@trusty-squire/mcp 1.1.6 → 1.1.7

package/dist/bot/operator-recipe.d.ts

@@ -1,29 +1,177 @@
 import { z } from "zod";
+export declare const OperatorVerbSchema: z.ZodEnum<["purchase", "get_api_key", "signup", "subscribe", "cancel", "login", "book", "reserve", "renew", "upgrade", "downgrade", "add_to_cart", "checkout", "download", "configure"]>;
+export type OperatorVerb = z.infer<typeof OperatorVerbSchema>;
+export declare const RecipeHoleSchema: z.ZodObject<{
+    hole: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    hole: string;
+}, {
+    hole: string;
+}>;
+export type RecipeHole = z.infer<typeof RecipeHoleSchema>;
+export declare const RecipeValueSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    hole: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    hole: string;
+}, {
+    hole: string;
+}>]>;
+export type RecipeValue = z.infer<typeof RecipeValueSchema>;
+export declare const RecipeTargetSchema: z.ZodObject<{
+    dom_hint: z.ZodOptional<z.ZodObject<{
+        testid: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id?: string | undefined;
+        name?: string | undefined;
+        testid?: string | undefined;
+    }, {
+        id?: string | undefined;
+        name?: string | undefined;
+        testid?: string | undefined;
+    }>>;
+    role_hint: z.ZodOptional<z.ZodString>;
+    accessible_name: z.ZodOptional<z.ZodString>;
+    near_text_hint: z.ZodOptional<z.ZodString>;
+    href_hint: z.ZodOptional<z.ZodString>;
+    css: z.ZodOptional<z.ZodString>;
+    visible_text: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    css?: string | undefined;
+    near_text_hint?: string | undefined;
+    dom_hint?: {
+        id?: string | undefined;
+        name?: string | undefined;
+        testid?: string | undefined;
+    } | undefined;
+    role_hint?: string | undefined;
+    accessible_name?: string | undefined;
+    href_hint?: string | undefined;
+    visible_text?: string | undefined;
+}, {
+    css?: string | undefined;
+    near_text_hint?: string | undefined;
+    dom_hint?: {
+        id?: string | undefined;
+        name?: string | undefined;
+        testid?: string | undefined;
+    } | undefined;
+    role_hint?: string | undefined;
+    accessible_name?: string | undefined;
+    href_hint?: string | undefined;
+    visible_text?: string | undefined;
+}>;
+export type RecipeTarget = z.infer<typeof RecipeTargetSchema>;
 declare const TraceActionSchema: z.ZodObject<{
-    kind: z.ZodEnum<["goto", "click", "js_click", "type", "press", "oauth_click", "oauth_settle", "allow_host", "type_secret", "scroll", "extract"]>;
+    kind: z.ZodEnum<["goto", "click", "js_click", "type", "press", "oauth_click", "oauth_settle", "allow_host", "type_secret", "select", "set_phone_country", "operate_pay", "scroll", "extract"]>;
     text_match: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodObject<{
+        dom_hint: z.ZodOptional<z.ZodObject<{
+            testid: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id?: string | undefined;
+            name?: string | undefined;
+            testid?: string | undefined;
+        }, {
+            id?: string | undefined;
+            name?: string | undefined;
+            testid?: string | undefined;
+        }>>;
+        role_hint: z.ZodOptional<z.ZodString>;
+        accessible_name: z.ZodOptional<z.ZodString>;
+        near_text_hint: z.ZodOptional<z.ZodString>;
+        href_hint: z.ZodOptional<z.ZodString>;
+        css: z.ZodOptional<z.ZodString>;
+        visible_text: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        css?: string | undefined;
+        near_text_hint?: string | undefined;
+        dom_hint?: {
+            id?: string | undefined;
+            name?: string | undefined;
+            testid?: string | undefined;
+        } | undefined;
+        role_hint?: string | undefined;
+        accessible_name?: string | undefined;
+        href_hint?: string | undefined;
+        visible_text?: string | undefined;
+    }, {
+        css?: string | undefined;
+        near_text_hint?: string | undefined;
+        dom_hint?: {
+            id?: string | undefined;
+            name?: string | undefined;
+            testid?: string | undefined;
+        } | undefined;
+        role_hint?: string | undefined;
+        accessible_name?: string | undefined;
+        href_hint?: string | undefined;
+        visible_text?: string | undefined;
+    }>>;
+    email_hole: z.ZodOptional<z.ZodString>;
     url_template: z.ZodOptional<z.ZodString>;
-    value: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        hole: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        hole: string;
+    }, {
+        hole: string;
+    }>]>>;
     host: z.ZodOptional<z.ZodString>;
     slot: z.ZodOptional<z.ZodString>;
     direction: z.ZodOptional<z.ZodEnum<["down", "up", "bottom", "top"]>>;
     key: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+    kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
     host?: string | undefined;
     key?: string | undefined;
     slot?: string | undefined;
