openbox-sdk-python

OpenBox base SDK (import openbox_core) — the standalone core every OpenBox framework SDK builds on. It owns:

  • Contracts — event and result dataclasses (EventEnvelope, EvaluationResult, ApprovalResult, Verdict).
  • Always-strict governance gate — malformed event/runtime contracts raise ContractError before send; there are no configurable gate modes.
  • Identity & signing — AIP DID validation + Ed25519 request signing, byte-compatible with the Temporal SDK signing contract.
  • Evaluate client — sync + async calls to OpenBox Core (/api/v1/governance/evaluate, /approval, /auth/validate).
  • Context & runtime — ActivityContext, ContextStore, trace correlation, FrameworkAdapter protocol, OpenBoxRuntime.
  • OTel span wire serialization — OTel spans are the internal source of truth, projected to the current Core SpanData wire shape before send.
  • Generic instrumentation — HTTP/DB/file/function wrappers with a started/completed hook runtime enforcing preflight before real operations.
  • Conformance kit — reusable fixtures framework SDKs run to prove parity.

Framework SDKs (Temporal, LangGraph, LangChain, DeepAgent, CrewAI) are thin adapters: they bind framework lifecycle into ActivityContext, emit lifecycle events, and translate EvaluationResult into native behavior.

Framework SDK integration

New framework SDK developers and agents should start with the OpenBox Python Framework SDK Integration guide. It describes how to build a framework SDK on top of this base package without reimplementing config, signing, governance gates, hook wire payloads, or conformance fixtures.

Install

uv sync                 # core
uv sync --extra http    # + HTTP instrumentation targets
uv sync --extra db      # + DB instrumentation targets

Import safety

openbox_core.__init__ and all openbox_core.contracts.* modules import without pulling in httpx, cryptography, requests, or OTel instrumentation — safe for constrained framework paths such as the Temporal workflow sandbox. tests/test_import_safety.py enforces this in CI.

Development

uv sync --all-extras
uv run pytest
uv run ruff check .

Key dates

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

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: OpenBox Team

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

db http

Tags

governance observability openbox opentelemetry sdk

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

openbox_sdk_python-1.1.0.tar.gz (179.4 kB view details)

Uploaded Source

Built Distribution

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

openbox_sdk_python-1.1.0-py3-none-any.whl (90.7 kB view details)

Uploaded Python 3

File details

Details for the file openbox_sdk_python-1.1.0.tar.gz.

File metadata

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

File hashes

Hashes for openbox_sdk_python-1.1.0.tar.gz
Algorithm Hash digest
SHA256 4f3915fcac9759b89b3454f042d8b94f946dd7f10163d40b492fce80ea70ea88
MD5 d482d3b1b9d1e394572fb8200d5b8266
BLAKE2b-256 0cb7aeeb671e47b47dea52060f394d88eb1d9edde2556da64b054271b0cb9cd3

See more details on using hashes here.

Provenance

The following attestation bundles were made for openbox_sdk_python-1.1.0.tar.gz:

Publisher: publish.yml on OpenBox-AI/openbox-sdk-python

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

File details

Details for the file openbox_sdk_python-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for openbox_sdk_python-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0425e57bf98826ba0f21f2b23c7aae61d35a8aa70bb464e4eadfc758e50434b4
MD5 4053627c8811891471bc349891b50566
BLAKE2b-256 5958e9cf85cf62dcd25071d6f7fe1f76a79db85ba4ef30f0fee3ab4747291385

See more details on using hashes here.

Provenance

The following attestation bundles were made for openbox_sdk_python-1.1.0-py3-none-any.whl:

Publisher: publish.yml on OpenBox-AI/openbox-sdk-python

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

Release history Release notifications | RSS feed

1.2.0

2 files

This release

1.1.0 This release

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

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