tidewave 0.5.5 → 0.7.0

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,18 +6976,21 @@ var init_src = __esm(() => {
 });
 
 // package.json
-var name = "tidewave", version = "0.5.5", package_default;
+var name = "tidewave", version = "0.7.0", package_default;
 var init_package = __esm(() => {
   package_default = {
     name,
     version,
-    description: "Tidewave for JavaScript/Next.js",
+    description: "Tidewave for JavaScript (Next.js, TanStack, Vite)",
     keywords: [
       "typescript",
       "documentation",
       "mcp",
       "cli",
-      "tidewave"
+      "tidewave",
+      "next",
+      "vite",
+      "tanstack"
     ],
     homepage: "https://tidewave.ai",
     repository: {
@@ -6835,6 +7027,11 @@ var init_package = __esm(() => {
         import: "./dist/next-js/instrumentation.js",
         require: "./dist/next-js/instrumentation.js"
       },
+      "./tanstack": {
+        types: "./dist/tanstack.d.ts",
+        import: "./dist/tanstack.js",
+        require: "./dist/tanstack.js"
+      },
       "./package.json": "./package.json"
     },
     files: [
@@ -6845,7 +7042,7 @@ var init_package = __esm(() => {
     ],
     scripts: {
       dist: "bun run clean && bun run build:js && bun run build:types",
-      "build:js": "bun build --outdir dist --root src --external typescript --external child_process --external module --external @opentelemetry/api --external @opentelemetry/sdk-logs --external @opentelemetry/sdk-trace-base src/next-js/handler.ts src/next-js/instrumentation.ts src/vite-plugin.ts src/evaluation/eval_worker.ts src/cli/index.ts --target node",
+      "build:js": "bun build --outdir dist --root src --external typescript --external child_process --external module --external @opentelemetry/api --external @opentelemetry/sdk-logs --external @opentelemetry/sdk-trace-base src/next-js/handler.ts src/next-js/instrumentation.ts src/vite-plugin.ts src/tanstack.ts src/evaluation/eval_worker.ts src/cli/index.ts --target node",
       "build:types": "tsc -p tsconfig.declarations.json",
       dev: "bun run src/cli/index.ts",
       test: "bun test",
@@ -6884,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"
@@ -7957,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;
       }
@@ -7972,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);
@@ -7984,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;
@@ -8032,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;
@@ -8146,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;
       });
@@ -8548,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;
@@ -8577,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 : "");
@@ -8585,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;
         }
@@ -8753,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;
@@ -8762,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;
@@ -10208,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) {
@@ -15503,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();
@@ -15534,7 +15732,6 @@ var init_esm = __esm(() => {
   init_unknown();
   init_selectParser();
   init_zodToJsonSchema();
-  init_zodToJsonSchema();
 });
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
@@ -16156,23 +16353,31 @@ var init_mcp = __esm(() => {
   };
 });
 
