/**
 * Coded errors thrown by the store and CLI layers. Each class carries a stable
 * machine-readable `.code` so callers can branch on failure kind without
 * parsing human-readable messages.
 */
export declare class CodedError extends Error {
    readonly code: string;
    constructor(code: string, message: string);
}
export declare class LoopNotFoundError extends CodedError {
    constructor(idOrName: string);
}
export declare class LoopArchivedError extends CodedError {
    constructor(idOrName: string);
}
export declare class LoopAdvancementConflictError extends CodedError {
    constructor(loopId: string, runId: string);
}
export declare class LoopMutationConflictError extends CodedError {
    readonly reason: "revision_mismatch" | "binding_mismatch" | "lease_conflict";
    constructor(reason: "revision_mismatch" | "binding_mismatch" | "lease_conflict", targetId: string);
}
export type RunFinalizationConflictReason = "stale_claim" | "run_not_running";
export declare class RunFinalizationConflictError extends CodedError {
    readonly reason: RunFinalizationConflictReason;
    constructor(reason: RunFinalizationConflictReason, runId: string);
}
export declare class AmbiguousNameError extends CodedError {
    constructor(name: string);
}
export type AgentExtraArgsValidationReason = "not_array" | "invalid_array" | "invalid_item" | "option_not_allowed";
/**
 * Deliberately public, bounded validation metadata. API boundaries may expose
 * this object, but must never expose the accompanying Error.message.
 */
export interface PublicValidationDetails {
    code: "agent_extra_args_invalid";
    reason: AgentExtraArgsValidationReason;
    path: string;
    index?: number;
    option?: string;
}
export declare function publicValidationDetails(value: unknown): Readonly<PublicValidationDetails> | undefined;
export declare class ValidationError extends CodedError {
    readonly publicDetails?: Readonly<PublicValidationDetails>;
    constructor(message: string, publicDetails?: PublicValidationDetails);
}
/** Safely capture and re-project even forged/subclass validation errors. */
export declare function validationErrorPublicDetails(error: ValidationError): Readonly<PublicValidationDetails> | undefined;
export declare class DuplicateWorkflowEventError extends CodedError {
    constructor(workflowRunId: string, eventType: string, stepId?: string);
}
export declare class LegacyWorkflowRunProvenanceError extends CodedError {
    constructor(workflowRunId: string);
}
export declare class WorkflowRunDefinitionConflictError extends CodedError {
    constructor(workflowRunId: string);
}
export declare class WorkflowRunHasLiveStepsError extends CodedError {
    constructor();
}
export declare class WorkflowRunStepOwnershipUnverifiableError extends CodedError {
    constructor();
}
export declare class WorkflowRunNotRunningError extends CodedError {
    constructor();
}