@dev.fast/whiteboard 0.4.0 → 0.4.1-preview.20261026.137

package/dist/{account-alias-2yTAxoBx.js → account-alias-BpH8VvTR.js}

@@ -1,11 +1,11 @@
 import { n as isJsonObject } from "./src-X9phtB2j.js";
-import { E as ReviewCliInstallStampSchema } from "./src-DYHVzX3b.js";
+import { E as ReviewCliInstallStampSchema } from "./src-DEOc8bvC.js";
 import { G as removeAgentTraceHook, H as AGENT_TRACE_HOOK_AGENTS, I as disableAllTraceRepositories, L as enableTraceRepository, Q as readStoreAuth, R as listTraceRepositoryRoots, U as describeTraceHookOwners, W as installHarnessHooks, Y as traceScope, g as disableTraceMachine, h as configureTraceMachine, rt as StoreClient, v as traceMachineEnabled, y as traceMachineStatus, z as traceRepositoryStatus } from "./src-Z1x4-Qmb.js";
 import { I as writeFileAtomicAsync, L as writePrivateJsonAtomic, N as devReviewHome, j as withFileLock } from "./s3-config-CjcLyFV5.js";
 import { i as readReviewPackageVersion } from "./package-paths-BeYHYjeR.js";
 import { n as reviewDesktopStateDir } from "./review-home-paths-CG-sb9Cw.js";
 import { n as isFile, t as isDirectory } from "./fs-utils-BMPLt0cr.js";
-import { c as findExecutable, s as executableCommand } from "./fuzzy-match-CfSxqzBF.js";
+import { c as findExecutable, s as executableCommand } from "./fuzzy-match-BNLXmpbv.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-DFWrNoGJ.js

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

package/dist/{agent-cli-CHNDd4Ga.js → agent-cli-DckMzOU_.js}

@@ -1,13 +1,13 @@
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
 import { v as traceMachineEnabled } from "./src-Z1x4-Qmb.js";
-import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-Dc0vHFJt.js";
+import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-D4FSEDX4.js";
 import { N as devReviewHome } from "./s3-config-CjcLyFV5.js";
 import { n as readBuildCommit } from "./package-paths-BeYHYjeR.js";
 import "./review-home-paths-CG-sb9Cw.js";
-import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-DKLIOgg3.js";
-import { n as reviewSessionAgent } from "./review-telemetry-BM-_KdLi.js";
-import { a as REVIEW_VIA_HEADER, i as REVIEW_THREAD_HEADER, n as REVIEW_AGENT_HEADER, t as ASK_THREAD_ENV } from "./request-origin-CNSLVn7x.js";
-import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-C1L1vJyz.js";
+import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-BchUrwFW.js";
+import { n as reviewSessionAgent } from "./review-telemetry-ChlsTRPN.js";
+import { a as REVIEW_VIA_HEADER, i as REVIEW_THREAD_HEADER, n as REVIEW_AGENT_HEADER, t as ASK_THREAD_ENV } from "./request-origin-BIBW432J.js";
+import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-DlU9hn7_.js";
 import { existsSync } from "node:fs";
 import path from "node:path";
 //#region src/review-api/install-update.ts
