@claudexor/schema 1.0.0 → 2.0.0

package/dist/control-spec.d.ts

@@ -0,0 +1,592 @@
+import { z } from "zod";
+export declare const ControlSpecPriorDecision: z.ZodObject<{
+    question: z.ZodString;
+    answer: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    question: string;
+    answer: string;
+}, {
+    question: string;
+    answer: string;
+}>;
+export declare const ControlSpecQuestionsRequest: z.ZodObject<{
+    prompt: z.ZodString;
+    scope: z.ZodObject<{
+        kind: z.ZodLiteral<"project">;
+        root: z.ZodString;
+        context: z.ZodDefault<z.ZodEnum<["auto"]>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "project";
+        root: string;
+        context: "auto";
+    }, {
+        kind: "project";
+        root: string;
+        context?: "auto" | undefined;
+    }>;
+    harnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    n: z.ZodOptional<z.ZodNumber>;
+    effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>>;
+    paidBudget: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"unlimited">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "unlimited";
+    }, {
+        kind: "unlimited";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"finite">;
+        maxUsd: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        kind: "finite";
+        maxUsd: number;
+    }, {
+        kind: "finite";
+        maxUsd: number;
+    }>]>>;
+    web: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+    reviewerModels: z.ZodOptional<z.ZodRecord<z.ZodEnum<["openai", "anthropic", "google", "cursor", "opencode", "xai", "local", "unknown"]>, z.ZodString>>;
+    reviewerEfforts: z.ZodOptional<z.ZodRecord<z.ZodEnum<["openai", "anthropic", "google", "cursor", "opencode", "xai", "local", "unknown"]>, z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>>>;
+    reviewerPanel: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        harness: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>>;
+    }, "strict", z.ZodTypeAny, {
+        harness: string;
+        model?: string | undefined;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    }, {
+        harness: string;
+        model?: string | undefined;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    }>, "many">>;
+    priorDecisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        answer: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        question: string;
+        answer: string;
+    }, {
+        question: string;
+        answer: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    scope: {
+        kind: "project";
+        root: string;
+        context: "auto";
+    };
+    web?: "off" | "auto" | "cached" | "live" | undefined;
+    harnesses?: string[] | undefined;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    n?: number | undefined;
+    reviewerModels?: Partial<Record<"openai" | "anthropic" | "google" | "cursor" | "opencode" | "xai" | "local" | "unknown", string>> | undefined;
+    reviewerEfforts?: Partial<Record<"openai" | "anthropic" | "google" | "cursor" | "opencode" | "xai" | "local" | "unknown", "low" | "medium" | "high" | "xhigh" | "max">> | undefined;
+    paidBudget?: {
+        kind: "unlimited";
+    } | {
+        kind: "finite";
+        maxUsd: number;
+    } | undefined;
+    reviewerPanel?: {
+        harness: string;
+        model?: string | undefined;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    }[] | undefined;
+    priorDecisions?: {
+        question: string;
+        answer: string;
+    }[] | undefined;
+}, {
+    prompt: string;
+    scope: {
+        kind: "project";
+        root: string;
+        context?: "auto" | undefined;
+    };
+    web?: "off" | "auto" | "cached" | "live" | undefined;
+    harnesses?: string[] | undefined;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    n?: number | undefined;
+    reviewerModels?: Partial<Record<"openai" | "anthropic" | "google" | "cursor" | "opencode" | "xai" | "local" | "unknown", string>> | undefined;
+    reviewerEfforts?: Partial<Record<"openai" | "anthropic" | "google" | "cursor" | "opencode" | "xai" | "local" | "unknown", "low" | "medium" | "high" | "xhigh" | "max">> | undefined;
+    paidBudget?: {
+        kind: "unlimited";
+    } | {
+        kind: "finite";
+        maxUsd: number;
+    } | undefined;
+    reviewerPanel?: {
+        harness: string;
+        model?: string | undefined;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    }[] | undefined;
+    priorDecisions?: {
+        question: string;
+        answer: string;
+    }[] | undefined;
+}>;
+export type ControlSpecQuestionsRequest = z.infer<typeof ControlSpecQuestionsRequest>;
+export declare const ControlSpecAnswersRequest: z.ZodObject<{
+    answers: z.ZodArray<z.ZodObject<{
+        question_id: z.ZodString;
+        option_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        question_id: string;
+        text: string | null;
+        option_ids: string[];
+    }, {
+        question_id: string;
+        text?: string | null | undefined;
+        option_ids?: string[] | undefined;
+    }>, "many">;
+    priorDecisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        answer: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        question: string;
+        answer: string;
+    }, {
+        question: string;
+        answer: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    answers: {
+        question_id: string;
+        text: string | null;
+        option_ids: string[];
+    }[];
+    priorDecisions?: {
+        question: string;
+        answer: string;
+    }[] | undefined;
+}, {
+    answers: {
+        question_id: string;
+        text?: string | null | undefined;
+        option_ids?: string[] | undefined;
+    }[];
+    priorDecisions?: {
+        question: string;
+        answer: string;
+    }[] | undefined;
+}>;
+export type ControlSpecAnswersRequest = z.infer<typeof ControlSpecAnswersRequest>;
+export declare const ControlSpecSessionState: z.ZodEnum<["grounding", "questions", "answered", "freezing", "frozen", "cancelled", "failed", "interrupted_unknown"]>;
+export type ControlSpecSessionState = z.infer<typeof ControlSpecSessionState>;
+export declare const ControlSpecSession: z.ZodObject<{
+    sessionId: z.ZodString;
+    prompt: z.ZodString;
+    scope: z.ZodObject<{
+        kind: z.ZodLiteral<"project">;
+        root: z.ZodString;
+        context: z.ZodEnum<["auto"]>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "project";
+        root: string;
+        context: "auto";
+    }, {
+        kind: "project";
+        root: string;
+        context: "auto";
+    }>;
+    state: z.ZodEnum<["grounding", "questions", "answered", "freezing", "frozen", "cancelled", "failed", "interrupted_unknown"]>;
+    planRunId: z.ZodNullable<z.ZodString>;
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        tier: z.ZodDefault<z.ZodNumber>;
+        prompt: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<["single", "multi", "text"]>>;
+        options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            label: string;
+        }, {
+            id: string;
+            label: string;
+        }>, "many">>;
+        allow_text: z.ZodDefault<z.ZodBoolean>;
+        rationale: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            id: string;
+            label: string;
+        }[];
+        kind: "text" | "single" | "multi";
+        id: string;
+        prompt: string;
+        tier: number;
+        allow_text: boolean;
+        rationale?: string | undefined;
+    }, {
+        id: string;
+        prompt: string;
+        options?: {
+            id: string;
+            label: string;
+        }[] | undefined;
+        kind?: "text" | "single" | "multi" | undefined;
+        tier?: number | undefined;
+        allow_text?: boolean | undefined;
+        rationale?: string | undefined;
+    }>, "many">;
+    answers: z.ZodArray<z.ZodObject<{
+        question_id: z.ZodString;
+        option_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        question_id: string;
+        text: string | null;
+        option_ids: string[];
+    }, {
+        question_id: string;
+        text?: string | null | undefined;
+        option_ids?: string[] | undefined;
+    }>, "many">;
+    priorDecisions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        answer: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        question: string;
+        answer: string;
+    }, {
+        question: string;
+        answer: string;
+    }>, "many">;
+    specId: z.ZodNullable<z.ZodString>;
+    specDir: z.ZodNullable<z.ZodString>;
+    specPath: z.ZodNullable<z.ZodString>;
+    specHash: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+    createdAt: string;
+    prompt: string;
+    error: string | null;
+    questions: {
+        options: {
+            id: string;
+            label: string;
+        }[];
+        kind: "text" | "single" | "multi";
+        id: string;
+        prompt: string;
+        tier: number;
+        allow_text: boolean;
+        rationale?: string | undefined;
+    }[];
+    answers: {
+        question_id: string;
+        text: string | null;
+        option_ids: string[];
+    }[];
+    planRunId: string | null;
+    scope: {
+        kind: "project";
+        root: string;
+        context: "auto";
+    };
+    specPath: string | null;
+    specId: string | null;
+    specHash: string | null;
+    sessionId: string;
+    updatedAt: string;
+    priorDecisions: {
+        question: string;
+        answer: string;
+    }[];
+    specDir: string | null;
+}, {
+    state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+    createdAt: string;
+    prompt: string;
+    error: string | null;
+    questions: {
+        id: string;
+        prompt: string;
+        options?: {
+            id: string;
+            label: string;
+        }[] | undefined;
+        kind?: "text" | "single" | "multi" | undefined;
+        tier?: number | undefined;
+        allow_text?: boolean | undefined;
+        rationale?: string | undefined;
+    }[];
+    answers: {
+        question_id: string;
+        text?: string | null | undefined;
+        option_ids?: string[] | undefined;
+    }[];
+    planRunId: string | null;
+    scope: {
+        kind: "project";
+        root: string;
+        context: "auto";
+    };
+    specPath: string | null;
+    specId: string | null;
+    specHash: string | null;
+    sessionId: string;
+    updatedAt: string;
+    priorDecisions: {
+        question: string;
+        answer: string;
+    }[];
+    specDir: string | null;
+}>;
+export type ControlSpecSession = z.infer<typeof ControlSpecSession>;
+export declare const ControlSpecSessionListResponse: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        prompt: z.ZodString;
+        scope: z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            root: z.ZodString;
+            context: z.ZodEnum<["auto"]>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "project";
+            root: string;
+            context: "auto";
+        }, {
+            kind: "project";
+            root: string;
+            context: "auto";
+        }>;
+        state: z.ZodEnum<["grounding", "questions", "answered", "freezing", "frozen", "cancelled", "failed", "interrupted_unknown"]>;
+        planRunId: z.ZodNullable<z.ZodString>;
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            tier: z.ZodDefault<z.ZodNumber>;
+            prompt: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<["single", "multi", "text"]>>;
+            options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                label: string;
+            }, {
+                id: string;
+                label: string;
+            }>, "many">>;
+            allow_text: z.ZodDefault<z.ZodBoolean>;
+            rationale: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            options: {
+                id: string;
+                label: string;
+            }[];
+            kind: "text" | "single" | "multi";
+            id: string;
+            prompt: string;
+            tier: number;
+            allow_text: boolean;
+            rationale?: string | undefined;
+        }, {
+            id: string;
+            prompt: string;
+            options?: {
+                id: string;
+                label: string;
+            }[] | undefined;
+            kind?: "text" | "single" | "multi" | undefined;
+            tier?: number | undefined;
+            allow_text?: boolean | undefined;
+            rationale?: string | undefined;
+        }>, "many">;
+        answers: z.ZodArray<z.ZodObject<{
+            question_id: z.ZodString;
+            option_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            question_id: string;
+            text: string | null;
+            option_ids: string[];
+        }, {
+            question_id: string;
+            text?: string | null | undefined;
+            option_ids?: string[] | undefined;
+        }>, "many">;
+        priorDecisions: z.ZodArray<z.ZodObject<{
+            question: z.ZodString;
+            answer: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            question: string;
+            answer: string;
+        }, {
+            question: string;
+            answer: string;
+        }>, "many">;
+        specId: z.ZodNullable<z.ZodString>;
+        specDir: z.ZodNullable<z.ZodString>;
+        specPath: z.ZodNullable<z.ZodString>;
+        specHash: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+        createdAt: string;
+        prompt: string;
+        error: string | null;
+        questions: {
+            options: {
+                id: string;
+                label: string;
+            }[];
+            kind: "text" | "single" | "multi";
+            id: string;
+            prompt: string;
+            tier: number;
+            allow_text: boolean;
+            rationale?: string | undefined;
+        }[];
+        answers: {
+            question_id: string;
+            text: string | null;
+            option_ids: string[];
+        }[];
+        planRunId: string | null;
+        scope: {
+            kind: "project";
+            root: string;
+            context: "auto";
+        };
+        specPath: string | null;
+        specId: string | null;
+        specHash: string | null;
+        sessionId: string;
+        updatedAt: string;
+        priorDecisions: {
+            question: string;
+            answer: string;
+        }[];
+        specDir: string | null;
+    }, {
+        state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+        createdAt: string;
+        prompt: string;
+        error: string | null;
+        questions: {
+            id: string;
+            prompt: string;
+            options?: {
+                id: string;
+                label: string;
+            }[] | undefined;
+            kind?: "text" | "single" | "multi" | undefined;
+            tier?: number | undefined;
+            allow_text?: boolean | undefined;
+            rationale?: string | undefined;
+        }[];
+        answers: {
+            question_id: string;
+            text?: string | null | undefined;
+            option_ids?: string[] | undefined;
+        }[];
+        planRunId: string | null;
+        scope: {
+            kind: "project";
+            root: string;
+            context: "auto";
+        };
+        specPath: string | null;
+        specId: string | null;
+        specHash: string | null;
+        sessionId: string;
+        updatedAt: string;
+        priorDecisions: {
+            question: string;
+            answer: string;
+        }[];
+        specDir: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    sessions: {
+        state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+        createdAt: string;
+        prompt: string;
+        error: string | null;
+        questions: {
+            options: {
+                id: string;
+                label: string;
+            }[];
+            kind: "text" | "single" | "multi";
+            id: string;
+            prompt: string;
+            tier: number;
+            allow_text: boolean;
+            rationale?: string | undefined;
+        }[];
+        answers: {
+            question_id: string;
+            text: string | null;
+            option_ids: string[];
+        }[];
+        planRunId: string | null;
+        scope: {
+            kind: "project";
+            root: string;
+            context: "auto";
+        };
+        specPath: string | null;
+        specId: string | null;
+        specHash: string | null;
+        sessionId: string;
+        updatedAt: string;
+        priorDecisions: {
+            question: string;
+            answer: string;
+        }[];
+        specDir: string | null;
+    }[];
+}, {
+    sessions: {
+        state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+        createdAt: string;
+        prompt: string;
+        error: string | null;
+        questions: {
+            id: string;
+            prompt: string;
+            options?: {
+                id: string;
+                label: string;
+            }[] | undefined;
+            kind?: "text" | "single" | "multi" | undefined;
+            tier?: number | undefined;
+            allow_text?: boolean | undefined;
+            rationale?: string | undefined;
+        }[];
+        answers: {
+            question_id: string;
+            text?: string | null | undefined;
+            option_ids?: string[] | undefined;
+        }[];
+        planRunId: string | null;
+        scope: {
+            kind: "project";
+            root: string;
+            context: "auto";
+        };
+        specPath: string | null;
+        specId: string | null;
+        specHash: string | null;
+        sessionId: string;
+        updatedAt: string;
+        priorDecisions: {
+            question: string;
+            answer: string;
+        }[];
+        specDir: string | null;
+    }[];
+}>;
+export type ControlSpecSessionListResponse = z.infer<typeof ControlSpecSessionListResponse>;
+//# sourceMappingURL=control-spec.d.ts.map

