@signalwire/sdk 2.0.4 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (656) hide show
  1. package/CHANGELOG.md +785 -0
  2. package/LICENSE +21 -0
  3. package/README.md +163 -68
  4. package/dist/AGENTS.md +13 -0
  5. package/dist/AgentBase.d.ts +550 -163
  6. package/dist/AgentBase.js +1640 -514
  7. package/dist/AgentBase.js.map +1 -1
  8. package/dist/AgentServer.d.ts +21 -0
  9. package/dist/AgentServer.js +154 -47
  10. package/dist/AgentServer.js.map +1 -1
  11. package/dist/AuthHandler.d.ts +14 -2
  12. package/dist/AuthHandler.js +7 -2
  13. package/dist/AuthHandler.js.map +1 -1
  14. package/dist/ConfigLoader.d.ts +5 -13
  15. package/dist/ConfigLoader.js +15 -29
  16. package/dist/ConfigLoader.js.map +1 -1
  17. package/dist/ContextBuilder.d.ts +202 -9
  18. package/dist/ContextBuilder.js +219 -36
  19. package/dist/ContextBuilder.js.map +1 -1
  20. package/dist/DataMap.d.ts +158 -45
  21. package/dist/DataMap.js +167 -52
  22. package/dist/DataMap.js.map +1 -1
  23. package/dist/FunctionResult.d.ts +277 -83
  24. package/dist/FunctionResult.js +444 -116
  25. package/dist/FunctionResult.js.map +1 -1
  26. package/dist/Logger.d.ts +30 -5
  27. package/dist/Logger.js +77 -19
  28. package/dist/Logger.js.map +1 -1
  29. package/dist/POM/PromptObjectModel.d.ts +163 -0
  30. package/dist/POM/PromptObjectModel.js +481 -0
  31. package/dist/POM/PromptObjectModel.js.map +1 -0
  32. package/dist/ParameterSchema.d.ts +306 -0
  33. package/dist/ParameterSchema.js +251 -0
  34. package/dist/ParameterSchema.js.map +1 -0
  35. package/dist/PlatformContracts.d.ts +21 -0
  36. package/dist/PlatformContracts.generated.d.ts +109 -0
  37. package/dist/PlatformContracts.generated.js +8 -0
  38. package/dist/PlatformContracts.generated.js.map +1 -0
  39. package/dist/PlatformContracts.js +2 -0
  40. package/dist/PlatformContracts.js.map +1 -0
  41. package/dist/PomBuilder.d.ts +28 -0
  42. package/dist/PomBuilder.js +81 -3
  43. package/dist/PomBuilder.js.map +1 -1
  44. package/dist/PostPrompt.d.ts +110 -0
  45. package/dist/PostPrompt.js +204 -0
  46. package/dist/PostPrompt.js.map +1 -0
  47. package/dist/PromptManager.d.ts +29 -1
  48. package/dist/PromptManager.js +37 -1
  49. package/dist/PromptManager.js.map +1 -1
  50. package/dist/PublicFetch.d.ts +132 -0
  51. package/dist/PublicFetch.js +311 -0
  52. package/dist/PublicFetch.js.map +1 -0
  53. package/dist/RobotsTxt.d.ts +41 -0
  54. package/dist/RobotsTxt.js +152 -0
  55. package/dist/RobotsTxt.js.map +1 -0
  56. package/dist/SWMLHandler.js.map +1 -1
  57. package/dist/SWMLService.d.ts +265 -66
  58. package/dist/SWMLService.js +652 -112
  59. package/dist/SWMLService.js.map +1 -1
  60. package/dist/SchemaUtils.d.ts +115 -2
  61. package/dist/SchemaUtils.js +444 -12
  62. package/dist/SchemaUtils.js.map +1 -1
  63. package/dist/SecurityUtils.d.ts +55 -8
  64. package/dist/SecurityUtils.js +162 -49
  65. package/dist/SecurityUtils.js.map +1 -1
  66. package/dist/ServerlessAdapter.d.ts +156 -7
  67. package/dist/ServerlessAdapter.js +399 -42
  68. package/dist/ServerlessAdapter.js.map +1 -1
  69. package/dist/SessionManager.d.ts +11 -2
  70. package/dist/SessionManager.js +50 -18
  71. package/dist/SessionManager.js.map +1 -1
  72. package/dist/SslConfig.d.ts +2 -1
  73. package/dist/SslConfig.js +4 -1
  74. package/dist/SslConfig.js.map +1 -1
  75. package/dist/SwaigActions.generated.d.ts +23 -0
  76. package/dist/SwaigActions.generated.js +8 -0
  77. package/dist/SwaigActions.generated.js.map +1 -0
  78. package/dist/SwaigContracts.d.ts +15 -0
  79. package/dist/SwaigContracts.generated.d.ts +264 -0
  80. package/dist/SwaigContracts.generated.js +12 -0
  81. package/dist/SwaigContracts.generated.js.map +1 -0
  82. package/dist/SwaigContracts.js +2 -0
  83. package/dist/SwaigContracts.js.map +1 -0
  84. package/dist/SwaigFunction.d.ts +110 -4
  85. package/dist/SwaigFunction.js +151 -19
  86. package/dist/SwaigFunction.js.map +1 -1
  87. package/dist/SwmlBuilder.d.ts +68 -19
  88. package/dist/SwmlBuilder.js +74 -38
  89. package/dist/SwmlBuilder.js.map +1 -1
  90. package/dist/SwmlVerbMethods.generated.d.ts +41 -4
  91. package/dist/SwmlVerbMethods.generated.js +1 -1
  92. package/dist/TypeInference.d.ts +39 -3
  93. package/dist/TypeInference.js +256 -16
  94. package/dist/TypeInference.js.map +1 -1
  95. package/dist/WebService.d.ts +79 -11
  96. package/dist/WebService.js +320 -109
  97. package/dist/WebService.js.map +1 -1
  98. package/dist/WebhookMiddleware.d.ts +119 -0
  99. package/dist/WebhookMiddleware.js +271 -0
  100. package/dist/WebhookMiddleware.js.map +1 -0
  101. package/dist/WebhookValidator.d.ts +92 -0
  102. package/dist/WebhookValidator.js +409 -0
  103. package/dist/WebhookValidator.js.map +1 -0
  104. package/dist/agents/BedrockAgent.d.ts +162 -0
  105. package/dist/agents/BedrockAgent.js +323 -0
  106. package/dist/agents/BedrockAgent.js.map +1 -0
  107. package/dist/ai-chat/AIChatClient.d.ts +316 -0
  108. package/dist/ai-chat/AIChatClient.js +535 -0
  109. package/dist/ai-chat/AIChatClient.js.map +1 -0
  110. package/dist/ai-chat/ChatGateway.d.ts +408 -0
  111. package/dist/ai-chat/ChatGateway.js +747 -0
  112. package/dist/ai-chat/ChatGateway.js.map +1 -0
  113. package/dist/ai-chat/HandoffRouter.d.ts +282 -0
  114. package/dist/ai-chat/HandoffRouter.js +518 -0
  115. package/dist/ai-chat/HandoffRouter.js.map +1 -0
  116. package/dist/ai-chat/index.d.ts +12 -0
  117. package/dist/ai-chat/index.js +10 -0
  118. package/dist/ai-chat/index.js.map +1 -0
  119. package/dist/capabilities.d.ts +64 -0
  120. package/dist/capabilities.js +95 -0
  121. package/dist/capabilities.js.map +1 -0
  122. package/dist/cli/agent-loader.d.ts +32 -6
  123. package/dist/cli/agent-loader.js +95 -34
  124. package/dist/cli/agent-loader.js.map +1 -1
  125. package/dist/cli/datamap-exec.d.ts +175 -0
  126. package/dist/cli/datamap-exec.js +1284 -0
  127. package/dist/cli/datamap-exec.js.map +1 -0
  128. package/dist/cli/function-args.d.ts +40 -0
  129. package/dist/cli/function-args.js +146 -0
  130. package/dist/cli/function-args.js.map +1 -0
  131. package/dist/cli/simulation.d.ts +99 -0
  132. package/dist/cli/simulation.js +490 -0
  133. package/dist/cli/simulation.js.map +1 -0
  134. package/dist/cli/swaig-test.d.ts +12 -25
  135. package/dist/cli/swaig-test.js +935 -367
  136. package/dist/cli/swaig-test.js.map +1 -1
  137. package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
  138. package/dist/cli/tsdocs/agentsNote.js +92 -0
  139. package/dist/cli/tsdocs/agentsNote.js.map +1 -0
  140. package/dist/cli/tsdocs/api-index.json +1 -0
  141. package/dist/cli/tsdocs/api.d.ts +91 -0
  142. package/dist/cli/tsdocs/api.js +372 -0
  143. package/dist/cli/tsdocs/api.js.map +1 -0
  144. package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
  145. package/dist/cli/tsdocs/apiTypes.js +7 -0
  146. package/dist/cli/tsdocs/apiTypes.js.map +1 -0
  147. package/dist/cli/tsdocs/bin.d.ts +6 -0
  148. package/dist/cli/tsdocs/bin.js +23 -0
  149. package/dist/cli/tsdocs/bin.js.map +1 -0
  150. package/dist/cli/tsdocs/files.d.ts +108 -0
  151. package/dist/cli/tsdocs/files.js +287 -0
  152. package/dist/cli/tsdocs/files.js.map +1 -0
  153. package/dist/cli/tsdocs/index.d.ts +28 -0
  154. package/dist/cli/tsdocs/index.js +307 -0
  155. package/dist/cli/tsdocs/index.js.map +1 -0
  156. package/dist/cli/tsdocs/live.d.ts +41 -0
  157. package/dist/cli/tsdocs/live.js +202 -0
  158. package/dist/cli/tsdocs/live.js.map +1 -0
  159. package/dist/cli/tsdocs/locate.d.ts +51 -0
  160. package/dist/cli/tsdocs/locate.js +75 -0
  161. package/dist/cli/tsdocs/locate.js.map +1 -0
  162. package/dist/cli/tsdocs/render.d.ts +75 -0
  163. package/dist/cli/tsdocs/render.js +323 -0
  164. package/dist/cli/tsdocs/render.js.map +1 -0
  165. package/dist/cli/tsdocs/topics.d.ts +43 -0
  166. package/dist/cli/tsdocs/topics.js +916 -0
  167. package/dist/cli/tsdocs/topics.js.map +1 -0
  168. package/dist/index.d.ts +102 -39
  169. package/dist/index.js +107 -30
  170. package/dist/index.js.map +1 -1
  171. package/dist/livewire/index.d.ts +229 -155
  172. package/dist/livewire/index.js +298 -195
  173. package/dist/livewire/index.js.map +1 -1
  174. package/dist/llms.txt +65 -0
  175. package/dist/prefabs/CallSessionStore.d.ts +52 -0
  176. package/dist/prefabs/CallSessionStore.js +72 -0
  177. package/dist/prefabs/CallSessionStore.js.map +1 -0
  178. package/dist/prefabs/ConciergeAgent.d.ts +13 -1
  179. package/dist/prefabs/ConciergeAgent.js +36 -31
  180. package/dist/prefabs/ConciergeAgent.js.map +1 -1
  181. package/dist/prefabs/FAQBotAgent.d.ts +9 -1
  182. package/dist/prefabs/FAQBotAgent.js +113 -47
  183. package/dist/prefabs/FAQBotAgent.js.map +1 -1
  184. package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
  185. package/dist/prefabs/InfoGathererAgent.js +67 -58
  186. package/dist/prefabs/InfoGathererAgent.js.map +1 -1
  187. package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
  188. package/dist/prefabs/ReceptionistAgent.js +39 -31
  189. package/dist/prefabs/ReceptionistAgent.js.map +1 -1
  190. package/dist/prefabs/SurveyAgent.d.ts +22 -4
  191. package/dist/prefabs/SurveyAgent.js +84 -68
  192. package/dist/prefabs/SurveyAgent.js.map +1 -1
  193. package/dist/relay/Action.d.ts +44 -21
  194. package/dist/relay/Action.js +75 -17
  195. package/dist/relay/Action.js.map +1 -1
  196. package/dist/relay/Call.d.ts +312 -47
  197. package/dist/relay/Call.js +369 -18
  198. package/dist/relay/Call.js.map +1 -1
  199. package/dist/relay/Deferred.js.map +1 -1
  200. package/dist/relay/Message.d.ts +26 -5
  201. package/dist/relay/Message.js +36 -6
  202. package/dist/relay/Message.js.map +1 -1
  203. package/dist/relay/RelayClient.d.ts +79 -14
  204. package/dist/relay/RelayClient.js +268 -61
  205. package/dist/relay/RelayClient.js.map +1 -1
  206. package/dist/relay/RelayError.d.ts +14 -0
  207. package/dist/relay/RelayError.js +15 -0
  208. package/dist/relay/RelayError.js.map +1 -1
  209. package/dist/relay/RelayEvent.d.ts +96 -65
  210. package/dist/relay/RelayEvent.js +85 -56
  211. package/dist/relay/RelayEvent.js.map +1 -1
  212. package/dist/relay/closedSets.d.ts +111 -0
  213. package/dist/relay/closedSets.js +83 -0
  214. package/dist/relay/closedSets.js.map +1 -0
  215. package/dist/relay/index.d.ts +3 -1
  216. package/dist/relay/index.js +1 -0
  217. package/dist/relay/index.js.map +1 -1
  218. package/dist/relay/normalize.js.map +1 -1
  219. package/dist/relay/protocol.types.generated.d.ts +1195 -0
  220. package/dist/relay/protocol.types.generated.js +8 -0
  221. package/dist/relay/protocol.types.generated.js.map +1 -0
  222. package/dist/relay/types.d.ts +81 -39
  223. package/dist/rest/HttpClient.d.ts +36 -8
  224. package/dist/rest/HttpClient.js +233 -40
  225. package/dist/rest/HttpClient.js.map +1 -1
  226. package/dist/rest/RequestOptions.d.ts +110 -0
  227. package/dist/rest/RequestOptions.js +113 -0
  228. package/dist/rest/RequestOptions.js.map +1 -0
  229. package/dist/rest/RestError.d.ts +52 -6
  230. package/dist/rest/RestError.js +89 -5
  231. package/dist/rest/RestError.js.map +1 -1
  232. package/dist/rest/base/CrudResource.d.ts +16 -26
  233. package/dist/rest/base/CrudResource.js +19 -33
  234. package/dist/rest/base/CrudResource.js.map +1 -1
  235. package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
  236. package/dist/rest/base/CrudWithAddresses.js +2 -2
  237. package/dist/rest/base/CrudWithAddresses.js.map +1 -1
  238. package/dist/rest/base/FabricResource.d.ts +15 -0
  239. package/dist/rest/base/FabricResource.js +16 -0
  240. package/dist/rest/base/FabricResource.js.map +1 -0
  241. package/dist/rest/base/ReadResource.d.ts +62 -0
  242. package/dist/rest/base/ReadResource.js +69 -0
  243. package/dist/rest/base/ReadResource.js.map +1 -0
  244. package/dist/rest/callHandler.d.ts +63 -0
  245. package/dist/rest/callHandler.js +62 -0
  246. package/dist/rest/callHandler.js.map +1 -0
  247. package/dist/rest/index.d.ts +19 -76
  248. package/dist/rest/index.js +49 -120
  249. package/dist/rest/index.js.map +1 -1
  250. package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
  251. package/dist/rest/namespaces/_client_tree_generated.js +171 -0
  252. package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
  253. package/dist/rest/namespaces/addresses.d.ts +3 -42
  254. package/dist/rest/namespaces/addresses.js +3 -50
  255. package/dist/rest/namespaces/addresses.js.map +1 -1
  256. package/dist/rest/namespaces/calling.d.ts +6 -378
  257. package/dist/rest/namespaces/calling.js +6 -473
  258. package/dist/rest/namespaces/calling.js.map +1 -1
  259. package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
  260. package/dist/rest/namespaces/calling.resources.generated.js +477 -0
  261. package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
  262. package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
  263. package/dist/rest/namespaces/calling.types.generated.js +8 -0
  264. package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
  265. package/dist/rest/namespaces/chat.d.ts +4 -18
  266. package/dist/rest/namespaces/chat.js +4 -21
  267. package/dist/rest/namespaces/chat.js.map +1 -1
  268. package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
  269. package/dist/rest/namespaces/chat.resources.generated.js +29 -0
  270. package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
  271. package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
  272. package/dist/rest/namespaces/chat.types.generated.js +8 -0
  273. package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
  274. package/dist/rest/namespaces/datasphere.d.ts +6 -62
  275. package/dist/rest/namespaces/datasphere.js +6 -72
  276. package/dist/rest/namespaces/datasphere.js.map +1 -1
  277. package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
  278. package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
  279. package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
  280. package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
  281. package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
  282. package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
  283. package/dist/rest/namespaces/fabric.d.ts +11 -273
  284. package/dist/rest/namespaces/fabric.js +14 -363
  285. package/dist/rest/namespaces/fabric.js.map +1 -1
  286. package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
  287. package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
  288. package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
  289. package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
  290. package/dist/rest/namespaces/fabric.types.generated.js +8 -0
  291. package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
  292. package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
  293. package/dist/rest/namespaces/fax.resources.generated.js +14 -0
  294. package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
  295. package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
  296. package/dist/rest/namespaces/fax.types.generated.js +8 -0
  297. package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
  298. package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
  299. package/dist/rest/namespaces/imported-numbers.js +3 -21
  300. package/dist/rest/namespaces/imported-numbers.js.map +1 -1
  301. package/dist/rest/namespaces/logs.d.ts +10 -101
  302. package/dist/rest/namespaces/logs.js +10 -128
  303. package/dist/rest/namespaces/logs.js.map +1 -1
  304. package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
  305. package/dist/rest/namespaces/logs.resources.generated.js +17 -0
  306. package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
  307. package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
  308. package/dist/rest/namespaces/logs.types.generated.js +8 -0
  309. package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
  310. package/dist/rest/namespaces/lookup.d.ts +3 -25
  311. package/dist/rest/namespaces/lookup.js +3 -27
  312. package/dist/rest/namespaces/lookup.js.map +1 -1
  313. package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
  314. package/dist/rest/namespaces/message.resources.generated.js +14 -0
  315. package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
  316. package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
  317. package/dist/rest/namespaces/message.types.generated.js +8 -0
  318. package/dist/rest/namespaces/message.types.generated.js.map +1 -0
  319. package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
  320. package/dist/rest/namespaces/messages.resources.generated.js +44 -0
  321. package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
  322. package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
  323. package/dist/rest/namespaces/messages.types.generated.js +8 -0
  324. package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
  325. package/dist/rest/namespaces/mfa.d.ts +3 -42
  326. package/dist/rest/namespaces/mfa.js +3 -49
  327. package/dist/rest/namespaces/mfa.js.map +1 -1
  328. package/dist/rest/namespaces/number-groups.d.ts +3 -45
  329. package/dist/rest/namespaces/number-groups.js +3 -53
  330. package/dist/rest/namespaces/number-groups.js.map +1 -1
  331. package/dist/rest/namespaces/phone-numbers.d.ts +9 -57
  332. package/dist/rest/namespaces/phone-numbers.js +9 -63
  333. package/dist/rest/namespaces/phone-numbers.js.map +1 -1
  334. package/dist/rest/namespaces/project.d.ts +6 -42
  335. package/dist/rest/namespaces/project.js +6 -51
  336. package/dist/rest/namespaces/project.js.map +1 -1
  337. package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
  338. package/dist/rest/namespaces/project.resources.generated.js +44 -0
  339. package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
  340. package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
  341. package/dist/rest/namespaces/project.types.generated.js +8 -0
  342. package/dist/rest/namespaces/project.types.generated.js.map +1 -0
  343. package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
  344. package/dist/rest/namespaces/projects.resources.generated.js +25 -0
  345. package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
  346. package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
  347. package/dist/rest/namespaces/projects.types.generated.js +8 -0
  348. package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
  349. package/dist/rest/namespaces/pubsub.d.ts +4 -18
  350. package/dist/rest/namespaces/pubsub.js +4 -21
  351. package/dist/rest/namespaces/pubsub.js.map +1 -1
  352. package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
  353. package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
  354. package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
  355. package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
  356. package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
  357. package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
  358. package/dist/rest/namespaces/queues.d.ts +3 -38
  359. package/dist/rest/namespaces/queues.js +3 -44
  360. package/dist/rest/namespaces/queues.js.map +1 -1
  361. package/dist/rest/namespaces/recordings.d.ts +3 -34
  362. package/dist/rest/namespaces/recordings.js +3 -40
  363. package/dist/rest/namespaces/recordings.js.map +1 -1
  364. package/dist/rest/namespaces/registry.d.ts +6 -137
  365. package/dist/rest/namespaces/registry.js +6 -173
  366. package/dist/rest/namespaces/registry.js.map +1 -1
  367. package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
  368. package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
  369. package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
  370. package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
  371. package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
  372. package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
  373. package/dist/rest/namespaces/short-codes.d.ts +3 -35
  374. package/dist/rest/namespaces/short-codes.js +3 -41
  375. package/dist/rest/namespaces/short-codes.js.map +1 -1
  376. package/dist/rest/namespaces/sip-profile.d.ts +3 -24
  377. package/dist/rest/namespaces/sip-profile.js +3 -29
  378. package/dist/rest/namespaces/sip-profile.js.map +1 -1
  379. package/dist/rest/namespaces/verified-callers.d.ts +3 -29
  380. package/dist/rest/namespaces/verified-callers.js +3 -34
  381. package/dist/rest/namespaces/verified-callers.js.map +1 -1
  382. package/dist/rest/namespaces/video.d.ts +10 -227
  383. package/dist/rest/namespaces/video.js +10 -288
  384. package/dist/rest/namespaces/video.js.map +1 -1
  385. package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
  386. package/dist/rest/namespaces/video.resources.generated.js +171 -0
  387. package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
  388. package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
  389. package/dist/rest/namespaces/video.types.generated.js +8 -0
  390. package/dist/rest/namespaces/video.types.generated.js.map +1 -0
  391. package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
  392. package/dist/rest/namespaces/voice.resources.generated.js +17 -0
  393. package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
  394. package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
  395. package/dist/rest/namespaces/voice.types.generated.js +8 -0
  396. package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
  397. package/dist/rest/pagination.d.ts +5 -1
  398. package/dist/rest/pagination.js +40 -20
  399. package/dist/rest/pagination.js.map +1 -1
  400. package/dist/rest/types.d.ts +21 -3
  401. package/dist/schema.json +299 -98
  402. package/dist/skills/SkillBase.d.ts +97 -20
  403. package/dist/skills/SkillBase.js +100 -17
  404. package/dist/skills/SkillBase.js.map +1 -1
  405. package/dist/skills/SkillManager.d.ts +66 -13
  406. package/dist/skills/SkillManager.js +101 -20
  407. package/dist/skills/SkillManager.js.map +1 -1
  408. package/dist/skills/SkillName.d.ts +44 -0
  409. package/dist/skills/SkillName.js +2 -0
  410. package/dist/skills/SkillName.js.map +1 -0
  411. package/dist/skills/SkillRegistry.d.ts +47 -7
  412. package/dist/skills/SkillRegistry.js +85 -13
  413. package/dist/skills/SkillRegistry.js.map +1 -1
  414. package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
  415. package/dist/skills/builtin/api_ninjas_trivia.js +24 -8
  416. package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
  417. package/dist/skills/builtin/ask_claude.d.ts +14 -4
  418. package/dist/skills/builtin/ask_claude.js +36 -14
  419. package/dist/skills/builtin/ask_claude.js.map +1 -1
  420. package/dist/skills/builtin/claude_skills.d.ts +3 -1
  421. package/dist/skills/builtin/claude_skills.js +19 -15
  422. package/dist/skills/builtin/claude_skills.js.map +1 -1
  423. package/dist/skills/builtin/custom_skills.d.ts +10 -3
  424. package/dist/skills/builtin/custom_skills.js +26 -9
  425. package/dist/skills/builtin/custom_skills.js.map +1 -1
  426. package/dist/skills/builtin/datasphere.d.ts +5 -3
  427. package/dist/skills/builtin/datasphere.js +34 -25
  428. package/dist/skills/builtin/datasphere.js.map +1 -1
  429. package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
  430. package/dist/skills/builtin/datasphere_serverless.js +17 -6
  431. package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
  432. package/dist/skills/builtin/datetime.d.ts +3 -1
  433. package/dist/skills/builtin/datetime.js +11 -7
  434. package/dist/skills/builtin/datetime.js.map +1 -1
  435. package/dist/skills/builtin/google_maps.d.ts +29 -14
  436. package/dist/skills/builtin/google_maps.js +89 -269
  437. package/dist/skills/builtin/google_maps.js.map +1 -1
  438. package/dist/skills/builtin/index.d.ts +8 -6
  439. package/dist/skills/builtin/index.js +8 -6
  440. package/dist/skills/builtin/index.js.map +1 -1
  441. package/dist/skills/builtin/info_gatherer.d.ts +4 -2
  442. package/dist/skills/builtin/info_gatherer.js +20 -12
  443. package/dist/skills/builtin/info_gatherer.js.map +1 -1
  444. package/dist/skills/builtin/joke.d.ts +16 -6
  445. package/dist/skills/builtin/joke.js +54 -37
  446. package/dist/skills/builtin/joke.js.map +1 -1
  447. package/dist/skills/builtin/math.d.ts +3 -1
  448. package/dist/skills/builtin/math.js +14 -9
  449. package/dist/skills/builtin/math.js.map +1 -1
  450. package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
  451. package/dist/skills/builtin/mcp_gateway.js +77 -46
  452. package/dist/skills/builtin/mcp_gateway.js.map +1 -1
  453. package/dist/skills/builtin/native_vector_search.d.ts +19 -5
  454. package/dist/skills/builtin/native_vector_search.js +179 -61
  455. package/dist/skills/builtin/native_vector_search.js.map +1 -1
  456. package/dist/skills/builtin/play_background_file.d.ts +21 -15
  457. package/dist/skills/builtin/play_background_file.js +43 -122
  458. package/dist/skills/builtin/play_background_file.js.map +1 -1
  459. package/dist/skills/builtin/spider.d.ts +46 -1
  460. package/dist/skills/builtin/spider.js +317 -101
  461. package/dist/skills/builtin/spider.js.map +1 -1
  462. package/dist/skills/builtin/swml_transfer.d.ts +14 -3
  463. package/dist/skills/builtin/swml_transfer.js +45 -24
  464. package/dist/skills/builtin/swml_transfer.js.map +1 -1
  465. package/dist/skills/builtin/weather_api.d.ts +24 -13
  466. package/dist/skills/builtin/weather_api.js +57 -31
  467. package/dist/skills/builtin/weather_api.js.map +1 -1
  468. package/dist/skills/builtin/web_search.d.ts +48 -10
  469. package/dist/skills/builtin/web_search.js +301 -84
  470. package/dist/skills/builtin/web_search.js.map +1 -1
  471. package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
  472. package/dist/skills/builtin/wikipedia_search.js +32 -14
  473. package/dist/skills/builtin/wikipedia_search.js.map +1 -1
  474. package/dist/skills/index.d.ts +3 -2
  475. package/dist/skills/index.js +1 -1
  476. package/dist/skills/index.js.map +1 -1
  477. package/dist/swml_verbs_generated.d.ts +2824 -0
  478. package/dist/swml_verbs_generated.js +12 -0
  479. package/dist/swml_verbs_generated.js.map +1 -0
  480. package/dist/types.d.ts +65 -6
  481. package/dist/web.d.ts +27 -0
  482. package/dist/web.js +20 -0
  483. package/dist/web.js.map +1 -0
  484. package/docs/agent-guide.md +1034 -0
  485. package/docs/ai_chat.md +560 -0
  486. package/docs/api-reference.md +3534 -0
  487. package/docs/architecture.md +846 -0
  488. package/docs/bedrock_agent.md +411 -0
  489. package/docs/cli-guide.md +403 -0
  490. package/docs/cloud_functions_guide.md +399 -0
  491. package/docs/configuration.md +548 -0
  492. package/docs/contexts-guide.md +884 -0
  493. package/docs/datamap-guide.md +1160 -0
  494. package/docs/developer_pain_points.md +548 -0
  495. package/docs/llm_parameters.md +298 -0
  496. package/docs/mcp_gateway_reference.md +354 -0
  497. package/docs/mcp_integration.md +162 -0
  498. package/docs/pgi_agent_guide.md +1820 -0
  499. package/docs/prefabs-guide.md +815 -0
  500. package/docs/programmatically_governed_inference.md +301 -0
  501. package/docs/sdk_features.md +501 -0
  502. package/docs/security.md +559 -0
  503. package/docs/serverless-guide.md +520 -0
  504. package/docs/skills-guide.md +1223 -0
  505. package/docs/skills-system.md +405 -0
  506. package/docs/skills_parameter_schema.md +417 -0
  507. package/docs/swaig-reference.md +1938 -0
  508. package/docs/swml_service_guide.md +573 -0
  509. package/docs/third_party_skills.md +410 -0
  510. package/docs/web_service.md +666 -0
  511. package/examples/README.md +202 -0
  512. package/examples/advanced-datamap.ts +108 -0
  513. package/examples/advanced-dynamic-config.ts +70 -0
  514. package/examples/auto-vivified.ts +95 -0
  515. package/examples/call-flow.ts +65 -0
  516. package/examples/comprehensive-dynamic.ts +125 -0
  517. package/examples/contexts-steps.ts +65 -0
  518. package/examples/custom-path.ts +45 -0
  519. package/examples/datamap-tools.ts +51 -0
  520. package/examples/datasphere-multi-instance.ts +66 -0
  521. package/examples/datasphere-serverless-env.ts +87 -0
  522. package/examples/datasphere-webhook-env.ts +65 -0
  523. package/examples/datasphere.ts +56 -0
  524. package/examples/declarative.ts +100 -0
  525. package/examples/dynamic-config.ts +54 -0
  526. package/examples/dynamic-info-gatherer.ts +69 -0
  527. package/examples/dynamic-swml-service.ts +67 -0
  528. package/examples/gather-info.ts +95 -0
  529. package/examples/gather-per-question-functions-demo.ts +139 -0
  530. package/examples/joke-agent.ts +34 -0
  531. package/examples/kubernetes-agent.ts +45 -0
  532. package/examples/llm-params.ts +75 -0
  533. package/examples/mcp-agent.ts +89 -0
  534. package/examples/mcp-gateway.ts +81 -0
  535. package/examples/multi-agent.ts +80 -0
  536. package/examples/multi-endpoint.ts +79 -0
  537. package/examples/pgi/case-domain.ts +114 -0
  538. package/examples/pgi/serve.ts +16 -0
  539. package/examples/pgi/support-agent.ts +265 -0
  540. package/examples/pom-prompt.ts +70 -0
  541. package/examples/prefab-concierge.ts +42 -0
  542. package/examples/prefab-faq.ts +58 -0
  543. package/examples/prefab-info-gatherer.ts +33 -0
  544. package/examples/prefab-receptionist.ts +36 -0
  545. package/examples/prefab-survey.ts +69 -0
  546. package/examples/quickstart-agent.ts +29 -0
  547. package/examples/quickstart-relay.ts +25 -0
  548. package/examples/quickstart-rest.ts +25 -0
  549. package/examples/record-call.ts +65 -0
  550. package/examples/relay-demo.ts +33 -0
  551. package/examples/room-and-sip.ts +93 -0
  552. package/examples/serverless-lambda.ts +43 -0
  553. package/examples/session-state.ts +83 -0
  554. package/examples/simple-agent.ts +36 -0
  555. package/examples/simple-static.ts +29 -0
  556. package/examples/skills-demo.ts +41 -0
  557. package/examples/step-function-inheritance-demo.ts +124 -0
  558. package/examples/swaig-features.ts +193 -0
  559. package/examples/swml-service-routing.ts +66 -0
  560. package/examples/swml-service.ts +38 -0
  561. package/examples/swmlservice_ai_sidecar.ts +104 -0
  562. package/examples/swmlservice_swaig_standalone.ts +79 -0
  563. package/examples/tap.ts +67 -0
  564. package/examples/typed-tools.ts +68 -0
  565. package/examples/verb-methods.ts +45 -0
  566. package/examples/web-search-multi-instance.ts +75 -0
  567. package/examples/web-search.ts +38 -0
  568. package/examples/wikipedia.ts +36 -0
  569. package/livewire/README.md +164 -0
  570. package/livewire/docs/migration-guide.md +251 -0
  571. package/livewire/examples/livewire-basic-agent.ts +74 -0
  572. package/livewire/examples/livewire-handoff.ts +196 -0
  573. package/livewire/examples/livewire-multi-tool.ts +121 -0
  574. package/package.json +88 -13
  575. package/relay/README.md +101 -0
  576. package/relay/docs/call-methods.md +622 -0
  577. package/relay/docs/client-reference.md +281 -0
  578. package/relay/docs/events.md +193 -0
  579. package/relay/docs/getting-started.md +221 -0
  580. package/relay/docs/guide.md +386 -0
  581. package/relay/docs/messaging.md +246 -0
  582. package/relay/examples/relay-inbound.ts +66 -0
  583. package/relay/examples/relay-messaging.ts +74 -0
  584. package/relay/examples/relay-outbound.ts +76 -0
  585. package/rest/README.md +141 -0
  586. package/rest/docs/calling.md +313 -0
  587. package/rest/docs/client-reference.md +149 -0
  588. package/rest/docs/fabric.md +192 -0
  589. package/rest/docs/getting-started.md +138 -0
  590. package/rest/docs/guide.md +421 -0
  591. package/rest/docs/namespaces.md +367 -0
  592. package/rest/docs/phone-binding.md +116 -0
  593. package/rest/examples/rest-10dlc-registration.ts +177 -0
  594. package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
  595. package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
  596. package/rest/examples/rest-calling-play-and-record.ts +98 -0
  597. package/rest/examples/rest-client.ts +59 -0
  598. package/rest/examples/rest-datasphere-search.ts +81 -0
  599. package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
  600. package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
  601. package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
  602. package/rest/examples/rest-manage-resources.ts +64 -0
  603. package/rest/examples/rest-phone-number-management.ts +200 -0
  604. package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
  605. package/rest/examples/rest-video-rooms.ts +186 -0
  606. package/tutorial/fred/fred.ts +218 -0
  607. package/tutorial/fred/tutorial/01-introduction.md +141 -0
  608. package/tutorial/fred/tutorial/02-setup.md +304 -0
  609. package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
  610. package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
  611. package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
  612. package/tutorial/fred/tutorial/06-running-testing.md +642 -0
  613. package/tutorial/fred/tutorial/README.md +56 -0
  614. package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
  615. package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
  616. package/tutorial/full-guardrails-agent/handlers.ts +436 -0
  617. package/tutorial/full-guardrails-agent/penny.ts +305 -0
  618. package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
  619. package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
  620. package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
  621. package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
  622. package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
  623. package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
  624. package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
  625. package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
  626. package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
  627. package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
  628. package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
  629. package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
  630. package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
  631. package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
  632. package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
  633. package/tutorial/full-guardrails-agent/workflow.ts +219 -0
  634. package/tutorial/multi_agents/README.md +175 -0
  635. package/tutorial/multi_agents/advanced_agent.ts +395 -0
  636. package/tutorial/multi_agents/extending_agents.ts +641 -0
  637. package/tutorial/multi_agents/knowledge.ts +59 -0
  638. package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
  639. package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
  640. package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
  641. package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
  642. package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
  643. package/tutorial/multi_agents/pc_builder.ts +529 -0
  644. package/tutorial/multi_agents/sales_agent.ts +88 -0
  645. package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
  646. package/tutorial/multi_agents/sales_knowledge.md +139 -0
  647. package/tutorial/multi_agents/support_knowledge.md +256 -0
  648. package/dist/cli/mock-data.d.ts +0 -37
  649. package/dist/cli/mock-data.js +0 -80
  650. package/dist/cli/mock-data.js.map +0 -1
  651. package/dist/generateVerbTypes.d.ts +0 -11
  652. package/dist/generateVerbTypes.js +0 -265
  653. package/dist/generateVerbTypes.js.map +0 -1
  654. package/dist/rest/namespaces/compat.d.ts +0 -585
  655. package/dist/rest/namespaces/compat.js +0 -735
  656. package/dist/rest/namespaces/compat.js.map +0 -1
