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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 3.0.5
+Version: 4.0.1
 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.5`
+- Current package version: `4.0.1`
 
 ## Install
 
@@ -74,6 +74,22 @@ timeline = await dominus.authority.get_run_timeline(
     since="2026-04-11T08:33:00Z",
     until="2026-04-11T09:33:00Z",
 )
+
+timeline_archive = await dominus.authority.get_timeline_archive_status(
+    app_slug="carebridge-summit",
+    env="production",
+)
+logs_archive = await dominus.logs.get_archive_status(all_scopes=True, limit=5)
+
+# Archive maintenance is explicit and dry-run first.
+verify = await dominus.authority.verify_timeline_archive_manifests(
+    since="2026-04-01T00:00:00Z",
+    until="2026-04-02T00:00:00Z",
+)
+prune = await dominus.logs.prune_archive_retention(
+    retention_days=90,
+    dry_run=True,
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/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.5`
+- Current package version: `4.0.1`
 
 ## Install
 
@@ -41,6 +41,22 @@ timeline = await dominus.authority.get_run_timeline(
     since="2026-04-11T08:33:00Z",
     until="2026-04-11T09:33:00Z",
 )
+
+timeline_archive = await dominus.authority.get_timeline_archive_status(
+    app_slug="carebridge-summit",
+    env="production",
+)
+logs_archive = await dominus.logs.get_archive_status(all_scopes=True, limit=5)
+
+# Archive maintenance is explicit and dry-run first.
+verify = await dominus.authority.verify_timeline_archive_manifests(
+    since="2026-04-01T00:00:00Z",
+    until="2026-04-02T00:00:00Z",
+)
+prune = await dominus.logs.prune_archive_retention(
+    retention_days=90,
+    dry_run=True,
+)
 ```
 
 ## Session-Scoped Clients

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

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

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/dominus/helpers/core.py

@@ -552,7 +552,6 @@ async def mint_selected_scope_jwt(
     target_org_id: str,
     target_app_slug: Optional[str] = None,
     target_env: Optional[str] = None,
-    use_shared: bool = False
 ) -> str:
     """
     Mint a selected-scope JWT for a target org/app/env scope.
@@ -566,7 +565,6 @@ async def mint_selected_scope_jwt(
         target_app_slug: Optional descriptive slug for the target app. The live
             mint route keys selected-scope targeting off org/env.
         target_env: Environment (development, staging, production)
-        use_shared: Deprecated no-op retained only for call-site simplicity
 
     Returns:
         Selected-scope JWT string
@@ -593,7 +591,6 @@ async def mint_selected_scope_jwt(
         "target_org_id": target_org_id,
         "target_env": target_env,
     }
-    _ = use_shared
 
     body_b64 = _b64_encode(body_json)
 

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

@@ -1574,6 +1574,66 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 15.0),
         )
 
+    async def repair_timeline_archive_manifests(
+        self,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Rebuild Authority timeline daily archive manifests from cold buckets. ``POST /api/authority/timelines/archive-repair``."""
+        body = _compact({
+            "since": since,
+            "until": until,
+        })
+        return await self._post(
+            "/api/authority/timelines/archive-repair",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def verify_timeline_archive_manifests(
+        self,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Verify Authority timeline daily archive manifests against cold buckets. ``POST /api/authority/timelines/archive-verify``."""
+        body = _compact({
+            "since": since,
+            "until": until,
+        })
+        return await self._post(
+            "/api/authority/timelines/archive-verify",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
+    async def prune_timeline_archive_retention(
+        self,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        retention_days: Optional[int] = None,
+        dry_run: bool = True,
+        confirm: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        """Dry-run or enforce Authority timeline cold archive retention. ``POST /api/authority/timelines/archive-prune``."""
+        body = _compact({
+            "since": since,
+            "until": until,
+            "retention_days": retention_days,
+            "dry_run": dry_run,
+            "confirm": confirm,
+        })
+        return await self._post(
+            "/api/authority/timelines/archive-prune",
+            body,
+            timeout=self._http_timeout(timeout, 30.0),
+        )
+
     # ==================================================================
     # Context
     # ==================================================================

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/dominus/namespaces/logs.py

@@ -429,6 +429,87 @@ class LogsNamespace:
             use_gateway=True,
         )
 
+    async def repair_archive_manifests(
+        self,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        target_org_id: Optional[str] = None,
+        target_env: Optional[str] = None,
+        use_shared: Optional[bool] = None,
+    ) -> Dict[str, Any]:
+        """Rebuild Logs Worker daily archive manifests from existing cold buckets. ``POST /api/logs/archive-repair``."""
+        body = {
+            "since": since,
+            "until": until,
+            "target_org_id": target_org_id,
+            "target_env": target_env,
+        }
+        if use_shared is not None:
+            body["use_shared"] = use_shared
+        return await self._client._request(
+            endpoint="/api/logs/archive-repair",
+            method="POST",
+            body={k: v for k, v in body.items() if v is not None and v != ""},
+            use_gateway=True,
+        )
+
+    async def verify_archive_manifests(
+        self,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        target_org_id: Optional[str] = None,
+        target_env: Optional[str] = None,
+        use_shared: Optional[bool] = None,
+    ) -> Dict[str, Any]:
+        """Verify Logs Worker daily archive manifests against existing cold buckets. ``POST /api/logs/archive-verify``."""
+        body = {
+            "since": since,
+            "until": until,
+            "target_org_id": target_org_id,
+            "target_env": target_env,
+        }
+        if use_shared is not None:
+            body["use_shared"] = use_shared
+        return await self._client._request(
+            endpoint="/api/logs/archive-verify",
+            method="POST",
+            body={k: v for k, v in body.items() if v is not None and v != ""},
+            use_gateway=True,
+        )
+
+    async def prune_archive_retention(
+        self,
+        *,
+        since: Optional[str] = None,
+        until: Optional[str] = None,
+        retention_days: Optional[int] = None,
+        dry_run: bool = True,
+        confirm: Optional[str] = None,
+        target_org_id: Optional[str] = None,
+        target_env: Optional[str] = None,
+        use_shared: Optional[bool] = None,
+    ) -> Dict[str, Any]:
+        """Dry-run or enforce Logs Worker cold archive retention. ``POST /api/logs/archive-prune``."""
+        body = {
+            "since": since,
+            "until": until,
+            "retention_days": retention_days,
+            "dry_run": dry_run,
+            "confirm": confirm,
+            "target_org_id": target_org_id,
+            "target_env": target_env,
+        }
+        if use_shared is not None:
+            body["use_shared"] = use_shared
+        return await self._client._request(
+            endpoint="/api/logs/archive-prune",
+            method="POST",
+            body={k: v for k, v in body.items() if v is not None and v != ""},
+            use_gateway=True,
+        )
+
     async def query(
         self,
         minutes: int = 10,

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 3.0.5
+Version: 4.0.1
 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.5`
