@tangle-network/agent-runtime 0.115.0 → 0.116.0

package/dist/{supervise-BcCHhLrz.js → supervise-BUR9ByF7.js}

@@ -1,10 +1,9 @@
 import { c as RuntimeRunStateError, i as ConfigError, o as NotFoundError, t as AgentEvalError$1, u as ValidationError } from "./errors-DEAvWQPy.js";
 import { a as mapWithConcurrency, c as sleep, d as throwIfAborted, f as withTimeout, l as stringifySafe, n as addTokenUsage, o as randomSuffix, p as zeroTokenUsage, r as deleteBoxSafe, s as randomUuid, t as abortError, u as throwAbort } from "./util-Cc9g9Y-o.js";
 import { a as contentAddress, i as InMemorySpawnJournal, n as FileSpawnJournal, r as InMemoryResultBlobStore, t as FileResultBlobStore } from "./spawn-journal-DCPbicXB.js";
-import { A as captureWorktreeDiff, C as routerChatWithUsage, E as runBrainLoop, M as removeWorktree, O as runWorktreeChecks, a as runFinalizer, i as pickBestDelivered, j as createWorktree, k as runWorktreeHarness, l as withDriverExecutor, n as bestDelivered, o as runTree, t as createSupervisor, x as routerBrain, y as createActivityLog } from "./supervisor-CspDspod.js";
+import { $ as removeWorktree, B as createActivityLog, D as toOtelAttributes, H as routerBrain, Q as createWorktree, S as createOtelExporter, T as generateSpanId, W as routerChatWithUsage, X as runWorktreeHarness, Y as runWorktreeChecks, Z as captureWorktreeDiff, a as runFinalizer, b as buildLoopSpanNodes, i as pickBestDelivered, l as withDriverExecutor, m as workerTraceSeamKey, n as bestDelivered, o as runTree, p as workerTraceEnv, q as runBrainLoop, t as createSupervisor } from "./supervisor-BBbPBXpe.js";
 import { i as notifyRuntimeHookEvent, t as composeRuntimeHooks } from "./runtime-hooks-C7iJOWm3.js";
 import { a as notifySandboxEventObserver, n as extractLlmCallEvent } from "./sandbox-events-DeI5xX8P.js";
-import { a as createOtelExporter, c as generateSpanId, r as buildLoopSpanNodes, u as toOtelAttributes } from "./otel-export-CPZTSADj.js";
 import { i as resolveAgentEnvironmentProvider, n as providerAsExecutor, s as buildBackendOptions } from "./environment-provider-CCaEhA-l.js";
 import { t as createStdioToolServer } from "./tool-server-RcWgLIsL.js";
 import { n as UI_LENSES } from "./substrate-B0TYNrXn.js";
@@ -282,6 +281,12 @@ function createSupervisorSpanRecorder(opts) {
 		} },
 		traceId,
 		rootSpanId,
