openfox 2.0.38 → 2.0.39

package/dist/agent-defaults/builder.agent.md

@@ -16,6 +16,8 @@ allowedTools:
   - load_skill
   - dev_server
   - background_process
+  - trace_code
+  - mcp_config
 ---
 
 # Build Mode

package/dist/agent-defaults/code-reviewer.agent.md

@@ -9,6 +9,7 @@ allowedTools:
   - run_command
   - web_fetch
   - session_metadata
+  - trace_code
 ---
 
 You are a code reviewer. Review the **git diff** of the modified files rather than reading the full files.

package/dist/agent-defaults/explorer.agent.md

@@ -8,6 +8,7 @@ allowedTools:
   - read_file
   - run_command
   - web_fetch
+  - trace_code
 ---
 
 You are a codebase exploration expert.

package/dist/agent-defaults/planner.agent.md

@@ -15,6 +15,7 @@ allowedTools:
   - background_process
   - mcp_config
   - dev_server
+  - trace_code
 ---
 
 # Plan Mode

package/dist/{chat-handler-TPKAEATB.js → chat-handler-4YZGM7V7.js}

@@ -5,8 +5,8 @@ import {
 } from "./chunk-JGNAYJJZ.js";
 import {
   runChatTurn
-} from "./chunk-FFQCZ2MI.js";
-import "./chunk-HJ7KRYWX.js";
+} from "./chunk-BG5ILIWN.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -145,4 +145,4 @@ export {
   startChatSession,
   stopSessionExecution
 };
-//# sourceMappingURL=chat-handler-TPKAEATB.js.map
+//# sourceMappingURL=chat-handler-4YZGM7V7.js.map

package/dist/{chunk-7W2WATAO.js → chunk-4RYP3RBY.js}

