hanzoai/python-sdk
2
0
Fork 0
mirror of https://github.com/hanzoai/python-sdk.git synced 2026-10-23 20:23:00 +00:00
Code Issues Packages Projects Releases Wiki Activity
359 Commits 9 Branches 339 Tags
93cf2f94180ba11ff8a508cf8da02db71bdb93c9
Commit Graph
359 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
zeekay 93cf2f9418 Async read/write 2026-01-06 12:02:00 -08:00
zeekay 7f7dd025ac chore: integrate hanzo-agent into workspace 
- Rename package from hanzoai to hanzo-agent (avoid conflict with root)
- Add to workspace members
- Add numpy as required dependency (used by memory module)
 2026-01-05 22:12:32 -08:00
zeekay 93b287bdde chore: remove standalone GitHub workflows from hanzo-agent 2026-01-05 22:04:17 -08:00
zeekay adc3ca0872 feat: bring hanzo-agent into monorepo tree 
Converts hanzo-agent from git submodule to regular directory.
This enables simpler cross-package refactoring and unified CI/CD.

Source: github.com/hanzoai/agent.git (a8d7ec9)
 2026-01-05 21:56:22 -08:00
zeekay 209ffa854c feat(browser): add CDP bridge server for extension integration 
- Add cdp_bridge_server.py with WebSocket bridge
- CDPBridgeServer routes commands to browser extension
- CDPBridgeClient for programmatic browser control
- Export bridge classes from browser package
- Update vscode.md with extension integration docs
 2026-01-05 18:46:13 -08:00
zeekay 2f38fb90ae docs: replace all placeholder content with real documentation 
MCP docs:
- quickstart.md - Installation, basic usage, transport modes
- configuration.md - CLI options, env vars, config files
- vscode.md - VS Code, Cursor, Windsurf integration

Agent SDK docs:
- agents.md - Creating and configuring agents
- running_agents.md - Runner, RunConfig, async/sync
- tools.md - Function tools, context, custom tools
- guardrails.md - Input/output validation
- handoffs.md - Agent delegation patterns
- streaming.md - Stream events and responses
- tracing.md - Observability and debugging
- context.md - Mutable run context
- config.md - RunConfig and ModelSettings
- results.md - RunResult, items, usage
- models.md - Providers and model selection
- multi_agent.md - Complex multi-agent patterns
 2026-01-05 18:37:11 -08:00
zeekay 561bc65c4f docs: add navigation section to main index 2026-01-05 17:45:23 -08:00
zeekay 2b9d967381 docs: improve DX with navigation and cross-references 
- Update docs/mcp/tools/ placeholders with quick refs and links
- Create docs/ref/tools/index.md with full package table
- Create docs/ref/agent/index.md with topic links
- Create docs/ref/mcp/index.md with tool categories
- Create docs/tools/index.md as main entry point
- Add consistent cross-references between sections
 2026-01-05 17:45:00 -08:00
zeekay 615cc113c4 test: fix tool count expectations in test_all_tools.py 
- Update shell tools: 11→12 (cmd replaces dag, added fish/dash)
- Update memory tools: 1→9 (individual tools not unified)
- Make database/editor tests optional with skipif
- Update total expected count: 40→38
 2026-01-05 17:42:14 -08:00
zeekay bac7db5724 docs(lib): add core library documentation 
- lib/index.md: Overview of all core utility packages
- lib/async.md: High-performance async I/O with uvloop
- lib/consensus.md: Metastable consensus protocol for multi-agent agreement
- lib/network.md: Agent network orchestration
- lib/aci.md: Agent-Computer Interface for development agents
- lib/repl.md: Interactive REPL with voice and LLM integration
 2026-01-05 17:39:35 -08:00
zeekay 795a76fb74 docs(tools): add database, editor, jupyter, mcp, vector tool docs 
- database.md: SQL query/search/stats and graph database tools
- editor.md: Neovim integration (edit, command, session)
- jupyter.md: Notebook read/edit/create/execute operations
- mcp-tools.md: MCP server management and configuration
- vector.md: Semantic search with vector embeddings
 2026-01-05 17:36:05 -08:00
zeekay dae5e9def6 docs(tools): add todo, computer, config tool documentation 
- todo.md: Task management with list, add, update, remove, clear actions
- computer.md: pyautogui Mac automation (mouse, keyboard, screenshots, windows)
- config.md: Git-style configuration and 700+ programmer personas
 2026-01-05 17:33:39 -08:00
zeekay 71e1868f5f fix(docs): correct auto-background timeout from 45s to 30s 
The auto-backgrounding timeout was changed to 30 seconds but
documentation still referenced 45 seconds. Updated all occurrences.
 2026-01-05 17:30:53 -08:00
zeekay d381e6ea02 docs(tools): add comprehensive documentation for all tool packages 
Add detailed documentation with examples for:
- hanzo-tools-fs: read, write, edit, tree, find, search, ast
- hanzo-tools-shell: cmd, ps, zsh, bash, auto-backgrounding
- hanzo-tools-browser: 70+ Playwright actions, device emulation
- hanzo-tools-memory: memories, facts, knowledge bases, scopes
- hanzo-tools-reasoning: think and critic tools
- hanzo-tools-lsp: go-to-definition, references, rename, hover
- hanzo-tools-refactor: rename, extract, inline, batch operations
- hanzo-tools-agent: multi-agent orchestration, consensus, swarm
- hanzo-tools-llm: unified LLM interface with 100+ models

