@dev.fast/whiteboard 0.5.0 → 0.5.2-preview.20261104.146

package/dist/{package-paths-Cg6fnaGp.js → package-paths-Dk7MOXxN.js}

@@ -1,5 +1,5 @@
 import { c as jsonString, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./review-home-paths-LdGS4SpR.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{profile--BYIjPkc.js → profile-Bsgzi9PA.js}

@@ -1,5 +1,5 @@
-import { a as projectOfCheckout, f as CheckoutGroups, o as groupCheckoutsAhead, s as initializeReviewStoreSchema, t as openLocalReviewStore } from "./local-data-C58vzLZR.js";
-import "./review-home-paths-LdGS4SpR.js";
+import { a as projectOfCheckout, f as CheckoutGroups, o as groupCheckoutsAhead, s as initializeReviewStoreSchema, t as openLocalReviewStore } from "./local-data-DdFkxFK_.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { j as withFileLock } from "./s3-config-CjcLyFV5.js";
 import { access, mkdir } from "node:fs/promises";
 import path from "node:path";

package/dist/profile-BxdzBxHW.js

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

package/dist/{remote-attach-C1prLjmj.js → remote-attach-LGTpwpUv.js}

@@ -1,7 +1,7 @@
-import { i as readReviewPackageVersion } from "./package-paths-Cg6fnaGp.js";
-import { a as readReviewServerHealth, l as serverNotReady } from "./server-discovery-WmuFl2S3.js";
-import { c as stopBackgroundServer, o as recordedBackgroundServer, r as ensureBackgroundServer } from "./background-server-eZWXoVcI.js";
-import { t as ensureRemoteLanguageServer } from "./remote-language-server-z3rdHcLL.js";
+import { i as readReviewPackageVersion } from "./package-paths-Dk7MOXxN.js";
+import { a as readReviewServerHealth, l as serverNotReady } from "./server-discovery-CV5qf1J8.js";
+import { c as stopBackgroundServer, o as recordedBackgroundServer, r as ensureBackgroundServer } from "./background-server-BraP8pJ9.js";
+import { t as ensureRemoteLanguageServer } from "./remote-language-server-BAznkpeu.js";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { gt, valid } from "semver";

package/dist/{remote-extensions-Bw029iIS.js → remote-extensions-BvV29_gk.js}

@@ -1,2 +1,2 @@
-import { t as ensureRemoteExtensions } from "./remote-extensions-MUUgbLJn.js";
+import { t as ensureRemoteExtensions } from "./remote-extensions-L95HNwIH.js";
 export { ensureRemoteExtensions };

package/dist/{remote-extensions-MUUgbLJn.js → remote-extensions-L95HNwIH.js}

@@ -1,7 +1,7 @@
 import { u as parseJsonText } from "./src-X9phtB2j.js";
-import "./review-home-paths-LdGS4SpR.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { N as devReviewHome } from "./s3-config-CjcLyFV5.js";
-import { t as findReviewPackageRoot } from "./package-paths-Cg6fnaGp.js";
+import { t as findReviewPackageRoot } from "./package-paths-Dk7MOXxN.js";
 import { createHash } from "node:crypto";
 import { z } from "zod";
 import { createReadStream, createWriteStream } from "node:fs";

package/dist/{remote-language-server-z3rdHcLL.js → remote-language-server-BAznkpeu.js}

@@ -1,8 +1,8 @@
-import "./review-home-paths-LdGS4SpR.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { A as processStartIdentity, j as withFileLock } from "./s3-config-CjcLyFV5.js";
-import { t as findReviewPackageRoot } from "./package-paths-Cg6fnaGp.js";
-import { n as cliSpawn, s as spawnDetached } from "./background-server-eZWXoVcI.js";
-import { r as remoteServerPaths, t as ensureRemoteExtensions } from "./remote-extensions-MUUgbLJn.js";
+import { t as findReviewPackageRoot } from "./package-paths-Dk7MOXxN.js";
+import { n as cliSpawn, s as spawnDetached } from "./background-server-BraP8pJ9.js";
+import { r as remoteServerPaths, t as ensureRemoteExtensions } from "./remote-extensions-L95HNwIH.js";
 import { randomBytes } from "node:crypto";
 import { z } from "zod";
 import { mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";

package/dist/{remote-uninstall-B3Slwor1.js → remote-uninstall-CLP79Cuk.js}

@@ -1,9 +1,9 @@
-import { C as REVIEW_REMOTE_INSTALL_LOCK, w as REVIEW_REMOTE_WRAPPER_MARK } from "./src-DLWol7GZ.js";
-import "./review-home-paths-LdGS4SpR.js";
+import { T as REVIEW_REMOTE_WRAPPER_MARK, w as REVIEW_REMOTE_INSTALL_LOCK } from "./src-CrrW7lcY.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { M as DEV_REVIEW_HOME_ENV } from "./s3-config-CjcLyFV5.js";
-import { c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-eZWXoVcI.js";
-import { i as whiteboardRemoteHome } from "./remote-extensions-MUUgbLJn.js";
-import { n as remoteLanguageServerGroups, r as stopProcessGroup } from "./remote-language-server-z3rdHcLL.js";
+import { c as stopBackgroundServer, o as recordedBackgroundServer } from "./background-server-BraP8pJ9.js";
+import { i as whiteboardRemoteHome } from "./remote-extensions-L95HNwIH.js";
+import { n as remoteLanguageServerGroups, r as stopProcessGroup } from "./remote-language-server-BAznkpeu.js";
 import { existsSync } from "node:fs";
 import { lstat, mkdir, readFile, readdir, rm, stat } from "node:fs/promises";
 import path from "node:path";

package/dist/{request-origin-B3_XI2VA.js → request-origin-D6B-zrL8.js}

@@ -1,7 +1,7 @@
 import { a as jsonNumber, c as jsonString, i as jsonBoolean, n as isJsonObject } from "./src-X9phtB2j.js";
-import { X as SELECTION_UNAVAILABLE_REASONS } from "./src-B2b8cCoI.js";
-import { _ as REVIEW_DIFF_LAYOUTS, g as REVIEW_COLOR_THEME_KINDS, v as REVIEW_DIFF_LAYOUT_SCOPES } from "./src-DLWol7GZ.js";
-import { n as askAgentIds } from "./thread-state-B7L1mpN_.js";
+import { X as SELECTION_UNAVAILABLE_REASONS } from "./src-BQDlJXkG.js";
+import { _ as REVIEW_DIFF_LAYOUTS, b as REVIEW_OPEN_FILES_IN_CHOICES, g as REVIEW_COLOR_THEME_KINDS, v as REVIEW_DIFF_LAYOUT_SCOPES } from "./src-CrrW7lcY.js";
+import { n as askAgentIds } from "./thread-state-WTqSborE.js";
 import { z } from "zod";
 //#region src/telemetry-clean-text.ts
 const USER_DATA_REGEXES = [
@@ -178,7 +178,8 @@ const LSP_VIA = ["command", "mouse"];
 const LSP_EDITOR_KIND = [
 	"files_tab",
 	"inline_peek",
-	"diff"
+	"diff",
+	"definition_peek"
 ];
 const LSP_LANGUAGE = [
 	"typescript",
@@ -297,6 +298,19 @@ const MAP_LEVEL = [
 	"code"
 ];
 const SOURCE_TREE_OPENED_VIA = ["topbar", "home"];
+const SOURCE_OPENED_DESTINATION = [
+	"source_window",
+	"vscode",
+	"cursor",
+	"zed",
+	"application"
+];
+const SOURCE_OPENED_KIND = [
+	"file",
+	"diff",
+	"references",
+	"tree"
+];
 /** Tab names the dwell beacon reports. Shared with its request parser. */
 const REVIEW_TELEMETRY_TABS = [
 	"review",
@@ -500,6 +514,13 @@ const UI_TELEMETRY_EVENTS = {
 		event: "review_source_tree_opened",
 		properties: { via: SOURCE_TREE_OPENED_VIA }
 	},
+	source_opened: {
+		event: "review_source_opened",
+		properties: {
+			destination: SOURCE_OPENED_DESTINATION,
+			kind: SOURCE_OPENED_KIND
+		}
+	},
 	whiteboard_file_exported: {
 		event: "review_whiteboard_file_exported",
 		properties: {}
@@ -644,7 +665,8 @@ const UI_TELEMETRY_EVENTS = {
 		properties: {
 			setting: SETTING_NAME,
 			enabled: "boolean",
-			value: REVIEW_COLOR_THEME_KINDS
+			value: REVIEW_COLOR_THEME_KINDS,
+			choice: REVIEW_OPEN_FILES_IN_CHOICES
 		}
 	},
 	review_opened: {

package/dist/{review-app-launcher-BZEbDKuK.js → review-app-launcher-tTe8bTwg.js}

@@ -1,5 +1,5 @@
-import { o as parseReviewVerbResponse } from "./src-DLWol7GZ.js";
-import { b as selectReviewInstance, m as healthyReviewInstance, v as reviewInstanceStartHint, y as reviewInstanceUnavailable } from "./server-discovery-WmuFl2S3.js";
+import { o as parseReviewVerbResponse } from "./src-CrrW7lcY.js";
+import { b as selectReviewInstance, m as healthyReviewInstance, v as reviewInstanceStartHint, y as reviewInstanceUnavailable } from "./server-discovery-CV5qf1J8.js";
 import { closeSync, existsSync, fstatSync, mkdtempSync, openSync, readSync } from "node:fs";
 import path from "node:path";
 import { homedir, tmpdir } from "node:os";

package/dist/{review-home-paths-LdGS4SpR.js → review-home-paths-BmZX2qiz.js}

@@ -379,7 +379,7 @@ async function runStoreLogin(input) {
 	};
 	let origin;
 	try {
-		origin = normalizeStoreOrigin(input.origin ?? DEFAULT_STORE_ORIGIN);
+		origin = normalizeStoreOrigin(input.origin || (input.env ?? process.env).DEV_REVIEW_SERVICE_ORIGIN || DEFAULT_STORE_ORIGIN);
 	} catch (error) {
 		return failWithJsonError(output, "login", errorMessage(error));
 	}

package/dist/{review-telemetry-x8u-9EZb.js → review-telemetry-DACDMfqq.js}

@@ -1,9 +1,9 @@
 import { c as jsonString, l as jsonValueSchema, o as jsonObject, u as parseJsonText } from "./src-X9phtB2j.js";
-import "./src-DLWol7GZ.js";
-import "./review-home-paths-LdGS4SpR.js";
+import "./src-CrrW7lcY.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { F as writeFileAtomic, N as devReviewHome, j as withFileLock, k as processIsAlive } from "./s3-config-CjcLyFV5.js";
-import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "./package-paths-Cg6fnaGp.js";
-import "./request-origin-B3_XI2VA.js";
+import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "./package-paths-Dk7MOXxN.js";
+import "./request-origin-D6B-zrL8.js";
 import { createHmac, randomUUID } from "node:crypto";
 import { z } from "zod";
 import { existsSync, readFileSync, rmSync } from "node:fs";

package/dist/server/desktop-host.js

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 import { S as splitGitPatchFiles, a as diff, o as diffFileSummaries } from "../src-Y30gweiK.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 { _ as readBoundedStream, d as legacyModeSchema, g as StreamLimitError } from "../import-YAIU6rB0.js";
-import { ot as ReviewInputError, y as resourceReferences } from "../src-B2b8cCoI.js";
-import { A as ReviewGatewayHostSchema, D as ReviewConnectRequestSchema, P as reviewDiffrSummarizerInputSchema, d as ReviewBugReportRequestSchema, f as parseReviewBugReportResponse, m as REVIEW_CLIENT_REMOTE, p as REVIEW_CLIENT_HEADER, r as parseReviewDesktopVerbFrame, s as parseZod, t as parseReviewCliInstallApplyRequest, u as ReviewBugReportMetaV2Schema, y as REVIEW_HOST_HEADER } from "../src-DLWol7GZ.js";
-import { i as reviewInstanceDiscoveryPath, o as reviewLegacyDiscoveryPath } from "../review-home-paths-LdGS4SpR.js";
-import { p as pullRequestProvider } from "../stored-document-migration-iwIQ4l5G.js";
+import { C as StreamLimitError, v as legacyModeSchema, w as readBoundedStream } from "../import-CZ1958L4.js";
+import { ot as ReviewInputError, y as resourceReferences } from "../src-BQDlJXkG.js";
+import { F as reviewDiffrSummarizerInputSchema, O as ReviewConnectRequestSchema, d as ReviewBugReportRequestSchema, f as parseReviewBugReportResponse, j as ReviewGatewayHostSchema, m as REVIEW_CLIENT_REMOTE, p as REVIEW_CLIENT_HEADER, r as parseReviewDesktopVerbFrame, s as parseZod, t as parseReviewCliInstallApplyRequest, u as ReviewBugReportMetaV2Schema, y as REVIEW_HOST_HEADER } from "../src-CrrW7lcY.js";
+import { i as reviewInstanceDiscoveryPath, o as reviewLegacyDiscoveryPath } from "../review-home-paths-BmZX2qiz.js";
+import { p as pullRequestProvider } from "../stored-document-migration-D1wK4yID.js";
 import { L as writePrivateJsonAtomic, N as devReviewHome } from "../s3-config-CjcLyFV5.js";
 import { t as errorMessage } from "../error-message-OtiDonty.js";
-import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "../package-paths-Cg6fnaGp.js";
-import { _ as reviewInstanceIdentity, u as REVIEW_INSTANCE_ENV } from "../server-discovery-WmuFl2S3.js";
-import { t as openReviewProfile } from "../profile--BYIjPkc.js";
-import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-x8u-9EZb.js";
-import { l as REVIEW_TELEMETRY_TABS } from "../request-origin-B3_XI2VA.js";
-import { c as removeLegacyReviewSkills, d as skipCliInstall, h as detectConnectAgents, i as finishCliInstallUpdate, l as resetCliInstall, m as connectAgent, n as applyCliInstall, o as pathShimPath, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-Bw3PT3Qo.js";
-import { C as setDiffrConfigValue, S as saveDiffrSummarizer, T as cliAskTools, _ as HttpJsonError, a as drainServerCrashReport, b as migrateDiffrConfig, c as answerErrorsAsJson, d as captureSanitizedUiTelemetry, f as clientErrorsForSession, g as DEFAULT_MAX_REQUEST_BYTES, h as readBoundedRequestJson, l as createWhiteboardCore, m as createNodeRequestListener, o as installProcessErrorTelemetry, p as recordClientError, r as takeOverServerHome, s as serverCrashReportPath, u as serverJson, v as ReviewServerError, w as testDiffrSummarizer, x as readDiffrConfig, y as GlobalReviewDesktopVerbRelay } from "../headless-host-Dl2KZ9IT.js";
-import { s as readQuerySchemas } from "../authoring-tools-CiLy46kh.js";
+import { i as readReviewPackageVersion, t as findReviewPackageRoot } from "../package-paths-Dk7MOXxN.js";
+import { _ as reviewInstanceIdentity, u as REVIEW_INSTANCE_ENV } from "../server-discovery-CV5qf1J8.js";
+import { t as openReviewProfile } from "../profile-Bsgzi9PA.js";
+import { r as reviewTelemetryChannel, t as ReviewTelemetry } from "../review-telemetry-DACDMfqq.js";
+import { l as REVIEW_TELEMETRY_TABS } from "../request-origin-D6B-zrL8.js";
+import { c as removeLegacyReviewSkills, d as skipCliInstall, h as detectConnectAgents, i as finishCliInstallUpdate, l as resetCliInstall, m as connectAgent, n as applyCliInstall, o as pathShimPath, r as declineCliInstall, s as removeCliInstall, t as aliasInstallationToAccount, u as resolveCliInstallStatus } from "../account-alias-BlYamXAG.js";
+import { C as DEFAULT_MAX_REQUEST_BYTES, D as writeAnimationsEnabled, E as readAnimationsEnabled, O as cliAskTools, S as readBoundedRequestJson, T as ReviewServerError, _ as saveDiffrSummarizer, a as drainServerCrashReport, b as remoteShare, c as answerErrorsAsJson, d as captureSanitizedUiTelemetry, f as clientErrorsForSession, g as readDiffrConfig, h as migrateDiffrConfig, l as createWhiteboardCore, m as GlobalReviewDesktopVerbRelay, o as installProcessErrorTelemetry, p as recordClientError, r as takeOverServerHome, s as serverCrashReportPath, u as serverJson, v as setDiffrConfigValue, w as HttpJsonError, x as createNodeRequestListener, y as testDiffrSummarizer } from "../headless-host-FAlbekFD.js";
+import { s as readQuerySchemas } from "../authoring-tools-CkfxTVJm.js";
 import crypto, { createHash, randomBytes } from "node:crypto";
 import { z } from "zod";
 import { Agent, request } from "undici";
@@ -264,30 +264,6 @@ function listenForDesktopHostShutdown(hostProcess, onShutdown, onTelemetrySettin
 	return () => hostProcess.off("message", handleMessage);
 }
 //#endregion
-//#region src/review-preferences.ts
-/**
-* Machine-wide Review preferences the server itself needs. Workbench settings
-* do not work here: the review server never reads the workbench
-* configuration.
-*/
-function reviewPreferencesPath(devHome = devReviewHome()) {
-	return path.join(devHome, "preferences.json");
-}
-/** Whether agents are offered animation authoring; existing animations
-* always render. A missing or unreadable file means off; it never throws. */
-async function readAnimationsEnabled(devHome) {
-	try {
-		const raw = parseJsonText(await readFile(reviewPreferencesPath(devHome), "utf8"));
-		return isJsonObject(raw) && raw.animationsEnabled === true;
-	} catch {
-		return false;
-	}
-}
-async function writeAnimationsEnabled(enabled, devHome) {
-	await writePrivateJsonAtomic(reviewPreferencesPath(devHome), { animationsEnabled: enabled });
-	return enabled;
-}
-//#endregion
 //#region src/server/crash-report.ts
 const CRASH_REPORT_URL = "https://bug.dev.fast/api/v2/crashes";
 const gzipAsync = promisify(gzip);
@@ -1730,6 +1706,11 @@ const REMOTE_ROUTES = [
 		method: "POST",
 		path: "copy-context"
 	},
+	{
+		method: "POST",
+		path: "share-bundle",
+		slow: true
+	},
 	{
 		method: "GET",
 		path: "language-context",
@@ -2130,6 +2111,7 @@ function createGlobalReviewServer(input) {
 		discovery.cliVersion = readReviewPackageVersion(pathToFileURL(cliPath).href);
 		if (input.cliRuntimePath && existsSync(input.cliRuntimePath)) discovery.cliRuntimePath = input.cliRuntimePath;
 	}
+	const hooks = reviewLifecycleTelemetry(telemetry, (reviewId) => reviewStore.summary(reviewId)?.firstCreatedAt, () => aliasInstallationToAccount(telemetry));
 	const core = createWhiteboardCore({
 		profile: {
 			store: reviewStore,
@@ -2153,7 +2135,13 @@ function createGlobalReviewServer(input) {
 				home: devReviewHome()
 			};
 		},
-		hooks: reviewLifecycleTelemetry(telemetry, (reviewId) => reviewStore.summary(reviewId)?.firstCreatedAt, () => aliasInstallationToAccount(telemetry)),
+		hooks: {
+			...hooks,
+			sharing: {
+				...hooks.sharing,
+				remoteShare: remoteShare((reviewId) => gateway.isRemote(reviewId), (request) => gateway.fetch(request))
+			}
+		},
 		ask: { tools: askTools }
 	});
 	const { app } = core;

package/dist/{server-discovery-WmuFl2S3.js → server-discovery-CV5qf1J8.js}

@@ -1,6 +1,6 @@
 import { a as jsonNumber, n as isJsonObject, s as jsonProperty, u as parseJsonText } from "./src-X9phtB2j.js";
-import { n as parseReviewDesktopDiscovery } from "./src-DLWol7GZ.js";
-import { a as reviewInstancesDir, o as reviewLegacyDiscoveryPath, r as reviewDevInstanceKey, t as reviewDefaultInstancePath } from "./review-home-paths-LdGS4SpR.js";
+import { n as parseReviewDesktopDiscovery } from "./src-CrrW7lcY.js";
+import { a as reviewInstancesDir, o as reviewLegacyDiscoveryPath, r as reviewDevInstanceKey, t as reviewDefaultInstancePath } from "./review-home-paths-BmZX2qiz.js";
 import { M as DEV_REVIEW_HOME_ENV, N as devReviewHome, k as processIsAlive } from "./s3-config-CjcLyFV5.js";
 import { z } from "zod";
 import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";

package/dist/sharing/index.d.ts

@@ -15,6 +15,7 @@ type JsonObject$1 = {
 };
 //#endregion
 //#region ../review-share-protocol/src/index.d.ts
+/** Unknown fields drop, so a reader opens bundles from newer sharers. */
 declare const shareBundleSchema: z.ZodObject<{
   format: z.ZodLiteral<"review-share/2">;
   reviewId: z.ZodString;
@@ -23,7 +24,7 @@ declare const shareBundleSchema: z.ZodObject<{
   snapshot: z.ZodRecord<z.ZodString, z.ZodUnknown>;
   images: z.ZodRecord<z.ZodString, z.ZodObject<{
     png: z.ZodBase64;
-  }, z.core.$strict>>;
+  }, z.core.$strip>>;
   traces: z.ZodRecord<z.ZodString, z.ZodUnknown>;
   maps: z.ZodRecord<z.ZodString, z.ZodUnknown>;
   commits: z.ZodArray<z.ZodUnknown>;
@@ -39,20 +40,53 @@ declare const shareBundleSchema: z.ZodObject<{
       repositoryId: z.ZodString;
       head: z.ZodString;
       base: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-  }, z.core.$strict>>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
   sources: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"excerpt">;
     file: z.ZodString;
     commit: z.ZodString;
     fromLine: z.ZodNumber;
     lines: z.ZodArray<z.ZodString>;
-  }, z.core.$strict>], "kind">>;
+  }, z.core.$strip>], "kind">>;
+  alignments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    file: z.ZodString;
+    previousFile: z.ZodOptional<z.ZodString>;
+    head: z.ZodString;
+    base: z.ZodOptional<z.ZodString>;
+    rows: z.ZodArray<z.ZodTuple<[z.ZodNullable<z.ZodNumber>, z.ZodNullable<z.ZodNumber>], null>>;
+  }, z.core.$strip>>>;
   repository: z.ZodOptional<z.ZodObject<{
     cloneUrl: z.ZodString;
-  }, z.core.$strict>>;
-}, z.core.$strict>;
+  }, z.core.$strip>>;
+  frozen: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
 type ShareBundle = z.infer<typeof shareBundleSchema>;
+declare const shareRevisionsSchema: z.ZodObject<{
+  latest: z.ZodUUID;
+  items: z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    version: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    size: z.ZodNumber;
+    url: z.ZodURL;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ShareRevisions = z.infer<typeof shareRevisionsSchema>;
+declare const sharedMetaSchema: z.ZodObject<{
+  sender: z.ZodObject<{
+    login: z.ZodString;
+  }, z.core.$strict>;
+  sharedAt: z.ZodNumber;
+  size: z.ZodNumber;
+  revision: z.ZodObject<{
+    id: z.ZodUUID;
+    version: z.ZodNumber;
+    createdAt: z.ZodNumber;
+  }, z.core.$strip>;
+  latest: z.ZodUUID;
+}, z.core.$strip>;
+type SharedMeta = z.infer<typeof sharedMetaSchema>;
 //#endregion
 //#region src/sharing/client.d.ts
 /** Account tokens go only to the configured API origin. */
@@ -76,8 +110,11 @@ declare class ShareClient {
     url: string;
   }>;
   revoke(shareId: string): Promise<JsonValue$1>;
-  /** The bundle and who shared it, read with the link's capability. */
-  download(capability: string): Promise<{
+  revisions(shareId: string): Promise<ShareRevisions>;
+  /** Who shared a link's revision, and which revision is its latest. */
+  shared(capability: string, revision?: string): Promise<SharedMeta>;
+  /** The bundle of the revision the meta names, and who shared it. */
+  download(capability: string, revision?: string): Promise<{
     bundle: {
       format: "review-share/2";
       reviewId: string;
@@ -108,14 +145,28 @@ declare class ShareClient {
         fromLine: number;
         lines: string[];
       }[];
+      alignments?: {
+        file: string;
+        head: string;
+        rows: [number | null, number | null][];
+        previousFile?: string | undefined;
+        base?: string | undefined;
+      }[] | undefined;
       repository?: {
         cloneUrl: string;
       } | undefined;
+      frozen?: true | undefined;
     };
     attribution: {
       login: string;
       sharedAt: number;
     };
+    revision: {
+      id: string;
+      version: number;
+      createdAt: number;
+    };
+    latest: string;
   }>;
 }
 //#endregion
@@ -1058,6 +1109,31 @@ declare const leafSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     head: z.ZodString;
     base: z.ZodOptional<z.ZodString>;
   }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"clip">;
+  id: z.ZodOptional<z.ZodString>;
+  title: z.ZodString;
+  html: z.ZodString;
+  markers: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strict>>;
+  scenarios: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+  }, z.core.$strict>>>;
+  code: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    source: z.ZodString;
+    label: z.ZodString;
+  }, z.core.$strict>]>>>;
+  height: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
+  pins: z.ZodOptional<z.ZodObject<{
+    repositoryId: z.ZodString;
+    head: z.ZodString;
+    base: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
 }, z.core.$strict>], "type">;
 type LeafBlock = z.infer<typeof leafSchema>;
 type Block = LeafBlock | SectionBlock | CalloutBlock;
