Metadata-Version: 2.4
Name: hanzo-tools-computer
Version: 0.5.4
Summary: Computer control tools for Hanzo AI - automation, screen recording, activity detection, session compression for Claude (100 images/32MB/2000px limits)
Author-email: Hanzo AI <dev@hanzo.ai>
License-Expression: MIT
Keywords: ai,automation,computer,hanzo,mcp,pyautogui,tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Requires-Dist: hanzo-tools>=0.3.0
Requires-Dist: mcp>=1.25.0
Requires-Dist: numpy>=1.26.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# hanzo-tools-computer

Computer control tools for Hanzo AI - pyautogui-based Mac automation.

## Installation

```bash
pip install hanzo-tools-computer
```

## Usage

```python
from hanzo_tools.computer import ComputerTool, register_tools

# Register with MCP server
register_tools(mcp_server, permission_manager)
```

## Actions

### Mouse
- `click` - Click at (x, y)
- `double_click` - Double click at (x, y)
- `right_click` - Right click at (x, y)
- `move` - Move mouse to (x, y)
- `drag` - Drag to (x, y)
- `scroll` - Scroll by amount

### Keyboard
- `type` - Type text string
- `press` - Press single key
- `hotkey` - Press key combination

### Screen
- `screenshot` - Capture screen
- `locate` - Find image on screen
- `info` - Get screen/mouse info

## Examples

```python
# Click at coordinates
computer(action="click", x=100, y=200)

# Type text
computer(action="type", text="Hello world")

# Keyboard shortcut (Cmd+C on Mac)
computer(action="hotkey", keys=["command", "c"])

# Take screenshot
computer(action="screenshot")

# Get screen info
computer(action="info")
```

## Safety

- FAILSAFE enabled: Move mouse to corner to abort
- macOS only (checks platform)
- All actions run in executor threads (non-blocking)

## License

MIT
