@signalwire/sdk 2.0.1 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/AgentBase.d.ts +1045 -0
- package/dist/AgentBase.js +2375 -0
- package/dist/AgentBase.js.map +1 -0
- package/dist/AgentServer.d.ts +146 -0
- package/dist/AgentServer.js +388 -0
- package/dist/AgentServer.js.map +1 -0
- package/dist/AuthHandler.d.ts +127 -0
- package/dist/AuthHandler.js +212 -0
- package/dist/AuthHandler.js.map +1 -0
- package/dist/ConfigLoader.d.ts +170 -0
- package/dist/ConfigLoader.js +393 -0
- package/dist/ConfigLoader.js.map +1 -0
- package/dist/ContextBuilder.d.ts +652 -0
- package/dist/ContextBuilder.js +1115 -0
- package/dist/ContextBuilder.js.map +1 -0
- package/dist/DataMap.d.ts +271 -0
- package/dist/DataMap.js +430 -0
- package/dist/DataMap.js.map +1 -0
- package/dist/FunctionResult.d.ts +481 -0
- package/dist/FunctionResult.js +775 -0
- package/dist/FunctionResult.js.map +1 -0
- package/dist/Logger.d.ts +113 -0
- package/dist/Logger.js +320 -0
- package/dist/Logger.js.map +1 -0
- package/dist/PomBuilder.d.ts +208 -0
- package/dist/PomBuilder.js +409 -0
- package/dist/PomBuilder.js.map +1 -0
- package/dist/PromptManager.d.ts +85 -0
- package/dist/PromptManager.js +108 -0
- package/dist/PromptManager.js.map +1 -0
- package/dist/SWMLHandler.d.ts +159 -0
- package/dist/SWMLHandler.js +229 -0
- package/dist/SWMLHandler.js.map +1 -0
- package/dist/SWMLService.d.ts +326 -0
- package/dist/SWMLService.js +610 -0
- package/dist/SWMLService.js.map +1 -0
- package/dist/SchemaUtils.d.ts +108 -0
- package/dist/SchemaUtils.js +317 -0
- package/dist/SchemaUtils.js.map +1 -0
- package/dist/SecurityUtils.d.ts +60 -0
- package/{src/SecurityUtils.ts → dist/SecurityUtils.js} +82 -83
- package/dist/SecurityUtils.js.map +1 -0
- package/dist/ServerlessAdapter.d.ts +119 -0
- package/dist/ServerlessAdapter.js +188 -0
- package/dist/ServerlessAdapter.js.map +1 -0
- package/dist/SessionManager.d.ts +142 -0
- package/dist/SessionManager.js +260 -0
- package/dist/SessionManager.js.map +1 -0
- package/dist/SslConfig.d.ts +77 -0
- package/dist/SslConfig.js +100 -0
- package/dist/SslConfig.js.map +1 -0
- package/dist/SwaigFunction.d.ts +159 -0
- package/dist/SwaigFunction.js +209 -0
- package/dist/SwaigFunction.js.map +1 -0
- package/dist/SwmlBuilder.d.ts +165 -0
- package/dist/SwmlBuilder.js +247 -0
- package/dist/SwmlBuilder.js.map +1 -0
- package/dist/SwmlVerbMethods.generated.d.ts +254 -0
- package/dist/SwmlVerbMethods.generated.js +9 -0
- package/dist/SwmlVerbMethods.generated.js.map +1 -0
- package/dist/TypeInference.d.ts +71 -0
- package/dist/TypeInference.js +164 -0
- package/dist/TypeInference.js.map +1 -0
- package/dist/WebService.d.ts +148 -0
- package/dist/WebService.js +532 -0
- package/dist/WebService.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +22 -0
- package/dist/cli/agent-loader.js +144 -0
- package/dist/cli/agent-loader.js.map +1 -0
- package/dist/cli/mock-data.d.ts +37 -0
- package/dist/cli/mock-data.js +80 -0
- package/dist/cli/mock-data.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +32 -0
- package/dist/cli/swaig-test.js +418 -0
- package/dist/cli/swaig-test.js.map +1 -0
- package/dist/generateVerbTypes.d.ts +11 -0
- package/dist/generateVerbTypes.js +265 -0
- package/dist/generateVerbTypes.js.map +1 -0
- package/{src/index.ts → dist/index.d.ts} +13 -100
- package/dist/index.js +152 -0
- package/dist/index.js.map +1 -0
- package/dist/livewire/index.d.ts +653 -0
- package/dist/livewire/index.js +992 -0
- package/dist/livewire/index.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +89 -0
- package/dist/prefabs/ConciergeAgent.js +245 -0
- package/dist/prefabs/ConciergeAgent.js.map +1 -0
- package/dist/prefabs/FAQBotAgent.d.ts +113 -0
- package/dist/prefabs/FAQBotAgent.js +329 -0
- package/dist/prefabs/FAQBotAgent.js.map +1 -0
- package/dist/prefabs/InfoGathererAgent.d.ts +126 -0
- package/dist/prefabs/InfoGathererAgent.js +287 -0
- package/dist/prefabs/InfoGathererAgent.js.map +1 -0
- package/dist/prefabs/ReceptionistAgent.d.ts +104 -0
- package/dist/prefabs/ReceptionistAgent.js +303 -0
- package/dist/prefabs/ReceptionistAgent.js.map +1 -0
- package/dist/prefabs/SurveyAgent.d.ts +148 -0
- package/dist/prefabs/SurveyAgent.js +540 -0
- package/dist/prefabs/SurveyAgent.js.map +1 -0
- package/{src/prefabs/index.ts → dist/prefabs/index.d.ts} +1 -15
- package/dist/prefabs/index.js +14 -0
- package/dist/prefabs/index.js.map +1 -0
- package/dist/relay/Action.d.ts +258 -0
- package/dist/relay/Action.js +402 -0
- package/dist/relay/Action.js.map +1 -0
- package/dist/relay/Call.d.ts +697 -0
- package/dist/relay/Call.js +1062 -0
- package/dist/relay/Call.js.map +1 -0
- package/dist/relay/Deferred.d.ts +44 -0
- package/dist/relay/Deferred.js +69 -0
- package/dist/relay/Deferred.js.map +1 -0
- package/dist/relay/Message.d.ts +103 -0
- package/dist/relay/Message.js +169 -0
- package/dist/relay/Message.js.map +1 -0
- package/dist/relay/RelayClient.d.ts +302 -0
- package/dist/relay/RelayClient.js +1019 -0
- package/dist/relay/RelayClient.js.map +1 -0
- package/dist/relay/RelayError.d.ts +15 -0
- package/dist/relay/RelayError.js +20 -0
- package/dist/relay/RelayError.js.map +1 -0
- package/dist/relay/RelayEvent.d.ts +254 -0
- package/dist/relay/RelayEvent.js +509 -0
- package/dist/relay/RelayEvent.js.map +1 -0
- package/dist/relay/constants.d.ts +90 -0
- package/{src/relay/constants.ts → dist/relay/constants.js} +11 -29
- package/dist/relay/constants.js.map +1 -0
- package/dist/relay/index.d.ts +16 -0
- package/dist/relay/index.js +18 -0
- package/dist/relay/index.js.map +1 -0
- package/dist/relay/types.d.ts +142 -0
- package/dist/relay/types.js +5 -0
- package/dist/relay/types.js.map +1 -0
- package/dist/rest/HttpClient.d.ts +80 -0
- package/dist/rest/HttpClient.js +148 -0
- package/dist/rest/HttpClient.js.map +1 -0
- package/dist/rest/RestError.d.ts +30 -0
- package/dist/rest/RestError.js +39 -0
- package/dist/rest/RestError.js.map +1 -0
- package/dist/rest/base/BaseResource.d.ts +24 -0
- package/dist/rest/base/BaseResource.js +29 -0
- package/dist/rest/base/BaseResource.js.map +1 -0
- package/dist/rest/base/CrudResource.d.ts +68 -0
- package/dist/rest/base/CrudResource.js +82 -0
- package/dist/rest/base/CrudResource.js.map +1 -0
- package/dist/rest/base/CrudWithAddresses.d.ts +22 -0
- package/dist/rest/base/CrudWithAddresses.js +25 -0
- package/dist/rest/base/CrudWithAddresses.js.map +1 -0
- package/dist/rest/index.d.ts +131 -0
- package/{src/rest/index.ts → dist/rest/index.js} +101 -136
- package/dist/rest/index.js.map +1 -0
- package/dist/rest/namespaces/addresses.d.ts +46 -0
- package/dist/rest/namespaces/addresses.js +55 -0
- package/dist/rest/namespaces/addresses.js.map +1 -0
- package/dist/rest/namespaces/calling.d.ts +382 -0
- package/dist/rest/namespaces/calling.js +478 -0
- package/dist/rest/namespaces/calling.js.map +1 -0
- package/dist/rest/namespaces/chat.d.ts +22 -0
- package/dist/rest/namespaces/chat.js +26 -0
- package/dist/rest/namespaces/chat.js.map +1 -0
- package/dist/rest/namespaces/compat.d.ts +585 -0
- package/dist/rest/namespaces/compat.js +735 -0
- package/dist/rest/namespaces/compat.js.map +1 -0
- package/dist/rest/namespaces/datasphere.d.ts +66 -0
- package/dist/rest/namespaces/datasphere.js +77 -0
- package/dist/rest/namespaces/datasphere.js.map +1 -0
- package/dist/rest/namespaces/fabric.d.ts +282 -0
- package/dist/rest/namespaces/fabric.js +373 -0
- package/dist/rest/namespaces/fabric.js.map +1 -0
- package/dist/rest/namespaces/imported-numbers.d.ts +22 -0
- package/dist/rest/namespaces/imported-numbers.js +26 -0
- package/dist/rest/namespaces/imported-numbers.js.map +1 -0
- package/dist/rest/namespaces/logs.d.ts +105 -0
- package/dist/rest/namespaces/logs.js +133 -0
- package/dist/rest/namespaces/logs.js.map +1 -0
- package/dist/rest/namespaces/lookup.d.ts +29 -0
- package/dist/rest/namespaces/lookup.js +32 -0
- package/dist/rest/namespaces/lookup.js.map +1 -0
- package/dist/rest/namespaces/mfa.d.ts +46 -0
- package/dist/rest/namespaces/mfa.js +54 -0
- package/dist/rest/namespaces/mfa.js.map +1 -0
- package/dist/rest/namespaces/number-groups.d.ts +49 -0
- package/dist/rest/namespaces/number-groups.js +58 -0
- package/dist/rest/namespaces/number-groups.js.map +1 -0
- package/dist/rest/namespaces/phone-numbers.d.ts +60 -0
- package/dist/rest/namespaces/phone-numbers.js +67 -0
- package/dist/rest/namespaces/phone-numbers.js.map +1 -0
- package/dist/rest/namespaces/project.d.ts +46 -0
- package/dist/rest/namespaces/project.js +56 -0
- package/dist/rest/namespaces/project.js.map +1 -0
- package/dist/rest/namespaces/pubsub.d.ts +22 -0
- package/dist/rest/namespaces/pubsub.js +26 -0
- package/dist/rest/namespaces/pubsub.js.map +1 -0
- package/dist/rest/namespaces/queues.d.ts +42 -0
- package/dist/rest/namespaces/queues.js +49 -0
- package/dist/rest/namespaces/queues.js.map +1 -0
- package/dist/rest/namespaces/recordings.d.ts +38 -0
- package/dist/rest/namespaces/recordings.js +45 -0
- package/dist/rest/namespaces/recordings.js.map +1 -0
- package/dist/rest/namespaces/registry.d.ts +141 -0
- package/dist/rest/namespaces/registry.js +178 -0
- package/dist/rest/namespaces/registry.js.map +1 -0
- package/dist/rest/namespaces/short-codes.d.ts +39 -0
- package/dist/rest/namespaces/short-codes.js +46 -0
- package/dist/rest/namespaces/short-codes.js.map +1 -0
- package/dist/rest/namespaces/sip-profile.d.ts +28 -0
- package/dist/rest/namespaces/sip-profile.js +34 -0
- package/dist/rest/namespaces/sip-profile.js.map +1 -0
- package/dist/rest/namespaces/verified-callers.d.ts +33 -0
- package/dist/rest/namespaces/verified-callers.js +39 -0
- package/dist/rest/namespaces/verified-callers.js.map +1 -0
- package/dist/rest/namespaces/video.d.ts +235 -0
- package/dist/rest/namespaces/video.js +297 -0
- package/dist/rest/namespaces/video.js.map +1 -0
- package/{src/rest/pagination.ts → dist/rest/pagination.d.ts} +2 -61
- package/dist/rest/pagination.js +78 -0
- package/dist/rest/pagination.js.map +1 -0
- package/dist/rest/types.d.ts +54 -0
- package/dist/rest/types.js +5 -0
- package/dist/rest/types.js.map +1 -0
- package/dist/skills/SkillBase.d.ts +404 -0
- package/dist/skills/SkillBase.js +471 -0
- package/dist/skills/SkillBase.js.map +1 -0
- package/dist/skills/SkillManager.d.ts +195 -0
- package/dist/skills/SkillManager.js +378 -0
- package/dist/skills/SkillManager.js.map +1 -0
- package/dist/skills/SkillRegistry.d.ts +176 -0
- package/dist/skills/SkillRegistry.js +310 -0
- package/dist/skills/SkillRegistry.js.map +1 -0
- package/dist/skills/builtin/api_ninjas_trivia.d.ts +47 -0
- package/dist/skills/builtin/api_ninjas_trivia.js +211 -0
- package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -0
- package/dist/skills/builtin/ask_claude.d.ts +37 -0
- package/dist/skills/builtin/ask_claude.js +162 -0
- package/dist/skills/builtin/ask_claude.js.map +1 -0
- package/dist/skills/builtin/claude_skills.d.ts +75 -0
- package/dist/skills/builtin/claude_skills.js +753 -0
- package/dist/skills/builtin/claude_skills.js.map +1 -0
- package/dist/skills/builtin/custom_skills.d.ts +79 -0
- package/dist/skills/builtin/custom_skills.js +227 -0
- package/dist/skills/builtin/custom_skills.js.map +1 -0
- package/dist/skills/builtin/datasphere.d.ts +73 -0
- package/dist/skills/builtin/datasphere.js +350 -0
- package/dist/skills/builtin/datasphere.js.map +1 -0
- package/dist/skills/builtin/datasphere_serverless.d.ts +89 -0
- package/dist/skills/builtin/datasphere_serverless.js +291 -0
- package/dist/skills/builtin/datasphere_serverless.js.map +1 -0
- package/dist/skills/builtin/datetime.d.ts +40 -0
- package/dist/skills/builtin/datetime.js +118 -0
- package/dist/skills/builtin/datetime.js.map +1 -0
- package/dist/skills/builtin/google_maps.d.ts +48 -0
- package/dist/skills/builtin/google_maps.js +470 -0
- package/dist/skills/builtin/google_maps.js.map +1 -0
- package/dist/skills/builtin/index.d.ts +31 -0
- package/{src/skills/builtin/index.ts → dist/skills/builtin/index.js} +30 -36
- package/dist/skills/builtin/index.js.map +1 -0
- package/dist/skills/builtin/info_gatherer.d.ts +115 -0
- package/dist/skills/builtin/info_gatherer.js +328 -0
- package/dist/skills/builtin/info_gatherer.js.map +1 -0
- package/dist/skills/builtin/joke.d.ts +41 -0
- package/dist/skills/builtin/joke.js +156 -0
- package/dist/skills/builtin/joke.js.map +1 -0
- package/dist/skills/builtin/math.d.ts +39 -0
- package/dist/skills/builtin/math.js +119 -0
- package/dist/skills/builtin/math.js.map +1 -0
- package/dist/skills/builtin/mcp_gateway.d.ts +82 -0
- package/dist/skills/builtin/mcp_gateway.js +574 -0
- package/dist/skills/builtin/mcp_gateway.js.map +1 -0
- package/dist/skills/builtin/native_vector_search.d.ts +128 -0
- package/dist/skills/builtin/native_vector_search.js +752 -0
- package/dist/skills/builtin/native_vector_search.js.map +1 -0
- package/dist/skills/builtin/play_background_file.d.ts +59 -0
- package/dist/skills/builtin/play_background_file.js +274 -0
- package/dist/skills/builtin/play_background_file.js.map +1 -0
- package/dist/skills/builtin/spider.d.ts +91 -0
- package/dist/skills/builtin/spider.js +758 -0
- package/dist/skills/builtin/spider.js.map +1 -0
- package/dist/skills/builtin/swml_transfer.d.ts +66 -0
- package/dist/skills/builtin/swml_transfer.js +475 -0
- package/dist/skills/builtin/swml_transfer.js.map +1 -0
- package/dist/skills/builtin/weather_api.d.ts +59 -0
- package/dist/skills/builtin/weather_api.js +196 -0
- package/dist/skills/builtin/weather_api.js.map +1 -0
- package/dist/skills/builtin/web_search.d.ts +160 -0
- package/dist/skills/builtin/web_search.js +894 -0
- package/dist/skills/builtin/web_search.js.map +1 -0
- package/dist/skills/builtin/wikipedia_search.d.ts +77 -0
- package/dist/skills/builtin/wikipedia_search.js +241 -0
- package/dist/skills/builtin/wikipedia_search.js.map +1 -0
- package/{src/skills/index.ts → dist/skills/index.d.ts} +0 -1
- package/dist/skills/index.js +10 -0
- package/dist/skills/index.js.map +1 -0
- package/dist/types.d.ts +118 -0
- package/dist/types.js +5 -0
- package/dist/types.js.map +1 -0
- package/package.json +7 -1
- package/.github/workflows/publish.yml +0 -27
- package/.github/workflows/test.yml +0 -17
- package/CLAUDE.md +0 -112
- package/docs/MIGRATION-2.0.md +0 -81
- package/docs/agent-guide.md +0 -869
- package/docs/agent_guide.md +0 -1026
- package/docs/api-reference.md +0 -2420
- package/docs/api_reference.md +0 -1301
- package/docs/architecture.md +0 -843
- package/docs/cli-guide.md +0 -579
- package/docs/cli_guide.md +0 -448
- package/docs/cloud_functions_guide.md +0 -474
- package/docs/configuration.md +0 -422
- package/docs/contexts-guide.md +0 -787
- package/docs/contexts_guide.md +0 -511
- package/docs/datamap-guide.md +0 -1141
- package/docs/datamap_guide.md +0 -595
- package/docs/llm_parameters.md +0 -239
- package/docs/mcp_gateway_reference.md +0 -648
- package/docs/mcp_integration.md +0 -108
- package/docs/prefabs-guide.md +0 -800
- package/docs/sdk_features.md +0 -477
- package/docs/security.md +0 -436
- package/docs/serverless-guide.md +0 -513
- package/docs/skills-guide.md +0 -857
- package/docs/skills-system.md +0 -301
- package/docs/skills_parameter_schema.md +0 -392
- package/docs/skills_system.md +0 -467
- package/docs/swaig-reference.md +0 -1627
- package/docs/swaig_reference.md +0 -910
- package/docs/swml_service_guide.md +0 -600
- package/docs/third_party_skills.md +0 -533
- package/docs/web_service.md +0 -677
- package/examples/README.md +0 -131
- package/examples/advanced-datamap.ts +0 -100
- package/examples/advanced-dynamic-config.ts +0 -70
- package/examples/auto-vivified.ts +0 -94
- package/examples/call-flow.ts +0 -63
- package/examples/comprehensive-dynamic.ts +0 -125
- package/examples/contexts-steps.ts +0 -65
- package/examples/custom-path.ts +0 -45
- package/examples/datamap-tools.ts +0 -55
- package/examples/datasphere-multi-instance.ts +0 -63
- package/examples/datasphere-serverless-env.ts +0 -68
- package/examples/datasphere-webhook-env.ts +0 -66
- package/examples/datasphere.ts +0 -37
- package/examples/declarative.ts +0 -100
- package/examples/dynamic-config.ts +0 -54
- package/examples/dynamic-info-gatherer.ts +0 -69
- package/examples/dynamic-swml-service.ts +0 -67
- package/examples/gather-info.ts +0 -71
- package/examples/gather-per-question-functions-demo.ts +0 -140
- package/examples/joke-agent.ts +0 -34
- package/examples/kubernetes-agent.ts +0 -45
- package/examples/llm-params.ts +0 -69
- package/examples/mcp-agent.ts +0 -84
- package/examples/mcp-gateway.ts +0 -35
- package/examples/multi-agent.ts +0 -73
- package/examples/multi-endpoint.ts +0 -79
- package/examples/pom-prompt.ts +0 -71
- package/examples/prefab-concierge.ts +0 -47
- package/examples/prefab-faq.ts +0 -54
- package/examples/prefab-info-gatherer.ts +0 -33
- package/examples/prefab-receptionist.ts +0 -36
- package/examples/prefab-survey.ts +0 -68
- package/examples/record-call.ts +0 -67
- package/examples/relay-demo.ts +0 -33
- package/examples/room-and-sip.ts +0 -94
- package/examples/serverless-lambda.ts +0 -35
- package/examples/session-state.ts +0 -83
- package/examples/simple-agent.ts +0 -36
- package/examples/simple-static.ts +0 -29
- package/examples/skills-demo.ts +0 -38
- package/examples/step-function-inheritance-demo.ts +0 -124
- package/examples/swaig-features.ts +0 -187
- package/examples/swml-service-routing.ts +0 -66
- package/examples/swml-service.ts +0 -38
- package/examples/tap.ts +0 -68
- package/examples/verb-methods.ts +0 -45
- package/examples/web-search-multi-instance.ts +0 -72
- package/examples/web-search.ts +0 -38
- package/examples/wikipedia.ts +0 -36
- package/livewire/README.md +0 -140
- package/livewire/docs/migration-guide.md +0 -228
- package/livewire/examples/livewire-basic-agent.ts +0 -74
- package/livewire/examples/livewire-handoff.ts +0 -197
- package/livewire/examples/livewire-multi-tool.ts +0 -117
- package/relay/README.md +0 -70
- package/relay/RELAY_IMPLEMENTATION_GUIDE.md +0 -1257
- package/relay/docs/call-methods.md +0 -474
- package/relay/docs/client-reference.md +0 -142
- package/relay/docs/events.md +0 -134
- package/relay/docs/getting-started.md +0 -134
- package/relay/docs/guide.md +0 -306
- package/relay/docs/messaging.md +0 -182
- package/relay/examples/relay-inbound.ts +0 -66
- package/relay/examples/relay-messaging.ts +0 -71
- package/relay/examples/relay-outbound.ts +0 -76
- package/rest/README.md +0 -95
- package/rest/docs/calling.md +0 -273
- package/rest/docs/client-reference.md +0 -107
- package/rest/docs/compat.md +0 -204
- package/rest/docs/fabric.md +0 -183
- package/rest/docs/getting-started.md +0 -110
- package/rest/docs/guide.md +0 -351
- package/rest/docs/namespaces.md +0 -285
- package/rest/examples/rest-10dlc-registration.ts +0 -161
- package/rest/examples/rest-calling-ivr-and-ai.ts +0 -102
- package/rest/examples/rest-calling-play-and-record.ts +0 -91
- package/rest/examples/rest-client.ts +0 -65
- package/rest/examples/rest-compat-laml.ts +0 -210
- package/rest/examples/rest-datasphere-search.ts +0 -82
- package/rest/examples/rest-fabric-conferences-and-routing.ts +0 -144
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +0 -108
- package/rest/examples/rest-fabric-swml-and-callflows.ts +0 -99
- package/rest/examples/rest-manage-resources.ts +0 -65
- package/rest/examples/rest-phone-number-management.ts +0 -197
- package/rest/examples/rest-queues-mfa-and-recordings.ts +0 -143
- package/rest/examples/rest-video-rooms.ts +0 -186
- package/src/AgentBase.ts +0 -2598
- package/src/AgentServer.ts +0 -442
- package/src/AuthHandler.ts +0 -256
- package/src/ConfigLoader.ts +0 -447
- package/src/ContextBuilder.ts +0 -1181
- package/src/DataMap.ts +0 -477
- package/src/FunctionResult.ts +0 -903
- package/src/Logger.ts +0 -337
- package/src/PomBuilder.ts +0 -467
- package/src/PromptManager.ts +0 -133
- package/src/SWMLHandler.ts +0 -298
- package/src/SWMLService.ts +0 -749
- package/src/SchemaUtils.ts +0 -361
- package/src/ServerlessAdapter.ts +0 -240
- package/src/SessionManager.ts +0 -311
- package/src/SslConfig.ts +0 -118
- package/src/SwaigFunction.ts +0 -276
- package/src/SwmlBuilder.ts +0 -283
- package/src/SwmlVerbMethods.generated.ts +0 -234
- package/src/TypeInference.ts +0 -199
- package/src/WebService.ts +0 -641
- package/src/cli/agent-loader.ts +0 -166
- package/src/cli/mock-data.ts +0 -111
- package/src/cli/swaig-test.ts +0 -452
- package/src/generateVerbTypes.ts +0 -322
- package/src/livewire/index.ts +0 -1252
- package/src/prefabs/ConciergeAgent.ts +0 -309
- package/src/prefabs/FAQBotAgent.ts +0 -415
- package/src/prefabs/InfoGathererAgent.ts +0 -379
- package/src/prefabs/ReceptionistAgent.ts +0 -395
- package/src/prefabs/SurveyAgent.ts +0 -671
- package/src/relay/Action.ts +0 -482
- package/src/relay/Call.ts +0 -1270
- package/src/relay/Deferred.ts +0 -94
- package/src/relay/Message.ts +0 -199
- package/src/relay/RelayClient.ts +0 -1185
- package/src/relay/RelayError.ts +0 -20
- package/src/relay/RelayEvent.ts +0 -944
- package/src/relay/index.ts +0 -123
- package/src/relay/types.ts +0 -149
- package/src/rest/HttpClient.ts +0 -164
- package/src/rest/RestError.ts +0 -45
- package/src/rest/base/BaseResource.ts +0 -32
- package/src/rest/base/CrudResource.ts +0 -98
- package/src/rest/base/CrudWithAddresses.ts +0 -37
- package/src/rest/namespaces/addresses.ts +0 -64
- package/src/rest/namespaces/calling.ts +0 -534
- package/src/rest/namespaces/chat.ts +0 -31
- package/src/rest/namespaces/compat.ts +0 -812
- package/src/rest/namespaces/datasphere.ts +0 -88
- package/src/rest/namespaces/fabric.ts +0 -417
- package/src/rest/namespaces/imported-numbers.ts +0 -31
- package/src/rest/namespaces/logs.ts +0 -151
- package/src/rest/namespaces/lookup.ts +0 -38
- package/src/rest/namespaces/mfa.ts +0 -61
- package/src/rest/namespaces/number-groups.ts +0 -68
- package/src/rest/namespaces/phone-numbers.ts +0 -76
- package/src/rest/namespaces/project.ts +0 -65
- package/src/rest/namespaces/pubsub.ts +0 -31
- package/src/rest/namespaces/queues.ts +0 -58
- package/src/rest/namespaces/recordings.ts +0 -53
- package/src/rest/namespaces/registry.ts +0 -200
- package/src/rest/namespaces/short-codes.ts +0 -54
- package/src/rest/namespaces/sip-profile.ts +0 -40
- package/src/rest/namespaces/verified-callers.ts +0 -46
- package/src/rest/namespaces/video.ts +0 -332
- package/src/rest/types.ts +0 -61
- package/src/skills/SkillBase.ts +0 -582
- package/src/skills/SkillManager.ts +0 -419
- package/src/skills/SkillRegistry.ts +0 -367
- package/src/skills/builtin/api_ninjas_trivia.ts +0 -285
- package/src/skills/builtin/ask_claude.ts +0 -246
- package/src/skills/builtin/claude_skills.ts +0 -983
- package/src/skills/builtin/custom_skills.ts +0 -327
- package/src/skills/builtin/datasphere.ts +0 -447
- package/src/skills/builtin/datasphere_serverless.ts +0 -347
- package/src/skills/builtin/datetime.ts +0 -137
- package/src/skills/builtin/google_maps.ts +0 -656
- package/src/skills/builtin/info_gatherer.ts +0 -415
- package/src/skills/builtin/joke.ts +0 -196
- package/src/skills/builtin/math.ts +0 -149
- package/src/skills/builtin/mcp_gateway.ts +0 -685
- package/src/skills/builtin/native_vector_search.ts +0 -910
- package/src/skills/builtin/play_background_file.ts +0 -367
- package/src/skills/builtin/spider.ts +0 -874
- package/src/skills/builtin/swml_transfer.ts +0 -645
- package/src/skills/builtin/weather_api.ts +0 -255
- package/src/skills/builtin/web_search.ts +0 -1083
- package/src/skills/builtin/wikipedia_search.ts +0 -304
- package/src/types.ts +0 -132
- package/tests/AgentBase.test.ts +0 -1093
- package/tests/AgentServer.test.ts +0 -126
- package/tests/AuthHandler.test.ts +0 -133
- package/tests/ConfigLoader.test.ts +0 -151
- package/tests/ContextBuilder.test.ts +0 -108
- package/tests/DataMap.test.ts +0 -367
- package/tests/EphemeralSkillCopy.test.ts +0 -107
- package/tests/FunctionResult.test.ts +0 -298
- package/tests/GracefulShutdown.test.ts +0 -46
- package/tests/Logger.test.ts +0 -420
- package/tests/PomBuilder.test.ts +0 -228
- package/tests/ProxyDetection.test.ts +0 -228
- package/tests/SWMLService.test.ts +0 -320
- package/tests/SWMLVerbHandler.test.ts +0 -523
- package/tests/SchemaUtils.test.ts +0 -106
- package/tests/SchemaUtils.verb.test.ts +0 -206
- package/tests/SecurityUtils.test.ts +0 -192
- package/tests/ServerlessAdapter.test.ts +0 -222
- package/tests/SessionManager.test.ts +0 -257
- package/tests/SkillBaseFeatures.test.ts +0 -130
- package/tests/SkillMultiInstance.test.ts +0 -102
- package/tests/SkillParameterSchemas.test.ts +0 -134
- package/tests/SkillRegistrySchema.test.ts +0 -84
- package/tests/SslConfig.test.ts +0 -97
- package/tests/SwmlBuilder.test.ts +0 -400
- package/tests/TypeInference.test.ts +0 -165
- package/tests/VerbHandlerRegistry.test.ts +0 -128
- package/tests/cli/mock-data.test.ts +0 -113
- package/tests/cli/swaig-test.test.ts +0 -108
- package/tests/examples.test.ts +0 -194
- package/tests/fixtures/scrape-parity/README.md +0 -53
- package/tests/fixtures/scrape-parity/expected/01_simple_article.json +0 -5
- package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +0 -5
- package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +0 -5
- package/tests/fixtures/scrape-parity/expected/04_bare_body.json +0 -5
- package/tests/fixtures/scrape-parity/expected/05_malformed.json +0 -5
- package/tests/fixtures/scrape-parity/expected/06_multi_class.json +0 -5
- package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +0 -5
- package/tests/fixtures/scrape-parity/expected/08_inline_script.json +0 -5
- package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +0 -5
- package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +0 -5
- package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +0 -5
- package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +0 -5
- package/tests/fixtures/scrape-parity/html/01_simple_article.html +0 -18
- package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +0 -18
- package/tests/fixtures/scrape-parity/html/03_nested_containers.html +0 -13
- package/tests/fixtures/scrape-parity/html/04_bare_body.html +0 -9
- package/tests/fixtures/scrape-parity/html/05_malformed.html +0 -11
- package/tests/fixtures/scrape-parity/html/06_multi_class.html +0 -18
- package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +0 -12
- package/tests/fixtures/scrape-parity/html/08_inline_script.html +0 -17
- package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +0 -21
- package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +0 -10
- package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +0 -13
- package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +0 -24
- package/tests/fixtures/scrape-parity/python_extract.py +0 -109
- package/tests/livewire/livewire.test.ts +0 -780
- package/tests/mcp.test.ts +0 -221
- package/tests/prefabs/prefabs.test.ts +0 -1093
- package/tests/relay/Action.test.ts +0 -392
- package/tests/relay/Call.test.ts +0 -535
- package/tests/relay/Deferred.test.ts +0 -71
- package/tests/relay/Message.test.ts +0 -164
- package/tests/relay/RelayClient.test.ts +0 -779
- package/tests/relay/RelayEvent.test.ts +0 -463
- package/tests/relay/helpers.ts +0 -79
- package/tests/rest/HttpClient.test.ts +0 -274
- package/tests/rest/RestError.test.ts +0 -53
- package/tests/rest/calling.test.ts +0 -156
- package/tests/rest/client.test.ts +0 -197
- package/tests/rest/compat.test.ts +0 -335
- package/tests/rest/datasphere.test.ts +0 -71
- package/tests/rest/fabric.test.ts +0 -186
- package/tests/rest/helpers.ts +0 -95
- package/tests/rest/logs.test.ts +0 -68
- package/tests/rest/pagination.test.ts +0 -133
- package/tests/rest/registry.test.ts +0 -94
- package/tests/rest/relay-rest.test.ts +0 -290
- package/tests/rest/video.test.ts +0 -173
- package/tests/setup.ts +0 -6
- package/tests/skills/SkillBase.test.ts +0 -108
- package/tests/skills/SkillManager.test.ts +0 -268
- package/tests/skills/SkillRegistry.test.ts +0 -176
- package/tests/skills/builtin.test.ts +0 -1472
- package/tests/skills/claude-skills.test.ts +0 -54
- package/tests/skills/custom-skills.test.ts +0 -53
- package/tests/skills/datasphere-serverless.test.ts +0 -70
- package/tests/skills/datasphere.test.ts +0 -107
- package/tests/skills/datetime.test.ts +0 -101
- package/tests/skills/google-maps.test.ts +0 -78
- package/tests/skills/info-gatherer.test.ts +0 -411
- package/tests/skills/joke.test.ts +0 -81
- package/tests/skills/math.test.ts +0 -68
- package/tests/skills/mcp-gateway.test.ts +0 -101
- package/tests/skills/play-background.test.ts +0 -54
- package/tests/skills/spider.test.ts +0 -108
- package/tests/skills/swml-transfer.test.ts +0 -178
- package/tests/skills/trivia.test.ts +0 -54
- package/tests/skills/vector-search.test.ts +0 -135
- package/tests/skills/weather-api.test.ts +0 -77
- package/tests/skills/web-search-parity.test.ts +0 -59
- package/tests/skills/web-search.test.ts +0 -103
- package/tests/skills/wikipedia.test.ts +0 -63
- package/tsconfig.json +0 -18
- package/vitest.config.ts +0 -9
- /package/{src → dist}/schema.json +0 -0
|
@@ -0,0 +1,378 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SkillManager - Manages skill lifecycle for an agent.
|
|
3
|
+
*
|
|
4
|
+
* Handles loading, unloading, validation, and injection of
|
|
5
|
+
* skill tools, hints, global data, and prompt sections.
|
|
6
|
+
*/
|
|
7
|
+
import { SkillRegistry } from './SkillRegistry.js';
|
|
8
|
+
import { getLogger } from '../Logger.js';
|
|
9
|
+
const log = getLogger('SkillManager');
|
|
10
|
+
/**
|
|
11
|
+
* Manages the lifecycle of skills attached to an agent.
|
|
12
|
+
*
|
|
13
|
+
* Handles loading, unloading, validation, and aggregation of skill tools,
|
|
14
|
+
* hints, global data, and prompt sections.
|
|
15
|
+
*
|
|
16
|
+
* @remarks
|
|
17
|
+
* **Architectural note — push vs pull model:**
|
|
18
|
+
* Python's `SkillManager.__init__(self, agent)` stores the agent reference and
|
|
19
|
+
* uses a **push model**: when a skill is loaded via `load_skill()`, the manager
|
|
20
|
+
* immediately calls `agent.add_hints()`, `agent.update_global_data()`, and
|
|
21
|
+
* `agent.prompt_add_section()` to inject skill data into the agent.
|
|
22
|
+
*
|
|
23
|
+
* This TypeScript implementation uses a **pull model** instead: `SkillManager`
|
|
24
|
+
* has no agent reference and no constructor. `AgentBase` owns the manager and
|
|
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.
|
|
30
|
+
*/
|
|
31
|
+
export class SkillManager {
|
|
32
|
+
skills = new Map();
|
|
33
|
+
skillMeta = new Map();
|
|
34
|
+
/**
|
|
35
|
+
* Public read-only view of all loaded skill instances, keyed by instance key.
|
|
36
|
+
* Python equivalent: `self.loaded_skills` (public `Dict[str, SkillBase]`).
|
|
37
|
+
*
|
|
38
|
+
* Use this to iterate or inspect loaded skills without mutating the internal map.
|
|
39
|
+
*/
|
|
40
|
+
get loadedSkills() {
|
|
41
|
+
return this.skills;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Add a skill to the manager, validating env vars and calling setup().
|
|
45
|
+
* Uses the skill's instance key for deduplication.
|
|
46
|
+
*
|
|
47
|
+
* {@link loadSkill} / {@link loadSkillByName} wrap this and catch to return
|
|
48
|
+
* `[false, msg]`, matching Python `load_skill`'s return contract
|
|
49
|
+
* (`skill_manager.py` lines 114-118).
|
|
50
|
+
*
|
|
51
|
+
* @param skill - The skill instance to add.
|
|
52
|
+
* @returns Resolves once the skill is registered.
|
|
53
|
+
* @throws {Error} When a single-instance skill is already loaded, its
|
|
54
|
+
* required environment variables are missing, its parameter schema is
|
|
55
|
+
* empty, its required packages cannot be imported, or `setup()` returns
|
|
56
|
+
* `false`.
|
|
57
|
+
*/
|
|
58
|
+
async addSkill(skill) {
|
|
59
|
+
const name = skill.skillName;
|
|
60
|
+
const instanceKey = skill.getInstanceKey();
|
|
61
|
+
const SkillClass = skill.constructor;
|
|
62
|
+
// Duplicate detection using instance key
|
|
63
|
+
if (this.skills.has(instanceKey)) {
|
|
64
|
+
if (!SkillClass.SUPPORTS_MULTIPLE_INSTANCES) {
|
|
65
|
+
throw new Error(`Skill '${name}' is already loaded and does not support multiple instances`);
|
|
66
|
+
}
|
|
67
|
+
log.warn(`Skill '${name}' with key '${instanceKey}' already loaded, skipping duplicate`);
|
|
68
|
+
return;
|
|
69
|
+
}
|
|
70
|
+
// Validate required env vars — throw on miss; loadSkill/loadSkillByName
|
|
71
|
+
// catch and convert to `[false, msg]` to match Python load_skill's return
|
|
72
|
+
// contract (skill_manager.py lines 114-118).
|
|
73
|
+
const missingEnvVars = skill.validateEnvVars();
|
|
74
|
+
if (missingEnvVars.length > 0) {
|
|
75
|
+
throw new Error(`Cannot load skill '${name}': missing environment variables: ${missingEnvVars.join(', ')}`);
|
|
76
|
+
}
|
|
77
|
+
// Parameter schema contract — partial port of Python load_skill checks
|
|
78
|
+
// (skill_manager.py:49-93). Python additionally requires the subclass to
|
|
79
|
+
// override get_parameter_schema; we skip that identity check because TS
|
|
80
|
+
// test fixtures and trivial skills routinely inherit the base schema
|
|
81
|
+
// without harm, and the TS type system already enforces that
|
|
82
|
+
// getParameterSchema is a callable classmethod returning the right shape.
|
|
83
|
+
const schema = SkillClass.getParameterSchema();
|
|
84
|
+
if (!schema || typeof schema !== 'object' || Object.keys(schema).length === 0) {
|
|
85
|
+
throw new Error(`Skill '${name}'.getParameterSchema() must return a non-empty object`);
|
|
86
|
+
}
|
|
87
|
+
log.debug(`Skill '${name}' has ${Object.keys(schema).length} config params`);
|
|
88
|
+
// Validate required packages — Python equivalent at skill_manager.py:121-131.
|
|
89
|
+
// Throw on miss; wrappers catch and convert to [false, msg].
|
|
90
|
+
const missingPackages = await skill.validatePackages();
|
|
91
|
+
if (missingPackages.length > 0) {
|
|
92
|
+
throw new Error(`Cannot load skill '${name}': missing required packages: ${missingPackages.join(', ')}`);
|
|
93
|
+
}
|
|
94
|
+
// Setup — returns boolean indicating success. Matches Python load_skill
|
|
95
|
+
// (skill_manager.py:134-137): setup() returning false is fatal, the skill
|
|
96
|
+
// is NOT registered, and the caller gets [false, msg] via the wrappers.
|
|
97
|
+
// Python fails closed so the AI never sees a tool whose skill knows it
|
|
98
|
+
// isn't configured correctly.
|
|
99
|
+
const setupOk = await skill.setup();
|
|
100
|
+
if (!setupOk) {
|
|
101
|
+
throw new Error(`Failed to setup skill '${name}'`);
|
|
102
|
+
}
|
|
103
|
+
skill.markInitialized();
|
|
104
|
+
this.skills.set(instanceKey, skill);
|
|
105
|
+
this.skillMeta.set(instanceKey, {
|
|
106
|
+
SkillClass,
|
|
107
|
+
config: { ...skill['config'] },
|
|
108
|
+
skillName: name,
|
|
109
|
+
});
|
|
110
|
+
log.debug(`Added skill '${name}' (key: ${instanceKey})`);
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Remove a skill by its instance key or instance ID, calling cleanup() before removal.
|
|
114
|
+
* @param keyOrId - The instance key or instance ID of the skill to remove.
|
|
115
|
+
* @returns True if the skill was found and removed, false otherwise.
|
|
116
|
+
*
|
|
117
|
+
* @remarks Equivalent to Python's `unload_skill(skill_identifier)`. Callers porting
|
|
118
|
+
* from Python should change `skill_manager.unload_skill(id)` →
|
|
119
|
+
* `skillManager.removeSkill(id)`.
|
|
120
|
+
*/
|
|
121
|
+
async removeSkill(keyOrId) {
|
|
122
|
+
// Try by instance key first
|
|
123
|
+
let skill = this.skills.get(keyOrId);
|
|
124
|
+
let key = keyOrId;
|
|
125
|
+
// Fallback: search by instanceId for backward compatibility
|
|
126
|
+
if (!skill) {
|
|
127
|
+
for (const [k, s] of this.skills) {
|
|
128
|
+
if (s.instanceId === keyOrId) {
|
|
129
|
+
skill = s;
|
|
130
|
+
key = k;
|
|
131
|
+
break;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
if (!skill)
|
|
136
|
+
return false;
|
|
137
|
+
await skill.cleanup();
|
|
138
|
+
this.skills.delete(key);
|
|
139
|
+
this.skillMeta.delete(key);
|
|
140
|
+
log.debug(`Removed skill '${skill.skillName}' (${key})`);
|
|
141
|
+
return true;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Remove all skill instances matching a given skill name.
|
|
145
|
+
* @param skillName - The skill name to match against.
|
|
146
|
+
* @returns The number of skill instances removed.
|
|
147
|
+
*/
|
|
148
|
+
async removeSkillByName(skillName) {
|
|
149
|
+
let count = 0;
|
|
150
|
+
for (const [key, skill] of this.skills) {
|
|
151
|
+
if (skill.skillName === skillName) {
|
|
152
|
+
await skill.cleanup();
|
|
153
|
+
this.skills.delete(key);
|
|
154
|
+
this.skillMeta.delete(key);
|
|
155
|
+
count++;
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
return count;
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* Check if any skill instance with the given name is currently loaded.
|
|
162
|
+
* @param skillName - The skill name to check for.
|
|
163
|
+
* @returns True if at least one instance with this name is loaded.
|
|
164
|
+
*/
|
|
165
|
+
hasSkill(skillName) {
|
|
166
|
+
for (const skill of this.skills.values()) {
|
|
167
|
+
if (skill.skillName === skillName)
|
|
168
|
+
return true;
|
|
169
|
+
}
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Check if a skill with the given instance key is currently loaded.
|
|
174
|
+
* This matches Python's `has_skill` semantics, which performs a direct
|
|
175
|
+
* dictionary key lookup (`skill_identifier in self.loaded_skills`).
|
|
176
|
+
*
|
|
177
|
+
* Use `hasSkill(name)` to check by skill name (iterates values).
|
|
178
|
+
* Use `hasSkillByKey(key)` to check by instance key (direct map lookup).
|
|
179
|
+
*
|
|
180
|
+
* @param instanceKey - The instance key to look up.
|
|
181
|
+
* @returns True if a skill with this exact instance key is loaded.
|
|
182
|
+
*
|
|
183
|
+
* @remarks Equivalent to Python's `has_skill(skill_identifier)`. Callers porting
|
|
184
|
+
* from Python should change `skill_manager.has_skill(key)` →
|
|
185
|
+
* `skillManager.hasSkillByKey(key)`.
|
|
186
|
+
*/
|
|
187
|
+
hasSkillByKey(instanceKey) {
|
|
188
|
+
return this.skills.has(instanceKey);
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* Load a skill by providing the class constructor directly, bypassing the registry.
|
|
192
|
+
* This is the TypeScript equivalent of Python's `load_skill(skill_name, skill_class, params)`
|
|
193
|
+
* path where a caller-provided `skill_class` is used instead of a registry lookup.
|
|
194
|
+
*
|
|
195
|
+
* @param skillClass - The skill class constructor (a subclass of `SkillBase`).
|
|
196
|
+
* @param config - Optional configuration to pass to the skill constructor.
|
|
197
|
+
* @returns A tuple `[success, errorMessage]` matching Python's `load_skill` return
|
|
198
|
+
* contract. `errorMessage` is an empty string on success.
|
|
199
|
+
*
|
|
200
|
+
* @remarks Equivalent to Python's `load_skill(skill_name, skill_class=MySkillClass, params)`.
|
|
201
|
+
*
|
|
202
|
+
* @example
|
|
203
|
+
* ```ts
|
|
204
|
+
* const [ok, err] = await manager.loadSkill(MyCustomSkill, { api_key: 'secret' });
|
|
205
|
+
* if (!ok) console.error(err);
|
|
206
|
+
* ```
|
|
207
|
+
*/
|
|
208
|
+
async loadSkill(skillClass, config) {
|
|
209
|
+
try {
|
|
210
|
+
// Concrete skill subclasses override the constructor to take only (config?: SkillConfig).
|
|
211
|
+
// Cast to reflect actual runtime signature — the base class requires `skillName` but
|
|
212
|
+
// concrete subclasses hardcode it in super(...), so only config is needed at the call site.
|
|
213
|
+
const SkillCtor = skillClass;
|
|
214
|
+
const skill = new SkillCtor(config);
|
|
215
|
+
await this.addSkill(skill);
|
|
216
|
+
return [true, ''];
|
|
217
|
+
}
|
|
218
|
+
catch (err) {
|
|
219
|
+
const errorMsg = `Error loading skill: ${err instanceof Error ? err.message : String(err)}`;
|
|
220
|
+
log.error(errorMsg);
|
|
221
|
+
return [false, errorMsg];
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* Load a skill by name from the global SkillRegistry, construct it, and add it.
|
|
226
|
+
* This is the TypeScript equivalent of Python's `load_skill(skill_name)` path
|
|
227
|
+
* where `skill_class=None` triggers a registry lookup.
|
|
228
|
+
*
|
|
229
|
+
* @param skillName - The registered skill name to look up in the SkillRegistry.
|
|
230
|
+
* @param config - Optional configuration to pass to the skill factory.
|
|
231
|
+
* @returns A tuple `[success, errorMessage]` matching Python's `load_skill` return
|
|
232
|
+
* contract. `errorMessage` is an empty string on success.
|
|
233
|
+
*
|
|
234
|
+
* @remarks Equivalent to Python's `load_skill(skill_name)` (registry path, where
|
|
235
|
+
* `skill_class=None`). Callers porting from Python should change
|
|
236
|
+
* `skill_manager.load_skill(name)` → `skillManager.loadSkillByName(name)`.
|
|
237
|
+
*/
|
|
238
|
+
async loadSkillByName(skillName, config) {
|
|
239
|
+
const registry = SkillRegistry.getInstance();
|
|
240
|
+
if (!registry.has(skillName)) {
|
|
241
|
+
const errorMsg = `Skill '${skillName}' not found in registry`;
|
|
242
|
+
log.error(errorMsg);
|
|
243
|
+
return [false, errorMsg];
|
|
244
|
+
}
|
|
245
|
+
const skill = registry.create(skillName, config);
|
|
246
|
+
if (!skill) {
|
|
247
|
+
const errorMsg = `Failed to create skill '${skillName}' from registry`;
|
|
248
|
+
log.error(errorMsg);
|
|
249
|
+
return [false, errorMsg];
|
|
250
|
+
}
|
|
251
|
+
try {
|
|
252
|
+
await this.addSkill(skill);
|
|
253
|
+
return [true, ''];
|
|
254
|
+
}
|
|
255
|
+
catch (err) {
|
|
256
|
+
const errorMsg = `Error loading skill '${skillName}': ${err instanceof Error ? err.message : String(err)}`;
|
|
257
|
+
log.error(errorMsg);
|
|
258
|
+
return [false, errorMsg];
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
/**
|
|
262
|
+
* List the instance keys of all currently loaded skills.
|
|
263
|
+
* Python equivalent: `list_loaded_skills() -> List[str]` which returns
|
|
264
|
+
* `list(self.loaded_skills.keys())`.
|
|
265
|
+
*
|
|
266
|
+
* Use `listSkills()` for richer objects (name, instanceId, initialized).
|
|
267
|
+
* Use `listSkillKeys()` for a flat list of instance key strings.
|
|
268
|
+
*
|
|
269
|
+
* @returns Array of instance key strings.
|
|
270
|
+
*
|
|
271
|
+
* @remarks Equivalent to Python's `list_loaded_skills()`. Callers porting from
|
|
272
|
+
* Python should change `skill_manager.list_loaded_skills()` →
|
|
273
|
+
* `skillManager.listSkillKeys()`.
|
|
274
|
+
*/
|
|
275
|
+
listSkillKeys() {
|
|
276
|
+
return Array.from(this.skills.keys());
|
|
277
|
+
}
|
|
278
|
+
/**
|
|
279
|
+
* Get a skill by its instance key or instance ID.
|
|
280
|
+
* @param keyOrId - The instance key or instance ID to look up.
|
|
281
|
+
* @returns The skill instance, or undefined if not found.
|
|
282
|
+
*/
|
|
283
|
+
getSkill(keyOrId) {
|
|
284
|
+
const skill = this.skills.get(keyOrId);
|
|
285
|
+
if (skill)
|
|
286
|
+
return skill;
|
|
287
|
+
// Fallback: search by instanceId
|
|
288
|
+
for (const s of this.skills.values()) {
|
|
289
|
+
if (s.instanceId === keyOrId)
|
|
290
|
+
return s;
|
|
291
|
+
}
|
|
292
|
+
return undefined;
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* List all loaded skill instances with their name, ID, and initialization state.
|
|
296
|
+
* @returns Array of skill summary objects.
|
|
297
|
+
*/
|
|
298
|
+
listSkills() {
|
|
299
|
+
return Array.from(this.skills.values()).map(s => ({
|
|
300
|
+
name: s.skillName,
|
|
301
|
+
instanceId: s.instanceId,
|
|
302
|
+
initialized: s.isInitialized(),
|
|
303
|
+
}));
|
|
304
|
+
}
|
|
305
|
+
/**
|
|
306
|
+
* Aggregate tool definitions from all loaded skills.
|
|
307
|
+
* @returns Combined array of all skill tool definitions.
|
|
308
|
+
*/
|
|
309
|
+
getAllTools() {
|
|
310
|
+
const tools = [];
|
|
311
|
+
for (const skill of this.skills.values()) {
|
|
312
|
+
tools.push(...skill.getTools());
|
|
313
|
+
}
|
|
314
|
+
return tools;
|
|
315
|
+
}
|
|
316
|
+
/**
|
|
317
|
+
* Aggregate prompt sections from all loaded skills.
|
|
318
|
+
* @returns Combined array of all skill prompt sections.
|
|
319
|
+
*/
|
|
320
|
+
getAllPromptSections() {
|
|
321
|
+
const sections = [];
|
|
322
|
+
for (const skill of this.skills.values()) {
|
|
323
|
+
sections.push(...skill.getPromptSections());
|
|
324
|
+
}
|
|
325
|
+
return sections;
|
|
326
|
+
}
|
|
327
|
+
/**
|
|
328
|
+
* Aggregate speech recognition hints from all loaded skills.
|
|
329
|
+
* @returns Combined array of all skill hint strings.
|
|
330
|
+
*/
|
|
331
|
+
getAllHints() {
|
|
332
|
+
const hints = [];
|
|
333
|
+
for (const skill of this.skills.values()) {
|
|
334
|
+
hints.push(...skill.getHints());
|
|
335
|
+
}
|
|
336
|
+
return hints;
|
|
337
|
+
}
|
|
338
|
+
/**
|
|
339
|
+
* Merge global data from all loaded skills into a single object.
|
|
340
|
+
* @returns Combined global data (later skills override earlier ones on key conflicts).
|
|
341
|
+
*/
|
|
342
|
+
getMergedGlobalData() {
|
|
343
|
+
const data = {};
|
|
344
|
+
for (const skill of this.skills.values()) {
|
|
345
|
+
Object.assign(data, skill.getGlobalData());
|
|
346
|
+
}
|
|
347
|
+
return data;
|
|
348
|
+
}
|
|
349
|
+
/**
|
|
350
|
+
* Get the number of currently loaded skill instances.
|
|
351
|
+
* @returns The count of loaded skills.
|
|
352
|
+
*/
|
|
353
|
+
get size() {
|
|
354
|
+
return this.skills.size;
|
|
355
|
+
}
|
|
356
|
+
/**
|
|
357
|
+
* Get metadata for all loaded skills, enabling ephemeral copy re-instantiation.
|
|
358
|
+
* @returns Array of entries containing skill name, class constructor, and config.
|
|
359
|
+
*/
|
|
360
|
+
getLoadedSkillEntries() {
|
|
361
|
+
return Array.from(this.skillMeta.values()).map(entry => ({
|
|
362
|
+
skillName: entry.skillName,
|
|
363
|
+
SkillClass: entry.SkillClass,
|
|
364
|
+
config: { ...entry.config },
|
|
365
|
+
}));
|
|
366
|
+
}
|
|
367
|
+
/**
|
|
368
|
+
* Remove all skills and clean up.
|
|
369
|
+
*/
|
|
370
|
+
async clear() {
|
|
371
|
+
for (const skill of this.skills.values()) {
|
|
372
|
+
await skill.cleanup();
|
|
373
|
+
}
|
|
374
|
+
this.skills.clear();
|
|
375
|
+
this.skillMeta.clear();
|
|
376
|
+
}
|
|
377
|
+
}
|
|
378
|
+
//# sourceMappingURL=SkillManager.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SkillManager.js","sourceRoot":"","sources":["../../src/skills/SkillManager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SkillRegistry - Global singleton registry for discovering and loading skills.
|
|
3
|
+
*
|
|
4
|
+
* Matches Python's `skills/registry.py:SkillRegistry`: the registry stores
|
|
5
|
+
* **class references** keyed by each class's static `SKILL_NAME`, and reads
|
|
6
|
+
* metadata (description, version, required packages/env vars,
|
|
7
|
+
* multi-instance support) by direct static-attribute access.
|
|
8
|
+
*
|
|
9
|
+
* Registration via `register(SkillClass)` validates that the class defines
|
|
10
|
+
* `SKILL_NAME`, that `getParameterSchema()` is callable and returns a
|
|
11
|
+
* non-empty object (Python `register_skill` at `registry.py:132-194`).
|
|
12
|
+
*
|
|
13
|
+
* Supports the `SIGNALWIRE_SKILL_PATHS` environment variable for custom
|
|
14
|
+
* skill directories, matching Python's discovery search path.
|
|
15
|
+
*/
|
|
16
|
+
import { SkillBase, type SkillConfig, type ParameterSchemaEntry } from './SkillBase.js';
|
|
17
|
+
/**
|
|
18
|
+
* Metadata exposed for a registered skill. Shape matches Python's
|
|
19
|
+
* `SkillRegistry.list_skills()` / `get_all_skills_schema()` return values
|
|
20
|
+
* (`skills/registry.py:205-227`, `229-296`).
|
|
21
|
+
*/
|
|
22
|
+
export interface SkillSchemaInfo {
|
|
23
|
+
/** The skill's registered name (from `SkillBase.SKILL_NAME`). */
|
|
24
|
+
name: string;
|
|
25
|
+
/** Human-readable description (from `SkillBase.SKILL_DESCRIPTION`). */
|
|
26
|
+
description: string;
|
|
27
|
+
/** Semantic version string (from `SkillBase.SKILL_VERSION`). */
|
|
28
|
+
version: string;
|
|
29
|
+
/** Whether this skill supports multiple simultaneous instances. */
|
|
30
|
+
supportsMultipleInstances: boolean;
|
|
31
|
+
/** Environment variables required by the skill. */
|
|
32
|
+
requiredEnvVars: string[];
|
|
33
|
+
/** NPM packages required by the skill. */
|
|
34
|
+
requiredPackages: string[];
|
|
35
|
+
/** Full parameter schema with types, defaults, and constraints. */
|
|
36
|
+
parameters: Record<string, ParameterSchemaEntry>;
|
|
37
|
+
/** Optional source category for grouping (e.g., "builtin", "external"). */
|
|
38
|
+
source?: string;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Global singleton registry for registering and instantiating skills.
|
|
42
|
+
*
|
|
43
|
+
* Skills can be registered programmatically via `register(SkillClass)`.
|
|
44
|
+
* Matches Python's `skill_registry` global (`skills/registry.py:481`).
|
|
45
|
+
*/
|
|
46
|
+
export declare class SkillRegistry {
|
|
47
|
+
/**
|
|
48
|
+
* Map from `SKILL_NAME` to class reference. Matches Python's
|
|
49
|
+
* `self._skills: Dict[str, Type[SkillBase]]` (`registry.py:26`).
|
|
50
|
+
*/
|
|
51
|
+
private registry;
|
|
52
|
+
private lockedNames;
|
|
53
|
+
private searchPaths;
|
|
54
|
+
constructor();
|
|
55
|
+
/**
|
|
56
|
+
* Get the global singleton instance, creating it on first access.
|
|
57
|
+
* @returns The shared SkillRegistry instance.
|
|
58
|
+
*/
|
|
59
|
+
static getInstance(): SkillRegistry;
|
|
60
|
+
/**
|
|
61
|
+
* Reset the global singleton (for testing).
|
|
62
|
+
*/
|
|
63
|
+
static resetInstance(): void;
|
|
64
|
+
/**
|
|
65
|
+
* Register a skill class. The skill name is read from the class's static
|
|
66
|
+
* `SKILL_NAME`. Mirrors Python's `register_skill(skill_class)`
|
|
67
|
+
* (`skills/registry.py:132-194`) — including the schema-non-empty check
|
|
68
|
+
* and the protection against overwriting locked skills.
|
|
69
|
+
*
|
|
70
|
+
* @param SkillClass - A concrete subclass of `SkillBase` with a
|
|
71
|
+
* non-empty `SKILL_NAME`.
|
|
72
|
+
*/
|
|
73
|
+
register(SkillClass: typeof SkillBase): void;
|
|
74
|
+
/**
|
|
75
|
+
* Lock one or more skill names to prevent overwriting.
|
|
76
|
+
* If called with no arguments, locks all currently registered skills.
|
|
77
|
+
* @param names - Skill names to lock; if omitted, all current names are locked.
|
|
78
|
+
*/
|
|
79
|
+
lock(names?: string[]): void;
|
|
80
|
+
/**
|
|
81
|
+
* Unregister a skill by name, removing it from the registry.
|
|
82
|
+
* @param name - The skill name to unregister.
|
|
83
|
+
* @returns True if the skill was found and removed.
|
|
84
|
+
*/
|
|
85
|
+
unregister(name: string): boolean;
|
|
86
|
+
/**
|
|
87
|
+
* Create a new skill instance by looking up its class in the registry.
|
|
88
|
+
* Matches Python's `skill_manager.load_skill(name)` class-lookup + instantiate
|
|
89
|
+
* flow (`skill_manager.py:97`: `skill_instance = skill_class(self.agent, params)`).
|
|
90
|
+
*
|
|
91
|
+
* @param name - The registered skill name.
|
|
92
|
+
* @param config - Optional configuration to pass to the skill constructor.
|
|
93
|
+
* @returns A new skill instance, or null if the name is not registered.
|
|
94
|
+
*/
|
|
95
|
+
create(name: string, config?: SkillConfig): SkillBase | null;
|
|
96
|
+
/**
|
|
97
|
+
* Get the registered skill class by name. Matches Python's
|
|
98
|
+
* `get_skill_class(skill_name)` (`registry.py:196-203`).
|
|
99
|
+
* @param name - The registered skill name.
|
|
100
|
+
* @returns The skill class reference, or undefined if not registered.
|
|
101
|
+
*/
|
|
102
|
+
getSkillClass(name: string): typeof SkillBase | undefined;
|
|
103
|
+
/**
|
|
104
|
+
* Check if a skill name is registered.
|
|
105
|
+
* @param name - The skill name to check.
|
|
106
|
+
* @returns True if the skill is registered.
|
|
107
|
+
*/
|
|
108
|
+
has(name: string): boolean;
|
|
109
|
+
/**
|
|
110
|
+
* List all registered skill names.
|
|
111
|
+
* @returns Array of registered skill name strings.
|
|
112
|
+
*/
|
|
113
|
+
listRegistered(): string[];
|
|
114
|
+
/**
|
|
115
|
+
* List all registered skills with their full metadata. Matches Python's
|
|
116
|
+
* `list_skills()` shape (`registry.py:205-227`) plus TS-idiomatic
|
|
117
|
+
* camelCase keys.
|
|
118
|
+
* @returns Array of skill metadata objects.
|
|
119
|
+
*/
|
|
120
|
+
listSkills(): SkillSchemaInfo[];
|
|
121
|
+
/**
|
|
122
|
+
* Add a directory path to search during skill discovery.
|
|
123
|
+
* @param path - Absolute path to a directory containing skill files.
|
|
124
|
+
*/
|
|
125
|
+
addSearchPath(path: string): void;
|
|
126
|
+
/**
|
|
127
|
+
* Get all configured search paths for skill discovery.
|
|
128
|
+
* @returns Copy of the search paths array.
|
|
129
|
+
*/
|
|
130
|
+
getSearchPaths(): string[];
|
|
131
|
+
/**
|
|
132
|
+
* Discover and register skills from a directory by importing each file.
|
|
133
|
+
* Looks for SkillBase subclass exports and registers them.
|
|
134
|
+
* @param dirPath - Absolute path to the directory to scan.
|
|
135
|
+
* @returns Array of newly discovered skill names.
|
|
136
|
+
*/
|
|
137
|
+
discoverFromDirectory(dirPath: string): Promise<string[]>;
|
|
138
|
+
/**
|
|
139
|
+
* Discover and register skills from all configured search paths.
|
|
140
|
+
* @returns Array of all newly discovered skill names.
|
|
141
|
+
*/
|
|
142
|
+
discoverAll(): Promise<string[]>;
|
|
143
|
+
/**
|
|
144
|
+
* Get the combined schema info for a registered skill.
|
|
145
|
+
* Matches Python `get_all_skills_schema` per-skill shape
|
|
146
|
+
* (`registry.py:287-295`).
|
|
147
|
+
* @param name - The registered skill name to query.
|
|
148
|
+
* @returns The skill's schema info, or undefined if not found.
|
|
149
|
+
*/
|
|
150
|
+
getSkillSchema(name: string): SkillSchemaInfo | undefined;
|
|
151
|
+
/**
|
|
152
|
+
* Get combined schema info for all registered skills.
|
|
153
|
+
* @returns Record mapping skill names to their schema info.
|
|
154
|
+
*/
|
|
155
|
+
getAllSkillsSchema(): Record<string, SkillSchemaInfo>;
|
|
156
|
+
/**
|
|
157
|
+
* Group registered skill names by source category. Matches Python's
|
|
158
|
+
* `list_all_skill_sources` (`skills/registry.py:436-478`).
|
|
159
|
+
*
|
|
160
|
+
* Current TS implementation treats every registered skill as "registered"
|
|
161
|
+
* (the only category that fits — filesystem-based discovery is optional
|
|
162
|
+
* and entry-points don't apply to Node the way they do to Python).
|
|
163
|
+
*
|
|
164
|
+
* @returns Record mapping source categories to arrays of skill names.
|
|
165
|
+
*/
|
|
166
|
+
listAllSkillSources(): Record<string, string[]>;
|
|
167
|
+
/**
|
|
168
|
+
* Get the number of registered skills.
|
|
169
|
+
* @returns The count of registered skills.
|
|
170
|
+
*/
|
|
171
|
+
get size(): number;
|
|
172
|
+
/**
|
|
173
|
+
* Clear all registrations.
|
|
174
|
+
*/
|
|
175
|
+
clear(): void;
|
|
176
|
+
}
|