@tangle-network/agent-runtime 0.324.0 → 0.325.2

package/dist/{coordination-driver-CNEeqMoh.js → coordination-driver-Bx7nXmOs.js}

@@ -1,6 +1,6 @@
-import { Ca as resolveRedactor, Et as failedItems, J as scopeRetainedOwnerResourceReader, Pt as createExecutorRegistry, Qi as InMemorySpawnJournal, St as checkVerdictOf, T as meterRuntimeOwnedProviderAttempt, Tn as runBrainLoop, Xi as FileSpawnJournal, Xt as createInbox, Yi as FileResultBlobStore, Zi as InMemoryResultBlobStore, an as isLiveNodeStatus, c as runTree, ca as contentAddress, fa as errMessage, fi as providerAttemptEvidence, ha as assertValidBudget, i as bestDelivered, ki as settlementFailureCause, la as detachedFrozen, o as pickBestDelivered, oa as parseWorkerToolTraceArtifact, on as isTerminalNodeStatus, s as runFinalizer, sa as workerTraceAnalysisStore, tn as createPeerMailbox, tt as resolveSpawnResourcePaths, v as withDriverExecutor, vt as CheckUnavailableError, w as meterRuntimeOwnedAccounting, zt as createRouterTranscript } from "./supervisor-DnKhkhKc.js";
+import { $i as InMemoryResultBlobStore, Bt as createRouterTranscript, Ct as checkVerdictOf, Dt as failedItems, En as runBrainLoop, Ft as createExecutorRegistry, J as scopeRetainedOwnerResourceReader, Qi as FileSpawnJournal, T as meterRuntimeOwnedProviderAttempt, Ta as resolveRedactor, Zi as FileResultBlobStore, Zt as createInbox, _a as assertValidBudget, at as runtimeGraphMetadataKey, c as runTree, ca as parseWorkerToolTraceArtifact, da as detachedFrozen, ea as InMemorySpawnJournal, i as bestDelivered, ji as settlementFailureCause, la as workerTraceAnalysisStore, ma as errMessage, mi as providerAttemptEvidence, nn as createPeerMailbox, o as pickBestDelivered, on as isLiveNodeStatus, s as runFinalizer, sn as isTerminalNodeStatus, tt as resolveSpawnResourcePaths, ua as contentAddress, v as withDriverExecutor, w as meterRuntimeOwnedAccounting, yt as CheckUnavailableError } from "./supervisor-CESg1FQx.js";
 import { f as RuntimeRunStateError, m as ValidationError } from "./errors-DodWX-cb.js";
-import { $ as promptCacheTokenClasses, U as chargedTokens, dt as addResourceSpend, mt as withBudgetResources, st as unmeteredSpend } from "./workspace-streams-CcoARX4v.js";
+import { G as chargedTokens, gt as withBudgetResources, lt as unmeteredSpend, pt as addResourceSpend, tt as promptCacheTokenClasses } from "./sandbox-profile-compat-Dq7ujONv.js";
 import { a as readCommittedJsonLines, t as appendCommittedJsonLine } from "./jsonl-file-DBv31uPi.js";
 import { A as writeWorkerCancellation, M as writeWorkerSteerAcknowledgement, b as workerCancellationsDir, c as readWorkerCancelRequests, d as readWorkerSteerRequests, k as writeRunCancellation, l as readWorkerCancellation, o as readRunCancelRequest, r as claimWorkerSteerDelivery, s as readRunCancellation, u as readWorkerSteerAcknowledgement } from "./run-layout-Cu8H7aeh.js";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest } from "@tangle-network/agent-interface";
