squidclaw 2026.4.24 → 2026.4.26

package/dist/run-main-C5SoyJvl.js

@@ -0,0 +1,452 @@
+import { i as formatUncaughtError } from "./errors-CGMew-1w.js";
+import { t as isMainModule } from "./is-main-EuRWM-HL.js";
+import { i as normalizeLowercaseStringOrEmpty, o as normalizeOptionalLowercaseString, s as normalizeOptionalString } from "./string-coerce-CIT1-v_a.js";
+import { A as hasFlag, D as getPositiveIntFlagValue, E as getFlagValue, L as isValueToken, T as getCommandPositionalsWithRootOptions, k as getVerboseFlag } from "./logger-DI8VmW74.js";
+import { t as resolveCliArgvInvocation } from "./argv-invocation-C_OkjMrJ.js";
+import { a as parseCliContainerArgs, i as maybeRunCliInContainer, n as applyCliProfileEnv, r as parseCliProfileArgs, t as normalizeWindowsArgv } from "./windows-argv-BSUon2ca.js";
+import { n as defaultRuntime } from "./runtime-beXCX1Aa.js";
+import { a as enableConsoleCapture } from "./subsystem-N40BsK-I.js";
+import { r as normalizeEnv, t as isTruthyEnvValue } from "./env-D7ydhUzs.js";
+import { t as assertSupportedRuntime } from "./runtime-guard-9xFL8fY5.js";
+import { _ as resolveStateDir } from "./paths-CBBdTof8.js";
+import { o as hasMemoryRuntime } from "./memory-state-CcnqnRW9.js";
+import "./logging-Db8a6Ejx.js";
+import { t as ensureSquidClawCliOnPath } from "./path-env-Dyk5uH6K.js";
+import { i as shouldSkipPluginCommandRegistration, n as shouldRegisterPrimaryCommandOnly } from "./command-registration-policy-qGDEOZTp.js";
+import { a as shouldEnsureCliPathForCommandPath, c as cliCommandCatalog, n as ensureCliExecutionBootstrap, o as resolveCliCommandPathPolicy, r as resolveCliExecutionStartupContext, s as matchesCommandPath, t as applyCliExecutionStartupPresentation } from "./command-execution-startup-CKIBavYi.js";
+import process$1 from "node:process";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { CommanderError } from "commander";
+//#region src/cli/program/route-args.ts
+function parseOptionalFlagValue(argv, name) {
+	const value = getFlagValue(argv, name);
+	if (value === null) return { ok: false };
+	return {
+		ok: true,
+		value
+	};
+}
+function parseRepeatedFlagValues(argv, name) {
+	const values = [];
+	const args = argv.slice(2);
+	for (let i = 0; i < args.length; i += 1) {
+		const arg = args[i];
+		if (!arg || arg === "--") break;
+		if (arg === name) {
+			const next = args[i + 1];
+			if (!isValueToken(next)) return null;
+			values.push(next);
+			i += 1;
+			continue;
+		}
+		if (arg.startsWith(`${name}=`)) {
+			const value = arg.slice(name.length + 1).trim();
+			if (!value) return null;
+			values.push(value);
+		}
+	}
+	return values;
+}
+function parseSinglePositional(argv, params) {
+	const positionals = getCommandPositionalsWithRootOptions(argv, params);
+	if (!positionals || positionals.length !== 1) return null;
+	return positionals[0] ?? null;
+}
+function parseHealthRouteArgs(argv) {
+	const timeoutMs = getPositiveIntFlagValue(argv, "--timeout");
+	if (timeoutMs === null) return null;
+	return {
+		json: hasFlag(argv, "--json"),
+		verbose: getVerboseFlag(argv, { includeDebug: true }),
+		timeoutMs
+	};
+}
+function parseStatusRouteArgs(argv) {
+	const timeoutMs = getPositiveIntFlagValue(argv, "--timeout");
+	if (timeoutMs === null) return null;
+	return {
+		json: hasFlag(argv, "--json"),
+		deep: hasFlag(argv, "--deep"),
+		all: hasFlag(argv, "--all"),
+		usage: hasFlag(argv, "--usage"),
+		verbose: getVerboseFlag(argv, { includeDebug: true }),
+		timeoutMs
+	};
+}
+function parseGatewayStatusRouteArgs(argv) {
+	const url = parseOptionalFlagValue(argv, "--url");
+	if (!url.ok) return null;
+	const token = parseOptionalFlagValue(argv, "--token");
+	if (!token.ok) return null;
+	const password = parseOptionalFlagValue(argv, "--password");
+	if (!password.ok) return null;
+	const timeout = parseOptionalFlagValue(argv, "--timeout");
+	if (!timeout.ok) return null;
+	const ssh = parseOptionalFlagValue(argv, "--ssh");
+	if (!ssh.ok || ssh.value !== void 0) return null;
+	const sshIdentity = parseOptionalFlagValue(argv, "--ssh-identity");
+	if (!sshIdentity.ok || sshIdentity.value !== void 0) return null;
+	if (hasFlag(argv, "--ssh-auto")) return null;
+	return {
+		rpc: {
+			url: url.value,
+			token: token.value,
+			password: password.value,
+			timeout: timeout.value
+		},
+		deep: hasFlag(argv, "--deep"),
+		json: hasFlag(argv, "--json"),
+		requireRpc: hasFlag(argv, "--require-rpc"),
+		probe: !hasFlag(argv, "--no-probe")
+	};
+}
+function parseSessionsRouteArgs(argv) {
+	const agent = parseOptionalFlagValue(argv, "--agent");
+	if (!agent.ok) return null;
+	const store = parseOptionalFlagValue(argv, "--store");
+	if (!store.ok) return null;
+	const active = parseOptionalFlagValue(argv, "--active");
+	if (!active.ok) return null;
+	return {
+		json: hasFlag(argv, "--json"),
+		allAgents: hasFlag(argv, "--all-agents"),
+		agent: agent.value,
+		store: store.value,
+		active: active.value
+	};
+}
+function parseAgentsListRouteArgs(argv) {
+	return {
+		json: hasFlag(argv, "--json"),
+		bindings: hasFlag(argv, "--bindings")
+	};
+}
+function parseConfigGetRouteArgs(argv) {
+	const path = parseSinglePositional(argv, {
+		commandPath: ["config", "get"],
+		booleanFlags: ["--json"]
+	});
+	if (!path) return null;
+	return {
+		path,
+		json: hasFlag(argv, "--json")
+	};
+}
+function parseConfigUnsetRouteArgs(argv) {
+	const path = parseSinglePositional(argv, { commandPath: ["config", "unset"] });
+	if (!path) return null;
+	return { path };
+}
+function parseModelsListRouteArgs(argv) {
+	const provider = parseOptionalFlagValue(argv, "--provider");
+	if (!provider.ok) return null;
+	return {
+		provider: provider.value,
+		all: hasFlag(argv, "--all"),
+		local: hasFlag(argv, "--local"),
+		json: hasFlag(argv, "--json"),
+		plain: hasFlag(argv, "--plain")
+	};
+}
+function parseModelsStatusRouteArgs(argv) {
+	const probeProvider = parseOptionalFlagValue(argv, "--probe-provider");
+	if (!probeProvider.ok) return null;
+	const probeTimeout = parseOptionalFlagValue(argv, "--probe-timeout");
+	if (!probeTimeout.ok) return null;
+	const probeConcurrency = parseOptionalFlagValue(argv, "--probe-concurrency");
+	if (!probeConcurrency.ok) return null;
+	const probeMaxTokens = parseOptionalFlagValue(argv, "--probe-max-tokens");
+	if (!probeMaxTokens.ok) return null;
+	const agent = parseOptionalFlagValue(argv, "--agent");
+	if (!agent.ok) return null;
+	const probeProfileValues = parseRepeatedFlagValues(argv, "--probe-profile");
+	if (probeProfileValues === null) return null;
+	const probeProfile = probeProfileValues.length === 0 ? void 0 : probeProfileValues.length === 1 ? probeProfileValues[0] : probeProfileValues;
+	return {
+		probeProvider: probeProvider.value,
+		probeTimeout: probeTimeout.value,
+		probeConcurrency: probeConcurrency.value,
+		probeMaxTokens: probeMaxTokens.value,
+		agent: agent.value,
+		probeProfile,
+		json: hasFlag(argv, "--json"),
+		plain: hasFlag(argv, "--plain"),
+		check: hasFlag(argv, "--check"),
+		probe: hasFlag(argv, "--probe")
+	};
+}
+//#endregion
+//#region src/cli/program/routed-command-definitions.ts
+function defineRoutedCommand(definition) {
+	return definition;
+}
+const routedCommandDefinitions = {
+	health: defineRoutedCommand({
+		parseArgs: parseHealthRouteArgs,
+		runParsedArgs: async (args) => {
+			const { healthCommand } = await import("./health-Dj59Wog_.js");
+			await healthCommand(args, defaultRuntime);
+		}
+	}),
+	status: defineRoutedCommand({
+		parseArgs: parseStatusRouteArgs,
+		runParsedArgs: async (args) => {
+			if (args.json) {
+				const { statusJsonCommand } = await import("./status-json-CWhbU4Da.js");
+				await statusJsonCommand({
+					deep: args.deep,
+					all: args.all,
+					usage: args.usage,
+					timeoutMs: args.timeoutMs
+				}, defaultRuntime);
+				return;
+			}
+			const { statusCommand } = await import("./status-BramWBLG.js");
+			await statusCommand(args, defaultRuntime);
+		}
+	}),
+	"gateway-status": defineRoutedCommand({
+		parseArgs: parseGatewayStatusRouteArgs,
+		runParsedArgs: async (args) => {
+			const { runDaemonStatus } = await import("./status-DlBtVbSH.js");
+			await runDaemonStatus(args);
+		}
+	}),
+	sessions: defineRoutedCommand({
+		parseArgs: parseSessionsRouteArgs,
+		runParsedArgs: async (args) => {
+			const { sessionsCommand } = await import("./sessions-B-eEwNDS.js");
+			await sessionsCommand(args, defaultRuntime);
+		}
+	}),
+	"agents-list": defineRoutedCommand({
+		parseArgs: parseAgentsListRouteArgs,
+		runParsedArgs: async (args) => {
+			const { agentsListCommand } = await import("./agents-BQS1Y3W6.js");
+			await agentsListCommand(args, defaultRuntime);
+		}
+	}),
+	"config-get": defineRoutedCommand({
+		parseArgs: parseConfigGetRouteArgs,
+		runParsedArgs: async (args) => {
+			const { runConfigGet } = await import("./config-cli-CE2z2XhI.js");
+			await runConfigGet(args);
+		}
+	}),
+	"config-unset": defineRoutedCommand({
+		parseArgs: parseConfigUnsetRouteArgs,
+		runParsedArgs: async (args) => {
+			const { runConfigUnset } = await import("./config-cli-CE2z2XhI.js");
+			await runConfigUnset(args);
+		}
+	}),
+	"models-list": defineRoutedCommand({
+		parseArgs: parseModelsListRouteArgs,
+		runParsedArgs: async (args) => {
+			const { modelsListCommand } = await import("./models-CUbywYoT.js");
+			await modelsListCommand(args, defaultRuntime);
+		}
+	}),
+	"models-status": defineRoutedCommand({
+		parseArgs: parseModelsStatusRouteArgs,
+		runParsedArgs: async (args) => {
+			const { modelsStatusCommand } = await import("./models-CUbywYoT.js");
+			await modelsStatusCommand(args, defaultRuntime);
+		}
+	})
+};
+//#endregion
+//#region src/cli/program/route-specs.ts
+function createCommandLoadPlugins(commandPath) {
+	return (argv) => {
+		const loadPlugins = resolveCliCommandPathPolicy([...commandPath]).loadPlugins;
+		return loadPlugins === "always" || loadPlugins === "text-only" && !hasFlag(argv, "--json");
+	};
+}
+function createParsedRoute(params) {
+	return {
+		match: (path) => matchesCommandPath(path, params.entry.commandPath, { exact: params.entry.exact }),
+		loadPlugins: params.entry.route?.preloadPlugins ? createCommandLoadPlugins(params.entry.commandPath) : void 0,
+		run: async (argv) => {
+			const args = params.definition.parseArgs(argv);
+			if (!args) return false;
+			await params.definition.runParsedArgs(args);
+			return true;
+		}
+	};
+}
+const routedCommands = cliCommandCatalog.filter((entry) => Boolean(entry.route)).map((entry) => createParsedRoute({
+	entry,
+	definition: routedCommandDefinitions[entry.route.id]
+}));
+//#endregion
+//#region src/cli/program/routes.ts
+function findRoutedCommand(path) {
+	for (const route of routedCommands) if (route.match(path)) return route;
+	return null;
+}
+//#endregion
+//#region src/cli/route.ts
+async function prepareRoutedCommand(params) {
+	const { startupPolicy } = resolveCliExecutionStartupContext({
+		argv: params.argv,
+		jsonOutputMode: hasFlag(params.argv, "--json"),
+		env: process.env,
+		routeMode: true
+	});
+	const { VERSION } = await import("./version-CEmEfLIL.js");
+	await applyCliExecutionStartupPresentation({
+		argv: params.argv,
+		routeLogsToStderrOnSuppress: false,
+		startupPolicy,
+		showBanner: process.stdout.isTTY && !startupPolicy.suppressDoctorStdout,
+		version: VERSION
+	});
+	const shouldLoadPlugins = typeof params.loadPlugins === "function" ? params.loadPlugins(params.argv) : params.loadPlugins;
+	await ensureCliExecutionBootstrap({
+		runtime: defaultRuntime,
+		commandPath: params.commandPath,
+		startupPolicy,
+		loadPlugins: shouldLoadPlugins ?? startupPolicy.loadPlugins
+	});
+}
+async function tryRouteCli(argv) {
+	if (isTruthyEnvValue(process.env.SQUIDCLAW_DISABLE_ROUTE_FIRST)) return false;
+	const invocation = resolveCliArgvInvocation(argv);
+	if (invocation.hasHelpOrVersion) return false;
+	if (!invocation.commandPath[0]) return false;
+	const route = findRoutedCommand(invocation.commandPath);
+	if (!route) return false;
+	await prepareRoutedCommand({
+		argv,
+		commandPath: invocation.commandPath,
+		loadPlugins: route.loadPlugins
+	});
+	return route.run(argv);
+}
+//#endregion
+//#region src/cli/run-main.ts
+async function closeCliMemoryManagers() {
+	if (!hasMemoryRuntime()) return;
+	try {
+		const { closeActiveMemorySearchManagers } = await import("./memory-runtime-CiQOPTmg.js");
+		await closeActiveMemorySearchManagers();
+	} catch {}
+}
+function rewriteUpdateFlagArgv(argv) {
+	const index = argv.indexOf("--update");
+	if (index === -1) return argv;
+	const next = [...argv];
+	next.splice(index, 1, "update");
+	return next;
+}
+function shouldEnsureCliPath(argv) {
+	const invocation = resolveCliArgvInvocation(argv);
+	if (invocation.hasHelpOrVersion) return false;
+	return shouldEnsureCliPathForCommandPath(invocation.commandPath);
+}
+function shouldUseRootHelpFastPath(argv) {
+	return resolveCliArgvInvocation(argv).isRootHelpInvocation;
+}
+function resolveMissingPluginCommandMessage(pluginId, config) {
+	const normalizedPluginId = normalizeLowercaseStringOrEmpty(pluginId);
+	if (!normalizedPluginId) return null;
+	const allow = Array.isArray(config?.plugins?.allow) && config.plugins.allow.length > 0 ? config.plugins.allow.filter((entry) => typeof entry === "string").map((entry) => normalizeOptionalLowercaseString(entry)).filter(Boolean) : [];
+	if (allow.length > 0 && !allow.includes(normalizedPluginId)) return `The \`squidclaw ${normalizedPluginId}\` command is unavailable because \`plugins.allow\` excludes "${normalizedPluginId}". Add "${normalizedPluginId}" to \`plugins.allow\` if you want that bundled plugin CLI surface.`;
+	if (config?.plugins?.entries?.[normalizedPluginId]?.enabled === false) return `The \`squidclaw ${normalizedPluginId}\` command is unavailable because \`plugins.entries.${normalizedPluginId}.enabled=false\`. Re-enable that entry if you want the bundled plugin CLI surface.`;
+	return null;
+}
+function shouldLoadCliDotEnv(env = process$1.env) {
+	if (existsSync(path.join(process$1.cwd(), ".env"))) return true;
+	return existsSync(path.join(resolveStateDir(env), ".env"));
+}
+async function runCli(argv = process$1.argv) {
+	const originalArgv = normalizeWindowsArgv(argv);
+	const parsedContainer = parseCliContainerArgs(originalArgv);
+	if (!parsedContainer.ok) throw new Error(parsedContainer.error);
+	const parsedProfile = parseCliProfileArgs(parsedContainer.argv);
+	if (!parsedProfile.ok) throw new Error(parsedProfile.error);
+	if (parsedProfile.profile) applyCliProfileEnv({ profile: parsedProfile.profile });
+	if ((parsedContainer.container ?? normalizeOptionalString(process$1.env.SQUIDCLAW_CONTAINER) ?? null) && parsedProfile.profile) throw new Error("--container cannot be combined with --profile/--dev");
+	const containerTarget = maybeRunCliInContainer(originalArgv);
+	if (containerTarget.handled) {
+		if (containerTarget.exitCode !== 0) process$1.exitCode = containerTarget.exitCode;
+		return;
+	}
+	let normalizedArgv = parsedProfile.argv;
+	if (shouldLoadCliDotEnv()) {
+		const { loadCliDotEnv } = await import("./dotenv-Wva7UBI_.js");
+		loadCliDotEnv({ quiet: true });
+	}
+	normalizeEnv();
+	if (shouldEnsureCliPath(normalizedArgv)) ensureSquidClawCliOnPath();
+	assertSupportedRuntime();
+	try {
+		if (shouldUseRootHelpFastPath(normalizedArgv)) {
+			const { outputPrecomputedRootHelpText } = await import("./root-help-metadata-DXUDXwdg.js");
+			if (!outputPrecomputedRootHelpText()) {
+				const { outputRootHelp } = await import("./root-help-BrKQYV9R.js");
+				await outputRootHelp();
+			}
+			return;
+		}
+		if (await tryRouteCli(normalizedArgv)) return;
+		enableConsoleCapture();
+		const [{ buildProgram }, { installUnhandledRejectionHandler }, { restoreTerminalState }] = await Promise.all([
+			import("./program-B2XUGWf0.js"),
+			import("./unhandled-rejections-Bvo4zsUY.js"),
+			import("./restore-ADlpnb-M.js")
+		]);
+		const program = buildProgram();
+		installUnhandledRejectionHandler();
+		process$1.on("uncaughtException", (error) => {
+			console.error("[squidclaw] Uncaught exception:", formatUncaughtError(error));
+			restoreTerminalState("uncaught exception", { resumeStdinIfPaused: false });
+			process$1.exit(1);
+		});
+		const parseArgv = rewriteUpdateFlagArgv(normalizedArgv);
+		const { primary } = resolveCliArgvInvocation(parseArgv);
+		if (primary && shouldRegisterPrimaryCommandOnly(parseArgv)) {
+			const { getProgramContext } = await import("./program-context-IHzM-xLz.js");
+			const ctx = getProgramContext(program);
+			if (ctx) {
+				const { registerCoreCliByName } = await import("./command-registry-C4qTbytp.js");
+				await registerCoreCliByName(program, ctx, primary, parseArgv);
+			}
+			const { registerSubCliByName } = await import("./register.subclis-DIE44wj9.js");
+			await registerSubCliByName(program, primary);
+		}
+		if (!shouldSkipPluginCommandRegistration({
+			argv: parseArgv,
+			primary,
+			hasBuiltinPrimary: primary !== null && program.commands.some((command) => command.name() === primary)
+		})) {
+			const { registerPluginCliCommandsFromValidatedConfig } = await import("./cli-GKILS9dU.js");
+			const config = await registerPluginCliCommandsFromValidatedConfig(program, void 0, void 0, {
+				mode: "lazy",
+				primary
+			});
+			if (config) {
+				if (primary && !program.commands.some((command) => command.name() === primary)) {
+					const missingPluginCommandMessage = resolveMissingPluginCommandMessage(primary, config);
+					if (missingPluginCommandMessage) throw new Error(missingPluginCommandMessage);
+				}
+			}
+		}
+		try {
+			await program.parseAsync(parseArgv);
+		} catch (error) {
+			if (!(error instanceof CommanderError)) throw error;
+			process$1.exitCode = error.exitCode;
+		}
+	} finally {
+		await closeCliMemoryManagers();
+	}
+}
+function isCliMainModule() {
+	return isMainModule({ currentFile: fileURLToPath(import.meta.url) });
+}
+//#endregion
+export { isCliMainModule, resolveMissingPluginCommandMessage, rewriteUpdateFlagArgv, runCli, shouldEnsureCliPath, shouldUseRootHelpFastPath };

