@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/tools/datetime_math.mjs

@@ -0,0 +1,171 @@
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import { validator } from "@nhtio/validation";
+import { DateTime, Duration, IANAZone } from "luxon";
+//#region src/batteries/tools/datetime_math/index.ts
+/**
+* Pre-constructed tools for ISO datetime arithmetic, differences, and timezone-aware formatting.
+*
+* @module @nhtio/adk/batteries/tools/datetime_math
+*
+* @remarks
+* Pre-constructed bundled tools for the `datetime_math` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+function resolveZone(timezone) {
+	if (!timezone) return { zone: "UTC" };
+	if (!IANAZone.isValidZone(timezone)) return {
+		zone: "",
+		error: `Invalid timezone "${timezone}".`
+	};
+	return { zone: timezone };
+}
+function parseDate(input, zone) {
+	if (input.toLowerCase() === "now") return DateTime.now().setZone(zone);
+	const dt = DateTime.fromISO(input, { zone });
+	if (!dt.isValid) return { error: `Invalid date "${input}". Use ISO 8601 format (e.g. "2025-06-15" or "2025-06-15T14:30:00") or "now".` };
+	return dt;
+}
+/**
+* Add or subtract a duration from a date/time.
+*
+* @remarks
+* All duration components (years/months/weeks/days/hours/minutes/seconds) are optional and
+* combined into a single Duration. Output formatting includes a time component when the input
+* itself has one or when any sub-day component is non-zero.
+*/
+var dateAddTool = new Tool({
+	name: "date_add",
+	description: "Add or subtract a duration from a date/time. Useful for \"what date is 90 days from now?\" or \"when was 6 months before X?\"",
+	inputSchema: validator.object({
+		date: validator.string().required().description("ISO 8601 date/datetime string or \"now\""),
+		direction: validator.string().valid("add", "subtract").required().description("\"add\" to move forward in time, \"subtract\" to move backward"),
+		years: validator.number().default(0).description("Years component (optional)"),
+		months: validator.number().default(0).description("Months component (optional)"),
+		weeks: validator.number().default(0).description("Weeks component (optional)"),
+		days: validator.number().default(0).description("Days component (optional)"),
+		hours: validator.number().default(0).description("Hours component (optional)"),
+		minutes: validator.number().default(0).description("Minutes component (optional)"),
+		seconds: validator.number().default(0).description("Seconds component (optional)"),
+		timezone: validator.string().optional().description("IANA timezone for interpreting the date (optional, defaults UTC)")
+	}),
+	handler: async (args) => {
+		const { date, direction, years, months, weeks, days, hours, minutes, seconds, timezone } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		const parsed = parseDate(date, zone);
+		if ("error" in parsed) return `Error: ${parsed.error}`;
+		const durObj = {
+			years,
+			months,
+			weeks,
+			days,
+			hours,
+			minutes,
+			seconds
+		};
+		const dur = Duration.fromObject(durObj);
+		const result = direction === "subtract" ? parsed.minus(dur) : parsed.plus(dur);
+		const inputHasTime = date.includes("T") || date.toLowerCase() === "now";
+		const durationHasTime = durObj.hours !== 0 || durObj.minutes !== 0 || durObj.seconds !== 0;
+		const formatted = inputHasTime || durationHasTime ? result.toFormat("cccc, LLLL d, yyyy 'at' h:mm:ss a ZZZZ") : result.toFormat("cccc, LLLL d, yyyy");
+		const durParts = Object.entries(durObj).filter(([, v]) => v !== 0).map(([k, v]) => `${v} ${k}`).join(", ");
+		return `${direction === "subtract" ? "Subtracting" : "Adding"} ${durParts || "0"} ${direction === "subtract" ? "from" : "to"} ${date}: ${formatted}`;
+	}
+});
+/**
+* Calculate the difference between two dates/times in a chosen unit.
+*
+* @remarks
+* Result is signed — positive when `to` is after `from`, negative otherwise — but rendered as
+* `|value| <unit> after/before` for readability. Uses luxon's `diff().as(unit)` which respects
+* calendar arithmetic for months/years.
+*/
+var dateDiffTool = new Tool({
+	name: "date_diff",
+	description: "Calculate the difference between two dates/times in a specified unit. Useful for \"how many days until X?\" or \"how long ago was Y?\"",
+	inputSchema: validator.object({
+		from: validator.string().required().description("Start date (ISO 8601 or \"now\")"),
+		to: validator.string().required().description("End date (ISO 8601 or \"now\")"),
+		unit: validator.string().valid("years", "months", "weeks", "days", "hours", "minutes", "seconds").required().description("Unit to express the difference in"),
+		timezone: validator.string().optional().description("IANA timezone for interpreting dates (optional, defaults UTC)")
+	}),
+	handler: async (args) => {
+		const { from, to, unit, timezone } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		const fromParsed = parseDate(from, zone);
+		if ("error" in fromParsed) return `Error: ${fromParsed.error}`;
+		const toParsed = parseDate(to, zone);
+		if ("error" in toParsed) return `Error: ${toParsed.error}`;
+		const value = toParsed.diff(fromParsed, unit).as(unit);
+		const rounded = Number.parseFloat(value.toFixed(4));
+		return `${to} is ${Math.abs(rounded)} ${unit} ${value >= 0 ? "after" : "before"} ${from}`;
+	}
+});
+/**
+* Convert total seconds into a human-readable duration string.
+*
+* @remarks
+* Examples: `3725` → `1 hour, 2 minutes and 5 seconds`. Negative inputs are prefixed with `-`.
+* Zero seconds returns the literal `0 seconds`.
+*/
+var durationFormatTool = new Tool({
+	name: "duration_format",
+	description: "Convert a total number of seconds into a human-readable duration breakdown (e.g. \"2 hours, 15 minutes and 30 seconds\").",
+	inputSchema: validator.object({ seconds: validator.number().required().description("Total number of seconds (may be negative)") }),
+	handler: async (args) => {
+		const { seconds: totalSeconds } = args;
+		const sign = totalSeconds < 0 ? "-" : "";
+		const absSeconds = Math.abs(totalSeconds);
+		const obj = Duration.fromObject({ seconds: absSeconds }).shiftTo("years", "months", "weeks", "days", "hours", "minutes", "seconds").toObject();
+		const units = [
+			[
+				"years",
+				"year",
+				"years"
+			],
+			[
+				"months",
+				"month",
+				"months"
+			],
+			[
+				"weeks",
+				"week",
+				"weeks"
+			],
+			[
+				"days",
+				"day",
+				"days"
+			],
+			[
+				"hours",
+				"hour",
+				"hours"
+			],
+			[
+				"minutes",
+				"minute",
+				"minutes"
+			],
+			[
+				"seconds",
+				"second",
+				"seconds"
+			]
+		];
+		const parts = [];
+		for (const [key, singular, plural] of units) {
+			const v = Math.floor(obj[key] ?? 0);
+			if (v > 0) parts.push(`${v} ${v === 1 ? singular : plural}`);
+		}
+		if (parts.length === 0) return "0 seconds";
+		return `${sign}${parts.length === 1 ? parts[0] : parts.slice(0, -1).join(", ") + " and " + parts[parts.length - 1]}`;
+	}
+});
+//#endregion
+export { dateAddTool, dateDiffTool, durationFormatTool };
+
+//# sourceMappingURL=datetime_math.mjs.map

