import type { FinishReason, TokenUsage } from '../sdk/agent';
import type { AgentMessage, ContentToolCall } from '../sdk/message';
export type SubAgentLifecycleUsage = Pick<TokenUsage, 'promptTokens' | 'completionTokens' | 'totalTokens' | 'cost'>;
export interface SubAgentLifecycleBase {
    taskName: string;
    taskPath: string;
    parentRunId?: string;
    parentToolCallId?: string;
    subAgentId?: string;
}
export interface SubAgentStartedPayload extends SubAgentLifecycleBase {
    startedAt: number;
}
export interface SubAgentCompletedPayload extends SubAgentLifecycleBase {
    status: 'completed' | 'failed' | 'suspended' | 'cancelled';
    startedAt: number;
    finishedAt: number;
    durationMs: number;
    runId?: string;
    threadId?: string;
    model?: string;
    usage?: SubAgentLifecycleUsage;
    finishReason?: FinishReason;
    error?: string;
}
export type ForwardedChildChunk = {
    type: 'text-delta';
    id: string;
    delta: string;
} | {
    type: 'reasoning-start';
    id: string;
} | {
    type: 'reasoning-delta';
    id: string;
    delta: string;
} | {
    type: 'reasoning-end';
    id: string;
} | {
    type: 'tool-input-start';
    toolCallId: string;
    toolName: string;
} | {
    type: 'tool-execution-start';
    toolCallId: string;
    toolName: string;
    startTime: number;
} | {
    type: 'tool-execution-end';
    toolCallId: string;
    toolName: string;
    isError: boolean;
    endTime: number;
};
export interface SubAgentChunkPayload extends SubAgentLifecycleBase {
    chunk: ForwardedChildChunk;
}
export declare const enum AgentEvent {
    AgentStart = "agent_start",
    AgentEnd = "agent_end",
    TurnStart = "turn_start",
    TurnEnd = "turn_end",
    ToolExecutionStart = "tool_execution_start",
    ToolExecutionEnd = "tool_execution_end",
    SubAgentStarted = "subagent_started",
    SubAgentCompleted = "subagent_completed",
    SubAgentChunk = "subagent_chunk",
    Error = "error"
}
export type AgentEventData = {
    type: AgentEvent.AgentStart;
} | {
    type: AgentEvent.AgentEnd;
    messages: AgentMessage[];
} | {
    type: AgentEvent.TurnStart;
} | {
    type: AgentEvent.TurnEnd;
    message: AgentMessage;
    toolResults: ContentToolCall[];
} | {
    type: AgentEvent.ToolExecutionStart;
    toolCallId: string;
    toolName: string;
    args: unknown;
} | {
    type: AgentEvent.ToolExecutionEnd;
    toolCallId: string;
    toolName: string;
    result: unknown;
    isError: boolean;
} | ({
    type: AgentEvent.SubAgentStarted;
} & SubAgentStartedPayload) | ({
    type: AgentEvent.SubAgentCompleted;
} & SubAgentCompletedPayload) | ({
    type: AgentEvent.SubAgentChunk;
} & SubAgentChunkPayload) | {
    type: AgentEvent.Error;
    message: string;
    error: unknown;
    source?: 'observer' | 'reflector' | 'episodic-memory' | 'input-persistence' | 'turn-delta-persistence';
};
export type AgentEventHandler = (data: AgentEventData) => void;
export interface AgentMiddleware {
    on: (event: AgentEvent, handler: AgentEventHandler) => void;
}