@qawolf/api-contracts 0.54.0 → 0.59.0

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

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/v1/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,CAC3B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,GAAG,cAAc,EACpD,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,WAAW,SAAS,cAAc,GAAG,cAAc,EACnD,QAAQ,SAAS,cAAc,GAAG,cAAc,EAChD,aAAa,SAAS,cAAc,GAAG,cAAc,EACrD,SAAS,SAAS,cAAc,GAAG,cAAc,IAC/C;IACF,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,aAAa,CAAC;IAC3B;;;OAGG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,aAAa,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAC7C,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,CACf,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAiB9B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,SAAS,cAAc,EACzE,WAAW,SAAS,6BAMjB,CAAC"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/v1/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,CAC3B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,GAAG,cAAc,EACpD,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,WAAW,SAAS,cAAc,GAAG,cAAc,EACnD,QAAQ,SAAS,cAAc,GAAG,cAAc,EAChD,aAAa,SAAS,cAAc,GAAG,cAAc,EACrD,SAAS,SAAS,cAAc,GAAG,cAAc,EACjD,YAAY,SAAS,cAAc,GAAG,cAAc,IAClD;IACF,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,aAAa,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAC7C,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,CACf,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAiB9B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,SAAS,cAAc,EACzE,WAAW,SAAS,6BAMjB,CAAC"}

package/dist/v1/ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/v1/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4DxB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC5D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACrE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,iHAAiH,CAClH;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACvD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACzD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,SAAoB,EACpB,EAAE,CACF,SAAS;KACN,QAAQ,EAAE;KACV,QAAQ,CACP,oJAAoJ,CACrJ,CAAC"}
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/v1/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyDxB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC5D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACrE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,iHAAiH,CAClH;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACvD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACzD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,SAAoB,EACpB,EAAE,CACF,SAAS;KACN,QAAQ,EAAE;KACV,QAAQ,CACP,oJAAoJ,CACrJ,CAAC"}

package/dist/v1/index.d.ts

