@qawolf/api-contracts 0.67.0 → 0.69.0

package/dist/v1/investigation/recordFinding.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { issuePrioritySchema } from "../issue/index.js";
+import { makeInvestigationFindingSchema } from "./finding.js";
+import { answerDescription, answerTitle, bugReport, commitHash, headline, matchReason, question, summary, } from "./findingInputFields.js";
+export const makeRecordInvestigationFindingContract = (ids) => {
+    const common = {
+        findingId: z
+            .string()
+            .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/)
+            .max(80)
+            .describe("Stable per cause, in kebab-case. Recording the same id again replaces the finding."),
+        flowIds: z
+            .array(ids.flow)
+            .min(1)
+            .max(100)
+            .refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique")
+            .describe("The failed flows in the run that share this cause. A flow moves here from any other finding."),
+        runId: ids.run,
+        sessionId: ids.chatSession.describe("The run's investigation session, the only session that records its findings. Read it from investigation.get."),
+        subSessionIds: z
+            .array(ids.chatSession)
+            .max(50)
+            .optional()
+            .describe("The sub-sessions whose work went into this finding."),
+    };
+    const input = z.discriminatedUnion("state", [
+        z.object({
+            ...common,
+            headline: headline.optional(),
+            state: z.literal("investigating"),
+            summary: summary.optional(),
+        }),
+        z.object({
+            ...common,
+            commitHash,
+            headline,
+            state: z.literal("fixed"),
+            summary,
+        }),
+        z.object({
+            ...common,
+            commitHash,
+            headline,
+            question: question
+                .optional()
+                .describe('Defaults to "Should I update the test?".'),
+            state: z.literal("fix-proposed"),
+            summary,
+        }),
+        z.object({
+            ...common,
+            ...bugReport,
+            headline,
+            issueId: ids.issue.describe("The report the flows were filed under or added to."),
+            matchReason: matchReason.optional(),
+            state: z.literal("reported"),
+            summary,
+        }),
+        z.object({
+            ...common,
+            ...bugReport,
+            headline,
+            issueId: ids.issue
+                .optional()
+                .describe("An already open report the flows match."),
+            matchReason: matchReason.optional(),
+            priority: issuePrioritySchema,
+            question: question
+                .optional()
+                .describe('Defaults to "Is this what you expect?".'),
+            state: z.literal("report-proposed"),
+            summary,
+        }),
+        z.object({ ...common, headline, state: z.literal("flake"), summary }),
+        z.object({
+            ...common,
+            bugAnswer: answerTitle.describe("The answer that means the app is wrong."),
+            bugAnswerDescription: answerDescription
+                .optional()
+                .describe("What the AI does after that answer."),
+            headline,
+            maintenanceAnswer: answerTitle.describe("The answer that means the test is out of date."),
+            maintenanceAnswerDescription: answerDescription
+                .optional()
+                .describe("What the AI does after that answer."),
+            question,
+            state: z.literal("question"),
+            summary,
+        }),
+    ]);
+    const output = z.object({
+        finding: makeInvestigationFindingSchema(ids),
+    });
+    return {
+        annotations: {
+            destructiveHint: true,
+            openWorldHint: false,
+            readOnlyHint: false,
+        },
+        description: "Record what the QA Wolf AI investigating a run concluded about one cause of its failures. " +
+            'state says what it concluded: "investigating" while sub-sessions work on the flows, "fixed" once a fix is published and the flows reattempted, ' +
+            '"fix-proposed" for a committed fix waiting for a person\'s approval, "reported" once the flows are filed or added to an open report, ' +
+            '"report-proposed" for a drafted report waiting for approval, "flake" when a reattempt passed with no change, ' +
+            'and "question" when the AI can\'t tell whether the test or the app is wrong. ' +
+            "Each flow belongs to one finding at a time, and a finding a person decided can't be replaced.",
+        input,
+        kind: "write",
+        name: "investigation.recordFinding",
+        output,
+    };
+};
+//# sourceMappingURL=recordFinding.js.map

package/dist/v1/investigation/recordFinding.js.map

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

package/dist/v1/mcpInputSchema.d.ts

@@ -5,5 +5,11 @@ export type McpInputSchema = {
     required?: string[];
     type: "object";
 };
