@tangle-network/agent-runtime 0.348.1 → 0.350.2

package/dist/{coordination-manager-Bm6leXc6.js → coordination-manager-BkVfWlMz.js}

@@ -1,13 +1,13 @@
-import { c as captureRunWriteContext, t as spawnJournalRecordEvents } from "./record-events-D93DkpAx.js";
-import { $ as resolveSpawnResourcePaths, Ct as readCommittedJsonLines, Dt as createExecutorRegistry, Ei as settlementFailureCause, Fn as INBOX_RECEIPT_KEY, G as meterRuntimeOwnedAccounting, Hn as createPeerMailbox, Li as detachedFrozen, R as runtimeGraphMetadataKey, S as workerTraceAnalysisStore, Vi as errMessage, Xi as resolveRedactor, Xn as isLiveNodeStatus, Zn as isTerminalNodeStatus, _ as withDriverExecutor, _t as InMemorySpawnJournal, dr as CheckUnavailableError, gt as InMemoryResultBlobStore, k as FileSpawnJournal, qi as assertValidBudget, vt as FileResultBlobStore, x as parseWorkerToolTraceArtifact, xr as failedItems, yr as checkVerdictOf, yt as appendCommittedJsonLine, zi as contentAddress } from "./supervisor-DDy0aEtR.js";
-import { C as writeWorkerCancellation, T as writeWorkerSteerAcknowledgement, c as writeRunCancellation, g as readWorkerSteerRequests, h as readWorkerSteerAcknowledgement, i as readRunCancellation, m as readWorkerCancellation, p as readWorkerCancelRequests, r as readRunCancelRequest, t as applyRunCancellation, u as claimWorkerSteerDelivery } from "./run-cancellation-CzFhQGMa.js";
+import { c as captureRunWriteContext, t as spawnJournalRecordEvents } from "./record-events-B2GUgYdz.js";
+import { $ as resolveSpawnResourcePaths, Ct as readCommittedJsonLines, Dt as createExecutorRegistry, Fn as INBOX_RECEIPT_KEY, G as meterRuntimeOwnedAccounting, Hn as createPeerMailbox, Oi as settlementFailureCause, Qi as resolveRedactor, R as runtimeGraphMetadataKey, S as workerTraceAnalysisStore, Ui as errMessage, Vi as contentAddress, Xn as isLiveNodeStatus, Yi as assertValidBudget, Zn as isTerminalNodeStatus, _ as withDriverExecutor, _t as InMemorySpawnJournal, dr as CheckUnavailableError, gt as InMemoryResultBlobStore, k as FileSpawnJournal, vt as FileResultBlobStore, x as parseWorkerToolTraceArtifact, xr as failedItems, yr as checkVerdictOf, yt as appendCommittedJsonLine, zi as detachedFrozen } from "./supervisor-C1OePYE-.js";
+import { C as writeWorkerCancellation, T as writeWorkerSteerAcknowledgement, c as writeRunCancellation, g as readWorkerSteerRequests, h as readWorkerSteerAcknowledgement, i as readRunCancellation, m as readWorkerCancellation, p as readWorkerCancelRequests, r as readRunCancelRequest, t as applyRunCancellation, u as claimWorkerSteerDelivery } from "./run-cancellation-BLy_Zz-w.js";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest } from "@tangle-network/agent-interface";
 import { argHash, errorStreakDetector, observeAll, repeatedActionDetector } from "@tangle-network/agent-eval";
 import { registry } from "zod";
 import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
