@jambonz/sdk 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client/index.cjs +3 -3
- package/dist/client/index.cjs.map +1 -1
- package/dist/client/index.d.cts +4 -4
- package/dist/client/index.d.ts +4 -4
- package/dist/client/index.js +3 -3
- package/dist/client/index.js.map +1 -1
- package/dist/index.cjs +14 -14
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +4 -4
- package/dist/index.d.ts +4 -4
- package/dist/index.js +14 -14
- package/dist/index.js.map +1 -1
- package/dist/{rest-B_GQITxM.d.cts → rest-BvOtq44O.d.cts} +3 -3
- package/dist/{rest-DgctQy2b.d.ts → rest-DAAEUWsa.d.ts} +3 -3
- package/dist/{session-DVGHbtan.d.cts → session-DKaSRkIo.d.cts} +19 -19
- package/dist/{session-DVGHbtan.d.ts → session-DKaSRkIo.d.ts} +19 -19
- package/dist/types/index.d.cts +3 -3
- package/dist/types/index.d.ts +3 -3
- package/dist/{verb-builder-B7RIVi0t.d.ts → verb-builder-CFPD9yWI.d.cts} +3 -3
- package/dist/{verb-builder-B6zPuGd1.d.cts → verb-builder-D5XRbTtu.d.ts} +3 -3
- package/dist/{verbs-B18Kazd9.d.cts → verbs-DKy6nGIH.d.cts} +6 -6
- package/dist/{verbs-B18Kazd9.d.ts → verbs-DKy6nGIH.d.ts} +6 -6
- package/dist/webhook/index.cjs +3 -3
- package/dist/webhook/index.cjs.map +1 -1
- package/dist/webhook/index.d.cts +2 -2
- package/dist/webhook/index.d.ts +2 -2
- package/dist/webhook/index.js +3 -3
- package/dist/webhook/index.js.map +1 -1
- package/dist/websocket/index.cjs +11 -11
- package/dist/websocket/index.cjs.map +1 -1
- package/dist/websocket/index.d.cts +7 -7
- package/dist/websocket/index.d.ts +7 -7
- package/dist/websocket/index.js +11 -11
- package/dist/websocket/index.js.map +1 -1
- package/package.json +2 -2
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { A as ActionHook, y as Verb } from './verbs-
|
|
1
|
+
import { A as ActionHook, y as Verb } from './verbs-DKy6nGIH.js';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* Types for the jambonz REST API client.
|
|
@@ -104,8 +104,8 @@ interface UpdateCallRequest {
|
|
|
104
104
|
};
|
|
105
105
|
/** Tag metadata. */
|
|
106
106
|
tag?: Record<string, unknown>;
|
|
107
|
-
/** Mid-conversation
|
|
108
|
-
|
|
107
|
+
/** Mid-conversation agent update. */
|
|
108
|
+
agent_update?: {
|
|
109
109
|
type: 'update_instructions' | 'inject_context' | 'update_tools' | 'generate_reply';
|
|
110
110
|
instructions?: string;
|
|
111
111
|
messages?: Array<{
|
|
@@ -94,16 +94,16 @@ interface TtsStreamingEvent {
|
|
|
94
94
|
bargein?: boolean;
|
|
95
95
|
}
|
|
96
96
|
/** WebSocket message types received from jambonz. */
|
|
97
|
-
type WsMessageType = 'session:new' | 'session:adulting' | 'session:reconnect' | 'session:redirect' | 'verb:hook' | 'dial:confirm' | 'call:status' | 'verb:status' | 'llm:event' | 'llm:tool-call' | '
|
|
98
|
-
/**
|
|
99
|
-
type
|
|
97
|
+
type WsMessageType = 'session:new' | 'session:adulting' | 'session:reconnect' | 'session:redirect' | 'verb:hook' | 'dial:confirm' | 'call:status' | 'verb:status' | 'llm:event' | 'llm:tool-call' | 'agent:event' | 'agent:tool-call' | 'tts:streaming-event' | 'tts:tokens-result' | 'jambonz:error';
|
|
98
|
+
/** Agent eventHook event types. */
|
|
99
|
+
type AgentEventType = 'turn_end' | 'user_transcript' | 'llm_response' | 'user_interruption';
|
|
100
100
|
/** Preflight (early generation) metrics. */
|
|
101
|
-
interface
|
|
101
|
+
interface AgentPreflightMetrics {
|
|
102
102
|
result: 'hit' | 'miss' | 'pending';
|
|
103
103
|
tokens?: number;
|
|
104
104
|
}
|
|
105
105
|
/** Per-turn latency metrics (all values in milliseconds). */
|
|
106
|
-
interface
|
|
106
|
+
interface AgentTurnLatency {
|
|
107
107
|
/** STT processing latency: stop talking to final transcript received. */
|
|
108
108
|
transcriber_latency?: number;
|
|
109
109
|
/** Additional wait after transcript for end-of-turn detection. */
|
|
@@ -113,32 +113,32 @@ interface PipelineTurnLatency {
|
|
|
113
113
|
/** TTS engine latency: first text sent to TTS until first audio received. */
|
|
114
114
|
voice_latency?: number;
|
|
115
115
|
/** Early generation metrics. */
|
|
116
|
-
preflight?:
|
|
116
|
+
preflight?: AgentPreflightMetrics;
|
|
117
117
|
}
|
|
118
|
-
/** Payload for
|
|
119
|
-
interface
|
|
118
|
+
/** Payload for agent:event turn_end messages. */
|
|
119
|
+
interface AgentTurnEndEvent {
|
|
120
120
|
type: 'turn_end';
|
|
121
121
|
transcript: string;
|
|
122
122
|
response: string;
|
|
123
123
|
interrupted: boolean;
|
|
124
|
-
latency:
|
|
124
|
+
latency: AgentTurnLatency;
|
|
125
125
|
}
|
|
126
|
-
/** Payload for
|
|
127
|
-
interface
|
|
126
|
+
/** Payload for agent:event user_transcript messages. */
|
|
127
|
+
interface AgentUserTranscriptEvent {
|
|
128
128
|
type: 'user_transcript';
|
|
129
129
|
transcript: string;
|
|
130
130
|
}
|
|
131
|
-
/** Payload for
|
|
132
|
-
interface
|
|
133
|
-
type: '
|
|
131
|
+
/** Payload for agent:event llm_response messages. */
|
|
132
|
+
interface AgentLlmResponseEvent {
|
|
133
|
+
type: 'llm_response';
|
|
134
134
|
response: string;
|
|
135
135
|
}
|
|
136
|
-
/** Payload for
|
|
137
|
-
interface
|
|
136
|
+
/** Payload for agent:event user_interruption messages. */
|
|
137
|
+
interface AgentUserInterruptionEvent {
|
|
138
138
|
type: 'user_interruption';
|
|
139
139
|
}
|
|
140
|
-
/** Union of all
|
|
141
|
-
type
|
|
140
|
+
/** Union of all agent eventHook payloads. */
|
|
141
|
+
type AgentEvent = AgentTurnEndEvent | AgentUserTranscriptEvent | AgentLlmResponseEvent | AgentUserInterruptionEvent;
|
|
142
142
|
/** Inbound WebSocket message from jambonz. */
|
|
143
143
|
interface WsMessage {
|
|
144
144
|
type: WsMessageType;
|
|
@@ -157,4 +157,4 @@ interface WsResponse {
|
|
|
157
157
|
data?: unknown;
|
|
158
158
|
}
|
|
159
159
|
|
|
160
|
-
export type {
|
|
160
|
+
export type { AgentEvent as A, CallSession as C, TtsStreamingEvent as T, WsMessage as W, AgentEventType as a, AgentLlmResponseEvent as b, AgentPreflightMetrics as c, AgentTurnEndEvent as d, AgentTurnLatency as e, AgentUserInterruptionEvent as f, AgentUserTranscriptEvent as g, TtsStreamingEventType as h, WsMessageType as i, WsResponse as j };
|
|
@@ -94,16 +94,16 @@ interface TtsStreamingEvent {
|
|
|
94
94
|
bargein?: boolean;
|
|
95
95
|
}
|
|
96
96
|
/** WebSocket message types received from jambonz. */
|
|
97
|
-
type WsMessageType = 'session:new' | 'session:adulting' | 'session:reconnect' | 'session:redirect' | 'verb:hook' | 'dial:confirm' | 'call:status' | 'verb:status' | 'llm:event' | 'llm:tool-call' | '
|
|
98
|
-
/**
|
|
99
|
-
type
|
|
97
|
+
type WsMessageType = 'session:new' | 'session:adulting' | 'session:reconnect' | 'session:redirect' | 'verb:hook' | 'dial:confirm' | 'call:status' | 'verb:status' | 'llm:event' | 'llm:tool-call' | 'agent:event' | 'agent:tool-call' | 'tts:streaming-event' | 'tts:tokens-result' | 'jambonz:error';
|
|
98
|
+
/** Agent eventHook event types. */
|
|
99
|
+
type AgentEventType = 'turn_end' | 'user_transcript' | 'llm_response' | 'user_interruption';
|
|
100
100
|
/** Preflight (early generation) metrics. */
|
|
101
|
-
interface
|
|
101
|
+
interface AgentPreflightMetrics {
|
|
102
102
|
result: 'hit' | 'miss' | 'pending';
|
|
103
103
|
tokens?: number;
|
|
104
104
|
}
|
|
105
105
|
/** Per-turn latency metrics (all values in milliseconds). */
|
|
106
|
-
interface
|
|
106
|
+
interface AgentTurnLatency {
|
|
107
107
|
/** STT processing latency: stop talking to final transcript received. */
|
|
108
108
|
transcriber_latency?: number;
|
|
109
109
|
/** Additional wait after transcript for end-of-turn detection. */
|
|
@@ -113,32 +113,32 @@ interface PipelineTurnLatency {
|
|
|
113
113
|
/** TTS engine latency: first text sent to TTS until first audio received. */
|
|
114
114
|
voice_latency?: number;
|
|
115
115
|
/** Early generation metrics. */
|
|
116
|
-
preflight?:
|
|
116
|
+
preflight?: AgentPreflightMetrics;
|
|
117
117
|
}
|
|
118
|
-
/** Payload for
|
|
119
|
-
interface
|
|
118
|
+
/** Payload for agent:event turn_end messages. */
|
|
119
|
+
interface AgentTurnEndEvent {
|
|
120
120
|
type: 'turn_end';
|
|
121
121
|
transcript: string;
|
|
122
122
|
response: string;
|
|
123
123
|
interrupted: boolean;
|
|
124
|
-
latency:
|
|
124
|
+
latency: AgentTurnLatency;
|
|
125
125
|
}
|
|
126
|
-
/** Payload for
|
|
127
|
-
interface
|
|
126
|
+
/** Payload for agent:event user_transcript messages. */
|
|
127
|
+
interface AgentUserTranscriptEvent {
|
|
128
128
|
type: 'user_transcript';
|
|
129
129
|
transcript: string;
|
|
130
130
|
}
|
|
131
|
-
/** Payload for
|
|
132
|
-
interface
|
|
133
|
-
type: '
|
|
131
|
+
/** Payload for agent:event llm_response messages. */
|
|
132
|
+
interface AgentLlmResponseEvent {
|
|
133
|
+
type: 'llm_response';
|
|
134
134
|
response: string;
|
|
135
135
|
}
|
|
136
|
-
/** Payload for
|
|
137
|
-
interface
|
|
136
|
+
/** Payload for agent:event user_interruption messages. */
|
|
137
|
+
interface AgentUserInterruptionEvent {
|
|
138
138
|
type: 'user_interruption';
|
|
139
139
|
}
|
|
140
|
-
/** Union of all
|
|
141
|
-
type
|
|
140
|
+
/** Union of all agent eventHook payloads. */
|
|
141
|
+
type AgentEvent = AgentTurnEndEvent | AgentUserTranscriptEvent | AgentLlmResponseEvent | AgentUserInterruptionEvent;
|
|
142
142
|
/** Inbound WebSocket message from jambonz. */
|
|
143
143
|
interface WsMessage {
|
|
144
144
|
type: WsMessageType;
|
|
@@ -157,4 +157,4 @@ interface WsResponse {
|
|
|
157
157
|
data?: unknown;
|
|
158
158
|
}
|
|
159
159
|
|
|
160
|
-
export type {
|
|
160
|
+
export type { AgentEvent as A, CallSession as C, TtsStreamingEvent as T, WsMessage as W, AgentEventType as a, AgentLlmResponseEvent as b, AgentPreflightMetrics as c, AgentTurnEndEvent as d, AgentTurnLatency as e, AgentUserInterruptionEvent as f, AgentUserTranscriptEvent as g, TtsStreamingEventType as h, WsMessageType as i, WsResponse as j };
|
package/dist/types/index.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as
|
|
2
|
-
export {
|
|
1
|
+
export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as AgentVerb, d as AlertVerb, e as Amd, f as AmdTimers, g as AnswerVerb, h as Auth, B as BidirectionalAudio, C as ConferenceVerb, i as ConfigVerb, D as DequeueVerb, j as DialVerb, k as DtmfVerb, l as DubVerb, E as EnqueueVerb, F as FillerNoise, G as GatherVerb, H as HangupVerb, J as JambonzApp, L as LeaveVerb, m as ListenVerb, n as LlmVerb, M as McpServerConfig, o as MessageVerb, P as PauseVerb, p as PlayVerb, R as Recognizer, q as RedirectVerb, S as SayVerb, r as SipDeclineVerb, s as SipReferVerb, t as SipRequestVerb, u as StreamVerb, v as Synthesizer, T as TagVerb, w as Target, x as TranscribeVerb, V as Vad, y as Verb, z as VerbName } from '../verbs-DKy6nGIH.cjs';
|
|
2
|
+
export { A as AgentEvent, a as AgentEventType, b as AgentLlmResponseEvent, c as AgentPreflightMetrics, d as AgentTurnEndEvent, e as AgentTurnLatency, f as AgentUserInterruptionEvent, g as AgentUserTranscriptEvent, C as CallSession, T as TtsStreamingEvent, h as TtsStreamingEventType, W as WsMessage, i as WsMessageType, j as WsResponse } from '../session-DKaSRkIo.cjs';
|
|
3
3
|
export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from '../common-BSJZX7WO.cjs';
|
|
4
|
-
export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-
|
|
4
|
+
export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-BvOtq44O.cjs';
|
package/dist/types/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as
|
|
2
|
-
export {
|
|
1
|
+
export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as AgentVerb, d as AlertVerb, e as Amd, f as AmdTimers, g as AnswerVerb, h as Auth, B as BidirectionalAudio, C as ConferenceVerb, i as ConfigVerb, D as DequeueVerb, j as DialVerb, k as DtmfVerb, l as DubVerb, E as EnqueueVerb, F as FillerNoise, G as GatherVerb, H as HangupVerb, J as JambonzApp, L as LeaveVerb, m as ListenVerb, n as LlmVerb, M as McpServerConfig, o as MessageVerb, P as PauseVerb, p as PlayVerb, R as Recognizer, q as RedirectVerb, S as SayVerb, r as SipDeclineVerb, s as SipReferVerb, t as SipRequestVerb, u as StreamVerb, v as Synthesizer, T as TagVerb, w as Target, x as TranscribeVerb, V as Vad, y as Verb, z as VerbName } from '../verbs-DKy6nGIH.js';
|
|
2
|
+
export { A as AgentEvent, a as AgentEventType, b as AgentLlmResponseEvent, c as AgentPreflightMetrics, d as AgentTurnEndEvent, e as AgentTurnLatency, f as AgentUserInterruptionEvent, g as AgentUserTranscriptEvent, C as CallSession, T as TtsStreamingEvent, h as TtsStreamingEventType, W as WsMessage, i as WsMessageType, j as WsResponse } from '../session-DKaSRkIo.js';
|
|
3
3
|
export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from '../common-BSJZX7WO.js';
|
|
4
|
-
export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-
|
|
4
|
+
export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-DAAEUWsa.js';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { y as Verb, S as SayVerb, p as PlayVerb, G as GatherVerb,
|
|
1
|
+
import { y as Verb, S as SayVerb, p as PlayVerb, G as GatherVerb, n as LlmVerb, I as S2sVerb, K as LlmBaseOptions, N as DialogflowVerb, c as AgentVerb, m as ListenVerb, u as StreamVerb, x as TranscribeVerb, j as DialVerb, C as ConferenceVerb, E as EnqueueVerb, D as DequeueVerb, H as HangupVerb, q as RedirectVerb, P as PauseVerb, L as LeaveVerb, r as SipDeclineVerb, t as SipRequestVerb, s as SipReferVerb, i as ConfigVerb, g as AnswerVerb, d as AlertVerb, T as TagVerb, k as DtmfVerb, l as DubVerb, o as MessageVerb } from './verbs-DKy6nGIH.cjs';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* Schema-based validation using AJV.
|
|
@@ -68,8 +68,8 @@ declare class VerbBuilder {
|
|
|
68
68
|
ultravox_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
|
|
69
69
|
/** Connect the caller to a Google Dialogflow agent (ES, CX, or CES). */
|
|
70
70
|
dialogflow(opts: Omit<DialogflowVerb, 'verb'>): this;
|
|
71
|
-
/** Voice AI
|
|
72
|
-
|
|
71
|
+
/** Voice AI agent with integrated turn detection. */
|
|
72
|
+
agent(opts: Omit<AgentVerb, 'verb'>): this;
|
|
73
73
|
/** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */
|
|
74
74
|
listen(opts: Omit<ListenVerb, 'verb'>): this;
|
|
75
75
|
/** Stream real-time call audio to a WebSocket endpoint. Synonym for {@link listen}. */
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { y as Verb, S as SayVerb, p as PlayVerb, G as GatherVerb,
|
|
1
|
+
import { y as Verb, S as SayVerb, p as PlayVerb, G as GatherVerb, n as LlmVerb, I as S2sVerb, K as LlmBaseOptions, N as DialogflowVerb, c as AgentVerb, m as ListenVerb, u as StreamVerb, x as TranscribeVerb, j as DialVerb, C as ConferenceVerb, E as EnqueueVerb, D as DequeueVerb, H as HangupVerb, q as RedirectVerb, P as PauseVerb, L as LeaveVerb, r as SipDeclineVerb, t as SipRequestVerb, s as SipReferVerb, i as ConfigVerb, g as AnswerVerb, d as AlertVerb, T as TagVerb, k as DtmfVerb, l as DubVerb, o as MessageVerb } from './verbs-DKy6nGIH.js';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* Schema-based validation using AJV.
|
|
@@ -68,8 +68,8 @@ declare class VerbBuilder {
|
|
|
68
68
|
ultravox_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
|
|
69
69
|
/** Connect the caller to a Google Dialogflow agent (ES, CX, or CES). */
|
|
70
70
|
dialogflow(opts: Omit<DialogflowVerb, 'verb'>): this;
|
|
71
|
-
/** Voice AI
|
|
72
|
-
|
|
71
|
+
/** Voice AI agent with integrated turn detection. */
|
|
72
|
+
agent(opts: Omit<AgentVerb, 'verb'>): this;
|
|
73
73
|
/** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */
|
|
74
74
|
listen(opts: Omit<ListenVerb, 'verb'>): this;
|
|
75
75
|
/** Stream real-time call audio to a WebSocket endpoint. Synonym for {@link listen}. */
|
|
@@ -437,8 +437,8 @@ interface DialogflowVerb {
|
|
|
437
437
|
dtmf?: string;
|
|
438
438
|
};
|
|
439
439
|
}
|
|
440
|
-
interface
|
|
441
|
-
verb: '
|
|
440
|
+
interface AgentVerb {
|
|
441
|
+
verb: 'agent';
|
|
442
442
|
id?: string;
|
|
443
443
|
/** STT configuration. */
|
|
444
444
|
stt: Recognizer;
|
|
@@ -458,9 +458,9 @@ interface PipelineVerb {
|
|
|
458
458
|
};
|
|
459
459
|
/** LLM configuration. */
|
|
460
460
|
llm: Record<string, unknown>;
|
|
461
|
-
/** Webhook when
|
|
461
|
+
/** Webhook when agent ends. */
|
|
462
462
|
actionHook?: ActionHook;
|
|
463
|
-
/** Webhook for
|
|
463
|
+
/** Webhook for agent events. */
|
|
464
464
|
eventHook?: ActionHook;
|
|
465
465
|
/** Webhook when the LLM requests a tool/function call. */
|
|
466
466
|
toolHook?: ActionHook;
|
|
@@ -882,10 +882,10 @@ interface MessageVerb {
|
|
|
882
882
|
actionHook?: ActionHook;
|
|
883
883
|
}
|
|
884
884
|
/** Any jambonz verb. Discriminated on the 'verb' property. */
|
|
885
|
-
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | DialogflowVerb |
|
|
885
|
+
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | DialogflowVerb | AgentVerb | ConferenceVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb;
|
|
886
886
|
/** A jambonz application — an array of verbs executed sequentially. */
|
|
887
887
|
type JambonzApp = Verb[];
|
|
888
888
|
/** All valid verb names. */
|
|
889
889
|
type VerbName = Verb['verb'];
|
|
890
890
|
|
|
891
|
-
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, S2sVerb as I, JambonzApp as J, LlmBaseOptions as K, LeaveVerb as L, McpServerConfig as M, DialogflowVerb as N, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b,
|
|
891
|
+
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, S2sVerb as I, JambonzApp as J, LlmBaseOptions as K, LeaveVerb as L, McpServerConfig as M, DialogflowVerb as N, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AgentVerb as c, AlertVerb as d, Amd as e, AmdTimers as f, AnswerVerb as g, Auth as h, ConfigVerb as i, DialVerb as j, DtmfVerb as k, DubVerb as l, ListenVerb as m, LlmVerb as n, MessageVerb as o, PlayVerb as p, RedirectVerb as q, SipDeclineVerb as r, SipReferVerb as s, SipRequestVerb as t, StreamVerb as u, Synthesizer as v, Target as w, TranscribeVerb as x, Verb as y, VerbName as z };
|
|
@@ -437,8 +437,8 @@ interface DialogflowVerb {
|
|
|
437
437
|
dtmf?: string;
|
|
438
438
|
};
|
|
439
439
|
}
|
|
440
|
-
interface
|
|
441
|
-
verb: '
|
|
440
|
+
interface AgentVerb {
|
|
441
|
+
verb: 'agent';
|
|
442
442
|
id?: string;
|
|
443
443
|
/** STT configuration. */
|
|
444
444
|
stt: Recognizer;
|
|
@@ -458,9 +458,9 @@ interface PipelineVerb {
|
|
|
458
458
|
};
|
|
459
459
|
/** LLM configuration. */
|
|
460
460
|
llm: Record<string, unknown>;
|
|
461
|
-
/** Webhook when
|
|
461
|
+
/** Webhook when agent ends. */
|
|
462
462
|
actionHook?: ActionHook;
|
|
463
|
-
/** Webhook for
|
|
463
|
+
/** Webhook for agent events. */
|
|
464
464
|
eventHook?: ActionHook;
|
|
465
465
|
/** Webhook when the LLM requests a tool/function call. */
|
|
466
466
|
toolHook?: ActionHook;
|
|
@@ -882,10 +882,10 @@ interface MessageVerb {
|
|
|
882
882
|
actionHook?: ActionHook;
|
|
883
883
|
}
|
|
884
884
|
/** Any jambonz verb. Discriminated on the 'verb' property. */
|
|
885
|
-
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | DialogflowVerb |
|
|
885
|
+
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | DialogflowVerb | AgentVerb | ConferenceVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb;
|
|
886
886
|
/** A jambonz application — an array of verbs executed sequentially. */
|
|
887
887
|
type JambonzApp = Verb[];
|
|
888
888
|
/** All valid verb names. */
|
|
889
889
|
type VerbName = Verb['verb'];
|
|
890
890
|
|
|
891
|
-
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, S2sVerb as I, JambonzApp as J, LlmBaseOptions as K, LeaveVerb as L, McpServerConfig as M, DialogflowVerb as N, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b,
|
|
891
|
+
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, S2sVerb as I, JambonzApp as J, LlmBaseOptions as K, LeaveVerb as L, McpServerConfig as M, DialogflowVerb as N, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AgentVerb as c, AlertVerb as d, Amd as e, AmdTimers as f, AnswerVerb as g, Auth as h, ConfigVerb as i, DialVerb as j, DtmfVerb as k, DubVerb as l, ListenVerb as m, LlmVerb as n, MessageVerb as o, PlayVerb as p, RedirectVerb as q, SipDeclineVerb as r, SipReferVerb as s, SipRequestVerb as t, StreamVerb as u, Synthesizer as v, Target as w, TranscribeVerb as x, Verb as y, VerbName as z };
|
package/dist/webhook/index.cjs
CHANGED
|
@@ -156,9 +156,9 @@ var VerbBuilder = class {
|
|
|
156
156
|
dialogflow(opts) {
|
|
157
157
|
return this.addVerb({ verb: "dialogflow", ...opts });
|
|
158
158
|
}
|
|
159
|
-
/** Voice AI
|
|
160
|
-
|
|
161
|
-
return this.addVerb({ verb: "
|
|
159
|
+
/** Voice AI agent with integrated turn detection. */
|
|
160
|
+
agent(opts) {
|
|
161
|
+
return this.addVerb({ verb: "agent", ...opts });
|
|
162
162
|
}
|
|
163
163
|
/** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */
|
|
164
164
|
listen(opts) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/validator.ts","../../src/verb-builder.ts","../../src/webhook/response.ts","../../src/webhook/env-vars.ts"],"names":["createRequire","dir","resolve","existsSync","dirname","fileURLToPath","readdirSync","basename","readFileSync","Ajv","createHmac","timingSafeEqual"],"mappings":";;;;;;;;;;;;;;;AAsBA,SAAS,aAAA,GAAwB;AAE/B,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAMA,sBAAA,CAAc,2PAAe,CAAA;AACzC,IAAA,MAAM,WAAA,GAAc,GAAA,CAAI,OAAA,CAAQ,iBAAiB,CAAA;AACjD,IAAA,MAAMC,IAAAA,GAAMC,YAAA,CAAQ,WAAA,EAAa,IAAI,CAAA;AACrC,IAAA,IAAIC,aAAA,CAAWD,YAAA,CAAQD,IAAAA,EAAK,yBAAyB,CAAC,CAAA,EAAG;AACvD,MAAA,OAAOA,IAAAA;AAAA,IACT;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAGA,EAAA,MAAM,UAAA,GAAa,OAAO,SAAA,KAAc,WAAA,GACpC,YACAG,YAAA,CAAQC,iBAAA,CAAc,2PAAe,CAAC,CAAA;AAE1C,EAAA,IAAI,GAAA,GAAM,UAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,EAAA,EAAI,CAAA,EAAA,EAAK;AAC3B,IAAA,MAAM,SAAA,GAAYH,YAAA,CAAQ,GAAA,EAAK,cAAA,EAAgB,YAAY,QAAQ,CAAA;AACnE,IAAA,IAAIC,aAAA,CAAWD,YAAA,CAAQ,SAAA,EAAW,yBAAyB,CAAC,CAAA,EAAG;AAC7D,MAAA,OAAO,SAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GAASE,aAAQ,GAAG,CAAA;AAC1B,IAAA,IAAI,WAAW,GAAA,EAAK;AACpB,IAAA,GAAA,GAAM,MAAA;AAAA,EACR;AAEA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR;AAAA,GACF;AACF;AAGA,SAAS,gBAAgB,GAAA,EAAuB;AAC9C,EAAA,IAAI;AACF,IAAA,OAAOE,eAAY,GAAG,CAAA,CACnB,MAAA,CAAO,CAAC,MAAM,CAAA,CAAE,QAAA,CAAS,cAAc,CAAC,EACxC,GAAA,CAAI,CAAC,MAAMC,aAAA,CAAS,CAAA,EAAG,cAAc,CAAC,CAAA;AAAA,EAC3C,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AAEA,SAAS,WAAW,QAAA,EAA2C;AAC7D,EAAA,OAAO,IAAA,CAAK,KAAA,CAAMC,eAAA,CAAa,QAAA,EAAU,OAAO,CAAC,CAAA;AACnD;AAEO,IAAM,mBAAN,MAAuB;AAAA,EACpB,WAAA;AAAA,EACA,GAAA;AAAA,EAER,YAAY,SAAA,EAAoB;AAC9B,IAAA,MAAM,GAAA,GAAM,aAAa,aAAA,EAAc;AACvC,IAAA,IAAA,CAAK,GAAA,GAAM,IAAIC,oBAAA,CAAI;AAAA,MACjB,SAAA,EAAW,IAAA;AAAA,MACX,MAAA,EAAQ,KAAA;AAAA,MACR,cAAA,EAAgB,KAAA;AAAA,MAChB,MAAA,EAAQ;AAAA,KACT,CAAA;AAGD,IAAA,MAAM,aAAA,GAAgBP,YAAA,CAAQ,GAAA,EAAK,YAAY,CAAA;AAC/C,IAAA,KAAA,MAAW,IAAA,IAAQ,eAAA,CAAgB,aAAa,CAAA,EAAG;AACjD,MAAA,MAAM,SAAS,UAAA,CAAWA,YAAA,CAAQ,eAAe,CAAA,EAAG,IAAI,cAAc,CAAC,CAAA;AACvE,MAAA,IAAA,CAAK,GAAA,CAAI,UAAU,MAAM,CAAA;AAAA,IAC3B;AAGA,IAAA,MAAM,QAAA,GAAWA,YAAA,CAAQ,GAAA,EAAK,OAAO,CAAA;AACrC,IAAA,KAAA,MAAW,IAAA,IAAQ,eAAA,CAAgB,QAAQ,CAAA,EAAG;AAC5C,MAAA,MAAM,SAAS,UAAA,CAAWA,YAAA,CAAQ,UAAU,CAAA,EAAG,IAAI,cAAc,CAAC,CAAA;AAClE,MAAA,IAAA,CAAK,GAAA,CAAI,UAAU,MAAM,CAAA;AAAA,IAC3B;AAGA,IAAA,MAAM,SAAA,GAAY,UAAA,CAAWA,YAAA,CAAQ,GAAA,EAAK,yBAAyB,CAAC,CAAA;AACpE,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,SAAS,CAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,SAAS,GAAA,EAAgC;AACvC,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,WAAA,CAAY,GAAG,CAAA;AAClC,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,MAAA,EAAQ,EAAC,EAAE;AAAA,IACnC;AACA,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,KAAA;AAAA,MACP,MAAA,EAAQ,YAAA,CAAa,IAAA,CAAK,WAAA,CAAY,MAAM;AAAA,KAC9C;AAAA,EACF;AAAA;AAAA,EAGA,aAAa,IAAA,EAAiC;AAE5C,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,CAAC,IAAI,CAAC,CAAA;AAAA,EAC7B;AACF,CAAA;AAEA,SAAS,aAAa,MAAA,EAA6D;AACjF,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,EAAC;AACrB,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,IAC1B,IAAA,EAAM,IAAI,YAAA,IAAgB,GAAA;AAAA,IAC1B,OAAA,EAAS,IAAI,OAAA,IAAW;AAAA,GAC1B,CAAE,CAAA;AACJ;;;AC9EO,IAAM,cAAN,MAAkB;AAAA,EACb,QAAgB,EAAC;AAAA,EACjB,SAAA;AAAA;AAAA;AAAA;AAAA,EAKV,YAAY,IAAA,EAA2B;AACrC,IAAA,IAAI,IAAA,EAAM,aAAa,KAAA,EAAO;AAC5B,MAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AAAA,IACnB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,SAAA,GAAY,IAAI,gBAAA,CAAiB,IAAA,EAAM,SAAS,CAAA;AAAA,IACvD;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,KAAK,IAAA,EAAoC;AACvC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,MAAA,EAAQ,GAAG,MAAM,CAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA;AAAA,EAKA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,WAAW,IAAA,EAA4C;AACrD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA;AAAA,EAGA,WAAW,IAAA,EAA4C;AACrD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA;AAAA,EAGA,eAAe,IAAA,EAA4C;AACzD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,gBAAA,EAAkB,GAAG,MAAM,CAAA;AAAA,EACzD;AAAA;AAAA,EAGA,aAAa,IAAA,EAA4C;AACvD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,cAAA,EAAgB,GAAG,MAAM,CAAA;AAAA,EACvD;AAAA;AAAA,EAGA,aAAa,IAAA,EAA4C;AACvD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,cAAA,EAAgB,GAAG,MAAM,CAAA;AAAA,EACvD;AAAA;AAAA,EAGA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA;AAAA,EAGA,SAAS,IAAA,EAAwC;AAC/C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,UAAA,EAAY,GAAG,MAAM,CAAA;AAAA,EACnD;AAAA;AAAA,EAGA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA;AAAA;AAAA,EAKA,KAAK,IAAA,EAAoC;AACvC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,MAAA,EAAQ,GAAG,MAAM,CAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA;AAAA,EAGA,QAAQ,IAAA,EAAuC;AAC7C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,SAAA,EAAW,GAAG,MAAM,CAAA;AAAA,EAClD;AAAA;AAAA,EAGA,QAAQ,IAAA,EAAuC;AAC7C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,SAAA,EAAW,GAAG,MAAM,CAAA;AAAA,EAClD;AAAA;AAAA,EAGA,OAAO,IAAA,EAAuC;AAC5C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,SAAS,IAAA,EAAwC;AAC/C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,UAAA,EAAY,GAAG,MAAM,CAAA;AAAA,EACnD;AAAA;AAAA,EAGA,MAAM,IAAA,EAAqC;AACzC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,GAAG,MAAM,CAAA;AAAA,EAChD;AAAA;AAAA,EAGA,MAAM,IAAA,EAAsC;AAC1C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,GAAG,MAAM,CAAA;AAAA,EAChD;AAAA;AAAA;AAAA,EAKA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,aAAA,EAAe,GAAG,MAAM,CAAA;AAAA,EACtD;AAAA;AAAA,EAGA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,aAAA,EAAe,GAAG,MAAM,CAAA;AAAA,EACtD;AAAA;AAAA,EAGA,SAAS,IAAA,EAAwC;AAC/C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,WAAA,EAAa,GAAG,MAAM,CAAA;AAAA,EACpD;AAAA;AAAA;AAAA,EAKA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,OAAO,IAAA,EAAuC;AAC5C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,MAAM,IAAA,EAAqC;AACzC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,GAAG,MAAM,CAAA;AAAA,EAChD;AAAA;AAAA,EAGA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,KAAK,IAAA,EAAoC;AACvC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,MAAA,EAAQ,GAAG,MAAM,CAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,QAAQ,IAAA,EAAuC;AAC7C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,SAAA,EAAW,GAAG,MAAM,CAAA;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAS,KAAA,EAAqB;AAC5B,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,KAAK,CAAA;AAC5C,MAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,IAAI,KAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9E,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAA2B,QAAQ,CAAA,CAAE,CAAA;AAAA,MACvD;AAAA,IACF;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,KAAK,CAAA;AACxB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAIU,QAAQ,IAAA,EAAkB;AAClC,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,YAAA,CAAa,IAAI,CAAA;AAC/C,MAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,IAAI,KAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9E,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,MAAA,EAAS,KAAK,IAAI,CAAA,qBAAA,EAAwB,QAAQ,CAAA,CAAE,CAAA;AAAA,MACtE;AAAA,IACF;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,KAAK,IAAI,CAAA;AACpB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,KAAK,KAAA,CAAM,MAAA;AAAA,EACpB;AAAA;AAAA,EAGA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAQ,EAAC;AACd,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAGA,MAAA,GAAiB;AACf,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,KAAK,CAAA;AAAA,EACvB;AACF,CAAA;;;ACxQO,IAAM,eAAA,GAAN,cAA8B,WAAA,CAAY;AAAA;AAAA,EAE/C,YAAY,IAAA,EAA2B;AACrC,IAAA,KAAA,CAAM,IAAI,CAAA;AAAA,EACZ;AAAA;AAAA,EAGA,MAAA,GAAqB;AACnB,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,KAAK,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,eAAA,CAAgB,MAAA,EAAgB,IAAA,EAA+B;AACpE,IAAA,MAAM,SAAA,GAAY,MAAM,SAAA,IAAa,GAAA;AAErC,IAAA,OAAO,CACL,GAAA,EACA,IAAA,EACA,IAAA,KACG;AACH,MAAA,IAAI;AACF,QAAA,MAAM,SAAA,GAAa,GAAA,CAAI,OAAA,CAA+C,mBAAmB,CAAA;AACzF,QAAA,IAAI,CAAC,SAAA,EAAW;AACd,UAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,QACpD;AAEA,QAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,KAAA,CAAM,GAAG,CAAA;AACjC,QAAA,IAAI,SAAA,GAAY,EAAA;AAChB,QAAA,MAAM,aAAuB,EAAC;AAE9B,QAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,UAAA,MAAM,CAAC,GAAA,EAAK,KAAK,CAAA,GAAI,IAAA,CAAK,MAAM,GAAG,CAAA;AACnC,UAAA,IAAI,GAAA,KAAQ,KAAK,SAAA,GAAY,KAAA;AAAA,eAAA,IACpB,GAAA,KAAQ,IAAA,EAAM,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA;AAAA,QAC9C;AAEA,QAAA,IAAI,CAAC,SAAA,IAAa,UAAA,CAAW,MAAA,KAAW,CAAA,EAAG;AACzC,UAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,QACpD;AAGA,QAAA,MAAM,EAAA,GAAK,QAAA,CAAS,SAAA,EAAW,EAAE,CAAA;AACjC,QAAA,MAAM,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,KAAQ,GAAI,CAAA;AACxC,QAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAA,GAAM,EAAE,IAAI,SAAA,EAAW;AAClC,UAAA,MAAM,IAAI,MAAM,+CAA+C,CAAA;AAAA,QACjE;AAGA,QAAA,MAAM,OAAA,GAAU,OAAO,GAAA,CAAI,IAAA,KAAS,QAAA,GAChC,IAAI,IAAA,GACJ,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAC3B,QAAA,MAAM,aAAA,GAAgB,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA;AAC7C,QAAA,MAAM,QAAA,GAAWQ,kBAAW,QAAA,EAAU,MAAM,EACzC,MAAA,CAAO,aAAa,CAAA,CACpB,MAAA,CAAO,KAAK,CAAA;AAGf,QAAA,MAAM,OAAA,GAAU,UAAA,CAAW,IAAA,CAAK,CAAC,GAAA,KAAQ;AACvC,UAAA,IAAI;AACF,YAAA,OAAOC,sBAAA,CAAgB,OAAO,IAAA,CAAK,GAAG,GAAG,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA,UAChE,CAAA,CAAA,MAAQ;AACN,YAAA,OAAO,KAAA;AAAA,UACT;AAAA,QACF,CAAC,CAAA;AAED,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA,MAAM,IAAI,MAAM,uCAAuC,CAAA;AAAA,QACzD;AAEA,QAAA,IAAA,EAAK;AAAA,MACP,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,MAC1D;AAAA,IACF,CAAA;AAAA,EACF;AACF;;;AC9EO,SAAS,kBAAkB,MAAA,EAAsB;AACtD,EAAA,OAAO,CAAC,GAAA,EAAyB,GAAA,EAAwC,IAAA,KAAqB;AAC5F,IAAA,IAAI,GAAA,CAAI,WAAW,SAAA,EAAW;AAC5B,MAAA,GAAA,CAAI,KAAK,MAAM,CAAA;AACf,MAAA;AAAA,IACF;AACA,IAAA,IAAA,EAAK;AAAA,EACP,CAAA;AACF","file":"index.cjs","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all JSON schemas from the @jambonz/schema package.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync, readdirSync, existsSync } from 'fs';\nimport { resolve, dirname, basename } from 'path';\nimport { fileURLToPath } from 'url';\nimport { createRequire } from 'module';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n/** Locate the @jambonz/schema package directory. */\nfunction findSchemaDir(): string {\n // Method 1: use createRequire to resolve the package\n try {\n const req = createRequire(import.meta.url);\n const schemaIndex = req.resolve('@jambonz/schema');\n const dir = resolve(schemaIndex, '..');\n if (existsSync(resolve(dir, 'jambonz-app.schema.json'))) {\n return dir;\n }\n } catch {\n // fall through\n }\n\n // Method 2: walk up from this file to find node_modules/@jambonz/schema\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n let dir = currentDir;\n for (let i = 0; i < 10; i++) {\n const candidate = resolve(dir, 'node_modules', '@jambonz', 'schema');\n if (existsSync(resolve(candidate, 'jambonz-app.schema.json'))) {\n return candidate;\n }\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n\n throw new Error(\n 'Could not find @jambonz/schema package. Ensure it is installed as a dependency.'\n );\n}\n\n/** Discover schema files in a subdirectory. */\nfunction discoverSchemas(dir: string): string[] {\n try {\n return readdirSync(dir)\n .filter((f) => f.endsWith('.schema.json'))\n .map((f) => basename(f, '.schema.json'));\n } catch {\n return [];\n }\n}\n\nfunction loadSchema(filePath: string): Record<string, unknown> {\n return JSON.parse(readFileSync(filePath, 'utf-8')) as Record<string, unknown>;\n}\n\nexport class JambonzValidator {\n private validateApp: ValidateFunction;\n private ajv: Ajv;\n\n constructor(schemaDir?: string) {\n const dir = schemaDir ?? findSchemaDir();\n this.ajv = new Ajv({\n allErrors: true,\n strict: false,\n validateSchema: false,\n logger: false,\n });\n\n // Register component schemas first (they are referenced by verb schemas)\n const componentsDir = resolve(dir, 'components');\n for (const name of discoverSchemas(componentsDir)) {\n const schema = loadSchema(resolve(componentsDir, `${name}.schema.json`));\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n const verbsDir = resolve(dir, 'verbs');\n for (const name of discoverSchemas(verbsDir)) {\n const schema = loadSchema(resolve(verbsDir, `${name}.schema.json`));\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(resolve(dir, 'jambonz-app.schema.json'));\n this.validateApp = this.ajv.compile(appSchema);\n }\n\n /** Validate a complete verb array (a jambonz application). */\n validate(app: unknown): ValidationResult {\n const valid = this.validateApp(app);\n if (valid) {\n return { valid: true, errors: [] };\n }\n return {\n valid: false,\n errors: formatErrors(this.validateApp.errors),\n };\n }\n\n /** Validate a single verb object. */\n validateVerb(verb: unknown): ValidationResult {\n // Wrap in an array and validate as an app\n return this.validate([verb]);\n }\n}\n\nfunction formatErrors(errors: ErrorObject[] | null | undefined): ValidationError[] {\n if (!errors) return [];\n return errors.map((err) => ({\n path: err.instancePath || '/',\n message: err.message || 'Unknown validation error',\n }));\n}\n\nlet _defaultValidator: JambonzValidator | null = null;\n\n/** Get a shared validator instance. */\nexport function getValidator(schemaDir?: string): JambonzValidator {\n if (!_defaultValidator) {\n _defaultValidator = new JambonzValidator(schemaDir);\n }\n return _defaultValidator;\n}\n","/**\n * Shared VerbBuilder base class.\n * Provides typed verb methods and raw JSON input for both WebhookResponse and WS Session.\n */\n\nimport type {\n AlertVerb,\n AnswerVerb,\n ConferenceVerb,\n ConfigVerb,\n DequeueVerb,\n DialogflowVerb,\n DialVerb,\n DtmfVerb,\n DubVerb,\n EnqueueVerb,\n GatherVerb,\n HangupVerb,\n LeaveVerb,\n ListenVerb,\n LlmBaseOptions,\n LlmVerb,\n MessageVerb,\n PauseVerb,\n PipelineVerb,\n PlayVerb,\n RedirectVerb,\n S2sVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n Verb,\n} from './types/verbs.js';\nimport { JambonzValidator } from './validator.js';\n\nexport interface VerbBuilderOptions {\n /** Enable runtime schema validation. Default: true. */\n validate?: boolean;\n /** Path to schema directory. Auto-detected if omitted. */\n schemaDir?: string;\n}\n\n/**\n * Base class for building jambonz verb arrays. Extended by {@link WebhookResponse}\n * and WsSession. Provides typed verb methods and optional runtime schema validation.\n */\nexport class VerbBuilder {\n protected verbs: Verb[] = [];\n protected validator: JambonzValidator | null;\n\n /**\n * @param opts - Options for validation and schema directory.\n */\n constructor(opts?: VerbBuilderOptions) {\n if (opts?.validate === false) {\n this.validator = null;\n } else {\n this.validator = new JambonzValidator(opts?.schemaDir);\n }\n }\n\n // --- Audio & Speech ---\n\n /** Speak text using TTS. Supports SSML, multiple voices, and streaming. */\n say(opts: Omit<SayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'say', ...opts });\n }\n\n /** Play an audio file from a URL. */\n play(opts: Omit<PlayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'play', ...opts });\n }\n\n /** Collect speech (STT) and/or DTMF input from the caller. */\n gather(opts: Omit<GatherVerb, 'verb'>): this {\n return this.addVerb({ verb: 'gather', ...opts });\n }\n\n // --- AI & Real-time ---\n\n /** Connect the caller to an LLM for real-time voice conversation. */\n llm(opts: Omit<LlmVerb, 'verb'>): this {\n return this.addVerb({ verb: 'llm', ...opts });\n }\n\n /** Synonym for {@link llm}. Requires vendor to be specified. */\n s2s(opts: Omit<S2sVerb, 'verb'>): this {\n return this.addVerb({ verb: 's2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='openai'. */\n openai_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'openai_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='google'. */\n google_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'google_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='elevenlabs'. */\n elevenlabs_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'elevenlabs_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='deepgram'. */\n deepgram_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'deepgram_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='ultravox'. */\n ultravox_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'ultravox_s2s', ...opts });\n }\n\n /** Connect the caller to a Google Dialogflow agent (ES, CX, or CES). */\n dialogflow(opts: Omit<DialogflowVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dialogflow', ...opts });\n }\n\n /** Voice AI pipeline with integrated turn detection. */\n pipeline(opts: Omit<PipelineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pipeline', ...opts });\n }\n\n /** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */\n listen(opts: Omit<ListenVerb, 'verb'>): this {\n return this.addVerb({ verb: 'listen', ...opts });\n }\n\n /** Stream real-time call audio to a WebSocket endpoint. Synonym for {@link listen}. */\n stream(opts: Omit<StreamVerb, 'verb'>): this {\n return this.addVerb({ verb: 'stream', ...opts });\n }\n\n /** Real-time call transcription sent to a webhook. */\n transcribe(opts: Omit<TranscribeVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transcribe', ...opts });\n }\n\n // --- Call Control ---\n\n /** Place an outbound call and bridge it to the current caller. */\n dial(opts: Omit<DialVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dial', ...opts });\n }\n\n /** Join or create a multi-party conference room. */\n conference(opts: Omit<ConferenceVerb, 'verb'>): this {\n return this.addVerb({ verb: 'conference', ...opts });\n }\n\n /** Place the caller into a named queue. */\n enqueue(opts: Omit<EnqueueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'enqueue', ...opts });\n }\n\n /** Remove a caller from a queue and bridge them. */\n dequeue(opts: Omit<DequeueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dequeue', ...opts });\n }\n\n /** End the call. */\n hangup(opts?: Omit<HangupVerb, 'verb'>): this {\n return this.addVerb({ verb: 'hangup', ...opts });\n }\n\n /** Transfer control to a different webhook URL. */\n redirect(opts: Omit<RedirectVerb, 'verb'>): this {\n return this.addVerb({ verb: 'redirect', ...opts });\n }\n\n /** Wait for a specified duration before continuing. */\n pause(opts: Omit<PauseVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pause', ...opts });\n }\n\n /** Leave a conference or queue. */\n leave(opts?: Omit<LeaveVerb, 'verb'>): this {\n return this.addVerb({ verb: 'leave', ...opts });\n }\n\n // --- SIP ---\n\n /** Reject an incoming call with a SIP error response. */\n sipDecline(opts: Omit<SipDeclineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:decline', ...opts });\n }\n\n /** Send a SIP INFO or other request within the dialog. */\n sipRequest(opts: Omit<SipRequestVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:request', ...opts });\n }\n\n /** Transfer the call via SIP REFER. */\n sipRefer(opts: Omit<SipReferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:refer', ...opts });\n }\n\n // --- Utility ---\n\n /** Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.). */\n config(opts: Omit<ConfigVerb, 'verb'>): this {\n return this.addVerb({ verb: 'config', ...opts });\n }\n\n /** Explicitly answer the call (sends a 200 OK). */\n answer(opts?: Omit<AnswerVerb, 'verb'>): this {\n return this.addVerb({ verb: 'answer', ...opts });\n }\n\n /** Send a SIP 180 Ringing with optional Alert-Info header. */\n alert(opts: Omit<AlertVerb, 'verb'>): this {\n return this.addVerb({ verb: 'alert', ...opts });\n }\n\n /** Attach metadata to the call for tracking or routing. */\n tag(opts: Omit<TagVerb, 'verb'>): this {\n return this.addVerb({ verb: 'tag', ...opts });\n }\n\n /** Send DTMF tones into the call. */\n dtmf(opts: Omit<DtmfVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dtmf', ...opts });\n }\n\n /** Mix an auxiliary audio track into the call. */\n dub(opts: Omit<DubVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dub', ...opts });\n }\n\n /** Send an SMS or MMS message. */\n message(opts: Omit<MessageVerb, 'verb'>): this {\n return this.addVerb({ verb: 'message', ...opts });\n }\n\n // --- Raw JSON input (primary AI agent path) ---\n\n /**\n * Add one or more verbs from raw JSON.\n * Validates against the JSON schemas at runtime if validation is enabled.\n */\n addVerbs(verbs: Verb[]): this {\n if (this.validator) {\n const result = this.validator.validate(verbs);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb validation failed: ${messages}`);\n }\n }\n this.verbs.push(...verbs);\n return this;\n }\n\n // --- Internal ---\n\n protected addVerb(verb: Verb): this {\n if (this.validator) {\n const result = this.validator.validateVerb(verb);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb '${verb.verb}' validation failed: ${messages}`);\n }\n }\n this.verbs.push(verb);\n return this;\n }\n\n /** Get the current verb count. */\n get length(): number {\n return this.verbs.length;\n }\n\n /** Clear all queued verbs. */\n clear(): this {\n this.verbs = [];\n return this;\n }\n\n /** Returns a copy of the current verb array. */\n toJSON(): Verb[] {\n return [...this.verbs];\n }\n}\n","/**\n * WebhookResponse — verb builder for HTTP webhook applications.\n * Extends VerbBuilder with toJSON() and signature verification.\n */\n\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { VerbBuilder, type VerbBuilderOptions } from '../verb-builder.js';\nimport type { JambonzApp } from '../types/verbs.js';\nimport type { IncomingMessage, ServerResponse } from 'http';\n\n/**\n * Verb builder for HTTP webhook applications.\n * Construct one per request, chain verb methods, and pass to `res.json()`.\n *\n * @example\n * ```typescript\n * app.post('/incoming', (req, res) => {\n * const jambonz = new WebhookResponse();\n * jambonz.say({ text: 'Hello!' }).hangup();\n * res.json(jambonz);\n * });\n * ```\n */\nexport class WebhookResponse extends VerbBuilder {\n /** @param opts - Options for validation and schema directory. */\n constructor(opts?: VerbBuilderOptions) {\n super(opts);\n }\n\n /** Returns the verb array for JSON serialization. */\n toJSON(): JambonzApp {\n return [...this.verbs];\n }\n\n /**\n * Express-compatible middleware for verifying jambonz webhook signatures.\n * Uses HMAC-SHA256 with timing-safe comparison.\n */\n static verifySignature(secret: string, opts?: { tolerance?: number }) {\n const tolerance = opts?.tolerance ?? 300; // 5 minutes default\n\n return (\n req: IncomingMessage & { body?: unknown; rawBody?: Buffer },\n _res: ServerResponse,\n next: (err?: Error) => void\n ) => {\n try {\n const signature = (req.headers as Record<string, string | undefined>)['jambonz-signature'];\n if (!signature) {\n throw new Error('Missing Jambonz-Signature header');\n }\n\n const parts = signature.split(',');\n let timestamp = '';\n const signatures: string[] = [];\n\n for (const part of parts) {\n const [key, value] = part.split('=');\n if (key === 't') timestamp = value;\n else if (key === 'v1') signatures.push(value);\n }\n\n if (!timestamp || signatures.length === 0) {\n throw new Error('Invalid Jambonz-Signature format');\n }\n\n // Check timestamp tolerance\n const ts = parseInt(timestamp, 10);\n const now = Math.floor(Date.now() / 1000);\n if (Math.abs(now - ts) > tolerance) {\n throw new Error('Webhook signature timestamp outside tolerance');\n }\n\n // Compute expected signature\n const payload = typeof req.body === 'string'\n ? req.body\n : JSON.stringify(req.body);\n const signedPayload = `${timestamp}.${payload}`;\n const expected = createHmac('sha256', secret)\n .update(signedPayload)\n .digest('hex');\n\n // Timing-safe comparison\n const matched = signatures.some((sig) => {\n try {\n return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));\n } catch {\n return false;\n }\n });\n\n if (!matched) {\n throw new Error('Webhook signature verification failed');\n }\n\n next();\n } catch (err) {\n next(err instanceof Error ? err : new Error(String(err)));\n }\n };\n }\n}\n","/**\n * Express middleware that auto-responds to HTTP OPTIONS requests with the\n * application environment variables schema for jambonz portal discovery.\n */\n\nimport type { EnvVarSchema } from '../types/common.js';\n\n/**\n * Express middleware that auto-responds to HTTP OPTIONS requests with the\n * application's environment variable schema, enabling jambonz portal discovery.\n *\n * @param schema - The environment variable schema to expose.\n *\n * @example\n * ```typescript\n * import { envVarsMiddleware } from '@jambonz/sdk/webhook';\n *\n * const envVars = {\n * API_KEY: { type: 'string', description: 'Your API key', required: true },\n * };\n * app.use(envVarsMiddleware(envVars));\n * ```\n */\nexport function envVarsMiddleware(schema: EnvVarSchema) {\n return (req: { method: string }, res: { json: (body: unknown) => void }, next: () => void) => {\n if (req.method === 'OPTIONS') {\n res.json(schema);\n return;\n }\n next();\n };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../../src/validator.ts","../../src/verb-builder.ts","../../src/webhook/response.ts","../../src/webhook/env-vars.ts"],"names":["createRequire","dir","resolve","existsSync","dirname","fileURLToPath","readdirSync","basename","readFileSync","Ajv","createHmac","timingSafeEqual"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all JSON schemas from the @jambonz/schema package.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync, readdirSync, existsSync } from 'fs';\nimport { resolve, dirname, basename } from 'path';\nimport { fileURLToPath } from 'url';\nimport { createRequire } from 'module';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n/** Locate the @jambonz/schema package directory. */\nfunction findSchemaDir(): string {\n // Method 1: use createRequire to resolve the package\n try {\n const req = createRequire(import.meta.url);\n const schemaIndex = req.resolve('@jambonz/schema');\n const dir = resolve(schemaIndex, '..');\n if (existsSync(resolve(dir, 'jambonz-app.schema.json'))) {\n return dir;\n }\n } catch {\n // fall through\n }\n\n // Method 2: walk up from this file to find node_modules/@jambonz/schema\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n let dir = currentDir;\n for (let i = 0; i < 10; i++) {\n const candidate = resolve(dir, 'node_modules', '@jambonz', 'schema');\n if (existsSync(resolve(candidate, 'jambonz-app.schema.json'))) {\n return candidate;\n }\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n\n throw new Error(\n 'Could not find @jambonz/schema package. Ensure it is installed as a dependency.'\n );\n}\n\n/** Discover schema files in a subdirectory. */\nfunction discoverSchemas(dir: string): string[] {\n try {\n return readdirSync(dir)\n .filter((f) => f.endsWith('.schema.json'))\n .map((f) => basename(f, '.schema.json'));\n } catch {\n return [];\n }\n}\n\nfunction loadSchema(filePath: string): Record<string, unknown> {\n return JSON.parse(readFileSync(filePath, 'utf-8')) as Record<string, unknown>;\n}\n\nexport class JambonzValidator {\n private validateApp: ValidateFunction;\n private ajv: Ajv;\n\n constructor(schemaDir?: string) {\n const dir = schemaDir ?? findSchemaDir();\n this.ajv = new Ajv({\n allErrors: true,\n strict: false,\n validateSchema: false,\n logger: false,\n });\n\n // Register component schemas first (they are referenced by verb schemas)\n const componentsDir = resolve(dir, 'components');\n for (const name of discoverSchemas(componentsDir)) {\n const schema = loadSchema(resolve(componentsDir, `${name}.schema.json`));\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n const verbsDir = resolve(dir, 'verbs');\n for (const name of discoverSchemas(verbsDir)) {\n const schema = loadSchema(resolve(verbsDir, `${name}.schema.json`));\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(resolve(dir, 'jambonz-app.schema.json'));\n this.validateApp = this.ajv.compile(appSchema);\n }\n\n /** Validate a complete verb array (a jambonz application). */\n validate(app: unknown): ValidationResult {\n const valid = this.validateApp(app);\n if (valid) {\n return { valid: true, errors: [] };\n }\n return {\n valid: false,\n errors: formatErrors(this.validateApp.errors),\n };\n }\n\n /** Validate a single verb object. */\n validateVerb(verb: unknown): ValidationResult {\n // Wrap in an array and validate as an app\n return this.validate([verb]);\n }\n}\n\nfunction formatErrors(errors: ErrorObject[] | null | undefined): ValidationError[] {\n if (!errors) return [];\n return errors.map((err) => ({\n path: err.instancePath || '/',\n message: err.message || 'Unknown validation error',\n }));\n}\n\nlet _defaultValidator: JambonzValidator | null = null;\n\n/** Get a shared validator instance. */\nexport function getValidator(schemaDir?: string): JambonzValidator {\n if (!_defaultValidator) {\n _defaultValidator = new JambonzValidator(schemaDir);\n }\n return _defaultValidator;\n}\n","/**\n * Shared VerbBuilder base class.\n * Provides typed verb methods and raw JSON input for both WebhookResponse and WS Session.\n */\n\nimport type {\n AgentVerb,\n AlertVerb,\n AnswerVerb,\n ConferenceVerb,\n ConfigVerb,\n DequeueVerb,\n DialogflowVerb,\n DialVerb,\n DtmfVerb,\n DubVerb,\n EnqueueVerb,\n GatherVerb,\n HangupVerb,\n LeaveVerb,\n ListenVerb,\n LlmBaseOptions,\n LlmVerb,\n MessageVerb,\n PauseVerb,\n PlayVerb,\n RedirectVerb,\n S2sVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n Verb,\n} from './types/verbs.js';\nimport { JambonzValidator } from './validator.js';\n\nexport interface VerbBuilderOptions {\n /** Enable runtime schema validation. Default: true. */\n validate?: boolean;\n /** Path to schema directory. Auto-detected if omitted. */\n schemaDir?: string;\n}\n\n/**\n * Base class for building jambonz verb arrays. Extended by {@link WebhookResponse}\n * and WsSession. Provides typed verb methods and optional runtime schema validation.\n */\nexport class VerbBuilder {\n protected verbs: Verb[] = [];\n protected validator: JambonzValidator | null;\n\n /**\n * @param opts - Options for validation and schema directory.\n */\n constructor(opts?: VerbBuilderOptions) {\n if (opts?.validate === false) {\n this.validator = null;\n } else {\n this.validator = new JambonzValidator(opts?.schemaDir);\n }\n }\n\n // --- Audio & Speech ---\n\n /** Speak text using TTS. Supports SSML, multiple voices, and streaming. */\n say(opts: Omit<SayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'say', ...opts });\n }\n\n /** Play an audio file from a URL. */\n play(opts: Omit<PlayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'play', ...opts });\n }\n\n /** Collect speech (STT) and/or DTMF input from the caller. */\n gather(opts: Omit<GatherVerb, 'verb'>): this {\n return this.addVerb({ verb: 'gather', ...opts });\n }\n\n // --- AI & Real-time ---\n\n /** Connect the caller to an LLM for real-time voice conversation. */\n llm(opts: Omit<LlmVerb, 'verb'>): this {\n return this.addVerb({ verb: 'llm', ...opts });\n }\n\n /** Synonym for {@link llm}. Requires vendor to be specified. */\n s2s(opts: Omit<S2sVerb, 'verb'>): this {\n return this.addVerb({ verb: 's2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='openai'. */\n openai_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'openai_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='google'. */\n google_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'google_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='elevenlabs'. */\n elevenlabs_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'elevenlabs_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='deepgram'. */\n deepgram_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'deepgram_s2s', ...opts });\n }\n\n /** Shortcut for s2s with vendor='ultravox'. */\n ultravox_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'ultravox_s2s', ...opts });\n }\n\n /** Connect the caller to a Google Dialogflow agent (ES, CX, or CES). */\n dialogflow(opts: Omit<DialogflowVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dialogflow', ...opts });\n }\n\n /** Voice AI agent with integrated turn detection. */\n agent(opts: Omit<AgentVerb, 'verb'>): this {\n return this.addVerb({ verb: 'agent', ...opts });\n }\n\n /** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */\n listen(opts: Omit<ListenVerb, 'verb'>): this {\n return this.addVerb({ verb: 'listen', ...opts });\n }\n\n /** Stream real-time call audio to a WebSocket endpoint. Synonym for {@link listen}. */\n stream(opts: Omit<StreamVerb, 'verb'>): this {\n return this.addVerb({ verb: 'stream', ...opts });\n }\n\n /** Real-time call transcription sent to a webhook. */\n transcribe(opts: Omit<TranscribeVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transcribe', ...opts });\n }\n\n // --- Call Control ---\n\n /** Place an outbound call and bridge it to the current caller. */\n dial(opts: Omit<DialVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dial', ...opts });\n }\n\n /** Join or create a multi-party conference room. */\n conference(opts: Omit<ConferenceVerb, 'verb'>): this {\n return this.addVerb({ verb: 'conference', ...opts });\n }\n\n /** Place the caller into a named queue. */\n enqueue(opts: Omit<EnqueueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'enqueue', ...opts });\n }\n\n /** Remove a caller from a queue and bridge them. */\n dequeue(opts: Omit<DequeueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dequeue', ...opts });\n }\n\n /** End the call. */\n hangup(opts?: Omit<HangupVerb, 'verb'>): this {\n return this.addVerb({ verb: 'hangup', ...opts });\n }\n\n /** Transfer control to a different webhook URL. */\n redirect(opts: Omit<RedirectVerb, 'verb'>): this {\n return this.addVerb({ verb: 'redirect', ...opts });\n }\n\n /** Wait for a specified duration before continuing. */\n pause(opts: Omit<PauseVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pause', ...opts });\n }\n\n /** Leave a conference or queue. */\n leave(opts?: Omit<LeaveVerb, 'verb'>): this {\n return this.addVerb({ verb: 'leave', ...opts });\n }\n\n // --- SIP ---\n\n /** Reject an incoming call with a SIP error response. */\n sipDecline(opts: Omit<SipDeclineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:decline', ...opts });\n }\n\n /** Send a SIP INFO or other request within the dialog. */\n sipRequest(opts: Omit<SipRequestVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:request', ...opts });\n }\n\n /** Transfer the call via SIP REFER. */\n sipRefer(opts: Omit<SipReferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:refer', ...opts });\n }\n\n // --- Utility ---\n\n /** Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.). */\n config(opts: Omit<ConfigVerb, 'verb'>): this {\n return this.addVerb({ verb: 'config', ...opts });\n }\n\n /** Explicitly answer the call (sends a 200 OK). */\n answer(opts?: Omit<AnswerVerb, 'verb'>): this {\n return this.addVerb({ verb: 'answer', ...opts });\n }\n\n /** Send a SIP 180 Ringing with optional Alert-Info header. */\n alert(opts: Omit<AlertVerb, 'verb'>): this {\n return this.addVerb({ verb: 'alert', ...opts });\n }\n\n /** Attach metadata to the call for tracking or routing. */\n tag(opts: Omit<TagVerb, 'verb'>): this {\n return this.addVerb({ verb: 'tag', ...opts });\n }\n\n /** Send DTMF tones into the call. */\n dtmf(opts: Omit<DtmfVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dtmf', ...opts });\n }\n\n /** Mix an auxiliary audio track into the call. */\n dub(opts: Omit<DubVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dub', ...opts });\n }\n\n /** Send an SMS or MMS message. */\n message(opts: Omit<MessageVerb, 'verb'>): this {\n return this.addVerb({ verb: 'message', ...opts });\n }\n\n // --- Raw JSON input (primary AI agent path) ---\n\n /**\n * Add one or more verbs from raw JSON.\n * Validates against the JSON schemas at runtime if validation is enabled.\n */\n addVerbs(verbs: Verb[]): this {\n if (this.validator) {\n const result = this.validator.validate(verbs);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb validation failed: ${messages}`);\n }\n }\n this.verbs.push(...verbs);\n return this;\n }\n\n // --- Internal ---\n\n protected addVerb(verb: Verb): this {\n if (this.validator) {\n const result = this.validator.validateVerb(verb);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb '${verb.verb}' validation failed: ${messages}`);\n }\n }\n this.verbs.push(verb);\n return this;\n }\n\n /** Get the current verb count. */\n get length(): number {\n return this.verbs.length;\n }\n\n /** Clear all queued verbs. */\n clear(): this {\n this.verbs = [];\n return this;\n }\n\n /** Returns a copy of the current verb array. */\n toJSON(): Verb[] {\n return [...this.verbs];\n }\n}\n","/**\n * WebhookResponse — verb builder for HTTP webhook applications.\n * Extends VerbBuilder with toJSON() and signature verification.\n */\n\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { VerbBuilder, type VerbBuilderOptions } from '../verb-builder.js';\nimport type { JambonzApp } from '../types/verbs.js';\nimport type { IncomingMessage, ServerResponse } from 'http';\n\n/**\n * Verb builder for HTTP webhook applications.\n * Construct one per request, chain verb methods, and pass to `res.json()`.\n *\n * @example\n * ```typescript\n * app.post('/incoming', (req, res) => {\n * const jambonz = new WebhookResponse();\n * jambonz.say({ text: 'Hello!' }).hangup();\n * res.json(jambonz);\n * });\n * ```\n */\nexport class WebhookResponse extends VerbBuilder {\n /** @param opts - Options for validation and schema directory. */\n constructor(opts?: VerbBuilderOptions) {\n super(opts);\n }\n\n /** Returns the verb array for JSON serialization. */\n toJSON(): JambonzApp {\n return [...this.verbs];\n }\n\n /**\n * Express-compatible middleware for verifying jambonz webhook signatures.\n * Uses HMAC-SHA256 with timing-safe comparison.\n */\n static verifySignature(secret: string, opts?: { tolerance?: number }) {\n const tolerance = opts?.tolerance ?? 300; // 5 minutes default\n\n return (\n req: IncomingMessage & { body?: unknown; rawBody?: Buffer },\n _res: ServerResponse,\n next: (err?: Error) => void\n ) => {\n try {\n const signature = (req.headers as Record<string, string | undefined>)['jambonz-signature'];\n if (!signature) {\n throw new Error('Missing Jambonz-Signature header');\n }\n\n const parts = signature.split(',');\n let timestamp = '';\n const signatures: string[] = [];\n\n for (const part of parts) {\n const [key, value] = part.split('=');\n if (key === 't') timestamp = value;\n else if (key === 'v1') signatures.push(value);\n }\n\n if (!timestamp || signatures.length === 0) {\n throw new Error('Invalid Jambonz-Signature format');\n }\n\n // Check timestamp tolerance\n const ts = parseInt(timestamp, 10);\n const now = Math.floor(Date.now() / 1000);\n if (Math.abs(now - ts) > tolerance) {\n throw new Error('Webhook signature timestamp outside tolerance');\n }\n\n // Compute expected signature\n const payload = typeof req.body === 'string'\n ? req.body\n : JSON.stringify(req.body);\n const signedPayload = `${timestamp}.${payload}`;\n const expected = createHmac('sha256', secret)\n .update(signedPayload)\n .digest('hex');\n\n // Timing-safe comparison\n const matched = signatures.some((sig) => {\n try {\n return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));\n } catch {\n return false;\n }\n });\n\n if (!matched) {\n throw new Error('Webhook signature verification failed');\n }\n\n next();\n } catch (err) {\n next(err instanceof Error ? err : new Error(String(err)));\n }\n };\n }\n}\n","/**\n * Express middleware that auto-responds to HTTP OPTIONS requests with the\n * application environment variables schema for jambonz portal discovery.\n */\n\nimport type { EnvVarSchema } from '../types/common.js';\n\n/**\n * Express middleware that auto-responds to HTTP OPTIONS requests with the\n * application's environment variable schema, enabling jambonz portal discovery.\n *\n * @param schema - The environment variable schema to expose.\n *\n * @example\n * ```typescript\n * import { envVarsMiddleware } from '@jambonz/sdk/webhook';\n *\n * const envVars = {\n * API_KEY: { type: 'string', description: 'Your API key', required: true },\n * };\n * app.use(envVarsMiddleware(envVars));\n * ```\n */\nexport function envVarsMiddleware(schema: EnvVarSchema) {\n return (req: { method: string }, res: { json: (body: unknown) => void }, next: () => void) => {\n if (req.method === 'OPTIONS') {\n res.json(schema);\n return;\n }\n next();\n };\n}\n"]}
|
package/dist/webhook/index.d.cts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-
|
|
2
|
-
import { J as JambonzApp } from '../verbs-
|
|
1
|
+
import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-CFPD9yWI.cjs';
|
|
2
|
+
import { J as JambonzApp } from '../verbs-DKy6nGIH.cjs';
|
|
3
3
|
import { IncomingMessage, ServerResponse } from 'http';
|
|
4
4
|
import { a as EnvVarSchema } from '../common-BSJZX7WO.cjs';
|
|
5
5
|
|
package/dist/webhook/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-
|
|
2
|
-
import { J as JambonzApp } from '../verbs-
|
|
1
|
+
import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-D5XRbTtu.js';
|
|
2
|
+
import { J as JambonzApp } from '../verbs-DKy6nGIH.js';
|
|
3
3
|
import { IncomingMessage, ServerResponse } from 'http';
|
|
4
4
|
import { a as EnvVarSchema } from '../common-BSJZX7WO.js';
|
|
5
5
|
|
package/dist/webhook/index.js
CHANGED
|
@@ -149,9 +149,9 @@ var VerbBuilder = class {
|
|
|
149
149
|
dialogflow(opts) {
|
|
150
150
|
return this.addVerb({ verb: "dialogflow", ...opts });
|
|
151
151
|
}
|
|
152
|
-
/** Voice AI
|
|
153
|
-
|
|
154
|
-
return this.addVerb({ verb: "
|
|
152
|
+
/** Voice AI agent with integrated turn detection. */
|
|
153
|
+
agent(opts) {
|
|
154
|
+
return this.addVerb({ verb: "agent", ...opts });
|
|
155
155
|
}
|
|
156
156
|
/** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */
|
|
157
157
|
listen(opts) {
|