10 Commits

• 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
• 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
• Fix test: getLeafId returns null for empty session, not empty string
  Mario Zechner · 2025-12-30 22:42:23 +01:00
  aee61b1a6b
• 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
• 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
• Add label support for session entries

  - Add LabelEntry type with targetId and label (string | undefined)
  - Add labelsById map built on load via linear scan
  - Add getLabel(id) and appendLabelChange(targetId, label) methods
  - Add label field to SessionTreeNode, populated by getTree()
  - Update createBranchedSession to preserve labels for entries on path
  - Labels are ignored by buildSessionContext (not sent to LLM)
  - Add comprehensive tests for label functionality

  Mario Zechner · 2025-12-30 22:42:18 +01:00
  9e68a59fed
• 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
• Refactor session manager: migration chain, validation, tests

  - Add migrateV1ToV2/migrateToCurrentVersion for extensible migrations
  - createSummaryMessage now takes timestamp from entry
  - loadEntriesFromFile validates session header
  - findMostRecentSession only returns valid session files (reads first 512 bytes)
  - Remove ConversationEntry alias
  - Fix mom context.ts TreeNode type
  
  Tests:
  - migration.test.ts: v1 migration, idempotency
  - build-context.test.ts: 14 tests covering trivial, compaction, branches
  - file-operations.test.ts: loadEntriesFromFile, findMostRecentSession

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