-//#region src/runtime/supervise/coordination-log.ts
+// src/runtime/supervise/coordination-log.ts
 /**
 * Durable side-log for coordination evidence the spawn journal does not own: questions, analyst
 * findings, answer decisions, authorized continuation receipts, delivery-attempt markers, and
@@ -117,8 +117,7 @@ async function foldCoordinationRecords(source, runId, ownerId) {
 		records
 	};
 }
-//#endregion
-//#region src/runtime/supervise/run-context.ts
+// src/runtime/supervise/run-context.ts
 /**
 *
 * `createInMemoryRunContext` — the one-call bundle of the in-memory stores a
@@ -193,8 +192,7 @@ function createFileRunContext(dir, opts = {}) {
 		coordinationLog: new FileCoordinationLog(`${dir}/coordination-log.jsonl`)
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-json.ts
+// src/mcp/tools/coordination-json.ts
 /** Stringify a findings payload for a routed delivery; never throws (a cyclic payload degrades to
 *  its String form rather than killing the settle path). */
 function safeJsonText(value) {
@@ -205,8 +203,7 @@ function safeJsonText(value) {
 		return String(value);
 	}
 }
-//#endregion
-//#region src/mcp/tools/coordination-events.ts
+// src/mcp/tools/coordination-events.ts
 /** Default and maximum bounds for one {@link CoordinationTools} journal read. The defaults are
 *  sized for a driver turn (a page a model can read and still have room to act on); the maxima
 *  bound what a single tool result may cost even when the caller asks for everything. */
@@ -281,8 +278,7 @@ const wakeEventKinds = [
 	"lead-message",
 	"map"
 ];
