dsh-mnemon-source-memory-spaces 0.5.14 → 0.5.16

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;
@@ -353,7 +358,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 +377,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 +515,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.14",
+  "version": "0.5.16",
   "description": "Memory Spaces Source and its private Provider SDK.",
   "license": "MIT",
   "type": "module",
@@ -65,10 +65,10 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.21",
+    "dsh-mnemon": "^0.5.24",
     "dsh-mnemon-provider-byterover": "^0.5.5",
     "dsh-mnemon-provider-hindsight": "^0.5.5",
-    "dsh-mnemon-provider-holographic": "^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",

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; }