@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-lsp-extension/src/tools/hover.js

@@ -0,0 +1,143 @@
+// @ts-nocheck
+/**
+ * lsp_hover — Get type information and documentation at a position.
+ */
+import { Type } from "@sinclair/typebox";
+import { Text } from "@earendil-works/pi-tui";
+import { resolveProvider } from "../resolve-provider.js";
+import { getEnclosingDeclaration, getSignatureText } from "../tree-sitter/symbol-extractor.js";
+import { resolveSymbolPosition, getSymbolNames } from "../shared/resolve-position.js";
+import { readFile } from "node:fs/promises";
+function formatHoverContent(hover) {
+    const contents = hover.contents;
+    if (typeof contents === "string")
+        return contents;
+    if ("kind" in contents && "value" in contents)
+        return contents.value;
+    if ("language" in contents && "value" in contents) {
+        return `\`\`\`${contents.language}\n${contents.value}\n\`\`\``;
+    }
+    if (Array.isArray(contents)) {
+        return contents.map((c) => {
+            if (typeof c === "string")
+                return c;
+            if ("language" in c && "value" in c)
+                return `\`\`\`${c.language}\n${c.value}\n\`\`\``;
+            return String(c);
+        }).join("\n\n");
+    }
+    return String(contents);
+}
+const HoverParams = Type.Object({
+    path: Type.String({ description: "File path" }),
+    line: Type.Optional(Type.Number({ description: "Line number (1-indexed). Required unless query is provided." })),
+    character: Type.Optional(Type.Number({ description: "Column number (1-indexed). Required unless query is provided." })),
+    query: Type.Optional(Type.String({ description: "Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically." })),
+});
+export function createHoverTool(manager, treeSitter) {
+    return {
+        name: "lsp_hover",
+        label: "LSP Hover",
+        description: "Get type information and documentation for a symbol at a specific position in a file. Line and character are 1-indexed.",
+        promptSnippet: "Get type info and docs for a symbol at a file position via LSP",
+        parameters: HoverParams,
+        async execute(_toolCallId, params) {
+            const filePath = params.path.replace(/^@/, "");
+            let line = params.line;
+            let character = params.character;
+            let resolvedFrom;
+            // Resolve position from query if line/character not provided
+            if ((line === undefined || character === undefined) && params.query) {
+                const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);
+                if (resolved) {
+                    line = resolved.line;
+                    character = resolved.character;
+                    resolvedFrom = `Resolved "${params.query}" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;
+                }
+                else {
+                    const names = await getSymbolNames(filePath, manager, treeSitter);
+                    const hint = names.length > 0 ? `\nAvailable symbols: ${names.slice(0, 20).join(", ")}` : "";
+                    return { content: [{ type: "text", text: `Could not find symbol "${params.query}" in ${filePath}${hint}` }], details: { hasResult: false } };
+                }
+            }
+            if (line === undefined || character === undefined) {
+                return { content: [{ type: "text", text: "Either line/character or query is required." }], details: { hasResult: false } };
+            }
+            const client = await manager.getClientForFile(filePath).catch(() => null);
+            if (client) {
+                // LSP path
+                const uri = manager.getFileUri(filePath);
+                const position = { line: line - 1, character: character - 1 };
+                try {
+                    const hover = await client.sendRequest("textDocument/hover", {
+                        textDocument: { uri }, position,
+                    });
+                    if (!hover) {
+                        const text = resolvedFrom
+                            ? `${resolvedFrom}\n\nNo hover information available at this position.`
+                            : "No hover information available at this position.";
+                        return { content: [{ type: "text", text }], details: { hasResult: false } };
+                    }
+                    const hoverText = formatHoverContent(hover);
+                    const text = resolvedFrom ? `${resolvedFrom}\n\n${hoverText}` : hoverText;
+                    return { content: [{ type: "text", text }], details: { hasResult: true } };
+                }
+                catch (err) {
+                    return { content: [{ type: "text", text: `LSP hover request failed: ${err.message}` }], details: { hasResult: false } };
+                }
+            }
+            // Tree-sitter fallback
+            if (treeSitter) {
+                const provider = resolveProvider(filePath, manager, treeSitter);
+                if (provider.type === "tree-sitter") {
+                    try {
+                        const absPath = manager.resolvePath(filePath);
+                        const content = await readFile(absPath, "utf-8");
+                        const tree = await treeSitter.parse(absPath, content);
+                        if (tree) {
+                            const decl = getEnclosingDeclaration(tree, line - 1, character - 1);
+                            if (decl) {
+                                const sig = getSignatureText(decl);
+                                const kindLabel = decl.type.replace(/_/g, " ");
+                                let text = `${kindLabel} [tree-sitter]\n\n\`\`\`\n${sig}\n\`\`\``;
+                                if (resolvedFrom)
+                                    text = `${resolvedFrom}\n\n${text}`;
+                                return { content: [{ type: "text", text }], details: { hasResult: true } };
+                            }
+                            const text = resolvedFrom
+                                ? `${resolvedFrom}\n\nNo hover information available at this position. [tree-sitter]`
+                                : "No hover information available at this position. [tree-sitter]";
+                            return { content: [{ type: "text", text }], details: { hasResult: false } };
+                        }
+                    }
+                    catch { /* fall through */ }
+                }
+            }
+            return { content: [{ type: "text", text: manager.getUnavailableReason(filePath) }], details: { hasResult: false } };
+        },
+        renderCall(args, theme) {
+            let text = theme.fg("toolTitle", theme.bold("lsp_hover "));
+            if (args.query && !args.line) {
+                text += theme.fg("accent", `${args.path}`);
+                text += theme.fg("muted", ` query="${args.query}"`);
+            }
+            else {
+                text += theme.fg("accent", `${args.path}:${args.line}:${args.character}`);
+            }
+            return new Text(text, 0, 0);
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return new Text(theme.fg("warning", "Looking up..."), 0, 0);
+            if (!result.details?.hasResult)
+                return new Text(theme.fg("dim", "No info"), 0, 0);
+            const content = result.content[0];
+            if (content?.type === "text") {
+                const lines = content.text.split("\n").slice(0, 5);
+                return new Text(lines.map((l) => theme.fg("dim", l)).join("\n"), 0, 0);
+            }
+            return new Text(theme.fg("dim", "No info"), 0, 0);
+        },
+    };
+}
+//# sourceMappingURL=hover.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/tools/hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/hover.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * lsp_hover — Get type information and documentation at a position.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { Hover, MarkupContent } from \"vscode-languageserver-protocol\";\nimport type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport type { LspManager } from \"../lsp-manager.js\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { resolveProvider } from \"../resolve-provider.js\";\nimport { getEnclosingDeclaration, getSignatureText } from \"../tree-sitter/symbol-extractor.js\";\nimport { resolveSymbolPosition, getSymbolNames } from \"../shared/resolve-position.js\";\nimport { readFile } from \"node:fs/promises\";\n\nfunction formatHoverContent(hover: Hover): string {\n  const contents = hover.contents;\n  if (typeof contents === \"string\") return contents;\n  if (\"kind\" in contents && \"value\" in contents) return (contents as MarkupContent).value;\n  if (\"language\" in contents && \"value\" in contents) {\n    return `\\`\\`\\`${(contents as any).language}\\n${(contents as any).value}\\n\\`\\`\\``;\n  }\n  if (Array.isArray(contents)) {\n    return contents.map((c) => {\n      if (typeof c === \"string\") return c;\n      if (\"language\" in c && \"value\" in c) return `\\`\\`\\`${c.language}\\n${c.value}\\n\\`\\`\\``;\n      return String(c);\n    }).join(\"\\n\\n\");\n  }\n  return String(contents);\n}\n\nconst HoverParams = Type.Object({\n  path: Type.String({ description: \"File path\" }),\n  line: Type.Optional(Type.Number({ description: \"Line number (1-indexed). Required unless query is provided.\" })),\n  character: Type.Optional(Type.Number({ description: \"Column number (1-indexed). Required unless query is provided.\" })),\n  query: Type.Optional(Type.String({ description: \"Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically.\" })),\n});\n\ninterface HoverDetails { hasResult: boolean }\n\nexport function createHoverTool(\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof HoverParams, HoverDetails> {\n  return {\n    name: \"lsp_hover\",\n    label: \"LSP Hover\",\n    description: \"Get type information and documentation for a symbol at a specific position in a file. Line and character are 1-indexed.\",\n    promptSnippet: \"Get type info and docs for a symbol at a file position via LSP\",\n    parameters: HoverParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      let line = params.line;\n      let character = params.character;\n      let resolvedFrom: string | undefined;\n\n      // Resolve position from query if line/character not provided\n      if ((line === undefined || character === undefined) && params.query) {\n        const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);\n        if (resolved) {\n          line = resolved.line;\n          character = resolved.character;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          const names = await getSymbolNames(filePath, manager, treeSitter);\n          const hint = names.length > 0 ? `\\nAvailable symbols: ${names.slice(0, 20).join(\", \")}` : \"\";\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}${hint}` }], details: { hasResult: false } };\n        }\n      }\n\n      if (line === undefined || character === undefined) {\n        return { content: [{ type: \"text\", text: \"Either line/character or query is required.\" }], details: { hasResult: false } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n\n      if (client) {\n        // LSP path\n        const uri = manager.getFileUri(filePath);\n        const position = { line: line - 1, character: character - 1 };\n\n        try {\n          const hover = await client.sendRequest<Hover | null>(\"textDocument/hover\", {\n            textDocument: { uri }, position,\n          });\n          if (!hover) {\n            const text = resolvedFrom\n              ? `${resolvedFrom}\\n\\nNo hover information available at this position.`\n              : \"No hover information available at this position.\";\n            return { content: [{ type: \"text\", text }], details: { hasResult: false } };\n          }\n          const hoverText = formatHoverContent(hover);\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\n${hoverText}` : hoverText;\n          return { content: [{ type: \"text\", text }], details: { hasResult: true } };\n        } catch (err: any) {\n          return { content: [{ type: \"text\", text: `LSP hover request failed: ${err.message}` }], details: { hasResult: false } };\n        }\n      }\n\n      // Tree-sitter fallback\n      if (treeSitter) {\n        const provider = resolveProvider(filePath, manager, treeSitter);\n        if (provider.type === \"tree-sitter\") {\n          try {\n            const absPath = manager.resolvePath(filePath);\n            const content = await readFile(absPath, \"utf-8\");\n            const tree = await treeSitter.parse(absPath, content);\n            if (tree) {\n              const decl = getEnclosingDeclaration(tree, line - 1, character - 1);\n              if (decl) {\n                const sig = getSignatureText(decl);\n                const kindLabel = decl.type.replace(/_/g, \" \");\n                let text = `${kindLabel} [tree-sitter]\\n\\n\\`\\`\\`\\n${sig}\\n\\`\\`\\``;\n                if (resolvedFrom) text = `${resolvedFrom}\\n\\n${text}`;\n                return { content: [{ type: \"text\", text }], details: { hasResult: true } };\n              }\n              const text = resolvedFrom\n                ? `${resolvedFrom}\\n\\nNo hover information available at this position. [tree-sitter]`\n                : \"No hover information available at this position. [tree-sitter]\";\n              return { content: [{ type: \"text\", text }], details: { hasResult: false } };\n            }\n          } catch { /* fall through */ }\n        }\n      }\n\n      return { content: [{ type: \"text\", text: manager.getUnavailableReason(filePath) }], details: { hasResult: false } };\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_hover \"));\n      if (args.query && !args.line) {\n        text += theme.fg(\"accent\", `${args.path}`);\n        text += theme.fg(\"muted\", ` query=\"${args.query}\"`);\n      } else {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial) return new Text(theme.fg(\"warning\", \"Looking up...\"), 0, 0);\n      if (!result.details?.hasResult) return new Text(theme.fg(\"dim\", \"No info\"), 0, 0);\n      const content = result.content[0];\n      if (content?.type === \"text\") {\n        const lines = content.text.split(\"\\n\").slice(0, 5);\n        return new Text(lines.map((l) => theme.fg(\"dim\", l)).join(\"\\n\"), 0, 0);\n      }\n      return new Text(theme.fg(\"dim\", \"No info\"), 0, 0);\n    },\n  };\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/tools/references.d.ts

