@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
|
@@ -1,474 +0,0 @@
|
|
|
1
|
-
# SignalWire AI Agents - Cloud Functions Deployment Guide
|
|
2
|
-
|
|
3
|
-
This guide covers deploying SignalWire AI Agents to Google Cloud Functions and Azure Functions.
|
|
4
|
-
|
|
5
|
-
## Overview
|
|
6
|
-
|
|
7
|
-
SignalWire AI Agents now support deployment to major cloud function platforms:
|
|
8
|
-
|
|
9
|
-
- **Google Cloud Functions** - Serverless compute platform on Google Cloud
|
|
10
|
-
- **Azure Functions** - Serverless compute service on Microsoft Azure
|
|
11
|
-
- **AWS Lambda** - Already supported (see existing documentation)
|
|
12
|
-
|
|
13
|
-
## Google Cloud Functions
|
|
14
|
-
|
|
15
|
-
### Environment Detection
|
|
16
|
-
|
|
17
|
-
The agent automatically detects Google Cloud Functions environment using these variables:
|
|
18
|
-
- `FUNCTION_TARGET` - The function entry point
|
|
19
|
-
- `K_SERVICE` - Knative service name (Cloud Run/Functions)
|
|
20
|
-
- `GOOGLE_CLOUD_PROJECT` - Google Cloud project ID
|
|
21
|
-
|
|
22
|
-
### Deployment Steps
|
|
23
|
-
|
|
24
|
-
1. **Create your agent file** (`main.py`):
|
|
25
|
-
```python
|
|
26
|
-
import functions_framework
|
|
27
|
-
from your_agent_module import YourAgent
|
|
28
|
-
|
|
29
|
-
# Create agent instance
|
|
30
|
-
agent = YourAgent(
|
|
31
|
-
name="my-agent",
|
|
32
|
-
# Configure your agent parameters
|
|
33
|
-
)
|
|
34
|
-
|
|
35
|
-
@functions_framework.http
|
|
36
|
-
def agent_handler(request):
|
|
37
|
-
"""HTTP Cloud Function entry point"""
|
|
38
|
-
return agent.handle_serverless_request(event=request)
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
2. **Create requirements.txt**:
|
|
42
|
-
```
|
|
43
|
-
functions-framework==3.*
|
|
44
|
-
@signalwire/sdk
|
|
45
|
-
# Add your other dependencies
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
3. **Deploy using gcloud**:
|
|
49
|
-
```bash
|
|
50
|
-
gcloud functions deploy my-agent \
|
|
51
|
-
--runtime python39 \
|
|
52
|
-
--trigger-http \
|
|
53
|
-
--entry-point agent_handler \
|
|
54
|
-
--allow-unauthenticated
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
### Environment Variables
|
|
58
|
-
|
|
59
|
-
Set these environment variables for your function:
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
# SignalWire credentials
|
|
63
|
-
export SIGNALWIRE_PROJECT_ID="your-project-id"
|
|
64
|
-
export SIGNALWIRE_TOKEN="your-token"
|
|
65
|
-
|
|
66
|
-
# Agent configuration
|
|
67
|
-
export AGENT_USERNAME="your-username"
|
|
68
|
-
export AGENT_PASSWORD="your-password"
|
|
69
|
-
|
|
70
|
-
# Optional: Custom region/project settings
|
|
71
|
-
export FUNCTION_REGION="us-central1"
|
|
72
|
-
export GOOGLE_CLOUD_PROJECT="your-project-id"
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
### URL Format
|
|
76
|
-
|
|
77
|
-
Google Cloud Functions URLs follow this pattern:
|
|
78
|
-
```
|
|
79
|
-
https://{region}-{project-id}.cloudfunctions.net/{function-name}
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
With authentication:
|
|
83
|
-
```
|
|
84
|
-
https://username:password@{region}-{project-id}.cloudfunctions.net/{function-name}
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
## Azure Functions
|
|
88
|
-
|
|
89
|
-
### Environment Detection
|
|
90
|
-
|
|
91
|
-
The agent automatically detects Azure Functions environment using these variables:
|
|
92
|
-
- `AZURE_FUNCTIONS_ENVIRONMENT` - Azure Functions runtime environment
|
|
93
|
-
- `FUNCTIONS_WORKER_RUNTIME` - Runtime language (python, node, etc.)
|
|
94
|
-
- `AzureWebJobsStorage` - Azure storage connection string
|
|
95
|
-
|
|
96
|
-
### Deployment Steps
|
|
97
|
-
|
|
98
|
-
1. **Create your function app structure**:
|
|
99
|
-
```
|
|
100
|
-
my-agent-function/
|
|
101
|
-
├── __init__.py
|
|
102
|
-
├── function.json
|
|
103
|
-
└── requirements.txt
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
2. **Create `__init__.py`**:
|
|
107
|
-
```python
|
|
108
|
-
import azure.functions as func
|
|
109
|
-
from your_agent_module import YourAgent
|
|
110
|
-
|
|
111
|
-
# Create agent instance
|
|
112
|
-
agent = YourAgent(
|
|
113
|
-
name="my-agent",
|
|
114
|
-
# Configure your agent parameters
|
|
115
|
-
)
|
|
116
|
-
|
|
117
|
-
def main(req: func.HttpRequest) -> func.HttpResponse:
|
|
118
|
-
"""Azure Function entry point"""
|
|
119
|
-
return agent.handle_serverless_request(event=req)
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
3. **Create `function.json`**:
|
|
123
|
-
```json
|
|
124
|
-
{
|
|
125
|
-
"scriptFile": "__init__.py",
|
|
126
|
-
"bindings": [
|
|
127
|
-
{
|
|
128
|
-
"authLevel": "anonymous",
|
|
129
|
-
"type": "httpTrigger",
|
|
130
|
-
"direction": "in",
|
|
131
|
-
"name": "req",
|
|
132
|
-
"methods": ["get", "post"]
|
|
133
|
-
},
|
|
134
|
-
{
|
|
135
|
-
"type": "http",
|
|
136
|
-
"direction": "out",
|
|
137
|
-
"name": "$return"
|
|
138
|
-
}
|
|
139
|
-
]
|
|
140
|
-
}
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
4. **Create `requirements.txt`**:
|
|
144
|
-
```
|
|
145
|
-
azure-functions
|
|
146
|
-
@signalwire/sdk
|
|
147
|
-
# Add your other dependencies
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
5. **Deploy using Azure CLI**:
|
|
151
|
-
```bash
|
|
152
|
-
# Create function app
|
|
153
|
-
az functionapp create \
|
|
154
|
-
--resource-group myResourceGroup \
|
|
155
|
-
--consumption-plan-location westus \
|
|
156
|
-
--runtime python \
|
|
157
|
-
--runtime-version 3.9 \
|
|
158
|
-
--functions-version 4 \
|
|
159
|
-
--name my-agent-function \
|
|
160
|
-
--storage-account mystorageaccount
|
|
161
|
-
|
|
162
|
-
# Deploy code
|
|
163
|
-
func azure functionapp publish my-agent-function
|
|
164
|
-
```
|
|
165
|
-
|
|
166
|
-
### Environment Variables
|
|
167
|
-
|
|
168
|
-
Set these in your Azure Function App settings:
|
|
169
|
-
|
|
170
|
-
```bash
|
|
171
|
-
# SignalWire credentials
|
|
172
|
-
SIGNALWIRE_PROJECT_ID="your-project-id"
|
|
173
|
-
SIGNALWIRE_TOKEN="your-token"
|
|
174
|
-
|
|
175
|
-
# Agent configuration
|
|
176
|
-
AGENT_USERNAME="your-username"
|
|
177
|
-
AGENT_PASSWORD="your-password"
|
|
178
|
-
|
|
179
|
-
# Azure-specific (usually auto-set)
|
|
180
|
-
AZURE_FUNCTIONS_ENVIRONMENT="Development"
|
|
181
|
-
WEBSITE_SITE_NAME="my-agent-function"
|
|
182
|
-
```
|
|
183
|
-
|
|
184
|
-
### URL Format
|
|
185
|
-
|
|
186
|
-
Azure Functions URLs follow this pattern:
|
|
187
|
-
```
|
|
188
|
-
https://{function-app-name}.azurewebsites.net/api/{function-name}
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
With authentication:
|
|
192
|
-
```
|
|
193
|
-
https://username:password@{function-app-name}.azurewebsites.net/api/{function-name}
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
## Authentication
|
|
197
|
-
|
|
198
|
-
Both platforms support HTTP Basic Authentication:
|
|
199
|
-
|
|
200
|
-
### Automatic Authentication
|
|
201
|
-
The agent automatically validates credentials in cloud function environments:
|
|
202
|
-
|
|
203
|
-
```python
|
|
204
|
-
agent = YourAgent(
|
|
205
|
-
name="my-agent",
|
|
206
|
-
username="your-username",
|
|
207
|
-
password="your-password"
|
|
208
|
-
)
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
### Authentication Flow
|
|
212
|
-
1. Client sends request with `Authorization: Basic <credentials>` header
|
|
213
|
-
2. Agent validates credentials against configured username/password
|
|
214
|
-
3. If invalid, returns 401 with `WWW-Authenticate` header
|
|
215
|
-
4. If valid, processes the request normally
|
|
216
|
-
|
|
217
|
-
## Testing
|
|
218
|
-
|
|
219
|
-
### SignalWire Agent Testing Tool
|
|
220
|
-
|
|
221
|
-
The SignalWire AI Agents SDK includes a testing tool (`swaig-test`) that can simulate cloud function environments for comprehensive testing before deployment.
|
|
222
|
-
|
|
223
|
-
#### Cloud Function Environment Simulation
|
|
224
|
-
|
|
225
|
-
**Google Cloud Functions:**
|
|
226
|
-
```bash
|
|
227
|
-
# Test SWML generation in GCP environment
|
|
228
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function --gcp-project my-project --dump-swml
|
|
229
|
-
|
|
230
|
-
# Test function execution
|
|
231
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function --gcp-project my-project --exec my_function --param value
|
|
232
|
-
|
|
233
|
-
# With custom region and service
|
|
234
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function \
|
|
235
|
-
--gcp-project my-project \
|
|
236
|
-
--gcp-region us-west1 \
|
|
237
|
-
--gcp-service my-service \
|
|
238
|
-
--dump-swml
|
|
239
|
-
```
|
|
240
|
-
|
|
241
|
-
**Azure Functions:**
|
|
242
|
-
```bash
|
|
243
|
-
# Test SWML generation in Azure environment
|
|
244
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function --dump-swml
|
|
245
|
-
|
|
246
|
-
# Test function execution
|
|
247
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function --exec my_function --param value
|
|
248
|
-
|
|
249
|
-
# With custom environment and URL
|
|
250
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function \
|
|
251
|
-
--azure-env Production \
|
|
252
|
-
--azure-function-url https://myapp.azurewebsites.net/api/myfunction \
|
|
253
|
-
--dump-swml
|
|
254
|
-
```
|
|
255
|
-
|
|
256
|
-
#### Environment Variable Testing
|
|
257
|
-
|
|
258
|
-
Test with custom environment variables:
|
|
259
|
-
```bash
|
|
260
|
-
# Set individual environment variables
|
|
261
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function \
|
|
262
|
-
--env GOOGLE_CLOUD_PROJECT=my-project \
|
|
263
|
-
--env DEBUG=1 \
|
|
264
|
-
--exec my_function
|
|
265
|
-
|
|
266
|
-
# Load from environment file
|
|
267
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function \
|
|
268
|
-
--env-file production.env \
|
|
269
|
-
--dump-swml
|
|
270
|
-
```
|
|
271
|
-
|
|
272
|
-
#### Authentication Testing
|
|
273
|
-
|
|
274
|
-
Test authentication in cloud function environments:
|
|
275
|
-
```bash
|
|
276
|
-
# Test with authentication (uses agent's configured credentials)
|
|
277
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function \
|
|
278
|
-
--gcp-project my-project \
|
|
279
|
-
--dump-swml --verbose
|
|
280
|
-
|
|
281
|
-
# The tool automatically tests:
|
|
282
|
-
# - Basic auth credential embedding in URLs
|
|
283
|
-
# - Authentication challenge responses
|
|
284
|
-
# - Platform-specific auth handling
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
#### URL Generation Testing
|
|
288
|
-
|
|
289
|
-
Verify that URLs are generated correctly for each platform:
|
|
290
|
-
```bash
|
|
291
|
-
# Check URL generation with verbose output
|
|
292
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function \
|
|
293
|
-
--gcp-project my-project \
|
|
294
|
-
--dump-swml --verbose
|
|
295
|
-
|
|
296
|
-
# Extract webhook URLs from SWML
|
|
297
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function \
|
|
298
|
-
--dump-swml --raw | jq '.sections.main[1].ai.SWAIG.functions[].web_hook_url'
|
|
299
|
-
```
|
|
300
|
-
|
|
301
|
-
#### Available Testing Options
|
|
302
|
-
|
|
303
|
-
**Platform Selection:**
|
|
304
|
-
- `--simulate-serverless cloud_function` - Google Cloud Functions
|
|
305
|
-
- `--simulate-serverless azure_function` - Azure Functions
|
|
306
|
-
- `--simulate-serverless lambda` - AWS Lambda
|
|
307
|
-
- `--simulate-serverless cgi` - CGI environment
|
|
308
|
-
|
|
309
|
-
**Google Cloud Platform Options:**
|
|
310
|
-
- `--gcp-project PROJECT_ID` - Set Google Cloud project ID
|
|
311
|
-
- `--gcp-region REGION` - Set Google Cloud region (default: us-central1)
|
|
312
|
-
- `--gcp-service SERVICE` - Set service name
|
|
313
|
-
- `--gcp-function-url URL` - Override function URL
|
|
314
|
-
|
|
315
|
-
**Azure Functions Options:**
|
|
316
|
-
- `--azure-env ENVIRONMENT` - Set Azure environment (default: Development)
|
|
317
|
-
- `--azure-function-url URL` - Override Azure Function URL
|
|
318
|
-
|
|
319
|
-
**Environment Variables:**
|
|
320
|
-
- `--env KEY=value` - Set individual environment variables
|
|
321
|
-
- `--env-file FILE` - Load environment variables from file
|
|
322
|
-
|
|
323
|
-
**Output Options:**
|
|
324
|
-
- `--dump-swml` - Generate and display SWML document
|
|
325
|
-
- `--verbose` - Show detailed information
|
|
326
|
-
- `--raw` - Output raw JSON (useful for piping to jq)
|
|
327
|
-
|
|
328
|
-
#### Complete Testing Workflow
|
|
329
|
-
|
|
330
|
-
```bash
|
|
331
|
-
# 1. List available agents and tools
|
|
332
|
-
swaig-test examples/my_agent.py --list-agents
|
|
333
|
-
swaig-test examples/my_agent.py --list-tools
|
|
334
|
-
|
|
335
|
-
# 2. Test SWML generation for each platform
|
|
336
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function --gcp-project test-project --dump-swml
|
|
337
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function --dump-swml
|
|
338
|
-
|
|
339
|
-
# 3. Test specific function execution
|
|
340
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function --gcp-project test-project --exec search_knowledge --query "test"
|
|
341
|
-
|
|
342
|
-
# 4. Test with production-like environment
|
|
343
|
-
swaig-test examples/my_agent.py --simulate-serverless azure_function --env-file production.env --exec my_function --param value
|
|
344
|
-
|
|
345
|
-
# 5. Verify authentication and URL generation
|
|
346
|
-
swaig-test examples/my_agent.py --simulate-serverless cloud_function --gcp-project prod-project --dump-swml --verbose
|
|
347
|
-
```
|
|
348
|
-
|
|
349
|
-
### Local Testing
|
|
350
|
-
|
|
351
|
-
**Google Cloud Functions:**
|
|
352
|
-
```bash
|
|
353
|
-
# Install Functions Framework
|
|
354
|
-
pip install functions-framework
|
|
355
|
-
|
|
356
|
-
# Run locally
|
|
357
|
-
functions-framework --target=agent_handler --debug
|
|
358
|
-
```
|
|
359
|
-
|
|
360
|
-
**Azure Functions:**
|
|
361
|
-
```bash
|
|
362
|
-
# Install Azure Functions Core Tools
|
|
363
|
-
npm install -g azure-functions-core-tools@4
|
|
364
|
-
|
|
365
|
-
# Run locally
|
|
366
|
-
func start
|
|
367
|
-
```
|
|
368
|
-
|
|
369
|
-
### Testing Authentication
|
|
370
|
-
|
|
371
|
-
```bash
|
|
372
|
-
# Test without auth (should return 401)
|
|
373
|
-
curl https://your-function-url/
|
|
374
|
-
|
|
375
|
-
# Test with valid auth
|
|
376
|
-
curl -u username:password https://your-function-url/
|
|
377
|
-
|
|
378
|
-
# Test SWAIG function call
|
|
379
|
-
curl -u username:password \
|
|
380
|
-
-H "Content-Type: application/json" \
|
|
381
|
-
-d '{"call_id": "test", "argument": {"parsed": [{"param": "value"}]}}' \
|
|
382
|
-
https://your-function-url/your_function_name
|
|
383
|
-
```
|
|
384
|
-
|
|
385
|
-
## Best Practices
|
|
386
|
-
|
|
387
|
-
### Performance
|
|
388
|
-
- Use connection pooling for database connections
|
|
389
|
-
- Implement proper caching strategies
|
|
390
|
-
- Minimize cold start times with smaller deployment packages
|
|
391
|
-
|
|
392
|
-
### Security
|
|
393
|
-
- Always use HTTPS endpoints
|
|
394
|
-
- Implement proper authentication
|
|
395
|
-
- Use environment variables for sensitive data
|
|
396
|
-
- Consider using cloud-native secret management
|
|
397
|
-
|
|
398
|
-
### Monitoring
|
|
399
|
-
- Enable cloud platform logging
|
|
400
|
-
- Monitor function execution times
|
|
401
|
-
- Set up alerts for errors and timeouts
|
|
402
|
-
- Use distributed tracing for complex workflows
|
|
403
|
-
|
|
404
|
-
### Cost Optimization
|
|
405
|
-
- Right-size memory allocation
|
|
406
|
-
- Implement proper timeout settings
|
|
407
|
-
- Use reserved capacity for predictable workloads
|
|
408
|
-
- Monitor and optimize function execution patterns
|
|
409
|
-
|
|
410
|
-
## Troubleshooting
|
|
411
|
-
|
|
412
|
-
### Common Issues
|
|
413
|
-
|
|
414
|
-
**Environment Detection:**
|
|
415
|
-
```python
|
|
416
|
-
# Check detected mode
|
|
417
|
-
from signalwire_agents.core.logging_config import get_execution_mode
|
|
418
|
-
print(f"Detected mode: {get_execution_mode()}")
|
|
419
|
-
```
|
|
420
|
-
|
|
421
|
-
**URL Generation:**
|
|
422
|
-
```python
|
|
423
|
-
# Check generated URLs
|
|
424
|
-
agent = YourAgent(name="test")
|
|
425
|
-
print(f"Base URL: {agent.get_full_url()}")
|
|
426
|
-
print(f"Auth URL: {agent.get_full_url(include_auth=True)}")
|
|
427
|
-
```
|
|
428
|
-
|
|
429
|
-
**Authentication Issues:**
|
|
430
|
-
- Verify username/password are set correctly
|
|
431
|
-
- Check that Authorization header is being sent
|
|
432
|
-
- Ensure credentials match exactly (case-sensitive)
|
|
433
|
-
|
|
434
|
-
### Debugging
|
|
435
|
-
|
|
436
|
-
Enable debug logging:
|
|
437
|
-
```python
|
|
438
|
-
import logging
|
|
439
|
-
logging.basicConfig(level=logging.DEBUG)
|
|
440
|
-
```
|
|
441
|
-
|
|
442
|
-
Check environment variables:
|
|
443
|
-
```python
|
|
444
|
-
import os
|
|
445
|
-
for key, value in os.environ.items():
|
|
446
|
-
if 'FUNCTION' in key or 'AZURE' in key or 'GOOGLE' in key:
|
|
447
|
-
print(f"{key}: {value}")
|
|
448
|
-
```
|
|
449
|
-
|
|
450
|
-
## Migration from Other Platforms
|
|
451
|
-
|
|
452
|
-
### From AWS Lambda
|
|
453
|
-
- Update environment variable names
|
|
454
|
-
- Modify request/response handling if needed
|
|
455
|
-
- Update deployment scripts
|
|
456
|
-
|
|
457
|
-
### From Traditional Servers
|
|
458
|
-
- Add cloud function entry point
|
|
459
|
-
- Configure environment variables
|
|
460
|
-
- Update URL generation logic
|
|
461
|
-
- Test authentication flow
|
|
462
|
-
|
|
463
|
-
## Examples
|
|
464
|
-
|
|
465
|
-
See `examples/lambda_agent.py` for a complete AWS Lambda deployment example.
|
|
466
|
-
|
|
467
|
-
## Support
|
|
468
|
-
|
|
469
|
-
For issues specific to cloud function deployment:
|
|
470
|
-
1. Check the troubleshooting section above
|
|
471
|
-
2. Verify environment variables are set correctly
|
|
472
|
-
3. Test authentication flow manually
|
|
473
|
-
4. Check cloud platform logs for detailed error messages
|
|
474
|
-
5. Refer to platform-specific documentation for deployment issues
|