dsh-prime-memory 0.20.0-beta.2 → 0.20.0-beta.21

package/dist/stats.d.ts

@@ -3,15 +3,13 @@ import { type MemoryConfig } from './config.js';
 import { type RecallSessionStats } from './hooks/recall.js';
 import type { RebuildController } from './pipeline/rebuild.js';
 import type { RuminateController } from './pipeline/ruminate.js';
+import type { RoomRegistryStore } from './store/rooms-registry.js';
+import type { RecallUsageStore } from './store/recall-usage.js';
 import { type LiveSettingsHandle } from './settings.js';
 import type { GraphStore } from './store/graph-store.js';
 import type { L0Store } from './store/l0.js';
 import type { L1Store } from './store/l1.js';
 import type { PersonaStore } from './store/persona.js';
-import type { SlotStore } from './store/slots.js';
-import type { ContextUsageStore } from './store/context-usage.js';
-import type { TodoRefStore } from './store/todo-ref.js';
-import type { MemoryRunner } from './pipeline/runner.js';
 import type { SceneStore } from './store/scenes.js';
 import type { SessionModeStore } from './store/session-modes.js';
 import type { EmbeddingManager } from './store/embedding-source.js';
@@ -27,7 +25,7 @@ export interface MemoryStatusSource {
     pending(): number;
 }
 /**
- * 端点全集运行时清单(36 个,与 tests/contract-keys.test.ts 的 ENDPOINTS 及
+ * 端点全集运行时清单(与 tests/contract-keys.test.ts 的 ENDPOINTS 及
  * contract.ts 类型映射表三方对齐,漂移由键集 diff 测试暴露)。
  * 注意:本清单同时是 HTTP 前缀路由 `/dsh-memory/rpc/<短名>` 的**放行白名单**
  * (见下方 SHORT_ENDPOINTS),漏一条 = 该端点在面板里静默消失(404 被客户端
@@ -71,29 +69,6 @@ export interface SessionInfoSource {
 }
 import type { MemoryOccupancy, UiRecord } from './contract.js';
 export type { MemoryStats } from './contract.js';
-/** 注册状态 RPC(web 侧 connection 服务可选,缺失时跳过,不影响插件主体)。 */
-/** 长任务端点依赖(可选:未装配时端点返 enabled:false,不报错)。 */
-export interface LongTaskEndpointDeps {
-    runner: MemoryRunner;
-    slots: SlotStore;
-    contextUsage: ContextUsageStore;
-    todoRef: TodoRefStore;
-}
-/**
- * 尾部 turn 压缩:把 (水位线, maxCapturedTurn] 内最近的最近 N 轮强制蒸馏入记忆
- * (force 跳过阈值;L1 去重与水位线双重防重)。off 档会话保持完全隐身(不压缩)。
- * 无锚点老数据只在首次压缩(无水位线)时纳入——宁少收不重蒸。
- */
-export declare function compressTailTurns(sessionId: string, turns: number, io: {
-    modes: SessionModeStore;
-    l0: L0Store;
-    runner: MemoryRunner;
-    logger: MemoryLogger;
-}): Promise<{
-    enqueued: number;
-    fromTurn: number | null;
-    toTurn: number | null;
-}>;
 /** registerMemoryRpc 形参中需要落入端点 deps 的部分。 */
 interface MemoryRpcSources {
     status?: MemoryStatusSource;
@@ -103,8 +78,8 @@ interface MemoryRpcSources {
     rebuild?: RebuildController;
     embedManager?: EmbeddingManager;
     sessionInfo?: SessionInfoSource;
-    /** 长任务端点依赖(未装配 = 端点恒 disabled,面板不挂载)。 */
-    longTask?: LongTaskEndpointDeps;
+    /** Room 注册表(未装配 = rooms-get 不带 registry,rooms-export 不可用)。 */
+    roomRegistry?: RoomRegistryStore;
 }
 /** 端点 deps 的注入面(ctx/cfg/stores/logger 由调用方绑定,其余由此处决定)。 */
 export type EndpointDepsInput = Omit<EndpointDeps, 'ctx' | 'cfg' | 'stores' | 'logger'>;
@@ -120,6 +95,8 @@ export declare function registerMemoryRpc(ctx: Context, cfg: MemoryConfig, store
     scenes: Record<MemoryFamily, SceneStore>;
     persona: Record<MemoryFamily, PersonaStore>;
     state: StateStore;
+    /** 召回使用统计(可选)。 */
+    usage?: RecallUsageStore;
     /** 记忆后端(后台边界);未装配时回退为包 l1 的进程内实现。 */
     backend?: MemoryBackend;
     /** 图谱存储(可选:未装配时图谱端点返空,不报错)。 */
@@ -127,14 +104,16 @@ export declare function registerMemoryRpc(ctx: Context, cfg: MemoryConfig, store
 }, logger: MemoryLogger, status?: MemoryStatusSource, live?: LiveSettingsHandle, modes?: SessionModeStore, dataDir?: string, rebuild?: RebuildController, embedManager?: EmbeddingManager, sessionInfo?: SessionInfoSource, 
 /** 反刍控制器(存储降级时为 undefined):经 buildEndpointDeps 落入 deps.ruminate。 */
 ruminate?: RuminateController, 
-/** 长任务端点依赖(cfg.longTask.enabled 门控;缺省 = 端点恒 disabled)。 */
-longTaskDeps?: LongTaskEndpointDeps): void;
+/** Room 分类管理依赖(注册表;缺省 = rooms-get 不带 registry、rooms-export 恒 404 语义)。 */
+roomRegistry?: RoomRegistryStore): void;
 export interface EndpointDeps {
     ctx: Context;
     cfg: MemoryConfig;
     stores: {
         l0: L0Store;
         l1: L1Store;
+        /** 召回使用统计(可选:未装配 = 列表不带 usage/usageSummary)。 */
+        usage?: RecallUsageStore;
         scenes: Record<MemoryFamily, SceneStore>;
         persona: Record<MemoryFamily, PersonaStore>;
         state: StateStore;
@@ -151,12 +130,14 @@ export interface EndpointDeps {
     ruminate?: RuminateController;
     embedManager?: EmbeddingManager;
     sessionInfo?: SessionInfoSource;
-    /** 长任务端点依赖(未装配 = 端点恒 disabled,面板不挂载)。 */
-    longTask?: LongTaskEndpointDeps;
+    /** Room 注册表(未装配 = rooms-get 不带 registry,rooms-export 不可用)。 */
+    roomRegistry?: RoomRegistryStore;
 }
 /** 端点分发表(导出供测试直调:可精确注入 rebuild/ruminate 等可选控制器,验证 deps 接线)。 */
 export declare function handleEndpoint(endpoint: string, payload: unknown, deps: EndpointDeps): Promise<unknown>;
 /** 浏览器卡片字段(比 MemoryRecord 精简,去掉大 metadata;Hall 从 metadata 提取)。 */
+/** 老化权重(与读路径 applyDecayWeight 同式):max(0.5, 0.5^(Δ天/半衰期));半衰期 ≤0 = 关 → null。 */
+export declare function agingWeightOf(updatedAtMs: number | undefined, halfLifeDays: number, now?: number): number | null;
 export declare function hitToUiRecord(r: {
     id: string;
     content: string;
@@ -173,4 +154,12 @@ export declare function hitToUiRecord(r: {
     family?: string;
     /** 退场判据:`valid_to` 闭合即已退场(软删)。由 `listL1`/`getByIds` 透传。 */
     validTo?: number;
+}, extra?: {
+    agingWeight?: number | null;
+    usage?: {
+        attempts: number;
+        used: number;
+        lastAttemptAt: number | null;
+        lastUsedAt: number | null;
+    } | null;
 }): UiRecord;