@@ -11,7 +11,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, AiTaskId extends PublicIdSchema = PublicIdSchema, ChatSessionId extends PublicIdSchema = PublicIdSchema, TriggerId extends PublicIdSchema = PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, AutomationId, IssueId, WorkspaceId, AiTaskId, ChatSessionId, TriggerId>) => {
+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, ChatSessionId extends PublicIdSchema = PublicIdSchema, TriggerId extends PublicIdSchema = PublicIdSchema, DeploymentId extends PublicIdSchema = PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, AutomationId, IssueId, WorkspaceId, AiTaskId, ChatSessionId, TriggerId, DeploymentId>) => {
     agent: {
         get: {
             readonly annotations: {
@@ -19,10 +19,11 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 readonly openWorldHint: false;
                 readonly readOnlyHint: true;
             };
-            readonly description: "Monitor a QA Wolf AI session by reading its status and replies. After agent.send, share the returned session URL before monitoring. Wait 30 to 60 seconds between checks; do not call this in a tight loop. Pass the nextCursor from one response as the cursor on the next check; it then reads only what is new, and only for the session that minted it. Continue monitoring silently when the status is unchanged and no replies come back; do not narrate waiting, announce the next check, or ask whether to keep monitoring. Report only substantive new progress, questions, blockers, or the final outcome. A status of \"waiting-for-you\" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Surface an explicit request for user input even if the status still says \"working\". Include the session URL when reporting a blocker or final outcome. On \"completed\", stop status checks and verify the requested result before claiming success. For new flows, validation, publication in the target environment, and readiness are separate checks; a Git push or final reply does not prove the flow is active. If every requested result is verified but status remains \"working\", report the mismatch and stop monitoring. Stop on \"failed\" or \"cancelled\" and report any confirmed partial result.";
+            readonly description: "Monitor a QA Wolf AI session by reading its status and replies. After agent.send, share the returned session URL before monitoring. Pass waitSeconds 45 so the server holds the check open and answers the moment something happens. Check again as soon as it returns; never sleep between checks or loop without waitSeconds. Pass the nextCursor from one response as the cursor on the next check; it then reads only what is new, and only for the session that minted it. Continue monitoring silently when the status is unchanged and no replies come back; do not narrate waiting, announce the next check, or ask whether to keep monitoring. Report only substantive new progress, questions, blockers, or the final outcome. A status of \"waiting-for-you\" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Surface an explicit request for user input even if the status still says \"working\". Include the session URL when reporting a blocker or final outcome. On \"completed\", stop status checks and verify the requested result before claiming success. For new flows, validation, publication in the target environment, and readiness are separate checks; a Git push or final reply does not prove the flow is active. If every requested result is verified but status remains \"working\", report the mismatch and stop monitoring. Stop on \"failed\" or \"cancelled\" and report any confirmed partial result.";
             readonly input: z.ZodObject<{
                 cursor: z.ZodOptional<z.ZodString>;
                 sessionId: ChatSessionId;
+                waitSeconds: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>;
             readonly kind: "read";
             readonly name: "agent.get";
@@ -41,6 +42,12 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     failed: "failed";
                     cancelled: "cancelled";
                 }>;
+                waitSeconds: z.ZodOptional<z.ZodNumber>;
+                wokeOn: z.ZodOptional<z.ZodEnum<{
+                    reply: "reply";
+                    status: "status";
+                    timeout: "timeout";
+                }>>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -50,7 +57,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 readonly openWorldHint: true;
                 readonly readOnlyHint: false;
             };
-            readonly description: "Start or continue work with the QA Wolf AI and return a live session URL to share with the user. Use it to cover a user journey, investigate a failing run, or fix a broken flow. This is the one verb that starts work from nothing: every other write acts on a flow, run or issue that already exists. Returns sessionId, status, and url as soon as the request is accepted; work can take minutes to tens of minutes. After each send, make the next action a normal user-visible assistant message containing the exact returned url, before any tool call or wait. Tool output and internal reasoning do not count as sharing the link. Do not run a timer or monitoring call alongside this send. Acceptance does not mean the work is complete. Then monitor the session with agent.get, reporting new progress, blockers, and the final outcome rather than unchanged status. Send here again to answer a question or add context to the same session.";
+            readonly description: "Start or continue work with the QA Wolf AI and return a live session URL to share with the user. Use it to cover a user journey, investigate a failing run, or fix a broken flow. This is the one verb that starts work from nothing: every other write acts on a flow, run or issue that already exists. Returns sessionId, status, and url as soon as the request is accepted; work can take minutes to tens of minutes. After each send, put the exact returned url in a normal user-visible assistant message, and repeat it in the last message of the turn: only a turn's trailing message is shown expanded. Tool output and internal reasoning do not count as sharing the link. Do not run a timer or monitoring call alongside this send. Acceptance does not mean the work is complete. Then monitor the session with agent.get, reporting new progress, blockers, and the final outcome rather than unchanged status. Send here again to answer a question or add context to the same session.";
             readonly input: z.ZodObject<{
                 environmentId: z.ZodOptional<PublicIdSchema>;
                 filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -94,7 +101,194 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             url: z.ZodURL;
         }, z.core.$strip>;
     };
+    codeHostIntegration: {
+        find: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the workspace's code host integrations (GitHub or GitLab). A connected integration lets QA Wolf read repositories and receive the code host's webhooks. codeHostIntegration.listRepositories pages the repositories each integration covers.";
+            readonly input: z.ZodObject<{
+                workspaceId: z.ZodOptional<WorkspaceId>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "codeHostIntegration.find";
+            readonly output: z.ZodObject<{
+                integrations: z.ZodArray<z.ZodObject<{
+                    connectedAt: z.ZodISODateTime;
+                    provider: z.ZodEnum<{
+                        github: "github";
+                        gitlab: "gitlab";
+                    }>;
+                    suspendedAt: z.ZodOptional<z.ZodISODateTime>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+                settingsUrl: z.ZodURL;
+            }, z.core.$strip>;
+        };
+        listRepositories: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the repositories the workspace's code host integrations cover, alphabetical by full name. The list reflects the last sync from the code host; codeHostIntegration.find lists the integrations themselves.";
+            readonly input: z.ZodObject<{
+                cursor: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodNumber>;
+                provider: z.ZodOptional<z.ZodEnum<{
+                    github: "github";
+                    gitlab: "gitlab";
+                }>>;
+                workspaceId: z.ZodOptional<WorkspaceId>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "codeHostIntegration.listRepositories";
+            readonly output: z.ZodObject<{
+                nextCursor: z.ZodOptional<z.ZodString>;
+                repositories: z.ZodArray<z.ZodObject<{
+                    fullName: z.ZodString;
+                    provider: z.ZodEnum<{
+                        github: "github";
+                        gitlab: "gitlab";
+                    }>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+        };
+    };
     deployment: {
+        find: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the deployments QA Wolf has received for the workspace, newest first. A deployment arrives through a code host integration's webhook or through deployment.reportStatus, and is what a deployment trigger evaluates against. deployment.listTriggerEvaluations reports each trigger's verdict for one deployment.";
+            readonly input: z.ZodObject<{
+                cursor: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodNumber>;
+                workspaceId: z.ZodOptional<WorkspaceId>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "deployment.find";
+            readonly output: z.ZodObject<{
+                deployments: z.ZodArray<z.ZodObject<{
+                    branch: z.ZodOptional<z.ZodString>;
+                    commitAuthorName: z.ZodOptional<z.ZodString>;
+                    commitMessage: z.ZodOptional<z.ZodString>;
+                    commitSha: z.ZodOptional<z.ZodString>;
+                    deployedAt: z.ZodISODateTime;
+                    deployTarget: z.ZodOptional<z.ZodString>;
+                    environmentId: EnvironmentId;
+                    environmentName: z.ZodOptional<z.ZodString>;
+                    id: DeploymentId;
+                    provider: z.ZodOptional<z.ZodEnum<{
+                        github: "github";
+                        gitlab: "gitlab";
+                        api: "api";
+                    }>>;
+                    status: z.ZodOptional<z.ZodEnum<{
+                        success: "success";
+                        pending: "pending";
+                        failure: "failure";
+                        inactive: "inactive";
+                    }>>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+                nextCursor: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        };
+        listTriggerEvaluations: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the per-trigger verdicts recorded when a deployment was evaluated against the workspace's triggers. Each verdict says whether the trigger matched, did not match with the reason per condition, or was never considered and why. Verdicts are a snapshot from evaluation time: editing or deleting a trigger later does not change them.";
+            readonly input: z.ZodObject<{
+                deploymentId: DeploymentId;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "deployment.listTriggerEvaluations";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                evaluations: z.ZodArray<z.ZodObject<{
+                    triggerId: z.ZodOptional<TriggerId>;
+                    triggerName: z.ZodString;
+                    verdict: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        conditionSets: z.ZodArray<z.ZodObject<{
+                            conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"matched">;
+                            }, z.core.$strip>, z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"did-not-match">;
+                                reason: z.ZodString;
+                            }, z.core.$strip>], "outcome">>;
+                            outcome: z.ZodEnum<{
+                                matched: "matched";
+                                "did-not-match": "did-not-match";
+                            }>;
+                        }, z.core.$strip>>;
+                        outcome: z.ZodLiteral<"matched">;
+                        run: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            runId: RunId;
+                            status: z.ZodLiteral<"ran">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            status: z.ZodLiteral<"starting">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            reason: z.ZodString;
+                            status: z.ZodLiteral<"did-not-run">;
+                            supersededByRunId: z.ZodOptional<RunId>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            status: z.ZodLiteral<"unknown">;
+                        }, z.core.$strip>], "status">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        conditionSets: z.ZodArray<z.ZodObject<{
+                            conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"matched">;
+                            }, z.core.$strip>, z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"did-not-match">;
+                                reason: z.ZodString;
+                            }, z.core.$strip>], "outcome">>;
+                            outcome: z.ZodEnum<{
+                                matched: "matched";
+                                "did-not-match": "did-not-match";
+                            }>;
+                        }, z.core.$strip>>;
+                        outcome: z.ZodLiteral<"did-not-match">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        outcome: z.ZodLiteral<"not-considered">;
+                        reason: z.ZodEnum<{
+                            "trigger-paused": "trigger-paused";
+                            "not-a-deployment-trigger": "not-a-deployment-trigger";
+                        }>;
+                    }, z.core.$strip>], "outcome">;
+                }, z.core.$strip>>;
+                state: z.ZodLiteral<"evaluated">;
+            }, z.core.$strip>, z.ZodObject<{
+                state: z.ZodLiteral<"not-evaluated">;
+            }, z.core.$strip>], "state">;
+        };
         reportStatus: {
             readonly annotations: {
                 readonly destructiveHint: true;
@@ -133,7 +327,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             readonly name: "deployment.reportStatus";
             readonly output: z.ZodObject<{
                 deployment: z.ZodObject<{
-                    id: PublicIdSchema;
+                    id: DeploymentId;
                     status: z.ZodEnum<{
                         success: "success";
                         pending: "pending";
@@ -386,6 +580,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     running: "running";
                 }>;
                 terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                variablesUrl: z.ZodOptional<z.ZodURL>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -453,6 +648,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                         running: "running";
                     }>;
                     terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                    variablesUrl: z.ZodOptional<z.ZodURL>;
                     url: z.ZodURL;
                 }, z.core.$strip>>;
                 nextCursor: z.ZodOptional<z.ZodString>;
@@ -496,6 +692,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     running: "running";
                 }>;
                 terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                variablesUrl: z.ZodOptional<z.ZodURL>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -597,6 +794,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     running: "running";
                 }>;
                 terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                variablesUrl: z.ZodOptional<z.ZodURL>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -1793,7 +1991,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 readonly openWorldHint: false;
                 readonly readOnlyHint: false;
             };
