@tangle-network/agent-runtime 7.0.0 → 8.0.0

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-import { S as RuntimeStreamEvent, US as SandboxClient, VS as OutputAdapter, vS as AgentRunSpec } from "./types-Jg274chm.js";
+import { DS as AgentRunSpec, QS as SandboxClient, S as RuntimeStreamEvent, XS as OutputAdapter } from "./types-C_qbnw9N.js";
 import { a as ProfileMaterializationContract, c as assertProfileMaterializes, n as AssertProfileMaterializationOptions, o as ProfileMaterializationIssue, r as DefineProfileMaterializationContractOptions, s as ValidateProfileMaterializationOptions, t as AgentProfileMaterializationAxis } from "./profile-materialization-BRY22Oh8.js";
 import { a as createSurfaceImprovementProposer, c as SurfaceValidationIssue, i as SurfaceImprovementEdit, l as renderSurfaceIssues, n as DraftPatchInput, o as AgentSurfaces, r as DraftPatchOutput, s as ResolvedSurface, t as CreateSurfaceImprovementProposerOptions, u as validateSurfaces } from "./improvement-adapter-D5GRU1eY.js";
 import { AgentProfile, AgentProfileFileMount, AgentProfileMcpServer } from "@tangle-network/agent-interface";

package/dist/agent.js

@@ -1,7 +1,7 @@
-import { nt as mapSandboxEvent } from "./failure-cause-rJTm_Tx8.js";
-import { A as createSandboxForSpec, Gt as assertProfileMaterialization, Kt as assertProfileMaterializes, en as sandboxActProfileMaterialization } from "./supervisor-gC-u_PRk.js";
+import { rt as mapSandboxEvent } from "./failure-cause-CVB-YE88.js";
+import { A as createSandboxForSpec, Rt as assertProfileMaterialization, qt as sandboxActProfileMaterialization, zt as assertProfileMaterializes } from "./supervisor-Dpeu7rnZ.js";
 import { l as sha256 } from "./jsonl-file-DsxVI0E_.js";
-import "./runtime-C9F1PG2A.js";
+import "./runtime-CaM5Gbbv.js";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";
 import { parseFindingSubject } from "@tangle-network/agent-eval/analyst";

package/dist/{bundle-Cy5igJdv.js → bundle-CcpL2lfr.js}

@@ -1,4 +1,4 @@
-import { L as immutableCandidateValue, N as canonicalCandidateDigest$1, R as omitTopLevelDigest } from "./workspace-streams-B7yNMahl.js";
+import { L as immutableCandidateValue, N as canonicalCandidateDigest$1, R as omitTopLevelDigest } from "./workspace-streams-DA9R3j-p.js";
 import { agentCandidateBundleSchema } from "@tangle-network/agent-interface";
 // src/candidate-execution/bundle.ts
 /** Validate and content-address a candidate bundle before it crosses an approval boundary. */
@@ -13,4 +13,4 @@ function sealAgentCandidateBundle(input) {
 }
 export { sealAgentCandidateBundle as t };
 
-//# sourceMappingURL=bundle-Cy5igJdv.js.map
+//# sourceMappingURL=bundle-CcpL2lfr.js.map

package/dist/{bundle-Cy5igJdv.js.map → bundle-CcpL2lfr.js.map}