package/batteries/tools/datetime_math.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime_math.mjs","names":[],"sources":["../../../src/batteries/tools/datetime_math/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for ISO datetime arithmetic, differences, and timezone-aware formatting.\n *\n * @module @nhtio/adk/batteries/tools/datetime_math\n *\n * @remarks\n * Pre-constructed bundled tools for the `datetime_math` 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 { DateTime, Duration, IANAZone } from 'luxon'\n\nfunction resolveZone(timezone: string | undefined): { zone: string; error?: string } {\n  if (!timezone) return { zone: 'UTC' }\n  if (!IANAZone.isValidZone(timezone)) return { zone: '', error: `Invalid timezone \"${timezone}\".` }\n  return { zone: timezone }\n}\n\nfunction parseDate(input: string, zone: string): DateTime | { error: string } {\n  if (input.toLowerCase() === 'now') return DateTime.now().setZone(zone)\n  const dt = DateTime.fromISO(input, { zone })\n  if (!dt.isValid)\n    return {\n      error: `Invalid date \"${input}\". Use ISO 8601 format (e.g. \"2025-06-15\" or \"2025-06-15T14:30:00\") or \"now\".`,\n    }\n  return dt\n}\n\n/**\n * Add or subtract a duration from a date/time.\n *\n * @remarks\n * All duration components (years/months/weeks/days/hours/minutes/seconds) are optional and\n * combined into a single Duration. Output formatting includes a time component when the input\n * itself has one or when any sub-day component is non-zero.\n */\nexport const dateAddTool = new Tool({\n  name: 'date_add',\n  description:\n    'Add or subtract a duration from a date/time. Useful for \"what date is 90 days from now?\" or \"when was 6 months before X?\"',\n  inputSchema: validator.object({\n    date: validator.string().required().description('ISO 8601 date/datetime string or \"now\"'),\n    direction: validator\n      .string()\n      .valid('add', 'subtract')\n      .required()\n      .description('\"add\" to move forward in time, \"subtract\" to move backward'),\n    years: validator.number().default(0).description('Years component (optional)'),\n    months: validator.number().default(0).description('Months component (optional)'),\n    weeks: validator.number().default(0).description('Weeks component (optional)'),\n    days: validator.number().default(0).description('Days component (optional)'),\n    hours: validator.number().default(0).description('Hours component (optional)'),\n    minutes: validator.number().default(0).description('Minutes component (optional)'),\n    seconds: validator.number().default(0).description('Seconds component (optional)'),\n    timezone: validator\n      .string()\n      .optional()\n      .description('IANA timezone for interpreting the date (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const { date, direction, years, months, weeks, days, hours, minutes, seconds, timezone } =\n      args as {\n        date: string\n        direction: 'add' | 'subtract'\n        years: number\n        months: number\n        weeks: number\n        days: number\n        hours: number\n        minutes: number\n        seconds: number\n        timezone?: string\n      }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    const parsed = parseDate(date, zone)\n    if ('error' in parsed) return `Error: ${parsed.error}`\n\n    const durObj = { years, months, weeks, days, hours, minutes, seconds }\n    const dur = Duration.fromObject(durObj)\n    const result = direction === 'subtract' ? parsed.minus(dur) : parsed.plus(dur)\n\n    const inputHasTime = date.includes('T') || date.toLowerCase() === 'now'\n    const durationHasTime = durObj.hours !== 0 || durObj.minutes !== 0 || durObj.seconds !== 0\n    const showTime = inputHasTime || durationHasTime\n\n    const formatted = showTime\n      ? result.toFormat(\"cccc, LLLL d, yyyy 'at' h:mm:ss a ZZZZ\")\n      : result.toFormat('cccc, LLLL d, yyyy')\n\n    const durParts = Object.entries(durObj)\n      .filter(([, v]) => v !== 0)\n      .map(([k, v]) => `${v} ${k}`)\n      .join(', ')\n\n    const verb = direction === 'subtract' ? 'Subtracting' : 'Adding'\n    const prep = direction === 'subtract' ? 'from' : 'to'\n    return `${verb} ${durParts || '0'} ${prep} ${date}: ${formatted}`\n  },\n})\n\n/**\n * Calculate the difference between two dates/times in a chosen unit.\n *\n * @remarks\n * Result is signed — positive when `to` is after `from`, negative otherwise — but rendered as\n * `|value| <unit> after/before` for readability. Uses luxon's `diff().as(unit)` which respects\n * calendar arithmetic for months/years.\n */\nexport const dateDiffTool = new Tool({\n  name: 'date_diff',\n  description:\n    'Calculate the difference between two dates/times in a specified unit. Useful for \"how many days until X?\" or \"how long ago was Y?\"',\n  inputSchema: validator.object({\n    from: validator.string().required().description('Start date (ISO 8601 or \"now\")'),\n    to: validator.string().required().description('End date (ISO 8601 or \"now\")'),\n    unit: validator\n      .string()\n      .valid('years', 'months', 'weeks', 'days', 'hours', 'minutes', 'seconds')\n      .required()\n      .description('Unit to express the difference in'),\n    timezone: validator\n      .string()\n      .optional()\n      .description('IANA timezone for interpreting dates (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const { from, to, unit, timezone } = args as {\n      from: string\n      to: string\n      unit: 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds'\n      timezone?: string\n    }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    const fromParsed = parseDate(from, zone)\n    if ('error' in fromParsed) return `Error: ${fromParsed.error}`\n\n    const toParsed = parseDate(to, zone)\n    if ('error' in toParsed) return `Error: ${toParsed.error}`\n\n    const diff = toParsed.diff(fromParsed, unit)\n    const value = diff.as(unit)\n    const rounded = Number.parseFloat(value.toFixed(4))\n    const abs = Math.abs(rounded)\n    const direction = value >= 0 ? 'after' : 'before'\n\n    return `${to} is ${abs} ${unit} ${direction} ${from}`\n  },\n})\n\n/**\n * Convert total seconds into a human-readable duration string.\n *\n * @remarks\n * Examples: `3725` → `1 hour, 2 minutes and 5 seconds`. Negative inputs are prefixed with `-`.\n * Zero seconds returns the literal `0 seconds`.\n */\nexport const durationFormatTool = new Tool({\n  name: 'duration_format',\n  description:\n    'Convert a total number of seconds into a human-readable duration breakdown (e.g. \"2 hours, 15 minutes and 30 seconds\").',\n  inputSchema: validator.object({\n    seconds: validator.number().required().description('Total number of seconds (may be negative)'),\n  }),\n  handler: async (args) => {\n    const { seconds: totalSeconds } = args as { seconds: number }\n    const sign = totalSeconds < 0 ? '-' : ''\n    const absSeconds = Math.abs(totalSeconds)\n\n    const dur = Duration.fromObject({ seconds: absSeconds }).shiftTo(\n      'years',\n      'months',\n      'weeks',\n      'days',\n      'hours',\n      'minutes',\n      'seconds'\n    )\n    const obj = dur.toObject()\n\n    const units: Array<[keyof typeof obj, string, string]> = [\n      ['years', 'year', 'years'],\n      ['months', 'month', 'months'],\n      ['weeks', 'week', 'weeks'],\n      ['days', 'day', 'days'],\n      ['hours', 'hour', 'hours'],\n      ['minutes', 'minute', 'minutes'],\n      ['seconds', 'second', 'seconds'],\n    ]\n\n    const parts: string[] = []\n    for (const [key, singular, plural] of units) {\n      const v = Math.floor(obj[key] ?? 0)\n      if (v > 0) parts.push(`${v} ${v === 1 ? singular : plural}`)\n    }\n\n    if (parts.length === 0) return '0 seconds'\n    const formatted =\n      parts.length === 1\n        ? parts[0]\n        : parts.slice(0, -1).join(', ') + ' and ' + parts[parts.length - 1]\n    return `${sign}${formatted}`\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/encoding/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pre-constructed tools for common text encodings and decoding operations.
+ *
+ * @module @nhtio/adk/batteries/tools/encoding
+ *
+ * @remarks
+ * Pre-constructed bundled tools for the `encoding` category. Import individually, the whole
+ * category, or import every tool via `@nhtio/adk/batteries`.
+ */
+import { Tool } from "../../../common";
+/**
+ * Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.
+ *
+ * @remarks
+ * `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,
+ * and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than
+ * thrown so the model can react in-line.
+ */
+export declare const encodeTextTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * Escape or unescape special characters for a target context.
+ *
+ * @remarks
+ * Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns
+ * an error string for unknown targets rather than throwing.
+ */
+export declare const textEscapeTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * Normalize Unicode text or extract code points.
+ *
+ * @remarks
+ * Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),
+ * `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or
+ * `code_points` (one `U+HHHH (char)` per line).
+ */
+export declare const unicodeNormalizeTool: Tool<import("../../../common").SpooledArtifact>;

package/batteries/tools/encoding.cjs

@@ -0,0 +1,156 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-KmRHZBOW.js");
+const require_tool_registry = require("../../tool_registry-Dkfprsck.js");
+require("../../common-Od8edUXU.js");
+const require_tool = require("../../tool-COSeH8I6.js");
+require("../../guards.cjs");
+let _nhtio_validation = require("@nhtio/validation");
+//#region src/batteries/tools/encoding/index.ts
+/**
+* Pre-constructed tools for common text encodings and decoding operations.
+*
+* @module @nhtio/adk/batteries/tools/encoding
+*
+* @remarks
+* Pre-constructed bundled tools for the `encoding` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+var utf8ToBase64 = (text) => {
+	const bytes = new TextEncoder().encode(text);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return globalThis.btoa(binary);
+};
+var base64ToUtf8 = (b64) => {
+	const binary = globalThis.atob(b64);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return new TextDecoder().decode(bytes);
+};
+/**
+* Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.
+*
+* @remarks
+* `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,
+* and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than
+* thrown so the model can react in-line.
+*/
+var encodeTextTool = new require_tool.Tool({
+	name: "encode_text",
+	description: "Encode or decode text using common schemes: base64, url (percent-encoding), html_entities. Specify direction: encode or decode.",
+	inputSchema: _nhtio_validation.validator.object({
+		text: _nhtio_validation.validator.string().required().description("Text to encode or decode"),
+		scheme: _nhtio_validation.validator.string().valid("base64", "url", "html_entities").required().description("Encoding scheme"),
+		direction: _nhtio_validation.validator.string().valid("encode", "decode").default("encode").description("Whether to encode or decode (default: encode)")
+	}),
+	handler: async (args) => {
+		const { text, scheme, direction } = args;
+		try {
+			if (scheme === "base64") {
+				if (direction === "encode") return utf8ToBase64(text);
+				return base64ToUtf8(text);
+			}
+			if (scheme === "url") {
+				if (direction === "encode") return encodeURIComponent(text);
+				return decodeURIComponent(text);
+			}
+			if (scheme === "html_entities") {
+				if (direction === "encode") return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+				return text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&#(\d+);/g, (_, code) => String.fromCharCode(Number.parseInt(code, 10))).replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+			}
+			return `Error: Unknown scheme "${scheme}".`;
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Escape or unescape special characters for a target context.
+*
+* @remarks
+* Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns
+* an error string for unknown targets rather than throwing.
+*/
+var textEscapeTool = new require_tool.Tool({
+	name: "text_escape",
+	description: "Escape or unescape special characters for a target context: json_string, regex, csv_field, sql_like, markdown.",
+	inputSchema: _nhtio_validation.validator.object({
+		text: _nhtio_validation.validator.string().required().description("Text to escape or unescape"),
+		target: _nhtio_validation.validator.string().valid("json_string", "regex", "csv_field", "sql_like", "markdown").required().description("Target context for escaping"),
+		direction: _nhtio_validation.validator.string().valid("escape", "unescape").default("escape").description("Whether to escape or unescape (default: escape)")
+	}),
+	handler: async (args) => {
+		const { text, target, direction } = args;
+		try {
+			if (target === "json_string") {
+				if (direction === "escape") return JSON.stringify(text).slice(1, -1);
+				return JSON.parse(`"${text}"`);
+			}
+			if (target === "regex") {
+				if (direction === "escape") return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+				return text.replace(/\\([.*+?^${}()|[\]\\])/g, "$1");
+			}
+			if (target === "csv_field") {
+				if (direction === "escape") {
+					if (/[,"\n\r]/.test(text)) return `"${text.replace(/"/g, "\"\"")}"`;
+					return text;
+				}
+				if (text.startsWith("\"") && text.endsWith("\"")) return text.slice(1, -1).replace(/""/g, "\"");
+				return text;
+			}
+			if (target === "sql_like") {
+				if (direction === "escape") return text.replace(/[%_\\]/g, "\\$&");
+				return text.replace(/\\([%_\\])/g, "$1");
+			}
+			if (target === "markdown") {
+				const mdChars = /[\\`*_{}[\]()#+\-.!|]/g;
+				if (direction === "escape") return text.replace(mdChars, "\\$&");
+				return text.replace(/\\([\\`*_{}[\]()#+\-.!|])/g, "$1");
+			}
+			return `Error: Unknown target "${target}".`;
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Normalize Unicode text or extract code points.
+*
+* @remarks
+* Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),
+* `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or
+* `code_points` (one `U+HHHH (char)` per line).
+*/
+var unicodeNormalizeTool = new require_tool.Tool({
+	name: "unicode_normalize",
+	description: "Normalize Unicode text (NFC, NFD, NFKC, NFKD), strip accents/diacritics, or get Unicode code points for each character.",
+	inputSchema: _nhtio_validation.validator.object({
+		text: _nhtio_validation.validator.string().required().description("Text to process"),
+		operation: _nhtio_validation.validator.string().valid("nfc", "nfd", "nfkc", "nfkd", "strip_accents", "code_points").required().description("Operation: NFC/NFD/NFKC/NFKD normalization, strip_accents (remove diacritics), or code_points (list hex values)")
+	}),
+	handler: async (args) => {
+		const { text, operation } = args;
+		try {
+			if (operation === "strip_accents") return text.normalize("NFD").replace(/[̀-ͯ]/g, "").normalize("NFC");
+			if (operation === "code_points") return [...text].map((ch) => {
+				return `U+${ch.codePointAt(0).toString(16).toUpperCase().padStart(4, "0")} (${ch})`;
+			}).join("\n");
+			const form = {
+				nfc: "NFC",
+				nfd: "NFD",
+				nfkc: "NFKC",
+				nfkd: "NFKD"
+			}[operation];
+			if (!form) return `Error: Unknown operation "${operation}".`;
+			return text.normalize(form);
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+//#endregion
+exports.encodeTextTool = encodeTextTool;
+exports.textEscapeTool = textEscapeTool;
+exports.unicodeNormalizeTool = unicodeNormalizeTool;
+
+//# sourceMappingURL=encoding.cjs.map

package/batteries/tools/encoding.cjs.map

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

package/batteries/tools/encoding.mjs

@@ -0,0 +1,152 @@
+import { o as isError } from "../../tool_registry-DqLOyGyG.mjs";
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import "../../guards.mjs";
+import { validator } from "@nhtio/validation";
+//#region src/batteries/tools/encoding/index.ts
+/**
+* Pre-constructed tools for common text encodings and decoding operations.
+*
+* @module @nhtio/adk/batteries/tools/encoding
+*
+* @remarks
+* Pre-constructed bundled tools for the `encoding` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+var utf8ToBase64 = (text) => {
+	const bytes = new TextEncoder().encode(text);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return globalThis.btoa(binary);
+};
+var base64ToUtf8 = (b64) => {
+	const binary = globalThis.atob(b64);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return new TextDecoder().decode(bytes);
+};
+/**
+* Encode or decode text using common schemes: base64, url (percent-encoding), html_entities.
+*
+* @remarks
+* `base64` uses the portable `globalThis.btoa`/`atob` pair so the tool works in browsers, Node,
+* and edge runtimes. Encoding/decoding errors are returned as `Error:` strings rather than
+* thrown so the model can react in-line.
+*/
+var encodeTextTool = new Tool({
+	name: "encode_text",
+	description: "Encode or decode text using common schemes: base64, url (percent-encoding), html_entities. Specify direction: encode or decode.",
+	inputSchema: validator.object({
+		text: validator.string().required().description("Text to encode or decode"),
+		scheme: validator.string().valid("base64", "url", "html_entities").required().description("Encoding scheme"),
+		direction: validator.string().valid("encode", "decode").default("encode").description("Whether to encode or decode (default: encode)")
+	}),
+	handler: async (args) => {
+		const { text, scheme, direction } = args;
+		try {
+			if (scheme === "base64") {
+				if (direction === "encode") return utf8ToBase64(text);
+				return base64ToUtf8(text);
+			}
+			if (scheme === "url") {
+				if (direction === "encode") return encodeURIComponent(text);
+				return decodeURIComponent(text);
+			}
+			if (scheme === "html_entities") {
+				if (direction === "encode") return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+				return text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&#(\d+);/g, (_, code) => String.fromCharCode(Number.parseInt(code, 10))).replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+			}
+			return `Error: Unknown scheme "${scheme}".`;
+		} catch (err) {
+			return `Error: ${isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Escape or unescape special characters for a target context.
+*
+* @remarks
+* Supports `json_string`, `regex`, `csv_field`, `sql_like`, and `markdown` targets. Returns
+* an error string for unknown targets rather than throwing.
+*/
+var textEscapeTool = new Tool({
+	name: "text_escape",
+	description: "Escape or unescape special characters for a target context: json_string, regex, csv_field, sql_like, markdown.",
+	inputSchema: validator.object({
+		text: validator.string().required().description("Text to escape or unescape"),
+		target: validator.string().valid("json_string", "regex", "csv_field", "sql_like", "markdown").required().description("Target context for escaping"),
+		direction: validator.string().valid("escape", "unescape").default("escape").description("Whether to escape or unescape (default: escape)")
+	}),
+	handler: async (args) => {
+		const { text, target, direction } = args;
+		try {
+			if (target === "json_string") {
+				if (direction === "escape") return JSON.stringify(text).slice(1, -1);
+				return JSON.parse(`"${text}"`);
+			}
+			if (target === "regex") {
+				if (direction === "escape") return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+				return text.replace(/\\([.*+?^${}()|[\]\\])/g, "$1");
+			}
+			if (target === "csv_field") {
+				if (direction === "escape") {
+					if (/[,"\n\r]/.test(text)) return `"${text.replace(/"/g, "\"\"")}"`;
+					return text;
+				}
+				if (text.startsWith("\"") && text.endsWith("\"")) return text.slice(1, -1).replace(/""/g, "\"");
+				return text;
+			}
+			if (target === "sql_like") {
+				if (direction === "escape") return text.replace(/[%_\\]/g, "\\$&");
+				return text.replace(/\\([%_\\])/g, "$1");
+			}
+			if (target === "markdown") {
+				const mdChars = /[\\`*_{}[\]()#+\-.!|]/g;
+				if (direction === "escape") return text.replace(mdChars, "\\$&");
+				return text.replace(/\\([\\`*_{}[\]()#+\-.!|])/g, "$1");
+			}
+			return `Error: Unknown target "${target}".`;
+		} catch (err) {
+			return `Error: ${isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Normalize Unicode text or extract code points.
+*
+* @remarks
+* Operations: NFC, NFD, NFKC, NFKD Unicode normalization forms (via `String.prototype.normalize`),
+* `strip_accents` (NFD-decompose, remove combining diacritics, re-compose to NFC), or
+* `code_points` (one `U+HHHH (char)` per line).
+*/
+var unicodeNormalizeTool = new Tool({
+	name: "unicode_normalize",
+	description: "Normalize Unicode text (NFC, NFD, NFKC, NFKD), strip accents/diacritics, or get Unicode code points for each character.",
+	inputSchema: validator.object({
+		text: validator.string().required().description("Text to process"),
+		operation: validator.string().valid("nfc", "nfd", "nfkc", "nfkd", "strip_accents", "code_points").required().description("Operation: NFC/NFD/NFKC/NFKD normalization, strip_accents (remove diacritics), or code_points (list hex values)")
+	}),
+	handler: async (args) => {
+		const { text, operation } = args;
+		try {
+			if (operation === "strip_accents") return text.normalize("NFD").replace(/[̀-ͯ]/g, "").normalize("NFC");
+			if (operation === "code_points") return [...text].map((ch) => {
+				return `U+${ch.codePointAt(0).toString(16).toUpperCase().padStart(4, "0")} (${ch})`;
+			}).join("\n");
+			const form = {
+				nfc: "NFC",
+				nfd: "NFD",
+				nfkc: "NFKC",
+				nfkd: "NFKD"
+			}[operation];
+			if (!form) return `Error: Unknown operation "${operation}".`;
+			return text.normalize(form);
+		} catch (err) {
+			return `Error: ${isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+//#endregion
+export { encodeTextTool, textEscapeTool, unicodeNormalizeTool };
+
+//# sourceMappingURL=encoding.mjs.map

package/batteries/tools/encoding.mjs.map

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

package/batteries/tools/formatting/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pre-constructed tools for locale-aware number, list, table, and text formatting.
+ *
+ * @module @nhtio/adk/batteries/tools/formatting
+ *
+ * @remarks
+ * Pre-constructed bundled tools for the `formatting` category. Import individually, the whole
+ * category, or import every tool via `@nhtio/adk/batteries`.
+ */
+import { Tool } from "../../../common";
+/**
+ * Format a number using locale-aware styles.
+ *
+ * @remarks
+ * Supported styles: `decimal`, `currency`, `percent`, `compact` (e.g. `1.2K`), `scientific`
+ * (e.g. `1.2e+3`), and `ordinal` (`1st`, `2nd`, `3rd`). Uses `Intl.NumberFormat` and
+ * `Intl.PluralRules` from the JS standard library. Returns an error string for non-finite values
+ * or invalid currency-without-currency-code.
+ */
+export declare const formatNumberTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * Format an array of items as a list.
+ *
+ * @remarks
+ * Supported styles: `bullet` (`• item`), `numbered` (`1. item`), `inline_and`
+ * (`a, b, and c`), `inline_or` (`a, b, or c`), `newline` (one per line).
+ */
+export declare const formatListTool: Tool<import("../../../common").SpooledArtifact>;