@signalwire/sdk 2.0.0 → 2.0.2

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