@qawolf/api-contracts 0.71.0 → 0.74.0

package/dist/v1/run/getAttemptArtifacts.d.ts

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeGetRunAttemptArtifactsContract: <FlowId extends PublicIdSchema, RunId extends PublicIdSchema, RunAttemptId extends PublicIdSchema>(ids: {
+    flow: FlowId;
+    run: RunId;
+    runAttempt: RunAttemptId;
+}) => {
+    readonly annotations: {
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+        readonly readOnlyHint: true;
+    };
+    readonly description: "Get metadata and signed artifact URLs for one finished run attempt.";
+    readonly input: z.ZodObject<{
+        attemptId: RunAttemptId;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "run.getAttemptArtifacts";
+    readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        flowId: FlowId;
+        flowStatus: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            passed: "passed";
+            canceled: "canceled";
+        }>;
+        retryContext: z.ZodObject<{
+            currentOrdinal: z.ZodNumber;
+            next: z.ZodOptional<z.ZodObject<{
+                attemptId: RunAttemptId;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    passed: "passed";
+                    canceled: "canceled";
+                    skipped: "skipped";
+                    aborted: "aborted";
+                }>;
+            }, z.core.$strip>>;
+            previous: z.ZodOptional<z.ZodObject<{
+                attemptId: RunAttemptId;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    passed: "passed";
+                    canceled: "canceled";
+                    skipped: "skipped";
+                    aborted: "aborted";
+                }>;
+            }, z.core.$strip>>;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+        runId: RunId;
+        runStatus: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            passed: "passed";
+            canceled: "canceled";
+            superseded: "superseded";
+        }>;
+        artifacts: z.ZodObject<{
+            logsUrl: z.ZodOptional<z.ZodURL>;
+            traceUrl: z.ZodOptional<z.ZodURL>;
+            videoUrl: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strip>;
+        artifactStatus: z.ZodLiteral<"signed">;
+        attempt: z.ZodObject<{
+            attemptId: RunAttemptId;
+            completedAt: z.ZodOptional<z.ZodISODateTime>;
+            createdAt: z.ZodISODateTime;
+            error: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodISODateTime>;
+            kind: z.ZodLiteral<"automated">;
+            status: z.ZodEnum<{
+                failed: "failed";
+                passed: "passed";
+                canceled: "canceled";
+                skipped: "skipped";
+                aborted: "aborted";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        flowId: FlowId;
+        flowStatus: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            passed: "passed";
+            canceled: "canceled";
+        }>;
+        retryContext: z.ZodObject<{
+            currentOrdinal: z.ZodNumber;
+            next: z.ZodOptional<z.ZodObject<{
+                attemptId: RunAttemptId;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    passed: "passed";
+                    canceled: "canceled";
+                    skipped: "skipped";
+                    aborted: "aborted";
+                }>;
+            }, z.core.$strip>>;
+            previous: z.ZodOptional<z.ZodObject<{
+                attemptId: RunAttemptId;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    passed: "passed";
+                    canceled: "canceled";
+                    skipped: "skipped";
+                    aborted: "aborted";
+                }>;
+            }, z.core.$strip>>;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+        runId: RunId;
+        runStatus: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            passed: "passed";
+            canceled: "canceled";
+            superseded: "superseded";
+        }>;
+        artifacts: z.ZodObject<{}, z.core.$strict>;
+        artifactStatus: z.ZodLiteral<"signing-failed">;
+        attempt: z.ZodObject<{
+            attemptId: RunAttemptId;
+            completedAt: z.ZodOptional<z.ZodISODateTime>;
+            createdAt: z.ZodISODateTime;
+            error: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodISODateTime>;
+            kind: z.ZodLiteral<"automated">;
+            status: z.ZodEnum<{
+                failed: "failed";
+                passed: "passed";
+                canceled: "canceled";
+                skipped: "skipped";
+                aborted: "aborted";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        flowId: FlowId;
+        flowStatus: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            passed: "passed";
+            canceled: "canceled";
+        }>;
+        retryContext: z.ZodObject<{
+            currentOrdinal: z.ZodNumber;
+            next: z.ZodOptional<z.ZodObject<{
+                attemptId: RunAttemptId;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    passed: "passed";
+                    canceled: "canceled";
+                    skipped: "skipped";
+                    aborted: "aborted";
+                }>;
+            }, z.core.$strip>>;
+            previous: z.ZodOptional<z.ZodObject<{
+                attemptId: RunAttemptId;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    passed: "passed";
+                    canceled: "canceled";
+                    skipped: "skipped";
+                    aborted: "aborted";
+                }>;
+            }, z.core.$strip>>;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+        runId: RunId;
+        runStatus: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            passed: "passed";
+            canceled: "canceled";
+            superseded: "superseded";
+        }>;
+        artifacts: z.ZodObject<{}, z.core.$strict>;
+        artifactStatus: z.ZodLiteral<"not-captured">;
+        attempt: z.ZodObject<{
+            attemptId: RunAttemptId;
+            completedAt: z.ZodOptional<z.ZodISODateTime>;
+            createdAt: z.ZodISODateTime;
+            error: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodISODateTime>;
+            kind: z.ZodLiteral<"manual">;
+            status: z.ZodLiteral<"passed">;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "artifactStatus">;
+};
+//# sourceMappingURL=getAttemptArtifacts.d.ts.map

