agent/pi - pi - Penguin

fix(coding-agent): stream large session files

closes #5231

Mario Zechner · 2026-05-30 21:21:42 +02:00

3911d6f5cd

fix(coding-agent): scope custom session dir lookups

Armin Ronacher · 2026-05-28 23:25:33 +02:00

4b4641c6b0

feat(session): Explicit session id naming (#5076 )

Armin Ronacher · 2026-05-27 21:32:10 +02:00

52dc08c1f7

fix(coding-agent): Clean up Path Handling (#4873 )

Armin Ronacher · 2026-05-22 11:25:15 +02:00

c100620bf4

chore(ts): use source import extensions

Armin Ronacher · 2026-05-20 00:04:03 +02:00

ae9450dc51

fix(coding-agent): cap resume session metadata loads

closes #4583

closes #4591

Mario Zechner · 2026-05-16 23:08:12 +02:00

758004d1bb

fix(agent): correct uuidv7 sequence handling

Armin Ronacher · 2026-05-13 15:53:53 +02:00

c00f1cf130

chore(deps): Kill small dependencies (#4467 )

Armin Ronacher · 2026-05-13 10:44:56 +02:00

2829146dde

chore: migrate pi packages to earendil works scope

Mario Zechner · 2026-05-07 15:59:42 +02:00

3e5ad67e0f

fix: align OpenAI cache affinity and use uuidv7 session ids

Mario Zechner · 2026-04-14 23:20:13 +02:00

018b40c30c

fix(coding-agent): handle missing session cwd

Mario Zechner · 2026-04-05 21:24:32 +02:00

080af6fc06

feat(coding-agent): add label timestamps to the session tree (#2691 )

warren · 2026-03-30 15:56:37 +02:00

84d2b51a2e

fix(coding-agent): respect agentDir for sdk session paths closes #2457

Mario Zechner · 2026-03-20 12:12:18 +01:00

6c8ac01947

fix(coding-agent): handle empty session titles and session info metadata (#2304 )

* fix(coding-agent): handle empty session titles in tree

* fix(coding-agent): ignore session info in summaries

* docs: update changelog for PR #2304

Aliou Diallo · 2026-03-17 16:22:04 +01:00

18d90b5c48

feat(session-manager): allow supplying custom session ID in newSession() (#2130 )

* feat(session-manager): allow supplying custom session ID in newSession()

Add optional `id` field to `NewSessionOptions`. When provided, this ID
is used as the session ID instead of generating a random UUID. Existing
callers are unaffected since the field is optional and falls back to
`randomUUID()`.

Closes #2097

* test(session-manager): add tests for custom session ID in newSession()

Verify that newSession() uses the provided id when supplied, falls back
to randomUUID() when omitted, and includes the custom id in the session
header.

Haoyu Zha · 2026-03-14 01:34:48 +01:00

f04d9bc428

fix(coding-agent): prevent duplicate session headers when forking from pre-assistant entry

createBranchedSession() wrote the file and set flushed=true even when the
branched path had no assistant message. The next _persist() call saw no
assistant, reset flushed=false, and the subsequent flush appended all
in-memory entries to the already-populated file, duplicating the header
and entries.

Fix: defer file creation when the branched path has no assistant message,
matching the newSession() contract. _persist() creates the file on the
first assistant response.

closes #1672

Mario Zechner · 2026-02-27 22:18:26 +01:00

2f64df1e52

fix(coding-agent): persist user message after fork

When hasAssistant guard returns early, set flushed=false so
the next persist (after assistant arrives) writes all entries
including the user message.

Mario Zechner · 2026-02-04 13:35:45 +01:00

b5be54b8ef

fix(coding-agent): fork writes to new session file, not parent (fixes #1242 )

- Store previousSessionFile before creating branched session
- Update sessionFile after writing new branch file
- Pass parentSession when forking from first message
- Add --local to git config in tests to prevent repo escape

Mario Zechner · 2026-02-04 13:22:43 +01:00

13ac63c3cd

feat(coding-agent): add threaded sort mode to /resume with tree display

Adds 'Threaded' as a new sort mode (now default) that displays sessions
in a tree structure based on parent-child relationships. The tree is
sorted by root session's modified date. Other sort modes (Recent, Fuzzy)
continue to show flat lists.

Sort mode cycles: Threaded -> Recent -> Fuzzy -> Threaded

Petr Baudis · 2026-01-31 23:17:05 +01:00

42d54e0d1c

Rename session from /resume session list (#863 )

* Add session renaming in interactive mode resume picker

Session list now displays last message timestamp as modified time
instead of file mtime. Ctrl+N enters rename mode in the interactive
resume picker, allowing quick session renaming without leaving the
selector. Rename hint is shown only in interactive mode, not in the
CLI --resume picker./

* Add docs entry for renaming in picker

* Update shortcut to ctrl+r for session renaming

Sergii Kozak · 2026-01-25 19:42:34 +01:00

b5873507c1

Fixes #933

Mario Zechner · 2026-01-25 02:47:17 +01:00

6b4188fa0b

fix(session): improve session ID resolution with global search and fork support (#785 )

When using `--session <UUID>`, the session lookup now:

1. Searches locally first (current project's session directory)
2. Falls back to global search across all projects
3. If found in different project, prompts user to fork the session
4. If not found anywhere, shows clear error instead of silently creating
   a broken session with malformed path

Adds `SessionManager.forkFrom()` to create a forked session from another
project, preserving full conversation history with updated cwd.

Rafał Krzyważnia · 2026-01-16 20:18:10 +01:00

48b4324155

fix(coding-agent): make /new create a new session file

fixes #649

Mario Zechner · 2026-01-12 17:06:33 +01:00

234f367d0d

feat(coding-agent): add session naming via /name command and extension API

- Add SessionInfoEntry type for session metadata
- Add /name <name> command to set session display name
- Add pi.setSessionName() and pi.getSessionName() extension API
- Session selector shows name (in warning color) instead of first message when set
- Session name included in fuzzy search
- /session command displays name when set

closes #650

Mario Zechner · 2026-01-12 16:56:39 +01:00

8f95a13e07

feat(coding-agent): add resume scope toggle with async loading

- /resume and --resume now toggle between Current Folder and All sessions with Tab
- SessionManager.list() and listAll() are now async with optional progress callback
- Shows loading progress (e.g. Loading 5/42) while scanning sessions
- SessionInfo.cwd field shows session working directory in All view
- Lazy loading: All sessions only loaded when user presses Tab

closes #619

Co-authored-by: Thomas Mustier <mustierthomas@gmail.com>

Mario Zechner · 2026-01-12 00:00:03 +01:00

302404684f

feat(coding-agent): add resume scope toggle

refactor(coding-agent): refine session listing helpers

Thomas Mustier · 2026-01-11 20:51:20 +00:00

e8d91f2bd4

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

Consolidate session events: remove session_before_new/session_new, add reason field to switch events

- Remove session_before_new and session_new hook events
- Add reason: 'new' | 'resume' to session_before_switch and session_switch events
- Remove 'new' reason from custom tool onSession (use 'switch' for both /new and /resume)
- Rename reset() to newSession(options?) in AgentSession
- Add NewSessionOptions with optional parentSession for lineage tracking
- Rename branchedFrom to parentSession in SessionHeader
- Rename RPC reset command to new_session with optional parentSession
- Update example hooks to use new event structure
- Update documentation and changelog

Based on discussion in #293

Mario Zechner · 2026-01-01 23:31:26 +01:00

484d7e06bb

Rework custom tools API with CustomToolContext

- CustomAgentTool renamed to CustomTool
- ToolAPI renamed to CustomToolAPI
- ToolContext renamed to CustomToolContext
- ToolSessionEvent renamed to CustomToolSessionEvent
- Added CustomToolContext parameter to execute() and onSession()
- CustomToolFactory now returns CustomTool<any, any> for type compatibility
- dispose() replaced with onSession({ reason: 'shutdown' })
- Added wrapCustomTool() to convert CustomTool to AgentTool
- Session exposes setToolUIContext() instead of leaking internals
- Fix ToolExecutionComponent to sync with toolOutputExpanded state
- Update all custom tool examples for new API

Mario Zechner · 2025-12-31 12:05:24 +01:00

568150f18b

Pass fromHook to appendCompaction for both manual and auto compaction

Mario Zechner · 2025-12-30 22:42:24 +01:00

d4dc07ab20

Add fromHook field to CompactionEntry and BranchSummaryEntry

- fromHook: true = hook generated, skip file extraction
- fromHook: undefined/false = pi generated, extract files (backward compatible)
- branchWithSummary now accepts fromHook parameter
- File extraction only runs for !entry.fromHook entries

Mario Zechner · 2025-12-30 22:42:24 +01:00

f118cdc67b

Store file lists in BranchSummaryEntry.details for cumulative tracking

- BranchSummaryResult now returns readFiles and modifiedFiles separately
- BranchSummaryDetails type for details: { readFiles, modifiedFiles }
- branchWithSummary accepts optional details parameter
- Collect files from existing branch_summary.details when preparing entries
- Files accumulate across nested branch summaries

Mario Zechner · 2025-12-30 22:42:24 +01:00

4ef3325cec

Add ReadonlySessionManager and refactor branch summarization

- Add ReadonlySessionManager interface to session-manager.ts
- Re-export from hooks/index.ts
- Add collectEntriesForBranchSummary() to extract entries for summarization
- Don't stop at compaction boundaries (include their summaries as context)
- Add token budget support to prepareBranchEntries()
- Walk entries newest-to-oldest to prioritize recent context
- Use options object for generateBranchSummary()
- Handle compaction entries as context summaries
- Export new types: CollectEntriesResult, GenerateBranchSummaryOptions

Mario Zechner · 2025-12-30 22:42:23 +01:00

08fab16e2d

Add tree navigation tests and shared test utilities

- Add test/utilities.ts with shared helpers (API_KEY, userMsg, assistantMsg, createTestSession)
- Add agent-session-tree-navigation.test.ts with e2e tests for tree navigation
- Add getChildren() method to SessionManager
- Add summaryEntry to navigateTree return type
- Update existing tests to use shared utilities

Mario Zechner · 2025-12-30 22:42:23 +01:00

31c5cd38d1

Fix branch summarization abort handling and tree navigation

- Check response.stopReason instead of catching errors for abort detection
- Return result object from _generateBranchSummary instead of throwing
- Fix summary attachment: attach to navigation target position, not old branch
- Support root-level summaries (parentId=null) in branchWithSummary
- Remove setTimeout hack for re-showing tree selector on abort

Mario Zechner · 2025-12-30 22:42:23 +01:00

01dae9ebcc

Add global debug key (Shift+Ctrl+D), iterative tree sorting to avoid stack overflow

Mario Zechner · 2025-12-30 22:42:22 +01:00

544814875e

feat(coding-agent): implement /tree command for session tree navigation

- Add TreeSelectorComponent with ASCII tree visualization
- Add AgentSession.navigateTree() for switching branches
- Add session_before_tree/session_tree hook events
- Add SessionManager.resetLeaf() for navigating to root
- Change leafId from string to string|null for consistency with parentId
- Support optional branch summarization when switching
- Update buildSessionContext() to handle null leafId
- Add /tree to slash commands in interactive mode

Mario Zechner · 2025-12-30 22:42:22 +01:00

4958271dd3

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

Use exhaustive switch on message.role throughout coding-agent

- addMessageToChat: exhaustive switch for all AgentMessage roles
- renderSessionContext: delegates to addMessageToChat, special handling for assistant tool calls and tool results
- export-html formatMessage: exhaustive switch for all AgentMessage roles
- Removed isHookMessage, isBashExecutionMessage type guards in favor of role checks
- Fixed imports and removed unused getLatestCompactionEntry

Mario Zechner · 2025-12-30 22:42:21 +01:00

b921298af7

Fix hook message duplication in TUI

Two bugs:
1. createCustomMessage was returning role: 'user' instead of preserving
   the hook message structure (role: 'hookMessage', customType, etc.)
2. rebuildChatFromMessages wasn't clearing the container before rebuilding

Mario Zechner · 2025-12-30 22:42:21 +01:00

ecef601d19

WIP: Refactor agent package - not compiling

- Renamed AppMessage to AgentMessage throughout
- New agent-loop.ts with AgentLoopContext, AgentLoopConfig
- Removed transport abstraction, Agent now takes streamFn directly
- Extracted streamProxy to proxy.ts utility
- Removed agent-loop from pi-ai (now in agent package)
- Updated consumers (coding-agent, mom) for AgentMessage rename
- Tests updated but some consumers still need migration

Known issues:
- AgentTool, AgentToolResult not exported from pi-ai
- Attachment not exported from pi-agent-core
- ProviderTransport removed but still referenced
- messageTransformer -> convertToLlm migration incomplete
- CustomMessages declaration merging not working properly

Mario Zechner · 2025-12-30 22:42:20 +01:00

a055fd4481

Cleanup: unify HookMessage naming and simplify SessionContext

- Rename HookAppMessage to HookMessage, isHookAppMessage to isHookMessage
- Remove entries array from SessionContext (use isHookMessage type guard instead)
- HookMessage.content now accepts string directly (not just array)
- Fix streamMessage type in AgentState (AppMessage, not Message)
- Rename CustomMessageComponent to HookMessageComponent
- Fix test hook to use pi.sendMessage

Mario Zechner · 2025-12-30 22:42:20 +01:00

204d27581b

Fix: handle branch_summary in kept messages before compaction