@agimon-ai/po-author 0.0.0-alpha.40 → 0.0.0-alpha.41

package/dist/extensions/web.mjs

@@ -606,6 +606,118 @@ function resolveAuthorGridCell(sessionId, cell, expectedGeometryToken) {
 		}
 	};
 }
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_lib/authorMarkdownText.ts
+const HEADING = /^#{1,6} /;
+const LIST_ITEM = /^(?:[-*+]|\d+[.)]) /;
+/**
+* One formatting edit for the selected source range. Bold, Heading and List toggle off when already applied;
+* Heading and List apply to every touched line and replace each other.
+*/
+function authorMarkdownFormat(content, from, to, format) {
+	if (format === "bold") {
+		const selected = content.slice(from, to);
+		if (selected.length >= 4 && selected.startsWith("**") && selected.endsWith("**")) return {
+			from,
+			to,
+			insert: selected.slice(2, -2),
+			select: {
+				from,
+				to: to - 4
+			}
+		};
+		if (from >= 2 && content.slice(from - 2, from) === "**" && content.slice(to, to + 2) === "**") return {
+			from: from - 2,
+			to: to + 2,
+			insert: selected,
+			select: {
+				from: from - 2,
+				to: to - 2
+			}
+		};
+		const text = selected || "bold text";
+		return {
+			from,
+			to,
+			insert: `**${text}**`,
+			select: {
+				from: from + 2,
+				to: from + 2 + text.length
+			}
+		};
+	}
+	if (format === "link") {
+		const text = content.slice(from, to) || "link text";
+		const url = from + text.length + 3;
+		return {
+			from,
+			to,
+			insert: `[${text}](https://)`,
+			select: {
+				from: url,
+				to: url + 8
+			}
+		};
+	}
+	const start = content.lastIndexOf("\n", from - 1) + 1;
+	const last = to > from && content[to - 1] === "\n" ? to - 1 : to;
+	const lineEnd = content.indexOf("\n", Math.max(last, start));
+	const end = lineEnd === -1 ? content.length : lineEnd;
+	const own = format === "heading" ? HEADING : LIST_ITEM;
+	const prefix = format === "heading" ? "## " : "- ";
+	const lines = content.slice(start, end).split("\n");
+	const written = lines.filter((line) => line.trim() !== "");
+	const remove = written.length > 0 && written.every((line) => own.test(line));
+	const insert = lines.map((line) => line.trim() === "" ? line : remove ? line.replace(own, "") : prefix + line.replace(HEADING, "").replace(LIST_ITEM, "")).join("\n");
+	return {
+		from: start,
+		to: end,
+		insert,
+		select: {
+			from: start,
+			to: start + insert.length
+		}
+	};
+}
+/**
+* Moves a source range through one edit from `before` to `after`. Text typed just outside the range stays
+* outside; text replaced inside it widens the range to the new text, so a note follows the passage it names.
+*/
+function rebaseTextRange(before, after, start, end) {
+	const limit = Math.min(before.length, after.length);
+	let prefix = 0;
+	while (prefix < limit && before[prefix] === after[prefix]) prefix += 1;
+	let suffix = 0;
+	while (suffix < limit - prefix && before[before.length - 1 - suffix] === after[after.length - 1 - suffix]) suffix += 1;
+	const changedEnd = before.length - suffix;
+	const delta = after.length - before.length;
+	const startAt = start < prefix ? start : start >= changedEnd ? start + delta : prefix;
+	const endAt = end <= prefix ? end : end >= changedEnd ? end + delta : after.length - suffix;
+	return {
+		start: startAt,
+		end: Math.max(startAt, endAt)
+	};
+}
+/**
+* Where each rendered text run starts in the Markdown source, searched in reading order.
+* Undefined when a run is blank or not verbatim source (entities, generated labels).
+*/
+function locateRenderedRuns(source, runs) {
+	let cursor = 0;
+	return runs.map((run) => {
+		if (run.trim() === "") return void 0;
+		const whole = source.indexOf(run, cursor);
+		const first = run.trimStart().split("\n")[0];
+		const at = whole === -1 ? source.indexOf(first, cursor) : whole;
+		if (at === -1) return void 0;
+		cursor = at + (whole === -1 ? first.length : run.length);
+		return at;
+	});
+}
+/** One-based source line of an offset. */
+function authorSourceLine(source, offset) {
+	return source.slice(0, offset).split("\n").length;
+}
 const TERMINAL_REQUEST_STATUSES = /* @__PURE__ */ new Set([
 	"COMPLETE",
 	"FAILED",
@@ -749,28 +861,40 @@ function putAuthorDocument(sessionId, input) {
 	staleThumbnails.forEach(revokeThumbnail);
 	return result;
 }
-/** Claims focus and returns a generation token that makes cleanup race-safe. */
+/**
+* Claims focus and returns a generation token that makes cleanup race-safe.
+* Claims stack: a popup review over a document tab hands focus back to the tab
+* when it closes, so the Author dock face stays for the document still shown.
+*/
 function focusAuthorDocument(sessionId, path) {
 	let generation = 0;
 	updateSession(sessionId, (session) => {
 		generation = session.generation + 1;
+		const focusedDocument = {
+			path: normalizeAuthorPath(path),
+			generation,
+			focusedAt: Date.now()
+		};
 		return {
 			...session,
 			generation,
-			focusedDocument: {
-				path: normalizeAuthorPath(path),
-				generation,
-				focusedAt: Date.now()
-			}
+			focusedDocument,
+			focusClaims: [...session.focusClaims ?? [], focusedDocument]
 		};
 	});
 	return generation;
 }
 function releaseAuthorDocumentFocus(sessionId, generation) {
-	updateSession(sessionId, (session) => session.focusedDocument?.generation === generation ? {
-		...session,
-		focusedDocument: void 0
-	} : session);
+	updateSession(sessionId, (session) => {
+		const claims = session.focusClaims ?? [];
+		if (!claims.some((claim) => claim.generation === generation)) return session;
+		const focusClaims = claims.filter((claim) => claim.generation !== generation);
+		return {
+			...session,
+			focusedDocument: focusClaims.at(-1),
+			focusClaims
+		};
+	});
 }
 function seekAuthorVideo(sessionId, path, timeSeconds) {
 	const normalized = normalizeAuthorPath(path);
@@ -1017,12 +1141,14 @@ function updateDocument(sessionId, path, update) {
 		const next = update(document);
 		const session = state.sessions[sessionId];
 		const identityChanged = document.version !== next.version || document.sourceSha256 !== next.sourceSha256;
-		const collection = identityChanged ? session?.annotationsByDocument[document.path] : void 0;
+		const current = identityChanged ? session?.annotationsByDocument[document.path] : void 0;
+		const rebased = current && rebaseTextCollection(current, document, next);
+		const collection = rebased === void 0 ? current : void 0;
 		if (collection !== void 0) {
 			if (collection.candidate?.thumbnailUrl !== void 0) staleThumbnails.push(collection.candidate.thumbnailUrl);
 			staleThumbnails.push(...collection.annotations.flatMap((annotation) => annotation.thumbnailUrl === void 0 ? [] : [annotation.thumbnailUrl]));
 		}
-		const staleCollection = identityChanged ? staleAuthorCollection(collection, Date.now()) : void 0;
+		const staleCollection = rebased ?? (identityChanged ? staleAuthorCollection(collection, Date.now()) : void 0);
 		const sessions = identityChanged && session !== void 0 ? {
 			...state.sessions,
 			[sessionId]: {
@@ -1091,6 +1217,40 @@ function staleAuthorCollection(collection, updatedAt) {
 		updatedAt
 	};
 }
+/**
+* Carries unsent text notes through a local edit or save instead of dropping them: each range follows its
+* passage and its quote is re-read. Undefined when the collection is already stale or holds a non-text anchor.
+*/
+function rebaseTextCollection(collection, before, after) {
+	if (collection.stale || collection.revision !== before.version || collection.sourceSha256 !== before.sourceSha256 || before.content === void 0 || after.content === void 0) return void 0;
+	if ([...collection.annotations, ...collection.candidate ? [collection.candidate] : []].some((item) => item.anchor.kind !== "text-range")) return void 0;
+	const source = after.content;
+	const rebase = (item) => {
+		const anchor = item.anchor;
+		const { start, end } = rebaseTextRange(before.content, source, anchor.startOffset, anchor.endOffset);
+		return {
+			...copyCandidate(item),
+			revision: after.version,
+			sourceSha256: after.sourceSha256,
+			quote: source.slice(start, end),
+			anchor: {
+				...anchor,
+				startOffset: start,
+				endOffset: end,
+				startLine: authorSourceLine(source, start),
+				endLine: authorSourceLine(source, end)
+			}
+		};
+	};
+	return {
+		...collection,
+		revision: after.version,
+		sourceSha256: after.sourceSha256,
+		candidate: collection.candidate && rebase(collection.candidate),
+		annotations: collection.annotations.map(rebase),
+		updatedAt: Date.now()
+	};
+}
 function updateCollection(sessionId, path, update) {
 	const normalized = normalizeAuthorPath(path);
 	const document = authorDocument(sessionId, normalized);
@@ -1172,7 +1332,9 @@ function revokeThumbnail(url) {
 	if (!url.startsWith("blob:")) return;
 	try {
 		URL.revokeObjectURL(url);
-	} catch {}
+	} catch (error) {
+		console.warn(`Author could not release a thumbnail: ${error instanceof Error ? error.message : String(error)}`);
+	}
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/channel/_lib/authorStore.ts
@@ -1217,11 +1379,6 @@ var author_webmcp_web_default = defineChannelFile({
 	}
 });
 //#endregion
-//#region src/constants/author.ts
-const AUTHOR_FILE_TAB_PREFIX = "author-file-";
-/** Names a file in the session's artifact folder rather than the working tree. Artifacts open read-only. */
-const AUTHOR_ARTIFACT_PREFIX = "artifact:";
-//#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/_components/AuthorGridOverlay.tsx
 function autonomousVoiceGridVisible(statuses) {
 	return statuses["po-voice"]?.trimStart().startsWith("voice auto:") === true;
@@ -1690,6 +1847,10 @@ function AuthorRegionDrafts({ sessionId, path, drafts }) {
 						" as an unsent annotation."
 					]
 				}),
+				drafts.candidate.quote ? /* @__PURE__ */ jsx("blockquote", {
+					className: "line-clamp-3 border-l-2 border-po-edge-magenta pl-2 text-base text-po-text sm:text-sm",
+					children: drafts.candidate.quote
+				}) : null,
 				drafts.candidate.anchor.kind === "video-time-rect" || drafts.candidate.anchor.kind === "video-time-point" ? /* @__PURE__ */ jsxs("p", {
 					className: "text-base text-po-dim sm:text-sm",
 					children: [
@@ -1761,8 +1922,8 @@ function AuthorRegionDrafts({ sessionId, path, drafts }) {
 								}),
 								region.comment,
 								/* @__PURE__ */ jsx("span", {
-									className: "block text-sm text-po-dim",
-									children: region.mode === "point" ? "Point" : "Region"
+									className: "line-clamp-2 block text-sm text-po-dim",
+									children: region.quote ? `“${region.quote}”` : region.mode === "point" ? "Point" : "Region"
 								})
 							]
 						}),
@@ -2067,6 +2228,191 @@ function AuthorRequestLog({ requests }) {
 	});
 }
 //#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/dock/_components/AuthorToolPalette.tsx
+/** One tool tile. An active annotation tool is the person's mark (rose); an active view tool is Po's jade. */
+function authorToolClassName(active, annotates) {
+	return `h-auto min-h-11 min-w-11 flex-col gap-1 rounded-md px-1 py-2 text-base [@media(pointer:fine)]:min-h-8 ${!active ? "border-po-border-soft bg-po-panel text-po-dim" : annotates ? "border-po-edge-magenta bg-po-tint-magenta font-semibold text-po-magenta hover:text-po-magenta" : "border-po-edge-green bg-po-tint-green font-semibold text-po-green hover:text-po-green"}`;
+}
+function AuthorToolPalette({ sessionId, path, kind, activeTool }) {
+	const text = kind === "markdown" || kind === "text";
+	const tools = [
+		...[
+			"image",
+			"pdf",
+			"video",
+			"story-preview"
+		].includes(kind) ? [{
+			label: "Pan",
+			glyph: "✋",
+			action: () => setAuthorToolMode(sessionId, path, activeTool === "pan" ? "select" : "pan"),
+			active: activeTool === "pan",
+			annotates: false
+		}] : [],
+		...[
+			"image",
+			"pdf",
+			"video",
+			"story-preview",
+			"html"
+		].includes(kind) ? [{
+			label: "Draw",
+			glyph: "✎",
+			action: () => setAuthorToolMode(sessionId, path, activeTool === "draw" ? "select" : "draw"),
+			active: activeTool === "draw",
+			annotates: true
+		}] : [],
+		{
+			label: "Region",
+			glyph: "⌗",
+			action: () => setAuthorToolMode(sessionId, path, activeTool === "mark" ? "select" : "mark"),
+			active: activeTool === "mark",
+			annotates: true
+		},
+		{
+			label: "Comment",
+			glyph: "●",
+			action: () => setAuthorToolMode(sessionId, path, activeTool === "comment" ? "select" : "comment"),
+			active: activeTool === "comment",
+			annotates: true
+		}
+	];
+	return /* @__PURE__ */ jsxs("section", {
+		"data-testid": "author-tool-palette",
+		className: "space-y-2",
+		children: [
+			/* @__PURE__ */ jsx("h3", {
+				className: "sr-only",
+				children: "Tools"
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "grid grid-cols-4 gap-1.5",
+				children: tools.map((tool) => /* @__PURE__ */ jsxs(Button, {
+					size: "md",
+					variant: "outline",
+					"aria-label": tool.label === "Region" ? "mark region" : tool.label,
+					"aria-pressed": tool.active,
+					onClick: tool.action,
+					className: authorToolClassName(tool.active === true, tool.annotates === true),
+					children: [/* @__PURE__ */ jsx("span", {
+						"aria-hidden": "true",
+						className: "text-lg leading-none",
+						children: tool.glyph
+					}), /* @__PURE__ */ jsx("span", {
+						className: "text-sm",
+						children: tool.label
+					})]
+				}, tool.label))
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "text-base leading-normal text-po-dim sm:text-sm",
+				children: activeTool === "draw" ? "Draw a location mark, then enter feedback text. Marks never edit the source." : activeTool === "pan" ? "Drag to pan; pinch to zoom. Use Fit to reset the view." : activeTool === "mark" ? text ? "Drag over the passage you want to mark. Choose Region again to stop." : "Drag over the document to mark a region." : activeTool === "comment" ? text ? "Click a paragraph or line to comment on it. Choose Comment again to stop." : "Click the document to place a comment pin." : text ? "Select text to comment on it, or choose Region or Comment." : "Choose Region to drag an area, or Comment to place a point."
+			})
+		]
+	});
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/dock/_components/AuthorPanel.tsx
+function AuthorPanel({ sessionId, submitCapture, statuses, renderSlot, renderSessionActivity }) {
+	const documents = useStore(authorWorkspace.store, (state) => {
+		if (sessionId === null) return [];
+		const prefix = `${sessionId}\n`;
+		return Object.entries(state.documents).filter(([key]) => key.startsWith(prefix)).map(([, document]) => document);
+	});
+	const workspace = useStore(authorWorkspace.store, (state) => sessionId === null ? void 0 : state.sessions[sessionId]);
+	const grid = useStore(authorGrid.store, (state) => sessionId === null ? void 0 : state.sessions[sessionId]);
+	const focused = documents.find((document) => document.path === workspace?.focusedDocument?.path);
+	const focusedPath = workspace?.focusedDocument?.path;
+	const requests = (workspace?.requests ?? []).filter((request) => focusedPath === void 0 || request.documentPath === focusedPath);
+	const drafts = useStore(authorWorkspace.store, (state) => authorDocumentAnnotations(sessionId, focusedPath ?? "", state));
+	const activity = sessionId !== null && focusedPath !== void 0 && requests.some((request) => request.status === "REQUESTED" || request.status === "CHANGING") ? renderSessionActivity?.() ?? null : null;
+	return /* @__PURE__ */ jsxs("section", {
+		"data-testid": "author-panel",
+		className: "flex min-h-0 flex-1 flex-col overflow-hidden",
+		children: [/* @__PURE__ */ jsx("div", {
+			className: "min-h-0 flex-1 overflow-y-auto p-3",
+			children: /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-3",
+				children: [
+					/* @__PURE__ */ jsx("div", {
+						"data-testid": "author-preview-providers",
+						className: "empty:hidden",
+						children: renderSlot("author.preview-provider")
+					}),
+					sessionId !== null && workspace !== void 0 && focused !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+						/* @__PURE__ */ jsx(AuthorToolPalette, {
+							sessionId,
+							path: focused.path,
+							kind: focused.kind,
+							activeTool: workspace.toolsByDocument[normalizeAuthorPath(focused.path)] ?? "select"
+						}),
+						/* @__PURE__ */ jsx("h2", {
+							className: "border-t border-po-border-soft pt-3 text-lg font-semibold text-po-hi",
+							children: "Annotations"
+						}),
+						/* @__PURE__ */ jsxs("p", {
+							className: "text-base leading-normal text-po-dim sm:text-sm",
+							children: [
+								focused.kind === "markdown" || focused.kind === "text" ? "Select text or mark a passage, add feedback, then submit here." : "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-po-dim sm:text-sm",
+							children: "Annotations reference video frames. They do not save changes to the source video."
+						}) : null,
+						autonomousVoiceGridVisible(statuses) && grid !== void 0 ? /* @__PURE__ */ jsxs("div", {
+							"data-testid": "author-grid-snapshot",
+							className: "rounded border border-po-red/40 bg-po-red/5 p-2 text-base text-po-dim",
+							children: [/* @__PURE__ */ jsx("strong", {
+								className: "text-po-red",
+								children: "VOICE GRID A1–H8"
+							}), /* @__PURE__ */ jsxs("p", {
+								className: "mt-1 truncate",
+								children: ["token ", grid.geometryToken]
+							})]
+						}) : null,
+						/* @__PURE__ */ jsx("div", {
+							className: "max-sm:hidden",
+							children: /* @__PURE__ */ jsx(AuthorFeedbackControls, {
+								sessionId,
+								document: focused,
+								drafts,
+								submitCapture
+							}, focused.path)
+						})
+					] }) : null,
+					/* @__PURE__ */ jsx("div", {
+						className: focused === void 0 ? void 0 : "border-t border-po-border-soft pt-3",
+						children: /* @__PURE__ */ jsx(AuthorRequestLog, { requests })
+					})
+				]
+			})
+		}), activity === null ? null : /* @__PURE__ */ jsx("footer", {
+			"data-testid": "author-session-activity",
+			className: "shrink-0 border-t border-po-border bg-po-rail p-3",
+			children: activity
+		})]
+	});
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/dock/authoring.web.tsx
+var authoring_web_default = defineDockFace({
+	id: "authoring",
+	label: "Author",
+	order: 30,
+	panel: AuthorPanel,
+	visibility: {
+		subscribe(listener) {
+			const subscription = authorWorkspace.store.subscribe(listener);
+			return () => subscription.unsubscribe();
+		},
+		isVisible(sessionId) {
+			return sessionId !== null && authorWorkspace.store.state.sessions[sessionId]?.focusedDocument !== void 0;
+		}
+	}
+});
+//#endregion
 //#region src/types/apiRoutes.ts
 /**
 * This package's routes, as data.
@@ -2177,20 +2523,46 @@ const api = createApiClient(apiRoutes_default, {
 	sessionAddress: sessionApiAddress
 });
 //#endregion
-//#region src/types/authorApi.ts
-/** Query parameter naming the session a document request belongs to. */
-const SESSION_QUERY_PARAM = "session";
+//#region src/constants/author.ts
+const AUTHOR_FILE_TAB_PREFIX = "author-file-";
+/** Names a file in the session's artifact folder rather than the working tree. Artifacts open read-only. */
+const AUTHOR_ARTIFACT_PREFIX = "artifact:";
 //#endregion