package/dist/run-wait-BS5Cx7Uv.js

@@ -0,0 +1,118 @@
+import { r as formatErrorMessage } from "./errors-CGMew-1w.js";
+import { r as callGateway } from "./call-Stm9npN1.js";
+import { i as stripToolMessages, t as extractAssistantText } from "./chat-history-text-BcM_iwAx.js";
+let runWaitDeps = { callGateway };
+function normalizeAgentWaitResult(status, wait) {
+	return {
+		status,
+		error: typeof wait?.error === "string" ? wait.error : void 0,
+		startedAt: typeof wait?.startedAt === "number" ? wait.startedAt : void 0,
+		endedAt: typeof wait?.endedAt === "number" ? wait.endedAt : void 0
+	};
+}
+function normalizePendingRunIds(runIds) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const runId of runIds) {
+		const normalized = runId.trim();
+		if (!normalized || seen.has(normalized)) continue;
+		seen.add(normalized);
+	}
+	return [...seen];
+}
+function resolveLatestAssistantReplySnapshot(messages) {
+	for (let i = messages.length - 1; i >= 0; i -= 1) {
+		const candidate = messages[i];
+		if (!candidate || typeof candidate !== "object") continue;
+		if (candidate.role !== "assistant") continue;
+		const text = extractAssistantText(candidate);
+		if (!text?.trim()) continue;
+		let fingerprint;
+		try {
+			fingerprint = JSON.stringify(candidate);
+		} catch {
+			fingerprint = text;
+		}
+		return {
+			text,
+			fingerprint
+		};
+	}
+	return {};
+}
+async function readLatestAssistantReplySnapshot(params) {
+	const history = await (params.callGateway ?? runWaitDeps.callGateway)({
+		method: "chat.history",
+		params: {
+			sessionKey: params.sessionKey,
+			limit: params.limit ?? 50
+		}
+	});
+	return resolveLatestAssistantReplySnapshot(stripToolMessages(Array.isArray(history?.messages) ? history.messages : []));
+}
+async function readLatestAssistantReply(params) {
+	return (await readLatestAssistantReplySnapshot({
+		sessionKey: params.sessionKey,
+		limit: params.limit,
+		callGateway: params.callGateway
+	})).text;
+}
+async function waitForAgentRun(params) {
+	const timeoutMs = Math.max(1, Math.floor(params.timeoutMs));
+	try {
+		const wait = await (params.callGateway ?? runWaitDeps.callGateway)({
+			method: "agent.wait",
+			params: {
+				runId: params.runId,
+				timeoutMs
+			},
+			timeoutMs: timeoutMs + 2e3
+		});
+		if (wait?.status === "timeout") return normalizeAgentWaitResult("timeout", wait);
+		if (wait?.status === "error") return normalizeAgentWaitResult("error", wait);
+		return normalizeAgentWaitResult("ok", wait);
+	} catch (err) {
+		const error = formatErrorMessage(err);
+		return {
+			status: error.includes("gateway timeout") ? "timeout" : "error",
+			error
+		};
+	}
+}
+async function waitForAgentRunAndReadUpdatedAssistantReply(params) {
+	const wait = await waitForAgentRun({
+		runId: params.runId,
+		timeoutMs: params.timeoutMs,
+		callGateway: params.callGateway
+	});
+	if (wait.status !== "ok") return wait;
+	const latestReply = await readLatestAssistantReplySnapshot({
+		sessionKey: params.sessionKey,
+		limit: params.limit,
+		callGateway: params.callGateway
+	});
+	const baselineFingerprint = params.baseline?.fingerprint;
+	return {
+		status: "ok",
+		replyText: latestReply.text && (!baselineFingerprint || latestReply.fingerprint !== baselineFingerprint) ? latestReply.text : void 0
+	};
+}
+async function waitForAgentRunsToDrain(params) {
+	const deadlineAtMs = params.deadlineAtMs ?? Date.now() + Math.max(1, Math.floor(params.timeoutMs ?? 0));
+	let pendingRunIds = new Set(normalizePendingRunIds(params.initialPendingRunIds ?? params.getPendingRunIds()));
+	while (pendingRunIds.size > 0 && Date.now() < deadlineAtMs) {
+		const remainingMs = Math.max(1, deadlineAtMs - Date.now());
+		await Promise.allSettled([...pendingRunIds].map((runId) => waitForAgentRun({
+			runId,
+			timeoutMs: remainingMs,
+			callGateway: params.callGateway
+		})));
+		pendingRunIds = new Set(normalizePendingRunIds(params.getPendingRunIds()));
+	}
+	return {
+		timedOut: pendingRunIds.size > 0,
+		pendingRunIds: [...pendingRunIds],
+		deadlineAtMs
+	};
+}
+//#endregion
+export { waitForAgentRunsToDrain as a, waitForAgentRunAndReadUpdatedAssistantReply as i, readLatestAssistantReplySnapshot as n, waitForAgentRun as r, readLatestAssistantReply as t };