/**
 * Workflow Hooks - Lifecycle hooks for workflow execution
 *
 * Provides workflow-level hooks matching Python's HooksConfig.
 *
 * @example
 * ```typescript
 * import { Workflow, WorkflowHooksConfig } from 'praisonai';
 *
 * const hooks: WorkflowHooksConfig = {
 *   onWorkflowStart: (workflow, input) => {
 *     console.log('Workflow started:', workflow.name);
 *   },
 *   onStepComplete: (stepName, result) => {
 *     console.log(`Step ${stepName} completed:`, result);
 *   }
 * };
 *
 * const workflow = new Workflow({ hooks });
 * ```
 */
/**
 * Workflow reference for hooks
 */
export interface WorkflowRef {
    id: string;
    name?: string;
    steps: string[];
}
/**
 * Step context for hooks
 */
export interface StepContext {
    stepName: string;
    stepIndex: number;
    totalSteps: number;
    input: any;
    previousResults: Record<string, any>;
}
/**
 * Workflow hooks configuration - matches Python HooksConfig
 */
export interface WorkflowHooksConfig {
    /** Called before workflow execution starts */
    onWorkflowStart?: (workflow: WorkflowRef, input: any) => void | Promise<void>;
    /** Called after workflow completes successfully */
    onWorkflowComplete?: (workflow: WorkflowRef, result: any) => void | Promise<void>;
    /** Called before each step starts */
    onStepStart?: (stepName: string, context: StepContext) => void | Promise<void>;
    /** Called after each step completes */
    onStepComplete?: (stepName: string, result: any, context: StepContext) => void | Promise<void>;
    /** Called when a step encounters an error */
    onStepError?: (stepName: string, error: Error, context: StepContext) => void | Promise<void>;
    /** Called when workflow fails */
    onWorkflowError?: (workflow: WorkflowRef, error: Error) => void | Promise<void>;
}
/**
 * Execute workflow hooks safely
 */
export declare class WorkflowHooksExecutor {
    private hooks;
    private logging;
    constructor(hooks?: WorkflowHooksConfig, logging?: boolean);
    private log;
    private safeExecute;
    onWorkflowStart(workflow: WorkflowRef, input: any): Promise<void>;
    onWorkflowComplete(workflow: WorkflowRef, result: any): Promise<void>;
    onStepStart(stepName: string, context: StepContext): Promise<void>;
    onStepComplete(stepName: string, result: any, context: StepContext): Promise<void>;
    onStepError(stepName: string, error: Error, context: StepContext): Promise<void>;
    onWorkflowError(workflow: WorkflowRef, error: Error): Promise<void>;
    /**
     * Check if any hooks are configured
     */
    hasHooks(): boolean;
    /**
     * Get configured hook names
     */
    getConfiguredHooks(): string[];
}
/**
 * Create workflow hooks executor
 */
export declare function createWorkflowHooks(config: WorkflowHooksConfig, logging?: boolean): WorkflowHooksExecutor;
/**
 * Pre-built logging hooks
 */
export declare function createLoggingWorkflowHooks(logger?: (msg: string, data?: any) => void): WorkflowHooksConfig;
/**
 * Timing hooks for performance monitoring
 */
export declare function createTimingWorkflowHooks(): {
    hooks: WorkflowHooksConfig;
    getTimings: () => Record<string, number>;
};
export default WorkflowHooksExecutor;