tasq/node_modules/agentic-flow/docs/archive/CHANGELOG-v1.3.0.md

Changelog - v1.3.0

Release Date: October 7, 2025

🎉 Major Features

Tool Emulation Architecture (Phase 2)

Complete implementation of tool emulation system for models without native function calling support.

Key Features:

• ✅ Automatic model capability detection
• ✅ ReAct and Prompt-based emulation strategies
• ✅ User-facing emulation messages at 3 levels
• ✅ Zero breaking changes - 100% backward compatible
• ✅ 15/15 regression tests passing

Supported Models:

• Native tool support: DeepSeek Chat, Claude 3.5, GPT-4, Llama 3.3, Qwen 2.5 Coder, Mistral Small
• Emulation required: Mistral 7B, Llama 2, Gemma 7B

Default Model Update

Changed default OpenRouter model from Llama 3.1 8B to DeepSeek Chat:

• ✅ Native tool support (no emulation needed)
• ✅ 128K context window (vs 32K)
• ✅ Cost-effective at $0.14/M tokens
• ✅ Eliminates context overflow errors in Claude Code interactive mode

🐛 Bug Fixes

Critical: Claude SDK Model Override

Fixed issue where Claude Agent SDK was sending Claude model IDs to OpenRouter, causing "model not found" errors.

Solution:

• Automatically override SDK Claude requests to use CLI-specified model
• Prevents errors when using OpenRouter with non-Claude models
• Maintains compatibility with all providers

📝 Changes

Tool Emulation Messages

Added user-facing messages at 3 levels:

1. Proxy Initialization: Shows when model lacks native tool support
2. Proxy Startup: Displays emulation strategy and expected reliability
3. Agent Execution: Informs about tool handling method

Example output for Mistral 7B:

⚙️  Detected: Model lacks native tool support
🔧 Using REACT emulation pattern
📊 Expected reliability: 70-85%

⚙️  Tool Emulation: REACT pattern
📊 Note: This model uses prompt-based tool emulation
   Tools are handled by Claude Agent SDK (limited to SDK tools)

Files Modified

• src/cli-proxy.ts - Added emulation messages, updated default model
• src/proxy/anthropic-to-openrouter.ts - Added model override logic, emulation routing
• src/cli/claude-code-wrapper.ts - Updated default model
• src/agents/claudeAgent.ts - Updated default model
• src/utils/modelCapabilities.ts - Created (Phase 1)
• src/proxy/tool-emulation.ts - Created (Phase 1)

🧪 Testing

Regression Tests: 15/15 PASS

• Tool emulation files exist
• Integration verified in cli-proxy and anthropic-to-openrouter
• Gemini proxy remains isolated
• TypeScript compilation succeeds
• Model capability detection working
• No tool name rewriting
• Tool schemas unchanged
• Backward compatibility verified

Manual Testing Results

• ✅ DeepSeek (native tools): Works perfectly, no emulation messages
• ✅ Mistral 7B (emulation): Works correctly, emulation messages appear
• ✅ Claude Code interactive mode: No context errors
• ✅ Claude Code non-interactive mode: Executes correctly
• ✅ Agent execution: Both model types work

📦 Migration Guide

For Users

No migration needed! This release is 100% backward compatible.

To use new default model (DeepSeek Chat):

npx agentic-flow claude-code --provider openrouter

To use emulation with non-tool models:

npx agentic-flow --agent coder --task "Your task" \
  --provider openrouter \
  --model "mistralai/mistral-7b-instruct"

For Developers

If you've set COMPLETION_MODEL in .env, it will override the new default.

To explicitly use DeepSeek Chat:

export COMPLETION_MODEL="deepseek/deepseek-chat"

🔗 Related Issues

• Closes #8 - Tool Emulation Phase 2 Integration

🙏 Credits

• Tool emulation architecture design
• Phase 2 integration implementation
• Model capability detection system
• Comprehensive testing and validation

---

Full Changelog: https://github.com/ruvnet/agentic-flow/compare/v1.2.7...v1.3.0