openbox-sdk-python 0.2.0__py3-none-any.whl

openbox_sdk_python-0.2.0.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: openbox-sdk-python
+Version: 0.2.0
+Summary: OpenBox base SDK - governance contracts, strict gate, identity/signing, evaluate client, context runtime, OTel span wire serialization, and generic instrumentation shared by every OpenBox framework SDK
+Author-email: OpenBox Team <tino@openbox.ai>
+License-Expression: MIT
+Keywords: governance,observability,openbox,opentelemetry,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: cryptography<47,>=43
+Requires-Dist: httpx<1,>=0.28.0
+Requires-Dist: opentelemetry-api<1.40.0,>=1.38.0
+Requires-Dist: opentelemetry-sdk<1.40.0,>=1.38.0
+Provides-Extra: db
+Requires-Dist: asyncpg>=0.29.0; extra == 'db'
+Requires-Dist: opentelemetry-instrumentation-asyncpg<0.61b0,>=0.59b0; extra == 'db'
+Requires-Dist: opentelemetry-instrumentation-dbapi<0.61b0,>=0.59b0; extra == 'db'
+Requires-Dist: opentelemetry-instrumentation-redis<0.61b0,>=0.59b0; extra == 'db'
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy<0.61b0,>=0.59b0; extra == 'db'
+Requires-Dist: pymongo>=4.6.0; extra == 'db'
+Requires-Dist: redis>=5.0.0; extra == 'db'
+Requires-Dist: sqlalchemy>=2.0.0; extra == 'db'
+Requires-Dist: wrapt>=1.16.0; extra == 'db'
+Provides-Extra: http
+Requires-Dist: opentelemetry-instrumentation-httpx<0.61b0,>=0.59b0; extra == 'http'
+Requires-Dist: opentelemetry-instrumentation-requests<0.61b0,>=0.59b0; extra == 'http'
+Requires-Dist: opentelemetry-instrumentation-urllib3<0.61b0,>=0.59b0; extra == 'http'
+Requires-Dist: opentelemetry-instrumentation-urllib<0.61b0,>=0.59b0; extra == 'http'
+Requires-Dist: requests>=2.31.0; extra == 'http'
+Description-Content-Type: text/markdown
+
+# 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](.github/instructions/openbox-sdk-python.instructions.md).
+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
+
+```bash
+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
+
+```bash
+uv sync --all-extras
+uv run pytest
+uv run ruff check .
+```

openbox_sdk_python-0.2.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+openbox_core/__init__.py,sha256=xdbYBImDu2mUeTVo_9U4TvaeSoUpFcTE7kwwtPn0a4Q,1983
+openbox_core/approvals.py,sha256=eobLN4rSBvaFaTbsPExu2XcGS5fSuWvo0GC1DR18w0I,4400
+openbox_core/client.py,sha256=Mo3HSFj7VmDYLiTJ0FnJdxNdetjU-NHK8IrBU7AL4vU,12615
+openbox_core/config.py,sha256=-YasfXrRmA2u_iywtFF0AysAp88hzHWu19je5cy4mo8,9684
+openbox_core/context.py,sha256=sNYnFYzZkHGDcrVmDSpRSx_uU818OPRNZBgUegWBcBk,7648
+openbox_core/errors.py,sha256=6nLNYNpHqoXSpsYl4Cf3kwG6-huYN_p5RRvdbjFok64,12114
+openbox_core/gate.py,sha256=xRzwM7VI1oWGNxiQqsZnUcuBg3S0GJEXqs0nliVaIsM,8649
+openbox_core/identity.py,sha256=avyiosTeuB4MnMGJx8ZNfK48am2tnipQ1f2pFI_VHtI,8400
+openbox_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+openbox_core/runtime.py,sha256=5pm_lxk1DGY8HDmfEnfvuCXJvzLai5CD71Yp8LtAz8U,5912
+openbox_core/sdk_version.py,sha256=vlBs5mJVcSJmpbijVissRGuUDlwmTK2w94TgCPHIOcQ,2207
+openbox_core/serialization.py,sha256=DT1bXF33REkjSn72svUYwC-98xeD1yw8h88gheDqIt8,4642
+openbox_core/adapters/__init__.py,sha256=RBN5_-V4qa55kKPzO3ownU8f70dPPQzyzeHway7JkGc,67
+openbox_core/adapters/base.py,sha256=U021sq08BvRzHTgbSijErFi89R5GZUgEBnyYzSQjiqc,4653
+openbox_core/conformance/__init__.py,sha256=muxUxcflVR-sZbX7R_uEFiREC0PQmI4ozO7gH2JQIc0,91
+openbox_core/conformance/fake_core.py,sha256=d4WlM867zVWNzxbFYI-M7hlyVQa67QC-IEg2LVqLM2o,6181
+openbox_core/conformance/hook_preflight.py,sha256=jRKNcM-yUUtCL6uYgf-XcFQUbI8Vcl8za62eY-vyEOk,3172
+openbox_core/conformance/instrumentation.py,sha256=MMx6H2Q7AofF6V-bWAR1ZXBXg5Jmczg4qW0Ehl-C3FM,3010
+openbox_core/contracts/__init__.py,sha256=7uBSUIxfUG6uZDsotQmT1jjXs3G75M2hFHtYEln_FGU,122
+openbox_core/contracts/context.py,sha256=V-eVbB-NIrXI1NKduengG0GVx7q1wKawyhwZh-D0C9Y,2873
+openbox_core/contracts/events.py,sha256=Loy5IW4UyPiffBVYK06IxiID6NKsNQjoTLguBb-j4Uw,13428
+openbox_core/contracts/otel_spans.py,sha256=PnElhgdOM_qlYVF9thPxvhNxloXOb3fpgSXDQN3evWg,10753
+openbox_core/contracts/results.py,sha256=3nxMxbK02jzgf5wh6TS5UVIS5J_jU7-HGxl9Loie9gs,10723
+openbox_core/hooks/__init__.py,sha256=jAZGEbN-sZbBD7o_tV-9ZDhBki88yHXKVQf4qhhkYTc,63
+openbox_core/hooks/events.py,sha256=PQSzH_8vLyUopjCDu6dxCtVh7OvNbiWnLx87fCY5jnU,2129
+openbox_core/hooks/preflight.py,sha256=W0pJKLo0OSQ9knyeM4ZZPdZeTcU4Fb8PLbeCB8hR71o,12723
+openbox_core/hooks/wrappers.py,sha256=KVyWhQ36FOP81L8lTo0TNNYSKo0bHmkcF47oMcLiTSg,3282
+openbox_core/instrumentation/__init__.py,sha256=1vGDrIwVdysd0xiaGMle_6R29UIWkyshJbK8G92NNPY,94
+openbox_core/instrumentation/db.py,sha256=GRGQFFemz75mHW9HRpqS8NfSCkCG9cofKcGKu0m506g,25058
+openbox_core/instrumentation/file.py,sha256=4fWl830VbGNnz4-G46yfpsq9hAhU0Vh9OpPdAy8v0L8,8648
+openbox_core/instrumentation/function.py,sha256=VBp_ubqdtzEutihUzUxEEYrqPSEfYaOZOkNLBU04B4E,3915
+openbox_core/instrumentation/http.py,sha256=9V2RoI1OB-AAWyD7Uw-pwzIV7TFiP2W5lR3EHETHlQo,28782
+openbox_core/instrumentation/llm.py,sha256=tDl1Vir4hl92MD94hurCt8v1_vhLkG_TB-uskW5YHpg,73
+openbox_core/instrumentation/manager.py,sha256=k2tTeBasQViDE8icGpFjQtuOAE4_mCz_A00vWFJvFqk,5643
+openbox_core/instrumentation/shared.py,sha256=cJ95L5p45zAuH75fCtoGC3C1-8oacQHayi8qsQhokWw,751
+openbox_core/otel/__init__.py,sha256=jt23K51OPKBmnDYe-VFSpYorkiu1QD-SUDZ2RuWul9s,114
+openbox_core/otel/propagation.py,sha256=oiy7CjH6NpsmVlffbhv7dc-ztgUtYHiNK2c4hhq0xIw,1660
+openbox_core/otel/provider.py,sha256=u2HAw3uUptsgiq_GMuJ9xz5m3tFzXvAiLu_pAC6tBFs,1145
+openbox_core/otel/setup.py,sha256=2WWmT0PjO8--4ZHIn_ZqhIo-qxFbKw7bLdpTWp8xCks,1289
+openbox_core/otel/span_processor.py,sha256=0cGanVux9OxgQwSWcl_bWZh1Vmx5mEpiCP4R8BK4m2k,2321
+openbox_core/otel/trace_context.py,sha256=blyLx6fekp6-JRHOooAfxEADXokqFrgtnVCMFFihQO0,2330
+openbox_core/validation/__init__.py,sha256=4SidWNPFY_GAkOccprotz6CfcvdNCh8WpxUpn_NDDxg,77
+openbox_core/validation/diagnostics.py,sha256=z5NqhtFgsym0uSS9GPd4kXpKd510e6Mb_mLFdRe9sVI,1677
+openbox_core/validation/event_rules.py,sha256=2ayE0aerCK1fRDwRodOHIo0BsPsJj7Egb9-lrSXBEhA,6536
+openbox_core/validation/registry.py,sha256=U2XvNCtcMgQlhPge38aZeMRTtv1QHQHDS4dM5QAPW_I,1145
+openbox_core/validation/span_normalization.py,sha256=mB8GghMwOo3WGdKNrm6g8krP7KmG5_TRIFI3cDdO2PQ,3611
+openbox_core/wire/__init__.py,sha256=bI-snmNkEvLKqyYl1fItOCwAo46ehKD9vykOFfqaZz0,105
+openbox_core/wire/core_span.py,sha256=U_d93VSa8992DQ_dqP2dgzp4Vu7eEROishH_oQZFuvM,5059
+openbox_core/wire/evaluate_payload.py,sha256=RQ9TaeMLQ08YSmN1FYlvVFfOy0FLp0ve6LBLDi2ZKeI,2027
+openbox_sdk_python-0.2.0.dist-info/METADATA,sha256=-JBntef7yQMyfVw4ghn8FBT4poS5UIJP9aUmB_ToYBI,4381
+openbox_sdk_python-0.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+openbox_sdk_python-0.2.0.dist-info/RECORD,,

openbox_sdk_python-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any