@signalwire/sdk 2.0.5 → 3.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (659) hide show
  1. package/CHANGELOG.md +821 -0
  2. package/LICENSE +21 -0
  3. package/README.md +163 -68
  4. package/dist/AGENTS.md +13 -0
  5. package/dist/AgentBase.d.ts +510 -126
  6. package/dist/AgentBase.js +1581 -455
  7. package/dist/AgentBase.js.map +1 -1
  8. package/dist/AgentServer.d.ts +21 -0
  9. package/dist/AgentServer.js +154 -47
  10. package/dist/AgentServer.js.map +1 -1
  11. package/dist/AuthHandler.d.ts +14 -2
  12. package/dist/AuthHandler.js +7 -2
  13. package/dist/AuthHandler.js.map +1 -1
  14. package/dist/ConfigLoader.d.ts +5 -13
  15. package/dist/ConfigLoader.js +15 -29
  16. package/dist/ConfigLoader.js.map +1 -1
  17. package/dist/ContextBuilder.d.ts +202 -9
  18. package/dist/ContextBuilder.js +219 -36
  19. package/dist/ContextBuilder.js.map +1 -1
  20. package/dist/DataMap.d.ts +186 -45
  21. package/dist/DataMap.js +210 -52
  22. package/dist/DataMap.js.map +1 -1
  23. package/dist/FunctionResult.d.ts +309 -83
  24. package/dist/FunctionResult.js +483 -116
  25. package/dist/FunctionResult.js.map +1 -1
  26. package/dist/Logger.d.ts +30 -5
  27. package/dist/Logger.js +77 -19
  28. package/dist/Logger.js.map +1 -1
  29. package/dist/POM/PromptObjectModel.d.ts +12 -1
  30. package/dist/POM/PromptObjectModel.js +25 -9
  31. package/dist/POM/PromptObjectModel.js.map +1 -1
  32. package/dist/ParameterSchema.d.ts +306 -0
  33. package/dist/ParameterSchema.js +251 -0
  34. package/dist/ParameterSchema.js.map +1 -0
  35. package/dist/PlatformContracts.d.ts +21 -0
  36. package/dist/PlatformContracts.generated.d.ts +109 -0
  37. package/dist/PlatformContracts.generated.js +8 -0
  38. package/dist/PlatformContracts.generated.js.map +1 -0
  39. package/dist/PlatformContracts.js +2 -0
  40. package/dist/PlatformContracts.js.map +1 -0
  41. package/dist/PomBuilder.d.ts +18 -0
  42. package/dist/PomBuilder.js +53 -3
  43. package/dist/PomBuilder.js.map +1 -1
  44. package/dist/PostPrompt.d.ts +110 -0
  45. package/dist/PostPrompt.js +204 -0
  46. package/dist/PostPrompt.js.map +1 -0
  47. package/dist/PromptManager.d.ts +22 -1
  48. package/dist/PromptManager.js +28 -1
  49. package/dist/PromptManager.js.map +1 -1
  50. package/dist/PublicFetch.d.ts +132 -0
  51. package/dist/PublicFetch.js +311 -0
  52. package/dist/PublicFetch.js.map +1 -0
  53. package/dist/RobotsTxt.d.ts +41 -0
  54. package/dist/RobotsTxt.js +152 -0
  55. package/dist/RobotsTxt.js.map +1 -0
  56. package/dist/SWMLHandler.js.map +1 -1
  57. package/dist/SWMLService.d.ts +169 -59
  58. package/dist/SWMLService.js +456 -129
  59. package/dist/SWMLService.js.map +1 -1
  60. package/dist/SchemaUtils.d.ts +115 -2
  61. package/dist/SchemaUtils.js +444 -12
  62. package/dist/SchemaUtils.js.map +1 -1
  63. package/dist/SecurityUtils.d.ts +49 -9
  64. package/dist/SecurityUtils.js +153 -51
  65. package/dist/SecurityUtils.js.map +1 -1
  66. package/dist/SemanticGate.d.ts +183 -0
  67. package/dist/SemanticGate.js +533 -0
  68. package/dist/SemanticGate.js.map +1 -0
  69. package/dist/ServerlessAdapter.d.ts +156 -7
  70. package/dist/ServerlessAdapter.js +399 -42
  71. package/dist/ServerlessAdapter.js.map +1 -1
  72. package/dist/SessionManager.d.ts +11 -2
  73. package/dist/SessionManager.js +50 -18
  74. package/dist/SessionManager.js.map +1 -1
  75. package/dist/SslConfig.d.ts +2 -1
  76. package/dist/SslConfig.js +4 -1
  77. package/dist/SslConfig.js.map +1 -1
  78. package/dist/SwaigActions.generated.d.ts +23 -0
  79. package/dist/SwaigActions.generated.js +8 -0
  80. package/dist/SwaigActions.generated.js.map +1 -0
  81. package/dist/SwaigContracts.d.ts +15 -0
  82. package/dist/SwaigContracts.generated.d.ts +264 -0
  83. package/dist/SwaigContracts.generated.js +12 -0
  84. package/dist/SwaigContracts.generated.js.map +1 -0
  85. package/dist/SwaigContracts.js +2 -0
  86. package/dist/SwaigContracts.js.map +1 -0
  87. package/dist/SwaigFunction.d.ts +139 -7
  88. package/dist/SwaigFunction.js +170 -22
  89. package/dist/SwaigFunction.js.map +1 -1
  90. package/dist/SwmlBuilder.d.ts +68 -19
  91. package/dist/SwmlBuilder.js +74 -38
  92. package/dist/SwmlBuilder.js.map +1 -1
  93. package/dist/SwmlVerbMethods.generated.d.ts +41 -4
  94. package/dist/SwmlVerbMethods.generated.js +1 -1
  95. package/dist/TypeInference.d.ts +39 -3
  96. package/dist/TypeInference.js +256 -16
  97. package/dist/TypeInference.js.map +1 -1
  98. package/dist/WebService.d.ts +79 -11
  99. package/dist/WebService.js +320 -109
  100. package/dist/WebService.js.map +1 -1
  101. package/dist/WebhookMiddleware.d.ts +119 -0
  102. package/dist/WebhookMiddleware.js +271 -0
  103. package/dist/WebhookMiddleware.js.map +1 -0
  104. package/dist/WebhookValidator.d.ts +92 -0
  105. package/dist/WebhookValidator.js +409 -0
  106. package/dist/WebhookValidator.js.map +1 -0
  107. package/dist/agents/BedrockAgent.d.ts +162 -0
  108. package/dist/agents/BedrockAgent.js +323 -0
  109. package/dist/agents/BedrockAgent.js.map +1 -0
  110. package/dist/ai-chat/AIChatClient.d.ts +316 -0
  111. package/dist/ai-chat/AIChatClient.js +535 -0
  112. package/dist/ai-chat/AIChatClient.js.map +1 -0
  113. package/dist/ai-chat/ChatGateway.d.ts +408 -0
  114. package/dist/ai-chat/ChatGateway.js +747 -0
  115. package/dist/ai-chat/ChatGateway.js.map +1 -0
  116. package/dist/ai-chat/HandoffRouter.d.ts +282 -0
  117. package/dist/ai-chat/HandoffRouter.js +518 -0
  118. package/dist/ai-chat/HandoffRouter.js.map +1 -0
  119. package/dist/ai-chat/index.d.ts +12 -0
  120. package/dist/ai-chat/index.js +10 -0
  121. package/dist/ai-chat/index.js.map +1 -0
  122. package/dist/capabilities.d.ts +64 -0
  123. package/dist/capabilities.js +95 -0
  124. package/dist/capabilities.js.map +1 -0
  125. package/dist/cli/agent-loader.d.ts +32 -6
  126. package/dist/cli/agent-loader.js +92 -33
  127. package/dist/cli/agent-loader.js.map +1 -1
  128. package/dist/cli/datamap-exec.d.ts +175 -0
  129. package/dist/cli/datamap-exec.js +1284 -0
  130. package/dist/cli/datamap-exec.js.map +1 -0
  131. package/dist/cli/function-args.d.ts +40 -0
  132. package/dist/cli/function-args.js +146 -0
  133. package/dist/cli/function-args.js.map +1 -0
  134. package/dist/cli/simulation.d.ts +99 -0
  135. package/dist/cli/simulation.js +490 -0
  136. package/dist/cli/simulation.js.map +1 -0
  137. package/dist/cli/swaig-test.d.ts +12 -25
  138. package/dist/cli/swaig-test.js +935 -371
  139. package/dist/cli/swaig-test.js.map +1 -1
  140. package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
  141. package/dist/cli/tsdocs/agentsNote.js +92 -0
  142. package/dist/cli/tsdocs/agentsNote.js.map +1 -0
  143. package/dist/cli/tsdocs/api-index.json +1 -0
  144. package/dist/cli/tsdocs/api.d.ts +91 -0
  145. package/dist/cli/tsdocs/api.js +372 -0
  146. package/dist/cli/tsdocs/api.js.map +1 -0
  147. package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
  148. package/dist/cli/tsdocs/apiTypes.js +7 -0
  149. package/dist/cli/tsdocs/apiTypes.js.map +1 -0
  150. package/dist/cli/tsdocs/bin.d.ts +6 -0
  151. package/dist/cli/tsdocs/bin.js +23 -0
  152. package/dist/cli/tsdocs/bin.js.map +1 -0
  153. package/dist/cli/tsdocs/files.d.ts +108 -0
  154. package/dist/cli/tsdocs/files.js +287 -0
  155. package/dist/cli/tsdocs/files.js.map +1 -0
  156. package/dist/cli/tsdocs/index.d.ts +28 -0
  157. package/dist/cli/tsdocs/index.js +307 -0
  158. package/dist/cli/tsdocs/index.js.map +1 -0
  159. package/dist/cli/tsdocs/live.d.ts +41 -0
  160. package/dist/cli/tsdocs/live.js +202 -0
  161. package/dist/cli/tsdocs/live.js.map +1 -0
  162. package/dist/cli/tsdocs/locate.d.ts +51 -0
  163. package/dist/cli/tsdocs/locate.js +75 -0
  164. package/dist/cli/tsdocs/locate.js.map +1 -0
  165. package/dist/cli/tsdocs/render.d.ts +75 -0
  166. package/dist/cli/tsdocs/render.js +323 -0
  167. package/dist/cli/tsdocs/render.js.map +1 -0
  168. package/dist/cli/tsdocs/topics.d.ts +43 -0
  169. package/dist/cli/tsdocs/topics.js +920 -0
  170. package/dist/cli/tsdocs/topics.js.map +1 -0
  171. package/dist/index.d.ts +49 -68
  172. package/dist/index.js +45 -73
  173. package/dist/index.js.map +1 -1
  174. package/dist/livewire/index.d.ts +229 -155
  175. package/dist/livewire/index.js +298 -195
  176. package/dist/livewire/index.js.map +1 -1
  177. package/dist/llms.txt +65 -0
  178. package/dist/prefabs/CallSessionStore.d.ts +52 -0
  179. package/dist/prefabs/CallSessionStore.js +72 -0
  180. package/dist/prefabs/CallSessionStore.js.map +1 -0
  181. package/dist/prefabs/ConciergeAgent.d.ts +13 -1
  182. package/dist/prefabs/ConciergeAgent.js +36 -31
  183. package/dist/prefabs/ConciergeAgent.js.map +1 -1
  184. package/dist/prefabs/FAQBotAgent.d.ts +9 -1
  185. package/dist/prefabs/FAQBotAgent.js +113 -47
  186. package/dist/prefabs/FAQBotAgent.js.map +1 -1
  187. package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
  188. package/dist/prefabs/InfoGathererAgent.js +67 -58
  189. package/dist/prefabs/InfoGathererAgent.js.map +1 -1
  190. package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
  191. package/dist/prefabs/ReceptionistAgent.js +39 -31
  192. package/dist/prefabs/ReceptionistAgent.js.map +1 -1
  193. package/dist/prefabs/SurveyAgent.d.ts +22 -4
  194. package/dist/prefabs/SurveyAgent.js +84 -68
  195. package/dist/prefabs/SurveyAgent.js.map +1 -1
  196. package/dist/relay/Action.d.ts +44 -21
  197. package/dist/relay/Action.js +75 -17
  198. package/dist/relay/Action.js.map +1 -1
  199. package/dist/relay/Call.d.ts +312 -47
  200. package/dist/relay/Call.js +369 -18
  201. package/dist/relay/Call.js.map +1 -1
  202. package/dist/relay/Deferred.js.map +1 -1
  203. package/dist/relay/Message.d.ts +26 -5
  204. package/dist/relay/Message.js +36 -6
  205. package/dist/relay/Message.js.map +1 -1
  206. package/dist/relay/RelayClient.d.ts +44 -17
  207. package/dist/relay/RelayClient.js +175 -65
  208. package/dist/relay/RelayClient.js.map +1 -1
  209. package/dist/relay/RelayError.d.ts +14 -0
  210. package/dist/relay/RelayError.js +15 -0
  211. package/dist/relay/RelayError.js.map +1 -1
  212. package/dist/relay/RelayEvent.d.ts +96 -65
  213. package/dist/relay/RelayEvent.js +85 -56
  214. package/dist/relay/RelayEvent.js.map +1 -1
  215. package/dist/relay/closedSets.d.ts +111 -0
  216. package/dist/relay/closedSets.js +83 -0
  217. package/dist/relay/closedSets.js.map +1 -0
  218. package/dist/relay/index.d.ts +3 -1
  219. package/dist/relay/index.js +1 -0
  220. package/dist/relay/index.js.map +1 -1
  221. package/dist/relay/normalize.js.map +1 -1
  222. package/dist/relay/protocol.types.generated.d.ts +1195 -0
  223. package/dist/relay/protocol.types.generated.js +8 -0
  224. package/dist/relay/protocol.types.generated.js.map +1 -0
  225. package/dist/relay/types.d.ts +73 -42
  226. package/dist/rest/HttpClient.d.ts +36 -8
  227. package/dist/rest/HttpClient.js +233 -40
  228. package/dist/rest/HttpClient.js.map +1 -1
  229. package/dist/rest/RequestOptions.d.ts +110 -0
  230. package/dist/rest/RequestOptions.js +113 -0
  231. package/dist/rest/RequestOptions.js.map +1 -0
  232. package/dist/rest/RestError.d.ts +52 -6
  233. package/dist/rest/RestError.js +89 -5
  234. package/dist/rest/RestError.js.map +1 -1
  235. package/dist/rest/base/CrudResource.d.ts +16 -26
  236. package/dist/rest/base/CrudResource.js +19 -33
  237. package/dist/rest/base/CrudResource.js.map +1 -1
  238. package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
  239. package/dist/rest/base/CrudWithAddresses.js +2 -2
  240. package/dist/rest/base/CrudWithAddresses.js.map +1 -1
  241. package/dist/rest/base/FabricResource.d.ts +15 -0
  242. package/dist/rest/base/FabricResource.js +16 -0
  243. package/dist/rest/base/FabricResource.js.map +1 -0
  244. package/dist/rest/base/ReadResource.d.ts +62 -0
  245. package/dist/rest/base/ReadResource.js +69 -0
  246. package/dist/rest/base/ReadResource.js.map +1 -0
  247. package/dist/rest/callHandler.d.ts +5 -2
  248. package/dist/rest/callHandler.js +4 -1
  249. package/dist/rest/callHandler.js.map +1 -1
  250. package/dist/rest/index.d.ts +18 -77
  251. package/dist/rest/index.js +47 -120
  252. package/dist/rest/index.js.map +1 -1
  253. package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
  254. package/dist/rest/namespaces/_client_tree_generated.js +171 -0
  255. package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
  256. package/dist/rest/namespaces/addresses.d.ts +3 -42
  257. package/dist/rest/namespaces/addresses.js +3 -50
  258. package/dist/rest/namespaces/addresses.js.map +1 -1
  259. package/dist/rest/namespaces/calling.d.ts +6 -378
  260. package/dist/rest/namespaces/calling.js +6 -473
  261. package/dist/rest/namespaces/calling.js.map +1 -1
  262. package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
  263. package/dist/rest/namespaces/calling.resources.generated.js +477 -0
  264. package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
  265. package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
  266. package/dist/rest/namespaces/calling.types.generated.js +8 -0
  267. package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
  268. package/dist/rest/namespaces/chat.d.ts +4 -18
  269. package/dist/rest/namespaces/chat.js +4 -21
  270. package/dist/rest/namespaces/chat.js.map +1 -1
  271. package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
  272. package/dist/rest/namespaces/chat.resources.generated.js +29 -0
  273. package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
  274. package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
  275. package/dist/rest/namespaces/chat.types.generated.js +8 -0
  276. package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
  277. package/dist/rest/namespaces/datasphere.d.ts +6 -62
  278. package/dist/rest/namespaces/datasphere.js +6 -72
  279. package/dist/rest/namespaces/datasphere.js.map +1 -1
  280. package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
  281. package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
  282. package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
  283. package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
  284. package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
  285. package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
  286. package/dist/rest/namespaces/fabric.d.ts +11 -327
  287. package/dist/rest/namespaces/fabric.js +14 -439
  288. package/dist/rest/namespaces/fabric.js.map +1 -1
  289. package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
  290. package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
  291. package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
  292. package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
  293. package/dist/rest/namespaces/fabric.types.generated.js +8 -0
  294. package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
  295. package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
  296. package/dist/rest/namespaces/fax.resources.generated.js +14 -0
  297. package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
  298. package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
  299. package/dist/rest/namespaces/fax.types.generated.js +8 -0
  300. package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
  301. package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
  302. package/dist/rest/namespaces/imported-numbers.js +3 -21
  303. package/dist/rest/namespaces/imported-numbers.js.map +1 -1
  304. package/dist/rest/namespaces/logs.d.ts +10 -101
  305. package/dist/rest/namespaces/logs.js +10 -128
  306. package/dist/rest/namespaces/logs.js.map +1 -1
  307. package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
  308. package/dist/rest/namespaces/logs.resources.generated.js +17 -0
  309. package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
  310. package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
  311. package/dist/rest/namespaces/logs.types.generated.js +8 -0
  312. package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
  313. package/dist/rest/namespaces/lookup.d.ts +3 -25
  314. package/dist/rest/namespaces/lookup.js +3 -27
  315. package/dist/rest/namespaces/lookup.js.map +1 -1
  316. package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
  317. package/dist/rest/namespaces/message.resources.generated.js +14 -0
  318. package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
  319. package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
  320. package/dist/rest/namespaces/message.types.generated.js +8 -0
  321. package/dist/rest/namespaces/message.types.generated.js.map +1 -0
  322. package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
  323. package/dist/rest/namespaces/messages.resources.generated.js +44 -0
  324. package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
  325. package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
  326. package/dist/rest/namespaces/messages.types.generated.js +8 -0
  327. package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
  328. package/dist/rest/namespaces/mfa.d.ts +3 -42
  329. package/dist/rest/namespaces/mfa.js +3 -49
  330. package/dist/rest/namespaces/mfa.js.map +1 -1
  331. package/dist/rest/namespaces/number-groups.d.ts +3 -45
  332. package/dist/rest/namespaces/number-groups.js +3 -53
  333. package/dist/rest/namespaces/number-groups.js.map +1 -1
  334. package/dist/rest/namespaces/phone-numbers.d.ts +8 -196
  335. package/dist/rest/namespaces/phone-numbers.js +8 -230
  336. package/dist/rest/namespaces/phone-numbers.js.map +1 -1
  337. package/dist/rest/namespaces/project.d.ts +6 -42
  338. package/dist/rest/namespaces/project.js +6 -51
  339. package/dist/rest/namespaces/project.js.map +1 -1
  340. package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
  341. package/dist/rest/namespaces/project.resources.generated.js +44 -0
  342. package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
  343. package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
  344. package/dist/rest/namespaces/project.types.generated.js +8 -0
  345. package/dist/rest/namespaces/project.types.generated.js.map +1 -0
  346. package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
  347. package/dist/rest/namespaces/projects.resources.generated.js +25 -0
  348. package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
  349. package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
  350. package/dist/rest/namespaces/projects.types.generated.js +8 -0
  351. package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
  352. package/dist/rest/namespaces/pubsub.d.ts +4 -18
  353. package/dist/rest/namespaces/pubsub.js +4 -21
  354. package/dist/rest/namespaces/pubsub.js.map +1 -1
  355. package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
  356. package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
  357. package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
  358. package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
  359. package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
  360. package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
  361. package/dist/rest/namespaces/queues.d.ts +3 -38
  362. package/dist/rest/namespaces/queues.js +3 -44
  363. package/dist/rest/namespaces/queues.js.map +1 -1
  364. package/dist/rest/namespaces/recordings.d.ts +3 -34
  365. package/dist/rest/namespaces/recordings.js +3 -40
  366. package/dist/rest/namespaces/recordings.js.map +1 -1
  367. package/dist/rest/namespaces/registry.d.ts +6 -137
  368. package/dist/rest/namespaces/registry.js +6 -173
  369. package/dist/rest/namespaces/registry.js.map +1 -1
  370. package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
  371. package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
  372. package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
  373. package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
  374. package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
  375. package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
  376. package/dist/rest/namespaces/short-codes.d.ts +3 -35
  377. package/dist/rest/namespaces/short-codes.js +3 -41
  378. package/dist/rest/namespaces/short-codes.js.map +1 -1
  379. package/dist/rest/namespaces/sip-profile.d.ts +3 -24
  380. package/dist/rest/namespaces/sip-profile.js +3 -29
  381. package/dist/rest/namespaces/sip-profile.js.map +1 -1
  382. package/dist/rest/namespaces/verified-callers.d.ts +3 -29
  383. package/dist/rest/namespaces/verified-callers.js +3 -34
  384. package/dist/rest/namespaces/verified-callers.js.map +1 -1
  385. package/dist/rest/namespaces/video.d.ts +10 -227
  386. package/dist/rest/namespaces/video.js +10 -288
  387. package/dist/rest/namespaces/video.js.map +1 -1
  388. package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
  389. package/dist/rest/namespaces/video.resources.generated.js +171 -0
  390. package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
  391. package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
  392. package/dist/rest/namespaces/video.types.generated.js +8 -0
  393. package/dist/rest/namespaces/video.types.generated.js.map +1 -0
  394. package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
  395. package/dist/rest/namespaces/voice.resources.generated.js +17 -0
  396. package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
  397. package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
  398. package/dist/rest/namespaces/voice.types.generated.js +8 -0
  399. package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
  400. package/dist/rest/pagination.d.ts +5 -1
  401. package/dist/rest/pagination.js +40 -20
  402. package/dist/rest/pagination.js.map +1 -1
  403. package/dist/rest/types.d.ts +21 -3
  404. package/dist/schema.json +299 -98
  405. package/dist/skills/SkillBase.d.ts +111 -21
  406. package/dist/skills/SkillBase.js +100 -17
  407. package/dist/skills/SkillBase.js.map +1 -1
  408. package/dist/skills/SkillManager.d.ts +66 -13
  409. package/dist/skills/SkillManager.js +101 -20
  410. package/dist/skills/SkillManager.js.map +1 -1
  411. package/dist/skills/SkillName.d.ts +44 -0
  412. package/dist/skills/SkillName.js +2 -0
  413. package/dist/skills/SkillName.js.map +1 -0
  414. package/dist/skills/SkillRegistry.d.ts +22 -11
  415. package/dist/skills/SkillRegistry.js +47 -17
  416. package/dist/skills/SkillRegistry.js.map +1 -1
  417. package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
  418. package/dist/skills/builtin/api_ninjas_trivia.js +18 -6
  419. package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
  420. package/dist/skills/builtin/ask_claude.d.ts +14 -4
  421. package/dist/skills/builtin/ask_claude.js +36 -14
  422. package/dist/skills/builtin/ask_claude.js.map +1 -1
  423. package/dist/skills/builtin/claude_skills.d.ts +3 -1
  424. package/dist/skills/builtin/claude_skills.js +19 -15
  425. package/dist/skills/builtin/claude_skills.js.map +1 -1
  426. package/dist/skills/builtin/custom_skills.d.ts +10 -3
  427. package/dist/skills/builtin/custom_skills.js +26 -9
  428. package/dist/skills/builtin/custom_skills.js.map +1 -1
  429. package/dist/skills/builtin/datasphere.d.ts +5 -3
  430. package/dist/skills/builtin/datasphere.js +21 -22
  431. package/dist/skills/builtin/datasphere.js.map +1 -1
  432. package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
  433. package/dist/skills/builtin/datasphere_serverless.js +17 -6
  434. package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
  435. package/dist/skills/builtin/datetime.d.ts +3 -1
  436. package/dist/skills/builtin/datetime.js +11 -7
  437. package/dist/skills/builtin/datetime.js.map +1 -1
  438. package/dist/skills/builtin/google_maps.d.ts +29 -14
  439. package/dist/skills/builtin/google_maps.js +89 -269
  440. package/dist/skills/builtin/google_maps.js.map +1 -1
  441. package/dist/skills/builtin/index.d.ts +8 -6
  442. package/dist/skills/builtin/index.js +8 -6
  443. package/dist/skills/builtin/index.js.map +1 -1
  444. package/dist/skills/builtin/info_gatherer.d.ts +4 -2
  445. package/dist/skills/builtin/info_gatherer.js +20 -12
  446. package/dist/skills/builtin/info_gatherer.js.map +1 -1
  447. package/dist/skills/builtin/joke.d.ts +16 -6
  448. package/dist/skills/builtin/joke.js +54 -37
  449. package/dist/skills/builtin/joke.js.map +1 -1
  450. package/dist/skills/builtin/math.d.ts +3 -1
  451. package/dist/skills/builtin/math.js +14 -9
  452. package/dist/skills/builtin/math.js.map +1 -1
  453. package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
  454. package/dist/skills/builtin/mcp_gateway.js +77 -46
  455. package/dist/skills/builtin/mcp_gateway.js.map +1 -1
  456. package/dist/skills/builtin/native_vector_search.d.ts +19 -5
  457. package/dist/skills/builtin/native_vector_search.js +179 -61
  458. package/dist/skills/builtin/native_vector_search.js.map +1 -1
  459. package/dist/skills/builtin/play_background_file.d.ts +21 -15
  460. package/dist/skills/builtin/play_background_file.js +43 -122
  461. package/dist/skills/builtin/play_background_file.js.map +1 -1
  462. package/dist/skills/builtin/spider.d.ts +42 -4
  463. package/dist/skills/builtin/spider.js +277 -104
  464. package/dist/skills/builtin/spider.js.map +1 -1
  465. package/dist/skills/builtin/swml_transfer.d.ts +14 -3
  466. package/dist/skills/builtin/swml_transfer.js +45 -24
  467. package/dist/skills/builtin/swml_transfer.js.map +1 -1
  468. package/dist/skills/builtin/weather_api.d.ts +24 -13
  469. package/dist/skills/builtin/weather_api.js +38 -30
  470. package/dist/skills/builtin/weather_api.js.map +1 -1
  471. package/dist/skills/builtin/web_search.d.ts +48 -10
  472. package/dist/skills/builtin/web_search.js +294 -100
  473. package/dist/skills/builtin/web_search.js.map +1 -1
  474. package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
  475. package/dist/skills/builtin/wikipedia_search.js +14 -13
  476. package/dist/skills/builtin/wikipedia_search.js.map +1 -1
  477. package/dist/skills/index.d.ts +3 -2
  478. package/dist/skills/index.js +1 -1
  479. package/dist/skills/index.js.map +1 -1
  480. package/dist/swml_verbs_generated.d.ts +2824 -0
  481. package/dist/swml_verbs_generated.js +12 -0
  482. package/dist/swml_verbs_generated.js.map +1 -0
  483. package/dist/types.d.ts +59 -6
  484. package/dist/web.d.ts +27 -0
  485. package/dist/web.js +20 -0
  486. package/dist/web.js.map +1 -0
  487. package/docs/agent-guide.md +1034 -0
  488. package/docs/ai_chat.md +560 -0
  489. package/docs/api-reference.md +3641 -0
  490. package/docs/architecture.md +846 -0
  491. package/docs/bedrock_agent.md +411 -0
  492. package/docs/cli-guide.md +403 -0
  493. package/docs/cloud_functions_guide.md +399 -0
  494. package/docs/configuration.md +548 -0
  495. package/docs/contexts-guide.md +884 -0
  496. package/docs/datamap-guide.md +1207 -0
  497. package/docs/developer_pain_points.md +548 -0
  498. package/docs/llm_parameters.md +298 -0
  499. package/docs/mcp_gateway_reference.md +354 -0
  500. package/docs/mcp_integration.md +162 -0
  501. package/docs/pgi_agent_guide.md +1820 -0
  502. package/docs/prefabs-guide.md +815 -0
  503. package/docs/programmatically_governed_inference.md +301 -0
  504. package/docs/sdk_features.md +501 -0
  505. package/docs/security.md +559 -0
  506. package/docs/serverless-guide.md +520 -0
  507. package/docs/skills-guide.md +1223 -0
  508. package/docs/skills-system.md +405 -0
  509. package/docs/skills_parameter_schema.md +417 -0
  510. package/docs/swaig-reference.md +1986 -0
  511. package/docs/swml_service_guide.md +573 -0
  512. package/docs/third_party_skills.md +410 -0
  513. package/docs/web_service.md +666 -0
  514. package/examples/README.md +202 -0
  515. package/examples/advanced-datamap.ts +108 -0
  516. package/examples/advanced-dynamic-config.ts +70 -0
  517. package/examples/auto-vivified.ts +95 -0
  518. package/examples/call-flow.ts +65 -0
  519. package/examples/comprehensive-dynamic.ts +125 -0
  520. package/examples/contexts-steps.ts +65 -0
  521. package/examples/custom-path.ts +45 -0
  522. package/examples/datamap-tools.ts +51 -0
  523. package/examples/datasphere-multi-instance.ts +66 -0
  524. package/examples/datasphere-serverless-env.ts +87 -0
  525. package/examples/datasphere-webhook-env.ts +65 -0
  526. package/examples/datasphere.ts +56 -0
  527. package/examples/declarative.ts +100 -0
  528. package/examples/dynamic-config.ts +54 -0
  529. package/examples/dynamic-info-gatherer.ts +69 -0
  530. package/examples/dynamic-swml-service.ts +67 -0
  531. package/examples/gather-info.ts +95 -0
  532. package/examples/gather-per-question-functions-demo.ts +139 -0
  533. package/examples/joke-agent.ts +34 -0
  534. package/examples/kubernetes-agent.ts +45 -0
  535. package/examples/llm-params.ts +75 -0
  536. package/examples/mcp-agent.ts +89 -0
  537. package/examples/mcp-gateway.ts +81 -0
  538. package/examples/multi-agent.ts +80 -0
  539. package/examples/multi-endpoint.ts +79 -0
  540. package/examples/pgi/case-domain.ts +114 -0
  541. package/examples/pgi/serve.ts +16 -0
  542. package/examples/pgi/support-agent.ts +265 -0
  543. package/examples/pom-prompt.ts +70 -0
  544. package/examples/prefab-concierge.ts +42 -0
  545. package/examples/prefab-faq.ts +58 -0
  546. package/examples/prefab-info-gatherer.ts +33 -0
  547. package/examples/prefab-receptionist.ts +36 -0
  548. package/examples/prefab-survey.ts +69 -0
  549. package/examples/quickstart-agent.ts +29 -0
  550. package/examples/quickstart-relay.ts +25 -0
  551. package/examples/quickstart-rest.ts +25 -0
  552. package/examples/record-call.ts +65 -0
  553. package/examples/relay-demo.ts +33 -0
  554. package/examples/room-and-sip.ts +93 -0
  555. package/examples/serverless-lambda.ts +43 -0
  556. package/examples/session-state.ts +83 -0
  557. package/examples/simple-agent.ts +36 -0
  558. package/examples/simple-static.ts +29 -0
  559. package/examples/skills-demo.ts +41 -0
  560. package/examples/step-function-inheritance-demo.ts +124 -0
  561. package/examples/swaig-features.ts +193 -0
  562. package/examples/swml-service-routing.ts +66 -0
  563. package/examples/swml-service.ts +38 -0
  564. package/examples/swmlservice_ai_sidecar.ts +104 -0
  565. package/examples/swmlservice_swaig_standalone.ts +79 -0
  566. package/examples/tap.ts +67 -0
  567. package/examples/typed-tools.ts +68 -0
  568. package/examples/verb-methods.ts +45 -0
  569. package/examples/web-search-multi-instance.ts +75 -0
  570. package/examples/web-search.ts +38 -0
  571. package/examples/wikipedia.ts +36 -0
  572. package/livewire/README.md +164 -0
  573. package/livewire/docs/migration-guide.md +251 -0
  574. package/livewire/examples/livewire-basic-agent.ts +74 -0
  575. package/livewire/examples/livewire-handoff.ts +196 -0
  576. package/livewire/examples/livewire-multi-tool.ts +121 -0
  577. package/package.json +85 -13
  578. package/relay/README.md +101 -0
  579. package/relay/docs/call-methods.md +622 -0
  580. package/relay/docs/client-reference.md +281 -0
  581. package/relay/docs/events.md +193 -0
  582. package/relay/docs/getting-started.md +221 -0
  583. package/relay/docs/guide.md +386 -0
  584. package/relay/docs/messaging.md +246 -0
  585. package/relay/examples/relay-inbound.ts +66 -0
  586. package/relay/examples/relay-messaging.ts +74 -0
  587. package/relay/examples/relay-outbound.ts +76 -0
  588. package/rest/README.md +141 -0
  589. package/rest/docs/calling.md +313 -0
  590. package/rest/docs/client-reference.md +149 -0
  591. package/rest/docs/fabric.md +192 -0
  592. package/rest/docs/getting-started.md +138 -0
  593. package/rest/docs/guide.md +421 -0
  594. package/rest/docs/namespaces.md +367 -0
  595. package/rest/docs/phone-binding.md +116 -0
  596. package/rest/examples/rest-10dlc-registration.ts +177 -0
  597. package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
  598. package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
  599. package/rest/examples/rest-calling-play-and-record.ts +98 -0
  600. package/rest/examples/rest-client.ts +59 -0
  601. package/rest/examples/rest-datasphere-search.ts +81 -0
  602. package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
  603. package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
  604. package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
  605. package/rest/examples/rest-manage-resources.ts +64 -0
  606. package/rest/examples/rest-phone-number-management.ts +200 -0
  607. package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
  608. package/rest/examples/rest-video-rooms.ts +186 -0
  609. package/tutorial/fred/fred.ts +218 -0
  610. package/tutorial/fred/tutorial/01-introduction.md +141 -0
  611. package/tutorial/fred/tutorial/02-setup.md +304 -0
  612. package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
  613. package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
  614. package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
  615. package/tutorial/fred/tutorial/06-running-testing.md +642 -0
  616. package/tutorial/fred/tutorial/README.md +56 -0
  617. package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
  618. package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
  619. package/tutorial/full-guardrails-agent/handlers.ts +436 -0
  620. package/tutorial/full-guardrails-agent/penny.ts +305 -0
  621. package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
  622. package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
  623. package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
  624. package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
  625. package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
  626. package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
  627. package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
  628. package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
  629. package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
  630. package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
  631. package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
  632. package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
  633. package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
  634. package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
  635. package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
  636. package/tutorial/full-guardrails-agent/workflow.ts +219 -0
  637. package/tutorial/multi_agents/README.md +175 -0
  638. package/tutorial/multi_agents/advanced_agent.ts +395 -0
  639. package/tutorial/multi_agents/extending_agents.ts +641 -0
  640. package/tutorial/multi_agents/knowledge.ts +59 -0
  641. package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
  642. package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
  643. package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
  644. package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
  645. package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
  646. package/tutorial/multi_agents/pc_builder.ts +529 -0
  647. package/tutorial/multi_agents/sales_agent.ts +88 -0
  648. package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
  649. package/tutorial/multi_agents/sales_knowledge.md +139 -0
  650. package/tutorial/multi_agents/support_knowledge.md +256 -0
  651. package/dist/cli/mock-data.d.ts +0 -37
  652. package/dist/cli/mock-data.js +0 -80
  653. package/dist/cli/mock-data.js.map +0 -1
  654. package/dist/generateVerbTypes.d.ts +0 -11
  655. package/dist/generateVerbTypes.js +0 -265
  656. package/dist/generateVerbTypes.js.map +0 -1
  657. package/dist/rest/namespaces/compat.d.ts +0 -585
  658. package/dist/rest/namespaces/compat.js +0 -735
  659. package/dist/rest/namespaces/compat.js.map +0 -1
