@agimon-ai/po-file-edit 0.0.0-alpha.21 → 0.0.0-alpha.23

package/dist/extensions/native.mjs

@@ -1,28 +1,36 @@
-import { defineChannelFile, defineNativePlugin, defineSessionStore } from "@agimon-ai/po-core/native";
+import { createApiClient, defineChannelFile, defineFileLinks, defineNativePlugin, defineSessionStore, nativeApiTransport, sessionApiAddress } from "@agimon-ai/po-core/native";
+import { View } from "react-native-unistyles/components/native/View";
+import { Text } from "react-native-unistyles/components/native/Text";
+import { ScrollView } from "react-native-unistyles/components/native/ScrollView";
+import { Button, CloseIcon, CodeBlock, CopyButton, DownloadIcon, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, KebabIcon, Label, Markdown, SegmentedControl, Sheet, SheetBody, SheetContent, SheetHeader, SheetTitle, Textarea, fontOf } from "@agimon-ai/po-native-components";
+import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "react";
+import { StyleSheet } from "react-native-unistyles";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/types/webFiles.ts
 /** The frame type the hub publishes and the web plugin claims; declared in the poWeb block too. */
 const filesChannelType = "file_edits";
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/_lib/filesModel.ts
-function isRecord(value) {
+function isRecord$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isItem(value) {
-	return isRecord(value) && typeof value.path === "string" && typeof value.relPath === "string" && typeof value.tool === "string" && typeof value.at === "number" && typeof value.count === "number";
+	return isRecord$1(value) && typeof value.path === "string" && typeof value.relPath === "string" && typeof value.tool === "string" && typeof value.at === "number" && typeof value.count === "number";
 }
 /** The shared wire gate for browser and native stores. */
 function parseFilesPayload(input) {
-	if (!isRecord(input) || !Array.isArray(input.items)) return null;
+	if (!isRecord$1(input) || !Array.isArray(input.items)) return null;
 	return { items: input.items.filter(isItem) };
 }
-/** The plugin's session data channel: 'file_edits' payloads into the store. */
-const filesChannel = defineSessionStore({
+const files = defineSessionStore({
 	items: [],
 	detail: {},
 	loading: [],
 	errors: {},
 	comments: []
-}).channel({
+});
+/** The plugin's session data channel: 'file_edits' payloads into the store. */
+const filesChannel = files.channel({
 	channel: filesChannelType,
 	parse: parseFilesPayload,
 	reduce: (current, { items }) => ({
@@ -30,10 +38,1206 @@ const filesChannel = defineSessionStore({
 		items
 	})
 });
+function markLoading(sessionId, filePath) {
+	files.update(sessionId, (current) => current.loading.includes(filePath) ? current : {
+		...current,
+		loading: [...current.loading, filePath],
+		errors: withoutKey(current.errors, filePath)
+	});
+}
+function storeDetail(sessionId, detail) {
+	files.update(sessionId, (current) => ({
+		...current,
+		detail: {
+			...current.detail,
+			[detail.path]: detail
+		},
+		loading: current.loading.filter((path) => path !== detail.path),
+		errors: withoutKey(current.errors, detail.path)
+	}));
+}
+function storeError(sessionId, filePath, message) {
+	files.update(sessionId, (current) => ({
+		...current,
+		loading: current.loading.filter((path) => path !== filePath),
+		errors: {
+			...current.errors,
+			[filePath]: message
+		}
+	}));
+}
+function addComment(sessionId, comment) {
+	files.update(sessionId, (current) => ({
+		...current,
+		comments: [...current.comments, comment]
+	}));
+}
+function removeComment(sessionId, id) {
+	files.update(sessionId, (current) => ({
+		...current,
+		comments: current.comments.filter((comment) => comment.id !== id)
+	}));
+}
+function clearComments(sessionId, filePath) {
+	files.update(sessionId, (current) => ({
+		...current,
+		comments: current.comments.filter((comment) => comment.path !== filePath)
+	}));
+}
+function withoutKey(source, key) {
+	return Object.fromEntries(Object.entries(source).filter(([entry]) => entry !== key));
+}
 //#endregion
 //#region src/extensions/workspaces/sessions/(frontend)/channel/file-edits.native.ts
 var file_edits_native_default = defineChannelFile(filesChannel);
 //#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_lib/fileIdentity.ts
+/** A short, stable fingerprint of a string; enough to separate two paths in an id. */
+function fingerprint(value) {
+	let hash = 2166136261;
+	for (let index = 0; index < value.length; index += 1) {
+		hash ^= value.charCodeAt(index);
+		hash = Math.imul(hash, 16777619);
+	}
+	return (hash >>> 0).toString(36);
+}
+/** The transient tab id for one file; stable, so reopening focuses rather than duplicates. */
+function fileTabId(filePath) {
+	const slug = filePath.replaceAll(/[^a-zA-Z0-9]+/gu, "-").replace(/^-|-$/gu, "");
+	return `files-file-${fingerprint(filePath)}-${slug.slice(-40)}`;
+}
+const api = createApiClient({
+	detail: {
+		method: "GET",
+		path: "/detail",
+		query: ["path"],
+		response: void 0
+	},
+	preview: {
+		method: "GET",
+		path: "/preview",
+		query: ["path"],
+		response: void 0
+	},
+	save: {
+		method: "PUT",
+		path: "/content",
+		response: void 0
+	},
+	/** The same path as `save`; the method is the whole of the difference. */
+	remove: {
+		method: "DELETE",
+		path: "/content",
+		query: ["path"]
+	},
+	/**
+	* The host's own bytes route, not this package's.
+	*
+	* `host: true` hangs it off the session root rather than under `/plugins`,
+	* which is how the cockpit already serves it. Declaring it here is the first
+	* time anything records that this package's previews depend on it.
+	*/
+	file: {
+		method: "GET",
+		path: "/file",
+		raw: true,
+		query: ["path"],
+		host: true
+	}
+}, {
+	scopes: ["session"],
+	basePath: "file-edits",
+	transport: nativeApiTransport,
+	sessionAddress: sessionApiAddress
+});
+//#endregion
+//#region src/types/fileEditsApi.ts
+/** Query parameter naming the file a request is about. */
+const PATH_QUERY_PARAM = "path";
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_lib/filesApi.native.ts
+/**
+* The page's half of this package's session API: one file's history, the
+* manual save, and the deletion.
+*
+* These are adapters now, not a transport. The generated client owns the URL
+* and the sealed transport with it, so nothing here spells a route or reaches
+* for `fetch`. What stays is this package's own vocabulary: which refusals the
+* reader is shown, and the stale-save contract the editor depends on.
+*
+* Sealing still matters and still happens, one layer down. What travels here is
+* file contents in both directions, which is the worst thing in the cockpit to
+* hand a tunnel's relay in the clear.
+*/
+const UNREACHABLE = "The session is unreachable.";
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The message a reader is shown: the route's own words, or why there were none. */
+function messageOf(result) {
+	if (result.status === 0) return UNREACHABLE;
+	return result.error === "" ? `The session answered ${result.status}.` : result.error;
+}
+async function fetchFileDetail(sessionId, filePath) {
+	const result = await api.session(sessionId).detail({ query: { [PATH_QUERY_PARAM]: filePath } });
+	if (!result.ok) return {
+		ok: false,
+		error: messageOf(result)
+	};
+	if (!isRecord(result.data)) return {
+		ok: false,
+		error: "The session answered with no detail."
+	};
+	return {
+		ok: true,
+		detail: result.data
+	};
+}
+/** One file the session never changed, read only; the route bounds it to the working directory. */
+async function fetchFilePreview(sessionId, filePath) {
+	const result = await api.session(sessionId).preview({ query: { [PATH_QUERY_PARAM]: filePath } });
+	if (!result.ok) return {
+		ok: false,
+		error: messageOf(result)
+	};
+	if (!isRecord(result.data)) return {
+		ok: false,
+		error: "The session answered with no file."
+	};
+	return {
+		ok: true,
+		preview: result.data
+	};
+}
+async function saveFileContent(sessionId, filePath, expectedHash, content) {
+	const result = await api.session(sessionId).save({ body: {
+		path: filePath,
+		expectedHash,
+		content
+	} });
+	if (result.status === 409) {
+		const data = result.ok ? void 0 : result.data;
+		const hash = isRecord(data) && typeof data.hash === "string" ? data.hash : void 0;
+		return {
+			ok: false,
+			stale: true,
+			error: result.ok ? "The file changed since it was opened." : messageOf(result),
+			...hash === void 0 ? {} : { hash }
+		};
+	}
+	if (!result.ok) return {
+		ok: false,
+		stale: false,
+		error: messageOf(result)
+	};
+	return {
+		ok: true,
+		hash: isRecord(result.data) && typeof result.data.hash === "string" ? result.data.hash : ""
+	};
+}
+/**
+* Removes the file from disk.
+*
+* The route takes only a path, with no hash to prove the reader saw what is
+* there now: a deletion discards the file whatever it holds, so a staleness
+* check would guard nothing. The confirmation in front of it is the guard.
+*/
+async function deleteFile(sessionId, filePath) {
+	const result = await api.session(sessionId).remove({ query: { [PATH_QUERY_PARAM]: filePath } });
+	return result.ok ? { ok: true } : {
+		ok: false,
+		error: messageOf(result)
+	};
+}
+/** Binds a save to this package's guarded sealed route and one file version. */
+async function prepareFileSave(sessionId, path, signal) {
+	const load = async (headers, signal) => {
+		if (signal.aborted) throw new Error("Download cancelled.");
+		const result = await api.session(sessionId).file({
+			query: { path },
+			headers,
+			signal
+		});
+		if (!result.ok && result.status !== 416) throw new Error(result.error || "File could not be read.");
+		if (!result.response) throw new Error("File could not be read.");
+		return result.response;
+	};
+	const probe = await load({ Range: "bytes=0-0" }, signal);
+	if (signal.aborted) throw new Error("Download cancelled.");
+	const range = /^bytes 0-0\/(\d+)$/u.exec(probe.headers.get("content-range") ?? "");
+	const empty = probe.status === 416 && probe.headers.get("content-range") === "bytes */0" || probe.status === 200 && probe.headers.get("content-length") === "0";
+	if (!empty && (probe.status !== 206 || !range)) throw new Error("The file does not support bounded downloads.");
+	const size = empty ? 0 : Number(range[1]);
+	if (!Number.isSafeInteger(size) || size < 0) throw new Error("Invalid file size.");
+	if ((await probe.arrayBuffer()).byteLength !== (empty ? 0 : 1)) throw new Error("Invalid file response.");
+	const version = probe.headers.get("etag");
+	if (!version) throw new Error("The file has no version validator.");
+	return {
+		name: path.split(/[\\/]/u).at(-1) ?? "",
+		mimeType: probe.headers.get("content-type")?.split(";")[0]?.trim() || "application/octet-stream",
+		size,
+		signal,
+		read: async (offset, count, signal) => {
+			if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(count) || offset < 0 || count < 1 || count > 1048576 || offset + count > size) throw new Error("Invalid download range.");
+			const end = offset + count - 1;
+			const response = await load({
+				Range: `bytes=${offset}-${end}`,
+				"If-Match": version
+			}, signal);
+			if (signal.aborted) throw new Error("Download cancelled.");
+			if (response.status !== 206 || response.headers.get("etag") !== version || response.headers.get("content-range") !== `bytes ${offset}-${end}/${size}`) throw new Error("The file changed or its range response is invalid.");
+			const bytes = new Uint8Array(await response.arrayBuffer());
+			if (signal.aborted) throw new Error("Download cancelled.");
+			if (bytes.byteLength !== count) throw new Error("The file response is incomplete.");
+			return bytes;
+		}
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_components/FilePreview.native.tsx
+const MEDIA = /\.(?:png|jpe?g|gif|webp|bmp|svg|ico|mp3|wav|m4a|ogg|mp4|mov|webm|pdf)$/iu;
+const MAX_MEDIA_BYTES = 5242880;
+const URL_OR_ANCHOR = /^(?:[a-z][a-z\d+.-]*:|\/\/|#|\?)/iu;
+function isMediaPath(path) {
+	return MEDIA.test(path);
+}
+function base64(bytes) {
+	const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+	const parts = [];
+	let chunk = "";
+	for (let offset = 0; offset < bytes.length; offset += 3) {
+		const first = bytes[offset];
+		const second = bytes[offset + 1];
+		const third = bytes[offset + 2];
+		chunk += alphabet[first >> 2] + alphabet[(first & 3) << 4 | (second ?? 0) >> 4] + (second === void 0 ? "=" : alphabet[(second & 15) << 2 | (third ?? 0) >> 6]) + (third === void 0 ? "=" : alphabet[third & 63]);
+		if (chunk.length >= 8192) {
+			parts.push(chunk);
+			chunk = "";
+		}
+	}
+	parts.push(chunk);
+	return parts.join("");
+}
+/** One media file's bytes through the package's guarded file route, as base64 with its content type. */
+async function fetchMedia(sessionId, path, signal) {
+	const result = await api.session(sessionId).file({
+		query: { path },
+		signal
+	});
+	if (!result.ok) throw new Error(result.error || `Media could not be loaded (${result.status}).`);
+	if (Number(result.response.headers.get("content-length")) > MAX_MEDIA_BYTES) throw new Error("This media is too large to preview.");
+	const bytes = new Uint8Array(await result.response.arrayBuffer());
+	if (bytes.length > MAX_MEDIA_BYTES) throw new Error("This media is too large to preview.");
+	const type = result.response.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase() ?? "";
+	if (!/^(?:image\/[a-z0-9.+-]+|audio\/[a-z0-9.+-]+|video\/[a-z0-9.+-]+|application\/pdf)$/u.test(type)) throw new Error("This media type cannot be previewed.");
+	return {
+		data: base64(bytes),
+		type
+	};
+}
+/** A Markdown image path, read against the document's own folder as GitHub reads it. */
+function documentRelative(documentPath, source) {
+	if (source.startsWith("/")) return source;
+	const parts = documentPath.split("/").slice(0, -1);
+	for (const segment of source.split("/")) if (segment === "..") parts.pop();
+	else if (segment !== "." && segment !== "") parts.push(segment);
+	return parts.join("/");
+}
+function SessionMedia({ sessionId, path, renderMediaPreview }) {
+	const [loaded, setLoaded] = useState();
+	useEffect(() => {
+		if (sessionId === null) return;
+		const controller = new AbortController();
+		(async () => {
+			const { data, type } = await fetchMedia(sessionId, path, controller.signal);
+			if (!controller.signal.aborted) setLoaded({
+				sessionId,
+				path,
+				type,
+				data
+			});
+		})().catch((failure) => {
+			if (!controller.signal.aborted) setLoaded({
+				sessionId,
+				path,
+				error: failure instanceof Error ? failure.message : String(failure)
+			});
+		});
+		return () => controller.abort();
+	}, [sessionId, path]);
+	const current = loaded?.sessionId === sessionId && loaded.path === path ? loaded : void 0;
+	if (!current?.data) return /* @__PURE__ */ jsx(Text, {
+		accessibilityRole: current?.error ? "alert" : "text",
+		style: current?.error ? styles$2.error : styles$2.meta,
+		children: current?.error ?? "Loading media..."
+	});
+	return renderMediaPreview ? /* @__PURE__ */ jsx(Fragment, { children: renderMediaPreview({
+		key: `file-media-${sessionId}-${path}`,
+		data: current.data,
+		mimeType: current.type,
+		title: path,
+		path
+	}) }) : /* @__PURE__ */ jsx(Text, {
+		style: styles$2.error,
+		children: "This host cannot display this media preview."
+	});
+}
+/** Rendering is separate from reading: only the guarded package API supplies file content or bytes. */
+function FilePreview({ path, working, ...props }) {
+	if (MEDIA.test(path)) return /* @__PURE__ */ jsx(SessionMedia, {
+		sessionId: props.sessionId,
+		path,
+		renderMediaPreview: props.renderMediaPreview
+	});
+	if (working.unavailable) return /* @__PURE__ */ jsx(Text, {
+		style: styles$2.meta,
+		children: working.reason ?? "this file cannot be shown"
+	});
+	if (/\.html?$/iu.test(path)) return props.renderFilePreview ? /* @__PURE__ */ jsx(View, {
+		style: styles$2.html,
+		children: props.renderFilePreview({
+			key: `file-html-${props.sessionId}-${path}`,
+			html: working.content,
+			title: path
+		})
+	}) : /* @__PURE__ */ jsx(Text, {
+		style: styles$2.error,
+		children: "This host cannot display HTML previews."
+	});
+	if (/\.(?:md|markdown)$/iu.test(path)) {
+		const { sessionId } = props;
+		return /* @__PURE__ */ jsx(Markdown, {
+			text: working.content,
+			onFileLink: (file) => {
+				const tab = props.fileTabFor(file);
+				return tab ? () => props.openTransientTab(tab) : void 0;
+			},
+			loadImage: async (source) => {
+				if (sessionId === null || URL_OR_ANCHOR.test(source)) throw new Error("This image cannot be loaded.");
+				const media = await fetchMedia(sessionId, documentRelative(path, source), new AbortController().signal);
+				if (!media.type.startsWith("image/")) throw new Error("This file is not an image.");
+				return {
+					url: `data:${media.type};base64,${media.data}`,
+					dispose: () => {}
+				};
+			}
+		});
+	}
+	return /* @__PURE__ */ jsx(CodeBlock, {
+		text: working.content,
+		language: path.split(".").at(-1)
+	});
+}
+const styles$2 = StyleSheet.create((theme) => ({
+	html: {
+		minHeight: theme.spacing(90),
+		uni__dependencies: [0]
+	},
+	meta: {
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.dim,
+		uni__dependencies: [0]
+	},
+	error: {
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.red,
+		uni__dependencies: [0]
+	}
+}));
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_components/FilePanel.native.tsx
+function Diff({ hunks, comment }) {
+	return /* @__PURE__ */ jsx(View, {
+		style: styles$1.diff,
+		children: hunks.map((hunk, index) => /* @__PURE__ */ jsxs(View, { children: [/* @__PURE__ */ jsxs(Text, {
+			style: styles$1.meta,
+			children: ["line ", hunk.start]
+		}), hunk.rows.map((row, position) => /* @__PURE__ */ jsx(Button, {
+			variant: "ghost",
+			accessibilityLabel: `comment on ${row.marker === "-" ? "removed" : "new"} line ${row.line}`,
+			onPress: () => comment({
+				snippet: row.content,
+				side: row.marker === "-" ? "old" : "new",
+				startLine: row.line,
+				endLine: row.line
+			}),
+			children: /* @__PURE__ */ jsxs(Text, {
+				selectable: true,
+				style: row.marker === "+" ? styles$1.added : row.marker === "-" ? styles$1.removed : styles$1.code,
+				children: [
+					row.marker,
+					" ",
+					row.line,
+					" ",
+					row.content
+				]
+			})
+		}, `${row.line}-${position}`))] }, `${hunk.start}-${index}`))
+	});
+}
+function ReviewSheet({ selection, close, submit }) {
+	const [body, setBody] = useState("");
+	const [snippet, setSnippet] = useState(selection.snippet);
+	return /* @__PURE__ */ jsx(Sheet, {
+		open: true,
+		onOpenChange: (open) => {
+			if (!open) close();
+		},
+		children: /* @__PURE__ */ jsxs(SheetContent, { children: [/* @__PURE__ */ jsx(SheetHeader, { children: /* @__PURE__ */ jsx(SheetTitle, { children: "review comment" }) }), /* @__PURE__ */ jsxs(SheetBody, { children: [
+			/* @__PURE__ */ jsx(Label, { children: "quotation" }),
+			/* @__PURE__ */ jsx(Textarea, {
+				accessibilityLabel: "quotation",
+				value: snippet,
+				onChangeText: setSnippet,
+				rows: 3
+			}),
+			/* @__PURE__ */ jsx(Label, { children: "comment" }),
+			/* @__PURE__ */ jsx(Textarea, {
+				accessibilityLabel: "comment",
+				value: body,
+				onChangeText: setBody,
+				rows: 3
+			}),
+			/* @__PURE__ */ jsxs(View, {
+				style: styles$1.actions,
+				children: [/* @__PURE__ */ jsx(Button, {
+					variant: "ghost",
+					onPress: close,
+					children: "cancel"
+				}), /* @__PURE__ */ jsx(Button, {
+					variant: "primary",
+					disabled: !body.trim(),
+					onPress: () => submit(body.trim(), snippet),
+					children: "add comment"
+				})]
+			})
+		] })] })
+	});
+}
+/** File writes retain the existing containment and stale-hash guards; deletion always asks first. */
+function FilePanel({ filePath, relPath, ...props }) {
+	const { sessionId, sendSessionFrame, closeTransientTab } = props;
+	const subscribe = useCallback((listener) => {
+		const subscription = files.store.subscribe(listener);
+		return () => subscription.unsubscribe();
+	}, []);
+	const session = useSyncExternalStore(subscribe, () => files.select(files.store.state, sessionId));
+	const detail = session.detail[filePath];
+	const working = detail?.working;
+	const comments = session.comments.filter((comment) => comment.path === filePath);
+	const [view, setView] = useState("preview");
+	const [source, setSource] = useState();
+	const [expanded, setExpanded] = useState();
+	const [selection, setSelection] = useState();
+	const [draft, setDraft] = useState();
+	const [confirmingDelete, setConfirmingDelete] = useState(false);
+	const [busy, setBusy] = useState(false);
+	const [note, setNote] = useState();
+	const [reviewError, setReviewError] = useState();
+	const outside = relPath === ".." || relPath.startsWith("../") || relPath.startsWith("/") || relPath.startsWith("..\\") || /^[a-z]:[\\/]/iu.test(relPath);
+	const writable = sessionId !== null && !outside && working !== void 0 && !working.unavailable;
+	const revision = session.items.find((item) => item.path === filePath)?.count ?? 0;
+	useEffect(() => {
+		if (sessionId === null) return;
+		let cancelled = false;
+		markLoading(sessionId, filePath);
+		fetchFileDetail(sessionId, filePath).then((result) => {
+			if (cancelled) return;
+			if (result.ok) {
+				storeDetail(sessionId, result.detail);
+				setSource(void 0);
+				setNote(void 0);
+			} else storeError(sessionId, filePath, result.error);
+		}).catch((failure) => {
+			if (!cancelled) storeError(sessionId, filePath, failure instanceof Error ? failure.message : String(failure));
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		sessionId,
+		filePath,
+		revision
+	]);
+	const downloadController = useRef(void 0);
+	useEffect(() => () => downloadController.current?.abort(), [sessionId, relPath]);
+	const download = async () => {
+		if (sessionId === null || outside || busy || !props.nativeSaveFile) return;
+		const controller = new AbortController();
+		downloadController.current = controller;
+		setBusy(true);
+		try {
+			await props.nativeSaveFile(await prepareFileSave(sessionId, relPath, controller.signal));
+			if (!controller.signal.aborted) setNote("saved");
+		} catch (error) {
+			if (!controller.signal.aborted) setNote(error instanceof Error ? error.message : String(error));
+		} finally {
+			setBusy(false);
+		}
+	};
+	const save = async () => {
+		if (!writable || sessionId === null || !working || source === void 0 || busy) return;
+		setBusy(true);
+		try {
+			const result = await saveFileContent(sessionId, filePath, working.hash, source);
+			if (!result.ok) {
+				setNote(result.error);
+				return;
+			}
+			setNote("saved");
+			const refreshed = await fetchFileDetail(sessionId, filePath);
+			if (refreshed.ok) {
+				storeDetail(sessionId, refreshed.detail);
+				setSource(void 0);
+			} else storeError(sessionId, filePath, refreshed.error);
+		} catch (failure) {
+			setNote(failure instanceof Error ? failure.message : String(failure));
+		} finally {
+			setBusy(false);
+		}
+	};
+	const remove = async () => {
+		if (!writable || sessionId === null || busy) return;
+		setBusy(true);
+		try {
+			const result = await deleteFile(sessionId, filePath);
+			if (!result.ok) {
+				storeError(sessionId, filePath, result.error);
+				setConfirmingDelete(false);
+			} else {
+				setConfirmingDelete(false);
+				closeTransientTab(fileTabId(filePath));
+			}
+		} catch (failure) {
+			storeError(sessionId, filePath, failure instanceof Error ? failure.message : String(failure));
+			setConfirmingDelete(false);
+		} finally {
+			setBusy(false);
+		}
+	};
+	const sendReview = () => {
+		if (sessionId === null || comments.length === 0) return;
+		const message = `I left ${comments.length} review ${comments.length === 1 ? "comment" : "comments"} on files you changed. Please address them.\n\n` + comments.map((comment) => {
+			return `### ${comment.startLine === void 0 ? comment.relPath : comment.side === "old" ? `${comment.relPath} (removed line ${comment.startLine})` : `${comment.relPath}:${comment.startLine}`}\n\n${comment.snippet.split("\n").slice(0, 20).join("\n").slice(0, 2e3).split("\n").map((line) => `> ${line}`).join("\n")}\n\n${comment.body.trim()}`;
+		}).join("\n\n");
+		try {
+			sendSessionFrame(sessionId, {
+				type: "follow_up",
+				message
+			});
+			clearComments(sessionId, filePath);
+			setReviewError(void 0);
+		} catch (failure) {
+			setReviewError(failure instanceof Error ? failure.message : String(failure));
+		}
+	};
+	return /* @__PURE__ */ jsxs(ScrollView, {
+		testID: "files-file-panel",
+		contentContainerStyle: styles$1.panel,
+		children: [
+			/* @__PURE__ */ jsxs(View, {
+				style: styles$1.header,
+				children: [/* @__PURE__ */ jsx(Text, {
+					selectable: true,
+					style: styles$1.path,
+					children: relPath
+				}), /* @__PURE__ */ jsxs(DropdownMenu, { children: [/* @__PURE__ */ jsx(DropdownMenuTrigger, {
+					variant: "ghost",
+					size: "icon",
+					accessibilityLabel: "file actions",
+					children: /* @__PURE__ */ jsx(KebabIcon, {})
+				}), /* @__PURE__ */ jsxs(DropdownMenuContent, { children: [
+					/* @__PURE__ */ jsx(DropdownMenuItem, {
+						disabled: sessionId === null || outside || busy || !props.nativeSaveFile,
+						onSelect: () => void download(),
+						children: "download"
+					}),
+					busy ? /* @__PURE__ */ jsx(DropdownMenuItem, {
+						onSelect: () => downloadController.current?.abort(),
+						children: "cancel download"
+					}) : null,
+					/* @__PURE__ */ jsx(DropdownMenuItem, {
+						disabled: !writable,
+						onSelect: () => setView("edit"),
+						children: "edit"
+					}),
+					/* @__PURE__ */ jsx(DropdownMenuItem, {
+						variant: "destructive",
+						disabled: !writable,
+						onSelect: () => setConfirmingDelete(true),
+						children: "delete"
+					}),
+					/* @__PURE__ */ jsx(DropdownMenuItem, {
+						onSelect: () => closeTransientTab(fileTabId(filePath)),
+						children: "close"
+					})
+				] })] })]
+			}),
+			view !== "edit" && note ? /* @__PURE__ */ jsx(Text, {
+				style: note === "saved" ? styles$1.success : styles$1.error,
+				children: note
+			}) : null,
+			/* @__PURE__ */ jsx(SegmentedControl, {
+				accessibilityLabel: "file view",
+				options: [{
+					value: "preview",
+					label: "preview"
+				}, {
+					value: "diff",
+					label: "diff"
+				}],
+				value: view,
+				onValueChange: setView
+			}),
+			view === "edit" ? /* @__PURE__ */ jsx(Text, {
+				style: styles$1.meta,
+				children: "editing"
+			}) : null,
+			session.loading.includes(filePath) && !detail ? /* @__PURE__ */ jsx(Text, {
+				style: styles$1.meta,
+				children: "reading this file's history…"
+			}) : null,
+			session.errors[filePath] ? /* @__PURE__ */ jsx(Text, {
+				accessibilityRole: "alert",
+				style: styles$1.error,
+				children: session.errors[filePath]
+			}) : null,
+			detail ? view === "diff" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+				/* @__PURE__ */ jsxs(Text, {
+					style: styles$1.meta,
+					children: [
+						"+",
+						detail.cumulative.additions,
+						" -",
+						detail.cumulative.removals
+					]
+				}),
+				detail.cumulative.note ? /* @__PURE__ */ jsx(Text, {
+					style: styles$1.meta,
+					children: detail.cumulative.note
+				}) : null,
+				detail.cumulative.hunks ? /* @__PURE__ */ jsx(Diff, {
+					hunks: detail.cumulative.hunks,
+					comment: setDraft
+				}) : null,
+				/* @__PURE__ */ jsxs(Text, {
+					style: styles$1.title,
+					children: [detail.versions.length, " changes this session"]
+				}),
+				detail.versions.map((version) => /* @__PURE__ */ jsxs(View, { children: [/* @__PURE__ */ jsxs(Button, {
+					variant: "ghost",
+					accessibilityState: { expanded: expanded === version.index },
+					onPress: () => setExpanded(expanded === version.index ? void 0 : version.index),
+					children: [
+						"#",
+						version.index,
+						" ",
+						version.tool,
+						" +",
+						version.additions,
+						" -",
+						version.removals,
+						version.origin === "scan" ? " · no baseline" : ""
+					]
+				}), expanded === version.index ? version.hunks ? /* @__PURE__ */ jsx(Diff, {
+					hunks: version.hunks,
+					comment: setDraft
+				}) : /* @__PURE__ */ jsx(Text, {
+					style: styles$1.meta,
+					children: version.note ?? "nothing to show"
+				}) : null] }, version.index))
+			] }) : view === "edit" ? /* @__PURE__ */ jsxs(Fragment, { children: [writable ? /* @__PURE__ */ jsxs(Fragment, { children: [
+				/* @__PURE__ */ jsx(Textarea, {
+					accessibilityLabel: "file source",
+					value: source ?? working?.content ?? "",
+					onChangeText: setSource,
+					rows: 12,
+					onSelectionChange: (event) => {
+						const content = source ?? working?.content ?? "";
+						const { start, end } = event.nativeEvent.selection;
+						setSelection(end > start ? {
+							snippet: content.slice(start, end),
+							startLine: content.slice(0, start).split("\n").length,
+							endLine: content.slice(0, end).split("\n").length
+						} : void 0);
+					}
+				}),
+				/* @__PURE__ */ jsxs(View, {
+					style: styles$1.actions,
+					children: [/* @__PURE__ */ jsx(Button, {
+						variant: "primary",
+						disabled: source === void 0 || busy,
+						onPress: () => void save(),
+						children: "save to disk"
+					}), /* @__PURE__ */ jsx(Button, {
+						variant: "ghost",
+						disabled: source === void 0,
+						onPress: () => setSource(void 0),
+						children: "discard edits"
+					})]
+				}),
+				/* @__PURE__ */ jsx(Button, {
+					variant: "ghost",
+					disabled: !selection,
+					onPress: () => setDraft(selection),
+					children: "comment on selection"
+				})
+			] }) : /* @__PURE__ */ jsx(Text, {
+				style: styles$1.meta,
+				children: working?.reason ?? "this file cannot be edited"
+			}), note ? /* @__PURE__ */ jsx(Text, {
+				style: note === "saved" ? styles$1.success : styles$1.error,
+				children: note
+			}) : null] }) : working ? /* @__PURE__ */ jsx(FilePreview, {
+				...props,
+				path: relPath,
+				working: {
+					...working,
+					content: source ?? working.content
+				}
+			}) : null : null,
+			detail && sessionId !== null ? /* @__PURE__ */ jsx(Button, {
+				variant: "ghost",
+				onPress: () => setDraft({ snippet: "" }),
+				children: "add review comment"
+			}) : null,
+			comments.length ? /* @__PURE__ */ jsxs(View, {
+				style: styles$1.diff,
+				children: [
+					/* @__PURE__ */ jsxs(Button, {
+						variant: "outline",
+						disabled: sessionId === null,
+						onPress: sendReview,
+						children: [
+							"send review (",
+							comments.length,
+							")"
+						]
+					}),
+					reviewError ? /* @__PURE__ */ jsxs(Text, {
+						accessibilityRole: "alert",
+						style: styles$1.error,
+						children: ["review not sent: ", reviewError]
+					}) : null,
+					comments.map((comment) => /* @__PURE__ */ jsxs(View, { children: [/* @__PURE__ */ jsxs(Text, {
+						style: styles$1.meta,
+						children: [
+							comment.relPath,
+							comment.startLine === void 0 ? "" : `:${comment.startLine}`,
+							" · ",
+							comment.body
+						]
+					}), /* @__PURE__ */ jsx(Button, {
+						variant: "ghost",
+						onPress: () => {
+							if (sessionId !== null) removeComment(sessionId, comment.id);
+						},
+						children: "remove comment"
+					})] }, comment.id))
+				]
+			}) : null,
+			draft ? /* @__PURE__ */ jsx(ReviewSheet, {
+				selection: draft,
+				close: () => setDraft(void 0),
+				submit: (body, snippet) => {
+					if (sessionId !== null) addComment(sessionId, {
+						id: `${filePath}:${draft.side ?? "new"}:${draft.startLine ?? 0}:${comments.length}:${body.length}`,
+						path: filePath,
+						relPath,
+						...draft,
+						snippet,
+						body
+					});
+					setDraft(void 0);
+				}
+			}) : null,
+			confirmingDelete ? /* @__PURE__ */ jsx(Sheet, {
+				open: true,
+				onOpenChange: (open) => {
+					if (!open) setConfirmingDelete(false);
+				},
+				children: /* @__PURE__ */ jsxs(SheetContent, { children: [/* @__PURE__ */ jsx(SheetHeader, { children: /* @__PURE__ */ jsx(SheetTitle, { children: "delete file" }) }), /* @__PURE__ */ jsxs(SheetBody, { children: [/* @__PURE__ */ jsxs(Text, {
+					style: styles$1.meta,
+					children: [
+						"This removes ",
+						relPath,
+						" from disk. It cannot be undone here."
+					]
+				}), /* @__PURE__ */ jsxs(View, {
+					style: styles$1.actions,
+					children: [/* @__PURE__ */ jsx(Button, {
+						variant: "ghost",
+						onPress: () => setConfirmingDelete(false),
+						children: "cancel"
+					}), /* @__PURE__ */ jsx(Button, {
+						variant: "danger",
+						disabled: !writable || busy,
+						onPress: () => void remove(),
+						children: "delete"
+					})]
+				})] })] })
+			}) : null
+		]
+	});
+}
+function fileTab(filePath, relPath) {
+	return {
+		id: fileTabId(filePath),
+		label: relPath.split("/").at(-1) ?? relPath,
+		panel: (props) => /* @__PURE__ */ jsx(FilePanel, {
+			...props,
+			filePath,
+			relPath
+		})
+	};
+}
+const styles$1 = StyleSheet.create((theme) => ({
+	panel: {
+		padding: theme.spacing(4),
+		gap: theme.spacing(3),
+		uni__dependencies: [0]
+	},
+	header: {
+		flexDirection: "row",
+		alignItems: "center",
+		gap: theme.spacing(2),
+		uni__dependencies: [0]
+	},
+	actions: {
+		flexDirection: "row",
+		flexWrap: "wrap",
+		gap: theme.spacing(2),
+		uni__dependencies: [0]
+	},
+	diff: {
+		gap: theme.spacing(2),
+		uni__dependencies: [0]
+	},
+	title: {
+		fontSize: theme.fontSize.base,
+		fontWeight: "600",
+		color: theme.colors.hi,
+		uni__dependencies: [0]
+	},
+	path: {
+		flex: 1,
+		fontFamily: fontOf(theme.fontFamily.mono),
+		fontSize: theme.fontSize.base,
+		color: theme.colors.hi,
+		uni__dependencies: [0]
+	},
+	code: {
+		fontFamily: fontOf(theme.fontFamily.mono),
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.text,
+		uni__dependencies: [0]
+	},
+	added: {
+		fontFamily: fontOf(theme.fontFamily.mono),
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.green,
+		uni__dependencies: [0]
+	},
+	removed: {
+		fontFamily: fontOf(theme.fontFamily.mono),
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.red,
+		uni__dependencies: [0]
+	},
+	meta: {
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.dim,
+		uni__dependencies: [0]
+	},
+	error: {
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.red,
+		uni__dependencies: [0]
+	},
+	success: {
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.green,
+		uni__dependencies: [0]
+	}
+}));
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/file-links/_components/FilePreviewPanel.native.tsx
+const HostCopyButton = CopyButton;
+/** What the subtitle calls a file, from its extension; the same words as the artifacts preview. */
+function fileKind(path) {
+	const extension = path.split(".").at(-1)?.toLowerCase() ?? "";
+	if (extension === "md" || extension === "markdown") return "Markdown";
+	if (extension === "html" || extension === "htm") return "HTML";
+	if (isMediaPath(path)) return "Media";
+	return extension === "" || extension === path.toLowerCase() ? "Text" : extension.toUpperCase();
+}
+/**
+* An unchanged file, read-only, laid out as the artifacts preview: what it is and its one action in
+* the top bar, the content padded below, and where it lives pinned at the bottom. Unchanged files are
+* admitted only by the package's guarded preview route.
+*/
+function FilePreviewPanel({ filePath, ...props }) {
+	const [loaded, setLoaded] = useState();
+	useEffect(() => {
+		if (props.sessionId === null) return;
+		const sessionId = props.sessionId;
+		let cancelled = false;
+		fetchFilePreview(sessionId, filePath).then((result) => {
+			if (!cancelled) setLoaded(result.ok ? {
+				sessionId,
+				path: filePath,
+				preview: result.preview
+			} : {
+				sessionId,
+				path: filePath,
+				error: result.error
+			});
+		}).catch((failure) => {
+			if (!cancelled) setLoaded({
+				sessionId,
+				path: filePath,
+				error: failure instanceof Error ? failure.message : String(failure)
+			});
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [props.sessionId, filePath]);
+	const current = loaded?.path === filePath && loaded.sessionId === props.sessionId ? loaded : void 0;
+	const controller = useRef(void 0);
+	const [saving, setSaving] = useState(false);
+	const [note, setNote] = useState();
+	useEffect(() => () => controller.current?.abort(), [props.sessionId, filePath]);
+	const save = async () => {
+		if (props.sessionId === null || !props.nativeSaveFile || controller.current) return;
+		const active = new AbortController();
+		controller.current = active;
+		setSaving(true);
+		setNote(void 0);
+		try {
+			await props.nativeSaveFile(await prepareFileSave(props.sessionId, filePath, active.signal));
+			if (!active.signal.aborted) setNote("Saved.");
+		} catch (error) {
+			if (!active.signal.aborted) setNote(error instanceof Error ? error.message : String(error));
+		} finally {
+			if (controller.current === active) controller.current = void 0;
+			setSaving(false);
+		}
+	};
+	const cancel = () => {
+		controller.current?.abort();
+		controller.current = void 0;
+		setSaving(false);
+		setNote("Download cancelled.");
+	};
+	const handlers = useRef({
+		save,
+		cancel
+	});
+	useEffect(() => {
+		handlers.current = {
+			save,
+			cancel
+		};
+	});
+	const { setTabHeader } = props;
+	const canSave = props.nativeSaveFile !== void 0;
+	const offline = props.sessionId === null;
+	const media = isMediaPath(filePath) && props.renderMediaPreview !== void 0;
+	const subtitle = `${fileKind(filePath)} · Unchanged`;
+	useEffect(() => {
+		if (!setTabHeader || media) return;
+		setTabHeader({
+			subtitle,
+			action: canSave ? /* @__PURE__ */ jsx(Button, {
+				variant: "ghost",
+				size: "icon",
+				disabled: offline,
+				accessibilityLabel: saving ? "Cancel download" : "Download",
+				onPress: () => saving ? handlers.current.cancel() : void handlers.current.save(),
+				children: saving ? /* @__PURE__ */ jsx(CloseIcon, { color: "hi" }) : /* @__PURE__ */ jsx(DownloadIcon, { color: "hi" })
+			}) : void 0
+		});
+	}, [
+		setTabHeader,
+		media,
+		subtitle,
+		canSave,
+		saving,
+		offline
+	]);
+	const relPath = current?.preview?.relPath ?? filePath;
+	const body = offline ? /* @__PURE__ */ jsx(Text, {
+		accessibilityRole: "alert",
+		style: styles.error,
+		children: "The session is unavailable."
+	}) : current?.error ? /* @__PURE__ */ jsx(Text, {
+		accessibilityRole: "alert",
+		style: styles.error,
+		children: current.error
+	}) : current?.preview ? /* @__PURE__ */ jsx(FilePreview, {
+		...props,
+		path: current.preview.relPath,
+		working: current.preview.working
+	}) : /* @__PURE__ */ jsx(Text, {
+		style: styles.meta,
+		children: "Reading this file..."
+	});
+	return /* @__PURE__ */ jsxs(View, {
+		style: styles.screen,
+		children: [media ? /* @__PURE__ */ jsx(View, {
+			style: styles.stage,
+			children: body
+		}) : /* @__PURE__ */ jsxs(ScrollView, {
+			style: styles.stage,
+			contentContainerStyle: styles.content,
+			children: [
+				setTabHeader ? null : /* @__PURE__ */ jsxs(View, {
+					style: styles.header,
+					children: [
+						/* @__PURE__ */ jsx(Text, {
+							style: [styles.meta, styles.headerLabel],
+							children: subtitle
+						}),
+						canSave && saving ? /* @__PURE__ */ jsx(Button, {
+							variant: "ghost",
+							size: "sm",
+							onPress: cancel,
+							children: "Cancel"
+						}) : null,
+						canSave ? /* @__PURE__ */ jsx(Button, {
+							variant: "outline",
+							size: "sm",
+							disabled: saving || offline,
+							onPress: () => void save(),
+							children: "Download"
+						}) : null
+					]
+				}),
+				note ? /* @__PURE__ */ jsx(Text, {
+					accessibilityLiveRegion: "polite",
+					style: styles.meta,
+					children: note
+				}) : null,
+				body
+			]
+		}), /* @__PURE__ */ jsxs(View, {
+			style: styles.strip,
+			children: [/* @__PURE__ */ jsx(Text, {
+				selectable: true,
+				numberOfLines: 1,
+				ellipsizeMode: "middle",
+				style: [styles.path, styles.stripPath],
+				children: relPath
+			}), HostCopyButton ? /* @__PURE__ */ jsx(HostCopyButton, {
+				text: relPath,
+				label: "path"
+			}) : null]
+		})]
+	});
+}
+function filePreviewTab(filePath) {
+	return {
+		id: `${fileTabId(filePath)}-preview`,
+		label: filePath.split("/").at(-1) ?? filePath,
+		panel: (props) => /* @__PURE__ */ jsx(FilePreviewPanel, {
+			...props,
+			filePath
+		})
+	};
+}
+const styles = StyleSheet.create((theme, rt) => ({
+	screen: { flex: 1 },
+	stage: { flex: 1 },
+	content: {
+		padding: theme.spacing(4),
+		gap: theme.spacing(3),
+		uni__dependencies: [0]
+	},
+	header: {
+		flexDirection: "row",
+		alignItems: "center",
+		gap: theme.spacing(2),
+		paddingBottom: theme.spacing(3),
+		borderBottomWidth: 1,
+		borderBottomColor: theme.colors["border-soft"],
+		uni__dependencies: [0]
+	},
+	headerLabel: { flex: 1 },
+	strip: {
+		flexDirection: "row",
+		alignItems: "center",
+		gap: theme.spacing(2),
+		paddingHorizontal: theme.spacing(4),
+		paddingTop: theme.spacing(2),
+		paddingBottom: theme.spacing(2) + rt.insets.bottom,
+		borderTopWidth: 1,
+		borderTopColor: theme.colors["border-soft"],
+		backgroundColor: theme.colors.bg,
+		uni__dependencies: [0, 9]
+	},
+	stripPath: { flexShrink: 1 },
+	path: {
+		fontFamily: fontOf(theme.fontFamily.mono),
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.dim,
+		uni__dependencies: [0]
+	},
+	meta: {
+		fontFamily: fontOf(theme.fontFamily.sans),
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.dim,
+		uni__dependencies: [0]
+	},
+	error: {
+		fontFamily: fontOf(theme.fontFamily.sans),
+		fontSize: theme.fontSize.sm,
+		color: theme.colors.red,
+		uni__dependencies: [0]
+	}
+}));
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/file-links/_lib/fileLinks.native.ts
+/**
+* The files a message names, as links into the same tab the activity dock
+* opens.
+*
+* Only files this session recorded a change to are claimed. A message quotes a
+* great deal that is shaped like nothing in particular, class names and globs
+* and flags among it, and guessing at what is a path produces links that open
+* an error. The recorded set is the one thing the page knows for certain, and
+* it is also the set a reader is most likely to want open.
+*/
+/** A reference the way a message writes one: 'src/app.ts:42' or 'src/app.ts:42:9'. */
+const LINE_SUFFIX = /:\d+(?::\d+)?$/;
+function itemsFor(sessionId) {
+	return files.select(files.store.state, sessionId).items;
+}
+function match(sessionId, path) {
+	const candidate = path.trim().replace(LINE_SUFFIX, "");
+	if (candidate === "") return void 0;
+	return itemsFor(sessionId).find((item) => item.relPath === candidate || item.path === candidate);
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/file-links/files.native.ts
+var files_native_default = defineFileLinks({
+	subscribe(listener) {
+		const subscription = files.store.subscribe(listener);
+		return () => subscription.unsubscribe();
+	},
+	fingerprint: (sessionId) => itemsFor(sessionId).map((item) => item.relPath).join("\n"),
+	resolve: (sessionId, path) => {
+		const item = match(sessionId, path);
+		return item === void 0 ? void 0 : fileTab(item.path, item.relPath);
+	},
+	openPath: (sessionId, path) => {
+		const item = match(sessionId, path);
+		if (item !== void 0) return fileTab(item.path, item.relPath);
+		const candidate = path.trim();
+		return candidate === "" ? void 0 : filePreviewTab(candidate);
+	}
+});
+//#endregion
 //#region generated/native.ts
 const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
@@ -41,9 +1245,14 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 };
 const nativePlugin = defineNativePlugin({
 	id: "files",
-	session: { get channels() {
-		return [via({ channel: "file_edits" }, file_edits_native_default)];
-	} }
+	session: {
+		get channels() {
+			return [via({ channel: "file_edits" }, file_edits_native_default)];
+		},
+		get fileLinks() {
+			return files_native_default;
+		}
+	}
 });
 //#endregion
 export { nativePlugin };