@tangle-network/agent-runtime 0.134.6 → 0.134.8

package/dist/{supervise-CR8zPmfT.js → supervise-B-nTWUCK.js}

@@ -4,15 +4,17 @@ import { S as contentAddress, b as parseWorkerToolTraceArtifact, d as prepareJso
 import { n as chargedTokens } from "./util-C1bv6yog.js";
 import { a as concreteProfileModel, d as harnessRunsAgent, n as assertModelAllowed, r as assertProfileModelsAllowed, s as profileModelExecutionSettings, t as assertExecutableAgentProfile, u as agentHarness } from "./model-policy-UTTc9Z-A.js";
 import { S as runtimeOwnedScopeOwnerRuntime, _ as runtimeOwnedDriveHarnessProviderEvidence, b as runtimeOwnedExecutorProviderEvidence, d as recordRuntimeOwnedDriveHarnessProviderEvidence, i as attestRuntimeOwnedScopeOwner, s as inheritRuntimeOwnedExecutorAttestation, v as runtimeOwnedExecutorExecutionBinding, x as runtimeOwnedPendingExecutorMaterialization, y as runtimeOwnedExecutorMaterialization } from "./materialization-BP5zspr2.js";
-import { $ as createInbox, B as WORKER_TRACE_PROPAGATION, D as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, Et as toOtelAttributes, Gt as controlProfileMaterialization, I as createExecutor, Jt as profileMaterializationAxes$1, Kt as defineProfileMaterializationContract, L as createExecutorRegistry, M as bindReusableExecutorExecutionId, N as bridgeStopSignalKey, O as teardownExecutor, P as captureReusableExecutorConfig, R as snapshotExecutorConfig, St as generateSpanId, Wt as assertProfileMaterialization, Xt as promptModelProfileMaterialization, Yt as promptControlProfileMaterialization, a as pickBestDelivered, c as driverChild, d as deriveNodeExecutionIdentity, f as meterRuntimeOwnedAccounting, gt as buildLoopSpanNodes, h as scopeOwnerExecutorNodeContext, j as spendFromUsageEvents, k as assertValidBudget, l as withDriverExecutor, m as recordScopeOwnerMaterialization, n as createSupervisor, nn as worktreeCliProfileMaterialization, o as runFinalizer, ot as routerBrain, p as meterRuntimeOwnedProviderAttempt, qt as fullProfileMaterialization, r as bestDelivered, s as runTree, st as runBrainLoop, w as freeSlots, yt as createOtelExporter } from "./supervisor-DEEGgN_S.js";
+import { $ as createInbox, B as WORKER_TRACE_PROPAGATION, D as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, Et as toOtelAttributes, Gt as controlProfileMaterialization, I as createExecutor, Jt as profileMaterializationAxes$1, Kt as defineProfileMaterializationContract, L as createExecutorRegistry, M as bindReusableExecutorExecutionId, N as bridgeStopSignalKey, O as teardownExecutor, P as captureReusableExecutorConfig, R as snapshotExecutorConfig, St as generateSpanId, Wt as assertProfileMaterialization, Xt as promptModelProfileMaterialization, Yt as promptControlProfileMaterialization, a as pickBestDelivered, c as driverChild, d as deriveNodeExecutionIdentity, f as meterRuntimeOwnedAccounting, gt as buildLoopSpanNodes, h as scopeOwnerExecutorNodeContext, j as spendFromUsageEvents, k as assertValidBudget, l as withDriverExecutor, m as recordScopeOwnerMaterialization, n as createSupervisor, nn as worktreeCliProfileMaterialization, o as runFinalizer, ot as routerBrain, p as meterRuntimeOwnedProviderAttempt, qt as fullProfileMaterialization, r as bestDelivered, s as runTree, st as runBrainLoop, w as freeSlots, yt as createOtelExporter } from "./supervisor-Dl9Fk7g5.js";
 import { t as composeRuntimeHooks } from "./runtime-hooks-C7iJOWm3.js";
+import { _ as writeWorkerCancellation, a as readWorkerCancellation, i as readWorkerCancelRequests } from "./run-layout-Be_Z0dF8.js";
 import { t as createStdioToolServer } from "./tool-server-Dh-NcbHr.js";
 import { n as UI_LENSES } from "./substrate-B0TYNrXn.js";
 import { argHash, errorStreakDetector, observeAll, repeatedActionDetector } from "@tangle-network/agent-eval";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, validateAgentProfileSecurity } from "@tangle-network/agent-interface";
 import { randomUUID } from "node:crypto";
