@signalwire/sdk 2.0.1 → 2.0.3

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 (610) hide show
  1. package/dist/AgentBase.d.ts +1045 -0
  2. package/dist/AgentBase.js +2375 -0
  3. package/dist/AgentBase.js.map +1 -0
  4. package/dist/AgentServer.d.ts +146 -0
  5. package/dist/AgentServer.js +388 -0
  6. package/dist/AgentServer.js.map +1 -0
  7. package/dist/AuthHandler.d.ts +127 -0
  8. package/dist/AuthHandler.js +212 -0
  9. package/dist/AuthHandler.js.map +1 -0
  10. package/dist/ConfigLoader.d.ts +170 -0
  11. package/dist/ConfigLoader.js +393 -0
  12. package/dist/ConfigLoader.js.map +1 -0
  13. package/dist/ContextBuilder.d.ts +652 -0
  14. package/dist/ContextBuilder.js +1115 -0
  15. package/dist/ContextBuilder.js.map +1 -0
  16. package/dist/DataMap.d.ts +271 -0
  17. package/dist/DataMap.js +430 -0
  18. package/dist/DataMap.js.map +1 -0
  19. package/dist/FunctionResult.d.ts +481 -0
  20. package/dist/FunctionResult.js +775 -0
  21. package/dist/FunctionResult.js.map +1 -0
  22. package/dist/Logger.d.ts +113 -0
  23. package/dist/Logger.js +320 -0
  24. package/dist/Logger.js.map +1 -0
  25. package/dist/PomBuilder.d.ts +208 -0
  26. package/dist/PomBuilder.js +409 -0
  27. package/dist/PomBuilder.js.map +1 -0
  28. package/dist/PromptManager.d.ts +85 -0
  29. package/dist/PromptManager.js +108 -0
  30. package/dist/PromptManager.js.map +1 -0
  31. package/dist/SWMLHandler.d.ts +159 -0
  32. package/dist/SWMLHandler.js +229 -0
  33. package/dist/SWMLHandler.js.map +1 -0
  34. package/dist/SWMLService.d.ts +326 -0
  35. package/dist/SWMLService.js +610 -0
  36. package/dist/SWMLService.js.map +1 -0
  37. package/dist/SchemaUtils.d.ts +108 -0
  38. package/dist/SchemaUtils.js +317 -0
  39. package/dist/SchemaUtils.js.map +1 -0
  40. package/dist/SecurityUtils.d.ts +60 -0
  41. package/{src/SecurityUtils.ts → dist/SecurityUtils.js} +82 -83
  42. package/dist/SecurityUtils.js.map +1 -0
  43. package/dist/ServerlessAdapter.d.ts +119 -0
  44. package/dist/ServerlessAdapter.js +188 -0
  45. package/dist/ServerlessAdapter.js.map +1 -0
  46. package/dist/SessionManager.d.ts +142 -0
  47. package/dist/SessionManager.js +260 -0
  48. package/dist/SessionManager.js.map +1 -0
  49. package/dist/SslConfig.d.ts +77 -0
  50. package/dist/SslConfig.js +100 -0
  51. package/dist/SslConfig.js.map +1 -0
  52. package/dist/SwaigFunction.d.ts +159 -0
  53. package/dist/SwaigFunction.js +209 -0
  54. package/dist/SwaigFunction.js.map +1 -0
  55. package/dist/SwmlBuilder.d.ts +165 -0
  56. package/dist/SwmlBuilder.js +247 -0
  57. package/dist/SwmlBuilder.js.map +1 -0
  58. package/dist/SwmlVerbMethods.generated.d.ts +254 -0
  59. package/dist/SwmlVerbMethods.generated.js +9 -0
  60. package/dist/SwmlVerbMethods.generated.js.map +1 -0
  61. package/dist/TypeInference.d.ts +71 -0
  62. package/dist/TypeInference.js +164 -0
  63. package/dist/TypeInference.js.map +1 -0
  64. package/dist/WebService.d.ts +148 -0
  65. package/dist/WebService.js +532 -0
  66. package/dist/WebService.js.map +1 -0
  67. package/dist/cli/agent-loader.d.ts +22 -0
  68. package/dist/cli/agent-loader.js +144 -0
  69. package/dist/cli/agent-loader.js.map +1 -0
  70. package/dist/cli/mock-data.d.ts +37 -0
  71. package/dist/cli/mock-data.js +80 -0
  72. package/dist/cli/mock-data.js.map +1 -0
  73. package/dist/cli/swaig-test.d.ts +32 -0
  74. package/dist/cli/swaig-test.js +418 -0
  75. package/dist/cli/swaig-test.js.map +1 -0
  76. package/dist/generateVerbTypes.d.ts +11 -0
  77. package/dist/generateVerbTypes.js +265 -0
  78. package/dist/generateVerbTypes.js.map +1 -0
  79. package/{src/index.ts → dist/index.d.ts} +13 -100
  80. package/dist/index.js +152 -0
  81. package/dist/index.js.map +1 -0
  82. package/dist/livewire/index.d.ts +653 -0
  83. package/dist/livewire/index.js +992 -0
  84. package/dist/livewire/index.js.map +1 -0
  85. package/dist/prefabs/ConciergeAgent.d.ts +89 -0
  86. package/dist/prefabs/ConciergeAgent.js +245 -0
  87. package/dist/prefabs/ConciergeAgent.js.map +1 -0
  88. package/dist/prefabs/FAQBotAgent.d.ts +113 -0
  89. package/dist/prefabs/FAQBotAgent.js +329 -0
  90. package/dist/prefabs/FAQBotAgent.js.map +1 -0
  91. package/dist/prefabs/InfoGathererAgent.d.ts +126 -0
  92. package/dist/prefabs/InfoGathererAgent.js +287 -0
  93. package/dist/prefabs/InfoGathererAgent.js.map +1 -0
  94. package/dist/prefabs/ReceptionistAgent.d.ts +104 -0
  95. package/dist/prefabs/ReceptionistAgent.js +303 -0
  96. package/dist/prefabs/ReceptionistAgent.js.map +1 -0
  97. package/dist/prefabs/SurveyAgent.d.ts +148 -0
  98. package/dist/prefabs/SurveyAgent.js +540 -0
  99. package/dist/prefabs/SurveyAgent.js.map +1 -0
  100. package/{src/prefabs/index.ts → dist/prefabs/index.d.ts} +1 -15
  101. package/dist/prefabs/index.js +14 -0
  102. package/dist/prefabs/index.js.map +1 -0
  103. package/dist/relay/Action.d.ts +258 -0
  104. package/dist/relay/Action.js +402 -0
  105. package/dist/relay/Action.js.map +1 -0
  106. package/dist/relay/Call.d.ts +697 -0
  107. package/dist/relay/Call.js +1062 -0
  108. package/dist/relay/Call.js.map +1 -0
  109. package/dist/relay/Deferred.d.ts +44 -0
  110. package/dist/relay/Deferred.js +69 -0
  111. package/dist/relay/Deferred.js.map +1 -0
  112. package/dist/relay/Message.d.ts +103 -0
  113. package/dist/relay/Message.js +169 -0
  114. package/dist/relay/Message.js.map +1 -0
  115. package/dist/relay/RelayClient.d.ts +302 -0
  116. package/dist/relay/RelayClient.js +1026 -0
  117. package/dist/relay/RelayClient.js.map +1 -0
  118. package/dist/relay/RelayError.d.ts +15 -0
  119. package/dist/relay/RelayError.js +20 -0
  120. package/dist/relay/RelayError.js.map +1 -0
  121. package/dist/relay/RelayEvent.d.ts +254 -0
  122. package/dist/relay/RelayEvent.js +509 -0
  123. package/dist/relay/RelayEvent.js.map +1 -0
  124. package/dist/relay/constants.d.ts +90 -0
  125. package/{src/relay/constants.ts → dist/relay/constants.js} +11 -29
  126. package/dist/relay/constants.js.map +1 -0
  127. package/dist/relay/index.d.ts +16 -0
  128. package/dist/relay/index.js +18 -0
  129. package/dist/relay/index.js.map +1 -0
  130. package/dist/relay/types.d.ts +142 -0
  131. package/dist/relay/types.js +5 -0
  132. package/dist/relay/types.js.map +1 -0
  133. package/dist/rest/HttpClient.d.ts +80 -0
  134. package/dist/rest/HttpClient.js +148 -0
  135. package/dist/rest/HttpClient.js.map +1 -0
  136. package/dist/rest/RestError.d.ts +30 -0
  137. package/dist/rest/RestError.js +39 -0
  138. package/dist/rest/RestError.js.map +1 -0
  139. package/dist/rest/base/BaseResource.d.ts +24 -0
  140. package/dist/rest/base/BaseResource.js +29 -0
  141. package/dist/rest/base/BaseResource.js.map +1 -0
  142. package/dist/rest/base/CrudResource.d.ts +68 -0
  143. package/dist/rest/base/CrudResource.js +82 -0
  144. package/dist/rest/base/CrudResource.js.map +1 -0
  145. package/dist/rest/base/CrudWithAddresses.d.ts +22 -0
  146. package/dist/rest/base/CrudWithAddresses.js +25 -0
  147. package/dist/rest/base/CrudWithAddresses.js.map +1 -0
  148. package/dist/rest/index.d.ts +131 -0
  149. package/{src/rest/index.ts → dist/rest/index.js} +101 -136
  150. package/dist/rest/index.js.map +1 -0
  151. package/dist/rest/namespaces/addresses.d.ts +46 -0
  152. package/dist/rest/namespaces/addresses.js +55 -0
  153. package/dist/rest/namespaces/addresses.js.map +1 -0
  154. package/dist/rest/namespaces/calling.d.ts +382 -0
  155. package/dist/rest/namespaces/calling.js +478 -0
  156. package/dist/rest/namespaces/calling.js.map +1 -0
  157. package/dist/rest/namespaces/chat.d.ts +22 -0
  158. package/dist/rest/namespaces/chat.js +26 -0
  159. package/dist/rest/namespaces/chat.js.map +1 -0
  160. package/dist/rest/namespaces/compat.d.ts +585 -0
  161. package/dist/rest/namespaces/compat.js +735 -0
  162. package/dist/rest/namespaces/compat.js.map +1 -0
  163. package/dist/rest/namespaces/datasphere.d.ts +66 -0
  164. package/dist/rest/namespaces/datasphere.js +77 -0
  165. package/dist/rest/namespaces/datasphere.js.map +1 -0
  166. package/dist/rest/namespaces/fabric.d.ts +282 -0
  167. package/dist/rest/namespaces/fabric.js +373 -0
  168. package/dist/rest/namespaces/fabric.js.map +1 -0
  169. package/dist/rest/namespaces/imported-numbers.d.ts +22 -0
  170. package/dist/rest/namespaces/imported-numbers.js +26 -0
  171. package/dist/rest/namespaces/imported-numbers.js.map +1 -0
  172. package/dist/rest/namespaces/logs.d.ts +105 -0
  173. package/dist/rest/namespaces/logs.js +133 -0
  174. package/dist/rest/namespaces/logs.js.map +1 -0
  175. package/dist/rest/namespaces/lookup.d.ts +29 -0
  176. package/dist/rest/namespaces/lookup.js +32 -0
  177. package/dist/rest/namespaces/lookup.js.map +1 -0
  178. package/dist/rest/namespaces/mfa.d.ts +46 -0
  179. package/dist/rest/namespaces/mfa.js +54 -0
  180. package/dist/rest/namespaces/mfa.js.map +1 -0
  181. package/dist/rest/namespaces/number-groups.d.ts +49 -0
  182. package/dist/rest/namespaces/number-groups.js +58 -0
  183. package/dist/rest/namespaces/number-groups.js.map +1 -0
  184. package/dist/rest/namespaces/phone-numbers.d.ts +60 -0
  185. package/dist/rest/namespaces/phone-numbers.js +67 -0
  186. package/dist/rest/namespaces/phone-numbers.js.map +1 -0
  187. package/dist/rest/namespaces/project.d.ts +46 -0
  188. package/dist/rest/namespaces/project.js +56 -0
  189. package/dist/rest/namespaces/project.js.map +1 -0
  190. package/dist/rest/namespaces/pubsub.d.ts +22 -0
  191. package/dist/rest/namespaces/pubsub.js +26 -0
  192. package/dist/rest/namespaces/pubsub.js.map +1 -0
  193. package/dist/rest/namespaces/queues.d.ts +42 -0
  194. package/dist/rest/namespaces/queues.js +49 -0
  195. package/dist/rest/namespaces/queues.js.map +1 -0
  196. package/dist/rest/namespaces/recordings.d.ts +38 -0
  197. package/dist/rest/namespaces/recordings.js +45 -0
  198. package/dist/rest/namespaces/recordings.js.map +1 -0
  199. package/dist/rest/namespaces/registry.d.ts +141 -0
  200. package/dist/rest/namespaces/registry.js +178 -0
  201. package/dist/rest/namespaces/registry.js.map +1 -0
  202. package/dist/rest/namespaces/short-codes.d.ts +39 -0
  203. package/dist/rest/namespaces/short-codes.js +46 -0
  204. package/dist/rest/namespaces/short-codes.js.map +1 -0
  205. package/dist/rest/namespaces/sip-profile.d.ts +28 -0
  206. package/dist/rest/namespaces/sip-profile.js +34 -0
  207. package/dist/rest/namespaces/sip-profile.js.map +1 -0
  208. package/dist/rest/namespaces/verified-callers.d.ts +33 -0
  209. package/dist/rest/namespaces/verified-callers.js +39 -0
  210. package/dist/rest/namespaces/verified-callers.js.map +1 -0
  211. package/dist/rest/namespaces/video.d.ts +235 -0
  212. package/dist/rest/namespaces/video.js +297 -0
  213. package/dist/rest/namespaces/video.js.map +1 -0
  214. package/{src/rest/pagination.ts → dist/rest/pagination.d.ts} +2 -61
  215. package/dist/rest/pagination.js +78 -0
  216. package/dist/rest/pagination.js.map +1 -0
  217. package/dist/rest/types.d.ts +54 -0
  218. package/dist/rest/types.js +5 -0
  219. package/dist/rest/types.js.map +1 -0
  220. package/dist/skills/SkillBase.d.ts +404 -0
  221. package/dist/skills/SkillBase.js +471 -0
  222. package/dist/skills/SkillBase.js.map +1 -0
  223. package/dist/skills/SkillManager.d.ts +195 -0
  224. package/dist/skills/SkillManager.js +378 -0
  225. package/dist/skills/SkillManager.js.map +1 -0
  226. package/dist/skills/SkillRegistry.d.ts +176 -0
  227. package/dist/skills/SkillRegistry.js +310 -0
  228. package/dist/skills/SkillRegistry.js.map +1 -0
  229. package/dist/skills/builtin/api_ninjas_trivia.d.ts +47 -0
  230. package/dist/skills/builtin/api_ninjas_trivia.js +211 -0
  231. package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -0
  232. package/dist/skills/builtin/ask_claude.d.ts +37 -0
  233. package/dist/skills/builtin/ask_claude.js +162 -0
  234. package/dist/skills/builtin/ask_claude.js.map +1 -0
  235. package/dist/skills/builtin/claude_skills.d.ts +75 -0
  236. package/dist/skills/builtin/claude_skills.js +753 -0
  237. package/dist/skills/builtin/claude_skills.js.map +1 -0
  238. package/dist/skills/builtin/custom_skills.d.ts +79 -0
  239. package/dist/skills/builtin/custom_skills.js +227 -0
  240. package/dist/skills/builtin/custom_skills.js.map +1 -0
  241. package/dist/skills/builtin/datasphere.d.ts +73 -0
  242. package/dist/skills/builtin/datasphere.js +350 -0
  243. package/dist/skills/builtin/datasphere.js.map +1 -0
  244. package/dist/skills/builtin/datasphere_serverless.d.ts +89 -0
  245. package/dist/skills/builtin/datasphere_serverless.js +291 -0
  246. package/dist/skills/builtin/datasphere_serverless.js.map +1 -0
  247. package/dist/skills/builtin/datetime.d.ts +40 -0
  248. package/dist/skills/builtin/datetime.js +118 -0
  249. package/dist/skills/builtin/datetime.js.map +1 -0
  250. package/dist/skills/builtin/google_maps.d.ts +48 -0
  251. package/dist/skills/builtin/google_maps.js +470 -0
  252. package/dist/skills/builtin/google_maps.js.map +1 -0
  253. package/dist/skills/builtin/index.d.ts +31 -0
  254. package/{src/skills/builtin/index.ts → dist/skills/builtin/index.js} +30 -36
  255. package/dist/skills/builtin/index.js.map +1 -0
  256. package/dist/skills/builtin/info_gatherer.d.ts +115 -0
  257. package/dist/skills/builtin/info_gatherer.js +328 -0
  258. package/dist/skills/builtin/info_gatherer.js.map +1 -0
  259. package/dist/skills/builtin/joke.d.ts +41 -0
  260. package/dist/skills/builtin/joke.js +156 -0
  261. package/dist/skills/builtin/joke.js.map +1 -0
  262. package/dist/skills/builtin/math.d.ts +39 -0
  263. package/dist/skills/builtin/math.js +119 -0
  264. package/dist/skills/builtin/math.js.map +1 -0
  265. package/dist/skills/builtin/mcp_gateway.d.ts +82 -0
  266. package/dist/skills/builtin/mcp_gateway.js +574 -0
  267. package/dist/skills/builtin/mcp_gateway.js.map +1 -0
  268. package/dist/skills/builtin/native_vector_search.d.ts +128 -0
  269. package/dist/skills/builtin/native_vector_search.js +752 -0
  270. package/dist/skills/builtin/native_vector_search.js.map +1 -0
  271. package/dist/skills/builtin/play_background_file.d.ts +59 -0
  272. package/dist/skills/builtin/play_background_file.js +274 -0
  273. package/dist/skills/builtin/play_background_file.js.map +1 -0
  274. package/dist/skills/builtin/spider.d.ts +91 -0
  275. package/dist/skills/builtin/spider.js +758 -0
  276. package/dist/skills/builtin/spider.js.map +1 -0
  277. package/dist/skills/builtin/swml_transfer.d.ts +66 -0
  278. package/dist/skills/builtin/swml_transfer.js +475 -0
  279. package/dist/skills/builtin/swml_transfer.js.map +1 -0
  280. package/dist/skills/builtin/weather_api.d.ts +59 -0
  281. package/dist/skills/builtin/weather_api.js +196 -0
  282. package/dist/skills/builtin/weather_api.js.map +1 -0
  283. package/dist/skills/builtin/web_search.d.ts +160 -0
  284. package/dist/skills/builtin/web_search.js +894 -0
  285. package/dist/skills/builtin/web_search.js.map +1 -0
  286. package/dist/skills/builtin/wikipedia_search.d.ts +77 -0
  287. package/dist/skills/builtin/wikipedia_search.js +241 -0
  288. package/dist/skills/builtin/wikipedia_search.js.map +1 -0
  289. package/{src/skills/index.ts → dist/skills/index.d.ts} +0 -1
  290. package/dist/skills/index.js +10 -0
  291. package/dist/skills/index.js.map +1 -0
  292. package/dist/types.d.ts +118 -0
  293. package/dist/types.js +5 -0
  294. package/dist/types.js.map +1 -0
  295. package/package.json +7 -1
  296. package/.github/workflows/publish.yml +0 -27
  297. package/.github/workflows/test.yml +0 -17
  298. package/CLAUDE.md +0 -112
  299. package/docs/MIGRATION-2.0.md +0 -81
  300. package/docs/agent-guide.md +0 -869
  301. package/docs/agent_guide.md +0 -1026
  302. package/docs/api-reference.md +0 -2420
  303. package/docs/api_reference.md +0 -1301
  304. package/docs/architecture.md +0 -843
  305. package/docs/cli-guide.md +0 -579
  306. package/docs/cli_guide.md +0 -448
  307. package/docs/cloud_functions_guide.md +0 -474
  308. package/docs/configuration.md +0 -422
  309. package/docs/contexts-guide.md +0 -787
  310. package/docs/contexts_guide.md +0 -511
  311. package/docs/datamap-guide.md +0 -1141
  312. package/docs/datamap_guide.md +0 -595
  313. package/docs/llm_parameters.md +0 -239
  314. package/docs/mcp_gateway_reference.md +0 -648
  315. package/docs/mcp_integration.md +0 -108
  316. package/docs/prefabs-guide.md +0 -800
  317. package/docs/sdk_features.md +0 -477
  318. package/docs/security.md +0 -436
  319. package/docs/serverless-guide.md +0 -513
  320. package/docs/skills-guide.md +0 -857
  321. package/docs/skills-system.md +0 -301
  322. package/docs/skills_parameter_schema.md +0 -392
  323. package/docs/skills_system.md +0 -467
  324. package/docs/swaig-reference.md +0 -1627
  325. package/docs/swaig_reference.md +0 -910
  326. package/docs/swml_service_guide.md +0 -600
  327. package/docs/third_party_skills.md +0 -533
  328. package/docs/web_service.md +0 -677
  329. package/examples/README.md +0 -131
  330. package/examples/advanced-datamap.ts +0 -100
  331. package/examples/advanced-dynamic-config.ts +0 -70
  332. package/examples/auto-vivified.ts +0 -94
  333. package/examples/call-flow.ts +0 -63
  334. package/examples/comprehensive-dynamic.ts +0 -125
  335. package/examples/contexts-steps.ts +0 -65
  336. package/examples/custom-path.ts +0 -45
  337. package/examples/datamap-tools.ts +0 -55
  338. package/examples/datasphere-multi-instance.ts +0 -63
  339. package/examples/datasphere-serverless-env.ts +0 -68
  340. package/examples/datasphere-webhook-env.ts +0 -66
  341. package/examples/datasphere.ts +0 -37
  342. package/examples/declarative.ts +0 -100
  343. package/examples/dynamic-config.ts +0 -54
  344. package/examples/dynamic-info-gatherer.ts +0 -69
  345. package/examples/dynamic-swml-service.ts +0 -67
  346. package/examples/gather-info.ts +0 -71
  347. package/examples/gather-per-question-functions-demo.ts +0 -140
  348. package/examples/joke-agent.ts +0 -34
  349. package/examples/kubernetes-agent.ts +0 -45
  350. package/examples/llm-params.ts +0 -69
  351. package/examples/mcp-agent.ts +0 -84
  352. package/examples/mcp-gateway.ts +0 -35
  353. package/examples/multi-agent.ts +0 -73
  354. package/examples/multi-endpoint.ts +0 -79
  355. package/examples/pom-prompt.ts +0 -71
  356. package/examples/prefab-concierge.ts +0 -47
  357. package/examples/prefab-faq.ts +0 -54
  358. package/examples/prefab-info-gatherer.ts +0 -33
  359. package/examples/prefab-receptionist.ts +0 -36
  360. package/examples/prefab-survey.ts +0 -68
  361. package/examples/record-call.ts +0 -67
  362. package/examples/relay-demo.ts +0 -33
  363. package/examples/room-and-sip.ts +0 -94
  364. package/examples/serverless-lambda.ts +0 -35
  365. package/examples/session-state.ts +0 -83
  366. package/examples/simple-agent.ts +0 -36
  367. package/examples/simple-static.ts +0 -29
  368. package/examples/skills-demo.ts +0 -38
  369. package/examples/step-function-inheritance-demo.ts +0 -124
  370. package/examples/swaig-features.ts +0 -187
  371. package/examples/swml-service-routing.ts +0 -66
  372. package/examples/swml-service.ts +0 -38
  373. package/examples/tap.ts +0 -68
  374. package/examples/verb-methods.ts +0 -45
  375. package/examples/web-search-multi-instance.ts +0 -72
  376. package/examples/web-search.ts +0 -38
  377. package/examples/wikipedia.ts +0 -36
  378. package/livewire/README.md +0 -140
  379. package/livewire/docs/migration-guide.md +0 -228
  380. package/livewire/examples/livewire-basic-agent.ts +0 -74
  381. package/livewire/examples/livewire-handoff.ts +0 -197
  382. package/livewire/examples/livewire-multi-tool.ts +0 -117
  383. package/relay/README.md +0 -70
  384. package/relay/RELAY_IMPLEMENTATION_GUIDE.md +0 -1257
  385. package/relay/docs/call-methods.md +0 -474
  386. package/relay/docs/client-reference.md +0 -142
  387. package/relay/docs/events.md +0 -134
  388. package/relay/docs/getting-started.md +0 -134
  389. package/relay/docs/guide.md +0 -306
  390. package/relay/docs/messaging.md +0 -182
  391. package/relay/examples/relay-inbound.ts +0 -66
  392. package/relay/examples/relay-messaging.ts +0 -71
  393. package/relay/examples/relay-outbound.ts +0 -76
  394. package/rest/README.md +0 -95
  395. package/rest/docs/calling.md +0 -273
  396. package/rest/docs/client-reference.md +0 -107
  397. package/rest/docs/compat.md +0 -204
  398. package/rest/docs/fabric.md +0 -183
  399. package/rest/docs/getting-started.md +0 -110
  400. package/rest/docs/guide.md +0 -351
  401. package/rest/docs/namespaces.md +0 -285
  402. package/rest/examples/rest-10dlc-registration.ts +0 -161
  403. package/rest/examples/rest-calling-ivr-and-ai.ts +0 -102
  404. package/rest/examples/rest-calling-play-and-record.ts +0 -91
  405. package/rest/examples/rest-client.ts +0 -65
  406. package/rest/examples/rest-compat-laml.ts +0 -210
  407. package/rest/examples/rest-datasphere-search.ts +0 -82
  408. package/rest/examples/rest-fabric-conferences-and-routing.ts +0 -144
  409. package/rest/examples/rest-fabric-subscribers-and-sip.ts +0 -108
  410. package/rest/examples/rest-fabric-swml-and-callflows.ts +0 -99
  411. package/rest/examples/rest-manage-resources.ts +0 -65
  412. package/rest/examples/rest-phone-number-management.ts +0 -197
  413. package/rest/examples/rest-queues-mfa-and-recordings.ts +0 -143
  414. package/rest/examples/rest-video-rooms.ts +0 -186
  415. package/src/AgentBase.ts +0 -2598
  416. package/src/AgentServer.ts +0 -442
  417. package/src/AuthHandler.ts +0 -256
  418. package/src/ConfigLoader.ts +0 -447
  419. package/src/ContextBuilder.ts +0 -1181
  420. package/src/DataMap.ts +0 -477
  421. package/src/FunctionResult.ts +0 -903
  422. package/src/Logger.ts +0 -337
  423. package/src/PomBuilder.ts +0 -467
  424. package/src/PromptManager.ts +0 -133
  425. package/src/SWMLHandler.ts +0 -298
  426. package/src/SWMLService.ts +0 -749
  427. package/src/SchemaUtils.ts +0 -361
  428. package/src/ServerlessAdapter.ts +0 -240
  429. package/src/SessionManager.ts +0 -311
  430. package/src/SslConfig.ts +0 -118
  431. package/src/SwaigFunction.ts +0 -276
  432. package/src/SwmlBuilder.ts +0 -283
  433. package/src/SwmlVerbMethods.generated.ts +0 -234
  434. package/src/TypeInference.ts +0 -199
  435. package/src/WebService.ts +0 -641
  436. package/src/cli/agent-loader.ts +0 -166
  437. package/src/cli/mock-data.ts +0 -111
  438. package/src/cli/swaig-test.ts +0 -452
  439. package/src/generateVerbTypes.ts +0 -322
  440. package/src/livewire/index.ts +0 -1252
  441. package/src/prefabs/ConciergeAgent.ts +0 -309
  442. package/src/prefabs/FAQBotAgent.ts +0 -415
  443. package/src/prefabs/InfoGathererAgent.ts +0 -379
  444. package/src/prefabs/ReceptionistAgent.ts +0 -395
  445. package/src/prefabs/SurveyAgent.ts +0 -671
  446. package/src/relay/Action.ts +0 -482
  447. package/src/relay/Call.ts +0 -1270
  448. package/src/relay/Deferred.ts +0 -94
  449. package/src/relay/Message.ts +0 -199
  450. package/src/relay/RelayClient.ts +0 -1185
  451. package/src/relay/RelayError.ts +0 -20
  452. package/src/relay/RelayEvent.ts +0 -944
  453. package/src/relay/index.ts +0 -123
  454. package/src/relay/types.ts +0 -149
  455. package/src/rest/HttpClient.ts +0 -164
  456. package/src/rest/RestError.ts +0 -45
  457. package/src/rest/base/BaseResource.ts +0 -32
  458. package/src/rest/base/CrudResource.ts +0 -98
  459. package/src/rest/base/CrudWithAddresses.ts +0 -37
  460. package/src/rest/namespaces/addresses.ts +0 -64
  461. package/src/rest/namespaces/calling.ts +0 -534
  462. package/src/rest/namespaces/chat.ts +0 -31
  463. package/src/rest/namespaces/compat.ts +0 -812
  464. package/src/rest/namespaces/datasphere.ts +0 -88
  465. package/src/rest/namespaces/fabric.ts +0 -417
  466. package/src/rest/namespaces/imported-numbers.ts +0 -31
  467. package/src/rest/namespaces/logs.ts +0 -151
  468. package/src/rest/namespaces/lookup.ts +0 -38
  469. package/src/rest/namespaces/mfa.ts +0 -61
  470. package/src/rest/namespaces/number-groups.ts +0 -68
  471. package/src/rest/namespaces/phone-numbers.ts +0 -76
  472. package/src/rest/namespaces/project.ts +0 -65
  473. package/src/rest/namespaces/pubsub.ts +0 -31
  474. package/src/rest/namespaces/queues.ts +0 -58
  475. package/src/rest/namespaces/recordings.ts +0 -53
  476. package/src/rest/namespaces/registry.ts +0 -200
  477. package/src/rest/namespaces/short-codes.ts +0 -54
  478. package/src/rest/namespaces/sip-profile.ts +0 -40
  479. package/src/rest/namespaces/verified-callers.ts +0 -46
  480. package/src/rest/namespaces/video.ts +0 -332
  481. package/src/rest/types.ts +0 -61
  482. package/src/skills/SkillBase.ts +0 -582
  483. package/src/skills/SkillManager.ts +0 -419
  484. package/src/skills/SkillRegistry.ts +0 -367
  485. package/src/skills/builtin/api_ninjas_trivia.ts +0 -285
  486. package/src/skills/builtin/ask_claude.ts +0 -246
  487. package/src/skills/builtin/claude_skills.ts +0 -983
  488. package/src/skills/builtin/custom_skills.ts +0 -327
  489. package/src/skills/builtin/datasphere.ts +0 -447
  490. package/src/skills/builtin/datasphere_serverless.ts +0 -347
  491. package/src/skills/builtin/datetime.ts +0 -137
  492. package/src/skills/builtin/google_maps.ts +0 -656
  493. package/src/skills/builtin/info_gatherer.ts +0 -415
  494. package/src/skills/builtin/joke.ts +0 -196
  495. package/src/skills/builtin/math.ts +0 -149
  496. package/src/skills/builtin/mcp_gateway.ts +0 -685
  497. package/src/skills/builtin/native_vector_search.ts +0 -910
  498. package/src/skills/builtin/play_background_file.ts +0 -367
  499. package/src/skills/builtin/spider.ts +0 -874
  500. package/src/skills/builtin/swml_transfer.ts +0 -645
  501. package/src/skills/builtin/weather_api.ts +0 -255
  502. package/src/skills/builtin/web_search.ts +0 -1083
  503. package/src/skills/builtin/wikipedia_search.ts +0 -304
  504. package/src/types.ts +0 -132
  505. package/tests/AgentBase.test.ts +0 -1093
  506. package/tests/AgentServer.test.ts +0 -126
  507. package/tests/AuthHandler.test.ts +0 -133
  508. package/tests/ConfigLoader.test.ts +0 -151
  509. package/tests/ContextBuilder.test.ts +0 -108
  510. package/tests/DataMap.test.ts +0 -367
  511. package/tests/EphemeralSkillCopy.test.ts +0 -107
  512. package/tests/FunctionResult.test.ts +0 -298
  513. package/tests/GracefulShutdown.test.ts +0 -46
  514. package/tests/Logger.test.ts +0 -420
  515. package/tests/PomBuilder.test.ts +0 -228
  516. package/tests/ProxyDetection.test.ts +0 -228
  517. package/tests/SWMLService.test.ts +0 -320
  518. package/tests/SWMLVerbHandler.test.ts +0 -523
  519. package/tests/SchemaUtils.test.ts +0 -106
  520. package/tests/SchemaUtils.verb.test.ts +0 -206
  521. package/tests/SecurityUtils.test.ts +0 -192
  522. package/tests/ServerlessAdapter.test.ts +0 -222
  523. package/tests/SessionManager.test.ts +0 -257
  524. package/tests/SkillBaseFeatures.test.ts +0 -130
  525. package/tests/SkillMultiInstance.test.ts +0 -102
  526. package/tests/SkillParameterSchemas.test.ts +0 -134
  527. package/tests/SkillRegistrySchema.test.ts +0 -84
  528. package/tests/SslConfig.test.ts +0 -97
  529. package/tests/SwmlBuilder.test.ts +0 -400
  530. package/tests/TypeInference.test.ts +0 -165
  531. package/tests/VerbHandlerRegistry.test.ts +0 -128
  532. package/tests/cli/mock-data.test.ts +0 -113
  533. package/tests/cli/swaig-test.test.ts +0 -108
  534. package/tests/examples.test.ts +0 -194
  535. package/tests/fixtures/scrape-parity/README.md +0 -53
  536. package/tests/fixtures/scrape-parity/expected/01_simple_article.json +0 -5
  537. package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +0 -5
  538. package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +0 -5
  539. package/tests/fixtures/scrape-parity/expected/04_bare_body.json +0 -5
  540. package/tests/fixtures/scrape-parity/expected/05_malformed.json +0 -5
  541. package/tests/fixtures/scrape-parity/expected/06_multi_class.json +0 -5
  542. package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +0 -5
  543. package/tests/fixtures/scrape-parity/expected/08_inline_script.json +0 -5
  544. package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +0 -5
  545. package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +0 -5
  546. package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +0 -5
  547. package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +0 -5
  548. package/tests/fixtures/scrape-parity/html/01_simple_article.html +0 -18
  549. package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +0 -18
  550. package/tests/fixtures/scrape-parity/html/03_nested_containers.html +0 -13
  551. package/tests/fixtures/scrape-parity/html/04_bare_body.html +0 -9
  552. package/tests/fixtures/scrape-parity/html/05_malformed.html +0 -11
  553. package/tests/fixtures/scrape-parity/html/06_multi_class.html +0 -18
  554. package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +0 -12
  555. package/tests/fixtures/scrape-parity/html/08_inline_script.html +0 -17
  556. package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +0 -21
  557. package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +0 -10
  558. package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +0 -13
  559. package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +0 -24
  560. package/tests/fixtures/scrape-parity/python_extract.py +0 -109
  561. package/tests/livewire/livewire.test.ts +0 -780
  562. package/tests/mcp.test.ts +0 -221
  563. package/tests/prefabs/prefabs.test.ts +0 -1093
  564. package/tests/relay/Action.test.ts +0 -392
  565. package/tests/relay/Call.test.ts +0 -535
  566. package/tests/relay/Deferred.test.ts +0 -71
  567. package/tests/relay/Message.test.ts +0 -164
  568. package/tests/relay/RelayClient.test.ts +0 -779
  569. package/tests/relay/RelayEvent.test.ts +0 -463
  570. package/tests/relay/helpers.ts +0 -79
  571. package/tests/rest/HttpClient.test.ts +0 -274
  572. package/tests/rest/RestError.test.ts +0 -53
  573. package/tests/rest/calling.test.ts +0 -156
  574. package/tests/rest/client.test.ts +0 -197
  575. package/tests/rest/compat.test.ts +0 -335
  576. package/tests/rest/datasphere.test.ts +0 -71
  577. package/tests/rest/fabric.test.ts +0 -186
  578. package/tests/rest/helpers.ts +0 -95
  579. package/tests/rest/logs.test.ts +0 -68
  580. package/tests/rest/pagination.test.ts +0 -133
  581. package/tests/rest/registry.test.ts +0 -94
  582. package/tests/rest/relay-rest.test.ts +0 -290
  583. package/tests/rest/video.test.ts +0 -173
  584. package/tests/setup.ts +0 -6
  585. package/tests/skills/SkillBase.test.ts +0 -108
  586. package/tests/skills/SkillManager.test.ts +0 -268
  587. package/tests/skills/SkillRegistry.test.ts +0 -176
  588. package/tests/skills/builtin.test.ts +0 -1472
  589. package/tests/skills/claude-skills.test.ts +0 -54
  590. package/tests/skills/custom-skills.test.ts +0 -53
  591. package/tests/skills/datasphere-serverless.test.ts +0 -70
  592. package/tests/skills/datasphere.test.ts +0 -107
  593. package/tests/skills/datetime.test.ts +0 -101
  594. package/tests/skills/google-maps.test.ts +0 -78
  595. package/tests/skills/info-gatherer.test.ts +0 -411
  596. package/tests/skills/joke.test.ts +0 -81
  597. package/tests/skills/math.test.ts +0 -68
  598. package/tests/skills/mcp-gateway.test.ts +0 -101
  599. package/tests/skills/play-background.test.ts +0 -54
  600. package/tests/skills/spider.test.ts +0 -108
  601. package/tests/skills/swml-transfer.test.ts +0 -178
  602. package/tests/skills/trivia.test.ts +0 -54
  603. package/tests/skills/vector-search.test.ts +0 -135
  604. package/tests/skills/weather-api.test.ts +0 -77
  605. package/tests/skills/web-search-parity.test.ts +0 -59
  606. package/tests/skills/web-search.test.ts +0 -103
  607. package/tests/skills/wikipedia.test.ts +0 -63
  608. package/tsconfig.json +0 -18
  609. package/vitest.config.ts +0 -9
  610. /package/{src → dist}/schema.json +0 -0
