57 Commits

• Add TUI rendering for CustomMessageEntry

  - Add CustomMessageComponent with purple-tinted styling
  - Add theme colors: customMessageBg, customMessageText, customMessageLabel
  - Rename renderMessages to renderSessionContext taking SessionContext directly
  - renderInitialMessages now gets context from sessionManager
  - Skip rendering for display: false entries

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  7b94ddf36b
• Refactor SessionEventBase to pass sessionManager and modelRegistry

  Breaking changes to hook types:
  - SessionEventBase now passes sessionManager and modelRegistry directly
  - before_compact: passes preparation, previousCompactions (newest first)
  - before_switch: has targetSessionFile; switch: has previousSessionFile
  - Removed resolveApiKey (use modelRegistry.getApiKey())
  - getSessionFile() returns string | undefined for in-memory sessions
  
  Updated:
  - All session event emissions in agent-session.ts
  - Hook examples (custom-compaction.ts, auto-commit-on-exit.ts, confirm-destructive.ts)
  - Tests (compaction-hooks.test.ts, compaction-hooks-example.test.ts)
  - export-html.ts guards for in-memory sessions

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  9bba388ec5
• fix: make OAuth login URL clickable in terminal

  Use OSC 8 hyperlink escape sequence to show 'Click here to login'
  as a clickable link instead of displaying the raw URL which spans
  multiple lines and is hard to click in terminals (especially WSL).

  Cursivez · 2025-12-29 13:45:11 +08:00
  d42a3d71fe
• feat(coding-agent): Add --session-dir flag for custom session directory

  - Add --session-dir CLI flag to specify custom session directory
  - SessionManager API: second param of create(), continueRecent(), list(), open()
    changed from agentDir to sessionDir (direct directory, no cwd encoding)
  - When omitted, uses default (~/.pi/agent/sessions/<encoded-cwd>/)
  - --session now derives sessionDir from file's parent if --session-dir not provided
  - list() validates session header before processing files
  - Closes #313
  
  Co-authored-by: scutifer <scutifer@users.noreply.github.com>

  Mario Zechner · 2025-12-25 20:27:41 +01:00
  911963e777
• Merge pull request #315 from mitsuhiko/model-switcher

  Reverse model switching and binding for dialog

  Mario Zechner · 2025-12-25 18:33:42 +01:00
  4edfff41a7
• Reverse model switching and binding for dialog
  Armin Ronacher · 2025-12-25 18:07:36 +01:00
  b576a527c7
