@lexwdex-org/opencode-dcp 3.3.4 → 3.4.1

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,18 @@ 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 = `
+\`\`\`${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 +1889,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 +2059,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 +2082,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 +2199,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 +2527,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 +4248,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 +4368,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 +4376,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 +4398,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 +4501,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,7 +4710,23 @@ ${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(
@@ -4503,7 +4735,7 @@ function buildSchema2() {
           "Message or block ID marking the beginning of range (e.g. m0001, b2)"
         ),
         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 +4745,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 +4760,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,