AURORA Agent Evidence SDK v0.3

aurora-agent is a local-first Python SDK for instrumenting declared consequential machine actions and transmitting compositional execution evidence to AURORA.

It provides two compatible surfaces:

  1. Local action evidence — proposal, authorization/policy, precommit, execution, outcome, deterministic bundle export, and offline verification.
  2. AURORA ingestion — incremental runtime events, a durable SQLite outbox, idempotent transport, and finalization into an immutable AURORA Compositional Evidence graph.

Core properties:

  • deterministic JSON canonicalization and SHA-256 commitments;
  • raw-payload minimization with DIGEST_ONLY as the default;
  • explicit REDACTED and FULL_PAYLOAD modes;
  • API keys held only in memory and never written to the outbox;
  • ordered, crash-recoverable delivery with stable idempotency keys;
  • generic Python capture surface;
  • framework-light Claude Agent SDK adapter;
  • direct observer integration with the JAKROW D3 execute_operation path;
  • final AURORA graph linked to an existing sealed AURORA record.

Package identity:

  • distribution: aurora-agent
  • import: aurora_agent
  • version: 0.3.0
  • Python: >=3.11,<3.14

Documentation:

  • SELF_SERVE_QUICKSTART.md
  • QUICKSTART.md
  • INGESTION_QUICKSTART.md
  • API_REFERENCE.md
  • THREAT_MODEL.md
  • NON_CLAIMS.txt
  • LICENSE and NOTICE
  • PRIVATE_RELEASE_NOTES.md

The SDK does not claim capture completeness, absence of bypass paths, causal truth, external-provider acknowledgement, qualified timestamp status, or legal compliance. DIGEST_ONLY protects raw values from the local outbox and AURORA payload storage, but AURORA can verify only the supplied client commitment unless the raw value is transmitted separately.

The aurora-agent SDK source and its generated Python distributions are licensed under the Apache License, Version 2.0. See LICENSE, NOTICE, and the repository-root LICENSING.md. AURORA hosted services and JAKROW components outside aurora-agent/ are not included in that grant.

Self-serve quickstart

After creating a Sandbox API key at https://auroraseal.com/app/quickstart:

pip install aurora-agent
export AURORA_API_KEY="<shown-once-key>"
aurora-agent quickstart

The command creates a controlled sample record, commits evidence locally before a local SQLite ledger operation, finalizes the graph, verifies it server-side, and prints the authenticated Viewer URL. It does not perform an external payment, message, purchase, or customer operation. The default capture mode is DIGEST_ONLY; the API key is not persisted in the outbox.

Recovery commands:

aurora-agent outbox status --outbox PATH
aurora-agent outbox flush --outbox PATH

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.9.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Jakman1225 from gravatar.com Jakman1225

Credits

Author: AURORA

License expression

Apache-2.0
View SPDX License List

Requires

Python <3.14, >=3.11

Provides Extra

test

Tags

ai-agents evidence auditability runtime compliance

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aurora_agent-0.3.0.tar.gz (49.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aurora_agent-0.3.0-py3-none-any.whl (44.5 kB view details)

Uploaded Python 3

File details

Details for the file aurora_agent-0.3.0.tar.gz.

File metadata

  • Download URL: aurora_agent-0.3.0.tar.gz
  • Upload date:
  • Size: 49.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for aurora_agent-0.3.0.tar.gz
Algorithm Hash digest
SHA256 1d68b8e3b7c58e2f51a8b9da5237459a83358cb6b17039bc79136c143b8745bc
MD5 47b26f065f8f9b46a792cf40290497bb
BLAKE2b-256 b77b8db0820912bb345f3a7197eb566b8ad8fb6c45acfcf0c71001ae7afa329a

See more details on using hashes here.

Provenance

The following attestation bundles were made for aurora_agent-0.3.0.tar.gz:

Publisher: aurora-agent-publish-pypi.yml on Jakman1225/jakrow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aurora_agent-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: aurora_agent-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 44.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for aurora_agent-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f8a5659796858ad29365f0750250a65ce906ee40c747bf71fb8a37b533743ae6
MD5 1f0ca5b5955ab96fae4c38d1e1f5d58a
BLAKE2b-256 e0e1fc71b6db852b4cdf074a30123a5e5a1d1ddd82838730ce79305c8bb1e724

See more details on using hashes here.

Provenance

The following attestation bundles were made for aurora_agent-0.3.0-py3-none-any.whl:

Publisher: aurora-agent-publish-pypi.yml on Jakman1225/jakrow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page