@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/tools/datetime_extended.mjs

@@ -0,0 +1,302 @@
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import { validator } from "@nhtio/validation";
+import { DateTime, IANAZone } from "luxon";
+import * as chrono from "chrono-node";
+//#region src/batteries/tools/datetime_extended/index.ts
+/**
+* Pre-constructed tools for parsing natural-language dates and business-calendar calculations.
+*
+* @module @nhtio/adk/batteries/tools/datetime_extended
+*
+* @remarks
+* Pre-constructed bundled tools for the `datetime_extended` 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 countBusinessDays(from, to) {
+	const forward = to >= from;
+	const start = forward ? from.startOf("day") : to.startOf("day");
+	const end = forward ? to.startOf("day") : from.startOf("day");
+	const totalDays = Math.round(end.diff(start, "days").days);
+	const fullWeeks = Math.floor(totalDays / 7);
+	let bdays = fullWeeks * 5;
+	let cursor = start.plus({ days: fullWeeks * 7 });
+	while (cursor < end) {
+		cursor = cursor.plus({ days: 1 });
+		if (cursor.weekday <= 5) bdays++;
+	}
+	return forward ? bdays : -bdays;
+}
+/**
+* Find the Nth occurrence of a weekday in a given month.
+*
+* @remarks
+* Examples: "2nd Friday of March 2026", "last Monday of January 2025". Accepts 1st–5th and
+* `last`. Returns an error if the month does not contain that many occurrences of the weekday.
+*/
+var dateNthWeekdayTool = new Tool({
+	name: "date_nth_weekday",
+	description: "Find the Nth occurrence of a weekday in a given month (e.g., \"2nd Friday of March 2026\", \"last Monday of next month\"). Supports 1st–5th and \"last\".",
+	inputSchema: validator.object({
+		nth: validator.string().required().description("Which occurrence: \"1st\", \"2nd\", \"3rd\", \"4th\", \"5th\", or \"last\"."),
+		weekday: validator.string().valid("monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday").required().description("Day of the week."),
+		month: validator.number().required().description("Month number (1–12)."),
+		year: validator.number().optional().description("Year (defaults to current year)."),
+		timezone: validator.string().optional().description("IANA timezone (optional, defaults UTC).")
+	}),
+	handler: async (args) => {
+		const { nth, weekday, month: rawMonth, year: rawYear, timezone } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		const targetWeekday = {
+			monday: 1,
+			tuesday: 2,
+			wednesday: 3,
+			thursday: 4,
+			friday: 5,
+			saturday: 6,
+			sunday: 7
+		}[weekday.toLowerCase()];
+		const month = Math.floor(rawMonth);
+		if (month < 1 || month > 12) return `Error: Month must be 1–12, got ${rawMonth}.`;
+		const year = Math.floor(rawYear ?? DateTime.now().setZone(zone).year);
+		const nthRaw = nth.toLowerCase().replace(/\s/g, "");
+		const firstOfMonth = DateTime.fromObject({
+			year,
+			month,
+			day: 1
+		}, { zone });
+		if (!firstOfMonth.isValid) return `Error: Invalid date for ${year}-${month}.`;
+		const occurrences = [];
+		let cursor = firstOfMonth;
+		while (cursor.weekday !== targetWeekday) cursor = cursor.plus({ days: 1 });
+		while (cursor.month === month) {
+			occurrences.push(cursor);
+			cursor = cursor.plus({ weeks: 1 });
+		}
+		let result;
+		if (nthRaw === "last") result = occurrences[occurrences.length - 1];
+		else {
+			const n = {
+				"1st": 1,
+				"1": 1,
+				"first": 1,
+				"2nd": 2,
+				"2": 2,
+				"second": 2,
+				"3rd": 3,
+				"3": 3,
+				"third": 3,
+				"4th": 4,
+				"4": 4,
+				"fourth": 4,
+				"5th": 5,
+				"5": 5,
+				"fifth": 5
+			}[nthRaw];
+			if (!n) return `Error: Invalid nth value "${nth}". Use 1st–5th or "last".`;
+			if (n > occurrences.length) return `Error: There is no ${nth} ${weekday} in ${firstOfMonth.toFormat("LLLL yyyy")} (only ${occurrences.length} occurrence${occurrences.length !== 1 ? "s" : ""}).`;
+			result = occurrences[n - 1];
+		}
+		if (!result) return "Error: Could not compute the date.";
+		return `${nth} ${weekday} of ${result.toFormat("LLLL yyyy")}: ${result.toISODate()}\nFormatted: ${result.toFormat("cccc, LLLL d, yyyy")}`;
+	}
+});
+/**
+* Get calendar metadata for a date.
+*
+* @remarks
+* Reports ISO week number, day of year, calendar quarter, fiscal quarter/year (configurable via
+* `fiscal_year_start_month`), week of month, and whether the date is a weekend. Accepts ISO
+* dates, natural-language ("next Tuesday"), and `now`.
+*/
+var dateCalendarInfoTool = new Tool({
+	name: "date_calendar_info",
+	description: "Get calendar metadata for a date: ISO week number, day of year, calendar quarter, fiscal quarter/year, week of month, and whether it is a weekend or weekday.",
+	inputSchema: validator.object({
+		date: validator.string().required().description("ISO 8601 date, natural language date, or \"now\"."),
+		timezone: validator.string().optional().description("IANA timezone (optional, defaults UTC)."),
+		fiscal_year_start_month: validator.number().default(1).description("Month when fiscal year starts (1–12, default: 1 = calendar year).")
+	}),
+	handler: async (args) => {
+		const { date: dateStr, timezone, fiscal_year_start_month: rawFyStart } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		let dt;
+		if (dateStr.toLowerCase() === "now") dt = DateTime.now().setZone(zone);
+		else {
+			dt = DateTime.fromISO(dateStr, { zone });
+			if (!dt.isValid) {
+				const parsed = chrono.parseDate(dateStr, /* @__PURE__ */ new Date());
+				if (!parsed) return `Error: Could not parse date "${dateStr}".`;
+				dt = DateTime.fromJSDate(parsed).setZone(zone);
+			}
+		}
+		const fyStart = Math.max(1, Math.min(12, Math.floor(rawFyStart)));
+		const calendarQuarter = Math.ceil(dt.month / 3);
+		const monthInFY = (dt.month - fyStart + 12) % 12;
+		const fiscalQuarter = Math.floor(monthInFY / 3) + 1;
+		const fiscalYear = dt.month >= fyStart ? dt.year : dt.year - 1;
+		const firstOfMonth = dt.startOf("month");
+		const weekOfMonth = Math.ceil((dt.day + firstOfMonth.weekday - 1) / 7);
+		const dayOfYear = Math.floor(dt.diff(dt.startOf("year"), "days").days) + 1;
+		const isWeekend = dt.weekday >= 6;
+		return [
+			`Date: ${dt.toISODate()} (${dt.toFormat("cccc, LLLL d, yyyy")})`,
+			"",
+			`ISO week number: ${dt.weekNumber} (ISO year: ${dt.weekYear})`,
+			`Day of year: ${dayOfYear} / ${dt.daysInYear}`,
+			`Day of week: ${dt.weekday} (${dt.toFormat("cccc")})`,
+			`Week of month: ${weekOfMonth}`,
+			`Weekend: ${isWeekend ? "Yes" : "No"}`,
+			"",
+			`Calendar quarter: Q${calendarQuarter}`,
+			`Fiscal quarter: FQ${fiscalQuarter} (FY${fiscalYear}${fyStart !== 1 ? `, starts month ${fyStart}` : ""})`
+		].join("\n");
+	}
+});
+/**
+* Parse a date/time expression from natural language or common formats.
+*
+* @remarks
+* Examples: `"next Monday"`, `"March 5th"`, `"in 2 weeks"`, `"yesterday"`. Uses chrono-node for
+* relative parsing. `reference_date` overrides the "now" anchor.
+*/
+var dateParseTool = new Tool({
+	name: "date_parse",
+	description: "Parse a date/time string from natural language or common formats (\"next Monday\", \"March 5th\", \"in 2 weeks\", \"yesterday\"). Returns an ISO 8601 date.",
+	inputSchema: validator.object({
+		text: validator.string().required().description("Date/time expression to parse (natural language or structured)"),
+		reference_date: validator.string().optional().description("ISO date to treat as \"now\" for relative expressions (default: current time)"),
+		timezone: validator.string().optional().description("IANA timezone for the result (optional, defaults UTC)")
+	}),
+	handler: async (args) => {
+		const { text, reference_date: referenceDate, timezone } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		let refDate = /* @__PURE__ */ new Date();
+		if (referenceDate) {
+			refDate = new Date(referenceDate);
+			if (Number.isNaN(refDate.getTime())) return `Error: Invalid reference_date "${referenceDate}".`;
+		}
+		const parsed = chrono.parseDate(text, refDate);
+		if (!parsed) return `Error: Could not parse a date from "${text}".`;
+		const dt = DateTime.fromJSDate(parsed).setZone(zone);
+		return `ISO: ${dt.toISO()}\nFormatted: ${dt.toFormat("cccc, LLLL d, yyyy h:mm a ZZZZ")}`;
+	}
+});
+/**
+* Get the start or end of a time period containing a given date.
+*
+* @remarks
+* Periods: `day`, `week`, `isoweek` (Monday-start), `month`, `quarter`, `year`. Quarter and year
+* honour `fiscal_year_start_month` for fiscal calendars (default: 1 = calendar year).
+*/
+var datePeriodTool = new Tool({
+	name: "date_period",
+	description: "Get the start or end of a time period (day, week, month, quarter, year) containing a given date. Supports fiscal year offsets.",
+	inputSchema: validator.object({
+		date: validator.string().required().description("ISO 8601 date or \"now\""),
+		period: validator.string().valid("day", "week", "isoweek", "month", "quarter", "year").required().description("Time period (isoweek = Monday-start week)"),
+		boundary: validator.string().valid("start", "end").required().description("\"start\" for the first moment, \"end\" for the last moment of the period"),
+		timezone: validator.string().optional().description("IANA timezone (optional, defaults UTC)"),
+		fiscal_year_start_month: validator.number().default(1).description("For quarter/year: month number when the fiscal year starts (1–12, default: 1 = calendar year)")
+	}),
+	handler: async (args) => {
+		const { date: dateStr, period, boundary, timezone, fiscal_year_start_month: rawFyStart } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		const dt = dateStr.toLowerCase() === "now" ? DateTime.now().setZone(zone) : DateTime.fromISO(dateStr, { zone });
+		if (!dt.isValid) return `Error: Invalid date "${dateStr}".`;
+		const fyStart = Math.max(1, Math.min(12, Math.floor(rawFyStart)));
+		let result;
+		switch (period) {
+			case "day":
+				result = boundary === "start" ? dt.startOf("day") : dt.endOf("day");
+				break;
+			case "week":
+				result = boundary === "start" ? dt.startOf("week") : dt.endOf("week");
+				break;
+			case "isoweek":
+				result = boundary === "start" ? dt.startOf("week").set({ weekday: 1 }) : dt.startOf("week").set({ weekday: 7 }).endOf("day");
+				break;
+			case "month":
+				result = boundary === "start" ? dt.startOf("month") : dt.endOf("month");
+				break;
+			case "quarter": {
+				const monthInFY = (dt.month - fyStart + 12) % 12;
+				const qStartMonth = (Math.floor(monthInFY / 3) * 3 + fyStart - 1) % 12 + 1;
+				const qStart = dt.set({
+					month: qStartMonth,
+					day: 1
+				}).startOf("day");
+				const adjusted = qStart > dt ? qStart.minus({ months: 3 }) : qStart;
+				result = boundary === "start" ? adjusted : adjusted.plus({ months: 3 }).minus({ days: 1 }).endOf("day");
+				break;
+			}
+			case "year":
+				if (fyStart === 1) result = boundary === "start" ? dt.startOf("year") : dt.endOf("year");
+				else {
+					const fyStartThis = dt.set({
+						month: fyStart,
+						day: 1
+					}).startOf("day");
+					const fyBase = dt >= fyStartThis ? fyStartThis : fyStartThis.minus({ years: 1 });
+					result = boundary === "start" ? fyBase : fyBase.plus({ years: 1 }).minus({ days: 1 }).endOf("day");
+				}
+				break;
+		}
+		return `${boundary === "start" ? "Start" : "End"} of ${period} containing ${dateStr}: ${result.toISO()}\nFormatted: ${result.toFormat("cccc, LLLL d, yyyy h:mm:ss a ZZZZ")}`;
+	}
+});
+/**
+* Count business days between two dates, or compute the date N business days away.
+*
+* @remarks
+* Monday–Friday only; no holiday calendar awareness. Provide either `to` (count between) or
+* `add_days` (compute target date). Negative `add_days` walks backwards.
+*/
+var dateBusinessDaysTool = new Tool({
+	name: "date_business_days",
+	description: "Count business days (Mon–Fri, no holiday awareness) between two dates, or calculate the date that is N business days from a start date.",
+	inputSchema: validator.object({
+		from: validator.string().required().description("Start date (ISO 8601 or \"now\")"),
+		to: validator.string().optional().description("End date (ISO 8601 or \"now\") — for counting business days between two dates"),
+		add_days: validator.number().optional().description("Instead of \"to\": number of business days to add (negative to subtract)"),
+		timezone: validator.string().optional().description("IANA timezone (optional, defaults UTC)")
+	}),
+	handler: async (args) => {
+		const { from: fromStr, to: toStr, add_days: addDays, timezone } = args;
+		const { zone, error: zoneError } = resolveZone(timezone);
+		if (zoneError) return `Error: ${zoneError}`;
+		const fromDt = (fromStr.toLowerCase() === "now" ? DateTime.now() : DateTime.fromISO(fromStr)).setZone(zone);
+		if (!fromDt.isValid) return `Error: Invalid from date "${fromStr}".`;
+		if (addDays !== void 0) {
+			const n = Math.floor(addDays);
+			let cursor = fromDt.startOf("day");
+			let remaining = Math.abs(n);
+			const dir = n >= 0 ? 1 : -1;
+			while (remaining > 0) {
+				cursor = cursor.plus({ days: dir });
+				if (cursor.weekday <= 5) remaining--;
+			}
+			return `${n >= 0 ? "+" : ""}${n} business day${Math.abs(n) !== 1 ? "s" : ""} from ${fromStr}: ${cursor.toISODate()}\nFormatted: ${cursor.toFormat("cccc, LLLL d, yyyy")}`;
+		}
+		if (!toStr) return "Error: Provide either \"to\" date or \"add_days\".";
+		const toDt = (toStr.toLowerCase() === "now" ? DateTime.now() : DateTime.fromISO(toStr)).setZone(zone);
+		if (!toDt.isValid) return `Error: Invalid to date "${toStr}".`;
+		return `Business days from ${fromStr} to ${toStr}: ${countBusinessDays(fromDt, toDt)}`;
+	}
+});
+//#endregion
+export { dateBusinessDaysTool, dateCalendarInfoTool, dateNthWeekdayTool, dateParseTool, datePeriodTool };
+
+//# sourceMappingURL=datetime_extended.mjs.map

