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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.1
+Version: 4.0.3
 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: `4.0.1`
+- Current package version: `4.0.3`
 
 ## Install
 
@@ -79,7 +80,11 @@ 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)
+logs_archive = await dominus.logs.get_archive_status(
+    all_scopes=True,
+    include_buffer=True,
+    limit=5,
+)
 
 # Archive maintenance is explicit and dry-run first.
 verify = await dominus.authority.verify_timeline_archive_manifests(
@@ -90,6 +95,9 @@ prune = await dominus.logs.prune_archive_retention(
     retention_days=90,
     dry_run=True,
 )
+buffer_proof = await dominus.logs.dry_run_archive_buffer_maintenance(
+    sample_limit=100,
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.1 → dominus_sdk_python-4.0.3}/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: `4.0.1`
+- Current package version: `4.0.3`
 
 ## Install
 
@@ -46,7 +47,11 @@ 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)
+logs_archive = await dominus.logs.get_archive_status(
+    all_scopes=True,
+    include_buffer=True,
+    limit=5,
+)
 
 # Archive maintenance is explicit and dry-run first.
 verify = await dominus.authority.verify_timeline_archive_manifests(
@@ -57,6 +62,9 @@ prune = await dominus.logs.prune_archive_retention(
     retention_days=90,
     dry_run=True,
 )
+buffer_proof = await dominus.logs.dry_run_archive_buffer_maintenance(
+    sample_limit=100,
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.1 → dominus_sdk_python-4.0.3}/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)
@@ -510,6 +513,36 @@ class LogsNamespace:
             use_gateway=True,
         )
 
+    async def dry_run_archive_buffer_maintenance(
+        self,
+        *,
+        sample_limit: Optional[int] = None,
+        max_archive_buckets: Optional[int] = None,
+        target_org_id: Optional[str] = None,
+        target_env: Optional[str] = None,
+        use_shared: Optional[bool] = None,
+    ) -> Dict[str, Any]:
+        """Dry-run Redis archive buffer/payload residue cleanup proof. ``POST /api/logs/archive-buffer-maintenance``.
+
+        This is intentionally read-only. The Logs Worker rejects destructive
+        cleanup attempts on this route.
+        """
+        body = {
+            "dry_run": True,
+            "sample_limit": sample_limit,
+            "max_archive_buckets": max_archive_buckets,
+            "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-buffer-maintenance",
+            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.1 → dominus_sdk_python-4.0.3}/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.1 → dominus_sdk_python-4.0.3}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.1
+Version: 4.0.3
 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: `4.0.1`
+- Current package version: `4.0.3`
 
 ## Install
 
@@ -79,7 +80,11 @@ 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)
+logs_archive = await dominus.logs.get_archive_status(
+    all_scopes=True,
+    include_buffer=True,
+    limit=5,
+)
 
 # Archive maintenance is explicit and dry-run first.
 verify = await dominus.authority.verify_timeline_archive_manifests(
@@ -90,6 +95,9 @@ prune = await dominus.logs.prune_archive_retention(
     retention_days=90,
     dry_run=True,
 )
+buffer_proof = await dominus.logs.dry_run_archive_buffer_maintenance(
+    sample_limit=100,
+)
 ```
 
 ## Session-Scoped Clients

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

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

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

@@ -81,13 +81,14 @@ 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
@@ -122,6 +123,13 @@ async def test_logs_archive_maintenance_helpers_forward_canonical_body():
         target_env="production",
         use_shared=True,
     )
+    await namespace.dry_run_archive_buffer_maintenance(
+        sample_limit=25,
+        max_archive_buckets=3,
+        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"
@@ -146,3 +154,13 @@ async def test_logs_archive_maintenance_helpers_forward_canonical_body():
         "target_env": "production",
         "use_shared": True,
     }
+    assert client.calls[3]["endpoint"] == "/api/logs/archive-buffer-maintenance"
+    assert client.calls[3]["method"] == "POST"
+    assert client.calls[3]["body"] == {
+        "dry_run": True,
+        "sample_limit": 25,
+        "max_archive_buckets": 3,
+        "target_org_id": "org-123",
+        "target_env": "production",
+        "use_shared": True,
+    }

{dominus_sdk_python-4.0.1 → dominus_sdk_python-4.0.3}/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",