dsh-mnemon 0.5.4 → 0.5.5

package/README.md

@@ -17,13 +17,13 @@
 
 <p align="center">
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md">
-    <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/memory-space-terminology/en/spaces.jpg" alt="Memory Spaces in the real DSH Sidebar with synthetic Atlas data" width="1180" />
+    <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.4/en/spaces.jpg" alt="Memory Spaces in the Light DSH Sidebar after importing a Mnemon Pack" width="1180" />
   </a>
 </p>
 
 <p align="center">
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/getting-started.md"><strong>Get started</strong></a> ·
-  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e1b58f917289325ee430106385da2d4ff2c67153/docs/assets/showcase/demo.mp4">Watch the v0.5.2 demo</a> ·
+  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.4/en/demo.mp4">Watch the v0.5.4 Light demo</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/extensions.md">Build a plugin</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/README.md">Documentation</a>
 </p>
@@ -119,4 +119,4 @@ pnpm verify
 pnpm verify:plugins
 ```
 
-Use Node.js `^22.19.0 || >=24.0.0` and pnpm 10.13.1. Package-level checks run independently; WebUI captures use disposable data and a real DSH Host. Tests of mechanics are not claims of LLM accuracy or live cloud-Provider conformance. [Development](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/README.md) · [Media provenance](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/memory-space-terminology/README.md).
+Use Node.js `^22.19.0 || >=24.0.0` and pnpm 10.13.1. Package-level checks run independently; WebUI captures use disposable data and a real DSH Host. Tests of mechanics are not claims of LLM accuracy or live cloud-Provider conformance. [Development](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/README.md) · [Media provenance](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.4/README.md).

package/README.zh-CN.md

@@ -17,13 +17,13 @@
 
 <p align="center">
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md">
-    <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/memory-space-terminology/zh-CN/spaces.jpg" alt="真实 DSH 侧栏中的记忆空间与合成 Atlas 数据" width="1180" />
+    <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.4/zh-CN/spaces.jpg" alt="导入 Mnemon Pack 后的浅色 DSH 记忆空间界面" width="1180" />
   </a>
 </p>
 
 <p align="center">
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/getting-started.md"><strong>快速开始</strong></a> ·
-  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e1b58f917289325ee430106385da2d4ff2c67153/docs/assets/showcase/demo.mp4">观看 v0.5.2 演示（英文界面）</a> ·
+  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.4/zh-CN/demo.mp4">观看 v0.5.4 浅色演示（中文界面）</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/extensions.md">制作插件</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/README.md">文档中心</a>
 </p>
@@ -119,4 +119,4 @@ pnpm verify
 pnpm verify:plugins
 ```
 
-使用 Node.js `^22.19.0 || >=24.0.0` 与 pnpm 10.13.1。各包可以独立验证；WebUI 素材来自临时数据和真实 DSH Host。机制测试不等于 LLM 准确度或真实云 Provider 一致性验证。[开发指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/README.md) · [素材来源](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/memory-space-terminology/README.md)。
+使用 Node.js `^22.19.0 || >=24.0.0` 与 pnpm 10.13.1。各包可以独立验证；WebUI 素材来自临时数据和真实 DSH Host。机制测试不等于 LLM 准确度或真实云 Provider 一致性验证。[开发指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/README.md) · [素材来源](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.4/README.md)。

package/lib/client.js

