dsh-plugin-om 0.0.20 → 0.0.21

package/README.md

@@ -79,7 +79,7 @@ dsh的"预设"分为两层，`dsh web`等同于`dsh --profile web`，调用的
 4. 提供recall/recall-semantic两个tool进行检索
 
 观察与反思共用同一套系统提示词（buildHistoryPrompt）：输入与输出都是合法的 <history> 块（模型消息 + index 的表达形式），先定义块、要求压缩、再给出数据源（下方 <history> 消息记录）。
-观察压缩按 `observeChunkTokens` 边界把未压缩消息分块（完整消息不跨块，thinking/text/toolcall&result 同块）并行摘要，各块合并为一个 <history> 块提交；提示词按块位次分档——前块要求简单摘要，最后一块要求「越往后越细」保留细节。
+观察压缩按 `observeChunkTokens` 边界把未压缩消息分块（完整消息不跨块，thinking/text/toolcall&result 同块）压缩摘要，最多 `observeChunkParallelism` 块同时进行、其余块排队，各块合并为一个 <history> 块提交；提示词按块位次分档——前块要求简单摘要，最后一块要求「越往后越细」保留细节。任一摘要请求遇 429 限流后，插件全局进入冷却期：后续所有摘要请求在 `rateLimitWaitMs` 内不会发出。
 
 ### 压缩日志块结构
 
@@ -125,6 +125,8 @@ dsh的"预设"分为两层，`dsh web`等同于`dsh --profile web`，调用的
 | `compressMaxTokens`     | `10000`  | 反思（合并调用）生成上限；观察分块用 `observeChunkMaxTokens`                                                                                                                  |
 | `observeChunkTokens`    | `30000`  | 观察分块 token 边界：未压缩消息按该边界拆分为多块并行压缩（完整消息不跨块）                                                                                                  |
 | `observeChunkMaxTokens` | `5000`   | 观察分块单块摘要的生成上限（每块独立调用）                                                                                                                                  |
+| `observeChunkParallelism` | `2`    | 观察分块压缩的最大并行数：同时进行的单块摘要调用上限，其余块排队（`1` 即串行）                                                                                              |
+| `rateLimitWaitMs`       | `60000`  | 遇 429 限流后，下一次摘要请求发出前至少等待的毫秒数（插件全局共享冷却期：任一请求遇 429 后，所有后续摘要请求——含并行中的其他块——都等满该时长；`0` 视为不限流）                |
 | `tailMessageCount`      | `10`     | 尾部保留的不压缩消息条数（不压缩、不被替换、不进摘要日志）                                                                                                                   |
 | `compressRetryCount`    | `10`     | 摘要调用失败后的最大重试次数（不含首次；总尝试次数 = 该值 + 1）                                                                                                              |
 | `modelDir`              | 共享目录 | recall-semantic 嵌入模型目录（默认 `$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>`，跨插件版本共享；小文件随包分发并在缺失时自动补齐，onnx 缺失且启用语义召回时运行时自动下载到该目录；可指向自定义目录） |
@@ -180,10 +182,11 @@ src/
 ├── log-index.ts              # 完整消息索引（index 定位 user/sys/assistant/具有result的toolcall；user_message 按 source.kind 分类：kind:user 为用户消息、其余为系统消息；本插件自产压缩日志消息不占位；未闭合 tool-call 不占位；recall 与摘要共用）
 ├── embedding.ts              # 本地 ONNX 嵌入（@huggingface/transformers + 本地模型；共享目录解析 / 小文件补齐 / 运行时按需下载编排 / 懒加载 / 批量 / cosine）
 ├── model-download.ts          # 模型下载原语（modelSourceUrl / needsDownload / 原子落盘 / 开始结束日志与失败镜像建议；运行时与 dev CLI 共用）
