export type ErrorKind = 'expected' | 'validation' | 'auth' | 'not_found' | 'conflict' | 'canceled' | 'internal';
export type ErrorContext = {
    runId?: string;
    auditLogPath?: string;
};
export type SilvanErrorOptions = {
    code: string;
    message: string;
    userMessage?: string;
    kind?: ErrorKind;
    exitCode?: number;
    details?: Record<string, unknown>;
    nextSteps?: string[];
    cause?: unknown;
    context?: ErrorContext;
};
export declare class SilvanError extends Error {
    code: string;
    kind: ErrorKind;
    userMessage: string;
    exitCode: number;
    details?: Record<string, unknown>;
    nextSteps?: string[];
    cause?: unknown;
    runId?: string;
    auditLogPath?: string;
    constructor(options: SilvanErrorOptions);
}
export declare class RunCanceledError extends Error {
    constructor();
}
export declare function normalizeError(error: unknown, context?: ErrorContext): SilvanError;