pi-readseek 0.4.30 → 0.5.1

package/README.md

@@ -2,8 +2,8 @@
 
 `pi-readseek` is a pi extension for readseek-backed file reading, hash-anchored
 editing, anchored grep, structural maps, symbol lookup, and structural search.
-It resolves conflicts between overlapping pi file-operation tools by exposing
-one consistent readseek-centered surface.
+It exposes readseek tools under the `readSeek_` prefix. Built-in pi tools stay
+active unless excluded in settings.
 
 ## Installation
 
@@ -23,61 +23,56 @@ npm install --save-dev @jarkkojs/readseek
 
 ## Tools
 
-- **read** — reads text files with `LINE:HASH` anchors for later `edit` calls;
-  images are returned as attachments and may include local OCR, caption, and
-  object text. Supports `symbol`, `map`, and `bundle` options powered by
-  `@jarkkojs/readseek`.
-- **edit** — changes existing text files using fresh anchors from `read`,
-  `grep`, `search`, or `write`. Variants: `set_line`, `replace_lines`,
-  `insert_after`, `replace_symbol`, `replace`. Set `new_text` to `""` to
-  delete a line.
-- **grep** — searches text and returns edit-ready `LINE:HASH` anchors without a
-  follow-up `read`.
-- **search** — searches code by structural pattern (AST) and returns anchored
-  matches. Use when syntax matters more than raw text.
-- **refs** — finds binding-accurate references to an identifier and returns
-  anchored usages with their enclosing symbols. Use before renaming or deleting
-  a symbol.
-- **write** — creates or overwrites whole files and returns anchors for
-  immediate follow-up edits.
+- **readSeek_read:** reads text files with `LINE:HASH` anchors; images can
+  include local OCR, captions, and object text.
+- **readSeek_edit:** edits existing text files using fresh `LINE:HASH` anchors.
+- **readSeek_grep:** searches text and returns edit-ready anchors.
+- **readSeek_search:** searches code by structural AST pattern.
+- **readSeek_refs:** finds identifier references with enclosing symbols.
+- **readSeek_rename:** plans or applies binding-aware renames.
+- **readSeek_hover:** identifies the cursor token and enclosing symbol.
+- **readSeek_def:** finds structural symbol definitions.
+- **readSeek_write:** creates or overwrites whole files and returns anchors.
 
 ## Settings
 
 `pi-readseek` reads optional JSON settings from:
 
-| Location | Scope |
-| --- | --- |
-| `~/.pi/agent/readseek/settings.json` | Global |
-| `.pi/readseek/settings.json` | Project |
+- `~/.pi/agent/settings.json` — Global
+- `.pi/settings.json` — Project
 
-Project settings override global settings. Image OCR behavior is controlled by
-`read.ocrMode`:
+Project settings override global settings. The `readseek` section lives inside pi's
+shared `settings.json`, alongside other extensions' sections. All settings are
+optional (defaults shown):
 
 ```json
 {
-  "read": {
-    "ocrMode": "on"
+  "readseek": {
+    "excludeTools": [],
+    "imageMode": "force",
+    "syntaxValidation": "warn",
+    "timeoutMs": 120000,
+    "grep": {
+      "maxLines": 2000,
+      "maxBytes": 51200
+    }
   }
 }
 ```
 
