@jambonz/sdk 0.8.2 → 0.9.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.
@@ -1,5 +1,5 @@
1
- import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-C1bMbs6-.cjs';
2
- import { A as ActionHook, $ as Verb } from '../verbs-Bq-MRFKt.cjs';
1
+ import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-D1QKhJ9w.cjs';
2
+ import { A as ActionHook, _ as Verb } from '../verbs-D3M5wzwF.cjs';
3
3
 
4
4
  /**
5
5
  * JambonzClient — REST API client for the jambonz platform.
@@ -1,5 +1,5 @@
1
- import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-arm-pIoj.js';
2
- import { A as ActionHook, $ as Verb } from '../verbs-Bq-MRFKt.js';
1
+ import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-CFV1CPqf.js';
2
+ import { A as ActionHook, _ as Verb } from '../verbs-D3M5wzwF.js';
3
3
 
4
4
  /**
5
5
  * JambonzClient — REST API client for the jambonz platform.
package/dist/index.d.cts CHANGED
@@ -1,8 +1,8 @@
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 LLM_VENDORS, p as LeaveVerb, q as ListenVerb, r as LlmMessage, s as LlmTool, t as LlmToolOpenAIWrapped, u as LlmToolOutputData, v as LlmVendor, w as LlmVerb, M as McpServerConfig, x as MessageVerb, P as PauseVerb, y as PlayVerb, R as Recognizer, z as RedirectVerb, S as SayVerb, I as SipDeclineVerb, K as SipReferVerb, N as SipRequestVerb, O as StreamVerb, Q as Synthesizer, T as TagVerb, U as Target, V as TranscribeVerb, W as TransferConfirm, X as TransferDisposition, Y as TransferOptions, Z as TransferVerb, _ as Vad, $ as Verb, a0 as VerbName } from './verbs-Bq-MRFKt.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-D3M5wzwF.cjs';
2
2
  export { A as AgentEvent, a as AgentEventType, b as AgentLlmResponseEvent, c as AgentPreflightMetrics, d as AgentTurnEndEvent, e as AgentTurnLatency, f as AgentUserInterruptionEvent, g as AgentUserTranscriptEvent, C as CallSession, T as TtsStreamingEvent, h as TtsStreamingEventType, W as WsMessage, i as WsMessageType, j as WsResponse } from './session-DKaSRkIo.cjs';
3
3
  export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from './common-BSJZX7WO.cjs';
4
- export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from './rest-C1bMbs6-.cjs';
5
- export { J as JambonzValidator, V as ValidationError, a as ValidationResult, b as VerbBuilder, c as VerbBuilderOptions, g as getValidator } from './verb-builder-DpeNsmyP.cjs';
4
+ export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from './rest-D1QKhJ9w.cjs';
5
+ export { J as JambonzValidator, V as ValidationError, a as ValidationResult, b as VerbBuilder, c as VerbBuilderOptions, g as getValidator } from './verb-builder-BOAclVFC.cjs';
6
6
  export { WebhookResponse, envVarsMiddleware } from './webhook/index.cjs';
7
7
  export { AudioClient, AudioClientEvents, AudioStream, AudioStreamEvents, AudioStreamMetadata, EndpointOptions, MakeService, Middleware, PlayAudioOptions, Session, WsClient, WsClientEvents, WsRouter, createEndpoint } from './websocket/index.cjs';
8
8
  export { CallsResource, ClientOptions, ConferencesResource, JambonzClient, QueuesResource } from './client/index.cjs';
package/dist/index.d.ts CHANGED
@@ -1,8 +1,8 @@
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 LLM_VENDORS, p as LeaveVerb, q as ListenVerb, r as LlmMessage, s as LlmTool, t as LlmToolOpenAIWrapped, u as LlmToolOutputData, v as LlmVendor, w as LlmVerb, M as McpServerConfig, x as MessageVerb, P as PauseVerb, y as PlayVerb, R as Recognizer, z as RedirectVerb, S as SayVerb, I as SipDeclineVerb, K as SipReferVerb, N as SipRequestVerb, O as StreamVerb, Q as Synthesizer, T as TagVerb, U as Target, V as TranscribeVerb, W as TransferConfirm, X as TransferDisposition, Y as TransferOptions, Z as TransferVerb, _ as Vad, $ as Verb, a0 as VerbName } from './verbs-Bq-MRFKt.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-D3M5wzwF.js';
2
2
  export { A as AgentEvent, a as AgentEventType, b as AgentLlmResponseEvent, c as AgentPreflightMetrics, d as AgentTurnEndEvent, e as AgentTurnLatency, f as AgentUserInterruptionEvent, g as AgentUserTranscriptEvent, C as CallSession, T as TtsStreamingEvent, h as TtsStreamingEventType, W as WsMessage, i as WsMessageType, j as WsResponse } from './session-DKaSRkIo.js';
3
3
  export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from './common-BSJZX7WO.js';
4
- export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from './rest-arm-pIoj.js';
5
- export { J as JambonzValidator, V as ValidationError, a as ValidationResult, b as VerbBuilder, c as VerbBuilderOptions, g as getValidator } from './verb-builder-BcM7Cth-.js';
4
+ export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from './rest-CFV1CPqf.js';
5
+ export { J as JambonzValidator, V as ValidationError, a as ValidationResult, b as VerbBuilder, c as VerbBuilderOptions, g as getValidator } from './verb-builder-CL8zS_z0.js';
6
6
  export { WebhookResponse, envVarsMiddleware } from './webhook/index.js';
7
7
  export { AudioClient, AudioClientEvents, AudioStream, AudioStreamEvents, AudioStreamMetadata, EndpointOptions, MakeService, Middleware, PlayAudioOptions, Session, WsClient, WsClientEvents, WsRouter, createEndpoint } from './websocket/index.js';
8
8
  export { CallsResource, ClientOptions, ConferencesResource, JambonzClient, QueuesResource } from './client/index.js';
@@ -1,4 +1,4 @@
1
- import { A as ActionHook, $ as Verb, S as SayVerb, Z as TransferVerb } from './verbs-Bq-MRFKt.js';
1
+ import { A as ActionHook, _ as Verb, S as SayVerb, Y as TransferVerb } from './verbs-D3M5wzwF.js';
2
2
 
3
3
  /**
4
4
  * Types for the jambonz REST API client.
@@ -1,4 +1,4 @@
1
- import { A as ActionHook, $ as Verb, S as SayVerb, Z as TransferVerb } from './verbs-Bq-MRFKt.cjs';
1
+ import { A as ActionHook, _ as Verb, S as SayVerb, Y as TransferVerb } from './verbs-D3M5wzwF.cjs';
2
2
 
3
3
  /**
4
4
  * Types for the jambonz REST API client.
@@ -1,22 +1,4 @@
1
1
  'use strict';
2
2
 
3
- // src/types/llm-vendors.generated.ts
4
- var LLM_VENDORS = [
5
- "openai",
6
- "anthropic",
7
- "google",
8
- "vertex-gemini",
9
- "vertex-openai",
10
- "bedrock",
11
- "deepseek",
12
- "baseten",
13
- "azure-openai",
14
- "groq",
15
- "huggingface",
16
- "moonshot",
17
- "zai"
18
- ];
19
-
20
- exports.LLM_VENDORS = LLM_VENDORS;
21
3
  //# sourceMappingURL=index.cjs.map
22
4
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/types/llm-vendors.generated.ts"],"names":[],"mappings":";;;AAQO,IAAM,WAAA,GAAc;AAAA,EACzB,QAAA;AAAA,EACA,WAAA;AAAA,EACA,QAAA;AAAA,EACA,eAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,cAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF","file":"index.cjs","sourcesContent":["// AUTO-GENERATED — DO NOT EDIT BY HAND.\n// Source of truth: @jambonz/schema@0.3.18 verbs/agent.schema.json (llm.vendor.enum)\n// Regenerate with: npm run gen:types\n//\n// This file derives the LLM vendor list from the JSON schema so the SDK's\n// types never drift from the schema when a new vendor is added.\n\n/** Supported LLM vendors for the agent verb, derived from the schema enum. */\nexport const LLM_VENDORS = [\n 'openai',\n 'anthropic',\n 'google',\n 'vertex-gemini',\n 'vertex-openai',\n 'bedrock',\n 'deepseek',\n 'baseten',\n 'azure-openai',\n 'groq',\n 'huggingface',\n 'moonshot',\n 'zai',\n] as const;\n\n/** Union of LLM vendor ids accepted by the agent verb's `llm.vendor`. */\nexport type LlmVendor = (typeof LLM_VENDORS)[number];\n"]}
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
@@ -1,4 +1,4 @@
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 LLM_VENDORS, p as LeaveVerb, q as ListenVerb, r as LlmMessage, s as LlmTool, t as LlmToolOpenAIWrapped, u as LlmToolOutputData, v as LlmVendor, w as LlmVerb, M as McpServerConfig, x as MessageVerb, P as PauseVerb, y as PlayVerb, R as Recognizer, z as RedirectVerb, S as SayVerb, I as SipDeclineVerb, K as SipReferVerb, N as SipRequestVerb, O as StreamVerb, Q as Synthesizer, T as TagVerb, U as Target, V as TranscribeVerb, W as TransferConfirm, X as TransferDisposition, Y as TransferOptions, Z as TransferVerb, _ as Vad, $ as Verb, a0 as VerbName } from '../verbs-Bq-MRFKt.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-D3M5wzwF.cjs';
2
2
  export { A as AgentEvent, a as AgentEventType, b as AgentLlmResponseEvent, c as AgentPreflightMetrics, d as AgentTurnEndEvent, e as AgentTurnLatency, f as AgentUserInterruptionEvent, g as AgentUserTranscriptEvent, C as CallSession, T as TtsStreamingEvent, h as TtsStreamingEventType, W as WsMessage, i as WsMessageType, j as WsResponse } from '../session-DKaSRkIo.cjs';
