counteraudit 0.1.0

HTTP client for the CounterAudit audit ingest API

counteraudit

Python client for the CounterAudit API. Requires Python 3.8+.

Install

pip install counteraudit

Usage

import os
from counteraudit import CounterAuditClient, CounterAuditError

# Initialize client
client = CounterAuditClient(
    base_url="https://api.counteraudit.io",
    api_key=os.environ["COUNTERAUDIT_API_KEY"]
)

# Health check
print(client.health())
# {'ok': True, 'service': 'counteraudit-api', 'version': '0.8.0'}

# Ingest an event
result = client.ingest(
    connector_id="langchain-v0.3",
    raw_event={
        "run_id": "run-1",
        "model_id": "gpt-4o",
        "input": "hello"
    }
)
print(result["packet_id"], result["entry_hash"])

# Verify a packet
verification = client.verify(result["packet_id"])
print(verification["valid"])  # True
print(verification["rfc3161_verified"])

# Get agentic debt metrics
debt = client.dashboard_debt(days=30)
print(debt["agentic_debt_index"])
print(debt["by_connector"])

# List packets (paginated)
page = client.list_packets(limit=20)
print(len(page["packets"]))
if page["next_cursor"]:
    next_page = client.list_packets(cursor=page["next_cursor"])

Context manager

with CounterAuditClient(base_url="...", api_key="...") as client:
    health = client.health()
    print(health)
# Session automatically closed

Error handling

try:
    client.verify("invalid-packet-id")
except CounterAuditError as e:
    print(f"Error {e.status_code}: {e.message}")
    print(e.body)  # Full error response

API Reference

Method	Maps to	Returns
health()	GET /health	Health dict
ingest(connector_id, raw_event, org_id=None)	POST /v1/audit/ingest	Ingest result
verify(packet_id)	GET /v1/audit/verify/:id	Verification result
chain(org_id)	GET /v1/audit/chain/:org_id	Chain summary
list_packets(limit=None, cursor=None)	GET /v1/audit/packets	Paginated list
list_connectors()	GET /v1/connectors	Connectors list
register_connector(...)	POST /v1/connectors/register	Created connector
update_connector(id, field_map=None, risk_defaults=None)	PATCH /v1/connectors/:id	Updated connector
delete_connector(connector_id)	DELETE /v1/connectors/:id	None
list_keys()	GET /v1/keys	Keys list (masked)
create_key(label=None)	POST /v1/keys	Created key (plaintext once)
delete_key(key_id)	DELETE /v1/keys/:id	None
dashboard_debt(days=None)	GET /v1/dashboard/debt	Debt summary

Development

From the monorepo:

cd packages/counteraudit-py
pip install -e .

License

MIT — see LICENSE in the repository root.