• Add /settings command with unified settings menu (#312)

  * Add /settings command with unified settings menu
  
  - Add SettingsList component to tui package with support for:
    - Inline value cycling (Enter/Space toggles)
    - Submenus for complex selections
    - Selection preservation when returning from submenu
  
  - Add /settings slash command consolidating:
    - Auto-compact (toggle)
    - Show images (toggle)
    - Queue mode (cycle)
    - Hide thinking (toggle)
    - Collapse changelog (toggle)
    - Thinking level (submenu)
    - Theme (submenu with preview)
  
  - Update AGENTS.md to clarify no inline imports rule
  
  Fixes #310
  
  * Add /settings to README slash commands table
  
  * Remove old settings slash commands, consolidate into /settings
  
  - Remove /thinking, /queue, /theme, /autocompact, /show-images commands
  - Remove unused selector methods and imports
  - Update README references to use /settings

  Mario Zechner · 2025-12-25 15:39:42 +01:00
  b4f7a957c4
• Rename /clear to /new, update hook events to before_new/new

  Closes #305 - took direct rename approach instead of alias system
  
  Thanks @mitsuhiko for the nudge!

  Mario Zechner · 2025-12-25 04:15:10 +01:00
  454ea1d36a
• Refactor OAuth/API key handling: AuthStorage and ModelRegistry

  - Add AuthStorage class for credential storage (auth.json)
  - Add ModelRegistry class for model management with API key resolution
  - Add discoverAuthStorage() and discoverModels() discovery functions
  - Add migration from legacy oauth.json and settings.json apiKeys to auth.json
  - Remove configureOAuthStorage, defaultGetApiKey, findModel, discoverAvailableModels
  - Remove apiKeys from Settings type and SettingsManager methods
  - Rename getOAuthPath to getAuthPath
  - Update SDK, examples, docs, tests, and mom package
  
  Fixes #296

  Mario Zechner · 2025-12-25 03:48:36 +01:00
  54018b6cc0
• WIP: Rename model-config.ts to models-json.ts

  - loadCustomModels now takes file path instead of agentDir

  Mario Zechner · 2025-12-25 01:15:17 +01:00
  1c31d91c83
• Improve compaction hooks: add signal, no timeout, SessionManager cleanup, docs
  Mario Zechner · 2025-12-24 13:54:05 +01:00
  705ba5d4f2
• docs: fix outdated custom tools paths and add missing header shortcut (#283)

  * docs: fix custom tools example paths to use index.ts structure
  
  * fix: add missing ctrl+g shortcut to startup header
  
  * docs: fix /session -> /resume for session switching references

  Aliou Diallo · 2025-12-23 03:29:31 +01:00
  7470dde1e9
• 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 bash tool visual line truncation

  Use visual line counting (accounting for line wrapping) instead of logical
  line counting for bash tool output in collapsed mode. Now consistent with
  bash-execution.ts behavior.
  
  - Add shared truncateToVisualLines utility
  - Update tool-execution.ts to use Box for bash with visual truncation
  - Update bash-execution.ts to use shared utility
  - Pass TUI to ToolExecutionComponent for terminal width access
  
  Fixes #275

  Mario Zechner · 2025-12-22 17:01:04 +01:00
  7ad8a8c447
• Refactor SessionManager to use static factory methods

  - Add factory methods: create(cwd), open(path), continueRecent(cwd), inMemory()
  - Add static list(cwd) for session listing
  - Make constructor private, pass cwd explicitly
  - Update SDK to take sessionManager instead of sessionFile options
  - Update main.ts to create SessionManager based on CLI flags
  - Update SessionSelectorComponent to take sessions[] instead of SessionManager
  - Update tests to use factory methods

  Mario Zechner · 2025-12-22 01:29:54 +01:00
  ace8ea3d5b
• Enable more biome lints and fix things
  Mario Zechner · 2025-12-21 22:56:20 +01:00
  d5fd685901
• feat(coding-agent): add configurable skills directories (#269)
  Nico Bailon · 2025-12-21 20:48:40 +01:00
  70440f7591
• feat(coding-agent): add Ctrl+Z to suspend process (#267)

  * feat(tui): add isCtrlZ key detection and resetRenderState method
  
  * feat(coding-agent): add Ctrl+Z handler to suspend process
  
  * docs(coding-agent): add Ctrl+Z to keyboard shortcuts documentation
  
  * feat(tui): add force parameter to requestRender

  Aliou Diallo · 2025-12-21 20:19:32 +01:00
  8868d623fc
• feat(coding-agent): add Ctrl+G to open external editor
  Aliou Diallo · 2025-12-21 12:07:05 +01:00
  fe853ed869
• Add configurable OAuth storage backend and respect --models in model selector

  - Add setOAuthStorage() and resetOAuthStorage() to pi-ai for custom storage backends
  - Configure coding-agent to use its own configurable OAuth path via getOAuthPath()
  - Model selector (/model command) now only shows models from --models scope when set
  - Rewrite OAuth documentation in pi-ai README with examples
  
  Fixes #255

  Mario Zechner · 2025-12-20 22:00:53 +01:00
  a81dc5eaca
• Add Google Gemini CLI and Antigravity OAuth providers

  - Add google-gemini-cli provider: free Gemini 2.0/2.5 via Cloud Code Assist
  - Add google-antigravity provider: free Gemini 3, Claude, GPT-OSS via sandbox
  - Move OAuth infrastructure from coding-agent to ai package
  - Fix thinking signature handling for cross-model handoff
  - Fix OpenAI message ID length limit (max 64 chars)
  - Add GitHub Copilot overflow pattern detection
  - Add OAuth provider tests for context overflow and streaming

  Mario Zechner · 2025-12-20 21:34:18 +01:00
  c359023c3f
• fix(coding-agent): clamp thinking level to model capabilities

  - setThinkingLevel() now clamps xhigh to high when model doesn't support it
  - Model changes automatically re-clamp the current thinking level
  - Fixed /model command to use session.setModel() instead of agent.setModel()
  - Footer and editor border color update after model/thinking changes
  
  Closes #253

  Mario Zechner · 2025-12-20 09:52:57 +01:00
  b7c3cf9436
• Fix footer overflow on narrow terminals, add /arminsayshi easter egg
  Mario Zechner · 2025-12-19 21:35:09 +01:00
  ad9d68e488
• feat: add xhigh thinking level support for gpt-5.2 and gpt-5.2-codex

  - Add XHIGH_MODELS constant and getAvailableThinkingLevels() to AgentSession
  - Update ThinkingSelectorComponent to accept availableLevels parameter
  - Both shift+tab cycling and /thinking command now show xhigh for supported models
  - Update types.ts documentation to list supported models

  theBucky · 2025-12-19 19:59:13 +01:00
  4f981d8ebc
• fix(coding-agent): properly cleanup terminal on Ctrl+C in session selector (#247)
  Aliou Diallo · 2025-12-19 19:04:00 +01:00
  95dcd04e7c
• Merge kitty-protocol-support into main
  Mario Zechner · 2025-12-19 01:21:47 +01:00
  139af12b37
• Add /hotkeys command, Ctrl+D exit, markdown table borders
  Mario Zechner · 2025-12-19 01:19:21 +01:00
  b2f29613e8
• Merge origin/main into kitty-protocol-support
  Mario Zechner · 2025-12-19 01:04:34 +01:00
  b1be086169
• Skills standard compliance

  Implement Agent Skills standard (https://agentskills.io/specification):
  - Validate name (must match parent dir, lowercase, max 64 chars)
  - Validate description (required, max 1024 chars)
  - Warn on unknown frontmatter fields
  - Warn on name collisions (keep first)
  - Change prompt format to XML structure
  - Remove {baseDir} placeholder (use relative paths)
  - Add tests and update documentation
  
  fixes #231

  Mario Zechner · 2025-12-19 00:11:39 +01:00
  05b7b81338
• Add Ctrl+D to exit when editor is empty

  - Add isCtrlD helper to keys.ts
  - CustomEditor intercepts Ctrl+D and only triggers callback when editor is empty
  - Single Ctrl+D with empty input exits immediately
  - Update CHANGELOG to frame as feature (Kitty protocol support) not fix

  Ahmed Kamal · 2025-12-18 19:39:41 +02:00
  727a7ab018
• 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
• Fix editor text clearing during compaction, fixes #179
  Mario Zechner · 2025-12-16 15:15:37 +01:00
  871188219b
• Add tool result streaming

  - Add AgentToolUpdateCallback type and optional onUpdate callback to AgentTool.execute()
  - Add tool_execution_update event with toolCallId, toolName, args, partialResult
  - Normalize tool_execution_end to always use AgentToolResult (no more string fallback)
  - Bash tool streams truncated rolling buffer output during execution
  - ToolExecutionComponent shows last N lines when collapsed (not first N)
  - Interactive mode handles tool_execution_update events
  - Update RPC docs and ai/agent READMEs
  
  fixes #44

  Mario Zechner · 2025-12-16 14:53:17 +01:00
  7ac832586f
• GitHub Copilot: auto-enable models, fix gpt-5 API, normalize tool call IDs

  - Auto-enable all models after /login via POST /models/{model}/policy
  - Use openai-responses API for gpt-5/o3/o4 models (not accessible via completions)
  - Normalize tool call IDs when switching between github-copilot models with different APIs
    (fixes #198: openai-responses generates 450+ char IDs with special chars that break other models)
  - Update README with streamlined GitHub Copilot docs

  Mario Zechner · 2025-12-15 20:06:11 +01:00
  c5543f7586
• feat: initial impl

  - add GitHub Copilot model discovery (env token fallback, headers,
  compat) plus fallback list and quoted provider keys in generated map
  - surface Copilot provider end-to-end (KnownProvider/default, env+OAuth
  token refresh/save, enterprise base URL swap, available only when
  creds/env exist)
  - tweak interactive OAuth UI to render instruction text and prompt
  placeholders
  
  gpt-5.2-high took about 35 minutes. It had a lot of trouble with `npm
  check`  and went off on a "let's adjust every tsconfig" side quest.
  Device code flow works, but the ai/scripts/generate-models.ts impl is
  wrong as models from months ago are missing and only those deprecated
  are accessible in the /models picker.

  cau1k · 2025-12-14 17:18:13 -05:00
  ccae7a4e0e
• Fix image rendering artifacts and improve show-images selector

  - Image component returns correct number of lines (rows) for TUI accounting
  - Empty lines rendered first, then cursor moves up and image is drawn
  - This clears the space the image occupies before rendering
  - Add spacer before inline images in tool output
  - Create ShowImagesSelectorComponent with borders like other selectors
  - Use showSelector pattern for /show-images command

  Mario Zechner · 2025-12-13 23:53:28 +01:00
  e4e234ecff
• Update existing tool components when toggling show-images setting
  Mario Zechner · 2025-12-13 23:15:56 +01:00
  53794d78f2
• Add /show-images command to toggle inline image display

  - Add terminal.showImages setting to settings-manager.ts
  - Add /show-images slash command (only visible if terminal supports images)
  - ToolExecutionComponent checks both terminal support and user setting
  - Shows text fallback when inline images are disabled

  Mario Zechner · 2025-12-13 23:14:46 +01:00
  f68a933d2c
• Display loaded skills on startup in interactive mode
  Mario Zechner · 2025-12-12 21:28:31 +01:00
  03c404c15f
• Auto-retry on transient provider errors (overloaded, rate limit, 5xx)

  - Add retry logic with exponential backoff (2s, 4s, 8s) in AgentSession
  - Disable Anthropic SDK built-in retries (maxRetries: 0) to allow app-level handling
  - TUI shows retry status with Escape to cancel
  - RPC mode: add set_auto_retry, abort_retry commands and auto_retry_start/end events
  - Configurable via settings.json: retry.enabled, retry.maxRetries, retry.baseDelayMs
  - Exclude context overflow errors from retry (handled by compaction)
  
  fixes #157

  Mario Zechner · 2025-12-10 23:36:46 +01:00
  bb445d24f1
• Fix branch selector for single message and --no-session mode

  - Allow branch selector to open with single user message (changed <= 1 to === 0 check)
  - Support in-memory branching for --no-session mode (no files created)
  - Add isEnabled() getter to SessionManager
  - Update sessionFile getter to return null when sessions disabled
  - Update SessionSwitchEvent types to allow null session files
  - Add branching tests for single message and --no-session scenarios
  
  fixes #163

  Mario Zechner · 2025-12-10 22:41:32 +01:00
  3d35e7c469
• fixes #161: disable theme watcher in print mode

  The theme file watcher was keeping the Node.js process alive indefinitely
  even in print mode where hot-reload is unnecessary. This fix adds an
  enableWatcher parameter to initTheme() and setTheme() functions, and only
  enables watchers in interactive mode.
  
  - Modified initTheme() to accept enableWatcher parameter (default: false)
  - Modified setTheme() to accept enableWatcher parameter (default: false)
  - Updated main.ts to only enable watchers in interactive mode
  - Updated InteractiveMode to enable watchers when changing themes

  Mario Zechner · 2025-12-10 21:16:47 +01:00
  9516424cae
• Add hooks system with pi.send() for external message injection

  - Hook discovery from ~/.pi/agent/hooks/, .pi/hooks/, --hook flag
  - Events: session_start, session_switch, agent_start/end, turn_start/end, tool_call, tool_result, branch
  - tool_call can block execution, tool_result can modify results
  - pi.send(text, attachments?) to inject messages from external sources
  - UI primitives: ctx.ui.select/confirm/input/notify
  - Context: ctx.exec(), ctx.cwd, ctx.sessionFile, ctx.hasUI
  - Docs shipped with npm package and binary builds
  - System prompt references docs folder

  Mario Zechner · 2025-12-10 00:50:30 +01:00
  7c553acd1e
• fix(coding-agent): skip hook init when no hooks configured
  Mario Zechner · 2025-12-09 22:24:17 +01:00
  86c2a33df4
• feat(coding-agent): implement hooks system

  - Add hooks infrastructure in core/hooks/ (loader, runner, types)
  - HookUIContext interface with mode-specific implementations
  - Interactive mode: TUI-based selector/input/confirm dialogs
  - RPC mode: JSON protocol for hook UI requests/responses
  - Print mode: no-op UI context (hooks run but can't prompt)
  - AgentSession.branch() now async, returns { selectedText, skipped }
  - Settings: hooks[] and hookTimeout configuration
  - Export hook types from package for hook authors
  
  Based on PR #147 proposal, adapted for new architecture.

  Mario Zechner · 2025-12-09 22:17:12 +01:00
  04d59f31ea
• Simplify compaction: remove proactive abort, use Agent.continue() for retry

  - Add agentLoopContinue() to pi-ai for resuming from existing context
  - Add Agent.continue() method and transport.continue() interface
  - Simplify AgentSession compaction to two cases: overflow (auto-retry) and threshold (no retry)
  - Remove proactive mid-turn compaction abort
  - Merge turn prefix summary into main summary
  - Add isCompacting property to AgentSession and RPC state
  - Block input during compaction in interactive mode
  - Show compaction count on session resume
  - Rename RPC.md to rpc.md for consistency
  
  Related to #128

  Mario Zechner · 2025-12-09 21:43:49 +01:00
  5a9d844f9a
• feat(coding-agent): implement new compaction system with overflow recovery

  Phase 1: Updated compaction.ts
  - findCutPoint now returns CutPointResult with isSplitTurn and turnStartIndex
  - Can cut at user, assistant, or bashExecution messages (never tool results)
  - Added turnPrefixSummary support for split turns (parallel summarization)
  - estimateTokens helper for context size estimation
  
  Phase 2: Updated session-manager.ts
  - CompactionEntry now has optional turnPrefixSummary field
  - loadSessionFromEntries injects both summaries when turn was split
  
  Phase 3: Updated agent-session.ts
  - Overflow detection via isContextOverflow after agent_end
  - Proactive compaction check on turn_end before next LLM call
  - _abortingForCompaction flag to skip saving aborted messages
  - Auto-retry after overflow recovery or proactive compaction
  - New event fields: reason (overflow/threshold), willRetry
  
  Phase 4: Updated interactive-mode.ts
  - Shows reason in compaction status (Context overflow detected...)
  - Shows retry status after compaction
  
  Tests updated for new CutPointResult return type.

  Mario Zechner · 2025-12-09 17:18:53 +01:00
  a38e619095
• Fix auto-compaction TUI integration and cut point logic

  - Trigger auto-compaction after agent_end instead of during message_end
  - Show CompactionComponent after auto-compaction (same as manual /compact)
  - Fix cut point to include bash executions before kept user message
  - Stop backward scan at compaction, assistant, user, or toolResult boundaries

  Mario Zechner · 2025-12-09 02:45:24 +01:00
  4227fd5996
• Add auto-compaction events to AgentSession

  - Add AgentSessionEvent type extending AgentEvent with auto_compaction_start/end
  - Emit events when auto-compaction starts and completes
  - TUI shows loader during auto-compaction with escape to cancel
  - Rebuilds chat UI when auto-compaction succeeds

  Mario Zechner · 2025-12-09 01:51:51 +01:00
  91b89578c1
• Show pending bash executions in pending area, move to chat on user submit
  Mario Zechner · 2025-12-09 01:39:40 +01:00
  803d4b65ee