@nhtio/adk 1.20260607.2 → 1.20260609.0

package/batteries/tools/encoding.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.cjs","names":[],"sources":["../../../src/batteries/tools/encoding/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for common text encodings and decoding operations.\n *\n * @module @nhtio/adk/batteries/tools/encoding\n *\n * @remarks\n * Pre-constructed bundled tools for the `encoding` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\nconst utf8ToBase64 = (text: string): string => {\n  const bytes = new TextEncoder().encode(text)\n  let binary = ''\n  for (const byte of bytes) binary += String.fromCharCode(byte)\n  return globalThis.btoa(binary)\n}\n\nconst base64ToUtf8 = (b64: string): string => {\n  const binary = globalThis.atob(b64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n  return new TextDecoder().decode(bytes)\n}\n\n/**\n * Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.\n *\n * @remarks\n * `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,\n * and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than\n * thrown so the model can react in-line.\n */\nexport const encodeTextTool = new Tool({\n  name: 'encode_text',\n  description:\n    'Encode or decode text using common schemes: base64, url (percent-encoding), html_entities. Specify direction: encode or decode.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to encode or decode'),\n    scheme: validator\n      .string()\n      .valid('base64', 'url', 'html_entities')\n      .required()\n      .description('Encoding scheme'),\n    direction: validator\n      .string()\n      .valid('encode', 'decode')\n      .default('encode')\n      .description('Whether to encode or decode (default: encode)'),\n  }),\n  handler: async (args) => {\n    const { text, scheme, direction } = args as {\n      text: string\n      scheme: string\n      direction: string\n    }\n\n    try {\n      if (scheme === 'base64') {\n        if (direction === 'encode') return utf8ToBase64(text)\n        return base64ToUtf8(text)\n      }\n\n      if (scheme === 'url') {\n        if (direction === 'encode') return encodeURIComponent(text)\n        return decodeURIComponent(text)\n      }\n\n      if (scheme === 'html_entities') {\n        if (direction === 'encode') {\n          return text\n            .replace(/&/g, '&amp;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;')\n            .replace(/\"/g, '&quot;')\n            .replace(/'/g, '&#39;')\n        }\n        return text\n          .replace(/&amp;/g, '&')\n          .replace(/&lt;/g, '<')\n          .replace(/&gt;/g, '>')\n          .replace(/&quot;/g, '\"')\n          .replace(/&#39;/g, \"'\")\n          .replace(/&#(\\d+);/g, (_, code: string) => String.fromCharCode(Number.parseInt(code, 10)))\n          .replace(/&#x([0-9a-fA-F]+);/g, (_, hex: string) =>\n            String.fromCharCode(Number.parseInt(hex, 16))\n          )\n      }\n\n      return `Error: Unknown scheme \"${scheme}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Escape or unescape special characters for a target context.\n *\n * @remarks\n * Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns\n * an error string for unknown targets rather than throwing.\n */\nexport const textEscapeTool = new Tool({\n  name: 'text_escape',\n  description:\n    'Escape or unescape special characters for a target context: json_string, regex, csv_field, sql_like, markdown.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to escape or unescape'),\n    target: validator\n      .string()\n      .valid('json_string', 'regex', 'csv_field', 'sql_like', 'markdown')\n      .required()\n      .description('Target context for escaping'),\n    direction: validator\n      .string()\n      .valid('escape', 'unescape')\n      .default('escape')\n      .description('Whether to escape or unescape (default: escape)'),\n  }),\n  handler: async (args) => {\n    const { text, target, direction } = args as {\n      text: string\n      target: string\n      direction: string\n    }\n\n    try {\n      if (target === 'json_string') {\n        if (direction === 'escape') return JSON.stringify(text).slice(1, -1)\n        return JSON.parse(`\"${text}\"`) as string\n      }\n\n      if (target === 'regex') {\n        if (direction === 'escape') return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([.*+?^${}()|[\\]\\\\])/g, '$1')\n      }\n\n      if (target === 'csv_field') {\n        if (direction === 'escape') {\n          if (/[,\"\\n\\r]/.test(text)) return `\"${text.replace(/\"/g, '\"\"')}\"`\n          return text\n        }\n        if (text.startsWith('\"') && text.endsWith('\"')) {\n          return text.slice(1, -1).replace(/\"\"/g, '\"')\n        }\n        return text\n      }\n\n      if (target === 'sql_like') {\n        if (direction === 'escape') return text.replace(/[%_\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([%_\\\\])/g, '$1')\n      }\n\n      if (target === 'markdown') {\n        const mdChars = /[\\\\`*_{}[\\]()#+\\-.!|]/g\n        if (direction === 'escape') return text.replace(mdChars, '\\\\$&')\n        return text.replace(/\\\\([\\\\`*_{}[\\]()#+\\-.!|])/g, '$1')\n      }\n\n      return `Error: Unknown target \"${target}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Normalize Unicode text or extract code points.\n *\n * @remarks\n * Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),\n * `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or\n * `code_points` (one `U+HHHH (char)` per line).\n */\nexport const unicodeNormalizeTool = new Tool({\n  name: 'unicode_normalize',\n  description:\n    'Normalize Unicode text (NFC, NFD, NFKC, NFKD), strip accents/diacritics, or get Unicode code points for each character.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to process'),\n    operation: validator\n      .string()\n      .valid('nfc', 'nfd', 'nfkc', 'nfkd', 'strip_accents', 'code_points')\n      .required()\n      .description(\n        'Operation: NFC/NFD/NFKC/NFKD normalization, strip_accents (remove diacritics), or code_points (list hex values)'\n      ),\n  }),\n  handler: async (args) => {\n    const { text, operation } = args as { text: string; operation: string }\n\n    try {\n      if (operation === 'strip_accents') {\n        return text.normalize('NFD').replace(/[̀-ͯ]/g, '').normalize('NFC')\n      }\n\n      if (operation === 'code_points') {\n        return [...text]\n          .map((ch) => {\n            const cp = ch.codePointAt(0)!\n            const hex = cp.toString(16).toUpperCase().padStart(4, '0')\n            return `U+${hex} (${ch})`\n          })\n          .join('\\n')\n      }\n\n      const formMap: Record<string, string> = { nfc: 'NFC', nfd: 'NFD', nfkc: 'NFKC', nfkd: 'NFKD' }\n      const form = formMap[operation]\n      if (!form) return `Error: Unknown operation \"${operation}\".`\n      return text.normalize(form)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"encoding.cjs","names":[],"sources":["../../../src/batteries/tools/encoding/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for common text encodings and decoding operations.\n *\n * @module @nhtio/adk/batteries/tools/encoding\n *\n * @remarks\n * Pre-constructed bundled tools for the `encoding` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\nconst utf8ToBase64 = (text: string): string => {\n  const bytes = new TextEncoder().encode(text)\n  let binary = ''\n  for (const byte of bytes) binary += String.fromCharCode(byte)\n  return globalThis.btoa(binary)\n}\n\nconst base64ToUtf8 = (b64: string): string => {\n  const binary = globalThis.atob(b64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n  return new TextDecoder().decode(bytes)\n}\n\n/**\n * Convert a numeric HTML-entity code point to its string, handling astral characters correctly.\n * Returns the original entity text `fallback` for code points outside the valid Unicode range\n * (0 – 0x10FFFF) so `String.fromCodePoint` never throws a RangeError.\n */\nconst codePointToString = (cp: number, fallback: string): string => {\n  if (!Number.isInteger(cp) || cp < 0 || cp > 0x10ffff) return fallback\n  return String.fromCodePoint(cp)\n}\n\n/**\n * Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.\n *\n * @remarks\n * `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,\n * and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than\n * thrown so the model can react in-line.\n */\nexport const encodeTextTool = new Tool({\n  name: 'encode_text',\n  description:\n    'Encode or decode text using common schemes: base64, url (percent-encoding), html_entities. Specify direction: encode or decode.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to encode or decode'),\n    scheme: validator\n      .string()\n      .valid('base64', 'url', 'html_entities')\n      .required()\n      .description('Encoding scheme'),\n    direction: validator\n      .string()\n      .valid('encode', 'decode')\n      .default('encode')\n      .description('Whether to encode or decode (default: encode)'),\n  }),\n  handler: async (args) => {\n    const { text, scheme, direction } = args as {\n      text: string\n      scheme: string\n      direction: string\n    }\n\n    try {\n      if (scheme === 'base64') {\n        if (direction === 'encode') return utf8ToBase64(text)\n        return base64ToUtf8(text)\n      }\n\n      if (scheme === 'url') {\n        if (direction === 'encode') return encodeURIComponent(text)\n        return decodeURIComponent(text)\n      }\n\n      if (scheme === 'html_entities') {\n        if (direction === 'encode') {\n          return text\n            .replace(/&/g, '&amp;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;')\n            .replace(/\"/g, '&quot;')\n            .replace(/'/g, '&#39;')\n        }\n        return (\n          text\n            .replace(/&amp;/g, '&')\n            .replace(/&lt;/g, '<')\n            .replace(/&gt;/g, '>')\n            .replace(/&quot;/g, '\"')\n            .replace(/&#39;/g, \"'\")\n            // Use fromCodePoint, not fromCharCode: a numeric entity above U+FFFF (e.g. an emoji like\n            // &#127881; = 🎉) is an astral code point. fromCharCode truncates to 16 bits and yields a\n            // broken/empty character; fromCodePoint produces the correct surrogate pair. Out-of-range\n            // code points (> U+10FFFF) are left as-is rather than throwing.\n            .replace(/&#(\\d+);/g, (m, code: string) =>\n              codePointToString(Number.parseInt(code, 10), m)\n            )\n            .replace(/&#x([0-9a-fA-F]+);/g, (m, hex: string) =>\n              codePointToString(Number.parseInt(hex, 16), m)\n            )\n        )\n      }\n\n      return `Error: Unknown scheme \"${scheme}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Escape or unescape special characters for a target context.\n *\n * @remarks\n * Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns\n * an error string for unknown targets rather than throwing.\n */\nexport const textEscapeTool = new Tool({\n  name: 'text_escape',\n  description:\n    'Escape or unescape special characters for a target context: json_string, regex, csv_field, sql_like, markdown.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to escape or unescape'),\n    target: validator\n      .string()\n      .valid('json_string', 'regex', 'csv_field', 'sql_like', 'markdown')\n      .required()\n      .description('Target context for escaping'),\n    direction: validator\n      .string()\n      .valid('escape', 'unescape')\n      .default('escape')\n      .description('Whether to escape or unescape (default: escape)'),\n  }),\n  handler: async (args) => {\n    const { text, target, direction } = args as {\n      text: string\n      target: string\n      direction: string\n    }\n\n    try {\n      if (target === 'json_string') {\n        if (direction === 'escape') return JSON.stringify(text).slice(1, -1)\n        return JSON.parse(`\"${text}\"`) as string\n      }\n\n      if (target === 'regex') {\n        if (direction === 'escape') return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([.*+?^${}()|[\\]\\\\])/g, '$1')\n      }\n\n      if (target === 'csv_field') {\n        if (direction === 'escape') {\n          if (/[,\"\\n\\r]/.test(text)) return `\"${text.replace(/\"/g, '\"\"')}\"`\n          return text\n        }\n        if (text.startsWith('\"') && text.endsWith('\"')) {\n          return text.slice(1, -1).replace(/\"\"/g, '\"')\n        }\n        return text\n      }\n\n      if (target === 'sql_like') {\n        if (direction === 'escape') return text.replace(/[%_\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([%_\\\\])/g, '$1')\n      }\n\n      if (target === 'markdown') {\n        const mdChars = /[\\\\`*_{}[\\]()#+\\-.!|]/g\n        if (direction === 'escape') return text.replace(mdChars, '\\\\$&')\n        return text.replace(/\\\\([\\\\`*_{}[\\]()#+\\-.!|])/g, '$1')\n      }\n\n      return `Error: Unknown target \"${target}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Normalize Unicode text or extract code points.\n *\n * @remarks\n * Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),\n * `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or\n * `code_points` (one `U+HHHH (char)` per line).\n */\nexport const unicodeNormalizeTool = new Tool({\n  name: 'unicode_normalize',\n  description:\n    'Normalize Unicode text (NFC, NFD, NFKC, NFKD), strip accents/diacritics, or get Unicode code points for each character.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to process'),\n    operation: validator\n      .string()\n      .valid('nfc', 'nfd', 'nfkc', 'nfkd', 'strip_accents', 'code_points')\n      .required()\n      .description(\n        'Operation: NFC/NFD/NFKC/NFKD normalization, strip_accents (remove diacritics), or code_points (list hex values)'\n      ),\n  }),\n  handler: async (args) => {\n    const { text, operation } = args as { text: string; operation: string }\n\n    try {\n      if (operation === 'strip_accents') {\n        return text.normalize('NFD').replace(/[̀-ͯ]/g, '').normalize('NFC')\n      }\n\n      if (operation === 'code_points') {\n        return [...text]\n          .map((ch) => {\n            const cp = ch.codePointAt(0)!\n            const hex = cp.toString(16).toUpperCase().padStart(4, '0')\n            return `U+${hex} (${ch})`\n          })\n          .join('\\n')\n      }\n\n      const formMap: Record<string, string> = { nfc: 'NFC', nfd: 'NFD', nfkc: 'NFKC', nfkd: 'NFKD' }\n      const form = formMap[operation]\n      if (!form) return `Error: Unknown operation \"${operation}\".`\n      return text.normalize(form)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/encoding.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-D1pSSlsd.mjs";
-import { t as Tool } from "../../tool-CMhaDRNd.mjs";
-import "../../common-BT0nfCi9.mjs";
+import { o as isError } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/encoding/index.ts
@@ -26,6 +26,15 @@ var base64ToUtf8 = (b64) => {
 	return new TextDecoder().decode(bytes);
 };
 /**
+* Convert a numeric HTML-entity code point to its string, handling astral characters correctly.
+* Returns the original entity text `fallback` for code points outside the valid Unicode range
+* (0 – 0x10FFFF) so `String.fromCodePoint` never throws a RangeError.
+*/
+var codePointToString = (cp, fallback) => {
+	if (!Number.isInteger(cp) || cp < 0 || cp > 1114111) return fallback;
+	return String.fromCodePoint(cp);
+};
+/**
 * Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.
 *
 * @remarks
@@ -54,7 +63,7 @@ var encodeTextTool = new Tool({
 			}
 			if (scheme === "html_entities") {
 				if (direction === "encode") return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-				return text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&#(\d+);/g, (_, code) => String.fromCharCode(Number.parseInt(code, 10))).replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+				return text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&#(\d+);/g, (m, code) => codePointToString(Number.parseInt(code, 10), m)).replace(/&#x([0-9a-fA-F]+);/g, (m, hex) => codePointToString(Number.parseInt(hex, 16), m));
 			}
 			return `Error: Unknown scheme "${scheme}".`;
 		} catch (err) {

package/batteries/tools/encoding.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.mjs","names":[],"sources":["../../../src/batteries/tools/encoding/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for common text encodings and decoding operations.\n *\n * @module @nhtio/adk/batteries/tools/encoding\n *\n * @remarks\n * Pre-constructed bundled tools for the `encoding` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\nconst utf8ToBase64 = (text: string): string => {\n  const bytes = new TextEncoder().encode(text)\n  let binary = ''\n  for (const byte of bytes) binary += String.fromCharCode(byte)\n  return globalThis.btoa(binary)\n}\n\nconst base64ToUtf8 = (b64: string): string => {\n  const binary = globalThis.atob(b64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n  return new TextDecoder().decode(bytes)\n}\n\n/**\n * Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.\n *\n * @remarks\n * `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,\n * and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than\n * thrown so the model can react in-line.\n */\nexport const encodeTextTool = new Tool({\n  name: 'encode_text',\n  description:\n    'Encode or decode text using common schemes: base64, url (percent-encoding), html_entities. Specify direction: encode or decode.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to encode or decode'),\n    scheme: validator\n      .string()\n      .valid('base64', 'url', 'html_entities')\n      .required()\n      .description('Encoding scheme'),\n    direction: validator\n      .string()\n      .valid('encode', 'decode')\n      .default('encode')\n      .description('Whether to encode or decode (default: encode)'),\n  }),\n  handler: async (args) => {\n    const { text, scheme, direction } = args as {\n      text: string\n      scheme: string\n      direction: string\n    }\n\n    try {\n      if (scheme === 'base64') {\n        if (direction === 'encode') return utf8ToBase64(text)\n        return base64ToUtf8(text)\n      }\n\n      if (scheme === 'url') {\n        if (direction === 'encode') return encodeURIComponent(text)\n        return decodeURIComponent(text)\n      }\n\n      if (scheme === 'html_entities') {\n        if (direction === 'encode') {\n          return text\n            .replace(/&/g, '&amp;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;')\n            .replace(/\"/g, '&quot;')\n            .replace(/'/g, '&#39;')\n        }\n        return text\n          .replace(/&amp;/g, '&')\n          .replace(/&lt;/g, '<')\n          .replace(/&gt;/g, '>')\n          .replace(/&quot;/g, '\"')\n          .replace(/&#39;/g, \"'\")\n          .replace(/&#(\\d+);/g, (_, code: string) => String.fromCharCode(Number.parseInt(code, 10)))\n          .replace(/&#x([0-9a-fA-F]+);/g, (_, hex: string) =>\n            String.fromCharCode(Number.parseInt(hex, 16))\n          )\n      }\n\n      return `Error: Unknown scheme \"${scheme}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Escape or unescape special characters for a target context.\n *\n * @remarks\n * Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns\n * an error string for unknown targets rather than throwing.\n */\nexport const textEscapeTool = new Tool({\n  name: 'text_escape',\n  description:\n    'Escape or unescape special characters for a target context: json_string, regex, csv_field, sql_like, markdown.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to escape or unescape'),\n    target: validator\n      .string()\n      .valid('json_string', 'regex', 'csv_field', 'sql_like', 'markdown')\n      .required()\n      .description('Target context for escaping'),\n    direction: validator\n      .string()\n      .valid('escape', 'unescape')\n      .default('escape')\n      .description('Whether to escape or unescape (default: escape)'),\n  }),\n  handler: async (args) => {\n    const { text, target, direction } = args as {\n      text: string\n      target: string\n      direction: string\n    }\n\n    try {\n      if (target === 'json_string') {\n        if (direction === 'escape') return JSON.stringify(text).slice(1, -1)\n        return JSON.parse(`\"${text}\"`) as string\n      }\n\n      if (target === 'regex') {\n        if (direction === 'escape') return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([.*+?^${}()|[\\]\\\\])/g, '$1')\n      }\n\n      if (target === 'csv_field') {\n        if (direction === 'escape') {\n          if (/[,\"\\n\\r]/.test(text)) return `\"${text.replace(/\"/g, '\"\"')}\"`\n          return text\n        }\n        if (text.startsWith('\"') && text.endsWith('\"')) {\n          return text.slice(1, -1).replace(/\"\"/g, '\"')\n        }\n        return text\n      }\n\n      if (target === 'sql_like') {\n        if (direction === 'escape') return text.replace(/[%_\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([%_\\\\])/g, '$1')\n      }\n\n      if (target === 'markdown') {\n        const mdChars = /[\\\\`*_{}[\\]()#+\\-.!|]/g\n        if (direction === 'escape') return text.replace(mdChars, '\\\\$&')\n        return text.replace(/\\\\([\\\\`*_{}[\\]()#+\\-.!|])/g, '$1')\n      }\n\n      return `Error: Unknown target \"${target}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Normalize Unicode text or extract code points.\n *\n * @remarks\n * Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),\n * `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or\n * `code_points` (one `U+HHHH (char)` per line).\n */\nexport const unicodeNormalizeTool = new Tool({\n  name: 'unicode_normalize',\n  description:\n    'Normalize Unicode text (NFC, NFD, NFKC, NFKD), strip accents/diacritics, or get Unicode code points for each character.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to process'),\n    operation: validator\n      .string()\n      .valid('nfc', 'nfd', 'nfkc', 'nfkd', 'strip_accents', 'code_points')\n      .required()\n      .description(\n        'Operation: NFC/NFD/NFKC/NFKD normalization, strip_accents (remove diacritics), or code_points (list hex values)'\n      ),\n  }),\n  handler: async (args) => {\n    const { text, operation } = args as { text: string; operation: string }\n\n    try {\n      if (operation === 'strip_accents') {\n        return text.normalize('NFD').replace(/[̀-ͯ]/g, '').normalize('NFC')\n      }\n\n      if (operation === 'code_points') {\n        return [...text]\n          .map((ch) => {\n            const cp = ch.codePointAt(0)!\n            const hex = cp.toString(16).toUpperCase().padStart(4, '0')\n            return `U+${hex} (${ch})`\n          })\n          .join('\\n')\n      }\n\n      const formMap: Record<string, string> = { nfc: 'NFC', nfd: 'NFD', nfkc: 'NFKC', nfkd: 'NFKD' }\n      const form = formMap[operation]\n      if (!form) return `Error: Unknown operation \"${operation}\".`\n      return text.normalize(form)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"encoding.mjs","names":[],"sources":["../../../src/batteries/tools/encoding/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for common text encodings and decoding operations.\n *\n * @module @nhtio/adk/batteries/tools/encoding\n *\n * @remarks\n * Pre-constructed bundled tools for the `encoding` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\nconst utf8ToBase64 = (text: string): string => {\n  const bytes = new TextEncoder().encode(text)\n  let binary = ''\n  for (const byte of bytes) binary += String.fromCharCode(byte)\n  return globalThis.btoa(binary)\n}\n\nconst base64ToUtf8 = (b64: string): string => {\n  const binary = globalThis.atob(b64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n  return new TextDecoder().decode(bytes)\n}\n\n/**\n * Convert a numeric HTML-entity code point to its string, handling astral characters correctly.\n * Returns the original entity text `fallback` for code points outside the valid Unicode range\n * (0 – 0x10FFFF) so `String.fromCodePoint` never throws a RangeError.\n */\nconst codePointToString = (cp: number, fallback: string): string => {\n  if (!Number.isInteger(cp) || cp < 0 || cp > 0x10ffff) return fallback\n  return String.fromCodePoint(cp)\n}\n\n/**\n * Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.\n *\n * @remarks\n * `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,\n * and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than\n * thrown so the model can react in-line.\n */\nexport const encodeTextTool = new Tool({\n  name: 'encode_text',\n  description:\n    'Encode or decode text using common schemes: base64, url (percent-encoding), html_entities. Specify direction: encode or decode.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to encode or decode'),\n    scheme: validator\n      .string()\n      .valid('base64', 'url', 'html_entities')\n      .required()\n      .description('Encoding scheme'),\n    direction: validator\n      .string()\n      .valid('encode', 'decode')\n      .default('encode')\n      .description('Whether to encode or decode (default: encode)'),\n  }),\n  handler: async (args) => {\n    const { text, scheme, direction } = args as {\n      text: string\n      scheme: string\n      direction: string\n    }\n\n    try {\n      if (scheme === 'base64') {\n        if (direction === 'encode') return utf8ToBase64(text)\n        return base64ToUtf8(text)\n      }\n\n      if (scheme === 'url') {\n        if (direction === 'encode') return encodeURIComponent(text)\n        return decodeURIComponent(text)\n      }\n\n      if (scheme === 'html_entities') {\n        if (direction === 'encode') {\n          return text\n            .replace(/&/g, '&amp;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;')\n            .replace(/\"/g, '&quot;')\n            .replace(/'/g, '&#39;')\n        }\n        return (\n          text\n            .replace(/&amp;/g, '&')\n            .replace(/&lt;/g, '<')\n            .replace(/&gt;/g, '>')\n            .replace(/&quot;/g, '\"')\n            .replace(/&#39;/g, \"'\")\n            // Use fromCodePoint, not fromCharCode: a numeric entity above U+FFFF (e.g. an emoji like\n            // &#127881; = 🎉) is an astral code point. fromCharCode truncates to 16 bits and yields a\n            // broken/empty character; fromCodePoint produces the correct surrogate pair. Out-of-range\n            // code points (> U+10FFFF) are left as-is rather than throwing.\n            .replace(/&#(\\d+);/g, (m, code: string) =>\n              codePointToString(Number.parseInt(code, 10), m)\n            )\n            .replace(/&#x([0-9a-fA-F]+);/g, (m, hex: string) =>\n              codePointToString(Number.parseInt(hex, 16), m)\n            )\n        )\n      }\n\n      return `Error: Unknown scheme \"${scheme}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Escape or unescape special characters for a target context.\n *\n * @remarks\n * Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns\n * an error string for unknown targets rather than throwing.\n */\nexport const textEscapeTool = new Tool({\n  name: 'text_escape',\n  description:\n    'Escape or unescape special characters for a target context: json_string, regex, csv_field, sql_like, markdown.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to escape or unescape'),\n    target: validator\n      .string()\n      .valid('json_string', 'regex', 'csv_field', 'sql_like', 'markdown')\n      .required()\n      .description('Target context for escaping'),\n    direction: validator\n      .string()\n      .valid('escape', 'unescape')\n      .default('escape')\n      .description('Whether to escape or unescape (default: escape)'),\n  }),\n  handler: async (args) => {\n    const { text, target, direction } = args as {\n      text: string\n      target: string\n      direction: string\n    }\n\n    try {\n      if (target === 'json_string') {\n        if (direction === 'escape') return JSON.stringify(text).slice(1, -1)\n        return JSON.parse(`\"${text}\"`) as string\n      }\n\n      if (target === 'regex') {\n        if (direction === 'escape') return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([.*+?^${}()|[\\]\\\\])/g, '$1')\n      }\n\n      if (target === 'csv_field') {\n        if (direction === 'escape') {\n          if (/[,\"\\n\\r]/.test(text)) return `\"${text.replace(/\"/g, '\"\"')}\"`\n          return text\n        }\n        if (text.startsWith('\"') && text.endsWith('\"')) {\n          return text.slice(1, -1).replace(/\"\"/g, '\"')\n        }\n        return text\n      }\n\n      if (target === 'sql_like') {\n        if (direction === 'escape') return text.replace(/[%_\\\\]/g, '\\\\$&')\n        return text.replace(/\\\\([%_\\\\])/g, '$1')\n      }\n\n      if (target === 'markdown') {\n        const mdChars = /[\\\\`*_{}[\\]()#+\\-.!|]/g\n        if (direction === 'escape') return text.replace(mdChars, '\\\\$&')\n        return text.replace(/\\\\([\\\\`*_{}[\\]()#+\\-.!|])/g, '$1')\n      }\n\n      return `Error: Unknown target \"${target}\".`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Normalize Unicode text or extract code points.\n *\n * @remarks\n * Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),\n * `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or\n * `code_points` (one `U+HHHH (char)` per line).\n */\nexport const unicodeNormalizeTool = new Tool({\n  name: 'unicode_normalize',\n  description:\n    'Normalize Unicode text (NFC, NFD, NFKC, NFKD), strip accents/diacritics, or get Unicode code points for each character.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text to process'),\n    operation: validator\n      .string()\n      .valid('nfc', 'nfd', 'nfkc', 'nfkd', 'strip_accents', 'code_points')\n      .required()\n      .description(\n        'Operation: NFC/NFD/NFKC/NFKD normalization, strip_accents (remove diacritics), or code_points (list hex values)'\n      ),\n  }),\n  handler: async (args) => {\n    const { text, operation } = args as { text: string; operation: string }\n\n    try {\n      if (operation === 'strip_accents') {\n        return text.normalize('NFD').replace(/[̀-ͯ]/g, '').normalize('NFC')\n      }\n\n      if (operation === 'code_points') {\n        return [...text]\n          .map((ch) => {\n            const cp = ch.codePointAt(0)!\n            const hex = cp.toString(16).toUpperCase().padStart(4, '0')\n            return `U+${hex} (${ch})`\n          })\n          .join('\\n')\n      }\n\n      const formMap: Record<string, string> = { nfc: 'NFC', nfd: 'NFD', nfkc: 'NFKC', nfkd: 'NFKD' }\n      const form = formMap[operation]\n      if (!form) return `Error: Unknown operation \"${operation}\".`\n      return text.normalize(form)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;AAcA,IAAM,gBAAgB,SAAyB;CAC7C,MAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,IAAI;CAC3C,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,OAAO,UAAU,OAAO,aAAa,IAAI;CAC5D,OAAO,WAAW,KAAK,MAAM;AAC/B;AAEA,IAAM,gBAAgB,QAAwB;CAC5C,MAAM,SAAS,WAAW,KAAK,GAAG;CAClC,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,MAAM,KAAK,OAAO,WAAW,CAAC;CACtE,OAAO,IAAI,YAAY,EAAE,OAAO,KAAK;AACvC;;;;;;AAOA,IAAM,qBAAqB,IAAY,aAA6B;CAClE,IAAI,CAAC,OAAO,UAAU,EAAE,KAAK,KAAK,KAAK,KAAK,SAAU,OAAO;CAC7D,OAAO,OAAO,cAAc,EAAE;AAChC;;;;;;;;;AAUA,IAAa,iBAAiB,IAAI,KAAK;CACrC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,MAAM,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,0BAA0B;EAC1E,QAAQ,UACL,OAAO,EACP,MAAM,UAAU,OAAO,eAAe,EACtC,SAAS,EACT,YAAY,iBAAiB;EAChC,WAAW,UACR,OAAO,EACP,MAAM,UAAU,QAAQ,EACxB,QAAQ,QAAQ,EAChB,YAAY,+CAA+C;CAChE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,MAAM,QAAQ,cAAc;EAMpC,IAAI;GACF,IAAI,WAAW,UAAU;IACvB,IAAI,cAAc,UAAU,OAAO,aAAa,IAAI;IACpD,OAAO,aAAa,IAAI;GAC1B;GAEA,IAAI,WAAW,OAAO;IACpB,IAAI,cAAc,UAAU,OAAO,mBAAmB,IAAI;IAC1D,OAAO,mBAAmB,IAAI;GAChC;GAEA,IAAI,WAAW,iBAAiB;IAC9B,IAAI,cAAc,UAChB,OAAO,KACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,OAAO;IAE1B,OACE,KACG,QAAQ,UAAU,GAAG,EACrB,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,GAAG,EACpB,QAAQ,WAAW,IAAG,EACtB,QAAQ,UAAU,GAAG,EAKrB,QAAQ,cAAc,GAAG,SACxB,kBAAkB,OAAO,SAAS,MAAM,EAAE,GAAG,CAAC,CAChD,EACC,QAAQ,wBAAwB,GAAG,QAClC,kBAAkB,OAAO,SAAS,KAAK,EAAE,GAAG,CAAC,CAC/C;GAEN;GAEA,OAAO,0BAA0B,OAAO;EAC1C,SAAS,KAAK;GACZ,OAAO,UAAU,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EAC1D;CACF;AACF,CAAC;;;;;;;;AASD,IAAa,iBAAiB,IAAI,KAAK;CACrC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,MAAM,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,4BAA4B;EAC5E,QAAQ,UACL,OAAO,EACP,MAAM,eAAe,SAAS,aAAa,YAAY,UAAU,EACjE,SAAS,EACT,YAAY,6BAA6B;EAC5C,WAAW,UACR,OAAO,EACP,MAAM,UAAU,UAAU,EAC1B,QAAQ,QAAQ,EAChB,YAAY,iDAAiD;CAClE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,MAAM,QAAQ,cAAc;EAMpC,IAAI;GACF,IAAI,WAAW,eAAe;IAC5B,IAAI,cAAc,UAAU,OAAO,KAAK,UAAU,IAAI,EAAE,MAAM,GAAG,EAAE;IACnE,OAAO,KAAK,MAAM,IAAI,KAAK,EAAE;GAC/B;GAEA,IAAI,WAAW,SAAS;IACtB,IAAI,cAAc,UAAU,OAAO,KAAK,QAAQ,uBAAuB,MAAM;IAC7E,OAAO,KAAK,QAAQ,2BAA2B,IAAI;GACrD;GAEA,IAAI,WAAW,aAAa;IAC1B,IAAI,cAAc,UAAU;KAC1B,IAAI,WAAW,KAAK,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,MAAM,MAAI,EAAE;KAC/D,OAAO;IACT;IACA,IAAI,KAAK,WAAW,IAAG,KAAK,KAAK,SAAS,IAAG,GAC3C,OAAO,KAAK,MAAM,GAAG,EAAE,EAAE,QAAQ,OAAO,IAAG;IAE7C,OAAO;GACT;GAEA,IAAI,WAAW,YAAY;IACzB,IAAI,cAAc,UAAU,OAAO,KAAK,QAAQ,WAAW,MAAM;IACjE,OAAO,KAAK,QAAQ,eAAe,IAAI;GACzC;GAEA,IAAI,WAAW,YAAY;IACzB,MAAM,UAAU;IAChB,IAAI,cAAc,UAAU,OAAO,KAAK,QAAQ,SAAS,MAAM;IAC/D,OAAO,KAAK,QAAQ,8BAA8B,IAAI;GACxD;GAEA,OAAO,0BAA0B,OAAO;EAC1C,SAAS,KAAK;GACZ,OAAO,UAAU,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EAC1D;CACF;AACF,CAAC;;;;;;;;;AAUD,IAAa,uBAAuB,IAAI,KAAK;CAC3C,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,MAAM,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,iBAAiB;EACjE,WAAW,UACR,OAAO,EACP,MAAM,OAAO,OAAO,QAAQ,QAAQ,iBAAiB,aAAa,EAClE,SAAS,EACT,YACC,iHACF;CACJ,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,MAAM,cAAc;EAE5B,IAAI;GACF,IAAI,cAAc,iBAChB,OAAO,KAAK,UAAU,KAAK,EAAE,QAAQ,UAAU,EAAE,EAAE,UAAU,KAAK;GAGpE,IAAI,cAAc,eAChB,OAAO,CAAC,GAAG,IAAI,EACZ,KAAK,OAAO;IAGX,OAAO,KAFI,GAAG,YAAY,CACd,EAAG,SAAS,EAAE,EAAE,YAAY,EAAE,SAAS,GAAG,GAC1C,EAAI,IAAI,GAAG;GACzB,CAAC,EACA,KAAK,IAAI;GAId,MAAM,OAAO;IAD6B,KAAK;IAAO,KAAK;IAAO,MAAM;IAAQ,MAAM;GACzE,EAAQ;GACrB,IAAI,CAAC,MAAM,OAAO,6BAA6B,UAAU;GACzD,OAAO,KAAK,UAAU,IAAI;EAC5B,SAAS,KAAK;GACZ,OAAO,UAAU,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EAC1D;CACF;AACF,CAAC"}

package/batteries/tools/formatting.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
-const require_tool = require("../../tool-CVyZkFC7.js");
-require("../../common-Cj8TaQ9U.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/formatting/index.ts
@@ -94,7 +94,7 @@ var formatListTool = new require_tool.Tool({
 	}),
 	handler: async (args) => {
 		const { items, style, indent: rawIndent } = args;
-		const indent = Math.max(0, Math.floor(rawIndent));
+		const indent = Math.min(100, Math.max(0, Math.floor(rawIndent)));
 		const pad = " ".repeat(indent);
 		if (items.length === 0) return "";
 		switch (style) {

package/batteries/tools/formatting.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"formatting.cjs","names":[],"sources":["../../../src/batteries/tools/formatting/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for locale-aware number, list, table, and text formatting.\n *\n * @module @nhtio/adk/batteries/tools/formatting\n *\n * @remarks\n * Pre-constructed bundled tools for the `formatting` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\n/**\n * Format a number using locale-aware styles.\n *\n * @remarks\n * Supported styles: `decimal`, `currency`, `percent`, `compact` (e.g. `1.2K`), `scientific`\n * (e.g. `1.2e+3`), and `ordinal` (`1st`, `2nd`, `3rd`). Uses `Intl.NumberFormat` and\n * `Intl.PluralRules` from the JS standard library. Returns an error string for non-finite values\n * or invalid currency-without-currency-code.\n */\nexport const formatNumberTool = new Tool({\n  name: 'format_number',\n  description:\n    'Format a number using locale-aware styles: decimal, currency, percent, compact (1.2K), scientific (1.2e3), or ordinal (1st/2nd/3rd). Supports locale and precision options.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('The number to format'),\n    style: validator\n      .string()\n      .valid('decimal', 'currency', 'percent', 'compact', 'scientific', 'ordinal')\n      .default('decimal')\n      .description('Formatting style (default: decimal)'),\n    currency: validator\n      .string()\n      .optional()\n      .description(\n        'ISO 4217 currency code — required when style is \"currency\" (e.g. \"USD\", \"EUR\")'\n      ),\n    locale: validator.string().default('en-US').description('BCP 47 locale tag (default: \"en-US\")'),\n    min_decimals: validator\n      .number()\n      .optional()\n      .description('Minimum fraction digits (default: style-dependent)'),\n    max_decimals: validator\n      .number()\n      .optional()\n      .description('Maximum fraction digits (default: style-dependent)'),\n  }),\n  handler: async (args) => {\n    const {\n      value,\n      style,\n      locale,\n      currency,\n      min_decimals: minDec,\n      max_decimals: maxDec,\n    } = args as {\n      value: number\n      style: string\n      locale: string\n      currency?: string\n      min_decimals?: number\n      max_decimals?: number\n    }\n\n    if (!Number.isFinite(value)) return `Error: Value must be a finite number (got ${value}).`\n\n    try {\n      if (style === 'ordinal') {\n        const pr = new Intl.PluralRules(locale, { type: 'ordinal' })\n        const suffixes: Record<string, string> = { one: 'st', two: 'nd', few: 'rd', other: 'th' }\n        const rule = pr.select(value)\n        const suffix = suffixes[rule] ?? 'th'\n        return `${new Intl.NumberFormat(locale).format(value)}${suffix}`\n      }\n\n      if (style === 'scientific') {\n        const exp = value === 0 ? 0 : Math.floor(Math.log10(Math.abs(value)))\n        const mantissa = value / Math.pow(10, exp)\n        const mFormatted = new Intl.NumberFormat(locale, {\n          minimumFractionDigits: minDec ?? 2,\n          maximumFractionDigits: maxDec ?? 6,\n        }).format(mantissa)\n        return `${mFormatted}e${exp >= 0 ? '+' : ''}${exp}`\n      }\n\n      const opts: Intl.NumberFormatOptions = {}\n\n      if (style === 'currency') {\n        if (!currency) return 'Error: \"currency\" parameter is required when style is \"currency\".'\n        opts.style = 'currency'\n        opts.currency = currency.toUpperCase()\n      } else if (style === 'percent') {\n        opts.style = 'percent'\n        opts.minimumFractionDigits = minDec ?? 1\n        opts.maximumFractionDigits = maxDec ?? 2\n      } else if (style === 'compact') {\n        opts.notation = 'compact'\n        opts.compactDisplay = 'short'\n      } else {\n        opts.style = 'decimal'\n      }\n\n      if (minDec !== undefined && style !== 'percent') opts.minimumFractionDigits = minDec\n      if (maxDec !== undefined && style !== 'percent') opts.maximumFractionDigits = maxDec\n\n      return new Intl.NumberFormat(locale, opts).format(value)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Format an array of items as a list.\n *\n * @remarks\n * Supported styles: `bullet` (`• item`), `numbered` (`1. item`), `inline_and`\n * (`a, b, and c`), `inline_or` (`a, b, or c`), `newline` (one per line).\n */\nexport const formatListTool = new Tool({\n  name: 'format_list',\n  description:\n    'Format an array of items as a list. Styles: bullet (• item), numbered (1. item), inline_and (\"a, b, and c\"), inline_or (\"a, b, or c\"), newline (one per line).',\n  inputSchema: validator.object({\n    items: validator\n      .array()\n      .items(validator.string())\n      .required()\n      .description('Array of items to format'),\n    style: validator\n      .string()\n      .valid('bullet', 'numbered', 'inline_and', 'inline_or', 'newline')\n      .default('bullet')\n      .description('List format style (default: bullet)'),\n    indent: validator.number().default(0).description('Spaces to indent each item (default: 0)'),\n  }),\n  handler: async (args) => {\n    const {\n      items,\n      style,\n      indent: rawIndent,\n    } = args as {\n      items: string[]\n      style: string\n      indent: number\n    }\n    const indent = Math.max(0, Math.floor(rawIndent))\n    const pad = ' '.repeat(indent)\n\n    if (items.length === 0) return ''\n\n    switch (style) {\n      case 'bullet':\n        return items.map((item) => `${pad}• ${item}`).join('\\n')\n      case 'numbered':\n        return items.map((item, i) => `${pad}${i + 1}. ${item}`).join('\\n')\n      case 'newline':\n        return items.map((item) => `${pad}${item}`).join('\\n')\n      case 'inline_and':\n      case 'inline_or': {\n        const conj = style === 'inline_and' ? 'and' : 'or'\n        if (items.length === 1) return items[0]\n        if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`\n        const last = items[items.length - 1]\n        const rest = items.slice(0, -1)\n        return `${rest.join(', ')}, ${conj} ${last}`\n      }\n      default:\n        return `Error: Unknown style \"${style}\".`\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"formatting.cjs","names":[],"sources":["../../../src/batteries/tools/formatting/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for locale-aware number, list, table, and text formatting.\n *\n * @module @nhtio/adk/batteries/tools/formatting\n *\n * @remarks\n * Pre-constructed bundled tools for the `formatting` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\n/**\n * Format a number using locale-aware styles.\n *\n * @remarks\n * Supported styles: `decimal`, `currency`, `percent`, `compact` (e.g. `1.2K`), `scientific`\n * (e.g. `1.2e+3`), and `ordinal` (`1st`, `2nd`, `3rd`). Uses `Intl.NumberFormat` and\n * `Intl.PluralRules` from the JS standard library. Returns an error string for non-finite values\n * or invalid currency-without-currency-code.\n */\nexport const formatNumberTool = new Tool({\n  name: 'format_number',\n  description:\n    'Format a number using locale-aware styles: decimal, currency, percent, compact (1.2K), scientific (1.2e3), or ordinal (1st/2nd/3rd). Supports locale and precision options.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('The number to format'),\n    style: validator\n      .string()\n      .valid('decimal', 'currency', 'percent', 'compact', 'scientific', 'ordinal')\n      .default('decimal')\n      .description('Formatting style (default: decimal)'),\n    currency: validator\n      .string()\n      .optional()\n      .description(\n        'ISO 4217 currency code — required when style is \"currency\" (e.g. \"USD\", \"EUR\")'\n      ),\n    locale: validator.string().default('en-US').description('BCP 47 locale tag (default: \"en-US\")'),\n    min_decimals: validator\n      .number()\n      .optional()\n      .description('Minimum fraction digits (default: style-dependent)'),\n    max_decimals: validator\n      .number()\n      .optional()\n      .description('Maximum fraction digits (default: style-dependent)'),\n  }),\n  handler: async (args) => {\n    const {\n      value,\n      style,\n      locale,\n      currency,\n      min_decimals: minDec,\n      max_decimals: maxDec,\n    } = args as {\n      value: number\n      style: string\n      locale: string\n      currency?: string\n      min_decimals?: number\n      max_decimals?: number\n    }\n\n    if (!Number.isFinite(value)) return `Error: Value must be a finite number (got ${value}).`\n\n    try {\n      if (style === 'ordinal') {\n        const pr = new Intl.PluralRules(locale, { type: 'ordinal' })\n        const suffixes: Record<string, string> = { one: 'st', two: 'nd', few: 'rd', other: 'th' }\n        const rule = pr.select(value)\n        const suffix = suffixes[rule] ?? 'th'\n        return `${new Intl.NumberFormat(locale).format(value)}${suffix}`\n      }\n\n      if (style === 'scientific') {\n        const exp = value === 0 ? 0 : Math.floor(Math.log10(Math.abs(value)))\n        const mantissa = value / Math.pow(10, exp)\n        const mFormatted = new Intl.NumberFormat(locale, {\n          minimumFractionDigits: minDec ?? 2,\n          maximumFractionDigits: maxDec ?? 6,\n        }).format(mantissa)\n        return `${mFormatted}e${exp >= 0 ? '+' : ''}${exp}`\n      }\n\n      const opts: Intl.NumberFormatOptions = {}\n\n      if (style === 'currency') {\n        if (!currency) return 'Error: \"currency\" parameter is required when style is \"currency\".'\n        opts.style = 'currency'\n        opts.currency = currency.toUpperCase()\n      } else if (style === 'percent') {\n        opts.style = 'percent'\n        opts.minimumFractionDigits = minDec ?? 1\n        opts.maximumFractionDigits = maxDec ?? 2\n      } else if (style === 'compact') {\n        opts.notation = 'compact'\n        opts.compactDisplay = 'short'\n      } else {\n        opts.style = 'decimal'\n      }\n\n      if (minDec !== undefined && style !== 'percent') opts.minimumFractionDigits = minDec\n      if (maxDec !== undefined && style !== 'percent') opts.maximumFractionDigits = maxDec\n\n      return new Intl.NumberFormat(locale, opts).format(value)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Format an array of items as a list.\n *\n * @remarks\n * Supported styles: `bullet` (`• item`), `numbered` (`1. item`), `inline_and`\n * (`a, b, and c`), `inline_or` (`a, b, or c`), `newline` (one per line).\n */\nexport const formatListTool = new Tool({\n  name: 'format_list',\n  description:\n    'Format an array of items as a list. Styles: bullet (• item), numbered (1. item), inline_and (\"a, b, and c\"), inline_or (\"a, b, or c\"), newline (one per line).',\n  inputSchema: validator.object({\n    items: validator\n      .array()\n      .items(validator.string())\n      .required()\n      .description('Array of items to format'),\n    style: validator\n      .string()\n      .valid('bullet', 'numbered', 'inline_and', 'inline_or', 'newline')\n      .default('bullet')\n      .description('List format style (default: bullet)'),\n    indent: validator.number().default(0).description('Spaces to indent each item (default: 0)'),\n  }),\n  handler: async (args) => {\n    const {\n      items,\n      style,\n      indent: rawIndent,\n    } = args as {\n      items: string[]\n      style: string\n      indent: number\n    }\n    // Clamp indent to a sane maximum: an unbounded value reaches `' '.repeat(indent)` and throws\n    // RangeError (Invalid string length). 100 spaces is far past any real formatting need.\n    const indent = Math.min(100, Math.max(0, Math.floor(rawIndent)))\n    const pad = ' '.repeat(indent)\n\n    if (items.length === 0) return ''\n\n    switch (style) {\n      case 'bullet':\n        return items.map((item) => `${pad}• ${item}`).join('\\n')\n      case 'numbered':\n        return items.map((item, i) => `${pad}${i + 1}. ${item}`).join('\\n')\n      case 'newline':\n        return items.map((item) => `${pad}${item}`).join('\\n')\n      case 'inline_and':\n      case 'inline_or': {\n        const conj = style === 'inline_and' ? 'and' : 'or'\n        if (items.length === 1) return items[0]\n        if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`\n        const last = items[items.length - 1]\n        const rest = items.slice(0, -1)\n        return `${rest.join(', ')}, ${conj} ${last}`\n      }\n      default:\n        return `Error: Unknown style \"${style}\".`\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,mBAAmB,IAAI,aAAA,KAAK;CACvC,MAAM;CACN,aACE;CACF,aAAa,kBAAA,UAAU,OAAO;EAC5B,OAAO,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,sBAAsB;EACvE,OAAO,kBAAA,UACJ,OAAO,EACP,MAAM,WAAW,YAAY,WAAW,WAAW,cAAc,SAAS,EAC1E,QAAQ,SAAS,EACjB,YAAY,qCAAqC;EACpD,UAAU,kBAAA,UACP,OAAO,EACP,SAAS,EACT,YACC,sFACF;EACF,QAAQ,kBAAA,UAAU,OAAO,EAAE,QAAQ,OAAO,EAAE,YAAY,wCAAsC;EAC9F,cAAc,kBAAA,UACX,OAAO,EACP,SAAS,EACT,YAAY,oDAAoD;EACnE,cAAc,kBAAA,UACX,OAAO,EACP,SAAS,EACT,YAAY,oDAAoD;CACrE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,OACA,OACA,QACA,UACA,cAAc,QACd,cAAc,WACZ;EASJ,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,OAAO,6CAA6C,MAAM;EAEvF,IAAI;GACF,IAAI,UAAU,WAAW;IAIvB,MAAM,SAAS;KAF4B,KAAK;KAAM,KAAK;KAAM,KAAK;KAAM,OAAO;IAEpE,EADF,IAFE,KAAK,YAAY,QAAQ,EAAE,MAAM,UAAU,CAE7C,EAAG,OAAO,KACC,MAAS;IACjC,OAAO,GAAG,IAAI,KAAK,aAAa,MAAM,EAAE,OAAO,KAAK,IAAI;GAC1D;GAEA,IAAI,UAAU,cAAc;IAC1B,MAAM,MAAM,UAAU,IAAI,IAAI,KAAK,MAAM,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,CAAC;IACpE,MAAM,WAAW,QAAQ,KAAK,IAAI,IAAI,GAAG;IAKzC,OAAO,GAJY,IAAI,KAAK,aAAa,QAAQ;KAC/C,uBAAuB,UAAU;KACjC,uBAAuB,UAAU;IACnC,CAAC,EAAE,OAAO,QACA,EAAW,GAAG,OAAO,IAAI,MAAM,KAAK;GAChD;GAEA,MAAM,OAAiC,CAAC;GAExC,IAAI,UAAU,YAAY;IACxB,IAAI,CAAC,UAAU,OAAO;IACtB,KAAK,QAAQ;IACb,KAAK,WAAW,SAAS,YAAY;GACvC,OAAO,IAAI,UAAU,WAAW;IAC9B,KAAK,QAAQ;IACb,KAAK,wBAAwB,UAAU;IACvC,KAAK,wBAAwB,UAAU;GACzC,OAAO,IAAI,UAAU,WAAW;IAC9B,KAAK,WAAW;IAChB,KAAK,iBAAiB;GACxB,OACE,KAAK,QAAQ;GAGf,IAAI,WAAW,KAAA,KAAa,UAAU,WAAW,KAAK,wBAAwB;GAC9E,IAAI,WAAW,KAAA,KAAa,UAAU,WAAW,KAAK,wBAAwB;GAE9E,OAAO,IAAI,KAAK,aAAa,QAAQ,IAAI,EAAE,OAAO,KAAK;EACzD,SAAS,KAAK;GACZ,OAAO,UAAU,sBAAA,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EAC1D;CACF;AACF,CAAC;;;;;;;;AASD,IAAa,iBAAiB,IAAI,aAAA,KAAK;CACrC,MAAM;CACN,aACE;CACF,aAAa,kBAAA,UAAU,OAAO;EAC5B,OAAO,kBAAA,UACJ,MAAM,EACN,MAAM,kBAAA,UAAU,OAAO,CAAC,EACxB,SAAS,EACT,YAAY,0BAA0B;EACzC,OAAO,kBAAA,UACJ,OAAO,EACP,MAAM,UAAU,YAAY,cAAc,aAAa,SAAS,EAChE,QAAQ,QAAQ,EAChB,YAAY,qCAAqC;EACpD,QAAQ,kBAAA,UAAU,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,yCAAyC;CAC7F,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,OACA,OACA,QAAQ,cACN;EAOJ,MAAM,SAAS,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,CAAC,CAAC;EAC/D,MAAM,MAAM,IAAI,OAAO,MAAM;EAE7B,IAAI,MAAM,WAAW,GAAG,OAAO;EAE/B,QAAQ,OAAR;GACE,KAAK,UACH,OAAO,MAAM,KAAK,SAAS,GAAG,IAAI,IAAI,MAAM,EAAE,KAAK,IAAI;GACzD,KAAK,YACH,OAAO,MAAM,KAAK,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,IAAI,MAAM,EAAE,KAAK,IAAI;GACpE,KAAK,WACH,OAAO,MAAM,KAAK,SAAS,GAAG,MAAM,MAAM,EAAE,KAAK,IAAI;GACvD,KAAK;GACL,KAAK,aAAa;IAChB,MAAM,OAAO,UAAU,eAAe,QAAQ;IAC9C,IAAI,MAAM,WAAW,GAAG,OAAO,MAAM;IACrC,IAAI,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM;IAC5D,MAAM,OAAO,MAAM,MAAM,SAAS;IAElC,OAAO,GADM,MAAM,MAAM,GAAG,EAClB,EAAK,KAAK,IAAI,EAAE,IAAI,KAAK,GAAG;GACxC;GACA,SACE,OAAO,yBAAyB,MAAM;EAC1C;CACF;AACF,CAAC"}

package/batteries/tools/formatting.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-D1pSSlsd.mjs";
-import { t as Tool } from "../../tool-CMhaDRNd.mjs";
-import "../../common-BT0nfCi9.mjs";
+import { o as isError } from "../../tool_registry-791Vrjtf.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/formatting/index.ts
@@ -92,7 +92,7 @@ var formatListTool = new Tool({
 	}),
 	handler: async (args) => {
 		const { items, style, indent: rawIndent } = args;
-		const indent = Math.max(0, Math.floor(rawIndent));
+		const indent = Math.min(100, Math.max(0, Math.floor(rawIndent)));
 		const pad = " ".repeat(indent);
 		if (items.length === 0) return "";
 		switch (style) {

package/batteries/tools/formatting.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"formatting.mjs","names":[],"sources":["../../../src/batteries/tools/formatting/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for locale-aware number, list, table, and text formatting.\n *\n * @module @nhtio/adk/batteries/tools/formatting\n *\n * @remarks\n * Pre-constructed bundled tools for the `formatting` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\n/**\n * Format a number using locale-aware styles.\n *\n * @remarks\n * Supported styles: `decimal`, `currency`, `percent`, `compact` (e.g. `1.2K`), `scientific`\n * (e.g. `1.2e+3`), and `ordinal` (`1st`, `2nd`, `3rd`). Uses `Intl.NumberFormat` and\n * `Intl.PluralRules` from the JS standard library. Returns an error string for non-finite values\n * or invalid currency-without-currency-code.\n */\nexport const formatNumberTool = new Tool({\n  name: 'format_number',\n  description:\n    'Format a number using locale-aware styles: decimal, currency, percent, compact (1.2K), scientific (1.2e3), or ordinal (1st/2nd/3rd). Supports locale and precision options.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('The number to format'),\n    style: validator\n      .string()\n      .valid('decimal', 'currency', 'percent', 'compact', 'scientific', 'ordinal')\n      .default('decimal')\n      .description('Formatting style (default: decimal)'),\n    currency: validator\n      .string()\n      .optional()\n      .description(\n        'ISO 4217 currency code — required when style is \"currency\" (e.g. \"USD\", \"EUR\")'\n      ),\n    locale: validator.string().default('en-US').description('BCP 47 locale tag (default: \"en-US\")'),\n    min_decimals: validator\n      .number()\n      .optional()\n      .description('Minimum fraction digits (default: style-dependent)'),\n    max_decimals: validator\n      .number()\n      .optional()\n      .description('Maximum fraction digits (default: style-dependent)'),\n  }),\n  handler: async (args) => {\n    const {\n      value,\n      style,\n      locale,\n      currency,\n      min_decimals: minDec,\n      max_decimals: maxDec,\n    } = args as {\n      value: number\n      style: string\n      locale: string\n      currency?: string\n      min_decimals?: number\n      max_decimals?: number\n    }\n\n    if (!Number.isFinite(value)) return `Error: Value must be a finite number (got ${value}).`\n\n    try {\n      if (style === 'ordinal') {\n        const pr = new Intl.PluralRules(locale, { type: 'ordinal' })\n        const suffixes: Record<string, string> = { one: 'st', two: 'nd', few: 'rd', other: 'th' }\n        const rule = pr.select(value)\n        const suffix = suffixes[rule] ?? 'th'\n        return `${new Intl.NumberFormat(locale).format(value)}${suffix}`\n      }\n\n      if (style === 'scientific') {\n        const exp = value === 0 ? 0 : Math.floor(Math.log10(Math.abs(value)))\n        const mantissa = value / Math.pow(10, exp)\n        const mFormatted = new Intl.NumberFormat(locale, {\n          minimumFractionDigits: minDec ?? 2,\n          maximumFractionDigits: maxDec ?? 6,\n        }).format(mantissa)\n        return `${mFormatted}e${exp >= 0 ? '+' : ''}${exp}`\n      }\n\n      const opts: Intl.NumberFormatOptions = {}\n\n      if (style === 'currency') {\n        if (!currency) return 'Error: \"currency\" parameter is required when style is \"currency\".'\n        opts.style = 'currency'\n        opts.currency = currency.toUpperCase()\n      } else if (style === 'percent') {\n        opts.style = 'percent'\n        opts.minimumFractionDigits = minDec ?? 1\n        opts.maximumFractionDigits = maxDec ?? 2\n      } else if (style === 'compact') {\n        opts.notation = 'compact'\n        opts.compactDisplay = 'short'\n      } else {\n        opts.style = 'decimal'\n      }\n\n      if (minDec !== undefined && style !== 'percent') opts.minimumFractionDigits = minDec\n      if (maxDec !== undefined && style !== 'percent') opts.maximumFractionDigits = maxDec\n\n      return new Intl.NumberFormat(locale, opts).format(value)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Format an array of items as a list.\n *\n * @remarks\n * Supported styles: `bullet` (`• item`), `numbered` (`1. item`), `inline_and`\n * (`a, b, and c`), `inline_or` (`a, b, or c`), `newline` (one per line).\n */\nexport const formatListTool = new Tool({\n  name: 'format_list',\n  description:\n    'Format an array of items as a list. Styles: bullet (• item), numbered (1. item), inline_and (\"a, b, and c\"), inline_or (\"a, b, or c\"), newline (one per line).',\n  inputSchema: validator.object({\n    items: validator\n      .array()\n      .items(validator.string())\n      .required()\n      .description('Array of items to format'),\n    style: validator\n      .string()\n      .valid('bullet', 'numbered', 'inline_and', 'inline_or', 'newline')\n      .default('bullet')\n      .description('List format style (default: bullet)'),\n    indent: validator.number().default(0).description('Spaces to indent each item (default: 0)'),\n  }),\n  handler: async (args) => {\n    const {\n      items,\n      style,\n      indent: rawIndent,\n    } = args as {\n      items: string[]\n      style: string\n      indent: number\n    }\n    const indent = Math.max(0, Math.floor(rawIndent))\n    const pad = ' '.repeat(indent)\n\n    if (items.length === 0) return ''\n\n    switch (style) {\n      case 'bullet':\n        return items.map((item) => `${pad}• ${item}`).join('\\n')\n      case 'numbered':\n        return items.map((item, i) => `${pad}${i + 1}. ${item}`).join('\\n')\n      case 'newline':\n        return items.map((item) => `${pad}${item}`).join('\\n')\n      case 'inline_and':\n      case 'inline_or': {\n        const conj = style === 'inline_and' ? 'and' : 'or'\n        if (items.length === 1) return items[0]\n        if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`\n        const last = items[items.length - 1]\n        const rest = items.slice(0, -1)\n        return `${rest.join(', ')}, ${conj} ${last}`\n      }\n      default:\n        return `Error: Unknown style \"${style}\".`\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"formatting.mjs","names":[],"sources":["../../../src/batteries/tools/formatting/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for locale-aware number, list, table, and text formatting.\n *\n * @module @nhtio/adk/batteries/tools/formatting\n *\n * @remarks\n * Pre-constructed bundled tools for the `formatting` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\n/**\n * Format a number using locale-aware styles.\n *\n * @remarks\n * Supported styles: `decimal`, `currency`, `percent`, `compact` (e.g. `1.2K`), `scientific`\n * (e.g. `1.2e+3`), and `ordinal` (`1st`, `2nd`, `3rd`). Uses `Intl.NumberFormat` and\n * `Intl.PluralRules` from the JS standard library. Returns an error string for non-finite values\n * or invalid currency-without-currency-code.\n */\nexport const formatNumberTool = new Tool({\n  name: 'format_number',\n  description:\n    'Format a number using locale-aware styles: decimal, currency, percent, compact (1.2K), scientific (1.2e3), or ordinal (1st/2nd/3rd). Supports locale and precision options.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('The number to format'),\n    style: validator\n      .string()\n      .valid('decimal', 'currency', 'percent', 'compact', 'scientific', 'ordinal')\n      .default('decimal')\n      .description('Formatting style (default: decimal)'),\n    currency: validator\n      .string()\n      .optional()\n      .description(\n        'ISO 4217 currency code — required when style is \"currency\" (e.g. \"USD\", \"EUR\")'\n      ),\n    locale: validator.string().default('en-US').description('BCP 47 locale tag (default: \"en-US\")'),\n    min_decimals: validator\n      .number()\n      .optional()\n      .description('Minimum fraction digits (default: style-dependent)'),\n    max_decimals: validator\n      .number()\n      .optional()\n      .description('Maximum fraction digits (default: style-dependent)'),\n  }),\n  handler: async (args) => {\n    const {\n      value,\n      style,\n      locale,\n      currency,\n      min_decimals: minDec,\n      max_decimals: maxDec,\n    } = args as {\n      value: number\n      style: string\n      locale: string\n      currency?: string\n      min_decimals?: number\n      max_decimals?: number\n    }\n\n    if (!Number.isFinite(value)) return `Error: Value must be a finite number (got ${value}).`\n\n    try {\n      if (style === 'ordinal') {\n        const pr = new Intl.PluralRules(locale, { type: 'ordinal' })\n        const suffixes: Record<string, string> = { one: 'st', two: 'nd', few: 'rd', other: 'th' }\n        const rule = pr.select(value)\n        const suffix = suffixes[rule] ?? 'th'\n        return `${new Intl.NumberFormat(locale).format(value)}${suffix}`\n      }\n\n      if (style === 'scientific') {\n        const exp = value === 0 ? 0 : Math.floor(Math.log10(Math.abs(value)))\n        const mantissa = value / Math.pow(10, exp)\n        const mFormatted = new Intl.NumberFormat(locale, {\n          minimumFractionDigits: minDec ?? 2,\n          maximumFractionDigits: maxDec ?? 6,\n        }).format(mantissa)\n        return `${mFormatted}e${exp >= 0 ? '+' : ''}${exp}`\n      }\n\n      const opts: Intl.NumberFormatOptions = {}\n\n      if (style === 'currency') {\n        if (!currency) return 'Error: \"currency\" parameter is required when style is \"currency\".'\n        opts.style = 'currency'\n        opts.currency = currency.toUpperCase()\n      } else if (style === 'percent') {\n        opts.style = 'percent'\n        opts.minimumFractionDigits = minDec ?? 1\n        opts.maximumFractionDigits = maxDec ?? 2\n      } else if (style === 'compact') {\n        opts.notation = 'compact'\n        opts.compactDisplay = 'short'\n      } else {\n        opts.style = 'decimal'\n      }\n\n      if (minDec !== undefined && style !== 'percent') opts.minimumFractionDigits = minDec\n      if (maxDec !== undefined && style !== 'percent') opts.maximumFractionDigits = maxDec\n\n      return new Intl.NumberFormat(locale, opts).format(value)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Format an array of items as a list.\n *\n * @remarks\n * Supported styles: `bullet` (`• item`), `numbered` (`1. item`), `inline_and`\n * (`a, b, and c`), `inline_or` (`a, b, or c`), `newline` (one per line).\n */\nexport const formatListTool = new Tool({\n  name: 'format_list',\n  description:\n    'Format an array of items as a list. Styles: bullet (• item), numbered (1. item), inline_and (\"a, b, and c\"), inline_or (\"a, b, or c\"), newline (one per line).',\n  inputSchema: validator.object({\n    items: validator\n      .array()\n      .items(validator.string())\n      .required()\n      .description('Array of items to format'),\n    style: validator\n      .string()\n      .valid('bullet', 'numbered', 'inline_and', 'inline_or', 'newline')\n      .default('bullet')\n      .description('List format style (default: bullet)'),\n    indent: validator.number().default(0).description('Spaces to indent each item (default: 0)'),\n  }),\n  handler: async (args) => {\n    const {\n      items,\n      style,\n      indent: rawIndent,\n    } = args as {\n      items: string[]\n      style: string\n      indent: number\n    }\n    // Clamp indent to a sane maximum: an unbounded value reaches `' '.repeat(indent)` and throws\n    // RangeError (Invalid string length). 100 spaces is far past any real formatting need.\n    const indent = Math.min(100, Math.max(0, Math.floor(rawIndent)))\n    const pad = ' '.repeat(indent)\n\n    if (items.length === 0) return ''\n\n    switch (style) {\n      case 'bullet':\n        return items.map((item) => `${pad}• ${item}`).join('\\n')\n      case 'numbered':\n        return items.map((item, i) => `${pad}${i + 1}. ${item}`).join('\\n')\n      case 'newline':\n        return items.map((item) => `${pad}${item}`).join('\\n')\n      case 'inline_and':\n      case 'inline_or': {\n        const conj = style === 'inline_and' ? 'and' : 'or'\n        if (items.length === 1) return items[0]\n        if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`\n        const last = items[items.length - 1]\n        const rest = items.slice(0, -1)\n        return `${rest.join(', ')}, ${conj} ${last}`\n      }\n      default:\n        return `Error: Unknown style \"${style}\".`\n    }\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/geo_basics.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-CVyZkFC7.js");
-require("../../common-Cj8TaQ9U.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/geo_basics/index.ts
 /**

package/batteries/tools/geo_basics.mjs

@@ -1,5 +1,5 @@
-import { t as Tool } from "../../tool-CMhaDRNd.mjs";
-import "../../common-BT0nfCi9.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/geo_basics/index.ts
 /**

package/batteries/tools/index.d.ts

@@ -22,6 +22,7 @@ export * from "./math/index";
 export * from "./memory/index";
 export * from "./parsing/index";
 export * from "./retrievables/index";
+export * from "./searxng/index";
 export * from "./standing_instructions/index";
 export * from "./statistics/index";
 export * from "./string_processing/index";

package/batteries/tools/math.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
-const require_tool = require("../../tool-CVyZkFC7.js");
-require("../../common-Cj8TaQ9U.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool = require("../../tool-D5WGVIcI.js");
+require("../../common-DZl3ADJs.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let mathjs = require("mathjs");
@@ -83,12 +83,12 @@ function evaluateLatex(latex) {
 	expr = expr.replace(/\\arccos/g, "acos");
 	expr = expr.replace(/\\arctan/g, "atan");
 	expr = expr.replace(/\\(sin|cos|tan|cot|sec|csc|sinh|cosh|tanh|ln|log|exp|abs|det)/g, "$1");
-	expr = expr.replace(/log_\{?(\w+)\}?\(/g, (_, base) => {
+	expr = expr.replace(/log_\{?(\w+)\}?\(((?:[^()]|\([^()]*\))*)\)/g, (_, base, arg) => {
 		const baseLower = base.toLowerCase();
-		if (baseLower === "10") return "log10(";
-		if (baseLower === "2") return "log2(";
-		if (baseLower === "e") return "ln(";
-		return `ln(/ln(${base})`;
+		if (baseLower === "10") return `log10(${arg})`;
+		if (baseLower === "2") return `log2(${arg})`;
+		if (baseLower === "e") return `ln(${arg})`;
+		return `(ln(${arg})/ln(${base}))`;
 	});
 	expr = expr.replace(/_\{[^}]*\}/g, "");
 	expr = expr.replace(/_\w/g, "");
@@ -108,6 +108,7 @@ function evaluateLatex(latex) {
 	expr = expr.replace(/\\quad/g, " ");
 	expr = expr.replace(/\\qquad/g, " ");
 	expr = expr.replace(/\\text\{([^{}]*)\}/g, "");
+	expr = expr.replace(/(\d(?:\.\d+)?)[eE]([+-]?\d+)/g, "($1*10^($2))");
 	expr = expr.replace(/(\d)([a-zA-Z(])/g, "$1*$2");
 	expr = expr.replace(/\)\s*\(/g, ")*(");
 	expr = expr.replace(/\s+/g, " ").trim();
@@ -402,6 +403,7 @@ var calculateTool = new require_tool.Tool({
 		if (lengthError) return lengthError;
 		try {
 			const result = math.evaluate(expression);
+			if (typeof result === "number" && !Number.isFinite(result)) return `Error: result is not finite (${result}) — the value overflows JavaScript's numeric range.`;
 			return `Result: ${result}\nKaTeX: $${math.parse(expression).toTex()} = ${result}$`;
 		} catch (err) {
 			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;

package/batteries/tools/math.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"math.cjs","names":[],"sources":["../../../src/batteries/tools/math/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for safe arithmetic, expression evaluation, and numeric operations.\n *\n * @module @nhtio/adk/batteries/tools/math\n *\n * @remarks\n * Pre-constructed bundled tools for the `math` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { create, all } from 'mathjs'\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\nimport { default as evaluatex } from 'evaluatex'\nimport { isError, isInstanceOf } from '@nhtio/adk/guards'\n\nconst math = create(all)\n\nconst BLOCKED_FUNCTIONS = [\n  'import',\n  'createUnit',\n  'simplify',\n  'derivative',\n  'compile',\n  'chain',\n  'reviver',\n  'replacer',\n]\n\nfor (const fn of BLOCKED_FUNCTIONS) {\n  if (fn in math) {\n    ;(math as any)[fn] = undefined\n  }\n}\n\nconst MAX_EXPRESSION_LENGTH = 1000\n\nfunction validateExpression(expr: string): string | undefined {\n  if (expr.length > MAX_EXPRESSION_LENGTH) {\n    return `Expression too long (max ${MAX_EXPRESSION_LENGTH} characters).`\n  }\n  return undefined\n}\n\n/**\n * EvaluateX scope providing constants and function aliases that evaluatex does not ship\n * out-of-the-box, matching the capabilities that were previously provided by the mathjs\n * translation layer.\n */\nconst EVALUATEX_SCOPE: Record<string, unknown> = {\n  // Mathematical constants\n  pi: Math.PI,\n  e: Math.E,\n  infinity: Infinity,\n  // Greek letters as named constants (matching LaTeX macro names)\n  alpha: undefined,\n  beta: undefined,\n  gamma: undefined,\n  delta: undefined,\n  epsilon: undefined,\n  theta: undefined,\n  lambda: undefined,\n  mu: undefined,\n  sigma: undefined,\n  tau: undefined,\n  phi: undefined,\n  omega: undefined,\n  // Function aliases — evaluatex uses log for natural log; provide ln as alias,\n  // plus common log bases and nthRoot for \\sqrt[n]{...}.\n  ln: Math.log,\n  log10: (x: number) => Math.log(x) / Math.LN10,\n  log2: (x: number) => Math.log(x) / Math.LN2,\n  nthRoot: (x: number, n: number) => Math.pow(x, 1 / n),\n  // Determinant (identity for scalars — det([a,b;c,d]) is not supported in the scalar path)\n  det: (x: number) => x,\n}\n\n/**\n * Translate a LaTeX/KaTeX expression to evaluatex-compatible syntax and evaluate it.\n *\n * The translation is a lightweight pass over the LaTeX source that handles common constructs\n * (frac, sqrt, trig, Greek macros, delimiters, etc.) and feeds the result to evaluatex with\n * a pre-built scope providing constants and function aliases. This replaces the previous\n * hand-rolled regex → mathjs pipeline.\n */\nfunction evaluateLatex(latex: string): number {\n  let expr = latex.trim()\n\n  // Strip display/inline math delimiters: $$...$$ or $...$\n  expr = expr.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  // Strip \\[ ... \\] or \\( ... \\) delimiters\n  expr = expr.replace(/^\\\\[[(]|\\\\[\\])]$/g, '')\n\n  // ---- LaTeX command translation ----\n\n  // \\frac{a}{b} → (a)/(b) — iterates to handle nested fractions\n  for (let i = 0; i < 20; i++) {\n    const before = expr\n    expr = expr.replace(/\\\\frac\\s*\\{([^}]*)\\}\\s*\\{([^}]*)\\}/g, '($1)/($2)')\n    if (expr === before) break\n  }\n\n  // \\sqrt[n]{x} → nthRoot(x, n)\n  expr = expr.replace(/\\\\sqrt\\[([^\\]]+)\\]\\s*\\{([^}]*)\\}/g, 'nthRoot($2, $1)')\n  // \\sqrt{x} → sqrt(x)\n  expr = expr.replace(/\\\\sqrt\\s*\\{([^}]*)\\}/g, 'sqrt($1)')\n\n  // Inverse trig: \\arcsin → asin (evaluatex uses asin/acos/atan natively)\n  expr = expr.replace(/\\\\arcsin/g, 'asin')\n  expr = expr.replace(/\\\\arccos/g, 'acos')\n  expr = expr.replace(/\\\\arctan/g, 'atan')\n\n  // Strip backslash from known function macros: \\sin, \\cos, \\tan, \\cot, \\sec, \\csc,\n  // \\sinh, \\cosh, \\tanh, \\ln, \\log, \\exp, \\abs, etc.\n  expr = expr.replace(/\\\\(sin|cos|tan|cot|sec|csc|sinh|cosh|tanh|ln|log|exp|abs|det)/g, '$1')\n\n  // Subscript-based log: \\log_2(x) → log2(x), or just strip subscript for single-arg\n  expr = expr.replace(/log_\\{?(\\w+)\\}?\\(/g, (_, base) => {\n    const baseLower = base.toLowerCase()\n    if (baseLower === '10') return 'log10('\n    if (baseLower === '2') return 'log2('\n    if (baseLower === 'e') return 'ln('\n    // Generic base: convert log_b(x) to ln(x)/ln(b) — evaluatex handles the\n    // resulting expression fine.\n    return `ln(/ln(${base})`\n  })\n  // Strip any remaining subscripts (e.g. x_1, a_n)\n  expr = expr.replace(/_\\{[^}]*\\}/g, '')\n  expr = expr.replace(/_\\w/g, '')\n\n  // Powers: ^{...} → ^(...)\n  expr = expr.replace(/\\^{([^{}]*)}/g, '^($1)')\n\n  // Greek letter macros\n  expr = expr.replace(/\\\\pi/g, 'pi')\n  expr = expr.replace(\n    /\\\\(alpha|beta|gamma|delta|epsilon|theta|lambda|mu|sigma|tau|phi|omega)/g,\n    '$1'\n  )\n\n  // Spacing and operators\n  expr = expr.replace(/\\\\cdot/g, '*')\n  expr = expr.replace(/\\\\times/g, '*')\n  expr = expr.replace(/\\\\div/g, '/')\n  expr = expr.replace(/\\\\infty/g, 'infinity')\n  expr = expr.replace(/\\\\left\\s*([([{|])/g, '$1')\n  expr = expr.replace(/\\\\right\\s*([)\\]}|])/g, '$1')\n  expr = expr.replace(/\\\\sum/g, 'sum')\n  expr = expr.replace(/\\\\prod/g, 'prod')\n  expr = expr.replace(/\\\\,/g, ' ')\n  expr = expr.replace(/\\\\;/g, ' ')\n  expr = expr.replace(/\\\\quad/g, ' ')\n  expr = expr.replace(/\\\\qquad/g, ' ')\n  // Strip \\text{...} blocks entirely\n  expr = expr.replace(/\\\\text\\{([^{}]*)\\}/g, '')\n\n  // Implicit multiplication: 2x, 3(x+1), etc.\n  expr = expr.replace(/(\\d)([a-zA-Z(])/g, '$1*$2')\n  expr = expr.replace(/\\)\\s*\\(/g, ')*(')\n\n  // Collapse whitespace\n  expr = expr.replace(/\\s+/g, ' ').trim()\n\n  const fn = evaluatex(expr, EVALUATEX_SCOPE)\n  const result = fn()\n  if (typeof result !== 'number' || !Number.isFinite(result)) {\n    throw new Error('Result is not finite')\n  }\n  return result\n}\n\n/**\n * Lightweight LaTeX-to-string translator for internal use by the numeric calculus path.\n *\n * This is the same translation pass as {@link evaluateLatex}, but returns the translated string\n * (compatible with mathjs syntax) rather than evaluating it. Used by the calculus handlers to\n * convert integrands, function bodies, and bound expressions before passing them to\n * `math.evaluate` for specific-point evaluation.\n */\nfunction translateLatex(latex: string): string {\n  let expr = latex.trim()\n  expr = expr.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  expr = expr.replace(/^\\\\[[(]|\\\\[\\])]$/g, '')\n\n  for (let i = 0; i < 20; i++) {\n    const before = expr\n    expr = expr.replace(/\\\\frac\\s*\\{([^}]*)\\}\\s*\\{([^}]*)\\}/g, '($1)/($2)')\n    if (expr === before) break\n  }\n\n  expr = expr.replace(/\\\\sqrt\\[([^\\]]+)\\]\\s*\\{([^}]*)\\}/g, 'nthRoot($2, $1)')\n  expr = expr.replace(/\\\\sqrt\\s*\\{([^}]*)\\}/g, 'sqrt($1)')\n\n  expr = expr.replace(/\\\\arcsin/g, 'asin')\n  expr = expr.replace(/\\\\arccos/g, 'acos')\n  expr = expr.replace(/\\\\arctan/g, 'atan')\n\n  expr = expr.replace(/\\\\(sin|cos|tan|cot|sec|csc|sinh|cosh|tanh|ln|log|exp|abs|det)/g, '$1')\n\n  expr = expr.replace(/log_\\{?(\\w+)\\}?\\s*\\(([^)]+)\\)/g, 'log($2, $1)')\n  expr = expr.replace(/\\^{([^{}]*)}/g, '^($1)')\n  expr = expr.replace(/_\\{[^{}]*\\}/g, '')\n  expr = expr.replace(/_\\w/g, '')\n\n  expr = expr.replace(/\\\\pi/g, 'pi')\n  expr = expr.replace(\n    /\\\\(alpha|beta|gamma|delta|epsilon|theta|lambda|mu|sigma|tau|phi|omega)/g,\n    '$1'\n  )\n\n  expr = expr.replace(/\\\\cdot/g, '*')\n  expr = expr.replace(/\\\\times/g, '*')\n  expr = expr.replace(/\\\\div/g, '/')\n  expr = expr.replace(/\\\\infty/g, 'Infinity')\n  expr = expr.replace(/\\\\left\\s*([([{|])/g, '$1')\n  expr = expr.replace(/\\\\right\\s*([)\\]}|])/g, '$1')\n  expr = expr.replace(/\\\\sum/g, 'sum')\n  expr = expr.replace(/\\\\prod/g, 'prod')\n  expr = expr.replace(/\\\\,/g, ' ')\n  expr = expr.replace(/\\\\;/g, ' ')\n  expr = expr.replace(/\\\\quad/g, ' ')\n  expr = expr.replace(/\\\\qquad/g, ' ')\n  expr = expr.replace(/\\\\text\\{([^{}]*)\\}/g, '')\n  expr = expr.replace(/(\\d)([a-zA-Z(])/g, '$1*$2')\n  expr = expr.replace(/\\)\\s*\\(/g, ')*(')\n  expr = expr.replace(/\\s+/g, ' ').trim()\n\n  return expr\n}\n\n// ─── Numeric calculus ─────────────────────────────────────────────────────────\n//\n// `evaluate_katex` is a numeric evaluator. mathjs has no symbolic integration, and its symbolic\n// `derivative` is intentionally blocklisted above, so calculus is computed NUMERICALLY: definite\n// integrals via composite Simpson quadrature, derivatives via central finite differences, and limits\n// via a two-sided approach. These are approximations (correct to ~1e-9 for the smooth expressions a\n// model emits), surfaced under a `Result (numeric):` label so the distinction is explicit.\n//\n// Detection runs on the RAW LaTeX, before `translateLatex` flattens it — its subscript stripping\n// would otherwise destroy integral bounds (`\\int_{0}^{1}` → `\\int^(1)`) and limit targets. The\n// extracted sub-expressions (integrand, bounds, body, point) are then translated by the existing\n// `translateLatex` and evaluated per-point with a scope, which works under the security blocklist.\n\n/** A tagged error whose message is surfaced to the model verbatim (caught by {@link tryCalculus}). */\nclass CalculusError extends Error {}\n\n/** Evaluate a mathjs expression at a single point, guarding against non-finite results. */\nfunction evalAt(expr: string, varName: string, x: number): number {\n  const y = math.evaluate!(expr, { [varName]: x })\n  if (typeof y !== 'number' || !Number.isFinite(y)) {\n    throw new CalculusError('NON_FINITE')\n  }\n  return y\n}\n\n/** Composite Simpson's rule over a finite interval. Throws {@link CalculusError} on a singularity. */\nfunction simpson(fn: (x: number) => number, a: number, b: number, n = 1000): number {\n  if (n % 2 === 1) n++\n  const h = (b - a) / n\n  let sum = fn(a) + fn(b)\n  for (let i = 1; i < n; i++) {\n    sum += (i % 2 === 1 ? 4 : 2) * fn(a + i * h)\n  }\n  const result = (h / 3) * sum\n  if (!Number.isFinite(result)) throw new CalculusError('NON_FINITE')\n  return result\n}\n\n/** Round numeric output to 12 significant digits, collapsing floating-point noise. */\nfunction formatNumeric(n: number): string {\n  // Snap values that are zero-to-within-tolerance to exactly 0 (e.g. lim_{x->inf} 1/x ≈ 1e-8).\n  if (Math.abs(n) < 1e-9) return '0'\n  return math.format!(n, { precision: 12 })\n}\n\n/**\n * Reads a single `_`/`^` script starting at `i`, supporting braced (`_{0}`, `^{\\pi}`), command\n * (`^\\pi`), and bare-token (`_0`, `^1`) forms. Returns the mark, its raw-LaTeX value, and the next\n * index, or `null` when there is no script at `i`.\n */\nfunction readScript(s: string, i: number): { mark: '_' | '^'; val: string; next: number } | null {\n  while (s[i] === ' ') i++\n  const mark = s[i]\n  if (mark !== '_' && mark !== '^') return null\n  i++\n  while (s[i] === ' ') i++\n  if (s[i] === '{') {\n    let depth = 0\n    const start = ++i\n    for (; i < s.length; i++) {\n      if (s[i] === '{') depth++\n      else if (s[i] === '}') {\n        if (depth === 0) break\n        depth--\n      }\n    }\n    return { mark, val: s.slice(start, i), next: i + 1 }\n  }\n  if (s[i] === '\\\\') {\n    const m = /^\\\\[a-zA-Z]+/.exec(s.slice(i))\n    if (!m) return null\n    return { mark, val: m[0], next: i + m[0].length }\n  }\n  const m = /^[A-Za-z0-9.]+/.exec(s.slice(i))\n  if (!m) return null\n  return { mark, val: m[0], next: i + m[0].length }\n}\n\n/** Translate a raw-LaTeX bound/target fragment and evaluate it to a finite number. */\nfunction evalBound(latex: string): number {\n  const trimmed = latex.trim()\n  if (/\\\\infty/.test(trimmed)) throw new CalculusError('INFINITE_BOUND')\n  const mathjsExpr = translateLatex(trimmed)\n  const value = math.evaluate!(mathjsExpr)\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new CalculusError('BAD_BOUND')\n  }\n  return value\n}\n\n/** Evaluate a definite integral `\\int_{a}^{b} f \\,dx` by Simpson quadrature. */\nfunction evalIntegral(s: string): string {\n  // Strip the operator (\\int, optionally with \\limits).\n  const m = /\\\\int(?:\\\\limits)?/.exec(s)\n  if (!m) throw new CalculusError('NOT_INTEGRAL')\n  let i = m.index + m[0].length\n\n  // Read up to two scripts (bounds), in either order.\n  const scripts: Record<'_' | '^', string | undefined> = { '_': undefined, '^': undefined }\n  for (let k = 0; k < 2; k++) {\n    const sc = readScript(s, i)\n    if (!sc) break\n    scripts[sc.mark] = sc.val\n    i = sc.next\n  }\n  if (scripts._ === undefined || scripts['^'] === undefined) {\n    throw new CalculusError('INDEFINITE')\n  }\n\n  // The remainder is `integrand … d<var>`. Pull the trailing differential off the end.\n  const rest = s.slice(i)\n  const diff = /\\\\?,?\\s*\\bd\\s*([a-zA-Z])\\s*$/.exec(rest)\n  if (!diff) throw new CalculusError('NO_DIFFERENTIAL')\n  const variable = diff[1]\n  const integrandLatex = rest.slice(0, diff.index)\n  if (integrandLatex.trim().length === 0) throw new CalculusError('NO_INTEGRAND')\n\n  const a = evalBound(scripts._)\n  const b = evalBound(scripts['^'])\n  const integrand = translateLatex(integrandLatex)\n  const fn = (x: number) => evalAt(integrand, variable, x)\n\n  let result: number\n  if (a === b) result = 0\n  else if (a < b) result = simpson(fn, a, b)\n  else result = -simpson(fn, b, a)\n\n  return `Converted: ∫(${integrand}) d${variable} from ${formatNumeric(a)} to ${formatNumeric(b)}\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Evaluate a derivative `\\frac{d}{dx} f \\big|_{x=a}` at a point via central finite difference. */\nfunction evalDerivative(s: string): string {\n  // Operator + variable: \\frac{d}{dx} … or bare d/dx ….\n  let variable: string | undefined\n  let body = s\n  const fracOp = /\\\\frac\\s*\\{\\s*d\\s*\\}\\s*\\{\\s*d\\s*([a-zA-Z])\\s*\\}/.exec(s)\n  if (fracOp) {\n    variable = fracOp[1]\n    body = s.slice(fracOp.index + fracOp[0].length)\n  } else {\n    const bareOp = /(?:^|[^a-zA-Z])d\\s*\\/\\s*d([a-zA-Z])/.exec(s)\n    if (bareOp) {\n      variable = bareOp[1]\n      body = s.slice(bareOp.index + bareOp[0].length)\n    }\n  }\n  if (!variable) throw new CalculusError('NOT_DERIVATIVE')\n\n  // Remove pure \\left. / \\right. delimiters.\n  body = body.replace(/\\\\left\\.?/g, '').replace(/\\\\right\\.?/g, '')\n\n  // Evaluation bar + point at the end: …|_{x=3} (optionally \\Big| etc.).\n  const bar = /\\\\?(?:Big|big|bigg|Bigg)?\\s*\\|\\s*_\\s*\\{?\\s*([a-zA-Z])\\s*=\\s*([^}]+?)\\s*\\}?\\s*$/.exec(\n    body\n  )\n  if (!bar) throw new CalculusError('NO_POINT')\n  const point = evalBound(bar[2])\n  let fnLatex = body.slice(0, bar.index).trim()\n\n  // Strip one layer of wrapping parentheses/brackets around the function body.\n  fnLatex = fnLatex\n    .replace(/^\\\\?\\(([\\s\\S]*)\\\\?\\)$/, '$1')\n    .replace(/^\\[([\\s\\S]*)\\]$/, '$1')\n    .trim()\n  if (fnLatex.length === 0) throw new CalculusError('NO_FUNCTION')\n\n  const expr = translateLatex(fnLatex)\n  const h = 1e-6\n  const fn = (x: number) => evalAt(expr, variable, x)\n  const result = (fn(point + h) - fn(point - h)) / (2 * h)\n  if (!Number.isFinite(result)) throw new CalculusError('NON_FINITE')\n\n  return `Converted: d/d${variable}(${expr}) at ${variable}=${formatNumeric(point)}\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Evaluate a limit `\\lim_{x \\to a} f(x)` by a two-sided numeric approach. */\nfunction evalLimit(s: string): string {\n  const head = /\\\\lim\\s*_\\s*\\{\\s*([a-zA-Z])\\s*\\\\to\\s*([\\s\\S]+?)\\s*\\}/.exec(s)\n  if (!head) throw new CalculusError('NOT_LIMIT')\n  const variable = head[1]\n  let targetLatex = head[2].trim()\n  const bodyLatex = s.slice(head.index + head[0].length).trim()\n  if (bodyLatex.length === 0) throw new CalculusError('NO_FUNCTION')\n\n  // One-sided markers (0^+, 0^-, 0^{+}) — record the side, strip the marker.\n  let side: 'both' | 'plus' | 'minus' = 'both'\n  const oneSided = /\\^\\s*\\{?\\s*([+-])\\s*\\}?\\s*$/.exec(targetLatex)\n  if (oneSided) {\n    side = oneSided[1] === '+' ? 'plus' : 'minus'\n    targetLatex = targetLatex.slice(0, oneSided.index).trim()\n  }\n\n  const expr = translateLatex(bodyLatex)\n  const fn = (x: number) => evalAt(expr, variable, x)\n  const eps = 1e-6\n\n  // Infinite targets via large-magnitude substitution.\n  let result: number\n  let targetLabel: string\n  if (/^-\\s*\\\\infty$/.test(targetLatex)) {\n    result = fn(-1e8)\n    targetLabel = '-∞'\n  } else if (/^\\\\infty$/.test(targetLatex)) {\n    result = fn(1e8)\n    targetLabel = '∞'\n  } else {\n    const target = evalBound(targetLatex)\n    targetLabel = formatNumeric(target)\n    if (side === 'plus') {\n      result = fn(target + eps)\n    } else if (side === 'minus') {\n      result = fn(target - eps)\n    } else {\n      const lo = fn(target - eps)\n      const hi = fn(target + eps)\n      const avg = (lo + hi) / 2\n      if (Math.abs(hi - lo) > 1e-3 * Math.max(1, Math.abs(avg))) {\n        throw new CalculusError('LIMIT_MISMATCH')\n      }\n      result = avg\n    }\n  }\n  if (!Number.isFinite(result)) throw new CalculusError('LIMIT_UNBOUNDED')\n\n  // Infinite-target substitution (±1e8) and the eps offset leave more residue than Simpson or the\n  // derivative difference, so snap a limit result to a nearby round value before formatting:\n  // 0.99999998 → 1, 1e-8 → 0. The tolerance is loose enough to absorb the substitution error yet\n  // far tighter than the divergence check that already rejected genuinely non-convergent limits.\n  const nearest = Math.round(result)\n  if (Math.abs(result - nearest) < 1e-6) result = nearest\n\n  return `Converted: lim ${variable}→${targetLabel} of (${expr})\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Human-readable, model-actionable message for each {@link CalculusError} tag. */\nfunction calculusErrorMessage(tag: string): string {\n  switch (tag) {\n    case 'INDEFINITE':\n      return 'Cannot evaluate an indefinite integral numerically. Provide bounds, e.g. \\\\int_{0}^{1} x dx.'\n    case 'NO_DIFFERENTIAL':\n      return \"Could not find the integration variable. Expected a trailing differential like 'dx'.\"\n    case 'NO_INTEGRAND':\n      return 'The integral has no integrand to evaluate.'\n    case 'INFINITE_BOUND':\n      return 'Infinite integration bounds are not supported. Provide finite numeric bounds, e.g. \\\\int_{0}^{1} f dx.'\n    case 'BAD_BOUND':\n      return 'Could not evaluate the integration bounds to numbers.'\n    case 'NO_POINT':\n      return 'Cannot evaluate a derivative numerically without a point. Specify where, e.g. \\\\frac{d}{dx}(x^2)\\\\Big|_{x=3}.'\n    case 'NO_FUNCTION':\n      return 'Could not find the function to evaluate.'\n    case 'LIMIT_MISMATCH':\n      return 'The limit may not exist (left and right values disagree).'\n    case 'LIMIT_UNBOUNDED':\n      return 'The limit appears to diverge (function is unbounded near the target).'\n    case 'NON_FINITE':\n      return 'The expression is not finite over the requested range (possible singularity); cannot evaluate numerically.'\n    default:\n      return 'Could not evaluate the calculus expression.'\n  }\n}\n\n/**\n * Detects a calculus construct in raw LaTeX and routes it to the matching numeric handler. Returns\n * the result/error string, or `null` when the input is not a calculus expression (so the caller\n * falls through to the scalar evaluation path unchanged).\n */\nfunction tryCalculus(latex: string): string | null {\n  let s = latex.trim()\n  s = s.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  s = s.replace(/^\\\\[[(]|\\\\[\\])]$/g, '').trim()\n\n  let handler: ((expr: string) => string) | undefined\n  if (/\\\\int/.test(s)) handler = evalIntegral\n  else if (/\\\\lim/.test(s)) handler = evalLimit\n  else if (\n    /\\\\frac\\s*\\{\\s*d\\s*\\}\\s*\\{\\s*d\\s*[a-zA-Z]\\s*\\}/.test(s) ||\n    /(?:^|[^a-zA-Z])d\\s*\\/\\s*d[a-zA-Z]/.test(s)\n  )\n    handler = evalDerivative\n  if (!handler) return null\n\n  try {\n    return handler(s)\n  } catch (err) {\n    if (isInstanceOf(err, 'CalculusError', CalculusError)) {\n      return `Error: ${calculusErrorMessage(err.message)}`\n    }\n    return `Error: ${isError(err) ? err.message : String(err)}`\n  }\n}\n\n/**\n * Evaluates a mathjs-syntax expression and returns the numeric result alongside the KaTeX\n * representation of the parsed expression.\n *\n * @remarks\n * Supports arithmetic, trigonometric, logarithmic, exponential, factorial, matrix, and unit\n * operations via `mathjs`. The mathjs instance is hardened: dangerous functions (`import`,\n * `createUnit`, `simplify`, `derivative`, `compile`, `chain`, `reviver`, `replacer`) are\n * disabled to prevent interpreter-surface exposure.\n *\n * Expressions over 1000 characters are rejected with an error string (not thrown). Parse and\n * evaluation errors are also returned as error strings — the tool surfaces math errors as\n * content rather than exceptions, so the model can react to them in-line.\n */\nexport const calculateTool = new Tool({\n  name: 'calculate',\n  description:\n    'Evaluate a math expression. Supports arithmetic, trig, log, sqrt, factorial, matrices.',\n  inputSchema: validator.object({\n    expression: validator.string().required().description('Math expression, e.g. \"sin(pi/4) + 5!\"'),\n  }),\n  handler: async (args) => {\n    const { expression } = args as { expression: string }\n\n    const lengthError = validateExpression(expression)\n    if (lengthError) return lengthError\n\n    try {\n      const result = math.evaluate!(expression)\n      const node = math.parse!(expression)\n      const katex = node.toTex()\n      return `Result: ${result}\\nKaTeX: $${katex} = ${result}$`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Translates a LaTeX/KaTeX expression using evaluatex and returns the numeric result.\n *\n * @remarks\n * Uses the evaluatex library to parse and evaluate LaTeX expressions. Handles common constructs\n * (`\\frac{a}{b}`, `\\sqrt{...}`, `\\cdot`, `\\times`, Greek macros like `\\pi`, inverse trig,\n * `\\left`/`\\right` delimiters, `\\text{...}`, subscripts, etc.) with a proper parser rather than\n * brittle regex.\n *\n * Also evaluates three calculus constructs **numerically** (mathjs has no symbolic integration, and\n * its symbolic `derivative` is blocklisted here for safety):\n * - Definite integrals — `\\int_{a}^{b} f \\,dx` via composite Simpson quadrature.\n * - Derivatives at a point — `\\frac{d}{dx} f \\big|_{x=a}` via central finite difference.\n * - Limits — `\\lim_{x \\to a} f` (including `a = \\pm\\infty`) via a two-sided numeric approach.\n *\n * Numeric results are rounded with `math.format(..., { precision: 12 })` and labelled\n * `Result (numeric):` to flag that they are approximations. Constructs that cannot be evaluated\n * numerically (indefinite integrals, derivatives without a point, infinite integration bounds,\n * singular integrands, divergent limits) return a specific, guiding error string.\n *\n * Parse and evaluation errors are returned as error strings rather than thrown.\n */\nexport const evaluateKatexTool = new Tool({\n  name: 'evaluate_katex',\n  description:\n    'Evaluate a KaTeX/LaTeX math expression and return the numeric result. Supports arithmetic, trig, logs, roots, and numeric calculus: definite integrals (\\\\int_{a}^{b} f dx), derivatives at a point (\\\\frac{d}{dx} f|_{x=a}), and limits (\\\\lim_{x \\\\to a} f).',\n  inputSchema: validator.object({\n    katex: validator\n      .string()\n      .required()\n      .description('LaTeX expression, e.g. \"\\\\frac{1}{2} + \\\\sqrt{9}\" or \"\\\\int_{0}^{1} x^2 dx\"'),\n  }),\n  handler: async (args) => {\n    const { katex } = args as { katex: string }\n\n    const lengthError = validateExpression(katex)\n    if (lengthError) return lengthError\n\n    try {\n      // Calculus (\\int, \\lim, d/dx) is detected on the raw LaTeX and evaluated numerically before\n      // the scalar flattening path, which would otherwise mangle bounds/targets. Returns null for\n      // non-calculus input, falling through to the scalar evaluator below unchanged.\n      const calculus = tryCalculus(katex)\n      if (calculus !== null) return calculus\n\n      const result = evaluateLatex(katex)\n      return `Result: ${result}`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"math.cjs","names":[],"sources":["../../../src/batteries/tools/math/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for safe arithmetic, expression evaluation, and numeric operations.\n *\n * @module @nhtio/adk/batteries/tools/math\n *\n * @remarks\n * Pre-constructed bundled tools for the `math` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { create, all } from 'mathjs'\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\nimport { default as evaluatex } from 'evaluatex'\nimport { isError, isInstanceOf } from '@nhtio/adk/guards'\n\nconst math = create(all)\n\nconst BLOCKED_FUNCTIONS = [\n  'import',\n  'createUnit',\n  'simplify',\n  'derivative',\n  'compile',\n  'chain',\n  'reviver',\n  'replacer',\n]\n\nfor (const fn of BLOCKED_FUNCTIONS) {\n  if (fn in math) {\n    ;(math as any)[fn] = undefined\n  }\n}\n\nconst MAX_EXPRESSION_LENGTH = 1000\n\nfunction validateExpression(expr: string): string | undefined {\n  if (expr.length > MAX_EXPRESSION_LENGTH) {\n    return `Expression too long (max ${MAX_EXPRESSION_LENGTH} characters).`\n  }\n  return undefined\n}\n\n/**\n * EvaluateX scope providing constants and function aliases that evaluatex does not ship\n * out-of-the-box, matching the capabilities that were previously provided by the mathjs\n * translation layer.\n */\nconst EVALUATEX_SCOPE: Record<string, unknown> = {\n  // Mathematical constants\n  pi: Math.PI,\n  e: Math.E,\n  infinity: Infinity,\n  // Greek letters as named constants (matching LaTeX macro names)\n  alpha: undefined,\n  beta: undefined,\n  gamma: undefined,\n  delta: undefined,\n  epsilon: undefined,\n  theta: undefined,\n  lambda: undefined,\n  mu: undefined,\n  sigma: undefined,\n  tau: undefined,\n  phi: undefined,\n  omega: undefined,\n  // Function aliases — evaluatex uses log for natural log; provide ln as alias,\n  // plus common log bases and nthRoot for \\sqrt[n]{...}.\n  ln: Math.log,\n  log10: (x: number) => Math.log(x) / Math.LN10,\n  log2: (x: number) => Math.log(x) / Math.LN2,\n  nthRoot: (x: number, n: number) => Math.pow(x, 1 / n),\n  // Determinant (identity for scalars — det([a,b;c,d]) is not supported in the scalar path)\n  det: (x: number) => x,\n}\n\n/**\n * Translate a LaTeX/KaTeX expression to evaluatex-compatible syntax and evaluate it.\n *\n * The translation is a lightweight pass over the LaTeX source that handles common constructs\n * (frac, sqrt, trig, Greek macros, delimiters, etc.) and feeds the result to evaluatex with\n * a pre-built scope providing constants and function aliases. This replaces the previous\n * hand-rolled regex → mathjs pipeline.\n */\nfunction evaluateLatex(latex: string): number {\n  let expr = latex.trim()\n\n  // Strip display/inline math delimiters: $$...$$ or $...$\n  expr = expr.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  // Strip \\[ ... \\] or \\( ... \\) delimiters\n  expr = expr.replace(/^\\\\[[(]|\\\\[\\])]$/g, '')\n\n  // ---- LaTeX command translation ----\n\n  // \\frac{a}{b} → (a)/(b) — iterates to handle nested fractions\n  for (let i = 0; i < 20; i++) {\n    const before = expr\n    expr = expr.replace(/\\\\frac\\s*\\{([^}]*)\\}\\s*\\{([^}]*)\\}/g, '($1)/($2)')\n    if (expr === before) break\n  }\n\n  // \\sqrt[n]{x} → nthRoot(x, n)\n  expr = expr.replace(/\\\\sqrt\\[([^\\]]+)\\]\\s*\\{([^}]*)\\}/g, 'nthRoot($2, $1)')\n  // \\sqrt{x} → sqrt(x)\n  expr = expr.replace(/\\\\sqrt\\s*\\{([^}]*)\\}/g, 'sqrt($1)')\n\n  // Inverse trig: \\arcsin → asin (evaluatex uses asin/acos/atan natively)\n  expr = expr.replace(/\\\\arcsin/g, 'asin')\n  expr = expr.replace(/\\\\arccos/g, 'acos')\n  expr = expr.replace(/\\\\arctan/g, 'atan')\n\n  // Strip backslash from known function macros: \\sin, \\cos, \\tan, \\cot, \\sec, \\csc,\n  // \\sinh, \\cosh, \\tanh, \\ln, \\log, \\exp, \\abs, etc.\n  expr = expr.replace(/\\\\(sin|cos|tan|cot|sec|csc|sinh|cosh|tanh|ln|log|exp|abs|det)/g, '$1')\n\n  // Subscript-based log: \\log_2(x) → log2(x), \\log_10(x) → log10(x), \\log_e(x) → ln(x), and a\n  // generic base \\log_b(arg) → (ln(arg)/ln(b)) via change of base. The argument is captured here\n  // (single level of nested parens) so the change-of-base form is well-formed — previously the\n  // argument was not captured and the output was the malformed `ln(/ln(b)`.\n  expr = expr.replace(\n    /log_\\{?(\\w+)\\}?\\(((?:[^()]|\\([^()]*\\))*)\\)/g,\n    (_, base: string, arg: string) => {\n      const baseLower = base.toLowerCase()\n      if (baseLower === '10') return `log10(${arg})`\n      if (baseLower === '2') return `log2(${arg})`\n      if (baseLower === 'e') return `ln(${arg})`\n      return `(ln(${arg})/ln(${base}))`\n    }\n  )\n  // Strip any remaining subscripts (e.g. x_1, a_n)\n  expr = expr.replace(/_\\{[^}]*\\}/g, '')\n  expr = expr.replace(/_\\w/g, '')\n\n  // Powers: ^{...} → ^(...)\n  expr = expr.replace(/\\^{([^{}]*)}/g, '^($1)')\n\n  // Greek letter macros\n  expr = expr.replace(/\\\\pi/g, 'pi')\n  expr = expr.replace(\n    /\\\\(alpha|beta|gamma|delta|epsilon|theta|lambda|mu|sigma|tau|phi|omega)/g,\n    '$1'\n  )\n\n  // Spacing and operators\n  expr = expr.replace(/\\\\cdot/g, '*')\n  expr = expr.replace(/\\\\times/g, '*')\n  expr = expr.replace(/\\\\div/g, '/')\n  expr = expr.replace(/\\\\infty/g, 'infinity')\n  expr = expr.replace(/\\\\left\\s*([([{|])/g, '$1')\n  expr = expr.replace(/\\\\right\\s*([)\\]}|])/g, '$1')\n  expr = expr.replace(/\\\\sum/g, 'sum')\n  expr = expr.replace(/\\\\prod/g, 'prod')\n  expr = expr.replace(/\\\\,/g, ' ')\n  expr = expr.replace(/\\\\;/g, ' ')\n  expr = expr.replace(/\\\\quad/g, ' ')\n  expr = expr.replace(/\\\\qquad/g, ' ')\n  // Strip \\text{...} blocks entirely\n  expr = expr.replace(/\\\\text\\{([^{}]*)\\}/g, '')\n\n  // Scientific notation: evaluatex doesn't understand `2e3` natively (it reads `e3` as a symbol),\n  // so rewrite a numeric literal's exponent into an explicit power: `2e3` → `(2*10^(3))`,\n  // `1.5e-8` → `(1.5*10^(-8))`. Done BEFORE implicit-multiplication insertion.\n  expr = expr.replace(/(\\d(?:\\.\\d+)?)[eE]([+-]?\\d+)/g, '($1*10^($2))')\n\n  // Implicit multiplication: 2x, 3(x+1), etc.\n  expr = expr.replace(/(\\d)([a-zA-Z(])/g, '$1*$2')\n  expr = expr.replace(/\\)\\s*\\(/g, ')*(')\n\n  // Collapse whitespace\n  expr = expr.replace(/\\s+/g, ' ').trim()\n\n  const fn = evaluatex(expr, EVALUATEX_SCOPE)\n  const result = fn()\n  if (typeof result !== 'number' || !Number.isFinite(result)) {\n    throw new Error('Result is not finite')\n  }\n  return result\n}\n\n/**\n * Lightweight LaTeX-to-string translator for internal use by the numeric calculus path.\n *\n * This is the same translation pass as {@link evaluateLatex}, but returns the translated string\n * (compatible with mathjs syntax) rather than evaluating it. Used by the calculus handlers to\n * convert integrands, function bodies, and bound expressions before passing them to\n * `math.evaluate` for specific-point evaluation.\n */\nfunction translateLatex(latex: string): string {\n  let expr = latex.trim()\n  expr = expr.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  expr = expr.replace(/^\\\\[[(]|\\\\[\\])]$/g, '')\n\n  for (let i = 0; i < 20; i++) {\n    const before = expr\n    expr = expr.replace(/\\\\frac\\s*\\{([^}]*)\\}\\s*\\{([^}]*)\\}/g, '($1)/($2)')\n    if (expr === before) break\n  }\n\n  expr = expr.replace(/\\\\sqrt\\[([^\\]]+)\\]\\s*\\{([^}]*)\\}/g, 'nthRoot($2, $1)')\n  expr = expr.replace(/\\\\sqrt\\s*\\{([^}]*)\\}/g, 'sqrt($1)')\n\n  expr = expr.replace(/\\\\arcsin/g, 'asin')\n  expr = expr.replace(/\\\\arccos/g, 'acos')\n  expr = expr.replace(/\\\\arctan/g, 'atan')\n\n  expr = expr.replace(/\\\\(sin|cos|tan|cot|sec|csc|sinh|cosh|tanh|ln|log|exp|abs|det)/g, '$1')\n\n  expr = expr.replace(/log_\\{?(\\w+)\\}?\\s*\\(([^)]+)\\)/g, 'log($2, $1)')\n  expr = expr.replace(/\\^{([^{}]*)}/g, '^($1)')\n  expr = expr.replace(/_\\{[^{}]*\\}/g, '')\n  expr = expr.replace(/_\\w/g, '')\n\n  expr = expr.replace(/\\\\pi/g, 'pi')\n  expr = expr.replace(\n    /\\\\(alpha|beta|gamma|delta|epsilon|theta|lambda|mu|sigma|tau|phi|omega)/g,\n    '$1'\n  )\n\n  expr = expr.replace(/\\\\cdot/g, '*')\n  expr = expr.replace(/\\\\times/g, '*')\n  expr = expr.replace(/\\\\div/g, '/')\n  expr = expr.replace(/\\\\infty/g, 'Infinity')\n  expr = expr.replace(/\\\\left\\s*([([{|])/g, '$1')\n  expr = expr.replace(/\\\\right\\s*([)\\]}|])/g, '$1')\n  expr = expr.replace(/\\\\sum/g, 'sum')\n  expr = expr.replace(/\\\\prod/g, 'prod')\n  expr = expr.replace(/\\\\,/g, ' ')\n  expr = expr.replace(/\\\\;/g, ' ')\n  expr = expr.replace(/\\\\quad/g, ' ')\n  expr = expr.replace(/\\\\qquad/g, ' ')\n  expr = expr.replace(/\\\\text\\{([^{}]*)\\}/g, '')\n  expr = expr.replace(/(\\d)([a-zA-Z(])/g, '$1*$2')\n  expr = expr.replace(/\\)\\s*\\(/g, ')*(')\n  expr = expr.replace(/\\s+/g, ' ').trim()\n\n  return expr\n}\n\n// ─── Numeric calculus ─────────────────────────────────────────────────────────\n//\n// `evaluate_katex` is a numeric evaluator. mathjs has no symbolic integration, and its symbolic\n// `derivative` is intentionally blocklisted above, so calculus is computed NUMERICALLY: definite\n// integrals via composite Simpson quadrature, derivatives via central finite differences, and limits\n// via a two-sided approach. These are approximations (correct to ~1e-9 for the smooth expressions a\n// model emits), surfaced under a `Result (numeric):` label so the distinction is explicit.\n//\n// Detection runs on the RAW LaTeX, before `translateLatex` flattens it — its subscript stripping\n// would otherwise destroy integral bounds (`\\int_{0}^{1}` → `\\int^(1)`) and limit targets. The\n// extracted sub-expressions (integrand, bounds, body, point) are then translated by the existing\n// `translateLatex` and evaluated per-point with a scope, which works under the security blocklist.\n\n/** A tagged error whose message is surfaced to the model verbatim (caught by {@link tryCalculus}). */\nclass CalculusError extends Error {}\n\n/** Evaluate a mathjs expression at a single point, guarding against non-finite results. */\nfunction evalAt(expr: string, varName: string, x: number): number {\n  const y = math.evaluate!(expr, { [varName]: x })\n  if (typeof y !== 'number' || !Number.isFinite(y)) {\n    throw new CalculusError('NON_FINITE')\n  }\n  return y\n}\n\n/** Composite Simpson's rule over a finite interval. Throws {@link CalculusError} on a singularity. */\nfunction simpson(fn: (x: number) => number, a: number, b: number, n = 1000): number {\n  if (n % 2 === 1) n++\n  const h = (b - a) / n\n  let sum = fn(a) + fn(b)\n  for (let i = 1; i < n; i++) {\n    sum += (i % 2 === 1 ? 4 : 2) * fn(a + i * h)\n  }\n  const result = (h / 3) * sum\n  if (!Number.isFinite(result)) throw new CalculusError('NON_FINITE')\n  return result\n}\n\n/** Round numeric output to 12 significant digits, collapsing floating-point noise. */\nfunction formatNumeric(n: number): string {\n  // Snap values that are zero-to-within-tolerance to exactly 0 (e.g. lim_{x->inf} 1/x ≈ 1e-8).\n  if (Math.abs(n) < 1e-9) return '0'\n  return math.format!(n, { precision: 12 })\n}\n\n/**\n * Reads a single `_`/`^` script starting at `i`, supporting braced (`_{0}`, `^{\\pi}`), command\n * (`^\\pi`), and bare-token (`_0`, `^1`) forms. Returns the mark, its raw-LaTeX value, and the next\n * index, or `null` when there is no script at `i`.\n */\nfunction readScript(s: string, i: number): { mark: '_' | '^'; val: string; next: number } | null {\n  while (s[i] === ' ') i++\n  const mark = s[i]\n  if (mark !== '_' && mark !== '^') return null\n  i++\n  while (s[i] === ' ') i++\n  if (s[i] === '{') {\n    let depth = 0\n    const start = ++i\n    for (; i < s.length; i++) {\n      if (s[i] === '{') depth++\n      else if (s[i] === '}') {\n        if (depth === 0) break\n        depth--\n      }\n    }\n    return { mark, val: s.slice(start, i), next: i + 1 }\n  }\n  if (s[i] === '\\\\') {\n    const m = /^\\\\[a-zA-Z]+/.exec(s.slice(i))\n    if (!m) return null\n    return { mark, val: m[0], next: i + m[0].length }\n  }\n  const m = /^[A-Za-z0-9.]+/.exec(s.slice(i))\n  if (!m) return null\n  return { mark, val: m[0], next: i + m[0].length }\n}\n\n/** Translate a raw-LaTeX bound/target fragment and evaluate it to a finite number. */\nfunction evalBound(latex: string): number {\n  const trimmed = latex.trim()\n  if (/\\\\infty/.test(trimmed)) throw new CalculusError('INFINITE_BOUND')\n  const mathjsExpr = translateLatex(trimmed)\n  const value = math.evaluate!(mathjsExpr)\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new CalculusError('BAD_BOUND')\n  }\n  return value\n}\n\n/** Evaluate a definite integral `\\int_{a}^{b} f \\,dx` by Simpson quadrature. */\nfunction evalIntegral(s: string): string {\n  // Strip the operator (\\int, optionally with \\limits).\n  const m = /\\\\int(?:\\\\limits)?/.exec(s)\n  if (!m) throw new CalculusError('NOT_INTEGRAL')\n  let i = m.index + m[0].length\n\n  // Read up to two scripts (bounds), in either order.\n  const scripts: Record<'_' | '^', string | undefined> = { '_': undefined, '^': undefined }\n  for (let k = 0; k < 2; k++) {\n    const sc = readScript(s, i)\n    if (!sc) break\n    scripts[sc.mark] = sc.val\n    i = sc.next\n  }\n  if (scripts._ === undefined || scripts['^'] === undefined) {\n    throw new CalculusError('INDEFINITE')\n  }\n\n  // The remainder is `integrand … d<var>`. Pull the trailing differential off the end.\n  const rest = s.slice(i)\n  const diff = /\\\\?,?\\s*\\bd\\s*([a-zA-Z])\\s*$/.exec(rest)\n  if (!diff) throw new CalculusError('NO_DIFFERENTIAL')\n  const variable = diff[1]\n  const integrandLatex = rest.slice(0, diff.index)\n  if (integrandLatex.trim().length === 0) throw new CalculusError('NO_INTEGRAND')\n\n  const a = evalBound(scripts._)\n  const b = evalBound(scripts['^'])\n  const integrand = translateLatex(integrandLatex)\n  const fn = (x: number) => evalAt(integrand, variable, x)\n\n  let result: number\n  if (a === b) result = 0\n  else if (a < b) result = simpson(fn, a, b)\n  else result = -simpson(fn, b, a)\n\n  return `Converted: ∫(${integrand}) d${variable} from ${formatNumeric(a)} to ${formatNumeric(b)}\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Evaluate a derivative `\\frac{d}{dx} f \\big|_{x=a}` at a point via central finite difference. */\nfunction evalDerivative(s: string): string {\n  // Operator + variable: \\frac{d}{dx} … or bare d/dx ….\n  let variable: string | undefined\n  let body = s\n  const fracOp = /\\\\frac\\s*\\{\\s*d\\s*\\}\\s*\\{\\s*d\\s*([a-zA-Z])\\s*\\}/.exec(s)\n  if (fracOp) {\n    variable = fracOp[1]\n    body = s.slice(fracOp.index + fracOp[0].length)\n  } else {\n    const bareOp = /(?:^|[^a-zA-Z])d\\s*\\/\\s*d([a-zA-Z])/.exec(s)\n    if (bareOp) {\n      variable = bareOp[1]\n      body = s.slice(bareOp.index + bareOp[0].length)\n    }\n  }\n  if (!variable) throw new CalculusError('NOT_DERIVATIVE')\n\n  // Remove pure \\left. / \\right. delimiters.\n  body = body.replace(/\\\\left\\.?/g, '').replace(/\\\\right\\.?/g, '')\n\n  // Evaluation bar + point at the end: …|_{x=3} (optionally \\Big| etc.).\n  const bar = /\\\\?(?:Big|big|bigg|Bigg)?\\s*\\|\\s*_\\s*\\{?\\s*([a-zA-Z])\\s*=\\s*([^}]+?)\\s*\\}?\\s*$/.exec(\n    body\n  )\n  if (!bar) throw new CalculusError('NO_POINT')\n  const point = evalBound(bar[2])\n  let fnLatex = body.slice(0, bar.index).trim()\n\n  // Strip one layer of wrapping parentheses/brackets around the function body.\n  fnLatex = fnLatex\n    .replace(/^\\\\?\\(([\\s\\S]*)\\\\?\\)$/, '$1')\n    .replace(/^\\[([\\s\\S]*)\\]$/, '$1')\n    .trim()\n  if (fnLatex.length === 0) throw new CalculusError('NO_FUNCTION')\n\n  const expr = translateLatex(fnLatex)\n  const h = 1e-6\n  const fn = (x: number) => evalAt(expr, variable, x)\n  const result = (fn(point + h) - fn(point - h)) / (2 * h)\n  if (!Number.isFinite(result)) throw new CalculusError('NON_FINITE')\n\n  return `Converted: d/d${variable}(${expr}) at ${variable}=${formatNumeric(point)}\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Evaluate a limit `\\lim_{x \\to a} f(x)` by a two-sided numeric approach. */\nfunction evalLimit(s: string): string {\n  const head = /\\\\lim\\s*_\\s*\\{\\s*([a-zA-Z])\\s*\\\\to\\s*([\\s\\S]+?)\\s*\\}/.exec(s)\n  if (!head) throw new CalculusError('NOT_LIMIT')\n  const variable = head[1]\n  let targetLatex = head[2].trim()\n  const bodyLatex = s.slice(head.index + head[0].length).trim()\n  if (bodyLatex.length === 0) throw new CalculusError('NO_FUNCTION')\n\n  // One-sided markers (0^+, 0^-, 0^{+}) — record the side, strip the marker.\n  let side: 'both' | 'plus' | 'minus' = 'both'\n  const oneSided = /\\^\\s*\\{?\\s*([+-])\\s*\\}?\\s*$/.exec(targetLatex)\n  if (oneSided) {\n    side = oneSided[1] === '+' ? 'plus' : 'minus'\n    targetLatex = targetLatex.slice(0, oneSided.index).trim()\n  }\n\n  const expr = translateLatex(bodyLatex)\n  const fn = (x: number) => evalAt(expr, variable, x)\n  const eps = 1e-6\n\n  // Infinite targets via large-magnitude substitution.\n  let result: number\n  let targetLabel: string\n  if (/^-\\s*\\\\infty$/.test(targetLatex)) {\n    result = fn(-1e8)\n    targetLabel = '-∞'\n  } else if (/^\\\\infty$/.test(targetLatex)) {\n    result = fn(1e8)\n    targetLabel = '∞'\n  } else {\n    const target = evalBound(targetLatex)\n    targetLabel = formatNumeric(target)\n    if (side === 'plus') {\n      result = fn(target + eps)\n    } else if (side === 'minus') {\n      result = fn(target - eps)\n    } else {\n      const lo = fn(target - eps)\n      const hi = fn(target + eps)\n      const avg = (lo + hi) / 2\n      if (Math.abs(hi - lo) > 1e-3 * Math.max(1, Math.abs(avg))) {\n        throw new CalculusError('LIMIT_MISMATCH')\n      }\n      result = avg\n    }\n  }\n  if (!Number.isFinite(result)) throw new CalculusError('LIMIT_UNBOUNDED')\n\n  // Infinite-target substitution (±1e8) and the eps offset leave more residue than Simpson or the\n  // derivative difference, so snap a limit result to a nearby round value before formatting:\n  // 0.99999998 → 1, 1e-8 → 0. The tolerance is loose enough to absorb the substitution error yet\n  // far tighter than the divergence check that already rejected genuinely non-convergent limits.\n  const nearest = Math.round(result)\n  if (Math.abs(result - nearest) < 1e-6) result = nearest\n\n  return `Converted: lim ${variable}→${targetLabel} of (${expr})\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Human-readable, model-actionable message for each {@link CalculusError} tag. */\nfunction calculusErrorMessage(tag: string): string {\n  switch (tag) {\n    case 'INDEFINITE':\n      return 'Cannot evaluate an indefinite integral numerically. Provide bounds, e.g. \\\\int_{0}^{1} x dx.'\n    case 'NO_DIFFERENTIAL':\n      return \"Could not find the integration variable. Expected a trailing differential like 'dx'.\"\n    case 'NO_INTEGRAND':\n      return 'The integral has no integrand to evaluate.'\n    case 'INFINITE_BOUND':\n      return 'Infinite integration bounds are not supported. Provide finite numeric bounds, e.g. \\\\int_{0}^{1} f dx.'\n    case 'BAD_BOUND':\n      return 'Could not evaluate the integration bounds to numbers.'\n    case 'NO_POINT':\n      return 'Cannot evaluate a derivative numerically without a point. Specify where, e.g. \\\\frac{d}{dx}(x^2)\\\\Big|_{x=3}.'\n    case 'NO_FUNCTION':\n      return 'Could not find the function to evaluate.'\n    case 'LIMIT_MISMATCH':\n      return 'The limit may not exist (left and right values disagree).'\n    case 'LIMIT_UNBOUNDED':\n      return 'The limit appears to diverge (function is unbounded near the target).'\n    case 'NON_FINITE':\n      return 'The expression is not finite over the requested range (possible singularity); cannot evaluate numerically.'\n    default:\n      return 'Could not evaluate the calculus expression.'\n  }\n}\n\n/**\n * Detects a calculus construct in raw LaTeX and routes it to the matching numeric handler. Returns\n * the result/error string, or `null` when the input is not a calculus expression (so the caller\n * falls through to the scalar evaluation path unchanged).\n */\nfunction tryCalculus(latex: string): string | null {\n  let s = latex.trim()\n  s = s.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  s = s.replace(/^\\\\[[(]|\\\\[\\])]$/g, '').trim()\n\n  let handler: ((expr: string) => string) | undefined\n  if (/\\\\int/.test(s)) handler = evalIntegral\n  else if (/\\\\lim/.test(s)) handler = evalLimit\n  else if (\n    /\\\\frac\\s*\\{\\s*d\\s*\\}\\s*\\{\\s*d\\s*[a-zA-Z]\\s*\\}/.test(s) ||\n    /(?:^|[^a-zA-Z])d\\s*\\/\\s*d[a-zA-Z]/.test(s)\n  )\n    handler = evalDerivative\n  if (!handler) return null\n\n  try {\n    return handler(s)\n  } catch (err) {\n    if (isInstanceOf(err, 'CalculusError', CalculusError)) {\n      return `Error: ${calculusErrorMessage(err.message)}`\n    }\n    return `Error: ${isError(err) ? err.message : String(err)}`\n  }\n}\n\n/**\n * Evaluates a mathjs-syntax expression and returns the numeric result alongside the KaTeX\n * representation of the parsed expression.\n *\n * @remarks\n * Supports arithmetic, trigonometric, logarithmic, exponential, factorial, matrix, and unit\n * operations via `mathjs`. The mathjs instance is hardened: dangerous functions (`import`,\n * `createUnit`, `simplify`, `derivative`, `compile`, `chain`, `reviver`, `replacer`) are\n * disabled to prevent interpreter-surface exposure.\n *\n * Expressions over 1000 characters are rejected with an error string (not thrown). Parse and\n * evaluation errors are also returned as error strings — the tool surfaces math errors as\n * content rather than exceptions, so the model can react to them in-line.\n */\nexport const calculateTool = new Tool({\n  name: 'calculate',\n  description:\n    'Evaluate a math expression. Supports arithmetic, trig, log, sqrt, factorial, matrices.',\n  inputSchema: validator.object({\n    expression: validator.string().required().description('Math expression, e.g. \"sin(pi/4) + 5!\"'),\n  }),\n  handler: async (args) => {\n    const { expression } = args as { expression: string }\n\n    const lengthError = validateExpression(expression)\n    if (lengthError) return lengthError\n\n    try {\n      const result = math.evaluate!(expression)\n      // A scalar that overflowed float64 (e.g. `2^5000`, `factorial(200)`) comes back as\n      // `Infinity`/`NaN`. Surface that as a clear error rather than printing `Result: Infinity`,\n      // which reads like a genuine answer.\n      if (typeof result === 'number' && !Number.isFinite(result)) {\n        return `Error: result is not finite (${result}) — the value overflows JavaScript's numeric range.`\n      }\n      const node = math.parse!(expression)\n      const katex = node.toTex()\n      return `Result: ${result}\\nKaTeX: $${katex} = ${result}$`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Translates a LaTeX/KaTeX expression using evaluatex and returns the numeric result.\n *\n * @remarks\n * Uses the evaluatex library to parse and evaluate LaTeX expressions. Handles common constructs\n * (`\\frac{a}{b}`, `\\sqrt{...}`, `\\cdot`, `\\times`, Greek macros like `\\pi`, inverse trig,\n * `\\left`/`\\right` delimiters, `\\text{...}`, subscripts, etc.) with a proper parser rather than\n * brittle regex.\n *\n * Also evaluates three calculus constructs **numerically** (mathjs has no symbolic integration, and\n * its symbolic `derivative` is blocklisted here for safety):\n * - Definite integrals — `\\int_{a}^{b} f \\,dx` via composite Simpson quadrature.\n * - Derivatives at a point — `\\frac{d}{dx} f \\big|_{x=a}` via central finite difference.\n * - Limits — `\\lim_{x \\to a} f` (including `a = \\pm\\infty`) via a two-sided numeric approach.\n *\n * Numeric results are rounded with `math.format(..., { precision: 12 })` and labelled\n * `Result (numeric):` to flag that they are approximations. Constructs that cannot be evaluated\n * numerically (indefinite integrals, derivatives without a point, infinite integration bounds,\n * singular integrands, divergent limits) return a specific, guiding error string.\n *\n * Parse and evaluation errors are returned as error strings rather than thrown.\n */\nexport const evaluateKatexTool = new Tool({\n  name: 'evaluate_katex',\n  description:\n    'Evaluate a KaTeX/LaTeX math expression and return the numeric result. Supports arithmetic, trig, logs, roots, and numeric calculus: definite integrals (\\\\int_{a}^{b} f dx), derivatives at a point (\\\\frac{d}{dx} f|_{x=a}), and limits (\\\\lim_{x \\\\to a} f).',\n  inputSchema: validator.object({\n    katex: validator\n      .string()\n      .required()\n      .description('LaTeX expression, e.g. \"\\\\frac{1}{2} + \\\\sqrt{9}\" or \"\\\\int_{0}^{1} x^2 dx\"'),\n  }),\n  handler: async (args) => {\n    const { katex } = args as { katex: string }\n\n    const lengthError = validateExpression(katex)\n    if (lengthError) return lengthError\n\n    try {\n      // Calculus (\\int, \\lim, d/dx) is detected on the raw LaTeX and evaluated numerically before\n      // the scalar flattening path, which would otherwise mangle bounds/targets. Returns null for\n      // non-calculus input, falling through to the scalar evaluator below unchanged.\n      const calculus = tryCalculus(katex)\n      if (calculus !== null) return calculus\n\n      const result = evaluateLatex(katex)\n      return `Result: ${result}`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":"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"}