Metadata-Version: 2.4
Name: heed
Version: 0.1.0
Summary: Python SDK for Heed — human-in-the-loop approval for AI agents
Project-URL: Homepage, https://heed.run
Project-URL: Documentation, https://heed.run/docs
Author-email: Heed <hello@getheed.ai>
License: MIT
Keywords: agents,ai-agents,approval,heed,hitl,human-in-the-loop
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# heed

Python SDK for [Heed](https://heed.run) — human-in-the-loop approval for AI agents.

## Install

```bash
pip install heed
```

## Quickstart

```python
from heed import Heed

client = Heed(api_key="hd_live_your_key_here")

result = client.request_approval(
    action="send_invoice",
    summary="Invoice ACME Corp for $5,200",
    context={"amount": 5200},
)

if result.get("requires_approval"):
    decision = client.wait_for_decision(result["id"], timeout=300)
    print(decision["status"])  # approved | rejected | ...
else:
    print("Auto-approved — proceed")
```

## Webhook verification

```python
from heed import verify_webhook

is_valid = verify_webhook(request_body, request.headers["X-OA-Signature"], webhook_secret)
```

Docs: https://heed.run/docs