@@ -1 +1 @@
-{"version":3,"file":"bundle-Cy5igJdv.js","names":["canonicalCandidateDigest"],"sources":["../src/candidate-execution/bundle.ts"],"sourcesContent":["import type { AgentCandidateBundle } from '@tangle-network/agent-interface'\nimport { agentCandidateBundleSchema } from '@tangle-network/agent-interface'\n\nimport { canonicalCandidateDigest, immutableCandidateValue, omitTopLevelDigest } from './digest'\n\n/** Exact candidate wire shape before the runtime computes its canonical digest. */\nexport type AgentCandidateBundleInput = Omit<AgentCandidateBundle, 'digest'>\n\n/** Validate and content-address a candidate bundle before it crosses an approval boundary. */\nexport function sealAgentCandidateBundle(input: AgentCandidateBundleInput): AgentCandidateBundle {\n  const digest = canonicalCandidateDigest(input)\n  const parsed = agentCandidateBundleSchema.parse({ ...input, digest })\n  const parsedDigest = canonicalCandidateDigest(omitTopLevelDigest(parsed))\n  if (parsedDigest !== digest) {\n    throw new Error('candidate bundle changed while validating its canonical wire shape')\n  }\n  return immutableCandidateValue(parsed)\n}\n"],"mappings":";;;;AASA,SAAgB,yBAAyB,OAAwD;CAC/F,MAAM,SAASA,2BAAyB,KAAK;CAC7C,MAAM,SAAS,2BAA2B,MAAM;EAAE,GAAG;EAAO;CAAO,CAAC;CAEpE,IADqBA,2BAAyB,mBAAmB,MAAM,CACxD,MAAM,QACnB,MAAM,IAAI,MAAM,oEAAoE;CAEtF,OAAO,wBAAwB,MAAM;AACvC"}
+{"version":3,"file":"bundle-CcpL2lfr.js","names":["canonicalCandidateDigest"],"sources":["../src/candidate-execution/bundle.ts"],"sourcesContent":["import type { AgentCandidateBundle } from '@tangle-network/agent-interface'\nimport { agentCandidateBundleSchema } from '@tangle-network/agent-interface'\n\nimport { canonicalCandidateDigest, immutableCandidateValue, omitTopLevelDigest } from './digest'\n\n/** Exact candidate wire shape before the runtime computes its canonical digest. */\nexport type AgentCandidateBundleInput = Omit<AgentCandidateBundle, 'digest'>\n\n/** Validate and content-address a candidate bundle before it crosses an approval boundary. */\nexport function sealAgentCandidateBundle(input: AgentCandidateBundleInput): AgentCandidateBundle {\n  const digest = canonicalCandidateDigest(input)\n  const parsed = agentCandidateBundleSchema.parse({ ...input, digest })\n  const parsedDigest = canonicalCandidateDigest(omitTopLevelDigest(parsed))\n  if (parsedDigest !== digest) {\n    throw new Error('candidate bundle changed while validating its canonical wire shape')\n  }\n  return immutableCandidateValue(parsed)\n}\n"],"mappings":";;;;AASA,SAAgB,yBAAyB,OAAwD;CAC/F,MAAM,SAASA,2BAAyB,KAAK;CAC7C,MAAM,SAAS,2BAA2B,MAAM;EAAE,GAAG;EAAO;CAAO,CAAC;CAEpE,IADqBA,2BAAyB,mBAAmB,MAAM,CACxD,MAAM,QACnB,MAAM,IAAI,MAAM,oEAAoE;CAEtF,OAAO,wBAAwB,MAAM;AACvC"}

package/dist/candidate-execution/index.js

