@mastra/mcp-docs-server 1.1.7-alpha.0 → 1.1.8-alpha.0
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/agent-approval.md +61 -31
- package/.docs/docs/agents/supervisor-agents.md +1 -1
- package/.docs/docs/getting-started/manual-install.md +1 -1
- package/.docs/docs/index.md +68 -24
- package/.docs/docs/mastra-cloud/setup.md +1 -1
- package/.docs/docs/memory/observational-memory.md +9 -0
- package/.docs/docs/memory/semantic-recall.md +17 -1
- package/.docs/docs/workspace/skills.md +7 -5
- package/.docs/guides/deployment/aws-lambda.md +76 -165
- package/.docs/guides/deployment/azure-app-services.md +38 -61
- package/.docs/guides/deployment/cloudflare.md +1 -1
- package/.docs/guides/deployment/netlify.md +1 -1
- package/.docs/guides/deployment/vercel.md +1 -1
- package/.docs/models/gateways/netlify.md +5 -1
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/anthropic.md +9 -9
- package/.docs/models/providers/deepseek.md +1 -1
- package/.docs/models/providers/google.md +11 -11
- package/.docs/models/providers/openai.md +19 -19
- package/.docs/models/providers/opencode.md +33 -33
- package/.docs/models/providers/xai.md +3 -3
- package/.docs/reference/agents/agent.md +20 -20
- package/.docs/reference/agents/generate.md +200 -66
- package/.docs/reference/agents/generateLegacy.md +77 -35
- package/.docs/reference/agents/getDefaultGenerateOptions.md +4 -6
- package/.docs/reference/agents/getDefaultOptions.md +4 -6
- package/.docs/reference/agents/getDefaultStreamOptions.md +4 -6
- package/.docs/reference/agents/getDescription.md +1 -1
- package/.docs/reference/agents/getInstructions.md +4 -6
- package/.docs/reference/agents/getLLM.md +6 -8
- package/.docs/reference/agents/getMemory.md +4 -6
- package/.docs/reference/agents/getModel.md +4 -6
- package/.docs/reference/agents/getTools.md +5 -7
- package/.docs/reference/agents/getVoice.md +4 -6
- package/.docs/reference/agents/listAgents.md +4 -6
- package/.docs/reference/agents/listScorers.md +4 -6
- package/.docs/reference/agents/listTools.md +4 -6
- package/.docs/reference/agents/listWorkflows.md +4 -6
- package/.docs/reference/agents/network.md +69 -23
- package/.docs/reference/ai-sdk/chat-route.md +7 -7
- package/.docs/reference/ai-sdk/handle-chat-stream.md +12 -12
- package/.docs/reference/ai-sdk/handle-network-stream.md +4 -4
- package/.docs/reference/ai-sdk/handle-workflow-stream.md +11 -11
- package/.docs/reference/ai-sdk/network-route.md +3 -3
- package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +9 -9
- package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +9 -9
- package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +5 -5
- package/.docs/reference/ai-sdk/with-mastra.md +12 -12
- package/.docs/reference/ai-sdk/workflow-route.md +3 -3
- package/.docs/reference/auth/auth0.md +6 -6
- package/.docs/reference/auth/better-auth.md +5 -5
- package/.docs/reference/auth/clerk.md +5 -5
- package/.docs/reference/auth/firebase.md +7 -7
- package/.docs/reference/auth/jwt.md +1 -1
- package/.docs/reference/auth/supabase.md +4 -4
- package/.docs/reference/auth/workos.md +6 -6
- package/.docs/reference/cli/create-mastra.md +14 -14
- package/.docs/reference/client-js/mastra-client.md +23 -23
- package/.docs/reference/client-js/workflows.md +3 -3
- package/.docs/reference/core/addGateway.md +2 -2
- package/.docs/reference/core/getAgent.md +2 -2
- package/.docs/reference/core/getAgentById.md +2 -2
- package/.docs/reference/core/getDeployer.md +1 -1
- package/.docs/reference/core/getGateway.md +2 -2
- package/.docs/reference/core/getGatewayById.md +2 -2
- package/.docs/reference/core/getLogger.md +1 -1
- package/.docs/reference/core/getMCPServer.md +2 -2
- package/.docs/reference/core/getMCPServerById.md +3 -3
- package/.docs/reference/core/getMemory.md +2 -2
- package/.docs/reference/core/getScorer.md +2 -2
- package/.docs/reference/core/getScorerById.md +2 -2
- package/.docs/reference/core/getServer.md +1 -1
- package/.docs/reference/core/getStorage.md +1 -1
- package/.docs/reference/core/getStoredAgentById.md +18 -20
- package/.docs/reference/core/getTelemetry.md +1 -1
- package/.docs/reference/core/getVector.md +2 -2
- package/.docs/reference/core/getWorkflow.md +3 -3
- package/.docs/reference/core/listAgents.md +1 -1
- package/.docs/reference/core/listGateways.md +1 -1
- package/.docs/reference/core/listLogs.md +9 -11
- package/.docs/reference/core/listLogsByRunId.md +9 -9
- package/.docs/reference/core/listMCPServers.md +1 -1
- package/.docs/reference/core/listMemory.md +1 -1
- package/.docs/reference/core/listScorers.md +1 -1
- package/.docs/reference/core/listStoredAgents.md +9 -11
- package/.docs/reference/core/listVectors.md +1 -1
- package/.docs/reference/core/listWorkflows.md +2 -2
- package/.docs/reference/core/mastra-class.md +17 -17
- package/.docs/reference/core/mastra-model-gateway.md +15 -15
- package/.docs/reference/core/setLogger.md +2 -4
- package/.docs/reference/core/setStorage.md +1 -1
- package/.docs/reference/datasets/addItem.md +20 -4
- package/.docs/reference/datasets/addItems.md +8 -2
- package/.docs/reference/datasets/compareExperiments.md +15 -3
- package/.docs/reference/datasets/create.md +6 -6
- package/.docs/reference/datasets/dataset.md +1 -1
- package/.docs/reference/datasets/delete.md +2 -2
- package/.docs/reference/datasets/deleteExperiment.md +2 -2
- package/.docs/reference/datasets/deleteItem.md +2 -2
- package/.docs/reference/datasets/deleteItems.md +2 -2
- package/.docs/reference/datasets/get.md +2 -2
- package/.docs/reference/datasets/getDetails.md +9 -9
- package/.docs/reference/datasets/getExperiment.md +2 -2
- package/.docs/reference/datasets/getItem.md +3 -3
- package/.docs/reference/datasets/getItemHistory.md +22 -2
- package/.docs/reference/datasets/list.md +7 -3
- package/.docs/reference/datasets/listExperimentResults.md +34 -4
- package/.docs/reference/datasets/listExperiments.md +41 -3
- package/.docs/reference/datasets/listItems.md +18 -6
- package/.docs/reference/datasets/listVersions.md +23 -3
- package/.docs/reference/datasets/startExperiment.md +62 -12
- package/.docs/reference/datasets/startExperimentAsync.md +5 -1
- package/.docs/reference/datasets/update.md +6 -6
- package/.docs/reference/datasets/updateItem.md +5 -5
- package/.docs/reference/deployer.md +8 -8
- package/.docs/reference/evals/answer-relevancy.md +11 -11
- package/.docs/reference/evals/answer-similarity.md +17 -19
- package/.docs/reference/evals/bias.md +10 -10
- package/.docs/reference/evals/completeness.md +3 -3
- package/.docs/reference/evals/content-similarity.md +6 -6
- package/.docs/reference/evals/context-precision.md +4 -4
- package/.docs/reference/evals/context-relevance.md +4 -4
- package/.docs/reference/evals/create-scorer.md +47 -49
- package/.docs/reference/evals/faithfulness.md +11 -11
- package/.docs/reference/evals/hallucination.md +17 -21
- package/.docs/reference/evals/keyword-coverage.md +4 -4
- package/.docs/reference/evals/mastra-scorer.md +14 -14
- package/.docs/reference/evals/noise-sensitivity.md +4 -4
- package/.docs/reference/evals/prompt-alignment.md +4 -4
- package/.docs/reference/evals/run-evals.md +16 -16
- package/.docs/reference/evals/scorer-utils.md +3 -3
- package/.docs/reference/evals/textual-difference.md +3 -3
- package/.docs/reference/evals/tone-consistency.md +3 -3
- package/.docs/reference/evals/tool-call-accuracy.md +5 -5
- package/.docs/reference/evals/toxicity.md +8 -8
- package/.docs/reference/harness/harness-class.md +34 -42
- package/.docs/reference/logging/pino-logger.md +5 -5
- package/.docs/reference/memory/clone-utilities.md +5 -5
- package/.docs/reference/memory/cloneThread.md +17 -21
- package/.docs/reference/memory/createThread.md +10 -10
- package/.docs/reference/memory/deleteMessages.md +2 -2
- package/.docs/reference/memory/getThreadById.md +2 -2
- package/.docs/reference/memory/listThreads.md +5 -5
- package/.docs/reference/memory/memory-class.md +12 -14
- package/.docs/reference/memory/observational-memory.md +102 -94
- package/.docs/reference/memory/recall.md +14 -16
- package/.docs/reference/observability/tracing/configuration.md +27 -10
- package/.docs/reference/observability/tracing/exporters/console-exporter.md +4 -7
- package/.docs/reference/processors/batch-parts-processor.md +8 -10
- package/.docs/reference/processors/language-detector.md +14 -16
- package/.docs/reference/processors/message-history-processor.md +7 -9
- package/.docs/reference/processors/moderation-processor.md +13 -15
- package/.docs/reference/processors/pii-detector.md +14 -16
- package/.docs/reference/processors/processor-interface.md +62 -62
- package/.docs/reference/processors/prompt-injection-detector.md +11 -13
- package/.docs/reference/processors/semantic-recall-processor.md +14 -16
- package/.docs/reference/processors/system-prompt-scrubber.md +12 -14
- package/.docs/reference/processors/token-limiter-processor.md +11 -13
- package/.docs/reference/processors/tool-call-filter.md +5 -7
- package/.docs/reference/processors/tool-search-processor.md +9 -11
- package/.docs/reference/processors/unicode-normalizer.md +8 -10
- package/.docs/reference/processors/working-memory-processor.md +14 -18
- package/.docs/reference/rag/chunk.md +38 -38
- package/.docs/reference/rag/database-config.md +11 -7
- package/.docs/reference/rag/document.md +2 -2
- package/.docs/reference/rag/embeddings.md +12 -12
- package/.docs/reference/rag/extract-params.md +23 -23
- package/.docs/reference/rag/graph-rag.md +12 -12
- package/.docs/reference/rag/rerank.md +25 -17
- package/.docs/reference/rag/rerankWithScorer.md +25 -17
- package/.docs/reference/server/create-route.md +14 -14
- package/.docs/reference/server/express-adapter.md +10 -10
- package/.docs/reference/server/fastify-adapter.md +10 -10
- package/.docs/reference/server/hono-adapter.md +10 -10
- package/.docs/reference/server/koa-adapter.md +10 -10
- package/.docs/reference/server/mastra-server.md +10 -10
- package/.docs/reference/server/register-api-route.md +13 -13
- package/.docs/reference/storage/cloudflare-d1.md +5 -5
- package/.docs/reference/storage/cloudflare.md +6 -6
- package/.docs/reference/storage/composite.md +9 -9
- package/.docs/reference/storage/convex.md +3 -3
- package/.docs/reference/storage/dynamodb.md +9 -9
- package/.docs/reference/storage/lance.md +3 -3
- package/.docs/reference/storage/libsql.md +2 -2
- package/.docs/reference/storage/mongodb.md +5 -5
- package/.docs/reference/storage/mssql.md +2 -2
- package/.docs/reference/storage/postgresql.md +25 -25
- package/.docs/reference/storage/upstash.md +3 -3
- package/.docs/reference/streaming/ChunkType.md +251 -59
- package/.docs/reference/streaming/agents/MastraModelOutput.md +86 -16
- package/.docs/reference/streaming/agents/stream.md +155 -43
- package/.docs/reference/streaming/agents/streamLegacy.md +79 -39
- package/.docs/reference/streaming/workflows/resumeStream.md +18 -8
- package/.docs/reference/streaming/workflows/stream.md +21 -9
- package/.docs/reference/streaming/workflows/timeTravelStream.md +4 -4
- package/.docs/reference/tools/create-tool.md +25 -21
- package/.docs/reference/tools/document-chunker-tool.md +7 -7
- package/.docs/reference/tools/graph-rag-tool.md +16 -18
- package/.docs/reference/tools/mcp-client.md +38 -27
- package/.docs/reference/tools/mcp-server.md +45 -45
- package/.docs/reference/tools/vector-query-tool.md +34 -22
- package/.docs/reference/vectors/astra.md +22 -22
- package/.docs/reference/vectors/chroma.md +44 -44
- package/.docs/reference/vectors/convex.md +26 -26
- package/.docs/reference/vectors/couchbase.md +30 -30
- package/.docs/reference/vectors/duckdb.md +29 -29
- package/.docs/reference/vectors/elasticsearch.md +27 -27
- package/.docs/reference/vectors/lance.md +46 -38
- package/.docs/reference/vectors/libsql.md +31 -31
- package/.docs/reference/vectors/mongodb.md +32 -32
- package/.docs/reference/vectors/opensearch.md +27 -27
- package/.docs/reference/vectors/pg.md +60 -44
- package/.docs/reference/vectors/pinecone.md +38 -38
- package/.docs/reference/vectors/qdrant.md +36 -36
- package/.docs/reference/vectors/s3vectors.md +24 -24
- package/.docs/reference/vectors/turbopuffer.md +29 -29
- package/.docs/reference/vectors/upstash.md +25 -25
- package/.docs/reference/vectors/vectorize.md +27 -27
- package/.docs/reference/voice/azure.md +19 -15
- package/.docs/reference/voice/cloudflare.md +10 -12
- package/.docs/reference/voice/composite-voice.md +10 -10
- package/.docs/reference/voice/deepgram.md +20 -14
- package/.docs/reference/voice/elevenlabs.md +20 -22
- package/.docs/reference/voice/google-gemini-live.md +42 -44
- package/.docs/reference/voice/google.md +25 -21
- package/.docs/reference/voice/mastra-voice.md +20 -20
- package/.docs/reference/voice/murf.md +24 -28
- package/.docs/reference/voice/openai-realtime.md +26 -26
- package/.docs/reference/voice/openai.md +14 -12
- package/.docs/reference/voice/playai.md +13 -15
- package/.docs/reference/voice/sarvam.md +21 -25
- package/.docs/reference/voice/speechify.md +11 -13
- package/.docs/reference/voice/voice.addInstructions.md +1 -1
- package/.docs/reference/voice/voice.addTools.md +1 -1
- package/.docs/reference/voice/voice.answer.md +1 -1
- package/.docs/reference/voice/voice.connect.md +3 -3
- package/.docs/reference/voice/voice.events.md +11 -11
- package/.docs/reference/voice/voice.getSpeakers.md +30 -30
- package/.docs/reference/voice/voice.listen.md +9 -9
- package/.docs/reference/voice/voice.off.md +2 -2
- package/.docs/reference/voice/voice.on.md +2 -2
- package/.docs/reference/voice/voice.send.md +1 -1
- package/.docs/reference/voice/voice.speak.md +11 -11
- package/.docs/reference/voice/voice.updateConfig.md +3 -3
- package/.docs/reference/workflows/run-methods/cancel.md +2 -2
- package/.docs/reference/workflows/run-methods/restart.md +17 -5
- package/.docs/reference/workflows/run-methods/resume.md +23 -9
- package/.docs/reference/workflows/run-methods/start.md +22 -8
- package/.docs/reference/workflows/run-methods/startAsync.md +12 -6
- package/.docs/reference/workflows/run-methods/timeTravel.md +29 -13
- package/.docs/reference/workflows/run.md +12 -12
- package/.docs/reference/workflows/step.md +24 -26
- package/.docs/reference/workflows/workflow-methods/branch.md +2 -2
- package/.docs/reference/workflows/workflow-methods/commit.md +1 -1
- package/.docs/reference/workflows/workflow-methods/create-run.md +4 -4
- package/.docs/reference/workflows/workflow-methods/dountil.md +3 -3
- package/.docs/reference/workflows/workflow-methods/dowhile.md +3 -3
- package/.docs/reference/workflows/workflow-methods/foreach.md +9 -9
- package/.docs/reference/workflows/workflow-methods/map.md +2 -2
- package/.docs/reference/workflows/workflow-methods/parallel.md +2 -2
- package/.docs/reference/workflows/workflow-methods/sleep.md +2 -2
- package/.docs/reference/workflows/workflow-methods/sleepUntil.md +2 -2
- package/.docs/reference/workflows/workflow-methods/then.md +2 -2
- package/.docs/reference/workflows/workflow.md +40 -50
- package/.docs/reference/workspace/daytona-sandbox.md +33 -33
- package/.docs/reference/workspace/e2b-sandbox.md +20 -20
- package/.docs/reference/workspace/filesystem.md +22 -22
- package/.docs/reference/workspace/gcs-filesystem.md +15 -15
- package/.docs/reference/workspace/local-filesystem.md +35 -35
- package/.docs/reference/workspace/local-sandbox.md +26 -26
- package/.docs/reference/workspace/s3-filesystem.md +18 -18
- package/.docs/reference/workspace/sandbox.md +8 -8
- package/.docs/reference/workspace/workspace-class.md +30 -34
- package/CHANGELOG.md +16 -0
- package/package.json +6 -6
- package/.docs/docs/getting-started/start.md +0 -28
|
@@ -34,11 +34,11 @@ Before using `ConvexVector`, you need to set up the Convex schema and storage ha
|
|
|
34
34
|
|
|
35
35
|
## Constructor Options
|
|
36
36
|
|
|
37
|
-
**deploymentUrl
|
|
37
|
+
**deploymentUrl** (`string`): Convex deployment URL (e.g., https\://your-project.convex.cloud)
|
|
38
38
|
|
|
39
|
-
**adminAuthToken
|
|
39
|
+
**adminAuthToken** (`string`): Convex admin authentication token
|
|
40
40
|
|
|
41
|
-
**storageFunction
|
|
41
|
+
**storageFunction** (`string`): Path to the storage mutation function (Default: `mastra/storage:handle`)
|
|
42
42
|
|
|
43
43
|
## Constructor Examples
|
|
44
44
|
|
|
@@ -69,11 +69,11 @@ const vectorStore = new ConvexVector({
|
|
|
69
69
|
|
|
70
70
|
### createIndex()
|
|
71
71
|
|
|
72
|
-
**indexName
|
|
72
|
+
**indexName** (`string`): Name of the index to create
|
|
73
73
|
|
|
74
|
-
**dimension
|
|
74
|
+
**dimension** (`number`): Vector dimension (must match your embedding model)
|
|
75
75
|
|
|
76
|
-
**metric
|
|
76
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (only cosine is currently supported) (Default: `cosine`)
|
|
77
77
|
|
|
78
78
|
```typescript
|
|
79
79
|
await vectorStore.createIndex({
|
|
@@ -84,13 +84,13 @@ await vectorStore.createIndex({
|
|
|
84
84
|
|
|
85
85
|
### upsert()
|
|
86
86
|
|
|
87
|
-
**indexName
|
|
87
|
+
**indexName** (`string`): Name of the index to upsert vectors into
|
|
88
88
|
|
|
89
|
-
**vectors
|
|
89
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
90
90
|
|
|
91
|
-
**metadata
|
|
91
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
92
92
|
|
|
93
|
-
**ids
|
|
93
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
94
94
|
|
|
95
95
|
```typescript
|
|
96
96
|
await vectorStore.upsert({
|
|
@@ -103,15 +103,15 @@ await vectorStore.upsert({
|
|
|
103
103
|
|
|
104
104
|
### query()
|
|
105
105
|
|
|
106
|
-
**indexName
|
|
106
|
+
**indexName** (`string`): Name of the index to query
|
|
107
107
|
|
|
108
|
-
**queryVector
|
|
108
|
+
**queryVector** (`number[]`): Query vector
|
|
109
109
|
|
|
110
|
-
**topK
|
|
110
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
111
111
|
|
|
112
|
-
**filter
|
|
112
|
+
**filter** (`Record<string, any>`): Metadata filters
|
|
113
113
|
|
|
114
|
-
**includeVector
|
|
114
|
+
**includeVector** (`boolean`): Whether to include the vector in the result (Default: `false`)
|
|
115
115
|
|
|
116
116
|
```typescript
|
|
117
117
|
const results = await vectorStore.query({
|
|
@@ -133,7 +133,7 @@ const indexes = await vectorStore.listIndexes()
|
|
|
133
133
|
|
|
134
134
|
### describeIndex()
|
|
135
135
|
|
|
136
|
-
**indexName
|
|
136
|
+
**indexName** (`string`): Name of the index to describe
|
|
137
137
|
|
|
138
138
|
Returns:
|
|
139
139
|
|
|
@@ -147,7 +147,7 @@ interface IndexStats {
|
|
|
147
147
|
|
|
148
148
|
### deleteIndex()
|
|
149
149
|
|
|
150
|
-
**indexName
|
|
150
|
+
**indexName** (`string`): Name of the index to delete
|
|
151
151
|
|
|
152
152
|
Deletes the index and all its vectors.
|
|
153
153
|
|
|
@@ -159,13 +159,13 @@ await vectorStore.deleteIndex({ indexName: 'my_vectors' })
|
|
|
159
159
|
|
|
160
160
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
161
161
|
|
|
162
|
-
**indexName
|
|
162
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
163
163
|
|
|
164
|
-
**id
|
|
164
|
+
**id** (`string`): ID of the vector to update (mutually exclusive with filter)
|
|
165
165
|
|
|
166
|
-
**filter
|
|
166
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
|
|
167
167
|
|
|
168
|
-
**update
|
|
168
|
+
**update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
|
|
169
169
|
|
|
170
170
|
```typescript
|
|
171
171
|
// Update by ID
|
|
@@ -190,9 +190,9 @@ await vectorStore.updateVector({
|
|
|
190
190
|
|
|
191
191
|
### deleteVector()
|
|
192
192
|
|
|
193
|
-
**indexName
|
|
193
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
194
194
|
|
|
195
|
-
**id
|
|
195
|
+
**id** (`string`): ID of the vector to delete
|
|
196
196
|
|
|
197
197
|
```typescript
|
|
198
198
|
await vectorStore.deleteVector({ indexName: 'my_vectors', id: 'vector123' })
|
|
@@ -202,11 +202,11 @@ await vectorStore.deleteVector({ indexName: 'my_vectors', id: 'vector123' })
|
|
|
202
202
|
|
|
203
203
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
204
204
|
|
|
205
|
-
**indexName
|
|
205
|
+
**indexName** (`string`): Name of the index containing the vectors to delete
|
|
206
206
|
|
|
207
|
-
**ids
|
|
207
|
+
**ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
|
|
208
208
|
|
|
209
|
-
**filter
|
|
209
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
210
210
|
|
|
211
211
|
```typescript
|
|
212
212
|
// Delete by IDs
|
|
@@ -51,21 +51,21 @@ const store = new CouchbaseVector({
|
|
|
51
51
|
|
|
52
52
|
## Constructor Options
|
|
53
53
|
|
|
54
|
-
**id
|
|
54
|
+
**id** (`string`): Unique identifier for this vector store instance
|
|
55
55
|
|
|
56
|
-
**connectionString
|
|
56
|
+
**connectionString** (`string`): Couchbase connection string
|
|
57
57
|
|
|
58
|
-
**username
|
|
58
|
+
**username** (`string`): Couchbase username
|
|
59
59
|
|
|
60
|
-
**password
|
|
60
|
+
**password** (`string`): Couchbase password
|
|
61
61
|
|
|
62
|
-
**bucketName
|
|
62
|
+
**bucketName** (`string`): Name of the Couchbase bucket to use
|
|
63
63
|
|
|
64
|
-
**scopeName
|
|
64
|
+
**scopeName** (`string`): Name of the Couchbase scope to use
|
|
65
65
|
|
|
66
|
-
**collectionName
|
|
66
|
+
**collectionName** (`string`): Name of the Couchbase collection to use
|
|
67
67
|
|
|
68
|
-
**options
|
|
68
|
+
**options** (`CouchbaseClientOptions`): Optional Couchbase client options
|
|
69
69
|
|
|
70
70
|
## Methods
|
|
71
71
|
|
|
@@ -75,11 +75,11 @@ Creates a new vector index in Couchbase.
|
|
|
75
75
|
|
|
76
76
|
> **Note:** Index creation is asynchronous. After calling `createIndex`, allow time (typically 1–5 seconds for small datasets, longer for large ones) before querying. For production, implement polling to check index status rather than using fixed delays.
|
|
77
77
|
|
|
78
|
-
**indexName
|
|
78
|
+
**indexName** (`string`): Name of the index to create
|
|
79
79
|
|
|
80
|
-
**dimension
|
|
80
|
+
**dimension** (`number`): Vector dimension (must match your embedding model)
|
|
81
81
|
|
|
82
|
-
**metric
|
|
82
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
83
83
|
|
|
84
84
|
### upsert()
|
|
85
85
|
|
|
@@ -87,13 +87,13 @@ Adds or updates vectors and their metadata in the collection.
|
|
|
87
87
|
|
|
88
88
|
> **Note:** You can upsert data before or after creating the index. The `upsert` method does not require the index to exist. Couchbase allows multiple Search indexes over the same collection.
|
|
89
89
|
|
|
90
|
-
**indexName
|
|
90
|
+
**indexName** (`string`): Name of the index to insert into
|
|
91
91
|
|
|
92
|
-
**vectors
|
|
92
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
93
93
|
|
|
94
|
-
**metadata
|
|
94
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
95
95
|
|
|
96
|
-
**ids
|
|
96
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
97
97
|
|
|
98
98
|
### query()
|
|
99
99
|
|
|
@@ -101,23 +101,23 @@ Searches for similar vectors.
|
|
|
101
101
|
|
|
102
102
|
> **Warning:** The `filter` and `includeVector` parameters are not currently supported. Filtering must be performed client-side after retrieving results, or by using the Couchbase SDK's Search capabilities directly. To retrieve the vector embedding, fetch the full document by ID using the Couchbase SDK.
|
|
103
103
|
|
|
104
|
-
**indexName
|
|
104
|
+
**indexName** (`string`): Name of the index to search in
|
|
105
105
|
|
|
106
|
-
**queryVector
|
|
106
|
+
**queryVector** (`number[]`): Query vector to find similar vectors for
|
|
107
107
|
|
|
108
|
-
**topK
|
|
108
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
109
109
|
|
|
110
|
-
**filter
|
|
110
|
+
**filter** (`Record<string, any>`): Metadata filters
|
|
111
111
|
|
|
112
|
-
**includeVector
|
|
112
|
+
**includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
|
|
113
113
|
|
|
114
|
-
**minScore
|
|
114
|
+
**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
|
|
115
115
|
|
|
116
116
|
### describeIndex()
|
|
117
117
|
|
|
118
118
|
Returns information about the index.
|
|
119
119
|
|
|
120
|
-
**indexName
|
|
120
|
+
**indexName** (`string`): Name of the index to describe
|
|
121
121
|
|
|
122
122
|
Returns:
|
|
123
123
|
|
|
@@ -133,7 +133,7 @@ interface IndexStats {
|
|
|
133
133
|
|
|
134
134
|
Deletes an index and all its data.
|
|
135
135
|
|
|
136
|
-
**indexName
|
|
136
|
+
**indexName** (`string`): Name of the index to delete
|
|
137
137
|
|
|
138
138
|
### listIndexes()
|
|
139
139
|
|
|
@@ -145,27 +145,27 @@ Returns: `Promise<string[]>`
|
|
|
145
145
|
|
|
146
146
|
Updates a specific vector entry by its ID with new vector data and/or metadata. **Note:** Filter-based updates are not yet implemented for Couchbase.
|
|
147
147
|
|
|
148
|
-
**indexName
|
|
148
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
149
149
|
|
|
150
|
-
**id
|
|
150
|
+
**id** (`string`): ID of the vector entry to update
|
|
151
151
|
|
|
152
|
-
**update
|
|
152
|
+
**update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
|
|
153
153
|
|
|
154
154
|
### deleteVector()
|
|
155
155
|
|
|
156
156
|
Deletes a single vector by its ID from the index.
|
|
157
157
|
|
|
158
|
-
**indexName
|
|
158
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
159
159
|
|
|
160
|
-
**id
|
|
160
|
+
**id** (`string`): ID of the vector to delete
|
|
161
161
|
|
|
162
162
|
### deleteVectors()
|
|
163
163
|
|
|
164
164
|
Deletes multiple vectors by their IDs. **Note:** Filter-based deletion is not yet implemented for Couchbase.
|
|
165
165
|
|
|
166
|
-
**indexName
|
|
166
|
+
**indexName** (`string`): Name of the index containing the vectors to delete
|
|
167
167
|
|
|
168
|
-
**ids
|
|
168
|
+
**ids** (`string[]`): Array of vector IDs to delete
|
|
169
169
|
|
|
170
170
|
### disconnect()
|
|
171
171
|
|
|
@@ -75,13 +75,13 @@ await store.close();
|
|
|
75
75
|
|
|
76
76
|
## Constructor Options
|
|
77
77
|
|
|
78
|
-
**id
|
|
78
|
+
**id** (`string`): Unique identifier for the vector store instance
|
|
79
79
|
|
|
80
|
-
**path
|
|
80
|
+
**path** (`string`): Database file path. Use ':memory:' for in-memory database, or a file path like './vectors.duckdb' for persistence. (Default: `':memory:'`)
|
|
81
81
|
|
|
82
|
-
**dimensions
|
|
82
|
+
**dimensions** (`number`): Default dimension for vector embeddings (Default: `1536`)
|
|
83
83
|
|
|
84
|
-
**metric
|
|
84
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Default distance metric for similarity search (Default: `cosine`)
|
|
85
85
|
|
|
86
86
|
## Methods
|
|
87
87
|
|
|
@@ -89,43 +89,43 @@ await store.close();
|
|
|
89
89
|
|
|
90
90
|
Creates a new vector collection with optional HNSW index for fast approximate nearest neighbor search.
|
|
91
91
|
|
|
92
|
-
**indexName
|
|
92
|
+
**indexName** (`string`): Name of the index to create
|
|
93
93
|
|
|
94
|
-
**dimension
|
|
94
|
+
**dimension** (`number`): Vector dimension size (must match your embedding model)
|
|
95
95
|
|
|
96
|
-
**metric
|
|
96
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
97
97
|
|
|
98
98
|
### upsert()
|
|
99
99
|
|
|
100
100
|
Adds or updates vectors and their metadata in the index.
|
|
101
101
|
|
|
102
|
-
**indexName
|
|
102
|
+
**indexName** (`string`): Name of the index to insert into
|
|
103
103
|
|
|
104
|
-
**vectors
|
|
104
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
105
105
|
|
|
106
|
-
**metadata
|
|
106
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
107
107
|
|
|
108
|
-
**ids
|
|
108
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated UUIDs if not provided)
|
|
109
109
|
|
|
110
110
|
### query()
|
|
111
111
|
|
|
112
112
|
Searches for similar vectors with optional metadata filtering.
|
|
113
113
|
|
|
114
|
-
**indexName
|
|
114
|
+
**indexName** (`string`): Name of the index to search in
|
|
115
115
|
|
|
116
|
-
**queryVector
|
|
116
|
+
**queryVector** (`number[]`): Query vector to find similar vectors for
|
|
117
117
|
|
|
118
|
-
**topK
|
|
118
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
119
119
|
|
|
120
|
-
**filter
|
|
120
|
+
**filter** (`Filter`): Metadata filters using MongoDB-like query syntax
|
|
121
121
|
|
|
122
|
-
**includeVector
|
|
122
|
+
**includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
|
|
123
123
|
|
|
124
124
|
### describeIndex()
|
|
125
125
|
|
|
126
126
|
Gets information about an index.
|
|
127
127
|
|
|
128
|
-
**indexName
|
|
128
|
+
**indexName** (`string`): Name of the index to describe
|
|
129
129
|
|
|
130
130
|
Returns:
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ interface IndexStats {
|
|
|
141
141
|
|
|
142
142
|
Deletes an index and all its data.
|
|
143
143
|
|
|
144
|
-
**indexName
|
|
144
|
+
**indexName** (`string`): Name of the index to delete
|
|
145
145
|
|
|
146
146
|
### listIndexes()
|
|
147
147
|
|
|
@@ -153,35 +153,35 @@ Returns: `Promise<string[]>`
|
|
|
153
153
|
|
|
154
154
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
155
155
|
|
|
156
|
-
**indexName
|
|
156
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
157
157
|
|
|
158
|
-
**id
|
|
158
|
+
**id** (`string`): ID of the vector entry to update (mutually exclusive with filter)
|
|
159
159
|
|
|
160
|
-
**filter
|
|
160
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
|
|
161
161
|
|
|
162
|
-
**update
|
|
162
|
+
**update** (`object`): Update data containing vector and/or metadata
|
|
163
163
|
|
|
164
|
-
**update.vector
|
|
164
|
+
**update.vector** (`number[]`): New vector data to update
|
|
165
165
|
|
|
166
|
-
**update.metadata
|
|
166
|
+
**update.metadata** (`Record<string, any>`): New metadata to update
|
|
167
167
|
|
|
168
168
|
### deleteVector()
|
|
169
169
|
|
|
170
170
|
Deletes a specific vector entry from an index by its ID.
|
|
171
171
|
|
|
172
|
-
**indexName
|
|
172
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
173
173
|
|
|
174
|
-
**id
|
|
174
|
+
**id** (`string`): ID of the vector entry to delete
|
|
175
175
|
|
|
176
176
|
### deleteVectors()
|
|
177
177
|
|
|
178
178
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
179
179
|
|
|
180
|
-
**indexName
|
|
180
|
+
**indexName** (`string`): Name of the index containing the vectors to delete
|
|
181
181
|
|
|
182
|
-
**ids
|
|
182
|
+
**ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
|
|
183
183
|
|
|
184
|
-
**filter
|
|
184
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
185
185
|
|
|
186
186
|
### close()
|
|
187
187
|
|
|
@@ -67,9 +67,9 @@ const results = await store.query({
|
|
|
67
67
|
|
|
68
68
|
## Constructor Options
|
|
69
69
|
|
|
70
|
-
**id
|
|
70
|
+
**id** (`string`): Unique identifier for this vector store instance
|
|
71
71
|
|
|
72
|
-
**url
|
|
72
|
+
**url** (`string`): ElasticSearch connection URL (e.g., 'http\://localhost:9200')
|
|
73
73
|
|
|
74
74
|
## Methods
|
|
75
75
|
|
|
@@ -77,43 +77,43 @@ const results = await store.query({
|
|
|
77
77
|
|
|
78
78
|
Creates a new index with the specified configuration.
|
|
79
79
|
|
|
80
|
-
**indexName
|
|
80
|
+
**indexName** (`string`): Name of the index to create
|
|
81
81
|
|
|
82
|
-
**dimension
|
|
82
|
+
**dimension** (`number`): Vector dimension (must match your embedding model)
|
|
83
83
|
|
|
84
|
-
**metric
|
|
84
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
85
85
|
|
|
86
86
|
### upsert()
|
|
87
87
|
|
|
88
88
|
Adds or updates vectors and their metadata in the index.
|
|
89
89
|
|
|
90
|
-
**indexName
|
|
90
|
+
**indexName** (`string`): Name of the index to insert into
|
|
91
91
|
|
|
92
|
-
**vectors
|
|
92
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
93
93
|
|
|
94
|
-
**metadata
|
|
94
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
95
95
|
|
|
96
|
-
**ids
|
|
96
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
97
97
|
|
|
98
98
|
### query()
|
|
99
99
|
|
|
100
100
|
Searches for similar vectors with optional metadata filtering.
|
|
101
101
|
|
|
102
|
-
**indexName
|
|
102
|
+
**indexName** (`string`): Name of the index to search in
|
|
103
103
|
|
|
104
|
-
**queryVector
|
|
104
|
+
**queryVector** (`number[]`): Query vector to find similar vectors for
|
|
105
105
|
|
|
106
|
-
**topK
|
|
106
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
107
107
|
|
|
108
|
-
**filter
|
|
108
|
+
**filter** (`Record<string, any>`): Metadata filters
|
|
109
109
|
|
|
110
|
-
**includeVector
|
|
110
|
+
**includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
|
|
111
111
|
|
|
112
112
|
### describeIndex()
|
|
113
113
|
|
|
114
114
|
Gets information about an index.
|
|
115
115
|
|
|
116
|
-
**indexName
|
|
116
|
+
**indexName** (`string`): Name of the index to describe
|
|
117
117
|
|
|
118
118
|
Returns:
|
|
119
119
|
|
|
@@ -129,7 +129,7 @@ interface IndexStats {
|
|
|
129
129
|
|
|
130
130
|
Deletes an index and all its data.
|
|
131
131
|
|
|
132
|
-
**indexName
|
|
132
|
+
**indexName** (`string`): Name of the index to delete
|
|
133
133
|
|
|
134
134
|
### listIndexes()
|
|
135
135
|
|
|
@@ -141,35 +141,35 @@ Returns: `Promise<string[]>`
|
|
|
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
|
|
|
144
|
-
**indexName
|
|
144
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
145
145
|
|
|
146
|
-
**id
|
|
146
|
+
**id** (`string`): ID of the vector to update (mutually exclusive with filter)
|
|
147
147
|
|
|
148
|
-
**filter
|
|
148
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
|
|
149
149
|
|
|
150
|
-
**update
|
|
150
|
+
**update** (`object`): Update data containing vector and/or metadata
|
|
151
151
|
|
|
152
|
-
**update.vector
|
|
152
|
+
**update.vector** (`number[]`): New vector data
|
|
153
153
|
|
|
154
|
-
**update.metadata
|
|
154
|
+
**update.metadata** (`Record<string, any>`): New metadata
|
|
155
155
|
|
|
156
156
|
### deleteVector()
|
|
157
157
|
|
|
158
158
|
Deletes a single vector by its ID.
|
|
159
159
|
|
|
160
|
-
**indexName
|
|
160
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
161
161
|
|
|
162
|
-
**id
|
|
162
|
+
**id** (`string`): ID of the vector to delete
|
|
163
163
|
|
|
164
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
|
|
|
168
|
-
**indexName
|
|
168
|
+
**indexName** (`string`): Name of the index containing the vectors to delete
|
|
169
169
|
|
|
170
|
-
**ids
|
|
170
|
+
**ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
|
|
171
171
|
|
|
172
|
-
**filter
|
|
172
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
173
173
|
|
|
174
174
|
## Response Types
|
|
175
175
|
|