dominus-sdk-python 9.0.9__tar.gz → 9.0.11__tar.gz

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 9.0.9
+Version: 9.0.11
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -38,8 +38,8 @@ 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-09-07-1135-sdk-python/00-reading-order.md`; the latest
-cleanup audit is `docs/janitor/2026-09-07-1135-sdk-python-cleanup-audit.md`.
+`docs/agent-guide/2026-09-14-1300-sdk-python/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
 
 ## What This Repo Ships
 
@@ -48,7 +48,7 @@ cleanup audit is `docs/janitor/2026-09-07-1135-sdk-python-cleanup-audit.md`.
 - 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: `9.0.8`
+- Current package version: `9.0.11`
 
 ## Install
 

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/README.md

@@ -5,8 +5,8 @@ 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-09-07-1135-sdk-python/00-reading-order.md`; the latest
-cleanup audit is `docs/janitor/2026-09-07-1135-sdk-python-cleanup-audit.md`.
+`docs/agent-guide/2026-09-14-1300-sdk-python/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
 
 ## What This Repo Ships
 
@@ -15,7 +15,7 @@ cleanup audit is `docs/janitor/2026-09-07-1135-sdk-python-cleanup-audit.md`.
 - 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: `9.0.8`
+- Current package version: `9.0.11`
 
 ## Install
 

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/dominus/__init__.py

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

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/dominus/namespaces/ai.py

@@ -969,9 +969,10 @@ class AiNamespace(GatewayMixin):
         tool_allowlist: Optional[List[str]] = None,
         guardrails: Optional[Dict[str, Any]] = None,
         output_schema: Optional[Dict[str, Any]] = None,
-        model: str = "claude-sonnet-4-5",
+        model: Optional[str] = None,
         tool_endpoint: Optional[str] = None,
-        timeout: float = 300.0
+        timeout: float = 300.0,
+        provider: str = "claude"
     ) -> Dict[str, Any]:
         """
         Execute agent with blocking wait.
@@ -987,9 +988,10 @@ class AiNamespace(GatewayMixin):
             tool_allowlist: Optional list of tool names to enable
             guardrails: Optional guardrails config (max_steps, max_tool_calls, etc.)
             output_schema: Optional JSON Schema for structured output
-            model: Model to use (default: claude-sonnet-4-5)
+            model: Model to use (provider default when omitted)
             tool_endpoint: Optional custom tool endpoint URL
             timeout: Request timeout in seconds (default: 300s)
+            provider: Agent provider to use (default: claude)
 
         Returns:
             Dict with "conversation_id", "final_response", "machine_output",
@@ -1000,8 +1002,12 @@ class AiNamespace(GatewayMixin):
             "system_prompt": system_prompt,
             "user_prompt": user_prompt,
             "history_source": history_source,
-            "model": model
+            "provider": provider
         }
+        if model:
+            body["model"] = model
+        elif provider == "claude":
+            body["model"] = "claude-sonnet-4-5"
         if inline_history:
             body["inline_history"] = inline_history
         if preloaded_context:
@@ -1034,10 +1040,11 @@ class AiNamespace(GatewayMixin):
         tool_allowlist: Optional[List[str]] = None,
         guardrails: Optional[Dict[str, Any]] = None,
         output_schema: Optional[Dict[str, Any]] = None,
-        model: str = "claude-sonnet-4-5",
+        model: Optional[str] = None,
         tool_endpoint: Optional[str] = None,
         on_chunk: Optional[Callable[[Dict[str, Any]], None]] = None,
-        timeout: float = 300.0
+        timeout: float = 300.0,
+        provider: str = "claude"
     ) -> AsyncGenerator[Dict[str, Any], None]:
         """
         Execute agent with SSE streaming.
@@ -1053,10 +1060,11 @@ class AiNamespace(GatewayMixin):
             tool_allowlist: Optional list of tool names
             guardrails: Optional guardrails config
             output_schema: Optional JSON Schema for structured output
