import { type BuildDispatchCheckpoint, type BuildRunningAction, type BuildWorkerBudgetReservation } from "../core/buildExecution.js";
import type { RunPaths } from "./artifacts.js";
import type { GraphExecutionState } from "../core/scheduler.js";
import type { GraphCheckpointLease } from "../runtime/graphCheckpoint.js";
export interface BuildActionSettlement {
    outcome: "succeeded" | "failed";
    recordedAt: string;
    receipt?: unknown;
}
export interface BuildActionExecutor {
    /** Called only after the exact action intent is durable. */
    execute(action: Readonly<BuildRunningAction>, context?: Readonly<BuildActionExecutionContext>): Promise<BuildActionSettlement>;
    /** Called instead of execute whenever a crash left the action outcome uncertain. */
    reconcile(action: Readonly<BuildRunningAction>, context?: Readonly<BuildActionExecutionContext>): Promise<BuildActionSettlement | undefined>;
}
export interface BuildActionExecutionContext {
    workerBudgetReservation?: Readonly<BuildWorkerBudgetReservation>;
    graphState?: Readonly<GraphExecutionState>;
    signal?: AbortSignal;
}
export interface DurableBuildActionResult {
    checkpoint: Readonly<BuildDispatchCheckpoint>;
    ledgerHead: string;
    reconciled: boolean;
}
/**
 * Execute one inner BUILD effect beneath the scheduler's single outer BUILD
 * reservation. This append-only ledger never overwrites scheduler sideEffect;
 * the caller seals and binds the ledger head in the outer result receipt.
 */
export declare function executeDurableBuildAction(paths: RunPaths, actionValue: Readonly<BuildRunningAction>, executor: Readonly<BuildActionExecutor>, options: Readonly<{
    owner: Readonly<GraphCheckpointLease>;
    recordedAt: string;
    context?: Readonly<BuildActionExecutionContext>;
}>): Promise<DurableBuildActionResult>;