@narumitw/pi-subagents 2.0.6 → 2.1.1

package/src/usage-recording.ts

@@ -0,0 +1,478 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { type ExtensionAPI, getAgentDir } from "@earendil-works/pi-coding-agent";
+import type { AgentTurnCompletion, ManagedAgent } from "./registry-types.js";
+import type { TransportUsage } from "./transport-types.js";
+import {
+	USAGE_RECORDING_DIRECTORY,
+	USAGE_RECORDING_RETENTION_DAYS,
+	USAGE_RECORDING_STUDY_ID,
+} from "./usage-recording-config.js";
+import type { UsageEventStorePort } from "./usage-recording-store.js";
+
+const SHUTDOWN_FLUSH_MS = 2_500;
+
+const SUBAGENT_TOOLS = new Set([
+	"subagent",
+	"subagent_spawn",
+	"subagent_send",
+	"subagent_manage",
+	"subagent_mailbox",
+	"subagent_inspect",
+	"subagent_consult",
+	"subagent_await",
+]);
+
+export type UsageSurfaceArm = "all" | "async-only" | "blocking-only" | "disabled";
+
+type UsageEventType =
+	| "study_exposure"
+	| "parent_turn_start"
+	| "parent_turn_end"
+	| "tool_start"
+	| "tool_end"
+	| "child_run_start"
+	| "child_run_end"
+	| "completion_transition"
+	| "lifecycle";
+
+interface UsageEvent {
+	schemaVersion: 1;
+	studyId: typeof USAGE_RECORDING_STUDY_ID;
+	surfaceArm: UsageSurfaceArm;
+	logicalSession: string;
+	runtimeInstance: string;
+	branchEpoch: number;
+	turnId?: string;
+	eventSequence: number;
+	monotonicOffsetMs: number;
+	eventType: UsageEventType;
+	data: Record<string, boolean | number | string>;
+}
+
+export interface UsageRecordingStatus {
+	enabled: boolean;
+	initialized: boolean;
+	retentionDays: number;
+	path: string;
+	recordedEvents: number;
+	writeFailure: boolean;
+}
+
+export interface UsageRecordingController {
+	startSession(input: {
+		enabled: boolean;
+		surfaceArm: UsageSurfaceArm;
+		reason: "startup" | "reload" | "new" | "resume" | "fork";
+		onWarning?: (message: string) => void;
+	}): Promise<void>;
+	shutdown(reason: "quit" | "reload" | "new" | "resume" | "fork"): Promise<void>;
+	setEnabled(value: boolean): Promise<void>;
+	getStatus(): UsageRecordingStatus;
+	observeAgents(agents: readonly ManagedAgent[]): void;
+	recordChildCompletion(completion: AgentTurnCompletion): void;
+	recordCompletionDeliveryAttempt(
+		completion: AgentTurnCompletion,
+		input: {
+			delivery: "steer" | "nextTurn";
+			triggerTurn: boolean;
+			outcome: "accepted" | "failed";
+		},
+	): void;
+	recordCompletionVisible(completion: AgentTurnCompletion): void;
+}
+
+export interface UsageRecordingDependencies {
+	createId(): string;
+	monotonicNow(): number;
+	getAgentDir(): string;
+	loadStore(): Promise<{
+		UsageEventStore: new (path: string) => UsageEventStorePort;
+	}>;
+}
+
+export function registerUsageRecording(
+	pi: ExtensionAPI,
+	dependencies: Partial<UsageRecordingDependencies> = {},
+): UsageRecordingController {
+	const deps: UsageRecordingDependencies = {
+		createId: dependencies.createId ?? randomUUID,
+		monotonicNow: dependencies.monotonicNow ?? performance.now.bind(performance),
+		getAgentDir: dependencies.getAgentDir ?? getAgentDir,
+		loadStore: dependencies.loadStore ?? (() => import("./usage-recording-store.js")),
+	};
+	const pathValue = path.join(deps.getAgentDir(), USAGE_RECORDING_DIRECTORY);
+	const runtimeInstance = deps.createId();
+	let logicalSession = deps.createId();
+	let branchEpoch = 0;
+	let surfaceArm: UsageSurfaceArm = "disabled";
+	let sessionStartedAt = deps.monotonicNow();
+	let enabled = false;
+	let eventSequence = 0;
+	let recordedEvents = 0;
+	let writeFailure = false;
+	let warningActive = false;
+	let onWarning: ((message: string) => void) | undefined;
+	let storePromise: Promise<UsageEventStorePort> | undefined;
+	let writeGeneration = 0;
+	let writeTail: Promise<void> = Promise.resolve();
+	let transitionTail: Promise<void> = Promise.resolve();
+	let currentTurnId: string | undefined;
+	let turnOrdinal = 0;
+	let operationOrdinal = 0;
+	let childOrdinal = 0;
+	let runOrdinal = 0;
+	let completionOrdinal = 0;
+	const operations = new Map<string, { id: string; startedAt: number }>();
+	const children = new Map<string, string>();
+	const runs = new Map<string, string>();
+	const completions = new Map<string, string>();
+	const agentStates = new Map<string, string>();
+	const activeRuns = new Map<string, string>();
+
+	pi.on("agent_start", () => record("lifecycle", { phase: "parent_agent_start" }));
+	pi.on("agent_settled", () => record("lifecycle", { phase: "parent_agent_settled" }));
+	pi.on("turn_start", () => {
+		currentTurnId = `turn-${++turnOrdinal}`;
+		record("parent_turn_start", { turnOrdinal }, currentTurnId);
+	});
+	pi.on("turn_end", (event) => {
+		record(
+			"parent_turn_end",
+			{
+				turnOrdinal,
+				...usageNumbers(event.message.role === "assistant" ? event.message.usage : undefined),
+			},
+			currentTurnId,
+		);
+		currentTurnId = undefined;
+	});
+	pi.on("tool_execution_start", (event) => {
+		if (!SUBAGENT_TOOLS.has(event.toolName)) return;
+		const operationId = `tool-${++operationOrdinal}`;
+		operations.set(event.toolCallId, { id: operationId, startedAt: offset() });
+		record("tool_start", { operationId, tool: event.toolName }, currentTurnId);
+	});
+	pi.on("tool_execution_end", (event) => {
+		if (!SUBAGENT_TOOLS.has(event.toolName)) return;
+		const operation = operations.get(event.toolCallId);
+		operations.delete(event.toolCallId);
+		record(
+			"tool_end",
+			{
+				operationId: operation?.id ?? `tool-${++operationOrdinal}`,
+				tool: event.toolName,
+				isError: event.isError,
+				...(operation ? { durationMs: Math.max(0, offset() - operation.startedAt) } : {}),
+				...usageNumbers(event.result?.usage),
+			},
+			currentTurnId,
+		);
+	});
+
+	const controller: UsageRecordingController = {
+		startSession(input) {
+			return serializeTransition(async () => {
+				enabled = false;
+				await closeStore();
+				logicalSession = deps.createId();
+				branchEpoch += 1;
+				surfaceArm = input.surfaceArm;
+				sessionStartedAt = deps.monotonicNow();
+				eventSequence = 0;
+				recordedEvents = 0;
+				writeFailure = false;
+				warningActive = false;
+				onWarning = input.onWarning;
+				currentTurnId = undefined;
+				turnOrdinal = 0;
+				operationOrdinal = 0;
+				childOrdinal = 0;
+				runOrdinal = 0;
+				completionOrdinal = 0;
+				operations.clear();
+				children.clear();
+				runs.clear();
+				completions.clear();
+				agentStates.clear();
+				activeRuns.clear();
+				enabled = input.enabled;
+				if (!enabled) return;
+				record("study_exposure", { reason: input.reason });
+				record("lifecycle", { phase: "session_start", reason: input.reason });
+				enqueue(async (store) => store.prune(USAGE_RECORDING_RETENTION_DAYS));
+				await writeTail;
+			});
+		},
+		shutdown(reason) {
+			return serializeTransition(async () => {
+				if (enabled) record("lifecycle", { phase: "session_shutdown", reason });
+				enabled = false;
+				await flushWithin(SHUTDOWN_FLUSH_MS);
+				await closeStore();
+			});
+		},
+		setEnabled(value) {
+			return serializeTransition(async () => {
+				if (value === enabled) return;
+				if (value) {
+					enabled = true;
+					record("study_exposure", { reason: "enabled_in_settings" });
+					record("lifecycle", { phase: "recording_enabled" });
+					enqueue(async (store) => store.prune(USAGE_RECORDING_RETENTION_DAYS));
+					await writeTail;
+					return;
+				}
+				record("lifecycle", { phase: "recording_disabled" });
+				enabled = false;
+				await flushWithin(SHUTDOWN_FLUSH_MS);
+				await closeStore();
+			});
+		},
+		getStatus() {
+			return {
+				enabled,
+				initialized: storePromise !== undefined,
+				retentionDays: USAGE_RECORDING_RETENTION_DAYS,
+				path: pathValue,
+				recordedEvents,
+				writeFailure,
+			};
+		},
+		observeAgents(agents) {
+			if (!enabled) return;
+			for (const agent of agents) {
+				const childId = localChildId(agent.id);
+				if (agentStates.get(agent.id) !== agent.state) {
+					agentStates.set(agent.id, agent.state);
+					record("lifecycle", { phase: "child_state", childId, state: agent.state });
+				}
+				if (agent.currentRunId && activeRuns.get(agent.id) !== agent.currentRunId) {
+					activeRuns.set(agent.id, agent.currentRunId);
+					record("child_run_start", {
+						childId,
+						runId: localRunId(agent.currentRunId),
+						generation: agent.currentTurnGeneration ?? agent.turnGeneration ?? 0,
+					});
+				}
+			}
+		},
+		recordChildCompletion(completion) {
+			if (!enabled) return;
+			const childId = localChildId(completion.agent.id);
+			const runId = localRunId(completion.runId);
+			const timing = completion.agent.telemetry?.timing;
+			record("child_run_end", {
+				childId,
+				runId,
+				generation: completion.generation,
+				state: completion.agent.state,
+				...(completion.agent.outcome?.status
+					? { outcomeStatus: completion.agent.outcome.status }
+					: {}),
+				...(completion.agent.termination?.reason
+					? { terminationReason: completion.agent.termination.reason }
+					: {}),
+				...(completion.agent.telemetry?.budgetSource
+					? {
+							timeoutBudgetSource: completion.agent.telemetry.budgetSource.timeout,
+							idleTimeoutBudgetSource: completion.agent.telemetry.budgetSource.idleTimeout,
+							turnLimitBudgetSource: completion.agent.telemetry.budgetSource.turnLimit,
+							toolCallLimitBudgetSource: completion.agent.telemetry.budgetSource.toolCallLimit,
+						}
+					: {}),
+				...(timing?.startedAt !== undefined && timing.settledAt !== undefined
+					? { durationMs: Math.max(0, timing.settledAt - timing.startedAt) }
+					: {}),
+				...transportUsageNumbers(completion.agent.telemetry?.usage),
+			});
+			recordCompletion(completion, "persisted");
+		},
+		recordCompletionDeliveryAttempt(completion, input) {
+			recordCompletion(completion, "delivery_attempt", {
+				delivery: input.delivery,
+				triggerTurn: input.triggerTurn,
+				outcome: input.outcome,
+			});
+		},
+		recordCompletionVisible(completion) {
+			recordCompletion(completion, "visible");
+		},
+	};
+
+	return controller;
+
+	function record(
+		eventType: UsageEventType,
+		data: UsageEvent["data"],
+		turnId = currentTurnId,
+	): void {
+		if (!enabled) return;
+		const event: UsageEvent = {
+			schemaVersion: 1,
+			studyId: USAGE_RECORDING_STUDY_ID,
+			surfaceArm,
+			logicalSession,
+			runtimeInstance,
+			branchEpoch,
+			...(turnId ? { turnId } : {}),
+			eventSequence: ++eventSequence,
+			monotonicOffsetMs: offset(),
+			eventType,
+			data,
+		};
+		enqueue(async (store) => store.append(event), true);
+	}
+
+	function recordCompletion(
+		completion: AgentTurnCompletion,
+		transition: "persisted" | "delivery_attempt" | "visible",
+		extra: UsageEvent["data"] = {},
+	): void {
+		if (!enabled) return;
+		record("completion_transition", {
+			completionId: localCompletionId(completion.completionId),
+			childId: localChildId(completion.agent.id),
+			runId: localRunId(completion.runId),
+			generation: completion.generation,
+			transition,
+			...extra,
+		});
+	}
+
+	function enqueue(
+		operation: (store: UsageEventStorePort) => Promise<void>,
+		countsAsEvent = false,
+	): void {
+		const generation = writeGeneration;
+		const task = writeTail.then(async () => {
+			if (generation !== writeGeneration) return false;
+			await operation(await ensureStore());
+			return true;
+		});
+		writeTail = task.then(
+			(completed) => {
+				if (completed && countsAsEvent) recordedEvents += 1;
+				writeFailure = false;
+				warningActive = false;
+			},
+			() => {
+				writeFailure = true;
+				if (!warningActive) {
+					warningActive = true;
+					safeWarn("Local subagent usage recording could not save an event; recording will retry.");
+				}
+			},
+		);
+	}
+
+	async function ensureStore(): Promise<UsageEventStorePort> {
+		storePromise ??= deps
+			.loadStore()
+			.then(({ UsageEventStore }) => new UsageEventStore(pathValue))
+			.catch((error: unknown) => {
+				storePromise = undefined;
+				throw error;
+			});
+		return storePromise;
+	}
+
+	function serializeTransition(operation: () => Promise<void>): Promise<void> {
+		const result = transitionTail.then(operation, operation);
+		transitionTail = result.catch(() => undefined);
+		return result;
+	}
+
+	async function flushWithin(timeoutMs: number): Promise<void> {
+		let timer: NodeJS.Timeout | undefined;
+		try {
+			await Promise.race([
+				writeTail,
+				new Promise<void>((resolve) => {
+					timer = setTimeout(resolve, timeoutMs);
+				}),
+			]);
+		} finally {
+			if (timer) clearTimeout(timer);
+		}
+	}
+
+	async function closeStore(): Promise<void> {
+		writeGeneration += 1;
+		const active = storePromise;
+		storePromise = undefined;
+		if (active) await active.then((store) => store.close()).catch(() => undefined);
+		await writeTail;
+		writeTail = Promise.resolve();
+	}
+
+	function localChildId(value: string): string {
+		return localId(children, value, "child", () => ++childOrdinal);
+	}
+
+	function localRunId(value: string): string {
+		return localId(runs, value, "run", () => ++runOrdinal);
+	}
+
+	function localCompletionId(value: string): string {
+		return localId(completions, value, "completion", () => ++completionOrdinal);
+	}
+
+	function offset(): number {
+		return Math.max(0, Math.round(deps.monotonicNow() - sessionStartedAt));
+	}
+
+	function safeWarn(message: string): void {
+		try {
+			onWarning?.(message);
+		} catch {
+			// A replaced UI cannot receive storage feedback.
+		}
+	}
+}
+
+function localId(
+	values: Map<string, string>,
+	raw: string,
+	prefix: string,
+	next: () => number,
+): string {
+	const existing = values.get(raw);
+	if (existing) return existing;
+	const created = `${prefix}-${next()}`;
+	values.set(raw, created);
+	return created;
+}
+
+function usageNumbers(value: unknown): Record<string, number> {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+	const record = value as Record<string, unknown>;
+	return numericFields(record, ["input", "output", "cacheRead", "cacheWrite"]);
+}
+
+function transportUsageNumbers(value: TransportUsage | undefined): Record<string, number> {
+	if (!value) return {};
+	return numericFields(value as unknown as Record<string, unknown>, [
+		"input",
+		"output",
+		"cacheRead",
+		"cacheWrite",
+		"totalTokens",
+		"cost",
+		"turns",
+	]);
+}
+
+function numericFields(
+	record: Record<string, unknown>,
+	fields: readonly string[],
+): Record<string, number> {
+	return Object.fromEntries(
+		fields.flatMap((field) => {
+			const value = record[field];
+			return typeof value === "number" && Number.isFinite(value) && value >= 0
+				? [[field, value] as const]
+				: [];
+		}),
+	);
+}