@@ -30,6 +30,16 @@ window.__ModuleLoader__.load({
 		const MNEMON_WRITE_CHANNEL = "/dsh-mnemon-write";
 		const MNEMON_PACK_CHANNEL = "/dsh-mnemon-pack";
 		const MNEMON_SETTINGS_CHANNEL = "/dsh-mnemon-settings";
+		/** DSH API Gateway endpoints used by paired remote Web clients. */
+		const MNEMON_REMOTE_CHANNEL = "/api";
+		const MNEMON_REMOTE_NAMESPACE = "dshMnemon";
+		const MNEMON_REMOTE_READ_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/read`;
+		const MNEMON_REMOTE_ACTIVATION_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/activation`;
+		const MNEMON_REMOTE_WRITE_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/write`;
+		const MNEMON_REMOTE_PACK_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/pack`;
+		const MNEMON_REMOTE_SETTINGS_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/settings`;
+		const MNEMON_REMOTE_VIEW_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/view`;
+		const MNEMON_REMOTE_VIEW_WRITE_ENDPOINT = `${MNEMON_REMOTE_NAMESPACE}/viewWrite`;
 		const MNEMON_SETTINGS_NAMESPACE = "mnemon";
 		const MNEMON_UI_SETTINGS_NAMESPACE = "mnemon-ui";
 		const DEFAULT_EMBEDDING_ENDPOINT = "http://localhost:11434";
@@ -40,6 +50,46 @@ window.__ModuleLoader__.load({
 			"openai"
 		];
 		//#endregion
+		//#region src/client/remote-rpc.ts
+		const REMOTE_ENDPOINT = /* @__PURE__ */ new Map([
+			[MNEMON_READ_CHANNEL, MNEMON_REMOTE_READ_ENDPOINT],
+			[MNEMON_ACTIVATION_CHANNEL, MNEMON_REMOTE_ACTIVATION_ENDPOINT],
+			[MNEMON_WRITE_CHANNEL, MNEMON_REMOTE_WRITE_ENDPOINT],
+			[MNEMON_PACK_CHANNEL, MNEMON_REMOTE_PACK_ENDPOINT],
+			[MNEMON_SETTINGS_CHANNEL, MNEMON_REMOTE_SETTINGS_ENDPOINT],
+			[MNEMON_VIEW_CHANNEL, MNEMON_REMOTE_VIEW_ENDPOINT],
+			[MNEMON_VIEW_WRITE_CHANNEL, MNEMON_REMOTE_VIEW_WRITE_ENDPOINT]
+		]);
+		function isClientRpcResult(value) {
+			if (typeof value !== "object" || value === null || !Object.hasOwn(value, "ok")) return false;
+			const candidate = value;
+			if (candidate.ok === true) return Object.hasOwn(candidate, "value");
+			if (candidate.ok !== false || typeof candidate.error !== "object" || candidate.error === null) return false;
+			return typeof candidate.error.message === "string";
+		}
+		function isLoopbackHostname(hostname) {
+			if (hostname === "localhost" || hostname === "[::1]") return true;
+			const parts = hostname.split(".");
+			return parts.length === 4 && parts[0] === "127" && parts.every((part) => /^\d{1,3}$/.test(part) && Number(part) <= 255);
+		}
+		function isRemoteConnection(connection) {
+			const hostname = globalThis.location?.hostname;
+			return typeof hostname === "string" && hostname !== "" && !isLoopbackHostname(hostname) || connection.isLoopback === false;
+		}
+		/** Route only paired remote pages through API Gateway; local clients retain legacy channels. */
+		async function callMnemonRpc(connection, channel, endpoint, payload, signal) {
+			const remoteEndpoint = REMOTE_ENDPOINT.get(channel);
+			if (!isRemoteConnection(connection) || remoteEndpoint === void 0) return signal === void 0 ? connection.rpc.call(channel, endpoint, payload) : connection.rpc.call(channel, endpoint, payload, signal);
+			const remotePayload = { args: {
+				endpoint,
+				payload
+			} };
+			const response = await (signal === void 0 ? connection.rpc.call(MNEMON_REMOTE_CHANNEL, remoteEndpoint, remotePayload) : connection.rpc.call(MNEMON_REMOTE_CHANNEL, remoteEndpoint, remotePayload, signal));
+			if (!response.ok) return response;
+			if (!isClientRpcResult(response.value)) throw new Error("DSH API Gateway returned an invalid Mnemon response");
+			return response.value;
+		}
+		//#endregion
 		//#region src/client/api.ts
 		const turnActivityCache = /* @__PURE__ */ new WeakMap();
 		async function loadTurnActivities(connection, sessionId, requiredCursor) {
@@ -65,7 +115,7 @@ window.__ModuleLoader__.load({
 				const snapshot = await entry.inFlight;
 				return snapshot.cursor >= requiredCursor ? snapshot : loadTurnActivities(connection, sessionId, requiredCursor);
 			}
-			const request = connection.rpc.call(MNEMON_READ_CHANNEL, "turn-activities", sessionId === void 0 ? {} : { sessionId }).then((response) => {
+			const request = callMnemonRpc(connection, MNEMON_READ_CHANNEL, "turn-activities", sessionId === void 0 ? {} : { sessionId }).then((response) => {
 				if (!response.ok) throw new Error(response.error.message);
 				const snapshot = response.value;
 				entry.cursor = snapshot.cursor;
@@ -87,7 +137,7 @@ window.__ModuleLoader__.load({
 				this.workspaceId = workspaceId;
 			}
 			async call(channel, endpoint, payload) {
-				const response = await this.connection.rpc.call(channel, endpoint, payload);
+				const response = await callMnemonRpc(this.connection, channel, endpoint, payload);
 				if (!response.ok) throw new Error(response.error.message);
 				return response.value;
 			}
@@ -4960,7 +5010,7 @@ window.__ModuleLoader__.load({
 				const controller = new AbortController();
 				const timeout = setTimeout(() => controller.abort(), Math.max(1, this.requestTimeoutMs));
 				try {
-					return await this.connection.rpc.call(MNEMON_SETTINGS_CHANNEL, endpoint, payload, controller.signal);
+					return await callMnemonRpc(this.connection, MNEMON_SETTINGS_CHANNEL, endpoint, payload, controller.signal);
 				} catch (error) {
 					if (controller.signal.aborted) throw new Error("Mnemon settings request timed out");
 					throw error;

package/lib/index.js

@@ -2,6 +2,7 @@ import { i as withMemoryStorageLock, n as memoryStrategyConfigurationValues, r a
 import { a as prepareMemoryContributions, i as validateMemoryPluginGraph, n as MemoryCompositionGeneration, r as captureMemoryContributionSnapshot, t as provideMemoryRuntime } from "./runtime-AtIOTeP1.js";
 import { DEFAULT_MEMORY_VIEW_BUDGET, MEMORY_CAPABILITIES } from "./contracts.js";
 import { r as defineMemoryPlugin, t as canonicalMemoryJson } from "./definitions-j0FLgE0-.js";
+import { Context } from "@deepseek-ai/cordis";
 import z from "schemastery";
 import { basename, delimiter, dirname, isAbsolute, join, normalize, resolve } from "node:path";
 import { resolveEmbedding, resolvePersistenceStrategy, resolveRecallQuality } from "dsh-mnemon-source-memory-spaces";
@@ -15,6 +16,7 @@ import { fileURLToPath } from "node:url";
 import { findMnemonCommand, mnemonNpmLauncher } from "dsh-mnemon-source-memory-spaces/native-cli";
 import { spawn } from "node:child_process";
 import { z as z$1 } from "zod";
+import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 //#region src/host/display-mode.ts
 /** Keep the historical misspelling at input boundaries, never in UI or runtime state. */
 function normalizeDisplayMode(value) {
@@ -38,6 +40,7 @@ const MNEMON_ACTIVATION_CHANNEL = "/dsh-mnemon-activation";
 const MNEMON_WRITE_CHANNEL = "/dsh-mnemon-write";
 const MNEMON_PACK_CHANNEL = "/dsh-mnemon-pack";
 const MNEMON_SETTINGS_CHANNEL = "/dsh-mnemon-settings";
+const MNEMON_REMOTE_NAMESPACE = "dshMnemon";
 const MNEMON_SETTINGS_NAMESPACE = "mnemon";
 const CATEGORIES = [
 	"preference",
@@ -6508,10 +6511,20 @@ function createPackHandler(input) {
 }
 function registerRpc(connection, input, lifecycle, versions, managementAuthority = "loopback") {
 	const versionManager = versions ?? new VersionUpdateManager({ mnemonCliPath: () => input.config.cliPath });
-	connection.rpc.handle(MNEMON_READ_CHANNEL, createReadHandler(input, lifecycle, versionManager), { authority: "trusted-host" });
-	connection.rpc.handle(MNEMON_ACTIVATION_CHANNEL, createActivationHandler(input), { authority: "trusted-host" });
-	connection.rpc.handle(MNEMON_WRITE_CHANNEL, createWriteHandler(input, lifecycle, versionManager), { authority: managementAuthority });
-	connection.rpc.handle(MNEMON_PACK_CHANNEL, createPackHandler(input), { authority: managementAuthority });
+	const readHandler = createReadHandler(input, lifecycle, versionManager);
+	const activationHandler = createActivationHandler(input);
+	const writeHandler = createWriteHandler(input, lifecycle, versionManager);
+	const packHandler = createPackHandler(input);
+	connection.rpc.handle(MNEMON_READ_CHANNEL, readHandler, { authority: "trusted-host" });
+	connection.rpc.handle(MNEMON_ACTIVATION_CHANNEL, activationHandler, { authority: "trusted-host" });
+	connection.rpc.handle(MNEMON_WRITE_CHANNEL, writeHandler, { authority: managementAuthority });
+	connection.rpc.handle(MNEMON_PACK_CHANNEL, packHandler, { authority: managementAuthority });
+	return {
+		read: readHandler,
+		activation: activationHandler,
+		write: writeHandler,
+		pack: packHandler
+	};
 }
 //#endregion
 //#region src/host/settings.ts
@@ -6660,7 +6673,9 @@ function createSettingsHandler(settings) {
 	};
 }
 function registerSettingsRpc(connection, settings, authority = "loopback") {
-	connection.rpc.handle(MNEMON_SETTINGS_CHANNEL, createSettingsHandler(settings), { authority });
+	const handler = createSettingsHandler(settings);
+	connection.rpc.handle(MNEMON_SETTINGS_CHANNEL, handler, { authority });
+	return handler;
 }
 //#endregion
 //#region src/host/tools.ts
@@ -8243,8 +8258,14 @@ function createViewHandler(runtime, engine, management, access, lifecycle, insta
 	};
 }
 function registerViewRpc(connection, runtime, engine, management, lifecycle, authority, installation) {
-	connection.rpc.handle(MNEMON_VIEW_CHANNEL, createViewHandler(runtime, engine, management, "read", lifecycle, installation), { authority: "trusted-host" });
-	connection.rpc.handle(MNEMON_VIEW_WRITE_CHANNEL, createViewHandler(runtime, engine, management, "write", lifecycle, installation), { authority });
+	const readHandler = createViewHandler(runtime, engine, management, "read", lifecycle, installation);
+	const writeHandler = createViewHandler(runtime, engine, management, "write", lifecycle, installation);
+	connection.rpc.handle(MNEMON_VIEW_CHANNEL, readHandler, { authority: "trusted-host" });
+	connection.rpc.handle(MNEMON_VIEW_WRITE_CHANNEL, writeHandler, { authority });
+	return {
+		read: readHandler,
+		write: writeHandler
+	};
 }
 //#endregion
 //#region src/host/plugin-installation.ts
@@ -8461,6 +8482,218 @@ var MemoryPluginInstallation = class {
 	}
 };
 //#endregion
+//#region src/host/remote-rpc.ts
+var __runInitializers = function(thisArg, initializers, value) {
+	var useValue = arguments.length > 2;
+	for (var i = 0; i < initializers.length; i++) value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+	return useValue ? value : void 0;
+};
+var __esDecorate = function(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+	function accept(f) {
+		if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected");
+		return f;
+	}
+	var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+	var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+	var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+	var _, done = false;
+	for (var i = decorators.length - 1; i >= 0; i--) {
+		var context = {};
+		for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+		for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+		context.addInitializer = function(f) {
+			if (done) throw new TypeError("Cannot add initializers after decoration has completed");
+			extraInitializers.push(accept(f || null));
+		};
+		var result = (0, decorators[i])(kind === "accessor" ? {
+			get: descriptor.get,
+			set: descriptor.set
+		} : descriptor[key], context);
+		if (kind === "accessor") {
+			if (result === void 0) continue;
+			if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+			if (_ = accept(result.get)) descriptor.get = _;
+			if (_ = accept(result.set)) descriptor.set = _;
+			if (_ = accept(result.init)) initializers.unshift(_);
+		} else if (_ = accept(result)) {
+			if (kind === "field") initializers.unshift(_);
+			else descriptor[key] = _;
+		}
+	}
+	if (target) Object.defineProperty(target, contextIn.name, descriptor);
+	done = true;
+};
+function denied() {
+	return {
+		ok: false,
+		error: {
+			code: "bad-request",
+			message: "remote Mnemon management requires remoteAccess: trusted-host",
+			details: { issues: [] }
+		}
+	};
+}
+function unknownSettingsEndpoint(endpoint) {
+	return {
+		ok: false,
+		error: {
+			code: "bad-request",
+			message: `unknown remote Mnemon settings endpoint: ${endpoint}`,
+			details: { issues: [] }
+		}
+	};
+}
+/**
+* Project Mnemon's existing handlers through DSH API Gateway. The Gateway owns
+* `/api`, Host/Origin validation, browser pairing, and response envelopes;
+* this Service retains Mnemon's narrower management grant.
+*/
+let MnemonRemoteService = (() => {
+	let _classSuper = TypertRemoteService;
+	let _instanceExtraInitializers = [];
+	let _read_decorators;
+	let _activation_decorators;
+	let _write_decorators;
+	let _pack_decorators;
+	let _settings_decorators;
+	let _view_decorators;
+	let _viewWrite_decorators;
+	return class MnemonRemoteService extends _classSuper {
+		static {
+			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+			_read_decorators = [Remote("read")];
+			_activation_decorators = [Remote("activation")];
+			_write_decorators = [Remote("write")];
+			_pack_decorators = [Remote("pack")];
+			_settings_decorators = [Remote("settings")];
+			_view_decorators = [Remote("view")];
+			_viewWrite_decorators = [Remote("viewWrite")];
+			__esDecorate(this, null, _read_decorators, {
+				kind: "method",
+				name: "read",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "read" in obj,
+					get: (obj) => obj.read
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _activation_decorators, {
+				kind: "method",
+				name: "activation",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "activation" in obj,
+					get: (obj) => obj.activation
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _write_decorators, {
+				kind: "method",
+				name: "write",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "write" in obj,
+					get: (obj) => obj.write
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _pack_decorators, {
+				kind: "method",
+				name: "pack",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "pack" in obj,
+					get: (obj) => obj.pack
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _settings_decorators, {
+				kind: "method",
+				name: "settings",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "settings" in obj,
+					get: (obj) => obj.settings
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _view_decorators, {
+				kind: "method",
+				name: "view",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "view" in obj,
+					get: (obj) => obj.view
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _viewWrite_decorators, {
+				kind: "method",
+				name: "viewWrite",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "viewWrite" in obj,
+					get: (obj) => obj.viewWrite
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
+			if (_metadata) Object.defineProperty(this, Symbol.metadata, {
+				enumerable: true,
+				configurable: true,
+				writable: true,
+				value: _metadata
+			});
+		}
+		handlers = __runInitializers(this, _instanceExtraInitializers);
+		constructor(ctx, handlers) {
+			super(ctx, "mnemonRemote", { namespace: MNEMON_REMOTE_NAMESPACE });
+			this.handlers = handlers;
+		}
+		read(endpoint, payload, signal) {
+			return this.handlers.read(endpoint, payload, signal);
+		}
+		activation(endpoint, payload, signal) {
+			return this.handlers.activation(endpoint, payload, signal);
+		}
+		write(endpoint, payload, signal) {
+			if (!this.handlers.management) return Promise.resolve(denied());
+			return this.handlers.write(endpoint, payload, signal);
+		}
+		pack(endpoint, payload, signal) {
+			if (!this.handlers.management) return Promise.resolve(denied());
+			return this.handlers.pack(endpoint, payload, signal);
+		}
+		async settings(endpoint, payload, signal) {
+			if (endpoint === "mutate" && !this.handlers.management) return denied();
+			if (endpoint !== "get" && endpoint !== "mutate") return unknownSettingsEndpoint(endpoint);
+			const response = await this.handlers.settings(endpoint, payload, signal);
+			if (endpoint !== "get" || this.handlers.management || !response.ok || typeof response.value !== "object" || response.value === null || Array.isArray(response.value)) return response;
+			return {
+				...response,
+				value: {
+					...response.value,
+					writable: false
+				}
+			};
+		}
+		view(endpoint, payload, signal) {
+			return this.handlers.view(endpoint, payload, signal);
+		}
+		viewWrite(endpoint, payload, signal) {
+			if (!this.handlers.management) return Promise.resolve(denied());
+			return this.handlers.viewWrite(endpoint, payload, signal);
+		}
+	};
+})();
+//#endregion
 //#region src/host/plugin.ts
 const name = "dsh-mnemon";
 const provide = ["mnemonMemory"];
@@ -8573,9 +8806,16 @@ function apply(rawContext, config = {}) {
 	ctx.inject(["connection"], (webContext) => {
 		if (webContext.connection === void 0) return;
 		const managementAuthority = resolved.remoteAccess === "trusted-host" ? "trusted-host" : "loopback";
-		registerRpc(webContext.connection, runtime, lifecycle, void 0, managementAuthority);
-		registerSettingsRpc(webContext.connection, ctx.settings, managementAuthority);
-		registerViewRpc(webContext.connection, runtime, extensions, memoryPlugins, lifecycle, managementAuthority, pluginInstallation);
+		const rpc = registerRpc(webContext.connection, runtime, lifecycle, void 0, managementAuthority);
+		const settings = registerSettingsRpc(webContext.connection, ctx.settings, managementAuthority);
+		const view = registerViewRpc(webContext.connection, runtime, extensions, memoryPlugins, lifecycle, managementAuthority, pluginInstallation);
+		if (Context.is(webContext)) new MnemonRemoteService(webContext, {
+			...rpc,
+			settings,
+			view: view.read,
+			viewWrite: view.write,
+			management: managementAuthority === "trusted-host"
+		});
 	});
 }
 //#endregion

package/lib/testing.js

@@ -1,8 +1,8 @@
 import { t as provideMemoryRuntime } from "./runtime-AtIOTeP1.js";
 import { DEFAULT_MEMORY_VIEW_BUDGET } from "./contracts.js";
 import { c as jsonClone } from "./definitions-j0FLgE0-.js";
-import { readFileSync } from "node:fs";
 import { Context } from "@deepseek-ai/cordis";
+import { readFileSync } from "node:fs";
 //#region src/sdk/testing.ts
 /**
 * A test fixture, not a production service or a second Loader. It mounts real

package/lib/types/src/host/protocol.d.ts

@@ -24,6 +24,16 @@ export declare const MNEMON_ACTIVATION_CHANNEL = "/dsh-mnemon-activation";
 export declare const MNEMON_WRITE_CHANNEL = "/dsh-mnemon-write";
 export declare const MNEMON_PACK_CHANNEL = "/dsh-mnemon-pack";
 export declare const MNEMON_SETTINGS_CHANNEL = "/dsh-mnemon-settings";
+/** DSH API Gateway endpoints used by paired remote Web clients. */
+export declare const MNEMON_REMOTE_CHANNEL = "/api";
+export declare const MNEMON_REMOTE_NAMESPACE = "dshMnemon";
+export declare const MNEMON_REMOTE_READ_ENDPOINT = "dshMnemon/read";
+export declare const MNEMON_REMOTE_ACTIVATION_ENDPOINT = "dshMnemon/activation";
+export declare const MNEMON_REMOTE_WRITE_ENDPOINT = "dshMnemon/write";
+export declare const MNEMON_REMOTE_PACK_ENDPOINT = "dshMnemon/pack";
+export declare const MNEMON_REMOTE_SETTINGS_ENDPOINT = "dshMnemon/settings";
+export declare const MNEMON_REMOTE_VIEW_ENDPOINT = "dshMnemon/view";
+export declare const MNEMON_REMOTE_VIEW_WRITE_ENDPOINT = "dshMnemon/viewWrite";
 export declare const MNEMON_SETTINGS_NAMESPACE = "mnemon";
 export declare const MNEMON_UI_SETTINGS_NAMESPACE = "mnemon-ui";
 export * from './view-protocol.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Composable three-tier memory control plane for DeepSeek Harness: persistent runtime context, searchable project documents, pluggable long-term memory, guarded strategies, WebUI, and headless tools.",
   "keywords": [
     "deepseek-harness",
@@ -161,6 +161,7 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -171,6 +172,7 @@
     "@deepseek-ai/dsh": "0.1.2-rc.1",
     "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
     "@deepseek-ai/dsh-agent-loop": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-gateway": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-connection": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
@@ -192,6 +194,8 @@
     "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.2-rc.1",
     "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
     "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-registry": "0.1.2-rc.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",