@tangle-network/agent-runtime 0.247.0 → 0.252.0

package/dist/{substrate-CQ0hfewn.d.ts → substrate-Ctmos75o.d.ts}

@@ -1,4 +1,4 @@
-import { Ur as Driver, Vr as AgentRunSpec, hi as Validator, ui as OutputAdapter } from "./types-BUhz284C.js";
+import { Ur as Driver, Vr as AgentRunSpec, hi as Validator, ui as OutputAdapter } from "./types-BmxS-W-f.js";
 import { AgentProfile } from "@tangle-network/agent-interface";
 //#region src/profiles/coder.d.ts
 /**
@@ -281,4 +281,4 @@ interface UiFinding {
 }
 //#endregion
 export { CoderTask as _, UiFindingSeverity as a, KnowledgeUpdate as c, ResearchSource as d, ResearchTask as f, researcherProfile as g, multiHarnessResearcherFanout as h, UiFindingScreenshot as i, MultiHarnessResearcherFanoutOptions as l, createResearcherValidator as m, UI_LENSES as n, UiLens as o, ResearcherProfileOptions as p, UiFinding as r, KnowledgeItem as s, UI_FINDING_SEVERITIES as t, ResearchOutput as u, coderTaskToPrompt as v };
-//# sourceMappingURL=substrate-CQ0hfewn.d.ts.map
+//# sourceMappingURL=substrate-Ctmos75o.d.ts.map

package/dist/{supervise-DZEOpzRw.js → supervise-BXzkqfTE.js}

@@ -1,11 +1,11 @@
-import { $i as withBudgetResources, $n as contentAddress, Bn as linkAbort, Br as promptControlProfileMaterialization, C as restoreScopeOwnerAcceptedExecution, Cn as routerBrain, F as prepareScopeRetainedOwnerTask, Fr as assertProfileMaterialization, Ft as newUsageTotals, Gr as renderUnsupported, I as scopeRetainedOwnerContext, Ii as addSpend, In as registerRetainedExecutorPreparation, Ir as controlProfileMaterialization, Ji as unmeteredSpend, L as scopeRetainedOwnerPriorSpend, Ln as retainedExecutorSeamKey, Lr as defineProfileMaterializationContract, Lt as spendFromUsageTotals, M as bindScopeRetainedOwnerEnvironmentId, Mt as assertValidBudget, N as bindScopeRetainedOwnerProvider, P as consumeScopeRetainedOwnerResult, Pt as meterUsageEvent, Qi as resourceTelemetry, Qr as readCommittedJsonLines, R as scopeRetainedOwnerResourceReader, Rn as RunCancellationReason, Rr as fullProfileMaterialization, Rt as WORKER_TRACE_PROPAGATION, S as recordScopeOwnerMaterialization, Vn as runAbortable, Vr as promptModelProfileMaterialization, Wi as sleep, Xi as zeroSpend, Xr as isNoEntError, Yi as withTimeout, Yr as worktreeCliProfileMaterialization, Zi as addResourceSpend, Zr as prepareJsonlAppend, _ as beginScopeOwnerAttempt, aa as teardownExecutor, an as bridgeAdmissionRefusal, b as meterRuntimeOwnedAccounting, ci as providerAttemptEvidence, d as defaultUnmetContractSteer, di as runtimeOwnedExecutorExecutionBinding, dn as bridgeRuntimeAttachmentsKey, f as runDriverWithRetry, fi as runtimeOwnedExecutorMaterialization, fn as bridgeStopSignalKey, fr as generateSpanId, ft as snapshotExecutorConfig, gr as toOtelAttributes, h as isDriverSpec, hi as runtimeOwnedScopeOwnerRuntime, ii as inheritRuntimeOwnedExecutorAttestation, in as executorFailure, jn as resolveAgentEnvironmentProvider, l as HarnessTurnFailedError, li as recordRuntimeOwnedDriveHarnessProviderEvidence, lr as createOtelExporter, m as driverExecutorFactory, mi as runtimeOwnedPendingExecutorMaterialization, n as createSupervisor, o as runFinalizer, on as bridgeModelRouteRefusal, ot as bindReusableExecutorExecutionId, p as driverChild, pi as runtimeOwnedExecutorProviderEvidence, qr as unsupportedProfileDimensions, qt as createInbox, r as bestDelivered, ra as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, s as runTree, st as captureReusableExecutorConfig, t as createRootHandle, ti as attestRuntimeOwnedScopeOwner, tt as errMessage, ui as runtimeOwnedDriveHarnessProviderEvidence, ut as createExecutor, w as scopeOwnerExecutorNodeContext, x as meterRuntimeOwnedProviderAttempt, xi as detachedSnapshot, y as deriveNodeExecutionIdentity, z as scopeRetainedOwnerResult, zr as profileMaterializationAxes$1 } from "./supervisor-BIBWUFUr.js";
+import { $i as withBudgetResources, $n as contentAddress, Br as promptControlProfileMaterialization, C as restoreScopeOwnerAcceptedExecution, Cn as routerBrain, F as prepareScopeRetainedOwnerTask, Fr as assertProfileMaterialization, Ft as newUsageTotals, Gn as linkAbort, Gr as renderUnsupported, I as scopeRetainedOwnerContext, Ii as addSpend, In as registerRetainedExecutorPreparation, Ir as controlProfileMaterialization, Ji as unmeteredSpend, Kn as runAbortable, L as scopeRetainedOwnerPriorSpend, Ln as retainedExecutorSeamKey, Lr as defineProfileMaterializationContract, Lt as spendFromUsageTotals, M as bindScopeRetainedOwnerEnvironmentId, Mt as assertValidBudget, N as bindScopeRetainedOwnerProvider, P as consumeScopeRetainedOwnerResult, Pt as meterUsageEvent, Qi as resourceTelemetry, Qr as readCommittedJsonLines, R as scopeRetainedOwnerResourceReader, Rr as fullProfileMaterialization, Rt as WORKER_TRACE_PROPAGATION, S as recordScopeOwnerMaterialization, Un as RunCancellationReason, Vr as promptModelProfileMaterialization, Wi as sleep, Xi as zeroSpend, Xr as isNoEntError, Yi as withTimeout, Yr as worktreeCliProfileMaterialization, Zi as addResourceSpend, Zr as prepareJsonlAppend, _ as beginScopeOwnerAttempt, aa as teardownExecutor, an as bridgeAdmissionRefusal, b as meterRuntimeOwnedAccounting, ci as providerAttemptEvidence, d as defaultUnmetContractSteer, di as runtimeOwnedExecutorExecutionBinding, dn as bridgeRuntimeAttachmentsKey, f as runDriverWithRetry, fi as runtimeOwnedExecutorMaterialization, fn as bridgeStopSignalKey, fr as generateSpanId, ft as snapshotExecutorConfig, gr as toOtelAttributes, h as isDriverSpec, hi as runtimeOwnedScopeOwnerRuntime, ii as inheritRuntimeOwnedExecutorAttestation, in as executorFailure, jn as resolveAgentEnvironmentProvider, l as HarnessTurnFailedError, li as recordRuntimeOwnedDriveHarnessProviderEvidence, lr as createOtelExporter, m as driverExecutorFactory, mi as runtimeOwnedPendingExecutorMaterialization, n as createSupervisor, o as runFinalizer, on as bridgeModelRouteRefusal, ot as bindReusableExecutorExecutionId, p as driverChild, pi as runtimeOwnedExecutorProviderEvidence, qr as unsupportedProfileDimensions, qt as createInbox, r as bestDelivered, ra as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, s as runTree, st as captureReusableExecutorConfig, t as createRootHandle, ti as attestRuntimeOwnedScopeOwner, tt as errMessage, ui as runtimeOwnedDriveHarnessProviderEvidence, ut as createExecutor, w as scopeOwnerExecutorNodeContext, x as meterRuntimeOwnedProviderAttempt, xi as detachedSnapshot, y as deriveNodeExecutionIdentity, z as scopeRetainedOwnerResult, zr as profileMaterializationAxes$1 } from "./supervisor-OJwKAnFd.js";
 import { f as RuntimeRunStateError, i as ConfigError, m as ValidationError } from "./errors-DodWX-cb.js";
 import { a as concreteProfileModel, c as profileModelExecutionSettings, d as agentHarness, f as harnessRunsAgent, n as assertModelAllowed, o as enforceTokenLimits, r as assertProfileModelsAllowed, s as profileBridgeWireModel, t as assertExecutableAgentProfile } from "./model-policy-BbSCSak0.js";
 import { t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
 import { n as assertNoSymlinkDescendant } from "./durable-file-DWQA4ooo.js";
 import { n as createStdioToolServer, t as PROTOCOL_VERSION } from "./tool-server-x9NEhvHZ.js";
-import { D as coordinationVerbNames, S as watchRunCancellation, c as createProgressTracker, d as progressStop, k as createCoordinationToolsForManager, n as createSteerAcknowledger, r as driverAgent, t as createCancelAcknowledger, v as createFileRunContext, w as DEFAULT_AWAIT_EVENT_TIMEOUT_MS, x as applyRunCancellation, y as createInMemoryRunContext } from "./coordination-driver-BV4AAUns.js";
-import { k as writeRunCancellation, o as readRunCancelRequest, s as readRunCancellation } from "./run-layout-hKAJGF4g.js";
+import { D as coordinationVerbNames, S as watchRunCancellation, c as createProgressTracker, d as progressStop, k as createCoordinationToolsForManager, n as createSteerAcknowledger, r as driverAgent, t as createCancelAcknowledger, v as createFileRunContext, w as DEFAULT_AWAIT_EVENT_TIMEOUT_MS, x as applyRunCancellation, y as createInMemoryRunContext } from "./coordination-driver-QxitIuva.js";
+import { k as writeRunCancellation, o as readRunCancelRequest, s as readRunCancellation } from "./run-layout-vwd4SwX_.js";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, canonicalCandidateJson, validateAgentProfileSecurity } from "@tangle-network/agent-interface";
 import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
 import { closeSync, constants, fsyncSync, openSync, writeSync } from "node:fs";
@@ -1389,7 +1389,8 @@ function observeWorkerControls(options) {
 	};
 	const steers = createSteerAcknowledger({
 		...deps,
-		deliverRoot: options.deliverRoot
+		deliverRoot: options.deliverRoot,
+		deliverRootReady: options.deliverRootReady
 	});
 	const cancellations = createCancelAcknowledger(deps);
 	let active = true;
@@ -1717,6 +1718,9 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 	const driveHarness = deps.driveHarness;
 	if (!driveHarness) throw new ValidationError(`supervisorAgent: profile.harness="${harness}" needs deps.driveHarness (how to run the harness with the coordination MCP mounted)`);
 	const deliver = driveHarness.deliver?.bind(driveHarness);
+	const rawDeliverReady = driveHarness.deliverReady;
+	if (rawDeliverReady !== void 0 && typeof rawDeliverReady !== "function") throw new ValidationError("supervisorAgent: driveHarness.deliverReady must be a function when provided");
+	const deliverReady = rawDeliverReady?.bind(driveHarness);
 	const externalAgent = {
 		name,
 		...deliver ? { deliver(message) {
@@ -1732,6 +1736,7 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 			const nodeObserver = bindSupervisorNodeObserver(context, observeNodeEvent, deps.onEvent);
 			const stopController = new AbortController();
 			const coordinationLifetime = linkAbort(scope.signal);
+			let harnessInvocationActive = false;
 			const tracker = deps.stopRule ? createProgressTracker({ now: Date.now }) : void 0;
 			let progressStopReason;
 			let ledger;
@@ -1801,7 +1806,10 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 					scope,
 					signal: coordinationLifetime.signal,
 					controlScope: deps.controlScope ?? "run",
-					...deps.controlScope === "subtree" ? {} : { deliverRoot: (message) => deliver?.(message) ?? false },
+					...deps.controlScope === "subtree" ? {} : {
+						deliverRoot: (message) => deliver?.(message) ?? false,
+						deliverRootReady: () => deliver === void 0 || harnessInvocationActive && (deliverReady === void 0 || deliverReady())
+					},
 					onError: (error) => {
 						coordinationLifetime.abort(error);
 						stopController.abort(error);
@@ -1841,6 +1849,7 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 						if (deps.controlDir !== void 0 && deps.abortRun !== void 0) applyRunCancellation(deps.controlDir, deps.abortRun, () => (/* @__PURE__ */ new Date()).toISOString());
 						scope.signal.throwIfAborted();
 						beginScopeOwnerAttempt(scope, attempt);
