npm - dsh-plugin-om - Versions diffs - 0.0.26 → 0.0.27 - Mend

dsh-plugin-om 0.0.26 → 0.0.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/README.md +62 -64
package/dist/compaction-log.d.ts +21 -21
package/dist/compaction-log.d.ts.map +1 -1
package/dist/compress.d.ts +3 -3
package/dist/compress.d.ts.map +1 -1
package/dist/config.d.ts +2 -0
package/dist/config.d.ts.map +1 -1
package/dist/index.mjs +115 -83
package/dist/summarize.d.ts +24 -13
package/dist/summarize.d.ts.map +1 -1
package/dist/types.d.ts +3 -3
package/dist/types.d.ts.map +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -2,36 +2,33 @@
 [![npm version](https://img.shields.io/npm/v/dsh-plugin-om.svg)](https://www.npmjs.com/package/dsh-plugin-om)
-在 DSH 里应用 [Observational Memory](https://mastra.ai/research/observational-memory) 风格的上下文管理策略：自动把历史消息压缩为摘要，并提供工具回看原始内容。
+在 DSH 里应用 [Observational Memory](https://mastra.ai/research/observational-memory) 风格的上下文管理：自动把历史消息压缩为摘要并提供工具回看原始内容。
 ## 功能
-- **自动压缩**（仅主会话，`agent/pre-step` 时阻塞串行执行）：
-  - **观察**：净压力（上下文压力 − 已压缩 `<history>` 块 token 估算合计 − 系统提示词 token 估算 − 工具定义 token 估算）首次 ≥ `observeThresholdTokens` 时记录待定标记（触发点 = 当时的最后一条完整消息），本次不压缩；待定后新增完整消息数达到 `tailMessageCount` 时，摘要压缩边界至触发点的全部消息并追加为新 `<history>` 块，精确替换被压缩的消息区间（旧块保留，等待期消息成为新的未压缩尾部）。待定标记以 log-only `om/observe-pending` / `om/observe-invalidate` 会话事件持久化（重启后从日志恢复），摘要失败保留待定、下个 pre-step 直接重试；`tailMessageCount=0` 时触发当轮立即执行
-  - **反思**：全部 `<history>` 块 token 合计 ≥ `reflectThresholdTokens` 时，把多个摘要块合并为一条更紧凑的摘要
-  - **输出容错**：摘要输出按首个 `<history>` 开标签到最后一个 `</history>` 定位；整块 XML 非法时按条目标签模糊提取并重建为合法块，再校验无 reasoning 与 index 连续
-  - **失败中断**：摘要尝试全部耗尽后拒绝当前 step（当前 turn 以 blocked 结束，不再继续 AI 会话；signal 中止除外），最后一次尝试的实际报错与诊断子会话 sessionId 写入日志与 `compaction/end` error
-  - **失败诊断落盘**：摘要最终失败（含 signal 中止）时，把每次尝试的完整提示词与模型原始输出原样落盘为一个 one-shot 诊断子会话（`subagent/descriptor` 标记、以 subagent 形式出现在宿主子代理列表中；内容零加工、无额外消息），sessionId 随失败结果进主会话日志与 `compaction/end` error 载荷
-  - **降级容错**：挂载失败类问题（systemPrompt 服务缺失、tokenMeter 服务异常）不阻塞压缩——systemPrompt 按 0 计、tokenMeter 计价按 0 计或跳过观察；问题始终 `console.warn` 输出到宿主进程外部，并写入 log-only `om/warning` 会话事件（同会话同一问题至多一条）。系统提示词/工具定义估算的普通运行时报错仅记日志，同样按 0 计
-- **recall 工具**：按完整消息 index 区间回看原始会话（含被压缩内容；命中消息中的图片附件随结果保留）
-- **recall-semantic 工具**：本地嵌入模型（paraphrase-multilingual-MiniLM-L12-v2）按语义检索全部完整消息（只匹配文本，纯图片消息不进候选池）
-- **压缩卡片**：浏览器客户端在消息列表渲染折叠式「已压缩」卡片、「正在压缩上下文（观察/反思）…」提示行与可展开的「上下文压缩失败」错误行
-- **降级警告行**：浏览器客户端把 `om/warning` 事件渲染为可展开的「上下文压缩功能降级」警告行（折叠摘要 + 完整说明展开）
+- **自动压缩**：仅主会话，在 agent/pre-step 阻塞串行执行。净压力达到 `observeThresholdTokens` 后再累计 `tailMessageCount` 条完整消息时，把触发点前的全部消息摘要为新 `<history>` 块并精确替换对应消息区间；全部 `<history>` 块 token 合计达到 `reflectThresholdTokens` 时把全部块内文拼合为单个 `<history>` 块送入摘要，合并为一条更紧凑的摘要。待定标记以 log-only 会话事件持久化，重启后从日志恢复
+- **输出容错**：摘要输出按 `<history>` 标签定位，整块非法时按条目标签模糊提取并重建为合法块。重试全部耗尽后拒绝当前 step；每次实际发出的摘要调用无论成功失败都把完整提示词与模型原始输出即时落盘为 one-shot 诊断子会话
+- **降级容错**：systemPrompt 或 tokenMeter 服务异常时按 0 计继续压缩，问题通过 console 输出与 log-only `om/warning` 会话事件上报，同会话同一问题至多一条
+- **recall 工具**：按完整消息 index 区间回看原始会话，含被压缩内容，图片附件随结果保留
+- **recall-semantic 工具**：本地嵌入模型 paraphrase-multilingual-MiniLM-L12-v2 按语义检索全部完整消息，只匹配文本，纯图片消息不进候选池
+- **压缩卡片**：浏览器客户端渲染折叠式已压缩卡片、压缩中提示行与可展开的失败错误行
+- **降级警告行**：浏览器客户端把 `om/warning` 事件渲染为可展开的警告行
 ## 安装与启用
-- `$DSH_HOME` 缺省为 `~/.dsh`；*profile* 描述 dsh 进程的启动模式（官方启动命令即名为 `web` 的 profile）
+`$DSH_HOME` 缺省为 `~/.dsh`，profile 描述 dsh 进程的启动模式。
 ```sh
 dsh plugin --profile <profile> add dsh-plugin-om
 ```
-安装完成后重启 dsh；可用 `dsh --profile <profile> --dump-config` 审查配置。
+安装完成后重启 dsh，可用 `dsh --profile <profile> --dump-config` 审查配置。
-> pnpm 11+ 默认禁止依赖构建脚本，安装失败时把 `$DSH_HOME/profiles/<profile>/pnpm-workspace.yaml` 的 `allowBuilds` 改为 `true`，或使用
-> `dsh plugin --profile <profile> add dsh-plugin-om --allow-build=onnxruntime-node --allow-build=protobufjs --allow-build=sharp`
+> pnpm 11+ 默认禁止依赖构建脚本，安装失败时把 `$DSH_HOME/profiles/<profile>/pnpm-workspace.yaml` 的 `allowBuilds` 改为 `true`，或安装时追加 `--allow-build=onnxruntime-node --allow-build=protobufjs --allow-build=sharp`
-覆盖默认配置：编辑 `$DSH_HOME/profiles/<profile>/cordis.patch.yml`，删除空数组并加入（可热更新）：
+### 配置覆盖
+编辑 `$DSH_HOME/profiles/<profile>/cordis.patch.yml`，删除空数组并加入，可热更新：
 ```yaml
 - id: dsh-plugin-om
@@ -41,7 +38,7 @@ dsh plugin --profile <profile> add dsh-plugin-om
 ### 开发插件
-运行 `pnpm dev` 构建（本地嵌入模型运行时自动下载，也可 `pnpm run download:model` 预下载），在 `cordis.patch.yml` 加入（可热重载）：
+运行 `pnpm dev` 构建，本地嵌入模型运行时自动下载，也可 `pnpm run download:model` 预下载。在 `cordis.patch.yml` 加入，可热重载：
 ```yaml
 - insert:
@@ -51,27 +48,28 @@ dsh plugin --profile <profile> add dsh-plugin-om
 ### 与 compaction-basic 的关系
-preset-agent 自带 `compaction-basic` 压缩，也会压缩上下文，其压缩阈值为 80% 上下文窗口，一般会先用om进行压缩。
+preset-agent 自带 compaction-basic 压缩，阈值为上下文窗口的 80%，一般先用 om 进行压缩。
 ## 插件配置项
 | 键 | 默认 | 含义 |
 | --- | --- | --- |
-| `observeThresholdTokens` | `45000` | 观察阈值（tokens）：净压力（上下文压力 − 已压缩块 − 系统提示词估算 − 工具定义估算）≥ 该值时触发观察压缩 |
-| `reflectThresholdTokens` | `120000` | 反思阈值（tokens）：全部 `<history>` 块 token 合计 ≥ 该值时触发合并 |
-| `compressMaxTokens` | 不设置 | 单次摘要生成上限（不设置时由模型适配器默认值决定） |
-| `rateLimitWaitMs` | `60000` | 遇 429 限流后下一次摘要请求前的等待毫秒数（全局冷却期；`0` 不限流） |
-| `tailMessageCount` | `5` | 观察触发后延迟执行的等待完整消息条数（新增完整消息数达到该值才执行压缩；`0` 表示触发当轮立即执行） |
-| `compressRetryCount` | `5` | 摘要失败后的最大重试次数（不含首次） |
-| `modelDir` | 共享目录 | recall-semantic 嵌入模型目录（默认 `$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>`，onnx 缺失且启用语义召回时运行时自动下载） |
-| `omEnabled` | `true` | 是否启用自动压缩（`false` 时关闭，recall 工具不受影响） |
-| `debug` | dev | 步骤级日志开关（缺省按 `NODE_ENV !== 'production'` 判定；每次压缩尝试的结果/报错与失败日志始终输出） |
+| `observeThresholdTokens` | `45000` | 净压力达到该值时触发观察压缩 |
+| `reflectThresholdTokens` | `120000` | 全部 `<history>` 块 token 合计达到该值时触发反思合并 |
+| `compressMaxTokens` | 不设置 | 单次摘要生成上限，不设置时由模型适配器默认值决定 |
+| `rateLimitWaitMs` | `60000` | 遇 429 限流后下一次摘要请求前的等待毫秒数，`0` 不限流 |
+| `tailMessageCount` | `5` | 观察触发后等待新增完整消息达到该条数才执行压缩，`0` 表示触发当轮立即执行 |
+| `compressRetryCount` | `5` | 摘要失败后的最大重试次数，不含首次 |
+| `compressSkipReasoning` | `true` | 观察压缩请求是否携带被压缩 assistant 消息的 reasoning 思考文本，`true` 时不携带 `<reasoning>` 参考条目，压缩指令同步省略对应说明 |
+| `modelDir` | 共享目录 | recall-semantic 嵌入模型目录，默认 `$DSH_HOME/plugin-data/dsh-plugin-om/models/<id>`，onnx 缺失且启用语义召回时运行时自动下载 |
+| `omEnabled` | `true` | 是否启用自动压缩，关闭后 recall 工具不受影响 |
+| `debug` | dev | 步骤级日志开关，缺省按 `NODE_ENV` 非 production 判定，压缩尝试结果与失败日志始终输出 |
 | `recallEnabled` | `true` | 是否注册 `recall` 工具 |
-| `semanticRecallEnabled` | `true` | 是否注册 `recall-semantic` 工具（`false` 时不注册、不触发模型下载） |
+| `semanticRecallEnabled` | `true` | 是否注册 `recall-semantic` 工具，关闭时不触发模型下载 |
 > 不建议把观察阈值设置得过高：越早压缩收益越高，且机制依赖模型对消息计数，过多消息会导致历史混乱。
-> 想直观理解机制并估算不同参数下的 token 成本，可打开交互式[机制说明与成本计算器](https://fanethedivine.github.io/dsh-plugin-om/)（部署在 GitHub Pages，不随插件包分发）：右侧参数侧边栏（滑块 + 数字输入联动）+ 居中的合并单元格成本表（每格显示 om 关闭红 / om 开启绿），可调节系统提示词、dsh 注入消息、阈值、压缩比与三类 token 价格，对比 20k–250k 原始会话规模下启用 om 的 token 消耗量与费用。
+> 想直观理解机制并估算不同参数下的 token 成本，可打开交互式[机制说明与成本计算器](https://fanethedivine.github.io/dsh-plugin-om/)，部署在 GitHub Pages，不随插件包分发。
 ## npm 命令
@@ -81,45 +79,45 @@ preset-agent 自带 `compaction-basic` 压缩，也会压缩上下文，其压
 | `pnpm typecheck` | TypeScript 类型检查 |
 | `pnpm lint` / `pnpm format` | 代码检查 / 格式化 |
 | `pnpm test` | vitest 单元测试 |
-| `pnpm run download:model` | 手动预下载嵌入模型（已存在跳过，`--force` 重下） |
+| `pnpm run download:model` | 手动预下载嵌入模型，已存在跳过，`--force` 重下 |
 | `pnpm build` / `pnpm dev` | 构建 / 自动打包 |
 | `pnpm run release` | check → CHANGELOG 归档 → 版本号更新 → 打 tag 推送 |
 ## 文件地图
 ```
-cordis.patch.yml               # bundle patch：dsh plugin add 后作为组合层插入插件行
+cordis.patch.yml                 # bundle patch，dsh plugin add 后作为组合层插入插件行
 src/
-├── index.ts                   # 打包入口：注册 recall 工具 + 接线 pre-step 自动压缩
-├── config.ts                  # 配置默认值与宽松合并（未知键忽略、非法值回退默认）
-├── constants.ts               # 共享常量（插件标识 / history 标签 / 完整消息定义）
-├── degrade.ts                 # 挂载失败降级上报（console 外部输出 + om/warning 会话事件，每会话去重）
-├── types.ts                   # type-only：宿主类型再导出 + 领域类型
-├── utils.ts                   # 零依赖工具函数（文本渲染 / 主会话判定 / 路由解析）
-├── logger.ts                  # 插件日志门面（step 按 debug 开关过滤）
-├── rate-limit.ts              # 全局 429 限流冷却门（进程级共享状态）
-├── log-index.ts               # 完整消息索引与渲染（recall 与摘要共用同一套编号）
-├── recall.ts                  # recall 工具：按完整消息 index 区间回看
-├── recall-output.ts           # recall 输出契约：{ text, images } 与 render 投影
-├── semantic-recall.ts         # recall-semantic 工具：本地嵌入语义检索
-├── embedding.ts               # 本地 ONNX 嵌入（懒加载 / 批量 / 运行时按需下载编排）
-├── model-download.ts          # 模型下载原语（URL / 跳过判定 / 原子落盘）
-├── summarize.ts               # 共享压缩提示词 + <history> 块渲染与输出校验 + 摘要调用
-├── compaction-log.ts          # 压缩失败诊断落盘（诊断子会话创建 + descriptor + 逐尝试原样消息组）
-├── compress.ts                # 两级自动压缩（观察/反思）、失败中断传播与 compaction 生命周期事件
-└── client/                    # 浏览器客户端 bundle（压缩卡片）
-    ├── index.ts               # 客户端入口：注册卡片定义与渲染器
-    ├── definition.ts          # 压缩卡片业务定义（认领生命周期事件、替换检查点与 om/warning）
-    ├── OmCompactionCard.tsx   # 折叠卡片渲染器（统计标题 + summary/失败报错展开）
-    ├── OmWarningCard.tsx      # 功能降级警告行渲染器（折叠摘要 + 完整说明展开）
-    ├── format.ts              # 统计数字紧凑格式化（k/w/M）
-    └── locales.ts             # om-compaction 文案字典（zh/en）
-models/                        # 嵌入模型目录（小文件随包分发；onnx 运行时按需下载，不进 git）
-scripts/                       # release-archive.mjs（CHANGELOG 归档）/ download-model.mjs（预下载 CLI）
-tests/                         # vitest 测试（服务端各模块 + tests/client/ 客户端卡片 + tests/web/ 成本模型 + 整条链路集成测试）
-web/                           # 机制说明与成本计算器站点（独立 Vite + React + Tailwind CSS + shadcn/ui 工程，发布到 GitHub Pages，不随插件包分发）
-    ├── src/model.ts           # 成本模型纯函数（om 开/关全会话模拟与三类 token 计价）
-    └── src/components/        # 机制简述（观察/反思/dsh注入） / 侧边栏参数面板（滑块+input） / 合并单元格成本表 / shadcn/ui 原语
-.github/workflows/web-deploy.yml  # web/ 变更合入 main 时构建并部署 GitHub Pages
+├── index.ts                     # 打包入口：注册 recall 工具并接线 pre-step 自动压缩
+├── config.ts                    # 配置默认值与宽松合并，未知键忽略、非法值回退默认
+├── constants.ts                 # 共享常量：插件标识、history 标签、完整消息定义
+├── degrade.ts                   # 挂载失败降级上报：console 外部输出与 om/warning 会话事件
+├── types.ts                     # type-only：宿主类型再导出与领域类型
+├── utils.ts                     # 零依赖工具函数：文本渲染、主会话判定、路由解析
+├── json-schema.ts               # zod schema 到工具 wire 参数 JSON Schema 的转换
+├── logger.ts                    # 插件日志门面，step 按 debug 开关过滤
+├── rate-limit.ts                # 全局 429 限流冷却门，进程级共享状态
+├── log-index.ts                 # 完整消息索引与渲染，recall 与摘要共用同一套编号
+├── recall.ts                    # recall 工具：按完整消息 index 区间回看
+├── recall-output.ts             # recall 输出契约：{ text, images } 与 render 投影
+├── semantic-recall.ts           # recall-semantic 工具：本地嵌入语义检索
+├── embedding.ts                 # 本地 ONNX 嵌入：懒加载、批量、运行时按需下载编排
+├── model-download.ts            # 模型下载原语：URL、跳过判定、原子落盘
+├── summarize.ts                 # 共享压缩提示词、history 块渲染与输出校验、摘要调用
+├── compaction-log.ts            # 压缩日志落盘：诊断子会话创建与单次尝试原样消息组
+├── compress.ts                  # 两级自动压缩：观察与反思、失败中断传播、compaction 生命周期事件
+└── client/                      # 浏览器客户端 bundle：压缩卡片
+    ├── index.ts                 # 客户端入口：注册卡片定义与渲染器
+    ├── definition.ts            # 压缩卡片业务定义：认领生命周期事件、检查点替换与 om/warning
+    ├── OmCompactionCard.tsx     # 折叠卡片渲染器：统计标题与 summary、失败报错展开
+    ├── OmWarningCard.tsx        # 功能降级警告行渲染器：折叠摘要与完整说明展开
+    ├── format.ts                # 统计数字紧凑格式化：k、w、M
+    └── locales.ts               # om-compaction 文案字典：zh 与 en
+models/                          # 嵌入模型目录：小文件随包分发，onnx 运行时按需下载，不进 git
+scripts/                         # release-archive.mjs 为 CHANGELOG 归档脚本，download-model.mjs 为预下载 CLI
+tests/                           # vitest 测试：服务端各模块、客户端卡片、成本模型与整条链路集成测试
+web/                             # 机制说明与成本计算器站点：独立 Vite + React + Tailwind CSS + shadcn/ui 工程，发布到 GitHub Pages，不随插件包分发
+    ├── src/model.ts             # 成本模型纯函数：om 开关全会话模拟与三类 token 计价
+    └── src/components/          # 机制简述、侧边栏参数面板、合并单元格成本表、shadcn/ui 原语
+.github/workflows/web-deploy.yml # web/ 变更合入 main 时构建并部署 GitHub Pages
 ```

package/dist/compaction-log.d.ts CHANGED Viewed

@@ -1,42 +1,42 @@
 /**
- * 压缩失败诊断落盘：摘要 run 最终失败时，把每次尝试的完整提示词与模型原始输出
- * 原样落盘为一个 one-shot 诊断子会话（header origin 'subagent' + 首事件
- * subagent/descriptor），使其以 subagent 形式出现在宿主子代理列表中，便于查看
- * 失败调用的完整会话。导出 recordCompactionFailure / SummaryAttemptRecord /
- * compactionLogLabel / COMPACTION_LOG_PROVIDER。
+ * 压缩调用日志落盘：摘要 run 的每次 LLM 调用（每次尝试，无论成功失败）完成后，
+ * 把该次尝试的完整提示词与模型原始输出原样落盘为一个 one-shot 诊断子会话
+ * （header origin 'subagent' + 首事件 subagent/descriptor），使其以 subagent 形式
+ * 出现在宿主子代理列表中，便于查验每次调用的完整会话。导出 recordCompactionAttempt /
+ * SummaryAttemptRecord / compactionLogLabel / COMPACTION_LOG_PROVIDER。
  *
- * - 子会话内容零加工：每次尝试一对 user/message（实际提示词全文，含 <history> 块）
+ * - 子会话内容零加工：一对 user/message（实际提示词全文，含 <history> 块）
  *   + assistant/message（模型原始输出全文，异常/中止时为已收集的部分输出），
- *   不插入任何额外消息；失败原因不进子会话，走主会话日志与 compaction/end error 载荷
- * - 失败原因与诊断子会话 sessionId 由调用方写入主会话日志（compress.ts / index.ts）
- * - 落盘自身绝不抛错：任何失败仅 logger.warn 并返回 undefined，不影响压缩失败流程
+ *   不插入任何额外消息；成败与原因不进子会话，由调用方写入主会话日志并关联子会话 id
+ * - 落盘自身绝不抛错：任何失败仅 logger.warn 并返回 undefined，不影响压缩流程
  */
 import type { Context, Session } from './types.ts';
 import { type RoutedTarget } from './utils.ts';
 /** 诊断子会话的 descriptor provider（宿主子代理列表识别用）。 */
 export declare const COMPACTION_LOG_PROVIDER = "om-compaction-log";
-/** 一次失败摘要尝试的完整记录：prompt=实际提示词全文（含 <history> 块），rawOutput=模型原始输出全文。 */
+/** 一次摘要尝试的完整记录：prompt=实际提示词全文（含 <history> 块），rawOutput=模型原始输出全文。 */
 export type SummaryAttemptRecord = {
     prompt: string;
     rawOutput: string;
 };
-/** 诊断子会话 label：含压缩阶段与尝试次数。 */
-export declare function compactionLogLabel(phase: 'observe' | 'reflect' | undefined, attemptCount: number): string;
+/** 诊断子会话 label：含压缩阶段与尝试序号。 */
+export declare function compactionLogLabel(phase: 'observe' | 'reflect' | undefined, attemptNo: number): string;
 /**
- * 把一次最终失败的摘要 run 落盘为诊断子会话：ctx.sessions.create 创建子会话
- * （header origin 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、
- * cwd 继承主会话），追加 one-shot descriptor（provider om-compaction-log，label 含
- * 压缩阶段与尝试次数），逐尝试原样追加「提示词 + 原始输出」消息组，flush 持久化
- * 检查点，返回子会话 id。落盘自身绝不抛错：任何失败仅 logger.warn 并返回
- * undefined（不影响压缩失败流程）。
+ * 把一次摘要尝试落盘为诊断子会话：ctx.sessions.create 创建子会话（header origin
+ * 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、cwd 继承主会话），
+ * 追加 one-shot descriptor（provider om-compaction-log，label 含压缩阶段与尝试序号），
+ * 原样追加「提示词 + 原始输出」消息组，flush 持久化检查点，返回子会话 id。落盘自身
+ * 绝不抛错：任何失败仅 logger.warn 并返回 undefined（不影响压缩流程）。
  */
-export declare function recordCompactionFailure(ctx: Context, parentSession: Session, options: {
+export declare function recordCompactionAttempt(ctx: Context, parentSession: Session, options: {
     /** 压缩 pass（诊断子会话 label 用）。 */
     phase: 'observe' | 'reflect' | undefined;
     /** 摘要调用的路由目标（assistant/message 的 model 来源标记）。 */
     target: RoutedTarget;
-    /** 逐尝试的完整记录（提示词 + 原始输出；中止在首次请求前时为空）。 */
-    attempts: readonly SummaryAttemptRecord[];
+    /** 本次尝试的完整记录（提示词 + 原始输出）。 */
+    attempt: SummaryAttemptRecord;
+    /** 尝试序号（1 起，label 与消息 step 标注用）。 */
+    attemptNo: number;
     /** 插件 debug 开关（落盘失败的 warn 是否带步骤细节）。 */
     debug: boolean;
 }): Promise<string | undefined>;

package/dist/compaction-log.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"compaction-log.d.ts","sourceRoot":"","sources":["../src/compaction-log.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;;;GAYG~~;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAE3D,~~sEAAsE~~;~~AACtE~~,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AASzE,8BAA8B;AAC9B,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EACxC,~~YAAY~~,EAAE,MAAM,~~GACnB~~,MAAM,CAER;AA8BD~~;;;;;;;GAOG~~;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE;IACP,8BAA8B;IAC9B,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,iDAAiD;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,~~wCAAwC~~;~~IACxC~~,~~QAAQ~~,EAAE,SAAS,~~oBAAoB,~~EAAE,CAAC;~~IAC1C~~,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,~~CAmC7B~~"}
1	+ {"version":3,"file":"compaction-log.d.ts","sourceRoot":"","sources":["../src/compaction-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAE3D,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AASzE,8BAA8B;AAC9B,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AA8BD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE;IACP,8BAA8B;IAC9B,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,iDAAiD;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,6BAA6B;IAC7B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+B7B"}

package/dist/compress.d.ts CHANGED Viewed

@@ -55,9 +55,9 @@ export declare function findObservePending(session: Session): {
     triggerMessageIndex: number;
 } | undefined;
 /**
- * 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，摘要调用把整个块
- * 区段合并替换为一条更紧凑的摘要。失败不产生部分替换；摘要尝试全部耗尽返回
- * 失败结果（error = 最后一次尝试的实际报错/具体问题）。
+ * 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，全部块内文拼合为
+ * 单个 <history> 块送入摘要调用，整个块区段合并替换为一条更紧凑的摘要。失败不产生
+ * 部分替换；摘要尝试全部耗尽返回失败结果（error = 最后一次尝试的实际报错/具体问题）。
  */
 export declare function reflectPass(ctx: Context, agent: Agent, config: Readonly<PluginConfig>, target: RoutedTarget, signal?: AbortSignal): Promise<CompressPassResult>;
 /**

package/dist/compress.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"~~AAuCA~~,OAAO,KAAK,EACV,KAAK,EAKL,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;~~AA4CD~~;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAY1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,MAAM,GACtB;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,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAmB1D;AA0HD;;;;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,kBAAkB,CAAC,CAgI7B;AAwED;;;;;;;;;GASG;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,kBAAkB,CAAC,CAwO7B;AAED;;;;GAIG;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,kBAAkB,CAAC,CAwB7B"}
1	+ {"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EACV,KAAK,EAKL,OAAO,EACP,YAAY,EACZ,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAgB,KAAK,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEhG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAuDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAY1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,MAAM,GACtB;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,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAmB1D;AA0HD;;;;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,kBAAkB,CAAC,CAgI7B;AAwED;;;;;;;;;GASG;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,kBAAkB,CAAC,CAwO7B;AAED;;;;GAIG;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,kBAAkB,CAAC,CAwB7B"}

package/dist/config.d.ts CHANGED Viewed

@@ -12,6 +12,8 @@ export type PluginConfig = {
     tailMessageCount: number;
     /** 摘要失败后的最大重试次数（不含首次）。 */
     compressRetryCount: number;
+    /** 压缩输入是否携带被压缩消息的 reasoning 思考文本（true 时压缩请求不含 <reasoning> 参考条目，压缩提示词也省略其说明）。 */
+    compressSkipReasoning: boolean;
     /** 是否启用自动压缩（观察/反思）。 */
     omEnabled: boolean;
     /** 步骤级日志开关（缺省按 NODE_ENV !== 'production' 判定）。 */

package/dist/config.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,~~CAYhD~~,CAAC;AAqCH,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,~~CAoBnE~~"}
1	+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAahD,CAAC;AAqCH,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAqBnE"}

package/dist/index.mjs CHANGED Viewed

@@ -7482,9 +7482,9 @@ function phaseLabel(phase) {
 	if (phase === "reflect") return "反思";
 	return "压缩";
 }
-/** 诊断子会话 label：含压缩阶段与尝试次数。 */
-function compactionLogLabel(phase, attemptCount) {
-	return `OM 压缩失败日志（${phaseLabel(phase)} · ${attemptCount} 次尝试）`;
+/** 诊断子会话 label：含压缩阶段与尝试序号。 */
+function compactionLogLabel(phase, attemptNo) {
+	return `OM 压缩日志（${phaseLabel(phase)} · 第 ${attemptNo} 次尝试）`;
 }
 /** 追加一次尝试的「提示词 → 原始输出」消息组（surfaceOp append；id 为品牌类型，session.append 运行时校验）。 */
 function appendAttemptMessages(child, attempt, step, target) {
@@ -7521,14 +7521,13 @@ function appendAttemptMessages(child, attempt, step, target) {
 	}, { surfaceOp: "append" });
 }
 /**
-* 把一次最终失败的摘要 run 落盘为诊断子会话：ctx.sessions.create 创建子会话
-* （header origin 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、
-* cwd 继承主会话），追加 one-shot descriptor（provider om-compaction-log，label 含
-* 压缩阶段与尝试次数），逐尝试原样追加「提示词 + 原始输出」消息组，flush 持久化
-* 检查点，返回子会话 id。落盘自身绝不抛错：任何失败仅 logger.warn 并返回
-* undefined（不影响压缩失败流程）。
+* 把一次摘要尝试落盘为诊断子会话：ctx.sessions.create 创建子会话（header origin
+* 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、cwd 继承主会话），
+* 追加 one-shot descriptor（provider om-compaction-log，label 含压缩阶段与尝试序号），
+* 原样追加「提示词 + 原始输出」消息组，flush 持久化检查点，返回子会话 id。落盘自身
+* 绝不抛错：任何失败仅 logger.warn 并返回 undefined（不影响压缩流程）。
 */
-async function recordCompactionFailure(ctx, parentSession, options) {
+async function recordCompactionAttempt(ctx, parentSession, options) {
 	const logger = makeLogger(ctx, options.debug);
 	try {
 		const header = parentSession.header;
@@ -7542,23 +7541,19 @@ async function recordCompactionFailure(ctx, parentSession, options) {
 			version: SUBAGENT_DESCRIPTOR_VERSION,
 			mode: "one-shot",
 			provider: COMPACTION_LOG_PROVIDER,
-			label: compactionLogLabel(options.phase, options.attempts.length)
+			label: compactionLogLabel(options.phase, options.attemptNo)
 		});
-		for (let i = 0; i < options.attempts.length; i += 1) {
-			const attempt = options.attempts[i];
-			if (attempt === void 0) continue;
-			appendAttemptMessages(child, attempt, i + 1, options.target);
-		}
+		appendAttemptMessages(child, options.attempt, 1, options.target);
 		try {
 			await ctx.sessions.flush(child);
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
-			logger.warn(`压缩失败诊断子会话 flush 失败（子会话 ${child.id} 已创建）: ${message}`);
+			logger.warn(`压缩日志子会话 flush 失败（子会话 ${child.id} 已创建）: ${message}`);
 		}
 		return child.id;
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
-		logger.warn(`压缩失败诊断子会话落盘失败: ${message}`);
+		logger.warn(`压缩日志子会话落盘失败（第 ${options.attemptNo} 次尝试）: ${message}`);
 		return;
 	}
 }
@@ -7621,8 +7616,10 @@ async function gateRateLimit(waitMs, signal) {
 /**
 * 共享压缩提示词（观察/反思同一套）：定义 history 块（模型消息 + index 的表达形式）、
 * 完整消息定义、压缩要求、输出格式与数据源说明。
+* skipReasoning=true（默认，与 compressSkipReasoning 默认一致）时压缩输入不含
+* <reasoning> 参考条目，提示词相应省略 <reasoning> 的说明两行。
 */
-function buildHistoryPrompt() {
+function buildHistoryPrompt(skipReasoning = true) {
 	return [
 		"压缩 <history> 消息记录。你应当输出**单个**合法的 <history> 块。",
 		"",
@@ -7630,17 +7627,18 @@ function buildHistoryPrompt() {
 		"- <history> 是历史消息的记录块。",
 		"- <user_message index=\"N\">：用户消息条目。",
 		"- <sys type=\"(kind)\" index=\"N\">：系统消息条目。",
-		"- <reasoning>：模型的思考过程，仅作压缩参考，产物中不要出现。",
+		...skipReasoning ? [] : ["- <reasoning>：模型的思考过程，仅作压缩参考，产物中不要出现。"],
 		"- <assistant index=\"N\">：单条完整消息（模型输出文本，或 toolcall 及其 result）。",
 		"- <assistant start=\"A\" end=\"B\">：多条连续完整消息聚合的模块（A/B 为模块首尾完整消息的 index）。",
 		"",
 		"【压缩要求】",
 		"- <user_message> <sys> 条目从输入中逐条保留，不做任何处理。",
-		"- <reasoning> 只作参考，输出产物中不包含 <reasoning> 块。",
-		"- 将具有关联性的 <assistant> 消息按内在逻辑连贯性划分为连续模块，聚合为 <assistant start=\"\" end=\"\"> 块：块内描述模块的目的、行为与结果；涉及的具体文件保留在模块内容中，多个前缀相同的路径合并简写。",
-		"- 单条重要的完整消息以 <assistant index=\"\"> 单独呈现，内容不受限制。",
+		...skipReasoning ? [] : ["- <reasoning> 只作参考，输出产物中不包含 <reasoning> 块。"],
+		"- 将具有关联性的 <assistant> 消息按内在逻辑连贯性划分为连续模块，聚合为 <assistant start=\"\" end=\"\"> 块",
+		"- 单条重要的完整消息以 <assistant index=\"\"> 单独呈现",
+		"- 压缩后的 <assistant> 块内，应当描述**行为逻辑**，强调关键的**结论、产出和任务**；涉及到的具体文件保留完整路径",
 		"- 加载的 skill 属于**关键信息**：应当产出独立块且不过多省略。",
-		"- 条目按 index 顺序覆盖本次压缩的全部完整消息：index/start/end 必须连续（区间内 index 连续、相邻条目相接），不跳号、不重叠、不遗漏。",
+		"- 压缩后的消息，区间边界与输入的消息必须完全相同，内部 index/start/end 必须连续，相邻区间的左右界必须相邻，",
 		"",
 		"【摘要粒度】",
 		"- 越往后越细：靠近末尾（最近）的完整消息保留更多细节（关键文件、改动与结论），开头（较早）的完整消息可适当从简。",
@@ -7697,14 +7695,15 @@ function renderUserEntry(doc, session, cm) {
 }
 /**
 * 渲染完整消息记录（观察输入）：输出一个合法的 <history> 块——
-* user → <user_message>（文本原样、图片注释）、sys → <sys> 空块、assistant 的
-* reasoning → <reasoning>（参考条目）、assistant/toolcall → <assistant>（原样文本）。
+* user → <user_message>（文本原样、图片注释）、sys → <sys> 空块、
+* assistant/toolcall → <assistant>（原样文本）；skipReasoning=false 时另把
+* assistant 的 reasoning → <reasoning>（参考条目）。
 * 文本经 XML 序列化自动转义；仅渲染 seqs 全部落在给定集合内的完整消息。
 */
-function renderMessages(session, seqs) {
+function renderMessages(session, seqs, skipReasoning = true) {
 	const shadowed = new Set(seqs);
 	const reasoningBySeq = /* @__PURE__ */ new Map();
-	for (const seq of seqs) {
+	if (!skipReasoning) for (const seq of seqs) {
 		const event = session.events[seq];
 		if (event?.type !== "assistant/message") continue;
 		const message = event.data.message;
@@ -7733,7 +7732,7 @@ function renderMessages(session, seqs) {
 		} else {
 			const callSeq = cm.seqs[0];
 			const reasonings = callSeq === void 0 ? void 0 : reasoningBySeq.get(callSeq);
-			if (callSeq !== void 0 && reasonings !== void 0 && !emittedReasoning.has(callSeq)) {
+			if (!skipReasoning && callSeq !== void 0 && reasonings !== void 0 && !emittedReasoning.has(callSeq)) {
 				emittedReasoning.add(callSeq);
 				for (const text of reasonings) {
 					const re = doc.createElement("reasoning");
@@ -7815,6 +7814,14 @@ function buildSummaryOptions(session, instruction, contextText, maxTokens, targe
 }
 /** 产出日志后插入首个 <history> 后的格式说明（XML 注释，完整消息定义 + 条目标签语义）。 */
 const HISTORY_FORMAT_NOTE = `<!-- 完整消息：${COMPLETE_MESSAGE_DEFINITION} <TAG index="N">表示单条完整消息，<TAG start="A" end="B"> 表示连续模块，start/end 是首尾完整消息的 index；<sys type="KIND" index="N"> 表示被压缩的系统消息，块中为空 -->`;
+/**
+* 剥离 <history> 块内文块首的格式说明注释（HISTORY_FORMAT_NOTE 整体精确匹配，仅块首
+* 一处）；正文条目内出现的同名注释串不动。非块首或不匹配时原样返回。
+*/
+function stripLeadingFormatNote(inner) {
+	if (!inner.startsWith(HISTORY_FORMAT_NOTE)) return inner;
+	return inner.slice(HISTORY_FORMAT_NOTE.length).replace(/^\s+/, "");
+}
 /** 读取元素整数属性（非负整数；缺失 / 非数字返回 undefined）。 */
 function intAttr(el, name) {
 	const raw = el.getAttribute(name);
@@ -7886,7 +7893,7 @@ function parseHistoryBlock(xml) {
 	};
 }
 /**
-* 解析文本中全部 <history> 块内的条目（反思输入为多个块拼接：逐块解析提取）。
+* 解析文本中全部 <history> 块内的条目（逐块解析提取，兼容多块拼接文本）。
 * 非法块跳过；仅提取不校验顺序（连续性由 historyContinuity 校验）。
 */
 function parseHistoryEntries(text) {
@@ -8031,95 +8038,109 @@ function extractSummaryDetailed(raw, expected) {
 }
 /**
 * 直连 LLM 执行一次摘要（观察或反思），返回文本与可选 token usage。
-* 失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）均记录日志并重试，每次尝试的
-* 结果或报错始终写入日志（成功 info / 失败 warn，不受 debug 影响）；全部尝试耗尽
-* 返回失败结果（携带最后一次尝试的实际报错/具体问题）。最终失败（耗尽或 signal
-* 中止）时把每次尝试的完整提示词与模型原始输出原样落盘为诊断子会话（phase 标注
-* 观察或反思），诊断子会话 id 随失败结果返回。signal 中止（含限流等待被中止）
-* 立即放弃并标记 aborted。每次请求发出前先过全局限流等待门。
+* 每次实际发出的 LLM 调用（无论成功、校验不通过、非 stop 结束还是异常）完成后，
+* 立即把该次尝试的完整提示词与模型原始输出原样落盘为诊断子会话（phase 标注观察
+* 或反思），子会话 id 写入该次尝试的主会话日志；请求发出前被中止的尝试（无实际
+* 调用）不落盘。失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）记录日志并重试；
+* 全部尝试耗尽返回失败结果（携带最后一次尝试的实际报错/具体问题与其诊断子会话 id）。
+* signal 中止（含限流等待被中止）立即放弃并标记 aborted。每次请求发出前先过全局
+* 限流等待门。
 */
 async function runSummarySubagent(ctx, agent, instruction, contextText, maxTokens, target, debug, signal, options) {
 	const session = agent.session;
 	const logger = makeLogger(ctx, debug);
 	const maxAttempts = options?.maxAttempts ?? 11;
 	let lastFailure = {};
-	/** 逐尝试的完整记录（提示词 + 原始输出原样收集，仅最终失败时落盘）。 */
-	const attempts = [];
-	/** 最终失败的统一出口：落盘诊断子会话并携带其 id 返回。 */
-	const finishFailure = async (error, aborted) => {
-		const diagnosticSessionId = await recordCompactionFailure(ctx, session, {
-			phase: options?.phase,
-			target,
-			attempts,
-			debug
-		});
-		return {
-			ok: false,
-			error,
-			aborted,
-			...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
-		};
-	};
 	for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
 		if (signal?.aborted) {
 			logger.warn(`摘要调用中止（第 ${attempt}/${maxAttempts} 次尝试前 signal 已中止），放弃本次压缩`);
-			return await finishFailure(COMPACTION_ABORTED_ERROR, true);
+			return {
+				ok: false,
+				error: COMPACTION_ABORTED_ERROR,
+				aborted: true,
+				...lastFailure.diagnosticSessionId === void 0 ? {} : { diagnosticSessionId: lastFailure.diagnosticSessionId }
+			};
 		}
 		const rateLimitWaitMs = options?.rateLimitWaitMs ?? 6e4;
 		if (!await gateRateLimit(rateLimitWaitMs, signal)) {
 			logger.warn(`摘要调用中止（第 ${attempt}/${maxAttempts} 次尝试前限流等待被 signal 中止），放弃本次压缩`);
-			return await finishFailure(COMPACTION_ABORTED_ERROR, true);
+			return {
+				ok: false,
+				error: COMPACTION_ABORTED_ERROR,
+				aborted: true,
+				...lastFailure.diagnosticSessionId === void 0 ? {} : { diagnosticSessionId: lastFailure.diagnosticSessionId }
+			};
 		}
 		logger.step(`摘要调用开始（第 ${attempt}/${maxAttempts} 次，provider ${target.provider}，model ${target.model}，maxTokens ${maxTokens === void 0 ? "未设置" : String(maxTokens)}）`);
 		const prompt = `${instruction}\n\n${contextText ?? ""}`;
 		const collector = new StreamCollector();
 		let streamCompleted = false;
+		/** 本次尝试的诊断子会话 id（调用完成后立即落盘；落盘失败时缺失）。 */
+		const logAttempt = async () => recordCompactionAttempt(ctx, session, {
+			phase: options?.phase,
+			target,
+			attempt: {
+				prompt,
+				rawOutput: collector.text
+			},
+			attemptNo: attempt,
+			debug
+		});
 		try {
 			const requestOptions = buildSummaryOptions(session, instruction, contextText, maxTokens, target, signal);
 			for await (const chunk of ctx.llm.stream(requestOptions)) collector.push(chunk);
 			streamCompleted = true;
-			attempts.push({
-				prompt,
-				rawOutput: collector.text
-			});
+			const diagnosticSessionId = await logAttempt();
 			const extracted = extractSummaryDetailed(collector.text, options?.expected);
 			const finish = collector.finish;
 			if (finish.kind !== "stop") {
-				lastFailure = { reason: `摘要流以 ${String(finish.kind)} 结束（非正常完成）` };
-				logger.warn(`摘要未完成（第 ${attempt}/${maxAttempts} 次，${lastFailure.reason}）` + (attempt < maxAttempts ? "，将重试" : "，重试耗尽，放弃本次压缩"));
+				lastFailure = {
+					reason: `摘要流以 ${String(finish.kind)} 结束（非正常完成）`,
+					...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
+				};
+				logger.warn(`摘要未完成（第 ${attempt}/${maxAttempts} 次，${lastFailure.reason}，子会话 ${diagnosticSessionId ?? "未落盘"}）` + (attempt < maxAttempts ? "，将重试" : "，重试耗尽，放弃本次压缩"));
 				continue;
 			}
 			if ("error" in extracted) {
-				lastFailure = { reason: extracted.error };
-				logger.warn(`摘要输出未通过校验（第 ${attempt}/${maxAttempts} 次，${extracted.error}）` + (attempt < maxAttempts ? "，将重试" : "，重试耗尽，放弃本次压缩"));
+				lastFailure = {
+					reason: extracted.error,
+					...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
+				};
+				logger.warn(`摘要输出未通过校验（第 ${attempt}/${maxAttempts} 次，${extracted.error}，子会话 ${diagnosticSessionId ?? "未落盘"}）` + (attempt < maxAttempts ? "，将重试" : "，重试耗尽，放弃本次压缩"));
 				continue;
 			}
 			const text = extracted.log;
 			const usage = collector.usage;
-			logger.info(`摘要调用成功（第 ${attempt}/${maxAttempts} 次，输出 ${text.length} 字符` + (usage === void 0 ? "" : `，input ${String(usage.inputTokens ?? "?")} / output ${String(usage.outputTokens ?? "?")} tokens`) + "）");
+			logger.info(`摘要调用成功（第 ${attempt}/${maxAttempts} 次，输出 ${text.length} 字符` + (usage === void 0 ? "" : `，input ${String(usage.inputTokens ?? "?")} / output ${String(usage.outputTokens ?? "?")} tokens`) + `，子会话 ${diagnosticSessionId ?? "未落盘"}）`);
 			return {
 				ok: true,
 				text,
 				attemptCount: attempt,
-				...usage === void 0 ? {} : { usage }
+				...usage === void 0 ? {} : { usage },
+				...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
 			};
 		} catch (error) {
-			if (!streamCompleted) attempts.push({
-				prompt,
-				rawOutput: collector.text
-			});
+			const diagnosticSessionId = streamCompleted ? void 0 : await logAttempt();
 			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 ? "，将重试" : "，重试耗尽，放弃本次压缩"));
+			lastFailure = {
+				error: message,
+				...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
+			};
+			logger.warn(`摘要调用失败（第 ${attempt}/${maxAttempts} 次，${message}，子会话 ${diagnosticSessionId ?? "未落盘"}）` + (attempt < maxAttempts ? "，将重试" : "，重试耗尽，放弃本次压缩"));
 		}
 	}
 	const lastError = lastFailure.error ?? lastFailure.reason ?? "未知原因";
 	logger.warn(`摘要调用最终失败（已尝试 ${maxAttempts} 次，最后错误：${lastError}），拒绝放行本轮 step`);
-	return await finishFailure(lastError, false);
+	return {
+		ok: false,
+		error: lastError,
+		aborted: false,
+		...lastFailure.diagnosticSessionId === void 0 ? {} : { diagnosticSessionId: lastFailure.diagnosticSessionId }
+	};
 }
 //#endregion
 //#region src/compress.ts
@@ -8128,7 +8149,8 @@ async function runSummarySubagent(ctx, agent, instruction, contextText, maxToken
 * 导出 estimateTextTokens / isPairBalancedAfter / computeCompressRange / historySection /
 * findObservePending / reflectPass / observePass / maybeCompress。
 *
-* - 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，摘要合并为一条
+* - 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，块内文拼合为单个
+*   <history> 块输入摘要，合并为一条
 * - 观察（触发 → 待定 → 延迟执行）：净压力（上下文压力 − 已压缩块 token 合计 − 系统提示词
 *   token 估算 − 工具定义 token 估算）首次 ≥ observeThresholdTokens 时记录待定标记
 *   （触发点 = 当时的最后一条完整消息 index），本次不压缩；待定后新增完整消息数 ≥
@@ -8192,6 +8214,14 @@ function historyInnerText(text) {
 	return text.slice(gt + 1, close).trim();
 }
 /**
+* 反思输入拼合：全部块内文（historyInnerText 去掉开标签属性，块首格式说明注释剥离）
+* 按序合并进单个 <history> 块。正文条目内出现的属性/注释同名串原样保留。
+*/
+function mergeHistoryBlocks(blocks) {
+	const inner = blocks.map((block) => stripLeadingFormatNote(historyInnerText(block.text))).join("\n");
+	return `<${HISTORY_TAG}>\n${inner}\n</${HISTORY_TAG}>`;
+}
+/**
 * 判定表层节点 seq 之后的切点是否 tool-call/result 配对平衡：按表层顺序折叠未闭合的
 * 工具调用数，处理到 seq 后计数为 0 即平衡（防止把 tool-call 与其结果切到两侧）。
 */
@@ -8346,7 +8376,7 @@ function appendCompactionSummary(session, data) {
 }
 /**
 * 追加 compaction/end（log-only，结束生命周期；error 记录失败原因，
-* diagnosticSessionId 记录最终失败时的诊断子会话 id）。
+* diagnosticSessionId 记录最后一次摘要尝试（无论成功或失败）的诊断子会话 id）。
 */
 function appendCompactionEnd(session, lifecycle, error, diagnosticSessionId) {
 	const payload = {
@@ -8378,9 +8408,9 @@ function appendHistoryMessage(session, content, sourceEventSeqs, surfaceOp, comp
 	});
 }
 /**
-* 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，摘要调用把整个块
-* 区段合并替换为一条更紧凑的摘要。失败不产生部分替换；摘要尝试全部耗尽返回
-* 失败结果（error = 最后一次尝试的实际报错/具体问题）。
+* 反思：全部 <history> 块 token 合计 ≥ reflectThresholdTokens 时，全部块内文拼合为
+* 单个 <history> 块送入摘要调用，整个块区段合并替换为一条更紧凑的摘要。失败不产生
+* 部分替换；摘要尝试全部耗尽返回失败结果（error = 最后一次尝试的实际报错/具体问题）。
 */
 async function reflectPass(ctx, agent, config, target, signal) {
 	const session = agent.session;
@@ -8406,8 +8436,8 @@ async function reflectPass(ctx, agent, config, target, signal) {
 		return { failed: false };
 	}
 	const blockSeqs = blocks.map((block) => block.seq);
-	const instruction = buildHistoryPrompt();
-	const contextText = blocks.map((block) => block.text).join("\n");
+	const instruction = buildHistoryPrompt(config.compressSkipReasoning);
+	const contextText = mergeHistoryBlocks(blocks);
 	const expectedEnd = reflectExpectedEnd(contextText);
 	const lifecycle = {
 		compactionId: newCompactionId(),
@@ -8468,7 +8498,7 @@ async function reflectPass(ctx, agent, config, target, signal) {
 			end: last.seq
 		}, lifecycle.compactionId);
 		logger.step("反思提交：追加 compaction/end");
-		appendCompactionEnd(session, lifecycle);
+		appendCompactionEnd(session, lifecycle, void 0, summaryResult.diagnosticSessionId);
 		logger.info(`反思完成（摘要 ${tokens} tokens ≥ 阈值 ${threshold}，合并 ${blocks.length} 个块为一条）`);
 		return { failed: false };
 	} catch (error) {
@@ -8631,8 +8661,8 @@ async function observePass(ctx, agent, config, waitCount, target, signal) {
 	const startIndex = inRangeCms[0]?.index ?? 0;
 	const endIndex = inRangeCms[inRangeCms.length - 1]?.index ?? startIndex;
 	logger.step(`观察：保留旧块 ${blocks.length} 条，替换 [${replaceStart}..${range.end}]（${replaceSeqs.length} 个表层节点，压缩至${triggerNote}），新消息 index ${startIndex}..${endIndex}`);
-	const instruction = buildHistoryPrompt();
-	const contextText = renderMessages(session, replaceSeqs);
+	const instruction = buildHistoryPrompt(config.compressSkipReasoning);
+	const contextText = renderMessages(session, replaceSeqs, config.compressSkipReasoning);
 	const lifecycle = {
 		compactionId: newCompactionId(),
 		turn: openTurnOf(session)
@@ -8710,7 +8740,7 @@ async function observePass(ctx, agent, config, waitCount, target, signal) {
 			end: range.end
 		}, lifecycle.compactionId);
 		logger.step("观察提交：追加 compaction/end");
-		appendCompactionEnd(session, lifecycle);
+		appendCompactionEnd(session, lifecycle, void 0, summaryResult.diagnosticSessionId);
 		clearPending();
 		logger.info(`观察压缩完成（替换 ${replaceSeqs.length} 个表层节点，约 ${shadowedTokenCount} tokens，压缩至${triggerNote}）`);
 		return { failed: false };
@@ -8968,6 +8998,7 @@ const DEFAULT_CONFIG = Object.freeze({
 	rateLimitWaitMs: 6e4,
 	tailMessageCount: 5,
 	compressRetryCount: 5,
+	compressSkipReasoning: true,
 	omEnabled: true,
 	debug: false,
 	recallEnabled: true,
@@ -9009,6 +9040,7 @@ function resolveConfig(raw) {
 		if (integer && !Number.isInteger(value)) continue;
 		config[key] = value;
 	}
+	config.compressSkipReasoning = resolveBoolean(input.compressSkipReasoning, true);
 	config.omEnabled = resolveBoolean(input.omEnabled, true);
 	config.debug = resolveBoolean(input.debug, process.env.NODE_ENV !== "production");
 	config.recallEnabled = resolveBoolean(input.recallEnabled, true);

package/dist/summarize.d.ts CHANGED Viewed

@@ -17,22 +17,27 @@ import { type RoutedTarget } from './utils.ts';
 /**
  * 共享压缩提示词（观察/反思同一套）：定义 history 块（模型消息 + index 的表达形式）、
  * 完整消息定义、压缩要求、输出格式与数据源说明。
+ * skipReasoning=true（默认，与 compressSkipReasoning 默认一致）时压缩输入不含
+ * <reasoning> 参考条目，提示词相应省略 <reasoning> 的说明两行。
  */
-export declare function buildHistoryPrompt(): string;
+export declare function buildHistoryPrompt(skipReasoning?: boolean): string;
 /**
  * 渲染完整消息记录（观察输入）：输出一个合法的 <history> 块——
- * user → <user_message>（文本原样、图片注释）、sys → <sys> 空块、assistant 的
- * reasoning → <reasoning>（参考条目）、assistant/toolcall → <assistant>（原样文本）。
+ * user → <user_message>（文本原样、图片注释）、sys → <sys> 空块、
+ * assistant/toolcall → <assistant>（原样文本）；skipReasoning=false 时另把
+ * assistant 的 reasoning → <reasoning>（参考条目）。
  * 文本经 XML 序列化自动转义；仅渲染 seqs 全部落在给定集合内的完整消息。
  */
-export declare function renderMessages(session: Session, seqs: readonly number[]): string;
-/** 摘要调用成功结果：文本 + 可选 token usage + 尝试次数。 */
+export declare function renderMessages(session: Session, seqs: readonly number[], skipReasoning?: boolean): string;
+/** 摘要调用成功结果：文本 + 可选 token usage + 尝试次数 + 诊断子会话 id。 */
 export type SummarySuccess = {
     ok: true;
     text: string;
     usage?: TokenUsage;
     /** 成功时的尝试次数（1 起；载荷层换算为重试次数 = 该值 - 1）。 */
     attemptCount: number;
+    /** 本次成功尝试落盘的诊断子会话 id（落盘失败时缺失）。 */
+    diagnosticSessionId?: string;
 };
 /** 摘要调用失败结果：最后一次尝试的实际报错/具体问题 + 是否因 signal 中止 + 诊断子会话 id。 */
 export type SummaryFailure = {
@@ -41,7 +46,7 @@ export type SummaryFailure = {
     error: string;
     /** 因 signal 中止（含限流等待被中止）而放弃；此时 error 为 COMPACTION_ABORTED_ERROR。 */
     aborted: boolean;
-    /** 诊断子会话 id（最终失败时每次尝试的完整提示词与模型原始输出落盘处；落盘失败时缺失）。 */
+    /** 最后一次尝试落盘的诊断子会话 id（每次尝试各自落盘；该次未发出请求或落盘失败时缺失）。 */
     diagnosticSessionId?: string;
 };
 /** 摘要调用结果（成功/失败二选一）。 */
@@ -50,6 +55,11 @@ export type SummaryOutcome = SummarySuccess | SummaryFailure;
 export declare const MIN_HISTORY_LENGTH = 10;
 /** 产出日志后插入首个 <history> 后的格式说明（XML 注释，完整消息定义 + 条目标签语义）。 */
 export declare const HISTORY_FORMAT_NOTE = "<!-- \u5B8C\u6574\u6D88\u606F\uFF1A`\u5B8C\u6574\u6D88\u606F`\u6307\u4E00\u6761`\u7528\u6237\u6D88\u606F`\u3001`\u7CFB\u7EDF\u6D88\u606F`\u3001`\u6A21\u578B\u8F93\u51FA\u6587\u672C`\u6216`\u5177\u6709result\u7684toolcall`\uFF1B\u9996\u6761 index \u4E3A 0\uFF0C\u6309\u4F1A\u8BDD\u987A\u5E8F\u9012\u589E\u3002 <TAG index=\"N\">\u8868\u793A\u5355\u6761\u5B8C\u6574\u6D88\u606F\uFF0C<TAG start=\"A\" end=\"B\"> \u8868\u793A\u8FDE\u7EED\u6A21\u5757\uFF0Cstart/end \u662F\u9996\u5C3E\u5B8C\u6574\u6D88\u606F\u7684 index\uFF1B<sys type=\"KIND\" index=\"N\"> \u8868\u793A\u88AB\u538B\u7F29\u7684\u7CFB\u7EDF\u6D88\u606F\uFF0C\u5757\u4E2D\u4E3A\u7A7A -->";
+/**
+ * 剥离 <history> 块内文块首的格式说明注释（HISTORY_FORMAT_NOTE 整体精确匹配，仅块首
+ * 一处）；正文条目内出现的同名注释串不动。非块首或不匹配时原样返回。
+ */
+export declare function stripLeadingFormatNote(inner: string): string;
 /** history 块内条目（单条 index 或模块 start/end）。 */
 export type HistoryEntryRange = {
     kind: 'user' | 'assistant' | 'sys';
@@ -58,7 +68,7 @@ export type HistoryEntryRange = {
     end?: number;
 };
 /**
- * 解析文本中全部 <history> 块内的条目（反思输入为多个块拼接：逐块解析提取）。
+ * 解析文本中全部 <history> 块内的条目（逐块解析提取，兼容多块拼接文本）。
  * 非法块跳过；仅提取不校验顺序（连续性由 historyContinuity 校验）。
  */
 export declare function parseHistoryEntries(text: string): HistoryEntryRange[];
@@ -97,12 +107,13 @@ export declare function extractSummaryLog(raw: string, expected?: SummaryValidat
 export declare const SUMMARY_DEFAULT_MAX_ATTEMPTS = 11;
 /**
  * 直连 LLM 执行一次摘要（观察或反思），返回文本与可选 token usage。
- * 失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）均记录日志并重试，每次尝试的
- * 结果或报错始终写入日志（成功 info / 失败 warn，不受 debug 影响）；全部尝试耗尽
- * 返回失败结果（携带最后一次尝试的实际报错/具体问题）。最终失败（耗尽或 signal
- * 中止）时把每次尝试的完整提示词与模型原始输出原样落盘为诊断子会话（phase 标注
- * 观察或反思），诊断子会话 id 随失败结果返回。signal 中止（含限流等待被中止）
- * 立即放弃并标记 aborted。每次请求发出前先过全局限流等待门。
+ * 每次实际发出的 LLM 调用（无论成功、校验不通过、非 stop 结束还是异常）完成后，
+ * 立即把该次尝试的完整提示词与模型原始输出原样落盘为诊断子会话（phase 标注观察
+ * 或反思），子会话 id 写入该次尝试的主会话日志；请求发出前被中止的尝试（无实际
+ * 调用）不落盘。失败（抛异常 / 空输出 / 非 stop 结束 / 校验不通过）记录日志并重试；
+ * 全部尝试耗尽返回失败结果（携带最后一次尝试的实际报错/具体问题与其诊断子会话 id）。
+ * signal 中止（含限流等待被中止）立即放弃并标记 aborted。每次请求发出前先过全局
+ * 限流等待门。
  */
 export declare function runSummarySubagent(ctx: Context, agent: Agent, instruction: string, contextText: string | undefined, maxTokens: number | undefined, target: RoutedTarget, debug: boolean, signal?: AbortSignal, options?: {
     maxAttempts?: number;

package/dist/summarize.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqBH,OAAO,KAAK,EAAE,KAAK,EAAmB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD~~;;;GAGG~~;AACH,wBAAgB,kBAAkB,~~IAAI~~,MAAM,~~CAyC3C~~;AA0CD~~;;;;;GAKG~~;AACH,wBAAgB,cAAc,~~CAAC~~,OAAO,EAAE,OAAO,~~EAAE~~,IAAI,EAAE,SAAS,MAAM,EAAE,~~GAAG~~,MAAM,~~CAsDhF~~;AAED,~~2CAA2C~~;~~AAC3C~~,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;~~CACtB~~,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC;AA2E7D,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,2oBAA6K,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;AAoEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CASrE;AACD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBvC;AAED,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA+EtE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,sBAAsB,GAChC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA4CrC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAG/F;AAED,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,GAAG,SAAS,EAC7B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B,GACA,OAAO,CAAC,cAAc,CAAC,~~CA4GzB~~"}
1	+ {"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts CHANGED Viewed

@@ -101,12 +101,12 @@ export type CompactionSummaryPayload = SessionEventMap['compaction/summary'] & {
     attemptCount?: number;
 };
 /**
- * 插件扩展的 compaction/end 载荷：宿主类型 + diagnosticSessionId（压缩最终失败时
- * 落盘的诊断子会话 id）。宿主 append 不做 schema 剥离，扩展字段原样持久化；
+ * 插件扩展的 compaction/end 载荷：宿主类型 + diagnosticSessionId（最后一次摘要尝试
+ * 无论成功或失败时落盘的诊断子会话 id）。宿主 append 不做 schema 剥离，扩展字段原样持久化；
  * 客户端读取时按可选处理（UI 渲染行为不变）。
  */
 export type CompactionEndPayload = SessionEventMap['compaction/end'] & {
-    /** 压缩最终失败时的诊断子会话 id（落盘失败时缺失）。 */
+    /** 最后一次摘要尝试（成功或失败）落盘的诊断子会话 id（未发出请求或落盘失败时缺失）。 */
     diagnosticSessionId?: string;
 };
 /**

package/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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~~iCAAiC~~;~~IACjC~~,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC,kBAAkB,CAAC,GAAG;IACzE,oCAAoC;IACpC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B,CAAC"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

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