@tecet/ollm 0.1.4 → 0.1.5

package/docs/Tools/Architecture.md

@@ -1,884 +0,0 @@
-# Tool Execution System Architecture
-
-**Technical Architecture and Design of the Tool System**
-
----
-
-## Table of Contents
-
-1. [Overview](#overview)
-2. [System Architecture](#system-architecture)
-3. [Core Components](#core-components)
-4. [Tool Categories](#tool-categories)
-5. [Data Flow](#data-flow)
-6. [Integration Points](#integration-points)
-7. [Design Decisions](#design-decisions)
-8. [Security Model](#security-model)
-
-**See Also:**
-
-- [Tool User Guide](UserGuide.md) - Using tools
-- [MCP Architecture](../MCP/MCP_Architecture.md) - MCP tool integration
-- [Hook Architecture](../Hooks/Architecture.md) - Hook system integration
-
----
-
-## Overview
-
-The Tool Execution System manages tool registration, validation, permission checking, and execution. It provides a unified interface for built-in tools, MCP tools, and dynamically registered tools.
-
-### Key Features
-
-- ✅ Unified tool registry for all tool types
-- ✅ Schema-based parameter validation
-- ✅ Permission-based approval system
-- ✅ Dynamic tool registration at runtime
-- ✅ MCP tool integration
-- ✅ Result formatting and truncation
-- ✅ Error handling and recovery
-
----
-
-## System Architecture
-
-### High-Level Architecture
-
-```mermaid
-graph TB
-    subgraph Sources["Tool Sources"]
-        BuiltIn["Built-in Tools"]
-        MCP["MCP Tools"]
-        Dynamic["Dynamic Tools"]
-        Extension["Extension Tools"]
-    end
-
-    subgraph ToolSystem["Tool System"]
-        Registry["Tool Registry"]
-        Validator["Parameter Validator"]
-        Policy["Policy Engine"]
-        Executor["Tool Executor"]
-        Formatter["Result Formatter"]
-    end
-
-    subgraph LLM["LLM Integration"]
-        Provider["Provider"]
-        Agent["Agent"]
-    end
-
-    Sources --> Registry
-    Registry --> Validator
-    Validator --> Policy
-    Policy --> Executor
-    Executor --> Formatter
-    Formatter --> Provider
-    Provider --> Agent
-
-    style ToolSystem fill:#f9f,stroke:#333,stroke-width:2px
-    style Sources fill:#bbf,stroke:#333,stroke-width:2px
-    style LLM fill:#bfb,stroke:#333,stroke-width:2px
-```
-
-### Component Interaction Flow
-
-```mermaid
-flowchart LR
-    LLM[LLM Request] --> Registry[Tool Registry]
-    Registry --> Validate[Validate Parameters]
-    Validate --> Policy[Check Permissions]
-    Policy --> Execute[Execute Tool]
-    Execute --> Format[Format Result]
-    Format --> Return[Return to LLM]
-
-    style LLM fill:#e1f5ff
-    style Policy fill:#fff4e1
-    style Execute fill:#e8f5e9
-    style Return fill:#f3e5f5
-```
-
----
-
-## Core Components
-
-### 1. Tool Registry
-
-**Location:** `packages/core/src/tools/tool-registry.ts`
-
-**Responsibilities:**
-
-- Register and store tool definitions
-- Provide tool list to LLM
-- Route tool execution requests
-- Manage tool lifecycle
-
-**Key Methods:**
-
-```typescript
-interface ToolRegistry {
-  registerTool(definition: ToolDefinition): void;
-  unregisterTool(name: string): void;
-  getTool(name: string): ToolDefinition | undefined;
-  getAllTools(): ToolDefinition[];
-  executeTool(name: string, args: any): Promise<any>;
-}
-```
-
-**Tool Definition:**
-
-```typescript
-interface ToolDefinition {
-  name: string;
-  description: string;
-  inputSchema: {
-    type: 'object';
-    properties: Record<string, ParameterSchema>;
-    required: string[];
-  };
-  execute: (args: any) => Promise<any>;
-}
-```
-
-### 2. Parameter Validator
-
-**Location:** `packages/core/src/tools/validation.ts`
-
-**Responsibilities:**
-
-- Validate parameters against schema
-- Type checking
-- Required field verification
-- Value range validation
-
-**Validation Flow:**
-
-```mermaid
-flowchart TD
-    Start[Tool Call] --> CheckExists{Tool Exists?}
-    CheckExists -->|No| ErrorNotFound[Error: Tool Not Found]
-    CheckExists -->|Yes| ValidateSchema[Validate Against Schema]
-
-    ValidateSchema --> CheckRequired{All Required?}
-    CheckRequired -->|No| ErrorRequired[Error: Missing Required]
-    CheckRequired -->|Yes| CheckTypes{Types Match?}
-
-    CheckTypes -->|No| ErrorType[Error: Type Mismatch]
-    CheckTypes -->|Yes| CheckValues{Values Valid?}
-
-    CheckValues -->|No| ErrorValue[Error: Invalid Value]
-    CheckValues -->|Yes| Success[Validation Success]
-
-    style Start fill:#e1f5ff
-    style Success fill:#e8f5e9
-    style ErrorNotFound fill:#ffe1e1
-    style ErrorRequired fill:#ffe1e1
-    style ErrorType fill:#ffe1e1
-    style ErrorValue fill:#ffe1e1
-```
-
-### 3. Policy Engine
-
-**Location:** `packages/core/src/policy/policyEngine.ts`
-
-**Responsibilities:**
-
-- Check tool permissions
-- Request user approval
-- Evaluate risk levels
-- Manage approval modes
-
-**Approval Modes:**
-
-```mermaid
-graph TD
-    ToolCall[Tool Call] --> CheckMode{Approval Mode}
-
-    CheckMode -->|YOLO| AutoApprove[Auto-Approve All]
-    CheckMode -->|AUTO| CheckRisk{Check Risk Level}
-    CheckMode -->|ASK| RequestApproval[Request Approval]
-
-    CheckRisk -->|Low| AutoApprove
-    CheckRisk -->|Medium| RequestApproval
-    CheckRisk -->|High| RequestApproval
-
-    RequestApproval --> UserDecision{User Approves?}
-    UserDecision -->|Yes| Execute[Execute Tool]
-    UserDecision -->|No| Block[Block Execution]
-
-    AutoApprove --> Execute
-
-    style AutoApprove fill:#e8f5e9
-    style Execute fill:#e1f5ff
-    style Block fill:#ffe1e1
-```
-
-**Risk Levels:**
-
-- **Low** - Read-only operations (glob, ls, grep, read_file)
-- **Medium** - Write operations (write_file, edit_file)
-- **High** - Dangerous operations (shell, delete)
-
-### 4. Tool Executor
-
-**Location:** `packages/core/src/tools/tool-registry.ts`
-
-**Responsibilities:**
-
-- Execute tool function
-- Handle errors gracefully
-- Capture results
-- Manage timeouts
-
-**Execution Flow:**
-
-```mermaid
-flowchart TD
-    Start[Start Execution] --> Validate[Validate Parameters]
-    Validate --> CheckPermission[Check Permission]
-    CheckPermission --> Approved{Approved?}
-
-    Approved -->|No| Block[Block Execution]
-    Approved -->|Yes| Execute[Execute Tool Function]
-
-    Execute --> Timeout{Timeout?}
-    Timeout -->|Yes| Error[Return Timeout Error]
-    Timeout -->|No| Success{Success?}
-
-    Success -->|No| CatchError[Catch Error]
-    Success -->|Yes| FormatResult[Format Result]
-
-    CatchError --> Error
-    FormatResult --> Return[Return Result]
-
-    Block --> Error
-
-    style Start fill:#e1f5ff
-    style Execute fill:#e8f5e9
-    style Return fill:#f3e5f5
-    style Error fill:#ffe1e1
-```
-
-### 5. Result Formatter
-
-**Location:** `packages/core/src/tools/output-helpers.ts`
-
-**Responsibilities:**
-
-- Format results for LLM
-- Truncate large outputs
-- Add metadata
-- Handle errors
-
-**Truncation Strategy:**
-
-| Output Type        | Size Limit  | Strategy                           |
-| ------------------ | ----------- | ---------------------------------- |
-| File contents      | 10KB        | Show first 5KB + "... [truncated]" |
-| Directory listings | 1000 items  | Show first 500 + count             |
-| Search results     | 100 matches | Show first 50 + count              |
-| Shell output       | 10KB        | Show last 5KB (most recent)        |
-
----
-
-## Tool Categories
-
-### File Discovery Tools
-
-**Purpose:** Find and locate files
-
-| Tool   | Description             | Risk Level |
-| ------ | ----------------------- | ---------- |
-| `glob` | Find files by pattern   | Low        |
-| `ls`   | List directory contents | Low        |
-| `grep` | Search file contents    | Low        |
-
-**Auto-Approve:** ✅ Yes (in AUTO mode)
-
-### File Operations Tools
-
-**Purpose:** Read and write files
-
-| Tool              | Description            | Risk Level |
-| ----------------- | ---------------------- | ---------- |
-| `read_file`       | Read single file       | Low        |
-| `read_many_files` | Read multiple files    | Low        |
-| `edit_file`       | Edit file sections     | Medium     |
-| `write_file`      | Create/overwrite files | Medium     |
-
-**Auto-Approve:**
-
-- Read: ✅ Yes (in AUTO mode)
-- Write: ❌ No (requires approval)
-
-### Web Tools
-
-**Purpose:** Access web resources
-
-| Tool         | Description       | Risk Level |
-| ------------ | ----------------- | ---------- |
-| `web_search` | Search internet   | Low        |
-| `web_fetch`  | Fetch URL content | Low        |
-
-**Auto-Approve:** ✅ Yes (in AUTO mode)
-
-### Shell Tool
-
-**Purpose:** Execute shell commands
-
-| Tool    | Description      | Risk Level |
-| ------- | ---------------- | ---------- |
-| `shell` | Execute commands | High       |
-
-**Auto-Approve:** ❌ No (always requires approval unless YOLO)
-
-**Note:** Shell tool UI enhancement planned (collapsible terminal with visual indicators).
-
-### Memory & Context Tools
-
-**Purpose:** Manage memory and context
-
-| Tool                | Description           | Risk Level |
-| ------------------- | --------------------- | ---------- |
-| `memory`            | Persistent memory     | Low        |
-| `remember`          | Simplified memory     | Low        |
-| `write_memory_dump` | Context snapshot      | Low        |
-| `read_reasoning`    | Review past reasoning | Low        |
-
-**Auto-Approve:** ✅ Yes (in AUTO mode)
-
-### Goal Management Tools
-
-**Purpose:** Manage goals and decisions
-
-| Tool                | Description        | Risk Level |
-| ------------------- | ------------------ | ---------- |
-| `create_goal`       | Create new goal    | Low        |
-| `switch_goal`       | Switch active goal | Low        |
-| `complete_goal`     | Mark goal complete | Low        |
-| `create_checkpoint` | Create checkpoint  | Low        |
-| `record_decision`   | Record decision    | Low        |
-
-**Auto-Approve:** ✅ Yes (in AUTO mode)
-
-**See:** `dev_PromptSystem.md` for goal system architecture
-
----
-
-## Data Flow
-
-### Tool Registration Flow
-
-```mermaid
-flowchart TD
-    Start[Application Startup] --> InitRegistry[Initialize Tool Registry]
-    InitRegistry --> RegisterBuiltIn[Register Built-in Tools]
-
-    RegisterBuiltIn --> FileTools[File Tools]
-    RegisterBuiltIn --> WebTools[Web Tools]
-    RegisterBuiltIn --> ShellTool[Shell Tool]
-    RegisterBuiltIn --> MemoryTools[Memory Tools]
-    RegisterBuiltIn --> GoalTools[Goal Tools]
-
-    FileTools --> RegisterMCP[Register MCP Tools]
-    WebTools --> RegisterMCP
-    ShellTool --> RegisterMCP
-    MemoryTools --> RegisterMCP
-    GoalTools --> RegisterMCP
-
-    RegisterMCP --> ConnectServers[Connect to MCP Servers]
-    ConnectServers --> DiscoverTools[Discover Tools]
-    DiscoverTools --> ConvertSchemas[Convert Schemas]
-    ConvertSchemas --> WrapTools[Wrap with MCPToolWrapper]
-
-    WrapTools --> RegisterDynamic[Register Dynamic Tools]
-    RegisterDynamic --> MemoryDump[write_memory_dump]
-    RegisterDynamic --> HotSwap[trigger_hot_swap]
-    RegisterDynamic --> ExtensionTools[Extension Tools]
-
-    MemoryDump --> Ready[Tools Available to LLM]
-    HotSwap --> Ready
-    ExtensionTools --> Ready
-
-    style Start fill:#e1f5ff
-    style Ready fill:#e8f5e9
-```
-
-### Tool Execution Flow
-
-```mermaid
-flowchart TD
-    LLM[LLM Requests Tool] --> Lookup[Tool Registry Lookup]
-    Lookup --> Exists{Tool Exists?}
-
-    Exists -->|No| ErrorNotFound[Error: Tool Not Found]
-    Exists -->|Yes| Validate[Validate Parameters]
-
-    Validate --> Valid{Valid?}
-    Valid -->|No| ErrorInvalid[Error: Invalid Parameters]
-    Valid -->|Yes| CheckPermission[Check Permission]
-
-    CheckPermission --> Policy[Policy Engine]
-    Policy --> Approved{Approved?}
-
-    Approved -->|No| ErrorDenied[Error: Permission Denied]
-    Approved -->|Yes| Execute[Execute Tool Function]
-
-    Execute --> Success{Success?}
-    Success -->|No| CatchError[Catch Error]
-    Success -->|Yes| FormatResult[Format Result]
-
-    CatchError --> ErrorExecution[Error: Execution Failed]
-    FormatResult --> Truncate[Truncate if Needed]
-    Truncate --> AddMetadata[Add Metadata]
-    AddMetadata --> Return[Return to LLM]
-
-    ErrorNotFound --> Return
-    ErrorInvalid --> Return
-    ErrorDenied --> Return
-    ErrorExecution --> Return
-
-    style LLM fill:#e1f5ff
-    style Execute fill:#e8f5e9
-    style Return fill:#f3e5f5
-    style ErrorNotFound fill:#ffe1e1
-    style ErrorInvalid fill:#ffe1e1
-    style ErrorDenied fill:#ffe1e1
-    style ErrorExecution fill:#ffe1e1
-```
-
-### MCP Tool Execution Flow
-
-```mermaid
-flowchart TD
-    LLM[LLM Requests MCP Tool] --> Registry[Tool Registry]
-    Registry --> Wrapper[MCPToolWrapper]
-    Wrapper --> ValidateParams[Validate Parameters]
-    ValidateParams --> CheckPermission[Check Permission]
-    CheckPermission --> MCPClient[MCP Client]
-
-    MCPClient --> Transport[MCP Transport]
-    Transport --> Stdio[Stdio: Write to stdin]
-    Transport --> SSE[SSE: POST to endpoint]
-    Transport --> HTTP[HTTP: POST request]
-
-    Stdio --> Server[MCP Server]
-    SSE --> Server
-    HTTP --> Server
-
-    Server --> Process[Process Request]
-    Process --> Response[Send Response]
-    Response --> Receive[MCP Transport Receives]
-    Receive --> ConvertResult[Convert Result]
-    ConvertResult --> Format[Format for LLM]
-    Format --> Return[Return to LLM]
-
-    style LLM fill:#e1f5ff
-    style Server fill:#e8f5e9
-    style Return fill:#f3e5f5
-```
-
----
-
-## Integration Points
-
-### 1. Provider Integration
-
-Tools are passed to the provider alongside the system prompt:
-
-```typescript
-const turnOptions: ChatOptions = {
-  systemPrompt: systemPromptWithContext,
-  tools: tools, // All registered tools
-  ...options,
-};
-
-const response = await provider.chat(messages, turnOptions);
-```
-
-**Current Issue:** Tools not being passed to provider (see Troubleshooting section).
-
-### 2. MCP Integration
-
-MCP tools are automatically registered in the Tool Registry:
-
-```mermaid
-sequenceDiagram
-    participant MCP as MCP Client
-    participant Converter as Schema Converter
-    participant Wrapper as Tool Wrapper
-    participant Registry as Tool Registry
-    participant LLM as LLM
-
-    MCP->>MCP: Connect to Server
-    MCP->>MCP: Discover Tools
-    MCP->>Converter: Convert Schema
-    Converter-->>MCP: Internal Schema
-    MCP->>Wrapper: Wrap Tool
-    Wrapper->>Registry: Register Tool
-    Registry-->>LLM: Tool Available
-```
-
-### 3. Hook Integration
-
-Hooks can trigger tool execution through `askAgent` action:
-
-```json
-{
-  "action": {
-    "type": "askAgent",
-    "prompt": "Run linting on {{file.path}} using the shell tool"
-  }
-}
-```
-
-The agent will then use the appropriate tool.
-
-### 4. Dynamic Tool Registration
-
-Services can register tools at runtime:
-
-```typescript
-// ChatContext registers memory dump tool
-toolRegistry.registerTool({
-  name: 'write_memory_dump',
-  description: 'Create context snapshot',
-  inputSchema: {
-    /* ... */
-  },
-  execute: async (args) => {
-    return await chatContext.createMemoryDump(args);
-  },
-});
-```
-
----
-
-## Design Decisions
-
-### 1. Unified Tool Registry
-
-**Decision:** Single registry for all tool types
-
-**Rationale:**
-
-- Consistent interface for LLM
-- Simplified tool management
-- Easier to add new tool sources
-- Unified permission checking
-
-**Trade-offs:**
-
-- ✅ Consistency
-- ✅ Simplicity
-- ❌ Less flexibility per tool type
-- ❌ Shared namespace
-
-### 2. Schema-Based Validation
-
-**Decision:** Use JSON Schema for parameter validation
-
-**Rationale:**
-
-- Standard format
-- Type safety
-- Clear documentation
-- Tool compatibility
-
-**Trade-offs:**
-
-- ✅ Type safety
-- ✅ Clear contracts
-- ❌ Verbose schemas
-- ❌ Limited validation logic
-
-### 3. Permission-Based Approval
-
-**Decision:** Three approval modes (YOLO, AUTO, ASK)
-
-**Rationale:**
-
-- Balance safety and speed
-- User control
-- Risk-based decisions
-- Flexible workflow
-
-**Modes:**
-
-- **YOLO** - Maximum speed, minimum safety
-- **AUTO** - Balanced (recommended)
-- **ASK** - Maximum safety, slower workflow
-
-### 4. Result Truncation
-
-**Decision:** Truncate large outputs automatically
-
-**Rationale:**
-
-- Prevent context overflow
-- Keep relevant information
-- LLM can request more if needed
-- Better performance
-
-**Strategy:**
-
-- File contents: First 5KB
-- Directory listings: First 500 items
-- Search results: First 50 matches
-- Shell output: Last 5KB (most recent)
-
-### 5. Dynamic Registration
-
-**Decision:** Allow runtime tool registration
-
-**Rationale:**
-
-- Flexibility
-- Service integration
-- Extension support
-- Hot-reload capability
-
-**Use Cases:**
-
-- Memory dump tool (ChatContext)
-- Hot swap tool (HotSwapService)
-- Extension tools
-- MCP tools
-
----
-
-## Security Model
-
-### 1. Permission Checking
-
-**Threat:** Unauthorized tool execution
-
-**Mitigation:**
-
-- Policy engine evaluation
-- User approval workflow
-- Risk-based decisions
-- Approval persistence
-
-**Implementation:**
-
-```typescript
-async function checkPermission(tool: string, args: any): Promise<boolean> {
-  const riskLevel = evaluateRisk(tool, args);
-
-  if (approvalMode === 'YOLO') {
-    return true;
-  }
-
-  if (approvalMode === 'AUTO' && riskLevel === 'low') {
-    return true;
-  }
-
-  return await requestUserApproval(tool, args);
-}
-```
-
-### 2. Parameter Validation
-
-**Threat:** Malicious or malformed parameters
-
-**Mitigation:**
-
-- Schema validation
-- Type checking
-- Value range validation
-- Required field verification
-
-**Implementation:**
-
-```typescript
-function validateParameters(tool: ToolDefinition, args: any): void {
-  const schema = tool.inputSchema;
-
-  // Check required fields
-  for (const field of schema.required) {
-    if (!(field in args)) {
-      throw new Error(`Missing required field: ${field}`);
-    }
-  }
-
-  // Check types
-  for (const [field, value] of Object.entries(args)) {
-    const fieldSchema = schema.properties[field];
-    if (!validateType(value, fieldSchema.type)) {
-      throw new Error(`Invalid type for field: ${field}`);
-    }
-  }
-}
-```
-
-### 3. Error Isolation
-
-**Threat:** Tool errors affecting system
-
-**Mitigation:**
-
-- Try-catch blocks
-- Error formatting
-- Graceful degradation
-- Error logging
-
-**Implementation:**
-
-```typescript
-async function executeTool(name: string, args: any): Promise<any> {
-  try {
-    const tool = getTool(name);
-    const result = await tool.execute(args);
-    return formatResult(result);
-  } catch (error) {
-    logger.error(`Tool execution failed: ${error.message}`);
-    return {
-      error: error.message,
-      tool: name,
-      args: args,
-    };
-  }
-}
-```
-
-### 4. Output Sanitization
-
-**Threat:** Malicious output affecting LLM
-
-**Mitigation:**
-
-- Output truncation
-- Special character escaping
-- Size limits
-- Format validation
-
----
-
-## Performance Considerations
-
-### 1. Tool Caching
-
-**Optimization:** Cache tool definitions
-
-**Implementation:**
-
-- Store tool definitions in memory
-- Lazy load tool implementations
-- Cache validation results
-- Reuse tool instances
-
-### 2. Parallel Execution
-
-**Optimization:** Execute independent tools in parallel
-
-**Note:** Currently not implemented, but planned for future.
-
-### 3. Result Streaming
-
-**Optimization:** Stream large results
-
-**Note:** Currently not implemented, but planned for shell tool enhancement.
-
----
-
-## Troubleshooting
-
-### Tools Not Available to LLM
-
-**Symptom:** LLM doesn't use tools, only provides advice
-
-**ROOT CAUSE:** Tools are not being passed to the provider in the chat request.
-
-**Location:** `packages/core/src/core/chatClient.ts` line ~370
-
-**Current Code (BROKEN):**
-
-```typescript
-const turnOptions: ChatOptions = {
-  ...options,
-  systemPrompt: systemPromptWithContext,
-  // ❌ Missing: tools from ToolRegistry
-};
-```
-
-**Fix:**
-
-```typescript
-// Get all registered tools
-const tools = this.toolRegistry.getAllTools().map((tool) => ({
-  name: tool.name,
-  description: tool.description,
-  parameters: tool.inputSchema,
-}));
-
-const turnOptions: ChatOptions = {
-  ...options,
-  systemPrompt: systemPromptWithContext,
-  tools: tools, // ✅ Add tools here
-};
-```
-
-**See:** `works_todo.md` Task #10 for complete fix details
-
----
-
-## File Locations
-
-| File                                        | Purpose                         |
-| ------------------------------------------- | ------------------------------- |
-| `packages/core/src/tools/tool-registry.ts`  | Tool registration and execution |
-| `packages/core/src/tools/types.ts`          | Tool type definitions           |
-| `packages/core/src/tools/validation.ts`     | Parameter validation            |
-| `packages/core/src/tools/output-helpers.ts` | Result formatting               |
-| `packages/core/src/policy/policyEngine.ts`  | Permission checking             |
-| `packages/core/src/policy/policyRules.ts`   | Risk evaluation rules           |
-| `packages/core/src/mcp/mcpToolWrapper.ts`   | MCP tool wrapper                |
-| `packages/core/src/mcp/mcpClient.ts`        | MCP client                      |
-
-**Built-in Tools:**
-
-- `packages/core/src/tools/glob.ts` - File pattern search
-- `packages/core/src/tools/ls.ts` - Directory listing
-- `packages/core/src/tools/grep.ts` - Content search
-- `packages/core/src/tools/read-file.ts` - Read single file
-- `packages/core/src/tools/read-many-files.ts` - Read multiple files
-- `packages/core/src/tools/edit-file.ts` - Edit file sections
-- `packages/core/src/tools/write-file.ts` - Create/overwrite files
-- `packages/core/src/tools/web-search.ts` - Web search
-- `packages/core/src/tools/web-fetch.ts` - Fetch URL content
-- `packages/core/src/tools/shell.ts` - Shell execution
-- `packages/core/src/tools/memory.ts` - Persistent memory
-- `packages/core/src/tools/remember.ts` - Simplified memory
-- `packages/core/src/tools/goal-management.ts` - Goal tools
-- `packages/core/src/tools/write-todos.ts` - Todo management
-- `packages/core/src/tools/read-reasoning.ts` - Reasoning retrieval
-
-**Dynamic Tools:**
-
-- `packages/core/src/tools/MemoryDumpTool.ts` - Memory dump tool
-- `packages/core/src/tools/HotSwapTool.ts` - Hot swap tool
-
----
-
-## Further Reading
-
-### Documentation
-
-- [Tool User Guide](UserGuide.md) - Using tools
-- [MCP Architecture](../MCP/MCP_Architecture.md) - MCP tool integration
-- [Hook Architecture](../Hooks/Architecture.md) - Hook system integration
-
-### Related Systems
-
-- [Goal Management](dev_PromptSystem.md) - Goal system architecture
-- [Context Compression](dev_ContextCompression.md) - Goal system integration
-- [Provider System](dev_ProviderSystem.md) - Provider integration
-
-### External References
-
-- JSON Schema (https://json-schema.org/)
-- Tool Use Patterns (https://docs.anthropic.com/claude/docs/tool-use)
-
----
-
-**Document Version:** 1.0  
-**Last Updated:** 2026-01-26  
-**Status:** ✅ Complete