feat: phase 4 batch 1 - tool result caching

[arpayidcloud-byte]

Phase 4 Batch 1: Tool Result Caching

Changes

1. Cache Integration

• Added @agentx/cache dependency to @agentx/tool-sdk
• Integrated CacheManager into ToolExecutionPipelineImpl
• Added configurable cache TTL (default 5 minutes)

2. Cache Strategy

• Cache read operations: fs.read, git.read, shell.read
• Do NOT cache write operations: fs.write, git.write, shell.exec
• Do NOT cache failed operations: Only successful results are cached

3. Cache Key Generation

• Based on: tool name, category, arguments hash, working directory
• Uses base64 encoding for compact keys
• Ensures unique keys for different contexts

4. Performance Benefits

• Reduces redundant read operations
• Improves response time for repeated reads
• Memory-efficient with LRU eviction (max 1000 entries)

Testing

• ✅ Local typecheck passed (54/54)
• ✅ Local build passed (42/42)
• ✅ Local test passed (85/85)
• ✅ New tests for caching functionality:
  • Read operations are cached
  • Write operations are NOT cached
  • Failed operations are NOT cached

Next

Phase 4 Batch 2: Tool execution sandboxing and timeout enforcement

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.