dsh-plugin-om 0.0.21 → 0.0.23

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,sEAAsE;AACtE,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,kDAAkD;AAClD,eAAO,MAAM,WAAW,iHAAuB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,oUACgD,CAAC;AAEzF,mGAAmG;AACnG,wBAAgB,mBAAmB,CACjC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACrD,OAAO,CAGT;AAED,0GAA0G;AAC1G,eAAO,MAAM,yBAAyB,YAAY,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uCAAuC;AACvC,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,iDAAiD;AACjD,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,iDAAiD;AACjD,eAAO,MAAM,WAAW,iHAAuB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,oUACgD,CAAC;AAEzF,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,6DAA0B,CAAC;AAEhE,uFAAuF;AACvF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACrD,OAAO,CAGT"}

package/dist/embedding.d.ts

@@ -1,64 +1,47 @@
 /**
- * 本地语义嵌入（recall-semantic 的向量引擎）。
- *
- * - 模型：Xenova/paraphrase-multilingual-MiniLM-L12-v2（量化 ONNX，多语言，
- *   中英 + 代码均可处理）。模型目录默认 = $DSH_HOME/plugin-data/dsh-plugin-om/
- *   models/<模型id>/（跨插件版本共享）：随包小文件（config/tokenizer 等）缺失时
- *   从打包目录复制补齐（离线可用），onnx 二进制按需下载。
- * - 运行时下载：模型 onnx 缺失时由 ensureModelReady 后台下载（不阻塞、单飞、
- *   失败自动重试），下载逻辑见 model-download.ts；就绪前工具告知模型。
- * - 懒加载：首次调用才 `import('@huggingface/transformers')` 并加载 pipeline，
- *   插件启动不阻塞；加载结果单例缓存（resetEmbedder 供测试重置）。
- * - 批处理：一次推理多条文本（mean pooling + L2 归一化），输出每条的向量。
- * - 相似度：cosineSimilarity 纯函数（归一化向量点积即余弦）。
- *
- * 依赖说明：@huggingface/transformers 为运行时依赖（v4，dtype q8 加载
- * model_quantized.onnx），node 侧使用 onnxruntime-node 原生绑定。
+ * 本地语义嵌入（recall-semantic 的向量引擎）：Xenova/paraphrase-multilingual-MiniLM-L12-v2
+ * 量化 ONNX，懒加载 + 批量推理 + cosine 相似度，模型缺失时按需后台下载。
+ * 导出 BUNDLED_MODEL_DIR / EMBEDDING_MODEL_ID / resolveDshHome / sharedModelDir /
+ * ensureModelSmallFiles / getEmbedder / resetEmbedder / ensureModelReady /
+ * resetModelDownloads / cosineSimilarity 及 EmbedFn / ModelStatus 类型。
+ * 模型目录默认为跨版本共享目录（$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>）：
+ * 随包小文件缺失时从打包目录复制补齐（离线可用），onnx 二进制按需下载
+ * （见 model-download.ts）。@huggingface/transformers 为运行时依赖（dtype q8 加载
+ * model_quantized.onnx，node 侧使用 onnxruntime-node 原生绑定）。
  */
 import { EMBEDDING_MODEL_ID, type ModelFetch } from './model-download.ts';
 /** 打包模型目录：<包根>/models/<model-id>/。 */
 export declare const BUNDLED_MODEL_DIR: string;
 export { EMBEDDING_MODEL_ID };
-/** DSH 用户数据根目录：$DSH_HOME 优先（空白视为未设置），缺省 ~/.dsh（与宿主解析规则一致）。 */
+/** DSH 用户数据根目录：$DSH_HOME 优先（空白视为未设置），缺省 ~/.dsh。 */
 export declare function resolveDshHome(): string;
-/**
- * 跨插件版本共享的默认模型目录：$DSH_HOME/plugin-data/dsh-plugin-om/models/<模型id>。
- * 不随插件包（版本）变化，升级/重装插件后仍复用同一份已下载模型（onnx 不重复下载）。
- */
+/** 跨插件版本共享的默认模型目录：$DSH_HOME/plugin-data/dsh-plugin-om/models/<模型id>。 */
 export declare function sharedModelDir(): string;
 /**
- * 补齐模型目录的随包小文件（config/tokenizer 等）：modelDir 与打包目录不同
- * （如共享目录）时，把打包目录中缺失的小文件复制过去，保证模型可离线加载。
- * 已存在的文件不覆盖（同一模型文件跨版本稳定）；打包目录本身缺失则跳过。
- * 幂等、无网络。onnx 二进制不在此列（按需下载，见 model-download.ts）。
+ * 补齐模型目录的随包小文件（config/tokenizer 等）：modelDir 与打包目录不同时，
+ * 把打包目录中缺失的小文件复制过去（已存在不覆盖；打包目录缺失则跳过）。
+ * 幂等、无网络；onnx 二进制不在此列。
  */
 export declare function ensureModelSmallFiles(modelDir: string, bundledDir?: string): void;
 /** 嵌入函数类型：批量文本 → 每条一个向量（Float32Array）。 */
 export type EmbedFn = (texts: readonly string[]) => Promise<Float32Array[]>;
 /**
- * 获取（或加载）嵌入函数。首次调用动态 import transformers 并加载本地模型；
+ * 获取（或加载）嵌入函数。首次调用动态 import transformers 并加载本地模型，
  * 之后复用同一 pipeline。失败时抛出可读错误（调用方自行降级）。
  */
 export declare function getEmbedder(modelDir?: string): Promise<EmbedFn>;
 /** 重置模型单例（测试用：卸载已加载的 pipeline）。 */
 export declare function resetEmbedder(): void;
