dsh-mnemon 0.5.16 → 0.5.17

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

@@ -11,6 +11,10 @@ export interface MemoryTopologyDefinition {
     }>;
 }
 export interface MemoryCompositionStatus {
+    /** Whether a composition serves new turns. A rejected change can leave the previous one serving. */
+    serving: boolean;
+    /** The main Strategy composing the serving composition, which a fallback can make differ from the selected one. */
+    strategyTypeId?: string;
     evaluation: import('../core/contracts/index.ts').MemoryCompositionEvaluationReport;
     sources: MemorySourceManagementInstance[];
     configuration: ResolvedMemoryTopologyConfig;
@@ -104,7 +108,7 @@ export type RpcResult<T = JsonValue> = {
     error: RpcError;
 };
 /** Public DSH browser RPC face plus the transport boundary needed to gate local-only writes. */
-export type ClientConnectionHandle = Pick<DshClientConnectionHandle, 'rpc'> & Partial<Pick<DshClientConnectionHandle, 'isLoopback'>>;
+export type ClientConnectionHandle = Pick<DshClientConnectionHandle, 'rpc' | 'isLoopback'>;
 export interface ClientSettingsSnapshot<T> {
     status: 'loading' | 'ready' | 'unavailable';
     value?: T;
@@ -117,11 +121,7 @@ export interface ClientSettingsSnapshot<T> {
 export interface ClientSettingsScope<T> {
     getSnapshot(): ClientSettingsSnapshot<T>;
     subscribe(listener: () => void): () => void;
-    set(field: string, value: unknown): Promise<void>;
-    unset(field: string): Promise<void>;
-    setPath(path: string[], value: unknown): Promise<void>;
-    unsetPath(path: string[]): Promise<void>;
-    mutate?(ops: SettingsOperation[]): Promise<void>;
+    mutate(ops: SettingsOperation[]): Promise<void>;
 }
 export type SettingsOperation = {
     op: 'set';
@@ -220,7 +220,7 @@ export interface Config {
     displayMode?: MnemonDisplayMode | 'buildin';
     tabEnabled?: boolean;
     writeEnabled?: boolean;
-    /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
+    /** Remote management grant for paired pages; loopback pages keep full access. */
     remoteAccess?: 'read-only' | 'trusted-host';
     lifecycleEnabled?: boolean;
     recallMode?: 'guided' | 'off';
@@ -297,7 +297,7 @@ export interface ResolvedConfig {
     displayMode: MnemonDisplayMode;
     tabEnabled: boolean;
     writeEnabled: boolean;
-    /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
+    /** Remote management grant for paired pages; loopback pages keep full access. */
     remoteAccess: 'read-only' | 'trusted-host';
     lifecycleEnabled: boolean;
     recallMode: 'guided' | 'off';
@@ -523,6 +523,8 @@ export interface StatusView {
     };
 }
 export type MnemonPackComponent = 'runtime' | 'documents' | 'memory-spaces';
+/** The Sources that keep their data in Mnemon's data directory, in the order a backup lists them. */
+export declare const MNEMON_PACK_COMPONENTS: readonly ["runtime", "documents", "memory-spaces"];
 export type MnemonPackScope = 'full' | MnemonPackComponent;
 export type MnemonPackImportMode = 'merge' | 'replace';
 export interface MnemonPackComponentSummary {
@@ -543,6 +545,12 @@ export interface MnemonPackManifest {
     components: MnemonPackComponent[];
     summary: MnemonPackComponentSummary[];
 }
+/** Where memory lives now, and where the global scope keeps it when no directory is chosen. */
+export interface MnemonPackTarget {
+    root: string;
+    scope: StorageScopeKind;
+    defaultRoot: string;
+}
 export interface MnemonPackExport {
     fileName: string;
     mimeType: 'application/zip';

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

@@ -8,9 +8,14 @@ export interface MemoryPluginPreference {
     enabled: boolean;
     config: Record<string, MemoryJsonValue>;
 }
+/** Saved form: enablement lives in the DSH profile patch once the plugin manager can write it. */
+export interface MemoryPluginSavedPreference {
+    enabled?: boolean;
+    config: Record<string, MemoryJsonValue>;
+}
 export interface MemoryViewPreferences {
     strategyTypeId?: string;
-    entries: Record<string, MemoryPluginPreference>;
+    entries: Record<string, MemoryPluginSavedPreference>;
 }
 export interface MemoryPluginEntryView {
     entryId: string;

package/lib/types/src/sdk/index.d.ts

@@ -4,6 +4,7 @@ export { defineMemoryPlugin, defineMemorySource, defineMemoryStrategy, defineMem
 export { record as memoryInputRecord, text as memoryInputText, integer as memoryInputInteger, stringArray as memoryInputStringArray, truncate as truncateMemoryText, receipt as createMemoryMutationReceipt, migrationLineage as memoryInputMigrationLineage } from './input.ts';
 export { memoryConfigurationDigest } from './input.ts';
 export { defineMemoryStrategyConfiguration } from './strategy-configuration.ts';
+export { defineMemoryViewExtension, memoryViewExtensionValues, validateMemoryViewExtension } from './view-extensions.ts';
 export type { MemoryStrategyConfiguration, MemoryStrategyConfigurationField, MemoryLocalizedText } from './strategy-configuration.ts';
 export { withMemoryStorageLock } from './storage-lock.ts';
-export type { ComposableMemoryView, MemoryActionOffer, MemoryCompositionEvaluationReport, MemoryEvidence, MemoryMutationReceipt, MemoryPluginDescriptor, MemoryPluginLocalizedText, MemoryPluginProvidedCapability, MemoryPluginRole, MemoryMutationCompletion, MemoryReadGrant, MemorySourceDefinition, MemorySourceFacts, MemoryAvailableSource, MemorySourceManifest, MemorySourcePresentation, MemorySourcePresentationItem, MemorySourceRuntime, MemorySourceViewContext, MemoryStrategyDefinition, MemoryStrategyExtensionDefinition, MemoryStrategyExtensionManifest, MemoryStrategyContribution, MemoryStrategyTurn, MemoryStrategyReadRequest, MemoryStrategyRead, MemoryStrategyManifest, MemoryViewRequest, MemoryViewSourcePresentation, MemoryViewSpec, MemoryViewGuidance, } from "../core/contracts/index.ts";
+export type { ComposableMemoryView, MemoryActionOffer, MemoryCompositionEvaluationReport, MemoryEvidence, MemoryMutationReceipt, MemoryPluginDescriptor, MemoryPluginLocalizedText, MemoryPluginProvidedCapability, MemoryPluginRole, MemoryMutationCompletion, MemoryReadGrant, MemorySourceDefinition, MemorySourceFacts, MemoryAvailableSource, MemorySourceManifest, MemorySourcePresentation, MemorySourcePresentationItem, MemorySourceRuntime, MemorySourceViewContext, MemoryStrategyDefinition, MemoryStrategyExtensionDefinition, MemoryStrategyExtensionManifest, MemoryStrategyContribution, MemoryStrategyTurn, MemoryStrategyReadRequest, MemoryStrategyRead, MemoryStrategyManifest, MemoryViewRequest, MemoryViewSourcePresentation, MemoryViewSpec, MemoryViewGuidance, MemoryViewExtensionSlot, MemoryViewExtensionValues, } from "../core/contracts/index.ts";

package/lib/types/src/sdk/testing.d.ts

@@ -20,6 +20,7 @@ export interface MemoryTestSource {
 export interface MemoryTestOptions {
     strategyInstanceKey?: string;
     strategyTypeId?: string;
+    strategyFallback?: 'sole-strategy';
     sourceConfiguration?: (source: MemoryTestSource) => Readonly<Record<string, MemoryJsonValue>>;
     sourceCapabilities?: (source: MemoryTestSource) => readonly MemoryCapability[];
     now?: () => Date;

package/lib/types/src/sdk/view-extensions.d.ts

@@ -0,0 +1,12 @@
+import { type MemoryAvailableSource, type MemoryJsonValue, type MemoryStrategyContribution, type MemoryStrategyExtensionDefinition, type MemoryViewExtensionSlot, type MemoryViewExtensionValues, type MemoryViewRequest } from '../core/contracts/index.ts';
+/** Validate one standard View extension value; a Strategy validates again before interpreting it. */
+export declare function validateMemoryViewExtension<K extends MemoryViewExtensionSlot>(slot: K, value: MemoryJsonValue): MemoryViewExtensionValues[K];
+/** Standard values contributed to one composition; each slot has at most one owner. */
+export declare function memoryViewExtensionValues(contributions: readonly MemoryStrategyContribution[]): Partial<MemoryViewExtensionValues>;
+/** An extension for whichever selected Strategy declares its standard slot. */
+export declare function defineMemoryViewExtension<K extends MemoryViewExtensionSlot>(definition: {
+    typeId: string;
+    packageName: string;
+    slot: K;
+    contribute(request: MemoryViewRequest, sources: readonly MemoryAvailableSource[]): MemoryViewExtensionValues[K];
+}): MemoryStrategyExtensionDefinition;

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "三级记忆 (dsh-mnemon)",
-    "description": "三级记忆系统：召回 / 写入 / 记忆页签（策略配置在 profile patch 层）"
+    "title": "可组合记忆 (dsh-mnemon)",
+    "description": "面向 DeepSeek Harness 的可组合视图记忆。记忆来源与策略可插拔，开箱即用提供分层记忆。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.5.16",
-  "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.",
+  "version": "0.5.17",
+  "description": "Composable, view-based memory for DeepSeek Harness. Pluggable sources and strategies, with layered memory out of the box.",
   "keywords": [
     "deepseek-harness",
     "deepseek-harness-plugin",
@@ -122,7 +122,6 @@
   },
   "scripts": {
     "build": "tsdown && tsc -p tsconfig.types.json && node scripts/link-bundle-declarations.mjs",
-    "bundle": "tsdown",
     "prepublishOnly": "pnpm run verify",
     "lint:package": "publint --strict && attw --pack . --profile esm-only --quiet",
     "typecheck": "tsc -p tsconfig.json --noEmit",
@@ -139,76 +138,76 @@
     "release:intent": "node scripts/check-release-intent.mjs",
     "release:status": "changeset status",
     "release:version": "changeset version && node scripts/sync-release-metadata.mjs && pnpm install --lockfile-only",
-    "dsh:link-source": "node scripts/link-dsh-source.mjs",
-    "dsh:restore-registry": "node scripts/link-dsh-source.mjs --restore",
     "release:check": "node scripts/release.mjs --check"
   },
   "dependencies": {
-    "@deepseek-ai/cosmokit": "^1.8.4",
-    "dsh-mnemon-provider-byterover": "0.5.4",
-    "dsh-mnemon-provider-hindsight": "0.5.4",
-    "dsh-mnemon-provider-holographic": "0.5.4",
-    "dsh-mnemon-provider-honcho": "0.5.4",
-    "dsh-mnemon-provider-mem0": "0.5.4",
-    "dsh-mnemon-provider-mnemon-native": "0.5.5",
-    "dsh-mnemon-provider-openviking": "0.5.6",
-    "dsh-mnemon-provider-retaindb": "0.5.4",
-    "dsh-mnemon-provider-supermemory": "0.5.4",
-    "dsh-mnemon-source-documents": "0.5.6",
-    "dsh-mnemon-source-memory-spaces": "0.5.10",
-    "dsh-mnemon-source-runtime": "0.5.9",
-    "dsh-mnemon-strategy-auto-capture": "0.5.4",
-    "dsh-mnemon-strategy-default-three-tier": "0.5.6",
-    "dsh-mnemon-strategy-light-context": "0.5.4",
-    "dsh-mnemon-strategy-scoped": "0.5.4",
+    "@deepseek-ai/cosmokit": "^1.8.5",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "dsh-mnemon-provider-byterover": "0.5.5",
+    "dsh-mnemon-provider-hindsight": "0.5.5",
+    "dsh-mnemon-provider-holographic": "0.5.5",
+    "dsh-mnemon-provider-honcho": "0.5.5",
+    "dsh-mnemon-provider-mem0": "0.5.5",
+    "dsh-mnemon-provider-mnemon-native": "0.5.6",
+    "dsh-mnemon-provider-openviking": "0.5.7",
+    "dsh-mnemon-provider-retaindb": "0.5.5",
+    "dsh-mnemon-provider-supermemory": "0.5.5",
+    "dsh-mnemon-source-documents": "0.5.7",
+    "dsh-mnemon-source-memory-spaces": "0.5.11",
+    "dsh-mnemon-source-runtime": "0.5.10",
+    "dsh-mnemon-strategy-auto-capture": "0.5.5",
+    "dsh-mnemon-strategy-default-three-tier": "0.5.7",
+    "dsh-mnemon-strategy-general": "0.5.1",
+    "dsh-mnemon-strategy-light-context": "0.5.5",
+    "dsh-mnemon-strategy-scoped": "0.5.5",
     "fflate": "^0.8.3",
-    "schemastery": "^3.18.0",
-    "schemastery-live": "npm:@deepseek-ai/schemastery@^3.18.3",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1 || ^0.1.6-alpha.2 || ^0.1.7-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.1 || ^0.1.6-alpha.2 || ^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-rc.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@changesets/cli": "^2.31.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-agent-loop": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-api-gateway": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-tool": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-invariants": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session-format-v0-to-v1": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session-projection-legacy": "npm:@deepseek-ai/dsh-session-projection@0.1.0-rc.8",
-    "@deepseek-ai/dsh-session-query": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-subagent": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-typert-registry": "0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-invariants": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-format-v0-to-v1": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-query": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-subagent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-registry": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-util-code-language": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
     "@shikijs/langs": "^4.3.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",
@@ -216,7 +215,8 @@
     "@types/react-dom": "^18.3.0",
     "anser": "^2.3.5",
     "clsx": "^2.1.1",
-    "cosmokit-legacy": "npm:@deepseek-ai/cosmokit@1.8.3",
+    "diff": "^9.0.0",
+    "immer": "^10.1.1",
     "jsdom": "^26.1.0",
     "katex": "^0.16.47",
     "lightningcss": "^1.29.0",
@@ -236,9 +236,11 @@
     "react-dom": "^18.2.0",
     "semver": "^7.8.5",
     "shiki": "^4.3.1",
+    "simple-icons": "16.31.0",
     "tsdown": "^0.22.0",
     "typescript": "^5.9.0",
-    "vitest": "^3.2.0"
+    "vitest": "^3.2.0",
+    "zustand": "~4.4.7"
   },
   "bin": {
     "dsh-mnemon-repair-session": "bin/repair-legacy-session.mjs"

package/lib/contracts-D4ghDRK4.js

@@ -1,35 +0,0 @@
-//#region src/core/contracts/plugin.ts
-/** Declarative identity and graph relations shared by every Mnemon plugin. */
-const MEMORY_PLUGIN_API_VERSION = "dsh-mnemon/plugin/v1";
-//#endregion
-//#region src/core/contracts/view.ts
-const COMPOSABLE_MEMORY_API_VERSION = "dsh-mnemon/v1";
-const DEFAULT_MEMORY_VIEW_BUDGET = Object.freeze({
-	maxProjectionCharacters: 65536,
-	maxRoutes: 16,
-	maxActions: 16,
-	maxEvidenceResults: 16,
-	maxEvidenceCharacters: 16384
-});
-//#endregion
-//#region src/core/contracts/index.ts
-const MEMORY_CAPABILITIES = [
-	"status",
-	"project",
-	"recall",
-	"search",
-	"read",
-	"browse",
-	"write",
-	"archive",
-	"graph",
-	"related",
-	"link",
-	"forget",
-	"maintain",
-	"export",
-	"import"
-];
-const MEMORY_SOURCE_MODES = ["eager", "routed"];
-//#endregion
-export { MEMORY_PLUGIN_API_VERSION as a, DEFAULT_MEMORY_VIEW_BUDGET as i, MEMORY_SOURCE_MODES as n, COMPOSABLE_MEMORY_API_VERSION as r, MEMORY_CAPABILITIES as t };