remoteclaw 0.1.0-next.87fb2cd → 0.1.0-next.8c439ca

package/dist/register.status-health-sessions-C_n1u-uW.js

@@ -0,0 +1,428 @@
+import { Ct as theme, St as isRich, _ as defaultRuntime, _t as setVerbose } from "./entry.js";
+import { i as loadConfig } from "./config-B39yU2hC.js";
+import "./host-env-security-axRnIi8d.js";
+import "./shell-env-DBS5su07.js";
+import "./version-3QUZW8EP.js";
+import "./env-vars-CD2_baIP.js";
+import "./zod-schema-C752uoFq.js";
+import "./agent-scope-CJW7vnF8.js";
+import "./dock-nJM0dcsi.js";
+import "./message-channel-DOyKgFu8.js";
+import { c as capEntryCount, g as updateSessionStore, l as loadSessionStore, p as resolveMaintenanceConfig, u as pruneStaleEntries, v as enforceSessionDiskBudget } from "./sessions-Bh4_6wS4.js";
+import "./plugins-DdMgSc_b.js";
+import "./accounts-WYyfAiie.js";
+import "./accounts-DAdUdbPk.js";
+import "./accounts-Bpk-loA6.js";
+import "./bindings-BpL4pISF.js";
+import "./logging-DJFQvfGD.js";
+import "./targets-Q-YGeAqu.js";
+import "./chat-envelope-CY1yvCc-.js";
+import "./strip-inbound-meta-DuDjnGjC.js";
+import "./client-D2d88Uyh.js";
+import "./call-VEhcnYzD.js";
+import "./net-Cg8AQeke.js";
+import "./logger-BWMPnILd.js";
+import "./ip-D0zgNmBV.js";
+import "./tailnet-CEudzG0i.js";
+import "./lanes-cHJ5arWg.js";
+import "./subagent-registry-CB6BnueH.js";
+import "./response-prefix-template-DDvbVpx6.js";
+import "./agent-helpers-D83kfcF9.js";
+import "./tool-images-kloBqxqK.js";
+import "./exec-DkFE7lqU.js";
+import "./image-ops-DWytvdh_.js";
+import "./tokens-B-jmvNR9.js";
+import "./reply-fFZaZsO9.js";
+import "./hook-runner-global-wRhkAE0S.js";
+import "./redact-Dx1Fue21.js";
+import "./tool-display-Br6mwaJc.js";
+import "./markdown-tables-DeFSK6aY.js";
+import "./chunk-CrfQ_O--.js";
+import "./media-BD2cZGXT.js";
+import "./render-flG67HhW.js";
+import "./tables-K3rOiGaJ.js";
+import "./fs-safe-BcEpbVjc.js";
+import "./mime-1E7nn9IU.js";
+import "./ssrf-7I3FUHpm.js";
+import "./fetch-CbGTzJ8L.js";
+import "./common-6D7nhDP-.js";
+import "./auth-C-XX0Tdt.js";
+import "./file-lock-BHfqppLm.js";
+import "./commands-kZtQfqDl.js";
+import "./commands-registry-BMXLgPo_.js";
+import "./provider-auth-CfdnLqh3.js";
+import "./audio-B1lTyRqS.js";
+import "./targets-Zb5zZXjb.js";
+import "./pairing-store-Bu9pVlkO.js";
+import "./fetch-B3EQXbTa.js";
+import "./retry-CByUYDAZ.js";
+import "./client-Fi2k2G9Z.js";
+import "./errors-BfONuT95.js";
+import "./channel-activity-DtRx3b0W.js";
+import "./send-DRuTHjnp.js";
+import "./session-cost-usage-Dg3dzS0E.js";
+import "./reply-directives-DQ904djQ.js";
+import "./ports-DiQFcKUB.js";
+import "./ports-lsof-xWMTWvMQ.js";
+import "./control-auth-CJ8E08vS.js";
+import "./prompt-C31r0R5I.js";
+import "./tailscale-DngZHD9L.js";
+import "./auth-DJ7XEBDO.js";
+import "./store-D_gpBpAW.js";
+import "./dangerous-tools-CIPZZJoN.js";
+import { t as formatDocsLink } from "./links-BFtUmGLH.js";
+import "./progress-C-hTn2yV.js";
+import { t as runCommandWithRuntime } from "./cli-utils-5W6ugvN5.js";
+import { t as formatHelpExamples } from "./help-format-GeOPYD_A.js";
+import "./prompt-style-B1740PBl.js";
+import "./send-PrDp6hCg.js";
+import "./deliver-CNjdsIiw.js";
+import "./outbound-attachment-DYa1asB5.js";
+import "./delivery-queue-DMeQchpT.js";
+import "./onboard-helpers-BGcqk1LH.js";
+import "./channels-status-issues-B77y-TLr.js";
+import { n as parsePositiveIntOrUndefined } from "./helpers-6_MYSJEW.js";
+import "./systemd-tS61V4ao.js";
+import "./service-SRcnA1Am.js";
+import "./diagnostics-BhFwk6F3.js";
+import "./table-B9zSN_7D.js";
+import "./audit-Ctou59eh.js";
+import { n as statusCommand } from "./status-C484AT5t.js";
+import { r as healthCommand } from "./health-ClE4NYwj.js";
+import "./channel-account-context-CaCzVa76.js";
+import "./status.update-DquSK3p7.js";
+import "./session-utils-BizbTwCq.js";
+import "./dm-policy-shared-CkFf7bHb.js";
+import "./node-service-CkwVlcey.js";
+import { a as SESSION_MODEL_PAD, c as formatSessionKeyCell, d as resolveSessionDisplayModel, f as toSessionDisplayRows, i as SESSION_KEY_PAD, l as formatSessionModelCell, o as formatSessionAgeCell, p as resolveSessionStoreTargets, r as SESSION_AGE_PAD, s as formatSessionFlagsCell, t as sessionsCommand, u as resolveSessionDisplayDefaults } from "./sessions-CrzERa3i.js";
+
+//#region src/commands/sessions-cleanup.ts
+const ACTION_PAD = 12;
+function resolveSessionCleanupAction(params) {
+	if (params.staleKeys.has(params.key)) return "prune-stale";
+	if (params.cappedKeys.has(params.key)) return "cap-overflow";
+	if (params.budgetEvictedKeys.has(params.key)) return "evict-budget";
+	return "keep";
+}
+function formatCleanupActionCell(action, rich) {
+	const label = action.padEnd(ACTION_PAD);
+	if (!rich) return label;
+	if (action === "keep") return theme.muted(label);
+	if (action === "prune-stale") return theme.warn(label);
+	if (action === "cap-overflow") return theme.accentBright(label);
+	return theme.error(label);
+}
+function buildActionRows(params) {
+	return toSessionDisplayRows(params.beforeStore).map((row) => ({
+		...row,
+		action: resolveSessionCleanupAction({
+			key: row.key,
+			staleKeys: params.staleKeys,
+			cappedKeys: params.cappedKeys,
+			budgetEvictedKeys: params.budgetEvictedKeys
+		})
+	}));
+}
+async function previewStoreCleanup(params) {
+	const maintenance = resolveMaintenanceConfig();
+	const beforeStore = loadSessionStore(params.target.storePath, { skipCache: true });
+	const previewStore = structuredClone(beforeStore);
+	const staleKeys = /* @__PURE__ */ new Set();
+	const cappedKeys = /* @__PURE__ */ new Set();
+	const pruned = pruneStaleEntries(previewStore, maintenance.pruneAfterMs, {
+		log: false,
+		onPruned: ({ key }) => {
+			staleKeys.add(key);
+		}
+	});
+	const capped = capEntryCount(previewStore, maintenance.maxEntries, {
+		log: false,
+		onCapped: ({ key }) => {
+			cappedKeys.add(key);
+		}
+	});
+	const beforeBudgetStore = structuredClone(previewStore);
+	const diskBudget = await enforceSessionDiskBudget({
+		store: previewStore,
+		storePath: params.target.storePath,
+		activeSessionKey: params.activeKey,
+		maintenance,
+		warnOnly: false,
+		dryRun: true
+	});
+	const budgetEvictedKeys = /* @__PURE__ */ new Set();
+	for (const key of Object.keys(beforeBudgetStore)) if (!Object.hasOwn(previewStore, key)) budgetEvictedKeys.add(key);
+	const beforeCount = Object.keys(beforeStore).length;
+	const afterPreviewCount = Object.keys(previewStore).length;
+	const wouldMutate = pruned > 0 || capped > 0 || Boolean((diskBudget?.removedEntries ?? 0) > 0 || (diskBudget?.removedFiles ?? 0) > 0);
+	return {
+		summary: {
+			agentId: params.target.agentId,
+			storePath: params.target.storePath,
+			mode: params.mode,
+			dryRun: params.dryRun,
+			beforeCount,
+			afterCount: afterPreviewCount,
+			pruned,
+			capped,
+			diskBudget,
+			wouldMutate
+		},
+		actionRows: buildActionRows({
+			beforeStore,
+			staleKeys,
+			cappedKeys,
+			budgetEvictedKeys
+		})
+	};
+}
+function renderStoreDryRunPlan(params) {
+	const rich = isRich();
+	if (params.showAgentHeader) params.runtime.log(`Agent: ${params.summary.agentId}`);
+	params.runtime.log(`Session store: ${params.summary.storePath}`);
+	params.runtime.log(`Maintenance mode: ${params.summary.mode}`);
+	params.runtime.log(`Entries: ${params.summary.beforeCount} -> ${params.summary.afterCount} (remove ${params.summary.beforeCount - params.summary.afterCount})`);
+	params.runtime.log(`Would prune stale: ${params.summary.pruned}`);
+	params.runtime.log(`Would cap overflow: ${params.summary.capped}`);
+	if (params.summary.diskBudget) params.runtime.log(`Would enforce disk budget: ${params.summary.diskBudget.totalBytesBefore} -> ${params.summary.diskBudget.totalBytesAfter} bytes (files ${params.summary.diskBudget.removedFiles}, entries ${params.summary.diskBudget.removedEntries})`);
+	if (params.actionRows.length === 0) return;
+	params.runtime.log("");
+	params.runtime.log("Planned session actions:");
+	const header = [
+		"Action".padEnd(ACTION_PAD),
+		"Key".padEnd(SESSION_KEY_PAD),
+		"Age".padEnd(SESSION_AGE_PAD),
+		"Model".padEnd(SESSION_MODEL_PAD),
+		"Flags"
+	].join(" ");
+	params.runtime.log(rich ? theme.heading(header) : header);
+	for (const actionRow of params.actionRows) {
+		const model = resolveSessionDisplayModel(params.cfg, actionRow, params.displayDefaults);
+		const line = [
+			formatCleanupActionCell(actionRow.action, rich),
+			formatSessionKeyCell(actionRow.key, rich),
+			formatSessionAgeCell(actionRow.updatedAt, rich),
+			formatSessionModelCell(model, rich),
+			formatSessionFlagsCell(actionRow, rich)
+		].join(" ");
+		params.runtime.log(line.trimEnd());
+	}
+}
+async function sessionsCleanupCommand(opts, runtime) {
+	const cfg = loadConfig();
+	const displayDefaults = resolveSessionDisplayDefaults(cfg);
+	const mode = opts.enforce ? "enforce" : resolveMaintenanceConfig().mode;
+	let targets;
+	try {
+		targets = resolveSessionStoreTargets(cfg, {
+			store: opts.store,
+			agent: opts.agent,
+			allAgents: opts.allAgents
+		});
+	} catch (error) {
+		runtime.error(error instanceof Error ? error.message : String(error));
+		runtime.exit(1);
+		return;
+	}
+	const previewResults = [];
+	for (const target of targets) {
+		const result = await previewStoreCleanup({
+			target,
+			mode,
+			dryRun: Boolean(opts.dryRun),
+			activeKey: opts.activeKey
+		});
+		previewResults.push(result);
+	}
+	if (opts.dryRun) {
+		if (opts.json) {
+			if (previewResults.length === 1) {
+				runtime.log(JSON.stringify(previewResults[0]?.summary ?? {}, null, 2));
+				return;
+			}
+			runtime.log(JSON.stringify({
+				allAgents: true,
+				mode,
+				dryRun: true,
+				stores: previewResults.map((result) => result.summary)
+			}, null, 2));
+			return;
+		}
+		for (let i = 0; i < previewResults.length; i += 1) {
+			const result = previewResults[i];
+			if (i > 0) runtime.log("");
+			renderStoreDryRunPlan({
+				cfg,
+				summary: result.summary,
+				actionRows: result.actionRows,
+				displayDefaults,
+				runtime,
+				showAgentHeader: previewResults.length > 1
+			});
+		}
+		return;
+	}
+	const appliedSummaries = [];
+	for (const target of targets) {
+		const appliedReportRef = { current: null };
+		await updateSessionStore(target.storePath, async () => {}, {
+			activeSessionKey: opts.activeKey,
+			maintenanceOverride: { mode },
+			onMaintenanceApplied: (report) => {
+				appliedReportRef.current = report;
+			}
+		});
+		const afterStore = loadSessionStore(target.storePath, { skipCache: true });
+		const preview = previewResults.find((result) => result.summary.storePath === target.storePath);
+		const appliedReport = appliedReportRef.current;
+		const summary = appliedReport === null ? {
+			...preview?.summary ?? {
+				agentId: target.agentId,
+				storePath: target.storePath,
+				mode,
+				dryRun: false,
+				beforeCount: 0,
+				afterCount: 0,
+				pruned: 0,
+				capped: 0,
+				diskBudget: null,
+				wouldMutate: false
+			},
+			dryRun: false,
+			applied: true,
+			appliedCount: Object.keys(afterStore).length
+		} : {
+			agentId: target.agentId,
+			storePath: target.storePath,
+			mode: appliedReport.mode,
+			dryRun: false,
+			beforeCount: appliedReport.beforeCount,
+			afterCount: appliedReport.afterCount,
+			pruned: appliedReport.pruned,
+			capped: appliedReport.capped,
+			diskBudget: appliedReport.diskBudget,
+			wouldMutate: appliedReport.pruned > 0 || appliedReport.capped > 0 || Boolean((appliedReport.diskBudget?.removedEntries ?? 0) > 0 || (appliedReport.diskBudget?.removedFiles ?? 0) > 0),
+			applied: true,
+			appliedCount: Object.keys(afterStore).length
+		};
+		appliedSummaries.push(summary);
+	}
+	if (opts.json) {
+		if (appliedSummaries.length === 1) {
+			runtime.log(JSON.stringify(appliedSummaries[0] ?? {}, null, 2));
+			return;
+		}
+		runtime.log(JSON.stringify({
+			allAgents: true,
+			mode,
+			dryRun: false,
+			stores: appliedSummaries
+		}, null, 2));
+		return;
+	}
+	for (let i = 0; i < appliedSummaries.length; i += 1) {
+		const summary = appliedSummaries[i];
+		if (i > 0) runtime.log("");
+		if (appliedSummaries.length > 1) runtime.log(`Agent: ${summary.agentId}`);
+		runtime.log(`Session store: ${summary.storePath}`);
+		runtime.log(`Applied maintenance. Current entries: ${summary.appliedCount ?? 0}`);
+	}
+}
+
+//#endregion
+//#region src/cli/program/register.status-health-sessions.ts
+function resolveVerbose(opts) {
+	return Boolean(opts.verbose || opts.debug);
+}
+function parseTimeoutMs(timeout) {
+	const parsed = parsePositiveIntOrUndefined(timeout);
+	if (timeout !== void 0 && parsed === void 0) {
+		defaultRuntime.error("--timeout must be a positive integer (milliseconds)");
+		defaultRuntime.exit(1);
+		return null;
+	}
+	return parsed;
+}
+async function runWithVerboseAndTimeout(opts, action) {
+	const verbose = resolveVerbose(opts);
+	setVerbose(verbose);
+	const timeoutMs = parseTimeoutMs(opts.timeout);
+	if (timeoutMs === null) return;
+	await runCommandWithRuntime(defaultRuntime, async () => {
+		await action({
+			verbose,
+			timeoutMs
+		});
+	});
+}
+function registerStatusHealthSessionsCommands(program) {
+	program.command("status").description("Show channel health and recent session recipients").option("--json", "Output JSON instead of text", false).option("--all", "Full diagnosis (read-only, pasteable)", false).option("--usage", "Show model provider usage/quota snapshots", false).option("--deep", "Probe channels (WhatsApp Web + Telegram + Discord + Slack + Signal)", false).option("--timeout <ms>", "Probe timeout in milliseconds", "10000").option("--verbose", "Verbose logging", false).option("--debug", "Alias for --verbose", false).addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
+		["remoteclaw status", "Show channel health + session summary."],
+		["remoteclaw status --all", "Full diagnosis (read-only)."],
+		["remoteclaw status --json", "Machine-readable output."],
+		["remoteclaw status --usage", "Show model provider usage/quota snapshots."],
+		["remoteclaw status --deep", "Run channel probes (WA + Telegram + Discord + Slack + Signal)."],
+		["remoteclaw status --deep --timeout 5000", "Tighten probe timeout."]
+	])}`).addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/status", "docs.remoteclaw.org/cli/status")}\n`).action(async (opts) => {
+		await runWithVerboseAndTimeout(opts, async ({ verbose, timeoutMs }) => {
+			await statusCommand({
+				json: Boolean(opts.json),
+				all: Boolean(opts.all),
+				deep: Boolean(opts.deep),
+				usage: Boolean(opts.usage),
+				timeoutMs,
+				verbose
+			}, defaultRuntime);
+		});
+	});
+	program.command("health").description("Fetch health from the running gateway").option("--json", "Output JSON instead of text", false).option("--timeout <ms>", "Connection timeout in milliseconds", "10000").option("--verbose", "Verbose logging", false).option("--debug", "Alias for --verbose", false).addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/health", "docs.remoteclaw.org/cli/health")}\n`).action(async (opts) => {
+		await runWithVerboseAndTimeout(opts, async ({ verbose, timeoutMs }) => {
+			await healthCommand({
+				json: Boolean(opts.json),
+				timeoutMs,
+				verbose
+			}, defaultRuntime);
+		});
+	});
+	const sessionsCmd = program.command("sessions").description("List stored conversation sessions").option("--json", "Output as JSON", false).option("--verbose", "Verbose logging", false).option("--store <path>", "Path to session store (default: resolved from config)").option("--agent <id>", "Agent id to inspect (default: configured default agent)").option("--all-agents", "Aggregate sessions across all configured agents", false).option("--active <minutes>", "Only show sessions updated within the past N minutes").addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
+		["remoteclaw sessions", "List all sessions."],
+		["remoteclaw sessions --agent work", "List sessions for one agent."],
+		["remoteclaw sessions --all-agents", "Aggregate sessions across agents."],
+		["remoteclaw sessions --active 120", "Only last 2 hours."],
+		["remoteclaw sessions --json", "Machine-readable output."],
+		["remoteclaw sessions --store ./tmp/sessions.json", "Use a specific session store."]
+	])}\n\n${theme.muted("Shows token usage per session when the agent reports it; set agents.defaults.contextTokens to cap the window and show %.")}`).addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/sessions", "docs.remoteclaw.org/cli/sessions")}\n`).action(async (opts) => {
+		setVerbose(Boolean(opts.verbose));
+		await sessionsCommand({
+			json: Boolean(opts.json),
+			store: opts.store,
+			agent: opts.agent,
+			allAgents: Boolean(opts.allAgents),
+			active: opts.active
+		}, defaultRuntime);
+	});
+	sessionsCmd.enablePositionalOptions();
+	sessionsCmd.command("cleanup").description("Run session-store maintenance now").option("--store <path>", "Path to session store (default: resolved from config)").option("--agent <id>", "Agent id to maintain (default: configured default agent)").option("--all-agents", "Run maintenance across all configured agents", false).option("--dry-run", "Preview maintenance actions without writing", false).option("--enforce", "Apply maintenance even when configured mode is warn", false).option("--active-key <key>", "Protect this session key from budget-eviction").option("--json", "Output JSON", false).addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
+		["remoteclaw sessions cleanup --dry-run", "Preview stale/cap cleanup."],
+		["remoteclaw sessions cleanup --enforce", "Apply maintenance now."],
+		["remoteclaw sessions cleanup --agent work --dry-run", "Preview one agent store."],
+		["remoteclaw sessions cleanup --all-agents --dry-run", "Preview all agent stores."],
+		["remoteclaw sessions cleanup --enforce --store ./tmp/sessions.json", "Use a specific store."]
+	])}`).action(async (opts, command) => {
+		const parentOpts = command.parent?.opts();
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await sessionsCleanupCommand({
+				store: opts.store ?? parentOpts?.store,
+				agent: opts.agent ?? parentOpts?.agent,
+				allAgents: Boolean(opts.allAgents || parentOpts?.allAgents),
+				dryRun: Boolean(opts.dryRun),
+				enforce: Boolean(opts.enforce),
+				activeKey: opts.activeKey,
+				json: Boolean(opts.json || parentOpts?.json)
+			}, defaultRuntime);
+		});
+	});
+}
+
+//#endregion
+export { registerStatusHealthSessionsCommands };