@@ -0,0 +1,101 @@
1
+ /**
2
+ * REST Example: Deploy a voice application with SWML scripts and call flows.
3
+ *
4
+ * Prerequisites:
5
+ * export SIGNALWIRE_PROJECT_ID=your-project-id
6
+ * export SIGNALWIRE_API_TOKEN=your-api-token
7
+ * export SIGNALWIRE_SPACE=your-space.signalwire.com
8
+ *
9
+ * Run:
10
+ * npx tsx rest/examples/rest-fabric-swml-and-callflows.ts
11
+ */
12
+
13
+ import { RestClient, RestError } from '@signalwire/sdk';
14
+
15
+ const client = new RestClient();
16
+
17
+ async function main() {
18
+ // 1. Create a SWML script
19
+ console.log('Creating SWML script...');
20
+ const swml = await client.fabric.swmlScripts.create({
21
+ name: 'Greeting Script',
22
+ contents: JSON.stringify({
23
+ sections: { main: [{ play: { url: 'say:Hello from SignalWire' } }] },
24
+ }),
25
+ });
26
+ const swmlId = swml.id;
27
+ console.log(` Created SWML script: ${swmlId}`);
28
+
29
+ // 2. List SWML scripts to confirm
30
+ console.log('\nListing SWML scripts...');
31
+ const scripts = await client.fabric.swmlScripts.list();
32
+ for (const s of scripts.data ?? []) {
33
+ console.log(` - ${s.id}: ${s.display_name ?? 'unnamed'}`);
34
+ }
35
+
36
+ // 3. Create a call flow
37
+ console.log('\nCreating call flow...');
38
+ const flow = await client.fabric.callFlows.create({ title: 'Main IVR Flow' });
39
+ const flowId = flow.id;
40
+ console.log(` Created call flow: ${flowId}`);
41
+
42
+ // 4. Deploy a version of the call flow
43
+ console.log('\nDeploying call flow version...');
44
+ try {
45
+ const version = await client.fabric.callFlows.deployVersion(flowId, { document_version: 1 });
46
+ console.log(` Deployed version: ${JSON.stringify(version)}`);
47
+ } catch (err) {
48
+ if (err instanceof RestError) {
49
+ console.log(` Deploy failed (expected in demo): ${err.statusCode}`);
50
+ } else throw err;
51
+ }
52
+
53
+ // 5. List call flow versions
54
+ console.log('\nListing call flow versions...');
55
+ try {
56
+ const versions = await client.fabric.callFlows.listVersions(flowId);
57
+ for (const v of versions.data ?? []) {
58
+ console.log(` - Version: ${v.version ?? v.id ?? 'unknown'}`);
59
+ }
60
+ } catch (err) {
61
+ if (err instanceof RestError) {
62
+ console.log(` List versions failed: ${err.statusCode}`);
63
+ } else throw err;
64
+ }
65
+
66
+ // 6. List addresses for the call flow
67
+ console.log('\nListing call flow addresses...');
68
+ try {
69
+ const addrs = await client.fabric.callFlows.listAddresses(flowId);
70
+ for (const a of addrs.data ?? []) {
71
+ console.log(` - ${a.display_name ?? a.id ?? 'unknown'}`);
72
+ }
73
+ } catch (err) {
74
+ if (err instanceof RestError) {
75
+ console.log(` List addresses failed: ${err.statusCode}`);
76
+ } else throw err;
77
+ }
78
+
79
+ // 7. Create a SWML webhook as an alternative approach
80
+ console.log('\nCreating SWML webhook...');
81
+ const webhook = await client.fabric.swmlWebhooks.create({
82
+ name: 'External Handler',
83
+ primary_request_url: 'https://example.com/swml-handler',
84
+ });
85
+ const webhookId = webhook.id;
86
+ console.log(` Created webhook: ${webhookId}`);
87
+
88
+ // 8. Clean up
89
+ console.log('\nCleaning up...');
90
+ await client.fabric.swmlWebhooks.delete(webhookId);
91
+ console.log(` Deleted webhook ${webhookId}`);
92
+ await client.fabric.callFlows.delete(flowId);
93
+ console.log(` Deleted call flow ${flowId}`);
94
+ await client.fabric.swmlScripts.delete(swmlId);
95
+ console.log(` Deleted SWML script ${swmlId}`);
96
+ }
97
+
98
+ main().catch((err) => {
99
+ console.error('Error:', err.message);
100
+ process.exit(1);
101
+ });
@@ -0,0 +1,64 @@
1
+ /**
2
+ * REST Example: Create an AI agent, assign a phone number, and place a test call.
3
+ *
4
+ * Prerequisites:
5
+ * export SIGNALWIRE_PROJECT_ID=your-project-id
6
+ * export SIGNALWIRE_API_TOKEN=your-api-token
7
+ * export SIGNALWIRE_SPACE=your-space.signalwire.com
8
+ *
9
+ * Run:
10
+ * npx tsx rest/examples/rest-manage-resources.ts
11
+ */
12
+
13
+ import { RestClient, RestError } from '@signalwire/sdk';
14
+
15
+ const client = new RestClient();
16
+
17
+ async function main() {
18
+ // 1. Create an AI agent
19
+ console.log('Creating AI agent...');
20
+ const agent = await client.fabric.aiAgents.create({
21
+ name: 'Demo Support Bot',
22
+ agent_id: '00000000-0000-0000-0000-000000000000',
23
+ prompt: { text: 'You are a friendly support agent for Acme Corp.' },
24
+ });
25
+ const agentId = agent.id;
26
+ console.log(` Created agent: ${agentId}`);
27
+
28
+ // 2. List all AI agents
29
+ console.log('\nListing AI agents...');
30
+ const agents = await client.fabric.aiAgents.list();
31
+ for (const a of agents.data ?? []) {
32
+ console.log(` - ${a.id}: ${a.display_name ?? 'unnamed'}`);
33
+ }
34
+
35
+ // 3. Search for a phone number
36
+ console.log('\nSearching for available phone numbers...');
37
+ const available = await client.phoneNumbers.search({ areacode: '512', max_results: 3 });
38
+ for (const num of available.data ?? []) {
39
+ console.log(` - ${num.number ?? 'unknown'}`);
40
+ }
41
+
42
+ // 4. Place a test call (requires valid numbers)
43
+ console.log('\nPlacing a test call...');
44
+ try {
45
+ const result = await client.calling.dial('+15559876543', '+15551234567', {
46
+ url: 'https://example.com/call-handler',
47
+ });
48
+ console.log(` Call initiated: ${JSON.stringify(result)}`);
49
+ } catch (err) {
50
+ if (err instanceof RestError) {
51
+ console.log(` Call failed (expected in demo): ${err.statusCode}`);
52
+ } else throw err;
53
+ }
54
+
55
+ // 5. Clean up: delete the agent
56
+ console.log(`\nDeleting agent ${agentId}...`);
57
+ await client.fabric.aiAgents.delete(agentId);
58
+ console.log(' Deleted.');
59
+ }
60
+
61
+ main().catch((err) => {
62
+ console.error('Error:', err.message);
63
+ process.exit(1);
64
+ });
@@ -0,0 +1,200 @@
1
+ /**
2
+ * REST Example: Full phone number inventory lifecycle.
3
+ *
4
+ * Prerequisites:
5
+ * export SIGNALWIRE_PROJECT_ID=your-project-id
6
+ * export SIGNALWIRE_API_TOKEN=your-api-token
7
+ * export SIGNALWIRE_SPACE=your-space.signalwire.com
8
+ *
9
+ * Run:
10
+ * npx tsx rest/examples/rest-phone-number-management.ts
11
+ */
12
+
13
+ import { RestClient, RestError } from '@signalwire/sdk';
14
+
15
+ const client = new RestClient();
16
+
17
+ async function main() {
18
+ // 1. Search for available phone numbers
19
+ console.log('Searching available numbers...');
20
+ const available = await client.phoneNumbers.search({ areacode: '512', max_results: 3 });
21
+ for (const num of available.data ?? []) {
22
+ console.log(` - ${num.number ?? 'unknown'}`);
23
+ }
24
+
25
+ // 2. Purchase a number
26
+ console.log('\nPurchasing a phone number...');
27
+ let numId: string | null = null;
28
+ try {
29
+ const first = (available.data ?? [])[0];
30
+ const number = await client.phoneNumbers.create({ number: first?.number ?? '+15125551234' });
31
+ numId = number.id;
32
+ console.log(` Purchased: ${numId}`);
33
+ } catch (err) {
34
+ if (err instanceof RestError) {
35
+ console.log(` Purchase failed (expected in demo): ${err.statusCode}`);
36
+ } else throw err;
37
+ }
38
+
39
+ // 3. List and get owned numbers
40
+ console.log('\nListing owned numbers...');
41
+ const owned = await client.phoneNumbers.list();
42
+ for (const n of (owned.data ?? []).slice(0, 5)) {
43
+ console.log(` - ${n.number ?? 'unknown'} (${n.id})`);
44
+ }
45
+
46
+ if (numId) {
47
+ const detail = await client.phoneNumbers.get(numId);
48
+ console.log(` Detail: ${detail.number ?? 'N/A'}`);
49
+ }
50
+
51
+ // 4. Update a number
52
+ if (numId) {
53
+ console.log(`\nUpdating number ${numId}...`);
54
+ await client.phoneNumbers.update(numId, { name: 'Main Line' });
55
+ console.log(" Updated name to 'Main Line'");
56
+ }
57
+
58
+ // 5. Create a number group
59
+ console.log('\nCreating number group...');
60
+ let groupId: string | null = null;
61
+ try {
62
+ const group = await client.numberGroups.create({ name: 'Sales Pool' });
63
+ groupId = group.id;
64
+ console.log(` Created group: ${groupId}`);
65
+ } catch (err) {
66
+ if (err instanceof RestError) {
67
+ console.log(` Group creation failed (expected in demo): ${err.statusCode}`);
68
+ } else throw err;
69
+ }
70
+
71
+ // 6. Add a membership and list memberships
72
+ if (groupId && numId) {
73
+ console.log('\nAdding number to group...');
74
+ try {
75
+ const membership = await client.numberGroups.addMembership(groupId, numId);
76
+ const memId = membership.id;
77
+ console.log(` Membership: ${memId}`);
78
+
79
+ const memberships = await client.numberGroups.listMemberships(groupId);
80
+ for (const m of memberships.data ?? []) {
81
+ console.log(` - Member: ${m.id ?? 'unknown'}`);
82
+ }
83
+ } catch (err) {
84
+ if (err instanceof RestError) {
85
+ console.log(` Membership failed (expected in demo): ${err.statusCode}`);
86
+ } else throw err;
87
+ }
88
+ }
89
+
90
+ // 7. Lookup carrier info
91
+ console.log('\nLooking up carrier info...');
92
+ try {
93
+ const info = await client.lookup.phoneNumber('+15125551234');
94
+ console.log(` Carrier: ${info.carrier?.lec ?? 'unknown'}`);
95
+ } catch (err) {
96
+ if (err instanceof RestError) {
97
+ console.log(` Lookup failed (expected in demo): ${err.statusCode}`);
98
+ } else throw err;
99
+ }
100
+
101
+ // 8. Create a verified caller
102
+ console.log('\nCreating verified caller...');
103
+ let callerId: string | null = null;
104
+ try {
105
+ const caller = await client.verifiedCallers.create({ number: '+15125559999' });
106
+ callerId = caller.id;
107
+ console.log(` Created verified caller: ${callerId}`);
108
+ await client.verifiedCallers.submitVerification(callerId as string, '123456');
109
+ console.log(' Verification code submitted');
110
+ } catch (err) {
111
+ if (err instanceof RestError) {
112
+ console.log(` Verified caller failed (expected in demo): ${err.statusCode}`);
113
+ } else throw err;
114
+ }
115
+
116
+ // 9. Get and update SIP profile
117
+ console.log('\nGetting SIP profile...');
118
+ try {
119
+ const profile = await client.sipProfile.get();
120
+ console.log(` SIP profile: ${JSON.stringify(profile)}`);
121
+ await client.sipProfile.update({ default_codecs: ['PCMU', 'PCMA'] });
122
+ console.log(' Updated SIP codecs');
123
+ } catch (err) {
124
+ if (err instanceof RestError) {
125
+ console.log(` SIP profile failed (expected in demo): ${err.statusCode}`);
126
+ } else throw err;
127
+ }
128
+
129
+ // 10. List short codes
130
+ console.log('\nListing short codes...');
131
+ try {
132
+ const codes = await client.shortCodes.list();
133
+ for (const sc of codes.data ?? []) {
134
+ console.log(` - ${sc.number ?? 'unknown'}`);
135
+ }
136
+ } catch (err) {
137
+ if (err instanceof RestError) {
138
+ console.log(` Short codes failed (expected in demo): ${err.statusCode}`);
139
+ } else throw err;
140
+ }
141
+
142
+ // 11. Create an address
143
+ console.log('\nCreating address...');
144
+ let addrId: string | null = null;
145
+ try {
146
+ const addr = await client.addresses.create(
147
+ 'HQ Address',
148
+ 'US',
149
+ 'Acme',
150
+ 'Corp',
151
+ '123',
152
+ 'Main St',
153
+ 'Austin',
154
+ 'TX',
155
+ '78701',
156
+ );
157
+ addrId = addr.id;
158
+ console.log(` Created address: ${addrId}`);
159
+ } catch (err) {
160
+ if (err instanceof RestError) {
161
+ console.log(` Address creation failed (expected in demo): ${err.statusCode}`);
162
+ } else throw err;
163
+ }
164
+
165
+ // 12. Clean up
166
+ console.log('\nCleaning up...');
167
+ if (addrId) {
168
+ await client.addresses.delete(addrId);
169
+ console.log(` Deleted address ${addrId}`);
170
+ }
171
+ if (callerId) {
172
+ try {
173
+ await client.verifiedCallers.delete(callerId);
174
+ console.log(` Deleted verified caller ${callerId}`);
175
+ } catch (err) {
176
+ if (err instanceof RestError) {
177
+ console.log(` Verified caller delete failed: ${err.statusCode}`);
178
+ } else throw err;
179
+ }
180
+ }
181
+ if (groupId) {
182
+ await client.numberGroups.delete(groupId);
183
+ console.log(` Deleted number group ${groupId}`);
184
+ }
185
+ if (numId) {
186
+ try {
187
+ await client.phoneNumbers.delete(numId);
188
+ console.log(` Released number ${numId}`);
189
+ } catch (err) {
190
+ if (err instanceof RestError) {
191
+ console.log(` Release number failed (recently purchased): ${err.statusCode}`);
192
+ } else throw err;
193
+ }
194
+ }
195
+ }
196
+
197
+ main().catch((err) => {
198
+ console.error('Error:', err.message);
199
+ process.exit(1);
200
+ });
@@ -0,0 +1,143 @@
1
+ /**
2
+ * REST Example: Call queues, recording review, and MFA verification.
3
+ *
4
+ * Prerequisites:
5
+ * export SIGNALWIRE_PROJECT_ID=your-project-id
6
+ * export SIGNALWIRE_API_TOKEN=your-api-token
7
+ * export SIGNALWIRE_SPACE=your-space.signalwire.com
8
+ *
9
+ * Run:
10
+ * npx tsx rest/examples/rest-queues-mfa-and-recordings.ts
11
+ */
12
+
13
+ import { RestClient, RestError } from '@signalwire/sdk';
14
+
15
+ const client = new RestClient();
16
+
17
+ async function main() {
18
+ // --- Queues ---
19
+
20
+ // 1. Create a queue
21
+ console.log('Creating call queue...');
22
+ let queueId: string | null = null;
23
+ try {
24
+ const queue = await client.queues.create({ name: 'Support Queue', max_size: 50 });
25
+ queueId = queue.id;
26
+ console.log(` Created queue: ${queueId}`);
27
+ } catch (err) {
28
+ if (err instanceof RestError) {
29
+ console.log(` Queue creation failed (expected in demo): ${err.statusCode}`);
30
+ } else throw err;
31
+ }
32
+
33
+ // 2. List queues
34
+ console.log('\nListing queues...');
35
+ const queues = await client.queues.list();
36
+ for (const q of queues.data ?? []) {
37
+ console.log(` - ${q.id}: ${q.friendly_name ?? 'unnamed'}`);
38
+ }
39
+
40
+ // 3. Get and update queue
41
+ if (queueId) {
42
+ const detail = await client.queues.get(queueId);
43
+ console.log(
44
+ `\nQueue detail: ${detail.friendly_name ?? 'N/A'} (max: ${detail.max_size ?? 'N/A'})`,
45
+ );
46
+
47
+ await client.queues.update(queueId, { name: 'Priority Support Queue' });
48
+ console.log(' Updated queue name');
49
+ }
50
+
51
+ // 4. Queue members
52
+ if (queueId) {
53
+ console.log('\nListing queue members...');
54
+ try {
55
+ const members = await client.queues.listMembers(queueId);
56
+ for (const m of members.data ?? []) {
57
+ console.log(` - Member: ${m.call_id ?? 'unknown'} (position ${m.position})`);
58
+ }
59
+
60
+ const nextMember = await client.queues.getNextMember(queueId);
61
+ console.log(` Next member: ${JSON.stringify(nextMember)}`);
62
+ } catch (err) {
63
+ if (err instanceof RestError) {
64
+ console.log(` Member ops failed (expected if queue empty): ${err.statusCode}`);
65
+ } else throw err;
66
+ }
67
+ }
68
+
69
+ // --- Recordings ---
70
+
71
+ // 5. List recordings
72
+ console.log('\nListing recordings...');
73
+ const recordings = await client.recordings.list();
74
+ for (const r of (recordings.data ?? []).slice(0, 5)) {
75
+ console.log(` - ${r.id}: ${r.duration_in_seconds}s`);
76
+ }
77
+
78
+ // 6. Get recording details
79
+ const firstRec = (recordings.data ?? [])[0];
80
+ if (firstRec?.id) {
81
+ const recDetail = await client.recordings.get(firstRec.id);
82
+ console.log(` Recording: ${recDetail.duration_in_seconds}s, status ${recDetail.status}`);
83
+ }
84
+
85
+ // --- MFA ---
86
+
87
+ // 7. Send MFA via SMS
88
+ console.log('\nSending MFA SMS code...');
89
+ let requestId: string | null = null;
90
+ try {
91
+ const smsResult = await client.mfa.sms('+15551234567', {
92
+ from: '+15559876543',
93
+ message: 'Your code is {{code}}',
94
+ token_length: 6,
95
+ });
96
+ requestId = smsResult.id;
97
+ console.log(` MFA SMS sent: ${requestId}`);
98
+ } catch (err) {
99
+ if (err instanceof RestError) {
100
+ console.log(` MFA SMS failed (expected in demo): ${err.statusCode}`);
101
+ } else throw err;
102
+ }
103
+
104
+ // 8. Send MFA via voice call
105
+ console.log('\nSending MFA voice code...');
106
+ try {
107
+ const voiceResult = await client.mfa.call('+15551234567', {
108
+ from: '+15559876543',
109
+ message: 'Your verification code is {{code}}',
110
+ token_length: 6,
111
+ });
112
+ console.log(` MFA call sent: ${voiceResult.id}`);
113
+ } catch (err) {
114
+ if (err instanceof RestError) {
115
+ console.log(` MFA call failed (expected in demo): ${err.statusCode}`);
116
+ } else throw err;
117
+ }
118
+
119
+ // 9. Verify MFA token
120
+ if (requestId) {
121
+ console.log('\nVerifying MFA token...');
122
+ try {
123
+ const verify = await client.mfa.verify(requestId, '123456');
124
+ console.log(` Verification result: ${JSON.stringify(verify)}`);
125
+ } catch (err) {
126
+ if (err instanceof RestError) {
127
+ console.log(` Verify failed (expected in demo): ${err.statusCode}`);
128
+ } else throw err;
129
+ }
130
+ }
131
+
132
+ // 10. Clean up
133
+ console.log('\nCleaning up...');
134
+ if (queueId) {
135
+ await client.queues.delete(queueId);
136
+ console.log(` Deleted queue ${queueId}`);
137
+ }
138
+ }
139
+
140
+ main().catch((err) => {
141
+ console.error('Error:', err.message);
142
+ process.exit(1);
143
+ });
@@ -0,0 +1,186 @@
1
+ /**
2
+ * REST Example: Video rooms for team standup and conference streaming.
3
+ *
4
+ * Prerequisites:
5
+ * export SIGNALWIRE_PROJECT_ID=your-project-id
6
+ * export SIGNALWIRE_API_TOKEN=your-api-token
7
+ * export SIGNALWIRE_SPACE=your-space.signalwire.com
8
+ *
9
+ * Run:
10
+ * npx tsx rest/examples/rest-video-rooms.ts
11
+ */
12
+
13
+ import { RestClient, RestError } from '@signalwire/sdk';
14
+
15
+ const client = new RestClient();
16
+
17
+ async function main() {
18
+ // --- Video Rooms ---
19
+
20
+ // 1. Create a video room
21
+ console.log('Creating video room...');
22
+ const room = await client.video.rooms.create({
23
+ name: 'daily-standup',
24
+ display_name: 'Daily Standup',
25
+ max_members: 10,
26
+ layout: 'grid-responsive',
27
+ });
28
+ const roomId = room.id;
29
+ console.log(` Created room: ${roomId}`);
30
+
31
+ // 2. List video rooms
32
+ console.log('\nListing video rooms...');
33
+ const rooms = await client.video.rooms.list();
34
+ for (const r of (rooms.data ?? []).slice(0, 5)) {
35
+ console.log(` - ${r.id}: ${r.name ?? 'unnamed'}`);
36
+ }
37
+
38
+ // 3. Generate a join token
39
+ console.log('\nGenerating room token...');
40
+ try {
41
+ const token = await client.video.roomTokens.create('daily-standup', {
42
+ user_name: 'alice',
43
+ permissions: ['room.self.audio_mute', 'room.self.video_mute'],
44
+ });
45
+ console.log(` Token: ${String(token.token ?? '').slice(0, 40)}...`);
46
+ } catch (err) {
47
+ if (err instanceof RestError) {
48
+ console.log(` Token failed (expected in demo): ${err.statusCode}`);
49
+ } else throw err;
50
+ }
51
+
52
+ // --- Sessions ---
53
+
54
+ // 4. List room sessions
55
+ console.log('\nListing room sessions...');
56
+ const sessions = await client.video.roomSessions.list();
57
+ for (const s of (sessions.data ?? []).slice(0, 3)) {
58
+ console.log(` - Session ${s.id}: ${s.status ?? 'unknown'}`);
59
+ }
60
+
61
+ // 5. Get session details with members, events, recordings
62
+ const firstSession = (sessions.data ?? [{}])[0];
63
+ if (firstSession?.id) {
64
+ const sid = firstSession.id;
65
+ const detail = await client.video.roomSessions.get(sid);
66
+ console.log(` Session: ${detail.name ?? 'N/A'} (${detail.status ?? 'N/A'})`);
67
+
68
+ const members = await client.video.roomSessions.listMembers(sid);
69
+ console.log(` Members: ${(members.data ?? []).length}`);
70
+
71
+ const events = await client.video.roomSessions.listEvents(sid);
72
+ console.log(` Events: ${(events.data ?? []).length}`);
73
+
74
+ const recs = await client.video.roomSessions.listRecordings(sid);
75
+ console.log(` Recordings: ${(recs.data ?? []).length}`);
76
+ }
77
+
78
+ // --- Room Recordings ---
79
+
80
+ // 6. List and get room recordings
81
+ console.log('\nListing room recordings...');
82
+ const roomRecs = await client.video.roomRecordings.list();
83
+ for (const rr of (roomRecs.data ?? []).slice(0, 3)) {
84
+ console.log(` - Recording ${rr.id}: ${rr.duration ?? 'N/A'}s`);
85
+ }
86
+
87
+ const firstRec = (roomRecs.data ?? [{}])[0];
88
+ if (firstRec?.id) {
89
+ const recDetail = await client.video.roomRecordings.get(firstRec.id);
90
+ console.log(` Recording detail: ${recDetail.duration ?? 'N/A'}s`);
91
+
92
+ const recEvents = await client.video.roomRecordings.listEvents(firstRec.id);
93
+ console.log(` Recording events: ${(recEvents.data ?? []).length}`);
94
+ }
95
+
96
+ // --- Video Conferences ---
97
+
98
+ // 7. Create a video conference
99
+ console.log('\nCreating video conference...');
100
+ let confId: string | null = null;
101
+ try {
102
+ const conf = await client.video.conferences.create({
103
+ name: 'all-hands-stream',
104
+ display_name: 'All Hands Meeting',
105
+ });
106
+ confId = conf.id;
107
+ console.log(` Created conference: ${confId}`);
108
+ } catch (err) {
109
+ if (err instanceof RestError) {
110
+ console.log(` Conference creation failed (expected in demo): ${err.statusCode}`);
111
+ } else throw err;
112
+ }
113
+
114
+ // 8. List conference tokens
115
+ if (confId) {
116
+ console.log('\nListing conference tokens...');
117
+ try {
118
+ const tokens = await client.video.conferences.listConferenceTokens(confId);
119
+ for (const t of tokens.data ?? []) {
120
+ console.log(` - Token: ${t.id ?? 'unknown'}`);
121
+ }
122
+ } catch (err) {
123
+ if (err instanceof RestError) {
124
+ console.log(` Conference tokens failed: ${err.statusCode}`);
125
+ } else throw err;
126
+ }
127
+ }
128
+
129
+ // 9. Create a stream on the conference
130
+ let streamId: string | null = null;
131
+ if (confId) {
132
+ console.log('\nCreating stream on conference...');
133
+ try {
134
+ const stream = await client.video.conferences.createStream(
135
+ confId,
136
+ 'rtmp://live.example.com/stream-key',
137
+ );
138
+ streamId = stream.id;
139
+ console.log(` Created stream: ${streamId}`);
140
+ } catch (err) {
141
+ if (err instanceof RestError) {
142
+ console.log(` Stream creation failed (expected in demo): ${err.statusCode}`);
143
+ } else throw err;
144
+ }
145
+ }
146
+
147
+ // 10. Get and update stream
148
+ if (streamId) {
149
+ console.log(`\nManaging stream ${streamId}...`);
150
+ try {
151
+ const sDetail = await client.video.streams.get(streamId);
152
+ console.log(` Stream URL: ${sDetail.url ?? 'N/A'}`);
153
+
154
+ await client.video.streams.update(streamId, 'rtmp://backup.example.com/stream-key');
155
+ console.log(' Stream URL updated');
156
+ } catch (err) {
157
+ if (err instanceof RestError) {
158
+ console.log(` Stream ops failed: ${err.statusCode}`);
159
+ } else throw err;
160
+ }
161
+ }
162
+
163
+ // 11. Clean up
164
+ console.log('\nCleaning up...');
165
+ if (streamId) {
166
+ try {
167
+ await client.video.streams.delete(streamId);
168
+ console.log(` Deleted stream ${streamId}`);
169
+ } catch (err) {
170
+ if (err instanceof RestError) {
171
+ console.log(` Stream delete failed: ${err.statusCode}`);
172
+ } else throw err;
173
+ }
174
+ }
175
+ if (confId) {
176
+ await client.video.conferences.delete(confId);
177
+ console.log(` Deleted conference ${confId}`);
178
+ }
179
+ await client.video.rooms.delete(roomId);
180
+ console.log(` Deleted room ${roomId}`);
181
+ }
182
+
183
+ main().catch((err) => {
184
+ console.error('Error:', err.message);
185
+ process.exit(1);
186
+ });