@jambonz/sdk 0.12.0 → 0.13.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.
Files changed (40) hide show
  1. package/dist/client/index.d.cts +2 -2
  2. package/dist/client/index.d.ts +2 -2
  3. package/dist/harness/index.cjs +843 -0
  4. package/dist/harness/index.cjs.map +1 -0
  5. package/dist/harness/index.d.cts +503 -0
  6. package/dist/harness/index.d.ts +503 -0
  7. package/dist/harness/index.js +832 -0
  8. package/dist/harness/index.js.map +1 -0
  9. package/dist/index.cjs +14 -0
  10. package/dist/index.cjs.map +1 -1
  11. package/dist/index.d.cts +3 -3
  12. package/dist/index.d.ts +3 -3
  13. package/dist/index.js +14 -0
  14. package/dist/index.js.map +1 -1
  15. package/dist/{rest-0m9Hgjmn.d.cts → rest-B-7QX4TM.d.cts} +1 -1
  16. package/dist/{rest-CqS2POQv.d.ts → rest-r1vLsPCg.d.ts} +1 -1
  17. package/dist/types/index.d.cts +2 -2
  18. package/dist/types/index.d.ts +2 -2
  19. package/dist/{verb-builder-C1id83_f.d.cts → verb-builder-UVx6Exh1.d.ts} +3 -1
  20. package/dist/{verb-builder-YFevoXCs.d.ts → verb-builder-tc7P_MTy.d.cts} +3 -1
  21. package/dist/{verbs-DQ6zJ0bn.d.cts → verbs-D461pHTq.d.cts} +52 -6
  22. package/dist/{verbs-DQ6zJ0bn.d.ts → verbs-D461pHTq.d.ts} +52 -6
  23. package/dist/webhook/index.cjs +6 -0
  24. package/dist/webhook/index.cjs.map +1 -1
  25. package/dist/webhook/index.d.cts +2 -2
  26. package/dist/webhook/index.d.ts +2 -2
  27. package/dist/webhook/index.js +6 -0
  28. package/dist/webhook/index.js.map +1 -1
  29. package/dist/websocket/index.cjs +14 -0
  30. package/dist/websocket/index.cjs.map +1 -1
  31. package/dist/websocket/index.d.cts +5 -3
  32. package/dist/websocket/index.d.ts +5 -3
  33. package/dist/websocket/index.js +14 -0
  34. package/dist/websocket/index.js.map +1 -1
  35. package/examples/harness/README.md +73 -0
  36. package/examples/harness/harness.ts +99 -0
  37. package/examples/harness/package.json +21 -0
  38. package/examples/harness/tsconfig.json +12 -0
  39. package/examples/openai-realtime/ws-app.ts +18 -14
  40. package/package.json +13 -2
@@ -1,4 +1,4 @@
1
- import { A as ActionHook, _ as Verb, S as SayVerb, Y as TransferVerb } from './verbs-DQ6zJ0bn.js';
1
+ import { A as ActionHook, _ as Verb, S as SayVerb, Y as TransferVerb } from './verbs-D461pHTq.js';
2
2
 
