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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 5.0.0
+Version: 6.0.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: `6.0.0`
 
 ## Install
 
@@ -66,7 +66,7 @@ users = await dominus.db.query("users", filters={"status": "active"})
 await dominus.redis.set("session:123", {"user": "john"}, ttl=3600)
 
 run = await dominus.workflow.ensure(
-    "wf://carebridge/report-cycle",
+    workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@v3",
     subject="PCM47474562",
     company="summit-radiology",
 )
@@ -193,7 +193,7 @@ JWT and selected scope headers directly through Gateway.
 | `health` | Gateway | Health and ping helpers |
 | `admin` | Admin Worker | Admin category reseed/reset |
 | `ai` | Agent Runtime | Agent, completion, RAG, artifacts, results, raw orchestration |
-| `workflow` | Workflow Manager + Authority | Saved workflow CRUD and canonical run lifecycle |
+| `workflow` | Workflow Manager + Authority | Saved workflow CRUD and recipe-backed run lifecycle |
 | `artifacts` | Artifact Worker | Addressed V2 artifacts, bookmarks, watches |
 | `jobs` | Job Worker | Enqueue, poll, dead-letter management |
 | `processor` | Processor | Batch and single-job processing |

{dominus_sdk_python-5.0.0 → dominus_sdk_python-6.0.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: `6.0.0`
 
 ## Install
 
@@ -32,7 +32,7 @@ users = await dominus.db.query("users", filters={"status": "active"})
 await dominus.redis.set("session:123", {"user": "john"}, ttl=3600)
 
 run = await dominus.workflow.ensure(
-    "wf://carebridge/report-cycle",
+    workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@v3",
     subject="PCM47474562",
     company="summit-radiology",
 )
@@ -159,7 +159,7 @@ JWT and selected scope headers directly through Gateway.
 | `health` | Gateway | Health and ping helpers |
 | `admin` | Admin Worker | Admin category reseed/reset |
 | `ai` | Agent Runtime | Agent, completion, RAG, artifacts, results, raw orchestration |
-| `workflow` | Workflow Manager + Authority | Saved workflow CRUD and canonical run lifecycle |
+| `workflow` | Workflow Manager + Authority | Saved workflow CRUD and recipe-backed run lifecycle |
 | `artifacts` | Artifact Worker | Addressed V2 artifacts, bookmarks, watches |
 | `jobs` | Job Worker | Enqueue, poll, dead-letter management |
 | `processor` | Processor | Batch and single-job processing |

{dominus_sdk_python-5.0.0 → dominus_sdk_python-6.0.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__ = "6.0.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-6.0.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-6.0.0}/dominus/namespaces/authority.py

@@ -12,9 +12,9 @@ All methods route through the gateway (``use_gateway=True``) which maps
 
 Run launch is also exposed as ``dominus.workflow.ensure(...)``. Both call
 ``/api/authority/runs/ensure``. Use ``dominus.workflow.ensure`` for the
-canonical "launch a saved workflow" path; use ``dominus.authority.ensure_run``
-when you want to think in Authority terms (run lifecycle, run dossiers,
-retries, cancels).
+canonical recipe-backed launch path; use ``dominus.authority.ensure_run`` when
+you want to think in Authority terms (run lifecycle, run dossiers, retries,
+cancels).
 """
 from __future__ import annotations
 
@@ -48,6 +48,14 @@ def _is_provisioning_bootstrap_run_kind(run_kind: Optional[str]) -> bool:
     return _normalize_run_kind_token(run_kind) == "provisioning_bootstrap"
 
 
+def _is_workflow_recipe_ref(value: Optional[str]) -> bool:
+    return str(value or "").strip().startswith("recipe://workflow-recipe-v1/")
+
+
+def _is_pipeline_recipe_ref(value: Optional[str]) -> bool:
+    return str(value or "").strip().startswith("recipe://pipeline-recipe-v1/")
+
+
 def _query_string(params: Mapping[str, Any]) -> str:
     cleaned = {k: v for k, v in params.items() if v is not None and v != ""}
     if not cleaned:
@@ -61,7 +69,10 @@ class AuthorityNamespace:
 
     Usage::
 
-        await dominus.authority.ensure_run(workflow_id="...", subject="PCM47474562")
+        await dominus.authority.ensure_run(
+            workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@head",
+            subject="PCM47474562",
+        )
         await dominus.authority.list_provisioning_targets()
         await dominus.authority.get_run_dossier(run_id)
     """
@@ -167,8 +178,8 @@ class AuthorityNamespace:
     async def ensure_run(
         self,
         *,
-        workflow_id: Optional[str] = None,
-        workflow_ref: Optional[str] = None,
+        workflow_recipe_ref: Optional[str] = None,
+        pipeline_recipe_ref: Optional[str] = None,
         run_kind: Optional[str] = None,
         bootstrap_profile_ref: Optional[str] = None,
         provisioning_target_slug: Optional[str] = None,
@@ -213,11 +224,23 @@ class AuthorityNamespace:
         ``bootstrap_provisioning_target`` (``execution_mode``, ``region``, ``bootstrap_profile_ref``, ...).
         """
         bootstrap = _is_provisioning_bootstrap_run_kind(run_kind)
-        if not bootstrap and not workflow_id and not workflow_ref:
+        recipe_sources = [
+            value
+            for value in (
+                str(workflow_recipe_ref or "").strip(),
+                str(pipeline_recipe_ref or "").strip(),
+            )
+            if value
+        ]
+        if not bootstrap and len(recipe_sources) != 1:
             raise ValueError(
-                "ensure_run requires workflow_id or workflow_ref unless run_kind is "
+                "ensure_run requires exactly one of workflow_recipe_ref or pipeline_recipe_ref unless run_kind is "
                 "provisioning.bootstrap"
             )
+        if workflow_recipe_ref and not _is_workflow_recipe_ref(workflow_recipe_ref):
+            raise ValueError("workflow_recipe_ref must start with recipe://workflow-recipe-v1/")
+        if pipeline_recipe_ref and not _is_pipeline_recipe_ref(pipeline_recipe_ref):
+            raise ValueError("pipeline_recipe_ref must start with recipe://pipeline-recipe-v1/")
         if bootstrap:
             target_slug = (provisioning_target_slug or "").strip()
             if not target_slug:
@@ -236,8 +259,6 @@ class AuthorityNamespace:
                 "run_kind": run_kind,
                 "bootstrap_profile_ref": bootstrap_profile_ref,
                 "provisioning_target_slug": provisioning_target_slug,
-                "workflow_id": workflow_id,
-                "workflow_ref": workflow_ref,
                 "instance_id": instance_id,
                 "instance_key": instance_key,
                 "group": group,
@@ -262,8 +283,8 @@ class AuthorityNamespace:
             })
         else:
             body = _compact({
-                "workflow_id": workflow_id,
-                "workflow_ref": workflow_ref,
+                "workflow_recipe_ref": workflow_recipe_ref,
+                "pipeline_recipe_ref": pipeline_recipe_ref,
                 "instance_id": instance_id,
                 "instance_key": instance_key,
                 "group": group,

{dominus_sdk_python-5.0.0 → dominus_sdk_python-6.0.0}/dominus/namespaces/recipes.py

@@ -41,14 +41,24 @@ class RecipesNamespace:
     def __init__(self, client: "Dominus"):
         self._client = client
 
-    async def _post(self, endpoint: str, body: Optional[Dict[str, Any]] = None, *, timeout: float = 30.0) -> Dict[str, Any]:
-        return await self._client._request(
-            endpoint=endpoint,
-            method="POST",
-            body=body or {},
-            use_gateway=True,
-            timeout=timeout,
-        )
+    async def _post(
+        self,
+        endpoint: str,
+        body: Optional[Dict[str, Any]] = None,
+        *,
+        timeout: float = 30.0,
+        actor_context: Optional[Dict[str, str]] = None,
+    ) -> Dict[str, Any]:
+        kwargs: Dict[str, Any] = {
+            "endpoint": endpoint,
+            "method": "POST",
+            "body": body or {},
+            "use_gateway": True,
+            "timeout": timeout,
+        }
+        if actor_context is not None:
+            kwargs["actor"] = actor_context
+        return await self._client._request(**kwargs)
 
     async def _get(self, endpoint: str, *, timeout: float = 30.0) -> Dict[str, Any]:
         return await self._client._request(
@@ -75,6 +85,7 @@ class RecipesNamespace:
         name: str,
         body: str,
         description: Optional[str] = None,
+        actor_context: Optional[Dict[str, str]] = None,
         timeout: float = 30.0,
     ) -> Dict[str, Any]:
         """Publish a recipe. ``POST /api/recipe/recipes/publish``."""
@@ -87,6 +98,7 @@ class RecipesNamespace:
                 "body": body,
                 "description": description,
             }),
+            actor_context=actor_context,
             timeout=timeout,
         )
 
@@ -112,6 +124,7 @@ class RecipesNamespace:
         name: str,
         version: int,
         reason: Optional[str] = None,
+        actor_context: Optional[Dict[str, str]] = None,
         timeout: float = 30.0,
     ) -> Dict[str, Any]:
         """Mark the current head recipe version deprecated. ``POST /api/recipe/recipes/deprecate``."""
@@ -124,6 +137,7 @@ class RecipesNamespace:
                 "version": version,
                 "reason": reason,
             }),
+            actor_context=actor_context,
             timeout=timeout,
         )
 
@@ -170,6 +184,7 @@ class RecipesNamespace:
         owning_worker: str,
         schema_version: int,
         json_schema: Dict[str, Any],
+        actor_context: Optional[Dict[str, str]] = None,
         timeout: float = 15.0,
     ) -> Dict[str, Any]:
         """Register a recipe type. ``POST /api/recipe/types/register``.
@@ -184,5 +199,6 @@ class RecipesNamespace:
                 "schema_version": schema_version,
                 "json_schema": json_schema,
             },
+            actor_context=actor_context,
             timeout=timeout,
         )

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

@@ -33,9 +33,9 @@ Usage:
     tools = await dominus.workflow.list_tools(limit=50)
     await dominus.workflow.register_tool({"slug": "my-tool", "name": "My Tool", "tool_type": "http"})
 
-    # Canonical saved-workflow launch (Authority POST /api/authority/runs/ensure)
+    # Canonical recipe-backed launch (Authority POST /api/authority/runs/ensure)
     execution = await dominus.workflow.ensure(
-        "my-workflow-id",
+        workflow_recipe_ref="recipe://workflow-recipe-v1/my-workflow@head",
         subject="PCM47474562",
         company="acme",
         inputs={"key": "value"},
@@ -58,7 +58,7 @@ class WorkflowNamespace:
     Workflow management namespace.
 
     Provides operations for workflow CRUD, pipelines, templates,
-    and the saved-workflow run lifecycle via the dominus-workflow-manager service.
+    and the recipe-backed run lifecycle via Authority.
     """
 
     def __init__(self, client: "Dominus"):
@@ -92,17 +92,12 @@ class WorkflowNamespace:
         return endpoint
 
     @staticmethod
-    def _workflow_identifier_body(
-        workflow_id: Optional[str] = None,
-        workflow_ref: Optional[str] = None,
-    ) -> Dict[str, Any]:
-        if workflow_ref and str(workflow_ref).strip():
-            return {"workflow_ref": str(workflow_ref).strip()}
-        if WorkflowNamespace._is_workflow_ref(workflow_id):
-            return {"workflow_ref": str(workflow_id).strip()}
-        if workflow_id and str(workflow_id).strip():
-            return {"workflow_id": str(workflow_id).strip()}
-        raise ValueError("workflow_id or workflow_ref is required")
+    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:
@@ -210,11 +205,14 @@ class WorkflowNamespace:
 
     def _build_authority_ensure_body(
         self,
-        workflow_id: str,
+        recipe_ref: 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,
+        group: Optional[str] = None,
+        owner: Optional[str] = None,
         inputs: Optional[Dict[str, Any]] = None,
         context: Optional[Dict[str, Any]] = None,
         bindings: Optional[Dict[str, Any]] = None,
@@ -227,16 +225,37 @@ 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_recipe_ref = str(recipe_ref or "").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_recipe_ref:
+            if self._is_workflow_recipe_ref(normalized_recipe_ref):
+                launch_sources.append(("workflow_recipe_ref", normalized_recipe_ref))
+            elif self._is_pipeline_recipe_ref(normalized_recipe_ref):
+                launch_sources.append(("pipeline_recipe_ref", normalized_recipe_ref))
+            else:
+                raise ValueError(
+                    "recipe_ref must start with recipe://workflow-recipe-v1/ "
+                    "or recipe://pipeline-recipe-v1/"
+                )
+        if len(launch_sources) != 1:
+            raise ValueError(
+                "ensure requires exactly one of recipe_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:
             body["company"] = company
+        if group is not None:
+            body["group"] = group
+        if owner is not None:
+            body["owner"] = owner
         if inputs:
             body["inputs"] = inputs
         if context:
@@ -855,7 +874,7 @@ class WorkflowNamespace:
 
     async def ensure(
         self,
-        workflow_id: str,
+        recipe_ref: Optional[str] = None,
         *,
         instance_id: Optional[str] = None,
         group: Optional[str] = None,
@@ -865,7 +884,8 @@ class WorkflowNamespace:
         bindings: Optional[Dict[str, Any]] = None,
         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,
@@ -884,10 +904,13 @@ class WorkflowNamespace:
         return await self._api(
             endpoint="/api/authority/runs/ensure",
             body=self._build_authority_ensure_body(
-                workflow_id,
-                workflow_ref=workflow_ref,
+                recipe_ref,
+                workflow_recipe_ref=workflow_recipe_ref,
+                pipeline_recipe_ref=pipeline_recipe_ref,
                 subject=subject,
                 company=company,
+                group=group,
+                owner=owner,
                 inputs=inputs,
                 context=context,
                 bindings=bindings,

{dominus_sdk_python-5.0.0 → dominus_sdk_python-6.0.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: 6.0.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: `6.0.0`
 
 ## Install
 
@@ -66,7 +66,7 @@ users = await dominus.db.query("users", filters={"status": "active"})
 await dominus.redis.set("session:123", {"user": "john"}, ttl=3600)
 
 run = await dominus.workflow.ensure(
-    "wf://carebridge/report-cycle",
+    workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@v3",
     subject="PCM47474562",
     company="summit-radiology",
 )
@@ -193,7 +193,7 @@ JWT and selected scope headers directly through Gateway.
 | `health` | Gateway | Health and ping helpers |
 | `admin` | Admin Worker | Admin category reseed/reset |
 | `ai` | Agent Runtime | Agent, completion, RAG, artifacts, results, raw orchestration |
-| `workflow` | Workflow Manager + Authority | Saved workflow CRUD and canonical run lifecycle |
+| `workflow` | Workflow Manager + Authority | Saved workflow CRUD and recipe-backed run lifecycle |
 | `artifacts` | Artifact Worker | Addressed V2 artifacts, bookmarks, watches |
 | `jobs` | Job Worker | Enqueue, poll, dead-letter management |
 | `processor` | Processor | Batch and single-job processing |

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominus-sdk-python"
-version = "5.0.0"
+version = "6.0.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-6.0.0}/tests/test_authority_public_vocabulary.py

@@ -86,10 +86,29 @@ def test_authority_scope_signatures_use_new_public_vocabulary():
     schedule_create_sig = inspect.signature(AuthorityNamespace.create_schedule)
     mint_sig = inspect.signature(core_helpers.mint_selected_scope_jwt)
 
-    for name in ("app_slug", "env", "target_org_id", "target_env", "run_kind", "target_app_slug", "bootstrap_profile_ref", "provisioning_target_slug"):
+    for name in (
+        "app_slug",
+        "env",
+        "target_org_id",
+        "target_env",
+        "run_kind",
+        "target_app_slug",
+        "bootstrap_profile_ref",
+        "provisioning_target_slug",
+        "workflow_recipe_ref",
+        "pipeline_recipe_ref",
+    ):
         assert name in ensure_sig.parameters
     old_profile_key = "bootstrap" + "_profile"
-    for legacy in ("project_slug", "environment", "target_project_id", "target_environment", old_profile_key):
+    for legacy in (
+        "project_slug",
+        "environment",
+        "target_project_id",
+        "target_environment",
+        "workflow_id",
+        "workflow_ref",
+        old_profile_key,
+    ):
         assert legacy not in ensure_sig.parameters
 
     for name in ("shared_app_slug", "target_app_slug", "target_env", "bootstrap_profile_ref"):
@@ -135,7 +154,7 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
     namespace = AuthorityNamespace(client)
 
     await namespace.ensure_run(
-        workflow_id="wf-123",
+        workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@head",
         app_slug="carebridge",
         env="production",
         target_org_id="org-123",
@@ -255,7 +274,10 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
     assert ensure_body["env"] == "production"
     assert ensure_body["target_org_id"] == "org-123"
     assert ensure_body["target_env"] == "production"
+    assert ensure_body["workflow_recipe_ref"] == "recipe://workflow-recipe-v1/report-cycle@head"
     assert "bootstrap_profile_ref" not in ensure_body
+    assert "workflow_id" not in ensure_body
+    assert "workflow_ref" not in ensure_body
 
     bootstrap_body = client.calls[1]["body"]
     assert bootstrap_body["shared_app_slug"] == "shared-core"
@@ -478,6 +500,24 @@ async def test_authority_ensure_run_provisioning_bootstrap_omits_workflow_mode()
     assert "mode" not in body
 
 
+@pytest.mark.asyncio
+async def test_authority_ensure_run_requires_recipe_launch_ref():
+    client = FakeClient()
+    namespace = AuthorityNamespace(client)
+
+    with pytest.raises(ValueError, match="workflow_recipe_ref or pipeline_recipe_ref"):
+        await namespace.ensure_run(app_slug="carebridge", env="production")
+
+    with pytest.raises(ValueError, match="recipe://workflow-recipe-v1/"):
+        await namespace.ensure_run(
+            workflow_recipe_ref="wf://carebridge/report-cycle",
+            app_slug="carebridge",
+            env="production",
+        )
+
+    assert client.calls == []
+
+
 @pytest.mark.asyncio
 async def test_authority_ensure_run_bootstrap_requires_provisioning_target_slug():
     client = FakeClient()

{dominus_sdk_python-5.0.0 → dominus_sdk_python-6.0.0}/tests/test_recipes_namespace.py

@@ -47,3 +47,39 @@ async def test_recipes_namespace_maps_deprecate_to_gateway_route(monkeypatch, sd
             "timeout": 30.0,
         }
     ]
+
+
+@pytest.mark.asyncio
+async def test_recipes_namespace_passes_actor_context_on_publish(monkeypatch, sdk):
+    calls = []
+
+    async def fake_request(**kwargs):
+        calls.append(kwargs)
+        return {"ok": True, "recipe": {"version": 1}}
+
+    monkeypatch.setattr(sdk, "_request", fake_request)
+
+    actor = {"type": "user", "id": "user-1"}
+    await sdk.recipes.publish(
+        type="browser-recipe",
+        tier="project",
+        name="cms-login",
+        body="version: browser-recipe-v1\nsteps: []\n",
+        actor_context=actor,
+    )
+
+    assert calls == [
+        {
+            "endpoint": "/api/recipe/recipes/publish",
+            "method": "POST",
+            "body": {
+                "type": "browser-recipe",
+                "tier": "project",
+                "name": "cms-login",
+                "body": "version: browser-recipe-v1\nsteps: []\n",
+            },
+            "use_gateway": True,
+            "timeout": 30.0,
+            "actor": actor,
+        }
+    ]

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

@@ -255,7 +255,7 @@ async def test_workflow_ensure_supports_authority_one_call_lifecycle():
     namespace = WorkflowNamespace(client)
 
     await namespace.ensure(
-        "wf://carebridge/report-cycle",
+        workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@head",
         subject="PCM47474562",
         company="summit-radiology",
         inputs={"report_snapshot": "ar://artifact"},
@@ -265,7 +265,7 @@ async def test_workflow_ensure_supports_authority_one_call_lifecycle():
 
     assert client.calls[0]["endpoint"] == "/api/authority/runs/ensure"
     body = client.calls[0]["body"]
-    assert body["workflow_ref"] == "wf://carebridge/report-cycle"
+    assert body["workflow_recipe_ref"] == "recipe://workflow-recipe-v1/report-cycle@head"
     assert body["subject"] == "PCM47474562"
     assert body["company"] == "summit-radiology"
     assert body["inputs"] == {"report_snapshot": "ar://artifact"}
@@ -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()
@@ -416,24 +433,24 @@ async def test_saved_workflow_instance_ensure_contract_matches_workflow_manager(
 
 
 @pytest.mark.asyncio
-async def test_saved_workflow_ensure_is_authority_only_and_stream_guard():
+async def test_recipe_workflow_ensure_is_authority_only_and_stream_guard():
     client = FakeClient()
     namespace = WorkflowNamespace(client)
 
     await namespace.ensure(
-        "wf-instance",
+        workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@head",
         mode="ensure_only",
     )
 
     call = client.calls[0]
     assert call["endpoint"] == "/api/authority/runs/ensure"
-    assert call["body"]["workflow_id"] == "wf-instance"
+    assert call["body"]["workflow_recipe_ref"] == "recipe://workflow-recipe-v1/report-cycle@head"
     assert call["body"]["mode"] == "ensure_only"
     assert isinstance(call["body"]["idempotency_key"], str)
 
     with pytest.raises(ValueError, match="Authority-only and supports blocking, async, or ensure_only"):
         await namespace.ensure(
-            "wf-instance",
+            workflow_recipe_ref="recipe://workflow-recipe-v1/report-cycle@head",
             mode="streaming",
         )
 

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

@@ -56,24 +56,62 @@ async def test_workflow_get_accepts_workflow_ref():
 
 
 @pytest.mark.asyncio
-async def test_workflow_ensure_accepts_workflow_ref():
+async def test_workflow_ensure_rejects_legacy_workflow_ref():
+    client = FakeClient()
+    namespace = WorkflowNamespace(client)
+
+    with pytest.raises(ValueError, match="recipe_ref"):
+        await namespace.ensure(
+            "wf://carebridge-platform/production/shared/patient-intake",
+            subject="sub-1",
+            company="co-1",
+            instance_id="run-123",
+            context={"report_ref": {"report_id": "r-1"}},
+            mode="async",
+        )
+
+    assert client.calls == []
+
+
+@pytest.mark.asyncio
+async def test_workflow_ensure_accepts_recipe_refs():
     client = FakeClient()
     namespace = WorkflowNamespace(client)
 
     await namespace.ensure(
-        "wf://carebridge-platform/production/shared/patient-intake",
+        workflow_recipe_ref="recipe://workflow-recipe-v1/patient-intake@v4",
         subject="sub-1",
         company="co-1",
-        instance_id="run-123",
+        mode="async",
+    )
+    await namespace.ensure(
+        pipeline_recipe_ref="recipe://pipeline-recipe-v1/intake-pipeline@v2",
         context={"report_ref": {"report_id": "r-1"}},
         mode="async",
     )
 
-    assert client.calls[0]["endpoint"] == "/api/authority/runs/ensure"
-    body = client.calls[0]["body"]
-    assert body["workflow_ref"] == "wf://carebridge-platform/production/shared/patient-intake"
-    assert body["instance_id"] == "run-123"
-    assert body["context"] == {"report_ref": {"report_id": "r-1"}}
+    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_recipe_refs():
+    client = FakeClient()
+    namespace = WorkflowNamespace(client)
+
+    with pytest.raises(ValueError, match="exactly one"):
+        await namespace.ensure(
+            "recipe://pipeline-recipe-v1/intake-pipeline@v2",
+            workflow_recipe_ref="recipe://workflow-recipe-v1/patient-intake@v4",
+        )
+
+    assert client.calls == []
 
 
 @pytest.mark.asyncio
@@ -125,7 +163,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",