package/dist/v1/run/getAttemptArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAttemptArtifacts.d.ts","sourceRoot":"","sources":["../../../src/v1/run/getAttemptArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD,eAAO,MAAM,kCAAkC,GAC7C,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,EACnC,KAAK;IACL,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;IACX,UAAU,EAAE,YAAY,CAAC;CAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFA,CAAC"}

package/dist/v1/run/getAttemptArtifacts.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { publicRunStatusValues, publicRunSummaryStatusValues, } from "./summary.js";
+export const makeGetRunAttemptArtifactsContract = (ids) => {
+    const input = z.object({ attemptId: ids.runAttempt });
+    const attemptStatus = z.enum([
+        "passed",
+        "failed",
+        "canceled",
+        "aborted",
+        "skipped",
+    ]);
+    const attemptNeighbor = z.object({
+        attemptId: ids.runAttempt,
+        status: attemptStatus,
+    });
+    const response = z.object({
+        flowId: ids.flow,
+        flowStatus: z.enum(publicRunStatusValues),
+        retryContext: z.object({
+            currentOrdinal: z.number().int().min(1),
+            next: attemptNeighbor.optional(),
+            previous: attemptNeighbor.optional(),
+            total: z.number().int().min(1),
+        }),
+        runId: ids.run,
+        runStatus: z.enum(publicRunSummaryStatusValues),
+    });
+    const attempt = z.object({
+        attemptId: ids.runAttempt,
+        completedAt: z.iso.datetime().optional(),
+        createdAt: z.iso.datetime(),
+        error: z.string().optional(),
+        startedAt: z.iso.datetime().optional(),
+    });
+    const output = z.discriminatedUnion("artifactStatus", [
+        response.extend({
+            artifacts: z.object({
+                logsUrl: z.url().optional(),
+                traceUrl: z.url().optional(),
+                videoUrl: z.url().optional(),
+            }),
+            artifactStatus: z.literal("signed"),
+            attempt: attempt.extend({
+                kind: z.literal("automated"),
+                status: attemptStatus,
+            }),
+        }),
+        response.extend({
+            artifacts: z.object({}).strict(),
+            artifactStatus: z.literal("signing-failed"),
+            attempt: attempt.extend({
+                kind: z.literal("automated"),
+                status: attemptStatus,
+            }),
+        }),
+        response.extend({
+            artifacts: z.object({}).strict(),
+            artifactStatus: z.literal("not-captured"),
+            attempt: attempt.extend({
+                kind: z.literal("manual"),
+                status: z.literal("passed"),
+            }),
+        }),
+    ]);
+    return {
+        annotations: {
+            destructiveHint: false,
+            openWorldHint: false,
+            readOnlyHint: true,
+        },
+        description: "Get metadata and signed artifact URLs for one finished run attempt.",
+        input,
+        kind: "read",
+        name: "run.getAttemptArtifacts",
+        output,
+    };
+};
+//# sourceMappingURL=getAttemptArtifacts.js.map