-import path, { dirname, resolve } from "node:path";
+import path, { dirname, join, resolve } from "node:path";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { readFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { Readable, Writable } from "node:stream";
 //#region src/runtime/supervise/completion-gate.ts
@@ -1018,6 +1020,7 @@ function createCoordinationTools(opts) {
 	const completedKeys = /* @__PURE__ */ new Set();
 	const keyByWorker = /* @__PURE__ */ new Map();
 	const profileNameByWorker = /* @__PURE__ */ new Map();
+	const liveHandles = /* @__PURE__ */ new Map();
 	let unkeyedAssignmentOrdinal = nextUnkeyedAssignmentOrdinal(opts.scope);
 	for (const [key, prior] of opts.scope.resume?.keys ?? []) if (prior.state === "completed") completedKeys.add(key);
 	const nodeForWorker = (id) => opts.scope.view.nodes.find((node) => node.id === id) ?? opts.scope.resume?.view.nodes.find((node) => node.id === id);
@@ -1849,6 +1852,7 @@ function createCoordinationTools(opts) {
 				}
 				if (res.ok) {
 					watchWorker(res.handle.id);
+					liveHandles.set(res.handle.id, res.handle);
 					if (key !== void 0) keyByWorker.set(res.handle.id, key);
 					if (typeof profile.name === "string" && profile.name.length > 0) profileNameByWorker.set(res.handle.id, profile.name);
 				}
@@ -2231,6 +2235,18 @@ function createCoordinationTools(opts) {
 			}
 		});
 	}
+	const abortWorker = (ref, reason) => {
+		const live = opts.scope.view.nodes.filter((node) => isLive(node.status));
+		const target = live.find((node) => node.id === ref) ?? live.find((node) => profileNameByWorker.get(node.id) === ref) ?? live.find((node) => node.label === ref);
+		if (target === void 0) return void 0;
+		const handle = liveHandles.get(target.id);
+		if (handle === void 0) return void 0;
+		handle.abort(reason);
+		return {
+			id: target.id,
+			label: target.label
+		};
+	};
 	return {
 		tools,
 		ready,
@@ -2245,7 +2261,8 @@ function createCoordinationTools(opts) {
 		submittedResult: () => submitted,
 		settled: () => ledger,
 		questions: () => questions,
-		drainResolved
+		drainResolved,
+		abortWorker
 	};
 }
 function nextUnkeyedAssignmentOrdinal(scope) {
@@ -2770,6 +2787,142 @@ function validateDriverPromptCache(promptCache) {
 		if (!Number.isSafeInteger(value) || value < 0) return new ValidationError(`driverAgent: prompt-cache field ${JSON.stringify(field)} must be a non-negative safe integer`);
 	}
 }
