openfox 2.0.37 → 2.0.39

package/dist/{chunk-DAC7YKYW.js → chunk-P4SOUTLD.js}

@@ -2,7 +2,7 @@ import {
   injectWorkflowKickoffIfNeeded,
   runAgentTurn,
   runChatTurn
-} from "./chunk-QG2WM7EX.js";
+} from "./chunk-BG5ILIWN.js";
 import {
   applyDynamicContext,
   checkAborted,
@@ -16,7 +16,7 @@ import {
   loadAllAgentsDefault,
   saveItemToDir,
   spawnShellProcess
-} from "./chunk-BJPPDLJX.js";
+} from "./chunk-UR4A2HYT.js";
 import {
   getPlatformShell,
   onProcessEvent
@@ -2056,4 +2056,4 @@ export {
   signalMcpReady,
   createWebSocketServer
 };
-//# sourceMappingURL=chunk-DAC7YKYW.js.map
+//# sourceMappingURL=chunk-P4SOUTLD.js.map

package/dist/{chunk-BJPPDLJX.js → chunk-UR4A2HYT.js}

@@ -71,7 +71,7 @@ import {
 import {
   loadGlobalConfig,
   saveGlobalConfig
-} from "./chunk-PWY6EBZ6.js";
+} from "./chunk-EZ3BPIUV.js";
 import {
   getGlobalConfigDir
 } from "./chunk-CQGTEGKL.js";
@@ -2938,7 +2938,7 @@ async function describeImageFromDataUrl(dataUrl, visionModel, options) {
 import { createHash as createHash2 } from "crypto";
 async function loadVisionModelFromGlobalConfig() {
   try {
-    const { loadGlobalConfig: loadGlobalConfig2, getVisionFallback } = await import("./config-QI3KOU42.js");
+    const { loadGlobalConfig: loadGlobalConfig2, getVisionFallback } = await import("./config-XOXIIBUY.js");
     const runtimeConfig = getRuntimeConfig();
     const mode = runtimeConfig.mode ?? "production";
     const globalConfig = await loadGlobalConfig2(mode);
@@ -3452,7 +3452,7 @@ var callSubAgentTool = {
       };
     }
     try {
-      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-JPKBLAQ5.js");
+      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-ZYUJUI4R.js");
       const toolRegistry = getToolRegistryForAgent2(agentDef);
       const turnMetrics = new TurnMetrics();
       const result = await executeSubAgent({
@@ -4268,7 +4268,7 @@ function resolveAgentDef2(sessionManager, sessionId) {
 }
 async function buildCachedPrompt(sessionManager, sessionId, agentDef) {
   const { instructionContent, skills } = await loadSessionContext(sessionManager, sessionId);
-  const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-JPKBLAQ5.js");
+  const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-ZYUJUI4R.js");
   const tools = getToolRegistryForAgent2(agentDef).definitions;
   const toolFingerprint = getToolFingerprint(tools);
   const allAgents = await loadAllAgentsDefault();
@@ -4281,7 +4281,7 @@ async function buildCachedPrompt(sessionManager, sessionId, agentDef) {
 async function computeSessionHash(sessionManager, sessionId) {
   const { instructionContent, skills } = await loadSessionContext(sessionManager, sessionId);
   const agentDef = await resolveAgentDef2(sessionManager, sessionId);
-  const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-JPKBLAQ5.js");
+  const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-ZYUJUI4R.js");
   const tools = getToolRegistryForAgent2(agentDef).definitions;
   const toolFingerprint = getToolFingerprint(tools);
   return computeDynamicContextHash(instructionContent, skills, toolFingerprint);
@@ -4388,7 +4388,7 @@ var mcpConfigTool = createTool(
       await saveGlobalConfig(mcpConfigMode, { ...globalConfig, mcpServers: updated });
     }
     async function rebuildTools() {
-      const { setMcpTools: setMcpTools2 } = await import("./tools-JPKBLAQ5.js");
+      const { setMcpTools: setMcpTools2 } = await import("./tools-ZYUJUI4R.js");
       const mcpTools = createMcpTools(mcpManagerForTools);
       setMcpTools2(mcpTools);
     }
@@ -4401,9 +4401,10 @@ var mcpConfigTool = createTool(
       for (const server of servers) {
         const connStr = server.status === "connected" ? "\u25CF" : server.status === "error" ? "\u2717" : "\u25CB";
         const cmdStr = server.config.command ? `${server.config.command} ${(server.config.args ?? []).join(" ")}` : server.config.url ?? "";
-        lines.push(
-          `${connStr} ${server.name} (${server.config.transport}) \u2014 ${server.status}${server.error ? `: ${server.error}` : ""}`
-        );
+        const hasCachedTools = server.tools.length > 0;
+        const sourceLabel = server.status === "connected" ? " (live)" : hasCachedTools ? " (from cache)" : "";
+        const statusLine = server.error ? `${server.status}${sourceLabel}: ${server.error}` : `${server.status}${sourceLabel}`;
+        lines.push(`${connStr} ${server.name} (${server.config.transport}) \u2014 ${statusLine}`);
         lines.push(`  ${cmdStr}`);
         lines.push(`  ${server.tools.length} tools, ~${server.estimatedTokens} tokens`);
         const enabledTools = server.tools.filter((t) => t.enabled);
@@ -4488,6 +4489,270 @@ var mcpConfigTool = createTool(
   }
 );
 
+// src/server/tools/trace-code.ts
+import { stat as stat2, readFile as readFile8 } from "fs/promises";
+function graphNode(location, depth, relation, symbolName, symbolKind) {
+  const node = { location, depth, relation, symbolName };
+  if (symbolKind) node.symbolKind = symbolKind;
+  return node;
+}
+var MAX_DEPTH = 5;
+var VALID_DIRECTIONS = ["up", "down", "both"];
+var SNIPPET_RADIUS = 2;
+var CACHE_MAX_SIZE = 50;
+function locationKey(loc) {
+  return `${loc.path}:${loc.line}:${loc.character}`;
+}
+function formatLocation(loc, workdir) {
+  const relPath = loc.path.startsWith(workdir) ? loc.path.slice(workdir.length + 1) : loc.path;
+  return `${relPath}:${loc.line + 1}:${loc.character}`;
+}
+var fileCache = /* @__PURE__ */ new Map();
+async function getCachedLines(path, approvedPaths) {
+  if (!approvedPaths.has(path)) return [];
+  const cached = fileCache.get(path);
+  if (cached) {
+    try {
+      const stats = await stat2(path);
+      if (stats.mtimeMs === cached.mtimeMs) {
+        return cached.lines;
+      }
+    } catch {
+    }
+  }
+  try {
+    const stats = await stat2(path);
+    const content = await readFile8(path, "utf-8");
+    const lines = content.split("\n");
+    fileCache.set(path, { mtimeMs: stats.mtimeMs, lines });
+    if (fileCache.size > CACHE_MAX_SIZE) {
+      const oldest = fileCache.keys().next();
+      if (!oldest.done && oldest.value !== void 0) {
+        fileCache.delete(oldest.value);
+      }
+    }
+    return lines;
+  } catch {
+    return [];
+  }
+}
+async function getSnippet(path, line, approvedPaths, radius = SNIPPET_RADIUS) {
+  const lines = await getCachedLines(path, approvedPaths);
+  if (lines.length === 0) return "";
+  const start = Math.max(0, line - radius);
+  const end = Math.min(lines.length - 1, line + radius);
+  const lineNumWidth = String(end + 1).length;
+  const result = [];
+  for (let i = start; i <= end; i++) {
+    const gutter = i === line ? ">" : " ";
+    const lineNum = String(i + 1).padStart(lineNumWidth);
+    result.push(`${gutter} ${lineNum}\u2502 ${lines[i] ?? ""}`);
+  }
+  return result.join("\n");
+}
+function formatEdgeLabel(relation) {
+  switch (relation) {
+    case "definition":
+      return "definition";
+    case "references":
+      return "reference";
+    case "type-definition":
+      return "type definition";
+    default:
+      return relation;
+  }
+}
+async function collectNodes(lsp, startLocations, symbolName, symbolKind, maxDepth, direction) {
+  const visited = /* @__PURE__ */ new Set();
+  const nodes = [];
+  const edges = [];
+  const queue = startLocations.map((loc) => ({ location: loc, depth: 0, relation: "match" }));
+  let idx = 0;
+  while (idx < queue.length) {
+    const item = queue[idx];
+    idx++;
+    const key = locationKey(item.location);
+    if (visited.has(key)) continue;
+    visited.add(key);
+    nodes.push(graphNode(item.location, item.depth, item.relation, symbolName, symbolKind));
+    if (item.parentKey) {
+      const relation = item.relation === "definition" ? "definition" : item.relation === "type-definition" ? "type-definition" : "references";
+      edges.push({ from: item.parentKey, to: key, relation });
+    }
+    if (item.depth >= maxDepth) continue;
+    const { path, line, character } = item.location;
+    if (direction === "down" || direction === "both") {
+      const defs = await lsp.getDefinition(path, line, character);
+      for (const def of defs) {
+        const defKey = locationKey(def);
+        if (!visited.has(defKey)) {
+          queue.push({ location: def, depth: item.depth + 1, relation: "definition", parentKey: key });
+        }
+      }
+      const typeDefs = await lsp.getTypeDefinition(path, line, character);
+      for (const td of typeDefs) {
+        const tdKey = locationKey(td);
+        if (!visited.has(tdKey)) {
+          queue.push({ location: td, depth: item.depth + 1, relation: "type-definition", parentKey: key });
+        }
+      }
+    }
+    if (direction === "up" || direction === "both") {
+      const refs = await lsp.getReferences(path, line, character);
+      for (const ref of refs) {
+        const refKey = locationKey(ref);
+        if (!visited.has(refKey)) {
+          queue.push({ location: ref, depth: item.depth + 1, relation: "reference", parentKey: key });
+        }
+      }
+    }
+  }
+  return { nodes, edges };
+}
+async function formatOutput(symbolName, direction, depth, nodes, edges, workdir, approvedPaths) {
+  const lines = [];
+  lines.push(`Symbol: ${symbolName}`);
+  lines.push(`Direction: ${direction} | Depth: ${depth}`);
+  lines.push(`Nodes: ${nodes.length} | Edges: ${edges.length}`);
+  lines.push("");
+  if (nodes.length === 0) {
+    lines.push("No results found.");
+    return lines.join("\n");
+  }
+  const byDepth = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const group = byDepth.get(node.depth) ?? [];
+    group.push(node);
+    byDepth.set(node.depth, group);
+  }
+  for (const [depth2, group] of [...byDepth.entries()].sort(([a], [b]) => a - b)) {
+    lines.push(`\u2500\u2500 Depth ${depth2} \u2500\u2500`);
+    const fileGroups = /* @__PURE__ */ new Map();
+    for (const node of group) {
+      const fileKey = node.location.path;
+      const fileGroup = fileGroups.get(fileKey) ?? [];
+      fileGroup.push(node);
+      fileGroups.set(fileKey, fileGroup);
+    }
+    for (const [filePath, fileNodes] of fileGroups) {
+      const relPath = filePath.startsWith(workdir) ? filePath.slice(workdir.length + 1) : filePath;
+      if (fileNodes.length > 5) {
+        const kinds = [...new Set(fileNodes.map((n) => formatEdgeLabel(n.relation)))];
+        lines.push(`  ${kinds.join(", ")} \xD7 ${fileNodes.length} in ${relPath}`);
+      } else {
+        for (const node of fileNodes) {
+          const label = formatEdgeLabel(node.relation);
+          const kind = node.symbolKind ? ` (${node.symbolKind})` : "";
+          const loc = formatLocation(node.location, workdir);
+          lines.push(`  ${label}: ${loc}${kind}`);
+          const snippet = await getSnippet(node.location.path, node.location.line, approvedPaths);
+          if (snippet) {
+            for (const snipLine of snippet.split("\n")) {
+              lines.push(`    ${snipLine}`);
+            }
+          }
+        }
+      }
+    }
+    lines.push("");
+  }
+  if (edges.length > 0 && edges.length <= 20) {
+    lines.push("Edges:");
+    for (const edge of edges) {
+      lines.push(`  ${edge.from} \u2500\u2500${edge.relation}\u2500\u2500\u25B6 ${edge.to}`);
+    }
+    lines.push("");
+  } else if (edges.length > 20) {
+    lines.push(`Edges: ${edges.length} total (suppressed, too many to display individually)`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+var traceCodeTool = createTool(
+  "trace_code",
+  {
+    type: "function",
+    function: {
+      name: "trace_code",
+      description: "Trace a symbol through the codebase using LSP-powered static analysis. Finds definitions, references, and type definitions up to a configurable depth. Returns a graph of locations with inline code snippets for each node.",
+      parameters: {
+        type: "object",
+        properties: {
+          symbol: {
+            type: "string",
+            description: 'Symbol name to trace (e.g., "rebuildTools", "handleSubmit", "UserProfile")'
+          },
+          file: {
+            type: "string",
+            description: "File path containing the symbol. Used to seed the LSP server and detect the language. Relative to the working directory."
+          },
+          depth: {
+            type: "number",
+            description: "Graph traversal depth (default: 1, max: 5). How many hops to follow. Start with 1 for immediate defs+refs.",
+            default: 1
+          },
+          direction: {
+            type: "string",
+            enum: ["up", "down", "both"],
+            description: '"down" follows definitions, "up" finds references, "both" does both (default).',
+            default: "both"
+          }
+        },
+        required: ["symbol", "file"]
+      }
+    }
+  },
+  async (args, context, helpers) => {
+    const symbol = args.symbol?.trim();
+    if (!symbol) {
+      return helpers.error("symbol is required");
+    }
+    const file = args.file?.trim();
+    if (!file) {
+      return helpers.error("file is required");
+    }
+    const depth = args.depth ?? 1;
+    if (depth > MAX_DEPTH) {
+      return helpers.error(`depth cannot exceed ${MAX_DEPTH}`);
+    }
+    const direction = args.direction ?? "both";
+    if (!VALID_DIRECTIONS.includes(direction)) {
+      return helpers.error(`direction must be one of: ${VALID_DIRECTIONS.join(", ")}`);
+    }
+    const lsp = context.lspManager;
+    if (!lsp) {
+      return helpers.error("LSP is not available. The trace_code tool requires a running LSP server.");
+    }
+    const fullPath = helpers.resolvePath(file);
+    try {
+      await stat2(fullPath);
+    } catch {
+      return helpers.error(`File not found: "${file}". Check that the path exists.`);
+    }
+    let symbols;
+    try {
+      symbols = await lsp.seedAndFindWorkspaceSymbol(symbol, fullPath);
+    } catch {
+      return helpers.error(`Failed to search for symbol "${symbol}". LSP may not be responding.`);
+    }
+    if (symbols.length === 0) {
+      const installHint = lsp.getInstallHint(fullPath);
+      const hint = installHint ? ` ${installHint}` : "";
+      return helpers.error(
+        `Symbol "${symbol}" not found in "${file}". Check that the symbol name is correct and that the LSP server has indexed the project.${hint}`
+      );
+    }
+    const startLocations = symbols.map((s) => s.location);
+    const symbolKind = symbols[0].kind;
+    const { nodes, edges } = await collectNodes(lsp, startLocations, symbol, symbolKind, depth, direction);
+    const allPaths = [...new Set(nodes.map((n) => n.location.path))];
+    await helpers.checkPathAccess(allPaths);
+    const approvedPaths = new Set(allPaths);
+    const output = await formatOutput(symbol, direction, depth, nodes, edges, context.workdir, approvedPaths);
+    return helpers.success(output);
+  }
+);
+
 // src/server/tools/index.ts
 var _builtInTools;
 function getBuiltInTools() {
@@ -4506,7 +4771,8 @@ function getBuiltInTools() {
       devServerTool,
       stepDoneTool,
       backgroundProcessTool,
-      mcpConfigTool
+      mcpConfigTool,
+      traceCodeTool
     ];
   }
   return _builtInTools;
@@ -4792,4 +5058,4 @@ export {
   getToolRegistryForAgent,
   createToolRegistry
 };
-//# sourceMappingURL=chunk-BJPPDLJX.js.map
+//# sourceMappingURL=chunk-UR4A2HYT.js.map

package/dist/cli/dev.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "../chunk-PKE4MQWI.js";
+} from "../chunk-4RYP3RBY.js";
 import {
   logger
 } from "../chunk-K44MW7JJ.js";

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "../chunk-PKE4MQWI.js";
+} from "../chunk-4RYP3RBY.js";
 import {
   logger
 } from "../chunk-K44MW7JJ.js";

package/dist/{config-QI3KOU42.js → config-XOXIIBUY.js}

@@ -13,7 +13,7 @@ import {
   saveGlobalConfig,
   setDefaultModelSelection,
   updateProvider
-} from "./chunk-PWY6EBZ6.js";
+} from "./chunk-EZ3BPIUV.js";
 import "./chunk-CQGTEGKL.js";
 export {
   activateProvider,
@@ -31,4 +31,4 @@ export {
   setDefaultModelSelection,
   updateProvider
 };
-//# sourceMappingURL=config-QI3KOU42.js.map
+//# sourceMappingURL=config-XOXIIBUY.js.map

package/dist/{orchestrator-PTKTND5E.js → orchestrator-7B3XOZ4T.js}

@@ -2,8 +2,8 @@ import {
   injectWorkflowKickoffIfNeeded,
   runAgentTurn,
   runChatTurn
-} from "./chunk-QG2WM7EX.js";
-import "./chunk-BJPPDLJX.js";
+} from "./chunk-BG5ILIWN.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -28,7 +28,7 @@ import "./chunk-Z4FMBCJO.js";
 import "./chunk-Z6W4YHJB.js";
 import "./chunk-K44MW7JJ.js";
 import "./chunk-YD6NDTKF.js";
-import "./chunk-PWY6EBZ6.js";
+import "./chunk-EZ3BPIUV.js";
 import "./chunk-CQGTEGKL.js";
 import "./chunk-V4IE7HJY.js";
 export {
@@ -42,4 +42,4 @@ export {
   runAgentTurn,
   runChatTurn
 };
-//# sourceMappingURL=orchestrator-PTKTND5E.js.map
+//# sourceMappingURL=orchestrator-7B3XOZ4T.js.map

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfox",
-  "version": "2.0.37",
+  "version": "2.0.39",
   "description": "Local-LLM-first agentic coding assistant",
   "type": "module",
   "bin": {

package/dist/{processor-D6HYPRZD.js → processor-FB2I73B3.js}

@@ -3,7 +3,7 @@ import {
   finalizeTurnCompletion,
   generateSessionNameForSession
 } from "./chunk-JGNAYJJZ.js";
-import "./chunk-BJPPDLJX.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -28,7 +28,7 @@ import {
   logger
 } from "./chunk-K44MW7JJ.js";
 import "./chunk-YD6NDTKF.js";
-import "./chunk-PWY6EBZ6.js";
+import "./chunk-EZ3BPIUV.js";
 import "./chunk-CQGTEGKL.js";
 import "./chunk-V4IE7HJY.js";
 
@@ -171,7 +171,7 @@ var QueueProcessor = class {
       backend: provider?.backend ?? llmClient.getBackend(),
       model: llmClient.getModel()
     };
-    const { runChatTurn } = await import("./orchestrator-PTKTND5E.js");
+    const { runChatTurn } = await import("./orchestrator-7B3XOZ4T.js");
     const runChatTurnParams = buildRunChatTurnParams({
       sessionManager,
       sessionId,
@@ -216,4 +216,4 @@ var QueueProcessor = class {
 export {
   QueueProcessor
 };
-//# sourceMappingURL=processor-D6HYPRZD.js.map
+//# sourceMappingURL=processor-FB2I73B3.js.map

package/dist/{provider-ZLMMOORK.js → provider-JLLIB72V.js}

@@ -18,7 +18,7 @@ import {
   loadGlobalConfig,
   removeProvider,
   saveGlobalConfig
-} from "./chunk-PWY6EBZ6.js";
+} from "./chunk-EZ3BPIUV.js";
 import "./chunk-CQGTEGKL.js";
 import "./chunk-V4IE7HJY.js";
 
@@ -260,7 +260,7 @@ async function runProviderAdd(mode) {
     isActive: makeActive
   });
   if (makeActive) {
-    const { setDefaultModelSelection } = await import("./config-QI3KOU42.js");
+    const { setDefaultModelSelection } = await import("./config-XOXIIBUY.js");
     newConfig = setDefaultModelSelection(
       newConfig,
       newConfig.providers[newConfig.providers.length - 1].id,
@@ -388,4 +388,4 @@ export {
   runProviderRemove,
   runProviderUse
 };
-//# sourceMappingURL=provider-ZLMMOORK.js.map
+//# sourceMappingURL=provider-JLLIB72V.js.map

package/dist/{serve-NGAWODZ2.js → serve-RZWSK3AA.js}

@@ -1,10 +1,10 @@
 import {
   VERSION,
   createServer
-} from "./chunk-2G2H4HUO.js";
-import "./chunk-DAC7YKYW.js";
-import "./chunk-QG2WM7EX.js";
-import "./chunk-BJPPDLJX.js";
+} from "./chunk-BMRC6TQ5.js";
+import "./chunk-P4SOUTLD.js";
+import "./chunk-BG5ILIWN.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -37,7 +37,7 @@ import {
   getActiveProvider,
   getDefaultModel,
   loadGlobalConfig
-} from "./chunk-PWY6EBZ6.js";
+} from "./chunk-EZ3BPIUV.js";
 import {
   ensureDataDirExists,
   getDatabasePath,
@@ -199,4 +199,4 @@ async function runServe(options) {
 export {
   runServe
 };
-//# sourceMappingURL=serve-NGAWODZ2.js.map
+//# sourceMappingURL=serve-RZWSK3AA.js.map

package/dist/server/index.d.ts

@@ -118,6 +118,33 @@ interface LLMClientWithModel extends LLMClient {
     setBackend(backend: Backend): void;
 }
 
+interface CodeLocation {
+    path: string;
+    line: number;
+    character: number;
+    endLine: number;
+    endCharacter: number;
+}
+interface SymbolInfo {
+    name: string;
+    kind: string;
+    location: CodeLocation;
+    containerName?: string;
+}
+interface HoverInfo {
+    contents: string;
+    range?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+
 interface LspManagerInterface {
     /**
      * Notify the LSP that a file has changed and get diagnostics
@@ -136,6 +163,34 @@ interface LspManagerInterface {
      * Get installation hint for a file's language server, if it's not installed
      */
     getInstallHint(path: string): string | null;
+    /**
+     * Find the definition of a symbol at the given position
+     */
+    getDefinition(path: string, line: number, character: number): Promise<CodeLocation[]>;
+    /**
+     * Find all references to a symbol at the given position
+     */
+    getReferences(path: string, line: number, character: number): Promise<CodeLocation[]>;
+    /**
+     * Find the type definition of a symbol at the given position
+     */
+    getTypeDefinition(path: string, line: number, character: number): Promise<CodeLocation[]>;
+    /**
+     * Search workspace for a symbol by name
+     */
+    findWorkspaceSymbol(query: string): Promise<SymbolInfo[]>;
+    /**
+     * Open a file to seed the LSP server, then search for a workspace symbol.
+     * Some LSP servers (e.g., typescript-language-server) only index projects
+     * after a file is opened via textDocument/didOpen. This method handles
+     * that by opening the given file first, flushing the notification queue,
+     * then querying workspace/symbol.
+     */
+    seedAndFindWorkspaceSymbol(query: string, filePath: string): Promise<SymbolInfo[]>;
+    /**
+     * Get hover information for a symbol at the given position
+     */
+    getHoverInfo(path: string, line: number, character: number): Promise<HoverInfo | null>;
     /**
      * Shutdown all LSP servers
      */
@@ -242,6 +297,39 @@ declare class LspManager implements LspManagerInterface {
      * to avoid spamming the user on every edit.
      */
     getInstallHint(path: string): string | null;
+    /**
+     * Find the definition of a symbol at the given position.
+     */
+    getDefinition(path: string, line: number, character: number): Promise<CodeLocation[]>;
+    /**
+     * Find all references to a symbol at the given position.
+     */
+    getReferences(path: string, line: number, character: number): Promise<CodeLocation[]>;
+    /**
+     * Find the type definition of a symbol at the given position.
+     */
+    getTypeDefinition(path: string, line: number, character: number): Promise<CodeLocation[]>;
+    /**
+     * Search workspace for a symbol by name.
+     * Uses the first available server that supports workspace/symbol.
+     */
+    findWorkspaceSymbol(query: string): Promise<SymbolInfo[]>;
+    /**
+     * Open a file to seed the LSP server, then search for a workspace symbol.
+     *
+     * Some LSP servers (e.g., typescript-language-server) only index projects
+     * after a file is opened via textDocument/didOpen. This method:
+     * 1. Detects the language from the file and starts the appropriate server
+     * 2. Reads the file from disk and sends didOpen to trigger project indexing
+     * 3. Sends a hover request to flush the notification queue (JSON-RPC processes
+     *    requests sequentially, so the server must finish didOpen before responding)
+     * 4. Queries workspace/symbol for the given symbol
+     */
+    seedAndFindWorkspaceSymbol(query: string, filePath: string): Promise<SymbolInfo[]>;
+    /**
+     * Get hover information for a symbol at the given position.
+     */
+    getHoverInfo(path: string, line: number, character: number): Promise<HoverInfo | null>;
     /**
      * Shutdown all LSP servers.
      */

package/dist/server/index.js

@@ -1,10 +1,10 @@
 import {
   createServer,
   createServerHandle
-} from "../chunk-2G2H4HUO.js";
-import "../chunk-DAC7YKYW.js";
-import "../chunk-QG2WM7EX.js";
-import "../chunk-BJPPDLJX.js";
+} from "../chunk-BMRC6TQ5.js";
+import "../chunk-P4SOUTLD.js";
+import "../chunk-BG5ILIWN.js";
+import "../chunk-UR4A2HYT.js";
 import "../chunk-DL6ZILAF.js";
 import "../chunk-PBGOZMVY.js";
 import "../chunk-VRGRAQDG.js";
@@ -29,7 +29,7 @@ import "../chunk-IEDE6VK4.js";
 import "../chunk-K44MW7JJ.js";
 import "../chunk-VUQCQXXJ.js";
 import "../chunk-YD6NDTKF.js";
-import "../chunk-PWY6EBZ6.js";
+import "../chunk-EZ3BPIUV.js";
 import "../chunk-CQGTEGKL.js";
 import "../chunk-V4IE7HJY.js";
 export {