-/** 模型就绪状态：ready=本地已就绪可直接加载；downloading=缺失，后台下载中/将自动重试。 */
+/** 模型就绪状态：ready=本地已就绪；downloading=缺失，后台下载中/将自动重试。 */
 export type ModelStatus = 'ready' | 'downloading';
 /**
  * 确保模型就绪（运行时按需下载编排）。
- * - 本地 onnx 已存在 → 'ready'（不触发下载）。
- * - 缺失 → 启动后台下载（不阻塞，单飞）并返回 'downloading'；下载失败仅调用
- *   warn 记录日志并结束本次尝试，下次调用会重新触发下载（自动重试）。
- * - warn 可选：下载失败时的日志回调（默认静默；apply 注入 ctx.logger.warn）。
- * - log 可选：下载开始/结束日志回调（默认静默；apply 注入 console.log + ctx.logger.info 双通道）。
- * - fetchImpl 可注入（测试传替身，默认全局 fetch）。
+ * 本地 onnx 已存在 → 'ready'；缺失 → 启动后台下载（不阻塞、单飞，失败经 warn 记录，
+ * 下次调用自动重试）并返回 'downloading'。warn/log/fetchImpl 可注入（测试传替身）。
  */
 export declare function ensureModelReady(modelDir?: string, warn?: (message: string) => void, fetchImpl?: ModelFetch, log?: (message: string) => void): Promise<ModelStatus>;
 /** 重置下载状态（测试用：清空在途下载任务记录）。 */
 export declare function resetModelDownloads(): void;
-/**
- * 两个向量的余弦相似度（向量已 L2 归一化时点积即余弦；这里兜底再归一化）。
- * 任一向量为零向量返回 0。
- */
+/** 两个向量的余弦相似度（向量已 L2 归一化时点积即余弦；这里兜底再归一化）。零向量返回 0。 */
 export declare function cosineSimilarity(a: Float32Array | readonly number[], b: Float32Array | readonly number[]): number;
 //# sourceMappingURL=embedding.d.ts.map

package/dist/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../src/embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAEL,kBAAkB,EAElB,KAAK,UAAU,EAGhB,MAAM,qBAAqB,CAAC;AAK7B,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,QAAsD,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,8DAA8D;AAC9D,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAA0B,GACrC,IAAI,CASN;AAED,0CAA0C;AAC1C,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;AAQ5E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,GAAE,MAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAoClF;AAED,mCAAmC;AACnC,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAKlD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAE,MAA0B,EACpC,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,EAC1C,SAAS,CAAC,EAAE,UAAU,EACtB,GAAG,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,GACxC,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED,8BAA8B;AAC9B,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EACnC,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,GAClC,MAAM,CAkBR"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../src/embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAEL,kBAAkB,EAElB,KAAK,UAAU,EAGhB,MAAM,qBAAqB,CAAC;AAK7B,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,QAAsD,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,mDAAmD;AACnD,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wEAAwE;AACxE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAA0B,GACrC,IAAI,CASN;AAED,0CAA0C;AAC1C,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;AAQ5E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,GAAE,MAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAmClF;AAED,mCAAmC;AACnC,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAKlD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAE,MAA0B,EACpC,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,EAC1C,SAAS,CAAC,EAAE,UAAU,EACtB,GAAG,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,GACxC,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAED,8BAA8B;AAC9B,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EACnC,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,GAClC,MAAM,CAeR"}

package/dist/index.d.ts

@@ -1,29 +1,8 @@
-/**
- * dsh-plugin-om — Observational Memory（OM）上下文压缩 + recall 检索插件。
- * 不依赖特定 tool mode（native / code / both 均可运行）。
- *
- * 模块：
- *  - recall.ts  recall({ start, end?, offset? }) 工具：按完整消息 index 回看原始会话
- *  - semantic-recall.ts  recall-semantic({ query, top_k?, start?, end?, offset? }) 工具：
- *    按语义在全部完整消息（含被压缩/遮蔽）中检索，返回最匹配的完整消息与匹配说明
- *    （本地 ONNX embedding，模型随插件打包，懒加载）
- *  - compress.ts 自动压缩（OM 观察/反思两级阈值）：pre-step 阻塞串行执行——
- *    反思（<history> 块 tokens 合计 ≥ reflectThresholdTokens 时摘要调用精简合并）、
- *    观察（未压缩消息 tokens ≥ observeThresholdTokens 时摘要调用压缩为观察日志并追加）
- *
- * 约束：不引入自定义会话事件类型——压缩复用宿主已知的 compaction/* 生命周期事件
- * （start/summary/end）与 checkpoint 标记，结果写入消息记录与轨迹。
- * 仅主会话生效（subagent 不压缩、recall 拒绝）。
- */
 import type { Context } from './types.ts';
 /** 插件名（Loader 识别入口的稳定标识）。 */
 export declare const name = "dsh-plugin-om";
 /** 插件注入的服务依赖（tools/llm/tokenMeter/sessions），由宿主按序注入。 */
 export declare const inject: string[];
-/**
- * 插件激活入口：注册 recall / recall-semantic 工具（由配置键 recallEnabled /
- * semanticRecallEnabled 控制），并在 agent/pre-step 阻塞触发两级自动压缩
- * （先反思后观察）。仅主会话生效。
- */
+/** 插件激活入口：解析配置、注册工具、接线 pre-step 自动压缩。 */
 export declare function apply(ctx: Context, config?: unknown): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,6BAA6B;AAC7B,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,wDAAwD;AACxD,eAAO,MAAM,MAAM,UAA6C,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAwD1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,6BAA6B;AAC7B,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,wDAAwD;AACxD,eAAO,MAAM,MAAM,UAA6C,CAAC;AAEjE,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAoD1D"}