import type { TimerSnapshot, TimerTick } from "./types.ts"; /** * Build the synthetic message injected for one timer tick. * * The original instruction is repeated verbatim because compaction may remove * the tool call that created the timer. The trailing guidance is deliberately * short: the model should act, report, and optionally persist a snapshot, not * re-read a status dump. * * @example * ```ts * formatTick({ timer, run: 1, scheduledAt: Date.now() }) * // [Timer: watch deploy ยท tick #1] * // * // Check whether the deploy finished. * // * // Do that again and report back. ... * ``` */ export declare function formatTick(tick: TimerTick): string; /** Result text for a successful `timer_start` call. */ export declare function formatStart(timer: TimerSnapshot, now?: number, replaced?: TimerSnapshot): string; /** Result text for a successful `timer_stop` call. */ export declare function formatStop(timer: TimerSnapshot): string; /** * Human-readable status for `timer_status`. * * Uses ISO timestamps so output is unambiguous regardless of server timezone; * the relative "in ..." suffix gives the practical answer. */ export declare function formatStatus(timer: TimerSnapshot | undefined, now?: number): string; /** * Format a whole number of seconds without relying on locale output. * * @example * ```ts * formatDuration(45) // "45s" * formatDuration(300) // "5m" * formatDuration(3720) // "1h 2m" * ``` */ export declare function formatDuration(seconds: number): string; /** Format a millisecond delta as a short countdown. */ export declare function formatRemaining(ms: number): string; /** ISO timestamp for status output. */ export declare function formatTimestamp(ms: number): string; //# sourceMappingURL=format.d.ts.map