dominus-sdk-python 6.1.0__tar.gz → 6.1.1__tar.gz

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 6.1.0
+Version: 6.1.1
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -42,7 +42,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - 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: `6.0.0`
+- Current package version: `6.1.1`
 
 ## Install
 
@@ -94,6 +94,20 @@ machine_logs = await dominus.logs.tail(
     since="2026-04-11T08:33:00Z",
     level="error",
 )
+policy = await dominus.platform.ensure_policy_decision(
+    {
+        "group": "dominus",
+        "repository": "carebridgesystems/dominus-platform-worker",
+    },
+    actor_context={"type": "user", "id": "operator-1"},
+)
+coder_run = await dominus.coder.ensure_run(
+    policy_decision_id=policy["data"]["policy_decision"]["decision_id"],
+    workflow_recipe_ref="recipe://workflow-recipe-v1/coder-feature@head",
+    repository="carebridgesystems/dominus-platform-worker",
+    instructions="Fix failing tests",
+    actor_context={"type": "user", "id": "operator-1"},
+)
 
 # Archive maintenance is explicit and dry-run first.
 verify = await dominus.authority.verify_timeline_archive_manifests(
@@ -206,6 +220,8 @@ JWT and selected scope headers directly through Gateway.
 | `browser` | Browser Worker | Browser run health, ensure/start/status/result/retry/nudge/cancel/timeline/dossier |
 | `deployer` | Deployer | Thin operator control-plane request surface |
 | `warden` | Warden | Thin operator control-plane request surface |
+| `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
+| `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/README.md

@@ -9,7 +9,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - 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: `6.0.0`
+- Current package version: `6.1.1`
 
 ## Install
 
@@ -61,6 +61,20 @@ machine_logs = await dominus.logs.tail(
     since="2026-04-11T08:33:00Z",
     level="error",
 )
+policy = await dominus.platform.ensure_policy_decision(
+    {
+        "group": "dominus",
+        "repository": "carebridgesystems/dominus-platform-worker",
+    },
+    actor_context={"type": "user", "id": "operator-1"},
+)
+coder_run = await dominus.coder.ensure_run(
+    policy_decision_id=policy["data"]["policy_decision"]["decision_id"],
+    workflow_recipe_ref="recipe://workflow-recipe-v1/coder-feature@head",
+    repository="carebridgesystems/dominus-platform-worker",
+    instructions="Fix failing tests",
+    actor_context={"type": "user", "id": "operator-1"},
+)
 
 # Archive maintenance is explicit and dry-run first.
 verify = await dominus.authority.verify_timeline_archive_manifests(
@@ -173,6 +187,8 @@ JWT and selected scope headers directly through Gateway.
 | `browser` | Browser Worker | Browser run health, ensure/start/status/result/retry/nudge/cancel/timeline/dossier |
 | `deployer` | Deployer | Thin operator control-plane request surface |
 | `warden` | Warden | Thin operator control-plane request surface |
+| `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
+| `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/dominus/__init__.py

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

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/dominus/namespaces/coder.py

@@ -54,6 +54,26 @@ def _mutation_body(
     )
 
 
+def _actor_headers(actor_context: Optional[Dict[str, str]]) -> Optional[Dict[str, str]]:
+    if not actor_context:
+        return None
+    actor_type = str(actor_context.get("type") or actor_context.get("actor_type") or "").strip()
+    actor_id = str(actor_context.get("id") or actor_context.get("actor_id") or "").strip()
+    if not actor_type or not actor_id:
+        return None
+    return {"X-Actor-Type": actor_type, "X-Actor-Id": actor_id}
+
+
+def _assert_one_launch_source(workflow_recipe_ref: Optional[str], pipeline_recipe_ref: Optional[str]) -> None:
+    present = [
+        ref
+        for ref in (workflow_recipe_ref, pipeline_recipe_ref)
+        if isinstance(ref, str) and ref.strip()
+    ]
+    if len(present) != 1:
+        raise ValueError("ensure_run requires exactly one of workflow_recipe_ref or pipeline_recipe_ref")
+
+
 class CoderNamespace:
     """Coder run lifecycle helpers."""
 
@@ -101,9 +121,11 @@ class CoderNamespace:
         instructions: Optional[str] = None,
         inputs: Optional[Dict[str, Any]] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        actor_context: Optional[Dict[str, str]] = None,
     ) -> Dict[str, Any]:
         if not policy_decision_id or policy_decision_id.strip() == "":
             raise ValueError("ensure_run requires policy_decision_id")
+        _assert_one_launch_source(workflow_recipe_ref, pipeline_recipe_ref)
 
         body = _compact(
             {
@@ -128,6 +150,7 @@ class CoderNamespace:
             "/runs/ensure",
             method="POST",
             body=body,
+            headers=_actor_headers(actor_context),
             timeout=600.0,
         )
 
@@ -139,6 +162,7 @@ class CoderNamespace:
         repository: Optional[str] = None,
         limit: Optional[int] = None,
         offset: Optional[int] = None,
+        actor_context: Optional[Dict[str, str]] = None,
     ) -> Dict[str, Any]:
         qs = _query_string(
             {
@@ -149,10 +173,19 @@ class CoderNamespace:
                 "offset": offset,
             }
         )
-        return await self.request(f"/runs{qs}", method="GET")
+        return await self.request(f"/runs{qs}", method="GET", headers=_actor_headers(actor_context))
 
-    async def get_run(self, run_id: str) -> Dict[str, Any]:
-        return await self.request(f"/runs/{quote(run_id, safe='')}", method="GET")
+    async def get_run(
+        self,
+        run_id: str,
+        *,
+        actor_context: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
+        return await self.request(
+            f"/runs/{quote(run_id, safe='')}",
+            method="GET",
+            headers=_actor_headers(actor_context),
+        )
 
     async def cancel_run(
         self,
@@ -161,6 +194,7 @@ class CoderNamespace:
         reason: Optional[str] = None,
         idempotency_key: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        actor_context: Optional[Dict[str, str]] = None,
     ) -> Dict[str, Any]:
         return await self.request(
             f"/runs/{quote(run_id, safe='')}/cancel",
@@ -170,6 +204,7 @@ class CoderNamespace:
                 idempotency_key=idempotency_key,
                 metadata=metadata,
             ),
+            headers=_actor_headers(actor_context),
         )
 
     async def retry_run(
@@ -179,6 +214,7 @@ class CoderNamespace:
         reason: Optional[str] = None,
         idempotency_key: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        actor_context: Optional[Dict[str, str]] = None,
     ) -> Dict[str, Any]:
         return await self.request(
             f"/runs/{quote(run_id, safe='')}/retry",
@@ -188,6 +224,7 @@ class CoderNamespace:
                 idempotency_key=idempotency_key,
                 metadata=metadata,
             ),
+            headers=_actor_headers(actor_context),
         )
 
     async def nudge_run(
@@ -197,6 +234,7 @@ class CoderNamespace:
         reason: Optional[str] = None,
         idempotency_key: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        actor_context: Optional[Dict[str, str]] = None,
     ) -> Dict[str, Any]:
         return await self.request(
             f"/runs/{quote(run_id, safe='')}/nudge",
@@ -206,16 +244,29 @@ class CoderNamespace:
                 idempotency_key=idempotency_key,
                 metadata=metadata,
             ),
