@dev.fast/whiteboard 0.2.5-preview.20261013.113 → 0.2.5-preview.20261015.115

package/dist/{desktop-discovery-Ba3dD5Cn.js → server-discovery-CifQ3yQS.js}

@@ -1,6 +1,8 @@
 import { a as jsonNumber, n as isJsonObject, s as jsonProperty, u as parseJsonText } from "./src-X9phtB2j.js";
-import { n as parseReviewDesktopDiscovery } from "./src-WCbabvdS.js";
-import { a as reviewInstancesDir, o as reviewLegacyDiscoveryPath, r as reviewDevInstanceKey, t as reviewDefaultInstancePath } from "./review-home-paths-Y9mYWkCI.js";
+import { n as parseReviewDesktopDiscovery } from "./src-Bgvf1sEN.js";
+import { a as reviewInstancesDir, o as reviewLegacyDiscoveryPath, r as reviewDevInstanceKey, t as reviewDefaultInstancePath } from "./review-home-paths-zwevIq4I.js";
+import { M as devReviewHome, O as processIsAlive, j as DEV_REVIEW_HOME_ENV } from "./s3-config-DDWWMh5x.js";
+import { z } from "zod";
 import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
 //#region src/desktop-discovery.ts
@@ -84,6 +86,17 @@ function reviewInstanceIdentity(env) {
 	if (appVersion) identity.appVersion = appVersion;
 	return identity;
 }
