@mastra/mcp-docs-server 1.1.7 → 1.1.8
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
|
@@ -4,49 +4,49 @@ The TurbopufferVector class provides vector search using [Turbopuffer](https://t
|
|
|
4
4
|
|
|
5
5
|
## Constructor Options
|
|
6
6
|
|
|
7
|
-
**apiKey
|
|
7
|
+
**apiKey** (`string`): The API key to authenticate with Turbopuffer
|
|
8
8
|
|
|
9
|
-
**baseUrl
|
|
9
|
+
**baseUrl** (`string`): The base URL for the Turbopuffer API (Default: `https://api.turbopuffer.com`)
|
|
10
10
|
|
|
11
|
-
**connectTimeout
|
|
11
|
+
**connectTimeout** (`number`): The timeout to establish a connection, in ms. Only applicable in Node and Deno. (Default: `10000`)
|
|
12
12
|
|
|
13
|
-
**connectionIdleTimeout
|
|
13
|
+
**connectionIdleTimeout** (`number`): The socket idle timeout, in ms. Only applicable in Node and Deno. (Default: `60000`)
|
|
14
14
|
|
|
15
|
-
**warmConnections
|
|
15
|
+
**warmConnections** (`number`): The number of connections to open initially when creating a new client. (Default: `0`)
|
|
16
16
|
|
|
17
|
-
**compression
|
|
17
|
+
**compression** (`boolean`): Whether to compress requests and accept compressed responses. (Default: `true`)
|
|
18
18
|
|
|
19
|
-
**schemaConfigForIndex
|
|
19
|
+
**schemaConfigForIndex** (`function`): A callback function that takes an index name and returns a config object for that index. This allows you to define explicit schemas per index.
|
|
20
20
|
|
|
21
21
|
## Methods
|
|
22
22
|
|
|
23
23
|
### createIndex()
|
|
24
24
|
|
|
25
|
-
**indexName
|
|
25
|
+
**indexName** (`string`): Name of the index to create
|
|
26
26
|
|
|
27
|
-
**dimension
|
|
27
|
+
**dimension** (`number`): Vector dimension (must match your embedding model)
|
|
28
28
|
|
|
29
|
-
**metric
|
|
29
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
30
30
|
|
|
31
31
|
### upsert()
|
|
32
32
|
|
|
33
|
-
**vectors
|
|
33
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
34
34
|
|
|
35
|
-
**metadata
|
|
35
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
36
36
|
|
|
37
|
-
**ids
|
|
37
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
38
38
|
|
|
39
39
|
### query()
|
|
40
40
|
|
|
41
|
-
**indexName
|
|
41
|
+
**indexName** (`string`): Name of the index to query
|
|
42
42
|
|
|
43
|
-
**queryVector
|
|
43
|
+
**queryVector** (`number[]`): Query vector to find similar vectors
|
|
44
44
|
|
|
45
|
-
**topK
|
|
45
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
46
46
|
|
|
47
|
-
**filter
|
|
47
|
+
**filter** (`Record<string, any>`): Metadata filters for the query
|
|
48
48
|
|
|
49
|
-
**includeVector
|
|
49
|
+
**includeVector** (`boolean`): Whether to include vectors in the results (Default: `false`)
|
|
50
50
|
|
|
51
51
|
### listIndexes()
|
|
52
52
|
|
|
@@ -54,7 +54,7 @@ Returns an array of index names as strings.
|
|
|
54
54
|
|
|
55
55
|
### describeIndex()
|
|
56
56
|
|
|
57
|
-
**indexName
|
|
57
|
+
**indexName** (`string`): Name of the index to describe
|
|
58
58
|
|
|
59
59
|
Returns:
|
|
60
60
|
|
|
@@ -68,35 +68,35 @@ interface IndexStats {
|
|
|
68
68
|
|
|
69
69
|
### deleteIndex()
|
|
70
70
|
|
|
71
|
-
**indexName
|
|
71
|
+
**indexName** (`string`): Name of the index to delete
|
|
72
72
|
|
|
73
73
|
### updateVector()
|
|
74
74
|
|
|
75
75
|
Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
|
|
76
76
|
|
|
77
|
-
**indexName
|
|
77
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
78
78
|
|
|
79
|
-
**id
|
|
79
|
+
**id** (`string`): ID of the vector to update (mutually exclusive with filter)
|
|
80
80
|
|
|
81
|
-
**filter
|
|
81
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
|
|
82
82
|
|
|
83
|
-
**update
|
|
83
|
+
**update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
|
|
84
84
|
|
|
85
85
|
### deleteVector()
|
|
86
86
|
|
|
87
|
-
**indexName
|
|
87
|
+
**indexName** (`string`): Name of the index containing the vector
|
|
88
88
|
|
|
89
|
-
**id
|
|
89
|
+
**id** (`string`): ID of the vector to delete
|
|
90
90
|
|
|
91
91
|
### deleteVectors()
|
|
92
92
|
|
|
93
93
|
Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
|
|
94
94
|
|
|
95
|
-
**indexName
|
|
95
|
+
**indexName** (`string`): Name of the index containing the vectors to delete
|
|
96
96
|
|
|
97
|
-
**ids
|
|
97
|
+
**ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
|
|
98
98
|
|
|
99
|
-
**filter
|
|
99
|
+
**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
|
|
100
100
|
|
|
101
101
|
## Response Types
|
|
102
102
|
|
|
@@ -4,9 +4,9 @@ The UpstashVector class provides vector search using [Upstash Vector](https://up
|
|
|
4
4
|
|
|
5
5
|
## Constructor Options
|
|
6
6
|
|
|
7
|
-
**url
|
|
7
|
+
**url** (`string`): Upstash Vector database URL
|
|
8
8
|
|
|
9
|
-
**token
|
|
9
|
+
**token** (`string`): Upstash Vector API token
|
|
10
10
|
|
|
11
11
|
## Methods
|
|
12
12
|
|
|
@@ -14,41 +14,41 @@ The UpstashVector class provides vector search using [Upstash Vector](https://up
|
|
|
14
14
|
|
|
15
15
|
Note: This method is a no-op for Upstash as indexes are created automatically.
|
|
16
16
|
|
|
17
|
-
**indexName
|
|
17
|
+
**indexName** (`string`): Name of the index to create
|
|
18
18
|
|
|
19
|
-
**dimension
|
|
19
|
+
**dimension** (`number`): Vector dimension (must match your embedding model)
|
|
20
20
|
|
|
21
|
-
**metric
|
|
21
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
|
|
22
22
|
|
|
23
23
|
### upsert()
|
|
24
24
|
|
|
25
|
-
**indexName
|
|
25
|
+
**indexName** (`string`): Name of the index to upsert into
|
|
26
26
|
|
|
27
|
-
**vectors
|
|
27
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
28
28
|
|
|
29
|
-
**sparseVectors
|
|
29
|
+
**sparseVectors** (`{ indices: number[], values: number[] }[]`): Array of sparse vectors for hybrid search. Each sparse vector must have matching indices and values arrays.
|
|
30
30
|
|
|
31
|
-
**metadata
|
|
31
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
32
32
|
|
|
33
|
-
**ids
|
|
33
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
34
34
|
|
|
35
35
|
### query()
|
|
36
36
|
|
|
37
|
-
**indexName
|
|
37
|
+
**indexName** (`string`): Name of the index to query
|
|
38
38
|
|
|
39
|
-
**queryVector
|
|
39
|
+
**queryVector** (`number[]`): Query vector to find similar vectors
|
|
40
40
|
|
|
41
|
-
**sparseVector
|
|
41
|
+
**sparseVector** (`{ indices: number[], values: number[] }`): Optional sparse vector for hybrid search. Must have matching indices and values arrays.
|
|
42
42
|
|
|
43
|
-
**topK
|
|
43
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
44
44
|
|
|
45
|
-
**filter
|
|
45
|
+
**filter** (`Record<string, any>`): Metadata filters for the query
|
|
46
46
|
|
|
47
|
-
**includeVector
|
|
47
|
+
**includeVector** (`boolean`): Whether to include vectors in the results (Default: `false`)
|
|
48
48
|
|
|
49
|
-
**fusionAlgorithm
|
|
49
|
+
**fusionAlgorithm** (`FusionAlgorithm`): Algorithm used to combine dense and sparse search results in hybrid search (e.g., RRF - Reciprocal Rank Fusion)
|
|
50
50
|
|
|
51
|
-
**queryMode
|
|
51
|
+
**queryMode** (`QueryMode`): Search mode: 'DENSE' for dense-only, 'SPARSE' for sparse-only, or 'HYBRID' for combined search
|
|
52
52
|
|
|
53
53
|
### listIndexes()
|
|
54
54
|
|
|
@@ -56,7 +56,7 @@ Returns an array of index names (namespaces) as strings.
|
|
|
56
56
|
|
|
57
57
|
### describeIndex()
|
|
58
58
|
|
|
59
|
-
**indexName
|
|
59
|
+
**indexName** (`string`): Name of the index to describe
|
|
60
60
|
|
|
61
61
|
Returns:
|
|
62
62
|
|
|
@@ -70,15 +70,15 @@ interface IndexStats {
|
|
|
70
70
|
|
|
71
71
|
### deleteIndex()
|
|
72
72
|
|
|
73
|
-
**indexName
|
|
73
|
+
**indexName** (`string`): Name of the index (namespace) to delete
|
|
74
74
|
|
|
75
75
|
### updateVector()
|
|
76
76
|
|
|
77
|
-
**indexName
|
|
77
|
+
**indexName** (`string`): Name of the index to update
|
|
78
78
|
|
|
79
|
-
**id
|
|
79
|
+
**id** (`string`): ID of the item to update
|
|
80
80
|
|
|
81
|
-
**update
|
|
81
|
+
**update** (`object`): Update object containing vector, sparse vector, and/or metadata
|
|
82
82
|
|
|
83
83
|
The `update` object can have the following properties:
|
|
84
84
|
|
|
@@ -88,9 +88,9 @@ The `update` object can have the following properties:
|
|
|
88
88
|
|
|
89
89
|
### deleteVector()
|
|
90
90
|
|
|
91
|
-
**indexName
|
|
91
|
+
**indexName** (`string`): Name of the index from which to delete the item
|
|
92
92
|
|
|
93
|
-
**id
|
|
93
|
+
**id** (`string`): ID of the item to delete
|
|
94
94
|
|
|
95
95
|
Attempts to delete an item by its ID from the specified index. Logs an error message if the deletion fails.
|
|
96
96
|
|
|
@@ -4,41 +4,41 @@ The CloudflareVector class provides vector search using [Cloudflare Vectorize](h
|
|
|
4
4
|
|
|
5
5
|
## Constructor Options
|
|
6
6
|
|
|
7
|
-
**accountId
|
|
7
|
+
**accountId** (`string`): Cloudflare account ID
|
|
8
8
|
|
|
9
|
-
**apiToken
|
|
9
|
+
**apiToken** (`string`): Cloudflare API token with Vectorize permissions
|
|
10
10
|
|
|
11
11
|
## Methods
|
|
12
12
|
|
|
13
13
|
### createIndex()
|
|
14
14
|
|
|
15
|
-
**indexName
|
|
15
|
+
**indexName** (`string`): Name of the index to create
|
|
16
16
|
|
|
17
|
-
**dimension
|
|
17
|
+
**dimension** (`number`): Vector dimension (must match your embedding model)
|
|
18
18
|
|
|
19
|
-
**metric
|
|
19
|
+
**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (dotproduct maps to dot-product) (Default: `cosine`)
|
|
20
20
|
|
|
21
21
|
### upsert()
|
|
22
22
|
|
|
23
|
-
**indexName
|
|
23
|
+
**indexName** (`string`): Name of the index to upsert into
|
|
24
24
|
|
|
25
|
-
**vectors
|
|
25
|
+
**vectors** (`number[][]`): Array of embedding vectors
|
|
26
26
|
|
|
27
|
-
**metadata
|
|
27
|
+
**metadata** (`Record<string, any>[]`): Metadata for each vector
|
|
28
28
|
|
|
29
|
-
**ids
|
|
29
|
+
**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
|
|
30
30
|
|
|
31
31
|
### query()
|
|
32
32
|
|
|
33
|
-
**indexName
|
|
33
|
+
**indexName** (`string`): Name of the index to query
|
|
34
34
|
|
|
35
|
-
**queryVector
|
|
35
|
+
**queryVector** (`number[]`): Query vector to find similar vectors
|
|
36
36
|
|
|
37
|
-
**topK
|
|
37
|
+
**topK** (`number`): Number of results to return (Default: `10`)
|
|
38
38
|
|
|
39
|
-
**filter
|
|
39
|
+
**filter** (`Record<string, any>`): Metadata filters for the query
|
|
40
40
|
|
|
41
|
-
**includeVector
|
|
41
|
+
**includeVector** (`boolean`): Whether to include vectors in the results (Default: `false`)
|
|
42
42
|
|
|
43
43
|
### listIndexes()
|
|
44
44
|
|
|
@@ -46,7 +46,7 @@ Returns an array of index names as strings.
|
|
|
46
46
|
|
|
47
47
|
### describeIndex()
|
|
48
48
|
|
|
49
|
-
**indexName
|
|
49
|
+
**indexName** (`string`): Name of the index to describe
|
|
50
50
|
|
|
51
51
|
Returns:
|
|
52
52
|
|
|
@@ -60,49 +60,49 @@ interface IndexStats {
|
|
|
60
60
|
|
|
61
61
|
### deleteIndex()
|
|
62
62
|
|
|
63
|
-
**indexName
|
|
63
|
+
**indexName** (`string`): Name of the index to delete
|
|
64
64
|
|
|
65
65
|
### createMetadataIndex()
|
|
66
66
|
|
|
67
67
|
Creates an index on a metadata field to enable filtering.
|
|
68
68
|
|
|
69
|
-
**indexName
|
|
69
|
+
**indexName** (`string`): Name of the index containing the metadata field
|
|
70
70
|
|
|
71
|
-
**propertyName
|
|
71
|
+
**propertyName** (`string`): Name of the metadata field to index
|
|
72
72
|
|
|
73
|
-
**indexType
|
|
73
|
+
**indexType** (`'string' | 'number' | 'boolean'`): Type of the metadata field
|
|
74
74
|
|
|
75
75
|
### deleteMetadataIndex()
|
|
76
76
|
|
|
77
77
|
Removes an index from a metadata field.
|
|
78
78
|
|
|
79
|
-
**indexName
|
|
79
|
+
**indexName** (`string`): Name of the index containing the metadata field
|
|
80
80
|
|
|
81
|
-
**propertyName
|
|
81
|
+
**propertyName** (`string`): Name of the metadata field to remove indexing from
|
|
82
82
|
|
|
83
83
|
### listMetadataIndexes()
|
|
84
84
|
|
|
85
85
|
Lists all metadata field indexes for an index.
|
|
86
86
|
|
|
87
|
-
**indexName
|
|
87
|
+
**indexName** (`string`): Name of the index to list metadata indexes for
|
|
88
88
|
|
|
89
89
|
### updateVector()
|
|
90
90
|
|
|
91
91
|
Updates a vector or metadata for a specific ID within an index.
|
|
92
92
|
|
|
93
|
-
**indexName
|
|
93
|
+
**indexName** (`string`): Name of the index containing the ID to update
|
|
94
94
|
|
|
95
|
-
**id
|
|
95
|
+
**id** (`string`): Unique identifier of the vector or metadata to update
|
|
96
96
|
|
|
97
|
-
**update
|
|
97
|
+
**update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
|
|
98
98
|
|
|
99
99
|
### deleteVector()
|
|
100
100
|
|
|
101
101
|
Deletes a vector and its associated metadata for a specific ID within an index.
|
|
102
102
|
|
|
103
|
-
**indexName
|
|
103
|
+
**indexName** (`string`): Name of the index containing the ID to delete
|
|
104
104
|
|
|
105
|
-
**id
|
|
105
|
+
**id** (`string`): Unique identifier of the vector and metadata to delete
|
|
106
106
|
|
|
107
107
|
## Response Types
|
|
108
108
|
|
|
@@ -37,23 +37,27 @@ const text = await voice.listen(audioStream)
|
|
|
37
37
|
|
|
38
38
|
### Constructor Options
|
|
39
39
|
|
|
40
|
-
**speechModel
|
|
40
|
+
**speechModel** (`AzureSpeechConfig`): Configuration for text-to-speech synthesis.
|
|
41
41
|
|
|
42
|
-
**
|
|
42
|
+
**speechModel.apiKey** (`string`): Azure Speech Services API key (NOT Azure OpenAI key). Falls back to AZURE\_API\_KEY environment variable.
|
|
43
43
|
|
|
44
|
-
**
|
|
44
|
+
**speechModel.region** (`string`): Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE\_REGION environment variable.
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
**speechModel.voiceName** (`string`): Voice ID for speech synthesis (e.g., 'en-US-AriaNeural', 'en-US-JennyNeural'). Only used in speechModel. See voice list below.
|
|
47
47
|
|
|
48
|
-
|
|
48
|
+
**speechModel.language** (`string`): Recognition language code (e.g., 'en-US', 'fr-FR'). Only used in listeningModel.
|
|
49
49
|
|
|
50
|
-
**
|
|
50
|
+
**listeningModel** (`AzureSpeechConfig`): Configuration for speech-to-text recognition.
|
|
51
51
|
|
|
52
|
-
**
|
|
52
|
+
**listeningModel.apiKey** (`string`): Azure Speech Services API key (NOT Azure OpenAI key). Falls back to AZURE\_API\_KEY environment variable.
|
|
53
53
|
|
|
54
|
-
**
|
|
54
|
+
**listeningModel.region** (`string`): Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE\_REGION environment variable.
|
|
55
55
|
|
|
56
|
-
**
|
|
56
|
+
**listeningModel.voiceName** (`string`): Voice ID for speech synthesis (e.g., 'en-US-AriaNeural', 'en-US-JennyNeural'). Only used in speechModel. See voice list below.
|
|
57
|
+
|
|
58
|
+
**listeningModel.language** (`string`): Recognition language code (e.g., 'en-US', 'fr-FR'). Only used in listeningModel.
|
|
59
|
+
|
|
60
|
+
**speaker** (`string`): Default voice ID for speech synthesis.
|
|
57
61
|
|
|
58
62
|
## Methods
|
|
59
63
|
|
|
@@ -61,9 +65,9 @@ Configuration object for speech synthesis (`speechModel`) and recognition (`list
|
|
|
61
65
|
|
|
62
66
|
Converts text to speech using Azure's neural text-to-speech service.
|
|
63
67
|
|
|
64
|
-
**input
|
|
68
|
+
**input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
|
|
65
69
|
|
|
66
|
-
**options.speaker
|
|
70
|
+
**options.speaker** (`string`): Voice ID to use for speech synthesis (e.g., 'en-US-JennyNeural'). Overrides the default voice. (Default: `Constructor's speaker value`)
|
|
67
71
|
|
|
68
72
|
Returns: `Promise<NodeJS.ReadableStream>` - Audio stream in WAV format
|
|
69
73
|
|
|
@@ -71,7 +75,7 @@ Returns: `Promise<NodeJS.ReadableStream>` - Audio stream in WAV format
|
|
|
71
75
|
|
|
72
76
|
Transcribes audio using Azure's speech-to-text service.
|
|
73
77
|
|
|
74
|
-
**audioStream
|
|
78
|
+
**audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe. Must be in WAV format.
|
|
75
79
|
|
|
76
80
|
Returns: `Promise<string>` - The recognized text from the audio
|
|
77
81
|
|
|
@@ -81,11 +85,11 @@ Returns: `Promise<string>` - The recognized text from the audio
|
|
|
81
85
|
|
|
82
86
|
Returns an array of available voice options (200+ voices), where each node contains:
|
|
83
87
|
|
|
84
|
-
**voiceId
|
|
88
|
+
**voiceId** (`string`): Unique identifier for the voice (e.g., 'en-US-JennyNeural', 'fr-FR-DeniseNeural')
|
|
85
89
|
|
|
86
|
-
**language
|
|
90
|
+
**language** (`string`): Language code extracted from voice ID (e.g., 'en', 'fr')
|
|
87
91
|
|
|
88
|
-
**region
|
|
92
|
+
**region** (`string`): Region code extracted from voice ID (e.g., 'US', 'GB', 'FR')
|
|
89
93
|
|
|
90
94
|
Returns: `Promise<Array<{ voiceId: string; language: string; region: string; }>>`
|
|
91
95
|
|
|
@@ -31,17 +31,15 @@ console.log(speakers)
|
|
|
31
31
|
|
|
32
32
|
### Constructor Options
|
|
33
33
|
|
|
34
|
-
**speechModel
|
|
34
|
+
**speechModel** (`CloudflareSpeechConfig`): Configuration for text-to-speech synthesis.
|
|
35
35
|
|
|
36
|
-
**
|
|
36
|
+
**speechModel.name** (`string`): Model name to use for TTS.
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
**speechModel.apiKey** (`string`): Cloudflare API token with Workers AI access. Falls back to CLOUDFLARE\_API\_TOKEN environment variable.
|
|
39
39
|
|
|
40
|
-
**
|
|
40
|
+
**speechModel.accountId** (`string`): Cloudflare account ID. Falls back to CLOUDFLARE\_ACCOUNT\_ID environment variable.
|
|
41
41
|
|
|
42
|
-
**
|
|
43
|
-
|
|
44
|
-
**accountId?:** (`string`): Cloudflare account ID. Falls back to CLOUDFLARE\_ACCOUNT\_ID environment variable.
|
|
42
|
+
**speaker** (`string`): Default voice ID for speech synthesis. (Default: `'en-US-1'`)
|
|
45
43
|
|
|
46
44
|
## Methods
|
|
47
45
|
|
|
@@ -49,11 +47,11 @@ console.log(speakers)
|
|
|
49
47
|
|
|
50
48
|
Converts text to speech using Cloudflare's text-to-speech service.
|
|
51
49
|
|
|
52
|
-
**input
|
|
50
|
+
**input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
|
|
53
51
|
|
|
54
|
-
**options.speaker
|
|
52
|
+
**options.speaker** (`string`): Voice ID to use for speech synthesis. (Default: `Constructor's speaker value`)
|
|
55
53
|
|
|
56
|
-
**options.format
|
|
54
|
+
**options.format** (`string`): Output audio format. (Default: `'mp3'`)
|
|
57
55
|
|
|
58
56
|
Returns: `Promise<NodeJS.ReadableStream>`
|
|
59
57
|
|
|
@@ -61,9 +59,9 @@ Returns: `Promise<NodeJS.ReadableStream>`
|
|
|
61
59
|
|
|
62
60
|
Returns an array of available voice options, where each node contains:
|
|
63
61
|
|
|
64
|
-
**voiceId
|
|
62
|
+
**voiceId** (`string`): Unique identifier for the voice (e.g., 'en-US-1')
|
|
65
63
|
|
|
66
|
-
**language
|
|
64
|
+
**language** (`string`): Language code of the voice (e.g., 'en-US')
|
|
67
65
|
|
|
68
66
|
## Notes
|
|
69
67
|
|
|
@@ -6,13 +6,13 @@ CompositeVoice supports both Mastra voice providers and AI SDK model providers
|
|
|
6
6
|
|
|
7
7
|
## Constructor Parameters
|
|
8
8
|
|
|
9
|
-
**config
|
|
9
|
+
**config** (`object`): Configuration object for the composite voice service
|
|
10
10
|
|
|
11
|
-
**config.input
|
|
11
|
+
**config.input** (`MastraVoice | TranscriptionModel`): Voice provider or AI SDK transcription model to use for speech-to-text operations. AI SDK models are automatically wrapped.
|
|
12
12
|
|
|
13
|
-
**config.output
|
|
13
|
+
**config.output** (`MastraVoice | SpeechModel`): Voice provider or AI SDK speech model to use for text-to-speech operations. AI SDK models are automatically wrapped.
|
|
14
14
|
|
|
15
|
-
**config.realtime
|
|
15
|
+
**config.realtime** (`MastraVoice`): Voice provider to use for real-time speech-to-speech operations
|
|
16
16
|
|
|
17
17
|
## Methods
|
|
18
18
|
|
|
@@ -20,9 +20,9 @@ CompositeVoice supports both Mastra voice providers and AI SDK model providers
|
|
|
20
20
|
|
|
21
21
|
Converts text to speech using the configured speaking provider.
|
|
22
22
|
|
|
23
|
-
**input
|
|
23
|
+
**input** (`string | NodeJS.ReadableStream`): Text to convert to speech
|
|
24
24
|
|
|
25
|
-
**options
|
|
25
|
+
**options** (`object`): Provider-specific options passed to the speaking provider
|
|
26
26
|
|
|
27
27
|
Notes:
|
|
28
28
|
|
|
@@ -34,9 +34,9 @@ Notes:
|
|
|
34
34
|
|
|
35
35
|
Converts speech to text using the configured listening provider.
|
|
36
36
|
|
|
37
|
-
**audioStream
|
|
37
|
+
**audioStream** (`NodeJS.ReadableStream`): Audio stream to convert to text
|
|
38
38
|
|
|
39
|
-
**options
|
|
39
|
+
**options** (`object`): Provider-specific options passed to the listening provider
|
|
40
40
|
|
|
41
41
|
Notes:
|
|
42
42
|
|
|
@@ -48,9 +48,9 @@ Notes:
|
|
|
48
48
|
|
|
49
49
|
Returns a list of available voices from the speaking provider, where each node contains:
|
|
50
50
|
|
|
51
|
-
**voiceId
|
|
51
|
+
**voiceId** (`string`): Unique identifier for the voice
|
|
52
52
|
|
|
53
|
-
**key
|
|
53
|
+
**key** (`value`): Additional voice properties that vary by provider (e.g., name, language)
|
|
54
54
|
|
|
55
55
|
Notes:
|
|
56
56
|
|
|
@@ -32,21 +32,27 @@ const transcript = await voice.listen(audioStream)
|
|
|
32
32
|
|
|
33
33
|
## Constructor Parameters
|
|
34
34
|
|
|
35
|
-
**speechModel
|
|
35
|
+
**speechModel** (`DeepgramVoiceConfig`): Configuration for text-to-speech functionality. (Default: `{ name: 'aura' }`)
|
|
36
36
|
|
|
37
|
-
**
|
|
37
|
+
**speechModel.name** (`DeepgramModel`): The Deepgram model to use
|
|
38
38
|
|
|
39
|
-
**
|
|
39
|
+
**speechModel.apiKey** (`string`): Deepgram API key. Falls back to DEEPGRAM\_API\_KEY environment variable
|
|
40
40
|
|
|
41
|
-
|
|
41
|
+
**speechModel.properties** (`Record<string, any>`): Additional properties to pass to the Deepgram API
|
|
42
42
|
|
|
43
|
-
**
|
|
43
|
+
**speechModel.language** (`string`): Language code for the model
|
|
44
44
|
|
|
45
|
-
**
|
|
45
|
+
**listeningModel** (`DeepgramVoiceConfig`): Configuration for speech-to-text functionality. (Default: `{ name: 'nova' }`)
|
|
46
46
|
|
|
47
|
-
**
|
|
47
|
+
**listeningModel.name** (`DeepgramModel`): The Deepgram model to use
|
|
48
48
|
|
|
49
|
-
**
|
|
49
|
+
**listeningModel.apiKey** (`string`): Deepgram API key. Falls back to DEEPGRAM\_API\_KEY environment variable
|
|
50
|
+
|
|
51
|
+
**listeningModel.properties** (`Record<string, any>`): Additional properties to pass to the Deepgram API
|
|
52
|
+
|
|
53
|
+
**listeningModel.language** (`string`): Language code for the model
|
|
54
|
+
|
|
55
|
+
**speaker** (`DeepgramVoiceId`): Default voice to use for text-to-speech (Default: `'asteria-en'`)
|
|
50
56
|
|
|
51
57
|
## Methods
|
|
52
58
|
|
|
@@ -54,11 +60,11 @@ const transcript = await voice.listen(audioStream)
|
|
|
54
60
|
|
|
55
61
|
Converts text to speech using the configured speech model and voice.
|
|
56
62
|
|
|
57
|
-
**input
|
|
63
|
+
**input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
|
|
58
64
|
|
|
59
|
-
**options
|
|
65
|
+
**options** (`object`): Additional options for speech synthesis
|
|
60
66
|
|
|
61
|
-
**options.speaker
|
|
67
|
+
**options.speaker** (`string`): Override the default speaker for this request
|
|
62
68
|
|
|
63
69
|
Returns: `Promise<NodeJS.ReadableStream>`
|
|
64
70
|
|
|
@@ -66,9 +72,9 @@ Returns: `Promise<NodeJS.ReadableStream>`
|
|
|
66
72
|
|
|
67
73
|
Converts speech to text using the configured listening model.
|
|
68
74
|
|
|
69
|
-
**audioStream
|
|
75
|
+
**audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe
|
|
70
76
|
|
|
71
|
-
**options
|
|
77
|
+
**options** (`object`): Additional options to pass to the Deepgram API
|
|
72
78
|
|
|
73
79
|
Returns: `Promise<string>`
|
|
74
80
|
|
|
@@ -76,4 +82,4 @@ Returns: `Promise<string>`
|
|
|
76
82
|
|
|
77
83
|
Returns a list of available voice options.
|
|
78
84
|
|
|
79
|
-
**voiceId
|
|
85
|
+
**voiceId** (`string`): Unique identifier for the voice
|