@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-lsp-extension/src/shared/resolve-position.js

@@ -0,0 +1,191 @@
+// @ts-nocheck
+/**
+ * Shared position resolver — resolves a symbol name to a file position.
+ *
+ * Used by position-based tools (hover, definition, references, rename, completions)
+ * to allow the LLM to pass a symbol name instead of exact line/character.
+ */
+import { extractSymbols } from "../tree-sitter/symbol-extractor.js";
+import { getLanguageIdFromPath } from "./language-map.js";
+import { readFile } from "node:fs/promises";
+/**
+ * Resolve a symbol name to a position in a file.
+ *
+ * Priority:
+ * 1. LSP document symbols (most accurate)
+ * 2. Tree-sitter symbol extraction (fallback)
+ *
+ * Matching priority:
+ * 1. Exact case-sensitive match
+ * 2. Case-insensitive exact match
+ * 3. Substring match (case-insensitive)
+ * 4. Dot-qualified match (e.g. "MyClass.render" matches "render" inside "MyClass")
+ */
+export async function resolveSymbolPosition(filePath, query, manager, treeSitter) {
+    // Try LSP document symbols first
+    const client = await manager.getClientForFile(filePath).catch(() => null);
+    if (client) {
+        const uri = manager.getFileUri(filePath);
+        try {
+            const symbols = await client.sendRequest("textDocument/documentSymbol", { textDocument: { uri } });
+            if (symbols && symbols.length > 0) {
+                const match = findInDocumentSymbols(symbols, query);
+                if (match)
+                    return match;
+            }
+        }
+        catch { /* fall through to tree-sitter */ }
+    }
+    // Try tree-sitter fallback
+    if (treeSitter) {
+        try {
+            const absPath = manager.resolvePath(filePath);
+            const content = await readFile(absPath, "utf-8");
+            const languageId = getLanguageIdFromPath(filePath);
+            if (languageId) {
+                const tree = await treeSitter.parse(absPath, content);
+                if (tree) {
+                    const symbols = extractSymbols(tree, languageId);
+                    const match = findInSymbolInfos(symbols, query);
+                    if (match)
+                        return match;
+                }
+            }
+        }
+        catch { /* fall through */ }
+    }
+    return null;
+}
+/**
+ * Get top-level symbol names from a file (for error hints).
+ */
+export async function getSymbolNames(filePath, manager, treeSitter) {
+    const client = await manager.getClientForFile(filePath).catch(() => null);
+    if (client) {
+        const uri = manager.getFileUri(filePath);
+        try {
+            const symbols = await client.sendRequest("textDocument/documentSymbol", { textDocument: { uri } });
+            if (symbols && symbols.length > 0) {
+                if ("selectionRange" in symbols[0]) {
+                    return symbols.map(s => s.name);
+                }
+                return symbols.map(s => s.name);
+            }
+        }
+        catch { /* fall through */ }
+    }
+    if (treeSitter) {
+        try {
+            const absPath = manager.resolvePath(filePath);
+            const content = await readFile(absPath, "utf-8");
+            const languageId = getLanguageIdFromPath(filePath);
+            if (languageId) {
+                const tree = await treeSitter.parse(absPath, content);
+                if (tree) {
+                    const symbols = extractSymbols(tree, languageId);
+                    return symbols.map(s => s.name);
+                }
+            }
+        }
+        catch { /* fall through */ }
+    }
+    return [];
+}
+// --- LSP DocumentSymbol matching ---
+function findInDocumentSymbols(symbols, query) {
+    if (symbols.length === 0)
+        return null;
+    // Check if these are DocumentSymbol (hierarchical) or SymbolInformation (flat)
+    if ("selectionRange" in symbols[0]) {
+        return findInHierarchicalSymbols(symbols, query);
+    }
+    return findInFlatSymbols(symbols, query);
+}
+function findInHierarchicalSymbols(symbols, query) {
+    const candidates = flattenDocumentSymbols(symbols);
+    return matchCandidates(candidates, query, "lsp");
+}
+function flattenDocumentSymbols(symbols, parent) {
+    const result = [];
+    for (const sym of symbols) {
+        result.push({
+            name: sym.name,
+            line: sym.selectionRange.start.line + 1,
+            character: sym.selectionRange.start.character + 1,
+            parent,
+        });
+        if (sym.children && sym.children.length > 0) {
+            result.push(...flattenDocumentSymbols(sym.children, sym.name));
+        }
+    }
+    return result;
+}
+function findInFlatSymbols(symbols, query) {
+    const candidates = symbols.map(sym => ({
+        name: sym.name,
+        line: sym.location.range.start.line + 1,
+        character: sym.location.range.start.character + 1,
+        parent: sym.containerName ?? undefined,
+    }));
+    return matchCandidates(candidates, query, "lsp");
+}
+// --- Tree-sitter SymbolInfo matching ---
+function findInSymbolInfos(symbols, query) {
+    const candidates = flattenSymbolInfos(symbols);
+    return matchCandidates(candidates, query, "tree-sitter");
+}
+function flattenSymbolInfos(symbols, parent) {
+    const result = [];
+    for (const sym of symbols) {
+        result.push({
+            name: sym.name,
+            line: sym.line,
+            character: 1, // tree-sitter symbols don't have column precision for the name
+            parent,
+        });
+        if (sym.children && sym.children.length > 0) {
+            result.push(...flattenSymbolInfos(sym.children, sym.name));
+        }
+    }
+    return result;
+}
+// --- Shared matching logic ---
+function matchCandidates(candidates, query, source) {
+    // Support dot-qualified queries like "MyClass.render"
+    const dotIndex = query.lastIndexOf(".");
+    let parentFilter;
+    let symbolQuery;
+    if (dotIndex > 0) {
+        parentFilter = query.slice(0, dotIndex);
+        symbolQuery = query.slice(dotIndex + 1);
+    }
+    else {
+        symbolQuery = query;
+    }
+    // If dot-qualified, try to match parent.child first
+    if (parentFilter) {
+        const qualified = candidates.filter(c => c.parent?.toLowerCase() === parentFilter.toLowerCase());
+        const match = matchByPriority(qualified, symbolQuery, source);
+        if (match)
+            return match;
+    }
+    // Fall back to unqualified match across all candidates
+    return matchByPriority(candidates, symbolQuery, source);
+}
+function matchByPriority(candidates, query, source) {
+    const queryLower = query.toLowerCase();
+    // 1. Exact case-sensitive match
+    const exact = candidates.find(c => c.name === query);
+    if (exact)
+        return { line: exact.line, character: exact.character, symbolName: exact.name, source };
+    // 2. Case-insensitive exact match
+    const caseInsensitive = candidates.find(c => c.name.toLowerCase() === queryLower);
+    if (caseInsensitive)
+        return { line: caseInsensitive.line, character: caseInsensitive.character, symbolName: caseInsensitive.name, source };
+    // 3. Substring match (case-insensitive)
+    const substring = candidates.find(c => c.name.toLowerCase().includes(queryLower));
+    if (substring)
+        return { line: substring.line, character: substring.character, symbolName: substring.name, source };
+    return null;
+}
+//# sourceMappingURL=resolve-position.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/shared/resolve-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-position.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/shared/resolve-position.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Shared position resolver — resolves a symbol name to a file position.\n *\n * Used by position-based tools (hover, definition, references, rename, completions)\n * to allow the LLM to pass a symbol name instead of exact line/character.\n */\n\nimport type { DocumentSymbol, SymbolInformation } from \"vscode-languageserver-protocol\";\nimport type { LspManager } from \"../lsp-manager.js\";\nimport type { TreeSitterManager } from \"../tree-sitter/parser-manager.js\";\nimport { extractSymbols, type SymbolInfo } from \"../tree-sitter/symbol-extractor.js\";\nimport { getLanguageIdFromPath } from \"./language-map.js\";\nimport { readFile } from \"node:fs/promises\";\n\nexport interface ResolvedPosition {\n  line: number;       // 1-indexed (tool convention)\n  character: number;  // 1-indexed\n  symbolName: string;\n  source: \"lsp\" | \"tree-sitter\";\n}\n\ntype DocumentSymbolResponse = DocumentSymbol[] | SymbolInformation[] | null;\n\n/**\n * Resolve a symbol name to a position in a file.\n *\n * Priority:\n * 1. LSP document symbols (most accurate)\n * 2. Tree-sitter symbol extraction (fallback)\n *\n * Matching priority:\n * 1. Exact case-sensitive match\n * 2. Case-insensitive exact match\n * 3. Substring match (case-insensitive)\n * 4. Dot-qualified match (e.g. \"MyClass.render\" matches \"render\" inside \"MyClass\")\n */\nexport async function resolveSymbolPosition(\n  filePath: string,\n  query: string,\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): Promise<ResolvedPosition | null> {\n  // Try LSP document symbols first\n  const client = await manager.getClientForFile(filePath).catch(() => null);\n  if (client) {\n    const uri = manager.getFileUri(filePath);\n    try {\n      const symbols = await client.sendRequest<DocumentSymbolResponse>(\n        \"textDocument/documentSymbol\",\n        { textDocument: { uri } }\n      );\n      if (symbols && symbols.length > 0) {\n        const match = findInDocumentSymbols(symbols, query);\n        if (match) return match;\n      }\n    } catch { /* fall through to tree-sitter */ }\n  }\n\n  // Try tree-sitter fallback\n  if (treeSitter) {\n    try {\n      const absPath = manager.resolvePath(filePath);\n      const content = await readFile(absPath, \"utf-8\");\n      const languageId = getLanguageIdFromPath(filePath);\n      if (languageId) {\n        const tree = await treeSitter.parse(absPath, content);\n        if (tree) {\n          const symbols = extractSymbols(tree, languageId);\n          const match = findInSymbolInfos(symbols, query);\n          if (match) return match;\n        }\n      }\n    } catch { /* fall through */ }\n  }\n\n  return null;\n}\n\n/**\n * Get top-level symbol names from a file (for error hints).\n */\nexport async function getSymbolNames(\n  filePath: string,\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): Promise<string[]> {\n  const client = await manager.getClientForFile(filePath).catch(() => null);\n  if (client) {\n    const uri = manager.getFileUri(filePath);\n    try {\n      const symbols = await client.sendRequest<DocumentSymbolResponse>(\n        \"textDocument/documentSymbol\",\n        { textDocument: { uri } }\n      );\n      if (symbols && symbols.length > 0) {\n        if (\"selectionRange\" in symbols[0]) {\n          return (symbols as DocumentSymbol[]).map(s => s.name);\n        }\n        return (symbols as SymbolInformation[]).map(s => s.name);\n      }\n    } catch { /* fall through */ }\n  }\n\n  if (treeSitter) {\n    try {\n      const absPath = manager.resolvePath(filePath);\n      const content = await readFile(absPath, \"utf-8\");\n      const languageId = getLanguageIdFromPath(filePath);\n      if (languageId) {\n        const tree = await treeSitter.parse(absPath, content);\n        if (tree) {\n          const symbols = extractSymbols(tree, languageId);\n          return symbols.map(s => s.name);\n        }\n      }\n    } catch { /* fall through */ }\n  }\n\n  return [];\n}\n\n// --- LSP DocumentSymbol matching ---\n\nfunction findInDocumentSymbols(\n  symbols: DocumentSymbol[] | SymbolInformation[],\n  query: string,\n): ResolvedPosition | null {\n  if (symbols.length === 0) return null;\n\n  // Check if these are DocumentSymbol (hierarchical) or SymbolInformation (flat)\n  if (\"selectionRange\" in symbols[0]) {\n    return findInHierarchicalSymbols(symbols as DocumentSymbol[], query);\n  }\n  return findInFlatSymbols(symbols as SymbolInformation[], query);\n}\n\ninterface SymbolCandidate {\n  name: string;\n  line: number;      // 1-indexed\n  character: number; // 1-indexed\n  parent?: string;\n}\n\nfunction findInHierarchicalSymbols(\n  symbols: DocumentSymbol[],\n  query: string,\n): ResolvedPosition | null {\n  const candidates = flattenDocumentSymbols(symbols);\n  return matchCandidates(candidates, query, \"lsp\");\n}\n\nfunction flattenDocumentSymbols(\n  symbols: DocumentSymbol[],\n  parent?: string,\n): SymbolCandidate[] {\n  const result: SymbolCandidate[] = [];\n  for (const sym of symbols) {\n    result.push({\n      name: sym.name,\n      line: sym.selectionRange.start.line + 1,\n      character: sym.selectionRange.start.character + 1,\n      parent,\n    });\n    if (sym.children && sym.children.length > 0) {\n      result.push(...flattenDocumentSymbols(sym.children, sym.name));\n    }\n  }\n  return result;\n}\n\nfunction findInFlatSymbols(\n  symbols: SymbolInformation[],\n  query: string,\n): ResolvedPosition | null {\n  const candidates: SymbolCandidate[] = symbols.map(sym => ({\n    name: sym.name,\n    line: sym.location.range.start.line + 1,\n    character: sym.location.range.start.character + 1,\n    parent: sym.containerName ?? undefined,\n  }));\n  return matchCandidates(candidates, query, \"lsp\");\n}\n\n// --- Tree-sitter SymbolInfo matching ---\n\nfunction findInSymbolInfos(\n  symbols: SymbolInfo[],\n  query: string,\n): ResolvedPosition | null {\n  const candidates = flattenSymbolInfos(symbols);\n  return matchCandidates(candidates, query, \"tree-sitter\");\n}\n\nfunction flattenSymbolInfos(\n  symbols: SymbolInfo[],\n  parent?: string,\n): SymbolCandidate[] {\n  const result: SymbolCandidate[] = [];\n  for (const sym of symbols) {\n    result.push({\n      name: sym.name,\n      line: sym.line,\n      character: 1, // tree-sitter symbols don't have column precision for the name\n      parent,\n    });\n    if (sym.children && sym.children.length > 0) {\n      result.push(...flattenSymbolInfos(sym.children, sym.name));\n    }\n  }\n  return result;\n}\n\n// --- Shared matching logic ---\n\nfunction matchCandidates(\n  candidates: SymbolCandidate[],\n  query: string,\n  source: \"lsp\" | \"tree-sitter\",\n): ResolvedPosition | null {\n  // Support dot-qualified queries like \"MyClass.render\"\n  const dotIndex = query.lastIndexOf(\".\");\n  let parentFilter: string | undefined;\n  let symbolQuery: string;\n\n  if (dotIndex > 0) {\n    parentFilter = query.slice(0, dotIndex);\n    symbolQuery = query.slice(dotIndex + 1);\n  } else {\n    symbolQuery = query;\n  }\n\n  // If dot-qualified, try to match parent.child first\n  if (parentFilter) {\n    const qualified = candidates.filter(\n      c => c.parent?.toLowerCase() === parentFilter!.toLowerCase()\n    );\n    const match = matchByPriority(qualified, symbolQuery, source);\n    if (match) return match;\n  }\n\n  // Fall back to unqualified match across all candidates\n  return matchByPriority(candidates, symbolQuery, source);\n}\n\nfunction matchByPriority(\n  candidates: SymbolCandidate[],\n  query: string,\n  source: \"lsp\" | \"tree-sitter\",\n): ResolvedPosition | null {\n  const queryLower = query.toLowerCase();\n\n  // 1. Exact case-sensitive match\n  const exact = candidates.find(c => c.name === query);\n  if (exact) return { line: exact.line, character: exact.character, symbolName: exact.name, source };\n\n  // 2. Case-insensitive exact match\n  const caseInsensitive = candidates.find(c => c.name.toLowerCase() === queryLower);\n  if (caseInsensitive) return { line: caseInsensitive.line, character: caseInsensitive.character, symbolName: caseInsensitive.name, source };\n\n  // 3. Substring match (case-insensitive)\n  const substring = candidates.find(c => c.name.toLowerCase().includes(queryLower));\n  if (substring) return { line: substring.line, character: substring.character, symbolName: substring.name, source };\n\n  return null;\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/shared/timing.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared timing constants for LSP operations.
+ */
+/** Delay (ms) to wait for LSP to publish diagnostics after a file change */
+export declare const DIAGNOSTIC_SETTLE_DELAY_MS = 1500;
+/** Delay (ms) to wait for a daemon socket to start listening after spawn */
+export declare const DAEMON_SOCKET_READY_DELAY_MS = 500;
+/** Interval (ms) between retries when connecting to a daemon */
+export declare const DAEMON_RETRY_INTERVAL_MS = 5000;
+/** Maximum number of retries when connecting to a daemon (5 min total at 5s intervals) */
+export declare const DAEMON_MAX_RETRIES = 60;
+/** Delay (ms) to let LSP process a synthetic didChange before requesting completions */
+export declare const SYNTHETIC_DOT_SETTLE_DELAY_MS = 100;
+//# sourceMappingURL=timing.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/shared/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/shared/timing.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,wFAAwF;AACxF,eAAO,MAAM,6BAA6B,MAAM,CAAC","sourcesContent":["// @ts-nocheck\n/**\n * Shared timing constants for LSP operations.\n */\n\n/** Delay (ms) to wait for LSP to publish diagnostics after a file change */\nexport const DIAGNOSTIC_SETTLE_DELAY_MS = 1500;\n\n/** Delay (ms) to wait for a daemon socket to start listening after spawn */\nexport const DAEMON_SOCKET_READY_DELAY_MS = 500;\n\n/** Interval (ms) between retries when connecting to a daemon */\nexport const DAEMON_RETRY_INTERVAL_MS = 5000;\n\n/** Maximum number of retries when connecting to a daemon (5 min total at 5s intervals) */\nexport const DAEMON_MAX_RETRIES = 60;\n\n/** Delay (ms) to let LSP process a synthetic didChange before requesting completions */\nexport const SYNTHETIC_DOT_SETTLE_DELAY_MS = 100;\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/shared/timing.js