package/dist/control-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-spec.d.ts","sourceRoot":"","sources":["../src/control-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,wBAAwB;;;;;;;;;EAK1B,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4B0B,CAAC;AACnE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMyB,CAAC;AAChE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF,eAAO,MAAM,uBAAuB,uHASlC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBsC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhC,CAAC;AACZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/control-spec.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { InterviewAnswer, InterviewQuestion } from "./spec.js";
+import { ExternalContextPolicy, NonBlankString, ProviderFamily } from "./primitives.js";
+import { EffortHint } from "./harness.js";
+import { ControlReviewerPanelEntry } from "./control.js";
+import { RunScopeContext } from "./control-run-scope.js";
+import { PaidBudget } from "./budget.js";
+export const ControlSpecPriorDecision = z
+    .object({
+    question: z.string().describe("Question asked in a prior tier."),
+    answer: z.string().describe("The user's answer."),
+})
+    .strict();
+export const ControlSpecQuestionsRequest = z
+    .object({
+    prompt: z.string().min(1).describe("The user's request the interview is clarifying."),
+    scope: z
+        .object({
+        kind: z.literal("project"),
+        root: z.string().describe("Absolute path of the project root."),
+        context: RunScopeContext.default("auto"),
+    })
+        .strict()
+        .describe("Project the spec is about."),
+    harnesses: z
+        .array(NonBlankString)
+        .optional()
+        .describe("Harnesses eligible to generate the questions."),
+    n: z.number().int().positive().optional(),
+    effort: EffortHint.optional(),
+    paidBudget: PaidBudget.optional(),
+    web: ExternalContextPolicy.optional(),
+    reviewerModels: z.record(ProviderFamily, NonBlankString).optional(),
+    reviewerEfforts: z.record(ProviderFamily, EffortHint).optional(),
+    reviewerPanel: z.array(ControlReviewerPanelEntry).min(1).optional(),
+    priorDecisions: z
+        .array(ControlSpecPriorDecision)
+        .optional()
+        .describe("Prior-tier decisions carried into the next interview tier."),
+})
+    .strict()
+    .describe("Request to create a durable spec interview session.");
+export const ControlSpecAnswersRequest = z
+    .object({
+    answers: z.array(InterviewAnswer).describe("Answers for the current interview tier."),
+    priorDecisions: z.array(ControlSpecPriorDecision).optional(),
+})
+    .strict()
+    .describe("Answers recorded against a durable spec session.");
+export const ControlSpecSessionState = z.enum([
+    "grounding",
+    "questions",
+    "answered",
+    "freezing",
+    "frozen",
+    "cancelled",
+    "failed",
+    "interrupted_unknown",
+]);
+export const ControlSpecSession = z
+    .object({
+    sessionId: NonBlankString,
+    prompt: z.string(),
+    scope: z
+        .object({ kind: z.literal("project"), root: z.string(), context: RunScopeContext })
+        .strict(),
+    state: ControlSpecSessionState,
+    planRunId: z.string().nullable(),
+    questions: z.array(InterviewQuestion),
+    answers: z.array(InterviewAnswer),
+    priorDecisions: z.array(ControlSpecPriorDecision),
+    specId: z.string().nullable(),
+    specDir: z.string().nullable(),
+    specPath: z.string().nullable(),
+    specHash: z.string().nullable(),
+    error: z.string().nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+})
+    .strict()
+    .describe("Durable public projection of a spec interview session.");
+export const ControlSpecSessionListResponse = z
+    .object({ sessions: z.array(ControlSpecSession) })
+    .strict();
+//# sourceMappingURL=control-spec.js.map

package/dist/control-spec.js.map

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