Skip to main content

Interface: CallRecord

Defined in: packages/agentos/src/voice/types.ts:135

Full record of a voice call — used for tracking, persistence, and status queries.

Properties

callId

callId: string

Defined in: packages/agentos/src/voice/types.ts:137

Unique call identifier (UUID).


createdAt

createdAt: number

Defined in: packages/agentos/src/voice/types.ts:161

Unix timestamp (ms) when the call was created.


direction

direction: CallDirection

Defined in: packages/agentos/src/voice/types.ts:145

Call direction.


endedAt?

optional endedAt: number

Defined in: packages/agentos/src/voice/types.ts:163

Unix timestamp (ms) when the call reached a terminal state.


errorMessage?

optional errorMessage: string

Defined in: packages/agentos/src/voice/types.ts:165

Error message if state is 'error' or 'failed'.


fromNumber

fromNumber: string

Defined in: packages/agentos/src/voice/types.ts:149

E.164 phone number of the caller.


metadata?

optional metadata: Record<string, unknown>

Defined in: packages/agentos/src/voice/types.ts:167

Provider-specific metadata.


mode

mode: CallMode

Defined in: packages/agentos/src/voice/types.ts:147

Call interaction mode.


processedEventIds

processedEventIds: string[]

Defined in: packages/agentos/src/voice/types.ts:157

IDs of webhook events already processed (idempotency).


provider

provider: VoiceProviderName

Defined in: packages/agentos/src/voice/types.ts:141

Which provider is handling this call.


providerCallId?

optional providerCallId: string

Defined in: packages/agentos/src/voice/types.ts:139

Provider-assigned call ID (e.g., Twilio CallSid).


seedId?

optional seedId: string

Defined in: packages/agentos/src/voice/types.ts:153

Agent seed ID (if bound to a specific agent).


state

state: CallState

Defined in: packages/agentos/src/voice/types.ts:143

Current state in the call lifecycle.


streamSid?

optional streamSid: string

Defined in: packages/agentos/src/voice/types.ts:159

Stream SID for media streams (Twilio-specific).


toNumber

toNumber: string

Defined in: packages/agentos/src/voice/types.ts:151

E.164 phone number being called.


transcript

transcript: TranscriptEntry[]

Defined in: packages/agentos/src/voice/types.ts:155

Conversation transcript.