-    value?: string | undefined;
+    value?: string | {
+        hole: string;
+    } | undefined;
     text_match?: string | undefined;
+    target?: {
+        css?: string | undefined;
+        near_text_hint?: string | undefined;
+        dom_hint?: {
+            id?: string | undefined;
+            name?: string | undefined;
+            testid?: string | undefined;
+        } | undefined;
+        role_hint?: string | undefined;
+        accessible_name?: string | undefined;
+        href_hint?: string | undefined;
+        visible_text?: string | undefined;
+    } | undefined;
+    email_hole?: string | undefined;
     url_template?: string | undefined;
     direction?: "down" | "up" | "bottom" | "top" | undefined;
 }, {
-    kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+    kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
     host?: string | undefined;
     key?: string | undefined;
     slot?: string | undefined;
-    value?: string | undefined;
+    value?: string | {
+        hole: string;
+    } | undefined;
     text_match?: string | undefined;
+    target?: {
+        css?: string | undefined;
+        near_text_hint?: string | undefined;
+        dom_hint?: {
+            id?: string | undefined;
+            name?: string | undefined;
+            testid?: string | undefined;
+        } | undefined;
+        role_hint?: string | undefined;
+        accessible_name?: string | undefined;
+        href_hint?: string | undefined;
+        visible_text?: string | undefined;
+    } | undefined;
+    email_hole?: string | undefined;
     url_template?: string | undefined;
     direction?: "down" | "up" | "bottom" | "top" | undefined;
 }>;
@@ -31,53 +179,169 @@ export type TraceAction = z.infer<typeof TraceActionSchema>;
 declare const TraceEntrySchema: z.ZodObject<{
     intent: z.ZodOptional<z.ZodString>;
     action: z.ZodObject<{
-        kind: z.ZodEnum<["goto", "click", "js_click", "type", "press", "oauth_click", "oauth_settle", "allow_host", "type_secret", "scroll", "extract"]>;
+        kind: z.ZodEnum<["goto", "click", "js_click", "type", "press", "oauth_click", "oauth_settle", "allow_host", "type_secret", "select", "set_phone_country", "operate_pay", "scroll", "extract"]>;
         text_match: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodObject<{
+            dom_hint: z.ZodOptional<z.ZodObject<{
+                testid: z.ZodOptional<z.ZodString>;
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            }, {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            }>>;
+            role_hint: z.ZodOptional<z.ZodString>;
+            accessible_name: z.ZodOptional<z.ZodString>;
+            near_text_hint: z.ZodOptional<z.ZodString>;
+            href_hint: z.ZodOptional<z.ZodString>;
+            css: z.ZodOptional<z.ZodString>;
+            visible_text: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            css?: string | undefined;
+            near_text_hint?: string | undefined;
+            dom_hint?: {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            } | undefined;
+            role_hint?: string | undefined;
+            accessible_name?: string | undefined;
+            href_hint?: string | undefined;
+            visible_text?: string | undefined;
+        }, {
+            css?: string | undefined;
+            near_text_hint?: string | undefined;
+            dom_hint?: {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            } | undefined;
+            role_hint?: string | undefined;
+            accessible_name?: string | undefined;
+            href_hint?: string | undefined;
+            visible_text?: string | undefined;
+        }>>;
+        email_hole: z.ZodOptional<z.ZodString>;
         url_template: z.ZodOptional<z.ZodString>;
-        value: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            hole: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            hole: string;
+        }, {
+            hole: string;
+        }>]>>;
         host: z.ZodOptional<z.ZodString>;
         slot: z.ZodOptional<z.ZodString>;
         direction: z.ZodOptional<z.ZodEnum<["down", "up", "bottom", "top"]>>;
         key: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+        kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
         host?: string | undefined;
         key?: string | undefined;
         slot?: string | undefined;
