import type { ProjectId, SessionId, TurnId } from '../../types/ids/index.js';
import type { Turn } from '../../types/session/turn.js';
import type { ApiPermissionMode, ISOTimestamp } from '../api.js';
import type { WireTurnStatus } from './turn-status.js';
/**
 * Why a turn stopped, as the wire's `stop_reason` field carries it.
 *
 * The domain stop reason under a wire name, so the HTTP field stays decoupled
 * from the internal type's identifier.
 */
export type WireStopReason = NonNullable<Turn['stopReason']>;
/** The per-turn configuration a client may set. Every field is optional; the agent's defaults fill the rest. */
export interface WireTurnConfig {
    model?: string;
    temperature?: number;
    tokenBudget?: number;
    maxResponseTokens?: number;
    timeoutMs?: number;
    streamIdleTimeoutMs?: number;
    maxRequestRichContentBytes?: number;
    permissionMode?: ApiPermissionMode;
    systemPrompt?: string;
}
/** What one turn spent. Usage of this turn only; child sessions report their own. */
export interface WireUsage {
    input_tokens: number;
    output_tokens: number;
    total_tokens: number;
    total_cost_usd?: number;
}
/**
 * One turn of a session, as HTTP, SSE and A2A payloads carry it.
 *
 * A turn always belongs to a session: `session_id` is required. A child
 * session's turn names the parent session and the parent turn whose tool call
 * spawned it; `child_session_ids` lists the child sessions this turn spawned.
 */
export interface WireTurn {
    turn_id: TurnId;
    session_id: SessionId;
    project_id: ProjectId | null;
    agent_id: string;
    agent_name?: string;
    status: WireTurnStatus;
    stop_reason?: WireStopReason;
    created_at: ISOTimestamp;
    started_at?: ISOTimestamp;
    completed_at?: ISOTimestamp;
    duration_ms?: number;
    model?: string;
    config: WireTurnConfig;
    usage?: WireUsage;
    iterations?: number;
    /** The authoritative answer, after guardrail, review and structured-output overrides. */
    result?: string;
    last_error?: string;
    /** Present on a child session's turn: the session that delegated it. */
    parent_session_id?: SessionId;
    /** Present on a child session's turn: the parent turn whose tool call spawned the child. */
    parent_turn_id?: TurnId;
    depth?: number;
    child_session_ids?: SessionId[];
}
//# sourceMappingURL=turn.d.ts.map