opencode-readseek 0.9.5 → 0.9.6

package/dist/index.js

@@ -22,11 +22,10 @@ var DOCUMENT_NODE_KINDS = [
   "structural_section"
 ];
 var TOOL_NAMES = [
-  "read",
+  "digest",
   "edit",
   "write",
   "grep",
-  "digest",
   "view",
   "search",
   "def",
@@ -103,11 +102,10 @@ var PARAM_DESCRIPTIONS = {
   scopeContext: "Context lines within each symbol"
 };
 var TOOL_DESCRIPTIONS = {
-  read: "Read anchored text by range or symbol. Standalone images require an explicit mode. Use it before edits to obtain fresh `LINE:HASH` anchors; use `view` for documents and `digest` with the map facet for structural outlines.",
+  digest: "Digest source content and images into the native CLI envelope. Returns metadata plus requested facets unchanged from `readseek digest`. Use it before edits to obtain fresh `LINE:HASH` anchors; use for structural maps, diagnostics, and cursor identity.",
   edit: 'Edit existing text files with fresh `LINE:HASH` anchors. Read or search first when no fresh anchors are available. Each `edits[]` item must use exactly one nested object: `{"set_line":{"anchor":"LINE:HASH","new_text":"..."}}`, `{"replace_lines":{"start_anchor":"LINE:HASH","end_anchor":"LINE:HASH","new_text":"..."}}`, `{"insert_after":{"anchor":"LINE:HASH","new_text":"..."}}`, `{"replace_symbol":{"symbol":"name","new_body":"..."}}`, or `{"replace":{"old_text":"...","new_text":"..."}}`.',
   write: "Create or replace a complete text file and return `LINE:HASH` anchors. Use `edit` for small changes to an existing file.",
   grep: "Search text or regex in files and return edit-ready `LINE:HASH` anchors. Use for identifiers, strings, configuration, errors, comments, and documentation.",
-  digest: "Digest source content and images into the native CLI envelope. Returns metadata plus requested facets unchanged from `readseek digest`; use for structural maps, diagnostics, and cursor identity.",
   view: "Digest a document's structure or selected content. Start with the overview, then narrow by page, node, kind, or depth instead of reading the whole document. PDF is the first supported document format.",
   search: "Search code by AST structure using ast-grep-style patterns. Results include line hashes usable as `LINE:HASH` anchors. Use `grep` for identifiers, strings, comments, configuration, documentation, or other plain text and regex.",
   def: "Go to a symbol definition or declaration by name. Accepts qualified or unqualified names; use this instead of text search for functions, methods, classes, types, and other declarations.",
@@ -115,7 +113,10 @@ var TOOL_DESCRIPTIONS = {
   rename: "Rename a symbol at a source location. Resolvable same-named bindings are preserved; verified edits apply by default. Set `apply: false` to preview the plan before changing files."
 };
 function renderToolDescription(name, aliases = {}) {
-  return TOOL_NAMES.reduce((description, toolName) => description.replaceAll(`\`${toolName}\``, `\`${aliases[toolName] ?? toolName}\``), TOOL_DESCRIPTIONS[name]);
+  const desc = TOOL_DESCRIPTIONS[name];
+  if (!desc)
+    throw new Error(`Missing TOOL_DESCRIPTIONS for ${name}`);
+  return TOOL_NAMES.reduce((description, toolName) => description.replaceAll(`\`${toolName}\``, `\`${aliases[toolName] ?? toolName}\``), desc);
 }
 var gitFlagsSchema = {
   cached: {
@@ -194,25 +195,27 @@ var editItemSchema = {
 };
 var TOOL_CONTRACTS = [
   {
-    name: "read",
-    title: "Read anchored text",
-    description: TOOL_DESCRIPTIONS.read,
+    name: "digest",
+    title: "Digest source",
+    description: TOOL_DESCRIPTIONS.digest,
     inputSchema: {
       type: "object",
       properties: {
         path: { type: "string", description: PARAM_DESCRIPTIONS.path },
-        offset: { type: "integer", minimum: 1, description: PARAM_DESCRIPTIONS.offset },
-        limit: { type: "integer", minimum: 1, description: PARAM_DESCRIPTIONS.readLimit },
-        symbol: { type: "string", description: PARAM_DESCRIPTIONS.symbolRead },
-        bundle: {
+        select: { type: "string", description: PARAM_DESCRIPTIONS.select },
+        at: { type: "string", description: PARAM_DESCRIPTIONS.at },
+        end: { type: "integer", minimum: 1, description: PARAM_DESCRIPTIONS.end },
+        limit: { type: "integer", minimum: 1, description: PARAM_DESCRIPTIONS.limit },
+        language: { type: "string", description: PARAM_DESCRIPTIONS.languageOverride },
+        visionMode: {
           type: "string",
-          enum: ["local"],
-          description: PARAM_DESCRIPTIONS.bundle
+          enum: [...VISION_MODES],
+          description: PARAM_DESCRIPTIONS.visionModeDigest
         },
-        image: {
+        visionLevel: {
           type: "string",
-          enum: [...VISION_MODES],
-          description: PARAM_DESCRIPTIONS.image
+          enum: [...VISION_LEVELS],
+          description: PARAM_DESCRIPTIONS.visionLevel
         }
       },
       required: ["path"],
@@ -286,34 +289,6 @@ var TOOL_CONTRACTS = [
       additionalProperties: false
     }
   },
-  {
-    name: "digest",
-    title: "Digest source",
-    description: TOOL_DESCRIPTIONS.digest,
-    inputSchema: {
-      type: "object",
-      properties: {
-        path: { type: "string", description: PARAM_DESCRIPTIONS.path },
-        select: { type: "string", description: PARAM_DESCRIPTIONS.select },
-        at: { type: "string", description: PARAM_DESCRIPTIONS.at },
-        end: { type: "integer", minimum: 1, description: PARAM_DESCRIPTIONS.end },
-        limit: { type: "integer", minimum: 1, description: PARAM_DESCRIPTIONS.limit },
-        language: { type: "string", description: PARAM_DESCRIPTIONS.languageOverride },
-        visionMode: {
-          type: "string",
-          enum: [...VISION_MODES],
-          description: PARAM_DESCRIPTIONS.visionModeDigest
-        },
-        visionLevel: {
-          type: "string",
-          enum: [...VISION_LEVELS],
-          description: PARAM_DESCRIPTIONS.visionLevel
-        }
-      },
-      required: ["path"],
-      additionalProperties: false
-    }
-  },
   {
     name: "view",
     title: "View document",
@@ -774,7 +749,7 @@ var MAX_DOCUMENT_OUTPUT_LINES = 2000;
 var TOOL_POLICY = [
   "ReadSeek tool policy:",
   "- Prefer readseek_* tools over built-ins when they can do the job.",
-  "- Read with readseek_read first; readseek_edit needs fresh LINE:HASH anchors.",
+  "- Read with readseek_digest first; readseek_edit needs fresh LINE:HASH anchors.",
   "- Use readseek_grep for text/regex, readseek_search for AST patterns, and readseek_digest/def/refs for symbol navigation.",
   "- Use readseek_edit for existing files, readseek_write for whole-file creation or replacement, and readseek_rename for symbol renames.",
   "- Do not use built-in read, edit, write, grep, or apply_patch when a ReadSeek tool can do the job.",
@@ -786,7 +761,6 @@ function openCodeToolDescription(name) {
   return renderToolDescription(name, OPENCODE_TOOL_ALIASES);
 }
 var PREFERRED_TOOL_DESCRIPTIONS = {
-  readseek_read: "Preferred file reader; returns LINE:HASH anchors for durable references.",
   readseek_edit: "Preferred tool for editing existing text files with fresh LINE:HASH anchors.",
   readseek_write: "Preferred tool for creating or replacing a complete text file; returns LINE:HASH anchors.",
   readseek_rename: "Use to rename a symbol with binding-aware, verified edits.",
@@ -798,7 +772,6 @@ var PREFERRED_TOOL_DESCRIPTIONS = {
   readseek_view: "Use to digest document structure or selected content."
 };
 var FALLBACK_TOOL_DESCRIPTIONS = {
-  read: "Fallback only. Prefer readseek_read so edits can use LINE:HASH anchors.",
   edit: "Fallback only. Prefer readseek_edit with fresh LINE:HASH anchors.",
   write: "Fallback only. Prefer readseek_write so the result returns LINE:HASH anchors.",
   grep: "Fallback only. Prefer readseek_grep for text/regex search with edit-ready anchors.",
@@ -816,46 +789,6 @@ function resolveImagePolicy(options) {
     return value;
   throw new Error('opencode-readseek imageMode must be "on", "auto", or "off"');
 }
-function isVisualFile(value) {
-  const output = record(value);
-  const type = output.type;
-  return typeof output.width === "number" || typeof type === "string" && type.startsWith("image/");
-}
-function isVisualBoundsError(error) {
-  if (!(error instanceof Error))
-    return false;
-  const message = error.message.replace(/^error:\s*/, "");
-  return message.startsWith("--end") && /(?:does|do) not apply to images/.test(message);
-}
-function isDocumentBoundsError(error) {
-  if (!(error instanceof Error))
-    return false;
-  const message = error.message.replace(/^error:\s*/, "");
-  return /(?:does|do) not apply to (?:documents|PDFs)/.test(message) || /document content belongs to view/.test(message) || /source facets do not apply to documents/.test(message);
-}
-function isPdfFile(value) {
-  const output = record(value);
-  return output.format === "pdf" || output.type === "application/pdf";
-}
-function documentReceipt(filePath, envelope) {
-  const recordEnvelope = record(envelope);
-  return {
-    file: filePath,
-    use: "readseek_view",
-    reason: "document content belongs to readseek_view",
-    metadata: digestMetadata(envelope),
-    ...recordEnvelope.cache !== undefined ? { cache: recordEnvelope.cache } : {}
-  };
-}
-async function digestDocumentReceipt(context, filePath) {
-  const cacheDir = await ensureReadSeekCache(context);
-  const envelope = await runReadSeek(context, [
-    "--readseek-dir",
-    cacheDir,
-    ...digestArgs(filePath, "metadata")
-  ]);
-  return documentReceipt(filePath, envelope);
-}
 function digestArgs(filePath, select, extra = []) {
   return [...buildDigestArgs({ path: filePath, select }), ...extra];
 }
@@ -866,10 +799,6 @@ function requireDigestFacet(envelope, facet) {
   }
   return value;
 }
-function digestMetadata(envelope) {
-  return record(record(envelope).metadata);
-}
-
 class SessionAnchors {
   #pathsBySession = new Map;
   #renamePlans = new Map;
@@ -1062,12 +991,6 @@ async function authorizeEdit(context, filePaths, diff = "", authorizeExternalPat
 function withAt(args, line, column) {
   args.push("--at", buildLineLocation(line, column));
 }
-function isLikelyImagePath(filePath) {
-  return /\.(avif|bmp|gif|heic|heif|ico|jpe?g|png|svg|tiff?|webp)$/i.test(filePath);
-}
-function isLikelyDocumentPath(filePath) {
-  return /\.pdf$/i.test(filePath);
-}
 function readRangeArgs(filePath, start, end) {
   const extra = [];
   if (start > 1)
@@ -1366,43 +1289,6 @@ function boundDocumentOutput(value) {
   return truncated ? `${output}
 [… document view truncated; narrow it with page, node, kind, or depth]` : output;
 }
-function attachmentExtension(mime) {
-  switch (mime) {
-    case "image/gif":
-      return "gif";
-    case "image/jpeg":
-      return "jpg";
-    case "image/png":
-      return "png";
-    case "image/webp":
-      return "webp";
-    default:
-      return "bin";
-  }
-}
-function imageAttachment(image, filename) {
-  if (image.encoding !== "base64" || typeof image.data !== "string" || typeof image.mime !== "string") {
-    return;
-  }
-  return {
-    type: "file",
-    mime: image.mime,
-    url: `data:${image.mime};base64,${image.data}`,
-    filename: `${filename}.${attachmentExtension(image.mime)}`
-  };
-}
-function formatReadResult(value) {
-  const output = record(value);
-  if (output.use === "readseek_view")
-    return { output: render(value) };
-  const attachment = imageAttachment(output, "image");
-  if (!attachment)
-    return { output: render(value) };
-  const sanitized = { ...output };
-  delete sanitized.data;
-  delete sanitized.encoding;
-  return { output: render(sanitized), attachments: [attachment] };
-}
 function previewDiffLine(prefix, line) {
   const value = `${prefix}${line}`;
   const maxBytes = 256;
@@ -1651,100 +1537,6 @@ var ReadSeekPlugin = async (_input, options) => {
   const imageModes = imagePolicy === "auto" ? ["none", "all", "ocr", "caption", "objects"] : ["all", "ocr", "caption", "objects"];
   return {
     tool: {
-      readseek_read: readseekTool(imagePolicy === "off" ? `${openCodeToolDescription("read")} Image reads are disabled.` : `${openCodeToolDescription("read")} Available image modes: ${imageModes.join(", ")}.`, {
-        path: tool.schema.string().describe("Path relative to the project directory"),
-        offset: tool.schema.number().int().positive().optional().describe("One-based starting line"),
-        limit: tool.schema.number().int().positive().optional().describe(`Maximum number of lines; defaults to ${DEFAULT_READ_LIMIT}`),
-        language: tool.schema.string().optional().describe("Language override when auto-detection is ambiguous"),
-        ...imagePolicy === "off" ? {} : {
-          image: tool.schema.enum(imageModes).optional().describe("Standalone image processing mode")
-        }
-      }, "read", async (input, context) => {
-        const filePath = resolvePath(context.directory, input.path);
-        await authorizeRead(context, filePath);
-        const image = input.image;
-        if (imagePolicy === "off" && image !== undefined)
-          throw new Error("image reads are disabled");
-        if (imagePolicy === "on" && image === "none")
-          throw new Error('image="none" requires imageMode="auto"');
-        if (isLikelyDocumentPath(filePath)) {
-          if (image !== undefined)
-            throw new Error("image does not apply to documents; use readseek_view");
-          if (input.offset !== undefined || input.limit !== undefined) {
-            throw new Error("offset and limit do not apply to documents; use readseek_view");
-          }
-          if (input.language !== undefined) {
-            throw new Error("language does not apply to documents; use readseek_view");
-          }
-          return digestDocumentReceipt(context, filePath);
-        }
-        let detectedText = false;
-        if (image === undefined && isLikelyImagePath(filePath)) {
-          const envelope2 = await runReadSeek(context, digestArgs(filePath, "metadata"));
-          const metadata2 = digestMetadata(envelope2);
-          if (isPdfFile(metadata2))
-            return documentReceipt(filePath, envelope2);
-          if (isVisualFile(metadata2)) {
-            return { file: filePath, skipped: true, reason: "image mode not selected" };
-          }
-          detectedText = true;
-        }
-        const extra = [];
-        const wantsImage = !detectedText && (image !== undefined || isLikelyImagePath(filePath));
-        if (!wantsImage) {
-          const start = input.offset ?? 1;
-          const end = start + (input.limit ?? DEFAULT_READ_LIMIT) - 1;
-          if (start > 1)
-            withAt(extra, start);
-          extra.push("--end", String(end));
-          if (input.language)
-            extra.push("--language", input.language);
-        } else {
-          if (input.offset !== undefined || input.limit !== undefined) {
-            throw new Error("offset and limit do not apply to image reads");
-          }
-          if (input.language !== undefined) {
-            throw new Error("language does not apply to image reads");
-          }
-          if (image !== undefined)
-            extra.push("--vision-mode", image);
-        }
-        let envelope;
-        try {
-          envelope = await runReadSeek(context, digestArgs(filePath, "content", extra), image !== undefined && image !== "none" ? { timeoutMs: DEFAULT_VISION_TIMEOUT_MS } : {});
-        } catch (error) {
-          if (image !== undefined)
-            throw error;
-          if (isDocumentBoundsError(error)) {
-            return digestDocumentReceipt(context, filePath);
-          }
-          if (isVisualBoundsError(error)) {
-            const metadataEnvelope = await runReadSeek(context, digestArgs(filePath, "metadata"));
-            if (isPdfFile(digestMetadata(metadataEnvelope))) {
-              return documentReceipt(filePath, metadataEnvelope);
-            }
-            if (isVisualFile(digestMetadata(metadataEnvelope))) {
-              return { file: filePath, skipped: true, reason: "image mode not selected" };
-            }
-          }
-          throw error;
-        }
-        const metadata = digestMetadata(envelope);
-        if (isPdfFile(metadata) || record(envelope).cache !== undefined) {
-          return documentReceipt(filePath, envelope);
-        }
-        const visual = isVisualFile(metadata);
-        if (visual && image === undefined) {
-          return { file: filePath, skipped: true, reason: "image mode not selected" };
-        }
-        if (visual && (input.offset !== undefined || input.limit !== undefined)) {
-          throw new Error("offset and limit do not apply to image reads");
-        }
-        if (visual && input.language !== undefined) {
-          throw new Error("language does not apply to image reads");
-        }
-        return requireDigestFacet(envelope, "content");
-      }, formatReadResult),
       readseek_view: readseekTool(openCodeToolDescription("view"), {
         path: tool.schema.string().describe("Document path relative to the project directory"),
         node: tool.schema.string().min(1).optional().describe(PARAM_DESCRIPTIONS.node),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-readseek",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "OpenCode plugin for anchored file operations and structural code navigation",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,7 +33,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.9.5",
+    "@jarkkojs/readseek": "^0.9.6",
     "@opencode-ai/plugin": "^1.17.20"
   },
   "devDependencies": {