dsh-mnemon-source-memory-spaces 0.5.15 → 0.5.17

package/lib/provider-sdk.d.ts

@@ -1,5 +1,5 @@
 import { CATEGORIES, Category, EDGE_TYPES, EdgeType, INTENTS, Insight, Intent, JsonValue, MemoryBody, MemoryBodyProvider, MemoryBodyStats, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemorySpace, MemorySpaceProvider, MemorySpaceStats, OpenVikingBodyConnection, OpenVikingSpaceConnection, RememberRequest, SOURCES, SearchRequest, Source } from "./contracts.js";
-import { C as ProviderSpaceStatus, S as ProviderSearchResult, _ as MemorySpaceNativeRunner, a as MemorySpaceProviderHost, b as ProviderMemorySpace, c as MemorySpaceProviderRuntimeContext, d as defineMemorySpaceProviderDefinition, f as MemoryProviderAdapter, g as MemorySpaceNativeRunOptions, h as MemorySpaceAuthority, i as MemorySpaceProviderEntry, l as MemorySpaceProviderScoreSemantics, m as MemoryProviderScoreSemantics, n as MemorySpaceProviderDefinition, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, r as MemorySpaceProviderDisposer, s as MemorySpaceProviderModule, t as MEMORY_SPACE_PROVIDER_API_VERSION, u as defineMemorySpaceProvider, v as NORMALIZED_RELEVANCE_SCORE, x as ProviderScoreSemantics, y as ProviderBodyStatus } from "./definitions-DwiEZSE_.js";
+import { C as ProviderSearchResult, S as ProviderScoreSemantics, _ as MemorySpaceNativeRunner, a as MemorySpaceProviderHost, b as ProviderEntityIndex, c as MemorySpaceProviderRuntimeContext, d as defineMemorySpaceProviderDefinition, f as MemoryProviderAdapter, g as MemorySpaceNativeRunOptions, h as MemorySpaceAuthority, i as MemorySpaceProviderEntry, l as MemorySpaceProviderScoreSemantics, m as MemoryProviderScoreSemantics, n as MemorySpaceProviderDefinition, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, r as MemorySpaceProviderDisposer, s as MemorySpaceProviderModule, t as MEMORY_SPACE_PROVIDER_API_VERSION, u as defineMemorySpaceProvider, v as NORMALIZED_RELEVANCE_SCORE, w as ProviderSpaceStatus, x as ProviderMemorySpace, y as ProviderBodyStatus } from "./definitions-CtjNSwBS.js";
 //#region src/providers/http.d.ts
 interface HttpProviderOptions {
   label?: string;
@@ -60,4 +60,4 @@ declare const DEFAULT_MAX_OUTPUT_BYTES: number;
 /** Spawn without a shell, with bounded output and cooperative cancellation. */
 declare const runProcess: ProcessRunner;
 //#endregion
-export { CATEGORIES, type Category, DEFAULT_MAX_OUTPUT_BYTES, EDGE_TYPES, type EdgeType, HttpMemoryProvider, HttpProviderOptions, INTENTS, type Insight, type Intent, JsonRequestOptions, type JsonValue, MEMORY_SPACE_PROVIDER_API_VERSION, type MemoryBody, type MemoryBodyProvider, type MemoryBodyStats, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphSnapshot, type MemoryListRequest, MemoryProviderAdapter, MemoryProviderAdapterFactoryContext, type MemoryProviderCapabilities, type MemoryProviderConfigField, type MemoryProviderConfigOption, type MemoryProviderConnection, type MemoryProviderConnectionValue, type MemoryProviderDescriptor, type MemoryProviderIcon, type MemoryProviderId, MemoryProviderScoreSemantics, type MemorySpace, MemorySpaceAuthority, MemorySpaceNativeRunOptions, MemorySpaceNativeRunner, type MemorySpaceProvider, type MemorySpaceProviderDefinition, type MemorySpaceProviderDisposer, type MemorySpaceProviderEntry, type MemorySpaceProviderHost, type MemorySpaceProviderManifest, type MemorySpaceProviderModule, type MemorySpaceProviderRuntimeContext, type MemorySpaceProviderScoreSemantics, type MemorySpaceStats, NORMALIZED_RELEVANCE_SCORE, type OpenVikingBodyConnection, type OpenVikingSpaceConnection, ProcessError, ProcessFailureReason, ProcessOptions, ProcessResult, ProcessRunner, ProviderBodyStatus, ProviderMemorySpace, ProviderScoreSemantics, ProviderSearchResult, ProviderSpaceStatus, type RememberRequest, SOURCES, type SearchRequest, type Source, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString, runProcess };
+export { CATEGORIES, type Category, DEFAULT_MAX_OUTPUT_BYTES, EDGE_TYPES, type EdgeType, HttpMemoryProvider, HttpProviderOptions, INTENTS, type Insight, type Intent, JsonRequestOptions, type JsonValue, MEMORY_SPACE_PROVIDER_API_VERSION, type MemoryBody, type MemoryBodyProvider, type MemoryBodyStats, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphSnapshot, type MemoryListRequest, MemoryProviderAdapter, MemoryProviderAdapterFactoryContext, type MemoryProviderCapabilities, type MemoryProviderConfigField, type MemoryProviderConfigOption, type MemoryProviderConnection, type MemoryProviderConnectionValue, type MemoryProviderDescriptor, type MemoryProviderIcon, type MemoryProviderId, MemoryProviderScoreSemantics, type MemorySpace, MemorySpaceAuthority, MemorySpaceNativeRunOptions, MemorySpaceNativeRunner, type MemorySpaceProvider, type MemorySpaceProviderDefinition, type MemorySpaceProviderDisposer, type MemorySpaceProviderEntry, type MemorySpaceProviderHost, type MemorySpaceProviderManifest, type MemorySpaceProviderModule, type MemorySpaceProviderRuntimeContext, type MemorySpaceProviderScoreSemantics, type MemorySpaceStats, NORMALIZED_RELEVANCE_SCORE, type OpenVikingBodyConnection, type OpenVikingSpaceConnection, ProcessError, ProcessFailureReason, ProcessOptions, ProcessResult, ProcessRunner, ProviderBodyStatus, ProviderEntityIndex, ProviderMemorySpace, ProviderScoreSemantics, ProviderSearchResult, ProviderSpaceStatus, type RememberRequest, SOURCES, type SearchRequest, type Source, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString, runProcess };

package/lib/testing.d.ts

@@ -1,5 +1,5 @@
 import { MemoryProviderConnection, MemoryProviderDescriptor, MemorySpace } from "./contracts.js";
-import { f as MemoryProviderAdapter, h as MemorySpaceAuthority, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, s as MemorySpaceProviderModule } from "./definitions-DwiEZSE_.js";
+import { f as MemoryProviderAdapter, h as MemorySpaceAuthority, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, s as MemorySpaceProviderModule } from "./definitions-CtjNSwBS.js";
 //#region src/testing.d.ts
 interface MemorySpaceProviderTest {
   readonly registered: boolean;

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

@@ -1,4 +1,4 @@
-import type { CreateMemorySpaceRequest, EntityView, Insight, MemorySpace, MemorySpaceView, MemorySpaceMetadataMaintenanceResult, MemorySpaceCatalog, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryReadSource, RememberRequest, SearchRequest, UpdateMemorySpaceRequest } from '../contracts.ts';
+import type { CreateMemorySpaceRequest, EntityMemoriesView, EntityRelatedView, EntityView, Insight, MemorySpace, MemorySpaceView, MemorySpaceMetadataMaintenanceResult, MemorySpaceCatalog, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryReadSource, RememberRequest, SearchRequest, UpdateMemorySpaceRequest } from '../contracts.ts';
 /**
  * Source-owned structural page API; the default bundle may supply agent-assisted callbacks.
  * body/bodies method and wire-field spellings remain compatible with existing
@@ -10,6 +10,10 @@ export interface MemorySpacesPageClient {
     graph(memoryBodyIds?: string[]): Promise<MemoryGraphSnapshot>;
     list(request?: MemoryListRequest): Promise<MemoryListView>;
     entities(entity?: string, limit?: number): Promise<EntityView>;
+    /** Optional for page clients written against an older Source; the Entities page then lists entities(entity) only. */
+    entityMemories?(entity: string, offset?: number, limit?: number): Promise<EntityMemoriesView>;
+    /** view: one id per page view; its next selection cancels the related read it is still waiting for. */
+    entityRelated?(entity: string, limit?: number, view?: string): Promise<EntityRelatedView>;
     search(request: SearchRequest): Promise<SearchResponse>;
     agentSearch(request: SearchRequest): Promise<AgentSearchResponse>;
     related(id: string, memoryBodyId?: string): Promise<Insight[]>;

package/lib/types/contracts.d.ts

@@ -235,6 +235,11 @@ export declare const EDGE_TYPES: readonly ["temporal", "semantic", "causal", "en
 export type Intent = 'WHY' | 'WHEN' | 'ENTITY' | 'GENERAL';
 export declare const INTENTS: readonly ["WHY", "WHEN", "ENTITY", "GENERAL"];
 export type RecallRelevanceTier = 'high' | 'medium' | 'low' | 'unknown';
+/**
+ * One spelling-insensitive key per entity. The Host's entity index and the Client's graph
+ * both count an entity's memories by it, so their numbers agree.
+ */
+export declare function normalizeEntityKey(entity: string): string;
 export interface Insight {
     id: string;
     content: string;
@@ -273,6 +278,13 @@ export interface SearchRequest {
     source?: Source;
     intent?: Intent;
     memoryBodyIds?: string[];
+    /**
+     * A look at the memory rather than a use of it, such as the Memory System's
+     * own searches. Providers that record reads, as access counts or a query
+     * log, leave it out, and may answer from a snapshot that lags a write still
+     * in flight; a check that must see a write leaves the flag unset.
+     */
+    inspect?: boolean;
 }
 export interface RememberRequest {
     content: string;
@@ -353,7 +365,8 @@ export interface MemoryGraphSnapshot {
     sources?: MemoryReadSource[];
 }
 export type MemoryReadMode = 'search' | 'graph' | 'projection' | 'enumerable' | 'query-only' | 'entities' | 'unsupported';
-export type MemoryReadStatus = 'ready' | 'empty' | 'query-required' | 'unsupported' | 'unavailable';
+/** 'loading' is client-only: a page shows its spaces from the directory while the read runs. */
+export type MemoryReadStatus = 'ready' | 'empty' | 'query-required' | 'unsupported' | 'unavailable' | 'loading';
 /**
  * One provider-backed Memory Space participating in a read surface.
  *
@@ -371,6 +384,10 @@ export interface MemoryReadSource {
     status: MemoryReadStatus;
     itemCount: number;
     edgeCount?: number;
+    /** Entity reads: the memories the entity index covers in this space. */
+    memoryCount?: number;
+    /** Entity reads: false when the Provider could not index every memory of this space. */
+    complete?: boolean;
     hint?: string;
     quality?: RecallQualityStats;
 }
@@ -505,15 +522,40 @@ export interface MemorySpacesStatus {
         dbPath?: string;
     };
 }
+/**
+ * The entities of the active spaces. Each count is the number of memories that
+ * carry the entity, the same set entity-memories lists.
+ */
 export interface EntityView {
     items: Array<{
         entity: string;
         count: number;
     }>;
+    /** With a selected entity: the first page of entity-memories, kept for existing callers. */
     insights: Insight[];
     selected?: string;
     /** Omitted only when talking to a pre-provider-aware Host. */
     sources?: MemoryReadSource[];
+    /** Distinct entities across the active spaces; items may be capped below it. Omitted by older Hosts. */
+    total?: number;
+    /** False when a space's Provider could not index every memory. Omitted by older Hosts. */
+    complete?: boolean;
+}
+/** One page of the memories that carry an entity, by importance and then recency. */
+export interface EntityMemoriesView {
+    /** The entity's most common spelling, or the requested name when no memory carries it. */
+    entity: string;
+    total: number;
+    offset: number;
+    items: Insight[];
+    complete: boolean;
+    sources: MemoryReadSource[];
+}
+/** Memories recall relates to an entity that do not carry it themselves. */
+export interface EntityRelatedView {
+    entity: string;
+    items: Insight[];
+    sources: MemoryReadSource[];
 }
 /** @deprecated Use CreateMemorySpaceRequest. The wire shape is unchanged. */
 export type CreateMemoryBodyRequest = CreateMemorySpaceRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-memory-spaces",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "Memory Spaces Source and its private Provider SDK.",
   "license": "MIT",
   "type": "module",
@@ -65,13 +65,13 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.23",
+    "dsh-mnemon": "^0.5.25",
     "dsh-mnemon-provider-byterover": "^0.5.5",
     "dsh-mnemon-provider-hindsight": "^0.5.5",
     "dsh-mnemon-provider-holographic": "^0.5.6",
     "dsh-mnemon-provider-honcho": "^0.5.5",
     "dsh-mnemon-provider-mem0": "^0.5.5",
-    "dsh-mnemon-provider-mnemon-native": "^0.5.8",
+    "dsh-mnemon-provider-mnemon-native": "^0.5.9",
     "dsh-mnemon-provider-openviking": "^0.5.7",
     "dsh-mnemon-provider-retaindb": "^0.5.5",
     "dsh-mnemon-provider-supermemory": "^0.5.5",

package/presentation/locales.json

@@ -291,11 +291,23 @@
     "entities.filterHint": "输入时即时过滤左侧列表（按 Esc 清空）",
     "entities.emptyRail": "写入带实体的记忆后，这里会形成入口。",
     "entities.filterEmpty": "本地无匹配。点“查阅”向宿主发起查询。",
-    "entities.loading": "正在沿实体关系召回…",
+    "entities.loading": "正在读取实体的记忆…",
     "entities.selectTitle": "选择或输入一个实体",
-    "entities.selectText": "实体视图会聚合与它相关的记忆，而不是只做字面匹配。",
+    "entities.selectText": "选中后列出带有它的全部记忆；需要时，可再查找召回认为相关的其他记忆。",
     "entities.emptyTitle": "没有关联记忆",
     "entities.emptyText": "尝试更完整的名称或另一个实体别名。",
+    "entities.railLoading": "正在读取实体…",
+    "entities.memoriesHint": "带有此实体的记忆",
+    "entities.relatedTitle": "相关记忆",
+    "entities.relatedHint": "召回认为相关、但不带此实体的记忆",
+    "entities.findRelated": "查找相关记忆",
+    "entities.hideRelated": "收起",
+    "entities.noCarrying": "没有记忆带有此实体。",
+    "entities.noRelated": "没有其他相关记忆。",
+    "entities.retry": "重试",
+    "entities.sourceReady": "{count} 个实体",
+    "entities.sourcePartial": "{count} 个实体 · 部分",
+    "readSources.status.loading": "正在读取",
     "remember.title": "存入记忆",
     "remember.description": "任务 Agent 会判断是否值得保存，去重、提炼后写入合适的记忆空间，不占用当前对话。",
     "remember.readOnlyTitle": "当前为只读模式",
@@ -637,11 +649,23 @@
     "entities.filterHint": "Type to filter the rail locally (Esc to clear).",
     "entities.emptyRail": "Entities appear here after memories with entity metadata are stored.",
     "entities.filterEmpty": "No local match. Press Explore to query the host.",
-    "entities.loading": "Recalling entity relations…",
+    "entities.loading": "Reading the entity's memories…",
     "entities.selectTitle": "Select or enter an entity",
-    "entities.selectText": "The entity view aggregates related memories instead of relying on literal matching.",
+    "entities.selectText": "Selecting one lists every memory that carries it; Find related memories then adds others recall relates to it.",
     "entities.emptyTitle": "No related memories",
     "entities.emptyText": "Try the full name or another entity alias.",
+    "entities.railLoading": "Reading entities…",
+    "entities.memoriesHint": "Memories that carry this entity",
+    "entities.relatedTitle": "Related memories",
+    "entities.relatedHint": "Recalled as related, without this entity",
+    "entities.findRelated": "Find related memories",
+    "entities.hideRelated": "Hide",
+    "entities.noCarrying": "No memory carries this entity.",
+    "entities.noRelated": "No other related memories.",
+    "entities.retry": "Retry",
+    "entities.sourceReady": "{count} entities",
+    "entities.sourcePartial": "{count} entities · partial",
+    "readSources.status.loading": "Reading",
     "remember.title": "Save to memory",
     "remember.description": "A task Agent decides whether this is worth keeping, removes duplicates, distills it and writes it to the right Memory Space, outside this conversation.",
     "remember.readOnlyTitle": "Read-only mode",

package/presentation/page.module.css

@@ -376,6 +376,26 @@ button.readSourceCard:hover { background: var(--mn-hover); }
 .entityList button > span { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .entityList strong { flex: none; color: var(--mn-faint); font-size: 12px; font-weight: 400; font-variant-numeric: tabular-nums; }
 .entityResults > .emptyState { min-height: 360px; }
+.entitySection { min-width: 0; }
+.entitySection + .entitySection { margin-top: 24px; }
+/* A section keeps its height while it loads, so the one below does not jump. */
+.entitySectionBody { min-height: 116px; }
+.entityQuiet { margin: 0 0 8px; padding: 12px 2px; color: var(--mn-faint); font-size: 13px; line-height: 20px; }
+.entityRetry { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 8px 12px; }
+.entityRelatedHead { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; }
+.entityRelatedHead > div:first-child { flex: 1; min-width: 0; }
+.entityRelatedHead > button { flex: none; margin-top: 2px; }
+.insightSkeleton { position: relative; display: grid; min-height: 108px; align-content: start; gap: 12px; overflow: hidden; margin-bottom: 8px; padding: 16px; border: .5px solid var(--mn-card-line); border-radius: var(--dsw-radius-lg); }
+.insightSkeleton > span { display: block; height: 10px; border-radius: 999px; background: var(--mn-fill); }
+.insightSkeleton > span:nth-child(1) { width: 36%; }
+.insightSkeleton > span:nth-child(2) { width: 94%; }
+.insightSkeleton > span:nth-child(3) { width: 68%; }
+.entityRailSkeleton { position: relative; display: block; height: 32px; overflow: hidden; border-radius: var(--dsw-radius-sm); background: color-mix(in srgb, var(--mn-fill) 55%, transparent); }
+.insightSkeleton::after,
+.entityRailSkeleton::after { position: absolute; inset: 0; content: ""; background: linear-gradient(105deg, transparent 20%, color-mix(in srgb, var(--mn-text) 5%, transparent) 45%, transparent 70%); transform: translateX(-120%); animation: entity-skeleton-sweep 1.2s ease-in-out infinite; pointer-events: none; }
+@keyframes entity-skeleton-sweep { to { transform: translateX(120%); } }
+@media (prefers-reduced-motion: reduce) { .insightSkeleton::after, .entityRailSkeleton::after { animation: none; } }
+.readSourceCard[data-status="loading"] .readSourceSignal { background: var(--mn-idle); }
 
 .supervisedComposer { border: .5px solid var(--mn-card-line); border-radius: var(--dsw-radius-lg); }
 .supervisedComposer { overflow: hidden; }