3 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
• 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