#!/usr/bin/env node
import { Command } from 'commander';
import type { ProgressEvent } from './opcode-runner.js';
export declare const program: Command;
type CloudCheckpointType = 'preset_progress' | 'upload_start' | 'upload_end';
/** Interval below which consecutive `granular` checkpoints are coalesced. */
export declare const GRANULAR_CHECKPOINT_THROTTLE_MS = 1200;
export declare function cloudCaptureProgressCheckpoint(event: ProgressEvent): {
    type: CloudCheckpointType;
    message: string;
    status?: 'running';
    /** Fine-grained intra-preset event (per-opcode / per-narration) — throttled
     *  so a long video's step stream can't bury the coarse structural events in
     *  the server's bounded timeline window. Structural events are never marked. */
    granular?: boolean;
} | null;
/**
 * Stateful gate that admits at most one `granular` checkpoint per throttle
 * window; structural (non-granular) checkpoints always pass. Create one per
 * preset so each preset streams its own opcode/narration cadence. `now` is
 * injectable for tests.
 */
export declare function createGranularCheckpointThrottle(throttleMs?: number, now?: () => number): (granular: boolean) => boolean;
export {};