mirror of https://github.com/hanzoai/python-sdk.git synced 2026-10-23 20:23:00 +00:00

Files

T

zeekay 572dcd68f2 decomplect: HIP-0300 wire surface is the only public contract

The MCP wire (what tools/list reports) ships exactly one tool per axis:
fs, exec, code, git, fetch, plan — action-routed. The per-action classes
(ReadTool, WriteTool, EditTool, …) stay importable for in-process
read-only sandboxing (swarm sub-agents) but are NOT on the wire.

PyPI 0.3.1 of hanzo-tools-fs shipped the legacy split (7 tools) while
the local 0.3.1 source had already migrated to TOOLS=[FsTool]. Same
version number, two different contracts — the source of the
'Python MCP surfaces 32 tools, Node MCP surfaces 13' divergence
that breaks contract parity. Bumping to 0.3.2 publishes the
HIP-0300 surface for the first time.

- pkg/hanzo-tools-fs 0.3.1 → 0.3.2: TOOLS=[FsTool]; legacy classes
  importable; dropped 'Edit = EditTool' alias; cleaner __init__.
- pkg/hanzo-tools-shell 0.6.3 → 0.6.4: bump only (source already
  TOOLS=_get_detected_shell_tools()).
- pkg/hanzo-tools-code 0.1.0 → 0.1.1: bump only (TOOLS=[CodeTool]).
- pkg/hanzo-tools-vcs  0.1.0 → 0.1.1: bump only (TOOLS=[GitTool]).
- pkg/hanzo-tools-net  0.1.0 → 0.1.1: bump only (TOOLS=[FetchTool]).
- pkg/hanzo-tools-plan 0.1.0 → 0.1.1: bump only (TOOLS=[PlanTool]).
- pkg/hanzo-tools-agent 0.3.1 → 0.3.2: 'Edit' alias is gone — call
  EditTool by its real name in swarm_tool.py.
- pkg/hanzo-mcp 0.15.3 → 0.15.4: gets the HIP-0300-clean wire when
  consumed via 'uvx --refresh-package hanzo-tools-fs hanzo-mcp serve'.

2026-05-13 13:51:48 -07:00

hanzo_tools

decomplect: HIP-0300 wire surface is the only public contract

2026-05-13 13:51:48 -07:00

tests

style: format test files with black

2025-12-27 15:00:11 -08:00

pyproject.toml

decomplect: HIP-0300 wire surface is the only public contract

2026-05-13 13:51:48 -07:00

README.md

feat(mcp): unify tool surfaces, rename iching→zen, fix test infrastructure

2026-03-06 03:13:54 -08:00

uv.lock

fix(lint): fix import sorting and lru_cache noqa

2025-12-27 20:32:45 -08:00

README.md

hanzo-tools-agent

Agent orchestration tools for Hanzo MCP.

Installation

pip install hanzo-tools-agent

# Optional: API mode
pip install hanzo-tools-agent[api]

# Optional: High-performance
pip install hanzo-tools-agent[perf]

Tools

agent - Unified Agent Runner

Run various AI CLI agents with auto-backgrounding.

# Run with default agent
agent(action="run", prompt="Explain this code")

# Run specific agent
agent(action="run", name="gemini", prompt="Review this PR")

# List available agents
agent(action="list")

# Check agent status
agent(action="status", name="claude")

Available Agents:

claude - Anthropic Claude Code CLI
codex - OpenAI Codex CLI
gemini - Google Gemini CLI
grok - xAI Grok CLI
qwen - Alibaba Qwen CLI
vibe - Vibe coding agent
code - Hanzo Code agent
dev - Hanzo Dev agent

Direct API Mode

Configure agents for direct API calls without CLI:

// ~/.hanzo/agents/custom.json
{
    "endpoint": "https://api.openai.com/v1/chat/completions",
    "api_type": "openai",
    "model": "gpt-4",
    "env_key": "OPENAI_API_KEY"
}

zen - Hanzo Zen Guidance

zen(challenge="How should I approach this refactoring?")

review - Code Review

review(
    focus="FUNCTIONALITY",
    work_description="Implemented auto-import feature",
    file_paths=["/path/to/file.py"]
)

License

MIT