@tangle-network/agent-runtime 0.107.4 → 0.108.0

package/dist/{supervise-BiRutHS9.js → supervise-JfKPwIlO.js}

@@ -1,7 +1,7 @@
-import { i as ConfigError, o as NotFoundError, t as AgentEvalError$1, u as ValidationError } from "./errors-DEAvWQPy.js";
+import { c as RuntimeRunStateError, i as ConfigError, o as NotFoundError, t as AgentEvalError$1, u as ValidationError } from "./errors-DEAvWQPy.js";
 import { a as randomSuffix, c as stringifySafe, d as withTimeout, f as zeroTokenUsage, i as mapWithConcurrency, l as throwAbort, n as deleteBoxSafe, o as randomUuid, s as sleep, t as addTokenUsage, u as throwIfAborted } from "./util-MVgdwuIS.js";
 import { a as contentAddress, i as InMemorySpawnJournal, n as FileSpawnJournal, r as InMemoryResultBlobStore, t as FileResultBlobStore } from "./spawn-journal-CwPvKUTa.js";
-import { A as removeWorktree, D as runWorktreeHarness, E as runWorktreeChecks, O as captureWorktreeDiff, S as routerChatWithUsage, b as routerBrain, i as withDriverExecutor, k as createWorktree, m as createActivityLog, t as createSupervisor, w as runBrainLoop, y as notifyRuntimeHookEvent } from "./supervisor-DTKhF-RV.js";
+import { D as routerChatWithUsage, F as removeWorktree, M as runWorktreeHarness, N as captureWorktreeDiff, P as createWorktree, T as routerBrain, a as runFinalizer, i as pickBestDelivered, j as runWorktreeChecks, k as runBrainLoop, l as withDriverExecutor, n as bestDelivered, o as runTree, t as createSupervisor, w as notifyRuntimeHookEvent, y as createActivityLog } from "./supervisor-B2LzaWRb.js";
 import { a as notifySandboxEventObserver, n as extractLlmCallEvent } from "./sandbox-events-DeI5xX8P.js";
 import { i as resolveAgentEnvironmentProvider, n as providerAsExecutor } from "./environment-provider-CfLUmKmf.js";
 import { r as buildLoopSpanNodes } from "./otel-export-D34IQW1C.js";
@@ -90,6 +90,80 @@ function assertModelAllowed(model, allowed) {
 	if (!allowed.includes(model)) throw new ConfigError(`model ${JSON.stringify(model)} is not in the allowed set ${JSON.stringify([...allowed])}`);
 }
 //#endregion
+//#region src/runtime/supervise/coordination-log.ts
+/** Should this bus event be persisted? Questions and findings ARE the prior context a resumed
+*  driver needs; answers fold their status; everything else has a better ledger or none. */
+function persisted(event) {
+	return event.type === "question" || event.type === "finding" || event.type === "answer";
+}
+/** FS-backed `CoordinationLog`: append-only JSONL, fsynced per record. */
+var FileCoordinationLog = class {
+	path;
+	constructor(path) {
+		this.path = path;
+	}
+	async append(runId, event, at) {
+		if (!persisted(event)) return;
+		const fs = await import("node:fs/promises");
+		const path = await import("node:path");
+		await fs.mkdir(path.dirname(this.path), { recursive: true });
+		const record = {
+			runId,
+			at,
+			event
+		};
+		const fh = await fs.open(this.path, "a");
+		try {
+			await fh.write(`${JSON.stringify(record)}\n`);
+			await fh.sync();
+		} finally {
+			await fh.close();
+		}
+	}
+	async load(runId) {
+		const fs = await import("node:fs/promises");
+		let text;
+		try {
+			text = await fs.readFile(this.path, "utf8");
+		} catch (err) {
+			if (isNoEntError(err)) return {
+				questions: [],
+				findings: []
+			};
+			throw err;
+		}
+		const byId = /* @__PURE__ */ new Map();
+		const findings = [];
+		for (const line of text.split("\n")) {
+			if (line.length === 0) continue;
+			const record = JSON.parse(line);
+			if (record.runId !== runId) continue;
+			const ev = record.event;
+			if (ev.type === "question") byId.set(ev.question.id, ev.question);
+			else if (ev.type === "finding") findings.push(ev.finding);
+			else if (ev.type === "answer") {
+				const prior = byId.get(ev.questionId);
+				if (prior) byId.set(ev.questionId, {
+					...prior,
+					status: "answered",
+					decision: {
+						kind: "answer",
+						answer: ev.down.instruction,
+						by: "prior-run"
+					}
+				});
+			}
+		}
+		return {
+			questions: [...byId.values()],
+			findings
+		};
+	}
+};
+function isNoEntError(err) {
+	return typeof err === "object" && err !== null && "code" in err && err.code === "ENOENT";
+}
+//#endregion
 //#region src/runtime/sandbox-acquire.ts
 /**
 * HTTP statuses where create should be retried — gateway timeouts
@@ -979,7 +1053,7 @@ async function invokePrepareBox(spec, box, signal, recordMount) {
 }
 /** Shared no-op recorder for box-preparation paths that have no run manifest. */
 const noopMountRecorder = () => {};