3
3
  export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from '../common-BSJZX7WO.cjs';
4
- export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-C1bMbs6-.cjs';
4
+ export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-D1QKhJ9w.cjs';
@@ -1,4 +1,4 @@
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 LLM_VENDORS, p as LeaveVerb, q as ListenVerb, r as LlmMessage, s as LlmTool, t as LlmToolOpenAIWrapped, u as LlmToolOutputData, v as LlmVendor, w as LlmVerb, M as McpServerConfig, x as MessageVerb, P as PauseVerb, y as PlayVerb, R as Recognizer, z as RedirectVerb, S as SayVerb, I as SipDeclineVerb, K as SipReferVerb, N as SipRequestVerb, O as StreamVerb, Q as Synthesizer, T as TagVerb, U as Target, V as TranscribeVerb, W as TransferConfirm, X as TransferDisposition, Y as TransferOptions, Z as TransferVerb, _ as Vad, $ as Verb, a0 as VerbName } from '../verbs-Bq-MRFKt.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-D3M5wzwF.js';
2
2
  export { A as AgentEvent, a as AgentEventType, b as AgentLlmResponseEvent, c as AgentPreflightMetrics, d as AgentTurnEndEvent, e as AgentTurnLatency, f as AgentUserInterruptionEvent, g as AgentUserTranscriptEvent, C as CallSession, T as TtsStreamingEvent, h as TtsStreamingEventType, W as WsMessage, i as WsMessageType, j as WsResponse } from '../session-DKaSRkIo.js';
