pi-readseek 0.11.1 → 0.11.3

package/dist/index.ts

@@ -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"]),
@@ -276,9 +274,6 @@ var TOOL_COMPACT_GUIDELINES = {
 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 renderCompactGuidelines(name, aliases = {}) {
   return (TOOL_COMPACT_GUIDELINES[name] ?? []).map((guideline) => rewriteBacktickedToolNames(guideline, aliases));
 }
@@ -293,15 +288,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) {
@@ -404,8 +390,38 @@ function validateExactlyOneEditVariant(edits) {
   }
   return { ok: true, edits: normalized };
 }
+var BASE10_INT_RE = /^-?\d+$/;
 var MIN_SAFE_INTEGER = BigInt(Number.MIN_SAFE_INTEGER);
 var MAX_SAFE_INTEGER = BigInt(Number.MAX_SAFE_INTEGER);
+function formatReceived(value) {
+  if (typeof value === "number" || typeof value === "bigint")
+    return String(value);
+  return JSON.stringify(value) ?? String(value);
+}
+function invalidInteger(value, name) {
+  return {
+    ok: false,
+    message: `Invalid ${name}: expected a safe base-10 integer, received ${formatReceived(value)}.`
+  };
+}
+function coerceObviousBase10Int(value, name) {
+  if (value === undefined || typeof value === "string" && value.trim() === "") {
+    return { ok: true, value: undefined };
+  }
+  if (typeof value === "number") {
+    if (Number.isSafeInteger(value)) {
+      return { ok: true, value };
+    }
+    return invalidInteger(value, name);
+  }
+  if (typeof value === "string" && BASE10_INT_RE.test(value)) {
+    const parsed = BigInt(value);
+    if (parsed >= MIN_SAFE_INTEGER && parsed <= MAX_SAFE_INTEGER) {
+      return { ok: true, value: Number(parsed) };
+    }
+  }
+  return invalidInteger(value, name);
+}
 // ../readseek-api/src/argv.ts
 var DEFAULT_STRUCTURE_DEPTH = 1;
 function appendGitScopeArgs(args, input) {
@@ -1262,10 +1278,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")}`;
@@ -1425,7 +1441,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;
@@ -1524,6 +1540,23 @@ function resolveReadSeekBinaryFromPackages(resolver = resolveFromPackage, option
   accessSync(binaryPath, fsConstants.X_OK);
   return binaryPath;
 }
+// ../readseek-api/src/path.ts
+import { homedir } from "node:os";
+import path3 from "node:path";
+var UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+function expandUserPath(filePath, homedirFn = homedir) {
+  const withoutAt = filePath.startsWith("@") ? filePath.slice(1) : filePath;
+  const normalized = withoutAt.replace(UNICODE_SPACES, " ");
+  if (normalized === "~")
+    return homedirFn();
+  if (normalized.startsWith("~/"))
+    return homedirFn() + normalized.slice(1);
+  return normalized;
+}
+function resolveToCwd(filePath, cwd, homedirFn = homedir) {
+  const expanded = expandUserPath(filePath, homedirFn);
+  return path3.isAbsolute(expanded) ? expanded : path3.resolve(cwd, expanded);
+}
 // ../readseek-api/src/error.ts
 var READSEEK_USAGE_HINT = /(?:^|\n)\s*Run readseek(?: [\w-]+)* --help for more information\.?\s*$/;
 function cleanReadSeekErrorText(stderr) {
@@ -2013,8 +2046,7 @@ function descriptionAliases(toolName, registeredName, toolAliases) {
   }));
 }
 function defineToolPromptMetadata(options) {
-  const fileName = promptFileName(options.promptUrl);
-  const toolName = toolNameFromPrompt(fileName);
+  const toolName = options.toolName ?? toolNameFromPrompt(promptFileName(options.promptUrl));
   const replaceable = REPLACEABLE_BY_TOOL.get(toolName);
   const defaultReadSeekName = `readSeek_${toolName}`;
   const registeredName = options.registeredName ?? (replaceable ? defaultReadSeekName : undefined);
@@ -2221,13 +2253,6 @@ function generateCompactOrFullDiff(oldContent, newContent, contextLines = 4) {
   }
   return generateDiffString(oldContent, newContent, contextLines);
 }
