trigguard 0.2.0

TrigGuard product SDK — authorize, verify, attest, audit, explain, coach via POST /execute

TrigGuard (Python)

Pre-execution authorization for AI and automation — thin client for POST /execute, offline receipt verification, and the six product verbs.

Install

pip install trigguard

Python 3.9+ · depends on cryptography for offline Ed25519 verify only.

Quick start

import os
from trigguard import TrigGuard

tg = TrigGuard(
    api_key=os.environ["TRIGGUARD_API_KEY"],
    gateway_url=os.environ.get("TRIGGUARD_GATEWAY_URL", "https://api.trigguardai.com"),
)

result = tg.authorize(surface="deploy.release", actor="my-service")
trusted = tg.verify(result["receipt"]) if result.get("receipt") else False
print(result["decision"], trusted)

Product API (parity with Node)

Verb	Method
Authorize	tg.authorize(surface=..., actor=..., context=...)
Verify	tg.verify(receipt)
Attest	tg.attest(action=..., surface=...)
Audit	tg.audit(execution_id=...)
Explain	tg.explain(execution_id)
Coach	tg.coach(intent=...)

Factory: create_trigguard() · Legacy: Client.execute()

Adoption

• Python first 10 minutes
• Node first 10 minutes

Authority

Canonical PyPI source: sdk/python/ only. See docs/infrastructure/PYTHON_SDK_AUTHORITY.md.

PyPI publish

Parity work targets 0.2.0. Publish is gated on at least one Node design partner — build and validate locally until then.