14 Commits

• 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
• refactor(coding-agent): fix compaction for branched sessions, consolidate hook context types

  Compaction API:
  - prepareCompaction() now takes (pathEntries, settings) only
  - CompactionPreparation restructured: removed cutPoint/messagesToKeep/boundaryStart, added turnPrefixMessages/isSplitTurn/previousSummary/fileOps/settings
  - compact() now takes (preparation, model, apiKey, customInstructions?, signal?)
  - Fixed token overflow by using getPath() instead of getEntries()
  
  Hook types:
  - HookEventContext renamed to HookContext
  - HookCommandContext removed, RegisteredCommand.handler takes (args, ctx)
  - HookContext now includes model field
  - SessionBeforeCompactEvent: removed previousCompactions/model, added branchEntries
  - SessionBeforeTreeEvent: removed model (use ctx.model)
  - HookRunner.initialize() added for modes to set up callbacks

  Mario Zechner · 2025-12-31 02:24:24 +01:00
  ddda8b124c
• 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
• 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
• 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
• Refactor: shared exec utility, rename CustomMessageRenderer to HookMessageRenderer

  - Extract execCommand to src/core/exec.ts, shared by hooks and custom-tools
  - Rename CustomMessageRenderer -> HookMessageRenderer
  - Rename registerCustomMessageRenderer -> registerMessageRenderer
  - Renderer now receives HookMessage instead of CustomMessageEntry
  - CustomMessageComponent now has setExpanded() and responds to Ctrl+E toggle
  - Re-export ExecOptions/ExecResult from exec.ts for backward compatibility

  Mario Zechner · 2025-12-30 22:42:19 +01:00
  a8866d7a83
• Fix tests for sessionManager/modelRegistry on context

  - compaction-hooks-example.test.ts: get sessionManager/modelRegistry from ctx
  - compaction-hooks.test.ts:
    - Pass sessionManager/modelRegistry to HookRunner constructor
    - Remove setSessionFile call
    - Update tests to use session.sessionManager instead of event.sessionManager

  Mario Zechner · 2025-12-30 22:42:19 +01:00
  5fee9005b7
• 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
• Add CustomMessageEntry rendering infrastructure

  - Add renderCustomMessage to HookAPI for registering custom renderers
  - Add CustomMessageRenderer type and CustomMessageRenderOptions
  - Store customMessageRenderers in LoadedHook
  - Add getCustomMessageRenderer(customType) to HookRunner
  - SessionContext.entries now aligned with messages (same length, corresponding indices)
  
  TUI can now correlate messages with their source entries to identify
  custom_message entries and use hook-provided renderers.

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  11a7845ceb
• 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
• 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
• 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