/**
 * Human-in-the-Loop Node
 *
 * Features:
 * - Async human approvals
 * - Multiple approval types (binary, multi-choice, free-form, rating)
 * - Approval chains (sequential approvers)
 * - Timeout handling with configurable actions
 * - Delegation support
 * - Priority-based routing
 */
import type { WorkflowState, HumanNodeConfig, ApprovalResponse, ApprovalStore, ApprovalNotifier, ApprovalChoice, ApprovalChainStep } from '@cogitator-ai/types';
/**
 * Context for human node execution
 */
export interface HumanNodeContext {
    workflowId: string;
    runId: string;
    nodeId: string;
    approvalStore: ApprovalStore;
    approvalNotifier?: ApprovalNotifier;
}
/**
 * Result of human node execution
 */
export interface HumanNodeResult<S extends WorkflowState> {
    approved: boolean;
    decision: unknown;
    response: ApprovalResponse;
    state: S;
    timedOut?: boolean;
    escalated?: boolean;
}
/**
 * Execute a human approval node
 */
export declare function executeHumanNode<S extends WorkflowState>(state: S, config: HumanNodeConfig<S>, context: HumanNodeContext): Promise<HumanNodeResult<S>>;
/**
 * Create a human approval node factory
 */
export declare function humanNode<S extends WorkflowState>(name: string, approval: HumanNodeConfig<S>['approval']): HumanNodeConfig<S>;
/**
 * Create a simple approve/reject node
 */
export declare function approvalNode<S extends WorkflowState>(name: string, options: {
    title: string;
    description?: string | ((state: S) => string);
    assignee?: string | ((state: S) => string);
    timeout?: number;
    timeoutAction?: 'approve' | 'reject' | 'fail';
    priority?: 'low' | 'normal' | 'high' | 'urgent';
}): HumanNodeConfig<S>;
/**
 * Create a multi-choice selection node
 */
export declare function choiceNode<S extends WorkflowState>(name: string, options: {
    title: string;
    description?: string | ((state: S) => string);
    choices: ApprovalChoice[];
    assignee?: string | ((state: S) => string);
    timeout?: number;
    priority?: 'low' | 'normal' | 'high' | 'urgent';
}): HumanNodeConfig<S>;
/**
 * Create a free-form input node
 */
export declare function inputNode<S extends WorkflowState>(name: string, options: {
    title: string;
    description?: string | ((state: S) => string);
    assignee?: string | ((state: S) => string);
    timeout?: number;
    priority?: 'low' | 'normal' | 'high' | 'urgent';
}): HumanNodeConfig<S>;
/**
 * Create a rating node
 */
export declare function ratingNode<S extends WorkflowState>(name: string, options: {
    title: string;
    description?: string | ((state: S) => string);
    assignee?: string | ((state: S) => string);
    timeout?: number;
    priority?: 'low' | 'normal' | 'high' | 'urgent';
}): HumanNodeConfig<S>;
/**
 * Create an approval chain node
 */
export declare function chainNode<S extends WorkflowState>(name: string, options: {
    title: string;
    description?: string | ((state: S) => string);
    chain: ApprovalChainStep[];
    priority?: 'low' | 'normal' | 'high' | 'urgent';
}): HumanNodeConfig<S>;
/**
 * Create a manager → director → VP chain
 */
export declare function managementChain<S extends WorkflowState>(name: string, options: {
    title: string;
    description?: string | ((state: S) => string);
    manager: string;
    director?: string;
    vp?: string;
    timeoutPerStep?: number;
}): HumanNodeConfig<S>;
//# sourceMappingURL=human-node.d.ts.map