dominus-sdk-python 5.0.0__tar.gz → 5.1.0__tar.gz

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 5.0.0
+Version: 5.1.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -43,7 +43,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: `4.0.8`
+- Current package version: `5.1.0`
 
 ## Install
 
@@ -71,6 +71,12 @@ run = await dominus.workflow.ensure(
     company="summit-radiology",
 )
 
+recipe_run = await dominus.workflow.ensure(
+    workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@v3",
+    subject="PCM47474562",
+    company="summit-radiology",
+)
+
 timeline = await dominus.authority.get_run_timeline(
     run["run_id"],
     since="2026-04-11T08:33:00Z",

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/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: `4.0.8`
+- Current package version: `5.1.0`
 
 ## Install
 
@@ -37,6 +37,12 @@ run = await dominus.workflow.ensure(
     company="summit-radiology",
 )
 
+recipe_run = await dominus.workflow.ensure(
+    workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@v3",
+    subject="PCM47474562",
+    company="summit-radiology",
+)
+
 timeline = await dominus.authority.get_run_timeline(
     run["run_id"],
     since="2026-04-11T08:33:00Z",

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/dominus/__init__.py

@@ -90,14 +90,12 @@ from .namespaces.health import HealthNamespace
 # Export new namespaces (Node.js SDK parity)
 from .namespaces.artifacts import (
     ARTIFACT_REF_PREFIX,
-    DISPLAY_REF_PREFIX,
     ARTIFACT_ENVIRONMENTS,
     ArtifactsNamespace,
     build_artifact_ref,
     build_v2_artifact_ref,
     build_pinned_artifact_ref,
     build_legacy_artifact_ref,
-    build_display_artifact_ref,
     parse_artifact_ref,
     try_parse_artifact_ref,
     validate_artifact_address,
@@ -105,7 +103,6 @@ from .namespaces.artifacts import (
     is_pinned_artifact_ref,
     is_head_artifact_ref,
     is_legacy_artifact_ref,
-    is_display_artifact_ref,
 )
 from .namespaces.jobs import JobsNamespace
 from .namespaces.processor import ProcessorNamespace
@@ -165,7 +162,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "4.6.2"
+__version__ = "5.1.0"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -195,14 +192,12 @@ __all__ = [
     "HealthNamespace",
     # New namespaces (Node.js SDK parity)
     "ARTIFACT_REF_PREFIX",
-    "DISPLAY_REF_PREFIX",
     "ARTIFACT_ENVIRONMENTS",
     "ArtifactsNamespace",
     "build_artifact_ref",
     "build_v2_artifact_ref",
     "build_pinned_artifact_ref",
     "build_legacy_artifact_ref",
-    "build_display_artifact_ref",
     "parse_artifact_ref",
     "try_parse_artifact_ref",
     "validate_artifact_address",
@@ -210,7 +205,6 @@ __all__ = [
     "is_pinned_artifact_ref",
     "is_head_artifact_ref",
     "is_legacy_artifact_ref",
-    "is_display_artifact_ref",
     "JobsNamespace",
     "ProcessorNamespace",
     "SyncNamespace",

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/dominus/namespaces/artifacts.py

@@ -35,10 +35,13 @@ def _safe_string(value: Any) -> str:
 
 
 ARTIFACT_REF_PREFIX = "ar://"
-DISPLAY_REF_PREFIX = "art:r:"
 ARTIFACT_ENVIRONMENTS = ("development", "staging", "production")
 
 
+def _legacy_project_head_ref(project_id: str, environment: str, key: str) -> str:
+    return f"{ARTIFACT_REF_PREFIX}dominus/project:{project_id}/{environment}/legacy/{quote(key, safe='')}"
+
+
 def build_artifact_ref(
     *,
     project_slug: Optional[str] = None,
@@ -109,13 +112,6 @@ def build_pinned_artifact_ref(
     return f"{ref}@v{version}"
 
 
-def build_display_artifact_ref(artifact_key: str) -> Optional[str]:
-    normalized_key = _safe_string(artifact_key)
-    if not normalized_key:
-        return None
-    return f"{DISPLAY_REF_PREFIX}{normalized_key}"
-
-
 def build_legacy_artifact_ref(
     *,
     project_slug: str,
@@ -146,15 +142,6 @@ def parse_artifact_ref(artifact_ref: str) -> Optional[Dict[str, Any]]:
     normalized = _safe_string(artifact_ref)
     if not normalized:
         return None
-    if normalized.startswith(DISPLAY_REF_PREFIX):
-        artifact_key = normalized[len(DISPLAY_REF_PREFIX):]
-        if not artifact_key:
-            return None
-        return {
-            "format": "display",
-            "raw": normalized,
-            "artifact_key": artifact_key,
-        }
     if not normalized.startswith(ARTIFACT_REF_PREFIX):
         return None
 
@@ -245,10 +232,6 @@ def is_legacy_artifact_ref(artifact_ref: Dict[str, Any]) -> bool:
     return artifact_ref.get("format") == "v1"
 
 
-def is_display_artifact_ref(artifact_ref: Dict[str, Any]) -> bool:
-    return artifact_ref.get("format") == "display"
-
-
 def _split_version_suffix(value: str) -> tuple[str, Optional[str]]:
     if "@" not in value:
         return value, None
@@ -366,10 +349,10 @@ class ArtifactsNamespace:
             category=category,
             content_type=content_type,
         )
-        disp = build_display_artifact_ref(use_key)
+        fallback_ref = _legacy_project_head_ref(project_id, environment, use_key)
         return {
             "key": use_key,
-            "ref": v2.get("compatibility_ref") or v2.get("head_ref") or disp,
+            "ref": v2.get("head_ref") or fallback_ref,
             "storage_type": v2.get("storage_type") or "redis",
             "size_bytes": v2.get("size_bytes", 0),
             "expires_at": v2.get("expires_at") or "",
@@ -377,14 +360,14 @@ class ArtifactsNamespace:
 
     async def retrieve(self, key: str) -> Dict[str, Any]:
         """
-        Retrieve by key via V2 display ref + target_project_id (compat with legacy data).
+        Retrieve by key via the addressed V2 compatibility head.
         """
-        project_id, _environment = await self._legacy_project_context()
+        project_id, environment = await self._legacy_project_context()
+        ref = _legacy_project_head_ref(project_id, environment, key)
         return await self._api(
             "/api/artifact/v2/retrieve",
             body={
-                "ref": f"{DISPLAY_REF_PREFIX}{key}",
-                "target_project_id": project_id,
+                "ref": ref,
             },
         )
 

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/dominus/namespaces/workflow.py

@@ -104,6 +104,14 @@ class WorkflowNamespace:
             return {"workflow_id": str(workflow_id).strip()}
         raise ValueError("workflow_id or workflow_ref is required")
 
+    @staticmethod
+    def _is_workflow_recipe_ref(value: Optional[str]) -> bool:
+        return str(value or "").strip().startswith("recipe://workflow-recipe-v1/")
+
+    @staticmethod
+    def _is_pipeline_recipe_ref(value: Optional[str]) -> bool:
+        return str(value or "").strip().startswith("recipe://pipeline-recipe-v1/")
+
     @staticmethod
     def _instance_base_endpoint(workflow_id: str) -> str:
         from urllib.parse import quote
@@ -210,9 +218,11 @@ class WorkflowNamespace:
 
     def _build_authority_ensure_body(
         self,
-        workflow_id: str,
+        workflow_id: Optional[str] = None,
         *,
         workflow_ref: Optional[str] = None,
+        workflow_recipe_ref: Optional[str] = None,
+        pipeline_recipe_ref: Optional[str] = None,
         subject: Optional[str] = None,
         company: Optional[str] = None,
         inputs: Optional[Dict[str, Any]] = None,
@@ -227,12 +237,30 @@ class WorkflowNamespace:
         idempotency_key: Optional[str] = None,
     ) -> Dict[str, Any]:
         body: Dict[str, Any] = {"mode": mode}
-        if workflow_ref:
-            body["workflow_ref"] = workflow_ref
-        elif self._is_workflow_ref(workflow_id):
-            body["workflow_ref"] = workflow_id
-        else:
-            body["workflow_id"] = workflow_id
+        launch_sources: List[tuple[str, str]] = []
+        normalized_workflow_id = str(workflow_id or "").strip()
+        if workflow_ref and str(workflow_ref).strip():
+            launch_sources.append(("workflow_ref", str(workflow_ref).strip()))
+        if workflow_recipe_ref and str(workflow_recipe_ref).strip():
+            launch_sources.append(("workflow_recipe_ref", str(workflow_recipe_ref).strip()))
+        if pipeline_recipe_ref and str(pipeline_recipe_ref).strip():
+            launch_sources.append(("pipeline_recipe_ref", str(pipeline_recipe_ref).strip()))
+        if normalized_workflow_id:
+            if self._is_workflow_ref(normalized_workflow_id):
+                launch_sources.append(("workflow_ref", normalized_workflow_id))
+            elif self._is_workflow_recipe_ref(normalized_workflow_id):
+                launch_sources.append(("workflow_recipe_ref", normalized_workflow_id))
+            elif self._is_pipeline_recipe_ref(normalized_workflow_id):
+                launch_sources.append(("pipeline_recipe_ref", normalized_workflow_id))
+            else:
+                launch_sources.append(("workflow_id", normalized_workflow_id))
+        if len(launch_sources) != 1:
+            raise ValueError(
+                "ensure requires exactly one of workflow_id, workflow_ref, "
+                "workflow_recipe_ref, or pipeline_recipe_ref"
+            )
+        field, value = launch_sources[0]
+        body[field] = value
         if subject is not None:
             body["subject"] = subject
         if company is not None:
@@ -855,7 +883,7 @@ class WorkflowNamespace:
 
     async def ensure(
         self,
-        workflow_id: str,
+        workflow_id: Optional[str] = None,
         *,
         instance_id: Optional[str] = None,
         group: Optional[str] = None,
@@ -866,6 +894,8 @@ class WorkflowNamespace:
         mode: str = "blocking",
         context: Optional[Dict[str, Any]] = None,
         workflow_ref: Optional[str] = None,
+        workflow_recipe_ref: Optional[str] = None,
+        pipeline_recipe_ref: Optional[str] = None,
         subject: Optional[str] = None,
         company: Optional[str] = None,
         inputs: Optional[Dict[str, Any]] = None,
@@ -886,6 +916,8 @@ class WorkflowNamespace:
             body=self._build_authority_ensure_body(
                 workflow_id,
                 workflow_ref=workflow_ref,
+                workflow_recipe_ref=workflow_recipe_ref,
+                pipeline_recipe_ref=pipeline_recipe_ref,
                 subject=subject,
                 company=company,
                 inputs=inputs,

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 5.0.0
+Version: 5.1.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -43,7 +43,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: `4.0.8`
+- Current package version: `5.1.0`
 
 ## Install
 
@@ -71,6 +71,12 @@ run = await dominus.workflow.ensure(
     company="summit-radiology",
 )
 
+recipe_run = await dominus.workflow.ensure(
+    workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@v3",
+    subject="PCM47474562",
+    company="summit-radiology",
+)
+
 timeline = await dominus.authority.get_run_timeline(
     run["run_id"],
     since="2026-04-11T08:33:00Z",

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/pyproject.toml

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

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/tests/test_workflow_lifecycle.py

@@ -274,6 +274,23 @@ async def test_workflow_ensure_supports_authority_one_call_lifecycle():
     assert isinstance(body["idempotency_key"], str) and body["idempotency_key"]
 
 
+@pytest.mark.asyncio
+async def test_workflow_ensure_can_infer_recipe_ref_from_first_argument():
+    client = FakeClient()
+    namespace = WorkflowNamespace(client)
+
+    await namespace.ensure(
+        "recipe://workflow-recipe-v1/report-cycle@v3",
+        company="summit-radiology",
+        mode="async",
+    )
+
+    body = client.calls[0]["body"]
+    assert body["workflow_recipe_ref"] == "recipe://workflow-recipe-v1/report-cycle@v3"
+    assert body["company"] == "summit-radiology"
+    assert "workflow_id" not in body
+
+
 @pytest.mark.asyncio
 async def test_workflow_get_detects_authority_run_ids():
     client = FakeClient()

{dominus_sdk_python-5.0.0 → dominus_sdk_python-5.1.0}/tests/test_workflow_refs.py

@@ -76,6 +76,47 @@ async def test_workflow_ensure_accepts_workflow_ref():
     assert body["context"] == {"report_ref": {"report_id": "r-1"}}
 
 
+@pytest.mark.asyncio
+async def test_workflow_ensure_accepts_recipe_refs():
+    client = FakeClient()
+    namespace = WorkflowNamespace(client)
+
+    await namespace.ensure(
+        workflow_recipe_ref="recipe://workflow-recipe-v1/patient-intake@v4",
+        subject="sub-1",
+        company="co-1",
+        mode="async",
+    )
+    await namespace.ensure(
+        pipeline_recipe_ref="recipe://pipeline-recipe-v1/intake-pipeline@v2",
+        context={"report_ref": {"report_id": "r-1"}},
+        mode="async",
+    )
+
+    first = client.calls[0]["body"]
+    assert first["workflow_recipe_ref"] == "recipe://workflow-recipe-v1/patient-intake@v4"
+    assert first["subject"] == "sub-1"
+    assert "workflow_id" not in first
+    second = client.calls[1]["body"]
+    assert second["pipeline_recipe_ref"] == "recipe://pipeline-recipe-v1/intake-pipeline@v2"
+    assert second["context"] == {"report_ref": {"report_id": "r-1"}}
+    assert "workflow_ref" not in second
+
+
+@pytest.mark.asyncio
+async def test_workflow_ensure_rejects_mixed_legacy_and_recipe_refs():
+    client = FakeClient()
+    namespace = WorkflowNamespace(client)
+
+    with pytest.raises(ValueError, match="exactly one"):
+        await namespace.ensure(
+            "wf-123",
+            workflow_recipe_ref="recipe://workflow-recipe-v1/patient-intake@v4",
+        )
+
+    assert client.calls == []
+
+
 @pytest.mark.asyncio
 async def test_workflow_save_forwards_builder_metadata():
     client = FakeClient()
@@ -125,7 +166,7 @@ def test_artifact_ref_helpers_round_trip():
     }
 
 
-def test_artifact_ref_helpers_support_v2_and_display_refs():
+def test_artifact_ref_helpers_support_v2_refs():
     v2_ref = build_artifact_ref(
         group="carebridge",
         owner="carebridge-summit",