@qawolf/api-contracts 0.59.0 → 0.63.0

package/dist/v1/legacyTrigger/resource.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+const namedIdentity = z.object({ id: z.string(), name: z.string() });
+/**
+ * How a legacy deployment trigger narrows the branches it fires for.
+ *
+ * `listed-branches` carries the stored value as `raw` alongside the globs it
+ * splits into, because a current trigger's `branchPattern` is a single
+ * case-insensitive glob with no negation and each entry has to be mapped by
+ * hand.
+ */
+const branchScope = z.union([
+    z.object({ kind: z.literal("all-branches") }),
+    z.object({
+        caseSensitiveGlobs: z.array(z.string()),
+        kind: z.literal("listed-branches"),
+        negated: z.boolean(),
+        raw: z.string(),
+    }),
+]);
+const codeHostingServiceRepository = z.union([
+    z.object({ kind: z.literal("any") }),
+    z.object({ kind: z.literal("none") }),
+    z.object({ id: z.string(), kind: z.literal("by-id") }),
+]);
+export const makeLegacyTriggerSchema = (ids) => {
+    const base = {
+        environment: z.object({
+            id: ids.environment,
+            kind: z
+                .enum(["static", "preview"])
+                .describe("Whether the environment is static or a preview. A preview environment holds copies of the static deployment triggers."),
+            name: z.string(),
+            terminatedAt: z.iso
+                .datetime()
+                .optional()
+                .describe("When the environment was terminated, if it has been."),
+        }),
+        id: ids.legacyTrigger,
+        isPaused: z.boolean(),
+        name: z.string(),
+        pausedAt: z.iso.datetime().optional(),
+        tags: z.array(namedIdentity),
+    };
+    return z.union([
+        z.object({
+            ...base,
+            nextAt: z.iso.datetime().optional(),
+            repeatMinutes: z.number(),
+            startAt: z.iso.datetime().optional(),
+            timezoneId: z.string().optional(),
+            type: z.literal("scheduled"),
+        }),
+        z.object({
+            ...base,
+            adaptiveFlowSelection: z
+                .boolean()
+                .describe("Whether QA Wolf picks the flows to run from the deployment's changes. Such a trigger migrates to a generativeSuite action, which names no flows or tags of its own."),
+            branchScope,
+            codeHostingServiceRepository,
+            deploymentPrLabel: z.string().optional(),
+            deploymentType: z.string().optional(),
+            type: z.union([z.literal("generic"), z.literal("pr-testing-button")]),
+        }),
+    ]);
+};
+//# sourceMappingURL=resource.js.map