@@ -5,9 +5,12 @@
5
5
  * They define tools, prompt sections, hints, and global data.
6
6
  */
7
7
  import type { SwaigHandler } from '../SwaigFunction.js';
8
+ import type { FillerPhrases, SemanticGate } from '../SemanticGate.js';
9
+ import type { SwaigRequest } from '../SwaigContracts.js';
8
10
  import type { FunctionResult } from '../FunctionResult.js';
9
11
  import type { AgentBase } from '../AgentBase.js';
10
12
  import { type Logger } from '../Logger.js';
13
+ import type { ToolParameters, ToolArgs } from '../ParameterSchema.js';
11
14
  /** Configuration key-value pairs passed to a skill at construction time. */
12
15
  export interface SkillConfig {
13
16
  [key: string]: unknown;
@@ -24,7 +27,11 @@ export interface SkillToolDefinition {
24
27
  handler: SwaigHandler;
25
28
  /** Whether the tool requires secure (authenticated) invocation. */
26
29
  secure?: boolean;
27
- /** Filler phrases spoken while the tool executes, keyed by language. */
30
+ /**
31
+ * Phrases the AI says while the tool runs, keyed by language code, `"auto"`
32
+ * or `"default"`; an entry may also be a list of phrases, a wait script
33
+ * (the type predates wait scripts, so one needs a cast).
34
+ */
28
35
  fillers?: Record<string, string[]>;
29
36
  /** List of parameter names that are required. */
30
37
  required?: string[];
@@ -39,7 +46,74 @@ export interface SkillToolDefinition {
39
46
  * The flag is serialised as `"is_hangup_hook": true` in the SWAIG JSON.
40
47
  */
41
48
  isHangupHook?: boolean;
49
+ /**
50
+ * Semantic gates on the tool: yes/no preconditions a decision model checks
51
+ * right before the platform runs it (see {@link SemanticGate}). They win
52
+ * over gates in the skill's `swaig_fields`.
53
+ */
54
+ gates?: ReadonlyArray<SemanticGate | Record<string, unknown>>;
55
+ /** Phrases the AI says while the gates are checked, shaped like `fillers`. */
56
+ gate_fillers?: FillerPhrases;
42
57
  }
58
+ /**
59
+ * Build a {@link SkillToolDefinition} whose `handler` args are *inferred* from
60
+ * its `parameters` schema + `required` list — the `getTools()`-level counterpart
61
+ * to {@link ../SWMLService.SWMLService.defineTool}'s typed-tool inference.
62
+ *
63
+ * A skill returns its tools as a plain `SkillToolDefinition[]`, and that
64
+ * interface types `handler` as the loose {@link SwaigHandler} (`args:
65
+ * Record<string, unknown>`) — so a hand-written entry's handler sees untyped
66
+ * args and must reach for `args['query'] as string`. Wrapping the entry in
67
+ * `defineSkillTool` captures `parameters` (`P`) and `required` (`R`) via `const`
68
+ * type parameters and feeds them through {@link ToolArgs}, so the handler's
69
+ * `args` is precise: a `required` string prop is `args.query: string`, an `enum`
70
+ * prop narrows to its literal union, optional props are `?`. It then erases the
71
+ * typed handler back to {@link SwaigHandler} at a single boundary and returns an
72
+ * ordinary `SkillToolDefinition`, so the result drops straight into a
73
+ * `getTools()` array with no other change.
74
+ *
75
+ * The inferred `args` is a **compile-time authoring convenience only** — at
76
+ * runtime `args` is still whatever JSON the model extracted, so a handler that
77
+ * cares (most do, since the model can emit an empty/typeless value even for a
78
+ * `required` param) keeps its defensive `typeof`/`.trim()` narrowing. The wire
79
+ * output is byte-identical to the equivalent hand-written entry (drift/emission
80
+ * unaffected); this is purely an author-side type gain.
81
+ *
82
+ * @example
83
+ * ```ts
84
+ * import { SkillBase, defineSkillTool, FunctionResult, type SkillToolDefinition } from '@signalwire/sdk';
85
+ *
86
+ * class WikiSkill extends SkillBase {
87
+ * static override SKILL_NAME = 'wiki';
88
+ * static override SKILL_DESCRIPTION = 'Search Wikipedia.';
89
+ *
90
+ * override getTools(): SkillToolDefinition[] {
91
+ * return [
92
+ * defineSkillTool({
93
+ * name: 'search_wiki',
94
+ * description: 'Search Wikipedia for a topic',
95
+ * parameters: { query: { type: 'string', description: 'The search term' } },
96
+ * required: ['query'],
97
+ * handler: async (args) => {
98
+ * // args.query is `string` (required) — no cast needed
99
+ * if (!args.query.trim()) return new FunctionResult('Provide a query.');
100
+ * return new FunctionResult(await this.searchWiki(args.query.trim()));
101
+ * },
102
+ * }),
103
+ * ];
104
+ * }
105
+ *
106
+ * private async searchWiki(query: string): Promise<string> {
107
+ * return `results for ${query}`;
108
+ * }
109
+ * }
110
+ * ```
111
+ */
112
+ export declare function defineSkillTool<const P extends ToolParameters = ToolParameters, const R extends readonly PropertyKey[] = []>(toolDef: Omit<SkillToolDefinition, 'parameters' | 'required' | 'handler'> & {
113
+ parameters?: P;
114
+ required?: R;
115
+ handler: (args: ToolArgs<P, R>, rawData: SwaigRequest, agent?: AgentBase) => FunctionResult | Record<string, unknown> | string | Promise<FunctionResult | Record<string, unknown> | string>;
116
+ }): SkillToolDefinition;
43
117
  /** A section of prompt content injected into the agent's system prompt by a skill. */
44
118
  export interface SkillPromptSection {
45
119
  /** Section heading displayed in the prompt. */
@@ -63,7 +137,7 @@ export interface ParameterSchemaEntry {
63
137
  required?: boolean;
64
138
  /** Whether the parameter should be hidden from user-facing output (e.g., API keys). */
65
139
  hidden?: boolean;
66
- /** Environment variable that can supply this parameter's value. */
140
+ /** Environment variable a configuration tool can read this value from. A hint only: the SDK doesn't read it, so the skill gets the value from its params. */
67
141
  env_var?: string;
68
142
  /** Allowed values for the parameter. */
69
143
  enum?: unknown[];
@@ -85,13 +159,14 @@ export interface ParameterSchemaEntry {
85
159
  * - **Speech hints** via `getHints()`
86
160
  * - **Global data** seeded into each call via `getGlobalData()`
87
161
  *
88
- * Skills are added to an agent with `agent.addSkill('name', config)` and the
89
- * {@link SkillManager} calls `setAgent()` + `setup()` in sequence before the
90
- * agent starts serving requests.
162
+ * Skills are added to an agent with `agent.addSkill(new MySkill(config))`, or
163
+ * by registered name with `agent.addSkillByName('name', config)`. The agent
164
+ * calls `setAgent()`, and the {@link SkillManager} then calls `setup()`,
165
+ * before the skill's tools are registered.
91
166
  *
92
167
  * @example Custom skill
93
168
  * ```ts
94
- * import { SkillBase, FunctionResult, type SkillToolDefinition } from '@signalwire/sdk';
169
+ * import { AgentBase, SkillBase, FunctionResult, type SkillToolDefinition } from '@signalwire/sdk';
95
170
  *
96
171
  * export class GreetingSkill extends SkillBase {
97
172
  * static override SKILL_NAME = 'greeting';
@@ -108,7 +183,8 @@ export interface ParameterSchemaEntry {
108
183
  * }
109
184
  *
110
185
  * // In your agent:
111
- * agent.addSkill(new GreetingSkill({ message: 'Howdy!' }));
186
+ * const agent = new AgentBase({ name: 'demo', route: '/' });
187
+ * await agent.addSkill(new GreetingSkill({ message: 'Howdy!' }));
112
188
  * ```
113
189
  *
114
190
  * @see {@link SkillManager}
@@ -119,7 +195,7 @@ export declare abstract class SkillBase {
119
195
  /**
120
196
  * Unique skill name. Subclasses MUST override with a non-empty string.
121
197
  *
122
- * Python parity: `SKILL_NAME: str = None` at `core/skill_base.py:23`.
198
+ * Python equivalent:`SKILL_NAME: str = None` at `core/skill_base.py:23`.
123
199
  * Python raises `ValueError` in `__init__` when this is left as `None`;
124
200
  * TS throws at construction when this is left as the empty default.
125
201
  */
@@ -127,19 +203,19 @@ export declare abstract class SkillBase {
127
203
  /**
128
204
  * Human-readable description of the skill. Subclasses MUST override.
129
205
  *
130
- * Python parity: `SKILL_DESCRIPTION: str = None` at `core/skill_base.py:24`.
206
+ * Python equivalent:`SKILL_DESCRIPTION: str = None` at `core/skill_base.py:24`.
131
207
  */
132
208
  static SKILL_DESCRIPTION: string;
133
209
  /**
134
210
  * Semantic version string. Subclasses may override; defaults to `"1.0.0"`.
135
211
  *
136
- * Python parity: `SKILL_VERSION: str = "1.0.0"` at `core/skill_base.py:25`.
212
+ * Python equivalent:`SKILL_VERSION: str = "1.0.0"` at `core/skill_base.py:25`.
137
213
  */
138
214
  static SKILL_VERSION: string;
139
215
  /**
140
216
  * Packages required by the skill, checked at load time by `validatePackages()`.
141
217
  *
142
- * Python parity: `REQUIRED_PACKAGES: List[str] = []` at `core/skill_base.py:26`.
218
+ * Python equivalent:`REQUIRED_PACKAGES: List[str] = []` at `core/skill_base.py:26`.
143
219
  * In TS these are npm package names importable via dynamic `import()`.
144
220
  */
145
221
  static REQUIRED_PACKAGES: readonly string[];
@@ -147,13 +223,13 @@ export declare abstract class SkillBase {
147
223
  * Environment variables required for the skill to function, checked at load
148
224
  * time by `validateEnvVars()`.
149
225
  *
150
- * Python parity: `REQUIRED_ENV_VARS: List[str] = []` at `core/skill_base.py:27`.
226
+ * Python equivalent:`REQUIRED_ENV_VARS: List[str] = []` at `core/skill_base.py:27`.
151
227
  */
152
228
  static REQUIRED_ENV_VARS: readonly string[];
153
229
  /**
154
230
  * Whether this skill type supports multiple simultaneous instances (e.g., with different tool_name).
155
231
  *
156
- * Python parity: `SUPPORTS_MULTIPLE_INSTANCES: bool = False` at `core/skill_base.py:30`.
232
+ * Python equivalent:`SUPPORTS_MULTIPLE_INSTANCES: bool = False` at `core/skill_base.py:30`.
157
233
  */
158
234
  static SUPPORTS_MULTIPLE_INSTANCES: boolean;
159
235
  /**
@@ -185,8 +261,12 @@ export declare abstract class SkillBase {
185
261
  * constructor. In the TypeScript SDK the SkillManager always calls
186
262
  * `setAgent()` before `setup()`, so subclasses can rely on `getAgent()` being
187
263
  * safe to call inside `setup()` and any method invoked after it.
264
+ *
265
+ * Readable by anyone holding the skill, so a test or an introspection tool can
266
+ * check which agent a skill was bound to. Subclasses that need a guaranteed
267
+ * non-null agent should still prefer the asserting {@link getAgent}.
188
268
  */
189
- protected agent?: AgentBase;
269
+ agent?: AgentBase;
190
270
  /**
191
271
  * Logger scoped to this skill. Python equivalent: `self.logger = get_logger(...)`
192
272
  * set in `SkillBase.__init__` so every subclass can call `self.logger.info(...)`.
@@ -196,7 +276,7 @@ export declare abstract class SkillBase {
196
276
  /**
197
277
  * Tools registered imperatively via `defineTool()`.
198
278
  *
199
- * Python parity: Python's `SkillBase.register_tools()` is a `@abstractmethod` that
279
+ * Python equivalent:Python's `SkillBase.register_tools()` is a `@abstractmethod` that
200
280
  * calls `self.agent.define_tool(...)` (or `self.define_tool(...)`) once per tool.
201
281
  * In TypeScript the tool pipeline is declarative (pull model): `SkillManager`
202
282
  * calls `getTools()` at SWML render time. Skills that want to build their tool
@@ -218,10 +298,20 @@ export declare abstract class SkillBase {
218
298
  * attached to an agent by the SkillManager).
219
299
  */
220
300
  protected getAgent(): AgentBase;
301
+ /**
302
+ * The configuration this skill was constructed with — the reference's public
303
+ * `self.params` (`core/skill_base.py:40`), read-only.
304
+ *
305
+ * `swaig_fields` is absent: the constructor pops it into {@link swaigFields},
306
+ * mirroring the reference's `self.swaig_fields = self.params.pop(...)`
307
+ * (`core/skill_base.py:44`). Use {@link getConfig} for a single typed key; this
308
+ * returns the whole map, which is what the reference attribute exposes.
309
+ */
310
+ get params(): Readonly<SkillConfig>;
221
311
  /**
222
312
  * Create a new skill instance.
223
313
  *
224
- * Python parity: `core/skill_base.py:32-43`.
314
+ * Python equivalent:`core/skill_base.py:32-43`.
225
315
  * Python `__init__` raises `ValueError` if `SKILL_NAME` or `SKILL_DESCRIPTION`
226
316
  * is left as `None` on the subclass. TS throws the equivalent when the static
227
317
  * defaults haven't been overridden.
@@ -243,7 +333,7 @@ export declare abstract class SkillBase {
243
333
  * `defineTool()`. Skills using the declarative pattern override this
244
334
  * method to return a static array built from their config.
245
335
  *
246
- * Python parity: replaces the `@abstractmethod register_tools()` contract
336
+ * Python equivalent:replaces the `@abstractmethod register_tools()` contract
247
337
  * — Python skills call `self.define_tool(...)` inside `register_tools()`;
248
338
  * TypeScript skills either call `this.defineTool(...)` in `setup()` (and
249
339
  * let the default `getTools()` return them) or override `getTools()`
@@ -255,7 +345,7 @@ export declare abstract class SkillBase {
255
345
  /**
256
346
  * Imperatively register a tool with this skill.
257
347
  *
258
- * Python parity: `core/skill_base.py:58` `def define_tool(self, **kwargs)`.
348
+ * Python equivalent:`core/skill_base.py:58` `def define_tool(self, **kwargs)`.
259
349
  * Merges `this.swaigFields` into the tool definition (explicit fields on
260
350
  * `toolDef` take precedence), then pushes the result into `_dynamicTools`
261
351
  * so the default `getTools()` returns it at SWML render time.
@@ -328,7 +418,7 @@ export declare abstract class SkillBase {
328
418
  * @param rawData - The raw request data containing global_data.
329
419
  * @returns The skill's stored data, or an empty object if not found.
330
420
  */
331
- getSkillData(rawData: Record<string, unknown>): Record<string, unknown>;
421
+ getSkillData(rawData: SwaigRequest): Record<string, unknown>;
332
422
  /**
333
423
  * Update this skill's namespaced data on a FunctionResult via updateGlobalData.
334
424
  * @param result - The FunctionResult to update.
@@ -344,7 +434,7 @@ export declare abstract class SkillBase {
344
434
  * Validate that all required environment variables declared on the skill class
345
435
  * are set in the current process environment.
346
436
  *
347
- * Python parity: `core/skill_base.py:103-110` reads `self.REQUIRED_ENV_VARS`
437
+ * Python equivalent:`core/skill_base.py:103-110` reads `self.REQUIRED_ENV_VARS`
348
438
  * directly. TS reads the same static from the class.
349
439
  *
350
440
  * Returns the list of missing variable names so callers can produce actionable
@@ -387,7 +477,7 @@ export declare abstract class SkillBase {
387
477
  /**
388
478
  * Validate that all required packages declared on the skill class can be imported.
389
479
  *
390
- * Python parity: `core/skill_base.py:112-124` reads `self.REQUIRED_PACKAGES`
480
+ * Python equivalent:`core/skill_base.py:112-124` reads `self.REQUIRED_PACKAGES`
391
481
  * directly and tries `importlib.import_module(pkg)` for each; TS does the
392
482
  * equivalent with a dynamic `import()`.
393
483
  *
@@ -6,6 +6,71 @@
6
6
  */
7
7
  import { randomBytes } from 'node:crypto';
8
8
  import { getLogger } from '../Logger.js';
9
+ /**
10
+ * Build a {@link SkillToolDefinition} whose `handler` args are *inferred* from
11
+ * its `parameters` schema + `required` list — the `getTools()`-level counterpart
12
+ * to {@link ../SWMLService.SWMLService.defineTool}'s typed-tool inference.
13
+ *
14
+ * A skill returns its tools as a plain `SkillToolDefinition[]`, and that
15
+ * interface types `handler` as the loose {@link SwaigHandler} (`args:
16
+ * Record<string, unknown>`) — so a hand-written entry's handler sees untyped
17
+ * args and must reach for `args['query'] as string`. Wrapping the entry in
18
+ * `defineSkillTool` captures `parameters` (`P`) and `required` (`R`) via `const`
19
+ * type parameters and feeds them through {@link ToolArgs}, so the handler's
20
+ * `args` is precise: a `required` string prop is `args.query: string`, an `enum`
21
+ * prop narrows to its literal union, optional props are `?`. It then erases the
22
+ * typed handler back to {@link SwaigHandler} at a single boundary and returns an
23
+ * ordinary `SkillToolDefinition`, so the result drops straight into a
24
+ * `getTools()` array with no other change.
25
+ *
26
+ * The inferred `args` is a **compile-time authoring convenience only** — at
27
+ * runtime `args` is still whatever JSON the model extracted, so a handler that
28
+ * cares (most do, since the model can emit an empty/typeless value even for a
29
+ * `required` param) keeps its defensive `typeof`/`.trim()` narrowing. The wire
30
+ * output is byte-identical to the equivalent hand-written entry (drift/emission
31
+ * unaffected); this is purely an author-side type gain.
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * import { SkillBase, defineSkillTool, FunctionResult, type SkillToolDefinition } from '@signalwire/sdk';
36
+ *
37
+ * class WikiSkill extends SkillBase {
38
+ * static override SKILL_NAME = 'wiki';
39
+ * static override SKILL_DESCRIPTION = 'Search Wikipedia.';
40
+ *
41
+ * override getTools(): SkillToolDefinition[] {
42
+ * return [
43
+ * defineSkillTool({
44
+ * name: 'search_wiki',
45
+ * description: 'Search Wikipedia for a topic',
46
+ * parameters: { query: { type: 'string', description: 'The search term' } },
47
+ * required: ['query'],
48
+ * handler: async (args) => {
49
+ * // args.query is `string` (required) — no cast needed
50
+ * if (!args.query.trim()) return new FunctionResult('Provide a query.');
51
+ * return new FunctionResult(await this.searchWiki(args.query.trim()));
52
+ * },
53
+ * }),
54
+ * ];
55
+ * }
56
+ *
57
+ * private async searchWiki(query: string): Promise<string> {
58
+ * return `results for ${query}`;
59
+ * }
60
+ * }
61
+ * ```
62
+ */
63
+ export function defineSkillTool(toolDef) {
64
+ return {
65
+ ...toolDef,
66
+ parameters: toolDef.parameters,
67
+ required: toolDef.required,
68
+ // Single type-erasure boundary: at runtime the handler is the ordinary
69
+ // (args: Record<string,unknown>, rawData) SwaigHandler; the inferred-args
70
+ // view is compile-time only (mirrors SWMLService.defineTool).
71
+ handler: toolDef.handler,
72
+ };
73
+ }
9
74
  /**
10
75
  * Abstract base class for agent skills.
11
76
  *
@@ -17,13 +82,14 @@ import { getLogger } from '../Logger.js';
17
82
  * - **Speech hints** via `getHints()`
18
83
  * - **Global data** seeded into each call via `getGlobalData()`
19
84
  *
20
- * Skills are added to an agent with `agent.addSkill('name', config)` and the
21
- * {@link SkillManager} calls `setAgent()` + `setup()` in sequence before the
22
- * agent starts serving requests.
85
+ * Skills are added to an agent with `agent.addSkill(new MySkill(config))`, or
86
+ * by registered name with `agent.addSkillByName('name', config)`. The agent
87
+ * calls `setAgent()`, and the {@link SkillManager} then calls `setup()`,
88
+ * before the skill's tools are registered.
23
89
  *
24
90
  * @example Custom skill
25
91
  * ```ts
26
- * import { SkillBase, FunctionResult, type SkillToolDefinition } from '@signalwire/sdk';
92
+ * import { AgentBase, SkillBase, FunctionResult, type SkillToolDefinition } from '@signalwire/sdk';
27
93
  *
28
94
  * export class GreetingSkill extends SkillBase {
29
95
  * static override SKILL_NAME = 'greeting';
@@ -40,7 +106,8 @@ import { getLogger } from '../Logger.js';
40
106
  * }
41
107
  *
42
108
  * // In your agent:
43
- * agent.addSkill(new GreetingSkill({ message: 'Howdy!' }));
109
+ * const agent = new AgentBase({ name: 'demo', route: '/' });
110
+ * await agent.addSkill(new GreetingSkill({ message: 'Howdy!' }));
44
111
  * ```
45
112
  *
46
113
  * @see {@link SkillManager}
@@ -51,7 +118,7 @@ export class SkillBase {
51
118
  /**
52
119
  * Unique skill name. Subclasses MUST override with a non-empty string.
53
120
  *
54
- * Python parity: `SKILL_NAME: str = None` at `core/skill_base.py:23`.
121
+ * Python equivalent:`SKILL_NAME: str = None` at `core/skill_base.py:23`.
55
122
  * Python raises `ValueError` in `__init__` when this is left as `None`;
56
123
  * TS throws at construction when this is left as the empty default.
57
124
  */
@@ -59,19 +126,19 @@ export class SkillBase {
59
126
  /**
60
127
  * Human-readable description of the skill. Subclasses MUST override.
61
128
  *
62
- * Python parity: `SKILL_DESCRIPTION: str = None` at `core/skill_base.py:24`.
129
+ * Python equivalent:`SKILL_DESCRIPTION: str = None` at `core/skill_base.py:24`.
63
130
  */
64
131
  static SKILL_DESCRIPTION = '';
65
132
  /**
66
133
  * Semantic version string. Subclasses may override; defaults to `"1.0.0"`.
67
134
  *
68
- * Python parity: `SKILL_VERSION: str = "1.0.0"` at `core/skill_base.py:25`.
135
+ * Python equivalent:`SKILL_VERSION: str = "1.0.0"` at `core/skill_base.py:25`.
69
136
  */
70
137
  static SKILL_VERSION = '1.0.0';
71
138
  /**
72
139
  * Packages required by the skill, checked at load time by `validatePackages()`.
73
140
  *
74
- * Python parity: `REQUIRED_PACKAGES: List[str] = []` at `core/skill_base.py:26`.
141
+ * Python equivalent:`REQUIRED_PACKAGES: List[str] = []` at `core/skill_base.py:26`.
75
142
  * In TS these are npm package names importable via dynamic `import()`.
76
143
  */
77
144
  static REQUIRED_PACKAGES = [];
@@ -79,13 +146,13 @@ export class SkillBase {
79
146
  * Environment variables required for the skill to function, checked at load
80
147
  * time by `validateEnvVars()`.
81
148
  *
82
- * Python parity: `REQUIRED_ENV_VARS: List[str] = []` at `core/skill_base.py:27`.
149
+ * Python equivalent:`REQUIRED_ENV_VARS: List[str] = []` at `core/skill_base.py:27`.
83
150
  */
84
151
  static REQUIRED_ENV_VARS = [];
85
152
  /**
86
153
  * Whether this skill type supports multiple simultaneous instances (e.g., with different tool_name).
87
154
  *
88
- * Python parity: `SUPPORTS_MULTIPLE_INSTANCES: bool = False` at `core/skill_base.py:30`.
155
+ * Python equivalent:`SUPPORTS_MULTIPLE_INSTANCES: bool = False` at `core/skill_base.py:30`.
89
156
  */
90
157
  static SUPPORTS_MULTIPLE_INSTANCES = false;
91
158
  /**
@@ -142,6 +209,10 @@ export class SkillBase {
142
209
  * constructor. In the TypeScript SDK the SkillManager always calls
143
210
  * `setAgent()` before `setup()`, so subclasses can rely on `getAgent()` being
144
211
  * safe to call inside `setup()` and any method invoked after it.
212
+ *
213
+ * Readable by anyone holding the skill, so a test or an introspection tool can
214
+ * check which agent a skill was bound to. Subclasses that need a guaranteed
215
+ * non-null agent should still prefer the asserting {@link getAgent}.
145
216
  */
146
217
  agent;
147
218
  /**
@@ -153,7 +224,7 @@ export class SkillBase {
153
224
  /**
154
225
  * Tools registered imperatively via `defineTool()`.
155
226
  *
156
- * Python parity: Python's `SkillBase.register_tools()` is a `@abstractmethod` that
227
+ * Python equivalent:Python's `SkillBase.register_tools()` is a `@abstractmethod` that
157
228
  * calls `self.agent.define_tool(...)` (or `self.define_tool(...)`) once per tool.
158
229
  * In TypeScript the tool pipeline is declarative (pull model): `SkillManager`
159
230
  * calls `getTools()` at SWML render time. Skills that want to build their tool
@@ -182,10 +253,22 @@ export class SkillBase {
182
253
  }
183
254
  return this.agent;
184
255
  }
256
+ /**
257
+ * The configuration this skill was constructed with — the reference's public
258
+ * `self.params` (`core/skill_base.py:40`), read-only.
259
+ *
260
+ * `swaig_fields` is absent: the constructor pops it into {@link swaigFields},
261
+ * mirroring the reference's `self.swaig_fields = self.params.pop(...)`
262
+ * (`core/skill_base.py:44`). Use {@link getConfig} for a single typed key; this
263
+ * returns the whole map, which is what the reference attribute exposes.
264
+ */
265
+ get params() {
266
+ return this.config;
267
+ }
185
268
  /**
186
269
  * Create a new skill instance.
187
270
  *
188
- * Python parity: `core/skill_base.py:32-43`.
271
+ * Python equivalent:`core/skill_base.py:32-43`.
189
272
  * Python `__init__` raises `ValueError` if `SKILL_NAME` or `SKILL_DESCRIPTION`
190
273
  * is left as `None` on the subclass. TS throws the equivalent when the static
191
274
  * defaults haven't been overridden.
@@ -226,7 +309,7 @@ export class SkillBase {
226
309
  * `defineTool()`. Skills using the declarative pattern override this
227
310
  * method to return a static array built from their config.
228
311
  *
229
- * Python parity: replaces the `@abstractmethod register_tools()` contract
312
+ * Python equivalent:replaces the `@abstractmethod register_tools()` contract
230
313
  * — Python skills call `self.define_tool(...)` inside `register_tools()`;
231
314
  * TypeScript skills either call `this.defineTool(...)` in `setup()` (and
232
315
  * let the default `getTools()` return them) or override `getTools()`
@@ -240,7 +323,7 @@ export class SkillBase {
240
323
  /**
241
324
  * Imperatively register a tool with this skill.
242
325
  *
243
- * Python parity: `core/skill_base.py:58` `def define_tool(self, **kwargs)`.
326
+ * Python equivalent:`core/skill_base.py:58` `def define_tool(self, **kwargs)`.
244
327
  * Merges `this.swaigFields` into the tool definition (explicit fields on
245
328
  * `toolDef` take precedence), then pushes the result into `_dynamicTools`
246
329
  * so the default `getTools()` returns it at SWML render time.
@@ -368,7 +451,7 @@ export class SkillBase {
368
451
  * Validate that all required environment variables declared on the skill class
369
452
  * are set in the current process environment.
370
453
  *
371
- * Python parity: `core/skill_base.py:103-110` reads `self.REQUIRED_ENV_VARS`
454
+ * Python equivalent:`core/skill_base.py:103-110` reads `self.REQUIRED_ENV_VARS`
372
455
  * directly. TS reads the same static from the class.
373
456
  *
374
457
  * Returns the list of missing variable names so callers can produce actionable
@@ -436,7 +519,7 @@ export class SkillBase {
436
519
  /**
437
520
  * Validate that all required packages declared on the skill class can be imported.
438
521
  *
439
- * Python parity: `core/skill_base.py:112-124` reads `self.REQUIRED_PACKAGES`
522
+ * Python equivalent:`core/skill_base.py:112-124` reads `self.REQUIRED_PACKAGES`
440
523
  * directly and tries `importlib.import_module(pkg)` for each; TS does the
441
524
  * equivalent with a dynamic `import()`.
442
525
  *
@@ -1 +1 @@
1
- {"version":3,"file":"SkillBase.js","sourceRoot":"","sources":["../../src/skills/SkillBase.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"SkillBase.js","sourceRoot":"","sources":["../../src/skills/SkillBase.ts"],"names":[],"mappings":"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"}
@@ -5,6 +5,7 @@
5
5
  * skill tools, hints, global data, and prompt sections.
6
6
  */
7
7
  import { SkillBase, type SkillConfig } from './SkillBase.js';
8
+ import type { AgentBase } from '../AgentBase.js';
8
9
  /**
9
10
  * Manages the lifecycle of skills attached to an agent.
10
11
  *
@@ -12,23 +13,49 @@ import { SkillBase, type SkillConfig } from './SkillBase.js';
12
13
  * hints, global data, and prompt sections.
13
14
  *
14
15
  * @remarks
15
- * **Architectural note — push vs pull model:**
16
- * Python's `SkillManager.__init__(self, agent)` stores the agent reference and
17
- * uses a **push model**: when a skill is loaded via `load_skill()`, the manager
18
- * immediately calls `agent.add_hints()`, `agent.update_global_data()`, and
19
- * `agent.prompt_add_section()` to inject skill data into the agent.
16
+ * `AgentBase` owns a manager (`agent.skillManager`). {@link addSkill} only
17
+ * checks, sets up and records a skill: `AgentBase.addSkill()` calls it, then
18
+ * registers the skill's tools, prompt sections, hints and global data on the
19
+ * agent. {@link loadSkill} and {@link loadSkillByName} on a manager that
20
+ * belongs to an agent go through `AgentBase.addSkill()`, so the skill is
21
+ * registered on the agent as well, as Python's `SkillManager.load_skill()`
22
+ * does (`core/skill_manager.py`). On a standalone manager they only record
23
+ * the skill.
20
24
  *
21
- * This TypeScript implementation uses a **pull model** instead: `SkillManager`
22
- * has no agent reference and no constructor. `AgentBase` owns the manager and
23
- * calls `getAllHints()`, `getMergedGlobalData()`, and `getAllPromptSections()`
24
- * at render time. Both approaches produce the same observable behavior at the
25
- * SWML / SWAIG level. The pull model avoids circular-reference issues between
26
- * `AgentBase` and `SkillManager` and is better suited to TypeScript's
27
- * import-graph constraints.
25
+ * The owning agent is kept as a public back-reference ({@link agent}), the
26
+ * reference's readable `self.agent` (`core/skill_manager.py:22`).
28
27
  */
29
28
  export declare class SkillManager {
30
29
  private skills;
31
30
  private skillMeta;
31
+ /** Instance keys taken over from another manager by {@link _inheritFrom}. */
32
+ private inherited;
33
+ /**
34
+ * The agent this manager belongs to (the reference's public `self.agent`), or
35
+ * `undefined` when the manager is used standalone (a bare `new SkillManager()`,
36
+ * as in tests and the doc examples).
37
+ */
38
+ readonly agent?: AgentBase;
39
+ /**
40
+ * @param agent - Optional owning agent, kept as a public back-reference
41
+ * (the reference's `SkillManager(agent)`). Omit for standalone use.
42
+ */
43
+ constructor(agent?: AgentBase);
44
+ /**
45
+ * Start with the skills another manager has loaded, for a per-request copy
46
+ * of its agent. The skill instances are shared and not set up again: their
47
+ * tools, hints, prompt sections and global data are already in the agent
48
+ * the copy was made from. Removing an inherited skill from this manager
49
+ * drops it here without cleaning up the shared instance.
50
+ * @internal
51
+ */
52
+ _inheritFrom(other: SkillManager): void;
53
+ /**
54
+ * Whether `skill`'s instance is one {@link _inheritFrom} took over, so
55
+ * adding it again is a no-op.
56
+ * @internal
57
+ */
58
+ _inherits(skill: SkillBase): boolean;
32
59
  /**
33
60
  * Public read-only view of all loaded skill instances, keyed by instance key.
34
61
  * Python equivalent: `self.loaded_skills` (public `Dict[str, SkillBase]`).
@@ -38,7 +65,9 @@ export declare class SkillManager {
38
65
  get loadedSkills(): ReadonlyMap<string, SkillBase>;
39
66
  /**
40
67
  * Add a skill to the manager, validating env vars and calling setup().
41
- * Uses the skill's instance key for deduplication.
68
+ * Uses the skill's instance key for deduplication. This records the skill
69
+ * only; it doesn't register the skill's tools on the agent. Use
70
+ * {@link loadSkill}, or `AgentBase.addSkill()`, for that.
42
71
  *
43
72
  * {@link loadSkill} / {@link loadSkillByName} wrap this and catch to return
44
73
  * `[false, msg]`, matching Python `load_skill`'s return contract
@@ -90,11 +119,21 @@ export declare class SkillManager {
90
119
  * `skillManager.hasSkillByKey(key)`.
91
120
  */
92
121
  hasSkillByKey(instanceKey: string): boolean;
122
+ /**
123
+ * Add a skill and, when this manager belongs to an agent, register its
124
+ * tools, prompt sections, hints and global data there, through
125
+ * `AgentBase.addSkill()` (which calls {@link addSkill}).
126
+ */
127
+ private addAndRegister;
93
128
  /**
94
129
  * Load a skill by providing the class constructor directly, bypassing the registry.
95
130
  * This is the TypeScript equivalent of Python's `load_skill(skill_name, skill_class, params)`
96
131
  * path where a caller-provided `skill_class` is used instead of a registry lookup.
97
132
  *
133
+ * On a manager that belongs to an agent, the skill's tools, prompt sections,
134
+ * hints and global data are registered on that agent, as with
135
+ * `agent.addSkill()`.
136
+ *
98
137
  * @param skillClass - The skill class constructor (a subclass of `SkillBase`).
99
138
  * @param config - Optional configuration to pass to the skill constructor.
100
139
  * @returns A tuple `[success, errorMessage]` matching Python's `load_skill` return
@@ -104,6 +143,17 @@ export declare class SkillManager {
104
143
  *
105
144
  * @example
106
145
  * ```ts
146
+ * import { SkillManager, SkillBase, type SkillToolDefinition } from '@signalwire/sdk';
147
+ *
148
+ * class MyCustomSkill extends SkillBase {
149
+ * static override SKILL_NAME = 'my_custom';
150
+ * static override SKILL_DESCRIPTION = 'Example custom skill.';
151
+ * override getTools(): SkillToolDefinition[] {
152
+ * return [];
153
+ * }
154
+ * }
155
+ *
156
+ * const manager = new SkillManager();
107
157
  * const [ok, err] = await manager.loadSkill(MyCustomSkill, { api_key: 'secret' });
108
158
  * if (!ok) console.error(err);
109
159
  * ```
@@ -114,6 +164,9 @@ export declare class SkillManager {
114
164
  * This is the TypeScript equivalent of Python's `load_skill(skill_name)` path
115
165
  * where `skill_class=None` triggers a registry lookup.
116
166
  *
167
+ * On a manager that belongs to an agent, the skill is registered on that
168
+ * agent, as with {@link loadSkill}.
169
+ *
117
170
  * @param skillName - The registered skill name to look up in the SkillRegistry.
118
171
  * @param config - Optional configuration to pass to the skill factory.
119
172
  * @returns A tuple `[success, errorMessage]` matching Python's `load_skill` return