@tangle-network/agent-runtime 0.295.4 → 0.296.0

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-import { Ic as SuperviseTestOptions, Rc as superviseWithTestBrain, Tl as supervisorAgentWithTestBrain, Tn as driverAgent, Zt as RunGraphTestOptions, gl as SupervisorAgentTestDeps, tn as runGraphWithTestBrain, wn as DriverAgentOptions } from "./index-D5p4txpC.js";
-import { Gn as ToolLoopChat, Wn as ToolLoopCallContext } from "./stream-agent-turn-D6lDcAYs.js";
+import { Ic as SuperviseTestOptions, Rc as superviseWithTestBrain, Tl as supervisorAgentWithTestBrain, Tn as driverAgent, Zt as RunGraphTestOptions, gl as SupervisorAgentTestDeps, tn as runGraphWithTestBrain, wn as DriverAgentOptions } from "./index-3GzNNtI9.js";
+import { Ln as ToolLoopCallContext, Rn as ToolLoopChat } from "./stream-agent-turn-LDA8JK7E.js";
 import { AgentImprovementProposal, AgentProfile, AgentProfileImprovementMeasuredComparison, SandboxSizePreset } from "@tangle-network/agent-interface";
 //#region src/testing/index.d.ts
 /** A proposal produced by Runtime's opaque profile-improvement path. */

package/dist/testing.js