package/dist/v1/run/getAttemptArtifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAttemptArtifacts.js","sourceRoot":"","sources":["../../../src/v1/run/getAttemptArtifacts.ts"],"names":[],"mappings":"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"}

package/dist/v1/run/summary.d.ts

@@ -2,6 +2,13 @@ import { z } from "zod";
 import type { PublicIdSchema } from "../ids.js";
 /** The public status vocabulary, shared by a run and by each of its flows. */
 export declare const publicRunStatusValues: readonly ["queued", "running", "passed", "failed", "canceled"];
+/**
+ * The run's own status vocabulary: the flow values plus the states only a
+ * whole run can be in. The deployment verdict's runs share it, so the two
+ * cannot disagree about a run; flow statuses and the `flowStatuses` filter
+ * keep the five shared values.
+ */
+export declare const publicRunSummaryStatusValues: readonly ["queued", "running", "passed", "failed", "canceled", "superseded"];
 export declare const makeRunSummaryFields: <RunId extends PublicIdSchema>(ids: {
     run: RunId;
 }) => {
@@ -13,6 +20,7 @@ export declare const makeRunSummaryFields: <RunId extends PublicIdSchema>(ids: {
         commitSha: z.ZodOptional<z.ZodString>;
         commitUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+    needsReview: z.ZodOptional<z.ZodBoolean>;
     runId: RunId;
     status: z.ZodEnum<{
         failed: "failed";
@@ -20,6 +28,11 @@ export declare const makeRunSummaryFields: <RunId extends PublicIdSchema>(ids: {
         running: "running";
         passed: "passed";
         canceled: "canceled";
+        superseded: "superseded";
     }>;
+    supersededBy: z.ZodOptional<z.ZodObject<{
+        runId: RunId;
+        url: z.ZodURL;
+    }, z.core.$strip>>;
 };
 //# sourceMappingURL=summary.d.ts.map

package/dist/v1/run/summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/v1/run/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,gEAMxB,CAAC;AAKX,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,cAAc,EAAE,KAAK;IACtE,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;CAkCC,CAAC"}
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/v1/run/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,gEAMxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,8EAG/B,CAAC;AAKX,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,cAAc,EAAE,KAAK;IACtE,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;CAiDC,CAAC"}

package/dist/v1/run/summary.js

@@ -7,6 +7,16 @@ export const publicRunStatusValues = [
     "failed",
     "canceled",
 ];
+/**
+ * The run's own status vocabulary: the flow values plus the states only a
+ * whole run can be in. The deployment verdict's runs share it, so the two
+ * cannot disagree about a run; flow statuses and the `flowStatuses` filter
+ * keep the five shared values.
+ */
+export const publicRunSummaryStatusValues = [
+    ...publicRunStatusValues,
+    "superseded",
+];
 // The shared run summary fields. run.find returns them as rows. run.get adds
 // the per-flow results to them. Both shapes come from this one factory, so
 // the shapes cannot become different.
@@ -31,12 +41,23 @@ export const makeRunSummaryFields = (ids) => ({
             .describe("Link to the commit on the code host."),
     })
         .describe("The branch and commit under test. The fields are present when a deploy notification started the run, and absent for runs started another way, for example manually or with run.create."),
+    needsReview: z
+        .boolean()
+        .optional()
+        .describe("True once every flow has finished its attempts and at least one failed flow still has no diagnosis, including one whose investigation carried over to a later run. `status` stays `running` until that failure is diagnosed, so a caller that is not waiting for a diagnosis can stop polling here and read the run's failed flows."),
     // Deliberately not described here: run.find builds its rows from this factory
     // too, and its rows answer no requested id, so wording about the id you asked
     // for belongs on run.get alone.
     runId: ids.run,
     status: z
-        .enum(publicRunStatusValues)
-        .describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, and canceled; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer."),
+        .enum(publicRunSummaryStatusValues)
+        .describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, canceled, and superseded; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer, and `needsReview` tells such a run apart from one that is still executing. `superseded` means a newer run replaced this one before it finished: it is not a pass, this run will never change again, and the verdict belongs to the run in `supersededBy`."),
+    supersededBy: z
+        .object({
+        runId: ids.run,
+        url: z.url().describe("Absolute URL of the replacement run's page."),
+    })
+        .optional()
+        .describe("The run that replaced this one, present only when `status` is `superseded`. A newer deployment to the same branch and environment (and service, when the deployment named one) cancels the older run's unfinished flows and takes over. Deduplication ignores the commit, so the replacement may be testing a later commit than this run did. Only the direct replacement is named; that run can itself be superseded."),
 });
 //# sourceMappingURL=summary.js.map

package/dist/v1/run/summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/v1/run/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;CACF,CAAC;AAEX,6EAA6E;AAC7E,2EAA2E;AAC3E,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAA+B,GAElE,EAAE,EAAE,CAAC,CAAC;IACL,WAAW,EAAE,CAAC,CAAC,GAAG;SACf,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,+KAA+K,CAChL;IACH,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,wEAAwE;QACxE,uEAAuE;QACvE,sEAAsE;QACtE,mDAAmD;QACnD,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,CAAC;KACpD,CAAC;SACD,QAAQ,CACP,wLAAwL,CACzL;IACH,8EAA8E;IAC9E,8EAA8E;IAC9E,gCAAgC;IAChC,KAAK,EAAE,GAAG,CAAC,GAAG;IACd,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,qBAAqB,CAAC;SAC3B,QAAQ,CACP,4eAA4e,CAC7e;CACJ,CAAC,CAAC"}
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/v1/run/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;CACF,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,qBAAqB;IACxB,YAAY;CACJ,CAAC;AAEX,6EAA6E;AAC7E,2EAA2E;AAC3E,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAA+B,GAElE,EAAE,EAAE,CAAC,CAAC;IACL,WAAW,EAAE,CAAC,CAAC,GAAG;SACf,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,+KAA+K,CAChL;IACH,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,wEAAwE;QACxE,uEAAuE;QACvE,sEAAsE;QACtE,mDAAmD;QACnD,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,CAAC;KACpD,CAAC;SACD,QAAQ,CACP,wLAAwL,CACzL;IACH,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,qUAAqU,CACtU;IACH,8EAA8E;IAC9E,8EAA8E;IAC9E,gCAAgC;IAChC,KAAK,EAAE,GAAG,CAAC,GAAG;IACd,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,4BAA4B,CAAC;SAClC,QAAQ,CACP,kvBAAkvB,CACnvB;IACH,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC;QACN,KAAK,EAAE,GAAG,CAAC,GAAG;QACd,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KACrE,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,wZAAwZ,CACzZ;CACJ,CAAC,CAAC"}

package/dist/v1/runner/browserAction.d.ts

@@ -1,4 +1,9 @@
 import { z } from "zod";
+export declare const screenCoordinateSchema: z.ZodInt;
+export declare const screenPointSchema: z.ZodObject<{
+    x: z.ZodInt;
+    y: z.ZodInt;
+}, z.core.$strict>;
 /** The keyboard is held for 50 ms per character, so 200 of them is ten seconds. */
 export declare const maxTypedTextLength = 200;
 /** Only the two schemes a browser navigation means, matched on the parsed scheme. */

package/dist/v1/runner/browserAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserAction.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/browserAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAatC,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,UAEH,CAAC;AAE7B,iFAAiF;AACjF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA+C9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"browserAction.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/browserAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,sBAAsB,UAA0C,CAAC;AAE9E,eAAO,MAAM,iBAAiB;;;kBAG5B,CAAC;AAOH,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAatC,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,UAEH,CAAC;AAE7B,iFAAiF;AACjF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA+C9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/v1/runner/browserAction.js

@@ -1,15 +1,15 @@
 import { z } from "zod";
 /**
- * The input of `runner.performAction`, validated with the same schema by apex and
- * the runner. Only ever tighten a bound: pods deploy separately, so a widened
- * bound forwards actions an older pod rejects.
+ * The actions a browser runner performs, validated with the same schema by apex
+ * and the runner. Only ever tighten a bound: pods deploy separately, so a
+ * widened bound forwards actions an older pod rejects.
  *
  * `snake_case` on purpose: these are the computer-use tool names.
  */
 /** A whole pixel on the runner's virtual desktop. */
 const maxScreenCoordinate = 20_000;
-const screenCoordinateSchema = z.int().min(0).max(maxScreenCoordinate);
-const screenPointSchema = z.strictObject({
+export const screenCoordinateSchema = z.int().min(0).max(maxScreenCoordinate);
+export const screenPointSchema = z.strictObject({
     x: screenCoordinateSchema,
     y: screenCoordinateSchema,
 });

package/dist/v1/runner/browserAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserAction.js","sourceRoot":"","sources":["../../../src/v1/runner/browserAction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browserAction.js","sourceRoot":"","sources":["../../../src/v1/runner/browserAction.ts"],"names":[],"mappings":"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"}

package/dist/v1/runner/catalog.d.ts

@@ -40,12 +40,14 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
                 playwright: "playwright";
                 android: "android";
                 ios: "ios";
+                windows: "windows";
             }>;
             runnerName: import("zod").ZodEnum<{
                 basic: "basic";
                 playwright: "playwright";
                 android: "android";
                 ios: "ios";
+                windows: "windows";
             }>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             failureReason: import("zod").ZodLiteral<"needs-full-sync">;
@@ -85,7 +87,7 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
             readonly openWorldHint: false;
             readonly readOnlyHint: false;
         };
-        readonly description: "Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. `screen-needs-a-run` if the runner's virtual desktop has never started. Waiting will not change this and retrying is pointless — call `runner.runFlow` with a flow that opens a browser, then ask for the screen again. On a runner image with a browser that has never run anything, any `runner.performAction` also starts the browser itself. Evaluating a snippet does not start the desktop. `screen-not-ready` if the runner has a screen that cannot serve this instant. Retry in a second or two: the desktop restarts when a run changes the display size, and it serves one see-or-act request at a time, so a screenshot or action already in flight is the usual reason. Do not submit a run to clear this — a run may restart the display and discard what is on it. `runner-has-no-screen` if this runner is not one that runs a browser on a virtual desktop. Nothing about it can be seen or driven, and retrying will never help — launch a `playwright` runner instead. `runner-unreachable` if the runner could not be reached: it may still be starting, it may have terminated after inactivity, or it may be too busy to answer. Nothing was changed, so retrying is safe; if it persists, launch the runner again.";
+        readonly description: "Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. `screen-needs-a-run` if the runner's virtual desktop has never started. Waiting will not change this and retrying is pointless — call `runner.runFlow` with a flow that opens a browser, then ask for the screen again. On a runner image with a browser that has never run anything, any `runner.performAction` also starts the browser itself. Evaluating a snippet does not start the desktop. `screen-not-ready` if the runner has a screen that cannot serve this instant. Retry in a second or two: the desktop restarts when a run changes the display size, and it serves one see-or-act request at a time, so a screenshot or action already in flight is the usual reason. Do not submit a run to clear this — a run may restart the display and discard what is on it. `runner-has-no-screen` if this runner has no browser desktop to see or drive, and retrying will never help. Launch a `playwright` runner, or on `windows` use `runner.runFlow`. `runner-unreachable` if the runner could not be reached: it may still be starting, it may have terminated after inactivity, or it may be too busy to answer. Nothing was changed, so retrying is safe; if it persists, launch the runner again.";
         readonly input: import("zod").ZodObject<{
             id: import("zod").ZodString;
             workspaceId: import("zod").ZodOptional<WorkspaceId>;
@@ -623,6 +625,7 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
                 playwright: "playwright";
                 android: "android";
                 ios: "ios";
+                windows: "windows";
             }>>;
             workspaceId: import("zod").ZodOptional<WorkspaceId>;
         }, import("zod/v4/core").$strip>;
@@ -636,6 +639,7 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
                 playwright: "playwright";
                 android: "android";
                 ios: "ios";
+                windows: "windows";
             }>;
             url: import("zod").ZodURL;
             alreadyRunning: import("zod").ZodBoolean;
