specrails-core 6.4.0 → 6.6.0

package/dist/agent-runtime/engine/runs.d.ts

@@ -37,76 +37,47 @@ export interface ResumeDefinitionOptions extends RunObservers {
     context?: PipelineContext;
 }
 export declare function createRun(input: DefinitionRunInput & RunObservers): Promise<{
-    error?: {
-        code: string;
-        message: string;
-    } | undefined;
-    metrics: import("../efficiency-types.js").RuntimeEfficiency;
-    efficiencySummary: {
-        reservations: {
-            pendingInvocations: number;
-            knownTokens: number;
-            knownCostUsd: number;
-            tokensUnknown: boolean;
-            costUnknown: boolean;
-        };
-        schemaVersion: 1;
-        currentEvidenceIds: string[];
-        planHash: string | null;
-        candidateHash: string | null;
+    type: 'runtime-status';
+    engineVersion: number;
+    state: {
+        schemaVersion: 2;
         runId: string;
+        traceId: string;
+        workflowId: string;
         workflowVersion: string;
-        technicalAcceptance: string;
-        archive: import("../../pipeline/pipeline-state.js").PhaseStatus;
-        delivery: "pending" | "complete" | "pending-host";
-        roles: {
-            role: string;
-            provider: string | null;
-            model: string | null;
-            effort: string | null;
-            observedModel: null;
-            observedEffort: null;
-            origin: string;
-            tier: "base" | "escalation";
-        }[];
-        invocations: {
-            byKind: {
-                [k: string]: number;
-            };
-            total: number;
-            complete: boolean;
-            promptBytes: number | null;
-            contextBytes: number | null;
-            handoffBytes: number | null;
-            fullContexts: number;
-            incrementalContexts: number;
+        workflowFingerprint: string;
+        inputFingerprint: string;
+        status: import("../workflow-types.js").WorkflowStatus;
+        createdAt: string;
+        updatedAt: string;
+        nextAttempt: number;
+        transitions: number;
+        executionCount: number;
+        history: import("../workflow-types.js").StepAttemptRecord[];
+        events: import("../workflow-types.js").WorkflowEvent[];
+        budget: import("./contracts.js").WorkflowBudget;
+        usage: {
+            costUsd: number | null;
+            inputTokens: number | null;
+            outputTokens: number | null;
+            knownCostUsd: number;
+            knownTokens: number;
+            durationMs: number;
         };
-        escalations: {
-            role: string;
-            attemptId: string;
-            provider: string;
-            model: string | null;
-            effort: string | null;
-            reason: string | null;
-        }[];
-        escalationsTruncated: boolean;
-        checks: {
-            invalidated: number | null;
-            available: boolean;
-            complete: boolean;
-            executed: number | null;
-            reused: number | null;
-            notRun: number | null;
-            durationMs: number | null;
+        pendingApproval?: {
+            stepId: string;
+            requestedAt: string;
+            grantedAt?: string;
+            reason?: string;
         };
-        metrics: import("../efficiency-types.js").RuntimeEfficiency;
-    };
-    revision: number;
-    eventCursor: number;
-    forkOf?: string | undefined;
-    type: "runtime-status";
-    engineVersion: number;
-    state: {
+        pendingQuestion?: {
+            stepId: string;
+            requestedAt: string;
+            question: string;
+            answeredAt?: string;
+            answer?: string;
+        };
+        error?: string;
         nextNodePath: string;
         nextStep: string;
         steps: {
@@ -117,7 +88,6 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             };
         };
         scopes: {
-            output?: unknown;
             nodePath: string;
             scopeId: string;
             branch: import("node:sqlite").SQLOutputValue;
@@ -125,6 +95,7 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             status: string;
             visits: number;
             attemptId: string | null;
+            output?: unknown;
         }[];
         lease: {
             owner: string;
@@ -137,7 +108,7 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             scopeId: string;
             attemptId: string;
             status: string;
-            effect: "write";
+            effect: 'write';
         }[];
         steering: {
             receipts: import("./steering/inbox.js").SteeringReceipt[];
@@ -177,22 +148,11 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
                 message: string;
             };
         }[];
-        schemaVersion: 2;
+    } | {
         runId: string;
         traceId: string;
-        workflowId: string;
-        workflowVersion: string;
-        workflowFingerprint: string;
-        inputFingerprint: string;
         status: import("../workflow-types.js").WorkflowStatus;
-        createdAt: string;
         updatedAt: string;
-        nextAttempt: number;
-        transitions: number;
-        executionCount: number;
-        history: import("../workflow-types.js").StepAttemptRecord[];
-        events: import("../workflow-types.js").WorkflowEvent[];
-        budget: import("./contracts.js").WorkflowBudget;
         usage: {
             costUsd: number | null;
             inputTokens: number | null;
@@ -206,16 +166,14 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             requestedAt: string;
             grantedAt?: string;
             reason?: string;
-        };
+        } | undefined;
         pendingQuestion?: {
             stepId: string;
             requestedAt: string;
             question: string;
             answeredAt?: string;
             answer?: string;
-        };
-        error?: string;
-    } | {
+        } | undefined;
         nextNodePath: string;
         nextStep: string;
         steps: {
@@ -226,7 +184,6 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             };
         };
         scopes: {
-            output?: unknown;
             nodePath: string;
             scopeId: string;
             branch: import("node:sqlite").SQLOutputValue;
@@ -234,6 +191,7 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             status: string;
             visits: number;
             attemptId: string | null;
+            output?: unknown;
         }[];
         lease: {
             owner: string;
@@ -246,7 +204,7 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
             scopeId: string;
             attemptId: string;
             status: string;
-            effect: "write";
+            effect: 'write';
         }[];
         steering: {
             receipts: import("./steering/inbox.js").SteeringReceipt[];
@@ -286,31 +244,6 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
                 message: string;
             };
         }[];