-//#region src/extensions/workspaces/sessions/(frontend)/_lib/authorFiles.ts
-const IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
-	"avif",
-	"bmp",
-	"gif",
-	"jpeg",
-	"jpg",
-	"png",
-	"svg",
-	"webp"
+//#region src/types/authorPreview.ts
+function parseAuthorOpenSourceAction(input) {
+	if (typeof input !== "object" || input === null) return null;
+	const candidate = input;
+	return candidate.version === 1 && typeof candidate.createTab === "function" ? candidate : null;
+}
+function parseAuthorPreviewAction(input) {
+	if (typeof input !== "object" || input === null) return null;
+	const candidate = input;
+	if (candidate.version !== 1 || typeof candidate.label !== "string" || candidate.label.trim() === "") return null;
+	if (candidate.detail !== void 0 && typeof candidate.detail !== "string") return null;
+	if (typeof candidate.createTab !== "function") return null;
+	if (candidate.supportsSource !== void 0 && typeof candidate.supportsSource !== "function") return null;
+	if (candidate.embeddedPanel !== void 0 && typeof candidate.embeddedPanel !== "function") return null;
+	return candidate;
+}
+const authorPreviewActionSlot = {
+	slot: "author.preview-action",
+	parse: parseAuthorPreviewAction
+};
+//#endregion
+//#region src/types/authorApi.ts
+/** Query parameter naming the session a document request belongs to. */
+const SESSION_QUERY_PARAM = "session";
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_lib/authorFiles.ts
+const IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
+	"avif",
+	"bmp",
+	"gif",
+	"jpeg",
+	"jpg",
+	"png",
+	"svg",
+	"webp"
 ]);
 const VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([
 	"m4v",
@@ -2318,364 +2690,120 @@ async function loadAuthorDocument(sessionId, path, signal) {
 			path,
 			kind,
 			title: authorFileName(path),
-			structuredFormat: format,
-			fragments: parsed.fragments,
-			...csvDialect === void 0 ? {} : { csvDialect },
-			originalFragments: parsed.fragments.map((fragment) => ({ ...fragment })),
-			...sourceSha256 === void 0 ? {} : { sourceSha256 }
-		};
-	}
-	const mediaUrl = kind === "image" || kind === "video" || kind === "pdf" || kind === "opaque" ? url : void 0;
-	const content = kind === "text" || kind === "markdown" || kind === "story-preview" || kind === "html" ? await response.text() : void 0;
-	return {
-		path,
-		kind,
-		title: authorFileName(path),
-		...content === void 0 ? {} : { content },
-		...mediaUrl === void 0 ? {} : { mediaUrl },
-		...sourceSha256 === void 0 ? {} : { sourceSha256 }
-	};
-}
-function operationsFor(document) {
-	const originals = new Map((document.originalFragments ?? []).map((fragment) => [fragment.id, fragment.text]));
-	return (document.fragments ?? []).filter((fragment) => !fragment.readOnly && originals.get(fragment.id) !== fragment.text).map((fragment) => ({
-		fragmentId: fragment.id,
-		replacement: fragment.text
-	}));
-}
-function decodeBase64(value) {
-	if (!/^(?:[A-Za-z\d+/]{4})*(?:[A-Za-z\d+/]{2}==|[A-Za-z\d+/]{3}=)?$/.test(value)) throw new Error("Invalid serialized document bytes.");
-	const binary = atob(value);
-	return Uint8Array.from(binary, (character) => character.charCodeAt(0));
-}
-function imageMimeType(path) {
-	const extension = path.split(".").at(-1)?.toLowerCase();
-	if (extension === "png") return "image/png";
-	if (extension === "jpg" || extension === "jpeg") return "image/jpeg";
-	if (extension === "webp") return "image/webp";
-}
-async function croppedImageBytes(documentInput, signal) {
-	const { crop, mediaUrl } = documentInput;
-	if (crop === void 0 || mediaUrl === void 0) throw new Error("This Author image has no crop source.");
-	const mimeType = imageMimeType(documentInput.path);
-	if (mimeType === void 0) throw new Error("This image format cannot preserve its encoding after crop.");
-	const response = await browserTransport.fetch(mediaUrl, {
-		signal,
-		cache: "no-store"
-	});
-	if (!response.ok) throw new Error(`Author could not read the image before saving (${response.status})`);
-	const bitmap = await createImageBitmap(await response.blob());
-	try {
-		const sourceX = Math.round(crop.x * bitmap.width);
-		const sourceY = Math.round(crop.y * bitmap.height);
-		const sourceWidth = Math.max(1, Math.round(crop.width * bitmap.width));
-		const sourceHeight = Math.max(1, Math.round(crop.height * bitmap.height));
-		const canvas = window.document.createElement("canvas");
-		canvas.width = sourceWidth;
-		canvas.height = sourceHeight;
-		const context = canvas.getContext("2d");
-		if (context === null) throw new Error("Canvas is unavailable for image crop.");
-		context.drawImage(bitmap, sourceX, sourceY, sourceWidth, sourceHeight, 0, 0, sourceWidth, sourceHeight);
-		const blob = await new Promise((resolve) => canvas.toBlob(resolve, mimeType));
-		if (blob === null || blob.type !== mimeType) throw new Error("The browser cannot encode this cropped image format.");
-		return blob;
-	} finally {
-		bitmap.close();
-	}
-}
-async function bytesToSave(sessionId, document, signal) {
-	if (document.kind === "text" || document.kind === "markdown" || document.kind === "story-preview" || document.kind === "html") return document.content ?? "";
-	if (document.kind === "image" && document.crop !== void 0) return await croppedImageBytes(document, signal);
-	if (document.structuredFormat === void 0) throw new Error("This Author view cannot be saved.");
-	const operations = operationsFor(document);
-	const request = {
-		path: document.path,
-		format: document.structuredFormat,
-		operations,
-		...document.csvDialect === void 0 ? {} : { csvDialect: document.csvDialect }
-	};
-	const preflight = await documentRequest(api.session(sessionId).documentsPreflight, sessionId, request, signal);
-	if (preflight.sourceDigest !== void 0 && preflight.sourceDigest !== document.sourceSha256) throw new Error("Document source changed before saving. Reopen the document.");
-	if (!preflight.accepted) throw new Error(preflight.issues.map((issue) => issue.message).join("\n") || "Author preflight rejected the edit.");
-	const serialized = await documentRequest(api.session(sessionId).documentsSerialize, sessionId, {
-		...request,
-		preflightDigest: preflight.digest
-	}, signal);
-	if (serialized.encoding !== "base64") throw new Error("Author serialize returned an unsupported encoding.");
-	const bytes = decodeBase64(serialized.bytes);
-	return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
-}
-async function saveAuthorDocument(sessionId, document, signal) {
-	if (document.path.startsWith("artifact:")) throw new Error("Artifacts are read-only.");
-	if (document.sourceSha256 === void 0) throw new Error("This Author view has no source digest.");
-	const response = await browserTransport.fetch(authorSessionFileUrl(sessionId, document.path), {
-		method: "PUT",
-		headers: {
-			"Content-Type": "application/octet-stream",
-			"X-Expected-SHA256": document.sourceSha256
-		},
-		body: await bytesToSave(sessionId, document, signal),
-		signal
-	});
-	if (!response.ok) throw new Error(`Author save failed (${response.status})`);
-	const sha256 = response.headers.get("X-File-SHA256");
-	if (sha256 === null || !/^[a-f0-9]{64}$/.test(sha256)) throw new Error("Author save returned an invalid digest.");
-	return sha256;
-}
-function csvDialectFromMetadata(metadata) {
-	if (metadata === void 0) return void 0;
-	const { delimiter, quote, recordDelimiter } = metadata;
-	if (delimiter !== "," && delimiter !== ";" && delimiter !== "	" && delimiter !== "|" || quote !== "\"" && quote !== "'" || recordDelimiter !== "\n" && recordDelimiter !== "\r\n") throw new Error("Author document API returned an invalid CSV dialect.");
-	return {
-		delimiter,
-		quote,
-		recordDelimiter
-	};
-}
-//#endregion
-//#region src/extensions/workspaces/sessions/(frontend)/dock/_components/AuthorToolPalette.tsx
-/** One tool tile. An active annotation tool is the person's mark (rose); an active view tool is Po's jade. */
-function authorToolClassName(active, annotates) {
-	return `h-auto min-h-11 min-w-11 flex-col gap-1 rounded-md px-1 py-2 text-base [@media(pointer:fine)]:min-h-8 ${!active ? "border-po-border-soft bg-po-panel text-po-dim" : annotates ? "border-po-edge-magenta bg-po-tint-magenta font-semibold text-po-magenta hover:text-po-magenta" : "border-po-edge-green bg-po-tint-green font-semibold text-po-green hover:text-po-green"}`;
-}
-function AuthorToolPalette({ sessionId, path, kind, activeTool }) {
-	const [error, setError] = useState();
-	const format = (style) => {
-		const selected = authorDocumentAnnotations(sessionId, path).candidate;
-		const document = selected && authorDocument(sessionId, selected.documentPath);
-		if (!selected || !document || selected.anchor.kind !== "text-range" || selected.revision !== document.version || selected.sourceSha256 !== document.sourceSha256) {
-			setError("Select text in the document first.");
-			return;
-		}
-		const { startOffset, endOffset } = selected.anchor;
-		const content = document.content ?? "";
-		const text = content.slice(startOffset, endOffset);
-		const replacement = style === "Bold" ? `**${text}**` : style === "Link" ? `[${text}](https://)` : text.split("\n").map((line) => `${style === "Heading" ? "## " : "- "}${line}`).join("\n");
-		reviseAuthorDocument(sessionId, document.path, content.slice(0, startOffset) + replacement + content.slice(endOffset));
-		setAuthorRegionCandidate(sessionId, path, void 0);
-		setError(void 0);
-	};
-	const tools = [
-		...[
-			"image",
-			"pdf",
-			"video",
-			"story-preview"
-		].includes(kind) ? [{
-			label: "Pan",
-			glyph: "✋",
-			action: () => setAuthorToolMode(sessionId, path, activeTool === "pan" ? "select" : "pan"),
-			active: activeTool === "pan",
-			annotates: false
-		}] : [],
-		...[
-			"image",
-			"pdf",
-			"video",
-			"story-preview",
-			"html"
-		].includes(kind) ? [{
-			label: "Draw",
-			glyph: "✎",
-			action: () => setAuthorToolMode(sessionId, path, activeTool === "draw" ? "select" : "draw"),
-			active: activeTool === "draw",
-			annotates: true
-		}] : [],
-		{
-			label: "Region",
-			glyph: "⌗",
-			action: () => setAuthorToolMode(sessionId, path, activeTool === "mark" ? "select" : "mark"),
-			active: activeTool === "mark",
-			annotates: true
-		},
-		...kind === "markdown" && !isMermaidPath(path) ? [
-			{
-				label: "Bold",
-				glyph: "B",
-				action: () => format("Bold")
-			},
-			{
-				label: "Heading",
-				glyph: "H",
-				action: () => format("Heading")
-			},
-			{
-				label: "Link",
-				glyph: "↗",
-				action: () => format("Link")
-			},
-			{
-				label: "List",
-				glyph: "≡",
-				action: () => format("List")
-			}
-		] : [],
-		{
-			label: "Comment",
-			glyph: "●",
-			action: () => setAuthorToolMode(sessionId, path, activeTool === "comment" ? "select" : "comment"),
-			active: activeTool === "comment",
-			annotates: true
-		}
-	];
-	return /* @__PURE__ */ jsxs("section", {
-		"data-testid": "author-tool-palette",
-		className: "space-y-2",
-		children: [
-			/* @__PURE__ */ jsx("h3", {
-				className: "sr-only",
-				children: "Tools"
-			}),
-			/* @__PURE__ */ jsx("div", {
-				className: "grid grid-cols-4 gap-1.5",
-				children: tools.map((tool) => /* @__PURE__ */ jsxs(Button, {
-					size: "md",
-					variant: "outline",
-					"aria-label": tool.label === "Region" ? "mark region" : tool.label,
-					"aria-pressed": tool.active,
-					onClick: tool.action,
-					className: authorToolClassName(tool.active === true, tool.annotates === true),
-					children: [/* @__PURE__ */ jsx("span", {
-						"aria-hidden": "true",
-						className: "text-lg leading-none",
-						children: tool.glyph
-					}), /* @__PURE__ */ jsx("span", {
-						className: "text-sm",
-						children: tool.label
-					})]
-				}, tool.label))
-			}),
-			/* @__PURE__ */ jsx("p", {
-				className: "text-base leading-normal text-po-dim sm:text-sm",
-				children: activeTool === "draw" ? "Draw a location mark, then enter feedback text. Marks never edit the source." : activeTool === "pan" ? "Drag to pan; pinch to zoom. Use Fit to reset the view." : 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-po-red",
-				children: error
-			}) : null
-		]
-	});
-}
-//#endregion
-//#region src/extensions/workspaces/sessions/(frontend)/dock/_components/AuthorPanel.tsx
-function AuthorPanel({ sessionId, submitCapture, statuses, renderSlot, renderSessionActivity }) {
-	const documents = useStore(authorWorkspace.store, (state) => {
-		if (sessionId === null) return [];
-		const prefix = `${sessionId}\n`;
-		return Object.entries(state.documents).filter(([key]) => key.startsWith(prefix)).map(([, document]) => document);
-	});
-	const workspace = useStore(authorWorkspace.store, (state) => sessionId === null ? void 0 : state.sessions[sessionId]);
-	const grid = useStore(authorGrid.store, (state) => sessionId === null ? void 0 : state.sessions[sessionId]);
-	const focused = documents.find((document) => document.path === workspace?.focusedDocument?.path);
-	const focusedPath = workspace?.focusedDocument?.path;
-	const requests = (workspace?.requests ?? []).filter((request) => focusedPath === void 0 || request.documentPath === focusedPath);
-	const drafts = useStore(authorWorkspace.store, (state) => authorDocumentAnnotations(sessionId, focusedPath ?? "", state));
-	const activity = sessionId !== null && focusedPath !== void 0 && requests.some((request) => request.status === "REQUESTED" || request.status === "CHANGING") ? renderSessionActivity?.() ?? null : null;
-	return /* @__PURE__ */ jsxs("section", {
-		"data-testid": "author-panel",
-		className: "flex min-h-0 flex-1 flex-col overflow-hidden",
-		children: [/* @__PURE__ */ jsx("div", {
-			className: "min-h-0 flex-1 overflow-y-auto p-3",
-			children: /* @__PURE__ */ jsxs("div", {
-				className: "flex flex-col gap-3",
-				children: [
-					/* @__PURE__ */ jsx("div", {
-						"data-testid": "author-preview-providers",
-						className: "empty:hidden",
-						children: renderSlot("author.preview-provider")
-					}),
-					sessionId !== null && workspace !== void 0 && focused !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
-						/* @__PURE__ */ jsx(AuthorToolPalette, {
-							sessionId,
-							path: focused.path,
-							kind: focused.kind,
-							activeTool: workspace.toolsByDocument[normalizeAuthorPath(focused.path)] ?? "select"
-						}),
-						/* @__PURE__ */ jsx("h2", {
-							className: "border-t border-po-border-soft pt-3 text-lg font-semibold text-po-hi",
-							children: "Annotations"
-						}),
-						/* @__PURE__ */ jsx("p", {
-							className: "text-base leading-normal text-po-dim sm:text-sm",
-							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-po-dim sm:text-sm",
-							children: "Annotations reference video frames. They do not save changes to the source video."
-						}) : null,
-						autonomousVoiceGridVisible(statuses) && grid !== void 0 ? /* @__PURE__ */ jsxs("div", {
-							"data-testid": "author-grid-snapshot",
-							className: "rounded border border-po-red/40 bg-po-red/5 p-2 text-base text-po-dim",
-							children: [/* @__PURE__ */ jsx("strong", {
-								className: "text-po-red",
-								children: "VOICE GRID A1–H8"
-							}), /* @__PURE__ */ jsxs("p", {
-								className: "mt-1 truncate",
-								children: ["token ", grid.geometryToken]
-							})]
-						}) : null,
-						/* @__PURE__ */ jsx("div", {
-							className: "max-sm:hidden",
-							children: /* @__PURE__ */ jsx(AuthorFeedbackControls, {
-								sessionId,
-								document: focused,
-								drafts,
-								submitCapture
-							}, focused.path)
-						})
-					] }) : null,
-					/* @__PURE__ */ jsx("div", {
-						className: focused === void 0 ? void 0 : "border-t border-po-border-soft pt-3",
-						children: /* @__PURE__ */ jsx(AuthorRequestLog, { requests })
-					})
-				]
-			})
-		}), activity === null ? null : /* @__PURE__ */ jsx("footer", {
-			"data-testid": "author-session-activity",
-			className: "shrink-0 border-t border-po-border bg-po-rail p-3",
-			children: activity
-		})]
+			structuredFormat: format,
+			fragments: parsed.fragments,
+			...csvDialect === void 0 ? {} : { csvDialect },
+			originalFragments: parsed.fragments.map((fragment) => ({ ...fragment })),
+			...sourceSha256 === void 0 ? {} : { sourceSha256 }
+		};
+	}
+	const mediaUrl = kind === "image" || kind === "video" || kind === "pdf" || kind === "opaque" ? url : void 0;
+	const content = kind === "text" || kind === "markdown" || kind === "story-preview" || kind === "html" ? await response.text() : void 0;
+	return {
+		path,
+		kind,
+		title: authorFileName(path),
+		...content === void 0 ? {} : { content },
+		...mediaUrl === void 0 ? {} : { mediaUrl },
+		...sourceSha256 === void 0 ? {} : { sourceSha256 }
+	};
+}
+function operationsFor(document) {
+	const originals = new Map((document.originalFragments ?? []).map((fragment) => [fragment.id, fragment.text]));
+	return (document.fragments ?? []).filter((fragment) => !fragment.readOnly && originals.get(fragment.id) !== fragment.text).map((fragment) => ({
+		fragmentId: fragment.id,
+		replacement: fragment.text
+	}));
+}
+function decodeBase64(value) {
+	if (!/^(?:[A-Za-z\d+/]{4})*(?:[A-Za-z\d+/]{2}==|[A-Za-z\d+/]{3}=)?$/.test(value)) throw new Error("Invalid serialized document bytes.");
+	const binary = atob(value);
+	return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+}
+function imageMimeType(path) {
+	const extension = path.split(".").at(-1)?.toLowerCase();
+	if (extension === "png") return "image/png";
+	if (extension === "jpg" || extension === "jpeg") return "image/jpeg";
+	if (extension === "webp") return "image/webp";
+}
+async function croppedImageBytes(documentInput, signal) {
+	const { crop, mediaUrl } = documentInput;
+	if (crop === void 0 || mediaUrl === void 0) throw new Error("This Author image has no crop source.");
+	const mimeType = imageMimeType(documentInput.path);
+	if (mimeType === void 0) throw new Error("This image format cannot preserve its encoding after crop.");
+	const response = await browserTransport.fetch(mediaUrl, {
+		signal,
+		cache: "no-store"
 	});
+	if (!response.ok) throw new Error(`Author could not read the image before saving (${response.status})`);
+	const bitmap = await createImageBitmap(await response.blob());
+	try {
+		const sourceX = Math.round(crop.x * bitmap.width);
+		const sourceY = Math.round(crop.y * bitmap.height);
+		const sourceWidth = Math.max(1, Math.round(crop.width * bitmap.width));
+		const sourceHeight = Math.max(1, Math.round(crop.height * bitmap.height));
+		const canvas = window.document.createElement("canvas");
+		canvas.width = sourceWidth;
+		canvas.height = sourceHeight;
+		const context = canvas.getContext("2d");
+		if (context === null) throw new Error("Canvas is unavailable for image crop.");
+		context.drawImage(bitmap, sourceX, sourceY, sourceWidth, sourceHeight, 0, 0, sourceWidth, sourceHeight);
+		const blob = await new Promise((resolve) => canvas.toBlob(resolve, mimeType));
+		if (blob === null || blob.type !== mimeType) throw new Error("The browser cannot encode this cropped image format.");
+		return blob;
+	} finally {
+		bitmap.close();
+	}
 }
