@qawolf/api-contracts 0.22.0 → 0.25.0

package/dist/v1/index.d.ts

@@ -3,11 +3,13 @@ export type { AnyPublicApiContract, PublicApiContract, PublicApiContractKind, }
 export { type IdentityResponse, identityResponse } from "./identity/index.js";
 export { type PublicIdSchema, type PublicIdSchemas, defaultIdSchemas, } from "./ids.js";
 export { makeFlowSelectionSchema } from "./run/index.js";
+export { type BrowserAction, browserActionSchema, } from "./runner/browserAction.js";
 export { runEnvironmentSchema } from "./runner/environment.js";
 export { isShippableRunFilePath, runFilePathSchema, runPackageJsonPath, shippableRunFileExtensions, } from "./runner/files.js";
 export { type RunnerNameForPublicApi, makeRunnerSchema, runnerIdSchema, runnerNameSchema, } from "./runner/identity.js";
 export { type JournalEntry, type JournalStream, type KnownJournalStream, type ReadJournalRequest, type ReadJournalResponse, journalEntrySchema, journalStreamSchema, knownJournalStreams, maxJournalStreamNameLength, readJournalRequestSchema, readJournalResponseSchema, } from "./runner/journal.js";
 export { type RunFiles, maxRunFilesByteLength, maxRunnerRequestEncodedByteLength, runFilesByteLength, runFilesSchema, } from "./runner/payloadSize.js";
+export { maxActionErrorMessageLength } from "./runner/performAction.js";
 import type { AnyPublicApiContract } from "./definition.js";
 import { type PublicIdSchema, type PublicIdSchemasOf } from "./ids.js";
 export type PublicApiInput<Api extends AnyPublicApiContract> = z.input<Api["input"]>;
@@ -19,7 +21,7 @@ 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, AutomationId extends PublicIdSchema = PublicIdSchema, IssueId extends PublicIdSchema = PublicIdSchema, WorkspaceId extends PublicIdSchema = PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, AutomationId, IssueId, WorkspaceId>) => {
+export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, AutomationId extends PublicIdSchema = PublicIdSchema, IssueId extends PublicIdSchema = PublicIdSchema, WorkspaceId extends PublicIdSchema = PublicIdSchema, AiTaskId extends PublicIdSchema = PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, AutomationId, IssueId, WorkspaceId, AiTaskId>) => {
     automate: {
         readonly description: "Request automation for draft flows. First create a named local .flow.ts draft for every requested journey that does not already have a matching draft; never reuse a generic starter or placeholder. Each new draft must start with a JSDoc Goal: description, import flow from @qawolf/flows/web, and use export default flow(...); a comment-only file or direct test(...) call is not a valid draft. Commit and push all changes with Git to publish them, then list remote drafts to resolve every selected ID. Do not use patch to create or rename a selected flow. Finally make one automation request containing all requested flow IDs.";
         readonly input: z.ZodObject<{
@@ -54,6 +56,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
                 id: EnvironmentId;
+                isDefault: z.ZodBoolean;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -96,6 +99,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             readonly kind: "read";
             readonly name: "environment.find";
             readonly output: z.ZodObject<{
+                defaultEnvironmentId: EnvironmentId;
                 environments: z.ZodArray<z.ZodObject<{
                     alias: z.ZodOptional<z.ZodString>;
                     flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -107,6 +111,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         syncStatus: z.ZodLiteral<"not-reconciled">;
                     }, z.core.$strip>], "syncStatus">>;
                     id: EnvironmentId;
+                    isDefault: z.ZodBoolean;
                     kind: z.ZodEnum<{
                         static: "static";
                         preview: "preview";
@@ -143,6 +148,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
                 id: EnvironmentId;
+                isDefault: z.ZodBoolean;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -187,7 +193,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             }, z.core.$strip>;
         };
         setVariable: {
-            readonly description: "Create or replace an environment variable. If the user asks to create one for \"my email\" without naming it, use DEFAULT_ENVIRONMENT_EMAIL. The value is never returned.";
+            readonly description: "Create or replace an environment variable. If the user asks to create one for \"my email\" without naming it, use DEFAULT_EMAIL. The value is never returned.";
             readonly input: z.ZodObject<{
                 environmentId: PublicIdSchema;
                 name: z.ZodString;
@@ -219,6 +225,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
                 id: EnvironmentId;
+                isDefault: z.ZodBoolean;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -540,6 +547,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
         create: {
             readonly description: "Create a run for the selected flows and/or tags in an environment.";
             readonly input: z.ZodIntersection<z.ZodObject<{
+                aiTaskId: z.ZodOptional<AiTaskId>;
                 environmentId: PublicIdSchema;
                 environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 ignoreRules: z.ZodDefault<z.ZodBoolean>;
@@ -598,13 +606,74 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             readonly name: "run.get";
             readonly output: z.ZodObject<{
                 flows: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"failed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodOptional<z.ZodISODateTime>;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"canceled">;
+                    }, z.core.$strip>], "status">, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"manual">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                    }, z.core.$strip>]>>>;
                     failure: z.ZodObject<{
+                        diagnosis: z.ZodOptional<z.ZodObject<{
+                            issueId: IssueId;
+                            type: z.ZodEnum<{
+                                bug: "bug";
+                                maintenance: "maintenance";
+                            }>;
+                        }, z.core.$strip>>;
                         error: z.ZodString;
                     }, z.core.$strip>;
                     flowId: FlowId;
                     name: z.ZodString;
                     status: z.ZodLiteral<"failed">;
                 }, z.core.$strip>, z.ZodObject<{
+                    attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"failed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodOptional<z.ZodISODateTime>;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"canceled">;
+                    }, z.core.$strip>], "status">, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"manual">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                    }, z.core.$strip>]>>>;
                     flowId: FlowId;
                     name: z.ZodString;
                     status: z.ZodEnum<{
@@ -685,6 +754,63 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 }>;
             }, z.core.$strip>;
         };