3
3
  /**
4
4
  * Types for the jambonz REST API client.
@@ -1,6 +1,6 @@
1
- export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as AgentLlm, d as AgentLlmOptions, e as AgentVerb, f as AlertVerb, g as Amd, h as AmdTimers, i as AnswerVerb, j as Auth, B as BidirectionalAudio, C as ConferenceVerb, k as ConfigVerb, D as DequeueVerb, l as DialVerb, m as DtmfVerb, n as DubVerb, E as EnqueueVerb, F as FillerNoise, G as GatherVerb, H as Handoff, o as HangupVerb, J as JambonzApp, L as LeaveVerb, p as ListenVerb, q as LlmMessage, r as LlmTool, s as LlmToolOpenAIWrapped, t as LlmToolOutputData, u as LlmVendor, v as LlmVerb, M as McpServerConfig, w as MessageVerb, P as PauseVerb, x as PlayVerb, R as Recognizer, y as RedirectVerb, S as SayVerb, z as SipDeclineVerb, I as SipReferVerb, K as SipRequestVerb, N as StreamVerb, O as Synthesizer, T as TagVerb, Q as Target, U as TranscribeVerb, V as TransferConfirm, W as TransferDisposition, X as TransferOptions, Y as TransferVerb, Z as Vad, _ as Verb, $ as VerbName } from '../verbs-DQ6zJ0bn.cjs';
1
+ export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as AgentLlm, d as AgentLlmOptions, e as AgentVerb, f as AlertVerb, g as Amd, h as AmdTimers, i as AnswerVerb, j as Auth, B as BidirectionalAudio, C as ConferenceVerb, k as ConfigVerb, D as DequeueVerb, l as DialVerb, m as DtmfVerb, n as DubVerb, E as EnqueueVerb, F as FillerNoise, G as GatherVerb, H as Handoff, o as HangupVerb, J as JambonzApp, L as LeaveVerb, p as ListenVerb, q as LlmMessage, r as LlmTool, s as LlmToolOpenAIWrapped, t as LlmToolOutputData, u as LlmVendor, v as LlmVerb, M as McpServerConfig, w as MessageVerb, P as PauseVerb, x as PlayVerb, R as Recognizer, y as RedirectVerb, S as SayVerb, z as SipDeclineVerb, I as SipReferVerb, K as SipRequestVerb, N as StreamVerb, O as Synthesizer, T as TagVerb, Q as Target, U as TranscribeVerb, V as TransferConfirm, W as TransferDisposition, X as TransferOptions, Y as TransferVerb, Z as Vad, _ as Verb, $ as VerbName } from '../verbs-D461pHTq.cjs';
2
2
  export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from '../common-BSJZX7WO.cjs';
3
- export { C as CallCount, a as CallInfo, b as CreateCallRequest, D as DialogflowUpdate, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-0m9Hgjmn.cjs';
3
+ export { C as CallCount, a as CallInfo, b as CreateCallRequest, D as DialogflowUpdate, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-B-7QX4TM.cjs';
4
4
 
5
5
  /**
6
6
  * Types for call session data received from jambonz.
@@ -1,6 +1,6 @@
1
- export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as AgentLlm, d as AgentLlmOptions, e as AgentVerb, f as AlertVerb, g as Amd, h as AmdTimers, i as AnswerVerb, j as Auth, B as BidirectionalAudio, C as ConferenceVerb, k as ConfigVerb, D as DequeueVerb, l as DialVerb, m as DtmfVerb, n as DubVerb, E as EnqueueVerb, F as FillerNoise, G as GatherVerb, H as Handoff, o as HangupVerb, J as JambonzApp, L as LeaveVerb, p as ListenVerb, q as LlmMessage, r as LlmTool, s as LlmToolOpenAIWrapped, t as LlmToolOutputData, u as LlmVendor, v as LlmVerb, M as McpServerConfig, w as MessageVerb, P as PauseVerb, x as PlayVerb, R as Recognizer, y as RedirectVerb, S as SayVerb, z as SipDeclineVerb, I as SipReferVerb, K as SipRequestVerb, N as StreamVerb, O as Synthesizer, T as TagVerb, Q as Target, U as TranscribeVerb, V as TransferConfirm, W as TransferDisposition, X as TransferOptions, Y as TransferVerb, Z as Vad, _ as Verb, $ as VerbName } from '../verbs-DQ6zJ0bn.js';
1
+ export { A as ActionHook, a as ActionHookDelayAction, b as ActionHookObject, c as AgentLlm, d as AgentLlmOptions, e as AgentVerb, f as AlertVerb, g as Amd, h as AmdTimers, i as AnswerVerb, j as Auth, B as BidirectionalAudio, C as ConferenceVerb, k as ConfigVerb, D as DequeueVerb, l as DialVerb, m as DtmfVerb, n as DubVerb, E as EnqueueVerb, F as FillerNoise, G as GatherVerb, H as Handoff, o as HangupVerb, J as JambonzApp, L as LeaveVerb, p as ListenVerb, q as LlmMessage, r as LlmTool, s as LlmToolOpenAIWrapped, t as LlmToolOutputData, u as LlmVendor, v as LlmVerb, M as McpServerConfig, w as MessageVerb, P as PauseVerb, x as PlayVerb, R as Recognizer, y as RedirectVerb, S as SayVerb, z as SipDeclineVerb, I as SipReferVerb, K as SipRequestVerb, N as StreamVerb, O as Synthesizer, T as TagVerb, Q as Target, U as TranscribeVerb, V as TransferConfirm, W as TransferDisposition, X as TransferOptions, Y as TransferVerb, Z as Vad, _ as Verb, $ as VerbName } from '../verbs-D461pHTq.js';
2
2
  export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from '../common-BSJZX7WO.js';
3
- export { C as CallCount, a as CallInfo, b as CreateCallRequest, D as DialogflowUpdate, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-CqS2POQv.js';
3
+ export { C as CallCount, a as CallInfo, b as CreateCallRequest, D as DialogflowUpdate, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-r1vLsPCg.js';
4
4
 
5
5
  /**
6
6
  * Types for call session data received from jambonz.
@@ -1,4 +1,4 @@
1
- import { _ as Verb, S as SayVerb, x as PlayVerb, G as GatherVerb, v as LlmVerb, a0 as S2sVerb, a1 as LlmBaseOptions, a2 as DialogflowVerb, e as AgentVerb, p as ListenVerb, N as StreamVerb, U as TranscribeVerb, l as DialVerb, C as ConferenceVerb, a3 as RoomVerb, E as EnqueueVerb, D as DequeueVerb, o as HangupVerb, y as RedirectVerb, P as PauseVerb, L as LeaveVerb, z as SipDeclineVerb, K as SipRequestVerb, I as SipReferVerb, Y as TransferVerb, k as ConfigVerb, i as AnswerVerb, f as AlertVerb, T as TagVerb, m as DtmfVerb, n as DubVerb, w as MessageVerb } from './verbs-DQ6zJ0bn.cjs';
1
+ import { _ as Verb, S as SayVerb, x as PlayVerb, G as GatherVerb, v as LlmVerb, a0 as S2sVerb, a1 as LlmBaseOptions, a2 as DialogflowVerb, e as AgentVerb, p as ListenVerb, N as StreamVerb, U as TranscribeVerb, l as DialVerb, C as ConferenceVerb, a3 as RoomVerb, E as EnqueueVerb, D as DequeueVerb, o as HangupVerb, y as RedirectVerb, P as PauseVerb, L as LeaveVerb, z as SipDeclineVerb, K as SipRequestVerb, I as SipReferVerb, Y as TransferVerb, k as ConfigVerb, i as AnswerVerb, f as AlertVerb, T as TagVerb, m as DtmfVerb, n as DubVerb, w as MessageVerb } from './verbs-D461pHTq.js';
2
2
 
3
3
  /**
4
4
  * Schema-based validation using AJV.
@@ -61,7 +61,9 @@ declare class VerbBuilder {
61
61
  qwen_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
62
62
  gptlive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
63
63
  nova_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
64
+ rime_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
64
65
  voicelive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
66
+ phonic_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
65
67
  /** Shortcut for s2s with vendor='google'. */
