/**
 * Sleep effect — parse human-friendly durations, create sleep effects,
 * and check expiry (TOOLS-028).
 *
 * Supports duration strings: "30s", "5m", "2h", "1d"
 * and ISO 8601 timestamps: "2026-06-03T15:30:00Z"
 */
export interface SleepTarget {
    /** When the sleep expires (epoch ms). */
    wakeAt: number;
    /** Original input string. */
    raw: string;
    /** Whether the input was an ISO timestamp (vs. relative duration). */
    isAbsolute: boolean;
}
export interface SleepEffect {
    kind: 'sleep';
    wakeAt: number;
    raw: string;
    createdAt: number;
}
/**
 * Parse a sleep target from a human-friendly string.
 *
 * Accepted formats:
 *  - Relative: "30s", "5m", "2h", "1d" (with optional verbose units)
 *  - Absolute: any ISO 8601 date string parseable by `Date.parse`
 *
 * Returns `undefined` if the string cannot be parsed.
 */
export declare function parseSleepTarget(input: string, now?: number): SleepTarget | undefined;
/**
 * Create a sleep effect from a parsed target.
 */
export declare function createSleepEffect(target: SleepTarget, now?: number): SleepEffect;
/**
 * Return true if the sleep effect has expired (the wake time has passed).
 */
export declare function isExpired(effect: SleepEffect, now?: number): boolean;
//# sourceMappingURL=sleepEffect.d.ts.map