package/src/verification-harness.ts

@@ -6,7 +6,7 @@ import * as path from "node:path";
 import { promisify } from "node:util";
 import { redactPrivateText } from "./context.js";
 import { appendBounded, truncateUtf8 } from "./limits.js";
-import { terminateProcess } from "./runner.js";
+import { terminateProcess } from "./process-control.js";
 import type { VerificationCheckReceipt } from "./verification-receipt.js";
 import {
 	captureWorkflowTreeIdentity,

package/src/workflow-ui.ts

@@ -10,7 +10,7 @@ export async function showWorkflowPreview(
 ): Promise<boolean> {
 	const changes = workflowEffects(current, next);
 	return ctx.ui.confirm(
-		requiresReload ? "Save delegation change and reload?" : "Save delegation change?",
+		requiresReload ? "Save how subagents run and reload?" : "Save how subagents run?",
 		[
 			`Current: ${workflowLabel(current)}`,
 			`New: ${workflowLabel(next)}`,
@@ -28,13 +28,13 @@ export async function showWorkflowPreview(
 export function workflowLabel(value: DelegationWorkflow): string {
 	switch (value) {
 		case "all":
-			return "All delegation methods";
+			return "Background plus compatibility methods (async + sync)";
 		case "async-only":
-			return "Async only";
+			return "Keep Pi available (async)";
 		case "blocking-only":
-			return "Blocking only";
+			return "Compatibility blocking methods (sync)";
 		case "disabled":
-			return "Delegation disabled";
+			return "Subagents disabled";
 	}
 }
 
@@ -42,19 +42,27 @@ function workflowEffects(current: DelegationWorkflow, next: DelegationWorkflow):
 	const blockingEnabled = (value: DelegationWorkflow) =>
 		value === "all" || value === "blocking-only";
 	const asyncEnabled = (value: DelegationWorkflow) => value === "all" || value === "async-only";
+	const awaitEnabled = (value: DelegationWorkflow) => blockingEnabled(value) && asyncEnabled(value);
 	const effects: string[] = [];
 	if (blockingEnabled(current) !== blockingEnabled(next)) {
 		effects.push(
 			blockingEnabled(next)
-				? "Add blocking `subagent` and read-only `subagent_consult`"
-				: "Remove blocking `subagent` and read-only `subagent_consult`",
+				? "Allow deprecated blocking `subagent` and supported read-only `subagent_consult`"
+				: "Remove deprecated blocking `subagent` and supported read-only `subagent_consult`",
 		);
 	}
 	if (asyncEnabled(current) !== asyncEnabled(next)) {
 		effects.push(
 			asyncEnabled(next)
-				? "Add async `subagent_spawn`, `subagent_send`, `subagent_manage`, and `subagent_mailbox`"
-				: "Remove async `subagent_spawn`, `subagent_send`, `subagent_manage`, and `subagent_mailbox`",
+				? "Allow background tools: `subagent_spawn`, `subagent_send`, `subagent_manage`, and `subagent_mailbox`"
+				: "Remove background tools: `subagent_spawn`, `subagent_send`, `subagent_manage`, and `subagent_mailbox`",
+		);
+	}
+	if (awaitEnabled(current) !== awaitEnabled(next)) {
+		effects.push(
+			awaitEnabled(next)
+				? "Allow the blocking retained-agent join: `subagent_await`"
+				: "Remove the blocking retained-agent join: `subagent_await`",
 		);
 	}
 	return effects;

package/dist/chunks/chunk-434NII74.ts.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/completion-delivery.ts"],
-  "sourcesContent": ["import type { ExtensionAPI, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport type { CompletionDelivery } from \"./agents/types.js\";\nimport { SUBAGENT_COMPLETION_MESSAGE_TYPE } from \"./completion-render.js\";\nimport { redactPrivateText } from \"./context.js\";\nimport { DEFAULT_MAX_CONTEXT_BYTES, MAX_TOOL_MESSAGE_BYTES, truncateUtf8 } from \"./limits.js\";\nimport type { AgentTurnCompletion, ManagedAgent } from \"./registry.js\";\nimport { safeTerminalText } from \"./safe-text.js\";\nimport { PI_SUBAGENTS_RPC_PROTOCOL } from \"./transport-types.js\";\n\nconst MAX_COMPLETION_ERROR_BYTES = 512;\nconst MAX_COMPLETIONS_PER_MESSAGE = 16;\nconst COMPLETION_BATCH_DELAY_MS = 10;\n\ninterface CompletionMetadata {\n\tprotocol: typeof PI_SUBAGENTS_RPC_PROTOCOL;\n\tcompletionId: string;\n\trunId: string;\n\tgeneration: number;\n\tagentId: string;\n\ttaskPath?: string;\n\trecipientPath?: string;\n\tagent: string;\n\ttask: string;\n\tstate: string;\n\ttransport?: string;\n\tstructuredResult?: ManagedAgent[\"structuredResult\"];\n\toutcome?: ManagedAgent[\"outcome\"];\n\tcapabilityGrant?: ManagedAgent[\"capabilityGrant\"];\n}\n\ninterface CompletionMessage {\n\tcustomType: typeof SUBAGENT_COMPLETION_MESSAGE_TYPE;\n\tcontent: string;\n\tdisplay: true;\n\tdetails:\n\t\t| CompletionMetadata\n\t\t| {\n\t\t\t\tcompletionCount: number;\n\t\t\t\tcompletions: CompletionMetadata[];\n\t\t  };\n}\n\ntype CompletionContext = Pick<ExtensionContext, \"hasPendingMessages\" | \"isIdle\">;\ntype CompletionPi = Pick<ExtensionAPI, \"sendMessage\">;\n\nexport interface CompletionDeliveryBrokerOptions {\n\tonDeliveryError?: (error: unknown) => void;\n\tonAcknowledged?: (completions: readonly AgentTurnCompletion[], acknowledgedAt: number) => void;\n\tnow?: () => number;\n}\n\n/** Owns bounded completion batching and at most one idle-root wake for one parent session. */\nexport class CompletionDeliveryBroker {\n\tprivate pending: AgentTurnCompletion[] = [];\n\tprivate readonly knownCompletionIds = new Set<string>();\n\tprivate awaitingParentAck: AgentTurnCompletion[] = [];\n\tprivate flushTimer?: NodeJS.Timeout;\n\tprivate wakeInFlight = false;\n\tprivate closed = false;\n\n\tconstructor(\n\t\tprivate readonly pi: CompletionPi,\n\t\tprivate readonly ctx: CompletionContext,\n\t\tprivate delivery: CompletionDelivery,\n\t\tprivate readonly options: CompletionDeliveryBrokerOptions = {},\n\t) {}\n\n\tenqueue(completion: AgentTurnCompletion): void {\n\t\tif (this.closed || this.knownCompletionIds.has(completion.completionId)) return;\n\t\tthis.knownCompletionIds.add(completion.completionId);\n\t\tthis.pending.push(completion);\n\t\tthis.scheduleFlush();\n\t}\n\n\tsetDelivery(value: CompletionDelivery): void {\n\t\tthis.delivery = value;\n\t\tthis.scheduleFlush();\n\t}\n\n\tonParentTurnStart(): void {\n\t\tthis.wakeInFlight = false;\n\t\tthis.scheduleFlush();\n\t}\n\n\tonParentContext(messages: readonly unknown[]): void {\n\t\tthis.acknowledgeVisible(completionIdsFromContext(messages));\n\t\tif (this.awaitingParentAck.length > 0) {\n\t\t\tthis.pending = [...this.awaitingParentAck.splice(0), ...this.pending];\n\t\t}\n\t\tthis.scheduleFlush();\n\t}\n\n\tonParentSettled(): void {\n\t\tthis.wakeInFlight = false;\n\t\tthis.scheduleFlush();\n\t}\n\n\tflush(): void {\n\t\tif (this.closed || this.pending.length === 0) return;\n\t\tif (this.flushTimer) clearTimeout(this.flushTimer);\n\t\tthis.flushTimer = undefined;\n\t\tif (this.delivery === \"auto-resume\" && !this.isRootIdle()) return;\n\n\t\tconst completions = this.pending.splice(0);\n\t\tconst batches = chunkCompletions(completions);\n\t\tlet canWake = this.shouldWakeRoot();\n\t\tfor (let index = 0; index < batches.length; index++) {\n\t\t\tconst triggerTurn = canWake && index === batches.length - 1;\n\t\t\tconst batch = batches[index];\n\t\t\tconst message = buildCompletionMessage(batch);\n\t\t\tif (triggerTurn) this.wakeInFlight = true;\n\t\t\tthis.awaitingParentAck.push(...batch);\n\t\t\ttry {\n\t\t\t\t// Pi treats explicit false as immediate insertion instead of queued steering while streaming.\n\t\t\t\tthis.pi.sendMessage(message, {\n\t\t\t\t\tdeliverAs: \"steer\",\n\t\t\t\t\t...(triggerTurn ? { triggerTurn: true } : {}),\n\t\t\t\t});\n\t\t\t} catch (primaryError) {\n\t\t\t\tthis.removeAwaiting(batch);\n\t\t\t\tif (triggerTurn) this.wakeInFlight = false;\n\t\t\t\tcanWake = false;\n\t\t\t\tthis.awaitingParentAck.push(...batch);\n\t\t\t\ttry {\n\t\t\t\t\tthis.pi.sendMessage(message, { deliverAs: \"nextTurn\", triggerTurn: false });\n\t\t\t\t} catch (fallbackError) {\n\t\t\t\t\tthis.removeAwaiting(batch);\n\t\t\t\t\tthis.pending = [...batches.slice(index).flat(), ...this.pending];\n\t\t\t\t\ttry {\n\t\t\t\t\t\tthis.options.onDeliveryError?.(\n\t\t\t\t\t\t\tnew AggregateError(\n\t\t\t\t\t\t\t\t[primaryError, fallbackError],\n\t\t\t\t\t\t\t\t\"Detached subagent completion delivery failed\",\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Delivery retention must survive a failing observer.\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tthis.closed = true;\n\t\tif (this.flushTimer) clearTimeout(this.flushTimer);\n\t\tthis.flushTimer = undefined;\n\t\tthis.pending = [];\n\t\tthis.awaitingParentAck = [];\n\t\tthis.knownCompletionIds.clear();\n\t}\n\n\tprivate scheduleFlush(): void {\n\t\tif (this.closed || this.pending.length === 0 || this.flushTimer) return;\n\t\tthis.flushTimer = setTimeout(() => {\n\t\t\tthis.flushTimer = undefined;\n\t\t\tthis.flush();\n\t\t}, COMPLETION_BATCH_DELAY_MS);\n\t}\n\n\tprivate acknowledgeVisible(visibleIds: ReadonlySet<string>): void {\n\t\tif (visibleIds.size === 0) return;\n\t\tconst completions = [...this.awaitingParentAck, ...this.pending].filter((completion) =>\n\t\t\tvisibleIds.has(completion.completionId),\n\t\t);\n\t\tif (completions.length === 0) return;\n\t\tconst acknowledgedIds = new Set(completions.map((completion) => completion.completionId));\n\t\tthis.awaitingParentAck = this.awaitingParentAck.filter(\n\t\t\t(completion) => !acknowledgedIds.has(completion.completionId),\n\t\t);\n\t\tthis.pending = this.pending.filter(\n\t\t\t(completion) => !acknowledgedIds.has(completion.completionId),\n\t\t);\n\t\tfor (const completion of completions) this.knownCompletionIds.delete(completion.completionId);\n\t\ttry {\n\t\t\tthis.options.onAcknowledged?.(completions, (this.options.now ?? Date.now)());\n\t\t} catch {\n\t\t\t// Context assembly already observed the message, so observer failures cannot retract it.\n\t\t}\n\t}\n\n\tprivate removeAwaiting(completions: readonly AgentTurnCompletion[]): void {\n\t\tconst removed = new Set(completions.map((completion) => completion.completionId));\n\t\tthis.awaitingParentAck = this.awaitingParentAck.filter(\n\t\t\t(completion) => !removed.has(completion.completionId),\n\t\t);\n\t}\n\n\tprivate isRootIdle(): boolean {\n\t\ttry {\n\t\t\treturn this.ctx.isIdle();\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprivate shouldWakeRoot(): boolean {\n\t\tif (this.delivery !== \"auto-resume\" || this.wakeInFlight) return false;\n\t\ttry {\n\t\t\treturn !this.ctx.hasPendingMessages();\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n}\n\nfunction completionIdsFromContext(messages: readonly unknown[]): Set<string> {\n\tconst ids = new Set<string>();\n\tfor (const message of messages) {\n\t\tif (!message || typeof message !== \"object\" || Array.isArray(message)) continue;\n\t\tconst record = message as Record<string, unknown>;\n\t\tif (record.role !== \"custom\" || record.customType !== SUBAGENT_COMPLETION_MESSAGE_TYPE)\n\t\t\tcontinue;\n\t\tconst details = record.details;\n\t\tif (!details || typeof details !== \"object\" || Array.isArray(details)) continue;\n\t\tconst metadata = details as Record<string, unknown>;\n\t\tif (\n\t\t\tmetadata.protocol === PI_SUBAGENTS_RPC_PROTOCOL &&\n\t\t\ttypeof metadata.completionId === \"string\"\n\t\t) {\n\t\t\tids.add(metadata.completionId);\n\t\t}\n\t\tif (!Array.isArray(metadata.completions)) continue;\n\t\tfor (const completion of metadata.completions) {\n\t\t\tif (!completion || typeof completion !== \"object\" || Array.isArray(completion)) continue;\n\t\t\tconst item = completion as Record<string, unknown>;\n\t\t\tif (item.protocol === PI_SUBAGENTS_RPC_PROTOCOL && typeof item.completionId === \"string\") {\n\t\t\t\tids.add(item.completionId);\n\t\t\t}\n\t\t}\n\t}\n\treturn ids;\n}\n\nfunction chunkCompletions(completions: AgentTurnCompletion[]): AgentTurnCompletion[][] {\n\tconst batches: AgentTurnCompletion[][] = [];\n\tfor (let index = 0; index < completions.length; index += MAX_COMPLETIONS_PER_MESSAGE) {\n\t\tbatches.push(completions.slice(index, index + MAX_COMPLETIONS_PER_MESSAGE));\n\t}\n\treturn batches;\n}\n\nfunction buildCompletionMessage(completions: AgentTurnCompletion[]): CompletionMessage {\n\tif (completions.length === 1) {\n\t\tconst completion = completions[0];\n\t\treturn {\n\t\t\tcustomType: SUBAGENT_COMPLETION_MESSAGE_TYPE,\n\t\t\tcontent: buildDetachedCompletionMessage(completion),\n\t\t\tdisplay: true,\n\t\t\tdetails: completionMetadata(completion),\n\t\t};\n\t}\n\tconst content = truncateUtf8(\n\t\t[\n\t\t\t\"Message Type: SUBAGENT_COMPLETION_BATCH\",\n\t\t\t`Protocol: ${PI_SUBAGENTS_RPC_PROTOCOL}`,\n\t\t\t`Completion Count: ${completions.length}`,\n\t\t\t...completions.flatMap((completion, index) => [\n\t\t\t\t\"\",\n\t\t\t\t`--- Completion ${index + 1} of ${completions.length} ---`,\n\t\t\t\tbuildDetachedCompletionMessage(completion),\n\t\t\t]),\n\t\t].join(\"\\n\"),\n\t\tDEFAULT_MAX_CONTEXT_BYTES,\n\t).text;\n\treturn {\n\t\tcustomType: SUBAGENT_COMPLETION_MESSAGE_TYPE,\n\t\tcontent,\n\t\tdisplay: true,\n\t\tdetails: {\n\t\t\tcompletionCount: completions.length,\n\t\t\tcompletions: completions.map(completionMetadata),\n\t\t},\n\t};\n}\n\nfunction completionMetadata(completion: AgentTurnCompletion): CompletionMetadata {\n\treturn {\n\t\tprotocol: PI_SUBAGENTS_RPC_PROTOCOL,\n\t\tcompletionId: completion.completionId,\n\t\trunId: completion.runId,\n\t\tgeneration: completion.generation,\n\t\tagentId: completion.agent.id,\n\t\t...(completion.agent.taskPath ? { taskPath: completion.agent.taskPath } : {}),\n\t\t...(completion.recipientPath ? { recipientPath: completion.recipientPath } : {}),\n\t\tagent: completion.agent.agent,\n\t\ttask: sanitizeCompletionLine(completion.task, 256) || \"(unknown task)\",\n\t\tstate: completion.agent.state,\n\t\t...(completion.agent.telemetry?.transport\n\t\t\t? { transport: completion.agent.telemetry.transport }\n\t\t\t: {}),\n\t\t...(completion.agent.structuredResult\n\t\t\t? { structuredResult: completion.agent.structuredResult }\n\t\t\t: {}),\n\t\t...(completion.agent.outcome ? { outcome: completion.agent.outcome } : {}),\n\t\t...(completion.agent.capabilityGrant\n\t\t\t? { capabilityGrant: completion.agent.capabilityGrant }\n\t\t\t: {}),\n\t};\n}\n\nexport function buildDetachedCompletionMessage(completion: AgentTurnCompletion): string {\n\tconst task = sanitizeCompletionLine(completion.task, 256) || \"(unknown task)\";\n\tconst agentName = sanitizeCompletionLine(completion.agent.agent, 128) || \"(unknown agent)\";\n\tconst output = safeTerminalText(redactPrivateText(completion.output));\n\tconst error = completion.error\n\t\t? truncateUtf8(\n\t\t\t\tsafeTerminalText(redactPrivateText(completion.error)),\n\t\t\t\tMAX_COMPLETION_ERROR_BYTES,\n\t\t\t).text\n\t\t: \"\";\n\treturn truncateUtf8(\n\t\t[\n\t\t\t\"Message Type: SUBAGENT_COMPLETION\",\n\t\t\t`Protocol: ${PI_SUBAGENTS_RPC_PROTOCOL}`,\n\t\t\t`Completion ID: ${completion.completionId}`,\n\t\t\t`Run ID: ${completion.runId}`,\n\t\t\t`Generation: ${completion.generation}`,\n\t\t\t`Agent ID: ${completion.agent.id}`,\n\t\t\t...(completion.agent.taskPath ? [`Agent Path: ${completion.agent.taskPath}`] : []),\n\t\t\t...(completion.recipientPath ? [`Recipient Path: ${completion.recipientPath}`] : []),\n\t\t\t`Agent: ${agentName}`,\n\t\t\t`Task: ${task}`,\n\t\t\t`State: ${completion.agent.state}`,\n\t\t\t...(error.trim() ? [\"Error:\", error] : []),\n\t\t\t\"Payload:\",\n\t\t\toutput.trim() ? output : \"(no output)\",\n\t\t].join(\"\\n\"),\n\t\tMAX_TOOL_MESSAGE_BYTES,\n\t).text;\n}\n\nfunction sanitizeCompletionLine(value: string, maxBytes: number): string {\n\treturn (\n\t\ttruncateUtf8(redactPrivateText(value), maxBytes)\n\t\t\t// biome-ignore lint/suspicious/noControlCharactersInRegex: Strip untrusted terminal controls.\n\t\t\t.text.replace(/[\\u0000-\\u001f\\u007f]+/g, \" \")\n\t\t\t.replace(/\\s+/g, \" \")\n\t\t\t.trim()\n\t);\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/chunks/chunk-7OBINKFM.ts.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/stateful-limits.ts"],
-  "sourcesContent": ["import type { SubagentRuntimeSettings } from \"./agents/types.js\";\n\nexport const STATEFUL_LIMIT_FIELDS = [\n\t\"maxAgents\",\n\t\"maxActiveTurns\",\n\t\"maxChildrenPerAgent\",\n\t\"maxDepth\",\n\t\"maxStoredAgents\",\n] as const;\n\nexport type StatefulLimitField = (typeof STATEFUL_LIMIT_FIELDS)[number];\n\nexport interface StatefulLimits {\n\tmaxAgents: number;\n\tmaxActiveTurns: number;\n\tmaxChildrenPerAgent: number;\n\tmaxDepth: number;\n\tmaxStoredAgents: number;\n}\n\nexport interface StatefulLimitDefinition {\n\tfield: StatefulLimitField;\n\tlabel: string;\n\tdescription: string;\n\tdefaultValue: number;\n\tminimum: number;\n}\n\nexport const STATEFUL_LIMIT_DEFINITIONS: readonly StatefulLimitDefinition[] = [\n\t{\n\t\tfield: \"maxAgents\",\n\t\tlabel: \"Retained agents\",\n\t\tdescription: \"Running, queued, and reusable idle detached agents\",\n\t\tdefaultValue: 16,\n\t\tminimum: 1,\n\t},\n\t{\n\t\tfield: \"maxActiveTurns\",\n\t\tlabel: \"Active turns\",\n\t\tdescription: \"Detached agent turns that may run at the same time\",\n\t\tdefaultValue: 4,\n\t\tminimum: 1,\n\t},\n\t{\n\t\tfield: \"maxChildrenPerAgent\",\n\t\tlabel: \"Children per agent\",\n\t\tdescription: \"Direct child agents retained beneath one parent\",\n\t\tdefaultValue: 8,\n\t\tminimum: 1,\n\t},\n\t{\n\t\tfield: \"maxDepth\",\n\t\tlabel: \"Agent tree depth\",\n\t\tdescription: \"Nested child levels below a root agent\",\n\t\tdefaultValue: 3,\n\t\tminimum: 0,\n\t},\n\t{\n\t\tfield: \"maxStoredAgents\",\n\t\tlabel: \"Stored agents\",\n\t\tdescription: \"Detached agent records kept per session on disk\",\n\t\tdefaultValue: 50,\n\t\tminimum: 1,\n\t},\n];\n\nconst definitionsByField = new Map(\n\tSTATEFUL_LIMIT_DEFINITIONS.map((definition) => [definition.field, definition]),\n);\n\nexport function statefulLimitDefinition(field: StatefulLimitField): StatefulLimitDefinition {\n\tconst definition = definitionsByField.get(field);\n\tif (!definition) throw new Error(`Unknown stateful limit: ${field}`);\n\treturn definition;\n}\n\nexport function isStatefulLimitField(value: string): value is StatefulLimitField {\n\treturn (STATEFUL_LIMIT_FIELDS as readonly string[]).includes(value);\n}\n\nexport function isValidStatefulLimit(field: StatefulLimitField, value: unknown): value is number {\n\treturn (\n\t\ttypeof value === \"number\" &&\n\t\tNumber.isSafeInteger(value) &&\n\t\tvalue >= statefulLimitDefinition(field).minimum\n\t);\n}\n\nexport function resolveStatefulLimits(settings?: SubagentRuntimeSettings): StatefulLimits {\n\treturn Object.fromEntries(\n\t\tSTATEFUL_LIMIT_DEFINITIONS.map((definition) => [\n\t\t\tdefinition.field,\n\t\t\tsettings?.[definition.field] ?? definition.defaultValue,\n\t\t]),\n\t) as unknown as StatefulLimits;\n}\n"],
-  "mappings": ";;;;AAEO,IAAM,wBAAwB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD;AAoBO,IAAM,6BAAiE;AAAA,EAC7E;AAAA,IACC,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,SAAS;AAAA,EACV;AAAA,EACA;AAAA,IACC,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,SAAS;AAAA,EACV;AAAA,EACA;AAAA,IACC,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,SAAS;AAAA,EACV;AAAA,EACA;AAAA,IACC,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,SAAS;AAAA,EACV;AAAA,EACA;AAAA,IACC,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,SAAS;AAAA,EACV;AACD;AAEA,IAAM,qBAAqB,IAAI;AAAA,EAC9B,2BAA2B,IAAI,CAAC,eAAe,CAAC,WAAW,OAAO,UAAU,CAAC;AAC9E;AAEO,SAAS,wBAAwB,OAAoD;AAC3F,QAAM,aAAa,mBAAmB,IAAI,KAAK;AAC/C,MAAI,CAAC,WAAY,OAAM,IAAI,MAAM,2BAA2B,KAAK,EAAE;AACnE,SAAO;AACR;AAEO,SAAS,qBAAqB,OAA4C;AAChF,SAAQ,sBAA4C,SAAS,KAAK;AACnE;AAEO,SAAS,qBAAqB,OAA2B,OAAiC;AAChG,SACC,OAAO,UAAU,YACjB,OAAO,cAAc,KAAK,KAC1B,SAAS,wBAAwB,KAAK,EAAE;AAE1C;AAEO,SAAS,sBAAsB,UAAoD;AACzF,SAAO,OAAO;AAAA,IACb,2BAA2B,IAAI,CAAC,eAAe;AAAA,MAC9C,WAAW;AAAA,MACX,WAAW,WAAW,KAAK,KAAK,WAAW;AAAA,IAC5C,CAAC;AAAA,EACF;AACD;",
-  "names": []
-}

package/dist/chunks/chunk-7QPPBBXZ.ts.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/settings.ts"],
-  "sourcesContent": ["import { randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport * as path from \"node:path\";\nimport { getAgentDir } from \"@earendil-works/pi-coding-agent\";\nimport type {\n\tAgentConfig,\n\tCompletionDelivery,\n\tConsultationCwdPolicy,\n\tConsultResourcePolicy,\n\tDelegationCwdPolicy,\n\tSubagentAgentConfig,\n\tSubagentSettings,\n\tSubagentThinkingLevel,\n\tSubagentTransportKind,\n} from \"./agents/types.js\";\nimport { MAX_CONFIGURABLE_PARALLEL_TASKS } from \"./limits.js\";\nimport type { DelegationWorkflow } from \"./settings/inspection.js\";\nimport {\n\thasOwn,\n\tisPlainObject,\n\tisPositiveInteger,\n\tnormalizeSubagentSettings,\n} from \"./settings/schema.js\";\nimport {\n\tpathEntryExists,\n\tresolveSubagentSettingsPaths,\n\tSUBAGENT_SETTINGS_FILE,\n} from \"./settings-reader.js\";\nimport {\n\tisValidStatefulLimit,\n\tresolveStatefulLimits,\n\tSTATEFUL_LIMIT_FIELDS,\n\ttype StatefulLimitField,\n\ttype StatefulLimits,\n\tstatefulLimitDefinition,\n} from \"./stateful-limits.js\";\n\nexport {\n\ttype BlockingParallelLimitSettingsSnapshot,\n\ttype CompletionDeliverySettingsSnapshot,\n\ttype ConsultResourceSettingsSnapshot,\n\ttype CwdPolicyFieldSnapshot,\n\ttype CwdPolicySettingsSnapshot,\n\tconsumeSubagentSettingsNotice,\n\tDEFAULT_CONSULT_RESOURCE_POLICY,\n\tDEFAULT_CONSULTATION_CWD_POLICY,\n\tDEFAULT_DELEGATION_CWD_POLICY,\n\ttype DelegationWorkflow,\n\ttype DelegationWorkflowSettingsSnapshot,\n\thasOwn,\n\tinspectBlockingParallelLimitSettings,\n\tinspectCompletionDeliverySettings,\n\tinspectConsultResourceSettings,\n\tinspectCwdPolicySettings,\n\tinspectDelegationWorkflowSettings,\n\tinspectStatefulLimitSettings,\n\tinspectStatefulTransportSettings,\n\tinspectSubagentSettings,\n\tnormalizeAgentSettings,\n\tnormalizeSubagentSettings,\n\treadSubagentSettings,\n\tresolveBlockingMaxParallelTasks,\n\tresolveDelegationWorkflow,\n\ttype StatefulLimitFieldSnapshot,\n\ttype StatefulLimitSettingsSnapshot,\n\ttype StatefulTransportSettingsSnapshot,\n\ttype SubagentSettingsSnapshot,\n\tsubagentSettingsFilePath,\n} from \"./settings-reader.js\";\n\nconst SETTINGS_FILE = SUBAGENT_SETTINGS_FILE;\nconst require = createRequire(import.meta.url);\n\nconst SETTINGS_LOCK_FS_ADAPTER = {\n\tmkdir: fs.mkdir,\n\tmkdirSync: fs.mkdirSync,\n\trealpath: fs.realpath,\n\trealpathSync: fs.realpathSync,\n\trmdir: fs.rmdir,\n\trmdirSync: fs.rmdirSync,\n\tstat: fs.stat,\n\tstatSync: fs.statSync,\n\tutimes: fs.utimes,\n\tutimesSync: fs.utimesSync,\n};\n\nexport function saveSubagentConfig(settings: SubagentSettings): void {\n\twriteSettingsObject(settings);\n}\n\nexport function updateDelegationWorkflowSetting(\n\tvalue: Exclude<DelegationWorkflow, \"disabled\">,\n): void {\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst blocking = raw.blocking;\n\t\tif (blocking !== undefined && !isPlainObject(blocking)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} blocking settings`);\n\t\t}\n\t\tconst stateful = raw.stateful;\n\t\tif (stateful !== undefined && !isPlainObject(stateful)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} stateful settings`);\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tblocking: {\n\t\t\t\t\t...(blocking ?? {}),\n\t\t\t\t\tenabled: value !== \"async-only\",\n\t\t\t\t},\n\t\t\t\tstateful: {\n\t\t\t\t\t...(stateful ?? {}),\n\t\t\t\t\tenabled: value !== \"blocking-only\",\n\t\t\t\t},\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport function updateStatefulTransportSetting(value: SubagentTransportKind): void {\n\tif (![\"subprocess\", \"in-process\", \"rpc\", \"auto\"].includes(value)) {\n\t\tthrow new Error(`Unsupported stateful transport: ${value}`);\n\t}\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst stateful = raw.stateful;\n\t\tif (stateful !== undefined && !isPlainObject(stateful)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} stateful settings`);\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tstateful: { ...(stateful ?? {}), transport: value },\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport function updateCompletionDeliverySetting(value: CompletionDelivery): void {\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst stateful = raw.stateful;\n\t\tif (stateful !== undefined && !isPlainObject(stateful)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} stateful settings`);\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tstateful: {\n\t\t\t\t\t...(stateful ?? {}),\n\t\t\t\t\tcompletionDelivery: value,\n\t\t\t\t},\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport function updateBlockingMaxParallelTasksSetting(value: number): void {\n\tif (!isPositiveInteger(value) || value > MAX_CONFIGURABLE_PARALLEL_TASKS) {\n\t\tthrow new Error(\n\t\t\t`Maximum parallel tasks must be an integer between 1 and ${MAX_CONFIGURABLE_PARALLEL_TASKS}`,\n\t\t);\n\t}\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst blocking = raw.blocking;\n\t\tif (blocking !== undefined && !isPlainObject(blocking)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} blocking settings`);\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tblocking: {\n\t\t\t\t\t...(blocking ?? {}),\n\t\t\t\t\tmaxParallelTasks: value,\n\t\t\t\t},\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport function updateStatefulLimitSetting(\n\tfield: StatefulLimitField,\n\tvalue: number,\n\texpected?: StatefulLimits,\n): void {\n\tif (!isValidStatefulLimit(field, value)) {\n\t\tthrow new Error(\n\t\t\t`${field} must be a safe integer greater than or equal to ${statefulLimitDefinition(field).minimum}`,\n\t\t);\n\t}\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst stateful = raw.stateful;\n\t\tif (stateful !== undefined && !isPlainObject(stateful)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} stateful settings`);\n\t\t}\n\t\tconst normalized = normalizeSubagentSettings(raw);\n\t\tif (!normalized) throw new Error(`Cannot update invalid ${SETTINGS_FILE}`);\n\t\tif (expected && !sameStatefulLimits(resolveStatefulLimits(normalized.stateful), expected)) {\n\t\t\tthrow new Error(\"Detached limit settings changed; reopen settings and retry\");\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tstateful: { ...(stateful ?? {}), [field]: value },\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport function updateConsultResourceSetting(value: ConsultResourcePolicy): void {\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst consult = raw.consult;\n\t\tif (consult !== undefined && !isPlainObject(consult)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} consult settings`);\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tconsult: {\n\t\t\t\t\t...(consult ?? {}),\n\t\t\t\t\tresources: value,\n\t\t\t\t},\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport function updateCwdPolicySetting(field: \"consultation\", value: ConsultationCwdPolicy): void;\nexport function updateCwdPolicySetting(field: \"delegation\", value: DelegationCwdPolicy): void;\nexport function updateCwdPolicySetting(\n\tfield: \"consultation\" | \"delegation\",\n\tvalue: ConsultationCwdPolicy | DelegationCwdPolicy,\n): void {\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst cwdPolicy = raw.cwdPolicy;\n\t\tif (cwdPolicy !== undefined && !isPlainObject(cwdPolicy)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} cwdPolicy settings`);\n\t\t}\n\t\twriteSettingsObjectUnlocked(\n\t\t\t{\n\t\t\t\t...raw,\n\t\t\t\tcwdPolicy: { ...(cwdPolicy ?? {}), [field]: value },\n\t\t\t},\n\t\t\tupdate.replaceCanonical,\n\t\t);\n\t});\n}\n\nexport type AgentSettingsPatch = {\n\ttools?: string[] | undefined;\n\tmodel?: string | null | undefined;\n\tthinkingLevel?: SubagentThinkingLevel | null | undefined;\n\ttimeoutMs?: number | null | undefined;\n};\n\nexport function updateAgentToolsSetting(name: string, tools: string[] | undefined): void {\n\tupdateAgentSettingsPatch({ [name]: { tools } });\n}\n\nexport function updateAgentSettingsPatch(patches: Record<string, AgentSettingsPatch>): void {\n\twithSettingsMutationLock(() => {\n\t\tconst update = readSettingsObjectForUpdate();\n\t\tconst raw = update.document;\n\t\tconst rawAgents = raw.agents;\n\t\tif (rawAgents !== undefined && !isPlainObject(rawAgents)) {\n\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} agent settings`);\n\t\t}\n\t\tconst agents = { ...(rawAgents ?? {}) };\n\t\tfor (const [name, patch] of Object.entries(patches)) {\n\t\t\tconst rawAgent = hasOwn(agents, name) ? agents[name] : undefined;\n\t\t\tif (rawAgent !== undefined && !isPlainObject(rawAgent)) {\n\t\t\t\tthrow new Error(`Cannot update invalid ${SETTINGS_FILE} settings for ${name}`);\n\t\t\t}\n\t\t\tconst agent = { ...(rawAgent ?? {}) };\n\t\t\tfor (const field of [\"tools\", \"model\", \"thinkingLevel\", \"timeoutMs\"] as const) {\n\t\t\t\tif (!hasOwn(patch, field)) continue;\n\t\t\t\tconst value = patch[field];\n\t\t\t\tif (value === undefined) delete agent[field];\n\t\t\t\telse\n\t\t\t\t\tObject.defineProperty(agent, field, {\n\t\t\t\t\t\tvalue,\n\t\t\t\t\t\tenumerable: true,\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\twritable: true,\n\t\t\t\t\t});\n\t\t\t}\n\t\t\tif (Object.keys(agent).length > 0) {\n\t\t\t\tObject.defineProperty(agents, name, {\n\t\t\t\t\tvalue: agent,\n\t\t\t\t\tenumerable: true,\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\twritable: true,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tdelete agents[name];\n\t\t\t}\n\t\t}\n\n\t\tconst normalized = normalizeSubagentSettings({\n\t\t\t...raw,\n\t\t\t...(Object.keys(agents).length > 0 ? { agents } : {}),\n\t\t});\n\t\tif (!normalized) throw new Error(`Cannot update invalid ${SETTINGS_FILE} agent settings`);\n\t\tconst updated = { ...raw };\n\t\tif (Object.keys(agents).length > 0) updated.agents = agents;\n\t\telse delete updated.agents;\n\t\twriteSettingsObjectUnlocked(updated, update.replaceCanonical);\n\t});\n}\n\ninterface SettingsObjectForUpdate {\n\tdocument: Record<string, unknown>;\n\treplaceCanonical: boolean;\n}\n\nfunction readSettingsObjectForUpdate(): SettingsObjectForUpdate {\n\tconst { canonicalPath, activePath } = resolveSubagentSettingsPaths();\n\tif (activePath === undefined) return { document: {}, replaceCanonical: false };\n\tconst activeFile = path.basename(activePath);\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(fs.readFileSync(activePath, \"utf8\"));\n\t} catch {\n\t\tthrow new Error(`Cannot update malformed ${activeFile}`);\n\t}\n\tif (!isPlainObject(parsed) || !normalizeSubagentSettings(parsed)) {\n\t\tthrow new Error(`Cannot update invalid ${activeFile}`);\n\t}\n\treturn { document: parsed, replaceCanonical: activePath === canonicalPath };\n}\n\nfunction writeSettingsObject(settings: object, replaceCanonical?: boolean): void {\n\twithSettingsMutationLock(() => writeSettingsObjectUnlocked(settings, replaceCanonical));\n}\n\nfunction writeSettingsObjectUnlocked(settings: object, replaceCanonical?: boolean): void {\n\tconst agentDir = getAgentDir();\n\tfs.mkdirSync(agentDir, { recursive: true });\n\tconst configPath = path.join(agentDir, SETTINGS_FILE);\n\tconst tempFile = path.join(agentDir, `.${SETTINGS_FILE}.${randomUUID()}.tmp`);\n\t// Updates seeded from a missing or legacy document must remain exclusive even if the\n\t// canonical path appears after the read and before publication.\n\tconst firstCanonicalPublication = !(replaceCanonical ?? pathEntryExists(configPath));\n\ttry {\n\t\tfs.writeFileSync(tempFile, `${JSON.stringify(settings, null, \"\\t\")}\\n`, {\n\t\t\tencoding: \"utf8\",\n\t\t\tflag: \"wx\",\n\t\t});\n\t\tif (firstCanonicalPublication && pathEntryExists(configPath)) {\n\t\t\tthrow new Error(`${SETTINGS_FILE} was created concurrently; reopen settings and retry`);\n\t\t}\n\t\tfs.renameSync(tempFile, configPath);\n\t} finally {\n\t\ttry {\n\t\t\tfs.rmSync(tempFile, { force: true });\n\t\t} catch {\n\t\t\t// Preserve the save result if best-effort temp cleanup fails.\n\t\t}\n\t}\n}\n\nfunction withSettingsMutationLock<T>(mutate: () => T): T {\n\tconst lockfile = require(\"proper-lockfile\") as typeof import(\"proper-lockfile\");\n\tconst agentDir = getAgentDir();\n\tfs.mkdirSync(agentDir, { recursive: true });\n\tconst configPath = path.join(agentDir, SETTINGS_FILE);\n\tconst release = lockfile.lockSync(configPath, {\n\t\tfs: SETTINGS_LOCK_FS_ADAPTER,\n\t\tlockfilePath: `${configPath}.mutation-lock`,\n\t\trealpath: false,\n\t});\n\ttry {\n\t\treturn mutate();\n\t} finally {\n\t\trelease();\n\t}\n}\n\nfunction sameStatefulLimits(left: StatefulLimits, right: StatefulLimits): boolean {\n\treturn STATEFUL_LIMIT_FIELDS.every((field) => left[field] === right[field]);\n}\n\nexport function uniqueToolNames(tools: string[]): string[] {\n\treturn [...new Set(tools)];\n}\n\nexport function sameToolSet(left: string[], right: string[]): boolean {\n\tconst leftSet = new Set(left);\n\tconst rightSet = new Set(right);\n\tif (leftSet.size !== rightSet.size) return false;\n\treturn [...leftSet].every((tool) => rightSet.has(tool));\n}\n\nexport function resolveSubagentThinkingLevel(\n\tagents: readonly Pick<AgentConfig, \"name\" | \"thinkingLevel\">[],\n\tagentName: string,\n\ttopLevelThinkingLevel?: SubagentThinkingLevel,\n\tlocalThinkingLevel?: SubagentThinkingLevel,\n): SubagentThinkingLevel | undefined {\n\treturn (\n\t\tlocalThinkingLevel ??\n\t\ttopLevelThinkingLevel ??\n\t\tagents.find((agent) => agent.name === agentName)?.thinkingLevel\n\t);\n}\n\nexport function hasAnyAgentOverride(config: SubagentAgentConfig): boolean {\n\treturn (\n\t\thasOwn(config, \"tools\") ||\n\t\thasOwn(config, \"model\") ||\n\t\thasOwn(config, \"thinkingLevel\") ||\n\t\thasOwn(config, \"timeoutMs\")\n\t);\n}\n"],
-  "mappings": "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",
-  "names": ["require", "require"]
-}