opencode-readseek 0.9.5 → 0.9.7

package/dist/index.js

@@ -1,9 +1,11 @@
 // index.ts
-import { lstat, mkdir, open, readFile, readlink, realpath, stat } from "node:fs/promises";
+import path7 from "node:path";
+
+// src/client.ts
 import { createRequire as createRequire2 } from "node:module";
 import { homedir } from "node:os";
-import path2 from "node:path";
-import { tool } from "@opencode-ai/plugin";
+import path3 from "node:path";
+import { stat } from "node:fs/promises";
 
 // ../readseek-api/src/contract.ts
 var VISION_MODES = ["none", "all", "ocr", "caption", "objects"];
@@ -22,11 +24,10 @@ var DOCUMENT_NODE_KINDS = [
   "structural_section"
 ];
 var TOOL_NAMES = [
-  "read",
+  "digest",
   "edit",
   "write",
   "grep",
-  "digest",
   "view",
   "search",
   "def",
@@ -35,6 +36,8 @@ var TOOL_NAMES = [
 ];
 var PARAM_DESCRIPTIONS = {
   path: "Absolute or relative file path",
+  projectPath: "Path relative to the project directory",
+  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",
@@ -88,6 +91,7 @@ var PARAM_DESCRIPTIONS = {
   symbol: "Mapped symbol name",
   newBody: "Complete replacement body for the symbol",
   apply: "When supported by the host, apply the verified plan instead of previewing only",
+  applyDefaultTrue: "Apply the verified edits; defaults to true",
   planHash: "Require the apply plan to match this dry-run plan hash",
   workspace: "Rename across the project",
   to: "New symbol name",
@@ -103,11 +107,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 +118,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 +200,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 +294,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",
@@ -416,6 +396,88 @@ var TOOL_CONTRACTS = [
     }
   }
 ];
+// ../readseek-api/src/policy.ts
+var BUILTIN_FALLBACKS = {
+  read: "digest",
+  edit: "edit",
+  write: "write",
+  grep: "grep",
+  apply_patch: "edit"
+};
+var PREFERENCE_LEADS = {
+  digest: "Preferred for reading source with anchors and facets.",
+  edit: "Preferred for editing existing text files with fresh LINE:HASH anchors.",
+  write: "Preferred for creating or replacing a complete text file; returns LINE:HASH anchors.",
+  grep: "Preferred text/regex search; returns edit-ready LINE:HASH anchors.",
+  search: "Preferred for AST or structural code search with ast-grep-style patterns.",
+  def: "Preferred for go-to-definition or declaration lookup by name.",
+  refs: "Preferred for finding identifier-name matches or binding-specific references before rename or delete.",
+  rename: "Preferred for renaming a symbol with binding-aware, verified edits.",
+  view: "Preferred for digesting document structure or selected content."
+};
+var FALLBACK_TEMPLATES = {
+  read: "Fallback only. Prefer `digest` with fresh LINE:HASH anchors.",
+  edit: "Fallback only. Prefer `edit` with fresh LINE:HASH anchors.",
+  write: "Fallback only. Prefer `write` so the result returns LINE:HASH anchors.",
+  grep: "Fallback only. Prefer `grep` for text/regex search with edit-ready anchors.",
+  apply_patch: "Fallback only. Prefer `edit` for existing text files."
+};
+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], aliases);
+}
+function renderFallbackToolDescription(builtIn, aliases = {}) {
+  const template = FALLBACK_TEMPLATES[builtIn];
+  if (!template)
+    return;
+  return rewriteBacktickedToolNames(template, aliases);
+}
+function renderToolRoutingPolicy(options = {}) {
+  const aliases = options.aliases ?? {};
+  const digest = resolveToolName("digest", aliases);
+  const edit = resolveToolName("edit", aliases);
+  const write = resolveToolName("write", aliases);
+  const grep = resolveToolName("grep", aliases);
+  const search = resolveToolName("search", aliases);
+  const def = resolveToolName("def", aliases);
+  const refs = resolveToolName("refs", aliases);
+  const rename = resolveToolName("rename", aliases);
+  const view = resolveToolName("view", aliases);
+  if (options.style === "server") {
+    return [
+      "Structural code navigation, document viewing, and hash-verified edits with readseek.",
+      "For structural questions, prefer these tools to text Grep/Bash: definitions, references, AST search, multi-facet digest (content/map/diagnostics/identity), and document views.",
+      `Use ${edit} 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) {
+    bullets.push("- Prefer ReadSeek tools over built-ins when they can do the job.");
+  }
+  bullets.push(`- Read with ${digest} first; ${edit} needs fresh LINE:HASH anchors.`, `- Use ${grep} for text/regex, ${search} for AST patterns, and ${digest}/${def}/${refs} for symbol navigation.`, `- Use ${edit} for existing files, ${write} for whole-file creation or replacement, and ${rename} for symbol renames.`, `- Use ${view} for document structure; run ${digest} with select diagnostics after source edits for a quick syntax check.`);
+  if (options.demoteBuiltIns && options.demoteBuiltIns.length > 0) {
+    bullets.push(`- Do not use built-in ${options.demoteBuiltIns.join(", ")} when a ReadSeek tool can do the job.`);
+  }
+  return [title, ...bullets].join(`
+`);
+}
+function preferredToolDescriptionMap(aliases = {}) {
+  return Object.fromEntries(TOOL_NAMES.map((name) => [resolveToolName(name, aliases), renderPreferredToolDescription(name, aliases)]));
+}
+function fallbackToolDescriptionMap(builtIns = Object.keys(BUILTIN_FALLBACKS), aliases = {}) {
+  return Object.fromEntries(builtIns.flatMap((builtIn) => {
+    const description = renderFallbackToolDescription(builtIn, aliases);
+    return description ? [[builtIn, description]] : [];
+  }));
+}
 // ../readseek-api/src/validation.ts
 function validateGitSelection(input) {
   if (input.ignored && !input.others) {
@@ -764,50 +826,103 @@ async function runReadSeekBunText(binaryPath, args, options = {}) {
 async function runReadSeekBunJson(binaryPath, args, options = {}) {
   return parseSuccessfulJson(await runReadSeekBun(binaryPath, args, options));
 }
-// index.ts
-var resolveFromHost = createRequire2(import.meta.url).resolve;
+// src/constants.ts
 var DEFAULT_VISION_TIMEOUT_MS = 30 * 60 * 1000;
 var DEFAULT_READ_LIMIT = 2000;
 var EDIT_RESULT_READ_LIMIT = 40;
 var MAX_DOCUMENT_OUTPUT_BYTES = 256 * 1024;
 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.",
-  "- 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.",
-  "- Run readseek_digest with select=diagnostics after source edits for a quick syntax check."
-].join(`
-`);
-var OPENCODE_TOOL_ALIASES = Object.fromEntries(TOOL_NAMES.map((name) => [name, `readseek_${name}`]));
-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.",
-  readseek_grep: "Preferred text/regex search; returns edit-ready LINE:HASH anchors.",
-  readseek_search: "Use for AST or structural code search with ast-grep-style patterns.",
-  readseek_digest: "Use to digest native facets (metadata, content, map, diagnostics, identity) and return the full envelope.",
-  readseek_def: "Use for go-to-definition or declaration lookup by name.",
-  readseek_refs: "Use to find identifier-name matches or binding-specific references before rename or delete.",
-  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.",
-  apply_patch: "Fallback only. Prefer readseek_edit for existing text files."
-};
+var MAX_PERMISSION_DIFF_BYTES = 32 * 1024;
 var IMAGE_MODES = [...VISION_MODES];
 var VISION_ANALYSIS_MODE_VALUES = [...VISION_ANALYSIS_MODES];
 var VISION_LEVEL_VALUES = [...VISION_LEVELS];
 var DOCUMENT_NODE_KIND_VALUES = [...DOCUMENT_NODE_KINDS];
+
+// src/util.ts
+import path2 from "node:path";
+function render(value) {
+  return JSON.stringify(value, null, 2);
+}
+function record(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function items(value) {
+  return Array.isArray(value) ? value : [];
+}
+function identifiedName(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const identifier = value.identifier;
+  if (!identifier || typeof identifier !== "object")
+    return;
+  const text = identifier.text;
+  return typeof text === "string" ? text : undefined;
+}
+function collectAnchoredFiles(value, files) {
+  if (Array.isArray(value)) {
+    for (const item of value)
+      collectAnchoredFiles(item, files);
+    return;
+  }
+  if (!value || typeof value !== "object")
+    return;
+  const output = value;
+  const hashlines = output.hashlines;
+  if (typeof output.file === "string" && Array.isArray(hashlines) && hashlines.some((line) => typeof record(line).line === "number" && typeof record(line).hash === "string"))
+    files.add(output.file);
+  for (const item of Object.values(output))
+    collectAnchoredFiles(item, files);
+}
+function renameFiles(value) {
+  const output = record(value);
+  const files = [];
+  if (typeof output.file === "string" && items(output.edits).length > 0)
+    files.push(path2.resolve(output.file));
+  for (const other of items(output.others)) {
+    const item = record(other);
+    if (typeof item.file === "string" && items(item.edits).length > 0)
+      files.push(path2.resolve(item.file));
+  }
+  return files;
+}
+function normalizeToLf(content) {
+  return content.replace(/\r\n/g, `
+`).replace(/\r/g, `
+`);
+}
+function diffLines(content) {
+  if (content === "")
+    return [];
+  const lines = content.split(`
+`);
+  if (lines.at(-1) === "")
+    lines.pop();
+  return lines.map((line) => line.replace(/\r/g, "\\r"));
+}
+function hasFinalNewline(content) {
+  return content === "" || /[\r\n]$/.test(content);
+}
+function diffRange(start, count) {
+  return count === 0 ? `${start},0` : `${start + 1},${count}`;
+}
+function utf8Prefix(value, maxBytes) {
+  const bytes = Buffer.from(value, "utf8");
+  if (bytes.length <= maxBytes)
+    return value;
+  let end = maxBytes;
+  const decoder = new TextDecoder("utf-8", { fatal: true });
+  while (end > 0) {
+    try {
+      return decoder.decode(bytes.subarray(0, end));
+    } catch {
+      end--;
+    }
+  }
+  return "";
+}
+
+// src/client.ts
+var resolveFromHost = createRequire2(import.meta.url).resolve;
 function resolveImagePolicy(options) {
   const value = options?.imageMode;
   if (value === undefined)
@@ -816,46 +931,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,232 +941,30 @@ function requireDigestFacet(envelope, facet) {
   }
   return value;
 }
-function digestMetadata(envelope) {
-  return record(record(envelope).metadata);
+function withAt(args, line, column) {
+  args.push("--at", buildLineLocation(line, column));
 }
-
-class SessionAnchors {
-  #pathsBySession = new Map;
-  #renamePlans = new Map;
-  mark(sessionID, filePath) {
-    let paths = this.#pathsBySession.get(sessionID);
-    if (!paths) {
-      paths = new Set;
-      this.#pathsBySession.set(sessionID, paths);
-    }
-    paths.add(filePath);
-  }
-  forget(filePath) {
-    const absolutePath = path2.resolve(filePath);
-    for (const paths of this.#pathsBySession.values())
-      paths.delete(absolutePath);
-    for (const [sessionID, plan] of this.#renamePlans) {
-      if (plan.files.has(absolutePath))
-        this.#renamePlans.delete(sessionID);
-    }
-  }
-  deleteSession(sessionID) {
-    this.#pathsBySession.delete(sessionID);
-    this.#renamePlans.delete(sessionID);
-  }
-  planRename(sessionID, output) {
-    if (!output || typeof output !== "object")
-      return;
-    const record = output;
-    if (record.applied === true) {
-      this.#renamePlans.delete(sessionID);
-      return;
-    }
-    const { file, old_name: oldName, new_name: newName, others } = record;
-    if (typeof file !== "string" || typeof oldName !== "string" || typeof newName !== "string")
-      return;
-    const files = new Set([path2.resolve(file)]);
-    if (Array.isArray(others)) {
-      for (const item of others) {
-        if (!item || typeof item !== "object")
-          continue;
-        const otherFile = item.file;
-        if (typeof otherFile === "string")
-          files.add(path2.resolve(otherFile));
-      }
-    }
-    this.#renamePlans.set(sessionID, { summary: `${oldName} -> ${newName}`, files });
-  }
-  render(sessionID) {
-    const paths = this.#pathsBySession.get(sessionID);
-    const sections = [];
-    if (paths?.size) {
-      sections.push(`## ReadSeek Anchors
-The following files have fresh LINE:HASH anchors:
-${[...paths].sort().map((filePath) => `- ${filePath}`).join(`
-`)}`);
-    }
-    const renamePlan = this.#renamePlans.get(sessionID);
-    if (renamePlan)
-      sections.push(`## Pending ReadSeek Rename Plan
-- ${renamePlan.summary}`);
-    return sections.length === 0 ? undefined : sections.join(`
-
-`);
-  }
+function readRangeArgs(filePath, start, end) {
+  const extra = [];
+  if (start > 1)
+    withAt(extra, start);
+  extra.push("--end", String(end));
+  return digestArgs(filePath, "content", extra);
 }
-function resolvePath(directory, filePath) {
-  return path2.resolve(directory, filePath);
+function readSeekBinaryPath() {
+  return resolveReadSeekBinaryFromPackages(resolveFromHost);
 }
-function containsPath(directory, filePath) {
-  const relative = path2.relative(directory, filePath);
-  return relative === "" || !relative.startsWith(`..${path2.sep}`) && relative !== ".." && !path2.isAbsolute(relative);
-}
-async function resolveSymlinks(filePath) {
-  let unresolved = path2.resolve(filePath);
-  let symlinks = 0;
-  while (true) {
-    const parsed = path2.parse(unresolved);
-    const parts = unresolved.slice(parsed.root.length).split(path2.sep).filter(Boolean);
-    let resolved = parsed.root;
-    let restart = false;
-    for (let index = 0;index < parts.length; index++) {
-      const candidate = path2.join(resolved, parts[index]);
-      const info = await lstat(candidate);
-      if (!info.isSymbolicLink()) {
-        resolved = candidate;
-        continue;
-      }
-      symlinks++;
-      if (symlinks > 40) {
-        const error = new Error(`too many symbolic links: ${filePath}`);
-        error.code = "ELOOP";
-        throw error;
-      }
-      const target = await readlink(candidate);
-      unresolved = path2.resolve(path2.dirname(candidate), target, ...parts.slice(index + 1));
-      restart = true;
-      break;
-    }
-    if (!restart)
-      return resolved;
-  }
-}
-async function portableRealpath(filePath) {
-  try {
-    return await realpath(filePath);
-  } catch (error) {
-    if (error.code !== "EACCES")
-      throw error;
-    return resolveSymlinks(filePath);
-  }
-}
-async function canonicalPath(filePath) {
-  const missing = [];
-  let existing = filePath;
-  while (true) {
-    try {
-      return path2.join(await portableRealpath(existing), ...missing.reverse());
-    } catch (error) {
-      if (error.code !== "ENOENT")
-        throw error;
-      const parent = path2.dirname(existing);
-      if (parent === existing)
-        throw error;
-      missing.push(path2.basename(existing));
-      existing = parent;
-    }
-  }
-}
-async function authorizeExternal(context, filePath) {
-  const [accessPath, directory, worktree] = await Promise.all([
-    canonicalPath(filePath),
-    canonicalPath(context.directory),
-    context.worktree === "/" ? Promise.resolve("/") : canonicalPath(context.worktree)
-  ]);
-  if (containsPath(directory, accessPath) || worktree !== "/" && containsPath(worktree, accessPath)) {
-    return;
-  }
-  const info = await stat(accessPath).catch(() => {
-    return;
-  });
-  const parentDir = info?.isDirectory() ? accessPath : path2.dirname(accessPath);
-  const pattern = path2.join(parentDir, "*").replaceAll("\\", "/");
-  await context.ask({
-    permission: "external_directory",
-    patterns: [pattern],
-    always: [pattern],
-    metadata: { filepath: filePath, parentDir }
-  });
-}
-async function rejectSymlinkMutation(filePath) {
-  const info = await lstat(filePath).catch((error) => {
-    if (error.code === "ENOENT")
-      return;
-    throw error;
-  });
-  if (info?.isSymbolicLink())
-    throw new Error(`refusing to modify symbolic link: ${filePath}`);
-}
-async function authorizeRead(context, filePath) {
-  await authorizeExternal(context, filePath);
-  await context.ask({
-    permission: "read",
-    patterns: [path2.relative(context.worktree, filePath).replaceAll("\\", "/")],
-    always: ["*"],
-    metadata: {}
-  });
-}
-async function authorizeSearch(context, filePath, pattern) {
-  await context.ask({
-    permission: "grep",
-    patterns: [pattern],
-    always: ["*"],
-    metadata: { pattern, path: filePath }
-  });
-  await authorizeExternal(context, filePath);
-}
-async function authorizeEdit(context, filePaths, diff = "", authorizeExternalPaths = true) {
-  if (authorizeExternalPaths) {
-    for (const filePath of filePaths)
-      await authorizeExternal(context, filePath);
-  }
-  const patterns = filePaths.map((filePath) => path2.relative(context.worktree, filePath).replaceAll("\\", "/"));
-  await context.ask({
-    permission: "edit",
-    patterns,
-    always: ["*"],
-    metadata: { filepath: filePaths.join(", "), diff }
-  });
-}
-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)
-    withAt(extra, start);
-  extra.push("--end", String(end));
-  return digestArgs(filePath, "content", extra);
-}
-async function runDigestContent(context, args, options = {}) {
-  return requireDigestFacet(await runReadSeek(context, args, options), "content");
-}
-function readSeekBinaryPath() {
-  return resolveReadSeekBinaryFromPackages(resolveFromHost);
-}
-async function preserveAbortReason(signal, cancelable, invoke) {
-  try {
-    const value = await invoke();
-    if (cancelable)
-      signal.throwIfAborted();
-    return value;
-  } catch (error) {
-    if (cancelable)
-      signal.throwIfAborted();
-    throw error;
-  }
+async function preserveAbortReason(signal, cancelable, invoke) {
+  try {
+    const value = await invoke();
+    if (cancelable)
+      signal.throwIfAborted();
+    return value;
+  } catch (error) {
+    if (cancelable)
+      signal.throwIfAborted();
+    throw error;
+  }
 }
 async function runReadSeekRaw(context, args, options = {}) {
   context.abort.throwIfAborted();
@@ -1113,6 +986,9 @@ async function runReadSeek(context, args, options = {}) {
     timeoutMs: options.timeoutMs
   }));
 }
+async function runDigestContent(context, args, options = {}) {
+  return requireDigestFacet(await runReadSeek(context, args, options), "content");
+}
 async function postMutationPreview(context, args, filePath, changed) {
   try {
     return await runDigestContent(context, args, {
@@ -1132,8 +1008,8 @@ async function postMutationPreview(context, args, filePath, changed) {
 var readSeekCacheInit;
 function readSeekCacheDir() {
   const xdgCacheHome = process.env.XDG_CACHE_HOME?.trim();
-  const cacheHome = xdgCacheHome || path2.join(homedir(), ".cache");
-  return path2.join(cacheHome, "opencode", "readseek");
+  const cacheHome = xdgCacheHome || path3.join(homedir(), ".cache");
+  return path3.join(cacheHome, "opencode", "readseek");
 }
 async function ensureReadSeekCache(context) {
   const cacheDir = readSeekCacheDir();
@@ -1151,28 +1027,109 @@ async function ensureReadSeekCache(context) {
   });
   return readSeekCacheInit;
 }
-function render(value) {
-  return JSON.stringify(value, null, 2);
+function boundDocumentOutput(value) {
+  const lines = value.split(`
+`);
+  let output = lines.length > MAX_DOCUMENT_OUTPUT_LINES ? lines.slice(0, MAX_DOCUMENT_OUTPUT_LINES).join(`
+`) : value;
+  const truncated = output !== value || Buffer.byteLength(output, "utf8") > MAX_DOCUMENT_OUTPUT_BYTES;
+  output = utf8Prefix(output, MAX_DOCUMENT_OUTPUT_BYTES);
+  return truncated ? `${output}
+[… document view truncated; narrow it with page, node, kind, or depth]` : output;
 }
-function collectAnchoredFiles(value, files) {
-  if (Array.isArray(value)) {
-    for (const item of value)
-      collectAnchoredFiles(item, files);
-    return;
+
+// src/policy.ts
+var OPENCODE_TOOL_ALIASES = Object.fromEntries(TOOL_NAMES.map((name) => [name, `readseek_${name}`]));
+var TOOL_POLICY = renderToolRoutingPolicy({
+  aliases: OPENCODE_TOOL_ALIASES,
+  preferOverBuiltIns: true,
+  demoteBuiltIns: ["read", "edit", "write", "grep", "apply_patch"]
+});
+var PREFERRED_TOOL_DESCRIPTIONS = preferredToolDescriptionMap(OPENCODE_TOOL_ALIASES);
+var FALLBACK_TOOL_DESCRIPTIONS = fallbackToolDescriptionMap(["edit", "write", "grep", "apply_patch"], OPENCODE_TOOL_ALIASES);
+function openCodeToolDescription(name) {
+  return renderToolDescription(name, OPENCODE_TOOL_ALIASES);
+}
+
+// src/session-anchors.ts
+import path4 from "node:path";
+
+class SessionAnchors {
+  #pathsBySession = new Map;
+  #renamePlans = new Map;
+  mark(sessionID, filePath) {
+    let paths = this.#pathsBySession.get(sessionID);
+    if (!paths) {
+      paths = new Set;
+      this.#pathsBySession.set(sessionID, paths);
+    }
+    paths.add(filePath);
+  }
+  forget(filePath) {
+    const absolutePath = path4.resolve(filePath);
+    for (const paths of this.#pathsBySession.values())
+      paths.delete(absolutePath);
+    for (const [sessionID, plan] of this.#renamePlans) {
+      if (plan.files.has(absolutePath))
+        this.#renamePlans.delete(sessionID);
+    }
+  }
+  deleteSession(sessionID) {
+    this.#pathsBySession.delete(sessionID);
+    this.#renamePlans.delete(sessionID);
+  }
+  planRename(sessionID, output) {
+    if (!output || typeof output !== "object")
+      return;
+    const record2 = output;
+    if (record2.applied === true) {
+      this.#renamePlans.delete(sessionID);
+      return;
+    }
+    const { file, old_name: oldName, new_name: newName, others } = record2;
+    if (typeof file !== "string" || typeof oldName !== "string" || typeof newName !== "string")
+      return;
+    const files = new Set([path4.resolve(file)]);
+    if (Array.isArray(others)) {
+      for (const item of others) {
+        if (!item || typeof item !== "object")
+          continue;
+        const otherFile = item.file;
+        if (typeof otherFile === "string")
+          files.add(path4.resolve(otherFile));
+      }
+    }
+    this.#renamePlans.set(sessionID, { summary: `${oldName} -> ${newName}`, files });
+  }
+  render(sessionID) {
+    const paths = this.#pathsBySession.get(sessionID);
+    const sections = [];
+    if (paths?.size) {
+      sections.push(`## ReadSeek Anchors
+The following files have fresh LINE:HASH anchors:
+${[...paths].sort().map((filePath) => `- ${filePath}`).join(`
+`)}`);
+    }
+    const renamePlan = this.#renamePlans.get(sessionID);
+    if (renamePlan)
+      sections.push(`## Pending ReadSeek Rename Plan
+- ${renamePlan.summary}`);
+    return sections.length === 0 ? undefined : sections.join(`
+
+`);
   }
-  if (!value || typeof value !== "object")
-    return;
-  const output = value;
-  const hashlines = output.hashlines;
-  if (typeof output.file === "string" && Array.isArray(hashlines) && hashlines.some((line) => typeof record(line).line === "number" && typeof record(line).hash === "string"))
-    files.add(output.file);
-  for (const item of Object.values(output))
-    collectAnchoredFiles(item, files);
 }
+
+// src/tools.ts
+import { readFile as readFile2, stat as stat3 } from "node:fs/promises";
+import { tool as tool2 } from "@opencode-ai/plugin";
+
+// src/edits.ts
+import { lstat, mkdir, open, readFile } from "node:fs/promises";
+import path5 from "node:path";
 var fileMutationTails = new Map;
-var MAX_PERMISSION_DIFF_BYTES = 32 * 1024;
 async function withFileMutationQueue(filePath, operation) {
-  const key = path2.resolve(filePath);
+  const key = path5.resolve(filePath);
   const previous = fileMutationTails.get(key);
   let release = () => {};
   const current = new Promise((resolve) => {
@@ -1189,6 +1146,15 @@ async function withFileMutationQueue(filePath, operation) {
       fileMutationTails.delete(key);
   }
 }
+function parseAnchor(anchor) {
+  const match = /^(\d+):([0-9a-fA-F]{3})$/.exec(anchor.trim());
+  if (!match)
+    throw new Error(`invalid LINE:HASH anchor: ${anchor}`);
+  const line = Number(match[1]);
+  if (line === 0)
+    throw new Error(`anchor line must be greater than zero: ${anchor}`);
+  return { line, hash: match[2].toLowerCase() };
+}
 function validateEdits(value) {
   if (!Array.isArray(value) || value.length === 0)
     throw new Error("edits must contain at least one edit");
@@ -1230,15 +1196,6 @@ function validateEdits(value) {
     }
   }
 }
-function parseAnchor(anchor) {
-  const match = /^(\d+):([0-9a-fA-F]{3})$/.exec(anchor.trim());
-  if (!match)
-    throw new Error(`invalid LINE:HASH anchor: ${anchor}`);
-  const line = Number(match[1]);
-  if (line === 0)
-    throw new Error(`anchor line must be greater than zero: ${anchor}`);
-  return { line, hash: match[2].toLowerCase() };
-}
 function firstChangedLine(before, after) {
   const beforeLines = normalizeToLf(before).split(`
 `);
@@ -1272,7 +1229,7 @@ async function writeHandle(handle, content) {
   }
 }
 async function writeText(filePath, expected, content) {
-  await mkdir(path2.dirname(filePath), { recursive: true });
+  await mkdir(path5.dirname(filePath), { recursive: true });
   if (!expected.exists) {
     let handle2;
     try {
@@ -1309,100 +1266,6 @@ async function writeText(filePath, expected, content) {
     await handle.close();
   }
 }
-function renameFiles(value) {
-  const output = record(value);
-  const files = [];
-  if (typeof output.file === "string" && items(output.edits).length > 0)
-    files.push(path2.resolve(output.file));
-  for (const other of items(output.others)) {
-    const item = record(other);
-    if (typeof item.file === "string" && items(item.edits).length > 0)
-      files.push(path2.resolve(item.file));
-  }
-  return files;
-}
-function normalizeToLf(content) {
-  return content.replace(/\r\n/g, `
-`).replace(/\r/g, `
-`);
-}
-function diffLines(content) {
-  if (content === "")
-    return [];
-  const lines = content.split(`
-`);
-  if (lines.at(-1) === "")
-    lines.pop();
-  return lines.map((line) => line.replace(/\r/g, "\\r"));
-}
-function hasFinalNewline(content) {
-  return content === "" || /[\r\n]$/.test(content);
-}
-function diffRange(start, count) {
-  return count === 0 ? `${start},0` : `${start + 1},${count}`;
-}
-function utf8Prefix(value, maxBytes) {
-  const bytes = Buffer.from(value, "utf8");
-  if (bytes.length <= maxBytes)
-    return value;
-  let end = maxBytes;
-  const decoder = new TextDecoder("utf-8", { fatal: true });
-  while (end > 0) {
-    try {
-      return decoder.decode(bytes.subarray(0, end));
-    } catch {
-      end--;
-    }
-  }
-  return "";
-}
-function boundDocumentOutput(value) {
-  const lines = value.split(`
-`);
-  let output = lines.length > MAX_DOCUMENT_OUTPUT_LINES ? lines.slice(0, MAX_DOCUMENT_OUTPUT_LINES).join(`
-`) : value;
-  const truncated = output !== value || Buffer.byteLength(output, "utf8") > MAX_DOCUMENT_OUTPUT_BYTES;
-  output = utf8Prefix(output, MAX_DOCUMENT_OUTPUT_BYTES);
-  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;
@@ -1495,21 +1358,137 @@ function simpleDiff(filePath, before, after) {
   ].join(`
 `);
 }
-function identifiedName(value) {
-  if (!value || typeof value !== "object")
+
+// src/paths.ts
+import { lstat as lstat2, readlink, realpath, stat as stat2 } from "node:fs/promises";
+import path6 from "node:path";
+function resolvePath(directory, filePath) {
+  return path6.resolve(directory, filePath);
+}
+function containsPath(directory, filePath) {
+  const relative = path6.relative(directory, filePath);
+  return relative === "" || !relative.startsWith(`..${path6.sep}`) && relative !== ".." && !path6.isAbsolute(relative);
+}
+async function resolveSymlinks(filePath) {
+  let unresolved = path6.resolve(filePath);
+  let symlinks = 0;
+  while (true) {
+    const parsed = path6.parse(unresolved);
+    const parts = unresolved.slice(parsed.root.length).split(path6.sep).filter(Boolean);
+    let resolved = parsed.root;
+    let restart = false;
+    for (let index = 0;index < parts.length; index++) {
+      const candidate = path6.join(resolved, parts[index]);
+      const info = await lstat2(candidate);
+      if (!info.isSymbolicLink()) {
+        resolved = candidate;
+        continue;
+      }
+      symlinks++;
+      if (symlinks > 40) {
+        const error = new Error(`too many symbolic links: ${filePath}`);
+        error.code = "ELOOP";
+        throw error;
+      }
+      const target = await readlink(candidate);
+      unresolved = path6.resolve(path6.dirname(candidate), target, ...parts.slice(index + 1));
+      restart = true;
+      break;
+    }
+    if (!restart)
+      return resolved;
+  }
+}
+async function portableRealpath(filePath) {
+  try {
+    return await realpath(filePath);
+  } catch (error) {
+    if (error.code !== "EACCES")
+      throw error;
+    return resolveSymlinks(filePath);
+  }
+}
+async function canonicalPath(filePath) {
+  const missing = [];
+  let existing = filePath;
+  while (true) {
+    try {
+      return path6.join(await portableRealpath(existing), ...missing.reverse());
+    } catch (error) {
+      if (error.code !== "ENOENT")
+        throw error;
+      const parent = path6.dirname(existing);
+      if (parent === existing)
+        throw error;
+      missing.push(path6.basename(existing));
+      existing = parent;
+    }
+  }
+}
+async function authorizeExternal(context, filePath) {
+  const [accessPath, directory, worktree] = await Promise.all([
+    canonicalPath(filePath),
+    canonicalPath(context.directory),
+    context.worktree === "/" ? Promise.resolve("/") : canonicalPath(context.worktree)
+  ]);
+  if (containsPath(directory, accessPath) || worktree !== "/" && containsPath(worktree, accessPath)) {
     return;
-  const identifier = value.identifier;
-  if (!identifier || typeof identifier !== "object")
+  }
+  const info = await stat2(accessPath).catch(() => {
     return;
-  const text = identifier.text;
-  return typeof text === "string" ? text : undefined;
+  });
+  const parentDir = info?.isDirectory() ? accessPath : path6.dirname(accessPath);
+  const pattern = path6.join(parentDir, "*").replaceAll("\\", "/");
+  await context.ask({
+    permission: "external_directory",
+    patterns: [pattern],
+    always: [pattern],
+    metadata: { filepath: filePath, parentDir }
+  });
 }
-function record(value) {
-  return value && typeof value === "object" ? value : {};
+async function rejectSymlinkMutation(filePath) {
+  const info = await lstat2(filePath).catch((error) => {
+    if (error.code === "ENOENT")
+      return;
+    throw error;
+  });
+  if (info?.isSymbolicLink())
+    throw new Error(`refusing to modify symbolic link: ${filePath}`);
 }
-function items(value) {
-  return Array.isArray(value) ? value : [];
+async function authorizeRead(context, filePath) {
+  await authorizeExternal(context, filePath);
+  await context.ask({
+    permission: "read",
+    patterns: [path6.relative(context.worktree, filePath).replaceAll("\\", "/")],
+    always: ["*"],
+    metadata: {}
+  });
 }
+async function authorizeSearch(context, filePath, pattern) {
+  await context.ask({
+    permission: "grep",
+    patterns: [pattern],
+    always: ["*"],
+    metadata: { pattern, path: filePath }
+  });
+  await authorizeExternal(context, filePath);
+}
+async function authorizeEdit(context, filePaths, diff = "", authorizeExternalPaths = true) {
+  if (authorizeExternalPaths) {
+    for (const filePath of filePaths)
+      await authorizeExternal(context, filePath);
+  }
+  const patterns = filePaths.map((filePath) => path6.relative(context.worktree, filePath).replaceAll("\\", "/"));
+  await context.ask({
+    permission: "edit",
+    patterns,
+    always: ["*"],
+    metadata: { filepath: filePaths.join(", "), diff }
+  });
+}
+
+// src/presentation.ts
+import { tool } from "@opencode-ai/plugin";
 function initialTitle(kind, args) {
   switch (kind) {
     case "read":
@@ -1645,478 +1624,390 @@ function readseekTool(description, args, kind, execute, formatResult = (result)
     }
   });
 }
-var ReadSeekPlugin = async (_input, options) => {
-  const anchors = new SessionAnchors;
-  const imagePolicy = resolveImagePolicy(options);
-  const imageModes = imagePolicy === "auto" ? ["none", "all", "ocr", "caption", "objects"] : ["all", "ocr", "caption", "objects"];
+
+// src/tools.ts
+function createReadSeekTools(imagePolicy) {
   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);
+    readseek_view: readseekTool(openCodeToolDescription("view"), {
+      path: tool2.schema.string().describe(PARAM_DESCRIPTIONS.projectPath),
+      node: tool2.schema.string().min(1).optional().describe(PARAM_DESCRIPTIONS.node),
+      page: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.page),
+      kind: tool2.schema.enum(DOCUMENT_NODE_KIND_VALUES).optional().describe(PARAM_DESCRIPTIONS.kind),
+      depth: tool2.schema.number().int().nonnegative().optional().describe(PARAM_DESCRIPTIONS.depth),
+      outline: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.outline),
+      visionMode: tool2.schema.enum(VISION_ANALYSIS_MODE_VALUES).optional().describe(PARAM_DESCRIPTIONS.visionModeView),
+      visionLevel: tool2.schema.enum(VISION_LEVEL_VALUES).optional().describe(PARAM_DESCRIPTIONS.visionLevel)
+    }, "view", async (input, context) => {
+      const filePath = resolvePath(context.directory, input.path);
+      await authorizeRead(context, filePath);
+      const visionMode = input.visionMode;
+      const visionLevel = input.visionLevel;
+      const vision = validateVisionLevelVsMode({
+        visionMode,
+        visionLevel,
+        outline: input.outline
+      });
+      if (!vision.ok)
+        throw new Error(vision.error);
+      const cacheDir = await ensureReadSeekCache(context);
+      const args = buildViewArgs({
+        path: filePath,
+        node: input.node,
+        page: input.page,
+        kind: input.kind,
+        depth: input.depth,
+        outline: input.outline,
+        visionMode,
+        visionLevel,
+        readseekDir: cacheDir
+      });
+      return runReadSeekRaw(context, args, visionMode === undefined ? {} : { timeoutMs: DEFAULT_VISION_TIMEOUT_MS });
+    }, (result) => ({ output: boundDocumentOutput(String(result)) })),
+    readseek_digest: readseekTool(openCodeToolDescription("digest"), {
+      path: tool2.schema.string().describe(PARAM_DESCRIPTIONS.projectPath),
+      select: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.selectComma),
+      at: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.at),
+      end: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.end),
+      limit: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.limit),
+      language: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.languageOverride),
+      visionMode: tool2.schema.enum(IMAGE_MODES).optional().describe(PARAM_DESCRIPTIONS.visionModeDigest),
+      visionLevel: tool2.schema.enum(VISION_LEVEL_VALUES).optional().describe(PARAM_DESCRIPTIONS.visionLevel)
+    }, "digest", async (input, context) => {
+      const filePath = resolvePath(context.directory, input.path);
+      await authorizeRead(context, filePath);
+      const select = (input.select ?? "content").trim() || "content";
+      const visionMode = input.visionMode;
+      const visionLevel = input.visionLevel;
+      const vision = validateVisionLevelVsMode({ visionMode, visionLevel });
+      if (!vision.ok)
+        throw new Error(vision.error);
+      const cacheDir = await ensureReadSeekCache(context);
+      const args = buildDigestArgs({
+        path: filePath,
+        select,
+        at: input.at,
+        end: input.end,
+        limit: input.limit,
+        language: input.language,
+        visionMode,
+        visionLevel,
+        readseekDir: cacheDir
+      });
+      return runReadSeek(context, args, visionMode === undefined || visionMode === "none" ? {} : { timeoutMs: DEFAULT_VISION_TIMEOUT_MS });
+    }),
+    readseek_grep: readseekTool(openCodeToolDescription("grep"), {
+      pattern: tool2.schema.string().describe(PARAM_DESCRIPTIONS.grepPattern),
+      path: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.projectSearchPath),
+      glob: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.glob),
+      literal: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.literal),
+      ignoreCase: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignoreCase),
+      context: tool2.schema.number().int().nonnegative().optional().describe(PARAM_DESCRIPTIONS.context),
+      limit: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.matchLimit)
+    }, "grep", async (input, context) => {
+      const target = resolvePath(context.directory, input.path ?? ".");
+      const pattern = input.pattern;
+      await authorizeSearch(context, target, pattern);
+      let expression;
+      try {
+        const source = input.literal ? pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") : pattern;
+        expression = new RegExp(source, input.ignoreCase ? "i" : "");
+      } catch (error) {
+        throw new Error(`invalid regular expression: ${error instanceof Error ? error.message : String(error)}`);
+      }
+      const info = await stat3(target);
+      const files = [];
+      if (info.isFile())
+        files.push(target);
+      else if (info.isDirectory()) {
+        const glob = new Bun.Glob(input.glob ?? "**/*");
+        for await (const filePath of glob.scan({ cwd: target, absolute: true, onlyFiles: true, followSymlinks: false })) {
+          files.push(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" };
+      } else
+        throw new Error(`grep target is not a file or directory: ${target}`);
+      const maxMatches = input.limit ?? 100;
+      const contextLines = input.context ?? 0;
+      const results = [];
+      let totalMatches = 0;
+      let truncated = false;
+      for (const filePath of files.sort()) {
+        context.abort.throwIfAborted();
+        if (truncated)
+          break;
+        const buffer = await readFile2(filePath);
+        if (buffer.includes(0))
+          continue;
+        const lines = buffer.toString("utf8").replace(/\r\n/g, `
+`).split(`
+`);
+        const matchLines = new Set;
+        const ranges = [];
+        for (let index = 0;index < lines.length; index++) {
+          expression.lastIndex = 0;
+          if (!expression.test(lines[index] ?? ""))
+            continue;
+          if (totalMatches === maxMatches) {
+            truncated = true;
+            break;
           }
-          detectedText = true;
+          const line = index + 1;
+          matchLines.add(line);
+          ranges.push([Math.max(1, line - contextLines), Math.min(lines.length, line + contextLines)]);
+          totalMatches++;
         }
-        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);
+        if (ranges.length === 0)
+          continue;
+        const mergedRanges = [];
+        for (const [start, end] of ranges) {
+          const previous = mergedRanges.at(-1);
+          if (previous && start <= previous[1] + 1)
+            previous[1] = Math.max(previous[1], end);
+          else
+            mergedRanges.push([start, end]);
         }
-        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" };
-            }
+        const linesByNumber = new Map;
+        for (const [start, end] of mergedRanges) {
+          const output = record(await runDigestContent(context, readRangeArgs(filePath, start, end)));
+          for (const hashline of items(output.hashlines)) {
+            const line = record(hashline).line;
+            if (typeof line === "number" && !linesByNumber.has(line))
+              linesByNumber.set(line, hashline);
           }
-          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),
-        page: tool.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.page),
-        kind: tool.schema.enum(DOCUMENT_NODE_KIND_VALUES).optional().describe(PARAM_DESCRIPTIONS.kind),
-        depth: tool.schema.number().int().nonnegative().optional().describe(PARAM_DESCRIPTIONS.depth),
-        outline: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.outline),
-        visionMode: tool.schema.enum(VISION_ANALYSIS_MODE_VALUES).optional().describe(PARAM_DESCRIPTIONS.visionModeView),
-        visionLevel: tool.schema.enum(VISION_LEVEL_VALUES).optional().describe(PARAM_DESCRIPTIONS.visionLevel)
-      }, "view", async (input, context) => {
-        const filePath = resolvePath(context.directory, input.path);
-        await authorizeRead(context, filePath);
-        const visionMode = input.visionMode;
-        const visionLevel = input.visionLevel;
-        const vision = validateVisionLevelVsMode({
-          visionMode,
-          visionLevel,
-          outline: input.outline
-        });
-        if (!vision.ok)
-          throw new Error(vision.error);
-        const cacheDir = await ensureReadSeekCache(context);
-        const args = buildViewArgs({
-          path: filePath,
-          node: input.node,
-          page: input.page,
-          kind: input.kind,
-          depth: input.depth,
-          outline: input.outline,
-          visionMode,
-          visionLevel,
-          readseekDir: cacheDir
+        const hashlines = [...linesByNumber.values()];
+        const matches = hashlines.filter((hashline) => {
+          const line = record(hashline).line;
+          return typeof line === "number" && matchLines.has(line);
         });
-        return runReadSeekRaw(context, args, visionMode === undefined ? {} : { timeoutMs: DEFAULT_VISION_TIMEOUT_MS });
-      }, (result) => ({ output: boundDocumentOutput(String(result)) })),
-      readseek_digest: readseekTool(openCodeToolDescription("digest"), {
-        path: tool.schema.string().describe("Path relative to the project directory"),
-        select: tool.schema.string().optional().describe("Comma-separated facets: metadata, content, map, diagnostics, identity; defaults to content"),
-        at: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.at),
-        end: tool.schema.number().int().positive().optional().describe("Last line to include; content facet only"),
-        limit: tool.schema.number().int().positive().optional().describe("Maximum number of lines; content facet only"),
-        language: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
-        visionMode: tool.schema.enum(IMAGE_MODES).optional().describe("Standalone image mode for the content facet: none, all, ocr, caption, or objects"),
-        visionLevel: tool.schema.enum(VISION_LEVEL_VALUES).optional().describe("Vision inference level: low (default), medium, or high; content facet only")
-      }, "digest", async (input, context) => {
-        const filePath = resolvePath(context.directory, input.path);
+        results.push({ file: filePath, matches, hashlines });
+      }
+      return { results, truncated };
+    }),
+    readseek_search: readseekTool(openCodeToolDescription("search"), {
+      pattern: tool2.schema.string().describe(PARAM_DESCRIPTIONS.pattern),
+      path: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.projectSearchPath),
+      language: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
+      cached: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.cached),
+      others: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.others),
+      ignored: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignored)
+    }, "search", async (input, context) => {
+      const target = resolvePath(context.directory, input.path ?? ".");
+      const args = buildSearchArgs({
+        path: target,
+        pattern: input.pattern,
+        language: input.language,
+        cached: input.cached,
+        others: input.others,
+        ignored: input.ignored
+      });
+      await authorizeSearch(context, target, input.pattern);
+      return runReadSeek(context, args);
+    }),
+    readseek_def: readseekTool(openCodeToolDescription("def"), {
+      name: tool2.schema.string().describe(PARAM_DESCRIPTIONS.name),
+      path: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.projectSearchPath),
+      language: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
+      cached: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.cached),
+      others: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.others),
+      ignored: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignored)
+    }, "def", async (input, context) => {
+      const target = resolvePath(context.directory, input.path ?? ".");
+      const args = buildDefArgs({
+        path: target,
+        name: input.name,
+        language: input.language,
+        format: "plain",
+        cached: input.cached,
+        others: input.others,
+        ignored: input.ignored
+      });
+      await authorizeSearch(context, target, input.name);
+      return runReadSeek(context, args);
+    }),
+    readseek_refs: readseekTool(openCodeToolDescription("refs"), {
+      name: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.refsName),
+      path: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.projectSearchPath),
+      language: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
+      scope: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.scope),
+      line: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.line),
+      column: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.column),
+      cached: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.cached),
+      others: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.others),
+      ignored: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignored)
+    }, "refs", async (input, context) => {
+      const target = resolvePath(context.directory, input.path ?? ".");
+      const name = input.name;
+      const args = buildRefsArgs({
+        path: target,
+        name,
+        scope: input.scope,
+        line: input.line,
+        column: input.column,
+        language: input.language,
+        cached: input.cached,
+        others: input.others,
+        ignored: input.ignored
+      });
+      await authorizeSearch(context, target, name ?? "*");
+      return runReadSeek(context, args);
+    }),
+    readseek_rename: readseekTool(openCodeToolDescription("rename"), {
+      path: tool2.schema.string().describe(PARAM_DESCRIPTIONS.projectPath),
+      line: tool2.schema.number().int().positive().describe(PARAM_DESCRIPTIONS.renameLine),
+      column: tool2.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.column),
+      to: tool2.schema.string().min(1).describe(PARAM_DESCRIPTIONS.to),
+      workspace: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.workspace),
+      apply: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.applyDefaultTrue)
+    }, "rename", async (input, context) => {
+      const filePath = resolvePath(context.directory, input.path);
+      await authorizeRead(context, filePath);
+      if (input.workspace) {
+        const identifyArgs = digestArgs(filePath, "identity");
+        withAt(identifyArgs, input.line, input.column);
+        const envelope = await runReadSeek(context, identifyArgs);
+        const name = identifiedName(requireDigestFacet(envelope, "identity"));
+        if (!name)
+          throw new Error("readseek could not identify a binding at the rename cursor");
+        await authorizeSearch(context, context.directory, name);
+      }
+      const args = buildRenameArgs({
+        path: filePath,
+        to: input.to,
+        line: input.line,
+        column: input.column,
+        workspace: input.workspace ? context.directory : undefined
+      });
+      const plan = await runReadSeek(context, args);
+      if (input.apply === false)
+        return plan;
+      const files = renameFiles(plan);
+      const planHash = record(plan).plan_hash;
+      if (typeof planHash !== "string" || planHash.length === 0) {
+        throw new Error("readseek rename plan did not include a plan hash");
+      }
+      await authorizeEdit(context, files);
+      return runReadSeek(context, buildRenameArgs({
+        path: filePath,
+        to: input.to,
+        line: input.line,
+        column: input.column,
+        workspace: input.workspace ? context.directory : undefined,
+        apply: true,
+        planHash
+      }), {
+        cancelable: false,
+        timeoutMs: DEFAULT_READSEEK_TIMEOUT_MS
+      });
+    }),
+    readseek_edit: readseekTool(openCodeToolDescription("edit"), {
+      path: tool2.schema.string().describe(PARAM_DESCRIPTIONS.projectPath),
+      edits: tool2.schema.array(tool2.schema.union([
+        tool2.schema.object({
+          set_line: tool2.schema.object({
+            anchor: tool2.schema.string().describe(PARAM_DESCRIPTIONS.anchor),
+            new_text: tool2.schema.string().describe(PARAM_DESCRIPTIONS.newTextLine)
+          }).strict()
+        }).strict(),
+        tool2.schema.object({
+          replace_lines: tool2.schema.object({
+            start_anchor: tool2.schema.string().describe(PARAM_DESCRIPTIONS.startAnchor),
+            end_anchor: tool2.schema.string().describe(PARAM_DESCRIPTIONS.endAnchor),
+            new_text: tool2.schema.string().describe(PARAM_DESCRIPTIONS.newTextRange)
+          }).strict()
+        }).strict(),
+        tool2.schema.object({
+          insert_after: tool2.schema.object({
+            anchor: tool2.schema.string().describe(PARAM_DESCRIPTIONS.insertAnchor),
+            new_text: tool2.schema.string().describe(PARAM_DESCRIPTIONS.newTextInsert)
+          }).strict()
+        }).strict(),
+        tool2.schema.object({
+          replace: tool2.schema.object({
+            old_text: tool2.schema.string().describe(PARAM_DESCRIPTIONS.oldText),
+            new_text: tool2.schema.string().describe(PARAM_DESCRIPTIONS.newText),
+            all: tool2.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.all)
+          }).strict()
+        }).strict(),
+        tool2.schema.object({
+          replace_symbol: tool2.schema.object({
+            symbol: tool2.schema.string().describe(PARAM_DESCRIPTIONS.symbol),
+            new_body: tool2.schema.string().describe(PARAM_DESCRIPTIONS.newBody)
+          }).strict()
+        }).strict()
+      ])).min(1).describe(PARAM_DESCRIPTIONS.edits),
+      language: tool2.schema.string().optional().describe(PARAM_DESCRIPTIONS.languageSymbol)
+    }, "edit", async (input, context) => {
+      const filePath = resolvePath(context.directory, input.path);
+      validateEdits(input.edits);
+      return withFileMutationQueue(filePath, async () => {
+        context.abort.throwIfAborted();
         await authorizeRead(context, filePath);
-        const select = (input.select ?? "content").trim() || "content";
-        const visionMode = input.visionMode;
-        const visionLevel = input.visionLevel;
-        const vision = validateVisionLevelVsMode({ visionMode, visionLevel });
-        if (!vision.ok)
-          throw new Error(vision.error);
-        const cacheDir = await ensureReadSeekCache(context);
-        const args = buildDigestArgs({
+        await rejectSymlinkMutation(filePath);
+        const edits = input.edits;
+        const request = JSON.stringify({ edits });
+        const baseArgs = buildEditArgs({
           path: filePath,
-          select,
-          at: input.at,
-          end: input.end,
-          limit: input.limit,
           language: input.language,
-          visionMode,
-          visionLevel,
-          readseekDir: cacheDir
+          requestFromStdin: true
         });
-        return runReadSeek(context, args, visionMode === undefined || visionMode === "none" ? {} : { timeoutMs: DEFAULT_VISION_TIMEOUT_MS });
-      }),
-      readseek_grep: readseekTool(openCodeToolDescription("grep"), {
-        pattern: tool.schema.string().describe("Text or regular expression to search for; set literal for exact text"),
-        path: tool.schema.string().optional().describe("File or directory to search; defaults to the project directory"),
-        glob: tool.schema.string().optional().describe("File-name glob, such as **/*.ts"),
-        literal: tool.schema.boolean().optional().describe("Treat pattern as literal text"),
-        ignoreCase: tool.schema.boolean().optional().describe("Ignore case"),
-        context: tool.schema.number().int().nonnegative().optional().describe("Surrounding lines for each match"),
-        limit: tool.schema.number().int().positive().optional().describe("Maximum matching lines; defaults to 100")
-      }, "grep", async (input, context) => {
-        const target = resolvePath(context.directory, input.path ?? ".");
-        const pattern = input.pattern;
-        await authorizeSearch(context, target, pattern);
-        let expression;
-        try {
-          const source = input.literal ? pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") : pattern;
-          expression = new RegExp(source, input.ignoreCase ? "i" : "");
-        } catch (error) {
-          throw new Error(`invalid regular expression: ${error instanceof Error ? error.message : String(error)}`);
+        const plan = record(await runReadSeek(context, baseArgs, { stdin: request }));
+        if (typeof plan.before_content !== "string" || typeof plan.content !== "string" || typeof plan.plan_hash !== "string") {
+          throw new Error("readseek edit plan is missing before_content, content, or plan_hash");
         }
-        const info = await stat(target);
-        const files = [];
-        if (info.isFile())
-          files.push(target);
-        else if (info.isDirectory()) {
-          const glob = new Bun.Glob(input.glob ?? "**/*");
-          for await (const filePath of glob.scan({ cwd: target, absolute: true, onlyFiles: true, followSymlinks: false })) {
-            files.push(filePath);
-          }
-        } else
-          throw new Error(`grep target is not a file or directory: ${target}`);
-        const maxMatches = input.limit ?? 100;
-        const contextLines = input.context ?? 0;
-        const results = [];
-        let totalMatches = 0;
-        let truncated = false;
-        for (const filePath of files.sort()) {
-          context.abort.throwIfAborted();
-          if (truncated)
-            break;
-          const buffer = await readFile(filePath);
-          if (buffer.includes(0))
-            continue;
-          const lines = buffer.toString("utf8").replace(/\r\n/g, `
-`).split(`
-`);
-          const matchLines = new Set;
-          const ranges = [];
-          for (let index = 0;index < lines.length; index++) {
-            expression.lastIndex = 0;
-            if (!expression.test(lines[index] ?? ""))
-              continue;
-            if (totalMatches === maxMatches) {
-              truncated = true;
-              break;
-            }
-            const line = index + 1;
-            matchLines.add(line);
-            ranges.push([Math.max(1, line - contextLines), Math.min(lines.length, line + contextLines)]);
-            totalMatches++;
-          }
-          if (ranges.length === 0)
-            continue;
-          const mergedRanges = [];
-          for (const [start, end] of ranges) {
-            const previous = mergedRanges.at(-1);
-            if (previous && start <= previous[1] + 1)
-              previous[1] = Math.max(previous[1], end);
-            else
-              mergedRanges.push([start, end]);
-          }
-          const linesByNumber = new Map;
-          for (const [start, end] of mergedRanges) {
-            const output = record(await runDigestContent(context, readRangeArgs(filePath, start, end)));
-            for (const hashline of items(output.hashlines)) {
-              const line = record(hashline).line;
-              if (typeof line === "number" && !linesByNumber.has(line))
-                linesByNumber.set(line, hashline);
-            }
-          }
-          const hashlines = [...linesByNumber.values()];
-          const matches = hashlines.filter((hashline) => {
-            const line = record(hashline).line;
-            return typeof line === "number" && matchLines.has(line);
-          });
-          results.push({ file: filePath, matches, hashlines });
+        const before = plan.before_content;
+        const after = plan.content;
+        const previewStart = Math.max(1, firstChangedLine(before, after) - 3);
+        const previewArgs = readRangeArgs(filePath, previewStart, previewStart + EDIT_RESULT_READ_LIMIT - 1);
+        if (before === after) {
+          return postMutationPreview(context, previewArgs, filePath, false);
         }
-        return { results, truncated };
-      }),
-      readseek_search: readseekTool(openCodeToolDescription("search"), {
-        pattern: tool.schema.string().describe(PARAM_DESCRIPTIONS.pattern),
-        path: tool.schema.string().optional().describe("File or directory to search; defaults to the project directory"),
-        language: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
-        cached: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.cached),
-        others: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.others),
-        ignored: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignored)
-      }, "search", async (input, context) => {
-        const target = resolvePath(context.directory, input.path ?? ".");
-        const args = buildSearchArgs({
-          path: target,
-          pattern: input.pattern,
-          language: input.language,
-          cached: input.cached,
-          others: input.others,
-          ignored: input.ignored
-        });
-        await authorizeSearch(context, target, input.pattern);
-        return runReadSeek(context, args);
-      }),
-      readseek_def: readseekTool(openCodeToolDescription("def"), {
-        name: tool.schema.string().describe(PARAM_DESCRIPTIONS.name),
-        path: tool.schema.string().optional().describe("File or directory to search; defaults to the project directory"),
-        language: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
-        cached: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.cached),
-        others: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.others),
-        ignored: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignored)
-      }, "def", async (input, context) => {
-        const target = resolvePath(context.directory, input.path ?? ".");
-        const args = buildDefArgs({
-          path: target,
-          name: input.name,
-          language: input.language,
-          format: "plain",
-          cached: input.cached,
-          others: input.others,
-          ignored: input.ignored
-        });
-        await authorizeSearch(context, target, input.name);
-        return runReadSeek(context, args);
-      }),
-      readseek_refs: readseekTool(openCodeToolDescription("refs"), {
-        name: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.refsName),
-        path: tool.schema.string().optional().describe("File or directory to search; defaults to the project directory"),
-        language: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.language),
-        scope: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.scope),
-        line: tool.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.line),
-        column: tool.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.column),
-        cached: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.cached),
-        others: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.others),
-        ignored: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.ignored)
-      }, "refs", async (input, context) => {
-        const target = resolvePath(context.directory, input.path ?? ".");
-        const name = input.name;
-        const args = buildRefsArgs({
-          path: target,
-          name,
-          scope: input.scope,
-          line: input.line,
-          column: input.column,
-          language: input.language,
-          cached: input.cached,
-          others: input.others,
-          ignored: input.ignored
-        });
-        await authorizeSearch(context, target, name ?? "*");
-        return runReadSeek(context, args);
-      }),
-      readseek_rename: readseekTool(openCodeToolDescription("rename"), {
-        path: tool.schema.string().describe("Path relative to the project directory"),
-        line: tool.schema.number().int().positive().describe(PARAM_DESCRIPTIONS.renameLine),
-        column: tool.schema.number().int().positive().optional().describe(PARAM_DESCRIPTIONS.column),
-        to: tool.schema.string().min(1).describe(PARAM_DESCRIPTIONS.to),
-        workspace: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.workspace),
-        apply: tool.schema.boolean().optional().describe("Apply the verified edits; defaults to true")
-      }, "rename", async (input, context) => {
-        const filePath = resolvePath(context.directory, input.path);
-        await authorizeRead(context, filePath);
-        if (input.workspace) {
-          const identifyArgs = digestArgs(filePath, "identity");
-          withAt(identifyArgs, input.line, input.column);
-          const envelope = await runReadSeek(context, identifyArgs);
-          const name = identifiedName(requireDigestFacet(envelope, "identity"));
-          if (!name)
-            throw new Error("readseek could not identify a binding at the rename cursor");
-          await authorizeSearch(context, context.directory, name);
-        }
-        const args = buildRenameArgs({
+        await authorizeEdit(context, [filePath], simpleDiff(filePath, before, after), false);
+        context.abort.throwIfAborted();
+        const applied = record(await runReadSeek(context, buildEditArgs({
           path: filePath,
-          to: input.to,
-          line: input.line,
-          column: input.column,
-          workspace: input.workspace ? context.directory : undefined
-        });
-        const plan = await runReadSeek(context, args);
-        if (input.apply === false)
-          return plan;
-        const files = renameFiles(plan);
-        const planHash = record(plan).plan_hash;
-        if (typeof planHash !== "string" || planHash.length === 0) {
-          throw new Error("readseek rename plan did not include a plan hash");
-        }
-        await authorizeEdit(context, files);
-        return runReadSeek(context, buildRenameArgs({
-          path: filePath,
-          to: input.to,
-          line: input.line,
-          column: input.column,
-          workspace: input.workspace ? context.directory : undefined,
+          language: input.language,
+          requestFromStdin: true,
           apply: true,
-          planHash
+          planHash: plan.plan_hash
         }), {
           cancelable: false,
+          stdin: request,
           timeoutMs: DEFAULT_READSEEK_TIMEOUT_MS
-        });
-      }),
-      readseek_edit: readseekTool(openCodeToolDescription("edit"), {
-        path: tool.schema.string().describe("Path relative to the project directory"),
-        edits: tool.schema.array(tool.schema.union([
-          tool.schema.object({
-            set_line: tool.schema.object({
-              anchor: tool.schema.string().describe(PARAM_DESCRIPTIONS.anchor),
-              new_text: tool.schema.string().describe(PARAM_DESCRIPTIONS.newTextLine)
-            }).strict()
-          }).strict(),
-          tool.schema.object({
-            replace_lines: tool.schema.object({
-              start_anchor: tool.schema.string().describe(PARAM_DESCRIPTIONS.startAnchor),
-              end_anchor: tool.schema.string().describe(PARAM_DESCRIPTIONS.endAnchor),
-              new_text: tool.schema.string().describe(PARAM_DESCRIPTIONS.newTextRange)
-            }).strict()
-          }).strict(),
-          tool.schema.object({
-            insert_after: tool.schema.object({
-              anchor: tool.schema.string().describe(PARAM_DESCRIPTIONS.insertAnchor),
-              new_text: tool.schema.string().describe(PARAM_DESCRIPTIONS.newTextInsert)
-            }).strict()
-          }).strict(),
-          tool.schema.object({
-            replace: tool.schema.object({
-              old_text: tool.schema.string().describe(PARAM_DESCRIPTIONS.oldText),
-              new_text: tool.schema.string().describe(PARAM_DESCRIPTIONS.newText),
-              all: tool.schema.boolean().optional().describe(PARAM_DESCRIPTIONS.all)
-            }).strict()
-          }).strict(),
-          tool.schema.object({
-            replace_symbol: tool.schema.object({
-              symbol: tool.schema.string().describe(PARAM_DESCRIPTIONS.symbol),
-              new_body: tool.schema.string().describe(PARAM_DESCRIPTIONS.newBody)
-            }).strict()
-          }).strict()
-        ])).min(1).describe(PARAM_DESCRIPTIONS.edits),
-        language: tool.schema.string().optional().describe(PARAM_DESCRIPTIONS.languageSymbol)
-      }, "edit", async (input, context) => {
-        const filePath = resolvePath(context.directory, input.path);
-        validateEdits(input.edits);
-        return withFileMutationQueue(filePath, async () => {
-          context.abort.throwIfAborted();
-          await authorizeRead(context, filePath);
-          await rejectSymlinkMutation(filePath);
-          const edits = input.edits;
-          const request = JSON.stringify({ edits });
-          const baseArgs = buildEditArgs({
-            path: filePath,
-            language: input.language,
-            requestFromStdin: true
-          });
-          const plan = record(await runReadSeek(context, baseArgs, { stdin: request }));
-          if (typeof plan.before_content !== "string" || typeof plan.content !== "string" || typeof plan.plan_hash !== "string") {
-            throw new Error("readseek edit plan is missing before_content, content, or plan_hash");
-          }
-          const before = plan.before_content;
-          const after = plan.content;
-          const previewStart = Math.max(1, firstChangedLine(before, after) - 3);
-          const previewArgs = readRangeArgs(filePath, previewStart, previewStart + EDIT_RESULT_READ_LIMIT - 1);
-          if (before === after) {
-            return postMutationPreview(context, previewArgs, filePath, false);
-          }
-          await authorizeEdit(context, [filePath], simpleDiff(filePath, before, after), false);
-          context.abort.throwIfAborted();
-          const applied = record(await runReadSeek(context, buildEditArgs({
-            path: filePath,
-            language: input.language,
-            requestFromStdin: true,
-            apply: true,
-            planHash: plan.plan_hash
-          }), {
-            cancelable: false,
-            stdin: request,
-            timeoutMs: DEFAULT_READSEEK_TIMEOUT_MS
-          }));
-          if (applied.applied !== true) {
-            throw new Error("readseek did not confirm that the edit was applied");
-          }
-          return postMutationPreview(context, previewArgs, filePath, true);
-        });
-      }),
-      readseek_write: readseekTool(openCodeToolDescription("write"), {
-        path: tool.schema.string().describe("Path relative to the project directory"),
-        content: tool.schema.string().describe("Complete text file content")
-      }, "write", async (input, context) => {
-        const filePath = resolvePath(context.directory, input.path);
-        await authorizeExternal(context, filePath);
-        return withFileMutationQueue(filePath, async () => {
-          context.abort.throwIfAborted();
-          await rejectSymlinkMutation(filePath);
-          const before = await readTextSnapshot(filePath);
-          const content = input.content;
-          if (content.includes("\x00"))
-            throw new Error("write content must be text");
-          await authorizeEdit(context, [filePath], simpleDiff(filePath, before.content, content), false);
-          context.abort.throwIfAborted();
-          await writeText(filePath, before, content);
-          return postMutationPreview(context, digestArgs(filePath, "content", ["--end", String(DEFAULT_READ_LIMIT)]), filePath, !before.exists || before.content !== content);
-        });
-      })
-    },
+        }));
+        if (applied.applied !== true) {
+          throw new Error("readseek did not confirm that the edit was applied");
+        }
+        return postMutationPreview(context, previewArgs, filePath, true);
+      });
+    }),
+    readseek_write: readseekTool(openCodeToolDescription("write"), {
+      path: tool2.schema.string().describe(PARAM_DESCRIPTIONS.projectPath),
+      content: tool2.schema.string().describe(PARAM_DESCRIPTIONS.content)
+    }, "write", async (input, context) => {
+      const filePath = resolvePath(context.directory, input.path);
+      await authorizeExternal(context, filePath);
+      return withFileMutationQueue(filePath, async () => {
+        context.abort.throwIfAborted();
+        await rejectSymlinkMutation(filePath);
+        const before = await readTextSnapshot(filePath);
+        const content = input.content;
+        if (content.includes("\x00"))
+          throw new Error("write content must be text");
+        await authorizeEdit(context, [filePath], simpleDiff(filePath, before.content, content), false);
+        context.abort.throwIfAborted();
+        await writeText(filePath, before, content);
+        return postMutationPreview(context, digestArgs(filePath, "content", ["--end", String(DEFAULT_READ_LIMIT)]), filePath, !before.exists || before.content !== content);
+      });
+    })
+  };
+}
+
+// index.ts
+var ReadSeekPlugin = async (_input, options) => {
+  const anchors = new SessionAnchors;
+  const imagePolicy = resolveImagePolicy(options);
+  return {
+    tool: createReadSeekTools(imagePolicy),
     "experimental.chat.system.transform": async (_input2, output) => {
       output.system.push(TOOL_POLICY);
     },
@@ -2153,7 +2044,7 @@ var ReadSeekPlugin = async (_input, options) => {
         const files = new Set;
         collectAnchoredFiles(result, files);
         for (const filePath of files)
-          anchors.mark(input.sessionID, path2.resolve(filePath));
+          anchors.mark(input.sessionID, path7.resolve(filePath));
       } catch {}
     },
     "experimental.session.compacting": async (input, output) => {