-        pendingQuestion?: {
-            stepId: string;
-            requestedAt: string;
-            question: string;
-            answeredAt?: string;
-            answer?: string;
-        } | undefined;
-        pendingApproval?: {
-            stepId: string;
-            requestedAt: string;
-            grantedAt?: string;
-            reason?: string;
-        } | undefined;
-        runId: string;
-        traceId: string;
-        status: import("../workflow-types.js").WorkflowStatus;
-        updatedAt: string;
-        usage: {
-            costUsd: number | null;
-            inputTokens: number | null;
-            outputTokens: number | null;
-            knownCostUsd: number;
-            knownTokens: number;
-            durationMs: number;
-        };
     };
     workflow: {
         id: string;
@@ -318,17 +251,9 @@ export declare function createRun(input: DefinitionRunInput & RunObservers): Pro
         source: string;
     };
     completion: any;
-}>;
-export declare function resumeRun(directory: string, options?: ResumeDefinitionOptions): Promise<{
+    forkOf?: string | undefined;
     metrics: import("../efficiency-types.js").RuntimeEfficiency;
     efficiencySummary: {
-        reservations: {
-            pendingInvocations: number;
-            knownTokens: number;
-            knownCostUsd: number;
-            tokensUnknown: boolean;
-            costUnknown: boolean;
-        };
         schemaVersion: 1;
         currentEvidenceIds: string[];
         planHash: string | null;
@@ -337,7 +262,7 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
         workflowVersion: string;
         technicalAcceptance: string;
         archive: import("../../pipeline/pipeline-state.js").PhaseStatus;
-        delivery: "pending" | "complete" | "pending-host";
+        delivery: "complete" | "pending" | "pending-host";
         roles: {
             role: string;
             provider: string | null;
@@ -379,13 +304,63 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             durationMs: number | null;
         };
         metrics: import("../efficiency-types.js").RuntimeEfficiency;
+        reservations: {
+            pendingInvocations: number;
+            knownTokens: number;
+            knownCostUsd: number;
+            tokensUnknown: boolean;
+            costUnknown: boolean;
+        };
     };
     revision: number;
     eventCursor: number;
-    forkOf?: string | undefined;
-    type: "runtime-status";
+    error?: {
+        code: string;
+        message: string;
+    } | undefined;
+}>;
+export declare function resumeRun(directory: string, options?: ResumeDefinitionOptions): Promise<{
+    type: 'runtime-status';
     engineVersion: number;
     state: {
+        schemaVersion: 2;
+        runId: string;
+        traceId: string;
+        workflowId: string;
+        workflowVersion: string;
+        workflowFingerprint: string;
+        inputFingerprint: string;
+        status: import("../workflow-types.js").WorkflowStatus;
+        createdAt: string;
+        updatedAt: string;
+        nextAttempt: number;
+        transitions: number;
+        executionCount: number;
+        history: import("../workflow-types.js").StepAttemptRecord[];
+        events: import("../workflow-types.js").WorkflowEvent[];
+        budget: import("./contracts.js").WorkflowBudget;
+        usage: {
+            costUsd: number | null;
+            inputTokens: number | null;
+            outputTokens: number | null;
+            knownCostUsd: number;
+            knownTokens: number;
+            durationMs: number;
+        };
+        pendingApproval?: {
+            stepId: string;
+            requestedAt: string;
+            grantedAt?: string;
+            reason?: string;
+        };
+        pendingQuestion?: {
+            stepId: string;
+            requestedAt: string;
+            question: string;
+            answeredAt?: string;
+            answer?: string;
+        };
+        error?: string;
         nextNodePath: string;
         nextStep: string;
         steps: {
@@ -396,7 +371,6 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             };
         };
         scopes: {
-            output?: unknown;
             nodePath: string;
             scopeId: string;
             branch: import("node:sqlite").SQLOutputValue;
@@ -404,6 +378,7 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             status: string;
             visits: number;
             attemptId: string | null;
+            output?: unknown;
         }[];
         lease: {
             owner: string;
@@ -416,7 +391,7 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             scopeId: string;
             attemptId: string;
             status: string;
-            effect: "write";
+            effect: 'write';
         }[];
         steering: {
             receipts: import("./steering/inbox.js").SteeringReceipt[];
@@ -456,22 +431,11 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
                 message: string;
             };
         }[];
