@ashx-j/lunr 0.1.0

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

@@ -0,0 +1,87 @@
+// @ts-nocheck
+/**
+ * ast_search — Find code matching a structural pattern with metavariables.
+ *
+ * Uses tree-sitter AST matching to find code by structure, not text.
+ * Supports `$NAME` for single-node wildcards and `$$$NAME` for variadic.
+ */
+import { Type } from "@sinclair/typebox";
+import { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from "../../../../core/tools/truncate.js";
+import { relative } from "node:path";
+import { compilePattern } from "../tree-sitter/pattern-compiler.js";
+import { searchFiles } from "../tree-sitter/search-engine.js";
+const SearchParams = Type.Object({
+    pattern: Type.String({ description: "Structural pattern with metavariables ($NAME for single node, $$$NAME for variadic)" }),
+    language: Type.String({ description: "Target language (typescript, python, rust, java, etc.)" }),
+    path: Type.Optional(Type.String({ description: "File or directory to search (default: workspace root)" })),
+    max_results: Type.Optional(Type.Number({ description: "Maximum results to return (default: 50)" })),
+});
+export function createCodeSearchTool(rootDirOrGetter, treeSitter) {
+    const getRootDir = typeof rootDirOrGetter === "function" ? rootDirOrGetter : () => rootDirOrGetter;
+    return {
+        name: "ast_search",
+        label: "Code Search",
+        description: "Find code matching a structural pattern using AST matching. " +
+            "Use $NAME to match any single node, $$$NAME to match zero-or-more nodes. " +
+            "More precise than grep — matches code structure, not text.",
+        parameters: SearchParams,
+        async execute(_toolCallId, params) {
+            const rootDir = getRootDir();
+            const { pattern: patternStr, language, path, max_results } = params;
+            // Compile the pattern
+            let compiled;
+            try {
+                compiled = await compilePattern(patternStr, language, treeSitter);
+            }
+            catch (e) {
+                return {
+                    content: [{ type: "text", text: `Error: ${e.message}` }],
+                    details: { matchCount: 0, filesSearched: 0 },
+                };
+            }
+            // Run the search
+            const matches = await searchFiles(compiled, rootDir, treeSitter, {
+                path,
+                maxResults: max_results ?? 50,
+            });
+            if (matches.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No matches found." }],
+                    details: { matchCount: 0, filesSearched: 0 },
+                };
+            }
+            // Format results
+            const lines = [];
+            lines.push(`Found ${matches.length} match${matches.length !== 1 ? "es" : ""}:\n`);
+            for (const m of matches) {
+                const relPath = relative(rootDir, m.file);
+                const matchText = m.matchedText.length > 200
+                    ? m.matchedText.slice(0, 200) + "..."
+                    : m.matchedText;
+                lines.push(`${relPath}:${m.line}:${m.column}`);
+                lines.push(`  ${matchText.replace(/\n/g, "\n  ")}`);
+                // Show captures
+                const captureEntries = Object.entries(m.captures);
+                if (captureEntries.length > 0) {
+                    for (const [name, value] of captureEntries) {
+                        const displayValue = value.length > 100 ? value.slice(0, 100) + "..." : value;
+                        lines.push(`  $${name} = ${displayValue}`);
+                    }
+                }
+                lines.push("");
+            }
+            const text = lines.join("\n");
+            const uniqueFiles = new Set(matches.map((m) => m.file));
+            const truncation = truncateHead(text, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
+            let output = truncation.content;
+            if (truncation.truncated) {
+                output += `\n\n[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines]`;
+            }
+            return {
+                content: [{ type: "text", text: output }],
+                details: { matchCount: matches.length, filesSearched: uniqueFiles.size },
+            };
+        },
+    };
+}
+//# sourceMappingURL=code-search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-search.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/code-search.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * ast_search — Find code matching a structural pattern with metavariables.\n *\n * Uses tree-sitter AST matching to find code by structure, not text.\n * Supports `$NAME` for single-node wildcards and `$$$NAME` for variadic.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport { truncateHead, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES } from \"../../../../core/tools/truncate.js\";\nimport { relative } from \"node:path\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { compilePattern } from \"../tree-sitter/pattern-compiler.js\";\nimport { searchFiles } from \"../tree-sitter/search-engine.js\";\n\nconst SearchParams = Type.Object({\n  pattern: Type.String({ description: \"Structural pattern with metavariables ($NAME for single node, $$$NAME for variadic)\" }),\n  language: Type.String({ description: \"Target language (typescript, python, rust, java, etc.)\" }),\n  path: Type.Optional(Type.String({ description: \"File or directory to search (default: workspace root)\" })),\n  max_results: Type.Optional(Type.Number({ description: \"Maximum results to return (default: 50)\" })),\n});\n\ninterface SearchDetails {\n  matchCount: number;\n  filesSearched: number;\n}\n\nexport function createCodeSearchTool(\n  rootDirOrGetter: string | (() => string),\n  treeSitter: TreeSitterManager,\n): ToolDefinition<typeof SearchParams> {\n  const getRootDir = typeof rootDirOrGetter === \"function\" ? rootDirOrGetter : () => rootDirOrGetter;\n\n  return {\n    name: \"ast_search\",\n    label: \"Code Search\",\n    description:\n      \"Find code matching a structural pattern using AST matching. \" +\n      \"Use $NAME to match any single node, $$$NAME to match zero-or-more nodes. \" +\n      \"More precise than grep — matches code structure, not text.\",\n    parameters: SearchParams,\n\n    async execute(_toolCallId, params) {\n      const rootDir = getRootDir();\n      const { pattern: patternStr, language, path, max_results } = params;\n\n      // Compile the pattern\n      let compiled;\n      try {\n        compiled = await compilePattern(patternStr, language, treeSitter);\n      } catch (e: any) {\n        return {\n          content: [{ type: \"text\", text: `Error: ${e.message}` }],\n          details: { matchCount: 0, filesSearched: 0 },\n        };\n      }\n\n      // Run the search\n      const matches = await searchFiles(compiled, rootDir, treeSitter, {\n        path,\n        maxResults: max_results ?? 50,\n      });\n\n      if (matches.length === 0) {\n        return {\n          content: [{ type: \"text\", text: \"No matches found.\" }],\n          details: { matchCount: 0, filesSearched: 0 },\n        };\n      }\n\n      // Format results\n      const lines: string[] = [];\n      lines.push(`Found ${matches.length} match${matches.length !== 1 ? \"es\" : \"\"}:\\n`);\n\n      for (const m of matches) {\n        const relPath = relative(rootDir, m.file);\n        const matchText = m.matchedText.length > 200\n          ? m.matchedText.slice(0, 200) + \"...\"\n          : m.matchedText;\n\n        lines.push(`${relPath}:${m.line}:${m.column}`);\n        lines.push(`  ${matchText.replace(/\\n/g, \"\\n  \")}`);\n\n        // Show captures\n        const captureEntries = Object.entries(m.captures);\n        if (captureEntries.length > 0) {\n          for (const [name, value] of captureEntries) {\n            const displayValue = value.length > 100 ? value.slice(0, 100) + \"...\" : value;\n            lines.push(`  $${name} = ${displayValue}`);\n          }\n        }\n        lines.push(\"\");\n      }\n\n      const text = lines.join(\"\\n\");\n      const uniqueFiles = new Set(matches.map((m) => m.file));\n\n      const truncation = truncateHead(text, { maxLines: DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n      let output = truncation.content;\n      if (truncation.truncated) {\n        output += `\\n\\n[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines]`;\n      }\n\n      return {\n        content: [{ type: \"text\", text: output }],\n        details: { matchCount: matches.length, filesSearched: uniqueFiles.size },\n      };\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,34 @@
+/**
+ * lsp_completions — Get completion suggestions at a position.
+ *
+ * Returns ranked completion items with type signatures and documentation,
+ * letting the LLM discover available methods, properties, and APIs.
+ */
+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 CompletionParams: Type.TObject<{
+    path: Type.TString;
+    line: Type.TOptional<Type.TNumber>;
+    character: Type.TOptional<Type.TNumber>;
+    query: Type.TOptional<Type.TString>;
+    limit: Type.TOptional<Type.TNumber>;
+    trigger: Type.TOptional<Type.TUnion<[Type.TLiteral<"auto">, Type.TLiteral<"none">]>>;
+}>;
+interface CompletionDetails {
+    count: number;
+    total: number;
+}
+/** Interface for coordinating document versions with FileSync */
+export interface VersionTracker {
+    getTrackedVersion(uri: string): number | null;
+    setTrackedVersion(uri: string, version: number): void;
+    /** Check if a synthetic dot operation is in progress for a URI */
+    isSyntheticDotActive(uri: string): boolean;
+}
+/** Simple per-URI lock to prevent concurrent synthetic dot + file write version conflicts */
+export declare const syntheticDotLocks: Set<string>;
+export declare function createCompletionsTool(manager: LspManager, versionTracker?: VersionTracker, treeSitter?: TreeSitterManager | null): ToolDefinition<typeof CompletionParams, CompletionDetails>;
+export {};
+//# sourceMappingURL=completions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/completions.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAOzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA2E1E,QAAA,MAAM,gBAAgB;;;;;;;EAcpB,CAAC;AAEH,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAyCD,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,kEAAkE;IAClE,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5C;AAED,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,aAAoB,CAAC;AAEnD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC,cAAc,CAAC,OAAO,gBAAgB,EAAE,iBAAiB,CAAC,CA6P5D","sourcesContent":["// @ts-nocheck\n/**\n * lsp_completions — Get completion suggestions at a position.\n *\n * Returns ranked completion items with type signatures and documentation,\n * letting the LLM discover available methods, properties, and APIs.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type {\n  CompletionItem,\n  CompletionList,\n  CompletionItemKind,\n  MarkupContent,\n} 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 { resolveSymbolPosition } from \"../shared/resolve-position.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { SYNTHETIC_DOT_SETTLE_DELAY_MS } from \"../shared/timing.js\";\n\n/** Map CompletionItemKind to human-readable labels */\nconst KIND_LABELS: Record<number, string> = {\n  1: \"text\",\n  2: \"method\",\n  3: \"function\",\n  4: \"constructor\",\n  5: \"field\",\n  6: \"variable\",\n  7: \"class\",\n  8: \"interface\",\n  9: \"module\",\n  10: \"property\",\n  11: \"unit\",\n  12: \"value\",\n  13: \"enum\",\n  14: \"keyword\",\n  15: \"snippet\",\n  16: \"color\",\n  17: \"file\",\n  18: \"reference\",\n  19: \"folder\",\n  20: \"enum member\",\n  21: \"constant\",\n  22: \"struct\",\n  23: \"event\",\n  24: \"operator\",\n  25: \"type param\",\n};\n\nfunction kindLabel(kind?: CompletionItemKind): string {\n  if (!kind) return \"unknown\";\n  return KIND_LABELS[kind] ?? \"unknown\";\n}\n\n/** Extract a short doc summary (first 1-2 lines) from documentation */\nfunction docSummary(doc?: string | MarkupContent): string | undefined {\n  if (!doc) return undefined;\n  const text = typeof doc === \"string\" ? doc : doc.value;\n  if (!text) return undefined;\n  // Strip markdown code fences and take first 2 non-empty lines\n  const lines = text\n    .replace(/```[\\s\\S]*?```/g, \"\")\n    .split(\"\\n\")\n    .map((l) => l.trim())\n    .filter((l) => l.length > 0);\n  const summary = lines.slice(0, 2).join(\" \");\n  // Cap at 120 chars\n  return summary.length > 120 ? summary.slice(0, 117) + \"...\" : summary;\n}\n\n/** Format a single completion item as a compact line */\nfunction formatItem(item: CompletionItem): string {\n  const kind = kindLabel(item.kind);\n  const label = item.label;\n  const detail = item.detail ? ` ${item.detail}` : \"\";\n  const labelDetail =\n    item.labelDetails?.detail ? item.labelDetails.detail : \"\";\n  const labelDesc =\n    item.labelDetails?.description ? ` — ${item.labelDetails.description}` : \"\";\n\n  let line = `${kind.padEnd(12)} ${label}${labelDetail}${detail}${labelDesc}`;\n  const doc = docSummary(item.documentation);\n  if (doc) {\n    line += `\\n${\"\".padEnd(13)}${doc}`;\n  }\n  return line;\n}\n\ntype CompletionResponse = CompletionList | CompletionItem[] | null;\n\nconst CompletionParams = 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  limit: Type.Optional(\n    Type.Number({ description: \"Max results to return (default: 20)\" })\n  ),\n  trigger: Type.Optional(\n    Type.Union([Type.Literal(\"auto\"), Type.Literal(\"none\")], {\n      description:\n        'Synthetic trigger mode (default: \"auto\"). When \"auto\", if the position is at the end of an identifier (no trailing dot), a dot is temporarily inserted to trigger member completions. Use \"none\" to skip this.',\n    })\n  ),\n});\n\ninterface CompletionDetails {\n  count: number;\n  total: number;\n}\n\n/**\n * Check if the position is at the end of an identifier (suitable for synthetic dot insertion).\n * Returns the position after the identifier where the dot should be inserted, or null.\n */\nfunction shouldSyntheticTrigger(\n  content: string,\n  line: number,    // 0-indexed\n  character: number // 0-indexed\n): { insertLine: number; insertChar: number } | null {\n  const lines = content.split(\"\\n\");\n  if (line < 0 || line >= lines.length) return null;\n  const lineText = lines[line];\n  if (character < 0 || character > lineText.length) return null;\n\n  // The character at `character` (0-indexed) should NOT be a dot already\n  if (lineText[character] === \".\") return null;\n\n  // The character before `character` should be an identifier char (or closing paren/bracket)\n  const charBefore = character > 0 ? lineText[character - 1] : \"\";\n  if (!charBefore) return null;\n\n  // Accept identifier chars, closing parens/brackets (for chained calls like foo().bar)\n  if (/[\\w\\d_\\)\\]]/.test(charBefore)) {\n    return { insertLine: line, insertChar: character };\n  }\n\n  return null;\n}\n\n/**\n * Insert a dot at the given position in the content string.\n */\nfunction insertDot(content: string, line: number, character: number): string {\n  const lines = content.split(\"\\n\");\n  const lineText = lines[line];\n  lines[line] = lineText.slice(0, character) + \".\" + lineText.slice(character);\n  return lines.join(\"\\n\");\n}\n\n/** Interface for coordinating document versions with FileSync */\nexport interface VersionTracker {\n  getTrackedVersion(uri: string): number | null;\n  setTrackedVersion(uri: string, version: number): void;\n  /** Check if a synthetic dot operation is in progress for a URI */\n  isSyntheticDotActive(uri: string): boolean;\n}\n\n/** Simple per-URI lock to prevent concurrent synthetic dot + file write version conflicts */\nexport const syntheticDotLocks = new Set<string>();\n\nexport function createCompletionsTool(\n  manager: LspManager,\n  versionTracker?: VersionTracker,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof CompletionParams, CompletionDetails> {\n  return {\n    name: \"lsp_completions\",\n    label: \"LSP Completions\",\n    description:\n      'Get completion suggestions at a specific position in a file. Returns methods, properties, and other symbols available at that point. Useful for discovering APIs and verifying method names. Line and character are 1-indexed. When trigger is \"auto\" (default), a dot is temporarily inserted if the position is at the end of an identifier, enabling member completion without editing the file.',\n    promptSnippet:\n      'Get code completion suggestions at a file position via LSP. Use to discover available methods, properties, and APIs on objects. Supports automatic dot insertion for exploring members on identifiers.',\n    parameters: CompletionParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      const limit = params.limit ?? 20;\n      const trigger = params.trigger ?? \"auto\";\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 + 1;\n          character = resolved.character + 1;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}` }], details: { count: 0, total: 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, total: 0 } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n      if (!client) {\n        return {\n          content: [\n            { type: \"text\", text: manager.getUnavailableReason(filePath) },\n          ],\n          details: { count: 0, total: 0 },\n        };\n      }\n\n      // Check if server supports completions\n      const caps = client.serverCapabilities;\n      if (caps && !caps.completionProvider) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `LSP server for this file does not support completions.`,\n            },\n          ],\n          details: { count: 0, total: 0 },\n        };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const position = {\n        line: line - 1,\n        character: character - 1,\n      };\n\n      try {\n        // Synthetic trigger: if position is at end of identifier, temporarily insert \".\"\n        let syntheticDot = false;\n        let originalContent: string | null = null;\n        let revertVersion = 99991;\n        let completionPosition = position;\n\n        if (trigger === \"auto\") {\n          // Acquire per-URI lock to prevent concurrent version mutations\n          if (syntheticDotLocks.has(uri)) {\n            // Another synthetic dot operation is in progress — skip synthetic trigger\n          } else {\n          try {\n            syntheticDotLocks.add(uri);\n            const absPath = manager.resolvePath(filePath);\n            const fileContent = await readFile(absPath, \"utf-8\");\n            const triggerPos = shouldSyntheticTrigger(fileContent, position.line, position.character);\n\n            if (triggerPos) {\n              originalContent = fileContent;\n              const modifiedContent = insertDot(fileContent, triggerPos.insertLine, triggerPos.insertChar);\n\n              // Coordinate version with FileSync to avoid desync\n              const currentVersion = versionTracker?.getTrackedVersion(uri);\n              const insertVersion = currentVersion != null ? currentVersion + 1 : 99990;\n              revertVersion = currentVersion != null ? currentVersion + 2 : 99991;\n\n              // Send the modified content to the LSP server\n              client.didChange(uri, insertVersion, modifiedContent);\n\n              // Update FileSync so it knows about the version bump\n              if (versionTracker && currentVersion != null) {\n                versionTracker.setTrackedVersion(uri, insertVersion);\n              }\n\n              // The completion position is right after the inserted dot\n              completionPosition = {\n                line: triggerPos.insertLine,\n                character: triggerPos.insertChar + 1,\n              };\n              syntheticDot = true;\n\n              // Brief delay to let the LSP process the change\n              await new Promise((r) => setTimeout(r, SYNTHETIC_DOT_SETTLE_DELAY_MS));\n            }\n          } catch {\n            // If reading file or inserting dot fails, fall through to normal completion\n          } finally {\n            syntheticDotLocks.delete(uri);\n          }\n          }\n        }\n\n        let response: CompletionResponse;\n        try {\n          response = await client.sendRequest<CompletionResponse>(\n            \"textDocument/completion\",\n            { textDocument: { uri }, position: completionPosition }\n          );\n        } finally {\n          // Always revert synthetic dot, even on error\n          if (syntheticDot && originalContent !== null) {\n            try {\n              client.didChange(uri, revertVersion, originalContent);\n              // Update FileSync with the final version after revert\n              if (versionTracker) {\n                versionTracker.setTrackedVersion(uri, revertVersion);\n              }\n            } catch {\n              // Best effort revert\n            }\n          }\n        }\n\n        if (!response) {\n          return {\n            content: [\n              { type: \"text\", text: \"No completions available at this position.\" },\n            ],\n            details: { count: 0, total: 0 },\n          };\n        }\n\n        // Normalize to array\n        const allItems: CompletionItem[] = Array.isArray(response)\n          ? response\n          : response.items;\n\n        if (allItems.length === 0) {\n          return {\n            content: [\n              { type: \"text\", text: \"No completions available at this position.\" },\n            ],\n            details: { count: 0, total: 0 },\n          };\n        }\n\n        const total = allItems.length;\n\n        // Sort by sortText (LSP ranking), then take top N\n        const sorted = [...allItems].sort((a, b) => {\n          const sa = a.sortText ?? a.label;\n          const sb = b.sortText ?? b.label;\n          return sa.localeCompare(sb);\n        });\n        const topItems = sorted.slice(0, limit);\n\n        // Resolve items in parallel for full details (documentation, signatures)\n        const resolveSupported = caps?.completionProvider?.resolveProvider;\n        let resolvedItems: CompletionItem[];\n\n        if (resolveSupported) {\n          const resolveResults = await Promise.allSettled(\n            topItems.map((item) =>\n              Promise.race([\n                client.sendRequest<CompletionItem>(\n                  \"completionItem/resolve\",\n                  item\n                ),\n                // Timeout per item: 2 seconds\n                new Promise<CompletionItem>((_, reject) =>\n                  setTimeout(() => reject(new Error(\"resolve timeout\")), 2000)\n                ),\n              ])\n            )\n          );\n\n          resolvedItems = resolveResults.map((result, i) =>\n            result.status === \"fulfilled\" ? result.value : topItems[i]\n          );\n        } else {\n          resolvedItems = topItems;\n        }\n\n        // Format output\n        const triggerNote = syntheticDot ? \" (synthetic dot trigger)\" : \"\";\n        let header = `${resolvedItems.length} of ${total} completions at ${filePath}:${line}:${character}${triggerNote}\\n`;\n        if (resolvedFrom) header = `${resolvedFrom}\\n\\n${header}`;\n        const lines = resolvedItems.map(formatItem);\n        const text = header + lines.join(\"\\n\");\n\n        return {\n          content: [{ type: \"text\", text }],\n          details: { count: resolvedItems.length, total },\n        };\n      } catch (err: any) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `LSP completion request failed: ${err.message}`,\n            },\n          ],\n          details: { count: 0, total: 0 },\n        };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_completions \"));\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      const extras: string[] = [];\n      if (args.limit) extras.push(`limit: ${args.limit}`);\n      if (args.trigger === \"none\") extras.push(\"trigger: none\");\n      if (extras.length > 0) {\n        text += theme.fg(\"dim\", ` (${extras.join(\", \")})`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial)\n        return new Text(theme.fg(\"warning\", \"Loading completions...\"), 0, 0);\n      if (!result.details || result.details.count === 0) {\n        const content = result.content[0];\n        if (content?.type === \"text\")\n          return new Text(theme.fg(\"dim\", content.text), 0, 0);\n        return new Text(theme.fg(\"dim\", \"No completions\"), 0, 0);\n      }\n      const { count, total } = result.details;\n      const summary = `${count} of ${total} completions`;\n      return new Text(theme.fg(\"dim\", summary), 0, 0);\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,347 @@
+// @ts-nocheck
+/**
+ * lsp_completions — Get completion suggestions at a position.
+ *
+ * Returns ranked completion items with type signatures and documentation,
+ * letting the LLM discover available methods, properties, and APIs.
+ */
+import { Type } from "@sinclair/typebox";
+import { Text } from "@earendil-works/pi-tui";
+import { resolveSymbolPosition } from "../shared/resolve-position.js";
+import { readFile } from "node:fs/promises";
+import { SYNTHETIC_DOT_SETTLE_DELAY_MS } from "../shared/timing.js";
+/** Map CompletionItemKind to human-readable labels */
+const KIND_LABELS = {
+    1: "text",
+    2: "method",
+    3: "function",
+    4: "constructor",
+    5: "field",
+    6: "variable",
+    7: "class",
+    8: "interface",
+    9: "module",
+    10: "property",
+    11: "unit",
+    12: "value",
+    13: "enum",
+    14: "keyword",
+    15: "snippet",
+    16: "color",
+    17: "file",
+    18: "reference",
+    19: "folder",
+    20: "enum member",
+    21: "constant",
+    22: "struct",
+    23: "event",
+    24: "operator",
+    25: "type param",
+};
+function kindLabel(kind) {
+    if (!kind)
+        return "unknown";
+    return KIND_LABELS[kind] ?? "unknown";
+}
+/** Extract a short doc summary (first 1-2 lines) from documentation */
+function docSummary(doc) {
+    if (!doc)
+        return undefined;
+    const text = typeof doc === "string" ? doc : doc.value;
+    if (!text)
+        return undefined;
+    // Strip markdown code fences and take first 2 non-empty lines
+    const lines = text
+        .replace(/```[\s\S]*?```/g, "")
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    const summary = lines.slice(0, 2).join(" ");
+    // Cap at 120 chars
+    return summary.length > 120 ? summary.slice(0, 117) + "..." : summary;
+}
+/** Format a single completion item as a compact line */
+function formatItem(item) {
+    const kind = kindLabel(item.kind);
+    const label = item.label;
+    const detail = item.detail ? ` ${item.detail}` : "";
+    const labelDetail = item.labelDetails?.detail ? item.labelDetails.detail : "";
+    const labelDesc = item.labelDetails?.description ? ` — ${item.labelDetails.description}` : "";
+    let line = `${kind.padEnd(12)} ${label}${labelDetail}${detail}${labelDesc}`;
+    const doc = docSummary(item.documentation);
+    if (doc) {
+        line += `\n${"".padEnd(13)}${doc}`;
+    }
+    return line;
+}
+const CompletionParams = 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." })),
+    limit: Type.Optional(Type.Number({ description: "Max results to return (default: 20)" })),
+    trigger: Type.Optional(Type.Union([Type.Literal("auto"), Type.Literal("none")], {
+        description: 'Synthetic trigger mode (default: "auto"). When "auto", if the position is at the end of an identifier (no trailing dot), a dot is temporarily inserted to trigger member completions. Use "none" to skip this.',
+    })),
+});
+/**
+ * Check if the position is at the end of an identifier (suitable for synthetic dot insertion).
+ * Returns the position after the identifier where the dot should be inserted, or null.
+ */
+function shouldSyntheticTrigger(content, line, // 0-indexed
+character // 0-indexed
+) {
+    const lines = content.split("\n");
+    if (line < 0 || line >= lines.length)
+        return null;
+    const lineText = lines[line];
+    if (character < 0 || character > lineText.length)
+        return null;
+    // The character at `character` (0-indexed) should NOT be a dot already
+    if (lineText[character] === ".")
+        return null;
+    // The character before `character` should be an identifier char (or closing paren/bracket)
+    const charBefore = character > 0 ? lineText[character - 1] : "";
+    if (!charBefore)
+        return null;
+    // Accept identifier chars, closing parens/brackets (for chained calls like foo().bar)
+    if (/[\w\d_\)\]]/.test(charBefore)) {
+        return { insertLine: line, insertChar: character };
+    }
+    return null;
+}
+/**
+ * Insert a dot at the given position in the content string.
+ */
+function insertDot(content, line, character) {
+    const lines = content.split("\n");
+    const lineText = lines[line];
+    lines[line] = lineText.slice(0, character) + "." + lineText.slice(character);
+    return lines.join("\n");
+}
+/** Simple per-URI lock to prevent concurrent synthetic dot + file write version conflicts */
+export const syntheticDotLocks = new Set();
+export function createCompletionsTool(manager, versionTracker, treeSitter) {
+    return {
+        name: "lsp_completions",
+        label: "LSP Completions",
+        description: 'Get completion suggestions at a specific position in a file. Returns methods, properties, and other symbols available at that point. Useful for discovering APIs and verifying method names. Line and character are 1-indexed. When trigger is "auto" (default), a dot is temporarily inserted if the position is at the end of an identifier, enabling member completion without editing the file.',
+        promptSnippet: 'Get code completion suggestions at a file position via LSP. Use to discover available methods, properties, and APIs on objects. Supports automatic dot insertion for exploring members on identifiers.',
+        parameters: CompletionParams,
+        async execute(_toolCallId, params) {
+            const filePath = params.path.replace(/^@/, "");
+            const limit = params.limit ?? 20;
+            const trigger = params.trigger ?? "auto";
+            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 + 1;
+                    character = resolved.character + 1;
+                    resolvedFrom = `Resolved "${params.query}" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;
+                }
+                else {
+                    return { content: [{ type: "text", text: `Could not find symbol "${params.query}" in ${filePath}` }], details: { count: 0, total: 0 } };
+                }
+            }
+            if (line === undefined || character === undefined) {
+                return { content: [{ type: "text", text: "Either line/character or query is required." }], details: { count: 0, total: 0 } };
+            }
+            const client = await manager.getClientForFile(filePath).catch(() => null);
+            if (!client) {
+                return {
+                    content: [
+                        { type: "text", text: manager.getUnavailableReason(filePath) },
+                    ],
+                    details: { count: 0, total: 0 },
+                };
+            }
+            // Check if server supports completions
+            const caps = client.serverCapabilities;
+            if (caps && !caps.completionProvider) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `LSP server for this file does not support completions.`,
+                        },
+                    ],
+                    details: { count: 0, total: 0 },
+                };
+            }
+            const uri = manager.getFileUri(filePath);
+            const position = {
+                line: line - 1,
+                character: character - 1,
+            };
+            try {
+                // Synthetic trigger: if position is at end of identifier, temporarily insert "."
+                let syntheticDot = false;
+                let originalContent = null;
+                let revertVersion = 99991;
+                let completionPosition = position;
+                if (trigger === "auto") {
+                    // Acquire per-URI lock to prevent concurrent version mutations
+                    if (syntheticDotLocks.has(uri)) {
+                        // Another synthetic dot operation is in progress — skip synthetic trigger
+                    }
+                    else {
+                        try {
+                            syntheticDotLocks.add(uri);
+                            const absPath = manager.resolvePath(filePath);
+                            const fileContent = await readFile(absPath, "utf-8");
+                            const triggerPos = shouldSyntheticTrigger(fileContent, position.line, position.character);
+                            if (triggerPos) {
+                                originalContent = fileContent;
+                                const modifiedContent = insertDot(fileContent, triggerPos.insertLine, triggerPos.insertChar);
+                                // Coordinate version with FileSync to avoid desync
+                                const currentVersion = versionTracker?.getTrackedVersion(uri);
+                                const insertVersion = currentVersion != null ? currentVersion + 1 : 99990;
+                                revertVersion = currentVersion != null ? currentVersion + 2 : 99991;
+                                // Send the modified content to the LSP server
+                                client.didChange(uri, insertVersion, modifiedContent);
+                                // Update FileSync so it knows about the version bump
+                                if (versionTracker && currentVersion != null) {
+                                    versionTracker.setTrackedVersion(uri, insertVersion);
+                                }
+                                // The completion position is right after the inserted dot
+                                completionPosition = {
+                                    line: triggerPos.insertLine,
+                                    character: triggerPos.insertChar + 1,
+                                };
+                                syntheticDot = true;
+                                // Brief delay to let the LSP process the change
+                                await new Promise((r) => setTimeout(r, SYNTHETIC_DOT_SETTLE_DELAY_MS));
+                            }
+                        }
+                        catch {
+                            // If reading file or inserting dot fails, fall through to normal completion
+                        }
+                        finally {
+                            syntheticDotLocks.delete(uri);
+                        }
+                    }
+                }
+                let response;
+                try {
+                    response = await client.sendRequest("textDocument/completion", { textDocument: { uri }, position: completionPosition });
+                }
+                finally {
+                    // Always revert synthetic dot, even on error
+                    if (syntheticDot && originalContent !== null) {
+                        try {
+                            client.didChange(uri, revertVersion, originalContent);
+                            // Update FileSync with the final version after revert
+                            if (versionTracker) {
+                                versionTracker.setTrackedVersion(uri, revertVersion);
+                            }
+                        }
+                        catch {
+                            // Best effort revert
+                        }
+                    }
+                }
+                if (!response) {
+                    return {
+                        content: [
+                            { type: "text", text: "No completions available at this position." },
+                        ],
+                        details: { count: 0, total: 0 },
+                    };
+                }
+                // Normalize to array
+                const allItems = Array.isArray(response)
+                    ? response
+                    : response.items;
+                if (allItems.length === 0) {
+                    return {
+                        content: [
+                            { type: "text", text: "No completions available at this position." },
+                        ],
+                        details: { count: 0, total: 0 },
+                    };
+                }
+                const total = allItems.length;
+                // Sort by sortText (LSP ranking), then take top N
+                const sorted = [...allItems].sort((a, b) => {
+                    const sa = a.sortText ?? a.label;
+                    const sb = b.sortText ?? b.label;
+                    return sa.localeCompare(sb);
+                });
+                const topItems = sorted.slice(0, limit);
+                // Resolve items in parallel for full details (documentation, signatures)
+                const resolveSupported = caps?.completionProvider?.resolveProvider;
+                let resolvedItems;
+                if (resolveSupported) {
+                    const resolveResults = await Promise.allSettled(topItems.map((item) => Promise.race([
+                        client.sendRequest("completionItem/resolve", item),
+                        // Timeout per item: 2 seconds
+                        new Promise((_, reject) => setTimeout(() => reject(new Error("resolve timeout")), 2000)),
+                    ])));
+                    resolvedItems = resolveResults.map((result, i) => result.status === "fulfilled" ? result.value : topItems[i]);
+                }
+                else {
+                    resolvedItems = topItems;
+                }
+                // Format output
+                const triggerNote = syntheticDot ? " (synthetic dot trigger)" : "";
+                let header = `${resolvedItems.length} of ${total} completions at ${filePath}:${line}:${character}${triggerNote}\n`;
+                if (resolvedFrom)
+                    header = `${resolvedFrom}\n\n${header}`;
+                const lines = resolvedItems.map(formatItem);
+                const text = header + lines.join("\n");
+                return {
+                    content: [{ type: "text", text }],
+                    details: { count: resolvedItems.length, total },
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `LSP completion request failed: ${err.message}`,
+                        },
+                    ],
+                    details: { count: 0, total: 0 },
+                };
+            }
+        },
+        renderCall(args, theme) {
+            let text = theme.fg("toolTitle", theme.bold("lsp_completions "));
+            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}`);
+            }
+            const extras = [];
+            if (args.limit)
+                extras.push(`limit: ${args.limit}`);
+            if (args.trigger === "none")
+                extras.push("trigger: none");
+            if (extras.length > 0) {
+                text += theme.fg("dim", ` (${extras.join(", ")})`);
+            }
+            return new Text(text, 0, 0);
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return new Text(theme.fg("warning", "Loading completions..."), 0, 0);
+            if (!result.details || result.details.count === 0) {
+                const content = result.content[0];
+                if (content?.type === "text")
+                    return new Text(theme.fg("dim", content.text), 0, 0);
+                return new Text(theme.fg("dim", "No completions"), 0, 0);
+            }
+            const { count, total } = result.details;
+            const summary = `${count} of ${total} completions`;
+            return new Text(theme.fg("dim", summary), 0, 0);
+        },
+    };
+}
+//# sourceMappingURL=completions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completions.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/completions.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * lsp_completions — Get completion suggestions at a position.\n *\n * Returns ranked completion items with type signatures and documentation,\n * letting the LLM discover available methods, properties, and APIs.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type {\n  CompletionItem,\n  CompletionList,\n  CompletionItemKind,\n  MarkupContent,\n} 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 { resolveSymbolPosition } from \"../shared/resolve-position.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { SYNTHETIC_DOT_SETTLE_DELAY_MS } from \"../shared/timing.js\";\n\n/** Map CompletionItemKind to human-readable labels */\nconst KIND_LABELS: Record<number, string> = {\n  1: \"text\",\n  2: \"method\",\n  3: \"function\",\n  4: \"constructor\",\n  5: \"field\",\n  6: \"variable\",\n  7: \"class\",\n  8: \"interface\",\n  9: \"module\",\n  10: \"property\",\n  11: \"unit\",\n  12: \"value\",\n  13: \"enum\",\n  14: \"keyword\",\n  15: \"snippet\",\n  16: \"color\",\n  17: \"file\",\n  18: \"reference\",\n  19: \"folder\",\n  20: \"enum member\",\n  21: \"constant\",\n  22: \"struct\",\n  23: \"event\",\n  24: \"operator\",\n  25: \"type param\",\n};\n\nfunction kindLabel(kind?: CompletionItemKind): string {\n  if (!kind) return \"unknown\";\n  return KIND_LABELS[kind] ?? \"unknown\";\n}\n\n/** Extract a short doc summary (first 1-2 lines) from documentation */\nfunction docSummary(doc?: string | MarkupContent): string | undefined {\n  if (!doc) return undefined;\n  const text = typeof doc === \"string\" ? doc : doc.value;\n  if (!text) return undefined;\n  // Strip markdown code fences and take first 2 non-empty lines\n  const lines = text\n    .replace(/```[\\s\\S]*?```/g, \"\")\n    .split(\"\\n\")\n    .map((l) => l.trim())\n    .filter((l) => l.length > 0);\n  const summary = lines.slice(0, 2).join(\" \");\n  // Cap at 120 chars\n  return summary.length > 120 ? summary.slice(0, 117) + \"...\" : summary;\n}\n\n/** Format a single completion item as a compact line */\nfunction formatItem(item: CompletionItem): string {\n  const kind = kindLabel(item.kind);\n  const label = item.label;\n  const detail = item.detail ? ` ${item.detail}` : \"\";\n  const labelDetail =\n    item.labelDetails?.detail ? item.labelDetails.detail : \"\";\n  const labelDesc =\n    item.labelDetails?.description ? ` — ${item.labelDetails.description}` : \"\";\n\n  let line = `${kind.padEnd(12)} ${label}${labelDetail}${detail}${labelDesc}`;\n  const doc = docSummary(item.documentation);\n  if (doc) {\n    line += `\\n${\"\".padEnd(13)}${doc}`;\n  }\n  return line;\n}\n\ntype CompletionResponse = CompletionList | CompletionItem[] | null;\n\nconst CompletionParams = 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  limit: Type.Optional(\n    Type.Number({ description: \"Max results to return (default: 20)\" })\n  ),\n  trigger: Type.Optional(\n    Type.Union([Type.Literal(\"auto\"), Type.Literal(\"none\")], {\n      description:\n        'Synthetic trigger mode (default: \"auto\"). When \"auto\", if the position is at the end of an identifier (no trailing dot), a dot is temporarily inserted to trigger member completions. Use \"none\" to skip this.',\n    })\n  ),\n});\n\ninterface CompletionDetails {\n  count: number;\n  total: number;\n}\n\n/**\n * Check if the position is at the end of an identifier (suitable for synthetic dot insertion).\n * Returns the position after the identifier where the dot should be inserted, or null.\n */\nfunction shouldSyntheticTrigger(\n  content: string,\n  line: number,    // 0-indexed\n  character: number // 0-indexed\n): { insertLine: number; insertChar: number } | null {\n  const lines = content.split(\"\\n\");\n  if (line < 0 || line >= lines.length) return null;\n  const lineText = lines[line];\n  if (character < 0 || character > lineText.length) return null;\n\n  // The character at `character` (0-indexed) should NOT be a dot already\n  if (lineText[character] === \".\") return null;\n\n  // The character before `character` should be an identifier char (or closing paren/bracket)\n  const charBefore = character > 0 ? lineText[character - 1] : \"\";\n  if (!charBefore) return null;\n\n  // Accept identifier chars, closing parens/brackets (for chained calls like foo().bar)\n  if (/[\\w\\d_\\)\\]]/.test(charBefore)) {\n    return { insertLine: line, insertChar: character };\n  }\n\n  return null;\n}\n\n/**\n * Insert a dot at the given position in the content string.\n */\nfunction insertDot(content: string, line: number, character: number): string {\n  const lines = content.split(\"\\n\");\n  const lineText = lines[line];\n  lines[line] = lineText.slice(0, character) + \".\" + lineText.slice(character);\n  return lines.join(\"\\n\");\n}\n\n/** Interface for coordinating document versions with FileSync */\nexport interface VersionTracker {\n  getTrackedVersion(uri: string): number | null;\n  setTrackedVersion(uri: string, version: number): void;\n  /** Check if a synthetic dot operation is in progress for a URI */\n  isSyntheticDotActive(uri: string): boolean;\n}\n\n/** Simple per-URI lock to prevent concurrent synthetic dot + file write version conflicts */\nexport const syntheticDotLocks = new Set<string>();\n\nexport function createCompletionsTool(\n  manager: LspManager,\n  versionTracker?: VersionTracker,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof CompletionParams, CompletionDetails> {\n  return {\n    name: \"lsp_completions\",\n    label: \"LSP Completions\",\n    description:\n      'Get completion suggestions at a specific position in a file. Returns methods, properties, and other symbols available at that point. Useful for discovering APIs and verifying method names. Line and character are 1-indexed. When trigger is \"auto\" (default), a dot is temporarily inserted if the position is at the end of an identifier, enabling member completion without editing the file.',\n    promptSnippet:\n      'Get code completion suggestions at a file position via LSP. Use to discover available methods, properties, and APIs on objects. Supports automatic dot insertion for exploring members on identifiers.',\n    parameters: CompletionParams,\n\n    async execute(_toolCallId, params) {\n      const filePath = params.path.replace(/^@/, \"\");\n      const limit = params.limit ?? 20;\n      const trigger = params.trigger ?? \"auto\";\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 + 1;\n          character = resolved.character + 1;\n          resolvedFrom = `Resolved \"${params.query}\" → ${resolved.symbolName} at ${line}:${character} [${resolved.source}]`;\n        } else {\n          return { content: [{ type: \"text\", text: `Could not find symbol \"${params.query}\" in ${filePath}` }], details: { count: 0, total: 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, total: 0 } };\n      }\n\n      const client = await manager.getClientForFile(filePath).catch(() => null);\n      if (!client) {\n        return {\n          content: [\n            { type: \"text\", text: manager.getUnavailableReason(filePath) },\n          ],\n          details: { count: 0, total: 0 },\n        };\n      }\n\n      // Check if server supports completions\n      const caps = client.serverCapabilities;\n      if (caps && !caps.completionProvider) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `LSP server for this file does not support completions.`,\n            },\n          ],\n          details: { count: 0, total: 0 },\n        };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const position = {\n        line: line - 1,\n        character: character - 1,\n      };\n\n      try {\n        // Synthetic trigger: if position is at end of identifier, temporarily insert \".\"\n        let syntheticDot = false;\n        let originalContent: string | null = null;\n        let revertVersion = 99991;\n        let completionPosition = position;\n\n        if (trigger === \"auto\") {\n          // Acquire per-URI lock to prevent concurrent version mutations\n          if (syntheticDotLocks.has(uri)) {\n            // Another synthetic dot operation is in progress — skip synthetic trigger\n          } else {\n          try {\n            syntheticDotLocks.add(uri);\n            const absPath = manager.resolvePath(filePath);\n            const fileContent = await readFile(absPath, \"utf-8\");\n            const triggerPos = shouldSyntheticTrigger(fileContent, position.line, position.character);\n\n            if (triggerPos) {\n              originalContent = fileContent;\n              const modifiedContent = insertDot(fileContent, triggerPos.insertLine, triggerPos.insertChar);\n\n              // Coordinate version with FileSync to avoid desync\n              const currentVersion = versionTracker?.getTrackedVersion(uri);\n              const insertVersion = currentVersion != null ? currentVersion + 1 : 99990;\n              revertVersion = currentVersion != null ? currentVersion + 2 : 99991;\n\n              // Send the modified content to the LSP server\n              client.didChange(uri, insertVersion, modifiedContent);\n\n              // Update FileSync so it knows about the version bump\n              if (versionTracker && currentVersion != null) {\n                versionTracker.setTrackedVersion(uri, insertVersion);\n              }\n\n              // The completion position is right after the inserted dot\n              completionPosition = {\n                line: triggerPos.insertLine,\n                character: triggerPos.insertChar + 1,\n              };\n              syntheticDot = true;\n\n              // Brief delay to let the LSP process the change\n              await new Promise((r) => setTimeout(r, SYNTHETIC_DOT_SETTLE_DELAY_MS));\n            }\n          } catch {\n            // If reading file or inserting dot fails, fall through to normal completion\n          } finally {\n            syntheticDotLocks.delete(uri);\n          }\n          }\n        }\n\n        let response: CompletionResponse;\n        try {\n          response = await client.sendRequest<CompletionResponse>(\n            \"textDocument/completion\",\n            { textDocument: { uri }, position: completionPosition }\n          );\n        } finally {\n          // Always revert synthetic dot, even on error\n          if (syntheticDot && originalContent !== null) {\n            try {\n              client.didChange(uri, revertVersion, originalContent);\n              // Update FileSync with the final version after revert\n              if (versionTracker) {\n                versionTracker.setTrackedVersion(uri, revertVersion);\n              }\n            } catch {\n              // Best effort revert\n            }\n          }\n        }\n\n        if (!response) {\n          return {\n            content: [\n              { type: \"text\", text: \"No completions available at this position.\" },\n            ],\n            details: { count: 0, total: 0 },\n          };\n        }\n\n        // Normalize to array\n        const allItems: CompletionItem[] = Array.isArray(response)\n          ? response\n          : response.items;\n\n        if (allItems.length === 0) {\n          return {\n            content: [\n              { type: \"text\", text: \"No completions available at this position.\" },\n            ],\n            details: { count: 0, total: 0 },\n          };\n        }\n\n        const total = allItems.length;\n\n        // Sort by sortText (LSP ranking), then take top N\n        const sorted = [...allItems].sort((a, b) => {\n          const sa = a.sortText ?? a.label;\n          const sb = b.sortText ?? b.label;\n          return sa.localeCompare(sb);\n        });\n        const topItems = sorted.slice(0, limit);\n\n        // Resolve items in parallel for full details (documentation, signatures)\n        const resolveSupported = caps?.completionProvider?.resolveProvider;\n        let resolvedItems: CompletionItem[];\n\n        if (resolveSupported) {\n          const resolveResults = await Promise.allSettled(\n            topItems.map((item) =>\n              Promise.race([\n                client.sendRequest<CompletionItem>(\n                  \"completionItem/resolve\",\n                  item\n                ),\n                // Timeout per item: 2 seconds\n                new Promise<CompletionItem>((_, reject) =>\n                  setTimeout(() => reject(new Error(\"resolve timeout\")), 2000)\n                ),\n              ])\n            )\n          );\n\n          resolvedItems = resolveResults.map((result, i) =>\n            result.status === \"fulfilled\" ? result.value : topItems[i]\n          );\n        } else {\n          resolvedItems = topItems;\n        }\n\n        // Format output\n        const triggerNote = syntheticDot ? \" (synthetic dot trigger)\" : \"\";\n        let header = `${resolvedItems.length} of ${total} completions at ${filePath}:${line}:${character}${triggerNote}\\n`;\n        if (resolvedFrom) header = `${resolvedFrom}\\n\\n${header}`;\n        const lines = resolvedItems.map(formatItem);\n        const text = header + lines.join(\"\\n\");\n\n        return {\n          content: [{ type: \"text\", text }],\n          details: { count: resolvedItems.length, total },\n        };\n      } catch (err: any) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `LSP completion request failed: ${err.message}`,\n            },\n          ],\n          details: { count: 0, total: 0 },\n        };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_completions \"));\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      const extras: string[] = [];\n      if (args.limit) extras.push(`limit: ${args.limit}`);\n      if (args.trigger === \"none\") extras.push(\"trigger: none\");\n      if (extras.length > 0) {\n        text += theme.fg(\"dim\", ` (${extras.join(\", \")})`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial)\n        return new Text(theme.fg(\"warning\", \"Loading completions...\"), 0, 0);\n      if (!result.details || result.details.count === 0) {\n        const content = result.content[0];\n        if (content?.type === \"text\")\n          return new Text(theme.fg(\"dim\", content.text), 0, 0);\n        return new Text(theme.fg(\"dim\", \"No completions\"), 0, 0);\n      }\n      const { count, total } = result.details;\n      const summary = `${count} of ${total} completions`;\n      return new Text(theme.fg(\"dim\", summary), 0, 0);\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,20 @@
+/**
+ * lsp_definition — Go to the definition of 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";
+import type { WorkspaceIndex } from "../tree-sitter/workspace-index.js";
+declare const DefinitionParams: Type.TObject<{
+    path: Type.TString;
+    line: Type.TOptional<Type.TNumber>;
+    character: Type.TOptional<Type.TNumber>;
+    query: Type.TOptional<Type.TString>;
+}>;
+interface DefinitionDetails {
+    count: number;
+}
+export declare function createDefinitionTool(manager: LspManager, treeSitter?: TreeSitterManager | null, workspaceIndex?: WorkspaceIndex | null): ToolDefinition<typeof DefinitionParams, DefinitionDetails>;
+export {};
+//# sourceMappingURL=definition.d.ts.map