dominus-sdk-python 3.0.4__tar.gz → 3.0.5__tar.gz

{dominus_sdk_python-3.0.4 → dominus_sdk_python-3.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 3.0.4
+Version: 3.0.5
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -41,7 +41,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - Namespace-first API with a small root shortcut surface
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `3.0.4`
+- Current package version: `3.0.5`
 
 ## Install
 
@@ -69,7 +69,11 @@ run = await dominus.workflow.ensure(
     company="summit-radiology",
 )
 
-timeline = await dominus.workflow.get_run_timeline(run["run_id"])
+timeline = await dominus.authority.get_run_timeline(
+    run["run_id"],
+    since="2026-04-11T08:33:00Z",
+    until="2026-04-11T09:33:00Z",
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-3.0.4 → dominus_sdk_python-3.0.5}/README.md

@@ -8,7 +8,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - Namespace-first API with a small root shortcut surface
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `3.0.4`
+- Current package version: `3.0.5`
 
 ## Install
 
@@ -36,7 +36,11 @@ run = await dominus.workflow.ensure(
     company="summit-radiology",
 )
 
-timeline = await dominus.workflow.get_run_timeline(run["run_id"])
+timeline = await dominus.authority.get_run_timeline(
+    run["run_id"],
+    since="2026-04-11T08:33:00Z",
+    until="2026-04-11T09:33:00Z",
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-3.0.4 → dominus_sdk_python-3.0.5}/dominus/__init__.py

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

{dominus_sdk_python-3.0.4 → dominus_sdk_python-3.0.5}/dominus/namespaces/authority.py

@@ -118,6 +118,7 @@ class AuthorityNamespace:
         target_org_id: Optional[str],
         target_env: Optional[str],
         target_app_slug: Optional[str] = None,
+        shared_app_slug: Optional[str] = None,
     ) -> Dict[str, Any]:
         out: Dict[str, Any] = {}
         if app_slug:
@@ -130,6 +131,8 @@ class AuthorityNamespace:
             out["target_app_slug"] = target_app_slug
         if target_env:
             out["target_env"] = target_env
