dsh-mnemon 0.3.0 → 0.3.2

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

@@ -1,5 +1,5 @@
 import { type JSX } from 'react';
-import type { ClientConnectionHandle, ClientSettingsScope, Config, InteractionConfig } from '../shared/contracts.ts';
+import { type ClientConnectionHandle, type ClientSettingsScope, type Config, type InteractionConfig } from '../shared/contracts.ts';
 import { type MnemonTranslate } from './locales.ts';
 export interface MnemonSettingsCardProps {
     scope: ClientSettingsScope<Config>;

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

@@ -1,4 +1,4 @@
-import { type AssistantMessageText, type CreateMemoryBodyRequest, type ClientConnectionHandle, type DocumentMutation, type DocumentMutationResult, type DocumentSearchResult, type DocumentSnapshot, type DocumentView, type EntityView, type Insight, type MemoryBody, type MemoryBodyView, type MemoryBodyMetadataMaintenanceResult, type MemoryBodyCatalog, type MemoryProviderServiceCatalog, type MemoryProviderServiceView, type MemoryGraphSnapshot, type MemoryListRequest, type MemoryListView, type MemorySystemDescriptor, type MemoryReadSource, type MnemonPackExport, type MnemonPackImportResult, type MnemonPackPreview, type RememberRequest, type RuntimeMemoryImportance, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type SearchRequest, type StatusView, type TaskAgentModelCatalog, type TurnMemoryActivity, type UpdateMemoryBodyRequest, type UpdateMemoryProviderServiceRequest, type VersionComponentId, type VersionStatus, type VersionUpdateResult } from '../shared/contracts.ts';
+import { type AssistantMessageText, type CreateMemoryBodyRequest, type ClientConnectionHandle, type DocumentMutation, type DocumentMutationResult, type DocumentSearchResult, type DocumentSnapshot, type DocumentView, type EntityView, type Insight, type MemoryBody, type MemoryBodyView, type MemoryBodyMetadataMaintenanceResult, type MemoryBodyCatalog, type MemoryProviderServiceCatalog, type MemoryProviderServiceView, type MemoryGraphSnapshot, type MemoryListRequest, type MemoryListView, type MemorySystemDescriptor, type MemoryReadSource, type MnemonPackExport, type MnemonPackImportResult, type MnemonPackPreview, type MnemonEmbeddingStatus, type RememberRequest, type RuntimeMemoryImportance, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type SearchRequest, type StatusView, type TaskAgentModelCatalog, type TurnMemoryActivity, type UpdateMemoryBodyRequest, type UpdateMemoryProviderServiceRequest, type VersionComponentId, type VersionStatus, type VersionUpdateResult } from '../shared/contracts.ts';
 export interface SearchResponse {
     query: string;
     mode: string;
@@ -24,6 +24,7 @@ export declare class MnemonClient {
     private scoped;
     status(): Promise<StatusView>;
     statusSummary(): Promise<StatusView>;
+    embeddingStatus(): Promise<MnemonEmbeddingStatus>;
     memorySystem(): Promise<MemorySystemDescriptor>;
     taskAgentModels(includeCatalog?: boolean): Promise<TaskAgentModelCatalog>;
     versions(): Promise<VersionStatus>;

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

@@ -485,7 +485,9 @@ export declare const zh: {
     'entities.action': string;
     'entities.top': string;
     'entities.frequency': string;
+    'entities.filterHint': string;
     'entities.emptyRail': string;
+    'entities.filterEmpty': string;
     'entities.loading': string;
     'entities.selectTitle': string;
     'entities.selectText': string;
@@ -729,6 +731,23 @@ export declare const zh: {
     'config.nativeGlobalLocationHint': string;
     'config.nativeGlobalLocationWorkspaceHint': string;
     'config.nativeDefaultLocation': string;
+    'config.embeddingTitle': string;
+    'config.embeddingDescription': string;
+    'config.embeddingManaged': string;
+    'config.embeddingManagedHint': string;
+    'config.embeddingEndpoint': string;
+    'config.embeddingModel': string;
+    'config.embeddingEndpointInvalid': string;
+    'config.embeddingModelInvalid': string;
+    'config.embeddingSecurity': string;
+    'config.embeddingTest': string;
+    'config.embeddingNotTested': string;
+    'config.embeddingTesting': string;
+    'config.embeddingSaveBeforeTest': string;
+    'config.embeddingTestUnavailable': string;
+    'config.embeddingStatusAvailable': string;
+    'config.embeddingStatusUnavailable': string;
+    'config.embeddingStatusFailed': string;
     'config.providerGlobalLocation': string;
     'config.providerGlobalLocationHint': string;
     'config.providerGlobalLocationWorkspaceHint': string;
@@ -1361,7 +1380,9 @@ export declare const en: {
     'entities.action': string;
     'entities.top': string;
     'entities.frequency': string;
+    'entities.filterHint': string;
     'entities.emptyRail': string;
+    'entities.filterEmpty': string;
     'entities.loading': string;
     'entities.selectTitle': string;
     'entities.selectText': string;
@@ -1605,6 +1626,23 @@ export declare const en: {
     'config.nativeGlobalLocationHint': string;
     'config.nativeGlobalLocationWorkspaceHint': string;
     'config.nativeDefaultLocation': string;
+    'config.embeddingTitle': string;
+    'config.embeddingDescription': string;
+    'config.embeddingManaged': string;
+    'config.embeddingManagedHint': string;
+    'config.embeddingEndpoint': string;
+    'config.embeddingModel': string;
+    'config.embeddingEndpointInvalid': string;
+    'config.embeddingModelInvalid': string;
+    'config.embeddingSecurity': string;
+    'config.embeddingTest': string;
+    'config.embeddingNotTested': string;
+    'config.embeddingTesting': string;
+    'config.embeddingSaveBeforeTest': string;
+    'config.embeddingTestUnavailable': string;
+    'config.embeddingStatusAvailable': string;
+    'config.embeddingStatusUnavailable': string;
+    'config.embeddingStatusFailed': string;
     'config.providerGlobalLocation': string;
     'config.providerGlobalLocationHint': string;
     'config.providerGlobalLocationWorkspaceHint': string;

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

@@ -7,3 +7,4 @@ export declare const DEFAULT_RECALL_HIGH_SCORE_THRESHOLD = 0.6;
 export declare const DEFAULT_RECALL_CANDIDATE_MULTIPLIER = 3;
 export declare const DEFAULT_RECALL_MAX_MEDIUM_RESULTS = 4;
 export declare const DEFAULT_RECALL_MAX_UNKNOWN_RESULTS = 2;
+export { DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL } from './shared/contracts.ts';

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

@@ -1,6 +1,6 @@
 import z from 'schemastery';
 import type { Config as SharedConfig, CustomPackConfig as SharedCustomPackConfig, InteractionConfig as SharedInteractionConfig, ResolvedConfig as SharedResolvedConfig, ResolvedInteractionConfig as SharedResolvedInteractionConfig } from './shared/contracts.ts';
-export { DEFAULT_IDLE_REVIEW_MS, 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_TIMEOUT_MS, } from './config-values.ts';
+export { DEFAULT_IDLE_REVIEW_MS, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, 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_TIMEOUT_MS, } from './config-values.ts';
 export type Config = SharedConfig;
 export type CustomPackConfig = SharedCustomPackConfig;
 export type InteractionConfig = SharedInteractionConfig;

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

@@ -1,12 +1,17 @@
 import type { HostAgent, HostContextShape } from './contracts.ts';
 import type { ResolvedConfig } from './config.ts';
-import type { RuntimeMemoryController } from './runtime-memory.ts';
+import { type RuntimeMemoryController } from './runtime-memory.ts';
 import type { MemoryWake } from '../packages/contracts/src/index.ts';
 export declare const GUIDANCE_SECTION_NAME = "mnemon:routing";
+export declare const RUNTIME_MEMORY_PROTOCOL_SECTION_NAME = "mnemon:runtime-memory-protocol";
 export declare const RUNTIME_MEMORY_CONTEXT_NAME = "mnemon:runtime-memory";
 export declare const ROUTING_GUIDANCE = "Use memory only when needed. Search Mnemon Documents for substantial project records. Call mnemon_recall for durable history or exact prior details; never infer a missing historical rule. Put only new user facts or explicit save/correction requests in mnemon_runtime_memory; never cache retrieved evidence. A write exists only after its receipt.";
-/** Replace the already-materialized Agent context with the Wake pinned during assembly. */
+/** Replace the already-materialized Agent protocol and context with the Wake pinned during assembly. */
 export declare function applyAgentMemoryViewWake<T extends {
+    sections: Array<{
+        name: string;
+        text: string;
+    }>;
     contexts: Array<{
         name: string;
         text: string;

package/lib/types/src/providers/provider.d.ts

@@ -38,6 +38,8 @@ export interface MemoryProviderAdapter {
     graph(body: MemoryBody, signal?: AbortSignal): Promise<MemoryGraphSnapshot>;
     list(body: MemoryBody, request: MemoryListRequest, signal?: AbortSignal): Promise<Insight[]>;
     remember(body: MemoryBody, request: RememberRequest, signal?: AbortSignal): Promise<JsonValue>;
+    /** Persist an ordered host-authorized batch and return one receipt per request. */
+    rememberMany?(body: MemoryBody, requests: readonly RememberRequest[], signal?: AbortSignal): Promise<JsonValue[]>;
     related?(body: MemoryBody, id: string, depth: number, edge?: EdgeType, signal?: AbortSignal): Promise<Insight[]>;
     link?(body: MemoryBody, sourceId: string, targetId: string, type: EdgeType, weight: number, reason?: string, signal?: AbortSignal): Promise<JsonValue>;
     forget?(body: MemoryBody, id: string, signal?: AbortSignal): Promise<JsonValue>;

package/lib/types/src/runtime-memory.d.ts

@@ -9,6 +9,7 @@ export declare const RUNTIME_MEMORY_LIMITS: {
     readonly memory: number;
     readonly user: number;
 };
+export declare const RUNTIME_MEMORY_PROTOCOL: string;
 export interface RuntimeMemoryContextProjection {
     revision: string;
     text: string;

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

@@ -6,9 +6,9 @@ import type { AuthorityCommitRecorder } from './memory-receipts.ts';
 import { type LlmMemoryPlacementSelection, type PreparedMemoryPlacement } from './provider-placement.ts';
 import { type MemoryProviderAdapterRegistry } from './providers/registry.ts';
 import { type RecallQualityPolicyRegistry } from './recall-quality/index.ts';
-import { type EdgeType, type EntityView, type Insight, type MemoryBodyCatalog, type MemoryBodyMetadataUpdate, type MemoryBodyView, type MemoryGraphSnapshot, type MemoryListRequest, type MemoryListView, type MemoryPlacementDecision, type MemoryReadSource, type RememberRequest, type SearchRequest, type StatusView } from './shared/contracts.ts';
+import { type EdgeType, type EntityView, type Insight, type MemoryBodyCatalog, type MemoryBodyMetadataUpdate, type MemoryBodyView, type MemoryGraphSnapshot, type MemoryListRequest, type MemoryListView, type MnemonEmbeddingStatus, type MemoryPlacementDecision, type MemoryReadSource, type RememberRequest, type SearchRequest, type StatusView } from './shared/contracts.ts';
 export { CATEGORIES, EDGE_TYPES, INTENTS, SOURCES } from './shared/contracts.ts';
-export type { Category, EdgeType, EntityView, Insight, Intent, MemoryBodyCatalog, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryReadSource, RecallQualityStats, RememberRequest, SearchRequest, Source, StatusView, } from './shared/contracts.ts';
+export type { Category, EdgeType, EntityView, Insight, Intent, MemoryBodyCatalog, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MnemonEmbeddingStatus, MemoryReadSource, RecallQualityStats, RememberRequest, SearchRequest, Source, StatusView, } from './shared/contracts.ts';
 export interface MemoryBodyMetadataSample {
     memoryBodyId: string;
     name: string;
@@ -40,6 +40,8 @@ export declare class MnemonService {
     memoryRevision(): string;
     /** Return a usable system snapshot without waiting for any Provider I/O. */
     statusSummary(): StatusView;
+    /** Probe the effective Mnemon embedding runtime and its default Store coverage. */
+    embeddingStatus(signal?: AbortSignal): Promise<MnemonEmbeddingStatus>;
     status(signal?: AbortSignal): Promise<StatusView>;
     reconnectBody(id: string, signal?: AbortSignal): Promise<MemoryBodyView>;
     search(request: SearchRequest, signal?: AbortSignal): Promise<{
@@ -59,6 +61,12 @@ export declare class MnemonService {
     list(request?: MemoryListRequest, signal?: AbortSignal): Promise<MemoryListView>;
     entities(entity?: string, limit?: number, signal?: AbortSignal): Promise<EntityView>;
     remember(request: RememberRequest, signal?: AbortSignal): Promise<JsonValue>;
+    /**
+     * Persist a host-authorized set of exact memories without involving a model
+     * in the data plane. Mnemon Native requests share one import per destination;
+     * other Providers retain their adapter-defined write semantics.
+     */
+    rememberMany(requests: readonly RememberRequest[], signal?: AbortSignal): Promise<JsonValue[]>;
     related(id: string, depth?: number, edge?: EdgeType, signal?: AbortSignal, memoryBodyId?: string): Promise<Insight[]>;
     link(sourceId: string, targetId: string, type?: EdgeType, weight?: number, reason?: string, signal?: AbortSignal, memoryBodyId?: string): Promise<JsonValue>;
     forget(id: string, signal?: AbortSignal, memoryBodyId?: string): Promise<JsonValue>;
@@ -88,6 +96,7 @@ export declare class MnemonService {
     private nativeMetadataSample;
     private nativeSearch;
     private nativeRemember;
+    private nativeRememberMany;
     private nativeRelated;
     private nativeLink;
     private nativeForget;
@@ -95,6 +104,7 @@ export declare class MnemonService {
     private readBodies;
     private readBody;
     private writeBody;
+    private prepareRemember;
     private annotate;
     private annotateResult;
     private activateAfterWrite;

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

@@ -8,6 +8,8 @@ export declare const MNEMON_PACK_CHANNEL = "/dsh-mnemon-pack";
 export declare const MNEMON_SETTINGS_CHANNEL = "/dsh-mnemon-settings";
 export declare const MNEMON_SETTINGS_NAMESPACE = "mnemon";
 export declare const MNEMON_UI_SETTINGS_NAMESPACE = "mnemon-ui";
+export declare const DEFAULT_EMBEDDING_ENDPOINT = "http://localhost:11434";
+export declare const DEFAULT_EMBEDDING_MODEL = "nomic-embed-text";
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -119,6 +121,8 @@ export interface Config {
     store?: string;
     timeoutMs?: number;
     defaultRecallLimit?: number;
+    /** Optional DSH-owned overrides injected into every Mnemon CLI process. */
+    embedding?: MnemonEmbeddingConfig;
     memoryTopology?: MemoryTopologyConfig;
     recallQuality?: RecallQualityConfig;
     routingGuidance?: boolean;
@@ -141,6 +145,17 @@ export interface Config {
     /** Model route used by clean, session-independent maintenance Agents. */
     taskAgentModel?: TaskAgentModelConfig;
 }
+export interface MnemonEmbeddingConfig {
+    /** When false or omitted, Mnemon keeps its inherited environment and built-in defaults. */
+    enabled?: boolean;
+    endpoint?: string;
+    model?: string;
+}
+export interface ResolvedMnemonEmbeddingConfig {
+    enabled: boolean;
+    endpoint: string;
+    model: string;
+}
 export interface TaskAgentModelConfig {
     mode?: 'inherit' | 'fixed';
     provider?: string;
@@ -192,6 +207,7 @@ export interface ResolvedConfig {
     store?: string;
     timeoutMs: number;
     defaultRecallLimit: number;
+    embedding: ResolvedMnemonEmbeddingConfig;
     memoryTopology: ResolvedMemoryTopologyConfig;
     recallQuality: ResolvedRecallQualityConfig;
     routingGuidance: boolean;
@@ -211,6 +227,13 @@ export interface ResolvedConfig {
     persistenceStrategy: ResolvedMemoryPersistenceStrategy;
     taskAgentModel: ResolvedTaskAgentModelConfig;
 }
+export interface MnemonEmbeddingStatus {
+    available: boolean;
+    model: string;
+    totalInsights: number;
+    embedded: number;
+    coverage: string;
+}
 export interface ResolvedInteractionConfig {
     turnBar: boolean;
     saveAction: boolean;

package/package.json

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