release: 2.1.0

[stainless-app]

Automated Release PR

2.1.0 (2026-07-03)

Full Changelog: v2.0.2...v2.1.0

Features

• add 'hanzo infra' CLI for cloud infrastructure provisioning (fe2abac)
• add cloud CLI commands (83599fa)
• add CloudClient and rewrite wire protocol for Rust compatibility (99aa65a)
• add hanzo-agents package with CLI (6e06785)
• add hanzo-async unified async I/O with uvloop support (5348dc4)
• add hanzo-cli unified CLI with IAM, KMS, PaaS management (eb2f0a1)
• add hanzo-flow package (re-exports hanzoflow CLI as hanzo-flow) (d07898d)
• add hanzo-kms package, MCP proxy tools, and agent reflexion (98aa8a0)
• add hanzo-node cross-platform binary installer (91e4b60)
• add hanzo-tools-api package and hanzo.infra SDK (f73a84e)
• add HIP-0300 cross-language MCP conformance test suite (2e556a7)
• add new tool packages and install command (0230656)
• add RAG search via Hanzo Cloud (search-docs + chat-docs) (d2d1efc)
• add REPL, IDE tools and ZAP protocol (a6741fc)
• add UI registry server and tiered backend (local → registry → github) (f63053f)
• agent: add direct API mode and auto-backgrounding (34539d7)
• agent: agentic proxy with Claude Code integration (2367201)
• agent: multi-agent orchestration with DAG, swarm, Lux Quasar consensus (75702ab)
• agent: one tool with actions, not many tools (4e9182f)
• auth/IAM refactor + add hanzo-iam and hanzo-web3 packages (eeb2c09)
• auto-install uvloop on Linux/macOS with platform gate (3ea63d9)
• bring hanzo-agent into monorepo tree (c9b06e9)
• browser: add CDP bridge server for extension integration (baa6954)
• browser: add navigation/fetch/history to extension actions (4195b13)
• browser: add wait_for_selector, query_selector_all to extension actions (2e8d105)
• browser: configurable backend + fix CDP bridge for websockets >= 13 (80c8b6e)
• bump versions and add hanzo-cli/kms/iam to publish workflow (6912742)
• cli: add bot commands, s3 storage, dev/net passthrough (6a4fc31)
• cli: add k8s kubectl wrapper and remove REPL (57853cf)
• cli: add top-level deploy alias and fix KMS create_secret (af06f92)
• cli: replace all 18 stub commands with real API implementations (fe20394)
• computer: add intelligent video slicing with activity detection (9fc460e)
• computer: add MediaTool with configurable limits (100 images, 32MB) (2ea8185)
• computer: add ScreenTool for unified screen recording and Claude interpretation (bc55675)
• configurable HANZO_AUTO_BACKGROUND_TIMEOUT env var (default: 30s) (aa2e887)
• consensus: add MCP mesh for agent-to-agent consensus (5d93c8e)
• consolidate tools - 52 to 30 tools (38f34c1)
• dns: add multi-provider DNS CLI (3409410)
• docs: add Cmd+K search with dark modal styling (e408726)
• enable ui tool in hanzo-mcp with local-first component reading (595036d)
• extract hanzo-metastable-consensus package (8f8ec4e)
• HANZO_AUTO_BACKGROUND_TIMEOUT=0 disables auto-backgrounding (5bd4ab2)
• hanzo-cli: add bot node agent commands with browser OAuth login (f57fd2f)
• hanzo-cli: add native hanzo.toml support for PaaS deployments (a77e89a)
• hanzo-dev Python TUI + LSP + hooks + sandbox + vim + git + multi-auth + full parity (041dcce)
• hanzo-iam: canonical IAM_ env contract + FastAPI integration (1.30.0) (6cac1b6)
• hanzo-mcp: 100% MCP/ZAP protocol parity with method pass-through v0.14.0 (9f9504f)
• hanzo-mcp: unified tool command and essential tools system (f9a43e5)
• hanzo-mcp: v0.10.18 - add hanzo-tools-* and hanzo-persona as required dependencies (1eadea4)
• hanzo-tasks: Python SDK for durable task execution (75108b7)
• hanzo-zap: add ZAP SDK package to monorepo (0.6.1) (5e49b8f)
• iam: add set-password and enforce-hashing CLI commands (1728d3a)
• iam: add set-password and enforce-hashing CLI commands (#27) (f476b27)
• llm: use hanzo-metastable-consensus for consensus tool (70ffe7b)
• mcp: add auth, kms, and platform MCP tools (34554a5)
• mcp: consolidate memory surface and restore local tool compatibility (8297746)
• mcp: register code, git, fetch tools for HIP-0300 parity with TS MCP (27ec75f)
• mcp: unify tool surfaces, rename iching→zen, fix test infrastructure (810ff41)
• memory: add namespace/key support + BlueRedChannel coordination class (6913819)
• memory: add no-backend markdown fallback for all memory MCP tools (38c0060)
• memory: consolidate 9 memory tools → single unified memory tool (ae79e88)
• refactor cloud CLI to gcloud idioms (879e8c3)
• rename 'hanzo infra' CLI to 'hanzo cloud' (c05f03c)
• rename PostHog analytics -> Insights in hanzo-mcp (fbea730)
• sdk: add datastore, docdb, ingress, mpc, paas resource modules (c3faf8b)
• shell: add bash tool and shell parameter for runtime switching (9413226)
• shell: add curl, jq, wget tools for shell escaping-free operations (73adf3e)
• shell: add shell detection to only expose user's active shell (f087e0e)
• shell: add Shellflow DSL for inline DAG syntax (9d9f818)
• shell: nested arrays auto-parallel in DAG execution (4703ec9)
• shell: remove cmd, add ksh/tcsh/csh support, shell-first exposure (f14618f)
• shell: shellflow DSL parser with high-performance optimization (c28f8c9)
• tools-browser: add tab_id / client_id / target_browser params (8e648ff)
• tools-browser: set_default_browser / use_browser actions for v1.9.0 bridge (77d03f4)
• tools-browser: ZAP-native 2-process architecture (0.5.0) (4ab1296)
• tools: add Rust<>Python parity for plan, patch, wait tools (4a1245e)
• tools: bidirectional HIP-0300 action sync across Python/TS/Rust (d410ddc)
• tools: fix BaseTool dispatch + achieve 100% HIP-0300 conformance (64881d7)
• wire CLI to PaaS API with IAM session exchange (263b4e2)
• zap-server: auto-publish via hanzo-zap-mdns + retract on stop (6a3595e)
• zap: add ZAP WebSocket server for browser extension discovery (8d5fad3)

Bug Fixes

• api: add User-Agent header to APIs.guru fetch to fix CI 403 (f4d7af8)
• async audit improvements and test fixes (24ae6dc)
• bare except clauses and SQL injection vulnerability (206ea68)
• bare except in autonomous_bug_solver example (71bcae0)
• bot: use OPENCLAW_GATEWAY_TOKEN and write bot.json config (30ec6b6)
• browser: add missing action-to-method mappings in CDP bridge (3b24a68)
• browser: auto-start CDP bridge on BrowserTool init (2e5b1cd)
• browser: fix extension result passthrough, add DOM actions (f4d402f)
• browser: unwrap CDP Runtime.evaluate results for consistency (b330d9a)
• ci: add hanzo-tools-ui to pyright exclude list (6ef7293)
• ci: align test expectations with tool renames, fix ruff lint/format (5196cb6)
• ci: allow publish even when lint fails (pre-existing errors) (c8127f5)
• ci: apply black formatting and bump hanzo-mcp to 0.12.3 (b2b4b6c)
• ci: apply black formatting to base.py and enhanced_repl.py (9904e69)
• ci: build packages from repo root to avoid stdlib shadowing (1651406)
• ci: change pyright from strict to basic mode (143f24d)
• ci: clean lint/format and bump hanzo-mcp to 0.12.2 (487ef2b)
• ci: drop --no-deps from local tool installs to resolve psutil (ffb3f5b)
• ci: exclude all subpackages from pyright scope (8308d45)
• ci: fix Windows test workflow - hanzoai installs from root, not pkg/ (b4f1259)
• ci: handle hanzoai root package in publish workflow (945b384)
• ci: ignore hanzo-tools-core deprecation warning in pytest (36a8b91)
• ci: install hanzo-tools shim before hanzo-tools-core in test workflow (1676a3b)
• ci: install libatomic1 for pyright on ARC runner (d104a15)
• ci: install local hanzo-tools-agent in release-check venv (2721752)
• ci: install local tool packages in CI to match monorepo renames (4bb3ddd)
• ci: pin black <26.1 to avoid internal error, lower requires-python to 3.12 (6880821)
• ci: relax config tool count, install hanzo-tools shim in test matrix (d018cff)
• ci: remove PYTEST_DISABLE_PLUGIN_AUTOLOAD, override addopts in CI (1712518)
• ci: resolve root lint failures across workspace packages (f965b69)
• ci: sort imports in 4 test files (ruff I001) (835472a)
• ci: update workflow to use hanzo_tools.agent imports (10bcd16)
• ci: update workflow tool counts (1416f10)
• cli: refactor PaaS auth flow and fix container deploy payload (bf7b1f3)
• cli: sort imports to satisfy ruff I001 lint rule (3b338de)
• computer: correct docstring to show 2000px Claude limit (066ec4e)
• computer: use Claude's actual 2000px limit for multi-image (5805c58)
• core: filter deprecation warning in tests (084718a)
• core: import MCPResourceDocument from types.py, not base.py (22b21c9)
• core: remove ToolCategory from exports (it's in hanzo-mcp, not hanzo-tools-core) (84541d8)
• core: update memory tool count (1 unified tool, not 9) (4c27562)
• core: update test module names and tool counts (2b18b3b)
• CTO review — version targets, slash command parity, dataclass default (37d3d8d)
• curl: accept json parameter in MCP tool registration (dfc19d9)
• depend on hanzo-flow (hyphenated PyPI name) (af770df)
• docs: add .gitkeep to overrides directory for GitHub Actions (a692e83)
• docs: checkout submodules for docs build (ae62ebd)
• docs: correct auto-background timeout from 45s to 30s (83958e6)
• docs: improve header tab contrast and visibility (c2343f2)
• docs: install package for API reference generation (73c5db0)
• docs: pin mkdocstrings version for compatibility (ae342dd)
• docs: remove blue links, fix search box dark styling (67954dd)
• docs: rename llm.md to llm-tools.md to avoid gitignore (26c8b98)
• eliminate remaining TODOs and stubs in source code (19c55a9)
• finalize latest MCP/CLI/SDK updates (862e093)
• flow CLI binary is 'flow' not 'hanzo-flow' (682644a)
• hanzo-mcp: add missing mypy type annotations to pass CI (bb97ddf)
• hanzo-mcp: add serve subcommand support for Claude Code (a2893f6)
• hanzo-mcp: update fallback version to 0.14.0, add watchdog to dev deps (5d62abf)
• hanzo-memory: fix tests and clean up deprecated code (d748b5b)
• hanzo-tools-browser: 0.5.2 — import wire format from zap-protocol (129360b)
• imports: update filesystem to fs in agent tools (eda66d0)
• lint — ruff format and fix for hanzo-tools-ui and hanzo-mcp (7fad40b)
• lint and format issues (3b8da2f)
• lint: add strict=False to zip() in using_grok example (0996212)
• lint: fix import sorting and lru_cache noqa (0b91b3d)
• lint: format hanzo-mcp tests with ruff (462d542)
• lint: resolve all ruff + black errors across all packages (47b743f)
• lint: resolve all ruff E722, S310, S202, S103, B905 errors (178cf71)
• lint: run black formatter on all 69 unformatted files (0ed51d1)
• mcp: correct import in litellm warning test (f2e9856)
• mcp: inject hanzo-mcp version into MCP server metadata (94fadc3)
• mcp: lower shell dep to 0.2.0 to unblock CI (PyPI has 0.2.0) (7e04fc3)
• mcp: simplify agent tests to match actual API (8e107b4)
• mcp: update tests to use AgentTool instead of UnifiedAgentTool (f98ed61)
• move hanzo-cli/kms to optional deps to unblock publish (927c67b)
• registry client uses static JSON paths for CF Pages compatibility (84177d6)
• remove conflicting hanzo-mcp script from hanzo package (62d81f2)
• replace stubs with real implementations (48e9ee3)
• resolve all I001 import sorting errors across monorepo (1554cd6)
• resolve all ruff lint errors (F401, F841, E741, I001) (4a7637d)
• resolve mypy errors and update shell tool count in tests (e57963a)
• restore 'version = ' prefix in 7 axis pyproject.toml files (5b84f5c)
• ruff format MCP files + update required tool count to 21 (6aa68d1)
• ruff lint auto-fixes across hanzo-mcp and tests (d9d3b86)
• ruff lint errors across hanzo-tools-* packages (I001, F401, F541) (d4d07a8)
• screen: write captures to file instead of returning inline base64 (c23bb92)
• sdk: update paas resource module (1f9460f)
• test-hanzo-tools: align tool expectations and modernize websockets import (fb67143)
• update agent tests for unified tools (a4aa420)
• update hanzo-flow entry point to flow.launcher (internal rename) (2d123ca)
• Windows + WSL compatibility across python-sdk (5379b70)
• Windows/WSL compatibility for shell tools and CLI helpers (682ad02)
• zap-server: race-free client cleanup when client_id is reused (9affd39)
• zap: dual-protocol decode, fix tool extraction, persist auth token (e78af14)
• zap: replace websockets with native ZAP TCP transport (e533310)

Performance Improvements

• 30s auto-backgrounding + fix hanging processes (cd78924)

Chores

• add publish-external-dists workflow + zap-mdns/zap-protocol dists (afcd988)
• add README.md for hanzo-tools-code and hanzo-tools-test (650fb99)
• bump hanzo-mcp to 0.10.21 (bf9339c)
• bump hanzo-mcp to 0.10.22, hanzo-tools-agent to 0.2.1 (27fd57b)
• bump hanzo-mcp to 0.10.32 (0de76e5)
• bump hanzo-mcp to 0.10.33, update shell dep to 0.5.4 (4e8a4c7)
• bump hanzo-tools-shell 0.6.3, hanzo 0.4.2 (Windows compat) (5a2da08)
• bump hanzo-tools-shell to 0.3.0 (3b42441)
• bump minimum Python to 3.12 (0e9ec97)
• bump versions for consolidated computer/screen tools (7fb47e6)
• bump versions for PyPI release (92c0e6d)
• cleanup — remove docker-compose.yml (use compose.yml), delete dead files (99bee7e)
• gitignore build/ artifacts, remove tracked build files (f5c11a3)
• hanzo-mcp: bump version to 0.15.0 (5da7d0f)
• hanzo-mcp: update uv lockfile after dependency changes (1f2be7d)
• hanzo-tools-iam: add uv.lock (e236dba)
• integrate hanzo-agent into workspace (42fa09d)
• mcp: bump to 0.10.27, require hanzo-tools-shell>=0.4.1 (bdf274b)
• release: bump hanzo-mcp to 0.12.1 (5f30375)
• remove AI-generated summary/report files (2facc47)
• remove dead release-please machinery (ba7e634)
• remove dist-external/ after one-shot zap publish (8f343f6)
• remove standalone GitHub workflows from hanzo-agent (02450be)
• rename Quality Gate workflow (de1223e)
• sync repo (31ccc45)
• sync uncommitted changes (29cf88a)
• untrack node_modules, improve .gitignore (8daeb54)
• update all dependencies and fix uvloop/nest_asyncio conflict (551c584)
• update dependencies to latest (8e240fb)
• update dependencies to latest (4a0c618)
• update hanzo-kms package (4215bc2)
• update hanzoai SDK and tests (22f4ab0)
• update SDK client, memory docs, and tests (bd6d88a)
• update sub-package dependencies for security fixes (911eb87)
• update uv.lock (a0c1682)

Documentation

• add LLM.md project guide (e68b843)
• add navigation section to main index (9bbab33)
• add Next.js documentation site with @hanzo/mdx (7bd5e0b)
• add READMEs for all 18 hanzo-tools-* packages (114864d)
• consensus: document MCP mesh usage (35b7806)
• create unified documentation site for python-sdk (7475b29)
• hanzo-tools: add README with architecture, API, and usage examples (cac1c9c)
• improve DX with navigation and cross-references (3317417)
• lib: add core library documentation (5d24e71)
• mcp: add comprehensive parity analysis for Python/TS/Rust MCPs (11ebec2)
• replace all placeholder content with real documentation (5cb47d5)
• shell: update bash/shell tool descriptions with Shellflow syntax (9ec863b)
• tools: add comprehensive documentation for all tool packages (05aabb2)
• tools: add database, editor, jupyter, mcp, vector tool docs (0b1036a)
• tools: add todo, computer, config tool documentation (f81e038)

Styles

• auto-fix ruff lint and format for Python 3.12 (d9123e7)
• black --target-version py312 (CI format-check fix) (4b664bb)
• black --target-version py312 (unblock publish CI) (240f66a)
• docs: add Geist font, Hanzo logo, and shadcn/ui dark theme (452797f)
• fix import sorting in test file (0123c91)
• format hanzo_mcp/init.py (4c2990d)
• format iam.py with black line-length rules (1a1edb0)
• format test files with black (fd74508)
• hanzo: format with black (b16bf40)

Refactors

• agent: rename Lux Quasar to Metastable consensus (bc786f1)
• eliminate all TODOs, placeholders, stubs, and fake data (11aa128)
• hanzo-mcp: clean up ZAP server bridge (8d1527d)
• mcp: rename hanzo-tools-platform to hanzo-tools-paas (f4db786)
• merge hanzo-tools-core into hanzo-tools (211a8a0)
• remove AI slop - mock data, stubs, dead code (aa50cb4)
• remove AI slop - mock data, stubs, dead code (902e49d)
• remove all backwards compat aliases from cloud CLI (7220db4)
• remove ambiguous shell tool, keep specific shells (76d4623)
• rename hanzo-metastable-consensus to hanzo-consensus (d764d3c)
• rename hanzo-tools-filesystem to hanzo-tools-fs (236ee58)
• shell: merge dag into zsh for unified shell tool (981f1c1)
• simplify hanzo infra extras (hanzo[vector] instead of hanzo[infra-vector]) (be050ee)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions