dsh-mnemon 0.3.4 → 0.3.5

package/README.md

@@ -24,7 +24,7 @@
 <p align="center">
   <a href="./docs/en/capabilities.md"><strong>Explore the capability map</strong></a> ·
   <a href="./docs/en/getting-started.md">Start in five minutes</a> ·
-  <a href="./docs/en/releases/v0.3.4.md">Read the v0.3.4 notes</a> ·
+  <a href="./docs/en/releases/v0.3.5.md">Read the v0.3.5 notes</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">Watch the widescreen demo</a>
 </p>
 
@@ -108,7 +108,7 @@ Windows users can install the official v0.2.3-or-newer release ZIP. The expected
 
 ### 2. Install DSH and the plugin
 
-This release is verified against DSH 0.1.1-rc.2, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`; Node 20 lacks host primitives used by rc.2. The dsh-mnemon package itself retains Node.js 20 compatibility for older compatible DSH hosts. DSH rc.2 is published on npm's `latest` and `next` tags; use the exact version below for a reproducible installation:
+The registry installation remains verified against DSH 0.1.1-rc.2, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`; Node 20 lacks host primitives used by rc.2. Source compatibility is also verified against the source-only DSH 0.1.2-alpha.1 preview; it is not an npm installation target. The dsh-mnemon package itself retains Node.js 20 compatibility for older compatible DSH hosts. Use the exact published version below for a reproducible installation; plugin authors can follow the [alpha source workflow](./docs/en/development.md#dsh-012-alpha1-source-verification).
 
 ```sh
 npm install -g @deepseek-ai/dsh@0.1.1-rc.2
@@ -208,7 +208,7 @@ See [Operations, security, and troubleshooting](./docs/en/operations.md) for bac
 | Back up, update, or troubleshoot | [Operations](./docs/en/operations.md) |
 | Integrate tools, commands, or RPC | [Interface reference](./docs/en/interfaces.md) |
 | Build a Layer, Adapter, Strategy, Guard, or MemorySource extension | [Extension guide](./docs/en/extensions.md) |
-| Review the release | [v0.3.4 release notes](./docs/en/releases/v0.3.4.md) |
+| Review the release | [v0.3.5 release notes](./docs/en/releases/v0.3.5.md) |
 
 See the [documentation hub](./docs/en/README.md) for the full map.
 

package/README.zh-CN.md

@@ -24,7 +24,7 @@
 <p align="center">
   <a href="./docs/zh-CN/capabilities.md"><strong>先看能力地图</strong></a> ·
   <a href="./docs/zh-CN/getting-started.md">5 分钟开始</a> ·
-  <a href="./docs/zh-CN/releases/v0.3.4.md">v0.3.4 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.3.5.md">v0.3.5 升级说明</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">观看宽屏实机演示</a>
 </p>
 
@@ -108,7 +108,7 @@ Windows 推荐安装 v0.2.3 或更高版本的官方 ZIP；标准安装目录与
 
 ### 2. 安装 DSH 与插件
 
-本版本已验证 DSH 0.1.1-rc.2；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`，Node 20 缺少 rc.2 使用的宿主原语。dsh-mnemon 包本身仍为较旧且兼容的 DSH Host 保留 Node.js 20 支持。DSH rc.2 已发布到 npm 的 `latest` 与 `next` 标签；为了可复现安装，下面显式指定版本：
+Registry 安装仍以 DSH 0.1.1-rc.2 验证；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`，Node 20 缺少 rc.2 使用的宿主原语。源码兼容性也已针对仅提供源码的 DSH 0.1.2-alpha.1 预览版验证；它不是 npm 安装目标。dsh-mnemon 包本身仍为较旧且兼容的 DSH Host 保留 Node.js 20 支持。下面显式指定已发布版本以保证可复现安装；插件作者可参照 [alpha 源码验证流程](./docs/zh-CN/development.md#dsh-012-alpha1-源码验证)。
 
 ```sh
 npm install -g @deepseek-ai/dsh@0.1.1-rc.2
@@ -208,7 +208,7 @@ dsh plugin --profile headless add "link:/absolute/path/to/dsh-mnemon"
 | 备份、更新或排障 | [运维指南](./docs/zh-CN/operations.md) |
 | 接入工具、命令或 RPC | [接口参考](./docs/zh-CN/interfaces.md) |
 | 开发 Layer、Adapter、Strategy、Guard 或 MemorySource 扩展 | [扩展开发指南](./docs/zh-CN/extensions.md) |
-| 查看本次升级 | [v0.3.4 发布说明](./docs/zh-CN/releases/v0.3.4.md) |
+| 查看本次升级 | [v0.3.5 发布说明](./docs/zh-CN/releases/v0.3.5.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/client.js

@@ -6351,7 +6351,8 @@ window.__ModuleLoader__.load({
 			return (0, react.useContext)(I18nContext);
 		}
 		function useLocale() {
-			return (0, react.useContext)(LocaleContext) === "en" ? "en-US" : "zh-CN";
+			const locale = (0, react.useContext)(LocaleContext);
+			return locale === "en" ? "en-US" : locale === "zh" ? "zh-CN" : locale;
 		}
 		function categoryLabel(t, category) {
 			return CATEGORY_KEYS[category] === void 0 ? category : t(CATEGORY_KEYS[category]);
@@ -12500,7 +12501,7 @@ window.__ModuleLoader__.load({
 			const currentCwd = sessions.current === void 0 ? void 0 : sessions.byId[sessions.current]?.cwd;
 			const normalizePath = (value) => value.replace(/[\\/]+$/u, "");
 			const effectiveWorkspace = currentCwd === void 0 ? void 0 : workspaces.items.find((workspace) => normalizePath(workspace.path) === normalizePath(currentCwd));
-			const fallbackWorkspace = effectiveWorkspace ?? workspaces.items.find((workspace) => String(workspace.workspaceId) === String(workspaces.recentWorkspaceId)) ?? workspaces.items[0];
+			const fallbackWorkspace = effectiveWorkspace ?? workspaces.items[0];
 			const resolvedSelectedId = selectedWorkspaceId !== void 0 && workspaces.items.some((workspace) => String(workspace.workspaceId) === selectedWorkspaceId) ? selectedWorkspaceId : fallbackWorkspace === void 0 ? void 0 : String(fallbackWorkspace.workspaceId);
 			(0, react.useEffect)(() => {
 				if (resolvedSelectedId !== selectedWorkspaceId) setSelectedWorkspaceId(resolvedSelectedId);
@@ -12846,14 +12847,11 @@ window.__ModuleLoader__.load({
 						current: void 0,
 						byId: {}
 					};
-					const workspaces = ctx.workspaces?.list?.getSnapshot?.() ?? {
-						items: [],
-						recentWorkspaceId: void 0
-					};
+					const workspaces = ctx.workspaces?.list?.getSnapshot?.() ?? { items: [] };
 					const sessionId = sessions.current;
 					const cwd = sessionId === void 0 ? void 0 : sessions.byId[sessionId]?.cwd;
 					const normalizePath = (value) => value.replace(/[\\/]+$/u, "");
-					const workspace = cwd === void 0 ? workspaces.items.find((candidate) => String(candidate.workspaceId) === String(workspaces.recentWorkspaceId)) ?? workspaces.items[0] : workspaces.items.find((candidate) => normalizePath(candidate.path) === normalizePath(cwd));
+					const workspace = cwd === void 0 ? workspaces.items[0] : workspaces.items.find((candidate) => normalizePath(candidate.path) === normalizePath(cwd));
 					return {
 						scope: settings,
 						interactionScope: interactionSettings,

package/lib/index.js

@@ -9324,11 +9324,7 @@ const ACTIVATION_PAYLOAD_FIELDS = /* @__PURE__ */ new Set([
 	"sessionId",
 	"workspaceId"
 ]);
-/**
-* Expose only DSH read-routing activation to trusted Web hosts. Metadata,
-* provider connections, credentials, and durable memory writes stay on the
-* loopback-only write channel.
-*/
+/** Keep activation on a narrow, independently validated control endpoint. */
 function createActivationHandler(input) {
 	return async (endpoint, rawPayload) => {
 		try {
@@ -9566,7 +9562,7 @@ function createWriteHandler(input, lifecycle, runtimeMemory, versions) {
 		}
 	};
 }
-/** Backup payloads contain private memory and use the deployment's management authority. */
+/** Backup payloads contain private memory and stay behind DSH browser authentication. */
 function createPackHandler(input, writeEnabled = true) {
 	return async (endpoint, rawPayload) => {
 		try {
@@ -9585,7 +9581,11 @@ function createPackHandler(input, writeEnabled = true) {
 		}
 	};
 }
-/** Reads and activation use trusted hosts; other privileged channels require explicit promotion. */
+/**
+* Register one call shape across DSH rc.2 and 0.1.2-alpha.1. The former
+* enforces channel authority; the latter ignores the trailing options object
+* after applying its uniform browser-session authentication boundary.
+*/
 function registerRpc(connection, input, lifecycle, runtimeMemory, storage, packs, versions, managementAuthority = "loopback") {
 	const versionManager = versions ?? new VersionUpdateManager({ mnemonCliPath: () => findVersionCli(input) });
 	connection.rpc.handle(MNEMON_READ_CHANNEL, createReadHandler(input, lifecycle, runtimeMemory, storage, versionManager), { authority: "trusted-host" });

package/lib/types/src/client/MnemonTurnTail.d.ts

@@ -1,5 +1,4 @@
 import type { ClientConnectionHandle } from '../shared/contracts.ts';
-import type { TurnTailOwnerProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import { type MnemonAnchorPage } from './anchor.ts';
 import type { MnemonKey } from './locales.ts';
 export interface MnemonTurnTailProps {
@@ -15,6 +14,8 @@ export interface MnemonTurnTailProps {
 /** Route a settled tool name to the workbench page that explains its effect. */
 export declare function memoryPageForTool(name: string): MnemonAnchorPage;
 /** Whether this entry renders for the owner; chain selectors decline quietly. */
-export declare function selectMnemonTurnTail(owner: TurnTailOwnerProps): Record<string, never> | null;
+export declare function selectMnemonTurnTail(owner: {
+    turn: unknown;
+}): Record<string, never> | null;
 /** One-line memory-activity bar under a completed turn; hides when the turn touched no memory. */
 export declare const MnemonTurnTail: import("react").NamedExoticComponent<MnemonTurnTailProps>;

package/lib/types/src/client/MnemonView.d.ts

@@ -9,7 +9,7 @@ export interface MnemonViewProps {
     workspaceSelection?: MnemonWorkspaceSelection;
     surface?: MnemonViewSurface;
     t?: MnemonTranslate;
-    locale?: 'zh' | 'en';
+    locale?: string;
     onClose?: () => void;
 }
 export interface MnemonWorkspaceSelection {

package/lib/types/src/client/dsh-compat.d.ts

@@ -6,15 +6,46 @@
  */
 import type { ConnectionHandle } from '@deepseek-ai/dsh-client-connection/client';
 import type { LocaleRuntime } from '@deepseek-ai/dsh-client-locale/client';
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context } from '@deepseek-ai/cordis';
 import type { MnemonKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         mnemon: MnemonKey;
     }
 }
-/** DSH 0.1.1-rc.2 client context plus the two injected feature services. */
-export type MnemonClientContext = ClientContext & {
+export interface MnemonSessionSummary {
+    cwd?: string;
+    origin?: string;
+    projectionValues?: Readonly<Record<string, unknown>>;
+    [key: string]: unknown;
+}
+export interface MnemonSessionListState {
+    current?: string;
+    byId: Record<string, MnemonSessionSummary>;
+    [key: string]: unknown;
+}
+export interface MnemonWorkspaceSummary {
+    workspaceId: unknown;
+    title: string;
+    path: string;
+}
+export interface MnemonWorkspaceListState {
+    items: MnemonWorkspaceSummary[];
+    [key: string]: unknown;
+}
+interface SnapshotStore<State> {
+    getSnapshot(): State;
+    subscribe(listener: () => void): () => void;
+}
+/** Context shared by the released client runtime and the 0.1.2 controller split. */
+export type MnemonClientContext = Context & {
     connection: ConnectionHandle;
     locale: LocaleRuntime;
+    sessions: {
+        list: SnapshotStore<MnemonSessionListState>;
+    };
+    workspaces: {
+        list: SnapshotStore<MnemonWorkspaceListState>;
+    };
 };
+export {};

package/lib/types/src/client/subagent-token-usage.d.ts

@@ -1,6 +1,5 @@
-import type { SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
-import type { MnemonClientContext } from './dsh-compat.ts';
+import type { MnemonClientContext, MnemonSessionListState } from './dsh-compat.ts';
 export declare const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
 export interface MnemonTokenUsageProjection {
     uncachedInputTokens: number;
@@ -13,9 +12,9 @@ export interface MnemonTokenUsageProjection {
  * released official catalog component. All other consumers continue seeing
  * DSH's complete-log `tokenUsage` value.
  */
-export declare function scopeSubagentTokenUsage(state: SessionListState): SessionListState;
+export declare function scopeSubagentTokenUsage(state: MnemonSessionListState): MnemonSessionListState;
 /** Wrap the framework hook while preserving its selector/equality contract. */
-export declare function createScopedUseSessions(useSessions: SnapshotSelectorHook<SessionListState>): SnapshotSelectorHook<SessionListState>;
+export declare function createScopedUseSessions(useSessions: SnapshotSelectorHook<MnemonSessionListState>): SnapshotSelectorHook<MnemonSessionListState>;
 /**
  * Shadow the released official single-slot entry at a lower priority. The
  * component and action factory are captured from the public slot ledger, so

package/lib/types/src/contracts.d.ts

@@ -1,12 +1,18 @@
 import type { RpcResult, SettingsOperation } from './shared/contracts.ts';
 export type { ClientConnectionHandle, ClientSettingsScope, ClientSettingsSnapshot, JsonPrimitive, JsonValue, RpcError, RpcResult, SettingsOperation, } from './shared/contracts.ts';
-export type HostRpcHandler = (endpoint: string, payload: unknown) => Promise<RpcResult<unknown>>;
+export type HostRpcHandler = (endpoint: string, payload: unknown, signal?: AbortSignal) => Promise<RpcResult<unknown>>;
 export type HostRpcAuthority = 'trusted-host' | 'loopback';
+/**
+ * DSH rc.2 requires this registration policy. DSH 0.1.2-alpha.1 accepts only
+ * the first two JavaScript arguments and safely ignores this trailing value.
+ * Keeping one unconditional call shape avoids runtime version detection.
+ */
+export interface HostRpcRegistrationOptions {
+    readonly authority: HostRpcAuthority;
+}
 export interface HostConnectionHandle {
     rpc: {
-        handle(channel: string, handler: HostRpcHandler, options: {
-            authority: HostRpcAuthority;
-        }): unknown;
+        handle(channel: string, handler: HostRpcHandler, options: HostRpcRegistrationOptions): unknown;
     };
 }
 export interface HostSettingsScope<T> {

package/lib/types/src/rpc.d.ts

@@ -9,14 +9,14 @@ import { VersionUpdateManager } from './version-updates.ts';
 export { MNEMON_ACTIVATION_CHANNEL, MNEMON_PACK_CHANNEL, MNEMON_READ_CHANNEL, MNEMON_WRITE_CHANNEL } from './channels.ts';
 type RuntimeInput = MnemonService | LiveMnemonRuntime;
 export declare function createReadHandler(input: RuntimeInput, lifecycle?: MnemonLifecycle, runtimeMemory?: RuntimeMemoryController, storage?: StorageScopeInspector, versions?: VersionUpdateManager): HostRpcHandler;
-/**
- * Expose only DSH read-routing activation to trusted Web hosts. Metadata,
- * provider connections, credentials, and durable memory writes stay on the
- * loopback-only write channel.
- */
+/** Keep activation on a narrow, independently validated control endpoint. */
 export declare function createActivationHandler(input: RuntimeInput): HostRpcHandler;
 export declare function createWriteHandler(input: RuntimeInput, lifecycle?: MnemonLifecycle, runtimeMemory?: RuntimeMemoryController, versions?: VersionUpdateManager): HostRpcHandler;
-/** Backup payloads contain private memory and use the deployment's management authority. */
+/** Backup payloads contain private memory and stay behind DSH browser authentication. */
 export declare function createPackHandler(input: MnemonPackManager | LiveMnemonRuntime, writeEnabled?: boolean | (() => boolean)): HostRpcHandler;
-/** Reads and activation use trusted hosts; other privileged channels require explicit promotion. */
+/**
+ * Register one call shape across DSH rc.2 and 0.1.2-alpha.1. The former
+ * enforces channel authority; the latter ignores the trailing options object
+ * after applying its uniform browser-session authentication boundary.
+ */
 export declare function registerRpc(connection: HostConnectionHandle, input: RuntimeInput, lifecycle?: MnemonLifecycle, runtimeMemory?: RuntimeMemoryController, storage?: StorageScopeInspector, packs?: MnemonPackManager, versions?: VersionUpdateManager, managementAuthority?: HostRpcAuthority): void;

package/lib/types/src/shared/contracts.d.ts

@@ -145,7 +145,7 @@ export interface Config {
     displayMode?: 'sidebar' | 'buildin';
     tabEnabled?: boolean;
     writeEnabled?: boolean;
-    /** Remote Web policy for privileged Mnemon RPC. This boundary is sampled at Host startup. */
+    /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
     remoteAccess?: 'read-only' | 'trusted-host';
     lifecycleEnabled?: boolean;
     recallMode?: 'guided' | 'off';
@@ -232,6 +232,7 @@ export interface ResolvedConfig {
     displayMode: 'sidebar' | 'buildin';
     tabEnabled: boolean;
     writeEnabled: boolean;
+    /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
     remoteAccess: 'read-only' | 'trusted-host';
     lifecycleEnabled: boolean;
     recallMode: 'guided' | 'off';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.3.4",
+  "version": "0.3.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",
@@ -114,9 +114,9 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-locale"
       ],
@@ -133,7 +133,9 @@
     "verify:build": "node scripts/verify-deterministic-build.mjs",
     "verify:headless": "node scripts/verify-headless-profile.mjs",
     "verify:package": "node scripts/verify-package-contents.mjs && node scripts/verify-public-entries.mjs && pnpm run lint:package",
-    "verify": "pnpm run typecheck && pnpm run test && pnpm run verify:build && pnpm run verify:headless && pnpm run verify:package"
+    "verify": "pnpm run typecheck && pnpm run test && pnpm run verify:build && pnpm run verify:headless && pnpm run verify:package",
+    "dsh:link-source": "node scripts/link-dsh-source.mjs",
+    "dsh:restore-registry": "node scripts/link-dsh-source.mjs --restore"
   },
   "dependencies": {
     "fflate": "^0.8.3",
@@ -142,7 +144,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -152,9 +154,9 @@
     "@deepseek-ai/dsh": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-conversation": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-primitives": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-tool": "0.1.1-rc.2",