@@ -550,7 +550,8 @@ const coordinationVerbNames = [
 	"read_journal",
 	"list_analysts",
 	"run_analyst",
-	"define_analyst"
+	"define_analyst",
+	"run_graph"
 ];
 /**
 * The `CoordinationEvent` kinds that wake a waiting manager. The queue carries the UP-leg only:
@@ -569,6 +570,47 @@ const idArg = {
 	type: "string",
 	description: "The workerId returned by spawn_worker."
 };
+/** The optional per-spawn budget `spawn_worker` and `run_graph` take. */
+const spawnBudgetArg = {
+	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.",
+	properties: {
+		maxIterations: {
+			type: "number",
+			minimum: 0
+		},
+		maxTokens: {
+			type: "number",
+			minimum: 0
+		},
+		maxUsd: {
+			type: "number",
+			minimum: 0
+		},
+		deadlineMs: {
+			type: "number",
+			minimum: 0
+		},
+		resources: {
+			type: "object",
+			additionalProperties: {
+				type: "object",
+				properties: {
+					unit: {
+						type: "string",
+						minLength: 1
+					},
+					limit: {
+						type: "integer",
+						minimum: 0,
+						maximum: Number.MAX_SAFE_INTEGER
+					}
+				},
+				required: ["unit", "limit"]
+			}
+		}
+	}
+};
 /**
 * Strip zod's object-KEY CODEC artifact from a derived JSON Schema, at every depth.
 *
@@ -2136,6 +2178,107 @@ function createCoordinationToolsForManager(opts, lifetime) {
 			idleMs: Date.now() - startedAt
 		});
 	};
+	const admitSpawn = async (input) => {
+		const { profile, key, continuity, successorOf } = input;
+		const a = input.args;
+		const task = detachedFrozen(input.task);
+		const label = typeof a.label === "string" ? a.label : input.defaultLabel;
+		if (opts.preflightSpawn) {
+			const refusal = await opts.preflightSpawn(input.preflightProfile(), {
+				label,
+				...key !== void 0 ? { key } : {},
+				task
+			});
+			if (refusal) {
+				preflightCounts[refusal.cause] += 1;
+				return {
+					error: "preflight-refused",
+					reason: `the spawn pre-flight refused this profile (${refusal.cause}): ${refusal.detail}`,
+					cause: refusal.cause,
+					detail: refusal.detail,
+					live: liveWorkerCount(),
+					freeSlots: freeWorkerSlots()
+				};
+			}
+		}
+		const budget = Object.freeze(a.budget === void 0 ? opts.perWorker : mergeBudget(opts.perWorker, a.budget));
+		const assignmentId = key !== void 0 ? `key:${key}` : `ordinal:${unkeyedAssignmentOrdinal++}`;
+		const peerMailUrl = peerMail?.mintCapability(assignmentId);
+		const context = Object.freeze({
+			assignmentId,
+			parentNodeId: opts.scope.view.root,
+			budget,
+			task,
+			label,
+			...key !== void 0 ? { key } : {},
+			continuity: continuity.continuity,
+			...continuity.continuity === "resume" ? { resume: continuity.resume } : {},
+			...successorOf !== void 0 ? { successorOf } : {},
+			...peerMailUrl !== void 0 ? { peerMailUrl } : {}
+		});
+		const res = opts.scope.spawn(() => opts.makeWorkerAgent(profile, context), task, {
+			budget,
+			label,
+			assignmentId,
+			...key !== void 0 ? { key } : {},
+			...successorOf !== void 0 ? { successorOf } : {}
+		});
+		if (res.ok && res.prior?.state === "completed") {
+			const s = res.prior.settled;
+			const { id, status, resumed: _resumed, ...evidence } = projectSettled(s);
+			return Promise.resolve({
+				workerId: id,
+				resumed: "completed",
+				status,
+				...evidence,
+				...evidence.outRef === void 0 ? {} : { outputRead: {
+					tool: "observe_agent",
+					arguments: { workerId: id }
+				} },
+				live: liveWorkerCount(),
+				freeSlots: freeWorkerSlots()
+			});
+		}
+		if (res.ok) {
+			watchWorker(res.handle.id);
+			liveHandles.set(res.handle.id, res.handle);
+			peerMail?.bindCapability(assignmentId, res.handle.id);
+			if (typeof profile.name === "string" && profile.name.length > 0) profileNameByWorker.set(res.handle.id, profile.name);
+		}
+		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,
+			assignmentId: res.handle.assignmentId ?? assignmentId,
+			...res.handle.identity === void 0 ? {} : { identity: res.handle.identity },
+			...res.handle.materialization === void 0 ? {} : { materialization: res.handle.materialization },
+			...res.handle.executionBindings === void 0 ? {} : { executionBindings: res.handle.executionBindings },
+			continuity: continuity.continuity,
+			...continuity.continuity === "resume" ? { resume: continuity.resume } : {},
+			...successorOf !== void 0 ? { successorOf } : {},
+			status: res.handle.status,
+			live: liveWorkerCount(),
+			queued: queuedWorkerCount(),
+			freeSlots: freeWorkerSlots(),
+			...priorHistory,
+			...input.resourcesFromPath.length === 0 ? {} : { resourcesFromPath: input.resourcesFromPath },
+			...input.accepted
+		} : {
+			error: res.reason,
+			reason: spawnRefusalReason(res.reason, res.shortfalls, {
+				usdUnbudgeted: "this run's root budget declares no maxUsd, so a child budget naming maxUsd can never be admitted at any amount — spawn with a budget that omits maxUsd",
+				inDoubt: "this key has a prior worker recorded as started without a terminal receipt; no replacement was started because that remote worker may still be running — inspect or recover the exact prior execution before retrying",
+				scopeSettled: "this run has already reached its join barrier — its driver returned and the supervisor is settling, so no further worker can be started, joined, or paid for; record this stage as not started"
+			}),
+			...res.shortfalls === void 0 ? {} : { shortfalls: res.shortfalls },
+			...res.reason === "usd-unbudgeted" ? { hint: "This run's root budget declares no maxUsd, so a child budget naming maxUsd can never be admitted — at any amount. Retrying with a smaller maxUsd will fail identically. Spawn with a budget that omits maxUsd, or ask the caller to give the run a root maxUsd." } : res.reason === "in-doubt" ? { hint: "Do not retry this key. Use the recorded prior worker identity to inspect or recover that exact execution. A terminal receipt or explicit recovery is required before replacement work can start." } : {},
+			live: liveWorkerCount(),
+			freeSlots: freeWorkerSlots()
+		});
+	};
 	const tools = [
 		{
 			name: "spawn_worker",
@@ -2162,46 +2305,7 @@ function createCoordinationToolsForManager(opts, lifetime) {
 						type: "string",
 						description: "The workerId of a SETTLED worker you spawned that this new worker replaces — for example one that failed, stalled, or finished with a weak result, restarted with a changed profile or task. The run record then names the predecessor on the new worker. Refused for an id you did not spawn (`error: \"successor-unknown\"`) and for a worker still live (`error: \"successor-live\"` — end your turn until it settles). Put what the successor needs from its predecessor in `task`."
 					},
-					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.",
-						properties: {
-							maxIterations: {
-								type: "number",
-								minimum: 0
-							},
-							maxTokens: {
-								type: "number",
-								minimum: 0
-							},
-							maxUsd: {
-								type: "number",
-								minimum: 0
-							},
-							deadlineMs: {
-								type: "number",
-								minimum: 0
-							},
-							resources: {
-								type: "object",
-								additionalProperties: {
-									type: "object",
-									properties: {
-										unit: {
-											type: "string",
-											minLength: 1
-										},
-										limit: {
-											type: "integer",
-											minimum: 0,
-											maximum: Number.MAX_SAFE_INTEGER
-										}
-									},
-									required: ["unit", "limit"]
-								}
-							}
-						}
-					}
+					budget: spawnBudgetArg
 				},
 				required: ["profile", "task"]
 			},
@@ -2240,6 +2344,17 @@ function createCoordinationToolsForManager(opts, lifetime) {
 						message: issue.message
 					}))
 				});
+				if (parsedProfile.data.metadata?.["agentRuntimeGraph"] !== void 0) {
+					const reason = `metadata.${runtimeGraphMetadataKey} is written by Runtime for the root of a run_graph subtask; call run_graph to run a graph`;
+					return {
+						error: "invalid-profile",
+						reason,
+						issues: [{
+							path: `metadata.${runtimeGraphMetadataKey}`,
+							message: reason
+						}]
+					};
+				}
 				const profile = detachedFrozen(opts.composeSpawnProfile ? agentProfileSchema.parse(opts.composeSpawnProfile(parsedProfile.data)) : parsedProfile.data);
 				const continuity = resolveContinuity(parseContinuity(a.continuity), profile.name, key);
 				if ("error" in continuity) return Promise.resolve({
@@ -2265,102 +2380,16 @@ function createCoordinationToolsForManager(opts, lifetime) {
 						freeSlots: freeWorkerSlots()
 					};
 				}
-				const task = detachedFrozen(a.task);
-				const label = typeof a.label === "string" ? a.label : "worker";
-				if (opts.preflightSpawn) {
-					const preflightProfile = opts.resolveSpawnProfile ? detachedFrozen(opts.resolveSpawnProfile(profile)) : profile;
-					const refusal = await opts.preflightSpawn(preflightProfile, {
-						label,
-						...key !== void 0 ? { key } : {},
-						task
-					});
-					if (refusal) {
-						preflightCounts[refusal.cause] += 1;
-						return {
-							error: "preflight-refused",
-							reason: `the spawn pre-flight refused this profile (${refusal.cause}): ${refusal.detail}`,
-							cause: refusal.cause,
-							detail: refusal.detail,
-							live: liveWorkerCount(),
-							freeSlots: freeWorkerSlots()
-						};
-					}
-				}
-				const budget = Object.freeze(a.budget === void 0 ? opts.perWorker : mergeBudget(opts.perWorker, a.budget));
-				const assignmentId = key !== void 0 ? `key:${key}` : `ordinal:${unkeyedAssignmentOrdinal++}`;
-				const peerMailUrl = peerMail?.mintCapability(assignmentId);
-				const context = Object.freeze({
-					assignmentId,
-					parentNodeId: opts.scope.view.root,
-					budget,
-					task,
-					label,
-					...key !== void 0 ? { key } : {},
-					continuity: continuity.continuity,
-					...continuity.continuity === "resume" ? { resume: continuity.resume } : {},
-					...successorOf !== void 0 ? { successorOf } : {},
-					...peerMailUrl !== void 0 ? { peerMailUrl } : {}
-				});
-				const res = opts.scope.spawn(() => opts.makeWorkerAgent(profile, context), task, {
-					budget,
-					label,
-					assignmentId,
-					...key !== void 0 ? { key } : {},
-					...successorOf !== void 0 ? { successorOf } : {}
-				});
-				if (res.ok && res.prior?.state === "completed") {
-					const s = res.prior.settled;
-					const { id, status, resumed: _resumed, ...evidence } = projectSettled(s);
-					return Promise.resolve({
-						workerId: id,
-						resumed: "completed",
-						status,
-						...evidence,
-						...evidence.outRef === void 0 ? {} : { outputRead: {
-							tool: "observe_agent",
-							arguments: { workerId: id }
-						} },
-						live: liveWorkerCount(),
-						freeSlots: freeWorkerSlots()
-					});
-				}
-				if (res.ok) {
-					watchWorker(res.handle.id);
-					liveHandles.set(res.handle.id, res.handle);
-					peerMail?.bindCapability(assignmentId, res.handle.id);
-					if (typeof profile.name === "string" && profile.name.length > 0) profileNameByWorker.set(res.handle.id, profile.name);
-				}
-				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,
-					assignmentId: res.handle.assignmentId ?? assignmentId,
-					...res.handle.identity === void 0 ? {} : { identity: res.handle.identity },
-					...res.handle.materialization === void 0 ? {} : { materialization: res.handle.materialization },
-					...res.handle.executionBindings === void 0 ? {} : { executionBindings: res.handle.executionBindings },
-					continuity: continuity.continuity,
-					...continuity.continuity === "resume" ? { resume: continuity.resume } : {},
-					...successorOf !== void 0 ? { successorOf } : {},
-					status: res.handle.status,
-					live: liveWorkerCount(),
-					queued: queuedWorkerCount(),
-					freeSlots: freeWorkerSlots(),
-					...priorHistory,
-					...resourcePaths.resolved.length === 0 ? {} : { resourcesFromPath: resourcePaths.resolved }
-				} : {
-					error: res.reason,
-					reason: spawnRefusalReason(res.reason, res.shortfalls, {
-						usdUnbudgeted: "this run's root budget declares no maxUsd, so a child budget naming maxUsd can never be admitted at any amount — spawn with a budget that omits maxUsd",
-						inDoubt: "this key has a prior worker recorded as started without a terminal receipt; no replacement was started because that remote worker may still be running — inspect or recover the exact prior execution before retrying",
-						scopeSettled: "this run has already reached its join barrier — its driver returned and the supervisor is settling, so no further worker can be started, joined, or paid for; record this stage as not started"
-					}),
-					...res.shortfalls === void 0 ? {} : { shortfalls: res.shortfalls },
-					...res.reason === "usd-unbudgeted" ? { hint: "This run's root budget declares no maxUsd, so a child budget naming maxUsd can never be admitted — at any amount. Retrying with a smaller maxUsd will fail identically. Spawn with a budget that omits maxUsd, or ask the caller to give the run a root maxUsd." } : res.reason === "in-doubt" ? { hint: "Do not retry this key. Use the recorded prior worker identity to inspect or recover that exact execution. A terminal receipt or explicit recovery is required before replacement work can start." } : {},
-					live: liveWorkerCount(),
-					freeSlots: freeWorkerSlots()
+				return admitSpawn({
+					profile,
+					args: a,
+					task: a.task,
+					key,
+					continuity,
+					successorOf,
+					preflightProfile: () => opts.resolveSpawnProfile ? detachedFrozen(opts.resolveSpawnProfile(profile)) : profile,
+					resourcesFromPath: resourcePaths.resolved,
+					defaultLabel: "worker"
 				});
 			}
 		},
@@ -3031,6 +3060,79 @@ function createCoordinationToolsForManager(opts, lifetime) {
 			handler: async (raw) => readJournal(raw, false)
 		} : tool));
 	}
+	if (opts.graphs) {
+		const graphs = opts.graphs;
+		tools.push({
+			name: "run_graph",
+			description: "Run an agent graph as ONE subtask instead of one worker: a fixed topology whose nodes are profiles and whose edges carry directives, driven by its root node. Pass `graph` ({ nodes: [{ id, profile }], edges: [{ kind: 'delegates', from, to, directive: 'delegates/worker-brief/v1' }] }, where each profile.name equals its node id and the root node grants agent_runtime_coordination_spawn_worker) or `graphDigest` (a graph stored in this run's graph registry). `deliverable` is what the graph must deliver; it becomes the root node's task. The subtask reserves `budget` (merged over the per-worker default, as for spawn_worker) from your conserved pool, and the whole graph spends only that. Every node runs its own pinned profile; the run keeps its checks and graders, which are never graph nodes. Returns a workerId as spawn_worker does; end your turn and you are woken when the graph settles. Its output is { deliverable, edges }: the root node's result and the edge ledger (every traversal, also recorded in the run journal).",
+			inputSchema: {
+				type: "object",
+				properties: {
+					graph: {
+						type: "object",
+						description: "The graph as data: { nodes: [{ id, profile }], edges: [...] }. Delegates edges run from the root to each worker node; an optional analyzes edge ({ kind: 'analyzes', analyst, over, to, directive }) names an analyst node.",
+						additionalProperties: true
+					},
+					graphDigest: {
+						type: "string",
+						description: "A stored graph's digest in this run's graph registry, instead of graph."
+					},
+					deliverable: {
+						type: "string",
+						description: "What the graph must deliver. It becomes the root node's task."
+					},
+					budget: spawnBudgetArg,
+					label: {
+						type: "string",
+						description: "Optional trace label."
+					},
+					key: {
+						type: "string",
+						description: "Optional semantic name for this subtask. The same key never runs twice, as for spawn_worker: a completed key returns its committed result."
+					}
+				},
+				required: ["deliverable"]
+			},
+			handler: async (raw) => {
+				const a = obj(raw);
+				const deliverable = typeof a.deliverable === "string" ? a.deliverable.trim() : "";
+				if (deliverable.length === 0) return {
+					error: "invalid-graph",
+					reason: "deliverable must be a non-empty string: what the graph must deliver"
+				};
+				if (a.graph === void 0 === (a.graphDigest === void 0)) return {
+					error: "invalid-graph",
+					reason: "pass exactly one of graph (the graph as data) or graphDigest (a stored graph)"
+				};
+				if (a.graphDigest !== void 0 && typeof a.graphDigest !== "string") return {
+					error: "invalid-graph",
+					reason: "graphDigest must be a string"
+				};
+				const key = a.key === void 0 ? void 0 : str(a.key, "key");
+				const prepared = await graphs.prepare(typeof a.graphDigest === "string" ? { graphDigest: a.graphDigest } : { graph: a.graph });
+				if (!prepared.ok) return {
+					error: "invalid-graph",
+					reason: prepared.reason
+				};
+				const profile = detachedFrozen(prepared.profile);
+				return admitSpawn({
+					profile,
+					args: a,
+					task: deliverable,
+					key,
+					continuity: { continuity: "fresh" },
+					successorOf: void 0,
+					preflightProfile: () => opts.resolveSpawnProfile ? detachedFrozen(opts.resolveSpawnProfile(profile)) : profile,
+					resourcesFromPath: [],
+					defaultLabel: `graph:${prepared.root}`,
+					accepted: { graph: {
+						root: prepared.root,
+						nodes: prepared.nodes
+					} }
+				});
+			}
+		});
+	}
 	if (opts.analysts) {
 		tools.push({
 			name: "list_analysts",
@@ -4600,6 +4702,7 @@ function driverAgent(opts) {
 				scope,
 				blobs: opts.blobs,
 				makeWorkerAgent: opts.makeWorkerAgent,
+				...opts.graphs ? { graphs: opts.graphs } : {},
 				...opts.authorizeDownMessage ? { authorizeDownMessage: opts.authorizeDownMessage } : {},
 				perWorker: opts.perWorker,
 				...opts.deliverable ? { deliverable: opts.deliverable } : {},
@@ -5008,4 +5111,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-CNEeqMoh.js.map
+//# sourceMappingURL=coordination-driver-Bx7nXmOs.js.map