-// src/logger/circular-buffer.ts
-class CircularBuffer {
-  buffer;
-  maxSize;
-  writeIndex = 0;
-  count = 0;
-  constructor(maxSize = 1024) {
-    this.buffer = new Array(maxSize);
-    this.maxSize = maxSize;
-  }
-  addLog(log) {
-    this.buffer[this.writeIndex] = log;
-    this.writeIndex = (this.writeIndex + 1) % this.maxSize;
-    this.count = Math.min(this.count + 1, this.maxSize);
-  }
-  getLogs(options) {
-    let logs = this.getAllLogs();
+// src/logger/tidewave-logger.ts
+import { appendFile, readFile } from "fs/promises";
+import * as path5 from "path";
+import * as os2 from "os";
+import * as crypto from "crypto";
+
+class TidewaveLogger {
+  logFilePath;
+  constructor() {
+    const cwd = process.cwd();
+    const digest = crypto.createHash("md5").update(cwd).digest("hex").slice(0, 16);
+    const tempDir = os2.tmpdir();
+    this.logFilePath = path5.join(tempDir, `${digest}.tidewave.ndjson`);
+  }
+  async addLog(log) {
+    const line = JSON.stringify(log) + `
+`;
+    try {
+      await appendFile(this.logFilePath, line, "utf8");
+    } catch (error) {
+      console.log("[Tidewave] failed to write to log file, error:", error);
+    }
+  }
+  async getLogs(options) {
+    let logs = await this.getAllLogs();
     if (options?.level) {
       const level = options.level.toUpperCase();
       logs = logs.filter((log) => log.severityText === level);
@@ -16190,31 +16395,26 @@ class CircularBuffer {
     }
     return logs;
   }
-  getAllLogs() {
-    if (this.count < this.maxSize) {
-      return this.buffer.slice(0, this.count).filter(Boolean);
+  async getAllLogs() {
+    try {
+      const content = await readFile(this.logFilePath, "utf8");
+      return content.split(`
+`).map((line) => {
+        try {
+          return JSON.parse(line);
+        } catch {
+          return null;
+        }
+      }).filter((log) => log !== null);
+    } catch (error) {
+      console.log("[Tidewave] failed to read from log file, error:", error);
+      return [];
     }
-    return [...this.buffer.slice(this.writeIndex), ...this.buffer.slice(0, this.writeIndex)].filter(Boolean);
-  }
-  getStats() {
-    return {
-      totalLogs: this.count,
-      bufferSize: this.maxSize,
-      bufferUsage: Math.min(this.count / this.maxSize * 100, 100).toFixed(1) + "%"
-    };
-  }
-  clear() {
-    this.buffer = new Array(this.maxSize);
-    this.writeIndex = 0;
-    this.count = 0;
   }
 }
-var circularBuffer;
-var init_circular_buffer = __esm(() => {
-  if (!globalThis.__tidewaveCircularBuffer) {
-    globalThis.__tidewaveCircularBuffer = new CircularBuffer(1024);
-  }
-  circularBuffer = globalThis.__tidewaveCircularBuffer;
+var tidewaveLogger;
+var init_tidewave_logger = __esm(() => {
+  tidewaveLogger = new TidewaveLogger;
 });
 
 // src/mcp.ts
@@ -16277,7 +16477,7 @@ async function handleGetDocs({ reference }) {
       isError: true
     };
   }
-  if (!docs.documentation) {
+  if ("documentation" in docs && !docs.documentation) {
     return {
       content: [
         {
@@ -16306,15 +16506,15 @@ async function handleGetSourcePath({ reference }) {
       isError: true
     };
   }
-  const { path: path5, format } = sourceResult;
+  const { path: path6, format } = sourceResult;
   return {
-    content: [{ type: "text", text: `${path5}(${format})` }],
+    content: [{ type: "text", text: `${path6}(${format})` }],
     isError: false
   };
 }
 async function handleGetLogs(args) {
   try {
-    const logs = circularBuffer.getLogs({
+    const logs = await tidewaveLogger.getLogs({
       tail: args.tail,
       grep: args.grep,
       level: args.level,
@@ -16370,7 +16570,7 @@ var init_mcp2 = __esm(() => {
   init_package();
   init_core();
   init_src();
-  init_circular_buffer();
+  init_tidewave_logger();
   ({
     docs: { mcp: docsMcp },
     source: { mcp: sourceMcp },
@@ -16991,7 +17191,7 @@ init_mcp2();
 
 // src/cli/install.ts
 import * as fs2 from "fs";
-import * as path5 from "path";
+import * as path6 from "path";
 import * as child_process from "child_process";
 import * as readline from "readline";
 async function handleInstall(options) {
@@ -17039,7 +17239,7 @@ The installer only works for Next.js projects
 }
 async function detectNextJsVersion(dir) {
   try {
-    const nextPackageJsonPath = path5.join(dir, "node_modules", "next", "package.json");
+    const nextPackageJsonPath = path6.join(dir, "node_modules", "next", "package.json");
     if (!fs2.existsSync(nextPackageJsonPath)) {
       return null;
     }
@@ -17059,13 +17259,13 @@ async function detectNextJsVersion(dir) {
   }
 }
 function detectPackageManager(dir) {
-  if (fs2.existsSync(path5.join(dir, "bun.lockb")))
+  if (fs2.existsSync(path6.join(dir, "bun.lockb")))
     return "bun";
-  if (fs2.existsSync(path5.join(dir, "pnpm-lock.yaml")))
+  if (fs2.existsSync(path6.join(dir, "pnpm-lock.yaml")))
     return "pnpm";
-  if (fs2.existsSync(path5.join(dir, "yarn.lock")))
+  if (fs2.existsSync(path6.join(dir, "yarn.lock")))
     return "yarn";
-  if (fs2.existsSync(path5.join(dir, "package-lock.json")))
+  if (fs2.existsSync(path6.join(dir, "package-lock.json")))
     return "npm";
   return "npm";
 }
@@ -17134,8 +17334,8 @@ Please install manually:
   }
 }
 async function createApiHandler(dir, dryRun) {
-  const apiDir = path5.join(dir, "pages", "api");
-  const handlerPath = path5.join(apiDir, "tidewave.ts");
+  const apiDir = path6.join(dir, "pages", "api");
+  const handlerPath = path6.join(apiDir, "tidewave.ts");
   const handlerContent = `import type { NextApiRequest, NextApiResponse } from 'next';
 
 export default async function handler(
@@ -17160,28 +17360,28 @@ export const config = {
 `;
   if (fs2.existsSync(handlerPath)) {
     if (dryRun) {
-      console.log(source_default.gray(`[DRY RUN] Would ask to overwrite: ${path5.relative(dir, handlerPath)}`));
+      console.log(source_default.gray(`[DRY RUN] Would ask to overwrite: ${path6.relative(dir, handlerPath)}`));
       return;
     }
     const shouldOverwrite = await promptUser(source_default.yellow(`
-⚠️ ${path5.relative(dir, handlerPath)} already exists. Overwrite? (Y/n): `));
+⚠️ ${path6.relative(dir, handlerPath)} already exists. Overwrite? (Y/n): `));
     if (!shouldOverwrite) {
-      console.log(source_default.gray(`⏭️ Skipping: ${path5.relative(dir, handlerPath)}`));
+      console.log(source_default.gray(`⏭️ Skipping: ${path6.relative(dir, handlerPath)}`));
       return;
     }
   }
   if (dryRun) {
-    console.log(source_default.gray(`[DRY RUN] Would create: ${path5.relative(dir, handlerPath)}`));
+    console.log(source_default.gray(`[DRY RUN] Would create: ${path6.relative(dir, handlerPath)}`));
     return;
   }
   fs2.mkdirSync(apiDir, { recursive: true });
   fs2.writeFileSync(handlerPath, handlerContent, "utf-8");
-  console.log(source_default.green(`✅ Created: ${path5.relative(dir, handlerPath)}`));
+  console.log(source_default.green(`✅ Created: ${path6.relative(dir, handlerPath)}`));
 }
 async function createMiddleware(dir, nextVersion, dryRun) {
   const isNext16Plus = nextVersion.major >= 16;
   const fileName = isNext16Plus ? "proxy.ts" : "middleware.ts";
-  const filePath = path5.join(dir, fileName);
+  const filePath = path6.join(dir, fileName);
   if (fs2.existsSync(filePath)) {
     console.log(source_default.yellow(`⏭️ ${fileName} already exists`));
     const content = fs2.readFileSync(filePath, "utf-8");
@@ -17245,9 +17445,9 @@ function printMiddlewareInstructions(isNext16Plus) {
   console.log();
 }
 async function createInstrumentation(dir, dryRun) {
-  const rootPath = path5.join(dir, "instrumentation.ts");
-  const srcPath = path5.join(dir, "src", "instrumentation.ts");
-  const hasSrcDir = fs2.existsSync(path5.join(dir, "src"));
+  const rootPath = path6.join(dir, "instrumentation.ts");
+  const srcPath = path6.join(dir, "src", "instrumentation.ts");
+  const hasSrcDir = fs2.existsSync(path6.join(dir, "src"));
   const instrumentationPath = hasSrcDir ? srcPath : rootPath;
   if (fs2.existsSync(rootPath) || fs2.existsSync(srcPath)) {
     const existingPath = fs2.existsSync(rootPath) ? rootPath : srcPath;
@@ -17296,14 +17496,14 @@ export async function register() {
 }
 `;
   if (dryRun) {
-    console.log(source_default.gray(`[DRY RUN] Would create: ${path5.relative(dir, instrumentationPath)}`));
+    console.log(source_default.gray(`[DRY RUN] Would create: ${path6.relative(dir, instrumentationPath)}`));
     return;
   }
   if (hasSrcDir) {
-    fs2.mkdirSync(path5.dirname(instrumentationPath), { recursive: true });
+    fs2.mkdirSync(path6.dirname(instrumentationPath), { recursive: true });
   }
   fs2.writeFileSync(instrumentationPath, instrumentationContent, "utf-8");
-  console.log(source_default.green(`✅ Created: ${path5.relative(dir, instrumentationPath)}`));
+  console.log(source_default.green(`✅ Created: ${path6.relative(dir, instrumentationPath)}`));
 }
 function printInstrumentationInstructions() {
   console.log(source_default.cyan(`  // Inside your register() function:
@@ -17322,9 +17522,9 @@ function printInstrumentationInstructions() {
 }
 
 // src/cli/index.ts
-function chdir(path6) {
+function chdir(path7) {
   try {
-    process.chdir(path6);
+    process.chdir(path7);
   } catch (e) {
     console.error(source_default.red(`Failed to apply given prefix: ${e}`));
   }