/**
 * Safe Stage — 0-risk wrapper utilities.
 *
 * Pattern from MrGray17/opentoken (MIT).
 * Every operation MUST have a conservative safety guard:
 * - If a step fails, return a meaningful fallback
 * - Every try-catch logs and never throws
 * - Conservative filter: if result is "bigger" than fallback, use fallback
 */
/**
 * Synchronous safe wrapper with conservative filtering.
 * @param name - Operation name for logging
 * @param fn - Operation to execute
 * @param fallback - Default value on failure
 * @returns Operation result or fallback
 */
export declare function safeStage<T>(name: string, fn: () => T, fallback: T): T;
/**
 * Async safe wrapper with conservative filtering.
 * @param name - Operation name for logging
 * @param fn - Async operation to execute
 * @param fallback - Default value on failure
 * @returns Operation result or fallback
 */
export declare function safeStageAsync<T>(name: string, fn: () => Promise<T>, fallback: T): Promise<T>;
/**
 * Hook-safe async wrapper: wraps an async hook handler so it never throws.
 * @param name - Hook name for logging
 * @param handler - The hook handler function
 * @returns A wrapped handler that never throws
 */
export declare function safeHook<TInput, TOutput>(name: string, handler: (input: TInput, output: TOutput) => Promise<void>): (input: TInput, output: TOutput) => Promise<void>;
/**
 * Conservative filter: ensures output doesn't exceed size limits.
 * If the content is more than `maxFactor` times the original, return original.
 */
export declare function conservativeFilter(original: string, result: string, maxFactor?: number): string;