dsh-mnemon 0.5.33 → 0.5.35

package/lib/{starter-resolution-DoFp9FLr.js → starter-resolution-BAHgCK5h.js}

@@ -6,19 +6,20 @@ var dependencies = {
 	"@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.6",
-	"dsh-mnemon-provider-holographic": "0.5.6",
+	"dsh-mnemon-provider-hindsight": "0.5.7",
+	"dsh-mnemon-provider-holographic": "0.5.7",
 	"dsh-mnemon-provider-honcho": "0.5.5",
 	"dsh-mnemon-provider-mem0": "0.5.5",
-	"dsh-mnemon-provider-mnemon-native": "0.5.9",
-	"dsh-mnemon-provider-openviking": "0.5.8",
+	"dsh-mnemon-provider-mnemon-native": "0.5.10",
+	"dsh-mnemon-provider-openviking": "0.5.9",
 	"dsh-mnemon-provider-retaindb": "0.5.6",
 	"dsh-mnemon-provider-supermemory": "0.5.5",
 	"dsh-mnemon-source-documents": "0.5.11",
-	"dsh-mnemon-source-memory-spaces": "0.5.22",
-	"dsh-mnemon-source-runtime": "0.5.15",
+	"dsh-mnemon-source-memory-spaces": "0.5.23",
+	"dsh-mnemon-source-runtime": "0.5.16",
+	"dsh-mnemon-source-skills": "0.5.2",
 	"dsh-mnemon-strategy-auto-capture": "0.5.5",
-	"dsh-mnemon-strategy-default-three-tier": "0.5.10",
+	"dsh-mnemon-strategy-default-three-tier": "0.5.11",
 	"dsh-mnemon-strategy-general": "0.5.1",
 	"dsh-mnemon-strategy-light-context": "0.5.6",
 	"dsh-mnemon-strategy-scoped": "0.5.5",

package/lib/starter.js

@@ -1,4 +1,4 @@
-import { t as prepareStarterResolution } from "./starter-resolution-DoFp9FLr.js";
+import { t as prepareStarterResolution } from "./starter-resolution-BAHgCK5h.js";
 //#region src/starter.ts
 const name = "dsh-mnemon-starter";
 const provide = ["mnemonStarterReady"];

package/lib/{strategy-configuration-CLHxaPOb.js → strategy-configuration-CKP2kRss.js}

@@ -1,6 +1,7 @@
 import { n as deepFreeze, t as canonicalMemoryJson } from "./definitions-DU7MLBhu.js";
-import { resolve } from "node:path";
+import { dirname, isAbsolute, join, resolve } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
+import { realpathSync, statSync } from "node:fs";
 //#region src/sdk/storage-lock.ts
 const queues = /* @__PURE__ */ new Map();
 /**
@@ -19,6 +20,37 @@ function withMemoryStorageLock(directory, operation) {
 	return result;
 }
 //#endregion
+//#region src/sdk/workspace-storage.ts
+/** Local workspace identity, including aliases with not-yet-created descendants. */
+function canonicalWorkspacePath(workspacePath) {
+	if (!isAbsolute(workspacePath) || workspacePath.includes("\0")) throw new Error("Workspace path must be absolute");
+	let parent = resolve(workspacePath);
+	const suffix = [];
+	for (;;) {
+		let real;
+		try {
+			real = realpathSync.native(parent);
+		} catch (error) {
+			if (error.code !== "ENOENT") throw error;
+			const next = dirname(parent);
+			if (next === parent) throw error;
+			suffix.unshift(parent.slice(next.length).replace(/^[/\\]+/u, ""));
+			parent = next;
+			continue;
+		}
+		if (suffix.length > 0 && !statSync(real).isDirectory()) throw Object.assign(/* @__PURE__ */ new Error(`ENOTDIR: not a directory, realpath '${parent}'`), {
+			code: "ENOTDIR",
+			path: parent,
+			syscall: "realpath"
+		});
+		return join(real, ...suffix);
+	}
+}
+/** A rename or move selects a new directory; resolving identity never writes. */
+function workspaceStorageId(workspacePath) {
+	return createHash("sha256").update(canonicalWorkspacePath(workspacePath)).digest("hex");
+}
+//#endregion
 //#region src/sdk/input.ts
 /** Stable digest of validated configuration; raw values never enter diagnostics. */
 function memoryConfigurationDigest(value) {
@@ -156,4 +188,4 @@ function memoryStrategyConfigurationValues(definition, input) {
 	return config;
 }
 //#endregion
-export { memoryConfigurationDigest as a, record as c, truncate as d, withMemoryStorageLock as f, integer as i, stringArray as l, memoryStrategyConfigurationValues as n, migrationLineage as o, readMemoryStrategyConfiguration as r, receipt as s, defineMemoryStrategyConfiguration as t, text as u };
+export { memoryConfigurationDigest as a, record as c, truncate as d, canonicalWorkspacePath as f, integer as i, stringArray as l, withMemoryStorageLock as m, memoryStrategyConfigurationValues as n, migrationLineage as o, workspaceStorageId as p, readMemoryStrategyConfiguration as r, receipt as s, defineMemoryStrategyConfiguration as t, text as u };

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

@@ -382,6 +382,7 @@ export declare const zh: {
     'board.composing': string;
     'board.lastSource': string;
     'board.enabledCount': string;
+    'board.experimental': string;
     'board.search': string;
     'board.searchEmpty': string;
     'details.open': string;
@@ -614,6 +615,7 @@ export declare const zh: {
     'config.syncNow': string;
     'config.syncNowRunning': string;
     'config.syncDone': string;
+    'config.runtimeMergeArchived': string;
     'config.syncDoneMerged': string;
     'config.syncUpToDate': string;
     'config.syncUpToDateMerged': string;
@@ -753,6 +755,34 @@ export declare const zh: {
     'review.historyHint': string;
     'review.historyEmpty': string;
     'review.rejectedHint': string;
+    'skills.label': string;
+    'skills.evolution': string;
+    'skills.evolutionHint': string;
+    'skills.autoBacktest': string;
+    'skills.autoBacktestHint': string;
+    'skills.parameters': string;
+    'skills.reviewThreshold': string;
+    'skills.idleSeconds': string;
+    'skills.cooldownSeconds': string;
+    'skills.minConfidence': string;
+    'skills.expiryDays': string;
+    'skills.maxPendingPerSession': string;
+    'skills.casesPerRun': string;
+    'skills.invalid': string;
+    'skills.hints': string;
+    'skills.hintsHint': string;
+    'skills.sidebar': string;
+    'skills.sidebarHint': string;
+    'skills.statusCount': string;
+    'skills.statusOn': string;
+    'skills.statusIdle': string;
+    'skills.statusOff': string;
+    'skillTail.label': string;
+    'skillTail.reviewing': string;
+    'skillTail.suggested': string;
+    'skillTail.failed': string;
+    'skillTail.openSkill': string;
+    'skillTail.openSuggestions': string;
     "term.space": string;
     "term.spaces": string;
     "category.decision": string;

package/lib/types/src/client/source-contracts.d.ts

@@ -46,10 +46,26 @@ export interface MemorySourcePageProps {
      * `topInset` below the top when the Source pins and measures its own header.
      */
     onRevealElement?(element: HTMLElement, topInset?: number): void;
+    /**
+     * Leave the Memory System for the conversation it was opened from, as the
+     * header's back button does. Absent where the page is already beside the
+     * conversation, such as the conversation tab.
+     */
+    onReturnToConversation?(): void;
     /** Optional, Source-bound product preferences; no raw settings service or secrets. */
     preferences?: {
         value: MemoryJsonValue;
         writable: boolean;
         replace(value: MemoryJsonValue): Promise<void>;
     };
+    /**
+     * Open this Source component's own settings, on its page under Plugins.
+     * Present while that page offers navigation.
+     */
+    onOpenSettings?(): void;
+    /**
+     * The page is the whole view, as in a sidebar entry of its own: the view's
+     * header already carries its title.
+     */
+    standalone?: boolean;
 }

package/lib/types/src/host/config-values.d.ts

@@ -12,4 +12,5 @@ export declare const DEFAULT_RECALL_LOW_SCORE_THRESHOLD: number;
 export declare const DEFAULT_RECALL_HIGH_SCORE_THRESHOLD: number;
 export declare const DEFAULT_RECALL_CANDIDATE_MULTIPLIER: number;
 export declare const DEFAULT_RECALL_MAX_MEDIUM_RESULTS: number;
+export declare const DEFAULT_RECALL_MAX_RANKED_RESULTS: number;
 export declare const DEFAULT_RECALL_MAX_UNKNOWN_RESULTS: number;

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

@@ -1,13 +1,16 @@
 import z from '@deepseek-ai/schemastery';
 export { resolveEmbedding, resolvePersistenceStrategy, resolveRecallQuality } from 'dsh-mnemon-source-memory-spaces';
-import type { Config as SharedConfig, CustomPackConfig as SharedCustomPackConfig, InteractionConfig as SharedInteractionConfig, ResolvedConfig as SharedResolvedConfig, ResolvedInteractionConfig as SharedResolvedInteractionConfig } from "./protocol.ts";
-export { DEFAULT_IDLE_REVIEW_MS, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, DEFAULT_RECALL_CANDIDATE_MULTIPLIER, DEFAULT_RECALL_HIGH_SCORE_THRESHOLD, DEFAULT_RECALL_LIMIT, DEFAULT_RECALL_LOW_SCORE_THRESHOLD, DEFAULT_RECALL_MAX_MEDIUM_RESULTS, DEFAULT_RECALL_MAX_UNKNOWN_RESULTS, DEFAULT_RECALL_QUALITY_POLICY, DEFAULT_RUNTIME_MAINTENANCE_MAX_TOKENS, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES, DEFAULT_RUNTIME_USER_LIMIT_BYTES, DEFAULT_TIMEOUT_MS, MAX_RUNTIME_MAINTENANCE_MAX_TOKENS, MAX_RUNTIME_MEMORY_LIMIT_BYTES, } from './config-values.ts';
+import type { Config as SharedConfig, CustomPackConfig as SharedCustomPackConfig, InteractionConfig as SharedInteractionConfig, ResolvedConfig as SharedResolvedConfig, ResolvedInteractionConfig as SharedResolvedInteractionConfig, ResolvedSkillsConfig } from "./protocol.ts";
+export { DEFAULT_IDLE_REVIEW_MS, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, DEFAULT_RECALL_CANDIDATE_MULTIPLIER, DEFAULT_RECALL_HIGH_SCORE_THRESHOLD, DEFAULT_RECALL_LIMIT, DEFAULT_RECALL_LOW_SCORE_THRESHOLD, DEFAULT_RECALL_MAX_MEDIUM_RESULTS, DEFAULT_RECALL_MAX_RANKED_RESULTS, DEFAULT_RECALL_MAX_UNKNOWN_RESULTS, DEFAULT_RECALL_QUALITY_POLICY, DEFAULT_RUNTIME_MAINTENANCE_MAX_TOKENS, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES, DEFAULT_RUNTIME_USER_LIMIT_BYTES, DEFAULT_TIMEOUT_MS, MAX_RUNTIME_MAINTENANCE_MAX_TOKENS, MAX_RUNTIME_MEMORY_LIMIT_BYTES, } from './config-values.ts';
 export type Config = SharedConfig;
 export type CustomPackConfig = SharedCustomPackConfig;
 export type InteractionConfig = SharedInteractionConfig;
 export type ResolvedConfig = SharedResolvedConfig;
 export type ResolvedInteractionConfig = SharedResolvedInteractionConfig;
 export declare const InteractionConfig: z<InteractionConfig>;
+/** 技能管理's settings, with the ranges its page accepts. */
+export declare const SkillsConfig: z<Partial<ResolvedSkillsConfig>, ResolvedSkillsConfig>;
+export declare function resolveSkillsConfig(config?: Partial<ResolvedSkillsConfig> | undefined): ResolvedSkillsConfig;
 export declare const Config: z<Config>;
 export declare function resolveInteractionConfig(config?: InteractionConfig): ResolvedInteractionConfig;
 export declare function resolveConfig(config?: Config): ResolvedConfig;

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

@@ -68,6 +68,8 @@ export declare const MNEMON_REMOTE_VIEW_WRITE_ENDPOINT = "dshMnemon/viewWrite";
 export declare const MNEMON_REMOTE_REVIEW_ENDPOINT = "dshMnemon/review";
 export declare const MNEMON_SETTINGS_NAMESPACE = "mnemon";
 export declare const MNEMON_UI_SETTINGS_NAMESPACE = "mnemon-ui";
+/** 技能管理's settings: one live group of the dsh-mnemon entry, drawn on that component's page. */
+export declare const MNEMON_SKILLS_SETTINGS_NAMESPACE = "mnemon-skills";
 export * from './view-protocol.ts';
 export * from './memory-tools.ts';
 export * from './sync-rules.ts';
@@ -77,7 +79,7 @@ export * from './sync-rules.ts';
  * exactly these names.
  */
 export declare const MNEMON_RPC_ENDPOINTS: {
-    readonly "/dsh-mnemon-read": readonly ["status", "status-summary", "memory-system", "versions", "task-agent-models", "runtime-memory", "documents", "document", "document-search", "graph", "bodies", "body-directory", "body-reconnect", "provider-services", "embedding-status", "list", "entities", "search", "agent-search", "related", "turn-activities", "turn-activity", "assistant-message", "source-management-catalog", "source-management-read", "source-assistance"];
+    readonly "/dsh-mnemon-read": readonly ["status", "status-summary", "memory-system", "versions", "task-agent-models", "runtime-memory", "documents", "document", "document-search", "graph", "bodies", "body-directory", "body-reconnect", "provider-services", "embedding-status", "list", "entities", "search", "agent-search", "related", "turn-activities", "turn-activity", "skill-activity", "assistant-message", "source-management-catalog", "source-management-read", "source-assistance"];
     readonly "/dsh-mnemon-activation": readonly ["body", "source-assistance"];
     readonly "/dsh-mnemon-write": readonly ["runtime-memory", "document", "supervise", "remember", "link", "forget", "body-create", "body-update", "body-delete", "body-merge", "body-metadata-maintain", "provider-service-update", "embedding-fill", "source-management-mutate", "source-assistance", "version-update"];
     readonly "/dsh-mnemon-pack": readonly ["target", "export", "inspect", "import"];
@@ -291,6 +293,8 @@ export interface Config {
         turnBar?: boolean;
         saveAction?: boolean;
     };
+    /** 技能管理: skill evolution and where the page shows. */
+    skills?: SkillsConfig;
     /** Provider policy used when an Agent must create a new Memory Space while distilling memory. */
     persistenceStrategy?: MemoryPersistenceStrategy;
     /** Model route used by clean, session-independent maintenance Agents. */
@@ -409,6 +413,69 @@ export interface ResolvedInteractionConfig {
     turnBar: boolean;
     saveAction: boolean;
 }
+/** 技能管理's settings, as stored; every key is optional and falls back to its default. */
+export type SkillsConfig = Partial<ResolvedSkillsConfig>;
+export interface ResolvedSkillsConfig {
+    /** Review finished conversations in the background and suggest new or better skills. */
+    evolution: boolean;
+    /** Backtest a draft against the current version as soon as it is written. */
+    autoBacktest: boolean;
+    /** The one-line skills bar under a finished turn. */
+    hints: boolean;
+    /** 技能管理 as a sidebar entry of its own instead of a Memory System page. */
+    sidebar: boolean;
+    /** The post-turn score a conversation's window needs before it is reviewed. */
+    reviewThreshold: number;
+    /** How long a conversation sits idle before its review runs. */
+    idleSeconds: number;
+    /** The least time between two reviews of one conversation. */
+    cooldownSeconds: number;
+    /** Suggestions below this confidence are dropped. */
+    minConfidence: number;
+    /** A pending suggestion expires after this many days. */
+    expiryDays: number;
+    /** At most this many pending suggestions from one conversation. */
+    maxPendingPerSession: number;
+    /** At most this many cases in one backtest. */
+    casesPerRun: number;
+}
+export declare const DEFAULT_SKILLS_CONFIG: Readonly<ResolvedSkillsConfig>;
+/** One skill a turn used: the model loaded it, or the user asked for it with `/name`. */
+export interface TurnSkillUse {
+    name: string;
+    by: 'model' | 'user';
+}
+/** A skill review of a conversation, placed under the turn its window ended with. */
+export interface TurnSkillReview {
+    turn: number;
+    /** `scheduled` waits for the conversation to sit idle; the others say how it went. */
+    state: 'scheduled' | 'reviewing' | 'suggested' | 'nothing' | 'error';
+    /** The suggestions it left that still exist, newest first. */
+    suggestions: Array<{
+        id: string;
+        skillName: string;
+        action: 'create' | 'update';
+        status: string;
+    }>;
+    error?: string;
+}
+/** What one conversation did with skills: each turn's uses and each review, for the turn bars. */
+export interface SkillActivitySnapshot {
+    /** Whether a skills bar has anything to read: the Skills Source runs for this conversation. */
+    available: boolean;
+    turns: Array<{
+        turn: number;
+        skills: TurnSkillUse[];
+    }>;
+    reviews: TurnSkillReview[];
+}
+/** What the Status page says about 技能管理. */
+export interface SkillsStatusSummary {
+    evolution: boolean;
+    skills: number;
+    /** Suggestions and drafts waiting for the user. */
+    waiting: number;
+}
 /**
  * Provider instance identity inside one Memory Spaces Source. Built-in ids
  * remain stable; third-party child modules may contribute additional ids.
@@ -512,9 +579,11 @@ export interface SubagentCounters {
     documentArchives: number;
     metadataMaintenances: number;
     reconciliations: number;
+    /** Skill reviews, drafts, backtest runs and case derivations. */
+    skills?: number;
     failures: number;
     lastRunId?: string;
-    lastOperation?: 'recall' | 'write' | 'review' | 'placement' | 'migration' | 'compaction' | 'document-archive' | 'metadata-maintenance' | 'reconcile';
+    lastOperation?: 'recall' | 'write' | 'review' | 'placement' | 'migration' | 'compaction' | 'document-archive' | 'metadata-maintenance' | 'reconcile' | 'skill';
     lastAt?: string;
 }
 /** What a delegated memory write did, as the write task Agent's receipts show it. */
@@ -652,6 +721,8 @@ export interface StatusView {
     memorySystem?: MemoryCompositionStatus;
     lifecycle?: LifecycleSnapshot;
     documents?: DocumentSnapshot;
+    /** 技能管理, when its Source runs for this scope. */
+    skills?: SkillsStatusSummary;
     storage?: StorageScopeCatalog;
     workspaceContext?: {
         mode: StorageScopeKind;
@@ -725,10 +796,12 @@ export interface MnemonPackPreview {
  * leaves an entry out because a tombstone still hides it has to say how many.
  */
 export interface MnemonRuntimeMergeReport {
-    /** Incoming entries this merge wrote into the data directory. */
+    /** Incoming entries this merge admitted to hot runtime memory. */
     added: number;
     /** Incoming entries a tombstone still hides, so the merge left them out. */
     held: number;
+    /** Exact MEMORY records newly saved in the local import-overflow archive. */
+    archived?: number;
 }
 export interface MnemonPackImportResult {
     imported: true;

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

@@ -7,4 +7,5 @@ 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 { canonicalWorkspacePath, workspaceStorageId } from './workspace-storage.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/workspace-storage.d.ts

@@ -0,0 +1,4 @@
+/** Local workspace identity, including aliases with not-yet-created descendants. */
+export declare function canonicalWorkspacePath(workspacePath: string): string;
+/** A rename or move selects a new directory; resolving identity never writes. */
+export declare function workspaceStorageId(workspacePath: string): string;

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "可组合记忆 (dsh-mnemon)",
-    "description": "面向 DeepSeek Harness 的可组合视图记忆。记忆来源与策略可插拔，开箱即用提供分层记忆。"
+    "description": "面向 DeepSeek Harness 的可组合视图上下文。来源与策略可插拔，开箱即用提供分层记忆与自进化技能。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.5.33",
-  "description": "Composable, view-based memory for DeepSeek Harness. Pluggable sources and strategies, with layered memory out of the box.",
+  "version": "0.5.35",
+  "description": "Composable, view-based context for DeepSeek Harness. Pluggable sources and strategies, with layered memory and self-evolving skills out of the box.",
   "keywords": [
     "deepseek-harness",
     "deepseek-harness-plugin",
@@ -156,19 +156,20 @@
     "@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.6",
-    "dsh-mnemon-provider-holographic": "0.5.6",
+    "dsh-mnemon-provider-hindsight": "0.5.7",
+    "dsh-mnemon-provider-holographic": "0.5.7",
     "dsh-mnemon-provider-honcho": "0.5.5",
     "dsh-mnemon-provider-mem0": "0.5.5",
-    "dsh-mnemon-provider-mnemon-native": "0.5.9",
-    "dsh-mnemon-provider-openviking": "0.5.8",
+    "dsh-mnemon-provider-mnemon-native": "0.5.10",
+    "dsh-mnemon-provider-openviking": "0.5.9",
     "dsh-mnemon-provider-retaindb": "0.5.6",
     "dsh-mnemon-provider-supermemory": "0.5.5",
     "dsh-mnemon-source-documents": "0.5.11",
-    "dsh-mnemon-source-memory-spaces": "0.5.22",
-    "dsh-mnemon-source-runtime": "0.5.15",
+    "dsh-mnemon-source-memory-spaces": "0.5.23",
+    "dsh-mnemon-source-runtime": "0.5.16",
+    "dsh-mnemon-source-skills": "0.5.2",
     "dsh-mnemon-strategy-auto-capture": "0.5.5",
-    "dsh-mnemon-strategy-default-three-tier": "0.5.10",
+    "dsh-mnemon-strategy-default-three-tier": "0.5.11",
     "dsh-mnemon-strategy-general": "0.5.1",
     "dsh-mnemon-strategy-light-context": "0.5.6",
     "dsh-mnemon-strategy-scoped": "0.5.5",