Interface ChatTurn

A single turn in a chat session — either a user message or an agent response.

interface ChatTurn {
    agent_metadata?: ChatAgentMetadata | null;
    completed_at: string | null;
    content: string;
    created_at: string;
    error?: ChatTurnError | null;
    id: string;
    role: ChatTurnRole;
    sequence_number: number;
    session_id: string;
    status: ChatTurnStatus;
}

Index

Properties

agent_metadata? completed_at content created_at error? id role sequence_number session_id status

Properties

`Optional`agent_metadata

agent_metadata?: ChatAgentMetadata | null

Present for role === 'agent' turns

completed_at

completed_at: string | null

content

content: string

Message text (user) or agent response text

created_at

created_at: string

`Optional`error

error?: ChatTurnError | null

Present when status === 'failed'

id

id: string

role

role: ChatTurnRole

sequence_number

sequence_number: number

1-based position in the session; user messages are odd, agent responses are even

session_id

session_id: string

status

status: ChatTurnStatus