dsh-remember 0.1.0 → 0.3.1

package/lib/client.js

@@ -583,62 +583,112 @@ function ModelSelect(props) {
 		style: inputStyle(false)
 	}, options);
 }
+/** Upper bound for an import traveling base64 through the host remote. */
+const IMPORT_LIMIT_BYTES = 32 * 1024 * 1024;
+/** Save bundle bytes: native save dialog where available, download fallback. */
+async function saveBundleFile(name$1, base64) {
+	const binary = atob(base64);
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+	const picker = window.showSaveFilePicker;
+	if (picker != null) try {
+		const writable = await (await picker.call(window, { suggestedName: name$1 })).createWritable();
+		await writable.write(bytes);
+		await writable.close();
+		return;
+	} catch (error) {
+		if (error?.name === "AbortError") return;
+	}
+	const url = URL.createObjectURL(new Blob([bytes]));
+	const anchor = document.createElement("a");
+	anchor.href = url;
+	anchor.download = name$1;
+	anchor.click();
+	setTimeout(() => URL.revokeObjectURL(url), 1e3);
+}
 /**
-* Import/export entry: the host-side transfer runs through the memory-commands
-* channel (path field + action), and the outcome comes back as a `transfer:`-
-* prefixed status detail line.
+* Import/export entry: export returns the bundle from the host and saves it
+* through the browser's file dialog; import reads a picked file and hands the
+* bytes back to the host. Outcomes come back as `transfer:`-prefixed status
+* detail lines.
 */
 function TransferSection(props) {
 	const { t, commands } = props;
-	const [exportPath, setExportPath] = (0, react.useState)("");
-	const [importPath, setImportPath] = (0, react.useState)("");
 	const [requested, setRequested] = (0, react.useState)(null);
-	const send = (action, file) => {
-		if (commands == null || file.trim() === "") return;
-		setRequested(action);
-		(async () => {
-			await commands.set("path", file.trim());
-			await commands.set("action", action);
-			await commands.set("requestedAt", Date.now());
-		})();
+	const [localError, setLocalError] = (0, react.useState)("");
+	const fileInput = (0, react.useRef)(null);
+	const exportBundle = async () => {
+		if (commands == null) return;
+		setLocalError("");
+		setRequested("export");
+		try {
+			const result = await commands.run({ action: "export" });
+			if (result.bundle != null && result.bundle.data !== "") {
+				await saveBundleFile(result.bundle.name, result.bundle.data);
+				return;
+			}
+			if (!result.ok) setLocalError(result.detail);
+		} catch (error) {
+			setLocalError(String(error));
+		}
 	};
-	const feedback = props.statusDetail?.startsWith("transfer:") === true ? props.statusDetail.slice(9).trim() : null;
-	const feedbackIsError = feedback != null && /fail|need|must|unsupported|error/iu.test(feedback);
-	const transferRow = (value, setValue, labelKey, action) => {
-		const empty = value.trim() === "";
-		return (0, react.createElement)("div", {
-			className: "dshm-row",
-			style: rowStyle()
-		}, (0, react.createElement)("div", { style: labelStackStyle() }, (0, react.createElement)("span", { style: { fontSize: 13 } }, t(labelKey))), (0, react.createElement)("div", { style: {
-			display: "flex",
-			alignItems: "center",
-			gap: 8,
-			flexShrink: 0
-		} }, (0, react.createElement)("input", {
-			type: "text",
-			value,
-			spellCheck: false,
-			className: "dshm-input",
-			placeholder: "C:\\…\\memory.dshmem.json",
-			onChange: (event) => {
-				setValue(event.target.value);
-				setRequested(null);
-			},
-			style: inputStyle(false)
-		}), (0, react.createElement)("button", {
-			type: "button",
-			disabled: commands == null || empty,
-			className: "dshm-btn",
-			onClick: () => send(action, value),
-			style: primaryButtonStyle(commands == null || empty)
-		}, t(`transfer_${action}`))));
+	const importBundle = async (payload) => {
+		if (commands == null) return;
+		setLocalError("");
+		setRequested("import");
+		try {
+			const result = await commands.run({
+				action: "import",
+				payload
+			});
+			if (!result.ok) setLocalError(result.detail);
+		} catch (error) {
+			setLocalError(String(error));
+		}
 	};
-	return (0, react.createElement)("section", { style: sectionStyle() }, (0, react.createElement)("h3", { style: sectionHeaderStyle() }, t("group_transfer")), (0, react.createElement)("div", { style: { borderTop: `1px solid ${BORDER$1}` } }, transferRow(exportPath, setExportPath, "transfer_exportPath", "export"), transferRow(importPath, setImportPath, "transfer_importPath", "import")), (0, react.createElement)("p", { style: {
+	const pickImport = (event) => {
+		const file = event.target.files?.[0];
+		event.target.value = "";
+		if (file == null) return;
+		if (file.size > IMPORT_LIMIT_BYTES) {
+			setLocalError(t("transfer_tooBig"));
+			return;
+		}
+		const reader = new FileReader();
+		reader.onload = () => {
+			const result = String(reader.result ?? "");
+			importBundle(result.slice(result.indexOf(",") + 1));
+		};
+		reader.onerror = () => setLocalError(t("transfer_readFailed"));
+		reader.readAsDataURL(file);
+	};
+	const feedback = localError !== "" ? localError : props.statusDetail?.startsWith("transfer:") === true ? props.statusDetail.slice(9).trim() : null;
+	const feedbackIsError = feedback != null && (localError !== "" || /fail|need|must|unsupported|error/iu.test(feedback));
+	const transferRow = (labelKey, descKey, action) => (0, react.createElement)("div", {
+		className: "dshm-row",
+		style: rowStyle()
+	}, (0, react.createElement)("div", { style: labelStackStyle() }, (0, react.createElement)("span", { style: { fontSize: 13 } }, t(labelKey)), (0, react.createElement)("span", { style: {
 		fontSize: 11.5,
-		opacity: .5,
-		margin: "8px 2px 0",
-		lineHeight: 1.5
-	} }, t("transfer_hint")), (0, react.createElement)("div", { style: {
+		opacity: .5
+	} }, t(descKey))), (0, react.createElement)("button", {
+		type: "button",
+		disabled: commands == null,
+		className: "dshm-btn",
+		onClick: () => {
+			setLocalError("");
+			setRequested(action);
+			if (action === "export") exportBundle();
+			else fileInput.current?.click();
+		},
+		style: primaryButtonStyle(commands == null)
+	}, t(`transfer_${action}`)));
+	return (0, react.createElement)("section", { style: sectionStyle() }, (0, react.createElement)("h3", { style: sectionHeaderStyle() }, t("group_transfer")), (0, react.createElement)("div", { style: { borderTop: `1px solid ${BORDER$1}` } }, transferRow("transfer_exportLabel", "transfer_exportDesc", "export"), transferRow("transfer_importLabel", "transfer_importDesc", "import")), (0, react.createElement)("input", {
+		type: "file",
+		accept: ".json,.gz,.dshmem",
+		ref: fileInput,
+		style: { display: "none" },
+		onChange: pickImport
+	}), (0, react.createElement)("div", { style: {
 		minHeight: 18,
 		margin: "4px 2px 0"
 	} }, feedback != null ? (0, react.createElement)("span", { style: {
@@ -699,9 +749,11 @@ function hintText(t, field) {
 	return hint === `hint_${field}` ? "" : hint;
 }
 /**
-* The dedicated Memory settings page (occupies one `settings.section` seat):
-* live status banner, divided-list sections with catalog-backed model pickers
-* and toggle switches, transfer actions, and a collapsed advanced section.
+* The dedicated Memory settings page: live status banner, divided-list sections
+* with catalog-backed model pickers and toggle switches, transfer actions, and a
+* collapsed advanced section. Rendered both as its own `settings.section` seat
+* and inside the plugin page's `plugins.bundle.config` seat, where `embedded`
+* drops the heading the page already supplies.
 * Render failures surface inline instead of blanking the panel.
 */
 function MemorySettingsPage(props) {
@@ -777,15 +829,16 @@ function renderMemoryPage(props) {
 			onReset: () => props.resetField(field.spec.field)
 		}))));
 	};
+	const embedded = props.embedded === true;
 	return (0, react.createElement)("div", { style: {
-		maxWidth: 640,
-		paddingBottom: 32
-	} }, (0, react.createElement)("h2", { style: {
+		maxWidth: embedded ? void 0 : 640,
+		paddingBottom: embedded ? 0 : 32
+	} }, embedded ? null : (0, react.createElement)("h2", { style: {
 		fontSize: 19,
 		fontWeight: 650,
 		margin: "0 0 4px",
 		letterSpacing: .2
-	} }, t("title")), (0, react.createElement)("p", { style: {
+	} }, t("title")), embedded ? null : (0, react.createElement)("p", { style: {
 		fontSize: 13,
 		opacity: .6,
 		margin: "0 0 18px",
@@ -852,6 +905,293 @@ function renderMemoryPage(props) {
 	} }, t("readOnly")) : null));
 }
 
+//#endregion
+//#region src/client/remote.ts
+/**
+* Result codecs exist only to satisfy the strict-codec contract; the gateway
+* already delivered parsed JSON, so the browser side does no re-parsing.
+*/
+const passthrough = (name$1) => ({
+	mode: "strict",
+	typeSymbol: `dsh-remember#${name$1}`,
+	create: () => ({ parse: (value) => value })
+});
+const jsonParameter = (name$1, typeName) => ({
+	name: name$1,
+	wire: name$1,
+	source: "json",
+	codec: passthrough(typeName)
+});
+const descriptor = (method, parameters, resultName) => ({
+	id: `dsh-remember#memory/${method}`,
+	service: "memory",
+	namespace: "memory",
+	method,
+	invocation: { kind: "direct" },
+	parameters,
+	result: passthrough(resultName)
+});
+/** Mirrors MEMORY_INVOCATIONS in src/typert.ts (method names and wires must match). */
+const CONTRIBUTION = {
+	package: "dsh-remember",
+	descriptors: [
+		descriptor("getStatus", [], "MemoryStatus"),
+		descriptor("getConfig", [], "ConfigSnapshot"),
+		descriptor("updateConfig", [jsonParameter("patch", "ConfigPatch")], "ConfigSnapshot"),
+		descriptor("unsetConfig", [jsonParameter("field", "ConfigField")], "ConfigSnapshot"),
+		descriptor("getView", [], "MemoryView"),
+		descriptor("runCommand", [jsonParameter("request", "CommandRequest")], "CommandResult")
+	]
+};
+const STATUS_POLL_MS = 2500;
+const CONFIG_POLL_MS = 15e3;
+const VIEW_POLL_MS = 5e3;
+/** A snapshot store with change notification, in the Shape components expect. */
+var BridgeStore = class {
+	snapshot;
+	listeners = /* @__PURE__ */ new Set();
+	/** Fired when the subscriber count crosses zero; used for lazy polling. */
+	onActiveChange;
+	constructor(initial) {
+		this.snapshot = initial;
+	}
+	getSnapshot = () => this.snapshot;
+	subscribe = (listener) => {
+		this.listeners.add(listener);
+		if (this.listeners.size === 1) this.onActiveChange?.(true);
+		return () => {
+			this.listeners.delete(listener);
+			if (this.listeners.size === 0) this.onActiveChange?.(false);
+		};
+	};
+	set(snapshot) {
+		this.snapshot = snapshot;
+		for (const listener of this.listeners) listener();
+	}
+};
+const loadingSnapshot = () => ({
+	status: "loading",
+	value: void 0,
+	base: void 0,
+	user: void 0,
+	revision: void 0,
+	writable: false,
+	mode: "host"
+});
+const unavailableSnapshot = () => ({
+	status: "unavailable",
+	value: void 0,
+	base: void 0,
+	user: void 0,
+	revision: void 0,
+	writable: false,
+	mode: "host"
+});
+function failureDetail(error) {
+	if (error == null) return "memory host call failed";
+	return `${error.code ?? "error"}: ${error.message ?? "unknown failure"}`;
+}
+/**
+* Owns the mounted namespace plus the snapshot stores. Created synchronously
+* (slots need it immediately) and attached once `$mount` resolves.
+*/
+var MemoryBridge = class {
+	remote = null;
+	statusTimer;
+	configTimer;
+	viewTimer;
+	configStore = new BridgeStore(loadingSnapshot());
+	statusStore = new BridgeStore(loadingSnapshot());
+	viewStore = new BridgeStore(loadingSnapshot());
+	/** Settings page scope: `set`/`unset` persist config overrides on the host. */
+	configScope = {
+		getSnapshot: () => this.configStore.getSnapshot(),
+		subscribe: (listener) => this.configStore.subscribe(listener),
+		set: async (field, value) => {
+			await this.updateConfig({ [field]: value });
+		},
+		unset: async (field) => {
+			await this.unsetConfig(field);
+		}
+	};
+	/** Selector-hook source for the sidebar pill and the status banner. */
+	statusSource = {
+		getSnapshot: () => this.statusStore.getSnapshot(),
+		subscribe: (listener) => this.statusStore.subscribe(listener)
+	};
+	/** Selector-hook source for the viewer page (polls only while mounted). */
+	viewSource = {
+		getSnapshot: () => this.viewStore.getSnapshot(),
+		subscribe: (listener) => this.viewStore.subscribe(listener)
+	};
+	/** The single action runner every widget uses. */
+	commands = { run: (request) => this.runCommand(request) };
+	constructor() {
+		this.viewStore.onActiveChange = (active) => {
+			if (active) {
+				this.refreshView();
+				this.viewTimer = setInterval(() => {
+					this.refreshView();
+				}, VIEW_POLL_MS);
+			} else {
+				this.stopTimer(this.viewTimer);
+				this.viewTimer = void 0;
+			}
+		};
+	}
+	attach(remote) {
+		this.remote = remote;
+		this.refreshStatus();
+		this.refreshConfig();
+		this.statusTimer = setInterval(() => {
+			this.refreshStatus();
+		}, STATUS_POLL_MS);
+		this.configTimer = setInterval(() => {
+			this.refreshConfig();
+		}, CONFIG_POLL_MS);
+	}
+	detach() {
+		this.stopTimer(this.statusTimer);
+		this.stopTimer(this.configTimer);
+		this.stopTimer(this.viewTimer);
+		this.statusTimer = void 0;
+		this.configTimer = void 0;
+		this.viewTimer = void 0;
+		this.remote = null;
+	}
+	async updateConfig(patch) {
+		const result = await this.requireRemote().updateConfig(patch);
+		if (!result.ok) throw new Error(failureDetail(result.error));
+		this.applyConfig(result.value);
+		this.refreshStatus();
+	}
+	async unsetConfig(field) {
+		const result = await this.requireRemote().unsetConfig(field);
+		if (!result.ok) throw new Error(failureDetail(result.error));
+		this.applyConfig(result.value);
+	}
+	async runCommand(request) {
+		const remote = this.remote;
+		if (remote == null) return {
+			ok: false,
+			detail: "memory host unavailable"
+		};
+		let result;
+		try {
+			result = await remote.runCommand(request);
+		} catch (error) {
+			return {
+				ok: false,
+				detail: String(error)
+			};
+		}
+		if (!result.ok) return {
+			ok: false,
+			detail: failureDetail(result.error)
+		};
+		if (result.value.view !== void 0) this.applyView(result.value.view);
+		else this.refreshView();
+		this.refreshStatus();
+		this.refreshConfig();
+		return result.value;
+	}
+	async refreshView() {
+		const remote = this.remote;
+		if (remote == null) return;
+		try {
+			const result = await remote.getView();
+			if (!result.ok) throw new Error(failureDetail(result.error));
+			this.applyView(result.value);
+		} catch {
+			this.viewStore.set(unavailableSnapshot());
+		}
+	}
+	applyView(view) {
+		this.viewStore.set({
+			status: "ready",
+			value: view,
+			base: void 0,
+			user: void 0,
+			revision: view.updatedAt,
+			writable: false,
+			mode: "host"
+		});
+	}
+	applyConfig(config) {
+		this.configStore.set({
+			status: "ready",
+			value: config.value,
+			base: config.base,
+			user: config.user,
+			revision: config.revision,
+			writable: true,
+			mode: "host"
+		});
+	}
+	async refreshConfig() {
+		const remote = this.remote;
+		if (remote == null) return;
+		try {
+			const result = await remote.getConfig();
+			if (!result.ok) throw new Error(failureDetail(result.error));
+			this.applyConfig(result.value);
+		} catch {
+			this.configStore.set(unavailableSnapshot());
+		}
+	}
+	async refreshStatus() {
+		const remote = this.remote;
+		if (remote == null) return;
+		try {
+			const result = await remote.getStatus();
+			if (!result.ok) throw new Error(failureDetail(result.error));
+			const status = result.value;
+			this.statusStore.set({
+				status: "ready",
+				value: status,
+				base: void 0,
+				user: void 0,
+				revision: status.updatedAt,
+				writable: false,
+				mode: "host"
+			});
+		} catch {
+			this.statusStore.set(unavailableSnapshot());
+		}
+	}
+	requireRemote() {
+		if (this.remote == null) throw new Error("memory host unavailable");
+		return this.remote;
+	}
+	stopTimer(timer) {
+		if (timer !== void 0) clearInterval(timer);
+	}
+};
+/**
+* Mount the contribution and hand the resulting namespace to the bridge.
+* Returns the disposer the caller runs from its effect cleanup.
+*/
+async function mountMemoryBridge(bridge, ctx) {
+	const remote = ctx.remote;
+	if (remote == null || typeof remote.$mount !== "function") throw new Error("the remote service is not available in this composition");
+	let dispose;
+	try {
+		dispose = await remote.$mount(CONTRIBUTION);
+	} catch (error) {
+		throw new Error(`mounting the memory remote contribution failed: ${String(error)}`);
+	}
+	const namespace = ctx.get("remote.memory");
+	if (namespace == null) {
+		await dispose();
+		throw new Error("remote.memory is missing after mounting the contribution");
+	}
+	bridge.attach(namespace);
+	return async () => {
+		bridge.detach();
+		await dispose();
+	};
+}
+
 //#endregion
 //#region src/client/sidebar-action.ts
 let styleInjected$1 = false;
@@ -956,10 +1296,7 @@ function renderAction(props) {
 	const sendCommand = (action) => {
 		const commands = props.commands;
 		if (commands == null) return;
-		(async () => {
-			await commands.set("action", action);
-			await commands.set("requestedAt", Date.now());
-		})();
+		commands.run({ action });
 	};
 	const toggleSetting = (field, value) => {
 		props.settings?.set(field, value);
@@ -1322,7 +1659,11 @@ function ensureViewerStyles() {
 		".dshmv-usage { display: flex; align-items: center; gap: 6px; }",
 		".dshmv-usage-bar { height: 5px; border-radius: 3px; background: var(--dsw-alias-brand-primary, #4d6bfe); min-width: 2px; transition: width 200ms ease; }",
 		".dshmv-empty { color: var(--dsw-alias-label-tertiary, rgba(0,0,0,0.45)); padding: 24px 0; text-align: center; font-size: 12px; }",
-		".dshmv-mono { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 11px; color: var(--dsw-alias-label-tertiary, rgba(0,0,0,0.45)); }"
+		".dshmv-mono { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 11px; color: var(--dsw-alias-label-tertiary, rgba(0,0,0,0.45)); }",
+		".dshmv-section { margin: 2px 0 8px; font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-secondary, rgba(0,0,0,0.65)); }",
+		".dshmv-toprow { display: flex; align-items: center; gap: 10px; padding: 7px 10px; border-radius: 8px; border: 0.5px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.1)); background: var(--dsw-alias-fill-tertiary, rgba(0,0,0,0.04)); margin-bottom: 6px; }",
+		".dshmv-toprow-name { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: 600; font-size: 12px; }",
+		".dshmv-toprow-meta { flex: 0 0 auto; font-size: 11px; color: var(--dsw-alias-label-tertiary, rgba(0,0,0,0.45)); font-variant-numeric: tabular-nums; }"
 	].join("\n");
 	document.head.appendChild(tag);
 	styleInjected = true;
@@ -1399,19 +1740,16 @@ function renderViewer(props) {
 	const sendCommand = (action, arg = "", force = false) => {
 		const commands = props.commands;
 		if (commands == null) return;
-		(async () => {
-			if (arg !== "") await commands.set("arg", arg);
-			if (force) await commands.set("force", true);
-			await commands.set("action", action);
-			await commands.set("requestedAt", Date.now());
-		})();
+		commands.run({
+			action,
+			arg: arg === "" ? void 0 : arg,
+			force: force || void 0
+		});
 	};
-	const effectiveText = showTranslated && hasTranslation ? texts.translatedSummary : texts.summary;
 	return (0, react.createElement)("div", { className: "dshmv-root" }, (0, react.createElement)("div", { className: "dshmv-tabs" }, ...[
 		"overview",
 		"summary",
-		"index",
-		"records"
+		"index"
 	].map((id) => (0, react.createElement)("button", {
 		key: id,
 		type: "button",
@@ -1457,30 +1795,54 @@ function renderViewer(props) {
 	}, t("viewer_rebuild")), showTranslated && hasTranslation && view.translatedStale === true ? (0, react.createElement)("span", { className: "dshmv-badge dshmv-badge-stale" }, t("viewer_stale")) : null, showTranslated && hasTranslation && view.translatedStale !== true ? (0, react.createElement)("span", { className: "dshmv-badge dshmv-badge-ok" }, t("viewer_fresh")) : null, (0, react.createElement)("span", { className: "dshmv-status" }, status.detail ?? "")), (0, react.createElement)("div", {
 		className: "dshmv-body",
 		"data-fill": "true"
-	}, tab === "overview" ? renderOverview(t, texts, effectiveText, showTranslated, status, records) : tab === "summary" ? (0, react.createElement)(SummaryView, {
+	}, tab === "overview" ? (0, react.createElement)(OverviewView, {
 		t,
 		texts,
-		showTranslated
-	}) : tab === "index" ? renderIndex(t, texts, showTranslated) : (0, react.createElement)(RecordsView, {
-		t,
+		showTranslated,
+		status,
 		records
-	})));
+	}) : tab === "summary" ? (0, react.createElement)(SummaryView, {
+		t,
+		texts,
+		showTranslated
+	}) : renderIndex(t, texts, showTranslated)));
 }
-function renderOverview(t, texts, effectiveText, showTranslated, status, records) {
+/** Overview dashboard: stat cards, status, most-cited, and the records table. */
+function OverviewView(props) {
+	const { t, texts, showTranslated, status, records } = props;
+	const [query, setQuery] = (0, react.useState)("");
 	const totalUsage = records.reduce((sum, record) => sum + record.usageCount, 0);
 	const consolidated = records.filter((record) => record.selectedForPhase2).length;
+	const topCited = records.filter((record) => record.usageCount > 0).sort((a, b) => b.usageCount - a.usageCount).slice(0, 5);
 	const phase = status.phase ?? "idle";
 	const active = phase === "phase1" || phase === "phase2";
+	const needle = query.trim().toLowerCase();
+	const filtered = needle === "" ? records : records.filter((record) => record.sessionId.toLowerCase().includes(needle) || record.rolloutSlug.toLowerCase().includes(needle) || record.workspacePath.toLowerCase().includes(needle));
+	const maxUsage = Math.max(1, ...records.map((record) => record.usageCount));
 	const card = (num, label) => (0, react.createElement)("div", {
 		className: "dshmv-card",
 		key: label
 	}, (0, react.createElement)("div", { className: "dshmv-card-num" }, num), (0, react.createElement)("div", { className: "dshmv-card-label" }, label));
-	return (0, react.createElement)("div", { className: "dshmv-fill" }, (0, react.createElement)("div", { className: "dshmv-cards" }, card(records.length, t("viewer_stat_records")), card(consolidated, t("viewer_stat_consolidated")), card(totalUsage, t("viewer_stat_citations")), card(formatBytes(texts.summary.length), t("viewer_stat_summarySize"))), (0, react.createElement)("div", { style: {
+	return (0, react.createElement)("div", { className: "dshmv-scroll-fill" }, (0, react.createElement)("div", { className: "dshmv-cards" }, card(records.length, t("viewer_stat_records")), card(consolidated, t("viewer_stat_consolidated")), card(totalUsage, t("viewer_stat_citations")), card(formatBytes(texts.summary.length), t("viewer_stat_summarySize")), card(formatBytes(texts.index.length), t("viewer_stat_indexSize"))), (0, react.createElement)("div", { style: {
 		display: "flex",
 		alignItems: "center",
 		gap: 8,
 		marginBottom: 10
-	} }, (0, react.createElement)("span", { className: `dshmv-badge ${active ? "dshmv-badge-stale" : "dshmv-badge-ok"}` }, active ? phase === "phase1" ? t("phase1") : t("phase2") : t("statusIdle")), status.updatedAt != null && status.updatedAt > 0 ? (0, react.createElement)("span", { className: "dshmv-mono" }, new Date(status.updatedAt).toLocaleString()) : null, showTranslated ? (0, react.createElement)("span", { className: "dshmv-badge dshmv-badge-ok" }, t("viewer_badgeTranslated")) : null), effectiveText !== "" || texts.summary !== "" ? (0, react.createElement)("div", { className: "dshmv-md dshmv-md-fill" }, effectiveText !== "" ? effectiveText : texts.summary) : (0, react.createElement)("div", { className: "dshmv-empty dshmv-md-fill" }, texts.failed ? t("viewer_decodeFailed") : t("viewer_empty")));
+	} }, (0, react.createElement)("span", { className: `dshmv-badge ${active ? "dshmv-badge-stale" : "dshmv-badge-ok"}` }, active ? phase === "phase1" ? t("phase1") : t("phase2") : t("statusIdle")), status.updatedAt != null && status.updatedAt > 0 ? (0, react.createElement)("span", { className: "dshmv-mono" }, new Date(status.updatedAt).toLocaleString()) : null, showTranslated ? (0, react.createElement)("span", { className: "dshmv-badge dshmv-badge-ok" }, t("viewer_badgeTranslated")) : null), records.length === 0 ? null : (0, react.createElement)("div", { className: "dshmv-section" }, t("viewer_topCited")), ...topCited.map((record) => (0, react.createElement)("div", {
+		className: "dshmv-toprow",
+		key: record.sessionId
+	}, (0, react.createElement)("span", { className: "dshmv-toprow-name" }, record.rolloutSlug || record.sessionId.slice(0, 8)), (0, react.createElement)("span", { className: "dshmv-toprow-meta" }, `${record.usageCount} · ${formatTime(record.lastUsage ?? record.sourceUpdatedAt)}`))), records.length > 0 && topCited.length === 0 ? (0, react.createElement)("div", { className: "dshmv-empty" }, t("viewer_noCitations")) : null, records.length === 0 ? null : (0, react.createElement)("div", {
+		className: "dshmv-section",
+		style: { marginTop: 14 }
+	}, t("viewer_tab_records")), records.length === 0 ? null : (0, react.createElement)("input", {
+		className: "dshmv-search",
+		placeholder: t("viewer_search"),
+		value: query,
+		onChange: (event) => setQuery(event.target.value)
+	}), records.length === 0 ? (0, react.createElement)("div", { className: "dshmv-empty" }, t("viewer_empty")) : (0, react.createElement)("table", { className: "dshmv-table" }, (0, react.createElement)("thead", null, (0, react.createElement)("tr", null, (0, react.createElement)("th", null, t("viewer_col_session")), (0, react.createElement)("th", null, t("viewer_col_usage")), (0, react.createElement)("th", null, t("viewer_col_updated")))), (0, react.createElement)("tbody", null, ...filtered.map((record) => (0, react.createElement)("tr", { key: record.sessionId }, (0, react.createElement)("td", null, (0, react.createElement)("div", { style: { fontWeight: 600 } }, record.rolloutSlug || record.sessionId.slice(0, 8)), (0, react.createElement)("div", { className: "dshmv-mono" }, record.workspacePath)), (0, react.createElement)("td", null, (0, react.createElement)("div", { className: "dshmv-usage" }, (0, react.createElement)("span", {
+		className: "dshmv-usage-bar",
+		style: { width: `${Math.round(record.usageCount / maxUsage * 48)}px` }
+	}), (0, react.createElement)("span", null, String(record.usageCount))), record.lastUsage != null ? (0, react.createElement)("div", { className: "dshmv-mono" }, `${t("viewer_col_lastUsed")}: ${formatTime(record.lastUsage)}`) : null), (0, react.createElement)("td", { className: "dshmv-mono" }, formatTime(record.sourceUpdatedAt)))))));
 }
 function SummaryView(props) {
 	const { t, texts, showTranslated } = props;
@@ -1491,22 +1853,6 @@ function renderIndex(t, texts, showTranslated) {
 	const text = showTranslated && texts.translatedIndex !== "" ? texts.translatedIndex : texts.index;
 	return text !== "" ? (0, react.createElement)("div", { className: "dshmv-md dshmv-md-fill" }, text) : (0, react.createElement)("div", { className: "dshmv-empty dshmv-fill" }, texts.failed ? t("viewer_decodeFailed") : t("viewer_empty"));
 }
-function RecordsView(props) {
-	const { t, records } = props;
-	const [query, setQuery] = (0, react.useState)("");
-	const needle = query.trim().toLowerCase();
-	const filtered = needle === "" ? records : records.filter((record) => record.sessionId.toLowerCase().includes(needle) || record.rolloutSlug.toLowerCase().includes(needle) || record.workspacePath.toLowerCase().includes(needle));
-	const maxUsage = Math.max(1, ...records.map((record) => record.usageCount));
-	return (0, react.createElement)("div", { className: "dshmv-fill" }, (0, react.createElement)("input", {
-		className: "dshmv-search",
-		placeholder: t("viewer_search"),
-		value: query,
-		onChange: (event) => setQuery(event.target.value)
-	}), (0, react.createElement)("div", { className: "dshmv-scroll-fill" }, filtered.length === 0 ? (0, react.createElement)("div", { className: "dshmv-empty" }, t("viewer_empty")) : (0, react.createElement)("table", { className: "dshmv-table" }, (0, react.createElement)("thead", null, (0, react.createElement)("tr", null, (0, react.createElement)("th", null, t("viewer_col_session")), (0, react.createElement)("th", null, t("viewer_col_usage")), (0, react.createElement)("th", null, t("viewer_col_updated")))), (0, react.createElement)("tbody", null, ...filtered.map((record) => (0, react.createElement)("tr", { key: record.sessionId }, (0, react.createElement)("td", null, (0, react.createElement)("div", { style: { fontWeight: 600 } }, record.rolloutSlug || record.sessionId.slice(0, 8)), (0, react.createElement)("div", { className: "dshmv-mono" }, record.workspacePath)), (0, react.createElement)("td", null, (0, react.createElement)("div", { className: "dshmv-usage" }, (0, react.createElement)("span", {
-		className: "dshmv-usage-bar",
-		style: { width: `${Math.round(record.usageCount / maxUsage * 48)}px` }
-	}), (0, react.createElement)("span", null, String(record.usageCount))), record.lastUsage != null ? (0, react.createElement)("div", { className: "dshmv-mono" }, `${t("viewer_col_lastUsed")}: ${formatTime(record.lastUsage)}`) : null), (0, react.createElement)("td", { className: "dshmv-mono" }, formatTime(record.sourceUpdatedAt))))))));
-}
 /** Title chip for the viewer tab. */
 function MemoryViewerTitle(props) {
 	return (0, react.createElement)("span", null, props.t("viewer_title"));
@@ -1548,9 +1894,7 @@ const name = "dsh-remember";
 const inject = [
 	"slots",
 	"locale",
-	"settingsScope",
-	"remote",
-	"remote.session"
+	"remote"
 ];
 const NS = "dsh-memory";
 const ZH = {
@@ -1617,12 +1961,15 @@ const ZH = {
 	phase1: "记忆提取中",
 	phase2: "记忆整理中",
 	processing: "记忆处理中",
-	transfer_hint: "导出生成单个 gzip 压缩的 bundle 文件;导入按内容哈希去重合并,冲突以本地为准,未压缩的 JSON 也能读。",
-	transfer_exportPath: "导出到文件",
-	transfer_importPath: "从文件导入",
+	transfer_exportLabel: "导出记忆",
+	transfer_exportDesc: "保存为单个 bundle 文件,位置在浏览器里选",
+	transfer_importLabel: "导入记忆",
+	transfer_importDesc: "选择一个 bundle 文件合并进当前记忆库",
 	transfer_export: "导出",
 	transfer_import: "导入",
 	transfer_requested: "已发送,结果见上方状态栏",
+	transfer_tooBig: "文件超过 32 MB,请改用 memory_export 工具直接导出到磁盘",
+	transfer_readFailed: "文件读取失败",
 	viewer_title: "记忆浏览",
 	viewer_refresh: "刷新",
 	viewer_translate: "翻译记忆",
@@ -1635,6 +1982,9 @@ const ZH = {
 	viewer_stat_consolidated: "已整理",
 	viewer_stat_citations: "被引用次数",
 	viewer_stat_summarySize: "摘要大小",
+	viewer_stat_indexSize: "注册表大小",
+	viewer_topCited: "最常引用",
+	viewer_noCitations: "还没有引用记录",
 	viewer_original: "显示原文",
 	viewer_translated: "显示译文",
 	viewer_showTranslated: "显示译文",
@@ -1718,12 +2068,15 @@ const EN = {
 	phase1: "Extracting memories",
 	phase2: "Consolidating memories",
 	processing: "Memory processing",
-	transfer_hint: "Export writes one gzip-compressed bundle file; import merges by content hash (conflicts keep the local copy) and also accepts uncompressed JSON.",
-	transfer_exportPath: "Export to file",
-	transfer_importPath: "Import from file",
+	transfer_exportLabel: "Export memory",
+	transfer_exportDesc: "Save as a single bundle file — pick the location in the browser",
+	transfer_importLabel: "Import memory",
+	transfer_importDesc: "Pick a bundle file to merge into the current memory store",
 	transfer_export: "Export",
 	transfer_import: "Import",
 	transfer_requested: "Sent — result appears in the status bar above",
+	transfer_tooBig: "File exceeds 32 MB — use the memory_export tool to write it to disk instead",
+	transfer_readFailed: "Failed to read the file",
 	viewer_title: "Memory",
 	viewer_refresh: "Refresh",
 	viewer_translate: "Translate memory",
@@ -1736,6 +2089,9 @@ const EN = {
 	viewer_stat_consolidated: "Consolidated",
 	viewer_stat_citations: "Citations",
 	viewer_stat_summarySize: "Summary size",
+	viewer_stat_indexSize: "Registry size",
+	viewer_topCited: "Most cited",
+	viewer_noCitations: "No citations yet",
 	viewer_original: "Show original",
 	viewer_translated: "Show translation",
 	viewer_showTranslated: "Translation",
@@ -1757,34 +2113,42 @@ const EN = {
 };
 /** Activate the browser half: register the Memory settings page and the status pill. */
 function apply(ctx) {
+	try {
+		activate(ctx);
+	} catch (error) {
+		console.error("[dsh-memory] activation failed", error);
+		throw error;
+	}
+}
+function activate(ctx) {
 	ctx.effect(() => ctx.locale.register(NS, {
 		zh: ZH,
 		en: EN
 	}), "dsh-memory: dictionaries");
 	ctx.effect(() => installCitationStripper(), "dsh-memory: citation stripper");
-	const cardScope = ctx.settingsScope.bind({ namespace: "memory" });
-	const statusScope = ctx.settingsScope.bind({ namespace: "memory-status" });
-	const commandsScope = ctx.settingsScope.bind({ namespace: "memory-commands" });
-	const viewerScope = ctx.settingsScope.bind({ namespace: "memory-view" });
-	const card = new MemoryCardController(cardScope, catalogLoader(ctx));
-	const statusSource = {
-		getSnapshot: () => statusScope.getSnapshot(),
-		subscribe: (listener) => statusScope.subscribe(listener)
-	};
-	const viewSource = {
-		getSnapshot: () => viewerScope.getSnapshot(),
-		subscribe: (listener) => viewerScope.subscribe(listener)
-	};
-	const commandsView = {
-		set: (field, value) => commandsScope.set(field, value),
-		unset: (field) => commandsScope.unset(field)
-	};
-	const memoryView = {
-		set: (field, value) => cardScope.set(field, value),
-		unset: (field) => cardScope.unset(field),
-		getSnapshot: () => cardScope.getSnapshot(),
-		subscribe: (listener) => cardScope.subscribe(listener)
-	};
+	const bridge = new MemoryBridge();
+	ctx.effect(() => {
+		let dispose;
+		let cancelled = false;
+		mountMemoryBridge(bridge, ctx).then((mounted) => {
+			if (cancelled) {
+				mounted();
+				return;
+			}
+			dispose = mounted;
+		}).catch((error) => {
+			console.warn("[dsh-memory] memory remote unavailable:", error);
+		});
+		return () => {
+			cancelled = true;
+			if (dispose != null) dispose();
+		};
+	}, "dsh-memory: memory remote");
+	const card = new MemoryCardController(bridge.configScope, catalogLoader(ctx));
+	const statusSource = bridge.statusSource;
+	const viewSource = bridge.viewSource;
+	const commandsView = bridge.commands;
+	const memoryView = bridge.configScope;
 	let sidebarRight;
 	ctx.inject(["sidebarRightTabs", "sidebarRight"], (sctx) => {
 		sidebarRight = sctx.sidebarRight;
@@ -1817,20 +2181,29 @@ function apply(ctx) {
 			sidebarRight?.openTab(MEMORY_VIEWER_KIND, {});
 		} catch {}
 	};
+	const pageFace = (embedded) => () => ({
+		...card.inject(),
+		commands: commandsView,
+		embedded,
+		hooks: {
+			memoryPage: card.pageStore(),
+			memoryStatus: statusSource,
+			memoryView: viewSource
+		}
+	});
 	ctx.slots.inject("settings.section", () => ctx.slots.register({
 		name: "settings.section",
 		id: "memory",
 		order: 16,
 		label: () => t_nav(ctx),
 		locale: NS,
-		inject: () => ({
-			...card.inject(),
-			commands: commandsView,
-			hooks: {
-				memoryPage: card.pageStore(),
-				memoryStatus: statusSource
-			}
-		})
+		inject: pageFace(false)
+	}, MemorySettingsPage));
+	ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
+		name: "plugins.bundle.config",
+		key: "dsh-remember",
+		locale: NS,
+		inject: pageFace(true)
 	}, MemorySettingsPage));
 	ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
 		name: "sidebar.footer.action",
@@ -1848,12 +2221,27 @@ function apply(ctx) {
 function t_nav(ctx) {
 	return ctx.locale.bind(NS)("nav");
 }
+/**
+* The catalog is optional: `remote.session` is not in `inject`, because a
+* composition without the session controller must still activate the panel
+* (users can type `provider/model` by hand). Looking the service up through
+* `ctx.get` keeps activation independent of the controller's ordering.
+*/
+function lookupSession(ctx) {
+	try {
+		const value = ctx.get("remote.session");
+		return typeof value === "object" && value !== null ? value : null;
+	} catch {
+		return null;
+	}
+}
 /** Query the Host model catalog and flatten it into selectable routes. */
 function catalogLoader(ctx) {
-	const call = ctx.remote?.session?.modelCatalog;
+	const session = lookupSession(ctx);
+	const call = session?.modelCatalog;
 	if (call == null) return null;
 	return async () => {
-		const result = await call.call(ctx.remote.session);
+		const result = await call.call(session);
 		if (!result?.ok || result.value == null) throw new Error("model catalog unavailable");
 		return result.value.groups.flatMap((group) => group.models.map((model) => ({
 			provider: group.id,