66
68
  google_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
67
69
  /** Shortcut for s2s with vendor='elevenlabs'. */
@@ -1,4 +1,4 @@
1
- import { _ as Verb, S as SayVerb, x as PlayVerb, G as GatherVerb, v as LlmVerb, a0 as S2sVerb, a1 as LlmBaseOptions, a2 as DialogflowVerb, e as AgentVerb, p as ListenVerb, N as StreamVerb, U as TranscribeVerb, l as DialVerb, C as ConferenceVerb, a3 as RoomVerb, E as EnqueueVerb, D as DequeueVerb, o as HangupVerb, y as RedirectVerb, P as PauseVerb, L as LeaveVerb, z as SipDeclineVerb, K as SipRequestVerb, I as SipReferVerb, Y as TransferVerb, k as ConfigVerb, i as AnswerVerb, f as AlertVerb, T as TagVerb, m as DtmfVerb, n as DubVerb, w as MessageVerb } from './verbs-DQ6zJ0bn.js';
1
+ import { _ as Verb, S as SayVerb, x as PlayVerb, G as GatherVerb, v as LlmVerb, a0 as S2sVerb, a1 as LlmBaseOptions, a2 as DialogflowVerb, e as AgentVerb, p as ListenVerb, N as StreamVerb, U as TranscribeVerb, l as DialVerb, C as ConferenceVerb, a3 as RoomVerb, E as EnqueueVerb, D as DequeueVerb, o as HangupVerb, y as RedirectVerb, P as PauseVerb, L as LeaveVerb, z as SipDeclineVerb, K as SipRequestVerb, I as SipReferVerb, Y as TransferVerb, k as ConfigVerb, i as AnswerVerb, f as AlertVerb, T as TagVerb, m as DtmfVerb, n as DubVerb, w as MessageVerb } from './verbs-D461pHTq.cjs';
2
2
 
3
3
  /**
4
4
  * Schema-based validation using AJV.
@@ -61,7 +61,9 @@ declare class VerbBuilder {
61
61
  qwen_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
62
62
  gptlive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
63
63
  nova_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
64
+ rime_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
64
65
  voicelive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
66
+ phonic_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
65
67
  /** Shortcut for s2s with vendor='google'. */
