@visulima/error 4.4.18 → 4.5.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## @visulima/error [4.5.0](https://github.com/visulima/visulima/compare/@visulima/error@4.4.18...@visulima/error@4.5.0) (2025-09-07)
+
+### Features
+
+* add error solution finder, added new format helper for trace ([82508bc](https://github.com/visulima/visulima/commit/82508bc42476da034b10c4023c823755a3c6b120))
+
+### Bug Fixes
+
+* **error:** remove find cache dir dependency and add caching interface ([#514](https://github.com/visulima/visulima/issues/514)) ([caa1bfa](https://github.com/visulima/visulima/commit/caa1bfaf656009d76bcc2991e4a7ff706451670d))
+
+### Miscellaneous Chores
+
+* update dependencies and remove obsolete documentation ([9e5e3c2](https://github.com/visulima/visulima/commit/9e5e3c2a68acf50d4b7abf8545d0edb85bb89078))
+* update LICENSE.md with bundled dependencies and their licenses; add new fixture in pnpm-lock.yaml ([49d02a7](https://github.com/visulima/visulima/commit/49d02a7307168d9d2400e846d6f822a631d536e7))
+
 ## @visulima/error [4.4.18](https://github.com/visulima/visulima/compare/@visulima/error@4.4.17...@visulima/error@4.4.18) (2025-06-04)
 
 

package/LICENSE.md

@@ -27,6 +27,131 @@ The published @visulima/error artifact additionally contains code with the follo
 MIT
 
 # Bundled dependencies:
+## @visulima/path
+License: MIT
+By: Daniel Bannert
+Repository: git+https://github.com/visulima/visulima.git
+
+> MIT License
+>
+> Copyright (c) 2024 visulima
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.
+>
+> ---
+>
+> MIT License
+>
+> Copyright (c) Pooya Parsa <pooya@pi0.io> - Daniel Roe <daniel@roe.dev>
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.
+>
+> ---
+>
+> Copyright Joyent, Inc. and other Node contributors.
+>
+> Permission is hereby granted, free of charge, to any person obtaining a
+> copy of this software and associated documentation files (the
+> "Software"), to deal in the Software without restriction, including
+> without limitation the rights to use, copy, modify, merge, publish,
+> distribute, sublicense, and/or sell copies of the Software, and to permit
+> persons to whom the Software is furnished to do so, subject to the
+> following conditions:
+>
+> The above copyright notice and this permission notice shall be included
+> in all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+> OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+> MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+> NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+> DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+> OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+> USE OR OTHER DEALINGS IN THE SOFTWARE.
+>
+> ---
+>
+> Bundled zeptomatch (https://github.com/fabiospampinato/zeptomatch)
+>
+> The MIT License (MIT)
+>
+> Copyright (c) 2023-present Fabio Spampinato
+>
+> Permission is hereby granted, free of charge, to any person obtaining a
+> copy of this software and associated documentation files (the "Software"),
+> to deal in the Software without restriction, including without limitation
+> the rights to use, copy, modify, merge, publish, distribute, sublicense,
+> and/or sell copies of the Software, and to permit persons to whom the
+> Software is furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+> FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+> DEALINGS IN THE SOFTWARE.
+>
+>
+>
+> # Licenses of bundled dependencies
+> The published @visulima/path artifact additionally contains code with the following licenses:
+> MIT
+>
+> # Bundled dependencies:
+> ## binary-extensions
+> License: MIT
+> By: Sindre Sorhus
+> Repository: sindresorhus/binary-extensions
+>
+> > MIT License
+> >
+> > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+> > Copyright (c) Paul Miller (https://paulmillr.com)
+> >
+> > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+> >
+> > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+> >
+> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---------------------------------------
+
 ## is-plain-obj
 License: MIT
 By: Sindre Sorhus

package/README.md

@@ -39,6 +39,21 @@ yarn add @visulima/error
 pnpm add @visulima/error
 ```
 
+### Optional: AI integration
+
+If you want to generate AI-powered solution hints, install these optional peer dependencies in your app:
+
+```sh
+# pnpm
+pnpm add ai
+
+# npm
+npm i ai
+
+# yarn
+yarn add ai
+```
+
 ## Usage
 
 ### Extend the VisulimaError
@@ -228,6 +243,109 @@ console.log(stack);
 // ];
 ```
 
+### Format stacktrace to a string
+
+Turn parsed frames into a printable stack string (Node-style), optionally with a header line.
+
+```ts
+import { parseStacktrace, stringifyStackFrames, formatStackFrameLine } from "@visulima/error";
+
+const error = new Error("Boom");
+
+const frames = parseStacktrace(error);
+
+// Full stack as a single string with a header ("Error: Boom")
+const stackText = stringifyStackFrames(frames, {
+    header: { name: error.name, message: error.message },
+});
+console.log(stackText);
+
+// Format a single frame line (e.g., for custom rendering)
+const firstLine = formatStackFrameLine(frames[0]);
+```
+
+#### API
+
+- `stringifyStackFrames(frames, options?)`
+  - `frames`: `Trace[]` — parsed frames from `parseStacktrace`
+  - `options.header`: `{ name?: string; message?: string }` — optional first-line header
+- `formatStackFrameLine(frame)`
+  - `frame`: `Trace`
+  - returns a single formatted line like `"    at myMethod (/path/file.ts:10:5)"`
+
+## Solutions (finders)
+
+Generate helpful hints to fix an error. Two finders ship out of the box:
+
+- Rule-based finder: provides best-effort fixes for common errors (ESM/CJS mix, missing default export, DNS issues, hydration mismatch, etc.)
+- Error-hint finder: reads `error.hint` you attach to an `Error` or `VisulimaError`
+
+Both return a `Solution` (`{ header?: string; body: string }`) or `undefined`.
+
+```ts
+import { codeFrame } from "@visulima/error";
+import { ruleBasedFinder, errorHintFinder } from "@visulima/error";
+
+const error = new Error("Cannot read properties of undefined (reading 'x')");
+
+const source = "const o = undefined\nconsole.log(o.x)\n";
+const snippet = codeFrame(source, { start: { line: 2, column: 13 } });
+
+const fileCtx = {
+    file: "/path/to/file.ts",
+    line: 2,
+    language: "ts",
+    snippet,
+};
+
+// 1) Rule-based finder
+const ruleHint = await ruleBasedFinder.handle(error, fileCtx);
+if (ruleHint) {
+    console.log(ruleHint.header);
+    console.log(ruleHint.body);
+}
+
+// 2) Error-hint finder (reads error.hint)
+const custom = new Error("failed") as Error & { hint?: unknown };
+custom.hint = ["Check the environment variables.", "Ensure the service is reachable."];
+const hintHint = await errorHintFinder.handle(custom, { file: "", line: 0 });
+```
+
+### AI solution helper (optional)
+
+You can build an AI prompt with rich context and render the LLM result into a nice HTML snippet.
+
+```ts
+import { aiPrompt, aiSolutionResponse } from "@visulima/error/solution/ai";
+// or
+// import aiPrompt from "@visulima/error/solution/ai/prompt";
+
+const prompt = aiPrompt({
+    applicationType: undefined,
+    error,
+    file: fileCtx,
+});
+
+// Send `prompt` to your LLM of choice.
+// When you receive the model's text output, format it for display:
+const html = aiSolutionResponse(modelText);
+```
+
+You may also use a convenience finder that calls an AI provider for you (requires optional peer dep `ai`):
+
+```ts
+import { aiFinder } from "@visulima/error/solution/ai";
+import { createOpenAI } from "@ai-sdk/openai";
+
+const client = createOpenAI(apiKey ? { apiKey } : undefined);
+
+const findAI = aiFinder(client(modelId), {
+    temperature: 0,
+});
+
+const aiHint = await findAI.handle(error, fileCtx);
+```
+
 ### API
 
 #### error

package/dist/index.cjs

@@ -4,18 +4,27 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 
 const codeFrame_index = require('./code-frame/index.cjs');
 const indexToLineColumn = require('./packem_shared/indexToLineColumn-DjmjeiIY.cjs');
+const solution_ai_aiPrompt = require('./solution/ai/ai-prompt.cjs');
+const aiSolutionResponse = require('./packem_shared/aiSolutionResponse-BPckbL56.cjs');
+const errorHintFinder = require('./packem_shared/errorHintFinder-DZugFHq0.cjs');
+const ruleBasedFinder = require('./packem_shared/ruleBasedFinder-y_-5kbeT.cjs');
 const captureRawStackTrace = require('./packem_shared/captureRawStackTrace-ClSI1tHb.cjs');
 const getErrorCauses = require('./packem_shared/getErrorCauses-miTeYJEG.cjs');
 const parseStacktrace = require('./packem_shared/parseStacktrace-6pFoXW43.cjs');
 const isVisulimaError = require('./packem_shared/isVisulimaError-BVLWvREw.cjs');
 const renderError = require('./packem_shared/renderError-CXZTAXig.cjs');
 const serializeError = require('./packem_shared/serializeError-CT7s0Ffk.cjs');
+const formatStackFrameLine = require('./packem_shared/formatStackFrameLine-DcXSX--m.cjs');
 
 
 
 exports.CODE_FRAME_POINTER = codeFrame_index.CODE_FRAME_POINTER;
 exports.codeFrame = codeFrame_index.codeFrame;
 exports.indexToLineColumn = indexToLineColumn;
+exports.aiPrompt = solution_ai_aiPrompt;
+exports.aiSolutionResponse = aiSolutionResponse;
+exports.errorHintFinder = errorHintFinder;
+exports.ruleBasedFinder = ruleBasedFinder;
 exports.captureRawStackTrace = captureRawStackTrace;
 exports.getErrorCauses = getErrorCauses;
 exports.parseStacktrace = parseStacktrace;
@@ -23,3 +32,5 @@ exports.VisulimaError = isVisulimaError.VisulimaError;
 exports.isVisulimaError = isVisulimaError.isVisulimaError;
 exports.renderError = renderError.renderError;
 exports.serializeError = serializeError.serialize;
+exports.formatStackFrameLine = formatStackFrameLine.formatStackFrameLine;
+exports.formatStacktrace = formatStackFrameLine.formatStacktrace;

package/dist/index.d.cts

@@ -1,6 +1,10 @@
 export { CODE_FRAME_POINTER, codeFrame } from './code-frame/index.cjs';
+export { default as aiPrompt } from './solution/ai/ai-prompt.cjs';
+export { a as aiSolutionResponse } from './packem_shared/ai-solution-response-BuaDQAEU.cjs';
+export { errorHintFinder, ruleBasedFinder } from './solution/index.cjs';
+export { S as Solution, a as SolutionError, b as SolutionFinder, c as SolutionFinderFile } from './packem_shared/types-BtQS7FHG.cjs';
 export { ErrorHint, ErrorLocation, ErrorProperties, ErrorWithCauseSerializerOptions, RenderErrorOptions, SerializedError, VisulimaError, captureRawStackTrace, getErrorCauses, isVisulimaError, renderError, serializeError } from './error/index.cjs';
-export { Trace, TraceType, parseStacktrace } from './stacktrace/index.cjs';
+export { Trace, TraceType, formatStackFrameLine, formatStacktrace, parseStacktrace } from './stacktrace/index.cjs';
 export { C as CodeFrameLocation, a as CodeFrameNodeLocation, b as CodeFrameOptions, c as ColorizeMethod } from './packem_shared/types-CrVmNoPV.cjs';
 
 declare const indexToLineColumn: (input: number[] | string, index: number, options?: {

package/dist/index.d.mts

@@ -1,6 +1,10 @@
 export { CODE_FRAME_POINTER, codeFrame } from './code-frame/index.mjs';
+export { default as aiPrompt } from './solution/ai/ai-prompt.mjs';
+export { a as aiSolutionResponse } from './packem_shared/ai-solution-response-BuaDQAEU.mjs';
+export { errorHintFinder, ruleBasedFinder } from './solution/index.mjs';
+export { S as Solution, a as SolutionError, b as SolutionFinder, c as SolutionFinderFile } from './packem_shared/types-BtQS7FHG.mjs';
 export { ErrorHint, ErrorLocation, ErrorProperties, ErrorWithCauseSerializerOptions, RenderErrorOptions, SerializedError, VisulimaError, captureRawStackTrace, getErrorCauses, isVisulimaError, renderError, serializeError } from './error/index.mjs';
-export { Trace, TraceType, parseStacktrace } from './stacktrace/index.mjs';
+export { Trace, TraceType, formatStackFrameLine, formatStacktrace, parseStacktrace } from './stacktrace/index.mjs';
 export { C as CodeFrameLocation, a as CodeFrameNodeLocation, b as CodeFrameOptions, c as ColorizeMethod } from './packem_shared/types-CrVmNoPV.mjs';
 
 declare const indexToLineColumn: (input: number[] | string, index: number, options?: {

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 export { CODE_FRAME_POINTER, codeFrame } from './code-frame/index.js';
+export { default as aiPrompt } from './solution/ai/ai-prompt.js';
+export { a as aiSolutionResponse } from './packem_shared/ai-solution-response-BuaDQAEU.js';
+export { errorHintFinder, ruleBasedFinder } from './solution/index.js';
+export { S as Solution, a as SolutionError, b as SolutionFinder, c as SolutionFinderFile } from './packem_shared/types-BtQS7FHG.js';
 export { ErrorHint, ErrorLocation, ErrorProperties, ErrorWithCauseSerializerOptions, RenderErrorOptions, SerializedError, VisulimaError, captureRawStackTrace, getErrorCauses, isVisulimaError, renderError, serializeError } from './error/index.js';
-export { Trace, TraceType, parseStacktrace } from './stacktrace/index.js';
+export { Trace, TraceType, formatStackFrameLine, formatStacktrace, parseStacktrace } from './stacktrace/index.js';
 export { C as CodeFrameLocation, a as CodeFrameNodeLocation, b as CodeFrameOptions, c as ColorizeMethod } from './packem_shared/types-CrVmNoPV.js';
 
 declare const indexToLineColumn: (input: number[] | string, index: number, options?: {

package/dist/index.mjs

@@ -1,8 +1,13 @@
 export { CODE_FRAME_POINTER, codeFrame } from './code-frame/index.mjs';
 export { default as indexToLineColumn } from './packem_shared/indexToLineColumn-Dx91YDU1.mjs';
+export { default as aiPrompt } from './solution/ai/ai-prompt.mjs';
+export { default as aiSolutionResponse } from './packem_shared/aiSolutionResponse-bDi4ad8f.mjs';
+export { default as errorHintFinder } from './packem_shared/errorHintFinder-CQy_qIK3.mjs';
+export { default as ruleBasedFinder } from './packem_shared/ruleBasedFinder-BYrndubA.mjs';
 export { default as captureRawStackTrace } from './packem_shared/captureRawStackTrace-Tl3Rqkat.mjs';
 export { default as getErrorCauses } from './packem_shared/getErrorCauses-CG_JRE6j.mjs';
 export { default as parseStacktrace } from './packem_shared/parseStacktrace-BKGoWCwC.mjs';
 export { VisulimaError, isVisulimaError } from './packem_shared/isVisulimaError-H6TqEA42.mjs';
 export { renderError } from './packem_shared/renderError-BWpM2m6k.mjs';
 export { serialize as serializeError } from './packem_shared/serializeError-DusTUACt.mjs';
+export { formatStackFrameLine, formatStacktrace } from './packem_shared/formatStackFrameLine-DqkmKWH3.mjs';

package/dist/packem_shared/ai-solution-response-BuaDQAEU.d.cts

@@ -0,0 +1,3 @@
+declare const aiSolutionResponse: (rawText: string) => string;
+
+export { aiSolutionResponse as a };

package/dist/packem_shared/ai-solution-response-BuaDQAEU.d.mts

@@ -0,0 +1,3 @@
+declare const aiSolutionResponse: (rawText: string) => string;
+
+export { aiSolutionResponse as a };

package/dist/packem_shared/ai-solution-response-BuaDQAEU.d.ts

@@ -0,0 +1,3 @@
+declare const aiSolutionResponse: (rawText: string) => string;
+
+export { aiSolutionResponse as a };

package/dist/packem_shared/aiFinder-BGfwKKxE.cjs

@@ -0,0 +1,263 @@
+'use strict';
+
+const node_crypto = require('node:crypto');
+const node_fs = require('node:fs');
+const node_os = require('node:os');
+const ai = require('ai');
+const solution_ai_aiPrompt = require('../solution/ai/ai-prompt.cjs');
+const aiSolutionResponse = require('./aiSolutionResponse-BPckbL56.cjs');
+
+var __defProp$1 = Object.defineProperty;
+var __name$1 = (target, value) => __defProp$1(target, "name", { value, configurable: true });
+var __defProp$1$1 = Object.defineProperty;
+var __name$1$1 = /* @__PURE__ */ __name$1((target, value) => __defProp$1$1(target, "name", { value, configurable: true }), "__name$1");
+const DRIVE_LETTER_START_RE = /^[A-Z]:\//i;
+const normalizeWindowsPath = /* @__PURE__ */ __name$1$1((input = "") => {
+  if (!input) {
+    return input;
+  }
+  return input.replaceAll("\\", "/").replace(DRIVE_LETTER_START_RE, (r) => r.toUpperCase());
+}, "normalizeWindowsPath");
+var __defProp2 = Object.defineProperty;
+var __name2 = /* @__PURE__ */ __name$1((target, value) => __defProp2(target, "name", { value, configurable: true }), "__name");
+const UNC_REGEX = /^[/\\]{2}/;
+const IS_ABSOLUTE_RE = /^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^[A-Z]:[/\\]/i;
+const DRIVE_LETTER_RE = /^[A-Z]:$/i;
+const normalizeString = /* @__PURE__ */ __name2((path2, allowAboveRoot) => {
+  let result = "";
+  let lastSegmentLength = 0;
+  let lastSlash = -1;
+  let dots = 0;
+  let char = null;
+  for (let index = 0; index <= path2.length; ++index) {
+    if (index < path2.length) {
+      char = path2[index];
+    } else if (char === "/") {
+      break;
+    } else {
+      char = "/";
+    }
+    if (char === "/") {
+      if (lastSlash === index - 1 || dots === 1) ;
+      else if (dots === 2) {
+        if (result.length < 2 || lastSegmentLength !== 2 || !result.endsWith(".") || result.at(-2) !== ".") {
+          if (result.length > 2) {
+            const lastSlashIndex = result.lastIndexOf("/");
+            if (lastSlashIndex === -1) {
+              result = "";
+              lastSegmentLength = 0;
+            } else {
+              result = result.slice(0, lastSlashIndex);
+              lastSegmentLength = result.length - 1 - result.lastIndexOf("/");
+            }
+            lastSlash = index;
+            dots = 0;
+            continue;
+          } else if (result.length > 0) {
+            result = "";
+            lastSegmentLength = 0;
+            lastSlash = index;
+            dots = 0;
+            continue;
+          }
+        }
+        if (allowAboveRoot) {
+          result += result.length > 0 ? "/.." : "..";
+          lastSegmentLength = 2;
+        }
+      } else {
+        if (result.length > 0) {
+          result += `/${path2.slice(lastSlash + 1, index)}`;
+        } else {
+          result = path2.slice(lastSlash + 1, index);
+        }
+        lastSegmentLength = index - lastSlash - 1;
+      }
+      lastSlash = index;
+      dots = 0;
+    } else if (char === "." && dots !== -1) {
+      ++dots;
+    } else {
+      dots = -1;
+    }
+  }
+  return result;
+}, "normalizeString");
+const isAbsolute = /* @__PURE__ */ __name2((path2) => IS_ABSOLUTE_RE.test(path2), "isAbsolute");
+const normalize = /* @__PURE__ */ __name2(function(path2) {
+  if (path2.length === 0) {
+    return ".";
+  }
+  path2 = normalizeWindowsPath(path2);
+  const isUNCPath = UNC_REGEX.exec(path2);
+  const isPathAbsolute = isAbsolute(path2);
+  const trailingSeparator = path2.at(-1) === "/";
+  path2 = normalizeString(path2, !isPathAbsolute);
+  if (path2.length === 0) {
+    if (isPathAbsolute) {
+      return "/";
+    }
+    return trailingSeparator ? "./" : ".";
+  }
+  if (trailingSeparator) {
+    path2 += "/";
+  }
+  if (DRIVE_LETTER_RE.test(path2)) {
+    path2 += "/";
+  }
+  if (isUNCPath) {
+    if (!isPathAbsolute) {
+      return `//./${path2}`;
+    }
+    return `//${path2}`;
+  }
+  return isPathAbsolute && !isAbsolute(path2) ? `/${path2}` : path2;
+}, "normalize");
+const join = /* @__PURE__ */ __name2((...segments) => {
+  let path2 = "";
+  for (const seg of segments) {
+    if (!seg) {
+      continue;
+    }
+    if (path2.length > 0) {
+      const pathTrailing = path2[path2.length - 1] === "/";
+      const segLeading = seg[0] === "/";
+      const both = pathTrailing && segLeading;
+      if (both) {
+        path2 += seg.slice(1);
+      } else {
+        path2 += pathTrailing || segLeading ? seg : `/${seg}`;
+      }
+    } else {
+      path2 += seg;
+    }
+  }
+  return normalize(path2);
+}, "join");
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const DEFAULT_HEADER = "## Ai Generated Solution";
+const DEFAULT_ERROR_MESSAGE = "Creation of a AI solution failed.";
+const generateCacheKey = /* @__PURE__ */ __name((error, file, temperature) => {
+  const keyData = {
+    error: {
+      name: error.name,
+      message: error.message,
+      stack: error.stack
+    },
+    file: {
+      file: file.file,
+      language: file.language,
+      line: file.line,
+      snippet: file.snippet
+    },
+    temperature
+  };
+  return node_crypto.createHash("sha256").update(JSON.stringify(keyData)).digest("hex");
+}, "generateCacheKey");
+const getCacheDirectory = /* @__PURE__ */ __name((directory) => {
+  if (directory) {
+    return directory;
+  }
+  return join(node_os.tmpdir(), "visulima-error-cache");
+}, "getCacheDirectory");
+const ensureCacheDirectory = /* @__PURE__ */ __name((cacheDir) => {
+  if (!node_fs.existsSync(cacheDir)) {
+    node_fs.mkdirSync(cacheDir, { recursive: true });
+  }
+}, "ensureCacheDirectory");
+const getCacheFilePath = /* @__PURE__ */ __name((cacheDir, key) => {
+  return join(cacheDir, `${key}.json`);
+}, "getCacheFilePath");
+const readFromCache = /* @__PURE__ */ __name((cacheFilePath, ttl) => {
+  try {
+    if (!node_fs.existsSync(cacheFilePath)) {
+      return null;
+    }
+    const cacheContent = node_fs.readFileSync(cacheFilePath, "utf-8");
+    const cacheEntry = JSON.parse(cacheContent);
+    const now = Date.now();
+    if (now - cacheEntry.timestamp > ttl) {
+      return null;
+    }
+    return cacheEntry.solution;
+  } catch {
+    return null;
+  }
+}, "readFromCache");
+const writeToCache = /* @__PURE__ */ __name((cacheFilePath, solution, ttl) => {
+  try {
+    const cacheEntry = {
+      solution,
+      timestamp: Date.now(),
+      ttl
+    };
+    node_fs.writeFileSync(cacheFilePath, JSON.stringify(cacheEntry, null, 2), "utf-8");
+  } catch {
+  }
+}, "writeToCache");
+const aiFinder = /* @__PURE__ */ __name((model, options) => {
+  return {
+    handle: /* @__PURE__ */ __name(async (error, file) => {
+      const cacheOptions = options?.cache;
+      const temperature = options?.temperature ?? 0;
+      const ttl = cacheOptions?.ttl ?? 24 * 60 * 60 * 1e3;
+      if (cacheOptions?.enabled !== false) {
+        const cacheKey = generateCacheKey(error, file, temperature);
+        const cacheDir = getCacheDirectory(cacheOptions?.directory);
+        const cacheFilePath = getCacheFilePath(cacheDir, cacheKey);
+        const cachedSolution = readFromCache(cacheFilePath, ttl);
+        if (cachedSolution) {
+          return cachedSolution;
+        }
+        ensureCacheDirectory(cacheDir);
+      }
+      const content = solution_ai_aiPrompt({ applicationType: void 0, error, file });
+      try {
+        const result = await ai.generateText({
+          model,
+          prompt: content,
+          temperature
+        });
+        const messageContent = result.text;
+        let solution;
+        if (!messageContent) {
+          solution = {
+            body: aiSolutionResponse(DEFAULT_ERROR_MESSAGE),
+            header: DEFAULT_HEADER
+          };
+        } else {
+          solution = {
+            body: aiSolutionResponse(messageContent),
+            header: DEFAULT_HEADER
+          };
+        }
+        if (cacheOptions?.enabled !== false) {
+          const cacheKey = generateCacheKey(error, file, temperature);
+          const cacheDir = getCacheDirectory(cacheOptions?.directory);
+          const cacheFilePath = getCacheFilePath(cacheDir, cacheKey);
+          writeToCache(cacheFilePath, solution, ttl);
+        }
+        return solution;
+      } catch (error_) {
+        console.error(error_);
+        const solution = {
+          body: aiSolutionResponse(DEFAULT_ERROR_MESSAGE),
+          header: DEFAULT_HEADER
+        };
+        if (cacheOptions?.enabled !== false) {
+          const cacheKey = generateCacheKey(error, file, temperature);
+          const cacheDir = getCacheDirectory(cacheOptions?.directory);
+          const cacheFilePath = getCacheFilePath(cacheDir, cacheKey);
+          writeToCache(cacheFilePath, solution, ttl);
+        }
+        return solution;
+      }
+    }, "handle"),
+    name: "AI SDK",
+    priority: 99
+  };
+}, "aiFinder");
+
+module.exports = aiFinder;