heed 0.1.0

Python SDK for Heed — human-in-the-loop approval for AI agents

heed

Python SDK for Heed — human-in-the-loop approval for AI agents.

Install

pip install heed

Quickstart

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

from heed import verify_webhook

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

Docs: https://heed.run/docs