harness-engineering-agent 0.3.24 → 0.3.26

package/dist/controller/agent-output-contracts.d.ts

@@ -0,0 +1,762 @@
+import type { z } from "zod";
+export declare const WorkerOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "WorkerOutput";
+    readonly requiredFields: readonly ["schemaVersion", "role", "status", "summary", "evidenceIds", "changedPaths"];
+    readonly example: Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        role: "worker";
+        status: "completed";
+        changedPaths: readonly string[];
+        repositoryId?: string | undefined;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        role: "worker";
+        status: "blocked";
+        blockingReason: string;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        role: "worker";
+        status: "evidence_gap";
+        missingEvidenceKinds: readonly ("verification" | "red" | "green" | "refactor" | "approval" | "artifact-summary")[];
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        role: "worker";
+        status: "failed";
+        failureId: string;
+    }>>;
+};
+export declare const VerifierOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "VerifierOutput";
+    readonly requiredFields: readonly ["schemaVersion", "role", "status", "summary", "evidenceIds"];
+    readonly example: Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "passed";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        taskReview?: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            taskId: string & z.core.$brand<"TaskId">;
+            requirementId: string;
+            acceptanceCriterionIds: readonly string[];
+            status: "failed" | "passed";
+            summary: string;
+            changedPaths: readonly string[];
+            specCompliance: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            codeQuality: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            repositoryId?: string | undefined;
+        }> | undefined;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "failed";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        taskReview?: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            taskId: string & z.core.$brand<"TaskId">;
+            requirementId: string;
+            acceptanceCriterionIds: readonly string[];
+            status: "failed" | "passed";
+            summary: string;
+            changedPaths: readonly string[];
+            specCompliance: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            codeQuality: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            repositoryId?: string | undefined;
+        }> | undefined;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "approved";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        planReview: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            graphId: string;
+            requirementId: string;
+            status: "approved" | "rejected";
+            summary: string;
+            requirement: Readonly<{
+                schemaVersion: "1.0.0";
+                requirementId: string;
+                title: string;
+                summary: string;
+                acceptanceCriteria: readonly Readonly<{
+                    criterionId: string;
+                    text: string;
+                }>[];
+                complexityAssessment?: Readonly<{
+                    tier: "trivial" | "standard" | "complex";
+                    rationale: string;
+                    estimatedFileCount: number;
+                    estimatedCrossModuleDeps: number;
+                    suggestedRoute: "direct" | "streamlined" | "full" | "parallel";
+                    confidence: "high" | "medium" | "low";
+                }> | undefined;
+                coordinationAnalysis?: Readonly<{
+                    surfaceForm: string;
+                    trueIntent: string;
+                    actionPlan: readonly string[];
+                    reflectionNotes: readonly string[];
+                }> | undefined;
+                taskSchedulingAnalysis?: Readonly<{
+                    requestKind: "ordinary" | "lifecycle" | "engineering_task" | "ambiguous";
+                    shouldCoordinate: boolean;
+                    requiresPlanBeforeExecution: boolean;
+                    routingRationale: string;
+                    rejudgementTriggers: readonly string[];
+                }> | undefined;
+                repositoryId?: string | undefined;
+                targetRepository?: string | undefined;
+                workspaceMutation?: "allowed" | "forbidden" | undefined;
+            }>;
+            taskGraph: Readonly<{
+                schemaVersion: "1.0.0";
+                graphId: string;
+                runId: string & z.core.$brand<"RunId">;
+                version: number;
+                tasks: readonly Readonly<{
+                    schemaVersion: "1.0.0";
+                    taskId: string & z.core.$brand<"TaskId">;
+                    runId: string & z.core.$brand<"RunId">;
+                    requirementIds: readonly string[];
+                    title: string;
+                    summary: string;
+                    status: "blocked" | "paused" | "failed" | "completed" | "planned" | "ready" | "in_progress";
+                    allowedPaths: readonly string[];
+                    acceptanceCriterionIds: readonly string[];
+                    executionCategory: "quick" | "deep" | "visual-engineering" | "ultrabrain";
+                    verificationPlan: readonly Readonly<{
+                        name: string;
+                        command: string;
+                        workingDirectory: string;
+                        scope: "task" | "project" | "integration";
+                        sideEffectLevel: "read_only" | "workspace_write" | "external_side_effect";
+                        timeoutMs: number;
+                        args?: readonly string[] | undefined;
+                        origin?: "config" | "planner" | "worker" | "failure-analyzer" | "repair" | undefined;
+                        requiresConfirmation?: boolean | undefined;
+                        confirmation?: Readonly<{
+                            approvedBy: string;
+                            reason: string;
+                        }> | undefined;
+                        allowedEnv?: Readonly<Record<string, string>> | undefined;
+                    }>[];
+                    retryBudget: Readonly<{
+                        maxAttempts: number;
+                        maxRepairAttempts: number;
+                    }>;
+                    dependencies: readonly (string & z.core.$brand<"TaskId">)[];
+                    evidenceRefs: readonly (string & z.core.$brand<"EvidenceId">)[];
+                    repairEnabled: boolean;
+                    assignedAgentRole: "intake" | "planner" | "worker" | "verifier" | "failure-analyzer" | "repair-worker" | "acceptance";
+                    repositoryId?: string | undefined;
+                    complexityTier?: "trivial" | "standard" | "complex" | undefined;
+                    tierOverriddenFrom?: "trivial" | "standard" | "complex" | undefined;
+                    modelProfile?: Readonly<{
+                        provider: string;
+                        model: string;
+                    }> | undefined;
+                    workspaceMutation?: "allowed" | "forbidden" | undefined;
+                }>[];
+                edges: readonly Readonly<{
+                    fromTaskId: string & z.core.$brand<"TaskId">;
+                    toTaskId: string & z.core.$brand<"TaskId">;
+                }>[];
+                repositoryId?: string | undefined;
+            }>;
+            contextPackage: Readonly<{
+                schemaVersion: "1.0.0";
+                contextPackageId: string;
+                runId: string & z.core.$brand<"RunId">;
+                requirementId: string;
+                summary: string;
+                repositoryReferences: readonly (Readonly<{
+                    path: string;
+                    reason: string;
+                    kind: "file";
+                }> | Readonly<{
+                    symbol: string;
+                    path: string;
+                    reason: string;
+                    kind: "symbol";
+                }>)[];
+                externalReferences: readonly Readonly<{
+                    title: string;
+                    sourceType: "spec" | "doc" | "repo" | "issue";
+                    locator: string;
+                    reason: string;
+                }>[];
+                unresolvedQuestions: readonly Readonly<{
+                    questionId: string;
+                    question: string;
+                    impact: string;
+                }>[];
+                constraints: readonly string[];
+            }>;
+            coverage: readonly Readonly<{
+                criterionId: string;
+                criterion: string;
+                coveredByTaskIds: readonly (string & z.core.$brand<"TaskId">)[];
+                verificationCommandNames: readonly string[];
+            }>[];
+            findings: readonly Readonly<{
+                severity: "critical" | "important" | "advisory";
+                message: string;
+                taskId?: (string & z.core.$brand<"TaskId">) | undefined;
+                criterionId?: string | undefined;
+            }>[];
+            reviewedTasks: readonly Readonly<{
+                taskId: string & z.core.$brand<"TaskId">;
+                executionCategory: "quick" | "deep" | "visual-engineering" | "ultrabrain";
+                requirementIds: readonly string[];
+                acceptanceCriterionIds: readonly string[];
+                allowedPaths: readonly string[];
+                dependencies: readonly (string & z.core.$brand<"TaskId">)[];
+                verificationCommandNames: readonly string[];
+            }>[];
+        }>;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "rejected";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        planReview: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            graphId: string;
+            requirementId: string;
+            status: "approved" | "rejected";
+            summary: string;
+            requirement: Readonly<{
+                schemaVersion: "1.0.0";
+                requirementId: string;
+                title: string;
+                summary: string;
+                acceptanceCriteria: readonly Readonly<{
+                    criterionId: string;
+                    text: string;
+                }>[];
+                complexityAssessment?: Readonly<{
+                    tier: "trivial" | "standard" | "complex";
+                    rationale: string;
+                    estimatedFileCount: number;
+                    estimatedCrossModuleDeps: number;
+                    suggestedRoute: "direct" | "streamlined" | "full" | "parallel";
+                    confidence: "high" | "medium" | "low";
+                }> | undefined;
+                coordinationAnalysis?: Readonly<{
+                    surfaceForm: string;
+                    trueIntent: string;
+                    actionPlan: readonly string[];
+                    reflectionNotes: readonly string[];
+                }> | undefined;
+                taskSchedulingAnalysis?: Readonly<{
+                    requestKind: "ordinary" | "lifecycle" | "engineering_task" | "ambiguous";
+                    shouldCoordinate: boolean;
+                    requiresPlanBeforeExecution: boolean;
+                    routingRationale: string;
+                    rejudgementTriggers: readonly string[];
+                }> | undefined;
+                repositoryId?: string | undefined;
+                targetRepository?: string | undefined;
+                workspaceMutation?: "allowed" | "forbidden" | undefined;
+            }>;
+            taskGraph: Readonly<{
+                schemaVersion: "1.0.0";
+                graphId: string;
+                runId: string & z.core.$brand<"RunId">;
+                version: number;
+                tasks: readonly Readonly<{
+                    schemaVersion: "1.0.0";
+                    taskId: string & z.core.$brand<"TaskId">;
+                    runId: string & z.core.$brand<"RunId">;
+                    requirementIds: readonly string[];
+                    title: string;
+                    summary: string;
+                    status: "blocked" | "paused" | "failed" | "completed" | "planned" | "ready" | "in_progress";
+                    allowedPaths: readonly string[];
+                    acceptanceCriterionIds: readonly string[];
+                    executionCategory: "quick" | "deep" | "visual-engineering" | "ultrabrain";
+                    verificationPlan: readonly Readonly<{
+                        name: string;
+                        command: string;
+                        workingDirectory: string;
+                        scope: "task" | "project" | "integration";
+                        sideEffectLevel: "read_only" | "workspace_write" | "external_side_effect";
+                        timeoutMs: number;
+                        args?: readonly string[] | undefined;
+                        origin?: "config" | "planner" | "worker" | "failure-analyzer" | "repair" | undefined;
+                        requiresConfirmation?: boolean | undefined;
+                        confirmation?: Readonly<{
+                            approvedBy: string;
+                            reason: string;
+                        }> | undefined;
+                        allowedEnv?: Readonly<Record<string, string>> | undefined;
+                    }>[];
+                    retryBudget: Readonly<{
+                        maxAttempts: number;
+                        maxRepairAttempts: number;
+                    }>;
+                    dependencies: readonly (string & z.core.$brand<"TaskId">)[];
+                    evidenceRefs: readonly (string & z.core.$brand<"EvidenceId">)[];
+                    repairEnabled: boolean;
+                    assignedAgentRole: "intake" | "planner" | "worker" | "verifier" | "failure-analyzer" | "repair-worker" | "acceptance";
+                    repositoryId?: string | undefined;
+                    complexityTier?: "trivial" | "standard" | "complex" | undefined;
+                    tierOverriddenFrom?: "trivial" | "standard" | "complex" | undefined;
+                    modelProfile?: Readonly<{
+                        provider: string;
+                        model: string;
+                    }> | undefined;
+                    workspaceMutation?: "allowed" | "forbidden" | undefined;
+                }>[];
+                edges: readonly Readonly<{
+                    fromTaskId: string & z.core.$brand<"TaskId">;
+                    toTaskId: string & z.core.$brand<"TaskId">;
+                }>[];
+                repositoryId?: string | undefined;
+            }>;
+            contextPackage: Readonly<{
+                schemaVersion: "1.0.0";
+                contextPackageId: string;
+                runId: string & z.core.$brand<"RunId">;
+                requirementId: string;
+                summary: string;
+                repositoryReferences: readonly (Readonly<{
+                    path: string;
+                    reason: string;
+                    kind: "file";
+                }> | Readonly<{
+                    symbol: string;
+                    path: string;
+                    reason: string;
+                    kind: "symbol";
+                }>)[];
+                externalReferences: readonly Readonly<{
+                    title: string;
+                    sourceType: "spec" | "doc" | "repo" | "issue";
+                    locator: string;
+                    reason: string;
+                }>[];
+                unresolvedQuestions: readonly Readonly<{
+                    questionId: string;
+                    question: string;
+                    impact: string;
+                }>[];
+                constraints: readonly string[];
+            }>;
+            coverage: readonly Readonly<{
+                criterionId: string;
+                criterion: string;
+                coveredByTaskIds: readonly (string & z.core.$brand<"TaskId">)[];
+                verificationCommandNames: readonly string[];
+            }>[];
+            findings: readonly Readonly<{
+                severity: "critical" | "important" | "advisory";
+                message: string;
+                taskId?: (string & z.core.$brand<"TaskId">) | undefined;
+                criterionId?: string | undefined;
+            }>[];
+            reviewedTasks: readonly Readonly<{
+                taskId: string & z.core.$brand<"TaskId">;
+                executionCategory: "quick" | "deep" | "visual-engineering" | "ultrabrain";
+                requirementIds: readonly string[];
+                acceptanceCriterionIds: readonly string[];
+                allowedPaths: readonly string[];
+                dependencies: readonly (string & z.core.$brand<"TaskId">)[];
+                verificationCommandNames: readonly string[];
+            }>[];
+        }>;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "evidence_gap";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        missingEvidenceKinds: readonly ("verification" | "red" | "green" | "refactor" | "approval" | "artifact-summary")[];
+        taskReview?: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            taskId: string & z.core.$brand<"TaskId">;
+            requirementId: string;
+            acceptanceCriterionIds: readonly string[];
+            status: "failed" | "passed";
+            summary: string;
+            changedPaths: readonly string[];
+            specCompliance: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            codeQuality: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            repositoryId?: string | undefined;
+        }> | undefined;
+    }>>;
+};
+export declare const TaskReviewOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "TaskReview";
+    readonly requiredFields: readonly ["schemaVersion", "role", "status", "summary", "evidenceIds", "taskReview"];
+    readonly example: Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "passed";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        taskReview: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            taskId: string & z.core.$brand<"TaskId">;
+            requirementId: string;
+            acceptanceCriterionIds: readonly string[];
+            status: "failed" | "passed";
+            summary: string;
+            changedPaths: readonly string[];
+            specCompliance: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            codeQuality: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            repositoryId?: string | undefined;
+        }>;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "failed";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        taskReview: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            taskId: string & z.core.$brand<"TaskId">;
+            requirementId: string;
+            acceptanceCriterionIds: readonly string[];
+            status: "failed" | "passed";
+            summary: string;
+            changedPaths: readonly string[];
+            specCompliance: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            codeQuality: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            repositoryId?: string | undefined;
+        }>;
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "verifier";
+        status: "evidence_gap";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        missingEvidenceKinds: readonly ("verification" | "red" | "green" | "refactor" | "approval" | "artifact-summary")[];
+        taskReview: Readonly<{
+            schemaVersion: "1.0.0";
+            reviewId: string;
+            runId: string & z.core.$brand<"RunId">;
+            taskId: string & z.core.$brand<"TaskId">;
+            requirementId: string;
+            acceptanceCriterionIds: readonly string[];
+            status: "failed" | "passed";
+            summary: string;
+            changedPaths: readonly string[];
+            specCompliance: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            codeQuality: Readonly<{
+                verdict: "pass" | "fail";
+                summary: string;
+                findings: readonly Readonly<{
+                    severity: "critical" | "important" | "advisory";
+                    category: "spec-compliance" | "code-quality";
+                    message: string;
+                    changedPath?: string | undefined;
+                }>[];
+            }>;
+            repositoryId?: string | undefined;
+        }>;
+    }>>;
+};
+export declare const AcceptanceOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "AcceptanceOutput";
+    readonly requiredFields: readonly ["schemaVersion", "role", "status", "summary", "evidenceIds"];
+    readonly example: Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "acceptance";
+        status: "accepted";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "acceptance";
+        status: "failed";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+    }>> | Readonly<Readonly<{
+        schemaVersion: "1.0.0";
+        role: "acceptance";
+        status: "evidence_gap";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        missingEvidenceKinds: readonly ("verification" | "red" | "green" | "refactor" | "approval" | "artifact-summary")[];
+    }>>;
+};
+export declare const FailureAnalyzerOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "FailureAnalyzerOutput";
+    readonly requiredFields: readonly ["schemaVersion", "role", "action", "summary", "evidenceIds", "category"];
+    readonly example: Readonly<{
+        schemaVersion: "1.0.0";
+        role: "failure-analyzer";
+        action: "repair";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        category: "implementation-defect";
+        confirmedRootCause: true;
+    }> | Readonly<{
+        schemaVersion: "1.0.0";
+        role: "failure-analyzer";
+        action: "probe";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        category: "context-gap" | "implementation-defect" | "verification-environment";
+        diagnosticProbe: Readonly<{
+            summary: string;
+            verificationCommand: Readonly<{
+                name: string;
+                command: string;
+                workingDirectory: string;
+                scope: "task";
+                sideEffectLevel: "read_only";
+                timeoutMs: number;
+                args?: readonly string[] | undefined;
+                origin?: "failure-analyzer" | undefined;
+                requiresConfirmation?: false | undefined;
+                confirmation?: undefined;
+                allowedEnv?: Readonly<Record<string, string>> | undefined;
+            }>;
+        }>;
+    }> | Readonly<{
+        schemaVersion: "1.0.0";
+        role: "failure-analyzer";
+        action: "clarify";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        category: "context-gap" | "requirement-ambiguity";
+        missingContext: readonly string[];
+    }> | Readonly<{
+        schemaVersion: "1.0.0";
+        role: "failure-analyzer";
+        action: "wait";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        category: "dependency-blocked";
+        blockedDependency: string;
+    }> | Readonly<{
+        schemaVersion: "1.0.0";
+        role: "failure-analyzer";
+        action: "terminate";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        category: "verification-environment" | "model-failure";
+    }>;
+};
+export declare const RepairWorkerOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "RepairWorkerOutput";
+    readonly requiredFields: readonly ["schemaVersion", "role", "status", "summary", "evidenceIds", "repairTask"];
+    readonly example: Readonly<{
+        schemaVersion: "1.0.0";
+        role: "repair-worker";
+        status: "planned";
+        summary: string;
+        evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+        repairTask: Readonly<{
+            schemaVersion: "1.0.0";
+            repairTaskId: string;
+            version: number;
+            sourceTaskId: string & z.core.$brand<"TaskId">;
+            sourceFailureId: string;
+            rootCauseFingerprint: string;
+            summary: string;
+            allowedPaths: readonly string[];
+            acceptanceCriterionIds: readonly string[];
+            retryBudget: Readonly<{
+                maxAttempts: number;
+                maxRepairAttempts: number;
+            }>;
+            failureEvidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+            verificationPlan: Readonly<{
+                minimalFailureSet: readonly Readonly<{
+                    name: string;
+                    command: string;
+                    workingDirectory: string;
+                    scope: "task" | "project" | "integration";
+                    sideEffectLevel: "read_only" | "workspace_write" | "external_side_effect";
+                    timeoutMs: number;
+                    args?: readonly string[] | undefined;
+                    origin?: "config" | "planner" | "worker" | "failure-analyzer" | "repair" | undefined;
+                    requiresConfirmation?: boolean | undefined;
+                    confirmation?: Readonly<{
+                        approvedBy: string;
+                        reason: string;
+                    }> | undefined;
+                    allowedEnv?: Readonly<Record<string, string>> | undefined;
+                }>[];
+                fullVerification: readonly Readonly<{
+                    name: string;
+                    command: string;
+                    workingDirectory: string;
+                    scope: "task" | "project" | "integration";
+                    sideEffectLevel: "read_only" | "workspace_write" | "external_side_effect";
+                    timeoutMs: number;
+                    args?: readonly string[] | undefined;
+                    origin?: "config" | "planner" | "worker" | "failure-analyzer" | "repair" | undefined;
+                    requiresConfirmation?: boolean | undefined;
+                    confirmation?: Readonly<{
+                        approvedBy: string;
+                        reason: string;
+                    }> | undefined;
+                    allowedEnv?: Readonly<Record<string, string>> | undefined;
+                }>[];
+            }>;
+            phaseEvidenceKinds: ["red", "green", "refactor"];
+            repositoryId?: string | undefined;
+        }>;
+    }>;
+};
+export declare const RunAcceptanceOutputContract: {
+    readonly schemaVersion: "1.0.0";
+    readonly type: "RunAcceptance";
+    readonly requiredFields: readonly ["schemaVersion", "acceptanceId", "runId", "status", "summary", "criterionDecisions"];
+    readonly example: Readonly<{
+        schemaVersion: "1.0.0";
+        acceptanceId: string;
+        runId: string & z.core.$brand<"RunId">;
+        status: "unknown" | "accepted" | "blocked" | "waived";
+        summary: string;
+        criterionDecisions: readonly Readonly<{
+            criterionId: string;
+            requirementId: string;
+            status: "unknown" | "accepted" | "blocked" | "waived";
+            taskIds: readonly (string & z.core.$brand<"TaskId">)[];
+            taskReviewIds: readonly string[];
+            evidenceIds: readonly (string & z.core.$brand<"EvidenceId">)[];
+            failureIds: readonly string[];
+            waiverIds: readonly string[];
+            changedPaths: readonly string[];
+            summary: string;
+        }>[];
+        legacyCompletedWithoutTrustworthyAcceptance: boolean;
+        repositoryId?: string | undefined;
+    }>;
+};
+//# sourceMappingURL=agent-output-contracts.d.ts.map