Consolidates agent functionality into unified hanzo-agent SDK:
Changes:
- Removed old pkg/hanzo-agents package (deprecated)
- Added hanzo-agent as git submodule at pkg/hanzo-agent
- Updated pyproject.toml to remove hanzo-agents test exclusion
- Configured .gitmodules for github.com/hanzoai/agent
Benefits:
- Single source of truth for agent functionality
- Modular extensions (web3, tee, marketplace, cli)
- Maintains both standalone and integrated use cases
- Users can install: pip install "hanzoai[full]"
Migration:
- Old: from hanzo_agents import Agent
- New: from agents import Agent (in hanzo-agent submodule)
Related: Agent SDK now at github.com/hanzoai/agent
Fixes critical issue where tool_use blocks could be orphaned without
corresponding tool_result blocks, causing Claude API 400 errors:
"tool_use ids were found without tool_result blocks immediately after"
Changes:
- Collect tool results atomically before adding to messages
- Add error recovery to append tool_result for any orphaned tool_use blocks
- Ensures 1:1 pairing of tool_use and tool_result even on exceptions
Location: hanzo_mcp/tools/agent/agent_tool_v1_deprecated.py:449-603
Fixed the read tool and all filesystem tools to properly work with agents
that call them with 2 positional arguments (ctx, file_path).
Changes:
- Updated auto_timeout decorator to handle instance methods properly
- Changed wrapper signature to accept *args to handle both methods and functions
- Properly extracts ctx from correct position (second arg for methods, first for functions)
- Made set_tool_context_info async and updated all callers
- Changed from sync to async def
- Added await for all calls to set_tool_context_info()
- Fixed in: read, write, edit, multi_edit, ast_tool, rules_tool, symbols_tool
- Tests now pass without warnings
- Both run() and call() methods work correctly
- Agents can now properly invoke read tool with expected signature
Version: 0.9.1 -> 0.9.2
- Add --daemon flag to run as single process serving multiple agents
- Add --socket-path for Unix socket communication
- Add --max-connections to limit concurrent agent connections
- Implement file locking to prevent multiple daemon instances
- Set environment variables for daemon mode configuration
This ensures hanzo-mcp runs as single process even with 100+ agents
- Implement MCPToolTimeoutManager with configurable timeouts
- Add @auto_timeout decorator for all MCP tools
- Apply auto-timeout to search, find, and ast tools
- Default 2-minute timeout, configurable via HANZO_MCP_TOOL_TIMEOUT
- Background operations continue with full log files
- Process management integration for monitoring and termination
- Solves MCP error -32001 (Request timed out) issues
Version bump: 0.8.15 → 0.8.16
- Added missing imports for register_thinking_tool, register_critic_tool, and register_batch_tool
- Fixed FastMCP import fallback to support multiple mcp module structures
- Updated Claude MCP configuration to use venv Python for proper dependency resolution
- Resolved NameError issues preventing server initialization
- Added comprehensive anti-stub test suite that detects:
- TODO/FIXME/STUB/FAKE/UNFINISHED patterns
- Empty functions with only pass/ellipsis
- NotImplementedError raises
- Mock implementations in production
- Debug prints in production
- Skipped tests
- Created strict GitHub Actions workflow that:
- BLOCKS deployment if ANY forbidden patterns found
- Requires ALL tests to pass (no skips allowed)
- Runs security scans
- Verifies all functions are implemented
- Only allows PyPI publish after ALL checks pass
- Added pre-commit hooks to catch issues locally before push
- Updated Makefile with 'make check' that runs all quality gates
- Fixed stub function issue in tools/__init__.py
This ensures we NEVER deploy incomplete or stub code to production again!
- Fix Hanzo Node detection to test actual chat endpoint instead of health check
- Check both ports 3690 (default) and 8000 for Hanzo Node
- Add session-based failed tool tracking to avoid repeated attempts
- Cache working tool selection for better performance
- Fix hanzo-mcp integration with proper dependencies
- Add comprehensive test suite for tool detection (14 tests)
- Test and verify OpenAI Codex integration
- Fix Hanzo Node health check to use port 3690 (not 8000)
- Update chat completions endpoint to use correct port
- Fix status display to show correct port number
- This allows proper detection and use of local Hanzo Node
- Fix Hanzo Node detection to verify chat endpoint actually works
- Skip Hanzo Node if /v1/chat/completions returns 404
- Add proper fallback chain when primary tool fails
- Show helpful error messages and suggest working alternatives
- agent will be used when Hanzo Node isn't functional
- Add /todo command with full todo management capabilities
- Quick add with tags, priority, and due dates: /todo Buy milk #shopping !high @tomorrow
- Comprehensive todo operations: add, list, done, start, cancel, delete, view, stats
- Persistent storage in ~/.hanzo/todos.json
- Rich display with tables and emoji status indicators
- Advanced filtering by status, priority, and tags
- Statistics dashboard with completion rates
- Shortcut /t for quick access
- Hanzo Node (hanzod) now highest priority when running on localhost:8000
- Provides completely private, local AI - data never leaves your machine
- Detects running Hanzo Router on localhost:4000 as LLM proxy
- Priority chain: Hanzo Node → Router → agent → other tools
- Shows model count when Hanzo Node is running
- Special messaging for privacy when using local AI
- Version 0.3.27 with enhanced local AI support
- Detect available AI tools: agent, OpenAI Codex, Gemini CLI, Grok, OpenHands, Hanzo Dev
- agent is default when available, with intelligent fallback chain
- Display detected tools as 'agent: Tool Name' in REPL
- Quick model selector with arrow key navigation (press ↓ for menu)
- Background task management with /tasks and /kill commands
- Tools integrated into /model command for seamless switching
- Version 0.3.26 with enhanced AI tool integration
- Simplified model display to just show 'model: provider/model-name'
- Removed authentication lock icons for cleaner interface
- Successfully published to PyPI at https://pypi.org/project/hanzo/0.3.25/
- Remove 'hanzo' prefix from prompt, just show clean '>'
- Display model info below input: 'model: provider/model-name'
- Show auth status with lock icons
- Version bump to 0.3.25 for PyPI release
- Display current model in REPL prompt (e.g., hanzo [gpt] 🔓 >)
- Add /model command for easy model switching
- Add /status command showing auth and system status
- Add /login and /logout commands for authentication
- Show authentication status with lock/unlock icons
- Support for switching between 20+ AI models
- Enhanced startup UI with version and changelog integration
- Fixed async auth commands to work with Click CLI
- Create comprehensive startup UI with ASCII art branding
- Add What's New section with GitHub changelog integration
- Implement update checking from PyPI
- Show system status (Router, Node, API) indicators
- Add quick start tips and command hints
- Create inline startup notifications for commands
- Support minimal UI mode with environment variables
- Cache changelog data for offline usage
- Smart display logic (show once per day for inline)
- Version bump to 0.3.23
The UI provides a clean, informative startup experience similar to agent,
with automatic update notifications and helpful tips for new users.
- Create detailed README for main repository with architecture overview
- Add package-specific READMEs with usage examples and API documentation
- Create CONTRIBUTING.md with development guidelines and workflow
- Update LLM.md with architectural decisions and patterns
- Document all CLI commands, configuration options, and best practices
- Include installation, testing, and deployment instructions
- Add code examples for all major features
- Document port allocation strategy and integration points
- Ensure 100% test pass rate (197 tests passing)
- Fix syntax errors (indentation) in hanzo-mcp tools
- Replace all bare except statements with except Exception
- Fix import sorting issues across all packages
- Update type annotations to use modern X | Y syntax for Python 3.10+
- Ensure all packages pass ruff linting checks
- Lower Python requirement from >=3.12 to >=3.10 to match CI test matrix
- Update mypy and ruff configurations to target Python 3.10
- Add Python 3.10, 3.11, 3.12 to classifiers
- Fixes CI failures across all Python versions in test matrix
- Renamed 'cluster' terminology to 'node' throughout codebase for clarity
- Added new 'hanzo router' command for managing LLM proxy server
- Added zsh shell tool with automatic shell detection (prefers zsh over bash)
- Fixed REPL to use cloud mode by default to avoid local server dependency
- Updated chat command to try router (port 4000) before local node (port 8000)
- Added comprehensive Grok documentation to README
- Created NODE_COMPATIBILITY.md documenting integration with desktop app and network
BREAKING CHANGE: 'hanzo cluster' commands now use 'hanzo node' - old commands still work via aliases
Key changes:
- hanzo node start/stop/status - manage local AI nodes
- hanzo router start/stop/status - manage LLM proxy router
- hanzo node worker - manage node workers (formerly cluster nodes)
- Zsh is now default shell when available
- Router runs on port 4000, nodes on port 8000
- Full compatibility with Hanzo desktop app and network layer
- Implement unified CLI tools module for all AI providers
- Add support for claude/cc, codex, gemini, grok, openhands/oh, hanzo-dev, cline, aider
- Enable parallel batch execution of CLI tools
- Add comprehensive test suite with 16 passing tests
- Fix typing issues with mypy strict mode
- Add GitHub Actions CI/CD workflow with optional integration tests
- Support authentication flow for all providers
- Follow DRY principle with single source of truth
Major improvements:
- Streaming responses with real-time feedback
- Smart rate limiting with exponential backoff
- Error recovery with circuit breaker pattern
- Comprehensive test suite (all tests passing)
- Fixed CI/CD pipeline issues
- TypeWriter effect for code display
- Adaptive rate limits per API provider
Performance:
- Prevents API overuse with smart throttling
- Automatic fallback on rate limit errors
- Burst protection and cooldown periods
- Per-API customized limits
Version bump to 0.3.21
- Automatic fallback handler tries all available AI options
- Memory persistence with #memory commands (like Claude Desktop)
- Smart context management with priority-based memories
- Session tracking and user preferences
- Export/import memory capabilities
- Enhanced AI responses with contextual awareness
- Version bump to 0.3.20
- Chat-first interface (natural language by default)
- Claude Desktop-style UI with light gray borders
- Support for multiple orchestrators (GPT-5, Codex, Claude, local models)
- CLI tool integration (OpenAI CLI, Claude Desktop, Gemini CLI, Hanzo IDE)
- System 2 thinking with critic agents
- Comprehensive test coverage with real AI validation
- Version bump to 0.3.19
- Fix 'not enough values to unpack' error by using predefined ROUNDED box
- Simplify input handling to avoid prompt_toolkit complexity
- Keep the visual bordered input box design
- Bump version to 0.3.18
The UI now works without crashing on startup!
- Implement bordered input boxes with light gray styling (╭─╮ borders)
- Add styled response panels for AI outputs
- Use prompt_toolkit for better input handling with custom styles
- Add modern › prompt symbol instead of basic >
- Improve header with panel styling
- Make all AI responses display in consistent bordered panels
- Better error handling for Ctrl+C and Ctrl+D
- Version bump to 0.3.17
The interface now looks much more polished with Claude-like aesthetics!
- Fix openai CLI command to use correct syntax: chat.completions.create
- Use -g flag instead of -p for message input
- Bump version to 0.3.16
The correct command is now:
openai api chat.completions.create -m gpt-4 -g 'message'
- Fix chat_with_agents to properly route to direct API chat for CLI tools
- Implement working _send_to_instance that uses real AI models
- Add proper methods for OpenAI CLI, Claude Desktop, Gemini CLI
- Add proper methods for local models via Ollama
- Fix multi-Claude orchestrator to use actual AI instead of placeholders
- Bump version to 0.3.15
Now hanzo dev --orchestrator codex actually works!
zeekay
