import type { JsonObject } from './types.js';
export type FabricErrorCode = 'AGENT_NOT_FOUND' | 'AGENT_INSTANCE_NOT_FOUND' | 'AGENT_INSTANCE_EXISTS' | 'AGENT_INSTANCE_CONDITION_INVALID' | 'AGENT_INITIAL_DATA_INVALID' | 'SESSION_NOT_FOUND' | 'SKILL_NOT_FOUND' | 'ROLE_NOT_FOUND' | 'POLICY_DENIED' | 'APPROVAL_REQUIRED' | 'APPROVAL_DENIED' | 'SANDBOX_UNAVAILABLE' | 'SANDBOX_ESCAPE_BLOCKED' | 'MODEL_TIMEOUT' | 'MODEL_RATE_LIMITED' | 'MODEL_CONTEXT_OVERFLOW' | 'MODEL_AUTH_FAILED' | 'TOOL_NOT_FOUND' | 'TOOL_VALIDATION_FAILED' | 'RESULT_VALIDATION_FAILED' | 'RESULT_UNAVAILABLE' | 'TOOL_EXECUTION_FAILED' | 'COMMAND_DENIED' | 'CHECKPOINT_NOT_FOUND' | 'STORE_CONFLICT' | 'STORE_UNAVAILABLE' | 'INVALID_WORKSPACE' | 'MOUNT_INVALID_PATH' | 'INVALID_CONFIG' | 'COST_LIMIT_EXCEEDED' | 'WEBHOOK_AUTH_FAILED' | 'BUILD_FAILED' | 'BUILD_INVALID_TARGET' | 'BUILD_VERIFICATION_FAILED' | 'PERSISTENCE_CONFLICT' | 'PERSISTENCE_UNAVAILABLE' | 'PERSISTENCE_INVALID_CONFIG' | 'UNKNOWN';
export interface FabricErrorOptions {
    code: FabricErrorCode;
    message: string;
    publicMessage?: string;
    details?: JsonObject;
    publicDetails?: JsonObject;
    cause?: unknown;
    retryable?: boolean;
}
export interface SerializedFabricError {
    name: string;
    code: FabricErrorCode;
    message: string;
    retryable: boolean;
    details?: JsonObject;
}
/** Mint an opaque, sortable correlation reference for one transported error. */
export declare function createErrorReference(now?: number): string;
export declare class FabricError extends Error {
    readonly code: FabricErrorCode;
    readonly details?: JsonObject;
    readonly publicMessage: string;
    readonly publicDetails?: JsonObject;
    readonly retryable: boolean;
    constructor(options: FabricErrorOptions);
    toJSON(audience?: 'public' | 'developer'): SerializedFabricError;
    toPublicJSON(): SerializedFabricError;
    toDeveloperJSON(): SerializedFabricError;
}
/** Remove credentials and host filesystem locations from caller-visible text. */
export declare function sanitizePublicText(value: string): string;
export declare function sanitizePublicJson<T>(value: T): T;
export declare function isFabricError(error: unknown): error is FabricError;
export declare function toFabricError(error: unknown, fallback: Omit<FabricErrorOptions, 'cause'>): FabricError;
/** Convert any thrown value into the stable public/developer transport shape. */
export declare function serializeFabricError(error: unknown, audience?: 'public' | 'developer', fallback?: Omit<FabricErrorOptions, 'cause'>): SerializedFabricError;
//# sourceMappingURL=error.d.ts.map