-            model: Model to use
+            model: Model to use (provider default when omitted)
             tool_endpoint: Optional custom tool endpoint URL
             on_chunk: Optional callback for each chunk
             timeout: Request timeout in seconds
+            provider: Agent provider to use (default: claude)
 
         Yields:
             Streaming chunks with "type" and content
@@ -1066,8 +1074,12 @@ class AiNamespace(GatewayMixin):
             "system_prompt": system_prompt,
             "user_prompt": user_prompt,
             "history_source": history_source,
-            "model": model
+            "provider": provider
         }
+        if model:
+            body["model"] = model
+        elif provider == "claude":
+            body["model"] = "claude-sonnet-4-5"
         if inline_history:
             body["inline_history"] = inline_history
         if preloaded_context:
@@ -1104,9 +1116,10 @@ class AiNamespace(GatewayMixin):
         tool_allowlist: Optional[List[str]] = None,
         guardrails: Optional[Dict[str, Any]] = None,
         output_schema: Optional[Dict[str, Any]] = None,
-        model: str = "claude-sonnet-4-5",
+        model: Optional[str] = None,
         tool_endpoint: Optional[str] = None,
-        webhook_url: Optional[str] = None
+        webhook_url: Optional[str] = None,
+        provider: str = "claude"
     ) -> Dict[str, Any]:
         """
         Fire-and-forget async execution.
@@ -1125,9 +1138,10 @@ class AiNamespace(GatewayMixin):
             tool_allowlist: Optional list of tool names
             guardrails: Optional guardrails config
             output_schema: Optional JSON Schema
-            model: Model to use
+            model: Model to use (provider default when omitted)
             tool_endpoint: Optional custom tool endpoint URL
             webhook_url: Optional webhook for completion notification
+            provider: Agent provider to use (default: claude)
 
         Returns:
             Dict with "result_key" for polling
@@ -1138,8 +1152,12 @@ class AiNamespace(GatewayMixin):
             "user_prompt": user_prompt,
             "result_key": result_key,
             "history_source": history_source,
-            "model": model
+            "provider": provider
         }
+        if model:
+            body["model"] = model
+        elif provider == "claude":
+            body["model"] = "claude-sonnet-4-5"
         if inline_history:
             body["inline_history"] = inline_history
         if preloaded_context:

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/dominus/namespaces/artifacts.py

@@ -624,11 +624,22 @@ class ArtifactsNamespace:
     async def unwatch(self, *, watcher_name: str, **selector: Any) -> Dict[str, Any]:
         return await self.unwatch_v2(watcher_name=watcher_name, **selector)
 
-    async def list_v2(self, limit: int = 100, include_tombstoned: bool = False, **selector: Any) -> Dict[str, Any]:
+    async def list_v2(
+        self,
+        limit: int = 100,
+        include_tombstoned: bool = False,
+        cursor: Optional[str] = None,
+        include_versions: bool = False,
+        **selector: Any,
+    ) -> Dict[str, Any]:
         body = self._selector_body(selector)
         body["limit"] = limit
         if include_tombstoned:
             body["include_tombstoned"] = True
+        if cursor:
+            body["cursor"] = cursor
+        if include_versions:
+            body["include_versions"] = True
         return await self._api("/api/artifact/v2/list", body=body)
 
     async def delete_v2(self, *, tombstone: bool = False, delete_bookmarks: bool = False, actor_context: Optional[Dict[str, str]] = None, **selector: Any) -> Dict[str, Any]:

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 9.0.9
+Version: 9.0.11
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -38,8 +38,8 @@ 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-09-07-1135-sdk-python/00-reading-order.md`; the latest
-cleanup audit is `docs/janitor/2026-09-07-1135-sdk-python-cleanup-audit.md`.
+`docs/agent-guide/2026-09-14-1300-sdk-python/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
 
 ## What This Repo Ships
 
@@ -48,7 +48,7 @@ cleanup audit is `docs/janitor/2026-09-07-1135-sdk-python-cleanup-audit.md`.
 - 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: `9.0.8`
+- Current package version: `9.0.11`
 
 ## Install
 

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/dominus_sdk_python.egg-info/SOURCES.txt

@@ -52,6 +52,8 @@ dominus_sdk_python.egg-info/SOURCES.txt
 dominus_sdk_python.egg-info/dependency_links.txt
 dominus_sdk_python.egg-info/requires.txt
 dominus_sdk_python.egg-info/top_level.txt
+tests/test_ai_namespace.py
+tests/test_artifacts_namespace.py
 tests/test_auth.py
 tests/test_authority_public_vocabulary.py
 tests/test_browser_namespace.py
@@ -75,5 +77,6 @@ tests/test_secrets_presence_contract.py
 tests/test_stash_artifact_facade.py
 tests/test_stash_tables_namespace.py
 tests/test_transport_compat.py
+tests/test_version_consistency.py
 tests/test_workflow_lifecycle.py
 tests/test_workflow_refs.py

{dominus_sdk_python-9.0.9 → dominus_sdk_python-9.0.11}/pyproject.toml

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

dominus_sdk_python-9.0.11/tests/test_ai_namespace.py

@@ -0,0 +1,75 @@
+import pytest
+
+from dominus.namespaces.ai import AiNamespace
+
+
+class FakeClient:
+    def __init__(self):
+        self.calls = []
+        self.stream_calls = []
+
+    async def _request(self, endpoint, method="POST", body=None, use_gateway=False):
+        self.calls.append(
+            {
+                "endpoint": endpoint,
+                "method": method,
+                "body": body,
+                "use_gateway": use_gateway,
+            }
+        )
+        return {"ok": True}
+
+    async def _stream_request(
+        self, endpoint, body=None, on_chunk=None, timeout=300.0, use_gateway=False
+    ):
+        self.stream_calls.append(
+            {
+                "endpoint": endpoint,
+                "body": body,
+                "timeout": timeout,
+                "use_gateway": use_gateway,
+            }
+        )
+        yield {"type": "complete"}
+
+
+@pytest.mark.asyncio
+async def test_agent_methods_forward_provider_to_each_agent_route():
+    client = FakeClient()
+    namespace = AiNamespace(client)
+
+    await namespace.run_agent(
+        "conv-1", "system", "user", provider="openai", model="gpt-4o"
+    )
+    [chunk async for chunk in namespace.stream_agent(
+        "conv-2", "system", "user", provider="openai", model="gpt-4o"
+    )]
+    await namespace.run_agent_async(
+        "conv-3",
+        "system",
+        "user",
+        "result-3",
+        provider="openai",
+        model="gpt-4o",
+    )
+
+    assert [call["body"]["provider"] for call in client.calls] == [
+        "openai",
+        "openai",
+    ]
+    assert client.stream_calls[0]["body"]["provider"] == "openai"
+
+
+@pytest.mark.asyncio
+async def test_provider_only_agent_call_leaves_model_for_server_default():
+    client = FakeClient()
+    namespace = AiNamespace(client)
+
+    await namespace.run_agent(
+        "conv-provider-only",
+        "system",
+        "user",
+        provider="openai",
+    )
+
+    assert "model" not in client.calls[0]["body"]

dominus_sdk_python-9.0.11/tests/test_artifacts_namespace.py

@@ -0,0 +1,93 @@
+import pytest
+
+import dominus.start as start_module
+
+
+@pytest.fixture()
+def sdk(monkeypatch):
+    monkeypatch.setattr(start_module, "_VALIDATION_ERROR", None)
+    monkeypatch.setattr(start_module, "_TOKEN", "a" * 64)
+    monkeypatch.setattr(start_module, "_VALIDATED", False)
+    monkeypatch.setattr(start_module, "_BASE_URL", "https://gateway.example")
+    monkeypatch.setattr(start_module, "_GATEWAY_URL", "https://gateway.example")
+    return start_module.Dominus()
+
+
+@pytest.mark.asyncio
+async def test_list_v2_forwards_cursor_and_include_versions(monkeypatch, sdk):
+    calls = []
+
+    async def fake_request(**kwargs):
+        calls.append(kwargs)
+        return {"artifacts": [], "count": 0, "total_size_bytes": 0, "next_cursor": "cursor-2"}
+
+    monkeypatch.setattr(sdk, "_request", fake_request)
+
+    result = await sdk.artifacts.list_v2(
+        cursor="cursor-1",
+        include_versions=True,
+        owner="project:00000000-0000-0000-0000-000000000000",
+    )
+
+    assert result["next_cursor"] == "cursor-2"
+    assert calls == [
+        {
+            "endpoint": "/api/artifact/v2/list",
+            "method": "POST",
+            "body": {
+                "owner": "project:00000000-0000-0000-0000-000000000000",
+                "limit": 100,
+                "cursor": "cursor-1",
+                "include_versions": True,
+            },
+            "use_gateway": True,
+            "timeout": 30.0,
+            "actor": None,
+        }
+    ]
+
+
+@pytest.mark.asyncio
+async def test_list_v2_omits_unset_cursor_and_include_versions(monkeypatch, sdk):
+    calls = []
+
+    async def fake_request(**kwargs):
+        calls.append(kwargs)
+        return {"artifacts": [], "count": 0, "total_size_bytes": 0, "next_cursor": None}
+
+    monkeypatch.setattr(sdk, "_request", fake_request)
+
+    await sdk.artifacts.list_v2(group="dominus", owner="project:p", environment="production", kind="legacy")
+
+    assert calls == [
+        {
+            "endpoint": "/api/artifact/v2/list",
+            "method": "POST",
+            "body": {
+                "group": "dominus",
+                "owner": "project:p",
+                "environment": "production",
+                "kind": "legacy",
+                "limit": 100,
+            },
+            "use_gateway": True,
+            "timeout": 30.0,
+            "actor": None,
+        }
+    ]
+
+
+@pytest.mark.asyncio
+async def test_list_v2_empty_cursor_is_not_forwarded(monkeypatch, sdk):
+    """An empty cursor is falsy and must not be sent: the worker rejects a malformed cursor with 400."""
+    calls = []
+
+    async def fake_request(**kwargs):
+        calls.append(kwargs)
+        return {"artifacts": [], "count": 0, "total_size_bytes": 0, "next_cursor": None}
+
+    monkeypatch.setattr(sdk, "_request", fake_request)
+
+    await sdk.artifacts.list_v2(cursor="", owner="project:p")
+
+    assert "cursor" not in calls[0]["body"]

dominus_sdk_python-9.0.11/tests/test_version_consistency.py

@@ -0,0 +1,38 @@
+"""Executable contract for Non-Negotiable #7: the two version authorities agree.
+
+`pyproject.toml` is what the production publish workflow stamps on the artifact
+(and what PyPI is queried with); `dominus/__init__.py` is what the installed
+package reports at runtime. When they drift, a production push publishes a
+package that misreports its own version. The drift has recurred twice
+(9.0.7/9.0.6, then 9.0.9/9.0.8), so it is asserted mechanically here.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import dominus
+
+ROOT = Path(__file__).resolve().parents[1]
+PYPROJECT = ROOT / "pyproject.toml"
+
+_VERSION_LINE = re.compile(r'^version\s*=\s*"([^"]+)"', re.MULTILINE)
+
+
+def _pyproject_version() -> str:
+    raw = PYPROJECT.read_bytes()
+    try:
+        import tomllib
+    except ModuleNotFoundError:  # Python 3.9/3.10
+        match = _VERSION_LINE.search(raw.decode("utf-8"))
+        assert match is not None, "pyproject.toml declares no [project] version"
+        return match.group(1)
+    return tomllib.loads(raw.decode("utf-8"))["project"]["version"]
+
+
+def test_pyproject_and_package_version_match() -> None:
+    assert _pyproject_version() == dominus.__version__, (
+        "pyproject.toml and dominus/__init__.py versions have drifted: "
+        f"pyproject={_pyproject_version()!r}, dominus.__version__={dominus.__version__!r}"
+    )