Metadata-Version: 2.4
Name: helm-anthropic
Version: 0.4.0
Summary: HELM governance adapter for anthropic — fail-closed tool calling for AI agents
Author-email: Mindburn Labs <oss@mindburn.org>
License: Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: helm-sdk>=0.4.0
Requires-Dist: httpx>=0.25.0

# helm-anthropic

HELM governance adapter for [Anthropic Claude SDK](https://docs.anthropic.com).

## What it does

Governs Anthropic Claude tool_use calls through HELM:

1. Every tool_use content block is evaluated against HELM policy before execution
2. Denied calls raise `HelmToolDenyError` (fail-closed by default)
3. Receipts with SHA-256 hashes are collected for every approved execution

## Quick start

```python
from helm_anthropic import HelmAnthropicGovernor

governor = HelmAnthropicGovernor(helm_url="http://localhost:8080")
response = anthropic_client.messages.create(model="claude-sonnet-4-20250514", ...)
approved = governor.govern_message_response(response)
```

## Configuration

| Parameter          | Default                 | Description          |
| ------------------ | ----------------------- | -------------------- |
| `helm_url`         | `http://localhost:8080` | HELM kernel URL      |
| `api_key`          | `None`                  | HELM API key         |
| `fail_closed`      | `True`                  | Deny on HELM errors  |
| `collect_receipts` | `True`                  | Keep receipt chain   |
| `timeout`          | `30.0`                  | HTTP timeout seconds |

## License

Apache-2.0
