dsh-mnemon 0.1.5 → 0.2.0

package/lib/types/service.d.ts

@@ -2,153 +2,18 @@ import type { JsonValue } from './contracts.ts';
 import type { ResolvedConfig } from './config.ts';
 import { MemoryBodyRegistry, type CreateMemoryBodyRequest, type MemoryBody, type UpdateMemoryBodyRequest } from './memory-bodies.ts';
 import type { MnemonRunner } from './runner.ts';
-import type { LifecycleSnapshot } from './lifecycle.ts';
-import type { DocumentSnapshot } from './documents.ts';
-import type { StorageScopeCatalog } from './storage-scope.ts';
-export declare const CATEGORIES: readonly ["preference", "decision", "fact", "insight", "context", "general"];
-export type Category = typeof CATEGORIES[number];
-export declare const SOURCES: readonly ["user", "agent", "external"];
-export type Source = typeof SOURCES[number];
-export declare const EDGE_TYPES: readonly ["temporal", "semantic", "causal", "entity"];
-export type EdgeType = typeof EDGE_TYPES[number];
-export declare const INTENTS: readonly ["WHY", "WHEN", "ENTITY", "GENERAL"];
-export type Intent = typeof INTENTS[number];
-export interface Insight {
-    id: string;
-    content: string;
-    category?: string;
-    importance?: number;
-    tags?: string[];
-    entities?: string[];
-    source?: string;
-    score?: number;
-    confidence?: string;
-    intent?: string;
-    matchedVia?: string;
-    createdAt?: string;
-    depth?: number;
-    edgeType?: string;
-    memoryBodyId?: string;
-    memoryBodyName?: string;
-}
-export interface SearchRequest {
-    query: string;
-    mode?: 'smart' | 'keyword' | 'basic';
-    limit?: number;
-    category?: Category;
-    source?: Source;
-    intent?: Intent;
-    memoryBodyIds?: string[];
-}
-export interface RememberRequest {
-    content: string;
-    category?: Category;
-    importance?: number;
-    tags?: string[];
-    entities?: string[];
-    source?: Source;
-    memoryBodyId?: string;
-}
-export interface MemoryBodyStats {
-    totalInsights: number;
-    deletedInsights: number;
-    edgeCount: number;
-    oplogCount: number;
-    dbSizeBytes: number;
-    byCategory: Record<string, number>;
-    topEntities: Array<{
-        entity: string;
-        count: number;
-    }>;
-}
-export interface MemoryBodyView extends MemoryBody {
-    healthy: boolean;
-    error?: string;
-    stats?: MemoryBodyStats;
-}
-export interface MemoryBodyCatalog {
-    items: MemoryBodyView[];
-    total: number;
-    activeCount: number;
-    directory: string;
-    generatedAt: string;
-}
-export interface StatusView {
-    healthy: boolean;
-    error?: string;
-    version?: string;
-    dshMnemonVersion?: string;
-    cliPath: string;
-    commandFound: boolean;
-    dataDir: string;
-    store: string;
-    writeEnabled: boolean;
-    timeoutMs: number;
-    defaultRecallLimit: number;
-    memoryBodyDirectory: string;
-    memoryBodies: MemoryBodyView[];
-    lifecycle?: LifecycleSnapshot;
-    documents?: DocumentSnapshot;
-    storage?: StorageScopeCatalog;
-    workspaceContext?: {
-        mode: 'global' | 'workspace' | 'custom';
-        selectedRoot: string;
-        effectiveRoot: string;
-        aligned: boolean;
-        selectedWorkspace?: {
-            id: string;
-            title: string;
-            path: string;
-        };
-        effectiveWorkspace?: {
-            id: string;
-            title: string;
-            path: string;
-        };
-    };
-    stats?: MemoryBodyStats & {
-        dbPath?: string;
-    };
-}
-export interface MemoryGraphNode extends Insight {
-    color: string;
-    graphId?: string;
-    kind?: 'memory' | 'entity' | 'space';
-    memoryBodyIds?: string[];
-    memoryBodyNames?: string[];
-    occurrenceCount?: number;
-}
-export interface MemoryGraphEdge {
-    sourceId: string;
-    targetId: string;
-    label: string;
-    color: string;
-    type?: EdgeType | 'scope';
-}
-export interface MemoryGraphSnapshot {
-    nodes: MemoryGraphNode[];
-    edges: MemoryGraphEdge[];
-    generatedAt: string;
-    memoryBodies?: Array<Pick<MemoryBody, 'id' | 'name' | 'active'>>;
-}
-export interface MemoryListRequest {
-    query?: string;
-    category?: Category;
-    limit?: number;
-    memoryBodyIds?: string[];
-}
-export interface MemoryListView {
-    items: MemoryGraphNode[];
-    total: number;
-    generatedAt: string;
-}
-export interface EntityView {
-    items: Array<{
-        entity: string;
-        count: number;
-    }>;
-    insights: Insight[];
-    selected?: string;
+import { type LlmMemoryPlacementSelection, type PreparedMemoryPlacement } from './provider-placement.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';
+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, RememberRequest, SearchRequest, Source, StatusView, } from './shared/contracts.ts';
+export interface MemoryBodyMetadataSample {
+    memoryBodyId: string;
+    name: string;
+    description: string;
+    providerId: MemoryBody['provider']['id'];
+    providerLabel: string;
+    method: 'native-basic' | 'browse' | 'search';
+    evidence: Array<Pick<Insight, 'content' | 'category' | 'entities'>>;
 }
 /** Parse the official Mnemon vis.js export without executing its HTML or loading its CDN script. */
 export declare function parseMemoryGraph(html: string, now?: Date): MemoryGraphSnapshot;
