@claudexor/schema 1.0.0

package/dist/control-run-detail.d.ts

@@ -0,0 +1,1686 @@
+import { z } from "zod";
+/** Per-candidate evidence card for a race run (projected from
+ * attempts/<id>/attempt.yaml + reviews/<id>.yaml + the decision winner).
+ * The macOS Candidates tab renders these; SSE freshness rides the client's
+ * existing refresh-on-event. */
+export declare const ControlCandidate: z.ZodObject<{
+    attemptId: z.ZodString;
+    harnessId: z.ZodString;
+    label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    costUsd: z.ZodDefault<z.ZodNumber>;
+    costEstimated: z.ZodDefault<z.ZodBoolean>;
+    errored: z.ZodDefault<z.ZodBoolean>;
+    gatesPassed: z.ZodDefault<z.ZodNumber>;
+    gatesTotal: z.ZodDefault<z.ZodNumber>;
+    /** Blocking review findings count (accepted blockers). */
+    blockers: z.ZodDefault<z.ZodNumber>;
+    reviewVerified: z.ZodDefault<z.ZodBoolean>;
+    finalReviewClean: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+    winner: z.ZodDefault<z.ZodBoolean>;
+    diffstat: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        files: z.ZodDefault<z.ZodNumber>;
+        additions: z.ZodDefault<z.ZodNumber>;
+        deletions: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        files: number;
+        additions: number;
+        deletions: number;
+    }, {
+        files?: number | undefined;
+        additions?: number | undefined;
+        deletions?: number | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    label: string | null;
+    winner: boolean;
+    harnessId: string;
+    attemptId: string;
+    blockers: number;
+    costUsd: number;
+    costEstimated: boolean;
+    errored: boolean;
+    gatesPassed: number;
+    gatesTotal: number;
+    reviewVerified: boolean;
+    finalReviewClean: boolean | null;
+    diffstat: {
+        files: number;
+        additions: number;
+        deletions: number;
+    } | null;
+}, {
+    harnessId: string;
+    attemptId: string;
+    label?: string | null | undefined;
+    winner?: boolean | undefined;
+    blockers?: number | undefined;
+    costUsd?: number | undefined;
+    costEstimated?: boolean | undefined;
+    errored?: boolean | undefined;
+    gatesPassed?: number | undefined;
+    gatesTotal?: number | undefined;
+    reviewVerified?: boolean | undefined;
+    finalReviewClean?: boolean | null | undefined;
+    diffstat?: {
+        files?: number | undefined;
+        additions?: number | undefined;
+        deletions?: number | undefined;
+    } | null | undefined;
+}>;
+export type ControlCandidate = z.infer<typeof ControlCandidate>;
+export declare const ControlRunDetail: z.ZodObject<{
+    summary: z.ZodObject<{
+        jobId: z.ZodString;
+        runId: z.ZodString;
+        taskId: z.ZodOptional<z.ZodString>;
+        state: z.ZodEnum<["queued", "running", "blocked", "succeeded", "no_op", "ungated", "review_not_run", "failed", "cancelled", "interrupted", "exhausted", "not_converged", "stuck_no_progress"]>;
+        runDir: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        failure: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            phase: z.ZodDefault<z.ZodString>;
+            category: z.ZodDefault<z.ZodEnum<["validation", "project", "auth", "harness_unavailable", "harness_error", "budget", "policy", "cancelled", "internal", "unknown"]>>;
+            harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            attemptId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            safeMessage: z.ZodString;
+            rawDetailRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            logRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            eventRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            runDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            nextActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            runDir: string | null;
+            category: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal";
+            phase: string;
+            harnessId: string | null;
+            attemptId: string | null;
+            safeMessage: string;
+            rawDetailRef: string | null;
+            logRefs: string[];
+            eventRefs: string[];
+            nextActions: string[];
+        }, {
+            safeMessage: string;
+            runDir?: string | null | undefined;
+            category?: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal" | undefined;
+            phase?: string | undefined;
+            harnessId?: string | null | undefined;
+            attemptId?: string | null | undefined;
+            rawDetailRef?: string | null | undefined;
+            logRefs?: string[] | undefined;
+            eventRefs?: string[] | undefined;
+            nextActions?: string[] | undefined;
+        }>>>;
+        project: z.ZodDefault<z.ZodObject<{
+            kind: z.ZodDefault<z.ZodEnum<["project", "none"]>>;
+            root: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            projectName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            context: z.ZodDefault<z.ZodEnum<["off", "auto"]>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "none" | "project";
+            root: string | null;
+            context: "off" | "auto";
+            projectName: string | null;
+        }, {
+            kind?: "none" | "project" | undefined;
+            root?: string | null | undefined;
+            context?: "off" | "auto" | undefined;
+            projectName?: string | null | undefined;
+        }>>;
+        mode: z.ZodOptional<z.ZodEnum<["ask", "plan", "audit", "agent", "orchestrate"]>>;
+        strategy: z.ZodOptional<z.ZodNullable<z.ZodEnum<["race", "attempts", "until_clean", "swarm", "create"]>>>;
+        prompt: z.ZodOptional<z.ZodString>;
+        harnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        primaryHarness: z.ZodOptional<z.ZodString>;
+        portfolio: z.ZodOptional<z.ZodEnum<["daily-rich", "balanced", "cheapest", "strongest", "burn", "subscription-first", "api-overflow", "conserve-claude", "conserve-codex"]>>;
+        model: z.ZodOptional<z.ZodString>;
+        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;
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            model?: string | undefined;
+        }, {
+            harness: string;
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            model?: string | undefined;
+        }>, "many">>;
+        protectedPathApprovals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            reason?: string | undefined;
+        }, {
+            path: string;
+            reason?: string | undefined;
+        }>, "many">>;
+        n: z.ZodOptional<z.ZodNumber>;
+        maxUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        spendUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        spendEstimated: z.ZodOptional<z.ZodBoolean>;
+        access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
+        requestedAccess: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
+        effectiveAccess: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
+        externalContextPolicy: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+        webRequired: z.ZodOptional<z.ZodBoolean>;
+        webMode: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+        webEvidence: z.ZodDefault<z.ZodObject<{
+            required: z.ZodDefault<z.ZodBoolean>;
+            mode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+            effectiveMode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+            attempted: z.ZodDefault<z.ZodBoolean>;
+            satisfied: z.ZodDefault<z.ZodBoolean>;
+            status: z.ZodDefault<z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>>;
+            tool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            errorSummary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            rawDetailRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            available: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            target: string | null;
+            tool: string | null;
+            mode: "off" | "auto" | "cached" | "live";
+            required: boolean;
+            attempted: boolean;
+            rawDetailRef: string | null;
+            effectiveMode: "off" | "auto" | "cached" | "live";
+            satisfied: boolean;
+            errorSummary: string | null;
+            available: boolean;
+        }, {
+            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+            target?: string | null | undefined;
+            tool?: string | null | undefined;
+            mode?: "off" | "auto" | "cached" | "live" | undefined;
+            required?: boolean | undefined;
+            attempted?: boolean | undefined;
+            rawDetailRef?: string | null | undefined;
+            effectiveMode?: "off" | "auto" | "cached" | "live" | undefined;
+            satisfied?: boolean | undefined;
+            errorSummary?: string | null | undefined;
+            available?: boolean | undefined;
+        }>>;
+        toolPermissionPolicy: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        outputReadyState: z.ZodDefault<z.ZodEnum<["pending", "finalizing", "ready", "diagnostic"]>>;
+        toolWarningsTotal: z.ZodDefault<z.ZodNumber>;
+        result: z.ZodDefault<z.ZodObject<{
+            kind: z.ZodDefault<z.ZodEnum<["patch", "answer", "plan", "report", "none"]>>;
+            diffStat: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                files: z.ZodNumber;
+                additions: z.ZodNumber;
+                deletions: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                files: number;
+                additions: number;
+                deletions: number;
+            }, {
+                files: number;
+                additions: number;
+                deletions: number;
+            }>>>;
+            blockers: z.ZodDefault<z.ZodNumber>;
+            adopted: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+            applyState: z.ZodDefault<z.ZodEnum<["not_applied", "applied", "applied_review_blocked", "reverted"]>>;
+            preTurnSha: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            postTurnSha: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            revertable: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "plan" | "none" | "patch" | "report" | "answer";
+            diffStat: {
+                files: number;
+                additions: number;
+                deletions: number;
+            } | null;
+            blockers: number;
+            adopted: boolean | null;
+            applyState: "not_applied" | "applied" | "applied_review_blocked" | "reverted";
+            preTurnSha: string | null;
+            postTurnSha: string | null;
+            revertable: boolean;
+        }, {
+            kind?: "plan" | "none" | "patch" | "report" | "answer" | undefined;
+            diffStat?: {
+                files: number;
+                additions: number;
+                deletions: number;
+            } | null | undefined;
+            blockers?: number | undefined;
+            adopted?: boolean | null | undefined;
+            applyState?: "not_applied" | "applied" | "applied_review_blocked" | "reverted" | undefined;
+            preTurnSha?: string | null | undefined;
+            postTurnSha?: string | null | undefined;
+            revertable?: boolean | undefined;
+        }>>;
+        waitingOnUser: z.ZodDefault<z.ZodBoolean>;
+        route: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            requestedModel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            observedModel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            verified: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            verified: boolean;
+            harnessId: string | null;
+            requestedModel: string | null;
+            observedModel: string | null;
+        }, {
+            verified?: boolean | undefined;
+            harnessId?: string | null | undefined;
+            requestedModel?: string | null | undefined;
+            observedModel?: string | null | undefined;
+        }>>>;
+        tests: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        specId: z.ZodOptional<z.ZodString>;
+        specHash: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        state: "cancelled" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted" | "running" | "queued" | "succeeded" | "interrupted";
+        runId: string;
+        project: {
+            kind: "none" | "project";
+            root: string | null;
+            context: "off" | "auto";
+            projectName: string | null;
+        };
+        jobId: string;
+        failure: {
+            runDir: string | null;
+            category: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal";
+            phase: string;
+            harnessId: string | null;
+            attemptId: string | null;
+            safeMessage: string;
+            rawDetailRef: string | null;
+            logRefs: string[];
+            eventRefs: string[];
+            nextActions: string[];
+        } | null;
+        webEvidence: {
+            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            target: string | null;
+            tool: string | null;
+            mode: "off" | "auto" | "cached" | "live";
+            required: boolean;
+            attempted: boolean;
+            rawDetailRef: string | null;
+            effectiveMode: "off" | "auto" | "cached" | "live";
+            satisfied: boolean;
+            errorSummary: string | null;
+            available: boolean;
+        };
+        outputReadyState: "pending" | "finalizing" | "ready" | "diagnostic";
+        toolWarningsTotal: number;
+        result: {
+            kind: "plan" | "none" | "patch" | "report" | "answer";
+            diffStat: {
+                files: number;
+                additions: number;
+                deletions: number;
+            } | null;
+            blockers: number;
+            adopted: boolean | null;
+            applyState: "not_applied" | "applied" | "applied_review_blocked" | "reverted";
+            preTurnSha: string | null;
+            postTurnSha: string | null;
+            revertable: boolean;
+        };
+        waitingOnUser: boolean;
+        route: {
+            verified: boolean;
+            harnessId: string | null;
+            requestedModel: string | null;
+            observedModel: string | null;
+        } | null;
+        prompt?: string | undefined;
+        access?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        error?: string | undefined;
+        mode?: "ask" | "plan" | "audit" | "agent" | "orchestrate" | undefined;
+        harnesses?: string[] | undefined;
+        runDir?: string | undefined;
+        tests?: string[] | undefined;
+        portfolio?: "daily-rich" | "balanced" | "cheapest" | "strongest" | "burn" | "subscription-first" | "api-overflow" | "conserve-claude" | "conserve-codex" | undefined;
+        n?: number | undefined;
+        model?: string | undefined;
+        primaryHarness?: string | undefined;
+        maxUsd?: number | null | undefined;
+        externalContextPolicy?: "off" | "auto" | "cached" | "live" | undefined;
+        protectedPathApprovals?: {
+            path: string;
+            reason?: string | undefined;
+        }[] | undefined;
+        specId?: string | undefined;
+        specHash?: string | undefined;
+        reviewerPanel?: {
+            harness: string;
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            model?: string | undefined;
+        }[] | undefined;
+        createdAt?: string | undefined;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        taskId?: string | undefined;
+        strategy?: "race" | "attempts" | "swarm" | "create" | "until_clean" | null | undefined;
+        spendUsd?: number | null | undefined;
+        spendEstimated?: boolean | undefined;
+        requestedAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        effectiveAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        webRequired?: boolean | undefined;
+        webMode?: "off" | "auto" | "cached" | "live" | undefined;
+        toolPermissionPolicy?: Record<string, unknown> | undefined;
+    }, {
+        state: "cancelled" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted" | "running" | "queued" | "succeeded" | "interrupted";
+        runId: string;
+        jobId: string;
+        prompt?: string | undefined;
+        access?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        error?: string | undefined;
+        mode?: "ask" | "plan" | "audit" | "agent" | "orchestrate" | undefined;
+        harnesses?: string[] | undefined;
+        runDir?: string | undefined;
+        tests?: string[] | undefined;
+        portfolio?: "daily-rich" | "balanced" | "cheapest" | "strongest" | "burn" | "subscription-first" | "api-overflow" | "conserve-claude" | "conserve-codex" | undefined;
+        project?: {
+            kind?: "none" | "project" | undefined;
+            root?: string | null | undefined;
+            context?: "off" | "auto" | undefined;
+            projectName?: string | null | undefined;
+        } | undefined;
+        n?: number | undefined;
+        model?: string | undefined;
+        primaryHarness?: string | undefined;
+        maxUsd?: number | null | undefined;
+        externalContextPolicy?: "off" | "auto" | "cached" | "live" | undefined;
+        protectedPathApprovals?: {
+            path: string;
+            reason?: string | undefined;
+        }[] | undefined;
+        specId?: string | undefined;
+        specHash?: string | undefined;
+        reviewerPanel?: {
+            harness: string;
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            model?: string | undefined;
+        }[] | undefined;
+        createdAt?: string | undefined;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        taskId?: string | undefined;
+        failure?: {
+            safeMessage: string;
+            runDir?: string | null | undefined;
+            category?: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal" | undefined;
+            phase?: string | undefined;
+            harnessId?: string | null | undefined;
+            attemptId?: string | null | undefined;
+            rawDetailRef?: string | null | undefined;
+            logRefs?: string[] | undefined;
+            eventRefs?: string[] | undefined;
+            nextActions?: string[] | undefined;
+        } | null | undefined;
+        strategy?: "race" | "attempts" | "swarm" | "create" | "until_clean" | null | undefined;
+        spendUsd?: number | null | undefined;
+        spendEstimated?: boolean | undefined;
+        requestedAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        effectiveAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        webRequired?: boolean | undefined;
+        webMode?: "off" | "auto" | "cached" | "live" | undefined;
+        webEvidence?: {
+            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+            target?: string | null | undefined;
+            tool?: string | null | undefined;
+            mode?: "off" | "auto" | "cached" | "live" | undefined;
+            required?: boolean | undefined;
+            attempted?: boolean | undefined;
+            rawDetailRef?: string | null | undefined;
+            effectiveMode?: "off" | "auto" | "cached" | "live" | undefined;
+            satisfied?: boolean | undefined;
+            errorSummary?: string | null | undefined;
+            available?: boolean | undefined;
+        } | undefined;
+        toolPermissionPolicy?: Record<string, unknown> | undefined;
+        outputReadyState?: "pending" | "finalizing" | "ready" | "diagnostic" | undefined;
+        toolWarningsTotal?: number | undefined;
+        result?: {
+            kind?: "plan" | "none" | "patch" | "report" | "answer" | undefined;
+            diffStat?: {
+                files: number;
+                additions: number;
+                deletions: number;
+            } | null | undefined;
+            blockers?: number | undefined;
+            adopted?: boolean | null | undefined;
+            applyState?: "not_applied" | "applied" | "applied_review_blocked" | "reverted" | undefined;
+            preTurnSha?: string | null | undefined;
+            postTurnSha?: string | null | undefined;
+            revertable?: boolean | undefined;
+        } | undefined;
+        waitingOnUser?: boolean | undefined;
+        route?: {
+            verified?: boolean | undefined;
+            harnessId?: string | null | undefined;
+            requestedModel?: string | null | undefined;
+            observedModel?: string | null | undefined;
+        } | null | undefined;
+    }>;
+    /**
+     * Highest event seq included in this snapshot. Clients subscribe to the
+     * event stream from this cursor; events with seq <= lastSeq are already
+     * reflected in the snapshot (snapshot-then-subscribe, no gaps, no dupes).
+     */
+    lastSeq: z.ZodDefault<z.ZodNumber>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<["file", "directory"]>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        mime: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "file" | "directory";
+        mime?: string | undefined;
+        bytes?: number | undefined;
+    }, {
+        path: string;
+        kind: "file" | "directory";
+        mime?: string | undefined;
+        bytes?: number | undefined;
+    }>, "many">>;
+    primaryOutput: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<["answer", "report", "plan", "summary", "patch", "diagnostic"]>;
+        path: z.ZodString;
+        text: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "diagnostic" | "plan" | "summary" | "patch" | "report" | "answer";
+        text: string | null;
+        bytes?: number | undefined;
+    }, {
+        path: string;
+        kind: "diagnostic" | "plan" | "summary" | "patch" | "report" | "answer";
+        text?: string | null | undefined;
+        bytes?: number | undefined;
+    }>>>;
+    timeline: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        ts: z.ZodOptional<z.ZodString>;
+        harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        attemptId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        title: z.ZodString;
+        detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodEnum<["info", "warning", "error"]>>;
+        toolName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        errorSummary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        rawRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        detail: string | null;
+        target: string | null;
+        title: string;
+        severity: "error" | "info" | "warning";
+        harnessId: string | null;
+        attemptId: string | null;
+        errorSummary: string | null;
+        toolName: string | null;
+        rawRef: string | null;
+        ts?: string | undefined;
+    }, {
+        type: string;
+        title: string;
+        detail?: string | null | undefined;
+        target?: string | null | undefined;
+        ts?: string | undefined;
+        severity?: "error" | "info" | "warning" | undefined;
+        harnessId?: string | null | undefined;
+        attemptId?: string | null | undefined;
+        errorSummary?: string | null | undefined;
+        toolName?: string | null | undefined;
+        rawRef?: string | null | undefined;
+    }>, "many">>;
+    budget: z.ZodDefault<z.ZodObject<{
+        maxUsd: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        spendUsd: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        remainingUsd: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        estimated: z.ZodDefault<z.ZodBoolean>;
+        source: z.ZodDefault<z.ZodEnum<["decision", "events", "settings", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        source: "unknown" | "decision" | "events" | "settings";
+        estimated: boolean;
+        maxUsd: number | null;
+        spendUsd: number | null;
+        remainingUsd: number | null;
+    }, {
+        source?: "unknown" | "decision" | "events" | "settings" | undefined;
+        estimated?: boolean | undefined;
+        maxUsd?: number | null | undefined;
+        spendUsd?: number | null | undefined;
+        remainingUsd?: number | null | undefined;
+    }>>;
+    finalSummary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    decision: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        winner: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<["success", "no_op", "ungated", "review_not_run", "blocked", "not_converged", "stuck_no_progress", "failed", "exhausted", "cancelled"]>;
+        outcome: z.ZodDefault<z.ZodEnum<["ready", "no_op", "ungated", "review_not_run", "blocked"]>>;
+        why_winner: z.ZodDefault<z.ZodString>;
+        why_not_others: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        accepted_risks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        final_checks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidence_facts: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        budget_summary: z.ZodDefault<z.ZodObject<{
+            spend_usd: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            estimated: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            estimated: boolean;
+            spend_usd: number | null;
+        }, {
+            estimated?: boolean | undefined;
+            spend_usd?: number | null | undefined;
+        }>>;
+        apply_recommendation: z.ZodDefault<z.ZodEnum<["apply", "inspect", "continue", "split_task", "human_review"]>>;
+        verification_basis: z.ZodDefault<z.ZodEnum<["none", "cross_family_review", "both"]>>;
+        final_verify: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            attempted: z.ZodBoolean;
+            base_sha: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            applied_cleanly: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+            gates_passed: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+            gates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                status: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: string;
+                id: string;
+            }, {
+                status: string;
+                id: string;
+            }>, "many">>;
+            duration_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            duration_ms: number | null;
+            base_sha: string | null;
+            reason: string | null;
+            attempted: boolean;
+            applied_cleanly: boolean | null;
+            gates_passed: boolean | null;
+            gates: {
+                status: string;
+                id: string;
+            }[];
+        }, {
+            attempted: boolean;
+            duration_ms?: number | null | undefined;
+            base_sha?: string | null | undefined;
+            reason?: string | null | undefined;
+            applied_cleanly?: boolean | null | undefined;
+            gates_passed?: boolean | null | undefined;
+            gates?: {
+                status: string;
+                id: string;
+            }[] | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "cancelled" | "success" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted";
+        winner: string | null;
+        outcome: "ready" | "no_op" | "ungated" | "review_not_run" | "blocked";
+        why_winner: string;
+        why_not_others: Record<string, string>;
+        accepted_risks: string[];
+        final_checks: string[];
+        evidence_facts: string[];
+        budget_summary: {
+            estimated: boolean;
+            spend_usd: number | null;
+        };
+        apply_recommendation: "apply" | "inspect" | "continue" | "split_task" | "human_review";
+        verification_basis: "none" | "cross_family_review" | "both";
+        final_verify: {
+            duration_ms: number | null;
+            base_sha: string | null;
+            reason: string | null;
+            attempted: boolean;
+            applied_cleanly: boolean | null;
+            gates_passed: boolean | null;
+            gates: {
+                status: string;
+                id: string;
+            }[];
+        } | null;
+    }, {
+        status: "cancelled" | "success" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted";
+        winner: string | null;
+        outcome?: "ready" | "no_op" | "ungated" | "review_not_run" | "blocked" | undefined;
+        why_winner?: string | undefined;
+        why_not_others?: Record<string, string> | undefined;
+        accepted_risks?: string[] | undefined;
+        final_checks?: string[] | undefined;
+        evidence_facts?: string[] | undefined;
+        budget_summary?: {
+            estimated?: boolean | undefined;
+            spend_usd?: number | null | undefined;
+        } | undefined;
+        apply_recommendation?: "apply" | "inspect" | "continue" | "split_task" | "human_review" | undefined;
+        verification_basis?: "none" | "cross_family_review" | "both" | undefined;
+        final_verify?: {
+            attempted: boolean;
+            duration_ms?: number | null | undefined;
+            base_sha?: string | null | undefined;
+            reason?: string | null | undefined;
+            applied_cleanly?: boolean | null | undefined;
+            gates_passed?: boolean | null | undefined;
+            gates?: {
+                status: string;
+                id: string;
+            }[] | undefined;
+        } | null | undefined;
+    }>>>;
+    /** Persisted operator unblock decision (accept_risk/override), hash-bound; server-owned apply affordance. */
+    operatorDecision: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        action: z.ZodString;
+        decidedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        action: string;
+        decidedAt: string | null;
+    }, {
+        action: string;
+        decidedAt?: string | null | undefined;
+    }>>>;
+    workProduct: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["patch", "new_repo", "report"]>;
+        source_task_id: z.ZodString;
+        producer_attempt_id: z.ZodOptional<z.ZodString>;
+        evidence_dir: z.ZodOptional<z.ZodString>;
+        files: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        meta: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "patch" | "new_repo" | "report";
+        files: Record<string, string>;
+        source_task_id: string;
+        meta: Record<string, unknown>;
+        producer_attempt_id?: string | undefined;
+        evidence_dir?: string | undefined;
+    }, {
+        id: string;
+        kind: "patch" | "new_repo" | "report";
+        source_task_id: string;
+        files?: Record<string, string> | undefined;
+        producer_attempt_id?: string | undefined;
+        evidence_dir?: string | undefined;
+        meta?: Record<string, unknown> | undefined;
+    }>>>;
+    /** Derived apply-gate verdict (single producer: the delivery gate); null when the run has no patch artifact. */
+    applyEligibility: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        eligible: z.ZodBoolean;
+        state: z.ZodNullable<z.ZodString>;
+        reason: z.ZodNullable<z.ZodString>;
+        requiredAction: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        state: string | null;
+        reason: string | null;
+        eligible: boolean;
+        requiredAction: string | null;
+    }, {
+        state: string | null;
+        reason: string | null;
+        eligible: boolean;
+        requiredAction: string | null;
+    }>>>;
+    reviewFindings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        severity: z.ZodEnum<["BLOCK", "FIX_FIRST", "WARN", "NIT", "OUT_OF_SCOPE", "INSUFFICIENT_EVIDENCE", "NEEDS_HUMAN"]>;
+        category: z.ZodEnum<["correctness", "regression", "security", "performance", "maintainability", "test_gap", "spec_gap", "deploy", "architecture", "ux"]>;
+        claim: z.ZodString;
+        linked_acceptance_criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidence: z.ZodDefault<z.ZodObject<{
+            files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                lines: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                lines: string | null;
+            }, {
+                path: string;
+                lines?: string | null | undefined;
+            }>, "many">>;
+            diff_hunks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                command: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                command: string;
+            }, {
+                command: string;
+            }>, "many">>;
+            logs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+            }, {
+                path: string;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            commands: {
+                command: string;
+            }[];
+            files: {
+                path: string;
+                lines: string | null;
+            }[];
+            diff_hunks: string[];
+            logs: {
+                path: string;
+            }[];
+        }, {
+            commands?: {
+                command: string;
+            }[] | undefined;
+            files?: {
+                path: string;
+                lines?: string | null | undefined;
+            }[] | undefined;
+            diff_hunks?: string[] | undefined;
+            logs?: {
+                path: string;
+            }[] | undefined;
+        }>>;
+        proposed_fix: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        reviewer: z.ZodObject<{
+            harness_id: z.ZodString;
+            requested_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            requested_effort: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            observed_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            route_proof_status: z.ZodDefault<z.ZodEnum<["verified", "accepted_model_arg", "unverified", "same_model_fallback"]>>;
+        }, "strip", z.ZodTypeAny, {
+            harness_id: string;
+            observed_model: string | null;
+            requested_model: string | null;
+            requested_effort: string | null;
+            route_proof_status: "verified" | "accepted_model_arg" | "unverified" | "same_model_fallback";
+        }, {
+            harness_id: string;
+            observed_model?: string | null | undefined;
+            requested_model?: string | null | undefined;
+            requested_effort?: string | null | undefined;
+            route_proof_status?: "verified" | "accepted_model_arg" | "unverified" | "same_model_fallback" | undefined;
+        }>;
+        status: z.ZodDefault<z.ZodEnum<["proposed", "accepted", "rebutted", "fixed", "accepted_risk", "duplicate", "stale", "out_of_scope", "insufficient_evidence"]>>;
+        revalidation_note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "stale" | "proposed" | "accepted" | "rebutted" | "fixed" | "accepted_risk" | "duplicate" | "out_of_scope" | "insufficient_evidence";
+        id: string;
+        severity: "BLOCK" | "FIX_FIRST" | "WARN" | "NIT" | "OUT_OF_SCOPE" | "INSUFFICIENT_EVIDENCE" | "NEEDS_HUMAN";
+        category: "correctness" | "regression" | "security" | "performance" | "maintainability" | "test_gap" | "spec_gap" | "deploy" | "architecture" | "ux";
+        claim: string;
+        linked_acceptance_criteria: string[];
+        evidence: {
+            commands: {
+                command: string;
+            }[];
+            files: {
+                path: string;
+                lines: string | null;
+            }[];
+            diff_hunks: string[];
+            logs: {
+                path: string;
+            }[];
+        };
+        proposed_fix: string | null;
+        reviewer: {
+            harness_id: string;
+            observed_model: string | null;
+            requested_model: string | null;
+            requested_effort: string | null;
+            route_proof_status: "verified" | "accepted_model_arg" | "unverified" | "same_model_fallback";
+        };
+        revalidation_note?: string | undefined;
+    }, {
+        id: string;
+        severity: "BLOCK" | "FIX_FIRST" | "WARN" | "NIT" | "OUT_OF_SCOPE" | "INSUFFICIENT_EVIDENCE" | "NEEDS_HUMAN";
+        category: "correctness" | "regression" | "security" | "performance" | "maintainability" | "test_gap" | "spec_gap" | "deploy" | "architecture" | "ux";
+        claim: string;
+        reviewer: {
+            harness_id: string;
+            observed_model?: string | null | undefined;
+            requested_model?: string | null | undefined;
+            requested_effort?: string | null | undefined;
+            route_proof_status?: "verified" | "accepted_model_arg" | "unverified" | "same_model_fallback" | undefined;
+        };
+        status?: "stale" | "proposed" | "accepted" | "rebutted" | "fixed" | "accepted_risk" | "duplicate" | "out_of_scope" | "insufficient_evidence" | undefined;
+        linked_acceptance_criteria?: string[] | undefined;
+        evidence?: {
+            commands?: {
+                command: string;
+            }[] | undefined;
+            files?: {
+                path: string;
+                lines?: string | null | undefined;
+            }[] | undefined;
+            diff_hunks?: string[] | undefined;
+            logs?: {
+                path: string;
+            }[] | undefined;
+        } | undefined;
+        proposed_fix?: string | null | undefined;
+        revalidation_note?: string | undefined;
+    }>, "many">>;
+    pendingInteractions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        interactionId: z.ZodString;
+        runId: z.ZodString;
+        attemptId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sourceTool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        questions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            header: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                description: string | null;
+            }, {
+                label: string;
+                description?: string | null | undefined;
+            }>, "many">>;
+            multi_select: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            options: {
+                label: string;
+                description: string | null;
+            }[];
+            id: string;
+            question: string;
+            header: string | null;
+            multi_select: boolean;
+        }, {
+            id: string;
+            question: string;
+            options?: {
+                label: string;
+                description?: string | null | undefined;
+            }[] | undefined;
+            header?: string | null | undefined;
+            multi_select?: boolean | undefined;
+        }>, "many">>;
+        requestedAt: z.ZodString;
+        timeoutAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        questions: {
+            options: {
+                label: string;
+                description: string | null;
+            }[];
+            id: string;
+            question: string;
+            header: string | null;
+            multi_select: boolean;
+        }[];
+        runId: string;
+        harnessId: string | null;
+        attemptId: string | null;
+        interactionId: string;
+        sourceTool: string | null;
+        requestedAt: string;
+        timeoutAt: string | null;
+    }, {
+        runId: string;
+        interactionId: string;
+        requestedAt: string;
+        questions?: {
+            id: string;
+            question: string;
+            options?: {
+                label: string;
+                description?: string | null | undefined;
+            }[] | undefined;
+            header?: string | null | undefined;
+            multi_select?: boolean | undefined;
+        }[] | undefined;
+        harnessId?: string | null | undefined;
+        attemptId?: string | null | undefined;
+        sourceTool?: string | null | undefined;
+        timeoutAt?: string | null | undefined;
+    }>, "many">>;
+    /** Typed executor progress for an orchestrate run (auto_safe/auto_full);
+     * null for non-orchestrate runs or suggest autonomy. Projected from
+     * final/orchestration_progress.yaml. */
+    orchestrate: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            tool: z.ZodEnum<["start_run", "race", "status", "answer_question", "apply", "review"]>;
+            risk: z.ZodEnum<["safe", "risky"]>;
+            status: z.ZodEnum<["pending", "running", "done", "skipped", "blocked", "failed"]>;
+            run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "pending" | "blocked" | "failed" | "running" | "done" | "skipped";
+            detail: string | null;
+            tool: "status" | "review" | "apply" | "start_run" | "race" | "answer_question";
+            run_id: string | null;
+            index: number;
+            risk: "safe" | "risky";
+        }, {
+            status: "pending" | "blocked" | "failed" | "running" | "done" | "skipped";
+            tool: "status" | "review" | "apply" | "start_run" | "race" | "answer_question";
+            index: number;
+            risk: "safe" | "risky";
+            detail?: string | null | undefined;
+            run_id?: string | null | undefined;
+        }>, "many">>;
+        autonomy: z.ZodEnum<["suggest", "auto_safe", "auto_full"]>;
+        stopped_reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        autonomy: "suggest" | "auto_safe" | "auto_full";
+        steps: {
+            status: "pending" | "blocked" | "failed" | "running" | "done" | "skipped";
+            detail: string | null;
+            tool: "status" | "review" | "apply" | "start_run" | "race" | "answer_question";
+            run_id: string | null;
+            index: number;
+            risk: "safe" | "risky";
+        }[];
+        stopped_reason: string | null;
+    }, {
+        autonomy: "suggest" | "auto_safe" | "auto_full";
+        steps?: {
+            status: "pending" | "blocked" | "failed" | "running" | "done" | "skipped";
+            tool: "status" | "review" | "apply" | "start_run" | "race" | "answer_question";
+            index: number;
+            risk: "safe" | "risky";
+            detail?: string | null | undefined;
+            run_id?: string | null | undefined;
+        }[] | undefined;
+        stopped_reason?: string | null | undefined;
+    }>>>;
+    /** Per-candidate evidence cards. Present for EVERY envelope-producing
+     * mode (races show N lanes; single-candidate turns and convergence
+     * refinements project their attempts too); empty only when no attempt
+     * artifacts exist. */
+    candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        attemptId: z.ZodString;
+        harnessId: z.ZodString;
+        label: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        costUsd: z.ZodDefault<z.ZodNumber>;
+        costEstimated: z.ZodDefault<z.ZodBoolean>;
+        errored: z.ZodDefault<z.ZodBoolean>;
+        gatesPassed: z.ZodDefault<z.ZodNumber>;
+        gatesTotal: z.ZodDefault<z.ZodNumber>;
+        /** Blocking review findings count (accepted blockers). */
+        blockers: z.ZodDefault<z.ZodNumber>;
+        reviewVerified: z.ZodDefault<z.ZodBoolean>;
+        finalReviewClean: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+        winner: z.ZodDefault<z.ZodBoolean>;
+        diffstat: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            files: z.ZodDefault<z.ZodNumber>;
+            additions: z.ZodDefault<z.ZodNumber>;
+            deletions: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            files: number;
+            additions: number;
+            deletions: number;
+        }, {
+            files?: number | undefined;
+            additions?: number | undefined;
+            deletions?: number | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string | null;
+        winner: boolean;
+        harnessId: string;
+        attemptId: string;
+        blockers: number;
+        costUsd: number;
+        costEstimated: boolean;
+        errored: boolean;
+        gatesPassed: number;
+        gatesTotal: number;
+        reviewVerified: boolean;
+        finalReviewClean: boolean | null;
+        diffstat: {
+            files: number;
+            additions: number;
+            deletions: number;
+        } | null;
+    }, {
+        harnessId: string;
+        attemptId: string;
+        label?: string | null | undefined;
+        winner?: boolean | undefined;
+        blockers?: number | undefined;
+        costUsd?: number | undefined;
+        costEstimated?: boolean | undefined;
+        errored?: boolean | undefined;
+        gatesPassed?: number | undefined;
+        gatesTotal?: number | undefined;
+        reviewVerified?: boolean | undefined;
+        finalReviewClean?: boolean | null | undefined;
+        diffstat?: {
+            files?: number | undefined;
+            additions?: number | undefined;
+            deletions?: number | undefined;
+        } | null | undefined;
+    }>, "many">>;
+    /** Live plan checklist: the LAST plan.progress event's items, or null
+     * when the run never emitted one. */
+    planProgress: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<["pending", "in_progress", "completed"]>;
+        }, "strip", z.ZodTypeAny, {
+            status: "pending" | "completed" | "in_progress";
+            id: string;
+            title: string;
+        }, {
+            status: "pending" | "completed" | "in_progress";
+            id: string;
+            title: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        items: {
+            status: "pending" | "completed" | "in_progress";
+            id: string;
+            title: string;
+        }[];
+    }, {
+        items?: {
+            status: "pending" | "completed" | "in_progress";
+            id: string;
+            title: string;
+        }[] | undefined;
+    }>>>;
+    failure: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        phase: z.ZodDefault<z.ZodString>;
+        category: z.ZodDefault<z.ZodEnum<["validation", "project", "auth", "harness_unavailable", "harness_error", "budget", "policy", "cancelled", "internal", "unknown"]>>;
+        harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        attemptId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        safeMessage: z.ZodString;
+        rawDetailRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        logRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        eventRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        runDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        nextActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        runDir: string | null;
+        category: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal";
+        phase: string;
+        harnessId: string | null;
+        attemptId: string | null;
+        safeMessage: string;
+        rawDetailRef: string | null;
+        logRefs: string[];
+        eventRefs: string[];
+        nextActions: string[];
+    }, {
+        safeMessage: string;
+        runDir?: string | null | undefined;
+        category?: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal" | undefined;
+        phase?: string | undefined;
+        harnessId?: string | null | undefined;
+        attemptId?: string | null | undefined;
+        rawDetailRef?: string | null | undefined;
+        logRefs?: string[] | undefined;
+        eventRefs?: string[] | undefined;
+        nextActions?: string[] | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    orchestrate: {
+        autonomy: "suggest" | "auto_safe" | "auto_full";
+        steps: {
+            status: "pending" | "blocked" | "failed" | "running" | "done" | "skipped";
+            detail: string | null;
+            tool: "status" | "review" | "apply" | "start_run" | "race" | "answer_question";
+            run_id: string | null;
+            index: number;
+            risk: "safe" | "risky";
+        }[];
+        stopped_reason: string | null;
+    } | null;
+    decision: {
+        status: "cancelled" | "success" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted";
+        winner: string | null;
+        outcome: "ready" | "no_op" | "ungated" | "review_not_run" | "blocked";
+        why_winner: string;
+        why_not_others: Record<string, string>;
+        accepted_risks: string[];
+        final_checks: string[];
+        evidence_facts: string[];
+        budget_summary: {
+            estimated: boolean;
+            spend_usd: number | null;
+        };
+        apply_recommendation: "apply" | "inspect" | "continue" | "split_task" | "human_review";
+        verification_basis: "none" | "cross_family_review" | "both";
+        final_verify: {
+            duration_ms: number | null;
+            base_sha: string | null;
+            reason: string | null;
+            attempted: boolean;
+            applied_cleanly: boolean | null;
+            gates_passed: boolean | null;
+            gates: {
+                status: string;
+                id: string;
+            }[];
+        } | null;
+    } | null;
+    summary: {
+        state: "cancelled" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted" | "running" | "queued" | "succeeded" | "interrupted";
+        runId: string;
+        project: {
+            kind: "none" | "project";
+            root: string | null;
+            context: "off" | "auto";
+            projectName: string | null;
+        };
+        jobId: string;
+        failure: {
+            runDir: string | null;
+            category: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal";
+            phase: string;
+            harnessId: string | null;
+            attemptId: string | null;
+            safeMessage: string;
+            rawDetailRef: string | null;
+            logRefs: string[];
+            eventRefs: string[];
+            nextActions: string[];
+        } | null;
+        webEvidence: {
+            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            target: string | null;
+            tool: string | null;
+            mode: "off" | "auto" | "cached" | "live";
+            required: boolean;
+            attempted: boolean;
+            rawDetailRef: string | null;
+            effectiveMode: "off" | "auto" | "cached" | "live";
+            satisfied: boolean;
+            errorSummary: string | null;
+            available: boolean;
+        };
+        outputReadyState: "pending" | "finalizing" | "ready" | "diagnostic";
+        toolWarningsTotal: number;
+        result: {
+            kind: "plan" | "none" | "patch" | "report" | "answer";
+            diffStat: {
+                files: number;
+                additions: number;
+                deletions: number;
+            } | null;
+            blockers: number;
+            adopted: boolean | null;
+            applyState: "not_applied" | "applied" | "applied_review_blocked" | "reverted";
+            preTurnSha: string | null;
+            postTurnSha: string | null;
+            revertable: boolean;
+        };
+        waitingOnUser: boolean;
+        route: {
+            verified: boolean;
+            harnessId: string | null;
+            requestedModel: string | null;
+            observedModel: string | null;
+        } | null;
+        prompt?: string | undefined;
+        access?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        error?: string | undefined;
+        mode?: "ask" | "plan" | "audit" | "agent" | "orchestrate" | undefined;
+        harnesses?: string[] | undefined;
+        runDir?: string | undefined;
+        tests?: string[] | undefined;
+        portfolio?: "daily-rich" | "balanced" | "cheapest" | "strongest" | "burn" | "subscription-first" | "api-overflow" | "conserve-claude" | "conserve-codex" | undefined;
+        n?: number | undefined;
+        model?: string | undefined;
+        primaryHarness?: string | undefined;
+        maxUsd?: number | null | undefined;
+        externalContextPolicy?: "off" | "auto" | "cached" | "live" | undefined;
+        protectedPathApprovals?: {
+            path: string;
+            reason?: string | undefined;
+        }[] | undefined;
+        specId?: string | undefined;
+        specHash?: string | undefined;
+        reviewerPanel?: {
+            harness: string;
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            model?: string | undefined;
+        }[] | undefined;
+        createdAt?: string | undefined;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        taskId?: string | undefined;
+        strategy?: "race" | "attempts" | "swarm" | "create" | "until_clean" | null | undefined;
+        spendUsd?: number | null | undefined;
+        spendEstimated?: boolean | undefined;
+        requestedAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        effectiveAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        webRequired?: boolean | undefined;
+        webMode?: "off" | "auto" | "cached" | "live" | undefined;
+        toolPermissionPolicy?: Record<string, unknown> | undefined;
+    };
+    applyEligibility: {
+        state: string | null;
+        reason: string | null;
+        eligible: boolean;
+        requiredAction: string | null;
+    } | null;
+    budget: {
+        source: "unknown" | "decision" | "events" | "settings";
+        estimated: boolean;
+        maxUsd: number | null;
+        spendUsd: number | null;
+        remainingUsd: number | null;
+    };
+    failure: {
+        runDir: string | null;
+        category: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal";
+        phase: string;
+        harnessId: string | null;
+        attemptId: string | null;
+        safeMessage: string;
+        rawDetailRef: string | null;
+        logRefs: string[];
+        eventRefs: string[];
+        nextActions: string[];
+    } | null;
+    lastSeq: number;
+    artifacts: {
+        path: string;
+        kind: "file" | "directory";
+        mime?: string | undefined;
+        bytes?: number | undefined;
+    }[];
+    primaryOutput: {
+        path: string;
+        kind: "diagnostic" | "plan" | "summary" | "patch" | "report" | "answer";
+        text: string | null;
+        bytes?: number | undefined;
+    } | null;
+    timeline: {
+        type: string;
+        detail: string | null;
+        target: string | null;
+        title: string;
+        severity: "error" | "info" | "warning";
+        harnessId: string | null;
+        attemptId: string | null;
+        errorSummary: string | null;
+        toolName: string | null;
+        rawRef: string | null;
+        ts?: string | undefined;
+    }[];
+    finalSummary: string | null;
+    operatorDecision: {
+        action: string;
+        decidedAt: string | null;
+    } | null;
+    workProduct: {
+        id: string;
+        kind: "patch" | "new_repo" | "report";
+        files: Record<string, string>;
+        source_task_id: string;
+        meta: Record<string, unknown>;
+        producer_attempt_id?: string | undefined;
+        evidence_dir?: string | undefined;
+    } | null;
+    reviewFindings: {
+        status: "stale" | "proposed" | "accepted" | "rebutted" | "fixed" | "accepted_risk" | "duplicate" | "out_of_scope" | "insufficient_evidence";
+        id: string;
+        severity: "BLOCK" | "FIX_FIRST" | "WARN" | "NIT" | "OUT_OF_SCOPE" | "INSUFFICIENT_EVIDENCE" | "NEEDS_HUMAN";
+        category: "correctness" | "regression" | "security" | "performance" | "maintainability" | "test_gap" | "spec_gap" | "deploy" | "architecture" | "ux";
+        claim: string;
+        linked_acceptance_criteria: string[];
+        evidence: {
+            commands: {
+                command: string;
+            }[];
+            files: {
+                path: string;
+                lines: string | null;
+            }[];
+            diff_hunks: string[];
+            logs: {
+                path: string;
+            }[];
+        };
+        proposed_fix: string | null;
+        reviewer: {
+            harness_id: string;
+            observed_model: string | null;
+            requested_model: string | null;
+            requested_effort: string | null;
+            route_proof_status: "verified" | "accepted_model_arg" | "unverified" | "same_model_fallback";
+        };
+        revalidation_note?: string | undefined;
+    }[];
+    pendingInteractions: {
+        questions: {
+            options: {
+                label: string;
+                description: string | null;
+            }[];
+            id: string;
+            question: string;
+            header: string | null;
+            multi_select: boolean;
+        }[];
+        runId: string;
+        harnessId: string | null;
+        attemptId: string | null;
+        interactionId: string;
+        sourceTool: string | null;
+        requestedAt: string;
+        timeoutAt: string | null;
+    }[];
+    candidates: {
+        label: string | null;
+        winner: boolean;
+        harnessId: string;
+        attemptId: string;
+        blockers: number;
+        costUsd: number;
+        costEstimated: boolean;
+        errored: boolean;
+        gatesPassed: number;
+        gatesTotal: number;
+        reviewVerified: boolean;
+        finalReviewClean: boolean | null;
+        diffstat: {
+            files: number;
+            additions: number;
+            deletions: number;
+        } | null;
+    }[];
+    planProgress: {
+        items: {
+            status: "pending" | "completed" | "in_progress";
+            id: string;
+            title: string;
+        }[];
+    } | null;
+}, {
+    summary: {
+        state: "cancelled" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted" | "running" | "queued" | "succeeded" | "interrupted";
+        runId: string;
+        jobId: string;
+        prompt?: string | undefined;
+        access?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        error?: string | undefined;
+        mode?: "ask" | "plan" | "audit" | "agent" | "orchestrate" | undefined;
+        harnesses?: string[] | undefined;
+        runDir?: string | undefined;
+        tests?: string[] | undefined;
+        portfolio?: "daily-rich" | "balanced" | "cheapest" | "strongest" | "burn" | "subscription-first" | "api-overflow" | "conserve-claude" | "conserve-codex" | undefined;
+        project?: {
+            kind?: "none" | "project" | undefined;
+            root?: string | null | undefined;
+            context?: "off" | "auto" | undefined;
+            projectName?: string | null | undefined;
+        } | undefined;
+        n?: number | undefined;
+        model?: string | undefined;
+        primaryHarness?: string | undefined;
+        maxUsd?: number | null | undefined;
+        externalContextPolicy?: "off" | "auto" | "cached" | "live" | undefined;
+        protectedPathApprovals?: {
+            path: string;
+            reason?: string | undefined;
+        }[] | undefined;
+        specId?: string | undefined;
+        specHash?: string | undefined;
+        reviewerPanel?: {
+            harness: string;
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            model?: string | undefined;
+        }[] | undefined;
+        createdAt?: string | undefined;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        taskId?: string | undefined;
+        failure?: {
+            safeMessage: string;
+            runDir?: string | null | undefined;
+            category?: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal" | undefined;
+            phase?: string | undefined;
+            harnessId?: string | null | undefined;
+            attemptId?: string | null | undefined;
+            rawDetailRef?: string | null | undefined;
+            logRefs?: string[] | undefined;
+            eventRefs?: string[] | undefined;
+            nextActions?: string[] | undefined;
+        } | null | undefined;
+        strategy?: "race" | "attempts" | "swarm" | "create" | "until_clean" | null | undefined;
+        spendUsd?: number | null | undefined;
+        spendEstimated?: boolean | undefined;
+        requestedAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        effectiveAccess?: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native" | undefined;
+        webRequired?: boolean | undefined;
+        webMode?: "off" | "auto" | "cached" | "live" | undefined;
+        webEvidence?: {
+            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+            target?: string | null | undefined;
+            tool?: string | null | undefined;
+            mode?: "off" | "auto" | "cached" | "live" | undefined;
+            required?: boolean | undefined;
+            attempted?: boolean | undefined;
+            rawDetailRef?: string | null | undefined;
+            effectiveMode?: "off" | "auto" | "cached" | "live" | undefined;
+            satisfied?: boolean | undefined;
+            errorSummary?: string | null | undefined;
+            available?: boolean | undefined;
+        } | undefined;
+        toolPermissionPolicy?: Record<string, unknown> | undefined;
+        outputReadyState?: "pending" | "finalizing" | "ready" | "diagnostic" | undefined;
+        toolWarningsTotal?: number | undefined;
+        result?: {
+            kind?: "plan" | "none" | "patch" | "report" | "answer" | undefined;
+            diffStat?: {
+                files: number;
+                additions: number;
+                deletions: number;
+            } | null | undefined;
+            blockers?: number | undefined;
+            adopted?: boolean | null | undefined;
+            applyState?: "not_applied" | "applied" | "applied_review_blocked" | "reverted" | undefined;
+            preTurnSha?: string | null | undefined;
+            postTurnSha?: string | null | undefined;
+            revertable?: boolean | undefined;
+        } | undefined;
+        waitingOnUser?: boolean | undefined;
+        route?: {
+            verified?: boolean | undefined;
+            harnessId?: string | null | undefined;
+            requestedModel?: string | null | undefined;
+            observedModel?: string | null | undefined;
+        } | null | undefined;
+    };
+    orchestrate?: {
+        autonomy: "suggest" | "auto_safe" | "auto_full";
+        steps?: {
+            status: "pending" | "blocked" | "failed" | "running" | "done" | "skipped";
+            tool: "status" | "review" | "apply" | "start_run" | "race" | "answer_question";
+            index: number;
+            risk: "safe" | "risky";
+            detail?: string | null | undefined;
+            run_id?: string | null | undefined;
+        }[] | undefined;
+        stopped_reason?: string | null | undefined;
+    } | null | undefined;
+    decision?: {
+        status: "cancelled" | "success" | "no_op" | "ungated" | "review_not_run" | "blocked" | "not_converged" | "stuck_no_progress" | "failed" | "exhausted";
+        winner: string | null;
+        outcome?: "ready" | "no_op" | "ungated" | "review_not_run" | "blocked" | undefined;
+        why_winner?: string | undefined;
+        why_not_others?: Record<string, string> | undefined;
+        accepted_risks?: string[] | undefined;
+        final_checks?: string[] | undefined;
+        evidence_facts?: string[] | undefined;
+        budget_summary?: {
+            estimated?: boolean | undefined;
+            spend_usd?: number | null | undefined;
+        } | undefined;
+        apply_recommendation?: "apply" | "inspect" | "continue" | "split_task" | "human_review" | undefined;
+        verification_basis?: "none" | "cross_family_review" | "both" | undefined;
+        final_verify?: {
+            attempted: boolean;
+            duration_ms?: number | null | undefined;
+            base_sha?: string | null | undefined;
+            reason?: string | null | undefined;
+            applied_cleanly?: boolean | null | undefined;
+            gates_passed?: boolean | null | undefined;
+            gates?: {
+                status: string;
+                id: string;
+            }[] | undefined;
+        } | null | undefined;
+    } | null | undefined;
+    applyEligibility?: {
+        state: string | null;
+        reason: string | null;
+        eligible: boolean;
+        requiredAction: string | null;
+    } | null | undefined;
+    budget?: {
+        source?: "unknown" | "decision" | "events" | "settings" | undefined;
+        estimated?: boolean | undefined;
+        maxUsd?: number | null | undefined;
+        spendUsd?: number | null | undefined;
+        remainingUsd?: number | null | undefined;
+    } | undefined;
+    failure?: {
+        safeMessage: string;
+        runDir?: string | null | undefined;
+        category?: "validation" | "unknown" | "harness_error" | "auth" | "cancelled" | "budget" | "project" | "policy" | "harness_unavailable" | "internal" | undefined;
+        phase?: string | undefined;
+        harnessId?: string | null | undefined;
+        attemptId?: string | null | undefined;
+        rawDetailRef?: string | null | undefined;
+        logRefs?: string[] | undefined;
+        eventRefs?: string[] | undefined;
+        nextActions?: string[] | undefined;
+    } | null | undefined;
+    lastSeq?: number | undefined;
+    artifacts?: {
+        path: string;
+        kind: "file" | "directory";
+        mime?: string | undefined;
+        bytes?: number | undefined;
+    }[] | undefined;
+    primaryOutput?: {
+        path: string;
+        kind: "diagnostic" | "plan" | "summary" | "patch" | "report" | "answer";
+        text?: string | null | undefined;
+        bytes?: number | undefined;
+    } | null | undefined;
+    timeline?: {
+        type: string;
+        title: string;
+        detail?: string | null | undefined;
+        target?: string | null | undefined;
+        ts?: string | undefined;
+        severity?: "error" | "info" | "warning" | undefined;
+        harnessId?: string | null | undefined;
+        attemptId?: string | null | undefined;
+        errorSummary?: string | null | undefined;
+        toolName?: string | null | undefined;
+        rawRef?: string | null | undefined;
+    }[] | undefined;
+    finalSummary?: string | null | undefined;
+    operatorDecision?: {
+        action: string;
+        decidedAt?: string | null | undefined;
+    } | null | undefined;
+    workProduct?: {
+        id: string;
+        kind: "patch" | "new_repo" | "report";
+        source_task_id: string;
+        files?: Record<string, string> | undefined;
+        producer_attempt_id?: string | undefined;
+        evidence_dir?: string | undefined;
+        meta?: Record<string, unknown> | undefined;
+    } | null | undefined;
+    reviewFindings?: {
+        id: string;
+        severity: "BLOCK" | "FIX_FIRST" | "WARN" | "NIT" | "OUT_OF_SCOPE" | "INSUFFICIENT_EVIDENCE" | "NEEDS_HUMAN";
+        category: "correctness" | "regression" | "security" | "performance" | "maintainability" | "test_gap" | "spec_gap" | "deploy" | "architecture" | "ux";
+        claim: string;
+        reviewer: {
+            harness_id: string;
+            observed_model?: string | null | undefined;
+            requested_model?: string | null | undefined;
+            requested_effort?: string | null | undefined;
+            route_proof_status?: "verified" | "accepted_model_arg" | "unverified" | "same_model_fallback" | undefined;
+        };
+        status?: "stale" | "proposed" | "accepted" | "rebutted" | "fixed" | "accepted_risk" | "duplicate" | "out_of_scope" | "insufficient_evidence" | undefined;
+        linked_acceptance_criteria?: string[] | undefined;
+        evidence?: {
+            commands?: {
+                command: string;
+            }[] | undefined;
+            files?: {
+                path: string;
+                lines?: string | null | undefined;
+            }[] | undefined;
+            diff_hunks?: string[] | undefined;
+            logs?: {
+                path: string;
+            }[] | undefined;
+        } | undefined;
+        proposed_fix?: string | null | undefined;
+        revalidation_note?: string | undefined;
+    }[] | undefined;
+    pendingInteractions?: {
+        runId: string;
+        interactionId: string;
+        requestedAt: string;
+        questions?: {
+            id: string;
+            question: string;
+            options?: {
+                label: string;
+                description?: string | null | undefined;
+            }[] | undefined;
+            header?: string | null | undefined;
+            multi_select?: boolean | undefined;
+        }[] | undefined;
+        harnessId?: string | null | undefined;
+        attemptId?: string | null | undefined;
+        sourceTool?: string | null | undefined;
+        timeoutAt?: string | null | undefined;
+    }[] | undefined;
+    candidates?: {
+        harnessId: string;
+        attemptId: string;
+        label?: string | null | undefined;
+        winner?: boolean | undefined;
+        blockers?: number | undefined;
+        costUsd?: number | undefined;
+        costEstimated?: boolean | undefined;
+        errored?: boolean | undefined;
+        gatesPassed?: number | undefined;
+        gatesTotal?: number | undefined;
+        reviewVerified?: boolean | undefined;
+        finalReviewClean?: boolean | null | undefined;
+        diffstat?: {
+            files?: number | undefined;
+            additions?: number | undefined;
+            deletions?: number | undefined;
+        } | null | undefined;
+    }[] | undefined;
+    planProgress?: {
+        items?: {
+            status: "pending" | "completed" | "in_progress";
+            id: string;
+            title: string;
+        }[] | undefined;
+    } | null | undefined;
+}>;
+export type ControlRunDetail = z.infer<typeof ControlRunDetail>;
+//# sourceMappingURL=control-run-detail.d.ts.map