+        if shared_app_slug:
+            out["shared_app_slug"] = shared_app_slug
         return out
 
     def _target_query_params(
@@ -167,6 +170,7 @@ class AuthorityNamespace:
         workflow_id: Optional[str] = None,
         workflow_ref: Optional[str] = None,
         run_kind: Optional[str] = None,
+        bootstrap_profile: Optional[str] = None,
         company_slug: Optional[str] = None,
         slug: Optional[str] = None,
         instance_id: Optional[str] = None,
@@ -207,7 +211,7 @@ class AuthorityNamespace:
 
         For company bootstrap, pass ``run_kind="company.bootstrap"`` (or ``company_bootstrap``) plus
         ``company``, ``company_slug``, or ``slug``. Optional bootstrap fields mirror
-        ``bootstrap_company`` (``execution_mode``, ``region``, …).
+        ``bootstrap_company`` (``execution_mode``, ``region``, ``bootstrap_profile``, …).
         """
         bootstrap = _is_company_bootstrap_run_kind(run_kind)
         if not bootstrap and not workflow_id and not workflow_ref:
@@ -233,6 +237,7 @@ class AuthorityNamespace:
         if bootstrap:
             body = _compact({
                 "run_kind": run_kind,
+                "bootstrap_profile": bootstrap_profile,
                 "workflow_id": workflow_id,
                 "workflow_ref": workflow_ref,
                 "instance_id": instance_id,
@@ -264,6 +269,7 @@ class AuthorityNamespace:
             body = _compact({
                 "workflow_id": workflow_id,
                 "workflow_ref": workflow_ref,
+                "bootstrap_profile": bootstrap_profile,
                 "instance_id": instance_id,
                 "instance_key": instance_key,
                 "group": group,
@@ -444,21 +450,51 @@ class AuthorityNamespace:
             body,
         )
 
-    async def get_run_timeline(self, run_id: str, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+    async def get_run_timeline(
+        self,
+        run_id: str,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        window_hours: Optional[int] = None,
+        limit: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
         """Get run state-transition timeline. ``GET /api/authority/runs/{run_id}/timeline``."""
         if not run_id:
             raise ValueError("run_id is required")
+        qs = _query_string({
+            "since": since,
+            "until": until,
+            "window_hours": window_hours,
+            "limit": limit,
+        })
         return await self._get(
-            f"/api/authority/runs/{quote(run_id, safe='')}/timeline",
+            f"/api/authority/runs/{quote(run_id, safe='')}/timeline{qs}",
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_run_dossier(self, run_id: str, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+    async def get_run_dossier(
+        self,
+        run_id: str,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        window_hours: Optional[int] = None,
+        limit: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
         """Get the full Authority dossier for a run. ``GET /api/authority/dossiers/run/{run_id}``."""
         if not run_id:
             raise ValueError("run_id is required")
+        qs = _query_string({
+            "since": since,
+            "until": until,
+            "window_hours": window_hours,
+            "limit": limit,
+        })
         return await self._get(
-            f"/api/authority/dossiers/run/{quote(run_id, safe='')}",
+            f"/api/authority/dossiers/run/{quote(run_id, safe='')}{qs}",
             timeout=self._http_timeout(timeout, 30.0),
         )
 
@@ -469,90 +505,278 @@ class AuthorityNamespace:
     async def publish_workflow(
         self,
         *,
-        workflow_ref: str,
+        name: Optional[str] = None,
+        yaml_content: Optional[str] = None,
+        workflow_ref: Optional[str] = None,
         workflow_id: Optional[str] = None,
-        version: Optional[Any] = None,
-        status: Optional[str] = None,
-        pinned: Optional[bool] = None,
-        bindings: Optional[Dict[str, Any]] = None,
+        description: Optional[str] = None,
+        tags: Optional[Any] = None,
         metadata: Optional[Dict[str, Any]] = None,
         app_slug: Optional[str] = None,
         env: Optional[str] = None,
         target_org_id: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
         target_env: Optional[str] = None,
+        shared_app_slug: Optional[str] = None,
         initiator_type: Optional[str] = None,
         initiator_id: Optional[str] = None,
         idempotency_key: Optional[str] = None,
+        timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
         """Publish a workflow to the Authority registry. ``POST /api/authority/workflows/publish``."""
-        if not workflow_ref:
-            raise ValueError("publish_workflow requires workflow_ref")
         body = _compact({
+            "name": name,
+            "yaml_content": yaml_content,
             "workflow_ref": workflow_ref,
             "workflow_id": workflow_id,
-            "version": version,
-            "status": status,
-            "pinned": pinned,
-            "bindings": bindings,
+            "description": description,
+            "tags": tags,
             "metadata": metadata,
             **self._initiator(initiator_type, initiator_id, idempotency_key),
-            **self._scope(app_slug, env, target_org_id, target_env),
+            **self._scope(
+                app_slug,
+                env,
+                target_org_id,
+                target_env,
+                target_app_slug=target_app_slug,
+                shared_app_slug=shared_app_slug,
+            ),
         })
-        return await self._post("/api/authority/workflows/publish", body)
+        return await self._post(
+            "/api/authority/workflows/publish",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
 
     async def list_bindings(
         self,
         *,
-        workflow_ref: Optional[str] = None,
-        workflow_id: Optional[str] = None,
+        source_workflow_ref: Optional[str] = None,
+        workflow_type: Optional[str] = None,
+        company_slug: Optional[str] = None,
         status: Optional[str] = None,
         app_slug: Optional[str] = None,
         env: Optional[str] = None,
         target_org_id: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
         target_env: Optional[str] = None,
+        shared_app_slug: Optional[str] = None,
         limit: int = 50,
         offset: int = 0,
+        timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
         """List Authority workflow bindings. ``GET /api/authority/workflow-bindings``."""
         tid, tev = self._target_query_params(target_org_id, target_env)
         qs = _query_string({
-            "workflow_ref": workflow_ref,
-            "workflow_id": workflow_id,
+            "source_workflow_ref": source_workflow_ref,
+            "workflow_type": workflow_type,
+            "company_slug": company_slug,
             "status": status,
             "app_slug": app_slug,
             "env": env,
             "target_org_id": tid,
+            "target_app_slug": target_app_slug,
             "target_env": tev,
+            "shared_app_slug": shared_app_slug,
             "limit": limit,
             "offset": offset,
         })
-        return await self._get(f"/api/authority/workflow-bindings{qs}")
+        return await self._get(
+            f"/api/authority/workflow-bindings{qs}",
+            timeout=self._http_timeout(timeout, 30.0),
+        )
 
     async def list_publications(
         self,
         *,
-        workflow_ref: Optional[str] = None,
+        publication_id: Optional[str] = None,
+        binding_id: Optional[str] = None,
+        source_workflow_ref: Optional[str] = None,
+        workflow_type: Optional[str] = None,
+        company_slug: Optional[str] = None,
         status: Optional[str] = None,
         app_slug: Optional[str] = None,
         env: Optional[str] = None,
         target_org_id: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
         target_env: Optional[str] = None,
+        shared_app_slug: Optional[str] = None,
         limit: int = 50,
         offset: int = 0,
+        timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
         """List Authority workflow publications. ``GET /api/authority/workflow-publications``."""
         tid, tev = self._target_query_params(target_org_id, target_env)
         qs = _query_string({
-            "workflow_ref": workflow_ref,
+            "publication_id": publication_id,
+            "binding_id": binding_id,
+            "source_workflow_ref": source_workflow_ref,
+            "workflow_type": workflow_type,
+            "company_slug": company_slug,
             "status": status,
             "app_slug": app_slug,
             "env": env,
             "target_org_id": tid,
+            "target_app_slug": target_app_slug,
             "target_env": tev,
+            "shared_app_slug": shared_app_slug,
             "limit": limit,
             "offset": offset,
         })
-        return await self._get(f"/api/authority/workflow-publications{qs}")
+        return await self._get(
+            f"/api/authority/workflow-publications{qs}",
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def create_workflow_binding(
+        self,
+        *,
+        company_slug: str,
+        workflow_type: str,
+        source_workflow_id: str,
+        target_workflow_id: str,
+        source_workflow_ref: Optional[str] = None,
+        source_org_id: Optional[str] = None,
+        source_version: Optional[int] = None,
+        target_tenant_slug: Optional[str] = None,
+        target_workflow_slug: Optional[str] = None,
+        active_publication_id: Optional[str] = None,
+        publication_state: Optional[str] = None,
+        publication_operation: Optional[str] = None,
+        source_hash: Optional[str] = None,
+        target_hash: Optional[str] = None,
+        drift_status: Optional[str] = None,
+        drift_checked_at: Optional[str] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        status: Optional[str] = None,
+        published_at: Optional[str] = None,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+        target_org_id: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
+        target_env: Optional[str] = None,
+        shared_app_slug: Optional[str] = None,
+        initiator_type: Optional[str] = None,
+        initiator_id: Optional[str] = None,
+        idempotency_key: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Create or update a workflow binding. ``POST /api/authority/workflow-bindings``."""
+        body = _compact({
+            "company_slug": company_slug,
+            "workflow_type": workflow_type,
+            "source_workflow_ref": source_workflow_ref,
+            "source_org_id": source_org_id,
+            "source_workflow_id": source_workflow_id,
+            "source_version": source_version,
+            "target_tenant_slug": target_tenant_slug,
+            "target_workflow_slug": target_workflow_slug,
+            "target_workflow_id": target_workflow_id,
+            "active_publication_id": active_publication_id,
+            "publication_state": publication_state,
+            "publication_operation": publication_operation,
+            "source_hash": source_hash,
+            "target_hash": target_hash,
+            "drift_status": drift_status,
+            "drift_checked_at": drift_checked_at,
+            "metadata": metadata,
+            "status": status,
+            "published_at": published_at,
+            **self._initiator(initiator_type, initiator_id, idempotency_key),
+            **self._scope(
+                app_slug,
+                env,
+                target_org_id,
+                target_env,
+                target_app_slug=target_app_slug,
+                shared_app_slug=shared_app_slug,
+            ),
+        })
+        return await self._post(
+            "/api/authority/workflow-bindings",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def create_workflow_publication(
+        self,
+        *,
+        company_slug: str,
+        workflow_type: str,
+        source_workflow_id: str,
+        target_workflow_id: str,
+        source_workflow_ref: Optional[str] = None,
+        source_org_id: Optional[str] = None,
+        operation: Optional[str] = None,
+        source_version: Optional[int] = None,
+        source_hash: Optional[str] = None,
+        source_name: Optional[str] = None,
+        source_description: Optional[str] = None,
+        source_tags: Optional[list[Any]] = None,
+        source_yaml: Optional[str] = None,
+        target_tenant_slug: Optional[str] = None,
+        target_workflow_slug: Optional[str] = None,
+        target_hash: Optional[str] = None,
+        previous_publication_id: Optional[str] = None,
+        rollback_of_publication_id: Optional[str] = None,
+        publication_status: Optional[str] = None,
+        binding_status: Optional[str] = None,
+        publication_metadata: Optional[Dict[str, Any]] = None,
+        binding_metadata: Optional[Dict[str, Any]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        published_at: Optional[str] = None,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+        target_org_id: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
+        target_env: Optional[str] = None,
+        shared_app_slug: Optional[str] = None,
+        initiator_type: Optional[str] = None,
+        initiator_id: Optional[str] = None,
+        idempotency_key: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Create or upsert a workflow publication. ``POST /api/authority/workflow-publications``."""
+        body = _compact({
+            "company_slug": company_slug,
+            "workflow_type": workflow_type,
+            "source_workflow_ref": source_workflow_ref,
+            "source_org_id": source_org_id,
+            "operation": operation,
+            "source_workflow_id": source_workflow_id,
+            "source_version": source_version,
+            "source_hash": source_hash,
+            "source_name": source_name,
+            "source_description": source_description,
+            "source_tags": source_tags,
+            "source_yaml": source_yaml,
+            "target_tenant_slug": target_tenant_slug,
+            "target_workflow_slug": target_workflow_slug,
+            "target_workflow_id": target_workflow_id,
+            "target_hash": target_hash,
+            "previous_publication_id": previous_publication_id,
+            "rollback_of_publication_id": rollback_of_publication_id,
+            "publication_status": publication_status,
+            "binding_status": binding_status,
+            "publication_metadata": publication_metadata,
+            "binding_metadata": binding_metadata,
+            "metadata": metadata,
+            "published_at": published_at,
+            **self._initiator(initiator_type, initiator_id, idempotency_key),
+            **self._scope(
+                app_slug,
+                env,
+                target_org_id,
+                target_env,
+                target_app_slug=target_app_slug,
+                shared_app_slug=shared_app_slug,
+            ),
+        })
+        return await self._post(
+            "/api/authority/workflow-publications",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
 
     # ==================================================================
     # Companies
@@ -655,6 +879,7 @@ class AuthorityNamespace:
         action: Optional[str] = None,
         run_id: Optional[str] = None,
         reason: Optional[str] = None,
+        bootstrap_profile: Optional[str] = None,
         shared_app_slug: Optional[str] = None,
         region: Optional[str] = None,
         system: Optional[str] = None,
@@ -684,6 +909,7 @@ class AuthorityNamespace:
             "action": action,
             "run_id": run_id,
             "reason": reason,
+            "bootstrap_profile": bootstrap_profile,
             "shared_app_slug": shared_app_slug,
             "region": region,
             "system": system,
@@ -742,6 +968,10 @@ class AuthorityNamespace:
         env: Optional[str] = None,
         target_org_id: Optional[str] = None,
         target_env: Optional[str] = None,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        window_hours: Optional[int] = None,
+        limit: Optional[int] = None,
         timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
         """Get full Authority dossier for a company. ``GET /api/authority/dossiers/company/{company}``."""
@@ -753,6 +983,10 @@ class AuthorityNamespace:
             "env": env,
             "target_org_id": tid,
             "target_env": tev,
+            "since": since,
+            "until": until,
+            "window_hours": window_hours,
+            "limit": limit,
         })
         return await self._get(
             f"/api/authority/dossiers/company/{quote(company_slug, safe='')}{qs}",
@@ -889,7 +1123,16 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_deploy_dossier(self, deploy_id: str, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+    async def get_deploy_dossier(
+        self,
+        deploy_id: str,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        window_hours: Optional[int] = None,
+        limit: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
         """
         Get the full Authority dossier for a deploy.
         ``GET /api/authority/dossiers/deploy/{deploy_id}``.
@@ -900,8 +1143,14 @@ class AuthorityNamespace:
         """
         if not deploy_id:
             raise ValueError("deploy_id is required")
+        qs = _query_string({
+            "since": since,
+            "until": until,
+            "window_hours": window_hours,
+            "limit": limit,
+        })
         return await self._get(
-            f"/api/authority/dossiers/deploy/{quote(deploy_id, safe='')}",
+            f"/api/authority/dossiers/deploy/{quote(deploy_id, safe='')}{qs}",
             timeout=self._http_timeout(timeout, 30.0),
         )
 
@@ -1272,6 +1521,8 @@ class AuthorityNamespace:
         company: Optional[str] = None,
         run_id: Optional[str] = None,
         filters: Optional[Dict[str, Any]] = None,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
         window_hours: Optional[int] = None,
         limit: Optional[int] = None,
         app_slug: Optional[str] = None,
@@ -1289,6 +1540,8 @@ class AuthorityNamespace:
             "company": company,
             "run_id": run_id,
             "filters": filters,
+            "since": since,
+            "until": until,
             "window_hours": window_hours,
             "limit": limit,
             **self._initiator(initiator_type, initiator_id, idempotency_key),
@@ -1300,6 +1553,27 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
+    async def get_timeline_archive_status(
+        self,
+        *,
+        all_scopes: bool = False,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+        limit: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Get Authority timeline archive backlog state. ``GET /api/authority/timelines/archive-status``."""
+        qs = _query_string({
+            "all_scopes": "true" if all_scopes else None,
+            "app_slug": app_slug,
+            "env": env,
+            "limit": limit,
+        })
+        return await self._get(
+            f"/api/authority/timelines/archive-status{qs}",
+            timeout=self._http_timeout(timeout, 15.0),
+        )
+
     # ==================================================================
     # Context
     # ==================================================================