@@ -664,6 +668,7 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
@@ -675,7 +680,7 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
             readonly openWorldHint: true;
             readonly readOnlyHint: false;
         };
-        readonly description: "Perform one raw browser action on an interactive runner: click, double_click, move, drag, scroll, keypress, type, or navigate. One action per request, and the runner serves one at a time. A success means the action took effect. `action-failed`, with a reason, if it reached the runner and did not take effect. On a runner image with a browser, the first action on a runner that has never run anything starts its browser and waits for it, so it can take up to a minute to answer — no `runner.runFlow` is needed before acting; if the browser is still starting when the wait runs out, the answer is `screen-not-ready` and retrying converges. On a mobile runner, the same `screen-needs-a-run` and `screen-not-ready` outcomes mean no Appium session has started yet, or it did not answer this instant; `runner.runFlow` is what starts one, same as a browser. `screen-needs-a-run` if the browser could not be started that way — usually a runner whose runs all finished without starting its desktop; call `runner.runFlow` with a flow that opens a browser. `screen-not-ready` if the runner has a screen that cannot serve this instant. Retry in a second or two: the desktop restarts when a run changes the display size, and it serves one see-or-act request at a time, so a screenshot or action already in flight is the usual reason. Do not submit a run to clear this — a run may restart the display and discard what is on it. `runner-has-no-screen` if this runner is not one that runs a browser on a virtual desktop. Nothing about it can be seen or driven, and retrying will never help — launch a `playwright` runner instead. `runner-unreachable` if the runner could not be reached: it may still be starting, it may have terminated after inactivity, or it may have stopped answering mid-action. This does not mean the action was not performed — take a screenshot before repeating it.";
+        readonly description: "Perform one raw action on an interactive runner: click, double_click, move, drag, scroll, keypress, type, or navigate; on mobile, tap, swipe, fill, or type. One action per request, and the runner serves one at a time. A success means the action took effect. `action-failed`, with a reason, if it reached the runner and did not take effect. On a runner image with a browser, the first action on a runner that has never run anything starts its browser and waits for it, so it can take up to a minute to answer — no `runner.runFlow` is needed before acting; if the browser is still starting when the wait runs out, the answer is `screen-not-ready` and retrying converges. On a mobile runner, the same `screen-needs-a-run` and `screen-not-ready` outcomes mean no Appium session has started yet, or it did not answer this instant; `runner.runFlow` is what starts one, same as a browser. `screen-needs-a-run` if the browser could not be started that way — usually a runner whose runs all finished without starting its desktop; call `runner.runFlow` with a flow that opens a browser. `screen-not-ready` if the runner has a screen that cannot serve this instant. Retry in a second or two: the desktop restarts when a run changes the display size, and it serves one see-or-act request at a time, so a screenshot or action already in flight is the usual reason. Do not submit a run to clear this — a run may restart the display and discard what is on it. `runner-has-no-screen` if this runner has no browser desktop to see or drive, and retrying will never help. Launch a `playwright` runner, or on `windows` use `runner.runFlow`. `runner-unreachable` if the runner could not be reached: it may still be starting, it may have terminated after inactivity, or it may have stopped answering mid-action. This does not mean the action was not performed — take a screenshot before repeating it.";
         readonly input: import("zod").ZodObject<{
             action: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
                 button: import("zod").ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;
@@ -711,6 +716,36 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
             }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
                 text: import("zod").ZodString;
                 type: import("zod").ZodLiteral<"type">;
