@qawolf/api-contracts 0.1.0 → 0.11.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/v1/run/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAGlC,GAID,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,oEAAoE;QACpE,gEAAgE;QAChE,+BAA+B;QAC/B,YAAY,EAAE,CAAC,CAAC,GAAG;aAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,CACP,6EAA6E,CAC9E;QACH,yEAAyE;QACzE,uDAAuD;QACvD,GAAG,yBAAyB,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACjE,aAAa,EAAE,GAAG,CAAC,WAAW;KAC/B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,UAAU,EAAE,gBAAgB;QAC5B,IAAI,EAAE,CAAC;aACJ,KAAK,CACJ,QAAQ,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE;YAClC,mBAAmB,EAAE,+BAA+B;SACrD,CAAC,CACH;aACA,QAAQ,CACP,mFAAmF,CACpF;KACJ,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,kDAAkD;QAC/D,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,UAAU;QAChB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeFlowSelectionSchema: <FlowId extends PublicIdSchema>(ids: {
+    flow: FlowId;
+}) => z.ZodObject<{
+    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+//# sourceMappingURL=flowSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flowSelection.d.ts","sourceRoot":"","sources":["../../../src/v1/run/flowSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,uBAAuB,GAAI,MAAM,SAAS,cAAc,EAAE,KAAK;IAC1E,IAAI,EAAE,MAAM,CAAC;CACd;;;iBAWI,CAAC"}

package/dist/v1/run/flowSelection.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+// Takes only the flow schema: callers like stored trigger actions have no
+// other public id concepts to inject.
+export const makeFlowSelectionSchema = (ids) => z
+    .object({
+    flowIds: z.array(ids.flow).default([]),
+    tagNames: z.array(z.string().min(1)).default([]),
+})
+    .refine((selection) => selection.flowIds.length + selection.tagNames.length > 0, {
+    message: "At least one flow or tag is required.",
+});
+//# sourceMappingURL=flowSelection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flowSelection.js","sourceRoot":"","sources":["../../../src/v1/run/flowSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,0EAA0E;AAC1E,sCAAsC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAgC,GAEtE,EAAE,EAAE,CACH,CAAC;KACE,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjD,CAAC;KACD,MAAM,CACL,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EACvE;IACE,OAAO,EAAE,uCAAuC;CACjD,CACF,CAAC"}

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

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeGetRunContract: <FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
+    [key: string]: unknown;
+    flow: FlowId;
+    run: RunId;
+}) => {
+    readonly description: "Get a run's status, per-flow results, and links.";
+    readonly input: z.ZodObject<{
+        runId: RunId;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "run.get";
+    readonly output: z.ZodObject<{
+        flows: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            failure: z.ZodObject<{
+                error: z.ZodString;
+            }, z.core.$strip>;
+            flowId: FlowId;
+            name: z.ZodString;
+            status: z.ZodLiteral<"failed">;
+        }, z.core.$strip>, z.ZodObject<{
+            flowId: FlowId;
+            name: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                canceled: "canceled";
+                queued: "queued";
+                passed: "passed";
+            }>;
+        }, z.core.$strip>], "status">>;
+        completedAt: z.ZodOptional<z.ZodISODateTime>;
+        createdAt: z.ZodISODateTime;
+        git: z.ZodObject<{
+            branch: z.ZodOptional<z.ZodString>;
+            commitMessage: z.ZodOptional<z.ZodString>;
+            commitSha: z.ZodOptional<z.ZodString>;
+            commitUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        runId: RunId;
+        status: z.ZodEnum<{
+            running: "running";
+            canceled: "canceled";
+            queued: "queued";
+            passed: "passed";
+            failed: "failed";
+        }>;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=get.d.ts.map

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

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

package/dist/v1/run/get.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+import { makeRunSummaryFields } from "./summary.js";
+export const makeGetRunContract = (ids) => {
+    const input = z.object({
+        runId: ids.run,
+    });
+    // We return one flat entry per flow, each carrying its own status, rather
+    // than status-keyed buckets (`{ passed: [...], failed: [...] }`). A flat list
+    // is a superset — the caller can group by status — and gives each flow a
+    // place to carry detail (its failure now, links later) without reshaping.
+    // We also dropped the aggregate outcome counts an earlier version returned:
+    // they are derivable from this list, and keeping both invites the two
+    // representations to drift.
+    // A flow entry is a discriminated union on `status`: a failed flow always
+    // carries `failure`, and every non-failed flow omits it. Encoding the rule in
+    // the shape means the contract rejects a "failed" flow with no error (and a
+    // `failure` on a flow that didn't fail), so a caller can rely on
+    // "failed ⇔ failure present" instead of defensively checking, and we can't
+    // accidentally emit a contradictory record.
+    const failedFlow = z.object({
+        failure: z.object({
+            // The raw error from the run itself, available the moment the flow fails.
+            // Chosen over QA Wolf's analyzed error (`RunAnalysisDto`): the analysis is
+            // produced only after investigation and is usually absent while an agent
+            // is still polling, whereas this is immediate. Analysis fields
+            // (categorization, a parsed line number) can be added here later as
+            // optional additions without another contract bump.
+            error: z.string(),
+        }),
+        flowId: ids.flow,
+        name: z.string(),
+        status: z.literal("failed"),
+    });
+    const nonFailedFlow = z.object({
+        flowId: ids.flow,
+        name: z.string(),
+        status: z.enum(["queued", "running", "passed", "canceled"]),
+    });
+    const flows = z
+        .array(z.discriminatedUnion("status", [failedFlow, nonFailedFlow]))
+        .describe("The run's flows, ordered alphabetically by name.");
+    const output = resource({
+        ...makeRunSummaryFields(ids),
+        flows,
+    }, { urlFieldDescription: "Absolute URL of the run page." });
+    return {
+        description: "Get a run's status, per-flow results, and links.",
+        input,
+        kind: "read",
+        name: "run.get",
+        output,
+    };
+};
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/v1/run/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAGhC,GAID,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,KAAK,EAAE,GAAG,CAAC,GAAG;KACf,CAAC,CAAC;IAEH,0EAA0E;IAC1E,8EAA8E;IAC9E,yEAAyE;IACzE,0EAA0E;IAC1E,4EAA4E;IAC5E,sEAAsE;IACtE,4BAA4B;IAC5B,0EAA0E;IAC1E,8EAA8E;IAC9E,4EAA4E;IAC5E,iEAAiE;IACjE,2EAA2E;IAC3E,4CAA4C;IAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,0EAA0E;YAC1E,2EAA2E;YAC3E,yEAAyE;YACzE,+DAA+D;YAC/D,oEAAoE;YACpE,oDAAoD;YACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC;QACF,MAAM,EAAE,GAAG,CAAC,IAAI;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,IAAI;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;KAC5D,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;SAClE,QAAQ,CAAC,kDAAkD,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,QAAQ,CACrB;QACE,GAAG,oBAAoB,CAAC,GAAG,CAAC;QAC5B,KAAK;KACN,EACD,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,CACzD,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,kDAAkD;QAC/D,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,SAAS;QACf,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -1,17 +1,28 @@
 import { z } from "zod";
-import type { PublicIdSchema, PublicIdSchemasOf } from "../ids.js";
-export declare const makeCreateRunContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
-    readonly description: "Create a run for selected flows in an environment.";
-    readonly input: z.ZodObject<{
+import type { PublicIdSchema } from "../ids.js";
+import { makeFlowSelectionSchema } from "./flowSelection.js";
+export { makeFlowSelectionSchema };
+export declare const makeCreateRunContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
+    environment: EnvironmentId;
+    flow: FlowId;
+    run: RunId;
+}) => {
+    readonly description: "Create a run for the selected flows and/or tags in an environment.";
+    readonly input: z.ZodIntersection<z.ZodObject<{
         environmentId: EnvironmentId;
         environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        flowIds: z.ZodArray<FlowId>;
         ignoreRules: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>;
+        pullRequestNumber: z.ZodOptional<z.ZodNumber>;
+        repository: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+        tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
     readonly kind: "write";
     readonly name: "run.create";
     readonly output: z.ZodObject<{
         runId: RunId;
+        url: z.ZodURL;
     }, z.core.$strip>;
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnE,eAAO,MAAM,qBAAqB,GAChC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;CAsBrD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,eAAO,MAAM,qBAAqB,GAChC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;CAyCA,CAAC"}

package/dist/v1/run/index.js

@@ -1,14 +1,33 @@
 import { z } from "zod";
+import { resource } from "../resource.js";
+import { makeFlowSelectionSchema } from "./flowSelection.js";
+export { makeFlowSelectionSchema };
 export const makeCreateRunContract = (ids) => {
-    const input = z.object({
+    const input = z
+        .object({
         environmentId: ids.environment,
         environmentVariables: z.record(z.string(), z.string()).optional(),
-        flowIds: z.array(ids.flow).min(1),
         ignoreRules: z.boolean().default(false),
-    });
-    const output = z.object({ runId: ids.run });
+        // Associate a pull request with the run by its number within a
+        // repository. A number requires a repository; a repository may be given
+        // on its own. The server resolves the internal pull request id,
+        // scoped to the caller's team.
+        pullRequestNumber: z
+            .number()
+            .int()
+            .positive()
+            .describe("The number of the pull request to associate with the run.")
+            .optional(),
+        repository: z
+            .string()
+            .min(1)
+            .describe('The owner/name of the repository, e.g. "acme/web".')
+            .optional(),
+    })
+        .and(makeFlowSelectionSchema(ids));
+    const output = resource({ runId: ids.run }, { urlFieldDescription: "Absolute URL of the run page." });
     return {
-        description: "Create a run for selected flows in an environment.",
+        description: "Create a run for the selected flows and/or tags in an environment.",
         input,
         kind: "write",
         name: "run.create",

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAKnC,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,WAAW;QAC9B,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACjE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACxC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAE5C,OAAO;QACL,WAAW,EAAE,oDAAoD;QACjE,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAInC,GAID,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC;SACZ,MAAM,CAAC;QACN,aAAa,EAAE,GAAG,CAAC,WAAW;QAC9B,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACjE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACvC,+DAA+D;QAC/D,wEAAwE;QACxE,gEAAgE;QAChE,+BAA+B;QAC/B,iBAAiB,EAAE,CAAC;aACjB,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;aACrE,QAAQ,EAAE;QACb,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,oDAAoD,CAAC;aAC9D,QAAQ,EAAE;KACd,CAAC;SACD,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CACrB,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,EAClB,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,CACzD,CAAC;IAEF,OAAO;QACL,WAAW,EACT,oEAAoE;QACtE,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeRunSummaryFields: <RunId extends PublicIdSchema>(ids: {
+    run: RunId;
+}) => {
+    completedAt: z.ZodOptional<z.ZodISODateTime>;
+    createdAt: z.ZodISODateTime;
+    git: z.ZodObject<{
+        branch: z.ZodOptional<z.ZodString>;
+        commitMessage: z.ZodOptional<z.ZodString>;
+        commitSha: z.ZodOptional<z.ZodString>;
+        commitUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    runId: RunId;
+    status: z.ZodEnum<{
+        running: "running";
+        canceled: "canceled";
+        queued: "queued";
+        passed: "passed";
+        failed: "failed";
+    }>;
+};
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;CA+BC,CAAC"}

package/dist/v1/run/summary.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+// 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.
+export const makeRunSummaryFields = (ids) => ({
+    completedAt: z.iso
+        .datetime()
+        .optional()
+        .describe("When the run finished executing. Absent while queued or running, and also absent for a terminal run that never completed execution (e.g. every flow was canceled or skipped)."),
+    createdAt: z.iso.datetime(),
+    git: z
+        .object({
+        branch: z.string().optional(),
+        commitMessage: z.string().optional(),
+        commitSha: z.string().optional(),
+        // This is `z.string()`, not `z.url()`. The value is stored commit data,
+        // and the endpoint validates its own output. One bad legacy commit URL
+        // would cause a 500 error for that run. A loose schema is safe now. A
+        // tighter schema later would be a breaking change.
+        commitUrl: z
+            .string()
+            .optional()
+            .describe("Link to the commit on the code host."),
+    })
+        .describe("The branch and commit under test. The fields are present when a deploy notification started the run, and absent for runs started another way, for example manually or with run.create."),
+    runId: ids.run,
+    status: z
+        .enum(["queued", "running", "passed", "failed", "canceled"])
+        .describe("Whole-run status. Terminal statuses are passed, failed, and canceled; poll until one is reached."),
+});
+//# sourceMappingURL=summary.js.map

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

@@ -0,0 +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,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,kGAAkG,CACnG;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+/**
+ * The shared tag resource. Tag names are the public handle; there is no
+ * public tag id.
+ */
+export declare const makeTagResourceSchema: () => z.ZodObject<{
+    color: z.ZodString;
+    name: z.ZodString;
+    url: z.ZodURL;
+}, z.core.$strip>;
+export declare const makeCreateTagContract: () => {
+    readonly description: "Create a tag on the caller's team. Tags select flows in run.create.";
+    readonly input: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "tag.create";
+    readonly output: z.ZodObject<{
+        color: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/tag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;iBAiB/B,CAAC;AAEJ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;CA6BjC,CAAC"}

package/dist/v1/tag/index.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+// tag.create returns this schema and the future tag.list returns rows of
+// it; one factory keeps the two shapes from drifting.
+/**
+ * The shared tag resource. Tag names are the public handle; there is no
+ * public tag id.
+ */
+export const makeTagResourceSchema = () => resource({
+    color: z
+        .string()
+        // Colors are system assigned from a fixed hex palette and the column
+        // has no user input path, so the output can promise the format.
+        .regex(/^#[0-9a-fA-F]{6}$/)
+        .describe("The tag's display color as a hex code, assigned by QA Wolf."),
+    name: z.string(),
+}, {
+    // Every tag on a team shares this URL: the app has no per-tag page.
+    urlFieldDescription: "Absolute URL of the team's tag settings page.",
+});
+export const makeCreateTagContract = () => {
+    const input = z.object({
+        name: z
+            .string()
+            .trim()
+            .min(1)
+            // The tags table stores the name in a varchar(255) column; a longer
+            // name must fail here, not as a database error.
+            .max(255)
+            .refine((name) => !name.includes(","), "Tag names cannot include commas."),
+    });
+    const output = makeTagResourceSchema();
+    return {
+        description: "Create a tag on the caller's team. Tags select flows in run.create.",
+        input,
+        kind: "write",
+        name: "tag.create",
+        output,
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/v1/tag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/tag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,yEAAyE;AACzE,sDAAsD;AACtD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE,CACxC,QAAQ,CACN;IACE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;QACT,qEAAqE;QACrE,gEAAgE;SAC/D,KAAK,CAAC,mBAAmB,CAAC;SAC1B,QAAQ,CACP,6DAA6D,CAC9D;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,EACD;IACE,oEAAoE;IACpE,mBAAmB,EAAE,+CAA+C;CACrE,CACF,CAAC;AAEJ,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE;IACxC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC;YACP,oEAAoE;YACpE,gDAAgD;aAC/C,GAAG,CAAC,GAAG,CAAC;aACR,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC7B,kCAAkC,CACnC;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IAEvC,OAAO;QACL,WAAW,EACT,qEAAqE;QACvE,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/api-contracts",
-  "version": "0.1.0",
+  "version": "0.11.0",
   "private": false,
   "description": "Versioned contracts for the QA Wolf public API",
   "repository": {
@@ -26,7 +26,7 @@
     "build": "rm -rf ./dist && tsc -p tsconfig.build.json",
     "lint:ci": "npm run lint:non-fixable; NON_FIXABLE_EXIT=$?; npm run lint:fixable && exit $NON_FIXABLE_EXIT",
     "lint:dev": "npm run lint:fixable",
-    "lint:fixable": "eslint . --ext cjs,cts,js,jsx,mjs,ts,tsx --fix --quiet && prettier --log-level=warn --write .",
+    "lint:fixable": "eslint . --fix --quiet && oxfmt --write .",
     "lint:non-fixable": "dpdm --exit-code circular:1 --no-tree --no-warning --transform --include='.*' --exclude='/(dist|node_modules)/' '**/*'",
     "prepublishOnly": "npm run build",
     "test": "NODE_OPTIONS=\"--experimental-vm-modules\" NODE_NO_WARNINGS=1 jest",
@@ -37,7 +37,7 @@
   },
   "devDependencies": {
     "@typescript/native-preview": "^7.0.0-dev.20260416.1",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "zod": "^4.1.11"
   },
   "peerDependencies": {