mirror of
https://github.com/hanzoai/python-sdk.git
synced 2026-10-23 20:23:00 +00:00
zeekay
86c2cdcc0d
- Add hanzo-tools-code: code analysis and transformation tools - Add hanzo-tools-net: network and HTTP tools - Add hanzo-tools-plan: planning and task management tools - Add hanzo-tools-test: testing tools - Add hanzo-tools-vcs: version control tools - Add install command for dependency management - Improve CDP bridge server with better error handling - Add ui_tool for computer tools - Add unified tool loading and id_tool - Add HIP documentation (HIP-0300, HIP-0301)
130 lines
4.0 KiB
Markdown
130 lines
4.0 KiB
Markdown
# Tools Overview
|
|
|
|
Complete documentation for all `hanzo-tools-*` packages.
|
|
|
|
> **Architecture**: Tools follow [HIP-0300](../hip/HIP-0300.md) - the Unified MCP Tools Architecture with orthogonal operators and effect tracking.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# All tools (recommended)
|
|
pip install hanzo-mcp[tools-all]
|
|
|
|
# Core development tools
|
|
pip install hanzo-mcp[tools-dev]
|
|
|
|
# Individual packages
|
|
pip install hanzo-tools-shell hanzo-tools-browser
|
|
```
|
|
|
|
## Tool Categories
|
|
|
|
### HIP-0300 Core Operators
|
|
|
|
Primary operators organized by orthogonal axes:
|
|
|
|
| Tool | Axis | Actions | Description |
|
|
|------|------|---------|-------------|
|
|
| [fs](fs.md) | Bytes + Paths | read, write, edit, search, patch, tree | Filesystem operations |
|
|
| [id](core.md) | Identity | hash, uri, ref, verify | Content-addressable identity |
|
|
| [code](code.md) | Symbols + Structure | parse, transform, summarize | Code analysis and transformation |
|
|
| [proc](shell.md) | Execution | run, bg, signal, wait | Process execution |
|
|
| [vcs](vcs.md) | History + Diffs | status, diff, commit, log | Version control |
|
|
| [test](test.md) | Validation | check, build, test | Validation loops |
|
|
| [net](net.md) | Network | search, fetch, download, crawl | Network operations |
|
|
| [plan](plan.md) | Orchestration | intent, route, compose | Intent routing |
|
|
|
|
### Control Surfaces
|
|
|
|
| Tool | Surface | Description |
|
|
|------|---------|-------------|
|
|
| [browser](browser.md) | Web DOM | Playwright automation (70+ actions) |
|
|
| [computer](computer.md) | OS Desktop | Mac automation via pyautogui |
|
|
|
|
### Extended Operators
|
|
|
|
| Tool | Domain | Description |
|
|
|------|--------|-------------|
|
|
| [lsp](lsp.md) | Semantic Stream | Language server protocol (diagnostics, code_actions) |
|
|
| [memory](memory.md) | Knowledge | Persistent memory and knowledge bases |
|
|
| [todo](todo.md) | Task Tracking | Task management |
|
|
| [reasoning](reasoning.md) | Cognition | Structured thinking (think, critic) |
|
|
| [agent](agent.md) | Multi-Agent | Agent orchestration (run, list, status) |
|
|
| [llm](llm-tools.md) | LLM Interface | Unified LLM interface (llm, consensus) |
|
|
|
|
### Infrastructure
|
|
|
|
| Package | Tools | Description |
|
|
|---------|-------|-------------|
|
|
| [Core](core.md) | Base classes | BaseTool, IdTool, ToolRegistry |
|
|
| [Config](config.md) | 2 | Configuration and mode management |
|
|
| [Database](database.md) | 8 | SQL and graph database operations |
|
|
| [Vector](vector.md) | 3 | Semantic search with embeddings |
|
|
| [Refactor](refactor.md) | 1 | Code refactoring (rename, extract, inline) |
|
|
| [Jupyter](jupyter.md) | 1 | Notebook read/edit/execute |
|
|
| [Editor](editor.md) | 3 | Neovim integration |
|
|
| [MCP](mcp-tools.md) | 4 | MCP server management |
|
|
|
|
## Quick Reference
|
|
|
|
### Most Used Tools
|
|
|
|
```python
|
|
# File operations
|
|
read(file_path="/path/to/file")
|
|
write(file_path="/path/to/file", content="...")
|
|
edit(file_path="/path/to/file", old_string="old", new_string="new")
|
|
|
|
# Command execution
|
|
cmd("ls -la")
|
|
cmd(["npm install", "npm build"], parallel=True)
|
|
|
|
# Search
|
|
search(pattern="TODO", path=".")
|
|
ast(pattern="def test_", path="/tests")
|
|
|
|
# Reasoning
|
|
think(thought="Analyzing the problem...")
|
|
critic(analysis="Code review findings...")
|
|
|
|
# Browser
|
|
browser(action="navigate", url="https://example.com")
|
|
browser(action="click", selector="button")
|
|
```
|
|
|
|
### Tool Discovery
|
|
|
|
```python
|
|
from importlib.metadata import entry_points
|
|
|
|
# Discover all available tools
|
|
for ep in entry_points(group="hanzo.tools"):
|
|
tools = ep.load()
|
|
print(f"{ep.name}: {[t.name for t in tools]}")
|
|
```
|
|
|
|
## Architecture
|
|
|
|
All tools follow a consistent pattern:
|
|
|
|
```python
|
|
from hanzo_tools.core import BaseTool, ToolContext
|
|
|
|
class MyTool(BaseTool):
|
|
name = "my_tool"
|
|
|
|
@property
|
|
def description(self) -> str:
|
|
return "Tool description"
|
|
|
|
async def call(self, ctx: ToolContext, **params) -> str:
|
|
# Implementation
|
|
return result
|
|
```
|
|
|
|
## See Also
|
|
|
|
- [Core Libraries](../lib/index.md) - Supporting packages (async, consensus, network)
|
|
- [MCP Reference](../ref/mcp/index.md) - Server documentation
|
|
- [Agent Framework](../ref/agent/index.md) - Multi-agent SDK
|