Class VerbBuilder

Base class for building jambonz verb arrays. Extended by WebhookResponse and WsSession. Provides typed verb methods and optional runtime schema validation.

Hierarchy (View Summary)

VerbBuilder
- WebhookResponse

Index

Constructors

Properties

verbs validator

Accessors

Constructors

constructor

new VerbBuilder(opts?: VerbBuilderOptions): VerbBuilder
Parameters
- Optionalopts: VerbBuilderOptions
  Options for validation and schema directory.
Returns VerbBuilder
- Defined in src/verb-builder.ts:55

Properties

`Protected`verbs

verbs: Verb[] = []

`Protected`validator

validator: JambonzValidator | null

Accessors

length

get length(): number
Get the current verb count.

Returns number
- Defined in src/verb-builder.ts:236

Methods

say

say(opts: Omit<SayVerb, "verb">): this
Speak text using TTS. Supports SSML, multiple voices, and streaming.
Parameters
- opts: Omit<SayVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:66

play

play(opts: Omit<PlayVerb, "verb">): this
Play an audio file from a URL.
Parameters
- opts: Omit<PlayVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:71

gather

gather(opts: Omit<GatherVerb, "verb">): this
Collect speech (STT) and/or DTMF input from the caller.
Parameters
- opts: Omit<GatherVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:76

llm

llm(opts: Omit<LlmVerb, "verb">): this
Connect the caller to an LLM for real-time voice conversation.
Parameters
- opts: Omit<LlmVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:83

pipeline

pipeline(opts: Omit<PipelineVerb, "verb">): this
Voice AI pipeline with integrated turn detection.
Parameters
- opts: Omit<PipelineVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:88

listen

listen(opts: Omit<ListenVerb, "verb">): this
Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio.
Parameters
- opts: Omit<ListenVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:93

stream

stream(opts: Omit<StreamVerb, "verb">): this
Stream real-time call audio to a WebSocket endpoint. Synonym for listen.
Parameters
- opts: Omit<StreamVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:98

transcribe

transcribe(opts: Omit<TranscribeVerb, "verb">): this
Real-time call transcription sent to a webhook.
Parameters
- opts: Omit<TranscribeVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:103

dial

dial(opts: Omit<DialVerb, "verb">): this
Place an outbound call and bridge it to the current caller.
Parameters
- opts: Omit<DialVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:110

conference

conference(opts: Omit<ConferenceVerb, "verb">): this
Join or create a multi-party conference room.
Parameters
- opts: Omit<ConferenceVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:115

enqueue

enqueue(opts: Omit<EnqueueVerb, "verb">): this
Place the caller into a named queue.
Parameters
- opts: Omit<EnqueueVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:120

dequeue

dequeue(opts: Omit<DequeueVerb, "verb">): this
Remove a caller from a queue and bridge them.
Parameters
- opts: Omit<DequeueVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:125

hangup

hangup(opts?: Omit<HangupVerb, "verb">): this
End the call.
Parameters
- Optionalopts: Omit<HangupVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:130

redirect

redirect(opts: Omit<RedirectVerb, "verb">): this
Transfer control to a different webhook URL.
Parameters
- opts: Omit<RedirectVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:135

pause

pause(opts: Omit<PauseVerb, "verb">): this
Wait for a specified duration before continuing.
Parameters
- opts: Omit<PauseVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:140

leave

leave(opts?: Omit<LeaveVerb, "verb">): this
Leave a conference or queue.
Parameters
- Optionalopts: Omit<LeaveVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:145

sipDecline

sipDecline(opts: Omit<SipDeclineVerb, "verb">): this
Reject an incoming call with a SIP error response.
Parameters
- opts: Omit<SipDeclineVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:152

sipRequest

sipRequest(opts: Omit<SipRequestVerb, "verb">): this
Send a SIP INFO or other request within the dialog.
Parameters
- opts: Omit<SipRequestVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:157

sipRefer

sipRefer(opts: Omit<SipReferVerb, "verb">): this
Transfer the call via SIP REFER.
Parameters
- opts: Omit<SipReferVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:162

config

config(opts: Omit<ConfigVerb, "verb">): this
Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.).
Parameters
- opts: Omit<ConfigVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:169

answer

answer(opts?: Omit<AnswerVerb, "verb">): this
Explicitly answer the call (sends a 200 OK).
Parameters
- Optionalopts: Omit<AnswerVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:174

alert

alert(opts: Omit<AlertVerb, "verb">): this
Send a SIP 180 Ringing with optional Alert-Info header.
Parameters
- opts: Omit<AlertVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:179

tag

tag(opts: Omit<TagVerb, "verb">): this
Attach metadata to the call for tracking or routing.
Parameters
- opts: Omit<TagVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:184

dtmf

dtmf(opts: Omit<DtmfVerb, "verb">): this
Send DTMF tones into the call.
Parameters
- opts: Omit<DtmfVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:189

dub

dub(opts: Omit<DubVerb, "verb">): this
Mix an auxiliary audio track into the call.
Parameters
- opts: Omit<DubVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:194

message

message(opts: Omit<MessageVerb, "verb">): this
Send an SMS or MMS message.
Parameters
- opts: Omit<MessageVerb, "verb">
Returns this
- Defined in src/verb-builder.ts:199

addVerbs

addVerbs(verbs: Verb[]): this
Add one or more verbs from raw JSON. Validates against the JSON schemas at runtime if validation is enabled.
Parameters
- verbs: Verb[]
Returns this
- Defined in src/verb-builder.ts:209

`Protected`addVerb

addVerb(verb: Verb): this
Parameters
- verb: Verb
Returns this
- Defined in src/verb-builder.ts:223

clear

clear(): this
Clear all queued verbs.

Returns this
- Defined in src/verb-builder.ts:241

toJSON

toJSON(): Verb[]
Returns a copy of the current verb array.

Returns Verb[]
- Defined in src/verb-builder.ts:247