-
-// src/path-utils.ts
-import {
-  expandUserPath as expandUserPath2,
-  resolveToCwd as resolveToCwd2
-} from "@jarkkojs/readseek-api";
-
 // src/runtime.ts
 function throwIfAborted(signal) {
   if (signal?.aborted)
@@ -2558,12 +2583,12 @@ function classifyEdit(oldContent, newContent) {
 // src/readseek-client.ts
 import { existsSync as existsSync2, statSync as statSync3 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
-import { homedir as homedir2 } from "node:os";
-import path3 from "node:path";
+import { homedir as homedir3 } from "node:os";
+import path4 from "node:path";
 
 // src/readseek-settings.ts
 import { readFileSync, statSync as statSync2 } from "node:fs";
-import { homedir } from "node:os";
+import { homedir as homedir2 } from "node:os";
 import { join } from "node:path";
 var READSEEK_TOOL_REPLACEMENTS = {
   read: "readSeek_show_content",
@@ -2750,7 +2775,7 @@ function mergeSettings(base, override) {
   return settings;
 }
 function resolveReadSeekJsonSettings() {
-  const globalResult = readSettingsFile(join(homedir(), ".pi/agent/settings.json"));
+  const globalResult = readSettingsFile(join(homedir2(), ".pi/agent/settings.json"));
   const projectResult = readSettingsFile(join(process.cwd(), ".pi/settings.json"));
   return {
     settings: mergeSettings(globalResult.settings, projectResult.settings),
@@ -2785,8 +2810,8 @@ function readSeekBinaryAvailability() {
 }
 var defaultReadSeekDirInit;
 function defaultReadSeekDir() {
-  const home = homedir2();
-  return home ? path3.join(home, ".pi", "readseek") : null;
+  const home = homedir3();
+  return home ? path4.join(home, ".pi", "readseek") : null;
 }
 function directoryExists(dir) {
   try {
@@ -2811,11 +2836,11 @@ async function ensureDefaultReadSeekDir() {
   return defaultReadSeekDirInit;
 }
 function hasProjectReadSeekDir(cwd = process.cwd()) {
-  let dir = path3.resolve(cwd);
+  let dir = path4.resolve(cwd);
   while (true) {
-    if (existsSync2(path3.join(dir, ".readseek")))
+    if (existsSync2(path4.join(dir, ".readseek")))
       return true;
-    const parent = path3.dirname(dir);
+    const parent = path4.dirname(dir);
     if (parent === dir)
       return false;
     dir = parent;
@@ -3212,7 +3237,7 @@ function linkToolPath(styledText, rawPath, cwd) {
   try {
     if (!getCapabilities().hyperlinks)
       return styledText;
-    const absolutePath = resolveToCwd2(rawPath, cwd);
+    const absolutePath = resolveToCwd(rawPath, cwd);
     return hyperlink(styledText, pathToFileURL(absolutePath).href);
   } catch {
     return styledText;
@@ -3614,7 +3639,7 @@ async function executeEdit(opts) {
   const parsed = params;
   const rawPath = parsed.path;
   const path = rawPath.replace(/^@/, "");
-  const absolutePath = resolveToCwd2(path, cwd);
+  const absolutePath = resolveToCwd(path, cwd);
   throwIfAborted(signal);
   try {
     return await withFileMutationQueue(absolutePath, async () => {
@@ -3736,7 +3761,7 @@ async function executeEdit(opts) {
 function registerEditTool(pi, options = {}) {
   const name = options.name ?? "readSeek_edit_text";
   const promptMetadata = defineToolPromptMetadata({
-    promptUrl: new URL("../prompts/edit_text.md", import.meta.url),
+    toolName: "edit_text",
     promptSnippet: "Edit existing files with fresh LINE:HASH anchors",
     registeredName: name,
     toolAliases: options.toolAliases
@@ -3833,7 +3858,7 @@ ${theme.fg("error", info.errorText)}`;
 
 // src/grep.ts
 import { readFile as fsReadFile2, stat as fsStat } from "node:fs/promises";
-import path4 from "node:path";
+import path5 from "node:path";
 import { createGrepTool } from "@earendil-works/pi-coding-agent";
 import { Type as Type5 } from "@sinclair/typebox";
 import { Text as Text4 } from "@earendil-works/pi-tui";
@@ -4200,12 +4225,6 @@ function formatGrepResultText(input) {
     errorText: undefined
   };
 }
-
-// src/coerce-obvious-int.ts
-import {
-  coerceObviousBase10Int
-} from "@jarkkojs/readseek-api";
-
 // src/tui-source-render.ts
 var GREP_ANCHOR_RE = /^(.*?):(>>|  )(\d+):([0-9a-zA-Z]{1,16})\|(.*)$/;
 function renderGrepSourceForDisplay(text, anchors, renderPath = (path) => path) {
@@ -4365,7 +4384,7 @@ async function executeGrep(opts) {
   if (!textBlock?.text)
     return result;
   const { path: rawSearchPath } = p;
-  const searchPath = resolveToCwd2(rawSearchPath || ".", cwd);
+  const searchPath = resolveToCwd(rawSearchPath || ".", cwd);
   let searchPathIsDirectory = false;
   try {
     searchPathIsDirectory = (await fsStat(searchPath)).isDirectory();
@@ -4419,7 +4438,7 @@ async function executeGrep(opts) {
   };
   const toAbsolutePath = (displayPath) => {
     if (searchPathIsDirectory)
-      return path4.resolve(searchPath, displayPath);
+      return path5.resolve(searchPath, displayPath);
     return searchPath;
   };
   const groupsByPath = new Map;
@@ -4609,7 +4628,7 @@ ${warning}` } : item),
 function registerGrepTool(pi, options = {}) {
   const name = options.name ?? "readSeek_find_text";
   const promptMetadata = defineToolPromptMetadata({
-    promptUrl: new URL("../prompts/find_text.md", import.meta.url),
+    toolName: "find_text",
     promptSnippet: "Search text or regex with edit-ready LINE:HASH anchors",
     registeredName: name
   });
@@ -4696,7 +4715,7 @@ function registerGrepTool(pi, options = {}) {
 }
 
 // src/search.ts
-import path5 from "node:path";
+import path6 from "node:path";
 import { Type as Type6 } from "@sinclair/typebox";
 
 // src/stat-search-path.ts
@@ -4755,7 +4774,7 @@ function mergeRanges(ranges) {
   return merged;
 }
 var SEARCH_PROMPT_METADATA = defineToolPromptMetadata({
-  promptUrl: new URL("../prompts/find_nodes.md", import.meta.url),
+  toolName: "find_nodes",
   promptSnippet: "Search code by AST structure using ast-grep-style patterns"
 });
 function linesFromSearchResult(result, ranges) {
@@ -4781,14 +4800,14 @@ function linesFromSearchResult(result, ranges) {
   return lines;
 }
 function readSeekLanguageForPath(language, searchPath, isFile) {
-  if (language === "typescript" && isFile && path5.extname(searchPath).toLowerCase() === ".tsx")
+  if (language === "typescript" && isFile && path6.extname(searchPath).toLowerCase() === ".tsx")
     return "tsx";
   return language;
 }
 async function executeSearch(opts) {
   const { params, signal, cwd, onFileAnchored } = opts;
   const p = params;
-  const searchPath = resolveToCwd2(p.path ?? ".", cwd);
+  const searchPath = resolveToCwd(p.path ?? ".", cwd);
   const statResult = await statSearchPathOrError("search", p.path, searchPath);
   if (!statResult.ok)
     return statResult.error;
@@ -4816,8 +4835,8 @@ async function executeSearch(opts) {
     }
     const readSeekFiles = [];
     for (const result of results) {
-      const abs = path5.isAbsolute(result.file) ? result.file : path5.resolve(cwd, result.file);
-      const display = path5.relative(cwd, abs) || abs;
+      const abs = path6.isAbsolute(result.file) ? result.file : path6.resolve(cwd, result.file);
+      const display = path6.relative(cwd, abs) || abs;
       const ranges = result.matches.map((match) => ({ startLine: match.start_line, endLine: match.end_line }));
       const mergedRanges = mergeRanges(ranges);
       const lines = linesFromSearchResult(result, mergedRanges);
@@ -4898,7 +4917,7 @@ function registerSearchTool(pi, options = {}) {
 
 // src/refs.ts
 import { Type as Type7 } from "@sinclair/typebox";
-import path6 from "node:path";
+import path7 from "node:path";
 
 // src/refs-output.ts
 function refsQueryLabel(input) {
@@ -4929,7 +4948,7 @@ function buildRefsOutput(input) {
 
 // src/refs.ts
 var REFS_PROMPT_METADATA = defineToolPromptMetadata({
-  promptUrl: new URL("../prompts/find_references.md", import.meta.url),
+  toolName: "find_references",
   promptSnippet: "Find references by identifier name or cursor binding"
 });
 function refsLine(reference) {
@@ -4942,14 +4961,14 @@ function groupReferences(references, cwd) {
   const files = new Map;
   const seen = new Set;
   for (const reference of references) {
-    const abs = path6.isAbsolute(reference.file) ? reference.file : path6.resolve(cwd, reference.file);
+    const abs = path7.isAbsolute(reference.file) ? reference.file : path7.resolve(cwd, reference.file);
     const dedupeKey = `${abs}:${reference.line}:${reference.column}`;
     if (seen.has(dedupeKey))
       continue;
     seen.add(dedupeKey);
     let file = files.get(abs);
     if (!file) {
-      file = { displayPath: path6.relative(cwd, abs) || abs, path: abs, lines: [] };
+      file = { displayPath: path7.relative(cwd, abs) || abs, path: abs, lines: [] };
       files.set(abs, file);
     }
     file.lines.push(refsLine(reference));
@@ -4966,7 +4985,7 @@ async function executeRefs(opts) {
   if (!scopeError.ok) {
     return buildToolErrorResult("refs", "invalid-parameter", `refs parameter: ${scopeError.error}`);
   }
-  const searchPath = resolveToCwd2(p.path ?? ".", cwd);
+  const searchPath = resolveToCwd(p.path ?? ".", cwd);
   const statResult = await statSearchPathOrError("refs", p.path, searchPath);
   if (!statResult.ok)
     return statResult.error;
@@ -5038,10 +5057,10 @@ function registerRefsTool(pi, options = {}) {
 
 // src/rename.ts
 import { Type as Type8 } from "@sinclair/typebox";
-import path7 from "node:path";
+import path8 from "node:path";
 import { Text as Text5 } from "@earendil-works/pi-tui";
 var RENAME_PROMPT_METADATA = defineToolPromptMetadata({
-  promptUrl: new URL("../prompts/rename_symbol.md", import.meta.url),
+  toolName: "rename_symbol",
   promptSnippet: "Rename a symbol at a source location with verified edits"
 });
 var renameSchema = Type8.Object({
@@ -5060,7 +5079,7 @@ async function executeRename(opts) {
   if (typeof p.at !== "string" || !/^(line:[1-9][0-9]*|hash:[0-9a-fA-F]+)(:[1-9][0-9]*)?$/.test(p.at)) {
     return buildToolErrorResult("rename_symbol", "invalid-parameter", "at must be a line or hash location with an optional positive column");
   }
-  const filePath = resolveToCwd2(p.path, cwd);
+  const filePath = resolveToCwd(p.path, cwd);
   try {
     const output = await readSeekRenameSymbol(filePath, {
       to: p.to,
@@ -5073,14 +5092,14 @@ async function executeRename(opts) {
       for (const file of [output, ...output.others]) {
         if (file.edits.length === 0)
           continue;
-        const absoluteFile = path7.isAbsolute(file.file) ? file.file : path7.resolve(cwd, file.file);
+        const absoluteFile = path8.isAbsolute(file.file) ? file.file : path8.resolve(cwd, file.file);
         onFileMutated?.(absoluteFile);
       }
     }
-    const primaryAbs = path7.isAbsolute(output.file) ? output.file : path7.resolve(cwd, output.file);
+    const primaryAbs = path8.isAbsolute(output.file) ? output.file : path8.resolve(cwd, output.file);
     const files = [primaryAbs];
     for (const other of output.others) {
-      const abs = path7.isAbsolute(other.file) ? other.file : path7.resolve(cwd, other.file);
+      const abs = path8.isAbsolute(other.file) ? other.file : path8.resolve(cwd, other.file);
       if (!files.includes(abs))
         files.push(abs);
     }
@@ -5162,7 +5181,7 @@ function registerRenameTool(pi, options = {}) {
       });
       if (expanded && output) {
         for (const file of outputs) {
-          const display = path7.relative(cwd, file.file) || file.file;
+          const display = path8.relative(cwd, file.file) || file.file;
           text += `
 ${linkedPathLine(theme, file.file, display, cwd, ` (${file.edits.length} edits)`, width)}`;
         }
@@ -5466,7 +5485,7 @@ async function executeWrite(opts) {
 function registerWriteTool(pi, options = {}) {
   const name = options.name ?? "readSeek_write_file";
   const promptMetadata = defineToolPromptMetadata({
-    promptUrl: new URL("../prompts/write_file.md", import.meta.url),
+    toolName: "write_file",
     promptSnippet: "Create or replace a complete file with LINE:HASH anchors",
     registeredName: name
   });
@@ -5482,7 +5501,7 @@ function registerWriteTool(pi, options = {}) {
     }),
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       const cwd = ctx?.cwd ?? process.cwd();
-      const absolutePath = resolveToCwd2(params.path, cwd);
+      const absolutePath = resolveToCwd(params.path, cwd);
       try {
         return await withFileMutationQueue2(absolutePath, async () => {
           let result;
@@ -5578,9 +5597,9 @@ function registerWriteTool(pi, options = {}) {
 
 // src/def.ts
 import { Type as Type10 } from "@sinclair/typebox";
-import path8 from "node:path";
+import path9 from "node:path";
 var DEF_PROMPT_METADATA = defineToolPromptMetadata({
-  promptUrl: new URL("../prompts/find_definitions.md", import.meta.url),
+  toolName: "find_definitions",
   promptSnippet: "Go to a symbol definition or declaration by name"
 });
 async function executeDef(opts) {
@@ -5589,7 +5608,7 @@ async function executeDef(opts) {
   if (!p.name || !p.name.trim()) {
     return buildToolErrorResult("def", "invalid-parameter", "readSeek_find_definitions requires 'name'");
   }
-  const searchPath = resolveToCwd2(p.path ?? ".", cwd);
+  const searchPath = resolveToCwd(p.path ?? ".", cwd);
   const statResult = await statSearchPathOrError("def", p.path, searchPath);
   if (!statResult.ok)
     return statResult.error;
@@ -5604,16 +5623,16 @@ async function executeDef(opts) {
       return {
         content: [{ type: "text", text: "no definitions found" }],
         details: {
-          readSeekValue: { tool: "def", ok: true, path: searchPath, definitions: [] }
+          readSeekValue: { tool: "def", ok: true, path: searchPath, definitions: [], files: [] }
         }
       };
     }
     const files = new Map;
     for (const def of definitions) {
-      const abs = path8.isAbsolute(def.file) ? def.file : path8.resolve(cwd, def.file);
+      const abs = path9.isAbsolute(def.file) ? def.file : path9.resolve(cwd, def.file);
       let file = files.get(abs);
       if (!file) {
-        file = { displayPath: path8.relative(cwd, abs) || abs, path: abs, lines: [] };
+        file = { displayPath: path9.relative(cwd, abs) || abs, path: abs, lines: [] };
         files.set(abs, file);
       }
       file.lines.push(buildReadSeekLineWithHash(def.line, def.line_hash, def.text));
@@ -5633,7 +5652,7 @@ async function executeDef(opts) {
       content: [{ type: "text", text: textParts.join(`
 `) }],
       details: {
-        readSeekValue: { tool: "def", ok: true, path: searchPath, definitions }
+        readSeekValue: { tool: "def", ok: true, path: searchPath, definitions, files: fileList }
       }
     };
   } catch (err) {
@@ -5676,7 +5695,7 @@ function registerDefTool(pi, options = {}) {
 }
 
 // src/access.ts
-import { Text as Text7 } from "@earendil-works/pi-tui";
+import { Text as Text7, wrapTextWithAnsi as wrapTextWithAnsi2 } from "@earendil-works/pi-tui";
 import { Type as Type11 } from "@sinclair/typebox";
 import { readFile as readFile2 } from "node:fs/promises";
 var operations = {
@@ -5709,6 +5728,48 @@ function resolveNonShowSummary(tool, envelope) {
     return "text recognized";
   return "complete";
 }
+var SOURCE_ROW_RE = /^(\d+)(:[0-9a-fA-F]+)? \| (.*)$/;
+function renderShowPresentation(summary, body, extras, expanded, theme, fallbackWidth) {
+  const fg = typeof theme?.fg === "function" ? (style, value) => theme.fg(style, value) : (_style, value) => value;
+  const rawBodyLines = expanded && body ? body.split(`
+`) : [];
+  let maxDigits = 0;
+  for (const line of rawBodyLines) {
+    const match = line.match(SOURCE_ROW_RE);
+    if (match && match[1].length > maxDigits)
+      maxDigits = match[1].length;
+  }
+  return {
+    invalidate() {},
+    render(renderWidth) {
+      const normalized = normalizeWidth(renderWidth, fallbackWidth ?? 80);
+      const out = [...wrapTextWithAnsi2(summary, normalized)];
+      if (!expanded)
+        return out;
+      for (const line of rawBodyLines) {
+        if (!line && maxDigits > 0)
+          continue;
+        const match = line.match(SOURCE_ROW_RE);
+        if (match) {
+          const anchor = `${match[1].padStart(maxDigits, " ")}${match[2] ?? ""}`;
+          const prefix = `  ${fg("dim", `${anchor} | `)}`;
+          out.push(...wrapWithHangingIndent(prefix, match[3] ?? "", normalized));
+        } else if (line.startsWith("Cursor: ")) {
+          out.push(...wrapWithHangingIndent("  ", fg("dim", line), normalized));
+        } else {
+          out.push(...wrapTextWithAnsi2(line, normalized));
+        }
+      }
+      for (const extra of extras) {
+        for (const line of extra.split(`
+`)) {
+          out.push(...wrapTextWithAnsi2(fg("warning", line), normalized));
+        }
+      }
+      return out;
+    }
+  };
+}
 function hasAnchors(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -5743,7 +5804,7 @@ async function executeAccess(opts) {
     return buildToolErrorResult(opts.tool, "invalid-parameter", "path is required");
   if (path === "-")
     return buildToolErrorResult(opts.tool, "invalid-parameter", "Agent tools require a file path; stdin is available through the CLI or API");
-  const filePath = resolveToCwd2(path, opts.cwd);
+  const filePath = resolveToCwd(path, opts.cwd);
   try {
     const { path: _path, ...options } = p;
     const envelope = await operations[opts.tool](filePath, { ...options, signal: opts.signal });
@@ -5774,7 +5835,7 @@ function registerAccessTools(pi, options = {}) {
     const registeredName = name === "show_content" ? options.name ?? `readSeek_${name}` : `readSeek_${name}`;
     const contract = getToolContract(name);
     const metadata = defineToolPromptMetadata({
-      promptUrl: new URL(`../prompts/${name}.md`, import.meta.url),
+      toolName: name,
       promptSnippet: contract.title,
       registeredName,
       toolAliases: options.toolAliases
@@ -5796,8 +5857,18 @@ function registerAccessTools(pi, options = {}) {
         const label = renderToolLabel(theme, registeredName);
         const filePath = typeof args?.path === "string" ? args.path : args?.path ? String(args.path) : "";
         const renderedPath = filePath ? linkToolPath(theme?.fg ? theme.fg("accent", filePath) : filePath, filePath, cwd) : "";
-        const atBadge = args?.at ? theme?.fg ? theme.fg("dim", ` @ ${args.at}`) : ` @ ${args.at}` : "";
-        const text = clampLineToWidth([label, renderedPath, atBadge].filter(Boolean).join(" "), context.width);
+        const atBadge = args?.at ? theme?.fg ? theme.fg("dim", `@ ${args.at}`) : `@ ${args.at}` : "";
+        const flags = [
+          args?.limit !== undefined && `limit=${args.limit}`,
+          args?.end !== undefined && `end=${args.end}`,
+          args?.depth !== undefined && `depth=${args.depth}`,
+          args?.kind && `kind=${args.kind}`,
+          args?.outline && "outline",
+          args?.noAnchors && "no-anchors",
+          args?.level && `level=${args.level}`
+        ].filter(Boolean);
+        const flagsBadge = flags.length > 0 ? theme?.fg ? theme.fg("dim", `[${flags.join(",")}]`) : `[${flags.join(",")}]` : "";
+        const text = clampLineToWidth([label, renderedPath, atBadge, flagsBadge].filter(Boolean).join(" "), context.width);
         return upsertTextComponent(context.lastComponent, text);
       },
       renderResult(result, renderOptions, theme, ...rest) {
@@ -5808,18 +5879,20 @@ function registerAccessTools(pi, options = {}) {
         if (isError || result.isError)
           return renderErrorResult(text, { expanded, width, fallback: `${registeredName} failed`, theme });
         const presentation = result.details?.readSeekValue?.presentation;
+        const envelope = result.details?.readSeekValue?.envelope;
         if (presentation) {
-          const summary = summaryLine(presentation.summary, { hidden: !!presentation.body && !expanded, theme, style: presentation.notices.length > 0 ? "warning" : "success" });
-          const notes = presentation.notices.map((notice) => `Note: ${notice}`);
+          const warning = typeof envelope?.warning === "string" && envelope.warning ? presentation.notices.at(-1) : undefined;
           const attachments = result.content?.filter((item) => item.type === "text").slice(1).map((item) => item.text) ?? [];
-          return new Text7([summary, ...expanded ? [presentation.body] : [], ...notes, ...attachments].filter(Boolean).join(`
-
-`), 0, 0);
+          const extras = [...warning ? [`Note: ${warning}`] : [], ...attachments];
+          const hasWarning = extras.length > 0;
+          const hasExpandable = Boolean(presentation.body) || hasWarning;
+          const summary = summaryLine(presentation.summary, { hidden: hasExpandable && !expanded, theme, style: hasWarning ? "warning" : "success" });
+          return renderShowPresentation(summary, presentation.body, extras, expanded, theme, width);
         }
-        const envelope = result.details?.readSeekValue?.envelope;
         const nonShowSummary = resolveNonShowSummary(name, envelope);
         const summary = summaryLine(nonShowSummary, { hidden: !!text && !expanded, theme, style: "success" });
-        return new Text7(clampLinesToWidth((expanded ? `${summary}\\n${text}` : summary).split(`
+        return new Text7(clampLinesToWidth((expanded ? `${summary}
+${text}` : summary).split(`
 `), width).join(`
 `), 0, 0);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "description": "Pi extension for LINE:HASH-anchored file operations and structural code navigation",
   "type": "module",
   "exports": {
@@ -39,8 +39,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",
     "diff": "^9.0.0",
     "xxhash-wasm": "^1.1.0"
   },