vora-ai 0.1.0

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

@@ -0,0 +1,705 @@
+import { r as setVerbose } from "./global-state-DUuMGgts.js";
+import { n as defaultRuntime, r as writeRuntimeJson } from "./runtime-D0VpiCHi.js";
+import { t as formatDocsLink } from "./links-Dew9XRNK.js";
+import { n as isRich, r as theme } from "./theme-BJIQPogA.js";
+import { n as info } from "./globals-DNhziPZz.js";
+import { c as loadConfig } from "./io-B07IaARR.js";
+import "./config-CKbWnj3S.js";
+import { f as capEntryCount, h as enforceSessionDiskBudget, m as resolveMaintenanceConfig, p as pruneStaleEntries, r as loadSessionStore, u as updateSessionStore } from "./store-DKzOIKqx.js";
+import "./sessions-zgiFsm1E.js";
+import { i as resolveSessionFilePathOptions, r as resolveSessionFilePath } from "./paths-dFp6bjkV.js";
+import { ft as cancelTaskById, ht as getTaskById, xt as updateTaskNotifyPolicyById } from "./vora-embedded-runner-CtRc9sK4.js";
+import { n as summarizeTaskRecords } from "./task-registry.summary-DxVk_l3y.js";
+import { n as runCommandWithRuntime } from "./cli-utils-CMfpS8SF.js";
+import { t as formatHelpExamples } from "./help-format-Dad85O74.js";
+import { n as parsePositiveIntOrUndefined } from "./helpers-4IKdDZX5.js";
+import { r as healthCommand } from "./health-B3O0HygG.js";
+import { a as reconcileInspectableTasks, c as runTaskRegistryMaintenance, f as listTaskAuditFindings, i as previewTaskRegistryMaintenance, n as getInspectableTaskRegistrySummary, o as reconcileTaskLookupToken, p as summarizeTaskAuditFindings, t as getInspectableTaskAuditSummary } from "./task-registry.maintenance-Bu37anXR.js";
+import { t as statusCommand } from "./status-BXjWA90V.js";
+import { a as formatSessionModelCell, c as toSessionDisplayRows, i as formatSessionKeyCell, l as resolveSessionStoreTargetsOrExit, n as formatSessionAgeCell, o as resolveSessionDisplayDefaults, r as formatSessionFlagsCell, s as resolveSessionDisplayModel, t as sessionsCommand } from "./sessions-BLL-TKEv.js";
+import fsSync from "node:fs";
+//#region src/commands/sessions-cleanup.ts
+const ACTION_PAD = 12;
+function resolveSessionCleanupAction(params) {
+	if (params.missingKeys.has(params.key)) return "prune-missing";
+	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-missing") return theme.error(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,
+			missingKeys: params.missingKeys,
+			staleKeys: params.staleKeys,
+			cappedKeys: params.cappedKeys,
+			budgetEvictedKeys: params.budgetEvictedKeys
+		})
+	}));
+}
+function pruneMissingTranscriptEntries(params) {
+	const sessionPathOpts = resolveSessionFilePathOptions({ storePath: params.storePath });
+	let removed = 0;
+	for (const [key, entry] of Object.entries(params.store)) {
+		if (!entry?.sessionId) continue;
+		const transcriptPath = resolveSessionFilePath(entry.sessionId, entry, sessionPathOpts);
+		if (!fsSync.existsSync(transcriptPath)) {
+			delete params.store[key];
+			removed += 1;
+			params.onPruned?.(key);
+		}
+	}
+	return removed;
+}
+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 missingKeys = /* @__PURE__ */ new Set();
+	const missing = params.fixMissing === true ? pruneMissingTranscriptEntries({
+		store: previewStore,
+		storePath: params.target.storePath,
+		onPruned: (key) => {
+			missingKeys.add(key);
+		}
+	}) : 0;
+	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 = missing > 0 || 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,
+			missing,
+			pruned,
+			capped,
+			diskBudget,
+			wouldMutate
+		},
+		actionRows: buildActionRows({
+			beforeStore,
+			staleKeys,
+			cappedKeys,
+			budgetEvictedKeys,
+			missingKeys
+		})
+	};
+}
+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 missing transcripts: ${params.summary.missing}`);
+	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(26),
+		"Age".padEnd(9),
+		"Model".padEnd(14),
+		"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;
+	const targets = resolveSessionStoreTargetsOrExit({
+		cfg,
+		opts: {
+			store: opts.store,
+			agent: opts.agent,
+			allAgents: opts.allAgents
+		},
+		runtime
+	});
+	if (!targets) return;
+	const previewResults = [];
+	for (const target of targets) {
+		const result = await previewStoreCleanup({
+			target,
+			mode,
+			dryRun: Boolean(opts.dryRun),
+			activeKey: opts.activeKey,
+			fixMissing: Boolean(opts.fixMissing)
+		});
+		previewResults.push(result);
+	}
+	if (opts.dryRun) {
+		if (opts.json) {
+			if (previewResults.length === 1) {
+				writeRuntimeJson(runtime, previewResults[0]?.summary ?? {});
+				return;
+			}
+			writeRuntimeJson(runtime, {
+				allAgents: true,
+				mode,
+				dryRun: true,
+				stores: previewResults.map((result) => result.summary)
+			});
+			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 };
+		const missingApplied = await updateSessionStore(target.storePath, async (store) => {
+			if (!opts.fixMissing) return 0;
+			return pruneMissingTranscriptEntries({
+				store,
+				storePath: target.storePath
+			});
+		}, {
+			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,
+				missing: 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,
+			missing: missingApplied,
+			pruned: appliedReport.pruned,
+			capped: appliedReport.capped,
+			diskBudget: appliedReport.diskBudget,
+			wouldMutate: missingApplied > 0 || 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) {
+			writeRuntimeJson(runtime, appliedSummaries[0] ?? {});
+			return;
+		}
+		writeRuntimeJson(runtime, {
+			allAgents: true,
+			mode,
+			dryRun: false,
+			stores: appliedSummaries
+		});
+		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/tasks.ts
+const RUNTIME_PAD = 8;
+const STATUS_PAD = 10;
+const DELIVERY_PAD = 14;
+const ID_PAD = 10;
+const RUN_PAD = 10;
+function truncate(value, maxChars) {
+	if (value.length <= maxChars) return value;
+	if (maxChars <= 1) return value.slice(0, maxChars);
+	return `${value.slice(0, maxChars - 1)}…`;
+}
+function shortToken(value, maxChars = ID_PAD) {
+	const trimmed = value?.trim();
+	if (!trimmed) return "n/a";
+	return truncate(trimmed, maxChars);
+}
+function formatTaskStatusCell(status, rich) {
+	const padded = status.padEnd(STATUS_PAD);
+	if (!rich) return padded;
+	if (status === "succeeded") return theme.success(padded);
+	if (status === "failed" || status === "lost" || status === "timed_out") return theme.error(padded);
+	if (status === "running") return theme.accentBright(padded);
+	return theme.muted(padded);
+}
+function formatTaskRows(tasks, rich) {
+	const header = [
+		"Task".padEnd(ID_PAD),
+		"Kind".padEnd(RUNTIME_PAD),
+		"Status".padEnd(STATUS_PAD),
+		"Delivery".padEnd(DELIVERY_PAD),
+		"Run".padEnd(RUN_PAD),
+		"Child Session",
+		"Summary"
+	].join(" ");
+	const lines = [rich ? theme.heading(header) : header];
+	for (const task of tasks) {
+		const summary = truncate(task.terminalSummary?.trim() || task.progressSummary?.trim() || task.label?.trim() || task.task.trim(), 80);
+		const line = [
+			shortToken(task.taskId).padEnd(ID_PAD),
+			task.runtime.padEnd(RUNTIME_PAD),
+			formatTaskStatusCell(task.status, rich),
+			task.deliveryStatus.padEnd(DELIVERY_PAD),
+			shortToken(task.runId, RUN_PAD).padEnd(RUN_PAD),
+			truncate(task.childSessionKey?.trim() || "n/a", 36).padEnd(36),
+			summary
+		].join(" ");
+		lines.push(line.trimEnd());
+	}
+	return lines;
+}
+function formatTaskListSummary(tasks) {
+	const summary = summarizeTaskRecords(tasks);
+	return `${summary.byStatus.queued} queued · ${summary.byStatus.running} running · ${summary.failures} issues`;
+}
+function formatAgeMs(ageMs) {
+	if (typeof ageMs !== "number" || ageMs < 1e3) return "fresh";
+	const totalSeconds = Math.floor(ageMs / 1e3);
+	const days = Math.floor(totalSeconds / 86400);
+	const hours = Math.floor(totalSeconds % 86400 / 3600);
+	const minutes = Math.floor(totalSeconds % 3600 / 60);
+	if (days > 0) return `${days}d${hours}h`;
+	if (hours > 0) return `${hours}h${minutes}m`;
+	if (minutes > 0) return `${minutes}m`;
+	return `${totalSeconds}s`;
+}
+function formatAuditRows(findings, rich) {
+	const header = [
+		"Severity".padEnd(8),
+		"Code".padEnd(22),
+		"Task".padEnd(ID_PAD),
+		"Status".padEnd(STATUS_PAD),
+		"Age".padEnd(8),
+		"Detail"
+	].join(" ");
+	const lines = [rich ? theme.heading(header) : header];
+	for (const finding of findings) {
+		const severity = finding.severity.padEnd(8);
+		const status = formatTaskStatusCell(finding.task.status, rich);
+		const severityCell = !rich ? severity : finding.severity === "error" ? theme.error(severity) : theme.warn(severity);
+		lines.push([
+			severityCell,
+			finding.code.padEnd(22),
+			shortToken(finding.task.taskId).padEnd(ID_PAD),
+			status,
+			formatAgeMs(finding.ageMs).padEnd(8),
+			truncate(finding.detail, 88)
+		].join(" ").trimEnd());
+	}
+	return lines;
+}
+async function tasksListCommand(opts, runtime) {
+	const runtimeFilter = opts.runtime?.trim();
+	const statusFilter = opts.status?.trim();
+	const tasks = reconcileInspectableTasks().filter((task) => {
+		if (runtimeFilter && task.runtime !== runtimeFilter) return false;
+		if (statusFilter && task.status !== statusFilter) return false;
+		return true;
+	});
+	if (opts.json) {
+		runtime.log(JSON.stringify({
+			count: tasks.length,
+			runtime: runtimeFilter ?? null,
+			status: statusFilter ?? null,
+			tasks
+		}, null, 2));
+		return;
+	}
+	runtime.log(info(`Background tasks: ${tasks.length}`));
+	runtime.log(info(`Task pressure: ${formatTaskListSummary(tasks)}`));
+	if (runtimeFilter) runtime.log(info(`Runtime filter: ${runtimeFilter}`));
+	if (statusFilter) runtime.log(info(`Status filter: ${statusFilter}`));
+	if (tasks.length === 0) {
+		runtime.log("No background tasks found.");
+		return;
+	}
+	const rich = isRich();
+	for (const line of formatTaskRows(tasks, rich)) runtime.log(line);
+}
+async function tasksShowCommand(opts, runtime) {
+	const task = reconcileTaskLookupToken(opts.lookup);
+	if (!task) {
+		runtime.error(`Task not found: ${opts.lookup}`);
+		runtime.exit(1);
+		return;
+	}
+	if (opts.json) {
+		runtime.log(JSON.stringify(task, null, 2));
+		return;
+	}
+	const lines = [
+		"Background task:",
+		`taskId: ${task.taskId}`,
+		`kind: ${task.runtime}`,
+		`sourceId: ${task.sourceId ?? "n/a"}`,
+		`status: ${task.status}`,
+		`result: ${task.terminalOutcome ?? "n/a"}`,
+		`delivery: ${task.deliveryStatus}`,
+		`notify: ${task.notifyPolicy}`,
+		`ownerKey: ${task.ownerKey}`,
+		`childSessionKey: ${task.childSessionKey ?? "n/a"}`,
+		`parentTaskId: ${task.parentTaskId ?? "n/a"}`,
+		`agentId: ${task.agentId ?? "n/a"}`,
+		`runId: ${task.runId ?? "n/a"}`,
+		`label: ${task.label ?? "n/a"}`,
+		`task: ${task.task}`,
+		`createdAt: ${new Date(task.createdAt).toISOString()}`,
+		`startedAt: ${task.startedAt ? new Date(task.startedAt).toISOString() : "n/a"}`,
+		`endedAt: ${task.endedAt ? new Date(task.endedAt).toISOString() : "n/a"}`,
+		`lastEventAt: ${task.lastEventAt ? new Date(task.lastEventAt).toISOString() : "n/a"}`,
+		`cleanupAfter: ${task.cleanupAfter ? new Date(task.cleanupAfter).toISOString() : "n/a"}`,
+		...task.error ? [`error: ${task.error}`] : [],
+		...task.progressSummary ? [`progressSummary: ${task.progressSummary}`] : [],
+		...task.terminalSummary ? [`terminalSummary: ${task.terminalSummary}`] : []
+	];
+	for (const line of lines) runtime.log(line);
+}
+async function tasksNotifyCommand(opts, runtime) {
+	const task = reconcileTaskLookupToken(opts.lookup);
+	if (!task) {
+		runtime.error(`Task not found: ${opts.lookup}`);
+		runtime.exit(1);
+		return;
+	}
+	const updated = updateTaskNotifyPolicyById({
+		taskId: task.taskId,
+		notifyPolicy: opts.notify
+	});
+	if (!updated) {
+		runtime.error(`Task not found: ${opts.lookup}`);
+		runtime.exit(1);
+		return;
+	}
+	runtime.log(`Updated ${updated.taskId} notify policy to ${updated.notifyPolicy}.`);
+}
+async function tasksCancelCommand(opts, runtime) {
+	const task = reconcileTaskLookupToken(opts.lookup);
+	if (!task) {
+		runtime.error(`Task not found: ${opts.lookup}`);
+		runtime.exit(1);
+		return;
+	}
+	const result = await cancelTaskById({
+		cfg: loadConfig(),
+		taskId: task.taskId
+	});
+	if (!result.found) {
+		runtime.error(result.reason ?? `Task not found: ${opts.lookup}`);
+		runtime.exit(1);
+		return;
+	}
+	if (!result.cancelled) {
+		runtime.error(result.reason ?? `Could not cancel task: ${opts.lookup}`);
+		runtime.exit(1);
+		return;
+	}
+	const updated = getTaskById(task.taskId);
+	runtime.log(`Cancelled ${updated?.taskId ?? task.taskId} (${updated?.runtime ?? task.runtime})${updated?.runId ? ` run ${updated.runId}` : ""}.`);
+}
+async function tasksAuditCommand(opts, runtime) {
+	const severityFilter = opts.severity?.trim();
+	const codeFilter = opts.code?.trim();
+	const allFindings = listTaskAuditFindings();
+	const findings = allFindings.filter((finding) => {
+		if (severityFilter && finding.severity !== severityFilter) return false;
+		if (codeFilter && finding.code !== codeFilter) return false;
+		return true;
+	});
+	const limit = typeof opts.limit === "number" && opts.limit > 0 ? opts.limit : void 0;
+	const displayed = limit ? findings.slice(0, limit) : findings;
+	const summary = summarizeTaskAuditFindings(allFindings);
+	if (opts.json) {
+		runtime.log(JSON.stringify({
+			count: allFindings.length,
+			filteredCount: findings.length,
+			displayed: displayed.length,
+			filters: {
+				severity: severityFilter ?? null,
+				code: codeFilter ?? null,
+				limit: limit ?? null
+			},
+			summary,
+			findings: displayed
+		}, null, 2));
+		return;
+	}
+	runtime.log(info(`Task audit: ${summary.total} findings · ${summary.errors} errors · ${summary.warnings} warnings`));
+	if (severityFilter || codeFilter) runtime.log(info(`Showing ${findings.length} matching findings.`));
+	if (severityFilter) runtime.log(info(`Severity filter: ${severityFilter}`));
+	if (codeFilter) runtime.log(info(`Code filter: ${codeFilter}`));
+	if (limit) runtime.log(info(`Limit: ${limit}`));
+	if (displayed.length === 0) {
+		runtime.log("No task audit findings.");
+		return;
+	}
+	const rich = isRich();
+	for (const line of formatAuditRows(displayed, rich)) runtime.log(line);
+}
+async function tasksMaintenanceCommand(opts, runtime) {
+	const auditBefore = getInspectableTaskAuditSummary();
+	const maintenance = opts.apply ? runTaskRegistryMaintenance() : previewTaskRegistryMaintenance();
+	const summary = getInspectableTaskRegistrySummary();
+	const auditAfter = opts.apply ? getInspectableTaskAuditSummary() : auditBefore;
+	if (opts.json) {
+		runtime.log(JSON.stringify({
+			mode: opts.apply ? "apply" : "preview",
+			maintenance,
+			tasks: summary,
+			auditBefore,
+			auditAfter
+		}, null, 2));
+		return;
+	}
+	runtime.log(info(`Task maintenance (${opts.apply ? "applied" : "preview"}): ${maintenance.reconciled} reconcile · ${maintenance.cleanupStamped} cleanup stamp · ${maintenance.pruned} prune`));
+	runtime.log(info(`${opts.apply ? "Task health after apply" : "Task health"}: ${summary.byStatus.queued} queued · ${summary.byStatus.running} running · ${auditAfter.errors} audit errors · ${auditAfter.warnings} audit warnings`));
+	if (opts.apply) runtime.log(info(`Task health before apply: ${auditBefore.errors} audit errors · ${auditBefore.warnings} audit warnings`));
+	if (!opts.apply) runtime.log("Dry run only. Re-run with `vora tasks maintenance --apply` to write changes.");
+}
+//#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([
+		["vora status", "Show channel health + session summary."],
+		["vora status --all", "Full diagnosis (read-only)."],
+		["vora status --json", "Machine-readable output."],
+		["vora status --usage", "Show model provider usage/quota snapshots."],
+		["vora status --deep", "Run channel probes (WA + Telegram + Discord + Slack + Signal)."],
+		["vora status --deep --timeout 5000", "Tighten probe timeout."]
+	])}`).addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/status", "docs.vora.ai/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.vora.ai/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([
+		["vora sessions", "List all sessions."],
+		["vora sessions --agent work", "List sessions for one agent."],
+		["vora sessions --all-agents", "Aggregate sessions across agents."],
+		["vora sessions --active 120", "Only last 2 hours."],
+		["vora sessions --json", "Machine-readable output."],
+		["vora 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.vora.ai/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("--fix-missing", "Remove store entries whose transcript files are missing (bypasses age/count retention)", 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([
+		["vora sessions cleanup --dry-run", "Preview stale/cap cleanup."],
+		["vora sessions cleanup --dry-run --fix-missing", "Also preview pruning entries with missing transcript files."],
+		["vora sessions cleanup --enforce", "Apply maintenance now."],
+		["vora sessions cleanup --agent work --dry-run", "Preview one agent store."],
+		["vora sessions cleanup --all-agents --dry-run", "Preview all agent stores."],
+		["vora 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),
+				fixMissing: Boolean(opts.fixMissing),
+				activeKey: opts.activeKey,
+				json: Boolean(opts.json || parentOpts?.json)
+			}, defaultRuntime);
+		});
+	});
+	const tasksCmd = program.command("tasks").description("Inspect durable background task state").option("--json", "Output as JSON", false).option("--runtime <name>", "Filter by kind (subagent, acp, cron, cli)").option("--status <name>", "Filter by status (queued, running, succeeded, failed, timed_out, cancelled, lost)").action(async (opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksListCommand({
+				json: Boolean(opts.json),
+				runtime: opts.runtime,
+				status: opts.status
+			}, defaultRuntime);
+		});
+	});
+	tasksCmd.enablePositionalOptions();
+	tasksCmd.command("list").description("List tracked background tasks").option("--json", "Output as JSON", false).option("--runtime <name>", "Filter by kind (subagent, acp, cron, cli)").option("--status <name>", "Filter by status (queued, running, succeeded, failed, timed_out, cancelled, lost)").action(async (opts, command) => {
+		const parentOpts = command.parent?.opts();
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksListCommand({
+				json: Boolean(opts.json || parentOpts?.json),
+				runtime: opts.runtime ?? parentOpts?.runtime,
+				status: opts.status ?? parentOpts?.status
+			}, defaultRuntime);
+		});
+	});
+	tasksCmd.command("audit").description("Show stale or broken background task runs").option("--json", "Output as JSON", false).option("--severity <level>", "Filter by severity (warn, error)").option("--code <name>", "Filter by finding code (stale_queued, stale_running, lost, delivery_failed, missing_cleanup, inconsistent_timestamps)").option("--limit <n>", "Limit displayed findings").action(async (opts, command) => {
+		const parentOpts = command.parent?.opts();
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksAuditCommand({
+				json: Boolean(opts.json || parentOpts?.json),
+				severity: opts.severity,
+				code: opts.code,
+				limit: parsePositiveIntOrUndefined(opts.limit)
+			}, defaultRuntime);
+		});
+	});
+	tasksCmd.command("maintenance").description("Preview or apply task ledger maintenance").option("--json", "Output as JSON", false).option("--apply", "Apply reconciliation, cleanup stamping, and pruning", false).action(async (opts, command) => {
+		const parentOpts = command.parent?.opts();
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksMaintenanceCommand({
+				json: Boolean(opts.json || parentOpts?.json),
+				apply: Boolean(opts.apply)
+			}, defaultRuntime);
+		});
+	});
+	tasksCmd.command("show").description("Show one background task by task id, run id, or session key").argument("<lookup>", "Task id, run id, or session key").option("--json", "Output as JSON", false).action(async (lookup, opts, command) => {
+		const parentOpts = command.parent?.opts();
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksShowCommand({
+				lookup,
+				json: Boolean(opts.json || parentOpts?.json)
+			}, defaultRuntime);
+		});
+	});
+	tasksCmd.command("notify").description("Set task notify policy").argument("<lookup>", "Task id, run id, or session key").argument("<notify>", "Notify policy (done_only, state_changes, silent)").action(async (lookup, notify) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksNotifyCommand({
+				lookup,
+				notify
+			}, defaultRuntime);
+		});
+	});
+	tasksCmd.command("cancel").description("Cancel a running background task").argument("<lookup>", "Task id, run id, or session key").action(async (lookup) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await tasksCancelCommand({ lookup }, defaultRuntime);
+		});
+	});
+}
+//#endregion
+export { registerStatusHealthSessionsCommands };