dominus-sdk-python 9.0.4__tar.gz → 9.0.5__tar.gz

{dominus_sdk_python-9.0.4 → dominus_sdk_python-9.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 9.0.4
+Version: 9.0.5
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -48,7 +48,7 @@ cleanup audit is `docs/janitor/2026-08-04-sdk-python-cleanup-audit.md`.
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Transport compatibility for wrapped `{success,data}` responses and unwrapped Warden/control-plane success objects
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `9.0.4`
+- Current package version: `9.0.5`
 
 ## Install
 

{dominus_sdk_python-9.0.4 → dominus_sdk_python-9.0.5}/README.md

@@ -15,7 +15,7 @@ cleanup audit is `docs/janitor/2026-08-04-sdk-python-cleanup-audit.md`.
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Transport compatibility for wrapped `{success,data}` responses and unwrapped Warden/control-plane success objects
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `9.0.4`
+- Current package version: `9.0.5`
 
 ## Install
 

{dominus_sdk_python-9.0.4 → dominus_sdk_python-9.0.5}/dominus/__init__.py

@@ -178,7 +178,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "9.0.4"
+__version__ = "9.0.5"
 __all__ = [
     # Main SDK instance
     "dominus",

dominus_sdk_python-9.0.5/dominus/contract/__init__.py

@@ -0,0 +1,10 @@
+"""Python SDK contract module (S-4.8): envelope + projection helpers."""
+from .envelope import python_envelope, python_raise_for_status
+from .projections import Projections, python_projections
+
+__all__ = [
+    "Projections",
+    "python_envelope",
+    "python_projections",
+    "python_raise_for_status",
+]

dominus_sdk_python-9.0.5/dominus/contract/envelope.py

@@ -0,0 +1,23 @@
+"""Surface-adapter view of the canonical error envelope.
+
+Wraps existing ``DominusError.to_dict()`` / ``raise_for_status`` — no
+wire-shape change. Existing call sites stay on those APIs directly.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from dominus.errors import DominusError, raise_for_status
+
+
+def python_envelope(error: DominusError) -> Dict[str, Any]:
+    return error.to_dict()
+
+
+def python_raise_for_status(
+    status_code: int,
+    message: str,
+    details: Optional[Dict[str, Any]] = None,
+    endpoint: Optional[str] = None,
+) -> None:
+    raise_for_status(status_code, message, details, endpoint)

dominus_sdk_python-9.0.5/dominus/contract/projections.py

@@ -0,0 +1,22 @@
+"""Typed passthrough builder for per-surface name projections (ADR-0009).
+
+This SDK has no projection catalog; the helper accepts a projections
+object and returns it unchanged.
+"""
+from __future__ import annotations
+
+from typing import TypedDict
+
+
+class Projections(TypedDict, total=False):
+    gateway_path: str
+    sdk_python: str
+    sdk_nodejs: str
+    error_code_prefix: str
+    log_event_name: str
+    timeline_event_type: str
+    deploy_class: str
+
+
+def python_projections(projections: Projections) -> Projections:
+    return projections

{dominus_sdk_python-9.0.4 → dominus_sdk_python-9.0.5}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 9.0.4
+Version: 9.0.5
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -48,7 +48,7 @@ cleanup audit is `docs/janitor/2026-08-04-sdk-python-cleanup-audit.md`.
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Transport compatibility for wrapped `{success,data}` responses and unwrapped Warden/control-plane success objects
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `9.0.4`
+- Current package version: `9.0.5`
 
 ## Install
 

{dominus_sdk_python-9.0.4 → dominus_sdk_python-9.0.5}/dominus_sdk_python.egg-info/SOURCES.txt

@@ -6,6 +6,9 @@ dominus/py.typed
 dominus/start.py
 dominus/config/__init__.py
 dominus/config/endpoints.py
+dominus/contract/__init__.py
+dominus/contract/envelope.py
+dominus/contract/projections.py
 dominus/helpers/__init__.py
 dominus/helpers/auth.py
 dominus/helpers/cache.py
@@ -52,6 +55,7 @@ dominus_sdk_python.egg-info/top_level.txt
 tests/test_auth.py
 tests/test_authority_public_vocabulary.py
 tests/test_browser_namespace.py
+tests/test_contract.py
 tests/test_control_plane_namespaces.py
 tests/test_error_recovery_action.py
 tests/test_errors.py

{dominus_sdk_python-9.0.4 → dominus_sdk_python-9.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominus-sdk-python"
-version = "9.0.4"
+version = "9.0.5"
 description = "Python SDK for the Dominus gateway-first platform"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

dominus_sdk_python-9.0.5/tests/test_contract.py

@@ -0,0 +1,70 @@
+from dominus.errors import DominusError, raise_for_status
+from dominus.contract import python_envelope, python_projections, python_raise_for_status
+
+
+def test_python_envelope_wraps_to_dict_without_changing_wire_shape():
+    error = DominusError(
+        "Missing resource",
+        status_code=404,
+        details={
+            "code": "authority.resource.not_found",
+            "kind": "not_found",
+            "request_id": "req-python-contract-1",
+            "correlation_id": "corr-python-contract-1",
+        },
+        endpoint="/svc/authority/runs/status",
+    )
+
+    from_class = error.to_dict()
+    from_contract = python_envelope(error)
+
+    assert from_contract == from_class
+    assert from_contract["kind"] == "not_found"
+    assert from_contract["code"] == "authority.resource.not_found"
+    assert from_contract["request_id"] == "req-python-contract-1"
+    assert from_contract["http_status"] == 404
+    assert from_contract["envelope_version"] == "1"
+
+
+def test_python_raise_for_status_wraps_existing_raise_for_status():
+    try:
+        python_raise_for_status(
+            401,
+            "bad token",
+            {"kind": "unauthorized", "code": "kernel.auth.token_invalid"},
+        )
+    except DominusError as error:
+        assert error.kind == "unauthorized"
+        assert python_envelope(error) == error.to_dict()
+    else:
+        raise AssertionError("python_raise_for_status should raise DominusError")
+
+
+def test_python_raise_for_status_matches_raise_for_status_class():
+    raised = None
+    wrapped = None
+    try:
+        raise_for_status(404, "gone")
+    except DominusError as error:
+        raised = type(error)
+    try:
+        python_raise_for_status(404, "gone")
+    except DominusError as error:
+        wrapped = type(error)
+    assert raised is not None and raised is wrapped
+
+
+def test_python_projections_is_typed_passthrough_builder():
+    incoming = {
+        "gateway_path": "/svc/authority/runs/ensure",
+        "sdk_python": "dominus.workflow.ensure",
+        "sdk_nodejs": "dominus.workflow.ensure",
+        "error_code_prefix": "authority.",
+        "log_event_name": "authority.run.ensure",
+        "timeline_event_type": "authority.run.ensured",
+        "deploy_class": "worker_ga",
+    }
+
+    out = python_projections(incoming)
+    assert out is incoming
+    assert out == incoming