dominus-sdk-python 4.2.0__tar.gz → 4.4.0__tar.gz

{dominus_sdk_python-4.2.0 → dominus_sdk_python-4.4.0}/PKG-INFO

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

{dominus_sdk_python-4.2.0 → dominus_sdk_python-4.4.0}/dominus/__init__.py

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

{dominus_sdk_python-4.2.0 → dominus_sdk_python-4.4.0}/dominus/namespaces/redis.py

@@ -442,6 +442,107 @@ class RedisNamespace:
             use_gateway=True,
         )
 
+    async def sadd(
+        self,
+        key: str,
+        members: List[Any],
+        ttl: int = 3600,
+        category: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Add one or more members to a Redis set, with TTL refresh.
+
+        Backed by the native dominus-redis-worker /sadd route added 2026-05-09.
+        Each member is independently size-guarded (1 MiB cap per encoded value).
+
+        Args:
+            key: Key name (logical_path)
+            members: List of values to add
+            ttl: Time-to-live in seconds for the set (default 3600)
+            category: Optional namespace category
+
+        Returns:
+            Dict with {"key", "added", "ttl_seconds"}
+        """
+        body: Dict[str, Any] = {
+            "logical_path": key,
+            "members": members,
+            "ttl_seconds": ttl,
+        }
+        if category:
+            body["category"] = category
+        return await self._client._request(
+            endpoint="/api/redis/sadd",
+            body=body,
+            use_gateway=True,
+        )
+
+    async def srem(
+        self,
+        key: str,
+        members: List[Any],
+        category: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Remove one or more members from a Redis set.
+
+        Backed by the native dominus-redis-worker /srem route added 2026-05-09.
+
+        Args:
+            key: Key name (logical_path)
+            members: List of values to remove
+            category: Optional namespace category
+
+        Returns:
+            Dict with {"key", "removed"}
+        """
+        body: Dict[str, Any] = {
+            "logical_path": key,
+            "members": members,
+        }
+        if category:
+            body["category"] = category
+        return await self._client._request(
+            endpoint="/api/redis/srem",
+            body=body,
+            use_gateway=True,
+        )
+
+    async def mset(
+        self,
+        entries: List[Dict[str, Any]],
+    ) -> Dict[str, Any]:
+        """
+        Multi-set: write 1..50 keys (potentially different categories and TTLs)
+        in one redis-worker invocation. Backed by /mset added 2026-05-08.
+
+        Use for fixed-batch fan-out (e.g. heartbeat-style multi-write paths)
+        to reduce Cloudflare worker invocation counts and gateway hops.
+
+        Args:
+            entries: List of dicts each with {"key": str, "value": Any,
+                     "ttl"?: int, "category"?: str}
+
+        Returns:
+            Dict with {"stored": [{"key", "stored", "ttl_seconds"}, ...]}
+        """
+        wire_entries: List[Dict[str, Any]] = []
+        for entry in entries:
+            wire: Dict[str, Any] = {
+                "logical_path": entry["key"],
+                "value": entry["value"],
+            }
+            if "ttl" in entry and entry["ttl"] is not None:
+                wire["ttl_seconds"] = entry["ttl"]
+            if entry.get("category"):
+                wire["category"] = entry["category"]
+            wire_entries.append(wire)
+        return await self._client._request(
+            endpoint="/api/redis/mset",
+            body={"entries": wire_entries},
+            use_gateway=True,
+        )
+
     async def lrange(
         self,
         key: str,
@@ -474,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.2.0 → dominus_sdk_python-4.4.0}/dominus_sdk_python.egg-info/PKG-INFO

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

{dominus_sdk_python-4.2.0 → dominus_sdk_python-4.4.0}/pyproject.toml

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