@dev.fast/whiteboard 0.2.5-preview.20261015.119 → 0.2.5-preview.20261016.121

package/dist/{account-alias-C1ixP6bt.js → account-alias-CwNaMOwU.js}

@@ -1,11 +1,13 @@
-import { w as ReviewCliInstallStampSchema } from "./src-HnIPjtjx.js";
-import { $ as removeAgentTraceHook, C as disableTraceMachine, E as traceMachineStatus, G as listTraceRepositoryRoots, K as traceRepositoryStatus, Q as installHarnessHooks, S as configureTraceMachine, T as traceMachineEnabled, U as disableAllTraceRepositories, W as enableTraceRepository, Y as AGENT_TRACE_HOOK_AGENTS, Z as describeTraceHookOwners, ft as StoreClient, n as reviewDesktopStateDir, rt as traceScope, st as readStoreAuth } from "./review-home-paths-zwevIq4I.js";
+import { n as isJsonObject } from "./src-X9phtB2j.js";
+import { w as ReviewCliInstallStampSchema } from "./src-DZG1xAqW.js";
+import { C as disableTraceMachine, E as traceMachineStatus, G as listTraceRepositoryRoots, K as traceRepositoryStatus, Q as removeAgentTraceHook, S as configureTraceMachine, T as traceMachineEnabled, U as disableAllTraceRepositories, W as enableTraceRepository, X as describeTraceHookOwners, Y as AGENT_TRACE_HOOK_AGENTS, Z as installHarnessHooks, dt as StoreClient, n as reviewDesktopStateDir, nt as traceScope, ot as readStoreAuth } from "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock, F as writeFileAtomicAsync, I as writePrivateJsonAtomic, M as devReviewHome } from "./s3-config-DDWWMh5x.js";
-import { i as readReviewPackageVersion } from "./package-paths-BsuI4WUf.js";
-import { n as isFile, t as isDirectory } from "./fs-utils-BMPLt0cr.js";
+import { i as readReviewPackageVersion } from "./package-paths-jMg6JxDP.js";
+import { f as isDirectory, p as isFile } from "./thread-state-CaQ2lGdj.js";
+import { s as findExecutable } from "./fuzzy-match-DFPKdSLR.js";
 import { createHash } from "node:crypto";
 import { constants } from "node:fs";
