@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
|
@@ -45,23 +45,23 @@ The first parameter is the Mastra stream to convert. It can be one of:
|
|
|
45
45
|
|
|
46
46
|
The second parameter is an options object:
|
|
47
47
|
|
|
48
|
-
**from
|
|
48
|
+
**from** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
|
|
49
49
|
|
|
50
|
-
**lastMessageId
|
|
50
|
+
**lastMessageId** (`string`): (Agent only) The ID of the last message in the conversation.
|
|
51
51
|
|
|
52
|
-
**sendStart
|
|
52
|
+
**sendStart** (`boolean`): (Agent only) Whether to send start events in the stream. (Default: `true`)
|
|
53
53
|
|
|
54
|
-
**sendFinish
|
|
54
|
+
**sendFinish** (`boolean`): (Agent only) Whether to send finish events in the stream. (Default: `true`)
|
|
55
55
|
|
|
56
|
-
**sendReasoning
|
|
56
|
+
**sendReasoning** (`boolean`): (Agent only) Whether to include reasoning-delta chunks in the stream. Set to true to stream reasoning content from models that support extended thinking. (Default: `false`)
|
|
57
57
|
|
|
58
|
-
**sendSources
|
|
58
|
+
**sendSources** (`boolean`): (Agent only) Whether to include source citations in the output. (Default: `false`)
|
|
59
59
|
|
|
60
|
-
**includeTextStreamParts
|
|
60
|
+
**includeTextStreamParts** (`boolean`): (Workflow only) Whether to include text stream parts in the output. (Default: `true`)
|
|
61
61
|
|
|
62
|
-
**messageMetadata
|
|
62
|
+
**messageMetadata** (`(options: { part: UIMessageStreamPart }) => Record<string, unknown> | undefined`): (Agent only) A function that receives the current stream part and returns metadata to attach to start and finish chunks.
|
|
63
63
|
|
|
64
|
-
**onError
|
|
64
|
+
**onError** (`(error: unknown) => string`): (Agent only) A function to handle errors during stream conversion. Receives the error and should return a string representation.
|
|
65
65
|
|
|
66
66
|
## Examples
|
|
67
67
|
|
|
@@ -33,27 +33,27 @@ export default function Chat() {
|
|
|
33
33
|
|
|
34
34
|
## Parameters
|
|
35
35
|
|
|
36
|
-
**messages
|
|
36
|
+
**messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
|
|
37
37
|
|
|
38
38
|
## Returns
|
|
39
39
|
|
|
40
40
|
Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
|
|
41
41
|
|
|
42
|
-
**id
|
|
42
|
+
**id** (`string`): Unique message identifier.
|
|
43
43
|
|
|
44
|
-
**role
|
|
44
|
+
**role** (`'user' | 'assistant' | 'system'`): The role of the message sender.
|
|
45
45
|
|
|
46
|
-
**content
|
|
46
|
+
**content** (`string`): Text content of the message.
|
|
47
47
|
|
|
48
|
-
**parts
|
|
48
|
+
**parts** (`UIMessagePart[]`): Array of UI parts including text, tool-invocation, file, reasoning, source, and step markers.
|
|
49
49
|
|
|
50
|
-
**createdAt
|
|
50
|
+
**createdAt** (`Date`): Message creation timestamp.
|
|
51
51
|
|
|
52
|
-
**toolInvocations
|
|
52
|
+
**toolInvocations** (`ToolInvocation[]`): Array of tool invocations for assistant messages.
|
|
53
53
|
|
|
54
|
-
**experimental\_attachments
|
|
54
|
+
**experimental\_attachments** (`Attachment[]`): File attachments on the message.
|
|
55
55
|
|
|
56
|
-
**metadata
|
|
56
|
+
**metadata** (`Record<string, unknown>`): Custom metadata attached to the message.
|
|
57
57
|
|
|
58
58
|
## Examples
|
|
59
59
|
|
|
@@ -38,19 +38,19 @@ export default function Chat() {
|
|
|
38
38
|
|
|
39
39
|
## Parameters
|
|
40
40
|
|
|
41
|
-
**messages
|
|
41
|
+
**messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
|
|
42
42
|
|
|
43
43
|
## Returns
|
|
44
44
|
|
|
45
45
|
Returns an array of AI SDK V5+ `UIMessage` objects with the following structure:
|
|
46
46
|
|
|
47
|
-
**id
|
|
47
|
+
**id** (`string`): Unique message identifier.
|
|
48
48
|
|
|
49
|
-
**role
|
|
49
|
+
**role** (`'user' | 'assistant' | 'system'`): The role of the message sender.
|
|
50
50
|
|
|
51
|
-
**parts
|
|
51
|
+
**parts** (`UIMessagePart[]`): Array of UI parts including text, tool results, files, reasoning, sources, and step markers.
|
|
52
52
|
|
|
53
|
-
**metadata
|
|
53
|
+
**metadata** (`Record<string, unknown>`): Optional metadata including createdAt, threadId, resourceId, and custom fields.
|
|
54
54
|
|
|
55
55
|
## Examples
|
|
56
56
|
|
|
@@ -30,29 +30,29 @@ const { text } = await generateText({
|
|
|
30
30
|
|
|
31
31
|
## Parameters
|
|
32
32
|
|
|
33
|
-
**model
|
|
33
|
+
**model** (`LanguageModelV2`): Any AI SDK language model (e.g., \`openai('gpt-4o')\`, \`anthropic('claude-3-opus')\`).
|
|
34
34
|
|
|
35
|
-
**options
|
|
35
|
+
**options** (`WithMastraOptions`): Configuration object for processors and memory.
|
|
36
36
|
|
|
37
|
-
**options.inputProcessors
|
|
37
|
+
**options.inputProcessors** (`InputProcessor[]`): Input processors to run before the LLM call.
|
|
38
38
|
|
|
39
|
-
**options.outputProcessors
|
|
39
|
+
**options.outputProcessors** (`OutputProcessor[]`): Output processors to run on the LLM response.
|
|
40
40
|
|
|
41
|
-
**options.memory
|
|
41
|
+
**options.memory** (`WithMastraMemoryOptions`): Memory configuration - enables automatic message history persistence.
|
|
42
42
|
|
|
43
|
-
**options.memory.storage
|
|
43
|
+
**options.memory.storage** (`MemoryStorage`): Memory storage domain for message persistence. Get it from a composite store using \`await storage.getStore('memory')\`.
|
|
44
44
|
|
|
45
|
-
**options.memory.threadId
|
|
45
|
+
**options.memory.threadId** (`string`): Thread ID for conversation persistence.
|
|
46
46
|
|
|
47
|
-
**options.memory.resourceId
|
|
47
|
+
**options.memory.resourceId** (`string`): Resource ID (user/session identifier).
|
|
48
48
|
|
|
49
|
-
**options.memory.lastMessages
|
|
49
|
+
**options.memory.lastMessages** (`number | false`): Number of recent messages to retrieve, or false to disable.
|
|
50
50
|
|
|
51
|
-
**options.memory.semanticRecall
|
|
51
|
+
**options.memory.semanticRecall** (`WithMastraSemanticRecallOptions`): Semantic recall configuration (RAG-based memory retrieval).
|
|
52
52
|
|
|
53
|
-
**options.memory.workingMemory
|
|
53
|
+
**options.memory.workingMemory** (`MemoryConfig['workingMemory']`): Working memory configuration (persistent user data).
|
|
54
54
|
|
|
55
|
-
**options.memory.readOnly
|
|
55
|
+
**options.memory.readOnly** (`boolean`): Read-only mode - prevents saving new messages.
|
|
56
56
|
|
|
57
57
|
## Returns
|
|
58
58
|
|
|
@@ -47,11 +47,11 @@ export const mastra = new Mastra({
|
|
|
47
47
|
|
|
48
48
|
## Parameters
|
|
49
49
|
|
|
50
|
-
**path
|
|
50
|
+
**path** (`string`): The route path (e.g., \`/workflow\` or \`/workflow/:workflowId\`). Include \`:workflowId\` for dynamic workflow routing. (Default: `'/api/workflows/:workflowId/stream'`)
|
|
51
51
|
|
|
52
|
-
**workflow
|
|
52
|
+
**workflow** (`string`): Fixed workflow ID when not using dynamic routing. (Default: `undefined`)
|
|
53
53
|
|
|
54
|
-
**includeTextStreamParts
|
|
54
|
+
**includeTextStreamParts** (`boolean`): Whether to include text stream parts in the output. (Default: `true`)
|
|
55
55
|
|
|
56
56
|
## Additional configuration
|
|
57
57
|
|
|
@@ -22,21 +22,21 @@ export const mastra = new Mastra({
|
|
|
22
22
|
|
|
23
23
|
## Constructor parameters
|
|
24
24
|
|
|
25
|
-
**domain
|
|
25
|
+
**domain** (`string`): Your Auth0 domain (e.g., your-tenant.auth0.com). This is used to verify JWT tokens issued by your Auth0 tenant. (Default: `process.env.AUTH0_DOMAIN`)
|
|
26
26
|
|
|
27
|
-
**audience
|
|
27
|
+
**audience** (`string`): Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API. (Default: `process.env.AUTH0_AUDIENCE`)
|
|
28
28
|
|
|
29
|
-
**name
|
|
29
|
+
**name** (`string`): Custom name for the auth provider instance. (Default: `"auth0"`)
|
|
30
30
|
|
|
31
|
-
**authorizeUser
|
|
31
|
+
**authorizeUser** (`(user: Auth0User) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users with valid tokens.
|
|
32
32
|
|
|
33
33
|
## Environment Variables
|
|
34
34
|
|
|
35
35
|
The following environment variables are automatically used when constructor options are not provided:
|
|
36
36
|
|
|
37
|
-
**AUTH0\_DOMAIN
|
|
37
|
+
**AUTH0\_DOMAIN** (`string`): Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.
|
|
38
38
|
|
|
39
|
-
**AUTH0\_AUDIENCE
|
|
39
|
+
**AUTH0\_AUDIENCE** (`string`): Your Auth0 API identifier. This is the identifier you set when creating an API in your Auth0 Dashboard.
|
|
40
40
|
|
|
41
41
|
## Default Authorization Behavior
|
|
42
42
|
|
|
@@ -33,15 +33,15 @@ export const mastra = new Mastra({
|
|
|
33
33
|
|
|
34
34
|
## Constructor parameters
|
|
35
35
|
|
|
36
|
-
**auth
|
|
36
|
+
**auth** (`Auth`): Your Better Auth instance created via betterAuth({ ... }). This is required and must be properly configured with a supported database provider.
|
|
37
37
|
|
|
38
|
-
**name
|
|
38
|
+
**name** (`string`): Custom name for the auth provider instance. (Default: `'better-auth'`)
|
|
39
39
|
|
|
40
|
-
**authorizeUser
|
|
40
|
+
**authorizeUser** (`(user: BetterAuthUser, request: HonoRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after session verification. By default, allows all authenticated users with valid sessions.
|
|
41
41
|
|
|
42
|
-
**public
|
|
42
|
+
**public** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Public routes that do not require authentication. Supports exact paths, wildcards, and path params.
|
|
43
43
|
|
|
44
|
-
**protected
|
|
44
|
+
**protected** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Protected routes that require authentication. Supports exact paths, wildcards, and path params.
|
|
45
45
|
|
|
46
46
|
## BetterAuthUser Type
|
|
47
47
|
|
|
@@ -21,15 +21,15 @@ export const mastra = new Mastra({
|
|
|
21
21
|
|
|
22
22
|
## Constructor parameters
|
|
23
23
|
|
|
24
|
-
**publishableKey
|
|
24
|
+
**publishableKey** (`string`): Your Clerk publishable key. Can be found in your Clerk Dashboard under API Keys. (Default: `process.env.CLERK_PUBLISHABLE_KEY`)
|
|
25
25
|
|
|
26
|
-
**secretKey
|
|
26
|
+
**secretKey** (`string`): Your Clerk secret key. Used for server-side authentication and token verification. (Default: `process.env.CLERK_SECRET_KEY`)
|
|
27
27
|
|
|
28
|
-
**jwksUri
|
|
28
|
+
**jwksUri** (`string`): The JWKS URI from your Clerk application. Used to verify JWT signatures. (Default: `process.env.CLERK_JWKS_URI`)
|
|
29
29
|
|
|
30
|
-
**name
|
|
30
|
+
**name** (`string`): Custom name for the auth provider instance.
|
|
31
31
|
|
|
32
|
-
**authorizeUser
|
|
32
|
+
**authorizeUser** (`(user: User, request: HonoRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users.
|
|
33
33
|
|
|
34
34
|
## Related
|
|
35
35
|
|
|
@@ -36,23 +36,23 @@ export const mastra = new Mastra({
|
|
|
36
36
|
|
|
37
37
|
## Constructor parameters
|
|
38
38
|
|
|
39
|
-
**serviceAccount
|
|
39
|
+
**serviceAccount** (`string`): Path to the Firebase service account JSON file. This file contains the credentials needed to verify Firebase ID tokens on the server side. (Default: `process.env.FIREBASE_SERVICE_ACCOUNT`)
|
|
40
40
|
|
|
41
|
-
**databaseId
|
|
41
|
+
**databaseId** (`string`): The Firestore database ID to use. Typically '(default)' for the default database. (Default: `process.env.FIRESTORE_DATABASE_ID || process.env.FIREBASE_DATABASE_ID`)
|
|
42
42
|
|
|
43
|
-
**name
|
|
43
|
+
**name** (`string`): Custom name for the auth provider instance. (Default: `"firebase"`)
|
|
44
44
|
|
|
45
|
-
**authorizeUser
|
|
45
|
+
**authorizeUser** (`(user: FirebaseUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks for the presence of a document in the 'user\_access' collection keyed by the user's UID.
|
|
46
46
|
|
|
47
47
|
## Environment Variables
|
|
48
48
|
|
|
49
49
|
The following environment variables are automatically used when constructor options are not provided:
|
|
50
50
|
|
|
51
|
-
**FIREBASE\_SERVICE\_ACCOUNT
|
|
51
|
+
**FIREBASE\_SERVICE\_ACCOUNT** (`string`): Path to Firebase service account JSON file. Used if serviceAccount option is not provided.
|
|
52
52
|
|
|
53
|
-
**FIRESTORE\_DATABASE\_ID
|
|
53
|
+
**FIRESTORE\_DATABASE\_ID** (`string`): Firestore database ID. Primary environment variable for database configuration.
|
|
54
54
|
|
|
55
|
-
**FIREBASE\_DATABASE\_ID
|
|
55
|
+
**FIREBASE\_DATABASE\_ID** (`string`): Alternative environment variable for Firestore database ID. Used if FIRESTORE\_DATABASE\_ID is not set.
|
|
56
56
|
|
|
57
57
|
## Default Authorization Behavior
|
|
58
58
|
|
|
@@ -19,7 +19,7 @@ export const mastra = new Mastra({
|
|
|
19
19
|
|
|
20
20
|
## Constructor parameters
|
|
21
21
|
|
|
22
|
-
**secret
|
|
22
|
+
**secret** (`string`): A unique string used to sign and verify JSON Web Tokens (JWTs) for authenticating incoming requests.
|
|
23
23
|
|
|
24
24
|
## Related
|
|
25
25
|
|
|
@@ -20,13 +20,13 @@ export const mastra = new Mastra({
|
|
|
20
20
|
|
|
21
21
|
## Constructor parameters
|
|
22
22
|
|
|
23
|
-
**url
|
|
23
|
+
**url** (`string`): The URL of your Supabase project. Can be found in your Supabase project settings. (Default: `process.env.SUPABASE_URL`)
|
|
24
24
|
|
|
25
|
-
**anonKey
|
|
25
|
+
**anonKey** (`string`): The anonymous/public key for your Supabase project. Used for client-side authentication. (Default: `process.env.SUPABASE_ANON_KEY`)
|
|
26
26
|
|
|
27
|
-
**name
|
|
27
|
+
**name** (`string`): Custom name for the auth provider instance.
|
|
28
28
|
|
|
29
|
-
**authorizeUser
|
|
29
|
+
**authorizeUser** (`(user: User, request: HoneRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks the 'isAdmin' column in the 'users' table.
|
|
30
30
|
|
|
31
31
|
## Related
|
|
32
32
|
|
|
@@ -22,21 +22,21 @@ export const mastra = new Mastra({
|
|
|
22
22
|
|
|
23
23
|
## Constructor parameters
|
|
24
24
|
|
|
25
|
-
**apiKey
|
|
25
|
+
**apiKey** (`string`): Your WorkOS API key. This is used to authenticate with the WorkOS API for user verification and organization management. (Default: `process.env.WORKOS_API_KEY`)
|
|
26
26
|
|
|
27
|
-
**clientId
|
|
27
|
+
**clientId** (`string`): Your WorkOS Client ID. This identifies your application when exchanging authorization codes for access tokens. (Default: `process.env.WORKOS_CLIENT_ID`)
|
|
28
28
|
|
|
29
|
-
**name
|
|
29
|
+
**name** (`string`): Custom name for the auth provider instance. (Default: `"workos"`)
|
|
30
30
|
|
|
31
|
-
**authorizeUser
|
|
31
|
+
**authorizeUser** (`(user: WorkosUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks if the user has an 'admin' role in any organization membership.
|
|
32
32
|
|
|
33
33
|
## Environment Variables
|
|
34
34
|
|
|
35
35
|
The following environment variables are automatically used when constructor options are not provided:
|
|
36
36
|
|
|
37
|
-
**WORKOS\_API\_KEY
|
|
37
|
+
**WORKOS\_API\_KEY** (`string`): Your WorkOS API key. Can be found in your WorkOS Dashboard under API Keys.
|
|
38
38
|
|
|
39
|
-
**WORKOS\_CLIENT\_ID
|
|
39
|
+
**WORKOS\_CLIENT\_ID** (`string`): Your WorkOS Client ID. Can be found in your WorkOS Dashboard under Applications.
|
|
40
40
|
|
|
41
41
|
## Default Authorization Behavior
|
|
42
42
|
|
|
@@ -92,33 +92,33 @@ bun x create-mastra@latest my-project -- --default --skills claude-code,cursor
|
|
|
92
92
|
|
|
93
93
|
Instead of an interactive prompt you can also define these CLI flags.
|
|
94
94
|
|
|
95
|
-
**--version
|
|
95
|
+
**--version** (`boolean`): Output the version number
|
|
96
96
|
|
|
97
|
-
**--project-name
|
|
97
|
+
**--project-name** (`string`): Project name that will be used in package.json and as the project directory name
|
|
98
98
|
|
|
99
|
-
**--default
|
|
99
|
+
**--default** (`boolean`): Quick start with defaults (src, OpenAI, no examples)
|
|
100
100
|
|
|
101
|
-
**--components
|
|
101
|
+
**--components** (`string`): Comma-separated list of components (agents, tools, workflows, scorers)
|
|
102
102
|
|
|
103
|
-
**--llm
|
|
103
|
+
**--llm** (`string`): Default model provider (openai, anthropic, groq, google, or cerebras)
|
|
104
104
|
|
|
105
|
-
**--llm-api-key
|
|
105
|
+
**--llm-api-key** (`string`): API key for the model provider
|
|
106
106
|
|
|
107
|
-
**--example
|
|
107
|
+
**--example** (`boolean`): Include example code
|
|
108
108
|
|
|
109
|
-
**--no-example
|
|
109
|
+
**--no-example** (`boolean`): Do not include example code
|
|
110
110
|
|
|
111
|
-
**--template
|
|
111
|
+
**--template** (`string`): Create project from a template (use template name, public GitHub URL, or leave blank to select from list)
|
|
112
112
|
|
|
113
|
-
**--timeout
|
|
113
|
+
**--timeout** (`number`): Configurable timeout for package installation, defaults to 60000 ms
|
|
114
114
|
|
|
115
|
-
**--dir
|
|
115
|
+
**--dir** (`string`): Target directory for Mastra source code (default: src/)
|
|
116
116
|
|
|
117
|
-
**--mcp
|
|
117
|
+
**--mcp** (`string`): MCP Server for code editor (cursor, cursor-global, windsurf, vscode)
|
|
118
118
|
|
|
119
|
-
**--skills
|
|
119
|
+
**--skills** (`string`): Comma-separated list of agents to install Mastra skills for (e.g., claude-code,cursor,windsurf)
|
|
120
120
|
|
|
121
|
-
**--help
|
|
121
|
+
**--help** (`boolean`): Display help for command
|
|
122
122
|
|
|
123
123
|
## Telemetry
|
|
124
124
|
|
|
@@ -14,50 +14,50 @@ export const mastraClient = new MastraClient({
|
|
|
14
14
|
|
|
15
15
|
## Parameters
|
|
16
16
|
|
|
17
|
-
**baseUrl
|
|
17
|
+
**baseUrl** (`string`): The base URL for the Mastra API. All requests will be sent relative to this URL.
|
|
18
18
|
|
|
19
|
-
**retries
|
|
19
|
+
**retries** (`number`): The number of times a request will be retried on failure before throwing an error. (Default: `3`)
|
|
20
20
|
|
|
21
|
-
**backoffMs
|
|
21
|
+
**backoffMs** (`number`): The initial delay in milliseconds before retrying a failed request. This value is doubled with each retry (exponential backoff). (Default: `300`)
|
|
22
22
|
|
|
23
|
-
**maxBackoffMs
|
|
23
|
+
**maxBackoffMs** (`number`): The maximum backoff time in milliseconds. Prevents retries from waiting too long between attempts. (Default: `5000`)
|
|
24
24
|
|
|
25
|
-
**headers
|
|
25
|
+
**headers** (`Record<string, string>`): An object containing custom HTTP headers to include with every request.
|
|
26
26
|
|
|
27
|
-
**credentials
|
|
27
|
+
**credentials** (`"omit" | "same-origin" | "include"`): Credentials mode for requests. See https\://developer.mozilla.org/en-US/docs/Web/API/Request/credentials for more info.
|
|
28
28
|
|
|
29
29
|
## Methods
|
|
30
30
|
|
|
31
|
-
**listAgents()
|
|
31
|
+
**listAgents()** (`Promise<Record<string, GetAgentResponse>>`): Returns all available agent instances.
|
|
32
32
|
|
|
33
|
-
**getAgent(agentId)
|
|
33
|
+
**getAgent(agentId)** (`Agent`): Retrieves a specific agent instance by ID.
|
|
34
34
|
|
|
35
|
-
**getMemoryThreads(params)
|
|
35
|
+
**getMemoryThreads(params)** (`Promise<StorageThreadType[]>`): Retrieves memory threads for the specified resource and agent. Requires a \`resourceId\` and an \`agentId\`.
|
|
36
36
|
|
|
37
|
-
**createMemoryThread(params)
|
|
37
|
+
**createMemoryThread(params)** (`Promise<MemoryThread>`): Creates a new memory thread with the given parameters.
|
|
38
38
|
|
|
39
|
-
**getMemoryThread({ threadId, agentId })
|
|
39
|
+
**getMemoryThread({ threadId, agentId })** (`MemoryThread`): Fetches a specific memory thread by ID.
|
|
40
40
|
|
|
41
|
-
**saveMessageToMemory(params)
|
|
41
|
+
**saveMessageToMemory(params)** (`Promise<{ messages: (MastraMessageV1 | MastraDBMessage)[] }>`): Saves one or more messages to the memory system. Returns the saved messages.
|
|
42
42
|
|
|
43
|
-
**getMemoryStatus()
|
|
43
|
+
**getMemoryStatus()** (`Promise<MemoryStatus>`): Returns the current status of the memory system.
|
|
44
44
|
|
|
45
|
-
**listTools()
|
|
45
|
+
**listTools()** (`Record<string, Tool>`): Returns all available tools.
|
|
46
46
|
|
|
47
|
-
**getTool(toolId)
|
|
47
|
+
**getTool(toolId)** (`Tool`): Retrieves a specific tool instance by ID.
|
|
48
48
|
|
|
49
|
-
**listWorkflows()
|
|
49
|
+
**listWorkflows()** (`Record<string, Workflow>`): Returns all available workflow instances.
|
|
50
50
|
|
|
51
|
-
**getWorkflow(workflowId)
|
|
51
|
+
**getWorkflow(workflowId)** (`Workflow`): Retrieves a specific workflow instance by ID.
|
|
52
52
|
|
|
53
|
-
**getVector(vectorName)
|
|
53
|
+
**getVector(vectorName)** (`MastraVector`): Returns a vector store instance by name.
|
|
54
54
|
|
|
55
|
-
**listLogs(params)
|
|
55
|
+
**listLogs(params)** (`Promise<LogEntry[]>`): Fetches system logs matching the provided filters.
|
|
56
56
|
|
|
57
|
-
**getLog(params)
|
|
57
|
+
**getLog(params)** (`Promise<LogEntry>`): Retrieves a specific log entry by ID or filter.
|
|
58
58
|
|
|
59
|
-
**listLogTransports()
|
|
59
|
+
**listLogTransports()** (`string[]`): Returns the list of configured log transport types.
|
|
60
60
|
|
|
61
|
-
**getTrace(traceId)
|
|
61
|
+
**getTrace(traceId)** (`Promise<TraceRecord>`): Retrieves a specific trace by ID, including all its spans and details.
|
|
62
62
|
|
|
63
|
-
**getTraces(params)
|
|
63
|
+
**getTraces(params)** (`Promise<GetTracesResponse>`): Retrieves paginated list of trace root spans with optional filtering. Use getTrace() to get complete traces with all spans.
|
|
@@ -192,8 +192,8 @@ const result = await workflow.runById(runId, {
|
|
|
192
192
|
|
|
193
193
|
A workflow run result yields the following:
|
|
194
194
|
|
|
195
|
-
**runId
|
|
195
|
+
**runId** (`string`): Unique identifier for this workflow run instance
|
|
196
196
|
|
|
197
|
-
**eventTimestamp
|
|
197
|
+
**eventTimestamp** (`Date`): The timestamp of the event
|
|
198
198
|
|
|
199
|
-
**payload
|
|
199
|
+
**payload** (`object`): Contains currentStep (id, status, output, payload) and workflowState (status, steps record)
|
|
@@ -19,9 +19,9 @@ mastra.addGateway(new MyCustomGateway())
|
|
|
19
19
|
|
|
20
20
|
## Parameters
|
|
21
21
|
|
|
22
|
-
**gateway
|
|
22
|
+
**gateway** (`MastraModelGateway`): The gateway instance to add
|
|
23
23
|
|
|
24
|
-
**key
|
|
24
|
+
**key** (`string`): Optional registration key. If not provided, uses gateway.getId()
|
|
25
25
|
|
|
26
26
|
## Returns
|
|
27
27
|
|
|
@@ -10,11 +10,11 @@ mastra.getAgent('testAgent')
|
|
|
10
10
|
|
|
11
11
|
## Parameters
|
|
12
12
|
|
|
13
|
-
**name
|
|
13
|
+
**name** (`TAgentName extends keyof TAgents`): The name of the agent to retrieve. Must be a valid agent name that exists in the Mastra configuration.
|
|
14
14
|
|
|
15
15
|
## Returns
|
|
16
16
|
|
|
17
|
-
**agent
|
|
17
|
+
**agent** (`TAgents[TAgentName]`): The agent instance with the specified name. Throws an error if the agent is not found.
|
|
18
18
|
|
|
19
19
|
## Related
|
|
20
20
|
|
|
@@ -10,11 +10,11 @@ mastra.getAgentById('test-agent-123')
|
|
|
10
10
|
|
|
11
11
|
## Parameters
|
|
12
12
|
|
|
13
|
-
**id
|
|
13
|
+
**id** (`string`): The ID of the agent to retrieve. The method will first search for an agent with this ID, and if not found, will attempt to use it as a name to call getAgent().
|
|
14
14
|
|
|
15
15
|
## Returns
|
|
16
16
|
|
|
17
|
-
**agent
|
|
17
|
+
**agent** (`Agent`): The agent instance with the specified ID. Throws an error if the agent is not found.
|
|
18
18
|
|
|
19
19
|
## Related
|
|
20
20
|
|
|
@@ -14,7 +14,7 @@ This method does not accept any parameters.
|
|
|
14
14
|
|
|
15
15
|
## Returns
|
|
16
16
|
|
|
17
|
-
**deployer
|
|
17
|
+
**deployer** (`MastraDeployer | undefined`): The configured deployer instance, or undefined if no deployer has been configured.
|
|
18
18
|
|
|
19
19
|
## Related
|
|
20
20
|
|
|
@@ -19,11 +19,11 @@ console.log(gateway.name) // 'My Custom Gateway'
|
|
|
19
19
|
|
|
20
20
|
## Parameters
|
|
21
21
|
|
|
22
|
-
**key
|
|
22
|
+
**key** (`string`): The registration key of the gateway
|
|
23
23
|
|
|
24
24
|
## Returns
|
|
25
25
|
|
|
26
|
-
**gateway
|
|
26
|
+
**gateway** (`MastraModelGateway`): The gateway instance
|
|
27
27
|
|
|
28
28
|
## Throws
|
|
29
29
|
|
|
@@ -26,11 +26,11 @@ console.log(gateway.name) // 'My Custom Gateway'
|
|
|
26
26
|
|
|
27
27
|
## Parameters
|
|
28
28
|
|
|
29
|
-
**id
|
|
29
|
+
**id** (`string`): The unique ID of the gateway (gateway.id property)
|
|
30
30
|
|
|
31
31
|
## Returns
|
|
32
32
|
|
|
33
|
-
**gateway
|
|
33
|
+
**gateway** (`MastraModelGateway | undefined`): The gateway instance, or undefined if not found
|
|
34
34
|
|
|
35
35
|
## Related
|
|
36
36
|
|
|
@@ -14,7 +14,7 @@ This method does not accept any parameters.
|
|
|
14
14
|
|
|
15
15
|
## Returns
|
|
16
16
|
|
|
17
|
-
**logger
|
|
17
|
+
**logger** (`TLogger`): The configured logger instance used for logging across all components (agents, workflows, etc.).
|
|
18
18
|
|
|
19
19
|
## Related
|
|
20
20
|
|
|
@@ -30,11 +30,11 @@ const serverById = mastra.getMCPServerById('my-mcp-server')
|
|
|
30
30
|
|
|
31
31
|
## Parameters
|
|
32
32
|
|
|
33
|
-
**registryKey
|
|
33
|
+
**registryKey** (`string`): The registry key used when registering the MCP server in the mcpServers configuration object. This is the key in the key-value pair, not the server's intrinsic id property.
|
|
34
34
|
|
|
35
35
|
## Returns
|
|
36
36
|
|
|
37
|
-
**server
|
|
37
|
+
**server** (`MCPServerBase | undefined`): The MCP server instance with the specified registry key, or undefined if not found.
|
|
38
38
|
|
|
39
39
|
## Related Methods
|
|
40
40
|
|
|
@@ -30,13 +30,13 @@ const serverByKey = mastra.getMCPServer('customKey')
|
|
|
30
30
|
|
|
31
31
|
## Parameters
|
|
32
32
|
|
|
33
|
-
**serverId
|
|
33
|
+
**serverId** (`string`): The intrinsic id property of the MCP server (set when the server was instantiated).
|
|
34
34
|
|
|
35
|
-
**version
|
|
35
|
+
**version** (`string`): Optional. If provided, returns the server only if its version matches.
|
|
36
36
|
|
|
37
37
|
## Returns
|
|
38
38
|
|
|
39
|
-
**server
|
|
39
|
+
**server** (`MCPServerBase | undefined`): The MCP server instance with the specified id (and version, if provided), or undefined if not found.
|
|
40
40
|
|
|
41
41
|
## Notes
|
|
42
42
|
|
|
@@ -16,11 +16,11 @@ const thread = await memory.createThread({
|
|
|
16
16
|
|
|
17
17
|
## Parameters
|
|
18
18
|
|
|
19
|
-
**key
|
|
19
|
+
**key** (`TMemoryKey extends keyof TMemory`): The registry key of the memory instance to retrieve. Must match a key used when registering memory in the Mastra constructor.
|
|
20
20
|
|
|
21
21
|
## Returns
|
|
22
22
|
|
|
23
|
-
**memory
|
|
23
|
+
**memory** (`TMemory[TMemoryKey]`): The memory instance with the specified key. Throws an error if the memory is not found.
|
|
24
24
|
|
|
25
25
|
## Example: Registering and Retrieving Memory
|
|
26
26
|
|