import type { InstallRefreshReport } from "../types.js";
/**
 * Describes a normalized actionable diagnostic for user-facing failures.
 */
export interface ActionableDiagnostic {
    title: string;
    summary: string;
    why?: string;
    nextCommands?: string[];
    reportPaths?: string[];
    policyBlock?: boolean;
}
/**
 * Formats an actionable diagnostic with stable labels for CLI output/tests.
 */
export declare function formatActionableDiagnostic(diagnostic: ActionableDiagnostic): string;
/**
 * Builds an actionable diagnostic for unknown host adapter input.
 */
export declare function unknownHostDiagnostic(hostName: string): ActionableDiagnostic;
/**
 * Builds an actionable diagnostic for unsupported native install requests.
 */
export declare function unsupportedNativeInstallDiagnostic(options: {
    displayName: string;
    hostId: string;
}): ActionableDiagnostic;
/**
 * Builds an actionable diagnostic for native install plans with no selected assets.
 */
export declare function noNativeInstallAssetsDiagnostic(options: {
    displayName: string;
    assetKind: string;
    hostId: string;
}): ActionableDiagnostic;
/**
 * Builds an actionable diagnostic when refresh/apply is blocked by policy.
 */
export declare function installRefreshPolicyDiagnostic(report: InstallRefreshReport): ActionableDiagnostic | null;