@qawolf/api-contracts 0.71.0 → 0.74.0

package/dist/v1/index.d.ts

@@ -11,7 +11,9 @@ export type PublicApiOutput<Api extends AnyPublicApiContract> = z.infer<Api["out
  * the same factory with its own strict id schemas, so the contract shape can
  * never drift between the two while validation strictness stays server-owned.
  */
-export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, IssueId extends PublicIdSchema = PublicIdSchema, WorkspaceId extends PublicIdSchema = PublicIdSchema, AiTaskId extends PublicIdSchema = PublicIdSchema, ChatSessionId extends PublicIdSchema = PublicIdSchema, TriggerId extends PublicIdSchema = PublicIdSchema, DeploymentId extends PublicIdSchema = PublicIdSchema, LegacyTriggerId extends PublicIdSchema = PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, IssueId, WorkspaceId, AiTaskId, ChatSessionId, TriggerId, DeploymentId, LegacyTriggerId>) => {
+export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, IssueId extends PublicIdSchema = PublicIdSchema, WorkspaceId extends PublicIdSchema = PublicIdSchema, AiTaskId extends PublicIdSchema = PublicIdSchema, ChatSessionId extends PublicIdSchema = PublicIdSchema, TriggerId extends PublicIdSchema = PublicIdSchema, DeploymentId extends PublicIdSchema = PublicIdSchema, LegacyTriggerId extends PublicIdSchema = PublicIdSchema, RunAttemptId extends PublicIdSchema = PublicIdSchema>(ids: Omit<PublicIdSchemasOf<EnvironmentId, FlowId, RunId, IssueId, WorkspaceId, AiTaskId, ChatSessionId, TriggerId, DeploymentId, LegacyTriggerId, RunAttemptId>, "runAttempt"> & {
+    runAttempt?: RunAttemptId;
+}) => {
     agent: {
         get: {
             readonly annotations: {
@@ -204,17 +206,17 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                             conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"matched">;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"did-not-match">;
                                 reason: z.ZodString;
@@ -264,17 +266,17 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                             conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"matched">;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"did-not-match">;
                                 reason: z.ZodString;
@@ -1125,6 +1127,30 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     urgent: "urgent";
                 }>>;
                 workspaceId: z.ZodOptional<WorkspaceId>;
+            }, z.core.$strip>, z.ZodObject<{
+                effort: z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    extraSmall: "extraSmall";
+                    large: "large";
+                    extraLarge: "extraLarge";
+                }>;
+                priority: z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    urgent: "urgent";
+                }>;
+                reason: z.ZodEnum<{
+                    dataChanged: "dataChanged";
+                    flowNeedsWork: "flowNeedsWork";
+                    other: "other";
+                    uiChanged: "uiChanged";
+                }>;
+                type: z.ZodLiteral<"maintenance">;
+                description: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                workspaceId: z.ZodOptional<WorkspaceId>;
             }, z.core.$strip>], "type">;
             readonly kind: "write";
             readonly name: "issue.create";
@@ -1628,7 +1654,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 readonly openWorldHint: false;
                 readonly readOnlyHint: true;
             };
-            readonly description: "List an environment's recent runs, newest first.";
+            readonly description: "List an environment's recent runs, newest first, including failed-attempt discovery metadata.";
             readonly input: z.ZodObject<{
                 environmentId: PublicIdSchema;
                 workspaceId: z.ZodOptional<WorkspaceId>;
@@ -1641,6 +1667,8 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             readonly output: z.ZodObject<{
                 nextCursor: z.ZodOptional<z.ZodString>;
                 runs: z.ZodArray<z.ZodObject<{
+                    failedAttemptCount: z.ZodOptional<z.ZodNumber>;
+                    hasFailedAttempts: z.ZodOptional<z.ZodBoolean>;
                     completedAt: z.ZodOptional<z.ZodISODateTime>;
                     createdAt: z.ZodISODateTime;
                     git: z.ZodObject<{
@@ -1649,6 +1677,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         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";
@@ -1656,7 +1685,12 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         running: "running";
                         passed: "passed";
                         canceled: "canceled";
+                        superseded: "superseded";
                     }>;
+                    supersededBy: z.ZodOptional<z.ZodObject<{
+                        runId: RunId;
+                        url: z.ZodURL;
+                    }, z.core.$strip>>;
                     url: z.ZodURL;
                 }, z.core.$strip>>;
             }, z.core.$strip>;
@@ -1684,6 +1718,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 blockingBugCount: z.ZodNumber;
                 flows: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodISODateTime;
@@ -1692,6 +1727,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
@@ -1700,11 +1736,13 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodOptional<z.ZodISODateTime>;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
                         status: z.ZodLiteral<"canceled">;
                     }, z.core.$strip>], "status">, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"manual">;
                         startedAt: z.ZodISODateTime;
