@tangle-network/agent-runtime 0.309.0 → 0.312.0

package/dist/{supervise-B5iHXeuw.js → supervise-CGMzXi_j.js}

@@ -1,10 +1,10 @@
-import { $n as parseWorkerToolTraceArtifact, A as scopeOwnerExecutorNodeContext, Ai as worktreeCliProfileMaterialization, An as resolveAgentEnvironmentProvider, At as captureReusableExecutorConfig, B as consumeScopeRetainedOwnerResult, Bi as recordRuntimeOwnedDriveHarnessProviderEvidence, C as deriveNodeExecutionIdentity, Ct as createContinuationKeeper, D as recordScopeOwnerMaterialization, E as recordScopeOwnerDriverAttempt, Ei as renderUnsupported, F as seatExecutionProfile, Fi as inheritRuntimeOwnedExecutorAttestation, Fn as retainedExecutorSeamKey, Ft as snapshotExecutorConfig, G as scopeRetainedOwnerContext, Gi as runtimeOwnedPendingExecutorMaterialization, H as prepareScopeRetainedOwnerSeatSwitch, Hi as runtimeOwnedExecutorExecutionBinding, I as abandonScopeRetainedOwnerInvocation, J as scopeRetainedOwnerResourceReader, Jn as readCommittedJsonLines, Jt as createActivityLog, K as scopeRetainedOwnerJournalRoot, Ki as runtimeOwnedScopeOwnerRuntime, Kn as isNoEntError, Kr as generateSpanId, L as beginScopeRetainedOwnerDrive, M as SeatChain, Mi as attestRuntimeOwnedScopeOwner, Mr as contentAddress, N as SeatChainExhaustedError, Nt as createExecutor, O as recordScopeOwnerPause, Oi as unsupportedProfileDimensions, Or as persistHarnessTranscript, P as authoredSeatStages, Pn as registerRetainedExecutorPreparation, Qi as detachedSnapshot, R as bindScopeRetainedOwnerEnvironmentId, Si as promptModelProfileMaterialization, Sr as RunCancellationReason, St as checkVerdictOf, T as meterRuntimeOwnedProviderAttempt, Tr as runAbortable, U as prepareScopeRetainedOwnerTask, Ui as runtimeOwnedExecutorMaterialization, V as noteScopeRetainedOwnerCoordination, Vi as runtimeOwnedDriveHarnessProviderEvidence, Vt as WORKER_TRACE_PROPAGATION, W as reconcileScopeRetainedOwnerEnvironment, Wi as runtimeOwnedExecutorProviderEvidence, Wr as createOtelExporter, X as scopeRetainedOwnerResult, Xr as toOtelAttributes, Xt as createInbox, Y as scopeRetainedOwnerRestorePoint, Z as scopeRetainedOwnerTurnEnded, _ as isDriverSpec, _i as controlProfileMaterialization, an as isLiveNodeStatus, b as assertRecursiveReservationPolicy, bi as profileMaterializationAxes$1, c as runTree, cn as bridgeModelRouteRefusal, dr as bridgeStopSignalKey, f as runDriverWithRetry, fr as errMessage, g as driverExecutorFactory, gi as assertProfileMaterialization, gt as CONTINUATIONS_DIR, h as driverChild, i as bestDelivered, ir as assertValidBudget, it as providerVisibleProfile, k as restoreScopeOwnerAcceptedExecution, kr as readHarnessTranscript, kt as bindReusableExecutorExecutionId, lr as spendFromUsageTotals, mt as gateOnDeliverable, n as createRootHandle, nt as coordinationMcpAlias, or as meterUsageEvent, p as summarizeDriverAttempts, q as scopeRetainedOwnerPriorSpend, qn as prepareJsonlAppend, r as createSupervisor, rt as coordinationProfileToolPrefix, s as runFinalizer, sn as bridgeAdmissionRefusal, sr as newUsageTotals, tr as executorFailure, u as HarnessTurnFailedError, ur as bridgeRuntimeAttachmentsKey, vi as defineProfileMaterializationContract, vt as CheckUnavailableError, w as meterRuntimeOwnedAccounting, wn as routerBrain, wr as linkAbort, x as beginScopeOwnerAttempt, xi as promptControlProfileMaterialization, xt as bestComposite, yi as fullProfileMaterialization, yt as admitContinuationPolicy, z as bindScopeRetainedOwnerProvider, zi as providerAttemptEvidence, zt as createRouterTranscript } from "./supervisor-Cd39ZN4b.js";
+import { $n as parseWorkerToolTraceArtifact, A as scopeOwnerExecutorNodeContext, Ai as worktreeCliProfileMaterialization, An as resolveAgentEnvironmentProvider, At as captureReusableExecutorConfig, B as consumeScopeRetainedOwnerResult, Bi as recordRuntimeOwnedDriveHarnessProviderEvidence, C as deriveNodeExecutionIdentity, Ct as createContinuationKeeper, D as recordScopeOwnerMaterialization, E as recordScopeOwnerDriverAttempt, Ei as renderUnsupported, F as seatExecutionProfile, Fi as inheritRuntimeOwnedExecutorAttestation, Fn as retainedExecutorSeamKey, Ft as snapshotExecutorConfig, G as scopeRetainedOwnerContext, Gi as runtimeOwnedPendingExecutorMaterialization, H as prepareScopeRetainedOwnerSeatSwitch, Hi as runtimeOwnedExecutorExecutionBinding, I as abandonScopeRetainedOwnerInvocation, J as scopeRetainedOwnerResourceReader, Jn as readCommittedJsonLines, Jt as createActivityLog, K as scopeRetainedOwnerJournalRoot, Ki as runtimeOwnedScopeOwnerRuntime, Kn as isNoEntError, Kr as generateSpanId, L as beginScopeRetainedOwnerDrive, M as SeatChain, Mi as attestRuntimeOwnedScopeOwner, Mr as contentAddress, N as SeatChainExhaustedError, Nt as createExecutor, O as recordScopeOwnerPause, Oi as unsupportedProfileDimensions, Or as persistHarnessTranscript, P as authoredSeatStages, Pn as registerRetainedExecutorPreparation, Qi as detachedSnapshot, R as bindScopeRetainedOwnerEnvironmentId, Si as promptModelProfileMaterialization, Sr as RunCancellationReason, St as checkVerdictOf, T as meterRuntimeOwnedProviderAttempt, Tr as runAbortable, U as prepareScopeRetainedOwnerTask, Ui as runtimeOwnedExecutorMaterialization, V as noteScopeRetainedOwnerCoordination, Vi as runtimeOwnedDriveHarnessProviderEvidence, Vt as WORKER_TRACE_PROPAGATION, W as reconcileScopeRetainedOwnerEnvironment, Wi as runtimeOwnedExecutorProviderEvidence, Wr as createOtelExporter, X as scopeRetainedOwnerResult, Xr as toOtelAttributes, Xt as createInbox, Y as scopeRetainedOwnerRestorePoint, Z as scopeRetainedOwnerTurnEnded, _ as isDriverSpec, _i as controlProfileMaterialization, an as isLiveNodeStatus, b as assertRecursiveReservationPolicy, bi as profileMaterializationAxes$1, c as runTree, cn as bridgeModelRouteRefusal, dr as bridgeStopSignalKey, f as runDriverWithRetry, fr as errMessage, g as driverExecutorFactory, gi as assertProfileMaterialization, gt as CONTINUATIONS_DIR, h as driverChild, i as bestDelivered, ir as assertValidBudget, it as providerVisibleProfile, k as restoreScopeOwnerAcceptedExecution, kr as readHarnessTranscript, kt as bindReusableExecutorExecutionId, lr as spendFromUsageTotals, mt as gateOnDeliverable, n as createRootHandle, nt as coordinationMcpAlias, or as meterUsageEvent, p as summarizeDriverAttempts, q as scopeRetainedOwnerPriorSpend, qn as prepareJsonlAppend, r as createSupervisor, rt as coordinationProfileToolPrefix, s as runFinalizer, sn as bridgeAdmissionRefusal, sr as newUsageTotals, tr as executorFailure, u as HarnessTurnFailedError, ur as bridgeRuntimeAttachmentsKey, vi as defineProfileMaterializationContract, vt as CheckUnavailableError, w as meterRuntimeOwnedAccounting, wn as routerBrain, wr as linkAbort, x as beginScopeOwnerAttempt, xi as promptControlProfileMaterialization, xt as bestComposite, yi as fullProfileMaterialization, yt as admitContinuationPolicy, z as bindScopeRetainedOwnerProvider, zi as providerAttemptEvidence, zt as createRouterTranscript } from "./supervisor-DgcmBicU.js";
 import { f as RuntimeRunStateError, i as ConfigError, m as ValidationError } from "./errors-DodWX-cb.js";