@@ -1,7 +1,7 @@
-import { F as deepFreezeCandidate, I as embeddedCandidateArtifact, M as canonicalCandidateBytes$1, a as verifyAgentCandidateWorkspaceArtifacts, c as createAgentCandidateWorkspacePort, h as workspaceLimits, i as readAgentCandidateWorkspaceArtifactFiles, j as verifiedArtifactChunks, n as captureAgentCandidateWorkspaceTreeToArtifacts, o as verifyAgentCandidateWorkspaceTree, p as captureAgentCandidateWorkspaceFiles, r as materializeAgentCandidateWorkspaceFromArtifacts, s as captureAgentCandidateWorkspace, t as captureAgentCandidateWorkspaceToArtifacts, x as candidateWorkspaceManifest } from "../workspace-streams-B7yNMahl.js";
-import { a as applyExactAgentProfileDiff, b as parseExactCandidateProfile, i as agentCandidateProfileAsAgentProfile, o as assertCandidateProfileBinding, p as freezeGenericAgentCandidateProfile, v as parseExactAgentProfile, y as parseExactAgentProfileDiff } from "../profile-CNSQjOes.js";
-import { t as sealAgentCandidateBundle } from "../bundle-Cy5igJdv.js";
-import { _ as sealTerminalDigest, a as consumePreparedCandidateExecution, b as sealAgentCandidateModelSettlement, c as withinCandidateCleanupDeadline, d as assertTerminalMatchesClaim, f as assertTerminalMatchesStaged, g as requireStagedTerminal, h as rejectedStage, i as beginPreparedCandidateDisposal, l as assertRecoveryMatchesStaged, m as rejectedFinish, n as executePreparedAgentCandidate, o as candidateClaimFileInternals, p as recoveredTerminalRecord, r as assertPreparedCandidateIntegrity, s as candidateCleanupDeadline, t as prepareAgentCandidateExecution, u as assertTerminalAllowedInPhase, v as terminalRecord, w as verifyAgentCandidateBundle, x as exactProcessProviderAsCandidateExecutor, y as createProtectedAgentCandidateModelPort } from "../prepare-Dtfk_Wi_.js";
+import { F as deepFreezeCandidate, I as embeddedCandidateArtifact, M as canonicalCandidateBytes$1, a as verifyAgentCandidateWorkspaceArtifacts, c as createAgentCandidateWorkspacePort, h as workspaceLimits, i as readAgentCandidateWorkspaceArtifactFiles, j as verifiedArtifactChunks, n as captureAgentCandidateWorkspaceTreeToArtifacts, o as verifyAgentCandidateWorkspaceTree, p as captureAgentCandidateWorkspaceFiles, r as materializeAgentCandidateWorkspaceFromArtifacts, s as captureAgentCandidateWorkspace, t as captureAgentCandidateWorkspaceToArtifacts, x as candidateWorkspaceManifest } from "../workspace-streams-DA9R3j-p.js";
+import { a as applyExactAgentProfileDiff, b as parseExactCandidateProfile, i as agentCandidateProfileAsAgentProfile, o as assertCandidateProfileBinding, p as freezeGenericAgentCandidateProfile, v as parseExactAgentProfile, y as parseExactAgentProfileDiff } from "../profile-CD25rTJF.js";
+import { t as sealAgentCandidateBundle } from "../bundle-CcpL2lfr.js";
+import { _ as sealTerminalDigest, a as consumePreparedCandidateExecution, b as sealAgentCandidateModelSettlement, c as withinCandidateCleanupDeadline, d as assertTerminalMatchesClaim, f as assertTerminalMatchesStaged, g as requireStagedTerminal, h as rejectedStage, i as beginPreparedCandidateDisposal, l as assertRecoveryMatchesStaged, m as rejectedFinish, n as executePreparedAgentCandidate, o as candidateClaimFileInternals, p as recoveredTerminalRecord, r as assertPreparedCandidateIntegrity, s as candidateCleanupDeadline, t as prepareAgentCandidateExecution, u as assertTerminalAllowedInPhase, v as terminalRecord, w as verifyAgentCandidateBundle, x as exactProcessProviderAsCandidateExecutor, y as createProtectedAgentCandidateModelPort } from "../prepare-BnF8nGIg.js";
 import { agentCandidateArtifactRefSchema, agentCandidateWorkspaceManifestMaterialSchema, agentCandidateWorkspaceSnapshotEvidenceSchema } from "@tangle-network/agent-interface";
 import { randomUUID } from "node:crypto";
 import { linkSync } from "node:fs";

package/dist/continuation-CIyKnS1Q.js

