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

package/dist/extensions/web.mjs

@@ -1,4 +1,4 @@
-import { apiResponse, createApiClient, defineApiRoutes, defineChannelFile, defineDockFace, defineFileLinks, defineGlobalStore, defineLeaderBinding, defineMinorModeFile, defineSessionStore, defineToolRenderer, defineWebLifecycle, defineWebPlugin, sessionApiAddress, toolResultTextLines } from "@agimon-ai/doompi-core/web";
+import { apiResponse, createApiClient, defineApiRoutes, defineChannelFile, defineDockFace, defineFileLinks, defineGlobalStore, defineLeaderBinding, defineMinorModeFile, defineSessionStore, defineSlotFile, defineToolRenderer, defineWebLifecycle, defineWebPlugin, sessionApiAddress, toolResultTextLines } from "@agimon-ai/doompi-core/web";
 import { Store } from "@tanstack/store";
 import { Button, CodeEditor, Markdown, MediaPreview, MessageItem, MessageItemBody, MessageItemHeader, MessageItemStatus, MessageLines, collapseLines, toolTone } from "@agimon-ai/doompi-web-components";
 import { useStore } from "@tanstack/react-store";
@@ -501,7 +501,7 @@ function putAuthorDocument(sessionId, input) {
 					},
 					regions: [],
 					candidate: void 0,
