dominus-sdk-python 6.3.0__tar.gz → 7.1.0__tar.gz

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 6.3.0
+Version: 7.1.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -35,6 +35,12 @@ Requires-Dist: PyJWT>=2.8.0; extra == "all"
 
 Async Python SDK for the Dominus gateway-first service plane.
 
+## Agent Guide
+
+Start with `docs/agent-guide/INDEX.md`. The current snapshot is
+`docs/agent-guide/2026-06-27-0849-agent-guide/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-06-27-0849-agent-guide-cleanup-audit.md`.
+
 ## What This Repo Ships
 
 - Python 3.9+ asyncio client for Dominus services
@@ -42,7 +48,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: `6.1.1`
+- Current package version: `7.1.0`
 
 ## Install
 
@@ -135,6 +141,54 @@ buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
 schedules = await dominus.authority.list_schedules(all_scopes=True)
 ```
 
+## Stash Managed Tables
+
+`dominus.stash.tables` provides a typed client for small, scoped JSONB tables
+without exposing SQL. Every call requires `env`, `scope` (`self` or `group`),
+and `table`; self and group tables resolve to independent project and shared
+databases.
+
+```python
+spec = await dominus.stash.tables.define(
+    env="production",
+    scope="self",
+    table="jobs",
+    if_revision=0,
+    primary_key={"field": "id", "generate": "uuid"},
+    fields={
+        "id": {"type": "uuid", "required": True},
+        "status": {"type": "string", "required": True},
+        "priority": {"type": "integer"},
+    },
+)
+
+row = await dominus.stash.tables.put_row(
+    env="production",
+    scope="self",
+    table="jobs",
+    if_revision=0,
+    row={"status": "queued", "priority": 5},
+)
+
+page = await dominus.stash.tables.select(
+    env="production",
+    scope="self",
+    table="jobs",
+    where={
+        "or": [
+            {"field": "status", "op": "eq", "value": "queued"},
+            {"field": "priority", "op": "gte", "value": 5},
+        ]
+    },
+    page_size=50,
+)
+```
+
+Use `if_revision` for table definitions and single-row put/delete compare-and-
+swap. `update_where` instead requires `if_spec_revision` and `max_affected`.
+Cursors are opaque keyset tokens. `delete_row` is a hard delete and returns a
+durable mutation receipt; there is no soft-delete or restore lifecycle.
+
 ## Browser Automation
 
 `dominus.browser` exposes the first-class Dominus browser automation primitive through authenticated gateway routes under `/svc/browser/*`. SDK methods use `/api/browser/*` internally with gateway routing enabled; worker-local routes remain `/health` and `/runs/*`.
@@ -223,6 +277,9 @@ JWT and selected scope headers directly through Gateway.
 | `warden` | Warden | Thin operator control-plane request surface |
 | `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
 | `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
+| `publisher` | Publisher | Release/channel/signing build and artifact operations |
+| `stash` | Stash | Items, managed tables, kinds, bookmarks, watches, artifact facade |
+| `recipes` | Recipe Worker | Recipe type registry, publish, validate, get/list |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.1.0}/README.md

@@ -2,6 +2,12 @@
 
 Async Python SDK for the Dominus gateway-first service plane.
 
+## Agent Guide
+
+Start with `docs/agent-guide/INDEX.md`. The current snapshot is
+`docs/agent-guide/2026-06-27-0849-agent-guide/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-06-27-0849-agent-guide-cleanup-audit.md`.
+
 ## What This Repo Ships
 
 - Python 3.9+ asyncio client for Dominus services
@@ -9,7 +15,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: `6.1.1`
+- Current package version: `7.1.0`
 
 ## Install
 
@@ -102,6 +108,54 @@ buffer_cleanup = await dominus.logs.run_archive_buffer_maintenance(
 schedules = await dominus.authority.list_schedules(all_scopes=True)
 ```
 
+## Stash Managed Tables
+
+`dominus.stash.tables` provides a typed client for small, scoped JSONB tables
+without exposing SQL. Every call requires `env`, `scope` (`self` or `group`),
+and `table`; self and group tables resolve to independent project and shared
+databases.
+
+```python
+spec = await dominus.stash.tables.define(
+    env="production",
+    scope="self",
+    table="jobs",
+    if_revision=0,
+    primary_key={"field": "id", "generate": "uuid"},
+    fields={
+        "id": {"type": "uuid", "required": True},
+        "status": {"type": "string", "required": True},
+        "priority": {"type": "integer"},
+    },
+)
+
+row = await dominus.stash.tables.put_row(
+    env="production",
+    scope="self",
+    table="jobs",
+    if_revision=0,
+    row={"status": "queued", "priority": 5},
+)
+
+page = await dominus.stash.tables.select(
+    env="production",
+    scope="self",
+    table="jobs",
+    where={
+        "or": [
+            {"field": "status", "op": "eq", "value": "queued"},
+            {"field": "priority", "op": "gte", "value": 5},
+        ]
+    },
+    page_size=50,
+)
+```
+
+Use `if_revision` for table definitions and single-row put/delete compare-and-
+swap. `update_where` instead requires `if_spec_revision` and `max_affected`.
+Cursors are opaque keyset tokens. `delete_row` is a hard delete and returns a
+durable mutation receipt; there is no soft-delete or restore lifecycle.
+
 ## Browser Automation
 
 `dominus.browser` exposes the first-class Dominus browser automation primitive through authenticated gateway routes under `/svc/browser/*`. SDK methods use `/api/browser/*` internally with gateway routing enabled; worker-local routes remain `/health` and `/runs/*`.
@@ -190,6 +244,9 @@ JWT and selected scope headers directly through Gateway.
 | `warden` | Warden | Thin operator control-plane request surface |
 | `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
 | `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
+| `publisher` | Publisher | Release/channel/signing build and artifact operations |
+| `stash` | Stash | Items, managed tables, kinds, bookmarks, watches, artifact facade |
+| `recipes` | Recipe Worker | Recipe type registry, publish, validate, get/list |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.1.0}/dominus/__init__.py

@@ -115,6 +115,7 @@ from .namespaces.warden import WardenNamespace
 from .namespaces.platform import PlatformNamespace
 from .namespaces.coder import CoderNamespace
 from .namespaces.publisher import PublisherNamespace
+from .namespaces.stash import StashNamespace, StashTablesNamespace
 
 # Export AI namespace for agent-runtime operations
 from .namespaces.ai import (
@@ -172,7 +173,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "6.3.0"
+__version__ = "7.1.0"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -226,6 +227,8 @@ __all__ = [
     "PlatformNamespace",
     "CoderNamespace",
     "PublisherNamespace",
+    "StashNamespace",
+    "StashTablesNamespace",
     # AI namespace for agent-runtime operations
     "AiNamespace",
     "RagSubNamespace",

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.1.0}/dominus/namespaces/__init__.py

@@ -21,6 +21,8 @@ from .deployer import DeployerNamespace
 from .warden import WardenNamespace
 from .platform import PlatformNamespace
 from .coder import CoderNamespace
+from .publisher import PublisherNamespace
+from .stash import StashNamespace, StashTablesNamespace
 from .ai import (
     AiNamespace,
     RagSubNamespace,
@@ -52,6 +54,9 @@ __all__ = [
     "WardenNamespace",
     "PlatformNamespace",
     "CoderNamespace",
+    "PublisherNamespace",
+    "StashNamespace",
+    "StashTablesNamespace",
     "AiNamespace",
     "RagSubNamespace",
     "ArtifactsSubNamespace",

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.1.0}/dominus/namespaces/authority.py

@@ -3,7 +3,7 @@ Authority Namespace - Dominus Authority service surface.
 
 Canonical SDK entry point for the dominus-authority service. Mirrors the MCP
 ``authority_*`` tool surface so application code can drive runs, provisioning
-targets, deploys, managed clients, timelines, dossiers, and Authority context resolution
+targets, deploys, managed clients, timelines, verdicts, and Authority context resolution
 without touching workflow-manager / client-worker / deploy-worker routes
 directly.
 
@@ -13,7 +13,7 @@ All methods route through the gateway (``use_gateway=True``) which maps
 Run launch is also exposed as ``dominus.workflow.ensure(...)``. Both call
 ``/api/authority/runs/ensure``. Use ``dominus.workflow.ensure`` for the
 canonical recipe-backed launch path; use ``dominus.authority.ensure_run`` when
-you want to think in Authority terms (run lifecycle, run dossiers, retries,
+you want to think in Authority terms (run lifecycle, verdicts, retries,
 cancels).
 """
 from __future__ import annotations
@@ -74,7 +74,7 @@ class AuthorityNamespace:
             subject="PCM47474562",
         )
         await dominus.authority.list_provisioning_targets()
-        await dominus.authority.get_run_dossier(run_id)
+        await dominus.authority.get_run_verdict(run_id)
     """
 
     def __init__(self, client: "Dominus"):
@@ -489,27 +489,17 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_run_dossier(
+    async def get_run_verdict(
         self,
         run_id: str,
         *,
-        since: Optional[str] = None,
-        until: Optional[str] = None,
-        window_hours: Optional[int] = None,
-        limit: Optional[int] = None,
         timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
-        """Get the full Authority dossier for a run. ``GET /api/authority/dossiers/run/{run_id}``."""
+        """Get the compact Authority verdict for a run. ``GET /api/authority/runs/{run_id}/verdict``."""
         if not run_id:
             raise ValueError("run_id is required")
-        qs = _query_string({
-            "since": since,
-            "until": until,
-            "window_hours": window_hours,
-            "limit": limit,
-        })
         return await self._get(
-            f"/api/authority/dossiers/run/{quote(run_id, safe='')}{qs}",
+            f"/api/authority/runs/{quote(run_id, safe='')}/verdict",
             timeout=self._http_timeout(timeout, 30.0),
         )
 
@@ -984,39 +974,6 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_provisioning_target_dossier(
-        self,
-        provisioning_target_slug: str,
-        *,
-        app_slug: Optional[str] = None,
-        env: Optional[str] = None,
-        target_org_id: Optional[str] = None,
-        target_env: Optional[str] = None,
-        since: Optional[str] = None,
-        until: Optional[str] = None,
-        window_hours: Optional[int] = None,
-        limit: Optional[int] = None,
-        timeout: Optional[float] = None,
-    ) -> Dict[str, Any]:
-        """Get full Authority dossier for a provisioning target. ``GET /api/authority/dossiers/provisioning-target/{provisioning_target_slug}``."""
-        if not provisioning_target_slug:
-            raise ValueError("provisioning_target_slug is required")
-        tid, tev = self._target_query_params(target_org_id, target_env)
-        qs = _query_string({
-            "app_slug": app_slug,
-            "env": env,
-            "target_org_id": tid,
-            "target_env": tev,
-            "since": since,
-            "until": until,
-            "window_hours": window_hours,
-            "limit": limit,
-        })
-        return await self._get(
-            f"/api/authority/dossiers/provisioning-target/{quote(provisioning_target_slug, safe='')}{qs}",
-            timeout=self._http_timeout(timeout, 30.0),
-        )
-
     # ==================================================================
     # Deploys
     # ==================================================================
@@ -1147,36 +1104,20 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_deploy_dossier(
+    async def get_deploy_verdict(
         self,
         deploy_id: str,
         *,
-        since: Optional[str] = None,
-        until: Optional[str] = None,
-        window_hours: Optional[int] = None,
-        limit: Optional[int] = None,
-        full: bool = False,
         timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
         """
-        Get the full Authority dossier for a deploy.
-        ``GET /api/authority/dossiers/deploy/{deploy_id}``.
-
-        Mirrors the MCP ``authority_get_deploy_dossier`` tool. If the dossier
-        route is not yet enabled in dominus-authority the gateway will return
-        404 — the SDK surface is intentionally aligned with MCP.
+        Get the compact Authority verdict for a deploy.
+        ``GET /api/authority/deploys/{deploy_id}/verdict``.
         """
         if not deploy_id:
             raise ValueError("deploy_id is required")
-        qs = _query_string({
-            "since": since,
-            "until": until,
-            "window_hours": window_hours,
-            "limit": limit,
-            "full": 1 if full else None,
-        })
         return await self._get(
-            f"/api/authority/dossiers/deploy/{quote(deploy_id, safe='')}{qs}",
+            f"/api/authority/deploys/{quote(deploy_id, safe='')}/verdict",
             timeout=self._http_timeout(timeout, 30.0),
         )