/** `EventMsg`'s legacy v1 wire format — see file header for the source
 *  citation (codex-rs/protocol/src/protocol.rs + legacy_events.rs). Only
 *  the variants this runner acts on are typed; everything else (exec
 *  command begin/end, mcp tool call begin/end, reasoning, …) is ignored. */
export interface CodexTokenUsage {
    input_tokens: number;
    cached_input_tokens?: number;
    cache_write_input_tokens?: number;
    output_tokens: number;
    reasoning_output_tokens?: number;
    total_tokens?: number;
}
/** Current (v0.149.0+) item-based wire format's `item` payload. Only the
 *  fields this runner acts on are typed (codex-runner-tools.ts maps the
 *  tool items); reasoning and other non-tool items are ignored, same
 *  policy as the legacy format's untyped variants. */
export interface CodexItem {
    id: string;
    type: string;
    /** agent_message */
    text?: string;
    /** command_execution */
    command?: string;
    aggregated_output?: string;
    exit_code?: number | null;
    /** in_progress | completed | failed (| declined) */
    status?: string;
    /** file_change */
    changes?: Array<{
        path: string;
        kind?: string;
        diff?: string;
    }>;
    /** mcp_tool_call */
    server?: string;
    tool?: string;
    arguments?: unknown;
    result?: {
        content?: Array<{
            type?: string;
            text?: string;
        }>;
        [k: string]: unknown;
    };
    error?: {
        message?: string;
    };
    /** web_search */
    query?: string;
    /** todo_list */
    items?: Array<{
        text: string;
        completed?: boolean;
    }>;
}
export interface CodexEvent {
    type: 'session_configured' | 'task_started' | 'agent_message' | 'token_count' | 'task_complete' | 'error' | 'thread.started' | 'turn.started' | 'item.started' | 'item.completed' | 'turn.completed' | 'turn.failed' | (string & {});
    session_id?: string;
    thread_id?: string;
    message?: string;
    info?: {
        last_token_usage?: CodexTokenUsage;
        total_token_usage?: CodexTokenUsage;
    };
    turn_id?: string;
    last_agent_message?: string;
    error?: {
        message: string;
    };
    item?: CodexItem;
    usage?: CodexTokenUsage;
}
/**
 * One parsed codex event, normalized for incremental streaming.
 *   - 'assistant': rawText is one whole agent_message (fences intact) for
 *     end-of-turn tool-call parsing; text is the fence-stripped prose,
 *     present only when non-empty.
 *   - 'tool':      codex's own tool activity (a command_execution item's
 *     start, or the spawn-time liveness yield) — forwarded by run() as a
 *     `tool_use` liveness AgentMessage (see header).
 *   - 'tool_start' / 'tool_end': one codex tool item's start and matched
 *     end (codex-runner-tools.ts), correlated by `toolUseId`, with the
 *     contract §4 canonical `toolKind`/`input` on the start and the
 *     result on the end — forwarded as rich `tool_use`/`tool_result`.
 *   - 'meta':      any other event that only carries a thread id.
 */
export interface CodexStreamEvent {
    kind: 'assistant' | 'tool' | 'tool_start' | 'tool_end' | 'meta';
    text?: string;
    rawText?: string;
    /** 'tool' / 'tool_start': short progress label. */
    toolName?: string;
    threadId?: string;
    /** tool_start / tool_end */
    toolUseId?: string;
    /** Native codex item type (command_execution, file_change, …). */
    tool?: string;
    toolKind?: 'shell' | 'patch' | 'mcp' | 'web' | 'todo' | 'other';
    input?: Record<string, unknown>;
    /** tool_end */
    output?: string;
    isError?: boolean;
    exitCode?: number;
    durationMs?: number;
}
export interface TurnOutcome {
    threadId?: string;
    exitCode: number;
    stderrTail: string;
    timedOut: boolean;
    /** Total input, cached part included (OpenAI convention, #550). */
    inputTokens: number;
    outputTokens: number;
    /** #550: the parts of inputTokens served from / written to the cache. */
    cachedInputTokens?: number;
    cacheWriteInputTokens?: number;
    error?: string;
}
//# sourceMappingURL=codex-runner-types.d.ts.map