agent/pi - pi - Penguin

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

added custom header support and example extension

Tudor Oancea · 2026-01-06 21:20:19 +01:00

f755f69e0a

fix: OAuth token refresh failure returns undefined instead of throwing

When OAuth refresh fails during model discovery, getApiKey() now returns
undefined instead of throwing. This allows the app to start and fall back
to other providers, so the user can /login to re-authenticate.

fixes #498

Mario Zechner · 2026-01-06 20:57:42 +01:00

d2f3b42deb

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

Merge PR #492 : Add blockImages setting

- Setting controls filtering at convertToLlm layer
- Images are always stored in session, filtered dynamically based on current setting
- Toggle mid-session works: LLM sees/doesn't see images already in session
- Fixed SettingsManager.save() to handle inMemory mode for all setters

Closes #492

Mario Zechner · 2026-01-06 12:00:15 +01:00

a1d0b1c151

Add blockImages setting to prevent images from being sent to LLM providers

- Setting controls filtering at convertToLlm layer (defense-in-depth)
- Images are always stored in session, filtered dynamically based on current setting
- Toggle mid-session works: LLM sees/doesn't see images already in session
- Fixed SettingsManager.save() to handle inMemory mode for all setters

Closes #492

Mario Zechner · 2026-01-06 11:59:09 +01:00

1fc2a912d4

feat(ai,agent,coding-agent): add sessionId for provider session-based caching

- Add sessionId to StreamOptions for providers that support session-based caching
- OpenAI Codex provider uses sessionId for prompt_cache_key and routing headers
- Agent class now accepts and forwards sessionId to stream functions
- coding-agent passes session ID from SessionManager and updates on session changes
- Update ai package README with table of contents, OpenAI Codex OAuth docs, and env vars table
- Increase Codex instructions cache TTL from 15 minutes to 24 hours
- Add tests for sessionId forwarding in ai and agent packages

Mario Zechner · 2026-01-06 11:08:42 +01:00

edb0da9611

feat(coding-agent): add blockImages setting to prevent image uploads

Josh · 2026-01-06 00:34:23 -06:00

b582a6b70d

fix(coding-agent): improve bash tool error handling (#479 )

- Validate working directory exists before spawning to provide clear error message
- Add spawn error handler to prevent uncaught exceptions when shell not found or cwd invalid
- Add tests for both error scenarios

Without these fixes, spawn errors (e.g., ENOENT from missing cwd or shell) would
cause uncaught exceptions that crash the entire agent session instead of being
returned as clean tool errors.

Co-authored-by: robinwander <robinwander@users.noreply.github.com>

Robin · 2026-01-06 00:48:10 +01:00

1432fd91d2

Expand configured extension directories from settings.json (#480 )

* Expand configured extension directories

* Extract resolveExtensionEntries helper for directory resolution

* Update CHANGELOG for extension directory resolution

Prateek Sunal · 2026-01-06 00:42:02 +01:00

132ff1e7e4

fix: inject URL params for share links in iframe context

Mario Zechner · 2026-01-06 00:37:45 +01:00

1922db81a2

fix: copy link in shared sessions uses correct URL instead of about:srcdoc

Mario Zechner · 2026-01-06 00:22:32 +01:00

8b963f833a

feat: Add copy-link button to share viewer messages (#477 )

* feat: add copy-link button to share viewer messages

Implements the feature requested in #437:

- Add a small link icon button that appears on hovering over user/assistant
  messages in the share viewer
- Clicking the button copies a shareable URL to clipboard with visual feedback
- URL format: base?gistId&leafId=<active-leaf>&targetId=<message-id>
- When loading a URL with leafId and targetId params:
  - Navigate to the specified leaf node
  - Scroll to and briefly highlight the target message

This enables users to share links to specific messages within a session.

* fix: preserve gist ID format and add clipboard fallback

- Fix URL format to produce ?gistId&leafId=... instead of ?gistId=&leafId=...
  (preserves the bare key format expected by the backend)
- Add execCommand fallback for clipboard copy on HTTP contexts where
  navigator.clipboard is unavailable

lockmeister · 2026-01-05 23:59:26 +01:00

cf10e9592a

fix: clean up Codex thinking level handling

- Remove per-thinking-level model variants (gpt-5.2-codex-high, etc.)
- Remove thinkingLevels from Model type
- Provider clamps reasoning effort internally
- Omit reasoning field when thinking is off

fixes #472

Mario Zechner · 2026-01-05 21:58:26 +01:00

0b9e3ada0c

fix: codex thinking handling

Ben Vargas · 2026-01-05 21:55:47 +01:00

02b72b49d5

Improve OAuth login UI with consistent dialog component

- Add LoginDialogComponent with proper borders (top/bottom DynamicBorder)
- Refactor all OAuth providers to use racing approach (browser callback vs manual paste)
- Add onEscape handler to Input component for cancellation
- Add abortable sleep for GitHub Copilot polling (instant cancel on Escape)
- Show OS-specific click hint (Cmd+click on macOS, Ctrl+click elsewhere)
- Clear content between login phases (fixes GitHub Copilot two-phase flow)
- Use InteractiveMode's showStatus/showError for result messages
- Reorder providers: Anthropic, ChatGPT, GitHub Copilot, Gemini CLI, Antigravity

Mario Zechner · 2026-01-05 19:58:44 +01:00

9b12719ab1

feat(oauth): show paste input immediately during OpenAI Codex login (#468 )

Previously, users had to wait up to 60 seconds for the browser callback
to timeout before being prompted to paste the authorization code. This
was problematic for SSH/VPS sessions where the callback cannot work.

Now the paste input is shown immediately alongside the browser flow:
- Browser callback and manual paste race - whichever completes first wins
- Desktop users: browser callback succeeds, input is cleaned up
- SSH/VPS users: paste code immediately without waiting

Changes:
- Add cancelWait() to OAuth server for early termination of polling loop
- Add onManualCodeInput callback that races with browser callback
- Show paste input immediately in TUI for openai-codex provider
- Clean up input on success, error, or when browser callback wins

Co-authored-by: cc-vps <crcatala+vps@gmail.com>

Christian Catalan · 2026-01-05 18:47:58 +01:00

05b9d55656

docs: clarify SDK extension discovery and settings.json support

Mario Zechner · 2026-01-05 18:00:32 +01:00

3129e2ac10

fix: mark with-deps example as private, update changelog

Mario Zechner · 2026-01-05 17:55:15 +01:00

7e2ebdd78e

fix(sdk): extensions: [] now disables discovery as documented (#465 )

Aliou Diallo · 2026-01-05 16:55:51 +01:00

042d3fa310

fix: prevent silent logout when multiple pi instances refresh OAuth tokens (#466 )

cursive · 2026-01-05 16:55:05 +01:00

6a8609ac56

Merge branch 'openai-codex'

Mario Zechner · 2026-01-05 05:33:48 +01:00

9a147559c0

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

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

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

feat(hooks): expose setTitle to HookUIContext (#446 )

Aliou Diallo · 2026-01-04 20:55:52 +01:00

5cb7af1ddc

feat(ai): add OpenAI Codex OAuth + responses provider

Ahmed Kamal · 2026-01-04 21:11:19 +02:00

1650041a63

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(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

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