-Modes:
-
-- `"on"` — always run local image OCR/caption/object analysis. This is the
-  default.
-- `"off"` — return only the image attachment. Use this as a workaround if the
-  local readseek image-analysis path crashes.
-- `"auto"` — run local image analysis only when the active model does not
-  support native image input.
-
-`READSEEK_READ_OCR_MODE=on|off|auto` overrides the JSON setting for one
-process.
-
-## Related
-
-- [readseek.vim](https://github.com/jarkkojs/readseek.vim) — Vim 9 plugin
-  frontend for the readseek CLI. Provides go-to-definition, references,
-  rename, hover, and structural search from within Vim.
+- **excludeTools:** active tool names to hide after activating `readSeek_*`
+  tools. For a readseek-only file surface, use `["read", "edit", "write",
+  "grep"]`.
+- **imageMode:** image OCR/caption/object analysis in `readSeek_read`: `"force"`
+  (or its alias `"on"`) always runs it, `"off"` returns only the image
+  attachment, and `"auto"` runs it only when the active model does not support
+  native image input.
+- **syntaxValidation:** pre-write syntax-regression check in `readSeek_edit`:
+  `"warn"` writes with a warning, `"block"` aborts without writing, `"off"`
+  skips the check.
+- **timeoutMs:** readseek invocation timeout in milliseconds.
+- **grep.maxLines** / **grep.maxBytes:** visible `readSeek_grep` output
+  budget; values above the defaults are clamped.
 
 ## Licensing
 

package/index.ts

@@ -9,7 +9,24 @@ import { registerHoverTool } from "./src/hover.js";
 import { registerWriteTool } from "./src/write.js";
 import { registerDefTool } from "./src/def.js";
 import { SessionAnchors } from "./src/session-anchors.js";
-import { isReadSeekAvailable } from "./src/readseek-client.js";
+import { readSeekBinaryAvailability } from "./src/readseek-client.js";
+import { resolveReadSeekJsonSettings, type ReadSeekSettingsWarning } from "./src/readseek-settings.js";
+
+const READSEEK_TOOL_NAMES = [
+	"readSeek_read",
+	"readSeek_edit",
+	"readSeek_grep",
+	"readSeek_search",
+	"readSeek_refs",
+	"readSeek_rename",
+	"readSeek_hover",
+	"readSeek_write",
+	"readSeek_def",
+];
+
+function formatSettingsWarning(warning: ReadSeekSettingsWarning): string {
+	return `${warning.message} (${warning.source})`;
+}
 
 export default function piReadSeekExtension(pi: ExtensionAPI): void {
 	const sessionAnchors = new SessionAnchors();
@@ -18,16 +35,37 @@ export default function piReadSeekExtension(pi: ExtensionAPI): void {
 
 	registerReadTool(pi, { onSuccessfulRead: markAnchored });
 	registerEditTool(pi, { wasReadInSession: hasFreshAnchors });
-	const searchAvailable = isReadSeekAvailable();
-	const searchGuideline = searchAvailable
-		? "Use grep summary for counts; use search for structural code patterns."
-		: "Use grep summary for counts; search is unavailable (readseek native backend not loaded).";
-
-	registerGrepTool(pi, { searchGuideline, onFileAnchored: markAnchored });
+	registerGrepTool(pi, { onFileAnchored: markAnchored });
 	registerSgTool(pi, { onFileAnchored: markAnchored });
 	registerRefsTool(pi, { onFileAnchored: markAnchored });
 	registerRenameTool(pi);
 	registerHoverTool(pi);
 	registerDefTool(pi, { onFileAnchored: markAnchored });
 	registerWriteTool(pi, { onFileAnchored: markAnchored });
+
+	pi.on("session_start", (_event, ctx) => {
+		const { settings, warnings } = resolveReadSeekJsonSettings();
+		const excludeTools = new Set(settings.excludeTools ?? []);
+		const knownTools = new Set([...pi.getAllTools().map((tool) => tool.name), ...READSEEK_TOOL_NAMES]);
+		const problems = warnings.map(formatSettingsWarning);
+		for (const name of excludeTools) {
+			if (!knownTools.has(name)) problems.push(`Unknown tool "${name}" in readseek.excludeTools`);
+		}
+
+		const availability = readSeekBinaryAvailability();
+		if (!availability.available) {
+			problems.push(`readseek tools are inactive: ${availability.reason}`);
+		}
+
+		for (const problem of problems) {
+			if (ctx.hasUI) ctx.ui.notify(problem, "warning");
+			else console.warn(problem);
+		}
+
+		if (!availability.available) return;
+
+		const activeTools = [...pi.getActiveTools(), ...READSEEK_TOOL_NAMES]
+			.filter((name) => !excludeTools.has(name));
+		pi.setActiveTools([...new Set(activeTools)]);
+	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.4.30",
+  "version": "0.5.1",
   "description": "Pi extension for readseek-backed hash-anchored read/edit/grep, structural code maps, structural search, and file exploration",
   "type": "module",
   "exports": {
@@ -39,7 +39,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.4.34",
+    "@jarkkojs/readseek": "^0.5.0",
     "diff": "^8.0.3",
     "xxhash-wasm": "^1.1.0"
   },

package/prompts/def.md

@@ -1,24 +1,17 @@
----
-tools: def
----
-
 Find structural symbol definitions. Calls `readseek def` which searches
 for the definition of a named symbol across a file or directory.
 
 ## Parameters
 
 - `path` (optional): File or directory to search (default: ".").
-- `name` (optional): Qualified or unqualified symbol name. Required unless
-  `fromIdentify` is true.
+- `name`: Qualified or unqualified symbol name.
 - `lang` (optional): Language override.
-- `fromIdentify` (optional): When true, reads identify output from a
-  previous identify call to extract the symbol name automatically.
 - `cached` (optional): Search tracked/indexed files in a Git repository.
 - `others` (optional): Search untracked files.
 - `ignored` (optional): Include ignored untracked files.
 
 ## When to use
 
-- After a hover call, to jump to where a symbol is defined.
+- After a `readSeek_hover` call, use the qualified symbol name to jump to its definition.
 - When the user asks "where is X defined?".
 - To find a function/class/type definition by its qualified name.

package/prompts/edit.md

@@ -1,6 +1,6 @@
-Surgically edit existing text files. Prefer hash-verified anchors from fresh `read`, `grep`, `search`, or `write` output; copy `LINE:HASH` anchors exactly.
+Surgically edit existing text files. Prefer hash-verified anchors from fresh `readSeek_read`, `readSeek_grep`, `readSeek_search`, or `readSeek_write` output; copy `LINE:HASH` anchors exactly.
 
-`edit` requires the target file to have been anchored earlier in the current session. If you get `file-not-read`, run `read`, `grep`, `search`, or `write` first.
+`readSeek_edit` requires the target file to have been anchored earlier in the current session. If you get `file-not-read`, run `readSeek_read`, `readSeek_grep`, `readSeek_search`, or `readSeek_write` first.
 
 ## Variants
 
@@ -43,28 +43,28 @@ Wrap string replacements as `{ "replace": { "old_text": "...", "new_text": "..."
 
 ## `replace_symbol`
 
-Use `replace_symbol` when you want to replace one whole mapped symbol without line anchors. Query symbols like `read({ symbol })`: `Name`, `Class.method`, or `Name@<line>`.
+Use `replace_symbol` when you want to replace one whole mapped symbol without line anchors. Query symbols like `readSeek_read({ symbol })`: `Name`, `Class.method`, or `Name@<line>`.
 
 Rules:
 
-- Use an exact name, dotted path, or `@<line>`. If `read({ symbol })` returned a fuzzy match, confirm the exact symbol first.
+- Use an exact name, dotted path, or `@<line>`. If `readSeek_read({ symbol })` returned a fuzzy match, confirm the exact symbol first.
 - Supported for TypeScript, JavaScript, Rust, and Java. For other languages, use anchored edits.
 - `new_body` must not be empty or whitespace-only.
-- Write `new_body` without extra leading indentation; `edit` re-indents it to match the original symbol.
+- Write `new_body` without extra leading indentation; `readSeek_edit` re-indents it to match the original symbol.
 - If `new_body` appears to declare a different symbol name, the edit still applies but returns a `name-mismatch` warning.
 - Do not combine `replace_symbol` with anchored edits that touch the same lines. Duplicate or overlapping `replace_symbol` ranges are rejected.
 
 ## Stale anchors
 
-If anchors no longer match, `edit` fails with `hash-mismatch` and shows nearby current lines. Lines marked `>>>` include updated anchors:
+If anchors no longer match, `readSeek_edit` fails with `hash-mismatch` and shows nearby current lines. Lines marked `>>>` include updated anchors:
 
 ```text
 >>> 41:b34|  const renamed = 3;
 ```
 
-Copy the updated `LINE:HASH` and retry. If the target moved farther away, re-run `read`, `grep`, `search`, or `write` for fresh anchors.
+Copy the updated `LINE:HASH` and retry. If the target moved farther away, re-run `readSeek_read`, `readSeek_grep`, `readSeek_search`, or `readSeek_write` for fresh anchors.
 
-If `edit` auto-relocates an anchor, read the warning and verify that the edit landed in the intended place.
+If `readSeek_edit` auto-relocates an anchor, read the warning and verify that the edit landed in the intended place.
 
 ## Validation and warnings
 
@@ -80,21 +80,21 @@ Syntax validation runs before writing when supported:
 - Default `warn`: write succeeds, but warnings include `syntax-regression: lines X-Y`.
 - `block`: aborts without writing.
 - `off`: skips validation.
-- `READSEEK_SYNTAX_VALIDATE` can set the default mode.
+- The `readseek.syntaxValidation` setting can change the default mode.
 
 Existing syntax errors are tolerated; warnings are for newly introduced parser errors.
 
 ## Optional post-edit verification
 
-`postEditVerify: true` opts into read-back verification for this call. It is off by default. When enabled, `edit` writes normally, then reads the file back and compares persisted content to the intended content, including BOM and original line endings. This is not syntax validation.
+`postEditVerify: true` opts into read-back verification for this call. It is off by default. When enabled, `readSeek_edit` writes normally, then reads the file back and compares persisted content to the intended content, including BOM and original line endings. This is not syntax validation.
 
 ## Diff data contract
 
-Successful `edit` results include:
+Successful `readSeek_edit` results include:
 
-- `details.diff` and `details.readseekValue.diff`: compact human-readable hashline diff strings.
+- `details.diff` and `details.readSeekValue.diff`: compact human-readable hashline diff strings.
 - `details.patch`: standard unified diff with file and hunk headers.
-- `details.diffData` and `details.readseekValue.diffData`: stable structured diff data.
+- `details.diffData` and `details.readSeekValue.diffData`: stable structured diff data.
 
 `diffData` shape:
 

package/prompts/grep.md

@@ -1,4 +1,4 @@
-Search file contents. Non-summary results include edit-ready `LINE:HASH` anchors, so you usually do not need a follow-up `read` before `edit`.
+Search file contents. Non-summary results include edit-ready `LINE:HASH` anchors, so you usually do not need a follow-up `readSeek_read` before `readSeek_edit`.
 
 ## Modes
 
@@ -21,8 +21,8 @@ Search file contents. Non-summary results include edit-ready `LINE:HASH` anchors
 
 ## Use well
 
-Use `grep` for text: identifiers, strings, config keys, error messages, comments, or docs. Use `literal: true` unless you want regex behavior.
+Use `readSeek_grep` for text: identifiers, strings, config keys, error messages, comments, or docs. Use `literal: true` unless you want regex behavior.
 
-For code shape — calls, imports, declarations, JSX, object literals, control flow — prefer `search`, which parses AST patterns.
+For code shape — calls, imports, declarations, JSX, object literals, control flow — prefer `readSeek_search`, which parses AST patterns.
 
 If output says results were truncated at `limit` or by display budget, narrow before editing. Good narrowing order: `summary` → `path`/`glob` → stricter pattern → `scope: "symbol"` or `context`.

package/prompts/hover.md

@@ -1,8 +1,4 @@
----
-tools: hover
----
-
-Use hover to identify the identifier and enclosing symbol at a cursor
+Use `readSeek_hover` to identify the identifier and enclosing symbol at a cursor
 position. Calls `readseek identify` with the file content sent via stdin
 so unsaved editor content is included.
 
@@ -14,6 +10,6 @@ so unsaved editor content is included.
 
 ## When to use
 
-- Before a rename, to confirm the identifier under the cursor.
+- Before a `readSeek_rename`, to confirm the identifier under the cursor.
 - Before a go-to-definition, to get the qualified symbol name.
 - To inspect what symbol a specific line belongs to.

package/prompts/read.md

@@ -1,4 +1,4 @@
-Read files through readseek. Text output uses `LINE:HASH|content` anchors that can be copied directly into `edit`; supported images return attachments and may append OCR/caption/object text depending on `read.ocrMode`. Default cap: {{DEFAULT_MAX_LINES}} lines or {{DEFAULT_MAX_BYTES}}.
+Read files through readseek. Text output uses `LINE:HASH|content` anchors that can be copied directly into `readSeek_edit`; supported images return attachments and may append OCR/caption/object text depending on `readseek.imageMode`. Default cap: {{DEFAULT_MAX_LINES}} lines or {{DEFAULT_MAX_BYTES}}.
 
 ## Choose the right read
 
@@ -15,7 +15,7 @@ Read files through readseek. Text output uses `LINE:HASH|content` anchors that c
 - `symbol` — symbol query; supports `Class.method`, package-relative Java names, and `Name@<line>` disambiguation; cannot combine with `offset` / `limit`.
 - `bundle` — only `"local"`; requires `symbol` and cannot combine with `map`.
 
-When a full-file read is truncated, readseek appends a structural map automatically when available. Use map line ranges for follow-up `read({ offset, limit })` calls.
+When a full-file read is truncated, readseek appends a structural map automatically when available. Use map line ranges for follow-up `readSeek_read({ offset, limit })` calls.
 
 ## Symbol examples
 
@@ -38,4 +38,4 @@ Result behavior:
 - **Fuzzy**: returns the best camelCase/substring match with a warning; verify before editing from those anchors.
 - **Not found** or **unmappable**: falls back to normal read with a warning and, when available, symbol suggestions.
 
-Hash anchors from normal, symbol, and bundled reads are valid for `edit` until the file changes.
+Hash anchors from normal, symbol, and bundled reads are valid for `readSeek_edit` until the file changes.

package/prompts/refs.md

@@ -20,4 +20,4 @@ Without `scope`, references match by identifier name across the target. With `sc
 
 When searching a directory inside a Git repository, readseek defaults to tracked/indexed files plus untracked non-ignored files. Use `cached`, `others`, and `ignored` to narrow or expand that selection. `ignored` requires `others`.
 
-Use `grep` for plain text, `search` for code shape, and `refs` for identifier usage.
+Use `readSeek_grep` for plain text, `readSeek_search` for code shape, and `readSeek_refs` for identifier usage.

package/prompts/rename.md

@@ -1,8 +1,4 @@
----
-tools: rename
----
-
-Use rename to rename an identifier (variable, function, type, etc.) with
+Use `readSeek_rename` to rename an identifier (variable, function, type, etc.) with
 binding accuracy. The tool calls `readseek rename` which resolves the
 lexical binding under the cursor and renames every occurrence that binds
 to the same declaration.
@@ -27,5 +23,5 @@ to the same declaration.
 
 ## When not to use
 
-- For search-and-replace across files, use grep or sg.
-- For refactoring that requires adding/removing parameters, use edit.
+- For search-and-replace across files, use `readSeek_grep` or `readSeek_search`.
+- For refactoring that requires adding/removing parameters, use `readSeek_edit`.

package/prompts/sg.md

@@ -37,4 +37,4 @@ Useful `lang` values include `assembly`, `bash`, `c`, `cpp`, `csharp`, `css`, `d
 
 When searching a directory inside a Git repository, readseek defaults to tracked/indexed files plus untracked non-ignored files. Use `cached`, `others`, and `ignored` to narrow or expand that selection. `ignored` requires `others`.
 
-Use `grep` for plain text and `search` for structure.
+Use `readSeek_grep` for plain text and `readSeek_search` for structure.

package/prompts/write.md

@@ -1,10 +1,10 @@
-Create or overwrite a whole file and return `LINE:HASH` anchors for immediate follow-up `edit` calls.
+Create or overwrite a whole file and return `LINE:HASH` anchors for immediate follow-up `readSeek_edit` calls.
 
 ## Use / avoid
 
-Use `write` for new files, generated files, or intentional full-file replacement. For small changes or appends to an existing file, read or search first and use `edit` (`insert_after` for appends).
+Use `readSeek_write` for new files, generated files, or intentional full-file replacement. For small changes or appends to an existing file, run `readSeek_read` or `readSeek_search` first and use `readSeek_edit` (`insert_after` for appends).
 
-Existing files are overwritten without confirmation. Binary-looking content can be written, but hashlines are not generated, so there are no anchors for `edit`.
+Existing files are overwritten without confirmation. Binary-looking content can be written, but hashlines are not generated, so there are no anchors for `readSeek_edit`.
 
 ## Parameters
 
@@ -14,11 +14,11 @@ Existing files are overwritten without confirmation. Binary-looking content can
 
 ## Output
 
-Successful text writes return `LINE:HASH|content`. Display hashlines escape control characters for safe rendering. Visible output is capped at 2000 lines or 50 KB, but full anchors remain available in `readseekValue`.
+Successful text writes return `LINE:HASH|content`. Display hashlines escape control characters for safe rendering. Visible output is capped at 2000 lines or 50 KB, but full anchors remain available in `readSeekValue`.
 
 ## Diff data contract
 
-Successful text `write` results include additive final `details.diff`, `details.readseekValue.diff`, `details.diffData`, and `details.readseekValue.diffData` fields. String diff fields remain the backward-compatible human-readable fallback.
+Successful text `readSeek_write` results include additive final `details.diff`, `details.readSeekValue.diff`, `details.diffData`, and `details.readSeekValue.diffData` fields. String diff fields remain the backward-compatible human-readable fallback.
 
 `diffData` is a stable versioned contract:
 

package/src/def.ts

@@ -6,8 +6,8 @@ import { defineToolPromptMetadata } from "./tool-prompt-metadata.js";
 import { buildReadSeekLineWithHash, buildToolErrorResult } from "./readseek-value.js";
 import { resolveToCwd } from "./path-utils.js";
 import { statSearchPathOrError } from "./stat-search-path.js";
-import { classifyReadSeekFailure, readseekDef } from "./readseek-client.js";
-import { searchPathParam, langParam, readseekGitSearchParams } from "./readseek-params.js";
+import { classifyReadSeekFailure, readSeekDef } from "./readseek-client.js";
+import { searchPathParam, langParam, readSeekGitSearchParams } from "./readseek-params.js";
 import { registerReadSeekTool } from "./register-tool.js";
 
 import { renderAnchoredFilesResult, renderReadSeekSearchCall } from "./tui-render-utils.js";
@@ -22,7 +22,6 @@ type DefParams = {
 	name?: string;
 	path?: string;
 	lang?: string;
-	fromIdentify?: boolean;
 	cached?: boolean;
 	others?: boolean;
 	ignored?: boolean;
@@ -43,8 +42,8 @@ export async function executeDef(opts: ExecuteDefOptions): Promise<any> {
 	const { params, signal, cwd, onFileAnchored } = opts;
 	const p = params as DefParams;
 
-	if (!p.fromIdentify && (!p.name || !p.name.trim())) {
-		return buildToolErrorResult("def", "invalid-parameter", "def requires 'name' or 'fromIdentify'");
+	if (!p.name || !p.name.trim()) {
+		return buildToolErrorResult("def", "invalid-parameter", "readSeek_def requires 'name'");
 	}
 
 	const searchPath = resolveToCwd(p.path ?? ".", cwd);
@@ -53,9 +52,8 @@ export async function executeDef(opts: ExecuteDefOptions): Promise<any> {
 	if (!statResult.ok) return statResult.error;
 
 	try {
-		const definitions = await readseekDef(searchPath, {
+		const definitions = await readSeekDef(searchPath, {
 			name: p.name,
-			fromIdentify: p.fromIdentify,
 			language: p.lang,
 			cached: p.cached,
 			others: p.others,
@@ -67,7 +65,7 @@ export async function executeDef(opts: ExecuteDefOptions): Promise<any> {
 			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: [] },
 				},
 			};
 		}
@@ -92,14 +90,14 @@ export async function executeDef(opts: ExecuteDefOptions): Promise<any> {
 		for (const file of fileList) {
 			textParts.push(file.displayPath);
 			for (const line of file.lines) {
-			textParts.push(`  ${line.line}:${line.hash} ${line.display}`);
+				textParts.push(`  ${line.line}:${line.hash} ${line.display}`);
 			}
 		}
 
 		return {
 			content: [{ type: "text", text: textParts.join("\n") }],
 			details: {
-				readseekValue: { tool: "def", ok: true, path: searchPath, definitions },
+				readSeekValue: { tool: "def", ok: true, path: searchPath, definitions },
 			},
 		};
 	} catch (err: any) {
@@ -110,21 +108,16 @@ export async function executeDef(opts: ExecuteDefOptions): Promise<any> {
 
 export function registerDefTool(pi: ExtensionAPI, options: DefToolOptions = {}) {
 	registerReadSeekTool(pi, {
-		policy: "read-only",
-		pythonName: "def",
-		defaultExposure: "opt-in",
-	}, {
-		name: "def",
+		name: "readSeek_def",
 		label: "Definition",
 		description: DEF_PROMPT_METADATA.description,
 		promptSnippet: DEF_PROMPT_METADATA.promptSnippet,
 		promptGuidelines: DEF_PROMPT_METADATA.promptGuidelines,
 		parameters: Type.Object({
-			name: Type.Optional(Type.String({ description: "Qualified or unqualified symbol name" })),
+			name: Type.String({ description: "Qualified or unqualified symbol name" }),
 			path: searchPathParam(),
 			lang: langParam(),
-			fromIdentify: Type.Optional(Type.Boolean({ description: "Read identify output from stdin to choose the symbol name" })),
-			...readseekGitSearchParams(),
+			...readSeekGitSearchParams(),
 		}),
 		async execute(_toolCallId, params, signal, _onUpdate, ctx) {
 			return executeDef({ params, signal, cwd: ctx.cwd, onFileAnchored: options.onFileAnchored });
@@ -133,7 +126,7 @@ export function registerDefTool(pi: ExtensionAPI, options: DefToolOptions = {})
 			return renderReadSeekSearchCall(args, theme, rest, {
 				label: "def",
 				accent: args.name,
-				flags: [args.fromIdentify && "from-identify", args.cached && "cached", args.others && "others", args.ignored && "ignored"],
+				flags: [args.cached && "cached", args.others && "others", args.ignored && "ignored"],
 			});
 		},
 		renderResult(result: any, options: ToolRenderResultOptions, theme: any, ...rest: any[]) {

package/src/edit-output.ts

@@ -17,7 +17,7 @@ export interface BuildEditOutputInput {
 export interface EditOutputResult {
   text: string;
   patch: string;
-  readseekValue: ReturnType<typeof buildReadSeekEditResult>;
+  readSeekValue: ReturnType<typeof buildReadSeekEditResult>;
 }
 
 const EDIT_OPERATION_NAMES = ["set_line", "replace_lines", "insert_after", "replace"] as const;
@@ -84,7 +84,7 @@ function formatReplaceHint(edits: unknown[] | undefined, noopEdits: unknown[]):
   const counts = countEditTypes(edits);
   if (counts.replace === 0) return undefined;
   if (counts.replace !== counts.total) return undefined;
-  return "[info: this edit used replace (unverified). For safer future edits, prefer set_line/replace_lines with an anchor from read/grep/search.]";
+  return "[info: this edit used replace (unverified). For safer future edits, prefer set_line/replace_lines with an anchor from readSeek_read/readSeek_grep/readSeek_search.]";
 }
 export function buildEditOutput(input: BuildEditOutputInput): EditOutputResult {
   const summary = `Updated ${input.displayPath}`;
@@ -99,7 +99,7 @@ export function buildEditOutput(input: BuildEditOutputInput): EditOutputResult {
   return {
     text,
     patch: input.patch ?? "",
-    readseekValue: buildReadSeekEditResult({
+    readSeekValue: buildReadSeekEditResult({
       path: input.path,
       summary,
       diff: input.diff,

package/src/edit-syntax-validate.ts

@@ -1,4 +1,4 @@
-import { readseekCheck, type ReadSeekCheckOutput, type ReadSeekDiagnostic } from "./readseek-client.js";
+import { readSeekCheck, type ReadSeekCheckOutput, type ReadSeekDiagnostic } from "./readseek-client.js";
 
 export interface ValidateInput {
   filePath: string;
@@ -46,8 +46,8 @@ export async function validateSyntaxRegression(
   let before: ReadSeekCheckOutput;
   let after: ReadSeekCheckOutput;
   try {
-    before = input.before === undefined ? EMPTY : await readseekCheck(input.filePath, input.before, { signal: options.signal });
-    after = await readseekCheck(input.filePath, input.after, { signal: options.signal });
+    before = input.before === undefined ? EMPTY : await readSeekCheck(input.filePath, input.before, { signal: options.signal });
+    after = await readSeekCheck(input.filePath, input.after, { signal: options.signal });
   } catch {
     return null;
   }