@deepseek-ai/dsh-compaction-basic 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,100 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/compaction/compaction-basic/README.md
-README.md: e0a7d90fecf308fa9f83bf87c2bfb5c4ff13f2e3
-README.zh.md: 32d4f528e46206c5939dda038b710e01ce912d99
+/:
+  en: 4c3172f95eb524e1
+  zh: dd92ec1300ad9cbe
+/deepseek-ai-dsh-compaction-basic:
+  en: 3ba5f9e37ab36328
+  zh: 2390a55415d4c27b
+/deepseek-ai-dsh-compaction-basic/summary:
+  en: 31202d573182cc31
+  zh: e0a0c96f67a9c1ba
+/deepseek-ai-dsh-compaction-basic/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: bda879a892f240f0
+/deepseek-ai-dsh-compaction-basic/use-this-package:
+  en: b40fa08b8ad55cca
+  zh: f8765a6f199c8c7b
+/deepseek-ai-dsh-compaction-basic/use-this-package/what-you-get:
+  en: eb8e340061f72b98
+  zh: 327a51037b2d1adf
+/deepseek-ai-dsh-compaction-basic/use-this-package/smallest-working-composition:
+  en: 4cb73d7a57908948
+  zh: 7ba2ddc4c76e4957
+/deepseek-ai-dsh-compaction-basic/use-this-package/tuning-when-condensation-starts:
+  en: 3446c54c062d7e34
+  zh: fb502c941e508ae0
+/deepseek-ai-dsh-compaction-basic/use-this-package/what-happens-when-condensation-runs:
+  en: c872a8ef069596f0
+  zh: b3a48e309ae830d4
+/deepseek-ai-dsh-compaction-basic/use-this-package/on-demand-condensation-with-compact:
+  en: 4c5067e4c57ca708
+  zh: 1c0e70319b9b2112
+/deepseek-ai-dsh-compaction-basic/use-this-package/trimming-oversized-tool-outputs:
+  en: 1d6a74c0dc874dc8
+  zh: bcfa95549308c030
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation:
+  en: deb655b3b1860576
+  zh: 79f56e41a9dfe01f
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation/design-philosophy:
+  en: 54945a18965f12a8
+  zh: fecd5d4fc2f2e6d6
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation/automatic-triggers-and-overflow-recovery:
+  en: d62d65547dd0b2dc
+  zh: 5c21671f16d94f5a
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation/summarization-mechanics:
+  en: 967531b71453eb88
+  zh: c7919b46e36763e6
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation/the-region-transaction:
+  en: f4330f6bff22d400
+  zh: 46e16c51bb66a0f7
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation/config-resolution:
+  en: 246736aa86d3013d
+  zh: 35e261927ba0699c
+/deepseek-ai-dsh-compaction-basic/understand-the-implementation/source-map:
+  en: bd9d1e01ec833593
+  zh: cbadca50d8e9ed07
+/deepseek-ai-dsh-compaction-basic/further-exploration:
+  en: 84b5b81eb9b5965d
+  zh: 7000af0fa502fcc1
+/deepseek-ai-dsh-compaction-basic/model-experience:
+  en: 215e7ba838619b7b
+  zh: a311da3843709f90
+/deepseek-ai-dsh-compaction-basic/model-experience/conversation-history:
+  en: 2e1148dd0f39a281
+  zh: cd68c9fff63534af
+/deepseek-ai-dsh-compaction-basic/model-experience/conversation-history/what-the-model-sees:
+  en: 8d4325e6659bc314
+  zh: f80e69305b39f4a3
+/deepseek-ai-dsh-compaction-basic/model-experience/conversation-history/what-the-model-sees/conversation-checkpoint-preamble:
+  en: 129d1eaba2519330
+  zh: 3ec517bdc6cb5ae3
+/deepseek-ai-dsh-compaction-basic/model-experience/conversation-history/token-effect:
+  en: 872515a75b5a9726
+  zh: c0045e1972bbac4e
+/deepseek-ai-dsh-compaction-basic/model-experience/conversation-history/kv-cache-effect:
+  en: a22b43f321843aee
+  zh: a5960da1bef34441
+/deepseek-ai-dsh-compaction-basic/model-experience/auxiliary-summarizer-request:
+  en: 7169bd02a7a6c396
+  zh: 7c62e3d4a97c73f7
+/deepseek-ai-dsh-compaction-basic/model-experience/auxiliary-summarizer-request/what-the-model-sees:
+  en: b7afcf1cc1c85c40
+  zh: a112c5b3984c31dc
+/deepseek-ai-dsh-compaction-basic/model-experience/auxiliary-summarizer-request/what-the-model-sees/compaction-instruction-final-user-message:
+  en: 39a362ee4890dbdb
+  zh: 3b98699120b1548e
+/deepseek-ai-dsh-compaction-basic/model-experience/auxiliary-summarizer-request/token-effect:
+  en: 5e0679cb7cb4291a
+  zh: c9df8ebc526b05d9
+/deepseek-ai-dsh-compaction-basic/model-experience/auxiliary-summarizer-request/kv-cache-effect:
+  en: d31d3e3d46542c91
+  zh: 5a42f873993e0c79
+/deepseek-ai-dsh-compaction-basic/known-limitations-and-deferred-work:
+  en: 8f459fa26e079883
+  zh: 4acdcefa71ebb409
+/deepseek-ai-dsh-compaction-basic/known-limitations-and-deferred-work/dev-note:
+  en: 1fec7b90c3b68c49
+  zh: ad9ae54a598846d0

