@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/tools/formatting.cjs

@@ -0,0 +1,120 @@
+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/formatting/index.ts
+/**
+* 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`.
+*/
+/**
+* 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.
+*/
+var formatNumberTool = new require_tool.Tool({
+	name: "format_number",
+	description: "Format a number using locale-aware styles: decimal, currency, percent, compact (1.2K), scientific (1.2e3), or ordinal (1st/2nd/3rd). Supports locale and precision options.",
+	inputSchema: _nhtio_validation.validator.object({
+		value: _nhtio_validation.validator.number().required().description("The number to format"),
+		style: _nhtio_validation.validator.string().valid("decimal", "currency", "percent", "compact", "scientific", "ordinal").default("decimal").description("Formatting style (default: decimal)"),
+		currency: _nhtio_validation.validator.string().optional().description("ISO 4217 currency code — required when style is \"currency\" (e.g. \"USD\", \"EUR\")"),
+		locale: _nhtio_validation.validator.string().default("en-US").description("BCP 47 locale tag (default: \"en-US\")"),
+		min_decimals: _nhtio_validation.validator.number().optional().description("Minimum fraction digits (default: style-dependent)"),
+		max_decimals: _nhtio_validation.validator.number().optional().description("Maximum fraction digits (default: style-dependent)")
+	}),
+	handler: async (args) => {
+		const { value, style, locale, currency, min_decimals: minDec, max_decimals: maxDec } = args;
+		if (!Number.isFinite(value)) return `Error: Value must be a finite number (got ${value}).`;
+		try {
+			if (style === "ordinal") {
+				const suffix = {
+					one: "st",
+					two: "nd",
+					few: "rd",
+					other: "th"
+				}[new Intl.PluralRules(locale, { type: "ordinal" }).select(value)] ?? "th";
+				return `${new Intl.NumberFormat(locale).format(value)}${suffix}`;
+			}
+			if (style === "scientific") {
+				const exp = value === 0 ? 0 : Math.floor(Math.log10(Math.abs(value)));
+				const mantissa = value / Math.pow(10, exp);
+				return `${new Intl.NumberFormat(locale, {
+					minimumFractionDigits: minDec ?? 2,
+					maximumFractionDigits: maxDec ?? 6
+				}).format(mantissa)}e${exp >= 0 ? "+" : ""}${exp}`;
+			}
+			const opts = {};
+			if (style === "currency") {
+				if (!currency) return "Error: \"currency\" parameter is required when style is \"currency\".";
+				opts.style = "currency";
+				opts.currency = currency.toUpperCase();
+			} else if (style === "percent") {
+				opts.style = "percent";
+				opts.minimumFractionDigits = minDec ?? 1;
+				opts.maximumFractionDigits = maxDec ?? 2;
+			} else if (style === "compact") {
+				opts.notation = "compact";
+				opts.compactDisplay = "short";
+			} else opts.style = "decimal";
+			if (minDec !== void 0 && style !== "percent") opts.minimumFractionDigits = minDec;
+			if (maxDec !== void 0 && style !== "percent") opts.maximumFractionDigits = maxDec;
+			return new Intl.NumberFormat(locale, opts).format(value);
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* 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).
+*/
+var formatListTool = new require_tool.Tool({
+	name: "format_list",
+	description: "Format an array of items as a list. Styles: bullet (• item), numbered (1. item), inline_and (\"a, b, and c\"), inline_or (\"a, b, or c\"), newline (one per line).",
+	inputSchema: _nhtio_validation.validator.object({
+		items: _nhtio_validation.validator.array().items(_nhtio_validation.validator.string()).required().description("Array of items to format"),
+		style: _nhtio_validation.validator.string().valid("bullet", "numbered", "inline_and", "inline_or", "newline").default("bullet").description("List format style (default: bullet)"),
+		indent: _nhtio_validation.validator.number().default(0).description("Spaces to indent each item (default: 0)")
+	}),
+	handler: async (args) => {
+		const { items, style, indent: rawIndent } = args;
+		const indent = Math.max(0, Math.floor(rawIndent));
+		const pad = " ".repeat(indent);
+		if (items.length === 0) return "";
+		switch (style) {
+			case "bullet": return items.map((item) => `${pad}• ${item}`).join("\n");
+			case "numbered": return items.map((item, i) => `${pad}${i + 1}. ${item}`).join("\n");
+			case "newline": return items.map((item) => `${pad}${item}`).join("\n");
+			case "inline_and":
+			case "inline_or": {
+				const conj = style === "inline_and" ? "and" : "or";
+				if (items.length === 1) return items[0];
+				if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`;
+				const last = items[items.length - 1];
+				return `${items.slice(0, -1).join(", ")}, ${conj} ${last}`;
+			}
+			default: return `Error: Unknown style "${style}".`;
+		}
+	}
+});
+//#endregion
+exports.formatListTool = formatListTool;
+exports.formatNumberTool = formatNumberTool;
+
+//# sourceMappingURL=formatting.cjs.map

package/batteries/tools/formatting.cjs.map

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

package/batteries/tools/formatting.mjs

@@ -0,0 +1,117 @@
+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/formatting/index.ts
+/**
+* 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`.
+*/
+/**
+* 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.
+*/
+var formatNumberTool = new Tool({
+	name: "format_number",
+	description: "Format a number using locale-aware styles: decimal, currency, percent, compact (1.2K), scientific (1.2e3), or ordinal (1st/2nd/3rd). Supports locale and precision options.",
+	inputSchema: validator.object({
+		value: validator.number().required().description("The number to format"),
+		style: validator.string().valid("decimal", "currency", "percent", "compact", "scientific", "ordinal").default("decimal").description("Formatting style (default: decimal)"),
+		currency: validator.string().optional().description("ISO 4217 currency code — required when style is \"currency\" (e.g. \"USD\", \"EUR\")"),
+		locale: validator.string().default("en-US").description("BCP 47 locale tag (default: \"en-US\")"),
+		min_decimals: validator.number().optional().description("Minimum fraction digits (default: style-dependent)"),
+		max_decimals: validator.number().optional().description("Maximum fraction digits (default: style-dependent)")
+	}),
+	handler: async (args) => {
+		const { value, style, locale, currency, min_decimals: minDec, max_decimals: maxDec } = args;
+		if (!Number.isFinite(value)) return `Error: Value must be a finite number (got ${value}).`;
+		try {
+			if (style === "ordinal") {
+				const suffix = {
+					one: "st",
+					two: "nd",
+					few: "rd",
+					other: "th"
+				}[new Intl.PluralRules(locale, { type: "ordinal" }).select(value)] ?? "th";
+				return `${new Intl.NumberFormat(locale).format(value)}${suffix}`;
+			}
+			if (style === "scientific") {
+				const exp = value === 0 ? 0 : Math.floor(Math.log10(Math.abs(value)));
+				const mantissa = value / Math.pow(10, exp);
+				return `${new Intl.NumberFormat(locale, {
+					minimumFractionDigits: minDec ?? 2,
+					maximumFractionDigits: maxDec ?? 6
+				}).format(mantissa)}e${exp >= 0 ? "+" : ""}${exp}`;
+			}
+			const opts = {};
+			if (style === "currency") {
+				if (!currency) return "Error: \"currency\" parameter is required when style is \"currency\".";
+				opts.style = "currency";
+				opts.currency = currency.toUpperCase();
+			} else if (style === "percent") {
+				opts.style = "percent";
+				opts.minimumFractionDigits = minDec ?? 1;
+				opts.maximumFractionDigits = maxDec ?? 2;
+			} else if (style === "compact") {
+				opts.notation = "compact";
+				opts.compactDisplay = "short";
+			} else opts.style = "decimal";
+			if (minDec !== void 0 && style !== "percent") opts.minimumFractionDigits = minDec;
+			if (maxDec !== void 0 && style !== "percent") opts.maximumFractionDigits = maxDec;
+			return new Intl.NumberFormat(locale, opts).format(value);
+		} catch (err) {
+			return `Error: ${isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* 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).
+*/
+var formatListTool = new Tool({
+	name: "format_list",
+	description: "Format an array of items as a list. Styles: bullet (• item), numbered (1. item), inline_and (\"a, b, and c\"), inline_or (\"a, b, or c\"), newline (one per line).",
+	inputSchema: validator.object({
+		items: validator.array().items(validator.string()).required().description("Array of items to format"),
+		style: validator.string().valid("bullet", "numbered", "inline_and", "inline_or", "newline").default("bullet").description("List format style (default: bullet)"),
+		indent: validator.number().default(0).description("Spaces to indent each item (default: 0)")
+	}),
+	handler: async (args) => {
+		const { items, style, indent: rawIndent } = args;
+		const indent = Math.max(0, Math.floor(rawIndent));
+		const pad = " ".repeat(indent);
+		if (items.length === 0) return "";
+		switch (style) {
+			case "bullet": return items.map((item) => `${pad}• ${item}`).join("\n");
+			case "numbered": return items.map((item, i) => `${pad}${i + 1}. ${item}`).join("\n");
+			case "newline": return items.map((item) => `${pad}${item}`).join("\n");
+			case "inline_and":
+			case "inline_or": {
+				const conj = style === "inline_and" ? "and" : "or";
+				if (items.length === 1) return items[0];
+				if (items.length === 2) return `${items[0]} ${conj} ${items[1]}`;
+				const last = items[items.length - 1];
+				return `${items.slice(0, -1).join(", ")}, ${conj} ${last}`;
+			}
+			default: return `Error: Unknown style "${style}".`;
+		}
+	}
+});
+//#endregion
+export { formatListTool, formatNumberTool };
+
+//# sourceMappingURL=formatting.mjs.map

package/batteries/tools/formatting.mjs.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * Pre-constructed tools for basic geographic distance and coordinate calculations.
+ *
+ * @module @nhtio/adk/batteries/tools/geo_basics
+ *
+ * @remarks
+ * Pre-constructed bundled tools for the `geo_basics` category. Import individually, the whole
+ * category, or import every tool via `@nhtio/adk/batteries`.
+ */
+import { Tool } from "../../../common";
+/**
+ * Great-circle (haversine) distance between two geographic coordinates.
+ *
+ * @remarks
+ * Uses the Earth's mean radius (6371.0088 km). Returns both kilometres and miles.
+ */
+export declare const geoDistanceTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * Check whether a point lies within a radius of a centre coordinate.
+ *
+ * @remarks
+ * Uses the haversine distance internally; returns the radius unit chosen by the caller
+ * (km or miles) in the result string.
+ */
+export declare const geoWithinRadiusTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * Check whether a point falls inside an axis-aligned bounding box.
+ *
+ * @remarks
+ * The bounding box is defined by its SW and NE corners. Boxes that wrap the antimeridian
+ * (i.e. SW longitude greater than NE longitude) are handled correctly.
+ */
+export declare const geoBboxContainsTool: Tool<import("../../../common").SpooledArtifact>;

package/batteries/tools/geo_basics.cjs

@@ -0,0 +1,136 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-KmRHZBOW.js");
+require("../../common-Od8edUXU.js");
+const require_tool = require("../../tool-COSeH8I6.js");
+let _nhtio_validation = require("@nhtio/validation");
+//#region src/batteries/tools/geo_basics/index.ts
+/**
+* Pre-constructed tools for basic geographic distance and coordinate calculations.
+*
+* @module @nhtio/adk/batteries/tools/geo_basics
+*
+* @remarks
+* Pre-constructed bundled tools for the `geo_basics` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+var EARTH_RADIUS_KM = 6371.0088;
+function toRad(deg) {
+	return deg * Math.PI / 180;
+}
+function haversineKm(lat1, lon1, lat2, lon2) {
+	const dLat = toRad(lat2 - lat1);
+	const dLon = toRad(lon2 - lon1);
+	const a = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;
+	return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a));
+}
+function validateLatLon(lat, lon, label) {
+	if (typeof lat !== "number" || !Number.isFinite(lat) || lat < -90 || lat > 90) return `Error: ${label} latitude must be a number between -90 and 90.`;
+	if (typeof lon !== "number" || !Number.isFinite(lon) || lon < -180 || lon > 180) return `Error: ${label} longitude must be a number between -180 and 180.`;
+	return null;
+}
+/**
+* Great-circle (haversine) distance between two geographic coordinates.
+*
+* @remarks
+* Uses the Earth's mean radius (6371.0088 km). Returns both kilometres and miles.
+*/
+var geoDistanceTool = new require_tool.Tool({
+	name: "geo_distance",
+	description: "Calculate the great-circle (haversine) distance between two geographic coordinates. Returns distance in km and miles.",
+	inputSchema: _nhtio_validation.validator.object({
+		lat1: _nhtio_validation.validator.number().required().description("Latitude of point A (decimal degrees, -90 to 90)"),
+		lon1: _nhtio_validation.validator.number().required().description("Longitude of point A (decimal degrees, -180 to 180)"),
+		lat2: _nhtio_validation.validator.number().required().description("Latitude of point B (decimal degrees, -90 to 90)"),
+		lon2: _nhtio_validation.validator.number().required().description("Longitude of point B (decimal degrees, -180 to 180)")
+	}),
+	handler: async (args) => {
+		const { lat1, lon1, lat2, lon2 } = args;
+		const errA = validateLatLon(lat1, lon1, "point A");
+		if (errA) return errA;
+		const errB = validateLatLon(lat2, lon2, "point B");
+		if (errB) return errB;
+		const km = haversineKm(lat1, lon1, lat2, lon2);
+		const miles = km * .621371;
+		return `Distance: ${km.toFixed(4)} km / ${miles.toFixed(4)} miles`;
+	}
+});
+/**
+* Check whether a point lies within a radius of a centre coordinate.
+*
+* @remarks
+* Uses the haversine distance internally; returns the radius unit chosen by the caller
+* (km or miles) in the result string.
+*/
+var geoWithinRadiusTool = new require_tool.Tool({
+	name: "geo_within_radius",
+	description: "Check whether a point is within a given radius (km or miles) of a center coordinate.",
+	inputSchema: _nhtio_validation.validator.object({
+		center_lat: _nhtio_validation.validator.number().required().description("Center latitude"),
+		center_lon: _nhtio_validation.validator.number().required().description("Center longitude"),
+		point_lat: _nhtio_validation.validator.number().required().description("Point latitude to test"),
+		point_lon: _nhtio_validation.validator.number().required().description("Point longitude to test"),
+		radius: _nhtio_validation.validator.number().required().description("Radius value (must be positive)"),
+		unit: _nhtio_validation.validator.string().valid("km", "miles").default("km").description("Unit for the radius (default: km)")
+	}),
+	handler: async (args) => {
+		const { center_lat: centerLat, center_lon: centerLon, point_lat: pointLat, point_lon: pointLon, radius, unit } = args;
+		const errC = validateLatLon(centerLat, centerLon, "center");
+		if (errC) return errC;
+		const errP = validateLatLon(pointLat, pointLon, "point");
+		if (errP) return errP;
+		if (!Number.isFinite(radius) || radius <= 0) return "Error: radius must be a positive number.";
+		const km = haversineKm(centerLat, centerLon, pointLat, pointLon);
+		const distInUnit = unit === "miles" ? km * .621371 : km;
+		return `${distInUnit <= radius ? "Yes" : "No"} — distance is ${distInUnit.toFixed(4)} ${unit} (radius: ${radius} ${unit})`;
+	}
+});
+/**
+* Check whether a point falls inside an axis-aligned bounding box.
+*
+* @remarks
+* The bounding box is defined by its SW and NE corners. Boxes that wrap the antimeridian
+* (i.e. SW longitude greater than NE longitude) are handled correctly.
+*/
+var geoBboxContainsTool = new require_tool.Tool({
+	name: "geo_bbox_contains",
+	description: "Check whether a point falls inside an axis-aligned bounding box defined by its SW and NE corners.",
+	inputSchema: _nhtio_validation.validator.object({
+		sw_lat: _nhtio_validation.validator.number().required().description("South-west corner latitude"),
+		sw_lon: _nhtio_validation.validator.number().required().description("South-west corner longitude"),
+		ne_lat: _nhtio_validation.validator.number().required().description("North-east corner latitude"),
+		ne_lon: _nhtio_validation.validator.number().required().description("North-east corner longitude"),
+		point_lat: _nhtio_validation.validator.number().required().description("Point latitude to test"),
+		point_lon: _nhtio_validation.validator.number().required().description("Point longitude to test")
+	}),
+	handler: async (args) => {
+		const { sw_lat: swLat, sw_lon: swLon, ne_lat: neLat, ne_lon: neLon, point_lat: pointLat, point_lon: pointLon } = args;
+		for (const [lat, lon, label] of [
+			[
+				swLat,
+				swLon,
+				"SW"
+			],
+			[
+				neLat,
+				neLon,
+				"NE"
+			],
+			[
+				pointLat,
+				pointLon,
+				"point"
+			]
+		]) {
+			const err = validateLatLon(lat, lon, label);
+			if (err) return err;
+		}
+		if (swLat > neLat) return "Error: SW latitude must be ≤ NE latitude.";
+		return pointLat >= swLat && pointLat <= neLat && (swLon <= neLon ? pointLon >= swLon && pointLon <= neLon : pointLon >= swLon || pointLon <= neLon) ? `Yes — point (${pointLat}, ${pointLon}) is inside the bounding box.` : `No — point (${pointLat}, ${pointLon}) is outside the bounding box.`;
+	}
+});
+//#endregion
+exports.geoBboxContainsTool = geoBboxContainsTool;
+exports.geoDistanceTool = geoDistanceTool;
+exports.geoWithinRadiusTool = geoWithinRadiusTool;
+
+//# sourceMappingURL=geo_basics.cjs.map

package/batteries/tools/geo_basics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo_basics.cjs","names":[],"sources":["../../../src/batteries/tools/geo_basics/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for basic geographic distance and coordinate calculations.\n *\n * @module @nhtio/adk/batteries/tools/geo_basics\n *\n * @remarks\n * Pre-constructed bundled tools for the `geo_basics` 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\nconst EARTH_RADIUS_KM = 6371.0088\n\nfunction toRad(deg: number): number {\n  return (deg * Math.PI) / 180\n}\n\nfunction haversineKm(lat1: number, lon1: number, lat2: number, lon2: number): number {\n  const dLat = toRad(lat2 - lat1)\n  const dLon = toRad(lon2 - lon1)\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2\n  return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a))\n}\n\nfunction validateLatLon(lat: unknown, lon: unknown, label: string): string | null {\n  if (typeof lat !== 'number' || !Number.isFinite(lat) || lat < -90 || lat > 90)\n    return `Error: ${label} latitude must be a number between -90 and 90.`\n  if (typeof lon !== 'number' || !Number.isFinite(lon) || lon < -180 || lon > 180)\n    return `Error: ${label} longitude must be a number between -180 and 180.`\n  return null\n}\n\n/**\n * Great-circle (haversine) distance between two geographic coordinates.\n *\n * @remarks\n * Uses the Earth's mean radius (6371.0088 km). Returns both kilometres and miles.\n */\nexport const geoDistanceTool = new Tool({\n  name: 'geo_distance',\n  description:\n    'Calculate the great-circle (haversine) distance between two geographic coordinates. Returns distance in km and miles.',\n  inputSchema: validator.object({\n    lat1: validator\n      .number()\n      .required()\n      .description('Latitude of point A (decimal degrees, -90 to 90)'),\n    lon1: validator\n      .number()\n      .required()\n      .description('Longitude of point A (decimal degrees, -180 to 180)'),\n    lat2: validator\n      .number()\n      .required()\n      .description('Latitude of point B (decimal degrees, -90 to 90)'),\n    lon2: validator\n      .number()\n      .required()\n      .description('Longitude of point B (decimal degrees, -180 to 180)'),\n  }),\n  handler: async (args) => {\n    const { lat1, lon1, lat2, lon2 } = args as {\n      lat1: number\n      lon1: number\n      lat2: number\n      lon2: number\n    }\n\n    const errA = validateLatLon(lat1, lon1, 'point A')\n    if (errA) return errA\n    const errB = validateLatLon(lat2, lon2, 'point B')\n    if (errB) return errB\n\n    const km = haversineKm(lat1, lon1, lat2, lon2)\n    const miles = km * 0.621371\n\n    return `Distance: ${km.toFixed(4)} km / ${miles.toFixed(4)} miles`\n  },\n})\n\n/**\n * Check whether a point lies within a radius of a centre coordinate.\n *\n * @remarks\n * Uses the haversine distance internally; returns the radius unit chosen by the caller\n * (km or miles) in the result string.\n */\nexport const geoWithinRadiusTool = new Tool({\n  name: 'geo_within_radius',\n  description:\n    'Check whether a point is within a given radius (km or miles) of a center coordinate.',\n  inputSchema: validator.object({\n    center_lat: validator.number().required().description('Center latitude'),\n    center_lon: validator.number().required().description('Center longitude'),\n    point_lat: validator.number().required().description('Point latitude to test'),\n    point_lon: validator.number().required().description('Point longitude to test'),\n    radius: validator.number().required().description('Radius value (must be positive)'),\n    unit: validator\n      .string()\n      .valid('km', 'miles')\n      .default('km')\n      .description('Unit for the radius (default: km)'),\n  }),\n  handler: async (args) => {\n    const {\n      center_lat: centerLat,\n      center_lon: centerLon,\n      point_lat: pointLat,\n      point_lon: pointLon,\n      radius,\n      unit,\n    } = args as {\n      center_lat: number\n      center_lon: number\n      point_lat: number\n      point_lon: number\n      radius: number\n      unit: string\n    }\n\n    const errC = validateLatLon(centerLat, centerLon, 'center')\n    if (errC) return errC\n    const errP = validateLatLon(pointLat, pointLon, 'point')\n    if (errP) return errP\n    if (!Number.isFinite(radius) || radius <= 0) return 'Error: radius must be a positive number.'\n\n    const km = haversineKm(centerLat, centerLon, pointLat, pointLon)\n    const distInUnit = unit === 'miles' ? km * 0.621371 : km\n    const within = distInUnit <= radius\n\n    return `${within ? 'Yes' : 'No'} — distance is ${distInUnit.toFixed(4)} ${unit} (radius: ${radius} ${unit})`\n  },\n})\n\n/**\n * Check whether a point falls inside an axis-aligned bounding box.\n *\n * @remarks\n * The bounding box is defined by its SW and NE corners. Boxes that wrap the antimeridian\n * (i.e. SW longitude greater than NE longitude) are handled correctly.\n */\nexport const geoBboxContainsTool = new Tool({\n  name: 'geo_bbox_contains',\n  description:\n    'Check whether a point falls inside an axis-aligned bounding box defined by its SW and NE corners.',\n  inputSchema: validator.object({\n    sw_lat: validator.number().required().description('South-west corner latitude'),\n    sw_lon: validator.number().required().description('South-west corner longitude'),\n    ne_lat: validator.number().required().description('North-east corner latitude'),\n    ne_lon: validator.number().required().description('North-east corner longitude'),\n    point_lat: validator.number().required().description('Point latitude to test'),\n    point_lon: validator.number().required().description('Point longitude to test'),\n  }),\n  handler: async (args) => {\n    const {\n      sw_lat: swLat,\n      sw_lon: swLon,\n      ne_lat: neLat,\n      ne_lon: neLon,\n      point_lat: pointLat,\n      point_lon: pointLon,\n    } = args as {\n      sw_lat: number\n      sw_lon: number\n      ne_lat: number\n      ne_lon: number\n      point_lat: number\n      point_lon: number\n    }\n\n    for (const [lat, lon, label] of [\n      [swLat, swLon, 'SW'],\n      [neLat, neLon, 'NE'],\n      [pointLat, pointLon, 'point'],\n    ] as [number, number, string][]) {\n      const err = validateLatLon(lat, lon, label)\n      if (err) return err\n    }\n\n    if (swLat > neLat) return 'Error: SW latitude must be ≤ NE latitude.'\n\n    const latIn = pointLat >= swLat && pointLat <= neLat\n\n    // Handle bounding boxes that wrap the antimeridian\n    const lonIn =\n      swLon <= neLon\n        ? pointLon >= swLon && pointLon <= neLon\n        : pointLon >= swLon || pointLon <= neLon\n\n    const inside = latIn && lonIn\n    return inside\n      ? `Yes — point (${pointLat}, ${pointLon}) is inside the bounding box.`\n      : `No — point (${pointLat}, ${pointLon}) is outside the bounding box.`\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;AAaA,IAAM,kBAAkB;AAExB,SAAS,MAAM,KAAqB;CAClC,OAAQ,MAAM,KAAK,KAAM;AAC3B;AAEA,SAAS,YAAY,MAAc,MAAc,MAAc,MAAsB;CACnF,MAAM,OAAO,MAAM,OAAO,IAAI;CAC9B,MAAM,OAAO,MAAM,OAAO,IAAI;CAC9B,MAAM,IACJ,KAAK,IAAI,OAAO,CAAC,KAAK,IACtB,KAAK,IAAI,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC,KAAK;CACxE,OAAO,IAAI,kBAAkB,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC;AACrD;AAEA,SAAS,eAAe,KAAc,KAAc,OAA8B;CAChF,IAAI,OAAO,QAAQ,YAAY,CAAC,OAAO,SAAS,GAAG,KAAK,MAAM,OAAO,MAAM,IACzE,OAAO,UAAU,MAAM;CACzB,IAAI,OAAO,QAAQ,YAAY,CAAC,OAAO,SAAS,GAAG,KAAK,MAAM,QAAQ,MAAM,KAC1E,OAAO,UAAU,MAAM;CACzB,OAAO;AACT;;;;;;;AAQA,IAAa,kBAAkB,IAAI,aAAA,KAAK;CACtC,MAAM;CACN,aACE;CACF,aAAa,kBAAA,UAAU,OAAO;EAC5B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,YAAY,kDAAkD;EACjE,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,YAAY,qDAAqD;EACpE,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,YAAY,kDAAkD;EACjE,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,YAAY,qDAAqD;CACtE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,MAAM,MAAM,MAAM,SAAS;EAOnC,MAAM,OAAO,eAAe,MAAM,MAAM,SAAS;EACjD,IAAI,MAAM,OAAO;EACjB,MAAM,OAAO,eAAe,MAAM,MAAM,SAAS;EACjD,IAAI,MAAM,OAAO;EAEjB,MAAM,KAAK,YAAY,MAAM,MAAM,MAAM,IAAI;EAC7C,MAAM,QAAQ,KAAK;EAEnB,OAAO,aAAa,GAAG,QAAQ,CAAC,EAAE,QAAQ,MAAM,QAAQ,CAAC,EAAE;CAC7D;AACF,CAAC;;;;;;;;AASD,IAAa,sBAAsB,IAAI,aAAA,KAAK;CAC1C,MAAM;CACN,aACE;CACF,aAAa,kBAAA,UAAU,OAAO;EAC5B,YAAY,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,iBAAiB;EACvE,YAAY,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,kBAAkB;EACxE,WAAW,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,wBAAwB;EAC7E,WAAW,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,yBAAyB;EAC9E,QAAQ,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,iCAAiC;EACnF,MAAM,kBAAA,UACH,OAAO,EACP,MAAM,MAAM,OAAO,EACnB,QAAQ,IAAI,EACZ,YAAY,mCAAmC;CACpD,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,YAAY,WACZ,YAAY,WACZ,WAAW,UACX,WAAW,UACX,QACA,SACE;EASJ,MAAM,OAAO,eAAe,WAAW,WAAW,QAAQ;EAC1D,IAAI,MAAM,OAAO;EACjB,MAAM,OAAO,eAAe,UAAU,UAAU,OAAO;EACvD,IAAI,MAAM,OAAO;EACjB,IAAI,CAAC,OAAO,SAAS,MAAM,KAAK,UAAU,GAAG,OAAO;EAEpD,MAAM,KAAK,YAAY,WAAW,WAAW,UAAU,QAAQ;EAC/D,MAAM,aAAa,SAAS,UAAU,KAAK,UAAW;EAGtD,OAAO,GAFQ,cAAc,SAEV,QAAQ,KAAK,iBAAiB,WAAW,QAAQ,CAAC,EAAE,GAAG,KAAK,YAAY,OAAO,GAAG,KAAK;CAC5G;AACF,CAAC;;;;;;;;AASD,IAAa,sBAAsB,IAAI,aAAA,KAAK;CAC1C,MAAM;CACN,aACE;CACF,aAAa,kBAAA,UAAU,OAAO;EAC5B,QAAQ,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,4BAA4B;EAC9E,QAAQ,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,6BAA6B;EAC/E,QAAQ,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,4BAA4B;EAC9E,QAAQ,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,6BAA6B;EAC/E,WAAW,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,wBAAwB;EAC7E,WAAW,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,yBAAyB;CAChF,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,QAAQ,OACR,QAAQ,OACR,QAAQ,OACR,QAAQ,OACR,WAAW,UACX,WAAW,aACT;EASJ,KAAK,MAAM,CAAC,KAAK,KAAK,UAAU;GAC9B;IAAC;IAAO;IAAO;GAAI;GACnB;IAAC;IAAO;IAAO;GAAI;GACnB;IAAC;IAAU;IAAU;GAAO;EAC9B,GAAiC;GAC/B,MAAM,MAAM,eAAe,KAAK,KAAK,KAAK;GAC1C,IAAI,KAAK,OAAO;EAClB;EAEA,IAAI,QAAQ,OAAO,OAAO;EAW1B,OATc,YAAY,SAAS,YAAY,UAI7C,SAAS,QACL,YAAY,SAAS,YAAY,QACjC,YAAY,SAAS,YAAY,SAInC,gBAAgB,SAAS,IAAI,SAAS,iCACtC,eAAe,SAAS,IAAI,SAAS;CAC3C;AACF,CAAC"}

package/batteries/tools/geo_basics.mjs

@@ -0,0 +1,132 @@
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import { validator } from "@nhtio/validation";
+//#region src/batteries/tools/geo_basics/index.ts
+/**
+* Pre-constructed tools for basic geographic distance and coordinate calculations.
+*
+* @module @nhtio/adk/batteries/tools/geo_basics
+*
+* @remarks
+* Pre-constructed bundled tools for the `geo_basics` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+var EARTH_RADIUS_KM = 6371.0088;
+function toRad(deg) {
+	return deg * Math.PI / 180;
+}
+function haversineKm(lat1, lon1, lat2, lon2) {
+	const dLat = toRad(lat2 - lat1);
+	const dLon = toRad(lon2 - lon1);
+	const a = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;
+	return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a));
+}
+function validateLatLon(lat, lon, label) {
+	if (typeof lat !== "number" || !Number.isFinite(lat) || lat < -90 || lat > 90) return `Error: ${label} latitude must be a number between -90 and 90.`;
+	if (typeof lon !== "number" || !Number.isFinite(lon) || lon < -180 || lon > 180) return `Error: ${label} longitude must be a number between -180 and 180.`;
+	return null;
+}
+/**
+* Great-circle (haversine) distance between two geographic coordinates.
+*
+* @remarks
+* Uses the Earth's mean radius (6371.0088 km). Returns both kilometres and miles.
+*/
+var geoDistanceTool = new Tool({
+	name: "geo_distance",
+	description: "Calculate the great-circle (haversine) distance between two geographic coordinates. Returns distance in km and miles.",
+	inputSchema: validator.object({
+		lat1: validator.number().required().description("Latitude of point A (decimal degrees, -90 to 90)"),
+		lon1: validator.number().required().description("Longitude of point A (decimal degrees, -180 to 180)"),
+		lat2: validator.number().required().description("Latitude of point B (decimal degrees, -90 to 90)"),
+		lon2: validator.number().required().description("Longitude of point B (decimal degrees, -180 to 180)")
+	}),
+	handler: async (args) => {
+		const { lat1, lon1, lat2, lon2 } = args;
+		const errA = validateLatLon(lat1, lon1, "point A");
+		if (errA) return errA;
+		const errB = validateLatLon(lat2, lon2, "point B");
+		if (errB) return errB;
+		const km = haversineKm(lat1, lon1, lat2, lon2);
+		const miles = km * .621371;
+		return `Distance: ${km.toFixed(4)} km / ${miles.toFixed(4)} miles`;
+	}
+});
+/**
+* Check whether a point lies within a radius of a centre coordinate.
+*
+* @remarks
+* Uses the haversine distance internally; returns the radius unit chosen by the caller
+* (km or miles) in the result string.
+*/
+var geoWithinRadiusTool = new Tool({
+	name: "geo_within_radius",
+	description: "Check whether a point is within a given radius (km or miles) of a center coordinate.",
+	inputSchema: validator.object({
+		center_lat: validator.number().required().description("Center latitude"),
+		center_lon: validator.number().required().description("Center longitude"),
+		point_lat: validator.number().required().description("Point latitude to test"),
+		point_lon: validator.number().required().description("Point longitude to test"),
+		radius: validator.number().required().description("Radius value (must be positive)"),
+		unit: validator.string().valid("km", "miles").default("km").description("Unit for the radius (default: km)")
+	}),
+	handler: async (args) => {
+		const { center_lat: centerLat, center_lon: centerLon, point_lat: pointLat, point_lon: pointLon, radius, unit } = args;
+		const errC = validateLatLon(centerLat, centerLon, "center");
+		if (errC) return errC;
+		const errP = validateLatLon(pointLat, pointLon, "point");
+		if (errP) return errP;
+		if (!Number.isFinite(radius) || radius <= 0) return "Error: radius must be a positive number.";
+		const km = haversineKm(centerLat, centerLon, pointLat, pointLon);
+		const distInUnit = unit === "miles" ? km * .621371 : km;
+		return `${distInUnit <= radius ? "Yes" : "No"} — distance is ${distInUnit.toFixed(4)} ${unit} (radius: ${radius} ${unit})`;
+	}
+});
+/**
+* Check whether a point falls inside an axis-aligned bounding box.
+*
+* @remarks
+* The bounding box is defined by its SW and NE corners. Boxes that wrap the antimeridian
+* (i.e. SW longitude greater than NE longitude) are handled correctly.
+*/
+var geoBboxContainsTool = new Tool({
+	name: "geo_bbox_contains",
+	description: "Check whether a point falls inside an axis-aligned bounding box defined by its SW and NE corners.",
+	inputSchema: validator.object({
+		sw_lat: validator.number().required().description("South-west corner latitude"),
+		sw_lon: validator.number().required().description("South-west corner longitude"),
+		ne_lat: validator.number().required().description("North-east corner latitude"),
+		ne_lon: validator.number().required().description("North-east corner longitude"),
+		point_lat: validator.number().required().description("Point latitude to test"),
+		point_lon: validator.number().required().description("Point longitude to test")
+	}),
+	handler: async (args) => {
+		const { sw_lat: swLat, sw_lon: swLon, ne_lat: neLat, ne_lon: neLon, point_lat: pointLat, point_lon: pointLon } = args;
+		for (const [lat, lon, label] of [
+			[
+				swLat,
+				swLon,
+				"SW"
+			],
+			[
+				neLat,
+				neLon,
+				"NE"
+			],
+			[
+				pointLat,
+				pointLon,
+				"point"
+			]
+		]) {
+			const err = validateLatLon(lat, lon, label);
+			if (err) return err;
+		}
+		if (swLat > neLat) return "Error: SW latitude must be ≤ NE latitude.";
+		return pointLat >= swLat && pointLat <= neLat && (swLon <= neLon ? pointLon >= swLon && pointLon <= neLon : pointLon >= swLon || pointLon <= neLon) ? `Yes — point (${pointLat}, ${pointLon}) is inside the bounding box.` : `No — point (${pointLat}, ${pointLon}) is outside the bounding box.`;
+	}
+});
+//#endregion
+export { geoBboxContainsTool, geoDistanceTool, geoWithinRadiusTool };
+
+//# sourceMappingURL=geo_basics.mjs.map

package/batteries/tools/geo_basics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo_basics.mjs","names":[],"sources":["../../../src/batteries/tools/geo_basics/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for basic geographic distance and coordinate calculations.\n *\n * @module @nhtio/adk/batteries/tools/geo_basics\n *\n * @remarks\n * Pre-constructed bundled tools for the `geo_basics` 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\nconst EARTH_RADIUS_KM = 6371.0088\n\nfunction toRad(deg: number): number {\n  return (deg * Math.PI) / 180\n}\n\nfunction haversineKm(lat1: number, lon1: number, lat2: number, lon2: number): number {\n  const dLat = toRad(lat2 - lat1)\n  const dLon = toRad(lon2 - lon1)\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2\n  return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a))\n}\n\nfunction validateLatLon(lat: unknown, lon: unknown, label: string): string | null {\n  if (typeof lat !== 'number' || !Number.isFinite(lat) || lat < -90 || lat > 90)\n    return `Error: ${label} latitude must be a number between -90 and 90.`\n  if (typeof lon !== 'number' || !Number.isFinite(lon) || lon < -180 || lon > 180)\n    return `Error: ${label} longitude must be a number between -180 and 180.`\n  return null\n}\n\n/**\n * Great-circle (haversine) distance between two geographic coordinates.\n *\n * @remarks\n * Uses the Earth's mean radius (6371.0088 km). Returns both kilometres and miles.\n */\nexport const geoDistanceTool = new Tool({\n  name: 'geo_distance',\n  description:\n    'Calculate the great-circle (haversine) distance between two geographic coordinates. Returns distance in km and miles.',\n  inputSchema: validator.object({\n    lat1: validator\n      .number()\n      .required()\n      .description('Latitude of point A (decimal degrees, -90 to 90)'),\n    lon1: validator\n      .number()\n      .required()\n      .description('Longitude of point A (decimal degrees, -180 to 180)'),\n    lat2: validator\n      .number()\n      .required()\n      .description('Latitude of point B (decimal degrees, -90 to 90)'),\n    lon2: validator\n      .number()\n      .required()\n      .description('Longitude of point B (decimal degrees, -180 to 180)'),\n  }),\n  handler: async (args) => {\n    const { lat1, lon1, lat2, lon2 } = args as {\n      lat1: number\n      lon1: number\n      lat2: number\n      lon2: number\n    }\n\n    const errA = validateLatLon(lat1, lon1, 'point A')\n    if (errA) return errA\n    const errB = validateLatLon(lat2, lon2, 'point B')\n    if (errB) return errB\n\n    const km = haversineKm(lat1, lon1, lat2, lon2)\n    const miles = km * 0.621371\n\n    return `Distance: ${km.toFixed(4)} km / ${miles.toFixed(4)} miles`\n  },\n})\n\n/**\n * Check whether a point lies within a radius of a centre coordinate.\n *\n * @remarks\n * Uses the haversine distance internally; returns the radius unit chosen by the caller\n * (km or miles) in the result string.\n */\nexport const geoWithinRadiusTool = new Tool({\n  name: 'geo_within_radius',\n  description:\n    'Check whether a point is within a given radius (km or miles) of a center coordinate.',\n  inputSchema: validator.object({\n    center_lat: validator.number().required().description('Center latitude'),\n    center_lon: validator.number().required().description('Center longitude'),\n    point_lat: validator.number().required().description('Point latitude to test'),\n    point_lon: validator.number().required().description('Point longitude to test'),\n    radius: validator.number().required().description('Radius value (must be positive)'),\n    unit: validator\n      .string()\n      .valid('km', 'miles')\n      .default('km')\n      .description('Unit for the radius (default: km)'),\n  }),\n  handler: async (args) => {\n    const {\n      center_lat: centerLat,\n      center_lon: centerLon,\n      point_lat: pointLat,\n      point_lon: pointLon,\n      radius,\n      unit,\n    } = args as {\n      center_lat: number\n      center_lon: number\n      point_lat: number\n      point_lon: number\n      radius: number\n      unit: string\n    }\n\n    const errC = validateLatLon(centerLat, centerLon, 'center')\n    if (errC) return errC\n    const errP = validateLatLon(pointLat, pointLon, 'point')\n    if (errP) return errP\n    if (!Number.isFinite(radius) || radius <= 0) return 'Error: radius must be a positive number.'\n\n    const km = haversineKm(centerLat, centerLon, pointLat, pointLon)\n    const distInUnit = unit === 'miles' ? km * 0.621371 : km\n    const within = distInUnit <= radius\n\n    return `${within ? 'Yes' : 'No'} — distance is ${distInUnit.toFixed(4)} ${unit} (radius: ${radius} ${unit})`\n  },\n})\n\n/**\n * Check whether a point falls inside an axis-aligned bounding box.\n *\n * @remarks\n * The bounding box is defined by its SW and NE corners. Boxes that wrap the antimeridian\n * (i.e. SW longitude greater than NE longitude) are handled correctly.\n */\nexport const geoBboxContainsTool = new Tool({\n  name: 'geo_bbox_contains',\n  description:\n    'Check whether a point falls inside an axis-aligned bounding box defined by its SW and NE corners.',\n  inputSchema: validator.object({\n    sw_lat: validator.number().required().description('South-west corner latitude'),\n    sw_lon: validator.number().required().description('South-west corner longitude'),\n    ne_lat: validator.number().required().description('North-east corner latitude'),\n    ne_lon: validator.number().required().description('North-east corner longitude'),\n    point_lat: validator.number().required().description('Point latitude to test'),\n    point_lon: validator.number().required().description('Point longitude to test'),\n  }),\n  handler: async (args) => {\n    const {\n      sw_lat: swLat,\n      sw_lon: swLon,\n      ne_lat: neLat,\n      ne_lon: neLon,\n      point_lat: pointLat,\n      point_lon: pointLon,\n    } = args as {\n      sw_lat: number\n      sw_lon: number\n      ne_lat: number\n      ne_lon: number\n      point_lat: number\n      point_lon: number\n    }\n\n    for (const [lat, lon, label] of [\n      [swLat, swLon, 'SW'],\n      [neLat, neLon, 'NE'],\n      [pointLat, pointLon, 'point'],\n    ] as [number, number, string][]) {\n      const err = validateLatLon(lat, lon, label)\n      if (err) return err\n    }\n\n    if (swLat > neLat) return 'Error: SW latitude must be ≤ NE latitude.'\n\n    const latIn = pointLat >= swLat && pointLat <= neLat\n\n    // Handle bounding boxes that wrap the antimeridian\n    const lonIn =\n      swLon <= neLon\n        ? pointLon >= swLon && pointLon <= neLon\n        : pointLon >= swLon || pointLon <= neLon\n\n    const inside = latIn && lonIn\n    return inside\n      ? `Yes — point (${pointLat}, ${pointLon}) is inside the bounding box.`\n      : `No — point (${pointLat}, ${pointLon}) is outside the bounding box.`\n  },\n})\n"],"mappings":"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"}