opencode-readseek 0.11.1 → 0.11.3

package/dist/index.js

@@ -39,7 +39,6 @@ var PARAM_DESCRIPTIONS = {
   projectSearchPath: "File or directory to search; defaults to the project directory",
   searchPath: "File or directory to search; defaults to the current directory",
   language: "Language override when auto-detection is ambiguous",
-  languageOverride: "Language override",
   languageSymbol: "Language override for symbol replacement",
   pattern: "AST pattern (ast-grep style), such as console.log($$$ARGS)",
   patternContext: "Surrounding code context for sub-statement patterns",
@@ -56,14 +55,10 @@ var PARAM_DESCRIPTIONS = {
   end: "Last line to include",
   limit: "Maximum number of lines to include",
   depth: "Maximum structural depth for structure output; defaults to 1 in agent tools",
-  offset: "One-based starting line",
-  readLimit: "Maximum lines to return",
-  symbolRead: "Symbol name to read",
-  bundle: "Include related symbols from the same file; requires symbol",
   level: "Explicit inference level: low (default), medium, or high",
   include: "Additional caption tasks: text and/or objects",
   kind: "Restrict structure to this node kind",
-  outline: "Return a symbol outline",
+  outline: "Show outline of document hierarchy or source symbols",
   noAnchors: "Omit source line anchors",
   text: "Literal native text query; adapter find_text also supports regex via pattern",
   edits: "Use set_line, replace_lines, insert_after, replace_symbol, or replace",
@@ -119,11 +114,14 @@ var TOOL_DESCRIPTIONS = {
   rename_symbol: "Rename a symbol at a line or hash cursor with binding-aware edits and stale-plan protection.",
   write_file: "Create or replace a complete text file and return `LINE:HASH` anchors. Use `edit_text` for small changes."
 };
+function rewriteBacktickedToolNames(text, aliases = {}) {
+  return TOOL_NAMES.reduce((rewritten, toolName) => rewritten.replaceAll(`\`${toolName}\``, `\`${aliases[toolName] ?? toolName}\``), text);
+}
 function renderToolDescription(name, aliases = {}) {
   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);
+  return rewriteBacktickedToolNames(desc, aliases);
 }
 var gitScopeSchema = {
   gitScope: {
@@ -212,7 +210,7 @@ var TOOL_CONTRACTS = [
   tool("show_metadata", "Show metadata", { ...path, ...lang, ...stdin }, ["path"]),
   tool("show_assets", "Show assets", { ...path, at: string(PARAM_DESCRIPTIONS.assetAt), ...stdin }, ["path"]),
   tool("check_syntax", "Check syntax", { ...path, ...lang, ...stdin }, ["path"]),
-  tool("check_rules", "Check rules", { ...path, ...gitScopeSchema, rules: string(PARAM_DESCRIPTIONS.rules) }, ["rules"]),
+  tool("check_rules", "Check rules", { path: string(PARAM_DESCRIPTIONS.searchPath), ...gitScopeSchema, rules: string(PARAM_DESCRIPTIONS.rules) }, ["rules"]),
   tool("generate_caption", "Generate caption", { ...path, ...at, ...stdin, ...level, include: { type: "array", items: { type: "string", enum: ["text", "objects"] }, minItems: 1, uniqueItems: true, description: PARAM_DESCRIPTIONS.include } }, ["path"]),
   tool("detect_objects", "Detect objects", { ...path, ...at, ...stdin, ...level }, ["path"]),
   tool("recognize_text", "Recognize text", { ...path, ...at, ...stdin, ...level }, ["path"]),
@@ -236,12 +234,12 @@ var PREFERENCE_LEADS = {
   show_content: "Preferred for reading source with anchors.",
   edit_text: "Preferred for editing existing text files with fresh LINE:HASH anchors.",
   write_file: "Preferred for creating or replacing a complete text file; returns LINE:HASH anchors.",
-  find_text: "Preferred text/regex find_nodes; returns edit_text-ready LINE:HASH anchors.",
-  find_nodes: "Preferred for AST or structural code find_nodes with ast-find_text-style patterns.",
+  find_text: "Preferred text/regex search; returns edit-ready LINE:HASH anchors.",
+  find_nodes: "Preferred for AST or structural code search with ast-grep-style patterns.",
   find_definitions: "Preferred for go-to-definition or declaration lookup by name.",
   find_references: "Preferred for finding identifier-name matches or binding-specific references before rename_symbol or delete.",
   rename_symbol: "Preferred for renaming a symbol with binding-aware, verified edits.",
-  show_assets: "Preferred for saving a selected document asset to a file."
+  show_assets: "Preferred for materializing selected document assets with usable cached paths."
 };
 var FALLBACK_TEMPLATES = {
   read: "Prefer `show_content` with fresh LINE:HASH anchors.",
@@ -253,9 +251,6 @@ var FALLBACK_TEMPLATES = {
 function resolveToolName(name, aliases = {}) {
   return aliases[name] ?? name;
 }
-function rewriteBacktickedToolNames(text, aliases = {}) {
-  return TOOL_NAMES.reduce((rewritten, toolName) => rewritten.replaceAll(`\`${toolName}\``, `\`${resolveToolName(toolName, aliases)}\``), text);
-}
 function renderPreferredToolDescription(name, aliases = {}) {
   return rewriteBacktickedToolNames(PREFERENCE_LEADS[name] ?? `Preferred for ${name.replaceAll("_", " ")} with ReadSeek.`, aliases);
 }
@@ -276,15 +271,6 @@ function renderToolRoutingPolicy(options = {}) {
   const find_references = resolveToolName("find_references", aliases);
   const rename_symbol = resolveToolName("rename_symbol", aliases);
   const show_assets = resolveToolName("show_assets", aliases);
-  if (options.style === "server") {
-    return [
-      "Structural code navigation, document inspection, and hash-verified edits with readseek.",
-      "For structural questions, prefer these tools to text Grep/Bash: targeted definitions, references, and AST patterns; shallow show_structure views; check_syntax diagnostics and show_content cursor context; and document inspection.",
-      `Use ${edit_text} for LINE:HASH-anchored mutations (preview with apply=false; apply defaults to true and re-checks plan_hash).`,
-      "Paths resolve against CLAUDE_PROJECT_DIR. Native Read/Grep/Edit hooks provide passive context;",
-      "call MCP tools for active navigation, document questions, or anchored edits."
-    ].join(" ");
-  }
   const title = options.title ?? "ReadSeek tool policy:";
   const bullets = [];
   if (options.preferOverBuiltIns) {
@@ -1044,10 +1030,10 @@ function text(value) {
 function count(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
 }
-function safe(value) {
+function safe(value, preserveTabs = false) {
   return value.replace(/[\x00-\x09\x0b-\x1f\x7f-\x9f]/g, (char) => {
     if (char === "\t")
-      return "\\t";
+      return preserveTabs ? char : "\\t";
     if (char === "\r")
       return "\\r";
     return `\\x${char.charCodeAt(0).toString(16).padStart(2, "0")}`;
@@ -1207,7 +1193,7 @@ ${assetList(assets)}`);
     const lang = text(metadata.language || content.language);
     if (lang)
       summary.push(inline(lang));
-    const rows = lines.map((line) => `${line.line}${options.noAnchors ? "" : `:${text(line.hash)}`} | ${safe(text(line.text)).replaceAll("\\n", "\\\\n")}`);
+    const rows = lines.map((line) => `${line.line}${options.noAnchors ? "" : `:${text(line.hash)}`} | ${safe(text(line.text), true)}`);
     const identifier = record(cursor.identifier);
     if (count(cursor.line) !== undefined)
       result.metadata.line = cursor.line;
@@ -2405,7 +2391,7 @@ function initialTitle(kind, args) {
     case "find_definitions":
       return `Find definition ${args.name}`;
     case "find_references":
-      return `Find references to ${args.name}`;
+      return `Find references to ${args.name ?? args.at}`;
     case "rename_symbol":
       return `Rename ${args.path}:${args.at} to ${args.to}`;
     case "edit_text":
@@ -2964,7 +2950,7 @@ var ReadSeekPlugin = async (_input, options) => {
       if (!input.tool.startsWith("readseek_"))
         return;
       try {
-        const result = JSON.parse(output.output);
+        const result = output.metadata.readseek ?? JSON.parse(output.output);
         if (input.tool === "readseek_rename_symbol") {
           anchors.planRename(input.sessionID, result);
           if (record2(result).applied === true) {

package/package.json

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