-        value?: string | undefined;
+        value?: string | {
+            hole: string;
+        } | undefined;
         text_match?: string | undefined;
+        target?: {
+            css?: string | undefined;
+            near_text_hint?: string | undefined;
+            dom_hint?: {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            } | undefined;
+            role_hint?: string | undefined;
+            accessible_name?: string | undefined;
+            href_hint?: string | undefined;
+            visible_text?: string | undefined;
+        } | undefined;
+        email_hole?: string | undefined;
         url_template?: string | undefined;
         direction?: "down" | "up" | "bottom" | "top" | undefined;
     }, {
-        kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+        kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
         host?: string | undefined;
         key?: string | undefined;
         slot?: string | undefined;
-        value?: string | undefined;
+        value?: string | {
+            hole: string;
+        } | undefined;
         text_match?: string | undefined;
+        target?: {
+            css?: string | undefined;
+            near_text_hint?: string | undefined;
+            dom_hint?: {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            } | undefined;
+            role_hint?: string | undefined;
+            accessible_name?: string | undefined;
+            href_hint?: string | undefined;
+            visible_text?: string | undefined;
+        } | undefined;
+        email_hole?: string | undefined;
         url_template?: string | undefined;
         direction?: "down" | "up" | "bottom" | "top" | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     action: {
-        kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+        kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
         host?: string | undefined;
         key?: string | undefined;
         slot?: string | undefined;
-        value?: string | undefined;
+        value?: string | {
+            hole: string;
+        } | undefined;
         text_match?: string | undefined;
+        target?: {
+            css?: string | undefined;
+            near_text_hint?: string | undefined;
+            dom_hint?: {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            } | undefined;
+            role_hint?: string | undefined;
+            accessible_name?: string | undefined;
+            href_hint?: string | undefined;
+            visible_text?: string | undefined;
+        } | undefined;
+        email_hole?: string | undefined;
         url_template?: string | undefined;
         direction?: "down" | "up" | "bottom" | "top" | undefined;
     };
     intent?: string | undefined;
 }, {
     action: {
-        kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+        kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
         host?: string | undefined;
         key?: string | undefined;
         slot?: string | undefined;
-        value?: string | undefined;
+        value?: string | {
+            hole: string;
+        } | undefined;
         text_match?: string | undefined;
+        target?: {
+            css?: string | undefined;
+            near_text_hint?: string | undefined;
+            dom_hint?: {
+                id?: string | undefined;
+                name?: string | undefined;
+                testid?: string | undefined;
+            } | undefined;
+            role_hint?: string | undefined;
+            accessible_name?: string | undefined;
+            href_hint?: string | undefined;
+            visible_text?: string | undefined;
+        } | undefined;
+        email_hole?: string | undefined;
         url_template?: string | undefined;
         direction?: "down" | "up" | "bottom" | "top" | undefined;
     };
@@ -107,7 +371,7 @@ declare const SuccessSignalSchema: z.ZodUnion<[z.ZodObject<{
     url_contains: string;
 }>]>;
 export type SuccessSignal = z.infer<typeof SuccessSignalSchema>;
-export declare const PostconditionSchema: z.ZodObject<{
+export declare const PostconditionSchema: z.ZodEffects<z.ZodObject<{
     kind: z.ZodEnum<["execute_capability", "observe_artifact"]>;
     describe: z.ZodString;
     success_signal: z.ZodUnion<[z.ZodObject<{
@@ -132,7 +396,8 @@ export declare const PostconditionSchema: z.ZodObject<{
     }, {
         url_contains: string;
     }>]>;
-    probe_url: z.ZodOptional<z.ZodString>;
+    probe_url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    email_hole: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     kind: "execute_capability" | "observe_artifact";
     describe: string;
@@ -144,6 +409,7 @@ export declare const PostconditionSchema: z.ZodObject<{
     } | {
         url_contains: string;
     };
+    email_hole?: string | undefined;
     probe_url?: string | undefined;
 }, {
     kind: "execute_capability" | "observe_artifact";
@@ -156,6 +422,33 @@ export declare const PostconditionSchema: z.ZodObject<{
     } | {
         url_contains: string;
     };
+    email_hole?: string | undefined;
+    probe_url?: string | undefined;
+}>, {
+    kind: "execute_capability" | "observe_artifact";
+    describe: string;
+    success_signal: {
+        field_text: string;
+        min_value_len: number;
+    } | {
+        text_present: string;
+    } | {
+        url_contains: string;
+    };
+    email_hole?: string | undefined;
+    probe_url?: string | undefined;
+}, {
+    kind: "execute_capability" | "observe_artifact";
+    describe: string;
+    success_signal: {
+        field_text: string;
+        min_value_len: number;
+    } | {
+        text_present: string;
+    } | {
+        url_contains: string;
+    };
+    email_hole?: string | undefined;
     probe_url?: string | undefined;
 }>;
 export type Postcondition = z.infer<typeof PostconditionSchema>;
@@ -173,62 +466,181 @@ declare const SecretRefSchema: z.ZodObject<{
     sealed_from?: string | undefined;
 }>;
 export type SecretRef = z.infer<typeof SecretRefSchema>;
-export declare const OperatorRecipeSchema: z.ZodObject<{
+export declare const OperatorRecipeSchema: z.ZodEffects<z.ZodObject<{
     name: z.ZodString;
     schema_version: z.ZodLiteral<1>;
     goal: z.ZodString;
+    verb: z.ZodOptional<z.ZodEnum<["purchase", "get_api_key", "signup", "subscribe", "cancel", "login", "book", "reserve", "renew", "upgrade", "downgrade", "add_to_cart", "checkout", "download", "configure"]>>;
+    domain: z.ZodOptional<z.ZodString>;
     entry_url: z.ZodOptional<z.ZodString>;
+    entry_mode: z.ZodOptional<z.ZodLiteral<"runtime_service_url">>;
     allowed_hosts: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     trace: z.ZodArray<z.ZodObject<{
         intent: z.ZodOptional<z.ZodString>;
         action: z.ZodObject<{
-            kind: z.ZodEnum<["goto", "click", "js_click", "type", "press", "oauth_click", "oauth_settle", "allow_host", "type_secret", "scroll", "extract"]>;
+            kind: z.ZodEnum<["goto", "click", "js_click", "type", "press", "oauth_click", "oauth_settle", "allow_host", "type_secret", "select", "set_phone_country", "operate_pay", "scroll", "extract"]>;
             text_match: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodObject<{
+                dom_hint: z.ZodOptional<z.ZodObject<{
+                    testid: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, "strict", z.ZodTypeAny, {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                }, {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                }>>;
+                role_hint: z.ZodOptional<z.ZodString>;
+                accessible_name: z.ZodOptional<z.ZodString>;
+                near_text_hint: z.ZodOptional<z.ZodString>;
+                href_hint: z.ZodOptional<z.ZodString>;
+                css: z.ZodOptional<z.ZodString>;
+                visible_text: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            }, {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            }>>;
+            email_hole: z.ZodOptional<z.ZodString>;
             url_template: z.ZodOptional<z.ZodString>;
-            value: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                hole: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                hole: string;
+            }, {
+                hole: string;
+            }>]>>;
             host: z.ZodOptional<z.ZodString>;
             slot: z.ZodOptional<z.ZodString>;
             direction: z.ZodOptional<z.ZodEnum<["down", "up", "bottom", "top"]>>;
             key: z.ZodOptional<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
-            kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
             host?: string | undefined;
             key?: string | undefined;
             slot?: string | undefined;
-            value?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
             text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
             url_template?: string | undefined;
             direction?: "down" | "up" | "bottom" | "top" | undefined;
         }, {
-            kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
             host?: string | undefined;
             key?: string | undefined;
             slot?: string | undefined;
-            value?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
             text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
             url_template?: string | undefined;
             direction?: "down" | "up" | "bottom" | "top" | undefined;
         }>;
     }, "strict", z.ZodTypeAny, {
         action: {
-            kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
             host?: string | undefined;
             key?: string | undefined;
             slot?: string | undefined;
-            value?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
             text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
             url_template?: string | undefined;
             direction?: "down" | "up" | "bottom" | "top" | undefined;
         };
         intent?: string | undefined;
     }, {
         action: {
-            kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
             host?: string | undefined;
             key?: string | undefined;
             slot?: string | undefined;
-            value?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
             text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
             url_template?: string | undefined;
             direction?: "down" | "up" | "bottom" | "top" | undefined;
         };
@@ -247,7 +659,7 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
         stored: false;
         sealed_from?: string | undefined;
     }>, "many">>;
-    postcondition: z.ZodObject<{
+    postcondition: z.ZodEffects<z.ZodObject<{
         kind: z.ZodEnum<["execute_capability", "observe_artifact"]>;
         describe: z.ZodString;
         success_signal: z.ZodUnion<[z.ZodObject<{
@@ -272,7 +684,8 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
         }, {
             url_contains: string;
         }>]>;
-        probe_url: z.ZodOptional<z.ZodString>;
+        probe_url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        email_hole: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         kind: "execute_capability" | "observe_artifact";
         describe: string;
@@ -284,6 +697,7 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
         } | {
             url_contains: string;
         };
+        email_hole?: string | undefined;
         probe_url?: string | undefined;
     }, {
         kind: "execute_capability" | "observe_artifact";
@@ -296,18 +710,61 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
         } | {
             url_contains: string;
         };
+        email_hole?: string | undefined;
+        probe_url?: string | undefined;
+    }>, {
+        kind: "execute_capability" | "observe_artifact";
+        describe: string;
+        success_signal: {
+            field_text: string;
+            min_value_len: number;
+        } | {
+            text_present: string;
+        } | {
+            url_contains: string;
+        };
+        email_hole?: string | undefined;
+        probe_url?: string | undefined;
+    }, {
+        kind: "execute_capability" | "observe_artifact";
+        describe: string;
+        success_signal: {
+            field_text: string;
+            min_value_len: number;
+        } | {
+            text_present: string;
+        } | {
+            url_contains: string;
+        };
+        email_hole?: string | undefined;
         probe_url?: string | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     name: string;
     trace: {
         action: {
-            kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
             host?: string | undefined;
             key?: string | undefined;
             slot?: string | undefined;
-            value?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
             text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
             url_template?: string | undefined;
             direction?: "down" | "up" | "bottom" | "top" | undefined;
         };
@@ -332,19 +789,39 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
         } | {
             url_contains: string;
         };
+        email_hole?: string | undefined;
         probe_url?: string | undefined;
     };
+    verb?: "download" | "signup" | "login" | "purchase" | "get_api_key" | "subscribe" | "cancel" | "book" | "reserve" | "renew" | "upgrade" | "downgrade" | "add_to_cart" | "checkout" | "configure" | undefined;
+    domain?: string | undefined;
     entry_url?: string | undefined;
+    entry_mode?: "runtime_service_url" | undefined;
 }, {
     name: string;
     trace: {
         action: {
-            kind: "type" | "goto" | "click" | "extract" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret";
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
             host?: string | undefined;
             key?: string | undefined;
             slot?: string | undefined;
-            value?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
             text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
             url_template?: string | undefined;
             direction?: "down" | "up" | "bottom" | "top" | undefined;
         };
@@ -363,9 +840,127 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
         } | {
             url_contains: string;
         };
+        email_hole?: string | undefined;
         probe_url?: string | undefined;
     };
+    verb?: "download" | "signup" | "login" | "purchase" | "get_api_key" | "subscribe" | "cancel" | "book" | "reserve" | "renew" | "upgrade" | "downgrade" | "add_to_cart" | "checkout" | "configure" | undefined;
+    domain?: string | undefined;
     entry_url?: string | undefined;
+    entry_mode?: "runtime_service_url" | undefined;
+    allowed_hosts?: string[] | undefined;
+    secrets?: {
+        slot: string;
+        stored: false;
+        sealed_from?: string | undefined;
+    }[] | undefined;
+}>, {
+    name: string;
+    trace: {
+        action: {
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
+            host?: string | undefined;
+            key?: string | undefined;
+            slot?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
+            text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
+            url_template?: string | undefined;
+            direction?: "down" | "up" | "bottom" | "top" | undefined;
+        };
+        intent?: string | undefined;
+    }[];
+    schema_version: 1;
+    goal: string;
+    allowed_hosts: string[];
+    secrets: {
+        slot: string;
+        stored: false;
+        sealed_from?: string | undefined;
+    }[];
+    postcondition: {
+        kind: "execute_capability" | "observe_artifact";
+        describe: string;
+        success_signal: {
+            field_text: string;
+            min_value_len: number;
+        } | {
+            text_present: string;
+        } | {
+            url_contains: string;
+        };
+        email_hole?: string | undefined;
+        probe_url?: string | undefined;
+    };
+    verb?: "download" | "signup" | "login" | "purchase" | "get_api_key" | "subscribe" | "cancel" | "book" | "reserve" | "renew" | "upgrade" | "downgrade" | "add_to_cart" | "checkout" | "configure" | undefined;
+    domain?: string | undefined;
+    entry_url?: string | undefined;
+    entry_mode?: "runtime_service_url" | undefined;
+}, {
+    name: string;
+    trace: {
+        action: {
+            kind: "type" | "goto" | "click" | "extract" | "select" | "scroll" | "js_click" | "press" | "oauth_click" | "oauth_settle" | "allow_host" | "type_secret" | "set_phone_country" | "operate_pay";
+            host?: string | undefined;
+            key?: string | undefined;
+            slot?: string | undefined;
+            value?: string | {
+                hole: string;
+            } | undefined;
+            text_match?: string | undefined;
+            target?: {
+                css?: string | undefined;
+                near_text_hint?: string | undefined;
+                dom_hint?: {
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    testid?: string | undefined;
+                } | undefined;
+                role_hint?: string | undefined;
+                accessible_name?: string | undefined;
+                href_hint?: string | undefined;
+                visible_text?: string | undefined;
+            } | undefined;
+            email_hole?: string | undefined;
+            url_template?: string | undefined;
+            direction?: "down" | "up" | "bottom" | "top" | undefined;
+        };
+        intent?: string | undefined;
+    }[];
+    schema_version: 1;
+    goal: string;
+    postcondition: {
+        kind: "execute_capability" | "observe_artifact";
+        describe: string;
+        success_signal: {
+            field_text: string;
+            min_value_len: number;
+        } | {
+            text_present: string;
+        } | {
+            url_contains: string;
+        };
+        email_hole?: string | undefined;
+        probe_url?: string | undefined;
+    };
+    verb?: "download" | "signup" | "login" | "purchase" | "get_api_key" | "subscribe" | "cancel" | "book" | "reserve" | "renew" | "upgrade" | "downgrade" | "add_to_cart" | "checkout" | "configure" | undefined;
+    domain?: string | undefined;
+    entry_url?: string | undefined;
+    entry_mode?: "runtime_service_url" | undefined;
     allowed_hosts?: string[] | undefined;
     secrets?: {
         slot: string;
@@ -375,8 +970,12 @@ export declare const OperatorRecipeSchema: z.ZodObject<{
 }>;
 export type OperatorRecipe = z.infer<typeof OperatorRecipeSchema>;
 export declare function operatorRecipeDir(): string;
+/** Public-Suffix-List-backed local recipe domain; registry service slugs are unrelated. */
+export declare function operatorRecipeDomain(url: string): string;
+export declare function operatorRecipeKey(verb: OperatorVerb, url: string): string;
 export declare function writeRecipe(recipe: OperatorRecipe): Promise<string>;
 export declare function readRecipe(name: string): Promise<OperatorRecipe>;
+export declare function readRecipeForTask(verb: OperatorVerb, serviceUrl: string): Promise<OperatorRecipe>;
 export declare function listRecipes(): Promise<string[]>;
 export declare function renderOperatorRecipeHint(recipe: OperatorRecipe): string;
 export interface PostconditionSnapshot {
@@ -397,7 +996,66 @@ export declare function fillTemplate(template: string, params: Record<string, st
     url: string;
     missing: string[];
 };
+export interface KnownRecipeInputs {
+    address?: Readonly<Record<string, string>> | undefined;
+    contact?: Readonly<Record<string, string>> | undefined;
+    product_query?: string | undefined;
+    credential?: string | Readonly<Record<string, string>> | undefined;
+    card?: string | Readonly<Record<string, string>> | undefined;
+    quantity?: string | number | undefined;
+}
+export declare function knownRecipeInputValue(inputs: KnownRecipeInputs, hole: string): string | undefined;
+export declare function knownRecipeInputHolesForValue(inputs: KnownRecipeInputs, value: string): string[];
+/** Tag only exact, caller-proven values. Unknown literals deliberately remain literals. */
+export declare function tagProvenanceValue(value: string, inputs: KnownRecipeInputs): RecipeValue;
+export declare function tagTraceProvenance(trace: readonly TraceEntry[], inputs: KnownRecipeInputs): TraceEntry[];
+export declare function bindRecipeValue(value: RecipeValue, bindings: Readonly<Record<string, string>>): string;
+export declare function bindRecipeTarget(target: RecipeTarget, bindings: Readonly<Record<string, string>>, emailHole?: string): RecipeTarget;
+export declare function bindKnownEmailTemplate(value: string, bindings: Readonly<Record<string, string>>, emailHole?: string): string;
+export declare function bindRecipePostcondition(postcondition: Postcondition, bindings: Readonly<Record<string, string>>): Postcondition;
+export declare function cssEscapeRecipeValue(value: string): string;
+export interface RecipeTargetElement {
+    tag?: string;
+    testId?: string | null;
+    id?: string | null;
+    name?: string | null;
+    role?: string | null;
+    ariaLabel?: string | null;
+    labelText?: string | null;
+    visibleText?: string | null;
+    iconLabel?: string | null;
+    placeholder?: string | null;
+    title?: string | null;
+    href?: string | null;
+    selector: string;
+    value?: string | null;
+    selectedOptionText?: string | null;
+}
+export type RecipeTargetResolution<T extends RecipeTargetElement> = {
+    element: T;
+    via: "testid" | "id" | "name" | "role+accessible-name" | "href" | "css" | "visible-text";
+};
+/** Ordered fallback. It is intentionally not a weighted/scored matcher. */
+export declare function resolveRecipeTarget<T extends RecipeTargetElement>(elements: readonly T[], target: RecipeTarget): RecipeTargetResolution<T> | null;
+export declare function resolveRecipeFieldTarget<T extends RecipeTargetElement>(elements: readonly T[], target: RecipeTarget): RecipeTargetResolution<T> | null;
+export declare function hasRecipeTargetCandidate<T extends RecipeTargetElement>(elements: readonly T[], target: RecipeTarget): boolean;
+export declare function resolveRecipeRepairTarget<T extends RecipeTargetElement>(elements: readonly T[], target: RecipeTarget): T | null;
+export interface FilledFieldExpectation {
+    target: RecipeTarget;
+    expected: string;
+    hole?: string;
+    kind?: "type" | "select";
+}
+export type FieldValueVerification = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "field_missing" | "field_value_mismatch";
+    field: string;
+};
+/** Money-path guard: exact live values must equal every value Squire injected. */
+export declare function verifyFilledFieldValues(elements: readonly RecipeTargetElement[], expectedFields: readonly FilledFieldExpectation[]): FieldValueVerification;
 export declare function isSingleUseUrl(rawUrl: string): boolean;
-export declare function recipeEntryUrl(recipe: OperatorRecipe): string | null;
+export declare function recipeEntryUrl(recipe: OperatorRecipe, runtimeServiceUrl?: string): string | null;
 export {};
 //# sourceMappingURL=operator-recipe.d.ts.map