@cat-factory/orchestration 0.327.0 → 0.329.0

package/dist/modules/execution/ExecutionService.d.ts

@@ -65,6 +65,7 @@ export declare class ExecutionService {
     private readonly startStepDispatch;
     /** The pre-dispatch input gate; see {@link InputGateController}. */
     private readonly inputGate;
+    private readonly credentialWait;
     /** Bound collaborators for the shared pre-dispatch preamble ({@link runStepPreamble}). */
     private stepPreambleDepsCache?;
     /** The three doors onto "what personal subscriptions would a run started here lease". */
@@ -247,6 +248,1235 @@ export declare class ExecutionService {
      * otherwise performs one agent step via the shared {@link stepInstance} logic.
      */
     advanceInstance(workspaceId: string, executionId: string, options?: AdvanceOptions): Promise<AdvanceResult>;
+    /** Resume a step parked on a lapsed personal credential; see {@link CredentialWaitController}. */
+    resumeCredentialWait(ws: string, id: string, actor: string | null, renew: () => Promise<void>): Promise<{
+        projected?: boolean | undefined;
+        id: string;
+        blockId: string;
+        pipelineId: string;
+        pipelineName: string;
+        steps: {
+            runId?: string | undefined;
+            agentKind: string;
+            state: "done" | "pending" | "waiting_decision" | "working";
+            progress: number;
+            metrics?: {
+                calls: number;
+                promptTokens: number;
+                cacheReadTokens?: number | undefined;
+                cacheWriteTokens?: number | undefined;
+                completionTokens: number;
+                peakCompletionTokens: number;
+                maxOutputTokens: number | null;
+                truncatedCalls: number;
+                upstreamMs: number;
+                overheadMs: number;
+                errors: number;
+                warnings: number;
+                carryCostTokens?: number | undefined;
+                costEstimate?: number | null | undefined;
+                costCurrency?: string | undefined;
+                byPhase?: {
+                    phase: string;
+                    calls: number;
+                    promptTokens: number;
+                    cacheReadTokens: number;
+                    cacheWriteTokens: number;
+                    completionTokens: number;
+                    carryCostTokens: number;
+                    errors: number;
+                    costEstimate?: number | null | undefined;
+                }[] | undefined;
+            } | null | undefined;
+            usageBilling?: "metered" | "subscription" | undefined;
+            gate?: {
+                phase: "checking" | "working";
+                attempts: number;
+                maxAttempts: number;
+                headSha?: string | null | undefined;
+                headShas?: {
+                    [x: string]: string;
+                } | null | undefined;
+                conflictTarget?: {
+                    repo: string;
+                    frameId?: string | undefined;
+                    branch?: string | undefined;
+                } | null | undefined;
+                lastVerdict?: "fail" | "pass" | "pending" | null | undefined;
+                config?: {
+                    [x: string]: string | number | boolean | string[];
+                } | null | undefined;
+                lastFailureSummary?: string | null | undefined;
+                failingChecks?: {
+                    name: string;
+                    conclusion: string | null;
+                    url?: string | null | undefined;
+                    repo?: string | undefined;
+                }[] | null | undefined;
+                lastDispatchedInstructions?: string | null | undefined;
+                watchSince?: number | null | undefined;
+                watchWindowMinutes?: number | null | undefined;
+                regressedSignals?: {
+                    kind: "monitor" | "slo";
+                    id: string;
+                    name: string;
+                    state: "alert" | "no_data" | "ok" | "warn";
+                    detail?: string | undefined;
+                }[] | null | undefined;
+                attemptLog?: {
+                    attempt: number;
+                    at: number;
+                    outcome: "completed" | "failed";
+                    headSha?: string | null | undefined;
+                    instructions?: string | null | undefined;
+                    failingChecks?: {
+                        name: string;
+                        conclusion: string | null;
+                        url?: string | null | undefined;
+                        repo?: string | undefined;
+                    }[] | null | undefined;
+                    summary?: string | null | undefined;
+                }[] | null | undefined;
+                lastApprovals?: number | null | undefined;
+                requiredApprovingReviewCount?: number | null | undefined;
+                pendingThreadIds?: string[] | null | undefined;
+                lastAddressedCommentAt?: number | null | undefined;
+                humanReviewGraceMinutes?: number | null | undefined;
+                pendingFix?: {
+                    instructions: string;
+                    at: number;
+                } | null | undefined;
+            } | null | undefined;
+            test?: {
+                phase: "fixing" | "testing";
+                attempts: number;
+                maxAttempts: number;
+                lastReport?: {
+                    greenlight: boolean;
+                    summary: string;
+                    tested: string[];
+                    outcomes: {
+                        name: string;
+                        status: "failed" | "passed" | "skipped";
+                        detail?: string | undefined;
+                    }[];
+                    concerns: {
+                        title: string;
+                        detail: string;
+                        severity: "critical" | "high" | "low" | "medium";
+                    }[];
+                    requirementVerdicts?: {
+                        requirementId: string;
+                        status: "met" | "not_covered" | "not_met";
+                        detail?: string | undefined;
+                    }[] | undefined;
+                    environment?: "ephemeral" | "local" | undefined;
+                    screenshots?: {
+                        view: string;
+                        artifactId: string;
+                        hash?: string | undefined;
+                        width?: number | undefined;
+                        height?: number | undefined;
+                        referenceArtifactId?: string | undefined;
+                    }[] | undefined;
+                    abort?: {
+                        reason: string;
+                    } | null | undefined;
+                } | null | undefined;
+                attemptLog?: {
+                    attempt: number;
+                    at: number;
+                    outcome: "completed" | "failed";
+                    summary?: string | null | undefined;
+                    concerns?: {
+                        title: string;
+                        detail: string;
+                        severity: "critical" | "high" | "low" | "medium";
+                    }[] | null | undefined;
+                }[] | null | undefined;
+                infraSetup?: {
+                    started: boolean;
+                    dockerAvailable?: boolean | null | undefined;
+                    dockerWorkload?: "undetermined" | "unusable" | "usable" | null | undefined;
+                    dockerEgress?: "blocked" | "reachable" | "undetermined" | null | undefined;
+                    composePath?: string | null | undefined;
+                    at: number;
+                    durationMs?: number | null | undefined;
+                    logs?: string | null | undefined;
+                    error?: string | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            testerQuality?: {
+                enabled: boolean;
+                attempts: number;
+                maxAttempts: number;
+                gating?: {
+                    enabled: boolean;
+                    minComplexity?: number | undefined;
+                    minRisk?: number | undefined;
+                    minImpact?: number | undefined;
+                    onMissingEstimate: "run" | "skip";
+                } | null | undefined;
+                verdicts: {
+                    adequate: boolean;
+                    feedback: string;
+                    gaps: string[];
+                    at: number;
+                    model?: string | null | undefined;
+                }[];
+                exceeded?: boolean | undefined;
+            } | null | undefined;
+            humanTest?: {
+                phase: "awaiting_human" | "fixing" | "passed" | "provisioning" | "resolving_conflicts";
+                environment?: {
+                    id: string;
+                    url: string | null;
+                    status: "expired" | "failed" | "provisioning" | "ready" | "tearing_down" | "torn_down";
+                    expiresAt?: number | null | undefined;
+                } | null | undefined;
+                degradedReason?: string | null | undefined;
+                attempts: number;
+                maxAttempts: number;
+                headSha?: string | null | undefined;
+                rounds?: {
+                    kind: "fix" | "pull-main";
+                    findings: string;
+                    helperKind: string;
+                    jobId?: string | null | undefined;
+                    outcome?: "completed" | "failed" | null | undefined;
+                    at: number;
+                }[] | undefined;
+                pendingAction?: {
+                    type: "confirm" | "pull-main" | "recreate" | "request-fix";
+                    findings?: string | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            visualConfirm?: {
+                phase: "approved" | "awaiting_human" | "fixing";
+                pairs?: {
+                    view: string;
+                    actualArtifactId?: string | null | undefined;
+                    referenceArtifactId?: string | null | undefined;
+                    referenceOrigin?: "design" | "upload" | null | undefined;
+                }[] | undefined;
+                degradedReason?: string | null | undefined;
+                designReferences?: {
+                    documents: number;
+                    images: number;
+                    dropped?: number | undefined;
+                    gaps?: {
+                        title: string;
+                        reason: "failed" | "none" | "not_retained" | "partial" | "storage_unavailable" | null;
+                        dropped?: number | undefined;
+                    }[] | undefined;
+                } | null | undefined;
+                attempts: number;
+                maxAttempts: number;
+                rounds?: {
+                    findings: string;
+                    helperKind: string;
+                    jobId?: string | null | undefined;
+                    outcome?: "completed" | "failed" | null | undefined;
+                    at: number;
+                }[] | undefined;
+                pendingAction?: {
+                    type: "approve" | "recapture" | "request-fix";
+                    findings?: string | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            environment?: {
+                id: string;
+                url: string | null;
+                status: "expired" | "failed" | "provisioning" | "ready" | "tearing_down" | "torn_down";
+                expiresAt?: number | null | undefined;
+                lastError?: string | null | undefined;
+                statusNote?: string | null | undefined;
+                provisionType?: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes" | null | undefined;
+                engine?: "cloudflare" | "local-docker" | "local-k3s" | "none" | "remote-custom" | "remote-kubernetes" | null | undefined;
+            } | null | undefined;
+            subtasks?: {
+                completed: number;
+                inProgress: number;
+                total: number;
+                items?: {
+                    label: string;
+                    status: "completed" | "in_progress" | "pending";
+                }[] | undefined;
+            } | undefined;
+            container?: {
+                status: "destroyed" | "errored" | "starting" | "up";
+                phase?: string | null | undefined;
+                id?: string | null | undefined;
+                url?: string | null | undefined;
+            } | null | undefined;
+            delegated?: {
+                executor: string;
+                status: "cancelled" | "done" | "failed" | "running" | "starting";
+                correlationKey: string;
+                poll?: {
+                    intervalMs: number;
+                    maxDurationMs: number;
+                } | null | undefined;
+                externalId?: string | null | undefined;
+                url?: string | null | undefined;
+                phase?: string | null | undefined;
+                branches?: {
+                    base: string;
+                    work: string;
+                } | null | undefined;
+                repo?: {
+                    owner: string;
+                    name: string;
+                } | null | undefined;
+                branch?: string | null | undefined;
+                attempts: {
+                    startedAt: number;
+                    externalId?: string | null | undefined;
+                    url?: string | null | undefined;
+                    outcome?: string | null | undefined;
+                    usageReported?: boolean | undefined;
+                }[];
+                note?: string | null | undefined;
+            } | null | undefined;
+            search?: {
+                available: boolean;
+                provider: "brave" | "searxng" | null;
+            } | null | undefined;
+            decision: {
+                id: string;
+                question: string;
+                options: string[];
+                chosen: string | null;
+            } | null;
+            requiresApproval?: boolean | undefined;
+            approval?: {
+                id: string;
+                status: "approved" | "changes_requested" | "pending" | "rejected";
+                proposal: string;
+                feedback?: string | undefined;
+                comments?: {
+                    quotedSource?: string | undefined;
+                    srcStart?: number | undefined;
+                    srcEnd?: number | undefined;
+                    anchorId?: string | undefined;
+                    severity?: "blocker" | "major" | "minor" | undefined;
+                    body: string;
+                }[] | undefined;
+                requiredApprovals?: number | undefined;
+                approverPolicy?: {
+                    roles?: ("admin" | "member" | "viewer")[] | undefined;
+                    userIds?: string[] | undefined;
+                } | undefined;
+                approvals?: {
+                    actorId: string;
+                    actorLabel?: string | undefined;
+                    at: number;
+                }[] | undefined;
+            } | null | undefined;
+            companion?: {
+                threshold: number;
+                maxAttempts: number;
+                attempts: number;
+                verdicts: {
+                    rating: number;
+                    threshold: number;
+                    passed: boolean;
+                    feedback: string;
+                    comments?: {
+                        quotedSource?: string | undefined;
+                        srcStart?: number | undefined;
+                        srcEnd?: number | undefined;
+                        anchorId?: string | undefined;
+                        severity?: "blocker" | "major" | "minor" | undefined;
+                        body: string;
+                    }[] | undefined;
+                }[];
+                exceeded?: boolean | undefined;
+                capSettledByPolicy?: boolean | undefined;
+                stalled?: boolean | undefined;
+            } | null | undefined;
+            reviewCapSettledByPolicy?: boolean | undefined;
+            autoAnsweredByPolicy?: boolean | undefined;
+            followUps?: {
+                enabled: boolean;
+                items: {
+                    id: string;
+                    kind: "follow_up" | "question";
+                    title: string;
+                    detail: string;
+                    suggestedAction?: string | null | undefined;
+                    status: "answered" | "closed" | "dismissed" | "filed" | "pending" | "queued";
+                    answer?: string | null | undefined;
+                    sentToCoder?: boolean | undefined;
+                    dismissedByPolicy?: boolean | undefined;
+                    sendBackDropped?: boolean | undefined;
+                    ticketExternalId?: string | null | undefined;
+                    ticketUrl?: string | null | undefined;
+                    createdAt: number;
+                    updatedAt: number;
+                }[];
+                loops: number;
+                maxLoops: number;
+            } | null | undefined;
+            forkDecision?: {
+                status: "answering" | "awaiting_choice" | "chosen" | "proposing" | "single_path" | "skipped";
+                seamSummary?: string | null | undefined;
+                forks: {
+                    id: string;
+                    title: string;
+                    summary: string;
+                    approach: string;
+                    tradeoffs: string[];
+                    riskNotes?: string | null | undefined;
+                    recommended?: boolean | undefined;
+                }[];
+                singlePathReason?: string | null | undefined;
+                chat: {
+                    id: string;
+                    role: "assistant" | "human";
+                    text: string;
+                    createdAt: number;
+                }[];
+                maxChatTurns: number;
+                chosen?: {
+                    forkId?: string | null | undefined;
+                    custom?: string | null | undefined;
+                    note?: string | null | undefined;
+                    at: number;
+                } | null | undefined;
+                model?: string | null | undefined;
+            } | null | undefined;
+            judge?: {
+                status: "awaiting_decision" | "bouncing" | "evaluating" | "failed" | "passed" | "skipped";
+                rubricId?: string | null | undefined;
+                rubricName?: string | null | undefined;
+                rubricOverridden: boolean;
+                verdict?: {
+                    score: number;
+                    summary: string;
+                    findings: {
+                        title: string;
+                        detail?: string | undefined;
+                        severity: "critical" | "high" | "low" | "medium";
+                        where?: string | undefined;
+                    }[];
+                } | null | undefined;
+                threshold?: number | null | undefined;
+                disposition?: "bounce" | "fail" | "park" | "pass" | null | undefined;
+                bounces: number;
+                maxBounces: number;
+                model?: string | null | undefined;
+                modelPin?: {
+                    requested: string;
+                    status: "applied" | "overridden" | "unavailable";
+                } | null | undefined;
+                rounds: {
+                    round: number;
+                    at: number;
+                    verdict: {
+                        score: number;
+                        summary: string;
+                        findings: {
+                            title: string;
+                            detail?: string | undefined;
+                            severity: "critical" | "high" | "low" | "medium";
+                            where?: string | undefined;
+                        }[];
+                    };
+                    disposition: "bounce" | "fail" | "park" | "pass";
+                    model?: string | null | undefined;
+                }[];
+                note?: string | null | undefined;
+                capSettledByPolicy?: boolean | undefined;
+                resolution?: {
+                    choice: "bounce" | "proceed" | "stop";
+                    feedback?: string | null | undefined;
+                    at: number;
+                } | null | undefined;
+            } | null | undefined;
+            ralph?: {
+                phase: "iterating";
+                attempts: number;
+                maxIterations: number;
+                validationCommand: string;
+                progressPath?: string | null | undefined;
+                lastExitCode?: number | null | undefined;
+                lastValidationTail?: string | null | undefined;
+                noProgressStreak?: number | null | undefined;
+                attemptLog?: {
+                    attempt: number;
+                    at: number;
+                    validationPassed: boolean;
+                    exitCode?: number | null | undefined;
+                    outputTail?: string | null | undefined;
+                    summary?: string | null | undefined;
+                    headSha?: string | null | undefined;
+                }[] | null | undefined;
+                droppedAttempts?: number | null | undefined;
+            } | null | undefined;
+            validation?: {
+                passed: boolean;
+                attempts: number;
+                maxAttempts: number;
+                outcomes: {
+                    label: string;
+                    command: string;
+                    exitCode: number;
+                    passed: boolean;
+                    outputTail?: string | undefined;
+                    durationMs?: number | undefined;
+                    timedOut?: boolean | undefined;
+                }[];
+                at?: number | undefined;
+            } | null | undefined;
+            validationConfigUnreadable?: boolean | null | undefined;
+            reproduction?: {
+                status: "declared_infeasible" | "inconclusive" | "reproduced";
+                command: string;
+                testPaths: string[];
+                omittedTestPaths?: number | undefined;
+                base?: {
+                    exitCode: number;
+                    passed: boolean;
+                    outputTail?: string | undefined;
+                    durationMs?: number | undefined;
+                    timedOut?: boolean | undefined;
+                    setupFailed?: boolean | undefined;
+                } | undefined;
+                final?: {
+                    exitCode: number;
+                    passed: boolean;
+                    outputTail?: string | undefined;
+                    durationMs?: number | undefined;
+                    timedOut?: boolean | undefined;
+                    setupFailed?: boolean | undefined;
+                } | undefined;
+                attempts: number;
+                maxAttempts: number;
+                reason?: string | undefined;
+                alternativeVerification?: string | undefined;
+                note?: string | undefined;
+                at: number;
+            } | null | undefined;
+            pendingForkChat?: {
+                messageId: string;
+            } | null | undefined;
+            prReview?: {
+                status: "awaiting_selection" | "challenging" | "done" | "fixing" | "posting" | "reviewing" | "skipped";
+                summary?: string | null | undefined;
+                slices: {
+                    id: string;
+                    title: string;
+                    rationale: string;
+                    paths: string[];
+                }[];
+                sliceReviews: {
+                    label: string;
+                    status: "completed" | "in_progress";
+                    report?: string | null | undefined;
+                }[];
+                resumeAttempts: number;
+                resumePendingSlices?: string[] | undefined;
+                findings: {
+                    id: string;
+                    sliceId?: string | null | undefined;
+                    path: string;
+                    line?: number | null | undefined;
+                    side?: "LEFT" | "RIGHT" | null | undefined;
+                    severity: "blocker" | "high" | "low" | "medium" | "nit";
+                    category: "correctness" | "maintainability" | "other" | "performance" | "security" | "style" | "test";
+                    title: string;
+                    detail: string;
+                    suggestedFix?: string | null | undefined;
+                    challenge?: {
+                        status: "amended" | "failed" | "investigating" | "queued" | "retracted" | "upheld";
+                        question?: string | null | undefined;
+                        justification?: string | null | undefined;
+                    } | null | undefined;
+                }[];
+                selectedFindingIds: string[];
+                resolution?: "finish" | "fix" | "post" | null | undefined;
+                prUrl?: string | null | undefined;
+                model?: string | null | undefined;
+                reviewedHeadSha?: string | null | undefined;
+                postReport?: {
+                    attempted: number;
+                    posted: number;
+                    folded: number;
+                    bodyPosted?: boolean | null | undefined;
+                    bodyError?: string | null | undefined;
+                    failures: {
+                        findingId: string;
+                        path: string;
+                        line?: number | null | undefined;
+                        reason: string;
+                    }[];
+                    attempt?: number | undefined;
+                } | null | undefined;
+                postedFindingIds: string[];
+                postedBody: boolean;
+                postAttempts: number;
+            } | null | undefined;
+            bugFishing?: {
+                status: "awaiting_triage" | "done" | "fishing";
+                phases: {
+                    id: string;
+                    title: string;
+                    goal: string;
+                    status: "completed" | "failed" | "fishing" | "pending";
+                    summary?: string | null | undefined;
+                    settledAt?: number | null | undefined;
+                    failureReason?: string | null | undefined;
+                    territoryId?: string | null | undefined;
+                    territoryLabel?: string | null | undefined;
+                    coverage?: {
+                        filesRead: number;
+                        manifestFiles: number;
+                        offManifest: number;
+                        source: "self-reported";
+                    } | null | undefined;
+                    outOfScopeFindings?: number | undefined;
+                }[];
+                currentPhaseIndex: number;
+                findings: {
+                    id: string;
+                    phaseId: string;
+                    territoryId?: string | null | undefined;
+                    path: string;
+                    line?: number | null | undefined;
+                    severity: "critical" | "high" | "low" | "medium";
+                    kind: "bug" | "edge-case" | "footgun" | "logic-gap" | "other" | "requirement-gap";
+                    confidence: "high" | "low" | "medium";
+                    title: string;
+                    detail: string;
+                    failureScenario?: string | null | undefined;
+                    evidence?: string | null | undefined;
+                    suggestedFix?: string | null | undefined;
+                    spawn?: {
+                        status: "failed" | "pending" | "spawned";
+                        taskId: string;
+                        executionId?: string | null | undefined;
+                        pipelineId: string;
+                        requestedBy?: string | null | undefined;
+                        requestedAt: number;
+                        failureReason?: string | null | undefined;
+                    } | null | undefined;
+                    dismissed: boolean;
+                }[];
+                territories?: {
+                    id: string;
+                    label: string;
+                    roots: string[];
+                    fileCount: number;
+                    approxTokens: number;
+                    source: "blueprint" | "directory" | "whole-codebase";
+                    subtreeShas: string[];
+                }[] | undefined;
+                plan?: {
+                    passBudget: number;
+                    plannedCells: number;
+                    unfished: {
+                        territoryId: string;
+                        territoryLabel: string;
+                        phaseId: string;
+                        phaseTitle: string;
+                    }[];
+                    treeTruncated: boolean;
+                    surveyUnavailableReason?: string | null | undefined;
+                } | null | undefined;
+                model?: string | null | undefined;
+                defaultFixPipelineId?: string | null | undefined;
+            } | null | undefined;
+            pendingPrReviewPost?: boolean | null | undefined;
+            challengeJobs?: {
+                findingId: string;
+                question?: string | null | undefined;
+                epoch?: number | undefined;
+                jobId?: string | undefined;
+                model?: string | undefined;
+                subscriptionTokenId?: string | undefined;
+                initiatedByUserId?: string | undefined;
+                evictionRecoveries?: number | undefined;
+            }[] | undefined;
+            rework?: {
+                previousProposal: string;
+                feedback: string;
+                comments?: {
+                    quotedSource?: string | undefined;
+                    srcStart?: number | undefined;
+                    srcEnd?: number | undefined;
+                    anchorId?: string | undefined;
+                    severity?: "blocker" | "major" | "minor" | undefined;
+                    body: string;
+                }[] | undefined;
+                requestedBy: "human" | "reviewer";
+            } | null | undefined;
+            pendingIncorporation?: {
+                feedback?: string | undefined;
+                after?: "proceed" | "rereview" | undefined;
+            } | null | undefined;
+            pendingRecommendation?: {
+                itemIds: string[];
+                note?: string | undefined;
+            } | null | undefined;
+            pendingInterview?: {
+                proceed?: boolean | undefined;
+            } | null | undefined;
+            consensus?: {
+                enabled: boolean;
+                strategy: "debate" | "ranked-voting" | "specialist-panel";
+                participants: {
+                    id: string;
+                    role: string;
+                    systemFraming?: string | undefined;
+                    modelId?: string | undefined;
+                }[];
+                synthesizerModelId?: string | undefined;
+                rounds?: number | undefined;
+                gating?: {
+                    enabled: boolean;
+                    minComplexity?: number | undefined;
+                    minRisk?: number | undefined;
+                    minImpact?: number | undefined;
+                    onMissingEstimate: "consensus" | "standard";
+                } | undefined;
+                groupIds?: string[] | undefined;
+                selectedGroup?: {
+                    id: string;
+                    name: string;
+                } | undefined;
+            } | null | undefined;
+            gating?: {
+                enabled: boolean;
+                minComplexity?: number | undefined;
+                minRisk?: number | undefined;
+                minImpact?: number | undefined;
+                onMissingEstimate: "run" | "skip";
+            } | null | undefined;
+            stepOptions?: {
+                autoRecommend?: boolean | undefined;
+                skillId?: string | undefined;
+                maxOutputTokens?: number | undefined;
+                agentVariantId?: string | undefined;
+                binaryOutput?: {
+                    storageServiceId: string;
+                    contextServiceIds?: string[] | undefined;
+                    generatorIds?: string[] | undefined;
+                    modalities?: ("3d-model" | "3d-scene" | "audio" | "document" | "image" | "video")[] | undefined;
+                    mediaTypes?: string[] | undefined;
+                    generation?: import("@cat-factory/contracts").BinaryGenerationOptions | undefined;
+                    comparison?: {
+                        perGenerator?: number | undefined;
+                        multiSelect?: true | undefined;
+                    } | undefined;
+                } | undefined;
+                retainEnvironment?: boolean | undefined;
+                deployFix?: {
+                    enabled?: boolean | undefined;
+                    maxAttempts?: number | undefined;
+                } | undefined;
+                environmentInvestigation?: import("@cat-factory/contracts").EnvironmentInvestigationConfig | undefined;
+                gateConfig?: {
+                    approvers?: {
+                        roles?: ("admin" | "member" | "viewer")[] | undefined;
+                        userIds?: string[] | undefined;
+                    } | undefined;
+                    minApprovals?: number | undefined;
+                    fields?: {
+                        [x: string]: string | number | boolean | string[];
+                    } | undefined;
+                } | undefined;
+                condition?: {
+                    serviceScope: "backend" | "frontend";
+                } | undefined;
+            } | null | undefined;
+            skipped?: boolean | undefined;
+            skipReason?: "condition" | "gated" | "no_pull_request" | "producer_skipped" | "run_complete" | undefined;
+            noBusinessSpecs?: boolean | undefined;
+            technicalCorroborated?: boolean | undefined;
+            output?: string | undefined;
+            outputIsRendered?: boolean | undefined;
+            custom?: unknown;
+            hasOutput?: boolean | undefined;
+            model?: string | undefined;
+            subscriptionTokenId?: string | undefined;
+            initiatedByUserId?: string | undefined;
+            selectedFragmentIds?: string[] | undefined;
+            fragmentAdherence?: {
+                fragmentId?: string | undefined;
+                title?: string | undefined;
+                rating: number;
+                assessment: string;
+                relatedFindings: string[];
+            }[] | undefined;
+            effortReport?: {
+                difficulty: number;
+                summary?: string | undefined;
+                reducedEffectiveness?: string | undefined;
+                obstacles?: string[] | undefined;
+            } | undefined;
+            skillVersions?: {
+                skillId: string;
+                commit: string | null;
+                sha: string;
+            }[] | undefined;
+            toolServers?: {
+                wired: {
+                    id: string;
+                    label: string;
+                    transport: "http" | "stdio";
+                    tools?: string[] | undefined;
+                }[];
+                unavailable: {
+                    id: string;
+                    label: string;
+                    reason: "consensus_panel" | "harness_unsupported" | "missing_secret" | "oauth_not_connected" | "oauth_token_failed" | "over_budget" | "reserved_secret" | "transport_unsupported" | "unusable_secret";
+                }[];
+                agentKind: string;
+                observed?: {
+                    id: string;
+                    status: "failed" | "needs_auth" | "ready" | "unknown";
+                    toolCount?: number | undefined;
+                }[] | undefined;
+            } | undefined;
+            contextDocuments?: {
+                title: string;
+                externalId: string;
+                url: string;
+                origin: "confluence" | "figma" | "github" | "linear" | "notion" | "upload" | "zeplin";
+                freshness?: {
+                    status: "confirmed";
+                    version: string;
+                    change: "reimported" | "revision_only" | "unchanged";
+                } | {
+                    status: "not-applicable";
+                } | {
+                    status: "unconfirmed";
+                    reason: "credentials_unreadable" | "not_connected" | "source_unreachable" | "unversioned";
+                } | undefined;
+            }[] | undefined;
+            promptRevision?: number | undefined;
+            promptVariant?: {
+                id: string;
+                applied: "addition-only" | "full" | "superseded" | "withdrawn";
+                fingerprint?: string | undefined;
+            } | undefined;
+            foundationalServices?: {
+                declared: string[];
+                unknown: string[];
+            } | undefined;
+            binaryOutputs?: {
+                stored: {
+                    service: string;
+                    location: string;
+                    entity?: string | undefined;
+                    contentType?: string | undefined;
+                    description?: string | undefined;
+                    dimensions?: {
+                        width: number;
+                        height: number;
+                    } | undefined;
+                    generator?: string | undefined;
+                    processedBy?: string | undefined;
+                    modality?: "3d-model" | "3d-scene" | "audio" | "document" | "image" | "video" | undefined;
+                }[];
+                unknownServices: string[];
+                unknownGenerators: string[];
+                generatorsUnverified?: true | undefined;
+                invalidEntries: number;
+                omitted: number;
+                parseFailed?: boolean | undefined;
+                undeclared?: boolean | undefined;
+            } | undefined;
+            binaryCandidates?: {
+                status: "awaiting_choice" | "chosen" | "no_choice";
+                candidates: {
+                    id: string;
+                    label?: string | undefined;
+                    generator?: string | undefined;
+                    subject?: string | undefined;
+                    service: string;
+                    location: string;
+                    contentType?: string | undefined;
+                    previewUrl?: string | undefined;
+                    note?: string | undefined;
+                }[];
+                noChoiceReason?: "no_candidates" | "parse_failed" | "undeclared" | null | undefined;
+                choice?: {
+                    kept: {
+                        candidateId: string;
+                        storeAs?: string | undefined;
+                    }[];
+                    discarded: string[];
+                    note?: string | null | undefined;
+                    automatic?: true | undefined;
+                    at: number;
+                } | null | undefined;
+                multiSelect?: boolean | undefined;
+                invalidEntries: number;
+                omitted: number;
+                unusablePreviews: number;
+            } | null | undefined;
+            credentialWait?: {
+                raisedAt: number;
+            } | null | undefined;
+            jobId?: string | undefined;
+            startedAt?: number | null | undefined;
+            finishedAt?: number | null | undefined;
+            firstStartedAt?: number | null | undefined;
+            attempts?: number | undefined;
+            dispatches?: {
+                agentKind: string;
+                count: number;
+            }[] | undefined;
+            lastActivityAt?: number | null | undefined;
+            pausedAt?: number | null | undefined;
+            evictionRecoveries?: number | undefined;
+            transientEvictionRecoveries?: number | undefined;
+            branchContentionRecoveries?: number | undefined;
+            delegatedRetries?: number | undefined;
+            firstEvictionDetail?: string | undefined;
+            deployProvisioning?: {
+                type: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes";
+                manifestSource?: {
+                    type: "colocated";
+                    path: string;
+                    renderer?: "kustomize" | "raw" | undefined;
+                } | {
+                    type: "separate";
+                    repo: string;
+                    ref?: string | undefined;
+                    path: string;
+                    renderer?: "kustomize" | "raw" | undefined;
+                } | undefined;
+                composePath?: string | undefined;
+                localDevOnly?: boolean | undefined;
+                composeBuild?: boolean | undefined;
+                recipe?: {
+                    composeFiles?: (string | {
+                        kind: "path";
+                        path: string;
+                    } | {
+                        kind: "inline";
+                        content: string;
+                        path?: string | undefined;
+                    } | {
+                        kind: "repo";
+                        repo: string;
+                        path: string;
+                        ref?: string | undefined;
+                        provider?: "github" | "gitlab" | undefined;
+                    })[] | undefined;
+                    composeProfiles?: string[] | undefined;
+                    envFiles?: {
+                        template: string;
+                        target: string;
+                    }[] | undefined;
+                    externalNetworks?: string[] | undefined;
+                    sharedStackRefs?: string[] | undefined;
+                    prerequisites?: {
+                        check: "disk-space" | "docker-daemon" | "env-secrets-marker" | "hosts-entries" | "http-reachable" | "memory" | "mkcert-ca" | "registry-auth" | "tcp-reachable";
+                        params?: {
+                            minGib?: number | undefined;
+                            registry?: string | undefined;
+                            host?: string | undefined;
+                            port?: number | undefined;
+                            url?: string | undefined;
+                            expectStatus?: number | undefined;
+                            expectBodyContains?: string | undefined;
+                            hostnames?: string[] | undefined;
+                            file?: string | undefined;
+                            marker?: string | undefined;
+                        } | undefined;
+                        required?: boolean | undefined;
+                        remediation?: string | undefined;
+                        label?: string | undefined;
+                    }[] | undefined;
+                    setupSteps?: ({
+                        kind: "compose-exec";
+                        name: string;
+                        service: string;
+                        command: string[];
+                        stdinFile?: string | undefined;
+                        user?: string | undefined;
+                        workdir?: string | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "copy-file";
+                        name: string;
+                        from: string;
+                        to: string;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "wait-http";
+                        name: string;
+                        url: string;
+                        expectStatus?: number | undefined;
+                        expectBodyContains?: string | undefined;
+                        intervalMs?: number | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "wait-file";
+                        name: string;
+                        path: string;
+                        service?: string | undefined;
+                        intervalMs?: number | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "host-command";
+                        name: string;
+                        command: string[];
+                        workdir?: string | undefined;
+                        timeoutMs?: number | undefined;
+                    })[] | undefined;
+                    healthGate?: {
+                        kind: "compose-healthy";
+                    } | {
+                        kind: "http";
+                        url: string;
+                        expectStatus?: number | undefined;
+                        expectBodyContains?: string | undefined;
+                        intervalMs?: number | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "compose-exec";
+                        service: string;
+                        command: string[];
+                        intervalMs?: number | undefined;
+                        timeoutMs?: number | undefined;
+                    } | undefined;
+                    teardownSteps?: ({
+                        kind: "compose-exec";
+                        name: string;
+                        service: string;
+                        command: string[];
+                        stdinFile?: string | undefined;
+                        user?: string | undefined;
+                        workdir?: string | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "copy-file";
+                        name: string;
+                        from: string;
+                        to: string;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "wait-http";
+                        name: string;
+                        url: string;
+                        expectStatus?: number | undefined;
+                        expectBodyContains?: string | undefined;
+                        intervalMs?: number | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "wait-file";
+                        name: string;
+                        path: string;
+                        service?: string | undefined;
+                        intervalMs?: number | undefined;
+                        timeoutMs?: number | undefined;
+                    } | {
+                        kind: "host-command";
+                        name: string;
+                        command: string[];
+                        workdir?: string | undefined;
+                        timeoutMs?: number | undefined;
+                    })[] | undefined;
+                } | undefined;
+                manifestId?: string | undefined;
+                manifestPath?: string | undefined;
+                images?: {
+                    name: string;
+                    newNameTemplate?: string | undefined;
+                    newTagTemplate?: string | undefined;
+                    digestTemplate?: string | undefined;
+                }[] | undefined;
+                helmReleases?: {
+                    name: string;
+                    chart: string;
+                    repo?: string | undefined;
+                    version: string;
+                    namespaceTemplate?: string | undefined;
+                    values?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                    set?: {
+                        path: string;
+                        valueTemplate: string;
+                    }[] | undefined;
+                    valuesSecretRefs?: {
+                        path: string;
+                        secretRef: {
+                            key: string;
+                        };
+                    }[] | undefined;
+                    scope?: "per-environment" | "shared" | undefined;
+                }[] | undefined;
+                secretInjections?: ({
+                    mode: "secret";
+                    secretName: string;
+                    secretType?: string | undefined;
+                    entries: {
+                        key: string;
+                        secretRef?: {
+                            key: string;
+                        } | undefined;
+                        valueTemplate?: string | undefined;
+                    }[];
+                } | {
+                    mode: "generatorEnvFile";
+                    envFilePath: string;
+                    entries: {
+                        key: string;
+                        secretRef?: {
+                            key: string;
+                        } | undefined;
+                        valueTemplate?: string | undefined;
+                    }[];
+                })[] | undefined;
+            } | undefined;
+            deployEnvs?: {
+                [x: string]: {
+                    status: "failed" | "ready" | "skipped";
+                    url?: string | null | undefined;
+                    environmentId?: string | null | undefined;
+                    error?: string | null | undefined;
+                };
+            } | undefined;
+            deployFrameId?: string | undefined;
+            deployPrimaryFrameId?: string | undefined;
+            deployWait?: {
+                frameId: string;
+                environmentId: string;
+                startedAt: number;
+                polls: number;
+            } | undefined;
+            deployFix?: {
+                phase: "fixing" | "retrying";
+                attempts: number;
+                maxAttempts: number;
+                frameId: string;
+                reason: string;
+                lastError: string;
+                cycle?: number | null | undefined;
+                attemptLog?: {
+                    attempt: number;
+                    cycle?: number | null | undefined;
+                    at: number;
+                    outcome: "completed" | "failed";
+                    reason: string;
+                    error: string;
+                    summary?: string | null | undefined;
+                }[] | null | undefined;
+                droppedAttempts?: number | null | undefined;
+            } | undefined;
+            environmentInvestigation?: import("@cat-factory/contracts").EnvironmentInvestigationState | undefined;
+            disposeEnvs?: {
+                [x: string]: {
+                    status: "failed" | "none" | "reclaimed";
+                    environmentId?: string | null | undefined;
+                    confirmation?: "confirmed" | "still_standing" | "unconfirmed" | "unverifiable" | null | undefined;
+                    error?: string | null | undefined;
+                };
+            } | undefined;
+        }[];
+        currentStep: number;
+        status: "blocked" | "done" | "failed" | "paused" | "running";
+        failure?: {
+            kind: "agent" | "cancelled" | "companion_rejected" | "delegated_failed" | "dispatch" | "environment" | "evicted" | "harness_shutdown" | "job_failed" | "preflight" | "rejected" | "stalled" | "state_unreadable" | "timeout" | "unknown";
+            message: string;
+            detail: string | null;
+            hint: string | null;
+            reason?: string | null | undefined;
+            occurredAt: number;
+            lastSubtasks: {
+                completed: number;
+                inProgress: number;
+                total: number;
+                items?: {
+                    label: string;
+                    status: "completed" | "in_progress" | "pending";
+                }[] | undefined;
+            } | null;
+            stepIndex?: number | undefined;
+        } | null | undefined;
+        failureHistory?: {
+            kind: "agent" | "cancelled" | "companion_rejected" | "delegated_failed" | "dispatch" | "environment" | "evicted" | "harness_shutdown" | "job_failed" | "preflight" | "rejected" | "stalled" | "state_unreadable" | "timeout" | "unknown";
+            message: string;
+            detail: string | null;
+            hint: string | null;
+            reason?: string | null | undefined;
+            occurredAt: number;
+            lastSubtasks: {
+                completed: number;
+                inProgress: number;
+                total: number;
+                items?: {
+                    label: string;
+                    status: "completed" | "in_progress" | "pending";
+                }[] | undefined;
+            } | null;
+            stepIndex?: number | undefined;
+        }[] | undefined;
+        outputHistory?: {
+            stepIndex: number;
+            occurredAt: number;
+            output: string;
+            truncated?: boolean | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+        frontendBindings?: {
+            envVar: string;
+            serviceUrl?: string | undefined;
+            serviceAddress?: string | undefined;
+        }[] | undefined;
+        initiatedBy?: string | null | undefined;
+        initiatedByRole?: "admin" | "member" | "viewer" | null | undefined;
+        initiatedByExternalIdentity?: string | null | undefined;
+        mode?: "dry_run" | "live" | undefined;
+        intakeOrigin?: "public-api" | "schedule" | "tracker" | "ui" | undefined;
+        createdAt?: number | undefined;
+        rev?: number | undefined;
+        diagnostics?: {
+            lastDispatch?: {
+                stepIndex: number;
+                agentKind: string;
+                model?: string | null | undefined;
+                executionBackend?: string | undefined;
+                failure?: {
+                    kind: string;
+                    reason?: string | undefined;
+                    at: number;
+                } | undefined;
+                repo?: {
+                    owner: string;
+                    name: string;
+                    baseBranch?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+                at: number;
+            } | undefined;
+            host?: {
+                platform?: string | undefined;
+            } | undefined;
+        } | undefined;
+        inputGate?: {
+            status: "blocked" | "not_applicable" | "off" | "overridden" | "passed";
+            mode: "advisory" | "off" | "standard";
+            issues: {
+                code: "description_missing" | "description_placeholder" | "description_thin" | "reproduction_missing" | "required_field_missing" | "review_target_missing" | "success_criteria_missing";
+                severity: "advisory" | "blocking";
+                field?: {
+                    key: string;
+                    label: string;
+                } | undefined;
+            }[];
+            checkedAt: number;
+            overriddenBy?: string | null | undefined;
+            overriddenAt?: number | undefined;
+        } | undefined;
+    }>;
+    private advanceOnce;
     /**
      * The preamble's bound collaborators. Built lazily and memoised because two of them
      * (`RunDispatcher`'s methods) resolve through a field assigned after this one in the