export type EnvelopeMapping = {
    code: 'INVALID_GOAL';
    nextActions: readonly string[];
} | {
    code: 'INVALID_PROVIDERS';
    nextActions: readonly string[];
} | {
    code: 'INTERNAL_ERROR';
    nextActions: readonly string[];
};
/**
 * Map a thrown error into an envelope code + nextActions hint. Pure
 * function — no IO, no state. Safe to call from any CLI handler.
 *
 * @param error - any value that may have been thrown (we only inspect
 *                `.message` for goal-validation; everything else is
 *                routed by class).
 */
export declare function mapServiceError(error: unknown): EnvelopeMapping;