billion-context-dsh 0.2.13 → 0.2.14

package/README.en.md

@@ -3,7 +3,7 @@
 [English](./README.en.md) | [中文](./README.md)
 
 > **⚠️ Beta notice — not for production use**
-> This project (**v0.2.13**) is a work-in-progress beta. The [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) itself is also in **public beta**. **Do not use either in engineering / production environments** — expect breaking changes and rough edges.
+> This project (**v0.2.14**) is a work-in-progress beta. The [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) itself is also in **public beta**. **Do not use either in engineering / production environments** — expect breaking changes and rough edges.
 
 <p align="center">
 <strong>Built with gratitude on top of these projects</strong> — please give them a ⭐:

package/README.md

@@ -3,7 +3,7 @@
 [中文](./README.md) | [English](./README.en.md)
 
 > **⚠️ 测试版声明——请勿用于生产环境**
-> 本项目（**v0.2.13**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
+> 本项目（**v0.2.14**）仍处于开发中的测试版。[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身也处于**公开测试版**阶段。**请勿将两者用于工程化 / 生产环境**——预期会有破坏性变更与粗糙之处。
 
 <p align="center">
 <strong>衷心感谢以下项目——请给它们一个 ⭐：</strong>

package/dist/index.js

@@ -3502,7 +3502,7 @@ var AcpStateStore = class {
 };
 
 // src/tools.ts
-import { defineTool } from "@deepseek-ai/dsh-tools";
+import { defineTool, ToolArgsError } from "@deepseek-ai/dsh-tools";
 
 // src/config.ts
 function kernelConfigFor(input) {
@@ -3855,6 +3855,16 @@ var compressParameters = {
   // intentionally NOT `required: true` — a required property would reject the
   // wrapped shape before `handleCompress` can see it. The tool description
   // still tells the model content is mandatory.
+  //
+  // The items fields are the opposite case: startSeq/endSeq/summary MUST be
+  // `required: true`. Without that, a model call that omits `summary` (only
+  // startSeq/endSeq/topic present) passed schema validation and failed late
+  // inside the kernel with "Summary is empty" — and live sessions showed the
+  // model retrying the identical broken call in a loop. With the fields
+  // required, the same call is rejected at the schema gate with
+  // `missing required property "content[0].summary"`, which tells the model
+  // exactly which field to add (same pattern as decompress's required
+  // blockId / search_context's required query).
   arguments: { type: "json", description: "Tolerated wrapped-arguments form (model-generated); unwrapped in handleCompress. Prefer passing content directly." },
   topic: { type: "string", description: "Fallback topic for entries without their own." },
   content: {
@@ -3864,18 +3874,20 @@ var compressParameters = {
       type: "object",
       properties: {
         startSeq: {
+          required: true,
           oneOf: [
             { type: "integer", description: "First surface seq of the range." },
             { type: "string", description: "Seq as text; a trailing #callId fragment is ignored." }
           ]
         },
         endSeq: {
+          required: true,
           oneOf: [
             { type: "integer", description: "Inclusive last surface seq of the range." },
             { type: "string", description: "Seq as text; a trailing #callId fragment is ignored." }
           ]
         },
-        summary: { type: "string", description: "Complete technical summary replacing the range; keep paths, decisions, values verbatim. Minimum 50 characters." },
+        summary: { type: "string", required: true, description: "Complete technical summary replacing the range; keep paths, decisions, values verbatim. Minimum 50 characters." },
         topic: { type: "string", description: "Short label (3-5 words) for this range." }
       },
       additionalProperties: false
@@ -3946,6 +3958,18 @@ function unwrapEnvelope(args) {
   if (typeof inner !== "object" || inner === null || Array.isArray(inner)) return args;
   return { ...args, ...inner };
 }
+function validateContentItems(content) {
+  const violations = [];
+  content.forEach((item, index) => {
+    const path = `content[${index}]`;
+    if (item.startSeq === void 0) violations.push(`missing required property "${path}.startSeq"`);
+    if (item.endSeq === void 0) violations.push(`missing required property "${path}.endSeq"`);
+    if (typeof item.summary !== "string" || item.summary.trim().length === 0) {
+      violations.push(`missing required property "${path}.summary"`);
+    }
+  });
+  if (violations.length > 0) throw new ToolArgsError(violations);
+}
 async function handleCompress(env, args, exec) {
   const agent = requireAgent(exec);
   const session = agent.session;
@@ -3967,6 +3991,7 @@ async function handleCompress(env, args, exec) {
     };
   }
   args = unwrapped;
+  validateContentItems(args.content);
   const ranges = [];
   const alreadyCompressedNotes = [];
   for (const range of args.content) {