@dev.fast/whiteboard 0.2.4 → 0.2.5-preview.20261013.109

package/dist/{review-telemetry-DBy3eVCo.js → review-telemetry-CmM6tCbj.js}

@@ -1,8 +1,8 @@
 import { c as jsonString, l as jsonValueSchema, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
 import "./src-WCbabvdS.js";
+import "./review-home-paths-Y9mYWkCI.js";
 import { A as devReviewHome, D as processIsAlive, M as writeFileAtomic, O as withFileLock } from "./s3-config-CAxhO9u_.js";
-import "./review-home-paths-6zZH-1c9.js";
-import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "./package-paths-B6-zxvIO.js";
+import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "./package-paths-B9PDoAl6.js";
 import "./request-origin-DA4K1qWY.js";
 import { createHmac, randomUUID } from "node:crypto";
 import { z } from "zod";

package/dist/server/desktop-host.js

@@ -1,20 +1,19 @@
 #!/usr/bin/env node
-import { a as diffFileSummaries, b as resolveRevision, i as diff, x as splitGitPatchFiles } from "../src-CmdiBL20.js";
+import { C as ReviewInputError, a as diffFileSummaries, b as resolveRevision, i as diff, x as splitGitPatchFiles } from "../src-DiHP11l3.js";
 import { c as jsonString, i as jsonBoolean, n as isJsonObject, p as isObjectValue, s as jsonProperty, u as parseJsonText } from "../src-X9phtB2j.js";
-import { i as SharedReviewStore } from "../client-BFClfQLO.js";
+import { i as SharedReviewStore } from "../client-DzcSt6pV.js";
 import { c as ReviewBugReportRequestSchema, l as parseReviewBugReportResponse, o as parseZod, s as ReviewBugReportMetaV2Schema, t as parseReviewCliInstallApplyRequest, v as reviewDiffrSummarizerInputSchema } from "../src-WCbabvdS.js";
-import { C as resourceReferences, p as documentSchema } from "../stored-document-migration-BxZWQQjv.js";
-import { t as ReviewInputError } from "../input-error-OLgB_h31.js";
+import { et as shellQuote, i as reviewInstanceDiscoveryPath, o as reviewLegacyDiscoveryPath } from "../review-home-paths-Y9mYWkCI.js";
+import { C as resourceReferences, M as lensSchema, p as documentSchema } from "../stored-document-migration-u4L_1VZa.js";
 import { A as devReviewHome, P as writePrivateJsonAtomic } from "../s3-config-CAxhO9u_.js";
-import { U as shellQuote, i as reviewInstanceDiscoveryPath, o as reviewLegacyDiscoveryPath } from "../review-home-paths-6zZH-1c9.js";
-import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "../package-paths-B6-zxvIO.js";
-import { c as reviewInstanceIdentity, t as REVIEW_INSTANCE_ENV } from "../desktop-discovery-C-Qz54wO.js";
-import { t as openReviewProfile } from "../profile-RDEioF8b.js";
-import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-DBy3eVCo.js";
+import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "../package-paths-B9PDoAl6.js";
+import { c as reviewInstanceIdentity, t as REVIEW_INSTANCE_ENV } from "../desktop-discovery-Ba3dD5Cn.js";
+import { t as openReviewProfile } from "../profile-BsYDBr7t.js";
+import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-CmM6tCbj.js";
 import { o as REVIEW_TELEMETRY_TABS } from "../request-origin-DA4K1qWY.js";
-import { c as removeLegacyReviewSkills, d as skipCliInstall, i as finishCliInstallUpdate, l as resetCliInstall, n as applyCliInstall, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-_1_7vROx.js";
-import { _ as setDiffrConfigValue, a as serverJson, c as recordClientError, d as HttpJsonError, f as ReviewServerError, g as saveDiffrSummarizer, h as readDiffrConfig, i as createWhiteboardCore, l as createNodeRequestListener, m as migrateDiffrConfig, n as installProcessErrorTelemetry, o as captureSanitizedUiTelemetry, p as GlobalReviewDesktopVerbRelay, r as serverCrashReportPath, s as clientErrorsForSession, t as drainServerCrashReport, u as readBoundedRequestJson, v as testDiffrSummarizer } from "../process-error-telemetry-Dzh5a3s_.js";
-import { c as readQuerySchemas } from "../authoring-tools-DvIO906l.js";
+import { c as removeLegacyReviewSkills, d as skipCliInstall, i as finishCliInstallUpdate, l as resetCliInstall, n as applyCliInstall, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-D0hF0sKk.js";
+import { _ as setDiffrConfigValue, a as serverJson, c as recordClientError, d as HttpJsonError, f as ReviewServerError, g as saveDiffrSummarizer, h as readDiffrConfig, i as createWhiteboardCore, l as createNodeRequestListener, m as migrateDiffrConfig, n as installProcessErrorTelemetry, o as captureSanitizedUiTelemetry, p as GlobalReviewDesktopVerbRelay, r as serverCrashReportPath, s as clientErrorsForSession, t as drainServerCrashReport, u as readBoundedRequestJson, v as testDiffrSummarizer } from "../process-error-telemetry-C0swByfp.js";
+import { c as readQuerySchemas } from "../authoring-tools-D8WXsm_g.js";
 import crypto, { createHash, randomBytes, randomUUID } from "node:crypto";
 import { z } from "zod";
 import fs, { existsSync } from "node:fs";
@@ -814,6 +813,7 @@ const authoredSchema = z.strictObject({
 	title: z.string().min(1),
 	document: documentSchema
 });
+const lensesSchema = z.array(lensSchema.omit({ id: true }));
 const pinsSchema = z.strictObject({
 	base: z.string().regex(/^[a-f0-9]{40}$/),
 	head: z.string().regex(/^[a-f0-9]{40}$/)
@@ -826,15 +826,13 @@ const stampSchema = z.object({
 async function readTutorialAssets(assetsRoot) {
 	const bytes = await Promise.all([
 		"document.json",
-		"trace.json",
-		"software-map.json",
+		"lenses.json",
 		"pins.json"
 	].map((name) => readFile(path.join(assetsRoot, name), "utf8")));
 	return {
 		authored: authoredSchema.parse(JSON.parse(bytes[0])),
-		trace: JSON.parse(bytes[1]),
-		model: JSON.parse(bytes[2]),
-		pins: pinsSchema.parse(JSON.parse(bytes[3])),
+		lenses: lensesSchema.parse(JSON.parse(bytes[1])),
+		pins: pinsSchema.parse(JSON.parse(bytes[2])),
 		contentHash: createHash("sha256").update(JSON.stringify(bytes)).digest("hex")
 	};
 }
@@ -843,31 +841,6 @@ async function createNativeTutorial(input) {
 	const assets = await readTutorialAssets(input.assetsRoot);
 	const repository = await input.data.register(input.sampleRoot);
 	const pins = await input.data.resolvePins(repository.id, assets.pins.base, assets.pins.head);
-	const aliases = /* @__PURE__ */ new Map();
-	const traceId = randomUUID();
-	await input.data.upload({
-		id: traceId,
-		repositoryId: repository.id,
-		kind: "trace",
-		trace: assets.trace
-	});
-	aliases.set("tutorial-trace", traceId);
-	for (const side of ["base", "head"]) {
-		const id = randomUUID();
-		await input.data.upload({
-			id,
-			repositoryId: repository.id,
-			kind: "map",
-			pins,
-			side,
-			model: assets.model
-		});
-		aliases.set(`tutorial-map-${side}`, id);
-	}
-	for (const block of resourceReferences(assets.authored.document)) {
-		if (block.type === "trace_quote") block.traceId = aliases.get(block.traceId) ?? block.traceId;
-		if (block.type === "software_map") block.mapVersionId = aliases.get(block.mapVersionId) ?? block.mapVersionId;
-	}
 	const result = await input.store.execute({ operation: {
 		type: "create",
 		title: assets.authored.title,
@@ -879,6 +852,15 @@ async function createNativeTutorial(input) {
 		document: assets.authored.document,
 		origin: { tutorial: true }
 	});
+	for (const { title, targets } of assets.lenses) await input.store.execute({ operation: {
+		type: "lens_edit",
+		reviewId: result.reviewId,
+		edit: {
+			type: "insert",
+			title,
+			targets
+		}
+	} });
 	return {
 		snapshot: input.store.read(result.reviewId),
 		contentHash: assets.contentHash
@@ -903,10 +885,17 @@ function createTutorialService(input) {
 		}
 	}
 	async function cleanup() {
-		for (const reviewId of input.store.tutorialIds()) await input.store.execute({ operation: {
-			type: "delete",
-			reviewId
-		} });
+		for (const reviewId of input.store.tutorialIds()) {
+			if (!input.store.read(reviewId).trashedAt) await input.store.execute({ operation: {
+				type: "lifecycle",
+				state: "trash",
+				reviewId
+			} });
+			await input.store.execute({ operation: {
+				type: "delete",
+				reviewId
+			} });
+		}
 		for (const repository of input.store.repositories()) {
 			const relative = path.relative(tutorialRoot, repository.path);
 			if (relative && !relative.startsWith("..") && !path.isAbsolute(relative)) await input.data.forgetRepository(repository.id);

package/dist/{server-discovery-Dbzn3w6Z.js → server-discovery-ZVi8Ay8J.js}

@@ -1,5 +1,5 @@
+import "./review-home-paths-Y9mYWkCI.js";
 import { A as devReviewHome } from "./s3-config-CAxhO9u_.js";
-import "./review-home-paths-6zZH-1c9.js";
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
 import path from "node:path";

package/dist/sharing/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { watch } from "node:fs";
 import { DatabaseSync } from "node:sqlite";
+import { subscribe } from "@parcel/watcher";
 //#region ../json/src/json.d.ts
 /**
  * JSON values as they come off the wire or out of a file. Parse into one of
@@ -263,7 +263,7 @@ interface ReviewApiSummary {
     deletions: number;
   } | null;
   viewedAt: string | null;
-  dismissedAt: string | null;
+  trashedAt: string | null;
   /** An agent holds a live lease; absent on shared reviews. */
   working?: boolean;
 }
@@ -425,34 +425,13 @@ interface SectionBlock {
   children: Block[];
 }
 //#endregion
-//#region src/tutorial-conversation.d.ts
-declare const tutorialAuthoringConversationSchema: z.ZodObject<{
-  version: z.ZodLiteral<1>;
-  title: z.ZodString;
-  messages: z.ZodArray<z.ZodObject<{
-    role: z.ZodEnum<{
-      user: "user";
-      assistant: "assistant";
-    }>;
-    body: z.ZodString;
-  }, z.core.$strict>>;
-}, z.core.$strict>;
-type TutorialAuthoringConversation = z.infer<typeof tutorialAuthoringConversationSchema>;
-//#endregion
 //#region src/review-api/blocks/tutorial.d.ts
 type TutorialContent = {
   kind: "keymap";
-} | {
-  kind: "conversation";
-  conversation: TutorialAuthoringConversation;
 } | {
   kind: "view";
-  view: "review" | "commits" | "diff" | "map";
+  view: "diff";
   label: string;
-} | {
-  kind: "feature";
-  feature: "softwareMap";
-  children: Block[];
 };
 type TutorialBlock = {
   id?: string;
@@ -575,6 +554,7 @@ declare const leafSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       label: z.ZodString;
       key: z.ZodOptional<z.ZodString>;
       fields: z.ZodRecord<z.ZodString, z.ZodType<DatabaseField, unknown, z.core.$ZodTypeInternals<DatabaseField, unknown>>>;
+      source: any;
     }, z.core.$strict>>;
   }, z.core.$strict>>;
   useCases: z.ZodArray<z.ZodObject<{
@@ -815,6 +795,7 @@ declare const editSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         label: z.ZodString;
         key: z.ZodOptional<z.ZodString>;
         fields: z.ZodRecord<z.ZodString, z.ZodType<DatabaseField, unknown, z.core.$ZodTypeInternals<DatabaseField, unknown>>>;
+        source: any;
       }, z.core.$strict>>;
     }, z.core.$strict>>;
     useCases: z.ZodArray<z.ZodObject<{
@@ -914,28 +895,12 @@ declare const editSchema: 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<"conversation">;
-    conversation: any;
   }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"tutorial">;
     id: z.ZodOptional<z.ZodString>;
     kind: z.ZodLiteral<"view">;
-    view: z.ZodEnum<{
-      map: "map";
-      commits: "commits";
-      review: "review";
-      diff: "diff";
-    }>;
+    view: z.ZodLiteral<"diff">;
     label: z.ZodString;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"tutorial">;
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"feature">;
-    feature: z.ZodLiteral<"softwareMap">;
-    children: z.ZodArray<z.ZodLazy<z.ZodType<Block, unknown, z.core.$ZodTypeInternals<Block, unknown>>>>;
   }, z.core.$strict>], "kind">, z.ZodObject<{
     type: z.ZodDefault<z.ZodLiteral<"step">>;
     from: z.ZodString;
@@ -1235,7 +1200,11 @@ type AskRecord = z.infer<typeof askRecordSchema>;
  * `reviews`, so there is no foreign key; deleting a review deletes its rows. */
 declare class AskHistory {
   private readonly db;
+  private externalWriteGuard?;
+  setExternalWriteGuard(guard: (reviewId: string) => void): void;
   constructor(db: DatabaseSync);
+  private assertWritable;
+  private assertThreadWritable;
   save(record: AskRecord): void;
   /** Whether reopening the conversation bypasses permissions. */
   setBypass(id: string, bypass: boolean): void;
@@ -1256,6 +1225,7 @@ declare class AskHistory {
   /** Newest first. */
   list(reviewId: string): AskHistoryEntry[];
   get(id: string): AskRecord | undefined;
+  removeReview(reviewId: string): void;
   delete(id: string): void;
 }
 //#endregion
@@ -1272,6 +1242,8 @@ interface SnapshotOrigin {
   revision?: string;
 }
 interface Snapshot {
+  /** Current lifecycle state, projected onto every version when read. */
+  trashedAt?: string | null;
   shared?: {
     login?: string;
     sharedAt?: number;
@@ -1319,6 +1291,7 @@ interface Result {
   type?: Element["type"] | "lens";
   children?: WrittenComponent[];
   attention?: true;
+  lifecycle?: true;
   deleted?: true;
   warnings?: string[];
 }
@@ -1372,6 +1345,7 @@ declare class ReviewStore {
   private readonly liveSources;
   private refreshTimer?;
   private refreshSubscribers;
+  private readonly purgeTimer;
   watchWorktrees(): () => void;
   private projectLiveSource;
   private refreshPending;
@@ -1382,6 +1356,7 @@ declare class ReviewStore {
   private readonly externalChanges;
   private observedDataVersion;
   private observedVersions;
+  private observedDeletions;
   subscribeCatalog(listener: () => void): () => void;
   /** For a host whose listing changed without the store: a preference flip. */
   invalidateCatalog(): void;
@@ -1389,6 +1364,7 @@ declare class ReviewStore {
   constructor(databasePath: string, providers: ReviewProviders);
   private dataVersion;
   private currentVersions;
+  private currentDeletions;
   private refreshExternalChanges;
   /** Reader progress never creates a document version or authoring event. */
   viewedCoverage(reviewId: string): Map<string, {
@@ -1431,6 +1407,10 @@ declare class ReviewStore {
   resetServerId(): string;
   /** The 404 check alone, without loading a snapshot. */
   assertExists(id: string): void;
+  assertWritable(id: string): void;
+  private trashTime;
+  private removePermanently;
+  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. */
@@ -1465,14 +1445,15 @@ declare class ReviewStore {
   private startPullRequest;
   /** Reviews whose PR is this one, newest version first. Summaries only. */
   private reviewsForPullRequest;
+  private assertReusableReview;
   /** The answer to a create that found its PR's review. Its target stays:
    * moving it would silently point existing links at different code. */
   private existingReview;
   private commitCommand;
   private assertMutation;
   private notify;
-  /** Dismissed reviews, as Home lists them; only a restore clears it, not a view. */
-  dismissedIds(): string[];
+  /** Viewing a review in Trash does not restore it. */
+  trashedIds(): string[];
   has(reviewId: string): boolean;
   private validateExternal;
 }
@@ -1502,15 +1483,15 @@ declare class ReviewWorkspaces {
   private closed;
   private readonly ownerId;
   constructor(databasePath: string, store: ReviewStore);
-  private dismissed?;
+  private trashed?;
   private readonly releasing;
   /**
-   * Frees a newly dismissed review's checkouts to save disk. The review itself
+   * Frees a newly trashed review's checkouts to save disk. The review itself
    * stays; reopening it rebuilds them. Checkouts rebuilt by peeking at a
-   * dismissed review are kept until the next startup or dismissal, since
+   * trashed review are kept until the next startup or move to Trash, since
    * the Desktop's canvas tabs and source windows may still show them.
    */
-  private releaseDismissed;
+  private releaseTrashed;
   private repositoryDirs;
   /** Resolves once no release of the review is pending, so an ensure cannot race it. */
   released(reviewId: string): Promise<void>;
@@ -1617,7 +1598,7 @@ declare class LocalReviewData {
     blobReaderIdleTimeoutMs?: number;
     workspaceDatabase?: string;
     manageWorkspaces?: boolean;
-    watch?: typeof watch;
+    subscribe?: typeof subscribe;
     /** gh, git and GitHub API access for pull request targets. */
     pullRequests?: PullRequestDeps;
   });
@@ -1866,6 +1847,8 @@ declare class SharedReviewStore {
   private readonly attention;
   private readonly listeners;
   private catalogLoaded;
+  private readonly purgeTimer;
+  private purgePending;
   private readonly downloads;
   trackImport(job: Promise<void>): void;
   close(): Promise<void>;
@@ -1874,6 +1857,7 @@ declare class SharedReviewStore {
   private readonly jobs;
   private readonly states;
   constructor(root: string, fetchRepository?: typeof fetchPinnedRepository);
+  private purgeExpired;
   connect(store: ReviewStore, data: LocalReviewData): void;
   has(id: string): boolean;
   status(id: string): {
@@ -1887,9 +1871,11 @@ declare class SharedReviewStore {
   assertReady(id: string): Promise<void>;
   subscribe(listener: () => void): () => void;
   load(): Promise<void>;
+  assertWritable(id: string): void;
   get(id: string): {
     snapshot: {
       reviewId: string;
+      trashedAt: string | null;
       pins: any;
       target: any;
       shared: {
@@ -1965,7 +1951,9 @@ declare class SharedReviewStore {
   list(mode?: "structural" | "textual"): any;
   readObject(id: string, objectId: string): Promise<NonSharedBuffer>;
   removeLocal(id: string): Promise<void>;
-  setAttention(id: string, action: "view" | "dismiss" | "restore"): Promise<void>;
+  setAttention(id: string): Promise<void>;
+  setLifecycle(id: string, state: "active" | "trash"): Promise<void>;
+  private updateAttention;
   import(origin: string, shareId: string, bundle: ShareBundle): Promise<string>;
   read(id: string): Promise<ShareBundle>;
   private readValidated;

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-BFClfQLO.js";
+import { a as sharedReviewId, c as verifyShareRepository, i as SharedReviewStore, l as exportShare, n as ShareClient, o as validateShareBundle } from "../client-DzcSt6pV.js";
 export { ShareClient, SharedReviewStore, exportShare, sharedReviewId, validateShareBundle, verifyShareRepository };

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

@@ -29,6 +29,16 @@ 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) => {
 	/**
@@ -3673,4 +3683,4 @@ var require_adapter = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports.checkSync = checkSync;
 })))();
 //#endregion
-export { __commonJSMin as C, setLocalVcsCommandObserver as S, __toESM 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, __require as w, splitGitPatchFiles as x, resolveRepoContextSync as y };
+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 };

package/dist/{stored-document-migration-BxZWQQjv.js → stored-document-migration-u4L_1VZa.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 { 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";
@@ -1305,7 +1305,8 @@ const storeSchema = z.strictObject({
 	collections: z.record(text$1, z.strictObject({
 		label: label$1,
 		key: label$1.optional(),
-		fields: z.record(text$1, fieldSchema)
+		fields: z.record(text$1, fieldSchema),
+		source: anchorSchema.optional().describe("Where the table or collection is declared, such as its schema definition. Its use cases' tours start here.")
 	}))
 });
 const operationSchema = z.strictObject({
@@ -1447,39 +1448,12 @@ const trace_quote = {
 	})
 };
 //#endregion
-//#region src/tutorial-conversation.ts
-const tutorialAuthoringConversationSchema = z.strictObject({
-	version: z.literal(1),
-	title: z.string().trim().min(1),
-	messages: z.array(z.strictObject({
-		role: z.enum(["user", "assistant"]),
-		body: z.string().trim().min(1)
-	})).min(2)
-});
-//#endregion
 //#region src/review-api/blocks/tutorial.ts
-const tutorialSchema = z.discriminatedUnion("kind", [
-	defineBlock("tutorial", { kind: z.literal("keymap") }),
-	defineBlock("tutorial", {
-		kind: z.literal("conversation"),
-		conversation: tutorialAuthoringConversationSchema
-	}),
-	defineBlock("tutorial", {
-		kind: z.literal("view"),
-		view: z.enum([
-			"review",
-			"commits",
-			"diff",
-			"map"
-		]),
-		label: z.string()
-	}),
-	defineBlock("tutorial", {
-		kind: z.literal("feature"),
-		feature: z.literal("softwareMap"),
-		children: z.array(z.lazy(() => blockSchema))
-	})
-]);
+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
@@ -1709,12 +1683,17 @@ function documentReferences(document, { tolerant = false } = {}) {
 				})) : []
 			];
 		});
-		if (element.type === "database_lens") return element.useCases.flatMap((useCase) => useCase.operations.flatMap((operation) => select(operation.source, operation.pins ?? element.pins).map((source) => ({
+		if (element.type === "database_lens") return [...Object.entries(element.stores).flatMap(([storeKey, store]) => Object.entries(store.collections).flatMap(([key, collection]) => collection.source ? select(collection.source, element.pins).map((source) => ({
+			id: `${element.id}:schema:${storeKey}:${key}`,
+			source,
+			label: collection.label,
+			peek: true
+		})) : [])), ...element.useCases.flatMap((useCase) => useCase.operations.flatMap((operation) => select(operation.source, operation.pins ?? element.pins).map((source) => ({
 			id: operation.id,
 			source,
 			label: operation.label,
 			peek: true
-		}))));
+		}))))];
 		return [];
 	});
 }

package/dist/{tool-failure-DJmTieh5.js → tool-failure-CJHBCHMh.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-B_b1GtUc.js";
-import { t as ReviewInputError } from "./input-error-OLgB_h31.js";
+import { n as callAuthoringTool, s as ReviewApiError, t as ToolText } from "./agent-client-P3J4y8Zn.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,");

package/instructions/scratchpad.md

@@ -2,7 +2,7 @@
 
 The scratchpad is one document in Whiteboard that is not a session for any change. It has no target, base, head or lifecycle. You draw on it the way you would sketch an explanation on a whiteboard: a short paragraph, a sequence or flow diagram, a call tree, a code peek, and the smallest view that makes the point. The user reads it in the app and copies blocks back to you.
 
-Its id is fixed: `scratchpad`. While it is turned on in Whiteboard Settings it always exists; never create, rename, delete, dismiss or share it.
+Its id is fixed: `scratchpad`. While it is turned on in Whiteboard Settings it always exists; never create, rename, trash, delete or share it.
 
 ## When to draw here
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.fast/whiteboard",
-  "version": "0.2.4",
+  "version": "0.2.5-preview.20261013.109",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -46,6 +46,7 @@
     "@hono/node-server": "2.0.12",
     "@img/sharp-wasm32": "0.35.5",
     "@modelcontextprotocol/sdk": "1.31.0",
+    "@parcel/watcher": "2.6.0",
     "commander": "14.0.3",
     "fuzzysort": "4.0.2",
     "hono": "4.13.7",
@@ -59,7 +60,7 @@
     "sharp": "0.35.5",
     "smol-toml": "1.9.0",
     "zod": "4.6.5",
-    "@dev.fast/diffr": "0.1.17"
+    "@dev.fast/diffr": "0.1.19"
   },
   "devDependencies": {
     "@dev.fast/local-vcs": "^0.1.0",
@@ -72,9 +73,9 @@
     "typescript": "6.0.3",
     "vitest": "4.1.11",
     "@dev.fast/json": "0.0.0",
-    "@dev.fast/review-protocol": "0.0.0",
     "@dev.fast/review-share-protocol": "0.1.2",
     "@dev.fast/trace-core": "0.0.0",
+    "@dev.fast/review-protocol": "0.0.0",
     "@dev.fast/trace-protocol": "0.5.0"
   },
   "engines": {
@@ -85,7 +86,7 @@
     "repo": "devdotfast/review",
     "docs": "packages/review/instructions/authoring.md"
   },
-  "gitHead": "5b00f0e66d034e187a29d270b3690a37b57ccf7b",
+  "gitHead": "a3d88565d0643e8a8f9e80f24a9b9d29b6a97e3d",
   "scripts": {
     "prebuild": "pnpm run build:workspace-deps",
     "build": "node --max-old-space-size=8192 node_modules/tsdown/dist/run.mjs",

package/src/ask/agents.ts

@@ -52,6 +52,11 @@ interface AskAgentSpec {
    * read-only mode and settings, when the reviewer bypasses permissions.
    * Whiteboard also allows whatever it still asks. */
   bypass?: AskAgentBypass;
+  /** A follow-up asked while it answers joins that turn, when it says it
+   * takes one. Only for an adapter that leaves a follow-up arriving as the
+   * turn ends to Whiteboard: Codex's starts a turn of its own instead,
+   * which Whiteboard does not see end, so its follow-ups wait their turn. */
+  steers?: boolean;
 }
 
 interface AskAgentMcp {
@@ -81,6 +86,7 @@ export const askAgents: Record<AskAgentId, AskAgentSpec> = {
       executableEnv: "CLAUDE_CODE_EXECUTABLE",
     },
     signIn: "claude auth login",
+    steers: true,
     // Plan mode would end each answer asking to leave it, and it blocks the
     // Whiteboard tools that edit the review. Claude instead runs in its
     // default mode without its file tools, and without bypass, so commands

package/src/ask/thread-state.ts

@@ -174,6 +174,9 @@ export const askUsageSchema = z.object({
 
 export type AskUsage = z.infer<typeof askUsageSchema>;
 
+/** A follow-up waiting for the turn under way to end. */
+const askQueuedSchema = z.object({ id: z.string(), text: z.string() });
+
 const statusSchema = z.enum([
   "starting",
   "running",
@@ -209,6 +212,9 @@ export const askThreadStateSchema = z.object({
   title: z.string().optional(),
   selection: z.object({ title: z.string(), quote: z.string().optional() }),
   entries: z.array(askEntrySchema),
+  /** Follow-ups asked while the agent answered, which it could not take
+   * then: each goes as its own question once the turn ends. */
+  queued: z.array(askQueuedSchema).optional(),
 });
 
 export type AskEntry = z.infer<typeof askEntrySchema>;
@@ -228,6 +234,8 @@ export const askChangeSchema = z.discriminatedUnion("type", [
     accepts: askAcceptsSchema.optional(),
     usage: askUsageSchema.optional(),
     title: z.string().optional(),
+    /** Replaces the queue; empty clears it. */
+    queued: z.array(askQueuedSchema).optional(),
     /** `null` clears the error; absent leaves it. */
     error: z.string().nullable().optional(),
     /** `null` clears it; absent leaves it. */
@@ -271,7 +279,12 @@ export function applyAskChange(
 ): AskThreadState {
   switch (change.type) {
     case "set": {
-      const { error: _error, signIn: _signIn, ...rest } = state;
+      const {
+        error: _error,
+        signIn: _signIn,
+        queued: _queued,
+        ...rest
+      } = state;
 
       const next: AskThreadState = {
         ...rest,
@@ -295,6 +308,9 @@ export function applyAskChange(
       const title = change.title ?? state.title;
 
       if (title) next.title = title;
+      const queued = change.queued ?? state.queued;
+
+      if (queued?.length) next.queued = queued;
 
       // Absent keeps the error, null clears it, a message replaces it.
       const error = change.error === undefined ? state.error : change.error;