-//#endregion
-//#region src/extensions/workspaces/sessions/(frontend)/dock/authoring.web.tsx
-var authoring_web_default = defineDockFace({
-	id: "authoring",
-	label: "Author",
-	order: 30,
-	autoSelect: ({ tabId }) => tabId?.startsWith(AUTHOR_FILE_TAB_PREFIX) === true,
-	panel: AuthorPanel,
-	visibility: {
-		subscribe(listener) {
-			const subscription = authorWorkspace.store.subscribe(listener);
-			return () => subscription.unsubscribe();
+async function bytesToSave(sessionId, document, signal) {
+	if (document.kind === "text" || document.kind === "markdown" || document.kind === "story-preview" || document.kind === "html") return document.content ?? "";
+	if (document.kind === "image" && document.crop !== void 0) return await croppedImageBytes(document, signal);
+	if (document.structuredFormat === void 0) throw new Error("This Author view cannot be saved.");
+	const operations = operationsFor(document);
+	const request = {
+		path: document.path,
+		format: document.structuredFormat,
+		operations,
+		...document.csvDialect === void 0 ? {} : { csvDialect: document.csvDialect }
+	};
+	const preflight = await documentRequest(api.session(sessionId).documentsPreflight, sessionId, request, signal);
+	if (preflight.sourceDigest !== void 0 && preflight.sourceDigest !== document.sourceSha256) throw new Error("Document source changed before saving. Reopen the document.");
+	if (!preflight.accepted) throw new Error(preflight.issues.map((issue) => issue.message).join("\n") || "Author preflight rejected the edit.");
+	const serialized = await documentRequest(api.session(sessionId).documentsSerialize, sessionId, {
+		...request,
+		preflightDigest: preflight.digest
+	}, signal);
+	if (serialized.encoding !== "base64") throw new Error("Author serialize returned an unsupported encoding.");
+	const bytes = decodeBase64(serialized.bytes);
+	return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+async function saveAuthorDocument(sessionId, document, signal) {
+	if (document.path.startsWith("artifact:")) throw new Error("Artifacts are read-only.");
+	if (document.sourceSha256 === void 0) throw new Error("This Author view has no source digest.");
+	const response = await browserTransport.fetch(authorSessionFileUrl(sessionId, document.path), {
+		method: "PUT",
+		headers: {
+			"Content-Type": "application/octet-stream",
+			"X-Expected-SHA256": document.sourceSha256
 		},
-		isVisible(sessionId) {
-			return sessionId !== null && authorWorkspace.store.state.sessions[sessionId]?.focusedDocument !== void 0;
-		}
-	}
-});
-//#endregion
-//#region src/types/authorPreview.ts
-function parseAuthorOpenSourceAction(input) {
-	if (typeof input !== "object" || input === null) return null;
-	const candidate = input;
-	return candidate.version === 1 && typeof candidate.createTab === "function" ? candidate : null;
+		body: await bytesToSave(sessionId, document, signal),
+		signal
+	});
+	if (!response.ok) throw new Error(`Author save failed (${response.status})`);
+	const sha256 = response.headers.get("X-File-SHA256");
+	if (sha256 === null || !/^[a-f0-9]{64}$/.test(sha256)) throw new Error("Author save returned an invalid digest.");
+	return sha256;
 }
-function parseAuthorPreviewAction(input) {
-	if (typeof input !== "object" || input === null) return null;
-	const candidate = input;
-	if (candidate.version !== 1 || typeof candidate.label !== "string" || candidate.label.trim() === "") return null;
-	if (candidate.detail !== void 0 && typeof candidate.detail !== "string") return null;
-	if (typeof candidate.createTab !== "function") return null;
-	if (candidate.supportsSource !== void 0 && typeof candidate.supportsSource !== "function") return null;
-	if (candidate.embeddedPanel !== void 0 && typeof candidate.embeddedPanel !== "function") return null;
-	return candidate;
+function csvDialectFromMetadata(metadata) {
+	if (metadata === void 0) return void 0;
+	const { delimiter, quote, recordDelimiter } = metadata;
+	if (delimiter !== "," && delimiter !== ";" && delimiter !== "	" && delimiter !== "|" || quote !== "\"" && quote !== "'" || recordDelimiter !== "\n" && recordDelimiter !== "\r\n") throw new Error("Author document API returned an invalid CSV dialect.");
+	return {
+		delimiter,
+		quote,
+		recordDelimiter
+	};
 }
-const authorPreviewActionSlot = {
-	slot: "author.preview-action",
-	parse: parseAuthorPreviewAction
-};
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/_lib/authorGridTools.ts
 const stringProperty = {
@@ -2908,6 +3036,7 @@ function mutationTool(sessionId, path, kind) {
 						revision: document.version + 1
 					};
 				} else throw new Error("UNSUPPORTED_REGION: PDF, video and rendered HTML regions are capture-only.");
+				removeAuthorRegion(sessionId, path, region.id);
 				if (request !== void 0) {
 					const pendingRegions = rebasePendingRegions(pending, region, result, nextContent);
 					updateAuthorRequest(sessionId, request.id, (current) => ({
@@ -4589,9 +4718,118 @@ function AuthorStructuredView({ sessionId, document, displayedRegions }) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/_components/AuthorTextView.tsx
-function AuthorTextView({ sessionId, document, preview, displayedRegions, renderMediaReview }) {
+const FORMATS = [
+	{
+		format: "bold",
+		label: "Bold",
+		glyph: "B"
+	},
+	{
+		format: "heading",
+		label: "Heading",
+		glyph: "H"
+	},
+	{
+		format: "link",
+		label: "Link",
+		glyph: "↗"
+	},
+	{
+		format: "list",
+		label: "List",
+		glyph: "≡"
+	}
+];
+/** The blocks Comment marks in the reading view: one paragraph, item, heading, quote or code block. */
+const COMMENT_BLOCKS = "p,li,h1,h2,h3,h4,h5,h6,pre,blockquote,td,th";
+/** The CSS highlight that paints unsent notes on the reading view. */
+const NOTE_HIGHLIGHT = "po-author-note";
+/** The label shown for the passage being marked, before it has feedback. */
+const CANDIDATE_LABEL = "•";
+/** Rendered text in reading order, minus diagrams and controls that are not document text. */
+function renderedRuns(article) {
+	const walker = article.ownerDocument.createTreeWalker(article, NodeFilter.SHOW_TEXT, { acceptNode: (node) => node.parentElement?.closest("svg,button,[aria-hidden=\"true\"]") ? NodeFilter.FILTER_REJECT : NodeFilter.FILTER_ACCEPT });
+	const runs = [];
+	for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) runs.push(node);
+	return runs;
+}
+/** Maps a range over the rendered page back to the Markdown source it came from. */
+function sourceRange(article, source, range) {
+	const runs = renderedRuns(article);
+	const offsets = locateRenderedRuns(source, runs.map((run) => run.data));
+	let from;
+	let to;
+	runs.forEach((run, index) => {
+		const at = offsets[index];
+		if (at === void 0 || !range.intersectsNode(run)) return;
+		from ??= at + (run === range.startContainer ? range.startOffset : 0);
+		to = Math.min(source.length, at + (run === range.endContainer ? range.endOffset : run.data.length));
+	});
+	return from === void 0 || to === void 0 || to <= from ? void 0 : {
+		from,
+		to
+	};
+}
+/** The rendered text a source range covers: the way back from a note to the page. */
+function renderedRange(article, source, from, to) {
+	const runs = renderedRuns(article);
+	const offsets = locateRenderedRuns(source, runs.map((run) => run.data));
+	let first;
+	let last;
+	runs.forEach((run, index) => {
+		const at = offsets[index];
+		if (at === void 0 || at + run.data.length <= from || at >= to) return;
+		first ??= {
+			run,
+			offset: Math.max(0, from - at)
+		};
+		last = {
+			run,
+			offset: Math.min(run.data.length, to - at)
+		};
+	});
+	if (first === void 0 || last === void 0) return void 0;
+	const range = article.ownerDocument.createRange();
+	range.setStart(first.run, first.offset);
+	range.setEnd(last.run, last.offset);
+	return range;
+}
+/** The rendered text a dragged box covers, run by run. */
+function rangeInBox(article, box) {
+	const probe = article.ownerDocument.createRange();
+	const covered = renderedRuns(article).filter((run) => {
+		probe.selectNodeContents(run);
+		return [...probe.getClientRects()].some((rect) => rect.right > box.left && rect.left < box.right && rect.bottom > box.top && rect.top < box.bottom);
+	});
+	const first = covered[0];
+	const last = covered.at(-1);
+	if (first === void 0 || last === void 0) return void 0;
+	probe.setStart(first, 0);
+	probe.setEnd(last, last.data.length);
+	return probe;
+}
+function AuthorTextView({ sessionId, document, preview, activeTool = "select", displayedRegions, candidate, renderMediaReview }) {
 	const host = useRef(null);
 	const editor = useRef(null);
+	const article = useRef(null);
+	const selected = useRef({
+		from: 0,
+		to: 0
+	});
+	const [box, setBox] = useState();
+	const [notice, setNotice] = useState();
+	const [badges, setBadges] = useState([]);
+	const formatting = !preview && document.kind === "markdown" && !isMermaidPath(document.path);
+	const marks = [...displayedRegions.flatMap(({ ordinal, region }) => region.anchor.kind === "text-range" ? [{
+		label: String(ordinal),
+		from: region.anchor.startOffset,
+		to: region.anchor.endOffset
+	}] : []), ...candidate?.anchor.kind === "text-range" ? [{
+		label: CANDIDATE_LABEL,
+		from: candidate.anchor.startOffset,
+		to: candidate.anchor.endOffset
+	}] : []];
+	const marksKey = JSON.stringify(marks);
 	useEffect(() => registerAuthorGridResolver(sessionId, (cell, geometry) => {
 		if (preview || editor.current === null) return void 0;
 		const { originX = 0, originY = 0, width, height } = geometry.viewport;
@@ -4614,12 +4852,44 @@ function AuthorTextView({ sessionId, document, preview, displayedRegions, render
 		};
 	}), [preview, sessionId]);
 	useEffect(() => {
-		editor.current?.setMarkedRanges(displayedRegions.flatMap(({ ordinal, region }) => region.anchor.kind === "text-range" ? [{
-			from: region.anchor.startOffset,
-			to: region.anchor.endOffset,
-			label: String(ordinal)
-		}] : []));
-	}, [displayedRegions]);
+		editor.current?.setMarkedRanges(JSON.parse(marksKey));
+	}, [marksKey]);
+	useEffect(() => {
+		const root = article.current;
+		const frame = root?.parentElement;
+		if (!preview || !root || !frame) return void 0;
+		const paint = () => {
+			const source = document.content ?? "";
+			const placed = JSON.parse(marksKey).flatMap((mark) => {
+				const range = renderedRange(root, source, mark.from, mark.to);
+				return range === void 0 ? [] : [{
+					label: mark.label,
+					range
+				}];
+			});
+			if (typeof CSS !== "undefined" && "highlights" in CSS) CSS.highlights.set(NOTE_HIGHLIGHT, new Highlight(...placed.map(({ range }) => range)));
+			const origin = frame.getBoundingClientRect();
+			setBadges(placed.map(({ label, range }) => {
+				const rect = range.getClientRects()[0] ?? range.getBoundingClientRect();
+				return {
+					label,
+					left: rect.left - origin.left,
+					top: rect.top - origin.top
+				};
+			}));
+		};
+		paint();
+		const observer = typeof ResizeObserver === "undefined" ? void 0 : new ResizeObserver(paint);
+		observer?.observe(root);
+		return () => {
+			observer?.disconnect();
+			if (typeof CSS !== "undefined" && "highlights" in CSS) CSS.highlights.delete(NOTE_HIGHLIGHT);
+		};
+	}, [
+		preview,
+		marksKey,
+		document.content
+	]);
 	const lines = (document.content ?? "").split("\n").length;
 	const loadImage = useCallback(async (imagePath) => {
 		const path = authorMarkdownImagePath(document.path, imagePath);
@@ -4628,69 +4898,296 @@ function AuthorTextView({ sessionId, document, preview, displayedRegions, render
 			path
 		};
 	}, [sessionId, document.path]);
+	const format = (style) => {
+		const current = authorDocument(sessionId, document.path);
+		if (!current || editor.current === null) return;
+		const { from, to } = selected.current;
+		const edit = authorMarkdownFormat(current.content ?? "", from, to, style);
+		editor.current.applyEdits([{
+			from: edit.from,
+			to: edit.to,
+			insert: edit.insert
+		}]);
+		editor.current.revealAndSelect(edit.select);
+		editor.current.focus();
+	};
+	/** Makes a source range the annotation candidate the rail asks feedback for. */
+	const markSource = (found, mode, missing) => {
+		const current = authorDocument(sessionId, document.path);
+		const bounds = host.current?.getBoundingClientRect();
+		if (!current || !bounds) return;
+		if (found === void 0 || found.to <= found.from) {
+			setNotice(missing);
+			return;
+		}
+		const source = current.content ?? "";
+		setNotice(void 0);
+		setAuthorRegionCandidate(sessionId, document.path, {
+			documentPath: current.path,
+			revision: current.version,
+			sourceSha256: current.sourceSha256,
+			mode,
+			quote: source.slice(found.from, found.to),
+			anchor: {
+				kind: "text-range",
+				startOffset: found.from,
+				endOffset: found.to,
+				startLine: authorSourceLine(source, found.from),
+				endLine: authorSourceLine(source, found.to)
+			},
+			viewport: {
+				width: bounds.width,
+				height: bounds.height
+			},
+			createdAt: Date.now()
+		});
+	};
+	const markRendered = (range, mode) => {
+		if (article.current === null) return;
+		markSource(sourceRange(article.current, authorDocument(sessionId, document.path)?.content ?? "", range), mode, "That part of the page has no source text to mark. Press Edit to select it in the source.");
+	};
+	const markSelection = () => {
+		if (activeTool !== "select" || article.current === null) return;
+		const selection = window.getSelection();
+		if (selection === null || selection.isCollapsed || selection.rangeCount === 0) return;
+		const range = selection.getRangeAt(0);
+		if (article.current.contains(range.commonAncestorContainer)) markRendered(range, "region");
+	};
+	const annotating = activeTool === "mark" || activeTool === "comment";
+	const drawBox = (event, start) => {
+		const bounds = event.currentTarget.getBoundingClientRect();
+		const x = event.clientX - bounds.left;
+		const y = event.clientY - bounds.top;
+		return {
+			...start,
+			left: Math.min(start.x, x),
+			top: Math.min(start.y, y),
+			width: Math.abs(x - start.x),
+			height: Math.abs(y - start.y)
+		};
+	};
+	/** Region and Comment over the source editor: a dragged stretch of text, or the clicked line. */
+	const finishSourceAnnotation = (event, started) => {
+		const source = authorDocument(sessionId, document.path)?.content ?? "";
+		if (editor.current === null) return;
+		if (activeTool === "comment") {
+			const hit = editor.current.resolveViewportRegion({
+				left: event.clientX,
+				top: event.clientY,
+				right: event.clientX,
+				bottom: event.clientY
+			});
+			const lineStart = hit === null ? 0 : source.lastIndexOf("\n", hit.from - 1) + 1;
+			const lineEnd = hit === null ? -1 : source.indexOf("\n", hit.from);
+			markSource(hit === null ? void 0 : {
+				from: lineStart,
+				to: lineEnd === -1 ? source.length : lineEnd
+			}, "point", "Click a line with text to comment on it.");
+			return;
+		}
+		const drawn = drawBox(event, started);
+		if (drawn.width < 4 && drawn.height < 4) return;
+		const overlay = event.currentTarget.getBoundingClientRect();
+		const hit = editor.current.resolveViewportRegion({
+			left: overlay.left + drawn.left,
+			top: overlay.top + drawn.top,
+			right: overlay.left + drawn.left + drawn.width,
+			bottom: overlay.top + drawn.top + drawn.height
+		});
+		markSource(hit === null ? void 0 : {
+			from: hit.from,
+			to: hit.to
+		}, "region", "Drag over some text to mark it.");
+	};
+	const finishAnnotation = (event) => {
+		const started = box;
+		setBox(void 0);
+		if (started === void 0 || started.pointerId !== event.pointerId) return;
+		if (!preview) {
+			finishSourceAnnotation(event, started);
+			return;
+		}
+		if (article.current === null) return;
+		if (activeTool === "comment") {
+			const block = window.document.elementsFromPoint(event.clientX, event.clientY).find((element) => article.current?.contains(element) && element.closest(COMMENT_BLOCKS) !== null)?.closest(COMMENT_BLOCKS);
+			if (!block) return;
+			const range = window.document.createRange();
+			range.selectNodeContents(block);
+			markRendered(range, "point");
+			return;
+		}
+		const drawn = drawBox(event, started);
+		if (drawn.width < 4 || drawn.height < 4) return;
+		const overlay = event.currentTarget.getBoundingClientRect();
+		const range = rangeInBox(article.current, new DOMRect(overlay.left + drawn.left, overlay.top + drawn.top, drawn.width, drawn.height));
+		if (range === void 0) {
+			setNotice("Drag over some text to mark it.");
+			return;
+		}
+		markRendered(range, "region");
+	};
+	const overlay = annotating ? /* @__PURE__ */ jsx("div", {
+		"data-testid": "author-text-overlay",
+		className: `absolute inset-0 z-10 touch-none ${activeTool === "mark" ? "cursor-crosshair" : "cursor-pointer"}`,
+		onPointerDown: (event) => {
+			if (event.button !== 0) return;
+			event.preventDefault();
+			const bounds = event.currentTarget.getBoundingClientRect();
+			const x = event.clientX - bounds.left;
+			const y = event.clientY - bounds.top;
+			setBox({
+				pointerId: event.pointerId,
+				x,
+				y,
+				left: x,
+				top: y,
+				width: 0,
+				height: 0
+			});
+			event.currentTarget.setPointerCapture(event.pointerId);
+		},
+		onPointerMove: (event) => {
+			if (activeTool === "mark" && box?.pointerId === event.pointerId) setBox(drawBox(event, box));
+		},
+		onPointerUp: finishAnnotation,
+		onPointerCancel: () => setBox(void 0),
+		onWheel: (event) => preview ? void 0 : host.current?.querySelector(".cm-scroller")?.scrollBy({
+			left: event.deltaX,
+			top: event.deltaY
+		}),
+		children: box === void 0 || activeTool !== "mark" ? null : /* @__PURE__ */ jsx("div", {
+			"data-testid": "author-text-selection",
+			className: "pointer-events-none absolute border-2 border-dashed border-po-magenta bg-po-magenta/10",
+			style: {
+				left: box.left,
+				top: box.top,
+				width: box.width,
+				height: box.height
+			}
+		})
+	}) : null;
 	return /* @__PURE__ */ jsxs("div", {
 		ref: host,
 		className: "flex min-h-0 flex-1 flex-col",
-		children: [preview ? /* @__PURE__ */ jsx("div", {
-			"data-testid": "author-markdown",
-			className: "min-h-0 flex-1 overflow-auto bg-po-deep/50 p-6",
-			children: /* @__PURE__ */ jsx("article", {
-				className: "mx-auto min-h-full max-w-3xl rounded-md bg-po-panel px-6 py-8 sm:px-10 text-lg leading-relaxed text-po-text shadow-sm ring-1 ring-po-border-soft",
-				children: /* @__PURE__ */ jsx(Markdown, {
-					text: isMermaidPath(document.path) ? `\`\`\`\`mermaid\n${document.content ?? ""}\n\`\`\`\`` : document.content ?? "",
-					loadImage,
-					documentPath: document.path,
-					renderMediaReview
+		children: [
+			formatting ? /* @__PURE__ */ jsxs("div", {
+				role: "toolbar",
+				"aria-label": "Format Markdown",
+				"data-testid": "author-format-toolbar",
+				className: "flex shrink-0 items-center gap-1 border-b border-po-border bg-po-bg px-3 py-1.5",
+				children: [FORMATS.map(({ format: style, label, glyph }) => /* @__PURE__ */ jsxs(Button, {
+					size: "sm",
+					variant: "ghost",
+					"aria-label": label,
+					title: label,
+					className: "min-h-11 gap-1.5 [@media(pointer:fine)]:min-h-8",
+					onMouseDown: (event) => event.preventDefault(),
+					onClick: () => format(style),
+					children: [/* @__PURE__ */ jsx("span", {
+						"aria-hidden": "true",
+						className: "font-semibold",
+						children: glyph
+					}), /* @__PURE__ */ jsx("span", {
+						className: "text-sm",
+						children: label
+					})]
+				}, style)), /* @__PURE__ */ jsx("span", {
+					className: "ml-auto truncate text-sm text-po-dim",
+					children: "Select text, then format it."
+				})]
+			}) : null,
+			preview ? /* @__PURE__ */ jsx("div", {
+				"data-testid": "author-markdown",
+				className: "min-h-0 flex-1 overflow-auto bg-po-deep/50 p-6",
+				children: /* @__PURE__ */ jsxs("div", {
+					className: "relative mx-auto min-h-full max-w-3xl",
+					children: [
+						/* @__PURE__ */ jsx("article", {
+							ref: article,
+							onPointerUp: markSelection,
+							onKeyUp: markSelection,
+							className: "min-h-full rounded-md bg-po-panel px-6 py-8 sm:px-10 text-lg leading-relaxed text-po-text shadow-sm ring-1 ring-po-border-soft [&::highlight(po-author-note)]:bg-po-tint-magenta [&_*::highlight(po-author-note)]:bg-po-tint-magenta",
+							children: /* @__PURE__ */ jsx(Markdown, {
+								text: isMermaidPath(document.path) ? `\`\`\`\`mermaid\n${document.content ?? ""}\n\`\`\`\`` : document.content ?? "",
+								loadImage,
+								documentPath: document.path,
+								renderMediaReview
+							})
+						}),
+						badges.map((badge, index) => /* @__PURE__ */ jsx("span", {
+							"aria-hidden": "true",
+							"data-author-region": badge.label,
+							className: `pointer-events-none absolute z-10 flex h-6 min-w-6 -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-full border-2 px-1 text-sm font-semibold ${badge.label === CANDIDATE_LABEL ? "border-po-magenta bg-po-panel text-po-magenta" : "border-po-panel bg-po-magenta text-po-rail"}`,
+							style: {
+								left: badge.left,
+								top: badge.top
+							},
+							children: badge.label
+						}, `${badge.label}-${String(index)}`)),
+						overlay
+					]
 				})
+			}) : /* @__PURE__ */ jsxs("div", {
+				className: "relative flex min-h-0 flex-1 flex-col",
+				children: [/* @__PURE__ */ jsx(CodeEditor, {
+					value: document.content ?? "",
+					path: document.path,
+					"data-testid": "author-editor",
+					controllerRef: editor,
+					className: "min-h-0 flex-1",
+					onChange: (content) => reviseAuthorDocument(sessionId, document.path, content),
+					onSelect: (range) => {
+						selected.current = {
+							from: range.from,
+							to: range.to
+						};
+						const current = authorDocument(sessionId, document.path);
+						const bounds = host.current?.getBoundingClientRect();
+						if (!current || !bounds || range.from === range.to) return;
+						setAuthorRegionCandidate(sessionId, document.path, {
+							documentPath: current.path,
+							revision: current.version,
+							sourceSha256: current.sourceSha256,
+							quote: range.text,
+							anchor: {
+								kind: "text-range",
+								startOffset: range.from,
+								endOffset: range.to,
+								startLine: range.startLine,
+								endLine: range.endLine
+							},
+							viewport: {
+								width: bounds.width,
+								height: bounds.height
+							},
+							createdAt: Date.now()
+						});
+					}
+				}), overlay]
+			}),
+			notice === void 0 ? null : /* @__PURE__ */ jsx("output", {
+				className: "shrink-0 border-t border-po-border bg-po-bg px-4 py-1.5 text-sm text-po-dim",
+				children: notice
+			}),
+			/* @__PURE__ */ jsxs("footer", {
+				className: "flex shrink-0 items-center gap-2 border-t border-po-border bg-po-bg px-4 py-1.5 text-sm text-po-dim",
+				children: [
+					/* @__PURE__ */ jsx("span", {
+						className: "first-letter:uppercase",
+						children: document.kind
+					}),
+					/* @__PURE__ */ jsx("span", {
+						"aria-hidden": "true",
+						children: "·"
+					}),
+					/* @__PURE__ */ jsxs("span", { children: [
+						lines,
+						" line",
+						lines === 1 ? "" : "s"
+					] })
+				]
 			})
-		}) : /* @__PURE__ */ jsx(CodeEditor, {
-			value: document.content ?? "",
-			path: document.path,
-			"data-testid": "author-editor",
-			controllerRef: editor,
-			className: "min-h-0 flex-1",
-			onChange: (content) => reviseAuthorDocument(sessionId, document.path, content),
-			onSelect: (range) => {
-				const current = authorDocument(sessionId, document.path);
-				const bounds = host.current?.getBoundingClientRect();
-				if (!current || !bounds || range.from === range.to) return;
-				setAuthorRegionCandidate(sessionId, document.path, {
-					documentPath: current.path,
-					revision: current.version,
-					sourceSha256: current.sourceSha256,
-					quote: range.text,
-					anchor: {
-						kind: "text-range",
-						startOffset: range.from,
-						endOffset: range.to,
-						startLine: range.startLine,
-						endLine: range.endLine
-					},
-					viewport: {
-						width: bounds.width,
-						height: bounds.height
-					},
-					createdAt: Date.now()
-				});
-			}
-		}), /* @__PURE__ */ jsxs("footer", {
-			className: "flex shrink-0 items-center gap-2 border-t border-po-border bg-po-bg px-4 py-1.5 text-sm text-po-dim",
-			children: [
-				/* @__PURE__ */ jsx("span", {
-					className: "first-letter:uppercase",
-					children: document.kind
-				}),
-				/* @__PURE__ */ jsx("span", {
-					"aria-hidden": "true",
-					children: "·"
-				}),
-				/* @__PURE__ */ jsxs("span", { children: [
-					lines,
-					" line",
-					lines === 1 ? "" : "s"
-				] })
-			]
-		})]
+		]
 	});
 }
 //#endregion
@@ -4704,6 +5201,13 @@ const MOBILE_TOOL_GLYPHS = {
 };
 const pendingCanvases = /* @__PURE__ */ new Map();
 const canvasOwners = /* @__PURE__ */ new Map();
+const reason = (error) => error instanceof Error ? error.message : String(error);
+/** Closing a canvas nobody shows is best effort, but a failure is reported, never lost. */
+function closeCanvas(sessionId, alias) {
+	api.session(sessionId).bridgeClose({ body: { alias } }).then((result) => {
+		if (!result.ok) console.warn(`Author canvas '${alias}' did not close: ${result.error}`);
+	}).catch((error) => console.warn(`Author canvas '${alias}' did not close: ${reason(error)}`));
+}
 function tabId(path) {
 	let hash = 2166136261;
 	for (const char of normalizeAuthorPath(path)) hash = Math.imul(hash ^ char.charCodeAt(0), 16777619);
@@ -4810,8 +5314,10 @@ function AuthorDocumentPanel(props) {
 	const textPanel = /* @__PURE__ */ jsx(AuthorTextView, {
 		sessionId,
 		document,
-		preview: document.kind === "markdown" && markdownPreview && activeTool === "select" && !gridVisible,
+		preview: document.kind === "markdown" && markdownPreview && !gridVisible,
+		activeTool,
 		displayedRegions,
+		candidate: drafts.candidate,
 		renderMediaReview: markdownMediaReview(props)
 	});
 	const sourcePanel = document.kind === "html" && !htmlSource ? /* @__PURE__ */ jsx(AuthorHtmlView, {
@@ -5049,7 +5555,7 @@ function authorFileTab(path, preferredAlias) {
 				const opened = result.data;
 				const canonicalAlias = opened.alias;
 				if (controller.signal.aborted || pendingCanvases.get(key) !== controller) {
-					if ((canvasOwners.get(`${sessionId}\n${canonicalAlias}`)?.size ?? 0) === 0) api.session(sessionId).bridgeClose({ body: { alias: canonicalAlias } }).catch(() => void 0);
+					if ((canvasOwners.get(`${sessionId}\n${canonicalAlias}`)?.size ?? 0) === 0) closeCanvas(sessionId, canonicalAlias);
 					return;
 				}
 				canvasAliases.setState((state) => ({
@@ -5096,10 +5602,11 @@ function authorFileTab(path, preferredAlias) {
 					body: { path: normalized },
 					query: { session: sessionId }
 				}).then((result) => {
-					if (!result.ok || !("alias" in result.data) || typeof result.data.alias !== "string") return;
+					if (!result.ok) throw new Error(result.error);
+					if (!("alias" in result.data) || typeof result.data.alias !== "string") return;
 					const recoveredAlias = result.data.alias;
-					if ((canvasOwners.get(`${sessionId}\n${recoveredAlias}`)?.size ?? 0) === 0) api.session(sessionId).bridgeClose({ body: { alias: recoveredAlias } }).catch(() => void 0);
-				}).catch(() => void 0);
+					if ((canvasOwners.get(`${sessionId}\n${recoveredAlias}`)?.size ?? 0) === 0) closeCanvas(sessionId, recoveredAlias);
+				}).catch((error) => console.warn(`Author could not check for a canvas left open for '${normalized}': ${reason(error)}`));
 				return;
 			}
 			const owners = canvasOwners.get(`${sessionId}\n${alias}`);
@@ -5122,7 +5629,7 @@ function authorFileTab(path, preferredAlias) {
 				delete next[key];
 				return next;
 			});
-			if (lastOwner) api.session(sessionId).bridgeClose({ body: { alias } }).catch(() => void 0);
+			if (lastOwner) closeCanvas(sessionId, alias);
 		},
 		panel: (props) => /* @__PURE__ */ jsx(AuthorDocumentPanel, {
 			...props,