@@ -0,0 +1,15 @@
+// @ts-nocheck
+/**
+ * Shared timing constants for LSP operations.
+ */
+/** Delay (ms) to wait for LSP to publish diagnostics after a file change */
+export const DIAGNOSTIC_SETTLE_DELAY_MS = 1500;
+/** Delay (ms) to wait for a daemon socket to start listening after spawn */
+export const DAEMON_SOCKET_READY_DELAY_MS = 500;
+/** Interval (ms) between retries when connecting to a daemon */
+export const DAEMON_RETRY_INTERVAL_MS = 5000;
+/** Maximum number of retries when connecting to a daemon (5 min total at 5s intervals) */
+export const DAEMON_MAX_RETRIES = 60;
+/** Delay (ms) to let LSP process a synthetic didChange before requesting completions */
+export const SYNTHETIC_DOT_SETTLE_DELAY_MS = 100;
+//# sourceMappingURL=timing.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/shared/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/shared/timing.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;GAEG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,gEAAgE;AAChE,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,wFAAwF;AACxF,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC","sourcesContent":["// @ts-nocheck\n/**\n * Shared timing constants for LSP operations.\n */\n\n/** Delay (ms) to wait for LSP to publish diagnostics after a file change */\nexport const DIAGNOSTIC_SETTLE_DELAY_MS = 1500;\n\n/** Delay (ms) to wait for a daemon socket to start listening after spawn */\nexport const DAEMON_SOCKET_READY_DELAY_MS = 500;\n\n/** Interval (ms) between retries when connecting to a daemon */\nexport const DAEMON_RETRY_INTERVAL_MS = 5000;\n\n/** Maximum number of retries when connecting to a daemon (5 min total at 5s intervals) */\nexport const DAEMON_MAX_RETRIES = 60;\n\n/** Delay (ms) to let LSP process a synthetic didChange before requesting completions */\nexport const SYNTHETIC_DOT_SETTLE_DELAY_MS = 100;\n"]}

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

