atb-sdk 1.5.0

Python SDK for ATB (Agent Trace Bundle) — local-first AI audit trail

ATB Python SDK

The ATB Python SDK writes tamper-evident audit bundles in the same format as the Go CLI; bundles written by the SDK are verifiable with atb verify.

Installation

pip install atb-sdk

Quick example

from atb import Bundle
from atb.event_types import (
    AI_MODEL_INVOKED_EVENT_TYPE,
    AI_REQUEST_RECEIVED_EVENT_TYPE,
)

bundle = Bundle()

bundle.append(
    AI_REQUEST_RECEIVED_EVENT_TYPE,
    {
        "request_id": "req-001",
        "actor_id_hash": "hash-user-01",
        "purpose_tag": "quickstart_demo",
    },
)

bundle.append(
    AI_MODEL_INVOKED_EVENT_TYPE,
    {
        "model_provider": "openai",
        "model_id": "gpt-4o-mini",
        "model_parameters_digest": "sha256-params-abc",
        "prompt_digest": "sha256-prompt-def",
    },
)

path = bundle.save("run.atb/bundle.atb")
print(path)

Supported event types

Event type constant name	Event type string
BUNDLE_MANIFEST_EVENT_TYPE	atb.bundle.manifest
BUNDLE_ANCHOR_EVENT_TYPE	atb.bundle.anchor
BUNDLE_SIGNATURE_EVENT_TYPE	atb.bundle.signature
AI_REQUEST_RECEIVED_EVENT_TYPE	ai.request.received
AI_RESPONSE_SENT_EVENT_TYPE	ai.response.sent
AI_POLICY_DECISION_EVENT_TYPE	ai.policy.decision
AI_RETRIEVAL_EXECUTED_EVENT_TYPE	ai.retrieval.executed
AI_MODEL_INVOKED_EVENT_TYPE	ai.model.invoked
AI_MODEL_OUTPUT_EVENT_TYPE	ai.model.output
AI_ACTION_PRECOMMIT_EVENT_TYPE	ai.action.precommit
AI_ACTION_EXECUTED_EVENT_TYPE	ai.action.executed
AI_ACTION_COMMITTED_EVENT_TYPE	ai.action.committed
AI_HUMAN_APPROVAL_EVENT_TYPE	ai.human.approval
AI_JOB_SCHEDULED_EVENT_TYPE	ai.job.scheduled
AI_JOB_STARTED_EVENT_TYPE	ai.job.started
AI_JOB_STEP_EVENT_TYPE	ai.job.step
AI_JOB_COMPLETED_EVENT_TYPE	ai.job.completed
DATA_EXPORT_PRECOMMIT_EVENT_TYPE	data.export.precommit
DATA_EXPORT_EXECUTED_EVENT_TYPE	data.export.executed

Profile support

To verify a bundle against a profile, use the Go CLI: atb verify --bundle <path> --profile <profile-id>. The Python SDK does not include a verifier.

LangChain integration

For LangChain middleware guidance, see docs/integrations/.

Licence

MIT.