+        performAction: {
+            readonly description: "Perform one raw browser action on an interactive runner: click, double_click, move, drag, scroll, keypress, type, or navigate. Coordinates are whole pixels on the runner's virtual desktop, in the same space as `runner.takeScreenshot`. One action per request, and the runner serves one at a time. The action shapes follow the computer-use vocabulary, minus `screenshot` (use `runner.takeScreenshot`) and `wait` (delay on the caller's side). `performed` if the action took effect. `action-failed`, with a reason, if it reached the runner and did not take effect. `screen-needs-a-run` if the runner has not run anything yet, so its virtual desktop has never started. Waiting will not change this and retrying is pointless — call `runner.runFlow` on the runner, then ask for the screen again. 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. A `navigate` does not go through the screen, so a screen that is not ready does not stop it — but it still needs the runner to have run something, and until then it answers `action-failed` rather than `screen-needs-a-run`. `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 `node20WithPlaywright` 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 input: z.ZodObject<{
+                action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    button: z.ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;
+                    type: z.ZodLiteral<"click">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"double_click">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    scroll_x: z.ZodInt;
+                    scroll_y: z.ZodInt;
+                    type: z.ZodLiteral<"scroll">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"move">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    path: z.ZodArray<z.ZodObject<{
+                        x: z.ZodInt;
+                        y: z.ZodInt;
+                    }, z.core.$strict>>;
+                    type: z.ZodLiteral<"drag">;
+                }, z.core.$strict>, z.ZodObject<{
+                    keys: z.ZodArray<z.ZodString>;
+                    type: z.ZodLiteral<"keypress">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"navigate">;
+                    url: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    text: z.ZodString;
+                    type: z.ZodLiteral<"type">;
+                }, z.core.$strict>], "type">;
+                id: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "write";
+            readonly name: "runner.performAction";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                outcome: z.ZodLiteral<"performed">;
+            }, z.core.$strip>, z.ZodObject<{
+                errorMessage: z.ZodString;
+                outcome: z.ZodLiteral<"action-failed">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-needs-a-run">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-not-ready">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-has-no-screen">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-unreachable">;
+            }, z.core.$strip>], "outcome">;
+        };
         readJournal: {
             readonly description: "Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: `run-status` settles it, `run-logs` and `run-events` carry what it produced, and `recorder` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. `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<{
@@ -760,6 +886,26 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 }>;
             }, z.core.$strip>;
         };
