agent/pi - pi - Penguin

Add session management and agent state methods to hooks API

HookAPI additions:
- pi.newSession(options?) - create new session with optional setup callback
- pi.branch(entryId) - branch from a specific entry
- pi.navigateTree(targetId, options?) - navigate the session tree

HookContext additions:
- ctx.isIdle() - check if agent is streaming
- ctx.waitForIdle() - wait for agent to finish
- ctx.abort() - abort current operation
- ctx.hasQueuedMessages() - check for queued user messages

These enable hooks to programmatically manage sessions (handoff, templates)
and check agent state before showing interactive UI.

Fixes #388

Mario Zechner · 2026-01-01 23:56:24 +01:00

ccdd7bd283

Consolidate session events: remove session_before_new/session_new, add reason field to switch events

- Remove session_before_new and session_new hook events
- Add reason: 'new' | 'resume' to session_before_switch and session_switch events
- Remove 'new' reason from custom tool onSession (use 'switch' for both /new and /resume)
- Rename reset() to newSession(options?) in AgentSession
- Add NewSessionOptions with optional parentSession for lineage tracking
- Rename branchedFrom to parentSession in SessionHeader
- Rename RPC reset command to new_session with optional parentSession
- Update example hooks to use new event structure
- Update documentation and changelog

Based on discussion in #293

Mario Zechner · 2026-01-01 23:31:26 +01:00

484d7e06bb

Fix crash on Unicode format characters in visibleWidth

Strip all Unicode format characters (category Cf) before passing to
string-width. These are invisible control characters that crash
string-width but have no visible width anyway.

Closes #390

Mario Zechner · 2026-01-01 22:33:09 +01:00

1d9fa13d58

Remove extra spacer before loader in BorderedLoader

Mario Zechner · 2026-01-01 22:30:19 +01:00

7f0cd8bcb5

Add CHANGELOG entries for export theme colors and syntax highlighting

Mario Zechner · 2026-01-01 22:28:44 +01:00

e9cf47d09d

