@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.
Files changed (276) hide show
  1. package/.docs/docs/agents/agent-approval.md +61 -31
  2. package/.docs/docs/agents/supervisor-agents.md +1 -1
  3. package/.docs/docs/getting-started/manual-install.md +1 -1
  4. package/.docs/docs/index.md +68 -24
  5. package/.docs/docs/mastra-cloud/setup.md +1 -1
  6. package/.docs/docs/memory/observational-memory.md +9 -0
  7. package/.docs/docs/memory/semantic-recall.md +17 -1
  8. package/.docs/docs/workspace/skills.md +7 -5
  9. package/.docs/guides/deployment/aws-lambda.md +76 -165
  10. package/.docs/guides/deployment/azure-app-services.md +38 -61
  11. package/.docs/guides/deployment/cloudflare.md +1 -1
  12. package/.docs/guides/deployment/netlify.md +1 -1
  13. package/.docs/guides/deployment/vercel.md +1 -1
  14. package/.docs/models/gateways/netlify.md +5 -1
  15. package/.docs/models/index.md +1 -1
  16. package/.docs/models/providers/anthropic.md +9 -9
  17. package/.docs/models/providers/deepseek.md +1 -1
  18. package/.docs/models/providers/google.md +11 -11
  19. package/.docs/models/providers/openai.md +19 -19
  20. package/.docs/models/providers/opencode.md +33 -33
  21. package/.docs/models/providers/xai.md +3 -3
  22. package/.docs/reference/agents/agent.md +20 -20
  23. package/.docs/reference/agents/generate.md +200 -66
  24. package/.docs/reference/agents/generateLegacy.md +77 -35
  25. package/.docs/reference/agents/getDefaultGenerateOptions.md +4 -6
  26. package/.docs/reference/agents/getDefaultOptions.md +4 -6
  27. package/.docs/reference/agents/getDefaultStreamOptions.md +4 -6
  28. package/.docs/reference/agents/getDescription.md +1 -1
  29. package/.docs/reference/agents/getInstructions.md +4 -6
  30. package/.docs/reference/agents/getLLM.md +6 -8
  31. package/.docs/reference/agents/getMemory.md +4 -6
  32. package/.docs/reference/agents/getModel.md +4 -6
  33. package/.docs/reference/agents/getTools.md +5 -7
  34. package/.docs/reference/agents/getVoice.md +4 -6
  35. package/.docs/reference/agents/listAgents.md +4 -6
  36. package/.docs/reference/agents/listScorers.md +4 -6
  37. package/.docs/reference/agents/listTools.md +4 -6
  38. package/.docs/reference/agents/listWorkflows.md +4 -6
  39. package/.docs/reference/agents/network.md +69 -23
  40. package/.docs/reference/ai-sdk/chat-route.md +7 -7
  41. package/.docs/reference/ai-sdk/handle-chat-stream.md +12 -12
  42. package/.docs/reference/ai-sdk/handle-network-stream.md +4 -4
  43. package/.docs/reference/ai-sdk/handle-workflow-stream.md +11 -11
  44. package/.docs/reference/ai-sdk/network-route.md +3 -3
  45. package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +9 -9
  46. package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +9 -9
  47. package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +5 -5
  48. package/.docs/reference/ai-sdk/with-mastra.md +12 -12
  49. package/.docs/reference/ai-sdk/workflow-route.md +3 -3
  50. package/.docs/reference/auth/auth0.md +6 -6
  51. package/.docs/reference/auth/better-auth.md +5 -5
  52. package/.docs/reference/auth/clerk.md +5 -5
  53. package/.docs/reference/auth/firebase.md +7 -7
  54. package/.docs/reference/auth/jwt.md +1 -1
  55. package/.docs/reference/auth/supabase.md +4 -4
  56. package/.docs/reference/auth/workos.md +6 -6
  57. package/.docs/reference/cli/create-mastra.md +14 -14
  58. package/.docs/reference/client-js/mastra-client.md +23 -23
  59. package/.docs/reference/client-js/workflows.md +3 -3
  60. package/.docs/reference/core/addGateway.md +2 -2
  61. package/.docs/reference/core/getAgent.md +2 -2
  62. package/.docs/reference/core/getAgentById.md +2 -2
  63. package/.docs/reference/core/getDeployer.md +1 -1
  64. package/.docs/reference/core/getGateway.md +2 -2
  65. package/.docs/reference/core/getGatewayById.md +2 -2
  66. package/.docs/reference/core/getLogger.md +1 -1
  67. package/.docs/reference/core/getMCPServer.md +2 -2
  68. package/.docs/reference/core/getMCPServerById.md +3 -3
  69. package/.docs/reference/core/getMemory.md +2 -2
  70. package/.docs/reference/core/getScorer.md +2 -2
  71. package/.docs/reference/core/getScorerById.md +2 -2
  72. package/.docs/reference/core/getServer.md +1 -1
  73. package/.docs/reference/core/getStorage.md +1 -1
  74. package/.docs/reference/core/getStoredAgentById.md +18 -20
  75. package/.docs/reference/core/getTelemetry.md +1 -1
  76. package/.docs/reference/core/getVector.md +2 -2
  77. package/.docs/reference/core/getWorkflow.md +3 -3
  78. package/.docs/reference/core/listAgents.md +1 -1
  79. package/.docs/reference/core/listGateways.md +1 -1
  80. package/.docs/reference/core/listLogs.md +9 -11
  81. package/.docs/reference/core/listLogsByRunId.md +9 -9
  82. package/.docs/reference/core/listMCPServers.md +1 -1
  83. package/.docs/reference/core/listMemory.md +1 -1
  84. package/.docs/reference/core/listScorers.md +1 -1
  85. package/.docs/reference/core/listStoredAgents.md +9 -11
  86. package/.docs/reference/core/listVectors.md +1 -1
  87. package/.docs/reference/core/listWorkflows.md +2 -2
  88. package/.docs/reference/core/mastra-class.md +17 -17
  89. package/.docs/reference/core/mastra-model-gateway.md +15 -15
  90. package/.docs/reference/core/setLogger.md +2 -4
  91. package/.docs/reference/core/setStorage.md +1 -1
  92. package/.docs/reference/datasets/addItem.md +20 -4
  93. package/.docs/reference/datasets/addItems.md +8 -2
  94. package/.docs/reference/datasets/compareExperiments.md +15 -3
  95. package/.docs/reference/datasets/create.md +6 -6
  96. package/.docs/reference/datasets/dataset.md +1 -1
  97. package/.docs/reference/datasets/delete.md +2 -2
  98. package/.docs/reference/datasets/deleteExperiment.md +2 -2
  99. package/.docs/reference/datasets/deleteItem.md +2 -2
  100. package/.docs/reference/datasets/deleteItems.md +2 -2
  101. package/.docs/reference/datasets/get.md +2 -2
  102. package/.docs/reference/datasets/getDetails.md +9 -9
  103. package/.docs/reference/datasets/getExperiment.md +2 -2
  104. package/.docs/reference/datasets/getItem.md +3 -3
  105. package/.docs/reference/datasets/getItemHistory.md +22 -2
  106. package/.docs/reference/datasets/list.md +7 -3
  107. package/.docs/reference/datasets/listExperimentResults.md +34 -4
  108. package/.docs/reference/datasets/listExperiments.md +41 -3
  109. package/.docs/reference/datasets/listItems.md +18 -6
  110. package/.docs/reference/datasets/listVersions.md +23 -3
  111. package/.docs/reference/datasets/startExperiment.md +62 -12
  112. package/.docs/reference/datasets/startExperimentAsync.md +5 -1
  113. package/.docs/reference/datasets/update.md +6 -6
  114. package/.docs/reference/datasets/updateItem.md +5 -5
  115. package/.docs/reference/deployer.md +8 -8
  116. package/.docs/reference/evals/answer-relevancy.md +11 -11
  117. package/.docs/reference/evals/answer-similarity.md +17 -19
  118. package/.docs/reference/evals/bias.md +10 -10
  119. package/.docs/reference/evals/completeness.md +3 -3
  120. package/.docs/reference/evals/content-similarity.md +6 -6
  121. package/.docs/reference/evals/context-precision.md +4 -4
  122. package/.docs/reference/evals/context-relevance.md +4 -4
  123. package/.docs/reference/evals/create-scorer.md +47 -49
  124. package/.docs/reference/evals/faithfulness.md +11 -11
  125. package/.docs/reference/evals/hallucination.md +17 -21
  126. package/.docs/reference/evals/keyword-coverage.md +4 -4
  127. package/.docs/reference/evals/mastra-scorer.md +14 -14
  128. package/.docs/reference/evals/noise-sensitivity.md +4 -4
  129. package/.docs/reference/evals/prompt-alignment.md +4 -4
  130. package/.docs/reference/evals/run-evals.md +16 -16
  131. package/.docs/reference/evals/scorer-utils.md +3 -3
  132. package/.docs/reference/evals/textual-difference.md +3 -3
  133. package/.docs/reference/evals/tone-consistency.md +3 -3
  134. package/.docs/reference/evals/tool-call-accuracy.md +5 -5
  135. package/.docs/reference/evals/toxicity.md +8 -8
  136. package/.docs/reference/harness/harness-class.md +34 -42
  137. package/.docs/reference/logging/pino-logger.md +5 -5
  138. package/.docs/reference/memory/clone-utilities.md +5 -5
  139. package/.docs/reference/memory/cloneThread.md +17 -21
  140. package/.docs/reference/memory/createThread.md +10 -10
  141. package/.docs/reference/memory/deleteMessages.md +2 -2
  142. package/.docs/reference/memory/getThreadById.md +2 -2
  143. package/.docs/reference/memory/listThreads.md +5 -5
  144. package/.docs/reference/memory/memory-class.md +12 -14
  145. package/.docs/reference/memory/observational-memory.md +102 -94
  146. package/.docs/reference/memory/recall.md +14 -16
  147. package/.docs/reference/observability/tracing/configuration.md +27 -10
  148. package/.docs/reference/observability/tracing/exporters/console-exporter.md +4 -7
  149. package/.docs/reference/processors/batch-parts-processor.md +8 -10
  150. package/.docs/reference/processors/language-detector.md +14 -16
  151. package/.docs/reference/processors/message-history-processor.md +7 -9
  152. package/.docs/reference/processors/moderation-processor.md +13 -15
  153. package/.docs/reference/processors/pii-detector.md +14 -16
  154. package/.docs/reference/processors/processor-interface.md +62 -62
  155. package/.docs/reference/processors/prompt-injection-detector.md +11 -13
  156. package/.docs/reference/processors/semantic-recall-processor.md +14 -16
  157. package/.docs/reference/processors/system-prompt-scrubber.md +12 -14
  158. package/.docs/reference/processors/token-limiter-processor.md +11 -13
  159. package/.docs/reference/processors/tool-call-filter.md +5 -7
  160. package/.docs/reference/processors/tool-search-processor.md +9 -11
  161. package/.docs/reference/processors/unicode-normalizer.md +8 -10
  162. package/.docs/reference/processors/working-memory-processor.md +14 -18
  163. package/.docs/reference/rag/chunk.md +38 -38
  164. package/.docs/reference/rag/database-config.md +11 -7
  165. package/.docs/reference/rag/document.md +2 -2
  166. package/.docs/reference/rag/embeddings.md +12 -12
  167. package/.docs/reference/rag/extract-params.md +23 -23
  168. package/.docs/reference/rag/graph-rag.md +12 -12
  169. package/.docs/reference/rag/rerank.md +25 -17
  170. package/.docs/reference/rag/rerankWithScorer.md +25 -17
  171. package/.docs/reference/server/create-route.md +14 -14
  172. package/.docs/reference/server/express-adapter.md +10 -10
  173. package/.docs/reference/server/fastify-adapter.md +10 -10
  174. package/.docs/reference/server/hono-adapter.md +10 -10
  175. package/.docs/reference/server/koa-adapter.md +10 -10
  176. package/.docs/reference/server/mastra-server.md +10 -10
  177. package/.docs/reference/server/register-api-route.md +13 -13
  178. package/.docs/reference/storage/cloudflare-d1.md +5 -5
  179. package/.docs/reference/storage/cloudflare.md +6 -6
  180. package/.docs/reference/storage/composite.md +9 -9
  181. package/.docs/reference/storage/convex.md +3 -3
  182. package/.docs/reference/storage/dynamodb.md +9 -9
  183. package/.docs/reference/storage/lance.md +3 -3
  184. package/.docs/reference/storage/libsql.md +2 -2
  185. package/.docs/reference/storage/mongodb.md +5 -5
  186. package/.docs/reference/storage/mssql.md +2 -2
  187. package/.docs/reference/storage/postgresql.md +25 -25
  188. package/.docs/reference/storage/upstash.md +3 -3
  189. package/.docs/reference/streaming/ChunkType.md +251 -59
  190. package/.docs/reference/streaming/agents/MastraModelOutput.md +86 -16
  191. package/.docs/reference/streaming/agents/stream.md +155 -43
  192. package/.docs/reference/streaming/agents/streamLegacy.md +79 -39
  193. package/.docs/reference/streaming/workflows/resumeStream.md +18 -8
  194. package/.docs/reference/streaming/workflows/stream.md +21 -9
  195. package/.docs/reference/streaming/workflows/timeTravelStream.md +4 -4
  196. package/.docs/reference/tools/create-tool.md +25 -21
  197. package/.docs/reference/tools/document-chunker-tool.md +7 -7
  198. package/.docs/reference/tools/graph-rag-tool.md +16 -18
  199. package/.docs/reference/tools/mcp-client.md +38 -27
  200. package/.docs/reference/tools/mcp-server.md +45 -45
  201. package/.docs/reference/tools/vector-query-tool.md +34 -22
  202. package/.docs/reference/vectors/astra.md +22 -22
  203. package/.docs/reference/vectors/chroma.md +44 -44
  204. package/.docs/reference/vectors/convex.md +26 -26
  205. package/.docs/reference/vectors/couchbase.md +30 -30
  206. package/.docs/reference/vectors/duckdb.md +29 -29
  207. package/.docs/reference/vectors/elasticsearch.md +27 -27
  208. package/.docs/reference/vectors/lance.md +46 -38
  209. package/.docs/reference/vectors/libsql.md +31 -31
  210. package/.docs/reference/vectors/mongodb.md +32 -32
  211. package/.docs/reference/vectors/opensearch.md +27 -27
  212. package/.docs/reference/vectors/pg.md +60 -44
  213. package/.docs/reference/vectors/pinecone.md +38 -38
  214. package/.docs/reference/vectors/qdrant.md +36 -36
  215. package/.docs/reference/vectors/s3vectors.md +24 -24
  216. package/.docs/reference/vectors/turbopuffer.md +29 -29
  217. package/.docs/reference/vectors/upstash.md +25 -25
  218. package/.docs/reference/vectors/vectorize.md +27 -27
  219. package/.docs/reference/voice/azure.md +19 -15
  220. package/.docs/reference/voice/cloudflare.md +10 -12
  221. package/.docs/reference/voice/composite-voice.md +10 -10
  222. package/.docs/reference/voice/deepgram.md +20 -14
  223. package/.docs/reference/voice/elevenlabs.md +20 -22
  224. package/.docs/reference/voice/google-gemini-live.md +42 -44
  225. package/.docs/reference/voice/google.md +25 -21
  226. package/.docs/reference/voice/mastra-voice.md +20 -20
  227. package/.docs/reference/voice/murf.md +24 -28
  228. package/.docs/reference/voice/openai-realtime.md +26 -26
  229. package/.docs/reference/voice/openai.md +14 -12
  230. package/.docs/reference/voice/playai.md +13 -15
  231. package/.docs/reference/voice/sarvam.md +21 -25
  232. package/.docs/reference/voice/speechify.md +11 -13
  233. package/.docs/reference/voice/voice.addInstructions.md +1 -1
  234. package/.docs/reference/voice/voice.addTools.md +1 -1
  235. package/.docs/reference/voice/voice.answer.md +1 -1
  236. package/.docs/reference/voice/voice.connect.md +3 -3
  237. package/.docs/reference/voice/voice.events.md +11 -11
  238. package/.docs/reference/voice/voice.getSpeakers.md +30 -30
  239. package/.docs/reference/voice/voice.listen.md +9 -9
  240. package/.docs/reference/voice/voice.off.md +2 -2
  241. package/.docs/reference/voice/voice.on.md +2 -2
  242. package/.docs/reference/voice/voice.send.md +1 -1
  243. package/.docs/reference/voice/voice.speak.md +11 -11
  244. package/.docs/reference/voice/voice.updateConfig.md +3 -3
  245. package/.docs/reference/workflows/run-methods/cancel.md +2 -2
  246. package/.docs/reference/workflows/run-methods/restart.md +17 -5
  247. package/.docs/reference/workflows/run-methods/resume.md +23 -9
  248. package/.docs/reference/workflows/run-methods/start.md +22 -8
  249. package/.docs/reference/workflows/run-methods/startAsync.md +12 -6
  250. package/.docs/reference/workflows/run-methods/timeTravel.md +29 -13
  251. package/.docs/reference/workflows/run.md +12 -12
  252. package/.docs/reference/workflows/step.md +24 -26
  253. package/.docs/reference/workflows/workflow-methods/branch.md +2 -2
  254. package/.docs/reference/workflows/workflow-methods/commit.md +1 -1
  255. package/.docs/reference/workflows/workflow-methods/create-run.md +4 -4
  256. package/.docs/reference/workflows/workflow-methods/dountil.md +3 -3
  257. package/.docs/reference/workflows/workflow-methods/dowhile.md +3 -3
  258. package/.docs/reference/workflows/workflow-methods/foreach.md +9 -9
  259. package/.docs/reference/workflows/workflow-methods/map.md +2 -2
  260. package/.docs/reference/workflows/workflow-methods/parallel.md +2 -2
  261. package/.docs/reference/workflows/workflow-methods/sleep.md +2 -2
  262. package/.docs/reference/workflows/workflow-methods/sleepUntil.md +2 -2
  263. package/.docs/reference/workflows/workflow-methods/then.md +2 -2
  264. package/.docs/reference/workflows/workflow.md +40 -50
  265. package/.docs/reference/workspace/daytona-sandbox.md +33 -33
  266. package/.docs/reference/workspace/e2b-sandbox.md +20 -20
  267. package/.docs/reference/workspace/filesystem.md +22 -22
  268. package/.docs/reference/workspace/gcs-filesystem.md +15 -15
  269. package/.docs/reference/workspace/local-filesystem.md +35 -35
  270. package/.docs/reference/workspace/local-sandbox.md +26 -26
  271. package/.docs/reference/workspace/s3-filesystem.md +18 -18
  272. package/.docs/reference/workspace/sandbox.md +8 -8
  273. package/.docs/reference/workspace/workspace-class.md +30 -34
  274. package/CHANGELOG.md +16 -0
  275. package/package.json +6 -6
  276. 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:** (`string`): Convex deployment URL (e.g., https\://your-project.convex.cloud)
37
+ **deploymentUrl** (`string`): Convex deployment URL (e.g., https\://your-project.convex.cloud)
38
38
 
39
- **adminAuthToken:** (`string`): Convex admin authentication token
39
+ **adminAuthToken** (`string`): Convex admin authentication token
40
40
 
41
- **storageFunction?:** (`string`): Path to the storage mutation function (Default: `mastra/storage:handle`)
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:** (`string`): Name of the index to create
72
+ **indexName** (`string`): Name of the index to create
73
73
 
74
- **dimension:** (`number`): Vector dimension (must match your embedding model)
74
+ **dimension** (`number`): Vector dimension (must match your embedding model)
75
75
 
76
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (only cosine is currently supported) (Default: `cosine`)
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:** (`string`): Name of the index to upsert vectors into
87
+ **indexName** (`string`): Name of the index to upsert vectors into
88
88
 
89
- **vectors:** (`number[][]`): Array of embedding vectors
89
+ **vectors** (`number[][]`): Array of embedding vectors
90
90
 
91
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
91
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
92
92
 
93
- **ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
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:** (`string`): Name of the index to query
106
+ **indexName** (`string`): Name of the index to query
107
107
 
108
- **queryVector:** (`number[]`): Query vector
108
+ **queryVector** (`number[]`): Query vector
109
109
 
110
- **topK?:** (`number`): Number of results to return (Default: `10`)
110
+ **topK** (`number`): Number of results to return (Default: `10`)
111
111
 
112
- **filter?:** (`Record<string, any>`): Metadata filters
112
+ **filter** (`Record<string, any>`): Metadata filters
113
113
 
114
- **includeVector?:** (`boolean`): Whether to include the vector in the result (Default: `false`)
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:** (`string`): Name of the index to describe
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:** (`string`): Name of the index to delete
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:** (`string`): Name of the index containing the vector
162
+ **indexName** (`string`): Name of the index containing the vector
163
163
 
164
- **id?:** (`string`): ID of the vector to update (mutually exclusive with filter)
164
+ **id** (`string`): ID of the vector to update (mutually exclusive with filter)
165
165
 
166
- **filter?:** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
166
+ **filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
167
167
 
168
- **update:** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to 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:** (`string`): Name of the index containing the vector
193
+ **indexName** (`string`): Name of the index containing the vector
194
194
 
195
- **id:** (`string`): ID of the vector to delete
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:** (`string`): Name of the index containing the vectors to delete
205
+ **indexName** (`string`): Name of the index containing the vectors to delete
206
206
 
207
- **ids?:** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
207
+ **ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
208
208
 
209
- **filter?:** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
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:** (`string`): Unique identifier for this vector store instance
54
+ **id** (`string`): Unique identifier for this vector store instance
55
55
 
56
- **connectionString:** (`string`): Couchbase connection string
56
+ **connectionString** (`string`): Couchbase connection string
57
57
 
58
- **username:** (`string`): Couchbase username
58
+ **username** (`string`): Couchbase username
59
59
 
60
- **password:** (`string`): Couchbase password
60
+ **password** (`string`): Couchbase password
61
61
 
62
- **bucketName:** (`string`): Name of the Couchbase bucket to use
62
+ **bucketName** (`string`): Name of the Couchbase bucket to use
63
63
 
64
- **scopeName:** (`string`): Name of the Couchbase scope to use
64
+ **scopeName** (`string`): Name of the Couchbase scope to use
65
65
 
66
- **collectionName:** (`string`): Name of the Couchbase collection to use
66
+ **collectionName** (`string`): Name of the Couchbase collection to use
67
67
 
68
- **options?:** (`CouchbaseClientOptions`): Optional Couchbase client 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:** (`string`): Name of the index to create
78
+ **indexName** (`string`): Name of the index to create
79
79
 
80
- **dimension:** (`number`): Vector dimension (must match your embedding model)
80
+ **dimension** (`number`): Vector dimension (must match your embedding model)
81
81
 
82
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
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:** (`string`): Name of the index to insert into
90
+ **indexName** (`string`): Name of the index to insert into
91
91
 
92
- **vectors:** (`number[][]`): Array of embedding vectors
92
+ **vectors** (`number[][]`): Array of embedding vectors
93
93
 
94
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
94
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
95
95
 
96
- **ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
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:** (`string`): Name of the index to search in
104
+ **indexName** (`string`): Name of the index to search in
105
105
 
106
- **queryVector:** (`number[]`): Query vector to find similar vectors for
106
+ **queryVector** (`number[]`): Query vector to find similar vectors for
107
107
 
108
- **topK?:** (`number`): Number of results to return (Default: `10`)
108
+ **topK** (`number`): Number of results to return (Default: `10`)
109
109
 
110
- **filter?:** (`Record<string, any>`): Metadata filters
110
+ **filter** (`Record<string, any>`): Metadata filters
111
111
 
112
- **includeVector?:** (`boolean`): Whether to include vector data in results (Default: `false`)
112
+ **includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
113
113
 
114
- **minScore?:** (`number`): Minimum similarity score threshold (Default: `0`)
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:** (`string`): Name of the index to describe
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:** (`string`): Name of the index to delete
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:** (`string`): Name of the index containing the vector
148
+ **indexName** (`string`): Name of the index containing the vector
149
149
 
150
- **id:** (`string`): ID of the vector entry to update
150
+ **id** (`string`): ID of the vector entry to update
151
151
 
152
- **update:** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to 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:** (`string`): Name of the index containing the vector
158
+ **indexName** (`string`): Name of the index containing the vector
159
159
 
160
- **id:** (`string`): ID of the vector to delete
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:** (`string`): Name of the index containing the vectors to delete
166
+ **indexName** (`string`): Name of the index containing the vectors to delete
167
167
 
168
- **ids:** (`string[]`): Array of vector IDs to delete
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:** (`string`): Unique identifier for the vector store instance
78
+ **id** (`string`): Unique identifier for the vector store instance
79
79
 
80
- **path?:** (`string`): Database file path. Use ':memory:' for in-memory database, or a file path like './vectors.duckdb' for persistence. (Default: `':memory:'`)
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?:** (`number`): Default dimension for vector embeddings (Default: `1536`)
82
+ **dimensions** (`number`): Default dimension for vector embeddings (Default: `1536`)
83
83
 
84
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Default distance metric for similarity search (Default: `cosine`)
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:** (`string`): Name of the index to create
92
+ **indexName** (`string`): Name of the index to create
93
93
 
94
- **dimension:** (`number`): Vector dimension size (must match your embedding model)
94
+ **dimension** (`number`): Vector dimension size (must match your embedding model)
95
95
 
96
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
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:** (`string`): Name of the index to insert into
102
+ **indexName** (`string`): Name of the index to insert into
103
103
 
104
- **vectors:** (`number[][]`): Array of embedding vectors
104
+ **vectors** (`number[][]`): Array of embedding vectors
105
105
 
106
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
106
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
107
107
 
108
- **ids?:** (`string[]`): Optional vector IDs (auto-generated UUIDs if not provided)
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:** (`string`): Name of the index to search in
114
+ **indexName** (`string`): Name of the index to search in
115
115
 
116
- **queryVector:** (`number[]`): Query vector to find similar vectors for
116
+ **queryVector** (`number[]`): Query vector to find similar vectors for
117
117
 
118
- **topK?:** (`number`): Number of results to return (Default: `10`)
118
+ **topK** (`number`): Number of results to return (Default: `10`)
119
119
 
120
- **filter?:** (`Filter`): Metadata filters using MongoDB-like query syntax
120
+ **filter** (`Filter`): Metadata filters using MongoDB-like query syntax
121
121
 
122
- **includeVector?:** (`boolean`): Whether to include vector data in results (Default: `false`)
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:** (`string`): Name of the index to describe
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:** (`string`): Name of the index to delete
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:** (`string`): Name of the index containing the vector
156
+ **indexName** (`string`): Name of the index containing the vector
157
157
 
158
- **id?:** (`string`): ID of the vector entry to update (mutually exclusive with filter)
158
+ **id** (`string`): ID of the vector entry to update (mutually exclusive with filter)
159
159
 
160
- **filter?:** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
160
+ **filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
161
161
 
162
- **update:** (`object`): Update data containing vector and/or metadata
162
+ **update** (`object`): Update data containing vector and/or metadata
163
163
 
164
- **update.vector?:** (`number[]`): New vector data to update
164
+ **update.vector** (`number[]`): New vector data to update
165
165
 
166
- **update.metadata?:** (`Record<string, any>`): New metadata to update
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:** (`string`): Name of the index containing the vector
172
+ **indexName** (`string`): Name of the index containing the vector
173
173
 
174
- **id:** (`string`): ID of the vector entry to delete
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:** (`string`): Name of the index containing the vectors to delete
180
+ **indexName** (`string`): Name of the index containing the vectors to delete
181
181
 
182
- **ids?:** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
182
+ **ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
183
183
 
184
- **filter?:** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
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:** (`string`): Unique identifier for this vector store instance
70
+ **id** (`string`): Unique identifier for this vector store instance
71
71
 
72
- **url:** (`string`): ElasticSearch connection URL (e.g., 'http\://localhost:9200')
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:** (`string`): Name of the index to create
80
+ **indexName** (`string`): Name of the index to create
81
81
 
82
- **dimension:** (`number`): Vector dimension (must match your embedding model)
82
+ **dimension** (`number`): Vector dimension (must match your embedding model)
83
83
 
84
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
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:** (`string`): Name of the index to insert into
90
+ **indexName** (`string`): Name of the index to insert into
91
91
 
92
- **vectors:** (`number[][]`): Array of embedding vectors
92
+ **vectors** (`number[][]`): Array of embedding vectors
93
93
 
94
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
94
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
95
95
 
96
- **ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
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:** (`string`): Name of the index to search in
102
+ **indexName** (`string`): Name of the index to search in
103
103
 
104
- **queryVector:** (`number[]`): Query vector to find similar vectors for
104
+ **queryVector** (`number[]`): Query vector to find similar vectors for
105
105
 
106
- **topK?:** (`number`): Number of results to return (Default: `10`)
106
+ **topK** (`number`): Number of results to return (Default: `10`)
107
107
 
108
- **filter?:** (`Record<string, any>`): Metadata filters
108
+ **filter** (`Record<string, any>`): Metadata filters
109
109
 
110
- **includeVector?:** (`boolean`): Whether to include vector data in results (Default: `false`)
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:** (`string`): Name of the index to describe
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:** (`string`): Name of the index to delete
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:** (`string`): Name of the index containing the vector
144
+ **indexName** (`string`): Name of the index containing the vector
145
145
 
146
- **id?:** (`string`): ID of the vector to update (mutually exclusive with filter)
146
+ **id** (`string`): ID of the vector to update (mutually exclusive with filter)
147
147
 
148
- **filter?:** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
148
+ **filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
149
149
 
150
- **update:** (`object`): Update data containing vector and/or metadata
150
+ **update** (`object`): Update data containing vector and/or metadata
151
151
 
152
- **update.vector?:** (`number[]`): New vector data
152
+ **update.vector** (`number[]`): New vector data
153
153
 
154
- **update.metadata?:** (`Record<string, any>`): New 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:** (`string`): Name of the index containing the vector
160
+ **indexName** (`string`): Name of the index containing the vector
161
161
 
162
- **id:** (`string`): ID of the vector to delete
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:** (`string`): Name of the index containing the vectors to delete
168
+ **indexName** (`string`): Name of the index containing the vectors to delete
169
169
 
170
- **ids?:** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
170
+ **ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
171
171
 
172
- **filter?:** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
172
+ **filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
173
173
 
174
174
  ## Response Types
175
175