@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,287 +0,0 @@
1
- /**
2
- * ConciergeAgent - Prefab agent that acts as a virtual concierge for a venue
3
- * or business, providing information about services, amenities, and hours,
4
- * and answering availability and directions questions.
5
- *
6
- * Ported from the Python SDK `signalwire.prefabs.concierge.ConciergeAgent`.
7
- */
8
-
9
- import { AgentBase } from '../AgentBase.js';
10
- import { FunctionResult } from '../FunctionResult.js';
11
- import type { AgentOptions } from '../types.js';
12
-
13
- // ── Config types ────────────────────────────────────────────────────────────
14
-
15
- export interface ConciergeConfig {
16
- /** Name of the venue or business (required). */
17
- venueName: string;
18
- /** List of services offered by the venue (required). */
19
- services: string[];
20
- /** Dictionary of amenities, each mapping to a dict of detail keys/values. */
21
- amenities: Record<string, Record<string, string>>;
22
- /** Optional hours of operation by category (e.g. `{ default: "9 AM - 5 PM" }`). */
23
- hoursOfOperation?: Record<string, string>;
24
- /** Optional special instructions appended to the agent's instruction bullets. */
25
- specialInstructions?: string[];
26
- /** Optional custom welcome message spoken as a non-bargeable static greeting. */
27
- welcomeMessage?: string;
28
- /** Agent display name (defaults to `"concierge"`). */
29
- name?: string;
30
- /** HTTP route for this agent (defaults to `"/concierge"`). */
31
- route?: string;
32
- /** Additional AgentBase options forwarded to `super()`. */
33
- agentOptions?: Partial<AgentOptions>;
34
- }
35
-
36
- // ── Agent ───────────────────────────────────────────────────────────────────
37
-
38
- /**
39
- * Prefab agent that acts as a virtual concierge for a venue, providing information
40
- * about services, amenities, hours of operation, availability, and directions.
41
- */
42
- export class ConciergeAgent extends AgentBase {
43
- /** Name of the venue or business. */
44
- public venueName: string;
45
- /** List of services offered by the venue. */
46
- public services: string[];
47
- /** Dictionary of amenities, each mapping to a dict of detail keys/values. */
48
- public amenities: Record<string, Record<string, string>>;
49
- /** Hours of operation by category. Defaults to `{ default: "9 AM - 5 PM" }`. */
50
- public hoursOfOperation: Record<string, string>;
51
- /** Special instructions appended to the agent's instruction bullets. */
52
- public specialInstructions: string[];
53
-
54
- /**
55
- * Create a ConciergeAgent for a venue with the given services, amenities, and hours.
56
- * @param config - Configuration including venue name, services, amenities, and optional hours/instructions/welcome.
57
- */
58
- constructor(config: ConciergeConfig) {
59
- const agentName = config.name ?? 'concierge';
60
- super({
61
- name: agentName,
62
- route: config.route ?? '/concierge',
63
- usePom: true,
64
- ...config.agentOptions,
65
- });
66
-
67
- // Store configuration
68
- this.venueName = config.venueName;
69
- this.services = config.services;
70
- this.amenities = config.amenities;
71
- this.hoursOfOperation = config.hoursOfOperation ?? { default: '9 AM - 5 PM' };
72
- this.specialInstructions = config.specialInstructions ?? [];
73
-
74
- // Build the agent prompt and settings
75
- this.setupConciergeAgent(config.welcomeMessage);
76
-
77
- // Register tools after all fields are initialized
78
- this.defineTools();
79
- }
80
-
81
- /** Configure the concierge agent's prompt, hints, params, and global data. */
82
- private setupConciergeAgent(welcomeMessage?: string): void {
83
- // Personality
84
- this.promptAddSection('Personality', {
85
- body: `You are a professional and helpful virtual concierge for ${this.venueName}.`,
86
- });
87
-
88
- // Goal
89
- this.promptAddSection('Goal', {
90
- body: 'Provide exceptional service by helping users with information, recommendations, and booking assistance.',
91
- });
92
-
93
- // Instructions (base + special)
94
- const instructions = [
95
- 'Be warm and welcoming but professional at all times.',
96
- 'Provide accurate information about amenities, services, and operating hours.',
97
- 'Offer to help with reservations and bookings when appropriate.',
98
- 'Answer questions concisely with specific, relevant details.',
99
- ...this.specialInstructions,
100
- ];
101
- this.promptAddSection('Instructions', { bullets: instructions });
102
-
103
- // Services
104
- const servicesList = this.services.join(', ');
105
- this.promptAddSection('Available Services', {
106
- body: `The following services are available: ${servicesList}`,
107
- });
108
-
109
- // Amenities (each as a subsection)
110
- const amenitiesSubsections = Object.entries(this.amenities).map(([name, details]) => ({
111
- title: this.titleCase(name),
112
- body: Object.entries(details)
113
- .map(([k, v]) => `${this.titleCase(k)}: ${v}`)
114
- .join('\n'),
115
- }));
116
- this.promptAddSection('Amenities', {
117
- body: 'Information about available amenities:',
118
- subsections: amenitiesSubsections,
119
- });
120
-
121
- // Hours of operation
122
- const hoursList = Object.entries(this.hoursOfOperation)
123
- .map(([k, v]) => `${this.titleCase(k)}: ${v}`)
124
- .join('\n');
125
- this.promptAddSection('Hours of Operation', { body: hoursList });
126
-
127
- // Post-prompt summary template
128
- this.setPostPrompt(`
129
- Return a JSON summary of this interaction:
130
- {
131
- "topic": "MAIN_TOPIC",
132
- "service_requested": "SPECIFIC_SERVICE_REQUESTED_OR_null",
133
- "questions_answered": ["QUESTION_1", "QUESTION_2"],
134
- "follow_up_needed": true/false
135
- }
136
- `);
137
-
138
- // Hints for speech recognition
139
- this.addHints([
140
- this.venueName,
141
- ...this.services,
142
- ...Object.keys(this.amenities),
143
- ]);
144
-
145
- // AI behavior params
146
- this.setParams({
147
- wait_for_user: false,
148
- end_of_speech_timeout: 1000,
149
- ai_volume: 5,
150
- local_tz: 'America/New_York',
151
- });
152
-
153
- // Global data
154
- this.setGlobalData({
155
- venue_name: this.venueName,
156
- services: this.services,
157
- amenities: this.amenities,
158
- hours: this.hoursOfOperation,
159
- });
160
-
161
- // Native functions
162
- this.setNativeFunctions(['check_time']);
163
-
164
- // Custom welcome message (non-bargeable static greeting)
165
- if (welcomeMessage) {
166
- this.setParams({
167
- static_greeting: welcomeMessage,
168
- static_greeting_no_barge: true,
169
- });
170
- }
171
- }
172
-
173
- private titleCase(value: string): string {
174
- // Mirrors Python's str.title(): title-cases each word separated by non-letters.
175
- return value.replace(/[A-Za-z]+/g, (w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase());
176
- }
177
-
178
- // ── Tool registration ─────────────────────────────────────────────────
179
-
180
- /** Register the `check_availability` and `get_directions` SWAIG tools. */
181
- protected override defineTools(): void {
182
- // Tool: check_availability
183
- this.defineTool({
184
- name: 'check_availability',
185
- description: 'Check availability for a service on a specific date and time',
186
- parameters: {
187
- type: 'object',
188
- properties: {
189
- service: {
190
- type: 'string',
191
- description: 'The service to check (e.g., spa, restaurant)',
192
- },
193
- date: {
194
- type: 'string',
195
- description: 'The date to check (YYYY-MM-DD format)',
196
- },
197
- time: {
198
- type: 'string',
199
- description: 'The time to check (HH:MM format, 24-hour)',
200
- },
201
- },
202
- },
203
- handler: (args: Record<string, unknown>) => {
204
- const service = ((args['service'] as string) ?? '').toLowerCase();
205
- const date = (args['date'] as string) ?? '';
206
- const time = (args['time'] as string) ?? '';
207
-
208
- // Simple availability simulation — in a real app this would hit a booking system.
209
- const lowerServices = this.services.map((s) => s.toLowerCase());
210
- if (lowerServices.includes(service)) {
211
- return new FunctionResult(
212
- `Yes, ${service} is available on ${date} at ${time}. Would you like to make a reservation?`,
213
- );
214
- }
215
- return new FunctionResult(
216
- `I'm sorry, we don't offer ${service} at ${this.venueName}. ` +
217
- `Our available services are: ${this.services.join(', ')}.`,
218
- );
219
- },
220
- });
221
-
222
- // Tool: get_directions
223
- this.defineTool({
224
- name: 'get_directions',
225
- description: 'Get directions to a specific location or amenity',
226
- parameters: {
227
- type: 'object',
228
- properties: {
229
- location: {
230
- type: 'string',
231
- description: 'The location or amenity to get directions to',
232
- },
233
- },
234
- },
235
- handler: (args: Record<string, unknown>) => {
236
- const location = ((args['location'] as string) ?? '').toLowerCase();
237
-
238
- const amenity = this.amenities[location];
239
- if (amenity && typeof amenity['location'] === 'string') {
240
- const amenityLocation = amenity['location'];
241
- return new FunctionResult(
242
- `The ${location} is located at ${amenityLocation}. ` +
243
- `From the main entrance, follow the signs to ${amenityLocation}.`,
244
- );
245
- }
246
- return new FunctionResult(
247
- `I don't have specific directions to ${location}. ` +
248
- 'You can ask our staff at the front desk for assistance.',
249
- );
250
- },
251
- });
252
- }
253
-
254
- // ── Lifecycle hooks ───────────────────────────────────────────────────
255
-
256
- /**
257
- * Process the interaction summary returned at the end of a call.
258
- * Logs structured summaries as JSON. Subclasses may override to persist or process.
259
- */
260
- override onSummary(
261
- summary: Record<string, unknown> | null,
262
- _rawData: Record<string, unknown>,
263
- ): void | Promise<void> {
264
- if (summary) {
265
- try {
266
- // eslint-disable-next-line no-console
267
- console.log(`Concierge interaction summary: ${JSON.stringify(summary, null, 2)}`);
268
- } catch (err) {
269
- // eslint-disable-next-line no-console
270
- console.log(`Error processing summary: ${String(err)}`);
271
- }
272
- }
273
- }
274
- }
275
-
276
- // ── Factory function ────────────────────────────────────────────────────────
277
-
278
- /**
279
- * Factory function that creates and returns a new ConciergeAgent.
280
- * @param config - Configuration for the concierge agent.
281
- * @returns A configured ConciergeAgent instance.
282
- */
283
- export function createConciergeAgent(config: ConciergeConfig): ConciergeAgent {
284
- return new ConciergeAgent(config);
285
- }
286
-
287
- export default ConciergeAgent;
@@ -1,384 +0,0 @@
1
- /**
2
- * FAQBotAgent - A prefab agent that answers frequently asked questions using
3
- * keyword/word-overlap matching with configurable similarity thresholds
4
- * and optional escalation to a live agent.
5
- *
6
- * Ported from the Python SDK `signalwire.prefabs.faq_bot.FAQBotAgent`. Keeps
7
- * TS-specific enhancements (configurable similarity threshold, word-overlap
8
- * matcher, escalation tool) alongside the Python prefab's public surface.
9
- */
10
-
11
- import { AgentBase } from '../AgentBase.js';
12
- import { FunctionResult } from '../FunctionResult.js';
13
- import type { AgentOptions } from '../types.js';
14
-
15
- // ── Config types ────────────────────────────────────────────────────────────
16
-
17
- export interface FAQEntry {
18
- /** The representative question text. */
19
- question: string;
20
- /** The answer to provide when this FAQ matches. */
21
- answer: string;
22
- /** Additional keywords to boost matching accuracy. */
23
- keywords?: string[];
24
- /** Taxonomy categories this FAQ belongs to (used for filtering and hints). */
25
- categories?: string[];
26
- }
27
-
28
- export interface FAQBotConfig {
29
- /** Agent display name (defaults to `"faq_bot"`). */
30
- name?: string;
31
- /** HTTP route for this agent (defaults to `"/faq"`). */
32
- route?: string;
33
- /** List of FAQ entries for the knowledge base. */
34
- faqs: FAQEntry[];
35
- /** Whether to suggest related questions alongside a match. Default `true`. */
36
- suggestRelated?: boolean;
37
- /** Custom personality description for the agent's "Personality" prompt section. */
38
- persona?: string;
39
- /** Minimum match score (0-1) for an FAQ to be considered a match. Default 0.5. */
40
- threshold?: number;
41
- /** Message spoken when no FAQ matches the query. */
42
- escalationMessage?: string;
43
- /** Phone number to transfer to on escalation. If not set, escalate tool is not registered. */
44
- escalationNumber?: string;
45
- /** Additional AgentBase options forwarded to super(). */
46
- agentOptions?: Partial<AgentOptions>;
47
- }
48
-
49
- // ── Agent ───────────────────────────────────────────────────────────────────
50
-
51
- /** Prefab agent that answers frequently asked questions using keyword matching with optional escalation to a live agent. */
52
- export class FAQBotAgent extends AgentBase {
53
- /** The configured FAQ entries. */
54
- public faqs: FAQEntry[];
55
- /** Whether runner-up FAQ suggestions are appended to matches. */
56
- public suggestRelated: boolean;
57
- /** The personality description used in the prompt. */
58
- public persona: string;
59
- private threshold: number;
60
- private escalationMessage: string;
61
- private escalationNumber: string | null;
62
-
63
- /**
64
- * Create a FAQBotAgent with the specified FAQ entries and matching threshold.
65
- * @param config - Configuration including FAQ entries, threshold, and escalation settings.
66
- */
67
- constructor(config: FAQBotConfig) {
68
- const agentName = config.name ?? 'faq_bot';
69
- super({
70
- name: agentName,
71
- route: config.route ?? '/faq',
72
- usePom: true,
73
- ...config.agentOptions,
74
- });
75
-
76
- this.faqs = config.faqs;
77
- this.suggestRelated = config.suggestRelated ?? true;
78
- this.persona =
79
- config.persona ??
80
- 'You are a helpful FAQ bot that provides accurate answers to common questions.';
81
- this.threshold = config.threshold ?? 0.5;
82
- this.escalationMessage =
83
- config.escalationMessage ??
84
- "I'm sorry, I couldn't find an answer to your question. Let me transfer you to someone who can help.";
85
- this.escalationNumber = config.escalationNumber ?? null;
86
-
87
- this.buildPrompt();
88
- this.configureAgentSettings();
89
-
90
- // Register tools after all fields are initialized
91
- this.defineTools();
92
- }
93
-
94
- // ── Prompt construction (mirrors Python _build_faq_bot_prompt) ────────
95
-
96
- private buildPrompt(): void {
97
- // Personality
98
- this.promptAddSection('Personality', { body: this.persona });
99
-
100
- // Goal
101
- this.promptAddSection('Goal', {
102
- body:
103
- 'Answer user questions by matching them to the most similar FAQ in your database.',
104
- });
105
-
106
- // Instructions
107
- const instructions = [
108
- 'Compare user questions to your FAQ database and find the best match.',
109
- 'Provide the answer from the FAQ database for the matching question.',
110
- 'If no close match exists, politely say you don\'t have that information.',
111
- 'Be concise and factual in your responses.',
112
- ];
113
- if (this.suggestRelated) {
114
- instructions.push(
115
- 'When appropriate, suggest other related questions from the FAQ database that might be helpful.',
116
- );
117
- }
118
- this.promptAddSection('Instructions', { bullets: instructions });
119
-
120
- // FAQ Database (each FAQ as a subsection with optional categories line)
121
- const faqSubsections = this.faqs
122
- .filter((faq) => faq.question && faq.answer)
123
- .map((faq) => {
124
- let body = faq.answer;
125
- if (faq.categories && faq.categories.length > 0) {
126
- body = `${body}\n\nCategories: ${faq.categories.join(', ')}`;
127
- }
128
- return { title: faq.question, body };
129
- });
130
- this.promptAddSection('FAQ Database', {
131
- body: 'Here is your database of frequently asked questions and answers:',
132
- subsections: faqSubsections,
133
- });
134
-
135
- if (this.suggestRelated) {
136
- this.promptAddSection('Related Questions', {
137
- body:
138
- 'When appropriate, suggest other related questions from the FAQ database that might be helpful.',
139
- });
140
- }
141
- }
142
-
143
- // ── Agent settings (mirrors Python _configure_agent_settings + _setup_post_prompt) ─
144
-
145
- private configureAgentSettings(): void {
146
- // Post-prompt summary template
147
- this.setPostPrompt(`
148
- Return a JSON summary of this interaction:
149
- {
150
- "question": "MAIN_QUESTION_ASKED",
151
- "matched_faq": "MATCHED_FAQ_QUESTION_OR_null",
152
- "answered_successfully": true/false,
153
- "suggested_related": []
154
- }
155
- `);
156
-
157
- // Hints: 4+ char question words, FAQ keywords, and categories
158
- const hints: string[] = [];
159
- for (const faq of this.faqs) {
160
- const question = faq.question ?? '';
161
- if (question) {
162
- const words = question
163
- .split(/\s+/)
164
- .map((w) => w.replace(/^[.,?!]+|[.,?!]+$/g, ''))
165
- .filter((w) => w.length >= 4);
166
- hints.push(...words);
167
- }
168
- if (faq.keywords) hints.push(...faq.keywords);
169
- if (faq.categories) hints.push(...faq.categories);
170
- }
171
- const unique = Array.from(new Set(hints));
172
- if (unique.length > 0) this.addHints(unique);
173
-
174
- // AI behavior parameters
175
- this.setParams({
176
- wait_for_user: false,
177
- end_of_speech_timeout: 1000,
178
- ai_volume: 5,
179
- });
180
-
181
- // Global data: faq count and categories
182
- const categories = Array.from(
183
- new Set(
184
- this.faqs.flatMap((faq) => faq.categories ?? []),
185
- ),
186
- );
187
- this.setGlobalData({
188
- faq_count: this.faqs.length,
189
- categories,
190
- });
191
-
192
- // Native functions
193
- this.setNativeFunctions(['check_time']);
194
- }
195
-
196
- // ── Matching engine ───────────────────────────────────────────────────
197
-
198
- /**
199
- * Compute a word-overlap similarity score between a query and an FAQ entry.
200
- * Combines question text similarity and keyword overlap.
201
- * Returns a value between 0 and 1.
202
- */
203
- private computeMatchScore(query: string, faq: FAQEntry): number {
204
- const queryWords = this.tokenize(query);
205
- if (queryWords.length === 0) return 0;
206
-
207
- // Score against the question text
208
- const questionWords = this.tokenize(faq.question);
209
- const questionOverlap = this.wordOverlap(queryWords, questionWords);
210
-
211
- // Score against keywords
212
- let keywordScore = 0;
213
- if (faq.keywords && faq.keywords.length > 0) {
214
- const keywordTokens = faq.keywords.map((k) => k.toLowerCase().trim());
215
- const queryLower = query.toLowerCase();
216
- let keywordHits = 0;
217
- for (const kw of keywordTokens) {
218
- if (queryLower.includes(kw)) {
219
- keywordHits++;
220
- }
221
- }
222
- keywordScore = keywordTokens.length > 0 ? keywordHits / keywordTokens.length : 0;
223
- }
224
-
225
- // Weighted combination: 60% question overlap, 40% keyword score
226
- return faq.keywords && faq.keywords.length > 0
227
- ? questionOverlap * 0.6 + keywordScore * 0.4
228
- : questionOverlap;
229
- }
230
-
231
- private tokenize(text: string): string[] {
232
- return text
233
- .toLowerCase()
234
- .replace(/[^a-z0-9\s]/g, ' ')
235
- .split(/\s+/)
236
- .filter((w) => w.length > 1 && !STOP_WORDS.has(w));
237
- }
238
-
239
- private wordOverlap(queryWords: string[], targetWords: string[]): number {
240
- if (queryWords.length === 0 || targetWords.length === 0) return 0;
241
- const targetSet = new Set(targetWords);
242
- let matches = 0;
243
- for (const word of queryWords) {
244
- if (targetSet.has(word)) matches++;
245
- }
246
- // Normalize by the smaller set to be lenient
247
- const divisor = Math.min(queryWords.length, targetWords.length);
248
- return divisor > 0 ? matches / divisor : 0;
249
- }
250
-
251
- // ── Tool registration ─────────────────────────────────────────────────
252
-
253
- /** Register the search_faqs and optional escalate SWAIG tools. */
254
- protected override defineTools(): void {
255
- // Tool: search_faqs (matches Python name; supports optional category filter)
256
- this.defineTool({
257
- name: 'search_faqs',
258
- description: 'Search for FAQs matching a specific query or category',
259
- parameters: {
260
- type: 'object',
261
- properties: {
262
- query: {
263
- type: 'string',
264
- description: 'The search query',
265
- },
266
- category: {
267
- type: 'string',
268
- description: 'Optional category to filter by',
269
- },
270
- },
271
- },
272
- handler: (args: Record<string, unknown>) => {
273
- const query = (args['query'] as string) ?? '';
274
- const category = ((args['category'] as string) ?? '').toLowerCase().trim();
275
- if (!query) {
276
- return new FunctionResult('A query is required to search the FAQ.');
277
- }
278
-
279
- // Optionally filter by category
280
- const pool = category
281
- ? this.faqs.filter(
282
- (faq) =>
283
- (faq.categories ?? []).some((c) => c.toLowerCase().trim() === category),
284
- )
285
- : this.faqs;
286
-
287
- if (pool.length === 0) {
288
- return new FunctionResult('No matching FAQs found.');
289
- }
290
-
291
- // Score all FAQs in the (possibly filtered) pool
292
- const scored = pool
293
- .map((faq) => ({ faq, score: this.computeMatchScore(query, faq) }))
294
- .filter((s) => s.score >= this.threshold)
295
- .sort((a, b) => b.score - a.score);
296
-
297
- if (scored.length === 0) {
298
- return new FunctionResult('No matching FAQs found.');
299
- }
300
-
301
- // Match Python's response format: a numbered list of the top 3 matches'
302
- // question text (faq_bot.py:276-283). The answer text is supplied to
303
- // the AI via the prompt's "FAQ Database" section — the tool just
304
- // indicates which FAQs matched. The `suggest_related` flag does not
305
- // change the top-N here; it only toggles the prompt's "Related
306
- // Questions" section and the extra instruction bullet (Python parity).
307
- const top = scored.slice(0, 3);
308
- const lines = top.map((s, i) => `${i + 1}. ${s.faq.question}`).join('\n');
309
- return new FunctionResult(`Here are the most relevant FAQs:\n\n${lines}\n`);
310
- },
311
- });
312
-
313
- // Tool: escalate (only if escalation number is configured)
314
- if (this.escalationNumber) {
315
- this.defineTool({
316
- name: 'escalate',
317
- description: 'Transfer the caller to a live agent when the FAQ knowledge base cannot answer their question.',
318
- parameters: {
319
- type: 'object',
320
- properties: {
321
- reason: {
322
- type: 'string',
323
- description: 'The reason for escalation.',
324
- },
325
- },
326
- },
327
- handler: (_args: Record<string, unknown>) => {
328
- const reason = (_args['reason'] as string) || 'Caller needs assistance beyond FAQ';
329
- const result = new FunctionResult(
330
- `${this.escalationMessage} Transferring caller to a live agent. Reason: ${reason}`,
331
- );
332
- result.connect(this.escalationNumber!);
333
- return result;
334
- },
335
- });
336
- }
337
- }
338
-
339
- // ── Lifecycle hooks ───────────────────────────────────────────────────
340
-
341
- /**
342
- * Process the interaction summary returned at the end of a call.
343
- * Logs structured summaries as JSON. Subclasses may override to persist or process.
344
- */
345
- override onSummary(
346
- summary: Record<string, unknown> | null,
347
- _rawData: Record<string, unknown>,
348
- ): void | Promise<void> {
349
- if (summary) {
350
- try {
351
- // eslint-disable-next-line no-console
352
- console.log(`FAQ interaction summary: ${JSON.stringify(summary, null, 2)}`);
353
- } catch (err) {
354
- // eslint-disable-next-line no-console
355
- console.log(`Error processing summary: ${String(err)}`);
356
- }
357
- }
358
- }
359
- }
360
-
361
- // ── Common English stop words filtered from matching ────────────────────────
362
-
363
- const STOP_WORDS = new Set([
364
- 'a', 'an', 'the', 'is', 'it', 'to', 'in', 'of', 'and', 'or', 'for',
365
- 'on', 'at', 'by', 'do', 'if', 'my', 'so', 'up', 'am', 'as', 'be',
366
- 'he', 'me', 'we', 'no', 'not', 'are', 'was', 'has', 'had', 'how',
367
- 'its', 'can', 'did', 'get', 'but', 'you', 'her', 'him', 'his', 'she',
368
- 'our', 'who', 'this', 'that', 'what', 'with', 'have', 'from', 'will',
369
- 'your', 'they', 'them', 'been', 'does', 'just', 'than', 'when', 'which',
370
- 'would', 'could', 'should', 'about', 'their', 'there', 'these', 'those',
371
- ]);
372
-
373
- // ── Factory function ────────────────────────────────────────────────────────
374
-
375
- /**
376
- * Factory function that creates and returns a new FAQBotAgent.
377
- * @param config - Configuration for the FAQ bot agent.
378
- * @returns A configured FAQBotAgent instance.
379
- */
380
- export function createFAQBotAgent(config: FAQBotConfig): FAQBotAgent {
381
- return new FAQBotAgent(config);
382
- }
383
-
384
- export default FAQBotAgent;