-function finalize$1(args) {
+function finalize(args) {
 	let selector;
 	let winner;
 	if (args.options.selectWinner) {
@@ -1082,7 +1156,7 @@ async function decideAndFinalize(options, iterations, startMs, now, runId, mount
 /** Finalize the loop and emit the terminal `loop.ended` span. Used by the
 *  in-loop terminal path (decision trace already emitted) and decideAndFinalize. */
 async function finalizeAndEmitEnded(options, decision, iterations, startMs, now, runId, mounts) {
-	const result = finalize$1({
+	const result = finalize({
 		options,
 		decision,
 		iterations,
@@ -3540,8 +3614,9 @@ function createInMemoryRunContext(opts = {}) {
 * resumes when it is re-run with the SAME `runId` and the SAME `dir`: the committed children come
 * back on `Scope.resume` (rehydrated by `replaySpawnTree`) instead of being re-executed.
 *
-* Layout: `${dir}/spawn-journal.jsonl` (one JSONL record per event) and `${dir}/blobs/` (one
-* content-addressed JSON file per settled result). The directory is created on first write.
+* Layout: `${dir}/spawn-journal.jsonl` (one JSONL record per event), `${dir}/blobs/` (one
+* content-addressed JSON file per settled result), and `${dir}/coordination-log.jsonl` (questions
+* + findings, replayed into a resumed driver). The directory is created on first write.
 *
 * Opt-in by construction — `createInMemoryRunContext()` is unchanged and stays the default, so no
 * existing consumer writes to disk or resumes unless it asks for this.
@@ -3552,7 +3627,8 @@ function createFileRunContext(dir, opts = {}) {
 		journal: new FileSpawnJournal(`${dir}/spawn-journal.jsonl`),
 		blobs: new FileResultBlobStore(`${dir}/blobs`),
 		executors: opts.withDriver ? withDriverExecutor(base) : base,
-		resume: true
+		resume: true,
+		coordinationLog: new FileCoordinationLog(`${dir}/coordination-log.jsonl`)
 	};
 }
 //#endregion
@@ -3857,8 +3933,22 @@ function createCoordinationTools(opts) {
 	let reason;
 	let questionSeq = 0;
 	const ledger = [];
-	const questions = [];
+	const questions = [...opts.priorQuestions ?? []];
 	const questionPolicy = opts.questionPolicy ?? "auto";
+	const completedKeys = /* @__PURE__ */ new Set();
+	const keyByWorker = /* @__PURE__ */ new Map();
+	for (const [key, prior] of opts.scope.resume?.keys ?? []) if (prior.state === "completed") completedKeys.add(key);
+	for (const s of opts.scope.resume?.settled ?? []) ledger.push(s.kind === "done" ? {
+		id: s.handle.id,
+		status: "done",
+		score: s.verdict?.score ?? 0,
+		valid: s.verdict?.valid ?? false,
+		outRef: s.outRef
+	} : {
+		id: s.handle.id,
+		status: "down",
+		reason: s.reason
+	});
 	const bus = createEventBus();
 	if (opts.onEvent) {
 		const cb = opts.onEvent;
@@ -3903,6 +3993,8 @@ function createCoordinationTools(opts) {
 	};
 	const recordSettled = (s) => {
 		const settledAt = Date.now();
+		const settledKey = keyByWorker.get(s.handle.id);
+		if (settledKey !== void 0 && s.kind === "done") completedKeys.add(settledKey);
 		const w = s.kind === "done" ? {
 			id: s.handle.id,
 			status: "done",
@@ -4159,7 +4251,7 @@ function createCoordinationTools(opts) {
 	const tools = [
 		{
 			name: "spawn_agent",
-			description: "Start a worker the driver will drive. `profile` is the worker or another driver; `task` is what it should do. Reserves budget from the conserved pool and fails closed. Pass an optional `budget` (per-field) to give a hard sub-task more than the default — it merges over the per-worker default; the conserved pool is still the hard fence. When a max-live-workers cap is set it also fails closed (`error: \"max-live-workers\"`) while that many workers are still in flight — settle or steer one before spawning another. Returns `freeSlots`: how many MORE workers you can start right now (`null` = uncapped). While `freeSlots > 0` there is idle capacity — call this again to fill it rather than waiting; parallel workers finish the run sooner than one at a time.",
+			description: "Start a worker the driver will drive. `profile` is the worker or another driver; `task` is what it should do. Reserves budget from the conserved pool and fails closed. Pass an optional `budget` (per-field) to give a hard sub-task more than the default — it merges over the per-worker default; the conserved pool is still the hard fence. When a max-live-workers cap is set it also fails closed (`error: \"max-live-workers\"`) while that many workers are still in flight — settle or steer one before spawning another. Pass a `key` naming the assignment to make it run-once ACROSS restarts: a key that already completed returns the finished result (`resumed: \"completed\"` — no work re-runs, nothing is spent), a key whose prior attempt failed or was lost with a dead process spawns fresh and says so (`resumed: \"retried\" | \"lost\"`), and a key still running is refused (`error: \"duplicate-key\"`). Returns `freeSlots`: how many MORE workers you can start right now (`null` = uncapped). While `freeSlots > 0` there is idle capacity — call this again to fill it rather than waiting; parallel workers finish the run sooner than one at a time.",
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -4169,6 +4261,10 @@ function createCoordinationTools(opts) {
 						type: "string",
 						description: "Optional trace label."
 					},
+					key: {
+						type: "string",
+						description: "Optional semantic name for this assignment (e.g. \"summarize-ch3\"). The same key never runs twice: completed keys return their committed result, even after a coordinator restart."
+					},
 					budget: {
 						type: "object",
 						description: "Optional per-spawn budget that merges over the per-worker default (per field). Only set the ceilings this sub-task needs raised; the conserved pool still fences.",
@@ -4184,7 +4280,8 @@ function createCoordinationTools(opts) {
 			},
 			handler: (raw) => {
 				const a = obj(raw);
-				if (maxLiveWorkers !== void 0 && maxLiveWorkers > 0 && liveWorkerCount() >= maxLiveWorkers) return Promise.resolve({
+				const key = a.key === void 0 ? void 0 : str(a.key, "key");
+				if (!(key !== void 0 && completedKeys.has(key)) && maxLiveWorkers !== void 0 && maxLiveWorkers > 0 && liveWorkerCount() >= maxLiveWorkers) return Promise.resolve({
 					error: "max-live-workers",
 					live: liveWorkerCount(),
 					freeSlots: freeWorkerSlots()
@@ -4193,13 +4290,37 @@ function createCoordinationTools(opts) {
 				const budget = a.budget === void 0 ? opts.perWorker : mergeBudget(opts.perWorker, a.budget);
 				const res = opts.scope.spawn(agent, a.task, {
 					budget,
-					label: typeof a.label === "string" ? a.label : "worker"
+					label: typeof a.label === "string" ? a.label : "worker",
+					...key !== void 0 ? { key } : {}
 				});
-				if (res.ok) watchWorker(res.handle.id);
+				if (res.ok && res.prior?.state === "completed") {
+					const s = res.prior.settled;
+					if (key !== void 0) completedKeys.add(key);
+					return Promise.resolve({
+						workerId: s.handle.id,
+						resumed: "completed",
+						status: "done",
+						score: s.verdict?.score ?? 0,
+						valid: s.verdict?.valid ?? false,
+						outRef: s.outRef,
+						live: liveWorkerCount(),
+						freeSlots: freeWorkerSlots()
+					});
+				}
+				if (res.ok) {
+					watchWorker(res.handle.id);
+					if (key !== void 0) keyByWorker.set(res.handle.id, key);
+				}
+				const priorHistory = res.ok && res.prior !== void 0 && res.prior.state !== "completed" ? {
+					resumed: res.prior.state,
+					priorWorkerId: res.prior.priorId,
+					...res.prior.state === "retried" ? { priorReason: res.prior.reason } : {}
+				} : {};
 				return Promise.resolve(res.ok ? {
 					workerId: res.handle.id,
 					live: liveWorkerCount(),
-					freeSlots: freeWorkerSlots()
+					freeSlots: freeWorkerSlots(),
+					...priorHistory
 				} : {
 					error: res.reason,
 					live: liveWorkerCount(),
@@ -4218,7 +4339,19 @@ function createCoordinationTools(opts) {
 			handler: async (raw) => {
 				const id = str(obj(raw).workerId, "workerId");
 				const node = opts.scope.view.nodes.find((n) => n.id === id);
-				if (!node) return { error: `unknown workerId ${JSON.stringify(id)}` };
+				if (!node) {
+					const resumed = opts.scope.resume?.view.nodes.find((n) => n.id === id);
+					if (!resumed) return { error: `unknown workerId ${JSON.stringify(id)}` };
+					const output = resumed.outRef ? await opts.blobs.get(resumed.outRef) : void 0;
+					return {
+						status: resumed.status,
+						spent: resumed.spent,
+						outRef: resumed.outRef ?? null,
+						output: output ?? null,
+						progress: null,
+						resumed: true
+					};
+				}
 				const output = node.outRef ? await opts.blobs.get(node.outRef) : void 0;
 				const progress = readProgress(id);
 				return {
@@ -4983,8 +5116,14 @@ function driverAgent(opts) {
 				...opts.analysts ? { analysts: opts.analysts } : {},
 				...opts.analyzeOnSettle ? { analyzeOnSettle: opts.analyzeOnSettle } : {},
 				...opts.watchWorkers ? { watchWorkers: opts.watchWorkers } : {},
-				...opts.stallAfterMs !== void 0 ? { stallAfterMs: opts.stallAfterMs } : {}
+				...opts.stallAfterMs !== void 0 ? { stallAfterMs: opts.stallAfterMs } : {},
+				...opts.onEvent ? { onEvent: opts.onEvent } : {},
+				...opts.priorCoordination?.questions.length ? { priorQuestions: opts.priorCoordination.questions } : {}
 			});
+			for (const w of scope.resume?.waits ?? []) {
+				const rearmed = scope.wait(w.spec, { label: w.label });
+				if (!rearmed.ok) throw new RuntimeRunStateError(`driverAgent: cannot re-arm resumed wait '${w.label}' (${rearmed.reason})`);
+			}
 			const byName = new Map(coord.tools.map((t) => [t.name, t]));
 			const toolSpecs = [...coord.tools.map((t) => ({
 				type: "function",
@@ -5066,13 +5205,20 @@ function driverAgent(opts) {
 					const tool = byName.get(name);
 					return safeJson(tool ? await runTool(tool, args) : { error: `unknown tool: ${name}` });
 				},
-				initialMessages: [{
-					role: "system",
-					content: system
-				}, {
-					role: "user",
-					content: stringifyTask(task)
-				}],
+				initialMessages: [
+					{
+						role: "system",
+						content: system
+					},
+					{
+						role: "user",
+						content: stringifyTask(task)
+					},
+					...scope.resume ? [{
+						role: "user",
+						content: resumeBrief(scope.resume, opts.priorCoordination)
+					}] : []
+				],
 				maxTurns,
 				hooks: { stopBefore: () => {
 					if (coord.isStopped() || scope.signal.aborted || poolStarved(scope, opts.perWorker) || deadlinePassed(scope, now)) return true;
@@ -5087,10 +5233,46 @@ function driverAgent(opts) {
 				} }
 			});
 			await coord.drainResolved();
-			return finalize(coord, opts.blobs);
+			return runFinalizer(opts.finalizer ?? bestDelivered, {
+				settled: coord.settled(),
+				blobs: opts.blobs,
+				tree: runTree(scope),
+				budget: scope.budget
+			});
 		}
 	};
 }
+/**
+* The factual context a resumed driver starts from — everything the durable stores prove about
+* the prior process(es): committed settlements, per-key states (completed / lost / failed),
+* re-armed waits, carried-over questions and findings, and the spend already paid. Injected as
+* the brain's first user-context on a resumed run so it continues from the unresolved work.
+*/
+function resumeBrief(resume, prior) {
+	const lines = [
+		"RESUME: this run continues a prior coordinator process. Its committed work is restored",
+		"below and already counts toward the deliverable — do NOT redo it. Continue from the",
+		"unresolved work only.",
+		"",
+		`Committed workers (${resume.settled.length}):`
+	];
+	if (resume.settled.length === 0) lines.push("- none");
+	for (const s of resume.settled) lines.push(s.kind === "done" ? `- ${s.handle.id} (${s.handle.label}): done, score=${s.verdict?.score ?? 0}, valid=${s.verdict?.valid ?? false}, outRef=${s.outRef}` : `- ${s.handle.id} (${s.handle.label}): down, reason=${s.reason}`);
+	const byState = (state) => [...resume.keys].filter(([, v]) => v.state === state);
+	const completed = byState("completed");
+	const lost = byState("in-doubt");
+	const failed = byState("down");
+	if (completed.length > 0) lines.push("", "COMPLETED keys — spawn_agent with the same key returns the finished result, spending nothing:", ...completed.map(([k, v]) => `- ${k} → ${v.id} (${v.label})`));
+	if (lost.length > 0) lines.push("", "Keys LOST in flight with the prior process — this is the unresolved work; spawn_agent with the same key starts a fresh attempt:", ...lost.map(([k, v]) => `- ${k} (prior attempt ${v.id}, ${v.label})`));
+	if (failed.length > 0) lines.push("", "Keys whose prior attempt FAILED (settled down) — spawn_agent with the same key retries:", ...failed.map(([k, v]) => `- ${k} (prior attempt ${v.id}, ${v.label})`));
+	if (resume.waits.length > 0) lines.push("", "Pending waits RE-ARMED on their original deadlines (they settle through await_event):", ...resume.waits.map((w) => `- ${w.label} (${w.spec.kind})`));
+	const openQuestions = (prior?.questions ?? []).filter((q) => q.status === "open" || q.status === "escalated");
+	if (openQuestions.length > 0) lines.push("", "Questions carried over, still undecided (answer_question decides them; list_questions shows all):", ...openQuestions.map((q) => `- [${q.id}] from=${q.from}, urgency=${q.urgency}: ${q.question}`));
+	if ((prior?.findings.length ?? 0) > 0) lines.push("", "Analyst findings from the prior process:", ...(prior?.findings ?? []).map((f) => `- ${f.analyst} on ${f.fromWorker}: ${safeJson(f.findings)}`));
+	const spent = resume.priorSpend;
+	lines.push("", "Budget the run ALREADY spent before this process (it counts toward the run total):", `- child work: tokens in=${spent.childWork.tokens.input} out=${spent.childWork.tokens.output}, usd=${spent.childWork.usd}, iterations=${spent.childWork.iterations}`, `- driver inference: tokens in=${spent.driverInference.tokens.input} out=${spent.driverInference.tokens.output}, usd=${spent.driverInference.usd}`);
+	return lines.join("\n");
+}
 /** Run a work tool. A throw is data to the driver (it can recover next turn), not a crash — fold
 *  the error back as a string result. null/undefined passes through (the caller treats it as "not
 *  handled" and falls to the coordination dispatch). */
@@ -5113,17 +5295,13 @@ async function runTool(tool, args) {
 *  child delivered — an honest "the driver produced nothing", never a high-scoring result that
 *  ran without passing its check (Foreman's 0/18 lesson). `valid` is the single delivery signal,
 *  matching `defaultSelectWinner`'s valid-first rule; the oracle just doesn't fall back to an
-*  unchecked best-effort. */
+*  unchecked best-effort. The same argmax as the `bestDelivered` finalizer (`pickBestDelivered`);
+*  this direct form serves callers that hold a bare ledger + blob store. */
 async function finalizeBestDelivered(settled, blobs) {
-	const delivered = settled.filter((w) => w.status === "done" && w.valid === true);
-	if (delivered.length === 0) return void 0;
-	let best = delivered[0];
-	for (const w of delivered) if ((w.score ?? 0) > (best.score ?? 0)) best = w;
+	const best = pickBestDelivered(settled.filter((w) => w.status === "done" && w.valid === true));
+	if (best === void 0) return void 0;
 	return best.outRef ? await blobs.get(best.outRef) : void 0;
 }
-async function finalize(coord, blobs) {
-	return finalizeBestDelivered(coord.settled(), blobs);
-}
 function stringifyTask(task) {
 	return typeof task === "string" ? task : safeJson(task);
 }
@@ -7070,7 +7248,8 @@ async function serveCoordinationMcp(opts) {
 		...opts.watchWorkers ? { watchWorkers: opts.watchWorkers } : {},
 		...opts.stallAfterMs !== void 0 ? { stallAfterMs: opts.stallAfterMs } : {},
 		...opts.onEvent ? { onEvent: opts.onEvent } : {},
-		...opts.questionPolicy ? { questionPolicy: opts.questionPolicy } : {}
+		...opts.questionPolicy ? { questionPolicy: opts.questionPolicy } : {},
+		...opts.priorQuestions?.length ? { priorQuestions: opts.priorQuestions } : {}
 	});
 	const mcp = createMcpServer({
 		extraTools: coord.tools,
@@ -7147,8 +7326,9 @@ async function serveCoordinationMcp(opts) {
 *    coordination verbs: `serveCoordinationMcp` exposes spawn/await/steer/stop over the live scope,
 *    and the caller's `driveHarness` runs the harness with that MCP mounted. The harness IS the brain.
 *
-* Both arms spawn children through the SAME `makeWorkerAgent` seam and settle on the SAME completion
-* oracle (`finalizeBestDelivered` — the best DELIVERED child, never the driver's own prose).
+* Both arms spawn children through the SAME `makeWorkerAgent` seam and finalize through the SAME
+* seam (`runFinalizer` over DELIVERED children only — default keep-best, never the driver's own
+* prose).
 */
 /** The standing strategy a router-brained supervisor runs with when its profile names no
 *  `systemPrompt`. The brain's competence IS this prompt: without it the brain has the coordination
@@ -7194,7 +7374,10 @@ function supervisorAgent(profile, deps) {
 		...deps.stopRule ? { stopRule: deps.stopRule } : {},
 		...deps.onProgressStop ? { onProgressStop: deps.onProgressStop } : {},
 		...deps.maxTurns !== void 0 ? { maxTurns: deps.maxTurns } : {},
-		...deps.compaction ? { compaction: deps.compaction } : {}
+		...deps.compaction ? { compaction: deps.compaction } : {},
+		...deps.onEvent ? { onEvent: deps.onEvent } : {},
+		...deps.priorCoordination ? { priorCoordination: deps.priorCoordination } : {},
+		...deps.finalizer ? { finalizer: deps.finalizer } : {}
 	});
 	const driveHarness = deps.driveHarness;
 	if (!driveHarness) throw new ValidationError(`supervisorAgent: profile.harness="${harness}" needs deps.driveHarness (how to run the harness with the coordination MCP mounted)`);
@@ -7210,7 +7393,9 @@ function supervisorAgent(profile, deps) {
 				...deps.analysts ? { analysts: deps.analysts } : {},
 				...deps.analyzeOnSettle ? { analyzeOnSettle: deps.analyzeOnSettle } : {},
 				...deps.watchWorkers ? { watchWorkers: deps.watchWorkers } : {},
-				...deps.stallAfterMs !== void 0 ? { stallAfterMs: deps.stallAfterMs } : {}
+				...deps.stallAfterMs !== void 0 ? { stallAfterMs: deps.stallAfterMs } : {},
+				...deps.onEvent ? { onEvent: deps.onEvent } : {},
+				...deps.priorCoordination?.questions.length ? { priorQuestions: deps.priorCoordination.questions } : {}
 			});
 			try {
 				await driveHarness({
@@ -7220,7 +7405,12 @@ function supervisorAgent(profile, deps) {
 					coordinationMcpUrl: mcp.url
 				});
 				await mcp.drainResolved();
-				return await finalizeBestDelivered(mcp.settled(), deps.blobs);
+				return await runFinalizer(deps.finalizer ?? bestDelivered, {
+					settled: mcp.settled(),
+					blobs: deps.blobs,
+					tree: runTree(scope),
+					budget: scope.budget
+				});
 			} finally {
 				await mcp.close();
 			}
@@ -7284,38 +7474,49 @@ function supervise(profile, task, opts) {
 		if (!opts.backend) throw new ValidationError("supervise: provide opts.backend (where workers run) or opts.makeWorkerAgent");
 		makeWorkerAgent = workerFromBackend(opts.backend, opts.deliverable);
 	}
-	const agent = supervisorAgent(profile, {
-		blobs,
-		makeWorkerAgent,
-		perWorker,
-		...opts.maxLiveWorkers !== void 0 ? { maxLiveWorkers: opts.maxLiveWorkers } : {},
-		...opts.router ? { router: opts.router } : {},
-		...opts.brain ? { brain: opts.brain } : {},
-		...opts.driveHarness ? { driveHarness: opts.driveHarness } : {},
-		...opts.extraTools ? { extraTools: opts.extraTools } : {},
-		...opts.executeExtraTool ? { executeExtraTool: opts.executeExtraTool } : {},
-		...opts.analysts ? { analysts: opts.analysts } : {},
-		...opts.analyzeOnSettle ? { analyzeOnSettle: opts.analyzeOnSettle } : {},
-		...opts.watchWorkers ? { watchWorkers: opts.watchWorkers } : {},
-		...opts.stallAfterMs !== void 0 ? { stallAfterMs: opts.stallAfterMs } : {},
-		...opts.stopRule ? { stopRule: opts.stopRule } : {},
-		...opts.onProgressStop ? { onProgressStop: opts.onProgressStop } : {},
-		...opts.maxTurns !== void 0 ? { maxTurns: opts.maxTurns } : {},
-		...opts.compaction ? { compaction: opts.compaction } : {}
-	});
-	return createSupervisor().run(agent, task, {
-		budget: opts.budget,
-		runId: opts.runId ?? "supervise",
-		journal: opts.journal ?? ctx.journal,
-		blobs,
-		executors: ctx.executors,
-		maxDepth: opts.maxDepth ?? 8,
-		...opts.probes ? { probes: opts.probes } : {},
-		...ctx.resume === true ? { resume: true } : {},
-		...opts.now ? { now: opts.now } : {}
-	});
+	const workerFactory = makeWorkerAgent;
+	const runId = opts.runId ?? "supervise";
+	const log = ctx.coordinationLog;
+	const now = opts.now ?? Date.now;
+	const start = async () => {
+		const priorCoordination = log ? await log.load(runId) : void 0;
+		const agent = supervisorAgent(profile, {
+			blobs,
+			makeWorkerAgent: workerFactory,
+			perWorker,
+			...log ? { onEvent: (ev) => log.append(runId, ev, new Date(now()).toISOString()) } : {},
+			...priorCoordination && (priorCoordination.questions.length > 0 || priorCoordination.findings.length > 0) ? { priorCoordination } : {},
+			...opts.finalizer ? { finalizer: opts.finalizer } : {},
+			...opts.maxLiveWorkers !== void 0 ? { maxLiveWorkers: opts.maxLiveWorkers } : {},
+			...opts.router ? { router: opts.router } : {},
+			...opts.brain ? { brain: opts.brain } : {},
+			...opts.driveHarness ? { driveHarness: opts.driveHarness } : {},
+			...opts.extraTools ? { extraTools: opts.extraTools } : {},
+			...opts.executeExtraTool ? { executeExtraTool: opts.executeExtraTool } : {},
+			...opts.analysts ? { analysts: opts.analysts } : {},
+			...opts.analyzeOnSettle ? { analyzeOnSettle: opts.analyzeOnSettle } : {},
+			...opts.watchWorkers ? { watchWorkers: opts.watchWorkers } : {},
+			...opts.stallAfterMs !== void 0 ? { stallAfterMs: opts.stallAfterMs } : {},
+			...opts.stopRule ? { stopRule: opts.stopRule } : {},
+			...opts.onProgressStop ? { onProgressStop: opts.onProgressStop } : {},
+			...opts.maxTurns !== void 0 ? { maxTurns: opts.maxTurns } : {},
+			...opts.compaction ? { compaction: opts.compaction } : {}
+		});
+		return createSupervisor().run(agent, task, {
+			budget: opts.budget,
+			runId,
+			journal: opts.journal ?? ctx.journal,
+			blobs,
+			executors: ctx.executors,
+			maxDepth: opts.maxDepth ?? 8,
+			...opts.probes ? { probes: opts.probes } : {},
+			...ctx.resume === true ? { resume: true } : {},
+			...opts.now ? { now: opts.now } : {}
+		});
+	};
+	return start();
 }
 //#endregion
-export { eventToSnapshot as $, createDelegateHandler as A, createSteerableSandboxSession as At, DelegationTaskQueue as B, runAgentRounds as Bt, DELEGATE_FEEDBACK_INPUT_SCHEMA as C, createFileRunContext as Ct, DELEGATE_DESCRIPTION as D, createExecutorRegistry as Dt, validateDelegateFeedbackArgs as E, createExecutor as Et, assessAuthoredProfile as F, decodeToolPart as Ft, capDelegationTrace as G, assertModelAllowed as Gt, DELEGATION_TRACE_MAX_BYTES as H, createSandboxLineage as Ht, authoredWorker as I, sandboxSessionTraceSource as It, DelegationPersistenceError as J, composeLoopTraceEmitters as K, gateOnDeliverable as Kt, defaultProfileRichnessThresholds as L, createInbox as Lt, defaultDelegateBudget as M, piExecutor as Mt, delegate as N, piSeamKey as Nt, DELEGATE_INPUT_SCHEMA as O, createWorktreeCliExecutor as Ot, asAuthoredProfile as P, createPushTraceSource as Pt, InMemoryFeedbackStore as Q, profileRichnessFinding as R, createSandboxForSpec as Rt, DELEGATE_FEEDBACK_DESCRIPTION as S, watchTrace as St, createDelegateFeedbackHandler as T, cliWorktreeExecutor as Tt, DELEGATION_TRACE_MAX_SPANS as U, probeSandboxCapabilities as Ut, hashIdempotencyInput as V, runLoop as Vt, buildDelegationTraceSpans as W, acquireSandbox as Wt, FileDelegationStore as X, DelegationStateCorruptError as Y, InMemoryDelegationStore as Z, DELEGATE_UI_AUDIT_DESCRIPTION as _, effectiveConcurrency as _t, createInProcessTransport as a, createProgressTracker as at, createDelegateUiAuditHandler as b, rollingDispatch as bt, DELEGATION_STATUS_INPUT_SCHEMA as c, sampleFromSettled as ct, validateDelegationStatusArgs as d, bestSoFar as dt, driverAgent as et, DELEGATION_HISTORY_DESCRIPTION as f, plateauLength as ft, validateDelegationHistoryArgs as g, createEventBus as gt, createDelegationHistoryHandler as h, createCoordinationTools as ht, serveCoordinationMcp as i, anyOf as it, validateDelegateArgs as j, PI_RUNTIME as jt, DELEGATE_TOOL_NAME as k, DEFAULT_SANDBOX_STEERING_MAX_TURNS as kt, DELEGATION_STATUS_TOOL_NAME as l, anytimeReport as lt, DELEGATION_HISTORY_TOOL_NAME as m, DEFAULT_AWAIT_EVENT_TIMEOUT_MS as mt, workerFromBackend as n, allOf as nt, createMcpServer as o, noProgressFor as ot, DELEGATION_HISTORY_INPUT_SCHEMA as p, renderAnytimeTable as pt, createDelegationTraceCollector as q, supervisorAgent as r, allWorkersStalled as rt, DELEGATION_STATUS_DESCRIPTION as s, plateau as st, supervise as t, finalizeBestDelivered as tt, createDelegationStatusHandler as u, areaUnderCurve as ut, DELEGATE_UI_AUDIT_INPUT_SCHEMA as v, freeSlots as vt, DELEGATE_FEEDBACK_TOOL_NAME as w, createInMemoryRunContext as wt, validateDelegateUiAuditArgs as x, defaultToolDetectors as xt, DELEGATE_UI_AUDIT_TOOL_NAME as y, queueOf as yt, supervisorInstructions as z, defaultSelectWinner as zt };
+export { eventToSnapshot as $, createDelegateHandler as A, createSteerableSandboxSession as At, DelegationTaskQueue as B, runAgentRounds as Bt, DELEGATE_FEEDBACK_INPUT_SCHEMA as C, createFileRunContext as Ct, DELEGATE_DESCRIPTION as D, createExecutorRegistry as Dt, validateDelegateFeedbackArgs as E, createExecutor as Et, assessAuthoredProfile as F, decodeToolPart as Ft, capDelegationTrace as G, FileCoordinationLog as Gt, DELEGATION_TRACE_MAX_BYTES as H, createSandboxLineage as Ht, authoredWorker as I, sandboxSessionTraceSource as It, DelegationPersistenceError as J, composeLoopTraceEmitters as K, assertModelAllowed as Kt, defaultProfileRichnessThresholds as L, createInbox as Lt, defaultDelegateBudget as M, piExecutor as Mt, delegate as N, piSeamKey as Nt, DELEGATE_INPUT_SCHEMA as O, createWorktreeCliExecutor as Ot, asAuthoredProfile as P, createPushTraceSource as Pt, InMemoryFeedbackStore as Q, profileRichnessFinding as R, createSandboxForSpec as Rt, DELEGATE_FEEDBACK_DESCRIPTION as S, watchTrace as St, createDelegateFeedbackHandler as T, cliWorktreeExecutor as Tt, DELEGATION_TRACE_MAX_SPANS as U, probeSandboxCapabilities as Ut, hashIdempotencyInput as V, runLoop as Vt, buildDelegationTraceSpans as W, acquireSandbox as Wt, FileDelegationStore as X, DelegationStateCorruptError as Y, InMemoryDelegationStore as Z, DELEGATE_UI_AUDIT_DESCRIPTION as _, effectiveConcurrency as _t, createInProcessTransport as a, createProgressTracker as at, createDelegateUiAuditHandler as b, rollingDispatch as bt, DELEGATION_STATUS_INPUT_SCHEMA as c, sampleFromSettled as ct, validateDelegationStatusArgs as d, bestSoFar as dt, driverAgent as et, DELEGATION_HISTORY_DESCRIPTION as f, plateauLength as ft, validateDelegationHistoryArgs as g, createEventBus as gt, createDelegationHistoryHandler as h, createCoordinationTools as ht, serveCoordinationMcp as i, anyOf as it, validateDelegateArgs as j, PI_RUNTIME as jt, DELEGATE_TOOL_NAME as k, DEFAULT_SANDBOX_STEERING_MAX_TURNS as kt, DELEGATION_STATUS_TOOL_NAME as l, anytimeReport as lt, DELEGATION_HISTORY_TOOL_NAME as m, DEFAULT_AWAIT_EVENT_TIMEOUT_MS as mt, workerFromBackend as n, allOf as nt, createMcpServer as o, noProgressFor as ot, DELEGATION_HISTORY_INPUT_SCHEMA as p, renderAnytimeTable as pt, createDelegationTraceCollector as q, gateOnDeliverable as qt, supervisorAgent as r, allWorkersStalled as rt, DELEGATION_STATUS_DESCRIPTION as s, plateau as st, supervise as t, finalizeBestDelivered as tt, createDelegationStatusHandler as u, areaUnderCurve as ut, DELEGATE_UI_AUDIT_INPUT_SCHEMA as v, freeSlots as vt, DELEGATE_FEEDBACK_TOOL_NAME as w, createInMemoryRunContext as wt, validateDelegateUiAuditArgs as x, defaultToolDetectors as xt, DELEGATE_UI_AUDIT_TOOL_NAME as y, queueOf as yt, supervisorInstructions as z, defaultSelectWinner as zt };
 
-//# sourceMappingURL=supervise-BiRutHS9.js.map
+//# sourceMappingURL=supervise-JfKPwIlO.js.map