+/** Any live Desktop holds the store, attached window or not. Only a gone
+* process counts as stopped: a paused or busy one may not answer /health. */
+async function desktopUsesHome(home, env = process.env) {
+	const desktops = await readReviewInstances({ env: {
+		...env,
+		[DEV_REVIEW_HOME_ENV]: home
+	} });
+	const [problem] = desktops.broken.values();
+	if (problem) throw new Error(`Cannot tell whether a Whiteboard Desktop is using ${home}: ${problem.message}`);
+	return desktops.instances.some(({ discovery }) => [discovery.appPid, discovery.serverPid].some((pid) => processIsAlive(pid)));
+}
 /** Records by key, plus the files that could not be read, by key. */
 async function readReviewInstances(dependencies) {
 	const env = dependencies.env ?? process.env;
@@ -161,4 +174,76 @@ function reviewInstanceStartHint(selection) {
 	return checkout ? `Start it with \`pnpm dev\` in ${checkout}` : "Start it with `pnpm dev` in its checkout";
 }
 //#endregion
-export { readDefaultReviewInstance as a, reviewInstanceIdentity as c, selectReviewInstance as d, writeDefaultReviewInstance as f, healthyReviewInstance as i, reviewInstanceStartHint as l, ReviewInstanceUnavailableError as n, readReviewInstances as o, clearDefaultReviewInstance as r, requireHealthyReviewDesktop as s, REVIEW_INSTANCE_ENV as t, reviewInstanceUnavailable as u };
+//#region src/server-discovery.ts
+const discoverySchema = z.object({
+	version: z.literal(1),
+	instanceId: z.uuid(),
+	url: z.url().refine((value) => {
+		const url = new URL(value);
+		return url.protocol === "http:" && url.hostname === "127.0.0.1";
+	}),
+	serverPid: z.number().int().positive(),
+	token: z.string().min(1),
+	startedBy: z.enum([
+		"user",
+		"cli",
+		"desktop"
+	]).default("user")
+});
+function reviewServerStateDir(env = process.env) {
+	return env.DEV_REVIEW_SERVER_DIR?.trim() ? path.resolve(env.DEV_REVIEW_SERVER_DIR.trim()) : devReviewHome(env);
+}
+function reviewServerDiscoveryPath(stateDir) {
+	return path.join(stateDir, "review-server", "server.json");
+}
+/** Sent by a Desktop taking over the server's state directory. */
+const DESKTOP_TAKEOVER_SIGNAL = "SIGUSR2";
+function headlessServerLockPath(stateDir) {
+	return path.join(stateDir, "headless-server.lock");
+}
+async function readReviewServerDiscovery(stateDir) {
+	let source;
+	try {
+		source = await readFile(reviewServerDiscoveryPath(stateDir), "utf8");
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
+		throw error;
+	}
+	try {
+		return discoverySchema.parse(JSON.parse(source));
+	} catch {
+		throw new Error(`Whiteboard server discovery in ${stateDir} is invalid or incompatible. Restart it with this version of whiteboard server start.`);
+	}
+}
+async function reviewServerIsHealthy(discovery) {
+	return await readReviewServerHealth(discovery) !== null;
+}
+/** The recorded server's /health, or null when another or none answers. */
+async function readReviewServerHealth(discovery) {
+	try {
+		const response = await fetch(`${discovery.url}/health`, {
+			headers: { "x-review-token": discovery.token },
+			signal: AbortSignal.timeout(1500)
+		});
+		if (!response.ok) return null;
+		const health = z.object({
+			ok: z.literal(true),
+			instanceId: z.string(),
+			serverId: z.string().optional(),
+			serverPid: z.number().optional(),
+			version: z.string().optional(),
+			commit: z.string().nullable().optional()
+		}).safeParse(await response.json());
+		return health.success && health.data.instanceId === discovery.instanceId ? health.data : null;
+	} catch {
+		return null;
+	}
+}
+function desktopOwnsHome(stateDir) {
+	return `Whiteboard Desktop is serving ${stateDir}, so no other Whiteboard server can start there. Quit Desktop, or choose another --state-dir.`;
+}
+function serverNotReady(stateDir) {
+	return /* @__PURE__ */ new Error(`Whiteboard server is not ready in ${stateDir}. Run whiteboard server start --state-dir ${JSON.stringify(stateDir)}, then retry.`);
+}
+//#endregion
+export { reviewInstanceIdentity as _, readReviewServerHealth as a, selectReviewInstance as b, reviewServerStateDir as c, ReviewInstanceUnavailableError as d, clearDefaultReviewInstance as f, requireHealthyReviewDesktop as g, readDefaultReviewInstance as h, readReviewServerDiscovery as i, serverNotReady as l, healthyReviewInstance as m, desktopOwnsHome as n, reviewServerDiscoveryPath as o, desktopUsesHome as p, headlessServerLockPath as r, reviewServerIsHealthy as s, DESKTOP_TAKEOVER_SIGNAL as t, REVIEW_INSTANCE_ENV as u, reviewInstanceStartHint as v, writeDefaultReviewInstance as x, reviewInstanceUnavailable as y };

package/dist/sharing/index.d.ts

@@ -242,8 +242,10 @@ interface ReviewApiSummary {
   origin?: {
     branch?: string;
     baseRef?: string;
+    baseBranch?: string;
     pullRequestNumber?: number;
     pullRequestUrl?: string;
+    pullRequestTitle?: string;
     revision?: string;
   };
   /** Shared imports have separate local checkouts but retain their remote identity. */
@@ -266,6 +268,13 @@ interface ReviewApiSummary {
   trashedAt: string | null;
   /** An agent holds a live lease; absent on shared reviews. */
   working?: boolean;
+  host?: string;
+  hostState?: Exclude<ReviewGatewayHostState["state"], "duplicate">;
+  available?: {
+    sourceWindows: boolean;
+    /** Why they are off: the host's sentence, or its language features detail. */
+    reason?: string;
+  };
 }
 interface ReviewSourceEntry {
   path: string;
@@ -281,6 +290,57 @@ interface ReviewLanguageEnvironment {
   /** Present only when the language checkout is unavailable, not while preparing. */
   readonly issue?: string;
 }
+declare const ReviewGatewayHostSchema: z.ZodObject<{
+  alias: z.ZodString;
+  endpoint: z.ZodOptional<z.ZodObject<{
+    url: z.ZodString;
+    token: z.ZodString;
+  }, z.core.$strict>>;
+  problem: z.ZodOptional<z.ZodObject<{
+    state: z.ZodEnum<{
+      unreachable: "unreachable";
+      "not-installed": "not-installed";
+      "auth-failed": "auth-failed";
+      unsupported: "unsupported";
+      incompatible: "incompatible";
+    }>;
+    detail: z.ZodString;
+  }, z.core.$strict>>;
+  declined: z.ZodOptional<z.ZodLiteral<true>>;
+  asking: z.ZodOptional<z.ZodString>;
+  installFailure: z.ZodOptional<z.ZodString>;
+  target: z.ZodOptional<z.ZodEnum<{
+    "linux-x64": "linux-x64";
+    "linux-arm64": "linux-arm64";
+  }>>;
+  installing: z.ZodOptional<z.ZodObject<{
+    step: z.ZodEnum<{
+      preparing: "preparing";
+      "waiting-for-lock": "waiting-for-lock";
+      package: "package";
+      done: "done";
+    }>;
+  }, z.core.$strict>>;
+  languageFeatures: z.ZodOptional<z.ZodBoolean>;
+  languageFeaturesDetail: z.ZodOptional<z.ZodString>;
+  languageGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    group: z.ZodString;
+    installed: z.ZodBoolean;
+    detail: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+type ReviewGatewayHost = z.infer<typeof ReviewGatewayHostSchema>;
+interface ReviewGatewayHostState {
+  alias: string;
+  serverId?: string;
+  state: "connecting" | "online" | "offline" | "incompatible" | "duplicate" | "unreachable" | "not-installed" | "auth-failed" | "unsupported" | "installing";
+  detail?: string;
+  installCommand?: string;
+  languageFeatures?: boolean;
+  languageFeaturesDetail?: string;
+  languageGroups?: ReviewGatewayHost["languageGroups"];
+  declined?: true;
+}
 //#endregion
 //#region src/source.d.ts
 /** The repository and commits one source reference was read from. A
@@ -425,19 +485,6 @@ interface SectionBlock {
   children: Block[];
 }
 //#endregion
-//#region src/review-api/blocks/tutorial.d.ts
-type TutorialContent = {
-  kind: "keymap";
-} | {
-  kind: "view";
-  view: "diff";
-  label: string;
-};
-type TutorialBlock = {
-  id?: string;
-  type: "tutorial";
-} & TutorialContent;
-//#endregion
 //#region src/review-api/blocks/index.d.ts
 /** Leaf kinds share one discriminated union so unknown types read as they always have. */
 declare const leafSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -635,7 +682,7 @@ declare const leafSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   pins: any;
 }, z.core.$strict>], "type">;
 type LeafBlock = z.infer<typeof leafSchema>;
-type Block = LeafBlock | SectionBlock | CalloutBlock | TutorialBlock;
+type Block = LeafBlock | SectionBlock | CalloutBlock;
 //#endregion
 //#region src/review-api/diff-lenses.d.ts
 declare const lensSchema: z.ZodObject<{
@@ -891,17 +938,7 @@ declare const editSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       danger: "danger";
     }>>;
     children: z.ZodArray<z.ZodLazy<z.ZodType<Block, unknown, z.core.$ZodTypeInternals<Block, unknown>>>>;
-  }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"tutorial">;
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"keymap">;
   }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"tutorial">;
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"view">;
-    view: z.ZodLiteral<"diff">;
-    label: z.ZodString;
-  }, z.core.$strict>], "kind">, z.ZodObject<{
     type: z.ZodDefault<z.ZodLiteral<"step">>;
     from: z.ZodString;
     to: z.ZodString;
@@ -1171,6 +1208,14 @@ declare const askOfferSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type AskOffer = z.infer<typeof askOfferSchema>;
+/** What an agent may do without asking: nothing that changes the checkout,
+ * what its own judgment calls safe, or everything. */
+declare const askPermissionsSchema: z.ZodEnum<{
+  "read-only": "read-only";
+  auto: "auto";
+  bypass: "bypass";
+}>;
+type AskPermissions = z.infer<typeof askPermissionsSchema>;
 type AskEntry = z.infer<typeof askEntrySchema>;
 /** A saved conversation, as the history list shows it. The transcript stays
  * with the agent; Whiteboard keeps what it needs to find and reopen it. */
@@ -1206,8 +1251,8 @@ declare class AskHistory {
   private assertWritable;
   private assertThreadWritable;
   save(record: AskRecord): void;
-  /** Whether reopening the conversation bypasses permissions. */
-  setBypass(id: string, bypass: boolean): void;
+  /** What the agent may do without asking when the conversation reopens. */
+  setPermissions(id: string, permissions: AskPermissions): void;
   /** Points a conversation at a new session, when its agent could not
    * reopen the one it had. */
   updateSession(id: string, sessionId: string): void;
@@ -1232,12 +1277,14 @@ declare class AskHistory {
 //#region src/review-api/store.d.ts
 /** Source identity displayed in the review header and Home, alongside immutable pins. */
 interface SnapshotOrigin {
-  /** Managed tutorial; readable by ID but excluded from the user catalog. */
-  tutorial?: boolean;
   branch?: string;
   baseRef?: string;
+  /** The base the review's target names, such as the branch below it. */
+  baseBranch?: string;
   pullRequestNumber?: number;
   pullRequestUrl?: string;
+  /** As the forge reported it when the PR was attached. */
+  pullRequestTitle?: string;
   /** The legacy review revision this version was imported from. */
   revision?: string;
 }
@@ -1299,6 +1346,7 @@ interface Result {
 interface ResolvedPullRequest {
   target: ReviewTarget;
   pins: Pins;
+  /** Empty when the PR has none. */
   title: string;
 }
 interface ReviewProviders {
@@ -1310,6 +1358,8 @@ interface ReviewProviders {
     id?: string;
     preferred?: string;
   }): Promise<ResolvedPullRequest>;
+  /** Undefined when the forge can't be read. */
+  pullRequestTitle?(url: string): Promise<string | undefined>;
   resolveTarget?(target: ReviewTarget, pinned?: Pins): Promise<{
     target: ReviewTarget;
     pins: Pins;
@@ -1413,8 +1463,8 @@ declare class ReviewStore {
   private purgeExpired;
   read(id: string, version?: number): Snapshot;
   setDiffStats(pins: Pins, stats: NonNullable<ReviewApiSummary["diffStats"]>, mode?: "structural" | "textual"): void;
-  /** Managed records are discoverable even if their preparation stamp was lost. */
-  tutorialIds(): string[];
+  /** Reviews of the tutorial earlier versions shipped, for their removal. */
+  legacyTutorialIds(): string[];
   list(mode?: "structural" | "textual"): ReviewApiSummary[];
   /** One review's catalog entry, as review_list shows it. */
   summary(id: string): ReviewApiSummary | undefined;
@@ -1433,16 +1483,17 @@ declare class ReviewStore {
   }[];
   inspect(id: string, targetId?: string, version?: number): Element | {
     id: string | undefined;
-    type: "image" | "code" | "markdown" | "divider" | "code_peek" | "sequence" | "step" | "call_stack_diff" | "database_lens" | "trace_quote" | "software_map" | "flow_diagram" | "flow_node" | "flow_edge" | "section" | "callout" | "tutorial";
+    type: "image" | "code" | "markdown" | "divider" | "code_peek" | "sequence" | "step" | "call_stack_diff" | "database_lens" | "trace_quote" | "software_map" | "flow_diagram" | "flow_node" | "flow_edge" | "section" | "callout";
     label: any;
   }[];
-  /** The host can seed a managed document; transport callers only supply a command. */
+  /** The host can seed a document; transport callers only supply a command. */
   execute(input: unknown, initial?: {
     document: Block[];
     origin: SnapshotOrigin;
   }): Promise<Result>;
   /** Resolve a target-less PR create before it queues, when it will need it. */
   private startPullRequest;
+  private startPullRequestTitle;
   /** Reviews whose PR is this one, newest version first. Summaries only. */
   private reviewsForPullRequest;
   private assertReusableReview;
@@ -1492,6 +1543,8 @@ declare class ReviewWorkspaces {
    * the Desktop's canvas tabs and source windows may still show them.
    */
   private releaseTrashed;
+  /** Restored since the move to Trash: its checkouts may be in use. */
+  private stillTrashed;
   private repositoryDirs;
   /** Resolves once no release of the review is pending, so an ensure cannot race it. */
   released(reviewId: string): Promise<void>;
@@ -1644,6 +1697,7 @@ declare class LocalReviewData {
     id?: string;
     preferred?: string;
   }): Promise<ResolvedPullRequest>;
+  pullRequestTitle(url: string): Promise<string | undefined>;
   /** A registered checkout with a remote for host/owner/repo, and that remote. */
   private pullRequestCheckout;
   resolvePins(repositoryId: string, base: string, head: string): Promise<Pins>;
@@ -1803,6 +1857,7 @@ declare function validateShareBundle(bundle: ShareBundle): {
       baseRef?: string | undefined;
       pullRequestNumber?: number | undefined;
       pullRequestUrl?: string | undefined;
+      pullRequestTitle?: string | undefined;
       revision?: string | undefined;
     } | undefined;
   };
@@ -1892,6 +1947,7 @@ declare class SharedReviewStore {
         baseRef?: string | undefined;
         pullRequestNumber?: number | undefined;
         pullRequestUrl?: string | undefined;
+        pullRequestTitle?: string | undefined;
         revision?: string | undefined;
       } | undefined;
     };

package/dist/sharing/index.js

@@ -1,2 +1,2 @@
-import { a as sharedReviewId, c as verifyShareRepository, i as SharedReviewStore, l as exportShare, n as ShareClient, o as validateShareBundle } from "../client-DzcSt6pV.js";
+import { a as sharedReviewId, c as verifyShareRepository, i as SharedReviewStore, l as exportShare, n as ShareClient, o as validateShareBundle } from "../client-DhZzPePs.js";
 export { ShareClient, SharedReviewStore, exportShare, sharedReviewId, validateShareBundle, verifyShareRepository };

package/dist/{src-DiHP11l3.js → src-BMPuxWv4.js}

@@ -29,16 +29,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
 //#endregion
-//#region src/review-api/input-error.ts
-/** Deliberately safe to show to API clients, unlike filesystem/provider errors. */
-var ReviewInputError = class extends Error {
-	status;
-	constructor(message, status = 400) {
-		super(message);
-		this.status = status;
-	}
-};
-//#endregion
 //#region ../../node_modules/protocols/lib/index.js
 var require_lib$4 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	/**
@@ -1332,6 +1322,11 @@ async function resolveRevision(rootPath, revision) {
 	if (!vcs) return null;
 	return vcs.resolveRevision(revision);
 }
+async function defaultBranch(rootPath) {
+	const vcs = await detectLocalVcs(rootPath);
+	if (!vcs) return null;
+	return vcs.defaultBranch();
+}
 async function currentHeadForKind(rootPath, kind) {
 	return resolveRevisionForKind(rootPath, kind === "jj" ? "@" : "HEAD", kind);
 }
@@ -3683,4 +3678,4 @@ var require_adapter = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports.checkSync = checkSync;
 })))();
 //#endregion
-export { ReviewInputError as C, __toESM as E, setLocalVcsCommandObserver as S, __require as T, readFileAtCommit as _, diffFileSummaries as a, resolveRevision as b, diffTrees as c, gitAt as d, gitCommonDir as f, parseGitRemote as g, listTrackedFilesAtCommit as h, diff as i, diffWorkingTree as l, listCommitRange as m, createBlobBatchReader as n, diffFileSummariesTrees as o, jjRevisionIsConflicted as p, detectLocalVcs as r, diffFileSummariesWorkingTree as s, LocalVcsToolsMissingError as t, git as u, resolveRepoContext as v, __commonJSMin as w, splitGitPatchFiles as x, resolveRepoContextSync as y };
+export { setLocalVcsCommandObserver as C, __toESM as E, splitGitPatchFiles as S, __require as T, parseGitRemote as _, diff as a, resolveRepoContextSync as b, diffFileSummariesWorkingTree as c, git as d, gitAt as f, listTrackedFilesAtCommit as g, listCommitRange as h, detectLocalVcs as i, diffTrees as l, jjRevisionIsConflicted as m, createBlobBatchReader as n, diffFileSummaries as o, gitCommonDir as p, defaultBranch as r, diffFileSummariesTrees as s, LocalVcsToolsMissingError as t, diffWorkingTree as u, readFileAtCommit as v, __commonJSMin as w, resolveRevision as x, resolveRepoContext as y };

package/dist/{src-WCbabvdS.js → src-Bgvf1sEN.js}

@@ -176,6 +176,7 @@ const ReviewStructuralDiffErrorSchema = z.object({
 z.union([StructuralDiffEventSchema, ReviewStructuralDiffErrorSchema]);
 const REVIEW_CLIENT_HEADER = "x-review-client";
 const REVIEW_CLIENT_REMOTE = "remote";
+const REVIEW_HOST_HEADER = "x-review-host";
 const requiredString$1 = z.string({ error: "must be a string" }).refine((value) => value.trim().length > 0, "must be a string");
 const stringAllowEmpty = z.string({ error: "must be a string" });
 const positiveInteger = z.number({ error: "must be a positive integer" }).int("must be a positive integer").positive("must be a positive integer");
@@ -225,6 +226,7 @@ z.strictObject({
 });
 /** How embedded diffs lay out: base and head side by side, or one column. */
 const REVIEW_DIFF_LAYOUTS = ["split", "unified"];
+const REVIEW_DIFF_LAYOUT_SCOPES = ["diff", "peek"];
 const REVIEW_THEME_CHOICES = [
 	"dark",
 	"light",
@@ -259,6 +261,16 @@ z.object({
 	changed: z.boolean().optional(),
 	error: z.string().optional()
 });
+const REVIEW_REMOTE_WRAPPER_MARK = "# Written by Whiteboard Desktop, which replaces it with each install.";
+const REVIEW_REMOTE_ATTACH_BEGIN = "WHITEBOARD-REMOTE-BEGIN";
+const REVIEW_REMOTE_ATTACH_END = "WHITEBOARD-REMOTE-END";
+const REVIEW_REMOTE_INSTALL_LOCK = "install.lock";
+const REVIEW_REMOTE_AGENT_IDS = [
+	"claude",
+	"codex",
+	"opencode",
+	"pi"
+];
 const ReviewDesktopDiscoverySchema = z.object({
 	version: z.literal(3, { error: "Unsupported Whiteboard Desktop discovery version" }),
 	instanceId: requiredString$1,
@@ -280,6 +292,40 @@ const ReviewDesktopDiscoverySchema = z.object({
 	appPath: requiredString$1.optional(),
 	appVersion: requiredString$1.optional()
 });
+const ReviewGatewayHostSchema = z.strictObject({
+	alias: requiredString$1,
+	endpoint: z.strictObject({
+		url: requiredString$1,
+		token: requiredString$1
+	}).optional(),
+	problem: z.strictObject({
+		state: z.enum([
+			"unreachable",
+			"not-installed",
+			"auth-failed",
+			"unsupported",
+			"incompatible"
+		]),
+		detail: stringAllowEmpty
+	}).optional(),
+	declined: z.literal(true).optional(),
+	asking: requiredString$1.optional(),
+	installFailure: stringAllowEmpty.optional(),
+	target: z.enum(["linux-x64", "linux-arm64"]).optional(),
+	installing: z.strictObject({ step: z.enum([
+		"preparing",
+		"waiting-for-lock",
+		"package",
+		"done"
+	]) }).optional(),
+	languageFeatures: z.boolean().optional(),
+	languageFeaturesDetail: stringAllowEmpty.optional(),
+	languageGroups: z.array(z.strictObject({
+		group: requiredString$1,
+		installed: z.boolean(),
+		detail: stringAllowEmpty.optional()
+	})).optional()
+});
 z.strictObject({
 	kind: z.enum([
 		"git",
@@ -343,15 +389,14 @@ const ReviewErrorResponseSchema = z.strictObject({
 	code: requiredString$1.optional(),
 	retryable: z.boolean().optional()
 });
-z.strictObject({
-	kind: z.literal("api"),
-	reviewUuid: z.uuid({ error: "must be a UUID" }),
-	title: stringAllowEmpty
-});
 const ReviewStackLayerSchema = z.strictObject({
 	branch: requiredString$1,
-	pullRequestNumber: positiveInteger,
+	pullRequestNumber: positiveInteger.nullable(),
 	pullRequestUrl: absoluteUrlSchema.nullable(),
+	/** Where a new review of an unreviewed local branch starts. */
+	base: requiredString$1.nullable(),
+	/** A local branch's oldest commit subject. */
+	subject: requiredString$1.nullable(),
 	reviewUuid: z.uuid({ error: "must be a UUID" }).nullable(),
 	reviewTitle: stringAllowEmpty.nullable(),
 	relation: z.enum([
@@ -370,6 +415,15 @@ const ReviewCliInstallTargetSchema = z.enum([
 	"omp",
 	"copilot"
 ], { error: "must be claude, codex, cursor, opencode, pi, omp, or copilot" });
+const REVIEW_CLI_INSTALL_TARGET_LABELS = {
+	claude: "Claude Code",
+	codex: "Codex",
+	cursor: "Cursor",
+	opencode: "OpenCode",
+	pi: "Pi",
+	omp: "oh-my-pi",
+	copilot: "Copilot CLI"
+};
 const ReviewCliInstallStampSchema = z.object({
 	consent: z.enum([
 		"granted",
@@ -461,6 +515,69 @@ z.strictObject({
 	output: stringAllowEmpty,
 	shimPath: requiredString$1.optional()
 });
+/** An agent harness Whiteboard can connect to, and whether this machine has it. */
+const ReviewConnectAgentSchema = z.strictObject({
+	target: ReviewCliInstallTargetSchema,
+	name: requiredString$1,
+	found: z.boolean(),
+	/** Whether it already has Whiteboard's plugin or MCP server. */
+	connected: z.boolean()
+});
+z.strictObject({ agents: z.array(ReviewConnectAgentSchema) });
+const ReviewConnectRequestSchema = z.strictObject({ target: ReviewCliInstallTargetSchema });
+z.strictObject({
+	target: ReviewCliInstallTargetSchema,
+	state: z.enum([
+		"connected",
+		"approve",
+		"failed"
+	]),
+	output: stringAllowEmpty
+});
+/** A repository the first-run Run step can draw from. */
+const ReviewOnboardingProjectSchema = z.strictObject({
+	path: requiredString$1,
+	name: requiredString$1
+});
+/** Something in a repository to draw: the checkout's branch, another
+* worktree, or an open pull request. */
+const ReviewOnboardingTargetSchema = z.discriminatedUnion("kind", [
+	z.strictObject({
+		kind: z.literal("branch"),
+		path: requiredString$1,
+		branch: requiredString$1
+	}),
+	z.strictObject({
+		kind: z.literal("worktree"),
+		path: requiredString$1,
+		branch: requiredString$1
+	}),
+	z.strictObject({
+		kind: z.literal("pr"),
+		number: z.number().int().positive(),
+		title: requiredString$1,
+		url: requiredString$1,
+		author: stringAllowEmpty,
+		branch: stringAllowEmpty,
+		additions: z.number().int().nonnegative(),
+		deletions: z.number().int().nonnegative()
+	})
+]);
+z.strictObject({
+	project: ReviewOnboardingProjectSchema,
+	base: stringAllowEmpty,
+	targets: z.array(ReviewOnboardingTargetSchema)
+});
+/** Make a whiteboard of `target`, open it, and start `agent` drawing it. */
+const ReviewOnboardingRunRequestSchema = z.strictObject({
+	/** The repository the target came from. */
+	projectPath: requiredString$1,
+	/** What a branch is compared to, when it has no pull request. */
+	base: stringAllowEmpty,
+	target: ReviewOnboardingTargetSchema,
+	agent: requiredString$1,
+	prompt: z.string().trim().min(1).max(8e3)
+});
 const ReviewDiffFileSchema = z.strictObject({
 	path: requiredString$1,
 	previousPath: requiredString$1.optional(),
@@ -623,7 +740,7 @@ const ReviewVerbResponseSchema = z.discriminatedUnion("ok", [z.strictObject({
 	ok: z.literal(true),
 	result: z.unknown().optional()
 }), ReviewErrorResponseSchema]);
-z.strictObject({
+const ReviewDesktopVerbFrameSchema = z.strictObject({
 	event: z.literal("desktop-verb"),
 	id: requiredString$1,
 	request: ReviewVerbRequestSchema
@@ -832,6 +949,9 @@ function parseReviewDesktopDiscovery(value) {
 function parseReviewCliInstallApplyRequest(value) {
 	return parseZod(ReviewCliInstallApplyRequestSchema, value);
 }
+function parseReviewDesktopVerbFrame(value) {
+	return parseZod(ReviewDesktopVerbFrameSchema, value);
+}
 function parseReviewDesktopVerbResult(value) {
 	return parseZod(ReviewDesktopVerbResultSchema, value);
 }
@@ -856,4 +976,4 @@ function formatIssuePath(path) {
 	return output;
 }
 //#endregion
-export { SCRATCHPAD_REVIEW_ID as _, parseReviewVerbResponse as a, structuralChangeCounts as b, ReviewBugReportRequestSchema as c, REVIEW_CLIENT_REMOTE as d, REVIEW_DIFF_LAYOUTS as f, ReviewSelectedDiffSchema as g, ReviewCliInstallStampSchema as h, parseReviewVerbRequest as i, parseReviewBugReportResponse as l, ReviewApiSelectionSourceSchema as m, parseReviewDesktopDiscovery as n, parseZod as o, REVIEW_THEME_CHOICES as p, parseReviewDesktopVerbResult as r, ReviewBugReportMetaV2Schema as s, parseReviewCliInstallApplyRequest as t, REVIEW_CLIENT_HEADER as u, reviewDiffrSummarizerInputSchema as v, decodeStructuralDiffEvent as y };
+export { reviewDiffrSummarizerInputSchema as A, ReviewApiSelectionSourceSchema as C, ReviewOnboardingRunRequestSchema as D, ReviewGatewayHostSchema as E, structuralChangeCounts as M, ReviewSelectedDiffSchema as O, REVIEW_THEME_CHOICES as S, ReviewConnectRequestSchema as T, REVIEW_REMOTE_AGENT_IDS as _, parseReviewVerbRequest as a, REVIEW_REMOTE_INSTALL_LOCK as b, ReviewBugReportMetaV2Schema as c, REVIEW_CLIENT_HEADER as d, REVIEW_CLIENT_REMOTE as f, REVIEW_HOST_HEADER as g, REVIEW_DIFF_LAYOUT_SCOPES as h, parseReviewDesktopVerbResult as i, decodeStructuralDiffEvent as j, SCRATCHPAD_REVIEW_ID as k, ReviewBugReportRequestSchema as l, REVIEW_DIFF_LAYOUTS as m, parseReviewDesktopDiscovery as n, parseReviewVerbResponse as o, REVIEW_CLI_INSTALL_TARGET_LABELS as p, parseReviewDesktopVerbFrame as r, parseZod as s, parseReviewCliInstallApplyRequest as t, parseReviewBugReportResponse as u, REVIEW_REMOTE_ATTACH_BEGIN as v, ReviewCliInstallStampSchema as w, REVIEW_REMOTE_WRAPPER_MARK as x, REVIEW_REMOTE_ATTACH_END as y };

package/dist/{stored-document-migration-u4L_1VZa.js → stored-document-migration-CFOvjRwW.js}

@@ -1,6 +1,6 @@
-import { C as ReviewInputError } from "./src-DiHP11l3.js";
 import { f as isNumberValue, l as jsonValueSchema, m as isStringValue, n as isJsonObject } from "./src-X9phtB2j.js";
-import "./src-WCbabvdS.js";
+import "./src-Bgvf1sEN.js";
+import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 import { z } from "zod";
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { gfmFromMarkdown } from "mdast-util-gfm";
@@ -1448,17 +1448,6 @@ const trace_quote = {
 	})
 };
 //#endregion
-//#region src/review-api/blocks/tutorial.ts
-const tutorialSchema = z.discriminatedUnion("kind", [defineBlock("tutorial", { kind: z.literal("keymap") }), defineBlock("tutorial", {
-	kind: z.literal("view"),
-	view: z.literal("diff"),
-	label: z.string()
-})]);
-const tutorial = {
-	type: "tutorial",
-	schema: tutorialSchema
-};
-//#endregion
 //#region src/review-api/blocks/index.ts
 /** Leaf kinds share one discriminated union so unknown types read as they always have. */
 const leafSchema = z.discriminatedUnion("type", [
@@ -1488,8 +1477,7 @@ const blocks = {
 	software_map,
 	flow_diagram,
 	section,
-	callout,
-	tutorial
+	callout
 };
 /** Discriminated by type, so a malformed block reports its own kind's
 * issues rather than every kind's. */
@@ -1499,8 +1487,7 @@ const blockSchema = z.lazy(() => z.discriminatedUnion("type", blockKindSchemas()
 const blockKindSchemas = () => [
 	leafSchema,
 	sectionSchema,
-	calloutSchema,
-	tutorialSchema
+	calloutSchema
 ];
 function checkBlock(type, block) {
 	blocks[type].check?.(block);
@@ -1752,7 +1739,7 @@ function edits(content, replacement, value) {
 	]);
 }
 const editSchema = edits(contentSchema, blockSchema, z.json());
-const writableBlockTypes = Object.keys(blocks).filter((type) => type !== "tutorial");
+const writableBlockTypes = Object.keys(blocks);
 const namedByType = (types) => z.looseObject({ type: z.enum(types) }).describe("Fields depend on type; see the tool description.");
 /** What agents are shown: content names only its type. The host parses
 * editSchema, reporting the named kind's issues. */

package/dist/{tool-failure-CJHBCHMh.js → tool-failure-BXWzQG8T.js}

@@ -1,6 +1,6 @@
-import { C as ReviewInputError } from "./src-DiHP11l3.js";
 import { m as isStringValue, n as isJsonObject } from "./src-X9phtB2j.js";
-import { n as callAuthoringTool, s as ReviewApiError, t as ToolText } from "./agent-client-P3J4y8Zn.js";
+import { n as callAuthoringTool, s as ReviewApiError, t as ToolText } from "./agent-client-DVd-prfp.js";
+import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
 //#region src/review-api/public-tools.ts
 function publicDescription(text) {
 	return text.replace(/\breview_(\w+)/g, "session_$1").replace(/\breviewId\b/g, "sessionId").replace(/\bReview\b/g, "Whiteboard").replace("The result carries review,", "The result carries session,");