agent/pi
2
0
Fork 0
mirror of https://github.com/earendil-works/pi.git synced 2026-06-18 15:54:04 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,235 Commits 32 Branches 288 Tags
165fb58b398cb5b63b11cfe8bb4b60b2b876b4e4
Commit Graph

61 Commits

  • Move exec to HookAPI, sessionManager/modelRegistry to HookEventContext 
    Breaking changes:
- HookEventContext now has sessionManager and modelRegistry (moved from SessionEventBase)
- HookAPI now has exec() method (moved from HookEventContext/HookCommandContext)
- HookRunner constructor takes sessionManager and modelRegistry as required params
- Session events no longer include sessionManager/modelRegistry fields

Hook code migration:
- event.sessionManager -> ctx.sessionManager
- event.modelRegistry -> ctx.modelRegistry
- ctx.exec() -> pi.exec()

Updated:
- src/core/hooks/types.ts - type changes
- src/core/hooks/runner.ts - constructor, createContext
- src/core/hooks/loader.ts - add exec to HookAPI
- src/core/sdk.ts - pass sessionManager/modelRegistry to HookRunner
- src/core/agent-session.ts - remove sessionManager/modelRegistry from events
- src/modes/* - remove setSessionFile calls, update events
- examples/hooks/* - update to new API
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    29fec7848e
  • Update plan: HookCommandContext without sendMessage (use pi closure)
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    09e7e9196c
  • Add Agent.prompt(AppMessage) overload for custom message types 
    Instead of using continue() which validates roles, prompt() now accepts
an AppMessage directly. This allows hook messages with role: 'hookMessage'
to trigger proper agent loop with message events.

- Add overloads: prompt(AppMessage) and prompt(string, attachments?)
- sendHookMessage uses prompt(appMessage) instead of appendMessage+continue
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    a6322fda59
  • Use proper HookAppMessage type instead of _hookData marker 
    Following the same pattern as BashExecutionMessage:
- HookAppMessage has role: 'hookMessage' with customType, content, display, details
- isHookAppMessage() type guard for checking message type
- messageTransformer converts to user message for LLM context
- TUI checks isHookAppMessage() for rendering as CustomMessageComponent

This makes the API clean for anyone building on AgentSession - they can
use the type guard instead of knowing about internal marker fields.
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    75a9c3c714
  • Add emitLastMessage flag to agent.continue() 
    When calling continue() with emitLastMessage=true, the agent loop
emits message_start/message_end events for the last message in context.
This allows messages added outside the loop (e.g., hook messages via
sendHookMessage) to trigger proper TUI rendering.

Changes across packages:
- packages/ai: agentLoopContinue() accepts emitLastMessage parameter
- packages/agent: Agent.continue(), transports updated to pass flag
- packages/coding-agent: sendHookMessage passes true when triggerTurn
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    357bd946c2
  • Hook commands: remove string return, use sendMessage() for prompting 
    - Command handler now returns Promise<void> instead of Promise<string | undefined>
- To trigger LLM response, use sendMessage() with triggerTurn: true
- Simplify _tryExecuteHookCommand to return boolean

Added example hook and slash command in .pi/:
- .pi/hooks/test-command.ts - /greet command using sendMessage
- .pi/commands/review.md - file-based /review command
    Mario Zechner · 2025-12-30 22:42:18 +01:00
    30cd723411
  • Move hook command execution to AgentSession.prompt() 
    Hook commands registered via pi.registerCommand() are now handled in
AgentSession.prompt() alongside file-based slash commands. This:

- Removes duplicate tryHandleHookCommand from interactive-mode and rpc-mode
- All modes (interactive, RPC, print) share the same command handling logic
- AgentSession._tryExecuteHookCommand() builds CommandContext using:
  - UI context from hookRunner (set by mode)
  - sessionManager, modelRegistry from AgentSession
  - sendMessage via sendHookMessage
  - exec via exported execCommand
- Handler returning string uses it as prompt, undefined returns early

Also:
- Export execCommand from hooks/runner.ts
- Add getUIContext() and getHasUI() to HookRunner
- Make HookRunner.emitError() public for error reporting
    Mario Zechner · 2025-12-30 22:42:18 +01:00
    c8d9382aaa
  • Hook API: replace send() with sendMessage(), add appendEntry() and registerCommand() 
    Breaking changes to Hook API:
- pi.send(text, attachments?) replaced with pi.sendMessage(message, triggerTurn?)
  - Creates CustomMessageEntry instead of user messages
  - Properly handles queuing during streaming via agent loop
  - Supports optional turn triggering when idle
- New pi.appendEntry(customType, data?) for hook state persistence
- New pi.registerCommand(name, options) for custom slash commands
- Handler types renamed: SendHandler -> SendMessageHandler, new AppendEntryHandler

Implementation:
- AgentSession.sendHookMessage() handles all three cases:
  - Streaming: queues message with _hookData marker, agent loop processes it
  - Not streaming + triggerTurn: appends to state/session, calls agent.continue()
  - Not streaming + no trigger: appends to state/session only
- message_end handler routes based on _hookData presence to correct persistence
- HookRunner gains getRegisteredCommands() and getCommand() methods

New types: HookMessage<T>, RegisteredCommand, CommandContext
    Mario Zechner · 2025-12-30 22:42:18 +01:00
    ba185b0571
  • 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
  • Make CompactionEntry and CompactionResult generic with details field 
    - CompactionEntry<T> and CompactionResult<T> now have optional details?: T
- appendCompaction() accepts optional details parameter
- Hooks can return compaction.details to store custom data
- Enables structured compaction with ArtifactIndex (see #314)
- Fix CompactionResult export location (now from compaction.ts)
- Update plan with remaining compaction refactor items
    Mario Zechner · 2025-12-30 22:42:18 +01:00
    d96375b5e5
  • Session tree: simplify types, add branching API, comprehensive tests 
    Types:
- SessionEntryBase with type field, extended by all entry types
- CustomEntry for hooks (type: 'custom', customType, data)
- Remove XXXContent types and TreeNode (redundant)

API:
- Rename saveXXX to appendXXX with JSDoc explaining tree semantics
- Rename branchInPlace to branch() with better docs
- Add createBranchedSession(leafId) replacing index-based version
- Add getTree() returning SessionTreeNode[] for tree traversal
- Add appendCustomEntry(customType, data) for hooks

Tests:
- tree-traversal.test.ts: 28 tests covering append, getPath, getTree,
  branch, branchWithSummary, createBranchedSession
- save-entry.test.ts: custom entry integration

Docs:
- Class-level JSDoc explaining append-only tree model
- Method docs explaining leaf advancement and branching
- CHANGELOG.md entry for all changes
    Mario Zechner · 2025-12-30 22:42:18 +01:00
    6f94e24629
  • Fix SessionEntry type to exclude SessionHeader 
    - SessionEntry now only contains conversation entries (messages, compaction, etc.)
- SessionHeader is separate, not part of SessionEntry
- FileEntry = SessionHeader | SessionEntry (for file storage)
- getEntries() filters out header, returns SessionEntry[]
- Added getHeader() for accessing session metadata
- Updated compaction and tests to not expect header in entries
- Updated mom package to use FileEntry for internal storage
    Mario Zechner · 2025-12-30 22:42:17 +01:00
    9478a3c1f5
  • Session tree structure with id/parentId linking 
    - Add TreeNode base type with id, parentId, timestamp
- Add *Content types for clean input/output separation
- Entry types are now TreeNode & *Content intersections
- SessionManager assigns id/parentId on save, tracks leafId
- Add migrateSessionEntries() for v1 to v2 conversion
- Migration runs on load, rewrites file
- buildSessionContext() uses tree traversal from leaf
- Compaction returns CompactionResult (content only)
- Hooks return compaction content, not full entries
- Add firstKeptEntryId to before_compact hook event
- Update mom package for tree fields
- Better error messages for compaction failures
    Mario Zechner · 2025-12-30 22:42:17 +01:00
    c58d5f20a4
  • Merge pull request #346 from ronyrus/main 
    Improve error message when `apiKey` or `model` are absent
    Mario Zechner · 2025-12-29 13:38:21 +01:00
    65fb9116fb
  • Fix /copy after aborts
    Armin Ronacher · 2025-12-29 11:54:45 +01:00
    e30c4e30cb
  • Improve error message when apiKey or model are absent
    Rony Kelner · 2025-12-29 10:39:04 +09:00
    47b11bf798
  • fix: use consistent model comparison including provider
    Kao Félix · 2025-12-25 22:10:08 +01:00
    a7efe3d4c1
  • Reverse model switching and binding for dialog
    Armin Ronacher · 2025-12-25 18:07:36 +01:00
    b576a527c7
  • 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
  • Fix model selector not showing models with settings.json API keys 
    Fixes #295
    Mario Zechner · 2025-12-24 21:23:44 +01:00
    ac5f4a77cc
  • Improve compaction hooks: add signal, no timeout, SessionManager cleanup, docs
    Mario Zechner · 2025-12-24 13:54:05 +01:00
    705ba5d4f2
  • Add previousSummary to before_compact hook event
    Mario Zechner · 2025-12-24 12:47:12 +01:00
    403faafdbe
  • Improve before_compact hook: add messagesToKeep, replace apiKey with resolveApiKey
    Mario Zechner · 2025-12-24 12:41:22 +01:00
    d9a542763a
  • Add resolveApiKey to before_compact hook event
    Mario Zechner · 2025-12-24 12:28:51 +01:00
    43a5447a80
  • feat: Improve HTML export with markdown rendering and theme support 
    - Render markdown server-side using marked (tables, headings, code blocks, etc.)
- Honor user's chosen theme (light/dark) with appropriate color defaults
- Add image rendering for user messages
- Style code blocks with TUI-like ```language markers
    scutifer · 2025-12-24 12:13:15 +01:00
    531bb91337
  • Add before_compact hook event (closes #281) (#285) 
    * Add before_compact hook event (closes #281)

* Add compact hook event and documentation

- Add compact event that fires after compaction completes
- Update hooks.md with lifecycle diagram, field docs, and example
- Add CHANGELOG entry
- Add comprehensive test coverage (10 tests) for before_compact and compact events
- Tests cover: event emission, cancellation, custom entry, error handling, multiple hooks
    Nico Bailon · 2025-12-24 11:26:29 +01:00
    1e1a92ea47
  • List all provider keys in README settings example
    Mario Zechner · 2025-12-24 02:42:41 +01:00
    81b10f2fa0
  • Use injected resolveApiKey in AgentSession for settings.json support
    Mario Zechner · 2025-12-24 02:35:42 +01:00
    541758fbe0
  • Allow startup without API keys, fixes #288
    Mario Zechner · 2025-12-24 01:52:59 +01:00
    e234e8d18f
  • Add skipConversationRestore for before_branch hooks (#286)
    Nico Bailon · 2025-12-23 03:26:08 +01:00
    2953a9d8d4
  • 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 session-manager simplification issues 
    - Remove unused inspector import from session-manager.ts
- Remove dead code in _persist()
- Update tests for simplified SessionHeader
- Update mom context.ts: remove unused AgentState import, fix startSession(), rename isEnabled to isPersisted
    Mario Zechner · 2025-12-22 02:43:38 +01:00
    0faadfcd00
  • feat(coding-agent): add configurable skills directories (#269)
    Nico Bailon · 2025-12-21 20:48:40 +01:00
    70440f7591
  • fix(coding-agent): add connection error to retryable errors 
    Fixes #252
    Mario Zechner · 2025-12-20 09:55:03 +01:00
    c1382818cc
  • 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
  • feat: add xhigh thinking level support for gpt-5.2 models 
    - Add supportsXhigh() function to ai package for checking xhigh support
- Clamp xhigh to high for OpenAI models that don't support it
- Update coding-agent to use centralized supportsXhigh()
- gpt-5.2, gpt-5.2-codex now show xhigh in thinking selector

Closes #236
    Mario Zechner · 2025-12-19 20:07:24 +01:00
    7e38897673
  • 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
  • Check for compaction before prompt submission, not just after agent turn
    Mario Zechner · 2025-12-17 22:25:20 +01:00
    d5dde00d28
  • 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
  • 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
  • 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 queued messages.
    Mario Zechner · 2025-12-09 23:51:22 +01:00
    942d8d3c95
  • 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