Each doc includes:
- Installation instructions
- Quick start examples
- Full API reference
- Usage examples
- Best practices
 2026-01-05 17:27:46 -08:00
zeekay 68f15a2066 feat(docs): add Cmd+K search with dark modal styling 2026-01-05 17:17:02 -08:00
zeekay 2c284c3ba9 fix(docs): remove blue links, fix search box dark styling 2026-01-05 17:09:05 -08:00
zeekay 2c1de4a558 fix(docs): improve header tab contrast and visibility 2026-01-05 16:56:59 -08:00
zeekay 0b3f222b2c fix(docs): add .gitkeep to overrides directory for GitHub Actions 2026-01-05 16:40:53 -08:00
zeekay 724cd00192 style(docs): add Geist font, Hanzo logo, and shadcn/ui dark theme 
- Replace default logo with Hanzo logo (white for dark header)
- Add Hanzo favicon
- Configure Geist font family from jsdelivr CDN
- Configure Geist Mono for code blocks
- Implement shadcn/ui zinc color palette
- Set pure black header (#000000) matching shadcn dark mode
- Set slate scheme as default (dark mode first)
- Style code blocks, tables, admonitions with rounded corners
- Remove footer, add scrollbar styling
- Fix mkdocstrings config (deprecated selection option)
 2026-01-05 16:39:16 -08:00
zeekay 759217957d docs(mcp): add comprehensive parity analysis for Python/TS/Rust MCPs 2026-01-05 16:05:34 -08:00
zeekay f2b5985e72 fix(docs): rename llm.md to llm-tools.md to avoid gitignore 2026-01-05 13:43:11 -08:00
zeekay fbee568f07 docs: create unified documentation site for python-sdk 
- Add root-level mkdocs.yml with comprehensive navigation
- Create docs/ directory with:
  - Getting started (installation, quickstart)
  - MCP tools documentation (shell, browser, memory, etc.)
  - Agent SDK documentation structure
  - API reference stubs
- Update GitHub workflow to build from root mkdocs.yml
- Add Material theme with dark/light mode toggle

The docs site will be available at hanzoai.github.io/python-sdk/
 2026-01-05 13:42:30 -08:00
zeekay 416efa0a98 feat: HANZO_AUTO_BACKGROUND_TIMEOUT=0 disables auto-backgrounding 
- Setting timeout to 0 or negative now disables auto-backgrounding
  (uses 24h internal timeout instead of immediate backgrounding)
- Updated docstrings to document the disabled behavior
- hanzo-tools-shell 0.5.6, hanzo-tools-agent 0.3.1, hanzo-mcp 0.10.35
 2026-01-05 12:50:30 -08:00
zeekay f32a817024 feat: configurable HANZO_AUTO_BACKGROUND_TIMEOUT env var (default: 30s) 2026-01-05 06:41:08 -08:00
zeekay 7995da7c08 chore: bump hanzo-mcp to 0.10.33, update shell dep to 0.5.4 2026-01-05 01:27:01 -08:00
zeekay 5a39eec1c8 perf: 30s auto-backgrounding + fix hanging processes 
- Change default timeout from 45s to 30s for faster response
- Fix potential hanging in run_shell by using stream reading instead of communicate()
- Add start_new_session=True to prevent zombie processes
- Proper cleanup on error with process.kill()
- All stream reading uses chunked async reads (8KB chunks)
- Partial output preserved when backgrounding

53 tests pass in 1.1s.
 2026-01-05 01:05:53 -08:00
zeekay 28d71006e6 fix: async audit improvements and test fixes 
- Fix deprecated asyncio.get_event_loop() → get_running_loop() in open_tool.py
- Add documentation for ProcessManager dict modification pattern
- Add module docstring for hanzo_async.paths explaining executor usage
- Fix bash test to use proper bash syntax (not zsh-style { } backgrounding)
- Bump hanzo-tools-shell 0.5.2 → 0.5.3
- Bump hanzo-async 0.1.0 → 0.1.1

All 53 shell tests pass. Async code review: production-ready.
 2026-01-04 17:18:57 -08:00
zeekay 813c773293 chore: bump hanzo-mcp to 0.10.32 2026-01-04 16:51:48 -08:00
zeekay 12379913cd refactor: remove ambiguous shell tool, keep specific shells 
- Remove ShellTool from TOOLS list (too ambiguous)
- Keep zsh, bash, fish, dash as specific shell tools
- Update get_shell_tools to include bash
- Fix test imports (ShellTool now in shell_tools.py)
- Update tests to expect cmd as primary tool
- Verify asyncio.gather + uvloop works correctly

hanzo-tools-shell: 0.5.1 → 0.5.2
 2026-01-04 13:27:34 -08:00
zeekay 5e8660a87e chore: bump versions for PyPI release 
- hanzo-async: 0.1.0 (new)
- hanzo-tools-fs: 0.3.1
- hanzo-tools-shell: 0.5.1
- hanzo-tools-agent: 0.3.0
- hanzo-mcp: 0.10.31
 2026-01-03 17:41:51 -08:00
zeekay 98c079f4cb feat: add hanzo-async unified async I/O with uvloop support 
New package: hanzo-async
- Automatic uvloop detection and configuration
- Async file I/O (read_file, write_file, append_file, read_json, write_json)
- Async path operations (path_exists, is_file, is_dir, mkdir, etc.)
- Async subprocess execution (run_command, run_shell)
- Graceful fallback to asyncio on Windows or when uvloop not installed

Updated packages to use hanzo-async:
- hanzo-tools-shell: base_process.py, ps_tool.py, shell_tools.py
- hanzo-tools-agent: agent_tool.py, dataset.py
- hanzo-tools-fs: search.py
- hanzo-mcp: cli.py, auto_timeout.py, event_loop.py, version_tool.py

Shell improvements:
- Renamed zsh_tool.py to shell_tools.py (better organization)
- Added DashTool for Debian/Ubuntu's fast POSIX shell
- All shell tools now thin shims over CmdTool

Version info now shows async backend:
- CLI: hanzo-mcp 0.10.27 (async: uvloop 0.22.1)
- Tool: async: uvloop 0.22.1
 2026-01-03 17:39:48 -08:00
zeekay af7272fba4 docs: add Next.js documentation site with @hanzo/mdx 
- Fumadocs-based docs with @hanzo/mdx and @hanzo/ui integration
- Comprehensive SDK documentation for all packages:
  - hanzo-agent SDK (agents, tools, guardrails, tracing)
  - hanzo-mcp tools (filesystem, shell, browser, memory, etc.)
  - Client, models, embeddings, chat APIs
- Tailwind 4 + Next.js 16 + React 19 stack
- Static export for GitHub Pages deployment
 2025-12-29 20:16:38 -08:00
zeekay 6628c08fc4 fix(docs): install package for API reference generation 2025-12-27 21:29:46 -08:00
zeekay 9d68695d13 fix(docs): pin mkdocstrings version for compatibility 2025-12-27 21:27:50 -08:00
zeekay af162be170 fix(docs): checkout submodules for docs build 2025-12-27 21:26:25 -08:00
zeekay 07a993cf0b ci(docs): add GitHub Pages deployment workflow 2025-12-27 21:24:35 -08:00
zeekay 4248e21838 fix(imports): update filesystem to fs in agent tools 2025-12-27 20:36:12 -08:00
zeekay ea351e4c19 fix(lint): fix import sorting and lru_cache noqa 
- Fix 12 import sorting issues (I001)
- Add noqa for lru_cache in shellflow.py (TID251 rule for Stainless SDK)
 2025-12-27 20:32:45 -08:00
zeekay 18cac365c4 style(hanzo): format with black 2025-12-27 16:25:51 -08:00
zeekay 2789b98b71 chore: rename Quality Gate workflow 2025-12-27 15:39:39 -08:00
zeekay aad3393721 fix(ci): update workflow to use hanzo_tools.agent imports 
- Replace hanzo_mcp.tools.agent.cli_tools with hanzo_tools.agent
- Update test imports to use AgentTool, IChingTool, ReviewTool
- Simplify integration tests for new agent tool API
 2025-12-27 15:30:38 -08:00
zeekay 0166de0a44 fix(mcp): correct import in litellm warning test 
- Change register_agent_tools to register_tools (actual export name)
 2025-12-27 15:26:31 -08:00
zeekay 1211c4b85f fix(mcp): simplify agent tests to match actual API 
- Remove tests for non-existent AgentTool attributes (AGENTS, _mcp_config, etc.)
- Update uv.lock with latest package versions
- Keep only basic tool creation and registration tests
 2025-12-27 15:25:11 -08:00
zeekay 72ed8075a7 style: format hanzo_mcp/__init__.py 2025-12-27 15:21:35 -08:00
zeekay 7595f8c941 style: fix import sorting in test file 2025-12-27 15:20:15 -08:00
zeekay e8f601ea52 fix(mcp): update tests to use AgentTool instead of UnifiedAgentTool 2025-12-27 15:18:54 -08:00
zeekay 5a66967dee fix(ci): update workflow tool counts 
- hanzo_tools.filesystem -> hanzo_tools.fs
- shell: 7 -> 11 tools (added bash, curl, jq, wget)
- memory: 9 -> 1 (unified tool with actions)
- agent: 10-12 -> 3 (AgentTool, IChingTool, ReviewTool)
- Total: 40 tools
 2025-12-27 15:15:36 -08:00
zeekay b631e1634b fix(core): update memory tool count (1 unified tool, not 9) 2025-12-27 15:13:50 -08:00
zeekay 5b9b968491 fix(core): remove ToolCategory from exports (it's in hanzo-mcp, not hanzo-tools-core) 2025-12-27 15:11:58 -08:00
zeekay d75c6d894e fix(core): import MCPResourceDocument from types.py, not base.py 2025-12-27 15:09:52 -08:00