+						harnessInvocationActive = true;
 						try {
 							await driveHarness({
 								profile: providerProfile,
@@ -1855,6 +1864,8 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 							});
 						} catch (error) {
 							if (!mcp.submittedResult() && !mcp.isStopped()) throw error;
+						} finally {
+							harnessInvocationActive = false;
 						}
 						if (contractDeclared && !mcp.submittedResult()) {
 							await mcp.drainResolved();
@@ -2965,6 +2976,7 @@ function driveHarnessFromBackend(backend, executionId, now = Date.now, maxTurns,
 		if (!deliver) return false;
 		return deliver.call(activeExecutor, message) !== false;
 	};
+	drive.deliverReady = () => activeExecutor !== void 0;
 	drive.traceSource = () => activeExecutor?.traceSource?.();
 	drive.progress = () => activeExecutor?.progress?.();
 	return attestRuntimeOwnedScopeOwner(drive, ownerRuntime);
@@ -3059,9 +3071,11 @@ function assertSuperviseOptionKeys(opts, context) {
 function captureDeliverable(deliverable, context) {
 	if (typeof deliverable !== "object" || deliverable === null || Array.isArray(deliverable)) throw new ValidationError(`${context}: deliverable must be an object`);
 	if (typeof deliverable.check !== "function") throw new ValidationError(`${context}: deliverable.check must be a function`);
+	if (deliverable.explainFailure !== void 0 && typeof deliverable.explainFailure !== "function") throw new ValidationError(`${context}: deliverable.explainFailure must be a function`);
 	return Object.freeze({
 		...detachedSnapshot({ describe: deliverable.describe }, `${context} configuration`),
-		check: deliverable.check
+		check: deliverable.check,
+		...deliverable.explainFailure === void 0 ? {} : { explainFailure: deliverable.explainFailure }
 	});
 }
 Object.freeze([...[
@@ -3230,7 +3244,8 @@ function recordRunCancellationOutcome(runDir, result, now) {
 		...record?.path === void 0 ? {} : { path: record.path },
 		...record?.appliedAfterMs === void 0 ? {} : { appliedAfterMs: record.appliedAfterMs },
 		...record?.deadlineExceeded === void 0 ? {} : { deadlineExceeded: record.deadlineExceeded },
-		...request.reason === void 0 ? {} : { reason: request.reason }
+		...request.reason === void 0 ? {} : { reason: request.reason },
+		...request.operator === void 0 ? {} : { operator: request.operator }
 	};
 	if (record === void 0) {
 		writeRunCancellation(dir, {
@@ -3442,6 +3457,8 @@ function superviseInternal(profile, task, opts, testBrain) {
 		const harness = rawHarness;
 		const deliver = harness.deliver;
 		if (deliver !== void 0 && typeof deliver !== "function") throw new ValidationError("supervise: driveHarness.deliver must be a function when provided");
+		const deliverReady = harness.deliverReady;
+		if (deliverReady !== void 0 && typeof deliverReady !== "function") throw new ValidationError("supervise: driveHarness.deliverReady must be a function when provided");
 		const claim = harnessClaims.get(harness);
 		const conflictingOwner = claim ? [...claim.owners].find((claimedOwner) => claimedOwner !== ownerId) : void 0;
 		const steerable = typeof deliver === "function";
@@ -3813,4 +3830,4 @@ function rootProviderModelEvidenceFromExecution(evidence) {
 //#endregion
 export { createSupervisorSpanRecorder as _, isPreSpawnExecutorFailure as a, mapExecutorResult as b, withWorkerSpawnRetry as c, resolveSupervisorProfile as d, supervisorAgent as f, readRootStreamReceipt as g, readRootStream as h, workerFromBackend as i, assertCoordinationBinding as l, ROOT_STREAM_FILE as m, supervise as n, resolveWorkerSpawnRetry as o, supervisorAgentWithTestBrain as p, superviseWithTestBrain as r, retryPreSpawnRefusals as s, DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY as t, coordinationProfileToolPrefix as u, serveCoordinationMcp as v, gateOnDeliverable as y };
 
-//# sourceMappingURL=supervise-DZEOpzRw.js.map
+//# sourceMappingURL=supervise-BXzkqfTE.js.map