@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
|
@@ -35,45 +35,53 @@ const rerankedResults = await rerank({
|
|
|
35
35
|
|
|
36
36
|
## Parameters
|
|
37
37
|
|
|
38
|
-
**results
|
|
38
|
+
**results** (`QueryResult[]`): The vector search results to rerank
|
|
39
39
|
|
|
40
|
-
**query
|
|
40
|
+
**query** (`string`): The search query text used to evaluate relevance
|
|
41
41
|
|
|
42
|
-
**scorer
|
|
42
|
+
**scorer** (`RelevanceScoreProvider`): The relevance scorer to use for reranking
|
|
43
43
|
|
|
44
|
-
**options
|
|
44
|
+
**options** (`RerankerFunctionOptions`): Options for the reranking model
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
**options.weights** (`WeightConfig`): Weights for different scoring components (must add up to 1)
|
|
47
47
|
|
|
48
|
-
|
|
48
|
+
**options.weights.semantic** (`number (default: 0.4)`): Weight for semantic relevance
|
|
49
|
+
|
|
50
|
+
**options.weights.vector** (`number (default: 0.4)`): Weight for vector similarity
|
|
51
|
+
|
|
52
|
+
**options.weights.position** (`number (default: 0.2)`): Weight for position-based scoring
|
|
49
53
|
|
|
50
|
-
|
|
54
|
+
**options.queryEmbedding** (`number[]`): Embedding of the query
|
|
51
55
|
|
|
52
|
-
**
|
|
56
|
+
**options.topK** (`number`): Number of top results to return
|
|
53
57
|
|
|
54
|
-
|
|
58
|
+
The `rerankWithScorer` function accepts any `RelevanceScoreProvider` from @mastra/rag.
|
|
55
59
|
|
|
56
|
-
**
|
|
60
|
+
> **Note:** For semantic scoring to work properly during re-ranking, each result must include the text content in its `metadata.text` field.
|
|
57
61
|
|
|
58
62
|
## Returns
|
|
59
63
|
|
|
60
64
|
The function returns an array of `RerankResult` objects:
|
|
61
65
|
|
|
62
|
-
**result
|
|
66
|
+
**result** (`QueryResult`): The original query result
|
|
63
67
|
|
|
64
|
-
**score
|
|
68
|
+
**score** (`number`): Combined reranking score (0-1)
|
|
65
69
|
|
|
66
|
-
**details
|
|
70
|
+
**details** (`ScoringDetails`): Detailed scoring information
|
|
67
71
|
|
|
68
72
|
### ScoringDetails
|
|
69
73
|
|
|
70
|
-
**semantic
|
|
74
|
+
**semantic** (`number`): Semantic relevance score (0-1)
|
|
75
|
+
|
|
76
|
+
**vector** (`number`): Vector similarity score (0-1)
|
|
77
|
+
|
|
78
|
+
**position** (`number`): Position-based score (0-1)
|
|
71
79
|
|
|
72
|
-
**
|
|
80
|
+
**queryAnalysis** (`object`): Query analysis details
|
|
73
81
|
|
|
74
|
-
**
|
|
82
|
+
**queryAnalysis.magnitude**: Magnitude of the query
|
|
75
83
|
|
|
76
|
-
**queryAnalysis
|
|
84
|
+
**queryAnalysis.dominantFeatures**: Dominant features of the query
|
|
77
85
|
|
|
78
86
|
## Related
|
|
79
87
|
|
|
@@ -18,33 +18,33 @@ function createRoute<TPath, TQuery, TBody, TResponse, TResponseType>(
|
|
|
18
18
|
|
|
19
19
|
## Parameters
|
|
20
20
|
|
|
21
|
-
**method
|
|
21
|
+
**method** (`'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL'`): HTTP method
|
|
22
22
|
|
|
23
|
-
**path
|
|
23
|
+
**path** (`string`): Route path with optional params (e.g., \`/api/items/:id\`)
|
|
24
24
|
|
|
25
|
-
**responseType
|
|
25
|
+
**responseType** (`'json' | 'stream'`): Response format. Internal routes may use additional types (\`datastream-response\`, \`mcp-http\`, \`mcp-sse\`).
|
|
26
26
|
|
|
27
|
-
**handler
|
|
27
|
+
**handler** (`ServerRouteHandler`): Route handler function
|
|
28
28
|
|
|
29
|
-
**pathParamSchema
|
|
29
|
+
**pathParamSchema** (`ZodSchema`): Validates URL path parameters
|
|
30
30
|
|
|
31
|
-
**queryParamSchema
|
|
31
|
+
**queryParamSchema** (`ZodSchema`): Validates query string parameters
|
|
32
32
|
|
|
33
|
-
**bodySchema
|
|
33
|
+
**bodySchema** (`ZodSchema`): Validates request body
|
|
34
34
|
|
|
35
|
-
**responseSchema
|
|
35
|
+
**responseSchema** (`ZodSchema`): Documents response shape for OpenAPI
|
|
36
36
|
|
|
37
|
-
**streamFormat
|
|
37
|
+
**streamFormat** (`'sse' | 'stream'`): Stream format (when responseType is 'stream')
|
|
38
38
|
|
|
39
|
-
**maxBodySize
|
|
39
|
+
**maxBodySize** (`number`): Override default body size limit in bytes
|
|
40
40
|
|
|
41
|
-
**summary
|
|
41
|
+
**summary** (`string`): OpenAPI summary
|
|
42
42
|
|
|
43
|
-
**description
|
|
43
|
+
**description** (`string`): OpenAPI description
|
|
44
44
|
|
|
45
|
-
**tags
|
|
45
|
+
**tags** (`string[]`): OpenAPI tags
|
|
46
46
|
|
|
47
|
-
**deprecated
|
|
47
|
+
**deprecated** (`boolean`): Mark route as deprecated
|
|
48
48
|
|
|
49
49
|
## Handler parameters
|
|
50
50
|
|
|
@@ -54,25 +54,25 @@ app.listen(4111, () => {
|
|
|
54
54
|
|
|
55
55
|
## Constructor parameters
|
|
56
56
|
|
|
57
|
-
**app
|
|
57
|
+
**app** (`Application`): Express app instance
|
|
58
58
|
|
|
59
|
-
**mastra
|
|
59
|
+
**mastra** (`Mastra`): Mastra instance
|
|
60
60
|
|
|
61
|
-
**prefix
|
|
61
|
+
**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
|
|
62
62
|
|
|
63
|
-
**openapiPath
|
|
63
|
+
**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
|
|
64
64
|
|
|
65
|
-
**bodyLimitOptions
|
|
65
|
+
**bodyLimitOptions** (`{ maxSize: number, onError: (err) => unknown }`): Request body size limits
|
|
66
66
|
|
|
67
|
-
**streamOptions
|
|
67
|
+
**streamOptions** (`{ redact?: boolean }`): Stream redaction config. When true, redacts sensitive data from streams. (Default: `{ redact: true }`)
|
|
68
68
|
|
|
69
|
-
**customRouteAuthConfig
|
|
69
|
+
**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
|
|
70
70
|
|
|
71
|
-
**tools
|
|
71
|
+
**tools** (`Record<string, Tool>`): Available tools for the server
|
|
72
72
|
|
|
73
|
-
**taskStore
|
|
73
|
+
**taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
|
|
74
74
|
|
|
75
|
-
**mcpOptions
|
|
75
|
+
**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
|
|
76
76
|
|
|
77
77
|
## Differences from Hono
|
|
78
78
|
|
|
@@ -55,25 +55,25 @@ app.listen({ port: 3000 }, (err, address) => {
|
|
|
55
55
|
|
|
56
56
|
## Constructor parameters
|
|
57
57
|
|
|
58
|
-
**app
|
|
58
|
+
**app** (`FastifyInstance`): Fastify app instance
|
|
59
59
|
|
|
60
|
-
**mastra
|
|
60
|
+
**mastra** (`Mastra`): Mastra instance
|
|
61
61
|
|
|
62
|
-
**prefix
|
|
62
|
+
**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
|
|
63
63
|
|
|
64
|
-
**openapiPath
|
|
64
|
+
**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
|
|
65
65
|
|
|
66
|
-
**bodyLimitOptions
|
|
66
|
+
**bodyLimitOptions** (`BodyLimitOptions`): Request body size limits
|
|
67
67
|
|
|
68
|
-
**streamOptions
|
|
68
|
+
**streamOptions** (`StreamOptions`): Stream redaction config. When true (default), redacts sensitive data (system prompts, tool definitions, API keys) from stream chunks before sending to clients. (Default: `{ redact: true }`)
|
|
69
69
|
|
|
70
|
-
**customRouteAuthConfig
|
|
70
|
+
**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
|
|
71
71
|
|
|
72
|
-
**tools
|
|
72
|
+
**tools** (`ToolsInput`): Available tools for the server
|
|
73
73
|
|
|
74
|
-
**taskStore
|
|
74
|
+
**taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
|
|
75
75
|
|
|
76
|
-
**mcpOptions
|
|
76
|
+
**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
|
|
77
77
|
|
|
78
78
|
## Manual initialization
|
|
79
79
|
|
|
@@ -49,25 +49,25 @@ export default app
|
|
|
49
49
|
|
|
50
50
|
## Constructor parameters
|
|
51
51
|
|
|
52
|
-
**app
|
|
52
|
+
**app** (`Hono`): Hono app instance
|
|
53
53
|
|
|
54
|
-
**mastra
|
|
54
|
+
**mastra** (`Mastra`): Mastra instance
|
|
55
55
|
|
|
56
|
-
**prefix
|
|
56
|
+
**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
|
|
57
57
|
|
|
58
|
-
**openapiPath
|
|
58
|
+
**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
|
|
59
59
|
|
|
60
|
-
**bodyLimitOptions
|
|
60
|
+
**bodyLimitOptions** (`{ maxSize: number, onError: (err) => unknown }`): Request body size limits
|
|
61
61
|
|
|
62
|
-
**streamOptions
|
|
62
|
+
**streamOptions** (`{ redact?: boolean }`): Stream redaction config. When true, redacts sensitive data from streams. (Default: `{ redact: true }`)
|
|
63
63
|
|
|
64
|
-
**customRouteAuthConfig
|
|
64
|
+
**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
|
|
65
65
|
|
|
66
|
-
**tools
|
|
66
|
+
**tools** (`Record<string, Tool>`): Available tools for the server
|
|
67
67
|
|
|
68
|
-
**taskStore
|
|
68
|
+
**taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
|
|
69
69
|
|
|
70
|
-
**mcpOptions
|
|
70
|
+
**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
|
|
71
71
|
|
|
72
72
|
## Adding custom routes
|
|
73
73
|
|
|
@@ -54,25 +54,25 @@ app.listen(3000, () => {
|
|
|
54
54
|
|
|
55
55
|
## Constructor parameters
|
|
56
56
|
|
|
57
|
-
**app
|
|
57
|
+
**app** (`Koa`): Koa app instance
|
|
58
58
|
|
|
59
|
-
**mastra
|
|
59
|
+
**mastra** (`Mastra`): Mastra instance
|
|
60
60
|
|
|
61
|
-
**prefix
|
|
61
|
+
**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
|
|
62
62
|
|
|
63
|
-
**openapiPath
|
|
63
|
+
**openapiPath** (`string`): Path to serve OpenAPI spec (e.g., \`/openapi.json\`) (Default: `''`)
|
|
64
64
|
|
|
65
|
-
**bodyLimitOptions
|
|
65
|
+
**bodyLimitOptions** (`BodyLimitOptions`): Request body size limits
|
|
66
66
|
|
|
67
|
-
**streamOptions
|
|
67
|
+
**streamOptions** (`StreamOptions`): Stream redaction config. When true (default), redacts sensitive data (system prompts, tool definitions, API keys) from stream chunks before sending to clients. (Default: `{ redact: true }`)
|
|
68
68
|
|
|
69
|
-
**customRouteAuthConfig
|
|
69
|
+
**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides. Keys are \`METHOD:PATH\` (e.g., \`GET:/api/health\`). Value \`false\` makes route public, \`true\` requires auth.
|
|
70
70
|
|
|
71
|
-
**tools
|
|
71
|
+
**tools** (`ToolsInput`): Available tools for the server
|
|
72
72
|
|
|
73
|
-
**taskStore
|
|
73
|
+
**taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
|
|
74
74
|
|
|
75
|
-
**mcpOptions
|
|
75
|
+
**mcpOptions** (`MCPOptions`): MCP transport options. Set \`serverless: true\` for stateless environments like Cloudflare Workers or Vercel Edge.
|
|
76
76
|
|
|
77
77
|
## Error handling
|
|
78
78
|
|
|
@@ -28,25 +28,25 @@ constructor(options: MastraServerOptions<TApp>)
|
|
|
28
28
|
|
|
29
29
|
### Options
|
|
30
30
|
|
|
31
|
-
**app
|
|
31
|
+
**app** (`TApp`): Framework app instance
|
|
32
32
|
|
|
33
|
-
**mastra
|
|
33
|
+
**mastra** (`Mastra`): Mastra instance
|
|
34
34
|
|
|
35
|
-
**prefix
|
|
35
|
+
**prefix** (`string`): Route path prefix (e.g., \`/api/v2\`) (Default: `''`)
|
|
36
36
|
|
|
37
|
-
**openapiPath
|
|
37
|
+
**openapiPath** (`string`): Path to serve OpenAPI spec (Default: `''`)
|
|
38
38
|
|
|
39
|
-
**bodyLimitOptions
|
|
39
|
+
**bodyLimitOptions** (`BodyLimitOptions`): Request body size limits
|
|
40
40
|
|
|
41
|
-
**streamOptions
|
|
41
|
+
**streamOptions** (`StreamOptions`): Stream redaction config (Default: `{ redact: true }`)
|
|
42
42
|
|
|
43
|
-
**customRouteAuthConfig
|
|
43
|
+
**customRouteAuthConfig** (`Map<string, boolean>`): Per-route auth overrides
|
|
44
44
|
|
|
45
|
-
**tools
|
|
45
|
+
**tools** (`Record<string, Tool>`): Available tools for the server
|
|
46
46
|
|
|
47
|
-
**taskStore
|
|
47
|
+
**taskStore** (`InMemoryTaskStore`): Task store for A2A (Agent-to-Agent) operations
|
|
48
48
|
|
|
49
|
-
**mcpOptions
|
|
49
|
+
**mcpOptions** (`MCPOptions`): MCP transport options for serverless environments
|
|
50
50
|
|
|
51
51
|
## Abstract methods
|
|
52
52
|
|
|
@@ -22,35 +22,35 @@ registerApiRoute("/items/:itemId", { ... })
|
|
|
22
22
|
|
|
23
23
|
### options
|
|
24
24
|
|
|
25
|
-
**method
|
|
25
|
+
**method** (`'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL'`): HTTP method for the route
|
|
26
26
|
|
|
27
|
-
**handler
|
|
27
|
+
**handler** (`Handler`): Route handler function receiving Hono Context. Use either \`handler\` or \`createHandler\`, not both.
|
|
28
28
|
|
|
29
|
-
**createHandler
|
|
29
|
+
**createHandler** (`(c: Context) => Promise<Handler>`): Async factory function to create the handler. Use either \`handler\` or \`createHandler\`, not both.
|
|
30
30
|
|
|
31
|
-
**middleware
|
|
31
|
+
**middleware** (`MiddlewareHandler | MiddlewareHandler[]`): Route-specific middleware functions
|
|
32
32
|
|
|
33
|
-
**openapi
|
|
33
|
+
**openapi** (`DescribeRouteOptions`): OpenAPI metadata for Swagger UI documentation
|
|
34
34
|
|
|
35
35
|
## OpenAPI Options
|
|
36
36
|
|
|
37
37
|
The `openapi` property accepts standard OpenAPI 3.1 operation fields from [hono-openapi](https://github.com/honojs/middleware/tree/main/packages/openapi). Routes without an `openapi` property are not included in Swagger UI.
|
|
38
38
|
|
|
39
|
-
**summary
|
|
39
|
+
**summary** (`string`): Short summary of the operation
|
|
40
40
|
|
|
41
|
-
**description
|
|
41
|
+
**description** (`string`): Detailed description of the operation
|
|
42
42
|
|
|
43
|
-
**tags
|
|
43
|
+
**tags** (`string[]`): Tags for grouping in Swagger UI. Defaults to \['custom'] if not specified.
|
|
44
44
|
|
|
45
|
-
**deprecated
|
|
45
|
+
**deprecated** (`boolean`): Mark the operation as deprecated
|
|
46
46
|
|
|
47
|
-
**parameters
|
|
47
|
+
**parameters** (`ParameterObject[]`): Path, query, and header parameters
|
|
48
48
|
|
|
49
|
-
**requestBody
|
|
49
|
+
**requestBody** (`RequestBodyObject`): Request body specification
|
|
50
50
|
|
|
51
|
-
**responses
|
|
51
|
+
**responses** (`ResponsesObject`): Response specifications by status code
|
|
52
52
|
|
|
53
|
-
**security
|
|
53
|
+
**security** (`SecurityRequirementObject[]`): Security requirements for the operation
|
|
54
54
|
|
|
55
55
|
## Return Value
|
|
56
56
|
|
|
@@ -129,15 +129,15 @@ Or in `wrangler.jsonc`:
|
|
|
129
129
|
|
|
130
130
|
## Parameters
|
|
131
131
|
|
|
132
|
-
**binding
|
|
132
|
+
**binding** (`D1Database`): Cloudflare D1 Workers binding (for Workers runtime)
|
|
133
133
|
|
|
134
|
-
**accountId
|
|
134
|
+
**accountId** (`string`): Cloudflare Account ID (for REST API)
|
|
135
135
|
|
|
136
|
-
**databaseId
|
|
136
|
+
**databaseId** (`string`): Cloudflare D1 Database ID (for REST API)
|
|
137
137
|
|
|
138
|
-
**apiToken
|
|
138
|
+
**apiToken** (`string`): Cloudflare API Token (for REST API)
|
|
139
139
|
|
|
140
|
-
**tablePrefix
|
|
140
|
+
**tablePrefix** (`string`): Optional prefix for all table names (useful for environment isolation)
|
|
141
141
|
|
|
142
142
|
## Additional Notes
|
|
143
143
|
|
|
@@ -57,17 +57,17 @@ const storageRest = new CloudflareStore({
|
|
|
57
57
|
|
|
58
58
|
## Parameters
|
|
59
59
|
|
|
60
|
-
**id
|
|
60
|
+
**id** (`string`): Unique identifier for this storage instance.
|
|
61
61
|
|
|
62
|
-
**bindings
|
|
62
|
+
**bindings** (`Record<string, KVNamespace>`): Cloudflare Workers KV bindings (for Workers runtime)
|
|
63
63
|
|
|
64
|
-
**accountId
|
|
64
|
+
**accountId** (`string`): Cloudflare Account ID (for REST API)
|
|
65
65
|
|
|
66
|
-
**apiToken
|
|
66
|
+
**apiToken** (`string`): Cloudflare API Token (for REST API)
|
|
67
67
|
|
|
68
|
-
**namespacePrefix
|
|
68
|
+
**namespacePrefix** (`string`): Optional prefix for all namespace names (useful for environment isolation)
|
|
69
69
|
|
|
70
|
-
**keyPrefix
|
|
70
|
+
**keyPrefix** (`string`): Optional prefix for all keys (useful for environment isolation)
|
|
71
71
|
|
|
72
72
|
### Additional Notes
|
|
73
73
|
|
|
@@ -120,23 +120,23 @@ export const mastra = new Mastra({
|
|
|
120
120
|
|
|
121
121
|
## Options
|
|
122
122
|
|
|
123
|
-
**id
|
|
123
|
+
**id** (`string`): Unique identifier for this storage instance.
|
|
124
124
|
|
|
125
|
-
**default
|
|
125
|
+
**default** (`MastraCompositeStore`): Default storage adapter. Domains not explicitly specified in \`domains\` will use this storage's domains as fallbacks.
|
|
126
126
|
|
|
127
|
-
**domains
|
|
127
|
+
**domains** (`object`): Individual domain overrides. Each domain can come from a different storage adapter. These take precedence over the default storage.
|
|
128
128
|
|
|
129
|
-
**domains.memory
|
|
129
|
+
**domains.memory** (`MemoryStorage`): Storage for threads, messages, and resources.
|
|
130
130
|
|
|
131
|
-
**domains.workflows
|
|
131
|
+
**domains.workflows** (`WorkflowsStorage`): Storage for workflow snapshots.
|
|
132
132
|
|
|
133
|
-
**domains.scores
|
|
133
|
+
**domains.scores** (`ScoresStorage`): Storage for evaluation scores.
|
|
134
134
|
|
|
135
|
-
**domains.observability
|
|
135
|
+
**domains.observability** (`ObservabilityStorage`): Storage for traces and spans.
|
|
136
136
|
|
|
137
|
-
**domains.agents
|
|
137
|
+
**domains.agents** (`AgentsStorage`): Storage for stored agent configurations.
|
|
138
138
|
|
|
139
|
-
**disableInit
|
|
139
|
+
**disableInit** (`boolean`): When true, automatic initialization is disabled. You must call init() explicitly.
|
|
140
140
|
|
|
141
141
|
## Initialization
|
|
142
142
|
|
|
@@ -97,11 +97,11 @@ const storage = new ConvexStore({
|
|
|
97
97
|
|
|
98
98
|
## Parameters
|
|
99
99
|
|
|
100
|
-
**deploymentUrl
|
|
100
|
+
**deploymentUrl** (`string`): Convex deployment URL (e.g., https\://your-project.convex.cloud)
|
|
101
101
|
|
|
102
|
-
**adminAuthToken
|
|
102
|
+
**adminAuthToken** (`string`): Convex admin authentication token for backend access
|
|
103
103
|
|
|
104
|
-
**storageFunction
|
|
104
|
+
**storageFunction** (`string`): Path to the storage mutation function (default: 'mastra/storage:handle') (Default: `mastra/storage:handle`)
|
|
105
105
|
|
|
106
106
|
## Constructor Examples
|
|
107
107
|
|
|
@@ -108,17 +108,17 @@ For local development, you can use [DynamoDB Local](https://docs.aws.amazon.com/
|
|
|
108
108
|
|
|
109
109
|
## Parameters
|
|
110
110
|
|
|
111
|
-
**id
|
|
111
|
+
**id** (`string`): Unique identifier for this storage instance.
|
|
112
112
|
|
|
113
|
-
**config.tableName
|
|
113
|
+
**config.tableName** (`string`): The name of your DynamoDB table.
|
|
114
114
|
|
|
115
|
-
**config.region
|
|
115
|
+
**config.region** (`string`): AWS region. Defaults to 'us-east-1'. For local development, can be set to 'localhost' or similar.
|
|
116
116
|
|
|
117
|
-
**config.endpoint
|
|
117
|
+
**config.endpoint** (`string`): Custom endpoint for DynamoDB (e.g., 'http\://localhost:8000' for local development).
|
|
118
118
|
|
|
119
|
-
**config.credentials
|
|
119
|
+
**config.credentials** (`object`): AWS credentials object with \`accessKeyId\` and \`secretAccessKey\`. If not provided, the AWS SDK will attempt to source credentials from environment variables, IAM roles (e.g., for EC2/Lambda), or the shared AWS credentials file.
|
|
120
120
|
|
|
121
|
-
**config.ttl
|
|
121
|
+
**config.ttl** (`object`): TTL (Time To Live) configuration for automatic data expiration. Configure per entity type: thread, message, trace, eval, workflow\_snapshot, resource, score. Each entity config includes: enabled (boolean), attributeName (string, default: 'ttl'), defaultTtlSeconds (number).
|
|
122
122
|
|
|
123
123
|
## TTL (Time To Live) Configuration
|
|
124
124
|
|
|
@@ -188,11 +188,11 @@ TTL can be configured for these entity types:
|
|
|
188
188
|
|
|
189
189
|
Each entity type accepts the following configuration:
|
|
190
190
|
|
|
191
|
-
**enabled
|
|
191
|
+
**enabled** (`boolean`): Whether TTL is enabled for this entity type.
|
|
192
192
|
|
|
193
|
-
**attributeName
|
|
193
|
+
**attributeName** (`string`): The DynamoDB attribute name to use for TTL. Must match the TTL attribute configured on your DynamoDB table. Defaults to 'ttl'.
|
|
194
194
|
|
|
195
|
-
**defaultTtlSeconds
|
|
195
|
+
**defaultTtlSeconds** (`number`): Default TTL in seconds from item creation time. Items will be automatically deleted by DynamoDB after this duration.
|
|
196
196
|
|
|
197
197
|
### Enabling TTL on Your DynamoDB Table
|
|
198
198
|
|
|
@@ -53,11 +53,11 @@ const storage = await LanceStorage.create('my-storage', 's3://bucket/db', {
|
|
|
53
53
|
|
|
54
54
|
### LanceStorage.create()
|
|
55
55
|
|
|
56
|
-
**name
|
|
56
|
+
**name** (`string`): Name identifier for the storage instance
|
|
57
57
|
|
|
58
|
-
**uri
|
|
58
|
+
**uri** (`string`): URI to connect to the LanceDB database. Can be a local path, cloud DB URL, or S3 bucket URL
|
|
59
59
|
|
|
60
|
-
**options
|
|
60
|
+
**options** (`ConnectionOptions`): Connection options for LanceDB, such as timeout settings, authentication, etc.
|
|
61
61
|
|
|
62
62
|
## Additional Notes
|
|
63
63
|
|
|
@@ -89,9 +89,9 @@ storage: new LibSQLStore({
|
|
|
89
89
|
|
|
90
90
|
## Options
|
|
91
91
|
|
|
92
|
-
**url
|
|
92
|
+
**url** (`string`): Database URL. Use \`:memory:\` for in-memory database, \`file:filename.db\` for a file database, or a libSQL connection string (e.g., \`libsql://your-database.turso.io\`) for remote storage.
|
|
93
93
|
|
|
94
|
-
**authToken
|
|
94
|
+
**authToken** (`string`): Authentication token for remote libSQL databases.
|
|
95
95
|
|
|
96
96
|
## Initialization
|
|
97
97
|
|
|
@@ -44,15 +44,15 @@ const storage = new MongoDBStore({
|
|
|
44
44
|
|
|
45
45
|
## Parameters
|
|
46
46
|
|
|
47
|
-
**id
|
|
47
|
+
**id** (`string`): Unique identifier for this storage instance.
|
|
48
48
|
|
|
49
|
-
**uri
|
|
49
|
+
**uri** (`string`): MongoDB connection string (e.g., mongodb+srv://user:password\@cluster.mongodb.net)
|
|
50
50
|
|
|
51
|
-
**url
|
|
51
|
+
**url** (`string`): Deprecated. Use uri instead. MongoDB connection string (supported for backward compatibility).
|
|
52
52
|
|
|
53
|
-
**dbName
|
|
53
|
+
**dbName** (`string`): The name of the database you want the storage to use.
|
|
54
54
|
|
|
55
|
-
**options
|
|
55
|
+
**options** (`MongoClientOptions`): MongoDB client options for advanced configuration (SSL, connection pooling, etc.).
|
|
56
56
|
|
|
57
57
|
> **Deprecation Notice:** The `url` parameter is deprecated but still supported for backward compatibility. Please use `uri` instead in all new code.
|
|
58
58
|
|
|
@@ -41,9 +41,9 @@ const storage = new MSSQLStore({
|
|
|
41
41
|
|
|
42
42
|
## Parameters
|
|
43
43
|
|
|
44
|
-
**connectionString
|
|
44
|
+
**connectionString** (`string`): MSSQL connection string (e.g., Server=localhost,1433;Database=mydb;User Id=sa;Password=password;Encrypt=true;TrustServerCertificate=true)
|
|
45
45
|
|
|
46
|
-
**schemaName
|
|
46
|
+
**schemaName** (`string`): The name of the schema you want the storage to use. Will use the default schema if not provided.
|
|
47
47
|
|
|
48
48
|
## Constructor Examples
|
|
49
49
|
|