10 Commits

• WIP: Add hook API for dynamic tool control with plan-mode hook example

  - Add pi.getTools() and pi.setTools(toolNames) to HookAPI
  - Hooks can now enable/disable tools dynamically
  - Changes take effect on next agent turn
  
  New example hook: plan-mode.ts
  - Claude Code-style read-only exploration mode
  - /plan command toggles plan mode on/off
  - Plan mode tools: read, bash, grep, find, ls
  - Edit/write tools disabled in plan mode
  - Injects context telling agent about restrictions
  - After each response, prompts to execute/stay/refine
  - State persists across sessions

  Helmut Januschka · 2026-01-04 18:13:28 +01:00
  059292ead1
• Add todo hook companion to todo custom tool

  - /todos command displays all todos on current branch with custom UI
  - Update hooks.md to clarify components must not be wrapped in Box/Container
  - Cross-reference tool and hook in example READMEs

  Mario Zechner · 2026-01-03 00:13:25 +01:00
  74dc5e7c49
• Update docs for ctx.ui.editor() and handoff example

  - Added ctx.ui.editor() to hooks.md and custom-tools.md
  - Added ctx.ui.editor() to CHANGELOG.md
  - Added handoff.ts to examples/hooks/README.md

  Mario Zechner · 2026-01-02 01:26:21 +01:00
  02175d908b
• 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
• 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
• Improve compaction hooks: add signal, no timeout, SessionManager cleanup, docs
  Mario Zechner · 2025-12-24 13:54:05 +01:00
  705ba5d4f2
• Add full-compaction hook example
  Mario Zechner · 2025-12-24 12:25:36 +01:00
  5aa53ded11
• Add before/after session events with cancellation support

  - Merge branch event into session with before_branch/branch reasons
  - Add before_switch, before_clear, shutdown reasons
  - before_* events can be cancelled with { cancel: true }
  - Update RPC commands to return cancelled status
  - Add shutdown event on process exit
  - New example hooks: confirm-destructive, dirty-repo-guard, auto-commit-on-exit
  
  fixes #278

  Mario Zechner · 2025-12-22 18:18:38 +01:00
  42d7d9d9b6
• Add file-trigger hook example
  Mario Zechner · 2025-12-17 16:06:30 +01:00
  0ef73ad1dc
• Custom tools with session lifecycle, examples for hooks and tools

  - Custom tools: TypeScript modules that extend pi with new tools
    - Custom TUI rendering via renderCall/renderResult
    - User interaction via pi.ui (select, confirm, input, notify)
    - Session lifecycle via onSession callback for state reconstruction
    - Examples: todo.ts, question.ts, hello.ts
  
  - Hook examples: permission-gate, git-checkpoint, protected-paths
  
  - Session lifecycle centralized in AgentSession
    - Works across all modes (interactive, print, RPC)
    - Unified session event for hooks (replaces session_start/session_switch)
  
  - Box component added to pi-tui
  
  - Examples bundled in npm and binary releases
  
  Fixes #190

  Mario Zechner · 2025-12-17 16:03:23 +01:00
  e7097d911a