+            }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+                selector: import("zod").ZodOptional<import("zod").ZodString>;
+                strategy: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    "ios-predicate": "ios-predicate";
+                    shadow: "shadow";
+                    xpath: "xpath";
+                }>>;
+                type: import("zod").ZodLiteral<"tap">;
+                x: import("zod").ZodOptional<import("zod").ZodInt>;
+                y: import("zod").ZodOptional<import("zod").ZodInt>;
+            }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+                duration_ms: import("zod").ZodOptional<import("zod").ZodInt>;
+                from: import("zod").ZodObject<{
+                    x: import("zod").ZodInt;
+                    y: import("zod").ZodInt;
+                }, import("zod/v4/core").$strict>;
+                to: import("zod").ZodObject<{
+                    x: import("zod").ZodInt;
+                    y: import("zod").ZodInt;
+                }, import("zod/v4/core").$strict>;
+                type: import("zod").ZodLiteral<"swipe">;
+            }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+                selector: import("zod").ZodString;
+                strategy: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    "ios-predicate": "ios-predicate";
+                    shadow: "shadow";
+                    xpath: "xpath";
+                }>>;
+                text: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"fill">;
             }, import("zod/v4/core").$strict>], "type">;
             id: import("zod").ZodString;
             withScreenshot: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -733,6 +768,7 @@ export declare const makeRunnerContracts: <FlowId extends PublicIdSchema, Worksp
                 "screen-not-ready": "screen-not-ready";
                 "runner-has-no-screen": "runner-has-no-screen";
                 "action-not-supported-on-mobile": "action-not-supported-on-mobile";
