/**
 * Pre-flight validation patterns for AI flow design.
 * Catches common tool usage failures before execution and provides actionable guidance.
 */
export interface PreflightWarning {
    readonly code: string;
    readonly message: string;
    readonly severity: 'critical' | 'warning' | 'info';
    readonly suggestion: string;
}
export declare const EDIT_WITHOUT_READ = "EDIT_WITHOUT_READ";
type ToolHistoryCall = {
    toolName: string;
    args: Record<string, unknown>;
    timestamp?: number;
};
/**
 * Validate tool preconditions before execution to prevent common AI flow failures.
 *
 * This function implements the critical AI flow design principle: validate before execute.
 * It catches common patterns that lead to tool failures and provides actionable guidance.
 *
 * @param toolName - Name of the tool being called
 * @param args - Tool arguments
 * @returns Array of pre-flight warnings (empty if all validations pass)
 */
export declare function validateToolPreconditions(toolName: string, args: Record<string, unknown>): PreflightWarning[];
/**
 * Enhanced AI flow validation for TypeScript software engineering
 * Provides comprehensive validation of AI tool usage patterns
 */
export declare function validateAIFlowPatterns(toolName: string, args: Record<string, unknown>, toolHistory: readonly ToolHistoryCall[]): PreflightWarning[];
export {};
//# sourceMappingURL=toolPreconditions.d.ts.map