/**
 * Fixed codes only; generated native adapters must never copy refusal prose.
 * The released Sumi v3 adapter keeps its own frozen copy (agent-sumi.ts).
 */
export declare const HOOK_REFUSAL_REASON_CODES: readonly string[];
export declare class HookDiagnosticError extends Error {
    readonly code: string;
    readonly stage: "context" | "sync";
    /** Fixed marker: a refused renewal whose automatic pin migration ran out of budget. */
    readonly migration?: "timeout";
    /** Fixed marker: an expired pin whose renewal continues in a background worker. */
    readonly renewal?: "background";
    constructor(code: string, stage: "context" | "sync", migration?: "timeout", renewal?: "background");
}
export declare function hookChildError(stdout: string, stage: "context" | "sync"): HookDiagnosticError;
export declare function hookFailureReason(error: unknown, profileId?: string): string;
export declare function isOptionalHookContextFailure(error: unknown): error is HookDiagnosticError;
export declare function hookUnavailableContext(error: HookDiagnosticError, profileId?: string): string;