+/** 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. */
+const SPAWN_JOURNAL_FILE = "spawn-journal.jsonl";
+/**
+* The worker-cancel ACKNOWLEDGER — the runtime-side half of `run-layout`'s `cancelWorker`
+* contract, run from the coordination driver's turn loop (one cancellation-inbox read per turn,
+* no new process, no poller, no extra lifetime).
+*
+* Two-phase, honestly reported: `cancel_requested` is written the moment a live worker's abort is
+* issued (through the per-child abort chain the scope already owns, so siblings are untouched);
+* `cancelled` is written only when that worker's settlement is DELIVERED on the settle path with
+* a terminal `down`, and then the record names every subtree node id proven terminated. A worker
+* that already settled — or that settles `done` despite the abort — records `not_live`; a
+* reference matching nothing this manager knows stays pending (`cancelWorker` reports it
+* `unknown`). No path reports success for a missing worker.
+*
+* Idempotency is a lookup, in-process and across processes: an operation with a durable
+* acknowledgement is returned as-is and never re-applied.
+*/
+function createCancelAcknowledger(deps) {
+	const tracked = /* @__PURE__ */ new Map();
+	const iso = () => new Date(deps.now()).toISOString();
+	const write = (record) => {
+		writeWorkerCancellation(deps.dir, record);
+		tracked.set(record.operationId, record);
+	};
+	const deliveredTerminal = (id) => {
+		const row = deps.coord.settled().find((w) => w.id === id);
+		if (row !== void 0) return row.status;
+		const node = deps.scope.view.nodes.find((n) => n.id === id);
+		if (node === void 0) return void 0;
+		if (node.status === "done") return "done";
+		if (node.status === "failed" || node.status === "cancelled") return "down";
+	};
+	const apply = (request) => {
+		const aborted = deps.coord.abortWorker(request.worker, request.reason ?? "cancel requested");
+		const base = {
+			operationId: request.operationId,
+			worker: request.worker,
+			requestedAt: request.at,
+			observedAt: iso(),
+			...request.reason === void 0 ? {} : { reason: request.reason }
+		};
+		if (aborted !== void 0) {
+			write({
+				...base,
+				effect: "cancel_requested",
+				workerId: aborted.id,
+				detail: `abort issued to live worker '${aborted.label}' (${aborted.id}); termination not yet proven`,
+				terminated: []
+			});
+			return;
+		}
+		const goneId = deps.scope.view.nodes.find((n) => (n.id === request.worker || n.label === request.worker) && (n.status === "done" || n.status === "failed" || n.status === "cancelled"))?.id ?? deps.coord.settled().find((w) => w.id === request.worker)?.id;
+		if (goneId !== void 0) write({
+			...base,
+			effect: "not_live",
+			workerId: goneId,
+			detail: `worker '${goneId}' had already settled before this operation was applied`,
+			terminated: []
+		});
+	};
+	const reconcile = (record) => {
+		const workerId = record.workerId;
+		if (workerId === void 0) return;
+		const terminal = deliveredTerminal(workerId);
+		if (terminal === void 0) return;
+		if (terminal === "down") {
+			write({
+				...record,
+				effect: "cancelled",
+				observedAt: iso(),
+				terminated: [workerId, ...terminatedDescendants(deps.dir, workerId, record.requestedAt)],
+				detail: `worker '${workerId}' reached a terminal down state on the settle path`
+			});
+			return;
+		}
+		write({
+			...record,
+			effect: "not_live",
+			observedAt: iso(),
+			terminated: [],
+			detail: `worker '${workerId}' settled done despite the abort request; nothing was terminated`
+		});
+	};
+	return { pass() {
+		for (const request of readWorkerCancelRequests(deps.dir)) {
+			let record = tracked.get(request.operationId);
+			if (record === void 0) {
+				record = readWorkerCancellation(deps.dir, request.operationId);
+				if (record !== void 0) tracked.set(request.operationId, record);
+			}
+			if (record === void 0) {
+				apply(request);
+				continue;
+			}
+			if (record.effect === "cancel_requested") reconcile(record);
+		}
+	} };
+}
+/**
+* Subtree node ids with a terminal `down`/`cancelled` journal record at or after `sinceIso` —
+* the descendants a cancelled lead's cascading abort took down, read from the durable spawn
+* journal beside the run layout (the nested trees journal their terminal records before the lead
+* itself settles). Ids are hierarchical (`parent:sN`), so `${nodeId}:` prefixes exactly the
+* subtree. Tolerant of a missing or partially-written journal: evidence that cannot be read
+* names fewer nodes, never wrong ones.
+*/
+function terminatedDescendants(dir, nodeId, sinceIso) {
+	let raw;
+	try {
+		raw = readFileSync(join(dir, SPAWN_JOURNAL_FILE), "utf8");
+	} catch {
+		return [];
+	}
+	const prefix = `${nodeId}:`;
+	const ids = /* @__PURE__ */ new Set();
+	for (const line of raw.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		let parsed;
+		try {
+			parsed = JSON.parse(trimmed);
+		} catch {
+			continue;
+		}
+		if (parsed.kind !== "event" || parsed.event === void 0) continue;
+		const event = parsed.event;
+		if (!(event.kind === "settled" && event.status === "down" || event.kind === "cancelled")) continue;
+		if (typeof event.id !== "string" || !event.id.startsWith(prefix)) continue;
+		if (typeof event.at !== "string" || event.at < sinceIso) continue;
+		ids.add(event.id);
+	}
+	return [...ids].sort();
+}
 /**
 * Build the intelligent recursive driver. Its `act` is the LLM tool-loop; spawn it as a
 * `driverChild` (`driver-executor.ts`) to run it inside a nested scope, recursively.
@@ -2815,6 +2968,12 @@ function driverAgent(opts) {
 				...opts.priorCoordination?.questions.length ? { priorQuestions: opts.priorCoordination.questions } : {}
 			});
 			await coord.ready();
+			const acknowledger = opts.controlDir === void 0 ? void 0 : createCancelAcknowledger({
+				dir: opts.controlDir,
+				coord,
+				scope,
+				now
+			});
 			for (const w of scope.resume?.waits ?? []) {
 				const rearmed = scope.wait(w.spec, { label: w.label });
 				if (!rearmed.ok) throw new RuntimeRunStateError(`driverAgent: cannot re-arm resumed wait '${w.label}' (${rearmed.reason})`);
@@ -2983,6 +3142,7 @@ function driverAgent(opts) {
 				maxTurns,
 				hooks: {
 					beforeTurn: (_turn, messages) => {
+						acknowledger?.pass();
 						const pending = inbox.drain();
 						if (pending.length > 0) messages.push({
 							role: "user",
@@ -3003,6 +3163,7 @@ function driverAgent(opts) {
 				}
 			});
 			await coord.drainResolved();
+			acknowledger?.pass();
 			const submitted = coord.submittedResult();
 			if (submitted) return submitted.result;
 			return runFinalizer(opts.finalizer ?? bestDelivered, {
@@ -5457,6 +5618,7 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 			...deps.replaySettlements ? { replaySettlements: true } : {},
 			...priorCoordination ? { priorCoordination } : {},
 			...deps.finalizer ? { finalizer: deps.finalizer } : {},
+			...deps.controlDir === void 0 ? {} : { controlDir: deps.controlDir },
 			inbox
 		});
 		if (!deps.loadPriorCoordination && !resolveTools && !observeNodeEvent) return build(deps.priorCoordination, void 0, deps.onEvent);
@@ -6510,7 +6672,8 @@ function superviseInternal(profile, task, opts, testBrain) {
 			...options.maxTurns !== void 0 ? { maxTurns: options.maxTurns } : {},
 			...options.compaction ? { compaction: options.compaction } : {},
 			...options.driverRetry ? { driverRetry: options.driverRetry } : {},
-			...options.onDriverAttempt ? { onDriverAttempt: options.onDriverAttempt } : {}
+			...options.onDriverAttempt ? { onDriverAttempt: options.onDriverAttempt } : {},
+			...options.runDir === void 0 ? {} : { controlDir: resolve(options.runDir) }
 		};
 		const agent = testBrain === void 0 ? supervisorAgent(canonicalProfile, agentDeps) : supervisorAgentWithTestBrain(canonicalProfile, {
 			...agentDeps,
@@ -6589,4 +6752,4 @@ function rootProviderModelEvidenceFromExecution(evidence) {
 //#endregion
 export { DELEGATION_TRACE_MAX_BYTES as $, DELEGATION_HISTORY_INPUT_SCHEMA as A, defaultToolDetectors as At, DELEGATE_FEEDBACK_INPUT_SCHEMA as B, createMcpServer as C, plateauLength as Ct, createDelegationStatusHandler as D, createCoordinationTools as Dt, DELEGATION_STATUS_TOOL_NAME as E, canonicalFindingEvent as Et, DELEGATE_UI_AUDIT_INPUT_SCHEMA as F, createSupervisorSpanRecorder as Ft, DELEGATE_INPUT_SCHEMA as G, createDelegateFeedbackHandler as H, DELEGATE_UI_AUDIT_TOOL_NAME as I, gateOnDeliverable as It, validateDelegateArgs as J, DELEGATE_TOOL_NAME as K, createDelegateUiAuditHandler as L, mapExecutorResult as Lt, createDelegationHistoryHandler as M, createFileRunContext as Mt, validateDelegationHistoryArgs as N, createInMemoryRunContext as Nt, validateDelegationStatusArgs as O, normalizeAnalyzeOnSettle as Ot, DELEGATE_UI_AUDIT_DESCRIPTION as P, FileCoordinationLog as Pt, hashIdempotencyInput as Q, validateDelegateUiAuditArgs as R, createInProcessTransport as S, bestSoFar as St, DELEGATION_STATUS_INPUT_SCHEMA as T, DEFAULT_AWAIT_EVENT_TIMEOUT_MS as Tt, validateDelegateFeedbackArgs as U, DELEGATE_FEEDBACK_TOOL_NAME as V, DELEGATE_DESCRIPTION as W, delegate as X, defaultDelegateBudget as Y, DelegationTaskQueue as Z, promptHandle as _, noProgressFor as _t, assertCoordinationBinding as a, DelegationPersistenceError as at, classifyDriverFailure as b, anytimeReport as bt, supervisorAgentWithTestBrain as c, InMemoryDelegationStore as ct, delegatesWorkerBriefPrompt as d, driverAgent as dt, DELEGATION_TRACE_MAX_SPANS as et, dumbContinuationFailPrompt as f, finalizeBestDelivered as ft, naiveContinuationPrompt as g, createProgressTracker as gt, kernelPromptRegistry as h, anyOf as ht, workerFromBackend as i, createDelegationTraceCollector as it, DELEGATION_HISTORY_TOOL_NAME as j, watchTrace as jt, DELEGATION_HISTORY_DESCRIPTION as k, createEventBus as kt, analyzesFindingsReportPrompt as l, InMemoryFeedbackStore as lt, formatPromptHandle as m, allWorkersStalled as mt, supervise as n, capDelegationTrace as nt, resolveSupervisorProfile as o, DelegationStateCorruptError as ot, dumbContinuationPassPrompt as p, allOf as pt, createDelegateHandler as q, superviseWithTestBrain as r, composeLoopTraceEmitters as rt, supervisorAgent as s, FileDelegationStore as st, DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY as t, buildDelegationTraceSpans as tt, createPromptRegistry as u, eventToSnapshot as ut, supervisorPolicyPrompt as v, plateau as vt, DELEGATION_STATUS_DESCRIPTION as w, renderAnytimeTable as wt, serveCoordinationMcp as x, areaUnderCurve as xt, DriverAttemptsExhaustedError as y, sampleFromSettled as yt, DELEGATE_FEEDBACK_DESCRIPTION as z };
 
-//# sourceMappingURL=supervise-CR8zPmfT.js.map
+//# sourceMappingURL=supervise-B-nTWUCK.js.map