66
68
  google_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this;
67
69
  /** Shortcut for s2s with vendor='elevenlabs'. */
@@ -144,6 +144,16 @@ interface Recognizer {
144
144
  mistralOptions?: Record<string, unknown>;
145
145
  modulateOptions?: Record<string, unknown>;
146
146
  zoomOptions?: Record<string, unknown>;
147
+ azureopenaiOptions?: Record<string, unknown>;
148
+ gnaniOptions?: Record<string, unknown>;
149
+ inworldOptions?: Record<string, unknown>;
150
+ kugelaudioOptions?: Record<string, unknown>;
151
+ metaOptions?: Record<string, unknown>;
152
+ saidwireOptions?: Record<string, unknown>;
153
+ sarvamOptions?: Record<string, unknown>;
154
+ smallestaiOptions?: Record<string, unknown>;
155
+ /** Paxa Labs options; only when the recognizer vendor is 'paxa'. */
156
+ paxaOptions?: Record<string, unknown>;
147
157
  customOptions?: Record<string, unknown>;
148
158
  }
149
159
  /** Call target for the dial verb. */
@@ -434,6 +444,8 @@ interface LlmBaseOptions {
434
444
  apiKey?: string;
435
445
  [key: string]: unknown;
436
446
  };
447
+ /** With no auth: the label of the account's speech-to-speech credential to use (e.g. openai_s2s); omit for the unlabelled one. */
448
+ label?: string;
437
449
  /** Additional connection options (e.g. custom base URLs). */
438
450
  connectOptions?: Record<string, unknown>;
439
451
  /** LLM configuration including messages, temperature, tools. */
