@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/tools/text_comparison.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_comparison.cjs","names":[],"sources":["../../../src/batteries/tools/text_comparison/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for text diffs, similarity checks, and edit-distance comparisons.\n *\n * @module @nhtio/adk/batteries/tools/text_comparison\n *\n * @remarks\n * Pre-constructed bundled tools for the `text_comparison` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { diffLines, diffWords } from 'diff'\nimport { validator } from '@nhtio/validation'\nimport { distance } from 'fastest-levenshtein'\n\n/**\n * Compare two texts and emit a unified-style diff plus an additions/removals summary.\n *\n * @remarks\n * `mode: 'lines'` (default) compares line-by-line; `mode: 'words'` compares word-by-word. The\n * output is clipped at 60 diff lines — the suffix `… (N more lines truncated)` is appended if\n * the diff is larger. Identical inputs short-circuit with `Texts are identical`.\n */\nexport const textDiffTool = new Tool({\n  name: 'text_diff',\n  description:\n    'Compare two texts and show what changed. Returns a summary of additions, deletions, and a unified-style diff.',\n  inputSchema: validator.object({\n    text_a: validator.string().required().allow('').description('Original text (before)'),\n    text_b: validator.string().required().allow('').description('New text (after)'),\n    mode: validator\n      .string()\n      .valid('lines', 'words')\n      .default('lines')\n      .description('Compare line-by-line or word-by-word (default: lines)'),\n  }),\n  handler: async (args) => {\n    const {\n      text_a: a,\n      text_b: b,\n      mode,\n    } = args as {\n      text_a: string\n      text_b: string\n      mode: 'lines' | 'words'\n    }\n\n    if (a === b) return 'Texts are identical — no differences found.'\n\n    const changes = mode === 'words' ? diffWords(a, b) : diffLines(a, b)\n\n    let added = 0\n    let removed = 0\n    let unchanged = 0\n    const diffOutput: string[] = []\n\n    for (const part of changes) {\n      const unit = mode === 'words' ? (part.value.match(/\\S+/g) ?? []).length : (part.count ?? 1)\n      if (part.added) {\n        added += unit\n        for (const line of part.value.split('\\n').filter((l) => l !== '' || mode === 'words')) {\n          if (line !== '') diffOutput.push(`+ ${line}`)\n        }\n      } else if (part.removed) {\n        removed += unit\n        for (const line of part.value.split('\\n').filter((l) => l !== '' || mode === 'words')) {\n          if (line !== '') diffOutput.push(`- ${line}`)\n        }\n      } else {\n        unchanged += unit\n      }\n    }\n\n    const unit = mode === 'lines' ? 'line' : 'word'\n    const summary = `+${added} ${unit}${added !== 1 ? 's' : ''} added, -${removed} ${unit}${removed !== 1 ? 's' : ''} removed, ${unchanged} unchanged`\n\n    const MAX_DIFF_LINES = 60\n    const truncated =\n      diffOutput.length > MAX_DIFF_LINES\n        ? `\\n… (${diffOutput.length - MAX_DIFF_LINES} more lines truncated)`\n        : ''\n    return [summary, '', ...diffOutput.slice(0, MAX_DIFF_LINES)].join('\\n') + truncated\n  },\n})\n\n/**\n * Report the Levenshtein edit distance and a similarity percentage between two strings.\n *\n * @remarks\n * Useful for fuzzy matching. The percentage is `(1 - distance / max(len_a, len_b)) * 100`, with\n * a human-readable label appended (`identical` / `very similar` / `similar` / `somewhat\n * similar` / `different` / `very different`).\n */\nexport const stringSimilarityTool = new Tool({\n  name: 'string_similarity',\n  description:\n    'Calculate edit distance and similarity percentage between two strings using Levenshtein distance. Useful for fuzzy matching.',\n  inputSchema: validator.object({\n    a: validator.string().required().allow('').description('First string'),\n    b: validator.string().required().allow('').description('Second string'),\n    case_insensitive: validator\n      .boolean()\n      .default(false)\n      .description('Ignore case when comparing (default: false)'),\n  }),\n  handler: async (args) => {\n    let { a, b } = args as { a: string; b: string }\n    const { case_insensitive: ci } = args as { case_insensitive: boolean }\n\n    if (ci) {\n      a = a.toLowerCase()\n      b = b.toLowerCase()\n    }\n\n    const dist = distance(a, b)\n    const maxLen = Math.max(a.length, b.length)\n    const pct = maxLen === 0 ? 100 : Number.parseFloat(((1 - dist / maxLen) * 100).toFixed(1))\n\n    const label =\n      pct === 100\n        ? 'identical'\n        : pct >= 90\n          ? 'very similar'\n          : pct >= 70\n            ? 'similar'\n            : pct >= 50\n              ? 'somewhat similar'\n              : pct >= 30\n                ? 'different'\n                : 'very different'\n\n    return `Edit distance: ${dist}\\nSimilarity: ${pct}% (${label})`\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/text_comparison.mjs

@@ -0,0 +1,93 @@
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import { validator } from "@nhtio/validation";
+import { diffLines, diffWords } from "diff";
+import { distance } from "fastest-levenshtein";
+//#region src/batteries/tools/text_comparison/index.ts
+/**
+* Pre-constructed tools for text diffs, similarity checks, and edit-distance comparisons.
+*
+* @module @nhtio/adk/batteries/tools/text_comparison
+*
+* @remarks
+* Pre-constructed bundled tools for the `text_comparison` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+/**
+* Compare two texts and emit a unified-style diff plus an additions/removals summary.
+*
+* @remarks
+* `mode: 'lines'` (default) compares line-by-line; `mode: 'words'` compares word-by-word. The
+* output is clipped at 60 diff lines — the suffix `… (N more lines truncated)` is appended if
+* the diff is larger. Identical inputs short-circuit with `Texts are identical`.
+*/
+var textDiffTool = new Tool({
+	name: "text_diff",
+	description: "Compare two texts and show what changed. Returns a summary of additions, deletions, and a unified-style diff.",
+	inputSchema: validator.object({
+		text_a: validator.string().required().allow("").description("Original text (before)"),
+		text_b: validator.string().required().allow("").description("New text (after)"),
+		mode: validator.string().valid("lines", "words").default("lines").description("Compare line-by-line or word-by-word (default: lines)")
+	}),
+	handler: async (args) => {
+		const { text_a: a, text_b: b, mode } = args;
+		if (a === b) return "Texts are identical — no differences found.";
+		const changes = mode === "words" ? diffWords(a, b) : diffLines(a, b);
+		let added = 0;
+		let removed = 0;
+		let unchanged = 0;
+		const diffOutput = [];
+		for (const part of changes) {
+			const unit = mode === "words" ? (part.value.match(/\S+/g) ?? []).length : part.count ?? 1;
+			if (part.added) {
+				added += unit;
+				for (const line of part.value.split("\n").filter((l) => l !== "" || mode === "words")) if (line !== "") diffOutput.push(`+ ${line}`);
+			} else if (part.removed) {
+				removed += unit;
+				for (const line of part.value.split("\n").filter((l) => l !== "" || mode === "words")) if (line !== "") diffOutput.push(`- ${line}`);
+			} else unchanged += unit;
+		}
+		const unit = mode === "lines" ? "line" : "word";
+		const summary = `+${added} ${unit}${added !== 1 ? "s" : ""} added, -${removed} ${unit}${removed !== 1 ? "s" : ""} removed, ${unchanged} unchanged`;
+		const MAX_DIFF_LINES = 60;
+		const truncated = diffOutput.length > MAX_DIFF_LINES ? `\n… (${diffOutput.length - MAX_DIFF_LINES} more lines truncated)` : "";
+		return [
+			summary,
+			"",
+			...diffOutput.slice(0, MAX_DIFF_LINES)
+		].join("\n") + truncated;
+	}
+});
+/**
+* Report the Levenshtein edit distance and a similarity percentage between two strings.
+*
+* @remarks
+* Useful for fuzzy matching. The percentage is `(1 - distance / max(len_a, len_b)) * 100`, with
+* a human-readable label appended (`identical` / `very similar` / `similar` / `somewhat
+* similar` / `different` / `very different`).
+*/
+var stringSimilarityTool = new Tool({
+	name: "string_similarity",
+	description: "Calculate edit distance and similarity percentage between two strings using Levenshtein distance. Useful for fuzzy matching.",
+	inputSchema: validator.object({
+		a: validator.string().required().allow("").description("First string"),
+		b: validator.string().required().allow("").description("Second string"),
+		case_insensitive: validator.boolean().default(false).description("Ignore case when comparing (default: false)")
+	}),
+	handler: async (args) => {
+		let { a, b } = args;
+		const { case_insensitive: ci } = args;
+		if (ci) {
+			a = a.toLowerCase();
+			b = b.toLowerCase();
+		}
+		const dist = distance(a, b);
+		const maxLen = Math.max(a.length, b.length);
+		const pct = maxLen === 0 ? 100 : Number.parseFloat(((1 - dist / maxLen) * 100).toFixed(1));
+		return `Edit distance: ${dist}\nSimilarity: ${pct}% (${pct === 100 ? "identical" : pct >= 90 ? "very similar" : pct >= 70 ? "similar" : pct >= 50 ? "somewhat similar" : pct >= 30 ? "different" : "very different"})`;
+	}
+});
+//#endregion
+export { stringSimilarityTool, textDiffTool };
+
+//# sourceMappingURL=text_comparison.mjs.map

package/batteries/tools/text_comparison.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_comparison.mjs","names":[],"sources":["../../../src/batteries/tools/text_comparison/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for text diffs, similarity checks, and edit-distance comparisons.\n *\n * @module @nhtio/adk/batteries/tools/text_comparison\n *\n * @remarks\n * Pre-constructed bundled tools for the `text_comparison` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { diffLines, diffWords } from 'diff'\nimport { validator } from '@nhtio/validation'\nimport { distance } from 'fastest-levenshtein'\n\n/**\n * Compare two texts and emit a unified-style diff plus an additions/removals summary.\n *\n * @remarks\n * `mode: 'lines'` (default) compares line-by-line; `mode: 'words'` compares word-by-word. The\n * output is clipped at 60 diff lines — the suffix `… (N more lines truncated)` is appended if\n * the diff is larger. Identical inputs short-circuit with `Texts are identical`.\n */\nexport const textDiffTool = new Tool({\n  name: 'text_diff',\n  description:\n    'Compare two texts and show what changed. Returns a summary of additions, deletions, and a unified-style diff.',\n  inputSchema: validator.object({\n    text_a: validator.string().required().allow('').description('Original text (before)'),\n    text_b: validator.string().required().allow('').description('New text (after)'),\n    mode: validator\n      .string()\n      .valid('lines', 'words')\n      .default('lines')\n      .description('Compare line-by-line or word-by-word (default: lines)'),\n  }),\n  handler: async (args) => {\n    const {\n      text_a: a,\n      text_b: b,\n      mode,\n    } = args as {\n      text_a: string\n      text_b: string\n      mode: 'lines' | 'words'\n    }\n\n    if (a === b) return 'Texts are identical — no differences found.'\n\n    const changes = mode === 'words' ? diffWords(a, b) : diffLines(a, b)\n\n    let added = 0\n    let removed = 0\n    let unchanged = 0\n    const diffOutput: string[] = []\n\n    for (const part of changes) {\n      const unit = mode === 'words' ? (part.value.match(/\\S+/g) ?? []).length : (part.count ?? 1)\n      if (part.added) {\n        added += unit\n        for (const line of part.value.split('\\n').filter((l) => l !== '' || mode === 'words')) {\n          if (line !== '') diffOutput.push(`+ ${line}`)\n        }\n      } else if (part.removed) {\n        removed += unit\n        for (const line of part.value.split('\\n').filter((l) => l !== '' || mode === 'words')) {\n          if (line !== '') diffOutput.push(`- ${line}`)\n        }\n      } else {\n        unchanged += unit\n      }\n    }\n\n    const unit = mode === 'lines' ? 'line' : 'word'\n    const summary = `+${added} ${unit}${added !== 1 ? 's' : ''} added, -${removed} ${unit}${removed !== 1 ? 's' : ''} removed, ${unchanged} unchanged`\n\n    const MAX_DIFF_LINES = 60\n    const truncated =\n      diffOutput.length > MAX_DIFF_LINES\n        ? `\\n… (${diffOutput.length - MAX_DIFF_LINES} more lines truncated)`\n        : ''\n    return [summary, '', ...diffOutput.slice(0, MAX_DIFF_LINES)].join('\\n') + truncated\n  },\n})\n\n/**\n * Report the Levenshtein edit distance and a similarity percentage between two strings.\n *\n * @remarks\n * Useful for fuzzy matching. The percentage is `(1 - distance / max(len_a, len_b)) * 100`, with\n * a human-readable label appended (`identical` / `very similar` / `similar` / `somewhat\n * similar` / `different` / `very different`).\n */\nexport const stringSimilarityTool = new Tool({\n  name: 'string_similarity',\n  description:\n    'Calculate edit distance and similarity percentage between two strings using Levenshtein distance. Useful for fuzzy matching.',\n  inputSchema: validator.object({\n    a: validator.string().required().allow('').description('First string'),\n    b: validator.string().required().allow('').description('Second string'),\n    case_insensitive: validator\n      .boolean()\n      .default(false)\n      .description('Ignore case when comparing (default: false)'),\n  }),\n  handler: async (args) => {\n    let { a, b } = args as { a: string; b: string }\n    const { case_insensitive: ci } = args as { case_insensitive: boolean }\n\n    if (ci) {\n      a = a.toLowerCase()\n      b = b.toLowerCase()\n    }\n\n    const dist = distance(a, b)\n    const maxLen = Math.max(a.length, b.length)\n    const pct = maxLen === 0 ? 100 : Number.parseFloat(((1 - dist / maxLen) * 100).toFixed(1))\n\n    const label =\n      pct === 100\n        ? 'identical'\n        : pct >= 90\n          ? 'very similar'\n          : pct >= 70\n            ? 'similar'\n            : pct >= 50\n              ? 'somewhat similar'\n              : pct >= 30\n                ? 'different'\n                : 'very different'\n\n    return `Edit distance: ${dist}\\nSimilarity: ${pct}% (${label})`\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,eAAe,IAAI,KAAK;CACnC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,QAAQ,UAAU,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,wBAAwB;EACpF,QAAQ,UAAU,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,kBAAkB;EAC9E,MAAM,UACH,OAAO,EACP,MAAM,SAAS,OAAO,EACtB,QAAQ,OAAO,EACf,YAAY,uDAAuD;CACxE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,QAAQ,GACR,QAAQ,GACR,SACE;EAMJ,IAAI,MAAM,GAAG,OAAO;EAEpB,MAAM,UAAU,SAAS,UAAU,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;EAEnE,IAAI,QAAQ;EACZ,IAAI,UAAU;EACd,IAAI,YAAY;EAChB,MAAM,aAAuB,CAAC;EAE9B,KAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,OAAO,SAAS,WAAW,KAAK,MAAM,MAAM,MAAM,KAAK,CAAC,GAAG,SAAU,KAAK,SAAS;GACzF,IAAI,KAAK,OAAO;IACd,SAAS;IACT,KAAK,MAAM,QAAQ,KAAK,MAAM,MAAM,IAAI,EAAE,QAAQ,MAAM,MAAM,MAAM,SAAS,OAAO,GAClF,IAAI,SAAS,IAAI,WAAW,KAAK,KAAK,MAAM;GAEhD,OAAO,IAAI,KAAK,SAAS;IACvB,WAAW;IACX,KAAK,MAAM,QAAQ,KAAK,MAAM,MAAM,IAAI,EAAE,QAAQ,MAAM,MAAM,MAAM,SAAS,OAAO,GAClF,IAAI,SAAS,IAAI,WAAW,KAAK,KAAK,MAAM;GAEhD,OACE,aAAa;EAEjB;EAEA,MAAM,OAAO,SAAS,UAAU,SAAS;EACzC,MAAM,UAAU,IAAI,MAAM,GAAG,OAAO,UAAU,IAAI,MAAM,GAAG,WAAW,QAAQ,GAAG,OAAO,YAAY,IAAI,MAAM,GAAG,YAAY,UAAU;EAEvI,MAAM,iBAAiB;EACvB,MAAM,YACJ,WAAW,SAAS,iBAChB,QAAQ,WAAW,SAAS,eAAe,0BAC3C;EACN,OAAO;GAAC;GAAS;GAAI,GAAG,WAAW,MAAM,GAAG,cAAc;EAAC,EAAE,KAAK,IAAI,IAAI;CAC5E;AACF,CAAC;;;;;;;;;AAUD,IAAa,uBAAuB,IAAI,KAAK;CAC3C,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO;EAC5B,GAAG,UAAU,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,cAAc;EACrE,GAAG,UAAU,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,eAAe;EACtE,kBAAkB,UACf,QAAQ,EACR,QAAQ,KAAK,EACb,YAAY,6CAA6C;CAC9D,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,IAAI,EAAE,GAAG,MAAM;EACf,MAAM,EAAE,kBAAkB,OAAO;EAEjC,IAAI,IAAI;GACN,IAAI,EAAE,YAAY;GAClB,IAAI,EAAE,YAAY;EACpB;EAEA,MAAM,OAAO,SAAS,GAAG,CAAC;EAC1B,MAAM,SAAS,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM;EAC1C,MAAM,MAAM,WAAW,IAAI,MAAM,OAAO,aAAa,IAAI,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC;EAezF,OAAO,kBAAkB,KAAK,gBAAgB,IAAI,KAZhD,QAAQ,MACJ,cACA,OAAO,KACL,iBACA,OAAO,KACL,YACA,OAAO,KACL,qBACA,OAAO,KACL,cACA,iBAE+C;CAC/D;AACF,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Pre-constructed tools for current time lookup and timezone-aware time formatting.
+ *
+ * @module @nhtio/adk/batteries/tools/time
+ *
+ * @remarks
+ * Pre-constructed bundled tools for the `time` category. Import individually, the whole
+ * category, or import every tool via `@nhtio/adk/batteries`.
+ */
+import { Tool } from "../../../common";
+/**
+ * Return the current time formatted in a given timezone.
+ *
+ * @remarks
+ * `timezone` defaults to `UTC` when omitted. The ADK has no notion of a "user local"
+ * timezone, so callers should pass an IANA zone (`America/New_York`, `Europe/London`, ...) for
+ * non-UTC formatting.
+ */
+export declare const getCurrentTimeTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * Convert a wall-clock time between two IANA timezones.
+ *
+ * @remarks
+ * `time` must be `HH:MM` in 24-hour format. `target_timezone` defaults to UTC. The conversion
+ * uses today's date in the source zone to pick the correct DST offset.
+ */
+export declare const convertTimeTool: Tool<import("../../../common").SpooledArtifact>;

package/batteries/tools/time.cjs

@@ -0,0 +1,63 @@
+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");
+let luxon = require("luxon");
+//#region src/batteries/tools/time/index.ts
+/**
+* Pre-constructed tools for current time lookup and timezone-aware time formatting.
+*
+* @module @nhtio/adk/batteries/tools/time
+*
+* @remarks
+* Pre-constructed bundled tools for the `time` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+/**
+* Return the current time formatted in a given timezone.
+*
+* @remarks
+* `timezone` defaults to `UTC` when omitted. The ADK has no notion of a "user local"
+* timezone, so callers should pass an IANA zone (`America/New_York`, `Europe/London`, ...) for
+* non-UTC formatting.
+*/
+var getCurrentTimeTool = new require_tool.Tool({
+	name: "get_current_time",
+	description: "Get current time in an IANA timezone (defaults to UTC).",
+	inputSchema: _nhtio_validation.validator.object({ timezone: _nhtio_validation.validator.string().default("UTC").description("IANA timezone (optional, defaults UTC)") }),
+	handler: async (args) => {
+		const { timezone } = args;
+		if (!luxon.IANAZone.isValidZone(timezone)) return `Error: Invalid timezone "${timezone}".`;
+		return `${timezone}: ${luxon.DateTime.now().setZone(timezone).toFormat("cccc, LLLL d, yyyy h:mm:ss a ZZZZ")}`;
+	}
+});
+/**
+* Convert a wall-clock time between two IANA timezones.
+*
+* @remarks
+* `time` must be `HH:MM` in 24-hour format. `target_timezone` defaults to UTC. The conversion
+* uses today's date in the source zone to pick the correct DST offset.
+*/
+var convertTimeTool = new require_tool.Tool({
+	name: "convert_time",
+	description: "Convert time between timezones.",
+	inputSchema: _nhtio_validation.validator.object({
+		source_timezone: _nhtio_validation.validator.string().required().description("Source IANA timezone"),
+		time: _nhtio_validation.validator.string().required().description("HH:MM (24h)"),
+		target_timezone: _nhtio_validation.validator.string().default("UTC").description("Target IANA timezone (optional, defaults UTC)")
+	}),
+	handler: async (args) => {
+		const { source_timezone: sourceTimezone, time, target_timezone: targetTimezone } = args;
+		if (!luxon.IANAZone.isValidZone(sourceTimezone)) return `Error: Invalid source timezone "${sourceTimezone}".`;
+		if (!luxon.IANAZone.isValidZone(targetTimezone)) return `Error: Invalid target timezone "${targetTimezone}".`;
+		const parsed = luxon.DateTime.fromFormat(time, "HH:mm", { zone: sourceTimezone });
+		if (!parsed.isValid) return `Error: Invalid time "${time}". Use HH:MM.`;
+		return `${time} ${sourceTimezone} = ${parsed.setZone(targetTimezone).toFormat("HH:mm")} ${targetTimezone}`;
+	}
+});
+//#endregion
+exports.convertTimeTool = convertTimeTool;
+exports.getCurrentTimeTool = getCurrentTimeTool;
+
+//# sourceMappingURL=time.cjs.map

package/batteries/tools/time.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.cjs","names":[],"sources":["../../../src/batteries/tools/time/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for current time lookup and timezone-aware time formatting.\n *\n * @module @nhtio/adk/batteries/tools/time\n *\n * @remarks\n * Pre-constructed bundled tools for the `time` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { DateTime, IANAZone } from 'luxon'\nimport { validator } from '@nhtio/validation'\n\n/**\n * Return the current time formatted in a given timezone.\n *\n * @remarks\n * `timezone` defaults to `UTC` when omitted. The ADK has no notion of a \"user local\"\n * timezone, so callers should pass an IANA zone (`America/New_York`, `Europe/London`, ...) for\n * non-UTC formatting.\n */\nexport const getCurrentTimeTool = new Tool({\n  name: 'get_current_time',\n  description: 'Get current time in an IANA timezone (defaults to UTC).',\n  inputSchema: validator.object({\n    timezone: validator\n      .string()\n      .default('UTC')\n      .description('IANA timezone (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const { timezone } = args as { timezone: string }\n    if (!IANAZone.isValidZone(timezone)) {\n      return `Error: Invalid timezone \"${timezone}\".`\n    }\n    const now = DateTime.now().setZone(timezone)\n    return `${timezone}: ${now.toFormat('cccc, LLLL d, yyyy h:mm:ss a ZZZZ')}`\n  },\n})\n\n/**\n * Convert a wall-clock time between two IANA timezones.\n *\n * @remarks\n * `time` must be `HH:MM` in 24-hour format. `target_timezone` defaults to UTC. The conversion\n * uses today's date in the source zone to pick the correct DST offset.\n */\nexport const convertTimeTool = new Tool({\n  name: 'convert_time',\n  description: 'Convert time between timezones.',\n  inputSchema: validator.object({\n    source_timezone: validator.string().required().description('Source IANA timezone'),\n    time: validator.string().required().description('HH:MM (24h)'),\n    target_timezone: validator\n      .string()\n      .default('UTC')\n      .description('Target IANA timezone (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const {\n      source_timezone: sourceTimezone,\n      time,\n      target_timezone: targetTimezone,\n    } = args as {\n      source_timezone: string\n      time: string\n      target_timezone: string\n    }\n\n    if (!IANAZone.isValidZone(sourceTimezone)) {\n      return `Error: Invalid source timezone \"${sourceTimezone}\".`\n    }\n    if (!IANAZone.isValidZone(targetTimezone)) {\n      return `Error: Invalid target timezone \"${targetTimezone}\".`\n    }\n\n    const parsed = DateTime.fromFormat(time, 'HH:mm', { zone: sourceTimezone })\n    if (!parsed.isValid) {\n      return `Error: Invalid time \"${time}\". Use HH:MM.`\n    }\n\n    const converted = parsed.setZone(targetTimezone)\n    return `${time} ${sourceTimezone} = ${converted.toFormat('HH:mm')} ${targetTimezone}`\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,qBAAqB,IAAI,aAAA,KAAK;CACzC,MAAM;CACN,aAAa;CACb,aAAa,kBAAA,UAAU,OAAO,EAC5B,UAAU,kBAAA,UACP,OAAO,EACP,QAAQ,KAAK,EACb,YAAY,wCAAwC,EACzD,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,aAAa;EACrB,IAAI,CAAC,MAAA,SAAS,YAAY,QAAQ,GAChC,OAAO,4BAA4B,SAAS;EAG9C,OAAO,GAAG,SAAS,IADP,MAAA,SAAS,IAAI,EAAE,QAAQ,QACZ,EAAI,SAAS,mCAAmC;CACzE;AACF,CAAC;;;;;;;;AASD,IAAa,kBAAkB,IAAI,aAAA,KAAK;CACtC,MAAM;CACN,aAAa;CACb,aAAa,kBAAA,UAAU,OAAO;EAC5B,iBAAiB,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,sBAAsB;EACjF,MAAM,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,aAAa;EAC7D,iBAAiB,kBAAA,UACd,OAAO,EACP,QAAQ,KAAK,EACb,YAAY,+CAA+C;CAChE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,iBAAiB,gBACjB,MACA,iBAAiB,mBACf;EAMJ,IAAI,CAAC,MAAA,SAAS,YAAY,cAAc,GACtC,OAAO,mCAAmC,eAAe;EAE3D,IAAI,CAAC,MAAA,SAAS,YAAY,cAAc,GACtC,OAAO,mCAAmC,eAAe;EAG3D,MAAM,SAAS,MAAA,SAAS,WAAW,MAAM,SAAS,EAAE,MAAM,eAAe,CAAC;EAC1E,IAAI,CAAC,OAAO,SACV,OAAO,wBAAwB,KAAK;EAItC,OAAO,GAAG,KAAK,GAAG,eAAe,KADf,OAAO,QAAQ,cACK,EAAU,SAAS,OAAO,EAAE,GAAG;CACvE;AACF,CAAC"}

package/batteries/tools/time.mjs

@@ -0,0 +1,60 @@
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import { validator } from "@nhtio/validation";
+import { DateTime, IANAZone } from "luxon";
+//#region src/batteries/tools/time/index.ts
+/**
+* Pre-constructed tools for current time lookup and timezone-aware time formatting.
+*
+* @module @nhtio/adk/batteries/tools/time
+*
+* @remarks
+* Pre-constructed bundled tools for the `time` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+/**
+* Return the current time formatted in a given timezone.
+*
+* @remarks
+* `timezone` defaults to `UTC` when omitted. The ADK has no notion of a "user local"
+* timezone, so callers should pass an IANA zone (`America/New_York`, `Europe/London`, ...) for
+* non-UTC formatting.
+*/
+var getCurrentTimeTool = new Tool({
+	name: "get_current_time",
+	description: "Get current time in an IANA timezone (defaults to UTC).",
+	inputSchema: validator.object({ timezone: validator.string().default("UTC").description("IANA timezone (optional, defaults UTC)") }),
+	handler: async (args) => {
+		const { timezone } = args;
+		if (!IANAZone.isValidZone(timezone)) return `Error: Invalid timezone "${timezone}".`;
+		return `${timezone}: ${DateTime.now().setZone(timezone).toFormat("cccc, LLLL d, yyyy h:mm:ss a ZZZZ")}`;
+	}
+});
+/**
+* Convert a wall-clock time between two IANA timezones.
+*
+* @remarks
+* `time` must be `HH:MM` in 24-hour format. `target_timezone` defaults to UTC. The conversion
+* uses today's date in the source zone to pick the correct DST offset.
+*/
+var convertTimeTool = new Tool({
+	name: "convert_time",
+	description: "Convert time between timezones.",
+	inputSchema: validator.object({
+		source_timezone: validator.string().required().description("Source IANA timezone"),
+		time: validator.string().required().description("HH:MM (24h)"),
+		target_timezone: validator.string().default("UTC").description("Target IANA timezone (optional, defaults UTC)")
+	}),
+	handler: async (args) => {
+		const { source_timezone: sourceTimezone, time, target_timezone: targetTimezone } = args;
+		if (!IANAZone.isValidZone(sourceTimezone)) return `Error: Invalid source timezone "${sourceTimezone}".`;
+		if (!IANAZone.isValidZone(targetTimezone)) return `Error: Invalid target timezone "${targetTimezone}".`;
+		const parsed = DateTime.fromFormat(time, "HH:mm", { zone: sourceTimezone });
+		if (!parsed.isValid) return `Error: Invalid time "${time}". Use HH:MM.`;
+		return `${time} ${sourceTimezone} = ${parsed.setZone(targetTimezone).toFormat("HH:mm")} ${targetTimezone}`;
+	}
+});
+//#endregion
+export { convertTimeTool, getCurrentTimeTool };
+
+//# sourceMappingURL=time.mjs.map

package/batteries/tools/time.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.mjs","names":[],"sources":["../../../src/batteries/tools/time/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for current time lookup and timezone-aware time formatting.\n *\n * @module @nhtio/adk/batteries/tools/time\n *\n * @remarks\n * Pre-constructed bundled tools for the `time` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { Tool } from '@nhtio/adk/common'\nimport { DateTime, IANAZone } from 'luxon'\nimport { validator } from '@nhtio/validation'\n\n/**\n * Return the current time formatted in a given timezone.\n *\n * @remarks\n * `timezone` defaults to `UTC` when omitted. The ADK has no notion of a \"user local\"\n * timezone, so callers should pass an IANA zone (`America/New_York`, `Europe/London`, ...) for\n * non-UTC formatting.\n */\nexport const getCurrentTimeTool = new Tool({\n  name: 'get_current_time',\n  description: 'Get current time in an IANA timezone (defaults to UTC).',\n  inputSchema: validator.object({\n    timezone: validator\n      .string()\n      .default('UTC')\n      .description('IANA timezone (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const { timezone } = args as { timezone: string }\n    if (!IANAZone.isValidZone(timezone)) {\n      return `Error: Invalid timezone \"${timezone}\".`\n    }\n    const now = DateTime.now().setZone(timezone)\n    return `${timezone}: ${now.toFormat('cccc, LLLL d, yyyy h:mm:ss a ZZZZ')}`\n  },\n})\n\n/**\n * Convert a wall-clock time between two IANA timezones.\n *\n * @remarks\n * `time` must be `HH:MM` in 24-hour format. `target_timezone` defaults to UTC. The conversion\n * uses today's date in the source zone to pick the correct DST offset.\n */\nexport const convertTimeTool = new Tool({\n  name: 'convert_time',\n  description: 'Convert time between timezones.',\n  inputSchema: validator.object({\n    source_timezone: validator.string().required().description('Source IANA timezone'),\n    time: validator.string().required().description('HH:MM (24h)'),\n    target_timezone: validator\n      .string()\n      .default('UTC')\n      .description('Target IANA timezone (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const {\n      source_timezone: sourceTimezone,\n      time,\n      target_timezone: targetTimezone,\n    } = args as {\n      source_timezone: string\n      time: string\n      target_timezone: string\n    }\n\n    if (!IANAZone.isValidZone(sourceTimezone)) {\n      return `Error: Invalid source timezone \"${sourceTimezone}\".`\n    }\n    if (!IANAZone.isValidZone(targetTimezone)) {\n      return `Error: Invalid target timezone \"${targetTimezone}\".`\n    }\n\n    const parsed = DateTime.fromFormat(time, 'HH:mm', { zone: sourceTimezone })\n    if (!parsed.isValid) {\n      return `Error: Invalid time \"${time}\". Use HH:MM.`\n    }\n\n    const converted = parsed.setZone(targetTimezone)\n    return `${time} ${sourceTimezone} = ${converted.toFormat('HH:mm')} ${targetTimezone}`\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,qBAAqB,IAAI,KAAK;CACzC,MAAM;CACN,aAAa;CACb,aAAa,UAAU,OAAO,EAC5B,UAAU,UACP,OAAO,EACP,QAAQ,KAAK,EACb,YAAY,wCAAwC,EACzD,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,aAAa;EACrB,IAAI,CAAC,SAAS,YAAY,QAAQ,GAChC,OAAO,4BAA4B,SAAS;EAG9C,OAAO,GAAG,SAAS,IADP,SAAS,IAAI,EAAE,QAAQ,QACZ,EAAI,SAAS,mCAAmC;CACzE;AACF,CAAC;;;;;;;;AASD,IAAa,kBAAkB,IAAI,KAAK;CACtC,MAAM;CACN,aAAa;CACb,aAAa,UAAU,OAAO;EAC5B,iBAAiB,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,sBAAsB;EACjF,MAAM,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,aAAa;EAC7D,iBAAiB,UACd,OAAO,EACP,QAAQ,KAAK,EACb,YAAY,+CAA+C;CAChE,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EACJ,iBAAiB,gBACjB,MACA,iBAAiB,mBACf;EAMJ,IAAI,CAAC,SAAS,YAAY,cAAc,GACtC,OAAO,mCAAmC,eAAe;EAE3D,IAAI,CAAC,SAAS,YAAY,cAAc,GACtC,OAAO,mCAAmC,eAAe;EAG3D,MAAM,SAAS,SAAS,WAAW,MAAM,SAAS,EAAE,MAAM,eAAe,CAAC;EAC1E,IAAI,CAAC,OAAO,SACV,OAAO,wBAAwB,KAAK;EAItC,OAAO,GAAG,KAAK,GAAG,eAAe,KADf,OAAO,QAAQ,cACK,EAAU,SAAS,OAAO,EAAE,GAAG;CACvE;AACF,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Pre-constructed tools for converting values across common measurement units.
+ *
+ * @module @nhtio/adk/batteries/tools/unit_conversion
+ *
+ * @remarks
+ * Pre-constructed bundled tools for the `unit_conversion` category. Import individually, the whole
+ * category, or import every tool via `@nhtio/adk/batteries`.
+ */
+import { Tool } from "../../../common";
+/**
+ * Convert a numeric value between units of the same physical category.
+ *
+ * @remarks
+ * Supported categories: length, mass, volume, temperature, speed, area, data, time, energy,
+ * pressure, angle. Uses static conversion tables — no external data required. Temperature is
+ * handled specially via a Kelvin intermediate to preserve precision across `C`/`F`/`K`.
+ */
+export declare const convertUnitTool: Tool<import("../../../common").SpooledArtifact>;