@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.
- package/CHANGELOG.md +785 -0
- package/LICENSE +21 -0
- package/README.md +163 -68
- package/dist/AGENTS.md +13 -0
- package/dist/AgentBase.d.ts +550 -163
- package/dist/AgentBase.js +1640 -514
- package/dist/AgentBase.js.map +1 -1
- package/dist/AgentServer.d.ts +21 -0
- package/dist/AgentServer.js +154 -47
- package/dist/AgentServer.js.map +1 -1
- package/dist/AuthHandler.d.ts +14 -2
- package/dist/AuthHandler.js +7 -2
- package/dist/AuthHandler.js.map +1 -1
- package/dist/ConfigLoader.d.ts +5 -13
- package/dist/ConfigLoader.js +15 -29
- package/dist/ConfigLoader.js.map +1 -1
- package/dist/ContextBuilder.d.ts +202 -9
- package/dist/ContextBuilder.js +219 -36
- package/dist/ContextBuilder.js.map +1 -1
- package/dist/DataMap.d.ts +158 -45
- package/dist/DataMap.js +167 -52
- package/dist/DataMap.js.map +1 -1
- package/dist/FunctionResult.d.ts +277 -83
- package/dist/FunctionResult.js +444 -116
- package/dist/FunctionResult.js.map +1 -1
- package/dist/Logger.d.ts +30 -5
- package/dist/Logger.js +77 -19
- package/dist/Logger.js.map +1 -1
- package/dist/POM/PromptObjectModel.d.ts +163 -0
- package/dist/POM/PromptObjectModel.js +481 -0
- package/dist/POM/PromptObjectModel.js.map +1 -0
- package/dist/ParameterSchema.d.ts +306 -0
- package/dist/ParameterSchema.js +251 -0
- package/dist/ParameterSchema.js.map +1 -0
- package/dist/PlatformContracts.d.ts +21 -0
- package/dist/PlatformContracts.generated.d.ts +109 -0
- package/dist/PlatformContracts.generated.js +8 -0
- package/dist/PlatformContracts.generated.js.map +1 -0
- package/dist/PlatformContracts.js +2 -0
- package/dist/PlatformContracts.js.map +1 -0
- package/dist/PomBuilder.d.ts +28 -0
- package/dist/PomBuilder.js +81 -3
- package/dist/PomBuilder.js.map +1 -1
- package/dist/PostPrompt.d.ts +110 -0
- package/dist/PostPrompt.js +204 -0
- package/dist/PostPrompt.js.map +1 -0
- package/dist/PromptManager.d.ts +29 -1
- package/dist/PromptManager.js +37 -1
- package/dist/PromptManager.js.map +1 -1
- package/dist/PublicFetch.d.ts +132 -0
- package/dist/PublicFetch.js +311 -0
- package/dist/PublicFetch.js.map +1 -0
- package/dist/RobotsTxt.d.ts +41 -0
- package/dist/RobotsTxt.js +152 -0
- package/dist/RobotsTxt.js.map +1 -0
- package/dist/SWMLHandler.js.map +1 -1
- package/dist/SWMLService.d.ts +265 -66
- package/dist/SWMLService.js +652 -112
- package/dist/SWMLService.js.map +1 -1
- package/dist/SchemaUtils.d.ts +115 -2
- package/dist/SchemaUtils.js +444 -12
- package/dist/SchemaUtils.js.map +1 -1
- package/dist/SecurityUtils.d.ts +55 -8
- package/dist/SecurityUtils.js +162 -49
- package/dist/SecurityUtils.js.map +1 -1
- package/dist/ServerlessAdapter.d.ts +156 -7
- package/dist/ServerlessAdapter.js +399 -42
- package/dist/ServerlessAdapter.js.map +1 -1
- package/dist/SessionManager.d.ts +11 -2
- package/dist/SessionManager.js +50 -18
- package/dist/SessionManager.js.map +1 -1
- package/dist/SslConfig.d.ts +2 -1
- package/dist/SslConfig.js +4 -1
- package/dist/SslConfig.js.map +1 -1
- package/dist/SwaigActions.generated.d.ts +23 -0
- package/dist/SwaigActions.generated.js +8 -0
- package/dist/SwaigActions.generated.js.map +1 -0
- package/dist/SwaigContracts.d.ts +15 -0
- package/dist/SwaigContracts.generated.d.ts +264 -0
- package/dist/SwaigContracts.generated.js +12 -0
- package/dist/SwaigContracts.generated.js.map +1 -0
- package/dist/SwaigContracts.js +2 -0
- package/dist/SwaigContracts.js.map +1 -0
- package/dist/SwaigFunction.d.ts +110 -4
- package/dist/SwaigFunction.js +151 -19
- package/dist/SwaigFunction.js.map +1 -1
- package/dist/SwmlBuilder.d.ts +68 -19
- package/dist/SwmlBuilder.js +74 -38
- package/dist/SwmlBuilder.js.map +1 -1
- package/dist/SwmlVerbMethods.generated.d.ts +41 -4
- package/dist/SwmlVerbMethods.generated.js +1 -1
- package/dist/TypeInference.d.ts +39 -3
- package/dist/TypeInference.js +256 -16
- package/dist/TypeInference.js.map +1 -1
- package/dist/WebService.d.ts +79 -11
- package/dist/WebService.js +320 -109
- package/dist/WebService.js.map +1 -1
- package/dist/WebhookMiddleware.d.ts +119 -0
- package/dist/WebhookMiddleware.js +271 -0
- package/dist/WebhookMiddleware.js.map +1 -0
- package/dist/WebhookValidator.d.ts +92 -0
- package/dist/WebhookValidator.js +409 -0
- package/dist/WebhookValidator.js.map +1 -0
- package/dist/agents/BedrockAgent.d.ts +162 -0
- package/dist/agents/BedrockAgent.js +323 -0
- package/dist/agents/BedrockAgent.js.map +1 -0
- package/dist/ai-chat/AIChatClient.d.ts +316 -0
- package/dist/ai-chat/AIChatClient.js +535 -0
- package/dist/ai-chat/AIChatClient.js.map +1 -0
- package/dist/ai-chat/ChatGateway.d.ts +408 -0
- package/dist/ai-chat/ChatGateway.js +747 -0
- package/dist/ai-chat/ChatGateway.js.map +1 -0
- package/dist/ai-chat/HandoffRouter.d.ts +282 -0
- package/dist/ai-chat/HandoffRouter.js +518 -0
- package/dist/ai-chat/HandoffRouter.js.map +1 -0
- package/dist/ai-chat/index.d.ts +12 -0
- package/dist/ai-chat/index.js +10 -0
- package/dist/ai-chat/index.js.map +1 -0
- package/dist/capabilities.d.ts +64 -0
- package/dist/capabilities.js +95 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +32 -6
- package/dist/cli/agent-loader.js +95 -34
- package/dist/cli/agent-loader.js.map +1 -1
- package/dist/cli/datamap-exec.d.ts +175 -0
- package/dist/cli/datamap-exec.js +1284 -0
- package/dist/cli/datamap-exec.js.map +1 -0
- package/dist/cli/function-args.d.ts +40 -0
- package/dist/cli/function-args.js +146 -0
- package/dist/cli/function-args.js.map +1 -0
- package/dist/cli/simulation.d.ts +99 -0
- package/dist/cli/simulation.js +490 -0
- package/dist/cli/simulation.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +12 -25
- package/dist/cli/swaig-test.js +935 -367
- package/dist/cli/swaig-test.js.map +1 -1
- package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
- package/dist/cli/tsdocs/agentsNote.js +92 -0
- package/dist/cli/tsdocs/agentsNote.js.map +1 -0
- package/dist/cli/tsdocs/api-index.json +1 -0
- package/dist/cli/tsdocs/api.d.ts +91 -0
- package/dist/cli/tsdocs/api.js +372 -0
- package/dist/cli/tsdocs/api.js.map +1 -0
- package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
- package/dist/cli/tsdocs/apiTypes.js +7 -0
- package/dist/cli/tsdocs/apiTypes.js.map +1 -0
- package/dist/cli/tsdocs/bin.d.ts +6 -0
- package/dist/cli/tsdocs/bin.js +23 -0
- package/dist/cli/tsdocs/bin.js.map +1 -0
- package/dist/cli/tsdocs/files.d.ts +108 -0
- package/dist/cli/tsdocs/files.js +287 -0
- package/dist/cli/tsdocs/files.js.map +1 -0
- package/dist/cli/tsdocs/index.d.ts +28 -0
- package/dist/cli/tsdocs/index.js +307 -0
- package/dist/cli/tsdocs/index.js.map +1 -0
- package/dist/cli/tsdocs/live.d.ts +41 -0
- package/dist/cli/tsdocs/live.js +202 -0
- package/dist/cli/tsdocs/live.js.map +1 -0
- package/dist/cli/tsdocs/locate.d.ts +51 -0
- package/dist/cli/tsdocs/locate.js +75 -0
- package/dist/cli/tsdocs/locate.js.map +1 -0
- package/dist/cli/tsdocs/render.d.ts +75 -0
- package/dist/cli/tsdocs/render.js +323 -0
- package/dist/cli/tsdocs/render.js.map +1 -0
- package/dist/cli/tsdocs/topics.d.ts +43 -0
- package/dist/cli/tsdocs/topics.js +916 -0
- package/dist/cli/tsdocs/topics.js.map +1 -0
- package/dist/index.d.ts +102 -39
- package/dist/index.js +107 -30
- package/dist/index.js.map +1 -1
- package/dist/livewire/index.d.ts +229 -155
- package/dist/livewire/index.js +298 -195
- package/dist/livewire/index.js.map +1 -1
- package/dist/llms.txt +65 -0
- package/dist/prefabs/CallSessionStore.d.ts +52 -0
- package/dist/prefabs/CallSessionStore.js +72 -0
- package/dist/prefabs/CallSessionStore.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +13 -1
- package/dist/prefabs/ConciergeAgent.js +36 -31
- package/dist/prefabs/ConciergeAgent.js.map +1 -1
- package/dist/prefabs/FAQBotAgent.d.ts +9 -1
- package/dist/prefabs/FAQBotAgent.js +113 -47
- package/dist/prefabs/FAQBotAgent.js.map +1 -1
- package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
- package/dist/prefabs/InfoGathererAgent.js +67 -58
- package/dist/prefabs/InfoGathererAgent.js.map +1 -1
- package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
- package/dist/prefabs/ReceptionistAgent.js +39 -31
- package/dist/prefabs/ReceptionistAgent.js.map +1 -1
- package/dist/prefabs/SurveyAgent.d.ts +22 -4
- package/dist/prefabs/SurveyAgent.js +84 -68
- package/dist/prefabs/SurveyAgent.js.map +1 -1
- package/dist/relay/Action.d.ts +44 -21
- package/dist/relay/Action.js +75 -17
- package/dist/relay/Action.js.map +1 -1
- package/dist/relay/Call.d.ts +312 -47
- package/dist/relay/Call.js +369 -18
- package/dist/relay/Call.js.map +1 -1
- package/dist/relay/Deferred.js.map +1 -1
- package/dist/relay/Message.d.ts +26 -5
- package/dist/relay/Message.js +36 -6
- package/dist/relay/Message.js.map +1 -1
- package/dist/relay/RelayClient.d.ts +79 -14
- package/dist/relay/RelayClient.js +268 -61
- package/dist/relay/RelayClient.js.map +1 -1
- package/dist/relay/RelayError.d.ts +14 -0
- package/dist/relay/RelayError.js +15 -0
- package/dist/relay/RelayError.js.map +1 -1
- package/dist/relay/RelayEvent.d.ts +96 -65
- package/dist/relay/RelayEvent.js +85 -56
- package/dist/relay/RelayEvent.js.map +1 -1
- package/dist/relay/closedSets.d.ts +111 -0
- package/dist/relay/closedSets.js +83 -0
- package/dist/relay/closedSets.js.map +1 -0
- package/dist/relay/index.d.ts +3 -1
- package/dist/relay/index.js +1 -0
- package/dist/relay/index.js.map +1 -1
- package/dist/relay/normalize.js.map +1 -1
- package/dist/relay/protocol.types.generated.d.ts +1195 -0
- package/dist/relay/protocol.types.generated.js +8 -0
- package/dist/relay/protocol.types.generated.js.map +1 -0
- package/dist/relay/types.d.ts +81 -39
- package/dist/rest/HttpClient.d.ts +36 -8
- package/dist/rest/HttpClient.js +233 -40
- package/dist/rest/HttpClient.js.map +1 -1
- package/dist/rest/RequestOptions.d.ts +110 -0
- package/dist/rest/RequestOptions.js +113 -0
- package/dist/rest/RequestOptions.js.map +1 -0
- package/dist/rest/RestError.d.ts +52 -6
- package/dist/rest/RestError.js +89 -5
- package/dist/rest/RestError.js.map +1 -1
- package/dist/rest/base/CrudResource.d.ts +16 -26
- package/dist/rest/base/CrudResource.js +19 -33
- package/dist/rest/base/CrudResource.js.map +1 -1
- package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
- package/dist/rest/base/CrudWithAddresses.js +2 -2
- package/dist/rest/base/CrudWithAddresses.js.map +1 -1
- package/dist/rest/base/FabricResource.d.ts +15 -0
- package/dist/rest/base/FabricResource.js +16 -0
- package/dist/rest/base/FabricResource.js.map +1 -0
- package/dist/rest/base/ReadResource.d.ts +62 -0
- package/dist/rest/base/ReadResource.js +69 -0
- package/dist/rest/base/ReadResource.js.map +1 -0
- package/dist/rest/callHandler.d.ts +63 -0
- package/dist/rest/callHandler.js +62 -0
- package/dist/rest/callHandler.js.map +1 -0
- package/dist/rest/index.d.ts +19 -76
- package/dist/rest/index.js +49 -120
- package/dist/rest/index.js.map +1 -1
- package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
- package/dist/rest/namespaces/_client_tree_generated.js +171 -0
- package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
- package/dist/rest/namespaces/addresses.d.ts +3 -42
- package/dist/rest/namespaces/addresses.js +3 -50
- package/dist/rest/namespaces/addresses.js.map +1 -1
- package/dist/rest/namespaces/calling.d.ts +6 -378
- package/dist/rest/namespaces/calling.js +6 -473
- package/dist/rest/namespaces/calling.js.map +1 -1
- package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
- package/dist/rest/namespaces/calling.resources.generated.js +477 -0
- package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
- package/dist/rest/namespaces/calling.types.generated.js +8 -0
- package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.d.ts +4 -18
- package/dist/rest/namespaces/chat.js +4 -21
- package/dist/rest/namespaces/chat.js.map +1 -1
- package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/chat.resources.generated.js +29 -0
- package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
- package/dist/rest/namespaces/chat.types.generated.js +8 -0
- package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.d.ts +6 -62
- package/dist/rest/namespaces/datasphere.js +6 -72
- package/dist/rest/namespaces/datasphere.js.map +1 -1
- package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
- package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
- package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.d.ts +11 -273
- package/dist/rest/namespaces/fabric.js +14 -363
- package/dist/rest/namespaces/fabric.js.map +1 -1
- package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
- package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
- package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
- package/dist/rest/namespaces/fabric.types.generated.js +8 -0
- package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/fax.resources.generated.js +14 -0
- package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/fax.types.generated.js +8 -0
- package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
- package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
- package/dist/rest/namespaces/imported-numbers.js +3 -21
- package/dist/rest/namespaces/imported-numbers.js.map +1 -1
- package/dist/rest/namespaces/logs.d.ts +10 -101
- package/dist/rest/namespaces/logs.js +10 -128
- package/dist/rest/namespaces/logs.js.map +1 -1
- package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/logs.resources.generated.js +17 -0
- package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/logs.types.generated.js +8 -0
- package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
- package/dist/rest/namespaces/lookup.d.ts +3 -25
- package/dist/rest/namespaces/lookup.js +3 -27
- package/dist/rest/namespaces/lookup.js.map +1 -1
- package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/message.resources.generated.js +14 -0
- package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
- package/dist/rest/namespaces/message.types.generated.js +8 -0
- package/dist/rest/namespaces/message.types.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
- package/dist/rest/namespaces/messages.resources.generated.js +44 -0
- package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
- package/dist/rest/namespaces/messages.types.generated.js +8 -0
- package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
- package/dist/rest/namespaces/mfa.d.ts +3 -42
- package/dist/rest/namespaces/mfa.js +3 -49
- package/dist/rest/namespaces/mfa.js.map +1 -1
- package/dist/rest/namespaces/number-groups.d.ts +3 -45
- package/dist/rest/namespaces/number-groups.js +3 -53
- package/dist/rest/namespaces/number-groups.js.map +1 -1
- package/dist/rest/namespaces/phone-numbers.d.ts +9 -57
- package/dist/rest/namespaces/phone-numbers.js +9 -63
- package/dist/rest/namespaces/phone-numbers.js.map +1 -1
- package/dist/rest/namespaces/project.d.ts +6 -42
- package/dist/rest/namespaces/project.js +6 -51
- package/dist/rest/namespaces/project.js.map +1 -1
- package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
- package/dist/rest/namespaces/project.resources.generated.js +44 -0
- package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
- package/dist/rest/namespaces/project.types.generated.js +8 -0
- package/dist/rest/namespaces/project.types.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/projects.resources.generated.js +25 -0
- package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
- package/dist/rest/namespaces/projects.types.generated.js +8 -0
- package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.d.ts +4 -18
- package/dist/rest/namespaces/pubsub.js +4 -21
- package/dist/rest/namespaces/pubsub.js.map +1 -1
- package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
- package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
- package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
- package/dist/rest/namespaces/queues.d.ts +3 -38
- package/dist/rest/namespaces/queues.js +3 -44
- package/dist/rest/namespaces/queues.js.map +1 -1
- package/dist/rest/namespaces/recordings.d.ts +3 -34
- package/dist/rest/namespaces/recordings.js +3 -40
- package/dist/rest/namespaces/recordings.js.map +1 -1
- package/dist/rest/namespaces/registry.d.ts +6 -137
- package/dist/rest/namespaces/registry.js +6 -173
- package/dist/rest/namespaces/registry.js.map +1 -1
- package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
- package/dist/rest/namespaces/short-codes.d.ts +3 -35
- package/dist/rest/namespaces/short-codes.js +3 -41
- package/dist/rest/namespaces/short-codes.js.map +1 -1
- package/dist/rest/namespaces/sip-profile.d.ts +3 -24
- package/dist/rest/namespaces/sip-profile.js +3 -29
- package/dist/rest/namespaces/sip-profile.js.map +1 -1
- package/dist/rest/namespaces/verified-callers.d.ts +3 -29
- package/dist/rest/namespaces/verified-callers.js +3 -34
- package/dist/rest/namespaces/verified-callers.js.map +1 -1
- package/dist/rest/namespaces/video.d.ts +10 -227
- package/dist/rest/namespaces/video.js +10 -288
- package/dist/rest/namespaces/video.js.map +1 -1
- package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
- package/dist/rest/namespaces/video.resources.generated.js +171 -0
- package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
- package/dist/rest/namespaces/video.types.generated.js +8 -0
- package/dist/rest/namespaces/video.types.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/voice.resources.generated.js +17 -0
- package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
- package/dist/rest/namespaces/voice.types.generated.js +8 -0
- package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
- package/dist/rest/pagination.d.ts +5 -1
- package/dist/rest/pagination.js +40 -20
- package/dist/rest/pagination.js.map +1 -1
- package/dist/rest/types.d.ts +21 -3
- package/dist/schema.json +299 -98
- package/dist/skills/SkillBase.d.ts +97 -20
- package/dist/skills/SkillBase.js +100 -17
- package/dist/skills/SkillBase.js.map +1 -1
- package/dist/skills/SkillManager.d.ts +66 -13
- package/dist/skills/SkillManager.js +101 -20
- package/dist/skills/SkillManager.js.map +1 -1
- package/dist/skills/SkillName.d.ts +44 -0
- package/dist/skills/SkillName.js +2 -0
- package/dist/skills/SkillName.js.map +1 -0
- package/dist/skills/SkillRegistry.d.ts +47 -7
- package/dist/skills/SkillRegistry.js +85 -13
- package/dist/skills/SkillRegistry.js.map +1 -1
- package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
- package/dist/skills/builtin/api_ninjas_trivia.js +24 -8
- package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
- package/dist/skills/builtin/ask_claude.d.ts +14 -4
- package/dist/skills/builtin/ask_claude.js +36 -14
- package/dist/skills/builtin/ask_claude.js.map +1 -1
- package/dist/skills/builtin/claude_skills.d.ts +3 -1
- package/dist/skills/builtin/claude_skills.js +19 -15
- package/dist/skills/builtin/claude_skills.js.map +1 -1
- package/dist/skills/builtin/custom_skills.d.ts +10 -3
- package/dist/skills/builtin/custom_skills.js +26 -9
- package/dist/skills/builtin/custom_skills.js.map +1 -1
- package/dist/skills/builtin/datasphere.d.ts +5 -3
- package/dist/skills/builtin/datasphere.js +34 -25
- package/dist/skills/builtin/datasphere.js.map +1 -1
- package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
- package/dist/skills/builtin/datasphere_serverless.js +17 -6
- package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
- package/dist/skills/builtin/datetime.d.ts +3 -1
- package/dist/skills/builtin/datetime.js +11 -7
- package/dist/skills/builtin/datetime.js.map +1 -1
- package/dist/skills/builtin/google_maps.d.ts +29 -14
- package/dist/skills/builtin/google_maps.js +89 -269
- package/dist/skills/builtin/google_maps.js.map +1 -1
- package/dist/skills/builtin/index.d.ts +8 -6
- package/dist/skills/builtin/index.js +8 -6
- package/dist/skills/builtin/index.js.map +1 -1
- package/dist/skills/builtin/info_gatherer.d.ts +4 -2
- package/dist/skills/builtin/info_gatherer.js +20 -12
- package/dist/skills/builtin/info_gatherer.js.map +1 -1
- package/dist/skills/builtin/joke.d.ts +16 -6
- package/dist/skills/builtin/joke.js +54 -37
- package/dist/skills/builtin/joke.js.map +1 -1
- package/dist/skills/builtin/math.d.ts +3 -1
- package/dist/skills/builtin/math.js +14 -9
- package/dist/skills/builtin/math.js.map +1 -1
- package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
- package/dist/skills/builtin/mcp_gateway.js +77 -46
- package/dist/skills/builtin/mcp_gateway.js.map +1 -1
- package/dist/skills/builtin/native_vector_search.d.ts +19 -5
- package/dist/skills/builtin/native_vector_search.js +179 -61
- package/dist/skills/builtin/native_vector_search.js.map +1 -1
- package/dist/skills/builtin/play_background_file.d.ts +21 -15
- package/dist/skills/builtin/play_background_file.js +43 -122
- package/dist/skills/builtin/play_background_file.js.map +1 -1
- package/dist/skills/builtin/spider.d.ts +46 -1
- package/dist/skills/builtin/spider.js +317 -101
- package/dist/skills/builtin/spider.js.map +1 -1
- package/dist/skills/builtin/swml_transfer.d.ts +14 -3
- package/dist/skills/builtin/swml_transfer.js +45 -24
- package/dist/skills/builtin/swml_transfer.js.map +1 -1
- package/dist/skills/builtin/weather_api.d.ts +24 -13
- package/dist/skills/builtin/weather_api.js +57 -31
- package/dist/skills/builtin/weather_api.js.map +1 -1
- package/dist/skills/builtin/web_search.d.ts +48 -10
- package/dist/skills/builtin/web_search.js +301 -84
- package/dist/skills/builtin/web_search.js.map +1 -1
- package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
- package/dist/skills/builtin/wikipedia_search.js +32 -14
- package/dist/skills/builtin/wikipedia_search.js.map +1 -1
- package/dist/skills/index.d.ts +3 -2
- package/dist/skills/index.js +1 -1
- package/dist/skills/index.js.map +1 -1
- package/dist/swml_verbs_generated.d.ts +2824 -0
- package/dist/swml_verbs_generated.js +12 -0
- package/dist/swml_verbs_generated.js.map +1 -0
- package/dist/types.d.ts +65 -6
- package/dist/web.d.ts +27 -0
- package/dist/web.js +20 -0
- package/dist/web.js.map +1 -0
- package/docs/agent-guide.md +1034 -0
- package/docs/ai_chat.md +560 -0
- package/docs/api-reference.md +3534 -0
- package/docs/architecture.md +846 -0
- package/docs/bedrock_agent.md +411 -0
- package/docs/cli-guide.md +403 -0
- package/docs/cloud_functions_guide.md +399 -0
- package/docs/configuration.md +548 -0
- package/docs/contexts-guide.md +884 -0
- package/docs/datamap-guide.md +1160 -0
- package/docs/developer_pain_points.md +548 -0
- package/docs/llm_parameters.md +298 -0
- package/docs/mcp_gateway_reference.md +354 -0
- package/docs/mcp_integration.md +162 -0
- package/docs/pgi_agent_guide.md +1820 -0
- package/docs/prefabs-guide.md +815 -0
- package/docs/programmatically_governed_inference.md +301 -0
- package/docs/sdk_features.md +501 -0
- package/docs/security.md +559 -0
- package/docs/serverless-guide.md +520 -0
- package/docs/skills-guide.md +1223 -0
- package/docs/skills-system.md +405 -0
- package/docs/skills_parameter_schema.md +417 -0
- package/docs/swaig-reference.md +1938 -0
- package/docs/swml_service_guide.md +573 -0
- package/docs/third_party_skills.md +410 -0
- package/docs/web_service.md +666 -0
- package/examples/README.md +202 -0
- package/examples/advanced-datamap.ts +108 -0
- package/examples/advanced-dynamic-config.ts +70 -0
- package/examples/auto-vivified.ts +95 -0
- package/examples/call-flow.ts +65 -0
- package/examples/comprehensive-dynamic.ts +125 -0
- package/examples/contexts-steps.ts +65 -0
- package/examples/custom-path.ts +45 -0
- package/examples/datamap-tools.ts +51 -0
- package/examples/datasphere-multi-instance.ts +66 -0
- package/examples/datasphere-serverless-env.ts +87 -0
- package/examples/datasphere-webhook-env.ts +65 -0
- package/examples/datasphere.ts +56 -0
- package/examples/declarative.ts +100 -0
- package/examples/dynamic-config.ts +54 -0
- package/examples/dynamic-info-gatherer.ts +69 -0
- package/examples/dynamic-swml-service.ts +67 -0
- package/examples/gather-info.ts +95 -0
- package/examples/gather-per-question-functions-demo.ts +139 -0
- package/examples/joke-agent.ts +34 -0
- package/examples/kubernetes-agent.ts +45 -0
- package/examples/llm-params.ts +75 -0
- package/examples/mcp-agent.ts +89 -0
- package/examples/mcp-gateway.ts +81 -0
- package/examples/multi-agent.ts +80 -0
- package/examples/multi-endpoint.ts +79 -0
- package/examples/pgi/case-domain.ts +114 -0
- package/examples/pgi/serve.ts +16 -0
- package/examples/pgi/support-agent.ts +265 -0
- package/examples/pom-prompt.ts +70 -0
- package/examples/prefab-concierge.ts +42 -0
- package/examples/prefab-faq.ts +58 -0
- package/examples/prefab-info-gatherer.ts +33 -0
- package/examples/prefab-receptionist.ts +36 -0
- package/examples/prefab-survey.ts +69 -0
- package/examples/quickstart-agent.ts +29 -0
- package/examples/quickstart-relay.ts +25 -0
- package/examples/quickstart-rest.ts +25 -0
- package/examples/record-call.ts +65 -0
- package/examples/relay-demo.ts +33 -0
- package/examples/room-and-sip.ts +93 -0
- package/examples/serverless-lambda.ts +43 -0
- package/examples/session-state.ts +83 -0
- package/examples/simple-agent.ts +36 -0
- package/examples/simple-static.ts +29 -0
- package/examples/skills-demo.ts +41 -0
- package/examples/step-function-inheritance-demo.ts +124 -0
- package/examples/swaig-features.ts +193 -0
- package/examples/swml-service-routing.ts +66 -0
- package/examples/swml-service.ts +38 -0
- package/examples/swmlservice_ai_sidecar.ts +104 -0
- package/examples/swmlservice_swaig_standalone.ts +79 -0
- package/examples/tap.ts +67 -0
- package/examples/typed-tools.ts +68 -0
- package/examples/verb-methods.ts +45 -0
- package/examples/web-search-multi-instance.ts +75 -0
- package/examples/web-search.ts +38 -0
- package/examples/wikipedia.ts +36 -0
- package/livewire/README.md +164 -0
- package/livewire/docs/migration-guide.md +251 -0
- package/livewire/examples/livewire-basic-agent.ts +74 -0
- package/livewire/examples/livewire-handoff.ts +196 -0
- package/livewire/examples/livewire-multi-tool.ts +121 -0
- package/package.json +88 -13
- package/relay/README.md +101 -0
- package/relay/docs/call-methods.md +622 -0
- package/relay/docs/client-reference.md +281 -0
- package/relay/docs/events.md +193 -0
- package/relay/docs/getting-started.md +221 -0
- package/relay/docs/guide.md +386 -0
- package/relay/docs/messaging.md +246 -0
- package/relay/examples/relay-inbound.ts +66 -0
- package/relay/examples/relay-messaging.ts +74 -0
- package/relay/examples/relay-outbound.ts +76 -0
- package/rest/README.md +141 -0
- package/rest/docs/calling.md +313 -0
- package/rest/docs/client-reference.md +149 -0
- package/rest/docs/fabric.md +192 -0
- package/rest/docs/getting-started.md +138 -0
- package/rest/docs/guide.md +421 -0
- package/rest/docs/namespaces.md +367 -0
- package/rest/docs/phone-binding.md +116 -0
- package/rest/examples/rest-10dlc-registration.ts +177 -0
- package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
- package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
- package/rest/examples/rest-calling-play-and-record.ts +98 -0
- package/rest/examples/rest-client.ts +59 -0
- package/rest/examples/rest-datasphere-search.ts +81 -0
- package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
- package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
- package/rest/examples/rest-manage-resources.ts +64 -0
- package/rest/examples/rest-phone-number-management.ts +200 -0
- package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
- package/rest/examples/rest-video-rooms.ts +186 -0
- package/tutorial/fred/fred.ts +218 -0
- package/tutorial/fred/tutorial/01-introduction.md +141 -0
- package/tutorial/fred/tutorial/02-setup.md +304 -0
- package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
- package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
- package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
- package/tutorial/fred/tutorial/06-running-testing.md +642 -0
- package/tutorial/fred/tutorial/README.md +56 -0
- package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
- package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
- package/tutorial/full-guardrails-agent/handlers.ts +436 -0
- package/tutorial/full-guardrails-agent/penny.ts +305 -0
- package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
- package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
- package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
- package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
- package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
- package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
- package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
- package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
- package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
- package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
- package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
- package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
- package/tutorial/full-guardrails-agent/workflow.ts +219 -0
- package/tutorial/multi_agents/README.md +175 -0
- package/tutorial/multi_agents/advanced_agent.ts +395 -0
- package/tutorial/multi_agents/extending_agents.ts +641 -0
- package/tutorial/multi_agents/knowledge.ts +59 -0
- package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
- package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
- package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
- package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
- package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
- package/tutorial/multi_agents/pc_builder.ts +529 -0
- package/tutorial/multi_agents/sales_agent.ts +88 -0
- package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
- package/tutorial/multi_agents/sales_knowledge.md +139 -0
- package/tutorial/multi_agents/support_knowledge.md +256 -0
- package/dist/cli/mock-data.d.ts +0 -37
- package/dist/cli/mock-data.js +0 -80
- package/dist/cli/mock-data.js.map +0 -1
- package/dist/generateVerbTypes.d.ts +0 -11
- package/dist/generateVerbTypes.js +0 -265
- package/dist/generateVerbTypes.js.map +0 -1
- package/dist/rest/namespaces/compat.d.ts +0 -585
- package/dist/rest/namespaces/compat.js +0 -735
- package/dist/rest/namespaces/compat.js.map +0 -1
|
@@ -14,23 +14,61 @@ const log = getLogger('SkillManager');
|
|
|
14
14
|
* hints, global data, and prompt sections.
|
|
15
15
|
*
|
|
16
16
|
* @remarks
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* `
|
|
17
|
+
* `AgentBase` owns a manager (`agent.skillManager`). {@link addSkill} only
|
|
18
|
+
* checks, sets up and records a skill: `AgentBase.addSkill()` calls it, then
|
|
19
|
+
* registers the skill's tools, prompt sections, hints and global data on the
|
|
20
|
+
* agent. {@link loadSkill} and {@link loadSkillByName} on a manager that
|
|
21
|
+
* belongs to an agent go through `AgentBase.addSkill()`, so the skill is
|
|
22
|
+
* registered on the agent as well, as Python's `SkillManager.load_skill()`
|
|
23
|
+
* does (`core/skill_manager.py`). On a standalone manager they only record
|
|
24
|
+
* the skill.
|
|
22
25
|
*
|
|
23
|
-
*
|
|
24
|
-
*
|
|
25
|
-
* calls `getAllHints()`, `getMergedGlobalData()`, and `getAllPromptSections()`
|
|
26
|
-
* at render time. Both approaches produce the same observable behavior at the
|
|
27
|
-
* SWML / SWAIG level. The pull model avoids circular-reference issues between
|
|
28
|
-
* `AgentBase` and `SkillManager` and is better suited to TypeScript's
|
|
29
|
-
* import-graph constraints.
|
|
26
|
+
* The owning agent is kept as a public back-reference ({@link agent}), the
|
|
27
|
+
* reference's readable `self.agent` (`core/skill_manager.py:22`).
|
|
30
28
|
*/
|
|
31
29
|
export class SkillManager {
|
|
32
30
|
skills = new Map();
|
|
33
31
|
skillMeta = new Map();
|
|
32
|
+
/** Instance keys taken over from another manager by {@link _inheritFrom}. */
|
|
33
|
+
inherited = new Set();
|
|
34
|
+
/**
|
|
35
|
+
* The agent this manager belongs to (the reference's public `self.agent`), or
|
|
36
|
+
* `undefined` when the manager is used standalone (a bare `new SkillManager()`,
|
|
37
|
+
* as in tests and the doc examples).
|
|
38
|
+
*/
|
|
39
|
+
agent;
|
|
40
|
+
/**
|
|
41
|
+
* @param agent - Optional owning agent, kept as a public back-reference
|
|
42
|
+
* (the reference's `SkillManager(agent)`). Omit for standalone use.
|
|
43
|
+
*/
|
|
44
|
+
constructor(agent) {
|
|
45
|
+
this.agent = agent;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Start with the skills another manager has loaded, for a per-request copy
|
|
49
|
+
* of its agent. The skill instances are shared and not set up again: their
|
|
50
|
+
* tools, hints, prompt sections and global data are already in the agent
|
|
51
|
+
* the copy was made from. Removing an inherited skill from this manager
|
|
52
|
+
* drops it here without cleaning up the shared instance.
|
|
53
|
+
* @internal
|
|
54
|
+
*/
|
|
55
|
+
_inheritFrom(other) {
|
|
56
|
+
for (const [key, skill] of other.skills) {
|
|
57
|
+
this.skills.set(key, skill);
|
|
58
|
+
const meta = other.skillMeta.get(key);
|
|
59
|
+
if (meta)
|
|
60
|
+
this.skillMeta.set(key, meta);
|
|
61
|
+
this.inherited.add(key);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Whether `skill`'s instance is one {@link _inheritFrom} took over, so
|
|
66
|
+
* adding it again is a no-op.
|
|
67
|
+
* @internal
|
|
68
|
+
*/
|
|
69
|
+
_inherits(skill) {
|
|
70
|
+
return this.inherited.has(skill.getInstanceKey());
|
|
71
|
+
}
|
|
34
72
|
/**
|
|
35
73
|
* Public read-only view of all loaded skill instances, keyed by instance key.
|
|
36
74
|
* Python equivalent: `self.loaded_skills` (public `Dict[str, SkillBase]`).
|
|
@@ -42,7 +80,9 @@ export class SkillManager {
|
|
|
42
80
|
}
|
|
43
81
|
/**
|
|
44
82
|
* Add a skill to the manager, validating env vars and calling setup().
|
|
45
|
-
* Uses the skill's instance key for deduplication.
|
|
83
|
+
* Uses the skill's instance key for deduplication. This records the skill
|
|
84
|
+
* only; it doesn't register the skill's tools on the agent. Use
|
|
85
|
+
* {@link loadSkill}, or `AgentBase.addSkill()`, for that.
|
|
46
86
|
*
|
|
47
87
|
* {@link loadSkill} / {@link loadSkillByName} wrap this and catch to return
|
|
48
88
|
* `[false, msg]`, matching Python `load_skill`'s return contract
|
|
@@ -59,6 +99,12 @@ export class SkillManager {
|
|
|
59
99
|
const name = skill.skillName;
|
|
60
100
|
const instanceKey = skill.getInstanceKey();
|
|
61
101
|
const SkillClass = skill.constructor;
|
|
102
|
+
// A skill the per-request copy inherited is already loaded: adding it
|
|
103
|
+
// again is a no-op, as in the reference, not a duplicate error.
|
|
104
|
+
if (this.inherited.has(instanceKey)) {
|
|
105
|
+
log.debug(`Skill '${name}' (${instanceKey}) is inherited; not adding it again`);
|
|
106
|
+
return;
|
|
107
|
+
}
|
|
62
108
|
// Duplicate detection using instance key
|
|
63
109
|
if (this.skills.has(instanceKey)) {
|
|
64
110
|
if (!SkillClass.SUPPORTS_MULTIPLE_INSTANCES) {
|
|
@@ -134,7 +180,9 @@ export class SkillManager {
|
|
|
134
180
|
}
|
|
135
181
|
if (!skill)
|
|
136
182
|
return false;
|
|
137
|
-
|
|
183
|
+
// An inherited instance still belongs to the agent it came from.
|
|
184
|
+
if (!this.inherited.delete(key))
|
|
185
|
+
await skill.cleanup();
|
|
138
186
|
this.skills.delete(key);
|
|
139
187
|
this.skillMeta.delete(key);
|
|
140
188
|
log.debug(`Removed skill '${skill.skillName}' (${key})`);
|
|
@@ -187,11 +235,28 @@ export class SkillManager {
|
|
|
187
235
|
hasSkillByKey(instanceKey) {
|
|
188
236
|
return this.skills.has(instanceKey);
|
|
189
237
|
}
|
|
238
|
+
/**
|
|
239
|
+
* Add a skill and, when this manager belongs to an agent, register its
|
|
240
|
+
* tools, prompt sections, hints and global data there, through
|
|
241
|
+
* `AgentBase.addSkill()` (which calls {@link addSkill}).
|
|
242
|
+
*/
|
|
243
|
+
async addAndRegister(skill) {
|
|
244
|
+
if (this.agent) {
|
|
245
|
+
await this.agent.addSkill(skill);
|
|
246
|
+
}
|
|
247
|
+
else {
|
|
248
|
+
await this.addSkill(skill);
|
|
249
|
+
}
|
|
250
|
+
}
|
|
190
251
|
/**
|
|
191
252
|
* Load a skill by providing the class constructor directly, bypassing the registry.
|
|
192
253
|
* This is the TypeScript equivalent of Python's `load_skill(skill_name, skill_class, params)`
|
|
193
254
|
* path where a caller-provided `skill_class` is used instead of a registry lookup.
|
|
194
255
|
*
|
|
256
|
+
* On a manager that belongs to an agent, the skill's tools, prompt sections,
|
|
257
|
+
* hints and global data are registered on that agent, as with
|
|
258
|
+
* `agent.addSkill()`.
|
|
259
|
+
*
|
|
195
260
|
* @param skillClass - The skill class constructor (a subclass of `SkillBase`).
|
|
196
261
|
* @param config - Optional configuration to pass to the skill constructor.
|
|
197
262
|
* @returns A tuple `[success, errorMessage]` matching Python's `load_skill` return
|
|
@@ -201,6 +266,17 @@ export class SkillManager {
|
|
|
201
266
|
*
|
|
202
267
|
* @example
|
|
203
268
|
* ```ts
|
|
269
|
+
* import { SkillManager, SkillBase, type SkillToolDefinition } from '@signalwire/sdk';
|
|
270
|
+
*
|
|
271
|
+
* class MyCustomSkill extends SkillBase {
|
|
272
|
+
* static override SKILL_NAME = 'my_custom';
|
|
273
|
+
* static override SKILL_DESCRIPTION = 'Example custom skill.';
|
|
274
|
+
* override getTools(): SkillToolDefinition[] {
|
|
275
|
+
* return [];
|
|
276
|
+
* }
|
|
277
|
+
* }
|
|
278
|
+
*
|
|
279
|
+
* const manager = new SkillManager();
|
|
204
280
|
* const [ok, err] = await manager.loadSkill(MyCustomSkill, { api_key: 'secret' });
|
|
205
281
|
* if (!ok) console.error(err);
|
|
206
282
|
* ```
|
|
@@ -212,7 +288,7 @@ export class SkillManager {
|
|
|
212
288
|
// concrete subclasses hardcode it in super(...), so only config is needed at the call site.
|
|
213
289
|
const SkillCtor = skillClass;
|
|
214
290
|
const skill = new SkillCtor(config);
|
|
215
|
-
await this.
|
|
291
|
+
await this.addAndRegister(skill);
|
|
216
292
|
return [true, ''];
|
|
217
293
|
}
|
|
218
294
|
catch (err) {
|
|
@@ -226,6 +302,9 @@ export class SkillManager {
|
|
|
226
302
|
* This is the TypeScript equivalent of Python's `load_skill(skill_name)` path
|
|
227
303
|
* where `skill_class=None` triggers a registry lookup.
|
|
228
304
|
*
|
|
305
|
+
* On a manager that belongs to an agent, the skill is registered on that
|
|
306
|
+
* agent, as with {@link loadSkill}.
|
|
307
|
+
*
|
|
229
308
|
* @param skillName - The registered skill name to look up in the SkillRegistry.
|
|
230
309
|
* @param config - Optional configuration to pass to the skill factory.
|
|
231
310
|
* @returns A tuple `[success, errorMessage]` matching Python's `load_skill` return
|
|
@@ -249,7 +328,7 @@ export class SkillManager {
|
|
|
249
328
|
return [false, errorMsg];
|
|
250
329
|
}
|
|
251
330
|
try {
|
|
252
|
-
await this.
|
|
331
|
+
await this.addAndRegister(skill);
|
|
253
332
|
return [true, ''];
|
|
254
333
|
}
|
|
255
334
|
catch (err) {
|
|
@@ -296,7 +375,7 @@ export class SkillManager {
|
|
|
296
375
|
* @returns Array of skill summary objects.
|
|
297
376
|
*/
|
|
298
377
|
listSkills() {
|
|
299
|
-
return Array.from(this.skills.values()).map(s => ({
|
|
378
|
+
return Array.from(this.skills.values()).map((s) => ({
|
|
300
379
|
name: s.skillName,
|
|
301
380
|
instanceId: s.instanceId,
|
|
302
381
|
initialized: s.isInitialized(),
|
|
@@ -358,7 +437,7 @@ export class SkillManager {
|
|
|
358
437
|
* @returns Array of entries containing skill name, class constructor, and config.
|
|
359
438
|
*/
|
|
360
439
|
getLoadedSkillEntries() {
|
|
361
|
-
return Array.from(this.skillMeta.values()).map(entry => ({
|
|
440
|
+
return Array.from(this.skillMeta.values()).map((entry) => ({
|
|
362
441
|
skillName: entry.skillName,
|
|
363
442
|
SkillClass: entry.SkillClass,
|
|
364
443
|
config: { ...entry.config },
|
|
@@ -368,11 +447,13 @@ export class SkillManager {
|
|
|
368
447
|
* Remove all skills and clean up.
|
|
369
448
|
*/
|
|
370
449
|
async clear() {
|
|
371
|
-
for (const skill of this.skills
|
|
372
|
-
|
|
450
|
+
for (const [key, skill] of this.skills) {
|
|
451
|
+
if (!this.inherited.has(key))
|
|
452
|
+
await skill.cleanup();
|
|
373
453
|
}
|
|
374
454
|
this.skills.clear();
|
|
375
455
|
this.skillMeta.clear();
|
|
456
|
+
this.inherited.clear();
|
|
376
457
|
}
|
|
377
458
|
}
|
|
378
459
|
//# sourceMappingURL=SkillManager.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SkillManager.js","sourceRoot":"","sources":["../../src/skills/SkillManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"SkillManager.js","sourceRoot":"","sources":["../../src/skills/SkillManager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Built-in skill names as a typed, compile-time-checked closed set.
|
|
3
|
+
*
|
|
4
|
+
* The 19 names below are exactly the `SKILL_NAME` declared by each built-in
|
|
5
|
+
* skill class in `src/skills/builtin/` (the same set
|
|
6
|
+
* {@link registerBuiltinSkills} locks into the global `SkillRegistry`).
|
|
7
|
+
*
|
|
8
|
+
* {@link AgentBase.addSkillByName} and {@link AgentBase.hasSkill} accept this
|
|
9
|
+
* union OR any string (`SkillName | (string & {})`):
|
|
10
|
+
*
|
|
11
|
+
* - The union gives editor autocompletion for the built-in names.
|
|
12
|
+
* - The `string & {}` arm accepts any other string, so custom / third-party
|
|
13
|
+
* skill names work, as with the Python SDK (whose `add_skill` /
|
|
14
|
+
* `has_skill` take a bare `str`). It also means a typo in a call
|
|
15
|
+
* (`addSkillByName('datetiem')`) still compiles: `addSkillByName` then
|
|
16
|
+
* rejects at runtime because the name isn't registered. To have the
|
|
17
|
+
* compiler check a built-in name, type the value as `SkillName`.
|
|
18
|
+
*
|
|
19
|
+
* TypeScript erases these types, so the value passed at runtime is the same
|
|
20
|
+
* string either way.
|
|
21
|
+
*
|
|
22
|
+
* @example
|
|
23
|
+
* ```ts
|
|
24
|
+
* import { AgentBase, type SkillName } from '@signalwire/sdk';
|
|
25
|
+
* const agent = new AgentBase({ name: 'demo', route: '/' });
|
|
26
|
+
* await agent.addSkillByName('datetime'); // autocompleted built-in
|
|
27
|
+
* agent.hasSkill('datetime'); // true
|
|
28
|
+
* const name: SkillName = 'math'; // checked: 'mathh' is a compile error
|
|
29
|
+
* await agent.addSkillByName(name);
|
|
30
|
+
* // await agent.addSkillByName('datetiem'); // compiles, rejects: not registered
|
|
31
|
+
* ```
|
|
32
|
+
*/
|
|
33
|
+
export type SkillName = 'api_ninjas_trivia' | 'ask_claude' | 'claude_skills' | 'custom_skills' | 'datasphere' | 'datasphere_serverless' | 'datetime' | 'google_maps' | 'info_gatherer' | 'joke' | 'math' | 'mcp_gateway' | 'native_vector_search' | 'play_background_file' | 'spider' | 'swml_transfer' | 'weather_api' | 'web_search' | 'wikipedia_search';
|
|
34
|
+
/**
|
|
35
|
+
* A skill-name parameter: one of the typed built-in {@link SkillName} values
|
|
36
|
+
* (autocompleted) or any other string (custom / third-party skills, and
|
|
37
|
+
* consistency with Python's bare `str`). Because any string is accepted, a
|
|
38
|
+
* misspelled built-in name isn't a compile error here.
|
|
39
|
+
*
|
|
40
|
+
* The `(string & {})` arm preserves string literal autocompletion for the
|
|
41
|
+
* union members while still widening to accept arbitrary strings; it is purely
|
|
42
|
+
* a type-level annotation and has no runtime effect.
|
|
43
|
+
*/
|
|
44
|
+
export type SkillNameOrString = SkillName | (string & {});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SkillName.js","sourceRoot":"","sources":["../../src/skills/SkillName.ts"],"names":[],"mappings":""}
|
|
@@ -51,6 +51,11 @@ export declare class SkillRegistry {
|
|
|
51
51
|
private registry;
|
|
52
52
|
private lockedNames;
|
|
53
53
|
private searchPaths;
|
|
54
|
+
/**
|
|
55
|
+
* External skill directories registered via {@link addSkillDirectory}.
|
|
56
|
+
* Mirrors Python's `SkillRegistry._external_paths` (`registry.py:373`).
|
|
57
|
+
*/
|
|
58
|
+
private externalPaths;
|
|
54
59
|
constructor();
|
|
55
60
|
/**
|
|
56
61
|
* Get the global singleton instance, creating it on first access.
|
|
@@ -72,15 +77,20 @@ export declare class SkillRegistry {
|
|
|
72
77
|
*/
|
|
73
78
|
register(SkillClass: typeof SkillBase): void;
|
|
74
79
|
/**
|
|
75
|
-
* Lock one or more skill names
|
|
76
|
-
*
|
|
80
|
+
* Lock one or more skill names, so they can't be overwritten, unregistered
|
|
81
|
+
* or cleared. `registerBuiltinSkills()` locks the built-in skills, so a
|
|
82
|
+
* built-in can't be replaced by removing it and registering another class
|
|
83
|
+
* under its name. If called with no arguments, locks all currently
|
|
84
|
+
* registered skills.
|
|
77
85
|
* @param names - Skill names to lock; if omitted, all current names are locked.
|
|
78
86
|
*/
|
|
79
87
|
lock(names?: string[]): void;
|
|
80
88
|
/**
|
|
81
|
-
* Unregister a skill by name, removing it from the registry.
|
|
89
|
+
* Unregister a skill by name, removing it from the registry. A locked skill
|
|
90
|
+
* (see {@link lock}) isn't removed.
|
|
82
91
|
* @param name - The skill name to unregister.
|
|
83
|
-
* @returns True if the skill was found and removed
|
|
92
|
+
* @returns True if the skill was found and removed; false if it isn't
|
|
93
|
+
* registered or is locked.
|
|
84
94
|
*/
|
|
85
95
|
unregister(name: string): boolean;
|
|
86
96
|
/**
|
|
@@ -123,6 +133,31 @@ export declare class SkillRegistry {
|
|
|
123
133
|
* @param path - Absolute path to a directory containing skill files.
|
|
124
134
|
*/
|
|
125
135
|
addSearchPath(path: string): void;
|
|
136
|
+
/**
|
|
137
|
+
* Add a directory to search for skills.
|
|
138
|
+
*
|
|
139
|
+
* Mirrors Python's
|
|
140
|
+
* `signalwire.skills.registry.SkillRegistry.add_skill_directory`
|
|
141
|
+
* (`registry.py:407-431`): validate that the path exists and is a
|
|
142
|
+
* directory, then append it (de-duplicated) to `externalPaths`, which
|
|
143
|
+
* {@link discoverAll} scans along with the search paths. Throws
|
|
144
|
+
* `Error` (the JS analog of Python's `ValueError`) for non-existent
|
|
145
|
+
* paths or non-directories. Distinct from `addSearchPath`, which
|
|
146
|
+
* silently accepts anything; `addSkillDirectory` is the strict
|
|
147
|
+
* Python-equivalent surface and the recommended entry point for
|
|
148
|
+
* registering third-party skill directories.
|
|
149
|
+
*
|
|
150
|
+
* @param path - Absolute or relative path to a directory containing
|
|
151
|
+
* skill subdirectories.
|
|
152
|
+
* @throws Error when the path doesn't exist or isn't a directory.
|
|
153
|
+
*/
|
|
154
|
+
addSkillDirectory(path: string): void;
|
|
155
|
+
/**
|
|
156
|
+
* Returns a copy of the external skill directories registered via
|
|
157
|
+
* {@link addSkillDirectory}. The equivalent of Python's
|
|
158
|
+
* `_external_paths`.
|
|
159
|
+
*/
|
|
160
|
+
getExternalPaths(): string[];
|
|
126
161
|
/**
|
|
127
162
|
* Get all configured search paths for skill discovery.
|
|
128
163
|
* @returns Copy of the search paths array.
|
|
@@ -130,13 +165,17 @@ export declare class SkillRegistry {
|
|
|
130
165
|
getSearchPaths(): string[];
|
|
131
166
|
/**
|
|
132
167
|
* Discover and register skills from a directory by importing each file.
|
|
133
|
-
*
|
|
168
|
+
* Imports every `.ts` and `.js` file in the directory (not `.d.ts`), and
|
|
169
|
+
* `skill.ts`, or `skill.js` when there's no `skill.ts`, in each
|
|
170
|
+
* subdirectory. Looks for SkillBase subclass exports and registers them.
|
|
134
171
|
* @param dirPath - Absolute path to the directory to scan.
|
|
135
172
|
* @returns Array of newly discovered skill names.
|
|
136
173
|
*/
|
|
137
174
|
discoverFromDirectory(dirPath: string): Promise<string[]>;
|
|
138
175
|
/**
|
|
139
|
-
* Discover and register skills from
|
|
176
|
+
* Discover and register skills from every configured directory: the search
|
|
177
|
+
* paths ({@link addSearchPath}, `SIGNALWIRE_SKILL_PATHS`) and the
|
|
178
|
+
* directories added with {@link addSkillDirectory}, each once.
|
|
140
179
|
* @returns Array of all newly discovered skill names.
|
|
141
180
|
*/
|
|
142
181
|
discoverAll(): Promise<string[]>;
|
|
@@ -170,7 +209,8 @@ export declare class SkillRegistry {
|
|
|
170
209
|
*/
|
|
171
210
|
get size(): number;
|
|
172
211
|
/**
|
|
173
|
-
* Clear
|
|
212
|
+
* Clear every registration except locked skills (see {@link lock}), which
|
|
213
|
+
* stay registered.
|
|
174
214
|
*/
|
|
175
215
|
clear(): void;
|
|
176
216
|
}
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
*/
|
|
16
16
|
import { SkillBase } from './SkillBase.js';
|
|
17
17
|
import { getLogger } from '../Logger.js';
|
|
18
|
+
import { existsSync, statSync } from 'node:fs';
|
|
18
19
|
const log = getLogger('SkillRegistry');
|
|
19
20
|
let _instance = null;
|
|
20
21
|
/**
|
|
@@ -31,6 +32,11 @@ export class SkillRegistry {
|
|
|
31
32
|
registry = new Map();
|
|
32
33
|
lockedNames = new Set();
|
|
33
34
|
searchPaths;
|
|
35
|
+
/**
|
|
36
|
+
* External skill directories registered via {@link addSkillDirectory}.
|
|
37
|
+
* Mirrors Python's `SkillRegistry._external_paths` (`registry.py:373`).
|
|
38
|
+
*/
|
|
39
|
+
externalPaths = [];
|
|
34
40
|
constructor() {
|
|
35
41
|
const envPaths = process.env['SIGNALWIRE_SKILL_PATHS'];
|
|
36
42
|
this.searchPaths = envPaths ? envPaths.split(':').filter(Boolean) : [];
|
|
@@ -78,7 +84,7 @@ export class SkillRegistry {
|
|
|
78
84
|
}
|
|
79
85
|
}
|
|
80
86
|
catch (err) {
|
|
81
|
-
throw new Error(`${SkillClass.name}.getParameterSchema() failed: ${err instanceof Error ? err.message : String(err)}
|
|
87
|
+
throw new Error(`${SkillClass.name}.getParameterSchema() failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
|
|
82
88
|
}
|
|
83
89
|
if (this.registry.has(name)) {
|
|
84
90
|
log.warn(`Overwriting skill registration: ${name}`);
|
|
@@ -87,8 +93,11 @@ export class SkillRegistry {
|
|
|
87
93
|
log.debug(`Registered skill: ${name}`);
|
|
88
94
|
}
|
|
89
95
|
/**
|
|
90
|
-
* Lock one or more skill names
|
|
91
|
-
*
|
|
96
|
+
* Lock one or more skill names, so they can't be overwritten, unregistered
|
|
97
|
+
* or cleared. `registerBuiltinSkills()` locks the built-in skills, so a
|
|
98
|
+
* built-in can't be replaced by removing it and registering another class
|
|
99
|
+
* under its name. If called with no arguments, locks all currently
|
|
100
|
+
* registered skills.
|
|
92
101
|
* @param names - Skill names to lock; if omitted, all current names are locked.
|
|
93
102
|
*/
|
|
94
103
|
lock(names) {
|
|
@@ -98,11 +107,17 @@ export class SkillRegistry {
|
|
|
98
107
|
}
|
|
99
108
|
}
|
|
100
109
|
/**
|
|
101
|
-
* Unregister a skill by name, removing it from the registry.
|
|
110
|
+
* Unregister a skill by name, removing it from the registry. A locked skill
|
|
111
|
+
* (see {@link lock}) isn't removed.
|
|
102
112
|
* @param name - The skill name to unregister.
|
|
103
|
-
* @returns True if the skill was found and removed
|
|
113
|
+
* @returns True if the skill was found and removed; false if it isn't
|
|
114
|
+
* registered or is locked.
|
|
104
115
|
*/
|
|
105
116
|
unregister(name) {
|
|
117
|
+
if (this.lockedNames.has(name)) {
|
|
118
|
+
log.warn(`Cannot unregister locked skill: ${name}`);
|
|
119
|
+
return false;
|
|
120
|
+
}
|
|
106
121
|
return this.registry.delete(name);
|
|
107
122
|
}
|
|
108
123
|
/**
|
|
@@ -175,6 +190,43 @@ export class SkillRegistry {
|
|
|
175
190
|
this.searchPaths.push(path);
|
|
176
191
|
}
|
|
177
192
|
}
|
|
193
|
+
/**
|
|
194
|
+
* Add a directory to search for skills.
|
|
195
|
+
*
|
|
196
|
+
* Mirrors Python's
|
|
197
|
+
* `signalwire.skills.registry.SkillRegistry.add_skill_directory`
|
|
198
|
+
* (`registry.py:407-431`): validate that the path exists and is a
|
|
199
|
+
* directory, then append it (de-duplicated) to `externalPaths`, which
|
|
200
|
+
* {@link discoverAll} scans along with the search paths. Throws
|
|
201
|
+
* `Error` (the JS analog of Python's `ValueError`) for non-existent
|
|
202
|
+
* paths or non-directories. Distinct from `addSearchPath`, which
|
|
203
|
+
* silently accepts anything; `addSkillDirectory` is the strict
|
|
204
|
+
* Python-equivalent surface and the recommended entry point for
|
|
205
|
+
* registering third-party skill directories.
|
|
206
|
+
*
|
|
207
|
+
* @param path - Absolute or relative path to a directory containing
|
|
208
|
+
* skill subdirectories.
|
|
209
|
+
* @throws Error when the path doesn't exist or isn't a directory.
|
|
210
|
+
*/
|
|
211
|
+
addSkillDirectory(path) {
|
|
212
|
+
if (!existsSync(path)) {
|
|
213
|
+
throw new Error(`Skill directory does not exist: ${path}`);
|
|
214
|
+
}
|
|
215
|
+
if (!statSync(path).isDirectory()) {
|
|
216
|
+
throw new Error(`Path is not a directory: ${path}`);
|
|
217
|
+
}
|
|
218
|
+
if (!this.externalPaths.includes(path)) {
|
|
219
|
+
this.externalPaths.push(path);
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* Returns a copy of the external skill directories registered via
|
|
224
|
+
* {@link addSkillDirectory}. The equivalent of Python's
|
|
225
|
+
* `_external_paths`.
|
|
226
|
+
*/
|
|
227
|
+
getExternalPaths() {
|
|
228
|
+
return [...this.externalPaths];
|
|
229
|
+
}
|
|
178
230
|
/**
|
|
179
231
|
* Get all configured search paths for skill discovery.
|
|
180
232
|
* @returns Copy of the search paths array.
|
|
@@ -184,7 +236,9 @@ export class SkillRegistry {
|
|
|
184
236
|
}
|
|
185
237
|
/**
|
|
186
238
|
* Discover and register skills from a directory by importing each file.
|
|
187
|
-
*
|
|
239
|
+
* Imports every `.ts` and `.js` file in the directory (not `.d.ts`), and
|
|
240
|
+
* `skill.ts`, or `skill.js` when there's no `skill.ts`, in each
|
|
241
|
+
* subdirectory. Looks for SkillBase subclass exports and registers them.
|
|
188
242
|
* @param dirPath - Absolute path to the directory to scan.
|
|
189
243
|
* @returns Array of newly discovered skill names.
|
|
190
244
|
*/
|
|
@@ -201,8 +255,11 @@ export class SkillRegistry {
|
|
|
201
255
|
try {
|
|
202
256
|
const dirEntries = await readdir(dirPath, { withFileTypes: true });
|
|
203
257
|
entries = dirEntries
|
|
204
|
-
.filter(e => (e.isFile() &&
|
|
205
|
-
.
|
|
258
|
+
.filter((e) => (e.isFile() &&
|
|
259
|
+
(e.name.endsWith('.ts') || e.name.endsWith('.js')) &&
|
|
260
|
+
!e.name.endsWith('.d.ts')) ||
|
|
261
|
+
e.isDirectory())
|
|
262
|
+
.map((e) => e.name);
|
|
206
263
|
}
|
|
207
264
|
catch {
|
|
208
265
|
log.warn(`Cannot read skill directory: ${dirPath}`);
|
|
@@ -210,8 +267,17 @@ export class SkillRegistry {
|
|
|
210
267
|
}
|
|
211
268
|
for (const entry of entries) {
|
|
212
269
|
const fullPath = join(dirPath, entry);
|
|
270
|
+
let modulePath = fullPath;
|
|
271
|
+
if (!entry.endsWith('.ts') && !entry.endsWith('.js')) {
|
|
272
|
+
// A skill package: skill.ts, or skill.js when it's compiled.
|
|
273
|
+
modulePath = join(fullPath, 'skill.ts');
|
|
274
|
+
if (!existsSync(modulePath))
|
|
275
|
+
modulePath = join(fullPath, 'skill.js');
|
|
276
|
+
if (!existsSync(modulePath))
|
|
277
|
+
continue;
|
|
278
|
+
}
|
|
213
279
|
try {
|
|
214
|
-
const fileUrl = pathToFileURL(
|
|
280
|
+
const fileUrl = pathToFileURL(modulePath).href;
|
|
215
281
|
const mod = await import(fileUrl);
|
|
216
282
|
// Find any SkillBase subclass exported from the module. Matches
|
|
217
283
|
// Python `registry.py:104-113` which inspects loaded modules for
|
|
@@ -233,12 +299,14 @@ export class SkillRegistry {
|
|
|
233
299
|
return discovered;
|
|
234
300
|
}
|
|
235
301
|
/**
|
|
236
|
-
* Discover and register skills from
|
|
302
|
+
* Discover and register skills from every configured directory: the search
|
|
303
|
+
* paths ({@link addSearchPath}, `SIGNALWIRE_SKILL_PATHS`) and the
|
|
304
|
+
* directories added with {@link addSkillDirectory}, each once.
|
|
237
305
|
* @returns Array of all newly discovered skill names.
|
|
238
306
|
*/
|
|
239
307
|
async discoverAll() {
|
|
240
308
|
const all = [];
|
|
241
|
-
for (const path of this.searchPaths) {
|
|
309
|
+
for (const path of new Set([...this.searchPaths, ...this.externalPaths])) {
|
|
242
310
|
const found = await this.discoverFromDirectory(path);
|
|
243
311
|
all.push(...found);
|
|
244
312
|
}
|
|
@@ -301,10 +369,14 @@ export class SkillRegistry {
|
|
|
301
369
|
return this.registry.size;
|
|
302
370
|
}
|
|
303
371
|
/**
|
|
304
|
-
* Clear
|
|
372
|
+
* Clear every registration except locked skills (see {@link lock}), which
|
|
373
|
+
* stay registered.
|
|
305
374
|
*/
|
|
306
375
|
clear() {
|
|
307
|
-
this.registry.
|
|
376
|
+
for (const name of [...this.registry.keys()]) {
|
|
377
|
+
if (!this.lockedNames.has(name))
|
|
378
|
+
this.registry.delete(name);
|
|
379
|
+
}
|
|
308
380
|
}
|
|
309
381
|
}
|
|
310
382
|
//# sourceMappingURL=SkillRegistry.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SkillRegistry.js","sourceRoot":"","sources":["../../src/skills/SkillRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAA+C,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"SkillRegistry.js","sourceRoot":"","sources":["../../src/skills/SkillRegistry.ts"],"names":[],"mappings":"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"}
|
|
@@ -15,7 +15,9 @@ import type { SkillToolDefinition, SkillPromptSection, SkillConfig, ParameterSch
|
|
|
15
15
|
*
|
|
16
16
|
* @example
|
|
17
17
|
* ```ts
|
|
18
|
-
*
|
|
18
|
+
* import { AgentBase } from '@signalwire/sdk';
|
|
19
|
+
* const agent = new AgentBase({ name: 'demo', route: '/' });
|
|
20
|
+
* await agent.addSkillByName('api_ninjas_trivia', { default_category: 'sciencenature' });
|
|
19
21
|
* ```
|
|
20
22
|
*/
|
|
21
23
|
export declare class ApiNinjasTriviaSkill extends SkillBase {
|