dsh-mnemon 0.4.0 → 0.4.2

package/lib/index.js

@@ -14,6 +14,14 @@ import { strToU8, unzipSync, zipSync } from "fflate";
 import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { z as z$1 } from "zod";
+//#region src/shared/display-mode.ts
+/** Keep the historical misspelling at input boundaries, never in UI or runtime state. */
+function normalizeDisplayMode(value) {
+	if (value === void 0 || value === "sidebar") return "sidebar";
+	if (value === "builtin" || value === "buildin") return "builtin";
+	throw new Error("dsh-mnemon: displayMode must be sidebar or builtin (legacy buildin is accepted)");
+}
+//#endregion
 //#region src/shared/contracts.ts
 const MNEMON_READ_CHANNEL = "/dsh-mnemon-read";
 const MNEMON_ACTIVATION_CHANNEL = "/dsh-mnemon-activation";
@@ -202,6 +210,11 @@ const Config = z.object({
 		maxUnknownResults: 2
 	}),
 	routingGuidance: z.boolean().default(true),
+	displayMode: z.union([
+		"sidebar",
+		"builtin",
+		"buildin"
+	]).default("sidebar"),
 	tabEnabled: z.boolean().default(true),
 	writeEnabled: z.boolean().default(true),
 	remoteAccess: z.union(["read-only", "trusted-host"]).default("read-only"),
