13 Commits

• 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
• Fix SDK tools to respect cwd option

  Core tools now properly use the cwd passed to createAgentSession().
  Added tool factory functions for SDK users who specify custom cwd with explicit tools.
  
  Fixes #279

  Mario Zechner · 2025-12-22 16:17:55 +01:00
  face745f3d
• Add project-specific settings and SettingsManager factories

  - SettingsManager now loads .pi/settings.json from cwd (project settings)
  - Project settings merge with global settings (deep merge for objects)
  - Setters only modify global settings, project settings are read-only
  - Add static factories: SettingsManager.create(cwd?, agentDir?), SettingsManager.inMemory(settings?)
  - Add applyOverrides() for programmatic overrides
  - Replace 'settings' option with 'settingsManager' in CreateAgentSessionOptions
  - Update examples to use new pattern
  
  Incorporates PR #276 approach

  Mario Zechner · 2025-12-22 12:23:02 +01:00
  62c64a286b
• Add SDK usage examples

  12 examples showing increasing levels of customization:
  - 01-minimal: all defaults
  - 02-custom-model: model and thinking level
  - 03-custom-prompt: replace or modify prompt
  - 04-skills: discover, filter, merge skills
  - 05-tools: built-in tools, custom tools
  - 06-hooks: logging, blocking, result modification
  - 07-context-files: AGENTS.md files
  - 08-slash-commands: file-based commands
  - 09-api-keys-and-oauth: API key resolution, OAuth config
  - 10-settings: compaction, retry, terminal settings
  - 11-sessions: persistence options
  - 12-full-control: replace everything
  
  Also exports FileSlashCommand type from index.ts

  Mario Zechner · 2025-12-22 03:14:30 +01:00
  56121dcac1
• Update custom tools README for subdirectory/index.ts structure
  Mario Zechner · 2025-12-19 04:54:02 +01:00
  48e792aa52
• Convert custom tool examples to subdirectory/index.ts structure

  - hello.ts → hello/index.ts
  - question.ts → question/index.ts
  - todo.ts → todo/index.ts
  - subagent/subagent.ts → subagent/index.ts

  Mario Zechner · 2025-12-19 04:54:02 +01:00
  a930eb8489
• Subagent: markdown rendering in expanded view, chain streaming shows all steps

  - Export getMarkdownTheme() from coding-agent for custom tools
  - Chain/parallel modes now use Markdown component in expanded view
  - Chain streaming updates include all previous steps (not just current)
  - Strip {previous} placeholder from task preview in renderCall

  Mario Zechner · 2025-12-19 04:54:02 +01:00
  320556dbf5
• Refactor subagent tool, fix custom tool discovery, fix JSON mode stdout flush

  Breaking changes:
  - Custom tools now require index.ts entry point in subdirectory
    (e.g., tools/mytool/index.ts instead of tools/mytool.ts)
  
  Subagent tool improvements:
  - Refactored to use Message[] from ai package instead of custom types
  - Extracted agent discovery to separate agents.ts module
  - Added parallel mode streaming (shows progress from all tasks)
  - Added turn count to usage stats footer
  - Removed redundant Query section from scout output
  
  Fixes:
  - JSON mode stdout flush: Fixed race condition where pi --mode json
    could exit before all output was written, causing consumers to
    miss final events
  
  Also:
  - Added signal/timeout support to pi.exec() for custom tools and hooks
  - Renamed pi-pods bin to avoid conflict with pi

  Mario Zechner · 2025-12-19 04:54:02 +01:00
  4fb3af93fb
• Add subagent orchestration example (#215)
  Nico Bailon · 2025-12-19 01:45:18 +01:00
  eb1d08a5fb
• Fix TUI performance regression: add caching to Box, use Text directly for built-in tools
  Mario Zechner · 2025-12-17 16:39:23 +01:00
  909989066a
• Re-export Type from typebox, update examples to import from pi-coding-agent
  Mario Zechner · 2025-12-17 16:10:01 +01:00
  aedce30618
• 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