@@ -44,7 +44,7 @@ async function runReviewAgentCli(input) {
 			[REVIEW_THREAD_HEADER, thread ?? ""]
 		]);
 		if (mode === "mcp") {
-			const { serveReviewMcp } = await import("./mcp-Br-r_wwR.js");
+			const { serveReviewMcp } = await import("./mcp-D74cFQNM.js");
 			exitOnInstallUpdate(input.stderr);
 			await serveReviewMcp(async (key, agentKind) => {
 				const connected = await connectReviewInstance(key ? {

package/dist/{agent-client-Dc0vHFJt.js → agent-client-D4FSEDX4.js}

@@ -1,7 +1,7 @@
 import { d as isBooleanValue, f as isNumberValue, m as isStringValue, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DYHVzX3b.js";
+import "./src-DEOc8bvC.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-DKLIOgg3.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-BchUrwFW.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. */
@@ -259,7 +259,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-DyWnPJyZ.js");
+		const { ensureServerWithoutDesktop } = await import("./background-server-BPZ3GQan.js");
 		const server = await ensureServerWithoutDesktop({
 			selection,
 			env,

package/dist/{authoring-tools-D8EkIDjm.js → authoring-tools-DmIJZq0b.js}

@@ -1,6 +1,6 @@
 import { n as isJsonObject } from "./src-X9phtB2j.js";
-import { c as activityBeginSchema, l as activityEndSchema, n as uploadSchema, r as commandSchema, u as activityUpdateSchema } from "./local-data-DHedfhxw.js";
-import { L as publishedEditSchema, N as pathTargetSchema } from "./stored-document-migration-DEt8iwem.js";
+import { c as activityBeginSchema, l as activityEndSchema, n as uploadSchema, r as commandSchema, u as activityUpdateSchema } from "./local-data-C0OJttzT.js";
+import { L as publishedEdits, N as pathTargetSchema } from "./stored-document-migration-BCFx07Bq.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { t as findReviewPackageRoot } from "./package-paths-BeYHYjeR.js";
 import { z } from "zod";
@@ -69,6 +69,8 @@ const readQuerySchemas = {
 };
 //#endregion
 //#region src/review-api/component-reference.ts
+/** The animation component, shown only while Animations are on. */
+const ANIMATION = ["- animation {title, html, frames: {key, title, label?, caption?, duration? (ms)}[] (1 to 60), code?: {name: anchor}, height?: \"auto\" (default) | number (120 to 1200 CSS px), pins?}; declare every possible frame", "Use an animation for change over time that a static diagram cannot show: state before and after, a cache filling, data changing as a request crosses layers. It can sit in design beside the diagram, or replace it when the motion is the point. If nothing changes between frames, use a sequence or flow_diagram instead: their steps and nodes link to code. Read session_get_instructions({topic:\"animation\"}) before writing one."];
 /** Every component's fields, for session_get_instructions: the edit tool's
 * description must stay short enough that clients don't cut it off. */
 const COMPONENT_REFERENCE = [
@@ -97,11 +99,17 @@ const COMPONENT_REFERENCE = [
 	"- store {label, storage: relational|document, collections: {key: {label, fields: {key: field}, source?: anchor of its schema declaration}}, dataStoreKind?: database|objectStore|bucket|artifactStore|fileStore}",
 	"- field {label, dataType, nullable?, primaryKey?, references?: {store, collection, field}, fields?: {key: field}}",
 	"- useCase {label, summary?, operations: operation[] (1 or more)}; operation {kind: read|write, actor, store, collection, label, source: anchor, field?, detail?, pins?}, naming declared keys",
+	...ANIMATION,
 	"",
 	"Example (replace its path and lines with verified ones): {\"type\":\"sequence\",\"title\":\"Request\",\"actors\":{\"a\":\"Client\",\"b\":\"Server\"},\"steps\":[{\"from\":\"a\",\"to\":\"b\",\"label\":\"Send\",\"source\":\"head/src/app.ts#L10-L20\"}]}"
 ].join("\n");
+/** Keep disabled experimental components out of agent guidance. */
+function componentReference(animationsEnabled) {
+	return animationsEnabled ? COMPONENT_REFERENCE : COMPONENT_REFERENCE.split("\n").filter((line) => !ANIMATION.includes(line)).join("\n");
+}
 const instructionsQuerySchema = z.strictObject({ topic: z.enum([
 	"authoring",
+	"animation",
 	"file-lenses",
 	"trace-archaeology"
 ]).default("authoring") });
@@ -119,12 +127,13 @@ function read(root, name) {
 	return content;
 }
 async function renderInstructions(topic, context, root = findReviewPackageRoot(import.meta.url)) {
+	if (topic === "animation" && !context.animationsEnabled) throw new ReviewInputError("Animation authoring is disabled. Enable Animations in Settings under Experimental Features.", 409);
 	if (topic === "trace-archaeology" && !context.traceEnabled) return "Trace capture is off on this machine, so no agent traces are available. It can be turned on in Whiteboard Desktop Settings under Experimental Features.";
 	if (topic !== "authoring") return read(root, topic);
 	const more = [...context.traceEnabled ? ["- Why code exists / past agent sessions: `session_get_instructions({topic:\"trace-archaeology\"})`"] : []];
 	return [
 		await read(root, "authoring"),
-		COMPONENT_REFERENCE,
+		componentReference(context.animationsEnabled === true),
 		...context.traceEnabled ? ["## Traces\n\nAt the end, run `whiteboard trace list --session <sessionId> --json`, which covers every commit in the review. If it lists no sessions, there are no traces to quote: skip this step. Otherwise read `session_get_instructions({topic:\"trace-archaeology\"})` and rewrite as much as possible of the what/why, design, and requirements sections in terms of literal trace quotes from the user."] : [],
 		...more.length ? [`## More guidance\n\n${more.join("\n")}`] : []
 	].join("\n\n");
@@ -146,9 +155,9 @@ const REVIEW_STATUS_TOOL = {
 //#endregion
 //#region src/review-api/authoring-tools.ts
 /** The host publishes its input schemas, except where agents write less than
-* the host accepts (publishedEditSchema, publishedLensEditSchema) or name a
+* the host accepts (publishedEdits, publishedLensEditSchema) or name a
 * checkout by path (pathTargetSchema); adapters validate nothing. */
-function authoringTools(traceEnabled = false) {
+function authoringTools(traceEnabled = false, animationsEnabled = false) {
 	const id = z.string().min(1);
 	const review = { reviewId: id };
 	const [image, trace] = uploadSchema.options;
@@ -163,7 +172,7 @@ function authoringTools(traceEnabled = false) {
 	});
 	const descriptions = {
 		create: "Create a whiteboard. target names its repository by the checkout's path, and what it shows: {kind:\"project\"} for a plan in that repository's project with no change; {kind:\"worktree\", base?} for the saved files in the checkout, uncommitted ones included and untracked ones left out (git add -N a new file to include it), against base, by default the repository's default branch, from the merge base of base and HEAD, which follows rebases; {kind:\"commits\", head, base?} for immutable commits (omitted base means source at head with no diff; supply the parent to review introduced changes); {kind:\"pullRequest\", pullRequest} for a GitHub PR by URL or number, fetched into that checkout and pinned at the PR head and GitHub diff base. For a branch stacked on another, pass the branch below it as base. Group plan implementations or a PR stack under one project-target overview with parentId, and order its children with dependsOn; Git bases do not set these relationships. Revisions are resolved on acceptance. With a PR and no title the PR's title is used. When the existing review for that PR is in Trash, creation reports its ID; restore it with review_lifecycle state:\"active\" before continuing. When an active review for that PR exists, it is returned instead, reporting whether its head moved and whether an agent is working on it; update it in place, move its target with review_set_target, or create a separate review with reuseExisting:false. The result carries review, as review_list shows it, with its target and repositoryPath, so no follow-up read is needed before diffing. When Desktop is available the review opens there and the result reports opened, softwareMapEnabled and environmentIssues, as review_open does; set open:false to author in the background without taking over Desktop. parentId and dependsOn set its place among the project's reviews, as review_set_parent and review_set_dependencies do; projectId files it in another project, by project.id from review_list.",
-		set_target: "Move the review to a new target (the same targets review_create takes), such as the commits after a rebase or amend, or commits or a PR for a board that had none. The document and component IDs are kept. Revisions are resolved on acceptance. Returns warnings for retained source ranges in files the new commits changed, to verify, and resources that no longer match; fix them with review_edit. Earlier versions keep their source. A PR target names the PR; other targets keep it within the same repository and clear it across repositories.",
+		set_target: "Move the review to a new target (the same targets review_create takes), such as the commits after a rebase or amend, or commits or a PR for a board that had none. The document and component IDs are kept. Revisions are resolved on acceptance. Returns warnings for retained source ranges in files the new commits changed, to verify, and resources that no longer match; fix them with review_edit. Earlier versions keep their source. A PR target names the PR; other targets keep it within the same repository and clear it across repositories. To refresh a PR review, pass its PR target again: a commits target with its branch names pins their tips, not the PR's diff base.",
 		edit: [
 			"Edit one document component. content is one component, named by its type; each type's fields are in the Components section of session_get_instructions.",
 			"Anchors are head/path#L10-L20 or base/path#L7, or diff/path#L84-R90 for a range across sides, with repository-relative paths and 1-based inclusive lines. pins {head, base?} say which commits of the whiteboard's repository anchors quote: a step, frame, attachment or operation without pins uses its block's, and a block without them the review's.",
@@ -194,7 +203,11 @@ function authoringTools(traceEnabled = false) {
 	return [
 		REVIEW_STATUS_TOOL,
 		tool("capabilities", "Discover whether Desktop is available and optional software-map generation is enabled. Read before authoring.", z.strictObject({}), "GET", "/capabilities"),
-		tool("get_instructions", "Read Whiteboard's guidance before creating or editing a review. The default topic gives the authoring workflow; \"file-lenses\" covers Diff-view file lenses." + (traceEnabled ? " Call review_get_instructions({topic:\"trace-archaeology\"}) for why code exists, what an agent was thinking, or whether an agent solved this before." : ""), instructionsQuerySchema.partial(), "GET", "/instructions"),
+		tool("get_instructions", "Read Whiteboard's guidance before creating or editing a review. The default topic gives the authoring workflow; \"file-lenses\" covers Diff-view file lenses." + (traceEnabled ? " Call review_get_instructions({topic:\"trace-archaeology\"}) for why code exists, what an agent was thinking, or whether an agent solved this before." : ""), instructionsQuerySchema.extend({ topic: animationsEnabled ? instructionsQuerySchema.shape.topic : z.enum([
+			"authoring",
+			"file-lenses",
+			"trace-archaeology"
+		]).default("authoring") }).partial(), "GET", "/instructions"),
 		tool("activity_begin", "Show that you are working on a review: the reader sees your focus and your courier drawing your edits, and the review reads as finished only once every agent has ended. Returns an activityId: pass it to session_edit and session_lens_edit so your courier draws them, and to review_activity_update and review_activity_end. Nothing is locked; other agents can work on the review too. The activity expires after 3 minutes without an edit or update.", activityBeginSchema.extend(review), "POST", "/:reviewId/activity/begin"),
 		tool("activity_update", "Change your focus, or keep your activity alive during long reads or pauses; an edit carrying your activityId already keeps it alive. Omitted focus preserves it and null clears it. Fails once the activity has expired: begin a new one.", activityUpdateSchema.extend(review), "POST", "/:reviewId/activity/update"),
 		tool("activity_end", "End your activity when your part is finished: readers treat a review with content and no live activity as ready. Ending it creates no document version. Ending twice, or an expired activity, changes nothing.", activityEndSchema.extend(review), "POST", "/:reviewId/activity/end"),
@@ -208,7 +221,7 @@ function authoringTools(traceEnabled = false) {
 					open: z.boolean().optional()
 				},
 				...type === "set_target" && { target: pathTargetSchema },
-				...type === "edit" && { edit: publishedEditSchema }
+				...type === "edit" && { edit: publishedEdits(animationsEnabled) }
 			}), "POST", "/commands", type);
 		}),
 		tool("list", "List saved reviews.", z.strictObject({}), "GET", ""),

package/dist/{background-server-DHWHzpo5.js → background-server-B1uwDQTr.js}

@@ -1,8 +1,8 @@
 import "./src-Z1x4-Qmb.js";
 import { D as liveLockOwner, k as processIsAlive } from "./s3-config-CjcLyFV5.js";
 import { t as findReviewPackageRoot } from "./package-paths-BeYHYjeR.js";
-import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-DKLIOgg3.js";
-import { t as desktopApplicationInstalled } from "./review-app-launcher-BZAnR8Vp.js";
+import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-BchUrwFW.js";
+import { t as desktopApplicationInstalled } from "./review-app-launcher-Brn60fPu.js";
 import { mkdir, open, readFile, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { spawn } from "node:child_process";

package/dist/{background-server-DyWnPJyZ.js → background-server-BPZ3GQan.js}

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

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"0.4.0","commit":"90564c926cee5f245d498cb56585759cca9b312b","dirty":true,"builtAt":"2026-10-23T18:11:19.854Z"}
+{"version":"0.4.1-preview.20261026.137","commit":"46629c2739b7efbdb10cd7a98cfacb315e8d7ae0","dirty":true,"builtAt":"2026-10-26T17:52:50.758Z"}

package/dist/{cli-runner-DFBaVGij.js → cli-runner-DVEDbjXo.js}

@@ -1,19 +1,19 @@
 import { D as __commonJSMin, E as setLocalVcsCommandObserver, O as __require, k as __toESM } from "./src-X9ZebeOD.js";
 import { c as jsonString, n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { S as REVIEW_REMOTE_ATTACH_END, b as REVIEW_REMOTE_AGENT_IDS, h as REVIEW_CLI_INSTALL_TARGET_LABELS, l as boardTitle, x as REVIEW_REMOTE_ATTACH_BEGIN } from "./src-DYHVzX3b.js";
+import { S as REVIEW_REMOTE_ATTACH_END, b as REVIEW_REMOTE_AGENT_IDS, h as REVIEW_CLI_INSTALL_TARGET_LABELS, l as boardTitle, x as REVIEW_REMOTE_ATTACH_BEGIN } from "./src-DEOc8bvC.js";
 import { $ as runStoreLogin, A as loadS3TraceStorage, B as readTraceUserConfig, C as runTraceDeny, D as runTraceStoreInfo, E as runTraceStoreDelete, F as resolveTraceRepositoryTarget, J as traceHomeDir, K as resolveTraceCommand, M as selectTraceStorage, O as describeSelection, P as requireTraceConsent, Q as readStoreAuth, S as runTraceAllow, T as runTraceSessions, V as HOSTED_CAPTURE_SCOPE_DESCRIPTION, X as DEFAULT_STORE_ORIGIN, Y as traceScope, _ as readLegacyCaptureSettings, a as runTracePull$1, at as emitJsonEvent, c as runTraceEnable, ct as jsonRequestedInArgv, d as runTraceStatus, et as runStoreLogout, f as runTraceSync, i as runTraceList$1, it as withStoreAuthorization, l as runTraceInstallMachine, m as runTraceHook, n as resolveTraceReadStorage, nt as StoreApiError, o as runTraceShow, ot as failWithJsonError, p as runTraceGitHook, r as runTraceBlame, rt as StoreClient, s as runTraceDisable, st as humanStream, t as registerTraceCommands, tt as runStoreWhoami, u as runTraceRepair, v as traceMachineEnabled, w as runTraceOnboard, y as traceMachineStatus, z as traceRepositoryStatus } from "./src-Z1x4-Qmb.js";
-import { o as ReviewApiClient, s as ReviewApiError } from "./agent-client-Dc0vHFJt.js";
+import { o as ReviewApiClient, s as ReviewApiError } from "./agent-client-D4FSEDX4.js";
 import { C as s3ProfileSchema, E as writeTraceConfigFile, N as devReviewHome, P as normalizeStoreOrigin, S as readTraceConfigFile, T as sameS3Profile, _ as emptyTraceConfig, c as resolveS3Setup, g as currentStore, h as TraceConfigurationError, i as isS3MockMode, n as clearTraceEnvCache, o as readTraceEnvFile, p as traceSettingsPath, w as s3Store } from "./s3-config-CjcLyFV5.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, r as readBuildInfo, t as findReviewPackageRoot } from "./package-paths-BeYHYjeR.js";
 import { t as resolveReviewRoot } from "./runtime-C6_1K-3Z.js";
 import "./review-home-paths-CG-sb9Cw.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-DKLIOgg3.js";
-import { t as ReviewTelemetry } from "./review-telemetry-BM-_KdLi.js";
-import { t as fuzzyRank } from "./fuzzy-match-CfSxqzBF.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-2yTAxoBx.js";
-import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-BZAnR8Vp.js";
-import { t as reviewAgentCliHelp } from "./agent-cli-CHNDd4Ga.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-BchUrwFW.js";
+import { t as ReviewTelemetry } from "./review-telemetry-ChlsTRPN.js";
+import { t as fuzzyRank } from "./fuzzy-match-BNLXmpbv.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-BpH8VvTR.js";
+import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-Brn60fPu.js";
+import { t as reviewAgentCliHelp } from "./agent-cli-DckMzOU_.js";
 import { existsSync, mkdirSync, renameSync, writeFileSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import path from "node:path";
@@ -4334,7 +4334,7 @@ async function runReviewCli(input) {
 		if (!Number.isInteger(port) || port < 0 || port > 65535) throw new ReviewCliUsageError("--port must be an integer between 0 and 65535.");
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
 		if (options.detach) {
-			const { ensureBackgroundServer } = await import("./background-server-DyWnPJyZ.js");
+			const { ensureBackgroundServer } = await import("./background-server-BPZ3GQan.js");
 			const { discovery, started } = await ensureBackgroundServer({
 				stateDir,
 				env,
@@ -4356,7 +4356,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-dwlqhqMY.js");
+		const { HeadlessServerBusyError, runHeadlessServer } = await import("./headless-host-B63e2z2j.js");
 		try {
 			await runHeadlessServer({
 				stateDir,
@@ -4393,7 +4393,7 @@ async function runReviewCli(input) {
 	configureJsonOutput(serverCommand.command("stop").description("Stop a background server started by --detach, the CLI, or Desktop").option("--state-dir <path>", "directory selected when starting the server"), "plain").action(async (_options, command) => {
 		const options = command.optsWithGlobals();
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
-		const { headlessServerOwner, stopBackgroundServer } = await import("./background-server-DyWnPJyZ.js");
+		const { headlessServerOwner, stopBackgroundServer } = await import("./background-server-BPZ3GQan.js");
 		const owner = await headlessServerOwner(stateDir);
 		const discovery = await readReviewServerDiscovery(stateDir);
 		if (owner === void 0) {
@@ -4421,7 +4421,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-BopGMZUh.js"), import("./headless-host-dwlqhqMY.js")]);
+		const [{ openReviewProfile }, { withHeadlessServerLock }] = await Promise.all([import("./profile-CAn8Qdeh.js"), import("./headless-host-B63e2z2j.js")]);
 		const reset = await withHeadlessServerLock(await realpath(stateDir), async () => {
 			const local = await openReviewProfile(stateDir, { manageWorkspaces: false });
 			try {
@@ -4443,7 +4443,7 @@ async function runReviewCli(input) {
 	configureJsonOutput(remote.command("attach").description("Start a background server if none is healthy and report how to reach it").option("--state-dir <path>", "directory for saved reviews and server discovery").option("--groups <groups>", "comma-separated optional extension groups the Desktop has enabled, such as go").option("--replace", "stop a running server of another version that the CLI or Desktop started, and start this one"), "plain").action(async (_options, command) => {
 		const options = command.optsWithGlobals();
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
-		const { remoteAttach } = await import("./remote-attach-DSGpTOJ4.js");
+		const { remoteAttach } = await import("./remote-attach-DTByuwBs.js");
 		let attach;
 		try {
 			attach = await remoteAttach({
@@ -4485,7 +4485,7 @@ async function runReviewCli(input) {
 	configureJsonOutput(remote.command("uninstall").description("Remove what Whiteboard Desktop installed on this host, stopping a server it started").addOption(new Option("--keep-reviews", "leave the saved reviews in place").conflicts("deleteReviews")).addOption(new Option("--delete-reviews", "also delete the saved reviews")).option("--state-dir <path>", "directory for saved reviews and server discovery"), "plain").action(async (_options, command) => {
 		const options = command.optsWithGlobals();
 		const stateDir = reviewServerStateDir(authoringEnv(options.stateDir));
-		const { remoteUninstall } = await import("./remote-uninstall-Dp2o3qz0.js");
+		const { remoteUninstall } = await import("./remote-uninstall-aXApHJPy.js");
 		let deleteReviews = options.deleteReviews ? true : options.keepReviews ? false : void 0;
 		if (deleteReviews === void 0 && !options.json && input.stdin?.isTTY) {
 			const prompt = createInterface$1({
@@ -4707,14 +4707,14 @@ async function runReviewCli(input) {
 		command.showHelpAfterError(false).error("Markdown review migration is no longer supported. Ask your agent to migrate your old Whiteboard reviews.");
 	});
 	configureJsonOutput(configureJsonOutput(program.command("share").description("Upload an immutable review snapshot and return its share link"), "plain").option("--review <id>", "review ID").option("--version <number>", "Saved version to share").option("--preview", "Open the share link in Whiteboard Preview by default").option("--request-id <uuid>", "Reuse this ID when retrying the same immutable upload").action(async (options) => {
-		const { runShareCli } = await import("./cli-qZomwJmK.js");
+		const { runShareCli } = await import("./cli-tWBQpq27.js");
 		state.exitCode = await runShareCli({
 			...input,
 			...options,
 			env: authoringEnv()
 		});
 	}).command("revoke <share-id>").description("Revoke future downloads of a share"), "plain").action(async (shareId, options) => {
-		const { runShareCli } = await import("./cli-qZomwJmK.js");
+		const { runShareCli } = await import("./cli-tWBQpq27.js");
 		state.exitCode = await runShareCli({
 			...input,
 			...options,
@@ -4795,7 +4795,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-Cn4-16XA.js");
+		const { runReviewAgentCli } = await import("./agent-cli-DFWrNoGJ.js");
 		state.exitCode = await runReviewAgentCli({
 			...input,
 			env: authoringEnv(),

package/dist/{cli-qZomwJmK.js → cli-tWBQpq27.js}

@@ -1,4 +1,4 @@
-import { r as connectReviewApi } from "./agent-client-Dc0vHFJt.js";
+import { r as connectReviewApi } from "./agent-client-D4FSEDX4.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/sharing/cli.ts

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { a as jsonNumber, c as jsonString, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DYHVzX3b.js";
+import "./src-DEOc8bvC.js";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import path from "node:path";
 import os from "node:os";
@@ -17,7 +17,7 @@ async function runCli(effectivePath) {
 `);
 		return 1;
 	}
-	const { runReviewCli } = await import("./cli-runner-DFBaVGij.js");
+	const { runReviewCli } = await import("./cli-runner-DVEDbjXo.js");
 	return runReviewCli({
 		argv,
 		cliPaths: {

package/dist/{client-p9WB8Sj0.js → client-C8vT0mhW.js}

@@ -1,8 +1,8 @@
 import { f as gitAt } from "./src-X9ZebeOD.js";
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DYHVzX3b.js";
-import { f as sourceAnchors } from "./lens-selection-9byzEgvU.js";
-import { B as resourceReferences, D as boardRepositoryId, I as pinsSchema, J as checkReferences, K as sourceReferences, R as readsAtBoardPins, S as anchorPins, b as textIncludesQuote, c as traceSchema, et as lensSchema, j as elements, k as documentSchema, lt as parseMarkdown, n as migrateStoredDocument, r as migrateStoredLenses, s as softwareModelDataSchema, st as markdownNodes, t as liftFileLenses, tt as lensSelections, u as pullRequestUrl, z as resourceReference } from "./stored-document-migration-DEt8iwem.js";
+import "./src-DEOc8bvC.js";
+import { f as sourceAnchors } from "./lens-selection-EuZdag4Q.js";
+import { B as resourceReferences, D as boardRepositoryId, I as pinsSchema, J as checkReferences, K as sourceReferences, R as readsAtBoardPins, S as anchorPins, b as textIncludesQuote, c as traceSchema, et as lensSchema, j as elements, k as documentSchema, lt as parseMarkdown, n as migrateStoredDocument, r as migrateStoredLenses, s as softwareModelDataSchema, st as markdownNodes, t as liftFileLenses, tt as lensSelections, u as pullRequestUrl, z as resourceReference } from "./stored-document-migration-BCFx07Bq.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { createHash, randomUUID } from "node:crypto";
 import { z } from "zod";

package/dist/{fuzzy-match-CfSxqzBF.js → fuzzy-match-BNLXmpbv.js}

@@ -1,7 +1,7 @@
 import "./src-Z1x4-Qmb.js";
 import { N as devReviewHome } from "./s3-config-CjcLyFV5.js";
-import { n as askAgentIds } from "./thread-state-CO97FUqK.js";
-import { t as ASK_THREAD_ENV } from "./request-origin-CNSLVn7x.js";
+import { n as askAgentIds } from "./thread-state-CbLB0jUA.js";
+import { t as ASK_THREAD_ENV } from "./request-origin-BIBW432J.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-dwlqhqMY.js → headless-host-B63e2z2j.js}

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

package/dist/{headless-host-DJhcab6r.js → headless-host-Dl9g9Fvd.js}

@@ -1,23 +1,23 @@
 import { b as resolveRepoContext, d as git, r as defaultBranch, w as runVcs } from "./src-X9ZebeOD.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 validateShareSources, f as StreamLimitError, h as shareIdSchema, l as exportShare, m as parseShareLink, n as ShareClient, p as readBoundedStream, r as SharePreflightError, s as readShareRepository, t as ShareAuthError, u as referenceCommits } from "./client-p9WB8Sj0.js";
-import { d as textualRows, f as invalidateStructuralComparisons, h as readGitHubPullRequests, i as inspectSnapshot, m as diffrMissingError, p as diffrExecutable, r as commandSchema } from "./local-data-DHedfhxw.js";
-import { N as reviewDiffrSummarizerInputSchema, O as ReviewFeedbackContactSchema, P as decodeStructuralDiffEvent, a as parseReviewVerbRequest, c as boardIconKind, i as parseReviewDesktopVerbResult, j as ReviewOnboardingRunRequestSchema, k as ReviewFeedbackSchema, l as boardTitle, m as REVIEW_CLIENT_REMOTE, p as REVIEW_CLIENT_HEADER, y as REVIEW_HOST_HEADER } from "./src-DYHVzX3b.js";
+import { a as sharedReviewId, c as verifyShareRepository, d as validateShareSources, f as StreamLimitError, h as shareIdSchema, l as exportShare, m as parseShareLink, n as ShareClient, p as readBoundedStream, r as SharePreflightError, s as readShareRepository, t as ShareAuthError, u as referenceCommits } from "./client-C8vT0mhW.js";
+import { d as textualRows, f as invalidateStructuralComparisons, h as readGitHubPullRequests, i as inspectSnapshot, m as diffrMissingError, p as diffrExecutable, r as commandSchema } from "./local-data-C0OJttzT.js";
+import { F as decodeStructuralDiffEvent, N as reviewDiffrSummarizerInputSchema, O as ReviewFeedbackContactSchema, a as parseReviewVerbRequest, c as boardIconKind, i as parseReviewDesktopVerbResult, j as ReviewOnboardingRunRequestSchema, k as ReviewFeedbackSchema, l as boardTitle, m as REVIEW_CLIENT_REMOTE, p as REVIEW_CLIENT_HEADER, y as REVIEW_HOST_HEADER } from "./src-DEOc8bvC.js";
 import { $ as runStoreLogin, M as selectTraceStorage, N as TraceStorageDeniedError, Q as readStoreAuth, X as DEFAULT_STORE_ORIGIN, Z as clearStoreAuth, b as listReviewTraceSessions, j as resolveTraceStorage, k as isTraceStorageConfigured, q as shellQuote, v as traceMachineEnabled, x as loadReviewAgentTrace } from "./src-Z1x4-Qmb.js";
-import { _ as scopedCoverage, h as emptyCoverage, i as anchorSelection, l as resolveDiffSelection, m as coverageSources, n as SelectionUnavailableError, o as comparisonKey, s as formatAnchor, u as selectionKey, v as subtractIntervals, y as unionIntervals } from "./lens-selection-9byzEgvU.js";
-import { D as boardRepositoryId, E as boardLinks, G as selectionReferences, S as anchorPins, X as stepSources, Z as UNCATEGORIZED_LENS_ID, f as sourceBranchName, it as fileLineRangeSchema, j as elements, l as pullRequestKey, p as pullRequestProvider, tt as lensSelections } from "./stored-document-migration-DEt8iwem.js";
+import { _ as scopedCoverage, h as emptyCoverage, i as anchorSelection, l as resolveDiffSelection, m as coverageSources, n as SelectionUnavailableError, o as comparisonKey, s as formatAnchor, u as selectionKey, v as subtractIntervals, y as unionIntervals } from "./lens-selection-EuZdag4Q.js";
+import { D as boardRepositoryId, E as boardLinks, G as selectionReferences, S as anchorPins, X as stepSources, Z as UNCATEGORIZED_LENS_ID, f as sourceBranchName, it as fileLineRangeSchema, j as elements, l as pullRequestKey, p as pullRequestProvider, tt as lensSelections } from "./stored-document-migration-BCFx07Bq.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { A as processStartIdentity, L as writePrivateJsonAtomic, N as devReviewHome, h as TraceConfigurationError, i as isS3MockMode, j as withFileLock } from "./s3-config-CjcLyFV5.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { i as readReviewPackageVersion, n as readBuildCommit, t as findReviewPackageRoot } from "./package-paths-BeYHYjeR.js";
 import "./review-home-paths-CG-sb9Cw.js";
-import { _ as reviewInstanceIdentity, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-DKLIOgg3.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-CO97FUqK.js";
-import { t as openReviewProfile } from "./profile-D9wdlPgw.js";
-import { c as REVIEW_APP_SESSION_ID_HEADER, d as sanitizeUiTelemetryEvent, f as cleanTelemetryText, o as reviewRequestOrigin, r as REVIEW_PERSON_HEADER, s as BUNDLE_FRAME_PATTERN, t as ASK_THREAD_ENV, u as isReportableCleanedMessage } from "./request-origin-CNSLVn7x.js";
-import { a as defaultAskPermissions, i as askAgents, l as launchAskAgent, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-CfSxqzBF.js";
-import { a as inspectQuerySchema, i as renderInstructions, o as queryAnchor, r as instructionsQuerySchema, s as readQuerySchemas, t as authoringTools } from "./authoring-tools-D8EkIDjm.js";
-import { a as headlessServerOwner, c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-DHWHzpo5.js";
+import { _ as reviewInstanceIdentity, n as desktopOwnsHome, o as reviewServerDiscoveryPath, p as desktopUsesHome, r as headlessServerLockPath, t as DESKTOP_TAKEOVER_SIGNAL } from "./server-discovery-BchUrwFW.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-CbLB0jUA.js";
+import { t as openReviewProfile } from "./profile-DS1F6PBF.js";
+import { c as REVIEW_APP_SESSION_ID_HEADER, d as sanitizeUiTelemetryEvent, f as cleanTelemetryText, o as reviewRequestOrigin, r as REVIEW_PERSON_HEADER, s as BUNDLE_FRAME_PATTERN, t as ASK_THREAD_ENV, u as isReportableCleanedMessage } from "./request-origin-BIBW432J.js";
+import { a as defaultAskPermissions, i as askAgents, l as launchAskAgent, n as askAgentSettings, o as detectAskAgents, r as askAgentTakesMcp, t as fuzzyRank } from "./fuzzy-match-BNLXmpbv.js";
+import { a as inspectQuerySchema, i as renderInstructions, o as queryAnchor, r as instructionsQuerySchema, s as readQuerySchemas, t as authoringTools } from "./authoring-tools-DmIJZq0b.js";
+import { a as headlessServerOwner, c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-B1uwDQTr.js";
 import crypto$1, { createHash, randomBytes, randomUUID } from "node:crypto";
 import { z } from "zod";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
@@ -3136,6 +3136,14 @@ function documentText(snapshot, targetId, full = false, relations) {
 				}
 				for (const edge of element.edges) detail(`[${edge.id}] ${edge.from} → ${edge.to}${edge.label ? `: ${edge.label}` : ""}`);
 				break;
+			case "animation":
+				for (const [index, frame] of element.frames.entries()) detail(`Frame ${index + 1} [${frame.key}]: ${frame.title}${frame.caption ? ` — ${frame.caption}` : ""}`);
+				for (const [name, anchor] of Object.entries(element.code)) detail(`Code ${name}: ${anchor}`);
+				if (detailed) code(depth + 1, {
+					language: "html",
+					text: element.html
+				});
+				break;
 			case "software_map": detail(`Map: ${element.mapVersionId}${element.focusElementId ? `, focus: ${element.focusElementId}` : ""}`);
 		}
 	};
@@ -3638,7 +3646,7 @@ const remoteCaller = (context) => context.req.header(REVIEW_CLIENT_HEADER) === R
 function createReviewApi(store, data, open, shared, capabilities = () => ({
 	desktopAvailable: Boolean(open),
 	softwareMapEnabled: false
-}), traceEnabled = async () => false, status = () => ({}), hooks = {}, ask) {
+}), traceEnabled = async () => false, status = () => ({}), hooks = {}, ask, animationsEnabled = () => false) {
 	const app = new Hono();
 	app.onError((error, context) => {
 		if (error instanceof HttpJsonError) return context.json({ error: error.message }, error.statusCode);
@@ -3729,10 +3737,13 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 	};
 	app.get("/", (context) => context.json(catalog()));
 	app.get("/feedback-eligibility", (context) => context.json({ eligible: store.feedbackEligible() }));
-	const instructionContext = async () => ({ traceEnabled: await traceEnabled() });
+	const instructionContext = async () => ({
+		traceEnabled: await traceEnabled(),
+		animationsEnabled: animationsEnabled()
+	});
 	app.get("/authoring", async (context) => {
 		const instructions = await instructionContext();
-		return context.json(authoringTools(instructions.traceEnabled));
+		return context.json(authoringTools(instructions.traceEnabled, instructions.animationsEnabled));
 	});
 	app.get("/instructions", async (context) => {
 		const { topic } = instructionsQuerySchema.parse(context.req.query());
@@ -3786,7 +3797,10 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 		...status(),
 		desktopAvailable: (await capabilities()).desktopAvailable
 	}));
-	app.get("/capabilities", async (context) => context.json(await capabilities()));
+	app.get("/capabilities", async (context) => context.json({
+		...await capabilities(),
+		animationsEnabled: animationsEnabled()
+	}));
 	app.get("/:id/activity", (context) => {
 		const id = context.req.param("id");
 		readReview(id);
@@ -4721,6 +4735,12 @@ function createReviewApi(store, data, open, shared, capabilities = () => ({
 		const register = async (path) => data ? data.register(path) : store.registerRepository(path);
 		const request = withBoardRepository(await locateRepositories(await pullRequestTargets(body, register, (id) => store.read(id)), register), (id) => store.has(id) ? store.read(id) : void 0);
 		const input = commandSchema.parse(request);
+		if (!animationsEnabled() && input.operation.type === "edit") {
+			const { edit, reviewId } = input.operation;
+			const incoming = "content" in edit ? elements([edit.content]) : [];
+			const target = "targetId" in edit ? elements(readReview(reviewId).document).find((element) => element.id === edit.targetId) : void 0;
+			if (incoming.some((element) => element.type === "animation") || target?.type === "animation") throw new ReviewInputError("Animation authoring is disabled. Enable Animations in Settings under Experimental Features to edit animations. Existing animations can still be viewed.", 409);
+		}
 		const command = sharedCommandSchema.safeParse(input);
 		if (command.success && command.data.operation.reviewId?.startsWith("shared-")) {
 			const parsed = commandSchema.parse(input);
@@ -5096,7 +5116,7 @@ function createWhiteboardCore(input) {
 	const api = createReviewApi(store, data, callbacks.open, shared, callbacks.capabilities, () => traceMachineEnabled(), input.status, input.hooks, askThreads && {
 		threads: askThreads,
 		agents: async () => detectAskAgents(await ask?.env)
-	});
+	}, input.animations);
 	if (!shared) mountSharingPublisher(api, store, data);
 	return {
 		app,

package/dist/{lens-selection-9byzEgvU.js → lens-selection-EuZdag4Q.js}

@@ -1,4 +1,4 @@
-import "./src-DYHVzX3b.js";
+import "./src-DEOc8bvC.js";
 import { z } from "zod";
 //#region src/viewed-coverage.ts
 const coverageSchema = z.object({