package/README.md

@@ -116,7 +116,7 @@ Pressure policy resolves capacity from the adapter that owns the durable route.
 
 ### Summarization mechanics
 
-A direct `ctx.llm.stream()` call uses the configured provider/model pair and cap, falling back to the latest logged request target and then the `AgentOptions` pair, without running the loop-only `agent/request` extension point. The call replays the derived `system/message` at surface node 0 as the leading entry of `messages`, followed by the shadowed-region messages (including a shadowed in-history `system/message` in its surface position), and carries the header's tools verbatim — including image references, which the selected adapter must resolve or explicitly reject — and appends the compaction instruction as the final user message, so it reuses the provider's warm prefix cache instead of invalidating it. An empty-content system head contributes no message but remains outside the compacted range. The final instruction is a frozen `RequestUserInput` without durable identity or source; the replayed history and persisted checkpoint remain durable messages. The call sets `GenerateOptions.purpose` to `compaction`; only returned text enters the checkpoint, excluding reasoning and tool calls. Image output fails with `UNSUPPORTED_CONTENT` rather than disappearing. The replacement user message frames the summary with `<compacted-summary>` tags; the raw summary remains on the `compaction/summary` event.
+A direct `ctx.llm.stream()` call uses the configured provider/model pair and cap, falling back to the latest logged request target and then the `AgentOptions` pair, without running the loop-only `agent/request` extension point. The call replays the derived `system/message` at surface node 0 as the leading entry of `messages`, followed by the shadowed-region messages (including a shadowed in-history `system/message` in its surface position), and supplies the header's active tools for route-specific projection. The selected adapter must resolve image references in the replayed messages or explicitly reject them. The call appends the compaction instruction as the final user message, preserving the provider's warm prefix where projection permits. An empty-content system head contributes no message but remains outside the compacted range. The final instruction is a frozen `RequestUserInput` without durable identity or source; the replayed history and persisted checkpoint remain durable messages. The call sets `GenerateOptions.purpose` to `compaction`; only returned text enters the checkpoint, excluding reasoning and tool calls. Image output fails with `UNSUPPORTED_CONTENT` rather than disappearing. The replacement user message frames the summary with `<compacted-summary>` tags; the raw summary remains on the `compaction/summary` event. The call also carries `Session.toolHistory()` so the runtime can project deferred and retained definitions; a prefix missing update messages uses active declarations without developer updates.
 
 ### The region transaction
 
@@ -184,7 +184,7 @@ Replacing rather than append-only. Each checkpoint invalidates reuse from the fi
 
 #### What the model sees
 
-The summarization model receives the conversation replayed verbatim — the same system prompt, tool schemas, and messages the last routed request sent for the shadowed region — followed by one final user message: the compaction instruction below. The conversation model never sees this private request or its reasoning; only returned text is stored.
+The summarization model receives the system prompt and shadowed-region history, with tool declarations and developer updates projected for its route, followed by one final user message: the compaction instruction below. The conversation model never sees this private request or its reasoning; only returned text is stored.
 
 ##### Compaction instruction (final user message)
 

package/README.zh.md

@@ -116,7 +116,7 @@ kind: "package-reference"
 
 ### 摘要机制
 