@@ -1382,6 +1458,31 @@ declare const editSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       head: z.ZodString;
       base: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"clip">;
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    html: z.ZodString;
+    markers: z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      title: z.ZodString;
+      caption: z.ZodOptional<z.ZodString>;
+      code: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    scenarios: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+    }, z.core.$strict>>>;
+    code: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      source: z.ZodString;
+      label: z.ZodString;
+    }, z.core.$strict>]>>>;
+    height: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
+    pins: z.ZodOptional<z.ZodObject<{
+      repositoryId: z.ZodString;
+      head: z.ZodString;
+      base: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
   }, z.core.$strict>], "type">, z.ZodObject<{
     type: z.ZodLiteral<"section">;
     id: z.ZodOptional<z.ZodString>;
@@ -2109,6 +2210,11 @@ interface SharedProvenance {
   sharedAt?: number;
   cloneUrl?: string;
   key?: string;
+  revisionId?: string;
+  /** The version import wrote; anything later is the receiver's edit. */
+  importedVersion?: number;
+  /** Opened from a link naming a revision: never refreshed. */
+  pinned?: boolean;
 }
 /** Content a new board starts with, as another board left it. */
 interface Seed {
@@ -2308,8 +2414,12 @@ declare class ReviewStore {
   /** Forgets a checkout no board uses, after every write queued before it,
    * so a board being made with it keeps it. */
   unregisterRepository(id: string): Promise<void>;
-  /** The board copied from a share link, until it is deleted. */
-  copyOf(key: string): string | undefined;
+  /** The boards copied from a share link, newest first, until each is deleted. */
+  copiesOf(key: string): {
+    reviewId: string;
+    version: number;
+    shared: SharedProvenance;
+  }[];
   /** Checkouts whose remote is cloneUrl, most recently used first. */
   checkoutsOf(cloneUrl: string): string[];
   /** Registered checkouts, oldest registration first. */
@@ -2361,11 +2471,14 @@ declare class ReviewStore {
   history(id: string): HistoryEntry[];
   inspect(id: string, targetId?: string, version?: number): Element | {
     id: string | undefined;
-    type: "markdown" | "code" | "divider" | "code_peek" | "sequence" | "call_stack_diff" | "database_lens" | "image" | "trace_quote" | "software_map" | "flow_diagram" | "animation" | "step" | "flow_node" | "flow_edge" | "section" | "callout";
+    type: "markdown" | "code" | "divider" | "code_peek" | "sequence" | "call_stack_diff" | "database_lens" | "image" | "trace_quote" | "software_map" | "flow_diagram" | "animation" | "clip" | "step" | "flow_node" | "flow_edge" | "section" | "callout";
     label: string | undefined;
   }[];
   /** The host can seed a document; transport callers only supply a command. */
   execute(input: unknown, initial?: Seed, author?: Author): Promise<Result>;
+  /** Replaces a share copy's content under the same board id; 409 once it moved past `baseVersion`. */
+  refreshCopy(reviewId: string, baseVersion: number, create: unknown, seed: Seed): Promise<Result>;
+  private track;
   /** Resolve optional network context before entering the write queue. */
   private prepareCommand;
   private applyPreparedCommand;
@@ -2974,9 +3087,17 @@ declare function validateShareBundle(input: ShareBundle): {
       fromLine: number;
       lines: string[];
     }[];
+    alignments?: {
+      file: string;
+      head: string;
+      rows: [number | null, number | null][];
+      previousFile?: string | undefined;
+      base?: string | undefined;
+    }[] | undefined;
     repository?: {
       cloneUrl: string;
     } | undefined;
+    frozen?: true | undefined;
   };
   snapshot: {
     reviewId: string;
@@ -3111,8 +3232,10 @@ interface ShareImport {
   cloneRepository?: typeof cloneSharedRepository;
   onStage?: (stage: "fetching" | "validating") => void;
 }
-/** Imports a share as an ordinary board, once per link: the link's copy
- * comes back while it exists, even from Trash. */
-declare function importShare(input: ShareImport, key: string, received: ShareBundle, attribution?: ShareAttribution): Promise<string>;
+/** Imports a share as an ordinary board, or into a copy of its link. */
+declare function importShare(input: ShareImport, key: string, received: ShareBundle, provenance?: ShareAttribution & Pick<SharedProvenance, "revisionId" | "pinned">, into?: {
+  reviewId: string;
+  version: number;
+}): Promise<string>;
 //#endregion
 export { ShareClient, exportShare, importShare, shareKey, validateShareBundle };

package/dist/sharing/index.js

@@ -1,2 +1,2 @@
-import { c as ShareClient, i as validateShareBundle, l as exportShare, r as shareKey, t as importShare } from "../import-YAIU6rB0.js";
+import { a as shareKey, g as exportShare, o as validateShareBundle, t as importShare, u as ShareClient } from "../import-CZ1958L4.js";
 export { ShareClient, exportShare, importShare, shareKey, validateShareBundle };