+        takeScreenshot: {
+            readonly description: "Take one screenshot of an interactive runner's screen. The image is the runner's whole virtual desktop, browser window and all. `screen-needs-a-run` if the runner has not run anything yet, so its virtual desktop has never started. Waiting will not change this and retrying is pointless — call `runner.runFlow` on the runner, then ask for the screen again. 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 `node20WithPlaywright` 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 input: z.ZodObject<{
+                id: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "runner.takeScreenshot";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                imageJpegBase64: z.ZodString;
+                outcome: z.ZodLiteral<"captured">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-needs-a-run">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-not-ready">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-has-no-screen">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-unreachable">;
+            }, z.core.$strip>], "outcome">;
+        };
     };
     tag: {
         create: {
@@ -832,6 +978,7 @@ export declare const publicContractsV1: {
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
                 id: PublicIdSchema;
+                isDefault: z.ZodBoolean;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -874,6 +1021,7 @@ export declare const publicContractsV1: {
             readonly kind: "read";
             readonly name: "environment.find";
             readonly output: z.ZodObject<{
+                defaultEnvironmentId: PublicIdSchema;
                 environments: z.ZodArray<z.ZodObject<{
                     alias: z.ZodOptional<z.ZodString>;
                     flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -885,6 +1033,7 @@ export declare const publicContractsV1: {
                         syncStatus: z.ZodLiteral<"not-reconciled">;
                     }, z.core.$strip>], "syncStatus">>;
                     id: PublicIdSchema;
+                    isDefault: z.ZodBoolean;
                     kind: z.ZodEnum<{
                         static: "static";
                         preview: "preview";
@@ -921,6 +1070,7 @@ export declare const publicContractsV1: {
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
                 id: PublicIdSchema;
+                isDefault: z.ZodBoolean;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -965,7 +1115,7 @@ export declare const publicContractsV1: {
             }, z.core.$strip>;
         };
         setVariable: {
-            readonly description: "Create or replace an environment variable. If the user asks to create one for \"my email\" without naming it, use DEFAULT_ENVIRONMENT_EMAIL. The value is never returned.";
+            readonly description: "Create or replace an environment variable. If the user asks to create one for \"my email\" without naming it, use DEFAULT_EMAIL. The value is never returned.";
             readonly input: z.ZodObject<{
                 environmentId: PublicIdSchema;
                 name: z.ZodString;
@@ -997,6 +1147,7 @@ export declare const publicContractsV1: {
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
                 id: PublicIdSchema;
+                isDefault: z.ZodBoolean;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -1318,6 +1469,7 @@ export declare const publicContractsV1: {
         create: {
             readonly description: "Create a run for the selected flows and/or tags in an environment.";
             readonly input: z.ZodIntersection<z.ZodObject<{
+                aiTaskId: z.ZodOptional<PublicIdSchema>;
                 environmentId: PublicIdSchema;
                 environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 ignoreRules: z.ZodDefault<z.ZodBoolean>;
@@ -1376,13 +1528,74 @@ export declare const publicContractsV1: {
             readonly name: "run.get";
             readonly output: z.ZodObject<{
                 flows: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"failed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodOptional<z.ZodISODateTime>;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"canceled">;
+                    }, z.core.$strip>], "status">, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"manual">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                    }, z.core.$strip>]>>>;
                     failure: z.ZodObject<{
+                        diagnosis: z.ZodOptional<z.ZodObject<{
+                            issueId: PublicIdSchema;
+                            type: z.ZodEnum<{
+                                bug: "bug";
+                                maintenance: "maintenance";
+                            }>;
+                        }, z.core.$strip>>;
                         error: z.ZodString;
                     }, z.core.$strip>;
                     flowId: PublicIdSchema;
                     name: z.ZodString;
                     status: z.ZodLiteral<"failed">;
                 }, z.core.$strip>, z.ZodObject<{
+                    attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"failed">;
+                        logsUrl: z.ZodOptional<z.ZodURL>;
+                        traceUrl: z.ZodOptional<z.ZodURL>;
+                        videoUrl: z.ZodOptional<z.ZodURL>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        completedAt: z.ZodOptional<z.ZodISODateTime>;
+                        kind: z.ZodLiteral<"automated">;
+                        startedAt: z.ZodOptional<z.ZodISODateTime>;
+                        status: z.ZodLiteral<"canceled">;
+                    }, z.core.$strip>], "status">, z.ZodObject<{
+                        completedAt: z.ZodISODateTime;
+                        kind: z.ZodLiteral<"manual">;
+                        startedAt: z.ZodISODateTime;
+                        status: z.ZodLiteral<"passed">;
+                    }, z.core.$strip>]>>>;
                     flowId: PublicIdSchema;
                     name: z.ZodString;
                     status: z.ZodEnum<{
@@ -1463,6 +1676,63 @@ export declare const publicContractsV1: {
                 }>;
             }, z.core.$strip>;
         };
+        performAction: {
+            readonly description: "Perform one raw browser action on an interactive runner: click, double_click, move, drag, scroll, keypress, type, or navigate. Coordinates are whole pixels on the runner's virtual desktop, in the same space as `runner.takeScreenshot`. One action per request, and the runner serves one at a time. The action shapes follow the computer-use vocabulary, minus `screenshot` (use `runner.takeScreenshot`) and `wait` (delay on the caller's side). `performed` if the action took effect. `action-failed`, with a reason, if it reached the runner and did not take effect. `screen-needs-a-run` if the runner has not run anything yet, so its virtual desktop has never started. Waiting will not change this and retrying is pointless — call `runner.runFlow` on the runner, then ask for the screen again. 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. A `navigate` does not go through the screen, so a screen that is not ready does not stop it — but it still needs the runner to have run something, and until then it answers `action-failed` rather than `screen-needs-a-run`. `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 `node20WithPlaywright` 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 input: z.ZodObject<{
+                action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    button: z.ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;
+                    type: z.ZodLiteral<"click">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"double_click">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    scroll_x: z.ZodInt;
+                    scroll_y: z.ZodInt;
+                    type: z.ZodLiteral<"scroll">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"move">;
+                    x: z.ZodInt;
+                    y: z.ZodInt;
+                }, z.core.$strict>, z.ZodObject<{
+                    path: z.ZodArray<z.ZodObject<{
+                        x: z.ZodInt;
+                        y: z.ZodInt;
+                    }, z.core.$strict>>;
+                    type: z.ZodLiteral<"drag">;
+                }, z.core.$strict>, z.ZodObject<{
+                    keys: z.ZodArray<z.ZodString>;
+                    type: z.ZodLiteral<"keypress">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"navigate">;
+                    url: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    text: z.ZodString;
+                    type: z.ZodLiteral<"type">;
+                }, z.core.$strict>], "type">;
+                id: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "write";
+            readonly name: "runner.performAction";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                outcome: z.ZodLiteral<"performed">;
+            }, z.core.$strip>, z.ZodObject<{
+                errorMessage: z.ZodString;
+                outcome: z.ZodLiteral<"action-failed">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-needs-a-run">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-not-ready">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-has-no-screen">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-unreachable">;
+            }, z.core.$strip>], "outcome">;
+        };
         readJournal: {
             readonly description: "Read a window of one of an interactive runner's journal streams — the newest few, everything after a cursor, or everything belonging to one run. This is how a flow run's outcome and output are followed: `run-status` settles it, `run-logs` and `run-events` carry what it produced, and `recorder` carries the browser actions the runner recorded. A read counts as activity, so working through history does not get the runner reaped underneath you. `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<{
@@ -1538,6 +1808,26 @@ export declare const publicContractsV1: {
                 }>;
             }, z.core.$strip>;
         };
+        takeScreenshot: {
+            readonly description: "Take one screenshot of an interactive runner's screen. The image is the runner's whole virtual desktop, browser window and all. `screen-needs-a-run` if the runner has not run anything yet, so its virtual desktop has never started. Waiting will not change this and retrying is pointless — call `runner.runFlow` on the runner, then ask for the screen again. 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 `node20WithPlaywright` 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 input: z.ZodObject<{
+                id: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "runner.takeScreenshot";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                imageJpegBase64: z.ZodString;
+                outcome: z.ZodLiteral<"captured">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-needs-a-run">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"screen-not-ready">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-has-no-screen">;
+            }, z.core.$strip>, z.ZodObject<{
+                outcome: z.ZodLiteral<"runner-unreachable">;
+            }, z.core.$strip>], "outcome">;
+        };
     };
     tag: {
         create: {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CF,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoC,CAAC"}

package/dist/v1/index.js

@@ -1,6 +1,7 @@
 export { identityResponse } from "./identity/index.js";
 export { defaultIdSchemas, } from "./ids.js";
 export { makeFlowSelectionSchema } from "./run/index.js";
+export { browserActionSchema, } from "./runner/browserAction.js";
 // Carries the reservation of QA Wolf's own variable names, which the server
 // validates with rather than restating — a second copy of that rule is how the
 // reservation comes to differ from what is actually stamped.
@@ -15,6 +16,7 @@ export { makeRunnerSchema, runnerIdSchema, runnerNameSchema, } from "./runner/id
 // published here and the private journal package imports them from here.
 export { journalEntrySchema, journalStreamSchema, knownJournalStreams, maxJournalStreamNameLength, readJournalRequestSchema, readJournalResponseSchema, } from "./runner/journal.js";
 export { maxRunFilesByteLength, maxRunnerRequestEncodedByteLength, runFilesByteLength, runFilesSchema, } from "./runner/payloadSize.js";
+export { maxActionErrorMessageLength } from "./runner/performAction.js";
 import { makeAutomateContract } from "./automate/index.js";
 import { makeDeleteEnvironmentVariableContract } from "./environment/deleteVariable.js";
 import { makeFindEnvironmentsContract } from "./environment/find.js";
@@ -33,8 +35,10 @@ import { makeGetRunContract } from "./run/get.js";
 import { makeCreateRunContract } from "./run/index.js";
 import { makeEvaluateSnippetOnRunnerContract } from "./runner/evaluateSnippet.js";
 import { makeLaunchRunnerContract, makeStopRunnerContract, } from "./runner/index.js";
+import { makePerformActionOnRunnerContract } from "./runner/performAction.js";
 import { makeReadRunnerJournalContract } from "./runner/readJournal.js";
 import { makeRunFlowOnRunnerContract } from "./runner/runFlow.js";
+import { makeTakeScreenshotOnRunnerContract } from "./runner/takeScreenshot.js";
 import { makeCreateTagContract } from "./tag/index.js";
 import { makeListTagsContract } from "./tag/list.js";
 /**
@@ -79,9 +83,11 @@ export const makeContractsV1 = (ids) => {
         runner: {
             evaluateSnippet: makeEvaluateSnippetOnRunnerContract(),
             launch: makeLaunchRunnerContract(),
+            performAction: makePerformActionOnRunnerContract(),
             readJournal: makeReadRunnerJournalContract(),
             runFlow: makeRunFlowOnRunnerContract(),
             stop: makeStopRunnerContract(),
+            takeScreenshot: makeTakeScreenshotOnRunnerContract(),
         },
         tag: {
             create: makeCreateTagContract(),

package/dist/v1/index.js.map

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

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

@@ -1,8 +1,9 @@
 import { z } from "zod";
 import type { PublicIdSchema } from "../ids.js";
-export declare const makeGetRunContract: <FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
+export declare const makeGetRunContract: <FlowId extends PublicIdSchema, IssueId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
     [key: string]: unknown;
     flow: FlowId;
+    issue: IssueId;
     run: RunId;
 }) => {
     readonly description: "Get a run's status, per-flow results, and links.";
@@ -13,13 +14,74 @@ export declare const makeGetRunContract: <FlowId extends PublicIdSchema, RunId e
     readonly name: "run.get";
     readonly output: z.ZodObject<{
         flows: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                completedAt: z.ZodISODateTime;
+                kind: z.ZodLiteral<"automated">;
+                startedAt: z.ZodISODateTime;
+                status: z.ZodLiteral<"passed">;
+                logsUrl: z.ZodOptional<z.ZodURL>;
+                traceUrl: z.ZodOptional<z.ZodURL>;
+                videoUrl: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>, z.ZodObject<{
+                completedAt: z.ZodISODateTime;
+                kind: z.ZodLiteral<"automated">;
+                startedAt: z.ZodOptional<z.ZodISODateTime>;
+                status: z.ZodLiteral<"failed">;
+                logsUrl: z.ZodOptional<z.ZodURL>;
+                traceUrl: z.ZodOptional<z.ZodURL>;
+                videoUrl: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>, z.ZodObject<{
+                completedAt: z.ZodOptional<z.ZodISODateTime>;
+                kind: z.ZodLiteral<"automated">;
+                startedAt: z.ZodOptional<z.ZodISODateTime>;
+                status: z.ZodLiteral<"canceled">;
+            }, z.core.$strip>], "status">, z.ZodObject<{
+                completedAt: z.ZodISODateTime;
+                kind: z.ZodLiteral<"manual">;
+                startedAt: z.ZodISODateTime;
+                status: z.ZodLiteral<"passed">;
+            }, z.core.$strip>]>>>;
             failure: z.ZodObject<{
+                diagnosis: z.ZodOptional<z.ZodObject<{
+                    issueId: IssueId;
+                    type: z.ZodEnum<{
+                        bug: "bug";
+                        maintenance: "maintenance";
+                    }>;
+                }, z.core.$strip>>;
                 error: z.ZodString;
             }, z.core.$strip>;
             flowId: FlowId;
             name: z.ZodString;
             status: z.ZodLiteral<"failed">;
         }, z.core.$strip>, z.ZodObject<{
+            attempts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                completedAt: z.ZodISODateTime;
+                kind: z.ZodLiteral<"automated">;
+                startedAt: z.ZodISODateTime;
+                status: z.ZodLiteral<"passed">;
+                logsUrl: z.ZodOptional<z.ZodURL>;
+                traceUrl: z.ZodOptional<z.ZodURL>;
+                videoUrl: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>, z.ZodObject<{
+                completedAt: z.ZodISODateTime;
+                kind: z.ZodLiteral<"automated">;
+                startedAt: z.ZodOptional<z.ZodISODateTime>;
+                status: z.ZodLiteral<"failed">;
+                logsUrl: z.ZodOptional<z.ZodURL>;
+                traceUrl: z.ZodOptional<z.ZodURL>;
+                videoUrl: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>, z.ZodObject<{
+                completedAt: z.ZodOptional<z.ZodISODateTime>;
+                kind: z.ZodLiteral<"automated">;
+                startedAt: z.ZodOptional<z.ZodISODateTime>;
+                status: z.ZodLiteral<"canceled">;
+            }, z.core.$strip>], "status">, z.ZodObject<{
+                completedAt: z.ZodISODateTime;
+                kind: z.ZodLiteral<"manual">;
+                startedAt: z.ZodISODateTime;
+                status: z.ZodLiteral<"passed">;
+            }, z.core.$strip>]>>>;
             flowId: FlowId;
             name: z.ZodString;
             status: z.ZodEnum<{

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

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/v1/run/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,kBAAkB,GAC7B,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,KAAK;IACL,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkEA,CAAC"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/v1/run/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,kBAAkB,GAC7B,MAAM,SAAS,cAAc,EAC7B,OAAO,SAAS,cAAc,EAC9B,KAAK,SAAS,cAAc,EAC5B,KAAK;IACL,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKA,CAAC"}