@@ -0,0 +1,23 @@
+/**
+ * lsp_code_actions — Get available code actions (quick fixes, refactorings) at a position.
+ */
+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 CodeActionsParams: Type.TObject<{
+    path: Type.TString;
+    line: Type.TOptional<Type.TNumber>;
+    character: Type.TOptional<Type.TNumber>;
+    query: Type.TOptional<Type.TString>;
+    endLine: Type.TOptional<Type.TNumber>;
+    endCharacter: Type.TOptional<Type.TNumber>;
+    kind: Type.TOptional<Type.TString>;
+}>;
+interface CodeActionsDetails {
+    count: number;
+    preferredCount: number;
+}
+export declare function createCodeActionsTool(manager: LspManager, treeSitter?: TreeSitterManager | null): ToolDefinition<typeof CodeActionsParams, CodeActionsDetails>;
+export {};
+//# sourceMappingURL=code-actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-actions.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-lsp-extension/src/tools/code-actions.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAQzC,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;AAO1E,QAAA,MAAM,iBAAiB;;;;;;;;EAQrB,CAAC;AAEH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAyED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACpC,cAAc,CAAC,OAAO,iBAAiB,EAAE,kBAAkB,CAAC,CA4K9D","sourcesContent":["// @ts-nocheck\n/**\n * lsp_code_actions — Get available code actions (quick fixes, refactorings) at a position.\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type {\n  CodeAction,\n  Command,\n  Diagnostic,\n  TextEdit,\n  WorkspaceEdit,\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, getSymbolNames } from \"../shared/resolve-position.js\";\nimport { fileURLToPath } from \"node:url\";\nimport { relative } from \"node:path\";\n\ntype CodeActionResponse = (CodeAction | Command)[] | null;\n\nconst CodeActionsParams = 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  endLine: Type.Optional(Type.Number({ description: \"End line for range selection (1-indexed). Defaults to line.\" })),\n  endCharacter: Type.Optional(Type.Number({ description: \"End column for range selection (1-indexed). Defaults to character.\" })),\n  kind: Type.Optional(Type.String({ description: 'Filter by action kind (e.g., \"quickfix\", \"refactor\", \"source\")' })),\n});\n\ninterface CodeActionsDetails {\n  count: number;\n  preferredCount: number;\n}\n\n/** Check if a range contains a position (all 0-indexed) */\nfunction rangeContainsPosition(\n  range: { start: { line: number; character: number }; end: { line: number; character: number } },\n  line: number,\n  character: number,\n): boolean {\n  if (line < range.start.line || line > range.end.line) return false;\n  if (line === range.start.line && character < range.start.character) return false;\n  if (line === range.end.line && character > range.end.character) return false;\n  return true;\n}\n\n/** Format a workspace edit's changes into readable lines */\nfunction formatEditSummary(edit: WorkspaceEdit, rootDir: string): string[] {\n  const lines: string[] = [];\n\n  if (edit.documentChanges) {\n    for (const change of edit.documentChanges) {\n      if (\"textDocument\" in change && \"edits\" in change) {\n        let relPath: string;\n        try { relPath = relative(rootDir, fileURLToPath(change.textDocument.uri)); } catch { relPath = change.textDocument.uri; }\n        for (const textEdit of (change.edits as TextEdit[]).slice(0, 5)) {\n          const ln = textEdit.range.start.line + 1;\n          const col = textEdit.range.start.character + 1;\n          const endLn = textEdit.range.end.line + 1;\n          const endCol = textEdit.range.end.character + 1;\n          const newText = textEdit.newText.length > 60\n            ? textEdit.newText.slice(0, 57) + \"...\"\n            : textEdit.newText;\n          if (textEdit.range.start.line === textEdit.range.end.line && textEdit.range.start.character === textEdit.range.end.character) {\n            lines.push(`     ${relPath}:${ln}:${col} insert \"${newText.replace(/\\n/g, \"\\\\n\")}\"`);\n          } else {\n            lines.push(`     ${relPath}:${ln}:${col}-${endLn}:${endCol} → \"${newText.replace(/\\n/g, \"\\\\n\")}\"`);\n          }\n        }\n        const remaining = (change.edits as TextEdit[]).length - 5;\n        if (remaining > 0) lines.push(`     ... and ${remaining} more edits in ${relPath}`);\n      }\n    }\n  }\n\n  const changes = edit.changes ?? {};\n  for (const [uri, edits] of Object.entries(changes)) {\n    let relPath: string;\n    try { relPath = relative(rootDir, fileURLToPath(uri)); } catch { relPath = uri; }\n    for (const textEdit of edits.slice(0, 5)) {\n      const ln = textEdit.range.start.line + 1;\n      const col = textEdit.range.start.character + 1;\n      const endLn = textEdit.range.end.line + 1;\n      const endCol = textEdit.range.end.character + 1;\n      const newText = textEdit.newText.length > 60\n        ? textEdit.newText.slice(0, 57) + \"...\"\n        : textEdit.newText;\n      if (textEdit.range.start.line === textEdit.range.end.line && textEdit.range.start.character === textEdit.range.end.character) {\n        lines.push(`     ${relPath}:${ln}:${col} insert \"${newText.replace(/\\n/g, \"\\\\n\")}\"`);\n      } else {\n        lines.push(`     ${relPath}:${ln}:${col}-${endLn}:${endCol} → \"${newText.replace(/\\n/g, \"\\\\n\")}\"`);\n      }\n    }\n    const remaining = edits.length - 5;\n    if (remaining > 0) lines.push(`     ... and ${remaining} more edits in ${relPath}`);\n  }\n\n  return lines;\n}\n\n/** Check if a response item is a CodeAction (vs a Command) */\nfunction isCodeAction(item: CodeAction | Command): item is CodeAction {\n  return \"kind\" in item || \"edit\" in item || \"diagnostics\" in item || \"isPreferred\" in item;\n}\n\nexport function createCodeActionsTool(\n  manager: LspManager,\n  treeSitter?: TreeSitterManager | null,\n): ToolDefinition<typeof CodeActionsParams, CodeActionsDetails> {\n  return {\n    name: \"lsp_code_actions\",\n    label: \"LSP Code Actions\",\n    description: \"Get available code actions (quick fixes, refactorings, source actions) at a position or range. Returns actionable fixes the LSP server can suggest — auto-imports, remove unused, extract method, etc.\",\n    promptSnippet: \"Get available code actions (quick fixes, refactorings) at a file position via LSP. Use after lsp_diagnostics shows errors to find auto-fixes.\",\n    parameters: CodeActionsParams,\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, preferredCount: 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, preferredCount: 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, preferredCount: 0 } };\n      }\n\n      // Check if server supports code actions\n      const caps = client.serverCapabilities;\n      if (caps && !caps.codeActionProvider) {\n        return {\n          content: [{ type: \"text\", text: \"LSP server for this file does not support code actions.\" }],\n          details: { count: 0, preferredCount: 0 },\n        };\n      }\n\n      const uri = manager.getFileUri(filePath);\n      const startLine = line - 1;\n      const startChar = character - 1;\n      const endLine = (params.endLine ?? line) - 1;\n      const endChar = (params.endCharacter ?? character) - 1;\n\n      // Collect diagnostics that overlap with the requested range\n      const allDiags = client.getDiagnostics(uri) ?? [];\n      const rangeDiags = allDiags.filter((d: Diagnostic) =>\n        rangeContainsPosition(d.range, startLine, startChar) ||\n        rangeContainsPosition({ start: { line: startLine, character: startChar }, end: { line: endLine, character: endChar } }, d.range.start.line, d.range.start.character)\n      );\n\n      try {\n        const response = await client.sendRequest<CodeActionResponse>(\"textDocument/codeAction\", {\n          textDocument: { uri },\n          range: {\n            start: { line: startLine, character: startChar },\n            end: { line: endLine, character: endChar },\n          },\n          context: {\n            diagnostics: rangeDiags,\n            only: params.kind ? [params.kind] : undefined,\n          },\n        });\n\n        if (!response || response.length === 0) {\n          const text = resolvedFrom\n            ? `${resolvedFrom}\\n\\nNo code actions available at this position.`\n            : \"No code actions available at this position.\";\n          return { content: [{ type: \"text\", text }], details: { count: 0, preferredCount: 0 } };\n        }\n\n        // Separate CodeActions from Commands, sort: preferred first, then by kind\n        const actions: CodeAction[] = [];\n        const commands: Command[] = [];\n\n        for (const item of response) {\n          if (isCodeAction(item)) {\n            actions.push(item);\n          } else {\n            commands.push(item);\n          }\n        }\n\n        // Sort: preferred first, then quickfix > refactor > source > other\n        const kindOrder: Record<string, number> = { quickfix: 0, refactor: 1, source: 2 };\n        actions.sort((a, b) => {\n          if (a.isPreferred && !b.isPreferred) return -1;\n          if (!a.isPreferred && b.isPreferred) return 1;\n          const aKind = a.kind?.split(\".\")[0] ?? \"zzz\";\n          const bKind = b.kind?.split(\".\")[0] ?? \"zzz\";\n          return (kindOrder[aKind] ?? 3) - (kindOrder[bKind] ?? 3);\n        });\n\n        const rootDir = manager.resolvePath(\".\");\n        const outputLines: string[] = [];\n        let preferredCount = 0;\n\n        for (let i = 0; i < actions.length; i++) {\n          const action = actions[i];\n          const preferred = action.isPreferred ? \"★ \" : \"\";\n          if (action.isPreferred) preferredCount++;\n          const kindStr = action.kind ? ` [${action.kind}]` : \"\";\n          outputLines.push(`  ${i + 1}. ${preferred}${action.title}${kindStr}`);\n\n          if (action.edit) {\n            const editLines = formatEditSummary(action.edit, rootDir);\n            outputLines.push(...editLines);\n          } else if (action.command && !action.edit) {\n            outputLines.push(`     (command: ${action.command.title || action.command.command})`);\n          } else {\n            outputLines.push(\"     (resolve required)\");\n          }\n        }\n\n        // Append plain commands at the end\n        for (const cmd of commands) {\n          outputLines.push(`  • ${cmd.title} (command-only, requires IDE execution)`);\n        }\n\n        const totalCount = actions.length + commands.length;\n        const header = `${totalCount} code action(s) at ${filePath}:${line}:${character}`;\n        const preferredNote = preferredCount > 0 ? ` (${preferredCount} preferred)` : \"\";\n\n        let text = `${header}${preferredNote}\\n\\n${outputLines.join(\"\\n\")}`;\n        if (resolvedFrom) text = `${resolvedFrom}\\n\\n${text}`;\n\n        return {\n          content: [{ type: \"text\", text }],\n          details: { count: totalCount, preferredCount },\n        };\n      } catch (err: any) {\n        return {\n          content: [{ type: \"text\", text: `LSP code action request failed: ${err.message}` }],\n          details: { count: 0, preferredCount: 0 },\n        };\n      }\n    },\n\n    renderCall(args, theme) {\n      let text = theme.fg(\"toolTitle\", theme.bold(\"lsp_code_actions \"));\n      if (args.query && !args.line) {\n        text += theme.fg(\"accent\", args.path);\n        text += theme.fg(\"muted\", ` query=\"${args.query}\"`);\n      } else if (args.endLine) {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}-${args.endLine}:${args.endCharacter}`);\n      } else {\n        text += theme.fg(\"accent\", `${args.path}:${args.line}:${args.character}`);\n      }\n      if (args.kind) {\n        text += theme.fg(\"dim\", ` [${args.kind}]`);\n      }\n      return new Text(text, 0, 0);\n    },\n\n    renderResult(result, { isPartial }, theme) {\n      if (isPartial) return new Text(theme.fg(\"warning\", \"Loading...\"), 0, 0);\n      const details = result.details;\n      if (!details || details.count === 0) {\n        return new Text(theme.fg(\"dim\", \"No code actions available\"), 0, 0);\n      }\n      const preferred = details.preferredCount > 0 ? ` (${details.preferredCount} preferred)` : \"\";\n      return new Text(theme.fg(\"success\", `${details.count} action(s)${preferred}`), 0, 0);\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,259 @@
+// @ts-nocheck
+/**
+ * lsp_code_actions — Get available code actions (quick fixes, refactorings) at a position.
+ */
+import { Type } from "@sinclair/typebox";
+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";
+const CodeActionsParams = 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." })),
+    endLine: Type.Optional(Type.Number({ description: "End line for range selection (1-indexed). Defaults to line." })),
+    endCharacter: Type.Optional(Type.Number({ description: "End column for range selection (1-indexed). Defaults to character." })),
+    kind: Type.Optional(Type.String({ description: 'Filter by action kind (e.g., "quickfix", "refactor", "source")' })),
+});
+/** Check if a range contains a position (all 0-indexed) */
+function rangeContainsPosition(range, line, character) {
+    if (line < range.start.line || line > range.end.line)
+        return false;
+    if (line === range.start.line && character < range.start.character)
+        return false;
+    if (line === range.end.line && character > range.end.character)
+        return false;
+    return true;
+}
+/** Format a workspace edit's changes into readable lines */
+function formatEditSummary(edit, rootDir) {
+    const lines = [];
+    if (edit.documentChanges) {
+        for (const change of edit.documentChanges) {
+            if ("textDocument" in change && "edits" in change) {
+                let relPath;
+                try {
+                    relPath = relative(rootDir, fileURLToPath(change.textDocument.uri));
+                }
+                catch {
+                    relPath = change.textDocument.uri;
+                }
+                for (const textEdit of change.edits.slice(0, 5)) {
+                    const ln = textEdit.range.start.line + 1;
+                    const col = textEdit.range.start.character + 1;
+                    const endLn = textEdit.range.end.line + 1;
+                    const endCol = textEdit.range.end.character + 1;
+                    const newText = textEdit.newText.length > 60
+                        ? textEdit.newText.slice(0, 57) + "..."
+                        : textEdit.newText;
+                    if (textEdit.range.start.line === textEdit.range.end.line && textEdit.range.start.character === textEdit.range.end.character) {
+                        lines.push(`     ${relPath}:${ln}:${col} insert "${newText.replace(/\n/g, "\\n")}"`);
+                    }
+                    else {
+                        lines.push(`     ${relPath}:${ln}:${col}-${endLn}:${endCol} → "${newText.replace(/\n/g, "\\n")}"`);
+                    }
+                }
+                const remaining = change.edits.length - 5;
+                if (remaining > 0)
+                    lines.push(`     ... and ${remaining} more edits in ${relPath}`);
+            }
+        }
+    }
+    const changes = edit.changes ?? {};
+    for (const [uri, edits] of Object.entries(changes)) {
+        let relPath;
+        try {
+            relPath = relative(rootDir, fileURLToPath(uri));
+        }
+        catch {
+            relPath = uri;
+        }
+        for (const textEdit of edits.slice(0, 5)) {
+            const ln = textEdit.range.start.line + 1;
+            const col = textEdit.range.start.character + 1;
+            const endLn = textEdit.range.end.line + 1;
+            const endCol = textEdit.range.end.character + 1;
+            const newText = textEdit.newText.length > 60
+                ? textEdit.newText.slice(0, 57) + "..."
+                : textEdit.newText;
+            if (textEdit.range.start.line === textEdit.range.end.line && textEdit.range.start.character === textEdit.range.end.character) {
+                lines.push(`     ${relPath}:${ln}:${col} insert "${newText.replace(/\n/g, "\\n")}"`);
+            }
+            else {
+                lines.push(`     ${relPath}:${ln}:${col}-${endLn}:${endCol} → "${newText.replace(/\n/g, "\\n")}"`);
+            }
+        }
+        const remaining = edits.length - 5;
+        if (remaining > 0)
+            lines.push(`     ... and ${remaining} more edits in ${relPath}`);
+    }
+    return lines;
+}
+/** Check if a response item is a CodeAction (vs a Command) */
+function isCodeAction(item) {
+    return "kind" in item || "edit" in item || "diagnostics" in item || "isPreferred" in item;
+}
+export function createCodeActionsTool(manager, treeSitter) {
+    return {
+        name: "lsp_code_actions",
+        label: "LSP Code Actions",
+        description: "Get available code actions (quick fixes, refactorings, source actions) at a position or range. Returns actionable fixes the LSP server can suggest — auto-imports, remove unused, extract method, etc.",
+        promptSnippet: "Get available code actions (quick fixes, refactorings) at a file position via LSP. Use after lsp_diagnostics shows errors to find auto-fixes.",
+        parameters: CodeActionsParams,
+        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, preferredCount: 0 } };
+                }
+            }
+            if (line === undefined || character === undefined) {
+                return { content: [{ type: "text", text: "Either line/character or query is required." }], details: { count: 0, preferredCount: 0 } };
+            }
+            const client = await manager.getClientForFile(filePath).catch(() => null);
+            if (!client) {
+                return { content: [{ type: "text", text: manager.getUnavailableReason(filePath) }], details: { count: 0, preferredCount: 0 } };
+            }
+            // Check if server supports code actions
+            const caps = client.serverCapabilities;
+            if (caps && !caps.codeActionProvider) {
+                return {
+                    content: [{ type: "text", text: "LSP server for this file does not support code actions." }],
+                    details: { count: 0, preferredCount: 0 },
+                };
+            }
+            const uri = manager.getFileUri(filePath);
+            const startLine = line - 1;
+            const startChar = character - 1;
+            const endLine = (params.endLine ?? line) - 1;
+            const endChar = (params.endCharacter ?? character) - 1;
+            // Collect diagnostics that overlap with the requested range
+            const allDiags = client.getDiagnostics(uri) ?? [];
+            const rangeDiags = allDiags.filter((d) => rangeContainsPosition(d.range, startLine, startChar) ||
+                rangeContainsPosition({ start: { line: startLine, character: startChar }, end: { line: endLine, character: endChar } }, d.range.start.line, d.range.start.character));
+            try {
+                const response = await client.sendRequest("textDocument/codeAction", {
+                    textDocument: { uri },
+                    range: {
+                        start: { line: startLine, character: startChar },
+                        end: { line: endLine, character: endChar },
+                    },
+                    context: {
+                        diagnostics: rangeDiags,
+                        only: params.kind ? [params.kind] : undefined,
+                    },
+                });
+                if (!response || response.length === 0) {
+                    const text = resolvedFrom
+                        ? `${resolvedFrom}\n\nNo code actions available at this position.`
+                        : "No code actions available at this position.";
+                    return { content: [{ type: "text", text }], details: { count: 0, preferredCount: 0 } };
+                }
+                // Separate CodeActions from Commands, sort: preferred first, then by kind
+                const actions = [];
+                const commands = [];
+                for (const item of response) {
+                    if (isCodeAction(item)) {
+                        actions.push(item);
+                    }
+                    else {
+                        commands.push(item);
+                    }
+                }
+                // Sort: preferred first, then quickfix > refactor > source > other
+                const kindOrder = { quickfix: 0, refactor: 1, source: 2 };
+                actions.sort((a, b) => {
+                    if (a.isPreferred && !b.isPreferred)
+                        return -1;
+                    if (!a.isPreferred && b.isPreferred)
+                        return 1;
+                    const aKind = a.kind?.split(".")[0] ?? "zzz";
+                    const bKind = b.kind?.split(".")[0] ?? "zzz";
+                    return (kindOrder[aKind] ?? 3) - (kindOrder[bKind] ?? 3);
+                });
+                const rootDir = manager.resolvePath(".");
+                const outputLines = [];
+                let preferredCount = 0;
+                for (let i = 0; i < actions.length; i++) {
+                    const action = actions[i];
+                    const preferred = action.isPreferred ? "★ " : "";
+                    if (action.isPreferred)
+                        preferredCount++;
+                    const kindStr = action.kind ? ` [${action.kind}]` : "";
+                    outputLines.push(`  ${i + 1}. ${preferred}${action.title}${kindStr}`);
+                    if (action.edit) {
+                        const editLines = formatEditSummary(action.edit, rootDir);
+                        outputLines.push(...editLines);
+                    }
+                    else if (action.command && !action.edit) {
+                        outputLines.push(`     (command: ${action.command.title || action.command.command})`);
+                    }
+                    else {
+                        outputLines.push("     (resolve required)");
+                    }
+                }
+                // Append plain commands at the end
+                for (const cmd of commands) {
+                    outputLines.push(`  • ${cmd.title} (command-only, requires IDE execution)`);
+                }
+                const totalCount = actions.length + commands.length;
+                const header = `${totalCount} code action(s) at ${filePath}:${line}:${character}`;
+                const preferredNote = preferredCount > 0 ? ` (${preferredCount} preferred)` : "";
+                let text = `${header}${preferredNote}\n\n${outputLines.join("\n")}`;
+                if (resolvedFrom)
+                    text = `${resolvedFrom}\n\n${text}`;
+                return {
+                    content: [{ type: "text", text }],
+                    details: { count: totalCount, preferredCount },
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `LSP code action request failed: ${err.message}` }],
+                    details: { count: 0, preferredCount: 0 },
+                };
+            }
+        },
+        renderCall(args, theme) {
+            let text = theme.fg("toolTitle", theme.bold("lsp_code_actions "));
+            if (args.query && !args.line) {
+                text += theme.fg("accent", args.path);
+                text += theme.fg("muted", ` query="${args.query}"`);
+            }
+            else if (args.endLine) {
+                text += theme.fg("accent", `${args.path}:${args.line}:${args.character}-${args.endLine}:${args.endCharacter}`);
+            }
+            else {
+                text += theme.fg("accent", `${args.path}:${args.line}:${args.character}`);
+            }
+            if (args.kind) {
+                text += theme.fg("dim", ` [${args.kind}]`);
+            }
+            return new Text(text, 0, 0);
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return new Text(theme.fg("warning", "Loading..."), 0, 0);
+            const details = result.details;
+            if (!details || details.count === 0) {
+                return new Text(theme.fg("dim", "No code actions available"), 0, 0);
+            }
+            const preferred = details.preferredCount > 0 ? ` (${details.preferredCount} preferred)` : "";
+            return new Text(theme.fg("success", `${details.count} action(s)${preferred}`), 0, 0);
+        },
+    };
+}
+//# sourceMappingURL=code-actions.js.map