@@ -1725,6 +1763,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     status: z.ZodLiteral<"failed">;
                 }, z.core.$strip>, z.ZodObject<{
                     attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodISODateTime;
@@ -1733,6 +1772,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
@@ -1741,11 +1781,13 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodOptional<z.ZodISODateTime>;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
                         status: z.ZodLiteral<"canceled">;
                     }, z.core.$strip>], "status">, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"manual">;
                         startedAt: z.ZodISODateTime;
@@ -1769,16 +1811,211 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     commitSha: z.ZodOptional<z.ZodString>;
                     commitUrl: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>;
+                needsReview: z.ZodOptional<z.ZodBoolean>;
                 status: z.ZodEnum<{
                     failed: "failed";
                     queued: "queued";
                     running: "running";
                     passed: "passed";
                     canceled: "canceled";
+                    superseded: "superseded";
                 }>;
+                supersededBy: z.ZodOptional<z.ZodObject<{
+                    runId: RunId;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
+        getAttemptArtifacts: {
+            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: PublicIdSchema;
+            }, 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: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    previous: z.ZodOptional<z.ZodObject<{
+                        attemptId: PublicIdSchema;
+                        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: PublicIdSchema;
+                    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: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    previous: z.ZodOptional<z.ZodObject<{
+                        attemptId: PublicIdSchema;
+                        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: PublicIdSchema;
+                    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: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    previous: z.ZodOptional<z.ZodObject<{
+                        attemptId: PublicIdSchema;
+                        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: PublicIdSchema;
+                    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">;
+        };
         reattempt: {
             readonly annotations: {
                 readonly destructiveHint: true;
@@ -1858,12 +2095,14 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
                 runnerName: z.ZodEnum<{
                     basic: "basic";
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 failureReason: z.ZodLiteral<"needs-full-sync">;
@@ -1903,7 +2142,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 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: z.ZodObject<{
                 id: z.ZodString;
                 workspaceId: z.ZodOptional<WorkspaceId>;
@@ -2441,6 +2680,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>>;
                 workspaceId: z.ZodOptional<WorkspaceId>;
             }, z.core.$strip>;
@@ -2454,6 +2694,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
                 url: z.ZodURL;
                 alreadyRunning: z.ZodBoolean;
@@ -2482,6 +2723,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         playwright: "playwright";
                         android: "android";
                         ios: "ios";
+                        windows: "windows";
                     }>;
                     url: z.ZodURL;
                 }, z.core.$strip>>;
@@ -2493,7 +2735,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 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: z.ZodObject<{
                 action: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     button: z.ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;
@@ -2529,6 +2771,36 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 }, z.core.$strict>, z.ZodObject<{
                     text: z.ZodString;
                     type: z.ZodLiteral<"type">;
+                }, z.core.$strict>, z.ZodObject<{
+                    selector: z.ZodOptional<z.ZodString>;
+                    strategy: z.ZodOptional<z.ZodEnum<{
+                        "ios-predicate": "ios-predicate";
+                        shadow: "shadow";
+                        xpath: "xpath";
+                    }>>;
+                    type: z.ZodLiteral<"tap">;
+                    x: z.ZodOptional<z.ZodInt>;
+                    y: z.ZodOptional<z.ZodInt>;
+                }, z.core.$strict>, z.ZodObject<{
+                    duration_ms: z.ZodOptional<z.ZodInt>;
+                    from: z.ZodObject<{
+                        x: z.ZodInt;
+                        y: z.ZodInt;
+                    }, z.core.$strict>;
+                    to: z.ZodObject<{
+                        x: z.ZodInt;
+                        y: z.ZodInt;
+                    }, z.core.$strict>;
+                    type: z.ZodLiteral<"swipe">;
+                }, z.core.$strict>, z.ZodObject<{
+                    selector: z.ZodString;
+                    strategy: z.ZodOptional<z.ZodEnum<{
+                        "ios-predicate": "ios-predicate";
+                        shadow: "shadow";
+                        xpath: "xpath";
+                    }>>;
+                    text: z.ZodString;
+                    type: z.ZodLiteral<"fill">;
                 }, z.core.$strict>], "type">;
                 id: z.ZodString;
                 withScreenshot: z.ZodOptional<z.ZodBoolean>;
@@ -2551,6 +2823,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     "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: z.ZodLiteral<"failure">;
             }, z.core.$strip>], "failureReason">], "outcome">;
