opencode-acp 1.6.0 → 1.7.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAyBjD,QAAA,MAAM,MAAM,EAAE,MAkHK,CAAA;AAEnB,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA0BjD,QAAA,MAAM,MAAM,EAAE,MAmHK,CAAA;AAEnB,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -1526,7 +1526,7 @@ var defaultConfig = {
     protectTags: false,
     protectUserMessages: false,
     maxSummaryLength: 200,
-    maxSummaryLengthHard: 800,
+    maxSummaryLengthHard: 3e3,
     minCompressRange: 2e3
   },
   strategies: {
@@ -1841,7 +1841,7 @@ Using previous/default values`
 }
 
 // lib/compress/message.ts
-import { tool } from "@opencode-ai/plugin";
+import { tool as tool2 } from "@opencode-ai/plugin";
 
 // lib/token-utils.ts
 import * as _anthropicTokenizer from "@anthropic-ai/tokenizer";
@@ -2219,6 +2219,7 @@ function allocateNextMessageRef(state) {
 }
 
 // lib/compress/search.ts
+import { tool } from "@opencode-ai/plugin";
 async function fetchSessionMessages(client, sessionId) {
   const response = await client.session.messages({
     path: { id: sessionId }
@@ -2430,6 +2431,120 @@ function buildBoundaryLookup(context, state) {
   }
   return lookup;
 }
+var SEARCH_CONTEXT_TOOL_DESCRIPTION = `Search through all compressed block summaries AND visible messages to find relevant content. Use this BEFORE decompressing to find the right block. Returns a hit list with block/message IDs, relevance scores, and previews.
+
+Examples:
+- search_context({ query: "decoder accuracy" }) \u2014 find blocks/messages about decoder accuracy
+- search_context({ query: "training loss PPL" }) \u2014 find training results
+- search_context({ query: "architecture design", limit: 5 }) \u2014 top 5 results`;
+function countOccurrences(text, term) {
+  if (!text || !term) return 0;
+  let count = 0;
+  let idx = 0;
+  while ((idx = text.indexOf(term, idx)) !== -1) {
+    count++;
+    idx += term.length;
+  }
+  return count;
+}
+function buildSearchPreview(text, firstTerm) {
+  if (!text) return "";
+  const matchIdx = text.toLowerCase().indexOf(firstTerm);
+  if (matchIdx >= 0) {
+    const start = Math.max(0, matchIdx - 50);
+    const end = Math.min(text.length, matchIdx + 150);
+    return (start > 0 ? "..." : "") + text.substring(start, end) + (end < text.length ? "..." : "");
+  }
+  return text.substring(0, 200) + (text.length > 200 ? "..." : "");
+}
+function createSearchContextTool(ctx) {
+  ctx.prompts.reload();
+  return tool({
+    description: SEARCH_CONTEXT_TOOL_DESCRIPTION,
+    args: {
+      query: tool.schema.string().describe("Search query \u2014 keywords or phrase to find"),
+      limit: tool.schema.number().optional().describe("Maximum results to return (default: 10)"),
+      deep: tool.schema.boolean().optional().describe("If true, also search visible (uncompressed) messages. Slower but more thorough (default: false)")
+    },
+    async execute(args) {
+      const query = (args.query || "").toLowerCase().trim();
+      const limit = args.limit ?? 10;
+      if (!query) {
+        return "Error: query is required.";
+      }
+      const queryTerms = query.split(/\s+/).filter((t) => t.length > 0);
+      const results = [];
+      const MIN_RELEVANCE = 0.1;
+      const blocksById = ctx.state.prune.messages.blocksById;
+      for (const [blockId, block] of blocksById) {
+        if (!block.active) continue;
+        const topic = (block.topic || "").toLowerCase();
+        const summary = (block.summary || "").toLowerCase();
+        let relevance = 0;
+        let termsHit = 0;
+        for (const term of queryTerms) {
+          let termHit = false;
+          const topicCount = countOccurrences(topic, term);
+          if (topicCount > 0) {
+            relevance += Math.min(topicCount * 0.15, 0.45);
+            termHit = true;
+          }
+          const summaryCount = countOccurrences(summary, term);
+          if (summaryCount > 0) {
+            relevance += Math.min(summaryCount * 0.04, 0.2);
+            termHit = true;
+          }
+          if (termHit) termsHit++;
+        }
+        if (termsHit === queryTerms.length && queryTerms.length > 1) {
+          relevance *= 1.2;
+        }
+        if (queryTerms.length > 1 && query.includes(" ")) {
+          if (topic.includes(query) || summary.includes(query)) {
+            relevance += 0.25;
+          }
+        }
+        relevance = Math.min(relevance, 1);
+        if (relevance < MIN_RELEVANCE) continue;
+        const origSummary = block.summary || "";
+        const preview = buildSearchPreview(origSummary, queryTerms[0]);
+        results.push({
+          type: "block",
+          id: `b${blockId}`,
+          relevance,
+          label: block.topic || "(no topic)",
+          preview,
+          action: `\u2192 decompress(b${blockId}) for full content`
+        });
+      }
+      results.sort((a, b) => b.relevance - a.relevance);
+      const limited = results.slice(0, limit);
+      if (limited.length === 0) {
+        return `No matches found for "${args.query}". Try different keywords.`;
+      }
+      const lines = [];
+      lines.push(
+        `\u{1F50D} Found ${results.length} matches for "${args.query}" (showing top ${limited.length}):`
+      );
+      lines.push("");
+      for (const result of limited) {
+        const icon = result.type === "block" ? "\u{1F4E6}" : "\u{1F4C4}";
+        const stars = "\u2B50".repeat(Math.ceil(result.relevance * 5));
+        lines.push(
+          `${icon} [${result.id}] ${stars} (${result.relevance.toFixed(2)}) "${result.label}"`
+        );
+        lines.push(`   ${result.preview}`);
+        lines.push(`   ${result.action}`);
+        lines.push("");
+      }
+      let output = lines.join("\n");
+      if (output.length > 3e3) {
+        output = output.substring(0, 3e3) + "\n... (truncated, refine query for more specific results)";
+      }
+      return output;
+    }
+  });
+}
 
 // lib/compress/state.ts
 var DEFAULT_PROMOTION_THRESHOLD = 5;
@@ -3620,20 +3735,20 @@ function matchesGlob(inputPath, pattern) {
   regex += "$";
   return new RegExp(regex).test(input);
 }
-function getFilePathsFromParameters(tool4, parameters) {
+function getFilePathsFromParameters(tool5, parameters) {
   if (typeof parameters !== "object" || parameters === null) {
     return [];
   }
   const paths = [];
   const params = parameters;
-  if (tool4 === "apply_patch" && typeof params.patchText === "string") {
+  if (tool5 === "apply_patch" && typeof params.patchText === "string") {
     const pathRegex = /\*\*\* (?:Add|Delete|Update) File: ([^\n\r]+)/g;
     let match;
     while ((match = pathRegex.exec(params.patchText)) !== null) {
       paths.push(match[1].trim());
     }
   }
-  if (tool4 === "multiedit") {
+  if (tool5 === "multiedit") {
     if (typeof params.filePath === "string") {
       paths.push(params.filePath);
     }
@@ -3728,13 +3843,13 @@ var deduplicate = (state, logger, config, messages) => {
     logger.debug(`Marked ${newPruneIds.length} duplicate tool calls for pruning`);
   }
 };
-function createToolSignature(tool4, parameters) {
+function createToolSignature(tool5, parameters) {
   if (!parameters) {
-    return tool4;
+    return tool5;
   }
   const normalized = normalizeParameters(parameters);
   const sorted = sortObjectKeys(normalized);
-  return `${tool4}::${JSON.stringify(sorted)}`;
+  return `${tool5}::${JSON.stringify(sorted)}`;
 }
 function normalizeParameters(params) {
   if (typeof params !== "object" || params === null) return params;
@@ -3809,9 +3924,9 @@ var purgeErrors = (state, logger, config, messages) => {
 };
 
 // lib/ui/utils.ts
-function extractParameterKey(tool4, parameters) {
+function extractParameterKey(tool5, parameters) {
   if (!parameters) return "";
-  if (tool4 === "read" && parameters.filePath) {
+  if (tool5 === "read" && parameters.filePath) {
     const offset = parameters.offset;
     const limit = parameters.limit;
     if (offset !== void 0 && limit !== void 0) {
@@ -3825,10 +3940,10 @@ function extractParameterKey(tool4, parameters) {
     }
     return parameters.filePath;
   }
-  if ((tool4 === "write" || tool4 === "edit" || tool4 === "multiedit") && parameters.filePath) {
+  if ((tool5 === "write" || tool5 === "edit" || tool5 === "multiedit") && parameters.filePath) {
     return parameters.filePath;
   }
-  if (tool4 === "apply_patch" && typeof parameters.patchText === "string") {
+  if (tool5 === "apply_patch" && typeof parameters.patchText === "string") {
     const pathRegex = /\*\*\* (?:Add|Delete|Update) File: ([^\n\r]+)/g;
     const paths = [];
     let match;
@@ -3845,51 +3960,51 @@ function extractParameterKey(tool4, parameters) {
     }
     return "patch";
   }
-  if (tool4 === "list") {
+  if (tool5 === "list") {
     return parameters.path || "(current directory)";
   }
-  if (tool4 === "glob") {
+  if (tool5 === "glob") {
     if (parameters.pattern) {
       const pathInfo = parameters.path ? ` in ${parameters.path}` : "";
       return `"${parameters.pattern}"${pathInfo}`;
     }
     return "(unknown pattern)";
   }
-  if (tool4 === "grep") {
+  if (tool5 === "grep") {
     if (parameters.pattern) {
       const pathInfo = parameters.path ? ` in ${parameters.path}` : "";
       return `"${parameters.pattern}"${pathInfo}`;
     }
     return "(unknown pattern)";
   }
-  if (tool4 === "bash") {
+  if (tool5 === "bash") {
     if (parameters.description) return parameters.description;
     if (parameters.command) {
       return parameters.command.length > 50 ? parameters.command.substring(0, 50) + "..." : parameters.command;
     }
   }
-  if (tool4 === "webfetch" && parameters.url) {
+  if (tool5 === "webfetch" && parameters.url) {
     return parameters.url;
   }
-  if (tool4 === "websearch" && parameters.query) {
+  if (tool5 === "websearch" && parameters.query) {
     return `"${parameters.query}"`;
   }
-  if (tool4 === "codesearch" && parameters.query) {
+  if (tool5 === "codesearch" && parameters.query) {
     return `"${parameters.query}"`;
   }
-  if (tool4 === "todowrite") {
+  if (tool5 === "todowrite") {
     return `${parameters.todos?.length || 0} todos`;
   }
-  if (tool4 === "todoread") {
+  if (tool5 === "todoread") {
     return "read todo list";
   }
-  if (tool4 === "task" && parameters.description) {
+  if (tool5 === "task" && parameters.description) {
     return parameters.description;
   }
-  if (tool4 === "skill" && parameters.name) {
+  if (tool5 === "skill" && parameters.name) {
     return parameters.name;
   }
-  if (tool4 === "lsp") {
+  if (tool5 === "lsp") {
     const op = parameters.operation || "lsp";
     const path = parameters.filePath || "";
     const line = parameters.line;
@@ -3902,7 +4017,7 @@ function extractParameterKey(tool4, parameters) {
     }
     return op;
   }
-  if (tool4 === "question") {
+  if (tool5 === "question") {
     const questions = parameters.questions;
     if (Array.isArray(questions) && questions.length > 0) {
       const headers = questions.map((q) => q.header || "").filter(Boolean).slice(0, 3);
@@ -4483,14 +4598,14 @@ ${output}`);
 // lib/compress/message.ts
 function buildSchema(maxSummaryLength) {
   return {
-    topic: tool.schema.string().describe(
+    topic: tool2.schema.string().describe(
       "Short label (3-5 words) for the overall batch - e.g., 'Closed Research Notes'"
     ),
-    content: tool.schema.array(
-      tool.schema.object({
-        messageId: tool.schema.string().describe("Raw message ID to compress (e.g. m00001)"),
-        topic: tool.schema.string().describe("Short label (3-5 words) for this one message summary"),
-        summary: tool.schema.string().describe(
+    content: tool2.schema.array(
+      tool2.schema.object({
+        messageId: tool2.schema.string().describe("Raw message ID to compress (e.g. m00001)"),
+        topic: tool2.schema.string().describe("Short label (3-5 words) for this one message summary"),
+        summary: tool2.schema.string().describe(
           `Complete technical summary replacing that one message. Aim for <=${maxSummaryLength} chars; exceed only when strictly necessary to preserve critical detail (file paths, decisions, signatures, exact values). Never pad.`
         )
       })
@@ -4500,7 +4615,7 @@ function buildSchema(maxSummaryLength) {
 function createCompressMessageTool(ctx) {
   ctx.prompts.reload();
   const runtimePrompts = ctx.prompts.getRuntimePrompts();
-  return tool({
+  return tool2({
     description: runtimePrompts.compressMessage + MESSAGE_FORMAT_EXTENSION,
     args: buildSchema(ctx.config.compress.maxSummaryLength),
     async execute(args, toolCtx) {
@@ -4510,7 +4625,7 @@ function createCompressMessageTool(ctx) {
       for (const entry of input.content) {
         if (entry.summary.length > maxSummaryLengthHard) {
           throw new Error(
-            `Summary too long (${entry.summary.length} chars, hard ceiling ${maxSummaryLengthHard}). Aim for <=${ctx.config.compress.maxSummaryLength}; exceed only when strictly necessary. Rewrite more concisely.`
+            `Summary too long (${entry.summary.length} chars; limit ${maxSummaryLengthHard}). Rewrite to under ${maxSummaryLengthHard} chars \u2014 keep only the most essential details (conclusions, file paths, decisions, exact values) and drop verbose narration or raw dumps.`
           );
         }
       }
@@ -4613,7 +4728,7 @@ function createCompressMessageTool(ctx) {
 }
 
 // lib/compress/range.ts
-import { tool as tool2 } from "@opencode-ai/plugin";
+import { tool as tool3 } from "@opencode-ai/plugin";
 
 // lib/compress/range-utils.ts
 var BLOCK_PLACEHOLDER_REGEX = /\(b(\d+)\)|\{block_(\d+)\}/gi;
@@ -4757,14 +4872,14 @@ function appendMissingBlockSummaries(summary, _missingBlockIds, _summaryByBlockI
 // lib/compress/range.ts
 function buildSchema2(maxSummaryLength) {
   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(
+    topic: tool3.schema.string().describe("Short label (3-5 words) for display - e.g., 'Auth System Exploration'"),
+    content: tool3.schema.array(
+      tool3.schema.object({
+        startId: tool3.schema.string().describe(
           "Message or block ID marking the beginning of range (e.g. m00001, b2)"
         ),
-        endId: tool2.schema.string().describe("Message or block ID marking the end of range (e.g. m00012, b5)"),
-        summary: tool2.schema.string().describe(
+        endId: tool3.schema.string().describe("Message or block ID marking the end of range (e.g. m00012, b5)"),
+        summary: tool3.schema.string().describe(
           `Complete technical summary replacing all content in range. Aim for <=${maxSummaryLength} chars; exceed only when strictly necessary to preserve critical detail (file paths, decisions, signatures, exact values). Never pad.`
         )
       })
@@ -4776,7 +4891,7 @@ function buildSchema2(maxSummaryLength) {
 function createCompressRangeTool(ctx) {
   ctx.prompts.reload();
   const runtimePrompts = ctx.prompts.getRuntimePrompts();
-  return tool2({
+  return tool3({
     description: runtimePrompts.compressRange + RANGE_FORMAT_EXTENSION,
     args: buildSchema2(ctx.config.compress.maxSummaryLength),
     async execute(args, toolCtx) {
@@ -4786,7 +4901,7 @@ function createCompressRangeTool(ctx) {
       for (const entry of input.content) {
         if (entry.summary.length > maxSummaryLengthHard) {
           throw new Error(
-            `Summary too long (${entry.summary.length} chars, hard ceiling ${maxSummaryLengthHard}). Aim for <=${ctx.config.compress.maxSummaryLength}; exceed only when strictly necessary. Rewrite more concisely.`
+            `Summary too long (${entry.summary.length} chars; limit ${maxSummaryLengthHard}). Rewrite to under ${maxSummaryLengthHard} chars \u2014 keep only the most essential details (conclusions, file paths, decisions, exact values) and drop verbose narration or raw dumps.`
           );
         }
       }
@@ -4923,7 +5038,8 @@ function createCompressRangeTool(ctx) {
       }
       await finalizeSession(ctx, toolCtx, rawMessages, notifications, input.topic);
       return `Compressed ${totalCompressedMessages} messages into ${COMPRESSED_BLOCK_HEADER}.
-IMPORTANT: This was an automatic context compression. You MUST continue your previous task exactly where you left off. Do NOT ask the user what to do next.`;
+IMPORTANT: This was an automatic context compression. You MUST continue your previous task exactly where you left off. Do NOT ask the user what to do next.
+\u{1F4A1} Tip: Use search_context('keyword') to find compressed content when you need it later.`;
     }
   });
 }
@@ -4940,7 +5056,7 @@ function extractBoundaryConsumedBlocks(startReference, endReference) {
 }
 
 // lib/compress/decompress.ts
-import { tool as tool3 } from "@opencode-ai/plugin";
+import { tool as tool4 } from "@opencode-ai/plugin";
 
 // lib/messages/utils.ts
 import { createHash } from "crypto";
@@ -5392,8 +5508,8 @@ var resolveEffectiveCompressPermission = (basePermission, hostPermissions, agent
     agentName ? hostPermissions.agents[agentName] : void 0
   ) ? "deny" : basePermission;
 };
-var hasExplicitToolPermission = (permissionConfig, tool4) => {
-  return permissionConfig ? Object.prototype.hasOwnProperty.call(permissionConfig, tool4) : false;
+var hasExplicitToolPermission = (permissionConfig, tool5) => {
+  return permissionConfig ? Object.prototype.hasOwnProperty.call(permissionConfig, tool5) : false;
 };
 
 // lib/compress-permission.ts
@@ -6495,11 +6611,11 @@ IMPORTANT:
 - Do NOT call this tool in parallel with compress \u2014 their state mutations may conflict.`;
 function buildSchema3() {
   return {
-    blockId: tool3.schema.string().describe('Block reference to decompress (e.g., "b0", "b2")')
+    blockId: tool4.schema.string().describe('Block reference to decompress (e.g., "b0", "b2")')
   };
 }
 function createDecompressTool(ctx) {
-  return tool3({
+  return tool4({
     description: TOOL_DESCRIPTION,
     args: buildSchema3(),
     async execute(args, toolCtx) {
@@ -6785,7 +6901,7 @@ var SYSTEM = `
 
 You operate in a context-constrained environment. Context management helps preserve retrieval quality, but your primary goal is completing the task at hand. Do not let context management distract from the actual work.
 
-The tools you have for context management are \`compress\` and \`decompress\`. \`compress\` replaces older conversation content with technical summaries you produce. \`decompress\` restores previously compressed content when you need exact details.
+The tools you have for context management are \`compress\`, \`decompress\`, and \`search_context\`. \`compress\` replaces older conversation content with technical summaries you produce. \`decompress\` restores previously compressed content when you need exact details. \`search_context\` searches compressed block summaries (and visible messages) to locate relevant content before you decompress.
 
 \`<dcp-message-id>\` and \`<dcp-system-reminder>\` tags are environment-injected metadata. Do not output them.
 
@@ -6793,13 +6909,13 @@ COMPRESSION PHILOSOPHY
 
 Compression replaces raw conversation content with dense summaries. When used correctly, it keeps your context sharp and focused. When used carelessly, it destroys information you need.
 
-The key principle: compress proactively to keep context lean, but selectively. Large tool outputs (shell, diffs, logs) can be compressed into summaries at any time \u2014 you can decompress later if needed. Extract and keep what matters: user intent, key decisions, file paths, and important findings \u2014 even if buried in large messages. Compress everything else, including verbose parts of user messages, large code dumps, and long discussions.
+The key principle: compress selectively to keep context lean \u2014 but never compress content you're actively using for an ongoing task. Compression is for COMPLETED work, not work in progress. Before compressing, ask: "Will I need this in the next few turns?" If yes or unsure, keep it. Large tool outputs (shell, diffs, logs) can be compressed into summaries after the task using them is done \u2014 you can decompress later if needed. Extract and keep what matters: user intent, key decisions, file paths, and important findings \u2014 even if buried in large messages. Compress everything else, including verbose parts of user messages, large code dumps, and long discussions.
 
 Target the largest UNCOMPRESSED content first. Savings scale with original size \u2014 compressing a 5000-token tool output frees far more than re-shrinking an already-summarized 300-token block.
 
 CONTEXT PRESSURE LEVELS
 
-- Normal: Be frugal \u2014 compress large completed outputs into summaries. You can decompress later if needed.
+- Normal: After completing a task or sub-task, compress its tool outputs (agent results, verbose commands, large tool outputs) into summaries. Do NOT compress content you're actively using for an ongoing task \u2014 wait until the task is complete. You can decompress later if needed.
 - Elevated: Context is growing \u2014 compress completed sections and high-token waste now.
 - Critical: Compress aggressively now \u2014 preserve only what is essential for the current task.
 
@@ -6849,6 +6965,8 @@ Generate recovery breadcrumbs in your summary so future-you can reconstruct the
 
 If you later realize you need the original details from a compressed block, use \`decompress\` to restore them. You can decompress, read the content, then re-compress if needed.
 
+Use \`search_context\` to find relevant compressed content before decompressing \u2014 it returns ranked matches across all active block summaries so you can pick the right block ID without inflating context by trial-and-error decompression.
+
 Use \`compress\` and \`decompress\` deliberately with quality-first summaries. Prioritize stale content intelligently to maintain a high-signal context window.
 `;
 
@@ -7801,7 +7919,7 @@ var COMPRESS_TRIGGER_PROMPT = [
   "Follow the active compress mode, preserve all critical implementation details, and choose safe targets.",
   "Return after compress with a brief explanation of what content was compressed."
 ].join("\n\n");
-function getTriggerPrompt(tool4, state, config, userFocus) {
+function getTriggerPrompt(tool5, state, config, userFocus) {
   const base = COMPRESS_TRIGGER_PROMPT;
   const compressedBlockGuidance = config.compress.mode === "message" ? "" : buildCompressedBlockGuidance(state, config.gc);
   const sections = [base, compressedBlockGuidance];
@@ -7830,8 +7948,8 @@ async function handleManualToggleCommand(ctx, modeArg) {
   );
   logger.info("Manual mode toggled", { manualMode: state.manualMode });
 }
-async function handleManualTriggerCommand(ctx, tool4, userFocus) {
-  return getTriggerPrompt(tool4, ctx.state, ctx.config, userFocus);
+async function handleManualTriggerCommand(ctx, tool5, userFocus) {
+  return getTriggerPrompt(tool5, ctx.state, ctx.config, userFocus);
 }
 function applyPendingManualTrigger(state, messages, logger) {
   const pending = state.pendingManualTrigger;
@@ -9091,7 +9209,8 @@ var server = (async (ctx) => {
     tool: {
       ...config.compress.permission !== "deny" && {
         compress: config.compress.mode === "message" ? createCompressMessageTool(compressToolContext) : createCompressRangeTool(compressToolContext),
-        decompress: createDecompressTool(compressToolContext)
+        decompress: createDecompressTool(compressToolContext),
+        search_context: createSearchContextTool(compressToolContext)
       }
     },
     config: async (opencodeConfig) => {
@@ -9107,7 +9226,7 @@ var server = (async (ctx) => {
       }
       const toolsToAdd = [];
       if (config.compress.permission !== "deny" && !config.experimental.allowSubAgents) {
-        toolsToAdd.push("compress", "decompress");
+        toolsToAdd.push("compress", "decompress", "search_context");
       }
       if (toolsToAdd.length > 0) {
         const existingPrimaryTools = opencodeConfig.experimental?.primary_tools ?? [];