package/batteries/tools/datetime_extended.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime_extended.mjs","names":[],"sources":["../../../src/batteries/tools/datetime_extended/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for parsing natural-language dates and business-calendar calculations.\n *\n * @module @nhtio/adk/batteries/tools/datetime_extended\n *\n * @remarks\n * Pre-constructed bundled tools for the `datetime_extended` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport * as chrono from 'chrono-node'\nimport { Tool } from '@nhtio/adk/common'\nimport { DateTime, IANAZone } from 'luxon'\nimport { validator } from '@nhtio/validation'\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 countBusinessDays(from: DateTime, to: DateTime): number {\n  const forward = to >= from\n  const start = forward ? from.startOf('day') : to.startOf('day')\n  const end = forward ? to.startOf('day') : from.startOf('day')\n\n  const totalDays = Math.round(end.diff(start, 'days').days)\n  const fullWeeks = Math.floor(totalDays / 7)\n  let bdays = fullWeeks * 5\n\n  let cursor = start.plus({ days: fullWeeks * 7 })\n  while (cursor < end) {\n    cursor = cursor.plus({ days: 1 })\n    if (cursor.weekday <= 5) bdays++\n  }\n\n  return forward ? bdays : -bdays\n}\n\n/**\n * Find the Nth occurrence of a weekday in a given month.\n *\n * @remarks\n * Examples: \"2nd Friday of March 2026\", \"last Monday of January 2025\". Accepts 1st–5th and\n * `last`. Returns an error if the month does not contain that many occurrences of the weekday.\n */\nexport const dateNthWeekdayTool = new Tool({\n  name: 'date_nth_weekday',\n  description:\n    'Find the Nth occurrence of a weekday in a given month (e.g., \"2nd Friday of March 2026\", \"last Monday of next month\"). Supports 1st–5th and \"last\".',\n  inputSchema: validator.object({\n    nth: validator\n      .string()\n      .required()\n      .description('Which occurrence: \"1st\", \"2nd\", \"3rd\", \"4th\", \"5th\", or \"last\".'),\n    weekday: validator\n      .string()\n      .valid('monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday')\n      .required()\n      .description('Day of the week.'),\n    month: validator.number().required().description('Month number (1–12).'),\n    year: validator.number().optional().description('Year (defaults to current year).'),\n    timezone: validator.string().optional().description('IANA timezone (optional, defaults UTC).'),\n  }),\n  handler: async (args) => {\n    const {\n      nth,\n      weekday,\n      month: rawMonth,\n      year: rawYear,\n      timezone,\n    } = args as {\n      nth: string\n      weekday: string\n      month: number\n      year?: number\n      timezone?: string\n    }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    const weekdayNames: Record<string, number> = {\n      monday: 1,\n      tuesday: 2,\n      wednesday: 3,\n      thursday: 4,\n      friday: 5,\n      saturday: 6,\n      sunday: 7,\n    }\n\n    const targetWeekday = weekdayNames[weekday.toLowerCase()]\n    const month = Math.floor(rawMonth)\n    if (month < 1 || month > 12) return `Error: Month must be 1–12, got ${rawMonth}.`\n\n    const year = Math.floor(rawYear ?? DateTime.now().setZone(zone).year)\n    const nthRaw = nth.toLowerCase().replace(/\\s/g, '')\n\n    const firstOfMonth = DateTime.fromObject({ year, month, day: 1 }, { zone })\n    if (!firstOfMonth.isValid) return `Error: Invalid date for ${year}-${month}.`\n\n    const occurrences: DateTime[] = []\n    let cursor = firstOfMonth\n    while (cursor.weekday !== targetWeekday) {\n      cursor = cursor.plus({ days: 1 })\n    }\n    while (cursor.month === month) {\n      occurrences.push(cursor)\n      cursor = cursor.plus({ weeks: 1 })\n    }\n\n    let result: DateTime | undefined\n\n    if (nthRaw === 'last') {\n      result = occurrences[occurrences.length - 1]\n    } else {\n      const nthMap: Record<string, number> = {\n        '1st': 1,\n        '1': 1,\n        'first': 1,\n        '2nd': 2,\n        '2': 2,\n        'second': 2,\n        '3rd': 3,\n        '3': 3,\n        'third': 3,\n        '4th': 4,\n        '4': 4,\n        'fourth': 4,\n        '5th': 5,\n        '5': 5,\n        'fifth': 5,\n      }\n      const n = nthMap[nthRaw]\n      if (!n) return `Error: Invalid nth value \"${nth}\". Use 1st–5th or \"last\".`\n      if (n > occurrences.length) {\n        return `Error: There is no ${nth} ${weekday} in ${firstOfMonth.toFormat('LLLL yyyy')} (only ${occurrences.length} occurrence${occurrences.length !== 1 ? 's' : ''}).`\n      }\n      result = occurrences[n - 1]\n    }\n\n    if (!result) return 'Error: Could not compute the date.'\n\n    return `${nth} ${weekday} of ${result.toFormat('LLLL yyyy')}: ${result.toISODate()}\\nFormatted: ${result.toFormat('cccc, LLLL d, yyyy')}`\n  },\n})\n\n/**\n * Get calendar metadata for a date.\n *\n * @remarks\n * Reports ISO week number, day of year, calendar quarter, fiscal quarter/year (configurable via\n * `fiscal_year_start_month`), week of month, and whether the date is a weekend. Accepts ISO\n * dates, natural-language (\"next Tuesday\"), and `now`.\n */\nexport const dateCalendarInfoTool = new Tool({\n  name: 'date_calendar_info',\n  description:\n    'Get calendar metadata for a date: ISO week number, day of year, calendar quarter, fiscal quarter/year, week of month, and whether it is a weekend or weekday.',\n  inputSchema: validator.object({\n    date: validator\n      .string()\n      .required()\n      .description('ISO 8601 date, natural language date, or \"now\".'),\n    timezone: validator.string().optional().description('IANA timezone (optional, defaults UTC).'),\n    fiscal_year_start_month: validator\n      .number()\n      .default(1)\n      .description('Month when fiscal year starts (1–12, default: 1 = calendar year).'),\n  }),\n  handler: async (args) => {\n    const {\n      date: dateStr,\n      timezone,\n      fiscal_year_start_month: rawFyStart,\n    } = args as {\n      date: string\n      timezone?: string\n      fiscal_year_start_month: number\n    }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    let dt: DateTime\n\n    if (dateStr.toLowerCase() === 'now') {\n      dt = DateTime.now().setZone(zone)\n    } else {\n      dt = DateTime.fromISO(dateStr, { zone })\n      if (!dt.isValid) {\n        const parsed = chrono.parseDate(dateStr, new Date())\n        if (!parsed) return `Error: Could not parse date \"${dateStr}\".`\n        dt = DateTime.fromJSDate(parsed).setZone(zone)\n      }\n    }\n\n    const fyStart = Math.max(1, Math.min(12, Math.floor(rawFyStart)))\n\n    const calendarQuarter = Math.ceil(dt.month / 3)\n\n    const monthInFY = (dt.month - fyStart + 12) % 12\n    const fiscalQuarter = Math.floor(monthInFY / 3) + 1\n    const fiscalYear = dt.month >= fyStart ? dt.year : dt.year - 1\n\n    const firstOfMonth = dt.startOf('month')\n    const weekOfMonth = Math.ceil((dt.day + firstOfMonth.weekday - 1) / 7)\n\n    const dayOfYear = Math.floor(dt.diff(dt.startOf('year'), 'days').days) + 1\n\n    const isWeekend = dt.weekday >= 6\n\n    const lines = [\n      `Date: ${dt.toISODate()} (${dt.toFormat('cccc, LLLL d, yyyy')})`,\n      '',\n      `ISO week number: ${dt.weekNumber} (ISO year: ${dt.weekYear})`,\n      `Day of year: ${dayOfYear} / ${dt.daysInYear}`,\n      `Day of week: ${dt.weekday} (${dt.toFormat('cccc')})`,\n      `Week of month: ${weekOfMonth}`,\n      `Weekend: ${isWeekend ? 'Yes' : 'No'}`,\n      '',\n      `Calendar quarter: Q${calendarQuarter}`,\n      `Fiscal quarter: FQ${fiscalQuarter} (FY${fiscalYear}${fyStart !== 1 ? `, starts month ${fyStart}` : ''})`,\n    ]\n\n    return lines.join('\\n')\n  },\n})\n\n/**\n * Parse a date/time expression from natural language or common formats.\n *\n * @remarks\n * Examples: `\"next Monday\"`, `\"March 5th\"`, `\"in 2 weeks\"`, `\"yesterday\"`. Uses chrono-node for\n * relative parsing. `reference_date` overrides the \"now\" anchor.\n */\nexport const dateParseTool = new Tool({\n  name: 'date_parse',\n  description:\n    'Parse a date/time string from natural language or common formats (\"next Monday\", \"March 5th\", \"in 2 weeks\", \"yesterday\"). Returns an ISO 8601 date.',\n  inputSchema: validator.object({\n    text: validator\n      .string()\n      .required()\n      .description('Date/time expression to parse (natural language or structured)'),\n    reference_date: validator\n      .string()\n      .optional()\n      .description('ISO date to treat as \"now\" for relative expressions (default: current time)'),\n    timezone: validator\n      .string()\n      .optional()\n      .description('IANA timezone for the result (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const {\n      text,\n      reference_date: referenceDate,\n      timezone,\n    } = args as {\n      text: string\n      reference_date?: string\n      timezone?: string\n    }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    let refDate = new Date()\n    if (referenceDate) {\n      refDate = new Date(referenceDate)\n      if (Number.isNaN(refDate.getTime()))\n        return `Error: Invalid reference_date \"${referenceDate}\".`\n    }\n\n    const parsed = chrono.parseDate(text, refDate)\n    if (!parsed) return `Error: Could not parse a date from \"${text}\".`\n\n    const dt = DateTime.fromJSDate(parsed).setZone(zone)\n    return `ISO: ${dt.toISO()}\\nFormatted: ${dt.toFormat('cccc, LLLL d, yyyy h:mm a ZZZZ')}`\n  },\n})\n\n/**\n * Get the start or end of a time period containing a given date.\n *\n * @remarks\n * Periods: `day`, `week`, `isoweek` (Monday-start), `month`, `quarter`, `year`. Quarter and year\n * honour `fiscal_year_start_month` for fiscal calendars (default: 1 = calendar year).\n */\nexport const datePeriodTool = new Tool({\n  name: 'date_period',\n  description:\n    'Get the start or end of a time period (day, week, month, quarter, year) containing a given date. Supports fiscal year offsets.',\n  inputSchema: validator.object({\n    date: validator.string().required().description('ISO 8601 date or \"now\"'),\n    period: validator\n      .string()\n      .valid('day', 'week', 'isoweek', 'month', 'quarter', 'year')\n      .required()\n      .description('Time period (isoweek = Monday-start week)'),\n    boundary: validator\n      .string()\n      .valid('start', 'end')\n      .required()\n      .description('\"start\" for the first moment, \"end\" for the last moment of the period'),\n    timezone: validator.string().optional().description('IANA timezone (optional, defaults UTC)'),\n    fiscal_year_start_month: validator\n      .number()\n      .default(1)\n      .description(\n        'For quarter/year: month number when the fiscal year starts (1–12, default: 1 = calendar year)'\n      ),\n  }),\n  handler: async (args) => {\n    const {\n      date: dateStr,\n      period,\n      boundary,\n      timezone,\n      fiscal_year_start_month: rawFyStart,\n    } = args as {\n      date: string\n      period: 'day' | 'week' | 'isoweek' | 'month' | 'quarter' | 'year'\n      boundary: 'start' | 'end'\n      timezone?: string\n      fiscal_year_start_month: number\n    }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    const dt =\n      dateStr.toLowerCase() === 'now'\n        ? DateTime.now().setZone(zone)\n        : DateTime.fromISO(dateStr, { zone })\n    if (!dt.isValid) return `Error: Invalid date \"${dateStr}\".`\n\n    const fyStart = Math.max(1, Math.min(12, Math.floor(rawFyStart)))\n\n    let result: DateTime\n\n    switch (period) {\n      case 'day':\n        result = boundary === 'start' ? dt.startOf('day') : dt.endOf('day')\n        break\n      case 'week':\n        result = boundary === 'start' ? dt.startOf('week') : dt.endOf('week')\n        break\n      case 'isoweek':\n        result =\n          boundary === 'start'\n            ? dt.startOf('week').set({ weekday: 1 })\n            : dt.startOf('week').set({ weekday: 7 }).endOf('day')\n        break\n      case 'month':\n        result = boundary === 'start' ? dt.startOf('month') : dt.endOf('month')\n        break\n      case 'quarter': {\n        const monthInFY = (dt.month - fyStart + 12) % 12\n        const qIndex = Math.floor(monthInFY / 3)\n        const qStartMonth = ((qIndex * 3 + fyStart - 1) % 12) + 1\n        const qStart = dt.set({ month: qStartMonth, day: 1 }).startOf('day')\n        const adjusted = qStart > dt ? qStart.minus({ months: 3 }) : qStart\n        result =\n          boundary === 'start'\n            ? adjusted\n            : adjusted.plus({ months: 3 }).minus({ days: 1 }).endOf('day')\n        break\n      }\n      case 'year':\n        if (fyStart === 1) {\n          result = boundary === 'start' ? dt.startOf('year') : dt.endOf('year')\n        } else {\n          const fyStartThis = dt.set({ month: fyStart, day: 1 }).startOf('day')\n          const fyBase = dt >= fyStartThis ? fyStartThis : fyStartThis.minus({ years: 1 })\n          result =\n            boundary === 'start'\n              ? fyBase\n              : fyBase.plus({ years: 1 }).minus({ days: 1 }).endOf('day')\n        }\n        break\n    }\n\n    return `${boundary === 'start' ? 'Start' : 'End'} of ${period} containing ${dateStr}: ${result.toISO()}\\nFormatted: ${result.toFormat('cccc, LLLL d, yyyy h:mm:ss a ZZZZ')}`\n  },\n})\n\n/**\n * Count business days between two dates, or compute the date N business days away.\n *\n * @remarks\n * Monday–Friday only; no holiday calendar awareness. Provide either `to` (count between) or\n * `add_days` (compute target date). Negative `add_days` walks backwards.\n */\nexport const dateBusinessDaysTool = new Tool({\n  name: 'date_business_days',\n  description:\n    'Count business days (Mon–Fri, no holiday awareness) between two dates, or calculate the date that is N business days from a start date.',\n  inputSchema: validator.object({\n    from: validator.string().required().description('Start date (ISO 8601 or \"now\")'),\n    to: validator\n      .string()\n      .optional()\n      .description('End date (ISO 8601 or \"now\") — for counting business days between two dates'),\n    add_days: validator\n      .number()\n      .optional()\n      .description('Instead of \"to\": number of business days to add (negative to subtract)'),\n    timezone: validator.string().optional().description('IANA timezone (optional, defaults UTC)'),\n  }),\n  handler: async (args) => {\n    const {\n      from: fromStr,\n      to: toStr,\n      add_days: addDays,\n      timezone,\n    } = args as {\n      from: string\n      to?: string\n      add_days?: number\n      timezone?: string\n    }\n    const { zone, error: zoneError } = resolveZone(timezone)\n    if (zoneError) return `Error: ${zoneError}`\n\n    const fromDt = (\n      fromStr.toLowerCase() === 'now' ? DateTime.now() : DateTime.fromISO(fromStr)\n    ).setZone(zone)\n    if (!fromDt.isValid) return `Error: Invalid from date \"${fromStr}\".`\n\n    if (addDays !== undefined) {\n      const n = Math.floor(addDays)\n      let cursor = fromDt.startOf('day')\n      let remaining = Math.abs(n)\n      const dir = n >= 0 ? 1 : -1\n      while (remaining > 0) {\n        cursor = cursor.plus({ days: dir })\n        if (cursor.weekday <= 5) remaining--\n      }\n      return `${n >= 0 ? '+' : ''}${n} business day${Math.abs(n) !== 1 ? 's' : ''} from ${fromStr}: ${cursor.toISODate()}\\nFormatted: ${cursor.toFormat('cccc, LLLL d, yyyy')}`\n    }\n\n    if (!toStr) return 'Error: Provide either \"to\" date or \"add_days\".'\n\n    const toDt = (toStr.toLowerCase() === 'now' ? DateTime.now() : DateTime.fromISO(toStr)).setZone(\n      zone\n    )\n    if (!toDt.isValid) return `Error: Invalid to date \"${toStr}\".`\n\n    const count = countBusinessDays(fromDt, toDt)\n    return `Business days from ${fromStr} to ${toStr}: ${count}`\n  },\n})\n"],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+/**
+ * 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`.
+ */
+import { Tool } from "../../../common";
+/**
+ * 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.
+ */
+export declare const dateAddTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * 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.
+ */
+export declare const dateDiffTool: Tool<import("../../../common").SpooledArtifact>;
+/**
+ * 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`.
+ */
+export declare const durationFormatTool: Tool<import("../../../common").SpooledArtifact>;

package/batteries/tools/datetime_math.cjs

@@ -0,0 +1,175 @@
+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/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 (!luxon.IANAZone.isValidZone(timezone)) return {
+		zone: "",
+		error: `Invalid timezone "${timezone}".`
+	};
+	return { zone: timezone };
+}
+function parseDate(input, zone) {
+	if (input.toLowerCase() === "now") return luxon.DateTime.now().setZone(zone);
+	const dt = luxon.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 require_tool.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: _nhtio_validation.validator.object({
+		date: _nhtio_validation.validator.string().required().description("ISO 8601 date/datetime string or \"now\""),
+		direction: _nhtio_validation.validator.string().valid("add", "subtract").required().description("\"add\" to move forward in time, \"subtract\" to move backward"),
+		years: _nhtio_validation.validator.number().default(0).description("Years component (optional)"),
+		months: _nhtio_validation.validator.number().default(0).description("Months component (optional)"),
+		weeks: _nhtio_validation.validator.number().default(0).description("Weeks component (optional)"),
+		days: _nhtio_validation.validator.number().default(0).description("Days component (optional)"),
+		hours: _nhtio_validation.validator.number().default(0).description("Hours component (optional)"),
+		minutes: _nhtio_validation.validator.number().default(0).description("Minutes component (optional)"),
+		seconds: _nhtio_validation.validator.number().default(0).description("Seconds component (optional)"),
+		timezone: _nhtio_validation.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 = luxon.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 require_tool.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: _nhtio_validation.validator.object({
+		from: _nhtio_validation.validator.string().required().description("Start date (ISO 8601 or \"now\")"),
+		to: _nhtio_validation.validator.string().required().description("End date (ISO 8601 or \"now\")"),
+		unit: _nhtio_validation.validator.string().valid("years", "months", "weeks", "days", "hours", "minutes", "seconds").required().description("Unit to express the difference in"),
+		timezone: _nhtio_validation.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 require_tool.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: _nhtio_validation.validator.object({ seconds: _nhtio_validation.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 = luxon.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
+exports.dateAddTool = dateAddTool;
+exports.dateDiffTool = dateDiffTool;
+exports.durationFormatTool = durationFormatTool;
+
+//# sourceMappingURL=datetime_math.cjs.map

package/batteries/tools/datetime_math.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime_math.cjs","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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"}