-					requests: session.requests.map((request) => request.documentPath === path && (request.status === "REQUESTED" || request.status === "CHANGING" || request.status === "CHANGED") ? {
+					requests: session.requests.map((request) => input.kind !== "story-preview" && request.documentPath === path && (request.status === "REQUESTED" || request.status === "CHANGING" || request.status === "CHANGED") ? {
 						...request,
 						status: "FAILED",
 						currentOperation: void 0,
@@ -1033,6 +1033,7 @@ function utf8Prefix(value, limit) {
 }
 function createAuthorCapturePacket(captureId, capturedAt, document, regions) {
 	if (regions.length === 0 || regions.length > 16) throw new Error("Capture requires between 1 and 16 regions.");
+	if (document.kind === "story-preview" && document.storyPreview === void 0) throw new Error("Story preview capture requires source provenance.");
 	const packet = {
 		version: 1,
 		captureId,
@@ -1041,7 +1042,8 @@ function createAuthorCapturePacket(captureId, capturedAt, document, regions) {
 			path: document.path,
 			kind: document.kind,
 			revision: document.version,
-			...document.sourceSha256 === void 0 ? {} : { sourceSha256: document.sourceSha256 }
+			...document.sourceSha256 === void 0 ? {} : { sourceSha256: document.sourceSha256 },
+			...document.storyPreview === void 0 ? {} : { storyPreview: structuredClone(document.storyPreview) }
 		},
 		regions: regions.map((region, index) => {
 			if (region.documentPath !== document.path || region.revision !== document.version || region.sourceSha256 !== document.sourceSha256) throw new Error(`Region ${String(index + 1)} is stale for the focused document.`);
@@ -1073,12 +1075,30 @@ function anchorLocation(anchor) {
 		case "image-rect": return `image ${rectLocation(anchor.rect)}`;
 		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)}`;
 	}
 }
+function storyPreviewProvenance(packet) {
+	const preview = packet.document.storyPreview;
+	if (preview === void 0) return void 0;
+	const sources = preview.sources.map((source) => `- ${source.path} (sha256 ${source.sha256})`).join("\n");
+	return [
+		"Story preview source (edit these sources, never the generated preview artifact):",
+		`Project: ${preview.projectPath}`,
+		`Story: ${preview.storyPath}#${preview.storyExport}`,
+		`Build revision: ${preview.buildRevision}`,
+		`Viewport: ${String(preview.viewport.width)}x${String(preview.viewport.height)}`,
+		"Sources:",
+		sources,
+		"After editing the underlying story or component source, rebuild the preview before treating it as visually verified."
+	].join("\n");
+}
 function authorCaptureContext(packet) {
 	const metadata = JSON.stringify(packet);
 	if (bytes(metadata) > 65536) throw new Error("Author capture packet exceeds 64 KiB.");
-	const content = packet.regions.map((region) => `(${String(region.ordinal)}) ${region.comment} [${anchorLocation(region.anchor)}]${region.quote ? `\nQuoted text: ${region.quote}` : ""}`).join("\n\n");
+	const annotations = packet.regions.map((region) => `(${String(region.ordinal)}) ${region.comment} [${anchorLocation(region.anchor)}]${region.quote ? `\nQuoted text: ${region.quote}` : ""}`).join("\n\n");
+	const provenance = storyPreviewProvenance(packet);
+	const content = provenance === void 0 ? annotations : `${provenance}\n\nAnnotations:\n${annotations}`;
 	return {
 		kind: "author-capture",
 		source: "author",
@@ -1356,6 +1376,7 @@ function anchorLabel(anchor) {
 		case "image-rect": return "Image region";
 		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}`;
 	}
 }
 function progressLabel(request) {
@@ -1613,7 +1634,7 @@ function AuthorToolPalette({ sessionId, kind, activeTool }) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/dock/_components/AuthorPanel.tsx
-function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses }) {
+function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses, renderSlot }) {
 	const [captureStatus, setCaptureStatus] = useState();
 	const [capturing, setCapturing] = useState(false);
 	const documents = useStore(authorWorkspace.store, (state) => {
@@ -1624,82 +1645,89 @@ function AuthorPanel({ sessionId, activeMinorModes, submitCapture, statuses }) {
 	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);
-	if (!activeMinorModes?.includes("author") || focused === void 0) return null;
+	if (!activeMinorModes?.includes("author")) return null;
 	return /* @__PURE__ */ jsxs("section", {
 		"data-testid": "author-panel",
 		className: "flex min-h-0 flex-1 flex-col gap-2 overflow-y-auto p-3",
-		children: [sessionId !== null && workspace !== void 0 && focused !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
-			/* @__PURE__ */ jsx("h2", {
-				className: "text-base font-semibold text-doom-text",
-				children: "Annotations"
-			}),
-			/* @__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."
-			}),
-			focused.kind === "video" ? /* @__PURE__ */ jsx("p", {
-				className: "text-base text-doom-dim sm:text-sm",
-				children: "Annotations reference video frames. They do not save changes to the source video."
-			}) : null,
-			/* @__PURE__ */ jsx(AuthorToolPalette, {
-				sessionId,
-				kind: focused.kind,
-				activeTool: workspace.activeTool
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				"data-testid": "author-preview-providers",
+				children: renderSlot("author.preview-provider")
 			}),
-			autonomousVoiceGridVisible(statuses) && grid !== void 0 ? /* @__PURE__ */ jsxs("div", {
-				"data-testid": "author-grid-snapshot",
-				className: "rounded border border-doom-red/40 bg-doom-red/5 p-2 text-base text-doom-dim",
-				children: [/* @__PURE__ */ jsx("strong", {
-					className: "text-doom-red",
-					children: "VOICE GRID A1–H8"
-				}), /* @__PURE__ */ jsxs("p", {
-					className: "mt-1 truncate",
-					children: ["token ", grid.geometryToken]
-				})]
-			}) : null,
-			/* @__PURE__ */ jsx(AuthorRegionDrafts, {
-				sessionId,
-				workspace
-			}, focused.path),
-			workspace.regions.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",
-					variant: "outline",
-					"data-testid": "author-attach-capture",
-					disabled: capturing || workspace.candidate !== void 0 || submitCapture === void 0,
-					onClick: async () => {
-						if (capturing || workspace.candidate || submitCapture === void 0) return;
-						setCapturing(true);
-						setCaptureStatus("Submitting annotations…");
-						try {
-							const packet = createAuthorCapturePacket(crypto.randomUUID(), Date.now(), focused, workspace.regions);
-							await submitCapture({
-								...await multiRegionCaptureProvider(workspace.regions).capture(),
-								context: authorCaptureContext(packet)
-							});
-							setCaptureStatus("Request submitted. You can keep annotating here.");
-						} catch (reason) {
-							setCaptureStatus(reason instanceof Error ? reason.message : String(reason));
-						} finally {
-							setCapturing(false);
-						}
-					},
-					children: capturing ? "Submitting…" : `Submit ${workspace.regions.length} annotation${workspace.regions.length === 1 ? "" : "s"}`
-				}), workspace.candidate ? /* @__PURE__ */ jsx("p", {
+			sessionId !== null && workspace !== void 0 && focused !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+				/* @__PURE__ */ jsx("h2", {
+					className: "text-base font-semibold text-doom-text",
+					children: "Annotations"
+				}),
+				/* @__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."
+				}),
+				focused.kind === "video" ? /* @__PURE__ */ jsx("p", {
 					className: "text-base text-doom-dim sm:text-sm",
-					children: "Add or discard the current selection before submitting."
-				}) : null]
-			}) : null,
-			submitCapture === void 0 ? /* @__PURE__ */ jsx("output", {
-				className: "text-sm text-doom-red",
-				children: "Submission unavailable. Reload to update the app."
-			}) : null,
-			captureStatus ? /* @__PURE__ */ jsx("output", {
-				className: "block text-sm text-doom-dim",
-				children: captureStatus
-			}) : null
-		] }) : null, /* @__PURE__ */ jsx(AuthorRequestLog, { requests: workspace?.requests ?? [] })]
+					children: "Annotations reference video frames. They do not save changes to the source video."
+				}) : null,
+				/* @__PURE__ */ jsx(AuthorToolPalette, {
+					sessionId,
+					kind: focused.kind,
+					activeTool: workspace.activeTool
+				}),
+				autonomousVoiceGridVisible(statuses) && grid !== void 0 ? /* @__PURE__ */ jsxs("div", {
+					"data-testid": "author-grid-snapshot",
+					className: "rounded border border-doom-red/40 bg-doom-red/5 p-2 text-base text-doom-dim",
+					children: [/* @__PURE__ */ jsx("strong", {
+						className: "text-doom-red",
+						children: "VOICE GRID A1–H8"
+					}), /* @__PURE__ */ jsxs("p", {
+						className: "mt-1 truncate",
+						children: ["token ", grid.geometryToken]
+					})]
+				}) : null,
+				/* @__PURE__ */ jsx(AuthorRegionDrafts, {
+					sessionId,
+					workspace
+				}, focused.path),
+				workspace.regions.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",
+						variant: "outline",
+						"data-testid": "author-attach-capture",
+						disabled: capturing || workspace.candidate !== void 0 || submitCapture === void 0,
+						onClick: async () => {
+							if (capturing || workspace.candidate || submitCapture === void 0) return;
+							setCapturing(true);
+							setCaptureStatus("Submitting annotations…");
+							try {
+								const packet = createAuthorCapturePacket(crypto.randomUUID(), Date.now(), focused, workspace.regions);
+								await submitCapture({
+									...await multiRegionCaptureProvider(workspace.regions).capture(),
+									context: authorCaptureContext(packet)
+								});
+								setCaptureStatus("Request submitted. You can keep annotating here.");
+							} catch (reason) {
+								setCaptureStatus(reason instanceof Error ? reason.message : String(reason));
+							} finally {
+								setCapturing(false);
+							}
+						},
+						children: capturing ? "Submitting…" : `Submit ${workspace.regions.length} annotation${workspace.regions.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."
+					}) : null]
+				}) : null,
+				submitCapture === void 0 ? /* @__PURE__ */ jsx("output", {
+					className: "text-sm text-doom-red",
+					children: "Submission unavailable. Reload to update the app."
+				}) : null,
+				captureStatus ? /* @__PURE__ */ jsx("output", {
+					className: "block text-sm text-doom-dim",
+					children: captureStatus
+				}) : null
+			] }) : null,
+			/* @__PURE__ */ jsx(AuthorRequestLog, { requests: workspace?.requests ?? [] })
+		]
 	});
 }
 //#endregion