package/dist/v1/legacyTrigger/resource.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"mcpToolDescription.d.ts","sourceRoot":"","sources":["../../src/v1/mcpToolDescription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,KAAK,YAAY,CAAC,IAAI,IAAI,IAAI,SAAS;IAAE,IAAI,EAAE,MAAM,IAAI,SAAS,MAAM,CAAA;CAAE,GACtE,IAAI,GACJ,IAAI,SAAS,MAAM,GACjB;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CAAE,CAAC,MAAM,IAAI,CAAC,GAC5D,KAAK,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AA2BxE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAKR"}
+{"version":3,"file":"mcpToolDescription.d.ts","sourceRoot":"","sources":["../../src/v1/mcpToolDescription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,KAAK,YAAY,CAAC,IAAI,IAAI,IAAI,SAAS;IAAE,IAAI,EAAE,MAAM,IAAI,SAAS,MAAM,CAAA;CAAE,GACtE,IAAI,GACJ,IAAI,SAAS,MAAM,GACjB;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CAAE,CAAC,MAAM,IAAI,CAAC,GAC5D,KAAK,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AA6BxE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAKR"}

package/dist/v1/mcpToolDescription.js

@@ -1,12 +1,13 @@
 const descriptionAddenda = {
-    automate: "automate builds drafts that already exist in a local flow-code checkout and cannot create new flows. Without a checkout, send the request to agent.send instead.",
     "environment.update": "At least one of name or runConcurrencyLimit is required.",
     "flow.list": "An empty flows array is not on its own evidence that QA Wolf lost a flow. Read emptyReason, report what it says, and claim no more than it establishes.",
     "issue.update": "At least one of description, name, priority or status is required.",
     "run.create": "At least one flow or tag is required, so send flowIds, tagNames, or both. Send at most one of aiTaskId and chatSessionId. This call has no idempotency key, so a lost response cannot be safely resubmitted: read run.find before sending it again.",
     "runner.launch": "A runner bills for as long as it exists, so call runner_terminate as soon as the work is done. The answer carries a url: give it to the person who asked, so they can see the runner. The screen on that page plays only for whoever launched the runner, so a person opening it for one this connection launched with a team key sees the page without the screen.",
     "runner.list": "Call this before runner_launch to reuse a runner that is already running instead of paying for a second one. A listed runner may be driven by another machine or session right now, so sending it work can collide with theirs.",
+    "runner.performAction": "Send withScreenshot: true for the screen the action led to in the same answer, rather than a second round trip through runner_takeScreenshot.",
     "runner.runFlow": "files must include the entry point and the run's package.json. Send env or environmentId, not both. A path may be sent in files or referenced in unchangedFiles, not both. This call has no idempotency key, so a lost response cannot be safely resubmitted: read the runner's run-status journal stream before sending it again.",
+    "runner.takeScreenshot": "To see the screen an action led to, send withScreenshot: true on runner_performAction instead, which answers with the frame; call this on its own to look at the screen without acting on it.",
 };
 function readAddendum(contractName) {
     return Object.entries(descriptionAddenda).find(([name]) => name === contractName)?.[1];

package/dist/v1/mcpToolDescription.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcpToolDescription.js","sourceRoot":"","sources":["../../src/v1/mcpToolDescription.ts"],"names":[],"mappings":"AAWA,MAAM,kBAAkB,GAAgD;IACtE,QAAQ,EACN,kKAAkK;IACpK,oBAAoB,EAClB,0DAA0D;IAC5D,WAAW,EACT,yJAAyJ;IAC3J,cAAc,EACZ,oEAAoE;IACtE,YAAY,EACV,qPAAqP;IACvP,eAAe,EACb,qWAAqW;IACvW,aAAa,EACX,iOAAiO;IACnO,gBAAgB,EACd,oUAAoU;CACvU,CAAC;AAEF,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,YAAY,CAClC,EAAE,CAAC,CAAC,CAAC,CAAC;AACT,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA8B;IAE9B,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,QAAQ;QACb,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,IAAI,QAAQ,EAAE;QACvC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"mcpToolDescription.js","sourceRoot":"","sources":["../../src/v1/mcpToolDescription.ts"],"names":[],"mappings":"AAWA,MAAM,kBAAkB,GAAgD;IACtE,oBAAoB,EAClB,0DAA0D;IAC5D,WAAW,EACT,yJAAyJ;IAC3J,cAAc,EACZ,oEAAoE;IACtE,YAAY,EACV,qPAAqP;IACvP,eAAe,EACb,qWAAqW;IACvW,aAAa,EACX,iOAAiO;IACnO,sBAAsB,EACpB,+IAA+I;IACjJ,gBAAgB,EACd,oUAAoU;IACtU,uBAAuB,EACrB,+LAA+L;CAClM,CAAC;AAEF,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,YAAY,CAClC,EAAE,CAAC,CAAC,CAAC,CAAC;AACT,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA8B;IAE9B,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,QAAQ;QACb,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,IAAI,QAAQ,EAAE;QACvC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * How many actions one request may carry. A sequence is one request held open
+ * until its last action answers, so the bound keeps it to what a caller does
+ * between two looks at the screen, and keeps `each` mode to ten frames. Only
+ * ever lower it: apex and the pod both validate with it, and pods deploy
+ * separately, so a raised bound forwards sequences an older pod rejects.
+ */
+export declare const maxActionsPerRequest = 10;
+/** When a sequence frames the screen: never, once after its last action, or after every action. */
+export declare const screenshotModes: readonly ["none", "final", "each"];
+export type ScreenshotMode = (typeof screenshotModes)[number];
+//# sourceMappingURL=actionSequence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionSequence.d.ts","sourceRoot":"","sources":["../../../src/v1/runner/actionSequence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,mGAAmG;AACnG,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/v1/runner/actionSequence.js

@@ -0,0 +1,11 @@
+/**
+ * How many actions one request may carry. A sequence is one request held open
+ * until its last action answers, so the bound keeps it to what a caller does
+ * between two looks at the screen, and keeps `each` mode to ten frames. Only
+ * ever lower it: apex and the pod both validate with it, and pods deploy
+ * separately, so a raised bound forwards sequences an older pod rejects.
+ */
+export const maxActionsPerRequest = 10;
+/** When a sequence frames the screen: never, once after its last action, or after every action. */
+export const screenshotModes = ["none", "final", "each"];
+//# sourceMappingURL=actionSequence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionSequence.js","sourceRoot":"","sources":["../../../src/v1/runner/actionSequence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,mGAAmG;AACnG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC"}