@@ -457,6 +470,7 @@ function resolveConfig(config = {}) {
 		memoryTopology: resolveMemoryTopology(config.memoryTopology),
 		recallQuality: resolveRecallQuality(config.recallQuality),
 		routingGuidance: config.routingGuidance ?? true,
+		displayMode: normalizeDisplayMode(config.displayMode),
 		tabEnabled: config.tabEnabled ?? true,
 		writeEnabled: config.writeEnabled ?? true,
 		remoteAccess: config.remoteAccess ?? "read-only",
@@ -2712,7 +2726,7 @@ var MnemonPackManager = class {
 				};
 				const archive = zipSync(entries, {
 					level: 6,
-					mtime: /* @__PURE__ */ new Date("1980-01-01T00:00:00.000Z")
+					mtime: new Date(1980, 0, 1)
 				});
 				if (archive.length > 50331648) throw new Error("exported Mnemon Pack exceeds the transport safety limit");
 				return {
@@ -9861,7 +9875,10 @@ function descriptor(settings, namespace) {
 	if (view === void 0) throw new Error(`${namespace} settings namespace is unavailable`);
 	return {
 		status: "ready",
-		value: view.value,
+		value: namespace === "mnemon" && displayModeOf(view.value) === "buildin" ? {
+			...object(view.value),
+			displayMode: "builtin"
+		} : view.value,
 		base: view.base,
 		user: view.user,
 		revision: view.revision,
@@ -9874,6 +9891,28 @@ function object(value) {
 	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("payload must be an object");
 	return value;
 }
+function displayModeOf(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value.displayMode : void 0;
+}
+/** Canonicalize only the legacy field through DSH's locked, revision-fenced writer. */
+async function migrateLegacyDisplayMode(settings) {
+	if (!settings.writable) return;
+	for (let attempt = 0; attempt < 3; attempt += 1) {
+		const view = settings.describe({ redactSecrets: true }).find((candidate) => candidate.ns === MNEMON_SETTINGS_NAMESPACE);
+		if (view === void 0) return;
+		if ((typeof view.user === "object" && view.user !== null && Object.hasOwn(view.user, "displayMode") ? displayModeOf(view.user) : displayModeOf(view.base) ?? displayModeOf(view.value)) !== "buildin") return;
+		try {
+			await settings.mutate(MNEMON_SETTINGS_NAMESPACE, [{
+				op: "set",
+				path: ["displayMode"],
+				value: "builtin"
+			}], view.revision);
+			return;
+		} catch (error) {
+			if (attempt === 2 || typeof error !== "object" || error === null || !("code" in error) || error.code !== "SETTINGS_CONFLICT") throw error;
+		}
+	}
+}
 const MUTABLE_FIELDS = [
 	"storageScope",
 	"runtimeUserScope",
@@ -9892,6 +9931,7 @@ const MUTABLE_FIELDS = [
 	"recallMode",
 	"writebackMode",
 	"idleReviewMs",
+	"displayMode",
 	"tabEnabled",
 	"writeEnabled",
 	"persistenceStrategy",
@@ -9936,11 +9976,12 @@ function createSettingsHandler(settings) {
 				return {
 					op: "set",
 					path,
-					value: op.value
+					value: namespace === "mnemon" && path[0] === "displayMode" ? normalizeDisplayMode(op.value) : op.value
 				};
 			});
 			const revision = payload.expectedRevision === void 0 ? void 0 : Number(payload.expectedRevision);
 			await settings.mutate(namespace, ops, revision);
+			if (namespace === "mnemon") await migrateLegacyDisplayMode(settings);
 			return success(descriptor(settings, namespace));
 		} catch (error) {
 			return failure(error, namespace);
@@ -10937,6 +10978,23 @@ function apply(rawContext, config = {}) {
 		base: resolveInteractionConfig(resolved.conversationInteraction),
 		applies: "live"
 	});
+	ctx.effect(() => {
+		let disposed = false;
+		const migrate = () => {
+			if (disposed) return;
+			migrateLegacyDisplayMode(ctx.settings).catch((error) => {
+				console.warn("dsh-mnemon: could not persist the builtin displayMode migration", error);
+			});
+		};
+		const unsubscribe = ctx.on("settings/document-updated", ((namespace) => {
+			if (namespace === "mnemon") migrate();
+		}));
+		migrate();
+		return () => {
+			disposed = true;
+			unsubscribe();
+		};
+	}, "dsh-mnemon: canonical displayMode migration");
 	const coordinator = new MnemonSubagentCoordinator(ctx.subagents, runtime, void 0, ctx, () => {
 		const taskAgentModel = runtime.config.taskAgentModel;
 		if (taskAgentModel.mode !== "fixed") return void 0;

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

@@ -1,4 +1,4 @@
-import { type ClientConnectionHandle, type ClientSettingsScope, type Config } from '../shared/contracts.ts';
+import { type ClientConnectionHandle, type ClientSettingsScope, type Config, type MnemonDisplayMode } from '../shared/contracts.ts';
 import { type MnemonTranslate } from './locales.ts';
 export interface MnemonViewProps {
     connection: ClientConnectionHandle;
@@ -6,6 +6,8 @@ export interface MnemonViewProps {
     sessionId?: string;
     workspaceId?: string;
     workspaceSelection?: MnemonWorkspaceSelection;
+    /** Placement affects the scope header, never the shared pages or skin. */
+    surface?: MnemonDisplayMode;
     t?: MnemonTranslate;
     locale?: string;
     onClose?: () => void;

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

@@ -657,6 +657,13 @@ export declare const zh: {
     'config.ready': string;
     'config.noticeBefore': string;
     'config.noticeAfter': string;
+    'config.displayTitle': string;
+    'config.displayDescription': string;
+    'config.displayAria': string;
+    'config.displaySidebar': string;
+    'config.displaySidebarHint': string;
+    'config.displayBuiltin': string;
+    'config.displayBuiltinHint': string;
     'config.storageTitle': string;
     'config.storageDescription': string;
     'config.scope': string;
@@ -1531,6 +1538,13 @@ export declare const en: {
     'config.ready': string;
     'config.noticeBefore': string;
     'config.noticeAfter': string;
+    'config.displayTitle': string;
+    'config.displayDescription': string;
+    'config.displayAria': string;
+    'config.displaySidebar': string;
+    'config.displaySidebarHint': string;
+    'config.displayBuiltin': string;
+    'config.displayBuiltinHint': string;
     'config.storageTitle': string;
     'config.storageDescription': string;
     'config.scope': string;

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

@@ -1,4 +1,6 @@
 import type { HostConnectionHandle, HostRpcAuthority, HostRpcHandler, HostSettingsService } from './contracts.ts';
 export { MNEMON_SETTINGS_CHANNEL, MNEMON_SETTINGS_NAMESPACE, MNEMON_UI_SETTINGS_NAMESPACE } from './shared/contracts.ts';
+/** Canonicalize only the legacy field through DSH's locked, revision-fenced writer. */
+export declare function migrateLegacyDisplayMode(settings: HostSettingsService): Promise<void>;
 export declare function createSettingsHandler(settings: HostSettingsService): HostRpcHandler;
 export declare function registerSettingsRpc(connection: HostConnectionHandle, settings: HostSettingsService, authority?: HostRpcAuthority): void;

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

@@ -132,6 +132,8 @@ export interface ResolvedRecallQualityConfig {
     maxMediumResults: number;
     maxUnknownResults: number;
 }
+export { normalizeDisplayMode } from './display-mode.ts';
+export type MnemonDisplayMode = 'sidebar' | 'builtin';
 export interface Config {
     storageScope?: StorageScopeKind;
     /** Whether USER.md follows the selected storage root or stays in the global root. */
@@ -149,6 +151,8 @@ export interface Config {
     memoryTopology?: MemoryTopologyConfig;
     recallQuality?: RecallQualityConfig;
     routingGuidance?: boolean;
+    /** Entry placement only. Legacy `buildin` input is migrated to `builtin`. */
+    displayMode?: MnemonDisplayMode | 'buildin';
     tabEnabled?: boolean;
     writeEnabled?: boolean;
     /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
@@ -242,6 +246,7 @@ export interface ResolvedConfig {
     memoryTopology: ResolvedMemoryTopologyConfig;
     recallQuality: ResolvedRecallQualityConfig;
     routingGuidance: boolean;
+    displayMode: MnemonDisplayMode;
     tabEnabled: boolean;
     writeEnabled: boolean;
     /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */

package/lib/types/src/shared/display-mode.d.ts

@@ -0,0 +1,3 @@
+import type { MnemonDisplayMode } from './contracts.ts';
+/** Keep the historical misspelling at input boundaries, never in UI or runtime state. */
+export declare function normalizeDisplayMode(value: unknown): MnemonDisplayMode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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",