@signalwire/sdk 2.0.1 → 2.0.3
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 +1026 -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,142 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SessionManager - Stateless HMAC-SHA256 token generation and validation.
|
|
3
|
+
*
|
|
4
|
+
* Tokens encode call_id, function name, expiry and a nonce, signed with a
|
|
5
|
+
* shared secret. No server-side state is stored.
|
|
6
|
+
*/
|
|
7
|
+
/** Decoded token debug info matching the Python SDK's nested return structure. */
|
|
8
|
+
export interface DebugTokenResult {
|
|
9
|
+
valid_format: boolean;
|
|
10
|
+
components?: {
|
|
11
|
+
call_id: string;
|
|
12
|
+
function: string;
|
|
13
|
+
expiry: string;
|
|
14
|
+
expiry_date: string | null;
|
|
15
|
+
nonce: string;
|
|
16
|
+
signature: string;
|
|
17
|
+
};
|
|
18
|
+
status?: {
|
|
19
|
+
current_time: number;
|
|
20
|
+
is_expired: boolean | null;
|
|
21
|
+
expires_in_seconds: number | null;
|
|
22
|
+
};
|
|
23
|
+
parts_count?: number;
|
|
24
|
+
token_length?: number;
|
|
25
|
+
error?: string;
|
|
26
|
+
}
|
|
27
|
+
/** Stateless HMAC-SHA256 token manager for SWAIG function call authentication and per-session metadata storage. */
|
|
28
|
+
export declare class SessionManager {
|
|
29
|
+
/** Token validity duration in seconds. */
|
|
30
|
+
tokenExpirySecs: number;
|
|
31
|
+
/** HMAC signing secret. */
|
|
32
|
+
secretKey: string;
|
|
33
|
+
/**
|
|
34
|
+
* When true, {@link debugToken} decodes token internals.
|
|
35
|
+
* When false (default), it returns `{ error: "debug mode not enabled" }`.
|
|
36
|
+
*/
|
|
37
|
+
debugMode: boolean;
|
|
38
|
+
private sessionMetadata;
|
|
39
|
+
private sessionTimestamps;
|
|
40
|
+
private log;
|
|
41
|
+
/**
|
|
42
|
+
* Create a new SessionManager.
|
|
43
|
+
* @param tokenExpirySecs - Token validity duration in seconds (default 900).
|
|
44
|
+
* @param secretKey - HMAC signing secret; a random key is generated if omitted.
|
|
45
|
+
*/
|
|
46
|
+
constructor(tokenExpirySecs?: number, secretKey?: string);
|
|
47
|
+
/**
|
|
48
|
+
* Return the given callId or generate a new random session identifier.
|
|
49
|
+
* @param callId - Existing call ID to reuse.
|
|
50
|
+
* @returns The call ID string.
|
|
51
|
+
*/
|
|
52
|
+
createSession(callId?: string): string;
|
|
53
|
+
/**
|
|
54
|
+
* Generate a signed, base64url-encoded token binding a function name to a call ID.
|
|
55
|
+
* @param functionName - The SWAIG function name to bind.
|
|
56
|
+
* @param callId - The call ID to bind.
|
|
57
|
+
* @returns A base64url-encoded token string.
|
|
58
|
+
*/
|
|
59
|
+
generateToken(functionName: string, callId: string): string;
|
|
60
|
+
/**
|
|
61
|
+
* Alias for {@link generateToken}.
|
|
62
|
+
* @param functionName - The SWAIG function name to bind.
|
|
63
|
+
* @param callId - The call ID to bind.
|
|
64
|
+
* @returns A base64url-encoded token string.
|
|
65
|
+
*/
|
|
66
|
+
createToolToken(functionName: string, callId: string): string;
|
|
67
|
+
/**
|
|
68
|
+
* Validate a token against the expected call ID and function name.
|
|
69
|
+
* @param callId - The expected call ID.
|
|
70
|
+
* @param functionName - The expected function name.
|
|
71
|
+
* @param token - The base64url-encoded token to validate.
|
|
72
|
+
* @returns True if the token is valid and not expired.
|
|
73
|
+
*/
|
|
74
|
+
validateToken(callId: string, functionName: string, token: string): boolean;
|
|
75
|
+
/**
|
|
76
|
+
* Alias for {@link validateToken} with reordered parameters.
|
|
77
|
+
* @param functionName - The expected function name.
|
|
78
|
+
* @param token - The base64url-encoded token to validate.
|
|
79
|
+
* @param callId - The expected call ID.
|
|
80
|
+
* @returns True if the token is valid and not expired.
|
|
81
|
+
*/
|
|
82
|
+
validateToolToken(functionName: string, token: string, callId: string): boolean;
|
|
83
|
+
/**
|
|
84
|
+
* Debug a token without validating it.
|
|
85
|
+
*
|
|
86
|
+
* Requires {@link debugMode} to be `true`. When disabled, returns
|
|
87
|
+
* `{ error: "debug mode not enabled" }` matching the Python SDK behaviour.
|
|
88
|
+
*
|
|
89
|
+
* @param token - The base64url-encoded token to decode.
|
|
90
|
+
* @returns A nested debug structure matching the Python SDK, or an error object.
|
|
91
|
+
*/
|
|
92
|
+
debugToken(token: string): DebugTokenResult;
|
|
93
|
+
/**
|
|
94
|
+
* Retrieve metadata associated with a session.
|
|
95
|
+
*
|
|
96
|
+
* Returns an empty object when no metadata has been stored for the session,
|
|
97
|
+
* matching Python SDK behavior (`get_session_metadata` always returns `{}`).
|
|
98
|
+
* Callers can safely check truthiness or iterate keys without a null guard.
|
|
99
|
+
*
|
|
100
|
+
* @param sessionId - The session identifier.
|
|
101
|
+
* @returns The metadata record for the session, or `{}` if no metadata exists.
|
|
102
|
+
*/
|
|
103
|
+
getSessionMetadata(sessionId: string): Record<string, unknown>;
|
|
104
|
+
/**
|
|
105
|
+
* Merge metadata into a session, creating the entry if it does not exist.
|
|
106
|
+
*
|
|
107
|
+
* Supports two call signatures for Python SDK compatibility:
|
|
108
|
+
* - `setSessionMetadata(sessionId, metadata)` — bulk merge (TS-native)
|
|
109
|
+
* - `setSessionMetadata(sessionId, key, value)` — single key/value (Python-compatible)
|
|
110
|
+
*
|
|
111
|
+
* @param sessionId - The session identifier.
|
|
112
|
+
* @param metadataOrKey - A metadata record to merge, or a string key when called with three arguments.
|
|
113
|
+
* @param value - The value to set when called with a string key.
|
|
114
|
+
*/
|
|
115
|
+
setSessionMetadata(sessionId: string, metadataOrKey: Record<string, unknown>): void;
|
|
116
|
+
setSessionMetadata(sessionId: string, key: string, value: unknown): boolean;
|
|
117
|
+
/**
|
|
118
|
+
* Remove session metadata entries older than `maxAgeMs`.
|
|
119
|
+
* @param maxAgeMs - Maximum age in milliseconds (defaults to `tokenExpirySecs * 1000`).
|
|
120
|
+
*/
|
|
121
|
+
cleanup(maxAgeMs?: number): void;
|
|
122
|
+
/**
|
|
123
|
+
* Legacy method retained for API compatibility with the Python SDK.
|
|
124
|
+
* Does nothing and returns `true`.
|
|
125
|
+
* @param _callId - The call/session identifier (unused).
|
|
126
|
+
* @returns Always `true`.
|
|
127
|
+
*/
|
|
128
|
+
activateSession(_callId: string): boolean;
|
|
129
|
+
/**
|
|
130
|
+
* Legacy method retained for API compatibility with the Python SDK.
|
|
131
|
+
* Does nothing and returns `true`.
|
|
132
|
+
* @param _callId - The call/session identifier (unused).
|
|
133
|
+
* @returns Always `true`.
|
|
134
|
+
*/
|
|
135
|
+
endSession(_callId: string): boolean;
|
|
136
|
+
/**
|
|
137
|
+
* Delete all metadata for a session.
|
|
138
|
+
* @param sessionId - The session identifier.
|
|
139
|
+
* @returns True if the session existed and was deleted.
|
|
140
|
+
*/
|
|
141
|
+
deleteSessionMetadata(sessionId: string): boolean;
|
|
142
|
+
}
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SessionManager - Stateless HMAC-SHA256 token generation and validation.
|
|
3
|
+
*
|
|
4
|
+
* Tokens encode call_id, function name, expiry and a nonce, signed with a
|
|
5
|
+
* shared secret. No server-side state is stored.
|
|
6
|
+
*/
|
|
7
|
+
import { randomBytes, createHmac } from 'node:crypto';
|
|
8
|
+
import { getLogger } from './Logger.js';
|
|
9
|
+
/** Stateless HMAC-SHA256 token manager for SWAIG function call authentication and per-session metadata storage. */
|
|
10
|
+
export class SessionManager {
|
|
11
|
+
/** Token validity duration in seconds. */
|
|
12
|
+
tokenExpirySecs;
|
|
13
|
+
/** HMAC signing secret. */
|
|
14
|
+
secretKey;
|
|
15
|
+
/**
|
|
16
|
+
* When true, {@link debugToken} decodes token internals.
|
|
17
|
+
* When false (default), it returns `{ error: "debug mode not enabled" }`.
|
|
18
|
+
*/
|
|
19
|
+
debugMode = false;
|
|
20
|
+
sessionMetadata = new Map();
|
|
21
|
+
sessionTimestamps = new Map();
|
|
22
|
+
log = getLogger('SessionManager');
|
|
23
|
+
/**
|
|
24
|
+
* Create a new SessionManager.
|
|
25
|
+
* @param tokenExpirySecs - Token validity duration in seconds (default 900).
|
|
26
|
+
* @param secretKey - HMAC signing secret; a random key is generated if omitted.
|
|
27
|
+
*/
|
|
28
|
+
constructor(tokenExpirySecs = 900, secretKey) {
|
|
29
|
+
this.tokenExpirySecs = tokenExpirySecs;
|
|
30
|
+
this.secretKey = secretKey ?? randomBytes(32).toString('hex');
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Return the given callId or generate a new random session identifier.
|
|
34
|
+
* @param callId - Existing call ID to reuse.
|
|
35
|
+
* @returns The call ID string.
|
|
36
|
+
*/
|
|
37
|
+
createSession(callId) {
|
|
38
|
+
if (callId)
|
|
39
|
+
return callId;
|
|
40
|
+
return randomBytes(16).toString('base64url');
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Generate a signed, base64url-encoded token binding a function name to a call ID.
|
|
44
|
+
* @param functionName - The SWAIG function name to bind.
|
|
45
|
+
* @param callId - The call ID to bind.
|
|
46
|
+
* @returns A base64url-encoded token string.
|
|
47
|
+
*/
|
|
48
|
+
generateToken(functionName, callId) {
|
|
49
|
+
const expiry = Math.floor(Date.now() / 1000) + this.tokenExpirySecs;
|
|
50
|
+
const nonce = randomBytes(16).toString('hex');
|
|
51
|
+
const message = `${callId}:${functionName}:${expiry}:${nonce}`;
|
|
52
|
+
const signature = createHmac('sha256', this.secretKey)
|
|
53
|
+
.update(message)
|
|
54
|
+
.digest('hex');
|
|
55
|
+
const token = `${callId}.${functionName}.${expiry}.${nonce}.${signature}`;
|
|
56
|
+
const encoded = Buffer.from(token).toString('base64url');
|
|
57
|
+
this.log.debug('created_token', { function: functionName, call_id: callId });
|
|
58
|
+
return encoded;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Alias for {@link generateToken}.
|
|
62
|
+
* @param functionName - The SWAIG function name to bind.
|
|
63
|
+
* @param callId - The call ID to bind.
|
|
64
|
+
* @returns A base64url-encoded token string.
|
|
65
|
+
*/
|
|
66
|
+
createToolToken(functionName, callId) {
|
|
67
|
+
return this.generateToken(functionName, callId);
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Validate a token against the expected call ID and function name.
|
|
71
|
+
* @param callId - The expected call ID.
|
|
72
|
+
* @param functionName - The expected function name.
|
|
73
|
+
* @param token - The base64url-encoded token to validate.
|
|
74
|
+
* @returns True if the token is valid and not expired.
|
|
75
|
+
*/
|
|
76
|
+
validateToken(callId, functionName, token) {
|
|
77
|
+
try {
|
|
78
|
+
const decoded = Buffer.from(token, 'base64url').toString();
|
|
79
|
+
const parts = decoded.split('.');
|
|
80
|
+
if (parts.length !== 5) {
|
|
81
|
+
this.log.warn('token_invalid', { function: functionName });
|
|
82
|
+
return false;
|
|
83
|
+
}
|
|
84
|
+
const [tokenCallId, tokenFunction, tokenExpiry, tokenNonce, tokenSignature] = parts;
|
|
85
|
+
if (!callId) {
|
|
86
|
+
this.log.warn('token_rejected_no_call_id', { function: functionName });
|
|
87
|
+
return false;
|
|
88
|
+
}
|
|
89
|
+
if (tokenFunction !== functionName) {
|
|
90
|
+
this.log.warn('token_function_mismatch', { expected: functionName, got: tokenFunction });
|
|
91
|
+
return false;
|
|
92
|
+
}
|
|
93
|
+
const expiry = parseInt(tokenExpiry, 10);
|
|
94
|
+
if (expiry <= Math.floor(Date.now() / 1000)) {
|
|
95
|
+
this.log.warn('token_expired', { function: functionName });
|
|
96
|
+
return false;
|
|
97
|
+
}
|
|
98
|
+
const message = `${tokenCallId}:${tokenFunction}:${tokenExpiry}:${tokenNonce}`;
|
|
99
|
+
const expectedSig = createHmac('sha256', this.secretKey)
|
|
100
|
+
.update(message)
|
|
101
|
+
.digest('hex');
|
|
102
|
+
if (tokenSignature !== expectedSig) {
|
|
103
|
+
this.log.warn('token_invalid', { function: functionName });
|
|
104
|
+
return false;
|
|
105
|
+
}
|
|
106
|
+
if (tokenCallId !== callId) {
|
|
107
|
+
this.log.warn('token_call_id_mismatch', { expected: callId, got: tokenCallId });
|
|
108
|
+
return false;
|
|
109
|
+
}
|
|
110
|
+
this.log.debug('token_valid', { function: functionName });
|
|
111
|
+
return true;
|
|
112
|
+
}
|
|
113
|
+
catch {
|
|
114
|
+
this.log.warn('token_invalid', { function: functionName });
|
|
115
|
+
return false;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Alias for {@link validateToken} with reordered parameters.
|
|
120
|
+
* @param functionName - The expected function name.
|
|
121
|
+
* @param token - The base64url-encoded token to validate.
|
|
122
|
+
* @param callId - The expected call ID.
|
|
123
|
+
* @returns True if the token is valid and not expired.
|
|
124
|
+
*/
|
|
125
|
+
validateToolToken(functionName, token, callId) {
|
|
126
|
+
return this.validateToken(callId, functionName, token);
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Debug a token without validating it.
|
|
130
|
+
*
|
|
131
|
+
* Requires {@link debugMode} to be `true`. When disabled, returns
|
|
132
|
+
* `{ error: "debug mode not enabled" }` matching the Python SDK behaviour.
|
|
133
|
+
*
|
|
134
|
+
* @param token - The base64url-encoded token to decode.
|
|
135
|
+
* @returns A nested debug structure matching the Python SDK, or an error object.
|
|
136
|
+
*/
|
|
137
|
+
debugToken(token) {
|
|
138
|
+
if (!this.debugMode) {
|
|
139
|
+
return { valid_format: false, error: 'debug mode not enabled' };
|
|
140
|
+
}
|
|
141
|
+
try {
|
|
142
|
+
const decoded = Buffer.from(token, 'base64url').toString();
|
|
143
|
+
const parts = decoded.split('.');
|
|
144
|
+
if (parts.length !== 5) {
|
|
145
|
+
return {
|
|
146
|
+
valid_format: false,
|
|
147
|
+
parts_count: parts.length,
|
|
148
|
+
token_length: token ? token.length : 0,
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
const [tokenCallId, tokenFunction, tokenExpiry, tokenNonce, tokenSignature] = parts;
|
|
152
|
+
const currentTime = Math.floor(Date.now() / 1000);
|
|
153
|
+
let expiry = null;
|
|
154
|
+
let isExpired = null;
|
|
155
|
+
let expiresIn = null;
|
|
156
|
+
let expiryDate = null;
|
|
157
|
+
const parsed = parseInt(tokenExpiry, 10);
|
|
158
|
+
if (!Number.isNaN(parsed)) {
|
|
159
|
+
expiry = parsed;
|
|
160
|
+
isExpired = expiry < currentTime;
|
|
161
|
+
expiresIn = isExpired ? 0 : expiry - currentTime;
|
|
162
|
+
expiryDate = new Date(expiry * 1000).toISOString();
|
|
163
|
+
}
|
|
164
|
+
return {
|
|
165
|
+
valid_format: true,
|
|
166
|
+
components: {
|
|
167
|
+
call_id: tokenCallId.length > 8 ? tokenCallId.slice(0, 8) + '...' : tokenCallId,
|
|
168
|
+
function: tokenFunction,
|
|
169
|
+
expiry: tokenExpiry,
|
|
170
|
+
expiry_date: expiryDate,
|
|
171
|
+
nonce: tokenNonce,
|
|
172
|
+
signature: tokenSignature.length > 8 ? tokenSignature.slice(0, 8) + '...' : tokenSignature,
|
|
173
|
+
},
|
|
174
|
+
status: {
|
|
175
|
+
current_time: currentTime,
|
|
176
|
+
is_expired: isExpired,
|
|
177
|
+
expires_in_seconds: expiresIn,
|
|
178
|
+
},
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
catch (e) {
|
|
182
|
+
return {
|
|
183
|
+
valid_format: false,
|
|
184
|
+
error: e instanceof Error ? e.message : String(e),
|
|
185
|
+
token_length: token ? token.length : 0,
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* Retrieve metadata associated with a session.
|
|
191
|
+
*
|
|
192
|
+
* Returns an empty object when no metadata has been stored for the session,
|
|
193
|
+
* matching Python SDK behavior (`get_session_metadata` always returns `{}`).
|
|
194
|
+
* Callers can safely check truthiness or iterate keys without a null guard.
|
|
195
|
+
*
|
|
196
|
+
* @param sessionId - The session identifier.
|
|
197
|
+
* @returns The metadata record for the session, or `{}` if no metadata exists.
|
|
198
|
+
*/
|
|
199
|
+
getSessionMetadata(sessionId) {
|
|
200
|
+
return this.sessionMetadata.get(sessionId) ?? {};
|
|
201
|
+
}
|
|
202
|
+
setSessionMetadata(sessionId, metadataOrKey, value) {
|
|
203
|
+
if (typeof metadataOrKey === 'string') {
|
|
204
|
+
// Python-compatible single key/value overload — returns bool for parity
|
|
205
|
+
this.sessionMetadata.set(sessionId, { ...this.sessionMetadata.get(sessionId), [metadataOrKey]: value });
|
|
206
|
+
this.sessionTimestamps.set(sessionId, Date.now());
|
|
207
|
+
if (this.sessionMetadata.size > 1000) {
|
|
208
|
+
this.cleanup();
|
|
209
|
+
}
|
|
210
|
+
return true;
|
|
211
|
+
}
|
|
212
|
+
this.sessionMetadata.set(sessionId, { ...this.sessionMetadata.get(sessionId), ...metadataOrKey });
|
|
213
|
+
this.sessionTimestamps.set(sessionId, Date.now());
|
|
214
|
+
// Auto-cleanup when map grows too large
|
|
215
|
+
if (this.sessionMetadata.size > 1000) {
|
|
216
|
+
this.cleanup();
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* Remove session metadata entries older than `maxAgeMs`.
|
|
221
|
+
* @param maxAgeMs - Maximum age in milliseconds (defaults to `tokenExpirySecs * 1000`).
|
|
222
|
+
*/
|
|
223
|
+
cleanup(maxAgeMs) {
|
|
224
|
+
const maxAge = maxAgeMs ?? this.tokenExpirySecs * 1000;
|
|
225
|
+
const cutoff = Date.now() - maxAge;
|
|
226
|
+
for (const [id, ts] of this.sessionTimestamps) {
|
|
227
|
+
if (ts <= cutoff) {
|
|
228
|
+
this.sessionMetadata.delete(id);
|
|
229
|
+
this.sessionTimestamps.delete(id);
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* Legacy method retained for API compatibility with the Python SDK.
|
|
235
|
+
* Does nothing and returns `true`.
|
|
236
|
+
* @param _callId - The call/session identifier (unused).
|
|
237
|
+
* @returns Always `true`.
|
|
238
|
+
*/
|
|
239
|
+
activateSession(_callId) {
|
|
240
|
+
return true;
|
|
241
|
+
}
|
|
242
|
+
/**
|
|
243
|
+
* Legacy method retained for API compatibility with the Python SDK.
|
|
244
|
+
* Does nothing and returns `true`.
|
|
245
|
+
* @param _callId - The call/session identifier (unused).
|
|
246
|
+
* @returns Always `true`.
|
|
247
|
+
*/
|
|
248
|
+
endSession(_callId) {
|
|
249
|
+
return true;
|
|
250
|
+
}
|
|
251
|
+
/**
|
|
252
|
+
* Delete all metadata for a session.
|
|
253
|
+
* @param sessionId - The session identifier.
|
|
254
|
+
* @returns True if the session existed and was deleted.
|
|
255
|
+
*/
|
|
256
|
+
deleteSessionMetadata(sessionId) {
|
|
257
|
+
return this.sessionMetadata.delete(sessionId);
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
//# sourceMappingURL=SessionManager.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SessionManager.js","sourceRoot":"","sources":["../src/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAuBxC,mHAAmH;AACnH,MAAM,OAAO,cAAc;IACzB,0CAA0C;IAC1C,eAAe,CAAS;IACxB,2BAA2B;IAC3B,SAAS,CAAS;IAClB;;;OAGG;IACH,SAAS,GAAG,KAAK,CAAC;IACV,eAAe,GAAyC,IAAI,GAAG,EAAE,CAAC;IAClE,iBAAiB,GAAwB,IAAI,GAAG,EAAE,CAAC;IACnD,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAE1C;;;;OAIG;IACH,YAAY,eAAe,GAAG,GAAG,EAAE,SAAkB;QACnD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,MAAe;QAC3B,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,YAAoB,EAAE,MAAc;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;QACpE,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,YAAY,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC;aACnD,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,YAAY,IAAI,MAAM,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,YAAoB,EAAE,MAAc;QAClD,OAAO,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,MAAc,EAAE,YAAoB,EAAE,KAAa;QAC/D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;YAEpF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;gBACvE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;gBACzF,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,OAAO,GAAG,GAAG,WAAW,IAAI,aAAa,IAAI,WAAW,IAAI,UAAU,EAAE,CAAC;YAC/E,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC;iBACrD,MAAM,CAAC,OAAO,CAAC;iBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;gBAChF,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,YAAoB,EAAE,KAAa,EAAE,MAAc;QACnE,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAa;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAClE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,YAAY,EAAE,KAAK;oBACnB,WAAW,EAAE,KAAK,CAAC,MAAM;oBACzB,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;iBACvC,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;YAEpF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAClD,IAAI,MAAM,GAAkB,IAAI,CAAC;YACjC,IAAI,SAAS,GAAmB,IAAI,CAAC;YACrC,IAAI,SAAS,GAAkB,IAAI,CAAC;YACpC,IAAI,UAAU,GAAkB,IAAI,CAAC;YACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,MAAM,CAAC;gBAChB,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;gBACjC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC;gBACjD,UAAU,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACrD,CAAC;YAED,OAAO;gBACL,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE;oBACV,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW;oBAC/E,QAAQ,EAAE,aAAa;oBACvB,MAAM,EAAE,WAAW;oBACnB,WAAW,EAAE,UAAU;oBACvB,KAAK,EAAE,UAAU;oBACjB,SAAS,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,cAAc;iBAC3F;gBACD,MAAM,EAAE;oBACN,YAAY,EAAE,WAAW;oBACzB,UAAU,EAAE,SAAS;oBACrB,kBAAkB,EAAE,SAAS;iBAC9B;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO;gBACL,YAAY,EAAE,KAAK;gBACnB,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjD,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,SAAiB;QAClC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAeD,kBAAkB,CAAC,SAAiB,EAAE,aAA+C,EAAE,KAAe;QACpG,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,wEAAwE;YACxE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACxG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAClD,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,wCAAwC;QACxC,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,QAAiB;QACvB,MAAM,MAAM,GAAG,QAAQ,IAAI,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACnC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC9C,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,qBAAqB,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;CACF"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SslConfig - SSL/TLS configuration for HTTPS serving.
|
|
3
|
+
*
|
|
4
|
+
* Env vars:
|
|
5
|
+
* SWML_SSL_ENABLED: true|false
|
|
6
|
+
* SWML_SSL_CERT_PATH: path to PEM cert
|
|
7
|
+
* SWML_SSL_KEY_PATH: path to PEM key
|
|
8
|
+
* SWML_SSL_DOMAIN: domain for HSTS
|
|
9
|
+
*/
|
|
10
|
+
/** Configuration options for SSL/TLS setup. */
|
|
11
|
+
export interface SslOptions {
|
|
12
|
+
/** Whether SSL is enabled. */
|
|
13
|
+
enabled?: boolean;
|
|
14
|
+
/** Filesystem path to the PEM-encoded certificate. */
|
|
15
|
+
certPath?: string;
|
|
16
|
+
/** Filesystem path to the PEM-encoded private key. */
|
|
17
|
+
keyPath?: string;
|
|
18
|
+
/** Domain name used for HSTS headers. */
|
|
19
|
+
domain?: string;
|
|
20
|
+
/** Whether to send HSTS headers; defaults to true. */
|
|
21
|
+
hsts?: boolean;
|
|
22
|
+
/** HSTS max-age in seconds; defaults to 31536000 (1 year). */
|
|
23
|
+
hstsMaxAge?: number;
|
|
24
|
+
}
|
|
25
|
+
/** Manages SSL/TLS configuration sourced from explicit options or environment variables. */
|
|
26
|
+
export declare class SslConfig {
|
|
27
|
+
/** Whether SSL is enabled. */
|
|
28
|
+
enabled: boolean;
|
|
29
|
+
/** Filesystem path to the PEM certificate, or null if unset. */
|
|
30
|
+
certPath: string | null;
|
|
31
|
+
/** Filesystem path to the PEM private key, or null if unset. */
|
|
32
|
+
keyPath: string | null;
|
|
33
|
+
/** Domain name for HSTS, or null if unset. */
|
|
34
|
+
domain: string | null;
|
|
35
|
+
/** Whether HSTS headers should be emitted. */
|
|
36
|
+
hsts: boolean;
|
|
37
|
+
/** HSTS max-age value in seconds. */
|
|
38
|
+
hstsMaxAge: number;
|
|
39
|
+
/**
|
|
40
|
+
* Create an SslConfig, falling back to environment variables for any unset options.
|
|
41
|
+
* @param opts - Optional SSL configuration overrides.
|
|
42
|
+
*/
|
|
43
|
+
constructor(opts?: SslOptions);
|
|
44
|
+
/**
|
|
45
|
+
* Check whether SSL is fully configured: enabled with both cert and key files present on disk.
|
|
46
|
+
* @returns True if SSL is enabled and both certificate and key files exist.
|
|
47
|
+
*/
|
|
48
|
+
isConfigured(): boolean;
|
|
49
|
+
/**
|
|
50
|
+
* Read the PEM certificate file from disk.
|
|
51
|
+
* @returns The certificate contents, or null if the file is missing.
|
|
52
|
+
*/
|
|
53
|
+
getCert(): string | null;
|
|
54
|
+
/**
|
|
55
|
+
* Read the PEM private key file from disk.
|
|
56
|
+
* @returns The key contents, or null if the file is missing.
|
|
57
|
+
*/
|
|
58
|
+
getKey(): string | null;
|
|
59
|
+
/**
|
|
60
|
+
* Build the Strict-Transport-Security header value.
|
|
61
|
+
* @returns The HSTS header string, or null if HSTS is disabled or SSL is off.
|
|
62
|
+
*/
|
|
63
|
+
getHstsHeader(): string | null;
|
|
64
|
+
/**
|
|
65
|
+
* Create the options object needed by Node.js `https.createServer()`.
|
|
66
|
+
* @returns An object with `cert` and `key` strings, or null if either file is missing.
|
|
67
|
+
*/
|
|
68
|
+
getServerOptions(): {
|
|
69
|
+
cert: string;
|
|
70
|
+
key: string;
|
|
71
|
+
} | null;
|
|
72
|
+
/**
|
|
73
|
+
* Return a Hono middleware that appends the HSTS header to every response.
|
|
74
|
+
* @returns A Hono-compatible middleware function.
|
|
75
|
+
*/
|
|
76
|
+
hstsMiddleware(): (c: any, next: () => Promise<void>) => Promise<void>;
|
|
77
|
+
}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SslConfig - SSL/TLS configuration for HTTPS serving.
|
|
3
|
+
*
|
|
4
|
+
* Env vars:
|
|
5
|
+
* SWML_SSL_ENABLED: true|false
|
|
6
|
+
* SWML_SSL_CERT_PATH: path to PEM cert
|
|
7
|
+
* SWML_SSL_KEY_PATH: path to PEM key
|
|
8
|
+
* SWML_SSL_DOMAIN: domain for HSTS
|
|
9
|
+
*/
|
|
10
|
+
import { readFileSync, existsSync } from 'node:fs';
|
|
11
|
+
/** Manages SSL/TLS configuration sourced from explicit options or environment variables. */
|
|
12
|
+
export class SslConfig {
|
|
13
|
+
/** Whether SSL is enabled. */
|
|
14
|
+
enabled;
|
|
15
|
+
/** Filesystem path to the PEM certificate, or null if unset. */
|
|
16
|
+
certPath;
|
|
17
|
+
/** Filesystem path to the PEM private key, or null if unset. */
|
|
18
|
+
keyPath;
|
|
19
|
+
/** Domain name for HSTS, or null if unset. */
|
|
20
|
+
domain;
|
|
21
|
+
/** Whether HSTS headers should be emitted. */
|
|
22
|
+
hsts;
|
|
23
|
+
/** HSTS max-age value in seconds. */
|
|
24
|
+
hstsMaxAge;
|
|
25
|
+
/**
|
|
26
|
+
* Create an SslConfig, falling back to environment variables for any unset options.
|
|
27
|
+
* @param opts - Optional SSL configuration overrides.
|
|
28
|
+
*/
|
|
29
|
+
constructor(opts) {
|
|
30
|
+
this.enabled = opts?.enabled ?? (process.env['SWML_SSL_ENABLED'] === 'true');
|
|
31
|
+
this.certPath = opts?.certPath ?? process.env['SWML_SSL_CERT_PATH'] ?? null;
|
|
32
|
+
this.keyPath = opts?.keyPath ?? process.env['SWML_SSL_KEY_PATH'] ?? null;
|
|
33
|
+
this.domain = opts?.domain ?? process.env['SWML_SSL_DOMAIN'] ?? null;
|
|
34
|
+
this.hsts = opts?.hsts ?? true;
|
|
35
|
+
this.hstsMaxAge = opts?.hstsMaxAge ?? 31536000; // 1 year
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Check whether SSL is fully configured: enabled with both cert and key files present on disk.
|
|
39
|
+
* @returns True if SSL is enabled and both certificate and key files exist.
|
|
40
|
+
*/
|
|
41
|
+
isConfigured() {
|
|
42
|
+
if (!this.enabled)
|
|
43
|
+
return false;
|
|
44
|
+
if (!this.certPath || !this.keyPath)
|
|
45
|
+
return false;
|
|
46
|
+
return existsSync(this.certPath) && existsSync(this.keyPath);
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Read the PEM certificate file from disk.
|
|
50
|
+
* @returns The certificate contents, or null if the file is missing.
|
|
51
|
+
*/
|
|
52
|
+
getCert() {
|
|
53
|
+
if (!this.certPath || !existsSync(this.certPath))
|
|
54
|
+
return null;
|
|
55
|
+
return readFileSync(this.certPath, 'utf-8');
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Read the PEM private key file from disk.
|
|
59
|
+
* @returns The key contents, or null if the file is missing.
|
|
60
|
+
*/
|
|
61
|
+
getKey() {
|
|
62
|
+
if (!this.keyPath || !existsSync(this.keyPath))
|
|
63
|
+
return null;
|
|
64
|
+
return readFileSync(this.keyPath, 'utf-8');
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Build the Strict-Transport-Security header value.
|
|
68
|
+
* @returns The HSTS header string, or null if HSTS is disabled or SSL is off.
|
|
69
|
+
*/
|
|
70
|
+
getHstsHeader() {
|
|
71
|
+
if (!this.hsts || !this.enabled)
|
|
72
|
+
return null;
|
|
73
|
+
return `max-age=${this.hstsMaxAge}; includeSubDomains`;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Create the options object needed by Node.js `https.createServer()`.
|
|
77
|
+
* @returns An object with `cert` and `key` strings, or null if either file is missing.
|
|
78
|
+
*/
|
|
79
|
+
getServerOptions() {
|
|
80
|
+
const cert = this.getCert();
|
|
81
|
+
const key = this.getKey();
|
|
82
|
+
if (!cert || !key)
|
|
83
|
+
return null;
|
|
84
|
+
return { cert, key };
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Return a Hono middleware that appends the HSTS header to every response.
|
|
88
|
+
* @returns A Hono-compatible middleware function.
|
|
89
|
+
*/
|
|
90
|
+
hstsMiddleware() {
|
|
91
|
+
return async (c, next) => {
|
|
92
|
+
await next();
|
|
93
|
+
const hsts = this.getHstsHeader();
|
|
94
|
+
if (hsts) {
|
|
95
|
+
c.res.headers.set('Strict-Transport-Security', hsts);
|
|
96
|
+
}
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=SslConfig.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SslConfig.js","sourceRoot":"","sources":["../src/SslConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkBnD,4FAA4F;AAC5F,MAAM,OAAO,SAAS;IACpB,8BAA8B;IAC9B,OAAO,CAAU;IACjB,gEAAgE;IAChE,QAAQ,CAAgB;IACxB,gEAAgE;IAChE,OAAO,CAAgB;IACvB,8CAA8C;IAC9C,MAAM,CAAgB;IACtB,8CAA8C;IAC9C,IAAI,CAAU;IACd,qCAAqC;IACrC,UAAU,CAAS;IAEnB;;;OAGG;IACH,YAAY,IAAiB;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,MAAM,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC;QAC5E,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,QAAQ,CAAC,CAAC,SAAS;IAC3D,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAClD,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9D,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,WAAW,IAAI,CAAC,UAAU,qBAAqB,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,KAAK,EAAE,CAAM,EAAE,IAAyB,EAAE,EAAE;YACjD,MAAM,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;CACF"}
|