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