-            readonly description: "Launch an interactive runner on the caller's team under an id the caller chooses. Launching the same id again returns the runner already running rather than starting a second one, and the same id with a different runnerName is refused. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner — so read `alreadyRunning` to tell which happened. After a successful launch, make the next action a normal user-visible assistant message containing the exact returned `url`, before the first browser action. Tool output and internal reasoning do not count as sharing the link. When `alreadyRunning` is true the `url` is the same page, so share it again instead of assuming the caller still has it.";
+            readonly description: "Launch an interactive runner on the caller's team under an id the caller chooses. Launching the same id again returns the runner already running rather than starting a second one, and the same id with a different runnerName is refused. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner — so read `alreadyRunning` to tell which happened. A success means the runner is answering: the call waits for the pod it started to come up, so the very next call to the runner reaches it. If the pod does not come up in time the call fails instead, leaving the runner running — launching the same id again attaches to it. After a successful launch, put the exact returned `url` in a normal user-visible assistant message so they can watch while the browser is driven. Tool output and internal reasoning do not count as sharing the link. When `alreadyRunning` is true the `url` is the same page, so share it again instead of assuming the caller still has it.";
             readonly input: z.ZodObject<{
                 id: z.ZodString;
                 runnerName: z.ZodOptional<z.ZodEnum<{
@@ -1853,7 +2051,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. 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). 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. A `navigate` does not go through the screen, so a screen that is not ready does not stop 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. `action-not-supported-on-mobile` if the runner is a mobile device and this action has no touchscreen equivalent: `double_click`, `scroll`, `move`, `keypress` and `navigate`, and a `click` whose `button` is not `left`, are all pointer-device concepts a touchscreen has nothing to offer for. `click` taps, `drag` swipes between its path's first and last point, and `type` types into whatever the last tap focused. With `withScreenshot: true`, the answer also carries `imageJpegBase64`: a screenshot taken after the action, once the screen has changed from just before it or half a second has passed, whichever comes first. One call instead of `runner.performAction` followed by `runner.takeScreenshot`, with no fixed wait in between. Anything animating on the page counts as a change. The action itself is performed exactly as without the option; if the screen could serve no frame after it — a display restart, or a `navigate` on a desktop that is still starting — the action's result comes back without `imageJpegBase64`, so take a screenshot separately rather than repeating the action. On a mobile runner the screenshot is the device's own, taken right after a performed action. `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 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 input: z.ZodObject<{
                 action: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     button: z.ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;
@@ -2646,10 +2844,11 @@ export declare const publicContractsV1: {
                 readonly openWorldHint: false;
                 readonly readOnlyHint: true;
             };
-            readonly description: "Monitor a QA Wolf AI session by reading its status and replies. After agent.send, share the returned session URL before monitoring. Wait 30 to 60 seconds between checks; do not call this in a tight loop. Pass the nextCursor from one response as the cursor on the next check; it then reads only what is new, and only for the session that minted it. Continue monitoring silently when the status is unchanged and no replies come back; do not narrate waiting, announce the next check, or ask whether to keep monitoring. Report only substantive new progress, questions, blockers, or the final outcome. A status of \"waiting-for-you\" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Surface an explicit request for user input even if the status still says \"working\". Include the session URL when reporting a blocker or final outcome. On \"completed\", stop status checks and verify the requested result before claiming success. For new flows, validation, publication in the target environment, and readiness are separate checks; a Git push or final reply does not prove the flow is active. If every requested result is verified but status remains \"working\", report the mismatch and stop monitoring. Stop on \"failed\" or \"cancelled\" and report any confirmed partial result.";
+            readonly description: "Monitor a QA Wolf AI session by reading its status and replies. After agent.send, share the returned session URL before monitoring. Pass waitSeconds 45 so the server holds the check open and answers the moment something happens. Check again as soon as it returns; never sleep between checks or loop without waitSeconds. Pass the nextCursor from one response as the cursor on the next check; it then reads only what is new, and only for the session that minted it. Continue monitoring silently when the status is unchanged and no replies come back; do not narrate waiting, announce the next check, or ask whether to keep monitoring. Report only substantive new progress, questions, blockers, or the final outcome. A status of \"waiting-for-you\" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Surface an explicit request for user input even if the status still says \"working\". Include the session URL when reporting a blocker or final outcome. On \"completed\", stop status checks and verify the requested result before claiming success. For new flows, validation, publication in the target environment, and readiness are separate checks; a Git push or final reply does not prove the flow is active. If every requested result is verified but status remains \"working\", report the mismatch and stop monitoring. Stop on \"failed\" or \"cancelled\" and report any confirmed partial result.";
             readonly input: z.ZodObject<{
                 cursor: z.ZodOptional<z.ZodString>;
                 sessionId: PublicIdSchema;
+                waitSeconds: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>;
             readonly kind: "read";
             readonly name: "agent.get";
@@ -2668,6 +2867,12 @@ export declare const publicContractsV1: {
                     failed: "failed";
                     cancelled: "cancelled";
                 }>;
+                waitSeconds: z.ZodOptional<z.ZodNumber>;
+                wokeOn: z.ZodOptional<z.ZodEnum<{
+                    reply: "reply";
+                    status: "status";
+                    timeout: "timeout";
+                }>>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -2677,7 +2882,7 @@ export declare const publicContractsV1: {
                 readonly openWorldHint: true;
                 readonly readOnlyHint: false;
             };
-            readonly description: "Start or continue work with the QA Wolf AI and return a live session URL to share with the user. Use it to cover a user journey, investigate a failing run, or fix a broken flow. This is the one verb that starts work from nothing: every other write acts on a flow, run or issue that already exists. Returns sessionId, status, and url as soon as the request is accepted; work can take minutes to tens of minutes. After each send, make the next action a normal user-visible assistant message containing the exact returned url, before any tool call or wait. Tool output and internal reasoning do not count as sharing the link. Do not run a timer or monitoring call alongside this send. Acceptance does not mean the work is complete. Then monitor the session with agent.get, reporting new progress, blockers, and the final outcome rather than unchanged status. Send here again to answer a question or add context to the same session.";
+            readonly description: "Start or continue work with the QA Wolf AI and return a live session URL to share with the user. Use it to cover a user journey, investigate a failing run, or fix a broken flow. This is the one verb that starts work from nothing: every other write acts on a flow, run or issue that already exists. Returns sessionId, status, and url as soon as the request is accepted; work can take minutes to tens of minutes. After each send, put the exact returned url in a normal user-visible assistant message, and repeat it in the last message of the turn: only a turn's trailing message is shown expanded. Tool output and internal reasoning do not count as sharing the link. Do not run a timer or monitoring call alongside this send. Acceptance does not mean the work is complete. Then monitor the session with agent.get, reporting new progress, blockers, and the final outcome rather than unchanged status. Send here again to answer a question or add context to the same session.";
             readonly input: z.ZodObject<{
                 environmentId: z.ZodOptional<PublicIdSchema>;
                 filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2721,7 +2926,194 @@ export declare const publicContractsV1: {
             url: z.ZodURL;
         }, z.core.$strip>;
     };
+    codeHostIntegration: {
+        find: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the workspace's code host integrations (GitHub or GitLab). A connected integration lets QA Wolf read repositories and receive the code host's webhooks. codeHostIntegration.listRepositories pages the repositories each integration covers.";
+            readonly input: z.ZodObject<{
+                workspaceId: z.ZodOptional<PublicIdSchema>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "codeHostIntegration.find";
+            readonly output: z.ZodObject<{
+                integrations: z.ZodArray<z.ZodObject<{
+                    connectedAt: z.ZodISODateTime;
+                    provider: z.ZodEnum<{
+                        github: "github";
+                        gitlab: "gitlab";
+                    }>;
+                    suspendedAt: z.ZodOptional<z.ZodISODateTime>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+                settingsUrl: z.ZodURL;
+            }, z.core.$strip>;
+        };
+        listRepositories: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the repositories the workspace's code host integrations cover, alphabetical by full name. The list reflects the last sync from the code host; codeHostIntegration.find lists the integrations themselves.";
+            readonly input: z.ZodObject<{
+                cursor: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodNumber>;
+                provider: z.ZodOptional<z.ZodEnum<{
+                    github: "github";
+                    gitlab: "gitlab";
+                }>>;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "codeHostIntegration.listRepositories";
+            readonly output: z.ZodObject<{
+                nextCursor: z.ZodOptional<z.ZodString>;
+                repositories: z.ZodArray<z.ZodObject<{
+                    fullName: z.ZodString;
+                    provider: z.ZodEnum<{
+                        github: "github";
+                        gitlab: "gitlab";
+                    }>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+        };
+    };
     deployment: {
+        find: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the deployments QA Wolf has received for the workspace, newest first. A deployment arrives through a code host integration's webhook or through deployment.reportStatus, and is what a deployment trigger evaluates against. deployment.listTriggerEvaluations reports each trigger's verdict for one deployment.";
+            readonly input: z.ZodObject<{
+                cursor: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodNumber>;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "deployment.find";
+            readonly output: z.ZodObject<{
+                deployments: z.ZodArray<z.ZodObject<{
+                    branch: z.ZodOptional<z.ZodString>;
+                    commitAuthorName: z.ZodOptional<z.ZodString>;
+                    commitMessage: z.ZodOptional<z.ZodString>;
+                    commitSha: z.ZodOptional<z.ZodString>;
+                    deployedAt: z.ZodISODateTime;
+                    deployTarget: z.ZodOptional<z.ZodString>;
+                    environmentId: PublicIdSchema;
+                    environmentName: z.ZodOptional<z.ZodString>;
+                    id: PublicIdSchema;
+                    provider: z.ZodOptional<z.ZodEnum<{
+                        github: "github";
+                        gitlab: "gitlab";
+                        api: "api";
+                    }>>;
+                    status: z.ZodOptional<z.ZodEnum<{
+                        success: "success";
+                        pending: "pending";
+                        failure: "failure";
+                        inactive: "inactive";
+                    }>>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+                nextCursor: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        };
+        listTriggerEvaluations: {
+            readonly annotations: {
+                readonly destructiveHint: false;
+                readonly openWorldHint: false;
+                readonly readOnlyHint: true;
+            };
+            readonly description: "List the per-trigger verdicts recorded when a deployment was evaluated against the workspace's triggers. Each verdict says whether the trigger matched, did not match with the reason per condition, or was never considered and why. Verdicts are a snapshot from evaluation time: editing or deleting a trigger later does not change them.";
+            readonly input: z.ZodObject<{
+                deploymentId: PublicIdSchema;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "deployment.listTriggerEvaluations";
+            readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                evaluations: z.ZodArray<z.ZodObject<{
+                    triggerId: z.ZodOptional<PublicIdSchema>;
+                    triggerName: z.ZodString;
+                    verdict: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        conditionSets: z.ZodArray<z.ZodObject<{
+                            conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"matched">;
+                            }, z.core.$strip>, z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"did-not-match">;
+                                reason: z.ZodString;
+                            }, z.core.$strip>], "outcome">>;
+                            outcome: z.ZodEnum<{
+                                matched: "matched";
+                                "did-not-match": "did-not-match";
+                            }>;
+                        }, z.core.$strip>>;
+                        outcome: z.ZodLiteral<"matched">;
+                        run: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            runId: PublicIdSchema;
+                            status: z.ZodLiteral<"ran">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            status: z.ZodLiteral<"starting">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            reason: z.ZodString;
+                            status: z.ZodLiteral<"did-not-run">;
+                            supersededByRunId: z.ZodOptional<PublicIdSchema>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            status: z.ZodLiteral<"unknown">;
+                        }, z.core.$strip>], "status">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        conditionSets: z.ZodArray<z.ZodObject<{
+                            conditions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"matched">;
+                            }, z.core.$strip>, z.ZodObject<{
+                                kind: z.ZodEnum<{
+                                    branch: "branch";
+                                    deployTarget: "deployTarget";
+                                    environment: "environment";
+                                }>;
+                                outcome: z.ZodLiteral<"did-not-match">;
+                                reason: z.ZodString;
+                            }, z.core.$strip>], "outcome">>;
+                            outcome: z.ZodEnum<{
+                                matched: "matched";
+                                "did-not-match": "did-not-match";
+                            }>;
+                        }, z.core.$strip>>;
+                        outcome: z.ZodLiteral<"did-not-match">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        outcome: z.ZodLiteral<"not-considered">;
+                        reason: z.ZodEnum<{
+                            "trigger-paused": "trigger-paused";
+                            "not-a-deployment-trigger": "not-a-deployment-trigger";
+                        }>;
+                    }, z.core.$strip>], "outcome">;
+                }, z.core.$strip>>;
+                state: z.ZodLiteral<"evaluated">;
+            }, z.core.$strip>, z.ZodObject<{
+                state: z.ZodLiteral<"not-evaluated">;
+            }, z.core.$strip>], "state">;
+        };
         reportStatus: {
             readonly annotations: {
                 readonly destructiveHint: true;
@@ -3013,6 +3405,7 @@ export declare const publicContractsV1: {
                     running: "running";
                 }>;
                 terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                variablesUrl: z.ZodOptional<z.ZodURL>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -3080,6 +3473,7 @@ export declare const publicContractsV1: {
                         running: "running";
                     }>;
                     terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                    variablesUrl: z.ZodOptional<z.ZodURL>;
                     url: z.ZodURL;
                 }, z.core.$strip>>;
                 nextCursor: z.ZodOptional<z.ZodString>;
@@ -3123,6 +3517,7 @@ export declare const publicContractsV1: {
                     running: "running";
                 }>;
                 terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                variablesUrl: z.ZodOptional<z.ZodURL>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -3224,6 +3619,7 @@ export declare const publicContractsV1: {
                     running: "running";
                 }>;
                 terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                variablesUrl: z.ZodOptional<z.ZodURL>;
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
@@ -4420,7 +4816,7 @@ export declare const publicContractsV1: {
                 readonly openWorldHint: false;
                 readonly readOnlyHint: false;
             };
-            readonly description: "Launch an interactive runner on the caller's team under an id the caller chooses. Launching the same id again returns the runner already running rather than starting a second one, and the same id with a different runnerName is refused. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner — so read `alreadyRunning` to tell which happened. After a successful launch, make the next action a normal user-visible assistant message containing the exact returned `url`, before the first browser action. Tool output and internal reasoning do not count as sharing the link. When `alreadyRunning` is true the `url` is the same page, so share it again instead of assuming the caller still has it.";
+            readonly description: "Launch an interactive runner on the caller's team under an id the caller chooses. Launching the same id again returns the runner already running rather than starting a second one, and the same id with a different runnerName is refused. A runner is not permanent: it terminates on its own after a period of inactivity, and launching the same id after that starts and bills a new runner — so read `alreadyRunning` to tell which happened. A success means the runner is answering: the call waits for the pod it started to come up, so the very next call to the runner reaches it. If the pod does not come up in time the call fails instead, leaving the runner running — launching the same id again attaches to it. After a successful launch, put the exact returned `url` in a normal user-visible assistant message so they can watch while the browser is driven. Tool output and internal reasoning do not count as sharing the link. When `alreadyRunning` is true the `url` is the same page, so share it again instead of assuming the caller still has it.";
             readonly input: z.ZodObject<{
                 id: z.ZodString;
                 runnerName: z.ZodOptional<z.ZodEnum<{
@@ -4480,7 +4876,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. 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). 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. A `navigate` does not go through the screen, so a screen that is not ready does not stop 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. `action-not-supported-on-mobile` if the runner is a mobile device and this action has no touchscreen equivalent: `double_click`, `scroll`, `move`, `keypress` and `navigate`, and a `click` whose `button` is not `left`, are all pointer-device concepts a touchscreen has nothing to offer for. `click` taps, `drag` swipes between its path's first and last point, and `type` types into whatever the last tap focused. With `withScreenshot: true`, the answer also carries `imageJpegBase64`: a screenshot taken after the action, once the screen has changed from just before it or half a second has passed, whichever comes first. One call instead of `runner.performAction` followed by `runner.takeScreenshot`, with no fixed wait in between. Anything animating on the page counts as a change. The action itself is performed exactly as without the option; if the screen could serve no frame after it — a display restart, or a `navigate` on a desktop that is still starting — the action's result comes back without `imageJpegBase64`, so take a screenshot separately rather than repeating the action. On a mobile runner the screenshot is the device's own, taken right after a performed action. `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 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 input: z.ZodObject<{
                 action: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     button: z.ZodLiteral<"left" | "right" | "wheel" | "back" | "forward">;