12 Commits

• Fix: compaction now handles branch_summary and custom_message entries

  - Add getMessageFromEntry helper to extract AppMessage from any context-producing entry
  - Update findValidCutPoints to treat branch_summary/custom_message as valid cut points
  - Update findTurnStartIndex to recognize branch_summary/custom_message as turn starters
  - Update all message extraction loops to use getMessageFromEntry

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  beb804cda0
• 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
• 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
• 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
• Improve before_compact hook: add messagesToKeep, replace apiKey with resolveApiKey
  Mario Zechner · 2025-12-24 12:41:22 +01:00
  d9a542763a
• 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
• Enable more biome lints and fix things
  Mario Zechner · 2025-12-21 22:56:20 +01:00
  d5fd685901
• 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
• Reorganize file structure: core/, utils/, modes/interactive/components/, modes/interactive/theme/
  Mario Zechner · 2025-12-09 00:51:33 +01:00
  83a6c26969