agent-yes 1.127.2 → 1.129.0

package/dist/SUPPORTED_CLIS-BEGaVwg2.js

@@ -0,0 +1,8 @@
+import "./ts-D21pYxoi.js";
+import "./logger-B9h0djqx.js";
+import "./versionChecker-VKD48fzV.js";
+import "./pidStore-CGKIhaJO.js";
+import "./globalPidIndex-C7r2m6s7.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CRiTrZVs.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-CJzJB2Ov.js → SUPPORTED_CLIS-CRiTrZVs.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-CRNaIrcV.js";
+import { t as CLIS_CONFIG } from "./ts-D21pYxoi.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-CJzJB2Ov.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-CRiTrZVs.js.map

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { n as logger } from "./logger-B9h0djqx.js";
-import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-CY79Ce_C.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-VKD48fzV.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -482,7 +482,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 {
 	const rawArg = process.argv[2];
 	const isHelpFlag = rawArg === "-h" || rawArg === "--help";
-	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-BPz3ie1B.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-BLUX23IJ.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp();
 		process.exit(0);
@@ -515,7 +515,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BQ95wXgT.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BEGaVwg2.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-CRNaIrcV.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-D21pYxoi.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-CY79Ce_C.js";
+import "./versionChecker-VKD48fzV.js";
 import "./pidStore-CGKIhaJO.js";
 import "./globalPidIndex-C7r2m6s7.js";
 

package/dist/{schedule-BCS2rT7U.js → schedule-QakndFJf.js}

@@ -1,9 +1,9 @@
-import "./ts-CRNaIrcV.js";
+import "./ts-D21pYxoi.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-CY79Ce_C.js";
+import "./versionChecker-VKD48fzV.js";
 import "./pidStore-CGKIhaJO.js";
 import "./globalPidIndex-C7r2m6s7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CJzJB2Ov.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CRiTrZVs.js";
 import { n as resolveSpawnCwd } from "./workspaceConfig-BJO4fzEn.js";
 import { createHash } from "node:crypto";
 
@@ -141,4 +141,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-BCS2rT7U.js.map
+//# sourceMappingURL=schedule-QakndFJf.js.map

package/dist/{serve-vyKtlci4.js → serve-DpBmExxp.js}

@@ -1,13 +1,13 @@
-import "./ts-CRNaIrcV.js";
+import "./ts-D21pYxoi.js";
 import "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-CY79Ce_C.js";
+import { r as getInstalledPackage } from "./versionChecker-VKD48fzV.js";
 import "./pidStore-CGKIhaJO.js";
 import { a as updateGlobalPidStatus } from "./globalPidIndex-C7r2m6s7.js";
 import { t as pgidForWrapper } from "./reaper-BkjPN7mw.js";
 import "./configShared-C5QaNPnz.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CJzJB2Ov.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CRiTrZVs.js";
 import "./remotes-D8GvSbhf.js";
-import { f as readNotes, g as snapshotStatus, m as resolveOne, o as extractTaskCounts, p as renderRawLog, r as controlCodeFromName, u as listRecords, v as writeToIpc } from "./subcommands-DlWWdnWv.js";
+import { d as listRecords, g as resolveOne, i as controlCodeFromName, m as renderRawLog, p as readNotes, s as extractTaskCounts, x as writeToIpc, y as snapshotStatus } from "./subcommands-D1floyWA.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -208,6 +208,18 @@ function portFromArgs(args) {
 	const m = /--port[=\s](\d+)/.exec(args.join(" "));
 	return m ? Number(m[1]) : DEFAULT_PORT;
 }