-├── summarize.ts              # 共享提示词 buildHistoryPrompt（观察/反思同一套；mode 控制摘要粒度：summary 简单摘要 / detailed 越往后越细）+ renderMessages（@xmldom/xmldom 构建 <history> 块输入：用户消息原样、系统消息渲染为 <sys> 空块、自动转义）+ 直连 ctx.llm.stream() 摘要（new 方式：指令作 system、输入为渲染消息；extractSummaryLog 提取校验：XML 结构合法 / 无 reasoning / index 连续 / 覆盖区间；重试与流式 usage 归入主会话；成功返回 attemptCount（尝试次数，载荷层换算为重试次数））
+├── summarize.ts              # 共享提示词 buildHistoryPrompt（观察/反思同一套；mode 控制摘要粒度：summary 简单摘要 / detailed 越往后越细）+ renderMessages（@xmldom/xmldom 构建 <history> 块输入：用户消息原样、系统消息渲染为 <sys> 空块、自动转义）+ 直连 ctx.llm.stream() 摘要（new 方式：指令作 system、输入为渲染消息；extractSummaryLog 提取校验：XML 结构合法 / 无 reasoning / index 连续 / 覆盖区间；重试与流式 usage 归入主会话；每次请求前过全局限流等待门 rate-limit.ts；成功返回 attemptCount（尝试次数，载荷层换算为重试次数））
+├── rate-limit.ts             # 全局限流门（插件进程级共享状态）：429 识别（isRateLimitError）/ 冷却期记录（noteRateLimit）/ 等待门（gateRateLimit：最近一次 429 + rateLimitWaitMs 之前不放行，等待期间中止立即放弃，新 429 顺延冷却期）
 ├── recall.ts                 # recall 工具
 ├── semantic-recall.ts        # recall-semantic 工具（query 语义检索 + 区间限定 + 回退全量 + 匹配说明）
-└── compress.ts               # 两级自动压缩（测量 / mid-turn 区间计算 / 配对平衡回退 / source 标记判定摘要消息 / 观察分块并行 chunkCompleteMessages + 合并 mergeChunkReports / compaction/* 生命周期事件：start 在摘要调用前追加并带 phase，失败补 end(error) + 替换消息 source 插件标识）
+└── compress.ts               # 两级自动压缩（测量 / mid-turn 区间计算 / 配对平衡回退 / source 标记判定摘要消息 / 观察分块经 runWithConcurrency 有界并发池逐块压缩 + 合并 mergeChunkReports / compaction/* 生命周期事件：start 在摘要调用前追加并带 phase，失败补 end(error) + 替换消息 source 插件标识）
 src/client/
 ├── index.ts                   # 浏览器客户端入口（exports["./client"] → dist/client.js）：注入 slots/conversationEvents/locale，注册卡片定义与渲染器
 ├── definition.ts              # 压缩卡片业务定义：认领插件生命周期事件与替换检查点（source.plugin = dsh-plugin-om），聚合摘要卡片节点；start→压缩中提示行（running+phase）、end→hidden 撤回、summary→卡片（retryCount）

package/dist/compress.d.ts

@@ -2,6 +2,12 @@ import type { Agent, CompleteMessage, Context, PluginConfig, Session } from './t
 import { type RoutedTarget } from './utils.ts';
 /** 历史文本 token 估算：4 字符 ≈ 1 token（与宿主 dsh-token-meter 启发式一致）。 */
 export declare function estimateTextTokens(text: string): number;
+/**
+ * 有界并发池：最多 limit 个任务同时运行（limit 非法时按 1 处理），任务按 index 顺序
+ * 取用，结果数组与 items 按 index 对齐（任务自身以返回值表达失败，不在此抛出）。
+ * items 为空返回空数组。
+ */
+export declare function runWithConcurrency<T, R>(items: readonly T[], limit: number, task: (item: T, index: number) => Promise<R>): Promise<R[]>;
 /**
  * 按 token 边界把完整消息序列分块（观察并行压缩用）：完整消息不跨块——
  * 一条完整消息（含其 thinking/text/toolcall&result 全部 seqs）必然整体落在同一块，

package/dist/compress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EACV,KAAK,EAIL,eAAe,EACf,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,eAAe,EAAE,EAC/B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,GACtC,eAAe,EAAE,EAAE,CA6BrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiBlE;AAyED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG;IAAE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAyBzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAc1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CA8BpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAaA;AA8GD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Hf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA0Lf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyBf"}
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EACV,KAAK,EAIL,eAAe,EACf,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBd;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,eAAe,EAAE,EAC/B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,GACtC,eAAe,EAAE,EAAE,CA6BrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiBlE;AAyED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG;IAAE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAyBzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAc1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CA8BpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAaA;AA8GD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Hf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAgMf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/config.d.ts

@@ -10,6 +10,10 @@ export type PluginConfig = {
     observeChunkTokens: number;
     /** 观察分块单块摘要的生成上限（LLM maxTokens；每块独立调用）。 */
     observeChunkMaxTokens: number;