@@ -3687,17 +3960,17 @@ export declare const publicContractsV1: {
                             conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"matched">;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"did-not-match">;
                                 reason: z.ZodString;
@@ -3747,17 +4020,17 @@ export declare const publicContractsV1: {
                             conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"matched">;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodEnum<{
                                     branch: "branch";
+                                    environment: "environment";
                                     deployTarget: "deployTarget";
                                     service: "service";
-                                    environment: "environment";
                                 }>;
                                 outcome: z.ZodLiteral<"did-not-match">;
                                 reason: z.ZodString;
@@ -4608,6 +4881,30 @@ export declare const publicContractsV1: {
                     urgent: "urgent";
                 }>>;
                 workspaceId: z.ZodOptional<PublicIdSchema>;
+            }, z.core.$strip>, z.ZodObject<{
+                effort: z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    extraSmall: "extraSmall";
+                    large: "large";
+                    extraLarge: "extraLarge";
+                }>;
+                priority: z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    urgent: "urgent";
+                }>;
+                reason: z.ZodEnum<{
+                    dataChanged: "dataChanged";
+                    flowNeedsWork: "flowNeedsWork";
+                    other: "other";
+                    uiChanged: "uiChanged";
+                }>;
+                type: z.ZodLiteral<"maintenance">;
+                description: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
             }, z.core.$strip>], "type">;
             readonly kind: "write";
             readonly name: "issue.create";
@@ -5111,7 +5408,7 @@ export declare const publicContractsV1: {
                 readonly openWorldHint: false;
                 readonly readOnlyHint: true;
             };
