@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,411 +0,0 @@
1
- /**
2
- * Individual tests for the InfoGatherer skill.
3
- */
4
-
5
- import { describe, it, expect, beforeAll } from 'vitest';
6
- import { InfoGathererSkill, createInfoGathererSkill } from '../../src/skills/builtin/index.js';
7
- import { SkillBase } from '../../src/skills/SkillBase.js';
8
- import { suppressAllLogs } from '../../src/Logger.js';
9
-
10
- beforeAll(() => { suppressAllLogs(true); });
11
-
12
- // ── Basic skill identity + setup contract ──────────────────────────────────
13
-
14
- describe('InfoGathererSkill', () => {
15
- it('should instantiate via constructor and factory', () => {
16
- expect(new InfoGathererSkill()).toBeInstanceOf(SkillBase);
17
- expect(createInfoGathererSkill()).toBeInstanceOf(InfoGathererSkill);
18
- });
19
-
20
- it("should return false from setup when 'questions' is not configured", async () => {
21
- // Python parity: skill.py:91-95 — `questions` is required; setup returns
22
- // false (and logs an error) if it's missing.
23
- await expect(new InfoGathererSkill().setup()).resolves.toBe(false);
24
- });
25
-
26
- it('should return true from setup when valid questions are configured', async () => {
27
- await expect(
28
- new InfoGathererSkill({
29
- questions: [{ key_name: 'email', question_text: 'What is your email?' }],
30
- }).setup(),
31
- ).resolves.toBe(true);
32
- });
33
-
34
- it('should return false from setup when questions is an empty array', async () => {
35
- // Python parity: skill.py:301 — `At least one question is required`.
36
- await expect(
37
- new InfoGathererSkill({ questions: [] }).setup(),
38
- ).resolves.toBe(false);
39
- });
40
-
41
- it('should return false from setup when questions is not an array', async () => {
42
- await expect(
43
- new InfoGathererSkill({ questions: 'not-an-array' }).setup(),
44
- ).resolves.toBe(false);
45
- });
46
-
47
- it('should return false from setup when a question is missing key_name', async () => {
48
- await expect(
49
- new InfoGathererSkill({
50
- questions: [{ question_text: 'What is your name?' }],
51
- }).setup(),
52
- ).resolves.toBe(false);
53
- });
54
-
55
- it('should return false from setup when a question is missing question_text', async () => {
56
- await expect(
57
- new InfoGathererSkill({ questions: [{ key_name: 'name' }] }).setup(),
58
- ).resolves.toBe(false);
59
- });
60
-
61
- it('should skip prompt sections when skip_prompt is set', () => {
62
- expect(
63
- new InfoGathererSkill({ skip_prompt: true }).getPromptSections(),
64
- ).toHaveLength(0);
65
- });
66
-
67
- it('should return empty hints', () => {
68
- expect(new InfoGathererSkill().getHints()).toEqual([]);
69
- });
70
-
71
- it('should return correct manifest', () => {
72
- const klass = InfoGathererSkill as typeof SkillBase;
73
- expect(klass.SKILL_NAME).toBe('info_gatherer');
74
- expect(klass.SKILL_VERSION).toBe('1.0.0');
75
- });
76
-
77
- it('should have a parameter schema', () => {
78
- const schema = InfoGathererSkill.getParameterSchema();
79
- expect(schema).toBeDefined();
80
- });
81
- });
82
-
83
- // ── Sequential question flow mode ────────────────────────────────────────────
84
-
85
- describe('InfoGathererSkill — sequential question flow', () => {
86
- const QUESTIONS = [
87
- { key_name: 'first_name', question_text: 'What is your first name?' },
88
- { key_name: 'last_name', question_text: 'What is your last name?', confirm: true },
89
- { key_name: 'city', question_text: 'What city do you live in?', prompt_add: 'City only, please.' },
90
- ];
91
-
92
- // Helper: build a rawData envelope with skill state seeded under the given namespace.
93
- function makeRawData(
94
- namespace: string,
95
- state: Record<string, unknown>,
96
- ): Record<string, unknown> {
97
- return { global_data: { [namespace]: state } };
98
- }
99
-
100
- // ── setup() ──────────────────────────────────────────────────────────
101
-
102
- it('setup() — populates instance state from valid questions config', async () => {
103
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
104
- await skill.setup();
105
- // After setup, getTools() must return sequential tools (not field tools).
106
- const tools = skill.getTools();
107
- expect(tools).toHaveLength(2);
108
- expect(tools[0].name).toBe('start_questions');
109
- expect(tools[1].name).toBe('submit_answer');
110
- });
111
-
112
- it('setup() — uses prefix to derive tool names', async () => {
113
- const skill = new InfoGathererSkill({ questions: QUESTIONS, prefix: 'survey' });
114
- await skill.setup();
115
- const tools = skill.getTools();
116
- expect(tools[0].name).toBe('survey_start_questions');
117
- expect(tools[1].name).toBe('survey_submit_answer');
118
- });
119
-
120
- it('setup() — applies custom completion_message', async () => {
121
- const custom = 'All done! Thank you.';
122
- const skill = new InfoGathererSkill({ questions: QUESTIONS, completion_message: custom });
123
- await skill.setup();
124
- // Drive all the way to completion to observe the message.
125
- const namespace = 'skill:info_gatherer';
126
- const submitTool = skill.getTools()[1];
127
- // Answer question 1
128
- let state: Record<string, unknown> = { questions: QUESTIONS, question_index: 0, answers: [] };
129
- let rawData = makeRawData(namespace, state);
130
- let result = submitTool.handler({ answer: 'Alice', confirmed_by_user: false }, rawData) as { response: string };
131
- // Advance state (simulate updateSkillData)
132
- state = { questions: QUESTIONS, question_index: 1, answers: [{ key_name: 'first_name', answer: 'Alice' }] };
133
- // Answer question 2 (requires confirmation)
134
- rawData = makeRawData(namespace, state);
135
- result = submitTool.handler({ answer: 'Smith', confirmed_by_user: true }, rawData) as { response: string };
136
- state = { questions: QUESTIONS, question_index: 2, answers: [{ key_name: 'first_name', answer: 'Alice' }, { key_name: 'last_name', answer: 'Smith' }] };
137
- // Answer question 3 — last question
138
- rawData = makeRawData(namespace, state);
139
- result = submitTool.handler({ answer: 'Portland', confirmed_by_user: false }, rawData) as { response: string };
140
- expect(result.response).toBe(custom);
141
- });
142
-
143
- it('setup() — returns false for empty questions array (Python skill.py:301)', async () => {
144
- const skill = new InfoGathererSkill({ questions: [] });
145
- await expect(skill.setup()).resolves.toBe(false);
146
- // Un-set-up skill reports no tools (defensive guard — Python relies on
147
- // the SkillManager never calling register_tools on a failed skill).
148
- expect(skill.getTools()).toHaveLength(0);
149
- });
150
-
151
- it('setup() — returns false for non-array questions config', async () => {
152
- const skill = new InfoGathererSkill({ questions: 'not-an-array' });
153
- await expect(skill.setup()).resolves.toBe(false);
154
- expect(skill.getTools()).toHaveLength(0);
155
- });
156
-
157
- it('setup() — returns false when a question is missing key_name', async () => {
158
- const skill = new InfoGathererSkill({
159
- questions: [{ question_text: 'What is your name?' }],
160
- });
161
- await expect(skill.setup()).resolves.toBe(false);
162
- expect(skill.getTools()).toHaveLength(0);
163
- });
164
-
165
- it('setup() — returns false when a question is missing question_text', async () => {
166
- const skill = new InfoGathererSkill({
167
- questions: [{ key_name: 'name' }],
168
- });
169
- await expect(skill.setup()).resolves.toBe(false);
170
- expect(skill.getTools()).toHaveLength(0);
171
- });
172
-
173
- // ── getInstanceKey() ─────────────────────────────────────────────────
174
-
175
- it('getInstanceKey() — returns "info_gatherer" when no prefix', () => {
176
- expect(new InfoGathererSkill().getInstanceKey()).toBe('info_gatherer');
177
- });
178
-
179
- it('getInstanceKey() — returns "info_gatherer_<prefix>" when prefix set', () => {
180
- expect(new InfoGathererSkill({ prefix: 'intake' }).getInstanceKey()).toBe('info_gatherer_intake');
181
- });
182
-
183
- // ── getGlobalData() ──────────────────────────────────────────────────
184
-
185
- it('getGlobalData() — returns empty object when no questions configured', () => {
186
- expect(new InfoGathererSkill().getGlobalData()).toEqual({});
187
- });
188
-
189
- it('getGlobalData() — seeds question state after setup() with questions', async () => {
190
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
191
- await skill.setup();
192
- const globalData = skill.getGlobalData();
193
- const namespace = skill.getSkillNamespace();
194
- expect(globalData).toHaveProperty(namespace);
195
- const state = globalData[namespace] as Record<string, unknown>;
196
- expect(state['question_index']).toBe(0);
197
- expect(state['answers']).toEqual([]);
198
- expect(Array.isArray(state['questions'])).toBe(true);
199
- expect((state['questions'] as unknown[]).length).toBe(QUESTIONS.length);
200
- });
201
-
202
- it('getGlobalData() — uses prefix in namespace key', async () => {
203
- const skill = new InfoGathererSkill({ questions: QUESTIONS, prefix: 'survey' });
204
- await skill.setup();
205
- const globalData = skill.getGlobalData();
206
- // With prefix, namespace is "skill:survey" (config['prefix'] takes priority in getSkillNamespace)
207
- expect(globalData).toHaveProperty('skill:survey');
208
- });
209
-
210
- // ── SUPPORTS_MULTIPLE_INSTANCES ──────────────────────────────────────
211
-
212
- it('SUPPORTS_MULTIPLE_INSTANCES is true', () => {
213
- expect(InfoGathererSkill.SUPPORTS_MULTIPLE_INSTANCES).toBe(true);
214
- });
215
-
216
- // ── start_questions tool ─────────────────────────────────────────────
217
-
218
- it('start_questions — returns first question instruction when state is fresh', async () => {
219
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
220
- await skill.setup();
221
- const startTool = skill.getTools()[0];
222
- expect(startTool.name).toBe('start_questions');
223
-
224
- const namespace = skill.getSkillNamespace();
225
- const state = { questions: QUESTIONS, question_index: 0, answers: [] };
226
- const rawData = makeRawData(namespace, state);
227
-
228
- const result = startTool.handler({}, rawData) as { response: string };
229
- expect(result.response).toContain(QUESTIONS[0].question_text);
230
- expect(result.response).toContain('Question 1 of 3');
231
- });
232
-
233
- it('start_questions — includes submit tool name in instruction', async () => {
234
- const skill = new InfoGathererSkill({ questions: QUESTIONS, prefix: 'q' });
235
- await skill.setup();
236
- const startTool = skill.getTools()[0];
237
- const namespace = skill.getSkillNamespace();
238
- const rawData = makeRawData(namespace, { questions: QUESTIONS, question_index: 0, answers: [] });
239
- const result = startTool.handler({}, rawData) as { response: string };
240
- expect(result.response).toContain('q_submit_answer');
241
- });
242
-
243
- it('start_questions — returns no-questions message when questions array is empty in state', async () => {
244
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
245
- await skill.setup();
246
- const startTool = skill.getTools()[0];
247
- const namespace = skill.getSkillNamespace();
248
- // State has empty questions array
249
- const rawData = makeRawData(namespace, { questions: [], question_index: 0, answers: [] });
250
- const result = startTool.handler({}, rawData) as { response: string };
251
- expect(result.response).toContain("don't have any questions");
252
- });
253
-
254
- // ── submit_answer tool ───────────────────────────────────────────────
255
-
256
- it('submit_answer — valid answer advances to next question', async () => {
257
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
258
- await skill.setup();
259
- const submitTool = skill.getTools()[1];
260
- const namespace = skill.getSkillNamespace();
261
-
262
- const state = { questions: QUESTIONS, question_index: 0, answers: [] };
263
- const rawData = makeRawData(namespace, state);
264
-
265
- const result = submitTool.handler({ answer: 'Alice', confirmed_by_user: false }, rawData) as { response: string; action: Record<string, unknown>[] };
266
- // Should return the second question instruction
267
- expect(result.response).toContain(QUESTIONS[1].question_text);
268
- expect(result.response).toContain('Question 2 of 3');
269
- });
270
-
271
- it('submit_answer — confirm=true question is rejected without confirmed_by_user flag', async () => {
272
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
273
- await skill.setup();
274
- const submitTool = skill.getTools()[1];
275
- const namespace = skill.getSkillNamespace();
276
-
277
- // question_index=1 is the confirm:true question
278
- const state = {
279
- questions: QUESTIONS,
280
- question_index: 1,
281
- answers: [{ key_name: 'first_name', answer: 'Alice' }],
282
- };
283
- const rawData = makeRawData(namespace, state);
284
-
285
- const result = submitTool.handler({ answer: 'Smith', confirmed_by_user: false }, rawData) as { response: string };
286
- expect(result.response).toContain('must read the answer');
287
- expect(result.response).toContain('"Smith"');
288
- });
289
-
290
- it('submit_answer — confirm=true question succeeds with confirmed_by_user=true', async () => {
291
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
292
- await skill.setup();
293
- const submitTool = skill.getTools()[1];
294
- const namespace = skill.getSkillNamespace();
295
-
296
- const state = {
297
- questions: QUESTIONS,
298
- question_index: 1,
299
- answers: [{ key_name: 'first_name', answer: 'Alice' }],
300
- };
301
- const rawData = makeRawData(namespace, state);
302
-
303
- const result = submitTool.handler({ answer: 'Smith', confirmed_by_user: true }, rawData) as { response: string };
304
- // Should proceed to question 3
305
- expect(result.response).toContain(QUESTIONS[2].question_text);
306
- expect(result.response).toContain('Question 3 of 3');
307
- });
308
-
309
- it('submit_answer — prompt_add text is included in the next question instruction', async () => {
310
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
311
- await skill.setup();
312
- const submitTool = skill.getTools()[1];
313
- const namespace = skill.getSkillNamespace();
314
-
315
- // Advance past questions 1 and 2 (confirm) to reach question 3 (city, has prompt_add)
316
- const state = {
317
- questions: QUESTIONS,
318
- question_index: 1,
319
- answers: [{ key_name: 'first_name', answer: 'Alice' }],
320
- };
321
- const rawData = makeRawData(namespace, state);
322
- // Answer q2 with confirmation
323
- const result = submitTool.handler({ answer: 'Smith', confirmed_by_user: true }, rawData) as { response: string };
324
- expect(result.response).toContain('City only, please.');
325
- });
326
-
327
- it('submit_answer — last question triggers completion and disables tools', async () => {
328
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
329
- await skill.setup();
330
- const submitTool = skill.getTools()[1];
331
- const namespace = skill.getSkillNamespace();
332
-
333
- const state = {
334
- questions: QUESTIONS,
335
- question_index: 2,
336
- answers: [
337
- { key_name: 'first_name', answer: 'Alice' },
338
- { key_name: 'last_name', answer: 'Smith' },
339
- ],
340
- };
341
- const rawData = makeRawData(namespace, state);
342
-
343
- const result = submitTool.handler({ answer: 'Portland', confirmed_by_user: false }, rawData) as { response: string; action: Record<string, unknown>[] };
344
- // Response should be the completion message
345
- expect(result.response).toContain('Thank you! All questions have been answered');
346
- // Action should include toggle_functions to disable both tools
347
- const toggleAction = result.action.find((a) => 'toggle_functions' in a);
348
- expect(toggleAction).toBeDefined();
349
- const toggles = toggleAction!['toggle_functions'] as Array<{ function: string; active: boolean }>;
350
- const startToggle = toggles.find((t) => t.function === 'start_questions');
351
- const submitToggle = toggles.find((t) => t.function === 'submit_answer');
352
- expect(startToggle?.active).toBe(false);
353
- expect(submitToggle?.active).toBe(false);
354
- });
355
-
356
- it('submit_answer — last question also writes updated state via set_global_data', async () => {
357
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
358
- await skill.setup();
359
- const submitTool = skill.getTools()[1];
360
- const namespace = skill.getSkillNamespace();
361
-
362
- const state = {
363
- questions: QUESTIONS,
364
- question_index: 2,
365
- answers: [
366
- { key_name: 'first_name', answer: 'Alice' },
367
- { key_name: 'last_name', answer: 'Smith' },
368
- ],
369
- };
370
- const rawData = makeRawData(namespace, state);
371
- const result = submitTool.handler({ answer: 'Portland', confirmed_by_user: false }, rawData) as { response: string; action: Record<string, unknown>[] };
372
-
373
- const globalDataAction = result.action.find((a) => 'set_global_data' in a);
374
- expect(globalDataAction).toBeDefined();
375
- const updatedData = globalDataAction!['set_global_data'] as Record<string, unknown>;
376
- const newState = updatedData[namespace] as Record<string, unknown>;
377
- expect(newState['question_index']).toBe(3);
378
- expect((newState['answers'] as unknown[]).length).toBe(3);
379
- });
380
-
381
- it('submit_answer — returns "all answered" message when index is already at end', async () => {
382
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
383
- await skill.setup();
384
- const submitTool = skill.getTools()[1];
385
- const namespace = skill.getSkillNamespace();
386
-
387
- const state = {
388
- questions: QUESTIONS,
389
- question_index: 3, // past the end
390
- answers: [
391
- { key_name: 'first_name', answer: 'Alice' },
392
- { key_name: 'last_name', answer: 'Smith' },
393
- { key_name: 'city', answer: 'Portland' },
394
- ],
395
- };
396
- const rawData = makeRawData(namespace, state);
397
- const result = submitTool.handler({ answer: 'extra', confirmed_by_user: false }, rawData) as { response: string };
398
- expect(result.response).toBe('All questions have already been answered.');
399
- });
400
-
401
- // ── Prompt sections ──────────────────────────────────────────────────
402
-
403
- it('provides sequential prompt section when questions are configured', async () => {
404
- const skill = new InfoGathererSkill({ questions: QUESTIONS });
405
- await skill.setup();
406
- const sections = skill.getPromptSections();
407
- expect(sections.length).toBeGreaterThan(0);
408
- expect(sections[0].body).toContain('start_questions');
409
- expect(sections[0].body).toContain('submit_answer');
410
- });
411
- });
@@ -1,81 +0,0 @@
1
- /**
2
- * Individual tests for the Joke skill.
3
- */
4
-
5
- import { describe, it, expect, beforeAll } from 'vitest';
6
- import { JokeSkill, createJokeSkill } from '../../src/skills/builtin/index.js';
7
- import { SkillBase } from '../../src/skills/SkillBase.js';
8
- import { FunctionResult } from '../../src/FunctionResult.js';
9
- import { suppressAllLogs } from '../../src/Logger.js';
10
-
11
- beforeAll(() => { suppressAllLogs(true); });
12
-
13
- describe('JokeSkill', () => {
14
- it('should instantiate via constructor and factory', () => {
15
- expect(new JokeSkill()).toBeInstanceOf(SkillBase);
16
- expect(createJokeSkill()).toBeInstanceOf(JokeSkill);
17
- });
18
-
19
- it('should complete setup without errors', async () => {
20
- await expect(new JokeSkill().setup()).resolves.toBe(true);
21
- });
22
-
23
- it('should register a tell_joke tool', () => {
24
- const tools = new JokeSkill().getTools();
25
- expect(tools).toHaveLength(1);
26
- expect(tools[0].name).toBe('tell_joke');
27
- });
28
-
29
- it('should provide prompt sections', () => {
30
- const sections = new JokeSkill().getPromptSections();
31
- expect(sections.length).toBeGreaterThan(0);
32
- expect(sections[0].title).toBe('Jokes');
33
- });
34
-
35
- it('should skip prompt sections when skip_prompt is set', () => {
36
- expect(new JokeSkill({ skip_prompt: true }).getPromptSections()).toHaveLength(0);
37
- });
38
-
39
- it('should return empty hints and joke_skill_enabled global data', () => {
40
- const skill = new JokeSkill();
41
- expect(skill.getHints()).toEqual([]);
42
- expect(skill.getGlobalData()).toEqual({ joke_skill_enabled: true });
43
- });
44
-
45
- it('should use a configurable tool_name', () => {
46
- const skill = new JokeSkill({ tool_name: 'get_joke' });
47
- const tools = skill.getTools();
48
- expect(tools).toHaveLength(1);
49
- expect(tools[0].name).toBe('get_joke');
50
- });
51
-
52
- it('should return correct manifest', () => {
53
- const klass = JokeSkill as typeof SkillBase;
54
- expect(klass.SKILL_NAME).toBe('joke');
55
- expect(klass.SKILL_VERSION).toBe('1.0.0');
56
- });
57
-
58
- it('should return a joke from any category', () => {
59
- const handler = new JokeSkill().getTools()[0].handler;
60
- const result = handler({}, {}) as FunctionResult;
61
- expect(result).toBeInstanceOf(FunctionResult);
62
- expect(result.response).toContain('...');
63
- });
64
-
65
- it('should return a joke from a specific category', () => {
66
- const handler = new JokeSkill().getTools()[0].handler;
67
- const result = handler({ category: 'programming' }, {}) as FunctionResult;
68
- expect(result.response).toBeTruthy();
69
- });
70
-
71
- it('should handle unknown category', () => {
72
- const handler = new JokeSkill().getTools()[0].handler;
73
- const result = handler({ category: 'nonexistent' }, {}) as FunctionResult;
74
- expect(result.response).toContain('Unknown');
75
- });
76
-
77
- it('should have a parameter schema', () => {
78
- const schema = JokeSkill.getParameterSchema();
79
- expect(schema['swaig_fields']).toBeDefined();
80
- });
81
- });
@@ -1,68 +0,0 @@
1
- /**
2
- * Individual tests for the Math skill.
3
- */
4
-
5
- import { describe, it, expect, beforeAll } from 'vitest';
6
- import { MathSkill, createMathSkill } from '../../src/skills/builtin/index.js';
7
- import { SkillBase } from '../../src/skills/SkillBase.js';
8
- import { FunctionResult } from '../../src/FunctionResult.js';
9
- import { suppressAllLogs } from '../../src/Logger.js';
10
-
11
- beforeAll(() => { suppressAllLogs(true); });
12
-
13
- describe('MathSkill', () => {
14
- it('should instantiate via constructor and factory', () => {
15
- expect(new MathSkill()).toBeInstanceOf(SkillBase);
16
- expect(createMathSkill()).toBeInstanceOf(MathSkill);
17
- });
18
-
19
- it('should complete setup without errors', async () => {
20
- await expect(new MathSkill().setup()).resolves.toBe(true);
21
- });
22
-
23
- it('should register a calculate tool', () => {
24
- const tools = new MathSkill().getTools();
25
- expect(tools).toHaveLength(1);
26
- expect(tools[0].name).toBe('calculate');
27
- expect(tools[0].required).toContain('expression');
28
- });
29
-
30
- it('should provide prompt sections', () => {
31
- const sections = new MathSkill().getPromptSections();
32
- expect(sections.length).toBeGreaterThan(0);
33
- expect(sections[0].title).toBe('Mathematical Calculations');
34
- });
35
-
36
- it('should skip prompt sections when skip_prompt is set', () => {
37
- expect(new MathSkill({ skip_prompt: true }).getPromptSections()).toHaveLength(0);
38
- });
39
-
40
- it('should return empty hints and global data', () => {
41
- const skill = new MathSkill();
42
- expect(skill.getHints()).toEqual([]);
43
- expect(skill.getGlobalData()).toEqual({});
44
- });
45
-
46
- it('should return correct manifest', () => {
47
- const klass = MathSkill as typeof SkillBase;
48
- expect(klass.SKILL_NAME).toBe('math');
49
- expect(klass.SKILL_VERSION).toBe('1.0.0');
50
- });
51
-
52
- it('should evaluate a simple expression', () => {
53
- const handler = new MathSkill().getTools()[0].handler;
54
- const result = handler({ expression: '2 + 3' }, {}) as FunctionResult;
55
- expect(result.response).toContain('5');
56
- });
57
-
58
- it('should reject invalid expressions', () => {
59
- const handler = new MathSkill().getTools()[0].handler;
60
- const result = handler({ expression: 'DROP TABLE' }, {}) as FunctionResult;
61
- expect(result.response).toContain('Could not evaluate');
62
- });
63
-
64
- it('should have a parameter schema', () => {
65
- const schema = MathSkill.getParameterSchema();
66
- expect(schema['swaig_fields']).toBeDefined();
67
- });
68
- });
@@ -1,101 +0,0 @@
1
- /**
2
- * Individual tests for the McpGateway skill.
3
- */
4
-
5
- import { describe, it, expect, beforeAll } from 'vitest';
6
- import { McpGatewaySkill, createMcpGatewaySkill } from '../../src/skills/builtin/index.js';
7
- import { SkillBase } from '../../src/skills/SkillBase.js';
8
- import { FunctionResult } from '../../src/FunctionResult.js';
9
- import { suppressAllLogs } from '../../src/Logger.js';
10
-
11
- beforeAll(() => { suppressAllLogs(true); });
12
-
13
- describe('McpGatewaySkill', () => {
14
- it('should instantiate via constructor and factory', () => {
15
- expect(new McpGatewaySkill()).toBeInstanceOf(SkillBase);
16
- expect(createMcpGatewaySkill()).toBeInstanceOf(McpGatewaySkill);
17
- });
18
-
19
- it('should return false from setup when gateway_url is not configured', async () => {
20
- // Python parity: setup returns false when required gateway_url is missing,
21
- // so the SkillManager logs a warning and the placeholder tool is the only
22
- // surface. Configured-mode setup is exercised separately with mocked HTTP.
23
- await expect(new McpGatewaySkill().setup()).resolves.toBe(false);
24
- });
25
-
26
- it('should register a placeholder tool when unconfigured', () => {
27
- const tools = new McpGatewaySkill().getTools();
28
- expect(tools.length).toBeGreaterThan(0);
29
- expect(tools[0].handler).toBeTypeOf('function');
30
- // Placeholder handler should return a configuration-prompt message
31
- const res = tools[0].handler({}, {}) as FunctionResult;
32
- expect(res.response).toMatch(/not configured|configure/i);
33
- });
34
-
35
- it('should provide no prompt sections without configured services', () => {
36
- // Without configured services the prompt section should be empty (Python parity)
37
- expect(new McpGatewaySkill().getPromptSections()).toEqual([]);
38
- });
39
-
40
- it('should skip prompt sections when skip_prompt is set', () => {
41
- expect(new McpGatewaySkill({ skip_prompt: true }).getPromptSections()).toHaveLength(0);
42
- });
43
-
44
- it('should return mcp hints with configured services', () => {
45
- const skill = new McpGatewaySkill({
46
- services: [{ name: 'calculator' }, { name: 'weather' }],
47
- });
48
- const hints = skill.getHints();
49
- expect(hints).toContain('MCP');
50
- expect(hints).toContain('gateway');
51
- expect(hints).toContain('calculator');
52
- expect(hints).toContain('weather');
53
- });
54
-
55
- it('should return empty global data when not ready', () => {
56
- expect(new McpGatewaySkill().getGlobalData()).toEqual({});
57
- });
58
-
59
- it('should return correct manifest', () => {
60
- const klass = McpGatewaySkill as typeof SkillBase;
61
- expect(klass.SKILL_NAME).toBe('mcp_gateway');
62
- expect(klass.SKILL_VERSION).toBe('1.0.0');
63
- });
64
-
65
- it('should accept gateway_url config', () => {
66
- const skill = new McpGatewaySkill({ gateway_url: 'http://localhost:8080' });
67
- expect(skill.getConfig('gateway_url')).toBe('http://localhost:8080');
68
- });
69
-
70
- it('should have a parameter schema with all expected keys', () => {
71
- const schema = McpGatewaySkill.getParameterSchema();
72
- expect(schema['gateway_url']).toBeDefined();
73
- expect(schema['tool_prefix']).toBeDefined();
74
- expect((schema['tool_prefix'] as { default?: unknown }).default).toBe('mcp_');
75
- expect(schema['auth_token']).toBeDefined();
76
- expect((schema['auth_token'] as { env_var?: string }).env_var).toBe('MCP_GATEWAY_AUTH_TOKEN');
77
- expect(schema['auth_user']).toBeDefined();
78
- expect(schema['auth_password']).toBeDefined();
79
- expect(schema['services']).toBeDefined();
80
- expect(schema['session_timeout']).toBeDefined();
81
- expect(schema['retry_attempts']).toBeDefined();
82
- expect(schema['request_timeout']).toBeDefined();
83
- expect(schema['verify_ssl']).toBeDefined();
84
- });
85
-
86
- it('should build prompt sections when services are configured', () => {
87
- const skill = new McpGatewaySkill({
88
- gateway_url: 'http://localhost:8080',
89
- auth_token: 'abc',
90
- services: [
91
- { name: 'calculator', tools: '*' },
92
- { name: 'weather', tools: ['forecast', 'current'] },
93
- ],
94
- });
95
- // Skill is not ready until setup succeeds, so sections are empty.
96
- // But we can still verify the internal formatting builds without throwing:
97
- const sections = skill.getPromptSections();
98
- // Without setup, services list is still populated from config for prompt building
99
- expect(Array.isArray(sections)).toBe(true);
100
- });
101
- });