3
3
  export { E as EnvVarDef, a as EnvVarSchema, L as Logger } from '../common-BSJZX7WO.js';
4
- export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-arm-pIoj.js';
4
+ export { C as CallCount, a as CallInfo, b as CreateCallRequest, L as ListCallsFilter, Q as QueueInfo, U as UpdateCallRequest } from '../rest-CFV1CPqf.js';
@@ -1,20 +1,3 @@
1
- // src/types/llm-vendors.generated.ts
2
- var LLM_VENDORS = [
3
- "openai",
4
- "anthropic",
5
- "google",
6
- "vertex-gemini",
7
- "vertex-openai",
8
- "bedrock",
9
- "deepseek",
10
- "baseten",
11
- "azure-openai",
12
- "groq",
13
- "huggingface",
14
- "moonshot",
15
- "zai"
16
- ];
17
1
 
18
- export { LLM_VENDORS };
19
2
  //# sourceMappingURL=index.js.map
20
3
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/types/llm-vendors.generated.ts"],"names":[],"mappings":";AAQO,IAAM,WAAA,GAAc;AAAA,EACzB,QAAA;AAAA,EACA,WAAA;AAAA,EACA,QAAA;AAAA,EACA,eAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,cAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF","file":"index.js","sourcesContent":["// AUTO-GENERATED — DO NOT EDIT BY HAND.\n// Source of truth: @jambonz/schema@0.3.18 verbs/agent.schema.json (llm.vendor.enum)\n// Regenerate with: npm run gen:types\n//\n// This file derives the LLM vendor list from the JSON schema so the SDK's\n// types never drift from the schema when a new vendor is added.\n\n/** Supported LLM vendors for the agent verb, derived from the schema enum. */\nexport const LLM_VENDORS = [\n 'openai',\n 'anthropic',\n 'google',\n 'vertex-gemini',\n 'vertex-openai',\n 'bedrock',\n 'deepseek',\n 'baseten',\n 'azure-openai',\n 'groq',\n 'huggingface',\n 'moonshot',\n 'zai',\n] as const;\n\n/** Union of LLM vendor ids accepted by the agent verb's `llm.vendor`. */\nexport type LlmVendor = (typeof LLM_VENDORS)[number];\n"]}
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
@@ -1,4 +1,4 @@
1
- import { $ as Verb, S as SayVerb, y as PlayVerb, G as GatherVerb, w as LlmVerb, a1 as S2sVerb, a2 as LlmBaseOptions, a3 as DialogflowVerb, e as AgentVerb, q as ListenVerb, O as StreamVerb, V as TranscribeVerb, l as DialVerb, C as ConferenceVerb, a4 as RoomVerb, E as EnqueueVerb, D as DequeueVerb, o as HangupVerb, z as RedirectVerb, P as PauseVerb, p as LeaveVerb, I as SipDeclineVerb, N as SipRequestVerb, K as SipReferVerb, Z as TransferVerb, k as ConfigVerb, i as AnswerVerb, f as AlertVerb, T as TagVerb, m as DtmfVerb, n as DubVerb, x as MessageVerb } from './verbs-Bq-MRFKt.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-D3M5wzwF.cjs';
2
2
 
3
3
  /**
4
4
  * Schema-based validation using AJV.
@@ -1,4 +1,4 @@
1
- import { $ as Verb, S as SayVerb, y as PlayVerb, G as GatherVerb, w as LlmVerb, a1 as S2sVerb, a2 as LlmBaseOptions, a3 as DialogflowVerb, e as AgentVerb, q as ListenVerb, O as StreamVerb, V as TranscribeVerb, l as DialVerb, C as ConferenceVerb, a4 as RoomVerb, E as EnqueueVerb, D as DequeueVerb, o as HangupVerb, z as RedirectVerb, P as PauseVerb, p as LeaveVerb, I as SipDeclineVerb, N as SipRequestVerb, K as SipReferVerb, Z as TransferVerb, k as ConfigVerb, i as AnswerVerb, f as AlertVerb, T as TagVerb, m as DtmfVerb, n as DubVerb, x as MessageVerb } from './verbs-Bq-MRFKt.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-D3M5wzwF.js';
2
2
 
3
3
  /**
4
4
  * Schema-based validation using AJV.
@@ -134,6 +134,7 @@ interface Recognizer {
134
134
  assemblyAiOptions?: Record<string, unknown>;
135
135
  speechmaticsOptions?: Record<string, unknown>;
136
136
  openaiOptions?: Record<string, unknown>;
137
+ xaiOptions?: Record<string, unknown>;
137
138
  houndifyOptions?: Record<string, unknown>;
138
139
  gladiaOptions?: Record<string, unknown>;
139
140
  elevenlabsOptions?: Record<string, unknown>;
@@ -251,17 +252,19 @@ interface Amd {
251
252
  recognizer?: Recognizer;
252
253
  }
253
254
 
254
- /** Supported LLM vendors for the agent verb, derived from the schema enum. */
255
- declare const LLM_VENDORS: readonly ["openai", "anthropic", "google", "vertex-gemini", "vertex-openai", "bedrock", "deepseek", "baseten", "azure-openai", "groq", "huggingface", "moonshot", "zai"];
256
- /** Union of LLM vendor ids accepted by the agent verb's `llm.vendor`. */
257
- type LlmVendor = (typeof LLM_VENDORS)[number];
258
-
259
255
  /**
260
256
  * Verb types for all 26 jambonz verbs.
261
257
  * These map 1:1 to the JSON schemas in schema/verbs/.
262
258
  * The Verb discriminated union uses the 'verb' literal as the discriminator.
263
259
  */