-import { G as errorMessage, St as teardownSurfaces, Y as isAsyncIterable$1, at as unmeteredSpend, dt as resourceTelemetry, ft as withBudgetResources, ht as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, lt as addResourceSpend, ot as withTimeout, st as zeroSpend, tt as sleep, xt as teardownExecutor, z as addSpend } from "./workspace-streams-DaQceg2p.js";
+import { G as errorMessage, Tt as teardownSurfaces, Y as isAsyncIterable$1, _t as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, at as unmeteredSpend, dt as resourceTelemetry, ft as withBudgetResources, lt as addResourceSpend, ot as withTimeout, st as zeroSpend, tt as sleep, wt as teardownExecutor, z as addSpend } from "./workspace-streams-BEvSX97P.js";
 import { _ as agentHarness, a as concreteProfileModel, c as profileModelExecutionSettings, n as assertModelAllowed, o as enforceTokenLimits, r as assertProfileModelsAllowed, s as profileBridgeWireModel, t as assertExecutableAgentProfile, v as harnessRunsAgent } from "./model-policy-DydyWTQg.js";
 import { n as assertNoSymlinkDescendant } from "./durable-file-DWQA4ooo.js";
 import { t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
-import { C as createInMemoryRunContext, D as applyRunCancellation, M as coordinationVerbNames, O as watchRunCancellation, P as createCoordinationToolsForManager, S as createFileRunContext, c as resolveWakePolicy, f as createProgressTracker, h as progressStop, m as plateau, n as createSteerAcknowledger, o as composeWakeInput, r as driverAgent, s as deadlineWarningAt, t as createCancelAcknowledger, w as withRunContext } from "./coordination-driver-nxGtWmJm.js";
+import { C as createInMemoryRunContext, D as applyRunCancellation, M as coordinationVerbNames, O as watchRunCancellation, P as createCoordinationToolsForManager, S as createFileRunContext, c as resolveWakePolicy, f as createProgressTracker, h as progressStop, m as plateau, n as createSteerAcknowledger, o as composeWakeInput, r as driverAgent, s as deadlineWarningAt, t as createCancelAcknowledger, w as withRunContext } from "./coordination-driver-Cp2z1zz6.js";
 import { r as createStdioToolServer, t as PROTOCOL_VERSION } from "./tool-server-Dqer2M4_.js";
 import { k as writeRunCancellation, o as readRunCancelRequest, s as readRunCancellation } from "./run-layout-DSCWdbX2.js";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, canonicalCandidateJson, validateAgentProfileSecurity } from "@tangle-network/agent-interface";