+- Current package version: `4.0.1`
 
 ## Install
 
@@ -74,6 +74,22 @@ timeline = await dominus.authority.get_run_timeline(
     since="2026-04-11T08:33:00Z",
     until="2026-04-11T09:33:00Z",
 )
+
+timeline_archive = await dominus.authority.get_timeline_archive_status(
+    app_slug="carebridge-summit",
+    env="production",
+)
+logs_archive = await dominus.logs.get_archive_status(all_scopes=True, limit=5)
+
+# Archive maintenance is explicit and dry-run first.
+verify = await dominus.authority.verify_timeline_archive_manifests(
+    since="2026-04-01T00:00:00Z",
+    until="2026-04-02T00:00:00Z",
+)
+prune = await dominus.logs.prune_archive_retention(
+    retention_days=90,
+    dry_run=True,
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/pyproject.toml

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

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/tests/test_authority_public_vocabulary.py

@@ -79,6 +79,9 @@ 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_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)
     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"):
@@ -104,10 +107,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 ("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 ("target_org_id", "target_app_slug", "target_env"):
         assert name in mint_sig.parameters
-    for legacy in ("target_project_id", "target_project_slug", "target_environment"):
+    for legacy in ("target_project_id", "target_project_slug", "target_environment", "use_shared"):
         assert legacy not in mint_sig.parameters
 
 
@@ -197,6 +206,21 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         env="production",
         limit=5,
     )