-直接 `ctx.llm.stream()` 调用使用已配置的提供方／模型对与上限，回退到最新已记录请求目标，然后再回退到 `AgentOptions` 对，而不运行仅用于 agent loop 的 `agent/request` 扩展点。该调用将 surface 节点 0 处派生的 `system/message` 作为 `messages` 的首项回放，后接已遮蔽区域消息（包括位于其 surface 位置的被遮蔽历史内 `system/message`），并逐字携带 header 的工具——包括所选适配器必须解析或明确拒绝的图片引用——并将压缩指令作为最后一条 user 消息追加，从而复用提供方的热前缀 cache，而非使它失效。空内容系统头节点不贡献消息，但仍处于压缩范围之外。最终指令是冻结的 `RequestUserInput`，不含持久身份或来源；回放历史和持久化检查点仍然使用持久消息。调用将 `GenerateOptions.purpose` 设为 `compaction`；只有返回文本进入检查点，推理与工具调用都会被排除。图片输出会以 `UNSUPPORTED_CONTENT` 失败，而不是消失。替换 user 消息用 `<compacted-summary>` 标签框定摘要；原始摘要保留在 `compaction/summary` 事件上。
+直接 `ctx.llm.stream()` 调用使用已配置的提供方／模型对与上限，回退到最新已记录请求目标，然后再回退到 `AgentOptions` 对，而不运行仅用于 agent loop 的 `agent/request` 扩展点。该调用将 surface 节点 0 处派生的 `system/message` 作为 `messages` 的首项回放，后接已遮蔽区域消息（包括位于其 surface 位置的被遮蔽历史内 `system/message`），并提供 header 的有效工具供路由特定投影使用。所选适配器必须解析回放消息中的图片引用或明确拒绝它们。调用将压缩指令作为最后一条 user 消息追加，在投影允许时保留提供方的热前缀 cache。空内容系统头节点不贡献消息，但仍处于压缩范围之外。最终指令是冻结的 `RequestUserInput`，不含持久身份或来源；回放历史和持久化检查点仍然使用持久消息。调用将 `GenerateOptions.purpose` 设为 `compaction`；只有返回文本进入检查点，推理与工具调用都会被排除。图片输出会以 `UNSUPPORTED_CONTENT` 失败，而不是消失。替换 user 消息用 `<compacted-summary>` 标签框定摘要；原始摘要保留在 `compaction/summary` 事件上。 调用还携带 `Session.toolHistory()`，供运行时投影延迟和保留定义；若前缀缺少更新消息，则使用有效声明且不发送 developer 更新。
 
 ### 区域事务
 
@@ -184,7 +184,7 @@ This is an automatically generated checkpoint condensing an earlier span of the
 
 #### 模型看到的内容
 
-摘要模型会接收逐字回放的会话：与上次已路由请求为已遮蔽区域发送的相同系统提示词、工具 schema 与消息，后面跟随一条最终 user 消息，即下方压缩指令。会话模型绝不会看到该私有请求或其推理；只有返回文本会被存储。
+摘要模型接收系统提示词与已遮蔽区域的历史，其中工具声明和 developer 更新按其路由投影，后面跟随一条最终 user 消息，即下方压缩指令。会话模型绝不会看到该私有请求或其推理；只有返回文本会被存储。
 
 ##### 压缩指令（最终 user 消息）
 

package/lib/index.js

@@ -313,6 +313,7 @@ async function summarizeWithLlm(ctx, config, input, agent, signal) {
 		provider: target.provider,
 		model: target.model,
 		messages,
+		toolHistory: agent.session.toolHistory(),
 		...input.tools === void 0 ? {} : { tools: [...input.tools] },
 		maxTokens: config.maxTokens,
 		sessionId: agent.session.id,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-compaction-basic",
   "description": "Token-meter-driven compaction policy and LLM summarization backend for the DeepSeek Harness",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -28,13 +28,13 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-commands": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-compaction": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-compaction-tool-result-pruner": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-commands": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-compaction": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-compaction-tool-result-pruner": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-compaction-tool-result-pruner": {
@@ -42,26 +42,26 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2",
     "@deepseek-ai/schemastery": "~3.18.4"
   },
   "devDependencies": {
+    "@deepseek-ai/cordis-plugin-include": "~1.0.9",
     "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "0.1.7-alpha.2",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.9",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-commands": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-compaction": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-compaction-tool-result-pruner": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-invariants": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-llm-retry": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-compaction-image-offload": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-commands": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-compaction-tool-result-pruner": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-compaction": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-invariants": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm-retry": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-compaction-image-offload": "0.1.7-rc.2"
   }
 }