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:
Latest release

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.2.0.tar.gz (179.9 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.2.0-py3-none-any.whl (90.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openbox_sdk_python-1.2.0.tar.gz
  • Upload date:
  • Size: 179.9 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.2.0.tar.gz
Algorithm Hash digest
SHA256 37b66fc759e889c0556ac4c9b6bc573b27b8e1391d90ed276bc65ef2751ac416
MD5 8a24037a2eca4fa82a16c9557304dfad
BLAKE2b-256 e247cfd149354090f3c6fa4ca23c479179d695e5fdcb213ac441643270a8e0f7

See more details on using hashes here.

Provenance

The following attestation bundles were made for openbox_sdk_python-1.2.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.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for openbox_sdk_python-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9f32929ee28cd626bc25c6a9c83292bc08eb355152baebf113fccb59d0af105a
MD5 aae278fa4a69d509934c0880a47b251d
BLAKE2b-256 7a163a8e24625e601a512f28ac738e13e2dac3206425e4a60662a04085a6688c

See more details on using hashes here.

Provenance

The following attestation bundles were made for openbox_sdk_python-1.2.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

This release

1.2.0 This release

2 files

1.1.0

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