+/**
+ * Converts a contract input to the JSON Schema an MCP tool advertises: always
+ * one flat object, with no `allOf`, `anyOf` or `oneOf` at the root. The
+ * contract still validates every call, so the rules a flat object cannot
+ * enforce, such as a field required for one kind only, stay enforced there.
+ */
 export declare function toMcpInputSchema(input: z.ZodType): McpInputSchema;
 //# sourceMappingURL=mcpInputSchema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mcpInputSchema.d.ts","sourceRoot":"","sources":["../../src/v1/mcpInputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AA2BF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,GAAG,cAAc,CAYjE"}
+{"version":3,"file":"mcpInputSchema.d.ts","sourceRoot":"","sources":["../../src/v1/mcpInputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAsDF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,GAAG,cAAc,CAYjE"}

package/dist/v1/mcpInputSchema.js

@@ -1,30 +1,61 @@
 import { z } from "zod";
-function toObjectProperties(properties) {
-    return Object.fromEntries(Object.entries(properties).map(([key, schema]) => {
-        if (typeof schema !== "boolean")
-            return [key, schema];
-        return [key, schema ? {} : { not: {} }];
-    }));
+import { declarationsOf, oneOrAll, propertyNamesOf, toSchemaObject, unique, } from "./mcpInputShape.js";
+import { mergeDiscriminatedUnion } from "./mcpInputUnion.js";
+const structuralKeys = new Set([
+    "$schema",
+    "allOf",
+    "anyOf",
+    "oneOf",
+    "properties",
+    "required",
+    "type",
+]);
+function mergeIntersection(shapes) {
+    return {
+        properties: Object.fromEntries(propertyNamesOf(shapes).map((name) => [
+            name,
+            oneOrAll(declarationsOf(shapes, name), "allOf"),
+        ])),
+        required: unique(shapes.flatMap((shape) => shape.required)),
+    };
 }
-function requiringWorkspaceId(schema) {
-    const { allOf, properties, required = [] } = schema;
-    const declaresWorkspaceId = properties !== undefined && "workspaceId" in properties;
+function toObjectShape(schema) {
+    if (schema.allOf)
+        return mergeIntersection(schema.allOf.map(toObjectShape));
+    const alternatives = schema.oneOf ?? schema.anyOf;
+    if (alternatives)
+        return mergeDiscriminatedUnion(alternatives.map(toObjectShape));
+    if (schema.type !== "object") {
+        throw Error(`An MCP tool input must be an object schema, not ${schema.type ?? "an untyped schema"}.`);
+    }
     return {
-        ...schema,
-        ...(allOf ? { allOf: allOf.map(requiringWorkspaceId) } : {}),
-        ...(declaresWorkspaceId && !required.includes("workspaceId")
-            ? { required: [...required, "workspaceId"] }
-            : {}),
+        properties: Object.fromEntries(Object.entries(schema.properties ?? {}).map(([name, property]) => [
+            name,
+            toSchemaObject(property),
+        ])),
+        required: schema.required ?? [],
     };
 }
+function requiringWorkspaceId(shape) {
+    const declaresWorkspaceId = "workspaceId" in shape.properties;
+    if (!declaresWorkspaceId || shape.required.includes("workspaceId"))
+        return shape;
+    return { ...shape, required: [...shape.required, "workspaceId"] };
+}
+/**
+ * Converts a contract input to the JSON Schema an MCP tool advertises: always
+ * one flat object, with no `allOf`, `anyOf` or `oneOf` at the root. The
+ * contract still validates every call, so the rules a flat object cannot
+ * enforce, such as a field required for one kind only, stay enforced there.
+ */
 export function toMcpInputSchema(input) {
-    const generated = requiringWorkspaceId(z.toJSONSchema(input, { io: "input" }));
-    delete generated.$schema;
-    const { properties, required, ...rest } = generated;
+    const generated = z.toJSONSchema(input, { io: "input" });
+    const shape = requiringWorkspaceId(toObjectShape(generated));
+    const annotations = Object.fromEntries(Object.entries(generated).filter(([key]) => !structuralKeys.has(key)));
     return {
-        ...rest,
-        ...(properties ? { properties: toObjectProperties(properties) } : {}),
-        ...(required ? { required } : {}),
+        ...annotations,
+        properties: shape.properties,
+        ...(shape.required.length > 0 ? { required: shape.required } : {}),
         type: "object",
     };
 }

package/dist/v1/mcpInputSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcpInputSchema.js","sourceRoot":"","sources":["../../src/v1/mcpInputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,SAAS,kBAAkB,CACzB,UAA4C;IAE5C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;QAC/C,IAAI,OAAO,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAkB;IAC9C,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IACpD,MAAM,mBAAmB,GACvB,UAAU,KAAK,SAAS,IAAI,aAAa,IAAI,UAAU,CAAC;IAE1D,OAAO;QACL,GAAG,MAAM;QACT,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,mBAAmB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC1D,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,aAAa,CAAC,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,MAAM,SAAS,GAAG,oBAAoB,CACpC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CACvC,CAAC;IACF,OAAO,SAAS,CAAC,OAAO,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IACpD,OAAO;QACL,GAAG,IAAI;QACP,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,IAAI,EAAE,QAAQ;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mcpInputSchema.js","sourceRoot":"","sources":["../../src/v1/mcpInputSchema.ts"],"names":[],"mappings":"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"}

package/dist/v1/mcpInputShape.d.ts

@@ -0,0 +1,13 @@
+import type { z } from "zod";
+export type JsonSchema = z.core.JSONSchema.JSONSchema;
+export type ObjectShape = {
+    properties: Record<string, JsonSchema>;
+    required: string[];
+};
+export declare function unique<Item>(items: Item[]): Item[];
+export declare function toSchemaObject(schema: z.core.JSONSchema._JSONSchema): JsonSchema;
+export declare function propertyOf(shape: ObjectShape, name: string): JsonSchema | undefined;
+export declare function declarationsOf(shapes: ObjectShape[], name: string): JsonSchema[];
+export declare function propertyNamesOf(shapes: ObjectShape[]): string[];
+export declare function oneOrAll(schemas: JsonSchema[], combinator: "allOf" | "anyOf"): JsonSchema;
+//# sourceMappingURL=mcpInputShape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpInputShape.d.ts","sourceRoot":"","sources":["../../src/v1/mcpInputShape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAElD;AASD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,GACpC,UAAU,CAGZ;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,SAAS,CAExB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,EAAE,MAAM,GACX,UAAU,EAAE,CAKd;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAE/D;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,UAAU,EAAE,EACrB,UAAU,EAAE,OAAO,GAAG,OAAO,GAC5B,UAAU,CAIZ"}

package/dist/v1/mcpInputShape.js

@@ -0,0 +1,31 @@
+export function unique(items) {
+    return [...new Set(items)];
+}
+function distinctSchemas(schemas) {
+    const byJson = new Map(schemas.map((schema) => [JSON.stringify(schema), schema]));
+    return [...byJson.values()];
+}
+export function toSchemaObject(schema) {
+    if (typeof schema !== "boolean")
+        return schema;
+    return schema ? {} : { not: {} };
+}
+export function propertyOf(shape, name) {
+    return Object.entries(shape.properties).find(([key]) => key === name)?.[1];
+}
+export function declarationsOf(shapes, name) {
+    return shapes.flatMap((shape) => {
+        const property = propertyOf(shape, name);
+        return property === undefined ? [] : [property];
+    });
+}
+export function propertyNamesOf(shapes) {
+    return unique(shapes.flatMap((shape) => Object.keys(shape.properties)));
+}
+export function oneOrAll(schemas, combinator) {
+    const [only, ...others] = distinctSchemas(schemas);
+    if (!only)
+        throw Error("Cannot merge a property no branch declares.");
+    return others.length === 0 ? only : { [combinator]: [only, ...others] };
+}
+//# sourceMappingURL=mcpInputShape.js.map

package/dist/v1/mcpInputShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpInputShape.js","sourceRoot":"","sources":["../../src/v1/mcpInputShape.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,MAAM,CAAO,KAAa;IACxC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CAAC,OAAqB;IAC5C,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAC1D,CAAC;IACF,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAqC;IAErC,IAAI,OAAO,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC/C,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAkB,EAClB,IAAY;IAEZ,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAqB,EACrB,IAAY;IAEZ,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAgB,EAAE;QAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzC,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,OAAqB,EACrB,UAA6B;IAE7B,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,MAAM,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/v1/mcpInputUnion.d.ts

@@ -0,0 +1,3 @@
+import { type ObjectShape } from "./mcpInputShape.js";
+export declare function mergeDiscriminatedUnion(shapes: ObjectShape[]): ObjectShape;
+//# sourceMappingURL=mcpInputUnion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpInputUnion.d.ts","sourceRoot":"","sources":["../../src/v1/mcpInputUnion.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAKjB,MAAM,oBAAoB,CAAC;AA+E5B,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,CAyC1E"}

package/dist/v1/mcpInputUnion.js

@@ -0,0 +1,83 @@
+import { declarationsOf, oneOrAll, propertyNamesOf, propertyOf, } from "./mcpInputShape.js";
+function pinnedValueOf(shape, name) {
+    const pinned = propertyOf(shape, name)?.const;
+    return typeof pinned === "string" ? pinned : undefined;
+}
+function branchesPinnedBy(shapes, name) {
+    return shapes.flatMap((shape) => {
+        const value = pinnedValueOf(shape, name);
+        return value === undefined ? [] : [{ shape, value }];
+    });
+}
+function findDiscriminator(shapes) {
+    return propertyNamesOf(shapes)
+        .map((name) => ({ branches: branchesPinnedBy(shapes, name), name }))
+        .find(({ branches }) => branches.length === shapes.length &&
+        new Set(branches.map((branch) => branch.value)).size === shapes.length);
+}
+function listAlternatives(values) {
+    const quoted = values.map((value) => JSON.stringify(value));
+    if (quoted.length < 2)
+        return quoted.join("");
+    return `${quoted.slice(0, -1).join(", ")} or ${quoted.slice(-1).join("")}`;
+}
+function describeCondition(options) {
+    const { branchCount, discriminator, presentIn, requiredIn } = options;
+    const onlySome = presentIn.length < branchCount;
+    const requiredInSome = requiredIn.length > 0 && requiredIn.length < branchCount;
+    const when = (values) => `${discriminator} is ${listAlternatives(values)}`;
+    if (onlySome && requiredIn.length === presentIn.length)
+        return `Applies only when ${when(presentIn)}, and is required then.`;
+    const sentences = [
+        ...(onlySome ? [`Applies only when ${when(presentIn)}.`] : []),
+        ...(requiredInSome ? [`Required when ${when(requiredIn)}.`] : []),
+    ];
+    return sentences.length === 0 ? undefined : sentences.join(" ");
+}
+function withCondition(schema, condition) {
+    if (condition === undefined)
+        return schema;
+    const description = typeof schema.description === "string"
+        ? `${schema.description} ${condition}`
+        : condition;
+    return { ...schema, description };
+}
+function withoutPin(schema) {
+    return Object.fromEntries(Object.entries(schema).filter(([key]) => key !== "const"));
+}
+// The Claude API refuses a combinator at the root of a tool's input schema,
+// and clients that flatten it themselves either drop branches or leave array
+// fields untyped. A discriminated union keeps every branch: the discriminator
+// becomes an enum, and a field that belongs to some branches says which.
+export function mergeDiscriminatedUnion(shapes) {
+    const found = findDiscriminator(shapes);
+    if (found === undefined) {
+        throw Error("An MCP tool input that is a union needs a discriminator: a property every branch pins to a distinct string.");
+    }
+    const { branches, name: discriminator } = found;
+    const valuesWhere = (matches) => branches.filter(({ shape }) => matches(shape)).map(({ value }) => value);
+    const properties = propertyNamesOf(shapes).map((name) => {
+        const declared = declarationsOf(shapes, name);
+        if (name === discriminator) {
+            return [
+                name,
+                {
+                    ...oneOrAll(declared.map(withoutPin), "anyOf"),
+                    enum: branches.map(({ value }) => value),
+                },
+            ];
+        }
+        const condition = describeCondition({
+            branchCount: shapes.length,
+            discriminator,
+            presentIn: valuesWhere((shape) => propertyOf(shape, name) !== undefined),
+            requiredIn: valuesWhere((shape) => shape.required.includes(name)),
+        });
+        return [name, withCondition(oneOrAll(declared, "anyOf"), condition)];
+    });
+    return {
+        properties: Object.fromEntries(properties),
+        required: propertyNamesOf(shapes).filter((name) => shapes.every((shape) => shape.required.includes(name))),
+    };
+}
+//# sourceMappingURL=mcpInputUnion.js.map

package/dist/v1/mcpInputUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpInputUnion.js","sourceRoot":"","sources":["../../src/v1/mcpInputUnion.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;AAyBxE,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,8 +1,10 @@
 const descriptionAddenda = {
     "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.",
+    "investigation.recordFinding": "Read investigation.get first, and keep one findingId per cause: recording it again replaces the finding instead of adding one.",
     "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.",
+    "run.get": 'Read a run with flowStatuses: ["failed"] first. A flow that passed on a retry reads passed, so when the flow you want is missing, add "passed" to the filter.',
     "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.",

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,oBAAoB,EAClB,0DAA0D;IAC5D,WAAW,EACT,yJAAyJ;IAC3J,cAAc,EACZ,oEAAoE;IACtE,YAAY,EACV,qPAAqP;IACvP,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"}
+{"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,6BAA6B,EAC3B,gIAAgI;IAClI,cAAc,EACZ,oEAAoE;IACtE,YAAY,EACV,qPAAqP;IACvP,SAAS,EACP,+JAA+J;IACjK,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/run/get.d.ts

@@ -13,6 +13,13 @@ export declare const makeGetRunContract: <FlowId extends PublicIdSchema, IssueId
     };
     readonly description: "Get a run's status, per-flow results, links, and how many of its bugs are blocking.";
     readonly input: z.ZodObject<{
+        flowStatuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            failed: "failed";
+            running: "running";
+            canceled: "canceled";
+            queued: "queued";
+            passed: "passed";
+        }>>>;
         runId: RunId;
     }, z.core.$strip>;
     readonly kind: "read";

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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6KA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4LA,CAAC"}

package/dist/v1/run/get.js

@@ -1,8 +1,18 @@
 import { z } from "zod";
 import { resource } from "../resource.js";
-import { makeRunSummaryFields } from "./summary.js";
+import { makeRunSummaryFields, publicRunStatusValues } from "./summary.js";
 export const makeGetRunContract = (ids) => {
+    const flowStatus = z.enum(publicRunStatusValues);
     const input = z.object({
+        flowStatuses: z
+            .array(flowStatus)
+            .min(1)
+            .optional()
+            .describe("Return only the flows whose status is one of these. A suite run can " +
+            "hold hundreds of flows, so start an investigation with failed " +
+            "alone. A flow that passed after a retry reads passed, so add " +
+            "passed when a flaky flow is missing from the answer. Omit to " +
+            "return every flow. The run-level fields are unaffected."),
         runId: ids.run,
     });
     // Artifact URLs are signed without checking storage, so a fetch can return
@@ -121,11 +131,12 @@ export const makeGetRunContract = (ids) => {
         attempts,
         flowId: ids.flow,
         name: z.string(),
-        status: z.enum(["queued", "running", "passed", "canceled"]),
+        status: flowStatus.exclude(["failed"]),
     });
     const flows = z
         .array(z.discriminatedUnion("status", [failedFlow, nonFailedFlow]))
-        .describe("The run's flows, ordered alphabetically by name.");
+        .describe("The run's flows, ordered alphabetically by name. Only the flows " +
+        "matching flowStatuses when the request set it.");
     const output = resource({
         ...makeRunSummaryFields(ids),
         blockingBugCount: z

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

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

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

@@ -1,5 +1,7 @@
 import { z } from "zod";
 import type { PublicIdSchema } from "../ids.js";
+/** The public status vocabulary, shared by a run and by each of its flows. */
+export declare const publicRunStatusValues: readonly ["queued", "running", "passed", "failed", "canceled"];
 export declare const makeRunSummaryFields: <RunId extends PublicIdSchema>(ids: {
     run: RunId;
 }) => {

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

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

package/dist/v1/run/summary.js

@@ -1,4 +1,12 @@
 import { z } from "zod";
+/** The public status vocabulary, shared by a run and by each of its flows. */
+export const publicRunStatusValues = [
+    "queued",
+    "running",
+    "passed",
+    "failed",
+    "canceled",
+];
 // The shared run summary fields. run.find returns them as rows. run.get adds
 // the per-flow results to them. Both shapes come from this one factory, so
 // the shapes cannot become different.
@@ -28,7 +36,7 @@ export const makeRunSummaryFields = (ids) => ({
     // for belongs on run.get alone.
     runId: ids.run,
     status: z
-        .enum(["queued", "running", "passed", "failed", "canceled"])
+        .enum(publicRunStatusValues)
         .describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, and canceled; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer."),
 });
 //# sourceMappingURL=summary.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/api-contracts",
-  "version": "0.67.0",
+  "version": "0.69.0",
   "private": false,
   "description": "Versioned contracts for the QA Wolf public API",
   "repository": {