@mastra/mcp-docs-server 1.1.9-alpha.0 → 1.1.9-alpha.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/.docs/docs/agents/adding-voice.md +4 -4
- package/.docs/docs/agents/agent-approval.md +3 -3
- package/.docs/docs/agents/agent-memory.md +1 -1
- package/.docs/docs/agents/network-approval.md +1 -1
- package/.docs/docs/agents/networks.md +1 -1
- package/.docs/docs/agents/overview.md +1 -1
- package/.docs/docs/agents/processors.md +8 -8
- package/.docs/docs/agents/structured-output.md +1 -1
- package/.docs/docs/agents/supervisor-agents.md +3 -3
- package/.docs/docs/agents/using-tools.md +1 -1
- package/.docs/docs/build-with-ai/mcp-docs-server.md +1 -1
- package/.docs/docs/build-with-ai/skills.md +1 -1
- package/.docs/docs/community/contributing-templates.md +1 -1
- package/.docs/docs/community/discord.md +2 -2
- package/.docs/docs/community/licensing.md +1 -1
- package/.docs/docs/deployment/cloud-providers.md +2 -2
- package/.docs/docs/deployment/mastra-server.md +1 -1
- package/.docs/docs/deployment/monorepo.md +1 -1
- package/.docs/docs/deployment/overview.md +3 -3
- package/.docs/docs/deployment/studio.md +1 -1
- package/.docs/docs/deployment/web-framework.md +1 -1
- package/.docs/docs/deployment/workflow-runners.md +1 -1
- package/.docs/docs/evals/built-in-scorers.md +1 -1
- package/.docs/docs/evals/custom-scorers.md +6 -6
- package/.docs/docs/evals/overview.md +1 -1
- package/.docs/docs/evals/running-in-ci.md +6 -6
- package/.docs/docs/getting-started/build-with-ai.md +2 -2
- package/.docs/docs/getting-started/manual-install.md +1 -1
- package/.docs/docs/getting-started/project-structure.md +1 -1
- package/.docs/docs/index.md +1 -1
- package/.docs/docs/mcp/overview.md +1 -1
- package/.docs/docs/mcp/publishing-mcp-server.md +3 -3
- package/.docs/docs/memory/memory-processors.md +8 -8
- package/.docs/docs/memory/message-history.md +2 -2
- package/.docs/docs/memory/observational-memory.md +5 -5
- package/.docs/docs/memory/semantic-recall.md +7 -7
- package/.docs/docs/memory/working-memory.md +14 -14
- package/.docs/docs/observability/datasets/overview.md +1 -1
- package/.docs/docs/observability/datasets/running-experiments.md +1 -1
- package/.docs/docs/observability/logging.md +1 -1
- package/.docs/docs/observability/overview.md +5 -5
- package/.docs/docs/observability/tracing/bridges/otel.md +7 -7
- package/.docs/docs/observability/tracing/exporters/arize.md +3 -3
- package/.docs/docs/observability/tracing/exporters/braintrust.md +1 -1
- package/.docs/docs/observability/tracing/exporters/cloud.md +2 -2
- package/.docs/docs/observability/tracing/exporters/datadog.md +3 -3
- package/.docs/docs/observability/tracing/exporters/default.md +7 -7
- package/.docs/docs/observability/tracing/exporters/laminar.md +1 -1
- package/.docs/docs/observability/tracing/exporters/langfuse.md +3 -3
- package/.docs/docs/observability/tracing/exporters/langsmith.md +4 -4
- package/.docs/docs/observability/tracing/exporters/otel.md +8 -8
- package/.docs/docs/observability/tracing/exporters/posthog.md +2 -2
- package/.docs/docs/observability/tracing/exporters/sentry.md +4 -4
- package/.docs/docs/observability/tracing/overview.md +20 -20
- package/.docs/docs/observability/tracing/processors/sensitive-data-filter.md +11 -11
- package/.docs/docs/rag/chunking-and-embedding.md +4 -4
- package/.docs/docs/rag/overview.md +2 -2
- package/.docs/docs/rag/retrieval.md +4 -4
- package/.docs/docs/rag/vector-databases.md +11 -11
- package/.docs/docs/server/auth/auth0.md +1 -1
- package/.docs/docs/server/auth/clerk.md +1 -1
- package/.docs/docs/server/auth/composite-auth.md +9 -9
- package/.docs/docs/server/auth/custom-auth-provider.md +12 -12
- package/.docs/docs/server/auth/firebase.md +2 -2
- package/.docs/docs/server/auth/jwt.md +1 -1
- package/.docs/docs/server/auth/simple-auth.md +8 -8
- package/.docs/docs/server/auth/supabase.md +1 -1
- package/.docs/docs/server/auth/workos.md +1 -1
- package/.docs/docs/server/auth.md +1 -1
- package/.docs/docs/server/custom-adapters.md +7 -7
- package/.docs/docs/server/custom-api-routes.md +2 -2
- package/.docs/docs/server/mastra-client.md +1 -1
- package/.docs/docs/server/mastra-server.md +1 -1
- package/.docs/docs/server/request-context.md +2 -2
- package/.docs/docs/server/server-adapters.md +1 -1
- package/.docs/docs/streaming/events.md +1 -1
- package/.docs/docs/streaming/overview.md +1 -1
- package/.docs/docs/streaming/tool-streaming.md +2 -2
- package/.docs/docs/voice/overview.md +3 -3
- package/.docs/docs/voice/speech-to-speech.md +1 -1
- package/.docs/docs/voice/speech-to-text.md +2 -2
- package/.docs/docs/voice/text-to-speech.md +2 -2
- package/.docs/docs/workflows/agents-and-tools.md +1 -1
- package/.docs/docs/workflows/control-flow.md +1 -1
- package/.docs/docs/workflows/error-handling.md +3 -3
- package/.docs/docs/workflows/suspend-and-resume.md +1 -1
- package/.docs/docs/workflows/time-travel.md +1 -1
- package/.docs/docs/workflows/workflow-state.md +1 -1
- package/.docs/docs/workspace/filesystem.md +1 -1
- package/.docs/docs/workspace/overview.md +1 -1
- package/.docs/docs/workspace/search.md +1 -1
- package/.docs/docs/workspace/skills.md +2 -2
- package/.docs/guides/build-your-ui/ai-sdk-ui.md +2 -2
- package/.docs/guides/build-your-ui/assistant-ui.md +1 -1
- package/.docs/guides/build-your-ui/copilotkit.md +1 -1
- package/.docs/guides/deployment/digital-ocean.md +1 -1
- package/.docs/guides/getting-started/astro.md +1 -1
- package/.docs/guides/getting-started/electron.md +1 -1
- package/.docs/guides/getting-started/next-js.md +1 -1
- package/.docs/guides/getting-started/vite-react.md +1 -1
- package/.docs/guides/guide/ai-recruiter.md +3 -3
- package/.docs/guides/guide/chef-michel.md +4 -4
- package/.docs/guides/guide/code-review-bot.md +3 -3
- package/.docs/guides/guide/dev-assistant.md +5 -5
- package/.docs/guides/guide/docs-manager.md +3 -3
- package/.docs/guides/guide/github-actions-pr-description.md +2 -2
- package/.docs/guides/guide/notes-mcp-server.md +3 -3
- package/.docs/guides/guide/research-assistant.md +4 -4
- package/.docs/guides/guide/research-coordinator.md +1 -1
- package/.docs/guides/guide/stock-agent.md +4 -4
- package/.docs/guides/guide/web-search.md +2 -2
- package/.docs/guides/guide/whatsapp-chat-bot.md +1 -1
- package/.docs/guides/migrations/ai-sdk-v4-to-v5.md +3 -3
- package/.docs/guides/migrations/network-to-supervisor.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/agent.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/deployment.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/evals.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/mastra.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/overview.md +3 -3
- package/.docs/guides/migrations/upgrade-to-v1/storage.md +3 -3
- package/.docs/guides/migrations/upgrade-to-v1/tracing.md +2 -2
- package/.docs/guides/migrations/upgrade-to-v1/vectors.md +3 -3
- package/.docs/guides/migrations/upgrade-to-v1/voice.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/workflows.md +1 -1
- package/.docs/guides/migrations/vnext-to-standard-apis.md +1 -1
- package/.docs/models/embeddings.md +4 -4
- package/.docs/models/gateways/custom-gateways.md +4 -4
- package/.docs/models/gateways/netlify.md +1 -1
- package/.docs/models/gateways/openrouter.md +1 -1
- package/.docs/models/gateways/vercel.md +9 -2
- package/.docs/models/gateways.md +2 -2
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/302ai.md +3 -3
- package/.docs/models/providers/abacus.md +3 -3
- package/.docs/models/providers/aihubmix.md +3 -3
- package/.docs/models/providers/alibaba-cn.md +3 -3
- package/.docs/models/providers/alibaba-coding-plan-cn.md +3 -3
- package/.docs/models/providers/alibaba-coding-plan.md +3 -3
- package/.docs/models/providers/alibaba.md +3 -3
- package/.docs/models/providers/anthropic.md +4 -4
- package/.docs/models/providers/bailing.md +3 -3
- package/.docs/models/providers/baseten.md +3 -3
- package/.docs/models/providers/berget.md +3 -3
- package/.docs/models/providers/cerebras.md +4 -4
- package/.docs/models/providers/chutes.md +6 -5
- package/.docs/models/providers/clarifai.md +3 -3
- package/.docs/models/providers/cloudferro-sherlock.md +3 -3
- package/.docs/models/providers/cloudflare-workers-ai.md +3 -3
- package/.docs/models/providers/cortecs.md +3 -3
- package/.docs/models/providers/deepinfra.md +4 -4
- package/.docs/models/providers/deepseek.md +3 -3
- package/.docs/models/providers/drun.md +3 -3
- package/.docs/models/providers/evroc.md +3 -3
- package/.docs/models/providers/fastrouter.md +3 -3
- package/.docs/models/providers/fireworks-ai.md +3 -3
- package/.docs/models/providers/firmware.md +3 -3
- package/.docs/models/providers/friendli.md +3 -3
- package/.docs/models/providers/github-models.md +3 -3
- package/.docs/models/providers/google.md +4 -4
- package/.docs/models/providers/groq.md +4 -4
- package/.docs/models/providers/helicone.md +3 -3
- package/.docs/models/providers/huggingface.md +3 -3
- package/.docs/models/providers/iflowcn.md +3 -3
- package/.docs/models/providers/inception.md +3 -3
- package/.docs/models/providers/inference.md +3 -3
- package/.docs/models/providers/io-net.md +3 -3
- package/.docs/models/providers/jiekou.md +3 -3
- package/.docs/models/providers/kilo.md +3 -3
- package/.docs/models/providers/kimi-for-coding.md +4 -4
- package/.docs/models/providers/kuae-cloud-coding-plan.md +3 -3
- package/.docs/models/providers/llama.md +3 -3
- package/.docs/models/providers/lmstudio.md +3 -3
- package/.docs/models/providers/lucidquery.md +3 -3
- package/.docs/models/providers/meganova.md +3 -3
- package/.docs/models/providers/minimax-cn-coding-plan.md +4 -4
- package/.docs/models/providers/minimax-cn.md +4 -4
- package/.docs/models/providers/minimax-coding-plan.md +4 -4
- package/.docs/models/providers/minimax.md +4 -4
- package/.docs/models/providers/mistral.md +4 -4
- package/.docs/models/providers/moark.md +3 -3
- package/.docs/models/providers/modelscope.md +3 -3
- package/.docs/models/providers/moonshotai-cn.md +3 -3
- package/.docs/models/providers/moonshotai.md +3 -3
- package/.docs/models/providers/morph.md +3 -3
- package/.docs/models/providers/nano-gpt.md +25 -23
- package/.docs/models/providers/nebius.md +3 -3
- package/.docs/models/providers/nova.md +3 -3
- package/.docs/models/providers/novita-ai.md +3 -3
- package/.docs/models/providers/nvidia.md +3 -3
- package/.docs/models/providers/ollama-cloud.md +3 -3
- package/.docs/models/providers/openai.md +4 -4
- package/.docs/models/providers/opencode-go.md +3 -3
- package/.docs/models/providers/opencode.md +3 -3
- package/.docs/models/providers/ovhcloud.md +3 -3
- package/.docs/models/providers/perplexity-agent.md +4 -4
- package/.docs/models/providers/perplexity.md +4 -4
- package/.docs/models/providers/poe.md +3 -3
- package/.docs/models/providers/privatemode-ai.md +3 -3
- package/.docs/models/providers/qihang-ai.md +3 -3
- package/.docs/models/providers/qiniu-ai.md +3 -3
- package/.docs/models/providers/requesty.md +3 -3
- package/.docs/models/providers/scaleway.md +3 -3
- package/.docs/models/providers/siliconflow-cn.md +3 -3
- package/.docs/models/providers/siliconflow.md +3 -3
- package/.docs/models/providers/stackit.md +3 -3
- package/.docs/models/providers/stepfun.md +3 -3
- package/.docs/models/providers/submodel.md +3 -3
- package/.docs/models/providers/synthetic.md +3 -3
- package/.docs/models/providers/togetherai.md +4 -4
- package/.docs/models/providers/upstage.md +3 -3
- package/.docs/models/providers/vivgrid.md +4 -4
- package/.docs/models/providers/vultr.md +3 -3
- package/.docs/models/providers/wandb.md +3 -3
- package/.docs/models/providers/xai.md +4 -4
- package/.docs/models/providers/xiaomi.md +3 -3
- package/.docs/models/providers/zai-coding-plan.md +3 -3
- package/.docs/models/providers/zai.md +3 -3
- package/.docs/models/providers/zenmux.md +4 -4
- package/.docs/models/providers/zhipuai-coding-plan.md +3 -3
- package/.docs/models/providers/zhipuai.md +3 -3
- package/.docs/reference/agents/agent.md +3 -3
- package/.docs/reference/agents/generateLegacy.md +1 -1
- package/.docs/reference/agents/network.md +2 -2
- package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +1 -1
- package/.docs/reference/auth/auth0.md +4 -4
- package/.docs/reference/auth/better-auth.md +2 -2
- package/.docs/reference/auth/clerk.md +1 -1
- package/.docs/reference/auth/firebase.md +4 -4
- package/.docs/reference/auth/jwt.md +1 -1
- package/.docs/reference/auth/supabase.md +1 -1
- package/.docs/reference/auth/workos.md +4 -4
- package/.docs/reference/cli/mastra.md +1 -1
- package/.docs/reference/client-js/agents.md +22 -22
- package/.docs/reference/client-js/error-handling.md +2 -2
- package/.docs/reference/client-js/logs.md +2 -2
- package/.docs/reference/client-js/mastra-client.md +1 -1
- package/.docs/reference/client-js/memory.md +6 -6
- package/.docs/reference/client-js/observability.md +4 -4
- package/.docs/reference/client-js/telemetry.md +1 -1
- package/.docs/reference/client-js/tools.md +3 -3
- package/.docs/reference/client-js/vectors.md +2 -2
- package/.docs/reference/client-js/workflows.md +12 -12
- package/.docs/reference/core/getGatewayById.md +1 -1
- package/.docs/reference/core/getMCPServer.md +2 -2
- package/.docs/reference/core/getMCPServerById.md +2 -2
- package/.docs/reference/core/getMemory.md +1 -1
- package/.docs/reference/core/getScorer.md +2 -2
- package/.docs/reference/core/getScorerById.md +2 -2
- package/.docs/reference/core/getStoredAgentById.md +2 -2
- package/.docs/reference/core/listMCPServers.md +2 -2
- package/.docs/reference/core/listMemory.md +1 -1
- package/.docs/reference/core/listScorers.md +1 -1
- package/.docs/reference/core/listStoredAgents.md +2 -2
- package/.docs/reference/core/mastra-class.md +1 -1
- package/.docs/reference/core/mastra-model-gateway.md +11 -11
- package/.docs/reference/datasets/dataset.md +1 -1
- package/.docs/reference/deployer.md +4 -4
- package/.docs/reference/evals/answer-relevancy.md +3 -3
- package/.docs/reference/evals/answer-similarity.md +3 -3
- package/.docs/reference/evals/bias.md +4 -4
- package/.docs/reference/evals/completeness.md +5 -5
- package/.docs/reference/evals/content-similarity.md +3 -3
- package/.docs/reference/evals/context-precision.md +6 -6
- package/.docs/reference/evals/context-relevance.md +6 -6
- package/.docs/reference/evals/create-scorer.md +7 -7
- package/.docs/reference/evals/faithfulness.md +3 -3
- package/.docs/reference/evals/hallucination.md +5 -5
- package/.docs/reference/evals/keyword-coverage.md +3 -3
- package/.docs/reference/evals/mastra-scorer.md +6 -6
- package/.docs/reference/evals/noise-sensitivity.md +9 -9
- package/.docs/reference/evals/prompt-alignment.md +5 -5
- package/.docs/reference/evals/run-evals.md +5 -5
- package/.docs/reference/evals/scorer-utils.md +17 -17
- package/.docs/reference/evals/textual-difference.md +3 -3
- package/.docs/reference/evals/tone-consistency.md +4 -4
- package/.docs/reference/evals/tool-call-accuracy.md +9 -9
- package/.docs/reference/evals/toxicity.md +3 -3
- package/.docs/reference/harness/harness-class.md +1 -1
- package/.docs/reference/memory/clone-utilities.md +7 -7
- package/.docs/reference/memory/cloneThread.md +4 -4
- package/.docs/reference/memory/createThread.md +1 -1
- package/.docs/reference/memory/deleteMessages.md +1 -1
- package/.docs/reference/memory/getThreadById.md +1 -1
- package/.docs/reference/memory/listThreads.md +3 -3
- package/.docs/reference/memory/memory-class.md +1 -1
- package/.docs/reference/memory/observational-memory.md +1 -1
- package/.docs/reference/memory/recall.md +1 -1
- package/.docs/reference/observability/tracing/bridges/otel.md +5 -5
- package/.docs/reference/observability/tracing/configuration.md +17 -17
- package/.docs/reference/observability/tracing/exporters/arize.md +4 -4
- package/.docs/reference/observability/tracing/exporters/braintrust.md +3 -3
- package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +6 -6
- package/.docs/reference/observability/tracing/exporters/console-exporter.md +4 -4
- package/.docs/reference/observability/tracing/exporters/datadog.md +4 -4
- package/.docs/reference/observability/tracing/exporters/default-exporter.md +6 -6
- package/.docs/reference/observability/tracing/exporters/laminar.md +2 -2
- package/.docs/reference/observability/tracing/exporters/langfuse.md +4 -4
- package/.docs/reference/observability/tracing/exporters/langsmith.md +6 -6
- package/.docs/reference/observability/tracing/exporters/otel.md +12 -12
- package/.docs/reference/observability/tracing/exporters/posthog.md +3 -3
- package/.docs/reference/observability/tracing/exporters/sentry.md +5 -5
- package/.docs/reference/observability/tracing/instances.md +9 -9
- package/.docs/reference/observability/tracing/interfaces.md +39 -39
- package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md +5 -5
- package/.docs/reference/observability/tracing/spans.md +13 -13
- package/.docs/reference/processors/processor-interface.md +15 -15
- package/.docs/reference/rag/chunk.md +2 -2
- package/.docs/reference/rag/database-config.md +8 -8
- package/.docs/reference/rag/document.md +11 -11
- package/.docs/reference/rag/embeddings.md +5 -5
- package/.docs/reference/rag/extract-params.md +8 -8
- package/.docs/reference/rag/graph-rag.md +4 -4
- package/.docs/reference/rag/metadata-filters.md +5 -5
- package/.docs/reference/rag/rerank.md +2 -2
- package/.docs/reference/rag/rerankWithScorer.md +2 -2
- package/.docs/reference/server/express-adapter.md +1 -1
- package/.docs/reference/server/fastify-adapter.md +1 -1
- package/.docs/reference/server/hono-adapter.md +1 -1
- package/.docs/reference/server/koa-adapter.md +1 -1
- package/.docs/reference/server/mastra-server.md +16 -16
- package/.docs/reference/server/register-api-route.md +5 -5
- package/.docs/reference/server/routes.md +1 -1
- package/.docs/reference/storage/cloudflare-d1.md +2 -2
- package/.docs/reference/storage/cloudflare.md +2 -2
- package/.docs/reference/storage/composite.md +1 -1
- package/.docs/reference/storage/convex.md +5 -5
- package/.docs/reference/storage/dynamodb.md +5 -5
- package/.docs/reference/storage/lance.md +3 -3
- package/.docs/reference/storage/libsql.md +1 -1
- package/.docs/reference/storage/mongodb.md +5 -5
- package/.docs/reference/storage/mssql.md +3 -3
- package/.docs/reference/storage/overview.md +2 -2
- package/.docs/reference/storage/postgresql.md +5 -5
- package/.docs/reference/storage/upstash.md +3 -3
- package/.docs/reference/streaming/ChunkType.md +13 -13
- package/.docs/reference/streaming/agents/MastraModelOutput.md +6 -6
- package/.docs/reference/streaming/agents/stream.md +2 -2
- package/.docs/reference/streaming/agents/streamLegacy.md +1 -1
- package/.docs/reference/streaming/workflows/observeStream.md +1 -1
- package/.docs/reference/streaming/workflows/resumeStream.md +1 -1
- package/.docs/reference/streaming/workflows/stream.md +1 -1
- package/.docs/reference/templates/overview.md +3 -3
- package/.docs/reference/tools/create-tool.md +9 -9
- package/.docs/reference/tools/document-chunker-tool.md +4 -4
- package/.docs/reference/tools/graph-rag-tool.md +7 -7
- package/.docs/reference/tools/mcp-client.md +13 -13
- package/.docs/reference/tools/mcp-server.md +23 -23
- package/.docs/reference/tools/vector-query-tool.md +12 -12
- package/.docs/reference/vectors/astra.md +13 -13
- package/.docs/reference/vectors/chroma.md +16 -16
- package/.docs/reference/vectors/convex.md +15 -15
- package/.docs/reference/vectors/couchbase.md +15 -15
- package/.docs/reference/vectors/duckdb.md +17 -17
- package/.docs/reference/vectors/elasticsearch.md +14 -14
- package/.docs/reference/vectors/lance.md +22 -22
- package/.docs/reference/vectors/libsql.md +15 -15
- package/.docs/reference/vectors/mongodb.md +18 -18
- package/.docs/reference/vectors/opensearch.md +11 -11
- package/.docs/reference/vectors/pg.md +21 -21
- package/.docs/reference/vectors/pinecone.md +15 -15
- package/.docs/reference/vectors/qdrant.md +15 -15
- package/.docs/reference/vectors/s3vectors.md +17 -17
- package/.docs/reference/vectors/turbopuffer.md +14 -14
- package/.docs/reference/vectors/upstash.md +15 -15
- package/.docs/reference/vectors/vectorize.md +16 -16
- package/.docs/reference/voice/azure.md +8 -8
- package/.docs/reference/voice/cloudflare.md +5 -5
- package/.docs/reference/voice/composite-voice.md +5 -5
- package/.docs/reference/voice/deepgram.md +5 -5
- package/.docs/reference/voice/elevenlabs.md +6 -6
- package/.docs/reference/voice/google-gemini-live.md +20 -20
- package/.docs/reference/voice/google.md +9 -9
- package/.docs/reference/voice/mastra-voice.md +17 -17
- package/.docs/reference/voice/murf.md +6 -6
- package/.docs/reference/voice/openai-realtime.md +16 -16
- package/.docs/reference/voice/openai.md +5 -5
- package/.docs/reference/voice/playai.md +5 -5
- package/.docs/reference/voice/sarvam.md +5 -5
- package/.docs/reference/voice/speechify.md +5 -5
- package/.docs/reference/voice/voice.addInstructions.md +2 -2
- package/.docs/reference/voice/voice.addTools.md +2 -2
- package/.docs/reference/voice/voice.answer.md +2 -2
- package/.docs/reference/voice/voice.close.md +2 -2
- package/.docs/reference/voice/voice.connect.md +5 -5
- package/.docs/reference/voice/voice.events.md +2 -2
- package/.docs/reference/voice/voice.getSpeakers.md +3 -3
- package/.docs/reference/voice/voice.listen.md +6 -6
- package/.docs/reference/voice/voice.off.md +2 -2
- package/.docs/reference/voice/voice.on.md +3 -3
- package/.docs/reference/voice/voice.send.md +2 -2
- package/.docs/reference/voice/voice.speak.md +5 -5
- package/.docs/reference/voice/voice.updateConfig.md +3 -3
- package/.docs/reference/workflows/run-methods/startAsync.md +1 -1
- package/.docs/reference/workflows/run.md +3 -3
- package/.docs/reference/workflows/step.md +2 -2
- package/.docs/reference/workflows/workflow-methods/create-run.md +1 -1
- package/.docs/reference/workflows/workflow.md +1 -1
- package/.docs/reference/workspace/daytona-sandbox.md +2 -2
- package/.docs/reference/workspace/e2b-sandbox.md +2 -2
- package/.docs/reference/workspace/filesystem.md +1 -1
- package/.docs/reference/workspace/gcs-filesystem.md +1 -1
- package/.docs/reference/workspace/local-filesystem.md +1 -1
- package/.docs/reference/workspace/local-sandbox.md +4 -4
- package/.docs/reference/workspace/process-manager.md +2 -2
- package/.docs/reference/workspace/s3-filesystem.md +1 -1
- package/.docs/reference/workspace/workspace-class.md +2 -2
- package/CHANGELOG.md +14 -0
- package/package.json +4 -4
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Elasticsearch vector store
|
|
2
2
|
|
|
3
|
-
The ElasticSearchVector class provides vector search using [
|
|
3
|
+
The `ElasticSearchVector` class provides vector search using [Elasticsearch](https://www.elastic.co/elasticsearch/) with its `dense_vector` field type and k-NN search capabilities. It's part of the `@mastra/elasticsearch` package.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
@@ -65,15 +65,15 @@ const results = await store.query({
|
|
|
65
65
|
});
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
## Constructor
|
|
68
|
+
## Constructor options
|
|
69
69
|
|
|
70
70
|
**id** (`string`): Unique identifier for this vector store instance
|
|
71
71
|
|
|
72
|
-
**url** (`string`):
|
|
72
|
+
**url** (`string`): Elasticsearch connection URL (e.g., 'http\://localhost:9200')
|
|
73
73
|
|
|
74
74
|
## Methods
|
|
75
75
|
|
|
76
|
-
### createIndex()
|
|
76
|
+
### `createIndex()`
|
|
77
77
|
|
|
78
78
|
Creates a new index with the specified configuration.
|
|
79
79
|
|
|
@@ -83,7 +83,7 @@ Creates a new index with the specified configuration.
|
|
|
83
83
|
|
|
84
84
|
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
85
85
|
|
|
86
|
-
### upsert()
|
|
86
|
+
### `upsert()`
|
|
87
87
|
|
|
88
88
|
Adds or updates vectors and their metadata in the index.
|
|
89
89
|
|
|
@@ -95,7 +95,7 @@ Adds or updates vectors and their metadata in the index.
|
|
|
95
95
|
|
|
96
96
|
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
97
97
|
|
|
98
|
-
### query()
|
|
98
|
+
### `query()`
|
|
99
99
|
|
|
100
100
|
Searches for similar vectors with optional metadata filtering.
|
|
101
101
|
|
|
@@ -109,7 +109,7 @@ Searches for similar vectors with optional metadata filtering.
|
|
|
109
109
|
|
|
110
110
|
**includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
|
|
111
111
|
|
|
112
|
-
### describeIndex()
|
|
112
|
+
### `describeIndex()`
|
|
113
113
|
|
|
114
114
|
Gets information about an index.
|
|
115
115
|
|
|
@@ -125,19 +125,19 @@ interface IndexStats {
|
|
|
125
125
|
}
|
|
126
126
|
```
|
|
127
127
|
|
|
128
|
-
### deleteIndex()
|
|
128
|
+
### `deleteIndex()`
|
|
129
129
|
|
|
130
130
|
Deletes an index and all its data.
|
|
131
131
|
|
|
132
132
|
**indexName** (`string`): Name of the index to delete
|
|
133
133
|
|
|
134
|
-
### listIndexes()
|
|
134
|
+
### `listIndexes()`
|
|
135
135
|
|
|
136
136
|
Lists all vector indexes.
|
|
137
137
|
|
|
138
138
|
Returns: `Promise<string[]>`
|
|
139
139
|
|
|
140
|
-
### updateVector()
|
|
140
|
+
### `updateVector()`
|
|
141
141
|
|
|
142
142
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
143
143
|
|
|
@@ -153,7 +153,7 @@ Update a single vector by ID or by metadata filter. Either `id` or `filter` must
|
|
|
153
153
|
|
|
154
154
|
**update.metadata** (`Record<string, any>`): New metadata
|
|
155
155
|
|
|
156
|
-
### deleteVector()
|
|
156
|
+
### `deleteVector()`
|
|
157
157
|
|
|
158
158
|
Deletes a single vector by its ID.
|
|
159
159
|
|
|
@@ -161,7 +161,7 @@ Deletes a single vector by its ID.
|
|
|
161
161
|
|
|
162
162
|
**id** (`string`): ID of the vector to delete
|
|
163
163
|
|
|
164
|
-
### deleteVectors()
|
|
164
|
+
### `deleteVectors()`
|
|
165
165
|
|
|
166
166
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
167
167
|
|
|
@@ -171,7 +171,7 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
|
|
|
171
171
|
|
|
172
172
|
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
173
173
|
|
|
174
|
-
## Response
|
|
174
|
+
## Response types
|
|
175
175
|
|
|
176
176
|
Query results are returned in this format:
|
|
177
177
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# Lance
|
|
1
|
+
# Lance vector store
|
|
2
2
|
|
|
3
3
|
The LanceVectorStore class provides vector search using [LanceDB](https://lancedb.github.io/lancedb/), an embedded vector database built on the Lance columnar format. It offers efficient storage and fast similarity search for both local development and production deployments.
|
|
4
4
|
|
|
5
|
-
## Factory
|
|
5
|
+
## Factory method
|
|
6
6
|
|
|
7
7
|
The LanceVectorStore uses a factory pattern for creation. You should use the static `create()` method rather than the constructor directly.
|
|
8
8
|
|
|
@@ -10,7 +10,7 @@ The LanceVectorStore uses a factory pattern for creation. You should use the sta
|
|
|
10
10
|
|
|
11
11
|
**options** (`ConnectionOptions`): Additional connection options for LanceDB
|
|
12
12
|
|
|
13
|
-
## Constructor
|
|
13
|
+
## Constructor examples
|
|
14
14
|
|
|
15
15
|
You can create a `LanceVectorStore` instance using the static create method:
|
|
16
16
|
|
|
@@ -31,7 +31,7 @@ const s3Store = await LanceVectorStore.create('s3://bucket/db', {
|
|
|
31
31
|
|
|
32
32
|
## Methods
|
|
33
33
|
|
|
34
|
-
### createIndex()
|
|
34
|
+
### `createIndex()`
|
|
35
35
|
|
|
36
36
|
**tableName** (`string`): Name of the table to create index in
|
|
37
37
|
|
|
@@ -43,7 +43,7 @@ const s3Store = await LanceVectorStore.create('s3://bucket/db', {
|
|
|
43
43
|
|
|
44
44
|
**indexConfig** (`LanceIndexConfig`): Index configuration (Default: `{ type: 'hnsw' }`)
|
|
45
45
|
|
|
46
|
-
#### LanceIndexConfig
|
|
46
|
+
#### `LanceIndexConfig`
|
|
47
47
|
|
|
48
48
|
**type** (`'ivfflat' | 'hnsw'`): Index type (Default: `hnsw`)
|
|
49
49
|
|
|
@@ -61,7 +61,7 @@ const s3Store = await LanceVectorStore.create('s3://bucket/db', {
|
|
|
61
61
|
|
|
62
62
|
**hnsw\.efConstruction** (`number`): Build-time complexity (default: 100)
|
|
63
63
|
|
|
64
|
-
### createTable()
|
|
64
|
+
### `createTable()`
|
|
65
65
|
|
|
66
66
|
**tableName** (`string`): Name of the table to create
|
|
67
67
|
|
|
@@ -69,7 +69,7 @@ const s3Store = await LanceVectorStore.create('s3://bucket/db', {
|
|
|
69
69
|
|
|
70
70
|
**options** (`Partial<CreateTableOptions>`): Additional table creation options
|
|
71
71
|
|
|
72
|
-
### upsert()
|
|
72
|
+
### `upsert()`
|
|
73
73
|
|
|
74
74
|
**tableName** (`string`): Name of the table to upsert vectors into
|
|
75
75
|
|
|
@@ -79,7 +79,7 @@ const s3Store = await LanceVectorStore.create('s3://bucket/db', {
|
|
|
79
79
|
|
|
80
80
|
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
81
81
|
|
|
82
|
-
### query()
|
|
82
|
+
### `query()`
|
|
83
83
|
|
|
84
84
|
**tableName** (`string`): Name of the table to query
|
|
85
85
|
|
|
@@ -95,7 +95,7 @@ const s3Store = await LanceVectorStore.create('s3://bucket/db', {
|
|
|
95
95
|
|
|
96
96
|
**includeAllColumns** (`boolean`): Whether to include all columns in the result (Default: `false`)
|
|
97
97
|
|
|
98
|
-
### listTables()
|
|
98
|
+
### `listTables()`
|
|
99
99
|
|
|
100
100
|
Returns an array of table names as strings.
|
|
101
101
|
|
|
@@ -104,25 +104,25 @@ const tables = await vectorStore.listTables()
|
|
|
104
104
|
// ['my_vectors', 'embeddings', 'documents']
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
### getTableSchema()
|
|
107
|
+
### `getTableSchema()`
|
|
108
108
|
|
|
109
109
|
**tableName** (`string`): Name of the table to describe
|
|
110
110
|
|
|
111
111
|
Returns the schema of the specified table.
|
|
112
112
|
|
|
113
|
-
### deleteTable()
|
|
113
|
+
### `deleteTable()`
|
|
114
114
|
|
|
115
115
|
**tableName** (`string`): Name of the table to delete
|
|
116
116
|
|
|
117
|
-
### deleteAllTables()
|
|
117
|
+
### `deleteAllTables()`
|
|
118
118
|
|
|
119
119
|
Deletes all tables in the database.
|
|
120
120
|
|
|
121
|
-
### listIndexes()
|
|
121
|
+
### `listIndexes()`
|
|
122
122
|
|
|
123
123
|
Returns an array of index names as strings.
|
|
124
124
|
|
|
125
|
-
### describeIndex()
|
|
125
|
+
### `describeIndex()`
|
|
126
126
|
|
|
127
127
|
**indexName** (`string`): Name of the index to describe
|
|
128
128
|
|
|
@@ -143,11 +143,11 @@ interface IndexStats {
|
|
|
143
143
|
}
|
|
144
144
|
```
|
|
145
145
|
|
|
146
|
-
### deleteIndex()
|
|
146
|
+
### `deleteIndex()`
|
|
147
147
|
|
|
148
148
|
**indexName** (`string`): Name of the index to delete
|
|
149
149
|
|
|
150
|
-
### updateVector()
|
|
150
|
+
### `updateVector()`
|
|
151
151
|
|
|
152
152
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
153
153
|
|
|
@@ -159,13 +159,13 @@ Update a single vector by ID or by metadata filter. Either `id` or `filter` must
|
|
|
159
159
|
|
|
160
160
|
**update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
|
|
161
161
|
|
|
162
|
-
### deleteVector()
|
|
162
|
+
### `deleteVector()`
|
|
163
163
|
|
|
164
164
|
**indexName** (`string`): Name of the index containing the vector
|
|
165
165
|
|
|
166
166
|
**id** (`string`): ID of the vector to delete
|
|
167
167
|
|
|
168
|
-
### deleteVectors()
|
|
168
|
+
### `deleteVectors()`
|
|
169
169
|
|
|
170
170
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
171
171
|
|
|
@@ -175,11 +175,11 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
|
|
|
175
175
|
|
|
176
176
|
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
177
177
|
|
|
178
|
-
### close()
|
|
178
|
+
### `close()`
|
|
179
179
|
|
|
180
180
|
Closes the database connection.
|
|
181
181
|
|
|
182
|
-
## Response
|
|
182
|
+
## Response types
|
|
183
183
|
|
|
184
184
|
Query results are returned in this format:
|
|
185
185
|
|
|
@@ -193,7 +193,7 @@ interface QueryResult {
|
|
|
193
193
|
}
|
|
194
194
|
```
|
|
195
195
|
|
|
196
|
-
## Error
|
|
196
|
+
## Error handling
|
|
197
197
|
|
|
198
198
|
The store throws typed errors that can be caught:
|
|
199
199
|
|
|
@@ -210,7 +210,7 @@ try {
|
|
|
210
210
|
}
|
|
211
211
|
```
|
|
212
212
|
|
|
213
|
-
## Best
|
|
213
|
+
## Best practices
|
|
214
214
|
|
|
215
215
|
- Use the appropriate index type for your use case:
|
|
216
216
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# libSQL
|
|
1
|
+
# libSQL vector store
|
|
2
2
|
|
|
3
3
|
The libSQL storage implementation provides a SQLite-compatible vector search [libSQL](https://github.com/tursodatabase/libsql), a fork of SQLite with vector extensions, and [Turso](https://turso.tech/) with vector extensions, offering a lightweight and efficient vector database solution. It's part of the `@mastra/libsql` package and offers efficient vector similarity search with metadata filtering.
|
|
4
4
|
|
|
@@ -69,7 +69,7 @@ const results = await store.query({
|
|
|
69
69
|
});
|
|
70
70
|
```
|
|
71
71
|
|
|
72
|
-
## Constructor
|
|
72
|
+
## Constructor options
|
|
73
73
|
|
|
74
74
|
**url** (`string`): libSQL database URL. Use ':memory:' for in-memory database, 'file:dbname.db' for local file, or a libSQL-compatible connection string like 'libsql://your-database.turso.io'.
|
|
75
75
|
|
|
@@ -81,7 +81,7 @@ const results = await store.query({
|
|
|
81
81
|
|
|
82
82
|
## Methods
|
|
83
83
|
|
|
84
|
-
### createIndex()
|
|
84
|
+
### `createIndex()`
|
|
85
85
|
|
|
86
86
|
Creates a new vector collection. The index name must start with a letter or underscore and can only contain letters, numbers, and underscores. The dimension must be a positive integer.
|
|
87
87
|
|
|
@@ -91,7 +91,7 @@ Creates a new vector collection. The index name must start with a letter or unde
|
|
|
91
91
|
|
|
92
92
|
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search. Note: Currently only cosine similarity is supported by libSQL. (Default: `cosine`)
|
|
93
93
|
|
|
94
|
-
### upsert()
|
|
94
|
+
### `upsert()`
|
|
95
95
|
|
|
96
96
|
Adds or updates vectors and their metadata in the index. Uses a transaction to ensure all vectors are inserted atomically - if any insert fails, the entire operation is rolled back.
|
|
97
97
|
|
|
@@ -103,7 +103,7 @@ Adds or updates vectors and their metadata in the index. Uses a transaction to e
|
|
|
103
103
|
|
|
104
104
|
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
105
105
|
|
|
106
|
-
### query()
|
|
106
|
+
### `query()`
|
|
107
107
|
|
|
108
108
|
Searches for similar vectors with optional metadata filtering.
|
|
109
109
|
|
|
@@ -119,7 +119,7 @@ Searches for similar vectors with optional metadata filtering.
|
|
|
119
119
|
|
|
120
120
|
**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
|
|
121
121
|
|
|
122
|
-
### describeIndex()
|
|
122
|
+
### `describeIndex()`
|
|
123
123
|
|
|
124
124
|
Gets information about an index.
|
|
125
125
|
|
|
@@ -135,25 +135,25 @@ interface IndexStats {
|
|
|
135
135
|
}
|
|
136
136
|
```
|
|
137
137
|
|
|
138
|
-
### deleteIndex()
|
|
138
|
+
### `deleteIndex()`
|
|
139
139
|
|
|
140
140
|
Deletes an index and all its data.
|
|
141
141
|
|
|
142
142
|
**indexName** (`string`): Name of the index to delete
|
|
143
143
|
|
|
144
|
-
### listIndexes()
|
|
144
|
+
### `listIndexes()`
|
|
145
145
|
|
|
146
146
|
Lists all vector indexes in the database.
|
|
147
147
|
|
|
148
148
|
Returns: `Promise<string[]>`
|
|
149
149
|
|
|
150
|
-
### truncateIndex()
|
|
150
|
+
### `truncateIndex()`
|
|
151
151
|
|
|
152
152
|
Removes all vectors from an index while keeping the index structure.
|
|
153
153
|
|
|
154
154
|
**indexName** (`string`): Name of the index to truncate
|
|
155
155
|
|
|
156
|
-
### updateVector()
|
|
156
|
+
### `updateVector()`
|
|
157
157
|
|
|
158
158
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
159
159
|
|
|
@@ -169,7 +169,7 @@ Update a single vector by ID or by metadata filter. Either `id` or `filter` must
|
|
|
169
169
|
|
|
170
170
|
**update.metadata** (`Record<string, any>`): New metadata to update
|
|
171
171
|
|
|
172
|
-
### deleteVector()
|
|
172
|
+
### `deleteVector()`
|
|
173
173
|
|
|
174
174
|
Deletes a specific vector entry from an index by its ID.
|
|
175
175
|
|
|
@@ -177,7 +177,7 @@ Deletes a specific vector entry from an index by its ID.
|
|
|
177
177
|
|
|
178
178
|
**id** (`string`): ID of the vector entry to delete
|
|
179
179
|
|
|
180
|
-
### deleteVectors()
|
|
180
|
+
### `deleteVectors()`
|
|
181
181
|
|
|
182
182
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
183
183
|
|
|
@@ -187,7 +187,7 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
|
|
|
187
187
|
|
|
188
188
|
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
189
189
|
|
|
190
|
-
## Response
|
|
190
|
+
## Response types
|
|
191
191
|
|
|
192
192
|
Query results are returned in this format:
|
|
193
193
|
|
|
@@ -200,7 +200,7 @@ interface QueryResult {
|
|
|
200
200
|
}
|
|
201
201
|
```
|
|
202
202
|
|
|
203
|
-
## Error
|
|
203
|
+
## Error handling
|
|
204
204
|
|
|
205
205
|
The store throws specific errors for different failure cases:
|
|
206
206
|
|
|
@@ -232,7 +232,7 @@ Common error cases include:
|
|
|
232
232
|
- Database connection issues
|
|
233
233
|
- Transaction failures during upsert
|
|
234
234
|
|
|
235
|
-
## Usage
|
|
235
|
+
## Usage example
|
|
236
236
|
|
|
237
237
|
### Local embeddings with fastembed
|
|
238
238
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# MongoDB
|
|
1
|
+
# MongoDB vector store
|
|
2
2
|
|
|
3
3
|
The `MongoDBVector` class provides vector search using [MongoDB Atlas Vector Search](https://www.mongodb.com/docs/atlas/atlas-vector-search/). It enables efficient similarity search and metadata filtering within your MongoDB collections.
|
|
4
4
|
|
|
@@ -28,7 +28,7 @@ yarn add @mastra/mongodb@latest
|
|
|
28
28
|
bun add @mastra/mongodb@latest
|
|
29
29
|
```
|
|
30
30
|
|
|
31
|
-
## Usage
|
|
31
|
+
## Usage example
|
|
32
32
|
|
|
33
33
|
```typescript
|
|
34
34
|
import { MongoDBVector } from '@mastra/mongodb'
|
|
@@ -55,7 +55,7 @@ const store = new MongoDBVector({
|
|
|
55
55
|
})
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
## Constructor
|
|
58
|
+
## Constructor options
|
|
59
59
|
|
|
60
60
|
**id** (`string`): Unique identifier for this vector store instance
|
|
61
61
|
|
|
@@ -69,7 +69,7 @@ const store = new MongoDBVector({
|
|
|
69
69
|
|
|
70
70
|
## Methods
|
|
71
71
|
|
|
72
|
-
### createIndex()
|
|
72
|
+
### `createIndex()`
|
|
73
73
|
|
|
74
74
|
Creates a new vector index (collection) in MongoDB.
|
|
75
75
|
|
|
@@ -79,7 +79,7 @@ Creates a new vector index (collection) in MongoDB.
|
|
|
79
79
|
|
|
80
80
|
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
81
81
|
|
|
82
|
-
### upsert()
|
|
82
|
+
### `upsert()`
|
|
83
83
|
|
|
84
84
|
Adds or updates vectors and their metadata in the collection.
|
|
85
85
|
|
|
@@ -91,7 +91,7 @@ Adds or updates vectors and their metadata in the collection.
|
|
|
91
91
|
|
|
92
92
|
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
93
93
|
|
|
94
|
-
### query()
|
|
94
|
+
### `query()`
|
|
95
95
|
|
|
96
96
|
Searches for similar vectors with optional metadata filtering.
|
|
97
97
|
|
|
@@ -109,7 +109,7 @@ Searches for similar vectors with optional metadata filtering.
|
|
|
109
109
|
|
|
110
110
|
**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
|
|
111
111
|
|
|
112
|
-
### describeIndex()
|
|
112
|
+
### `describeIndex()`
|
|
113
113
|
|
|
114
114
|
Returns information about the index (collection).
|
|
115
115
|
|
|
@@ -125,19 +125,19 @@ interface IndexStats {
|
|
|
125
125
|
}
|
|
126
126
|
```
|
|
127
127
|
|
|
128
|
-
### deleteIndex()
|
|
128
|
+
### `deleteIndex()`
|
|
129
129
|
|
|
130
130
|
Deletes a collection and all its data.
|
|
131
131
|
|
|
132
132
|
**indexName** (`string`): Name of the collection to delete
|
|
133
133
|
|
|
134
|
-
### listIndexes()
|
|
134
|
+
### `listIndexes()`
|
|
135
135
|
|
|
136
136
|
Lists all vector collections in the MongoDB database.
|
|
137
137
|
|
|
138
138
|
Returns: `Promise<string[]>`
|
|
139
139
|
|
|
140
|
-
### updateVector()
|
|
140
|
+
### `updateVector()`
|
|
141
141
|
|
|
142
142
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
143
143
|
|
|
@@ -153,7 +153,7 @@ Update a single vector by ID or by metadata filter. Either `id` or `filter` must
|
|
|
153
153
|
|
|
154
154
|
**update.metadata** (`Record<string, any>`): New metadata to update
|
|
155
155
|
|
|
156
|
-
### deleteVector()
|
|
156
|
+
### `deleteVector()`
|
|
157
157
|
|
|
158
158
|
Deletes a specific vector entry from an index by its ID.
|
|
159
159
|
|
|
@@ -161,7 +161,7 @@ Deletes a specific vector entry from an index by its ID.
|
|
|
161
161
|
|
|
162
162
|
**id** (`string`): ID of the vector entry to delete
|
|
163
163
|
|
|
164
|
-
### deleteVectors()
|
|
164
|
+
### `deleteVectors()`
|
|
165
165
|
|
|
166
166
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
167
167
|
|
|
@@ -171,11 +171,11 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
|
|
|
171
171
|
|
|
172
172
|
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
173
173
|
|
|
174
|
-
### disconnect()
|
|
174
|
+
### `disconnect()`
|
|
175
175
|
|
|
176
176
|
Closes the MongoDB client connection. Should be called when done using the store.
|
|
177
177
|
|
|
178
|
-
## Response
|
|
178
|
+
## Response types
|
|
179
179
|
|
|
180
180
|
Query results are returned in this format:
|
|
181
181
|
|
|
@@ -188,7 +188,7 @@ interface QueryResult {
|
|
|
188
188
|
}
|
|
189
189
|
```
|
|
190
190
|
|
|
191
|
-
## Error
|
|
191
|
+
## Error handling
|
|
192
192
|
|
|
193
193
|
The store throws typed errors that can be caught:
|
|
194
194
|
|
|
@@ -212,15 +212,15 @@ try {
|
|
|
212
212
|
}
|
|
213
213
|
```
|
|
214
214
|
|
|
215
|
-
## Best
|
|
215
|
+
## Best practices
|
|
216
216
|
|
|
217
217
|
- Index metadata fields used in filters for optimal query performance.
|
|
218
218
|
- Use consistent field naming in metadata to avoid unexpected query results.
|
|
219
219
|
- Regularly monitor index and collection statistics to ensure efficient search.
|
|
220
220
|
|
|
221
|
-
## Usage
|
|
221
|
+
## Usage example
|
|
222
222
|
|
|
223
|
-
### Vector embeddings with MongoDB
|
|
223
|
+
### Vector embeddings with `MongoDB`
|
|
224
224
|
|
|
225
225
|
Embeddings are numeric vectors used by memory's `semanticRecall` to retrieve related messages by meaning (not keywords).
|
|
226
226
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# OpenSearch
|
|
1
|
+
# OpenSearch vector store
|
|
2
2
|
|
|
3
3
|
The OpenSearchVector class provides vector search using [OpenSearch](https://opensearch.org/), an open-source search and analytics engine. It uses OpenSearch's k-NN capabilities to perform vector similarity search.
|
|
4
4
|
|
|
5
|
-
## Constructor
|
|
5
|
+
## Constructor options
|
|
6
6
|
|
|
7
7
|
The constructor accepts all [OpenSearch ClientOptions](https://opensearch.org/docs/latest/clients/javascript/index/) plus a required `id` field.
|
|
8
8
|
|
|
@@ -18,7 +18,7 @@ The constructor accepts all [OpenSearch ClientOptions](https://opensearch.org/do
|
|
|
18
18
|
|
|
19
19
|
## Methods
|
|
20
20
|
|
|
21
|
-
### createIndex()
|
|
21
|
+
### `createIndex()`
|
|
22
22
|
|
|
23
23
|
Creates a new index with the specified configuration.
|
|
24
24
|
|
|
@@ -28,23 +28,23 @@ Creates a new index with the specified configuration.
|
|
|
28
28
|
|
|
29
29
|
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): The distance metric to use for vector similarity (Default: `'cosine'`)
|
|
30
30
|
|
|
31
|
-
### listIndexes()
|
|
31
|
+
### `listIndexes()`
|
|
32
32
|
|
|
33
33
|
Lists all indexes in the OpenSearch instance.
|
|
34
34
|
|
|
35
35
|
Returns: `Promise<string[]>`
|
|
36
36
|
|
|
37
|
-
### describeIndex()
|
|
37
|
+
### `describeIndex()`
|
|
38
38
|
|
|
39
39
|
Gets information about an index.
|
|
40
40
|
|
|
41
41
|
**indexName** (`string`): The name of the index to describe
|
|
42
42
|
|
|
43
|
-
### deleteIndex()
|
|
43
|
+
### `deleteIndex()`
|
|
44
44
|
|
|
45
45
|
**indexName** (`string`): The name of the index to delete
|
|
46
46
|
|
|
47
|
-
### upsert()
|
|
47
|
+
### `upsert()`
|
|
48
48
|
|
|
49
49
|
**indexName** (`string`): The name of the index to upsert vectors into
|
|
50
50
|
|
|
@@ -54,7 +54,7 @@ Gets information about an index.
|
|
|
54
54
|
|
|
55
55
|
**ids** (`string[]`): Optional array of IDs for the vectors. If not provided, random IDs will be generated
|
|
56
56
|
|
|
57
|
-
### query()
|
|
57
|
+
### `query()`
|
|
58
58
|
|
|
59
59
|
**indexName** (`string`): The name of the index to query
|
|
60
60
|
|
|
@@ -64,7 +64,7 @@ Gets information about an index.
|
|
|
64
64
|
|
|
65
65
|
**filter** (`VectorFilter`): Optional filter to apply to the query (MongoDB-style query syntax)
|
|
66
66
|
|
|
67
|
-
### updateVector()
|
|
67
|
+
### `updateVector()`
|
|
68
68
|
|
|
69
69
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
70
70
|
|
|
@@ -76,7 +76,7 @@ Update a single vector by ID or by metadata filter. Either `id` or `filter` must
|
|
|
76
76
|
|
|
77
77
|
**update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
|
|
78
78
|
|
|
79
|
-
### deleteVector()
|
|
79
|
+
### `deleteVector()`
|
|
80
80
|
|
|
81
81
|
Deletes a single vector by its ID from the index.
|
|
82
82
|
|
|
@@ -84,7 +84,7 @@ Deletes a single vector by its ID from the index.
|
|
|
84
84
|
|
|
85
85
|
**id** (`string`): The ID of the vector to delete
|
|
86
86
|
|
|
87
|
-
### deleteVectors()
|
|
87
|
+
### `deleteVectors()`
|
|
88
88
|
|
|
89
89
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
90
90
|
|