import type { EventBus } from '../kernel/events.js';
interface RequestLimitExtensionOptions {
    events: EventBus;
    sessionId?: string | undefined;
    currentIterations: number;
    currentLimit: number;
    /** When true (default), auto-grant 100 extra after giving listeners a tick to deny. */
    autoExtend: boolean;
    /** Timeout in ms before falling back to "0 extra" if no listener responds. */
    timeoutMs?: number | undefined;
}
/**
 * Emit `iteration.limit_reached` and wait for a listener to grant or
 * deny. Resolves with the number of extra iterations to grant (0 = stop).
 * When `autoExtend` is true the listener gets a `setImmediate` window to
 * react; otherwise the resolution stays open until the timer fires.
 *
 * Listener contract — **important for `autoExtend: true` callers**:
 *
 *   - `grant(extra)` and `deny()` must be invoked **synchronously** from
 *     the event listener (or earlier than the next `setImmediate` tick).
 *     The auto-grant path resolves to 100 inside `setImmediate`, so any
 *     async work between receiving the event and calling grant/deny will
 *     lose the race and the auto-grant wins.
 *
 *   - If you need to make an async decision (await a confirm dialog,
 *     query a remote policy), pass `autoExtend: false`. The promise will
 *     stay pending until the listener calls grant/deny or `timeoutMs`
 *     fires (default 30s).
 *
 *   - Multiple listeners are allowed but the first to call grant/deny
 *     wins; subsequent calls are no-ops.
 */
export declare function requestLimitExtension(opts: RequestLimitExtensionOptions): Promise<number>;
export {};
//# sourceMappingURL=iteration-limit.d.ts.map