1074 Commits

• Release v0.35.0
  Mario Zechner · 2026-01-05 03:41:24 +01:00
  78d0b88f7d
• 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
• Add customTools option back to createAgentSession SDK

  - Accepts ToolDefinition[] directly (simplified from old { path?, tool } format)
  - Tools are combined with extension-registered tools
  - Updated sdk.md documentation
  - Updated CHANGELOG

  Mario Zechner · 2026-01-05 03:34:36 +01:00
  8da793b1ba
• Improve Custom Components docs: explain editor replacement, simplify example
  Mario Zechner · 2026-01-05 03:09:02 +01:00
  6bd5e419a6
• Document setWidget Component support
  Mario Zechner · 2026-01-05 03:07:11 +01:00
  a5741df69a
• Add Custom UI section, update CHANGELOG migration docs

  - Add ## Custom UI section consolidating dialogs, widgets, custom components, message rendering, theme colors
  - Simplify ctx.ui and pi.registerMessageRenderer in other sections to reference Custom UI
  - Update CHANGELOG to reflect auto-migration of commands/ to prompts/

  Mario Zechner · 2026-01-05 03:06:39 +01:00
  0919ec5417
• Restructure extensions.md: add Custom Tools section, improve sendMessage docs

  - Add ## Custom Tools section with Tool Definition, Multiple Tools, Custom Rendering
  - Expand pi.sendMessage docs with deliverAs mode explanations
  - Add Extension Styles subsection (single file, dir, package.json)
  - Expand ExtensionCommandContext with waitForIdle, newSession, branch, navigateTree
  - Replace lodash with zod in examples
  - Various fixes and reorganization

  Mario Zechner · 2026-01-05 03:04:19 +01:00
  0e41b9c2a2
• Add table of contents to extensions.md
  Mario Zechner · 2026-01-05 02:51:45 +01:00
  e4f8215f97
• Show UI context methods in extension quick start example
  Mario Zechner · 2026-01-05 02:49:52 +01:00
  3e38fce541
• Update CHANGELOG with npm deployment note
  Mario Zechner · 2026-01-05 02:49:10 +01:00
  08f9622e99
• Add npm deployment to package.json benefits
  Mario Zechner · 2026-01-05 02:48:40 +01:00
  3f60de8929
• Add note about npm dependencies in extensions
  Mario Zechner · 2026-01-05 02:48:18 +01:00
  c8cfef7225
• Improve extension discovery docs with multi-entry package.json example
  Mario Zechner · 2026-01-05 02:47:52 +01:00
  f4a3724b7e
• Add migration for commands->prompts, warn about deprecated hooks/tools dirs

  - Auto-migrate commands/ to prompts/ on startup
  - Warn if hooks/ or tools/ directories contain custom extensions
  - Show deprecation warnings in interactive mode with keypress to continue
  - Update CHANGELOG and docs with full migration guide

  Mario Zechner · 2026-01-05 02:41:08 +01:00
  91cca23d23
• Flatten hello/ and question/ extension examples to single files
  Mario Zechner · 2026-01-05 01:45:10 +01:00
  cf1c4c31f4