+function explicitWebrtcUrl(args) {
+	for (let i = 0; i < args.length; i++) {
+		const a = args[i];
+		for (const flag of ["--webrtc", "--share"]) {
+			if (a === flag && args[i + 1]?.startsWith("webrtc://")) return args[i + 1];
+			if (a.startsWith(`${flag}=`)) {
+				const v = a.slice(flag.length + 1);
+				if (v.startsWith("webrtc://")) return v;
+			}
+		}
+	}
+}
 async function fetchDaemonVersion(port, token) {
 	try {
 		const r = await fetch(`http://127.0.0.1:${port}/api/version`, {
@@ -231,14 +243,30 @@ async function cmdServeDaemon(sub, args) {
 		const priorArgs = await readDaemonServeArgs(mgr);
 		const effArgs = args.length ? args : priorArgs ?? [];
 		const current = getInstalledPackage().version;
+		const webrtcDaemon = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
+		let shareLink = null;
+		let shareLinkMinted = false;
+		if (webrtcDaemon) try {
+			const { loadOrCreateShareRoom, shareLinkFromRoomUrl } = await import("./share-Cvb0PBKg.js");
+			const explicit = explicitWebrtcUrl(effArgs);
+			shareLink = shareLinkFromRoomUrl(explicit ?? await loadOrCreateShareRoom());
+			shareLinkMinted = !explicit;
+		} catch {}
+		const emitShareLink = () => {
+			if (!webrtcDaemon) return;
+			if (shareLink) process.stdout.write(`\nshared over WebRTC — open this link (the token is eaten from the URL on open):\n  ${shareLink}\n` + (shareLinkMinted ? `  (persistent room — same link across restarts; delete ~/.agent-yes/.share-room to rotate)\n` : ``));
+			else process.stdout.write("\nthe WebRTC share link carries a secret, so the daemon does NOT log it —\nread it from ~/.agent-yes/.share-link (mode 0600). The room persists in\n~/.agent-yes/.share-room, so the link survives restarts.\n");
+		};
 		if (priorArgs !== null) {
+			const sameConfig = JSON.stringify(effArgs) === JSON.stringify(priorArgs);
 			const runningVer = await fetchDaemonVersion(portFromArgs(effArgs), token);
-			if (runningVer === current) {
+			if (runningVer === current && sameConfig) {
 				await ensureBootAutostart(mgr);
 				process.stdout.write(`'${DAEMON_NAME}' already running v${current} (up to date)\n`);
+				emitShareLink();
 				return 0;
 			}
-			process.stdout.write(`rolling '${DAEMON_NAME}' ${runningVer ? `v${runningVer}` : "(unknown)"} → v${current}…\n`);
+			process.stdout.write(runningVer === current ? `reconfiguring '${DAEMON_NAME}' (serve args changed)…\n` : `rolling '${DAEMON_NAME}' ${runningVer ? `v${runningVer}` : "(unknown)"} → v${current}…\n`);
 			await spawnExit([
 				mgr.bin,
 				"stop",
@@ -251,7 +279,7 @@ async function cmdServeDaemon(sub, args) {
 			]);
 		}
 		const serveArgv = ayServeArgv(effArgs);
-		const oxmgrHealth = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share")) && mgr.id === "oxmgr" ? [
+		const oxmgrHealth = webrtcDaemon && mgr.id === "oxmgr" ? [
 			"--health-cmd",
 			ayServeArgv(["healthcheck"]).join(" "),
 			"--health-interval",
@@ -291,7 +319,6 @@ async function cmdServeDaemon(sub, args) {
 		if (code === 0) {
 			const onBoot = await ensureBootAutostart(mgr);
 			const port = portFromArgs(effArgs);
-			const webrtcish = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
 			const httpish = effArgs.some((a) => a.startsWith("--http") || a.startsWith("--share")) || !effArgs.some((a) => a.startsWith("--webrtc"));
 			process.stdout.write(`\n${priorArgs !== null ? `rolled '${DAEMON_NAME}' forward to` : `installed '${DAEMON_NAME}' as a daemon via ${mgr.id} —`} v${current}\n`);
 			if (mgr.id === "oxmgr") process.stdout.write(onBoot ? `start-on-boot: enabled (systemd --user + linger, starts at boot)\n` : `start-on-boot: not registered — needs a user systemd session; run \`oxmgr service install\` to enable\n`);
@@ -304,7 +331,7 @@ async function cmdServeDaemon(sub, args) {
 			}
 			process.stdout.write(`  ay serve logs                # view server logs\n`);
 			process.stdout.write(`  ay serve uninstall           # remove daemon\n`);
-			if (webrtcish) process.stdout.write("\nthe WebRTC share link carries a secret, so the daemon does NOT log it —\nread it from ~/.agent-yes/.share-link (mode 0600). The room persists in\n~/.agent-yes/.share-room, so the link survives restarts.\n");
+			emitShareLink();
 		}
 		return code ?? 1;
 	}
@@ -1052,7 +1079,7 @@ Options:
 		const webrtcVal = argv.webrtc ?? argv.share;
 		const explicitUrl = typeof webrtcVal === "string" && webrtcVal.startsWith("webrtc://") ? webrtcVal : void 0;
 		try {
-			const { startShare, loadOrCreateShareRoom } = await import("./share-YuM6-Q6A.js");
+			const { startShare, loadOrCreateShareRoom } = await import("./share-Cvb0PBKg.js");
 			const linkFile = path.join(process.env.AGENT_YES_HOME ?? path.join(homedir(), ".agent-yes"), ".share-link");
 			const announce = async (room, link, rotated) => {
 				const lead = rotated ? "the room was rejected by signaling (stale generation) — rotated to a fresh link" : "shared over WebRTC — open this link (the token is eaten from the URL on open)";
@@ -1107,4 +1134,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-vyKtlci4.js.map
+//# sourceMappingURL=serve-DpBmExxp.js.map

package/dist/{setup-BGfP7vQL.js → setup-DCisWuHB.js}

@@ -32,7 +32,7 @@ async function cmdSetup(rest) {
 	if (!existsSync(abs)) process.stderr.write(`  note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`);
 	if (noShare) return 0;
 	process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
-	const { cmdServe } = await import("./serve-vyKtlci4.js");
+	const { cmdServe } = await import("./serve-DpBmExxp.js");
 	return cmdServe([
 		"install",
 		"--share",
@@ -42,4 +42,4 @@ async function cmdSetup(rest) {
 
 //#endregion
 export { cmdSetup };
-//# sourceMappingURL=setup-BGfP7vQL.js.map
+//# sourceMappingURL=setup-DCisWuHB.js.map

package/dist/{share-YuM6-Q6A.js → share-Cvb0PBKg.js}

@@ -244,6 +244,15 @@ function parseShareUrl(s) {
 		host: m[3]
 	};
 }
+function formatShareLink(room, S, host) {
+	return `${host === "s.agent-yes.com" ? "https://agent-yes.com/w" : "http://localhost:7778/w"}/#${room}:${MARKER}${S}${host === "s.agent-yes.com" ? "" : "@" + host}`;
+}
+function shareLinkFromRoomUrl(url) {
+	const { room, token, host } = parseShareUrl(url);
+	const { s, v2 } = parseSecret(token);
+	if (!v2) throw new Error("refusing to derive a link for an unencrypted room — delete ~/.agent-yes/.share-room to rotate to an encrypted link");
+	return formatShareLink(room, s, host);
+}
 async function linkFromBunCache() {
 	const { existsSync, symlinkSync, mkdirSync, readdirSync } = await import("fs");
 	const path = (await import("path")).default;
@@ -320,9 +329,7 @@ async function startShare(opts) {
 	if (!v2) throw new Error("refusing to host an unencrypted room — delete ~/.agent-yes/.share-room to rotate to an encrypted link");
 	let S = firstS;
 	const wsScheme = host.startsWith("localhost") || host.startsWith("127.") ? "ws" : "wss";
-	const ui = host === "s.agent-yes.com" ? "https://agent-yes.com/w" : "http://localhost:7778/w";
-	const suffix = host === "s.agent-yes.com" ? "" : "@" + host;
-	const mkLink = () => `${ui}/#${room}:${MARKER}${S}${suffix}`;
+	const mkLink = () => formatShareLink(room, S, host);
 	let authToken = await deriveAuthToken(S, room, host);
 	let link = mkLink();
 	const RTCPeerConnection = await importRTC();
@@ -698,5 +705,5 @@ async function startShare(opts) {
 }
 
 //#endregion
-export { loadOrCreateShareRoom, startShare };
-//# sourceMappingURL=share-YuM6-Q6A.js.map
+export { loadOrCreateShareRoom, shareLinkFromRoomUrl, startShare };
+//# sourceMappingURL=share-Cvb0PBKg.js.map

package/dist/subcommands-BLUX23IJ.js

@@ -0,0 +1,7 @@
+import "./logger-B9h0djqx.js";
+import "./globalPidIndex-C7r2m6s7.js";
+import "./configShared-C5QaNPnz.js";
+import "./remotes-D8GvSbhf.js";
+import { _ as resolveReadWindow, a as cursorAbs, b as stopTipForCli, c as finalizedLines, d as listRecords, f as matchKeyword, g as resolveOne, h as renderRawLogLines, i as controlCodeFromName, l as isPidAlive, m as renderRawLog, n as READ_PAGE_DEFAULT, o as extractNeedsInput, p as readNotes, r as cmdHelp, s as extractTaskCounts, t as GRACEFUL_EXIT_COMMANDS, u as isSubcommand, v as runSubcommand, x as writeToIpc, y as snapshotStatus } from "./subcommands-D1floyWA.js";
+
+export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{subcommands-DlWWdnWv.js → subcommands-D1floyWA.js}

@@ -524,15 +524,15 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-vyKtlci4.js");
+				const { cmdServe } = await import("./serve-DpBmExxp.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-BGfP7vQL.js");
+				const { cmdSetup } = await import("./setup-DCisWuHB.js");
 				return cmdSetup(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-BCS2rT7U.js");
+				const { cmdSchedule } = await import("./schedule-QakndFJf.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -552,7 +552,7 @@ async function runSubcommand(argv) {
 	}
 }
 function cmdHelp() {
-	process.stdout.write("ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] <keyword>              stream output  (Ctrl-C to stop)\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay status <keyword>                 agent status snapshot\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n\nRemote:\n  ay setup                            guided setup: pick a workspace, share to agent-yes.com\n  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
+	process.stdout.write("ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay status <keyword>                 agent status snapshot\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n\nRemote:\n  ay setup                            guided setup: pick a workspace, share to agent-yes.com\n  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
 	return 0;
 }
 function matchKeyword(record, keyword) {
@@ -1153,7 +1153,7 @@ function truncate(s, n) {
 	return s.slice(0, n - 1) + "…";
 }
 async function cmdRead(rest, { mode }) {
-	const argv = await yargs(rest).usage("Usage: ay read/cat/tail/head <keyword> [options]").option("follow", {
+	const argv = await yargs(rest).usage("Usage: ay read/cat/tail/head <keyword> [options]\n\nPagination (static read; render the log once, window the rendered lines):\n  --last N | --head N         last / first N lines\n  --range A:B                 lines A..B (1-indexed, inclusive)\n  --before-line L [--limit N] the page of N lines ending just above line L").option("follow", {
 		alias: "f",
 		type: "boolean",
 		default: false,
@@ -1161,6 +1161,21 @@ async function cmdRead(rest, { mode }) {
 	}).option("n", {
 		type: "number",
 		description: "Number of lines (default: 96 for tail/head)"
+	}).option("last", {
+		type: "number",
+		description: "Show the last N rendered lines"
+	}).option("head", {
+		type: "number",
+		description: "Show the first N rendered lines"
+	}).option("range", {
+		type: "string",
+		description: "Show rendered lines A:B (1-indexed, inclusive)"
+	}).option("before-line", {
+		type: "number",
+		description: "Paginate: show the page of lines ending just above line L"
+	}).option("limit", {
+		type: "number",
+		description: "Page size for --before-line (default 96)"
 	}).option("plain", {
 		type: "boolean",
 		default: false,
@@ -1214,22 +1229,41 @@ async function cmdRead(rest, { mode }) {
 	}
 	if (!stats.isFile()) throw new Error(`pid ${record.pid}: log path is not a file: ${logPath}`);
 	const buf = await readFile(logPath);
-	const rendered = await renderRawLog(buf, {
-		mode,
-		n
-	});
 	const noteLabel = (await readNotes()).get(record.pid);
 	const header = noteLabel ? `[pid ${record.pid}  ${shortenPath(record.cwd)}  * ${noteLabel}]` : `[pid ${record.pid}  ${shortenPath(record.cwd)}]`;
-	process.stderr.write(header + "\n");
-	process.stdout.write(rendered);
-	if (!rendered.endsWith("\n")) process.stdout.write("\n");
 	if (follow) {
+		const rendered = await renderRawLog(buf, {
+			mode,
+			n
+		});
+		process.stderr.write(header + "\n");
+		process.stdout.write(rendered);
+		if (!rendered.endsWith("\n")) process.stdout.write("\n");
 		setInterval(() => void recordRead(reader.key, record.pid), 3e4).unref?.();
 		return plain ? followPlainLocal(logPath, buf) : followRawLocal(logPath, buf);
 	}
-	process.stderr.write(`
-  ay ls                                 # list all agents
-  ay tail -f ${record.pid}              # follow live output\n  ay send ${record.pid} "next: ..."      # send a prompt\n  ay send ${record.pid} "" --code=ctrl-c # interrupt\n`);
+	const allLines = await renderRawLogLines(buf);
+	const total = allLines.length;
+	const win = resolveReadWindow({
+		total,
+		mode,
+		n: argv.n,
+		last: argv.last,
+		head: argv.head,
+		range: argv.range,
+		beforeLine: argv["before-line"],
+		limit: argv.limit
+	});
+	const rendered = allLines.slice(win.start, win.end).join("\n");
+	process.stderr.write(header + "\n");
+	process.stdout.write(rendered);
+	if (!rendered.endsWith("\n")) process.stdout.write("\n");
+	const firstVisible = win.start + 1;
+	const shown = win.end - win.start;
+	const hints = [`\n`, `  ay ls                                 # list all agents\n`];
+	if (win.start > 0) hints.push(`  ay read ${record.pid} --before-line ${firstVisible} --limit ${shown || READ_PAGE_DEFAULT}   # older lines (page up)\n`);
+	hints.push(`  ay read ${record.pid} --range A:B            # lines A..B of ${total}\n`, `  ay tail -f ${record.pid}              # follow live output\n`, `  ay send ${record.pid} "next: ..."      # send a prompt\n`);
+	process.stderr.write(hints.join(""));
 	return 0;
 }
 /**
@@ -1394,9 +1428,23 @@ async function followPlainLocal(logPath, buf) {
 * Same approach as koho's renderTerminalBuffer + agent-yes's XtermProxy.
 */
 async function renderRawLog(buf, { mode, n }) {
+	const lines = await renderRawLogLines(buf);
+	if (mode === "cat") return lines.join("\n");
+	if (mode === "tail") return lines.slice(Math.max(0, lines.length - n)).join("\n");
+	return lines.slice(0, n).join("\n");
+}
+/**
+* Render the raw PTY byte stream to its full array of scrollback lines (trailing
+* blanks trimmed). This is the substrate `renderRawLog` slices by mode and that
+* pagination (`resolveReadWindow`) indexes into — slicing the FINAL rendered
+* state is sound, but rendering from an arbitrary mid-stream offset is not (PTY
+* cursor moves / clears / wraps), so we always render the whole buffer once and
+* window the resulting lines.
+*/
+async function renderRawLogLines(buf) {
 	const cols = 200;
 	const rows = 50;
-	const scrollback = Math.max(5e4, n + rows + 100);
+	const scrollback = 5e4;
 	try {
 		const { Terminal } = await import("@xterm/headless");
 		const term = new Terminal({
@@ -1413,18 +1461,73 @@ async function renderRawLog(buf, { mode, n }) {
 			lines.push(line ? line.translateToString(false).trimEnd() : "");
 		}
 		while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-		if (mode === "cat") return lines.join("\n");
-		if (mode === "tail") return lines.slice(Math.max(0, lines.length - n)).join("\n");
-		return lines.slice(0, n).join("\n");
+		return lines;
 	} catch {
 		let text = new TextDecoder().decode(buf);
 		text = text.replace(/\x1b\[[0-?]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[@-Z\\-_]/g, "").replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "");
 		const lines = text.split("\n");
-		if (mode === "cat") return lines.join("\n");
-		if (mode === "tail") return lines.slice(Math.max(0, lines.length - n)).join("\n");
-		return lines.slice(0, n).join("\n");
+		while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+		return lines;
 	}
 }
+const READ_PAGE_DEFAULT = 96;
+/**
+* Resolve which rendered lines to show. Precedence (first match wins):
+*   1. `range` "A:B"        — explicit 1-indexed inclusive window
+*   2. `beforeLine` (+limit)— the page of `limit` lines ending just ABOVE line L
+*                             (the pagination cursor `ay read` prints in its footer)
+*   3. `head` / `last`      — explicit first/last N rendered lines
+*   4. mode preset + `-n`   — tail/head default to the last/first N (96); cat = all
+* Indices are clamped to `[0, total]`; an empty / non-matching `range` falls through.
+*/
+function resolveReadWindow(opts) {
+	const total = Math.max(0, Math.floor(opts.total));
+	const clamp = (v) => Math.max(0, Math.min(total, Math.floor(v)));
+	const pos = (v) => v != null && Number.isFinite(v) && v > 0 ? Math.floor(v) : void 0;
+	const range = opts.range?.trim();
+	if (range) {
+		const m = /^(\d+):(\d+)$/.exec(range);
+		if (m) {
+			const a = parseInt(m[1], 10);
+			const b = parseInt(m[2], 10);
+			return {
+				start: clamp(Math.min(a, b) - 1),
+				end: clamp(Math.max(a, b))
+			};
+		}
+	}
+	if (opts.beforeLine != null && Number.isFinite(opts.beforeLine)) {
+		const limit = pos(opts.limit) ?? READ_PAGE_DEFAULT;
+		const end = clamp(opts.beforeLine - 1);
+		return {
+			start: clamp(end - limit),
+			end
+		};
+	}
+	const head = pos(opts.head);
+	if (head != null) return {
+		start: 0,
+		end: clamp(head)
+	};
+	const last = pos(opts.last);
+	if (last != null) return {
+		start: clamp(total - last),
+		end: total
+	};
+	const n = pos(opts.n);
+	if (opts.mode === "head") return {
+		start: 0,
+		end: clamp(n ?? READ_PAGE_DEFAULT)
+	};
+	if (opts.mode === "tail") return {
+		start: clamp(total - (n ?? READ_PAGE_DEFAULT)),
+		end: total
+	};
+	return {
+		start: 0,
+		end: total
+	};
+}
 /**
 * Extract a one-line activity summary from a raw log file.
 * Reads only the last 32 KB for speed, renders via xterm for clean output.
@@ -2303,5 +2406,5 @@ async function cmdResultSet(rest) {
 }
 
 //#endregion
-export { stopTipForCli as _, extractNeedsInput as a, isPidAlive as c, matchKeyword as d, readNotes as f, snapshotStatus as g, runSubcommand as h, cursorAbs as i, isSubcommand as l, resolveOne as m, cmdHelp as n, extractTaskCounts as o, renderRawLog as p, controlCodeFromName as r, finalizedLines as s, GRACEFUL_EXIT_COMMANDS as t, listRecords as u, writeToIpc as v };
-//# sourceMappingURL=subcommands-DlWWdnWv.js.map
+export { resolveReadWindow as _, cursorAbs as a, stopTipForCli as b, finalizedLines as c, listRecords as d, matchKeyword as f, resolveOne as g, renderRawLogLines as h, controlCodeFromName as i, isPidAlive as l, renderRawLog as m, READ_PAGE_DEFAULT as n, extractNeedsInput as o, readNotes as p, cmdHelp as r, extractTaskCounts as s, GRACEFUL_EXIT_COMMANDS as t, isSubcommand as u, runSubcommand as v, writeToIpc as x, snapshotStatus as y };
+//# sourceMappingURL=subcommands-D1floyWA.js.map

package/dist/{ts-CRNaIrcV.js → ts-D21pYxoi.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-CY79Ce_C.js";
+import { r as getInstalledPackage } from "./versionChecker-VKD48fzV.js";
 import { t as agentYesHome } from "./agentYesHome-BvaUOzCV.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-CJxsoGdb.js";
 import { t as PidStore } from "./pidStore-CGKIhaJO.js";
@@ -1787,4 +1787,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-CRNaIrcV.js.map
+//# sourceMappingURL=ts-D21pYxoi.js.map

package/dist/{versionChecker-CY79Ce_C.js → versionChecker-VKD48fzV.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.127.2";
+var version = "1.129.0";
 
 //#endregion
 //#region ts/versionChecker.ts
@@ -215,4 +215,4 @@ async function displayVersion() {
 
 //#endregion
 export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
-//# sourceMappingURL=versionChecker-CY79Ce_C.js.map
+//# sourceMappingURL=versionChecker-VKD48fzV.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.127.2",
+  "version": "1.129.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",

package/ts/serve.ts

@@ -276,6 +276,24 @@ function portFromArgs(args: string[]): number {
   return m ? Number(m[1]) : DEFAULT_PORT;
 }
 
+// An explicit webrtc:// URL passed to --webrtc/--share in the daemon's serve args,
+// or undefined for a bare flag (which mints a persisted room instead). Mirrors how
+// cmdServe resolves argv.webrtc/argv.share, but over the raw arg list install holds
+// (oxmgr splits the command on whitespace → `--webrtc url`; pm2/`=` → `--webrtc=url`).
+function explicitWebrtcUrl(args: string[]): string | undefined {
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]!;
+    for (const flag of ["--webrtc", "--share"]) {
+      if (a === flag && args[i + 1]?.startsWith("webrtc://")) return args[i + 1];
+      if (a.startsWith(`${flag}=`)) {
+        const v = a.slice(flag.length + 1);
+        if (v.startsWith("webrtc://")) return v;
+      }
+    }
+  }
+  return undefined;
+}
+
 // Ask the live daemon its version over the local HTTP API. null if it's not
 // listening (webrtc-only) or too old to expose /api/version — both of which we
 // treat as "outdated" so a re-install rolls it forward.
@@ -314,19 +332,68 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
     const effArgs = args.length ? args : (priorArgs ?? []);
     const current = getInstalledPackage().version;
 
+    // WebRTC daemon: resolve the share link up front so we can print it on every
+    // install path (fresh install, roll-forward, and the already-up-to-date no-op).
+    // The link is a pure transform of the room URL, so the foreground install
+    // command can show it even though the background daemon is what runs the bridge.
+    // Resolve (and persist, when auto-minting) the room BEFORE spawning, so the
+    // daemon reads the SAME ~/.agent-yes/.share-room and can't race us into minting
+    // a divergent one. We print the link directly — the install receipt already
+    // prints the bearer token, so the operator's terminal is the right trust scope
+    // for a secret-bearing link (unlike the daemon's persisted logs, which omit it).
+    const webrtcDaemon = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
+    let shareLink: string | null = null;
+    let shareLinkMinted = false; // auto-minted (persisted/rotatable) vs explicit URL
+    if (webrtcDaemon) {
+      try {
+        const { loadOrCreateShareRoom, shareLinkFromRoomUrl } = await import("./share.ts");
+        const explicit = explicitWebrtcUrl(effArgs);
+        shareLink = shareLinkFromRoomUrl(explicit ?? (await loadOrCreateShareRoom()));
+        shareLinkMinted = !explicit;
+      } catch {
+        /* best effort — fall back to the .share-link file hint in emitShareLink */
+      }
+    }
+    const emitShareLink = () => {
+      if (!webrtcDaemon) return;
+      if (shareLink)
+        process.stdout.write(
+          `\nshared over WebRTC — open this link (the token is eaten from the URL on open):\n` +
+            `  ${shareLink}\n` +
+            (shareLinkMinted
+              ? `  (persistent room — same link across restarts; delete ~/.agent-yes/.share-room to rotate)\n`
+              : ``),
+        );
+      else
+        process.stdout.write(
+          `\nthe WebRTC share link carries a secret, so the daemon does NOT log it —\n` +
+            `read it from ~/.agent-yes/.share-link (mode 0600). The room persists in\n` +
+            `~/.agent-yes/.share-room, so the link survives restarts.\n`,
+        );
+    };
+
     if (priorArgs !== null) {
-      // A daemon already exists — only disturb it if it's actually outdated.
+      // A daemon already exists. Treat this as a no-op only when it's BOTH current
+      // AND already running the requested config — otherwise a config change (e.g.
+      // `install --webrtc` over an --http daemon, which the version probe still
+      // reaches on the default port) would be silently ignored, and we'd print a
+      // share link for a WebRTC bridge that isn't actually running. A bare re-run
+      // passes no args, so effArgs === priorArgs and this stays a no-op as before.
+      const sameConfig = JSON.stringify(effArgs) === JSON.stringify(priorArgs);
       const runningVer = await fetchDaemonVersion(portFromArgs(effArgs), token);
-      if (runningVer === current) {
+      if (runningVer === current && sameConfig) {
         await ensureBootAutostart(mgr);
         process.stdout.write(`'${DAEMON_NAME}' already running v${current} (up to date)\n`);
+        emitShareLink();
         return 0;
       }
-      // Outdated (or unreachable/too-old to report) → graceful roll-forward.
-      // `stop` sends SIGTERM, which cmdServe handles cleanly (closing share
-      // peers so browsers reconnect fast), then we re-create with the new binary.
+      // Outdated, unreachable, or reconfigured → graceful roll-forward. `stop` sends
+      // SIGTERM, which cmdServe handles cleanly (closing share peers so browsers
+      // reconnect fast), then we re-create with the new binary/args.
       process.stdout.write(
-        `rolling '${DAEMON_NAME}' ${runningVer ? `v${runningVer}` : "(unknown)"} → v${current}…\n`,
+        runningVer === current
+          ? `reconfiguring '${DAEMON_NAME}' (serve args changed)…\n`
+          : `rolling '${DAEMON_NAME}' ${runningVer ? `v${runningVer}` : "(unknown)"} → v${current}…\n`,
       );
       await spawnExit([mgr.bin, "stop", DAEMON_NAME]);
       await spawnExit([mgr.bin, "delete", DAEMON_NAME]);
@@ -340,7 +407,7 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
     // freeze the JS event loop (host answers nobody, no in-process timer can
     // recover it), so an EXTERNAL probe of the serve heartbeat is the only thing
     // that can detect+restart it. 15s stale + 3 misses at 10s ≈ 45s to auto-recover.
-    const webrtcDaemon = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
+    // (webrtcDaemon resolved above, where we also derive the share link.)
     const oxmgrHealth =
       webrtcDaemon && mgr.id === "oxmgr"
         ? [
@@ -389,7 +456,6 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
       const onBoot = await ensureBootAutostart(mgr);
       const port = portFromArgs(effArgs);
       // Mirror cmdServe's mode resolution: webrtc-only daemons open no HTTP port.
-      const webrtcish = effArgs.some((a) => a.startsWith("--webrtc") || a.startsWith("--share"));
       const httpish =
         effArgs.some((a) => a.startsWith("--http") || a.startsWith("--share")) ||
         !effArgs.some((a) => a.startsWith("--webrtc"));
@@ -421,13 +487,7 @@ async function cmdServeDaemon(sub: string, args: string[]): Promise<number> {
       }
       process.stdout.write(`  ay serve logs                # view server logs\n`);
       process.stdout.write(`  ay serve uninstall           # remove daemon\n`);
-      if (webrtcish) {
-        process.stdout.write(
-          `\nthe WebRTC share link carries a secret, so the daemon does NOT log it —\n` +
-            `read it from ~/.agent-yes/.share-link (mode 0600). The room persists in\n` +
-            `~/.agent-yes/.share-room, so the link survives restarts.\n`,
-        );
-      }
+      emitShareLink();
     }
     return code ?? 1;
   }

package/ts/share.spec.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from "vitest";
+import { shareLinkFromRoomUrl } from "./share.ts";
+import { MARKER } from "../lab/ui/e2e.js";
+
+const S = "a".repeat(64); // a valid 64-hex room secret
+const TOK = `${MARKER}${S}`; // encrypted-room token (v2)
+
+// shareLinkFromRoomUrl turns a persisted/explicit webrtc://room:token@host room
+// into the browser console link `ay serve install` prints — it MUST match the
+// link startShare announces from the same room (both go through formatShareLink).
+describe("shareLinkFromRoomUrl", () => {
+  it("derives the prod console link (no host suffix; secret rides in the fragment)", () => {
+    const link = shareLinkFromRoomUrl(`webrtc://r1a2b3c:${TOK}@s.agent-yes.com`);
+    expect(link).toBe(`https://agent-yes.com/w/#r1a2b3c:${MARKER}${S}`);
+  });
+
+  it("derives a dev/self-hosted link carrying the signaling host in the fragment", () => {
+    const link = shareLinkFromRoomUrl(`webrtc://r1a2b3c:${TOK}@localhost:7778`);
+    expect(link).toBe(`http://localhost:7778/w/#r1a2b3c:${MARKER}${S}@localhost:7778`);
+  });
+
+  it("round-trips room + token in the fragment the browser splits back out", () => {
+    const link = shareLinkFromRoomUrl(`webrtc://room0:${TOK}@s.agent-yes.com`);
+    expect(link.split("#")[1]).toBe(`room0:${TOK}`);
+  });
+
+  it("refuses a legacy (unencrypted) room — operator must rotate to an encrypted link", () => {
+    expect(() => shareLinkFromRoomUrl(`webrtc://room0:${S}@s.agent-yes.com`)).toThrow(
+      /unencrypted/,
+    );
+  });
+
+  it("rejects a malformed room url", () => {
+    expect(() => shareLinkFromRoomUrl("not-a-webrtc-url")).toThrow(/webrtc:\/\//);
+  });
+});

package/ts/share.ts

@@ -160,6 +160,33 @@ function parseShareUrl(s: string): { room: string; token: string; host: string }
   return { room: m[1]!, token: m[2]!, host: m[3]! };
 }
 
+// The browser console URL for a room — what the operator opens to reach the host.
+// Pure function of (room, secret S, signaling host): S rides in the URL fragment
+// (never sent to any server) and is eaten by the page on open. Single source of
+// truth for the link format, shared by startShare's live announce and by
+// shareLinkFromRoomUrl (so `ay serve install` prints the exact link the daemon serves).
+function formatShareLink(room: string, S: string, host: string): string {
+  // The console web-app is served under /w/ (landing page lives at /). A non-prod
+  // signaling host targets the local dev UI and carries the host in the fragment.
+  const ui = host === "s.agent-yes.com" ? "https://agent-yes.com/w" : "http://localhost:7778/w";
+  const suffix = host === "s.agent-yes.com" ? "" : "@" + host;
+  return `${ui}/#${room}:${MARKER}${S}${suffix}`;
+}
+
+// Derive the shareable console link from a persisted/explicit webrtc://room:token@host
+// URL WITHOUT starting a bridge, so `ay serve install` can print the same link the
+// background daemon will serve. Throws on a legacy (unencrypted) room, mirroring
+// startShare's refusal to host one.
+export function shareLinkFromRoomUrl(url: string): string {
+  const { room, token, host } = parseShareUrl(url);
+  const { s, v2 } = parseSecret(token);
+  if (!v2)
+    throw new Error(
+      "refusing to derive a link for an unencrypted room — delete ~/.agent-yes/.share-room to rotate to an encrypted link",
+    );
+  return formatShareLink(room, s, host);
+}
+
 // node-datachannel ships a native addon. Under Bun the module sometimes resolves
 // from the global cache where the prebuilt .node isn't linked; this best-effort
 // shim symlinks it in before we import. In a normal npm/bunx install the binary
@@ -280,10 +307,7 @@ export async function startShare(
   let S = firstS;
 
   const wsScheme = host.startsWith("localhost") || host.startsWith("127.") ? "ws" : "wss";
-  // The console web-app is served under /w/ (landing page lives at /).
-  const ui = host === "s.agent-yes.com" ? "https://agent-yes.com/w" : "http://localhost:7778/w";
-  const suffix = host === "s.agent-yes.com" ? "" : "@" + host;
-  const mkLink = () => `${ui}/#${room}:${MARKER}${S}${suffix}`;
+  const mkLink = () => formatShareLink(room, S, host);
   let authToken = await deriveAuthToken(S, room, host);
   let link = mkLink();
 

package/ts/subcommands.spec.ts

@@ -1253,3 +1253,74 @@ describe("subcommands.listRecords merges per-cwd TS file with global", () => {
     }
   });
 });
+
+describe("subcommands.resolveReadWindow", () => {
+  const total = 100;
+
+  it("defaults: tail = last 96, head = first 96, cat = all", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total: 200, mode: "tail" })).toEqual({ start: 104, end: 200 });
+    expect(resolveReadWindow({ total: 200, mode: "head" })).toEqual({ start: 0, end: 96 });
+    expect(resolveReadWindow({ total: 200, mode: "cat" })).toEqual({ start: 0, end: 200 });
+  });
+
+  it("respects -n for tail/head; cat ignores -n (stays whole)", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "tail", n: 10 })).toEqual({ start: 90, end: 100 });
+    expect(resolveReadWindow({ total, mode: "head", n: 10 })).toEqual({ start: 0, end: 10 });
+    expect(resolveReadWindow({ total, mode: "cat", n: 10 })).toEqual({ start: 0, end: 100 });
+  });
+
+  it("--last / --head override the mode", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "cat", last: 5 })).toEqual({ start: 95, end: 100 });
+    expect(resolveReadWindow({ total, mode: "tail", head: 5 })).toEqual({ start: 0, end: 5 });
+  });
+
+  it("--range A:B is 1-indexed inclusive and order-insensitive", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "cat", range: "10:20" })).toEqual({
+      start: 9,
+      end: 20,
+    });
+    expect(resolveReadWindow({ total, mode: "cat", range: "20:10" })).toEqual({
+      start: 9,
+      end: 20,
+    });
+  });
+
+  it("--before-line L shows the page of `limit` lines ending just above L", async () => {
+    const { resolveReadWindow } = await loadModule();
+    // page-up cursor: lines strictly before line 51, limit 10 -> [41..50] (0-idx 40..50)
+    expect(resolveReadWindow({ total, mode: "cat", beforeLine: 51, limit: 10 })).toEqual({
+      start: 40,
+      end: 50,
+    });
+    // round-trip: first-visible of the above is line 41; paging up again from 41
+    expect(resolveReadWindow({ total, mode: "cat", beforeLine: 41, limit: 10 })).toEqual({
+      start: 30,
+      end: 40,
+    });
+  });
+
+  it("clamps out-of-range indices", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total: 5, mode: "tail", n: 999 })).toEqual({ start: 0, end: 5 });
+    expect(resolveReadWindow({ total: 5, mode: "cat", range: "3:999" })).toEqual({
+      start: 2,
+      end: 5,
+    });
+    expect(resolveReadWindow({ total: 5, mode: "cat", beforeLine: 2, limit: 999 })).toEqual({
+      start: 0,
+      end: 1,
+    });
+  });
+
+  it("ignores a malformed --range and falls through to the mode default", async () => {
+    const { resolveReadWindow } = await loadModule();
+    expect(resolveReadWindow({ total, mode: "head", range: "not-a-range" })).toEqual({
+      start: 0,
+      end: 96,
+    });
+  });
+});

package/dist/SUPPORTED_CLIS-BQ95wXgT.js

@@ -1,8 +0,0 @@
-import "./ts-CRNaIrcV.js";
-import "./logger-B9h0djqx.js";
-import "./versionChecker-CY79Ce_C.js";
-import "./pidStore-CGKIhaJO.js";
-import "./globalPidIndex-C7r2m6s7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CJzJB2Ov.js";
-
-export { SUPPORTED_CLIS };

package/dist/subcommands-BPz3ie1B.js

@@ -1,7 +0,0 @@
-import "./logger-B9h0djqx.js";
-import "./globalPidIndex-C7r2m6s7.js";
-import "./configShared-C5QaNPnz.js";
-import "./remotes-D8GvSbhf.js";
-import { _ as stopTipForCli, a as extractNeedsInput, c as isPidAlive, d as matchKeyword, f as readNotes, g as snapshotStatus, h as runSubcommand, i as cursorAbs, l as isSubcommand, m as resolveOne, n as cmdHelp, o as extractTaskCounts, p as renderRawLog, r as controlCodeFromName, s as finalizedLines, t as GRACEFUL_EXIT_COMMANDS, u as listRecords, v as writeToIpc } from "./subcommands-DlWWdnWv.js";
-
-export { cmdHelp, isSubcommand, runSubcommand };