@@ -0,0 +1,20 @@
+/**
+ * lsp_references — Find all references to a symbol.
+ */
+import { Type } from "@sinclair/typebox";
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { LspManager } from "../lsp-manager.js";
+import type { TreeSitterManager } from "../tree-sitter/parser-manager.js";
+declare const ReferencesParams: Type.TObject<{
+    path: Type.TString;
+    line: Type.TOptional<Type.TNumber>;
+    character: Type.TOptional<Type.TNumber>;
+    query: Type.TOptional<Type.TString>;
+    includeDeclaration: Type.TOptional<Type.TBoolean>;
+}>;
+interface ReferencesDetails {
+    count: number;
+}
+export declare function createReferencesTool(manager: LspManager, treeSitter?: TreeSitterManager | null): ToolDefinition<typeof ReferencesParams, ReferencesDetails>;
+export {};
+//# sourceMappingURL=references.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/tools/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/references.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAI1E,QAAA,MAAM,gBAAgB;;;;;;EAQpB,CAAC;AAEH,UAAU,iBAAiB;IAAG,KAAK,EAAE,MAAM,CAAA;CAAE;AAE7C,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EACnB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC,cAAc,CAAC,OAAO,gBAAgB,EAAE,iBAAiB,CAAC,CAsF5D","sourcesContent":["// @ts-nocheck\n/**\n * lsp_references — Find all references to a symbol.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { Location } from \"vscode-languageserver-protocol\";\nimport type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from \"../../../../core/tools/truncate.js\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport type { LspManager } from \"../lsp-manager.js\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { formatLocation } from \"../shared/format.js\";\nimport { resolveSymbolPosition, getSymbolNames } from \"../shared/resolve-position.js\";\n\nconst ReferencesParams = Type.Object({\n  path: Type.String({ description: \"File path\" }),\n  line: Type.Optional(Type.Number({ description: \"Line number (1-indexed). Required unless query is provided.\" })),\n  character: Type.Optional(Type.Number({ description: \"Column number (1-indexed). Required unless query is provided.\" })),\n  query: Type.Optional(Type.String({ description: \"Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically.\" })),\n  includeDeclaration: Type.Optional(\n    Type.Boolean({ description: \"Include the declaration in results (default: true)\" })\n  ),\n});\n\ninterface ReferencesDetails { count: number }\n\nexport function createReferencesTool(\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof ReferencesParams, ReferencesDetails> {\n  return {\n    name: \"lsp_references\",\n    label: \"LSP References\",\n    description: \"Find all references to a symbol at a specific position. Returns a list of file locations. Line and character are 1-indexed.\",\n    promptSnippet: \"Find all references to a symbol at a file position via LSP\",\n    parameters: ReferencesParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      let line = params.line;\n      let character = params.character;\n      let resolvedFrom: string | undefined;\n\n      // Resolve position from query if line/character not provided\n      if ((line === undefined || character === undefined) && params.query) {\n        const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);\n        if (resolved) {\n          line = resolved.line;\n          character = resolved.character;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          const names = await getSymbolNames(filePath, manager, treeSitter);\n          const hint = names.length > 0 ? `\\nAvailable symbols: ${names.slice(0, 20).join(\", \")}` : \"\";\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}${hint}` }], details: { count: 0 } };\n        }\n      }\n\n      if (line === undefined || character === undefined) {\n        return { content: [{ type: \"text\", text: \"Either line/character or query is required.\" }], details: { count: 0 } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n      if (!client) {\n        return { content: [{ type: \"text\", text: manager.getUnavailableReason(filePath) }], details: { count: 0 } };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const position = { line: line - 1, character: character - 1 };\n\n      try {\n        const locations = await client.sendRequest<Location[] | null>(\"textDocument/references\", {\n          textDocument: { uri }, position,\n          context: { includeDeclaration: params.includeDeclaration ?? true },\n        });\n\n        if (!locations || locations.length === 0) {\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\nNo references found.` : \"No references found.\";\n          return { content: [{ type: \"text\", text }], details: { count: 0 } };\n        }\n\n        const rootDir = manager.resolvePath(\".\");\n        const formatted = locations.map((l) => formatLocation(l, rootDir));\n        const output = formatted.join(\"\\n\");\n\n        const truncation = truncateHead(output, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n        let resultText = `${locations.length} reference(s) found:\\n\\n${truncation.content}`;\n        if (truncation.truncated) {\n          resultText += `\\n\\n[Output truncated: showing ${truncation.outputLines} of ${truncation.totalLines} references]`;\n        }\n        if (resolvedFrom) resultText = `${resolvedFrom}\\n\\n${resultText}`;\n\n        return { content: [{ type: \"text\", text: resultText }], details: { count: locations.length } };\n      } catch (err: any) {\n        return { content: [{ type: \"text\", text: `LSP references request failed: ${err.message}` }], details: { count: 0 } };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_references \"));\n      if (args.query && !args.line) {\n        text += theme.fg(\"accent\", `${args.path}`);\n        text += theme.fg(\"muted\", ` query=\"${args.query}\"`);\n      } else {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial) return new Text(theme.fg(\"warning\", \"Searching...\"), 0, 0);\n      const details = result.details;\n      if (!details || details.count === 0) return new Text(theme.fg(\"dim\", \"No references found\"), 0, 0);\n      return new Text(theme.fg(\"success\", `${details.count} reference(s)`), 0, 0);\n    },\n  };\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/tools/references.js

