mirror of https://github.com/hanzoai/python-sdk.git synced 2026-10-26 11:49:36 +00:00

Files

T

zeekay efa90f9978 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

docs: add READMEs for all 18 hanzo-tools-* packages

2025-12-27 14:55:13 -08:00

uv.lock

chore: update sub-package dependencies for security fixes

2026-02-02 22:40:00 -08:00

README.md

hanzo-tools-fs

Filesystem tools for Hanzo MCP.

Installation

pip install hanzo-tools-fs

Tools

read - Read Files

read(file_path="/path/to/file.py")
read(file_path="/path/to/file.py", offset=100, limit=50)

write - Write Files

write(file_path="/path/to/file.py", content="...")

edit - Edit Files

edit(
    file_path="/path/to/file.py",
    old_string="def old():",
    new_string="def new():"
)

tree - Directory Structure

tree(path="/project", depth=3)

find - File Discovery

find(pattern="*.py", path="/project")

search - Content Search

search(pattern="TODO|FIXME", path="./src")

ast - Code Structure

ast(pattern="class.*Service", path="/src")

License

MIT