-        schemaVersion: 2;
+    } | {
         runId: string;
         traceId: string;
-        workflowId: string;
-        workflowVersion: string;
-        workflowFingerprint: string;
-        inputFingerprint: string;
         status: import("../workflow-types.js").WorkflowStatus;
-        createdAt: string;
         updatedAt: string;
-        nextAttempt: number;
-        transitions: number;
-        executionCount: number;
-        history: import("../workflow-types.js").StepAttemptRecord[];
-        events: import("../workflow-types.js").WorkflowEvent[];
-        budget: import("./contracts.js").WorkflowBudget;
         usage: {
             costUsd: number | null;
             inputTokens: number | null;
@@ -485,16 +449,14 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             requestedAt: string;
             grantedAt?: string;
             reason?: string;
-        };
+        } | undefined;
         pendingQuestion?: {
             stepId: string;
             requestedAt: string;
             question: string;
             answeredAt?: string;
             answer?: string;
-        };
-        error?: string;
-    } | {
+        } | undefined;
         nextNodePath: string;
         nextStep: string;
         steps: {
@@ -505,7 +467,6 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             };
         };
         scopes: {
-            output?: unknown;
             nodePath: string;
             scopeId: string;
             branch: import("node:sqlite").SQLOutputValue;
@@ -513,6 +474,7 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             status: string;
             visits: number;
             attemptId: string | null;
+            output?: unknown;
         }[];
         lease: {
             owner: string;
@@ -525,7 +487,7 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
             scopeId: string;
             attemptId: string;
             status: string;
-            effect: "write";
+            effect: 'write';
         }[];
         steering: {
             receipts: import("./steering/inbox.js").SteeringReceipt[];
@@ -565,31 +527,6 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
                 message: string;
             };
         }[];
