@signalwire/sdk 2.0.0 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/AgentBase.d.ts +1045 -0
- package/dist/AgentBase.js +2375 -0
- package/dist/AgentBase.js.map +1 -0
- package/dist/AgentServer.d.ts +146 -0
- package/dist/AgentServer.js +388 -0
- package/dist/AgentServer.js.map +1 -0
- package/dist/AuthHandler.d.ts +127 -0
- package/dist/AuthHandler.js +212 -0
- package/dist/AuthHandler.js.map +1 -0
- package/dist/ConfigLoader.d.ts +170 -0
- package/dist/ConfigLoader.js +393 -0
- package/dist/ConfigLoader.js.map +1 -0
- package/dist/ContextBuilder.d.ts +652 -0
- package/dist/ContextBuilder.js +1115 -0
- package/dist/ContextBuilder.js.map +1 -0
- package/dist/DataMap.d.ts +271 -0
- package/dist/DataMap.js +430 -0
- package/dist/DataMap.js.map +1 -0
- package/dist/FunctionResult.d.ts +481 -0
- package/dist/FunctionResult.js +775 -0
- package/dist/FunctionResult.js.map +1 -0
- package/dist/Logger.d.ts +113 -0
- package/dist/Logger.js +320 -0
- package/dist/Logger.js.map +1 -0
- package/dist/PomBuilder.d.ts +208 -0
- package/dist/PomBuilder.js +409 -0
- package/dist/PomBuilder.js.map +1 -0
- package/dist/PromptManager.d.ts +85 -0
- package/dist/PromptManager.js +108 -0
- package/dist/PromptManager.js.map +1 -0
- package/dist/SWMLHandler.d.ts +159 -0
- package/dist/SWMLHandler.js +229 -0
- package/dist/SWMLHandler.js.map +1 -0
- package/dist/SWMLService.d.ts +326 -0
- package/dist/SWMLService.js +610 -0
- package/dist/SWMLService.js.map +1 -0
- package/dist/SchemaUtils.d.ts +108 -0
- package/dist/SchemaUtils.js +317 -0
- package/dist/SchemaUtils.js.map +1 -0
- package/dist/SecurityUtils.d.ts +60 -0
- package/{src/SecurityUtils.ts → dist/SecurityUtils.js} +82 -83
- package/dist/SecurityUtils.js.map +1 -0
- package/dist/ServerlessAdapter.d.ts +119 -0
- package/dist/ServerlessAdapter.js +188 -0
- package/dist/ServerlessAdapter.js.map +1 -0
- package/dist/SessionManager.d.ts +142 -0
- package/dist/SessionManager.js +260 -0
- package/dist/SessionManager.js.map +1 -0
- package/dist/SslConfig.d.ts +77 -0
- package/dist/SslConfig.js +100 -0
- package/dist/SslConfig.js.map +1 -0
- package/dist/SwaigFunction.d.ts +159 -0
- package/dist/SwaigFunction.js +209 -0
- package/dist/SwaigFunction.js.map +1 -0
- package/dist/SwmlBuilder.d.ts +165 -0
- package/dist/SwmlBuilder.js +247 -0
- package/dist/SwmlBuilder.js.map +1 -0
- package/dist/SwmlVerbMethods.generated.d.ts +254 -0
- package/dist/SwmlVerbMethods.generated.js +9 -0
- package/dist/SwmlVerbMethods.generated.js.map +1 -0
- package/dist/TypeInference.d.ts +71 -0
- package/dist/TypeInference.js +164 -0
- package/dist/TypeInference.js.map +1 -0
- package/dist/WebService.d.ts +148 -0
- package/dist/WebService.js +532 -0
- package/dist/WebService.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +22 -0
- package/dist/cli/agent-loader.js +144 -0
- package/dist/cli/agent-loader.js.map +1 -0
- package/dist/cli/mock-data.d.ts +37 -0
- package/dist/cli/mock-data.js +80 -0
- package/dist/cli/mock-data.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +32 -0
- package/dist/cli/swaig-test.js +418 -0
- package/dist/cli/swaig-test.js.map +1 -0
- package/dist/generateVerbTypes.d.ts +11 -0
- package/dist/generateVerbTypes.js +265 -0
- package/dist/generateVerbTypes.js.map +1 -0
- package/dist/index.d.ts +146 -0
- package/dist/index.js +152 -0
- package/dist/index.js.map +1 -0
- package/dist/livewire/index.d.ts +653 -0
- package/dist/livewire/index.js +992 -0
- package/dist/livewire/index.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +89 -0
- package/dist/prefabs/ConciergeAgent.js +245 -0
- package/dist/prefabs/ConciergeAgent.js.map +1 -0
- package/dist/prefabs/FAQBotAgent.d.ts +113 -0
- package/dist/prefabs/FAQBotAgent.js +329 -0
- package/dist/prefabs/FAQBotAgent.js.map +1 -0
- package/dist/prefabs/InfoGathererAgent.d.ts +126 -0
- package/dist/prefabs/InfoGathererAgent.js +287 -0
- package/dist/prefabs/InfoGathererAgent.js.map +1 -0
- package/dist/prefabs/ReceptionistAgent.d.ts +104 -0
- package/dist/prefabs/ReceptionistAgent.js +303 -0
- package/dist/prefabs/ReceptionistAgent.js.map +1 -0
- package/dist/prefabs/SurveyAgent.d.ts +148 -0
- package/dist/prefabs/SurveyAgent.js +540 -0
- package/dist/prefabs/SurveyAgent.js.map +1 -0
- package/{src/prefabs/index.ts → dist/prefabs/index.d.ts} +1 -15
- package/dist/prefabs/index.js +14 -0
- package/dist/prefabs/index.js.map +1 -0
- package/dist/relay/Action.d.ts +258 -0
- package/dist/relay/Action.js +402 -0
- package/dist/relay/Action.js.map +1 -0
- package/dist/relay/Call.d.ts +697 -0
- package/dist/relay/Call.js +1062 -0
- package/dist/relay/Call.js.map +1 -0
- package/dist/relay/Deferred.d.ts +44 -0
- package/dist/relay/Deferred.js +69 -0
- package/dist/relay/Deferred.js.map +1 -0
- package/dist/relay/Message.d.ts +103 -0
- package/dist/relay/Message.js +169 -0
- package/dist/relay/Message.js.map +1 -0
- package/dist/relay/RelayClient.d.ts +302 -0
- package/dist/relay/RelayClient.js +1019 -0
- package/dist/relay/RelayClient.js.map +1 -0
- package/dist/relay/RelayError.d.ts +15 -0
- package/dist/relay/RelayError.js +20 -0
- package/dist/relay/RelayError.js.map +1 -0
- package/dist/relay/RelayEvent.d.ts +254 -0
- package/dist/relay/RelayEvent.js +509 -0
- package/dist/relay/RelayEvent.js.map +1 -0
- package/dist/relay/constants.d.ts +90 -0
- package/{src/relay/constants.ts → dist/relay/constants.js} +11 -29
- package/dist/relay/constants.js.map +1 -0
- package/dist/relay/index.d.ts +16 -0
- package/dist/relay/index.js +18 -0
- package/dist/relay/index.js.map +1 -0
- package/dist/relay/types.d.ts +142 -0
- package/dist/relay/types.js +5 -0
- package/dist/relay/types.js.map +1 -0
- package/dist/rest/HttpClient.d.ts +80 -0
- package/dist/rest/HttpClient.js +148 -0
- package/dist/rest/HttpClient.js.map +1 -0
- package/dist/rest/RestError.d.ts +30 -0
- package/dist/rest/RestError.js +39 -0
- package/dist/rest/RestError.js.map +1 -0
- package/dist/rest/base/BaseResource.d.ts +24 -0
- package/dist/rest/base/BaseResource.js +29 -0
- package/dist/rest/base/BaseResource.js.map +1 -0
- package/dist/rest/base/CrudResource.d.ts +68 -0
- package/dist/rest/base/CrudResource.js +82 -0
- package/dist/rest/base/CrudResource.js.map +1 -0
- package/dist/rest/base/CrudWithAddresses.d.ts +22 -0
- package/dist/rest/base/CrudWithAddresses.js +25 -0
- package/dist/rest/base/CrudWithAddresses.js.map +1 -0
- package/{src/rest/index.ts → dist/rest/index.d.ts} +53 -122
- package/dist/rest/index.js +195 -0
- 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/dist/rest/pagination.d.ts +39 -0
- 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 -2489
- package/src/AgentServer.ts +0 -415
- package/src/AuthHandler.ts +0 -256
- package/src/ConfigLoader.ts +0 -447
- package/src/ContextBuilder.ts +0 -1150
- package/src/DataMap.ts +0 -449
- package/src/FunctionResult.ts +0 -866
- package/src/Logger.ts +0 -337
- package/src/PomBuilder.ts +0 -439
- package/src/PromptManager.ts +0 -133
- package/src/SWMLHandler.ts +0 -298
- package/src/SWMLService.ts +0 -717
- package/src/SchemaUtils.ts +0 -361
- package/src/ServerlessAdapter.ts +0 -221
- package/src/SessionManager.ts +0 -311
- package/src/SslConfig.ts +0 -118
- package/src/SwaigFunction.ts +0 -276
- package/src/SwmlBuilder.ts +0 -258
- package/src/SwmlVerbMethods.generated.ts +0 -234
- package/src/TypeInference.ts +0 -181
- package/src/WebService.ts +0 -619
- 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/index.ts +0 -167
- package/src/livewire/index.ts +0 -950
- package/src/prefabs/ConciergeAgent.ts +0 -287
- package/src/prefabs/FAQBotAgent.ts +0 -384
- package/src/prefabs/InfoGathererAgent.ts +0 -339
- package/src/prefabs/ReceptionistAgent.ts +0 -366
- package/src/prefabs/SurveyAgent.ts +0 -646
- package/src/relay/Action.ts +0 -314
- package/src/relay/Call.ts +0 -854
- package/src/relay/Deferred.ts +0 -71
- package/src/relay/Message.ts +0 -148
- package/src/relay/RelayClient.ts +0 -1036
- package/src/relay/RelayError.ts +0 -14
- package/src/relay/RelayEvent.ts +0 -892
- package/src/relay/index.ts +0 -123
- package/src/relay/types.ts +0 -149
- package/src/rest/HttpClient.ts +0 -103
- package/src/rest/RestError.ts +0 -31
- package/src/rest/base/BaseResource.ts +0 -19
- package/src/rest/base/CrudResource.ts +0 -51
- package/src/rest/base/CrudWithAddresses.ts +0 -26
- package/src/rest/namespaces/addresses.ts +0 -32
- package/src/rest/namespaces/calling.ts +0 -187
- package/src/rest/namespaces/chat.ts +0 -20
- package/src/rest/namespaces/compat.ts +0 -352
- package/src/rest/namespaces/datasphere.ts +0 -45
- package/src/rest/namespaces/fabric.ts +0 -222
- package/src/rest/namespaces/imported-numbers.ts +0 -20
- package/src/rest/namespaces/logs.ts +0 -84
- package/src/rest/namespaces/lookup.ts +0 -21
- package/src/rest/namespaces/mfa.ts +0 -30
- package/src/rest/namespaces/number-groups.ts +0 -38
- package/src/rest/namespaces/phone-numbers.ts +0 -44
- package/src/rest/namespaces/project.ts +0 -36
- package/src/rest/namespaces/pubsub.ts +0 -20
- package/src/rest/namespaces/queues.ts +0 -33
- package/src/rest/namespaces/recordings.ts +0 -28
- package/src/rest/namespaces/registry.ts +0 -101
- package/src/rest/namespaces/short-codes.ts +0 -28
- package/src/rest/namespaces/sip-profile.ts +0 -25
- package/src/rest/namespaces/verified-callers.ts +0 -27
- package/src/rest/namespaces/video.ts +0 -165
- package/src/rest/pagination.ts +0 -84
- package/src/rest/types.ts +0 -61
- package/src/skills/SkillBase.ts +0 -547
- package/src/skills/SkillManager.ts +0 -415
- package/src/skills/SkillRegistry.ts +0 -367
- package/src/skills/builtin/api_ninjas_trivia.ts +0 -280
- package/src/skills/builtin/ask_claude.ts +0 -241
- package/src/skills/builtin/claude_skills.ts +0 -978
- package/src/skills/builtin/custom_skills.ts +0 -312
- package/src/skills/builtin/datasphere.ts +0 -438
- package/src/skills/builtin/datasphere_serverless.ts +0 -339
- package/src/skills/builtin/datetime.ts +0 -130
- package/src/skills/builtin/google_maps.ts +0 -651
- package/src/skills/builtin/info_gatherer.ts +0 -405
- package/src/skills/builtin/joke.ts +0 -191
- package/src/skills/builtin/math.ts +0 -142
- package/src/skills/builtin/mcp_gateway.ts +0 -677
- package/src/skills/builtin/native_vector_search.ts +0 -901
- package/src/skills/builtin/play_background_file.ts +0 -358
- package/src/skills/builtin/spider.ts +0 -869
- package/src/skills/builtin/swml_transfer.ts +0 -635
- package/src/skills/builtin/weather_api.ts +0 -248
- package/src/skills/builtin/web_search.ts +0 -1074
- package/src/skills/builtin/wikipedia_search.ts +0 -299
- 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,752 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Native Vector Search Skill - Document search over a local or remote index.
|
|
3
|
+
*
|
|
4
|
+
* Port of the Python `NativeVectorSearchSkill`. Supports three backends in
|
|
5
|
+
* Python (SQLite `.swsearch`, PostgreSQL `pgvector`, and a remote HTTP
|
|
6
|
+
* search server). This TypeScript implementation provides:
|
|
7
|
+
*
|
|
8
|
+
* - In-memory TF-IDF search over `documents` passed via config (fast path
|
|
9
|
+
* that needs no additional deps), and
|
|
10
|
+
* - Remote HTTP search via a configured `remote_url` (compatible with the
|
|
11
|
+
* Python SDK's `sw-search` remote protocol).
|
|
12
|
+
*
|
|
13
|
+
* The SQLite/pgvector backends require native Python dependencies and are
|
|
14
|
+
* not available here; their schema entries are preserved so configuration
|
|
15
|
+
* written for the Python SDK remains valid.
|
|
16
|
+
*/
|
|
17
|
+
import { SkillBase } from '../SkillBase.js';
|
|
18
|
+
import { FunctionResult } from '../../FunctionResult.js';
|
|
19
|
+
import { getLogger } from '../../Logger.js';
|
|
20
|
+
import { validateUrl } from '../../SecurityUtils.js';
|
|
21
|
+
const log = getLogger('NativeVectorSearchSkill');
|
|
22
|
+
/**
|
|
23
|
+
* Tokenize text into lowercase words, removing punctuation and common stop words.
|
|
24
|
+
*/
|
|
25
|
+
function tokenize(text) {
|
|
26
|
+
const stopWords = new Set([
|
|
27
|
+
'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
|
|
28
|
+
'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
|
|
29
|
+
'should', 'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'for',
|
|
30
|
+
'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
|
|
31
|
+
'before', 'after', 'above', 'below', 'between', 'and', 'but', 'or',
|
|
32
|
+
'nor', 'not', 'so', 'yet', 'both', 'either', 'neither', 'each',
|
|
33
|
+
'every', 'all', 'any', 'few', 'more', 'most', 'other', 'some',
|
|
34
|
+
'such', 'no', 'only', 'own', 'same', 'than', 'too', 'very',
|
|
35
|
+
'just', 'because', 'if', 'when', 'where', 'how', 'what', 'which',
|
|
36
|
+
'who', 'whom', 'this', 'that', 'these', 'those', 'i', 'me', 'my',
|
|
37
|
+
'we', 'our', 'you', 'your', 'he', 'him', 'his', 'she', 'her',
|
|
38
|
+
'it', 'its', 'they', 'them', 'their', 'about', 'up', 'out',
|
|
39
|
+
]);
|
|
40
|
+
return text
|
|
41
|
+
.toLowerCase()
|
|
42
|
+
.replace(/[^a-z0-9\s]/g, ' ')
|
|
43
|
+
.split(/\s+/)
|
|
44
|
+
.filter((word) => word.length > 1 && !stopWords.has(word));
|
|
45
|
+
}
|
|
46
|
+
function termFrequency(tokens) {
|
|
47
|
+
const tf = new Map();
|
|
48
|
+
for (const token of tokens) {
|
|
49
|
+
tf.set(token, (tf.get(token) ?? 0) + 1);
|
|
50
|
+
}
|
|
51
|
+
const len = tokens.length || 1;
|
|
52
|
+
for (const [term, count] of tf) {
|
|
53
|
+
tf.set(term, count / len);
|
|
54
|
+
}
|
|
55
|
+
return tf;
|
|
56
|
+
}
|
|
57
|
+
function inverseDocumentFrequency(corpus) {
|
|
58
|
+
const idf = new Map();
|
|
59
|
+
const numDocs = corpus.length || 1;
|
|
60
|
+
const docFreq = new Map();
|
|
61
|
+
for (const tokens of corpus) {
|
|
62
|
+
const unique = new Set(tokens);
|
|
63
|
+
for (const t of unique)
|
|
64
|
+
docFreq.set(t, (docFreq.get(t) ?? 0) + 1);
|
|
65
|
+
}
|
|
66
|
+
for (const [term, freq] of docFreq) {
|
|
67
|
+
idf.set(term, Math.log((numDocs + 1) / (freq + 1)) + 1);
|
|
68
|
+
}
|
|
69
|
+
return idf;
|
|
70
|
+
}
|
|
71
|
+
function scoreTfIdf(queryTokens, docTf, idf) {
|
|
72
|
+
if (queryTokens.length === 0)
|
|
73
|
+
return 0;
|
|
74
|
+
let score = 0;
|
|
75
|
+
const queryTf = termFrequency(queryTokens);
|
|
76
|
+
for (const [term, qWeight] of queryTf) {
|
|
77
|
+
const docWeight = docTf.get(term) ?? 0;
|
|
78
|
+
const idfWeight = idf.get(term) ?? 1;
|
|
79
|
+
score += qWeight * docWeight * idfWeight * idfWeight;
|
|
80
|
+
}
|
|
81
|
+
return score;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Document search using TF-IDF in-memory scoring or a remote search server.
|
|
85
|
+
*
|
|
86
|
+
* Multi-instance capable (distinguished by `tool_name` + `index_file`).
|
|
87
|
+
*
|
|
88
|
+
* @example Local JSON index
|
|
89
|
+
* ```ts
|
|
90
|
+
* agent.addSkill('native_vector_search', {
|
|
91
|
+
* tool_name: 'search_docs',
|
|
92
|
+
* index_file: './data/support-docs.json',
|
|
93
|
+
* count: 3,
|
|
94
|
+
* });
|
|
95
|
+
* ```
|
|
96
|
+
*/
|
|
97
|
+
export class NativeVectorSearchSkill extends SkillBase {
|
|
98
|
+
// Python ground truth: skills/native_vector_search/skill.py:~75-82
|
|
99
|
+
static SKILL_NAME = 'native_vector_search';
|
|
100
|
+
static SKILL_DESCRIPTION = 'Search document indexes using vector similarity and keyword search (local or remote)';
|
|
101
|
+
static SKILL_VERSION = '1.0.0';
|
|
102
|
+
static REQUIRED_PACKAGES = [];
|
|
103
|
+
static REQUIRED_ENV_VARS = [];
|
|
104
|
+
static SUPPORTS_MULTIPLE_INSTANCES = true;
|
|
105
|
+
static getParameterSchema() {
|
|
106
|
+
return {
|
|
107
|
+
...super.getParameterSchema(),
|
|
108
|
+
index_file: {
|
|
109
|
+
type: 'string',
|
|
110
|
+
description: 'Path to .swsearch index file (SQLite backend only). Use this for local file-based search',
|
|
111
|
+
required: false,
|
|
112
|
+
},
|
|
113
|
+
build_index: {
|
|
114
|
+
type: 'boolean',
|
|
115
|
+
description: 'Whether to build index from source files',
|
|
116
|
+
default: false,
|
|
117
|
+
required: false,
|
|
118
|
+
},
|
|
119
|
+
source_dir: {
|
|
120
|
+
type: 'string',
|
|
121
|
+
description: 'Directory containing documents to index (required if build_index=True)',
|
|
122
|
+
required: false,
|
|
123
|
+
},
|
|
124
|
+
remote_url: {
|
|
125
|
+
type: 'string',
|
|
126
|
+
description: 'URL of remote search server for network mode (e.g., http://localhost:8001)',
|
|
127
|
+
required: false,
|
|
128
|
+
},
|
|
129
|
+
index_name: {
|
|
130
|
+
type: 'string',
|
|
131
|
+
description: 'Name of index on remote server (network mode only, used with remote_url)',
|
|
132
|
+
default: 'default',
|
|
133
|
+
required: false,
|
|
134
|
+
},
|
|
135
|
+
count: {
|
|
136
|
+
type: 'integer',
|
|
137
|
+
description: 'Number of search results to return',
|
|
138
|
+
default: 5,
|
|
139
|
+
required: false,
|
|
140
|
+
min: 1,
|
|
141
|
+
max: 20,
|
|
142
|
+
},
|
|
143
|
+
similarity_threshold: {
|
|
144
|
+
type: 'number',
|
|
145
|
+
description: 'Minimum similarity score for results (0.0 = no limit, 1.0 = exact match)',
|
|
146
|
+
default: 0.0,
|
|
147
|
+
required: false,
|
|
148
|
+
min: 0.0,
|
|
149
|
+
max: 1.0,
|
|
150
|
+
},
|
|
151
|
+
tags: {
|
|
152
|
+
type: 'array',
|
|
153
|
+
description: 'Tags to filter search results',
|
|
154
|
+
default: [],
|
|
155
|
+
required: false,
|
|
156
|
+
items: { type: 'string' },
|
|
157
|
+
},
|
|
158
|
+
global_tags: {
|
|
159
|
+
type: 'array',
|
|
160
|
+
description: 'Tags to apply to all indexed documents',
|
|
161
|
+
default: [],
|
|
162
|
+
required: false,
|
|
163
|
+
items: { type: 'string' },
|
|
164
|
+
},
|
|
165
|
+
file_types: {
|
|
166
|
+
type: 'array',
|
|
167
|
+
description: 'File extensions to include when building index',
|
|
168
|
+
default: ['md', 'txt', 'pdf', 'docx', 'html'],
|
|
169
|
+
required: false,
|
|
170
|
+
items: { type: 'string' },
|
|
171
|
+
},
|
|
172
|
+
exclude_patterns: {
|
|
173
|
+
type: 'array',
|
|
174
|
+
description: 'Patterns to exclude when building index',
|
|
175
|
+
default: [
|
|
176
|
+
'**/node_modules/**',
|
|
177
|
+
'**/.git/**',
|
|
178
|
+
'**/dist/**',
|
|
179
|
+
'**/build/**',
|
|
180
|
+
],
|
|
181
|
+
required: false,
|
|
182
|
+
items: { type: 'string' },
|
|
183
|
+
},
|
|
184
|
+
no_results_message: {
|
|
185
|
+
type: 'string',
|
|
186
|
+
description: 'Message when no results are found',
|
|
187
|
+
default: "No information found for '{query}'",
|
|
188
|
+
required: false,
|
|
189
|
+
},
|
|
190
|
+
response_prefix: {
|
|
191
|
+
type: 'string',
|
|
192
|
+
description: 'Prefix to add to search results',
|
|
193
|
+
default: '',
|
|
194
|
+
required: false,
|
|
195
|
+
},
|
|
196
|
+
response_postfix: {
|
|
197
|
+
type: 'string',
|
|
198
|
+
description: 'Postfix to add to search results',
|
|
199
|
+
default: '',
|
|
200
|
+
required: false,
|
|
201
|
+
},
|
|
202
|
+
max_content_length: {
|
|
203
|
+
type: 'integer',
|
|
204
|
+
description: 'Maximum total response size in characters (distributed across all results)',
|
|
205
|
+
default: 32768,
|
|
206
|
+
required: false,
|
|
207
|
+
min: 1000,
|
|
208
|
+
},
|
|
209
|
+
response_format_callback: {
|
|
210
|
+
type: 'object',
|
|
211
|
+
description: 'Optional callback function to format/transform the response.',
|
|
212
|
+
required: false,
|
|
213
|
+
},
|
|
214
|
+
description: {
|
|
215
|
+
type: 'string',
|
|
216
|
+
description: 'Tool description',
|
|
217
|
+
default: 'Search the knowledge base for information',
|
|
218
|
+
required: false,
|
|
219
|
+
},
|
|
220
|
+
hints: {
|
|
221
|
+
type: 'array',
|
|
222
|
+
description: 'Speech recognition hints',
|
|
223
|
+
default: [],
|
|
224
|
+
required: false,
|
|
225
|
+
items: { type: 'string' },
|
|
226
|
+
},
|
|
227
|
+
nlp_backend: {
|
|
228
|
+
type: 'string',
|
|
229
|
+
description: 'NLP backend for query processing (deprecated)',
|
|
230
|
+
default: 'basic',
|
|
231
|
+
required: false,
|
|
232
|
+
enum: ['basic', 'spacy', 'nltk'],
|
|
233
|
+
},
|
|
234
|
+
query_nlp_backend: {
|
|
235
|
+
type: 'string',
|
|
236
|
+
description: 'NLP backend for query expansion',
|
|
237
|
+
required: false,
|
|
238
|
+
enum: ['basic', 'spacy', 'nltk'],
|
|
239
|
+
},
|
|
240
|
+
index_nlp_backend: {
|
|
241
|
+
type: 'string',
|
|
242
|
+
description: 'NLP backend for indexing',
|
|
243
|
+
required: false,
|
|
244
|
+
enum: ['basic', 'spacy', 'nltk'],
|
|
245
|
+
},
|
|
246
|
+
backend: {
|
|
247
|
+
type: 'string',
|
|
248
|
+
description: "Storage backend for local database mode: 'sqlite' or 'pgvector'. Ignored if remote_url is set",
|
|
249
|
+
default: 'sqlite',
|
|
250
|
+
required: false,
|
|
251
|
+
enum: ['sqlite', 'pgvector'],
|
|
252
|
+
},
|
|
253
|
+
connection_string: {
|
|
254
|
+
type: 'string',
|
|
255
|
+
description: 'PostgreSQL connection string (pgvector backend only)',
|
|
256
|
+
required: false,
|
|
257
|
+
},
|
|
258
|
+
collection_name: {
|
|
259
|
+
type: 'string',
|
|
260
|
+
description: 'Collection/table name in PostgreSQL (pgvector backend only)',
|
|
261
|
+
required: false,
|
|
262
|
+
},
|
|
263
|
+
verbose: {
|
|
264
|
+
type: 'boolean',
|
|
265
|
+
description: 'Enable verbose logging',
|
|
266
|
+
default: false,
|
|
267
|
+
required: false,
|
|
268
|
+
},
|
|
269
|
+
keyword_weight: {
|
|
270
|
+
type: 'number',
|
|
271
|
+
description: 'Manual keyword weight (0.0-1.0). Overrides automatic weight detection',
|
|
272
|
+
required: false,
|
|
273
|
+
min: 0.0,
|
|
274
|
+
max: 1.0,
|
|
275
|
+
},
|
|
276
|
+
model_name: {
|
|
277
|
+
type: 'string',
|
|
278
|
+
description: 'Embedding model to use',
|
|
279
|
+
default: 'mini',
|
|
280
|
+
required: false,
|
|
281
|
+
},
|
|
282
|
+
overwrite: {
|
|
283
|
+
type: 'boolean',
|
|
284
|
+
description: 'Overwrite existing pgvector collection when building index',
|
|
285
|
+
default: false,
|
|
286
|
+
required: false,
|
|
287
|
+
},
|
|
288
|
+
documents: {
|
|
289
|
+
type: 'array',
|
|
290
|
+
description: 'In-memory array of documents to index: [{ id, text, metadata?, tags? }] (TS-specific)',
|
|
291
|
+
required: false,
|
|
292
|
+
items: { type: 'object' },
|
|
293
|
+
},
|
|
294
|
+
};
|
|
295
|
+
}
|
|
296
|
+
// Runtime state
|
|
297
|
+
toolName = 'search_knowledge';
|
|
298
|
+
backend = 'sqlite';
|
|
299
|
+
indexFile;
|
|
300
|
+
remoteUrl;
|
|
301
|
+
indexName = 'default';
|
|
302
|
+
count = 5;
|
|
303
|
+
similarityThreshold = 0.0;
|
|
304
|
+
filterTags = [];
|
|
305
|
+
noResultsMessage = "No information found for '{query}'";
|
|
306
|
+
responsePrefix = '';
|
|
307
|
+
responsePostfix = '';
|
|
308
|
+
maxContentLength = 32768;
|
|
309
|
+
responseFormatCallback;
|
|
310
|
+
description = 'Search the knowledge base for information';
|
|
311
|
+
verbose = false;
|
|
312
|
+
/**
|
|
313
|
+
* Hybrid scoring weight: 0.0 = pure TF-IDF, 1.0 = pure keyword overlap.
|
|
314
|
+
* `null` means "use Python default of 0.3 at search time" — matches
|
|
315
|
+
* Python `SearchEngine._merge_all_results` behavior when `keyword_weight`
|
|
316
|
+
* is None (see `search_engine.py` line 449).
|
|
317
|
+
*/
|
|
318
|
+
keywordWeight = null;
|
|
319
|
+
searchAvailable = false;
|
|
320
|
+
useRemote = false;
|
|
321
|
+
remoteBaseUrl;
|
|
322
|
+
remoteAuth;
|
|
323
|
+
// In-memory index state
|
|
324
|
+
_documents = [];
|
|
325
|
+
_tokenizedDocs = [];
|
|
326
|
+
_docTfs = [];
|
|
327
|
+
_idf = new Map();
|
|
328
|
+
_indexed = false;
|
|
329
|
+
getInstanceKey() {
|
|
330
|
+
const toolName = this.getConfig('tool_name', 'search_knowledge');
|
|
331
|
+
const indexFile = this.getConfig('index_file', 'default');
|
|
332
|
+
return `${this.skillName}_${toolName}_${indexFile}`;
|
|
333
|
+
}
|
|
334
|
+
async setup() {
|
|
335
|
+
// Config
|
|
336
|
+
this.toolName = this.getConfig('tool_name', 'search_knowledge');
|
|
337
|
+
this.backend = this.getConfig('backend', 'sqlite');
|
|
338
|
+
this.indexFile = this.getConfig('index_file', undefined);
|
|
339
|
+
this.count = this.getConfig('count', 5);
|
|
340
|
+
this.similarityThreshold = this.getConfig('similarity_threshold', 0.0);
|
|
341
|
+
this.filterTags = this.getConfig('tags', []) ?? [];
|
|
342
|
+
this.noResultsMessage = this.getConfig('no_results_message', "No information found for '{query}'");
|
|
343
|
+
this.responsePrefix = this.getConfig('response_prefix', '');
|
|
344
|
+
this.responsePostfix = this.getConfig('response_postfix', '');
|
|
345
|
+
this.maxContentLength = this.getConfig('max_content_length', 32768);
|
|
346
|
+
this.responseFormatCallback = this.getConfig('response_format_callback', undefined);
|
|
347
|
+
this.description = this.getConfig('description', 'Search the knowledge base for information');
|
|
348
|
+
this.verbose = this.getConfig('verbose', false);
|
|
349
|
+
const kw = this.getConfig('keyword_weight', null);
|
|
350
|
+
this.keywordWeight = kw == null ? null : Math.min(1.0, Math.max(0.0, kw));
|
|
351
|
+
// Remote search configuration
|
|
352
|
+
this.remoteUrl = this.getConfig('remote_url', undefined);
|
|
353
|
+
this.indexName = this.getConfig('index_name', 'default');
|
|
354
|
+
// Parse auth from URL if present
|
|
355
|
+
if (this.remoteUrl) {
|
|
356
|
+
try {
|
|
357
|
+
const parsed = new URL(this.remoteUrl);
|
|
358
|
+
if (parsed.username && parsed.password) {
|
|
359
|
+
this.remoteAuth = {
|
|
360
|
+
user: decodeURIComponent(parsed.username),
|
|
361
|
+
pass: decodeURIComponent(parsed.password),
|
|
362
|
+
};
|
|
363
|
+
parsed.username = '';
|
|
364
|
+
parsed.password = '';
|
|
365
|
+
this.remoteBaseUrl = parsed.toString().replace(/\/+$/, '');
|
|
366
|
+
}
|
|
367
|
+
else {
|
|
368
|
+
this.remoteBaseUrl = this.remoteUrl.replace(/\/+$/, '');
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
catch {
|
|
372
|
+
this.remoteBaseUrl = this.remoteUrl;
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
// Remote mode — validate and skip heavy local setup
|
|
376
|
+
if (this.remoteUrl) {
|
|
377
|
+
this.useRemote = true;
|
|
378
|
+
// SSRF protection — match Python skills/native_vector_search/skill.py:292-293
|
|
379
|
+
// which calls validate_url(self.remote_url) and refuses to connect to
|
|
380
|
+
// private/loopback/metadata-endpoint URLs in multi-tenant deployments.
|
|
381
|
+
const urlToValidate = this.remoteBaseUrl ?? this.remoteUrl;
|
|
382
|
+
if (!(await validateUrl(urlToValidate))) {
|
|
383
|
+
log.error('native_vector_search: remote_url rejected by SSRF protection', {
|
|
384
|
+
url: urlToValidate,
|
|
385
|
+
});
|
|
386
|
+
return false;
|
|
387
|
+
}
|
|
388
|
+
try {
|
|
389
|
+
// Python uses timeout=5 for the health check (skill.py). Don't wait
|
|
390
|
+
// the default 30s if a misconfigured remote URL doesn't respond.
|
|
391
|
+
const response = await this._fetchWithAuth(`${this.remoteBaseUrl}/health`, { method: 'GET' }, 5000);
|
|
392
|
+
if (response.status === 200) {
|
|
393
|
+
log.info('native_vector_search: remote server available', {
|
|
394
|
+
url: this.remoteBaseUrl,
|
|
395
|
+
});
|
|
396
|
+
this.searchAvailable = true;
|
|
397
|
+
return true;
|
|
398
|
+
}
|
|
399
|
+
if (response.status === 401) {
|
|
400
|
+
log.error('native_vector_search: remote auth failed');
|
|
401
|
+
}
|
|
402
|
+
else {
|
|
403
|
+
log.error('native_vector_search: remote server returned non-200', {
|
|
404
|
+
status: response.status,
|
|
405
|
+
});
|
|
406
|
+
}
|
|
407
|
+
this.searchAvailable = false;
|
|
408
|
+
}
|
|
409
|
+
catch (err) {
|
|
410
|
+
log.error('native_vector_search: failed to connect to remote', {
|
|
411
|
+
error: err instanceof Error ? err.message : String(err),
|
|
412
|
+
});
|
|
413
|
+
this.searchAvailable = false;
|
|
414
|
+
}
|
|
415
|
+
return this.searchAvailable;
|
|
416
|
+
}
|
|
417
|
+
// Local / in-memory mode
|
|
418
|
+
this.useRemote = false;
|
|
419
|
+
this._loadDocuments();
|
|
420
|
+
this.searchAvailable = this._indexed;
|
|
421
|
+
if (this.verbose) {
|
|
422
|
+
log.info('native_vector_search: local index loaded', {
|
|
423
|
+
docCount: this._documents.length,
|
|
424
|
+
indexed: this._indexed,
|
|
425
|
+
});
|
|
426
|
+
}
|
|
427
|
+
// Python parity (skill.py): local mode always returns True from setup()
|
|
428
|
+
// even when no documents are loaded. The skill stays registered and the
|
|
429
|
+
// "no information found" fallback fires at query time instead of the
|
|
430
|
+
// skill being rejected entirely. This lets a caller fix the config and
|
|
431
|
+
// reload without tearing down the agent.
|
|
432
|
+
return true;
|
|
433
|
+
}
|
|
434
|
+
getHints() {
|
|
435
|
+
const hints = ['search', 'find', 'look up', 'documentation', 'knowledge base'];
|
|
436
|
+
const extra = this.getConfig('hints', []) ?? [];
|
|
437
|
+
return [...hints, ...extra];
|
|
438
|
+
}
|
|
439
|
+
getGlobalData() {
|
|
440
|
+
const globalData = {};
|
|
441
|
+
if (this._indexed) {
|
|
442
|
+
globalData['search_stats'] = {
|
|
443
|
+
doc_count: this._documents.length,
|
|
444
|
+
backend: this.useRemote ? 'remote' : this.backend,
|
|
445
|
+
};
|
|
446
|
+
}
|
|
447
|
+
return globalData;
|
|
448
|
+
}
|
|
449
|
+
async cleanup() {
|
|
450
|
+
this._documents = [];
|
|
451
|
+
this._tokenizedDocs = [];
|
|
452
|
+
this._docTfs = [];
|
|
453
|
+
this._idf = new Map();
|
|
454
|
+
this._indexed = false;
|
|
455
|
+
}
|
|
456
|
+
/**
|
|
457
|
+
* Load and TF-IDF-index documents from config.
|
|
458
|
+
* Applies `global_tags` to every document's tag list.
|
|
459
|
+
*/
|
|
460
|
+
_loadDocuments() {
|
|
461
|
+
const docs = this.getConfig('documents', []) ?? [];
|
|
462
|
+
const globalTags = this.getConfig('global_tags', []) ?? [];
|
|
463
|
+
if (!Array.isArray(docs) || docs.length === 0) {
|
|
464
|
+
this._documents = [];
|
|
465
|
+
this._indexed = false;
|
|
466
|
+
return;
|
|
467
|
+
}
|
|
468
|
+
this._documents = docs
|
|
469
|
+
.filter((d) => d &&
|
|
470
|
+
typeof d.id === 'string' &&
|
|
471
|
+
typeof d.text === 'string' &&
|
|
472
|
+
d.text.trim().length > 0)
|
|
473
|
+
.map((d) => ({
|
|
474
|
+
...d,
|
|
475
|
+
tags: Array.from(new Set([...(d.tags ?? []), ...globalTags])),
|
|
476
|
+
}));
|
|
477
|
+
this._tokenizedDocs = this._documents.map((doc) => tokenize(doc.text));
|
|
478
|
+
this._docTfs = this._tokenizedDocs.map((tokens) => termFrequency(tokens));
|
|
479
|
+
this._idf = inverseDocumentFrequency(this._tokenizedDocs);
|
|
480
|
+
this._indexed = this._documents.length > 0;
|
|
481
|
+
}
|
|
482
|
+
/** @returns A single search tool using the configured `tool_name` (default `search_knowledge`). */
|
|
483
|
+
getTools() {
|
|
484
|
+
const toolName = this.getConfig('tool_name', 'search_knowledge');
|
|
485
|
+
const defaultCount = this.getConfig('count', 5);
|
|
486
|
+
const description = this.getConfig('description', 'Search the knowledge base for information');
|
|
487
|
+
return [
|
|
488
|
+
{
|
|
489
|
+
name: toolName,
|
|
490
|
+
description,
|
|
491
|
+
parameters: {
|
|
492
|
+
query: {
|
|
493
|
+
type: 'string',
|
|
494
|
+
description: 'Search query or question',
|
|
495
|
+
},
|
|
496
|
+
count: {
|
|
497
|
+
type: 'integer',
|
|
498
|
+
description: `Number of results to return (default: ${defaultCount})`,
|
|
499
|
+
default: defaultCount,
|
|
500
|
+
},
|
|
501
|
+
},
|
|
502
|
+
required: ['query'],
|
|
503
|
+
handler: async (args, rawData) => this._searchHandler(args, rawData),
|
|
504
|
+
},
|
|
505
|
+
];
|
|
506
|
+
}
|
|
507
|
+
/** @returns Prompt section describing the local document search capabilities. */
|
|
508
|
+
_getPromptSections() {
|
|
509
|
+
const toolName = this.getConfig('tool_name', 'search_knowledge');
|
|
510
|
+
const docCount = this._documents.length;
|
|
511
|
+
const mode = this.useRemote ? 'remote search server' : 'local document indexes';
|
|
512
|
+
return [
|
|
513
|
+
{
|
|
514
|
+
title: 'Knowledge Search',
|
|
515
|
+
body: `You can search ${mode} using the ${toolName} tool${docCount > 0 ? ` over ${docCount} indexed document(s)` : ''}.`,
|
|
516
|
+
bullets: [
|
|
517
|
+
`Use the ${toolName} tool when users ask questions about topics that might be in the indexed documents`,
|
|
518
|
+
'Search for relevant information using clear, specific queries',
|
|
519
|
+
'Provide helpful summaries of the search results',
|
|
520
|
+
'If no results are found, suggest the user try rephrasing their question or try another knowledge source',
|
|
521
|
+
],
|
|
522
|
+
},
|
|
523
|
+
];
|
|
524
|
+
}
|
|
525
|
+
// ---------------------------------------------------------------------------
|
|
526
|
+
// Search
|
|
527
|
+
// ---------------------------------------------------------------------------
|
|
528
|
+
async _searchHandler(args, _rawData) {
|
|
529
|
+
if (!this.searchAvailable && !this.useRemote) {
|
|
530
|
+
// In-memory path — we should still be usable if docs were loaded synchronously
|
|
531
|
+
// (constructor path); otherwise report unavailability.
|
|
532
|
+
if (!this._indexed || this._documents.length === 0) {
|
|
533
|
+
return new FunctionResult('No documents are loaded for searching. Configure the skill with a "documents" array or a "remote_url".');
|
|
534
|
+
}
|
|
535
|
+
}
|
|
536
|
+
const query = typeof args['query'] === 'string' ? args['query'].trim() : '';
|
|
537
|
+
if (!query) {
|
|
538
|
+
return new FunctionResult('Please provide a search query.');
|
|
539
|
+
}
|
|
540
|
+
const count = Math.max(1, Math.min(20, args['count'] ?? this.count));
|
|
541
|
+
let results = [];
|
|
542
|
+
try {
|
|
543
|
+
if (this.useRemote) {
|
|
544
|
+
results = await this._searchRemote(query, count);
|
|
545
|
+
}
|
|
546
|
+
else {
|
|
547
|
+
results = this._searchLocal(query, count);
|
|
548
|
+
}
|
|
549
|
+
}
|
|
550
|
+
catch (err) {
|
|
551
|
+
log.error('native_vector_search: search error', {
|
|
552
|
+
error: err instanceof Error ? err.message : String(err),
|
|
553
|
+
});
|
|
554
|
+
return new FunctionResult("I'm sorry, I encountered an issue while searching. Please try rephrasing your question.");
|
|
555
|
+
}
|
|
556
|
+
if (results.length === 0) {
|
|
557
|
+
let msg = this.noResultsMessage.replace('{query}', query);
|
|
558
|
+
if (this.responsePrefix)
|
|
559
|
+
msg = `${this.responsePrefix} ${msg}`;
|
|
560
|
+
if (this.responsePostfix)
|
|
561
|
+
msg = `${msg} ${this.responsePostfix}`;
|
|
562
|
+
if (typeof this.responseFormatCallback === 'function') {
|
|
563
|
+
try {
|
|
564
|
+
const formatted = this.responseFormatCallback({
|
|
565
|
+
response: msg,
|
|
566
|
+
agent: this.agent,
|
|
567
|
+
query,
|
|
568
|
+
results: [],
|
|
569
|
+
args,
|
|
570
|
+
count,
|
|
571
|
+
skill: this,
|
|
572
|
+
});
|
|
573
|
+
if (typeof formatted === 'string')
|
|
574
|
+
msg = formatted;
|
|
575
|
+
}
|
|
576
|
+
catch (err) {
|
|
577
|
+
log.error('native_vector_search: response_format_callback error (no results)', { error: err instanceof Error ? err.message : String(err) });
|
|
578
|
+
}
|
|
579
|
+
}
|
|
580
|
+
return new FunctionResult(msg);
|
|
581
|
+
}
|
|
582
|
+
// Compose formatted response with per-result truncation
|
|
583
|
+
const responseParts = [];
|
|
584
|
+
if (this.responsePrefix)
|
|
585
|
+
responseParts.push(this.responsePrefix);
|
|
586
|
+
responseParts.push(`Found ${results.length} relevant results for '${query}':\n`);
|
|
587
|
+
const estimatedOverheadPerResult = 300;
|
|
588
|
+
const prefixPostfixOverhead = this.responsePrefix.length + this.responsePostfix.length + 100;
|
|
589
|
+
const totalOverhead = results.length * estimatedOverheadPerResult + prefixPostfixOverhead;
|
|
590
|
+
const available = this.maxContentLength - totalOverhead;
|
|
591
|
+
const perResultLimit = results.length > 0
|
|
592
|
+
? Math.max(500, Math.floor(available / results.length))
|
|
593
|
+
: 1000;
|
|
594
|
+
results.forEach((r, i) => {
|
|
595
|
+
const filename = r.metadata['filename'] ?? `result-${i + 1}`;
|
|
596
|
+
const section = r.metadata['section'] ?? '';
|
|
597
|
+
const score = r.score;
|
|
598
|
+
let content = r.content;
|
|
599
|
+
if (content.length > perResultLimit) {
|
|
600
|
+
content = content.slice(0, perResultLimit) + '...';
|
|
601
|
+
}
|
|
602
|
+
const tags = r.metadata['tags'] ?? [];
|
|
603
|
+
let text = `**Result ${i + 1}** (from ${filename}`;
|
|
604
|
+
if (section)
|
|
605
|
+
text += `, section: ${section}`;
|
|
606
|
+
if (tags.length > 0)
|
|
607
|
+
text += `, tags: ${tags.join(', ')}`;
|
|
608
|
+
text += `, relevance: ${score.toFixed(2)})\n${content}\n`;
|
|
609
|
+
responseParts.push(text);
|
|
610
|
+
});
|
|
611
|
+
if (this.responsePostfix)
|
|
612
|
+
responseParts.push(this.responsePostfix);
|
|
613
|
+
let response = responseParts.join('\n');
|
|
614
|
+
if (typeof this.responseFormatCallback === 'function') {
|
|
615
|
+
try {
|
|
616
|
+
const formatted = this.responseFormatCallback({
|
|
617
|
+
response,
|
|
618
|
+
agent: this.agent,
|
|
619
|
+
query,
|
|
620
|
+
results,
|
|
621
|
+
args,
|
|
622
|
+
count,
|
|
623
|
+
skill: this,
|
|
624
|
+
});
|
|
625
|
+
if (typeof formatted === 'string') {
|
|
626
|
+
response = formatted;
|
|
627
|
+
}
|
|
628
|
+
else {
|
|
629
|
+
log.warn('native_vector_search: response_format_callback returned non-string');
|
|
630
|
+
}
|
|
631
|
+
}
|
|
632
|
+
catch (err) {
|
|
633
|
+
log.error('native_vector_search: response_format_callback error', {
|
|
634
|
+
error: err instanceof Error ? err.message : String(err),
|
|
635
|
+
});
|
|
636
|
+
}
|
|
637
|
+
}
|
|
638
|
+
return new FunctionResult(response);
|
|
639
|
+
}
|
|
640
|
+
_searchLocal(query, count) {
|
|
641
|
+
const queryTokens = tokenize(query);
|
|
642
|
+
if (queryTokens.length === 0)
|
|
643
|
+
return [];
|
|
644
|
+
// Mirrors Python search_engine.py line 449: None → 0.3.
|
|
645
|
+
const weight = this.keywordWeight ?? 0.3;
|
|
646
|
+
const scored = this._documents.map((doc, i) => {
|
|
647
|
+
const tfidf = scoreTfIdf(queryTokens, this._docTfs[i], this._idf);
|
|
648
|
+
let score;
|
|
649
|
+
if (weight > 0) {
|
|
650
|
+
// Keyword-overlap component: fraction of unique query terms present in doc.
|
|
651
|
+
// Mirrors Python: `keyword_weight=self.keyword_weight` passed to
|
|
652
|
+
// `search_engine.search()` for hybrid TF-IDF + keyword scoring.
|
|
653
|
+
const docTokenSet = new Set(this._tokenizedDocs[i]);
|
|
654
|
+
const uniqueQueryTokens = new Set(queryTokens);
|
|
655
|
+
let matches = 0;
|
|
656
|
+
for (const t of uniqueQueryTokens) {
|
|
657
|
+
if (docTokenSet.has(t))
|
|
658
|
+
matches++;
|
|
659
|
+
}
|
|
660
|
+
const keywordOverlap = uniqueQueryTokens.size > 0 ? matches / uniqueQueryTokens.size : 0;
|
|
661
|
+
score = tfidf * (1 - weight) + keywordOverlap * weight;
|
|
662
|
+
}
|
|
663
|
+
else {
|
|
664
|
+
score = tfidf;
|
|
665
|
+
}
|
|
666
|
+
return { doc, score };
|
|
667
|
+
});
|
|
668
|
+
const filtered = scored
|
|
669
|
+
.filter((s) => s.score > this.similarityThreshold)
|
|
670
|
+
.filter((s) => {
|
|
671
|
+
if (this.filterTags.length === 0)
|
|
672
|
+
return true;
|
|
673
|
+
const docTags = s.doc.tags ?? [];
|
|
674
|
+
return this.filterTags.some((t) => docTags.includes(t));
|
|
675
|
+
});
|
|
676
|
+
filtered.sort((a, b) => b.score - a.score);
|
|
677
|
+
return filtered.slice(0, count).map(({ doc, score }) => ({
|
|
678
|
+
content: doc.text,
|
|
679
|
+
score,
|
|
680
|
+
metadata: {
|
|
681
|
+
filename: doc.id,
|
|
682
|
+
...(doc.metadata ?? {}),
|
|
683
|
+
tags: doc.tags ?? [],
|
|
684
|
+
},
|
|
685
|
+
}));
|
|
686
|
+
}
|
|
687
|
+
/** Perform search against a remote search server. */
|
|
688
|
+
async _searchRemote(query, count) {
|
|
689
|
+
if (!this.remoteBaseUrl)
|
|
690
|
+
return [];
|
|
691
|
+
try {
|
|
692
|
+
const body = {
|
|
693
|
+
query,
|
|
694
|
+
index_name: this.indexName,
|
|
695
|
+
count,
|
|
696
|
+
similarity_threshold: this.similarityThreshold,
|
|
697
|
+
tags: this.filterTags,
|
|
698
|
+
};
|
|
699
|
+
const response = await this._fetchWithAuth(`${this.remoteBaseUrl}/search`, {
|
|
700
|
+
method: 'POST',
|
|
701
|
+
headers: { 'Content-Type': 'application/json' },
|
|
702
|
+
body: JSON.stringify(body),
|
|
703
|
+
});
|
|
704
|
+
if (response.status !== 200) {
|
|
705
|
+
log.error('native_vector_search: remote search failed', {
|
|
706
|
+
status: response.status,
|
|
707
|
+
});
|
|
708
|
+
return [];
|
|
709
|
+
}
|
|
710
|
+
const data = (await response.json());
|
|
711
|
+
return (data.results ?? []).map((r) => ({
|
|
712
|
+
content: r.content,
|
|
713
|
+
score: r.score,
|
|
714
|
+
metadata: r.metadata,
|
|
715
|
+
}));
|
|
716
|
+
}
|
|
717
|
+
catch (err) {
|
|
718
|
+
log.error('native_vector_search: remote search error', {
|
|
719
|
+
error: err instanceof Error ? err.message : String(err),
|
|
720
|
+
});
|
|
721
|
+
return [];
|
|
722
|
+
}
|
|
723
|
+
}
|
|
724
|
+
/** Fetch wrapper that injects Basic auth if configured. */
|
|
725
|
+
async _fetchWithAuth(url, init = {}, timeoutMs = 30_000) {
|
|
726
|
+
const headers = {
|
|
727
|
+
Accept: 'application/json',
|
|
728
|
+
...(init.headers ?? {}),
|
|
729
|
+
};
|
|
730
|
+
if (this.remoteAuth) {
|
|
731
|
+
const creds = Buffer.from(`${this.remoteAuth.user}:${this.remoteAuth.pass}`).toString('base64');
|
|
732
|
+
headers['Authorization'] = `Basic ${creds}`;
|
|
733
|
+
}
|
|
734
|
+
const controller = new AbortController();
|
|
735
|
+
const timer = setTimeout(() => controller.abort(), timeoutMs);
|
|
736
|
+
try {
|
|
737
|
+
return await fetch(url, { ...init, headers, signal: controller.signal });
|
|
738
|
+
}
|
|
739
|
+
finally {
|
|
740
|
+
clearTimeout(timer);
|
|
741
|
+
}
|
|
742
|
+
}
|
|
743
|
+
}
|
|
744
|
+
/**
|
|
745
|
+
* Factory function for creating NativeVectorSearchSkill instances.
|
|
746
|
+
* @param config - Optional skill configuration.
|
|
747
|
+
* @returns A new NativeVectorSearchSkill instance.
|
|
748
|
+
*/
|
|
749
|
+
export function createSkill(config) {
|
|
750
|
+
return new NativeVectorSearchSkill(config);
|
|
751
|
+
}
|
|
752
|
+
//# sourceMappingURL=native_vector_search.js.map
|