import type { WorkflowExecutionEvent } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
import type { WorkflowEventStreamState } from "../../internal/store/workflow-execution-event-store.js";
import { type WaterfallEntry, type WaterfallScale } from "./derive-waterfall-entries.js";
export interface UseWaterfallEntriesOptions {
    /** Events ordered by sequence_number ascending. */
    readonly events: readonly WorkflowExecutionEvent[];
    /** Current stream lifecycle state. */
    readonly streamState: WorkflowEventStreamState;
    /** ISO 8601 timestamp of execution start. */
    readonly executionStartIso: string;
    /** Total execution duration in ms (for completed executions). */
    readonly executionDurationMs?: number;
}
export interface UseWaterfallEntriesReturn {
    /** Waterfall entries (one per task, ordered by start time). */
    readonly entries: readonly WaterfallEntry[];
    /** Time axis scale specification. */
    readonly scale: WaterfallScale;
    /** True when the execution is live (bars may be growing). */
    readonly isLive: boolean;
    /** Current elapsed ms from execution start (updates via rAF when live). */
    readonly nowMs: number;
}
export declare function useWaterfallEntries({ events, streamState, executionStartIso, executionDurationMs, }: UseWaterfallEntriesOptions): UseWaterfallEntriesReturn;
//# sourceMappingURL=useWaterfallEntries.d.ts.map