+		workerTrace(spawningNodeId) {
+			return {
+				traceId,
+				parentSpanId: spanIdOf.get(spawningNodeId) ?? rootSpanId
+			};
+		},
 		async finish(outcome) {
 			if (finished) return;
 			finished = true;
@@ -2238,6 +2243,7 @@ const piSeamKey = "pi";
 /** Build the `Executor` for one pi worker. Registered as runtime `'pi'`. */
 const piExecutor = (spec, ctx) => {
 	const seam = readPiSeam(ctx);
+	const traceEnv = workerTraceEnv(ctx);
 	const inbox = createInbox();
 	const activity = createActivityLog(seam.activityWindow ?? 12);
 	const runId = `pi-${spec.profile.name ?? "worker"}-${Date.now()}`;
@@ -2271,6 +2277,7 @@ const piExecutor = (spec, ctx) => {
 				signal,
 				controller,
 				seam,
+				traceEnv,
 				spec,
 				runId,
 				inbox,
@@ -2329,7 +2336,7 @@ async function* streamPiSession(args) {
 	}
 	let proc;
 	try {
-		proc = spawnPi(seam, piMcp.args);
+		proc = spawnPi(seam, piMcp.args, args.traceEnv);
 	} catch (spawnFailure) {
 		piMcp.mount?.cleanup();
 		throw spawnFailure;
@@ -2649,8 +2656,14 @@ function taskText(task) {
 * the profile-derived extension flags (`--no-extensions` / `--extension`). Seam args go LAST so an
 * operator's explicit flag wins over a derived one under pi's last-flag-wins parsing; RPC mode has
 * no positional prompt, so nothing here has to precede an argument.
+*
+* `traceEnv` is the inherited `TRACE_ID` / `PARENT_SPAN_ID` pair (empty when the run records no
+* spans). It sits ABOVE the supervisor's ambient `process.env` — a supervisor that was itself
+* launched as someone's worker holds ids describing ITS place in an outer trace, which are the
+* wrong parent for this child — and BELOW `seam.env`, so an operator who sets either id explicitly
+* still wins. See `worker-trace.ts` for the full precedence rule.
 */
-function spawnPi(seam, profileArgs = []) {
+function spawnPi(seam, profileArgs = [], traceEnv = {}) {
 	const bin = seam.bin ?? "pi";
 	const argv = ["--mode", "rpc"];
 	if (seam.model) {
@@ -2664,6 +2677,7 @@ function spawnPi(seam, profileArgs = []) {
 		...seam.cwd ? { cwd: seam.cwd } : {},
 		env: {
 			...process.env,
+			...traceEnv,
 			...seam.env ?? {}
 		},
 		stdio: [
@@ -2810,7 +2824,10 @@ function createSteerableSandboxSession(args) {
 			profile: args.profile,
 			taskToPrompt: args.taskToPrompt,
 			name: args.profile.name ?? String(args.harness),
-			sandboxOverrides: { backend: { type: args.harness } }
+			sandboxOverrides: {
+				backend: { type: args.harness },
+				...args.traceEnv && Object.keys(args.traceEnv).length > 0 ? { env: args.traceEnv } : {}
+			}
 		};
 		const promptOptions = readPromptOptions(args.loopCtx);
 		const started = now();
@@ -3420,6 +3437,7 @@ const sandboxExecutor = (spec, ctx) => {
 	if (!seam.sandboxClient || typeof seam.sandboxClient.create !== "function") throw new ValidationError("sandboxExecutor: SandboxSeam.sandboxClient.create required");
 	const maxIterations = seam.maxIterations ?? 1;
 	if (!Number.isFinite(maxIterations) || maxIterations <= 0) throw new ValidationError("sandboxExecutor: maxIterations must be > 0");
+	const traceEnv = workerTraceEnv(ctx);
 	const controller = new AbortController();
 	const abortIfSignalled = () => {
 		if (ctx.signal.aborted) controller.abort();
@@ -3438,6 +3456,7 @@ const sandboxExecutor = (spec, ctx) => {
 			taskToPrompt: (t) => taskToPrompt(t),
 			options: seam.steering,
 			...seam.loopCtx ? { loopCtx: seam.loopCtx } : {},
+			...Object.keys(traceEnv).length > 0 ? { traceEnv } : {},
 			contentRef
 		});
 		return {
@@ -3478,6 +3497,7 @@ const sandboxExecutor = (spec, ctx) => {
 				maxIterations,
 				controller,
 				loopCtx: seam.loopCtx,
+				traceEnv,
 				onArtifact: (a) => {
 					artifact = a;
 				}
@@ -3505,7 +3525,10 @@ async function* streamSandboxLeaf(args) {
 		profile: args.spec.profile,
 		taskToPrompt: (t) => taskToPrompt(t),
 		name: args.spec.profile.name ?? args.harness,
-		sandboxOverrides: { backend: { type: args.harness } }
+		sandboxOverrides: {
+			backend: { type: args.harness },
+			...Object.keys(args.traceEnv).length > 0 ? { env: args.traceEnv } : {}
+		}
 	};
 	const started = Date.now();
 	const loopOptions = {
@@ -3569,6 +3592,7 @@ async function* streamSandboxLeaf(args) {
 const cliExecutor = (_spec, ctx) => {
 	const seam = readSeam(ctx, cliSeamKey, "cli");
 	if (!seam.bin) throw new ValidationError("cliExecutor: CliSeam.bin required");
+	const traceEnv = workerTraceEnv(ctx);
 	const controller = new AbortController();
 	const abortIfSignalled = () => {
 		if (ctx.signal.aborted) controller.abort();
@@ -3584,6 +3608,7 @@ const cliExecutor = (_spec, ctx) => {
 			return streamCliLeaf({
 				task,
 				signal,
+				traceEnv,
 				seam,
 				controller,
 				onProc: (p) => {
@@ -3611,6 +3636,7 @@ async function* streamCliLeaf(args) {
 		...args.seam.cwd ? { cwd: args.seam.cwd } : {},
 		env: {
 			...process.env,
+			...args.traceEnv,
 			...args.seam.env ?? {}
 		},
 		stdio: [
@@ -8573,10 +8599,20 @@ function routerBrainFromProfile(profile, deps) {
 }
 //#endregion
 //#region src/runtime/supervise/supervise.ts
-/** Build the worker seam from a backend (WHERE workers run) + an optional completion oracle (the
-*  deliverable check that makes "settled ⟺ delivered" true — the guard against "ran but didn't
-*  deliver"). The ONE place a backend becomes a spawnable worker. */
-function workerFromBackend(backend, deliverable) {
+/**
+* Build the worker seam from a backend (WHERE workers run) + an optional completion oracle (the
+* deliverable check that makes "settled ⟺ delivered" true — the guard against "ran but didn't
+* deliver"). The ONE place a backend becomes a spawnable worker.
+*
+* `seams` exists because this path builds the leaf executor EAGERLY and hands it back as a BYO
+* `executorSpec.executor`. The registry resolves a BYO executor without ever consulting the
+* per-child `ExecutorContext` the `Scope` seeds, so anything the scope would have supplied is
+* invisible here and has to be passed in. It is a FUNCTION because it is resolved once per worker
+* construction, so a caller may hand back something the run only learns later — which is exactly how
+* `supervise()` gives a traced run's workers their trace context without ordering the span recorder
+* ahead of the worker seam.
+*/
+function workerFromBackend(backend, deliverable, seams) {
 	return (rawProfile) => {
 		const p = rawProfile ?? {};
 		const name = typeof p.name === "string" && p.name.length > 0 ? p.name : "worker";
@@ -8586,7 +8622,7 @@ function workerFromBackend(backend, deliverable) {
 		};
 		const ctx = {
 			signal: new AbortController().signal,
-			seams: {}
+			seams: seams?.() ?? {}
 		};
 		const built = createExecutor(backend)(spec, ctx);
 		const executor = deliverable ? gateOnDeliverable(built, deliverable) : built;
@@ -8633,15 +8669,16 @@ function supervise(profile, task, opts) {
 	const ctx = opts.runDir !== void 0 ? createFileRunContext(opts.runDir, { withDriver: true }) : createInMemoryRunContext({ withDriver: true });
 	const blobs = opts.blobs ?? ctx.blobs;
 	const perWorker = opts.perWorker ?? defaultPerWorker(opts.budget);
+	const runId = opts.runId ?? "supervise";
+	const log = ctx.coordinationLog;
+	const now = opts.now ?? Date.now;
+	let spans;
 	let makeWorkerAgent = opts.makeWorkerAgent;
 	if (!makeWorkerAgent) {
 		if (!opts.backend) throw new ValidationError("supervise: provide opts.backend (where workers run) or opts.makeWorkerAgent");
-		makeWorkerAgent = workerFromBackend(opts.backend, deliverable);
+		makeWorkerAgent = workerFromBackend(opts.backend, deliverable, () => spans ? { [workerTraceSeamKey]: spans.workerTrace(runId) } : {});
 	}
 	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, {
@@ -8668,12 +8705,13 @@ function supervise(profile, task, opts) {
 			...opts.maxTurns !== void 0 ? { maxTurns: opts.maxTurns } : {},
 			...opts.compaction ? { compaction: opts.compaction } : {}
 		});
-		const spans = opts.otel ? createSupervisorSpanRecorder({
+		spans = opts.otel ? createSupervisorSpanRecorder({
 			runId,
 			...opts.otel,
 			now
 		}) : void 0;
-		const hooks = spans ? composeRuntimeHooks(opts.hooks, spans.hooks) : opts.hooks;
+		const recorder = spans;
+		const hooks = recorder ? composeRuntimeHooks(opts.hooks, recorder.hooks) : opts.hooks;
 		const run = createSupervisor().run(agent, task, {
 			budget: opts.budget,
 			runId,
@@ -8684,15 +8722,16 @@ function supervise(profile, task, opts) {
 			...probes ? { probes } : {},
 			...ctx.resume === true ? { resume: true } : {},
 			...opts.now ? { now: opts.now } : {},
-			...hooks ? { hooks } : {}
+			...hooks ? { hooks } : {},
+			...recorder ? { workerTrace: recorder.workerTrace } : {}
 		});
-		if (!spans) return run;
+		if (!recorder) return run;
 		try {
 			const result = await run;
-			await spans.finish({ result });
+			await recorder.finish({ result });
 			return result;
 		} catch (error) {
-			await spans.finish({ error });
+			await recorder.finish({ error });
 			throw error;
 		}
 	};
@@ -8701,4 +8740,4 @@ function supervise(profile, task, opts) {
 //#endregion
 export { InMemoryDelegationStore as $, FileCoordinationLog as $t, DELEGATE_INPUT_SCHEMA as A, createWorktreeCliExecutor as At, profileRichnessFinding as B, PI_MCP_ADAPTER_ENV as Bt, validateDelegateUiAuditArgs as C, defaultToolDetectors as Ct, createDelegateFeedbackHandler as D, cliWorktreeExecutor as Dt, DELEGATE_FEEDBACK_TOOL_NAME as E, createInMemoryRunContext as Et, delegate as F, piSeamKey as Ft, DELEGATION_TRACE_MAX_SPANS as G, createInbox as Gt, DelegationTaskQueue as H, buildPiMcpServers as Ht, asAuthoredProfile as I, createPushTraceSource as It, composeLoopTraceEmitters as J, runAgentRounds as Jt, buildDelegationTraceSpans as K, createSandboxForSpec as Kt, assessAuthoredProfile as L, decodeToolPart as Lt, createDelegateHandler as M, createSteerableSandboxSession as Mt, validateDelegateArgs as N, PI_RUNTIME as Nt, validateDelegateFeedbackArgs as O, createExecutor as Ot, defaultDelegateBudget as P, piExecutor as Pt, FileDelegationStore as Q, acquireSandbox as Qt, authoredWorker as R, sandboxSessionTraceSource as Rt, createDelegateUiAuditHandler as S, rollingDispatch as St, DELEGATE_FEEDBACK_INPUT_SCHEMA as T, createFileRunContext as Tt, hashIdempotencyInput as U, piMcpAdapterAvailable as Ut, supervisorInstructions as V, PI_MCP_CONFIG_FLAG as Vt, DELEGATION_TRACE_MAX_BYTES as W, preparePiMcp as Wt, DelegationPersistenceError as X, createSandboxLineage as Xt, createDelegationTraceCollector as Y, runLoop as Yt, DelegationStateCorruptError as Z, probeSandboxCapabilities as Zt, createDelegationHistoryHandler as _, createCoordinationTools as _t, supervisorAgent as a, allWorkersStalled as at, DELEGATE_UI_AUDIT_INPUT_SCHEMA as b, freeSlots as bt, createMcpServer as c, noProgressFor as ct, DELEGATION_STATUS_TOOL_NAME as d, anytimeReport as dt, createSupervisorSpanRecorder as en, InMemoryFeedbackStore as et, createDelegationStatusHandler as f, areaUnderCurve as ft, DELEGATION_HISTORY_TOOL_NAME as g, DEFAULT_AWAIT_EVENT_TIMEOUT_MS as gt, DELEGATION_HISTORY_INPUT_SCHEMA as h, renderAnytimeTable as ht, resolveSupervisorProfile as i, allOf as it, DELEGATE_TOOL_NAME as j, DEFAULT_SANDBOX_STEERING_MAX_TURNS as jt, DELEGATE_DESCRIPTION as k, createExecutorRegistry as kt, DELEGATION_STATUS_DESCRIPTION as l, plateau as lt, DELEGATION_HISTORY_DESCRIPTION as m, plateauLength as mt, workerFromBackend as n, gateOnDeliverable as nn, driverAgent as nt, serveCoordinationMcp as o, anyOf as ot, validateDelegationStatusArgs as p, bestSoFar as pt, capDelegationTrace as q, defaultSelectWinner as qt, assertCoordinationBinding as r, finalizeBestDelivered as rt, createInProcessTransport as s, createProgressTracker as st, supervise as t, assertModelAllowed as tn, eventToSnapshot as tt, DELEGATION_STATUS_INPUT_SCHEMA as u, sampleFromSettled as ut, validateDelegationHistoryArgs as v, createEventBus as vt, DELEGATE_FEEDBACK_DESCRIPTION as w, watchTrace as wt, DELEGATE_UI_AUDIT_TOOL_NAME as x, queueOf as xt, DELEGATE_UI_AUDIT_DESCRIPTION as y, effectiveConcurrency as yt, defaultProfileRichnessThresholds as z, PI_MCP_ADAPTER as zt };
 
-//# sourceMappingURL=supervise-BcCHhLrz.js.map
+//# sourceMappingURL=supervise-BUR9ByF7.js.map