246 Commits

• feat(coding-agent): add ExtensionAPI setLabel
  Mario Zechner · 2026-01-17 21:18:59 +01:00
  157e4e51bf
• docs(coding-agent): document ctx.compact and ctx.getContextUsage
  Mario Zechner · 2026-01-17 11:51:39 +01:00
  57fe00ced4
• feat(coding-agent): export keyHint utilities for extensions (#802)
  Danila Poyarkov · 2026-01-17 10:51:03 +01:00
  58eec55154
• fix(coding-agent): handle auto-compaction failures gracefully

  When auto-compaction fails (e.g., quota exceeded), emit the error via
  the auto_compaction_end event instead of throwing. The UI now displays
  the error message, allowing users to take action (switch models, wait
  for quota reset, etc.) instead of crashing.
  
  fixes #792

  Mario Zechner · 2026-01-16 23:13:26 +01:00
  20f5fcc79d
• Fix navigateTree API: add missing type updates, handler passthrough, and docs

  - Update ExtensionCommandContext.navigateTree type signature
  - Pass new options through in print-mode and rpc-mode handlers
  - Update docs/extensions.md, docs/sdk.md, docs/tree.md
  - Add changelog entry

  Mario Zechner · 2026-01-16 21:47:01 +01:00
  572ec64dbd
• docs(coding-agent): fix ctx.branch -> ctx.fork in extensions docs
  mom · 2026-01-16 13:47:28 +00:00
  fc3ca545df
• feat(coding-agent): extension command argument autocomplete
  Rafał Krzyważnia · 2026-01-16 12:47:29 +01:00
  35e48ca018
• feat(tui): hardware cursor positioning for IME support

  - Add Focusable interface for components that need hardware cursor positioning
  - Add CURSOR_MARKER (APC escape sequence) for marking cursor position in render output
  - Editor and Input components implement Focusable and emit marker when focused
  - TUI extracts cursor position from rendered output and positions hardware cursor
  - Track hardwareCursorRow separately from cursorRow for differential rendering
  - visibleWidth() and extractAnsiCode() now handle APC sequences
  - Update overlay-test.ts example to demonstrate Focusable usage
  - Add documentation for Focusable interface in docs/tui.md
  
  Closes #719, closes #525

  Mario Zechner · 2026-01-16 04:30:07 +01:00
  07fad1362c
• Move skill command handling to AgentSession, update docs

  - Skill commands (/skill:name) now expanded in AgentSession instead of
    interactive mode, enabling them in RPC and print modes
  - Input event can now intercept /skill:name before expansion
  - Updated extensions.md with clearer input event docs and processing order
  - Updated rpc.md: hook -> extension terminology, added skill expansion mentions
  - Added PR attribution to changelog entries for #761

  Mario Zechner · 2026-01-16 03:01:08 +01:00
  b4a05cbcab
• feat(coding-agent): add input event for extension input interception (#761)

  * feat(coding-agent): add input event for extension input interception
  
  Extensions can now intercept, transform, or handle user input before the
  agent processes it. Three result types: continue (pass through), transform
  (modify text/images), handled (respond without LLM). Handlers chain
  transforms and short-circuit on handled. Source field identifies origin.
  
  * fix: make source public, use if/else over ternary
  
  * fix: remove response field, extension handles own UI

  Nico Bailon · 2026-01-16 02:41:56 +01:00
  3e5d91f287
• Merge branch 'main' into feat/tui-overlay-options
  Mario Zechner · 2026-01-13 22:06:02 +01:00
  7d45e434de
• fix: extension loading in Bun binary (#681)

  - Remove loader exports from index.ts to break circular dependency
  - Static import of index.js in loader.ts for virtualModules
  - Add @mariozechner/pi-agent-core to virtualModules
  - Update @mariozechner/jiti to 2.6.5 (bundles babel for Bun binary)
  - Update SDK docs to use correct extension terminology

  Mario Zechner · 2026-01-13 21:19:41 +01:00
  843f235251
• docs: update extension examples READMEs and fix plan-mode references

  - Add missing extensions to examples/extensions/README.md:
    questionnaire.ts, truncated-tool.ts, model-status.ts, rainbow-editor.ts,
    custom-footer.ts, custom-header.ts, overlay-test.ts, shutdown-command.ts,
    interactive-shell.ts, claude-rules.ts, mac-system-theme.ts
  - Update plan-mode.ts -> plan-mode/ (now a directory)
  - Add new System Integration section
  - Update docs/extensions.md plan-mode.ts -> plan-mode/index.ts (17 refs)
  - Add questionnaire.ts to registerTool and ctx.ui.select() examples
  - Expand examples/README.md description

  Mario Zechner · 2026-01-13 18:34:08 +01:00
  36bb1d3865
• coding-agent: example extension to summarize conversation (#684)

  * feat: add summarize extension example
  
  Demonstrates custom UI with markdown rendering and external model
  integration for conversation summarization.
  
  * chore: update examples/extensions/README.md with summarize.ts

  scutifer · 2026-01-13 13:01:09 +01:00
  0f4d929a8e
• Add changelog and docs for settings fuzzy search (#643)
  Mario Zechner · 2026-01-12 19:00:33 +01:00
  842a65f06a
• Change getAllTools() to return ToolInfo[] instead of string[]

  Breaking change: pi.getAllTools() now returns Array<{ name, description }>
  instead of string[]. Extensions needing just names can use .map(t => t.name).
  
  Removes redundant getToolInfo() method added in original PR.
  
  Fixes #647

  Mario Zechner · 2026-01-12 17:18:43 +01:00
  1367a76ee8
• feat(coding-agent): add session naming via /name command and extension API

  - Add SessionInfoEntry type for session metadata
  - Add /name <name> command to set session display name
  - Add pi.setSessionName() and pi.getSessionName() extension API
  - Session selector shows name (in warning color) instead of first message when set
  - Session name included in fuzzy search
  - /session command displays name when set
  
  closes #650

  Mario Zechner · 2026-01-12 16:56:39 +01:00
  8f95a13e07
• Add changelog, update docs, fix handoff example for PR #642
  Mario Zechner · 2026-01-12 00:10:14 +01:00
  783aa0d6d0
• Merge branch 'tmp-2025-01-11' - resume scope toggle with async loading (#620)
  Mario Zechner · 2026-01-12 00:00:28 +01:00
  9d49b4d4ed
• feat(coding-agent): add resume scope toggle with async loading

  - /resume and --resume now toggle between Current Folder and All sessions with Tab
  - SessionManager.list() and listAll() are now async with optional progress callback
  - Shows loading progress (e.g. Loading 5/42) while scanning sessions
  - SessionInfo.cwd field shows session working directory in All view
  - Lazy loading: All sessions only loaded when user presses Tab
  
  closes #619
  
  Co-authored-by: Thomas Mustier <mustierthomas@gmail.com>

  Mario Zechner · 2026-01-12 00:00:03 +01:00
  302404684f
• Rename /branch command to /fork

  - RPC: branch -> fork, get_branch_messages -> get_fork_messages
  - SDK: branch() -> fork(), getBranchMessages() -> getForkMessages()
  - AgentSession: branch() -> fork(), getUserMessagesForBranching() -> getUserMessagesForForking()
  - Extension events: session_before_branch -> session_before_fork, session_branch -> session_fork
  - Settings: doubleEscapeAction 'branch' -> 'fork'
  
  fixes #641

  Mario Zechner · 2026-01-11 23:12:31 +01:00
  df3f5f41c0
• fix(tui): reset styles per line
  Mario Zechner · 2026-01-11 18:36:48 +01:00
  6d495348c5
• feat(coding-agent): add model_select extension hook

  Fires when the model changes via /model command, model cycling (Ctrl+P),
  or session restore. Includes source field and previousModel.
  
  Add model-status.ts example extension demonstrating status bar updates.
  
  closes #628

  Mario Zechner · 2026-01-11 18:12:46 +01:00
  a20c6efe17
• docs(coding-agent): document model_select hook

  Add CHANGELOG entry and extension documentation for the new model_select
  event that fires on model changes via /model, Ctrl+P, or session restore.

  Marc Krenn · 2026-01-11 18:12:09 +01:00
  943654cc93
• feat: Add skill slash commands and fuzzy matching for all commands

  - Skills registered as /skill:name commands for quick access
  - Toggle via /settings or skills.enableSkillCommands in settings.json
  - Fuzzy matching for all slash command autocomplete (type /skbra for /skill:brave-search)
  - Moved fuzzy module from coding-agent to tui package for reuse
  
  Closes #630 by @Dwsy (reimplemented with fixes)

  Mario Zechner · 2026-01-11 17:56:11 +01:00
  9655907624
• feat: add ctx.ui.setWorkingMessage() extension API

  Allows extensions to customize the streaming loader message.
  Pass undefined to restore default.

  Nico Bailon · 2026-01-10 21:11:44 -08:00
  271b49da3c
• fix(coding-agent): remove -- from registerFlag calls

  This was causing the agent sometimes to pick up on the incorrect syntax when
  asked to write extensions with flags

  Kao Félix · 2026-01-11 02:21:15 +01:00
  6d60302646
• feat(coding-agent): add FooterDataProvider for git branch and extension statuses

  Expose data that extensions cannot otherwise access: git branch and
  extension statuses from setStatus(). Token stats, model info, etc.
  remain computable via ctx.sessionManager and ctx.model.

  Nico Bailon · 2026-01-09 07:39:30 -08:00
  7b902612e9
• Add documentation on component invalidation and theme changes
  Mario Zechner · 2026-01-09 00:42:33 +01:00
  e0e66a3054
• feat(coding-agent): add interactive-shell.ts extension example

  Demonstrates running interactive commands (vim, git rebase, htop, etc.)
  with full terminal access using user_bash event and ctx.ui.custom().
  
  - Auto-detects interactive commands from built-in list
  - !i prefix to force interactive mode
  - Configurable via INTERACTIVE_COMMANDS/INTERACTIVE_EXCLUDE env vars
  
  closes #532

  Mario Zechner · 2026-01-09 00:08:52 +01:00
  c5b97d7a2f
• Fix --no-skills flag not preventing skills from loading

  The --no-skills flag set options.skills = [] in main.ts, but the
  interactive mode UI would rediscover skills anyway because it called
  loadSkills() directly instead of using the already-loaded skills.
  
  Changes:
  - Add AgentSession.skills and AgentSession.skillWarnings properties
  - discoverSkills() now returns { skills, warnings } instead of Skill[]
  - Interactive mode uses session.skills instead of calling loadSkills()
  - Update SDK docs and examples for new return type
  
  Fixes #577

  Mario Zechner · 2026-01-08 23:41:54 +01:00
  af2d8509e6
• docs: add overlay documentation, mark as experimental
  Mario Zechner · 2026-01-08 22:44:12 +01:00
  ec1ee7ddc6
• feat(coding-agent): add user_bash event and theme API extensions

  - user_bash event for intercepting ! and !! commands (#528)
  - Extensions can return { operations } or { result } to redirect/replace
  - executeBashWithOperations() for custom BashOperations execution
  - session.recordBashResult() for extensions handling bash themselves
  - Theme API: getAllThemes(), getTheme(), setTheme() on ctx.ui
  - mac-system-theme.ts example: sync with macOS dark/light mode
  - Updated ssh.ts to use user_bash event

  Mario Zechner · 2026-01-08 21:50:56 +01:00
  121823c74d
• Allow extensions to modify system prompt in before_agent_start

  - Add systemPrompt to BeforeAgentStartEvent so extensions can see current prompt
  - Change systemPromptAppend to systemPrompt in BeforeAgentStartEventResult for full replacement
  - Extensions can now chain modifications (each sees the result of previous)
  - Update ssh.ts to replace local cwd with remote cwd in system prompt
  - Update pirate.ts, claude-rules.ts, preset.ts to use new API
  
  fixes #575

  Mario Zechner · 2026-01-08 19:54:34 +01:00
  17cb328ca1
• feat(coding-agent): add pluggable operations for remote tool execution

  Adds optional operations parameter to create*Tool functions enabling
  delegation to remote systems (SSH, containers, etc.):
  
  - ReadOperations: readFile, access, detectImageMimeType
  - WriteOperations: writeFile, mkdir
  - EditOperations: readFile, writeFile, access
  - BashOperations: exec (with streaming, signal, timeout)
  
  Add ssh.ts example demonstrating --ssh flag for remote execution.
  Built-in renderers used automatically for overrides without custom renderers.
  
  fixes #564

  Mario Zechner · 2026-01-08 19:32:25 +01:00
  9ed88646a8
• feat(coding-agent): use built-in renderers for tool overrides without custom renderers

  When overriding a built-in tool (read, bash, edit, write, grep, find, ls)
  without providing renderCall/renderResult, the built-in renderer is now
  used automatically. This allows wrapping built-in tools for logging or
  access control without reimplementing the UI (syntax highlighting, diffs, etc.).

  Mario Zechner · 2026-01-08 18:52:33 +01:00
  bbf0d92e8c
• docs(coding-agent): clarify tool override doesn't require --no-tools
  Mario Zechner · 2026-01-08 18:52:33 +01:00
  4a6c32c142
• feat(coding-agent): add tool override support via extensions

  - Add setActiveTools() to ExtensionAPI for dynamic tool management
  - Extensions can now override, wrap, or disable built-in tools
  - Add tool-override.ts example demonstrating the pattern
  - Update documentation for tool override capabilities

  Mario Zechner · 2026-01-08 18:52:33 +01:00
  e3dd4f21d1
• feat(coding-agent): make ctx.shutdown() available for extensions (#542)
  Kao Félix · 2026-01-08 03:30:48 +01:00
  6845c4b85e
• feat(coding-agent): export run mode utilities with options interfaces

  - Add PrintModeOptions interface, update runPrintMode signature
  - Export InteractiveMode, InteractiveModeOptions, runPrintMode, PrintModeOptions, runRpcMode from main package
  - Document run modes in docs/sdk.md with usage examples
  - Update CHANGELOG

  Mario Zechner · 2026-01-08 01:53:24 +01:00
  e483521075
• refactor(coding-agent): simplify extension runtime architecture

  - Replace per-extension closures with shared ExtensionRuntime
  - Split context actions: ExtensionContextActions (required) + ExtensionCommandContextActions (optional)
  - Rename LoadedExtension to Extension, remove setter methods
  - Change runner.initialize() from options object to positional params
  - Derive hasUI from uiContext presence (no separate param)
  - Add warning when extensions override built-in tools
  - RPC and print modes now provide full command context actions
  
  BREAKING CHANGE: Extension system types and initialization API changed.
  See CHANGELOG.md for migration details.

  Mario Zechner · 2026-01-07 23:50:18 +01:00
  cb3ac0ba9e
• feat(coding-agent): add ctx.ui.setEditorComponent() extension API

  - Add setEditorComponent() to ctx.ui for custom editor components
  - Add CustomEditor base class for extensions (handles app keybindings)
  - Add keybindings parameter to ctx.ui.custom() factory (breaking change)
  - Add modal-editor.ts example (vim-like modes)
  - Add rainbow-editor.ts example (animated text highlighting)
  - Update docs: extensions.md, tui.md Pattern 7
  - Clean up terminal on TUI render errors

  Mario Zechner · 2026-01-07 16:11:49 +01:00
  09471ebc7d
• feat(coding-agent): add timeout option to extension dialogs with live countdown

  Extension UI dialogs (select, confirm, input) now support a timeout option
  that auto-dismisses with a live countdown display. Simpler alternative to
  manually managing AbortSignal for timed dialogs.
  
  Also adds ExtensionUIDialogOptions type export and updates RPC mode to
  forward timeout to clients.

  Nico Bailon · 2026-01-06 21:49:27 -08:00
  77477f6166
• Add AbortSignal support to extension UI dialogs

  Closes #474

  Nico Bailon · 2026-01-06 15:01:15 -08:00
  9771fa1e44
• Add ExtensionAPI methods, preset example, and TUI documentation improvements

  - ExtensionAPI: setModel(), getThinkingLevel(), setThinkingLevel() methods
  - New preset.ts example with plan/implement presets for model/thinking/tools switching
  - Export all UI components from pi-coding-agent for extension use
  - docs/tui.md: Common Patterns section with copy-paste code for SelectList, BorderedLoader, SettingsList, setStatus, setWidget, setFooter
  - docs/tui.md: Key Rules section for extension UI development
  - docs/extensions.md: Exhaustive example links for all ExtensionAPI methods and events
  - System prompt now references docs/tui.md for TUI development
  
  Fixes #509, relates to #347

  Mario Zechner · 2026-01-06 23:24:23 +01:00
  59d8b7948c
• Export truncation utilities for custom tools, add truncated-tool example

  - Export truncateHead, truncateTail, truncateLine, formatSize, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES from package
  - Add examples/extensions/truncated-tool.ts showing proper output truncation with custom rendering
  - Document output truncation best practices in docs/extensions.md

  Mario Zechner · 2026-01-06 22:13:08 +01:00
  7c99ea54bf
• Extensions: add pi.sendUserMessage() for sending user messages

  Adds sendUserMessage() to the extension API, allowing extensions to send
  actual user messages (role: user) rather than custom messages. Unlike
  sendMessage(), this always triggers a turn and behaves as if the user
  typed the message.
  
  - Add SendUserMessageHandler type and sendUserMessage() to ExtensionAPI
  - Wire handler through loader, runner, and all modes
  - Implement via prompt() with expandPromptTemplates: false
  - Add send-user-message.ts example with /ask, /steer, /followup commands
  - Document in extensions.md
  
  fixes #483

  Mario Zechner · 2026-01-06 13:40:24 +01:00
  7210086677
• Add ctx.ui.setFooter() for extensions to replace footer component

  Extensions can now replace the built-in footer with a custom component:
  - setFooter(factory) replaces with custom component
  - setFooter(undefined) restores built-in footer
  
  Includes example extension demonstrating context usage display.
  
  Closes #481

  Mario Zechner · 2026-01-06 12:39:45 +01:00
  f023af0dab
• docs: clarify SDK extension discovery and settings.json support
  Mario Zechner · 2026-01-05 18:00:32 +01:00
  3129e2ac10
• Add extensions option to createAgentSession SDK

  - Accept ExtensionFactory[] for inline extensions (merged with discovery)
  - Mark preloadedExtensions as @internal (CLI implementation detail)
  - Update sdk.md with inline extension example
  - Update CHANGELOG

  Mario Zechner · 2026-01-05 03:38:56 +01:00
  79cb8f0906