-        pendingQuestion?: {
-            stepId: string;
-            requestedAt: string;
-            question: string;
-            answeredAt?: string;
-            answer?: string;
-        } | undefined;
-        pendingApproval?: {
-            stepId: string;
-            requestedAt: string;
-            grantedAt?: string;
-            reason?: string;
-        } | undefined;
-        runId: string;
-        traceId: string;
-        status: import("../workflow-types.js").WorkflowStatus;
-        updatedAt: string;
-        usage: {
-            costUsd: number | null;
-            inputTokens: number | null;
-            outputTokens: number | null;
-            knownCostUsd: number;
-            knownTokens: number;
-            durationMs: number;
-        };
     };
     workflow: {
         id: string;
@@ -597,6 +534,69 @@ export declare function resumeRun(directory: string, options?: ResumeDefinitionO
         source: string;
     };
     completion: any;
+    forkOf?: string | undefined;
+    metrics: import("../efficiency-types.js").RuntimeEfficiency;
+    efficiencySummary: {
+        schemaVersion: 1;
+        currentEvidenceIds: string[];
+        planHash: string | null;
+        candidateHash: string | null;
+        runId: string;
+        workflowVersion: string;
+        technicalAcceptance: string;
+        archive: import("../../pipeline/pipeline-state.js").PhaseStatus;
+        delivery: "complete" | "pending" | "pending-host";
+        roles: {
+            role: string;
+            provider: string | null;
+            model: string | null;
+            effort: string | null;
+            observedModel: null;
+            observedEffort: null;
+            origin: string;
+            tier: "base" | "escalation";
+        }[];
+        invocations: {
+            byKind: {
+                [k: string]: number;
+            };
+            total: number;
+            complete: boolean;
+            promptBytes: number | null;
+            contextBytes: number | null;
+            handoffBytes: number | null;
+            fullContexts: number;
+            incrementalContexts: number;
+        };
+        escalations: {
+            role: string;
+            attemptId: string;
+            provider: string;
+            model: string | null;
+            effort: string | null;
+            reason: string | null;
+        }[];
+        escalationsTruncated: boolean;
+        checks: {
+            invalidated: number | null;
+            available: boolean;
+            complete: boolean;
+            executed: number | null;
+            reused: number | null;
+            notRun: number | null;
+            durationMs: number | null;
+        };
+        metrics: import("../efficiency-types.js").RuntimeEfficiency;
+        reservations: {
+            pendingInvocations: number;
+            knownTokens: number;
+            knownCostUsd: number;
+            tokensUnknown: boolean;
+            costUnknown: boolean;
+        };
+    };
+    revision: number;
+    eventCursor: number;
 }>;
 export declare function signalRun(directory: string, text: string, requestId?: string): Promise<import("./steering/inbox.js").SteeringMessage>;
 export declare function cancelRun(directory: string, requestId?: string): Promise<{

package/dist/agent-runtime/engine/state.d.ts

@@ -14,48 +14,48 @@ export declare function mergeOrdered<T extends OrderedRecord>(previous: T[], upd
 export declare function mergeHistory(previous: HistoryEntry[], update: HistoryEntry[], maxChars: number): HistoryEntry[];
 /** Private commit markers reach each task's saver writes and expire after a superstep. */
 export declare function definitionStateSchema(historyMaxChars?: number, scope?: ExecutionScope | null): import("@langchain/langgraph").AnnotationRoot<{
-    $outputs: import("@langchain/langgraph").BaseChannel<Record<string, JsonValue>, Record<string, JsonValue> | import("@langchain/langgraph").OverwriteValue<Record<string, JsonValue>>, unknown>;
-    $vars: import("@langchain/langgraph").BaseChannel<Record<string, JsonValue>, Record<string, JsonValue> | import("@langchain/langgraph").OverwriteValue<Record<string, JsonValue>>, unknown>;
+    $outputs: import("@langchain/langgraph").BaseChannel<Record<string, JsonValue>, import("@langchain/langgraph").OverwriteValue<Record<string, JsonValue>> | Record<string, JsonValue>, unknown>;
+    $vars: import("@langchain/langgraph").BaseChannel<Record<string, JsonValue>, import("@langchain/langgraph").OverwriteValue<Record<string, JsonValue>> | Record<string, JsonValue>, unknown>;
     $history: import("@langchain/langgraph").BaseChannel<HistoryEntry[], HistoryEntry[] | import("@langchain/langgraph").OverwriteValue<HistoryEntry[]>, unknown>;
     $sessions: import("@langchain/langgraph").BaseChannel<Record<string, {
         sessionId: string;
         identity: string;
-    }>, Record<string, {
+    }>, import("@langchain/langgraph").OverwriteValue<Record<string, {
         sessionId: string;
         identity: string;
-    }> | import("@langchain/langgraph").OverwriteValue<Record<string, {
+    }>> | Record<string, {
         sessionId: string;
         identity: string;
-    }>>, unknown>;
+    }>, unknown>;
     $usage: import("@langchain/langgraph").BaseChannel<EngineUsage, EngineUsage | import("@langchain/langgraph").OverwriteValue<EngineUsage>, unknown>;
-    $attempts: import("@langchain/langgraph").BaseChannel<Record<string, number>, Record<string, number> | import("@langchain/langgraph").OverwriteValue<Record<string, number>>, unknown>;
+    $attempts: import("@langchain/langgraph").BaseChannel<Record<string, number>, import("@langchain/langgraph").OverwriteValue<Record<string, number>> | Record<string, number>, unknown>;
     $consecutiveFailures: import("@langchain/langgraph").BaseChannel<{
         revision: number;
         count: number;
-    }, {
+    }, import("@langchain/langgraph").OverwriteValue<{
         revision: number;
         count: number;
-    } | import("@langchain/langgraph").OverwriteValue<{
+    }> | {
         revision: number;
         count: number;
-    }>, unknown>;
+    }, unknown>;
     $candidate: import("@langchain/langgraph").BaseChannel<CandidateState | null, CandidateState | import("@langchain/langgraph").OverwriteValue<CandidateState | null> | null, unknown>;
-    $verified: import("@langchain/langgraph").BaseChannel<VerifiedState | null, VerifiedState | import("@langchain/langgraph").OverwriteValue<VerifiedState | null> | null, unknown>;
+    $verified: import("@langchain/langgraph").BaseChannel<VerifiedState | null, import("@langchain/langgraph").OverwriteValue<VerifiedState | null> | VerifiedState | null, unknown>;
     $answers: import("@langchain/langgraph").BaseChannel<EngineAnswer[], EngineAnswer[] | import("@langchain/langgraph").OverwriteValue<EngineAnswer[]>, unknown>;
-    $branches: import("@langchain/langgraph").BaseChannel<Record<string, BranchState>, Record<string, BranchState> | import("@langchain/langgraph").OverwriteValue<Record<string, BranchState>>, unknown>;
-    $maps: import("@langchain/langgraph").BaseChannel<Record<string, import("./contracts.js").MapPlan>, Record<string, import("./contracts.js").MapPlan> | import("@langchain/langgraph").OverwriteValue<Record<string, import("./contracts.js").MapPlan>>, unknown>;
+    $branches: import("@langchain/langgraph").BaseChannel<Record<string, BranchState>, import("@langchain/langgraph").OverwriteValue<Record<string, BranchState>> | Record<string, BranchState>, unknown>;
+    $maps: import("@langchain/langgraph").BaseChannel<Record<string, import("./contracts.js").MapPlan>, import("@langchain/langgraph").OverwriteValue<Record<string, import("./contracts.js").MapPlan>> | Record<string, import("./contracts.js").MapPlan>, unknown>;
     $transitions: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
-    $lastOutcome: import("@langchain/langgraph").BaseChannel<Record<string, string>, Record<string, string> | import("@langchain/langgraph").OverwriteValue<Record<string, string>>, unknown>;
+    $lastOutcome: import("@langchain/langgraph").BaseChannel<Record<string, string>, import("@langchain/langgraph").OverwriteValue<Record<string, string>> | Record<string, string>, unknown>;
     $item: import("@langchain/langgraph").BaseChannel<{
         index: number;
         value: JsonValue;
-    } | null, {
+    } | null, import("@langchain/langgraph").OverwriteValue<{
         index: number;
         value: JsonValue;
-    } | import("@langchain/langgraph").OverwriteValue<{
+    } | null> | {
         index: number;
         value: JsonValue;
-    } | null> | null, unknown>;
+    } | null, unknown>;
     $scope: import("@langchain/langgraph").BaseChannel<ExecutionScope, ExecutionScope | import("@langchain/langgraph").OverwriteValue<ExecutionScope>, unknown>;
     $exit: import("@langchain/langgraph").BaseChannel<import("./contracts.js").ComponentExit | null, import("./contracts.js").ComponentExit | import("@langchain/langgraph").OverwriteValue<import("./contracts.js").ComponentExit | null> | null, unknown>;
     $commit: EphemeralValue<TerminalCommit>;

