@tangle-network/agent-runtime 0.326.1 → 0.328.0

package/dist/{activation-DKBSwzzM.d.ts → activation-CZRtcDPo.d.ts}

@@ -1,4 +1,4 @@
-import { $s as AgentTurnUsage, Ih as ExecutorConfig, US as OtelExportConfig, Xg as SharedBoxPlacementOptions, Yg as SharedBoxPlacement, ec as CollectedAgentTurn, jw as BudgetPool, kw as WorkerSlots } from "./types-BFDS9hpV.js";
+import { Iw as BudgetPool, JS as OtelExportConfig, Pw as WorkerSlots, Vh as ExecutorConfig, e_ as SharedBoxPlacement, ic as CollectedAgentTurn, rc as AgentTurnUsage, t_ as SharedBoxPlacementOptions } from "./types-0czU5q4A.js";
 import { AgentCandidateBundle, AgentImprovementActivation, AgentImprovementActivationOutcome, AgentImprovementActivationResult, AgentImprovementActivationTarget, AgentImprovementProposal, AgentImprovementReview, AgentImprovementSurface, AgentProfile, AgentProfileImprovementChange, AgentProfileImprovementExperiment, AgentTrainingReceipt, AgentTrainingTask, HarnessType, ReasoningEffort, Sha256Digest } from "@tangle-network/agent-interface";
 import { CostLedgerHandle, CostReceiptInput, MaximumCharge, PairedPromotionDecision, PendingCostCallView, ProposalFinding, RunRecord } from "@tangle-network/agent-eval";
 import { CampaignCellResult, CampaignScenarioIdentity, CampaignStorage, CompareOptimizationMethodsOptions, OptimizationMethod, OptimizationMethodComparison, Scenario, SearchAllocator, SearchCellResult, SearchCellStage, SearchClaim, SearchClaimVerification, SearchHistoryReceipt, SearchLane, SearchModelIdentity, SearchPolicy, SearchSourceRef, SearchSplit, SearchStateView, SurfaceProposer, WorktreeAdapter } from "@tangle-network/agent-eval/campaign";