@@ -1712,16 +1740,31 @@ var authoring_web_default = defineDockFace({
 	panel: AuthorPanel,
 	requiredMinorMode: "author",
 	visibility: {
-		subscribe(listener) {
-			const subscription = authorWorkspace.store.subscribe(listener);
-			return () => subscription.unsubscribe();
+		subscribe() {
+			return () => void 0;
 		},
 		isVisible(sessionId) {
-			return sessionId !== null && authorWorkspace.store.state.sessions[sessionId]?.focusedDocument !== void 0;
+			return sessionId !== null;
 		}
 	}
 });
 //#endregion
+//#region src/types/authorPreview.ts
+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/apiRoutes.ts
 /**
 * This package's routes, as data.
@@ -1856,10 +1899,12 @@ function structuredFormat(path) {
 	if (lower.endsWith(".xlsx")) return "xlsx";
 }
 function authorKindForPath(path) {
+	const lower = path.toLowerCase();
+	if (/\.stories\.(?:js|jsx|ts|tsx)$/u.test(lower)) return "story-preview";
 	const format = structuredFormat(path);
 	if (format === "markdown-slides") return "slides";
 	if (format !== void 0) return format;
-	const extension = path.split(".").at(-1)?.toLowerCase() ?? "";
+	const extension = lower.split(".").at(-1) ?? "";
 	if (extension === "md") return "markdown";
 	if (IMAGE_EXTENSIONS.has(extension)) return "image";
 	if (VIDEO_EXTENSIONS.has(extension)) return "video";
@@ -1927,7 +1972,7 @@ async function loadAuthorDocument(sessionId, path, signal) {
 		};
 	}
 	const mediaUrl = kind === "image" || kind === "video" || kind === "pdf" || kind === "opaque" ? url : void 0;
-	const content = kind === "text" || kind === "markdown" ? await response.text() : void 0;
+	const content = kind === "text" || kind === "markdown" || kind === "story-preview" ? await response.text() : void 0;
 	return {
 		path,
 		kind,
@@ -1985,7 +2030,7 @@ async function croppedImageBytes(documentInput, signal) {
 	}
 }
 async function bytesToSave(sessionId, document, signal) {
-	if (document.kind === "text" || document.kind === "markdown") return document.content ?? "";
+	if (document.kind === "text" || document.kind === "markdown" || document.kind === "story-preview") 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);
@@ -3129,14 +3174,24 @@ function AuthorDocumentPanel(props) {
 	}
 	return /* @__PURE__ */ jsx(ActiveAuthorDocumentPanel, { ...props });
 }
