@tangle-network/agent-runtime 0.123.1 → 0.126.0

package/dist/{supervise-Cx24b3lw.js → supervise-Ds8FtyI9.js}

@@ -1,5 +1,5 @@
 import { c as RuntimeRunStateError, i as ConfigError, o as NotFoundError, t as AgentEvalError$1, u as ValidationError } from "./errors-DEAvWQPy.js";
-import { S as detachedSnapshot, b as workerTraceAnalysisStore, d as writeAllBytes, i as InMemorySpawnJournal, l as parseCommittedJsonLines, n as FileSpawnJournal, r as InMemoryResultBlobStore, t as FileResultBlobStore, u as prepareJsonlAppend, x as contentAddress } from "./spawn-journal-DsZKDqeh.js";
+import { S as detachedSnapshot, b as workerTraceAnalysisStore, d as writeAllBytes, i as InMemorySpawnJournal, l as parseCommittedJsonLines, n as FileSpawnJournal, r as InMemoryResultBlobStore, t as FileResultBlobStore, u as prepareJsonlAppend, x as contentAddress, y as parseWorkerToolTraceArtifact } from "./spawn-journal-DsZKDqeh.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 { $t as concreteProfileModel, At as controlProfileMaterialization, Ct as runWorktreeHarness, Dt as removeWorktree, Et as createWorktree, F as toOtelAttributes, Ft as promptModelProfileMaterialization, J as createActivityLog, Mt as fullProfileMaterialization, Nt as profileMaterializationAxes, O as createOtelExporter, Pt as promptControlProfileMaterialization, Q as freeSlots, Qt as concreteModelId, St as runWorktreeChecks, T as buildLoopSpanNodes, Tt as captureWorktreeDiff, Vt as worktreeCliProfileMaterialization, Xt as assertModelAllowed, Y as describeToolArgs, Zt as assertProfileModelsAllowed, _ as workerTraceEnv, _t as routerChatWithUsage, a as pickBestDelivered, at as assertValidBudget, b as mergeTraceEnv, bt as runBrainLoop, c as driverChild, ct as attestRuntimeOwnedExecutor, d as deriveNodeExecutionIdentity, dt as newExecutionAttemptId, en as isHarnessNativeModel, f as recordScopeOwnerMaterialization, ft as runtimeOwnedExecutorExecutionBinding, h as WORKER_TRACE_PROPAGATION, ht as routerBrain, it as workerTokenFloor, j as generateSpanId, jt as defineProfileMaterializationContract, kt as assertProfileMaterialization, l as withDriverExecutor, lt as attestRuntimeOwnedScopeOwner, mt as runtimeOwnedScopeOwnerRuntime, n as createSupervisor, nt as teardownExecutor, o as runFinalizer, p as scopeOwnerExecutorNodeContext, pt as runtimeOwnedExecutorMaterialization, r as bestDelivered, rt as WORKER_TOKEN_FLOOR, s as runTree, st as spendFromUsageEvents, tn as profileForExecution, tt as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, ut as inheritRuntimeOwnedExecutorAttestation, wt as worktreeProfileExecutionPlan } from "./supervisor-DpjO0Gmy.js";
 import { i as notifyRuntimeHookEvent, t as composeRuntimeHooks } from "./runtime-hooks-C7iJOWm3.js";
@@ -5472,6 +5472,81 @@ function createCoordinationTools(opts) {
 		unwatchWorker(w.id);
 	};
 	let pendingSettlement;