+                "action-not-supported-on-browser": "action-not-supported-on-browser";
             }>;
             outcome: import("zod").ZodLiteral<"failure">;
         }, import("zod/v4/core").$strip>], "failureReason">], "outcome">;

package/dist/v1/runner/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAsBhD,eAAO,MAAM,mBAAmB,GAC9B,MAAM,SAAS,cAAc,EAC7B,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBC,CAAC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAsBhD,eAAO,MAAM,mBAAmB,GAC9B,MAAM,SAAS,cAAc,EAC7B,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBC,CAAC"}

package/dist/v1/runner/identity.d.ts

@@ -4,6 +4,7 @@ export declare const runnerNameSchema: z.ZodEnum<{
     playwright: "playwright";
     android: "android";
     ios: "ios";
+    windows: "windows";
 }>;
 export type RunnerNameForPublicApi = z.infer<typeof runnerNameSchema>;
 export declare const runnerWorkspaceRequirement = "Read it from whoami.";
@@ -19,6 +20,7 @@ export declare const makeRunnerSchema: () => z.ZodObject<{
         playwright: "playwright";
         android: "android";
         ios: "ios";
+        windows: "windows";
     }>;
     url: z.ZodURL;
 }, z.core.$strip>;

package/dist/v1/runner/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE,eAAO,MAAM,4BAA4B,8DAAuE,CAAC;AAEjH,eAAO,MAAM,cAAc,aAOxB,CAAC;AAEJ,eAAO,MAAM,oBAAoB,UAI9B,CAAC;AAEJ,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAczB,CAAC"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;EAM3B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE,eAAO,MAAM,4BAA4B,8DAAuE,CAAC;AAEjH,eAAO,MAAM,cAAc,aAOxB,CAAC;AAEJ,eAAO,MAAM,oBAAoB,UAI9B,CAAC;AAEJ,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAczB,CAAC"}