-function ActiveAuthorDocumentPanel({ path, sessionId, statuses }) {
+function ActiveAuthorDocumentPanel(props) {
+	const { path, sessionId, statuses } = props;
 	const document = useStore(authorWorkspace.store, (state) => sessionId === null ? void 0 : state.documents[authorDocumentKey(sessionId, path)]);
 	const focusGeneration = useRef(void 0);
 	const workspace = useStore(authorWorkspace.store, (state) => sessionId === null ? void 0 : state.sessions[sessionId]);
 	const activeTool = workspace?.activeTool ?? "select";
 	const [markdownPreview, setMarkdownPreview] = useState(true);
 	const [status, setStatus] = useState();
+	const [previewOpen, setPreviewOpen] = useState(false);
 	const kind = document?.kind;
+	const previewSource = document === void 0 ? void 0 : {
+		path: document.path,
+		kind: document.kind,
+		hasUnsavedChanges: document.version !== document.savedVersion,
+		revision: document.savedVersion,
+		sourceSha256: document.sourceSha256
+	};
+	const PreviewPanel = (previewSource === void 0 ? void 0 : (props.slotData?.(authorPreviewActionSlot) ?? []).find(({ data }) => data.embeddedPanel !== void 0 && (data.supportsSource === void 0 || data.supportsSource(previewSource))))?.data.embeddedPanel;
 	useEffect(() => {
 		if (document !== void 0 || sessionId === null) return;
 		const controller = new AbortController();
@@ -3202,7 +3257,8 @@ function ActiveAuthorDocumentPanel({ path, sessionId, statuses }) {
 		requestAuthorSave(sessionId, path);
 		setStatus("saving");
 		try {
-			completeAuthorSave(sessionId, path, await saveAuthorDocument(sessionId, document), savedVersion, savedFragments);
+			const sha256 = await saveAuthorDocument(sessionId, document);
+			completeAuthorSave(sessionId, path, sha256, savedVersion, savedFragments);
 			setStatus("saved");
 		} catch (error) {
 			failAuthorSave(sessionId, path, savedVersion);
@@ -3217,6 +3273,18 @@ function ActiveAuthorDocumentPanel({ path, sessionId, statuses }) {
 		preview: document.kind === "markdown" && markdownPreview && activeTool === "select" && !gridVisible,
 		displayedRegions
 	});
+	const sourcePanel = document.kind === "text" || document.kind === "markdown" || document.kind === "story-preview" ? textPanel : document.structuredFormat !== void 0 ? /* @__PURE__ */ jsx(AuthorStructuredView, {
+		sessionId,
+		document,
+		displayedRegions
+	}) : /* @__PURE__ */ jsx(AuthorMediaView, {
+		sessionId,
+		document,
+		activeTool,
+		displayedRegions,
+		pendingCandidate: workspace?.candidate !== void 0,
+		seekRequest: workspace?.videoSeekRequest
+	}, document.path);
 	return /* @__PURE__ */ jsxs("section", {
 		"data-testid": "author-document",
 		className: "flex min-h-0 flex-1 flex-col",
@@ -3228,6 +3296,15 @@ function ActiveAuthorDocumentPanel({ path, sessionId, statuses }) {
 						className: "min-w-0 flex-1 truncate text-base text-doom-hi",
 						children: document.title ?? document.path
 					}),
+					PreviewPanel !== void 0 && previewSource !== void 0 ? /* @__PURE__ */ jsx(Button, {
+						size: "xs",
+						variant: previewOpen ? "primary" : "outline",
+						"data-testid": "author-story-preview-toggle",
+						"aria-pressed": previewOpen,
+						"aria-label": previewOpen ? "show story source" : "show story preview",
+						onClick: () => setPreviewOpen(!previewOpen),
+						children: previewOpen ? "Source" : "Preview"
+					}) : null,
 					document.kind === "markdown" ? /* @__PURE__ */ jsx(Button, {
 						size: "xs",
 						variant: "ghost",
@@ -3244,7 +3321,7 @@ function ActiveAuthorDocumentPanel({ path, sessionId, statuses }) {
 						"data-testid": "author-save",
 						disabled: document.revisions.length === 0 || document.savingVersion !== void 0,
 						onClick: () => void save(),
-						children: "Save"
+						children: previewOpen && previewSource?.hasUnsavedChanges ? "Save & refresh" : "Save"
 					})
 				]
 			}),
@@ -3254,18 +3331,10 @@ function ActiveAuthorDocumentPanel({ path, sessionId, statuses }) {
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: "relative flex min-h-0 flex-1 overflow-hidden",
-				children: [document.kind === "text" || document.kind === "markdown" ? textPanel : document.structuredFormat !== void 0 ? /* @__PURE__ */ jsx(AuthorStructuredView, {
-					sessionId,
-					document,
-					displayedRegions
-				}) : /* @__PURE__ */ jsx(AuthorMediaView, {
-					sessionId,
-					document,
-					activeTool,
-					displayedRegions,
-					pendingCandidate: workspace?.candidate !== void 0,
-					seekRequest: workspace?.videoSeekRequest
-				}, document.path), /* @__PURE__ */ jsx(AuthorGridOverlay, {
+				children: [previewOpen && PreviewPanel !== void 0 && previewSource !== void 0 ? /* @__PURE__ */ jsx(PreviewPanel, {
+					...props,
+					source: previewSource
+				}) : sourcePanel, previewOpen && PreviewPanel !== void 0 && previewSource !== void 0 ? null : /* @__PURE__ */ jsx(AuthorGridOverlay, {
 					sessionId,
 					document,
 					visible: gridVisible
@@ -3411,6 +3480,21 @@ var mode_web_default = defineMinorModeFile({
 	order: 45
 });
 //#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/slot/preview-action.web.ts
+/** Typed data slot for preview launchers that need Author's focused source. */
+var preview_action_web_default = defineSlotFile({
+	slot: "author.preview-action",
+	parse: parseAuthorPreviewAction
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/slot/preview-provider.web.ts
+/**
+* Optional preview providers render launch controls here. The provider owns its
+* transient tab and preview lifecycle; Author owns the surrounding mode and
+* composer submission surface.
+*/
+var preview_provider_web_default = defineSlotFile({});
+//#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/tool/_lib/describeAuthorToolsToolRender.ts
 function describeAuthorToolsCallSummary(_args) {
 	return "";
@@ -3621,6 +3705,9 @@ const webPlugin = defineWebPlugin({
 		get minorModes() {
 			return [via({ name: "author" }, mode_web_default)];
 		},
+		get slots() {
+			return [via({ slot: "author.preview-action" }, preview_action_web_default), via({ slot: "author.preview-provider" }, preview_provider_web_default)];
+		},
 		get start() {
 			return start_web_default;
 		},