dominus-sdk-python 4.6.0__py3-none-any.whl → 4.6.2__py3-none-any.whl

dominus/__init__.py

@@ -112,6 +112,7 @@ from .namespaces.processor import ProcessorNamespace
 from .namespaces.sync import SyncNamespace
 from .namespaces.authority import AuthorityNamespace
 from .namespaces.browser import BrowserNamespace
+from .namespaces.recipes import RecipesNamespace
 from .namespaces.deployer import DeployerNamespace
 from .namespaces.warden import WardenNamespace
 
@@ -164,7 +165,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "4.6.0"
+__version__ = "4.6.2"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -215,6 +216,7 @@ __all__ = [
     "SyncNamespace",
     "AuthorityNamespace",
     "BrowserNamespace",
+    "RecipesNamespace",
     "DeployerNamespace",
     "WardenNamespace",
     # AI namespace for agent-runtime operations

dominus/namespaces/__init__.py

@@ -16,6 +16,7 @@ from .processor import ProcessorNamespace
 from .sync import SyncNamespace
 from .authority import AuthorityNamespace
 from .browser import BrowserNamespace
+from .recipes import RecipesNamespace
 from .deployer import DeployerNamespace
 from .warden import WardenNamespace
 from .ai import (
@@ -44,6 +45,7 @@ __all__ = [
     "SyncNamespace",
     "AuthorityNamespace",
     "BrowserNamespace",
+    "RecipesNamespace",
     "DeployerNamespace",
     "WardenNamespace",
     "AiNamespace",

dominus/namespaces/browser.py

@@ -77,7 +77,7 @@ class BrowserNamespace:
     async def ensure_run(
         self,
         *,
-        target: Dict[str, Any],
+        target: Optional[Dict[str, Any]] = None,
         idempotency_key: Optional[str] = None,
         run_kind: Optional[str] = None,
         route_label: Optional[str] = None,
@@ -92,11 +92,29 @@ class BrowserNamespace:
         org_id: Optional[str] = None,
         app_slug: Optional[str] = None,
         env: Optional[str] = None,
+        recipe_ref: Optional[str] = None,
+        recipe: Optional[Any] = None,
+        recipe_inputs: Optional[Dict[str, Any]] = None,
         timeout: float = 30.0,
     ) -> Dict[str, Any]:
         """
         Ensure a browser run. ``POST /api/browser/runs/ensure``.
 
+        ``target`` shorthand, ``recipe_ref``, or inline ``recipe`` must be
+        present. When ``recipe_ref`` is set, the worker resolves the
+        recipe through the recipe-worker, parses it, resolves variables, and
+        runs it through the recipe executor — supporting multi-step flows
+        including clicks, fills, assertions, extracts, and stash-backed
+        credential fills.
+
+        ``recipe`` may be an inline YAML string or JSON object for one-off
+        runs. Stable/shared recipes should be published and referenced via
+        ``recipe_ref``. Target/assertion shorthand runs are synthesized into a
+        ``browser-recipe-v1`` recipe internally; there is no separate runner path.
+
+        ``recipe_inputs`` supplies scalar values consumed by ``recipe-input://``
+        variable refs declared in the recipe's vars map.
+
         Browser run metadata remains browser-worker runtime state. Artifact V2
         is used for sanitized `browser-run` result payloads and, when opted-in
         via ``capture_policy["storage_state"] = "always"`` plus
@@ -109,8 +127,8 @@ class BrowserNamespace:
         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")
+        if not target and not recipe_ref and recipe is None:
+            raise ValueError("target, recipe_ref, or recipe is required")
         body = _compact({
             "idempotency_key": idempotency_key,
             "run_kind": run_kind,
@@ -127,6 +145,9 @@ class BrowserNamespace:
             "org_id": org_id,
             "app_slug": app_slug,
             "env": env,
+            "recipe_ref": recipe_ref,
+            "recipe": recipe,
+            "recipe_inputs": recipe_inputs,
         })
         return await self._post("/api/browser/runs/ensure", body, timeout=timeout)
 

dominus/namespaces/recipes.py

@@ -0,0 +1,188 @@
+"""
+Recipes Namespace - kernel-tier recipe protocol.
+
+Routes through ``/svc/recipe/*`` on the Dominus gateway. The recipe worker
+owns the type registry, JSON-Schema-based publish validation, three-tier
+resolution (project -> group -> platform), and B2-backed durable storage.
+
+Recipe types currently registered:
+  - browser-recipe (owned by dominus-browser-worker; body version is browser-recipe-v1)
+
+Refs follow ``recipe://{type}/{name}[@v{N}][?tier={tier}]``.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..start import Dominus
+
+
+def _compact(payload: Dict[str, Any]) -> Dict[str, Any]:
+    return {k: v for k, v in payload.items() if v is not None and v != ""}
+
+
+class RecipesNamespace:
+    """
+    Recipe worker namespace.
+
+    Usage::
+
+        types = await dominus.recipes.list_types()
+        await dominus.recipes.publish(
+            type="browser-recipe",
+            tier="platform",
+            name="health-check",
+            body="version: browser-recipe-v1\\nsteps:\\n  - kind: goto\\n    url: https://x/\\n",
+        )
+        recipe = await dominus.recipes.get(type="browser-recipe", name="health-check")
+    """
+
+    def __init__(self, client: "Dominus"):
+        self._client = client
+
+    async def _post(self, endpoint: str, body: Optional[Dict[str, Any]] = None, *, timeout: float = 30.0) -> Dict[str, Any]:
+        return await self._client._request(
+            endpoint=endpoint,
+            method="POST",
+            body=body or {},
+            use_gateway=True,
+            timeout=timeout,
+        )
+
+    async def _get(self, endpoint: str, *, timeout: float = 30.0) -> Dict[str, Any]:
+        return await self._client._request(
+            endpoint=endpoint,
+            method="GET",
+            use_gateway=True,
+            timeout=timeout,
+        )
+
+    async def list_types(self, *, owning_worker: Optional[str] = None, timeout: float = 15.0) -> Dict[str, Any]:
+        """List registered recipe types. ``GET /api/recipe/types``."""
+        query = f"?owning_worker={owning_worker}" if owning_worker else ""
+        return await self._get(f"/api/recipe/types{query}", timeout=timeout)
+
+    async def get_type(self, name: str, *, timeout: float = 15.0) -> Dict[str, Any]:
+        """Fetch a registered recipe type's schema. ``GET /api/recipe/types/{name}``."""
+        return await self._get(f"/api/recipe/types/{name}", timeout=timeout)
+
+    async def publish(
+        self,
+        *,
+        type: str,
+        tier: str,
+        name: str,
+        body: str,
+        description: Optional[str] = None,
+        timeout: float = 30.0,
+    ) -> Dict[str, Any]:
+        """Publish a recipe. ``POST /api/recipe/recipes/publish``."""
+        return await self._post(
+            "/api/recipe/recipes/publish",
+            _compact({
+                "type": type,
+                "tier": tier,
+                "name": name,
+                "body": body,
+                "description": description,
+            }),
+            timeout=timeout,
+        )
+
+    async def validate(
+        self,
+        *,
+        type: str,
+        body: str,
+        timeout: float = 15.0,
+    ) -> Dict[str, Any]:
+        """Validate a recipe body against its type schema. ``POST /api/recipe/recipes/validate``."""
+        return await self._post(
+            "/api/recipe/recipes/validate",
+            {"type": type, "body": body},
+            timeout=timeout,
+        )
+
+    async def deprecate(
+        self,
+        *,
+        type: str,
+        tier: str,
+        name: str,
+        version: int,
+        reason: Optional[str] = None,
+        timeout: float = 30.0,
+    ) -> Dict[str, Any]:
+        """Mark the current head recipe version deprecated. ``POST /api/recipe/recipes/deprecate``."""
+        return await self._post(
+            "/api/recipe/recipes/deprecate",
+            _compact({
+                "type": type,
+                "tier": tier,
+                "name": name,
+                "version": version,
+                "reason": reason,
+            }),
+            timeout=timeout,
+        )
+
+    async def list(
+        self,
+        *,
+        type: Optional[str] = None,
+        tier: Optional[str] = None,
+        name_prefix: Optional[str] = None,
+        timeout: float = 15.0,
+    ) -> Dict[str, Any]:
+        """List recipes filtered by type/tier/name. ``GET /api/recipe/recipes/list``."""
+        params: List[str] = []
+        if type:
+            params.append(f"type={type}")
+        if tier:
+            params.append(f"tier={tier}")
+        if name_prefix:
+            params.append(f"name_prefix={name_prefix}")
+        query = ("?" + "&".join(params)) if params else ""
+        return await self._get(f"/api/recipe/recipes/list{query}", timeout=timeout)
+
+    async def get(
+        self,
+        *,
+        type: str,
+        name: str,
+        version: Optional[int] = None,
+        tier: Optional[str] = None,
+        timeout: float = 15.0,
+    ) -> Dict[str, Any]:
+        """Resolve a recipe through the three-tier chain. ``GET /api/recipe/recipes/{type}/{name}[@v{N}]``."""
+        path = f"/api/recipe/recipes/{type}/{name}"
+        if version is not None:
+            path += f"@v{version}"
+        if tier:
+            path += f"?tier={tier}"
+        return await self._get(path, timeout=timeout)
+
+    async def register_type(
+        self,
+        *,
+        name: str,
+        owning_worker: str,
+        schema_version: int,
+        json_schema: Dict[str, Any],
+        timeout: float = 15.0,
+    ) -> Dict[str, Any]:
+        """Register a recipe type. ``POST /api/recipe/types/register``.
+
+        Owning workers do this on cold start. Normal callers should not need it.
+        """
+        return await self._post(
+            "/api/recipe/types/register",
+            {
+                "name": name,
+                "owning_worker": owning_worker,
+                "schema_version": schema_version,
+                "json_schema": json_schema,
+            },
+            timeout=timeout,
+        )

dominus/start.py

@@ -186,6 +186,10 @@ class Dominus:
         from .namespaces.stash import StashNamespace
         self.stash = StashNamespace(self)
 
+        # Recipe worker (kernel-tier; hosts browser-recipe today, workflow + envoy + others later)
+        from .namespaces.recipes import RecipesNamespace
+        self.recipes = RecipesNamespace(self)
+
         # Cache for JWT public key
         self._public_key_cache = None
 

{dominus_sdk_python-4.6.0.dist-info → dominus_sdk_python-4.6.2.dist-info}/METADATA

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

{dominus_sdk_python-4.6.0.dist-info → dominus_sdk_python-4.6.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-dominus/__init__.py,sha256=8bqI4GjEUi0cQnwbcGp70gr58Xkl19opz74SN7Xf-6M,6997
+dominus/__init__.py,sha256=fXMmrG8nn-vuCCSCbWfUYjZTWuTgPPgSlBERSxiba5s,7070
 dominus/errors.py,sha256=NthcR-o1Q1nQsE3ZSHStcW_RdZ8LQ06mPDSenY1txgM,8547
-dominus/start.py,sha256=jE4MCN-svtD7zQ83ugQ0kPmfxK4qJquDNVwXPNGNiwM,49636
+dominus/start.py,sha256=Dn6uN2z0KkiJmM8rOLU20JlslZ-xhOLQb2hcJOzHEYo,49839
 dominus/config/__init__.py,sha256=nvLLNh4dM_MCqcfF3XFS2NnVn44q0RYHEfAPP-2G5To,434
 dominus/config/endpoints.py,sha256=IFioVY3jQ5Mqy65L6rNbEXyPUfYTaXRQkfyGdKv33A8,4140
 dominus/helpers/__init__.py,sha256=cyoBvw1QJugtGt0gYitIz1yxOaMmBa-wMXqbh-fi4PU,61
@@ -11,13 +11,13 @@ dominus/helpers/core.py,sha256=stpagEgsRpsXFP9_L2M-gJVo3ioSsyZm7zr8zWIyfmA,37991
 dominus/helpers/crypto.py,sha256=R1yZittVykTQzGVJdb_uMQuF3Y1uGuQRJHZ1BTWT9lU,3014
 dominus/helpers/sse.py,sha256=8cuQbonEbroho8sZhZ8kmu_IQY2lD_xNLm7FLaREwgU,5325
 dominus/helpers/trace.py,sha256=i0dRYR4Y46LAnQr0Cm5htbyZ0VA4UQCLMx-q2CQQXSc,2686
-dominus/namespaces/__init__.py,sha256=KfN1xDiNffNu86H8SU9dLTP5Aykmw1FhADMLTp0Z_OY,1432
+dominus/namespaces/__init__.py,sha256=4zOayF2IoRHPCVpm41vBF15eoVsScIXv_BVTLsjU3bU,1494
 dominus/namespaces/admin.py,sha256=qkGoteAJ6cqdNub4zL1mtyxAQtsM3-nUplRSgw2fMZY,1640
 dominus/namespaces/ai.py,sha256=Kr_eY-SkEfC-b1fhVVv40pXn_GHkxRzMGD47WoTgu9M,48555
 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=_epZQbCQKUP66CnXJLvccZGJd5TVqMy8nGpscwrqTaE,7868
+dominus/namespaces/browser.py,sha256=mFxQCvwFy5XmSVIXwwOP2B5WpDnm62U-n-nDlCVn_e8,9042
 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,6 +29,7 @@ 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/recipes.py,sha256=xqvm-aKjLy4RrFZFUc_cvr0Q7QelHd7r0OowcU_yny4,6051
 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
@@ -37,7 +38,7 @@ dominus/namespaces/sync.py,sha256=mGwMNwc_iWoKgS94n1staPdsKBHNvliMG7omokl7Qmk,21
 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.6.0.dist-info/METADATA,sha256=kFXogTHvSh7G8RAQwkzJxS-Jdi5DngHczEhV7auxR1M,8900
-dominus_sdk_python-4.6.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-dominus_sdk_python-4.6.0.dist-info/top_level.txt,sha256=515zxMIbX0DpheRbjvNqKIt_AFqdFjX41jtyp_SqLf4,8
-dominus_sdk_python-4.6.0.dist-info/RECORD,,
+dominus_sdk_python-4.6.2.dist-info/METADATA,sha256=nfp-o802nj5qms1_1exjBlmGebXLKAwYiOSiHKO4_zM,8900
+dominus_sdk_python-4.6.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+dominus_sdk_python-4.6.2.dist-info/top_level.txt,sha256=515zxMIbX0DpheRbjvNqKIt_AFqdFjX41jtyp_SqLf4,8
+dominus_sdk_python-4.6.2.dist-info/RECORD,,