package/dist/v1/runner/identity.js

@@ -4,6 +4,7 @@ export const runnerNameSchema = z.enum([
     "playwright",
     "android",
     "ios",
+    "windows",
 ]);
 export const runnerWorkspaceRequirement = "Read it from whoami.";
 export const runnerWorkspaceIdDescription = `The workspace the runner belongs to. ${runnerWorkspaceRequirement}`;

package/dist/v1/runner/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/v1/runner/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,OAAO;IACP,YAAY;IACZ,SAAS;IACT,KAAK;CACN,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAEjE,MAAM,CAAC,MAAM,4BAA4B,GAAG,wCAAwC,0BAA0B,EAAE,CAAC;AAEjH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACJ,iCAAiC,EACjC,mHAAmH,CACpH,CAAC;AAEJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,GAAG,EAAE;KACL,QAAQ,CACP,skBAAskB,CACvkB,CAAC;AAEJ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CACnC,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,CACP,+IAA+I,CAChJ;IACH,EAAE,EAAE,cAAc,CAAC,QAAQ,CACzB,iDAAiD,CAClD;IACD,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CACnC,gIAAgI,CACjI;IACD,GAAG,EAAE,oBAAoB;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/v1/runner/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,OAAO;IACP,YAAY;IACZ,SAAS;IACT,KAAK;IACL,SAAS;CACV,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAEjE,MAAM,CAAC,MAAM,4BAA4B,GAAG,wCAAwC,0BAA0B,EAAE,CAAC;AAEjH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACJ,iCAAiC,EACjC,mHAAmH,CACpH,CAAC;AAEJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,GAAG,EAAE;KACL,QAAQ,CACP,skBAAskB,CACvkB,CAAC;AAEJ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CACnC,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,CACP,+IAA+I,CAChJ;IACH,EAAE,EAAE,cAAc,CAAC,QAAQ,CACzB,iDAAiD,CAClD;IACD,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CACnC,gIAAgI,CACjI;IACD,GAAG,EAAE,oBAAoB;CAC1B,CAAC,CAAC"}