+	const analystRuns = /* @__PURE__ */ new Map();
+	let analystRunOrdinal = 0;
+	/** The `finding` event an analyst-agent settlement becomes: its settle OUTPUT is the findings
+	*  (a failed run publishes the failure as findings — degraded beats vanished). */
+	const analystRunFinding = (run, settled) => deepFreezeDetached({
+		type: "finding",
+		finding: canonicalFindingEvent({
+			fromWorker: run.sourceWorker,
+			analyst: run.route.kind,
+			findings: settled.kind === "done" ? settled.out : { analystRunFailed: settled.reason }
+		})
+	});
+	/**
+	* Spawn one analyst-AGENT run over a settled worker's evidence, through the SAME spawn
+	* machinery a driver spawn uses (`scope.spawn` + `makeWorkerAgent`): the analyst's spend
+	* reserves from the conserved pool, its node is journaled/traced like any worker, and a
+	* node-pinning seam sees `context.analyst`. Its task is the route directive plus the settled
+	* worker's persisted tool-trace spans. A refused spawn publishes a finding RECORDING the
+	* refusal — observable, never silent — and must never take down the settlement path.
+	*/
+	const spawnAnalystRun = async (route, worker) => {
+		let spansText = "";
+		let spanCount = 0;
+		if (worker.trace.status === "available") try {
+			const artifact = parseWorkerToolTraceArtifact(await opts.blobs.get(worker.trace.traceRef), worker.trace.traceRef);
+			spanCount = artifact.spans.length;
+			spansText = safeJsonText(artifact.spans);
+		} catch {
+			spansText = "";
+		}
+		const task = [
+			...route.directive === void 0 || route.directive.length === 0 ? [] : [route.directive],
+			`Evidence — settled worker '${worker.id}' tool trace (${spanCount} spans):`,
+			spansText.length === 0 ? "(no tool spans available)" : spansText
+		].join("\n\n");
+		const assignmentId = `analyst:${route.kind}:o${analystRunOrdinal++}`;
+		const label = `analyst:${route.kind}`;
+		const context = Object.freeze({
+			assignmentId,
+			parentNodeId: opts.scope.view.root,
+			budget: opts.perWorker,
+			task,
+			label,
+			analyst: route.kind
+		});
+		let refusal;
+		let spawnedId;
+		try {
+			const res = opts.scope.spawn(() => opts.makeWorkerAgent(route.agent, context), task, {
+				budget: opts.perWorker,
+				label,
+				assignmentId
+			});
+			if (res.ok) spawnedId = res.handle.id;
+			else refusal = String(res.reason);
+		} catch (cause) {
+			refusal = cause instanceof Error ? cause.message : String(cause);
+		}
+		if (spawnedId === void 0) {
+			await bus.publish({
+				type: "finding",
+				finding: canonicalFindingEvent({
+					fromWorker: worker.id,
+					analyst: route.kind,
+					findings: { analystSpawnRefused: refusal ?? "unknown" }
+				})
+			});
+			return;
+		}
+		analystRuns.set(spawnedId, {
+			route,
+			sourceWorker: worker.id
+		});
+		watchWorker(spawnedId);
+	};
 	const workerRouteNames = (workerId) => {
 		const names = /* @__PURE__ */ new Set();
 		const profileName = profileNameByWorker.get(workerId);
@@ -5543,15 +5618,28 @@ function createCoordinationTools(opts) {
 		const pending = pendingSettlement;
 		if (!pending) return false;
 		await bus.publish(pending.event);
+		if (pending.analystRun) {
+			analystRuns.delete(pending.worker.id);
+			unwatchWorker(pending.worker.id);
+			pendingSettlement = void 0;
+			const { route } = pending.analystRun;
+			if (route.to !== void 0 && pending.event.type === "finding") await deliverRoutedFinding({
+				kind: route.kind,
+				to: route.to
+			}, pending.event.finding.findings);
+			return true;
+		}
 		commitSettled(pending.settled, pending.worker);
 		pendingSettlement = void 0;
-		if (pending.analyze && pending.worker.status === "done" && pending.worker.trace.status === "available" && opts.analysts && opts.analyzeOnSettle?.length) {
+		if (pending.analyze && pending.worker.status === "done" && pending.worker.trace.status === "available" && opts.analyzeOnSettle?.length) {
 			const routes = opts.analyzeOnSettle.map(normalizeAnalyzeOnSettle);
 			const sourceNames = workerRouteNames(pending.worker.id);
 			const applicable = routes.filter((route) => route.over === void 0 || route.over.some((name) => sourceNames.has(name)));
-			if (applicable.length > 0) {
+			const lensRoutes = applicable.filter((route) => route.agent === void 0);
+			const agentRoutes = applicable.filter((route) => route.agent !== void 0);
+			if (lensRoutes.length > 0 && opts.analysts) {
 				const trace = await workerTraceAnalysisStore(pending.worker.trace, opts.blobs);
-				for (const route of applicable) {
+				for (const route of lensRoutes) {
 					const findings = await opts.analysts.run(route.kind, trace);
 					await bus.publish({
 						type: "finding",
@@ -5564,6 +5652,7 @@ function createCoordinationTools(opts) {
 					if (route.to !== void 0) await deliverRoutedFinding(route, findings);
 				}
 			}
+			for (const route of agentRoutes) await spawnAnalystRun(route, pending.worker);
 		}
 		return true;
 	};
@@ -5572,7 +5661,14 @@ function createCoordinationTools(opts) {
 			const settled = await opts.scope.next();
 			if (!settled) return false;
 			const worker = projectSettled(settled);
-			pendingSettlement = {
+			const run = analystRuns.get(settled.handle.id);
+			pendingSettlement = run ? {
+				settled,
+				worker,
+				event: analystRunFinding(run, settled),
+				analyze: false,
+				analystRun: run
+			} : {
 				settled,
 				worker,
 				event: deepFreezeDetached({
@@ -5591,7 +5687,14 @@ function createCoordinationTools(opts) {
 				const settled = await opts.scope.nextResolved();
 				if (!settled) return drained;
 				const worker = projectSettled(settled);
-				pendingSettlement = {
+				const run = analystRuns.get(settled.handle.id);
+				pendingSettlement = run ? {
+					settled,
+					worker,
+					event: analystRunFinding(run, settled),
+					analyze: false,
+					analystRun: run
+				} : {
 					settled,
 					worker,
 					event: deepFreezeDetached({
@@ -6894,7 +6997,7 @@ function progressStop(tracker, rule, coord, scope, now, stallAfterMs) {
 function driverAgent(opts) {
 	if (typeof opts.brain !== "function") throw new ValidationError("driverAgent: opts.brain must be a function");
 	if ((opts.extraTools?.length ?? 0) > 0 && typeof opts.executeExtraTool !== "function") throw new ValidationError("driverAgent: extraTools requires executeExtraTool (how to run a work-tool call)");
-	if ((opts.analyzeOnSettle?.length ?? 0) > 0 && !opts.analysts) throw new ValidationError("driverAgent: analyzeOnSettle requires analysts (the lens registry the kinds resolve against)");
+	if ((opts.analyzeOnSettle ?? []).map(normalizeAnalyzeOnSettle).some((route) => route.agent === void 0) && !opts.analysts) throw new ValidationError("driverAgent: analyzeOnSettle requires analysts (the lens registry the kinds resolve against)");
 	const reserved = new Set(coordinationVerbNames);
 	for (const tool of opts.nodeTools ?? []) {
 		if (reserved.has(tool.name)) throw new ValidationError(`driverAgent: node tool "${tool.name}" collides with a coordination verb or another node tool`);
@@ -10110,4 +10213,4 @@ function supervise(profile, task, opts) {
 //#endregion
 export { allOf as $, naiveContinuationPrompt as $t, DELEGATE_DESCRIPTION as A, createSandboxForSpec as At, DELEGATION_TRACE_MAX_SPANS as B, assessAuthoredProfile as Bt, createDelegateUiAuditHandler as C, createWorktreeCliExecutor as Ct, DELEGATE_FEEDBACK_TOOL_NAME as D, decodeToolPart as Dt, DELEGATE_FEEDBACK_INPUT_SCHEMA as E, createPushTraceSource as Et, defaultDelegateBudget as F, probeSandboxCapabilities as Ft, DelegationPersistenceError as G, supervisorInstructions as Gt, capDelegationTrace as H, canonicalizeAuthoredProfile as Ht, delegate as I, acquireSandbox as It, InMemoryDelegationStore as J, delegatesWorkerBriefPrompt as Jt, DelegationStateCorruptError as K, analyzesFindingsReportPrompt as Kt, DelegationTaskQueue as L, FileCoordinationLog as Lt, DELEGATE_TOOL_NAME as M, runAgentRounds as Mt, createDelegateHandler as N, runLoop as Nt, createDelegateFeedbackHandler as O, sandboxSessionTraceSource as Ot, validateDelegateArgs as P, createSandboxLineage as Pt, finalizeBestDelivered as Q, kernelPromptRegistry as Qt, hashIdempotencyInput as R, createSupervisorSpanRecorder as Rt, DELEGATE_UI_AUDIT_TOOL_NAME as S, createExecutorRegistry as St, DELEGATE_FEEDBACK_DESCRIPTION as T, createSteerableSandboxSession as Tt, composeLoopTraceEmitters as U, defaultProfileRichnessThresholds as Ut, buildDelegationTraceSpans as V, authoredWorker as Vt, createDelegationTraceCollector as W, profileRichnessFinding as Wt, eventToSnapshot as X, dumbContinuationPassPrompt as Xt, InMemoryFeedbackStore as Y, dumbContinuationFailPrompt as Yt, driverAgent as Z, formatPromptHandle as Zt, DELEGATION_HISTORY_TOOL_NAME as _, watchTrace as _t, resolveSupervisorProfile as a, sampleFromSettled as at, DELEGATE_UI_AUDIT_DESCRIPTION as b, cliWorktreeExecutor as bt, createInProcessTransport as c, bestSoFar as ct, DELEGATION_STATUS_INPUT_SCHEMA as d, DEFAULT_AWAIT_EVENT_TIMEOUT_MS as dt, promptHandle as en, allWorkersStalled as et, DELEGATION_STATUS_TOOL_NAME as f, canonicalFindingEvent as ft, DELEGATION_HISTORY_INPUT_SCHEMA as g, defaultToolDetectors as gt, DELEGATION_HISTORY_DESCRIPTION as h, createEventBus as ht, assertCoordinationBinding as i, plateau as it, DELEGATE_INPUT_SCHEMA as j, defaultSelectWinner as jt, validateDelegateFeedbackArgs as k, createInbox as kt, createMcpServer as l, plateauLength as lt, validateDelegationStatusArgs as m, normalizeAnalyzeOnSettle as mt, supervise as n, gateOnDeliverable as nn, createProgressTracker as nt, supervisorAgent as o, anytimeReport as ot, createDelegationStatusHandler as p, createCoordinationTools as pt, FileDelegationStore as q, createPromptRegistry as qt, workerFromBackend as r, noProgressFor as rt, serveCoordinationMcp as s, areaUnderCurve as st, DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY as t, supervisorPolicyPrompt as tn, anyOf as tt, DELEGATION_STATUS_DESCRIPTION as u, renderAnytimeTable as ut, createDelegationHistoryHandler as v, createFileRunContext as vt, validateDelegateUiAuditArgs as w, DEFAULT_SANDBOX_STEERING_MAX_TURNS as wt, DELEGATE_UI_AUDIT_INPUT_SCHEMA as x, createExecutor as xt, validateDelegationHistoryArgs as y, createInMemoryRunContext as yt, DELEGATION_TRACE_MAX_BYTES as z, asAuthoredProfile as zt };
 
-//# sourceMappingURL=supervise-Cx24b3lw.js.map
+//# sourceMappingURL=supervise-Ds8FtyI9.js.map