@@ -1808,7 +1808,7 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 	if (harness === null && deps.continuation !== void 0) throw new ValidationError("supervisorAgent: continuation applies to an EXTERNAL-harness supervisor only (profile.harness set). A router-brained supervisor runs its own turn loop in process, so the policy would be silently ignored.");
 	if (deps.continuation !== void 0 && deps.deliverable === void 0) throw new ValidationError("supervisorAgent: continuation needs a `deliverable` completion check — with no check there is no contract that can be unmet");
 	if (harness !== null && deps.deliverable !== void 0 && deps.continuation === void 0) throw new ValidationError("supervisorAgent: a manager with a completion check needs a continuation policy (deadline, maxBarren, the note profile and switches). Runtime supplies no default: how long to send a director back, and what to tell it, is the record's decision");
-	if (deps.deliverable !== void 0 && runtimeToolNames.includes("stop")) throw new ValidationError(`supervisorAgent: the profile grants ${coordinationProfileToolPrefix}stop to a manager with a completion check. Such a manager ends only through submit_result (the check passes) or report_blocked (a failed probe); remove stop from its tools`);
+	if (deps.deliverable !== void 0 && runtimeToolNames.includes("stop")) throw new ValidationError(`supervisorAgent: the profile grants ${coordinationProfileToolPrefix}stop to a manager with a completion check. Such a manager ends only through submit_result (the check passes) or a bound (deadline, budget, cancellation, no progress); remove stop from its tools`);
 	const continuationDeadlineMs = deps.continuation === void 0 ? void 0 : admitContinuationPolicy(deps.continuation, "supervisorAgent");
 	if (harness === null) {
 		assertRouterArmResourcePolicy(stableProfile);
@@ -2119,12 +2119,14 @@ function buildSupervisorAgent(profile, deps, testBrain) {
 				const describe = deps.deliverable?.describe;
 				const settleLoop = () => {
 					const stopReason = controls.stopReason() ?? progressStopReason;
-					const closedBy = mcp.submittedResult() ? "result-accepted" : controls.blocked() !== void 0 ? "blocked" : mcp.isStopped() ? "stop" : progressStopReason !== void 0 ? "stop-rule" : void 0;
+					const closedBy = mcp.submittedResult() ? "result-accepted" : mcp.isStopped() ? "stop" : progressStopReason !== void 0 ? "stop-rule" : void 0;
+					const blocked = controls.blocked();
 					deps.onDriverLoopSettled?.({
 						...summarizeDriverAttempts(loopRecords),
 						environmentReplacements,
 						workspaceRestores,
 						...closedBy === void 0 ? {} : { closedBy },
+						...blocked.length === 0 ? {} : { blocked },
 						...stopReason === void 0 ? {} : { stopReason },
 						continuations: keeper?.entries() ?? []
 					});
@@ -3727,6 +3729,7 @@ const superviseOptionKeySet = /* @__PURE__ */ new Set([
 	"peerMail",
 	"perWorker",
 	"reservationPolicy",
+	"deadlineCheckIn",
 	"profileGuidance",
 	"profileSecurity",
 	"registry",
@@ -3739,6 +3742,7 @@ const superviseOptionKeySet = /* @__PURE__ */ new Set([
 	"router",
 	"runDir",
 	"resume",
+	"segment",
 	"runContext",
 	"runId",
 	"signal",
@@ -4147,6 +4151,47 @@ function superviseRootProfile(profile, profileGuidance) {
 	const compose = profileGuidanceComposer(profileGuidance);
 	return freezeDetachedProfile(compose ? compose(parsedProfile.data) : parsedProfile.data);
 }
+/** What a root profile runs on, as a `root-segment` record names it. */
+function rootSegmentOf(profile) {
+	return {
+		...profile.model?.provider === void 0 ? {} : { provider: profile.model.provider },
+		...profile.model?.default === void 0 ? {} : { model: profile.model.default },
+		...profile.model?.reasoningEffort === void 0 ? {} : { reasoningEffort: profile.model.reasoningEffort },
+		...profile.harness === void 0 ? {} : { harness: profile.harness }
+	};
+}
+/** Refuse a segment that names nothing usable before any compute. */
+function admitSegment(segment) {
+	if (typeof segment !== "object" || segment === null) throw new ValidationError("supervise: segment must be an object");
+	for (const key of [
+		"provider",
+		"model",
+		"harness"
+	]) {
+		const value = segment[key];
+		if (value !== void 0 && (typeof value !== "string" || value.trim().length === 0)) throw new ValidationError(`supervise: segment.${key} must name a ${key}`);
+	}
+	if (typeof segment.reason !== "string" || segment.reason.trim().length === 0) throw new ValidationError("supervise: segment.reason must say why the segment starts");
+	if (segment.stack !== void 0) {
+		if (typeof segment.stack !== "object" || segment.stack === null || Array.isArray(segment.stack)) throw new ValidationError("supervise: segment.stack must map package names to versions");
+		for (const [name, version] of Object.entries(segment.stack)) if (typeof version !== "string" || version.length === 0) throw new ValidationError(`supervise: segment.stack.${name} must be a version string`);
+	}
+}
+/** The recorded root profile with only its provider, model, reasoning effort and harness replaced
+*  where the segment names them. */
+function withRootSegment(profile, segment) {
+	if (segment.provider === void 0 && segment.model === void 0 && segment.reasoningEffort === void 0 && segment.harness === void 0) return profile;
+	return superviseRootProfile({
+		...profile,
+		...segment.harness === void 0 ? {} : { harness: segment.harness },
+		model: {
+			...profile.model,
+			...segment.provider === void 0 ? {} : { provider: segment.provider },
+			...segment.model === void 0 ? {} : { default: segment.model },
+			...segment.reasoningEffort === void 0 ? {} : { reasoningEffort: segment.reasoningEffort }
+		}
+	}, void 0);
+}
 function superviseWithContext(profile, task, opts, brain) {
 	if (opts.runContext?.acquire === void 0) return superviseInternal(profile, task, opts, brain);
 	const options = captureSuperviseOptions(opts);
@@ -4166,7 +4211,9 @@ function superviseInternal(profile, task, opts, testBrain) {
 	}
 	assertValidBudget(options.budget, "supervise budget");
 	const composeSpawnProfile = profileGuidanceComposer(options.profileGuidance);
-	const canonicalProfile = superviseRootProfile(profile, options.profileGuidance);
+	const registeredProfile = superviseRootProfile(profile, options.profileGuidance);
+	if (options.segment !== void 0) admitSegment(options.segment);
+	const canonicalProfile = options.segment === void 0 ? registeredProfile : withRootSegment(registeredProfile, options.segment);
 	assertExecutableAgentProfile(canonicalProfile, "supervise root");
 	if (authoredSeatStages(canonicalProfile) !== void 0 && options.selectSeat === void 0) throw new ValidationError("supervise: AgentProfile.seats requires selectSeat before execution");
 	const canonicalTask = freezeDetached(task);
@@ -4185,7 +4232,7 @@ function superviseInternal(profile, task, opts, testBrain) {
 			})));
 		};
 	};
-	const rootExecution = canonicalExecution(canonicalProfile, canonicalTask, options.execution, "supervise root");
+	const rootExecution = canonicalExecution(registeredProfile, canonicalTask, options.execution, "supervise root");
 	const backendModel = options.backend?.model;
 	const driverBackendModel = options.driverBackend?.model;
 	assertProfileModelsAllowed(canonicalProfile, options.allowedModels);
@@ -4598,6 +4645,14 @@ function superviseInternal(profile, task, opts, testBrain) {
 			executors: ctx.executors,
 			...options.recoverExecutor ?? recoveryFactories.get(workerFactory) ? { recoverExecutor: options.recoverExecutor ?? recoveryFactories.get(workerFactory) } : {},
 			rootIdentity: rootExecution.identity,
+			...options.segment === void 0 ? {} : { rootSegment: {
+				registered: rootSegmentOf(registeredProfile),
+				current: {
+					...rootSegmentOf(canonicalProfile),
+					...options.segment.stack === void 0 ? {} : { stack: { ...options.segment.stack } }
+				},
+				reason: options.segment.reason
+			} },
 			...rootOwnerRuntime === void 0 ? {} : { rootMaterialization: {
 				runtime: rootOwnerRuntime,
 				declaration: "deferred",
@@ -4610,6 +4665,7 @@ function superviseInternal(profile, task, opts, testBrain) {
 			ownerWorkspaceRetention: managerBackend?.backend === "provider" && managerBackend.workspaceRetention !== void 0,
 			...options.workerSlots !== void 0 ? { workerSlots: options.workerSlots } : {},
 			...options.reservationPolicy ? { reservationPolicy: options.reservationPolicy } : {},
+			...options.deadlineCheckIn === void 0 ? {} : { deadlineCheckIn: options.deadlineCheckIn },
 			...ctx.resume === true || options.runDir === void 0 && options.resume === true ? { resume: true } : {},
 			...options.now ? { now: options.now } : {},
 			signal: options.signal ? AbortSignal.any([options.signal, durableCancellation.signal]) : durableCancellation.signal,
@@ -4688,4 +4744,4 @@ function rootProviderModelEvidenceFromExecution(evidence) {
 //#endregion
 export { readRootStreamReceipt as _, superviseWithTestBrain as a, createSupervisorSpanRecorder as b, resolveWorkerSpawnRetry as c, assertCoordinationBinding as d, resolveSupervisorProfile as f, readRootStream as g, ROOT_STREAM_FILE as h, superviseRootProfile as i, retryPreSpawnRefusals as l, supervisorAgentWithTestBrain as m, profileGuidanceComposer as n, workerFromBackend as o, supervisorAgent as p, supervise as r, isPreSpawnExecutorFailure as s, DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY as t, withWorkerSpawnRetry as u, UNPROVEN_CONTINUITY as v, serveCoordinationMcp as x, composeReentryTask as y };
 
-//# sourceMappingURL=supervise-B5iHXeuw.js.map
+//# sourceMappingURL=supervise-CGMzXi_j.js.map