@@ -506,9 +518,15 @@ interface GptliveS2sVerb extends LlmBaseOptions {
506
518
  interface NovaS2sVerb extends LlmBaseOptions {
507
519
  verb: 'nova_s2s';
508
520
  }
521
+ interface RimeS2sVerb extends LlmBaseOptions {
522
+ verb: 'rime_s2s';
523
+ }
509
524
  interface VoiceliveS2sVerb extends LlmBaseOptions {
510
525
  verb: 'voicelive_s2s';
511
526
  }
527
+ interface PhonicS2sVerb extends LlmBaseOptions {
528
+ verb: 'phonic_s2s';
529
+ }
512
530
  interface DialogflowVerb {
513
531
  verb: 'dialogflow';
514
532
  /** The deployment to use (CES). Omit to use the app's default. */
@@ -563,6 +581,8 @@ interface DialogflowVerb {
563
581
  dtmf?: string;
564
582
  };
565
583
  }
584
+ /** Voice styles the agent verb's emotion option can use. */
585
+ type AgentEmotion = 'neutral' | 'happy' | 'excited' | 'calm' | 'empathetic' | 'sad' | 'serious' | 'surprised' | 'curious' | 'angry';
566
586
  interface AgentVerb {
567
587
  verb: 'agent';
568
588
  id?: string;
@@ -570,10 +590,12 @@ interface AgentVerb {
570
590
  stt?: Recognizer;
571
591
  /** TTS configuration. Optional — can be set at the application level. */
572
592
  tts?: Synthesizer;
573
- /** Turn detection strategy. String shorthand ('stt' or 'krisp') or object with tunable params. */
574
- turnDetection?: 'stt' | 'krisp' | {
575
- mode: 'krisp';
593
+ /** Turn detection strategy. String shorthand ('stt', 'krisp' or 'jambonz') or object with tunable params. 'jambonz' is the jambonz acoustic end-of-turn model; it runs in the media server and needs no vendor key. */
594
+ turnDetection?: 'stt' | 'krisp' | 'jambonz' | {
595
+ mode: 'krisp' | 'jambonz';
596
+ /** End-of-turn confidence threshold (0-1). Default: 0.5 for krisp; 0.9 for jambonz, where it is the starting value of a threshold that falls to 0 over 1.6 s of silence. */
576
597
  threshold?: number;
598
+ /** Krisp model name override (krisp only). */
577
599
  model?: string;
578
600
  };
579
601
  /** Barge-in configuration — controls user interruption of assistant speech. */
@@ -581,7 +603,7 @@ interface AgentVerb {
581
603
  enable?: boolean;
582
604
  /** How interruptions are detected. 'vad' (default): speech onset tentatively interrupts the assistant and is confirmed after minSpeechDuration of sustained speech, otherwise the assistant resumes. 'interruptPrediction': an ML model scores whether caller speech is a genuine interruption attempt vs backchannel (e.g. 'uh-huh'), so the assistant is never tentatively paused and backchannel does not cut it off; requires a provisioned vendor API key. */
583
605
  strategy?: 'vad' | 'interruptPrediction';
584
- /** Detection vendor for strategy 'interruptPrediction'; defaults to 'krisp' (currently the only option). Not used with strategy 'vad'. */
606
+ /** Detection vendor for strategy 'interruptPrediction'; 'krisp' (default) or 'jambonz'. It must match turnDetection when that is 'krisp' or 'jambonz' (they share one session). Not used with strategy 'vad'. */
585
607
  vendor?: string;
586
608
  /** Probability threshold for interruptPrediction (0-1). Higher values require stronger evidence before interrupting the assistant. Default: 0.5. */
587
609
  threshold?: number;
@@ -623,11 +645,35 @@ interface AgentVerb {
623
645
  speak?: boolean;
624
646
  /** Keep stage-direction-only paragraphs ('(silence)', '[No response needed]', '*pauses*') and <think>/<thinking>/<reasoning> blocks out of TTS. History and events keep the raw text. Default: true. */
625
647
  speechCleanup?: boolean;
648
+ /** Emotion-aware voice: the caller's tone is passed to the LLM, and the LLM may change the voice style with <voice/> directives that are rendered as the TTS vendor's own style tags. Omit to leave the agent unchanged. */
649
+ emotion?: {
650
+ /** Where the caller's tone comes from: the STT vendor's label, the LLM's reading of the words, or both ('auto'). Default: 'auto'. */
651
+ listen?: 'auto' | 'stt' | 'llm' | 'off';
652
+ /** Let the LLM change the voice style. Ignored when the TTS model has no style control. Default: true. */
653
+ speak?: boolean;
654
+ /** Allow-list of emotions the LLM may use. Default: every emotion the TTS model supports. */
655
+ emotions?: AgentEmotion[];
656
+ /** Allow non-speech sounds (e.g. laugh), all or a list. Default: false. */
657
+ sounds?: boolean | Array<'laugh' | 'sigh' | 'breath' | 'pause'>;
658
+ /** Drop STT emotion labels whose confidence is below this. Default: 0.5. */
659
+ minConfidence?: number;
660
+ /** The style every reply starts in. Default: 'neutral'. */
661
+ default?: AgentEmotion;
662
+ };
626
663
  /** Enable server-side noise isolation to reduce background noise on call audio. Defaults to inbound (caller) audio; set direction to 'write' for outbound. */
627
- noiseIsolation?: 'krisp' | 'rnnoise' | {
664
+ noiseIsolation?: 'krisp' | 'rnnoise' | 'kugelaudio' | 'aicoustics' | {
665
+ /** Vendor: 'krisp', 'rnnoise', 'kugelaudio' or 'aicoustics'. */
628
666
  mode: string;
667
+ /** Label of the speech credential to use, for vendors that need one (kugelaudio). */
668
+ label?: string;
669
+ /** Inline credentials for vendors that need them (kugelaudio). When omitted, the speech credential is looked up by vendor and label. */
670
+ auth?: {
671
+ apiKey?: string;
672
+ apiUri?: string;
673
+ };
629
674
  level?: number;
630
675
  direction?: 'read' | 'write';
676
+ /** Model name override. For aicoustics, a model file name in the media server's model directory. */
631
677
  model?: string;
632
678
  };
633
679
  /** External MCP servers that provide tools to the LLM. */
@@ -1146,7 +1192,7 @@ interface MessageVerb {
1146
1192
  actionHook?: ActionHook;
1147
1193
  }
1148
1194
  /** Any jambonz verb. Discriminated on the 'verb' property. */
1149
- type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | QwenS2sVerb | GptliveS2sVerb | NovaS2sVerb | VoiceliveS2sVerb | DialogflowVerb | AgentVerb | ConferenceVerb | RoomVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb | TransferVerb;
1195
+ type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | QwenS2sVerb | GptliveS2sVerb | NovaS2sVerb | RimeS2sVerb | VoiceliveS2sVerb | PhonicS2sVerb | DialogflowVerb | AgentVerb | ConferenceVerb | RoomVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb | TransferVerb;
1150
1196
  /** A jambonz application — an array of verbs executed sequentially. */
1151
1197
  type JambonzApp = Verb[];
1152
1198
  /** All valid verb names. */
@@ -144,6 +144,16 @@ interface Recognizer {
144
144
  mistralOptions?: Record<string, unknown>;
145
145
  modulateOptions?: Record<string, unknown>;
146
146
  zoomOptions?: Record<string, unknown>;
147
+ azureopenaiOptions?: Record<string, unknown>;
148
+ gnaniOptions?: Record<string, unknown>;
149
+ inworldOptions?: Record<string, unknown>;
150
+ kugelaudioOptions?: Record<string, unknown>;
151
+ metaOptions?: Record<string, unknown>;
152
+ saidwireOptions?: Record<string, unknown>;
153
+ sarvamOptions?: Record<string, unknown>;
154
+ smallestaiOptions?: Record<string, unknown>;
155
+ /** Paxa Labs options; only when the recognizer vendor is 'paxa'. */
156
+ paxaOptions?: Record<string, unknown>;
147
157
  customOptions?: Record<string, unknown>;
148
158
  }
149
159
  /** Call target for the dial verb. */
@@ -434,6 +444,8 @@ interface LlmBaseOptions {
434
444
  apiKey?: string;
435
445
  [key: string]: unknown;
436
446
  };
447
+ /** With no auth: the label of the account's speech-to-speech credential to use (e.g. openai_s2s); omit for the unlabelled one. */
448
+ label?: string;
437
449
  /** Additional connection options (e.g. custom base URLs). */
438
450
  connectOptions?: Record<string, unknown>;
439
451
  /** LLM configuration including messages, temperature, tools. */
@@ -506,9 +518,15 @@ interface GptliveS2sVerb extends LlmBaseOptions {
506
518
  interface NovaS2sVerb extends LlmBaseOptions {
507
519
  verb: 'nova_s2s';
508
520
  }
521
+ interface RimeS2sVerb extends LlmBaseOptions {
522
+ verb: 'rime_s2s';
523
+ }
509
524
  interface VoiceliveS2sVerb extends LlmBaseOptions {
510
525
  verb: 'voicelive_s2s';
511
526
  }
527
+ interface PhonicS2sVerb extends LlmBaseOptions {
528
+ verb: 'phonic_s2s';
529
+ }
512
530
  interface DialogflowVerb {
513
531
  verb: 'dialogflow';
514
532
  /** The deployment to use (CES). Omit to use the app's default. */
@@ -563,6 +581,8 @@ interface DialogflowVerb {
563
581
  dtmf?: string;
564
582
  };
565
583
  }
584
+ /** Voice styles the agent verb's emotion option can use. */
585
+ type AgentEmotion = 'neutral' | 'happy' | 'excited' | 'calm' | 'empathetic' | 'sad' | 'serious' | 'surprised' | 'curious' | 'angry';
566
586
  interface AgentVerb {
567
587
  verb: 'agent';
568
588
  id?: string;
@@ -570,10 +590,12 @@ interface AgentVerb {
570
590
  stt?: Recognizer;
571
591
  /** TTS configuration. Optional — can be set at the application level. */
572
592
  tts?: Synthesizer;
573
- /** Turn detection strategy. String shorthand ('stt' or 'krisp') or object with tunable params. */
574
- turnDetection?: 'stt' | 'krisp' | {
575
- mode: 'krisp';
593
+ /** Turn detection strategy. String shorthand ('stt', 'krisp' or 'jambonz') or object with tunable params. 'jambonz' is the jambonz acoustic end-of-turn model; it runs in the media server and needs no vendor key. */
594
+ turnDetection?: 'stt' | 'krisp' | 'jambonz' | {
595
+ mode: 'krisp' | 'jambonz';
596
+ /** End-of-turn confidence threshold (0-1). Default: 0.5 for krisp; 0.9 for jambonz, where it is the starting value of a threshold that falls to 0 over 1.6 s of silence. */
576
597
  threshold?: number;
598
+ /** Krisp model name override (krisp only). */
577
599
  model?: string;
578
600
  };
579
601
  /** Barge-in configuration — controls user interruption of assistant speech. */
@@ -581,7 +603,7 @@ interface AgentVerb {
581
603
  enable?: boolean;
582
604
  /** How interruptions are detected. 'vad' (default): speech onset tentatively interrupts the assistant and is confirmed after minSpeechDuration of sustained speech, otherwise the assistant resumes. 'interruptPrediction': an ML model scores whether caller speech is a genuine interruption attempt vs backchannel (e.g. 'uh-huh'), so the assistant is never tentatively paused and backchannel does not cut it off; requires a provisioned vendor API key. */
583
605
  strategy?: 'vad' | 'interruptPrediction';
584
- /** Detection vendor for strategy 'interruptPrediction'; defaults to 'krisp' (currently the only option). Not used with strategy 'vad'. */
606
+ /** Detection vendor for strategy 'interruptPrediction'; 'krisp' (default) or 'jambonz'. It must match turnDetection when that is 'krisp' or 'jambonz' (they share one session). Not used with strategy 'vad'. */
585
607
  vendor?: string;
586
608
  /** Probability threshold for interruptPrediction (0-1). Higher values require stronger evidence before interrupting the assistant. Default: 0.5. */
587
609
  threshold?: number;
@@ -623,11 +645,35 @@ interface AgentVerb {
623
645
  speak?: boolean;
624
646
  /** Keep stage-direction-only paragraphs ('(silence)', '[No response needed]', '*pauses*') and <think>/<thinking>/<reasoning> blocks out of TTS. History and events keep the raw text. Default: true. */
625
647
  speechCleanup?: boolean;
648
+ /** Emotion-aware voice: the caller's tone is passed to the LLM, and the LLM may change the voice style with <voice/> directives that are rendered as the TTS vendor's own style tags. Omit to leave the agent unchanged. */
649
+ emotion?: {
650
+ /** Where the caller's tone comes from: the STT vendor's label, the LLM's reading of the words, or both ('auto'). Default: 'auto'. */
651
+ listen?: 'auto' | 'stt' | 'llm' | 'off';
652
+ /** Let the LLM change the voice style. Ignored when the TTS model has no style control. Default: true. */
653
+ speak?: boolean;
654
+ /** Allow-list of emotions the LLM may use. Default: every emotion the TTS model supports. */
655
+ emotions?: AgentEmotion[];
656
+ /** Allow non-speech sounds (e.g. laugh), all or a list. Default: false. */
657
+ sounds?: boolean | Array<'laugh' | 'sigh' | 'breath' | 'pause'>;
658
+ /** Drop STT emotion labels whose confidence is below this. Default: 0.5. */
659
+ minConfidence?: number;
660
+ /** The style every reply starts in. Default: 'neutral'. */
661
+ default?: AgentEmotion;
662
+ };
626
663
  /** Enable server-side noise isolation to reduce background noise on call audio. Defaults to inbound (caller) audio; set direction to 'write' for outbound. */
627
- noiseIsolation?: 'krisp' | 'rnnoise' | {
664
+ noiseIsolation?: 'krisp' | 'rnnoise' | 'kugelaudio' | 'aicoustics' | {
665
+ /** Vendor: 'krisp', 'rnnoise', 'kugelaudio' or 'aicoustics'. */
628
666
  mode: string;
667
+ /** Label of the speech credential to use, for vendors that need one (kugelaudio). */
668
+ label?: string;
669
+ /** Inline credentials for vendors that need them (kugelaudio). When omitted, the speech credential is looked up by vendor and label. */
670
+ auth?: {
671
+ apiKey?: string;
672
+ apiUri?: string;
673
+ };
629
674
  level?: number;
630
675
  direction?: 'read' | 'write';
676
+ /** Model name override. For aicoustics, a model file name in the media server's model directory. */
631
677
  model?: string;
632
678
  };
633
679
  /** External MCP servers that provide tools to the LLM. */
@@ -1146,7 +1192,7 @@ interface MessageVerb {
1146
1192
  actionHook?: ActionHook;
1147
1193
  }
1148
1194
  /** Any jambonz verb. Discriminated on the 'verb' property. */
1149
- type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | QwenS2sVerb | GptliveS2sVerb | NovaS2sVerb | VoiceliveS2sVerb | DialogflowVerb | AgentVerb | ConferenceVerb | RoomVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb | TransferVerb;
1195
+ type Verb = AnswerVerb | AlertVerb | ConfigVerb | SayVerb | PlayVerb | GatherVerb | DialVerb | ListenVerb | StreamVerb | LlmVerb | S2sVerb | OpenaiS2sVerb | GoogleS2sVerb | ElevenlabsS2sVerb | DeepgramS2sVerb | UltravoxS2sVerb | QwenS2sVerb | GptliveS2sVerb | NovaS2sVerb | RimeS2sVerb | VoiceliveS2sVerb | PhonicS2sVerb | DialogflowVerb | AgentVerb | ConferenceVerb | RoomVerb | TranscribeVerb | EnqueueVerb | DequeueVerb | DtmfVerb | DubVerb | HangupVerb | LeaveVerb | MessageVerb | PauseVerb | RedirectVerb | TagVerb | SipDeclineVerb | SipRequestVerb | SipReferVerb | TransferVerb;
1150
1196
  /** A jambonz application — an array of verbs executed sequentially. */
1151
1197
  type JambonzApp = Verb[];
1152
1198
  /** All valid verb names. */
@@ -145,9 +145,15 @@ var VerbBuilder = class {
145
145
  nova_s2s(opts) {
146
146
  return this.addVerb({ verb: "nova_s2s", ...opts });
147
147
  }
148
+ rime_s2s(opts) {
149
+ return this.addVerb({ verb: "rime_s2s", ...opts });
150
+ }
148
151
  voicelive_s2s(opts) {
149
152
  return this.addVerb({ verb: "voicelive_s2s", ...opts });
150
153
  }
154
+ phonic_s2s(opts) {
155
+ return this.addVerb({ verb: "phonic_s2s", ...opts });
156
+ }
151
157
  /** Shortcut for s2s with vendor='google'. */
152
158
  google_s2s(opts) {
153
159
  return this.addVerb({ verb: "google_s2s", ...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":"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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 RoomVerb,\n S2sVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n TransferVerb,\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 qwen_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'qwen_s2s', ...opts });\n }\n\n gptlive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'gptlive_s2s', ...opts });\n }\n\n nova_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'nova_s2s', ...opts });\n }\n\n voicelive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'voicelive_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 /** `room` is a synonym for `conference` — prefer it in new applications. */\n room(opts: Omit<RoomVerb, 'verb'>): this {\n return this.addVerb({ verb: 'room', ...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 /** Transfer the caller to a destination (blind, or warm parked/three-way) with built-in failure handling. */\n transfer(opts: Omit<TransferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transfer', ...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 RoomVerb,\n S2sVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n TransferVerb,\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 qwen_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'qwen_s2s', ...opts });\n }\n\n gptlive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'gptlive_s2s', ...opts });\n }\n\n nova_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'nova_s2s', ...opts });\n }\n\n rime_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'rime_s2s', ...opts });\n }\n\n voicelive_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'voicelive_s2s', ...opts });\n }\n\n phonic_s2s(opts: Omit<LlmBaseOptions, 'vendor'>): this {\n return this.addVerb({ verb: 'phonic_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 /** `room` is a synonym for `conference` — prefer it in new applications. */\n room(opts: Omit<RoomVerb, 'verb'>): this {\n return this.addVerb({ verb: 'room', ...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 /** Transfer the caller to a destination (blind, or warm parked/three-way) with built-in failure handling. */\n transfer(opts: Omit<TransferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transfer', ...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,5 +1,5 @@
1
- import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-C1id83_f.cjs';
2
- import { J as JambonzApp } from '../verbs-DQ6zJ0bn.cjs';
1
+ import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-tc7P_MTy.cjs';
2
+ import { J as JambonzApp } from '../verbs-D461pHTq.cjs';
3
3
  import { IncomingMessage, ServerResponse } from 'http';
4
4
  import { a as EnvVarSchema } from '../common-BSJZX7WO.cjs';
5
5
 
@@ -1,5 +1,5 @@
1
- import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-YFevoXCs.js';
2
- import { J as JambonzApp } from '../verbs-DQ6zJ0bn.js';
1
+ import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-UVx6Exh1.js';
2
+ import { J as JambonzApp } from '../verbs-D461pHTq.js';
3
3
  import { IncomingMessage, ServerResponse } from 'http';
4
4
  import { a as EnvVarSchema } from '../common-BSJZX7WO.js';
5
5
 
@@ -138,9 +138,15 @@ var VerbBuilder = class {
138
138
  nova_s2s(opts) {
139
139
  return this.addVerb({ verb: "nova_s2s", ...opts });
140
140
  }
141
+ rime_s2s(opts) {
142
+ return this.addVerb({ verb: "rime_s2s", ...opts });
143
+ }
141
144
  voicelive_s2s(opts) {
142
145
  return this.addVerb({ verb: "voicelive_s2s", ...opts });
143
146
  }
147
+ phonic_s2s(opts) {
148
+ return this.addVerb({ verb: "phonic_s2s", ...opts });
149
+ }
144
150
  /** Shortcut for s2s with vendor='google'. */
145
151
  google_s2s(opts) {
146
152
  return this.addVerb({ verb: "google_s2s", ...opts });