agent/pi
1
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,325 Commits 32 Branches 288 Tags
04f2fcf004015ffecea34616ca72e53bde99cbb1
Commit Graph

27 Commits

  • refactor(hooks): split session events into individual typed events 
    Major changes:
- Replace monolithic SessionEvent with reason discriminator with individual
  event types: session_start, session_before_switch, session_switch,
  session_before_new, session_new, session_before_branch, session_branch,
  session_before_compact, session_compact, session_shutdown
- Each event has dedicated result type (SessionBeforeSwitchResult, etc.)
- HookHandler type now allows bare return statements (void in return type)
- HookAPI.on() has proper overloads for each event with correct typing

Additional fixes:
- AgentSession now always subscribes to agent in constructor (was only
  subscribing when external subscribe() called, breaking internal handlers)
- Standardize on undefined over null throughout codebase
- HookUIContext methods return undefined instead of null
- SessionManager methods return undefined instead of null
- Simplify hook exports to 'export type * from types.js'
- Add detailed JSDoc for skipConversationRestore vs cancel
- Fix createBranchedSession to rebuild index in persist mode
- newSession() now returns the session file path

Updated all example hooks, tests, and emission sites to use new event types.
    Mario Zechner · 2025-12-30 22:42:22 +01:00
    d6283f99dc
  • Remove allowDuringStreaming flag - commands always run immediately 
    Hook commands now always execute immediately, even during streaming.
If a command needs to interact with the LLM, it uses pi.sendMessage()
which handles queueing automatically.

This simplifies the API and eliminates the issue of queued slash
commands being sent to the LLM instead of executing.
    Mario Zechner · 2025-12-30 22:42:22 +01:00
    575c875475
  • Rename immediate -> allowDuringStreaming for hook commands
    Mario Zechner · 2025-12-30 22:42:22 +01:00
    f8352bb7d7
  • WIP: Major cleanup - move Attachment to consumers, simplify agent API 
    - Removed Attachment from agent package (now in web-ui/coding-agent)
- Agent.prompt now takes (text, images?: ImageContent[])
- Removed transports from web-ui (duplicate of agent package)
- Updated coding-agent to use local message types
- Updated mom package for new agent API

Remaining: Fix AgentInterface.ts to compose UserMessageWithAttachments
    Mario Zechner · 2025-12-30 22:42:20 +01:00
    6ddc7418da
  • Fix snake border alignment using visibleWidth for proper ANSI length calculation
    Mario Zechner · 2025-12-30 22:42:20 +01:00
    6977bc73ca
  • Snake: add full border frame and pause/resume with session persistence 
    - Full box border around title, game area, and instructions
- ESC pauses and saves state to session via pi.appendEntry()
- Resume shows 'PAUSED - press any key to continue'
- Q quits and clears saved state
- High score persists across games
    Mario Zechner · 2025-12-30 22:42:20 +01:00
    b47151a04f
  • Fix snake velocity: render cells as 2 chars wide for square aspect 
    Terminal cells are ~2:1 aspect ratio, so movement appeared faster
vertically. Now each game cell is 2 characters wide.
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    5ae33defd3
  • Improve snake game visuals 
    - Rounded box corners (╭╮╰╯)
- Better characters: ● head, ○ body, ◆ food, · empty
- Colored title with emoji
- Dimmed borders and help text
- Bold highlights for score and controls
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    516c0ea8bc
  • Add immediate flag to hook commands for non-queued execution 
    Commands with immediate: true run right away even during streaming.
Used for UI-only commands like /snake that don't interact with LLM.
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    818196d2c3
  • Fix snake.ts: use key helpers from pi-tui for ESC and arrow keys
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    165fb58b39
  • Add ui.custom() for custom hook components with keyboard focus 
    - Add custom() to HookUIContext: returns { close, requestRender }
- Component receives keyboard input via handleInput()
- CustomMessageComponent default rendering now limits to 5 lines when collapsed
- Add snake.ts example hook with /snake command
    Mario Zechner · 2025-12-30 22:42:19 +01:00
    14ad8d6228
  • 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
  • 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
  • Fix API key priority and compaction bugs 
    - getEnvApiKey: ANTHROPIC_OAUTH_TOKEN now takes precedence over ANTHROPIC_API_KEY
- findCutPoint: Stop scan-backwards loop at session header (was decrementing past it causing null preparation)
- generateSummary/generateTurnPrefixSummary: Throw on stopReason=error instead of returning empty string
- Test files: Fix API key priority order, use keepRecentTokens=1 for small test conversations
    Mario Zechner · 2025-12-30 22:42:17 +01:00
    251fea752c
  • 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
  • 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: Remove global state from pi-ai OAuth/API key handling 
    - Remove setApiKey, resolveApiKey, and global apiKeys Map from stream.ts
- Rename getApiKey to getApiKeyFromEnv (only checks env vars)
- Remove OAuth storage layer (storage.ts deleted)
- OAuth login/refresh functions now return credentials instead of saving
- getOAuthApiKey/refreshOAuthToken now take credentials as params
- Add test/oauth.ts helper for ai package tests
- Simplify root npm run check (single biome + tsgo pass)
- Remove redundant check scripts from most packages
- Add web-ui and coding-agent examples to biome/tsgo includes

coding-agent still has compile errors - needs refactoring for new API
    Mario Zechner · 2025-12-25 01:01:03 +01:00
    030788140a
  • 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
  • Update full-compaction example to use resolveApiKey
    Mario Zechner · 2025-12-24 12:30:00 +01:00
    e4283294c8
  • Add full-compaction hook example
    Mario Zechner · 2025-12-24 12:25:36 +01:00
    5aa53ded11
  • 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
  • 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