-import { access, chmod, lstat, readFile, rm, stat } from "node:fs/promises";
+import { access, chmod, lstat, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
 import { execFile } from "node:child_process";
@@ -71,105 +73,131 @@ function fffSteps(input, target) {
 	const root = shellQuote(input.fffCorpusRoot);
 	return [`Unless \`${target} mcp get fff\` finds an existing server, run:\n\n\`\`\`sh\n[ -x ${binary} ] || curl -fsSL ${FFF_INSTALL_URL} | bash\n${target === "claude" ? "claude mcp add -s user" : "codex mcp add"} fff -- ${binary} ${root}\n\`\`\``];
 }
-/** The Claude plugin's sh launch cannot start on Windows, so register the server directly. */
-const CLAUDE_WINDOWS_MCP_ADD = `claude mcp add -s user whiteboard -- ${WINDOWS_MCP_LAUNCH.command} ${WINDOWS_MCP_LAUNCH.args.join(" ")}`;
-/** Copilot CLI loads the Claude plugin, so on Windows it too registers the server directly. */
-const COPILOT_WINDOWS_MCP_ADD = `copilot mcp add whiteboard -- ${WINDOWS_MCP_LAUNCH.command} ${WINDOWS_MCP_LAUNCH.args.join(" ")}`;
-const CONNECT_COMMANDS = {
-	claude: [
-		{ argv: [
-			"claude",
+const WHITEBOARD_MARKETPLACE = "devdotfast/whiteboard";
+const WHITEBOARD_PLUGIN = "whiteboard@devfast";
+const ALREADY = /already/i;
+/** Each CLI agent's connect commands: Connect runs them, prompts print them. */
+function connectSteps(target, launch, platform) {
+	const marketplace = {
+		args: [
 			"plugin",
 			"marketplace",
 			"add",
-			"devdotfast/whiteboard"
-		] },
-		{ argv: [
-			"claude",
+			WHITEBOARD_MARKETPLACE
+		],
+		optional: true
+	};
+	const cleanup = (args, note) => ({
+		args,
+		optional: true,
+		note
+	});
+	const windows = (scope) => [
+		cleanup([
 			"plugin",
-			"install",
-			"whiteboard@devfast",
-			"--scope",
-			"user"
-		] },
+			"uninstall",
+			WHITEBOARD_PLUGIN
+		], "its launch cannot start on Windows, if installed"),
+		cleanup([
+			"mcp",
+			"remove",
+			...scope,
+			"whiteboard"
+		], "old registration, if any"),
 		{
-			argv: [
-				"claude",
+			args: [
 				"mcp",
-				"remove",
-				"-s",
-				"user",
-				"whiteboard"
+				"add",
+				...scope,
+				"whiteboard",
+				"--",
+				launch.command,
+				...launch.args
 			],
-			ifAny: true
+			done: ALREADY
 		}
-	],
-	codex: [
-		{ argv: [
-			"codex",
+	];
+	const plugin = (install, scope) => [
+		marketplace,
+		{
+			args: install,
+			done: ALREADY
+		},
+		cleanup([
+			"mcp",
+			"remove",
+			...scope,
+			"whiteboard"
+		], "old manual registration, if any")
+	];
+	switch (target) {
+		case "claude": return platform === "win32" ? windows(["-s", "user"]) : plugin([
 			"plugin",
-			"marketplace",
-			"add",
-			"devdotfast/whiteboard"
-		] },
-		{ argv: [
-			"codex",
+			"install",
+			WHITEBOARD_PLUGIN,
+			"--scope",
+			"user"
+		], ["-s", "user"]);
+		case "codex": return plugin([
 			"plugin",
 			"add",
-			"whiteboard@devfast"
-		] },
-		{
-			argv: [
-				"codex",
+			WHITEBOARD_PLUGIN
+		], []);
+		case "copilot": return platform === "win32" ? windows([]) : plugin([
+			"plugin",
+			"install",
+			WHITEBOARD_PLUGIN
+		], []);
+		case "opencode": return [{
+			args: [
 				"mcp",
-				"remove",
-				"whiteboard"
+				"add",
+				"--global",
+				"whiteboard",
+				"--",
+				launch.command,
+				...launch.args
 			],
-			ifAny: true
-		}
-	],
-	opencode: [{ argv: [
-		"opencode",
-		"mcp",
-		"add",
-		"--global",
-		"whiteboard",
-		"--",
-		REVIEW_MCP_LAUNCH.command,
-		...REVIEW_MCP_LAUNCH.args
-	] }],
-	pi: [{ argv: [
-		"pi",
-		"install",
-		PI_WHITEBOARD_PACKAGE
-	] }]
-};
-function runBlock(commands) {
-	return `Run:\n\n\`\`\`sh\n${commands.map(({ argv, ifAny }) => `${argv.join(" ")}${ifAny ? " # old manual registration, if any" : ""}`).join("\n")}\n\`\`\``;
+			done: ALREADY
+		}];
+		case "pi": return [{
+			args: [
+				"mcp",
+				"add",
+				"whiteboard",
+				"--",
+				launch.command,
+				...launch.args
+			],
+			done: ALREADY
+		}, cleanup(["remove", PI_WHITEBOARD_PACKAGE], "if installed")];
+	}
+}
+function connectLines(target, launch, platform, cleanups = true) {
+	return connectSteps(target, launch, platform).filter((step) => cleanups || !step.note).map(({ args, note }) => `${shellWords([target, ...args])}${note ? ` # ${note}` : ""}`).join("\n");
+}
+function runBlock(lines) {
+	return `\`\`\`sh\n${lines}\n\`\`\``;
 }
 function pluginSteps(target, platform) {
+	const launch = reviewMcpLaunch(true, platform);
 	switch (target) {
 		case "claude":
-			if (platform === "win32") return [`Run:\n\n\`\`\`sh\nclaude plugin uninstall whiteboard@devfast # its launch cannot start on Windows, if installed\nclaude mcp remove -s user whiteboard # old registration, if any\n${CLAUDE_WINDOWS_MCP_ADD}\n\`\`\``];
-			return [runBlock(CONNECT_COMMANDS.claude)];
-		case "codex": return [runBlock(CONNECT_COMMANDS.codex)];
+		case "codex":
+		case "copilot": return [`Run:\n\n${runBlock(connectLines(target, launch, platform))}`];
 		case "opencode": {
-			const launch = reviewMcpLaunch(true, platform);
 			const entry = JSON.stringify({ whiteboard: {
 				type: "local",
 				command: [launch.command, ...launch.args]
 			} }, null, 2);
-			return [`On OpenCode 2.0 or later, run:\n\n\`\`\`sh\nopencode mcp add --global whiteboard -- ${launchCommand(launch)}\n\`\`\`\n\nOn older OpenCode, add this entry to "mcp" in ~/.config/opencode/opencode.json, keeping the rest of the file:\n\n\`\`\`json\n${entry}\n\`\`\``, `Remove "@dev.fast/opencode-whiteboard" from "plugin" in ~/.config/opencode/opencode.json if it is there.`];
+			return [`On OpenCode 2.0 or later, run:\n\n${runBlock(connectLines(target, launch, platform))}\n\nOn older OpenCode, add this entry to "mcp" in ~/.config/opencode/opencode.json, keeping the rest of the file:\n\n\`\`\`json\n${entry}\n\`\`\``, `Remove "@dev.fast/opencode-whiteboard" from "plugin" in ~/.config/opencode/opencode.json if it is there.`];
 		}
-		case "copilot":
-			if (platform === "win32") return [`Run:\n\n\`\`\`sh\ncopilot plugin uninstall whiteboard@devfast # its launch cannot start on Windows, if installed\ncopilot mcp remove whiteboard # old registration, if any\n${COPILOT_WINDOWS_MCP_ADD}\n\`\`\``];
-			return ["Run:\n\n```sh\ncopilot plugin marketplace add devdotfast/whiteboard\ncopilot plugin install whiteboard@devfast\ncopilot mcp remove whiteboard # old manual registration, if any\n```"];
-		case "pi": return [`On Pi 0.99.0 or later, run:\n\n\`\`\`sh\npi mcp add whiteboard -- ${launchCommand(reviewMcpLaunch(true, platform))}\npi remove ${PI_WHITEBOARD_PACKAGE} # if installed\n\`\`\`\n\nOn older Pi, run \`pi install ${PI_WHITEBOARD_PACKAGE}\`.`];
+		case "pi": return [`On Pi 0.99.0 or later, run:\n\n${runBlock(connectLines(target, launch, platform))}\n\nOn older Pi, run \`pi install ${PI_WHITEBOARD_PACKAGE}\`.`];
 		case "omp": return [`Add this entry to mcpServers in ~/.omp/agent/mcp.json, keeping the rest of the file:\n\n\`\`\`json\n${JSON.stringify({ whiteboard: reviewMcpLaunch(true, platform) }, null, 2)}\n\`\`\``, `Run \`omp plugin uninstall @dev.fast/pi-whiteboard\` if installed.`];
 	}
 }
-function launchCommand(launch) {
-	return [launch.command, ...launch.args].map((arg) => /^[\w./-]+$/.test(arg) ? arg : shellQuote(arg)).join(" ");
+function shellWords(words) {
+	return words.map((word) => /^[\w./@:-]+$/.test(word) ? word : shellQuote(word)).join(" ");
 }
 function cursorSteps() {
 	const launch = reviewMcpLaunch(true);
@@ -231,6 +259,263 @@ function isInstallTarget(value) {
 	return ALL_INSTALL_TARGETS.some((target) => target === value);
 }
 //#endregion
+//#region src/agent-connect.ts
+const STEP_TIMEOUT_MS = 12e4;
+const HARNESSES = {
+	claude: {
+		name: "Claude Code",
+		commands: ["claude"],
+		installDirs: [".claude/local", ".local/bin"]
+	},
+	codex: {
+		name: "Codex",
+		commands: ["codex"]
+	},
+	cursor: {
+		name: "Cursor",
+		commands: ["cursor"],
+		homeDir: ".cursor",
+		apps: ["/Applications/Cursor.app"]
+	},
+	opencode: {
+		name: "OpenCode",
+		commands: ["opencode"],
+		installDirs: [".opencode/bin"]
+	},
+	pi: {
+		name: "Pi",
+		commands: ["pi"]
+	},
+	omp: {
+		name: "oh-my-pi",
+		commands: ["omp"],
+		homeDir: ".omp"
+	},
+	copilot: {
+		name: "Copilot CLI",
+		commands: ["copilot"]
+	}
+};
+const runProcess = (file, args) => new Promise((resolve) => {
+	execFile(file, args, {
+		timeout: STEP_TIMEOUT_MS,
+		maxBuffer: 4194304,
+		env: {
+			...process.env,
+			CI: "1",
+			GIT_TERMINAL_PROMPT: "0"
+		},
+		windowsHide: true
+	}, (error, stdout, stderr) => {
+		const output = `${stdout}${stderr}`.trim();
+		resolve(error ? {
+			code: 1,
+			output: output || error.message
+		} : {
+			code: 0,
+			output
+		});
+	});
+});
+async function exists(target) {
+	try {
+		await stat(target);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function findHarness(harness, homeDir, env) {
+	const installed = (harness.installDirs ?? []).map((directory) => path.join(homeDir, directory));
+	for (const command of harness.commands) {
+		const found = await findExecutable(command, env) ?? await findExecutable(command, { PATH: installed.join(path.delimiter) });
+		if (found) return found;
+	}
+}
+async function harnessFound(harness, homeDir, env, platform) {
+	if (await findHarness(harness, homeDir, env)) return true;
+	if (harness.homeDir && await exists(path.join(homeDir, harness.homeDir))) return true;
+	if (platform !== "darwin") return false;
+	for (const app of harness.apps ?? []) if (await exists(app)) return true;
+	return false;
+}
+/** OpenCode's config is JSONC: drop comments and trailing commas, keep strings. */
+const JSONC_EXTRAS = /("(?:\\.|[^"\\])*")|\/\/[^\n]*|\/\*[\s\S]*?\*\/|,(?=\s*[}\]])/g;
+async function readJson(file) {
+	try {
+		return JSON.parse((await readFile(file, "utf8")).replace(JSONC_EXTRAS, "$1"));
+	} catch {
+		return;
+	}
+}
+/** Follows `keys` down nested JSON objects. */
+function lookup(value, ...keys) {
+	let current = value;
+	for (const key of keys) {
+		if (!isJsonObject(current)) return void 0;
+		current = current[key];
+	}
+	return current;
+}
+/** Whether a `[plugins."…"]` table names the plugin, and does not turn it
+* off. */
+function codexHasPlugin(toml) {
+	const lines = toml.split("\n");
+	const start = lines.findIndex((line) => line.trim() === `[plugins."${WHITEBOARD_PLUGIN}"]`);
+	if (start === -1) return false;
+	for (const line of lines.slice(start + 1)) {
+		const trimmed = line.trim();
+		if (trimmed.startsWith("[")) break;
+		if (/^enabled\s*=\s*false\b/.test(trimmed)) return false;
+	}
+	return true;
+}
+/** Whether a harness already has Whiteboard, as its own config records it:
+* the plugin it installed, or the MCP server added to it. Copilot keeps no
+* record Whiteboard reads, so it always installs again, which is harmless. */
+async function harnessConnected(target, homeDir, env, platform) {
+	const claudeDir = env.CLAUDE_CONFIG_DIR ?? path.join(homeDir, ".claude");
+	const hasServer = async (file, ...keys) => lookup(await readJson(file), ...keys, "whiteboard") !== void 0;
+	switch (target) {
+		case "claude": {
+			if (platform === "win32") return hasServer(path.join(homeDir, ".claude.json"), "mcpServers");
+			const [installed, settings] = await Promise.all([readJson(path.join(claudeDir, "plugins", "installed_plugins.json")), readJson(path.join(claudeDir, "settings.json"))]);
+			const installs = lookup(installed, "plugins", WHITEBOARD_PLUGIN);
+			return Array.isArray(installs) && installs.length > 0 && lookup(settings, "enabledPlugins", "whiteboard@devfast") !== false;
+		}
+		case "codex": try {
+			return codexHasPlugin(await readFile(path.join(env.CODEX_HOME ?? path.join(homeDir, ".codex"), "config.toml"), "utf8"));
+		} catch {
+			return false;
+		}
+		case "opencode": {
+			const configDir = path.join(env.XDG_CONFIG_HOME || path.join(homeDir, ".config"), "opencode");
+			for (const name of [
+				"opencode.json",
+				"opencode.jsonc",
+				"config.json"
+			]) {
+				const config = await readJson(path.join(configDir, name));
+				if (lookup(config, "mcp", "whiteboard") !== void 0 || lookup(config, "mcp", "servers", "whiteboard") !== void 0) return true;
+			}
+			return false;
+		}
+		case "pi": return hasServer(path.join(homeDir, ".pi", "agent", "mcp.json"), "mcpServers");
+		case "omp": return hasServer(path.join(homeDir, ".omp", "agent", "mcp.json"), "mcpServers");
+		case "cursor": return cursorHasServer(homeDir);
+		case "copilot": return false;
+	}
+}
+/** Every harness Whiteboard connects to, whether this machine has it, and
+* whether it already has Whiteboard. */
+async function detectConnectAgents(input = {}) {
+	const homeDir = input.homeDir ?? os.homedir();
+	const env = input.env ?? process.env;
+	const platform = input.platform ?? process.platform;
+	return Promise.all(ALL_INSTALL_TARGETS.map(async (target) => {
+		const found = await harnessFound(HARNESSES[target], homeDir, env, platform);
+		return {
+			target,
+			name: HARNESSES[target].name,
+			found,
+			connected: found && await harnessConnected(target, homeDir, env, platform)
+		};
+	}));
+}
+/** oh-my-pi reads its MCP servers from one JSON file; merge ours in. */
+async function connectOmp(homeDir, launch) {
+	const file = path.join(homeDir, ".omp", "agent", "mcp.json");
+	try {
+		const config = await exists(file) ? JSON.parse(await readFile(file, "utf8")) : {};
+		if (!isJsonObject(config)) throw new Error(`${file} is not a JSON object.`);
+		const servers = isJsonObject(config.mcpServers) ? { ...config.mcpServers } : {};
+		servers.whiteboard = {
+			command: launch.command,
+			args: [...launch.args]
+		};
+		const next = {
+			...config,
+			mcpServers: servers
+		};
+		await mkdir(path.dirname(file), { recursive: true });
+		await writeFile(file, `${JSON.stringify(next, null, 2)}\n`);
+		return {
+			target: "omp",
+			state: "connected",
+			output: `Updated ${file}`
+		};
+	} catch (error) {
+		return {
+			target: "omp",
+			state: "failed",
+			output: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/** Whether Cursor's global MCP config already names Whiteboard's server. */
+async function cursorHasServer(homeDir) {
+	try {
+		const config = JSON.parse(await readFile(path.join(homeDir, ".cursor", "mcp.json"), "utf8"));
+		return isJsonObject(config) && isJsonObject(config.mcpServers) && config.mcpServers.whiteboard !== void 0;
+	} catch {
+		return false;
+	}
+}
+/** Cursor only installs an MCP server the user confirms, so open its link,
+* unless it already has one: confirming again would ask for nothing new. */
+async function connectCursor(homeDir, launch, platform, run) {
+	if (await cursorHasServer(homeDir)) return {
+		target: "cursor",
+		state: "connected",
+		output: "Cursor already has the whiteboard MCP server."
+	};
+	const url = cursorInstallDeeplink(launch);
+	const [file, args] = platform === "darwin" ? ["open", ["-g", url]] : platform === "win32" ? ["cmd", [
+		"/d",
+		"/c",
+		"start",
+		"\"\"",
+		url
+	]] : ["xdg-open", [url]];
+	const result = await run(file, args);
+	return {
+		target: "cursor",
+		state: result.code === 0 ? "approve" : "failed",
+		output: result.output
+	};
+}
+/** Installs Whiteboard's plugin, or its MCP server, into one harness. */
+async function connectAgent(target, input) {
+	const homeDir = input.homeDir ?? os.homedir();
+	const env = input.env ?? process.env;
+	const platform = input.platform ?? process.platform;
+	const run = input.run ?? runProcess;
+	const launch = reviewMcpLaunch(input.hasShim, platform);
+	if (target === "omp") return connectOmp(homeDir, launch);
+	if (target === "cursor") return connectCursor(homeDir, launch, platform, run);
+	const executable = await findHarness(HARNESSES[target], homeDir, env);
+	if (!executable) return {
+		target,
+		state: "failed",
+		output: `${HARNESSES[target].name} is not installed.`
+	};
+	const outputs = [];
+	for (const step of connectSteps(target, launch, platform)) {
+		const result = await run(executable, step.args);
+		outputs.push(result.output);
+		if (result.code !== 0 && !step.optional && !step.done?.test(result.output)) return {
+			target,
+			state: "failed",
+			output: outputs.join("\n").trim()
+		};
+	}
+	return {
+		target,
+		state: "connected",
+		output: outputs.join("\n").trim()
+	};
+}
+//#endregion
 //#region src/legacy-skills.ts
 const LEGACY_SKILL_NAMES = [
 	"whiteboard",
@@ -638,17 +923,19 @@ function withShimPath(result, shimPath) {
 }
 /** The published plugin per harness; Cursor's link needs the shim it launches. */
 function connectPlugins(hasShim) {
+	const launch = reviewMcpLaunch(hasShim);
+	const command = (target) => connectLines(target, launch, process.platform, false);
 	return {
 		claude: process.platform === "win32" ? {
 			label: "Add the Claude Code MCP server",
-			command: CLAUDE_WINDOWS_MCP_ADD
+			command: command("claude")
 		} : {
 			label: "Install the Claude Code plugin",
 			command: "/plugin marketplace add devdotfast/whiteboard\n/plugin install whiteboard@devfast"
 		},
 		codex: {
 			label: "Install the Codex plugin",
-			command: "codex plugin marketplace add devdotfast/whiteboard\ncodex plugin add whiteboard@devfast"
+			command: command("codex")
 		},
 		cursor: hasShim ? {
 			label: "Install in Cursor",
@@ -656,11 +943,11 @@ function connectPlugins(hasShim) {
 		} : { label: "Install in Cursor" },
 		opencode: {
 			label: "Add the OpenCode MCP server (OpenCode 2+)",
-			command: `opencode mcp add --global whiteboard -- ${launchCommand(reviewMcpLaunch(hasShim))}`
+			command: command("opencode")
 		},
 		pi: {
 			label: "Add the Pi MCP server (Pi 0.99+)",
-			command: `pi mcp add whiteboard -- ${launchCommand(reviewMcpLaunch(hasShim))}`
+			command: command("pi")
 		},
 		omp: {
 			label: "Add the oh-my-pi MCP server",
@@ -668,10 +955,10 @@ function connectPlugins(hasShim) {
 		},
 		copilot: process.platform === "win32" ? {
 			label: "Add the Copilot CLI MCP server",
-			command: COPILOT_WINDOWS_MCP_ADD
+			command: command("copilot")
 		} : {
 			label: "Install the Copilot CLI plugin",
-			command: "copilot plugin marketplace add devdotfast/whiteboard\ncopilot plugin install whiteboard@devfast"
+			command: command("copilot")
 		}
 	};
 }
@@ -1055,4 +1342,4 @@ async function aliasInstallationToAccount(telemetry, env = process.env, fetchImp
 	} catch {}
 }
 //#endregion
-export { connectPrompts as _, isOwnedShim as a, removeLegacyReviewSkills as c, skipCliInstall as d, windowsInstallerCommand as f, CONNECT_COMMANDS as g, isInstallTarget as h, finishCliInstallUpdate as i, resetCliInstall as l, ALL_INSTALL_TARGETS as m, applyCliInstall as n, pathShimPath as o, scanLegacySkills as p, declineCliInstall as r, removeCliInstall as s, aliasInstallationToAccount as t, resolveCliInstallStatus as u, reviewMcpLaunch as v, cursorInstallDeeplink as y };
+export { isInstallTarget as _, isOwnedShim as a, removeLegacyReviewSkills as c, skipCliInstall as d, windowsInstallerCommand as f, ALL_INSTALL_TARGETS as g, detectConnectAgents as h, finishCliInstallUpdate as i, resetCliInstall as l, connectAgent as m, applyCliInstall as n, pathShimPath as o, scanLegacySkills as p, declineCliInstall as r, removeCliInstall as s, aliasInstallationToAccount as t, resolveCliInstallStatus as u, connectPrompts as v };

package/dist/agent-cli-NWQPsL0W.js

@@ -0,0 +1,2 @@
+import { n as runReviewAgentCli } from "./agent-cli-S0bt9I7V.js";
+export { runReviewAgentCli };

package/dist/{agent-cli-CPSnWc9V.js → agent-cli-S0bt9I7V.js}

@@ -1,11 +1,11 @@
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { T as traceMachineEnabled } from "./review-home-paths-zwevIq4I.js";
-import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-Dogh8I83.js";
+import { T as traceMachineEnabled } from "./review-home-paths-Lc02WFuX.js";
+import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-DjXQy6CL.js";
 import { M as devReviewHome } from "./s3-config-DDWWMh5x.js";
-import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-CqRxbsER.js";
-import { n as reviewSessionAgent } from "./review-telemetry-9ceqh4wz.js";
-import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-C-V9f3Fr.js";
-import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-aSYcHDxP.js";
+import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-DVqrcIDT.js";
+import { n as reviewSessionAgent } from "./review-telemetry-DnQNwgR1.js";
+import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-D1RNVSeK.js";
+import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-CVJrfi5s.js";
 //#region src/review-api/agent-cli.ts
 const reviewAgentCliHelp = "whiteboard api tools  (one line per tool)\nwhiteboard api tools <tool-name>  (its description and input schema)\nwhiteboard api <tool-name> '<json>'\nwhiteboard api <tool-name> -  (read JSON from stdin)\nwhiteboard mcp  (stdio MCP adapter; Whiteboard Desktop or whiteboard server start must be running)\nSelect headless state with DEV_REVIEW_SERVER_DIR or whiteboard --state-dir <path> api/mcp.\n";
 async function runReviewAgentCli(input) {
@@ -20,7 +20,7 @@ async function runReviewAgentCli(input) {
 		if (extra.length || mode === "mcp" && name) throw new Error("Unexpected arguments. Use whiteboard api --help.");
 		const headers = Object.fromEntries([[REVIEW_VIA_HEADER, mode === "mcp" ? "mcp" : "api"], [REVIEW_AGENT_HEADER, reviewSessionAgent(env)]]);
 		if (mode === "mcp") {
-			const { serveReviewMcp } = await import("./mcp-Blb7rzGw.js");
+			const { serveReviewMcp } = await import("./mcp-BY4ExeMQ.js");
 			await serveReviewMcp(async (key, agentKind) => {
 				const connected = await connectReviewInstance(key ? {
 					...env,

package/dist/{agent-client-Dogh8I83.js → agent-client-DjXQy6CL.js}

@@ -1,7 +1,7 @@
 import { d as isBooleanValue, f as isNumberValue, m as isStringValue, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-HnIPjtjx.js";
+import "./src-DZG1xAqW.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, s as reviewServerIsHealthy, y as reviewInstanceUnavailable } from "./server-discovery-CqRxbsER.js";
+import { b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, s as reviewServerIsHealthy, y as reviewInstanceUnavailable } from "./server-discovery-DVqrcIDT.js";
 //#region ../review-protocol/src/review-api-client.ts
 const defaultRequest = (url, init) => fetch(url, init);
 /** A non-2xx reply; the status tells a caller whether retrying can help. */
@@ -68,7 +68,7 @@ var ReviewApiClient = class {
 			reader.releaseLock();
 		}
 	}
-	async follow(reviewId, signal, accept, disconnected, mode) {
+	async follow(reviewId, signal, accept, disconnected) {
 		if (signal.aborted) return;
 		let connections = liveConnections.get(this.request);
 		if (!connections) liveConnections.set(this.request, connections = /* @__PURE__ */ new Map());
@@ -79,7 +79,6 @@ var ReviewApiClient = class {
 			connections.set(key, live);
 		}
 		const subscription = { reviewId };
-		if (mode) subscription.mode = mode;
 		return live.add(subscription, signal, (value) => accept(value), disconnected);
 	}
 	/** Reopen the shared stream now rather than after its backoff. */
@@ -104,7 +103,7 @@ function sleep(ms, signal) {
 	});
 }
 function concerns(line, subscription) {
-	return line.kind === "list" ? subscription.reviewId === null && (subscription.mode ?? "structural") === line.mode : subscription.reviewId === line.reviewId;
+	return line.kind === "list" ? subscription.reviewId === null : subscription.reviewId === line.reviewId;
 }
 function report(listener, cause) {
 	if (listener.signal.aborted) return;
@@ -250,7 +249,7 @@ async function connectReviewInstance(env = process.env, headers = {}, options =
 	const selection = await selectReviewInstance({ env });
 	const discovery = healthyReviewInstance(selection);
 	if (!discovery) {
-		const { ensureServerWithoutDesktop } = await import("./background-server-BKR_lpYb.js");
+		const { ensureServerWithoutDesktop } = await import("./background-server-CVL7QpsL.js");
 		const server = await ensureServerWithoutDesktop({
 			selection,
 			env,

package/dist/{authoring-tools-CtsslOEf.js → authoring-tools-CjFAGHBa.js}

@@ -1,7 +1,7 @@
-import { _ as activityUpdateSchema, g as activityEndSchema, h as activityBeginSchema, i as commandSchema, n as uploadSchema } from "./local-data-D_9S--yI.js";
-import { S as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-DenDEYdI.js";
+import { c as activityEndSchema, i as commandSchema, l as activityUpdateSchema, n as uploadSchema, s as activityBeginSchema } from "./local-data-DN-A5p0K.js";
+import { S as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-DLBhkSfp.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { t as findReviewPackageRoot } from "./package-paths-BsuI4WUf.js";
+import { t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
@@ -85,7 +85,8 @@ const COMPONENT_REFERENCE = [
 	"- trace_quote {traceId, eventId, text}",
 	"- software_map {mapVersionId, focusElementId?}",
 	"- sequence {title, actors: {key: label}, steps: step[], pins?}",
-	"- step {from, to (actor keys), label, style?: call|return|async, and exactly one of source: anchor, explanation, or code: {text, language?}; pins?}",
+	"- step {from, to (actor keys), label, style?: call|return|async, and exactly one of source: anchor or anchor[] (at most 4), explanation, or code: {text, language?}; pins?}",
+	"A step's source is the line where its arrow leaves `from` (the call, return or emit). Add an additional range only when that line can't be read without it: the type or schema of what it passes, or the code that builds its argument. Never the callee's body; that is the next step.",
 	"- flow_diagram {title, nodes: flow_node[] (1 to 100), edges: flow_edge[], description?, direction?: right|down, pins?}",
 	"- flow_node {key, label, description?, kind?: process|decision|terminal, attachments?: {label, sources: anchor[], pins?}[], link?: {from or to, label?, style?}}",
 	"- flow_edge {from, to (node keys), label?, style?: solid|dashed}",

package/dist/{background-server-BKR_lpYb.js → background-server-CVL7QpsL.js}

@@ -1,2 +1,2 @@
-import { a as headlessServerOwner, c as stopBackgroundServer, i as ensureServerWithoutDesktop, r as ensureBackgroundServer } from "./background-server-DJT0CnYH.js";
+import { a as headlessServerOwner, c as stopBackgroundServer, i as ensureServerWithoutDesktop, r as ensureBackgroundServer } from "./background-server-ONy-xKJ1.js";
 export { ensureBackgroundServer, ensureServerWithoutDesktop, headlessServerOwner, stopBackgroundServer };

package/dist/{background-server-DJT0CnYH.js → background-server-ONy-xKJ1.js}

@@ -1,8 +1,8 @@
-import "./review-home-paths-zwevIq4I.js";
+import "./review-home-paths-Lc02WFuX.js";
 import { D as liveLockOwner, O as processIsAlive } from "./s3-config-DDWWMh5x.js";
-import { t as findReviewPackageRoot } from "./package-paths-BsuI4WUf.js";
-import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-CqRxbsER.js";
-import { t as desktopApplicationInstalled } from "./review-app-launcher-S2FZBY4W.js";
+import { t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
+import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-DVqrcIDT.js";
+import { t as desktopApplicationInstalled } from "./review-app-launcher-i1hmxOZA.js";
 import { mkdir, open, readFile, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { spawn } from "node:child_process";