import type { CreateWorkflowInput, LoopTarget, WorkflowSpec } from "../../types.js";
import { CodedError } from "../errors.js";
import { preflightTarget } from "../executor.js";
import { preflightWorkflow } from "../workflow-runner.js";
/**
 * Validation/preflight gates shared by CLI commands and route engines. Failures
 * throw a `GateError` carrying the gate kind and structured context so the CLI
 * error runner can render the stable `{ok:false, created:false, ...}` JSON shape.
 */
export declare class GateError extends CodedError {
    readonly gate: "validation" | "preflight";
    readonly context: Record<string, unknown>;
    constructor(gate: "validation" | "preflight", message: string, context: Record<string, unknown>);
}
export declare function normalizeLoopTargetForStorage(target: unknown, context: Record<string, unknown>, opts?: {
    baseDir?: string;
}): Exclude<LoopTarget, {
    type: "workflow";
}>;
export declare function normalizeWorkflowForStorage(body: CreateWorkflowInput, context: Record<string, unknown>): CreateWorkflowInput;
export declare function workflowBodyFromFile(file: string, fallbackName: string | undefined, context: Record<string, unknown>): CreateWorkflowInput;
export declare function preflightLoopTarget(target: Exclude<LoopTarget, {
    type: "workflow";
}>, context: Record<string, unknown>, metadata: Parameters<typeof preflightTarget>[1], opts: Parameters<typeof preflightTarget>[2]): ReturnType<typeof preflightTarget>;
export declare function preflightStoredWorkflow(workflow: Parameters<typeof preflightWorkflow>[0], context: Record<string, unknown>, opts: Parameters<typeof preflightWorkflow>[1]): ReturnType<typeof preflightWorkflow>;
export declare function workflowSpecForPreflight(body: CreateWorkflowInput, id?: string): WorkflowSpec;