skydive-cli 0.5.0-beta.32 → 0.5.0-beta.36

package/dist/js/bin.mjs

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import { A as takenAliasNames, B as name, D as dedupeAliasName, E as aliasActivationHint, F as getActiveWorkspaceId, I as getSessionIdentity, L as listWorkspaces, M as defaultInstallEnv, N as detectShell, O as installAgentAlias, P as ensureActiveOrganization, R as resolveWorkspaceId, S as themes, T as machineOsFromPlatform, V as version, a as installCrashHandler, j as SUPPORTED_SHELLS, k as slugifyAliasName, t as maybeStartProfiling, u as brandHelpArt, w as buildImportSeedPrompt, z as setActiveWorkspace } from "./profiler-CJMnC90G.mjs";
-import { A as getShareMachineDefault, C as getConfigPath, D as getPromptHistoryPath, E as getPreference, F as resolveAppUrl, H as saveSession, I as resolveChatAuth, L as resolveConfig, M as getStoredApiKeyWorkspaceName, N as getUpdateCheckDisabled, R as resolveManagementAuth, S as deleteConfig, T as getLastSeenVersion, V as saveConfig, W as setLastSeenVersion, _ as API_KEY_FAMILY_PREFIX, g as API_KEYS_URL, i as resolveAgent$1, j as getStoredApiKeyId, v as API_KEY_PREFIX, w as getDefaultAgent, x as PREFERENCES, y as DEFAULT_API_URL, z as resolveSession } from "./print-Clgq46GU.mjs";
+import { A as installAgentAlias, B as resolveWorkspaceId, D as machineOsFromPlatform, E as buildImportSeedPrompt, F as detectShell, H as name, I as ensureActiveOrganization, L as getActiveWorkspaceId, M as takenAliasNames, N as SUPPORTED_SHELLS, O as aliasActivationHint, P as defaultInstallEnv, R as getSessionIdentity, U as version, V as setActiveWorkspace, c as getAutomaticLogsDir, j as slugifyAliasName, k as dedupeAliasName, l as maybeStartProfiling, o as brandHelpArt, t as installCrashHandler, u as profileDir, w as themes, z as listWorkspaces } from "./install-aZ751iYf.mjs";
+import { A as getShareMachineDefault, C as getConfigPath, D as getPromptHistoryPath, E as getPreference, F as resolveAppUrl, H as saveSession, I as resolveChatAuth, L as resolveConfig, M as getStoredApiKeyWorkspaceName, N as getUpdateCheckDisabled, R as resolveManagementAuth, S as deleteConfig, T as getLastSeenVersion, V as saveConfig, W as setLastSeenVersion, _ as API_KEY_FAMILY_PREFIX, g as API_KEYS_URL, i as resolveAgent$1, j as getStoredApiKeyId, v as API_KEY_PREFIX, w as getDefaultAgent, x as PREFERENCES, y as DEFAULT_API_URL, z as resolveSession$1 } from "./print-h22UbIfZ.mjs";
 import { n as printError, r as printTable, t as output } from "./output-wY0VQDea.mjs";
 import { t as HttpError } from "./http-error-UHH3mVBF.mjs";
-import { t as createRestClient } from "./rest-C6E4mS2A.mjs";
+import { t as createRestClient } from "./rest-ClVPZquN.mjs";
 import "./billing-blocked-D3l5kJlX.mjs";
 import { r as resolveMachineIdentity } from "./client-d6K9qm6B.mjs";
-import { i as queryDaemonStatus, l as PORTAL_DAEMON_FLAG, n as ensureDaemonRunning, s as stopDaemon, u as daemonPaths } from "./daemon-CxFxH36O.mjs";
+import { i as queryDaemonStatus, l as PORTAL_DAEMON_FLAG, n as ensureDaemonRunning, s as stopDaemon, u as daemonPaths } from "./daemon-CH95gDij.mjs";
 import "./tls-cert-CV-pwxVN.mjs";
 import { i as grantPortalAccess, n as fetchPortalDevices, o as registerPortalDevice, r as findThisDevice, s as revokePortalAccess } from "./api-DQCaztBg.mjs";
-import { t as SandboxStream } from "./client-BTQ1fwzM.mjs";
+import { a as encodeFsRequest, i as decodeFsResponse, n as SANDBOX_STREAM_PATH, r as streamSpecToQuery, t as SandboxStream } from "./client-Btq6bMzX.mjs";
 import { hideBin } from "yargs/helpers";
 import yargs from "yargs";
 import { hostname, tmpdir } from "node:os";
@@ -19,12 +19,13 @@ import { z } from "zod";
 import open from "open";
 import fs from "node:fs";
 import { spawn, spawnSync } from "node:child_process";
