/**
 * Effect timeline + pending-effects list + mock registry — the three
 * trackers that back the `llui_pending_effects`, `llui_effect_timeline`,
 * `llui_mock_effect`, and `llui_resolve_effect` MCP tools.
 *
 * Dev-only — populated when `installSignalDebug` runs. Zero cost in
 * production (the effect-dispatch path short-circuits when
 * `_effectTimeline` is undefined).
 *
 * The mock registry stores match-to-response pairs; the actual
 * response delivery (i.e., converting a mocked response back into a
 * Msg via the effect's `onSuccess` callback) is the responsibility of
 * the MCP `llui_resolve_effect` tool — not this module.
 */
import { createRingBuffer, type RingBuffer } from './each-diff.js';
export interface EffectTimelineEntry {
    effectId: string;
    type: string;
    phase: 'dispatched' | 'in-flight' | 'resolved' | 'resolved-mocked' | 'cancelled';
    timestamp: number;
    /** Populated on `resolved` / `resolved-mocked` / `cancelled` entries; undefined on open phases. */
    durationMs?: number;
}
export interface PendingEffect {
    id: string;
    type: string;
    dispatchedAt: number;
    status: 'queued' | 'in-flight';
    payload: unknown;
}
/**
 * Match predicate for the mock registry. All provided fields must
 * match for the mock to fire:
 * - `type`: exact-match against the effect's `type` discriminant.
 * - `payloadPath`: dotted path into the effect object (e.g. `'url'` or
 *   `'body.key'`). When present without `payloadEquals`, presence of
 *   the path is sufficient.
 * - `payloadEquals`: strict (`===`) equality check at `payloadPath`.
 *
 * An empty match (no fields) matches every effect — callers should
 * set at least `type` to avoid accidental catch-all.
 */
export interface EffectMatch {
    type?: string;
    payloadPath?: string;
    payloadEquals?: unknown;
}
export interface EffectMock {
    mockId: string;
    match: EffectMatch;
    response: unknown;
    /** When false, the mock is removed after the first match (one-shot). */
    persist: boolean;
}
export interface MockRegistry {
    add(match: EffectMatch, response: unknown, persist: boolean): string;
    match(effect: unknown): {
        response: unknown;
        mockId: string;
    } | null;
    clear(): void;
    list(): EffectMock[];
}
export declare function createMockRegistry(): MockRegistry;
export interface PendingEffectsList {
    push(p: PendingEffect): void;
    findById(id: string): PendingEffect | undefined;
    remove(id: string): void;
    list(): PendingEffect[];
}
export declare function createPendingEffectsList(): PendingEffectsList;
export { createRingBuffer, type RingBuffer };
//# sourceMappingURL=effect-timeline.d.ts.map