-            readonly description: "List an environment's recent runs, newest first.";
+            readonly description: "List an environment's recent runs, newest first, including failed-attempt discovery metadata.";
             readonly input: z.ZodObject<{
                 environmentId: PublicIdSchema;
                 workspaceId: z.ZodOptional<PublicIdSchema>;
@@ -5124,6 +5421,8 @@ export declare const publicContractsV1: {
             readonly output: z.ZodObject<{
                 nextCursor: z.ZodOptional<z.ZodString>;
                 runs: z.ZodArray<z.ZodObject<{
+                    failedAttemptCount: z.ZodOptional<z.ZodNumber>;
+                    hasFailedAttempts: z.ZodOptional<z.ZodBoolean>;
                     completedAt: z.ZodOptional<z.ZodISODateTime>;
                     createdAt: z.ZodISODateTime;
                     git: z.ZodObject<{
@@ -5132,6 +5431,7 @@ export declare const publicContractsV1: {
                         commitSha: z.ZodOptional<z.ZodString>;
                         commitUrl: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>;
+                    needsReview: z.ZodOptional<z.ZodBoolean>;
                     runId: PublicIdSchema;
                     status: z.ZodEnum<{
                         failed: "failed";
@@ -5139,7 +5439,12 @@ export declare const publicContractsV1: {
                         running: "running";
                         passed: "passed";
                         canceled: "canceled";
+                        superseded: "superseded";
                     }>;
+                    supersededBy: z.ZodOptional<z.ZodObject<{
+                        runId: PublicIdSchema;
+                        url: z.ZodURL;
+                    }, z.core.$strip>>;
                     url: z.ZodURL;
                 }, z.core.$strip>>;
             }, z.core.$strip>;
@@ -5167,6 +5472,7 @@ export declare const publicContractsV1: {
                 blockingBugCount: z.ZodNumber;
                 flows: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodISODateTime;
@@ -5175,6 +5481,7 @@ export declare const publicContractsV1: {
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
@@ -5183,11 +5490,13 @@ export declare const publicContractsV1: {
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodOptional<z.ZodISODateTime>;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
                         status: z.ZodLiteral<"canceled">;
                     }, z.core.$strip>], "status">, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"manual">;
                         startedAt: z.ZodISODateTime;
@@ -5208,6 +5517,7 @@ export declare const publicContractsV1: {
                     status: z.ZodLiteral<"failed">;
                 }, z.core.$strip>, z.ZodObject<{
                     attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodISODateTime;
@@ -5216,6 +5526,7 @@ export declare const publicContractsV1: {
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
@@ -5224,11 +5535,13 @@ export declare const publicContractsV1: {
                         traceUrl: z.ZodOptional<z.ZodURL>;
                         videoUrl: z.ZodOptional<z.ZodURL>;
                     }, z.core.$strip>, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodOptional<z.ZodISODateTime>;
                         kind: z.ZodLiteral<"automated">;
                         startedAt: z.ZodOptional<z.ZodISODateTime>;
                         status: z.ZodLiteral<"canceled">;
                     }, z.core.$strip>], "status">, z.ZodObject<{
+                        attemptId: z.ZodOptional<PublicIdSchema>;
                         completedAt: z.ZodISODateTime;
                         kind: z.ZodLiteral<"manual">;
                         startedAt: z.ZodISODateTime;
@@ -5252,16 +5565,211 @@ export declare const publicContractsV1: {
                     commitSha: z.ZodOptional<z.ZodString>;
                     commitUrl: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>;
+                needsReview: z.ZodOptional<z.ZodBoolean>;
                 status: z.ZodEnum<{
                     failed: "failed";
                     queued: "queued";
                     running: "running";
                     passed: "passed";
                     canceled: "canceled";
+                    superseded: "superseded";
                 }>;
+                supersededBy: z.ZodOptional<z.ZodObject<{
+                    runId: PublicIdSchema;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
+        getAttemptArtifacts: {
+            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: PublicIdSchema;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "run.getAttemptArtifacts";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                flowId: PublicIdSchema;
+                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: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    previous: z.ZodOptional<z.ZodObject<{
+                        attemptId: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    total: z.ZodNumber;
+                }, z.core.$strip>;
+                runId: PublicIdSchema;
+                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: PublicIdSchema;
+                    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: PublicIdSchema;
+                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: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    previous: z.ZodOptional<z.ZodObject<{
+                        attemptId: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    total: z.ZodNumber;
+                }, z.core.$strip>;
+                runId: PublicIdSchema;
+                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: PublicIdSchema;
+                    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: PublicIdSchema;
+                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: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    previous: z.ZodOptional<z.ZodObject<{
+                        attemptId: PublicIdSchema;
+                        status: z.ZodEnum<{
+                            failed: "failed";
+                            passed: "passed";
+                            canceled: "canceled";
+                            skipped: "skipped";
+                            aborted: "aborted";
+                        }>;
+                    }, z.core.$strip>>;
+                    total: z.ZodNumber;
+                }, z.core.$strip>;
+                runId: PublicIdSchema;
+                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: PublicIdSchema;
+                    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">;
+        };
         reattempt: {
             readonly annotations: {
                 readonly destructiveHint: true;
@@ -5341,12 +5849,14 @@ export declare const publicContractsV1: {
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
                 runnerName: z.ZodEnum<{
                     basic: "basic";
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 failureReason: z.ZodLiteral<"needs-full-sync">;
@@ -5386,7 +5896,7 @@ export declare const publicContractsV1: {
                 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: z.ZodObject<{
                 id: z.ZodString;
                 workspaceId: z.ZodOptional<PublicIdSchema>;
@@ -5924,6 +6434,7 @@ export declare const publicContractsV1: {
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>>;
                 workspaceId: z.ZodOptional<PublicIdSchema>;
             }, z.core.$strip>;
@@ -5937,6 +6448,7 @@ export declare const publicContractsV1: {
                     playwright: "playwright";
                     android: "android";
                     ios: "ios";
+                    windows: "windows";
                 }>;
                 url: z.ZodURL;
                 alreadyRunning: z.ZodBoolean;
@@ -5965,6 +6477,7 @@ export declare const publicContractsV1: {
                         playwright: "playwright";
                         android: "android";
                         ios: "ios";
+                        windows: "windows";
                     }>;
                     url: z.ZodURL;
                 }, z.core.$strip>>;
@@ -5976,7 +6489,7 @@ export declare const publicContractsV1: {
                 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: z.ZodObject<{
                 action: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     button: z.ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;
@@ -6012,6 +6525,36 @@ export declare const publicContractsV1: {
                 }, z.core.$strict>, z.ZodObject<{
                     text: z.ZodString;
                     type: z.ZodLiteral<"type">;
+                }, z.core.$strict>, z.ZodObject<{
+                    selector: z.ZodOptional<z.ZodString>;
+                    strategy: z.ZodOptional<z.ZodEnum<{
+                        "ios-predicate": "ios-predicate";
+                        shadow: "shadow";
+                        xpath: "xpath";
+                    }>>;
+                    type: z.ZodLiteral<"tap">;
+                    x: z.ZodOptional<z.ZodInt>;
+                    y: z.ZodOptional<z.ZodInt>;
+                }, z.core.$strict>, z.ZodObject<{
+                    duration_ms: z.ZodOptional<z.ZodInt>;
+                    from: z.ZodObject<{
+                        x: z.ZodInt;
+                        y: z.ZodInt;
+                    }, z.core.$strict>;
+                    to: z.ZodObject<{
+                        x: z.ZodInt;
+                        y: z.ZodInt;
+                    }, z.core.$strict>;
+                    type: z.ZodLiteral<"swipe">;
+                }, z.core.$strict>, z.ZodObject<{
+                    selector: z.ZodString;
+                    strategy: z.ZodOptional<z.ZodEnum<{
+                        "ios-predicate": "ios-predicate";
+                        shadow: "shadow";
+                        xpath: "xpath";
+                    }>>;
+                    text: z.ZodString;
+                    type: z.ZodLiteral<"fill">;
                 }, z.core.$strict>], "type">;
                 id: z.ZodString;
                 withScreenshot: z.ZodOptional<z.ZodBoolean>;
@@ -6034,6 +6577,7 @@ export declare const publicContractsV1: {
                     "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: z.ZodLiteral<"failure">;
             }, z.core.$strip>], "failureReason">], "outcome">;