/**
 * Formats an Error together with its `.cause`, if present, so wrapper errors
 * (e.g. MonographError('Failed to open database at ...', err)) don't silently
 * drop the actionable detail attached as `cause`.
 */
export declare function formatErrorWithCause(err: unknown): string;
/**
 * Recognizes known native-addon load failure signatures (e.g. better-sqlite3
 * built against the wrong Node ABI) and returns a specific, actionable
 * message. Returns null when the text doesn't match a known pattern, so
 * callers can fall back to surfacing the raw text instead of a guess.
 */
export declare function classifyNativeModuleError(text: string): string | null;
/**
 * Pulls the `node_modules/<pkg>` package name out of the FIRST such path
 * mentioned anywhere in a native-module error dump — both the ABI-mismatch
 * shape ("The module '.../node_modules/better-sqlite3/build/Release/...'
 * was compiled against...") and the "could not locate the bindings file"
 * shape name the offending package this way. Used to look up that module's
 * own on-disk freshness (see checkMonographFreshness in
 * doctor-monograph-checks.ts) so a since-rebuilt module doesn't keep getting
 * reported as a current failure just because an old build.log entry still
 * mentions it. Handles scoped (@scope/name) and unscoped package dirs.
 */
export declare function extractNativeModulePackageName(text: string): string | null;
//# sourceMappingURL=native-error.d.ts.map