Metadata-Version: 2.4
Name: hanzo-tools-memory
Version: 0.2.2
Summary: Memory and knowledge base tools for Hanzo MCP
Author-email: Hanzo Industries Inc <dev@hanzo.ai>
License: MIT
Keywords: hanzo,tools,memory,knowledge,mcp,ai
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: hanzo-tools>=0.3.0
Requires-Dist: mcp>=1.25.0
Requires-Dist: pydantic>=2.12.5
Provides-Extra: full
Requires-Dist: hanzo-memory>=0.1.0; extra == "full"

# hanzo-tools-memory

Memory and knowledge management tools for Hanzo MCP.

## Installation

```bash
pip install hanzo-tools-memory
```

## Tools

### memory - Memory Management
Single tool surface with action-based operations.

**Recall memories:**
```python
memory(action="recall", query="project architecture")
memory(action="recall", queries=["user preferences", "coding standards"])
```

**Create memories:**
```python
memory(action="create", content="User prefers dark mode")
```

**Update memories:**
```python
memory(action="update", id="mem_123", content="Updated fact")
```

**Delete memories:**
```python
memory(action="delete", ids=["mem_123", "mem_456"])
```

**Knowledge bases:**
```python
memory(action="facts", query="API endpoints", kb="api_docs")
memory(action="store", facts=["Rate limit: 100/hour"], kb="api_docs")
memory(action="kb", kb_action="list")  # List knowledge bases
```

**Summarize:**
```python
memory(
    action="summarize",
    content="Long discussion about API design...",
    tags=["api", "design"]
)
```

**Backend selection (optional):**
```python
memory(action="recall", query="project auth flow", backend="auto")   # local-first (default)
memory(action="recall", query="project auth flow", backend="local")  # markdown only
memory(action="recall", query="project auth flow", backend="cloud")  # cloud/vector only
memory(action="recall", query="project auth flow", backend="hybrid") # local + cloud
```

## Scopes

- `session` - Current session only
- `project` - Project-specific (default)
- `global` - Across all projects

## License

MIT
