dominus-sdk-python 4.0.5__tar.gz → 4.0.6__tar.gz

{dominus_sdk_python-4.0.5 → dominus_sdk_python-4.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.5
+Version: 4.0.6
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: 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: `4.0.5`
+- Current package version: `4.0.6`
 
 ## Install
 
@@ -80,6 +80,10 @@ timeline_archive = await dominus.authority.get_timeline_archive_status(
     app_slug="carebridge-summit",
     env="production",
 )
+archive_batch = await dominus.authority.archive_timelines(
+    max_hours=24,
+    max_runtime_ms=600000,
+)
 logs_archive = await dominus.logs.get_archive_status(
     all_scopes=True,
     include_buffer=True,
@@ -107,6 +111,8 @@ buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
     batch_runs=5,
     max_runtime_ms=8000,
 )
+
+schedules = await dominus.authority.list_schedules(all_scopes=True)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.5 → dominus_sdk_python-4.0.6}/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.5`
+- Current package version: `4.0.6`
 
 ## Install
 
@@ -47,6 +47,10 @@ timeline_archive = await dominus.authority.get_timeline_archive_status(
     app_slug="carebridge-summit",
     env="production",
 )
+archive_batch = await dominus.authority.archive_timelines(
+    max_hours=24,
+    max_runtime_ms=600000,
+)
 logs_archive = await dominus.logs.get_archive_status(
     all_scopes=True,
     include_buffer=True,
@@ -74,6 +78,8 @@ buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
     batch_runs=5,
     max_runtime_ms=8000,
 )
+
+schedules = await dominus.authority.list_schedules(all_scopes=True)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.5 → dominus_sdk_python-4.0.6}/dominus/namespaces/authority.py

@@ -1574,6 +1574,24 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 15.0),
         )
 
+    async def archive_timelines(
+        self,
+        *,
+        max_hours: Optional[int] = None,
+        max_runtime_ms: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Run a bounded Authority timeline archive batch. ``POST /api/authority/timelines/archive``."""
+        body = _compact({
+            "max_hours": max_hours,
+            "max_runtime_ms": max_runtime_ms,
+        })
+        return await self._post(
+            "/api/authority/timelines/archive",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
     async def repair_timeline_archive_manifests(
         self,
         *,
@@ -1634,6 +1652,288 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
+    # ==================================================================
+    # Schedules
+    # ==================================================================
+
+    @staticmethod
+    def _schedule_body(
+        *,
+        schedule_key: Optional[str] = None,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        owner_app_slug: Optional[str] = None,
+        owner_env: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
+        target_env: Optional[str] = None,
+        target_url: Optional[str] = None,
+        target_path: Optional[str] = None,
+        gateway_route: Optional[str] = None,
+        method: Optional[str] = None,
+        body: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, Any]] = None,
+        auth_mode: Optional[str] = None,
+        secret_ref: Optional[str] = None,
+        frequency_kind: Optional[str] = None,
+        frequency_value: Optional[str] = None,
+        timezone: Optional[str] = None,
+        enabled: Optional[bool] = None,
+        next_due_at: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        max_runtime_ms: Optional[int] = None,
+        max_retries: Optional[int] = None,
+        jitter_seconds: Optional[int] = None,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        return _compact({
+            "schedule_key": schedule_key,
+            "name": name,
+            "description": description,
+            "owner_app_slug": owner_app_slug or app_slug,
+            "owner_env": owner_env or env,
+            "target_app_slug": target_app_slug,
+            "target_env": target_env,
+            "target_url": target_url,
+            "target_path": target_path,
+            "gateway_route": gateway_route,
+            "method": method,
+            "body_json": body,
+            "headers_json": headers,
+            "auth_mode": auth_mode,
+            "secret_ref": secret_ref,
+            "frequency_kind": frequency_kind,
+            "frequency_value": frequency_value,
+            "timezone": timezone,
+            "enabled": enabled,
+            "next_due_at": next_due_at,
+            "timeout_ms": timeout_ms,
+            "max_runtime_ms": max_runtime_ms,
+            "max_retries": max_retries,
+            "jitter_seconds": jitter_seconds,
+        })
+
+    async def list_schedules(
+        self,
+        *,
+        all_scopes: bool = False,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+        enabled: Optional[bool] = None,
+        limit: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """List Authority scheduled route definitions. ``GET /api/authority/schedules``."""
+        qs = _query_string({
+            "all_scopes": "true" if all_scopes else None,
+            "app_slug": app_slug,
+            "env": env,
+            "enabled": str(enabled).lower() if enabled is not None else None,
+            "limit": limit,
+        })
+        return await self._get(
+            f"/api/authority/schedules{qs}",
+            timeout=self._http_timeout(timeout, 15.0),
+        )
+
+    async def create_schedule(
+        self,
+        *,
+        schedule_key: Optional[str] = None,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        owner_app_slug: Optional[str] = None,
+        owner_env: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
+        target_env: Optional[str] = None,
+        target_url: Optional[str] = None,
+        target_path: Optional[str] = None,
+        gateway_route: Optional[str] = None,
+        method: Optional[str] = None,
+        body: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, Any]] = None,
+        auth_mode: Optional[str] = None,
+        secret_ref: Optional[str] = None,
+        frequency_kind: Optional[str] = None,
+        frequency_value: Optional[str] = None,
+        timezone: Optional[str] = None,
+        enabled: Optional[bool] = None,
+        next_due_at: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        max_runtime_ms: Optional[int] = None,
+        max_retries: Optional[int] = None,
+        jitter_seconds: Optional[int] = None,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Create a scheduled route. ``POST /api/authority/schedules``."""
+        return await self._post(
+            "/api/authority/schedules",
+            self._schedule_body(
+                schedule_key=schedule_key,
+                name=name,
+                description=description,
+                owner_app_slug=owner_app_slug,
+                owner_env=owner_env,
+                target_app_slug=target_app_slug,
+                target_env=target_env,
+                target_url=target_url,
+                target_path=target_path,
+                gateway_route=gateway_route,
+                method=method,
+                body=body,
+                headers=headers,
+                auth_mode=auth_mode,
+                secret_ref=secret_ref,
+                frequency_kind=frequency_kind,
+                frequency_value=frequency_value,
+                timezone=timezone,
+                enabled=enabled,
+                next_due_at=next_due_at,
+                timeout_ms=timeout_ms,
+                max_runtime_ms=max_runtime_ms,
+                max_retries=max_retries,
+                jitter_seconds=jitter_seconds,
+                app_slug=app_slug,
+                env=env,
+            ),
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def update_schedule(
+        self,
+        schedule_id: str,
+        *,
+        schedule_key: Optional[str] = None,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        owner_app_slug: Optional[str] = None,
+        owner_env: Optional[str] = None,
+        target_app_slug: Optional[str] = None,
+        target_env: Optional[str] = None,
+        target_url: Optional[str] = None,
+        target_path: Optional[str] = None,
+        gateway_route: Optional[str] = None,
+        method: Optional[str] = None,
+        body: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, Any]] = None,
+        auth_mode: Optional[str] = None,
+        secret_ref: Optional[str] = None,
+        frequency_kind: Optional[str] = None,
+        frequency_value: Optional[str] = None,
+        timezone: Optional[str] = None,
+        enabled: Optional[bool] = None,
+        next_due_at: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        max_runtime_ms: Optional[int] = None,
+        max_retries: Optional[int] = None,
+        jitter_seconds: Optional[int] = None,
+        app_slug: Optional[str] = None,
+        env: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Update a scheduled route. ``PATCH /api/authority/schedules/{schedule_id}``."""
+        return await self._client._request(
+            endpoint=f"/api/authority/schedules/{quote(schedule_id, safe='')}",
+            method="PATCH",
+            body=self._schedule_body(
+                schedule_key=schedule_key,
+                name=name,
+                description=description,
+                owner_app_slug=owner_app_slug,
+                owner_env=owner_env,
+                target_app_slug=target_app_slug,
+                target_env=target_env,
+                target_url=target_url,
+                target_path=target_path,
+                gateway_route=gateway_route,
+                method=method,
+                body=body,
+                headers=headers,
+                auth_mode=auth_mode,
+                secret_ref=secret_ref,
+                frequency_kind=frequency_kind,
+                frequency_value=frequency_value,
+                timezone=timezone,
+                enabled=enabled,
+                next_due_at=next_due_at,
+                timeout_ms=timeout_ms,
+                max_runtime_ms=max_runtime_ms,
+                max_retries=max_retries,
+                jitter_seconds=jitter_seconds,
+                app_slug=app_slug,
+                env=env,
+            ),
+            use_gateway=True,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def pause_schedule(self, schedule_id: str, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+        """Pause a scheduled route. ``POST /api/authority/schedules/{schedule_id}/pause``."""
+        return await self._post(
+            f"/api/authority/schedules/{quote(schedule_id, safe='')}/pause",
+            {},
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def resume_schedule(self, schedule_id: str, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+        """Resume a scheduled route. ``POST /api/authority/schedules/{schedule_id}/resume``."""
+        return await self._post(
+            f"/api/authority/schedules/{quote(schedule_id, safe='')}/resume",
+            {},
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def claim_due_schedules(
+        self,
+        *,
+        limit: Optional[int] = None,
+        lock_seconds: Optional[int] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Claim due scheduled routes for worker execution. ``POST /api/authority/schedules/claim-due``."""
+        body = _compact({
+            "limit": limit,
+            "lock_seconds": lock_seconds,
+        })
+        return await self._post(
+            "/api/authority/schedules/claim-due",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def complete_schedule_run(
+        self,
+        schedule_id: str,
+        run_id: str,
+        *,
+        result: Optional[Dict[str, Any]] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Mark a scheduled route run complete."""
+        return await self._post(
+            f"/api/authority/schedules/{quote(schedule_id, safe='')}/runs/{quote(run_id, safe='')}/complete",
+            {"result": result or {}},
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def fail_schedule_run(
+        self,
+        schedule_id: str,
+        run_id: str,
+        *,
+        error: str,
+        result: Optional[Dict[str, Any]] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Mark a scheduled route run failed."""
+        return await self._post(
+            f"/api/authority/schedules/{quote(schedule_id, safe='')}/runs/{quote(run_id, safe='')}/fail",
+            {"error": error, "result": result or {}},
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
     # ==================================================================
     # Context
     # ==================================================================

{dominus_sdk_python-4.0.5 → dominus_sdk_python-4.0.6}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.5
+Version: 4.0.6
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: 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: `4.0.5`
+- Current package version: `4.0.6`
 
 ## Install
 
@@ -80,6 +80,10 @@ timeline_archive = await dominus.authority.get_timeline_archive_status(
     app_slug="carebridge-summit",
     env="production",
 )
+archive_batch = await dominus.authority.archive_timelines(
+    max_hours=24,
+    max_runtime_ms=600000,
+)
 logs_archive = await dominus.logs.get_archive_status(
     all_scopes=True,
     include_buffer=True,
@@ -107,6 +111,8 @@ buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
     batch_runs=5,
     max_runtime_ms=8000,
 )
+
+schedules = await dominus.authority.list_schedules(all_scopes=True)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.5 → dominus_sdk_python-4.0.6}/pyproject.toml

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

{dominus_sdk_python-4.0.5 → dominus_sdk_python-4.0.6}/tests/test_authority_public_vocabulary.py

@@ -79,9 +79,11 @@ def test_authority_scope_signatures_use_new_public_vocabulary():
     timeline_sig = inspect.signature(AuthorityNamespace.get_run_timeline)
     query_timelines_sig = inspect.signature(AuthorityNamespace.query_timelines)
     archive_status_sig = inspect.signature(AuthorityNamespace.get_timeline_archive_status)
+    archive_run_sig = inspect.signature(AuthorityNamespace.archive_timelines)
     archive_repair_sig = inspect.signature(AuthorityNamespace.repair_timeline_archive_manifests)
     archive_verify_sig = inspect.signature(AuthorityNamespace.verify_timeline_archive_manifests)
     archive_prune_sig = inspect.signature(AuthorityNamespace.prune_timeline_archive_retention)
+    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"):
@@ -107,12 +109,16 @@ def test_authority_scope_signatures_use_new_public_vocabulary():
         assert name in timeline_sig.parameters
         assert name in query_timelines_sig.parameters
     assert "all_scopes" in archive_status_sig.parameters
+    for name in ("max_hours", "max_runtime_ms"):
+        assert name in archive_run_sig.parameters
     for name in ("since", "until"):
         assert name in archive_repair_sig.parameters
         assert name in archive_verify_sig.parameters
         assert name in archive_prune_sig.parameters
     for name in ("retention_days", "dry_run", "confirm"):
         assert name in archive_prune_sig.parameters
+    for name in ("gateway_route", "target_url", "frequency_kind", "max_runtime_ms", "app_slug", "env"):
+        assert name in schedule_create_sig.parameters
 
     for name in ("target_org_id", "target_app_slug", "target_env"):
         assert name in mint_sig.parameters
@@ -206,6 +212,10 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         env="production",
         limit=5,
     )
+    await namespace.archive_timelines(
+        max_hours=24,
+        max_runtime_ms=600000,
+    )
     await namespace.repair_timeline_archive_manifests(
         since="2026-04-01T00:00:00Z",
         until="2026-04-02T00:00:00Z",
@@ -221,6 +231,22 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         dry_run=False,
         confirm="DELETE_EXPIRED_ARCHIVE_OBJECTS",
     )
+    await namespace.create_schedule(
+        schedule_key="demo.hourly",
+        app_slug="carebridge",
+        env="production",
+        target_url="https://demo.example/api/hourly",
+        frequency_kind="hourly",
+        max_runtime_ms=600000,
+    )
+    await namespace.update_schedule(
+        "demo.hourly",
+        enabled=False,
+        next_due_at="2026-04-19T00:00:00Z",
+    )
+    await namespace.claim_due_schedules(limit=5, lock_seconds=900)
+    await namespace.complete_schedule_run("demo.hourly", "run-1", result={"ok": True})
+    await namespace.fail_schedule_run("demo.hourly", "run-2", error="boom", result={"ok": False})
 
     ensure_body = client.calls[0]["body"]
     assert ensure_body["app_slug"] == "carebridge"
@@ -279,25 +305,50 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         "/api/authority/timelines/archive-status?"
         "all_scopes=true&app_slug=carebridge&env=production&limit=5"
     )
-    assert client.calls[10]["endpoint"] == "/api/authority/timelines/archive-repair"
+    assert client.calls[10]["endpoint"] == "/api/authority/timelines/archive"
     assert client.calls[10]["method"] == "POST"
     assert client.calls[10]["body"] == {
-        "since": "2026-04-01T00:00:00Z",
-        "until": "2026-04-02T00:00:00Z",
+        "max_hours": 24,
+        "max_runtime_ms": 600000,
     }
-    assert client.calls[11]["endpoint"] == "/api/authority/timelines/archive-verify"
+    assert client.calls[11]["endpoint"] == "/api/authority/timelines/archive-repair"
+    assert client.calls[11]["method"] == "POST"
     assert client.calls[11]["body"] == {
         "since": "2026-04-01T00:00:00Z",
         "until": "2026-04-02T00:00:00Z",
     }
-    assert client.calls[12]["endpoint"] == "/api/authority/timelines/archive-prune"
+    assert client.calls[12]["endpoint"] == "/api/authority/timelines/archive-verify"
     assert client.calls[12]["body"] == {
+        "since": "2026-04-01T00:00:00Z",
+        "until": "2026-04-02T00:00:00Z",
+    }
+    assert client.calls[13]["endpoint"] == "/api/authority/timelines/archive-prune"
+    assert client.calls[13]["body"] == {
         "since": "2026-01-01T00:00:00Z",
         "until": "2026-01-02T00:00:00Z",
         "retention_days": 365,
         "dry_run": False,
         "confirm": "DELETE_EXPIRED_ARCHIVE_OBJECTS",
     }
+    assert client.calls[14]["endpoint"] == "/api/authority/schedules"
+    assert client.calls[14]["body"] == {
+        "schedule_key": "demo.hourly",
+        "owner_app_slug": "carebridge",
+        "owner_env": "production",
+        "target_url": "https://demo.example/api/hourly",
+        "frequency_kind": "hourly",
+        "max_runtime_ms": 600000,
+    }
+    assert client.calls[15]["endpoint"] == "/api/authority/schedules/demo.hourly"
+    assert client.calls[15]["method"] == "PATCH"
+    assert client.calls[15]["body"] == {
+        "enabled": False,
+        "next_due_at": "2026-04-19T00:00:00Z",
+    }
+    assert client.calls[16]["endpoint"] == "/api/authority/schedules/claim-due"
+    assert client.calls[16]["body"] == {"limit": 5, "lock_seconds": 900}
+    assert client.calls[17]["endpoint"] == "/api/authority/schedules/demo.hourly/runs/run-1/complete"
+    assert client.calls[18]["endpoint"] == "/api/authority/schedules/demo.hourly/runs/run-2/fail"
 
 
 @pytest.mark.asyncio