@@ -1,14 +1,14 @@
-import { D as canonicalCandidateDigest$1, j as immutableCandidateValue } from "./workspace-streams-D4TMTrJV.js";
-import { f as verifyAgentImprovementProposal } from "./improvement-cycle-C2IuQaRp.js";
-import { i as applyExactAgentProfileDiff, p as parseExactAgentProfile } from "./profile-BubsrYhR.js";
-import { r as driverAgent } from "./coordination-driver-IBnJrG35.js";
-import { a as superviseWithTestBrain, h as supervisorAgentWithTestBrain } from "./supervise-D5yxnDzD.js";
-import { i as runGraphWithTestBrain } from "./graph-BbsdhFNv.js";
+import { N as immutableCandidateValue, k as canonicalCandidateDigest$1 } from "./workspace-streams-D5gHJdTb.js";
+import { f as verifyAgentImprovementProposal } from "./improvement-cycle-7rd18eW9.js";
+import { i as applyExactAgentProfileDiff, p as parseExactAgentProfile } from "./profile-BetOB4_Q.js";
+import { r as driverAgent } from "./coordination-driver-BTwCdKrl.js";
+import { a as superviseWithTestBrain, h as supervisorAgentWithTestBrain } from "./supervise-B5r5oZZ1.js";
+import { i as runGraphWithTestBrain } from "./graph-CqKrLWkl.js";
 import { SANDBOX_SIZE_PRESET_NAMES, canonicalAgentProfileDigest } from "@tangle-network/agent-interface";
 //#region src/testing/fixtures/agent-improvement-proposal.json
 var agent_improvement_proposal_default = {
 	changedSurfaces: ["prompt"],
-	digest: "sha256:019467bd68f1012a8b2f9fb23361c5360b9a0cc9748e37f6aae7fc2e58e746b9",
+	digest: "sha256:2347162db675da4a323e7c4e70ed5ed52692a03d1c9bc4971a2312c1b142746c",
 	evaluation: {
 		"decision": {
 			"contributingChecks": [
@@ -4579,7 +4579,7 @@ var agent_improvement_proposal_default = {
 		],
 		"metadata": {
 			"fixture": "agent-improvement-proposal",
-			"runtimeVersion": "0.295.4"
+			"runtimeVersion": "0.296.0"
 		},
 		"objectives": [
 			{
@@ -4690,8 +4690,8 @@ var agent_improvement_proposal_default = {
 			"baselineContentHash": "sha256:5c21ee53e513fc604cb09754e21c392b24a424da0ef37dbf8f1ee4a8a0b08f09",
 			"candidateContentHash": "sha256:60fcbb1c728194bd51d7d19cb732d1c3f1881dce7e0a6266b41c8b98cfd65693",
 			"kind": "agent-eval-loop",
-			"recordDigest": "sha256:2d91fe3323183b8d4471a7f4334ea4db11f2f43ce695adaf53506d7767a0ded0",
-			"runId": "agent-runtime-0.295.4-proposal-fixture",
+			"recordDigest": "sha256:91c5dcf0ca44a66b44f08359efd13050fa10e04a00848fb98c966d49c6260027",
+			"runId": "agent-runtime-0.296.0-proposal-fixture",
 			"schema": "agent-candidate-experiment"
 		}
 	},
@@ -4714,13 +4714,13 @@ var agent_improvement_proposal_default = {
 	}],
 	kind: "agent-improvement-proposal",
 	proposedAt: "2026-07-10T01:00:00.000Z",
-	runId: "agent-runtime-0.295.4-proposal-fixture"
+	runId: "agent-runtime-0.296.0-proposal-fixture"
 };
 //#endregion
 //#region src/testing/fixtures/agent-profile-improvement-proposal.json
 var agent_profile_improvement_proposal_default = {
 	changedSurfaces: ["prompt", "skills"],
-	digest: "sha256:b38f7214bb6b1ff7c970d279b8a2b5e412b1b4c39e11db516f949f22448b0adc",
+	digest: "sha256:4dc5008417938b74ff03feb7e86d186b36ce223dee6aeb9ff5c8c1cebd156f68",
 	evaluation: {
 		"decision": {
 			"contributingChecks": [
@@ -6354,7 +6354,7 @@ var agent_profile_improvement_proposal_default = {
 		],
 		"metadata": {
 			"fixture": "agent-profile-improvement-proposal",
-			"runtimeVersion": "0.295.4"
+			"runtimeVersion": "0.296.0"
 		},
 		"objectives": [
 			{
@@ -6465,7 +6465,7 @@ var agent_profile_improvement_proposal_default = {
 			"baselineContentHash": "sha256:21c495a37c418c10bde64fbaa188beddeed31f1f051ea60a6a6582a9ee0db704",
 			"candidateContentHash": "sha256:103f77bc8481601eef1ad5fe6ba84a40dffabc3a44f421f8c8559121edab84e9",
 			"kind": "agent-eval-loop",
-			"recordDigest": "sha256:9b795fc1c85c88104be2c7df6c1fb88a39b0ad90909b474e8c15f65fe7b208f6",
+			"recordDigest": "sha256:a10db1fb4920043144295b5e6b06312725282b52e62d2e503da0bb0f95331361",
 			"runId": "profile-improvement-1",
 			"schema": "agent-profile-improvement-experiment"
 		}

package/dist/tui/index.d.ts

@@ -1,4 +1,4 @@
-import { Ct as ProvisionSupervisorConnection, Dt as provisionSupervisor, Et as SupervisorCleanupReceipt, Tt as ProvisionedSupervisor, wt as ProvisionSupervisorRequest } from "../index-D5p4txpC.js";
+import { Ct as ProvisionSupervisorConnection, Dt as provisionSupervisor, Et as SupervisorCleanupReceipt, Tt as ProvisionedSupervisor, wt as ProvisionSupervisorRequest } from "../index-3GzNNtI9.js";
 //#region src/tui/top-app.d.ts
 /**
  * The interactive side of the supervisor-run TUI: a keypress/mouse loop over the frames

package/dist/tui/index.js

@@ -1,3 +1,3 @@
-import { t as provisionSupervisor } from "../provision-supervisor-DRl8doHG.js";
+import { t as provisionSupervisor } from "../provision-supervisor-B-7DnLBR.js";
 import { a as renderTopFrameWithLayout, i as renderTopFrame, n as runTopApp, r as loadTopSnapshot, t as renderTopOnce } from "../top-app-DaiR4LXM.js";
 export { loadTopSnapshot, provisionSupervisor, renderTopFrame, renderTopFrameWithLayout, renderTopOnce, runTopApp };

package/dist/{types-C2MBdgd_.d.ts → types-CwGpKzG1.d.ts}

@@ -1,5 +1,6 @@
 import { l as RuntimeHooks } from "./runtime-hooks-Bj6wJHlH.js";
-import { AgentExactRunControlRef, AgentInteractiveSession, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionRef, AgentInteractiveSessionStart, AgentInteractiveSessionStatus, AgentNativeContextContinuationOptions, AgentNativeContextContinuationResult, AgentProfile, AgentSessionStatus, AgentTurnResult, ChildTaskEvent, ContextTransferRequest, HarnessType, InputPart, InteractionAcknowledgement, InteractionRequest, InteractionResponseCommand, NativeContextBoundaryProof, NativeContextContinuationRequest, NativeContextContinuationTurn, RequestedInteractions, RuntimeEventEnvelope, Sha256Digest, StreamEvent, WorkspaceCheckpointRef, WorkspaceCheckpointRequest } from "@tangle-network/agent-interface";
+import { c as AgentCandidateArtifactPort, t as AgentCandidateWorkspaceArchiveLimits } from "./workspace-archive-pz8YJ1fr.js";
+import { AgentCandidateArtifactRef, AgentCandidateWorkspaceSnapshotEvidence, AgentExactRunControlRef, AgentInteractiveSession, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionRef, AgentInteractiveSessionStart, AgentInteractiveSessionStatus, AgentNativeContextContinuationOptions, AgentNativeContextContinuationResult, AgentProfile, AgentSessionStatus, AgentTurnResult, ChildTaskEvent, ContextTransferRequest, HarnessType, InputPart, InteractionAcknowledgement, InteractionRequest, InteractionResponseCommand, NativeContextBoundaryProof, NativeContextContinuationRequest, NativeContextContinuationTurn, RequestedInteractions, RuntimeEventEnvelope, Sha256Digest, StreamEvent, WorkspaceCheckpointRef, WorkspaceCheckpointRequest } from "@tangle-network/agent-interface";
 import { AgentEvalError, AgentEvalError as AgentEvalError$1, AgentEvalErrorCode, ConfigError, ControlBudget, ControlDecision, ControlEvalResult, ControlRunResult, ControlStep, DataAcquisitionPlan, DefaultVerdict, DefaultVerdict as DefaultVerdict$1, JudgeError, KnowledgeReadinessReport, KnowledgeRequirement, NotFoundError, RunRecord, ToolSpan, TraceAnalysisStore, TraceStore, UserQuestion, ValidationError } from "@tangle-network/agent-eval";
 import { AgentRunOutcome } from "@tangle-network/sandbox/runtime";
 import { BackendType, CreateRequestOptions, CreateSandboxOptions, PromptOptions, SandboxEvent, SandboxInstance } from "@tangle-network/sandbox";
@@ -2539,6 +2540,271 @@ interface DriverContinuationRecord extends DriverLoopRecord {
 /** Count a loop's attempt records into its {@link DriverLoopRecord}. */
 declare function summarizeDriverAttempts(records: ReadonlyArray<DriverAttemptRecord>): DriverLoopRecord;
 //#endregion
+//#region src/runtime/provider-workspace-retention.d.ts
+/** The caller-owned boundary used to retain an executable provider workspace. */
+interface ProviderWorkspaceRetentionPort {
+  /** Maximum wall-clock time Runtime gives queueing, capture, and verification. */
+  readonly timeoutMs: number;
+  /**
+   * Maximum simultaneous captures and verifications using this exact port object, including
+   * recursive children. Omit for no admission bound. Share the port to share the bound.
+   * Timed-out callbacks keep their slot until they settle, even if they ignore cancellation.
+   */
+  readonly maxConcurrentCaptures?: number;
+  /** Same explicit archive bounds used by the capture callback. */
+  readonly limits?: Partial<AgentCandidateWorkspaceArchiveLimits>;
+  /** Refuse cleanup while any native session or workspace coverage remains missing. */
+  readonly requireCompleteProvenance?: boolean;
+  /** Reads the durable manifest and archive after capture returns. */
+  readonly artifacts: AgentCandidateArtifactPort;
+  /** Capture the live environment into the standard candidate workspace evidence shape. */
+  capture(context: ProviderWorkspaceRetentionContext): Promise<AgentCandidateWorkspaceSnapshotEvidence | ProviderWorkspaceCaptureResult>;
+}
+/** Source inventory metadata for a workspace entry. */
+interface ProviderWorkspaceEntryMetadata {
+  readonly path: string;
+  readonly type: 'file' | 'directory' | 'symlink';
+  readonly sizeBytes: number;
+  readonly mode: number;
+  readonly owner?: string | null;
+  readonly group?: string | null;
+  readonly modifiedAt?: string | null;
+  readonly accessedAt?: string | null;
+  readonly symlinkTarget?: string | null;
+}
+/** One Sidecar execution attempt; retries remain separate evidence. */
+interface ProviderWorkspaceAttemptProvenance {
+  readonly executionId: string;
+  readonly ordinal: number;
+  readonly providerSessionId: string;
+  readonly nativeSessionIds: ReadonlyArray<string>;
+  readonly processIds: ReadonlyArray<string>;
+  readonly outcome: 'succeeded' | 'failed' | 'cancelled' | 'unknown';
+  readonly missingReasons: ReadonlyArray<string>;
+}
+/** Source-reported coverage retained with the verified archive reference. */
+interface ProviderWorkspaceCaptureProvenance {
+  readonly status: 'reported' | 'unavailable';
+  readonly provider?: string;
+  readonly environmentId?: string;
+  readonly executionId?: string;
+  /** Exact admitted provider execution; executionId above remains the Runtime artifact identity. */
+  readonly controlRef?: AgentExactRunControlRef;
+  readonly workspaceScope?: 'environment';
+  readonly workspaceRoot?: string;
+  readonly capturedAt?: string;
+  readonly entries?: ReadonlyArray<ProviderWorkspaceEntryMetadata>;
+  readonly excludedPaths?: ReadonlyArray<ProviderWorkspaceEntryMetadata & {
+    readonly reason: string;
+  }>;
+  readonly workspace?: {
+    readonly scannedFiles: number;
+    readonly scannedDirectories: number;
+    readonly reportedFiles: number;
+    readonly reportedDirectories: number;
+    readonly complete: boolean;
+  };
+  /** Sidecar attempts join sessions through executionIds, not the Runtime node ID. */
+  readonly attempts?: ReadonlyArray<ProviderWorkspaceAttemptProvenance>;
+  readonly sessions?: ReadonlyArray<{
+    readonly id: string;
+    readonly executionId: string;
+    readonly transportEvents: string;
+    readonly eventCount: number;
+    readonly messageCount: number;
+    readonly messageScope?: string;
+    readonly backendType?: string;
+    readonly executionIds?: ReadonlyArray<string>;
+    readonly eventCountsByExecutionId?: Readonly<Record<string, number>>;
+    readonly nativeSessionId?: string | null;
+    readonly nativeReason?: string | null;
+    readonly sidecarImageDigest?: string | null;
+    readonly sidecarBundleRevision?: string | null;
+    readonly nativeStore?: {
+      readonly scope: 'session';
+      readonly roots: ReadonlyArray<{
+        readonly scope: 'session-home' | 'workspace-session';
+        readonly path: string;
+      }>;
+      readonly inventory: {
+        readonly scannedFiles: number;
+        readonly reportedFiles: number;
+        readonly scannedDirectories: number;
+        readonly reportedDirectories: number;
+        readonly scannedSymlinks: number;
+        readonly reportedSymlinks: number;
+        readonly skippedEntries: number;
+      } | null;
+      readonly complete: boolean;
+      readonly entries: ReadonlyArray<{
+        readonly sourceId?: string;
+        readonly rootScope: 'session-home' | 'workspace-session';
+        readonly path: string;
+        readonly kind: 'file' | 'directory' | 'symlink';
+        readonly mode: number;
+        readonly sizeBytes: number;
+        readonly sha256: string | null;
+        readonly linkTarget: string | null;
+      }>;
+      readonly excludedPaths: ReadonlyArray<{
+        readonly sourceId?: string;
+        readonly rootScope: 'session-home' | 'workspace-session';
+        readonly path: string;
+        readonly kind: 'file' | 'directory' | 'symlink';
+        readonly mode: number;
+        readonly sizeBytes: number;
+        readonly reason: 'credential';
+      }>;
+    };
+    readonly processStreams?: {
+      readonly complete: boolean;
+      readonly streamCount: number;
+      readonly stdinBytes: number;
+      readonly stdoutBytes: number;
+      readonly stderrBytes: number;
+      readonly protocolBytes: number;
+    };
+    readonly nativeEvents?: {
+      readonly complete: boolean;
+      readonly count: number;
+    };
+  }>;
+  readonly missing: ReadonlyArray<string>;
+}
+interface ProviderWorkspaceCaptureResult {
+  readonly snapshot: AgentCandidateWorkspaceSnapshotEvidence;
+  readonly provenance: ProviderWorkspaceCaptureProvenance;
+  readonly coverageComplete?: boolean;
+  readonly incompleteReason?: string;
+}
+/** The exact live execution facts supplied to a retention callback. */
+interface ProviderWorkspaceRetentionContext {
+  readonly environment: AgentEnvironment;
+  /** Runtime invocation identity used by the artifact store; never a provider session coordinate. */
+  readonly executionId: string;
+  /** Exact admitted provider execution, available even before the harness emits its session id. */
+  readonly controlRef?: AgentExactRunControlRef;
+  /** Exact supervised tree identity, when a supervisor created this execution. */
+  readonly node?: ExecutorNodeContext;
+  /** Sandbox/provider session used for this turn; null means no session id was observed. */
+  readonly providerSessionId?: string | null;
+  /** The harness's own session identity is unknown until a provider reports it. */
+  readonly nativeSessionId?: string | null;
+  /** The exact profile used to create the provider environment. */
+  readonly profile: AgentProfile;
+  /** The provider-derived outcome, when one was available before cleanup. */
+  readonly outcome?: AgentRunOutcome;
+  /** A fresh signal bounded by {@link ProviderWorkspaceRetentionPort.timeoutMs}. */
+  readonly signal: AbortSignal;
+}
+/** Durable join from one provider box to the verified bytes retained before cleanup. */
+interface ProviderWorkspaceCaptureReceipt {
+  readonly executionId: string;
+  /** Durable provider-native identity, separate from the Runtime invocation identity. */
+  readonly controlRef?: AgentExactRunControlRef;
+  readonly node?: ExecutorNodeContext;
+  readonly environmentId: string;
+  /** Exact provider-create profile identity; materialization receipts bind it to the authored profile. */
+  readonly profileDigest: string;
+  readonly providerSessionId: string | null;
+  readonly nativeSessionId: string | null;
+  readonly snapshot: AgentCandidateWorkspaceSnapshotEvidence;
+  readonly provenance: ProviderWorkspaceCaptureProvenance;
+  readonly coverageComplete: boolean;
+  readonly incompleteReason?: string;
+}
+//#endregion
+//#region src/runtime/retained-harness-transcript.d.ts
+/** Inventory and source identity only; native bytes remain in the original workspace archive. */
+interface RetainedHarnessTranscriptDescriptor {
+  readonly kind: 'retained-harness-transcript';
+  readonly schemaVersion: 1;
+  readonly harness: string;
+  readonly source: {
+    readonly executionId: string;
+    readonly controlRef?: AgentExactRunControlRef;
+    readonly node?: ExecutorNodeContext;
+    readonly environmentId: string;
+    readonly profileDigest: `sha256:${string}`;
+    readonly providerSessionId: string | null;
+    readonly nativeSessionId: string | null;
+    readonly coverageComplete: boolean;
+    readonly incompleteReason?: string;
+  };
+  readonly provider?: string;
+  readonly capturedAt?: string;
+  readonly snapshot: {
+    readonly kind: 'agent-candidate-workspace-snapshot';
+    readonly digest: `sha256:${string}`;
+    readonly manifest: AgentCandidateArtifactRef;
+    readonly archive: AgentCandidateArtifactRef;
+  };
+  readonly files: readonly {
+    readonly path: string;
+    readonly bytes: number;
+    readonly sha256: `sha256:${string}`;
+    readonly attribution: {
+      readonly providerSessionId: string;
+      readonly sourceId?: string;
+      readonly rootScope: 'session-home' | 'workspace-session';
+      readonly nativePath: string;
+    };
+  }[];
+  readonly skipped: readonly {
+    readonly path: string;
+    readonly reason: string;
+  }[];
+  readonly missing: readonly string[];
+}
+interface RetainedHarnessTranscriptCapture {
+  readonly status: 'retained';
+  readonly descriptor: RetainedHarnessTranscriptDescriptor;
+  readonly fileCount: number;
+  readonly totalBytes: number;
+  readonly skippedCount: number;
+}
+interface HarnessTranscriptMetadata {
+  readonly schemaVersion: 1;
+  readonly harness: string;
+  readonly files: readonly {
+    readonly path: string;
+    readonly bytes: number;
+    readonly sha256: string;
+    readonly attribution?: RetainedHarnessTranscriptDescriptor['files'][number]['attribution'];
+  }[];
+  readonly skipped: readonly {
+    readonly path: string;
+    readonly reason: string;
+  }[];
+  readonly source?: RetainedHarnessTranscriptDescriptor['source'];
+  readonly missing?: readonly string[];
+  readonly provider?: string;
+  readonly capturedAt?: string;
+}
+/** Projection limits do not change what the original archive retained. */
+interface HarnessTranscriptReadLimits {
+  readonly maxFileBytes: number;
+  readonly maxTotalBytes: number;
+  readonly maxFiles: number;
+  readonly maxManifestBytes: number;
+}
+interface HarnessTranscriptReadOptions {
+  readonly content?: boolean;
+  readonly artifacts?: AgentCandidateArtifactPort;
+  readonly limits?: Partial<HarnessTranscriptReadLimits>;
+  readonly workspaceLimits?: Partial<AgentCandidateWorkspaceArchiveLimits>;
+  readonly signal?: AbortSignal;
+}
+/** Describe already-verified retention, without reading the environment or copying archive bytes. */
+declare function retainHarnessTranscript(receipt: ProviderWorkspaceCaptureReceipt, harness: string): RetainedHarnessTranscriptCapture | HarnessTranscriptUnavailable;
+/** Read native metadata without archive I/O, or verify retained bytes before projecting bounded text. */
+declare function resolveHarnessTranscriptCapture(capture: HarnessTranscriptCapture, options: HarnessTranscriptReadOptions & {
+  content: false;
+}): Promise<HarnessTranscriptMetadata | undefined>;
+declare function resolveHarnessTranscriptCapture(capture: HarnessTranscriptCapture, options?: HarnessTranscriptReadOptions & {
+  content?: true;
+}): Promise<HarnessTranscriptArtifact | undefined>;
+//#endregion
 //#region src/runtime/harness-transcript.d.ts
 declare const HARNESS_TRANSCRIPT_SCHEMA_VERSION: 1;
 interface HarnessTranscriptFile {
@@ -2579,7 +2845,9 @@ type HarnessTranscriptUnavailableReason = 'unsupported-environment' | 'unknown-h
 'nothing-carried' |
 /** The capture succeeded and the blob write did not. The transcript existed in memory and
  *  never reached disk; mirrors `trace-persistence-failed` on the tool-span receipt. */
-'transcript-persistence-failed';
+'transcript-persistence-failed' |
+/** Workspace bytes survived but their transcript descriptor could not be constructed. */
+'retained-projection-failed';
 interface HarnessTranscriptUnavailable {
   readonly status: 'unavailable';
   readonly reason: HarnessTranscriptUnavailableReason;
@@ -2590,13 +2858,13 @@ interface HarnessTranscriptUnavailable {
   }[];
 }
 /**
- * What the executor holds in memory between the read and the settle: the files, inline.
+ * What the executor holds before settlement: a retained descriptor, inline files, or absence.
  *
- * Never journaled and never inside a result blob. The scope persists it under its own content
+ * Never embedded in a settlement event. The scope persists it under its own content
  * ref and records the {@link HarnessTranscriptEvidence} receipt instead, so the settlement stays
  * small and a replay pays nothing for a transcript nobody opens.
  */
-type HarnessTranscriptCapture = {
+type HarnessTranscriptCapture = RetainedHarnessTranscriptCapture | {
   readonly status: 'captured';
   readonly artifact: HarnessTranscriptArtifact;
   readonly fileCount: number;
@@ -2606,7 +2874,7 @@ type HarnessTranscriptCapture = {
 } | HarnessTranscriptUnavailable;
 /**
  * The durable receipt on a settlement: a content-addressed pointer to a persisted
- * {@link HarnessTranscriptArtifact}, or the exact reason there is none. A SIBLING of the tool-span
+ * {@link HarnessTranscriptArtifact} or a retained descriptor, or the exact reason there is none. A SIBLING of the tool-span
  * `trace` receipt, never nested inside it — a dropped child has zero tool spans and an
  * unavailable trace, and it is precisely the child whose transcript this exists to keep.
  */
@@ -2619,6 +2887,9 @@ type HarnessTranscriptEvidence = {
   readonly totalBytes: number;
   /** Non-zero when some transcript was found but deliberately not carried. */
   readonly skippedCount: number;
+  /** Retained source coverage, independent of text projection limits. */
+  readonly coverageComplete?: boolean;
+  readonly missing?: readonly string[];
 } | HarnessTranscriptUnavailable;
 /** The two optional environment reads the capture needs. Public because `captureHarnessTranscript`
  *  is, so a BYO executor can satisfy it with any box that offers a bounded `read` and an `exec`. */
@@ -2653,7 +2924,12 @@ declare function persistHarnessTranscript(capture: HarnessTranscriptCapture, blo
  * says there is none. Throws only when the receipt claims a blob the store does not hold — that
  * is corruption, not absence, and must not read as "no transcript".
  */
-declare function harnessTranscriptArtifact(evidence: HarnessTranscriptEvidence, blobs: Pick<ResultBlobStore, 'get'>): Promise<HarnessTranscriptArtifact | undefined>;
+declare function harnessTranscriptArtifact(evidence: HarnessTranscriptEvidence, blobs: Pick<ResultBlobStore, 'get'>, options: HarnessTranscriptReadOptions & {
+  content: false;
+}): Promise<HarnessTranscriptMetadata | undefined>;
+declare function harnessTranscriptArtifact(evidence: HarnessTranscriptEvidence, blobs: Pick<ResultBlobStore, 'get'>, options?: HarnessTranscriptReadOptions & {
+  content?: true;
+}): Promise<HarnessTranscriptArtifact | undefined>;
 //#endregion
 //#region src/runtime/retained-interactive-types.d.ts
 /** Environment and exact AgentProfile used to start one native coding-agent process. @stable */
@@ -5842,5 +6118,5 @@ interface WidenGate<Out> {
   readonly judgeExempt?: boolean;
 }
 //#endregion
-export { SpawnJournal as $, RuntimeStreamEvent as $a, Iteration as $i, ReadableEnvironment as $n, RetainedInteractiveBindingError as $r, RuntimeStreamEventCollector as $t, NodeExecutionIdentity as A, RuntimeRunStatus as Aa, RetainedRunStartMaterial as Ai, RetainedPendingCause as An, ContinuationPanelInput as Ar, TraceContext as At, ResultBlobStore as B, AgentTaskRunResult as Ba, ReservationHolder as Bi, ReconnectRetainedInteractiveRunOptions as Bn, distillFindings as Br, OtelSpan as Bt, ExecutorToolCall as C, Validator as Ca, RetainedRunEffect as Ci, SessionTraceBox as Cn, CheckUnavailableError as Cr, WorkspaceCheckpointMarker as Ct, MaterializedExecutionIdentity as D, RuntimeRunOptions as Da, RetainedRunIntentAdmission as Di, decodeToolPart as Dn, ContinuationEntry as Dr, workerTraceEnv as Dt, HeldEnvironment as E, RuntimeRunHandle as Ea, RetainedRunHandle as Ei, createPushTraceSource as En, ContinuationContext as Er, readWorkerTraceContext as Et, ProviderModelAttemptEvidence as F, AgentExecutionBackend as Fa, BudgetPoolRestore as Fi, ScopeProgressInput as Fn, VerdictSummary as Fr, LoopSpanNode as Ft, RootMaterialization as G, OpenAIChatResponseFormat as Ga, ReservationWaitRefused as Gi, RetainedInteractiveStartMaterial as Gn, AgentEvalError$1 as Gr, createOpenInferenceFileExporter as Gt, ResumedWork as H, AgentTaskStatus as Ha, ReservationShortfall as Hi, RetainedInteractiveAdmissionHook as Hn, failedItems as Hr, buildLoopOtelSpans as Ht, ProviderModelExecutionEvidence as I, AgentKnowledgeProvider as Ia, BudgetReadout as Ii, TeamProgress as In, admitContinuationPolicy as Ir, OtelAttribute as It, RootStreamReceipt as J, RunAgentTaskOptions as Ja, spendFromUsageEvents as Ji, HarnessTranscriptCapture as Jn, ConfigError as Jr, loopEventToOtelSpan as Jt, RootProviderModelEvidence as K, OpenAIChatTool as Ka, ReserveOptions as Ki, StartRetainedInteractiveRunOptions as Kn, AgentEvalErrorCode as Kr, createOtelExporter as Kt, RecursiveReservationPolicy as L, AgentRuntimeEvent as La, BudgetReconcileFault as Li, WorkerProgress as Ln, admitFinding as Lr, OtelExportConfig as Lt, NodeSnapshot as M, AgentAdapter as Ma, StartRetainedRunInEnvironmentOptions as Mi, ActivityNote as Mn, ContinuationPolicy as Mr, mergeTraceEnv as Mt, NodeStatus as N, AgentBackendContext as Na, StartRetainedRunOptions as Ni, DEFAULT_STALL_AFTER_MS as Nn, ContinuationProfile as Nr, readTraceContextFromEnv as Nt, MaterializedModelIdentity as O, RuntimeRunPersistenceAdapter as Oa, RetainedRunReplayPoint as Oi, sandboxSessionTraceSource as On, ContinuationNoteInput as Or, workerTraceHeaders as Ot, ProfileMaterializationReceipt as P, AgentBackendInput as Pa, BudgetPool as Pi, ExecutorProgress as Pn, PanelFinding as Pr, traceContextToEnv as Pt, SpawnEvent as Q, RuntimeSessionStore as Qa, ExecCtx as Qi, HarnessTranscriptUnavailableReason as Qn, RetainedInteractiveAdmissionError as Qr, RuntimeEventCollector as Qt, ResourceLimit as R, AgentRuntimeEventSink as Ra, LeakedReservation as Ri, createActivityLog as Rn, checkVerdictOf as Rr, OtelExportStats as Rt, ExecutorTeardownWarning as S, ValidationCtx as Sa, RetainedRunDispatchedAdmission as Si, SessionMessageLike as Sn, CheckRead as Sr, WorkerTraceUnavailableReason as St, Handle as T, RuntimeRunCost as Ta, RetainedRunEventOptions as Ti, TraceSource as Tn, ContinuationAppend as Tr, WorkerTraceSeamCarrier as Tt, RetainedExecutionState as U, BackendErrorDetail as Ua, ReservationStage as Ui, RetainedInteractiveEnvironmentInput as Un, passedItems as Ur, buildLoopSpanNodes as Ut, ResumedKeyState as V, AgentTaskSpec as Va, ReservationRejection as Vi, RecoverRetainedInteractiveRunOptions as Vn, expandQuestions as Vr, RuntimeEventOtelOptions as Vt, RootHandle as W, KnowledgeReadinessDecision as Wa, ReservationTicket as Wi, RetainedInteractiveRunHandle as Wn, verdictFromJudgeScore as Wr, buildRuntimeEventOtelSpans as Wt, Scope as X, RuntimeCanonicalStreamEvent as Xa, DefaultVerdict$1 as Xi, HarnessTranscriptFile as Xn, NotFoundError as Xr, padTraceId as Xt, Runtime as Y, RunAgentTaskStreamOptions as Ya, AgentRunSpec as Yi, HarnessTranscriptEvidence as Yn, JudgeError as Yr, padSpanId as Yt, Settled as Z, RuntimeSession as Za, Driver as Zi, HarnessTranscriptUnavailable as Zn, PlannerError as Zr, toOtelAttributes as Zt, ExecutorMaterialization as _, MountRecorder as _a, RetainedInteractiveStartedAdmission as _i, isWaitOutcome as _n, upstreamUnavailableSignal as _r, WaitOpts as _t, BudgetOverspend as a, LoopLineageOptions as aa, WorkerSlots as ai, createRuntimeEventCollector as an, DriverAttemptsExhaustedError as ar, SpendGap as at, ExecutorRegistry as b, SandboxClient as ba, RetainedRunCancelOptions as bi, validateWaitSpec as bn, CONTINUATIONS_DIR as br, WorkerInteractiveUnavailableReason as bt, EnvironmentTeardownReceipt as c, LoopResult as ca, NativeContextContinuationHandle as ci, sanitizeKnowledgeReadinessReport as cn, DriverContractState as cr, SubtreeSummary as ct, ExecutorAccounting as d, LoopTeardownFailedPayload as da, RecoverRetainedRunIntentOptions as di, WaitOutcome as dn, DriverProgressMark as dr, SupervisorOpts as dt, LoopDecisionPayload as ea, RetainedRunAdmissionError as ei, RuntimeStreamEventSink as en, captureHarnessTranscript as er, SpawnOpts as et, ExecutorCancellation as f, LoopTokenUsage as fa, RecoverRetainedRunOptions as fi, WaitProbe as fn, DriverReentry as fr, TokenUsageProvenance as ft, ExecutorFactory as g, MountManifestEntry as ga, RetainedInteractiveIntentAdmission as gi, createWaitProbes as gn, summarizeDriverAttempts as gr, UsageEvent as gt, ExecutorExecutionBinding as h, LoopWinner as ha, RetainedInteractiveEnvironmentAdmission as hi, WaitSpec as hn, classifyDriverFailure as hr, UnknownMaterializationReason as ht, Budget as i, LoopIterationStartedPayload as ia, SlotPermit as ii, SanitizedKnowledgeRequirement as in, DriverAttemptStop as ir, SpendChannel as it, NodeId as j, startRuntimeRun as ja, RetainedRunTurnInput as ji, ActivityLog as jn, ContinuationPanelResult as jr, createPropagatingTraceEmitter as jt, NoWinnerError as k, RuntimeRunRow as ka, RetainedRunSnapshot as ki, RetainedChildRecovery as kn, ContinuationPanel as kr, workerTraceSeamKey as kt, ExecutionBindingReceipt as l, LoopSandboxPlacement as la, NativeContextContinuationInput as li, sanitizeRuntimeStreamEvent as ln, DriverFailureClass as lr, SupervisedResult as lt, ExecutorContext as m, LoopTraceEvent as ma, RetainedInteractiveAdmission as mi, WaitRejection as mn, DriverRetryPolicy as mr, UnconfirmedTeardown as mt, AgentExecutionRef as n, LoopIterationDispatchPayload as na, RuntimeRunStateError as ni, RuntimeTelemetryOptions as nn, persistHarnessTranscript as nr, SpawnRejection as nt, BudgetViolation as o, LoopPlanDescription as oa, createWorkerSlots as oi, createRuntimeStreamEventCollector as on, DriverBudgetReadout as or, SteerableRootHandle as ot, ExecutorCancellationRequest as p, LoopTraceEmitter as pa, RecoverRetainedRunResult as pi, WaitProbeRegistry as pn, DriverRepromptRefusal as pr, TreeView as pt, RootSignal as q, OpenAIChatToolChoice as qa, createBudgetPool as qi, HarnessTranscriptArtifact as qn, BackendTransportError as qr, generateSpanId as qt, AgentSpec as r, LoopIterationEndedPayload as ra, ValidationError as ri, SanitizedKnowledgeReadinessReport as rn, DriverAttemptRecord as rr, Spend as rt, DefaultVerdict as s, LoopPlanPayload as sa, NativeContextContinuationExecution as si, sanitizeAgentRuntimeEvent as sn, DriverContinuationRecord as sr, SubtreeResult as st, Agent as t, LoopEndedPayload as ta, RetainedRunDispatchBindingError as ti, RuntimeStreamEventSummary as tn, harnessTranscriptArtifact as tr, SpawnPrior as tt, Executor as u, LoopStartedPayload as ua, ReconnectRetainedRunOptions as ui, PendingWait as un, DriverLoopRecord as ur, Supervisor as ut, ExecutorNodeContext as v, OutputAdapter as va, RetainedRunAdmission as vi, pollFor as vn, UnavailablePausePolicy as vr, WidenGate as vt, FleetYield as w, RuntimeRunCompleteInput as wa, RetainedRunEnvironmentAdmission as wi, ToolStepInput as wn, CheckVerdict as wr, WorkerTraceResolver as wt, ExecutorResult as x, SelectionReceipt as xa, RetainedRunCancellation as xi, waitUntil as xn, CONTINUATION_FACTS as xr, WorkerTraceEvidence as xt, ExecutorProgressEvent as y, RunProvenance as ya, RetainedRunAdmissionHook as yi, timerAt as yn, AdmittedFinding as yr, WorkerInteractiveSession as yt, ResourceSpend as z, AgentTaskContext as za, ReservationFloor as zi, readWorkerProgress as zn, composeContinuationNote as zr, OtelExporter as zt };
-//# sourceMappingURL=types-C2MBdgd_.d.ts.map
+export { SpawnJournal as $, AgentTaskContext as $a, ReservationFloor as $i, ReadableEnvironment as $n, composeContinuationNote as $r, RuntimeStreamEventCollector as $t, NodeExecutionIdentity as A, MountManifestEntry as Aa, RetainedInteractiveIntentAdmission as Ai, RetainedPendingCause as An, summarizeDriverAttempts as Ar, TraceContext as At, ResultBlobStore as B, RuntimeRunHandle as Ba, RetainedRunHandle as Bi, ReconnectRetainedInteractiveRunOptions as Bn, ContinuationContext as Br, OtelSpan as Bt, ExecutorToolCall as C, LoopSandboxPlacement as Ca, NativeContextContinuationInput as Ci, SessionTraceBox as Cn, DriverFailureClass as Cr, WorkspaceCheckpointMarker as Ct, MaterializedExecutionIdentity as D, LoopTraceEmitter as Da, RecoverRetainedRunResult as Di, decodeToolPart as Dn, DriverRepromptRefusal as Dr, workerTraceEnv as Dt, HeldEnvironment as E, LoopTokenUsage as Ea, RecoverRetainedRunOptions as Ei, createPushTraceSource as En, DriverReentry as Er, readWorkerTraceContext as Et, ProviderModelAttemptEvidence as F, SelectionReceipt as Fa, RetainedRunCancellation as Fi, ScopeProgressInput as Fn, CONTINUATION_FACTS as Fr, LoopSpanNode as Ft, RootMaterialization as G, startRuntimeRun as Ga, RetainedRunTurnInput as Gi, RetainedInteractiveStartMaterial as Gn, ContinuationPanelResult as Gr, createOpenInferenceFileExporter as Gt, ResumedWork as H, RuntimeRunPersistenceAdapter as Ha, RetainedRunReplayPoint as Hi, RetainedInteractiveAdmissionHook as Hn, ContinuationNoteInput as Hr, buildLoopOtelSpans as Ht, ProviderModelExecutionEvidence as I, ValidationCtx as Ia, RetainedRunDispatchedAdmission as Ii, TeamProgress as In, CheckRead as Ir, OtelAttribute as It, RootStreamReceipt as J, AgentBackendInput as Ja, BudgetPool as Ji, HarnessTranscriptCapture as Jn, PanelFinding as Jr, loopEventToOtelSpan as Jt, RootProviderModelEvidence as K, AgentAdapter as Ka, StartRetainedRunInEnvironmentOptions as Ki, StartRetainedInteractiveRunOptions as Kn, ContinuationPolicy as Kr, createOtelExporter as Kt, RecursiveReservationPolicy as L, Validator as La, RetainedRunEffect as Li, WorkerProgress as Ln, CheckUnavailableError as Lr, OtelExportConfig as Lt, NodeSnapshot as M, OutputAdapter as Ma, RetainedRunAdmission as Mi, ActivityNote as Mn, UnavailablePausePolicy as Mr, mergeTraceEnv as Mt, NodeStatus as N, RunProvenance as Na, RetainedRunAdmissionHook as Ni, DEFAULT_STALL_AFTER_MS as Nn, AdmittedFinding as Nr, readTraceContextFromEnv as Nt, MaterializedModelIdentity as O, LoopTraceEvent as Oa, RetainedInteractiveAdmission as Oi, sandboxSessionTraceSource as On, DriverRetryPolicy as Or, workerTraceHeaders as Ot, ProfileMaterializationReceipt as P, SandboxClient as Pa, RetainedRunCancelOptions as Pi, ExecutorProgress as Pn, CONTINUATIONS_DIR as Pr, traceContextToEnv as Pt, SpawnEvent as Q, AgentRuntimeEventSink as Qa, LeakedReservation as Qi, HarnessTranscriptUnavailableReason as Qn, checkVerdictOf as Qr, RuntimeEventCollector as Qt, ResourceLimit as R, RuntimeRunCompleteInput as Ra, RetainedRunEnvironmentAdmission as Ri, createActivityLog as Rn, CheckVerdict as Rr, OtelExportStats as Rt, ExecutorTeardownWarning as S, LoopResult as Sa, NativeContextContinuationHandle as Si, SessionMessageLike as Sn, DriverContractState as Sr, WorkerTraceUnavailableReason as St, Handle as T, LoopTeardownFailedPayload as Ta, RecoverRetainedRunIntentOptions as Ti, TraceSource as Tn, DriverProgressMark as Tr, WorkerTraceSeamCarrier as Tt, RetainedExecutionState as U, RuntimeRunRow as Ua, RetainedRunSnapshot as Ui, RetainedInteractiveEnvironmentInput as Un, ContinuationPanel as Ur, buildLoopSpanNodes as Ut, ResumedKeyState as V, RuntimeRunOptions as Va, RetainedRunIntentAdmission as Vi, RecoverRetainedInteractiveRunOptions as Vn, ContinuationEntry as Vr, RuntimeEventOtelOptions as Vt, RootHandle as W, RuntimeRunStatus as Wa, RetainedRunStartMaterial as Wi, RetainedInteractiveRunHandle as Wn, ContinuationPanelInput as Wr, buildRuntimeEventOtelSpans as Wt, Scope as X, AgentKnowledgeProvider as Xa, BudgetReadout as Xi, HarnessTranscriptFile as Xn, admitContinuationPolicy as Xr, padTraceId as Xt, Runtime as Y, AgentExecutionBackend as Ya, BudgetPoolRestore as Yi, HarnessTranscriptEvidence as Yn, VerdictSummary as Yr, padSpanId as Yt, Settled as Z, AgentRuntimeEvent as Za, BudgetReconcileFault as Zi, HarnessTranscriptUnavailable as Zn, admitFinding as Zr, toOtelAttributes as Zt, ExecutorMaterialization as _, LoopIterationEndedPayload as _a, ValidationError as _i, isWaitOutcome as _n, DriverAttemptRecord as _r, WaitOpts as _t, BudgetOverspend as a, ReservationWaitRefused as aa, AgentEvalError$1 as ai, createRuntimeEventCollector as an, OpenAIChatResponseFormat as ao, HarnessTranscriptReadOptions as ar, SpendGap as at, ExecutorRegistry as b, LoopPlanDescription as ba, createWorkerSlots as bi, validateWaitSpec as bn, DriverBudgetReadout as br, WorkerInteractiveUnavailableReason as bt, EnvironmentTeardownReceipt as c, spendFromUsageEvents as ca, ConfigError as ci, sanitizeKnowledgeReadinessReport as cn, RunAgentTaskOptions as co, resolveHarnessTranscriptCapture as cr, SubtreeSummary as ct, ExecutorAccounting as d, Driver as da, PlannerError as di, WaitOutcome as dn, RuntimeSession as do, ProviderWorkspaceCaptureProvenance as dr, SupervisorOpts as dt, ReservationHolder as ea, distillFindings as ei, RuntimeStreamEventSink as en, AgentTaskRunResult as eo, captureHarnessTranscript as er, SpawnOpts as et, ExecutorCancellation as f, ExecCtx as fa, RetainedInteractiveAdmissionError as fi, WaitProbe as fn, RuntimeSessionStore as fo, ProviderWorkspaceCaptureReceipt as fr, TokenUsageProvenance as ft, ExecutorFactory as g, LoopIterationDispatchPayload as ga, RuntimeRunStateError as gi, createWaitProbes as gn, ProviderWorkspaceRetentionPort as gr, UsageEvent as gt, ExecutorExecutionBinding as h, LoopEndedPayload as ha, RetainedRunDispatchBindingError as hi, WaitSpec as hn, ProviderWorkspaceRetentionContext as hr, UnknownMaterializationReason as ht, Budget as i, ReservationTicket as ia, verdictFromJudgeScore as ii, SanitizedKnowledgeRequirement as in, KnowledgeReadinessDecision as io, HarnessTranscriptReadLimits as ir, SpendChannel as it, NodeId as j, MountRecorder as ja, RetainedInteractiveStartedAdmission as ji, ActivityLog as jn, upstreamUnavailableSignal as jr, createPropagatingTraceEmitter as jt, NoWinnerError as k, LoopWinner as ka, RetainedInteractiveEnvironmentAdmission as ki, RetainedChildRecovery as kn, classifyDriverFailure as kr, workerTraceSeamKey as kt, ExecutionBindingReceipt as l, AgentRunSpec as la, JudgeError as li, sanitizeRuntimeStreamEvent as ln, RunAgentTaskStreamOptions as lo, retainHarnessTranscript as lr, SupervisedResult as lt, ExecutorContext as m, LoopDecisionPayload as ma, RetainedRunAdmissionError as mi, WaitRejection as mn, ProviderWorkspaceEntryMetadata as mr, UnconfirmedTeardown as mt, AgentExecutionRef as n, ReservationShortfall as na, failedItems as ni, RuntimeTelemetryOptions as nn, AgentTaskStatus as no, persistHarnessTranscript as nr, SpawnRejection as nt, BudgetViolation as o, ReserveOptions as oa, AgentEvalErrorCode as oi, createRuntimeStreamEventCollector as on, OpenAIChatTool as oo, RetainedHarnessTranscriptCapture as or, SteerableRootHandle as ot, ExecutorCancellationRequest as p, Iteration as pa, RetainedInteractiveBindingError as pi, WaitProbeRegistry as pn, RuntimeStreamEvent as po, ProviderWorkspaceCaptureResult as pr, TreeView as pt, RootSignal as q, AgentBackendContext as qa, StartRetainedRunOptions as qi, HarnessTranscriptArtifact as qn, ContinuationProfile as qr, generateSpanId as qt, AgentSpec as r, ReservationStage as ra, passedItems as ri, SanitizedKnowledgeReadinessReport as rn, BackendErrorDetail as ro, HarnessTranscriptMetadata as rr, Spend as rt, DefaultVerdict as s, createBudgetPool as sa, BackendTransportError as si, sanitizeAgentRuntimeEvent as sn, OpenAIChatToolChoice as so, RetainedHarnessTranscriptDescriptor as sr, SubtreeResult as st, Agent as t, ReservationRejection as ta, expandQuestions as ti, RuntimeStreamEventSummary as tn, AgentTaskSpec as to, harnessTranscriptArtifact as tr, SpawnPrior as tt, Executor as u, DefaultVerdict$1 as ua, NotFoundError as ui, PendingWait as un, RuntimeCanonicalStreamEvent as uo, ProviderWorkspaceAttemptProvenance as ur, Supervisor as ut, ExecutorNodeContext as v, LoopIterationStartedPayload as va, SlotPermit as vi, pollFor as vn, DriverAttemptStop as vr, WidenGate as vt, FleetYield as w, LoopStartedPayload as wa, ReconnectRetainedRunOptions as wi, ToolStepInput as wn, DriverLoopRecord as wr, WorkerTraceResolver as wt, ExecutorResult as x, LoopPlanPayload as xa, NativeContextContinuationExecution as xi, waitUntil as xn, DriverContinuationRecord as xr, WorkerTraceEvidence as xt, ExecutorProgressEvent as y, LoopLineageOptions as ya, WorkerSlots as yi, timerAt as yn, DriverAttemptsExhaustedError as yr, WorkerInteractiveSession as yt, ResourceSpend as z, RuntimeRunCost as za, RetainedRunEventOptions as zi, readWorkerProgress as zn, ContinuationAppend as zr, OtelExporter as zt };
+//# sourceMappingURL=types-CwGpKzG1.d.ts.map