@lexwdex-org/opencode-dcp 3.3.4 → 3.4.3

package/dist/index.js

@@ -862,6 +862,37 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
+// lib/config-env-override.ts
+function applyExternalModelEnvOverride(config) {
+  const envUrl = process.env.OPENCODE_DCP_EXTERNAL_COMPRESS_URL;
+  const envApiKey = process.env.OPENCODE_DCP_EXTERNAL_COMPRESS_KEY;
+  const envModel = process.env.OPENCODE_DCP_EXTERNAL_COMPRESS_MODEL;
+  const envTimeout = process.env.OPENCODE_DCP_EXTERNAL_COMPRESS_TIMEOUT;
+  const envRetries = process.env.OPENCODE_DCP_EXTERNAL_COMPRESS_RETRIES;
+  if (envUrl && envModel) {
+    const externalModel = {
+      url: envUrl,
+      model: envModel
+    };
+    if (envApiKey) {
+      externalModel.apiKey = envApiKey;
+    }
+    if (envTimeout) {
+      const parsed = parseInt(envTimeout, 10);
+      if (parsed > 0) {
+        externalModel.timeout = parsed;
+      }
+    }
+    if (envRetries) {
+      const parsed = parseInt(envRetries, 10);
+      if (parsed >= 0) {
+        externalModel.retries = parsed;
+      }
+    }
+    config.compress.externalModel = externalModel;
+  }
+}
+
 // lib/config.ts
 var DEFAULT_PROTECTED_TOOLS = [
   "task",
@@ -912,6 +943,7 @@ var VALID_CONFIG_KEYS = /* @__PURE__ */ new Set([
   "compress.protectedTools",
   "compress.protectTags",
   "compress.protectUserMessages",
+  "compress.externalModel",
   "strategies",
   "strategies.deduplication",
   "strategies.deduplication.enabled",
@@ -1213,6 +1245,30 @@ function validateConfigTypes(config) {
           actual: JSON.stringify(compress.permission)
         });
       }
+      if (compress.externalModel !== void 0) {
+        if (typeof compress.externalModel !== "object" || compress.externalModel === null || Array.isArray(compress.externalModel)) {
+          errors.push({
+            key: "compress.externalModel",
+            expected: "object with url and model",
+            actual: typeof compress.externalModel
+          });
+        } else {
+          if (typeof compress.externalModel.url !== "string") {
+            errors.push({
+              key: "compress.externalModel.url",
+              expected: "string",
+              actual: typeof compress.externalModel.url
+            });
+          }
+          if (typeof compress.externalModel.model !== "string") {
+            errors.push({
+              key: "compress.externalModel.model",
+              expected: "string",
+              actual: typeof compress.externalModel.model
+            });
+          }
+        }
+      }
       if (compress.showCompression !== void 0 && typeof compress.showCompression !== "boolean") {
         errors.push({
           key: "compress.showCompression",
@@ -1342,7 +1398,8 @@ var defaultConfig = {
     nudgeForce: "strong",
     protectedTools: [...COMPRESS_DEFAULT_PROTECTED_TOOLS],
     protectTags: false,
-    protectUserMessages: false
+    protectUserMessages: false,
+    externalModel: void 0
   },
   strategies: {
     deduplication: {
@@ -1465,7 +1522,8 @@ function mergeCompress(base, override) {
     nudgeForce: override.nudgeForce ?? base.nudgeForce,
     protectedTools: [.../* @__PURE__ */ new Set([...base.protectedTools, ...override.protectedTools ?? []])],
     protectTags: override.protectTags ?? base.protectTags,
-    protectUserMessages: override.protectUserMessages ?? base.protectUserMessages
+    protectUserMessages: override.protectUserMessages ?? base.protectUserMessages,
+    externalModel: override.externalModel ?? base.externalModel
   };
 }
 function mergeCommands(base, override) {
@@ -1509,7 +1567,8 @@ function deepCloneConfig(config) {
       ...config.compress,
       modelMaxLimits: { ...config.compress.modelMaxLimits },
       modelMinLimits: { ...config.compress.modelMinLimits },
-      protectedTools: [...config.compress.protectedTools]
+      protectedTools: [...config.compress.protectedTools],
+      externalModel: config.compress.externalModel ? { ...config.compress.externalModel } : void 0
     },
     strategies: {
       deduplication: {
@@ -1591,6 +1650,7 @@ Using previous/default values`
     showConfigWarnings(ctx, layer.path, result.data, layer.isProject);
     config = mergeLayer(config, result.data);
   }
+  applyExternalModelEnvOverride(config);
   return config;
 }
 
@@ -1793,7 +1853,12 @@ function countAllMessageTokens(msg) {
 }
 
 // lib/prompts/extensions/tool.ts
-var RANGE_FORMAT_EXTENSION = `
+function buildRangeFormatExtension(externalModelEnabled) {
+  const summaryField = externalModelEnabled ? `summary?: string     // \u66FF\u6362\u8303\u56F4\u5185\u6240\u6709\u5185\u5BB9\u7684\u5B8C\u6574\u6280\u672F\u6458\u8981\uFF08\u53EF\u7701\u7565\uFF1B\u5916\u90E8\u6A21\u578B\u751F\u6210\uFF09` : `summary: string      // \u66FF\u6362\u8303\u56F4\u5185\u6240\u6709\u5185\u5BB9\u7684\u5B8C\u6574\u6280\u672F\u6458\u8981`;
+  const externalHint = externalModelEnabled ? `
+
+\u5F53\u542F\u7528\u5916\u90E8\u6A21\u578B\u538B\u7F29\u65F6\uFF0Csummary \u5B57\u6BB5\u53EF\u7701\u7565\uFF1B\u63D2\u4EF6\u5C06\u81EA\u52A8\u8C03\u7528\u5916\u90E8\u6A21\u578B\u751F\u6210\u3002` : "";
+  return `
 \u538B\u7F29\u683C\u5F0F
 
 \`\`\`
@@ -1803,12 +1868,20 @@ var RANGE_FORMAT_EXTENSION = `
     {
       startId: string,     // \u8303\u56F4\u5F00\u59CB\u7684\u8FB9\u754C ID\uFF1AmNNNN \u6216 bN
       endId: string,       // \u8303\u56F4\u7ED3\u675F\u7684\u8FB9\u754C ID\uFF1AmNNNN \u6216 bN
-      summary: string      // \u66FF\u6362\u8303\u56F4\u5185\u6240\u6709\u5185\u5BB9\u7684\u5B8C\u6574\u6280\u672F\u6458\u8981
+      ${summaryField}
     }
   ]
 }
-\`\`\``;
-var MESSAGE_FORMAT_EXTENSION = `
+\`\`\`
+
+\u8FB9\u754C ID \u5FC5\u987B\u4ECE\u5F53\u524D\u53EF\u89C1\u4E0A\u4E0B\u6587\u4E2D\u5DF2\u6709\u7684\u6CE8\u5165 ID \u7CBE\u786E\u9009\u53D6\uFF1B\u4E0D\u8981\u53D1\u660E ID\uFF0C\u4E5F\u4E0D\u8981\u6839\u636E\u987A\u5E8F\u5916\u63A8\u4E0D\u5B58\u5728\u7684 ID\u3002${externalHint}`;
+}
+function buildMessageFormatExtension(externalModelEnabled) {
+  const summaryField = externalModelEnabled ? `summary?: string     // \u66FF\u6362\u8BE5\u6761\u6D88\u606F\u7684\u5B8C\u6574\u6280\u672F\u6458\u8981\uFF08\u53EF\u7701\u7565\uFF1B\u5916\u90E8\u6A21\u578B\u751F\u6210\uFF09` : `summary: string      // \u66FF\u6362\u8BE5\u6761\u6D88\u606F\u7684\u5B8C\u6574\u6280\u672F\u6458\u8981`;
+  const externalHint = externalModelEnabled ? `
+
+\u5F53\u542F\u7528\u5916\u90E8\u6A21\u578B\u538B\u7F29\u65F6\uFF0Csummary \u5B57\u6BB5\u53EF\u7701\u7565\uFF1B\u63D2\u4EF6\u5C06\u81EA\u52A8\u8C03\u7528\u5916\u90E8\u6A21\u578B\u751F\u6210\u3002` : "";
+  return `
 \u538B\u7F29\u683C\u5F0F
 
 \`\`\`
@@ -1818,11 +1891,14 @@ var MESSAGE_FORMAT_EXTENSION = `
     {
       messageId: string,   // \u4EC5\u539F\u59CB\u6D88\u606F ID\uFF1AmNNNN\uFF08\u5FFD\u7565 priority \u7B49\u5143\u6570\u636E\u5C5E\u6027\uFF09
       topic: string,       // \u6B64\u5355\u6761\u6D88\u606F\u6458\u8981\u7684\u77ED\u6807\u7B7E\uFF083-5 \u4E2A\u8BCD\uFF09
-      summary: string      // \u66FF\u6362\u8BE5\u6761\u6D88\u606F\u7684\u5B8C\u6574\u6280\u672F\u6458\u8981
+      ${summaryField}
     }
   ]
 }
-\`\`\``;
+\`\`\`${externalHint}`;
+}
+var RANGE_FORMAT_EXTENSION = buildRangeFormatExtension(false);
+var MESSAGE_FORMAT_EXTENSION = buildMessageFormatExtension(false);
 
 // lib/message-ids.ts
 var MESSAGE_REF_REGEX = /^m(\d{4})$/;
@@ -1985,11 +2061,17 @@ function resolveBoundaryIds(context, state, startId, endId) {
   const issues = [];
   const parsedStartId = parseBoundaryId(startId);
   const parsedEndId = parseBoundaryId(endId);
+  const hint = formatAvailableBoundaryHint(lookup);
+  const guidance = formatBoundaryUsageGuidance();
   if (parsedStartId === null) {
-    issues.push("startId is invalid. Use an injected message ID (mNNNN) or block ID (bN).");
+    issues.push(
+      `startId is invalid. Use an injected message ID (mNNNN) or block ID (bN).${hint}${guidance}`
+    );
   }
   if (parsedEndId === null) {
-    issues.push("endId is invalid. Use an injected message ID (mNNNN) or block ID (bN).");
+    issues.push(
+      `endId is invalid. Use an injected message ID (mNNNN) or block ID (bN).${hint}${guidance}`
+    );
   }
   if (issues.length > 0) {
     throw new Error(
@@ -2002,28 +2084,18 @@ function resolveBoundaryIds(context, state, startId, endId) {
   const startReference = lookup.get(parsedStartId.ref);
   const endReference = lookup.get(parsedEndId.ref);
   if (!startReference || !endReference) {
-    const allKeys = Array.from(lookup.keys());
-    const availableBlockRefs = allKeys.filter((key) => key.startsWith("b")).sort(
-      (a, b) => Number.parseInt(a.slice(1), 10) - Number.parseInt(b.slice(1), 10)
-    );
-    const availableMsgRefs = allKeys.filter((key) => key.startsWith("m")).sort(
-      (a, b) => Number.parseInt(a.slice(1), 10) - Number.parseInt(b.slice(1), 10)
-    );
-    const blockHint = availableBlockRefs.length ? ` Available block IDs: ${availableBlockRefs.join(", ")}.` : " No block IDs available.";
-    const msgHint = availableMsgRefs.length === 0 ? " No message IDs available." : availableMsgRefs.length <= 10 ? ` Available message IDs: ${availableMsgRefs.join(", ")}.` : ` Available message IDs: ${availableMsgRefs[0]} to ${availableMsgRefs[availableMsgRefs.length - 1]} (${availableMsgRefs.length} total).`;
-    const hint = `${msgHint}${blockHint}`;
     if (!startReference) {
       const wasKnown = state.messageIds.byRef.has(parsedStartId.ref);
       const reason = wasKnown ? " (message was likely compacted out of the conversation)" : " (invalid ID)";
       issues.push(
-        `startId ${parsedStartId.ref} is not available${reason}. Choose an injected ID visible in context.${hint}`
+        `startId ${parsedStartId.ref} is not available${reason}. Choose an injected ID visible in context.${hint}${guidance}`
       );
     }
     if (!endReference) {
       const wasKnown = state.messageIds.byRef.has(parsedEndId.ref);
       const reason = wasKnown ? " (message was likely compacted out of the conversation)" : " (invalid ID)";
       issues.push(
-        `endId ${parsedEndId.ref} is not available${reason}. Choose an injected ID visible in context.${hint}`
+        `endId ${parsedEndId.ref} is not available${reason}. Choose an injected ID visible in context.${hint}${guidance}`
       );
     }
   }
@@ -2129,6 +2201,17 @@ function resolveAnchorMessageId(startReference) {
   }
   return startReference.messageId;
 }
+function formatAvailableBoundaryHint(lookup) {
+  const allKeys = Array.from(lookup.keys());
+  const availableBlockRefs = allKeys.filter((key) => key.startsWith("b")).sort((a, b) => Number.parseInt(a.slice(1), 10) - Number.parseInt(b.slice(1), 10));
+  const availableMsgRefs = allKeys.filter((key) => key.startsWith("m")).sort((a, b) => Number.parseInt(a.slice(1), 10) - Number.parseInt(b.slice(1), 10));
+  const blockHint = availableBlockRefs.length ? ` Available block IDs: ${availableBlockRefs.join(", ")}.` : " No block IDs available.";
+  const msgHint = availableMsgRefs.length === 0 ? " No message IDs available." : availableMsgRefs.length <= 10 ? ` Available message IDs: ${availableMsgRefs.join(", ")}.` : ` Available message IDs: ${availableMsgRefs[0]} to ${availableMsgRefs[availableMsgRefs.length - 1]} (${availableMsgRefs.length} total).`;
+  return `${msgHint}${blockHint}`;
+}
+function formatBoundaryUsageGuidance() {
+  return " Use exactly one of the listed injected IDs. For already compressed content, use its bN block ID.";
+}
 function buildBoundaryLookup(context, state) {
   const lookup = /* @__PURE__ */ new Map();
   for (const [messageRef, messageId] of state.messageIds.byRef) {
@@ -2446,8 +2529,10 @@ function validateArgs(args) {
     if (typeof entry?.topic !== "string" || entry.topic.trim().length === 0) {
       throw new Error(`${prefix}.topic is required and must be a non-empty string`);
     }
-    if (typeof entry?.summary !== "string" || entry.summary.trim().length === 0) {
-      throw new Error(`${prefix}.summary is required and must be a non-empty string`);
+    if (entry?.summary !== void 0) {
+      if (typeof entry.summary !== "string" || entry.summary.trim().length === 0) {
+        throw new Error(`${prefix}.summary must be a non-empty string when provided`);
+      }
     }
   }
 }
@@ -4165,8 +4250,118 @@ ${output}`);
   return summary + heading + protectedOutputs.join("");
 }
 
+// lib/compress/external-inference.ts
+var ExternalModelError = class extends Error {
+  constructor(message, kind, cause) {
+    super(message);
+    this.kind = kind;
+    this.cause = cause;
+    this.name = "ExternalModelError";
+  }
+};
+function resolveCompressBaseUrl(url) {
+  const normalized = url.replace(/\/$/, "");
+  if (normalized.endsWith("/chat/completions")) {
+    return normalized;
+  }
+  return `${normalized}/chat/completions`;
+}
+async function callExternalModel(endpoint, cfg, req) {
+  const controller = new AbortController();
+  const timeoutMs = cfg.timeout ?? 12e4;
+  const timeoutHandle = setTimeout(() => controller.abort(), timeoutMs);
+  let response;
+  try {
+    response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...cfg.apiKey ? { Authorization: `Bearer ${cfg.apiKey}` } : {}
+      },
+      body: JSON.stringify({
+        model: cfg.model,
+        messages: [
+          { role: "system", content: req.systemPrompt },
+          { role: "user", content: req.userContent }
+        ],
+        temperature: 0
+      }),
+      signal: controller.signal
+    });
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new ExternalModelError(
+        `External model request timed out after ${timeoutMs}ms`,
+        "timeout",
+        error
+      );
+    }
+    throw new ExternalModelError(
+      `External model request failed: ${error instanceof Error ? error.message : String(error)}`,
+      "network",
+      error
+    );
+  } finally {
+    clearTimeout(timeoutHandle);
+  }
+  if (!response.ok) {
+    let errorBody = "";
+    try {
+      errorBody = await response.text();
+    } catch {
+    }
+    throw new ExternalModelError(
+      `External model returned HTTP ${response.status}: ${errorBody.slice(0, 200)}`,
+      "http",
+      { status: response.status, body: errorBody }
+    );
+  }
+  let parsed;
+  try {
+    parsed = await response.json();
+  } catch (error) {
+    throw new ExternalModelError("External model returned invalid JSON", "parse", error);
+  }
+  const content = parsed?.choices?.[0]?.message?.content;
+  if (typeof content !== "string" || content.trim().length === 0) {
+    throw new ExternalModelError(
+      "External model returned empty or missing summary content",
+      "empty",
+      parsed
+    );
+  }
+  return content;
+}
+async function generateSummaryViaExternal(cfg, req) {
+  const endpoint = resolveCompressBaseUrl(cfg.url);
+  const maxRetries = cfg.retries ?? 1;
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await callExternalModel(endpoint, cfg, req);
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError;
+}
+
 // lib/compress/message.ts
-function buildSchema() {
+function extractMessageText(messageId, searchContext) {
+  const msg = searchContext.rawMessagesById.get(messageId);
+  if (!msg) return "";
+  const parts = [];
+  for (const part of msg.parts) {
+    if (part.type === "text" && typeof part.text === "string") {
+      parts.push(part.text);
+    }
+  }
+  return parts.join("\n\n");
+}
+function buildSchema(externalModelEnabled) {
+  const summaryField = externalModelEnabled ? tool.schema.string().optional().describe(
+    "Complete technical summary replacing that one message (optional when external model is configured)"
+  ) : tool.schema.string().describe("Complete technical summary replacing that one message");
   return {
     topic: tool.schema.string().describe(
       "Short label (3-5 words) for the overall batch - e.g., 'Closed Research Notes'"
@@ -4175,7 +4370,7 @@ function buildSchema() {
       tool.schema.object({
         messageId: tool.schema.string().describe("Raw message ID to compress (e.g. m0001)"),
         topic: tool.schema.string().describe("Short label (3-5 words) for this one message summary"),
-        summary: tool.schema.string().describe("Complete technical summary replacing that one message")
+        summary: summaryField
       })
     ).describe("Batch of individual message summaries to create in one tool call")
   };
@@ -4183,9 +4378,10 @@ function buildSchema() {
 function createCompressMessageTool(ctx) {
   ctx.prompts.reload();
   const runtimePrompts = ctx.prompts.getRuntimePrompts();
+  const externalModelEnabled = ctx.config.compress.externalModel !== void 0;
   return tool({
-    description: runtimePrompts.compressMessage + MESSAGE_FORMAT_EXTENSION,
-    args: buildSchema(),
+    description: runtimePrompts.compressMessage + buildMessageFormatExtension(externalModelEnabled),
+    args: buildSchema(externalModelEnabled),
     async execute(args, toolCtx) {
       const input = args;
       validateArgs(input);
@@ -4204,9 +4400,29 @@ function createCompressMessageTool(ctx) {
       if (plans.length === 0 && skippedCount > 0) {
         throw new Error(formatIssues(skippedIssues, skippedCount));
       }
+      if (ctx.config.compress.externalModel) {
+        for (const plan of plans) {
+          if (plan.entry.summary === void 0) {
+            const userContent = extractMessageText(plan.entry.messageId, searchContext);
+            const generated = await generateSummaryViaExternal(
+              ctx.config.compress.externalModel,
+              {
+                systemPrompt: runtimePrompts.compressMessage,
+                userContent
+              }
+            );
+            plan.entry.summary = generated;
+          }
+        }
+      }
       const notifications = [];
       const preparedPlans = [];
       for (const plan of plans) {
+        if (plan.entry.summary === void 0) {
+          throw new Error(
+            "\u7F3A\u5C11 summary\uFF1A\u672A\u914D\u7F6E\u5916\u90E8\u6A21\u578B\uFF0C\u8BF7\u63D0\u4F9B summary \u6216\u914D\u7F6E OPENCODE_DCP_EXTERNAL_COMPRESS_URL/MODEL"
+          );
+        }
         const summaryWithPromptInfo = appendProtectedPromptInfo(
           plan.entry.summary,
           plan.selection,
@@ -4287,8 +4503,10 @@ function validateArgs2(args) {
     if (typeof entry?.endId !== "string" || entry.endId.trim().length === 0) {
       throw new Error(`${prefix}.endId is required and must be a non-empty string`);
     }
-    if (typeof entry?.summary !== "string" || entry.summary.trim().length === 0) {
-      throw new Error(`${prefix}.summary is required and must be a non-empty string`);
+    if (entry?.summary !== void 0) {
+      if (typeof entry.summary !== "string" || entry.summary.trim().length === 0) {
+        throw new Error(`${prefix}.summary must be a non-empty string when provided`);
+      }
     }
   }
 }
@@ -4494,16 +4712,34 @@ ${right}`;
 }
 
 // lib/compress/range.ts
-function buildSchema2() {
+function extractRangeText(selection, searchContext) {
+  const parts = [];
+  for (const messageId of selection.messageIds) {
+    const msg = searchContext.rawMessagesById.get(messageId);
+    if (!msg) continue;
+    for (const part of msg.parts) {
+      if (part.type === "text" && typeof part.text === "string") {
+        parts.push(part.text);
+      }
+    }
+  }
+  return parts.join("\n\n");
+}
+function buildSchema2(externalModelEnabled) {
+  const summaryField = externalModelEnabled ? tool2.schema.string().optional().describe(
+    "Complete technical summary replacing all content in range (optional when external model is configured)"
+  ) : tool2.schema.string().describe("Complete technical summary replacing all content in range");
   return {
     topic: tool2.schema.string().describe("Short label (3-5 words) for display - e.g., 'Auth System Exploration'"),
     content: tool2.schema.array(
       tool2.schema.object({
         startId: tool2.schema.string().describe(
-          "Message or block ID marking the beginning of range (e.g. m0001, b2)"
+          "Injected message or block ID visible in the current context marking the beginning of the range. Do not invent IDs; use an exact visible mNNNN or bN boundary."
+        ),
+        endId: tool2.schema.string().describe(
+          "Injected message or block ID visible in the current context marking the end of the range. Do not invent IDs; use an exact visible mNNNN or bN boundary."
         ),
-        endId: tool2.schema.string().describe("Message or block ID marking the end of range (e.g. m0012, b5)"),
-        summary: tool2.schema.string().describe("Complete technical summary replacing all content in range")
+        summary: summaryField
       })
     ).describe(
       "One or more ranges to compress, each with start/end boundaries and a summary"
@@ -4513,9 +4749,10 @@ function buildSchema2() {
 function createCompressRangeTool(ctx) {
   ctx.prompts.reload();
   const runtimePrompts = ctx.prompts.getRuntimePrompts();
+  const externalModelEnabled = ctx.config.compress.externalModel !== void 0;
   return tool2({
-    description: runtimePrompts.compressRange + RANGE_FORMAT_EXTENSION,
-    args: buildSchema2(),
+    description: runtimePrompts.compressRange + buildRangeFormatExtension(externalModelEnabled),
+    args: buildSchema2(externalModelEnabled),
     async execute(args, toolCtx) {
       const input = args;
       validateArgs2(input);
@@ -4527,10 +4764,30 @@ function createCompressRangeTool(ctx) {
       );
       const resolvedPlans = resolveRanges(input, searchContext, ctx.state);
       validateNonOverlapping(resolvedPlans);
+      if (ctx.config.compress.externalModel) {
+        for (const plan of resolvedPlans) {
+          if (plan.entry.summary === void 0) {
+            const userContent = extractRangeText(plan.selection, searchContext);
+            const generated = await generateSummaryViaExternal(
+              ctx.config.compress.externalModel,
+              {
+                systemPrompt: runtimePrompts.compressRange,
+                userContent
+              }
+            );
+            plan.entry.summary = generated;
+          }
+        }
+      }
       const notifications = [];
       const preparedPlans = [];
       let totalCompressedMessages = 0;
       for (const plan of resolvedPlans) {
+        if (plan.entry.summary === void 0) {
+          throw new Error(
+            "\u7F3A\u5C11 summary\uFF1A\u672A\u914D\u7F6E\u5916\u90E8\u6A21\u578B\uFF0C\u8BF7\u63D0\u4F9B summary \u6216\u914D\u7F6E OPENCODE_DCP_EXTERNAL_COMPRESS_URL/MODEL"
+          );
+        }
         const parsedPlaceholders = parseBlockPlaceholders(plan.entry.summary);
         const missingBlockIds = validateSummaryPlaceholders(
           parsedPlaceholders,
@@ -4882,44 +5139,51 @@ import { homedir as homedir4 } from "os";
 
 // lib/prompts/system.ts
 var SYSTEM = `
-\u4F60\u5728\u4E00\u4E2A\u4E0A\u4E0B\u6587\u53D7\u9650\u7684\u73AF\u5883\u4E2D\u8FD0\u884C\u3002\u6301\u7EED\u7BA1\u7406\u4E0A\u4E0B\u6587\u4EE5\u907F\u514D\u5806\u79EF\u5E76\u4FDD\u6301\u68C0\u7D22\u8D28\u91CF\u3002\u9AD8\u6548\u7684\u4E0A\u4E0B\u6587\u7BA1\u7406\u5BF9\u4F60\u7684\u4EE3\u7406\u6027\u80FD\u81F3\u5173\u91CD\u8981\u3002
+You run in a context-limited environment. Manage context actively to avoid accumulation and keep retrieval quality high.
+
+Your only context-management tool is \`compress\`. It replaces older conversation content with a technical summary you generate.
+
+Hard constraints
+- Context management is done ONLY by calling \`compress\`. Never produce summaries in plain text.
+- NEVER output \`<summary>\` or \`<analysis>\` XML tags in text responses \u2014 they cause system errors.
+- If context needs compression, call \`compress\`. Do not write summaries inline.
+- Use Markdown headings (e.g. \`## Analysis\`, \`## Summary\`) to organize information. Never use XML tags.
 
-\u4F60\u7528\u4E8E\u4E0A\u4E0B\u6587\u7BA1\u7406\u7684\u552F\u4E00\u5DE5\u5177\u662F \`compress\`\u3002\u5B83\u7528\u4F60\u751F\u6210\u7684\u6280\u672F\u6458\u8981\u66FF\u6362\u8F83\u65E7\u7684\u5BF9\u8BDD\u5185\u5BB9\u3002
+\`\` and \`\` are environment-injected metadata. Do not output them.
 
-\u5173\u952E\u7EA6\u675F
-- \u4E0A\u4E0B\u6587\u7BA1\u7406\u4EC5\u901A\u8FC7\u8C03\u7528 \`compress\` \u5DE5\u5177\u5B8C\u6210\u3002\u7EDD\u4E0D\u4EE5\u7EAF\u6587\u672C\u5F62\u5F0F\u751F\u6210\u6458\u8981\u3002
-- **\u4E25\u683C\u7981\u6B62**\u5728\u6587\u672C\u54CD\u5E94\u4E2D\u8F93\u51FA \`<summary>\` \u6216 \`<analysis>\` XML \u6807\u7B7E\u3002\u8FD9\u4E9B\u6807\u7B7E\u4F1A\u5BFC\u81F4\u7CFB\u7EDF\u9519\u8BEF\u3002
-- \u5982\u679C\u4F60\u8BA4\u4E3A\u4E0A\u4E0B\u6587\u9700\u8981\u538B\u7F29\uFF0C\u8C03\u7528 \`compress\` \u5DE5\u5177\u3002\u4E0D\u8981\u5185\u8054\u7F16\u5199\u6458\u8981\u3002
-- \u6240\u6709\u8F93\u51FA\u5FC5\u987B\u4F7F\u7528**\u4E2D\u6587**\u3002
-- \u5982\u679C\u9700\u8981\u5728\u6587\u672C\u4E2D\u7EC4\u7EC7\u4FE1\u606F\uFF0C\u4F7F\u7528 Markdown \u683C\u5F0F\uFF08\u5982 \`## \u5206\u6790\`\u3001\`## \u603B\u7ED3\`\uFF09\uFF0C\u7EDD\u4E0D\u4F7F\u7528 XML \u6807\u7B7E\u3002
+When to compress
 
-\`\` \u548C \`\` \u6807\u7B7E\u662F\u73AF\u5883\u6CE8\u5165\u7684\u5143\u6570\u636E\u3002\u4E0D\u8981\u8F93\u51FA\u5B83\u4EEC\u3002
+HIGHEST-PRIORITY HARD TRIGGER \u2014 call \`compress\` immediately whenever the conversation TOPIC changes. Compress the previous topic's finished context into a summary.
 
-\u538B\u7F29\u7684\u54F2\u5B66
-\`compress\` \u5C06\u5BF9\u8BDD\u5185\u5BB9\u8F6C\u6362\u4E3A\u5BC6\u96C6\u3001\u9AD8\u4FDD\u771F\u7684\u6458\u8981\u3002\u8FD9\u4E0D\u662F\u6E05\u7406\u2014\u2014\u800C\u662F\u7ED3\u6676\u3002\u4F60\u7684\u6458\u8981\u6210\u4E3A\u6240\u53D1\u751F\u4E8B\u60C5\u7684\u6743\u5A01\u8BB0\u5F55\u3002
+A topic change is an objective, low-judgment signal, not a subjective call. Any of these counts:
 
-\u5C06\u538B\u7F29\u89C6\u4E3A\u76F8\u53D8\uFF1A\u539F\u59CB\u63A2\u7D22\u53D8\u4E3A\u7CBE\u70BC\u7406\u89E3\u3002\u539F\u59CB\u4E0A\u4E0B\u6587\u5DF2\u5B8C\u6210\u5176\u4F7F\u547D\uFF1B\u4F60\u7684\u6458\u8981\u73B0\u5728\u627F\u8F7D\u8BE5\u7406\u89E3\u5411\u524D\u3002
+- The user raises a task or question unrelated to the previous one
+- The focus shifts from one module/file/feature to another
+- The goal shifts from explore/research \u2192 implement, or implement \u2192 debug/verify
+- A distinct problem is resolved and you move to the next
 
-\u4F55\u65F6\u538B\u7F29
+When any occurs, compress the finished range of the previous topic at once. Do not wait. This is the single most effective way to keep context clear.
 
-\u5F53\u4E00\u4E2A\u90E8\u5206\u771F\u6B63\u5173\u95ED\u4E14\u539F\u59CB\u5BF9\u8BDD\u5DF2\u5B8C\u6210\u5176\u4F7F\u547D\u65F6\uFF1A
+Also compress (when a section genuinely closes even without a topic change):
 
-- \u7814\u7A76\u5DF2\u5B8C\u6210\u4E14\u53D1\u73B0\u5DF2\u660E\u786E
-- \u5B9E\u73B0\u5DF2\u5B8C\u6210\u5E76\u9A8C\u8BC1
-- \u63A2\u7D22\u5DF2\u7A77\u5C3D\u4E14\u6A21\u5F0F\u5DF2\u7406\u89E3
-- \u6B7B\u80E1\u540C\u566A\u97F3\u53EF\u4EE5\u5728\u4E0D\u7B49\u5F85\u6574\u4E2A\u7AE0\u8282\u5173\u95ED\u7684\u60C5\u51B5\u4E0B\u88AB\u4E22\u5F03
+- Research is done and findings are settled
+- Implementation is complete and verified
+- Exploration is exhausted and patterns understood
+- Dead-end noise can be dropped without waiting for the whole section to close
 
-\u4E0D\u8981\u538B\u7F29\u7684\u60C5\u51B5
+Do NOT compress when:
 
-- \u539F\u59CB\u4E0A\u4E0B\u6587\u4ECD\u7136\u76F8\u5173\u4E14\u9700\u8981\u7528\u4E8E\u7F16\u8F91\u6216\u7CBE\u786E\u5F15\u7528
-- \u76EE\u6807\u5185\u5BB9\u4ECD\u5728\u79EF\u6781\u8FDB\u884C\u4E2D
-- \u4F60\u53EF\u80FD\u5728\u63A5\u4E0B\u6765\u7684\u6B65\u9AA4\u4E2D\u9700\u8981\u786E\u5207\u7684\u4EE3\u7801\u3001\u9519\u8BEF\u6D88\u606F\u6216\u6587\u4EF6\u5185\u5BB9
+- Raw context is still needed for editing or exact reference
+- The target work is actively in progress
+- You may need the exact code, error message, or file content in the next steps
 
-\u538B\u7F29\u524D\u95EE\u81EA\u5DF1\uFF1A_"\u8FD9\u4E2A\u90E8\u5206\u73B0\u5728\u662F\u5426\u8DB3\u591F\u5173\u95ED\u4EE5\u6210\u4E3A\u4EC5\u6458\u8981\uFF1F"_
+Ask yourself before compressing: _"Is this section closed enough to be summary-only?"_
 
-\u5B9A\u671F\u8BC4\u4F30\u5BF9\u8BDD\u7684\u4FE1\u566A\u6BD4\u3002\u6709\u610F\u8BC6\u5730\u4F7F\u7528 \`compress\` \u5E76\u63D0\u4F9B\u9AD8\u8D28\u91CF\u6458\u8981\u3002\u667A\u80FD\u5730\u4F18\u5148\u5904\u7406\u8FC7\u65F6\u5185\u5BB9\uFF0C\u4EE5\u7EF4\u62A4\u652F\u6301\u4F60\u4EE3\u7406\u80FD\u529B\u7684\u9AD8\u4FE1\u53F7\u4E0A\u4E0B\u6587\u7A97\u53E3\u3002
+If the answer is "the topic switched, the old content is no longer needed" \u2014 the answer is always yes.
 
-\u4FDD\u6301\u9510\u5229\u3001\u9AD8\u8D28\u91CF\u7684\u4E0A\u4E0B\u6587\u7A97\u53E3\u4EE5\u83B7\u5F97\u6700\u4F73\u6027\u80FD\u662F\u4F60\u7684\u8D23\u4EFB\u3002
+Periodically assess the conversation's signal-to-noise ratio. Use \`compress\` deliberately and provide high-quality summaries. Prioritize stale content to maintain a high-signal context window.
+
+Keeping a sharp, high-quality context window for best performance is your responsibility.
 `;
 
 // lib/prompts/compress-range.ts
@@ -5056,32 +5320,44 @@ var COMPRESS_MESSAGE = `\u5C06\u5BF9\u8BDD\u4E2D\u9009\u5B9A\u7684\u5355\u6761\u
 
 // lib/prompts/context-limit-nudge.ts
 var CONTEXT_LIMIT_NUDGE = `<dcp-system-reminder>
-\u4E25\u91CD\u8B66\u544A\uFF1A\u5DF2\u8FBE\u5230\u6700\u5927\u4E0A\u4E0B\u6587\u9650\u5236
+CRITICAL: max context limit reached.
 
-\u4F60\u5F53\u524D\u5904\u4E8E\u6216\u5DF2\u8D85\u8FC7\u914D\u7F6E\u7684\u6700\u5927\u4E0A\u4E0B\u6587\u9608\u503C\u3002\u8FD9\u662F\u7D27\u6025\u7684\u4E0A\u4E0B\u6587\u6062\u590D\u65F6\u523B\u3002
+You are at or beyond the configured max context threshold. This is an emergency context-recovery moment.
 
-\u4F60\u5FC5\u987B\u7ACB\u5373\u4F7F\u7528 \`compress\` \u5DE5\u5177\u3002\u5728\u5B8C\u6210\u538B\u7F29\u4E4B\u524D\uFF0C\u4E0D\u8981\u7EE7\u7EED\u6B63\u5E38\u63A2\u7D22\u3002
+You MUST call \`compress\` now. Do not continue normal exploration until compression is done.
 
-\u5982\u679C\u4F60\u6B63\u5728\u8FDB\u884C\u5173\u952E\u7684\u539F\u5B50\u64CD\u4F5C\uFF0C\u5148\u5B8C\u6210\u8BE5\u539F\u5B50\u6B65\u9AA4\uFF0C\u7136\u540E\u7ACB\u5373\u538B\u7F29\u3002
+If mid-atomic-step, finish that one step, then compress immediately.
 
-\u9009\u62E9\u8FC7\u7A0B
-\u4ECE\u8F83\u65E9\u7684\u3001\u5DF2\u5B8C\u6210\u7684\u5386\u53F2\u5F00\u59CB\uFF0C\u5728\u4E00\u6B21\u64CD\u4F5C\u4E2D\u6355\u83B7\u5C3D\u53EF\u80FD\u591A\u7684\u8FC7\u65F6\u4E0A\u4E0B\u6587\u3002
-\u9664\u975E\u6700\u65B0\u7684\u5DE5\u4F5C\u6D88\u606F\u5DF2\u660E\u663E\u7ED3\u675F\uFF0C\u5426\u5219\u4E0D\u8981\u9009\u62E9\u5B83\u4EEC\u3002
+Selection
+Start from older, already-finished history and capture as much stale context as possible in one pass.
+Do not select the latest working messages unless they are clearly concluded.
 
-\u6458\u8981\u8981\u6C42
-\u4F60\u7684\u6458\u8981\u5FC5\u987B\u8986\u76D6\u6240\u9009\u6D88\u606F\u4E2D\u7684\u6240\u6709\u5173\u952E\u7EC6\u8282\uFF0C\u4EE5\u786E\u4FDD\u5DE5\u4F5C\u53EF\u4EE5\u7EE7\u7EED\u3002
-\u5982\u679C\u538B\u7F29\u8303\u56F4\u5305\u542B\u7528\u6237\u6D88\u606F\uFF0C\u5B8C\u6574\u4FDD\u7559\u7528\u6237\u610F\u56FE\u3002\u5BF9\u4E8E\u8F83\u77ED\u7684\u7528\u6237\u6D88\u606F\uFF0C\u4F18\u5148\u4F7F\u7528\u76F4\u63A5\u5F15\u7528\u4EE5\u907F\u514D\u8BED\u4E49\u6F02\u79FB\u3002
+Summary requirements
+Your summary must cover all key details in the selected messages so work can continue.
+If the range contains user messages, preserve their intent fully. For short user messages, prefer direct quotes to avoid semantic drift.
 </dcp-system-reminder>
 `;
 
 // lib/prompts/turn-nudge.ts
 var TURN_NUDGE = `
-\u4E0A\u4E0B\u6587\u4F7F\u7528\u91CF\u5904\u4E8E\u4E2D\u7B49\u6C34\u5E73\u3002\u8003\u8651\u538B\u7F29\u5DF2\u5B8C\u6210\u7684\u5BF9\u8BDD\u8F6E\u6B21\u4EE5\u91CA\u653E\u7A7A\u95F4\u3002
+New user turn. This is the moment topic changes are most likely.
+
+Is this turn's request a different topic/task from the previous one?
+- New or independent topic: call \`compress\` now to fold the previous topic's finished context into a summary. Its details no longer need verbatim retention.
+- Continuation of the same topic: you may keep it, but still watch for stale accumulation.
+
+Topic change is the clearest, most objective compression trigger \u2014 do not miss it.
 `;
 
 // lib/prompts/iteration-nudge.ts
 var ITERATION_NUDGE = `
-\u5DF2\u8FDB\u884C\u591A\u6B21\u8FED\u4EE3\u4F46\u672A\u6536\u5230\u65B0\u7684\u7528\u6237\u8F93\u5165\u3002\u8003\u8651\u538B\u7F29\u65E9\u671F\u6B65\u9AA4\u4EE5\u4FDD\u6301\u4E0A\u4E0B\u6587\u6E05\u6670\u3002
+Many iterations elapsed without new user input.
+
+Has the current iteration's task effectively finished, or has its topic drifted away from earlier steps?
+- If earlier steps belong to a resolved problem or a superseded exploration, call \`compress\` now to fold them into a summary.
+- If the iteration still continues the same unfinished goal and early context is still needed, keep it.
+
+Do not let finished exploration directions keep occupying context. Topic drift is the best moment to compress.
 `;
 
 // lib/prompts/extensions/system.ts