remoteclaw 0.1.0-next.2abd2fa → 0.1.0-next.2e9a6cd

package/dist/register.status-health-sessions-z9x79dmg.js

@@ -0,0 +1,665 @@
+import "./paths-BTaH3rLn.js";
+import { E as info, I as isRich, L as theme, j as setVerbose } from "./utils-C5daYcFn.js";
+import "./reply-CTgksTO1.js";
+import "./subsystem-BgxIzx7w.js";
+import { n as defaultRuntime } from "./runtime-Ds3E9SqF.js";
+import "./ansi-aRwLYlzD.js";
+import { C as parseAgentSessionKey, s as normalizeAgentId } from "./session-key-C2n-VILA.js";
+import { c as resolveDefaultAgentId, n as listAgentIds } from "./agent-scope-BrDeaWWf.js";
+import "./subagent-registry-DWL-tayF.js";
+import "./message-channel-DF4I2vOK.js";
+import "./targets-DTM2OPnS.js";
+import { i as loadConfig } from "./config-CHDaGquZ.js";
+import "./env-DUb5GiQe.js";
+import "./host-env-security-Bms2_EMV.js";
+import "./shell-env-CsV_IkJj.js";
+import "./env-vars-CLGbxdpL.js";
+import "./zod-schema-D3hQ5SKe.js";
+import "./dock-D038fZZl.js";
+import "./runner-DOWTBU0-.js";
+import "./logger-BtwpYD7c.js";
+import "./ip-BAhS4rY2.js";
+import "./ssrf-B-rF_tZB.js";
+import "./local-roots-BfXsZRkm.js";
+import "./exec-BhkXWg7V.js";
+import "./tool-images-D16vIWPg.js";
+import "./redact-gXuh8MFk.js";
+import "./errors-CdmXrBic.js";
+import "./mime-Cqg1jjia.js";
+import "./auth-CVfoI--S.js";
+import "./file-lock-6NXMPZTT.js";
+import "./plugins-D6-JJ1il.js";
+import "./accounts-A8jZK_v9.js";
+import "./accounts-BegPt5VR.js";
+import "./accounts-BmiimLpP.js";
+import "./bindings-B6icMMUx.js";
+import "./tokens-7ZtWRjA3.js";
+import "./reply-payloads-te0YnESs.js";
+import "./targets-yq1kGK1_.js";
+import "./commands-DFHMoQgH.js";
+import "./commands-registry-DbS9NHeX.js";
+import "./pairing-store-ONzqxcNb.js";
+import "./fetch-CCuD0LYV.js";
+import "./retry-BcZuGfnV.js";
+import "./client-C7B0uFB0.js";
+import { m as resolveStorePath } from "./chat-envelope-BEDutlnF.js";
+import { A as enforceSessionDiskBudget, G as resolveFreshSessionTotalTokens, l as updateSessionStore, n as loadSessionStore, o as resolveMaintenanceConfig, r as pruneStaleEntries, t as capEntryCount } from "./store-Dv76bGHg.js";
+import "./strip-inbound-meta-BNXRYvmY.js";
+import { n as formatTimeAgo } from "./format-relative-CZOlQ2pA.js";
+import "./audio-BbCUzndz.js";
+import "./call-D5YKTYSM.js";
+import "./net-COL170MG.js";
+import "./tailnet-BoTa0e2q.js";
+import "./lanes-COs3zODW.js";
+import "./response-prefix-template-D-ptXREi.js";
+import "./agent-helpers-KHUla1K7.js";
+import "./image-ops-DMl7j7f4.js";
+import "./tool-display-AxpSXZVq.js";
+import "./channel-activity-CwiF_QMr.js";
+import "./send-BTupAHVX.js";
+import "./fs-safe-93aDW4mH.js";
+import "./ir-CnMQRFBu.js";
+import "./chunk-C1mQSjas.js";
+import "./markdown-tables-xMuH3QnS.js";
+import "./render-e7fENCYH.js";
+import "./tables-Cy3gObW7.js";
+import "./session-cost-usage-BYCI739a.js";
+import "./common-DHHHAcmR.js";
+import "./reply-directives-Caq4zVTg.js";
+import "./store-BLGrRL_E.js";
+import "./prompt-edYTUtju.js";
+import "./binaries-DbgLoSWv.js";
+import "./ports-dEePqmCq.js";
+import { n as parsePositiveIntOrUndefined } from "./helpers-BJtPtu_2.js";
+import "./send-qpwqt34s.js";
+import "./deliver-D8P9_nk-.js";
+import "./outbound-attachment-CbNLn0lk.js";
+import "./delivery-queue-B6TuHppj.js";
+import "./onboard-helpers-BHNXyhA4.js";
+import "./prompt-style-CYEpbwXH.js";
+import { t as formatDocsLink } from "./links-CIHbVNO_.js";
+import "./control-auth-BFbDXKLK.js";
+import "./tailscale-Driw3j8E.js";
+import "./auth-VItd2pwK.js";
+import "./dangerous-tools-BMt8-6jE.js";
+import "./progress-DQ1drugY.js";
+import { t as runCommandWithRuntime } from "./cli-utils-C5nQDfa6.js";
+import { t as formatHelpExamples } from "./help-format-Ch0EWh7N.js";
+import "./channels-status-issues-DXyOO-KH.js";
+import "./systemd-DzXePo7r.js";
+import "./service-Os7W1F2S.js";
+import "./diagnostics-CK2HGAFw.js";
+import "./table-V_9n7CjP.js";
+import "./audit-g55SYz1m.js";
+import { t as statusCommand } from "./status-RI2y_M21.js";
+import { r as healthCommand } from "./health-BCidscV-.js";
+import "./channel-account-context-CA2m93Kt.js";
+import { l as resolveSessionModelRef, n as classifySessionKey } from "./session-utils-BgWDCbyx.js";
+import "./dm-policy-shared-1FdjwGtJ.js";
+import "./status.update-DbO7izip.js";
+
+//#region src/commands/session-store-targets.ts
+function dedupeTargetsByStorePath(targets) {
+	const deduped = /* @__PURE__ */ new Map();
+	for (const target of targets) if (!deduped.has(target.storePath)) deduped.set(target.storePath, target);
+	return [...deduped.values()];
+}
+function resolveSessionStoreTargets(cfg, opts) {
+	const defaultAgentId = resolveDefaultAgentId(cfg);
+	const hasAgent = Boolean(opts.agent?.trim());
+	const allAgents = opts.allAgents === true;
+	if (hasAgent && allAgents) throw new Error("--agent and --all-agents cannot be used together");
+	if (opts.store && (hasAgent || allAgents)) throw new Error("--store cannot be combined with --agent or --all-agents");
+	if (opts.store) return [{
+		agentId: defaultAgentId,
+		storePath: resolveStorePath(opts.store, { agentId: defaultAgentId })
+	}];
+	if (allAgents) return dedupeTargetsByStorePath(listAgentIds(cfg).map((agentId) => ({
+		agentId,
+		storePath: resolveStorePath(cfg.session?.store, { agentId })
+	})));
+	if (hasAgent) {
+		const knownAgents = listAgentIds(cfg);
+		const requested = normalizeAgentId(opts.agent ?? "");
+		if (!knownAgents.includes(requested)) throw new Error(`Unknown agent id "${opts.agent}". Use "remoteclaw agents list" to see configured agents.`);
+		return [{
+			agentId: requested,
+			storePath: resolveStorePath(cfg.session?.store, { agentId: requested })
+		}];
+	}
+	return [{
+		agentId: defaultAgentId,
+		storePath: resolveStorePath(cfg.session?.store, { agentId: defaultAgentId })
+	}];
+}
+
+//#endregion
+//#region src/commands/sessions-table.ts
+const SESSION_KEY_PAD = 26;
+const SESSION_AGE_PAD = 9;
+const SESSION_MODEL_PAD = 14;
+function toSessionDisplayRows(store) {
+	return Object.entries(store).map(([key, entry]) => {
+		const updatedAt = entry?.updatedAt ?? null;
+		return {
+			key,
+			updatedAt,
+			ageMs: updatedAt ? Date.now() - updatedAt : null,
+			sessionId: entry?.sessionId,
+			systemSent: entry?.systemSent,
+			abortedLastRun: entry?.abortedLastRun,
+			verboseLevel: entry?.verboseLevel,
+			elevatedLevel: entry?.elevatedLevel,
+			responseUsage: entry?.responseUsage,
+			groupActivation: entry?.groupActivation,
+			inputTokens: entry?.inputTokens,
+			outputTokens: entry?.outputTokens,
+			totalTokens: entry?.totalTokens,
+			totalTokensFresh: entry?.totalTokensFresh,
+			model: entry?.model,
+			modelProvider: entry?.modelProvider,
+			providerOverride: entry?.providerOverride,
+			modelOverride: entry?.modelOverride,
+			contextTokens: entry?.contextTokens
+		};
+	}).toSorted((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
+}
+function resolveSessionDisplayDefaults(_cfg) {
+	return { model: "unknown" };
+}
+function resolveSessionDisplayModel(cfg, row, defaults) {
+	return resolveSessionModelRef(cfg, row, parseAgentSessionKey(row.key)?.agentId).model ?? defaults.model;
+}
+function truncateSessionKey(key) {
+	if (key.length <= SESSION_KEY_PAD) return key;
+	const head = Math.max(4, SESSION_KEY_PAD - 10);
+	return `${key.slice(0, head)}...${key.slice(-6)}`;
+}
+function formatSessionKeyCell(key, rich) {
+	const label = truncateSessionKey(key).padEnd(SESSION_KEY_PAD);
+	return rich ? theme.accent(label) : label;
+}
+function formatSessionAgeCell(updatedAt, rich) {
+	const padded = (updatedAt ? formatTimeAgo(Date.now() - updatedAt) : "unknown").padEnd(SESSION_AGE_PAD);
+	return rich ? theme.muted(padded) : padded;
+}
+function formatSessionModelCell(model, rich) {
+	const label = (model ?? "unknown").padEnd(SESSION_MODEL_PAD);
+	return rich ? theme.info(label) : label;
+}
+function formatSessionFlagsCell(row, rich) {
+	const label = [
+		row.verboseLevel ? `verbose:${row.verboseLevel}` : null,
+		row.elevatedLevel ? `elev:${row.elevatedLevel}` : null,
+		row.responseUsage ? `usage:${row.responseUsage}` : null,
+		row.groupActivation ? `activation:${row.groupActivation}` : null,
+		row.systemSent ? "system" : null,
+		row.abortedLastRun ? "aborted" : null,
+		row.sessionId ? `id:${row.sessionId}` : null
+	].filter(Boolean).join(" ");
+	return label.length === 0 ? "" : rich ? theme.muted(label) : label;
+}
+
+//#endregion
+//#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/commands/sessions.ts
+const AGENT_PAD = 10;
+const KIND_PAD = 6;
+const TOKENS_PAD = 20;
+const formatKTokens = (value) => `${(value / 1e3).toFixed(value >= 1e4 ? 0 : 1)}k`;
+const colorByPct = (label, pct, rich) => {
+	if (!rich || pct === null) return label;
+	if (pct >= 95) return theme.error(label);
+	if (pct >= 80) return theme.warn(label);
+	if (pct >= 60) return theme.success(label);
+	return theme.muted(label);
+};
+const formatTokensCell = (total, contextTokens, rich) => {
+	if (total === void 0) {
+		const label = `unknown/${contextTokens ? formatKTokens(contextTokens) : "?"} (?%)`;
+		return rich ? theme.muted(label.padEnd(TOKENS_PAD)) : label.padEnd(TOKENS_PAD);
+	}
+	const totalLabel = formatKTokens(total);
+	const ctxLabel = contextTokens ? formatKTokens(contextTokens) : "?";
+	const pct = contextTokens ? Math.min(999, Math.round(total / contextTokens * 100)) : null;
+	return colorByPct(`${totalLabel}/${ctxLabel} (${pct ?? "?"}%)`.padEnd(TOKENS_PAD), pct, rich);
+};
+const formatKindCell = (kind, rich) => {
+	const label = kind.padEnd(KIND_PAD);
+	if (!rich) return label;
+	if (kind === "group") return theme.accentBright(label);
+	if (kind === "global") return theme.warn(label);
+	if (kind === "direct") return theme.accent(label);
+	return theme.muted(label);
+};
+async function sessionsCommand(opts, runtime) {
+	const aggregateAgents = opts.allAgents === true;
+	const cfg = loadConfig();
+	const displayDefaults = resolveSessionDisplayDefaults(cfg);
+	const configContextTokens = cfg.agents?.defaults?.contextTokens ?? 2e5;
+	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;
+	}
+	let activeMinutes;
+	if (opts.active !== void 0) {
+		const parsed = Number.parseInt(String(opts.active), 10);
+		if (Number.isNaN(parsed) || parsed <= 0) {
+			runtime.error("--active must be a positive integer (minutes)");
+			runtime.exit(1);
+			return;
+		}
+		activeMinutes = parsed;
+	}
+	const rows = targets.flatMap((target) => {
+		const store = loadSessionStore(target.storePath);
+		return toSessionDisplayRows(store).map((row) => ({
+			...row,
+			agentId: parseAgentSessionKey(row.key)?.agentId ?? target.agentId,
+			kind: classifySessionKey(row.key, store[row.key])
+		}));
+	}).filter((row) => {
+		if (activeMinutes === void 0) return true;
+		if (!row.updatedAt) return false;
+		return Date.now() - row.updatedAt <= activeMinutes * 6e4;
+	}).toSorted((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
+	if (opts.json) {
+		const multi = targets.length > 1;
+		const aggregate = aggregateAgents || multi;
+		runtime.log(JSON.stringify({
+			path: aggregate ? null : targets[0]?.storePath ?? null,
+			stores: aggregate ? targets.map((target) => ({
+				agentId: target.agentId,
+				path: target.storePath
+			})) : void 0,
+			allAgents: aggregateAgents ? true : void 0,
+			count: rows.length,
+			activeMinutes: activeMinutes ?? null,
+			sessions: rows.map((r) => {
+				const model = resolveSessionDisplayModel(cfg, r, displayDefaults);
+				return {
+					...r,
+					totalTokens: resolveFreshSessionTotalTokens(r) ?? null,
+					totalTokensFresh: typeof r.totalTokens === "number" ? r.totalTokensFresh !== false : false,
+					contextTokens: r.contextTokens ?? configContextTokens ?? null,
+					model
+				};
+			})
+		}, null, 2));
+		return;
+	}
+	if (targets.length === 1 && !aggregateAgents) runtime.log(info(`Session store: ${targets[0]?.storePath}`));
+	else runtime.log(info(`Session stores: ${targets.length} (${targets.map((t) => t.agentId).join(", ")})`));
+	runtime.log(info(`Sessions listed: ${rows.length}`));
+	if (activeMinutes) runtime.log(info(`Filtered to last ${activeMinutes} minute(s)`));
+	if (rows.length === 0) {
+		runtime.log("No sessions found.");
+		return;
+	}
+	const rich = isRich();
+	const showAgentColumn = aggregateAgents || targets.length > 1;
+	const header = [
+		...showAgentColumn ? ["Agent".padEnd(AGENT_PAD)] : [],
+		"Kind".padEnd(KIND_PAD),
+		"Key".padEnd(SESSION_KEY_PAD),
+		"Age".padEnd(SESSION_AGE_PAD),
+		"Model".padEnd(SESSION_MODEL_PAD),
+		"Tokens (ctx %)".padEnd(TOKENS_PAD),
+		"Flags"
+	].join(" ");
+	runtime.log(rich ? theme.heading(header) : header);
+	for (const row of rows) {
+		const model = resolveSessionDisplayModel(cfg, row, displayDefaults);
+		const contextTokens = row.contextTokens ?? configContextTokens;
+		const total = resolveFreshSessionTotalTokens(row);
+		const line = [
+			...showAgentColumn ? [rich ? theme.accentBright(row.agentId.padEnd(AGENT_PAD)) : row.agentId.padEnd(AGENT_PAD)] : [],
+			formatKindCell(row.kind, rich),
+			formatSessionKeyCell(row.key, rich),
+			formatSessionAgeCell(row.updatedAt, rich),
+			formatSessionModelCell(model, rich),
+			formatTokensCell(total, contextTokens ?? null, rich),
+			formatSessionFlagsCell(row, rich)
+		].join(" ");
+		runtime.log(line.trimEnd());
+	}
+}
+
+//#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 };