+    /** 观察分块压缩的最大并行数：同时进行的单块摘要调用上限，其余块排队（默认 2）。 */
+    observeChunkParallelism: number;
+    /** 遇 429 限流后，下一次摘要请求发出前至少等待的毫秒数（全局限流冷却期，默认 60000）。 */
+    rateLimitWaitMs: number;
     /** 压缩边界：其后不压缩消息数下限（正整数，尾部保留）。 */
     tailMessageCount: number;
     /** 摘要调用失败后的最大重试次数（不含首次尝试；总尝试次数 = 该值 + 1，默认 11）。 */

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,6CAA6C;IAC7C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAahD,CAAC;AAuCH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CA4BnE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,6CAA6C;IAC7C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,uBAAuB,EAAE,MAAM,CAAC;IAChC,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAehD,CAAC;AA2CH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CA4BnE"}

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { homedir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { z } from "zod";
+import { toJSONSchema } from "zod/v4/core";
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 //#endregion
@@ -7368,7 +7369,7 @@ var require_dom_parser = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.onWarningStopParsing = onWarningStopParsing;
 }));
 //#endregion
-//#region src/summarize.ts
+//#region src/rate-limit.ts
 var import_lib = (/* @__PURE__ */ __commonJSMin(((exports) => {
 	var conventions = require_conventions();
 	exports.assign = conventions.assign;
@@ -7409,6 +7410,69 @@ var import_lib = (/* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.onWarningStopParsing = domParser.onWarningStopParsing;
 })))();
 /**
+* 全局限流门（插件进程级共享状态）：任一摘要请求遇 429 限流后记录时间戳，
+* 此后所有摘要请求在发出前先等待到「最近一次 429 + rateLimitWaitMs」之后——
+* 并行压缩时其他块的下一次请求同样受限。等待期间 signal 中止则立即放弃。
+*
+* 门在进入时与等待结束时都会重读最近限流时间戳：等待期间发生新的 429 会顺延
+* 冷却期（循环等待直到通过或中止）。
+*/
+/** 最近一次 429 限流的时间戳（ms；null = 未遇过限流，门直接放行）。 */
+let lastRateLimitAt = null;
+/**
+* 判定错误信息是否为 429 限流：匹配 429（独立数字）或 rate limit（空格/连字符/
+* 下划线分隔与 camelCase 均可），大小写不敏感。
+*/
+function isRateLimitError(message) {
+	return /\b429\b|rate[\s_-]?limit/i.test(message);
+}
+/** 记录一次 429 限流：把冷却期起点更新为当前时间。 */
+function noteRateLimit() {
+	lastRateLimitAt = Date.now();
+}
+/** 可中止延时：等待满 ms 返回 true；等待期间 signal 中止返回 false。 */
+function delay(ms, signal) {
+	return new Promise((resolve) => {
+		if (signal?.aborted) {
+			resolve(false);
+			return;
+		}
+		/** 定时器句柄（正常到点或中止清理用）。 */
+		const timer = setTimeout(() => {
+			cleanup();
+			resolve(true);
+		}, ms);
+		/** 中止监听（到点立即返回 false）。 */
+		const onAbort = () => {
+			cleanup();
+			resolve(false);
+		};
+		/** 清理定时器与中止监听。 */
+		const cleanup = () => {
+			clearTimeout(timer);
+			signal?.removeEventListener("abort", onAbort);
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+/**
+* 限流等待门：处于 429 冷却期（最近一次 429 + waitMs 未到）时等待到期限，
+* 通过后返回 true；等待期间 signal 中止返回 false。未遇过限流或冷却期已过
+* 立即放行。waitMs ≤ 0 视为不限流。
+*/
+async function gateRateLimit(waitMs, signal) {
+	if (waitMs <= 0) return true;
+	while (lastRateLimitAt !== null) {
+		/** 距冷却期结束的剩余等待（≤ 0 表示已过冷却期）。 */
+		const remaining = lastRateLimitAt + waitMs - Date.now();
+		if (remaining <= 0) return true;
+		if (!await delay(remaining, signal)) return false;
+	}
+	return true;
+}
+//#endregion
+//#region src/summarize.ts
+/**
 * 共享压缩提示词（观察/反思同一套）：定义 history 块（模型消息 + index 的表达形式）、
 * 完整消息定义、要求压缩（完整保留用户消息 / reasoning 仅参考 / 关联 assistant 合并 /
 * index/start/end 连续）、输出格式（一个合法 <history> 块，无 reasoning）、数据源说明。
@@ -7812,6 +7876,9 @@ function extractSummaryLog(raw, expected) {
 * 失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）均记录日志并重试，总共最多尝试
 * options.maxAttempts 次（默认 SUMMARY_DEFAULT_MAX_ATTEMPTS）；全部尝试失败返回 null
 * （不产生任何日志变更）。输出长度受 maxTokens 限制。
+* 每次请求发出前先过全局限流等待门（gateRateLimit）：任一请求遇 429 后，后续所有
+* 摘要请求（含并行中的其他调用方）在「最近一次 429 + options.rateLimitWaitMs」之前
+* 不会发出（缺省 RATE_LIMIT_WAIT_MS_DEFAULT）。
 */
 async function runSummarySubagent(ctx, agent, instruction, contextText, maxTokens, target, debug, signal, options) {
 	/** 当前会话。 */
@@ -7827,6 +7894,12 @@ async function runSummarySubagent(ctx, agent, instruction, contextText, maxToken
 			logger.warn(`摘要调用中止（第 ${attempt}/${maxAttempts} 次尝试前 signal 已中止），放弃本次摘要`);
 			return null;
 		}
+		/** 限流冷却时长（ms；调用方未传时用默认值）。 */
+		const rateLimitWaitMs = options?.rateLimitWaitMs ?? 6e4;
+		if (!await gateRateLimit(rateLimitWaitMs, signal)) {
+			logger.warn(`摘要调用中止（第 ${attempt}/${maxAttempts} 次尝试前限流等待被 signal 中止），放弃本次摘要`);
+			return null;
+		}
 		logger.step(`摘要调用开始（第 ${attempt}/${maxAttempts} 次，provider ${target.provider}，model ${target.model}，maxTokens ${maxTokens}）`);
 		try {
 			/** 摘要请求选项（new 方式组装）。 */
@@ -7856,6 +7929,10 @@ async function runSummarySubagent(ctx, agent, instruction, contextText, maxToken
 		} catch (error) {
 			/** 错误信息（统一为字符串）。 */
 			const message = error instanceof Error ? error.message : String(error);
+			if (isRateLimitError(message)) {
+				noteRateLimit();
+				logger.warn(`摘要调用触发限流（429，第 ${attempt}/${maxAttempts} 次），下一次请求前至少等待 ${rateLimitWaitMs}ms`);
+			}
 			lastFailure = { error: message };
 			logger.warn(`摘要调用失败（第 ${attempt}/${maxAttempts} 次，${message}）` + (attempt < maxAttempts ? "，将重试" : "，重试耗尽，忽略本次摘要"));
 		}
@@ -7899,6 +7976,30 @@ function estimateTextTokens(text) {
 	return Math.ceil(text.length / 4);
 }
 /**
+* 有界并发池：最多 limit 个任务同时运行（limit 非法时按 1 处理），任务按 index 顺序
+* 取用，结果数组与 items 按 index 对齐（任务自身以返回值表达失败，不在此抛出）。
+* items 为空返回空数组。
+*/
+async function runWithConcurrency(items, limit, task) {
+	/** 结果数组（按 index 对齐）。 */
+	const results = new Array(items.length);
+	/** 下一个待处理任务的下标（worker 间共享取号）。 */
+	let next = 0;
+	/** worker 数量（clamp 到 [1, items.length]）。 */
+	const workerCount = Math.max(1, Math.min(Math.floor(limit), items.length));
+	/** 各 worker：循环取号执行任务直到取尽。 */
+	const workers = Array.from({ length: workerCount }, async () => {
+		while (next < items.length) {
+			/** 本 worker 领取的任务下标。 */
+			const index = next;
+			next += 1;
+			results[index] = await task(items[index], index);
+		}
+	});
+	await Promise.all(workers);
+	return results;
+}
+/**
 * 按 token 边界把完整消息序列分块（观察并行压缩用）：完整消息不跨块——
 * 一条完整消息（含其 thinking/text/toolcall&result 全部 seqs）必然整体落在同一块，
 * 单条超界的消息独立成块。空输入返回空数组。
@@ -8268,7 +8369,8 @@ async function reflectPass(ctx, agent, config, target, signal) {
 		expected: expectedEnd < 0 ? { start: 0 } : {
 			start: 0,
 			end: expectedEnd
-		}
+		},
+		rateLimitWaitMs: config.rateLimitWaitMs
 	});
 	if (summaryResult === null || summaryResult.text.trim().length === 0) {
 		logger.step("反思：摘要调用失败/无输出，追加 compaction/end(error)");
@@ -8366,7 +8468,7 @@ async function observePass(ctx, agent, config, tailCount, target, signal) {
 	logger.step(`观察：保留旧块 ${blocks.length} 条，替换新消息 [${replaceSeqs[0]}..${range.end}]（${replaceSeqs.length} 条），尾部保留 ${tailCount} 条（不压缩、不进日志），新消息 index ${startIndex}..${endIndex}`);
 	/** 按 observeChunkTokens 边界把完整消息分块（完整消息不跨块；每块独立并行压缩）。 */
 	const chunks = chunkCompleteMessages(session, inRangeCms, config.observeChunkTokens, (message) => ctx.tokenMeter.estimateMessage(message));
-	logger.step(`观察：${inRangeCms.length} 条完整消息按 ${config.observeChunkTokens} tokens 边界分为 ${chunks.length} 块（每块摘要 maxTokens ${config.observeChunkMaxTokens}，除最后一块外要求简单摘要）`);
+	logger.step(`观察：${inRangeCms.length} 条完整消息按 ${config.observeChunkTokens} tokens 边界分为 ${chunks.length} 块（最多 ${config.observeChunkParallelism} 块并行，每块摘要 maxTokens ${config.observeChunkMaxTokens}，除最后一块外要求简单摘要）`);
 	/** 本次压缩生命周期（compactionId + 当前轮次；start 在摘要调用前开启，UI 压缩中提示）。 */
 	const lifecycle = {
 		compactionId: newCompactionId(),
@@ -8381,8 +8483,8 @@ async function observePass(ctx, agent, config, tailCount, target, signal) {
 		logger.warn(`观察压缩启动失败: ${message}`);
 		return;
 	}
-	/** 各块摘要结果（Promise.all 并行；null = 该块失败）。 */
-	const chunkResults = await Promise.all(chunks.map(async (chunk, index) => {
+	/** 各块摘要结果（有界并发池，最多 observeChunkParallelism 块同时进行；null = 该块失败；结果按块顺序）。 */
+	const chunkResults = await runWithConcurrency(chunks, config.observeChunkParallelism, async (chunk, index) => {
 		/** 该块提示词（较早块简单摘要；最后一块越往后越细）。 */
 		const instruction = buildHistoryPrompt(index === chunks.length - 1 ? "detailed" : "summary");
 		/** 该块渲染输入（块内完整消息的 seqs；合法 <history> 块，含绝对 index）。 */
@@ -8395,9 +8497,10 @@ async function observePass(ctx, agent, config, tailCount, target, signal) {
 			expected: {
 				start,
 				end
-			}
+			},
+			rateLimitWaitMs: config.rateLimitWaitMs
 		});
-	}));
+	});
 	if (chunkResults.find((r) => r === null || r.text.trim().length === 0) !== void 0) {
 		logger.step("观察：分块摘要存在失败/无输出，不产生部分替换，追加 compaction/end(error)");
 		try {
@@ -8740,6 +8843,8 @@ const DEFAULT_CONFIG = Object.freeze({
 	compressMaxTokens: 1e4,
 	observeChunkTokens: 3e4,
 	observeChunkMaxTokens: 5e3,
+	observeChunkParallelism: 2,
+	rateLimitWaitMs: 6e4,
 	tailMessageCount: 10,
 	compressRetryCount: 10,
 	omEnabled: true,
@@ -8755,6 +8860,8 @@ const NUMBER_KEYS = [
 	["compressMaxTokens", true],
 	["observeChunkTokens", true],
 	["observeChunkMaxTokens", true],
+	["observeChunkParallelism", true],
+	["rateLimitWaitMs", true],
 	["tailMessageCount", true],
 	["compressRetryCount", true]
 ];
@@ -8804,6 +8911,21 @@ function resolveConfig(raw) {
 	return Object.freeze(config);
 }
 //#endregion
+//#region src/json-schema.ts
+/**
+* zod schema → 工具 wire 参数 JSON Schema 的转换工具。
+*
+* 官方 API（如 api.deepseek.com 的 /chat/completions）要求 tools[].function.parameters
+* 为根级带 type:'object' 的标准 JSON Schema；工具的参数定义统一由 zod 的 toJSONSchema
+* 生成，避免手写属性 map 与执行期解析 schema 双份定义漂移。剥除 $schema 元键与
+* additionalProperties：未知键不在 wire 层拒绝，执行期仍由 zod 解析剥离。
+*/
+/** 由 zod schema 生成 wire 参数 JSON Schema（根 type:'object'，含 properties/required 与 describe 描述）。 */
+function parametersFromZod(schema) {
+	const { $schema: _schema, additionalProperties: _additional, ...rest } = toJSONSchema(schema);
+	return rest;
+}
+//#endregion
 //#region src/recall.ts
 /**
 * recall 工具：按「完整消息」序号（index）回看原始会话（start/end 为完整消息 index，
@@ -8813,17 +8935,19 @@ function resolveConfig(raw) {
 * recall 自身不设输出上限：超大的工具结果由 tool-result-pruner 裁剪（pruneContent），
 * 输出 token 由 pruner 配置控制。
 *
-* 参数由 zod schema（recallArgsSchema）在 execute 入口校验：start 必填（number），
-* end/offset 至少提供一个；非法参数抛出可读错误。
+* 参数由 zod schema（recallArgsSchema）统一描述：wire 参数 JSON Schema（根 type:'object'，
+* 各字段描述来自 .describe()）直接发给模型，execute 入口再做运行时校验（start 必填；
+* end/offset 至少提供一个；非法参数抛出可读错误）。
 */
 /**
 * recall 工具参数 schema：start 必填（number）；end 与 offset 至少提供一个
 * （二者同时给出时 end 优先，与 execute 语义一致）；未知键自动剥离。
+* 各字段描述经 .describe() 透传到 wire JSON Schema（生成见 json-schema.ts）。
 */
 const recallArgsSchema = z.object({
-	start: z.number(),
-	end: z.number().optional(),
-	offset: z.number().optional()
+	start: z.number().describe("完整消息序号（index），作为基准边界，和 end 或 offset 配合，指定区间；end 与 offset 至少提供一个（同时给出时 end 优先）。"),
+	end: z.number().optional().describe("与 offset 互斥，指定区间的另一个边界。"),
+	offset: z.number().optional().describe("与 end 互斥。相对 start 的步数：正数向后、负数向前。")
 }).refine((args) => args.end !== void 0 || args.offset !== void 0, { message: "end 与 offset 至少提供一个" });
 /**
 * 解析并校验 recall 调用参数：校验失败时抛出首个校验问题的可读消息
@@ -8843,21 +8967,7 @@ function buildRecallTool(getPruner) {
 	return {
 		name: "recall",
 		description: `${COMPLETE_MESSAGE_DEFINITION}此工具可以精确查询完整消息。用index指定一个区间，返回区间内所有完整消息的内容。`,
-		parameters: {
-			start: {
-				type: "number",
-				description: "完整消息序号（index），作为基准边界，和end或offset配合，指定区间",
-				required: true
-			},
-			end: {
-				type: "number",
-				description: "与 offset 互斥，指定区间的另一个边界。"
-			},
-			offset: {
-				type: "number",
-				description: "与 end 互斥。相对 start 的步数：正数向后、负数向前。"
-			}
-		},
+		parameters: parametersFromZod(recallArgsSchema),
 		output: {
 			schema: { type: "string" },
 			render: (_args, value) => [{
@@ -8925,6 +9035,8 @@ function buildRecallTool(getPruner) {
 *
 * - 参数：query 必填；top_k（默认 3，1-10）；start/end/offset 限定检索区间
 *   （意义同 recall：start 为基准边界，end 与 offset 二选一；end 优先）。
+*   wire 参数 JSON Schema 由本 schema 经 toJSONSchema 生成（各字段描述来自 .describe()，
+*   见 json-schema.ts）。
 * - 区间缺省（start 未提供）→ 检索全部消息；区间不合法（start/end 越界等）→
 *   不报错，回退全量检索并在输出中明确告知（模型可见）。
 * - 向量：本地 ONNX embedding（embedding.ts，懒加载 + 批量）；相似度 = cosine。
@@ -8934,11 +9046,11 @@ function buildRecallTool(getPruner) {
 */
 /** recall-semantic 工具参数 schema：query 必填；top_k 默认 3（1-10）；区间参数均可选。 */
 const semanticRecallArgsSchema = z.object({
-	query: z.string(),
-	top_k: z.number().int().min(1).max(10).optional(),
-	start: z.number().optional(),
-	end: z.number().optional(),
-	offset: z.number().optional()
+	query: z.string().describe("描述要找的内容的自然语言 query（可混用中英文与代码术语，如 \"修复 retry backoff 的逻辑\"），不能为空。"),
+	top_k: z.number().int().min(1).max(10).optional().describe("返回最匹配的完整消息条数（1-10，默认 3）。"),
+	start: z.number().optional().describe("完整消息序号（index），可选。作为基准边界，和end或offset配合，指定搜索区间。"),
+	end: z.number().optional().describe("必须和start配合使用，与 offset 互斥，指定搜索区间的另一个边界。"),
+	offset: z.number().optional().describe("必须和start配合使用，与 end 互斥。相对 start 的步数：正数向后、负数向前。")
 }).refine((args) => args.query.trim().length > 0, { message: "query 不能为空" });
 /** 解析并校验参数：失败时抛出可读错误（普通 Error 而非 ZodError）。 */
 function parseSemanticRecallArgs(raw) {
@@ -9033,29 +9145,7 @@ function buildSemanticRecallTool(options) {
 	return {
 		name: "recall-semantic",
 		description: `${COMPLETE_MESSAGE_DEFINITION}此工具可以按自然语言含义，检索最符合的完整消息。默认在全消息范围搜索，可以指定区间。`,
-		parameters: {
-			query: {
-				type: "string",
-				description: "描述要找的内容的自然语言 query（可混用中英文与代码术语，如 \"修复 retry backoff 的逻辑\"）。",
-				required: true
-			},
-			top_k: {
-				type: "number",
-				description: "返回最匹配的完整消息条数（1-10，默认 3）。"
-			},
-			start: {
-				type: "number",
-				description: "完整消息序号（index），可选。作为基准边界，和end或offset配合，指定搜索区间。"
-			},
-			end: {
-				type: "number",
-				description: "必须和start配合使用，与 offset 互斥，指定搜索区间的另一个边界。"
-			},
-			offset: {
-				type: "number",
-				description: "必须和start配合使用，与 end 互斥。相对 start 的步数：正数向后、负数向前。"
-			}
-		},
+		parameters: parametersFromZod(semanticRecallArgsSchema),
 		output: {
 			schema: { type: "string" },
 			render: (_args, value) => [{

package/dist/json-schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * zod schema → 工具 wire 参数 JSON Schema 的转换工具。
+ *
+ * 官方 API（如 api.deepseek.com 的 /chat/completions）要求 tools[].function.parameters
+ * 为根级带 type:'object' 的标准 JSON Schema；工具的参数定义统一由 zod 的 toJSONSchema
+ * 生成，避免手写属性 map 与执行期解析 schema 双份定义漂移。剥除 $schema 元键与
+ * additionalProperties：未知键不在 wire 层拒绝，执行期仍由 zod 解析剥离。
+ */
+import { type $ZodType } from 'zod/v4/core';
+/** 由 zod schema 生成 wire 参数 JSON Schema（根 type:'object'，含 properties/required 与 describe 描述）。 */
+export declare function parametersFromZod<T extends $ZodType>(schema: T): Record<string, unknown>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAE1D,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIxF"}

package/dist/rate-limit.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 全局限流门（插件进程级共享状态）：任一摘要请求遇 429 限流后记录时间戳，
+ * 此后所有摘要请求在发出前先等待到「最近一次 429 + rateLimitWaitMs」之后——
+ * 并行压缩时其他块的下一次请求同样受限。等待期间 signal 中止则立即放弃。
+ *
+ * 门在进入时与等待结束时都会重读最近限流时间戳：等待期间发生新的 429 会顺延
+ * 冷却期（循环等待直到通过或中止）。
+ */
+/** 默认限流冷却时长（ms）：调用方未传 rateLimitWaitMs 时的兜底值（与配置默认一致）。 */
+export declare const RATE_LIMIT_WAIT_MS_DEFAULT = 60000;
+/**
+ * 判定错误信息是否为 429 限流：匹配 429（独立数字）或 rate limit（空格/连字符/
+ * 下划线分隔与 camelCase 均可），大小写不敏感。
+ */
+export declare function isRateLimitError(message: string): boolean;
+/** 记录一次 429 限流：把冷却期起点更新为当前时间。 */
+export declare function noteRateLimit(): void;
+/**
+ * 限流等待门：处于 429 冷却期（最近一次 429 + waitMs 未到）时等待到期限，
+ * 通过后返回 true；等待期间 signal 中止返回 false。未遇过限流或冷却期已过
+ * 立即放行。waitMs ≤ 0 视为不限流。
+ */
+export declare function gateRateLimit(waitMs: number, signal?: AbortSignal): Promise<boolean>;
+/** 重置限流门状态（仅测试使用：用例间隔离）。 */
+export declare function resetRateLimitGate(): void;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,iCAAiC;AACjC,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AA4BD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAW1F;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/recall.d.ts

@@ -6,14 +6,16 @@
  * recall 自身不设输出上限：超大的工具结果由 tool-result-pruner 裁剪（pruneContent），
  * 输出 token 由 pruner 配置控制。
  *
- * 参数由 zod schema（recallArgsSchema）在 execute 入口校验：start 必填（number），
- * end/offset 至少提供一个；非法参数抛出可读错误。
+ * 参数由 zod schema（recallArgsSchema）统一描述：wire 参数 JSON Schema（根 type:'object'，
+ * 各字段描述来自 .describe()）直接发给模型，execute 入口再做运行时校验（start 必填；
+ * end/offset 至少提供一个；非法参数抛出可读错误）。
  */
 import { z } from 'zod';
 import type { ToolDefinition } from './types.ts';
 /**
  * recall 工具参数 schema：start 必填（number）；end 与 offset 至少提供一个
  * （二者同时给出时 end 优先，与 execute 语义一致）；未知键自动剥离。
+ * 各字段描述经 .describe() 透传到 wire JSON Schema（生成见 json-schema.ts）。
  */
 export declare const recallArgsSchema: z.ZodObject<{
     start: z.ZodNumber;

package/dist/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAQzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAYxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CAoFzE"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;iBAYzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAYxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CAsEzE"}

package/dist/semantic-recall.d.ts

@@ -6,6 +6,8 @@
  *
  * - 参数：query 必填；top_k（默认 3，1-10）；start/end/offset 限定检索区间
  *   （意义同 recall：start 为基准边界，end 与 offset 二选一；end 优先）。
+ *   wire 参数 JSON Schema 由本 schema 经 toJSONSchema 生成（各字段描述来自 .describe()，
+ *   见 json-schema.ts）。
  * - 区间缺省（start 未提供）→ 检索全部消息；区间不合法（start/end 越界等）→
  *   不报错，回退全量检索并在输出中明确告知（模型可见）。
  * - 向量：本地 ONNX embedding（embedding.ts，懒加载 + 批量）；相似度 = cosine。

package/dist/semantic-recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO,KAAK,EAAmB,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGlF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;iBAUjC,CAAC;AAEL,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAWxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,GACzD,WAAW,CA2Bb;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,+CAA+C;AAC/C,eAAO,MAAM,gCAAgC,6HAAyB,CAAC;AAEvE,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD,GAAG,cAAc,CAqHjB"}
+{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG/F,OAAO,KAAK,EAAmB,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGlF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;iBA6BjC,CAAC;AAEL,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAWxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,GACzD,WAAW,CA2Bb;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,+CAA+C;AAC/C,eAAO,MAAM,gCAAgC,6HAAyB,CAAC;AAEvE,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD,GAAG,cAAc,CA8FjB"}

package/dist/summarize.d.ts

@@ -89,9 +89,13 @@ export declare const SUMMARY_DEFAULT_MAX_ATTEMPTS = 11;
  * 失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）均记录日志并重试，总共最多尝试
  * options.maxAttempts 次（默认 SUMMARY_DEFAULT_MAX_ATTEMPTS）；全部尝试失败返回 null
  * （不产生任何日志变更）。输出长度受 maxTokens 限制。
+ * 每次请求发出前先过全局限流等待门（gateRateLimit）：任一请求遇 429 后，后续所有
+ * 摘要请求（含并行中的其他调用方）在「最近一次 429 + options.rateLimitWaitMs」之前
+ * 不会发出（缺省 RATE_LIMIT_WAIT_MS_DEFAULT）。
  */
 export declare function runSummarySubagent(ctx: Context, agent: Agent, instruction: string, contextText: string | undefined, maxTokens: number, target: RoutedTarget, debug: boolean, signal?: AbortSignal, options?: {
     maxAttempts?: number;
     expected?: SummaryValidationRange;
+    rateLimitWaitMs?: number;
 }): Promise<SummarySubagentResult | null>;
 //# sourceMappingURL=summarize.d.ts.map

package/dist/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAAE,KAAK,EAAmB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAiDxE;AA0CD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAqEhF;AAED,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AA8EF,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,yrBAA6K,CAAC;AAE9M,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoFF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAYrE;AACD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBvC;AAED,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAiC/F;AACD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAK/C;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAA;CAAE,GACpE,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA+EvC"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmBH,OAAO,KAAK,EAAE,KAAK,EAAmB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAiDxE;AA0CD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAqEhF;AAED,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AA8EF,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,yrBAA6K,CAAC;AAE9M,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoFF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAYrE;AACD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBvC;AAED,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAiC/F;AACD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAK/C;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9F,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAgGvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-om",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",