-//#endregion
-//#region src/mcp/tools/coordination-analysts.ts
+// src/mcp/tools/coordination-analysts.ts
 /**
 * The trace-tool sets a DEFINED analyst may ask for — the exact group names agent-eval's
 * `buildTraceToolsForGroup` accepts, restated here so the `define_analyst` JSON Schema can
@@ -402,15 +398,17 @@ function parseAuthoredAnalystDefinition(raw) {
 		message: `must be one of ${analystToolGroupNames.join(", ")}`
 	});
 	let model;
-	if (o.model !== void 0) if (typeof o.model !== "string" || o.model.trim().length === 0) issues.push({
-		path: "model",
-		message: "must be a non-empty string when present"
-	});
-	else if (o.model.length > bounds.maxModelChars) issues.push({
-		path: "model",
-		message: `must be at most ${bounds.maxModelChars} characters`
-	});
-	else model = o.model.trim();
+	if (o.model !== void 0) {
+		if (typeof o.model !== "string" || o.model.trim().length === 0) issues.push({
+			path: "model",
+			message: "must be a non-empty string when present"
+		});
+		else if (o.model.length > bounds.maxModelChars) issues.push({
+			path: "model",
+			message: `must be at most ${bounds.maxModelChars} characters`
+		});
+		else model = o.model.trim();
+	}
 	const clampedLimit = (field, max, source) => {
 		const value = source[field];
 		if (value === void 0) return void 0;
@@ -424,33 +422,35 @@ function parseAuthoredAnalystDefinition(raw) {
 		return Math.min(value, max);
 	};
 	let limits;
-	if (o.limits !== void 0) if (!o.limits || typeof o.limits !== "object" || Array.isArray(o.limits)) issues.push({
-		path: "limits",
-		message: "must be an object"
-	});
-	else {
-		const source = o.limits;
-		const knownLimits = /* @__PURE__ */ new Set([
-			"maxIterations",
-			"maxLlmCalls",
-			"maxToolCalls",
-			"maxOutputChars"
-		]);
-		for (const key of Object.keys(source)) if (!knownLimits.has(key)) issues.push({
-			path: `limits.${key}`,
-			message: `is not an investigation limit (accepted: ${[...knownLimits].join(", ")})`
+	if (o.limits !== void 0) {
+		if (!o.limits || typeof o.limits !== "object" || Array.isArray(o.limits)) issues.push({
+			path: "limits",
+			message: "must be an object"
 		});
-		const maxIterations = clampedLimit("maxIterations", bounds.maxIterations, source);
-		const maxLlmCalls = clampedLimit("maxLlmCalls", bounds.maxLlmCalls, source);
-		const maxToolCalls = clampedLimit("maxToolCalls", bounds.maxToolCalls, source);
-		const maxOutputChars = clampedLimit("maxOutputChars", bounds.maxOutputChars, source);
-		const present = {
-			...maxIterations === void 0 ? {} : { maxIterations },
-			...maxLlmCalls === void 0 ? {} : { maxLlmCalls },
-			...maxToolCalls === void 0 ? {} : { maxToolCalls },
-			...maxOutputChars === void 0 ? {} : { maxOutputChars }
-		};
-		if (Object.keys(present).length > 0) limits = present;
+		else {
+			const source = o.limits;
+			const knownLimits = /* @__PURE__ */ new Set([
+				"maxIterations",
+				"maxLlmCalls",
+				"maxToolCalls",
+				"maxOutputChars"
+			]);
+			for (const key of Object.keys(source)) if (!knownLimits.has(key)) issues.push({
+				path: `limits.${key}`,
+				message: `is not an investigation limit (accepted: ${[...knownLimits].join(", ")})`
+			});
+			const maxIterations = clampedLimit("maxIterations", bounds.maxIterations, source);
+			const maxLlmCalls = clampedLimit("maxLlmCalls", bounds.maxLlmCalls, source);
+			const maxToolCalls = clampedLimit("maxToolCalls", bounds.maxToolCalls, source);
+			const maxOutputChars = clampedLimit("maxOutputChars", bounds.maxOutputChars, source);
+			const present = {
+				...maxIterations === void 0 ? {} : { maxIterations },
+				...maxLlmCalls === void 0 ? {} : { maxLlmCalls },
+				...maxToolCalls === void 0 ? {} : { maxToolCalls },
+				...maxOutputChars === void 0 ? {} : { maxOutputChars }
+			};
+			if (Object.keys(present).length > 0) limits = present;
+		}
 	}
 	let minimumEvidenceCitations;
 	if (o.minimumEvidenceCitations !== void 0) {
@@ -497,8 +497,7 @@ function normalizeAnalyzeOnSettle(entry) {
 	if (route.statuses !== void 0 && (!Array.isArray(route.statuses) || route.statuses.length === 0 || route.statuses.some((status) => status !== "done" && status !== "down"))) throw new TypeError("analyzeOnSettle.statuses must contain done or down");
 	return route;
 }
-//#endregion
-//#region src/mcp/tools/coordination-budget.ts
+// src/mcp/tools/coordination-budget.ts
 /** Each channel spent beyond its budget, as spent of budget: `tokens 235,857 of 42,000` or
 *  `deadline 3,857 s of 2,400 s`. */
 function budgetOverspendText(violation) {
@@ -602,8 +601,7 @@ const BUDGET_FIELD = {
 	iterations: "maxIterations",
 	usd: "maxUsd"
 };
-//#endregion
-//#region src/runtime/supervise/driver-control-acknowledgers.ts
+// src/runtime/supervise/driver-control-acknowledgers.ts
 /** The journal file `createFileRunContext` writes inside the run directory. The acknowledger
 *  reads it as EVIDENCE for the terminated-descendants set — the nested trees of a cancelled
 *  lead journal their terminal records there before the lead settles into this scope. */
@@ -973,8 +971,7 @@ function terminatedDescendants(dir, nodeId, sinceIso) {
 function isDirectChildNodeId(owner, ref) {
 	return ref.startsWith(`${owner.ownerId}:s`) && /^s\d+$/.test(ref.slice(owner.ownerId.length + 1));
 }
-//#endregion
-//#region src/runtime/supervise/event-bus.ts
+// src/runtime/supervise/event-bus.ts
 /** Create the child→parent coordination bus: one typed pipe for settled outputs, questions, and analyst findings, with a priority-ordered pull queue and a pass-through subscribe lane.
 * @experimental In-process queue; durability is a transport swap that does not exist yet. */
 function createEventBus(now = Date.now) {
@@ -1061,8 +1058,7 @@ function createEventBus(now = Date.now) {
 		}
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-analysis.ts
+// src/mcp/tools/coordination-analysis.ts
 function createCoordinationAnalysis(deps) {
 	const { opts } = deps;
 	const analysisRoutes = (opts.analyzeOnSettle ?? []).map(normalizeAnalyzeOnSettle);
@@ -1151,7 +1147,8 @@ async function readTraceSpans(opts, worker) {
 		spanCount: 0
 	};
 	try {
-		const artifact = parseWorkerToolTraceArtifact(await opts.blobs.get(worker.trace.traceRef), worker.trace.traceRef);
+		const raw = await opts.blobs.get(worker.trace.traceRef);
+		const artifact = parseWorkerToolTraceArtifact(raw, worker.trace.traceRef);
 		return {
 			spansText: safeJsonText(artifact.spans),
 			spanCount: artifact.spans.length
@@ -1467,8 +1464,7 @@ async function recordManagerAnalysisFailure(state, error) {
 		});
 	}
 }
-//#endregion
-//#region src/mcp/tools/coordination-input.ts
+// src/mcp/tools/coordination-input.ts
 const urgencyPriority = (u) => u === "blocks-run" ? 20 : u === "blocks-step" ? 10 : 0;
 const str = (v, field) => {
 	if (typeof v !== "string" || v.length === 0) throw new Error(`coordination tools: "${field}" must be a non-empty string`);
@@ -1491,14 +1487,12 @@ const parseContinuity = (v) => {
 	if (v === "fresh" || v === "resume") return v;
 	throw new Error("coordination tools: \"continuity\" must be \"fresh\" or \"resume\"");
 };
-//#endregion
-//#region src/mcp/tools/coordination-worker-argument.ts
+// src/mcp/tools/coordination-worker-argument.ts
 const idArg = {
 	type: "string",
 	description: "The workerId returned by spawn_worker."
 };
-//#endregion
-//#region src/mcp/tools/coordination-analyst-tools.ts
+// src/mcp/tools/coordination-analyst-tools.ts
 function mountAnalystsTools({ opts, tools, ledger, nodeForWorker, analystMenu, analystRunContext, defineAnalyst }) {
 	if (opts.analysts) {
 		tools.push({
@@ -1646,8 +1640,7 @@ function mountAnalystsTools({ opts, tools, ledger, nodeForWorker, analystMenu, a
 		});
 	}
 }
-//#endregion
-//#region src/mcp/tools/coordination-tool-timeout.ts
+// src/mcp/tools/coordination-tool-timeout.ts
 async function runWithin(work, ms, message) {
 	let timer;
 	const timeout = new Promise((_, reject) => {
@@ -1660,8 +1653,7 @@ async function runWithin(work, ms, message) {
 		if (timer) clearTimeout(timer);
 	}
 }
-//#endregion
-//#region src/mcp/tools/coordination-audit-tools.ts
+// src/mcp/tools/coordination-audit-tools.ts
 function createAuditTools({ opts, tools, blockedReports, readJournal }) {
 	return [{
 		name: "report_blocked",
@@ -1800,8 +1792,7 @@ const unprobeableVerbs = /* @__PURE__ */ new Set([
 	"report_blocked"
 ]);
 const REPORT_BLOCKED_PROBE_MS = 6e4;
-//#endregion
-//#region src/mcp/tools/coordination-down-messages.ts
+// src/mcp/tools/coordination-down-messages.ts
 function createDownMessages({ opts, bus, lifetime }) {
 	async function sendDown(type, down, questionIdOrAnalyst) {
 		await bus.publish(type === "answer" ? {
@@ -1938,8 +1929,7 @@ function createDownMessages({ opts, bus, lifetime }) {
 		steerWorker
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-graph-tools.ts
+// src/mcp/tools/coordination-graph-tools.ts
 function mountGraphsTools({ opts, tools, admitSpawn }) {
 	if (opts.graphs) {
 		const graphs = opts.graphs;
@@ -2015,8 +2005,7 @@ function mountGraphsTools({ opts, tools, admitSpawn }) {
 		});
 	}
 }
-//#endregion
-//#region src/mcp/tools/coordination-journal-reader.ts
+// src/mcp/tools/coordination-journal-reader.ts
 function createJournalReader({ opts, bus }) {
 	let journalReadTo = 0;
 	const redactJournalEvent = resolveRedactor(opts.redactJournal);
@@ -2131,8 +2120,7 @@ function createJournalReader({ opts, bus }) {
 		readTo: () => journalReadTo
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-lead-intake.ts
+// src/mcp/tools/coordination-lead-intake.ts
 /**
 * What reaches a manager from outside its tools: lead messages from its parent, and the outcomes
 * of tool calls that outlived their response fence. Both are open work until they are delivered.
@@ -2216,8 +2204,7 @@ function leadMessageOf(message) {
 		interrupt
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-event-projection.ts
+// src/mcp/tools/coordination-event-projection.ts
 const eventWorker = (event) => event.type === "settled" ? event.worker.id : event.type === "finding" ? event.finding.fromWorker : event.type === "question" ? event.question.from : event.type === "map" ? event.map.sourceWorker : void 0;
 const projectEvent = (ev) => {
 	if (ev.type === "settled") {
@@ -2300,8 +2287,7 @@ const projectEvent = (ev) => {
 		...ev.down
 	};
 };
-//#endregion
-//#region src/mcp/tools/coordination-manager-reentry.ts
+// src/mcp/tools/coordination-manager-reentry.ts
 function managerReentryState({ opts, ledger, deliveries, priorJournal, bus, journal, openWork, driverAttempt, lastRejection }) {
 	const { unqueued, queued } = openWork();
 	const deliveredSettled = new Set(deliveries.flatMap((delivery) => delivery.record.event.type === "settled" ? [delivery.record.event.worker.id] : []));
@@ -2343,8 +2329,7 @@ function managerReentryState({ opts, ledger, deliveries, priorJournal, bus, jour
 		...lastRejection === void 0 ? {} : { lastRejection }
 	});
 }
-//#endregion
-//#region src/mcp/tools/coordination-manager-state.ts
+// src/mcp/tools/coordination-manager-state.ts
 function createManagerState(opts) {
 	const priorSubmission = opts.deliverable === void 0 ? void 0 : opts.priorJournal?.find((record) => record.event.type === "submission");
 	return {
@@ -2408,8 +2393,7 @@ async function acknowledgeDeliveries({ opts, bus, state, leadReceipts }, targets
 	for (const delivery of fresh) delivery.acknowledged = true;
 	return seqs;
 }
-//#endregion
-//#region src/mcp/tools/coordination-manager-waiting.ts
+// src/mcp/tools/coordination-manager-waiting.ts
 function createManagerWaiting(env) {
 	return {
 		ensureDrain: ensureDrain.bind(null, env),
@@ -2580,8 +2564,7 @@ async function awaitSettlement(env, workerIds, signal) {
 		})])) && settledIds().length === 0) return [];
 	}
 }
-//#endregion
-//#region src/mcp/tools/coordination-runtime-spawn.ts
+// src/mcp/tools/coordination-runtime-spawn.ts
 /**
 * Admit one keyed runtime spawn. A key whose prior worker is in doubt (started in a dead process
 * with no terminal receipt) is re-admitted once under `<key>#2`, the replacement key the
@@ -2607,8 +2590,7 @@ async function admitRuntimeSpawn(admitSpawn, input) {
 	}
 	return { inDoubt: true };
 }
-//#endregion
-//#region src/mcp/tools/coordination-map-routing.ts
+// src/mcp/tools/coordination-map-routing.ts
 function createMapRouting(deps) {
 	const state = {
 		...deps,
@@ -2929,8 +2911,7 @@ function resolveJsonPointer(document, pointer) {
 		value
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-question-ledger.ts
+// src/mcp/tools/coordination-question-ledger.ts
 function createQuestionLedger({ opts, bus }) {
 	let questionSeq = 0;
 	const questions = [...opts.priorQuestions ?? []];
@@ -3054,8 +3035,7 @@ function createQuestionLedger({ opts, bus }) {
 		blockingQuestionsForStop
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-messages.ts
+// src/mcp/tools/coordination-messages.ts
 /**
 * Why one parent→child delivery did not land, in the words the MANAGER needs.
 *
@@ -3072,14 +3052,12 @@ const downMessageRefusalReasons = Object.freeze({
 	"scope-stopped": "this manager’s scope has stopped, so no further message may be sent from it",
 	"runtime-error": "the executor threw while accepting the message; the worker may or may not have received it"
 });
-//#endregion
-//#region src/mcp/tools/coordination-questions.ts
+// src/mcp/tools/coordination-questions.ts
 /** Where a question this driver cannot answer goes next. `answer_question` accepts these and
 *  nothing else, so the decision type states them and nothing else. */
 const questionEscalationTargets = ["parent", "user"];
 const isQuestionEscalationTarget = (value) => questionEscalationTargets.includes(value);
-//#endregion
-//#region src/mcp/tools/coordination-question-tools.ts
+// src/mcp/tools/coordination-question-tools.ts
 function createQuestionTools({ questionLedger, messages }) {
 	return [
 		{
@@ -3234,8 +3212,7 @@ function createQuestionTools({ questionLedger, messages }) {
 		}
 	];
 }
-//#endregion
-//#region src/mcp/tools/coordination-completion-refusal.ts
+// src/mcp/tools/coordination-completion-refusal.ts
 /**
 * The refusal a failed check reading returns to `submit_result`: the verdict as a located fact,
 * the FAIL lines unless the check's tests must stay hidden, and how many times the manager has
@@ -3256,8 +3233,7 @@ function refusalText(verdict, deliverable, read) {
 		...lines.length > shown.length ? [`${lines.length - shown.length} more failure lines.`] : []
 	].join("\n");
 }
-//#endregion
-//#region src/mcp/tools/coordination-result-tools.ts
+// src/mcp/tools/coordination-result-tools.ts
 /**
 * The tools that end a manager: `submit_result` when it has an independent check, otherwise
 * `stop`, then `read_continuation` when the run keeps continuation notes.
@@ -3441,8 +3417,7 @@ function readContinuationTool(opts) {
 		}
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-route-routing.ts
+// src/mcp/tools/coordination-route-routing.ts
 /**
 * The flow scheduler of one manager: entry and route spawns are runtime spawns, like map items.
 * It has two call sites. `start` spawns every entry when the manager's coordination opens, before
@@ -3888,8 +3863,7 @@ function gateDecision(answer, choices) {
 	};
 	return `${shown} — expected { kind: 'choose', choice, by } or { kind: 'stop', reason, by }`;
 }
-//#endregion
-//#region src/mcp/tools/coordination-settlement-drain.ts
+// src/mcp/tools/coordination-settlement-drain.ts
 function createSettlementDrain({ opts, ledger, unwatchWorker, bus, analysis, maps, routes, workerRouteNames, projectSettled }) {
 	const hooked = /* @__PURE__ */ new Set();
 	const commitSettled = (w) => {
@@ -4027,8 +4001,7 @@ function createSettlementDrain({ opts, ledger, unwatchWorker, bus, analysis, map
 		isBusy: () => pendingSettlement !== void 0 || flushing > 0
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-budget-override.ts
+// src/mcp/tools/coordination-budget-override.ts
 const mergeBudget = (base, raw) => {
 	if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("coordination tools: \"budget\" must be an object");
 	const o = raw;
@@ -4058,8 +4031,7 @@ const mergeBudget = (base, raw) => {
 	assertValidBudget(merged, "coordination tools: budget");
 	return merged;
 };
-//#endregion
-//#region src/mcp/tools/coordination-model-attribution.ts
+// src/mcp/tools/coordination-model-attribution.ts
 /**
 * The substitution and the sentence a manager reads beside it. A manager that reports which model
 * did the work must read `modelSubstitution.ran`, never the model it asked for.
@@ -4070,8 +4042,7 @@ function modelSubstitutionReport(substitution) {
 		modelWarning: `spawn authorization ran this worker on ${substitution.ran}, not the ${substitution.requested} you authored; attribute its work to ${substitution.ran}`
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-spawn-admission.ts
+// src/mcp/tools/coordination-spawn-admission.ts
 function createSpawnAdmission(deps) {
 	const state = {
 		...deps,
@@ -4314,8 +4285,7 @@ function nextUnkeyedAssignmentOrdinal(scope) {
 	if (!Number.isSafeInteger(next)) throw new Error("coordination: durable assignment ordinal space is exhausted");
 	return next;
 }
-//#endregion
-//#region src/runtime/supervise/detector-monitor.ts
+// src/runtime/supervise/detector-monitor.ts
 /**
 *
 * The ONLINE analyst: watch a `TraceSource` and fold each tool span through agent-eval's published
@@ -4356,14 +4326,14 @@ function watchTrace(source, opts = {}) {
 		for (const s of signals) opts.onSignal?.(s, span);
 	});
 }
-//#endregion
-//#region src/mcp/tools/coordination-worker-observation.ts
+// src/mcp/tools/coordination-worker-observation.ts
 function createWorkerObservation({ opts, ledger, flushedAnalystRuns, bus, deadlineNoticeDelivered, leadPublishing }) {
 	const liveWorkerCount = () => opts.scope.view.nodes.filter((n) => isLiveNodeStatus(n.status)).length;
 	const queuedWorkerCount = () => opts.scope.view.nodes.filter((n) => n.status === "queued").length;
 	const projectNodeEvidence = (node, resumed = false) => ({
 		id: node.id,
 		status: node.status,
+		...node.failure === void 0 ? {} : { failure: node.failure },
 		...node.assignmentId === void 0 ? {} : { assignmentId: node.assignmentId },
 		...node.identity === void 0 ? {} : { identity: node.identity },
 		...node.modelSubstitution === void 0 ? {} : modelSubstitutionReport(node.modelSubstitution),
@@ -4488,8 +4458,7 @@ function createWorkerObservation({ opts, ledger, flushedAnalystRuns, bus, deadli
 		unwatchWorker
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-worker-settlement.ts
+// src/mcp/tools/coordination-worker-settlement.ts
 function createWorkerSettlement({ opts, nodeForWorker }) {
 	const descendantOutRefs = new Set(opts.sourceEvidenceRefs ?? []);
 	const projectSettled = (settled, resumed = false) => {
@@ -4543,8 +4512,7 @@ function createWorkerSettlement({ opts, nodeForWorker }) {
 		projectSettled
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-profile-schema.ts
+// src/mcp/tools/coordination-profile-schema.ts
 /**
 * Strip zod's object-KEY CODEC artifact from a derived JSON Schema, at every depth.
 *
@@ -4604,7 +4572,7 @@ const spawnProfileFields = [
 	},
 	{
 		name: "prompt",
-		description: "The child's standing instructions: `systemPrompt` (who it is and how it works) and `instructions` (durable rules). This is the role; the separate `task` argument carries what to do right now. A child with no systemPrompt has no role — always set one."
+		description: "The child's standing instructions: `appendSystemPrompt` (who it is and how it works; preserves native defaults) and `instructions` (durable rules). This is the role; the separate `task` argument carries what to do right now. Give each child instructions or appendSystemPrompt; systemPrompt explicitly replaces native defaults."
 	},
 	{
 		name: "tools",
@@ -4702,12 +4670,15 @@ let spawnProfileArgCache;
 *  keeps the conversion total: the canonical schema contains transforms with no JSON Schema form,
 *  and zod's default is to throw on them, which would leave the tool with no published shape. */
 function spawnProfileArg() {
-	if (!spawnProfileArgCache) spawnProfileArgCache = detachedFrozen(deriveSpawnProfileArg(agentProfileSchema.toJSONSchema({
-		metadata: registry(),
-		io: "input",
-		target: "draft-07",
-		unrepresentable: "any"
-	}).properties));
+	if (!spawnProfileArgCache) {
+		const canonical = agentProfileSchema.toJSONSchema({
+			metadata: registry(),
+			io: "input",
+			target: "draft-07",
+			unrepresentable: "any"
+		});
+		spawnProfileArgCache = detachedFrozen(deriveSpawnProfileArg(canonical.properties));
+	}
 	return spawnProfileArgCache;
 }
 /** `spawn_worker`'s `profile` argument when the run has a profiles table: one of the table's names,
@@ -4737,8 +4708,7 @@ function profileTableRefusal(table, profile) {
 	if (typeof name !== "string" || !table.has(name)) return void 0;
 	return `profile.name ${JSON.stringify(name)} is a profiles-table entry: pass profile: ${JSON.stringify(name)} to run that exact profile, or give the profile you wrote another name`;
 }
-//#endregion
-//#region src/mcp/tools/worker-output.ts
+// src/mcp/tools/worker-output.ts
 const WORKER_OUTPUT_PAGE_CHARS = 16384;
 function workerOutputReadOptions(raw) {
 	const offset = raw.outputOffset ?? 0;
@@ -4841,8 +4811,7 @@ function createWorkerOutputReader(blobs) {
 		}
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-worker-tools.ts
+// src/mcp/tools/coordination-worker-tools.ts
 function createWorkerTools(ctx) {
 	return [
 		spawnWorkerTool(ctx),
@@ -5048,6 +5017,7 @@ function observeTree({ opts, redactJournalEvent }) {
 			parent: node.parent,
 			label: node.label,
 			status: node.status,
+			...node.failure === void 0 ? {} : { failure: node.failure },
 			runtime: node.runtime,
 			spawnedAt: node.spawnedAt,
 			settledAt: node.settledAt
@@ -5065,6 +5035,7 @@ function observeEvents({ opts, redactJournalEvent }, args, eventCursor) {
 		label: node.label,
 		status: node.status,
 		runtime: node.runtime,
+		...node.failure === void 0 ? {} : { failure: node.failure },
 		events: opts.scope.observeEvents?.(id, eventCursor) ?? {
 			status: "unavailable",
 			reason: "not-captured"
@@ -5199,8 +5170,7 @@ function cancelWorkerTool({ opts, spawn, workers }) {
 		}
 	};
 }
-//#endregion
-//#region src/mcp/tools/coordination-manager.ts
+// src/mcp/tools/coordination-manager.ts
 /** Build the driver's MCP tools over a live scope. */
 function createCoordinationTools(opts) {
 	return createCoordinationToolsForManager(opts);
@@ -5610,7 +5580,6 @@ function createResumeReplay({ opts, bus, ledger, analysis, projectSettled }) {
 		return readyInFlight;
 	};
 }
-//#endregion
-export { createEventBus as a, budgetOverspendText as c, safeJsonText as d, createFileRunContext as f, foldCoordinationRecords as g, FileCoordinationLog as h, watchTrace as i, normalizeAnalyzeOnSettle as l, withRunContext as m, createCoordinationToolsForManager as n, createCancelAcknowledger as o, createInMemoryRunContext as p, defaultToolDetectors as r, createSteerAcknowledger as s, createCoordinationTools as t, coordinationVerbNames as u };
+export { FileCoordinationLog as _, downMessageRefusalReasons as a, createCancelAcknowledger as c, normalizeAnalyzeOnSettle as d, coordinationVerbNames as f, withRunContext as g, createInMemoryRunContext as h, watchTrace as i, createSteerAcknowledger as l, createFileRunContext as m, createCoordinationToolsForManager as n, resolveJsonPointer as o, safeJsonText as p, defaultToolDetectors as r, createEventBus as s, createCoordinationTools as t, budgetOverspendText as u, foldCoordinationRecords as v };
 
-//# sourceMappingURL=coordination-manager-Bm6leXc6.js.map
+//# sourceMappingURL=coordination-manager-BkVfWlMz.js.map