@@ -1013,4 +1013,4 @@ declare function verifyAgentImprovementActivationResult(input: {
 declare function executeAgentImprovementActivation(input: ExecuteAgentImprovementActivationInput, options: ExecuteAgentImprovementActivationOptions): Promise<AgentImprovementActivationResult>;
 //#endregion
 export { ImproveScenarioPartitions as $, createCommandProfileTrainer as A, AgenticGeneratorShotReceipt as At, ImproveMethodContext as B, ControlledTrainingCommand as C, subscriptionLane as Ct, ProfileTrainerRequest as D, AgenticGeneratorOptions as Dt, ProfileTrainer as E, AgenticGeneratorExecutorForWorktree as Et, ImproveCodeResult as F, defaultBuildPrompt as Ft, ImproveMethodSource as G, ImproveMethodLineage as H, ImproveCodeRunOptions as I, CandidateGenerator as It, ImproveProfileAgent as J, ImproveOptimizationRunOptions as K, ImproveCost as L, ImproveCandidateValidator as M, VerifyResult as Mt, ImproveCodeBaseOptions as N, agenticGenerator as Nt, TrainingBoundaryResult as O, AgenticGeneratorShotDisposition as Ot, ImproveCodeOptions as P, commandVerifier as Pt, ImproveRuntimeCodeGeneratorOptions as Q, ImproveCustomCodeGeneratorOptions as R, CheckpointServingPort as S, sharedBoxLane as St, ImproveTrainingResult as T, ReadonlyAgentProfile as Tt, ImproveMethodOptions as U, ImproveMethodFactory as V, ImproveMethodResult as W, ImproveProfileSurface as X, ImproveProfileComponents as Y, ImproveResult as Z, SearchMethodOptions as _, SearchTraceOptions as _t, AgentImprovementActivationTransitionInput as a, ImproveSkillsOptions as at, SearchImprovementDecision as b, isSearchEnvironmentFault as bt, CreateAgentImprovementActivationResultOptions as c, ImprovementCodeCandidate as ct, ProfileImprovementActivationTransitionInput as d, SearchPromotion as dt, ImproveSearchAgent as et, SealedCandidateActivationTransitionInput as f, SearchCellContext as ft, improve as g, SearchLaneOptions as gt, verifyAgentImprovementActivationResult as h, SearchLaneKind as ht, AgentImprovementActivationTransition as i, ImproveSearchResult as it, ImproveCandidateValidationInput as j, Verifier as jt, TrainingDatasetDocument as k, AgenticGeneratorShotExecution as kt, ExecuteAgentImprovementActivationInput as l, ImprovementProfileCandidate as lt, executeAgentImprovementActivation as m, SearchLane$1 as mt, AgentImprovementActivationResultStore as n, ImproveSearchMethod as nt, AgentProfileImprovementActivationOperation as o, ImproveSurface as ot, createAgentImprovementActivationResult as p, SearchEnvironmentFault as pt, ImproveOptions as q, AgentImprovementActivationTargetPlan as r, ImproveSearchOptions as rt, AgentProfileImprovementActivationTargetPlan as s, ImprovementCandidate as st, AgentImprovementActivationReconciliation as t, ImproveSearchIdentity as tt, ExecuteAgentImprovementActivationOptions as u, SearchDispatchContext as ut, searchMethod as v, SharedBoxSearchLane as vt, ImproveTrainingOptions as w, DeepReadonly as wt, decideSearchImprovement as x, routerLane as xt, DecideSearchImprovementOptions as y, dedicatedLane as yt, ImproveLineage as z };
-//# sourceMappingURL=activation-DKBSwzzM.d.ts.map
+//# sourceMappingURL=activation-CZRtcDPo.d.ts.map

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-import { Kw as AgentRunSpec, S as RuntimeStreamEvent, _T as SandboxClient, hT as OutputAdapter } from "./types-BFDS9hpV.js";
+import { S as RuntimeStreamEvent, ST as SandboxClient, Zw as AgentRunSpec, bT as OutputAdapter } from "./types-0czU5q4A.js";
 import { C as worktreeCliProfileMaterialization, S as validateProfileMaterialization, _ as promptModelProfileMaterialization, a as DefineProfileMaterializationContractOptions, b as renderProfileMaterializationIssues, c as ProfileMaterializationIssue, d as assertProfileMaterializes, f as controlProfileMaterialization, g as promptControlProfileMaterialization, h as profileMaterializationAxes, i as CanonicalAgentProfileMaterializationAxis, l as ValidateProfileMaterializationOptions, m as fullProfileMaterialization, n as AgentProfileMaterializationAxis, o as KnownAgentProfileMaterializationAxis, p as defineProfileMaterializationContract, r as AssertProfileMaterializationOptions, s as ProfileMaterializationContract, t as AGENT_PROFILE_MATERIALIZATION_AXES, u as assertProfileMaterialization, v as promptOnlyProfileMaterialization, x as sandboxActProfileMaterialization, y as promptResourceProfileMaterialization } from "./profile-materialization-BnoEf1co.js";
 import { a as createSurfaceImprovementProposer, c as SurfaceValidationIssue, d as validateSurfaces, i as SurfaceImprovementEdit, l as renderSurfaceIssues, n as DraftPatchInput, o as AgentSurfaces, r as DraftPatchOutput, s as ResolvedSurface, t as CreateSurfaceImprovementProposerOptions, u as resolveSubjectPath } from "./improvement-adapter-D5gwwoXQ.js";
 import { AgentProfile, AgentProfileFileMount, AgentProfileMcpServer } from "@tangle-network/agent-interface";

package/dist/agent.js

@@ -1,5 +1,5 @@
 import { Gr as defineProfileMaterializationContract, Hr as assertProfileMaterialization, Jr as promptControlProfileMaterialization, Kr as fullProfileMaterialization, Qr as renderProfileMaterializationIssues, Ur as assertProfileMaterializes, Vr as AGENT_PROFILE_MATERIALIZATION_AXES, Wi as mapSandboxEvent, Wr as controlProfileMaterialization, Xr as promptOnlyProfileMaterialization, Yr as promptModelProfileMaterialization, Zr as promptResourceProfileMaterialization, ei as sandboxActProfileMaterialization, hn as createSandboxForSpec, ii as worktreeCliProfileMaterialization, qr as profileMaterializationAxes, ri as validateProfileMaterialization } from "./supervisor-hIpqcCJr.js";
-import "./runtime-DtG9pERP.js";
+import "./runtime-CYjHXjec.js";
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/{coordination-driver-CwisRZNE.js → coordination-driver-B7Z9jgFr.js}

@@ -521,7 +521,8 @@ const journalEventKinds = [
 	"analyst-assignment",
 	"acknowledgement",
 	"tool-outcome",
-	"lead-message"
+	"lead-message",
+	"map"
 ];
 /** The reserved coordination verb names — the complete set `createCoordinationTools` can emit
 *  (the analyst pair is conditional but still reserved). A driver's extra WORK tools must not
@@ -564,7 +565,8 @@ const wakeEventKinds = [
 	"settled",
 	"finding",
 	"tool-outcome",
-	"lead-message"
+	"lead-message",
+	"map"
 ];
 const idArg = {
 	type: "string",
@@ -1023,7 +1025,7 @@ function createCoordinationToolsForManager(opts, lifetime) {
 		checkReads.push(entry);
 		return entry;
 	};
-	const eventWorker = (event) => event.type === "settled" ? event.worker.id : event.type === "finding" ? event.finding.fromWorker : event.type === "question" ? event.question.from : void 0;
+	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 acknowledge = async (targets, by) => {
 		const fresh = targets.filter((delivery) => !delivery.acknowledged);
 		if (fresh.length === 0) return [];
@@ -1343,6 +1345,271 @@ function createCoordinationToolsForManager(opts, lifetime) {
 		analyst: kind,
 		sourceWorker
 	}, { alreadySpent: true }) });
+	const mapRoutes = opts.mapOnSettle ?? [];
+	const mapMembers = /* @__PURE__ */ new Map();
+	const textBytes = (value) => Buffer.byteLength(safeJsonText(value), "utf8");
+	const publishMap = async (event, wake = false) => {
+		const record = detachedFrozen({
+			type: "map",
+			map: event
+		});
+		if (wake) await bus.publish(record);
+		else await bus.publish(record, { queue: false });
+	};
+	const workerSlotBound = () => {
+		const capacity = opts.scope.workerCapacity;
+		if (capacity === void 0 || capacity.freeSlots === null) return void 0;
+		return capacity.working + capacity.freeSlots;
+	};
+	const mapSettlement = (settled, worker) => {
+		if (settled.kind !== "done" || worker.status !== "done") return {
+			outcome: "failed",
+			reason: worker.status === "down" ? worker.reason : "down"
+		};
+		if (worker.valid === false) return {
+			outcome: "failed",
+			reason: "its deliverable check rejected the result"
+		};
+		if (settled.out === void 0) return {
+			outcome: "empty",
+			reason: "it settled with no result"
+		};
+		return {
+			outcome: "delivered",
+			result: settled.out
+		};
+	};
+	const startMapSpawn = async (expansion, role, profile, task, index) => {
+		const { route } = expansion;
+		const name = typeof profile.name === "string" && profile.name.length > 0 ? profile.name : "worker";
+		let response;
+		try {
+			response = await admitSpawn({
+				profile,
+				args: {
+					label: index === void 0 ? name : `${name}#${index}`,
+					...role === "item" && route.itemBudget !== void 0 ? { budget: route.itemBudget } : {}
+				},
+				task,
+				key: void 0,
+				continuity: { continuity: "fresh" },
+				successorOf: void 0,
+				preflightProfile: () => opts.resolveSpawnProfile ? detachedFrozen(opts.resolveSpawnProfile(profile)) : profile,
+				resourcesFromPath: [],
+				defaultLabel: name,
+				map: Object.freeze({
+					edge: route.edge,
+					role,
+					...index === void 0 ? {} : { index }
+				})
+			});
+		} catch (error) {
+			return { refused: errMessage(error) };
+		}
+		const started = response;
+		if (typeof started.workerId === "string") {
+			mapMembers.set(started.workerId, {
+				expansion,
+				role,
+				...index === void 0 ? {} : { index },
+				bytes: textBytes(task)
+			});
+			return { workerId: started.workerId };
+		}
+		return { refused: typeof started.reason === "string" ? started.reason : "spawn refused" };
+	};
+	const mapItemProfile = async (route) => {
+		if ("profile" in route.item) return { profile: route.item.profile };
+		if (!opts.graphs) return { refused: "a graph item starts through run_graph, which this manager does not serve" };
+		const prepared = await opts.graphs.prepare({ graph: route.item.graph });
+		return prepared.ok ? { profile: detachedFrozen(prepared.profile) } : { refused: prepared.reason };
+	};
+	const startMapItem = async (expansion, index) => {
+		const { route } = expansion;
+		const resolved = await mapItemProfile(route);
+		const started = "refused" in resolved ? resolved : await startMapSpawn(expansion, "item", resolved.profile, expansion.items[index], index);
+		if ("workerId" in started) {
+			expansion.inFlight += 1;
+			return;
+		}
+		const reason = `item spawn refused: ${started.refused}`;
+		expansion.settlements[index] = {
+			outcome: "unpropagated",
+			reason
+		};
+		if (route.onItemFailure === "all-or-refuse") expansion.stopped = true;
+		await publishMap({
+			edge: route.edge,
+			phase: "item",
+			outcome: "unpropagated",
+			sourceWorker: expansion.sourceWorker,
+			index,
+			bytes: 0,
+			reason
+		});
+	};
+	const pumpMap = async (expansion) => {
+		const { route, items } = expansion;
+		while (!expansion.stopped && expansion.inFlight < route.concurrency && expansion.next < items.length) {
+			const index = expansion.next;
+			expansion.next += 1;
+			await startMapItem(expansion, index);
+		}
+		if (expansion.inFlight === 0) await finishMap(expansion);
+	};
+	const finishMap = async (expansion, closed) => {
+		if (expansion.finished) return;
+		expansion.finished = true;
+		const { route, items, sourceWorker } = expansion;
+		for (let index = expansion.next; index < items.length; index += 1) {
+			const reason = closed ?? "not started: all-or-refuse stopped this map after an item failed";
+			expansion.settlements[index] = {
+				outcome: "unpropagated",
+				reason
+			};
+			await publishMap({
+				edge: route.edge,
+				phase: "item",
+				outcome: "unpropagated",
+				sourceWorker,
+				index,
+				bytes: 0,
+				reason
+			});
+		}
+		expansion.next = items.length;
+		const results = [];
+		const failures = [];
+		items.forEach((item, index) => {
+			const settlement = expansion.settlements[index];
+			if (settlement?.outcome === "delivered") results.push({
+				index,
+				item,
+				result: settlement.result
+			});
+			else failures.push({
+				index,
+				item,
+				outcome: settlement?.outcome ?? "unpropagated",
+				reason: settlement?.reason ?? "never settled"
+			});
+		});
+		const refusal = closed ?? (route.onItemFailure === "all-or-refuse" && failures.length > 0 ? `all-or-refuse: ${failures.length} of ${items.length} items did not deliver (${failures.map((failure) => `#${failure.index} ${failure.outcome}: ${failure.reason}`).join("; ")}); the join did not run` : void 0);
+		if (refusal !== void 0) {
+			await publishMap({
+				edge: route.edge,
+				phase: "join",
+				outcome: "unpropagated",
+				sourceWorker,
+				bytes: 0,
+				reason: refusal
+			}, closed === void 0);
+			return;
+		}
+		const task = {
+			map: route.edge,
+			source: sourceWorker,
+			items: items.length,
+			results,
+			failures
+		};
+		const started = await startMapSpawn(expansion, "join", route.join, task, void 0);
+		if ("refused" in started) await publishMap({
+			edge: route.edge,
+			phase: "join",
+			outcome: "unpropagated",
+			sourceWorker,
+			bytes: 0,
+			reason: `join spawn refused: ${started.refused}`
+		}, true);
+	};
+	const settleMapMember = async (settled, worker, advance) => {
+		const member = mapMembers.get(worker.id);
+		if (member === void 0) return;
+		mapMembers.delete(worker.id);
+		const { expansion, role, index, bytes } = member;
+		const settlement = mapSettlement(settled, worker);
+		await publishMap({
+			edge: expansion.route.edge,
+			phase: role,
+			outcome: settlement.outcome,
+			sourceWorker: expansion.sourceWorker,
+			...index === void 0 ? {} : { index },
+			workerId: worker.id,
+			bytes,
+			...settlement.reason === void 0 ? {} : { reason: settlement.reason }
+		});
+		if (role === "join" || index === void 0) return;
+		expansion.inFlight -= 1;
+		expansion.settlements[index] = settlement;
+		if (settlement.outcome !== "delivered" && expansion.route.onItemFailure === "all-or-refuse") expansion.stopped = true;
+		if (advance) await pumpMap(expansion);
+		else if (expansion.inFlight === 0) await finishMap(expansion, "not started: the manager stopped before this map finished");
+	};
+	const expandMaps = async (settled, worker) => {
+		if (settled.kind !== "done" || mapRoutes.length === 0) return;
+		const name = profileNameByWorker.get(worker.id);
+		for (const route of mapRoutes) {
+			if (route.from !== name) continue;
+			const refuse = (reason) => publishMap({
+				edge: route.edge,
+				phase: "expand",
+				outcome: "unpropagated",
+				sourceWorker: worker.id,
+				bytes: 0,
+				reason
+			}, true);
+			const selected = resolveJsonPointer(settled.out, route.pointer);
+			if (!selected.found) {
+				await refuse(`pointer ${JSON.stringify(route.pointer)} does not resolve in the source result: ${selected.reason}; no item ran`);
+				continue;
+			}
+			const items = selected.value;
+			if (!Array.isArray(items)) {
+				await refuse(`pointer ${JSON.stringify(route.pointer)} resolves to ${items === null ? "null" : typeof items}, not an array; no item ran`);
+				continue;
+			}
+			if (items.length > route.maxItems) {
+				await refuse(`max-items-exceeded: the list holds ${items.length} items and this map admits at most ${route.maxItems}; no item ran`);
+				continue;
+			}
+			const slots = workerSlotBound();
+			if (slots !== void 0 && route.concurrency > slots) {
+				await refuse(`concurrency-unsatisfiable: concurrency ${route.concurrency} exceeds this run's ${slots} worker slots, so the cap could never be honored; no item ran`);
+				continue;
+			}
+			await publishMap({
+				edge: route.edge,
+				phase: "expand",
+				outcome: items.length === 0 ? "empty" : "delivered",
+				sourceWorker: worker.id,
+				bytes: textBytes(items),
+				items: items.length,
+				...items.length === 0 ? { reason: "the list is empty; the join runs with no results" } : {}
+			});
+			await pumpMap({
+				route,
+				sourceWorker: worker.id,
+				items: detachedFrozen(items),
+				settlements: [],
+				next: 0,
+				inFlight: 0,
+				stopped: false,
+				finished: false
+			});
+		}
+	};
+	const runMapStep = async (step, worker) => {
+		try {
+			await step();
+		} catch (error) {
+			console.error("Runtime map step failed", {
+				managerId: opts.scope.view.root,
+				worker: worker.id,
+				error: errMessage(error)
+			});
+		}
+	};
 	let flushing = 0;
 	const flushPendingSettlement = async () => {
 		flushing += 1;
@@ -1355,7 +1622,8 @@ function createCoordinationToolsForManager(opts, lifetime) {
 	const flushPendingSettlementOnce = async () => {
 		const pending = pendingSettlement;
 		if (!pending) return false;
-		await bus.publish(pending.event);
+		if (mapMembers.get(pending.worker.id)?.role === "item") await bus.publish(pending.event, { queue: false });
+		else await bus.publish(pending.event);
 		if (pending.analystRun) {
 			analystRuns.delete(pending.worker.id);
 			flushedAnalystRuns.add(pending.worker.id);
@@ -1370,6 +1638,8 @@ function createCoordinationToolsForManager(opts, lifetime) {
 		}
 		commitSettled(pending.worker);
 		pendingSettlement = void 0;
+		const advance = pending.analyze && !finishingAnalysis;
+		await runMapStep(() => settleMapMember(pending.settled, pending.worker, advance), pending.worker);
 		if (pending.analyze && !finishingAnalysis && analysisRoutes.length) {
 			const sourceNames = workerRouteNames(pending.worker.id);
 			const applicable = analysisRoutes.filter((route) => route.at !== "manager-end" && (route.statuses ?? ["done"]).includes(pending.worker.status) && (route.over === void 0 || route.over.some((name) => sourceNames.has(name))));
@@ -1404,6 +1674,7 @@ function createCoordinationToolsForManager(opts, lifetime) {
 			}
 			for (const route of agentRoutes) await spawnAnalystRun(route, pending.worker);
 		}
+		if (advance) await runMapStep(() => expandMaps(pending.settled, pending.worker), pending.worker);
 		return true;
 	};
 	const drainSettlement = async (source = "next") => {
@@ -1638,6 +1909,10 @@ function createCoordinationToolsForManager(opts, lifetime) {
 			type: "lead-message",
 			...ev.message
 		};
+		if (ev.type === "map") return {
+			type: "map",
+			...ev.map
+		};
 		return {
 			type: ev.type,
 			...ev.down
@@ -1945,7 +2220,8 @@ function createCoordinationToolsForManager(opts, lifetime) {
 			queued: bus.queued([
 				"settled",
 				"finding",
-				"lead-message"
+				"lead-message",
+				"map"
 			])
 		};
 	};
@@ -2214,7 +2490,8 @@ function createCoordinationToolsForManager(opts, lifetime) {
 			continuity: continuity.continuity,
 			...continuity.continuity === "resume" ? { resume: continuity.resume } : {},
 			...successorOf !== void 0 ? { successorOf } : {},
-			...peerMailUrl !== void 0 ? { peerMailUrl } : {}
+			...peerMailUrl !== void 0 ? { peerMailUrl } : {},
+			...input.map !== void 0 ? { map: input.map } : {}
 		});
 		const res = opts.scope.spawn(() => opts.makeWorkerAgent(profile, context), task, {
 			budget,
@@ -2290,7 +2567,7 @@ function createCoordinationToolsForManager(opts, lifetime) {
 					task: { description: "The task the worker should perform." },
 					label: {
 						type: "string",
-						description: "Optional trace label."
+						description: "Optional trace label; defaults to the profile name."
 					},
 					key: {
 						type: "string",
@@ -2389,7 +2666,7 @@ function createCoordinationToolsForManager(opts, lifetime) {
 					successorOf,
 					preflightProfile: () => opts.resolveSpawnProfile ? detachedFrozen(opts.resolveSpawnProfile(profile)) : profile,
 					resourcesFromPath: resourcePaths.resolved,
-					defaultLabel: "worker"
+					defaultLabel: typeof profile.name === "string" && profile.name.length > 0 ? profile.name : "worker"
 				});
 			}
 		},
@@ -3411,11 +3688,15 @@ function createCoordinationToolsForManager(opts, lifetime) {
 					type: "settled",
 					worker: node.id
 				}))],
-				unacknowledged: deliveries.filter((delivery) => !delivery.acknowledged).map((delivery) => ({
+				unacknowledged: deliveries.filter((delivery) => !delivery.acknowledged && delivery.attempt !== driverAttempt).map((delivery) => ({
 					seq: delivery.record.seq,
 					type: delivery.record.event.type,
 					...eventWorker(delivery.record.event) === void 0 ? {} : { worker: eventWorker(delivery.record.event) },
-					...delivery.attempt === void 0 ? {} : { attempt: delivery.attempt }
+					...delivery.attempt === void 0 ? {} : { attempt: delivery.attempt },
+					event: {
+						...projectEvent(delivery.record.event),
+						eventSeq: delivery.record.seq
+					}
 				})),
 				...lastRejection === void 0 ? {} : { lastRejection }
 			});
@@ -3482,6 +3763,36 @@ function nextUnkeyedAssignmentOrdinal(scope) {
 	if (!Number.isSafeInteger(next)) throw new Error("coordination: durable assignment ordinal space is exhausted");
 	return next;
 }
+/** Resolve an RFC 6901 JSON pointer (`''` is the whole document). */
+function resolveJsonPointer(document, pointer) {
+	if (pointer === "") return {
+		found: true,
+		value: document
+	};
+	if (!pointer.startsWith("/")) return {
+		found: false,
+		reason: "a JSON pointer is empty or starts with \"/\""
+	};
+	let value = document;
+	for (const raw of pointer.slice(1).split("/")) {
+		const token = raw.replaceAll("~1", "/").replaceAll("~0", "~");
+		if (Array.isArray(value)) {
+			if (!/^(0|[1-9]\d*)$/.test(token) || Number(token) >= value.length) return {
+				found: false,
+				reason: `no index ${JSON.stringify(token)} in an array of ${value.length}`
+			};
+			value = value[Number(token)];
+		} else if (typeof value === "object" && value !== null && Object.hasOwn(value, token)) value = value[token];
+		else return {
+			found: false,
+			reason: `no member ${JSON.stringify(token)}`
+		};
+	}
+	return {
+		found: true,
+		value
+	};
+}
 /** 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) {
@@ -4715,6 +5026,7 @@ function driverAgent(opts) {
 				...opts.deliverable ? { deliverable: opts.deliverable } : {},
 				...opts.analysts ? { analysts: opts.analysts } : {},
 				...opts.analyzeOnSettle ? { analyzeOnSettle: opts.analyzeOnSettle } : {},
+				...opts.mapOnSettle ? { mapOnSettle: opts.mapOnSettle } : {},
 				...opts.sourceEvidenceRefs ? { sourceEvidenceRefs: opts.sourceEvidenceRefs } : {},
 				...opts.peerAudit ? { peerAudit: opts.peerAudit } : {},
 				...opts.watchWorkers ? { watchWorkers: opts.watchWorkers } : {},
@@ -5118,4 +5430,4 @@ function safeJson(v) {
 //#endregion
 export { ANALYST_DEFINITION_BOUNDS as A, createEventBus as B, createFileRunContext as C, foldCoordinationRecords as D, FileCoordinationLog as E, createCoordinationToolsForManager as F, watchTrace as H, downMessageRefusalReasons as I, normalizeAnalyzeOnSettle as L, canonicalFindingEvent as M, coordinationVerbNames as N, applyRunCancellation as O, createCoordinationTools as P, parseAuthoredAnalystDefinition as R, renderAnytimeTable as S, withRunContext as T, defaultToolDetectors as V, sampleFromSettled as _, DEFAULT_DEADLINE_WARNING_MS as a, bestSoFar as b, refreshedWake as c, allWorkersStalled as d, anyOf as f, progressStop as g, plateau as h, finalizeBestDelivered as i, analystToolGroupNames as j, watchRunCancellation as k, resolveWakePolicy as l, noProgressFor as m, createSteerAcknowledger as n, composeWakeInput as o, createProgressTracker as p, driverAgent as r, deadlineWarningAt as s, createCancelAcknowledger as t, allOf as u, anytimeReport as v, createInMemoryRunContext as w, plateauLength as x, areaUnderCurve as y, questionEscalationTargets as z };
 
-//# sourceMappingURL=coordination-driver-CwisRZNE.js.map
+//# sourceMappingURL=coordination-driver-B7Z9jgFr.js.map