264
260
 
261
+ /**
262
+ * LLM vendor id for the agent verb's `llm.vendor`. Free-form by design: the
263
+ * schema deliberately has no vendor enum so new LLMs can be added without a
264
+ * schema release; the server validates the vendor against its registered
265
+ * `@jambonz/llm` adapters at runtime.
266
+ */
267
+ type LlmVendor = string;
265
268
  interface SayVerb {
266
269
  verb: 'say';
267
270
  id?: string;
@@ -384,9 +387,10 @@ interface AgentLlmOptions {
384
387
  }
385
388
  /** `llm` block on the agent verb. */
386
389
  interface AgentLlm {
387
- /** LLM vendor. Derived from the @jambonz/schema agent verb enum — see llm-vendors.generated.ts. */
388
- vendor: LlmVendor;
389
- model: string;
390
+ /** LLM vendor. Optional: falls back to the application's default LLM vendor when omitted. */
391
+ vendor?: LlmVendor;
392
+ /** Model id. Optional: falls back to the application's default LLM model when omitted. */
393
+ model?: string;
390
394
  label?: string;
391
395
  auth?: {
392
396
  apiKey?: string;
@@ -534,8 +538,8 @@ interface AgentVerb {
534
538
  minSpeechDuration?: number;
535
539
  sticky?: boolean;
536
540
  };
537
- /** LLM configuration. */
538
- llm: AgentLlm;
541
+ /** LLM configuration. Optional: when omitted, the agent uses the application's default LLM (like stt/tts). */
542
+ llm?: AgentLlm;
539
543
  /** Webhook when agent ends. */
540
544
  actionHook?: ActionHook;
541
545
  /** Webhook for agent events. */
@@ -692,6 +696,8 @@ interface DialVerb {
692
696
  referHook?: ActionHook;
693
697
  /** Audio URL for ringback tone replacement. */
694
698
  dialMusic?: string;
699
+ /** Request SRTP (encrypted media) on the outbound call. 'sdes' negotiates keys via SDES crypto attributes (used with sips:/TLS targets); 'dtls' via DTLS-SRTP. Applies to SIP URI targets. */
700
+ srtpEncryption?: 'sdes' | 'dtls';
695
701
  /** DTMF capture patterns during bridged call. */
696
702
  dtmfCapture?: Record<string, unknown>;
697
703
  /** Webhook for captured DTMF patterns. */
@@ -1088,4 +1094,4 @@ type JambonzApp = Verb[];
1088
1094
  /** All valid verb names. */
1089
1095
  type VerbName = Verb['verb'];
1090
1096
 
1091
- export { type Verb as $, type ActionHook as A, type BidirectionalAudio as B, type ConferenceVerb as C, type DequeueVerb as D, type EnqueueVerb as E, type FillerNoise as F, type GatherVerb as G, type Handoff as H, type SipDeclineVerb as I, type JambonzApp as J, type SipReferVerb as K, LLM_VENDORS as L, type McpServerConfig as M, type SipRequestVerb as N, type StreamVerb as O, type PauseVerb as P, type Synthesizer as Q, type Recognizer as R, type SayVerb as S, type TagVerb as T, type Target as U, type TranscribeVerb as V, type TransferConfirm as W, type TransferDisposition as X, type TransferOptions as Y, type TransferVerb as Z, type Vad as _, type ActionHookDelayAction as a, type VerbName as a0, type S2sVerb as a1, type LlmBaseOptions as a2, type DialogflowVerb as a3, type RoomVerb as a4, type ActionHookObject as b, type AgentLlm as c, type AgentLlmOptions as d, type AgentVerb as e, type AlertVerb as f, type Amd as g, type AmdTimers as h, type AnswerVerb as i, type Auth as j, type ConfigVerb as k, type DialVerb as l, type DtmfVerb as m, type DubVerb as n, type HangupVerb as o, type LeaveVerb as p, type ListenVerb as q, type LlmMessage as r, type LlmTool as s, type LlmToolOpenAIWrapped as t, type LlmToolOutputData as u, type LlmVendor as v, type LlmVerb as w, type MessageVerb as x, type PlayVerb as y, type RedirectVerb as z };
1097
+ export type { VerbName as $, ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, Handoff as H, SipReferVerb as I, JambonzApp as J, SipRequestVerb as K, LeaveVerb as L, McpServerConfig as M, StreamVerb as N, Synthesizer as O, PauseVerb as P, Target as Q, Recognizer as R, SayVerb as S, TagVerb as T, TranscribeVerb as U, TransferConfirm as V, TransferDisposition as W, TransferOptions as X, TransferVerb as Y, Vad as Z, Verb as _, ActionHookDelayAction as a, S2sVerb as a0, LlmBaseOptions as a1, DialogflowVerb as a2, RoomVerb as a3, ActionHookObject as b, AgentLlm as c, AgentLlmOptions as d, AgentVerb as e, AlertVerb as f, Amd as g, AmdTimers as h, AnswerVerb as i, Auth as j, ConfigVerb as k, DialVerb as l, DtmfVerb as m, DubVerb as n, HangupVerb as o, ListenVerb as p, LlmMessage as q, LlmTool as r, LlmToolOpenAIWrapped as s, LlmToolOutputData as t, LlmVendor as u, LlmVerb as v, MessageVerb as w, PlayVerb as x, RedirectVerb as y, SipDeclineVerb as z };
@@ -134,6 +134,7 @@ interface Recognizer {
134
134
  assemblyAiOptions?: Record<string, unknown>;
135
135
  speechmaticsOptions?: Record<string, unknown>;
136
136
  openaiOptions?: Record<string, unknown>;
137
+ xaiOptions?: Record<string, unknown>;
137
138
  houndifyOptions?: Record<string, unknown>;
138
139
  gladiaOptions?: Record<string, unknown>;
139
140
  elevenlabsOptions?: Record<string, unknown>;
@@ -251,17 +252,19 @@ interface Amd {
251
252
  recognizer?: Recognizer;
252
253
  }
253
254
 
254
- /** Supported LLM vendors for the agent verb, derived from the schema enum. */
255
- declare const LLM_VENDORS: readonly ["openai", "anthropic", "google", "vertex-gemini", "vertex-openai", "bedrock", "deepseek", "baseten", "azure-openai", "groq", "huggingface", "moonshot", "zai"];
256
- /** Union of LLM vendor ids accepted by the agent verb's `llm.vendor`. */
257
- type LlmVendor = (typeof LLM_VENDORS)[number];
258
-
259
255
  /**
260
256
  * Verb types for all 26 jambonz verbs.
261
257
  * These map 1:1 to the JSON schemas in schema/verbs/.
262
258
  * The Verb discriminated union uses the 'verb' literal as the discriminator.
263
259
  */
264
260
 
261
+ /**
262
+ * LLM vendor id for the agent verb's `llm.vendor`. Free-form by design: the
263
+ * schema deliberately has no vendor enum so new LLMs can be added without a
264
+ * schema release; the server validates the vendor against its registered
265
+ * `@jambonz/llm` adapters at runtime.
266
+ */
267
+ type LlmVendor = string;
265
268
  interface SayVerb {
266
269
  verb: 'say';
267
270
  id?: string;
@@ -384,9 +387,10 @@ interface AgentLlmOptions {
384
387
  }
385
388
  /** `llm` block on the agent verb. */
386
389
  interface AgentLlm {
387
- /** LLM vendor. Derived from the @jambonz/schema agent verb enum — see llm-vendors.generated.ts. */
388
- vendor: LlmVendor;
389
- model: string;
390
+ /** LLM vendor. Optional: falls back to the application's default LLM vendor when omitted. */
391
+ vendor?: LlmVendor;
392
+ /** Model id. Optional: falls back to the application's default LLM model when omitted. */
393
+ model?: string;
390
394
  label?: string;
391
395
  auth?: {
392
396
  apiKey?: string;
@@ -534,8 +538,8 @@ interface AgentVerb {
534
538
  minSpeechDuration?: number;
535
539
  sticky?: boolean;
536
540
  };
537
- /** LLM configuration. */
538
- llm: AgentLlm;
541
+ /** LLM configuration. Optional: when omitted, the agent uses the application's default LLM (like stt/tts). */
542
+ llm?: AgentLlm;
539
543
  /** Webhook when agent ends. */
540
544
  actionHook?: ActionHook;
541
545
  /** Webhook for agent events. */
@@ -692,6 +696,8 @@ interface DialVerb {
692
696
  referHook?: ActionHook;
693
697
  /** Audio URL for ringback tone replacement. */
694
698
  dialMusic?: string;
699
+ /** Request SRTP (encrypted media) on the outbound call. 'sdes' negotiates keys via SDES crypto attributes (used with sips:/TLS targets); 'dtls' via DTLS-SRTP. Applies to SIP URI targets. */
700
+ srtpEncryption?: 'sdes' | 'dtls';
695
701
  /** DTMF capture patterns during bridged call. */
696
702
  dtmfCapture?: Record<string, unknown>;
697
703
  /** Webhook for captured DTMF patterns. */
@@ -1088,4 +1094,4 @@ type JambonzApp = Verb[];
1088
1094
  /** All valid verb names. */
1089
1095
  type VerbName = Verb['verb'];
1090
1096
 
1091
- export { type Verb as $, type ActionHook as A, type BidirectionalAudio as B, type ConferenceVerb as C, type DequeueVerb as D, type EnqueueVerb as E, type FillerNoise as F, type GatherVerb as G, type Handoff as H, type SipDeclineVerb as I, type JambonzApp as J, type SipReferVerb as K, LLM_VENDORS as L, type McpServerConfig as M, type SipRequestVerb as N, type StreamVerb as O, type PauseVerb as P, type Synthesizer as Q, type Recognizer as R, type SayVerb as S, type TagVerb as T, type Target as U, type TranscribeVerb as V, type TransferConfirm as W, type TransferDisposition as X, type TransferOptions as Y, type TransferVerb as Z, type Vad as _, type ActionHookDelayAction as a, type VerbName as a0, type S2sVerb as a1, type LlmBaseOptions as a2, type DialogflowVerb as a3, type RoomVerb as a4, type ActionHookObject as b, type AgentLlm as c, type AgentLlmOptions as d, type AgentVerb as e, type AlertVerb as f, type Amd as g, type AmdTimers as h, type AnswerVerb as i, type Auth as j, type ConfigVerb as k, type DialVerb as l, type DtmfVerb as m, type DubVerb as n, type HangupVerb as o, type LeaveVerb as p, type ListenVerb as q, type LlmMessage as r, type LlmTool as s, type LlmToolOpenAIWrapped as t, type LlmToolOutputData as u, type LlmVendor as v, type LlmVerb as w, type MessageVerb as x, type PlayVerb as y, type RedirectVerb as z };
1097
+ export type { VerbName as $, ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, Handoff as H, SipReferVerb as I, JambonzApp as J, SipRequestVerb as K, LeaveVerb as L, McpServerConfig as M, StreamVerb as N, Synthesizer as O, PauseVerb as P, Target as Q, Recognizer as R, SayVerb as S, TagVerb as T, TranscribeVerb as U, TransferConfirm as V, TransferDisposition as W, TransferOptions as X, TransferVerb as Y, Vad as Z, Verb as _, ActionHookDelayAction as a, S2sVerb as a0, LlmBaseOptions as a1, DialogflowVerb as a2, RoomVerb as a3, ActionHookObject as b, AgentLlm as c, AgentLlmOptions as d, AgentVerb as e, AlertVerb as f, Amd as g, AmdTimers as h, AnswerVerb as i, Auth as j, ConfigVerb as k, DialVerb as l, DtmfVerb as m, DubVerb as n, HangupVerb as o, ListenVerb as p, LlmMessage as q, LlmTool as r, LlmToolOpenAIWrapped as s, LlmToolOutputData as t, LlmVendor as u, LlmVerb as v, MessageVerb as w, PlayVerb as x, RedirectVerb as y, SipDeclineVerb as z };
@@ -1,5 +1,5 @@
1
- import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-DpeNsmyP.cjs';
2
- import { J as JambonzApp } from '../verbs-Bq-MRFKt.cjs';
1
+ import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-BOAclVFC.cjs';
2
+ import { J as JambonzApp } from '../verbs-D3M5wzwF.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-BcM7Cth-.js';
2
- import { J as JambonzApp } from '../verbs-Bq-MRFKt.js';
1
+ import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-CL8zS_z0.js';
2
+ import { J as JambonzApp } from '../verbs-D3M5wzwF.js';
3
3
  import { IncomingMessage, ServerResponse } from 'http';
4
4
  import { a as EnvVarSchema } from '../common-BSJZX7WO.js';
5
5
 
@@ -3,8 +3,8 @@ import { L as Logger, a as EnvVarSchema } from '../common-BSJZX7WO.cjs';
3
3
  import { EventEmitter } from 'events';
4
4
  import { WebSocket } from 'ws';
5
5
  import { C as CallSession, W as WsMessage } from '../session-DKaSRkIo.cjs';
6
- import { $ as Verb, S as SayVerb, u as LlmToolOutputData } from '../verbs-Bq-MRFKt.cjs';
7
- import { c as VerbBuilderOptions, b as VerbBuilder } from '../verb-builder-DpeNsmyP.cjs';
6
+ import { _ as Verb, S as SayVerb, t as LlmToolOutputData } from '../verbs-D3M5wzwF.cjs';
7
+ import { c as VerbBuilderOptions, b as VerbBuilder } from '../verb-builder-BOAclVFC.cjs';
8
8
 
9
9
  /**
10
10
  * WebSocket Session — represents a single call over a persistent WebSocket connection.
@@ -3,8 +3,8 @@ import { L as Logger, a as EnvVarSchema } from '../common-BSJZX7WO.js';
3
3
  import { EventEmitter } from 'events';
4
4
  import { WebSocket } from 'ws';
5
5
  import { C as CallSession, W as WsMessage } from '../session-DKaSRkIo.js';
6
- import { $ as Verb, S as SayVerb, u as LlmToolOutputData } from '../verbs-Bq-MRFKt.js';
7
- import { c as VerbBuilderOptions, b as VerbBuilder } from '../verb-builder-BcM7Cth-.js';
6
+ import { _ as Verb, S as SayVerb, t as LlmToolOutputData } from '../verbs-D3M5wzwF.js';
7
+ import { c as VerbBuilderOptions, b as VerbBuilder } from '../verb-builder-CL8zS_z0.js';
8
8
 
9
9
  /**
10
10
  * WebSocket Session — represents a single call over a persistent WebSocket connection.
@@ -0,0 +1,61 @@
1
+ # Conference Supervision
2
+
3
+ Monitor, coach, and barge into live conferences, and tap a room's audio for
4
+ transcription — the core patterns behind a call-center supervision tool,
5
+ distilled into two small files.
6
+
7
+ A complete reference application built on these patterns (React console,
8
+ diarized live transcript, closed-loop e2e tests) is at
9
+ https://github.com/jambonz/room-monitor — see its `docs/ADAPTING.md`.
10
+
11
+ ## What It Demonstrates
12
+
13
+ - **Tagging members** — `memberTag: 'agent'` at join, and mid-call
14
+ `tag`/`untag` via `injectCommand('conf:participant-action', ...)`
15
+ - **The supervisor leg** — one conference member whose join options and
16
+ participant actions produce three modes: silent monitor (`joinMuted`),
17
+ coach (audio delivered only to `agent`-tagged members), and barge-in
18
+ - **Mid-call mode switching** — `conferenceParticipantAction`
19
+ (`coach`/`uncoach`) + `conf_mute_status` via the REST client: no re-dial,
20
+ the room is never interrupted
21
+ - **Conference listen fork** — jambonz streams the room's mixed audio (L16
22
+ PCM) to your WebSocket for transcription/AI; your `metadata` arrives
23
+ verbatim as the fork's first text frame
24
+ - **Application env vars** — the caller flow's room name (`ROOM_NAME`) is
25
+ declared via OPTIONS discovery so operators edit it from the jambonz portal
26
+
27
+ ## Prerequisites
28
+
29
+ - A jambonz account with API credentials
30
+ - Three applications pointed at this app's paths (or one application and
31
+ custom `X-` headers — see the reference app): `/caller`, `/agent`,
32
+ `/supervisor`
33
+ - Conference-level listen (`/Conferences/{name}/listen`) requires a jambonz
34
+ release with MediaJam-based conferencing that includes it
35
+
36
+ ## Environment Variables
37
+
38
+ - `JAMBONZ_BASE_URL` — jambonz API URL (default: `https://api.jambonz.us`)
39
+ - `JAMBONZ_ACCOUNT_SID` — your account SID
40
+ - `JAMBONZ_API_KEY` — your API key
41
+ - `FORK_URL` — public ws(s):// URL of this app's `/fork` path (the media
42
+ server dials out to it)
43
+
44
+ ## Files
45
+
46
+ - `ws-app.ts` — the jambonz application: caller/agent/supervisor call flows +
47
+ the audio-fork sink
48
+ - `monitor.ts` — REST-side supervision driver: list live rooms, switch the
49
+ supervisor's mode (monitor → coach → barge), tag/untag a participant,
50
+ start/stop the transcription fork
51
+
52
+ ## Try It
53
+
54
+ ```bash
55
+ npm install @jambonz/sdk tsx
56
+ npx tsx ws-app.ts # the application (port 3000)
57
+ npx tsx monitor.ts # walk a live room through the supervision modes
58
+ ```
59
+
60
+ Place two calls into a room (one via `/agent`, one via `/caller`), then run
61
+ `monitor.ts` with the supervisor's call_sid to step through the modes.
@@ -0,0 +1,93 @@
1
+ import { JambonzClient } from '@jambonz/sdk/client';
2
+
3
+ /*
4
+ * Conference supervision — the REST-side driver.
5
+ *
6
+ * Walks a live room through the supervision modes using mid-call commands on
7
+ * the supervisor's existing leg (started via ws-app.ts /supervisor). Nothing
8
+ * here re-dials or interrupts the room.
9
+ *
10
+ * Usage:
11
+ * JAMBONZ_ACCOUNT_SID=... JAMBONZ_API_KEY=... \
12
+ * npx tsx monitor.ts <supervisor_call_sid> [room_name]
13
+ */
14
+
15
+ const baseUrl = process.env.JAMBONZ_BASE_URL || 'https://api.jambonz.us';
16
+ const accountSid = process.env.JAMBONZ_ACCOUNT_SID || '';
17
+ const apiKey = process.env.JAMBONZ_API_KEY || '';
18
+ const forkUrl = process.env.FORK_URL || 'wss://your-host/fork';
19
+
20
+ const supervisorCallSid = process.argv[2];
21
+ const roomName = process.argv[3] || 'support-room';
22
+ if (!accountSid || !apiKey || !supervisorCallSid) {
23
+ console.error('usage: JAMBONZ_ACCOUNT_SID=.. JAMBONZ_API_KEY=.. npx tsx monitor.ts <supervisor_call_sid> [room]');
24
+ process.exit(1);
25
+ }
26
+
27
+ const client = new JambonzClient({ baseUrl, accountSid, apiKey });
28
+ const pause = (ms: number) => new Promise((r) => setTimeout(r, ms));
29
+
30
+ /* -- discovery: what rooms are live? --------------------------------------- */
31
+ const conferences = await client.conferences.list();
32
+ console.log('live conferences:', conferences);
33
+
34
+ // On releases with the enriched listing, get participants + tags in one call:
35
+ // GET /Accounts/{sid}/Conferences?expand=participants
36
+ // → [{ id, name, durationSec, participants: [{ call_sid, label, memberTag, isAgent }] }]
37
+ // Derive agent counts (and whether Coach should be offered) from memberTag,
38
+ // and filter out memberTag === 'supervisor' legs before displaying counts.
39
+
40
+ /* -- transcription tap: stream the room mix to our websocket --------------- */
41
+ // jambonz only transports audio — the consumer (ws-app.ts /fork) decides what
42
+ // to do with it. The fork needs no participant leg, is excluded from counts,
43
+ // and is torn down automatically when the room ends.
44
+ const res = await fetch(
45
+ `${baseUrl}/v1/Accounts/${accountSid}/Conferences/${encodeURIComponent(roomName)}/listen`, {
46
+ method: 'POST',
47
+ headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
48
+ body: JSON.stringify({
49
+ url: forkUrl,
50
+ sampleRate: 16000,
51
+ metadata: { room: roomName, sampleRate: 16000 }, // delivered verbatim to the sink
52
+ }),
53
+ });
54
+ console.log(`listen fork: ${res.status}`);
55
+
56
+ /* -- the three supervision modes, as mid-call commands --------------------- */
57
+
58
+ // COACH: audio delivered only to members tagged 'agent'; the caller — and the
59
+ // audio fork — cannot hear it
60
+ console.log('coach mode: only agents hear the supervisor');
61
+ await client.calls.update(supervisorCallSid, {
62
+ conferenceParticipantAction: { action: 'coach', tag: 'agent' },
63
+ });
64
+ await client.calls.update(supervisorCallSid, { conf_mute_status: 'unmute' });
65
+ await pause(10000);
66
+
67
+ // BARGE-IN: heard by everyone
68
+ console.log('barge-in: everyone hears the supervisor');
69
+ await client.calls.update(supervisorCallSid, {
70
+ conferenceParticipantAction: { action: 'uncoach' },
71
+ });
72
+ await pause(10000);
73
+
74
+ // back to SILENT MONITOR
75
+ console.log('silent monitor: heard by no one');
76
+ await client.calls.update(supervisorCallSid, { conf_mute_status: 'mute' });
77
+
78
+ /* -- tags are dynamic too --------------------------------------------------
79
+ // promote/demote any live participant without a re-join; an active coach
80
+ // starts/stops reaching them immediately:
81
+ // await client.calls.update(someCallSid, {
82
+ // conferenceParticipantAction: { action: 'tag', tag: 'agent' },
83
+ // });
84
+ // await client.calls.update(someCallSid, {
85
+ // conferenceParticipantAction: { action: 'untag' },
86
+ // });
87
+ --------------------------------------------------------------------------- */
88
+
89
+ /* -- stop the transcription tap -------------------------------------------- */
90
+ await fetch(
91
+ `${baseUrl}/v1/Accounts/${accountSid}/Conferences/${encodeURIComponent(roomName)}/listen`,
92
+ { method: 'DELETE', headers: { Authorization: `Bearer ${apiKey}` } });
93
+ console.log('listen fork stopped');
@@ -0,0 +1,100 @@
1
+ import http from 'http';
2
+ import { createEndpoint } from '@jambonz/sdk/websocket';
3
+ import type { Session, AudioStream } from '@jambonz/sdk/websocket';
4
+
5
+ /*
6
+ * Conference supervision — the jambonz application side.
7
+ *
8
+ * Three call flows on one endpoint (point one jambonz application at each
9
+ * path), plus the audio sink that receives a conference listen fork:
10
+ *
11
+ * /caller a normal participant; which room they join is the
12
+ * application's ROOM_NAME env var (portal-editable via
13
+ * OPTIONS discovery)
14
+ * /agent joins the same room tagged 'agent' — the coach target
15
+ * /supervisor joins muted (silent monitor); mode changes come later as
16
+ * mid-call participant actions (see monitor.ts)
17
+ * /fork receives the room's mixed audio (L16 PCM) when a
18
+ * conference listen fork is started (see monitor.ts)
19
+ *
20
+ * Full reference app: https://github.com/jambonz/room-monitor
21
+ */
22
+
23
+ const envVars = {
24
+ ROOM_NAME: {
25
+ type: 'string' as const,
26
+ description: 'Conference room inbound callers join',
27
+ default: 'support-room',
28
+ },
29
+ };
30
+
31
+ const server = http.createServer();
32
+ const makeService = createEndpoint({ server, port: 3000, envVars });
33
+
34
+ const room = (session: Session): string =>
35
+ (session.data.env_vars as Record<string, string> | undefined)?.ROOM_NAME || 'support-room';
36
+
37
+ /* -- a normal caller ------------------------------------------------------ */
38
+ makeService({ path: '/caller' }).on('session:new', (session) => {
39
+ session
40
+ .answer()
41
+ .say({ text: 'Connecting you now.' })
42
+ .conference({
43
+ name: room(session),
44
+ startConferenceOnEnter: true,
45
+ endConferenceOnExit: false,
46
+ })
47
+ .send();
48
+ });
49
+
50
+ /* -- an agent: tagged, so coaching reaches them ---------------------------- */
51
+ makeService({ path: '/agent' }).on('session:new', (session) => {
52
+ session
53
+ .answer()
54
+ .conference({
55
+ name: room(session),
56
+ memberTag: 'agent', // <- the coach target; also drives supervision UIs
57
+ startConferenceOnEnter: true,
58
+ endConferenceOnExit: false,
59
+ })
60
+ .send();
61
+
62
+ // Tags are dynamic: promote/demote a live member without re-joining, e.g.
63
+ // session.injectCommand('conf:participant-action', { action: 'untag' });
64
+ // session.injectCommand('conf:participant-action', { action: 'tag', tag: 'agent' });
65
+ });
66
+
67
+ /* -- the supervisor: joins silent; modes switch mid-call ------------------- */
68
+ makeService({ path: '/supervisor' }).on('session:new', (session) => {
69
+ console.log(`supervisor leg ${session.callSid} — use this call_sid with monitor.ts`);
70
+ session
71
+ .answer()
72
+ .conference({
73
+ name: room(session),
74
+ joinMuted: true, // hears everything, heard by no one
75
+ memberTag: 'supervisor', // lets tooling filter this leg out of counts
76
+ startConferenceOnEnter: false, // never create/destroy the room being watched
77
+ endConferenceOnExit: false,
78
+ actionHook: '/conf-done',
79
+ })
80
+ .send();
81
+
82
+ session.on('/conf-done', () => {
83
+ session.hangup().reply();
84
+ });
85
+ });
86
+
87
+ /* -- the audio fork sink: the room mix arrives here ------------------------ */
88
+ makeService.audio({ path: '/fork' }).on('connection', (stream: AudioStream) => {
89
+ // the metadata you passed when starting the fork arrives verbatim as the
90
+ // first text frame — make it self-describing (room, sampleRate)
91
+ console.log('fork connected:', stream.metadata);
92
+
93
+ let bytes = 0;
94
+ stream.on('audio', (pcm: Buffer) => {
95
+ bytes += pcm.length;
96
+ // feed your STT / AI / recorder here — this is raw L16 PCM of the room
97
+ // mix. Note: coached (whispered) audio is never present in this stream.
98
+ });
99
+ stream.on('close', () => console.log(`fork closed after ${bytes} bytes`));
100
+ });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jambonz/sdk",
3
- "version": "0.8.2",
3
+ "version": "0.9.0",
4
4
  "description": "jambonz SDK for building voice applications — optimized for AI agents",
5
5
  "author": "Dave Horton",
6
6
  "license": "MIT",
@@ -82,13 +82,10 @@
82
82
  "examples"
83
83
  ],
84
84
  "scripts": {
85
- "gen:types": "node scripts/gen-llm-vendors.mjs",
86
- "prebuild": "npm run gen:types",
87
85
  "build": "tsup",
88
86
  "dev": "tsup --watch",
89
87
  "test": "vitest run",
90
88
  "test:watch": "vitest",
91
- "pretypecheck": "npm run gen:types",
92
89
  "typecheck": "tsc --noEmit",
93
90
  "lint": "eslint src/",
94
91
  "docs": "typedoc",
@@ -98,7 +95,7 @@
98
95
  "postpublish": "npm run clean-docs"
99
96
  },
100
97
  "dependencies": {
101
- "@jambonz/schema": "^0.3.18",
98
+ "@jambonz/schema": "^0.4.0",
102
99
  "ajv": "^8.17.1",
103
100
  "ws": "^8.18.0"
104
101
  },