@dev.fast/whiteboard 0.3.4-preview.20261019.127 → 0.3.4

package/dist/{account-alias-B5-HYi1D.js → account-alias-CprZojXd.js}

@@ -1,10 +1,10 @@
 import { n as isJsonObject } from "./src-X9phtB2j.js";
-import { E as ReviewCliInstallStampSchema } from "./src-BiWNbcF_.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, at as readStoreAuth, n as reviewDesktopStateDir, nt as traceScope, ut as StoreClient } from "./review-home-paths-D8AoCdd2.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-BWxO-UEL.js";
+import { w as ReviewCliInstallStampSchema } from "./src-DsM3jO8G.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-j2BRAaNv.js";
+import { I as writeFileAtomicAsync, L as writePrivateJsonAtomic, N as devReviewHome, j as withFileLock } from "./s3-config-BTO12tCC.js";
+import { i as readReviewPackageVersion } from "./package-paths-C--__jEv.js";
 import { n as isFile, t as isDirectory } from "./fs-utils-BMPLt0cr.js";
-import { c as findExecutable, s as executableCommand } from "./fuzzy-match-BmVJJm9I.js";
+import { c as findExecutable, s as executableCommand } from "./fuzzy-match-BO9bK37N.js";
 import { createHash } from "node:crypto";
 import { constants } from "node:fs";
 import { access, chmod, lstat, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
@@ -1093,9 +1093,9 @@ async function isOwnedShim(shimPath) {
 * (ELECTRON_RUN_AS_NODE) — the exact runtime the server uses. System Node is
 * the last resort and gets a clear version check instead of a cryptic crash.
 */
-async function writePathShim(shimPath, cliPath, runtimePath, devHome, previewHome = devHome) {
+async function writePathShim(shimPath, cliPath, runtimePath, devHome) {
 	if (process.platform === "win32") {
-		await writeFileAtomicAsync(shimPath, windowsCliShim(cliPath, runtimePath ?? process.execPath, devHome === previewHome ? devHome : void 0), { replaceSymlink: true });
+		await writeFileAtomicAsync(shimPath, windowsCliShim(cliPath, runtimePath ?? process.execPath, devHome), { replaceSymlink: true });
 		shimPath = shimPath.replace(/\.cmd$/i, "");
 	}
 	const source = `#!/bin/sh
@@ -1103,8 +1103,6 @@ async function writePathShim(shimPath, cliPath, runtimePath, devHome, previewHom
 FALLBACK_CLI=${shSingleQuote(cliPath)}
 FALLBACK_RUNTIME=${shSingleQuote(runtimePath ?? "")}
 DEFAULT_HOME=${shSingleQuote(devHome)}
-channel="\${DEV_FAST_REVIEW_CHANNEL:-\${DEV_REVIEW_INSTANCE:-}}"
-[ "$channel" = preview ] && DEFAULT_HOME=${shSingleQuote(previewHome)}
 export DEV_REVIEW_HOME="\${DEV_REVIEW_HOME:-$DEFAULT_HOME}"
 DESKTOP="$DEV_REVIEW_HOME/review-desktop"
 
@@ -1205,10 +1203,7 @@ async function installReviewCommand(input) {
 		output: `[skip] kept the existing whiteboard command at ${shimPath}\n`
 	};
 	const shadowingCommand = await resolvePathCommand("whiteboard", shimPath, env);
-	await writePathShim(shimPath, input.cliPath, input.cliRuntimePath, devReviewHome({ DEV_REVIEW_HOME: env.DEV_REVIEW_HOME }, homeDir), devReviewHome({
-		DEV_REVIEW_HOME: env.DEV_REVIEW_HOME,
-		DEV_REVIEW_INSTANCE: "preview"
-	}, homeDir));
+	await writePathShim(shimPath, input.cliPath, input.cliRuntimePath, devReviewHome(env, homeDir));
 	if (await traceMachineEnabled({
 		homeDir,
 		env

package/dist/agent-cli-C6SPSII0.js

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

package/dist/{agent-cli-CohHf6Ua.js → agent-cli-CThN7Q59.js}

@@ -1,12 +1,12 @@
 import { n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { T as traceMachineEnabled } from "./review-home-paths-D8AoCdd2.js";
-import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-Dtc-Kn_w.js";
-import { N as devReviewHome } from "./s3-config-CjcLyFV5.js";
-import { n as readBuildCommit } from "./package-paths-BWxO-UEL.js";
-import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-CKjw3-6h.js";
-import { n as reviewSessionAgent } from "./review-telemetry-BsoRMC2w.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-B9qCPiVB.js";
-import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-DvI-gys2.js";
+import { T as traceMachineEnabled } from "./review-home-paths-j2BRAaNv.js";
+import { a as toolResultText, i as connectReviewInstance, s as ReviewApiError } from "./agent-client-BOOi7EUR.js";
+import { N as devReviewHome } from "./s3-config-BTO12tCC.js";
+import { n as readBuildCommit } from "./package-paths-C--__jEv.js";
+import { b as selectReviewInstance, u as REVIEW_INSTANCE_ENV } from "./server-discovery-Bey8IqXH.js";
+import { n as reviewSessionAgent } from "./review-telemetry-BLNwYnLV.js";
+import { n as REVIEW_VIA_HEADER, t as REVIEW_AGENT_HEADER } from "./request-origin-Zcn_CjX4.js";
+import { i as publicTool, n as RECOVERY, r as callPublicTool, t as toolFailure } from "./tool-failure-C9MpbXJJ.js";
 import { existsSync } from "node:fs";
 import path from "node:path";
 //#region src/review-api/install-update.ts
@@ -36,14 +36,9 @@ async function runReviewAgentCli(input) {
 			return 0;
 		}
 		if (extra.length || mode === "mcp" && name) throw new Error("Unexpected arguments. Use whiteboard api --help.");
-		const thread = env[ASK_THREAD_ENV]?.trim();
-		const headers = Object.fromEntries([
-			[REVIEW_VIA_HEADER, mode === "mcp" ? "mcp" : "api"],
-			[REVIEW_AGENT_HEADER, reviewSessionAgent(env)],
-			[REVIEW_THREAD_HEADER, thread ?? ""]
-		]);
+		const headers = Object.fromEntries([[REVIEW_VIA_HEADER, mode === "mcp" ? "mcp" : "api"], [REVIEW_AGENT_HEADER, reviewSessionAgent(env)]]);
 		if (mode === "mcp") {
-			const { serveReviewMcp } = await import("./mcp-ovmiUE_x.js");
+			const { serveReviewMcp } = await import("./mcp-D1hziANa.js");
 			exitOnInstallUpdate(input.stderr);
 			await serveReviewMcp(async (key, agentKind) => {
 				const connected = await connectReviewInstance(key ? {

package/dist/{agent-client-Dtc-Kn_w.js → agent-client-BOOi7EUR.js}

@@ -1,7 +1,7 @@
 import { d as isBooleanValue, f as isNumberValue, m as isStringValue, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-BiWNbcF_.js";
+import "./src-DsM3jO8G.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-CKjw3-6h.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-Bey8IqXH.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. */
@@ -43,16 +43,6 @@ var ReviewApiClient = class {
 			signal
 		})).json();
 	}
-	/** A command the person gave from the app, not an agent: its version is
-	* credited to them, and a block they hold never stops it. The header is
-	* the one request-origin.ts names. */
-	async personCommand(operation) {
-		return (await this.response("/commands", {
-			method: "POST",
-			headers: { "x-review-person": "1" },
-			body: JSON.stringify({ operation })
-		})).json();
-	}
 	async *watch(subscriptions, signal) {
 		const reader = (await this.response(`/watch?subscriptions=${encodeURIComponent(JSON.stringify(subscriptions))}`, { signal })).body.pipeThrough(new TextDecoderStream()).getReader();
 		const cancel = () => {
@@ -259,7 +249,7 @@ async function connectReviewInstance(env = process.env, headers = {}, options =
 	const selection = await selectReviewInstance({ env });
 	const discovery = healthyReviewInstance(selection);
 	if (!discovery) {
-		const { ensureServerWithoutDesktop } = await import("./background-server-CB9C4uoc.js");
+		const { ensureServerWithoutDesktop } = await import("./background-server-DLSDogkI.js");
 		const server = await ensureServerWithoutDesktop({
 			selection,
 			env,

package/dist/{authoring-tools-B7KU04f7.js → authoring-tools-BNwuMnz6.js}

@@ -1,8 +1,7 @@
-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-Cpl4ENbJ.js";
-import { C as pathTargetSchema, D as publishedEditSchema } from "./stored-document-migration-dFbewRTG.js";
+import { c as activityEndSchema, i as commandSchema, l as activityUpdateSchema, n as uploadSchema, s as activityBeginSchema } from "./local-data-D_9tvdsp.js";
+import { S as publishedEditSchema, y as pathTargetSchema } from "./stored-document-migration-CChxtFAy.js";
 import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
-import { t as findReviewPackageRoot } from "./package-paths-BWxO-UEL.js";
+import { t as findReviewPackageRoot } from "./package-paths-C--__jEv.js";
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
@@ -103,8 +102,12 @@ const COMPONENT_REFERENCE = [
 const instructionsQuerySchema = z.strictObject({ topic: z.enum([
 	"authoring",
 	"file-lenses",
+	"scratchpad",
 	"trace-archaeology"
 ]).default("authoring") });
+function scratchpadAvailable(context) {
+	return context.desktopAvailable && context.scratchpadEnabled;
+}
 const cache = /* @__PURE__ */ new Map();
 function read(root, name) {
 	const file = path.join(root, "instructions", `${name}.md`);
@@ -119,9 +122,11 @@ function read(root, name) {
 	return content;
 }
 async function renderInstructions(topic, context, root = findReviewPackageRoot(import.meta.url)) {
+	if (topic === "scratchpad" && !scratchpadAvailable(context)) return "The Whiteboard scratchpad is turned off or Whiteboard Desktop is not running. Answer in chat; the scratchpad can be turned on in Whiteboard Desktop Settings.";
 	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 === "scratchpad") return `${await read(root, topic)}\n\n${COMPONENT_REFERENCE}`;
 	if (topic !== "authoring") return read(root, topic);
-	const more = [...context.traceEnabled ? ["- Why code exists / past agent sessions: `session_get_instructions({topic:\"trace-archaeology\"})`"] : []];
+	const more = [...scratchpadAvailable(context) ? ["- Explaining code visually outside a review: `session_get_instructions({topic:\"scratchpad\"})`"] : [], ...context.traceEnabled ? ["- Why code exists / past agent sessions: `session_get_instructions({topic:\"trace-archaeology\"})`"] : []];
 	return [
 		await read(root, "authoring"),
 		COMPONENT_REFERENCE,
@@ -148,7 +153,7 @@ const REVIEW_STATUS_TOOL = {
 /** The host publishes its input schemas, except where agents write less than
 * the host accepts (publishedEditSchema, publishedLensEditSchema) or name a
 * checkout by path (pathTargetSchema); adapters validate nothing. */
-function authoringTools(traceEnabled = false) {
+function authoringTools(scratchpadAvailable = false, traceEnabled = false) {
 	const id = z.string().min(1);
 	const review = { reviewId: id };
 	const [image, trace] = uploadSchema.options;
@@ -156,19 +161,19 @@ function authoringTools(traceEnabled = false) {
 		...image.shape,
 		...trace.shape,
 		kind: z.enum(["image", "trace"])
-	}).omit({ repositoryId: true }).extend({ repositoryPath: id }).partial().required({
+	}).partial().required({
 		id: true,
-		repositoryPath: true,
+		repositoryId: true,
 		kind: true
 	});
 	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; Desktop links whiteboards into a stack through their bases. 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.",
-		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.",
+		create: "Create a review of saved working files, immutable commits or a GitHub PR. Revisions are resolved on acceptance. A worktree target reviews the saved files in its checkout, uncommitted ones included and untracked ones left out (git add -N a new file to include it), against base: the branch to compare against, by default the default branch of the repository. The diff starts at the merge base of base and HEAD, which follows rebases. Omitted commits base means source at head with no diff; supply the parent to review introduced changes. For a branch stacked on another, pass the branch below it as base; Desktop links reviews into a stack through their bases. For a GitHub PR, pullRequestUrl alone is enough: target and title become optional, and the host fetches the PR into a registered checkout of its repository and pins the current PR head and GitHub diff base, titled from the PR. 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. kind:\"scratchpad\" names the one scratchpad, which the host creates itself. The result carries review, the review as review_list shows it: its target with resolved commits, origin (its PR), repositoryName 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.",
+		set_target: "Move the review to a new target, such as the commits after a rebase or amend, preserving the document and component IDs. 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. Omitted pullRequestUrl keeps the PR within the same repository; changing repositories clears it. Supply a URL to replace it or null to detach.",
 		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.",
-			"insert adds content: parentId nests it, afterId places it, and omitted placement appends. update patches a component's own fields; null removes an optional one. A section's children and a diagram's units change through their own IDs; a call stack's frames change by replacing the call stack. move and remove take a targetId; removing a flow_node removes its edges.",
-			"The host assigns short durable IDs. The result names the edited component and, for an insert or replace, its first-level children, and quotes the first and last line of each anchor the edit added or changed (the first 20; unquotedAnchors counts the rest): check they are the lines you meant. Accepted edits save at once. An edit to a block the user is editing is refused with an error: edit another block, or retry later.",
+			"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 (authoring or scratchpad).",
+			"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 {repositoryId, head, base?} say which commits anchors quote: a step, frame, attachment or operation without pins uses its block's, and a block without them the review's.",
+			"insert adds content: parentId nests it, afterId places it, and omitted placement appends (on the scratchpad, it lands at the top). update patches a component's own fields; null removes an optional one. A section's children and a diagram's units change through their own IDs; a call stack's frames change by replacing the call stack. move and remove take a targetId; removing a flow_node removes its edges.",
+			"The host assigns short durable IDs. The result names the edited component and, for an insert or replace, its first-level children, and quotes the first and last line of each anchor the edit added or changed (the first 20; unquotedAnchors counts the rest): check they are the lines you meant. Accepted edits save at once.",
 			"While a reader may be watching, write small and often: one paragraph per edit. Insert a new diagram whole. Change one already drawn a unit at a time (a flow_node, flow_edge or step, with parentId naming the diagram), and link each added flow_node to a node already drawn."
 		].join("\n"),
 		lens_edit: "Edit one Diff-view lens. Lenses partition the review's change for the Diff view; they sit beside the document (never in it) and version with it. The host assigns durable lens IDs; updates replace only the fields supplied. Write one lens per call while a reader may be watching; each draws in on the Diffs page. Pass your activityId so your courier draws each lens. The result identifies the lens and reports uncategorized: changed lines no lens selects yet, grouped by file. Keep adding lenses until it is empty or what remains is deliberate. review_lens_get reads the current lenses and gaps.",
@@ -176,15 +181,13 @@ function authoringTools(traceEnabled = false) {
 		restore: "Restore title, source pins, PR identity and content from a saved version.",
 		attention: "Mark an active review viewed without changing its content or lifecycle. Restore a review from Trash before marking it viewed.",
 		lifecycle: "Move a review between active and trash. Trash retains the review for 30 days before automatic deletion. Moving it back to active restores it; moving it to trash again does not restart that period.",
-		delete: "Permanently delete a review and its history. The review must be in Trash. This cannot be undone. Its children move up to top level, and dependencies on it are dropped.",
-		set_parent: "Nest the review under another review of the same project, or make it top-level with parentId:null. Nesting is one level deep: the parent must be top-level, and a review with children can't become a child. The sidebar shows children under their parent. Saves no review version. Returns the review's relations: parentId, children in sibling order, and dependsOn.",
-		set_dependencies: "Replace the list of reviews this one builds on: any reviews of the same project. Siblings list after what they depend on, directly or through other reviews; a PR stack is a chain. A list that would close a cycle is refused, naming the cycle. Saves no review version. Returns the review's relations."
+		delete: "Permanently delete a review and its history. The review must be in Trash. This cannot be undone."
 	};
 	const tool = (name, description, schema, method, path, commandType) => ({
 		name: `review_${name === "restore" ? "restore_version" : name}`,
 		description,
 		inputSchema: {
-			...withoutRepositoryIds(z.toJSONSchema(schema, { io: "input" })),
+			...z.toJSONSchema(schema, { io: "input" }),
 			type: "object"
 		},
 		method,
@@ -194,17 +197,18 @@ 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." : "") + (scratchpadAvailable ? " When the user asks in conversation to be shown how code works or wants a diagram, without asking for a review, draw it on the scratchpad rather than answering only in chat: call review_get_instructions({topic:\"scratchpad\"}) first. A request for a review or to use Whiteboard means authoring a review with the default topic." : ""), instructionsQuerySchema.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"),
 		...commandSchema.shape.operation.options.map((operation) => {
 			const type = operation.shape.type.value;
-			const { type: _type, repositoryId: _repositoryId, pullRequestUrl: _pullRequestUrl, ...fields } = operation.shape;
+			const { type: _type, repositoryId: _repositoryId, ...fields } = operation.shape;
 			return tool(type, descriptions[type], z.strictObject({
 				...fields,
 				...type === "create" && {
-					target: pathTargetSchema,
+					target: pathTargetSchema.optional(),
+					repositoryPath: id.optional().describe("Only with pullRequestUrl and no target: the local checkout to fetch the PR into. Default: the existing review's, else the first registered checkout with a remote for the PR's repository."),
 					open: z.boolean().optional()
 				},
 				...type === "set_target" && { target: pathTargetSchema },
@@ -224,20 +228,9 @@ function authoringTools(traceEnabled = false) {
 			retry: z.boolean().optional()
 		}), "POST", "/:reviewId/environment"),
 		tool("workspace_cleanup", "Inspect failed cleanup of retired review-owned checkouts. Supply workspaceId to retry removal of that checkout. This does not remove active review checkouts.", z.strictObject({ workspaceId: id.optional() }), "POST", "/workspace-cleanup"),
+		tool("register_repository", "Register a local Git or jj repository and return its id, for pins on scratchpad blocks. session_create and session_set_target take the checkout's path instead.", z.strictObject({ path: id }), "POST", "/repositories"),
 		tool("upload", "Retain an image or trace for use in a review. kind:\"image\" takes base64; kind:\"trace\" takes trace. Reusing an upload ID requires identical content; rejected uploads are not saved.", uploadInput, "POST", "/resources")
 	];
 }
-/** Drops repositoryId from pins: the host fills in the board's own. */
-function withoutRepositoryIds(schema) {
-	return JSON.parse(JSON.stringify(schema), (_key, value) => {
-		if (!isJsonObject(value) || !isJsonObject(value.properties) || !("repositoryId" in value.properties) || !("head" in value.properties)) return value;
-		const { repositoryId: _repositoryId, ...properties } = value.properties;
-		return {
-			...value,
-			properties,
-			...Array.isArray(value.required) && { required: value.required.filter((name) => name !== "repositoryId") }
-		};
-	});
-}
 //#endregion
-export { inspectQuerySchema as a, renderInstructions as i, REVIEW_STATUS_TOOL as n, queryAnchor as o, instructionsQuerySchema as r, readQuerySchemas as s, authoringTools as t };
+export { scratchpadAvailable as a, readQuerySchemas as c, renderInstructions as i, REVIEW_STATUS_TOOL as n, inspectQuerySchema as o, instructionsQuerySchema as r, queryAnchor as s, authoringTools as t };

package/dist/{background-server-C03RKxKS.js → background-server-CkvxA-6O.js}

@@ -1,8 +1,8 @@
-import "./review-home-paths-D8AoCdd2.js";
-import { D as liveLockOwner, k as processIsAlive } from "./s3-config-CjcLyFV5.js";
-import { t as findReviewPackageRoot } from "./package-paths-BWxO-UEL.js";
-import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-CKjw3-6h.js";
-import { t as desktopApplicationInstalled } from "./review-app-launcher-C7el2Uoy.js";
+import "./review-home-paths-j2BRAaNv.js";
+import { D as liveLockOwner, k as processIsAlive } from "./s3-config-BTO12tCC.js";
+import { t as findReviewPackageRoot } from "./package-paths-C--__jEv.js";
+import { a as readReviewServerHealth, c as reviewServerStateDir, i as readReviewServerDiscovery, n as desktopOwnsHome, p as desktopUsesHome, r as headlessServerLockPath } from "./server-discovery-Bey8IqXH.js";
+import { t as desktopApplicationInstalled } from "./review-app-launcher-CkwLclzR.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-CB9C4uoc.js → background-server-DLSDogkI.js}

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

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"0.3.4-preview.20261019.127","commit":"5dd55db92af13eac9187d16cf07b4bd80c456724","dirty":true,"builtAt":"2026-10-19T21:53:33.950Z"}
+{"version":"0.3.4","commit":"f33bd6620742fe65ccc1d5fef416fbe8254dcf79","dirty":true,"builtAt":"2026-10-20T15:23:18.478Z"}

package/dist/{cli-CJaEb7zC.js → cli-R4yfa5DT.js}

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

package/dist/{cli-runner-DGDIqh3V.js → cli-runner-Cuc9FSzu.js}

@@ -1,18 +1,18 @@
-import { A as __require, O as setLocalVcsCommandObserver, j as __toESM, k as __commonJSMin } from "./src-WPaQn75m.js";
+import { C as setLocalVcsCommandObserver, E as __toESM, T as __require, w as __commonJSMin } from "./src-BMPuxWv4.js";
 import { c as jsonString, n as isJsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import { b as REVIEW_REMOTE_ATTACH_BEGIN, h as REVIEW_CLI_INSTALL_TARGET_LABELS, l as boardTitle, x as REVIEW_REMOTE_ATTACH_END, y as REVIEW_REMOTE_AGENT_IDS } from "./src-BiWNbcF_.js";
-import { $ as resolveTraceCommand, A as runTraceDeny, E as traceMachineStatus, F as describeSelection, H as resolveTraceRepositoryTarget, J as HOSTED_CAPTURE_SCOPE_DESCRIPTION, K as traceRepositoryStatus, L as loadS3TraceStorage, M as runTraceSessions, N as runTraceStoreDelete, P as runTraceStoreInfo, T as traceMachineEnabled, V as requireTraceConsent, _ as runTraceRepair, at as readStoreAuth, b as runTraceGitHook, c as registerTraceCommands, ct as runStoreWhoami, d as runTraceList$1, dt as withStoreAuthorization, f as runTracePull$1, ft as emitJsonEvent, g as runTraceInstallMachine, h as runTraceEnable, ht as jsonRequestedInArgv, j as runTraceOnboard, k as runTraceAllow, l as resolveTraceReadStorage, lt as StoreApiError, m as runTraceDisable, mt as humanStream, nt as traceScope, ot as runStoreLogin, p as runTraceShow, pt as failWithJsonError, q as readTraceUserConfig, rt as DEFAULT_STORE_ORIGIN, st as runStoreLogout, tt as traceHomeDir, u as runTraceBlame, ut as StoreClient, v as runTraceStatus, w as readLegacyCaptureSettings, x as runTraceHook, y as runTraceSync, z as selectTraceStorage } from "./review-home-paths-D8AoCdd2.js";
-import { o as ReviewApiClient, s as ReviewApiError } from "./agent-client-Dtc-Kn_w.js";
-import { t as resolveReviewRoot } from "./runtime-Bj2tD33R.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 { _ as REVIEW_REMOTE_AGENT_IDS, p as REVIEW_CLI_INSTALL_TARGET_LABELS, v as REVIEW_REMOTE_ATTACH_BEGIN, y as REVIEW_REMOTE_ATTACH_END } from "./src-DsM3jO8G.js";
+import { $ as resolveTraceCommand, A as runTraceDeny, E as traceMachineStatus, F as describeSelection, H as resolveTraceRepositoryTarget, J as HOSTED_CAPTURE_SCOPE_DESCRIPTION, K as traceRepositoryStatus, L as loadS3TraceStorage, M as runTraceSessions, N as runTraceStoreDelete, P as runTraceStoreInfo, T as traceMachineEnabled, V as requireTraceConsent, _ as runTraceRepair, b as runTraceGitHook, c as registerTraceCommands, ct as runStoreLogout, d as runTraceList$1, dt as StoreClient, f as runTracePull$1, ft as withStoreAuthorization, g as runTraceInstallMachine, gt as jsonRequestedInArgv, h as runTraceEnable, ht as humanStream, j as runTraceOnboard, k as runTraceAllow, l as resolveTraceReadStorage, lt as runStoreWhoami, m as runTraceDisable, mt as failWithJsonError, nt as traceScope, ot as readStoreAuth, p as runTraceShow, pt as emitJsonEvent, q as readTraceUserConfig, rt as DEFAULT_STORE_ORIGIN, st as runStoreLogin, tt as traceHomeDir, u as runTraceBlame, ut as StoreApiError, v as runTraceStatus, w as readLegacyCaptureSettings, x as runTraceHook, y as runTraceSync, z as selectTraceStorage } from "./review-home-paths-j2BRAaNv.js";
+import { o as ReviewApiClient, s as ReviewApiError } from "./agent-client-BOOi7EUR.js";
+import { t as resolveReviewRoot } from "./runtime-CKiWhGrf.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-BTO12tCC.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
-import { i as readReviewPackageVersion, r as readBuildInfo, t as findReviewPackageRoot } from "./package-paths-BWxO-UEL.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-CKjw3-6h.js";
-import { t as ReviewTelemetry } from "./review-telemetry-BsoRMC2w.js";
-import { t as fuzzyRank } from "./fuzzy-match-BmVJJm9I.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-B5-HYi1D.js";
-import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-C7el2Uoy.js";
-import { t as reviewAgentCliHelp } from "./agent-cli-CohHf6Ua.js";
+import { i as readReviewPackageVersion, r as readBuildInfo, t as findReviewPackageRoot } from "./package-paths-C--__jEv.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-Bey8IqXH.js";
+import { t as ReviewTelemetry } from "./review-telemetry-BLNwYnLV.js";
+import { t as fuzzyRank } from "./fuzzy-match-BO9bK37N.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-CprZojXd.js";
+import { n as focusReviewDesktop, r as runReviewAppLaunch } from "./review-app-launcher-CkwLclzR.js";
+import { t as reviewAgentCliHelp } from "./agent-cli-CThN7Q59.js";
 import { existsSync, mkdirSync, renameSync, writeFileSync } from "node:fs";
 import { realpath } from "node:fs/promises";
 import path from "node:path";
@@ -3898,8 +3898,8 @@ function resolveTraceFile(env) {
 }
 if (traceEnabled) {
 	process.on("exit", flushTrace);
-	setLocalVcsCommandObserver({ start({ tool, args, cwd }) {
-		const handle = startSpan(commandSpanName(tool, args), { detail: commandDetail(tool, args, cwd) });
+	setLocalVcsCommandObserver({ start({ file, args, cwd }) {
+		const handle = startSpan(commandSpanName(file, args), { detail: commandDetail(file, args, cwd) });
 		return ({ ok }) => ok ? handle.end() : handle.fail();
 	} });
 }
@@ -4297,7 +4297,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-CB9C4uoc.js");
+			const { ensureBackgroundServer } = await import("./background-server-DLSDogkI.js");
 			const { discovery, started } = await ensureBackgroundServer({
 				stateDir,
 				env,
@@ -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-DRtjf9WA.js");
+		const { HeadlessServerBusyError, runHeadlessServer } = await import("./headless-host-CVBOQyRS.js");
 		try {
 			await runHeadlessServer({
 				stateDir,
@@ -4356,7 +4356,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-CB9C4uoc.js");
+		const { headlessServerOwner, stopBackgroundServer } = await import("./background-server-DLSDogkI.js");
 		const owner = await headlessServerOwner(stateDir);
 		const discovery = await readReviewServerDiscovery(stateDir);
 		if (owner === void 0) {
@@ -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-DJvkBJNQ.js"), import("./headless-host-DRtjf9WA.js")]);
+		const [{ openReviewProfile }, { withHeadlessServerLock }] = await Promise.all([import("./profile-CYPmvBoA.js"), import("./headless-host-CVBOQyRS.js")]);
 		const reset = await withHeadlessServerLock(await realpath(stateDir), async () => {
 			const local = await openReviewProfile(stateDir, { manageWorkspaces: false });
 			try {
@@ -4406,7 +4406,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-Dd-YobM6.js");
+		const { remoteAttach } = await import("./remote-attach-CEJ-kvDY.js");
 		let attach;
 		try {
 			attach = await remoteAttach({
@@ -4433,7 +4433,7 @@ async function runReviewCli(input) {
 	});
 	configureJsonOutput(remote.command("extensions").description("Language extensions for the language server on a remote").command("ensure").description("Download the curated extensions for this machine and list them for the language server").option("--groups <groups>", "comma-separated optional extension groups the Desktop has enabled, such as go"), "plain").action(async (_options, command) => {
 		const { json, groups } = command.optsWithGlobals();
-		const { ensureRemoteExtensions } = await import("./remote-extensions-VP-kfq0C.js");
+		const { ensureRemoteExtensions } = await import("./remote-extensions-GN8Gf_qG.js");
 		const result = await ensureRemoteExtensions({
 			env,
 			groups: groups?.split(",").map((group) => group.trim())
@@ -4448,7 +4448,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-DuOzsvaD.js");
+		const { remoteUninstall } = await import("./remote-uninstall-DW7Gdryh.js");
 		let deleteReviews = options.deleteReviews ? true : options.keepReviews ? false : void 0;
 		if (deleteReviews === void 0 && !options.json && input.stdin?.isTTY) {
 			const prompt = createInterface$1({
@@ -4522,7 +4522,7 @@ async function runReviewCli(input) {
 	const writeAppEvent = (event, options) => {
 		if (options.json) input.stdout.write(`${JSON.stringify(event)}\n`);
 		else if (event.action === "launch") input.stdout.write(event.state === "running" ? "Whiteboard Desktop is already running.\n" : options.focus ? "Whiteboard Desktop is ready.\n" : "Whiteboard Desktop is ready in the background. Pass --focus to bring it forward.\n");
-		else input.stdout.write(`Whiteboard Desktop is showing "${boardTitle(event.title)}".\n`);
+		else input.stdout.write(`Whiteboard Desktop is showing "${event.title}".\n`);
 	};
 	const pickReview = async (options) => {
 		const event = await runtime.runReviewAppPick({
@@ -4670,14 +4670,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-CJaEb7zC.js");
+		const { runShareCli } = await import("./cli-R4yfa5DT.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-CJaEb7zC.js");
+		const { runShareCli } = await import("./cli-R4yfa5DT.js");
 		state.exitCode = await runShareCli({
 			...input,
 			...options,
@@ -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-_YyMIMRY.js");
+		const { runReviewAgentCli } = await import("./agent-cli-C6SPSII0.js");
 		state.exitCode = await runReviewAgentCli({
 			...input,
 			env: authoringEnv(),

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-BiWNbcF_.js";
+import "./src-DsM3jO8G.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-DGDIqh3V.js");
+	const { runReviewCli } = await import("./cli-runner-Cuc9FSzu.js");
 	return runReviewCli({
 		argv,
 		cliPaths: {
@@ -45,8 +45,7 @@ async function maybeDelegateToDesktopCli(argv) {
 	].includes(argument) || /^--state-dir(?:=|$)/.test(argument)) || env.DEV_REVIEW_SERVER_DIR?.trim()) return null;
 	const ownPath = fileURLToPath(import.meta.url);
 	if (!/[\\/]dist[\\/]cli\.js$/.test(ownPath)) return null;
-	const channel = env.DEV_FAST_REVIEW_CHANNEL?.trim() || env.DEV_REVIEW_INSTANCE?.trim();
-	const devHome = env.DEV_REVIEW_HOME?.trim() ? path.resolve(env.DEV_REVIEW_HOME.trim()) : path.join(os.homedir(), channel === "preview" ? ".dev-preview" : ".dev");
+	const devHome = env.DEV_REVIEW_HOME?.trim() ? path.resolve(env.DEV_REVIEW_HOME.trim()) : path.join(os.homedir(), ".dev");
 	let cliPath;
 	let runtimePath;
 	const discoveryFile = selectedDiscoveryFile(devHome, env);