import type { RuntimeEngine, EntityInstance } from '../runtime-engine.js';
export interface SerializedRuntimeSnapshot {
    ir: unknown;
    stores: Record<string, EntityInstance[]>;
    context?: Record<string, unknown>;
}
export interface CommandTraceStep {
    index: number;
    label: string;
    snapshot: SerializedRuntimeSnapshot;
}
/**
 * Records store snapshots around command execution for step replay via
 * RuntimeEngine.restore(). v1 captures before/after the full command; optional
 * per-action steps when actionTraceHook is wired on RuntimeOptions.
 */
export declare class CommandTraceRecorder {
    private readonly engine;
    private steps;
    private actionIndex;
    constructor(engine: RuntimeEngine);
    runCommand(commandName: string, input: Record<string, unknown>, options?: {
        entityName?: string;
        instanceId?: string;
    }): Promise<import("../runtime-engine.js").CommandResult>;
    getSteps(): readonly CommandTraceStep[];
    restoreToStep(stepIndex: number): Promise<void>;
    /** Register on RuntimeOptions.actionTraceHook to capture per-action snapshots. */
    createActionHook(): (info: {
        index: number;
        kind: string;
        target?: string;
        entityName?: string;
        instanceId?: string;
    }) => Promise<void>;
}
//# sourceMappingURL=command-trace.d.ts.map