tidewave 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.7.0] - 2026-06-14
+
+* Support namespaces/files in `get_docs` tool and make it return a list of exports
+* Support re-exports in `get_docs` lookups
+* Improve out-of-the-box experience for remote access (which remains opt-in)
+
 ## [0.6.0] - 2025-12-31
 
 * Tanstack support

package/README.md

@@ -9,7 +9,7 @@ This project supports:
 
 - Next.js 15/16
 - TanStack Start with React
-- Vite with React/Vue
+- Vite with React/Vue (which includes Astro, VitePress, etc)
 
 If you are using React/Vue with Django, FastAPI, Flask, Phoenix, or Rails,
 [follow the steps here instead](http://hexdocs.pm/tidewave/frontend.html).
@@ -37,7 +37,7 @@ And you are almost there! Now make sure
 [Tidewave is installed](https://hexdocs.pm/tidewave/installation.html) and you
 are ready to connect Tidewave to your app.
 
-In case the command abovees do not work, you can toggle the manual installation
+In case the command above do not work, you can toggle the manual installation
 instructions below
 
 <details>
@@ -258,11 +258,28 @@ features.
 Next.js' `tidewaveHandler` and Vite's `tidewave` accept the configuration
 options below:
 
-- `allow_remote_access:` allow remote connections when true (default false).
-  Enable this only if you trust your network and you want Tidewave MCP to be
-  accessed from another trusted machine
+- `allow_remote_access:` Tidewave only allows requests from localhost by
+  default, even if your server listens on other interfaces, for security
+  purposes. Read
+  [our security guidelines for more information and when to allow remote access](https://hexdocs.pm/tidewave/security.html)
+  (if you know what you are doing)
 - `team`: enable Tidewave Web for teams
 
+## Available tools
+
+- `get_docs` - get the documentation for a given module/namespace or a
+  class/interface/enum/type in that namespace. It consults the exact versions
+  used by the project, ensuring you always get correct information
+
+- `get_source_location` - get the source location for a given module/namespace
+  or a class/interface/enum/type in that namespace, so an agent can directly
+  read the source skipping search
+
+- `get_logs` - reads console log written by the server
+
+- `project_eval` - evaluates code within the runtime itself, giving the agent
+  access to dependencies, server code, and all in-memory data
+
 ## CLI
 
 Tidewave.js also comes with a CLI for developers who want to use it as a
@@ -302,6 +319,7 @@ Here are some examples:
 
 ```bash
 # Local TypeScript/JavaScript files
+npx tidewave docs ./src/utils
 npx tidewave docs ./src/utils:formatDate
 npx tidewave docs ./components:Button#onClick
 

package/dist/cli/index.js

@@ -5,25 +5,43 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -5835,9 +5853,10 @@ var init_zod = __esm(() => {
 });
 
 // src/tools.ts
-var projectEvalDescription, projectEvalInputSchema, referenceDescription = `Module path in format 'module:symbol[#method|.method]'. Supports local files, dependencies, and Node.js builtins.
+var projectEvalDescription, projectEvalInputSchema, referenceDescription = `Module/file path, optionally with symbol in format 'module[:symbol[#method|.method]]'. Supports local files, dependencies, and Node.js builtins.
 
 Module reference format:
+- module                - List all symbols in the module (file-level documentation)
 - module:symbol         - Extract a top-level symbol
 - module:Class#method   - Extract an instance method
 - module:Class.method   - Extract a static method
@@ -5845,6 +5864,8 @@ Module reference format:
 - node:Class.method     - Extract a global/builtin static method
 
 Examples:
+- src/types.ts (list all symbols in file)
+- lodash (list all symbols in dependency)
 - src/types.ts:SymbolInfo (local file symbol)
 - lodash:isEmpty (dependency function)
 - react:Component#render (instance method)
@@ -5852,7 +5873,8 @@ Examples:
 var init_tools = __esm(() => {
   init_zod();
   projectEvalDescription = `
-Evaluates JavaScript/TypeScript code in the context of the project.
+Evaluates JavaScript/TypeScript code within your project's build tool
+(or server for full-stack applications).
 
 The current NodeJS version is: ${process.version}
 
@@ -5861,7 +5883,7 @@ including to test the behaviour of a function or to debug
 something. The tool also returns anything written to standard
 output. DO NOT use shell tools to evaluate JavaScript/TypeScript code.
 
-Imports are allowed only as the form of dynamic imports with async/await, e.g.:
+Imports are allowed only as the form of dynamic imports with async/await:
 const path = await import('node:path');
 `;
   projectEvalInputSchema = exports_external.object({
@@ -5887,7 +5909,26 @@ Defaults to 30000 (30 seconds).`),
     docs: {
       mcp: {
         name: "get_docs",
-        description: "Extract TypeScript/JavaScript documentation and type information for symbols, classes, functions, and methods. This works for modules in the current project, as well as dependencies, and builtin node modules",
+        description: `Extract TypeScript/JavaScript documentation and type information. Works for modules in the current project, dependencies, and builtin node modules.
+
+Reference format determines what is returned:
+
+• "module" - Returns file overview and lists all exported symbols with their kinds, line numbers, and brief documentation. Use this to discover what's available in a module.
+
+• "module:symbol" - Returns detailed documentation for a specific top-level symbol including its type signature, full documentation, JSDoc tags, and source location.
+
+• "module:Class.staticMethod" - Returns detailed documentation for a static method or property of a class or object.
+
+• "module:Class#instanceMethod" - Returns detailed documentation for an instance method or property of a class.
+
+Examples:
+- "src/types.ts" → Lists all exported symbols in the file
+- "lodash" → Lists all symbols exported from lodash
+- "src/types.ts:SymbolInfo" → Full docs for SymbolInfo interface
+- "react:Component#render" → Docs for React Component's render method
+- "node:Math.max" → Docs for Math.max static method
+
+Start with module-only references to explore, then drill into specific symbols for detailed information.`,
         inputSchema: docsInputSchema
       },
       cli: {
@@ -5936,7 +5977,7 @@ Defaults to 30000 (30 seconds).`),
     logs: {
       mcp: {
         name: "get_logs",
-        description: "Retrieve application logs for debugging. Returns logs excluding Tidewave internal logs. Supports filtering by level, time, and pattern matching.",
+        description: "Retrieve application logs within your project's build tool (or server for full-stack applications). Supports filtering by level, time, and pattern matching.",
         inputSchema: getLogsInputSchema
       }
     }
@@ -5952,6 +5993,9 @@ function isResolveError(result) {
 function isExtractError(result) {
   return result != null && "error" in result;
 }
+function isFileInfo(result) {
+  return result != null && "exports" in result && Array.isArray(result.exports);
+}
 function resolveError(specifier, source) {
   return {
     success: false,
@@ -6150,6 +6194,8 @@ function getSymbolKind(symbol) {
     return "property";
   if (flags & ts2.SymbolFlags.Method)
     return "method";
+  if (flags & ts2.SymbolFlags.EnumMember)
+    return "enum member";
   if (flags & ts2.SymbolFlags.Enum)
     return "enum";
   if (flags & ts2.SymbolFlags.Module)
@@ -6170,6 +6216,27 @@ function getSymbolKind(symbol) {
   }
   return "unknown";
 }
+function getFileOverview(sourceFile) {
+  const leadingComments = ts2.getLeadingCommentRanges(sourceFile.text, 0);
+  if (!leadingComments || leadingComments.length === 0) {
+    return;
+  }
+  for (const comment of leadingComments) {
+    const commentText = sourceFile.text.slice(comment.pos, comment.end);
+    const fileoverviewMatch = commentText.match(/@fileoverview\s+([\s\S]*?)(?=@\w+|$)/);
+    const fileMatch = commentText.match(/@file\s+([\s\S]*?)(?=@\w+|$)/);
+    const match = fileoverviewMatch || fileMatch;
+    if (match && match[1]) {
+      const overviewText = match[1].split(`
+`).map((line) => line.replace(/^\s*\*\s?/, "").trim()).filter((line) => line.length > 0).join(`
+`).trim();
+      if (overviewText) {
+        return overviewText;
+      }
+    }
+  }
+  return;
+}
 var init_utils = () => {};
 
 // src/resolution/formatters.ts
@@ -6266,7 +6333,7 @@ function getTypeString(checker, symbol, type) {
   }
   return defaultTypeString;
 }
-function formatOutput(info) {
+function formatSymbolInfo(info) {
   const output = [];
   output.push(`
 ${info.name}`);
@@ -6293,7 +6360,36 @@ ${info.name}`);
   return output.join(`
 `);
 }
-var init_formatters = () => {};
+function formatFileInfo(info) {
+  const output = [];
+  output.push(`
+File: ${info.path}`);
+  output.push("");
+  if (info.overview) {
+    output.push("Overview:");
+    output.push(info.overview);
+    output.push("");
+  }
+  output.push(`Symbols (${info.exportCount} total):`);
+  output.push("");
+  for (const exp of info.exports) {
+    output.push(`${exp.name} (${exp.kind}) - line ${exp.line}`);
+    if (exp.documentation) {
+      output.push(exp.documentation);
+    }
+  }
+  return output.join(`
+`);
+}
+function formatOutput(info) {
+  if (isFileInfo(info)) {
+    return formatFileInfo(info);
+  }
+  return formatSymbolInfo(info);
+}
+var init_formatters = __esm(() => {
+  init_core();
+});
 
 // src/resolution/symbol-finder.ts
 import ts4 from "typescript";
@@ -6370,7 +6466,12 @@ function getSymbolInfo(checker, symbol, member, isStatic) {
     return createExtractError("TYPE_ERROR", `Symbol '${symbol.getName()}' has no declarations`);
   }
   const targetDeclaration = declaration || symbol.declarations[0];
-  const type = checker.getTypeOfSymbolAtLocation(symbol, targetDeclaration);
+  let type;
+  if (symbol.flags & (ts4.SymbolFlags.Interface | ts4.SymbolFlags.TypeAlias)) {
+    type = checker.getDeclaredTypeOfSymbol(symbol);
+  } else {
+    type = checker.getTypeOfSymbolAtLocation(symbol, targetDeclaration);
+  }
   const symbolName = symbol.getName();
   let targetSymbol = symbol;
   let targetType = type;
@@ -6384,11 +6485,27 @@ function getSymbolInfo(checker, symbol, member, isStatic) {
         targetType = checker.getTypeOfSymbolAtLocation(staticMember, staticMember.valueDeclaration);
         name = `${symbolName}.${member}`;
       } else {
-        return createExtractError("MEMBER_NOT_FOUND", `Static member '${member}' not found on '${symbolName}'`);
+        return createExtractError("MEMBER_NOT_FOUND", `Static member '${member}' not found on '${symbolName}'. Available: ${staticMembers.map((m) => m.getName()).join(", ")}`);
       }
     } else {
       let instanceType;
-      if (symbol.flags & ts4.SymbolFlags.Class) {
+      if (symbol.flags & ts4.SymbolFlags.Interface) {
+        instanceType = type;
+        const instanceMembers = checker.getPropertiesOfType(instanceType);
+        const instanceMember = instanceMembers.find((s) => s.getName() === member);
+        if (instanceMember) {
+          targetSymbol = instanceMember;
+          const memberDecl = instanceMember.valueDeclaration || instanceMember.declarations?.[0];
+          if (memberDecl) {
+            targetType = checker.getTypeOfSymbolAtLocation(instanceMember, memberDecl);
+          } else {
+            targetType = checker.getTypeOfSymbol(instanceMember);
+          }
+          name = `${symbolName}#${member}`;
+        } else {
+          return createExtractError("MEMBER_NOT_FOUND", `Instance member '${member}' not found on interface '${symbolName}'. Available: ${instanceMembers.map((m) => m.getName()).join(", ")}`);
+        }
+      } else if (symbol.flags & ts4.SymbolFlags.Class) {
         instanceType = checker.getTypeOfSymbolAtLocation(symbol, symbol.valueDeclaration);
         const constructSignatures = instanceType.getConstructSignatures();
         if (constructSignatures.length > 0) {
@@ -6472,6 +6589,9 @@ var init_symbol_finder = __esm(() => {
 import ts5 from "typescript";
 import path4 from "node:path";
 function parseModulePath(modulePath) {
+  if (!modulePath || modulePath.trim() === "") {
+    return createExtractError("INVALID_REQUEST", "Module path is required");
+  }
   let module;
   let symbolPath;
   if (modulePath.startsWith("node:")) {
@@ -6480,12 +6600,22 @@ function parseModulePath(modulePath) {
     module = `node:${baseSymbol}`;
     symbolPath = nodeSymbol;
   } else {
-    const [mod, symPath] = modulePath.split(":");
-    if (!mod || !symPath) {
-      return createExtractError("INVALID_REQUEST", `Invalid format. Expected 'module:symbol', got '${modulePath}'`);
+    const colonIndex = modulePath.indexOf(":");
+    if (colonIndex === -1) {
+      module = modulePath;
+      symbolPath = undefined;
+    } else if (colonIndex === 0) {
+      return createExtractError("INVALID_REQUEST", 'Module path is required before ":"');
+    } else {
+      module = modulePath.substring(0, colonIndex);
+      symbolPath = modulePath.substring(colonIndex + 1);
+      if (!symbolPath || symbolPath.trim() === "") {
+        return createExtractError("INVALID_REQUEST", 'Symbol name is required after ":"');
+      }
     }
-    module = mod;
-    symbolPath = symPath;
+  }
+  if (!symbolPath) {
+    return { module, symbol: undefined, member: undefined, isStatic: false };
   }
   if (symbolPath.includes("#")) {
     const [symbol, member] = symbolPath.split("#");
@@ -6503,6 +6633,37 @@ function parseModulePath(modulePath) {
   }
   return { module, symbol: symbolPath, member: undefined, isStatic: false };
 }
+function getExportSummaries(moduleSymbol, sourceFile, checker) {
+  if (!moduleSymbol) {
+    return [];
+  }
+  try {
+    const exports = checker.getExportsOfModule(moduleSymbol);
+    const summaries = [];
+    for (const exp of exports) {
+      const name = exp.getName();
+      const kind = getSymbolKind(exp);
+      const decl = exp.valueDeclaration ?? exp.declarations?.[0];
+      let line = 0;
+      if (decl) {
+        const pos = sourceFile.getLineAndCharacterOfPosition(decl.getStart());
+        line = pos.line + 1;
+      }
+      const fullDoc = ts5.displayPartsToString(exp.getDocumentationComment(checker));
+      const briefDoc = fullDoc.split(`
+`)[0]?.trim();
+      summaries.push({
+        name,
+        kind,
+        line,
+        documentation: briefDoc || undefined
+      });
+    }
+    return summaries.sort((a, b) => a.line - b.line);
+  } catch {
+    return [];
+  }
+}
 async function extractDocs(modulePath) {
   const options = { prefix: process.cwd() };
   const parseResult = parseModulePath(modulePath);
@@ -6525,6 +6686,22 @@ async function extractDocs(modulePath) {
   }
   const { sourceFile, program: program2 } = resolvedModule;
   const checker = program2.getTypeChecker();
+  if (symbol === undefined) {
+    const overview = getFileOverview(sourceFile);
+    const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+    const exports = getExportSummaries(moduleSymbol, sourceFile, checker);
+    let relativePath = sourceFile.fileName;
+    const cwd = process.cwd();
+    if (relativePath.startsWith(cwd)) {
+      relativePath = path4.relative(cwd, relativePath);
+    }
+    return {
+      path: relativePath,
+      overview,
+      exportCount: exports.length,
+      exports
+    };
+  }
   let targetSymbol;
   if (isGlobalModule) {
     const actualSymbolName = module.startsWith("node:") ? module.slice(5) : module;
@@ -6545,9 +6722,11 @@ async function extractDocs(modulePath) {
       const exports = checker.getExportsOfModule(moduleSymbol);
       const exportSymbol = exports.find((exp) => exp.getName() === symbol);
       if (exportSymbol) {
-        if (exportSymbol.valueDeclaration && (ts5.isFunctionDeclaration(exportSymbol.valueDeclaration) || ts5.isClassDeclaration(exportSymbol.valueDeclaration) || ts5.isVariableDeclaration(exportSymbol.valueDeclaration))) {
+        if (exportSymbol.flags & ts5.SymbolFlags.Alias) {
+          targetSymbol = checker.getAliasedSymbol(exportSymbol);
+        } else if (exportSymbol.valueDeclaration && (ts5.isFunctionDeclaration(exportSymbol.valueDeclaration) || ts5.isClassDeclaration(exportSymbol.valueDeclaration) || ts5.isVariableDeclaration(exportSymbol.valueDeclaration) || ts5.isEnumDeclaration(exportSymbol.valueDeclaration))) {
           targetSymbol = exportSymbol;
-        } else if (exportSymbol.flags & (ts5.SymbolFlags.Interface | ts5.SymbolFlags.TypeAlias)) {
+        } else if (exportSymbol.flags & (ts5.SymbolFlags.Interface | ts5.SymbolFlags.TypeAlias | ts5.SymbolFlags.Enum)) {
           targetSymbol = exportSymbol;
         } else {
           targetSymbol = findSymbolInJavaScriptFile(sourceFile, checker, symbol);
@@ -6588,6 +6767,15 @@ async function getSourceLocation(reference) {
       };
     }
     const { module, symbol, member, isStatic } = parseResult;
+    if (!symbol) {
+      return {
+        success: false,
+        error: {
+          code: "INVALID_SPECIFIER",
+          message: "Symbol reference required for source location lookup"
+        }
+      };
+    }
     const config2 = loadTsConfig(options.prefix);
     let resolvedModule = resolveModule(module, config2.options);
     let isGlobalModule = false;
@@ -6708,6 +6896,7 @@ var init_resolution = __esm(() => {
   init_core();
   init_module_resolver();
   init_symbol_finder();
+  init_utils();
   init_formatters();
 });
 
@@ -6787,7 +6976,7 @@ var init_src = __esm(() => {
 });
 
 // package.json
-var name = "tidewave", version = "0.6.0", package_default;
+var name = "tidewave", version = "0.7.0", package_default;
 var init_package = __esm(() => {
   package_default = {
     name,
@@ -6798,7 +6987,10 @@ var init_package = __esm(() => {
       "documentation",
       "mcp",
       "cli",
-      "tidewave"
+      "tidewave",
+      "next",
+      "vite",
+      "tanstack"
     ],
     homepage: "https://tidewave.ai",
     repository: {
@@ -6889,7 +7081,7 @@ var init_package = __esm(() => {
       next: "^15.5.3",
       prettier: "^3.4.2",
       vite: "^7.1.5",
-      vitest: "^3.2.4"
+      vitest: "^4.1.8"
     },
     peerDependencies: {
       typescript: "^5"
@@ -7962,10 +8154,10 @@ var require_uri_all = __commonJS((exports, module) => {
       }
       return output;
     }
-    var ucs2encode = function ucs2encode(array) {
+    var ucs2encode = function ucs2encode2(array) {
       return String.fromCodePoint.apply(String, toConsumableArray(array));
     };
-    var basicToDigit = function basicToDigit(codePoint) {
+    var basicToDigit = function basicToDigit2(codePoint) {
       if (codePoint - 48 < 10) {
         return codePoint - 22;
       }
@@ -7977,10 +8169,10 @@ var require_uri_all = __commonJS((exports, module) => {
       }
       return base;
     };
-    var digitToBasic = function digitToBasic(digit, flag) {
+    var digitToBasic = function digitToBasic2(digit, flag) {
       return digit + 22 + 75 * (digit < 26) - ((flag != 0) << 5);
     };
-    var adapt = function adapt(delta, numPoints, firstTime) {
+    var adapt = function adapt2(delta, numPoints, firstTime) {
       var k = 0;
       delta = firstTime ? floor(delta / damp) : delta >> 1;
       delta += floor(delta / numPoints);
@@ -7989,7 +8181,7 @@ var require_uri_all = __commonJS((exports, module) => {
       }
       return floor(k + (baseMinusTMin + 1) * delta / (delta + skew));
     };
-    var decode = function decode(input) {
+    var decode = function decode2(input) {
       var output = [];
       var inputLength = input.length;
       var i = 0;
@@ -8037,7 +8229,7 @@ var require_uri_all = __commonJS((exports, module) => {
       }
       return String.fromCodePoint.apply(String, output);
     };
-    var encode = function encode(input) {
+    var encode = function encode2(input) {
       var output = [];
       input = ucs2decode(input);
       var inputLength = input.length;
@@ -8151,12 +8343,12 @@ var require_uri_all = __commonJS((exports, module) => {
       }
       return output.join("");
     };
-    var toUnicode = function toUnicode(input) {
+    var toUnicode = function toUnicode2(input) {
       return mapDomain(input, function(string) {
         return regexPunycode.test(string) ? decode(string.slice(4).toLowerCase()) : string;
       });
     };
-    var toASCII = function toASCII(input) {
+    var toASCII = function toASCII2(input) {
       return mapDomain(input, function(string) {
         return regexNonASCII.test(string) ? "xn--" + encode(string) : string;
       });
@@ -8553,13 +8745,13 @@ var require_uri_all = __commonJS((exports, module) => {
     var handler = {
       scheme: "http",
       domainHost: true,
-      parse: function parse(components, options) {
+      parse: function parse2(components, options) {
         if (!components.host) {
           components.error = components.error || "HTTP URIs must have a host.";
         }
         return components;
       },
-      serialize: function serialize(components, options) {
+      serialize: function serialize2(components, options) {
         var secure = String(components.scheme).toLowerCase() === "https";
         if (components.port === (secure ? 443 : 80) || components.port === "") {
           components.port = undefined;
@@ -8582,7 +8774,7 @@ var require_uri_all = __commonJS((exports, module) => {
     var handler$2 = {
       scheme: "ws",
       domainHost: true,
-      parse: function parse(components, options) {
+      parse: function parse2(components, options) {
         var wsComponents = components;
         wsComponents.secure = isSecure(wsComponents);
         wsComponents.resourceName = (wsComponents.path || "/") + (wsComponents.query ? "?" + wsComponents.query : "");
@@ -8590,7 +8782,7 @@ var require_uri_all = __commonJS((exports, module) => {
         wsComponents.query = undefined;
         return wsComponents;
       },
-      serialize: function serialize(wsComponents, options) {
+      serialize: function serialize2(wsComponents, options) {
         if (wsComponents.port === (isSecure(wsComponents) ? 443 : 80) || wsComponents.port === "") {
           wsComponents.port = undefined;
         }
@@ -8758,7 +8950,7 @@ var require_uri_all = __commonJS((exports, module) => {
     var UUID = /^[0-9A-Fa-f]{8}(?:\-[0-9A-Fa-f]{4}){3}\-[0-9A-Fa-f]{12}$/;
     var handler$6 = {
       scheme: "urn:uuid",
-      parse: function parse(urnComponents, options) {
+      parse: function parse2(urnComponents, options) {
         var uuidComponents = urnComponents;
         uuidComponents.uuid = uuidComponents.nss;
         uuidComponents.nss = undefined;
@@ -8767,7 +8959,7 @@ var require_uri_all = __commonJS((exports, module) => {
         }
         return uuidComponents;
       },
-      serialize: function serialize(uuidComponents, options) {
+      serialize: function serialize2(uuidComponents, options) {
         var urnComponents = uuidComponents;
         urnComponents.nss = (uuidComponents.uuid || "").toLowerCase();
         return urnComponents;
@@ -10213,7 +10405,7 @@ var require_compile = __commonJS((exports, module) => {
 
 // node_modules/ajv/lib/cache.js
 var require_cache = __commonJS((exports, module) => {
-  var Cache = module.exports = function Cache() {
+  var Cache = module.exports = function Cache2() {
     this._cache = {};
   };
   Cache.prototype.put = function Cache_put(key, value) {
@@ -15508,6 +15700,7 @@ var init_zodToJsonSchema = __esm(() => {
 
 // node_modules/zod-to-json-schema/dist/esm/index.js
 var init_esm = __esm(() => {
+  init_zodToJsonSchema();
   init_Options();
   init_Refs();
   init_parseDef();
@@ -15539,7 +15732,6 @@ var init_esm = __esm(() => {
   init_unknown();
   init_selectParser();
   init_zodToJsonSchema();
-  init_zodToJsonSchema();
 });
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
@@ -16285,7 +16477,7 @@ async function handleGetDocs({ reference }) {
       isError: true
     };
   }
-  if (!docs.documentation) {
+  if ("documentation" in docs && !docs.documentation) {
     return {
       content: [
         {

package/dist/core.d.ts

@@ -19,7 +19,7 @@ export interface InternalResolvedModule {
 }
 export interface ExtractionRequest {
     readonly module: string;
-    readonly symbol: string;
+    readonly symbol?: string;
     readonly member?: string;
     readonly isStatic?: boolean;
 }
@@ -32,6 +32,18 @@ export interface SymbolInfo {
     readonly location: string;
     readonly jsDoc?: string;
 }
+export interface ExportSummary {
+    readonly name: string;
+    readonly kind: string;
+    readonly line: number;
+    readonly documentation?: string;
+}
+export interface FileInfo {
+    readonly path: string;
+    readonly overview?: string;
+    readonly exportCount: number;
+    readonly exports: ExportSummary[];
+}
 export interface ExtractorOptions {
     readonly prefix?: string;
 }
@@ -62,19 +74,16 @@ export interface EvaluatedModuleResult {
     stderr: string;
 }
 export type ResolveResult = ResolvedModule | ResolveError;
-export type ExtractResult = SymbolInfo | ExtractError;
+export type ExtractResult = SymbolInfo | FileInfo | ExtractError;
 export type InternalResolveResult = InternalResolvedModule | ResolveError;
-export declare function isError(result: ResolveResult | ExtractResult): boolean;
 export declare function isResolveError(result: ResolveResult | InternalResolveResult): result is ResolveError;
 export declare function isExtractError(result: ExtractResult): result is ExtractError;
+export declare function isFileInfo(result: ExtractResult): result is FileInfo;
 export declare function resolveError(specifier: ModuleRequest['specifier'], source: ModuleRequest['source']): ResolveError;
 export declare function createExtractError(code: ExtractError['error']['code'], message: string, details?: unknown): ExtractError;
 export interface TidewaveConfig {
-    port?: number;
-    host?: string;
     clientUrl?: string;
     allowRemoteAccess?: boolean;
-    allowedOrigins?: string[];
     projectName?: string;
     framework?: string;
     team?: {