import type { EngineTelemetry, EngineWarning } from '../../types.js';
/**
 * Build the top-level `engine_warnings` array from `engine_telemetry`.
 *
 * Contract:
 *   - One warning per engine with outcome === 'error'. We do NOT emit
 *     warnings for outcome === 'skipped' (that's a deliberate cache-only
 *     path or a non-applicable vertical, not a failure).
 *   - The returned array is always defined — empty when no engine errored
 *     so callers can branch on `engine_warnings.length` without optional
 *     chaining gymnastics.
 *   - For 401 / 403 outcomes on an engine listed in ENGINE_AUTH_HINTS,
 *     the warning carries `hint` so users see the env-var fix shape.
 */
export declare function buildEngineWarnings(telemetry: EngineTelemetry[] | undefined): EngineWarning[];
//# sourceMappingURL=engine-warnings.d.ts.map