@@ -0,0 +1,1026 @@
1
+ /**
2
+ * RelayClient — WebSocket + JSON-RPC 2.0 protocol + event dispatch.
3
+ *
4
+ * One instance = one persistent WebSocket connection to SignalWire RELAY.
5
+ *
6
+ * Architecture:
7
+ * - JSON-RPC requests tracked by `id` in `_pending`; responses resolve deferreds
8
+ * - signalwire.event messages ACKed back to server, then dispatched to Call/Message
9
+ * - Result code checking accepts any 2xx (regex /^2\d{2}$/)
10
+ * - signalwire.connect responses skip code checking
11
+ * - Execute queue for requests while disconnected
12
+ * - Auto-reconnect with exponential backoff
13
+ */
14
+ /* eslint-disable @typescript-eslint/no-explicit-any */
15
+ import { randomUUID } from 'node:crypto';
16
+ import { getLogger } from '../Logger.js';
17
+ import { Call } from './Call.js';
18
+ import { createDeferred } from './Deferred.js';
19
+ import { AGENT_STRING, PROTOCOL_VERSION, DEFAULT_RELAY_HOST, EVENT_AUTHORIZATION_STATE, EVENT_CALL_DIAL, EVENT_CALL_RECEIVE, EVENT_CALL_STATE, EVENT_MESSAGING_RECEIVE, EVENT_MESSAGING_STATE, METHOD_SIGNALWIRE_CONNECT, METHOD_SIGNALWIRE_DISCONNECT, METHOD_SIGNALWIRE_EVENT, METHOD_SIGNALWIRE_PING, METHOD_SIGNALWIRE_RECEIVE, METHOD_SIGNALWIRE_UNRECEIVE, RECONNECT_BACKOFF_FACTOR, RECONNECT_MAX_DELAY, RECONNECT_MIN_DELAY, CLIENT_PING_INTERVAL, CLIENT_PING_MAX_FAILURES, SERVER_PING_TIMEOUT, REQUEST_TIMEOUT, EXECUTE_QUEUE_MAX, } from './constants.js';
20
+ import { Message } from './Message.js';
21
+ import { RelayError } from './RelayError.js';
22
+ // Polyfill Symbol.asyncDispose for runtimes that don't have it yet (Node <20.4)
23
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
24
+ Symbol.asyncDispose ??= Symbol.for('Symbol.asyncDispose');
25
+ const logger = getLogger('relay_client');
26
+ // Any 2xx code is considered success
27
+ const SUCCESS_CODE_RE = /^2\d{2}$/;
28
+ // Safety limits
29
+ const DEFAULT_MAX_ACTIVE_CALLS = 1000;
30
+ // Max concurrent RelayClient connections per process (env: RELAY_MAX_CONNECTIONS)
31
+ // Mirrors Python _MAX_CONNECTIONS (relay/client.py:81-88). Default 1, min 1,
32
+ // invalid env values fall back to 1.
33
+ function _parseMaxConnections() {
34
+ const raw = process.env.RELAY_MAX_CONNECTIONS;
35
+ if (raw == null || raw === '')
36
+ return 1;
37
+ const parsed = parseInt(raw, 10);
38
+ if (isNaN(parsed))
39
+ return 1;
40
+ return Math.max(1, parsed);
41
+ }
42
+ const _MAX_CONNECTIONS = _parseMaxConnections();
43
+ // Process-wide tracking of active RelayClient instances. Python uses id(self);
44
+ // TS has no such helper, so we track instance refs — identity equality is fine.
45
+ const _activeClients = new Set();
46
+ /**
47
+ * Real-time WebSocket client for SignalWire RELAY.
48
+ *
49
+ * One instance = one persistent JSON-RPC 2.0 WebSocket connection. Lets you
50
+ * place / receive calls and SMS, play/record media, run TTS, conference calls
51
+ * together, and subscribe to platform events — all without HTTP polling.
52
+ *
53
+ * Authentication supports either a project/token pair or a JWT.
54
+ *
55
+ * @example Inbound-call handler
56
+ * ```ts
57
+ * import { RelayClient } from '@signalwire/sdk';
58
+ *
59
+ * const client = new RelayClient({
60
+ * project: process.env.SIGNALWIRE_PROJECT_ID!,
61
+ * token: process.env.SIGNALWIRE_API_TOKEN!,
62
+ * host: 'example.signalwire.com',
63
+ * contexts: ['office'],
64
+ * });
65
+ *
66
+ * client.onCall(async (call) => {
67
+ * await call.answer();
68
+ * await call.playTTS({ text: 'Thanks for calling!' });
69
+ * await call.hangup();
70
+ * });
71
+ *
72
+ * await client.connect();
73
+ * ```
74
+ *
75
+ * @example Outbound dial + SMS
76
+ * ```ts
77
+ * await client.connect();
78
+ * const call = await client.dial({
79
+ * devices: [[{ type: 'phone', to: '+15551234567', from: '+15557654321' }]],
80
+ * });
81
+ * await client.sendMessage({ to: '+15551234567', from: '+15557654321', body: 'Hi!' });
82
+ * ```
83
+ *
84
+ * @see {@link Call}
85
+ * @see {@link Message}
86
+ */
87
+ export class RelayClient {
88
+ /** Project ID used for Basic Auth. */
89
+ project;
90
+ /** API token used for Basic Auth. */
91
+ token;
92
+ /** JWT used instead of project/token if provided. */
93
+ jwtToken;
94
+ /** Hostname of the RELAY endpoint (e.g. `example.signalwire.com`). */
95
+ host;
96
+ /** Contexts this client subscribes to for inbound events. */
97
+ contexts;
98
+ _ws = null;
99
+ _pending = new Map();
100
+ _pendingMethods = new Map();
101
+ _calls = new Map();
102
+ _messages = new Map();
103
+ _pendingDials = new Map();
104
+ _dialCallsByTag = new Map();
105
+ _executeQueue = [];
106
+ _onCallHandler = null;
107
+ _onMessageHandler = null;
108
+ _connected = false;
109
+ _closing = false;
110
+ _reconnectDelay = RECONNECT_MIN_DELAY;
111
+ _relayProtocol = '';
112
+ _identity = '';
113
+ _authorizationState = '';
114
+ _pingInterval = null;
115
+ _pingFailures = 0;
116
+ _serverPingTimeout = null;
117
+ _maxActiveCalls = DEFAULT_MAX_ACTIVE_CALLS;
118
+ // For run() — resolves when shutdown requested
119
+ _shutdownDeferred = null;
120
+ _signalHandlers = [];
121
+ /**
122
+ * WebSocket constructor override for testing.
123
+ * @internal
124
+ */
125
+ _wsFactory = null;
126
+ /**
127
+ * Create a new RELAY client.
128
+ * Credentials fall back to the `SIGNALWIRE_PROJECT_ID`, `SIGNALWIRE_API_TOKEN`,
129
+ * `SIGNALWIRE_JWT_TOKEN`, and `SIGNALWIRE_SPACE` env vars when omitted.
130
+ * @param options - Optional client configuration.
131
+ */
132
+ constructor(options = {}) {
133
+ this.project = options.project ?? process.env.SIGNALWIRE_PROJECT_ID ?? '';
134
+ this.token = options.token ?? process.env.SIGNALWIRE_API_TOKEN ?? '';
135
+ this.jwtToken = options.jwtToken ?? process.env.SIGNALWIRE_JWT_TOKEN ?? '';
136
+ this.host = options.host ?? process.env.SIGNALWIRE_SPACE ?? DEFAULT_RELAY_HOST;
137
+ this.contexts = options.contexts ?? [];
138
+ if (this.jwtToken) {
139
+ // JWT auth — project/token not required
140
+ }
141
+ else if (!this.project || !this.token) {
142
+ throw new Error('project and token are required (or provide jwt_token). ' +
143
+ 'Pass them directly or set SIGNALWIRE_PROJECT_ID / SIGNALWIRE_API_TOKEN env vars.');
144
+ }
145
+ // Validate host
146
+ if (/[@/?#\r\n ]/.test(this.host)) {
147
+ throw new Error(`Invalid host: ${this.host}. Must be a hostname, not a URL.`);
148
+ }
149
+ // Max concurrent calls (constructor > env var > default)
150
+ if (options.maxActiveCalls != null) {
151
+ this._maxActiveCalls = Math.max(1, options.maxActiveCalls);
152
+ }
153
+ else {
154
+ const envVal = process.env.RELAY_MAX_ACTIVE_CALLS ?? '';
155
+ const parsed = parseInt(envVal, 10);
156
+ this._maxActiveCalls = envVal && !isNaN(parsed) ? Math.max(1, parsed) : DEFAULT_MAX_ACTIVE_CALLS;
157
+ }
158
+ }
159
+ /** The protocol name the server assigned to this client after `connect()`. */
160
+ get relayProtocol() {
161
+ return this._relayProtocol;
162
+ }
163
+ /**
164
+ * Async disposable support — equivalent to Python's `__aexit__`.
165
+ *
166
+ * Enables usage with `await using`:
167
+ * ```ts
168
+ * await using client = new RelayClient({ ... });
169
+ * await client.connect();
170
+ * // ... automatically disconnects when scope exits
171
+ * ```
172
+ *
173
+ * For environments without `await using`, use try/finally:
174
+ * ```ts
175
+ * const client = new RelayClient({ ... });
176
+ * try { await client.connect(); ... }
177
+ * finally { await client.disconnect(); }
178
+ * ```
179
+ */
180
+ async [Symbol.asyncDispose]() {
181
+ await this.disconnect();
182
+ }
183
+ // ─── Handler Registration ──────────────────────────────────────
184
+ /**
185
+ * Register the inbound call handler.
186
+ *
187
+ * The handler is invoked once per inbound call, with a fully-formed
188
+ * {@link Call} already in state `"created"`. Answer, reject, or forward
189
+ * the call from inside the handler.
190
+ *
191
+ * @param handler - Callback invoked for each inbound call. May return a
192
+ * promise; errors are logged but do not tear down the client.
193
+ * @returns The same handler, to support decorator-style usage.
194
+ */
195
+ onCall(handler) {
196
+ this._onCallHandler = handler;
197
+ return handler;
198
+ }
199
+ /**
200
+ * Register the inbound message handler.
201
+ *
202
+ * The handler is invoked once per inbound SMS/MMS delivered to a subscribed
203
+ * context, with a {@link Message} already in state `"received"`.
204
+ *
205
+ * @param handler - Callback invoked for each inbound message. May return a
206
+ * promise; errors are logged but do not tear down the client.
207
+ * @returns The same handler, to support decorator-style usage.
208
+ */
209
+ onMessage(handler) {
210
+ this._onMessageHandler = handler;
211
+ return handler;
212
+ }
213
+ // ─── Connection Lifecycle ──────────────────────────────────────
214
+ /**
215
+ * Connect to RELAY and authenticate.
216
+ *
217
+ * Opens the WebSocket, runs the JSON-RPC `signalwire.connect` handshake,
218
+ * and starts the client-side ping loop. Safe to call again after a
219
+ * `disconnect()` to reconnect; the process-wide concurrent-connection limit
220
+ * is enforced here.
221
+ *
222
+ * @returns Resolves once the client is connected and authenticated.
223
+ * @throws {Error} When the process-wide connection limit is reached,
224
+ * authentication fails, or the WebSocket cannot be opened.
225
+ */
226
+ async connect() {
227
+ // Guard against connection leaks — enforce per-process limit.
228
+ // Don't count ourselves (allows reconnect without double-counting).
229
+ // Mirrors Python relay/client.py:216-228.
230
+ let otherCount = 0;
231
+ for (const c of _activeClients) {
232
+ if (c !== this)
233
+ otherCount++;
234
+ }
235
+ if (otherCount >= _MAX_CONNECTIONS) {
236
+ throw new Error(`RelayClient connection limit reached (${_MAX_CONNECTIONS}). ` +
237
+ `There are already ${otherCount} active connection(s) in this process. ` +
238
+ `Call disconnect() on existing clients first, or set ` +
239
+ `RELAY_MAX_CONNECTIONS env var to allow more.`);
240
+ }
241
+ _activeClients.add(this);
242
+ const uri = `wss://${this.host}`;
243
+ logger.info(`Connecting to ${uri}`);
244
+ const ws = this._wsFactory
245
+ ? this._wsFactory(uri)
246
+ : await this._createWebSocket(uri);
247
+ this._ws = ws;
248
+ this._connected = true;
249
+ this._reconnectDelay = RECONNECT_MIN_DELAY;
250
+ // Set up message handling
251
+ this._setupWsListeners(ws);
252
+ // Authenticate
253
+ await this._authenticate();
254
+ // Start client ping loop
255
+ this._pingFailures = 0;
256
+ this._startPingLoop();
257
+ // Flush queued requests
258
+ this._flushExecuteQueue();
259
+ logger.info('Connected and authenticated to RELAY');
260
+ }
261
+ /** Create a real WebSocket (uses dynamic import for ws). */
262
+ async _createWebSocket(uri) {
263
+ // eslint-disable-next-line @typescript-eslint/no-var-requires
264
+ const wsModule = await import('ws');
265
+ const WS = wsModule.default ?? wsModule;
266
+ const ws = new WS(uri, { maxPayload: 10 * 1024 * 1024 });
267
+ // Wait for the socket to finish the handshake before the caller tries to
268
+ // send signalwire.connect — otherwise send() throws "readyState 0".
269
+ await new Promise((resolve, reject) => {
270
+ ws.on('open', resolve);
271
+ ws.on('error', reject);
272
+ });
273
+ return ws;
274
+ }
275
+ _setupWsListeners(ws) {
276
+ ws.on('message', (data) => {
277
+ const raw = typeof data === 'string' ? data : data.toString();
278
+ let msg;
279
+ try {
280
+ msg = JSON.parse(raw);
281
+ }
282
+ catch {
283
+ logger.warn(`Invalid JSON received: ${raw}`);
284
+ return;
285
+ }
286
+ logger.debug(`<< ${raw}`);
287
+ this._handleMessage(msg).catch((err) => {
288
+ logger.error(`Error handling message: ${err}`);
289
+ });
290
+ });
291
+ ws.on('close', () => {
292
+ logger.info('WebSocket connection closed');
293
+ this._connected = false;
294
+ this._stopPingLoop();
295
+ this._cancelServerPingTimeout();
296
+ });
297
+ ws.on('error', (err) => {
298
+ logger.error(`WebSocket error: ${err}`);
299
+ });
300
+ // Server ping (if ws supports it)
301
+ ws.on('ping', () => {
302
+ this._resetServerPingTimeout();
303
+ });
304
+ }
305
+ /** Send signalwire.connect and wait for the response. */
306
+ async _authenticate() {
307
+ let authentication;
308
+ if (this.jwtToken) {
309
+ authentication = { jwt_token: this.jwtToken };
310
+ }
311
+ else {
312
+ authentication = { project: this.project, token: this.token };
313
+ }
314
+ const params = {
315
+ version: PROTOCOL_VERSION,
316
+ agent: AGENT_STRING,
317
+ event_acks: true,
318
+ authentication,
319
+ };
320
+ if (this.contexts.length > 0) {
321
+ params.contexts = this.contexts;
322
+ }
323
+ if (this._relayProtocol) {
324
+ params.protocol = this._relayProtocol;
325
+ }
326
+ if (this._authorizationState) {
327
+ params.authorization_state = this._authorizationState;
328
+ }
329
+ const result = await this._sendRequest(METHOD_SIGNALWIRE_CONNECT, params);
330
+ this._relayProtocol = result.protocol ?? this._relayProtocol;
331
+ this._identity = result.identity ?? this._identity;
332
+ logger.debug(`Auth response: protocol=${this._relayProtocol} identity=${this._identity}`);
333
+ }
334
+ /**
335
+ * Cleanly close the connection.
336
+ *
337
+ * Stops the ping loop, drops the WebSocket, rejects every pending request
338
+ * and dial with a `Connection closed` {@link RelayError}, and removes the
339
+ * client from the process-wide active set. Safe to call repeatedly.
340
+ *
341
+ * @returns Resolves once all resources have been released.
342
+ */
343
+ async disconnect() {
344
+ this._closing = true;
345
+ this._connected = false;
346
+ // Mirrors Python relay/client.py:290 — remove from per-process active set.
347
+ // Safe to call even if we never connected (Set.delete is idempotent).
348
+ _activeClients.delete(this);
349
+ this._stopPingLoop();
350
+ this._cancelServerPingTimeout();
351
+ if (this._ws) {
352
+ this._ws.removeAllListeners();
353
+ this._ws.close();
354
+ this._ws = null;
355
+ }
356
+ // Reject all pending
357
+ this._clearPendingRequests();
358
+ // Cancel queued requests
359
+ for (const { deferred } of this._executeQueue) {
360
+ if (!deferred.settled) {
361
+ deferred.reject(new RelayError(-1, 'Connection closed'));
362
+ deferred.promise.catch(() => { });
363
+ }
364
+ }
365
+ this._executeQueue = [];
366
+ // Cancel pending dials
367
+ for (const deferred of Array.from(this._pendingDials.values())) {
368
+ if (!deferred.settled) {
369
+ deferred.reject(new RelayError(-1, 'Connection closed during dial'));
370
+ deferred.promise.catch(() => { });
371
+ }
372
+ }
373
+ this._pendingDials.clear();
374
+ this._dialCallsByTag.clear();
375
+ logger.info('Disconnected from RELAY');
376
+ }
377
+ // ─── Public RPC Interface ──────────────────────────────────────
378
+ /**
379
+ * Send a JSON-RPC request and await the response.
380
+ *
381
+ * This is the low-level escape hatch for calling RELAY methods that don't
382
+ * yet have a higher-level helper on this class. Queued if the client is
383
+ * currently disconnected; sent immediately otherwise.
384
+ *
385
+ * @param method - Fully-qualified JSON-RPC method name (e.g. `"calling.play"`).
386
+ * @param params - Method-specific params object.
387
+ * @returns The `result` field of the JSON-RPC response.
388
+ * @throws {RelayError} When the server returns a non-2xx code.
389
+ */
390
+ async execute(method, params) {
391
+ return this._sendRequest(method, params);
392
+ }
393
+ /**
394
+ * Initiate an outbound call.
395
+ *
396
+ * Accepts a "dial plan" — an outer array of serial groups, each containing
397
+ * an inner array of devices dialled in parallel. Resolves when any device
398
+ * answers; rejects if no device answers within `dialTimeout`.
399
+ *
400
+ * @param devices - Serial/parallel dial plan. `[[A], [B, C]]` dials A first,
401
+ * then B and C in parallel.
402
+ * @param options - Optional dial behaviour overrides.
403
+ * @param options.tag - Client-provided tag for event correlation.
404
+ * Auto-generated (UUID) when omitted.
405
+ * @param options.maxDuration - Maximum call duration in minutes.
406
+ * @param options.dialTimeout - Seconds to wait for the dial to complete.
407
+ * Defaults to `120`.
408
+ * @returns A {@link Call} representing the answered leg.
409
+ * @throws {Error} When the dial times out.
410
+ * @throws {RelayError} When the server rejects the dial request.
411
+ */
412
+ async dial(devices, options = {}) {
413
+ const dialTag = options.tag ?? randomUUID();
414
+ const params = {
415
+ tag: dialTag,
416
+ devices,
417
+ };
418
+ if (options.maxDuration != null)
419
+ params.max_duration = options.maxDuration;
420
+ // Register a deferred that _handleEvent will resolve
421
+ const dialDeferred = createDeferred();
422
+ this._pendingDials.set(dialTag, dialDeferred);
423
+ this._dialCallsByTag.set(dialTag, []);
424
+ try {
425
+ await this.execute('calling.dial', params);
426
+ const timeoutSec = options.dialTimeout ?? 120;
427
+ const timeoutMs = timeoutSec * 1000;
428
+ const call = await new Promise((resolve, reject) => {
429
+ const timer = setTimeout(() => {
430
+ reject(new RelayError(-1, `Dial timed out waiting for answer (tag=${dialTag})`));
431
+ }, timeoutMs);
432
+ dialDeferred.promise.then((v) => { clearTimeout(timer); resolve(v); }, (e) => { clearTimeout(timer); reject(e); });
433
+ });
434
+ return call;
435
+ }
436
+ catch (err) {
437
+ if (!dialDeferred.settled) {
438
+ dialDeferred.reject(err);
439
+ dialDeferred.promise.catch(() => { });
440
+ }
441
+ throw err;
442
+ }
443
+ finally {
444
+ this._pendingDials.delete(dialTag);
445
+ this._dialCallsByTag.delete(dialTag);
446
+ }
447
+ }
448
+ /**
449
+ * Send an outbound SMS / MMS message.
450
+ *
451
+ * The method returns as soon as the server has accepted the send; track the
452
+ * message's terminal state with {@link Message.wait} or the `onCompleted`
453
+ * callback.
454
+ *
455
+ * @param options - Send parameters.
456
+ * @param options.toNumber - Destination phone number in E.164 format.
457
+ * @param options.fromNumber - Sender phone number in E.164 format.
458
+ * @param options.context - Context for receiving state events. Defaults to
459
+ * the negotiated relay protocol.
460
+ * @param options.body - Text body of the message.
461
+ * @param options.media - List of media URLs for MMS.
462
+ * @param options.tags - Tags attached to the message for correlation.
463
+ * @param options.region - Origination region override.
464
+ * @param options.onCompleted - Optional callback fired when the message
465
+ * reaches a terminal state (delivered / failed / undelivered).
466
+ * @returns A {@link Message} tracking the outbound send.
467
+ * @throws {RelayError} When the server rejects the send request.
468
+ */
469
+ async sendMessage(options) {
470
+ if (!options.body && (!options.media || options.media.length === 0)) {
471
+ throw new Error('At least one of body or media is required');
472
+ }
473
+ const msgContext = options.context ?? this._relayProtocol ?? 'default';
474
+ const params = {
475
+ context: msgContext,
476
+ to_number: options.toNumber,
477
+ from_number: options.fromNumber,
478
+ };
479
+ if (options.body)
480
+ params.body = options.body;
481
+ if (options.media)
482
+ params.media = options.media;
483
+ if (options.tags)
484
+ params.tags = options.tags;
485
+ if (options.region)
486
+ params.region = options.region;
487
+ const result = await this.execute('messaging.send', params);
488
+ const messageId = result.message_id ?? '';
489
+ const message = new Message({
490
+ messageId,
491
+ context: msgContext,
492
+ direction: 'outbound',
493
+ fromNumber: options.fromNumber,
494
+ toNumber: options.toNumber,
495
+ body: options.body ?? '',
496
+ media: options.media ?? [],
497
+ tags: options.tags ?? [],
498
+ state: 'queued',
499
+ });
500
+ if (options.onCompleted) {
501
+ message._onCompleted = options.onCompleted;
502
+ }
503
+ if (messageId) {
504
+ this._messages.set(messageId, message);
505
+ }
506
+ return message;
507
+ }
508
+ /**
509
+ * Subscribe to additional RELAY contexts on an already-connected client.
510
+ *
511
+ * Inbound calls and messages on any of the listed contexts will be delivered
512
+ * to the `onCall` / `onMessage` handlers. A no-op when `contexts` is empty.
513
+ *
514
+ * @param contexts - Context names to subscribe to.
515
+ * @returns Resolves once the server has confirmed the subscription.
516
+ * @throws {RelayError} When the server rejects the subscribe request.
517
+ */
518
+ async receive(contexts) {
519
+ if (!contexts.length)
520
+ return;
521
+ await this._sendRequest(METHOD_SIGNALWIRE_RECEIVE, { contexts });
522
+ logger.info(`Subscribed to contexts: ${contexts}`);
523
+ }
524
+ /**
525
+ * Unsubscribe from contexts previously passed to {@link receive} (or the
526
+ * constructor). A no-op when `contexts` is empty.
527
+ *
528
+ * @param contexts - Context names to unsubscribe from.
529
+ * @returns Resolves once the server has confirmed the unsubscribe.
530
+ * @throws {RelayError} When the server rejects the unsubscribe request.
531
+ */
532
+ async unreceive(contexts) {
533
+ if (!contexts.length)
534
+ return;
535
+ await this._sendRequest(METHOD_SIGNALWIRE_UNRECEIVE, { contexts });
536
+ logger.info(`Unsubscribed from contexts: ${contexts}`);
537
+ }
538
+ // ─── Run (auto-reconnect loop) ────────────────────────────────
539
+ /**
540
+ * Blocking entry point — connects and maintains the connection with
541
+ * auto-reconnect, returning only after a clean shutdown (Ctrl+C, SIGTERM,
542
+ * or {@link disconnect} from another scope).
543
+ *
544
+ * Installs `SIGINT` / `SIGTERM` handlers, so typically only one `RelayClient`
545
+ * per process should call `run()`.
546
+ *
547
+ * @returns Resolves once a shutdown has been requested and cleanup completes.
548
+ * @throws {Error} Only on unrecoverable startup failures — normal
549
+ * disconnects are handled internally by the reconnect loop.
550
+ */
551
+ async run() {
552
+ this._closing = false;
553
+ this._shutdownDeferred = createDeferred();
554
+ // Handle SIGINT/SIGTERM
555
+ const shutdown = () => {
556
+ logger.info('Shutting down ...');
557
+ this._closing = true;
558
+ if (this._ws) {
559
+ this._ws.close();
560
+ }
561
+ this._shutdownDeferred?.resolve();
562
+ };
563
+ process.on('SIGINT', shutdown);
564
+ process.on('SIGTERM', shutdown);
565
+ this._signalHandlers = [
566
+ () => process.removeListener('SIGINT', shutdown),
567
+ () => process.removeListener('SIGTERM', shutdown),
568
+ ];
569
+ try {
570
+ while (!this._closing) {
571
+ try {
572
+ await this.connect();
573
+ // Block until connection closes
574
+ await new Promise((resolve) => {
575
+ if (!this._ws) {
576
+ resolve();
577
+ return;
578
+ }
579
+ this._ws.on('close', () => resolve());
580
+ });
581
+ }
582
+ catch (err) {
583
+ if (this._closing)
584
+ break;
585
+ logger.error(`Connection error: ${err}`);
586
+ }
587
+ if (this._closing)
588
+ break;
589
+ this._stopPingLoop();
590
+ this._cancelServerPingTimeout();
591
+ this._clearPendingRequests();
592
+ // Auto-reconnect with exponential backoff
593
+ logger.info(`Reconnecting in ${this._reconnectDelay.toFixed(1)}s ...`);
594
+ await new Promise((resolve) => {
595
+ const timer = setTimeout(resolve, this._reconnectDelay * 1000);
596
+ // If shutdown requested during wait, resolve immediately
597
+ this._shutdownDeferred?.promise.then(() => {
598
+ clearTimeout(timer);
599
+ resolve();
600
+ });
601
+ });
602
+ if (this._closing)
603
+ break;
604
+ this._reconnectDelay = Math.min(this._reconnectDelay * RECONNECT_BACKOFF_FACTOR, RECONNECT_MAX_DELAY);
605
+ }
606
+ }
607
+ finally {
608
+ await this.disconnect();
609
+ // Cleanup signal handlers
610
+ for (const cleanup of this._signalHandlers)
611
+ cleanup();
612
+ this._signalHandlers = [];
613
+ logger.info('RELAY client stopped');
614
+ }
615
+ }
616
+ // ─── Internal: Send / Receive ──────────────────────────────────
617
+ async _sendRequest(method, params) {
618
+ const reqId = randomUUID();
619
+ const message = {
620
+ jsonrpc: '2.0',
621
+ id: reqId,
622
+ method,
623
+ params,
624
+ };
625
+ const deferred = createDeferred();
626
+ this._pending.set(reqId, deferred);
627
+ this._pendingMethods.set(reqId, method);
628
+ try {
629
+ if (!this._ws || !this._connected) {
630
+ if (this._executeQueue.length >= EXECUTE_QUEUE_MAX) {
631
+ throw new RelayError(-1, 'Execute queue full — too many requests while disconnected');
632
+ }
633
+ this._executeQueue.push({ message, deferred });
634
+ logger.debug(`Request queued (not connected): ${method}`);
635
+ }
636
+ else {
637
+ const raw = JSON.stringify(message);
638
+ logger.debug(`>> ${method} id=${reqId}`);
639
+ this._ws.send(raw);
640
+ }
641
+ // Timeout
642
+ return await new Promise((resolve, reject) => {
643
+ const timer = setTimeout(() => {
644
+ reject(new RelayError(-1, `Request timeout for ${method}`));
645
+ if (method !== METHOD_SIGNALWIRE_CONNECT) {
646
+ this._forceClose();
647
+ }
648
+ }, REQUEST_TIMEOUT);
649
+ deferred.promise.then((v) => { clearTimeout(timer); resolve(v); }, (e) => { clearTimeout(timer); reject(e); });
650
+ });
651
+ }
652
+ finally {
653
+ this._pending.delete(reqId);
654
+ this._pendingMethods.delete(reqId);
655
+ }
656
+ }
657
+ _flushExecuteQueue() {
658
+ if (!this._executeQueue.length || !this._ws)
659
+ return;
660
+ const queued = [...this._executeQueue];
661
+ this._executeQueue = [];
662
+ logger.debug(`Flushing ${queued.length} queued requests`);
663
+ for (const { message, deferred } of queued) {
664
+ if (deferred.settled)
665
+ continue;
666
+ const raw = JSON.stringify(message);
667
+ logger.debug(`>> (queued) ${message.method ?? '?'} id=${message.id ?? '?'}`);
668
+ try {
669
+ this._ws.send(raw);
670
+ }
671
+ catch (err) {
672
+ if (!deferred.settled) {
673
+ deferred.reject(new RelayError(-1, `Failed to send queued request: ${err}`));
674
+ deferred.promise.catch(() => { });
675
+ }
676
+ }
677
+ }
678
+ }
679
+ _clearPendingRequests() {
680
+ for (const deferred of Array.from(this._pending.values())) {
681
+ if (!deferred.settled) {
682
+ deferred.reject(new RelayError(-1, 'Connection closed'));
683
+ deferred.promise.catch(() => { });
684
+ }
685
+ }
686
+ this._pending.clear();
687
+ this._pendingMethods.clear();
688
+ for (const deferred of Array.from(this._pendingDials.values())) {
689
+ if (!deferred.settled) {
690
+ deferred.reject(new RelayError(-1, 'Connection closed during dial'));
691
+ deferred.promise.catch(() => { });
692
+ }
693
+ }
694
+ this._pendingDials.clear();
695
+ this._dialCallsByTag.clear();
696
+ }
697
+ // ─── Message Handling ──────────────────────────────────────────
698
+ async _handleMessage(msg) {
699
+ if (typeof msg !== 'object' || msg === null) {
700
+ logger.warn('Ignoring non-object message');
701
+ return;
702
+ }
703
+ // JSON-RPC error response
704
+ if ('id' in msg && 'error' in msg) {
705
+ const reqId = msg.id;
706
+ const deferred = this._pending.get(reqId);
707
+ if (deferred && !deferred.settled) {
708
+ const error = typeof msg.error === 'object' ? msg.error : { code: -1, message: String(msg.error) };
709
+ deferred.reject(new RelayError(error.code ?? -1, String(error.message ?? 'Unknown error')));
710
+ }
711
+ return;
712
+ }
713
+ // JSON-RPC success response
714
+ if ('id' in msg && 'result' in msg) {
715
+ const reqId = msg.id;
716
+ const deferred = this._pending.get(reqId);
717
+ if (deferred && !deferred.settled) {
718
+ const result = msg.result;
719
+ if (typeof result !== 'object' || result === null) {
720
+ deferred.resolve({ raw: result });
721
+ return;
722
+ }
723
+ const requestMethod = this._pendingMethods.get(reqId) ?? '';
724
+ if (requestMethod === METHOD_SIGNALWIRE_CONNECT) {
725
+ deferred.resolve(result);
726
+ }
727
+ else {
728
+ const code = result.code;
729
+ const codeStr = code != null ? String(code) : null;
730
+ if (codeStr != null && !SUCCESS_CODE_RE.test(codeStr)) {
731
+ let intCode;
732
+ try {
733
+ intCode = parseInt(codeStr, 10);
734
+ }
735
+ catch {
736
+ intCode = -1;
737
+ }
738
+ if (isNaN(intCode))
739
+ intCode = -1;
740
+ deferred.reject(new RelayError(intCode, String(result.message ?? 'Unknown error')));
741
+ }
742
+ else {
743
+ deferred.resolve(result);
744
+ }
745
+ }
746
+ }
747
+ return;
748
+ }
749
+ // Server-initiated method call
750
+ const method = (msg.method ?? '');
751
+ const params = (msg.params ?? {});
752
+ if (typeof params !== 'object') {
753
+ logger.warn('Ignoring message with non-object params');
754
+ return;
755
+ }
756
+ if (method === METHOD_SIGNALWIRE_EVENT) {
757
+ if ('id' in msg) {
758
+ this._sendEventAck(msg.id);
759
+ }
760
+ await this._handleEvent(params);
761
+ }
762
+ else if (method === METHOD_SIGNALWIRE_PING) {
763
+ this._resetServerPingTimeout();
764
+ if ('id' in msg) {
765
+ this._sendPong(msg.id);
766
+ }
767
+ }
768
+ else if (method === METHOD_SIGNALWIRE_DISCONNECT) {
769
+ const restart = params.restart ?? false;
770
+ logger.info(`Received signalwire.disconnect from server (restart=${restart})`);
771
+ if ('id' in msg) {
772
+ this._sendEventAck(msg.id);
773
+ }
774
+ if (restart) {
775
+ this._relayProtocol = '';
776
+ this._authorizationState = '';
777
+ }
778
+ }
779
+ }
780
+ // ─── Event Dispatch ────────────────────────────────────────────
781
+ async _handleEvent(payload) {
782
+ const eventType = (payload.event_type ?? '');
783
+ const eventParams = (payload.params ?? {});
784
+ const callId = (eventParams.call_id ?? '');
785
+ if (!eventType) {
786
+ logger.warn(`Received event with empty event_type: ${JSON.stringify(payload)}`);
787
+ return;
788
+ }
789
+ logger.debug(`Event: ${eventType} call_id=${callId}`);
790
+ // Authorization state update
791
+ if (eventType === EVENT_AUTHORIZATION_STATE) {
792
+ const authState = (eventParams.authorization_state ?? '');
793
+ if (authState) {
794
+ this._authorizationState = authState;
795
+ logger.debug('Updated authorization_state for reconnection');
796
+ }
797
+ return;
798
+ }
799
+ // Inbound message
800
+ if (eventType === EVENT_MESSAGING_RECEIVE) {
801
+ this._handleInboundMessage(payload);
802
+ return;
803
+ }
804
+ // Outbound message state change
805
+ if (eventType === EVENT_MESSAGING_STATE) {
806
+ this._handleMessageState(payload);
807
+ return;
808
+ }
809
+ // Inbound call
810
+ if (eventType === EVENT_CALL_RECEIVE) {
811
+ this._handleInboundCall(payload);
812
+ return;
813
+ }
814
+ // Outbound dial progress
815
+ if (eventType === EVENT_CALL_DIAL) {
816
+ await this._handleDialEvent(payload);
817
+ return;
818
+ }
819
+ // State events during pending dial
820
+ if (eventType === EVENT_CALL_STATE) {
821
+ const tag = (eventParams.tag ?? '');
822
+ if (tag && this._pendingDials.has(tag) && callId) {
823
+ if (!this._calls.has(callId)) {
824
+ this._registerDialLeg(tag, eventParams);
825
+ }
826
+ // Fall through to normal routing
827
+ }
828
+ }
829
+ // Route to existing Call by call_id
830
+ if (callId) {
831
+ const call = this._calls.get(callId);
832
+ if (call) {
833
+ await call._dispatchEvent(payload);
834
+ if (call.state === 'ended') {
835
+ this._calls.delete(callId);
836
+ }
837
+ }
838
+ }
839
+ }
840
+ _handleInboundCall(payload) {
841
+ if (this._calls.size >= this._maxActiveCalls) {
842
+ logger.error(`Max active calls (${this._maxActiveCalls}) reached, dropping inbound call`);
843
+ return;
844
+ }
845
+ const params = (payload.params ?? {});
846
+ const callId = (params.call_id ?? '');
847
+ const call = new Call(this, callId, params.node_id ?? '', params.project_id ?? this.project, this._relayProtocol || params.context || params.protocol || '', {
848
+ tag: params.tag ?? '',
849
+ direction: params.direction ?? 'inbound',
850
+ device: params.device,
851
+ state: params.call_state ?? 'created',
852
+ segmentId: params.segment_id ?? '',
853
+ });
854
+ this._calls.set(callId, call);
855
+ if (this._onCallHandler) {
856
+ Promise.resolve(this._onCallHandler(call)).catch((err) => {
857
+ logger.error(`Error in on_call handler for ${callId}: ${err}`);
858
+ });
859
+ }
860
+ else {
861
+ logger.warn(`Inbound call ${callId} but no on_call handler registered`);
862
+ }
863
+ }
864
+ _handleInboundMessage(payload) {
865
+ const params = (payload.params ?? {});
866
+ const message = new Message({
867
+ messageId: params.message_id ?? '',
868
+ context: params.context ?? '',
869
+ direction: params.direction ?? 'inbound',
870
+ fromNumber: params.from_number ?? '',
871
+ toNumber: params.to_number ?? '',
872
+ body: params.body ?? '',
873
+ media: params.media ?? [],
874
+ segments: params.segments ?? 0,
875
+ state: params.message_state ?? 'received',
876
+ tags: params.tags ?? [],
877
+ });
878
+ if (this._onMessageHandler) {
879
+ Promise.resolve(this._onMessageHandler(message)).catch((err) => {
880
+ logger.error(`Error in on_message handler for ${message.messageId}: ${err}`);
881
+ });
882
+ }
883
+ else {
884
+ logger.warn(`Inbound message ${message.messageId} but no on_message handler registered`);
885
+ }
886
+ }
887
+ _handleMessageState(payload) {
888
+ const params = (payload.params ?? {});
889
+ const messageId = (params.message_id ?? '');
890
+ const message = this._messages.get(messageId);
891
+ if (message) {
892
+ message._dispatchEvent(payload).catch((err) => {
893
+ logger.error(`Error dispatching message state for ${messageId}: ${err}`);
894
+ });
895
+ if (message.isDone) {
896
+ this._messages.delete(messageId);
897
+ }
898
+ }
899
+ else {
900
+ logger.debug(`State event for unknown message ${messageId}`);
901
+ }
902
+ }
903
+ _registerDialLeg(tag, eventParams) {
904
+ const callId = (eventParams.call_id ?? '');
905
+ const nodeId = (eventParams.node_id ?? '');
906
+ const call = new Call(this, callId, nodeId, eventParams.project_id ?? this.project, this._relayProtocol, {
907
+ tag,
908
+ direction: 'outbound',
909
+ device: eventParams.device,
910
+ state: eventParams.call_state ?? 'created',
911
+ });
912
+ this._calls.set(callId, call);
913
+ const legs = this._dialCallsByTag.get(tag) ?? [];
914
+ legs.push(call);
915
+ this._dialCallsByTag.set(tag, legs);
916
+ logger.debug(`Registered dial leg: call_id=${callId} tag=${tag}`);
917
+ return call;
918
+ }
919
+ async _handleDialEvent(payload) {
920
+ const eventParams = (payload.params ?? {});
921
+ const tag = (eventParams.tag ?? '');
922
+ const dialState = (eventParams.dial_state ?? '');
923
+ const callInfo = (eventParams.call ?? {});
924
+ logger.debug(`Dial event: tag=${tag} state=${dialState}`);
925
+ const dialDeferred = this._pendingDials.get(tag);
926
+ if (!dialDeferred || dialDeferred.settled) {
927
+ // Stale or progress event after resolution — dispatch to call if exists
928
+ if (callInfo) {
929
+ const cid = (callInfo.call_id ?? '');
930
+ const call = this._calls.get(cid);
931
+ if (call) {
932
+ await call._dispatchEvent(payload);
933
+ }
934
+ }
935
+ return;
936
+ }
937
+ if (dialState === 'answered') {
938
+ const winnerCallId = (callInfo.call_id ?? '');
939
+ const winnerNodeId = (callInfo.node_id ?? '');
940
+ let call = this._calls.get(winnerCallId);
941
+ if (!call) {
942
+ call = new Call(this, winnerCallId, winnerNodeId, this.project, this._relayProtocol, {
943
+ tag,
944
+ direction: 'outbound',
945
+ device: callInfo.device,
946
+ state: 'answered',
947
+ });
948
+ this._calls.set(winnerCallId, call);
949
+ }
950
+ else {
951
+ if (winnerNodeId && !call.nodeId) {
952
+ call.nodeId = winnerNodeId;
953
+ }
954
+ }
955
+ dialDeferred.resolve(call);
956
+ }
957
+ else if (dialState === 'failed') {
958
+ dialDeferred.reject(new RelayError(-1, `Dial failed (tag=${tag})`));
959
+ dialDeferred.promise.catch(() => { });
960
+ }
961
+ // "dialing" events are progress — don't resolve
962
+ }
963
+ // ─── Pong / ACK ───────────────────────────────────────────────
964
+ _sendPong(reqId) {
965
+ if (!this._ws)
966
+ return;
967
+ const msg = JSON.stringify({ jsonrpc: '2.0', id: reqId, result: {} });
968
+ this._ws.send(msg);
969
+ }
970
+ _sendEventAck(reqId) {
971
+ if (!this._ws)
972
+ return;
973
+ const msg = JSON.stringify({ jsonrpc: '2.0', id: reqId, result: {} });
974
+ this._ws.send(msg);
975
+ }
976
+ // ─── Client Ping Loop ─────────────────────────────────────────
977
+ _startPingLoop() {
978
+ this._stopPingLoop();
979
+ this._pingInterval = setInterval(async () => {
980
+ if (!this._connected || !this._ws)
981
+ return;
982
+ try {
983
+ await this._sendRequest(METHOD_SIGNALWIRE_PING, {});
984
+ this._pingFailures = 0;
985
+ }
986
+ catch {
987
+ this._pingFailures++;
988
+ const backoff = Math.min(RECONNECT_MIN_DELAY * (RECONNECT_BACKOFF_FACTOR ** this._pingFailures), RECONNECT_MAX_DELAY);
989
+ logger.warn(`Client ping failed (${this._pingFailures}/${CLIENT_PING_MAX_FAILURES}), backoff ${backoff.toFixed(1)}s`);
990
+ if (this._pingFailures >= CLIENT_PING_MAX_FAILURES) {
991
+ logger.error('Max ping failures reached, forcing reconnect');
992
+ this._forceClose();
993
+ }
994
+ }
995
+ }, CLIENT_PING_INTERVAL);
996
+ }
997
+ _stopPingLoop() {
998
+ if (this._pingInterval) {
999
+ clearInterval(this._pingInterval);
1000
+ this._pingInterval = null;
1001
+ }
1002
+ }
1003
+ // ─── Server Ping Watchdog ─────────────────────────────────────
1004
+ _resetServerPingTimeout() {
1005
+ this._pingFailures = 0;
1006
+ this._cancelServerPingTimeout();
1007
+ this._serverPingTimeout = setTimeout(() => {
1008
+ logger.debug(`No server ping received in ${SERVER_PING_TIMEOUT}ms, client pings will probe`);
1009
+ }, SERVER_PING_TIMEOUT);
1010
+ }
1011
+ _cancelServerPingTimeout() {
1012
+ if (this._serverPingTimeout) {
1013
+ clearTimeout(this._serverPingTimeout);
1014
+ this._serverPingTimeout = null;
1015
+ }
1016
+ }
1017
+ _forceClose() {
1018
+ this._stopPingLoop();
1019
+ this._cancelServerPingTimeout();
1020
+ this._connected = false;
1021
+ if (this._ws) {
1022
+ this._ws.close();
1023
+ }
1024
+ }
1025
+ }
1026
+ //# sourceMappingURL=RelayClient.js.map