+    await namespace.repair_timeline_archive_manifests(
+        since="2026-04-01T00:00:00Z",
+        until="2026-04-02T00:00:00Z",
+    )
+    await namespace.verify_timeline_archive_manifests(
+        since="2026-04-01T00:00:00Z",
+        until="2026-04-02T00:00:00Z",
+    )
+    await namespace.prune_timeline_archive_retention(
+        since="2026-01-01T00:00:00Z",
+        until="2026-01-02T00:00:00Z",
+        retention_days=365,
+        dry_run=False,
+        confirm="DELETE_EXPIRED_ARCHIVE_OBJECTS",
+    )
 
     ensure_body = client.calls[0]["body"]
     assert ensure_body["app_slug"] == "carebridge"
@@ -255,6 +279,25 @@ 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]["method"] == "POST"
+    assert client.calls[10]["body"] == {
+        "since": "2026-04-01T00:00:00Z",
+        "until": "2026-04-02T00:00:00Z",
+    }
+    assert client.calls[11]["endpoint"] == "/api/authority/timelines/archive-verify"
+    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]["body"] == {
+        "since": "2026-01-01T00:00:00Z",
+        "until": "2026-01-02T00:00:00Z",
+        "retention_days": 365,
+        "dry_run": False,
+        "confirm": "DELETE_EXPIRED_ARCHIVE_OBJECTS",
+    }
 
 
 @pytest.mark.asyncio

{dominus_sdk_python-3.0.5 → dominus_sdk_python-4.0.1}/tests/test_logs.py

@@ -91,3 +91,58 @@ async def test_logs_get_archive_status_forwards_filters():
     )
     assert client.calls[0]["method"] == "GET"
     assert client.calls[0]["use_gateway"] is True
+
+
+@pytest.mark.asyncio
+async def test_logs_archive_maintenance_helpers_forward_canonical_body():
+    client = FakeClient()
+    namespace = LogsNamespace(client)
+
+    await namespace.repair_archive_manifests(
+        since="2026-04-01T00:00:00Z",
+        until="2026-04-02T00:00:00Z",
+        target_org_id="org-123",
+        target_env="production",
+        use_shared=True,
+    )
+    await namespace.verify_archive_manifests(
+        since="2026-04-01T00:00:00Z",
+        until="2026-04-02T00:00:00Z",
+        target_org_id="org-123",
+        target_env="production",
+        use_shared=True,
+    )
+    await namespace.prune_archive_retention(
+        since="2026-01-01T00:00:00Z",
+        until="2026-01-02T00:00:00Z",
+        retention_days=90,
+        dry_run=False,
+        confirm="DELETE_EXPIRED_ARCHIVE_OBJECTS",
+        target_org_id="org-123",
+        target_env="production",
+        use_shared=True,
+    )
+
+    assert client.calls[0]["endpoint"] == "/api/logs/archive-repair"
+    assert client.calls[0]["method"] == "POST"
+    assert client.calls[0]["body"] == {
+        "since": "2026-04-01T00:00:00Z",
+        "until": "2026-04-02T00:00:00Z",
+        "target_org_id": "org-123",
+        "target_env": "production",
+        "use_shared": True,
+    }
+    assert client.calls[1]["endpoint"] == "/api/logs/archive-verify"
+    assert client.calls[1]["body"]["target_org_id"] == "org-123"
+    assert client.calls[1]["body"]["use_shared"] is True
+    assert client.calls[2]["endpoint"] == "/api/logs/archive-prune"
+    assert client.calls[2]["body"] == {
+        "since": "2026-01-01T00:00:00Z",
+        "until": "2026-01-02T00:00:00Z",
+        "retention_days": 90,
+        "dry_run": False,
+        "confirm": "DELETE_EXPIRED_ARCHIVE_OBJECTS",
+        "target_org_id": "org-123",
+        "target_env": "production",
+        "use_shared": True,
+    }