mirror of
https://github.com/hanzoai/python-sdk.git
synced 2026-10-23 20:23:00 +00:00
zooqueenandHanzo Dev
e7000de487
Search finds pages, web_read reads one, research is the whole loop behind a
single door: the live cloud answer engine (api.hanzo.ai /v1/ask, mode=research)
plans queries, searches, reads the best pages and writes an answer that cites
them. It is an action on the same fetch tool, not a new package — search, read
and research are one concern (the web) and share one client and one auth.
The engine replies as server-sent events, which is the cloud's other reply
shape, so HanzoCloud gains stream() beside get/post: the base URL, the auth
header and the error mapping stay in the one place that already owns them.
Each `data:` frame is yielded as a typed event (status | sources | text |
follow_ups | done | error); the terminal [DONE] sentinel ends the stream and is
never an event. Frames accumulate into {answer, sources, follow_ups}; `deep`
normalizes to `research` (one pass, two names) and any other mode is refused
rather than silently downgraded.
hanzo-tools 0.3.4->0.3.5, -net 0.1.3->0.1.4, and -net's floor moves to
hanzo-tools>=0.3.5 so the action cannot install against a client with no
stream(). Tests replay a canned SSE stream through the real parser.
Co-authored-by: Hanzo Dev <[email protected]>
hanzo-tools-net
Network tools for Hanzo AI MCP (HIP-0300).
Tools
fetch— the web, one door per verb:search— query → [url, title, snippet]web_read— url → clean markdownresearch— question → cited answer + sources (search + read + synthesize)fetch/download/crawl/head/request/open
vision— image (+ prompt) → text answer
Installation
pip install hanzo-tools-net
Usage
from hanzo_tools.net import TOOLS, register_tools
# Register with MCP server
register_tools(mcp_server)
Part of hanzo-tools
This package is part of the modular hanzo-tools ecosystem.