@@ -0,0 +1,451 @@
+import { m as ValidationError } from "./errors-DG8yufqX.js";
+import { l as sha256 } from "./jsonl-file-DsxVI0E_.js";
+import { a as writeAtomicDurableFile } from "./durable-file-DstVeHcj.js";
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+// src/finite-number.ts
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+// src/runtime/supervise/continuation.ts
+/**
+* One check ({@link CheckVerdict}; {@link CheckUnavailableError} pauses), one
+* {@link ContinuationPolicy} (`maxBarren`, an optional deadline, no re-prompt default), and one
+* note ({@link composeContinuationNote} owns the facts, {@link ContinuationProfile} owns the
+* words, a play may only append).
+*/
+/** Read a check function's return value into a verdict. Anything but `true` or a passing verdict
+*  is a failure: a check fails closed. */
+function checkVerdictOf(outcome) {
+	if (outcome === true) return { pass: true };
+	if (typeof outcome !== "object" || outcome === null || Array.isArray(outcome)) return { pass: false };
+	const raw = outcome;
+	const items = typeof raw.items === "object" && raw.items !== null && !Array.isArray(raw.items) ? Object.fromEntries(Object.entries(raw.items).filter((entry) => typeof entry[1] === "number" && Number.isFinite(entry[1]))) : void 0;
+	const failures = Array.isArray(raw.failures) ? raw.failures.filter((line) => typeof line === "string" && line.trim() !== "") : void 0;
+	return Object.freeze({
+		pass: raw.pass === true,
+		...items === void 0 ? {} : { items: Object.freeze(items) },
+		...isFiniteNumber(raw.composite) ? { composite: raw.composite } : {},
+		...isFiniteNumber(raw.threshold) ? { threshold: raw.threshold } : {},
+		...failures === void 0 ? {} : { failures: Object.freeze(failures) },
+		...typeof raw.review === "string" && raw.review.trim() !== "" ? { review: raw.review.trim() } : {}
+	});
+}
+/** Items that fail in `verdict`: every item below 1, or the named items of its FAIL lines. */
+function failedItems(verdict) {
+	if (verdict.items !== void 0) return Object.entries(verdict.items).filter(([, value]) => value < 1).map(([name]) => name);
+	return (verdict.failures ?? []).map((line) => line.slice(5).split(/[\s:]/u)[0] ?? "");
+}
+/** Items that pass in `verdict`. */
+function passedItems(verdict) {
+	return Object.entries(verdict.items ?? {}).filter(([, value]) => value >= 1).map(([name]) => name);
+}
+/** Resolve and check a policy before any compute. Returns the deadline in epoch ms, or undefined
+*  when the policy sets none. */
+function admitContinuationPolicy(policy, context) {
+	if (typeof policy !== "object" || policy === null) throw new ValidationError(`${context}: continuation must be an object`);
+	const deadlineMs = typeof policy.deadline === "string" ? Date.parse(policy.deadline) : policy.deadline;
+	if (deadlineMs !== void 0 && (typeof deadlineMs !== "number" || !Number.isFinite(deadlineMs) || deadlineMs <= 0)) throw new ValidationError(`${context}: continuation.deadline, when set, must be a finite time (epoch ms or ISO 8601)`);
+	if (!Number.isInteger(policy.maxBarren) || policy.maxBarren < 1) throw new ValidationError(`${context}: continuation.maxBarren must be an integer >= 1`);
+	if (policy.failures !== "verbatim" && policy.failures !== "off") throw new ValidationError(`${context}: continuation.failures must be 'verbatim' or 'off'`);
+	if (policy.panel !== "on" && policy.panel !== "off") throw new ValidationError(`${context}: continuation.panel must be 'on' or 'off'`);
+	if (policy.bar !== "on" && policy.bar !== "off") throw new ValidationError(`${context}: continuation.bar must be 'on' or 'off'`);
+	if (policy.panel === "on") {
+		if (typeof policy.runPanel !== "function") throw new ValidationError(`${context}: continuation.panel 'on' needs runPanel`);
+		const usd = policy.panelUsd;
+		if (usd === void 0 || !isFiniteNumber(usd.perContinuation) || !isFiniteNumber(usd.perRun) || usd.perContinuation <= 0 || usd.perRun < usd.perContinuation) throw new ValidationError(`${context}: continuation.panel 'on' needs panelUsd with 0 < perContinuation <= perRun`);
+	}
+	if (policy.append !== void 0 && typeof policy.append !== "function") throw new ValidationError(`${context}: continuation.append must be a function`);
+	if (policy.session !== void 0 && policy.session !== "native" && policy.session !== "fresh") throw new ValidationError(`${context}: continuation.session must be 'native' or 'fresh'`);
+	if (policy.reference !== void 0 && typeof policy.reference !== "string") throw new ValidationError(`${context}: continuation.reference must be a string`);
+	admitContinuationProfile(policy.profile, context);
+	return deadlineMs;
+}
+/** The facts a profile template may name. */
+const CONTINUATION_FACTS = [
+	"composite",
+	"threshold",
+	"failed",
+	"total",
+	"reads",
+	"owed",
+	"settled",
+	"delivered",
+	"continuation"
+];
+const factNames = new Set(CONTINUATION_FACTS);
+const placeholder = /\{([a-zA-Z]+)\}/gu;
+function admitContinuationProfile(profile, context) {
+	if (typeof profile !== "object" || profile === null) throw new ValidationError(`${context}: continuation.profile must be an object`);
+	if (typeof profile.id !== "string" || profile.id.trim() === "") throw new ValidationError(`${context}: continuation.profile.id must be non-empty`);
+	const texts = [
+		["opening", profile.opening],
+		["plan", profile.plan],
+		["rules", profile.rules],
+		...Object.entries(profile.headings ?? {}).map(([key, value]) => [`headings.${key}`, value]),
+		...profile.barRule === void 0 ? [] : [["barRule", profile.barRule]]
+	];
+	for (const key of [
+		"failures",
+		"protected",
+		"changed",
+		"findings",
+		"bar",
+		"plan",
+		"rules"
+	]) if (typeof profile.headings?.[key] !== "string") throw new ValidationError(`${context}: continuation.profile.headings.${key} must be a string`);
+	for (const [key, text] of texts) {
+		if (typeof text !== "string") throw new ValidationError(`${context}: continuation.profile.${key} must be a string`);
+		for (const match of text.matchAll(placeholder)) if (!factNames.has(match[1] ?? "")) throw new ValidationError(`${context}: continuation.profile.${key} names {${match[1]}}, which is not a fact Runtime supplies (${CONTINUATION_FACTS.join(", ")})`);
+	}
+	if (profile.review !== void 0) {
+		if (typeof profile.review !== "string" || profile.review.trim() === "") throw new ValidationError(`${context}: continuation.profile.review must be non-empty`);
+		for (const match of profile.review.matchAll(placeholder)) if (![
+			"version",
+			"path",
+			"score"
+		].includes(match[1] ?? "")) throw new ValidationError(`${context}: continuation.profile.review names {${match[1]}}; it may name {version}, {path} and {score}`);
+	}
+	if (profile.opening.trim() === "") throw new ValidationError(`${context}: continuation.profile.opening must be non-empty`);
+	if (profile.panelModel !== void 0 && typeof profile.panelModel !== "string") throw new ValidationError(`${context}: continuation.profile.panelModel must be a string`);
+	if (profile.questions !== void 0 && !Array.isArray(profile.questions)) throw new ValidationError(`${context}: continuation.profile.questions must be an array`);
+	for (const [index, question] of (profile.questions ?? []).entries()) if (typeof question !== "string" || question.trim() === "") throw new ValidationError(`${context}: continuation.profile.questions[${index}] must be a non-empty string`);
+}
+/** Findings reach the note only when every citation resolves, at least two distinct spans are
+*  cited, and the independent verifier agreed. The best method in Who&When found the failing step
+*  14.2% of the time, so an unverified finding is noise with a citation. */
+function admitFinding(finding) {
+	if (!finding.verified) return false;
+	if (finding.citations.length === 0) return false;
+	if (!finding.citations.every((citation) => citation.resolved)) return false;
+	return new Set(finding.citations.map((citation) => citation.uri)).size >= 2;
+}
+/** About 1,500 tokens of findings. */
+const FINDINGS_CHAR_CAP = 6e3;
+/**
+* Rank the admitted findings by how many failed items they explain, drop repeats, and keep them
+* within the note's cap. Earlier findings stay as they were written (ACE: itemized additions keep
+* detail that repeated rewrites lose); a finding whose items all pass now is marked resolved.
+*/
+function distillFindings(prior, proposed, failing, continuation) {
+	const key = (claim) => claim.toLowerCase().replace(/\s+/gu, " ").trim();
+	const known = new Set(prior.map((finding) => key(finding.claim)));
+	const carried = prior.map((finding) => finding.resolvedAt === void 0 && (finding.items?.length ?? 0) > 0 && (finding.items ?? []).every((item) => !failing.has(item)) ? {
+		...finding,
+		resolvedAt: continuation
+	} : finding);
+	const fresh = proposed.filter(admitFinding).filter((finding) => {
+		const k = key(finding.claim);
+		if (known.has(k)) return false;
+		known.add(k);
+		return true;
+	}).map((finding) => ({
+		finding,
+		links: (finding.items ?? []).filter((item) => failing.has(item)).length
+	})).sort((a, b) => b.links - a.links);
+	const out = [...carried];
+	let used = carried.filter((finding) => finding.resolvedAt === void 0).reduce((sum, finding) => sum + finding.claim.length, 0);
+	for (const { finding } of fresh) {
+		if (used + finding.claim.length > FINDINGS_CHAR_CAP) break;
+		used += finding.claim.length;
+		out.push({
+			...finding,
+			admittedAt: continuation
+		});
+	}
+	return out;
+}
+/** Expand the profile's question templates over the failed items and the settled workers. */
+function expandQuestions(templates, failing, workers) {
+	const out = [];
+	for (const template of templates) {
+		const hasItem = template.includes("{item}");
+		const hasWorker = template.includes("{worker}");
+		if (!hasItem && !hasWorker) {
+			out.push(template);
+			continue;
+		}
+		const items = hasItem ? failing : [""];
+		const each = hasWorker ? workers.map((worker) => `${worker.id} (${worker.label})`) : [""];
+		for (const item of items) for (const worker of each) out.push(template.replaceAll("{item}", item).replaceAll("{worker}", worker));
+	}
+	return out;
+}
+/**
+* Write one continuation note, sections 1 to 8 of docs/38. Section 9, the run's state, is
+* `composeReentryTask`, which wraps this text. Pure: the same input writes the same note.
+*/
+function composeContinuationNote(input) {
+	const { profile, verdict } = input;
+	const items = verdict?.items ?? {};
+	const total = Object.keys(items).length;
+	const failing = verdict === void 0 ? [] : failedItems(verdict);
+	const facts = {
+		composite: verdict?.composite === void 0 ? "unknown" : format(verdict.composite),
+		threshold: verdict?.threshold === void 0 ? "unknown" : format(verdict.threshold),
+		failed: verdict === void 0 || total === 0 && (verdict.failures?.length ?? 0) === 0 ? "unknown" : String(failing.length),
+		total: total === 0 ? "unknown" : String(total),
+		reads: String(input.reads),
+		owed: input.owed?.trim() || "not described",
+		settled: String(input.progress.settledCount),
+		delivered: String(input.progress.deliveredCount ?? 0),
+		continuation: String(input.continuation)
+	};
+	const fill = (text) => text.replace(placeholder, (_, name) => facts[name] ?? `{${name}}`);
+	const sections = [verdict === void 0 ? "No check verdict is available yet." + (input.canSubmitResult === true ? " Submit a result through submit_result to request the check." : "") : verdict.pass ? "The check passes on the current state, but no result has been accepted." + (input.canSubmitResult === true ? " Call submit_result to request acceptance." : "") : fill(profile.opening).trim()];
+	const section = (heading, body) => {
+		if (body.length === 0) return;
+		sections.push([...heading.trim() === "" ? [] : [`## ${fill(heading)}`], ...body].join("\n"));
+	};
+	if (input.failures === "verbatim" && verdict !== void 0) {
+		const lines = verdict.failures ?? [];
+		const shown = lines.slice(0, 40);
+		const more = lines.length - shown.length;
+		section(profile.headings.failures, [...shown, ...more > 0 ? [input.canReadMore ? `${more} more failure lines: call read_continuation with continuation ${input.continuation}.` : `${more} more failure lines are not shown.`] : []]);
+		const passing = passedItems(verdict);
+		section(profile.headings.protected, passing.length === 0 ? [] : [passing.join(", ")]);
+		if (input.previous !== void 0) {
+			const before = new Set(failedItems(input.previous));
+			const now = new Set(failing);
+			const fixed = [...before].filter((item) => !now.has(item));
+			const broke = [...now].filter((item) => !before.has(item));
+			section(profile.headings.changed, [
+				...fixed.length === 0 ? [] : [`Now passing: ${fixed.join(", ")}.`],
+				...broke.length === 0 ? [] : [`Newly failing: ${broke.join(", ")}.`],
+				...fixed.length === 0 && broke.length === 0 ? ["No item changed since the last note."] : [],
+				...input.previous.composite !== void 0 && verdict.composite !== void 0 ? [`Composite: ${format(input.previous.composite)} then ${format(verdict.composite)}.`] : []
+			]);
+		}
+	}
+	if (input.findings !== void 0) {
+		const open = input.findings.filter((finding) => finding.resolvedAt === void 0);
+		const resolved = input.findings.filter((finding) => finding.resolvedAt === input.continuation);
+		section(profile.headings.findings, [...open.map((finding) => `- [hypothesis] ${finding.claim}` + (finding.items?.length ? ` (items: ${finding.items.join(", ")})` : "") + ` Evidence: ${finding.citations.map((citation) => citation.uri).join(", ")}`), ...resolved.map((finding) => `- [resolved] ${finding.claim}`)]);
+	}
+	if (input.bar !== void 0 && verdict !== void 0) {
+		const body = [];
+		if (profile.barRule?.trim()) body.push(fill(profile.barRule).trim());
+		for (const [item, value] of Object.entries(items)) {
+			const best = input.bar.best?.verdict.items?.[item];
+			body.push(`- ${item}: ${value >= 1 ? "passes" : `fails (${format(value)})`}` + (best === void 0 ? "" : ` / ${input.bar.best?.label}: ${best >= 1 ? "passes" : `fails (${format(best)})`}`));
+		}
+		if (input.bar.best?.verdict.composite !== void 0) body.push(`Best version ${input.bar.best.label}: composite ${format(input.bar.best.verdict.composite)}.`);
+		if (input.bar.reference?.trim()) body.push(`Reference result: ${input.bar.reference.trim()}`);
+		if (verdict.review?.trim()) body.push(`The check's review: ${verdict.review.trim()}`);
+		section(profile.headings.bar, body);
+	}
+	section(profile.headings.plan, profile.plan.trim() === "" ? [] : [fill(profile.plan).trim()]);
+	section(profile.headings.rules, [...profile.rules.trim() === "" ? [] : [fill(profile.rules).trim()], ...input.sealed ? ["The score comes from cases you cannot see."] : []]);
+	for (const appended of input.appended ?? []) section(appended.heading, appended.text.trim() === "" ? [] : [appended.text.trim()]);
+	return sections.join("\n\n");
+}
+function summarizeVerdict(verdict) {
+	if (verdict === void 0) return null;
+	const total = Object.keys(verdict.items ?? {}).length;
+	return {
+		pass: verdict.pass,
+		...verdict.composite === void 0 ? {} : { composite: verdict.composite },
+		...total === 0 ? {} : {
+			failed: failedItems(verdict).length,
+			total
+		}
+	};
+}
+function noteDigest(note) {
+	return `sha256:${sha256(note)}`;
+}
+/** A run directory's continuation files: the root's at `<runDir>/continuations/<n>/`, a nested
+*  manager's at `<runDir>/continuations/managers/<owner>/<n>/`. */
+const CONTINUATIONS_DIR = "continuations";
+/**
+* Write one continuation's files under `<dir>/<n>/`: `note.md`, `verdict.json`, and
+* `panel.jsonl` when the panel ran. The director reads them through `read_continuation`, because
+* its box cannot read the driver's run directory.
+*/
+async function writeContinuationFiles(dir, continuation, files) {
+	const at = join(dir, String(continuation));
+	await mkdir(at, { recursive: true });
+	writeAtomicDurableFile(join(at, "note.md"), `${files.note}\n`);
+	writeAtomicDurableFile(join(at, "verdict.json"), `${JSON.stringify(files.verdict ?? null, null, 2)}\n`);
+	if (files.panel !== void 0) writeAtomicDurableFile(join(at, "panel.jsonl"), files.panel.map((line) => JSON.stringify(line)).join("\n") + (files.panel.length ? "\n" : ""));
+}
+/** The best composite across `reads`, or `undefined` when no read scored. */
+function bestComposite(reads) {
+	let best;
+	for (const read of reads) {
+		const value = read.verdict?.composite;
+		if (value !== void 0 && (best === void 0 || value > best)) best = value;
+	}
+	return best;
+}
+function format(value) {
+	return Number.isInteger(value) ? String(value) : value.toFixed(3).replace(/0+$/u, "");
+}
+/** Build the continuation state for one manager with a check. */
+function createContinuationKeeper(input) {
+	const { policy } = input;
+	const failures = input.feedback === "pass-only" ? "off" : policy.failures;
+	const entries = [];
+	const notes = [];
+	let findings = [];
+	let panelUsd = 0;
+	let panelUsdKnown = true;
+	const latestVerdict = () => {
+		const reads = input.reads();
+		for (let i = reads.length - 1; i >= 0; i -= 1) {
+			const read = reads[i];
+			if (read?.verdict !== void 0) return {
+				verdict: read.verdict,
+				read: read.read
+			};
+		}
+		return { read: 0 };
+	};
+	const closePrevious = () => {
+		const last = entries.at(-1);
+		const lastNote = notes.at(-1);
+		if (last === void 0 || lastNote === void 0) return;
+		const latest = latestVerdict();
+		entries[entries.length - 1] = {
+			...last,
+			after: latest.read > lastNote.read ? summarizeVerdict(latest.verdict) : null
+		};
+	};
+	return {
+		async compose(context) {
+			closePrevious();
+			const continuation = entries.length + 1;
+			const { verdict, read } = latestVerdict();
+			const failing = verdict === void 0 ? [] : failedItems(verdict);
+			let panelRecord;
+			let panelLines;
+			if (policy.panel === "on" && policy.runPanel !== void 0 && policy.panelUsd !== void 0) {
+				const workers = input.workers();
+				const questions = expandQuestions(policy.profile.questions ?? [], failing, workers);
+				const left = policy.panelUsd.perRun - panelUsd;
+				const usdCap = Math.min(policy.panelUsd.perContinuation, left);
+				const asking = questions.length > 0 && usdCap > 0 && panelUsdKnown;
+				let traces;
+				let unavailable;
+				if (asking) try {
+					traces = await input.traces?.();
+					if (traces === void 0) unavailable = "the run has recorded no trace yet";
+				} catch (error) {
+					unavailable = `the run's traces could not be read: ${error instanceof Error ? error.message : String(error)}`;
+				}
+				if (asking && traces !== void 0) {
+					const result = await policy.runPanel({
+						continuation,
+						task: input.task,
+						...verdict === void 0 ? {} : { verdict },
+						reads: input.reads(),
+						questions,
+						traces,
+						workers,
+						...policy.best === void 0 ? {} : { bar: policy.best },
+						...policy.reference === void 0 ? {} : { reference: policy.reference },
+						usdCap,
+						signal: context.signal
+					});
+					if (result.usd === null) panelUsdKnown = false;
+					else panelUsd += result.usd;
+					findings = distillFindings(findings, result.findings, new Set(failing), continuation);
+					panelRecord = {
+						asked: questions.length,
+						proposed: result.findings.length,
+						admitted: findings.filter((finding) => finding.admittedAt === continuation).length,
+						usd: result.usd
+					};
+					panelLines = [...result.findings.map((finding) => ({
+						kind: "finding",
+						admitted: admitFinding(finding),
+						...finding
+					})), ...result.receipts === void 0 ? [] : [{
+						kind: "receipts",
+						receipts: result.receipts
+					}]];
+				} else panelRecord = {
+					asked: 0,
+					proposed: 0,
+					admitted: 0,
+					usd: 0,
+					...unavailable === void 0 ? {} : { unavailable }
+				};
+			}
+			const appended = policy.append ? await policy.append({
+				continuation,
+				...verdict === void 0 ? {} : { verdict },
+				reads: input.reads(),
+				signal: context.signal
+			}) : void 0;
+			const note = composeContinuationNote({
+				profile: policy.profile,
+				continuation,
+				...verdict === void 0 ? {} : { verdict },
+				...notes.at(-1)?.verdict === void 0 ? {} : { previous: notes.at(-1)?.verdict },
+				reads: input.reads().length,
+				failures,
+				...policy.panel === "on" ? { findings } : {},
+				...policy.bar === "on" ? { bar: {
+					...policy.best === void 0 ? {} : { best: policy.best },
+					...policy.reference === void 0 ? {} : { reference: policy.reference }
+				} } : {},
+				...appended === void 0 ? {} : { appended: [appended] },
+				...input.owed === void 0 ? {} : { owed: input.owed },
+				progress: context.progress,
+				canReadMore: input.canReadMore,
+				canSubmitResult: input.canSubmitResult === true,
+				...input.sealed === true ? { sealed: true } : {}
+			});
+			notes.push({
+				note,
+				...verdict === void 0 ? {} : { verdict },
+				...panelLines === void 0 ? {} : { panel: panelLines },
+				read
+			});
+			entries.push({
+				continuation,
+				attempt: context.attempt,
+				noteDigest: noteDigest(note),
+				profile: policy.profile.id,
+				switches: {
+					failures,
+					panel: policy.panel,
+					bar: policy.bar
+				},
+				before: summarizeVerdict(verdict),
+				after: null,
+				...panelRecord === void 0 ? {} : { panel: panelRecord },
+				appended: appended === void 0 ? 0 : 1
+			});
+			if (input.dir !== void 0) await writeContinuationFiles(input.dir, continuation, {
+				note,
+				...verdict === void 0 ? {} : { verdict },
+				...panelLines === void 0 ? {} : { panel: panelLines }
+			});
+			return note;
+		},
+		read(continuation) {
+			const index = continuation === void 0 ? notes.length - 1 : continuation - 1;
+			const entry = notes[index];
+			if (entry === void 0) return {
+				found: false,
+				reason: notes.length === 0 ? "no continuation has been sent in this run" : `continuations run from 1 to ${notes.length}`
+			};
+			return {
+				found: true,
+				continuation: index + 1,
+				note: entry.note,
+				verdict: failures === "off" && entry.verdict !== void 0 ? { pass: entry.verdict.pass } : entry.verdict ?? null,
+				findings: findings.filter((finding) => finding.admittedAt <= index + 1)
+			};
+		},
+		entries() {
+			closePrevious();
+			return entries.map((entry) => ({ ...entry }));
+		}
+	};
+}
+export { createContinuationKeeper as a, checkVerdictOf as i, admitContinuationPolicy as n, failedItems as o, bestComposite as r, isFiniteNumber as s, CONTINUATIONS_DIR as t };
+
+//# sourceMappingURL=continuation-CIyKnS1Q.js.map