package/dist/v1/runner/index.d.ts

@@ -17,6 +17,7 @@ export declare const makeLaunchRunnerContract: <WorkspaceId extends PublicIdSche
             playwright: "playwright";
             android: "android";
             ios: "ios";
+            windows: "windows";
         }>>;
         workspaceId: z.ZodOptional<WorkspaceId>;
     }, z.core.$strip>;
@@ -30,6 +31,7 @@ export declare const makeLaunchRunnerContract: <WorkspaceId extends PublicIdSche
             playwright: "playwright";
             android: "android";
             ios: "ios";
+            windows: "windows";
         }>;
         url: z.ZodURL;
         alreadyRunning: z.ZodBoolean;

package/dist/v1/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAWhD,eAAO,MAAM,wBAAwB,GACnC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DA,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;CAmCA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAWhD,eAAO,MAAM,wBAAwB,GACnC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DA,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;CAmCA,CAAC"}

package/dist/v1/runner/inspectMobile.d.ts

@@ -1,5 +1,11 @@
 import { z } from "zod";
 import type { PublicIdSchema } from "../ids.js";
+/** Duplicated from the private `domain-runner-types` package, which this published one can't import. */
+export declare const selectorStrategySchema: z.ZodEnum<{
+    "ios-predicate": "ios-predicate";
+    shadow: "shadow";
+    xpath: "xpath";
+}>;
 export declare const inspectMobileRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     what: z.ZodLiteral<"session">;
 }, z.core.$strip>, z.ZodObject<{

package/dist/v1/runner/inspectMobile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspectMobile.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/inspectMobile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA8DhD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA0BrC,CAAC;AA4CH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,iCAAiC,GAC5C,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCA,CAAC"}
+{"version":3,"file":"inspectMobile.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/inspectMobile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAuBhD,wGAAwG;AACxG,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAC;AAsCH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA0BrC,CAAC;AA4CH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,iCAAiC,GAC5C,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCA,CAAC"}