@qawolf/api-contracts 0.67.0 → 0.69.0

package/dist/v1/investigation/finding.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { issuePrioritySchema } from "../issue/index.js";
+export const investigationFindingStateDescription = 'What the investigation concluded about the cause. Known values: "investigating", "fixed", "fix-proposed", "reported", "report-proposed", "flake", "question" and "dismissed". New values can appear.';
+export const makeInvestigationFindingSchema = (ids) => z.object({
+    actual: z.string().optional(),
+    commitHash: z.string().optional(),
+    decidedBy: z
+        .enum(["agent", "user"])
+        .optional()
+        .describe("Who decided: the AI on its own, or a person who approved or dismissed it. Absent until someone decides."),
+    disputeReason: z
+        .string()
+        .optional()
+        .describe("Why a person disputed what the AI did. Present on a proposal the AI made again after that dispute."),
+    expected: z.string().optional(),
+    findingId: z.string(),
+    flowIds: z.array(ids.flow),
+    headline: z.string().optional(),
+    issueId: ids.issue.optional(),
+    kind: z
+        .string()
+        .describe('What the failure is. Known values: "maintenance", "bug", "flake" and "unknown". New values can appear.'),
+    matchReason: z.string().optional(),
+    priority: issuePrioritySchema.optional(),
+    question: z
+        .object({
+        answers: z.array(z.object({
+            description: z.string().optional(),
+            title: z.string(),
+            value: z
+                .string()
+                .describe('What choosing this answer means. Known values: "apply", "dismiss", "report", "maintenance" and "bug". New values can appear.'),
+        })),
+        text: z.string(),
+    })
+        .optional()
+        .describe("The question waiting for a person, with the answers offered."),
+    response: z
+        .object({
+        answer: z.string().optional(),
+        at: z.iso.datetime(),
+        reason: z.string().optional(),
+        type: z
+            .string()
+            .describe('Known values: "answer" and "dispute". New values can appear.'),
+    })
+        .optional()
+        .describe("A person's answer or dispute that the investigation hasn't acted on yet."),
+    state: z.string().describe(investigationFindingStateDescription),
+    steps: z.array(z.string()).optional(),
+    subSessionIds: z.array(ids.chatSession),
+    summary: z.string().optional(),
+    updatedAt: z.iso.datetime(),
+});
+//# sourceMappingURL=finding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finding.js","sourceRoot":"","sources":["../../../src/v1/investigation/finding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,CAAC,MAAM,oCAAoC,GAC/C,sMAAsM,CAAC;AAEzM,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAI5C,GAKD,EAAE,EAAE,CACH,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;SACvB,QAAQ,EAAE;SACV,QAAQ,CACP,yGAAyG,CAC1G;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,oGAAoG,CACrG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,wGAAwG,CACzG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CACP,8HAA8H,CAC/H;SACJ,CAAC,CACH;QACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,8DAA8D,CAC/D;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E,CAC3E;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAChE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC"}

package/dist/v1/investigation/findingInputFields.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const headline: z.ZodString;
+export declare const summary: z.ZodString;
+export declare const commitHash: z.ZodString;
+export declare const question: z.ZodString;
+export declare const bugReport: {
+    actual: z.ZodString;
+    expected: z.ZodString;
+    steps: z.ZodArray<z.ZodString>;
+};
+export declare const matchReason: z.ZodString;
+export declare const answerTitle: z.ZodString;
+export declare const answerDescription: z.ZodString;
+//# sourceMappingURL=findingInputFields.d.ts.map

package/dist/v1/investigation/findingInputFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findingInputFields.d.ts","sourceRoot":"","sources":["../../../src/v1/investigation/findingInputFields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,QAAQ,aAKoB,CAAC;AAE1C,eAAO,MAAM,OAAO,aAOjB,CAAC;AAEJ,eAAO,MAAM,UAAU,aAKpB,CAAC;AAEJ,eAAO,MAAM,QAAQ,aAKqC,CAAC;AAE3D,eAAO,MAAM,SAAS;;;;CAarB,CAAC;AAEF,eAAO,MAAM,WAAW,aAOrB,CAAC;AAEJ,eAAO,MAAM,WAAW,aAAmC,CAAC;AAE5D,eAAO,MAAM,iBAAiB,aAAoC,CAAC"}