-import { createHash, randomBytes } from "node:crypto";
+import { createHash } from "node:crypto";
 import zlib from "node:zlib";
 import fsp, { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import { quote } from "shell-quote";
+import { WebSocket } from "ws";
 import semver from "semver";
 import { createInterface } from "node:readline";
+import { createInterface as createInterface$1 } from "node:readline/promises";
 
 //#region src/types.ts
 const NON_INTERACTIVE_ENV_VARS = [
@@ -620,7 +621,7 @@ const logoutCommand = {
 		const keyId = getStoredApiKeyId();
 		let keyRevoked = false;
 		if (keyId) {
-			const session = resolveSession({ appUrl: argv["api-url"] });
+			const session = resolveSession$1({ appUrl: argv["api-url"] });
 			const config = resolveConfig({ apiUrl: argv["api-url"] });
 			const credential = session.isOk() ? {
 				appUrl: session.value.appUrl,
@@ -651,7 +652,7 @@ const statusCommand$1 = {
 	describe: "Show current authentication state",
 	handler: async (argv) => {
 		const apiKey = resolveConfig({ apiUrl: argv["api-url"] });
-		const session = resolveSession({});
+		const session = resolveSession$1({});
 		const management = resolveManagementAuth({ apiUrl: argv["api-url"] });
 		const identity = session.isOk() ? (await getSessionIdentity({
 			appUrl: session.value.appUrl,
@@ -1001,7 +1002,7 @@ const completionCommand = {
 * resolve-or-exit block isn't copy-pasted per command.
 */
 function requireSession(argv) {
-	const session = resolveSession({ appUrl: resolveAppUrl({ appUrl: argv["api-url"] }) });
+	const session = resolveSession$1({ appUrl: resolveAppUrl({ appUrl: argv["api-url"] }) });
 	if (session.isErr()) {
 		printError(`${session.error.message} Run \`skydive auth login\` first, or set SKYDIVE_SESSION_TOKEN.`);
 		process.exit(1);
@@ -1066,7 +1067,7 @@ async function resolveAgent(client, selector) {
 	if (matches.length === 0) throw new Error(`No agent named "${selector}". Pass an id, or run \`skydive agents list\`.`);
 	throw new Error(`Multiple agents named "${selector}". Pass the id instead:\n${matches.map((a) => `  ${a.name}  ${a.id}`).join("\n")}`);
 }
-const listCommand$5 = {
+const listCommand$6 = {
 	command: "list",
 	describe: "List agents in the active workspace",
 	builder: (y) => y.option("limit", {
@@ -1290,7 +1291,7 @@ const aliasCommand = {
 const agentsCommand = {
 	command: "agents",
 	describe: "Manage agents",
-	builder: (y) => y.command(listCommand$5).command(getCommand$2).command(createCommand$1).command(aliasCommand).demandCommand(1, "Specify a subcommand: list, get, create, alias"),
+	builder: (y) => y.command(listCommand$6).command(getCommand$2).command(createCommand$1).command(aliasCommand).demandCommand(1, "Specify a subcommand: list, get, create, alias"),
 	handler: () => {}
 };
 
@@ -1572,20 +1573,20 @@ const importCommand = {
 			printError(`import needs the Bun runtime and it couldn't be set up automatically. Install Bun (https://bun.sh) and run \`bun ${process.argv[1] ?? "skydive"} import\`, point SKYDIVE_BUN_PATH at an existing bun binary, or use the non-interactive \`import -p\` (runs under Node).`);
 			process.exit(1);
 		}
-		let session = resolveSession({ appUrl });
+		let session = resolveSession$1({ appUrl });
 		if (session.isErr()) {
 			const login = await loginWithDevice({ appUrl });
 			if (login.isErr()) {
 				printError(login.error.message);
 				process.exit(1);
 			}
-			session = resolveSession({ appUrl });
+			session = resolveSession$1({ appUrl });
 			if (session.isErr()) {
 				printError("Signed in, but no session was stored.");
 				process.exit(1);
 			}
 		}
-		const { runChat } = await import("./boot-yyXrIeVy.mjs");
+		const { runChat } = await import("./boot-CmInaUwJ.mjs");
 		await runChat({
 			appUrl,
 			sessionToken: session.value.sessionToken,
@@ -1610,7 +1611,7 @@ const importCommand = {
 * (`chat -p "go ahead" --resume <id> --share-machine`) to apply it.
 */
 async function runImportPrintMode({ argv, appUrl }) {
-	const session = resolveSession({ appUrl });
+	const session = resolveSession$1({ appUrl });
 	if (session.isErr()) {
 		printError(`${session.error.message} For non-interactive use, run \`skydive auth login --web\` first, or set SKYDIVE_SESSION_TOKEN.`);
 		process.exit(1);
@@ -1623,7 +1624,7 @@ async function runImportPrintMode({ argv, appUrl }) {
 	});
 	const extra = (argv.print ?? "").trim();
 	const prompt = buildImportSeedPrompt(process.cwd(), machineOsFromPlatform(process.platform)) + (extra ? `\n\nAdditional instructions: ${extra}` : "");
-	const { runPrint } = await import("./print-B9djx8GU.mjs");
+	const { runPrint } = await import("./print-DV9L41G2.mjs");
 	try {
 		const result = await runPrint({
 			appUrl,
@@ -1647,7 +1648,7 @@ async function runImportPrintMode({ argv, appUrl }) {
 
 //#endregion
 //#region src/commands/keys.ts
-const listCommand$4 = {
+const listCommand$5 = {
 	command: "list",
 	describe: "List API keys for an agent",
 	handler: async (argv) => {
@@ -1736,7 +1737,7 @@ const keysCommand = {
 		type: "string",
 		demandOption: true,
 		describe: "Agent ID"
-	}).command(listCommand$4).command(createCommand).command(revokeCommand$1).demandCommand(1, "Specify a subcommand: list, create, revoke"),
+	}).command(listCommand$5).command(createCommand).command(revokeCommand$1).demandCommand(1, "Specify a subcommand: list, create, revoke"),
 	handler: () => {}
 };
 
@@ -1748,7 +1749,7 @@ async function readStdin() {
 	for await (const chunk of process.stdin) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
 	return Buffer.concat(chunks).toString("utf8").replace(/\n$/, "");
 }
-const listCommand$3 = {
+const listCommand$4 = {
 	command: "list",
 	describe: "List secret names for an agent (values are never shown)",
 	handler: async (argv) => {
@@ -1834,7 +1835,7 @@ const secretsCommand = {
 		type: "string",
 		demandOption: true,
 		describe: "Agent ID"
-	}).command(listCommand$3).command(setCommand$1).command(rmCommand).demandCommand(1, "Specify a subcommand: list, set, rm"),
+	}).command(listCommand$4).command(setCommand$1).command(rmCommand).demandCommand(1, "Specify a subcommand: list, set, rm"),
 	handler: () => {}
 };
 
@@ -2030,7 +2031,7 @@ const chatCommand = {
 			sessionToken: auth.value.token,
 			agentSelector: argv.agent ?? null
 		});
-		const { runChat } = await import("./boot-yyXrIeVy.mjs");
+		const { runChat } = await import("./boot-CmInaUwJ.mjs");
 		await runChat({
 			appUrl: auth.value.appUrl,
 			sessionToken: auth.value.token,
@@ -2114,7 +2115,7 @@ async function runPrintMode({ argv, appUrl }) {
 		printError(`${auth.error.message} For non-interactive use, run \`skydive auth login\` first, or set SKYDIVE_API_KEY / SKYDIVE_SESSION_TOKEN.`);
 		process.exit(1);
 	}
-	const { runPrint, readStdin } = await import("./print-B9djx8GU.mjs");
+	const { runPrint, readStdin } = await import("./print-DV9L41G2.mjs");
 	const workspaceId = await resolveWorkspaceFlag({
 		appUrl,
 		sessionToken: auth.value.token,
@@ -2209,7 +2210,7 @@ const getCommand$1 = {
 			printError(`${auth.error.message} Run \`skydive auth login\` first, or set SKYDIVE_API_KEY / SKYDIVE_SESSION_TOKEN.`);
 			process.exit(1);
 		}
-		const { messageGet } = await import("./print-B9djx8GU.mjs");
+		const { messageGet } = await import("./print-DV9L41G2.mjs");
 		try {
 			const result = await messageGet({
 				appUrl: auth.value.appUrl,
@@ -2256,7 +2257,7 @@ function messageToText(message) {
 	}
 	return chunks.join("\n").trim();
 }
-const listCommand$2 = {
+const listCommand$3 = {
 	command: "list",
 	describe: "List an agent's conversations",
 	builder: (y) => y.option("agent", {
@@ -2346,7 +2347,7 @@ const conversationsCommand = {
 	command: "conversations",
 	aliases: ["conv"],
 	describe: "List and read agent conversations",
-	builder: (y) => y.command(listCommand$2).command(showCommand).demandCommand(1, "Specify a subcommand: list, show"),
+	builder: (y) => y.command(listCommand$3).command(showCommand).demandCommand(1, "Specify a subcommand: list, show"),
 	handler: () => {}
 };
 
@@ -2388,7 +2389,7 @@ async function runList(argv, { hint }) {
 	]));
 	if (hint && !argv.quiet) console.log("\nRun `skydive workspace switch` to pick a workspace, or pass its slug directly.");
 }
-const listCommand$1 = {
+const listCommand$2 = {
 	command: "list",
 	describe: "List workspaces on your account",
 	handler: (argv) => runList(argv, { hint: false })
@@ -2412,7 +2413,7 @@ const switchCommand = {
 				printError("The workspace picker needs the Bun runtime and it could not be set up automatically. Pass a workspace slug instead, or install Bun and retry.");
 				process.exit(1);
 			}
-			const { runWorkspacePicker } = await import("./boot-yyXrIeVy.mjs");
+			const { runWorkspacePicker } = await import("./boot-CmInaUwJ.mjs");
 			await runWorkspacePicker(session);
 			return;
 		}
@@ -2445,7 +2446,7 @@ const switchCommand = {
 const workspaceCommand = {
 	command: "workspace",
 	describe: "List or switch the workspace all `skydive` commands act on",
-	builder: (y) => y.command(listCommand$1).command(switchCommand),
+	builder: (y) => y.command(listCommand$2).command(switchCommand),
 	handler: (argv) => runList(argv, { hint: true })
 };
 
@@ -2491,7 +2492,7 @@ const openCommand = {
 		const agent = argv.agent ? resolveAgent$1((await fetchPortalDevices(session)).agents, argv.agent) : null;
 		const cwd = argv.cwd ? path.resolve(argv.cwd) : process.cwd();
 		const { machineName } = await resolveMachineIdentity(null);
-		const { PortalDaemonClient } = await import("./daemon-client-1Qfc_Y3J.mjs");
+		const { PortalDaemonClient } = await import("./daemon-client-CC9sxWac.mjs");
 		let lastLine = "";
 		let signalConnected;
 		const connected = new Promise((resolve) => {
@@ -2767,7 +2768,7 @@ const portalCommand = {
 //#endregion
 //#region src/commands/sandbox.ts
 /** POSIX single-quote one word so the remote shell treats it as one token. */
-function shellQuote$1(word) {
+function shellQuote(word) {
 	if (/^[A-Za-z0-9_@%+=:,./-]+$/.test(word)) return word;
 	return `'${word.replace(/'/g, `'\\''`)}'`;
 }
@@ -2782,7 +2783,7 @@ function shellQuote$1(word) {
 * for too. yargs number-coerces bare numerals, so words are stringified.
 */
 function joinCommandWords(words) {
-	return words.map(String).map(shellQuote$1).join(" ").trim();
+	return words.map(String).map(shellQuote).join(" ").trim();
 }
 /**
 * `skydive sandbox` — the standalone counterpart to the chat TUI's `/sandbox`
@@ -2805,8 +2806,8 @@ const sandboxCommand = {
 	}).example("skydive sandbox --agent grace", "Live terminal (Ctrl-] detaches)").example("skydive sandbox --agent grace -- tail -n 50 /tmp/harness.log", "One-shot command (use `--` so its flags reach the sandbox)").example("skydive sandbox --agent grace -- sh -c 'ls /tmp | wc -l'", "Shell features go through an explicit `sh -c`"),
 	handler: async (argv) => {
 		const session = requireSession(argv);
-		const { createRestClient } = await import("./rest-CaWUSrnH.mjs");
-		const { resolveAgent } = await import("./print-B9djx8GU.mjs");
+		const { createRestClient } = await import("./rest-v-7FQqLP.mjs");
+		const { resolveAgent } = await import("./print-DV9L41G2.mjs");
 		const client = createRestClient({
 			appUrl: session.appUrl,
 			sessionToken: session.sessionToken
@@ -2875,7 +2876,7 @@ async function runPty({ session, agentId, agentName }) {
 		return 1;
 	}
 	console.error(`Connecting to ${agentName}'s sandbox… (Ctrl-] detaches)`);
-	const { runRawPtyPassthrough } = await import("./raw-pty-g3kATVQe.mjs");
+	const { runRawPtyPassthrough } = await import("./raw-pty-Ci2qFR9F.mjs");
 	const result = await runRawPtyPassthrough({
 		stdin: process.stdin,
 		stdout: process.stdout,
@@ -2887,40 +2888,151 @@ async function runPty({ session, agentId, agentName }) {
 	return result.code;
 }
 
+//#endregion
+//#region src/chat/sandbox/fs-client.ts
+function wsBase(appUrl) {
+	const base = appUrl.replace(/\/+$/, "");
+	if (base.startsWith("https://")) return `wss://${base.slice(8)}`;
+	if (base.startsWith("http://")) return `ws://${base.slice(7)}`;
+	return `wss://${base}`;
+}
+function toU8(data) {
+	if (Buffer.isBuffer(data)) return new Uint8Array(data);
+	if (Array.isArray(data)) return new Uint8Array(Buffer.concat(data));
+	return new Uint8Array(Buffer.from(data));
+}
+var SandboxFsClient = class SandboxFsClient {
+	ws;
+	ready;
+	nextReqId = 1;
+	pending = /* @__PURE__ */ new Map();
+	closedReason = null;
+	constructor(opts) {
+		const spec = {
+			mode: "fs",
+			agentId: opts.agentId
+		};
+		const url = new URL(`${wsBase(opts.appUrl)}${SANDBOX_STREAM_PATH}`);
+		for (const [key, value] of Object.entries(streamSpecToQuery(spec))) url.searchParams.set(key, value);
+		this.ws = new WebSocket(url.toString(), { headers: { authorization: `Bearer ${opts.sessionToken}` } });
+		this.ws.binaryType = "nodebuffer";
+		this.ready = new Promise((resolve, reject) => {
+			this.ws.once("open", () => resolve());
+			this.ws.once("error", (err) => reject(err));
+		});
+		this.ws.on("message", (data, isBinary) => {
+			if (!isBinary) return;
+			const res = decodeFsResponse(toU8(data));
+			if (!res) return;
+			const p = this.pending.get(res.reqId);
+			if (!p) return;
+			this.pending.delete(res.reqId);
+			if (res.status === "error") p.reject(new Error(res.message));
+			else p.resolve({
+				result: res.result,
+				blob: res.blob
+			});
+		});
+		const failAll = (reason) => {
+			this.closedReason = reason;
+			for (const [, p] of this.pending) p.reject(new Error(reason));
+			this.pending.clear();
+		};
+		this.ws.on("error", (err) => failAll(err.message));
+		this.ws.on("close", () => failAll(this.closedReason ?? "the sandbox filesystem connection closed"));
+	}
+	/** Open and wait for the channel to be ready to accept requests. */
+	static async connect(opts) {
+		const client = new SandboxFsClient(opts);
+		await client.ready;
+		return client;
+	}
+	request(req, blob) {
+		if (this.closedReason) return Promise.reject(new Error(this.closedReason));
+		const reqId = this.nextReqId++;
+		return new Promise((resolve, reject) => {
+			this.pending.set(reqId, {
+				resolve,
+				reject
+			});
+			try {
+				this.ws.send(encodeFsRequest(reqId, req, blob));
+			} catch (error) {
+				this.pending.delete(reqId);
+				reject(error instanceof Error ? error : new Error(String(error)));
+			}
+		});
+	}
+	async list(path) {
+		const { result } = await this.request({
+			op: "list",
+			path
+		}, null);
+		const entries = result["entries"];
+		if (!Array.isArray(entries)) return [];
+		return entries;
+	}
+	async stat(path) {
+		const { result } = await this.request({
+			op: "stat",
+			path
+		}, null);
+		return result["stat"];
+	}
+	async read(path, range) {
+		const req = range ? {
+			op: "read",
+			path,
+			offset: range.offset,
+			length: range.length
+		} : {
+			op: "read",
+			path
+		};
+		const { blob } = await this.request(req, null);
+		return blob;
+	}
+	async write(path, data) {
+		await this.request({
+			op: "write",
+			path
+		}, data);
+	}
+	async mkdir(path) {
+		await this.request({
+			op: "mkdir",
+			path
+		}, null);
+	}
+	async rename(oldPath, newPath) {
+		await this.request({
+			op: "rename",
+			oldPath,
+			newPath
+		}, null);
+	}
+	async remove(path) {
+		await this.request({
+			op: "remove",
+			path
+		}, null);
+	}
+	async exists(path) {
+		const { result } = await this.request({
+			op: "exists",
+			path
+		}, null);
+		return result["exists"] === true;
+	}
+	close() {
+		this.closedReason ??= "closed by caller";
+		this.ws.close();
+	}
+};
+
 //#endregion
 //#region src/commands/fs.ts
 /**
-* POSIX-quote one word so the remote shell treats it as a single token. Wraps
-* `shell-quote`'s `quote` (already a repo dependency, used elsewhere in the
-* CLI) rather than hand-rolling the escaping — it is the well-tested source of
-* truth for making a path/arg with spaces, quotes, `$`, `;`, globs, etc. inert
-* when interpolated into an `sh -c` line.
-*/
-function shellQuote(word) {
-	return quote([word]);
-}
-const MISSING_FILE_EXIT = 44;
-/**
-* Build the remote shell command that base64-encodes a file to stdout. Exits
-* {@link MISSING_FILE_EXIT} when the path doesn't exist, 1 when it's a
-* directory, so the caller can tell "create new" from a genuine error.
-*/
-function buildReadCommand(path) {
-	const q = shellQuote(path);
-	return `sh -c ${shellQuote(`if [ ! -e ${q} ]; then exit ${MISSING_FILE_EXIT}; fi; if [ -d ${q} ]; then echo 'path is a directory' >&2; exit 1; fi; base64 < ${q}`)}`;
-}
-/**
-* Build the remote shell command that decodes `b64` and writes it to `path`
-* atomically (temp file + `mv`) so a dropped connection can't truncate the
-* original in place. `token` is a caller-supplied unique suffix for the temp
-* file — generated in JS (not the shell's `$$`, which shell-quote would escape
-* to a literal, so every write would collide on the same temp name).
-*/
-function buildWriteCommand(path, b64, token) {
-	const tmp = `${path}.skydive-edit.${token}`;
-	return `sh -c ${shellQuote(`printf %s ${shellQuote(b64)} | base64 -d > ${shellQuote(tmp)} && mv -f ${shellQuote(tmp)} ${shellQuote(path)}`)}`;
-}
-/**
 * Resolve the editor command from an explicit override, then $VISUAL, $EDITOR,
 * then `vi`. Split so `EDITOR="code --wait"` (command + flags) is honored.
 */
@@ -2934,17 +3046,17 @@ function resolveEditor(override, env) {
 /**
 * `skydive fs edit <path>` — edit a file that lives on the agent's computer
 * (its sandbox) with your LOCAL editor. It reads the remote file down over the
-* same relay `skydive sandbox` uses, opens it in `$EDITOR`, and writes your
-* changes back when you save and close — so you edit a remote file as if it
-* were local, without opening the chat TUI.
+* multiplexed `fs` sandbox-stream channel, opens it in `$EDITOR`, and writes
+* your changes back when you save and close — so you edit a remote file as if
+* it were local, without opening the chat TUI.
 *
-* There is no server-side "file" endpoint yet: this rides entirely on the
-* existing one-shot `exec` mode of the sandbox stream. Contents move
-* base64-encoded in BOTH directions (exec has no stdin, so the write payload is
-* embedded in the command string) which keeps binary bytes, trailing newlines,
-* and CRLF intact. Access gating (EDIT on the agent + the sandbox kill switch)
-* is enforced by the relay, exactly as for `skydive sandbox`. A future PR adds
-* a first-class `fs` channel that `edit` (and `fs mount`) will ride instead.
+* It rides the first-class `fs` relay channel ({@link SandboxFsClient}): file
+* bytes move as the frame's trailing binary blob in BOTH directions, so binary
+* content, trailing newlines, and CRLF are preserved and — unlike the old
+* exec-mode path that embedded a base64 payload in the upgrade URL — a large
+* file no longer blows past the WebSocket URL / request-header length limit.
+* Access gating (EDIT on the agent + the `sandbox-fs-enabled` kill switch) is
+* enforced by the relay, exactly as for `skydive sandbox`.
 */
 const fsEditCommand = {
 	command: "edit <path>",
@@ -2963,8 +3075,8 @@ const fsEditCommand = {
 	handler: async (argv) => {
 		const session = requireSession(argv);
 		const remotePath = argv.path;
-		const { createRestClient } = await import("./rest-CaWUSrnH.mjs");
-		const { resolveAgent } = await import("./print-B9djx8GU.mjs");
+		const { createRestClient } = await import("./rest-v-7FQqLP.mjs");
+		const { resolveAgent } = await import("./print-DV9L41G2.mjs");
 		const client = createRestClient({
 			appUrl: session.appUrl,
 			sessionToken: session.sessionToken
@@ -2979,148 +3091,63 @@ const fsEditCommand = {
 			printError(error instanceof Error ? error.message : String(error));
 			process.exit(1);
 		}
-		const opts = {
-			session,
-			agentId: agent.id
-		};
-		console.error(`Reading ${remotePath} from ${agent.name}'s sandbox…`);
-		const read = await readRemote({
-			...opts,
-			path: remotePath
-		});
-		if (read.kind === "error") {
-			printError(read.message);
+		let fs;
+		try {
+			fs = await SandboxFsClient.connect({
+				appUrl: session.appUrl,
+				sessionToken: session.sessionToken,
+				agentId: agent.id
+			});
+		} catch (error) {
+			printError(`Could not open the sandbox filesystem channel: ${error instanceof Error ? error.message : String(error)}`);
 			process.exit(1);
 		}
-		const original = read.content;
-		if (read.kind === "missing") console.error(`${remotePath} does not exist yet — it will be created when you save.`);
-		const dir = await mkdtemp(join(tmpdir(), "skydive-edit-"));
-		const local = join(dir, remotePath.split("/").pop() || "file");
+		const cleanup = async (dir) => {
+			await rm(dir, {
+				recursive: true,
+				force: true
+			}).catch((error) => {
+				console.error(`Note: could not remove temp dir ${dir}: ${error instanceof Error ? error.message : String(error)}`);
+			});
+		};
+		let local = null;
+		let dir = null;
 		try {
+			console.error(`Reading ${remotePath} from ${agent.name}'s sandbox…`);
+			const isNew = !await fs.exists(remotePath);
+			const original = isNew ? Buffer.alloc(0) : Buffer.from(await fs.read(remotePath, null));
+			if (isNew) console.error(`${remotePath} does not exist yet — it will be created when you save.`);
+			dir = await mkdtemp(join(tmpdir(), "skydive-edit-"));
+			const base = remotePath.split("/").pop() || "file";
+			local = join(dir, base);
 			await writeFile(local, original);
 			if (!await openEditor(argv.editor, local)) {
 				printError("Editor exited non-zero; not saving any changes.");
+				fs.close();
+				await cleanup(dir);
 				process.exit(1);
 			}
 			const edited = await readFile(local);
 			if (edited.equals(original)) {
 				console.error("No changes — nothing written.");
+				fs.close();
+				await cleanup(dir);
 				process.exit(0);
 			}
 			console.error(`Writing changes back to ${remotePath}…`);
-			const wrote = await writeRemote({
-				...opts,
-				path: remotePath,
-				content: edited
-			});
-			if (wrote.kind === "error") {
-				printError(`${wrote.message}\nYour edited copy is kept at ${local} so you don't lose it.`);
-				process.exit(1);
-			}
+			await fs.write(remotePath, new Uint8Array(edited));
 			console.error("Saved.");
+			fs.close();
+			await cleanup(dir);
 			process.exit(0);
-		} finally {
-			await rm(dir, {
-				recursive: true,
-				force: true
-			}).catch((error) => {
-				console.error(`Note: could not remove temp dir ${dir}: ${error instanceof Error ? error.message : String(error)}`);
-			});
+		} catch (error) {
+			fs.close();
+			printError(`${error instanceof Error ? error.message : String(error)}${local ? `\nYour edited copy is kept at ${local} so you don't lose it.` : ""}`);
+			process.exit(1);
 		}
 	}
 };
 /**
-* Read a remote file as bytes. Runs `base64` on the file in the sandbox and
-* decodes the streamed stdout locally. Distinguishes "file is missing" (exit
-* code 44, so `edit` can create it) from a real read failure.
-*/
-function readRemote({ session, agentId, path }) {
-	const command = buildReadCommand(path);
-	const chunks = [];
-	const stderr = [];
-	return new Promise((resolve) => {
-		SandboxStream.open({
-			mode: "exec",
-			appUrl: session.appUrl,
-			sessionToken: session.sessionToken,
-			agentId,
-			command,
-			onEvent: (e) => {
-				switch (e.type) {
-					case "data":
-						chunks.push(Buffer.from(e.bytes));
-						break;
-					case "exit":
-						if (e.code === MISSING_FILE_EXIT) resolve({
-							kind: "missing",
-							content: Buffer.alloc(0)
-						});
-						else if (e.code === 0) resolve({
-							kind: "ok",
-							content: Buffer.from(Buffer.concat(chunks).toString("utf8").replace(/\s+/g, ""), "base64")
-						});
-						else resolve({
-							kind: "error",
-							message: stderr.join("").trim() || `Could not read the file (exit ${e.code}).`
-						});
-						break;
-					case "error":
-						stderr.push(e.message);
-						break;
-					case "close":
-						resolve({
-							kind: "error",
-							message: e.failure || "The connection to the sandbox closed before the file could be read."
-						});
-						break;
-				}
-			}
-		});
-	});
-}
-/**
-* Write bytes to a remote file. Exec has no stdin, so the base64 payload is
-* embedded in the command and decoded on the far side. Writes atomically via a
-* temp file + `mv` so a dropped connection mid-write can't leave a truncated
-* file in place of the original.
-*/
-function writeRemote({ session, agentId, path, content }) {
-	const token = randomBytes(6).toString("hex");
-	const command = buildWriteCommand(path, content.toString("base64"), token);
-	const stderr = [];
-	return new Promise((resolve) => {
-		SandboxStream.open({
-			mode: "exec",
-			appUrl: session.appUrl,
-			sessionToken: session.sessionToken,
-			agentId,
-			command,
-			onEvent: (e) => {
-				switch (e.type) {
-					case "data":
-						stderr.push(Buffer.from(e.bytes).toString("utf8"));
-						break;
-					case "exit":
-						resolve(e.code === 0 ? { kind: "ok" } : {
-							kind: "error",
-							message: stderr.join("").trim() || `Could not write the file (exit ${e.code}).`
-						});
-						break;
-					case "error":
-						stderr.push(e.message);
-						break;
-					case "close":
-						resolve({
-							kind: "error",
-							message: e.failure || "The connection to the sandbox closed before the file was written."
-						});
-						break;
-				}
-			}
-		});
-	});
-}
-/**
 * Open `file` in the caller's editor and resolve to whether it exited cleanly.
 * Precedence: explicit `--editor`, then $VISUAL, $EDITOR, then `vi`. The editor
 * inherits the real TTY so full-screen editors (vim/nano) work.
@@ -3143,7 +3170,7 @@ function openEditor(override, file) {
 *
 *   - `fs edit <path>`  edit one remote file with your local editor (shipped).
 *   - `fs mount <dir>`  mount the whole sandbox filesystem locally (coming in a
-*                       later PR, on a first-class `fs` relay channel).
+*                       later PR, on the same first-class `fs` relay channel).
 *
 * Grouping these under one command keeps the file surface discoverable and
 * leaves room to grow (`fs ls`, `fs cat`, `fs pull`) without adding more
@@ -3431,7 +3458,27 @@ function resolveSelfPath(execPath = process.execPath) {
 
 //#endregion
 //#region src/update-check/sources.ts
+/**
+* How this CLI was installed, which decides whether `skydive update` (and the
+* background update check) self-updates the binary from the release CDN or
+* hands off to the package manager.
+*
+* Two signals, runtime env first:
+*   - `SKYDIVE_CLI_INSTALL_SOURCE` env var — set by the npm launcher
+*     (src/launcher.ts) to `package-manager` before it execs the compiled
+*     binary. The binary itself is `--define`'d to `binary`, but when it was
+*     launched via the npm-installed launcher, npm owns its bytes and must not
+*     be self-mutated — so the env override wins.
+*   - The `SKYDIVE_CLI_INSTALL_SOURCE` compile-time constant — stamped
+*     `binary` into the standalone binary, undefined in the npm JS bundle.
+*
+* Any value other than exactly `binary` (including unset) means
+* package-manager, the safe default: we never self-update something we can't
+* prove is a standalone binary.
+*/
 function resolveInstallSource() {
+	const runtime = typeof process !== "undefined" ? process.env?.["SKYDIVE_CLI_INSTALL_SOURCE"] : void 0;
+	if (runtime !== void 0) return runtime === "binary" ? "binary" : "package-manager";
 	return typeof SKYDIVE_CLI_INSTALL_SOURCE === "string" && SKYDIVE_CLI_INSTALL_SOURCE === "binary" ? "binary" : "package-manager";
 }
 const NPM_REGISTRY_URL = "https://registry.npmjs.org";
@@ -3859,7 +3906,7 @@ function snapshot(pref) {
 		describe: pref.describe
 	};
 }
-const listCommand = {
+const listCommand$1 = {
 	command: "list",
 	aliases: ["ls"],
 	describe: "Show every editable preference, its value, and its source",
@@ -3950,7 +3997,7 @@ const unsetCommand = {
 		}
 	}
 };
-const pathCommand = {
+const pathCommand$1 = {
 	command: "path",
 	describe: "Print the on-disk config file path",
 	handler: (argv) => {
@@ -3964,14 +4011,172 @@ const pathCommand = {
 const configCommand = {
 	command: "config",
 	describe: "View and set CLI preferences (safe, hand-editable keys only)",
-	builder: (y) => y.command(listCommand).command(getCommand).command(setCommand).command(unsetCommand).command(pathCommand),
+	builder: (y) => y.command(listCommand$1).command(getCommand).command(setCommand).command(unsetCommand).command(pathCommand$1),
+	handler: (argv) => listCommand$1.handler(argv)
+};
+
+//#endregion
+//#region src/commands/logs.ts
+const ISSUE_REPOSITORY_URL = "https://github.com/Create-Inc/skydive-cli";
+function issueUrl(archivePath) {
+	const url = new URL(`${ISSUE_REPOSITORY_URL}/issues/new`);
+	url.searchParams.set("title", "CLI issue: ");
+	url.searchParams.set("body", [
+		"## What happened?",
+		"",
+		"<!-- Tell us what you were doing and what went wrong. -->",
+		"",
+		"## Diagnostics",
+		"",
+		`Please attach \`${path.basename(archivePath)}\` to this issue.`
+	].join("\n"));
+	return url.toString();
+}
+async function listLogSessions(activeSessionPath = profileDir()) {
+	const root = getAutomaticLogsDir();
+	try {
+		const entries = await fs.promises.readdir(root, { withFileTypes: true });
+		return (await Promise.all(entries.filter((entry) => entry.isDirectory() && path.join(root, entry.name) !== activeSessionPath).map(async (entry) => {
+			const sessionPath = path.join(root, entry.name);
+			return {
+				name: entry.name,
+				path: sessionPath,
+				modifiedAt: (await fs.promises.stat(sessionPath)).mtime.toISOString()
+			};
+		}))).sort((a, b) => b.name.localeCompare(a.name));
+	} catch (_error) {
+		return [];
+	}
+}
+async function resolveSession(name) {
+	const sessions = await listLogSessions();
+	const session = name ? sessions.find((candidate) => candidate.name === name) : sessions[0];
+	if (session) return session;
+	printError(name ? `Log session "${name}" was not found. Run \`skydive logs list\`.` : "No diagnostic logs found yet.");
+	process.exit(1);
+}
+async function offerIssueReport(archivePath) {
+	if (!process.stdin.isTTY || !process.stdout.isTTY) {
+		console.log(`Report an issue: ${ISSUE_REPOSITORY_URL}`);
+		return;
+	}
+	const prompt = createInterface$1({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		if ((await prompt.question("Open a prefilled GitHub issue in your browser? [Y/n] ")).trim().toLowerCase() === "n") {
+			console.log(`File an issue: ${ISSUE_REPOSITORY_URL}`);
+			return;
+		}
+		await open(issueUrl(archivePath));
+		console.log(`Attach the diagnostics archive: ${archivePath}`);
+	} finally {
+		prompt.close();
+	}
+}
+async function createArchive(source, destination) {
+	await new Promise((resolve, reject) => {
+		const child = spawn("tar", [
+			"-czf",
+			destination,
+			"-C",
+			path.dirname(source),
+			path.basename(source)
+		], { stdio: [
+			"ignore",
+			"ignore",
+			"pipe"
+		] });
+		const stderr = [];
+		child.stderr.on("data", (chunk) => stderr.push(chunk));
+		child.once("error", reject);
+		child.once("close", (code) => {
+			if (code === 0) {
+				resolve();
+				return;
+			}
+			reject(new Error(Buffer.concat(stderr).toString("utf8").trim() || "Could not archive logs."));
+		});
+	});
+}
+const listCommand = {
+	command: "list",
+	aliases: ["ls"],
+	describe: "List recent diagnostic sessions",
+	handler: async (argv) => {
+		const sessions = await listLogSessions();
+		if (argv.json) {
+			output(argv, sessions);
+			return;
+		}
+		if (sessions.length === 0) {
+			console.log("No diagnostic logs found yet.");
+			return;
+		}
+		printTable(["Session", "Modified"], sessions.map((session) => [session.name, session.modifiedAt]));
+	}
+};
+const pathCommand = {
+	command: "path [session]",
+	describe: "Print a diagnostic session directory (latest by default)",
+	builder: (y) => y.positional("session", {
+		type: "string",
+		describe: "Session name from `skydive logs list`"
+	}),
+	handler: async (argv) => {
+		const session = await resolveSession(argv.session);
+		if (argv.json) {
+			output(argv, session);
+			return;
+		}
+		console.log(session.path);
+	}
+};
+const exportCommand = {
+	command: "export [session]",
+	describe: "Archive a diagnostic session for sharing (latest by default)",
+	builder: (y) => y.positional("session", {
+		type: "string",
+		describe: "Session name from `skydive logs list`"
+	}).option("output", {
+		alias: "o",
+		type: "string",
+		describe: "Archive path (defaults to the current directory)"
+	}),
+	handler: async (argv) => {
+		const session = await resolveSession(argv.session);
+		const destination = path.resolve(argv.output ?? `skydive-logs-${session.name}.tar.gz`);
+		try {
+			await createArchive(session.path, destination);
+		} catch (error) {
+			printError(error instanceof Error ? error.message : String(error));
+			process.exit(1);
+		}
+		if (argv.json) {
+			output(argv, {
+				path: destination,
+				session: session.name,
+				issueUrl: issueUrl(destination),
+				repositoryUrl: ISSUE_REPOSITORY_URL
+			});
+			return;
+		}
+		console.log(destination);
+		await offerIssueReport(destination);
+	}
+};
+const logsCommand = {
+	command: "logs",
+	describe: "Find and export recent local diagnostic logs",
+	builder: (y) => y.command(listCommand).command(pathCommand).command(exportCommand),
 	handler: (argv) => listCommand.handler(argv)
 };
 
 //#endregion
 //#region src/cli.ts
 function createCli(argv) {
-	return yargs(argv).scriptName("skydive").usage("$0 <command> [options]").parserConfiguration({ "populate--": true }).example("skydive auth login", "Store your API key").example("skydive chat", "Open the interactive chat TUI (prod)").example("skydive chat --api-url http://localhost:4500", "Chat against a local dev API").example("skydive agents list", "List your agents").example("skydive completion install", "Set up TAB completion for your shell").example("skydive keys create \"my-key\"", "Create an API key").example("skydive secrets set OPENAI_API_KEY --agent-id <id>", "Set a secret (value from stdin)").example("skydive workspace list", "List workspaces on your account").example("skydive config set updateCheck false", "Disable the daily update check").example("skydive workspace switch acme-team", "Switch the workspace all `skydive` commands act on").example("skydive portal open --agent grace", "Open the portal to this machine for an agent, headless (no TUI)").example("skydive fs edit --agent grace /tmp/notes.md", "Edit a file on the agent's computer with your local editor").option("json", {
+	return yargs(argv).scriptName("skydive").usage("$0 <command> [options]").parserConfiguration({ "populate--": true }).example("skydive auth login", "Store your API key").example("skydive chat", "Open the interactive chat TUI (prod)").example("skydive chat --api-url http://localhost:4500", "Chat against a local dev API").example("skydive agents list", "List your agents").example("skydive completion install", "Set up TAB completion for your shell").example("skydive keys create \"my-key\"", "Create an API key").example("skydive secrets set OPENAI_API_KEY --agent-id <id>", "Set a secret (value from stdin)").example("skydive workspace list", "List workspaces on your account").example("skydive config set updateCheck false", "Disable the daily update check").example("skydive logs export", "Archive the latest local diagnostics for sharing").example("skydive workspace switch acme-team", "Switch the workspace all `skydive` commands act on").example("skydive portal open --agent grace", "Open the portal to this machine for an agent, headless (no TUI)").example("skydive fs edit --agent grace /tmp/notes.md", "Edit a file on the agent's computer with your local editor").option("json", {
 		type: "boolean",
 		default: false,
 		global: true,
@@ -3985,7 +4190,7 @@ function createCli(argv) {
 		type: "string",
 		global: true,
 		describe: "Override API base URL"
-	}).command(authCommand).command(chatCommand).command(messagesCommand).command(conversationsCommand).command(agentsCommand).command(importCommand).command(keysCommand).command(secretsCommand).command(workspaceCommand).command(portalCommand).command(sandboxCommand).command(fsCommand).command(updateCommand).command(configCommand).command(completionCommand).demandCommand(1, "Specify a command. Run --help for usage.").strict().wrap(null).version(version).alias("v", "version").alias("h", "help").help().fail((msg, err) => {
+	}).command(authCommand).command(chatCommand).command(messagesCommand).command(conversationsCommand).command(agentsCommand).command(importCommand).command(keysCommand).command(secretsCommand).command(workspaceCommand).command(portalCommand).command(sandboxCommand).command(fsCommand).command(updateCommand).command(configCommand).command(logsCommand).command(completionCommand).demandCommand(1, "Specify a command. Run --help for usage.").strict().wrap(null).version(version).alias("v", "version").alias("h", "help").help().fail((msg, err) => {
 		printError(err ? err instanceof Error ? err.message : String(err) : msg ?? "Unknown error");
 		process.exit(1);
 	});
@@ -4198,7 +4403,7 @@ function setupUpdateCheck(argv) {
 
 //#endregion
 //#region src/changelog.generated.ts
-const CHANGELOG_MD = "# Changelog\n\nAll notable changes to the Skydive CLI are documented here.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]\n\n### Added\n\n- `/search` (alias `/find`) in the chat TUI — opens the conversation picker with its search field focused, so \"find a conversation\" has a discoverable command instead of being a feature you had to know the bare picker already had. Pass a query inline (`/search billing deep dive`) and the picker opens already narrowed to the matches; bare `/search` opens it ready for you to type. The search runs server-side across conversation titles, message bodies, and participant names, the same search the picker exposes.\n- First run in a workspace with no agents now sets you up automatically: instead of dropping you on an empty agent picker, `skydive` creates your first agent for you (with a suggested name and avatar, mirroring the web onboarding flow) and then offers to have it learn how you already work — reading the other coding agents set up on your machine (Claude Code, Cursor, Codex, and more), the same import that `skydive import` runs, with a plan shown first and credentials never copied. Decline and you go straight into the new agent's chat. You can replay this flow anytime with `skydive --onboarding` (or `SKYDIVE_FORCE_ONBOARDING=1`), even in a workspace that already has agents.\n- `/computer` (alias `/stats`) in the chat TUI — a snapshot of the agent's sandbox drawn as colored bar graphs: CPU, memory, and disk usage. Bars turn amber past 75%% and red past 90%% so a glance tells you whether the box is under pressure. The numbers come from the Skydive API (the same live resource sample the web computer view reads), not by connecting to the sandbox — so the card shows instantly, never waking or hanging on a box that isn't running: when the agent has no live sandbox it simply reads \"no sandbox running\". The card keeps itself current quietly (a slow background refresh, no flicker or \"updating\" chrome); only the most recent card refreshes, and it silently stops while you're scrolled up (no wasted polls on a card you're not looking at) and resumes at the bottom.\n- `skydive fs` — a namespace for working with the files on an agent's computer (its sandbox) from your own machine. Its first subcommand, `skydive fs edit <path>`, reads a remote file down over the same relay `skydive sandbox` uses, opens it in your local editor (`$VISUAL`/`$EDITOR`, override with `--editor`, defaults to `vi`), and writes your changes back atomically when you save and close — so you can edit a remote file as if it were local without opening the chat TUI. A path that doesn't exist yet is created on save; no changes means nothing is written. Access is gated on EDIT permission for the agent, exactly like `skydive sandbox`. (A first-class `fs` relay channel and `skydive fs mount` land in follow-ups.)\n\n## [0.4.0] - 2026-08-07\n\n### Added\n\n- `skydive chat` works with API key auth: an API key alone now opens the chat TUI (and headless `chat -p`) without a browser login, using the key's pinned workspace.\n- `skydive config` command to view and set the safe, hand-editable CLI preferences (`shareMachineDefault`, `updateCheck`) without opening `config.json`. `config`/`config list` shows each key, its effective value, and whether it comes from the file or the built-in default; `config get`/`set`/`unset` read and change one key; `config path` prints the config file location. It only ever touches those preference keys, never credentials or flow-managed state.\n- Billing-blocked sends and runs now surface the server-authored recovery\n  guidance from the typed billing outcome. The chat TUI renders it as a\n  warning-toned system-notice row — live when a send is refused or a run is\n  stopped at the billing boundary, and again when reopening a conversation\n  that holds a persisted billing notice — instead of a generic error.\n  Headless `chat -p` and `messages get` print the guidance (state, recovery\n  step, and manage-billing URL) on stderr, keep any partial output already\n  streamed on stdout, and exit with code `5` (distinct from the generic `1`)\n  so scripted callers can tell a billing pause from a failure.\n- Syntax highlighting for 14 more languages in the chat transcript and file/review panes (python, bash, go, rust, c, cpp, java, ruby, css, html, json, yaml, and more) — previously only JavaScript/TypeScript rendered colored.\n\n### Changed\n\n- `skydive agent list` lists the full agent roster by default instead of a truncated page.\n\n### Fixed\n\n- Long multi-line bash tool-call commands (e.g. heredocs) are clamped with a `+N more · click to expand` tail instead of dumping their whole body into the scrollback.\n- Tool error output is clipped the same way as ok output, so a failing command no longer floods the transcript.\n- The TUI toast overlay has an opaque background instead of letting the transcript bleed through.\n\n## [0.3.0] - 2026-08-04\n\n### Added\n\n**Chat TUI**\n\n- `/fork` slash command to fork a conversation at any point and continue in a new thread.\n- `/conversation` switches threads from inside a live session.\n- `/compact` triggers manual conversation compaction.\n- `/portal` and `/copy` slash commands.\n- Archive the current conversation from the chat TUI.\n- `--new` flag on `skydive chat` to start a fresh conversation.\n- Debounced server-side conversation search in the picker, with title matches ranked first.\n- File review pane orientation toggle, and review comments in the file pane.\n- Pinned plan card controls and a jump-to-latest hint.\n- Terminal title (OSC) follows the live conversation title on every screen; inside cmux the workspace is renamed too, and linked PRs are pushed to the cmux sidebar.\n- Every participating agent shows in the conversation list; connect cards each have their own identity, and ctrl+r asks which connect card to act on.\n- Colored Skydive splash art in `skydive --help` and the TUI pickers.\n- New-agent name prefilled from the server's suggestion.\n\n**CLI & platform**\n\n- `skydive update` self-updater, with an update notice when a new version is available.\n- Shell completions for bash, zsh, and fish via `completion install`.\n- Portal daemon: one connection per host with per-conversation working directories.\n- Agent-led coding-agent import (`skydive import`).\n- Per-workspace scoping on the REST client, and cross-org `--agent <uuid>` auto-switches workspace.\n- `skydive-beta` wrapper for the canary channel.\n\n### Fixed\n\n- `skydive update` no longer claims an update is available on every npm install.\n- Chat memory is bounded (payload clamps + windowed rows) with a memory watchdog and OOM diagnostic report; transcript rows are memoized so streaming stops re-rendering the whole chat.\n- Chat-send failures map to real error messages.\n- Notification and sidebar previews use the last text block of the reply and strip inline markdown.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n- Sending to non-web channel conversations is blocked in the TUI.\n- GitHub bot connect opens on the web front door, not api.skydive.com.\n- TUI activity counter times from the run, not the screen.\n\n## [0.2.0] - 2026-07-29\n\n### Added\n\n**Sandbox & machine access**\n\n- Standalone `skydive sandbox` command for direct access to an agent's sandbox.\n- `/sandbox` in the chat TUI — live PTY session and one-shot command execution.\n- Headless machine sharing via `skydive portal`, with self-registering portal grants.\n- `shareMachineDefault` config key for always-on portal sharing.\n\n**Chat TUI**\n\n- File pane (`ctrl+g`) with Changes and Files tabs: a shared file tree plus source viewer and a workspace browser, mouse-resizable and responsive to terminal size.\n- Agent todo list rendered in the chat TUI, above the composer, mirroring the web chat's todo card.\n- Fuzzy finder in the conversation and agent pickers.\n- Slash-command autocomplete menu.\n- Paste or drag-and-drop any file into the composer; paste clipboard images with Cmd+V.\n- Run local shell commands with `!` in the composer.\n- Conversation recaps, streamed live title updates, and per-agent attribution on assistant turns.\n- Working timer rolls up into minutes and hours.\n- Conversation picker paginates past 50 conversations and shows only your own conversations.\n- Esc leaves a live run; typing `exit` quits the chat.\n- Cursor Dark theme.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n\n**Headless & scripting**\n\n- Resume a conversation by id.\n- `conversations list` and `conversations show` for transcript reads.\n- `messages get`, with run recovery keyed on message id.\n- Connect cards surface in headless `-p` mode so a driving agent never gets stuck.\n\n**Authentication**\n\n- `skydive auth login` via the browser now auto-mints an API key, so one login yields both a chat session and a usable management credential. Management commands announce the key's pinned workspace when it drives them, so a workspace mismatch is visible at use time.\n- Workspace picker on the device authorization page.\n- Account and workspace identity shown in `auth status`.\n\n**Platform**\n\n- Standalone binary builds compiling the CLI into a per-target executable.\n- Interactive workspace switcher; management commands follow the active workspace.\n- Terminal host integrations and agent notifications.\n\n### Fixed\n\n- Transcript errors collapse to one line, click to expand (REST and portal errors keep their full body).\n- Dragged/pasted image file paths attach the file instead of inserting path text, including macOS paths with literal parentheses.\n- Bare URLs in chat markdown are hyperlinked so they survive text wrap.\n- Composer draft is preserved across TUI overlays.\n- Relative connect links resolve before opening the browser.\n- Numbered markdown headings render colored in the TUI.\n- Chat transcript pages by 75% of a screen; picker rows stay on one line.\n- Run starts push to the TUI over the conversation stream.\n- Security: remediated high-severity dependency findings and cleared tar/shell-quote CVEs.\n\n## [0.1.0] - 2026-07-21\n\nInitial public release: `skydive chat` TUI, agent and conversation management,\ndevice authorization, and headless `-p` mode.\n";
+const CHANGELOG_MD = "# Changelog\n\nAll notable changes to the Skydive CLI are documented here.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]\n\n### Changed\n\n- `npm i -g skydive-cli` (and yarn/pnpm/bun) now installs a tiny launcher plus one prebuilt, os/cpu-matched binary that carries its own runtime — so on the common platforms `skydive chat` and `skydive import` start instantly and **do not download a Bun runtime on first use**. On any platform without a prebuilt binary (or if the optional dependency is skipped), the CLI automatically falls back to the existing behavior: it runs under your Node and provisions Bun on first `chat`, exactly as before. Nothing about the commands, flags, config, or `SKYDIVE_*` environment variables changes, and `skydive update` still upgrades npm installs via your package manager and standalone-binary installs in place.\n\n### Added\n\n- `/search` (alias `/find`) in the chat TUI — opens the conversation picker with its search field focused, so \"find a conversation\" has a discoverable command instead of being a feature you had to know the bare picker already had. Pass a query inline (`/search billing deep dive`) and the picker opens already narrowed to the matches; bare `/search` opens it ready for you to type. The search runs server-side across conversation titles, message bodies, and participant names, the same search the picker exposes.\n- First run in a workspace with no agents now sets you up automatically: instead of dropping you on an empty agent picker, `skydive` creates your first agent for you (with a suggested name and avatar, mirroring the web onboarding flow) and then offers to have it learn how you already work — reading the other coding agents set up on your machine (Claude Code, Cursor, Codex, and more), the same import that `skydive import` runs, with a plan shown first and credentials never copied. Decline and you go straight into the new agent's chat. You can replay this flow anytime with `skydive --onboarding` (or `SKYDIVE_FORCE_ONBOARDING=1`), even in a workspace that already has agents.\n- `/computer` (alias `/stats`) in the chat TUI — a snapshot of the agent's sandbox drawn as colored bar graphs: CPU, memory, and disk usage. Bars turn amber past 75%% and red past 90%% so a glance tells you whether the box is under pressure. The numbers come from the Skydive API (the same live resource sample the web computer view reads), not by connecting to the sandbox — so the card shows instantly, never waking or hanging on a box that isn't running: when the agent has no live sandbox it simply reads \"no sandbox running\". The card keeps itself current quietly (a slow background refresh, no flicker or \"updating\" chrome); only the most recent card refreshes, and it silently stops while you're scrolled up (no wasted polls on a card you're not looking at) and resumes at the bottom.\n- `skydive fs` — a namespace for working with the files on an agent's computer (its sandbox) from your own machine. Its first subcommand, `skydive fs edit <path>`, reads a remote file down over the same relay `skydive sandbox` uses, opens it in your local editor (`$VISUAL`/`$EDITOR`, override with `--editor`, defaults to `vi`), and writes your changes back atomically when you save and close — so you can edit a remote file as if it were local without opening the chat TUI. A path that doesn't exist yet is created on save; no changes means nothing is written. Access is gated on EDIT permission for the agent, exactly like `skydive sandbox`. (A first-class `fs` relay channel and `skydive fs mount` land in follow-ups.)\n\n## [0.4.0] - 2026-08-07\n\n### Added\n\n- `skydive chat` works with API key auth: an API key alone now opens the chat TUI (and headless `chat -p`) without a browser login, using the key's pinned workspace.\n- `skydive config` command to view and set the safe, hand-editable CLI preferences (`shareMachineDefault`, `updateCheck`) without opening `config.json`. `config`/`config list` shows each key, its effective value, and whether it comes from the file or the built-in default; `config get`/`set`/`unset` read and change one key; `config path` prints the config file location. It only ever touches those preference keys, never credentials or flow-managed state.\n- Billing-blocked sends and runs now surface the server-authored recovery\n  guidance from the typed billing outcome. The chat TUI renders it as a\n  warning-toned system-notice row — live when a send is refused or a run is\n  stopped at the billing boundary, and again when reopening a conversation\n  that holds a persisted billing notice — instead of a generic error.\n  Headless `chat -p` and `messages get` print the guidance (state, recovery\n  step, and manage-billing URL) on stderr, keep any partial output already\n  streamed on stdout, and exit with code `5` (distinct from the generic `1`)\n  so scripted callers can tell a billing pause from a failure.\n- Syntax highlighting for 14 more languages in the chat transcript and file/review panes (python, bash, go, rust, c, cpp, java, ruby, css, html, json, yaml, and more) — previously only JavaScript/TypeScript rendered colored.\n\n### Changed\n\n- `skydive agent list` lists the full agent roster by default instead of a truncated page.\n\n### Fixed\n\n- Long multi-line bash tool-call commands (e.g. heredocs) are clamped with a `+N more · click to expand` tail instead of dumping their whole body into the scrollback.\n- Tool error output is clipped the same way as ok output, so a failing command no longer floods the transcript.\n- The TUI toast overlay has an opaque background instead of letting the transcript bleed through.\n\n## [0.3.0] - 2026-08-04\n\n### Added\n\n**Chat TUI**\n\n- `/fork` slash command to fork a conversation at any point and continue in a new thread.\n- `/conversation` switches threads from inside a live session.\n- `/compact` triggers manual conversation compaction.\n- `/portal` and `/copy` slash commands.\n- Archive the current conversation from the chat TUI.\n- `--new` flag on `skydive chat` to start a fresh conversation.\n- Debounced server-side conversation search in the picker, with title matches ranked first.\n- File review pane orientation toggle, and review comments in the file pane.\n- Pinned plan card controls and a jump-to-latest hint.\n- Terminal title (OSC) follows the live conversation title on every screen; inside cmux the workspace is renamed too, and linked PRs are pushed to the cmux sidebar.\n- Every participating agent shows in the conversation list; connect cards each have their own identity, and ctrl+r asks which connect card to act on.\n- Colored Skydive splash art in `skydive --help` and the TUI pickers.\n- New-agent name prefilled from the server's suggestion.\n\n**CLI & platform**\n\n- `skydive update` self-updater, with an update notice when a new version is available.\n- Shell completions for bash, zsh, and fish via `completion install`.\n- Portal daemon: one connection per host with per-conversation working directories.\n- Agent-led coding-agent import (`skydive import`).\n- Per-workspace scoping on the REST client, and cross-org `--agent <uuid>` auto-switches workspace.\n- `skydive-beta` wrapper for the canary channel.\n\n### Fixed\n\n- `skydive update` no longer claims an update is available on every npm install.\n- Chat memory is bounded (payload clamps + windowed rows) with a memory watchdog and OOM diagnostic report; transcript rows are memoized so streaming stops re-rendering the whole chat.\n- Chat-send failures map to real error messages.\n- Notification and sidebar previews use the last text block of the reply and strip inline markdown.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n- Sending to non-web channel conversations is blocked in the TUI.\n- GitHub bot connect opens on the web front door, not api.skydive.com.\n- TUI activity counter times from the run, not the screen.\n\n## [0.2.0] - 2026-07-29\n\n### Added\n\n**Sandbox & machine access**\n\n- Standalone `skydive sandbox` command for direct access to an agent's sandbox.\n- `/sandbox` in the chat TUI — live PTY session and one-shot command execution.\n- Headless machine sharing via `skydive portal`, with self-registering portal grants.\n- `shareMachineDefault` config key for always-on portal sharing.\n\n**Chat TUI**\n\n- File pane (`ctrl+g`) with Changes and Files tabs: a shared file tree plus source viewer and a workspace browser, mouse-resizable and responsive to terminal size.\n- Agent todo list rendered in the chat TUI, above the composer, mirroring the web chat's todo card.\n- Fuzzy finder in the conversation and agent pickers.\n- Slash-command autocomplete menu.\n- Paste or drag-and-drop any file into the composer; paste clipboard images with Cmd+V.\n- Run local shell commands with `!` in the composer.\n- Conversation recaps, streamed live title updates, and per-agent attribution on assistant turns.\n- Working timer rolls up into minutes and hours.\n- Conversation picker paginates past 50 conversations and shows only your own conversations.\n- Esc leaves a live run; typing `exit` quits the chat.\n- Cursor Dark theme.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n\n**Headless & scripting**\n\n- Resume a conversation by id.\n- `conversations list` and `conversations show` for transcript reads.\n- `messages get`, with run recovery keyed on message id.\n- Connect cards surface in headless `-p` mode so a driving agent never gets stuck.\n\n**Authentication**\n\n- `skydive auth login` via the browser now auto-mints an API key, so one login yields both a chat session and a usable management credential. Management commands announce the key's pinned workspace when it drives them, so a workspace mismatch is visible at use time.\n- Workspace picker on the device authorization page.\n- Account and workspace identity shown in `auth status`.\n\n**Platform**\n\n- Standalone binary builds compiling the CLI into a per-target executable.\n- Interactive workspace switcher; management commands follow the active workspace.\n- Terminal host integrations and agent notifications.\n\n### Fixed\n\n- Transcript errors collapse to one line, click to expand (REST and portal errors keep their full body).\n- Dragged/pasted image file paths attach the file instead of inserting path text, including macOS paths with literal parentheses.\n- Bare URLs in chat markdown are hyperlinked so they survive text wrap.\n- Composer draft is preserved across TUI overlays.\n- Relative connect links resolve before opening the browser.\n- Numbered markdown headings render colored in the TUI.\n- Chat transcript pages by 75% of a screen; picker rows stay on one line.\n- Run starts push to the TUI over the conversation stream.\n- Security: remediated high-severity dependency findings and cleared tar/shell-quote CVEs.\n\n## [0.1.0] - 2026-07-21\n\nInitial public release: `skydive chat` TUI, agent and conversation management,\ndevice authorization, and headless `-p` mode.\n";
 
 //#endregion
 //#region src/whats-new.ts
@@ -4341,7 +4546,7 @@ if (process.argv.includes(UPDATE_WORKER_FLAG)) {
 	process.exit(0);
 }
 if (process.argv.includes(PORTAL_DAEMON_FLAG)) {
-	const { runPortalDaemon } = await import("./daemon-Btd2436i.mjs");
+	const { runPortalDaemon } = await import("./daemon-Dg89tpOE.mjs");
 	runPortalDaemon(process.argv);
 } else runCli();
 function runCli() {