@agimon-ai/doompi-author 0.0.1-alpha.14 → 0.0.1-alpha.16

package/dist/extensions/web.mjs

@@ -434,6 +434,9 @@ const TERMINAL_REQUEST_STATUSES = /* @__PURE__ */ new Set([
 const EMPTY_SESSION = {
 	generation: 0,
 	activeTool: "select",
+	annotationsByDocument: {},
+	annotations: [],
+	candidateText: "",
 	regions: [],
 	requests: []
 };
@@ -461,6 +464,46 @@ function authorSessionWorkspace(sessionId) {
 	if (sessionId === null) return EMPTY_SESSION;
 	return authorWorkspace.store.state.sessions[sessionId] ?? EMPTY_SESSION;
 }
+function hydrateAuthorAnnotationCollections(records) {
+	authorWorkspace.update((state) => {
+		let sessions = state.sessions;
+		for (const record of records) {
+			const path = normalizeAuthorPath(record.documentPath);
+			if (path === "") continue;
+			const session = sessions[record.sessionId] ?? EMPTY_SESSION;
+			const previous = session.annotationsByDocument[path];
+			if (previous !== void 0 && previous.updatedAt >= record.collection.updatedAt) continue;
+			const document = state.documents[authorDocumentKey(record.sessionId, path)];
+			const stale = record.collection.stale || document !== void 0 && (document.version !== record.collection.revision || document.sourceSha256 !== record.collection.sourceSha256);
+			const collection = restoreCollectionEvidence({
+				...record.collection,
+				stale
+			});
+			const visible = session.focusedDocument?.path === path && !stale;
+			const annotations = visible ? collection.annotations : session.annotations;
+			sessions = {
+				...sessions,
+				[record.sessionId]: {
+					...session,
+					annotationsByDocument: {
+						...session.annotationsByDocument,
+						[path]: collection
+					},
+					...visible ? {
+						annotations,
+						regions: annotations,
+						candidate: collection.candidate,
+						candidateText: collection.candidateText
+					} : {}
+				}
+			};
+		}
+		return sessions === state.sessions ? state : {
+			...state,
+			sessions
+		};
+	});
+}
 function putAuthorDocument(sessionId, input) {
 	const path = normalizeAuthorPath(input.path);
 	if (path === "") throw new Error("Author document path must not be empty");
@@ -484,9 +527,10 @@ function putAuthorDocument(sessionId, input) {
 		const session = state.sessions[sessionId];
 		let sessions = state.sessions;
 		if (sourceChanged && session?.focusedDocument?.path === path) {
-			staleThumbnails.push(...session.candidate?.thumbnailUrl === void 0 ? [] : [session.candidate.thumbnailUrl], ...session.regions.flatMap((region) => region.thumbnailUrl === void 0 ? [] : [region.thumbnailUrl]));
+			staleThumbnails.push(...session.candidate?.thumbnailUrl === void 0 ? [] : [session.candidate.thumbnailUrl], ...session.annotations.flatMap((annotation) => annotation.thumbnailUrl === void 0 ? [] : [annotation.thumbnailUrl]));
 			const now = Date.now();
 			const generation = session.generation + 1;
+			const staleCollection = staleAuthorCollection(session.annotationsByDocument[path], now);
 			sessions = {
 				...sessions,
 				[sessionId]: {
@@ -499,8 +543,14 @@ function putAuthorDocument(sessionId, input) {
 						sourceSha256: input.sourceSha256,
 						focusedAt: now
 					},
+					annotationsByDocument: {
+						...session.annotationsByDocument,
+						...staleCollection && { [path]: staleCollection }
+					},
+					annotations: [],
 					regions: [],
 					candidate: void 0,
+					candidateText: "",
 					requests: session.requests.map((request) => input.kind !== "story-preview" && request.documentPath === path && (request.status === "REQUESTED" || request.status === "CHANGING" || request.status === "CHANGED") ? {
 						...request,
 						status: "FAILED",
@@ -510,6 +560,20 @@ function putAuthorDocument(sessionId, input) {
 					} : request)
 				}
 			};
+		} else if (sourceChanged && session?.annotationsByDocument[path] !== void 0) {
+			const collection = session.annotationsByDocument[path];
+			if (collection.candidate?.thumbnailUrl !== void 0) staleThumbnails.push(collection.candidate.thumbnailUrl);
+			staleThumbnails.push(...collection.annotations.flatMap((annotation) => annotation.thumbnailUrl === void 0 ? [] : [annotation.thumbnailUrl]));
+			sessions = {
+				...sessions,
+				[sessionId]: {
+					...session,
+					annotationsByDocument: {
+						...session.annotationsByDocument,
+						[path]: staleAuthorCollection(collection, Date.now())
+					}
+				}
+			};
 		}
 		return {
 			documents: {
@@ -525,13 +589,13 @@ function putAuthorDocument(sessionId, input) {
 /** Claims focus and returns a generation token that makes cleanup race-safe. */
 function focusAuthorDocument(sessionId, path, revision, sourceSha256) {
 	const normalized = normalizeAuthorPath(path);
-	const staleThumbnails = [];
 	let generation = 0;
 	authorWorkspace.update((state) => {
 		const session = state.sessions[sessionId] ?? EMPTY_SESSION;
 		generation = session.generation + 1;
-		const keepRegions = session.focusedDocument?.path === normalized;
-		if (!keepRegions) staleThumbnails.push(...session.candidate?.thumbnailUrl === void 0 ? [] : [session.candidate.thumbnailUrl], ...session.regions.flatMap((region) => region.thumbnailUrl === void 0 ? [] : [region.thumbnailUrl]));
+		const stored = session.annotationsByDocument[normalized];
+		const current = stored !== void 0 && stored.revision === revision && stored.sourceSha256 === sourceSha256 && !stored.stale ? stored : void 0;
+		const annotations = current?.annotations ?? [];
 		return {
 			...state,
 			sessions: {
@@ -546,13 +610,14 @@ function focusAuthorDocument(sessionId, path, revision, sourceSha256) {
 						sourceSha256,
 						focusedAt: Date.now()
 					},
-					regions: keepRegions ? session.regions : [],
-					candidate: keepRegions ? session.candidate : void 0
+					annotations,
+					regions: annotations,
+					candidate: current?.candidate,
+					candidateText: current?.candidateText ?? ""
 				}
 			}
 		};
 	});
-	staleThumbnails.forEach(revokeThumbnail);
 	return generation;
 }
 function syncAuthorDocumentFocus(sessionId, generation, revision, sourceSha256) {
@@ -571,18 +636,17 @@ function syncAuthorDocumentFocus(sessionId, generation, revision, sourceSha256)
 	});
 }
 function releaseAuthorDocumentFocus(sessionId, generation) {
-	const staleThumbnails = [];
 	updateSession(sessionId, (session) => {
 		if (session.focusedDocument?.generation !== generation) return session;
-		staleThumbnails.push(...session.candidate?.thumbnailUrl === void 0 ? [] : [session.candidate.thumbnailUrl], ...session.regions.flatMap((region) => region.thumbnailUrl === void 0 ? [] : [region.thumbnailUrl]));
 		return {
 			...session,
 			focusedDocument: void 0,
 			candidate: void 0,
+			candidateText: "",
+			annotations: [],
 			regions: []
 		};
 	});
-	staleThumbnails.forEach(revokeThumbnail);
 }
 function seekAuthorVideo(sessionId, timeSeconds) {
 	const workspace = authorSessionWorkspace(sessionId);
@@ -614,51 +678,96 @@ function setAuthorRegionCandidate(sessionId, candidate) {
 			if (focused === void 0 || focused.path !== normalizeAuthorPath(candidate.documentPath)) throw new Error("The Author selection does not belong to the focused document.");
 			if (focused.revision !== candidate.revision || focused.sourceSha256 !== candidate.sourceSha256) throw new Error("The Author selection is stale for the focused document.");
 		}
+		if (focused === void 0) return session;
 		staleThumbnail = session.candidate?.thumbnailUrl;
-		return {
+		const copied = candidate === void 0 ? void 0 : copyCandidate(candidate);
+		return withFocusedCollection({
 			...session,
-			candidate: candidate === void 0 ? void 0 : structuredClone(candidate)
-		};
+			candidate: copied
+		}, focused.path, { candidate: copied });
 	});
 	if (staleThumbnail !== void 0 && staleThumbnail !== candidate?.thumbnailUrl) revokeThumbnail(staleThumbnail);
 }
+function setAuthorCandidateText(sessionId, candidateText) {
+	if (new TextEncoder().encode(candidateText).byteLength > 2048) throw new Error("Author candidate text must not exceed 2 KiB.");
+	updateSession(sessionId, (session) => {
+		const path = session.focusedDocument?.path;
+		return path === void 0 ? session : withFocusedCollection({
+			...session,
+			candidateText
+		}, path, { candidateText });
+	});
+}
 function commitAuthorRegion(sessionId, comment) {
 	const id = crypto.randomUUID();
 	const session = authorSessionWorkspace(sessionId);
-	if (session.candidate === void 0) throw new Error("Select a document region before adding a comment.");
+	if (session.candidate === void 0) throw new Error("Select a document annotation before adding a comment.");
 	addAuthorRegion(sessionId, {
 		...session.candidate,
 		id,
-		comment
+		comment,
+		version: 1
+	});
+	updateSession(sessionId, (current) => {
+		const path = current.focusedDocument?.path;
+		return path === void 0 ? current : withFocusedCollection({
+			...current,
+			candidate: void 0,
+			candidateText: ""
+		}, path, {
+			candidate: void 0,
+			candidateText: ""
+		});
 	});
-	updateSession(sessionId, (current) => ({
-		...current,
-		candidate: void 0
-	}));
 	return id;
 }
 function addAuthorRegion(sessionId, region) {
-	if (region.comment.trim() === "") throw new Error("Every Author region requires a comment.");
+	if (region.comment.trim() === "") throw new Error("Every Author annotation requires a comment.");
 	updateSession(sessionId, (session) => {
 		const focused = session.focusedDocument;
-		if (focused === void 0 || focused.path !== normalizeAuthorPath(region.documentPath)) throw new Error("The Author region does not belong to the focused document.");
-		if (focused.revision !== region.revision || focused.sourceSha256 !== region.sourceSha256) throw new Error("The Author region is stale for the focused document.");
-		if (session.regions.length >= 16) throw new Error(`Author requests support at most 16 regions.`);
-		if (session.regions.some((candidate) => candidate.id === region.id)) throw new Error(`Author region '${region.id}' already exists.`);
-		return {
+		if (focused === void 0 || focused.path !== normalizeAuthorPath(region.documentPath)) throw new Error("The Author annotation does not belong to the focused document.");
+		if (focused.revision !== region.revision || focused.sourceSha256 !== region.sourceSha256) throw new Error("The Author annotation is stale for the focused document.");
+		if (session.annotations.length >= 16) throw new Error(`Author requests support at most 16 annotations.`);
+		if (session.annotations.some((candidate) => candidate.id === region.id)) throw new Error(`Author annotation '${region.id}' already exists.`);
+		const annotations = [...session.annotations, copyRegion({
+			...region,
+			version: region.version ?? 1
+		})];
+		return withFocusedCollection({
 			...session,
-			regions: [...session.regions, copyRegion(region)]
-		};
+			annotations,
+			regions: annotations
+		}, focused.path, { annotations });
 	});
 }
-function removeAuthorRegion(sessionId, regionId) {
+function removeAuthorRegion(sessionId, regionId, expectedVersion, documentPath) {
 	let thumbnail;
 	updateSession(sessionId, (session) => {
-		thumbnail = session.regions.find((candidate) => candidate.id === regionId)?.thumbnailUrl;
-		const regions = session.regions.filter((candidate) => candidate.id !== regionId);
-		return regions.length === session.regions.length ? session : {
+		const path = documentPath === void 0 ? session.focusedDocument?.path : normalizeAuthorPath(documentPath);
+		if (path === void 0) return session;
+		const focused = session.focusedDocument?.path === path;
+		const collection = session.annotationsByDocument[path];
+		const current = focused ? session.annotations : collection?.annotations;
+		if (current === void 0) return session;
+		const annotation = current.find((candidate) => candidate.id === regionId);
+		if (annotation === void 0 || expectedVersion !== void 0 && (annotation.version ?? 1) !== expectedVersion) return session;
+		thumbnail = annotation.thumbnailUrl;
+		const annotations = current.filter((candidate) => candidate.id !== regionId);
+		if (focused) return withFocusedCollection({
+			...session,
+			annotations,
+			regions: annotations
+		}, path, { annotations });
+		return {
 			...session,
-			regions
+			annotationsByDocument: {
+				...session.annotationsByDocument,
+				[path]: {
+					...collection,
+					annotations,
+					updatedAt: Date.now()
+				}
+			}
 		};
 	});
 	if (thumbnail !== void 0) revokeThumbnail(thumbnail);
@@ -774,10 +883,12 @@ function completeAuthorSave(sessionId, path, sourceSha256, savedVersion, savedFr
 function dropAuthorSession(sessionId) {
 	const prefix = `${sessionId}\n`;
 	const session = authorWorkspace.store.state.sessions[sessionId];
-	if (session?.candidate?.thumbnailUrl !== void 0) revokeThumbnail(session.candidate.thumbnailUrl);
-	session?.regions.forEach((region) => {
-		if (region.thumbnailUrl !== void 0) revokeThumbnail(region.thumbnailUrl);
-	});
+	for (const collection of Object.values(session?.annotationsByDocument ?? {})) {
+		if (collection.candidate?.thumbnailUrl !== void 0) revokeThumbnail(collection.candidate.thumbnailUrl);
+		collection.annotations.forEach((annotation) => {
+			if (annotation.thumbnailUrl !== void 0) revokeThumbnail(annotation.thumbnailUrl);
+		});
+	}
 	authorWorkspace.update((state) => {
 		const sessions = { ...state.sessions };
 		delete sessions[sessionId];
@@ -787,6 +898,12 @@ function dropAuthorSession(sessionId) {
 		};
 	});
 }
+function setAuthorStoryPreview(sessionId, path, storyPreview) {
+	updateDocument(sessionId, path, (document) => ({
+		...document,
+		storyPreview: structuredClone(storyPreview)
+	}));
+}
 function updateDocument(sessionId, path, update) {
 	const key = authorDocumentKey(sessionId, path);
 	const staleThumbnails = [];
@@ -797,7 +914,8 @@ function updateDocument(sessionId, path, update) {
 		const session = state.sessions[sessionId];
 		const focused = session?.focusedDocument;
 		const identityChanged = focused?.path === document.path && (focused.revision !== next.version || focused.sourceSha256 !== next.sourceSha256);
-		if (identityChanged) staleThumbnails.push(...session.candidate?.thumbnailUrl === void 0 ? [] : [session.candidate.thumbnailUrl], ...session.regions.flatMap((region) => region.thumbnailUrl === void 0 ? [] : [region.thumbnailUrl]));
+		if (identityChanged) staleThumbnails.push(...session.candidate?.thumbnailUrl === void 0 ? [] : [session.candidate.thumbnailUrl], ...session.annotations.flatMap((annotation) => annotation.thumbnailUrl === void 0 ? [] : [annotation.thumbnailUrl]));
+		const staleCollection = identityChanged ? staleAuthorCollection(session.annotationsByDocument[document.path], Date.now()) : void 0;
 		const sessions = identityChanged ? {
 			...state.sessions,
 			[sessionId]: {
@@ -807,7 +925,13 @@ function updateDocument(sessionId, path, update) {
 					revision: next.version,
 					sourceSha256: next.sourceSha256
 				},
+				annotationsByDocument: {
+					...session.annotationsByDocument,
+					...staleCollection && { [document.path]: staleCollection }
+				},
 				candidate: void 0,
+				candidateText: "",
+				annotations: [],
 				regions: []
 			}
 		} : state.sessions;
@@ -834,16 +958,60 @@ function updateSession(sessionId, update) {
 		};
 	});
 }
-function copyRegion(region) {
-	const anchor = "rect" in region.anchor ? {
-		...region.anchor,
-		rect: { ...region.anchor.rect }
-	} : { ...region.anchor };
+function copyCandidate(candidate) {
+	const anchor = "rect" in candidate.anchor ? {
+		...candidate.anchor,
+		rect: { ...candidate.anchor.rect }
+	} : "point" in candidate.anchor ? {
+		...candidate.anchor,
+		point: { ...candidate.anchor.point }
+	} : { ...candidate.anchor };
 	return {
-		...region,
+		...candidate,
 		anchor,
-		viewport: { ...region.viewport },
-		voiceGrid: region.voiceGrid && { ...region.voiceGrid }
+		viewport: { ...candidate.viewport },
+		voiceGrid: candidate.voiceGrid && { ...candidate.voiceGrid }
+	};
+}
+function copyRegion(region) {
+	return copyCandidate(region);
+}
+function staleAuthorCollection(collection, updatedAt) {
+	if (collection === void 0) return void 0;
+	return {
+		...collection,
+		stale: true,
+		candidate: collection.candidate && {
+			...copyCandidate(collection.candidate),
+			thumbnailUrl: void 0
+		},
+		annotations: collection.annotations.map((annotation) => ({
+			...copyRegion(annotation),
+			thumbnailUrl: void 0
+		})),
+		updatedAt
+	};
+}
+function withFocusedCollection(session, path, update) {
+	const focused = session.focusedDocument;
+	if (focused === void 0 || focused.path !== path) return session;
+	const collection = {
+		...session.annotationsByDocument[path],
+		revision: focused.revision,
+		sourceSha256: focused.sourceSha256,
+		stale: false,
+		candidate: session.candidate,
+		candidateText: session.candidateText,
+		annotations: session.annotations,
+		updatedAt: Date.now(),
+		...update
+	};
+	return {
+		...session,
+		annotationsByDocument: {
+			...session.annotationsByDocument,
+			[path]: collection
+		}
 	};
 }
 function boundedHistoryText(value) {
@@ -873,6 +1041,30 @@ function boundHistory(records) {
 	}
 	return next;
 }
+function restoreCollectionEvidence(collection) {
+	const restore = (item) => {
+		const copied = copyCandidate(item);
+		const existingVersion = Reflect.get(copied, "version");
+		const versioned = "id" in copied ? {
+			...copied,
+			version: typeof existingVersion === "number" ? existingVersion : 1
+		} : copied;
+		if (versioned.thumbnailUrl !== void 0 || versioned.evidence === void 0) return versioned;
+		try {
+			return {
+				...versioned,
+				thumbnailUrl: URL.createObjectURL(versioned.evidence)
+			};
+		} catch {
+			return versioned;
+		}
+	};
+	return {
+		...collection,
+		candidate: collection.candidate && restore(collection.candidate),
+		annotations: collection.annotations.map(restore)
+	};
+}
 function revokeThumbnail(url) {
 	if (!url.startsWith("blob:")) return;
 	try {
@@ -1053,6 +1245,8 @@ function createAuthorCapturePacket(captureId, capturedAt, document, regions) {
 				id: region.id,
 				ordinal: index + 1,
 				comment: region.comment,
+				version: region.version ?? 1,
+				mode: region.mode ?? ("point" in region.anchor ? "point" : "region"),
 				...region.quote === void 0 ? {} : { quote: utf8Prefix(region.quote, AUTHOR_QUOTE_MAX_BYTES) },
 				anchor: structuredClone(region.anchor),
 				viewport: { ...region.viewport },
@@ -1063,8 +1257,10 @@ function createAuthorCapturePacket(captureId, capturedAt, document, regions) {
 	if (bytes(JSON.stringify(packet)) > 65536) throw new Error("Author capture packet exceeds 64 KiB.");
 	return packet;
 }
+function percent(value) {
+	return `${String(Math.round(value * 1e3) / 10)}%`;
+}
 function rectLocation(rect) {
-	const percent = (value) => `${String(Math.round(value * 1e3) / 10)}%`;
 	return `x ${percent(rect.x)}, y ${percent(rect.y)}, w ${percent(rect.width)}, h ${percent(rect.height)}`;
 }
 function anchorLocation(anchor) {
@@ -1076,6 +1272,10 @@ function anchorLocation(anchor) {
 		case "pdf-page-rect": return `page ${String(anchor.page)}, ${rectLocation(anchor.rect)}`;
 		case "video-time-rect": return `time ${anchor.timeSeconds.toFixed(3)}s${anchor.frame === void 0 ? "" : `, frame ${String(anchor.frame)}`}, ${rectLocation(anchor.rect)}`;
 		case "story-preview-rect": return `story preview ${rectLocation(anchor.rect)}`;
+		case "image-point": return `image point x ${percent(anchor.point.x)}, y ${percent(anchor.point.y)}`;
+		case "pdf-page-point": return `page ${String(anchor.page)}, point x ${percent(anchor.point.x)}, y ${percent(anchor.point.y)}`;
+		case "video-time-point": return `time ${anchor.timeSeconds.toFixed(3)}s, point x ${percent(anchor.point.x)}, y ${percent(anchor.point.y)}`;
+		case "story-preview-point": return `story preview point x ${percent(anchor.point.x)}, y ${percent(anchor.point.y)}`;
 	}
 }
 function storyPreviewProvenance(packet) {
@@ -1103,7 +1303,7 @@ function authorCaptureContext(packet) {
 		kind: "author-capture",
 		source: "author",
 		id: packet.captureId,
-		label: `${packet.regions.length} region${packet.regions.length === 1 ? "" : "s"} · ${packet.document.path}`,
+		label: `${packet.regions.length} annotation${packet.regions.length === 1 ? "" : "s"} · ${packet.document.path}`,
 		content,
 		metadata
 	};
@@ -1208,6 +1408,19 @@ function multiRegionCaptureProvider(regions) {
 					context.strokeRect(rx, ry, rw, rh);
 					labelX = rx;
 					labelY = ry;
+				} else if ("point" in region.anchor) {
+					const px = drawX + region.anchor.point.x * drawWidth;
+					const py = drawY + region.anchor.point.y * drawHeight;
+					const radius = Math.max(6, Math.min(14, Math.min(drawWidth, drawHeight) / 12));
+					context.beginPath();
+					context.arc(px, py, radius, 0, Math.PI * 2);
+					context.fillStyle = annotationColor;
+					context.fill();
+					context.strokeStyle = annotationForeground(annotationColor);
+					context.lineWidth = 2;
+					context.stroke();
+					labelX = px + radius;
+					labelY = py - radius;
 				}
 			}
 			const ordinal = String(index + 1);
@@ -1235,32 +1448,35 @@ function multiRegionCaptureProvider(regions) {
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/dock/_components/AuthorRegionDrafts.tsx
 function AuthorRegionDrafts({ sessionId, workspace }) {
-	const [comment, setComment] = useState("");
 	const [error, setError] = useState();
 	const add = () => {
 		try {
-			commitAuthorRegion(sessionId, comment);
-			setComment("");
+			commitAuthorRegion(sessionId, workspace.candidateText);
 			setError(void 0);
 		} catch (reason) {
 			setError(reason instanceof Error ? reason.message : String(reason));
 		}
 	};
-	if (!workspace.candidate && workspace.regions.length === 0) return null;
+	if (!workspace.candidate && workspace.annotations.length === 0) return null;
+	const candidateKind = workspace.candidate?.mode === "point" ? "point" : "region";
 	return /* @__PURE__ */ jsxs("section", {
 		className: "space-y-2",
 		"data-testid": "author-region-drafts",
 		children: [
 			workspace.candidate ? /* @__PURE__ */ jsxs(Fragment, { children: [
-				/* @__PURE__ */ jsx("h3", {
+				/* @__PURE__ */ jsxs("h3", {
 					className: "text-base font-semibold text-doom-text",
-					children: "Current selection"
+					children: ["Current ", candidateKind]
 				}),
-				/* @__PURE__ */ jsx("p", {
+				/* @__PURE__ */ jsxs("p", {
 					className: "text-base text-doom-dim sm:text-sm",
-					children: "Add a comment to keep this selection as an unsent draft."
+					children: [
+						"Add feedback to keep this ",
+						candidateKind,
+						" as an unsent annotation."
+					]
 				}),
-				workspace.candidate.anchor.kind === "video-time-rect" ? /* @__PURE__ */ jsxs("p", {
+				workspace.candidate.anchor.kind === "video-time-rect" || workspace.candidate.anchor.kind === "video-time-point" ? /* @__PURE__ */ jsxs("p", {
 					className: "text-base text-doom-dim sm:text-sm",
 					children: [
 						"Frame at ",
@@ -1269,9 +1485,9 @@ function AuthorRegionDrafts({ sessionId, workspace }) {
 					]
 				}) : null,
 				/* @__PURE__ */ jsx("textarea", {
-					"aria-label": "Region comment",
-					value: comment,
-					onChange: (event) => setComment(event.target.value),
+					"aria-label": "Annotation comment",
+					value: workspace.candidateText,
+					onChange: (event) => setAuthorCandidateText(sessionId, event.target.value),
 					placeholder: "What should change here?",
 					rows: 3,
 					className: "min-h-11 w-full resize-y rounded border border-doom-border bg-doom-deep p-2 text-lg leading-normal text-doom-text focus:border-doom-red focus:outline-none sm:text-sm"
@@ -1280,49 +1496,51 @@ function AuthorRegionDrafts({ sessionId, workspace }) {
 					className: "min-h-11 min-w-11 text-base [@media(pointer:fine)]:min-h-8 sm:text-sm",
 					variant: "outline",
 					onClick: add,
-					disabled: !workspace.candidate || !comment.trim() || workspace.regions.length >= 16,
-					children: "add region"
+					disabled: !workspace.candidate || !workspace.candidateText.trim() || workspace.annotations.length >= 16,
+					children: "add annotation"
 				}),
 				/* @__PURE__ */ jsx(Button, {
 					variant: "ghost",
 					className: "min-h-11 min-w-11 text-base [@media(pointer:fine)]:min-h-8 sm:text-sm",
 					onClick: () => {
 						setAuthorRegionCandidate(sessionId, void 0);
-						setComment("");
+						setAuthorCandidateText(sessionId, "");
 						setError(void 0);
 					},
-					children: "Discard selection"
+					children: "Discard annotation"
 				})
 			] }) : null,
 			error ? /* @__PURE__ */ jsx("output", {
 				className: "block text-base text-doom-red",
 				children: error
 			}) : null,
-			workspace.regions.length > 0 ? /* @__PURE__ */ jsxs("h3", {
+			workspace.annotations.length > 0 ? /* @__PURE__ */ jsxs("h3", {
 				className: "text-base font-semibold text-doom-text",
 				children: [
-					"Unsent drafts (",
-					workspace.regions.length,
+					"Unsent annotations (",
+					workspace.annotations.length,
 					")"
 				]
 			}) : null,
 			/* @__PURE__ */ jsx("ol", {
 				className: "space-y-2",
-				children: workspace.regions.map((region, index) => /* @__PURE__ */ jsxs("li", {
+				children: workspace.annotations.map((region, index) => /* @__PURE__ */ jsxs("li", {
 					className: "rounded border border-doom-border bg-doom-panel p-2 text-base leading-normal text-doom-text sm:text-sm",
 					children: [
 						/* @__PURE__ */ jsxs("span", { children: [
 							"(",
 							index + 1,
 							") ",
+							region.mode === "point" ? "Point" : "Region",
+							": ",
 							region.comment
 						] }),
-						region.anchor.kind === "video-time-rect" ? /* @__PURE__ */ jsxs(Button, {
+						region.anchor.kind === "video-time-rect" || region.anchor.kind === "video-time-point" ? /* @__PURE__ */ jsxs(Button, {
 							variant: "outline",
 							className: "min-h-11 min-w-11 text-base [@media(pointer:fine)]:min-h-8 sm:text-sm",
 							disabled: workspace.candidate !== void 0,
 							onClick: () => {
-								if (region.anchor.kind === "video-time-rect") seekAuthorVideo(sessionId, region.anchor.timeSeconds);
+								if (region.anchor.kind === "video-time-rect" || region.anchor.kind === "video-time-point") seekAuthorVideo(sessionId, region.anchor.timeSeconds);
 							},
 							children: [
 								"Go to ",
@@ -1333,7 +1551,7 @@ function AuthorRegionDrafts({ sessionId, workspace }) {
 						/* @__PURE__ */ jsx(Button, {
 							className: "min-h-11 min-w-11 text-base [@media(pointer:fine)]:min-h-8 sm:text-sm",
 							variant: "ghost",
-							"aria-label": `Remove region ${index + 1}`,
+							"aria-label": `Remove annotation ${index + 1}`,
 							onClick: () => removeAuthorRegion(sessionId, region.id),
 							children: "remove"
 						})
@@ -1377,18 +1595,22 @@ function anchorLabel(anchor) {
 		case "pdf-page-rect": return `Page ${anchor.page}`;
 		case "video-time-rect": return `Video ${Math.floor(anchor.timeSeconds / 60)}:${Math.floor(anchor.timeSeconds % 60).toString().padStart(2, "0")}`;
 		case "story-preview-rect": return `${anchor.preview.storyPath}#${anchor.preview.storyExport}`;
+		case "image-point": return "Image point";
+		case "pdf-page-point": return `Page ${anchor.page} point`;
+		case "video-time-point": return `Video ${Math.floor(anchor.timeSeconds / 60)}:${Math.floor(anchor.timeSeconds % 60).toString().padStart(2, "0")} point`;
+		case "story-preview-point": return `${anchor.preview.storyPath}#${anchor.preview.storyExport} point`;
 	}
 }
 function progressLabel(request) {
 	const total = request.regions.length;
 	const pending = request.pendingRegions?.length;
 	if (request.status === "CHANGING" && request.currentOperation === "Agent is working on this request") return "Processing request";
-	if (request.status === "CHANGING" && pending !== void 0) return `${total - pending} of ${total} regions applied`;
+	if (request.status === "CHANGING" && pending !== void 0) return `${total - pending} of ${total} annotations applied`;
 	if (request.status === "CHANGED") return "Changes applied · awaiting save";
 	if (request.status === "COMPLETE") return "Agent finished processing this request";
 	if (request.status === "FAILED") return "Stopped with an error";
 	if (request.status === "CANCELLED") return "Stopped before completion";
-	return `${total} region${total === 1 ? "" : "s"} queued`;
+	return `${total} annotation${total === 1 ? "" : "s"} queued`;
 }
 function RequestRecord({ request, prominent = false }) {
 	const instruction = requestInstruction(request.requestText);
@@ -1591,8 +1813,9 @@ function AuthorToolPalette({ sessionId, kind, activeTool }) {
 		] : [],
 		{
 			label: "Comment",
-			glyph: "□",
-			action: () => setAuthorToolMode(sessionId, "mark")
+			glyph: "●",
+			action: () => setAuthorToolMode(sessionId, activeTool === "comment" ? "select" : "comment"),
+			active: activeTool === "comment"
 		}
 	];
 	return /* @__PURE__ */ jsxs("section", {
@@ -1623,7 +1846,7 @@ function AuthorToolPalette({ sessionId, kind, activeTool }) {
 			}),
 			/* @__PURE__ */ jsx("p", {
 				className: "text-base leading-normal text-doom-dim sm:text-sm",
-				children: activeTool === "mark" ? "Drag over the document to mark a region." : "Choose Region to mark an area for a comment."
+				children: activeTool === "mark" ? "Drag over the document to mark a region." : activeTool === "comment" ? "Click the document to place a comment pin." : "Choose Region to drag an area, or Comment to place a point."
 			}),
 			error ? /* @__PURE__ */ jsx("output", {
 				className: "block text-base text-doom-red",
@@ -1661,7 +1884,7 @@ function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses, ren
 				}),
 				/* @__PURE__ */ jsx("p", {
 					className: "text-base leading-normal text-doom-dim sm:text-sm",
-					children: "Select a region, add a comment, then submit here. Requests queue while the agent is working."
+					children: "Drag a region or place a point, add feedback, then submit here. Requests queue while the agent is working."
 				}),
 				focused.kind === "video" ? /* @__PURE__ */ jsx("p", {
 					className: "text-base text-doom-dim sm:text-sm",
@@ -1687,7 +1910,7 @@ function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses, ren
 					sessionId,
 					workspace
 				}, focused.path),
-				workspace.regions.length > 0 ? /* @__PURE__ */ jsxs("div", {
+				workspace.annotations.length > 0 ? /* @__PURE__ */ jsxs("div", {
 					className: "space-y-1.5 border-b border-doom-border-soft pb-3",
 					children: [/* @__PURE__ */ jsx(Button, {
 						className: "min-h-11 min-w-11 w-full text-base [@media(pointer:fine)]:min-h-8 sm:text-sm",
@@ -1699,9 +1922,9 @@ function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses, ren
 							setCapturing(true);
 							setCaptureStatus("Submitting annotations…");
 							try {
-								const packet = createAuthorCapturePacket(crypto.randomUUID(), Date.now(), focused, workspace.regions);
+								const packet = createAuthorCapturePacket(crypto.randomUUID(), Date.now(), focused, workspace.annotations);
 								await submitCapture({
-									...await multiRegionCaptureProvider(workspace.regions).capture(),
+									...await multiRegionCaptureProvider(workspace.annotations).capture(),
 									context: authorCaptureContext(packet)
 								});
 								setCaptureStatus("Request submitted. You can keep annotating here.");
@@ -1711,10 +1934,10 @@ function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses, ren
 								setCapturing(false);
 							}
 						},
-						children: capturing ? "Submitting…" : `Submit ${workspace.regions.length} annotation${workspace.regions.length === 1 ? "" : "s"}`
+						children: capturing ? "Submitting…" : `Submit ${workspace.annotations.length} annotation${workspace.annotations.length === 1 ? "" : "s"}`
 					}), workspace.candidate ? /* @__PURE__ */ jsx("p", {
 						className: "text-base text-doom-dim sm:text-sm",
-						children: "Add or discard the current selection before submitting."
+						children: "Add or discard the current annotation before submitting."
 					}) : null]
 				}) : null,
 				submitCapture === void 0 ? /* @__PURE__ */ jsx("output", {
@@ -2733,16 +2956,24 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 		start.current = void 0;
 		if (!drag) return;
 		const bounds = drag.element.getBoundingClientRect();
-		const rect = normalizedAuthorRectangle(bounds, {
+		if (bounds.width <= 0 || bounds.height <= 0) return;
+		const point = {
+			x: Math.min(1, Math.max(0, (event.clientX - bounds.left) / bounds.width)),
+			y: Math.min(1, Math.max(0, (event.clientY - bounds.top) / bounds.height))
+		};
+		const rect = drag.mode === "mark" ? normalizedAuthorRectangle(bounds, {
 			left: drag.x,
 			top: drag.y,
 			right: event.clientX,
 			bottom: event.clientY
-		});
-		if (!rect) return;
-		setSelection({
+		}) : void 0;
+		if (drag.mode === "mark" && !rect) return;
+		setSelection(drag.mode === "mark" ? {
 			path: source.path,
 			rect
+		} : {
+			path: source.path,
+			point
 		});
 		const focused = authorSessionWorkspace(sessionId).focusedDocument;
 		if (!focused || focused.path !== source.path) return;
@@ -2753,11 +2984,16 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 			if (drag.element instanceof HTMLImageElement) {
 				const image = drag.element;
 				if (!image.naturalWidth || !image.naturalHeight) throw new Error("Image is not ready.");
-				anchor = {
+				anchor = drag.mode === "mark" ? {
 					kind: "image-rect",
 					rect,
 					naturalWidth: image.naturalWidth,
 					naturalHeight: image.naturalHeight
+				} : {
+					kind: "image-point",
+					point,
+					naturalWidth: image.naturalWidth,
+					naturalHeight: image.naturalHeight
 				};
 				const canvas = document.createElement("canvas");
 				const scale = Math.min(1, 1600 / Math.max(image.naturalWidth, image.naturalHeight));
@@ -2770,21 +3006,31 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 			} else if (source.kind === "pdf") {
 				const page = pdf.current?.getState();
 				if (!page?.sourceWidth) throw new Error("PDF page is not ready.");
-				anchor = {
+				anchor = drag.mode === "mark" ? {
 					kind: "pdf-page-rect",
 					page: page.page,
 					rect
+				} : {
+					kind: "pdf-page-point",
+					page: page.page,
+					point
 				};
 				blob = await pdf.current.capturePage();
 			} else {
 				const frame = await video.current?.captureFrame();
 				if (!frame) throw new Error("Video frame is not ready.");
-				anchor = {
+				anchor = drag.mode === "mark" ? {
 					kind: "video-time-rect",
 					rect,
 					timeSeconds: frame.timeSeconds,
 					intrinsicWidth: frame.width,
 					intrinsicHeight: frame.height
+				} : {
+					kind: "video-time-point",
+					point,
+					timeSeconds: frame.timeSeconds,
+					intrinsicWidth: frame.width,
+					intrinsicHeight: frame.height
 				};
 				blob = frame.blob;
 			}
@@ -2795,12 +3041,14 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 				documentPath: source.path,
 				revision: source.version,
 				sourceSha256: source.sourceSha256,
+				mode: drag.mode === "mark" ? "region" : "point",
 				anchor,
 				viewport: {
 					width: bounds.width,
 					height: bounds.height
 				},
 				thumbnailUrl,
+				evidence: blob,
 				createdAt: Date.now()
 			});
 			setError(void 0);
@@ -2810,6 +3058,7 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 		}
 	};
 	const selected = selection?.path === source.path ? selection.rect : void 0;
+	const selectedPoint = selection?.path === source.path ? selection.point : void 0;
 	const selectionOverlay = selected === void 0 ? null : /* @__PURE__ */ jsx("div", {
 		"data-testid": "author-media-selection",
 		className: "pointer-events-none absolute border-2 border-doom-red bg-doom-red/10",
@@ -2820,6 +3069,17 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 			height: `${selected.height * 100}%`
 		}
 	});
+	const pointPin = (ordinal, point, key) => /* @__PURE__ */ jsx("span", {
+		"data-author-point": ordinal,
+		"data-testid": ordinal === void 0 ? "author-media-point-selection" : void 0,
+		className: `pointer-events-none absolute z-10 flex h-5 min-w-5 -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-full border-2 px-1 text-2xs font-bold ${ordinal === void 0 ? "border-white bg-doom-red text-white" : "border-doom-deep bg-doom-yellow text-doom-deep"}`,
+		style: {
+			left: `${String(point.x * 100)}%`,
+			top: `${String(point.y * 100)}%`
+		},
+		children: ordinal ?? "•"
+	}, key);
+	const pointSelectionOverlay = selectedPoint === void 0 ? null : pointPin(void 0, selectedPoint, "selection");
 	return /* @__PURE__ */ jsxs("div", {
 		ref: host,
 		className: "min-h-0 flex-1 overflow-auto p-4",
@@ -2829,7 +3089,7 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 		},
 		onPointerMove: (event) => {
 			const drag = start.current;
-			if (drag === void 0) return;
+			if (drag === void 0 || drag.mode !== "mark") return;
 			const rect = normalizedAuthorRectangle(drag.element.getBoundingClientRect(), {
 				left: drag.x,
 				top: drag.y,
@@ -2842,7 +3102,7 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 			});
 		},
 		onPointerDownCapture: (event) => {
-			if (activeTool === "select" || event.button !== 0 || pendingCandidate) return;
+			if (activeTool !== "mark" && activeTool !== "comment" || event.button !== 0 || pendingCandidate) return;
 			const element = event.target;
 			if (!(element instanceof HTMLImageElement || element instanceof HTMLVideoElement || element instanceof HTMLCanvasElement)) return;
 			event.preventDefault();
@@ -2857,6 +3117,7 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 			start.current = {
 				x: event.clientX,
 				y: event.clientY,
+				mode: activeTool,
 				element
 			};
 			event.currentTarget.setPointerCapture(event.pointerId);
@@ -2881,7 +3142,9 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 						className: "block max-w-full"
 					}),
 					selectionOverlay,
+					pointSelectionOverlay,
 					displayedRegions.flatMap(({ ordinal, region }) => {
+						if (region.anchor.kind === "image-point") return [pointPin(ordinal, region.anchor.point, region.id)];
 						if (region.anchor.kind !== "image-rect") return [];
 						const { rect } = region.anchor;
 						return [/* @__PURE__ */ jsx("div", {
@@ -2917,9 +3180,32 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 							if (state.playing) setSelection(void 0);
 						}
 					}),
-					source.kind === "video" ? selectionOverlay : null,
-					source.kind === "video" ? displayedRegions.map(({ ordinal, region }) => {
-						if (region.anchor.kind !== "video-time-rect" || playback.playing || Math.abs(region.anchor.timeSeconds - playback.currentTime) > .1) return null;
+					selectionOverlay,
+					pointSelectionOverlay,
+					displayedRegions.map(({ ordinal, region }) => {
+						if (source.kind === "pdf") {
+							if (region.anchor.kind !== "pdf-page-point" && region.anchor.kind !== "pdf-page-rect") return null;
+							if (region.anchor.page !== pdf.current?.getState().page) return null;
+							if (region.anchor.kind === "pdf-page-point") return pointPin(ordinal, region.anchor.point, region.id);
+							const { rect } = region.anchor;
+							return /* @__PURE__ */ jsx("div", {
+								"data-author-region": ordinal,
+								className: "pointer-events-none absolute border border-doom-yellow bg-doom-yellow/10",
+								style: {
+									left: `${String(rect.x * 100)}%`,
+									top: `${String(rect.y * 100)}%`,
+									width: `${String(rect.width * 100)}%`,
+									height: `${String(rect.height * 100)}%`
+								},
+								children: /* @__PURE__ */ jsx("span", {
+									className: "bg-doom-yellow text-doom-deep",
+									children: ordinal
+								})
+							}, region.id);
+						}
+						if (source.kind !== "video" || playback.playing) return null;
+						if (region.anchor.kind === "video-time-point" && Math.abs(region.anchor.timeSeconds - playback.currentTime) <= .1) return pointPin(ordinal, region.anchor.point, region.id);
+						if (region.anchor.kind !== "video-time-rect" || Math.abs(region.anchor.timeSeconds - playback.currentTime) > .1) return null;
 						const { rect } = region.anchor;
 						return /* @__PURE__ */ jsx("div", {
 							"data-author-region": ordinal,
@@ -2935,7 +3221,7 @@ function AuthorMediaView({ sessionId, document: source, activeTool, displayedReg
 								children: ordinal
 							})
 						}, region.id);
-					}) : null
+					})
 				]
 			}),
 			source.kind === "video" ? /* @__PURE__ */ jsx(AuthorVideoControls, {
@@ -3267,6 +3553,20 @@ function ActiveAuthorDocumentPanel(props) {
 	};
 	const gridVisible = autonomousVoiceGridVisible(statuses);
 	const displayedRegions = displayedAuthorRegions(workspace);
+	const displayedPreviewAnnotations = displayedRegions.flatMap(({ ordinal, region }) => {
+		if (region.anchor.kind === "story-preview-rect") return [{
+			ordinal,
+			mode: "region",
+			point: region.anchor.rect,
+			rect: region.anchor.rect
+		}];
+		if (region.anchor.kind === "story-preview-point") return [{
+			ordinal,
+			mode: "point",
+			point: region.anchor.point
+		}];
+		return [];
+	});
 	const textPanel = /* @__PURE__ */ jsx(AuthorTextView, {
 		sessionId,
 		document,
@@ -3333,7 +3633,32 @@ function ActiveAuthorDocumentPanel(props) {
 				className: "relative flex min-h-0 flex-1 overflow-hidden",
 				children: [previewOpen && PreviewPanel !== void 0 && previewSource !== void 0 ? /* @__PURE__ */ jsx(PreviewPanel, {
 					...props,
-					source: previewSource
+					source: previewSource,
+					activeTool: activeTool === "crop" ? "select" : activeTool,
+					displayedAnnotations: displayedPreviewAnnotations,
+					pendingCandidate: workspace?.candidate !== void 0,
+					onAnnotationCandidate: (candidate) => {
+						setAuthorStoryPreview(sessionId, document.path, candidate.preview);
+						setAuthorRegionCandidate(sessionId, {
+							documentPath: document.path,
+							revision: document.version,
+							sourceSha256: document.sourceSha256,
+							mode: candidate.mode,
+							anchor: candidate.mode === "region" && candidate.rect !== void 0 ? {
+								kind: "story-preview-rect",
+								rect: candidate.rect,
+								preview: candidate.preview
+							} : {
+								kind: "story-preview-point",
+								point: candidate.point,
+								preview: candidate.preview
+							},
+							viewport: candidate.preview.viewport,
+							evidence: candidate.evidence,
+							thumbnailUrl: candidate.thumbnailUrl,
+							createdAt: Date.now()
+						});
+					}
 				}) : sourcePanel, previewOpen && PreviewPanel !== void 0 && previewSource !== void 0 ? null : /* @__PURE__ */ jsx(AuthorGridOverlay, {
 					sessionId,
 					document,
@@ -3395,6 +3720,157 @@ var author_toggle_web_default = defineLeaderBinding({
 	command: "minor author"
 });
 //#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_lib/authorAnnotationPersistence.ts
+const AUTHOR_ANNOTATION_DATABASE = "doompi-author-annotations";
+const STORE = "documents";
+const RECORD_VERSION = 1;
+function object(value) {
+	return typeof value === "object" && value !== null;
+}
+function finite(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+function point(value) {
+	return object(value) && finite(value.x) && finite(value.y) && value.x >= 0 && value.x <= 1 && value.y >= 0 && value.y <= 1;
+}
+function rect(value) {
+	return point(value) && object(value) && finite(value.width) && finite(value.height) && value.width > 0 && value.height > 0;
+}
+function validAnchor(value) {
+	if (!object(value) || typeof value.kind !== "string") return false;
+	switch (value.kind) {
+		case "text-range": return finite(value.startOffset) && finite(value.endOffset) && finite(value.startLine) && finite(value.endLine);
+		case "cell": return typeof value.fragmentId === "string" && typeof value.location === "string";
+		case "slide-element": return typeof value.fragmentId === "string" && finite(value.slide) && typeof value.location === "string";
+		case "image-rect": return rect(value.rect) && finite(value.naturalWidth) && finite(value.naturalHeight);
+		case "pdf-page-rect": return finite(value.page) && rect(value.rect);
+		case "video-time-rect": return finite(value.timeSeconds) && rect(value.rect);
+		case "story-preview-rect": return rect(value.rect) && object(value.preview);
+		case "image-point": return point(value.point) && finite(value.naturalWidth) && finite(value.naturalHeight);
+		case "pdf-page-point": return finite(value.page) && point(value.point);
+		case "video-time-point": return finite(value.timeSeconds) && point(value.point);
+		case "story-preview-point": return point(value.point) && object(value.preview);
+		default: return false;
+	}
+}
+function validEvidence(value) {
+	return value === void 0 || typeof Blob !== "undefined" && value instanceof Blob && value.size <= 8388608;
+}
+function validCandidate(value) {
+	if (!object(value)) return false;
+	return typeof value.documentPath === "string" && normalizeAuthorPath(value.documentPath) !== "" && finite(value.revision) && (value.sourceSha256 === void 0 || typeof value.sourceSha256 === "string") && (value.mode === void 0 || value.mode === "region" || value.mode === "point") && validAnchor(value.anchor) && object(value.viewport) && finite(value.viewport.width) && finite(value.viewport.height) && finite(value.createdAt) && validEvidence(value.evidence);
+}
+function validAnnotation(value) {
+	return validCandidate(value) && object(value) && typeof value.id === "string" && value.id !== "" && typeof value.comment === "string" && value.comment.trim() !== "" && (value.version === void 0 || Number.isInteger(value.version) && value.version >= 1);
+}
+function utf8Length(value) {
+	return new TextEncoder().encode(value).byteLength;
+}
+function validateAuthorAnnotationRecord(input) {
+	if (!object(input) || input.version !== RECORD_VERSION || typeof input.key !== "string") return void 0;
+	if (typeof input.sessionId !== "string" || input.sessionId === "" || typeof input.documentPath !== "string") return void 0;
+	const path = normalizeAuthorPath(input.documentPath);
+	if (path === "" || input.key !== `${input.sessionId}\n${path}` || !object(input.collection)) return void 0;
+	const collection = input.collection;
+	if (!finite(collection.revision) || collection.sourceSha256 !== void 0 && typeof collection.sourceSha256 !== "string" || typeof collection.stale !== "boolean" || typeof collection.candidateText !== "string" || utf8Length(collection.candidateText) > 2048 || !Array.isArray(collection.annotations) || collection.annotations.length > 16 || !collection.annotations.every(validAnnotation) || collection.candidate !== void 0 && !validCandidate(collection.candidate) || !finite(collection.updatedAt)) return void 0;
+	return input;
+}
+function durableCandidate(candidate) {
+	const { thumbnailUrl: _thumbnailUrl, ...durable } = candidate;
+	return durable;
+}
+function persistenceRecords() {
+	const records = [];
+	for (const [sessionId, session] of Object.entries(authorWorkspace.store.state.sessions)) for (const [documentPath, collection] of Object.entries(session.annotationsByDocument)) {
+		if (collection.annotations.length === 0 && collection.candidate === void 0 && collection.candidateText === "") continue;
+		records.push({
+			key: `${sessionId}\n${documentPath}`,
+			version: RECORD_VERSION,
+			sessionId,
+			documentPath,
+			collection: {
+				...collection,
+				candidate: collection.candidate && durableCandidate(collection.candidate),
+				annotations: collection.annotations.map(durableCandidate)
+			}
+		});
+	}
+	return records.sort((a, b) => b.collection.updatedAt - a.collection.updatedAt).slice(0, 100);
+}
+var IndexedDbAuthorAnnotationRepository = class {
+	#database;
+	#writes = Promise.resolve();
+	constructor(factory) {
+		this.#database = new Promise((resolve, reject) => {
+			const request = factory.open(AUTHOR_ANNOTATION_DATABASE, 1);
+			request.onupgradeneeded = () => {
+				if (!request.result.objectStoreNames.contains(STORE)) request.result.createObjectStore(STORE, { keyPath: "key" });
+			};
+			request.onsuccess = () => resolve(request.result);
+			request.onerror = () => reject(request.error ?? /* @__PURE__ */ new Error("Unable to open Author annotation storage."));
+		});
+	}
+	async load() {
+		const database = await this.#database;
+		return await new Promise((resolve, reject) => {
+			const request = database.transaction(STORE, "readonly").objectStore(STORE).getAll();
+			request.onsuccess = () => resolve(request.result);
+			request.onerror = () => reject(request.error ?? /* @__PURE__ */ new Error("Unable to read Author annotations."));
+		});
+	}
+	replace(records) {
+		const write = async () => {
+			const database = await this.#database;
+			await new Promise((resolve, reject) => {
+				const transaction = database.transaction(STORE, "readwrite");
+				const store = transaction.objectStore(STORE);
+				store.clear();
+				records.forEach((record) => store.put(record));
+				transaction.oncomplete = () => resolve();
+				transaction.onerror = () => reject(transaction.error ?? /* @__PURE__ */ new Error("Unable to write Author annotations."));
+				transaction.onabort = () => reject(transaction.error ?? /* @__PURE__ */ new Error("Author annotation write was aborted."));
+			});
+		};
+		this.#writes = this.#writes.catch(() => void 0).then(write);
+		return this.#writes;
+	}
+	async close() {
+		try {
+			await this.#writes;
+		} finally {
+			(await this.#database).close();
+		}
+	}
+};
+function startAuthorAnnotationPersistence(repository) {
+	const factory = typeof indexedDB === "undefined" ? void 0 : indexedDB;
+	if (repository === void 0 && factory === void 0) return async () => void 0;
+	const storage = repository ?? new IndexedDbAuthorAnnotationRepository(factory);
+	let stopped = false;
+	let hydrated = false;
+	let dirty = false;
+	const subscription = authorWorkspace.store.subscribe(() => {
+		if (!hydrated) dirty = true;
+		else storage.replace(persistenceRecords()).catch(() => void 0);
+	});
+	storage.load().then((values) => {
+		if (stopped) return;
+		const records = values.map(validateAuthorAnnotationRecord).filter((record) => record !== void 0).sort((a, b) => b.collection.updatedAt - a.collection.updatedAt).slice(0, 100);
+		hydrateAuthorAnnotationCollections(records);
+		hydrated = true;
+		if (dirty || records.length > 0) storage.replace(persistenceRecords()).catch(() => void 0);
+	}).catch(() => {
+		if (stopped) return;
+		hydrated = true;
+		if (dirty) storage.replace(persistenceRecords()).catch(() => void 0);
+	});
+	return async () => {
+		stopped = true;
+		subscription.unsubscribe();
+		await storage.close();
+	};
+}
+//#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/lifecycle/_lib/authorRequestLifecycle.ts
 function capturePacket(content) {
 	try {
@@ -3417,6 +3893,8 @@ function recordAuthorComposerSubmission(submission) {
 			revision: packet.document.revision,
 			sourceSha256: packet.document.sourceSha256,
 			comment: region.comment,
+			version: region.version ?? 1,
+			mode: region.mode,
 			quote: region.quote,
 			anchor: structuredClone(region.anchor),
 			viewport: { ...region.viewport },
@@ -3436,7 +3914,7 @@ function recordAuthorComposerSubmission(submission) {
 			revision: packet.document.revision,
 			sourceSha256: packet.document.sourceSha256
 		});
-		for (const region of packet.regions) removeAuthorRegion(submission.sessionId, region.id);
+		for (const region of packet.regions) removeAuthorRegion(submission.sessionId, region.id, region.version ?? 1, packet.document.path);
 	}
 }
 /** Only the host's correlated execution events may settle a submitted capture. */
@@ -3461,12 +3939,14 @@ function recordAuthorCaptureStatus(event) {
 //#region src/extensions/workspaces/sessions/(frontend)/lifecycle/_lib/authorBrowserLifecycle.ts
 function startAuthorBrowserLifecycle(runtime) {
 	const stopBridge = startAuthorBrowserBridge(runtime);
+	const stopPersistence = startAuthorAnnotationPersistence();
 	const stopSubmissions = runtime.onComposerSubmitted?.(recordAuthorComposerSubmission) ?? (() => void 0);
 	const stopCaptureStatus = runtime.onCaptureStatus?.(recordAuthorCaptureStatus) ?? (() => void 0);
-	return () => {
+	return async () => {
 		stopSubmissions();
 		stopCaptureStatus();
 		stopBridge();
+		await stopPersistence().catch(() => void 0);
 	};
 }
 //#endregion
@@ -3575,13 +4055,18 @@ function resultPath(result) {
 	if (typeof result?.details !== "object" || result.details === null || !("path" in result.details)) return void 0;
 	return typeof result.details.path === "string" ? result.details.path : void 0;
 }
-function OpenAuthoringFileToolCard({ args, result, running, isError, openTransientTab, openTab }) {
+function OpenAuthoringFileToolCard({ args, result, running, isError, output, openTransientTab, openTab }) {
 	const path = resultPath(result);
+	const unavailable = !running && !isError && result !== null && path === void 0;
+	const errorLines = isError ? (output ?? "").trim().split(/\r?\n/u).filter(Boolean).slice(0, 4).map((text) => ({
+		text,
+		tone: "error"
+	})) : [];
 	const requestedPath = typeof args.path === "string" ? args.path : "document";
 	return /* @__PURE__ */ jsx(MessageItem, {
 		tone: toolTone({
 			running,
-			isError
+			isError: isError || unavailable
 		}),
 		children: () => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(MessageItemHeader, {
 			title: "open_authoring_file",
@@ -3592,16 +4077,21 @@ function OpenAuthoringFileToolCard({ args, result, running, isError, openTransie
 			})
 		}), /* @__PURE__ */ jsxs(MessageItemBody, {
 			"data-testid": "tool-result-open_authoring_file",
-			children: [/* @__PURE__ */ jsx(MessageItemStatus, {
-				tone: isError ? "error" : running ? "running" : void 0,
-				children: isError ? "failed" : running ? "validating" : path === void 0 ? "waiting" : "ready"
-			}), !running && !isError && path !== void 0 ? /* @__PURE__ */ jsx(Button, {
-				size: "xs",
-				variant: "outline",
-				"data-testid": "author-open-file",
-				onClick: () => openAuthoringFileTab(path, openTransientTab, openTab),
-				children: "open in Author"
-			}) : null]
+			className: "flex flex-col gap-1",
+			children: [
+				errorLines.length > 0 ? /* @__PURE__ */ jsx(MessageLines, { lines: errorLines }) : null,
+				/* @__PURE__ */ jsx(MessageItemStatus, {
+					tone: isError || unavailable ? "error" : running ? "running" : void 0,
+					children: isError ? "failed" : running ? "validating" : unavailable ? "unavailable" : path === void 0 ? "waiting" : "ready"
+				}),
+				!running && !isError && path !== void 0 ? /* @__PURE__ */ jsx(Button, {
+					size: "xs",
+					variant: "outline",
+					"data-testid": "author-open-file",
+					onClick: () => openAuthoringFileTab(path, openTransientTab, openTab),
+					children: "open in Author"
+				}) : null
+			]
 		})] })
 	});
 }
@@ -3609,7 +4099,11 @@ function OpenAuthoringFileToolCard({ args, result, running, isError, openTransie
 //#region src/extensions/workspaces/sessions/(frontend)/tool/open-authoring-file.web.tsx
 var open_authoring_file_web_default = defineToolRenderer({
 	tools: ["open_authoring_file"],
-	message: OpenAuthoringFileToolCard
+	message: OpenAuthoringFileToolCard,
+	completionTab: ({ result }) => {
+		const path = resultPath(result);
+		return path === void 0 ? void 0 : authorFileTab(path);
+	}
 });
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/tool/_lib/useAuthorToolsToolRender.ts