package/dist/v1/investigation/findingInputFields.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export const headline = z
+    .string()
+    .trim()
+    .min(1)
+    .max(200)
+    .describe("One line naming the cause.");
+export const summary = z
+    .string()
+    .trim()
+    .min(1)
+    .max(2000)
+    .describe("What happened and what the AI did about it, in a short paragraph.");
+export const commitHash = z
+    .string()
+    .regex(/^[0-9a-f]{7,40}$/)
+    .describe("The commit with the fix: on the flow code branch once it is fixed, on the sub-session's branch while it is proposed.");
+export const question = z
+    .string()
+    .trim()
+    .min(1)
+    .max(300)
+    .describe("The question for a person, in one sentence.");
+export const bugReport = {
+    actual: z.string().trim().min(1).max(1000).describe("What the app did."),
+    expected: z
+        .string()
+        .trim()
+        .min(1)
+        .max(1000)
+        .describe("What the app should have done."),
+    steps: z
+        .array(z.string().trim().min(1).max(500))
+        .min(1)
+        .max(30)
+        .describe("The steps that reproduce the bug, in order."),
+};
+export const matchReason = z
+    .string()
+    .trim()
+    .min(1)
+    .max(500)
+    .describe("Why the flows belong to that already open report. Omit for a new report.");
+export const answerTitle = z.string().trim().min(1).max(80);
+export const answerDescription = z.string().trim().min(1).max(200);
+//# sourceMappingURL=findingInputFields.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findingInputFields.js","sourceRoot":"","sources":["../../../src/v1/investigation/findingInputFields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,QAAQ,CAAC,4BAA4B,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,IAAI,CAAC;KACT,QAAQ,CACP,mEAAmE,CACpE,CAAC;AAEJ,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,KAAK,CAAC,kBAAkB,CAAC;KACzB,QAAQ,CACP,sHAAsH,CACvH,CAAC;AAEJ,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACxE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,QAAQ,CACP,0EAA0E,CAC3E,CAAC;AAEJ,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeGetInvestigationContract: <ChatSessionId extends PublicIdSchema, FlowId extends PublicIdSchema, IssueId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
+    [key: string]: unknown;
+    chatSession: ChatSessionId;
+    flow: FlowId;
+    issue: IssueId;
+    run: RunId;
+}) => {
+    readonly annotations: {
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+        readonly readOnlyHint: true;
+    };
+    readonly description: string;
+    readonly input: z.ZodObject<{
+        runId: RunId;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "investigation.get";
+    readonly output: z.ZodObject<{
+        findings: z.ZodArray<z.ZodObject<{
+            actual: z.ZodOptional<z.ZodString>;
+            commitHash: z.ZodOptional<z.ZodString>;
+            decidedBy: z.ZodOptional<z.ZodEnum<{
+                user: "user";
+                agent: "agent";
+            }>>;
+            disputeReason: z.ZodOptional<z.ZodString>;
+            expected: z.ZodOptional<z.ZodString>;
+            findingId: z.ZodString;
+            flowIds: z.ZodArray<FlowId>;
+            headline: z.ZodOptional<z.ZodString>;
+            issueId: z.ZodOptional<IssueId>;
+            kind: z.ZodString;
+            matchReason: z.ZodOptional<z.ZodString>;
+            priority: z.ZodOptional<z.ZodEnum<{
+                unprioritized: "unprioritized";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                urgent: "urgent";
+            }>>;
+            question: z.ZodOptional<z.ZodObject<{
+                answers: z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    title: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$strip>>;
+                text: z.ZodString;
+            }, z.core.$strip>>;
+            response: z.ZodOptional<z.ZodObject<{
+                answer: z.ZodOptional<z.ZodString>;
+                at: z.ZodISODateTime;
+                reason: z.ZodOptional<z.ZodString>;
+                type: z.ZodString;
+            }, z.core.$strip>>;
+            state: z.ZodString;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            subSessionIds: z.ZodArray<ChatSessionId>;
+            summary: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        runId: RunId;
+        sessionId: z.ZodOptional<ChatSessionId>;
+        status: z.ZodEnum<{
+            investigating: "investigating";
+            finished: "finished";
+            "not-investigated": "not-investigated";
+        }>;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/v1/investigation/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,4BAA4B,GACvC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,OAAO,SAAS,cAAc,EAC9B,KAAK,SAAS,cAAc,EAC5B,KAAK;IACL,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCA,CAAC"}

package/dist/v1/investigation/get.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+import { makeInvestigationFindingSchema } from "./finding.js";
+export const makeGetInvestigationContract = (ids) => {
+    const input = z.object({ runId: ids.run });
+    const output = resource({
+        findings: z.array(makeInvestigationFindingSchema(ids)),
+        runId: ids.run,
+        sessionId: ids.chatSession
+            .optional()
+            .describe("The investigation session. Absent when the run has none."),
+        status: z
+            .enum(["investigating", "finished", "not-investigated"])
+            .describe('Whether the investigation session is still working. "not-investigated" when the run has no investigation.'),
+    }, { urlFieldDescription: "The run in the QA Wolf app." });
+    return {
+        annotations: {
+            destructiveHint: false,
+            openWorldHint: false,
+            readOnlyHint: true,
+        },
+        description: "Read what the QA Wolf AI investigating a run has concluded: one finding per cause of its failures, " +
+            "with the question waiting for a person and any answer or dispute the investigation hasn't acted on yet.",
+        input,
+        kind: "read",
+        name: "investigation.get",
+        output,
+    };
+};
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/v1/investigation/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAK1C,GAMD,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,QAAQ,CACrB;QACE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAC;QACtD,KAAK,EAAE,GAAG,CAAC,GAAG;QACd,SAAS,EAAE,GAAG,CAAC,WAAW;aACvB,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;QACvE,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,eAAe,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;aACvD,QAAQ,CACP,2GAA2G,CAC5G;KACJ,EACD,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,CACvD,CAAC;IAEF,OAAO;QACL,WAAW,EAAE;YACX,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,IAAI;SACnB;QACD,WAAW,EACT,qGAAqG;YACrG,yGAAyG;QAC3G,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,mBAAmB;QACzB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,219 @@
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeInvestigationContracts: <ChatSessionId extends PublicIdSchema, FlowId extends PublicIdSchema, IssueId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
+    [key: string]: unknown;
+    chatSession: ChatSessionId;
+    flow: FlowId;
+    issue: IssueId;
+    run: RunId;
+}) => {
+    get: {
+        readonly annotations: {
+            readonly destructiveHint: false;
+            readonly openWorldHint: false;
+            readonly readOnlyHint: true;
+        };
+        readonly description: string;
+        readonly input: import("zod").ZodObject<{
+            runId: RunId;
+        }, import("zod/v4/core").$strip>;
+        readonly kind: "read";
+        readonly name: "investigation.get";
+        readonly output: import("zod").ZodObject<{
+            findings: import("zod").ZodArray<import("zod").ZodObject<{
+                actual: import("zod").ZodOptional<import("zod").ZodString>;
+                commitHash: import("zod").ZodOptional<import("zod").ZodString>;
+                decidedBy: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    user: "user";
+                    agent: "agent";
+                }>>;
+                disputeReason: import("zod").ZodOptional<import("zod").ZodString>;
+                expected: import("zod").ZodOptional<import("zod").ZodString>;
+                findingId: import("zod").ZodString;
+                flowIds: import("zod").ZodArray<FlowId>;
+                headline: import("zod").ZodOptional<import("zod").ZodString>;
+                issueId: import("zod").ZodOptional<IssueId>;
+                kind: import("zod").ZodString;
+                matchReason: import("zod").ZodOptional<import("zod").ZodString>;
+                priority: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    unprioritized: "unprioritized";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    urgent: "urgent";
+                }>>;
+                question: import("zod").ZodOptional<import("zod").ZodObject<{
+                    answers: import("zod").ZodArray<import("zod").ZodObject<{
+                        description: import("zod").ZodOptional<import("zod").ZodString>;
+                        title: import("zod").ZodString;
+                        value: import("zod").ZodString;
+                    }, import("zod/v4/core").$strip>>;
+                    text: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>>;
+                response: import("zod").ZodOptional<import("zod").ZodObject<{
+                    answer: import("zod").ZodOptional<import("zod").ZodString>;
+                    at: import("zod").ZodISODateTime;
+                    reason: import("zod").ZodOptional<import("zod").ZodString>;
+                    type: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>>;
+                state: import("zod").ZodString;
+                steps: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                subSessionIds: import("zod").ZodArray<ChatSessionId>;
+                summary: import("zod").ZodOptional<import("zod").ZodString>;
+                updatedAt: import("zod").ZodISODateTime;
+            }, import("zod/v4/core").$strip>>;
+            runId: RunId;
+            sessionId: import("zod").ZodOptional<ChatSessionId>;
+            status: import("zod").ZodEnum<{
+                investigating: "investigating";
+                finished: "finished";
+                "not-investigated": "not-investigated";
+            }>;
+            url: import("zod").ZodURL;
+        }, import("zod/v4/core").$strip>;
+    };
+    recordFinding: {
+        readonly annotations: {
+            readonly destructiveHint: true;
+            readonly openWorldHint: false;
+            readonly readOnlyHint: false;
+        };
+        readonly description: string;
+        readonly input: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+            headline: import("zod").ZodOptional<import("zod").ZodString>;
+            state: import("zod").ZodLiteral<"investigating">;
+            summary: import("zod").ZodOptional<import("zod").ZodString>;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            commitHash: import("zod").ZodString;
+            headline: import("zod").ZodString;
+            state: import("zod").ZodLiteral<"fixed">;
+            summary: import("zod").ZodString;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            commitHash: import("zod").ZodString;
+            headline: import("zod").ZodString;
+            question: import("zod").ZodOptional<import("zod").ZodString>;
+            state: import("zod").ZodLiteral<"fix-proposed">;
+            summary: import("zod").ZodString;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            headline: import("zod").ZodString;
+            issueId: IssueId;
+            matchReason: import("zod").ZodOptional<import("zod").ZodString>;
+            state: import("zod").ZodLiteral<"reported">;
+            summary: import("zod").ZodString;
+            actual: import("zod").ZodString;
+            expected: import("zod").ZodString;
+            steps: import("zod").ZodArray<import("zod").ZodString>;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            headline: import("zod").ZodString;
+            issueId: import("zod").ZodOptional<IssueId>;
+            matchReason: import("zod").ZodOptional<import("zod").ZodString>;
+            priority: import("zod").ZodEnum<{
+                unprioritized: "unprioritized";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                urgent: "urgent";
+            }>;
+            question: import("zod").ZodOptional<import("zod").ZodString>;
+            state: import("zod").ZodLiteral<"report-proposed">;
+            summary: import("zod").ZodString;
+            actual: import("zod").ZodString;
+            expected: import("zod").ZodString;
+            steps: import("zod").ZodArray<import("zod").ZodString>;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            headline: import("zod").ZodString;
+            state: import("zod").ZodLiteral<"flake">;
+            summary: import("zod").ZodString;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            bugAnswer: import("zod").ZodString;
+            bugAnswerDescription: import("zod").ZodOptional<import("zod").ZodString>;
+            headline: import("zod").ZodString;
+            maintenanceAnswer: import("zod").ZodString;
+            maintenanceAnswerDescription: import("zod").ZodOptional<import("zod").ZodString>;
+            question: import("zod").ZodString;
+            state: import("zod").ZodLiteral<"question">;
+            summary: import("zod").ZodString;
+            findingId: import("zod").ZodString;
+            flowIds: import("zod").ZodArray<FlowId>;
+            runId: RunId;
+            sessionId: ChatSessionId;
+            subSessionIds: import("zod").ZodOptional<import("zod").ZodArray<ChatSessionId>>;
+        }, import("zod/v4/core").$strip>], "state">;
+        readonly kind: "write";
+        readonly name: "investigation.recordFinding";
+        readonly output: import("zod").ZodObject<{
+            finding: import("zod").ZodObject<{
+                actual: import("zod").ZodOptional<import("zod").ZodString>;
+                commitHash: import("zod").ZodOptional<import("zod").ZodString>;
+                decidedBy: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    user: "user";
+                    agent: "agent";
+                }>>;
+                disputeReason: import("zod").ZodOptional<import("zod").ZodString>;
+                expected: import("zod").ZodOptional<import("zod").ZodString>;
+                findingId: import("zod").ZodString;
+                flowIds: import("zod").ZodArray<FlowId>;
+                headline: import("zod").ZodOptional<import("zod").ZodString>;
+                issueId: import("zod").ZodOptional<IssueId>;
+                kind: import("zod").ZodString;
+                matchReason: import("zod").ZodOptional<import("zod").ZodString>;
+                priority: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    unprioritized: "unprioritized";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    urgent: "urgent";
+                }>>;
+                question: import("zod").ZodOptional<import("zod").ZodObject<{
+                    answers: import("zod").ZodArray<import("zod").ZodObject<{
+                        description: import("zod").ZodOptional<import("zod").ZodString>;
+                        title: import("zod").ZodString;
+                        value: import("zod").ZodString;
+                    }, import("zod/v4/core").$strip>>;
+                    text: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>>;
+                response: import("zod").ZodOptional<import("zod").ZodObject<{
+                    answer: import("zod").ZodOptional<import("zod").ZodString>;
+                    at: import("zod").ZodISODateTime;
+                    reason: import("zod").ZodOptional<import("zod").ZodString>;
+                    type: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>>;
+                state: import("zod").ZodString;
+                steps: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                subSessionIds: import("zod").ZodArray<ChatSessionId>;
+                summary: import("zod").ZodOptional<import("zod").ZodString>;
+                updatedAt: import("zod").ZodISODateTime;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/investigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,0BAA0B,GACrC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,OAAO,SAAS,cAAc,EAC9B,KAAK,SAAS,cAAc,EAC5B,KAAK;IACL,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGC,CAAC"}

package/dist/v1/investigation/index.js

@@ -0,0 +1,7 @@
+import { makeGetInvestigationContract } from "./get.js";
+import { makeRecordInvestigationFindingContract } from "./recordFinding.js";
+export const makeInvestigationContracts = (ids) => ({
+    get: makeGetInvestigationContract(ids),
+    recordFinding: makeRecordInvestigationFindingContract(ids),
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/investigation/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,sCAAsC,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAKxC,GAMD,EAAE,EAAE,CAAC,CAAC;IACL,GAAG,EAAE,4BAA4B,CAAC,GAAG,CAAC;IACtC,aAAa,EAAE,sCAAsC,CAAC,GAAG,CAAC;CAC3D,CAAC,CAAC"}

package/dist/v1/investigation/recordFinding.d.ts

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeRecordInvestigationFindingContract: <ChatSessionId extends PublicIdSchema, FlowId extends PublicIdSchema, IssueId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: {
+    [key: string]: unknown;
+    chatSession: ChatSessionId;
+    flow: FlowId;
+    issue: IssueId;
+    run: RunId;
+}) => {
+    readonly annotations: {
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+        readonly readOnlyHint: false;
+    };
+    readonly description: string;
+    readonly input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        headline: z.ZodOptional<z.ZodString>;
+        state: z.ZodLiteral<"investigating">;
+        summary: z.ZodOptional<z.ZodString>;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>, z.ZodObject<{
+        commitHash: z.ZodString;
+        headline: z.ZodString;
+        state: z.ZodLiteral<"fixed">;
+        summary: z.ZodString;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>, z.ZodObject<{
+        commitHash: z.ZodString;
+        headline: z.ZodString;
+        question: z.ZodOptional<z.ZodString>;
+        state: z.ZodLiteral<"fix-proposed">;
+        summary: z.ZodString;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>, z.ZodObject<{
+        headline: z.ZodString;
+        issueId: IssueId;
+        matchReason: z.ZodOptional<z.ZodString>;
+        state: z.ZodLiteral<"reported">;
+        summary: z.ZodString;
+        actual: z.ZodString;
+        expected: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>, z.ZodObject<{
+        headline: z.ZodString;
+        issueId: z.ZodOptional<IssueId>;
+        matchReason: z.ZodOptional<z.ZodString>;
+        priority: z.ZodEnum<{
+            unprioritized: "unprioritized";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            urgent: "urgent";
+        }>;
+        question: z.ZodOptional<z.ZodString>;
+        state: z.ZodLiteral<"report-proposed">;
+        summary: z.ZodString;
+        actual: z.ZodString;
+        expected: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>, z.ZodObject<{
+        headline: z.ZodString;
+        state: z.ZodLiteral<"flake">;
+        summary: z.ZodString;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>, z.ZodObject<{
+        bugAnswer: z.ZodString;
+        bugAnswerDescription: z.ZodOptional<z.ZodString>;
+        headline: z.ZodString;
+        maintenanceAnswer: z.ZodString;
+        maintenanceAnswerDescription: z.ZodOptional<z.ZodString>;
+        question: z.ZodString;
+        state: z.ZodLiteral<"question">;
+        summary: z.ZodString;
+        findingId: z.ZodString;
+        flowIds: z.ZodArray<FlowId>;
+        runId: RunId;
+        sessionId: ChatSessionId;
+        subSessionIds: z.ZodOptional<z.ZodArray<ChatSessionId>>;
+    }, z.core.$strip>], "state">;
+    readonly kind: "write";
+    readonly name: "investigation.recordFinding";
+    readonly output: z.ZodObject<{
+        finding: z.ZodObject<{
+            actual: z.ZodOptional<z.ZodString>;
+            commitHash: z.ZodOptional<z.ZodString>;
+            decidedBy: z.ZodOptional<z.ZodEnum<{
+                user: "user";
+                agent: "agent";
+            }>>;
+            disputeReason: z.ZodOptional<z.ZodString>;
+            expected: z.ZodOptional<z.ZodString>;
+            findingId: z.ZodString;
+            flowIds: z.ZodArray<FlowId>;
+            headline: z.ZodOptional<z.ZodString>;
+            issueId: z.ZodOptional<IssueId>;
+            kind: z.ZodString;
+            matchReason: z.ZodOptional<z.ZodString>;
+            priority: z.ZodOptional<z.ZodEnum<{
+                unprioritized: "unprioritized";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                urgent: "urgent";
+            }>>;
+            question: z.ZodOptional<z.ZodObject<{
+                answers: z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    title: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$strip>>;
+                text: z.ZodString;
+            }, z.core.$strip>>;
+            response: z.ZodOptional<z.ZodObject<{
+                answer: z.ZodOptional<z.ZodString>;
+                at: z.ZodISODateTime;
+                reason: z.ZodOptional<z.ZodString>;
+                type: z.ZodString;
+            }, z.core.$strip>>;
+            state: z.ZodString;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            subSessionIds: z.ZodArray<ChatSessionId>;
+            summary: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=recordFinding.d.ts.map

package/dist/v1/investigation/recordFinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordFinding.d.ts","sourceRoot":"","sources":["../../../src/v1/investigation/recordFinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAehD,eAAO,MAAM,sCAAsC,GACjD,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,OAAO,SAAS,cAAc,EAC9B,KAAK,SAAS,cAAc,EAC5B,KAAK;IACL,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkIA,CAAC"}