package/dist/agent-runtime/evaluation.d.ts

@@ -10,6 +10,9 @@ export interface EvaluationOptions {
     repetitions?: number;
 }
 export declare function runEvaluation(options: EvaluationOptions): Promise<{
+    schemaVersion: number;
+    isDefinitionEvaluation: boolean;
+    definitionHash?: string | null | undefined;
     acceptedCases: number;
     allCasesAccepted: boolean;
     experiment: string;
@@ -44,7 +47,4 @@ export declare function runEvaluation(options: EvaluationOptions): Promise<{
     stopReason: string | null;
     reportedSpendUsd: number;
     observations: Record<string, unknown>[];
-    definitionHash?: string | null | undefined;
-    schemaVersion: number;
-    isDefinitionEvaluation: boolean;
 }>;

package/dist/agent-runtime/executor-types.d.ts

@@ -3,7 +3,7 @@ import type { CacheTokenUsage } from './efficiency-types.js';
 import type { GuardrailSettings } from './guardrails.js';
 export declare const DEFAULT_AGENT_TIMEOUT_MS: number;
 export declare const DEFAULT_AGENT_IDLE_TIMEOUT_MS: number;
-export declare const BUILTIN_ROLES: readonly ["architect", "developer", "reviewer"];
+export declare const BUILTIN_ROLES: readonly ['architect', 'developer', 'reviewer'];
 export type BuiltinAgentRole = typeof BUILTIN_ROLES[number];
 export type AgentRole = string;
 export type AgentAccess = 'read' | 'write';
@@ -13,19 +13,19 @@ export declare const ROLE_ID: RegExp;
 export declare function isBuiltinRole(role: string): role is BuiltinAgentRole;
 export declare const BUILTIN_ROLE_POLICY: {
     readonly architect: {
-        readonly access: "read";
-        readonly artifacts: "all";
-        readonly openspecSkill: "openspec-ff-change";
+        readonly access: 'read';
+        readonly artifacts: 'all';
+        readonly openspecSkill: 'openspec-ff-change';
     };
     readonly developer: {
-        readonly access: "write";
-        readonly artifacts: "tasks-checkboxes";
-        readonly openspecSkill: "openspec-apply-change";
+        readonly access: 'write';
+        readonly artifacts: 'tasks-checkboxes';
+        readonly openspecSkill: 'openspec-apply-change';
     };
     readonly reviewer: {
-        readonly access: "read";
-        readonly artifacts: "none";
-        readonly openspecSkill: "openspec-verify-change";
+        readonly access: 'read';
+        readonly artifacts: 'none';
+        readonly openspecSkill: 'openspec-verify-change';
     };
 };
 /** Who an observer sees acting: a pipeline role, or the FIXER stance the developer step takes on a correction round. */

package/dist/agent-runtime/graph/convergence.d.ts

@@ -1,4 +1,4 @@
-import type { VerificationReceipt } from '../../pipeline/pipeline-state.js';
+import { type VerificationReceipt } from '../../pipeline/pipeline-state.js';
 import type { WorkflowState } from '../workflow-types.js';
 /** One verify visit, as the convergence guard remembers it. */
 export interface VerifyOutcome {
@@ -13,7 +13,7 @@ export interface VerifyOutcome {
 /** Verify visits since the latest explicit resume: a human continuing a blocked run grants a fresh budget, as for attempts. */
 export declare function outcomesSinceResume(history: readonly VerifyOutcome[], checkpoint: WorkflowState): VerifyOutcome[];
 /** Identity and one-line description of a failed receipt (or of a host finding that failed a green receipt). */
-export declare function describeFailure(receipt: Pick<VerificationReceipt, 'commands' | 'reason'>, roots: readonly string[], finding?: string): {
+export declare function describeFailure(receipt: Pick<VerificationReceipt, 'commands' | 'reason' | 'selfMutation'>, roots: readonly string[], finding?: string): {
     signature: string;
     summary: string;
 };