@jambonz/sdk 0.1.3 → 0.1.6
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.d.cts +2 -2
- package/dist/client/index.d.ts +2 -2
- package/dist/index.cjs +78 -7
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +78 -7
- package/dist/index.js.map +1 -1
- package/dist/{rest-BF9HKZrA.d.ts → rest-Ct1hlTMi.d.ts} +1 -1
- package/dist/{rest-v8weIueZ.d.cts → rest-CtGvvaaV.d.cts} +1 -1
- package/dist/types/index.d.cts +2 -2
- package/dist/types/index.d.ts +2 -2
- package/dist/{verb-builder-DkHAJrk4.d.cts → verb-builder-BJalSF8p.d.cts} +15 -1
- package/dist/{verb-builder-Dg_IPC4I.d.ts → verb-builder-CclNap8d.d.ts} +15 -1
- package/dist/{verbs-fjJjfGEt.d.cts → verbs-boTMgOLb.d.cts} +83 -9
- package/dist/{verbs-fjJjfGEt.d.ts → verbs-boTMgOLb.d.ts} +83 -9
- package/dist/webhook/index.cjs +36 -0
- 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 +36 -0
- package/dist/webhook/index.js.map +1 -1
- package/dist/websocket/index.cjs +78 -7
- package/dist/websocket/index.cjs.map +1 -1
- package/dist/websocket/index.d.cts +17 -3
- package/dist/websocket/index.d.ts +17 -3
- package/dist/websocket/index.js +78 -7
- package/dist/websocket/index.js.map +1 -1
- package/package.json +2 -2
- package/schema/components/llm-base.schema.json +94 -0
- package/schema/jambonz-app.schema.json +8 -2
- package/schema/verbs/deepgram_s2s.schema.json +22 -0
- package/schema/verbs/dialogflow.schema.json +120 -0
- package/schema/verbs/elevenlabs_s2s.schema.json +22 -0
- package/schema/verbs/google_s2s.schema.json +23 -0
- package/schema/verbs/llm.schema.json +1 -101
- package/schema/verbs/openai_s2s.schema.json +23 -0
- package/schema/verbs/pipeline.schema.json +2 -1
- package/schema/verbs/s2s.schema.json +26 -0
- package/schema/verbs/stream.schema.json +2 -1
- package/schema/verbs/ultravox_s2s.schema.json +22 -0
|
@@ -333,11 +333,16 @@ interface GatherVerb {
|
|
|
333
333
|
/** Handle slow actionHook responses. */
|
|
334
334
|
actionHookDelayAction?: ActionHookDelayAction;
|
|
335
335
|
}
|
|
336
|
-
interface
|
|
337
|
-
|
|
336
|
+
interface McpServerConfig {
|
|
337
|
+
url: string;
|
|
338
|
+
auth?: Record<string, unknown>;
|
|
339
|
+
roots?: Record<string, unknown>[];
|
|
340
|
+
}
|
|
341
|
+
/** Shared properties for llm, s2s, and vendor-specific s2s verbs. */
|
|
342
|
+
interface LlmBaseOptions {
|
|
338
343
|
id?: string;
|
|
339
344
|
/** LLM vendor. */
|
|
340
|
-
vendor
|
|
345
|
+
vendor?: string;
|
|
341
346
|
/** Model name. */
|
|
342
347
|
model?: string;
|
|
343
348
|
/** LLM vendor authentication. */
|
|
@@ -360,10 +365,75 @@ interface LlmVerb {
|
|
|
360
365
|
/** Event types to receive via eventHook. */
|
|
361
366
|
events?: string[];
|
|
362
367
|
}
|
|
363
|
-
interface
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
368
|
+
interface LlmVerb extends LlmBaseOptions {
|
|
369
|
+
verb: 'llm';
|
|
370
|
+
vendor: string;
|
|
371
|
+
}
|
|
372
|
+
interface S2sVerb extends LlmBaseOptions {
|
|
373
|
+
verb: 's2s';
|
|
374
|
+
vendor: string;
|
|
375
|
+
}
|
|
376
|
+
interface OpenaiS2sVerb extends LlmBaseOptions {
|
|
377
|
+
verb: 'openai_s2s';
|
|
378
|
+
}
|
|
379
|
+
interface GoogleS2sVerb extends LlmBaseOptions {
|
|
380
|
+
verb: 'google_s2s';
|
|
381
|
+
}
|
|
382
|
+
interface ElevenlabsS2sVerb extends LlmBaseOptions {
|
|
383
|
+
verb: 'elevenlabs_s2s';
|
|
384
|
+
}
|
|
385
|
+
interface DeepgramS2sVerb extends LlmBaseOptions {
|
|
386
|
+
verb: 'deepgram_s2s';
|
|
387
|
+
}
|
|
388
|
+
interface UltravoxS2sVerb extends LlmBaseOptions {
|
|
389
|
+
verb: 'ultravox_s2s';
|
|
390
|
+
}
|
|
391
|
+
interface DialogflowVerb {
|
|
392
|
+
verb: 'dialogflow';
|
|
393
|
+
id?: string;
|
|
394
|
+
/** Google service account credentials as JSON object or stringified JSON. */
|
|
395
|
+
credentials: Record<string, unknown> | string;
|
|
396
|
+
/** Google Cloud project ID. */
|
|
397
|
+
project: string;
|
|
398
|
+
/** Dialogflow agent ID. Required for CX agents. */
|
|
399
|
+
agent?: string;
|
|
400
|
+
/** Dialogflow environment. */
|
|
401
|
+
environment?: string;
|
|
402
|
+
/** Google Cloud region for the API endpoint. */
|
|
403
|
+
region?: string;
|
|
404
|
+
/** Dialogflow model type. */
|
|
405
|
+
model?: 'es' | 'cx' | 'ces';
|
|
406
|
+
/** Language code (e.g. 'en-US'). */
|
|
407
|
+
lang: string;
|
|
408
|
+
/** Webhook when session ends. */
|
|
409
|
+
actionHook?: ActionHook;
|
|
410
|
+
/** Webhook for Dialogflow events. */
|
|
411
|
+
eventHook?: ActionHook;
|
|
412
|
+
/** Event types to receive via eventHook. */
|
|
413
|
+
events?: string[];
|
|
414
|
+
/** Event to trigger at conversation start. */
|
|
415
|
+
welcomeEvent?: string;
|
|
416
|
+
/** Parameters for the welcome event. */
|
|
417
|
+
welcomeEventParams?: Record<string, unknown>;
|
|
418
|
+
/** Seconds to wait for input before no-input event. */
|
|
419
|
+
noInputTimeout?: number;
|
|
420
|
+
/** Event to trigger on no input. */
|
|
421
|
+
noInputEvent?: string;
|
|
422
|
+
/** Pass DTMF digits as text input. */
|
|
423
|
+
passDtmfAsTextInput?: boolean;
|
|
424
|
+
/** Audio URL to play while waiting for Dialogflow. */
|
|
425
|
+
thinkingMusic?: string;
|
|
426
|
+
/** TTS configuration for responses. */
|
|
427
|
+
tts?: Synthesizer;
|
|
428
|
+
/** Allow caller to interrupt responses. */
|
|
429
|
+
bargein?: boolean;
|
|
430
|
+
/** Initial query input. */
|
|
431
|
+
queryInput?: {
|
|
432
|
+
text?: string;
|
|
433
|
+
intent?: string;
|
|
434
|
+
event?: string;
|
|
435
|
+
dtmf?: string;
|
|
436
|
+
};
|
|
367
437
|
}
|
|
368
438
|
interface PipelineVerb {
|
|
369
439
|
verb: 'pipeline';
|
|
@@ -388,6 +458,8 @@ interface PipelineVerb {
|
|
|
388
458
|
actionHook?: ActionHook;
|
|
389
459
|
/** Webhook for pipeline events. */
|
|
390
460
|
eventHook?: ActionHook;
|
|
461
|
+
/** Webhook when the LLM requests a tool/function call. */
|
|
462
|
+
toolHook?: ActionHook;
|
|
391
463
|
}
|
|
392
464
|
interface ListenVerb {
|
|
393
465
|
verb: 'listen';
|
|
@@ -458,6 +530,8 @@ interface StreamVerb {
|
|
|
458
530
|
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
459
531
|
/** Stream before call is answered. */
|
|
460
532
|
earlyMedia?: boolean;
|
|
533
|
+
/** Specific audio channel to stream. */
|
|
534
|
+
channel?: number;
|
|
461
535
|
}
|
|
462
536
|
interface TranscribeVerb {
|
|
463
537
|
verb: 'transcribe';
|
|
@@ -787,10 +861,10 @@ interface MessageVerb {
|
|
|
787
861
|
actionHook?: ActionHook;
|
|
788
862
|
}
|
|
789
863
|
/** Any jambonz verb. Discriminated on the 'verb' property. */
|
|
790
|
-
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | PipelineVerb | ConferenceVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb;
|
|
864
|
+
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | DialogflowVerb | PipelineVerb | ConferenceVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb;
|
|
791
865
|
/** A jambonz application — an array of verbs executed sequentially. */
|
|
792
866
|
type JambonzApp = Verb[];
|
|
793
867
|
/** All valid verb names. */
|
|
794
868
|
type VerbName = Verb['verb'];
|
|
795
869
|
|
|
796
|
-
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, JambonzApp as J, LeaveVerb as L, McpServerConfig as M, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AlertVerb as c, Amd as d, AmdTimers as e, AnswerVerb as f, Auth as g, ConfigVerb as h, DialVerb as i, DtmfVerb as j, DubVerb as k, ListenVerb as l, LlmVerb as m, MessageVerb as n, PipelineVerb 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 };
|
|
870
|
+
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, AlertVerb as c, Amd as d, AmdTimers as e, AnswerVerb as f, Auth as g, ConfigVerb as h, DialVerb as i, DtmfVerb as j, DubVerb as k, ListenVerb as l, LlmVerb as m, MessageVerb as n, PipelineVerb 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 };
|
|
@@ -333,11 +333,16 @@ interface GatherVerb {
|
|
|
333
333
|
/** Handle slow actionHook responses. */
|
|
334
334
|
actionHookDelayAction?: ActionHookDelayAction;
|
|
335
335
|
}
|
|
336
|
-
interface
|
|
337
|
-
|
|
336
|
+
interface McpServerConfig {
|
|
337
|
+
url: string;
|
|
338
|
+
auth?: Record<string, unknown>;
|
|
339
|
+
roots?: Record<string, unknown>[];
|
|
340
|
+
}
|
|
341
|
+
/** Shared properties for llm, s2s, and vendor-specific s2s verbs. */
|
|
342
|
+
interface LlmBaseOptions {
|
|
338
343
|
id?: string;
|
|
339
344
|
/** LLM vendor. */
|
|
340
|
-
vendor
|
|
345
|
+
vendor?: string;
|
|
341
346
|
/** Model name. */
|
|
342
347
|
model?: string;
|
|
343
348
|
/** LLM vendor authentication. */
|
|
@@ -360,10 +365,75 @@ interface LlmVerb {
|
|
|
360
365
|
/** Event types to receive via eventHook. */
|
|
361
366
|
events?: string[];
|
|
362
367
|
}
|
|
363
|
-
interface
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
368
|
+
interface LlmVerb extends LlmBaseOptions {
|
|
369
|
+
verb: 'llm';
|
|
370
|
+
vendor: string;
|
|
371
|
+
}
|
|
372
|
+
interface S2sVerb extends LlmBaseOptions {
|
|
373
|
+
verb: 's2s';
|
|
374
|
+
vendor: string;
|
|
375
|
+
}
|
|
376
|
+
interface OpenaiS2sVerb extends LlmBaseOptions {
|
|
377
|
+
verb: 'openai_s2s';
|
|
378
|
+
}
|
|
379
|
+
interface GoogleS2sVerb extends LlmBaseOptions {
|
|
380
|
+
verb: 'google_s2s';
|
|
381
|
+
}
|
|
382
|
+
interface ElevenlabsS2sVerb extends LlmBaseOptions {
|
|
383
|
+
verb: 'elevenlabs_s2s';
|
|
384
|
+
}
|
|
385
|
+
interface DeepgramS2sVerb extends LlmBaseOptions {
|
|
386
|
+
verb: 'deepgram_s2s';
|
|
387
|
+
}
|
|
388
|
+
interface UltravoxS2sVerb extends LlmBaseOptions {
|
|
389
|
+
verb: 'ultravox_s2s';
|
|
390
|
+
}
|
|
391
|
+
interface DialogflowVerb {
|
|
392
|
+
verb: 'dialogflow';
|
|
393
|
+
id?: string;
|
|
394
|
+
/** Google service account credentials as JSON object or stringified JSON. */
|
|
395
|
+
credentials: Record<string, unknown> | string;
|
|
396
|
+
/** Google Cloud project ID. */
|
|
397
|
+
project: string;
|
|
398
|
+
/** Dialogflow agent ID. Required for CX agents. */
|
|
399
|
+
agent?: string;
|
|
400
|
+
/** Dialogflow environment. */
|
|
401
|
+
environment?: string;
|
|
402
|
+
/** Google Cloud region for the API endpoint. */
|
|
403
|
+
region?: string;
|
|
404
|
+
/** Dialogflow model type. */
|
|
405
|
+
model?: 'es' | 'cx' | 'ces';
|
|
406
|
+
/** Language code (e.g. 'en-US'). */
|
|
407
|
+
lang: string;
|
|
408
|
+
/** Webhook when session ends. */
|
|
409
|
+
actionHook?: ActionHook;
|
|
410
|
+
/** Webhook for Dialogflow events. */
|
|
411
|
+
eventHook?: ActionHook;
|
|
412
|
+
/** Event types to receive via eventHook. */
|
|
413
|
+
events?: string[];
|
|
414
|
+
/** Event to trigger at conversation start. */
|
|
415
|
+
welcomeEvent?: string;
|
|
416
|
+
/** Parameters for the welcome event. */
|
|
417
|
+
welcomeEventParams?: Record<string, unknown>;
|
|
418
|
+
/** Seconds to wait for input before no-input event. */
|
|
419
|
+
noInputTimeout?: number;
|
|
420
|
+
/** Event to trigger on no input. */
|
|
421
|
+
noInputEvent?: string;
|
|
422
|
+
/** Pass DTMF digits as text input. */
|
|
423
|
+
passDtmfAsTextInput?: boolean;
|
|
424
|
+
/** Audio URL to play while waiting for Dialogflow. */
|
|
425
|
+
thinkingMusic?: string;
|
|
426
|
+
/** TTS configuration for responses. */
|
|
427
|
+
tts?: Synthesizer;
|
|
428
|
+
/** Allow caller to interrupt responses. */
|
|
429
|
+
bargein?: boolean;
|
|
430
|
+
/** Initial query input. */
|
|
431
|
+
queryInput?: {
|
|
432
|
+
text?: string;
|
|
433
|
+
intent?: string;
|
|
434
|
+
event?: string;
|
|
435
|
+
dtmf?: string;
|
|
436
|
+
};
|
|
367
437
|
}
|
|
368
438
|
interface PipelineVerb {
|
|
369
439
|
verb: 'pipeline';
|
|
@@ -388,6 +458,8 @@ interface PipelineVerb {
|
|
|
388
458
|
actionHook?: ActionHook;
|
|
389
459
|
/** Webhook for pipeline events. */
|
|
390
460
|
eventHook?: ActionHook;
|
|
461
|
+
/** Webhook when the LLM requests a tool/function call. */
|
|
462
|
+
toolHook?: ActionHook;
|
|
391
463
|
}
|
|
392
464
|
interface ListenVerb {
|
|
393
465
|
verb: 'listen';
|
|
@@ -458,6 +530,8 @@ interface StreamVerb {
|
|
|
458
530
|
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
459
531
|
/** Stream before call is answered. */
|
|
460
532
|
earlyMedia?: boolean;
|
|
533
|
+
/** Specific audio channel to stream. */
|
|
534
|
+
channel?: number;
|
|
461
535
|
}
|
|
462
536
|
interface TranscribeVerb {
|
|
463
537
|
verb: 'transcribe';
|
|
@@ -787,10 +861,10 @@ interface MessageVerb {
|
|
|
787
861
|
actionHook?: ActionHook;
|
|
788
862
|
}
|
|
789
863
|
/** Any jambonz verb. Discriminated on the 'verb' property. */
|
|
790
|
-
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | PipelineVerb | ConferenceVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb;
|
|
864
|
+
type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | DialogflowVerb | PipelineVerb | ConferenceVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb;
|
|
791
865
|
/** A jambonz application — an array of verbs executed sequentially. */
|
|
792
866
|
type JambonzApp = Verb[];
|
|
793
867
|
/** All valid verb names. */
|
|
794
868
|
type VerbName = Verb['verb'];
|
|
795
869
|
|
|
796
|
-
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, JambonzApp as J, LeaveVerb as L, McpServerConfig as M, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AlertVerb as c, Amd as d, AmdTimers as e, AnswerVerb as f, Auth as g, ConfigVerb as h, DialVerb as i, DtmfVerb as j, DubVerb as k, ListenVerb as l, LlmVerb as m, MessageVerb as n, PipelineVerb 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 };
|
|
870
|
+
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, AlertVerb as c, Amd as d, AmdTimers as e, AnswerVerb as f, Auth as g, ConfigVerb as h, DialVerb as i, DtmfVerb as j, DubVerb as k, ListenVerb as l, LlmVerb as m, MessageVerb as n, PipelineVerb 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
|
@@ -37,6 +37,7 @@ var COMPONENT_SCHEMAS = [
|
|
|
37
37
|
"recognizer-sonioxOptions",
|
|
38
38
|
"recognizer-speechmaticsOptions",
|
|
39
39
|
"recognizer-verbioOptions",
|
|
40
|
+
"llm-base",
|
|
40
41
|
"synthesizer",
|
|
41
42
|
"target",
|
|
42
43
|
"vad"
|
|
@@ -52,6 +53,13 @@ var VERB_SCHEMAS = [
|
|
|
52
53
|
"listen",
|
|
53
54
|
"stream",
|
|
54
55
|
"llm",
|
|
56
|
+
"s2s",
|
|
57
|
+
"openai_s2s",
|
|
58
|
+
"google_s2s",
|
|
59
|
+
"elevenlabs_s2s",
|
|
60
|
+
"deepgram_s2s",
|
|
61
|
+
"ultravox_s2s",
|
|
62
|
+
"dialogflow",
|
|
55
63
|
"pipeline",
|
|
56
64
|
"conference",
|
|
57
65
|
"transcribe",
|
|
@@ -170,6 +178,34 @@ var VerbBuilder = class {
|
|
|
170
178
|
llm(opts) {
|
|
171
179
|
return this.addVerb({ verb: "llm", ...opts });
|
|
172
180
|
}
|
|
181
|
+
/** Synonym for {@link llm}. Requires vendor to be specified. */
|
|
182
|
+
s2s(opts) {
|
|
183
|
+
return this.addVerb({ verb: "s2s", ...opts });
|
|
184
|
+
}
|
|
185
|
+
/** Shortcut for s2s with vendor='openai'. */
|
|
186
|
+
openai_s2s(opts) {
|
|
187
|
+
return this.addVerb({ verb: "openai_s2s", ...opts });
|
|
188
|
+
}
|
|
189
|
+
/** Shortcut for s2s with vendor='google'. */
|
|
190
|
+
google_s2s(opts) {
|
|
191
|
+
return this.addVerb({ verb: "google_s2s", ...opts });
|
|
192
|
+
}
|
|
193
|
+
/** Shortcut for s2s with vendor='elevenlabs'. */
|
|
194
|
+
elevenlabs_s2s(opts) {
|
|
195
|
+
return this.addVerb({ verb: "elevenlabs_s2s", ...opts });
|
|
196
|
+
}
|
|
197
|
+
/** Shortcut for s2s with vendor='deepgram'. */
|
|
198
|
+
deepgram_s2s(opts) {
|
|
199
|
+
return this.addVerb({ verb: "deepgram_s2s", ...opts });
|
|
200
|
+
}
|
|
201
|
+
/** Shortcut for s2s with vendor='ultravox'. */
|
|
202
|
+
ultravox_s2s(opts) {
|
|
203
|
+
return this.addVerb({ verb: "ultravox_s2s", ...opts });
|
|
204
|
+
}
|
|
205
|
+
/** Connect the caller to a Google Dialogflow agent (ES, CX, or CES). */
|
|
206
|
+
dialogflow(opts) {
|
|
207
|
+
return this.addVerb({ verb: "dialogflow", ...opts });
|
|
208
|
+
}
|
|
173
209
|
/** Voice AI pipeline with integrated turn detection. */
|
|
174
210
|
pipeline(opts) {
|
|
175
211
|
return this.addVerb({ verb: "pipeline", ...opts });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/validator.ts","../../src/verb-builder.ts","../../src/webhook/response.ts","../../src/webhook/env-vars.ts"],"names":["resolve","readFileSync","dirname","fileURLToPath","Ajv","createHmac","timingSafeEqual"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all JSON schemas from schema/ and validates verb arrays and individual verbs.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync } from 'fs';\nimport { resolve, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n// Schema $id to file path mapping\nconst COMPONENT_SCHEMAS = [\n 'auth',\n 'actionHook',\n 'actionHookDelayAction',\n 'amd',\n 'bidirectionalAudio',\n 'fillerNoise',\n 'recognizer',\n 'recognizer-assemblyAiOptions',\n 'recognizer-awsOptions',\n 'recognizer-azureOptions',\n 'recognizer-cobaltOptions',\n 'recognizer-customOptions',\n 'recognizer-deepgramOptions',\n 'recognizer-elevenlabsOptions',\n 'recognizer-gladiaOptions',\n 'recognizer-googleOptions',\n 'recognizer-houndifyOptions',\n 'recognizer-ibmOptions',\n 'recognizer-nuanceOptions',\n 'recognizer-nvidiaOptions',\n 'recognizer-openaiOptions',\n 'recognizer-sonioxOptions',\n 'recognizer-speechmaticsOptions',\n 'recognizer-verbioOptions',\n 'synthesizer',\n 'target',\n 'vad',\n] as const;\n\nconst VERB_SCHEMAS = [\n 'answer',\n 'alert',\n 'config',\n 'say',\n 'play',\n 'gather',\n 'dial',\n 'listen',\n 'stream',\n 'llm',\n 'pipeline',\n 'conference',\n 'transcribe',\n 'enqueue',\n 'dequeue',\n 'dtmf',\n 'dub',\n 'hangup',\n 'leave',\n 'message',\n 'pause',\n 'redirect',\n 'tag',\n 'sip-decline',\n 'sip-request',\n 'sip-refer',\n] as const;\n\nfunction loadSchema(schemaDir: string, relativePath: string): Record<string, unknown> {\n const fullPath = resolve(schemaDir, relativePath);\n return JSON.parse(readFileSync(fullPath, 'utf-8')) as Record<string, unknown>;\n}\n\nfunction findSchemaDir(): string {\n // Walk up from this file to find the schema/ directory\n // In development: typescript/src/validator.ts -> ../../schema\n // In dist: dist/index.js -> ../schema (tsup bundles to package-root/dist/)\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n // Try relative paths from both src and dist locations\n const candidates = [\n resolve(currentDir, '../../schema'), // from typescript/src/\n resolve(currentDir, '../schema'), // from dist/ (tsup bundles to package-root/dist/)\n ];\n\n for (const candidate of candidates) {\n try {\n readFileSync(resolve(candidate, 'jambonz-app.schema.json'), 'utf-8');\n return candidate;\n } catch {\n // try next\n }\n }\n\n throw new Error(\n 'Could not find jambonz schema directory. Ensure the schema/ directory is present alongside the typescript/ directory.'\n );\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 for (const name of COMPONENT_SCHEMAS) {\n const schema = loadSchema(dir, `components/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n for (const name of VERB_SCHEMAS) {\n const schema = loadSchema(dir, `verbs/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(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 DialVerb,\n DtmfVerb,\n DubVerb,\n EnqueueVerb,\n GatherVerb,\n HangupVerb,\n LeaveVerb,\n ListenVerb,\n LlmVerb,\n MessageVerb,\n PauseVerb,\n PipelineVerb,\n PlayVerb,\n RedirectVerb,\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 /** 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":["resolve","readFileSync","dirname","fileURLToPath","Ajv","createHmac","timingSafeEqual"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all JSON schemas from schema/ and validates verb arrays and individual verbs.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync } from 'fs';\nimport { resolve, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n// Schema $id to file path mapping\nconst COMPONENT_SCHEMAS = [\n 'auth',\n 'actionHook',\n 'actionHookDelayAction',\n 'amd',\n 'bidirectionalAudio',\n 'fillerNoise',\n 'recognizer',\n 'recognizer-assemblyAiOptions',\n 'recognizer-awsOptions',\n 'recognizer-azureOptions',\n 'recognizer-cobaltOptions',\n 'recognizer-customOptions',\n 'recognizer-deepgramOptions',\n 'recognizer-elevenlabsOptions',\n 'recognizer-gladiaOptions',\n 'recognizer-googleOptions',\n 'recognizer-houndifyOptions',\n 'recognizer-ibmOptions',\n 'recognizer-nuanceOptions',\n 'recognizer-nvidiaOptions',\n 'recognizer-openaiOptions',\n 'recognizer-sonioxOptions',\n 'recognizer-speechmaticsOptions',\n 'recognizer-verbioOptions',\n 'llm-base',\n 'synthesizer',\n 'target',\n 'vad',\n] as const;\n\nconst VERB_SCHEMAS = [\n 'answer',\n 'alert',\n 'config',\n 'say',\n 'play',\n 'gather',\n 'dial',\n 'listen',\n 'stream',\n 'llm',\n 's2s',\n 'openai_s2s',\n 'google_s2s',\n 'elevenlabs_s2s',\n 'deepgram_s2s',\n 'ultravox_s2s',\n 'dialogflow',\n 'pipeline',\n 'conference',\n 'transcribe',\n 'enqueue',\n 'dequeue',\n 'dtmf',\n 'dub',\n 'hangup',\n 'leave',\n 'message',\n 'pause',\n 'redirect',\n 'tag',\n 'sip-decline',\n 'sip-request',\n 'sip-refer',\n] as const;\n\nfunction loadSchema(schemaDir: string, relativePath: string): Record<string, unknown> {\n const fullPath = resolve(schemaDir, relativePath);\n return JSON.parse(readFileSync(fullPath, 'utf-8')) as Record<string, unknown>;\n}\n\nfunction findSchemaDir(): string {\n // Walk up from this file to find the schema/ directory\n // In development: typescript/src/validator.ts -> ../../schema\n // In dist: dist/index.js -> ../schema (tsup bundles to package-root/dist/)\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n // Try relative paths from both src and dist locations\n const candidates = [\n resolve(currentDir, '../../schema'), // from typescript/src/\n resolve(currentDir, '../schema'), // from dist/ (tsup bundles to package-root/dist/)\n ];\n\n for (const candidate of candidates) {\n try {\n readFileSync(resolve(candidate, 'jambonz-app.schema.json'), 'utf-8');\n return candidate;\n } catch {\n // try next\n }\n }\n\n throw new Error(\n 'Could not find jambonz schema directory. Ensure the schema/ directory is present alongside the typescript/ directory.'\n );\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 for (const name of COMPONENT_SCHEMAS) {\n const schema = loadSchema(dir, `components/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n for (const name of VERB_SCHEMAS) {\n const schema = loadSchema(dir, `verbs/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(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"]}
|
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-BJalSF8p.cjs';
|
|
2
|
+
import { J as JambonzApp } from '../verbs-boTMgOLb.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-CclNap8d.js';
|
|
2
|
+
import { J as JambonzApp } from '../verbs-boTMgOLb.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
|
@@ -30,6 +30,7 @@ var COMPONENT_SCHEMAS = [
|
|
|
30
30
|
"recognizer-sonioxOptions",
|
|
31
31
|
"recognizer-speechmaticsOptions",
|
|
32
32
|
"recognizer-verbioOptions",
|
|
33
|
+
"llm-base",
|
|
33
34
|
"synthesizer",
|
|
34
35
|
"target",
|
|
35
36
|
"vad"
|
|
@@ -45,6 +46,13 @@ var VERB_SCHEMAS = [
|
|
|
45
46
|
"listen",
|
|
46
47
|
"stream",
|
|
47
48
|
"llm",
|
|
49
|
+
"s2s",
|
|
50
|
+
"openai_s2s",
|
|
51
|
+
"google_s2s",
|
|
52
|
+
"elevenlabs_s2s",
|
|
53
|
+
"deepgram_s2s",
|
|
54
|
+
"ultravox_s2s",
|
|
55
|
+
"dialogflow",
|
|
48
56
|
"pipeline",
|
|
49
57
|
"conference",
|
|
50
58
|
"transcribe",
|
|
@@ -163,6 +171,34 @@ var VerbBuilder = class {
|
|
|
163
171
|
llm(opts) {
|
|
164
172
|
return this.addVerb({ verb: "llm", ...opts });
|
|
165
173
|
}
|
|
174
|
+
/** Synonym for {@link llm}. Requires vendor to be specified. */
|
|
175
|
+
s2s(opts) {
|
|
176
|
+
return this.addVerb({ verb: "s2s", ...opts });
|
|
177
|
+
}
|
|
178
|
+
/** Shortcut for s2s with vendor='openai'. */
|
|
179
|
+
openai_s2s(opts) {
|
|
180
|
+
return this.addVerb({ verb: "openai_s2s", ...opts });
|
|
181
|
+
}
|
|
182
|
+
/** Shortcut for s2s with vendor='google'. */
|
|
183
|
+
google_s2s(opts) {
|
|
184
|
+
return this.addVerb({ verb: "google_s2s", ...opts });
|
|
185
|
+
}
|
|
186
|
+
/** Shortcut for s2s with vendor='elevenlabs'. */
|
|
187
|
+
elevenlabs_s2s(opts) {
|
|
188
|
+
return this.addVerb({ verb: "elevenlabs_s2s", ...opts });
|
|
189
|
+
}
|
|
190
|
+
/** Shortcut for s2s with vendor='deepgram'. */
|
|
191
|
+
deepgram_s2s(opts) {
|
|
192
|
+
return this.addVerb({ verb: "deepgram_s2s", ...opts });
|
|
193
|
+
}
|
|
194
|
+
/** Shortcut for s2s with vendor='ultravox'. */
|
|
195
|
+
ultravox_s2s(opts) {
|
|
196
|
+
return this.addVerb({ verb: "ultravox_s2s", ...opts });
|
|
197
|
+
}
|
|
198
|
+
/** Connect the caller to a Google Dialogflow agent (ES, CX, or CES). */
|
|
199
|
+
dialogflow(opts) {
|
|
200
|
+
return this.addVerb({ verb: "dialogflow", ...opts });
|
|
201
|
+
}
|
|
166
202
|
/** Voice AI pipeline with integrated turn detection. */
|
|
167
203
|
pipeline(opts) {
|
|
168
204
|
return this.addVerb({ verb: "pipeline", ...opts });
|