@@ -156,15 +21,31 @@ export declare class MnemonService {
     readonly runner: MnemonRunner;
     readonly config: ResolvedConfig;
     readonly memoryBodies: MemoryBodyRegistry;
+    private readonly providers;
+    private bodiesInFlight;
     constructor(runner: MnemonRunner, config: ResolvedConfig, memoryBodies?: MemoryBodyRegistry);
     bodies(signal?: AbortSignal): Promise<MemoryBodyCatalog>;
+    /** Coalesce simultaneous Status/Memory-page probes without caching mutations. */
+    private collectBodies;
+    /** Return the control-plane directory without waiting for provider I/O. */
+    bodyDirectory(): MemoryBodyCatalog;
+    /** Return a usable system snapshot without waiting for any Provider I/O. */
+    statusSummary(): StatusView;
     status(signal?: AbortSignal): Promise<StatusView>;
+    reconnectBody(id: string, signal?: AbortSignal): Promise<MemoryBodyView>;
     search(request: SearchRequest, signal?: AbortSignal): Promise<{
         query: string;
         mode: string;
         results: Insight[];
         hint?: string;
+        sources: MemoryReadSource[];
     }>;
+    /**
+     * Read a deliberately small metadata sample through the cheapest useful path
+     * exposed by the owning Provider. This avoids federated ranking, graph
+     * expansion, and large browse projections before an LLM metadata pass.
+     */
+    metadataSample(memoryBodyId: string, signal?: AbortSignal): Promise<MemoryBodyMetadataSample>;
     graph(signal?: AbortSignal, memoryBodyIds?: string[]): Promise<MemoryGraphSnapshot>;
     list(request?: MemoryListRequest, signal?: AbortSignal): Promise<MemoryListView>;
     entities(entity?: string, limit?: number, signal?: AbortSignal): Promise<EntityView>;
@@ -172,14 +53,36 @@ export declare class MnemonService {
     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>;
-    createBody(request: CreateMemoryBodyRequest, signal?: AbortSignal): Promise<MemoryBody>;
+    prepareBodyPlacement(request: CreateMemoryBodyRequest): PreparedMemoryPlacement;
+    createBody(request: CreateMemoryBodyRequest, signal?: AbortSignal, placement?: MemoryPlacementDecision): Promise<MemoryBody>;
+    /**
+     * Create a Memory Space from the configured distillation policy. The model
+     * may choose only among candidates already filtered by the host; manual mode
+     * ignores model preference and always uses the configured fixed provider.
+     */
+    createBodyForPersistence(body: {
+        name: string;
+        description: string;
+    }, selection: LlmMemoryPlacementSelection | undefined, signal?: AbortSignal, delegation?: {
+        runId: string;
+        provider: string;
+    }): Promise<MemoryBody>;
+    updateProviderService(providerId: MemoryBody['provider']['id'], settings: Record<string, string | number | boolean>, clearSecrets?: readonly string[], enabled?: boolean, signal?: AbortSignal): Promise<import("./shared/contracts.ts").MemoryProviderServiceView>;
     updateBody(id: string, request: UpdateMemoryBodyRequest): MemoryBody;
+    updateBodyMetadata(updates: readonly MemoryBodyMetadataUpdate[]): MemoryBody[];
     deleteBody(id: string, signal?: AbortSignal): Promise<MemoryBody>;
     mergeBodies(targetBodyId: string, sourceBodyIds: string[], deactivateSources?: boolean, signal?: AbortSignal): Promise<JsonValue>;
-    private bodyStatus;
+    private nativeBodyStatus;
     private parseStats;
-    private graphForBody;
-    private allInsights;
+    private nativeGraph;
+    private allNativeInsights;
+    private nativeMetadataSample;
+    private nativeSearch;
+    private nativeRemember;
+    private nativeRelated;
+    private nativeLink;
+    private nativeForget;
+    private providerFor;
     private readBodies;
     private readBody;
     private writeBody;
@@ -188,4 +91,3 @@ export declare class MnemonService {
     private activateAfterWrite;
     private assertWritable;
 }
-//# sourceMappingURL=service.d.ts.map

package/lib/types/settings.d.ts

@@ -1,7 +1,4 @@
 import type { HostConnectionHandle, HostRpcHandler, HostSettingsService } from './contracts.ts';
-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 { MNEMON_SETTINGS_CHANNEL, MNEMON_SETTINGS_NAMESPACE, MNEMON_UI_SETTINGS_NAMESPACE } from './shared/contracts.ts';
 export declare function createSettingsHandler(settings: HostSettingsService): HostRpcHandler;
 export declare function registerSettingsRpc(connection: HostConnectionHandle, settings: HostSettingsService): void;
-//# sourceMappingURL=settings.d.ts.map