import type { ConfigManager } from '../config/manager.js';
import type { SessionMaintenanceStatus } from './session-maintenance.js';
import type { EcosystemRecommendation } from './ecosystem/recommendations.js';
export type GuidanceMode = 'off' | 'minimal' | 'guided';
export type GuidanceCategory = 'onboarding' | 'operational' | 'recovery' | 'optimization';
export interface GuidanceItem {
    readonly id: string;
    readonly category: GuidanceCategory;
    readonly title: string;
    readonly summary: string;
    readonly commands: readonly string[];
}
export interface ContextualGuidanceSnapshot {
    readonly pendingApproval: boolean;
    readonly denialCount: number;
    readonly authRequiredMcpCount: number;
    readonly degradedProviderCount: number;
    readonly intelligenceUnavailable: boolean;
    readonly recommendations: readonly EcosystemRecommendation[];
}
export interface GuidancePersistenceOptions {
    readonly guidancePath?: string | undefined;
    readonly userRoot?: string | undefined;
    readonly homeDirectory?: string | undefined;
    readonly surfaceRoot?: string | undefined;
}
export declare function dismissGuidance(id: string, options?: GuidancePersistenceOptions): void;
export declare function resetGuidance(id?: string, options?: GuidancePersistenceOptions): void;
export declare function evaluateContextualGuidance(configManager: ConfigManager, snapshot: ContextualGuidanceSnapshot, maintenance: SessionMaintenanceStatus, options?: GuidancePersistenceOptions): GuidanceItem[];
export declare function formatGuidanceItems(items: readonly GuidanceItem[]): string[];
//# sourceMappingURL=guidance.d.ts.map