@@ -202,7 +202,7 @@ async function runCli(options) {
       if (!configExists) {
         await runNetworkSetup(mode);
       }
-      const { runServe } = await import("./serve-VIWHYE6X.js");
+      const { runServe } = await import("./serve-RZWSK3AA.js");
       const serveOptions = { mode };
       if (values.port) serveOptions.port = parseInt(values.port);
       if (values["no-browser"] === true) serveOptions.openBrowser = false;
@@ -214,4 +214,4 @@ async function runCli(options) {
 export {
   runCli
 };
-//# sourceMappingURL=chunk-7W2WATAO.js.map
+//# sourceMappingURL=chunk-4RYP3RBY.js.map

package/dist/{chunk-FFQCZ2MI.js → chunk-BG5ILIWN.js}

@@ -12,7 +12,7 @@ import {
   loadAllAgentsDefault,
   processEventsForConversation,
   runTopLevelAgentLoop
-} from "./chunk-HJ7KRYWX.js";
+} from "./chunk-UR4A2HYT.js";
 import {
   TurnMetrics,
   WORKFLOW_KICKOFF_PROMPT,
@@ -310,4 +310,4 @@ export {
   runAgentTurn,
   injectWorkflowKickoffIfNeeded
 };
-//# sourceMappingURL=chunk-FFQCZ2MI.js.map
+//# sourceMappingURL=chunk-BG5ILIWN.js.map

package/dist/{chunk-ATBNY4CL.js → chunk-BMRC6TQ5.js}

@@ -21,7 +21,7 @@ import {
   tokenFromPassword,
   verifyPassword,
   workflowExists
-} from "./chunk-GZZW4XSI.js";
+} from "./chunk-P4SOUTLD.js";
 import {
   agentExists,
   createToolRegistry,
@@ -61,7 +61,7 @@ import {
   setMcpTools,
   setNotifyMcpServersChanged,
   skillExists
-} from "./chunk-HJ7KRYWX.js";
+} from "./chunk-UR4A2HYT.js";
 import {
   getPathSeparator,
   isAbsolutePath
@@ -148,7 +148,7 @@ import {
 import express from "express";
 import cors from "cors";
 import { createServer as createHttpServer } from "http";
-import { fileURLToPath as fileURLToPath4 } from "url";
+import { fileURLToPath as fileURLToPath5 } from "url";
 import { dirname as dirname5, resolve as resolve3, join as join5 } from "path";
 import { readFile } from "fs/promises";
 import { createServer as createViteServer } from "vite";
@@ -1594,6 +1594,7 @@ var McpManager = class {
 // src/server/lsp/server.ts
 import { spawn } from "child_process";
 import { extname } from "path";
+import { fileURLToPath } from "url";
 import { createMessageConnection, StreamMessageReader, StreamMessageWriter } from "vscode-jsonrpc/node.js";
 var LSP = {
   initialize: "initialize",
@@ -1603,7 +1604,12 @@ var LSP = {
   didOpen: "textDocument/didOpen",
   didChange: "textDocument/didChange",
   didClose: "textDocument/didClose",
-  publishDiagnostics: "textDocument/publishDiagnostics"
+  publishDiagnostics: "textDocument/publishDiagnostics",
+  definition: "textDocument/definition",
+  references: "textDocument/references",
+  typeDefinition: "textDocument/typeDefinition",
+  hover: "textDocument/hover",
+  workspaceSymbol: "workspace/symbol"
 };
 var DiagnosticSeverity = {
   Error: 1,
@@ -1611,7 +1617,38 @@ var DiagnosticSeverity = {
   Information: 3,
   Hint: 4
 };
+function hoverInfo(contents, range) {
+  return range ? { contents, range } : { contents };
+}
 var DIAGNOSTIC_WAIT_MS = 2e3;
+var SYMBOL_KIND_NAMES = {
+  1: "File",
+  2: "Module",
+  3: "Namespace",
+  4: "Package",
+  5: "Class",
+  6: "Method",
+  7: "Property",
+  8: "Field",
+  9: "Constructor",
+  10: "Enum",
+  11: "Interface",
+  12: "Function",
+  13: "Variable",
+  14: "Constant",
+  15: "String",
+  16: "Number",
+  17: "Boolean",
+  18: "Array",
+  19: "Object",
+  20: "Key",
+  21: "Null",
+  22: "EnumMember",
+  23: "Struct",
+  24: "Event",
+  25: "Operator",
+  26: "TypeParameter"
+};
 function mapSeverity(severity) {
   switch (severity) {
     case DiagnosticSeverity.Error:
@@ -1906,6 +1943,174 @@ var LspServer = class {
     return () => this.diagnosticsCallbacks.delete(callback);
   }
   // ============================================================================
+  // Code Navigation Queries
+  // ============================================================================
+  /**
+   * Convert a file:// URI to a local path.
+   * Handles Windows paths (file:///C:/...) and URL-encoded characters.
+   */
+  uriToPath(uri) {
+    try {
+      return fileURLToPath(uri);
+    } catch {
+      return uri.replace(/^file:\/\//, "");
+    }
+  }
+  /**
+   * Convert a local path to a file:// URI.
+   */
+  pathToUri(path) {
+    return `file://${path}`;
+  }
+  /**
+   * Convert an LSP location to our internal CodeLocation.
+   */
+  toCodeLocation(loc) {
+    return {
+      path: this.uriToPath(loc.uri),
+      line: loc.range.start.line,
+      character: loc.range.start.character,
+      endLine: loc.range.end.line,
+      endCharacter: loc.range.end.character
+    };
+  }
+  /**
+   * Ensure the server is running before making a query.
+   */
+  requireConnection() {
+    if (this.state !== "running" || !this.connection) {
+      throw new Error("LSP server is not running");
+    }
+    return this.connection;
+  }
+  /**
+   * Normalize a single Location or Location[] response into CodeLocation[].
+   */
+  normalizeLocations(response) {
+    if (!response) return [];
+    if (Array.isArray(response)) {
+      return response.map((loc) => this.toCodeLocation(loc));
+    }
+    return [this.toCodeLocation(response)];
+  }
+  /**
+   * Find the definition of a symbol at the given position.
+   * Sends textDocument/definition request.
+   */
+  async getDefinition(path, line, character) {
+    try {
+      const conn = this.requireConnection();
+      const uri = this.pathToUri(path);
+      const result = await conn.sendRequest(LSP.definition, {
+        textDocument: { uri },
+        position: { line, character }
+      });
+      return this.normalizeLocations(result);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Find all references to a symbol at the given position.
+   * Sends textDocument/references request.
+   */
+  async getReferences(path, line, character) {
+    try {
+      const conn = this.requireConnection();
+      const uri = this.pathToUri(path);
+      const result = await conn.sendRequest(LSP.references, {
+        textDocument: { uri },
+        position: { line, character },
+        context: { includeDeclaration: true }
+      });
+      return this.normalizeLocations(result);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Find the type definition of a symbol at the given position.
+   * Sends textDocument/typeDefinition request.
+   */
+  async getTypeDefinition(path, line, character) {
+    try {
+      const conn = this.requireConnection();
+      const uri = this.pathToUri(path);
+      const result = await conn.sendRequest(LSP.typeDefinition, {
+        textDocument: { uri },
+        position: { line, character }
+      });
+      return this.normalizeLocations(result);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Search workspace for a symbol by name.
+   * Sends workspace/symbol request.
+   */
+  async findWorkspaceSymbol(query) {
+    try {
+      const conn = this.requireConnection();
+      const result = await conn.sendRequest(LSP.workspaceSymbol, { query });
+      if (!Array.isArray(result)) return [];
+      return result.map((sym) => {
+        const info = {
+          name: sym.name,
+          kind: this.symbolKindToString(sym.kind),
+          location: this.toCodeLocation(sym.location)
+        };
+        if (sym.containerName) {
+          info.containerName = sym.containerName;
+        }
+        return info;
+      });
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Get hover information for a symbol at the given position.
+   * Sends textDocument/hover request.
+   */
+  async getHoverInfo(path, line, character) {
+    try {
+      const conn = this.requireConnection();
+      const uri = this.pathToUri(path);
+      const result = await conn.sendRequest(LSP.hover, {
+        textDocument: { uri },
+        position: { line, character }
+      });
+      if (!result) return null;
+      const contents = this.extractHoverContents(result.contents);
+      const range = result.range ? {
+        start: { line: result.range.start.line, character: result.range.start.character },
+        end: { line: result.range.end.line, character: result.range.end.character }
+      } : void 0;
+      return hoverInfo(contents, range);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Extract a plain-text string from hover contents (which can be
+   * MarkupContent, MarkedString, or an array of either).
+   */
+  extractHoverContents(contents) {
+    if (typeof contents === "string") return contents;
+    if (Array.isArray(contents)) {
+      return contents.map((c) => typeof c === "string" ? c : c.value).join("\n\n");
+    }
+    return contents.value;
+  }
+  /**
+   * Convert LSP SymbolKind number to a human-readable string.
+   * See https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#symbolKind
+   */
+  symbolKindToString(kind) {
+    return SYMBOL_KIND_NAMES[kind] ?? "Unknown";
+  }
+  // ============================================================================
   // Status
   // ============================================================================
   isRunning() {
@@ -1917,13 +2122,22 @@ var LspServer = class {
   getLanguage() {
     return this.config.id;
   }
+  hasOpenDocuments() {
+    return this.openDocuments.size > 0;
+  }
+  getExtensions() {
+    return this.config.extensions;
+  }
 };
 
+// src/server/lsp/manager.ts
+import { readFileSync as readFileSync2 } from "fs";
+
 // src/server/utils/which.ts
 import { access, constants } from "fs/promises";
 import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __dirname = dirname(fileURLToPath2(import.meta.url));
 function getBundledBinPaths() {
   const paths = [];
   paths.push(join(process.cwd(), "node_modules", ".bin"));
@@ -1973,9 +2187,9 @@ async function which(command, workdir) {
 // src/server/lsp/languages.ts
 import { extname as extname2, basename } from "path";
 import { readFileSync } from "fs";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import { dirname as dirname2, resolve } from "path";
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var __dirname2 = dirname2(fileURLToPath3(import.meta.url));
 var languagesJson = JSON.parse(readFileSync(resolve(__dirname2, "languages.json"), "utf-8"));
 var LANGUAGES = languagesJson;
 var extensionToLanguage = /* @__PURE__ */ new Map();
@@ -2151,6 +2365,85 @@ var LspManager = class {
     }
     return null;
   }
+  // ============================================================================
+  // Code Navigation Queries
+  // ============================================================================
+  /**
+   * Find the definition of a symbol at the given position.
+   */
+  async getDefinition(path, line, character) {
+    const server = await this.getServerForFile(path);
+    if (!server) return [];
+    return server.getDefinition(path, line, character);
+  }
+  /**
+   * Find all references to a symbol at the given position.
+   */
+  async getReferences(path, line, character) {
+    const server = await this.getServerForFile(path);
+    if (!server) return [];
+    return server.getReferences(path, line, character);
+  }
+  /**
+   * Find the type definition of a symbol at the given position.
+   */
+  async getTypeDefinition(path, line, character) {
+    const server = await this.getServerForFile(path);
+    if (!server) return [];
+    return server.getTypeDefinition(path, line, character);
+  }
+  /**
+   * Search workspace for a symbol by name.
+   * Uses the first available server that supports workspace/symbol.
+   */
+  async findWorkspaceSymbol(query) {
+    for (const server of this.servers.values()) {
+      if (server.isRunning()) {
+        const results = await server.findWorkspaceSymbol(query);
+        if (results.length > 0) return results;
+      }
+    }
+    return [];
+  }
+  /**
+   * 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
+   */
+  async seedAndFindWorkspaceSymbol(query, filePath) {
+    const server = await this.getServerForFile(filePath);
+    if (!server?.isRunning()) return [];
+    try {
+      const content = readFileSync2(filePath, "utf-8");
+      await server.didOpen(filePath, content);
+      await server.getHoverInfo(filePath, 0, 0);
+    } catch (error) {
+      logger.warn("Failed to seed LSP server", {
+        path: filePath,
+        error: error instanceof Error ? error.message : String(error),
+        sessionId: this.sessionId
+      });
+      return [];
+    }
+    return server.findWorkspaceSymbol(query);
+  }
+  /**
+   * Get hover information for a symbol at the given position.
+   */
+  async getHoverInfo(path, line, character) {
+    const server = await this.getServerForFile(path);
+    if (!server) return null;
+    return server.getHoverInfo(path, line, character);
+  }
+  // ============================================================================
+  // Shutdown
+  // ============================================================================
   /**
    * Shutdown all LSP servers.
    */
@@ -3105,9 +3398,9 @@ function createSkillRoutes(configDir, projectDir) {
 // src/server/commands/registry.ts
 import { writeFile, mkdir, unlink } from "fs/promises";
 import { join as join3, dirname as dirname3 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { fileURLToPath as fileURLToPath4 } from "url";
 import matter from "gray-matter";
-var __bundleDir = dirname3(fileURLToPath3(import.meta.url));
+var __bundleDir = dirname3(fileURLToPath4(import.meta.url));
 var DEFAULTS_DIR = join3(__bundleDir, "defaults");
 var DEFAULTS_DIR_ALT = join3(__bundleDir, "command-defaults");
 var COMMAND_EXTENSION = ".command.md";
@@ -3544,7 +3837,7 @@ import { Router as Router7 } from "express";
 import { spawn as spawn2 } from "child_process";
 
 // src/constants.ts
-var VERSION = "2.0.38";
+var VERSION = "2.0.39";
 
 // src/server/routes/auto-update.ts
 var updateInProgress = false;
@@ -3659,7 +3952,7 @@ function createAutoUpdateRoutes(options = {}) {
 }
 
 // src/server/index.ts
-var __dirname3 = dirname5(fileURLToPath4(import.meta.url));
+var __dirname3 = dirname5(fileURLToPath5(import.meta.url));
 async function createServerHandle(config4) {
   setRuntimeConfig(config4);
   setLogLevel(config4.logging?.level ?? void 0, config4.mode);
@@ -3741,7 +4034,7 @@ async function createServerHandle(config4) {
       setMcpTools(mcpTools);
       logger.info("MCP tools registered", { count: mcpTools.length });
     }
-    const { signalMcpReady } = await import("./server-MEJPUI4S.js");
+    const { signalMcpReady } = await import("./server-YPCAJFOC.js");
     signalMcpReady();
   });
   const app = express();
@@ -3934,7 +4227,7 @@ async function createServerHandle(config4) {
   app.get("/api/sessions/:id", async (req, res) => {
     const { getEventStore: getEventStore2 } = await import("./events-KZZPCW2Q.js");
     const { buildMessagesFromStoredEvents } = await import("./folding-ENYH4LMG.js");
-    const { getPendingQuestionsForSession } = await import("./tools-ATO5MSWX.js");
+    const { getPendingQuestionsForSession } = await import("./tools-ZYUJUI4R.js");
     const session = sessionManager.getSession(req.params.id);
     if (!session) {
       return res.status(404).json({ error: "Session not found" });
@@ -4085,7 +4378,7 @@ async function createServerHandle(config4) {
     if (!callId || approved === void 0) {
       return res.status(400).json({ error: "callId and approved are required" });
     }
-    const { providePathConfirmation } = await import("./tools-ATO5MSWX.js");
+    const { providePathConfirmation } = await import("./tools-ZYUJUI4R.js");
     const result = providePathConfirmation(callId, approved, alwaysAllow);
     if (!result.found) {
       return res.status(404).json({ error: "No pending path confirmation with that ID" });
@@ -4093,7 +4386,7 @@ async function createServerHandle(config4) {
     const { getEventStore: getEventStore2 } = await import("./events-KZZPCW2Q.js");
     const { buildMessagesFromStoredEvents, foldPendingConfirmations } = await import("./folding-ENYH4LMG.js");
     const { createSessionStateMessage } = await import("./protocol-BKNLAEPJ.js");
-    const { getPendingQuestionsForSession } = await import("./tools-ATO5MSWX.js");
+    const { getPendingQuestionsForSession } = await import("./tools-ZYUJUI4R.js");
     const eventStore = getEventStore2();
     const events = eventStore.getEvents(sessionId);
     const messages = buildMessagesFromStoredEvents(events);
@@ -4114,7 +4407,7 @@ async function createServerHandle(config4) {
     if (!skip && typeof answer !== "string") {
       return res.status(400).json({ error: "answer is required when not skipping" });
     }
-    const { provideAnswer } = await import("./tools-ATO5MSWX.js");
+    const { provideAnswer } = await import("./tools-ZYUJUI4R.js");
     const found = provideAnswer(callId, answer ?? "", skip ?? false);
     if (!found) {
       return res.status(404).json({ error: "No pending question with that ID" });
@@ -4150,8 +4443,8 @@ async function createServerHandle(config4) {
     if (!session) {
       return res.status(404).json({ error: "Session not found" });
     }
-    const { stopSessionExecution } = await import("./chat-handler-TPKAEATB.js");
-    const { cancelQuestionsForSession, cancelPathConfirmationsForSession } = await import("./tools-ATO5MSWX.js");
+    const { stopSessionExecution } = await import("./chat-handler-4YZGM7V7.js");
+    const { cancelQuestionsForSession, cancelPathConfirmationsForSession } = await import("./tools-ZYUJUI4R.js");
     const queuedMessages = sessionManager.getQueueState(sessionId);
     sessionManager.clearMessageQueue(sessionId);
     stopSessionExecution(sessionId, sessionManager);
@@ -4647,7 +4940,7 @@ async function createServerHandle(config4) {
   });
   async function rebuildMcpTools() {
     const { createMcpTools: createMcpTools2 } = await import("./tool-adapter-B7QP6NLA.js");
-    const { setMcpTools: setMcpTools2 } = await import("./tools-ATO5MSWX.js");
+    const { setMcpTools: setMcpTools2 } = await import("./tools-ZYUJUI4R.js");
     const mcpTools = createMcpTools2(mcpManager);
     setMcpTools2(mcpTools);
   }
@@ -4960,7 +5253,7 @@ async function createServerHandle(config4) {
     const state = sessionManager.getContextState(sessionId);
     wssExports.broadcastForSession(sessionId, createContextStateMessage(state));
   });
-  const { QueueProcessor } = await import("./processor-NG4NH2SS.js");
+  const { QueueProcessor } = await import("./processor-FB2I73B3.js");
   const queueProcessor = new QueueProcessor({
     sessionManager,
     providerManager,
@@ -5035,4 +5328,4 @@ export {
   createServerHandle,
   createServer
 };
-//# sourceMappingURL=chunk-ATBNY4CL.js.map
+//# sourceMappingURL=chunk-BMRC6TQ5.js.map

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

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

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

@@ -3452,7 +3452,7 @@ var callSubAgentTool = {
       };
     }
     try {
-      const { getToolRegistryForAgent: getToolRegistryForAgent2 } = await import("./tools-ATO5MSWX.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-ATO5MSWX.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-ATO5MSWX.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-ATO5MSWX.js");
+      const { setMcpTools: setMcpTools2 } = await import("./tools-ZYUJUI4R.js");
       const mcpTools = createMcpTools(mcpManagerForTools);
       setMcpTools2(mcpTools);
     }
@@ -4489,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() {
@@ -4507,7 +4771,8 @@ function getBuiltInTools() {
       devServerTool,
       stepDoneTool,
       backgroundProcessTool,
-      mcpConfigTool
+      mcpConfigTool,
+      traceCodeTool
     ];
   }
   return _builtInTools;
@@ -4793,4 +5058,4 @@ export {
   getToolRegistryForAgent,
   createToolRegistry
 };
-//# sourceMappingURL=chunk-HJ7KRYWX.js.map
+//# sourceMappingURL=chunk-UR4A2HYT.js.map

package/dist/cli/dev.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "../chunk-7W2WATAO.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-7W2WATAO.js";
+} from "../chunk-4RYP3RBY.js";
 import {
   logger
 } from "../chunk-K44MW7JJ.js";

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

@@ -2,8 +2,8 @@ import {
   injectWorkflowKickoffIfNeeded,
   runAgentTurn,
   runChatTurn
-} from "./chunk-FFQCZ2MI.js";
-import "./chunk-HJ7KRYWX.js";
+} from "./chunk-BG5ILIWN.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -42,4 +42,4 @@ export {
   runAgentTurn,
   runChatTurn
 };
-//# sourceMappingURL=orchestrator-ZFBVVQBO.js.map
+//# sourceMappingURL=orchestrator-7B3XOZ4T.js.map

package/dist/package.json

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

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

@@ -3,7 +3,7 @@ import {
   finalizeTurnCompletion,
   generateSessionNameForSession
 } from "./chunk-JGNAYJJZ.js";
-import "./chunk-HJ7KRYWX.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -171,7 +171,7 @@ var QueueProcessor = class {
       backend: provider?.backend ?? llmClient.getBackend(),
       model: llmClient.getModel()
     };
-    const { runChatTurn } = await import("./orchestrator-ZFBVVQBO.js");
+    const { runChatTurn } = await import("./orchestrator-7B3XOZ4T.js");
     const runChatTurnParams = buildRunChatTurnParams({
       sessionManager,
       sessionId,
@@ -216,4 +216,4 @@ var QueueProcessor = class {
 export {
   QueueProcessor
 };
-//# sourceMappingURL=processor-NG4NH2SS.js.map
+//# sourceMappingURL=processor-FB2I73B3.js.map

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

@@ -1,10 +1,10 @@
 import {
   VERSION,
   createServer
-} from "./chunk-ATBNY4CL.js";
-import "./chunk-GZZW4XSI.js";
-import "./chunk-FFQCZ2MI.js";
-import "./chunk-HJ7KRYWX.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";
@@ -199,4 +199,4 @@ async function runServe(options) {
 export {
   runServe
 };
-//# sourceMappingURL=serve-VIWHYE6X.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-ATBNY4CL.js";
-import "../chunk-GZZW4XSI.js";
-import "../chunk-FFQCZ2MI.js";
-import "../chunk-HJ7KRYWX.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";

package/dist/{server-MEJPUI4S.js → server-YPCAJFOC.js}

@@ -1,9 +1,9 @@
 import {
   createWebSocketServer,
   signalMcpReady
-} from "./chunk-GZZW4XSI.js";
-import "./chunk-FFQCZ2MI.js";
-import "./chunk-HJ7KRYWX.js";
+} from "./chunk-P4SOUTLD.js";
+import "./chunk-BG5ILIWN.js";
+import "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -34,4 +34,4 @@ export {
   createWebSocketServer,
   signalMcpReady
 };
-//# sourceMappingURL=server-MEJPUI4S.js.map
+//# sourceMappingURL=server-YPCAJFOC.js.map

package/dist/{tools-ATO5MSWX.js → tools-ZYUJUI4R.js}

@@ -12,7 +12,7 @@ import {
   setMcpTools,
   stepDoneTool,
   validateToolAction
-} from "./chunk-HJ7KRYWX.js";
+} from "./chunk-UR4A2HYT.js";
 import "./chunk-DL6ZILAF.js";
 import "./chunk-PBGOZMVY.js";
 import "./chunk-VRGRAQDG.js";
@@ -57,4 +57,4 @@ export {
   stepDoneTool,
   validateToolAction
 };
-//# sourceMappingURL=tools-ATO5MSWX.js.map
+//# sourceMappingURL=tools-ZYUJUI4R.js.map

package/package.json

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