Handoff

export declare function createCompleteTool(): ToolDef;

export declare function createHandoffTool(targets: HandoffTarget[]): ToolDef;

export interface HandoffConfig {
    targets: HandoffTarget[];
    maxHandoffs?: number;
    carryMessages?: boolean;
    carrySessionState?: boolean;
}

export declare class HandoffManager {
    constructor(config: HandoffConfig);
    getTarget(name: string): HandoffTarget | undefined;
    execute(signal: HandoffSignal, sourceAgent: string, originalInput: string, conversationMessages: ChatMessage[], ctx: RunContext, eventBus: EventBus, opts?: RunOpts, approvals?: readonly ApprovalManager[]): Promise<HandoffResult>;
    /** Continue a live Agent stream after a fully authorized, settled transfer batch. */
    stream(signal: HandoffSignal, sourceAgent: string, originalInput: string, conversationMessages: ChatMessage[], ctx: RunContext, eventBus: EventBus, opts?: RunOpts, approvals?: readonly ApprovalManager[], transcript?: ChatMessage[], sourceModel?: ModelProvider): AsyncGenerator<StreamChunk, HandoffResult>;
}

export interface HandoffResult extends RunOutput {
    handoffChain: string[];
    finalAgent: string;
}

export declare class HandoffSignal extends Error {
    readonly targetAgent: string;
    readonly reason: string;
    constructor(targetAgent: string, reason: string);
}

export interface HandoffTarget {
    agent: Agent;
    description: string;
    onHandoff?: (ctx: RunContext) => Promise<void>;
}