+            headers=_actor_headers(actor_context),
         )
 
-    async def get_run_summary(self, run_id: str) -> Dict[str, Any]:
+    async def get_run_summary(
+        self,
+        run_id: str,
+        *,
+        actor_context: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
         return await self.request(
             f"/runs/{quote(run_id, safe='')}/summary",
             method="GET",
+            headers=_actor_headers(actor_context),
         )
 
-    async def get_run_artifacts(self, run_id: str) -> Dict[str, Any]:
+    async def get_run_artifacts(
+        self,
+        run_id: str,
+        *,
+        actor_context: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
         return await self.request(
             f"/runs/{quote(run_id, safe='')}/artifacts",
             method="GET",
+            headers=_actor_headers(actor_context),
         )

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/dominus/namespaces/platform.py

@@ -23,6 +23,16 @@ def _normalize_platform_path(path: str) -> str:
     return f"/svc/platform{normalized}"
 
 
+def _actor_headers(actor_context: Optional[Dict[str, str]]) -> Optional[Dict[str, str]]:
+    if not actor_context:
+        return None
+    actor_type = str(actor_context.get("type") or actor_context.get("actor_type") or "").strip()
+    actor_id = str(actor_context.get("id") or actor_context.get("actor_id") or "").strip()
+    if not actor_type or not actor_id:
+        return None
+    return {"X-Actor-Type": actor_type, "X-Actor-Id": actor_id}
+
+
 class PlatformNamespace:
     """Platform group/repository policy helpers."""
 
@@ -105,26 +115,41 @@ class PlatformNamespace:
             body=repository,
         )
 
-    async def ensure_policy_decision(self, options: Dict[str, Any]) -> Dict[str, Any]:
+    async def ensure_policy_decision(
+        self,
+        options: Dict[str, Any],
+        *,
+        actor_context: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
         return await self.request(
             "/policy/decisions/ensure",
             method="POST",
             body=options,
+            headers=_actor_headers(actor_context),
         )
 
-    async def get_policy_decision(self, decision_id: str) -> Dict[str, Any]:
+    async def get_policy_decision(
+        self,
+        decision_id: str,
+        *,
+        actor_context: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
         return await self.request(
             f"/policy/decisions/{quote(decision_id, safe='')}",
             method="GET",
+            headers=_actor_headers(actor_context),
         )
 
     async def rehydrate_policy_decision(
         self,
         decision_id: str,
         options: Optional[Dict[str, Any]] = None,
+        *,
+        actor_context: Optional[Dict[str, str]] = None,
     ) -> Dict[str, Any]:
         return await self.request(
             f"/policy/decisions/{quote(decision_id, safe='')}/rehydrate",
             method="POST",
             body=options or {},
+            headers=_actor_headers(actor_context),
         )

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 6.1.0
+Version: 6.1.1
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -42,7 +42,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - 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: `6.0.0`
+- Current package version: `6.1.1`
 
 ## Install
 
@@ -94,6 +94,20 @@ machine_logs = await dominus.logs.tail(
     since="2026-04-11T08:33:00Z",
     level="error",
 )
+policy = await dominus.platform.ensure_policy_decision(
+    {
+        "group": "dominus",
+        "repository": "carebridgesystems/dominus-platform-worker",
+    },
+    actor_context={"type": "user", "id": "operator-1"},
+)
+coder_run = await dominus.coder.ensure_run(
+    policy_decision_id=policy["data"]["policy_decision"]["decision_id"],
+    workflow_recipe_ref="recipe://workflow-recipe-v1/coder-feature@head",
+    repository="carebridgesystems/dominus-platform-worker",
+    instructions="Fix failing tests",
+    actor_context={"type": "user", "id": "operator-1"},
+)
 
 # Archive maintenance is explicit and dry-run first.
 verify = await dominus.authority.verify_timeline_archive_manifests(
@@ -206,6 +220,8 @@ JWT and selected scope headers directly through Gateway.
 | `browser` | Browser Worker | Browser run health, ensure/start/status/result/retry/nudge/cancel/timeline/dossier |
 | `deployer` | Deployer | Thin operator control-plane request surface |
 | `warden` | Warden | Thin operator control-plane request surface |
+| `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
+| `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/pyproject.toml

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

{dominus_sdk_python-6.1.0 → dominus_sdk_python-6.1.1}/tests/test_platform_coder_namespaces.py

@@ -31,7 +31,8 @@ async def test_platform_namespace_normalizes_helpers_onto_service_routes():
             "group": "dominus",
             "repository": "carebridgesystems/dominus-platform-worker",
             "metadata": {"safe": "ok"},
-        }
+        },
+        actor_context={"type": "user", "id": "user-1"},
     )
     await platform.rehydrate_policy_decision("pd_123", {"run_id": "run_123"})
 
@@ -51,6 +52,7 @@ async def test_platform_namespace_normalizes_helpers_onto_service_routes():
         "repository": "carebridgesystems/dominus-platform-worker",
         "metadata": {"safe": "ok"},
     }