@@ -0,0 +1,98 @@
+// @ts-nocheck
+/**
+ * lsp_references — Find all references to a symbol.
+ */
+import { Type } from "@sinclair/typebox";
+import { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from "../../../../core/tools/truncate.js";
+import { Text } from "@earendil-works/pi-tui";
+import { formatLocation } from "../shared/format.js";
+import { resolveSymbolPosition, getSymbolNames } from "../shared/resolve-position.js";
+const ReferencesParams = Type.Object({
+    path: Type.String({ description: "File path" }),
+    line: Type.Optional(Type.Number({ description: "Line number (1-indexed). Required unless query is provided." })),
+    character: Type.Optional(Type.Number({ description: "Column number (1-indexed). Required unless query is provided." })),
+    query: Type.Optional(Type.String({ description: "Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically." })),
+    includeDeclaration: Type.Optional(Type.Boolean({ description: "Include the declaration in results (default: true)" })),
+});
+export function createReferencesTool(manager, treeSitter) {
+    return {
+        name: "lsp_references",
+        label: "LSP References",
+        description: "Find all references to a symbol at a specific position. Returns a list of file locations. Line and character are 1-indexed.",
+        promptSnippet: "Find all references to a symbol at a file position via LSP",
+        parameters: ReferencesParams,
+        async execute(_toolCallId, params) {
+            const filePath = params.path.replace(/^@/, "");
+            let line = params.line;
+            let character = params.character;
+            let resolvedFrom;
+            // Resolve position from query if line/character not provided
+            if ((line === undefined || character === undefined) && params.query) {
+                const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);
+                if (resolved) {
+                    line = resolved.line;
+                    character = resolved.character;
+                    resolvedFrom = `Resolved "${params.query}" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;
+                }
+                else {
+                    const names = await getSymbolNames(filePath, manager, treeSitter);
+                    const hint = names.length > 0 ? `\nAvailable symbols: ${names.slice(0, 20).join(", ")}` : "";
+                    return { content: [{ type: "text", text: `Could not find symbol "${params.query}" in ${filePath}${hint}` }], details: { count: 0 } };
+                }
+            }
+            if (line === undefined || character === undefined) {
+                return { content: [{ type: "text", text: "Either line/character or query is required." }], details: { count: 0 } };
+            }
+            const client = await manager.getClientForFile(filePath).catch(() => null);
+            if (!client) {
+                return { content: [{ type: "text", text: manager.getUnavailableReason(filePath) }], details: { count: 0 } };
+            }
+            const uri = manager.getFileUri(filePath);
+            const position = { line: line - 1, character: character - 1 };
+            try {
+                const locations = await client.sendRequest("textDocument/references", {
+                    textDocument: { uri }, position,
+                    context: { includeDeclaration: params.includeDeclaration ?? true },
+                });
+                if (!locations || locations.length === 0) {
+                    const text = resolvedFrom ? `${resolvedFrom}\n\nNo references found.` : "No references found.";
+                    return { content: [{ type: "text", text }], details: { count: 0 } };
+                }
+                const rootDir = manager.resolvePath(".");
+                const formatted = locations.map((l) => formatLocation(l, rootDir));
+                const output = formatted.join("\n");
+                const truncation = truncateHead(output, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
+                let resultText = `${locations.length} reference(s) found:\n\n${truncation.content}`;
+                if (truncation.truncated) {
+                    resultText += `\n\n[Output truncated: showing ${truncation.outputLines} of ${truncation.totalLines} references]`;
+                }
+                if (resolvedFrom)
+                    resultText = `${resolvedFrom}\n\n${resultText}`;
+                return { content: [{ type: "text", text: resultText }], details: { count: locations.length } };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `LSP references request failed: ${err.message}` }], details: { count: 0 } };
+            }
+        },
+        renderCall(args, theme) {
+            let text = theme.fg("toolTitle", theme.bold("lsp_references "));
+            if (args.query && !args.line) {
+                text += theme.fg("accent", `${args.path}`);
+                text += theme.fg("muted", ` query="${args.query}"`);
+            }
+            else {
+                text += theme.fg("accent", `${args.path}:${args.line}:${args.character}`);
+            }
+            return new Text(text, 0, 0);
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return new Text(theme.fg("warning", "Searching..."), 0, 0);
+            const details = result.details;
+            if (!details || details.count === 0)
+                return new Text(theme.fg("dim", "No references found"), 0, 0);
+            return new Text(theme.fg("success", `${details.count} reference(s)`), 0, 0);
+        },
+    };
+}
+//# sourceMappingURL=references.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/tools/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/references.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * lsp_references — Find all references to a symbol.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { Location } from \"vscode-languageserver-protocol\";\nimport type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from \"../../../../core/tools/truncate.js\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport type { LspManager } from \"../lsp-manager.js\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { formatLocation } from \"../shared/format.js\";\nimport { resolveSymbolPosition, getSymbolNames } from \"../shared/resolve-position.js\";\n\nconst ReferencesParams = Type.Object({\n  path: Type.String({ description: \"File path\" }),\n  line: Type.Optional(Type.Number({ description: \"Line number (1-indexed). Required unless query is provided.\" })),\n  character: Type.Optional(Type.Number({ description: \"Column number (1-indexed). Required unless query is provided.\" })),\n  query: Type.Optional(Type.String({ description: \"Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically.\" })),\n  includeDeclaration: Type.Optional(\n    Type.Boolean({ description: \"Include the declaration in results (default: true)\" })\n  ),\n});\n\ninterface ReferencesDetails { count: number }\n\nexport function createReferencesTool(\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof ReferencesParams, ReferencesDetails> {\n  return {\n    name: \"lsp_references\",\n    label: \"LSP References\",\n    description: \"Find all references to a symbol at a specific position. Returns a list of file locations. Line and character are 1-indexed.\",\n    promptSnippet: \"Find all references to a symbol at a file position via LSP\",\n    parameters: ReferencesParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      let line = params.line;\n      let character = params.character;\n      let resolvedFrom: string | undefined;\n\n      // Resolve position from query if line/character not provided\n      if ((line === undefined || character === undefined) && params.query) {\n        const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);\n        if (resolved) {\n          line = resolved.line;\n          character = resolved.character;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          const names = await getSymbolNames(filePath, manager, treeSitter);\n          const hint = names.length > 0 ? `\\nAvailable symbols: ${names.slice(0, 20).join(\", \")}` : \"\";\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}${hint}` }], details: { count: 0 } };\n        }\n      }\n\n      if (line === undefined || character === undefined) {\n        return { content: [{ type: \"text\", text: \"Either line/character or query is required.\" }], details: { count: 0 } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n      if (!client) {\n        return { content: [{ type: \"text\", text: manager.getUnavailableReason(filePath) }], details: { count: 0 } };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const position = { line: line - 1, character: character - 1 };\n\n      try {\n        const locations = await client.sendRequest<Location[] | null>(\"textDocument/references\", {\n          textDocument: { uri }, position,\n          context: { includeDeclaration: params.includeDeclaration ?? true },\n        });\n\n        if (!locations || locations.length === 0) {\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\nNo references found.` : \"No references found.\";\n          return { content: [{ type: \"text\", text }], details: { count: 0 } };\n        }\n\n        const rootDir = manager.resolvePath(\".\");\n        const formatted = locations.map((l) => formatLocation(l, rootDir));\n        const output = formatted.join(\"\\n\");\n\n        const truncation = truncateHead(output, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n        let resultText = `${locations.length} reference(s) found:\\n\\n${truncation.content}`;\n        if (truncation.truncated) {\n          resultText += `\\n\\n[Output truncated: showing ${truncation.outputLines} of ${truncation.totalLines} references]`;\n        }\n        if (resolvedFrom) resultText = `${resolvedFrom}\\n\\n${resultText}`;\n\n        return { content: [{ type: \"text\", text: resultText }], details: { count: locations.length } };\n      } catch (err: any) {\n        return { content: [{ type: \"text\", text: `LSP references request failed: ${err.message}` }], details: { count: 0 } };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_references \"));\n      if (args.query && !args.line) {\n        text += theme.fg(\"accent\", `${args.path}`);\n        text += theme.fg(\"muted\", ` query=\"${args.query}\"`);\n      } else {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial) return new Text(theme.fg(\"warning\", \"Searching...\"), 0, 0);\n      const details = result.details;\n      if (!details || details.count === 0) return new Text(theme.fg(\"dim\", \"No references found\"), 0, 0);\n      return new Text(theme.fg(\"success\", `${details.count} reference(s)`), 0, 0);\n    },\n  };\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/tools/rename.d.ts

@@ -0,0 +1,22 @@
+/**
+ * lsp_rename — Preview a rename refactoring across the workspace.
+ * Returns planned edits but does NOT apply them.
+ */
+import { Type } from "@sinclair/typebox";
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { LspManager } from "../lsp-manager.js";
+import type { TreeSitterManager } from "../tree-sitter/parser-manager.js";
+declare const RenameParams: Type.TObject<{
+    path: Type.TString;
+    line: Type.TOptional<Type.TNumber>;
+    character: Type.TOptional<Type.TNumber>;
+    query: Type.TOptional<Type.TString>;
+    newName: Type.TString;
+}>;
+interface RenameDetails {
+    fileCount: number;
+    editCount: number;
+}
+export declare function createRenameTool(manager: LspManager, treeSitter?: TreeSitterManager | null): ToolDefinition<typeof RenameParams, RenameDetails>;
+export {};
+//# sourceMappingURL=rename.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/tools/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/rename.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA4C1E,QAAA,MAAM,YAAY;;;;;;EAMhB,CAAC;AAEH,UAAU,aAAa;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAEhE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,EACnB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC,cAAc,CAAC,OAAO,YAAY,EAAE,aAAa,CAAC,CA2FpD","sourcesContent":["// @ts-nocheck\n/**\n * lsp_rename — Preview a rename refactoring across the workspace.\n * Returns planned edits but does NOT apply them.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { WorkspaceEdit, TextEdit } from \"vscode-languageserver-protocol\";\nimport type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from \"../../../../core/tools/truncate.js\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport type { LspManager } from \"../lsp-manager.js\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { resolveSymbolPosition, getSymbolNames } from \"../shared/resolve-position.js\";\nimport { fileURLToPath } from \"node:url\";\nimport { relative } from \"node:path\";\n\nfunction formatWorkspaceEdit(edit: WorkspaceEdit, rootDir: string): { summary: string; fileCount: number; editCount: number } {\n  const lines: string[] = [];\n  let totalEdits = 0;\n  let fileCount = 0;\n\n  if (edit.documentChanges) {\n    for (const change of edit.documentChanges) {\n      if (\"textDocument\" in change && \"edits\" in change) {\n        fileCount++;\n        let relPath: string;\n        try { relPath = relative(rootDir, fileURLToPath(change.textDocument.uri)); } catch { relPath = change.textDocument.uri; }\n        lines.push(`${relPath}:`);\n        for (const textEdit of change.edits as TextEdit[]) {\n          const line = textEdit.range.start.line + 1;\n          const col = textEdit.range.start.character + 1;\n          lines.push(`  ${line}:${col} → \"${textEdit.newText}\"`);\n          totalEdits++;\n        }\n      }\n    }\n  }\n\n  const changes = edit.changes ?? {};\n  for (const [uri, edits] of Object.entries(changes)) {\n    fileCount++;\n    let relPath: string;\n    try { relPath = relative(rootDir, fileURLToPath(uri)); } catch { relPath = uri; }\n    lines.push(`${relPath}:`);\n    for (const textEdit of edits) {\n      const line = textEdit.range.start.line + 1;\n      const col = textEdit.range.start.character + 1;\n      lines.push(`  ${line}:${col} → \"${textEdit.newText}\"`);\n      totalEdits++;\n    }\n  }\n\n  return { summary: lines.join(\"\\n\"), fileCount, editCount: totalEdits };\n}\n\nconst RenameParams = Type.Object({\n  path: Type.String({ description: \"File path\" }),\n  line: Type.Optional(Type.Number({ description: \"Line number (1-indexed). Required unless query is provided.\" })),\n  character: Type.Optional(Type.Number({ description: \"Column number (1-indexed). Required unless query is provided.\" })),\n  query: Type.Optional(Type.String({ description: \"Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically.\" })),\n  newName: Type.String({ description: \"New name for the symbol\" }),\n});\n\ninterface RenameDetails { fileCount: number; editCount: number }\n\nexport function createRenameTool(\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof RenameParams, RenameDetails> {\n  return {\n    name: \"lsp_rename\",\n    label: \"LSP Rename\",\n    description: \"Preview a rename refactoring for a symbol at a position. Returns the list of changes that would be made across all files. Does NOT apply the changes — use edit/write tools to apply them. Line and character are 1-indexed.\",\n    promptSnippet: \"Preview rename refactoring for a symbol (returns planned edits, does not apply them)\",\n    parameters: RenameParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      let line = params.line;\n      let character = params.character;\n      let resolvedFrom: string | undefined;\n\n      // Resolve position from query if line/character not provided\n      if ((line === undefined || character === undefined) && params.query) {\n        const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);\n        if (resolved) {\n          line = resolved.line;\n          character = resolved.character;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          const names = await getSymbolNames(filePath, manager, treeSitter);\n          const hint = names.length > 0 ? `\\nAvailable symbols: ${names.slice(0, 20).join(\", \")}` : \"\";\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}${hint}` }], details: { fileCount: 0, editCount: 0 } };\n        }\n      }\n\n      if (line === undefined || character === undefined) {\n        return { content: [{ type: \"text\", text: \"Either line/character or query is required.\" }], details: { fileCount: 0, editCount: 0 } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n      if (!client) {\n        return { content: [{ type: \"text\", text: manager.getUnavailableReason(filePath) }], details: { fileCount: 0, editCount: 0 } };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const position = { line: line - 1, character: character - 1 };\n\n      try {\n        const result = await client.sendRequest<WorkspaceEdit | null>(\"textDocument/rename\", {\n          textDocument: { uri }, position, newName: params.newName,\n        });\n\n        if (!result) {\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\nRename not possible at this position.` : \"Rename not possible at this position.\";\n          return { content: [{ type: \"text\", text }], details: { fileCount: 0, editCount: 0 } };\n        }\n\n        const rootDir = manager.resolvePath(\".\");\n        const { summary, fileCount, editCount } = formatWorkspaceEdit(result, rootDir);\n\n        if (editCount === 0) {\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\nNo edits needed for this rename.` : \"No edits needed for this rename.\";\n          return { content: [{ type: \"text\", text }], details: { fileCount: 0, editCount: 0 } };\n        }\n\n        const truncation = truncateHead(summary, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n        let text = \"\";\n        if (resolvedFrom) text += `${resolvedFrom}\\n\\n`;\n        text += `Rename \"${params.newName}\": ${editCount} edit(s) across ${fileCount} file(s)\\n\\n`;\n        text += \"NOTE: These changes are NOT applied. Use edit/write tools to make the changes.\\n\\n\";\n        text += truncation.content;\n        if (truncation.truncated) text += `\\n\\n[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines]`;\n\n        return { content: [{ type: \"text\", text }], details: { fileCount, editCount } };\n      } catch (err: any) {\n        return { content: [{ type: \"text\", text: `LSP rename request failed: ${err.message}` }], details: { fileCount: 0, editCount: 0 } };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_rename \"));\n      if (args.query && !args.line) {\n        text += theme.fg(\"accent\", `${args.path}`);\n        text += theme.fg(\"muted\", ` query=\"${args.query}\" → ${args.newName}`);\n      } else {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}`);\n        text += theme.fg(\"muted\", ` → ${args.newName}`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial) return new Text(theme.fg(\"warning\", \"Computing...\"), 0, 0);\n      const details = result.details;\n      if (!details || details.editCount === 0) return new Text(theme.fg(\"dim\", \"No edits\"), 0, 0);\n      return new Text(theme.fg(\"success\", `${details.editCount} edit(s) in ${details.fileCount} file(s) (preview only)`), 0, 0);\n    },\n  };\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/tools/rename.js

@@ -0,0 +1,150 @@
+// @ts-nocheck
+/**
+ * lsp_rename — Preview a rename refactoring across the workspace.
+ * Returns planned edits but does NOT apply them.
+ */
+import { Type } from "@sinclair/typebox";
+import { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from "../../../../core/tools/truncate.js";
+import { Text } from "@earendil-works/pi-tui";
+import { resolveSymbolPosition, getSymbolNames } from "../shared/resolve-position.js";
+import { fileURLToPath } from "node:url";
+import { relative } from "node:path";
+function formatWorkspaceEdit(edit, rootDir) {
+    const lines = [];
+    let totalEdits = 0;
+    let fileCount = 0;
+    if (edit.documentChanges) {
+        for (const change of edit.documentChanges) {
+            if ("textDocument" in change && "edits" in change) {
+                fileCount++;
+                let relPath;
+                try {
+                    relPath = relative(rootDir, fileURLToPath(change.textDocument.uri));
+                }
+                catch {
+                    relPath = change.textDocument.uri;
+                }
+                lines.push(`${relPath}:`);
+                for (const textEdit of change.edits) {
+                    const line = textEdit.range.start.line + 1;
+                    const col = textEdit.range.start.character + 1;
+                    lines.push(`  ${line}:${col} → "${textEdit.newText}"`);
+                    totalEdits++;
+                }
+            }
+        }
+    }
+    const changes = edit.changes ?? {};
+    for (const [uri, edits] of Object.entries(changes)) {
+        fileCount++;
+        let relPath;
+        try {
+            relPath = relative(rootDir, fileURLToPath(uri));
+        }
+        catch {
+            relPath = uri;
+        }
+        lines.push(`${relPath}:`);
+        for (const textEdit of edits) {
+            const line = textEdit.range.start.line + 1;
+            const col = textEdit.range.start.character + 1;
+            lines.push(`  ${line}:${col} → "${textEdit.newText}"`);
+            totalEdits++;
+        }
+    }
+    return { summary: lines.join("\n"), fileCount, editCount: totalEdits };
+}
+const RenameParams = Type.Object({
+    path: Type.String({ description: "File path" }),
+    line: Type.Optional(Type.Number({ description: "Line number (1-indexed). Required unless query is provided." })),
+    character: Type.Optional(Type.Number({ description: "Column number (1-indexed). Required unless query is provided." })),
+    query: Type.Optional(Type.String({ description: "Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically." })),
+    newName: Type.String({ description: "New name for the symbol" }),
+});
+export function createRenameTool(manager, treeSitter) {
+    return {
+        name: "lsp_rename",
+        label: "LSP Rename",
+        description: "Preview a rename refactoring for a symbol at a position. Returns the list of changes that would be made across all files. Does NOT apply the changes — use edit/write tools to apply them. Line and character are 1-indexed.",
+        promptSnippet: "Preview rename refactoring for a symbol (returns planned edits, does not apply them)",
+        parameters: RenameParams,
+        async execute(_toolCallId, params) {
+            const filePath = params.path.replace(/^@/, "");
+            let line = params.line;
+            let character = params.character;
+            let resolvedFrom;
+            // Resolve position from query if line/character not provided
+            if ((line === undefined || character === undefined) && params.query) {
+                const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);
+                if (resolved) {
+                    line = resolved.line;
+                    character = resolved.character;
+                    resolvedFrom = `Resolved "${params.query}" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;
+                }
+                else {
+                    const names = await getSymbolNames(filePath, manager, treeSitter);
+                    const hint = names.length > 0 ? `\nAvailable symbols: ${names.slice(0, 20).join(", ")}` : "";
+                    return { content: [{ type: "text", text: `Could not find symbol "${params.query}" in ${filePath}${hint}` }], details: { fileCount: 0, editCount: 0 } };
+                }
+            }
+            if (line === undefined || character === undefined) {
+                return { content: [{ type: "text", text: "Either line/character or query is required." }], details: { fileCount: 0, editCount: 0 } };
+            }
+            const client = await manager.getClientForFile(filePath).catch(() => null);
+            if (!client) {
+                return { content: [{ type: "text", text: manager.getUnavailableReason(filePath) }], details: { fileCount: 0, editCount: 0 } };
+            }
+            const uri = manager.getFileUri(filePath);
+            const position = { line: line - 1, character: character - 1 };
+            try {
+                const result = await client.sendRequest("textDocument/rename", {
+                    textDocument: { uri }, position, newName: params.newName,
+                });
+                if (!result) {
+                    const text = resolvedFrom ? `${resolvedFrom}\n\nRename not possible at this position.` : "Rename not possible at this position.";
+                    return { content: [{ type: "text", text }], details: { fileCount: 0, editCount: 0 } };
+                }
+                const rootDir = manager.resolvePath(".");
+                const { summary, fileCount, editCount } = formatWorkspaceEdit(result, rootDir);
+                if (editCount === 0) {
+                    const text = resolvedFrom ? `${resolvedFrom}\n\nNo edits needed for this rename.` : "No edits needed for this rename.";
+                    return { content: [{ type: "text", text }], details: { fileCount: 0, editCount: 0 } };
+                }
+                const truncation = truncateHead(summary, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
+                let text = "";
+                if (resolvedFrom)
+                    text += `${resolvedFrom}\n\n`;
+                text += `Rename "${params.newName}": ${editCount} edit(s) across ${fileCount} file(s)\n\n`;
+                text += "NOTE: These changes are NOT applied. Use edit/write tools to make the changes.\n\n";
+                text += truncation.content;
+                if (truncation.truncated)
+                    text += `\n\n[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines]`;
+                return { content: [{ type: "text", text }], details: { fileCount, editCount } };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `LSP rename request failed: ${err.message}` }], details: { fileCount: 0, editCount: 0 } };
+            }
+        },
+        renderCall(args, theme) {
+            let text = theme.fg("toolTitle", theme.bold("lsp_rename "));
+            if (args.query && !args.line) {
+                text += theme.fg("accent", `${args.path}`);
+                text += theme.fg("muted", ` query="${args.query}" → ${args.newName}`);
+            }
+            else {
+                text += theme.fg("accent", `${args.path}:${args.line}:${args.character}`);
+                text += theme.fg("muted", ` → ${args.newName}`);
+            }
+            return new Text(text, 0, 0);
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return new Text(theme.fg("warning", "Computing..."), 0, 0);
+            const details = result.details;
+            if (!details || details.editCount === 0)
+                return new Text(theme.fg("dim", "No edits"), 0, 0);
+            return new Text(theme.fg("success", `${details.editCount} edit(s) in ${details.fileCount} file(s) (preview only)`), 0, 0);
+        },
+    };
+}
+//# sourceMappingURL=rename.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/tools/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/rename.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACxG,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAG9C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,SAAS,mBAAmB,CAAC,IAAmB,EAAE,OAAe,EAA6D;IAC5H,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,IAAI,cAAc,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBAClD,SAAS,EAAE,CAAC;gBACZ,IAAI,OAAe,CAAC;gBACpB,IAAI,CAAC;oBAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC;gBAAC,CAAC;gBACzH,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;gBAC1B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAmB,EAAE,CAAC;oBAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;oBAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,SAAO,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;oBACvD,UAAU,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,SAAS,EAAE,CAAC;QACZ,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,GAAG,GAAG,CAAC;QAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,SAAO,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;YACvD,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAAA,CACxE;AAED,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IAC/C,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC,CAAC;IAChH,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC,CAAC;IACvH,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kHAAgH,EAAE,CAAC,CAAC;IACpK,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;CACjE,CAAC,CAAC;AAIH,MAAM,UAAU,gBAAgB,CAC9B,OAAmB,EACnB,UAAqC,EACe;IACpD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,gOAA8N;QAC3O,aAAa,EAAE,sFAAsF;QACrG,UAAU,EAAE,YAAY;QAExB,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE;YACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YACjC,IAAI,YAAgC,CAAC;YAErC,6DAA6D;YAC7D,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACpE,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;gBAC1F,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;oBACrB,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;oBAC/B,YAAY,GAAG,aAAa,MAAM,CAAC,KAAK,SAAO,QAAQ,CAAC,UAAU,OAAO,IAAI,IAAI,SAAS,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACpH,CAAC;qBAAM,CAAC;oBACN,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;oBAClE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,MAAM,CAAC,KAAK,QAAQ,QAAQ,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzJ,CAAC;YACH,CAAC;YAED,IAAI,IAAI,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6CAA6C,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACvI,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YAChI,CAAC;YAED,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,CAAC,EAAE,CAAC;YAE9D,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAuB,qBAAqB,EAAE;oBACnF,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO;iBACzD,CAAC,CAAC;gBAEH,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,2CAA2C,CAAC,CAAC,CAAC,uCAAuC,CAAC;oBACjI,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxF,CAAC;gBAED,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACzC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/E,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBACpB,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,sCAAsC,CAAC,CAAC,CAAC,kCAAkC,CAAC;oBACvH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxF,CAAC;gBAED,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBACvG,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,IAAI,YAAY;oBAAE,IAAI,IAAI,GAAG,YAAY,MAAM,CAAC;gBAChD,IAAI,IAAI,WAAW,MAAM,CAAC,OAAO,MAAM,SAAS,mBAAmB,SAAS,cAAc,CAAC;gBAC3F,IAAI,IAAI,oFAAoF,CAAC;gBAC7F,IAAI,IAAI,UAAU,CAAC,OAAO,CAAC;gBAC3B,IAAI,UAAU,CAAC,SAAS;oBAAE,IAAI,IAAI,2BAA2B,UAAU,CAAC,WAAW,OAAO,UAAU,CAAC,UAAU,SAAS,CAAC;gBAEzH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC;YAClF,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACrI,CAAC;QAAA,CACF;QAED,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;YACtB,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,IAAI,CAAC,KAAK,SAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;iBAAM,CAAC;gBACN,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC1E,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAAA,CAC7B;QAED,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE;YACzC,IAAI,SAAS;gBAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,CAAC;gBAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5F,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,eAAe,OAAO,CAAC,SAAS,yBAAyB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAAA,CAC3H;KACF,CAAC;AAAA,CACH","sourcesContent":["// @ts-nocheck\n/**\n * lsp_rename — Preview a rename refactoring across the workspace.\n * Returns planned edits but does NOT apply them.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { WorkspaceEdit, TextEdit } from \"vscode-languageserver-protocol\";\nimport type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from \"../../../../core/tools/truncate.js\";\nimport { Text } from \"@earendil-works/pi-tui\";\nimport type { LspManager } from \"../lsp-manager.js\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { resolveSymbolPosition, getSymbolNames } from \"../shared/resolve-position.js\";\nimport { fileURLToPath } from \"node:url\";\nimport { relative } from \"node:path\";\n\nfunction formatWorkspaceEdit(edit: WorkspaceEdit, rootDir: string): { summary: string; fileCount: number; editCount: number } {\n  const lines: string[] = [];\n  let totalEdits = 0;\n  let fileCount = 0;\n\n  if (edit.documentChanges) {\n    for (const change of edit.documentChanges) {\n      if (\"textDocument\" in change && \"edits\" in change) {\n        fileCount++;\n        let relPath: string;\n        try { relPath = relative(rootDir, fileURLToPath(change.textDocument.uri)); } catch { relPath = change.textDocument.uri; }\n        lines.push(`${relPath}:`);\n        for (const textEdit of change.edits as TextEdit[]) {\n          const line = textEdit.range.start.line + 1;\n          const col = textEdit.range.start.character + 1;\n          lines.push(`  ${line}:${col} → \"${textEdit.newText}\"`);\n          totalEdits++;\n        }\n      }\n    }\n  }\n\n  const changes = edit.changes ?? {};\n  for (const [uri, edits] of Object.entries(changes)) {\n    fileCount++;\n    let relPath: string;\n    try { relPath = relative(rootDir, fileURLToPath(uri)); } catch { relPath = uri; }\n    lines.push(`${relPath}:`);\n    for (const textEdit of edits) {\n      const line = textEdit.range.start.line + 1;\n      const col = textEdit.range.start.character + 1;\n      lines.push(`  ${line}:${col} → \"${textEdit.newText}\"`);\n      totalEdits++;\n    }\n  }\n\n  return { summary: lines.join(\"\\n\"), fileCount, editCount: totalEdits };\n}\n\nconst RenameParams = Type.Object({\n  path: Type.String({ description: \"File path\" }),\n  line: Type.Optional(Type.Number({ description: \"Line number (1-indexed). Required unless query is provided.\" })),\n  character: Type.Optional(Type.Number({ description: \"Column number (1-indexed). Required unless query is provided.\" })),\n  query: Type.Optional(Type.String({ description: \"Symbol name to find in the file. Alternative to line/character — resolves the symbol's position automatically.\" })),\n  newName: Type.String({ description: \"New name for the symbol\" }),\n});\n\ninterface RenameDetails { fileCount: number; editCount: number }\n\nexport function createRenameTool(\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof RenameParams, RenameDetails> {\n  return {\n    name: \"lsp_rename\",\n    label: \"LSP Rename\",\n    description: \"Preview a rename refactoring for a symbol at a position. Returns the list of changes that would be made across all files. Does NOT apply the changes — use edit/write tools to apply them. Line and character are 1-indexed.\",\n    promptSnippet: \"Preview rename refactoring for a symbol (returns planned edits, does not apply them)\",\n    parameters: RenameParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      let line = params.line;\n      let character = params.character;\n      let resolvedFrom: string | undefined;\n\n      // Resolve position from query if line/character not provided\n      if ((line === undefined || character === undefined) && params.query) {\n        const resolved = await resolveSymbolPosition(filePath, params.query, manager, treeSitter);\n        if (resolved) {\n          line = resolved.line;\n          character = resolved.character;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          const names = await getSymbolNames(filePath, manager, treeSitter);\n          const hint = names.length > 0 ? `\\nAvailable symbols: ${names.slice(0, 20).join(\", \")}` : \"\";\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}${hint}` }], details: { fileCount: 0, editCount: 0 } };\n        }\n      }\n\n      if (line === undefined || character === undefined) {\n        return { content: [{ type: \"text\", text: \"Either line/character or query is required.\" }], details: { fileCount: 0, editCount: 0 } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n      if (!client) {\n        return { content: [{ type: \"text\", text: manager.getUnavailableReason(filePath) }], details: { fileCount: 0, editCount: 0 } };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const position = { line: line - 1, character: character - 1 };\n\n      try {\n        const result = await client.sendRequest<WorkspaceEdit | null>(\"textDocument/rename\", {\n          textDocument: { uri }, position, newName: params.newName,\n        });\n\n        if (!result) {\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\nRename not possible at this position.` : \"Rename not possible at this position.\";\n          return { content: [{ type: \"text\", text }], details: { fileCount: 0, editCount: 0 } };\n        }\n\n        const rootDir = manager.resolvePath(\".\");\n        const { summary, fileCount, editCount } = formatWorkspaceEdit(result, rootDir);\n\n        if (editCount === 0) {\n          const text = resolvedFrom ? `${resolvedFrom}\\n\\nNo edits needed for this rename.` : \"No edits needed for this rename.\";\n          return { content: [{ type: \"text\", text }], details: { fileCount: 0, editCount: 0 } };\n        }\n\n        const truncation = truncateHead(summary, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n        let text = \"\";\n        if (resolvedFrom) text += `${resolvedFrom}\\n\\n`;\n        text += `Rename \"${params.newName}\": ${editCount} edit(s) across ${fileCount} file(s)\\n\\n`;\n        text += \"NOTE: These changes are NOT applied. Use edit/write tools to make the changes.\\n\\n\";\n        text += truncation.content;\n        if (truncation.truncated) text += `\\n\\n[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines]`;\n\n        return { content: [{ type: \"text\", text }], details: { fileCount, editCount } };\n      } catch (err: any) {\n        return { content: [{ type: \"text\", text: `LSP rename request failed: ${err.message}` }], details: { fileCount: 0, editCount: 0 } };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_rename \"));\n      if (args.query && !args.line) {\n        text += theme.fg(\"accent\", `${args.path}`);\n        text += theme.fg(\"muted\", ` query=\"${args.query}\" → ${args.newName}`);\n      } else {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}`);\n        text += theme.fg(\"muted\", ` → ${args.newName}`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial) return new Text(theme.fg(\"warning\", \"Computing...\"), 0, 0);\n      const details = result.details;\n      if (!details || details.editCount === 0) return new Text(theme.fg(\"dim\", \"No edits\"), 0, 0);\n      return new Text(theme.fg(\"success\", `${details.editCount} edit(s) in ${details.fileCount} file(s) (preview only)`), 0, 0);\n    },\n  };\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/tools/symbols.d.ts

@@ -0,0 +1,18 @@
+/**
+ * lsp_symbols — List symbols in a file or search workspace symbols.
+ */
+import { Type } from "@sinclair/typebox";
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { LspManager } from "../lsp-manager.js";
+import type { TreeSitterManager } from "../tree-sitter/parser-manager.js";
+import type { WorkspaceIndex } from "../tree-sitter/workspace-index.js";
+declare const SymbolsParams: Type.TObject<{
+    path: Type.TOptional<Type.TString>;
+    query: Type.TOptional<Type.TString>;
+}>;
+interface SymbolsDetails {
+    count: number;
+}
+export declare function createSymbolsTool(manager: LspManager, treeSitter?: TreeSitterManager | null, workspaceIndex?: WorkspaceIndex | null): ToolDefinition<typeof SymbolsParams, SymbolsDetails>;
+export {};
+//# sourceMappingURL=symbols.d.ts.map