/**
 * `zod` — schema atoms, pagination, and tool-annotation helpers shared across
 * the MCP fleet. Intentionally small: atoms + annotations, not a schema
 * framework. Built on zod v4.
 *
 * The raw-shape style (`inputSchema: { foo: z.string() }`) used by
 * `server.registerTool` is preserved — these atoms are plain `ZodType`s you
 * drop straight into a shape object.
 */
import { z } from 'zod';
/** A strictly positive integer (`> 0`). */
export declare const PositiveInt: z.ZodNumber;
/** A non-negative integer (`>= 0`). */
export declare const NonNegInt: z.ZodNumber;
/** A non-empty string (after no trimming — at least one character). */
export declare const NonEmptyString: z.ZodString;
/**
 * An ISO calendar date, `YYYY-MM-DD`. Rejects impossible dates (e.g.
 * `2026-13-01`) via zod v4's `z.iso.date()`.
 */
export declare const IsoDate: z.ZodISODate;
/**
 * A 24-hour wall-clock time `HH:MM` (no seconds, no offset). This is the
 * fleet convention (resy notify/book, slot windows) — restaurant-local times
 * carried as bare `HH:MM`, never parsed through `Date` so they aren't shifted
 * by the server's timezone. Accepts `9:05` and `09:05`; rejects `24:00`,
 * `19:60`, and anything with seconds.
 */
export declare const IsoTime: z.ZodString;
/**
 * A bare numeric id as a string, e.g. App Store Connect's `1234567890`.
 * Exactly one-or-more ASCII digits — no signs, decimals, or whitespace.
 *
 * Use for ids that are interpolated into request paths so a non-numeric value
 * (or a traversal payload) can't slip through. (app-store-connect numeric ids.)
 */
export declare const NumericIdString: z.ZodString;
/**
 * A single, safe URL path segment: rejects the traversal / injection
 * characters `/`, `..`, `?`, `#`, and any whitespace. The fleet-standard
 * hardening for caller-supplied ids that get interpolated into request paths
 * (tempo account ids, ASC ids, gemini path ids) — defense-in-depth against
 * path traversal and query/fragment injection.
 *
 * This is a DENYLIST (`/^[^/?#\s]+$/` + no-`..`): it permits any character
 * except the traversal/injection set, so it's strictly less restrictive than a
 * per-id allowlist. Repos that hand-roll a stricter allowlist (e.g. tempo's
 * AccountId `/^[A-Za-z0-9:_.-]+$/`) should KEEP it rather than swap to this —
 * swapping would widen their accepted input. Use this atom for ids that have no
 * tighter character constraint; it's the floor, not a replacement for a
 * site-specific allowlist.
 */
export declare const SafePathSegment: z.ZodString;
/**
 * Optional portal-origin selector (e.g. `https://<vendor>.hbportal.co`).
 * Disambiguates which signed-in session a tool routes through when more than
 * one is active. Optional — when a single session is active it can be omitted.
 * (honeybook / disk-session MCPs)
 */
export declare const schemaOrigin: z.ZodOptional<z.ZodString>;
/**
 * The write-confirmation gate shared by mutating tools: without
 * `confirm: true` the tool returns a preview instead of performing the action.
 * (honeybook pay_invoice / sign_contract)
 */
export declare const schemaConfirm: z.ZodOptional<z.ZodBoolean>;
/**
 * Offset/limit pagination shape (raw, for spreading into an `inputSchema`).
 * `offset` defaults to 0, `limit` is bounded `1..200` and defaults to 50 —
 * the bounds standardized across the fleet's search tools.
 */
export declare const paginationSchema: {
    readonly offset: z.ZodDefault<z.ZodNumber>;
    readonly limit: z.ZodDefault<z.ZodNumber>;
};
/**
 * 1-based page pagination shape (`page_num` / `page_size`). `page_num`
 * defaults to 1, `page_size` is bounded `1..200` and defaults to 50.
 * Mirrors onehome-mcp's search pagination, normalized to 1-based.
 */
export declare const pageSchema: {
    readonly page_num: z.ZodDefault<z.ZodNumber>;
    readonly page_size: z.ZodDefault<z.ZodNumber>;
};
/**
 * Convert a 1-based page + page size into a zero-based offset.
 *
 * Defensive against bad callers: page and size are floored, page is clamped to
 * `>= 1` and size to `>= 0`, so the result is always a non-negative integer.
 *
 * @example calculateOffset(1, 50) // 0
 * @example calculateOffset(3, 50) // 100
 */
export declare function calculateOffset(page: number, size: number): number;
/** The MCP tool-annotation block, as consumed by `server.registerTool`. */
export interface ToolAnnotations {
    title?: string;
    readOnlyHint: boolean;
    idempotentHint?: boolean;
    openWorldHint?: boolean;
}
/** Options for {@link toolAnnotations}. */
export interface ToolAnnotationsInput {
    /** Human-readable tool title (shown in clients). Omitted from output when unset. */
    title?: string;
    /** Tool does not modify state. Default `true` (most fleet tools are reads). */
    readOnly?: boolean;
    /** Repeated identical calls have the same effect. Emitted ONLY when set. */
    idempotent?: boolean;
    /**
     * Tool reaches an open/unbounded external world (the live web/API) rather
     * than a closed local computation. Emitted ONLY when set.
     */
    openWorld?: boolean;
}
/**
 * Build the `annotations` block for `server.registerTool`. Only `readOnlyHint`
 * is always emitted (defaulting to `true` — most fleet tools are reads); `title`,
 * `idempotentHint`, and `openWorldHint` are emitted ONLY when you pass them. This
 * makes it a clean drop-in for the common `{ readOnlyHint: true }` shape without
 * injecting hints a tool didn't declare.
 *
 * @example toolAnnotations({ title: 'Search properties' })  // { title, readOnlyHint: true }
 * @example toolAnnotations({ readOnly: false })             // { readOnlyHint: false }
 * @example toolAnnotations({ title: 'Search', idempotent: true, openWorld: true })
 *   // { title, readOnlyHint: true, idempotentHint: true, openWorldHint: true }
 */
export declare function toolAnnotations(opts?: ToolAnnotationsInput): ToolAnnotations;
/**
 * Extract bare `HH:MM` from an ISO-ish datetime such as
 * `2026-05-01T19:00:00` or a wire time `19:00:00`. Deliberately avoids
 * `new Date()` so times aren't shifted by the server's timezone (resy returns
 * restaurant-local times with no offset). Returns `''` when no time is found.
 *
 * @example extractTime('2026-05-01T19:30:00') // '19:30'
 * @example extractTime('19:30:00')            // '19:30'
 * @example extractTime(undefined)             // ''
 */
export declare function extractTime(input: string | undefined | null): string;
/**
 * Normalize a loose caller-supplied time to canonical 24-hour `HH:MM`.
 *
 * Accepts:
 *  - `HH:MM` / `H:MM`           → zero-padded `HH:MM`
 *  - `HH:MM:SS`                 → seconds trimmed
 *  - `7pm`, `7:30 PM`, `12 am`  → 12h clock converted (12am→00, 12pm→12)
 *
 * Returns `undefined` when the input can't be understood, so callers can fall
 * through to a default rather than book at a garbage time.
 *
 * @example normalizeTime('7:30 PM') // '19:30'
 * @example normalizeTime('9:5')     // '09:05'
 * @example normalizeTime('12am')    // '00:00'
 * @example normalizeTime('nope')    // undefined
 */
export declare function normalizeTime(input: string | undefined | null): string | undefined;
export * from './parse-lenient.js';
//# sourceMappingURL=index.d.ts.map