@mlola/browser-protocol 0.1.0

package/dist/schemas.d.ts

@@ -0,0 +1,449 @@
+/**
+ * Zod schemas for every untrusted boundary: model responses, policy files,
+ * task files, daemon payloads. Runtime internals use plain TypeScript types;
+ * anything that crosses a trust boundary is parsed here before it is trusted.
+ */
+import { z } from "zod";
+export declare const jevChoiceQuestionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"choice">;
+    instructions: z.ZodString;
+    criteria: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export declare const jevRequestSchema: z.ZodObject<{
+    model: z.ZodString;
+    state: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    questions: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        instructions: z.ZodString;
+        criteria: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const jevChoiceAnswerSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodLiteral<"choice">>;
+    choice: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    probabilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const jevResponseSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    answers: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"choice">>;
+        choice: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        probabilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, z.core.$strip>>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strip>;
+export type JevRequest = z.infer<typeof jevRequestSchema>;
+export type JevResponse = z.infer<typeof jevResponseSchema>;
+export type JevChoiceAnswer = z.infer<typeof jevChoiceAnswerSchema>;
+export declare const textModelResponseSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const plannerModelResponseSchema: z.ZodObject<{
+    subgoals: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const completionCriteriaSchema: z.ZodType<import("./verification.ts").CompletionCriteria>;
+export declare const completionSpecSchema: z.ZodObject<{
+    criteria: z.ZodType<import("./verification.ts").CompletionCriteria, unknown, z.core.$ZodTypeInternals<import("./verification.ts").CompletionCriteria, unknown>>;
+    stableForMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const permissionModeSchema: z.ZodEnum<{
+    allow: "allow";
+    deny: "deny";
+    ask: "ask";
+    takeover: "takeover";
+}>;
+export declare const actionRiskSchema: z.ZodEnum<{
+    download: "download";
+    upload: "upload";
+    read: "read";
+    navigate: "navigate";
+    send_message: "send_message";
+    publish: "publish";
+    purchase: "purchase";
+    delete: "delete";
+    credential_change: "credential_change";
+    permission_change: "permission_change";
+    irreversible: "irreversible";
+    unknown: "unknown";
+}>;
+export declare const siteRuleSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    risk: z.ZodEnum<{
+        download: "download";
+        upload: "upload";
+        read: "read";
+        navigate: "navigate";
+        send_message: "send_message";
+        publish: "publish";
+        purchase: "purchase";
+        delete: "delete";
+        credential_change: "credential_change";
+        permission_change: "permission_change";
+        irreversible: "irreversible";
+        unknown: "unknown";
+    }>;
+    mode: z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        ask: "ask";
+        takeover: "takeover";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const policyFileSchema: z.ZodObject<{
+    defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        ask: "ask";
+        takeover: "takeover";
+    }>>>;
+    siteRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pattern: z.ZodString;
+        risk: z.ZodEnum<{
+            download: "download";
+            upload: "upload";
+            read: "read";
+            navigate: "navigate";
+            send_message: "send_message";
+            publish: "publish";
+            purchase: "purchase";
+            delete: "delete";
+            credential_change: "credential_change";
+            permission_change: "permission_change";
+            irreversible: "irreversible";
+            unknown: "unknown";
+        }>;
+        mode: z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    borrowTabs: z.ZodOptional<z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        ask: "ask";
+        takeover: "takeover";
+    }>>;
+    useExistingProfile: z.ZodOptional<z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        ask: "ask";
+        takeover: "takeover";
+    }>>;
+    clipboard: z.ZodOptional<z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        ask: "ask";
+        takeover: "takeover";
+    }>>;
+    secretsRequireTakeover: z.ZodOptional<z.ZodBoolean>;
+    maxTypedLength: z.ZodOptional<z.ZodNumber>;
+    allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    blockedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    restrictNavigation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PolicyFile = z.infer<typeof policyFileSchema>;
+export declare const browserConfigFileSchema: z.ZodObject<{
+    backend: z.ZodOptional<z.ZodEnum<{
+        playwright: "playwright";
+        "chrome-extension": "chrome-extension";
+        mock: "mock";
+    }>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        managed: "managed";
+        cdp: "cdp";
+    }>>;
+    channel: z.ZodOptional<z.ZodString>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    userDataDir: z.ZodOptional<z.ZodString>;
+    cdpUrl: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    downloadsDir: z.ZodOptional<z.ZodString>;
+    acceptDownloads: z.ZodOptional<z.ZodBoolean>;
+    actionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    settleMs: z.ZodOptional<z.ZodNumber>;
+    slowMoMs: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const budgetsFileSchema: z.ZodObject<{
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+    maxDecisionCalls: z.ZodOptional<z.ZodNumber>;
+    maxPlannerCalls: z.ZodOptional<z.ZodNumber>;
+    maxTextCalls: z.ZodOptional<z.ZodNumber>;
+    maxVisionCalls: z.ZodOptional<z.ZodNumber>;
+    maxCostUsd: z.ZodOptional<z.ZodNumber>;
+    maxDurationMs: z.ZodOptional<z.ZodNumber>;
+    maxRecoveryAttemptsPerStep: z.ZodOptional<z.ZodNumber>;
+    maxRecoveryAttemptsTotal: z.ZodOptional<z.ZodNumber>;
+    maxConsecutiveNoProgress: z.ZodOptional<z.ZodNumber>;
+    maxHumanHelpRequests: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const taskFileSchema: z.ZodObject<{
+    goal: z.ZodString;
+    startUrl: z.ZodOptional<z.ZodString>;
+    successCriteria: z.ZodOptional<z.ZodObject<{
+        criteria: z.ZodType<import("./verification.ts").CompletionCriteria, unknown, z.core.$ZodTypeInternals<import("./verification.ts").CompletionCriteria, unknown>>;
+        stableForMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    stopBefore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    budgets: z.ZodOptional<z.ZodObject<{
+        maxSteps: z.ZodOptional<z.ZodNumber>;
+        maxDecisionCalls: z.ZodOptional<z.ZodNumber>;
+        maxPlannerCalls: z.ZodOptional<z.ZodNumber>;
+        maxTextCalls: z.ZodOptional<z.ZodNumber>;
+        maxVisionCalls: z.ZodOptional<z.ZodNumber>;
+        maxCostUsd: z.ZodOptional<z.ZodNumber>;
+        maxDurationMs: z.ZodOptional<z.ZodNumber>;
+        maxRecoveryAttemptsPerStep: z.ZodOptional<z.ZodNumber>;
+        maxRecoveryAttemptsTotal: z.ZodOptional<z.ZodNumber>;
+        maxConsecutiveNoProgress: z.ZodOptional<z.ZodNumber>;
+        maxHumanHelpRequests: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    browser: z.ZodOptional<z.ZodObject<{
+        backend: z.ZodOptional<z.ZodEnum<{
+            playwright: "playwright";
+            "chrome-extension": "chrome-extension";
+            mock: "mock";
+        }>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            managed: "managed";
+            cdp: "cdp";
+        }>>;
+        channel: z.ZodOptional<z.ZodString>;
+        executablePath: z.ZodOptional<z.ZodString>;
+        headless: z.ZodOptional<z.ZodBoolean>;
+        userDataDir: z.ZodOptional<z.ZodString>;
+        cdpUrl: z.ZodOptional<z.ZodString>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        downloadsDir: z.ZodOptional<z.ZodString>;
+        acceptDownloads: z.ZodOptional<z.ZodBoolean>;
+        actionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        settleMs: z.ZodOptional<z.ZodNumber>;
+        slowMoMs: z.ZodOptional<z.ZodNumber>;
+        locale: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>>;
+        siteRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodString;
+            risk: z.ZodEnum<{
+                download: "download";
+                upload: "upload";
+                read: "read";
+                navigate: "navigate";
+                send_message: "send_message";
+                publish: "publish";
+                purchase: "purchase";
+                delete: "delete";
+                credential_change: "credential_change";
+                permission_change: "permission_change";
+                irreversible: "irreversible";
+                unknown: "unknown";
+            }>;
+            mode: z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+                takeover: "takeover";
+            }>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        borrowTabs: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>;
+        useExistingProfile: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>;
+        clipboard: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>;
+        secretsRequireTakeover: z.ZodOptional<z.ZodBoolean>;
+        maxTypedLength: z.ZodOptional<z.ZodNumber>;
+        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        blockedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        restrictNavigation: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    screenshot: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        "on-failure": "on-failure";
+        always: "always";
+    }>>;
+    providers: z.ZodOptional<z.ZodObject<{
+        decision: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        planner: z.ZodOptional<z.ZodString>;
+        vision: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    forcePlanner: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TaskFile = z.infer<typeof taskFileSchema>;
+export declare const createRunRequestSchema: z.ZodObject<{
+    goal: z.ZodString;
+    startUrl: z.ZodOptional<z.ZodString>;
+    successCriteria: z.ZodOptional<z.ZodObject<{
+        criteria: z.ZodType<import("./verification.ts").CompletionCriteria, unknown, z.core.$ZodTypeInternals<import("./verification.ts").CompletionCriteria, unknown>>;
+        stableForMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    stopBefore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    browser: z.ZodOptional<z.ZodObject<{
+        backend: z.ZodOptional<z.ZodEnum<{
+            playwright: "playwright";
+            "chrome-extension": "chrome-extension";
+            mock: "mock";
+        }>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            managed: "managed";
+            cdp: "cdp";
+        }>>;
+        channel: z.ZodOptional<z.ZodString>;
+        executablePath: z.ZodOptional<z.ZodString>;
+        headless: z.ZodOptional<z.ZodBoolean>;
+        userDataDir: z.ZodOptional<z.ZodString>;
+        cdpUrl: z.ZodOptional<z.ZodString>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        downloadsDir: z.ZodOptional<z.ZodString>;
+        acceptDownloads: z.ZodOptional<z.ZodBoolean>;
+        actionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        settleMs: z.ZodOptional<z.ZodNumber>;
+        slowMoMs: z.ZodOptional<z.ZodNumber>;
+        locale: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>>;
+        siteRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodString;
+            risk: z.ZodEnum<{
+                download: "download";
+                upload: "upload";
+                read: "read";
+                navigate: "navigate";
+                send_message: "send_message";
+                publish: "publish";
+                purchase: "purchase";
+                delete: "delete";
+                credential_change: "credential_change";
+                permission_change: "permission_change";
+                irreversible: "irreversible";
+                unknown: "unknown";
+            }>;
+            mode: z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+                takeover: "takeover";
+            }>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        borrowTabs: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>;
+        useExistingProfile: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>;
+        clipboard: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+            takeover: "takeover";
+        }>>;
+        secretsRequireTakeover: z.ZodOptional<z.ZodBoolean>;
+        maxTypedLength: z.ZodOptional<z.ZodNumber>;
+        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        blockedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        restrictNavigation: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    budgets: z.ZodOptional<z.ZodObject<{
+        maxSteps: z.ZodOptional<z.ZodNumber>;
+        maxDecisionCalls: z.ZodOptional<z.ZodNumber>;
+        maxPlannerCalls: z.ZodOptional<z.ZodNumber>;
+        maxTextCalls: z.ZodOptional<z.ZodNumber>;
+        maxVisionCalls: z.ZodOptional<z.ZodNumber>;
+        maxCostUsd: z.ZodOptional<z.ZodNumber>;
+        maxDurationMs: z.ZodOptional<z.ZodNumber>;
+        maxRecoveryAttemptsPerStep: z.ZodOptional<z.ZodNumber>;
+        maxRecoveryAttemptsTotal: z.ZodOptional<z.ZodNumber>;
+        maxConsecutiveNoProgress: z.ZodOptional<z.ZodNumber>;
+        maxHumanHelpRequests: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    screenshot: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        "on-failure": "on-failure";
+        always: "always";
+    }>>;
+    providers: z.ZodOptional<z.ZodObject<{
+        decision: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        planner: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    detached: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CreateRunRequest = z.infer<typeof createRunRequestSchema>;
+export declare const helpResolutionSchema: z.ZodObject<{
+    resolution: z.ZodEnum<{
+        takeover: "takeover";
+        completed: "completed";
+        cancelled: "cancelled";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HelpResolution = z.infer<typeof helpResolutionSchema>;
+export declare const approvalResolutionSchema: z.ZodObject<{
+    resolution: z.ZodEnum<{
+        takeover: "takeover";
+        approved: "approved";
+        denied: "denied";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ApprovalResolutionPayload = z.infer<typeof approvalResolutionSchema>;
+export declare const formatZodError: (error: z.ZodError, label?: string) => string;
+export declare const parseOrThrow: <T>(schema: z.ZodType<T>, value: unknown, label?: string) => T;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;iBAI3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAIH,eAAO,MAAM,0BAA0B;;;;;;iBAWrC,CAAC;AAIH,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,mBAAmB,EAAE,kBAAkB,CAuB9F,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAIH,eAAO,MAAM,oBAAoB;;;;;EAA+C,CAAC;AAEjF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;EAa3B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;iBAKzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBzB,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBlC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAY5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;iBAGnC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAIjF,eAAO,MAAM,cAAc,GAAI,OAAO,CAAC,CAAC,QAAQ,EAAE,cAAiB,KAAG,MAIrD,CAAC;AAElB,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,OAAO,EAAE,QAAQ,MAAM,KAAG,CAItF,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,218 @@
+/**
+ * Zod schemas for every untrusted boundary: model responses, policy files,
+ * task files, daemon payloads. Runtime internals use plain TypeScript types;
+ * anything that crosses a trust boundary is parsed here before it is trusted.
+ */
+import { z } from "zod";
+const ACTION_RISKS = [
+    "read",
+    "navigate",
+    "download",
+    "upload",
+    "send_message",
+    "publish",
+    "purchase",
+    "delete",
+    "credential_change",
+    "permission_change",
+    "irreversible",
+    "unknown",
+];
+/* ─────────────────────────── Fast-path (Jev) contract ─────────────────────── */
+export const jevChoiceQuestionSchema = z.object({
+    type: z.literal("choice"),
+    instructions: z.string().min(1),
+    criteria: z.record(z.string(), z.string()),
+});
+export const jevRequestSchema = z.object({
+    model: z.string().min(1),
+    state: z.union([z.string(), z.record(z.string(), z.unknown())]),
+    questions: z.record(z.string(), jevChoiceQuestionSchema),
+});
+export const jevChoiceAnswerSchema = z.object({
+    type: z.literal("choice").optional(),
+    choice: z.string().min(1),
+    confidence: z.number().optional(),
+    probabilities: z.record(z.string(), z.number()).optional(),
+});
+export const jevResponseSchema = z.object({
+    model: z.string().optional(),
+    answers: z.record(z.string(), jevChoiceAnswerSchema),
+    usage: z.record(z.string(), z.number()).optional(),
+});
+/* ───────────────────────────── Text helper contract ───────────────────────── */
+export const textModelResponseSchema = z.object({
+    text: z.string(),
+});
+/* ──────────────────────────── Planner contract ────────────────────────────── */
+export const plannerModelResponseSchema = z.object({
+    subgoals: z
+        .array(z.object({
+        description: z.string().min(1),
+        hints: z.array(z.string()).optional(),
+    }))
+        .min(1)
+        .max(12),
+    notes: z.string().optional(),
+});
+/* ────────────────────────────── Completion spec ───────────────────────────── */
+export const completionCriteriaSchema = z.lazy(() => z.union([
+    z.object({ kind: z.literal("url_contains"), value: z.string() }),
+    z.object({ kind: z.literal("url_matches"), pattern: z.string() }),
+    z.object({ kind: z.literal("title_contains"), value: z.string() }),
+    z.object({
+        kind: z.literal("element_visible"),
+        label: z.string(),
+        role: z.string().optional(),
+    }),
+    z.object({ kind: z.literal("text_visible"), text: z.string() }),
+    z.object({
+        kind: z.literal("artifact"),
+        documentType: z.string().optional(),
+        namePattern: z.string().optional(),
+        minCount: z.number().int().positive().optional(),
+    }),
+    z.object({ kind: z.literal("download_completed") }),
+    z.object({ kind: z.literal("manual"), description: z.string() }),
+    z.object({ kind: z.literal("all"), of: z.array(completionCriteriaSchema).min(1) }),
+    z.object({ kind: z.literal("any"), of: z.array(completionCriteriaSchema).min(1) }),
+    z.object({ kind: z.literal("not"), of: completionCriteriaSchema }),
+]));
+export const completionSpecSchema = z.object({
+    criteria: completionCriteriaSchema,
+    stableForMs: z.number().int().nonnegative().optional(),
+});
+/* ──────────────────────────── Policy file on disk ─────────────────────────── */
+export const permissionModeSchema = z.enum(["allow", "deny", "ask", "takeover"]);
+export const actionRiskSchema = z.enum([
+    "read",
+    "navigate",
+    "download",
+    "upload",
+    "send_message",
+    "publish",
+    "purchase",
+    "delete",
+    "credential_change",
+    "permission_change",
+    "irreversible",
+    "unknown",
+]);
+export const siteRuleSchema = z.object({
+    pattern: z.string().min(1),
+    risk: actionRiskSchema,
+    mode: permissionModeSchema,
+    note: z.string().optional(),
+});
+export const policyFileSchema = z
+    .object({
+    defaults: z.record(z.string(), permissionModeSchema).optional(),
+    siteRules: z.array(siteRuleSchema).optional(),
+    borrowTabs: permissionModeSchema.optional(),
+    useExistingProfile: permissionModeSchema.optional(),
+    clipboard: permissionModeSchema.optional(),
+    secretsRequireTakeover: z.boolean().optional(),
+    maxTypedLength: z.number().int().positive().optional(),
+    allowedOrigins: z.array(z.string()).optional(),
+    blockedOrigins: z.array(z.string()).optional(),
+    restrictNavigation: z.boolean().optional(),
+})
+    .superRefine((value, ctx) => {
+    for (const key of Object.keys(value.defaults ?? {})) {
+        if (!ACTION_RISKS.includes(key)) {
+            ctx.addIssue({ code: "custom", message: `unknown risk "${key}" in defaults`, path: ["defaults", key] });
+        }
+    }
+});
+/* ─────────────────────────────── Task file ────────────────────────────────── */
+export const browserConfigFileSchema = z.object({
+    backend: z.enum(["playwright", "chrome-extension", "mock"]).optional(),
+    mode: z.enum(["managed", "cdp"]).optional(),
+    channel: z.string().optional(),
+    executablePath: z.string().optional(),
+    headless: z.boolean().optional(),
+    userDataDir: z.string().optional(),
+    cdpUrl: z.string().optional(),
+    viewport: z
+        .object({ width: z.number().int().positive(), height: z.number().int().positive() })
+        .optional(),
+    downloadsDir: z.string().optional(),
+    acceptDownloads: z.boolean().optional(),
+    actionTimeoutMs: z.number().int().positive().optional(),
+    settleMs: z.number().int().nonnegative().optional(),
+    slowMoMs: z.number().nonnegative().optional(),
+    locale: z.string().optional(),
+    timezone: z.string().optional(),
+});
+export const budgetsFileSchema = z.object({
+    maxSteps: z.number().int().positive().optional(),
+    maxDecisionCalls: z.number().int().positive().optional(),
+    maxPlannerCalls: z.number().int().nonnegative().optional(),
+    maxTextCalls: z.number().int().nonnegative().optional(),
+    maxVisionCalls: z.number().int().nonnegative().optional(),
+    maxCostUsd: z.number().nonnegative().optional(),
+    maxDurationMs: z.number().int().positive().optional(),
+    maxRecoveryAttemptsPerStep: z.number().int().nonnegative().optional(),
+    maxRecoveryAttemptsTotal: z.number().int().nonnegative().optional(),
+    maxConsecutiveNoProgress: z.number().int().positive().optional(),
+    maxHumanHelpRequests: z.number().int().nonnegative().optional(),
+});
+export const taskFileSchema = z.object({
+    goal: z.string().min(1),
+    startUrl: z.string().optional(),
+    successCriteria: completionSpecSchema.optional(),
+    stopBefore: z.array(z.string()).optional(),
+    budgets: budgetsFileSchema.optional(),
+    browser: browserConfigFileSchema.optional(),
+    policy: policyFileSchema.optional(),
+    screenshot: z.enum(["off", "on-failure", "always"]).optional(),
+    providers: z
+        .object({
+        decision: z.string().optional(),
+        text: z.string().optional(),
+        planner: z.string().optional(),
+        vision: z.string().optional(),
+    })
+        .optional(),
+    forcePlanner: z.boolean().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/* ───────────────────────────── Daemon API shapes ──────────────────────────── */
+export const createRunRequestSchema = z.object({
+    goal: z.string().min(1),
+    startUrl: z.string().optional(),
+    successCriteria: completionSpecSchema.optional(),
+    stopBefore: z.array(z.string()).optional(),
+    browser: browserConfigFileSchema.optional(),
+    policy: policyFileSchema.optional(),
+    budgets: budgetsFileSchema.optional(),
+    screenshot: z.enum(["off", "on-failure", "always"]).optional(),
+    providers: z
+        .object({
+        decision: z.string().optional(),
+        text: z.string().optional(),
+        planner: z.string().optional(),
+    })
+        .optional(),
+    detached: z.boolean().optional(),
+});
+export const helpResolutionSchema = z.object({
+    resolution: z.enum(["completed", "cancelled", "takeover"]),
+    note: z.string().optional(),
+});
+export const approvalResolutionSchema = z.object({
+    resolution: z.enum(["approved", "denied", "takeover"]),
+    note: z.string().optional(),
+});
+/* ─────────────────────────────── helpers ──────────────────────────────────── */
+export const formatZodError = (error, label = "payload") => `${label}: ${error.issues
+    .slice(0, 6)
+    .map((i) => `${i.path.length > 0 ? i.path.join(".") : "(root)"}: ${i.message}`)
+    .join("; ")}`;
+export const parseOrThrow = (schema, value, label) => {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success)
+        throw new Error(formatZodError(parsed.error, label));
+    return parsed.data;
+};
+//# sourceMappingURL=schemas.js.map