+    assert client.calls[5][1]["headers"] == {"X-Actor-Type": "user", "X-Actor-Id": "user-1"}
 
 
 @pytest.mark.asyncio
@@ -76,8 +78,10 @@ async def test_coder_namespace_exposes_lifecycle_helpers_but_no_raw_shell():
         policy_decision_id="pd_123",
         mode="async",
         task_recipe_ref="recipe://coder-task-recipe-v1/fix-tests@head",
+        workflow_recipe_ref="recipe://workflow-recipe-v1/coder-feature@head",
         repository="carebridgesystems/dominus-platform-worker",
         instructions="Fix failing tests",
+        actor_context={"type": "user", "id": "user-1"},
     )
     await coder.list_runs(status="running", limit=10)
     await coder.cancel_run("run_123", reason="operator requested")
@@ -99,9 +103,11 @@ async def test_coder_namespace_exposes_lifecycle_helpers_but_no_raw_shell():
         "policy_decision_id": "pd_123",
         "mode": "async",
         "task_recipe_ref": "recipe://coder-task-recipe-v1/fix-tests@head",
+        "workflow_recipe_ref": "recipe://workflow-recipe-v1/coder-feature@head",
         "repository": "carebridgesystems/dominus-platform-worker",
         "instructions": "Fix failing tests",
     }
+    assert client.calls[0][1]["headers"] == {"X-Actor-Type": "user", "X-Actor-Id": "user-1"}
     assert not hasattr(coder, "shell")
     assert not hasattr(coder, "exec")
     assert not hasattr(coder, "command")
@@ -116,3 +122,21 @@ async def test_coder_ensure_run_requires_policy_decision_id():
         await coder.ensure_run(policy_decision_id="")
 
     assert client.calls == []
+
+
+@pytest.mark.asyncio
+async def test_coder_ensure_run_requires_exactly_one_authority_launch_source():
+    client = MockGatewayClient()
+    coder = CoderNamespace(client)
+
+    with pytest.raises(ValueError, match="exactly one"):
+        await coder.ensure_run(policy_decision_id="pd_123")
+
+    with pytest.raises(ValueError, match="exactly one"):
+        await coder.ensure_run(
+            policy_decision_id="pd_123",
+            workflow_recipe_ref="recipe://workflow-recipe-v1/coder@head",
+            pipeline_recipe_ref="recipe://pipeline-recipe-v1/coder@head",
+        )
+
+    assert client.calls == []