Skip to main content

Interface: BaseRealtimeModelConfig

Defined in: packages/sdk/src/types/model-config-types.ts:83

Base configuration for all realtime models. Contains common fields that apply to all realtime model providers.

Extended by​

Properties​

inactiveConfig?​

optional inactiveConfig: Record<string, unknown> | null

Defined in: packages/sdk/src/types/model-config-types.ts:112

Settings belonging to the voice architecture that is NOT currently selected, parked so switching between the composable stack and a native speech-to-speech model is lossless and reversible.

Declared on the base because the native schemas set extra="forbid" server-side: an undeclared key would be rejected on save. Written and read only by the switch itself (reconcile_realtime_model_config on the server, parkComposableConfig / restoreComposableConfig in the editor). Nothing at call time reads it — it is a holding area, never live configuration.

interruptionSound?​

optional interruptionSound: InterruptionSound | null

Defined in: packages/sdk/src/types/model-config-types.ts:93

Sound to play when user stops speaking after interrupting the assistant. Provides immediate auditory feedback that input was received. Default: none.

interruptionSoundVolume?​

optional interruptionSoundVolume: number | null

Defined in: packages/sdk/src/types/model-config-types.ts:95

Volume level for the interruption sound (0-100). 0 means muted. Missing or null means full volume (100).

thinkingSound?​

optional thinkingSound: ThinkingSound | null

Defined in: packages/sdk/src/types/model-config-types.ts:85

Sound to play while the agent is processing tool calls.

thinkingSoundInitialDelay?​

optional thinkingSoundInitialDelay: number | null

Defined in: packages/sdk/src/types/model-config-types.ts:89

Initial delay in milliseconds before playing thinking sound. Prevents needless interruption on short tool calls. Default: 500ms.

thinkingSoundVolume?​

optional thinkingSoundVolume: number | null

Defined in: packages/sdk/src/types/model-config-types.ts:87

Volume level for the thinking sound (0-100). 0 means muted. Missing or null means full volume (100).

thinkingSpeechPhrases?​

optional thinkingSpeechPhrases: string[] | null

Defined in: packages/sdk/src/types/model-config-types.ts:91

When thinkingSound is 'speech', one of these phrases is spoken while the agent runs a tool. Phrases rotate round-robin per session.

ttsModel?​

optional ttsModel: TTSModel | null

Defined in: packages/sdk/src/types/model-config-types.ts:97

TTS model ID in provider:tts:model format (e.g. 'elevenlabs:tts:eleven_flash_v2_5'), or 'native'.

voiceModel?​

optional voiceModel: string | null

Defined in: packages/sdk/src/types/model-config-types.ts:99

Canonical voice identifier (e.g., elevenlabs:voice:catt) that selects the specific agent voice.