@signalwire/sdk 2.0.4 → 3.5.0

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