dominus-sdk-python 4.0.0__tar.gz → 4.0.2__tar.gz

{dominus_sdk_python-4.0.0 → dominus_sdk_python-4.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.0
+Version: 4.0.2
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -40,8 +40,9 @@ Async Python SDK for the Dominus gateway-first service plane.
 - Python 3.9+ asyncio client for Dominus services
 - Namespace-first API with a small root shortcut surface
 - 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: `3.0.5`
+- Current package version: `4.0.2`
 
 ## Install
 
@@ -74,6 +75,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-4.0.0 → dominus_sdk_python-4.0.2}/README.md

@@ -7,8 +7,9 @@ Async Python SDK for the Dominus gateway-first service plane.
 - Python 3.9+ asyncio client for Dominus services
 - Namespace-first API with a small root shortcut surface
 - 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: `3.0.5`
+- Current package version: `4.0.2`
 
 ## Install
 
@@ -41,6 +42,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-4.0.0 → dominus_sdk_python-4.0.2}/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-4.0.0 → dominus_sdk_python-4.0.2}/dominus/namespaces/logs.py

@@ -407,6 +407,7 @@ class LogsNamespace:
         target_org_id: Optional[str] = None,
         target_env: Optional[str] = None,
         use_shared: Optional[bool] = None,
+        include_buffer: Optional[bool] = None,
         limit: Optional[int] = None,
     ) -> Dict[str, Any]:
         """Get Logs Worker archive backlog state. ``GET /api/logs/archive-status``."""
@@ -419,6 +420,8 @@ class LogsNamespace:
             params["target_env"] = target_env
         if use_shared is True:
             params["use_shared"] = "true"
+        if include_buffer is not None:
+            params["include_buffer"] = "true" if include_buffer else "false"
         if limit is not None:
             params["limit"] = limit
         qs = urlencode(params)
@@ -429,6 +432,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-4.0.0 → dominus_sdk_python-4.0.2}/dominus/start.py

@@ -468,8 +468,12 @@ class Dominus:
 
         result = _decode_json_or_b64_json(response.text)
 
-        # Check for success
-        if not result.get("success"):
+        if not isinstance(result, dict):
+            return {"result": result}
+
+        # Kernel routes historically returned {success,data}; some modern
+        # Warden control-plane routes return a decoded domain object directly.
+        if result.get("success") is False:
             error_msg = result.get("error") or result.get("message") or "Unknown error"
             error_details = result.get("details")
             if not isinstance(error_details, dict):
@@ -479,7 +483,11 @@ class Dominus:
                     error_details[key] = result[key]
             raise DominusError(str(error_msg), details=error_details, endpoint=endpoint)
 
-        return result.get("data", {})
+        if result.get("success") is True:
+            return result.get("data", {})
+        if "data" in result and len(result) <= 3:
+            return result.get("data", {})
+        return result
 
     async def gateway_fetch(
         self,

{dominus_sdk_python-4.0.0 → dominus_sdk_python-4.0.2}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.0
+Version: 4.0.2
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -40,8 +40,9 @@ Async Python SDK for the Dominus gateway-first service plane.
 - Python 3.9+ asyncio client for Dominus services
 - Namespace-first API with a small root shortcut surface
 - 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: `3.0.5`
+- Current package version: `4.0.2`
 
 ## Install
 
@@ -74,6 +75,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-4.0.0 → dominus_sdk_python-4.0.2}/pyproject.toml

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

{dominus_sdk_python-4.0.0 → dominus_sdk_python-4.0.2}/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,6 +107,12 @@ 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
@@ -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-4.0.0 → dominus_sdk_python-4.0.2}/tests/test_logs.py

@@ -81,13 +81,69 @@ async def test_logs_get_archive_status_forwards_filters():
         target_org_id="org-123",
         target_env="production",
         use_shared=True,
+        include_buffer=True,
         limit=5,
     )
 
     assert payload["events"][0]["event_id"] == "log-1"
     assert client.calls[0]["endpoint"] == (
         "/api/logs/archive-status?"
-        "all_scopes=true&target_org_id=org-123&target_env=production&use_shared=true&limit=5"
+        "all_scopes=true&target_org_id=org-123&target_env=production&use_shared=true&include_buffer=true&limit=5"
     )
     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,
+    }

{dominus_sdk_python-4.0.0 → dominus_sdk_python-4.0.2}/tests/test_transport_compat.py

@@ -55,6 +55,32 @@ class RequestClient:
         return FakeResponse(json.dumps({"success": True, "data": {"ok": True}}))
 
 
+class UnwrappedRequestClient:
+    calls = []
+
+    def __init__(self, *, base_url, headers, timeout):
+        self.base_url = base_url
+        self.headers = headers
+        self.timeout = timeout
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb):
+        return False
+
+    async def get(self, endpoint):
+        self.calls.append(
+            {
+                "endpoint": endpoint,
+                "base_url": self.base_url,
+                "headers": self.headers,
+                "timeout": self.timeout,
+            }
+        )
+        return FakeResponse(json.dumps({"secret": {"key": "PROVISION_REDIS_URL_REST", "value": "redis-url"}}))
+
+
 class ServiceJwtClient:
     def __init__(self, *, base_url, headers, timeout, proxy):
         self.base_url = base_url
@@ -132,6 +158,22 @@ async def test_request_accepts_raw_json_success_envelope(monkeypatch, sdk):
     assert RequestClient.calls[0]["endpoint"] == "/svc/health"
 
 
+@pytest.mark.asyncio
+async def test_request_accepts_unwrapped_control_plane_success(monkeypatch, sdk):
+    UnwrappedRequestClient.calls = []
+
+    async def fake_ensure_valid_jwt(psk_token, base_url):
+        return "jwt-abc"
+
+    monkeypatch.setattr(core_module, "_ensure_valid_jwt", fake_ensure_valid_jwt)
+    monkeypatch.setattr(start_module.httpx, "AsyncClient", UnwrappedRequestClient)
+
+    result = await sdk._request("/api/warden/secrets/PROVISION_REDIS_URL_REST", method="GET", use_gateway=True)
+
+    assert result == {"secret": {"key": "PROVISION_REDIS_URL_REST", "value": "redis-url"}}
+    assert UnwrappedRequestClient.calls[0]["endpoint"] == "/svc/warden/secrets/PROVISION_REDIS_URL_REST"
+
+
 def test_dominus_constructor_accepts_gateway_context_keywords():
     sdk = start_module.Dominus(
         gateway_user_token="user-jwt",