Add theme-configurable HTML export colors (from PR #387 )

- Add optional 'export' section to theme JSON with pageBg, cardBg, infoBg
- If not specified, colors are auto-derived from userMessageBg
- Add export colors to dark.json and light.json
- Update theme-schema.json and TypeBox schema
- Add documentation to docs/theme.md
- Add margin-top back to tool-output for spacing between header and content

Mario Zechner · 2026-01-01 22:21:40 +01:00

6267720660

Fix markdown code block default color to use --text not --mdCodeBlock

The mdCodeBlock color was being applied to all text in code blocks,
overriding hljs syntax highlighting for unspanned text.

Mario Zechner · 2026-01-01 22:15:26 +01:00

d612bc45f5

Fix hljs v11 compound class selectors for functions/types

Mario Zechner · 2026-01-01 22:07:04 +01:00

28434ce3a6

Fix hljs color mappings to match TUI theme

- Add .hljs-function for syntaxFunction
- Separate .hljs-punctuation to use syntaxPunctuation (was using syntaxOperator)

Mario Zechner · 2026-01-01 22:04:38 +01:00

ecfedce25f

Fix HTML escaping in markdown code blocks

Move HTML tag escaping from pre-parse to custom renderers.
This preserves < in code blocks while still escaping in text content.

Mario Zechner · 2026-01-01 22:03:01 +01:00

0b31884385

Add ctx.ui.theme getter for styling status text with theme colors

- Add theme property to HookUIContext interface
- Implement in interactive, RPC, and no-op contexts
- Add status-line.ts example hook
- Document styling with theme colors in hooks.md

Mario Zechner · 2026-01-01 21:58:01 +01:00

dccdf91b8c

Remove test files, add out.html to gitignore

Mario Zechner · 2026-01-01 21:50:32 +01:00

48ca55ab3c

Remove padding from markdown code blocks

Mario Zechner · 2026-01-01 21:50:23 +01:00

872205406e

Remove accidentally committed files

Mario Zechner · 2026-01-01 21:42:28 +01:00

a9492837e8

Fix markdown code block syntax highlighting

Marked v15 removed the highlight option from setOptions.
Use marked.use() with a custom renderer instead.

Mario Zechner · 2026-01-01 21:42:18 +01:00

0ec8509de3

Update todo.md

Mario Zechner · 2026-01-01 21:40:36 +01:00

cafbca02f9

Fix tool-output spacing by removing pre-wrap from container

The white-space: pre-wrap on .tool-output was preserving template
literal whitespace (newlines and indentation). The pre elements
inside still have pre-wrap for actual code content.

Mario Zechner · 2026-01-01 21:40:16 +01:00

95868ea5e9

Hooks can render custom status (#385 )

* Add ctx.ui.setStatus(key, text) API for hooks to display status in footer

- Add setStatus to HookUIContext interface
- Implement in interactive mode (FooterComponent)
- Implement in RPC mode (fire-and-forget)
- Add no-op implementations for headless contexts
- Multiple statuses displayed on single line, sorted by key
- Supports ANSI styling (hooks handle their own colors)

* Remove setStatus from changelog for now

* Fix hook status API to follow TUI rules

- Sanitize status text: replace newlines, tabs, carriage returns with spaces
- Truncate combined status line to terminal width using truncateToWidth
- Update JSDoc to document sanitization and truncation behavior
- Remove unused createHookUIContext method
- Add missing setStatus to test mock

* Add setStatus to changelog

* Use dim ellipsis for hook status truncation for consistency with footer style

---------

Co-authored-by: Mario Zechner <badlogicgames@gmail.com>

Prateek Sunal · 2026-01-01 21:35:37 +01:00

9b2aa4a683

Fix export HTML styling issues

- Match help-bar font size (11px) with header-info
- Add newline after 'Available Tools' header
- Remove excessive margin-top from tool-output

Mario Zechner · 2026-01-01 21:34:07 +01:00

89db7ed024

Add /share command to README

Mario Zechner · 2026-01-01 21:28:22 +01:00

0addbfec4e

Make /share cancellable with Escape, add CHANGELOG entries

- Use BorderedLoader for /share command so Escape cancels gist creation
- Add CHANGELOG entries for /share command and HTML export improvements
- Add todo.md with remaining export-html issues

Mario Zechner · 2026-01-01 21:27:33 +01:00

738892eb7a

Remove unused imports and variables

Mario Zechner · 2026-01-01 21:14:36 +01:00

93aaf8160e

Refactor export-html and add /share command

- Split template into separate files: template.html, template.css, template.js
- Add tree visualization sidebar for session navigation
- Fix HTML sanitization to prevent <style> tags breaking DOM
- Add DOM node caching for faster re-renders
- Fix tree indentation to match tree-selector.ts
- Add /share command to upload session as GitHub gist
- Support shittycodingagent.ai/session?{gistId} URLs

Closes #375, closes #380

Mario Zechner · 2026-01-01 21:13:40 +01:00

3fa9eb58b8

Show edit diff before tool execution (fixes #393 )

- Extract diff computation from edit.ts into shared edit-diff.ts
- ToolExecutionComponent computes and caches diff when args are complete
- Diff is visible while permission hooks block, before tool executes

Mario Zechner · 2026-01-01 20:34:19 +01:00

1ed009e2cf

Fix export-html tree sidebar to match TUI tree-selector

- Show tool results in default filter (not hidden)
- Branch summary shows summary text inline
- Custom message support in tree with customType label
- Remove extra padding from tree nodes (use line-height)
- Remove border styling from active/in-path nodes
- Consistent 18px line-height for tree entries

Mario Zechner · 2026-01-01 17:25:30 +01:00

173b81bc04

Fix export-html message stats and help bar

- Fix entry type names: branch_summary, custom_message (snake_case)
- Fix toolResult role (was 'tool')
- Count all entry types: user, assistant, tool results, custom, compactions, branch summaries
- Use global stats for tokens/cost (all entries), not just current branch
- Make help bar more prominent (12px, full opacity)
- Remove Esc shortcut from help bar

Mario Zechner · 2026-01-01 17:16:47 +01:00

a9da0ce3fd

Fix export-html header stats and UX

- Header h1 font size now 12px (matches body)
- Token/cost stats now computed for all entries, not just current branch
- Token display matches footer format: ↑input ↓output Rcache Wcache
- Cost display uses 3 decimal places like footer
- Scroll to target uses requestAnimationFrame for DOM readiness
- Initial load and Escape scroll to bottom, tree clicks scroll to target

Mario Zechner · 2026-01-01 17:12:44 +01:00

9e5163c296

Fix export-html spacing to use line-height based system

- Add --line-height CSS variable (18px = 12px font * 1.5)
- Convert all padding/margin to use var(--line-height)
- Remove fractional values for terminal-like consistency
- Fix gap between consecutive tool executions
- Remove extra padding from error-text and model-change
- Fix thinking toggle to show 'Thinking ...' when collapsed
- Remove top padding after timestamps in assistant messages
- Remove bottom padding from assistant-text

Mario Zechner · 2026-01-01 14:28:31 +01:00

f16fa1efb2

Fix export-html styling and behavior

- Fix UTF-8 decoding with TextDecoder for base64 session data
- Use toolOutput color for expand hints (not borderAccent)
- Remove '- click to expand' text to match TUI
- Ctrl+O toggles expanded state (not visibility) on tool outputs
- Edit diffs always visible (not affected by Ctrl+O)
- Remove Ctrl+F override to allow browser search
- Replace tabs with 3 spaces in all tool outputs
- Fix syntax highlighting default color to use --text
- Add more hljs token selectors (property, punctuation, operator)
- Compaction uses customMessageBg/Label/Text colors
- Model change uses dim color without background
- Scroll to end on initial load
- Pointer cursor on expandable elements

Mario Zechner · 2026-01-01 13:24:01 +01:00

fcb700701e

Add image support and mobile UX improvements to export-html

- Display images from read tool results (base64 encoded)
- Add ellipsis for truncated tree entries
- Make mobile hamburger button more subtle
- Add X close button in sidebar header on mobile
- Hide hamburger when sidebar is open

Mario Zechner · 2026-01-01 12:41:58 +01:00

55fd8d9fed

Polish export-html tree styling

- Add subtle border between sidebar and content
- Use selectedBg for tree node hover state
- Add left border accent for active and in-path nodes

Mario Zechner · 2026-01-01 03:46:08 +01:00

c8c7e0fba4

Improve export-html styling with derived export colors

- Add deriveExportColors() to compute page/card/info backgrounds from userMessageBg
- Use luminance detection to adapt colors for light/dark themes
- Use info-bg for model-change, compaction, system-prompt sections
- Use selectedBg for hover states and summary backgrounds
- Add scroll-to-message with highlight when clicking tree nodes
- Fix mobile overlay to close sidebar on click
- Wider sidebar (400px) with search and filter controls

Mario Zechner · 2026-01-01 03:44:19 +01:00

f53cabe1e3

WIP: Rewrite export-html with tree sidebar, client-side rendering

- Add tree sidebar with search and filter (Default/All/Labels)
- Client-side markdown/syntax highlighting via vendored marked.js + highlight.js
- Base64 encode session data to avoid escaping issues
- Reuse theme.ts color tokens via getResolvedThemeColors()
- Sticky sidebar, responsive mobile layout with overlay
- Click tree node to scroll to message
- Keyboard shortcuts: Esc to reset, Ctrl/Cmd+F to search

Mario Zechner · 2026-01-01 03:36:47 +01:00

256fa575fb

Add changelog entries for #372

Mario Zechner · 2026-01-01 02:16:51 +01:00

a073477555

Fix characters (#372 )

* Fix cat command

* Fix text rendering crash from undefined code points in bash output

* Revert unintentional model parameter changes from fix cat command commit

Mr. Rc · 2026-01-01 02:16:29 +01:00

bbf23bd5f1

fix: enabledModels now supports glob patterns for OAuth providers

Added glob pattern support (e.g., github-copilot/*, *sonnet*) to --models
and enabledModels. Patterns are matched against both provider/modelId and
just modelId, so *sonnet* works without requiring anthropic/*sonnet*.

The existing fuzzy substring matching for non-glob patterns is preserved.

fixes #337

Mario Zechner · 2026-01-01 02:04:04 +01:00

46bb5dcde8

Footer shows full session stats after compaction

FooterComponent now iterates over all session entries for cumulative
token usage and cost, not just post-compaction messages.

fixes #322

Mario Zechner · 2026-01-01 00:37:59 +01:00

7369128b3a

Coalesce sequential status messages

Rapidly changing settings no longer spams the chat log with multiple status lines.

fixes #365

Mario Zechner · 2026-01-01 00:28:37 +01:00

a2afa490f1

Merge branch 'main' into pb/tui-status-coalesce

Mario Zechner · 2026-01-01 00:27:54 +01:00

ac6f5006a9

Add thinkingText theme token, fix streaming toggle bug

- Add configurable thinkingText color for thinking blocks (defaults to muted)
- Make 'Thinking...' label italic when collapsed
- Fix Ctrl+T during streaming hiding the current message
- Track streamingMessage to properly re-render on toggle

Based on #366 by @paulbettner

Mario Zechner · 2026-01-01 00:25:04 +01:00

506e63a969

Merge main, resolve CHANGELOG conflict

Mario Zechner · 2026-01-01 00:10:46 +01:00

c15efdbcd9

Add setEditorText/getEditorText to hook UI context, improve custom() API

- Add setEditorText() and getEditorText() to HookUIContext for prompt generator pattern
- custom() now accepts async factories for fire-and-forget work
- Add CancellableLoader component to tui package
- Add BorderedLoader component for hooks with cancel UI
- Export HookAPI, HookContext, HookFactory from main package
- Update all examples to import from packages instead of relative paths
- Update hooks.md and custom-tools.md documentation

fixes #350

Mario Zechner · 2026-01-01 00:04:56 +01:00

6f7c10e323

Fix hook tool_result event not emitted for tool errors

Tools are supposed to throw on error. What needs fixing is that we need to report tool_result for erroneous tool executions as well.

Fixes #374

Mario Zechner · 2025-12-31 17:12:55 +01:00

02d0d6e192

fix(coding-agent): save initial model and thinking level to session

When creating a new session, initial model and thinking level were set
on the agent but never saved to session file. This caused --resume to
default thinking level to 'off'.

fixes #342

Aliou Diallo · 2025-12-31 15:21:41 +01:00

98c85bf36a

Update README.md compaction and branching sections

- Simplify compaction section, link to docs/compaction.md for details
- Clarify that branch summaries are optional (user is prompted)
- Change /branch to /tree in compaction note

Mario Zechner · 2025-12-31 14:44:51 +01:00

0fa558154c

Restructure README.md

- Add session tree intro to Sessions section
- Move Themes, Custom Slash Commands, Skills, Hooks, Custom Tools to new Extensions top-level section
- Keep Settings File under Configuration

Mario Zechner · 2025-12-31 14:39:51 +01:00

dc5466becc

Expand theme changes section in CHANGELOG.md

- Mark as breaking for custom themes
- Explain that custom themes must add new tokens or fail to load
- Note total color count increased from 46 to 50
- Reference theme.md and built-in themes

Mario Zechner · 2025-12-31 14:35:39 +01:00

116fbad24c

Expand pi.sendMessage and registerMessageRenderer docs in hooks.md

- sendMessage: document storage timing, LLM context, TUI display
- registerMessageRenderer: document renderer signature, return null for default

Mario Zechner · 2025-12-31 14:34:30 +01:00

f0ab8db40f

Fix SessionManager method name: getPath -> getBranch

Mario Zechner · 2025-12-31 14:30:08 +01:00

410659d45e

Document SessionManager and ModelRegistry in CHANGELOG.md

- SessionManager: method renames, new tree/append/branch methods
- ModelRegistry: new class for model discovery and API key resolution

Mario Zechner · 2025-12-31 14:28:44 +01:00

1b078a3f79

4207 Commits