/**
 * Augment Puppeteer CDP protocol-timeout errors with actionable guidance that
 * points at the HyperFrames-specific knobs. Puppeteer's stock error text
 * ("Runtime.callFunctionOn timed out. Increase the 'protocolTimeout' setting")
 * doesn't tell the user which env var / CLI flag raises this timeout in
 * HyperFrames, or what the currently-applied effective value is — so field
 * reporters have hit this class of failure, given up, and switched to
 * FFmpeg-only encoding rather than raise a knob they didn't know existed
 * (field signal ts=1784047847).
 *
 * The helper is deliberately conservative:
 *   - Only augments errors whose message matches known protocol-timeout
 *     strings (`Runtime.callFunctionOn timed out`, `Target closed`,
 *     `protocolTimeout`).
 *   - Non-matching errors are returned unchanged (same instance).
 *   - Non-Error inputs are coerced with `new Error(String(err))` so callers
 *     get a well-typed `Error` back regardless of what was thrown.
 *   - The original error is preserved via `err.cause`, so stack introspection
 *     and downstream logging still see the raw Puppeteer message.
 */
export declare function augmentProtocolTimeoutError(err: unknown, effectiveTimeoutMs: number): Error;
/**
 * Predicate variant: exposed for callers that only need to classify an error
 * (e.g. observability, tests) without materialising an augmented Error. Uses
 * the same matcher as the augmentation path so the two never drift.
 */
export declare function isProtocolTimeoutError(err: unknown): boolean;
//# sourceMappingURL=protocolTimeoutErrorHint.d.ts.map