11 Commits

• 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