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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.3
+Version: 4.0.5
 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.3`
+- Current package version: `4.0.5`
 
 ## Install
 
@@ -98,6 +98,15 @@ prune = await dominus.logs.prune_archive_retention(
 buffer_proof = await dominus.logs.dry_run_archive_buffer_maintenance(
     sample_limit=100,
 )
+buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
+    dry_run=False,
+    confirm="DELETE_ARCHIVE_BUFFER_RESIDUE",
+    salvage_missing_archive=True,
+    sample_limit=500,
+    max_archive_buckets=24,
+    batch_runs=5,
+    max_runtime_ms=8000,
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.3 → dominus_sdk_python-4.0.5}/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.3`
+- Current package version: `4.0.5`
 
 ## Install
 
@@ -65,6 +65,15 @@ prune = await dominus.logs.prune_archive_retention(
 buffer_proof = await dominus.logs.dry_run_archive_buffer_maintenance(
     sample_limit=100,
 )
+buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
+    dry_run=False,
+    confirm="DELETE_ARCHIVE_BUFFER_RESIDUE",
+    salvage_missing_archive=True,
+    sample_limit=500,
+    max_archive_buckets=24,
+    batch_runs=5,
+    max_runtime_ms=8000,
+)
 ```
 
 ## Session-Scoped Clients

{dominus_sdk_python-4.0.3 → dominus_sdk_python-4.0.5}/dominus/__init__.py

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

{dominus_sdk_python-4.0.3 → dominus_sdk_python-4.0.5}/dominus/namespaces/logs.py

@@ -513,24 +513,41 @@ class LogsNamespace:
             use_gateway=True,
         )
 
-    async def dry_run_archive_buffer_maintenance(
+    async def run_archive_buffer_maintenance(
         self,
         *,
+        dry_run: bool = True,
+        confirm: Optional[str] = None,
+        all_scopes: Optional[bool] = None,
+        max_scopes: Optional[int] = None,
+        salvage_missing_archive: Optional[bool] = None,
         sample_limit: Optional[int] = None,
         max_archive_buckets: Optional[int] = None,
+        batch_runs: Optional[int] = None,
+        stop_when_payload_fields_at_or_below: Optional[int] = None,
+        max_runtime_ms: 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``.
+        """Dry-run or enforce Redis archive buffer/payload residue cleanup. ``POST /api/logs/archive-buffer-maintenance``.
 
-        This is intentionally read-only. The Logs Worker rejects destructive
-        cleanup attempts on this route.
+        Destructive cleanup requires ``dry_run=False`` and
+        ``confirm='DELETE_ARCHIVE_BUFFER_RESIDUE'``. ``batch_runs`` and
+        ``max_runtime_ms`` are bounded by the Logs Worker so callers can run
+        confirmed salvage in safe chunks.
         """
         body = {
-            "dry_run": True,
+            "dry_run": dry_run,
+            "confirm": confirm,
+            "all_scopes": all_scopes,
+            "max_scopes": max_scopes,
+            "salvage_missing_archive": salvage_missing_archive,
             "sample_limit": sample_limit,
             "max_archive_buckets": max_archive_buckets,
+            "batch_runs": batch_runs,
+            "stop_when_payload_fields_at_or_below": stop_when_payload_fields_at_or_below,
+            "max_runtime_ms": max_runtime_ms,
             "target_org_id": target_org_id,
             "target_env": target_env,
         }
@@ -543,6 +560,35 @@ class LogsNamespace:
             use_gateway=True,
         )
 
+    async def dry_run_archive_buffer_maintenance(
+        self,
+        *,
+        all_scopes: Optional[bool] = None,
+        max_scopes: Optional[int] = None,
+        sample_limit: Optional[int] = None,
+        max_archive_buckets: Optional[int] = None,
+        batch_runs: Optional[int] = None,
+        stop_when_payload_fields_at_or_below: Optional[int] = None,
+        max_runtime_ms: 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."""
+        return await self.run_archive_buffer_maintenance(
+            dry_run=True,
+            all_scopes=all_scopes,
+            max_scopes=max_scopes,
+            sample_limit=sample_limit,
+            max_archive_buckets=max_archive_buckets,
+            batch_runs=batch_runs,
+            stop_when_payload_fields_at_or_below=stop_when_payload_fields_at_or_below,
+            max_runtime_ms=max_runtime_ms,
+            target_org_id=target_org_id,
+            target_env=target_env,
+            use_shared=use_shared,
+        )
+
     async def query(
         self,
         minutes: int = 10,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.0.3
+Version: 4.0.5
 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.3`
+- Current package version: `4.0.5`
 
 ## Install
 
@@ -98,6 +98,15 @@ prune = await dominus.logs.prune_archive_retention(
 buffer_proof = await dominus.logs.dry_run_archive_buffer_maintenance(
     sample_limit=100,
 )
+buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
+    dry_run=False,
+    confirm="DELETE_ARCHIVE_BUFFER_RESIDUE",
+    salvage_missing_archive=True,
+    sample_limit=500,
+    max_archive_buckets=24,
+    batch_runs=5,
+    max_runtime_ms=8000,
+)
 ```
 
 ## Session-Scoped Clients

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

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

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

@@ -130,6 +130,21 @@ async def test_logs_archive_maintenance_helpers_forward_canonical_body():
         target_env="production",
         use_shared=True,
     )
+    await namespace.run_archive_buffer_maintenance(
+        dry_run=False,
+        confirm="DELETE_ARCHIVE_BUFFER_RESIDUE",
+        all_scopes=True,
+        max_scopes=1,
+        salvage_missing_archive=True,
+        sample_limit=500,
+        max_archive_buckets=24,
+        batch_runs=5,
+        stop_when_payload_fields_at_or_below=145000,
+        max_runtime_ms=8000,
+        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"
@@ -164,3 +179,20 @@ async def test_logs_archive_maintenance_helpers_forward_canonical_body():
         "target_env": "production",
         "use_shared": True,
     }
+    assert client.calls[4]["endpoint"] == "/api/logs/archive-buffer-maintenance"
+    assert client.calls[4]["method"] == "POST"
+    assert client.calls[4]["body"] == {
+        "dry_run": False,
+        "confirm": "DELETE_ARCHIVE_BUFFER_RESIDUE",
+        "all_scopes": True,
+        "max_scopes": 1,
+        "salvage_missing_archive": True,
+        "sample_limit": 500,
+        "max_archive_buckets": 24,
+        "batch_runs": 5,
+        "stop_when_payload_fields_at_or_below": 145000,
+        "max_runtime_ms": 8000,
+        "target_org_id": "org-123",
+        "target_env": "production",
+        "use_shared": True,
+    }