/** * 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`. */ import { Tool } from "../../../common"; /** * 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. */ export declare const dateNthWeekdayTool: Tool; /** * 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`. */ export declare const dateCalendarInfoTool: Tool; /** * 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. */ export declare const dateParseTool: Tool; /** * 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). */ export declare const datePeriodTool: Tool; /** * 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. */ export declare const dateBusinessDaysTool: Tool;