dominus-sdk-python 4.3.0__py3-none-any.whl → 4.5.0__py3-none-any.whl

dominus/__init__.py

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

dominus/namespaces/browser.py

@@ -98,7 +98,16 @@ class BrowserNamespace:
         Ensure a browser run. ``POST /api/browser/runs/ensure``.
 
         Browser run metadata remains browser-worker runtime state. Artifact V2
-        is only used by the worker for sanitized result/capture payloads.
+        is used for sanitized `browser-run` result payloads and, when opted-in
+        via ``capture_policy["storage_state"] = "always"`` plus
+        ``auth_ref["session_slot_id"]``, for captured Playwright storage_state
+        in the separate ``browser-session`` category. Captured values are
+        never returned inline; only the artifact ref appears on the result
+        envelope as ``result_summary.captured_session_artifact_ref``.
+
+        Reuse a captured session by passing the same ``session_slot_id`` (slot
+        lookup, returns no storage_state on first call) or an explicit
+        ``session_artifact_ref`` (hard-error if the ref does not exist).
         """
         if not target:
             raise ValueError("target is required")

dominus/namespaces/redis.py

@@ -575,3 +575,120 @@ class RedisNamespace:
             body=body,
             use_gateway=True,
         )
+
+    async def xadd(
+        self,
+        key: str,
+        fields: Dict[str, Any],
+        id: Optional[str] = None,
+        maxlen: Optional[int] = None,
+        ttl: Optional[int] = None,
+        category: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Append an entry to a Redis stream.
+
+        Backed by the native dominus-redis-worker /xadd route added 2026-05-09.
+        Each field value is independently size-guarded (1 MiB cap per encoded
+        value). Use streams for log-style state that scales with iteration
+        count (agent step events, audit trails). Replaces RedisWorkerProjectCompat
+        shim emulation that did SET/GET whole-collection rewrites.
+
+        Args:
+            key: Stream key (logical_path)
+            fields: Field/value dict for the new entry
+            id: Optional explicit ID. Defaults to ``*`` (server-generated
+                ``<ms>-<seq>``). Returned in the response so callers can use
+                it for downstream xrange resume-after pagination.
+            maxlen: Optional MAXLEN cap. When set, redis-worker calls XADD
+                with MAXLEN ~ N (approximate trim).
+            ttl: Optional TTL in seconds (default uses worker default 3600).
+            category: Optional namespace category (default ``streams``).
+
+        Returns:
+            Dict with {"key", "id", "ttl_seconds"}
+        """
+        body: Dict[str, Any] = {
+            "logical_path": key,
+            "fields": fields,
+        }
+        if id:
+            body["id"] = id
+        if maxlen is not None:
+            body["maxlen"] = maxlen
+        if ttl is not None:
+            body["ttl_seconds"] = ttl
+        if category:
+            body["category"] = category
+        return await self._client._request(
+            endpoint="/api/redis/xadd",
+            body=body,
+            use_gateway=True,
+        )
+
+    async def xrange(
+        self,
+        key: str,
+        min: str = "-",
+        max: str = "+",
+        count: Optional[int] = None,
+        category: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Read entries from a Redis stream in id order.
+
+        Backed by /xrange added 2026-05-09. Pass ``-``/``+`` (default) for
+        the full range or explicit ``<ms>-<seq>`` ids for resume-after
+        pagination.
+
+        Args:
+            key: Stream key (logical_path)
+            min: Inclusive lower bound id, ``-`` for oldest.
+            max: Inclusive upper bound id, ``+`` for newest.
+            count: Optional COUNT cap.
+            category: Optional namespace category (default ``streams``).
+
+        Returns:
+            Dict with {"found", "entries": [{"id", "fields"}, ...], "count"}
+        """
+        body: Dict[str, Any] = {
+            "logical_path": key,
+            "min": min,
+            "max": max,
+        }
+        if count is not None:
+            body["count"] = count
+        if category:
+            body["category"] = category
+        return await self._client._request(
+            endpoint="/api/redis/xrange",
+            body=body,
+            use_gateway=True,
+        )
+
+    async def xlen(
+        self,
+        key: str,
+        category: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Stream entry count.
+
+        Backed by /xlen added 2026-05-09. Approximate on streams with
+        deletions; exact otherwise.
+
+        Args:
+            key: Stream key (logical_path)
+            category: Optional namespace category (default ``streams``).
+
+        Returns:
+            Dict with {"length"}
+        """
+        body: Dict[str, Any] = {"logical_path": key}
+        if category:
+            body["category"] = category
+        return await self._client._request(
+            endpoint="/api/redis/xlen",
+            body=body,
+            use_gateway=True,
+        )

{dominus_sdk_python-4.3.0.dist-info → dominus_sdk_python-4.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 4.3.0
+Version: 4.5.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary

{dominus_sdk_python-4.3.0.dist-info → dominus_sdk_python-4.5.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-dominus/__init__.py,sha256=7zVX4jREUdY9TScFlc93aLsvMCcal0ZVT3R_kOUVFCY,6997
+dominus/__init__.py,sha256=9dUf_NR4QxzaUUK7qpaliliDKq3Q65KC-S9Y2_RdsCo,6997
 dominus/errors.py,sha256=NthcR-o1Q1nQsE3ZSHStcW_RdZ8LQ06mPDSenY1txgM,8547
 dominus/start.py,sha256=_VxLodIPbbY3eDgxDAtkrvGYXctKXOS8RDErRM8JWbc,49468
 dominus/config/__init__.py,sha256=nvLLNh4dM_MCqcfF3XFS2NnVn44q0RYHEfAPP-2G5To,434
@@ -17,7 +17,7 @@ dominus/namespaces/ai.py,sha256=Kr_eY-SkEfC-b1fhVVv40pXn_GHkxRzMGD47WoTgu9M,4855
 dominus/namespaces/artifacts.py,sha256=MgjkjSmUP_5XGTAFU2UQ1VU3Vju3kVuvDqxChosP2J0,22246
 dominus/namespaces/auth.py,sha256=YA61WjeRewatrz6BTPhRC95jDgYk3b2QDlH0xdGUceg,67795
 dominus/namespaces/authority.py,sha256=vfXNc6A-eAeOzSuyMpBmkWjUvFVXvuelrn3O9YcIY9E,76874
-dominus/namespaces/browser.py,sha256=EM5Y1t7ezxYSPHdS3xo-jI7dSOFb_etS20EBdUyMR90,7277
+dominus/namespaces/browser.py,sha256=_epZQbCQKUP66CnXJLvccZGJd5TVqMy8nGpscwrqTaE,7868
 dominus/namespaces/courier.py,sha256=7ZuwTWzVGBPTnqPV1VqPdme6PkPyhQOddwaI1wxrlE8,8324
 dominus/namespaces/db.py,sha256=dv4IZACziub7OE8i_4q_Z31uVYJglE12TFkFIbFnYjw,15157
 dominus/namespaces/ddl.py,sha256=NTpd3V3595qcBheUZfFq4tQiAZsyYH9O8GR9OZ_czK8,25844
@@ -29,14 +29,14 @@ dominus/namespaces/jobs.py,sha256=YdiTzajUWtpdhk_jJhOlF0EeFegaRQFiszGSsFLs-Dc,54
 dominus/namespaces/logs.py,sha256=uM3yDU2YsqEqOt9eg1I9JyHZdHrFxSQahbknTLhmw_U,22102
 dominus/namespaces/portal.py,sha256=vf0Vu_12yS4_fto7sVCau5vQtghml7Wh7J2-XJnO2zA,15595
 dominus/namespaces/processor.py,sha256=gk-vvWfBTU9LkV34OaB4VdftArhTE67tfhlUtY0YglI,2678
-dominus/namespaces/redis.py,sha256=46-j-yXaS5Od0dGl6D7r5Cp3fLDiQeM6Rlzsn9TCfsc,15508
+dominus/namespaces/redis.py,sha256=1joYhewLGdN4-OCYJu5rvhsF5yORUUfVtBrgjzLKAzs,19337
 dominus/namespaces/secrets.py,sha256=od8AKgENwW6U-kVfIX3DSphXKeJA6XC-SxbGqsxhhUk,6253
 dominus/namespaces/secure.py,sha256=9idGY5R6k7b-JM1SAF_1Gt-YV5OempyxFBflgLJieLo,7168
 dominus/namespaces/sync.py,sha256=mGwMNwc_iWoKgS94n1staPdsKBHNvliMG7omokl7Qmk,2198
 dominus/namespaces/warden.py,sha256=ebbCeBJJwK9uALEj2aDbvWJ5HTlOXOpXJOwzokH1cso,1139
 dominus/namespaces/workflow.py,sha256=1LMzlYoVImtdpnuenJDtpx7dB2wdNVE3tSBFn-ZAyJA,47204
 dominus/services/__init__.py,sha256=LQl5sx6DHhX1xCN3MRoUgffxqwm3Mfm525hijyFods8,43
-dominus_sdk_python-4.3.0.dist-info/METADATA,sha256=bEd541Lu4P9g4ulABDzL3z-Xokw-kX8kCRopwUDMjTk,8900
-dominus_sdk_python-4.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-dominus_sdk_python-4.3.0.dist-info/top_level.txt,sha256=515zxMIbX0DpheRbjvNqKIt_AFqdFjX41jtyp_SqLf4,8
-dominus_sdk_python-4.3.0.dist-info/RECORD,,
+dominus_sdk_python-4.5.0.dist-info/METADATA,sha256=OsKJKzfOCg2j9_TMxJL0KBadYk6Nkz5dQ9sL8KSZUAU,8900
+dominus_sdk_python-4.5.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+dominus_sdk_python-4.5.0.dist-info/top_level.txt,sha256=515zxMIbX0DpheRbjvNqKIt_AFqdFjX41jtyp_SqLf4,8
+dominus_sdk_python-4.5.0.dist-info/RECORD,,