@nhtio/adk 1.20260607.2 → 1.20260609.0

package/batteries/tools/structured_data.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 { c as isObject, 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/structured_data/index.ts
@@ -49,29 +49,24 @@ var formatTableTool = new Tool({
 		}
 		if (!Array.isArray(rows)) return "Error: Input must be a JSON array.";
 		if (rows.length === 0) return "Empty array — no data to display.";
+		if (!explicitColumns && !isObject(rows[0])) return "Error: Cannot infer columns — the first row is not an object. Provide \"columns\", or pass an array of objects.";
 		const columns = explicitColumns ?? Object.keys(rows[0]);
+		const cell = (row, col) => isObject(row) ? row[col] : void 0;
 		if (format === "csv") {
 			const lines = [columns.map(csvEscape).join(",")];
-			for (const row of rows) {
-				const obj = row;
-				lines.push(columns.map((col) => csvEscape(obj[col])).join(","));
-			}
+			for (const row of rows) lines.push(columns.map((col) => csvEscape(cell(row, col))).join(","));
 			return lines.join("\n");
 		}
 		if (format === "tsv") {
 			const lines = [columns.map(tsvEscape).join("	")];
-			for (const row of rows) {
-				const obj = row;
-				lines.push(columns.map((col) => tsvEscape(obj[col])).join("	"));
-			}
+			for (const row of rows) lines.push(columns.map((col) => tsvEscape(cell(row, col))).join("	"));
 			return lines.join("\n");
 		}
 		return [
 			"| " + columns.map(mdEscape).join(" | ") + " |",
 			"| " + columns.map(() => "---").join(" | ") + " |",
 			...rows.map((row) => {
-				const obj = row;
-				return "| " + columns.map((col) => mdEscape(obj[col])).join(" | ") + " |";
+				return "| " + columns.map((col) => mdEscape(cell(row, col))).join(" | ") + " |";
 			})
 		].join("\n");
 	}

package/batteries/tools/structured_data.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"structured_data.mjs","names":[],"sources":["../../../src/batteries/tools/structured_data/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for transforming arrays and objects into tables and tabular text.\n *\n * @module @nhtio/adk/batteries/tools/structured_data\n *\n * @remarks\n * Pre-constructed bundled tools for the `structured_data` 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\nfunction csvEscape(value: unknown): string {\n  const str = value === null || value === undefined ? '' : String(value)\n  if (str.includes(',') || str.includes('\"') || str.includes('\\n') || str.includes('\\r')) {\n    return '\"' + str.replace(/\"/g, '\"\"') + '\"'\n  }\n  return str\n}\n\nfunction tsvEscape(value: unknown): string {\n  const str = value === null || value === undefined ? '' : String(value)\n  return str.replace(/\\t/g, ' ').replace(/\\r?\\n/g, ' ')\n}\n\nfunction mdEscape(value: unknown): string {\n  return String(value === null || value === undefined ? '' : value)\n    .replace(/\\|/g, '\\\\|')\n    .replace(/\\r?\\n/g, ' ')\n}\n\n/**\n * Convert a JSON array of objects into a formatted table.\n *\n * @remarks\n * Supports `markdown`, `csv`, and `tsv` output. Columns default to the keys of the first row;\n * supply `columns` to control which keys appear and in what order.\n */\nexport const formatTableTool = new Tool({\n  name: 'format_table',\n  description:\n    'Convert a JSON array of objects into a formatted table. Supports Markdown, CSV, and TSV output.',\n  inputSchema: validator.object({\n    data: validator.string().required().description('JSON array of objects as a string'),\n    format: validator\n      .string()\n      .valid('markdown', 'csv', 'tsv')\n      .required()\n      .description('Output format'),\n    columns: validator\n      .array()\n      .items(validator.string())\n      .optional()\n      .description(\n        'Column keys to include, in order. If omitted, all keys from the first row are used.'\n      ),\n  }),\n  handler: async (args) => {\n    const {\n      data,\n      format,\n      columns: explicitColumns,\n    } = args as {\n      data: string\n      format: 'markdown' | 'csv' | 'tsv'\n      columns?: string[]\n    }\n\n    let rows: unknown[]\n    try {\n      rows = JSON.parse(data)\n    } catch {\n      return 'Error: Invalid JSON input.'\n    }\n\n    if (!Array.isArray(rows)) return 'Error: Input must be a JSON array.'\n    if (rows.length === 0) return 'Empty array — no data to display.'\n\n    const columns = explicitColumns ?? Object.keys(rows[0] as Record<string, unknown>)\n\n    if (format === 'csv') {\n      const lines = [columns.map(csvEscape).join(',')]\n      for (const row of rows) {\n        const obj = row as Record<string, unknown>\n        lines.push(columns.map((col) => csvEscape(obj[col])).join(','))\n      }\n      return lines.join('\\n')\n    }\n\n    if (format === 'tsv') {\n      const lines = [columns.map(tsvEscape).join('\\t')]\n      for (const row of rows) {\n        const obj = row as Record<string, unknown>\n        lines.push(columns.map((col) => tsvEscape(obj[col])).join('\\t'))\n      }\n      return lines.join('\\n')\n    }\n\n    const header = '| ' + columns.map(mdEscape).join(' | ') + ' |'\n    const separator = '| ' + columns.map(() => '---').join(' | ') + ' |'\n    const dataRows = rows.map((row) => {\n      const obj = row as Record<string, unknown>\n      return '| ' + columns.map((col) => mdEscape(obj[col])).join(' | ') + ' |'\n    })\n    return [header, separator, ...dataRows].join('\\n')\n  },\n})\n\n/**\n * Pretty-print or minify a JSON string.\n *\n * @remarks\n * Validates the input as JSON, then re-serialises it with the requested indentation. `indent` is\n * clamped to the range [0, 8]; `0` produces minified output.\n */\nexport const jsonFormatTool = new Tool({\n  name: 'json_format',\n  description: 'Pretty-print or minify a JSON string. Validates JSON and normalises whitespace.',\n  inputSchema: validator.object({\n    data: validator.string().required().description('JSON string to format'),\n    indent: validator\n      .number()\n      .default(2)\n      .description('Indentation spaces (0 = minify, default: 2). Max: 8.'),\n  }),\n  handler: async (args) => {\n    const { data, indent } = args as { data: string; indent: number }\n    try {\n      const parsed = JSON.parse(data)\n      return JSON.stringify(parsed, null, Math.max(0, Math.min(8, Math.floor(indent))))\n    } catch (err) {\n      return `Error: Invalid JSON — ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\nconst FORMAT_PATTERNS: Record<string, { pattern: RegExp; label: string }> = {\n  email: {\n    pattern: /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/,\n    label: 'email address',\n  },\n  uuid: {\n    pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n    label: 'UUID (v1–v5)',\n  },\n  ipv4: {\n    pattern: /^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$/,\n    label: 'IPv4 address',\n  },\n  iso_date: {\n    pattern: /^\\d{4}-\\d{2}-\\d{2}$/,\n    label: 'ISO 8601 date (YYYY-MM-DD)',\n  },\n  iso_datetime: {\n    pattern: /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?$/,\n    label: 'ISO 8601 datetime',\n  },\n  hex_color: {\n    pattern: /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,\n    label: 'CSS hex color',\n  },\n  phone_e164: {\n    pattern: /^\\+[1-9]\\d{1,14}$/,\n    label: 'E.164 phone number',\n  },\n  semver: {\n    pattern: /^\\d+\\.\\d+\\.\\d+(-[0-9A-Za-z-.]+)?(\\+[0-9A-Za-z-.]+)?$/,\n    label: 'Semantic Version (SemVer)',\n  },\n  integer: {\n    pattern: /^-?\\d+$/,\n    label: 'integer',\n  },\n  decimal: {\n    pattern: /^-?\\d+(\\.\\d+)?$/,\n    label: 'decimal number',\n  },\n  alphanumeric: {\n    pattern: /^[a-zA-Z0-9]+$/,\n    label: 'alphanumeric string',\n  },\n  slug: {\n    pattern: /^[a-z0-9]+(-[a-z0-9]+)*$/,\n    label: 'URL slug',\n  },\n  hex: {\n    pattern: /^(0x)?[0-9a-fA-F]+$/,\n    label: 'hexadecimal string',\n  },\n  base64: {\n    pattern: /^[A-Za-z0-9+/]*={0,2}$/,\n    label: 'base64-encoded string',\n  },\n}\n\n/**\n * Check whether a string matches a known format.\n *\n * @remarks\n * Supported formats: `email`, `uuid` (v1–v5), `ipv4`, `iso_date`, `iso_datetime`, `hex_color`,\n * `phone_e164`, `semver`, `integer`, `decimal`, `alphanumeric`, `slug`, `hex`, `base64`.\n */\nexport const validateFormatTool = new Tool({\n  name: 'validate_format',\n  description:\n    'Check whether a string matches a known format (email, UUID, ISO date, hex colour, phone number, semver, slug, etc.).',\n  inputSchema: validator.object({\n    value: validator.string().required().description('The string to validate'),\n    format: validator\n      .string()\n      .valid(...Object.keys(FORMAT_PATTERNS))\n      .required()\n      .description(\n        `Format to validate against. One of: ${Object.keys(FORMAT_PATTERNS).join(', ')}`\n      ),\n  }),\n  handler: async (args) => {\n    const { value, format } = args as { value: string; format: string }\n    const def = FORMAT_PATTERNS[format]\n    if (!def) {\n      return `Error: Unknown format \"${format}\". Supported: ${Object.keys(FORMAT_PATTERNS).join(', ')}`\n    }\n    const valid = def.pattern.test(value)\n    return valid\n      ? `Valid: \"${value}\" is a valid ${def.label}.`\n      : `Invalid: \"${value}\" is not a valid ${def.label}.`\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAS,UAAU,OAAwB;CACzC,MAAM,MAAM,UAAU,QAAQ,UAAU,KAAA,IAAY,KAAK,OAAO,KAAK;CACrE,IAAI,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS,IAAG,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,SAAS,IAAI,GACnF,OAAO,OAAM,IAAI,QAAQ,MAAM,MAAI,IAAI;CAEzC,OAAO;AACT;AAEA,SAAS,UAAU,OAAwB;CAEzC,QADY,UAAU,QAAQ,UAAU,KAAA,IAAY,KAAK,OAAO,KAAK,GAC1D,QAAQ,OAAO,GAAG,EAAE,QAAQ,UAAU,GAAG;AACtD;AAEA,SAAS,SAAS,OAAwB;CACxC,OAAO,OAAO,UAAU,QAAQ,UAAU,KAAA,IAAY,KAAK,KAAK,EAC7D,QAAQ,OAAO,KAAK,EACpB,QAAQ,UAAU,GAAG;AAC1B;;;;;;;;AASA,IAAa,kBAAkB,IAAI,KAAK;CACtC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,MAAM,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,mCAAmC;EACnF,QAAQ,UACL,OAAO,EACP,MAAM,YAAY,OAAO,KAAK,EAC9B,SAAS,EACT,YAAY,eAAe;EAC9B,SAAS,UACN,MAAM,EACN,MAAM,UAAU,OAAO,CAAC,EACxB,SAAS,EACT,YACC,qFACF;CACJ,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,MACA,QACA,SAAS,oBACP;EAMJ,IAAI;EACJ,IAAI;GACF,OAAO,KAAK,MAAM,IAAI;EACxB,QAAQ;GACN,OAAO;EACT;EAEA,IAAI,CAAC,MAAM,QAAQ,IAAI,GAAG,OAAO;EACjC,IAAI,KAAK,WAAW,GAAG,OAAO;EAE9B,MAAM,UAAU,mBAAmB,OAAO,KAAK,KAAK,EAA6B;EAEjF,IAAI,WAAW,OAAO;GACpB,MAAM,QAAQ,CAAC,QAAQ,IAAI,SAAS,EAAE,KAAK,GAAG,CAAC;GAC/C,KAAK,MAAM,OAAO,MAAM;IACtB,MAAM,MAAM;IACZ,MAAM,KAAK,QAAQ,KAAK,QAAQ,UAAU,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC;GAChE;GACA,OAAO,MAAM,KAAK,IAAI;EACxB;EAEA,IAAI,WAAW,OAAO;GACpB,MAAM,QAAQ,CAAC,QAAQ,IAAI,SAAS,EAAE,KAAK,GAAI,CAAC;GAChD,KAAK,MAAM,OAAO,MAAM;IACtB,MAAM,MAAM;IACZ,MAAM,KAAK,QAAQ,KAAK,QAAQ,UAAU,IAAI,IAAI,CAAC,EAAE,KAAK,GAAI,CAAC;GACjE;GACA,OAAO,MAAM,KAAK,IAAI;EACxB;EAQA,OAAO;GANQ,OAAO,QAAQ,IAAI,QAAQ,EAAE,KAAK,KAAK,IAAI;GACxC,OAAO,QAAQ,UAAU,KAAK,EAAE,KAAK,KAAK,IAAI;GAKrC,GAJV,KAAK,KAAK,QAAQ;IACjC,MAAM,MAAM;IACZ,OAAO,OAAO,QAAQ,KAAK,QAAQ,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI;GACvE,CAC8B;EAAQ,EAAE,KAAK,IAAI;CACnD;AACF,CAAC;;;;;;;;AASD,IAAa,iBAAiB,IAAI,KAAK;CACrC,MAAM;CACN,aAAa;CACb,aAAa,UAAU,OAAO;EAC5B,MAAM,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,uBAAuB;EACvE,QAAQ,UACL,OAAO,EACP,QAAQ,CAAC,EACT,YAAY,sDAAsD;CACvE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,MAAM,WAAW;EACzB,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,IAAI;GAC9B,OAAO,KAAK,UAAU,QAAQ,MAAM,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC;EAClF,SAAS,KAAK;GACZ,OAAO,yBAAyB,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EACzE;CACF;AACF,CAAC;AAED,IAAM,kBAAsE;CAC1E,OAAO;EACL,SAAS;EACT,OAAO;CACT;CACA,MAAM;EACJ,SAAS;EACT,OAAO;CACT;CACA,MAAM;EACJ,SAAS;EACT,OAAO;CACT;CACA,UAAU;EACR,SAAS;EACT,OAAO;CACT;CACA,cAAc;EACZ,SAAS;EACT,OAAO;CACT;CACA,WAAW;EACT,SAAS;EACT,OAAO;CACT;CACA,YAAY;EACV,SAAS;EACT,OAAO;CACT;CACA,QAAQ;EACN,SAAS;EACT,OAAO;CACT;CACA,SAAS;EACP,SAAS;EACT,OAAO;CACT;CACA,SAAS;EACP,SAAS;EACT,OAAO;CACT;CACA,cAAc;EACZ,SAAS;EACT,OAAO;CACT;CACA,MAAM;EACJ,SAAS;EACT,OAAO;CACT;CACA,KAAK;EACH,SAAS;EACT,OAAO;CACT;CACA,QAAQ;EACN,SAAS;EACT,OAAO;CACT;AACF;;;;;;;;AASA,IAAa,qBAAqB,IAAI,KAAK;CACzC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,OAAO,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,wBAAwB;EACzE,QAAQ,UACL,OAAO,EACP,MAAM,GAAG,OAAO,KAAK,eAAe,CAAC,EACrC,SAAS,EACT,YACC,uCAAuC,OAAO,KAAK,eAAe,EAAE,KAAK,IAAI,GAC/E;CACJ,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,OAAO,WAAW;EAC1B,MAAM,MAAM,gBAAgB;EAC5B,IAAI,CAAC,KACH,OAAO,0BAA0B,OAAO,gBAAgB,OAAO,KAAK,eAAe,EAAE,KAAK,IAAI;EAGhG,OADc,IAAI,QAAQ,KAAK,KACxB,IACH,WAAW,MAAM,eAAe,IAAI,MAAM,KAC1C,aAAa,MAAM,mBAAmB,IAAI,MAAM;CACtD;AACF,CAAC"}
+{"version":3,"file":"structured_data.mjs","names":[],"sources":["../../../src/batteries/tools/structured_data/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for transforming arrays and objects into tables and tabular text.\n *\n * @module @nhtio/adk/batteries/tools/structured_data\n *\n * @remarks\n * Pre-constructed bundled tools for the `structured_data` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\nimport { isError, isObject } from '@nhtio/adk/guards'\n\nfunction csvEscape(value: unknown): string {\n  const str = value === null || value === undefined ? '' : String(value)\n  if (str.includes(',') || str.includes('\"') || str.includes('\\n') || str.includes('\\r')) {\n    return '\"' + str.replace(/\"/g, '\"\"') + '\"'\n  }\n  return str\n}\n\nfunction tsvEscape(value: unknown): string {\n  const str = value === null || value === undefined ? '' : String(value)\n  return str.replace(/\\t/g, ' ').replace(/\\r?\\n/g, ' ')\n}\n\nfunction mdEscape(value: unknown): string {\n  return String(value === null || value === undefined ? '' : value)\n    .replace(/\\|/g, '\\\\|')\n    .replace(/\\r?\\n/g, ' ')\n}\n\n/**\n * Convert a JSON array of objects into a formatted table.\n *\n * @remarks\n * Supports `markdown`, `csv`, and `tsv` output. Columns default to the keys of the first row;\n * supply `columns` to control which keys appear and in what order.\n */\nexport const formatTableTool = new Tool({\n  name: 'format_table',\n  description:\n    'Convert a JSON array of objects into a formatted table. Supports Markdown, CSV, and TSV output.',\n  inputSchema: validator.object({\n    data: validator.string().required().description('JSON array of objects as a string'),\n    format: validator\n      .string()\n      .valid('markdown', 'csv', 'tsv')\n      .required()\n      .description('Output format'),\n    columns: validator\n      .array()\n      .items(validator.string())\n      .optional()\n      .description(\n        'Column keys to include, in order. If omitted, all keys from the first row are used.'\n      ),\n  }),\n  handler: async (args) => {\n    const {\n      data,\n      format,\n      columns: explicitColumns,\n    } = args as {\n      data: string\n      format: 'markdown' | 'csv' | 'tsv'\n      columns?: string[]\n    }\n\n    let rows: unknown[]\n    try {\n      rows = JSON.parse(data)\n    } catch {\n      return 'Error: Invalid JSON input.'\n    }\n\n    if (!Array.isArray(rows)) return 'Error: Input must be a JSON array.'\n    if (rows.length === 0) return 'Empty array — no data to display.'\n\n    // Columns default to the first row's keys, but only an object row has keys. If columns aren't\n    // given and the first row isn't an object, there's nothing to tabulate — error clearly rather\n    // than throwing on `Object.keys(null)`.\n    if (!explicitColumns && !isObject(rows[0])) {\n      return 'Error: Cannot infer columns — the first row is not an object. Provide \"columns\", or pass an array of objects.'\n    }\n    const columns = explicitColumns ?? Object.keys(rows[0] as Record<string, unknown>)\n\n    // Read a cell safely: a null/primitive row has no properties, so it yields empty cells rather\n    // than throwing on `row[col]`.\n    const cell = (row: unknown, col: string): unknown =>\n      isObject(row) ? (row as Record<string, unknown>)[col] : undefined\n\n    if (format === 'csv') {\n      const lines = [columns.map(csvEscape).join(',')]\n      for (const row of rows) {\n        lines.push(columns.map((col) => csvEscape(cell(row, col))).join(','))\n      }\n      return lines.join('\\n')\n    }\n\n    if (format === 'tsv') {\n      const lines = [columns.map(tsvEscape).join('\\t')]\n      for (const row of rows) {\n        lines.push(columns.map((col) => tsvEscape(cell(row, col))).join('\\t'))\n      }\n      return lines.join('\\n')\n    }\n\n    const header = '| ' + columns.map(mdEscape).join(' | ') + ' |'\n    const separator = '| ' + columns.map(() => '---').join(' | ') + ' |'\n    const dataRows = rows.map((row) => {\n      return '| ' + columns.map((col) => mdEscape(cell(row, col))).join(' | ') + ' |'\n    })\n    return [header, separator, ...dataRows].join('\\n')\n  },\n})\n\n/**\n * Pretty-print or minify a JSON string.\n *\n * @remarks\n * Validates the input as JSON, then re-serialises it with the requested indentation. `indent` is\n * clamped to the range [0, 8]; `0` produces minified output.\n */\nexport const jsonFormatTool = new Tool({\n  name: 'json_format',\n  description: 'Pretty-print or minify a JSON string. Validates JSON and normalises whitespace.',\n  inputSchema: validator.object({\n    data: validator.string().required().description('JSON string to format'),\n    indent: validator\n      .number()\n      .default(2)\n      .description('Indentation spaces (0 = minify, default: 2). Max: 8.'),\n  }),\n  handler: async (args) => {\n    const { data, indent } = args as { data: string; indent: number }\n    try {\n      const parsed = JSON.parse(data)\n      return JSON.stringify(parsed, null, Math.max(0, Math.min(8, Math.floor(indent))))\n    } catch (err) {\n      return `Error: Invalid JSON — ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\nconst FORMAT_PATTERNS: Record<string, { pattern: RegExp; label: string }> = {\n  email: {\n    pattern: /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/,\n    label: 'email address',\n  },\n  uuid: {\n    pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n    label: 'UUID (v1–v5)',\n  },\n  ipv4: {\n    pattern: /^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$/,\n    label: 'IPv4 address',\n  },\n  iso_date: {\n    pattern: /^\\d{4}-\\d{2}-\\d{2}$/,\n    label: 'ISO 8601 date (YYYY-MM-DD)',\n  },\n  iso_datetime: {\n    pattern: /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?$/,\n    label: 'ISO 8601 datetime',\n  },\n  hex_color: {\n    pattern: /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,\n    label: 'CSS hex color',\n  },\n  phone_e164: {\n    pattern: /^\\+[1-9]\\d{1,14}$/,\n    label: 'E.164 phone number',\n  },\n  semver: {\n    pattern: /^\\d+\\.\\d+\\.\\d+(-[0-9A-Za-z-.]+)?(\\+[0-9A-Za-z-.]+)?$/,\n    label: 'Semantic Version (SemVer)',\n  },\n  integer: {\n    pattern: /^-?\\d+$/,\n    label: 'integer',\n  },\n  decimal: {\n    pattern: /^-?\\d+(\\.\\d+)?$/,\n    label: 'decimal number',\n  },\n  alphanumeric: {\n    pattern: /^[a-zA-Z0-9]+$/,\n    label: 'alphanumeric string',\n  },\n  slug: {\n    pattern: /^[a-z0-9]+(-[a-z0-9]+)*$/,\n    label: 'URL slug',\n  },\n  hex: {\n    pattern: /^(0x)?[0-9a-fA-F]+$/,\n    label: 'hexadecimal string',\n  },\n  base64: {\n    pattern: /^[A-Za-z0-9+/]*={0,2}$/,\n    label: 'base64-encoded string',\n  },\n}\n\n/**\n * Check whether a string matches a known format.\n *\n * @remarks\n * Supported formats: `email`, `uuid` (v1–v5), `ipv4`, `iso_date`, `iso_datetime`, `hex_color`,\n * `phone_e164`, `semver`, `integer`, `decimal`, `alphanumeric`, `slug`, `hex`, `base64`.\n */\nexport const validateFormatTool = new Tool({\n  name: 'validate_format',\n  description:\n    'Check whether a string matches a known format (email, UUID, ISO date, hex colour, phone number, semver, slug, etc.).',\n  inputSchema: validator.object({\n    value: validator.string().required().description('The string to validate'),\n    format: validator\n      .string()\n      .valid(...Object.keys(FORMAT_PATTERNS))\n      .required()\n      .description(\n        `Format to validate against. One of: ${Object.keys(FORMAT_PATTERNS).join(', ')}`\n      ),\n  }),\n  handler: async (args) => {\n    const { value, format } = args as { value: string; format: string }\n    const def = FORMAT_PATTERNS[format]\n    if (!def) {\n      return `Error: Unknown format \"${format}\". Supported: ${Object.keys(FORMAT_PATTERNS).join(', ')}`\n    }\n    const valid = def.pattern.test(value)\n    return valid\n      ? `Valid: \"${value}\" is a valid ${def.label}.`\n      : `Invalid: \"${value}\" is not a valid ${def.label}.`\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/text_analysis.cjs

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

package/batteries/tools/text_analysis.mjs

@@ -1,6 +1,6 @@
-import { t as Tool } from "../../tool-CMhaDRNd.mjs";
-import "../../common-BT0nfCi9.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-Ci5UL7l4.mjs";
+import { t as Tool } from "../../tool-wMYMVl60.mjs";
+import "../../common-DYDUi99O.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-wkrBF3oX.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/text_analysis/index.ts
 /**

package/batteries/tools/text_comparison.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");
 let diff = require("diff");
 let fastest_levenshtein = require("fastest-levenshtein");

package/batteries/tools/text_comparison.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";
 import { diffLines, diffWords } from "diff";
 import { distance } from "fastest-levenshtein";

package/batteries/tools/time.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");
 let luxon = require("luxon");
 //#region src/batteries/tools/time/index.ts

package/batteries/tools/time.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";
 import { DateTime, IANAZone } from "luxon";
 //#region src/batteries/tools/time/index.ts

package/batteries/tools/unit_conversion.cjs

@@ -1,7 +1,8 @@
 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");
+const require_lib_helpers_bignum = require("../../lib/helpers/bignum.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/unit_conversion/index.ts
 /**
@@ -425,15 +426,17 @@ var convertUnitTool = new require_tool.Tool({
 	inputSchema: _nhtio_validation.validator.object({
 		value: _nhtio_validation.validator.number().required().description("Numeric value to convert"),
 		from: _nhtio_validation.validator.string().required().description(`Source unit key. Supported keys: ${ALL_UNIT_KEYS}`),
-		to: _nhtio_validation.validator.string().required().description("Target unit key (must be in the same category as source)")
+		to: _nhtio_validation.validator.string().required().description("Target unit key (must be in the same category as source)"),
+		precision: _nhtio_validation.validator.number().default(8).description(`Significant digits in the result (default: 8).`)
 	}),
 	handler: async (args) => {
-		const { value, from, to } = args;
+		const { value, from, to, precision } = args;
 		if (TEMP_UNITS.has(from) || TEMP_UNITS.has(to)) {
 			if (!TEMP_UNITS.has(from)) return `Error: "${from}" is not a temperature unit. Use C, F, or K.`;
 			if (!TEMP_UNITS.has(to)) return `Error: "${to}" is not a temperature unit. Use C, F, or K.`;
-			const result = fromKelvin(toKelvin(value, from), to);
-			const rounded = Number.parseFloat(result.toPrecision(10));
+			const kelvin = toKelvin(value, from);
+			if (kelvin < -1e-9) return `Error: ${value}${TEMP_LABELS[from]} is below absolute zero (0 K); not a physical temperature.`;
+			const rounded = require_lib_helpers_bignum.formatBig(fromKelvin(kelvin, to), precision);
 			return `${value}${TEMP_LABELS[from]} = ${rounded}${TEMP_LABELS[to]}`;
 		}
 		const fromDef = UNITS[from];
@@ -441,8 +444,7 @@ var convertUnitTool = new require_tool.Tool({
 		if (!fromDef) return `Error: Unknown unit "${from}". Supported: ${ALL_UNIT_KEYS}`;
 		if (!toDef) return `Error: Unknown unit "${to}". Supported: ${ALL_UNIT_KEYS}`;
 		if (fromDef.category !== toDef.category) return `Error: Cannot convert "${from}" (${fromDef.category}) to "${to}" (${toDef.category}) — different categories.`;
-		const result = value * fromDef.factor / toDef.factor;
-		const rounded = Number.parseFloat(result.toPrecision(10));
+		const rounded = require_lib_helpers_bignum.formatBig(require_lib_helpers_bignum.bigScale(value, fromDef.factor, toDef.factor), precision);
 		return `${value} ${fromDef.label} = ${rounded} ${toDef.label}`;
 	}
 });

package/batteries/tools/unit_conversion.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"unit_conversion.cjs","names":[],"sources":["../../../src/batteries/tools/unit_conversion/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for converting values across common measurement units.\n *\n * @module @nhtio/adk/batteries/tools/unit_conversion\n *\n * @remarks\n * Pre-constructed bundled tools for the `unit_conversion` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\n\ntype UnitDef = { category: string; factor: number; label: string }\n\nconst UNITS: Record<string, UnitDef> = {\n  // Length (base: metre)\n  m: { category: 'length', factor: 1, label: 'metres' },\n  km: { category: 'length', factor: 1000, label: 'kilometres' },\n  cm: { category: 'length', factor: 0.01, label: 'centimetres' },\n  mm: { category: 'length', factor: 0.001, label: 'millimetres' },\n  mi: { category: 'length', factor: 1609.344, label: 'miles' },\n  ft: { category: 'length', factor: 0.3048, label: 'feet' },\n  in: { category: 'length', factor: 0.0254, label: 'inches' },\n  yd: { category: 'length', factor: 0.9144, label: 'yards' },\n  nmi: { category: 'length', factor: 1852, label: 'nautical miles' },\n\n  // Mass (base: gram)\n  g: { category: 'mass', factor: 1, label: 'grams' },\n  kg: { category: 'mass', factor: 1000, label: 'kilograms' },\n  mg: { category: 'mass', factor: 0.001, label: 'milligrams' },\n  t: { category: 'mass', factor: 1_000_000, label: 'metric tons' },\n  lb: { category: 'mass', factor: 453.59237, label: 'pounds' },\n  oz: { category: 'mass', factor: 28.349523125, label: 'ounces' },\n  st: { category: 'mass', factor: 6350.29318, label: 'stone' },\n\n  // Volume (base: litre)\n  L: { category: 'volume', factor: 1, label: 'litres' },\n  mL: { category: 'volume', factor: 0.001, label: 'millilitres' },\n  m3: { category: 'volume', factor: 1000, label: 'cubic metres' },\n  cm3: { category: 'volume', factor: 0.001, label: 'cubic centimetres' },\n  gal: { category: 'volume', factor: 3.785411784, label: 'US gallons' },\n  qt: { category: 'volume', factor: 0.946352946, label: 'US quarts' },\n  pt: { category: 'volume', factor: 0.473176473, label: 'US pints' },\n  cup: { category: 'volume', factor: 0.2365882365, label: 'US cups' },\n  floz: { category: 'volume', factor: 0.029573529562, label: 'US fluid ounces' },\n  tbsp: { category: 'volume', factor: 0.014786764781, label: 'tablespoons' },\n  tsp: { category: 'volume', factor: 0.0049289215938, label: 'teaspoons' },\n\n  // Speed (base: m/s)\n  m_s: { category: 'speed', factor: 1, label: 'm/s' },\n  km_h: { category: 'speed', factor: 1 / 3.6, label: 'km/h' },\n  mph: { category: 'speed', factor: 0.44704, label: 'mph' },\n  kn: { category: 'speed', factor: 0.514444, label: 'knots' },\n  ft_s: { category: 'speed', factor: 0.3048, label: 'ft/s' },\n\n  // Area (base: m²)\n  m2: { category: 'area', factor: 1, label: 'm²' },\n  km2: { category: 'area', factor: 1_000_000, label: 'km²' },\n  cm2: { category: 'area', factor: 0.0001, label: 'cm²' },\n  mm2: { category: 'area', factor: 0.000001, label: 'mm²' },\n  ft2: { category: 'area', factor: 0.09290304, label: 'sq ft' },\n  in2: { category: 'area', factor: 0.00064516, label: 'sq in' },\n  yd2: { category: 'area', factor: 0.83612736, label: 'sq yd' },\n  acre: { category: 'area', factor: 4046.8564224, label: 'acres' },\n  ha: { category: 'area', factor: 10_000, label: 'hectares' },\n\n  // Data storage (base: bit)\n  bit: { category: 'data', factor: 1, label: 'bits' },\n  B: { category: 'data', factor: 8, label: 'bytes' },\n  KB: { category: 'data', factor: 8_000, label: 'kilobytes' },\n  MB: { category: 'data', factor: 8_000_000, label: 'megabytes' },\n  GB: { category: 'data', factor: 8_000_000_000, label: 'gigabytes' },\n  TB: { category: 'data', factor: 8_000_000_000_000, label: 'terabytes' },\n  KiB: { category: 'data', factor: 8 * 1024, label: 'kibibytes' },\n  MiB: { category: 'data', factor: 8 * 1024 ** 2, label: 'mebibytes' },\n  GiB: { category: 'data', factor: 8 * 1024 ** 3, label: 'gibibytes' },\n  TiB: { category: 'data', factor: 8 * 1024 ** 4, label: 'tebibytes' },\n\n  // Time (base: second)\n  ms: { category: 'time', factor: 0.001, label: 'milliseconds' },\n  s: { category: 'time', factor: 1, label: 'seconds' },\n  min: { category: 'time', factor: 60, label: 'minutes' },\n  h: { category: 'time', factor: 3600, label: 'hours' },\n  d: { category: 'time', factor: 86400, label: 'days' },\n  wk: { category: 'time', factor: 604800, label: 'weeks' },\n\n  // Energy (base: joule)\n  J: { category: 'energy', factor: 1, label: 'joules' },\n  kJ: { category: 'energy', factor: 1000, label: 'kilojoules' },\n  cal: { category: 'energy', factor: 4.184, label: 'calories' },\n  kcal: { category: 'energy', factor: 4184, label: 'kilocalories' },\n  Wh: { category: 'energy', factor: 3600, label: 'watt-hours' },\n  kWh: { category: 'energy', factor: 3_600_000, label: 'kilowatt-hours' },\n  BTU: { category: 'energy', factor: 1055.05585, label: 'BTU' },\n\n  // Pressure (base: pascal)\n  Pa: { category: 'pressure', factor: 1, label: 'pascals' },\n  kPa: { category: 'pressure', factor: 1000, label: 'kilopascals' },\n  MPa: { category: 'pressure', factor: 1_000_000, label: 'megapascals' },\n  bar: { category: 'pressure', factor: 100_000, label: 'bar' },\n  psi: { category: 'pressure', factor: 6894.757, label: 'psi' },\n  atm: { category: 'pressure', factor: 101325, label: 'atm' },\n  mmHg: { category: 'pressure', factor: 133.322, label: 'mmHg' },\n\n  // Angle (base: radian)\n  rad: { category: 'angle', factor: 1, label: 'radians' },\n  deg: { category: 'angle', factor: Math.PI / 180, label: 'degrees' },\n  grad: { category: 'angle', factor: Math.PI / 200, label: 'gradians' },\n}\n\nconst TEMP_UNITS = new Set(['C', 'F', 'K'])\ntype TempUnit = 'C' | 'F' | 'K'\nconst TEMP_LABELS: Record<TempUnit, string> = { C: '°C', F: '°F', K: 'K' }\n\nfunction toKelvin(value: number, unit: TempUnit): number {\n  if (unit === 'C') return value + 273.15\n  if (unit === 'F') return (value - 32) * (5 / 9) + 273.15\n  return value\n}\n\nfunction fromKelvin(kelvin: number, unit: TempUnit): number {\n  if (unit === 'C') return kelvin - 273.15\n  if (unit === 'F') return (kelvin - 273.15) * (9 / 5) + 32\n  return kelvin\n}\n\nconst ALL_UNIT_KEYS = [...Object.keys(UNITS), 'C', 'F', 'K'].join(', ')\n\n/**\n * Convert a numeric value between units of the same physical category.\n *\n * @remarks\n * Supported categories: length, mass, volume, temperature, speed, area, data, time, energy,\n * pressure, angle. Uses static conversion tables — no external data required. Temperature is\n * handled specially via a Kelvin intermediate to preserve precision across `C`/`F`/`K`.\n */\nexport const convertUnitTool = new Tool({\n  name: 'convert_unit',\n  description:\n    'Convert a numeric value between units of the same category (length, mass, volume, temperature, speed, area, data, time, energy, pressure, angle). Uses static lookup tables — no external data required.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('Numeric value to convert'),\n    from: validator\n      .string()\n      .required()\n      .description(`Source unit key. Supported keys: ${ALL_UNIT_KEYS}`),\n    to: validator\n      .string()\n      .required()\n      .description('Target unit key (must be in the same category as source)'),\n  }),\n  handler: async (args) => {\n    const { value, from, to } = args as { value: number; from: string; to: string }\n\n    if (TEMP_UNITS.has(from) || TEMP_UNITS.has(to)) {\n      if (!TEMP_UNITS.has(from))\n        return `Error: \"${from}\" is not a temperature unit. Use C, F, or K.`\n      if (!TEMP_UNITS.has(to)) return `Error: \"${to}\" is not a temperature unit. Use C, F, or K.`\n      const result = fromKelvin(toKelvin(value, from as TempUnit), to as TempUnit)\n      const rounded = Number.parseFloat(result.toPrecision(10))\n      return `${value}${TEMP_LABELS[from as TempUnit]} = ${rounded}${TEMP_LABELS[to as TempUnit]}`\n    }\n\n    const fromDef = UNITS[from]\n    const toDef = UNITS[to]\n    if (!fromDef) return `Error: Unknown unit \"${from}\". Supported: ${ALL_UNIT_KEYS}`\n    if (!toDef) return `Error: Unknown unit \"${to}\". Supported: ${ALL_UNIT_KEYS}`\n    if (fromDef.category !== toDef.category) {\n      return `Error: Cannot convert \"${from}\" (${fromDef.category}) to \"${to}\" (${toDef.category}) — different categories.`\n    }\n\n    const inBase = value * fromDef.factor\n    const result = inBase / toDef.factor\n    const rounded = Number.parseFloat(result.toPrecision(10))\n    return `${value} ${fromDef.label} = ${rounded} ${toDef.label}`\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"unit_conversion.cjs","names":[],"sources":["../../../src/batteries/tools/unit_conversion/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for converting values across common measurement units.\n *\n * @module @nhtio/adk/batteries/tools/unit_conversion\n *\n * @remarks\n * Pre-constructed bundled tools for the `unit_conversion` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\nimport { bigScale, formatBig, DEFAULT_PRECISION } from '@nhtio/adk/lib/helpers/bignum'\n\ntype UnitDef = { category: string; factor: number; label: string }\n\nconst UNITS: Record<string, UnitDef> = {\n  // Length (base: metre)\n  m: { category: 'length', factor: 1, label: 'metres' },\n  km: { category: 'length', factor: 1000, label: 'kilometres' },\n  cm: { category: 'length', factor: 0.01, label: 'centimetres' },\n  mm: { category: 'length', factor: 0.001, label: 'millimetres' },\n  mi: { category: 'length', factor: 1609.344, label: 'miles' },\n  ft: { category: 'length', factor: 0.3048, label: 'feet' },\n  in: { category: 'length', factor: 0.0254, label: 'inches' },\n  yd: { category: 'length', factor: 0.9144, label: 'yards' },\n  nmi: { category: 'length', factor: 1852, label: 'nautical miles' },\n\n  // Mass (base: gram)\n  g: { category: 'mass', factor: 1, label: 'grams' },\n  kg: { category: 'mass', factor: 1000, label: 'kilograms' },\n  mg: { category: 'mass', factor: 0.001, label: 'milligrams' },\n  t: { category: 'mass', factor: 1_000_000, label: 'metric tons' },\n  lb: { category: 'mass', factor: 453.59237, label: 'pounds' },\n  oz: { category: 'mass', factor: 28.349523125, label: 'ounces' },\n  st: { category: 'mass', factor: 6350.29318, label: 'stone' },\n\n  // Volume (base: litre)\n  L: { category: 'volume', factor: 1, label: 'litres' },\n  mL: { category: 'volume', factor: 0.001, label: 'millilitres' },\n  m3: { category: 'volume', factor: 1000, label: 'cubic metres' },\n  cm3: { category: 'volume', factor: 0.001, label: 'cubic centimetres' },\n  gal: { category: 'volume', factor: 3.785411784, label: 'US gallons' },\n  qt: { category: 'volume', factor: 0.946352946, label: 'US quarts' },\n  pt: { category: 'volume', factor: 0.473176473, label: 'US pints' },\n  cup: { category: 'volume', factor: 0.2365882365, label: 'US cups' },\n  floz: { category: 'volume', factor: 0.029573529562, label: 'US fluid ounces' },\n  tbsp: { category: 'volume', factor: 0.014786764781, label: 'tablespoons' },\n  tsp: { category: 'volume', factor: 0.0049289215938, label: 'teaspoons' },\n\n  // Speed (base: m/s)\n  m_s: { category: 'speed', factor: 1, label: 'm/s' },\n  km_h: { category: 'speed', factor: 1 / 3.6, label: 'km/h' },\n  mph: { category: 'speed', factor: 0.44704, label: 'mph' },\n  kn: { category: 'speed', factor: 0.514444, label: 'knots' },\n  ft_s: { category: 'speed', factor: 0.3048, label: 'ft/s' },\n\n  // Area (base: m²)\n  m2: { category: 'area', factor: 1, label: 'm²' },\n  km2: { category: 'area', factor: 1_000_000, label: 'km²' },\n  cm2: { category: 'area', factor: 0.0001, label: 'cm²' },\n  mm2: { category: 'area', factor: 0.000001, label: 'mm²' },\n  ft2: { category: 'area', factor: 0.09290304, label: 'sq ft' },\n  in2: { category: 'area', factor: 0.00064516, label: 'sq in' },\n  yd2: { category: 'area', factor: 0.83612736, label: 'sq yd' },\n  acre: { category: 'area', factor: 4046.8564224, label: 'acres' },\n  ha: { category: 'area', factor: 10_000, label: 'hectares' },\n\n  // Data storage (base: bit)\n  bit: { category: 'data', factor: 1, label: 'bits' },\n  B: { category: 'data', factor: 8, label: 'bytes' },\n  KB: { category: 'data', factor: 8_000, label: 'kilobytes' },\n  MB: { category: 'data', factor: 8_000_000, label: 'megabytes' },\n  GB: { category: 'data', factor: 8_000_000_000, label: 'gigabytes' },\n  TB: { category: 'data', factor: 8_000_000_000_000, label: 'terabytes' },\n  KiB: { category: 'data', factor: 8 * 1024, label: 'kibibytes' },\n  MiB: { category: 'data', factor: 8 * 1024 ** 2, label: 'mebibytes' },\n  GiB: { category: 'data', factor: 8 * 1024 ** 3, label: 'gibibytes' },\n  TiB: { category: 'data', factor: 8 * 1024 ** 4, label: 'tebibytes' },\n\n  // Time (base: second)\n  ms: { category: 'time', factor: 0.001, label: 'milliseconds' },\n  s: { category: 'time', factor: 1, label: 'seconds' },\n  min: { category: 'time', factor: 60, label: 'minutes' },\n  h: { category: 'time', factor: 3600, label: 'hours' },\n  d: { category: 'time', factor: 86400, label: 'days' },\n  wk: { category: 'time', factor: 604800, label: 'weeks' },\n\n  // Energy (base: joule)\n  J: { category: 'energy', factor: 1, label: 'joules' },\n  kJ: { category: 'energy', factor: 1000, label: 'kilojoules' },\n  cal: { category: 'energy', factor: 4.184, label: 'calories' },\n  kcal: { category: 'energy', factor: 4184, label: 'kilocalories' },\n  Wh: { category: 'energy', factor: 3600, label: 'watt-hours' },\n  kWh: { category: 'energy', factor: 3_600_000, label: 'kilowatt-hours' },\n  BTU: { category: 'energy', factor: 1055.05585, label: 'BTU' },\n\n  // Pressure (base: pascal)\n  Pa: { category: 'pressure', factor: 1, label: 'pascals' },\n  kPa: { category: 'pressure', factor: 1000, label: 'kilopascals' },\n  MPa: { category: 'pressure', factor: 1_000_000, label: 'megapascals' },\n  bar: { category: 'pressure', factor: 100_000, label: 'bar' },\n  psi: { category: 'pressure', factor: 6894.757, label: 'psi' },\n  atm: { category: 'pressure', factor: 101325, label: 'atm' },\n  mmHg: { category: 'pressure', factor: 133.322, label: 'mmHg' },\n\n  // Angle (base: radian)\n  rad: { category: 'angle', factor: 1, label: 'radians' },\n  deg: { category: 'angle', factor: Math.PI / 180, label: 'degrees' },\n  grad: { category: 'angle', factor: Math.PI / 200, label: 'gradians' },\n}\n\nconst TEMP_UNITS = new Set(['C', 'F', 'K'])\ntype TempUnit = 'C' | 'F' | 'K'\nconst TEMP_LABELS: Record<TempUnit, string> = { C: '°C', F: '°F', K: 'K' }\n\nfunction toKelvin(value: number, unit: TempUnit): number {\n  if (unit === 'C') return value + 273.15\n  if (unit === 'F') return (value - 32) * (5 / 9) + 273.15\n  return value\n}\n\nfunction fromKelvin(kelvin: number, unit: TempUnit): number {\n  if (unit === 'C') return kelvin - 273.15\n  if (unit === 'F') return (kelvin - 273.15) * (9 / 5) + 32\n  return kelvin\n}\n\nconst ALL_UNIT_KEYS = [...Object.keys(UNITS), 'C', 'F', 'K'].join(', ')\n\n/**\n * Convert a numeric value between units of the same physical category.\n *\n * @remarks\n * Supported categories: length, mass, volume, temperature, speed, area, data, time, energy,\n * pressure, angle. Uses static conversion tables — no external data required. Temperature is\n * handled specially via a Kelvin intermediate to preserve precision across `C`/`F`/`K`.\n */\nexport const convertUnitTool = new Tool({\n  name: 'convert_unit',\n  description:\n    'Convert a numeric value between units of the same category (length, mass, volume, temperature, speed, area, data, time, energy, pressure, angle). Uses static lookup tables — no external data required.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('Numeric value to convert'),\n    from: validator\n      .string()\n      .required()\n      .description(`Source unit key. Supported keys: ${ALL_UNIT_KEYS}`),\n    to: validator\n      .string()\n      .required()\n      .description('Target unit key (must be in the same category as source)'),\n    precision: validator\n      .number()\n      .default(DEFAULT_PRECISION)\n      .description(`Significant digits in the result (default: ${DEFAULT_PRECISION}).`),\n  }),\n  handler: async (args) => {\n    const { value, from, to, precision } = args as {\n      value: number\n      from: string\n      to: string\n      precision: number\n    }\n\n    if (TEMP_UNITS.has(from) || TEMP_UNITS.has(to)) {\n      if (!TEMP_UNITS.has(from))\n        return `Error: \"${from}\" is not a temperature unit. Use C, F, or K.`\n      if (!TEMP_UNITS.has(to)) return `Error: \"${to}\" is not a temperature unit. Use C, F, or K.`\n      // Temperatures are small bounded values (schema rejects |value| > 2^53), so float64 math\n      // is exact enough; only the display precision changes.\n      const kelvin = toKelvin(value, from as TempUnit)\n      // Reject physically impossible temperatures below absolute zero (0 K) rather than silently\n      // returning a nonsensical value like \"-1 K = -274.15 °C\". A tiny epsilon absorbs float noise.\n      if (kelvin < -1e-9) {\n        return `Error: ${value}${TEMP_LABELS[from as TempUnit]} is below absolute zero (0 K); not a physical temperature.`\n      }\n      const result = fromKelvin(kelvin, to as TempUnit)\n      const rounded = formatBig(result, precision)\n      return `${value}${TEMP_LABELS[from as TempUnit]} = ${rounded}${TEMP_LABELS[to as TempUnit]}`\n    }\n\n    const fromDef = UNITS[from]\n    const toDef = UNITS[to]\n    if (!fromDef) return `Error: Unknown unit \"${from}\". Supported: ${ALL_UNIT_KEYS}`\n    if (!toDef) return `Error: Unknown unit \"${to}\". Supported: ${ALL_UNIT_KEYS}`\n    if (fromDef.category !== toDef.category) {\n      return `Error: Cannot convert \"${from}\" (${fromDef.category}) to \"${to}\" (${toDef.category}) — different categories.`\n    }\n\n    // `value * fromFactor / toFactor` in BigNumber so huge ratios (e.g. TB→bit) don't overflow to\n    // Infinity, tiny ratios (e.g. in→km) don't underflow to 0, and safe integers keep full digits.\n    const result = bigScale(value, fromDef.factor, toDef.factor)\n    const rounded = formatBig(result, precision)\n    return `${value} ${fromDef.label} = ${rounded} ${toDef.label}`\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/unit_conversion.mjs

@@ -1,5 +1,6 @@
-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 { bigScale, formatBig } from "../../lib/helpers/bignum.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/unit_conversion/index.ts
 /**
@@ -423,15 +424,17 @@ var convertUnitTool = new Tool({
 	inputSchema: validator.object({
 		value: validator.number().required().description("Numeric value to convert"),
 		from: validator.string().required().description(`Source unit key. Supported keys: ${ALL_UNIT_KEYS}`),
-		to: validator.string().required().description("Target unit key (must be in the same category as source)")
+		to: validator.string().required().description("Target unit key (must be in the same category as source)"),
+		precision: validator.number().default(8).description(`Significant digits in the result (default: 8).`)
 	}),
 	handler: async (args) => {
-		const { value, from, to } = args;
+		const { value, from, to, precision } = args;
 		if (TEMP_UNITS.has(from) || TEMP_UNITS.has(to)) {
 			if (!TEMP_UNITS.has(from)) return `Error: "${from}" is not a temperature unit. Use C, F, or K.`;
 			if (!TEMP_UNITS.has(to)) return `Error: "${to}" is not a temperature unit. Use C, F, or K.`;
-			const result = fromKelvin(toKelvin(value, from), to);
-			const rounded = Number.parseFloat(result.toPrecision(10));
+			const kelvin = toKelvin(value, from);
+			if (kelvin < -1e-9) return `Error: ${value}${TEMP_LABELS[from]} is below absolute zero (0 K); not a physical temperature.`;
+			const rounded = formatBig(fromKelvin(kelvin, to), precision);
 			return `${value}${TEMP_LABELS[from]} = ${rounded}${TEMP_LABELS[to]}`;
 		}
 		const fromDef = UNITS[from];
@@ -439,8 +442,7 @@ var convertUnitTool = new Tool({
 		if (!fromDef) return `Error: Unknown unit "${from}". Supported: ${ALL_UNIT_KEYS}`;
 		if (!toDef) return `Error: Unknown unit "${to}". Supported: ${ALL_UNIT_KEYS}`;
 		if (fromDef.category !== toDef.category) return `Error: Cannot convert "${from}" (${fromDef.category}) to "${to}" (${toDef.category}) — different categories.`;
-		const result = value * fromDef.factor / toDef.factor;
-		const rounded = Number.parseFloat(result.toPrecision(10));
+		const rounded = formatBig(bigScale(value, fromDef.factor, toDef.factor), precision);
 		return `${value} ${fromDef.label} = ${rounded} ${toDef.label}`;
 	}
 });

package/batteries/tools/unit_conversion.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"unit_conversion.mjs","names":[],"sources":["../../../src/batteries/tools/unit_conversion/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for converting values across common measurement units.\n *\n * @module @nhtio/adk/batteries/tools/unit_conversion\n *\n * @remarks\n * Pre-constructed bundled tools for the `unit_conversion` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\n\ntype UnitDef = { category: string; factor: number; label: string }\n\nconst UNITS: Record<string, UnitDef> = {\n  // Length (base: metre)\n  m: { category: 'length', factor: 1, label: 'metres' },\n  km: { category: 'length', factor: 1000, label: 'kilometres' },\n  cm: { category: 'length', factor: 0.01, label: 'centimetres' },\n  mm: { category: 'length', factor: 0.001, label: 'millimetres' },\n  mi: { category: 'length', factor: 1609.344, label: 'miles' },\n  ft: { category: 'length', factor: 0.3048, label: 'feet' },\n  in: { category: 'length', factor: 0.0254, label: 'inches' },\n  yd: { category: 'length', factor: 0.9144, label: 'yards' },\n  nmi: { category: 'length', factor: 1852, label: 'nautical miles' },\n\n  // Mass (base: gram)\n  g: { category: 'mass', factor: 1, label: 'grams' },\n  kg: { category: 'mass', factor: 1000, label: 'kilograms' },\n  mg: { category: 'mass', factor: 0.001, label: 'milligrams' },\n  t: { category: 'mass', factor: 1_000_000, label: 'metric tons' },\n  lb: { category: 'mass', factor: 453.59237, label: 'pounds' },\n  oz: { category: 'mass', factor: 28.349523125, label: 'ounces' },\n  st: { category: 'mass', factor: 6350.29318, label: 'stone' },\n\n  // Volume (base: litre)\n  L: { category: 'volume', factor: 1, label: 'litres' },\n  mL: { category: 'volume', factor: 0.001, label: 'millilitres' },\n  m3: { category: 'volume', factor: 1000, label: 'cubic metres' },\n  cm3: { category: 'volume', factor: 0.001, label: 'cubic centimetres' },\n  gal: { category: 'volume', factor: 3.785411784, label: 'US gallons' },\n  qt: { category: 'volume', factor: 0.946352946, label: 'US quarts' },\n  pt: { category: 'volume', factor: 0.473176473, label: 'US pints' },\n  cup: { category: 'volume', factor: 0.2365882365, label: 'US cups' },\n  floz: { category: 'volume', factor: 0.029573529562, label: 'US fluid ounces' },\n  tbsp: { category: 'volume', factor: 0.014786764781, label: 'tablespoons' },\n  tsp: { category: 'volume', factor: 0.0049289215938, label: 'teaspoons' },\n\n  // Speed (base: m/s)\n  m_s: { category: 'speed', factor: 1, label: 'm/s' },\n  km_h: { category: 'speed', factor: 1 / 3.6, label: 'km/h' },\n  mph: { category: 'speed', factor: 0.44704, label: 'mph' },\n  kn: { category: 'speed', factor: 0.514444, label: 'knots' },\n  ft_s: { category: 'speed', factor: 0.3048, label: 'ft/s' },\n\n  // Area (base: m²)\n  m2: { category: 'area', factor: 1, label: 'm²' },\n  km2: { category: 'area', factor: 1_000_000, label: 'km²' },\n  cm2: { category: 'area', factor: 0.0001, label: 'cm²' },\n  mm2: { category: 'area', factor: 0.000001, label: 'mm²' },\n  ft2: { category: 'area', factor: 0.09290304, label: 'sq ft' },\n  in2: { category: 'area', factor: 0.00064516, label: 'sq in' },\n  yd2: { category: 'area', factor: 0.83612736, label: 'sq yd' },\n  acre: { category: 'area', factor: 4046.8564224, label: 'acres' },\n  ha: { category: 'area', factor: 10_000, label: 'hectares' },\n\n  // Data storage (base: bit)\n  bit: { category: 'data', factor: 1, label: 'bits' },\n  B: { category: 'data', factor: 8, label: 'bytes' },\n  KB: { category: 'data', factor: 8_000, label: 'kilobytes' },\n  MB: { category: 'data', factor: 8_000_000, label: 'megabytes' },\n  GB: { category: 'data', factor: 8_000_000_000, label: 'gigabytes' },\n  TB: { category: 'data', factor: 8_000_000_000_000, label: 'terabytes' },\n  KiB: { category: 'data', factor: 8 * 1024, label: 'kibibytes' },\n  MiB: { category: 'data', factor: 8 * 1024 ** 2, label: 'mebibytes' },\n  GiB: { category: 'data', factor: 8 * 1024 ** 3, label: 'gibibytes' },\n  TiB: { category: 'data', factor: 8 * 1024 ** 4, label: 'tebibytes' },\n\n  // Time (base: second)\n  ms: { category: 'time', factor: 0.001, label: 'milliseconds' },\n  s: { category: 'time', factor: 1, label: 'seconds' },\n  min: { category: 'time', factor: 60, label: 'minutes' },\n  h: { category: 'time', factor: 3600, label: 'hours' },\n  d: { category: 'time', factor: 86400, label: 'days' },\n  wk: { category: 'time', factor: 604800, label: 'weeks' },\n\n  // Energy (base: joule)\n  J: { category: 'energy', factor: 1, label: 'joules' },\n  kJ: { category: 'energy', factor: 1000, label: 'kilojoules' },\n  cal: { category: 'energy', factor: 4.184, label: 'calories' },\n  kcal: { category: 'energy', factor: 4184, label: 'kilocalories' },\n  Wh: { category: 'energy', factor: 3600, label: 'watt-hours' },\n  kWh: { category: 'energy', factor: 3_600_000, label: 'kilowatt-hours' },\n  BTU: { category: 'energy', factor: 1055.05585, label: 'BTU' },\n\n  // Pressure (base: pascal)\n  Pa: { category: 'pressure', factor: 1, label: 'pascals' },\n  kPa: { category: 'pressure', factor: 1000, label: 'kilopascals' },\n  MPa: { category: 'pressure', factor: 1_000_000, label: 'megapascals' },\n  bar: { category: 'pressure', factor: 100_000, label: 'bar' },\n  psi: { category: 'pressure', factor: 6894.757, label: 'psi' },\n  atm: { category: 'pressure', factor: 101325, label: 'atm' },\n  mmHg: { category: 'pressure', factor: 133.322, label: 'mmHg' },\n\n  // Angle (base: radian)\n  rad: { category: 'angle', factor: 1, label: 'radians' },\n  deg: { category: 'angle', factor: Math.PI / 180, label: 'degrees' },\n  grad: { category: 'angle', factor: Math.PI / 200, label: 'gradians' },\n}\n\nconst TEMP_UNITS = new Set(['C', 'F', 'K'])\ntype TempUnit = 'C' | 'F' | 'K'\nconst TEMP_LABELS: Record<TempUnit, string> = { C: '°C', F: '°F', K: 'K' }\n\nfunction toKelvin(value: number, unit: TempUnit): number {\n  if (unit === 'C') return value + 273.15\n  if (unit === 'F') return (value - 32) * (5 / 9) + 273.15\n  return value\n}\n\nfunction fromKelvin(kelvin: number, unit: TempUnit): number {\n  if (unit === 'C') return kelvin - 273.15\n  if (unit === 'F') return (kelvin - 273.15) * (9 / 5) + 32\n  return kelvin\n}\n\nconst ALL_UNIT_KEYS = [...Object.keys(UNITS), 'C', 'F', 'K'].join(', ')\n\n/**\n * Convert a numeric value between units of the same physical category.\n *\n * @remarks\n * Supported categories: length, mass, volume, temperature, speed, area, data, time, energy,\n * pressure, angle. Uses static conversion tables — no external data required. Temperature is\n * handled specially via a Kelvin intermediate to preserve precision across `C`/`F`/`K`.\n */\nexport const convertUnitTool = new Tool({\n  name: 'convert_unit',\n  description:\n    'Convert a numeric value between units of the same category (length, mass, volume, temperature, speed, area, data, time, energy, pressure, angle). Uses static lookup tables — no external data required.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('Numeric value to convert'),\n    from: validator\n      .string()\n      .required()\n      .description(`Source unit key. Supported keys: ${ALL_UNIT_KEYS}`),\n    to: validator\n      .string()\n      .required()\n      .description('Target unit key (must be in the same category as source)'),\n  }),\n  handler: async (args) => {\n    const { value, from, to } = args as { value: number; from: string; to: string }\n\n    if (TEMP_UNITS.has(from) || TEMP_UNITS.has(to)) {\n      if (!TEMP_UNITS.has(from))\n        return `Error: \"${from}\" is not a temperature unit. Use C, F, or K.`\n      if (!TEMP_UNITS.has(to)) return `Error: \"${to}\" is not a temperature unit. Use C, F, or K.`\n      const result = fromKelvin(toKelvin(value, from as TempUnit), to as TempUnit)\n      const rounded = Number.parseFloat(result.toPrecision(10))\n      return `${value}${TEMP_LABELS[from as TempUnit]} = ${rounded}${TEMP_LABELS[to as TempUnit]}`\n    }\n\n    const fromDef = UNITS[from]\n    const toDef = UNITS[to]\n    if (!fromDef) return `Error: Unknown unit \"${from}\". Supported: ${ALL_UNIT_KEYS}`\n    if (!toDef) return `Error: Unknown unit \"${to}\". Supported: ${ALL_UNIT_KEYS}`\n    if (fromDef.category !== toDef.category) {\n      return `Error: Cannot convert \"${from}\" (${fromDef.category}) to \"${to}\" (${toDef.category}) — different categories.`\n    }\n\n    const inBase = value * fromDef.factor\n    const result = inBase / toDef.factor\n    const rounded = Number.parseFloat(result.toPrecision(10))\n    return `${value} ${fromDef.label} = ${rounded} ${toDef.label}`\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"unit_conversion.mjs","names":[],"sources":["../../../src/batteries/tools/unit_conversion/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for converting values across common measurement units.\n *\n * @module @nhtio/adk/batteries/tools/unit_conversion\n *\n * @remarks\n * Pre-constructed bundled tools for the `unit_conversion` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\nimport { bigScale, formatBig, DEFAULT_PRECISION } from '@nhtio/adk/lib/helpers/bignum'\n\ntype UnitDef = { category: string; factor: number; label: string }\n\nconst UNITS: Record<string, UnitDef> = {\n  // Length (base: metre)\n  m: { category: 'length', factor: 1, label: 'metres' },\n  km: { category: 'length', factor: 1000, label: 'kilometres' },\n  cm: { category: 'length', factor: 0.01, label: 'centimetres' },\n  mm: { category: 'length', factor: 0.001, label: 'millimetres' },\n  mi: { category: 'length', factor: 1609.344, label: 'miles' },\n  ft: { category: 'length', factor: 0.3048, label: 'feet' },\n  in: { category: 'length', factor: 0.0254, label: 'inches' },\n  yd: { category: 'length', factor: 0.9144, label: 'yards' },\n  nmi: { category: 'length', factor: 1852, label: 'nautical miles' },\n\n  // Mass (base: gram)\n  g: { category: 'mass', factor: 1, label: 'grams' },\n  kg: { category: 'mass', factor: 1000, label: 'kilograms' },\n  mg: { category: 'mass', factor: 0.001, label: 'milligrams' },\n  t: { category: 'mass', factor: 1_000_000, label: 'metric tons' },\n  lb: { category: 'mass', factor: 453.59237, label: 'pounds' },\n  oz: { category: 'mass', factor: 28.349523125, label: 'ounces' },\n  st: { category: 'mass', factor: 6350.29318, label: 'stone' },\n\n  // Volume (base: litre)\n  L: { category: 'volume', factor: 1, label: 'litres' },\n  mL: { category: 'volume', factor: 0.001, label: 'millilitres' },\n  m3: { category: 'volume', factor: 1000, label: 'cubic metres' },\n  cm3: { category: 'volume', factor: 0.001, label: 'cubic centimetres' },\n  gal: { category: 'volume', factor: 3.785411784, label: 'US gallons' },\n  qt: { category: 'volume', factor: 0.946352946, label: 'US quarts' },\n  pt: { category: 'volume', factor: 0.473176473, label: 'US pints' },\n  cup: { category: 'volume', factor: 0.2365882365, label: 'US cups' },\n  floz: { category: 'volume', factor: 0.029573529562, label: 'US fluid ounces' },\n  tbsp: { category: 'volume', factor: 0.014786764781, label: 'tablespoons' },\n  tsp: { category: 'volume', factor: 0.0049289215938, label: 'teaspoons' },\n\n  // Speed (base: m/s)\n  m_s: { category: 'speed', factor: 1, label: 'm/s' },\n  km_h: { category: 'speed', factor: 1 / 3.6, label: 'km/h' },\n  mph: { category: 'speed', factor: 0.44704, label: 'mph' },\n  kn: { category: 'speed', factor: 0.514444, label: 'knots' },\n  ft_s: { category: 'speed', factor: 0.3048, label: 'ft/s' },\n\n  // Area (base: m²)\n  m2: { category: 'area', factor: 1, label: 'm²' },\n  km2: { category: 'area', factor: 1_000_000, label: 'km²' },\n  cm2: { category: 'area', factor: 0.0001, label: 'cm²' },\n  mm2: { category: 'area', factor: 0.000001, label: 'mm²' },\n  ft2: { category: 'area', factor: 0.09290304, label: 'sq ft' },\n  in2: { category: 'area', factor: 0.00064516, label: 'sq in' },\n  yd2: { category: 'area', factor: 0.83612736, label: 'sq yd' },\n  acre: { category: 'area', factor: 4046.8564224, label: 'acres' },\n  ha: { category: 'area', factor: 10_000, label: 'hectares' },\n\n  // Data storage (base: bit)\n  bit: { category: 'data', factor: 1, label: 'bits' },\n  B: { category: 'data', factor: 8, label: 'bytes' },\n  KB: { category: 'data', factor: 8_000, label: 'kilobytes' },\n  MB: { category: 'data', factor: 8_000_000, label: 'megabytes' },\n  GB: { category: 'data', factor: 8_000_000_000, label: 'gigabytes' },\n  TB: { category: 'data', factor: 8_000_000_000_000, label: 'terabytes' },\n  KiB: { category: 'data', factor: 8 * 1024, label: 'kibibytes' },\n  MiB: { category: 'data', factor: 8 * 1024 ** 2, label: 'mebibytes' },\n  GiB: { category: 'data', factor: 8 * 1024 ** 3, label: 'gibibytes' },\n  TiB: { category: 'data', factor: 8 * 1024 ** 4, label: 'tebibytes' },\n\n  // Time (base: second)\n  ms: { category: 'time', factor: 0.001, label: 'milliseconds' },\n  s: { category: 'time', factor: 1, label: 'seconds' },\n  min: { category: 'time', factor: 60, label: 'minutes' },\n  h: { category: 'time', factor: 3600, label: 'hours' },\n  d: { category: 'time', factor: 86400, label: 'days' },\n  wk: { category: 'time', factor: 604800, label: 'weeks' },\n\n  // Energy (base: joule)\n  J: { category: 'energy', factor: 1, label: 'joules' },\n  kJ: { category: 'energy', factor: 1000, label: 'kilojoules' },\n  cal: { category: 'energy', factor: 4.184, label: 'calories' },\n  kcal: { category: 'energy', factor: 4184, label: 'kilocalories' },\n  Wh: { category: 'energy', factor: 3600, label: 'watt-hours' },\n  kWh: { category: 'energy', factor: 3_600_000, label: 'kilowatt-hours' },\n  BTU: { category: 'energy', factor: 1055.05585, label: 'BTU' },\n\n  // Pressure (base: pascal)\n  Pa: { category: 'pressure', factor: 1, label: 'pascals' },\n  kPa: { category: 'pressure', factor: 1000, label: 'kilopascals' },\n  MPa: { category: 'pressure', factor: 1_000_000, label: 'megapascals' },\n  bar: { category: 'pressure', factor: 100_000, label: 'bar' },\n  psi: { category: 'pressure', factor: 6894.757, label: 'psi' },\n  atm: { category: 'pressure', factor: 101325, label: 'atm' },\n  mmHg: { category: 'pressure', factor: 133.322, label: 'mmHg' },\n\n  // Angle (base: radian)\n  rad: { category: 'angle', factor: 1, label: 'radians' },\n  deg: { category: 'angle', factor: Math.PI / 180, label: 'degrees' },\n  grad: { category: 'angle', factor: Math.PI / 200, label: 'gradians' },\n}\n\nconst TEMP_UNITS = new Set(['C', 'F', 'K'])\ntype TempUnit = 'C' | 'F' | 'K'\nconst TEMP_LABELS: Record<TempUnit, string> = { C: '°C', F: '°F', K: 'K' }\n\nfunction toKelvin(value: number, unit: TempUnit): number {\n  if (unit === 'C') return value + 273.15\n  if (unit === 'F') return (value - 32) * (5 / 9) + 273.15\n  return value\n}\n\nfunction fromKelvin(kelvin: number, unit: TempUnit): number {\n  if (unit === 'C') return kelvin - 273.15\n  if (unit === 'F') return (kelvin - 273.15) * (9 / 5) + 32\n  return kelvin\n}\n\nconst ALL_UNIT_KEYS = [...Object.keys(UNITS), 'C', 'F', 'K'].join(', ')\n\n/**\n * Convert a numeric value between units of the same physical category.\n *\n * @remarks\n * Supported categories: length, mass, volume, temperature, speed, area, data, time, energy,\n * pressure, angle. Uses static conversion tables — no external data required. Temperature is\n * handled specially via a Kelvin intermediate to preserve precision across `C`/`F`/`K`.\n */\nexport const convertUnitTool = new Tool({\n  name: 'convert_unit',\n  description:\n    'Convert a numeric value between units of the same category (length, mass, volume, temperature, speed, area, data, time, energy, pressure, angle). Uses static lookup tables — no external data required.',\n  inputSchema: validator.object({\n    value: validator.number().required().description('Numeric value to convert'),\n    from: validator\n      .string()\n      .required()\n      .description(`Source unit key. Supported keys: ${ALL_UNIT_KEYS}`),\n    to: validator\n      .string()\n      .required()\n      .description('Target unit key (must be in the same category as source)'),\n    precision: validator\n      .number()\n      .default(DEFAULT_PRECISION)\n      .description(`Significant digits in the result (default: ${DEFAULT_PRECISION}).`),\n  }),\n  handler: async (args) => {\n    const { value, from, to, precision } = args as {\n      value: number\n      from: string\n      to: string\n      precision: number\n    }\n\n    if (TEMP_UNITS.has(from) || TEMP_UNITS.has(to)) {\n      if (!TEMP_UNITS.has(from))\n        return `Error: \"${from}\" is not a temperature unit. Use C, F, or K.`\n      if (!TEMP_UNITS.has(to)) return `Error: \"${to}\" is not a temperature unit. Use C, F, or K.`\n      // Temperatures are small bounded values (schema rejects |value| > 2^53), so float64 math\n      // is exact enough; only the display precision changes.\n      const kelvin = toKelvin(value, from as TempUnit)\n      // Reject physically impossible temperatures below absolute zero (0 K) rather than silently\n      // returning a nonsensical value like \"-1 K = -274.15 °C\". A tiny epsilon absorbs float noise.\n      if (kelvin < -1e-9) {\n        return `Error: ${value}${TEMP_LABELS[from as TempUnit]} is below absolute zero (0 K); not a physical temperature.`\n      }\n      const result = fromKelvin(kelvin, to as TempUnit)\n      const rounded = formatBig(result, precision)\n      return `${value}${TEMP_LABELS[from as TempUnit]} = ${rounded}${TEMP_LABELS[to as TempUnit]}`\n    }\n\n    const fromDef = UNITS[from]\n    const toDef = UNITS[to]\n    if (!fromDef) return `Error: Unknown unit \"${from}\". Supported: ${ALL_UNIT_KEYS}`\n    if (!toDef) return `Error: Unknown unit \"${to}\". Supported: ${ALL_UNIT_KEYS}`\n    if (fromDef.category !== toDef.category) {\n      return `Error: Cannot convert \"${from}\" (${fromDef.category}) to \"${to}\" (${toDef.category}) — different categories.`\n    }\n\n    // `value * fromFactor / toFactor` in BigNumber so huge ratios (e.g. TB→bit) don't overflow to\n    // Infinity, tiny ratios (e.g. in→km) don't underflow to 0, and safe integers keep full digits.\n    const result = bigScale(value, fromDef.factor, toDef.factor)\n    const rounded = formatBig(result, precision)\n    return `${value} ${fromDef.label} = ${rounded} ${toDef.label}`\n  },\n})\n"],"mappings":"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"}

package/batteries/tools.cjs

@@ -12,6 +12,7 @@ const require_batteries_tools_math = require("./tools/math.cjs");
 const require_batteries_tools_memory = require("./tools/memory.cjs");
 const require_batteries_tools_parsing = require("./tools/parsing.cjs");
 const require_batteries_tools_retrievables = require("./tools/retrievables.cjs");
+const require_searxng = require("../searxng-Bkrwhwhw.js");
 const require_batteries_tools_standing_instructions = require("./tools/standing_instructions.cjs");
 const require_batteries_tools_statistics = require("./tools/statistics.cjs");
 const require_batteries_tools_string_processing = require("./tools/string_processing.cjs");
@@ -20,6 +21,7 @@ const require_batteries_tools_text_analysis = require("./tools/text_analysis.cjs
 const require_batteries_tools_text_comparison = require("./tools/text_comparison.cjs");
 const require_batteries_tools_time = require("./tools/time.cjs");
 const require_batteries_tools_unit_conversion = require("./tools/unit_conversion.cjs");
+exports.E_INVALID_SEARXNG_CONFIG = require_searxng.E_INVALID_SEARXNG_CONFIG;
 exports.addStandingInstructionTool = require_batteries_tools_standing_instructions.addStandingInstructionTool;
 exports.calculateTool = require_batteries_tools_math.calculateTool;
 exports.colorAdjustTool = require_batteries_tools_color.colorAdjustTool;
@@ -29,6 +31,7 @@ exports.compareRecordsTool = require_batteries_tools_comparison.compareRecordsTo
 exports.compareValuesTool = require_batteries_tools_comparison.compareValuesTool;
 exports.convertTimeTool = require_batteries_tools_time.convertTimeTool;
 exports.convertUnitTool = require_batteries_tools_unit_conversion.convertUnitTool;
+exports.createSearxngSearchTool = require_searxng.createSearxngSearchTool;
 exports.dateAddTool = require_batteries_tools_datetime_math.dateAddTool;
 exports.dateBusinessDaysTool = require_batteries_tools_datetime_extended.dateBusinessDaysTool;
 exports.dateCalendarInfoTool = require_batteries_tools_datetime_extended.dateCalendarInfoTool;

package/batteries/tools.mjs

@@ -10,6 +10,7 @@ import { calculateTool, evaluateKatexTool } from "./tools/math.mjs";
 import { deleteMemoryTool, listMemoriesTool, memoryTools, storeMemoryTool, updateMemoryTool } from "./tools/memory.mjs";
 import { detectDelimiterTool, parseCsvTool, parseKvTool, parseYamlTool } from "./tools/parsing.mjs";
 import { deleteRetrievableTool, listRetrievablesTool, retrievableTools, storeRetrievableTool, updateRetrievableTool } from "./tools/retrievables.mjs";
+import { n as E_INVALID_SEARXNG_CONFIG, t as createSearxngSearchTool } from "../searxng-CyA-nEu5.mjs";
 import { addStandingInstructionTool, listStandingInstructionsTool, removeStandingInstructionTool, standingInstructionTools } from "./tools/standing_instructions.mjs";
 import { statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool } from "./tools/statistics.mjs";
 import { stringExtractTool, stringTransformTool } from "./tools/string_processing.mjs";
@@ -18,4 +19,4 @@ import { textAnalyzeTool, textLinesTool } from "./tools/text_analysis.mjs";
 import { stringSimilarityTool, textDiffTool } from "./tools/text_comparison.mjs";
 import { convertTimeTool, getCurrentTimeTool } from "./tools/time.mjs";
 import { convertUnitTool } from "./tools/unit_conversion.mjs";
-export { addStandingInstructionTool, calculateTool, colorAdjustTool, colorContrastTool, colorSchemeTool, compareRecordsTool, compareValuesTool, convertTimeTool, convertUnitTool, dateAddTool, dateBusinessDaysTool, dateCalendarInfoTool, dateDiffTool, dateNthWeekdayTool, dateParseTool, datePeriodTool, deleteMemoryTool, deleteRetrievableTool, detectDelimiterTool, durationFormatTool, encodeTextTool, evaluateKatexTool, formatListTool, formatNumberTool, formatTableTool, geoBboxContainsTool, geoDistanceTool, geoWithinRadiusTool, getCurrentTimeTool, jsonFormatTool, jsonTransformTool, listMemoriesTool, listRetrievablesTool, listStandingInstructionsTool, memoryTools, parseCsvTool, parseKvTool, parseYamlTool, removeStandingInstructionTool, retrievableTools, setOperationsTool, standingInstructionTools, statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool, storeMemoryTool, storeRetrievableTool, stringExtractTool, stringSimilarityTool, stringTransformTool, textAnalyzeTool, textDiffTool, textEscapeTool, textLinesTool, unicodeNormalizeTool, updateMemoryTool, updateRetrievableTool, validateFormatTool };
+export { E_INVALID_SEARXNG_CONFIG, addStandingInstructionTool, calculateTool, colorAdjustTool, colorContrastTool, colorSchemeTool, compareRecordsTool, compareValuesTool, convertTimeTool, convertUnitTool, createSearxngSearchTool, dateAddTool, dateBusinessDaysTool, dateCalendarInfoTool, dateDiffTool, dateNthWeekdayTool, dateParseTool, datePeriodTool, deleteMemoryTool, deleteRetrievableTool, detectDelimiterTool, durationFormatTool, encodeTextTool, evaluateKatexTool, formatListTool, formatNumberTool, formatTableTool, geoBboxContainsTool, geoDistanceTool, geoWithinRadiusTool, getCurrentTimeTool, jsonFormatTool, jsonTransformTool, listMemoriesTool, listRetrievablesTool, listStandingInstructionsTool, memoryTools, parseCsvTool, parseKvTool, parseYamlTool, removeStandingInstructionTool, retrievableTools, setOperationsTool, standingInstructionTools, statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool, storeMemoryTool, storeRetrievableTool, stringExtractTool, stringSimilarityTool, stringTransformTool, textAnalyzeTool, textDiffTool, textEscapeTool, textLinesTool, unicodeNormalizeTool, updateMemoryTool, updateRetrievableTool, validateFormatTool };

package/batteries/vector/arangodb/index.d.ts

@@ -13,6 +13,7 @@ import { BaseVectorStore } from "../contract";
 import type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from "../plan";
 import type { VectorMatch, VectorStoreCapabilities, BaseVectorStoreOptions } from "../types";
 export interface ArangoDBVectorStoreOptions extends BaseVectorStoreOptions {
+    /** Connection and authentication parameters for the backend. */
     connection: {
         url: string;
         username?: string;
@@ -24,6 +25,7 @@ export interface ArangoDBVectorStoreOptions extends BaseVectorStoreOptions {
 export declare class ArangoDBVectorStore extends BaseVectorStore {
     #private;
     readonly capabilities: VectorStoreCapabilities;
+    /** Static availability probe: whether this adapter's runtime driver can load in the current environment. */
     static isAvailable(): boolean;
     isAvailable(): boolean;
     connect(): Promise<void>;

package/batteries/vector/arangodb.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
+const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
 require("../../guards.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
 const require_batteries_vector_exceptions = require("./exceptions.cjs");
@@ -45,6 +45,7 @@ var ArangoDBVectorStore = class extends require_batteries_vector_contract.BaseVe
 	get #opts() {
 		return this.options;
 	}
+	/** Static availability probe: whether this adapter's runtime driver can load in the current environment. */
 	static isAvailable() {
 		return typeof process !== "undefined";
 	}

package/batteries/vector/arangodb.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"arangodb.cjs","names":["#opts","#db","#aql","#ensure","#dims","#indexed","#ensureVectorIndex","#parseMeta","#project"],"sources":["../../../src/batteries/vector/arangodb/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/arangodb\n *\n * ArangoDB adapter (experimental vector index, 3.12.4+). Each collection is an ArangoDB\n * document collection keyed by `_key`; a `vector` index on `vec` enables KNN via\n * `APPROX_NEAR_COSINE` / `APPROX_NEAR_L2`. Metadata is a JSON string attribute filtered with\n * the neutral filter tree's JS reference evaluator for exact cross-adapter parity.\n *\n * Driver: `arangojs` (pure JS). Requires the server started with\n * `--experimental-vector-index=true`. All values are passed as AQL bind parameters.\n */\n\nimport { evaluateFilter } from '../filters'\nimport { BaseVectorStore } from '../contract'\nimport { validateRecords } from '../validation'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport {\n  E_VECTOR_STORE_DRIVER_UNAVAILABLE,\n  E_VECTOR_STORE_CONNECTION_FAILED,\n  E_VECTOR_STORE_COLLECTION_FAILED,\n  E_VECTOR_STORE_UPSERT_FAILED,\n  E_VECTOR_STORE_SEARCH_FAILED,\n  E_VECTOR_STORE_DELETE_FAILED,\n  E_VECTOR_STORE_DIMENSION_MISMATCH,\n  E_VECTOR_STORE_UNSUPPORTED_OPERATION,\n} from '../exceptions'\nimport type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from '../plan'\nimport type {\n  VectorMatch,\n  VectorStoreCapabilities,\n  BaseVectorStoreOptions,\n  VectorMetadata,\n} from '../types'\n\nexport interface ArangoDBVectorStoreOptions extends BaseVectorStoreOptions {\n  connection: {\n    url: string\n    username?: string\n    password?: string\n    database?: string\n    nLists?: number\n  }\n}\n\nconst getArango = async () => {\n  try {\n    const mod = await import('arangojs')\n    return mod\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['arangojs'])\n  }\n}\n\nexport class ArangoDBVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: false,\n    rename: false,\n    rawSql: false,\n    builtInEncoding: false,\n    // Document writes are synchronous (visible on resolve). The option is a no-op.\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n\n  #db: any | null = null\n  #aql: any | null = null\n  #dims: Map<string, number> = new Map()\n  // ArangoDB's IVF vector index can't be created on an empty collection (\"not ready\") and\n  // needs nLists <= doc count. We therefore create the index lazily after the first upsert.\n  #indexed: Set<string> = new Set()\n\n  get #opts(): ArangoDBVectorStoreOptions {\n    return this.options as ArangoDBVectorStoreOptions\n  }\n\n  static isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n  isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  async connect(): Promise<void> {\n    if (this.#db) return\n    const arango = await getArango()\n    this.#aql = arango.aql\n    const c = this.#opts.connection\n    const dbName = c.database ?? 'vector'\n    try {\n      const auth = c.username ? { username: c.username, password: c.password ?? '' } : undefined\n      const sys = new arango.Database({ url: c.url, auth })\n      const exists = await sys.listDatabases().then((dbs: string[]) => dbs.includes(dbName))\n      if (!exists) {\n        await sys.createDatabase(dbName)\n      }\n      this.#db = new arango.Database({ url: c.url, databaseName: dbName, auth })\n    } catch (err) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)])\n    }\n  }\n\n  async close(): Promise<void> {\n    this.#db = null\n    this.#aql = null\n  }\n\n  async #ensure(): Promise<any> {\n    if (!this.#db) await this.connect()\n    return this.#db!\n  }\n\n  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    const db = await this.#ensure()\n    this.#dims.set(spec.collection, spec.vector.dimensions)\n    try {\n      const col = db.collection(spec.collection)\n      const exists = await col.exists()\n      if (exists && !ifNotExists) {\n        await col.drop()\n        this.#indexed.delete(spec.collection)\n      }\n      if (!(await col.exists())) {\n        await col.create()\n        this.#indexed.delete(spec.collection)\n      }\n      // The vector index is created lazily on first upsert (see #ensureVectorIndex): ArangoDB\n      // rejects creating it on an empty collection (\"vector index not ready\").\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['createCollection', String(err)])\n    }\n  }\n\n  // Create the IVF vector index once the collection has data (idempotent per collection).\n  async #ensureVectorIndex(collection: string): Promise<void> {\n    if (this.#indexed.has(collection)) return\n    const db = await this.#ensure()\n    const col = db.collection(collection)\n    const metric = this.#opts.metric ?? 'cosine'\n    const dim = this.#dims.get(collection) ?? this.#opts.dimensions\n    if (dim === undefined) return\n    try {\n      await col.ensureIndex({\n        type: 'vector',\n        fields: ['vec'],\n        params: {\n          metric: metric === 'euclidean' ? 'l2' : 'cosine',\n          dimension: dim,\n          nLists: this.#opts.connection.nLists ?? 1,\n        },\n      })\n      this.#indexed.add(collection)\n    } catch {\n      // If it still isn't ready (too few docs), leave it; executeSearch falls back to a\n      // brute-force AQL scan so correctness holds regardless of the index.\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    const db = await this.#ensure()\n    try {\n      const col = db.collection(collection)\n      if (await col.exists()) {\n        await col.drop()\n      } else if (!ifExists) {\n        throw new Error('collection not found: ' + collection)\n      }\n      this.#dims.delete(collection)\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', String(err)])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    const db = await this.#ensure()\n    try {\n      return await db.collection(collection).exists()\n    } catch {\n      return false\n    }\n  }\n\n  async renameCollection(_from: string, _to: string): Promise<void> {\n    throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(['renameCollection', 'arangodb'])\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    if (plan.records.length === 0) return\n    validateRecords(plan.records)\n    const db = await this.#ensure()\n    const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection)\n    try {\n      const col = db.collection(plan.collection)\n      for (const r of plan.records) {\n        let vector = r.vector\n        if (!vector && r.document) {\n          const [v] = await this.encode([r.document], 'document')\n          vector = v\n        }\n        if (!vector) {\n          throw new E_VECTOR_STORE_UPSERT_FAILED(['Record missing vector and document'])\n        }\n        if (expected !== undefined && vector.length !== expected) {\n          throw new E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length])\n        }\n        const doc = {\n          _key: r.id,\n          vec: vector,\n          document: r.document ?? '',\n          metadata: r.metadata ? JSON.stringify(r.metadata) : '{}',\n        }\n        await col.save(doc, { overwriteMode: 'replace' })\n      }\n      // Now that the collection has data, ensure the IVF vector index exists.\n      await this.#ensureVectorIndex(plan.collection)\n    } catch (err) {\n      if (\n        isInstanceOf(err, 'E_VECTOR_STORE_DIMENSION_MISMATCH', E_VECTOR_STORE_DIMENSION_MISMATCH) ||\n        isInstanceOf(err, 'E_VECTOR_STORE_UPSERT_FAILED', E_VECTOR_STORE_UPSERT_FAILED)\n      ) {\n        throw err\n      }\n      throw new E_VECTOR_STORE_UPSERT_FAILED([String(err)])\n    }\n  }\n\n  async executeSearch(plan: SearchPlan): Promise<VectorMatch[]> {\n    const db = await this.#ensure()\n    const aql = this.#aql\n    const metric = this.#opts.metric ?? 'cosine'\n    let queryVector: number[] | undefined\n    if (plan.near) {\n      if ('vector' in plan.near) {\n        queryVector = plan.near.vector\n      } else if ('serverText' in plan.near) {\n        const [v] = await this.encode([plan.near.serverText], 'query')\n        queryVector = v\n      } else if ('id' in plan.near) {\n        const col = db.collection(plan.collection)\n        try {\n          const doc = await col.document(plan.near.id)\n          queryVector = doc.vec as number[]\n        } catch {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id not found: ' + plan.near.id])\n        }\n      }\n    }\n\n    const offset = plan.offset ?? 0\n    try {\n      let rows: any[]\n      if (queryVector) {\n        // Use the exact AQL distance functions (COSINE_SIMILARITY / L2_DISTANCE) rather than the\n        // APPROX_NEAR_* index functions: they need no index, are always correct, and avoid\n        // ArangoDB's IVF \"not ready\" / nLists-vs-doc-count constraints. The IVF index is still\n        // created lazily on upsert for production-scale ANN; here correctness comes first.\n        const useL2 = metric === 'euclidean'\n        const fn = useL2 ? 'L2_DISTANCE' : 'COSINE_SIMILARITY'\n        const dir = useL2 ? 'ASC' : 'DESC'\n        const k = plan.filter ? 100000 : plan.topK + offset\n        const query =\n          `FOR d IN @@col ` +\n          `LET __score = ${fn}(d.vec, @qv) ` +\n          `SORT __score ${dir} LIMIT @k ` +\n          `RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata, score: __score }`\n        const cursor = await db.query(query, {\n          '@col': plan.collection,\n          'qv': queryVector,\n          k,\n        })\n        rows = await cursor.all()\n        const filtered = plan.filter\n          ? rows.filter((row) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          : rows\n        return filtered\n          .slice(offset, offset + plan.topK)\n          .map((row) => this.#project(row, plan, true))\n      } else {\n        const cursor = await db.query(\n          aql`FOR d IN ${db.collection(plan.collection)} RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata }`\n        )\n        rows = await cursor.all()\n        const filtered = plan.filter\n          ? rows.filter((row) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          : rows\n        return filtered\n          .slice(offset, offset + plan.topK)\n          .map((row) => this.#project(row, plan, false))\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n    }\n  }\n\n  #parseMeta(val: unknown): VectorMetadata {\n    if (typeof val === 'string') {\n      try {\n        return JSON.parse(val) as VectorMetadata\n      } catch {\n        return {}\n      }\n    }\n    if (val && typeof val === 'object') return val as VectorMetadata\n    return {}\n  }\n\n  #project(row: any, plan: SearchPlan, isKnn: boolean): VectorMatch {\n    const proj = plan.projection\n    const out: VectorMatch = {}\n    if (proj.id) out.id = row.id as string\n    if (proj.vector && Array.isArray(row.vec)) out.vector = (row.vec as number[]).map(Number)\n    if (proj.document) out.document = (row.document ?? undefined) as string | undefined\n    if (proj.metadata) out.metadata = this.#parseMeta(row.metadata)\n    if (isKnn && row.score !== undefined && row.score !== null) {\n      // APPROX_NEAR_COSINE returns cosine similarity in [0,1]; L2 returns a distance.\n      const m = this.#opts.metric ?? 'cosine'\n      out.score = m === 'euclidean' ? 1 / (1 + Number(row.score)) : Number(row.score)\n    }\n    return out\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    const db = await this.#ensure()\n    const aql = this.#aql\n    try {\n      const col = db.collection(plan.collection)\n      if (plan.ids && plan.ids.length > 0) {\n        await col.removeAll(plan.ids).catch(async () => {\n          for (const id of plan.ids!) await col.remove(id).catch(() => undefined)\n        })\n      } else if (plan.filter) {\n        const cursor = await db.query(\n          aql`FOR d IN ${col} RETURN { id: d._key, metadata: d.metadata }`\n        )\n        const rows = await cursor.all()\n        const targets = rows\n          .filter((row: any) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          .map((row: any) => row.id as string)\n        if (targets.length > 0) {\n          await col.removeAll(targets).catch(async () => {\n            for (const id of targets) await col.remove(id).catch(() => undefined)\n          })\n        }\n      } else {\n        await col.truncate()\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_DELETE_FAILED([String(err)])\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"arangodb.cjs","names":["#opts","#db","#aql","#ensure","#dims","#indexed","#ensureVectorIndex","#parseMeta","#project"],"sources":["../../../src/batteries/vector/arangodb/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/arangodb\n *\n * ArangoDB adapter (experimental vector index, 3.12.4+). Each collection is an ArangoDB\n * document collection keyed by `_key`; a `vector` index on `vec` enables KNN via\n * `APPROX_NEAR_COSINE` / `APPROX_NEAR_L2`. Metadata is a JSON string attribute filtered with\n * the neutral filter tree's JS reference evaluator for exact cross-adapter parity.\n *\n * Driver: `arangojs` (pure JS). Requires the server started with\n * `--experimental-vector-index=true`. All values are passed as AQL bind parameters.\n */\n\nimport { evaluateFilter } from '../filters'\nimport { BaseVectorStore } from '../contract'\nimport { validateRecords } from '../validation'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport {\n  E_VECTOR_STORE_DRIVER_UNAVAILABLE,\n  E_VECTOR_STORE_CONNECTION_FAILED,\n  E_VECTOR_STORE_COLLECTION_FAILED,\n  E_VECTOR_STORE_UPSERT_FAILED,\n  E_VECTOR_STORE_SEARCH_FAILED,\n  E_VECTOR_STORE_DELETE_FAILED,\n  E_VECTOR_STORE_DIMENSION_MISMATCH,\n  E_VECTOR_STORE_UNSUPPORTED_OPERATION,\n} from '../exceptions'\nimport type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from '../plan'\nimport type {\n  VectorMatch,\n  VectorStoreCapabilities,\n  BaseVectorStoreOptions,\n  VectorMetadata,\n} from '../types'\n\nexport interface ArangoDBVectorStoreOptions extends BaseVectorStoreOptions {\n  /** Connection and authentication parameters for the backend. */\n  connection: {\n    url: string\n    username?: string\n    password?: string\n    database?: string\n    nLists?: number\n  }\n}\n\nconst getArango = async () => {\n  try {\n    const mod = await import('arangojs')\n    return mod\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['arangojs'])\n  }\n}\n\nexport class ArangoDBVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: false,\n    rename: false,\n    rawSql: false,\n    builtInEncoding: false,\n    // Document writes are synchronous (visible on resolve). The option is a no-op.\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n\n  #db: any | null = null\n  #aql: any | null = null\n  #dims: Map<string, number> = new Map()\n  // ArangoDB's IVF vector index can't be created on an empty collection (\"not ready\") and\n  // needs nLists <= doc count. We therefore create the index lazily after the first upsert.\n  #indexed: Set<string> = new Set()\n\n  get #opts(): ArangoDBVectorStoreOptions {\n    return this.options as ArangoDBVectorStoreOptions\n  }\n\n  /** Static availability probe: whether this adapter's runtime driver can load in the current environment. */\n  static isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n  isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  async connect(): Promise<void> {\n    if (this.#db) return\n    const arango = await getArango()\n    this.#aql = arango.aql\n    const c = this.#opts.connection\n    const dbName = c.database ?? 'vector'\n    try {\n      const auth = c.username ? { username: c.username, password: c.password ?? '' } : undefined\n      const sys = new arango.Database({ url: c.url, auth })\n      const exists = await sys.listDatabases().then((dbs: string[]) => dbs.includes(dbName))\n      if (!exists) {\n        await sys.createDatabase(dbName)\n      }\n      this.#db = new arango.Database({ url: c.url, databaseName: dbName, auth })\n    } catch (err) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)])\n    }\n  }\n\n  async close(): Promise<void> {\n    this.#db = null\n    this.#aql = null\n  }\n\n  async #ensure(): Promise<any> {\n    if (!this.#db) await this.connect()\n    return this.#db!\n  }\n\n  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    const db = await this.#ensure()\n    this.#dims.set(spec.collection, spec.vector.dimensions)\n    try {\n      const col = db.collection(spec.collection)\n      const exists = await col.exists()\n      if (exists && !ifNotExists) {\n        await col.drop()\n        this.#indexed.delete(spec.collection)\n      }\n      if (!(await col.exists())) {\n        await col.create()\n        this.#indexed.delete(spec.collection)\n      }\n      // The vector index is created lazily on first upsert (see #ensureVectorIndex): ArangoDB\n      // rejects creating it on an empty collection (\"vector index not ready\").\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['createCollection', String(err)])\n    }\n  }\n\n  // Create the IVF vector index once the collection has data (idempotent per collection).\n  async #ensureVectorIndex(collection: string): Promise<void> {\n    if (this.#indexed.has(collection)) return\n    const db = await this.#ensure()\n    const col = db.collection(collection)\n    const metric = this.#opts.metric ?? 'cosine'\n    const dim = this.#dims.get(collection) ?? this.#opts.dimensions\n    if (dim === undefined) return\n    try {\n      await col.ensureIndex({\n        type: 'vector',\n        fields: ['vec'],\n        params: {\n          metric: metric === 'euclidean' ? 'l2' : 'cosine',\n          dimension: dim,\n          nLists: this.#opts.connection.nLists ?? 1,\n        },\n      })\n      this.#indexed.add(collection)\n    } catch {\n      // If it still isn't ready (too few docs), leave it; executeSearch falls back to a\n      // brute-force AQL scan so correctness holds regardless of the index.\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    const db = await this.#ensure()\n    try {\n      const col = db.collection(collection)\n      if (await col.exists()) {\n        await col.drop()\n      } else if (!ifExists) {\n        throw new Error('collection not found: ' + collection)\n      }\n      this.#dims.delete(collection)\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', String(err)])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    const db = await this.#ensure()\n    try {\n      return await db.collection(collection).exists()\n    } catch {\n      return false\n    }\n  }\n\n  async renameCollection(_from: string, _to: string): Promise<void> {\n    throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(['renameCollection', 'arangodb'])\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    if (plan.records.length === 0) return\n    validateRecords(plan.records)\n    const db = await this.#ensure()\n    const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection)\n    try {\n      const col = db.collection(plan.collection)\n      for (const r of plan.records) {\n        let vector = r.vector\n        if (!vector && r.document) {\n          const [v] = await this.encode([r.document], 'document')\n          vector = v\n        }\n        if (!vector) {\n          throw new E_VECTOR_STORE_UPSERT_FAILED(['Record missing vector and document'])\n        }\n        if (expected !== undefined && vector.length !== expected) {\n          throw new E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length])\n        }\n        const doc = {\n          _key: r.id,\n          vec: vector,\n          document: r.document ?? '',\n          metadata: r.metadata ? JSON.stringify(r.metadata) : '{}',\n        }\n        await col.save(doc, { overwriteMode: 'replace' })\n      }\n      // Now that the collection has data, ensure the IVF vector index exists.\n      await this.#ensureVectorIndex(plan.collection)\n    } catch (err) {\n      if (\n        isInstanceOf(err, 'E_VECTOR_STORE_DIMENSION_MISMATCH', E_VECTOR_STORE_DIMENSION_MISMATCH) ||\n        isInstanceOf(err, 'E_VECTOR_STORE_UPSERT_FAILED', E_VECTOR_STORE_UPSERT_FAILED)\n      ) {\n        throw err\n      }\n      throw new E_VECTOR_STORE_UPSERT_FAILED([String(err)])\n    }\n  }\n\n  async executeSearch(plan: SearchPlan): Promise<VectorMatch[]> {\n    const db = await this.#ensure()\n    const aql = this.#aql\n    const metric = this.#opts.metric ?? 'cosine'\n    let queryVector: number[] | undefined\n    if (plan.near) {\n      if ('vector' in plan.near) {\n        queryVector = plan.near.vector\n      } else if ('serverText' in plan.near) {\n        const [v] = await this.encode([plan.near.serverText], 'query')\n        queryVector = v\n      } else if ('id' in plan.near) {\n        const col = db.collection(plan.collection)\n        try {\n          const doc = await col.document(plan.near.id)\n          queryVector = doc.vec as number[]\n        } catch {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id not found: ' + plan.near.id])\n        }\n      }\n    }\n\n    const offset = plan.offset ?? 0\n    try {\n      let rows: any[]\n      if (queryVector) {\n        // Use the exact AQL distance functions (COSINE_SIMILARITY / L2_DISTANCE) rather than the\n        // APPROX_NEAR_* index functions: they need no index, are always correct, and avoid\n        // ArangoDB's IVF \"not ready\" / nLists-vs-doc-count constraints. The IVF index is still\n        // created lazily on upsert for production-scale ANN; here correctness comes first.\n        const useL2 = metric === 'euclidean'\n        const fn = useL2 ? 'L2_DISTANCE' : 'COSINE_SIMILARITY'\n        const dir = useL2 ? 'ASC' : 'DESC'\n        const k = plan.filter ? 100000 : plan.topK + offset\n        const query =\n          `FOR d IN @@col ` +\n          `LET __score = ${fn}(d.vec, @qv) ` +\n          `SORT __score ${dir} LIMIT @k ` +\n          `RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata, score: __score }`\n        const cursor = await db.query(query, {\n          '@col': plan.collection,\n          'qv': queryVector,\n          k,\n        })\n        rows = await cursor.all()\n        const filtered = plan.filter\n          ? rows.filter((row) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          : rows\n        return filtered\n          .slice(offset, offset + plan.topK)\n          .map((row) => this.#project(row, plan, true))\n      } else {\n        const cursor = await db.query(\n          aql`FOR d IN ${db.collection(plan.collection)} RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata }`\n        )\n        rows = await cursor.all()\n        const filtered = plan.filter\n          ? rows.filter((row) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          : rows\n        return filtered\n          .slice(offset, offset + plan.topK)\n          .map((row) => this.#project(row, plan, false))\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n    }\n  }\n\n  #parseMeta(val: unknown): VectorMetadata {\n    if (typeof val === 'string') {\n      try {\n        return JSON.parse(val) as VectorMetadata\n      } catch {\n        return {}\n      }\n    }\n    if (val && typeof val === 'object') return val as VectorMetadata\n    return {}\n  }\n\n  #project(row: any, plan: SearchPlan, isKnn: boolean): VectorMatch {\n    const proj = plan.projection\n    const out: VectorMatch = {}\n    if (proj.id) out.id = row.id as string\n    if (proj.vector && Array.isArray(row.vec)) out.vector = (row.vec as number[]).map(Number)\n    if (proj.document) out.document = (row.document ?? undefined) as string | undefined\n    if (proj.metadata) out.metadata = this.#parseMeta(row.metadata)\n    if (isKnn && row.score !== undefined && row.score !== null) {\n      // APPROX_NEAR_COSINE returns cosine similarity in [0,1]; L2 returns a distance.\n      const m = this.#opts.metric ?? 'cosine'\n      out.score = m === 'euclidean' ? 1 / (1 + Number(row.score)) : Number(row.score)\n    }\n    return out\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    const db = await this.#ensure()\n    const aql = this.#aql\n    try {\n      const col = db.collection(plan.collection)\n      if (plan.ids && plan.ids.length > 0) {\n        await col.removeAll(plan.ids).catch(async () => {\n          for (const id of plan.ids!) await col.remove(id).catch(() => undefined)\n        })\n      } else if (plan.filter) {\n        const cursor = await db.query(\n          aql`FOR d IN ${col} RETURN { id: d._key, metadata: d.metadata }`\n        )\n        const rows = await cursor.all()\n        const targets = rows\n          .filter((row: any) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          .map((row: any) => row.id as string)\n        if (targets.length > 0) {\n          await col.removeAll(targets).catch(async () => {\n            for (const id of targets) await col.remove(id).catch(() => undefined)\n          })\n        }\n      } else {\n        await col.truncate()\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_DELETE_FAILED([String(err)])\n    }\n  }\n}\n"],"mappings":"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"}

package/batteries/vector/arangodb.mjs

@@ -1,4 +1,4 @@
-import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
+import { s as isInstanceOf } from "../../tool_registry-791Vrjtf.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } from "./filters.mjs";
 import { E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
@@ -43,6 +43,7 @@ var ArangoDBVectorStore = class extends BaseVectorStore {
 	get #opts() {
 		return this.options;
 	}
+	/** Static availability probe: whether this adapter's runtime driver can load in the current environment. */
 	static isAvailable() {
 		return typeof process !== "undefined";
 	}