dominus-sdk-python 2.18.1__tar.gz → 3.0.1__tar.gz

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 2.18.1
+Version: 3.0.1
 Summary: Python SDK for the Dominus Orchestrator Platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -49,7 +49,7 @@ Async Python SDK for CareBridge Dominus platform services. Routes calls through
 - Server-side, asyncio-first Python SDK (3.9+)
 - Namespace API with root-level shortcuts for common operations
 - Targets production Cloudflare Workers (gateway, JWT, logs) and Cloud Run (orchestrator)
-- Version: 2.18.1
+- Version: 3.0.1
 
 ## Quick Start
 
@@ -97,13 +97,9 @@ execution = await dominus.workflow.ensure(
     inputs={"report_snapshot": "ar://carebridge/summit-radiology/production/snapshot/report-1"},
 )
 
-# Saved workflow lifecycle through workflow-manager when you need explicit artifacts
-run = await dominus.workflow.create_run(
-    workflow_id="wf_saved_123",
-    context={"report_ref": {"report_id": "r-1", "accession": "a-1", "session_number": "2"}},
-)
-await dominus.workflow.validate_run(run["run_id"])
-result = await dominus.workflow.start_run(run["run_id"])
+# Inspect the canonical run after ensure
+run_state = await dominus.workflow.get_run_state(execution["run_id"])
+timeline = await dominus.workflow.get_run_timeline(execution["run_id"])
 
 # Raw orchestration lifecycle with inline workflow definition
 raw_run = await dominus.ai.workflow.create_run(
@@ -195,9 +191,17 @@ dominus.release_console()     # stop capturing
 - [Development](docs/development.md) -- Setup, testing, adding APIs
 - [Workflow hard-cut release notes](docs/workflow-hard-cut-release.md) -- cutover notes and operational checks
 
+## Verification (local)
+
+```bash
+pip install -e .
+python -m pytest tests -q
+```
+
 ## Workflow Surfaces
 
-- `dominus.workflow.*` is the saved-workflow facade through `dominus-workflow-manager`. Use it for stored workflow IDs and the artifact-aware run lifecycle: `create_run -> register_artifact -> validate_run -> start_run`.
+- `dominus.workflow.ensure()` is the canonical saved-workflow launch path through Authority.
+- `dominus.workflow.ensure_instance()` / `stream_ensure_instance()` are lower-level instance controls, not the default launch surface.
 - `dominus.ai.workflow.*` is the raw orchestration surface. It requires inline `workflow_definition` data. It does not support saved-workflow IDs directly.
 - `dominus.workflow.execute_pipeline()` runs stored pipelines through workflow-manager's native orchestration-backed runner.
 - `dominus.artifacts.*` now supports addressed V2 artifact refs alongside legacy helpers. Prefer `store_v2()`, `head_v2()`, `compare_v2()`, bookmark helpers, and watcher helpers with canonical `ar://{group}/{owner}/{environment}/{kind}/{artifact_key}` refs for new code; `target_project_id` / `use_shared` remain compatibility-only targeting concepts.

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/README.md

@@ -7,7 +7,7 @@ Async Python SDK for CareBridge Dominus platform services. Routes calls through
 - Server-side, asyncio-first Python SDK (3.9+)
 - Namespace API with root-level shortcuts for common operations
 - Targets production Cloudflare Workers (gateway, JWT, logs) and Cloud Run (orchestrator)
-- Version: 2.18.1
+- Version: 3.0.1
 
 ## Quick Start
 
@@ -55,13 +55,9 @@ execution = await dominus.workflow.ensure(
     inputs={"report_snapshot": "ar://carebridge/summit-radiology/production/snapshot/report-1"},
 )
 
-# Saved workflow lifecycle through workflow-manager when you need explicit artifacts
-run = await dominus.workflow.create_run(
-    workflow_id="wf_saved_123",
-    context={"report_ref": {"report_id": "r-1", "accession": "a-1", "session_number": "2"}},
-)
-await dominus.workflow.validate_run(run["run_id"])
-result = await dominus.workflow.start_run(run["run_id"])
+# Inspect the canonical run after ensure
+run_state = await dominus.workflow.get_run_state(execution["run_id"])
+timeline = await dominus.workflow.get_run_timeline(execution["run_id"])
 
 # Raw orchestration lifecycle with inline workflow definition
 raw_run = await dominus.ai.workflow.create_run(
@@ -153,9 +149,17 @@ dominus.release_console()     # stop capturing
 - [Development](docs/development.md) -- Setup, testing, adding APIs
 - [Workflow hard-cut release notes](docs/workflow-hard-cut-release.md) -- cutover notes and operational checks
 
+## Verification (local)
+
+```bash
+pip install -e .
+python -m pytest tests -q
+```
+
 ## Workflow Surfaces
 
-- `dominus.workflow.*` is the saved-workflow facade through `dominus-workflow-manager`. Use it for stored workflow IDs and the artifact-aware run lifecycle: `create_run -> register_artifact -> validate_run -> start_run`.
+- `dominus.workflow.ensure()` is the canonical saved-workflow launch path through Authority.
+- `dominus.workflow.ensure_instance()` / `stream_ensure_instance()` are lower-level instance controls, not the default launch surface.
 - `dominus.ai.workflow.*` is the raw orchestration surface. It requires inline `workflow_definition` data. It does not support saved-workflow IDs directly.
 - `dominus.workflow.execute_pipeline()` runs stored pipelines through workflow-manager's native orchestration-backed runner.
 - `dominus.artifacts.*` now supports addressed V2 artifact refs alongside legacy helpers. Prefer `store_v2()`, `head_v2()`, `compare_v2()`, bookmark helpers, and watcher helpers with canonical `ar://{group}/{owner}/{environment}/{kind}/{artifact_key}` refs for new code; `target_project_id` / `use_shared` remain compatibility-only targeting concepts.

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/dominus/__init__.py

@@ -155,7 +155,6 @@ from .helpers.core import (
     verify_jwt_locally,
     is_jwt_valid,
     mint_selected_project_jwt,
-    delegate_jwt,
 )
 
 # Export trace utilities for distributed tracing
@@ -182,7 +181,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "2.18.1"
+__version__ = "3.0.1"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -253,7 +252,6 @@ __all__ = [
     "verify_jwt_locally",
     "is_jwt_valid",
     "mint_selected_project_jwt",
-    "delegate_jwt",
     # Trace utilities
     "generate_trace_id",
     "get_current_trace_id",

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/dominus/helpers/core.py

@@ -600,27 +600,6 @@ async def mint_selected_project_jwt(
         raise RuntimeError(f"Selected-project JWT mint failed: {e}") from e
 
 
-async def delegate_jwt(
-    psk_token: str,
-    target_project_id: str,
-    target_environment: str,
-    use_shared: bool = False
-) -> str:
-    """
-    Compatibility alias for :func:`mint_selected_project_jwt`.
-
-    .. deprecated::
-        Prefer :func:`mint_selected_project_jwt` for new code; "delegated" naming is
-        legacy terminology only.
-    """
-    return await mint_selected_project_jwt(
-        psk_token=psk_token,
-        target_project_id=target_project_id,
-        target_environment=target_environment,
-        use_shared=use_shared,
-    )
-
-
 def verify_token_format(token: str) -> bool:
     """
     Verify token format is valid (basic check, not server verification).

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/dominus/namespaces/ai.py

@@ -576,7 +576,7 @@ class WorkflowSubNamespace(GatewayMixin):
         if workflow_id:
             raise ValueError(
                 f"dominus.ai.workflow.{method_name}() does not support saved workflow IDs. "
-                "Pass workflow_definition for raw orchestration or use dominus.workflow.create_run() "
+                "Pass workflow_definition for raw orchestration or use dominus.workflow.ensure() "
                 "for saved-workflow execution."
             )
         raise ValueError(
@@ -624,7 +624,7 @@ class WorkflowSubNamespace(GatewayMixin):
 
         Args:
             workflow_definition: Inline orchestration workflow definition
-            workflow_id: Unsupported for raw orchestration; use dominus.workflow.create_run()
+            workflow_id: Unsupported for raw orchestration; use dominus.workflow.ensure()
             initial_artifacts: Initial artifact key -> artifact ID mapping
             input: Legacy alias for initial_artifacts
             conversation_id: Optional conversation ID for context

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/dominus/namespaces/workflow.py

@@ -63,7 +63,7 @@ class WorkflowNamespace:
     def _reject_legacy_runs_facade(self, method: str) -> None:
         raise RuntimeError(
             f"dominus.workflow.{method} was removed: /api/workflow/runs is retired. "
-            "Use ensure() with Authority fields (subject, company, inputs, context, ...) or ensure_instance()."
+            "Use ensure() through Authority."
         )
 
     @staticmethod
@@ -795,48 +795,29 @@ class WorkflowNamespace:
         idempotency_key: Optional[str] = None,
     ) -> Dict[str, Any]:
         """Ensure a workflow instance exists and optionally launch execution."""
-        if (
-            subject is not None
-            or company is not None
-            or inputs is not None
-            or workflow_ref is not None
-            or target_project_id is not None
-            or target_environment is not None
-            or initiator_type is not None
-            or initiator_id is not None
-            or idempotency_key is not None
-            or group is None
-            or owner is None
-        ):
-            return await self._api(
-                endpoint="/api/authority/runs/ensure",
-                body=self._build_authority_ensure_body(
-                    workflow_id,
-                    workflow_ref=workflow_ref,
-                    subject=subject,
-                    company=company,
-                    inputs=inputs,
-                    context=context,
-                    bindings=bindings,
-                    instance_id=instance_id,
-                    mode=mode,
-                    target_project_id=target_project_id,
-                    target_environment=target_environment,
-                    initiator_type=initiator_type,
-                    initiator_id=initiator_id,
-                    idempotency_key=idempotency_key,
-                ),
+        if mode == "streaming":
+            raise ValueError(
+                "dominus.workflow.ensure() is Authority-only and supports blocking, async, or ensure_only. "
+                "Use execution polling after launch instead of instance streaming on this surface."
             )
-        return await self.ensure_instance(
-            workflow_id,
-            instance_id=instance_id,
-            group=group,
-            owner=owner,
-            environment=environment,
-            nudge_policy=nudge_policy,
-            bindings=bindings,
-            mode=mode,
-            context=context,
+        return await self._api(
+            endpoint="/api/authority/runs/ensure",
+            body=self._build_authority_ensure_body(
+                workflow_id,
+                workflow_ref=workflow_ref,
+                subject=subject,
+                company=company,
+                inputs=inputs,
+                context=context,
+                bindings=bindings,
+                instance_id=instance_id,
+                mode=mode,
+                target_project_id=target_project_id,
+                target_environment=target_environment,
+                initiator_type=initiator_type,
+                initiator_id=initiator_id,
+                idempotency_key=idempotency_key,
+            ),
         )
 
     async def ensure_instance(
@@ -852,7 +833,13 @@ class WorkflowNamespace:
         mode: str = "blocking",
         context: Optional[Dict[str, Any]] = None,
     ) -> Dict[str, Any]:
-        """Ensure a workflow instance exists and optionally launch execution."""
+        """
+        Advanced instance-control surface for workflow-manager.
+
+        This is not the canonical public launch path. Prefer ensure() for
+        Authority-backed launch and use instance APIs only when you
+        intentionally need lower-level instance reuse or nudge/retry control.
+        """
         if mode == "streaming":
             raise ValueError("Use stream_ensure_instance() for streaming instance execution")
 
@@ -883,7 +870,12 @@ class WorkflowNamespace:
         context: Optional[Dict[str, Any]] = None,
         on_chunk: Optional[Any] = None,
     ):
-        """Ensure a workflow instance and stream execution events."""
+        """
+        Advanced instance-control SSE helper for workflow-manager.
+
+        This bypasses Authority launch and is retained only for explicit,
+        lower-level instance operations.
+        """
         async for chunk in self._client._stream_request(
             endpoint=f"{self._instance_base_endpoint(workflow_id)}/ensure",
             body=self._build_ensure_instance_body(

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 2.18.1
+Version: 3.0.1
 Summary: Python SDK for the Dominus Orchestrator Platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -49,7 +49,7 @@ Async Python SDK for CareBridge Dominus platform services. Routes calls through
 - Server-side, asyncio-first Python SDK (3.9+)
 - Namespace API with root-level shortcuts for common operations
 - Targets production Cloudflare Workers (gateway, JWT, logs) and Cloud Run (orchestrator)
-- Version: 2.18.1
+- Version: 3.0.1
 
 ## Quick Start
 
@@ -97,13 +97,9 @@ execution = await dominus.workflow.ensure(
     inputs={"report_snapshot": "ar://carebridge/summit-radiology/production/snapshot/report-1"},
 )
 
-# Saved workflow lifecycle through workflow-manager when you need explicit artifacts
-run = await dominus.workflow.create_run(
-    workflow_id="wf_saved_123",
-    context={"report_ref": {"report_id": "r-1", "accession": "a-1", "session_number": "2"}},
-)
-await dominus.workflow.validate_run(run["run_id"])
-result = await dominus.workflow.start_run(run["run_id"])
+# Inspect the canonical run after ensure
+run_state = await dominus.workflow.get_run_state(execution["run_id"])
+timeline = await dominus.workflow.get_run_timeline(execution["run_id"])
 
 # Raw orchestration lifecycle with inline workflow definition
 raw_run = await dominus.ai.workflow.create_run(
@@ -195,9 +191,17 @@ dominus.release_console()     # stop capturing
 - [Development](docs/development.md) -- Setup, testing, adding APIs
 - [Workflow hard-cut release notes](docs/workflow-hard-cut-release.md) -- cutover notes and operational checks
 
+## Verification (local)
+
+```bash
+pip install -e .
+python -m pytest tests -q
+```
+
 ## Workflow Surfaces
 
-- `dominus.workflow.*` is the saved-workflow facade through `dominus-workflow-manager`. Use it for stored workflow IDs and the artifact-aware run lifecycle: `create_run -> register_artifact -> validate_run -> start_run`.
+- `dominus.workflow.ensure()` is the canonical saved-workflow launch path through Authority.
+- `dominus.workflow.ensure_instance()` / `stream_ensure_instance()` are lower-level instance controls, not the default launch surface.
 - `dominus.ai.workflow.*` is the raw orchestration surface. It requires inline `workflow_definition` data. It does not support saved-workflow IDs directly.
 - `dominus.workflow.execute_pipeline()` runs stored pipelines through workflow-manager's native orchestration-backed runner.
 - `dominus.artifacts.*` now supports addressed V2 artifact refs alongside legacy helpers. Prefer `store_v2()`, `head_v2()`, `compare_v2()`, bookmark helpers, and watcher helpers with canonical `ar://{group}/{owner}/{environment}/{kind}/{artifact_key}` refs for new code; `target_project_id` / `use_shared` remain compatibility-only targeting concepts.

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/dominus_sdk_python.egg-info/SOURCES.txt

@@ -47,5 +47,6 @@ dominus_sdk_python.egg-info/dependency_links.txt
 dominus_sdk_python.egg-info/requires.txt
 dominus_sdk_python.egg-info/top_level.txt
 tests/test_logs.py
+tests/test_public_exports.py
 tests/test_workflow_lifecycle.py
 tests/test_workflow_refs.py

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominus-sdk-python"
-version = "2.18.1"
+version = "3.0.1"
 description = "Python SDK for the Dominus Orchestrator Platform"
 readme = "README.md"
 license = {text = "Proprietary"}

dominus_sdk_python-3.0.1/tests/test_public_exports.py

@@ -0,0 +1,11 @@
+from dominus import mint_selected_project_jwt
+
+
+def test_top_level_exports_drop_delegate_alias():
+    assert callable(mint_selected_project_jwt)
+    try:
+        from dominus import delegate_jwt  # type: ignore[attr-defined]
+    except ImportError:
+        delegate_jwt = None
+
+    assert delegate_jwt is None

{dominus_sdk_python-2.18.1 → dominus_sdk_python-3.0.1}/tests/test_workflow_lifecycle.py

@@ -374,26 +374,26 @@ async def test_saved_workflow_instance_ensure_contract_matches_workflow_manager(
 
 
 @pytest.mark.asyncio
-async def test_saved_workflow_instance_ensure_alias_and_stream_guard():
+async def test_saved_workflow_ensure_is_authority_only_and_stream_guard():
     client = FakeClient()
     namespace = WorkflowNamespace(client)
 
     await namespace.ensure(
         "wf-instance",
-        group="reports",
-        owner="company:acme",
         mode="ensure_only",
     )
 
     call = client.calls[0]
-    assert call["endpoint"] == "/api/workflow/workflows/wf-instance/instances/ensure"
-    assert call["body"] == {
-        "params": {
-            "group": "reports",
-            "owner": "company:acme",
-        },
-        "mode": "ensure_only",
-    }
+    assert call["endpoint"] == "/api/authority/runs/ensure"
+    assert call["body"]["workflow_id"] == "wf-instance"
+    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",
+            mode="streaming",
+        )
 
     with pytest.raises(ValueError, match="Use stream_ensure_instance\\(\\) for streaming instance execution"):
         await namespace.ensure_instance(