@dev.fast/whiteboard 0.3.1-preview.20261016.122 → 0.3.2

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

@@ -3,8 +3,8 @@ 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-jMg6JxDP.js";
-import { f as isDirectory, p as isFile } from "./thread-state-CaQ2lGdj.js";
-import { s as findExecutable } from "./fuzzy-match-DFPKdSLR.js";
+import { n as isFile, t as isDirectory } from "./fs-utils-BMPLt0cr.js";
+import { s as findExecutable } from "./fuzzy-match-C9olHRCK.js";
 import { createHash } from "node:crypto";
 import { constants } from "node:fs";
 import { access, chmod, lstat, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";

package/dist/agent-cli-CoHvydp7.js

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

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

@@ -2,10 +2,28 @@ import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.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 { n as readBuildCommit } from "./package-paths-jMg6JxDP.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 { n as reviewSessionAgent } from "./review-telemetry-ClhP_5lW.js";
+import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-BSwTNS8K.js";
 import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-CVJrfi5s.js";
+import { existsSync } from "node:fs";
+import path from "node:path";
+//#region src/review-api/install-update.ts
+/** Exits once an update replaces this install, or the Windows updater marks it. */
+function exitOnInstallUpdate(stderr) {
+	const commit = readBuildCommit(import.meta.url);
+	if (!commit) return;
+	const marker = path.join(path.dirname(process.execPath), "applying_update");
+	const staleMarker = existsSync(marker);
+	const timer = setInterval(() => {
+		if (!staleMarker && existsSync(marker) || readBuildCommit(import.meta.url) !== commit) {
+			clearInterval(timer);
+			stderr.write("Whiteboard was updated. Restart its MCP server.\n", () => process.exit(75));
+		}
+	}, 1e3).unref();
+}
+//#endregion
 //#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 +38,8 @@ 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-BY4ExeMQ.js");
+			const { serveReviewMcp } = await import("./mcp-D-7jkRTU.js");
+			exitOnInstallUpdate(input.stderr);
 			await serveReviewMcp(async (key, agentKind) => {
 				const connected = await connectReviewInstance(key ? {
 					...env,

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

@@ -1,4 +1,4 @@
-import { c as activityEndSchema, i as commandSchema, l as activityUpdateSchema, n as uploadSchema, s as activityBeginSchema } from "./local-data-DN-A5p0K.js";
+import { c as activityEndSchema, i as commandSchema, l as activityUpdateSchema, n as uploadSchema, s as activityBeginSchema } from "./local-data-DKmj2ygd.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-jMg6JxDP.js";

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"0.3.1-preview.20261016.122","commit":"7cef417b896162d45b18541ced02e6d250cdc535","dirty":true,"builtAt":"2026-10-16T18:47:14.922Z"}
+{"version":"0.3.2","commit":"38a6dad3049993f987d9b82ca3c5fee424b28f6b","dirty":true,"builtAt":"2026-10-16T21:59:03.536Z"}

package/dist/{cli-runner-DeQ4IhcG.js → cli-runner-DEKbykD8.js}

@@ -8,11 +8,11 @@ import { C as s3ProfileSchema, E as writeTraceConfigFile, M as devReviewHome, N
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, r as readBuildInfo, t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
 import { a as readReviewServerHealth, b as selectReviewInstance, c as reviewServerStateDir, d as ReviewInstanceUnavailableError, f as clearDefaultReviewInstance, g as requireHealthyReviewDesktop, h as readDefaultReviewInstance, i as readReviewServerDiscovery, l as serverNotReady, m as healthyReviewInstance, p as desktopUsesHome, t as DESKTOP_TAKEOVER_SIGNAL, u as REVIEW_INSTANCE_ENV, x as writeDefaultReviewInstance, y as reviewInstanceUnavailable } from "./server-discovery-DVqrcIDT.js";
-import { t as ReviewTelemetry } from "./review-telemetry-DnQNwgR1.js";
-import { t as fuzzyRank } from "./fuzzy-match-DFPKdSLR.js";
-import { _ as isInstallTarget, a as isOwnedShim, f as windowsInstallerCommand, g as ALL_INSTALL_TARGETS, h as detectConnectAgents, m as connectAgent, o as pathShimPath, p as scanLegacySkills, t as aliasInstallationToAccount, v as connectPrompts } from "./account-alias-CwNaMOwU.js";
+import { t as ReviewTelemetry } from "./review-telemetry-ClhP_5lW.js";
+import { t as fuzzyRank } from "./fuzzy-match-C9olHRCK.js";
+import { _ as isInstallTarget, a as isOwnedShim, f as windowsInstallerCommand, g as ALL_INSTALL_TARGETS, h as detectConnectAgents, m as connectAgent, o as pathShimPath, p as scanLegacySkills, t as aliasInstallationToAccount, v as connectPrompts } from "./account-alias-D_mqo_Jk.js";
 import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-i1hmxOZA.js";
-import { t as reviewAgentCliHelp } from "./agent-cli-S0bt9I7V.js";
+import { t as reviewAgentCliHelp } from "./agent-cli-DjLmorAW.js";
 import { existsSync, mkdirSync, renameSync, writeFileSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import path from "node:path";
@@ -4319,7 +4319,7 @@ async function runReviewCli(input) {
 		process.once("SIGINT", stop);
 		process.once("SIGTERM", stop);
 		process.once(DESKTOP_TAKEOVER_SIGNAL, takeover);
-		const { HeadlessServerBusyError, runHeadlessServer } = await import("./headless-host-DHShakz_.js");
+		const { HeadlessServerBusyError, runHeadlessServer } = await import("./headless-host-DRwHcAuF.js");
 		try {
 			await runHeadlessServer({
 				stateDir,
@@ -4384,7 +4384,7 @@ async function runReviewCli(input) {
 		if (!existsSync(path.join(stateDir, "review-api.db"))) throw new Error(`No saved reviews in ${stateDir}, so there is no server id to reset. Check --state-dir.`);
 		const inUse = `A Whiteboard server is using ${stateDir}. Stop it first, then run whiteboard server reset-id again.`;
 		if (await desktopUsesHome(stateDir, env)) return refuse(inUse, options.json);
-		const [{ openReviewProfile }, { withHeadlessServerLock }] = await Promise.all([import("./profile-BBw-jMW3.js"), import("./headless-host-DHShakz_.js")]);
+		const [{ openReviewProfile }, { withHeadlessServerLock }] = await Promise.all([import("./profile-D1rScZ-E.js"), import("./headless-host-DRwHcAuF.js")]);
 		const reset = await withHeadlessServerLock(await realpath(stateDir), async () => {
 			const local = await openReviewProfile(stateDir, { manageWorkspaces: false });
 			try {
@@ -4758,7 +4758,7 @@ async function runReviewCli(input) {
 		return commands;
 	} });
 	for (const [name, description] of [["api", "Call a JSON review authoring tool on the running server"], ["mcp", "Serve the JSON review authoring tools over stdio MCP"]]) configureOutput(program.command(name).description(description).argument("[args...]", "tool name and JSON input").allowUnknownOption().allowExcessArguments().helpOption(false).passThroughOptions().addHelpText("after", `\n${reviewAgentCliHelp}`), "plain").action(async (args) => {
-		const { runReviewAgentCli } = await import("./agent-cli-NWQPsL0W.js");
+		const { runReviewAgentCli } = await import("./agent-cli-CoHvydp7.js");
 		state.exitCode = await runReviewAgentCli({
 			...input,
 			env: authoringEnv(),

package/dist/cli.js

@@ -17,7 +17,7 @@ async function runCli(effectivePath) {
 `);
 		return 1;
 	}
-	const { runReviewCli } = await import("./cli-runner-DeQ4IhcG.js");
+	const { runReviewCli } = await import("./cli-runner-DEKbykD8.js");
 	return runReviewCli({
 		argv,
 		cliPaths: {

package/dist/fs-utils-BMPLt0cr.js

@@ -0,0 +1,22 @@
+import { stat } from "node:fs/promises";
+//#region src/fs-utils.ts
+/** Whether a thrown filesystem error reports a missing file (ENOENT). */
+function isMissingFileError(cause) {
+	return cause instanceof Error && "code" in cause && cause.code === "ENOENT";
+}
+async function isDirectory(target) {
+	try {
+		return (await stat(target)).isDirectory();
+	} catch {
+		return false;
+	}
+}
+async function isFile(target) {
+	try {
+		return (await stat(target)).isFile();
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { isFile as n, isMissingFileError as r, isDirectory as t };

package/dist/{fuzzy-match-DFPKdSLR.js → fuzzy-match-C9olHRCK.js}

@@ -1,6 +1,6 @@
 import "./review-home-paths-Lc02WFuX.js";
 import { M as devReviewHome } from "./s3-config-DDWWMh5x.js";
-import { n as askAgentIds } from "./thread-state-CaQ2lGdj.js";
+import { n as askAgentIds } from "./thread-state-DZihwhfu.js";
 import { createRequire } from "node:module";
 import { constants } from "node:fs";
 import { access, chmod, mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";

package/dist/{headless-host-CoN2f0Sk.js → headless-host-CnCDrHTx.js}

@@ -1,7 +1,7 @@
 import { d as git, r as defaultBranch } from "./src-BMPuxWv4.js";
 import { c as jsonString, m as isStringValue, n as isJsonObject, p as isObjectValue, u as parseJsonText } from "./src-X9phtB2j.js";
 import { a as sharedReviewId, c as verifyShareRepository, d as StreamLimitError, f as readBoundedStream, l as exportShare, m as shareIdSchema, n as ShareClient, p as parseShareLink, r as SharePreflightError, s as readShareRepository, t as ShareAuthError, u as validateShareSources } from "./client-CLqKkzOc.js";
-import { a as inspectSnapshot, d as diffrExecutable, f as diffrMissingError, i as commandSchema, r as SCRATCHPAD_ID, u as invalidateStructuralComparisons } from "./local-data-DN-A5p0K.js";
+import { a as inspectSnapshot, d as invalidateStructuralComparisons, f as diffrExecutable, i as commandSchema, p as diffrMissingError, r as SCRATCHPAD_ID } from "./local-data-DKmj2ygd.js";
 import { A as reviewDiffrSummarizerInputSchema, D as ReviewOnboardingRunRequestSchema, a as parseReviewVerbRequest, g as REVIEW_HOST_HEADER, i as parseReviewDesktopVerbResult, j as decodeStructuralDiffEvent } from "./src-DZG1xAqW.js";
 import { B as TraceStorageDeniedError, D as listReviewTraceSessions, I as isTraceStorageConfigured, O as loadReviewAgentTrace, R as resolveTraceStorage, T as traceMachineEnabled, at as openUrlInBrowser, et as shellQuote, it as clearStoreAuth, ot as readStoreAuth, rt as DEFAULT_STORE_ORIGIN, st as runStoreLogin, z as selectTraceStorage } from "./review-home-paths-Lc02WFuX.js";
 import { E as selectionReferences, G as comparisonKey, I as lensSelections, J as selectionKey, K as formatAnchor, M as UNCATEGORIZED_LENS_ID, Q as emptyCoverage, W as anchorSelection, Z as coverageSources, et as scopedCoverage, h as elements, j as stepSources, nt as unionIntervals, q as resolveDiffSelection, tt as subtractIntervals, u as anchorPins, z as fileLineRangeSchema } from "./stored-document-migration-DLBhkSfp.js";
@@ -10,11 +10,11 @@ import { A as withFileLock, I as writePrivateJsonAtomic, M as devReviewHome, h a
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, n as readBuildCommit, t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
 import { i as readReviewServerDiscovery, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-DVqrcIDT.js";
-import { c as askPicksSchema, d as selectionMarkdown, l as askQuestionSchema, n as askAgentIds, r as askChoiceKinds, s as askPermissionsSchema, t as applyAskChange, u as AgentSelectionSchema } from "./thread-state-CaQ2lGdj.js";
-import { t as openReviewProfile } from "./profile-Dm6irjbg.js";
-import { a as REVIEW_APP_SESSION_ID_HEADER, c as sanitizeUiTelemetryEvent, i as BUNDLE_FRAME_PATTERN, l as cleanTelemetryText, r as reviewRequestOrigin, s as isReportableCleanedMessage } from "./request-origin-D1RNVSeK.js";
-import { a as defaultAskPermissions, c as launchAskAgent, i as askAgents, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-DFPKdSLR.js";
-import { a as scratchpadAvailable, c as readQuerySchemas, i as renderInstructions, o as inspectQuerySchema, r as instructionsQuerySchema, s as queryAnchor, t as authoringTools } from "./authoring-tools-CjFAGHBa.js";
+import { c as askPicksSchema, d as selectionMarkdown, l as askQuestionSchema, n as askAgentIds, r as askChoiceKinds, s as askPermissionsSchema, t as applyAskChange, u as AgentSelectionSchema } from "./thread-state-DZihwhfu.js";
+import { t as openReviewProfile } from "./profile-B58hz5n7.js";
+import { a as REVIEW_APP_SESSION_ID_HEADER, c as sanitizeUiTelemetryEvent, i as BUNDLE_FRAME_PATTERN, l as cleanTelemetryText, r as reviewRequestOrigin, s as isReportableCleanedMessage } from "./request-origin-BSwTNS8K.js";
+import { a as defaultAskPermissions, c as launchAskAgent, i as askAgents, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-C9olHRCK.js";
+import { a as scratchpadAvailable, c as readQuerySchemas, i as renderInstructions, o as inspectQuerySchema, r as instructionsQuerySchema, s as queryAnchor, t as authoringTools } from "./authoring-tools-ByMdW_S8.js";
 import { a as headlessServerOwner, c as stopBackgroundServer } from "./background-server-ONy-xKJ1.js";
 import crypto$1, { createHash, randomBytes, randomUUID } from "node:crypto";
 import { z } from "zod";

package/dist/{headless-host-DHShakz_.js → headless-host-DRwHcAuF.js}

@@ -1,2 +1,2 @@
-import { i as withHeadlessServerLock, n as runHeadlessServer, r as takeOverServerHome, t as HeadlessServerBusyError } from "./headless-host-CoN2f0Sk.js";
+import { i as withHeadlessServerLock, n as runHeadlessServer, r as takeOverServerHome, t as HeadlessServerBusyError } from "./headless-host-CnCDrHTx.js";
 export { HeadlessServerBusyError, runHeadlessServer, takeOverServerHome, withHeadlessServerLock };

package/dist/{local-data-DN-A5p0K.js → local-data-DKmj2ygd.js}

@@ -6,7 +6,8 @@ import { $ as intersectIntervals, A as documentAdvice, B as requireVisibleSource
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { A as withFileLock, I as writePrivateJsonAtomic, O as processIsAlive } from "./s3-config-DDWWMh5x.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
-import { a as askHistoryEntrySchema, i as askEntrySchema, m as isMissingFileError, o as askOfferSchema, s as askPermissionsSchema } from "./thread-state-CaQ2lGdj.js";
+import { r as isMissingFileError } from "./fs-utils-BMPLt0cr.js";
+import { a as askHistoryEntrySchema, i as askEntrySchema, o as askOfferSchema, s as askPermissionsSchema } from "./thread-state-DZihwhfu.js";
 import { createRequire } from "node:module";
 import crypto, { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";
@@ -3736,7 +3737,8 @@ var LocalReviewData = class {
 		}
 		return {
 			workspacePath,
-			filePath
+			filePath,
+			rootPath
 		};
 	}
 	/** A document read that needs default pins; 409 when the document has none. */
@@ -4592,4 +4594,4 @@ async function readWorkspace(file) {
 	}
 }
 //#endregion
-export { inspectSnapshot as a, activityEndSchema as c, diffrExecutable as d, diffrMissingError as f, commandSchema as i, activityUpdateSchema as l, uploadSchema as n, initializeReviewStoreSchema as o, SCRATCHPAD_ID as r, activityBeginSchema as s, openLocalReviewStore as t, invalidateStructuralComparisons as u };
+export { inspectSnapshot as a, activityEndSchema as c, invalidateStructuralComparisons as d, diffrExecutable as f, commandSchema as i, activityUpdateSchema as l, uploadSchema as n, initializeReviewStoreSchema as o, diffrMissingError as p, SCRATCHPAD_ID as r, activityBeginSchema as s, openLocalReviewStore as t, pullRequestProvider as u };

package/dist/{mcp-BY4ExeMQ.js → mcp-D-7jkRTU.js}

@@ -1,6 +1,6 @@
 import { a as toolResultText, s as ReviewApiError } from "./agent-client-DjXQy6CL.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { n as REVIEW_STATUS_TOOL, t as authoringTools } from "./authoring-tools-CjFAGHBa.js";
+import { n as REVIEW_STATUS_TOOL, t as authoringTools } from "./authoring-tools-ByMdW_S8.js";
 import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-CVJrfi5s.js";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/{profile-Dm6irjbg.js → profile-B58hz5n7.js}

@@ -1,4 +1,4 @@
-import { o as initializeReviewStoreSchema, t as openLocalReviewStore } from "./local-data-DN-A5p0K.js";
+import { o as initializeReviewStoreSchema, t as openLocalReviewStore } from "./local-data-DKmj2ygd.js";
 import "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock } from "./s3-config-DDWWMh5x.js";
 import { access, mkdir } from "node:fs/promises";

package/dist/profile-D1rScZ-E.js

@@ -0,0 +1,2 @@
+import { t as openReviewProfile } from "./profile-B58hz5n7.js";
+export { openReviewProfile };

package/dist/{request-origin-D1RNVSeK.js → request-origin-BSwTNS8K.js}

@@ -1,5 +1,6 @@
 import { a as jsonNumber, c as jsonString, i as jsonBoolean, n as isJsonObject } from "./src-X9phtB2j.js";
 import { S as REVIEW_THEME_CHOICES, h as REVIEW_DIFF_LAYOUT_SCOPES, m as REVIEW_DIFF_LAYOUTS } from "./src-DZG1xAqW.js";
+import { n as askAgentIds } from "./thread-state-DZihwhfu.js";
 import { z } from "zod";
 //#region src/telemetry-clean-text.ts
 const USER_DATA_REGEXES = [
@@ -150,7 +151,8 @@ const PEEK_VIA = [
 	"diagram",
 	"map",
 	"db_lens",
-	"call_stack_frame"
+	"call_stack_frame",
+	"diff_definition"
 ];
 const PEEK_ROOT_KIND = ["range"];
 const LSP_FEATURE = [
@@ -226,6 +228,7 @@ const SETTING_NAME = [
 	"diffr_config",
 	"theme",
 	"ctrl_tab",
+	"open_files_in",
 	"ready_notification",
 	"document_width",
 	"code_font_size"
@@ -322,10 +325,39 @@ const INSTALL_LOCATION = [
 const DIFF_OPENED_VIA = [
 	"topbar",
 	"lens",
-	"locate"
+	"locate",
+	"file_picker"
 ];
 /** Which diff opened: a commit's, or a file diff drawn plain or structural. */
 const DIFF_OPENED_KIND = ["commit", "structural"];
+/** GitHub Enterprise is any GitHub host but github.com. */
+const PR_PROVIDER = [
+	"github",
+	"github_enterprise",
+	"azure_devops"
+];
+const REMOTE_HOST_PROBLEM = [
+	"unreachable",
+	"not_installed",
+	"auth_failed",
+	"unsupported",
+	"incompatible"
+];
+const REMOTE_HOST_TARGET = ["linux-x64", "linux-arm64"];
+const ASK_SELECTION = [
+	"text",
+	"code",
+	"diff",
+	"review"
+];
+const ONBOARDING_STEP = [
+	"welcome",
+	"install",
+	"run"
+];
+const RUN_MODE = ["draw", "copy"];
+const NEW_WHITEBOARD_VIA = ["button", "command"];
+const FIND_SURFACE = ["review", "diff"];
 const DISCORD_VIA = [
 	"topbar",
 	"dialog",
@@ -586,7 +618,9 @@ const UI_TELEMETRY_EVENTS = {
 		event: "review_session_started",
 		properties: {
 			source_kind: SESSION_SOURCE_KIND,
-			agent_kind: SESSION_AGENT_KIND
+			agent_kind: SESSION_AGENT_KIND,
+			remote: "boolean",
+			pr_provider: PR_PROVIDER
 		}
 	},
 	session_ended: {
@@ -674,6 +708,62 @@ const UI_TELEMETRY_EVENTS = {
 	review_shared: {
 		event: "review_review_shared",
 		properties: {}
+	},
+	find_opened: {
+		event: "review_find_opened",
+		properties: { surface: FIND_SURFACE }
+	},
+	ask_sent: {
+		event: "review_ask_sent",
+		properties: {
+			agent: askAgentIds,
+			follow_up: "boolean",
+			selection: ASK_SELECTION,
+			remote: "boolean"
+		}
+	},
+	onboarding_step_viewed: {
+		event: "review_onboarding_step_viewed",
+		properties: { step: ONBOARDING_STEP }
+	},
+	onboarding_skipped: {
+		event: "review_onboarding_skipped",
+		properties: { step: ONBOARDING_STEP }
+	},
+	onboarding_run_started: {
+		event: "review_onboarding_run_started",
+		properties: {
+			mode: RUN_MODE,
+			agent: askAgentIds
+		}
+	},
+	new_whiteboard_opened: {
+		event: "review_new_whiteboard_opened",
+		properties: { via: NEW_WHITEBOARD_VIA }
+	},
+	new_whiteboard_started: {
+		event: "review_new_whiteboard_started",
+		properties: {
+			mode: RUN_MODE,
+			embedded: "boolean",
+			agent: askAgentIds
+		}
+	},
+	remote_host_installed: {
+		event: "review_remote_host_installed",
+		properties: {
+			ok: "boolean",
+			target: REMOTE_HOST_TARGET,
+			duration_ms: "number"
+		}
+	},
+	remote_host_connected: {
+		event: "review_remote_host_connected",
+		properties: {
+			ok: "boolean",
+			problem: REMOTE_HOST_PROBLEM,
+			direct: "boolean"
+		}
 	}
 };
 const MAX_FREE_STRING_LENGTH = 40;

package/dist/{review-telemetry-DnQNwgR1.js → review-telemetry-ClhP_5lW.js}

@@ -3,7 +3,7 @@ import "./src-DZG1xAqW.js";
 import "./review-home-paths-Lc02WFuX.js";
 import { A as withFileLock, M as devReviewHome, O as processIsAlive, P as writeFileAtomic } from "./s3-config-DDWWMh5x.js";
 import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "./package-paths-jMg6JxDP.js";
-import "./request-origin-D1RNVSeK.js";
+import "./request-origin-BSwTNS8K.js";
 import { createHmac, randomUUID } from "node:crypto";
 import { z } from "zod";
 import { existsSync, readFileSync, rmSync } from "node:fs";

package/dist/server/desktop-host.js

@@ -2,6 +2,7 @@
 import { S as splitGitPatchFiles, a as diff, o as diffFileSummaries } from "../src-BMPuxWv4.js";
 import { c as jsonString, i as jsonBoolean, n as isJsonObject, p as isObjectValue, s as jsonProperty, u as parseJsonText } from "../src-X9phtB2j.js";
 import { d as StreamLimitError, f as readBoundedStream, i as SharedReviewStore } from "../client-CLqKkzOc.js";
+import { u as pullRequestProvider } from "../local-data-DKmj2ygd.js";
 import { A as reviewDiffrSummarizerInputSchema, E as ReviewGatewayHostSchema, T as ReviewConnectRequestSchema, c as ReviewBugReportMetaV2Schema, d as REVIEW_CLIENT_HEADER, f as REVIEW_CLIENT_REMOTE, g as REVIEW_HOST_HEADER, l as ReviewBugReportRequestSchema, r as parseReviewDesktopVerbFrame, s as parseZod, t as parseReviewCliInstallApplyRequest, u as parseReviewBugReportResponse } from "../src-DZG1xAqW.js";
 import { i as reviewInstanceDiscoveryPath, o as reviewLegacyDiscoveryPath } from "../review-home-paths-Lc02WFuX.js";
 import { w as resourceReferences } from "../stored-document-migration-DLBhkSfp.js";
@@ -10,12 +11,12 @@ import { I as writePrivateJsonAtomic, M as devReviewHome } from "../s3-config-DD
 import { t as errorMessage } from "../error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "../package-paths-jMg6JxDP.js";
 import { _ as reviewInstanceIdentity, u as REVIEW_INSTANCE_ENV } from "../server-discovery-DVqrcIDT.js";
-import { t as openReviewProfile } from "../profile-Dm6irjbg.js";
-import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-DnQNwgR1.js";
-import { o as REVIEW_TELEMETRY_TABS } from "../request-origin-D1RNVSeK.js";
-import { c as removeLegacyReviewSkills, d as skipCliInstall, h as detectConnectAgents, i as finishCliInstallUpdate, l as resetCliInstall, m as connectAgent, n as applyCliInstall, o as pathShimPath, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-CwNaMOwU.js";
-import { C as saveDiffrSummarizer, E as cliAskTools, S as readDiffrConfig, T as testDiffrSummarizer, _ as DEFAULT_MAX_REQUEST_BYTES, a as drainServerCrashReport, b as GlobalReviewDesktopVerbRelay, c as answerErrorsAsJson, d as legacyModeSchema, f as captureSanitizedUiTelemetry, g as readBoundedRequestJson, h as createNodeRequestListener, l as createWhiteboardCore, m as recordClientError, o as installProcessErrorTelemetry, p as clientErrorsForSession, r as takeOverServerHome, s as serverCrashReportPath, u as serverJson, v as HttpJsonError, w as setDiffrConfigValue, x as migrateDiffrConfig, y as ReviewServerError } from "../headless-host-CoN2f0Sk.js";
-import { c as readQuerySchemas } from "../authoring-tools-CjFAGHBa.js";
+import { t as openReviewProfile } from "../profile-B58hz5n7.js";
+import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-ClhP_5lW.js";
+import { o as REVIEW_TELEMETRY_TABS } from "../request-origin-BSwTNS8K.js";
+import { c as removeLegacyReviewSkills, d as skipCliInstall, h as detectConnectAgents, i as finishCliInstallUpdate, l as resetCliInstall, m as connectAgent, n as applyCliInstall, o as pathShimPath, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-D_mqo_Jk.js";
+import { C as saveDiffrSummarizer, E as cliAskTools, S as readDiffrConfig, T as testDiffrSummarizer, _ as DEFAULT_MAX_REQUEST_BYTES, a as drainServerCrashReport, b as GlobalReviewDesktopVerbRelay, c as answerErrorsAsJson, d as legacyModeSchema, f as captureSanitizedUiTelemetry, g as readBoundedRequestJson, h as createNodeRequestListener, l as createWhiteboardCore, m as recordClientError, o as installProcessErrorTelemetry, p as clientErrorsForSession, r as takeOverServerHome, s as serverCrashReportPath, u as serverJson, v as HttpJsonError, w as setDiffrConfigValue, x as migrateDiffrConfig, y as ReviewServerError } from "../headless-host-CnCDrHTx.js";
+import { c as readQuerySchemas } from "../authoring-tools-ByMdW_S8.js";
 import crypto, { createHash, randomBytes } from "node:crypto";
 import { z } from "zod";
 import fs, { existsSync, readFileSync } from "node:fs";
@@ -741,6 +742,16 @@ function jsonReviewBugReportSource(store, snapshot) {
 		}
 	};
 }
+/** The path id wins over any review id in the payload. */
+async function captureReviewUiEvent(telemetry, request, reviewId) {
+	const body = await readBoundedRequestJson(request, void 0, {});
+	const payload = isJsonObject(body) ? body : {};
+	const rawContext = isJsonObject(payload.context) ? payload.context : {};
+	await captureSanitizedUiTelemetry(telemetry, request, payload.name, payload.properties, recordClientError, payload.error, {
+		...rawContext,
+		reviewUuid: reviewId
+	}, payload.occurredAt);
+}
 /** Telemetry and report uploads for a pinned native review. */
 function createJsonReviewReporting(store, telemetry, options = {}) {
 	const { submit = submitReviewBugReport, shared } = options;
@@ -758,13 +769,7 @@ function createJsonReviewReporting(store, telemetry, options = {}) {
 		await next();
 	});
 	app.post("/:id/telemetry/event", async (c) => {
-		const body = await readBoundedRequestJson(c.req.raw, void 0, {});
-		const payload = isJsonObject(body) ? body : {};
-		const rawContext = isJsonObject(payload.context) ? payload.context : {};
-		await captureSanitizedUiTelemetry(telemetry, c.req.raw, payload.name, payload.properties, recordClientError, payload.error, {
-			...rawContext,
-			reviewUuid: c.req.param("id")
-		}, payload.occurredAt);
+		await captureReviewUiEvent(telemetry, c.req.raw, c.req.param("id"));
 		return c.json({ ok: true });
 	});
 	app.post("/:id/telemetry/tab", async (context) => {
@@ -1902,7 +1907,8 @@ function createReviewGateway(input) {
 		if (owner === void 0 || owner === "local") return input.local(request);
 		const alias = "remote" in owner ? owner.remote.alias : owner.down.alias;
 		if (route === "telemetry") {
-			await request.body?.cancel();
+			if (input.remoteEvent && new URL(request.url).pathname.endsWith("/telemetry/event")) await input.remoteEvent(request, reviewId);
+			else await request.body?.cancel();
 			return answer(alias, 200, { ok: true });
 		}
 		if (!route) return answer(alias, 404, {
@@ -1946,6 +1952,10 @@ function createReviewGateway(input) {
 		fetch: (request) => app.fetch(request),
 		setHosts: (list) => hosts.set(list),
 		hosts: () => hosts.states(),
+		isRemote(reviewId) {
+			const owner = locate(reviewId);
+			return owner !== void 0 && owner !== "local";
+		},
 		async close() {
 			closed = true;
 			stopWatchingWindows();
@@ -2115,6 +2125,7 @@ function createGlobalReviewServer(input) {
 		home: devReviewHome(),
 		relay,
 		restarted: (alias) => input.onRemoteHostRestarted?.(alias),
+		remoteEvent: (request, reviewId) => captureReviewUiEvent(telemetry, request, reviewId),
 		log: input.log
 	});
 	app.all("/reviews-api", (context) => gateway.fetch(context.req.raw));
@@ -2150,8 +2161,9 @@ function createGlobalReviewServer(input) {
 				delete eventProperties.source_kind;
 				delete eventProperties.agent_kind;
 				const rawContext = isJsonObject(payload.context) ? payload.context : {};
-				const sourceKind = sessionStartedSourceKind(reviewStore, jsonString(rawContext.reviewUuid));
-				if (sourceKind) eventProperties.source_kind = sourceKind;
+				const reviewUuid = jsonString(rawContext.reviewUuid);
+				Object.assign(eventProperties, sessionStartedSource(reviewStore, reviewUuid));
+				if (reviewUuid) eventProperties.remote = gateway.isRemote(reviewUuid);
 			}
 			await captureSanitizedUiTelemetry(telemetry, context.req.raw, payload.name, eventProperties, (event, eventContext) => {
 				flushBeforeOptOut = event.event === "review_setting_changed" && event.properties.setting === "telemetry_enabled" && event.properties.enabled === false;
@@ -2286,20 +2298,31 @@ function watchSessionOpen(watchdog, event, context) {
 	else if (event === "review_review_presented" || event === "review_session_ended") watchdog.presented(presentationSessionId);
 }
 /**
-* `session_started`'s `source_kind`: the opened review's target kind, or
-* `scratchpad` for the one scratchpad. Undefined when the review is gone (a
-* shared review this store never had, or one deleted between open and the
-* event arriving) or was left without a target.
+* `session_started`'s `source_kind` and `pr_provider`. Empty when the review
+* is not in this store: a shared or remote review, or one deleted between open
+* and the event arriving.
 */
-function sessionStartedSourceKind(reviewStore, reviewUuid) {
-	if (!reviewUuid) return void 0;
+function sessionStartedSource(reviewStore, reviewUuid) {
+	if (!reviewUuid) return {};
 	try {
 		const snapshot = reviewStore.read(reviewUuid);
-		return snapshot.kind === "scratchpad" ? snapshot.kind : snapshot.target?.kind;
+		const sourceKind = snapshot.kind === "scratchpad" ? snapshot.kind : snapshot.target?.kind;
+		const pullRequestUrl = snapshot.origin?.pullRequestUrl;
+		const prProvider = pullRequestUrl && prProviderOf(pullRequestUrl);
+		return {
+			...sourceKind && { source_kind: sourceKind },
+			...prProvider && { pr_provider: prProvider }
+		};
 	} catch {
-		return;
+		return {};
 	}
 }
+function prProviderOf(url) {
+	const resolved = pullRequestProvider(url);
+	if (!resolved) return void 0;
+	if (resolved.provider.id === "azure-devops") return "azure_devops";
+	return resolved.address.host === "github.com" ? "github" : "github_enterprise";
+}
 function listen(server, port) {
 	return new Promise((resolve, reject) => {
 		server.once("error", reject);

package/dist/sharing/index.d.ts

@@ -1644,6 +1644,7 @@ declare class LocalReviewData {
   }): Promise<{
     workspacePath: string;
     filePath?: string;
+    rootPath: string;
   }>;
   /** A document read that needs default pins; 409 when the document has none. */
   documentPins(snapshot: Snapshot): Promise<Pins>;

package/dist/{thread-state-CaQ2lGdj.js → thread-state-DZihwhfu.js}

@@ -1,25 +1,5 @@
 import { C as ReviewApiSelectionSourceSchema, O as ReviewSelectedDiffSchema } from "./src-DZG1xAqW.js";
 import { z } from "zod";
-import { stat } from "node:fs/promises";
-//#region src/fs-utils.ts
-/** Whether a thrown filesystem error reports a missing file (ENOENT). */
-function isMissingFileError(cause) {
-	return cause instanceof Error && "code" in cause && cause.code === "ENOENT";
-}
-async function isDirectory(target) {
-	try {
-		return (await stat(target)).isDirectory();
-	} catch {
-		return false;
-	}
-}
-async function isFile(target) {
-	try {
-		return (await stat(target)).isFile();
-	} catch {
-		return false;
-	}
-}
 /** A semantic selection, independent of comment/thread creation. */
 const AgentSelectionSchema = z.strictObject({
 	target: z.discriminatedUnion("kind", [
@@ -397,4 +377,4 @@ const askHistoryEntrySchema = z.object({
 	updatedAt: z.string()
 });
 //#endregion
-export { askHistoryEntrySchema as a, askPicksSchema as c, selectionMarkdown as d, isDirectory as f, askEntrySchema as i, askQuestionSchema as l, isMissingFileError as m, askAgentIds as n, askOfferSchema as o, isFile as p, askChoiceKinds as r, askPermissionsSchema as s, applyAskChange as t, AgentSelectionSchema as u };
+export { askHistoryEntrySchema as a, askPicksSchema as c, selectionMarkdown as d, askEntrySchema as i, askQuestionSchema as l, askAgentIds as n, askOfferSchema as o, askChoiceKinds as r, askPermissionsSchema as s, applyAskChange as t, AgentSelectionSchema as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.fast/whiteboard",
-  "version": "0.3.1-preview.20261016.122",
+  "version": "0.3.2",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -76,8 +76,8 @@
     "vitest": "4.1.11",
     "@dev.fast/json": "0.0.0",
     "@dev.fast/review-protocol": "0.0.0",
-    "@dev.fast/review-share-protocol": "0.1.2",
     "@dev.fast/trace-core": "0.0.0",
+    "@dev.fast/review-share-protocol": "0.1.2",
     "@dev.fast/trace-protocol": "0.5.0"
   },
   "engines": {
@@ -88,7 +88,7 @@
     "repo": "devdotfast/review",
     "docs": "packages/review/instructions/authoring.md"
   },
-  "gitHead": "7cef417b896162d45b18541ced02e6d250cdc535",
+  "gitHead": "38a6dad3049993f987d9b82ca3c5fee424b28f6b",
   "scripts": {
     "prebuild": "pnpm run build:workspace-deps",
     "build": "node --max-old-space-size=8192 node_modules/tsdown/dist/run.mjs",

package/src/review-api/agent-cli.ts

@@ -17,6 +17,7 @@ import {
   toolResultText,
 } from "./agent-client.js";
 import { type ReviewApiClient, ReviewApiError } from "./client.js";
+import { exitOnInstallUpdate } from "./install-update.js";
 import { callPublicTool, publicTool } from "./public-tools.js";
 import { RECOVERY } from "./recovery.js";
 import { REVIEW_AGENT_HEADER, REVIEW_VIA_HEADER } from "./request-origin.js";
@@ -70,6 +71,7 @@ export async function runReviewAgentCli(input: AgentCliInput): Promise<number> {
 
     if (mode === "mcp") {
       const { serveReviewMcp } = await import("./mcp.js");
+      exitOnInstallUpdate(input.stderr);
       await serveReviewMcp(
         async (key, agentKind) => {
           const connected = await connectReviewInstance(

package/src/review-api/install-update.ts

@@ -0,0 +1,27 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import type { Writable } from "node:stream";
+
+import { readBuildCommit } from "@review/package-paths.js";
+
+/** Exits once an update replaces this install, or the Windows updater marks it. */
+export function exitOnInstallUpdate(stderr: Writable): void {
+  const commit = readBuildCommit(import.meta.url);
+
+  if (!commit) return;
+
+  const marker = path.join(path.dirname(process.execPath), "applying_update");
+  const staleMarker = existsSync(marker);
+
+  const timer = setInterval(() => {
+    if (
+      (!staleMarker && existsSync(marker)) ||
+      readBuildCommit(import.meta.url) !== commit
+    ) {
+      clearInterval(timer);
+      stderr.write("Whiteboard was updated. Restart its MCP server.\n", () =>
+        process.exit(75),
+      );
+    }
+  }, 1000).unref();
+}

package/src/review-api/local-data.ts

@@ -382,7 +382,7 @@ export class LocalReviewData {
       commit?: string;
       anchor?: SourcePins;
     } = {},
-  ): Promise<{ workspacePath: string; filePath?: string }> {
+  ): Promise<{ workspacePath: string; filePath?: string; rootPath: string }> {
     const { pins } = await this.resolveSource(
       snapshot,
       source.commit,
@@ -515,7 +515,8 @@ export class LocalReviewData {
       }
     }
 
-    return { workspacePath, filePath };
+    // External editors open the checkout as their workspace beside the file.
+    return { workspacePath, filePath, rootPath };
   }
 
   /** A document read that needs default pins; 409 when the document has none. */

package/src/server/desktop-server.ts

@@ -40,6 +40,7 @@ import {
 } from "@review/desktop-discovery";
 import { readReviewPackageVersion } from "@review/package-paths";
 import type { LocalReviewData } from "@review/review-api/local-data.js";
+import { pullRequestProvider } from "@review/review-api/provider.js";
 import type { ReviewStore } from "@review/review-api/store.js";
 import {
   devReviewHome,
@@ -77,7 +78,10 @@ import {
   readBoundedRequestJson,
 } from "./hono-http";
 import { ReviewServerError } from "./http-json";
-import { createJsonReviewReporting } from "./json-review-reporting";
+import {
+  captureReviewUiEvent,
+  createJsonReviewReporting,
+} from "./json-review-reporting";
 import { removeLegacyTutorial } from "./legacy-tutorial-cleanup";
 import { createReviewGateway } from "./review-gateway";
 import { reviewLifecycleTelemetry } from "./review-lifecycle-telemetry";
@@ -253,6 +257,8 @@ export function createGlobalReviewServer(
     home: devReviewHome(),
     relay,
     restarted: (alias) => input.onRemoteHostRestarted?.(alias),
+    remoteEvent: (request, reviewId) =>
+      captureReviewUiEvent(telemetry, request, reviewId),
     log: input.log,
   });
 
@@ -314,12 +320,14 @@ export function createGlobalReviewServer(
 
         const rawContext = isJsonObject(payload.context) ? payload.context : {};
 
-        const sourceKind = sessionStartedSourceKind(
-          reviewStore,
-          jsonString(rawContext.reviewUuid),
+        const reviewUuid = jsonString(rawContext.reviewUuid);
+
+        Object.assign(
+          eventProperties,
+          sessionStartedSource(reviewStore, reviewUuid),
         );
 
-        if (sourceKind) eventProperties.source_kind = sourceKind;
+        if (reviewUuid) eventProperties.remote = gateway.isRemote(reviewUuid);
       }
 
       await captureSanitizedUiTelemetry(
@@ -562,28 +570,47 @@ function watchSessionOpen(
 }
 
 /**
- * `session_started`'s `source_kind`: the opened review's target kind, or
- * `scratchpad` for the one scratchpad. Undefined when the review is gone (a
- * shared review this store never had, or one deleted between open and the
- * event arriving) or was left without a target.
+ * `session_started`'s `source_kind` and `pr_provider`. Empty when the review
+ * is not in this store: a shared or remote review, or one deleted between open
+ * and the event arriving.
  */
-export function sessionStartedSourceKind(
+export function sessionStartedSource(
   reviewStore: ReviewStore,
   reviewUuid: string | undefined,
-): string | undefined {
-  if (!reviewUuid) return undefined;
+) {
+  if (!reviewUuid) return {};
 
   try {
     const snapshot = reviewStore.read(reviewUuid);
 
-    return snapshot.kind === "scratchpad"
-      ? snapshot.kind
-      : snapshot.target?.kind;
+    const sourceKind =
+      snapshot.kind === "scratchpad" ? snapshot.kind : snapshot.target?.kind;
+
+    const pullRequestUrl = snapshot.origin?.pullRequestUrl;
+
+    const prProvider = pullRequestUrl && prProviderOf(pullRequestUrl);
+
+    return {
+      ...(sourceKind && { source_kind: sourceKind }),
+      ...(prProvider && { pr_provider: prProvider }),
+    };
   } catch {
-    return undefined;
+    return {};
   }
 }
 
+function prProviderOf(url: string) {
+  const resolved = pullRequestProvider(url);
+
+  if (!resolved) return undefined;
+
+  if (resolved.provider.id === "azure-devops") return "azure_devops";
+
+  return resolved.address.host === "github.com"
+    ? "github"
+    : "github_enterprise";
+}
+
 function listen(server: Server, port: number): Promise<number> {
   return new Promise((resolve, reject) => {
     server.once("error", reject);

package/src/server/json-review-reporting.ts

@@ -23,6 +23,7 @@ import {
   requestJsonErrorStatus,
 } from "./review-api-parsers";
 import {
+  type ReviewTelemetryCapture,
   captureSanitizedUiTelemetry,
   clientErrorsForSession,
   recordClientError,
@@ -69,6 +70,27 @@ export function jsonReviewBugReportSource(
   };
 }
 
+/** The path id wins over any review id in the payload. */
+export async function captureReviewUiEvent(
+  telemetry: ReviewTelemetryCapture,
+  request: Request,
+  reviewId: string,
+) {
+  const body = await readBoundedRequestJson(request, undefined, {});
+  const payload = isJsonObject(body) ? body : {};
+  const rawContext = isJsonObject(payload.context) ? payload.context : {};
+  await captureSanitizedUiTelemetry(
+    telemetry,
+    request,
+    payload.name,
+    payload.properties,
+    recordClientError,
+    payload.error,
+    { ...rawContext, reviewUuid: reviewId },
+    payload.occurredAt,
+  );
+}
+
 /** Telemetry and report uploads for a pinned native review. */
 export function createJsonReviewReporting(
   store: ReviewStore,
@@ -105,21 +127,8 @@ export function createJsonReviewReporting(
     await next();
   });
   app.post("/:id/telemetry/event", async (c) => {
-    const body = await readBoundedRequestJson(c.req.raw, undefined, {});
-    const payload = isJsonObject(body) ? body : {};
-    const rawContext = isJsonObject(payload.context) ? payload.context : {};
-    await captureSanitizedUiTelemetry(
-      telemetry,
-      c.req.raw,
-      payload.name,
-      payload.properties,
-      recordClientError,
-      payload.error,
-      // The path id wins: the middleware above already asserted it exists,
-      // so a payload trying to assert a different review id is overridden.
-      { ...rawContext, reviewUuid: c.req.param("id") },
-      payload.occurredAt,
-    );
+    // The middleware above already asserted the review exists.
+    await captureReviewUiEvent(telemetry, c.req.raw, c.req.param("id"));
 
     return c.json({ ok: true });
   });

package/src/server/review-gateway.ts

@@ -129,6 +129,7 @@ export function createReviewGateway(input: {
   firstByteMs?: number;
   slowRouteMs?: number;
   restarted?(alias: string): void;
+  remoteEvent?(request: Request, reviewId: string): Promise<void>;
   log?(message: string): void;
 }) {
   const log = input.log ?? (() => {});
@@ -352,7 +353,12 @@ export function createReviewGateway(input: {
     const alias = "remote" in owner ? owner.remote.alias : owner.down.alias;
 
     if (route === "telemetry") {
-      await request.body?.cancel();
+      if (
+        input.remoteEvent &&
+        new URL(request.url).pathname.endsWith("/telemetry/event")
+      )
+        await input.remoteEvent(request, reviewId);
+      else await request.body?.cancel();
 
       return answer(alias, 200, { ok: true });
     }
@@ -420,6 +426,11 @@ export function createReviewGateway(input: {
     fetch: (request: Request) => app.fetch(request),
     setHosts: (list: ReviewGatewayHost[]) => hosts.set(list),
     hosts: () => hosts.states(),
+    isRemote(reviewId: string) {
+      const owner = locate(reviewId);
+
+      return owner !== undefined && owner !== "local";
+    },
     async close() {
       closed = true;
       stopWatchingWindows();

package/src/ui-telemetry-events.ts

@@ -28,6 +28,7 @@ import {
 } from "@dev.fast/review-protocol";
 import { z } from "zod";
 
+import { askAgentIds } from "./ask/thread-state";
 import { containsFilePath, hasPossibleUserInfo } from "./telemetry-clean-text";
 
 /** Property value validators: an enum of allowed strings, or a scalar type. */
@@ -64,6 +65,7 @@ const PEEK_VIA = [
   "map",
   "db_lens",
   "call_stack_frame",
+  "diff_definition",
 ] as const;
 
 export const PEEK_ROOT_KIND = ["range"] as const;
@@ -139,6 +141,7 @@ export const SETTING_NAME = [
   "diffr_config",
   "theme",
   "ctrl_tab",
+  "open_files_in",
   "ready_notification",
   "document_width",
   "code_font_size",
@@ -241,11 +244,43 @@ export const INSTALL_LOCATION = [
   "other",
 ] as const;
 
-export const DIFF_OPENED_VIA = ["topbar", "lens", "locate"] as const;
+export const DIFF_OPENED_VIA = [
+  "topbar",
+  "lens",
+  "locate",
+  "file_picker",
+] as const;
 
 /** Which diff opened: a commit's, or a file diff drawn plain or structural. */
 export const DIFF_OPENED_KIND = ["commit", "structural"] as const;
 
+/** GitHub Enterprise is any GitHub host but github.com. */
+export const PR_PROVIDER = [
+  "github",
+  "github_enterprise",
+  "azure_devops",
+] as const;
+
+export const REMOTE_HOST_PROBLEM = [
+  "unreachable",
+  "not_installed",
+  "auth_failed",
+  "unsupported",
+  "incompatible",
+] as const;
+
+export const REMOTE_HOST_TARGET = ["linux-x64", "linux-arm64"] as const;
+
+export const ASK_SELECTION = ["text", "code", "diff", "review"] as const;
+
+export const ONBOARDING_STEP = ["welcome", "install", "run"] as const;
+
+export const RUN_MODE = ["draw", "copy"] as const;
+
+export const NEW_WHITEBOARD_VIA = ["button", "command"] as const;
+
+export const FIND_SURFACE = ["review", "diff"] as const;
+
 export const DISCORD_VIA = ["topbar", "dialog", "docs"] as const;
 
 const REVIEW_DELETED_VIA = ["home"] as const;
@@ -514,6 +549,8 @@ export const UI_TELEMETRY_EVENTS = {
     properties: {
       source_kind: SESSION_SOURCE_KIND,
       agent_kind: SESSION_AGENT_KIND,
+      remote: "boolean",
+      pr_provider: PR_PROVIDER,
     },
   },
   session_ended: {
@@ -584,6 +621,55 @@ export const UI_TELEMETRY_EVENTS = {
   },
   // The reader copied the review's share link.
   review_shared: { event: "review_review_shared", properties: {} },
+  find_opened: {
+    event: "review_find_opened",
+    properties: { surface: FIND_SURFACE },
+  },
+  ask_sent: {
+    event: "review_ask_sent",
+    properties: {
+      agent: askAgentIds,
+      follow_up: "boolean",
+      selection: ASK_SELECTION,
+      remote: "boolean",
+    },
+  },
+  onboarding_step_viewed: {
+    event: "review_onboarding_step_viewed",
+    properties: { step: ONBOARDING_STEP },
+  },
+  onboarding_skipped: {
+    event: "review_onboarding_skipped",
+    properties: { step: ONBOARDING_STEP },
+  },
+  onboarding_run_started: {
+    event: "review_onboarding_run_started",
+    properties: { mode: RUN_MODE, agent: askAgentIds },
+  },
+  new_whiteboard_opened: {
+    event: "review_new_whiteboard_opened",
+    properties: { via: NEW_WHITEBOARD_VIA },
+  },
+  new_whiteboard_started: {
+    event: "review_new_whiteboard_started",
+    properties: { mode: RUN_MODE, embedded: "boolean", agent: askAgentIds },
+  },
+  remote_host_installed: {
+    event: "review_remote_host_installed",
+    properties: {
+      ok: "boolean",
+      target: REMOTE_HOST_TARGET,
+      duration_ms: "number",
+    },
+  },
+  remote_host_connected: {
+    event: "review_remote_host_connected",
+    properties: {
+      ok: "boolean",
+      problem: REMOTE_HOST_PROBLEM,
+      direct: "boolean",
+    },
+  },
 } as const satisfies Record<
   string,
   { event: string; properties: Record<string, UiTelemetryPropertySpec> }

package/dist/agent-cli-NWQPsL0W.js

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

package/dist/profile-BBw-jMW3.js

@@ -1,2 +0,0 @@
-import { t as openReviewProfile } from "./profile-Dm6irjbg.js";
-export { openReviewProfile };