• Merge hooks and custom-tools into unified extensions system (#454)

  Breaking changes:
  - Settings: 'hooks' and 'customTools' arrays replaced with 'extensions'
  - CLI: '--hook' and '--tool' flags replaced with '--extension' / '-e'
  - API: HookMessage renamed to CustomMessage, role 'hookMessage' to 'custom'
  - API: FileSlashCommand renamed to PromptTemplate
  - API: discoverSlashCommands() renamed to discoverPromptTemplates()
  - Directories: commands/ renamed to prompts/ for prompt templates
  
  Migration:
  - Session version bumped to 3 (auto-migrates v2 sessions)
  - Old 'hookMessage' role entries converted to 'custom'
  
  Structural changes:
  - src/core/hooks/ and src/core/custom-tools/ merged into src/core/extensions/
  - src/core/slash-commands.ts renamed to src/core/prompt-templates.ts
  - examples/hooks/ and examples/custom-tools/ merged into examples/extensions/
  - docs/hooks.md and docs/custom-tools.md merged into docs/extensions.md
  
  New test coverage:
  - test/extensions-runner.test.ts (10 tests)
  - test/extensions-discovery.test.ts (26 tests)
  - test/prompt-templates.test.ts

  Mario Zechner · 2026-01-05 01:43:35 +01:00
  c6fc084534
• Implement extension discovery with package.json manifest support

  Discovery rules:
  1. extensions/*.ts or *.js - direct files
  2. extensions/*/index.ts or index.js - subdirectory with index
  3. extensions/*/package.json with pi field - load declared paths
  
  No recursion beyond one level. Complex packages use package.json manifest.
  
  Added PiManifest type for future theme/skill bundling support.
  
  17 tests covering all discovery scenarios.
  
  refs #454

  Mario Zechner · 2026-01-04 23:24:24 +01:00
  9794868b38
• Add unified extensions system (not wired up yet)

  New src/core/extensions/ directory with:
  - types.ts: merged types from hooks and custom-tools
  - loader.ts: single loader for extensions
  - runner.ts: ExtensionRunner for event emission
  - wrapper.ts: tool wrapping utilities
  - index.ts: exports
  
  Key changes from old system:
  - Single ExtensionAPI with registerTool() for LLM-callable tools
  - Tools use ExtensionContext (has UI access)
  - No onSession callback on tools (use pi.on events instead)
  
  refs #454

  Mario Zechner · 2026-01-04 22:51:11 +01:00
  2846c7d190
• Fix event bus async error handling, clear pending messages on session switch, improve SDK docs

  - event-bus.ts: await async handlers to catch errors properly
  - agent-session.ts: clear _pendingNextTurnMessages on newSession/switchSession/branch
  - sdk.ts: make eventBus first (required) param for discoverHooks/discoverCustomTools
  - docs/sdk.md: document eventBus sharing pattern for hook/tool communication

  Mario Zechner · 2026-01-04 22:04:50 +01:00
  be330fdd9c
• docs(coding-agent): fix event bus docs - handlers persist, remove redundant note
  Mario Zechner · 2026-01-04 21:39:13 +01:00
  024ec33bf2
• docs(coding-agent): update event bus docs - async errors now caught automatically
  Mario Zechner · 2026-01-04 21:37:16 +01:00
  99a539baa4
• feat(coding-agent): add event bus for tool/hook communication (#431)

  * feat(coding-agent): add event bus for tool/hook communication
  
  Adds pi.events API enabling custom tools and hooks to communicate via
  pub/sub. Tools can emit events, hooks can listen. Shared EventBus instance
  created per session in createAgentSession().
  
  - EventBus interface with emit() and on() methods
  - on() returns unsubscribe function
  - Threaded through hook and tool loaders
  - Documented in hooks.md and custom-tools.md
  
  * fix(coding-agent): wrap event handlers to catch errors
  
  * docs: note async handler error handling for event bus
  
  * feat(coding-agent): add sendMessage to tools, nextTurn delivery mode
  
  - Custom tools now have pi.sendMessage() for direct agent notifications
  - New deliverAs: 'nextTurn' queues messages for next user prompt
  - Fix: hooks and tools now share the same eventBus (was isolated before)
  
  * fix(coding-agent): nextTurn delivery should always queue, even when streaming

  Nico Bailon · 2026-01-04 21:36:19 +01:00
  9c9e6822e3
• Add [Unreleased] section for next cycle
  Mario Zechner · 2026-01-04 21:06:48 +01:00
  12805f61bd
• Release v0.34.2
  Mario Zechner · 2026-01-04 21:06:08 +01:00
  71c978e2f9
• fix: move hook API changelog entries from 0.32.2 to 0.34.0

  The Hook API features (registerFlag, registerShortcut, setWidget, getActiveTools,
  plan-mode.ts) were incorrectly listed under 0.32.2 but actually shipped in 0.34.0.

  Mario Zechner · 2026-01-04 21:05:18 +01:00
  a4d6f22f55
• Add [Unreleased] section for next cycle
  Mario Zechner · 2026-01-04 20:57:34 +01:00
  2a47b1114d
• Release v0.34.1
  Mario Zechner · 2026-01-04 20:56:51 +01:00
  de92eeda1f
• feat(hooks): expose setTitle to HookUIContext (#446)
  Aliou Diallo · 2026-01-04 20:55:52 +01:00
  5cb7af1ddc
• docs: add note about macOS Finder image copy behavior
  Mario Zechner · 2026-01-04 20:52:51 +01:00
  affa618b43
• docs: add changelog entries for symbol key support (#450)
  Mario Zechner · 2026-01-04 20:38:27 +01:00
  2a332f7064
• feat(tui): add symbol key support to keybinding system (#450)

  - Added SymbolKey type with 32 symbol keys
  - Added symbol key constants to Key helper (Key.backtick, Key.comma, Key.period, etc.)
  - Updated matchesKey() and parseKey() to handle symbol key input
  - Added documentation in coding-agent README with examples

  Kao Félix · 2026-01-04 20:37:08 +01:00
  b836a9d2ee
• Add [Unreleased] section for next cycle
  Mario Zechner · 2026-01-04 20:30:34 +01:00
  61cadc226c
• Release v0.34.0
  Mario Zechner · 2026-01-04 20:29:50 +01:00
  dc2f5d43cc
• revert: remove unnecessary themeOverride params from theme functions

  The optional theme parameter was added as a workaround for tsx dev mode,
  but that's a dev-only issue. Users running the built package don't need it.

  Mario Zechner · 2026-01-04 20:27:46 +01:00
  00fa8b71c8
• docs: remove dev-only changelog entry
  Mario Zechner · 2026-01-04 20:26:29 +01:00
  7302fe5063
• docs: update CHANGELOG and hooks.md with missing items

  - tools.ts example hook
  - Multiple messages from before_agent_start
  - getSettingsListTheme/getSelectListTheme optional theme param
  - Hook error stack traces

  Mario Zechner · 2026-01-04 19:01:35 +01:00
  5318b42bd2
• fix(tools.ts): sync with active tools when no saved state

  Hook was showing all tools as enabled even though only 4 were active.
  Now initializes from pi.getActiveTools() to match actual state.

  Mario Zechner · 2026-01-04 18:50:45 +01:00
  b06bd1d24c
• fix(tools): wrap ALL registry tools with hooks, not just active ones

  wrappedToolRegistry was only containing activeToolsArray (4 tools).
  Now wraps all tools from the registry so hooks can enable any tool.

  Mario Zechner · 2026-01-04 18:47:57 +01:00
  31438fdf2a
• fix(tools): tool registry now contains ALL built-in tools

  - createAllTools() populates registry with all 7 built-in tools
  - --tools flag only sets initially active tools (default: read/bash/edit/write)
  - Hooks can enable any tool from registry via setActiveTools()
  - System prompt rebuilds with correct tool guidelines when tools change
  - Document tsx module resolution workaround in README

  Mario Zechner · 2026-01-04 18:44:41 +01:00
  2849623afc
• fix(theme): add optional themeOverride param to getSettingsListTheme/getSelectListTheme

  When hooks are loaded via jiti, they get a separate module instance from
  the main app. This means the global 'theme' variable in the hook's module
  is never initialized. Adding an optional theme parameter allows hooks to
  pass the theme from ctx.ui.custom() callback.
  
  Usage in hooks:
    getSettingsListTheme(theme)  // theme from ctx.ui.custom callback

  Mario Zechner · 2026-01-04 18:39:00 +01:00
  c447e62662
• fix(hooks): add stack traces to hook errors, fix tools.ts theme bug

  - HookError now includes optional stack field
  - Hook error display shows stack trace in dim color below error message
  - tools.ts: create SettingsListTheme using the theme passed to ctx.ui.custom()
    instead of using getSettingsListTheme() which depends on global theme

  Mario Zechner · 2026-01-04 18:33:28 +01:00
  6390ff87ef
• feat(hooks): add systemPromptAppend to before_agent_start, full tool registry

  - before_agent_start handlers can return systemPromptAppend to dynamically
    append text to the system prompt for that turn
  - Multiple hooks' systemPromptAppend strings are concatenated
  - Multiple hooks' messages are now all injected (not just first)
  - Tool registry now contains ALL built-in tools (read, bash, edit, write,
    grep, find, ls) regardless of --tools flag
  - --tools only sets initially active tools, hooks can enable any via
    setActiveTools()
  - System prompt automatically rebuilds when tools change, updating tool
    descriptions and guidelines
  - Add pirate.ts example hook demonstrating systemPromptAppend
  - Update hooks.md with systemPromptAppend documentation

  Mario Zechner · 2026-01-04 18:21:26 +01:00
  e4dd21a3b2
• feat(hooks): add tools.ts example hook for interactive tool enable/disable

  - /tools command opens SettingsList-based selector for all loaded tools
  - Space/Enter toggles individual tools between enabled/disabled
  - Changes apply immediately on toggle (like /settings)
  - Tool selection persisted to session via appendEntry()
  - State restored from current branch on session_start, session_tree, session_branch
  - Uses getBranch() to respect branch-specific tool configuration
  - Export getSettingsListTheme and getSelectListTheme for hooks to use

  Mario Zechner · 2026-01-04 18:13:30 +01:00
  892acedb6b
• fix(hooks): deep copy messages in context event before passing to hooks

  The context event handler documentation promised a deep copy but the
  implementation passed the original array reference. This could cause
  hooks to accidentally mutate session messages.
  
  Uses structuredClone() for fast native deep copying.

  Mario Zechner · 2026-01-04 18:13:30 +01:00
  ddf8bfceee
• refactor: address PR feedback - merge setWidget, use KeyId for shortcuts

  1. Merge setWidget and setWidgetComponent into single overloaded method
     - Accepts either string[] or component factory function
     - Uses single Map<string, Component> internally
     - String arrays wrapped in Container with Text components
  
  2. Use KeyId type for registerShortcut instead of plain string
     - Import Key from @mariozechner/pi-tui
     - Update plan-mode example to use Key.shift('p')
     - Type-safe shortcut registration
  
  3. Fix tool API docs
     - Both built-in and custom tools can be enabled/disabled
     - Removed incorrect 'custom tools always active' statement
  
  4. Use matchesKey instead of matchShortcut (already done in rebase)

  Helmut Januschka · 2026-01-04 18:13:30 +01:00
  8ecb1d6c0b
• fix: use robust matchShortcut from TUI library

  - Add matchShortcut() function to @mariozechner/pi-tui
  - Handles Kitty protocol, legacy terminal sequences, and lock keys
  - Supports special keys (enter, tab, space, backspace, escape)
  - Replace custom implementation in interactive-mode.ts
  - Remove unused imports

  Helmut Januschka · 2026-01-04 18:13:29 +01:00
  c1d7f8d962
• fix: remove inline imports and debug logging

  - Convert all inline import() types to top-level imports
  - Remove debug console.error statements from plan-mode hook

  Helmut Januschka · 2026-01-04 18:13:29 +01:00
  277d7bd83b
• fix(plan-mode): handle non-tool steps and clean up todo text

  - Non-tool turns (analysis, explanation) now mark step complete at turn_end
  - Clean up extracted step text: remove markdown, truncate to 50 chars
  - Remove redundant action words (Use, Run, Execute, etc.)
  - Track toolsCalledThisTurn flag to distinguish tool vs non-tool turns

  Helmut Januschka · 2026-01-04 18:13:29 +01:00
  a169029a16
• fix(plan-mode): track step completion via tool_result events

  - No longer relies on agent outputting [STEP N DONE] tags
  - Each successful tool_result marks the next uncompleted step done
  - Much more reliable than expecting LLM to follow tag format
  - Simplified execution context (no special instructions needed)

  Helmut Januschka · 2026-01-04 18:13:29 +01:00
  fdcc044491
• fix(plan-mode): use step numbers instead of random IDs

  - Steps are numbered 1, 2, 3... which is easier for agent to track
  - Agent outputs [STEP 1 DONE], [STEP 2 DONE] instead of [DONE:abc123]
  - Clearer instructions in execution context

  Helmut Januschka · 2026-01-04 18:13:29 +01:00
  361292d4de