@mastra/mcp-docs-server 1.0.0-beta.13 → 1.0.0-beta.14
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/organized/changelogs/%40mastra%2Fagent-builder.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +28 -28
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +98 -98
- package/.docs/organized/changelogs/%40mastra%2Fconvex.md +30 -0
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +171 -171
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +15 -15
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +15 -15
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +12 -12
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +22 -22
- package/.docs/organized/changelogs/%40mastra%2Frag.md +17 -17
- package/.docs/organized/changelogs/%40mastra%2Freact.md +9 -2
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +94 -94
- package/.docs/organized/changelogs/create-mastra.md +3 -3
- package/.docs/organized/changelogs/mastra.md +17 -17
- package/.docs/organized/code-examples/agent-v6.md +151 -0
- package/.docs/organized/code-examples/ai-elements.md +1 -1
- package/.docs/raw/agents/adding-voice.mdx +2 -3
- package/.docs/raw/agents/agent-approval.mdx +5 -6
- package/.docs/raw/agents/agent-memory.mdx +22 -30
- package/.docs/raw/agents/guardrails.mdx +60 -50
- package/.docs/raw/agents/networks.mdx +8 -12
- package/.docs/raw/agents/overview.mdx +39 -23
- package/.docs/raw/agents/processors.mdx +20 -19
- package/.docs/raw/agents/structured-output.mdx +11 -7
- package/.docs/raw/agents/using-tools.mdx +4 -5
- package/.docs/raw/deployment/mastra-server.mdx +3 -3
- package/.docs/raw/deployment/overview.mdx +7 -0
- package/.docs/raw/deployment/web-framework.mdx +4 -6
- package/.docs/raw/evals/custom-scorers.mdx +9 -6
- package/.docs/raw/evals/overview.mdx +3 -6
- package/.docs/raw/evals/running-in-ci.mdx +2 -2
- package/.docs/raw/getting-started/manual-install.mdx +20 -20
- package/.docs/raw/getting-started/mcp-docs-server.mdx +2 -2
- package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +4 -4
- package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +30 -30
- package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
- package/.docs/raw/guides/build-your-ui/copilotkit.mdx +11 -11
- package/.docs/raw/guides/deployment/amazon-ec2.mdx +9 -9
- package/.docs/raw/guides/deployment/aws-lambda.mdx +11 -11
- package/.docs/raw/guides/deployment/azure-app-services.mdx +2 -2
- package/.docs/raw/guides/deployment/cloudflare-deployer.mdx +5 -6
- package/.docs/raw/guides/deployment/digital-ocean.mdx +10 -10
- package/.docs/raw/guides/deployment/index.mdx +1 -1
- package/.docs/raw/guides/deployment/inngest.mdx +386 -0
- package/.docs/raw/guides/deployment/netlify-deployer.mdx +4 -4
- package/.docs/raw/guides/deployment/vercel-deployer.mdx +5 -6
- package/.docs/raw/guides/getting-started/astro.mdx +292 -451
- package/.docs/raw/guides/getting-started/express.mdx +7 -7
- package/.docs/raw/guides/getting-started/hono.mdx +18 -18
- package/.docs/raw/guides/getting-started/next-js.mdx +19 -20
- package/.docs/raw/guides/getting-started/quickstart.mdx +4 -4
- package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
- package/.docs/raw/guides/getting-started/vite-react.mdx +21 -21
- package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
- package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
- package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
- package/.docs/raw/guides/guide/research-assistant.mdx +13 -13
- package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
- package/.docs/raw/guides/guide/web-search.mdx +8 -8
- package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
- package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
- package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +1 -1
- package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +0 -2
- package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
- package/.docs/raw/index.mdx +2 -2
- package/.docs/raw/mastra-cloud/setting-up.mdx +6 -2
- package/.docs/raw/mcp/overview.mdx +31 -13
- package/.docs/raw/mcp/publishing-mcp-server.mdx +2 -2
- package/.docs/raw/memory/memory-processors.mdx +9 -9
- package/.docs/raw/memory/message-history.mdx +69 -0
- package/.docs/raw/memory/overview.mdx +34 -76
- package/.docs/raw/memory/semantic-recall.mdx +58 -49
- package/.docs/raw/memory/storage.mdx +188 -0
- package/.docs/raw/memory/working-memory.mdx +7 -7
- package/.docs/raw/observability/logging.mdx +9 -10
- package/.docs/raw/observability/overview.mdx +0 -1
- package/.docs/raw/observability/tracing/bridges/otel.mdx +2 -2
- package/.docs/raw/observability/tracing/exporters/default.mdx +3 -3
- package/.docs/raw/observability/tracing/exporters/langfuse.mdx +1 -2
- package/.docs/raw/observability/tracing/overview.mdx +23 -25
- package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +3 -3
- package/.docs/raw/rag/chunking-and-embedding.mdx +6 -6
- package/.docs/raw/rag/graph-rag.mdx +7 -7
- package/.docs/raw/rag/overview.mdx +1 -1
- package/.docs/raw/rag/retrieval.mdx +21 -22
- package/.docs/raw/rag/vector-databases.mdx +22 -22
- package/.docs/raw/reference/agents/agent.mdx +3 -3
- package/.docs/raw/reference/agents/generate.mdx +1 -1
- package/.docs/raw/reference/agents/generateLegacy.mdx +2 -2
- package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +2 -2
- package/.docs/raw/reference/agents/getDefaultOptions.mdx +2 -2
- package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +2 -2
- package/.docs/raw/reference/agents/getDescription.mdx +1 -1
- package/.docs/raw/reference/agents/getInstructions.mdx +2 -2
- package/.docs/raw/reference/agents/getLLM.mdx +2 -2
- package/.docs/raw/reference/agents/getMemory.mdx +2 -2
- package/.docs/raw/reference/agents/getModel.mdx +2 -2
- package/.docs/raw/reference/agents/getTools.mdx +2 -2
- package/.docs/raw/reference/agents/getVoice.mdx +2 -2
- package/.docs/raw/reference/agents/listAgents.mdx +2 -2
- package/.docs/raw/reference/agents/listScorers.mdx +2 -2
- package/.docs/raw/reference/agents/listTools.mdx +2 -2
- package/.docs/raw/reference/agents/listWorkflows.mdx +2 -2
- package/.docs/raw/reference/agents/network.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/chat-route.mdx +2 -2
- package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/network-route.mdx +2 -2
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +6 -6
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +3 -3
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +3 -3
- package/.docs/raw/reference/ai-sdk/with-mastra.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/workflow-route.mdx +2 -2
- package/.docs/raw/reference/auth/auth0.mdx +1 -2
- package/.docs/raw/reference/auth/clerk.mdx +1 -2
- package/.docs/raw/reference/auth/firebase.mdx +2 -4
- package/.docs/raw/reference/auth/jwt.mdx +1 -2
- package/.docs/raw/reference/auth/supabase.mdx +1 -2
- package/.docs/raw/reference/auth/workos.mdx +1 -2
- package/.docs/raw/reference/cli/create-mastra.mdx +10 -10
- package/.docs/raw/reference/cli/mastra.mdx +9 -9
- package/.docs/raw/reference/client-js/agents.mdx +1 -2
- package/.docs/raw/reference/client-js/mastra-client.mdx +1 -1
- package/.docs/raw/reference/core/getAgent.mdx +1 -1
- package/.docs/raw/reference/core/getAgentById.mdx +1 -1
- package/.docs/raw/reference/core/getDeployer.mdx +1 -1
- package/.docs/raw/reference/core/getLogger.mdx +1 -1
- package/.docs/raw/reference/core/getMCPServer.mdx +1 -1
- package/.docs/raw/reference/core/getMCPServerById.mdx +1 -1
- package/.docs/raw/reference/core/getMemory.mdx +2 -2
- package/.docs/raw/reference/core/getServer.mdx +1 -1
- package/.docs/raw/reference/core/getStorage.mdx +2 -2
- package/.docs/raw/reference/core/getStoredAgentById.mdx +3 -3
- package/.docs/raw/reference/core/getTelemetry.mdx +1 -1
- package/.docs/raw/reference/core/getVector.mdx +1 -1
- package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
- package/.docs/raw/reference/core/listAgents.mdx +1 -1
- package/.docs/raw/reference/core/listLogs.mdx +1 -1
- package/.docs/raw/reference/core/listLogsByRunId.mdx +1 -1
- package/.docs/raw/reference/core/listMCPServers.mdx +1 -1
- package/.docs/raw/reference/core/listMemory.mdx +2 -2
- package/.docs/raw/reference/core/listStoredAgents.mdx +4 -4
- package/.docs/raw/reference/core/listVectors.mdx +1 -1
- package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
- package/.docs/raw/reference/core/setLogger.mdx +1 -1
- package/.docs/raw/reference/core/setStorage.mdx +2 -2
- package/.docs/raw/reference/core/setTelemetry.mdx +1 -1
- package/.docs/raw/reference/deployer/cloudflare.mdx +1 -2
- package/.docs/raw/reference/deployer/deployer.mdx +0 -1
- package/.docs/raw/reference/deployer/netlify.mdx +1 -1
- package/.docs/raw/reference/deployer/vercel.mdx +2 -4
- package/.docs/raw/reference/evals/answer-relevancy.mdx +1 -1
- package/.docs/raw/reference/evals/answer-similarity.mdx +1 -1
- package/.docs/raw/reference/evals/bias.mdx +1 -1
- package/.docs/raw/reference/evals/completeness.mdx +1 -1
- package/.docs/raw/reference/evals/content-similarity.mdx +1 -1
- package/.docs/raw/reference/evals/context-precision.mdx +1 -1
- package/.docs/raw/reference/evals/faithfulness.mdx +1 -1
- package/.docs/raw/reference/evals/hallucination.mdx +1 -1
- package/.docs/raw/reference/evals/keyword-coverage.mdx +1 -1
- package/.docs/raw/reference/evals/prompt-alignment.mdx +7 -7
- package/.docs/raw/reference/evals/textual-difference.mdx +1 -1
- package/.docs/raw/reference/evals/tone-consistency.mdx +1 -1
- package/.docs/raw/reference/evals/tool-call-accuracy.mdx +10 -10
- package/.docs/raw/reference/evals/toxicity.mdx +1 -1
- package/.docs/raw/reference/logging/pino-logger.mdx +6 -7
- package/.docs/raw/reference/memory/createThread.mdx +2 -2
- package/.docs/raw/reference/memory/deleteMessages.mdx +2 -2
- package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +2 -2
- package/.docs/raw/reference/memory/memory-class.mdx +3 -3
- package/.docs/raw/reference/memory/query.mdx +2 -2
- package/.docs/raw/reference/memory/recall.mdx +2 -2
- package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +1 -1
- package/.docs/raw/reference/processors/batch-parts-processor.mdx +2 -2
- package/.docs/raw/reference/processors/language-detector.mdx +2 -2
- package/.docs/raw/reference/processors/message-history-processor.mdx +2 -2
- package/.docs/raw/reference/processors/moderation-processor.mdx +3 -3
- package/.docs/raw/reference/processors/pii-detector.mdx +3 -3
- package/.docs/raw/reference/processors/processor-interface.mdx +13 -13
- package/.docs/raw/reference/processors/prompt-injection-detector.mdx +2 -2
- package/.docs/raw/reference/processors/semantic-recall-processor.mdx +2 -2
- package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +2 -2
- package/.docs/raw/reference/processors/token-limiter-processor.mdx +2 -2
- package/.docs/raw/reference/processors/tool-call-filter.mdx +3 -3
- package/.docs/raw/reference/processors/unicode-normalizer.mdx +2 -2
- package/.docs/raw/reference/processors/working-memory-processor.mdx +3 -3
- package/.docs/raw/reference/rag/chunk.mdx +1 -1
- package/.docs/raw/reference/rag/extract-params.mdx +2 -2
- package/.docs/raw/reference/rag/metadata-filters.mdx +7 -7
- package/.docs/raw/reference/server/create-route.mdx +13 -13
- package/.docs/raw/reference/server/express-adapter.mdx +6 -7
- package/.docs/raw/reference/server/hono-adapter.mdx +6 -7
- package/.docs/raw/reference/server/mastra-server.mdx +20 -20
- package/.docs/raw/reference/storage/cloudflare-d1.mdx +3 -3
- package/.docs/raw/reference/storage/cloudflare.mdx +2 -2
- package/.docs/raw/reference/storage/convex.mdx +6 -6
- package/.docs/raw/reference/storage/dynamodb.mdx +4 -4
- package/.docs/raw/reference/storage/lance.mdx +3 -3
- package/.docs/raw/reference/storage/libsql.mdx +69 -54
- package/.docs/raw/reference/storage/mongodb.mdx +80 -7
- package/.docs/raw/reference/storage/mssql.mdx +4 -4
- package/.docs/raw/{memory → reference}/storage/overview.mdx +12 -110
- package/.docs/raw/reference/storage/postgresql.mdx +78 -7
- package/.docs/raw/reference/storage/upstash.mdx +74 -2
- package/.docs/raw/reference/streaming/agents/stream.mdx +5 -5
- package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +2 -2
- package/.docs/raw/reference/streaming/workflows/observeStream.mdx +1 -1
- package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +1 -1
- package/.docs/raw/reference/streaming/workflows/stream.mdx +2 -2
- package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +4 -4
- package/.docs/raw/reference/templates/overview.mdx +1 -2
- package/.docs/raw/reference/tools/create-tool.mdx +1 -4
- package/.docs/raw/reference/tools/vector-query-tool.mdx +1 -1
- package/.docs/raw/reference/vectors/astra.mdx +3 -3
- package/.docs/raw/reference/vectors/chroma.mdx +3 -3
- package/.docs/raw/reference/vectors/convex.mdx +12 -12
- package/.docs/raw/reference/vectors/couchbase.mdx +5 -5
- package/.docs/raw/reference/vectors/duckdb.mdx +10 -10
- package/.docs/raw/reference/vectors/elasticsearch.mdx +4 -4
- package/.docs/raw/reference/vectors/lance.mdx +4 -4
- package/.docs/raw/reference/vectors/libsql.mdx +61 -11
- package/.docs/raw/reference/vectors/mongodb.mdx +58 -5
- package/.docs/raw/reference/vectors/pg.mdx +53 -6
- package/.docs/raw/reference/vectors/pinecone.mdx +3 -3
- package/.docs/raw/reference/vectors/qdrant.mdx +3 -3
- package/.docs/raw/reference/vectors/s3vectors.mdx +6 -6
- package/.docs/raw/reference/vectors/turbopuffer.mdx +4 -4
- package/.docs/raw/reference/vectors/upstash.mdx +55 -6
- package/.docs/raw/reference/vectors/vectorize.mdx +3 -3
- package/.docs/raw/reference/workflows/run-methods/cancel.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/restart.mdx +1 -3
- package/.docs/raw/reference/workflows/run-methods/resume.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/start.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +5 -5
- package/.docs/raw/reference/workflows/run.mdx +1 -1
- package/.docs/raw/reference/workflows/step.mdx +3 -3
- package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +3 -3
- package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +6 -6
- package/.docs/raw/reference/workflows/workflow-methods/map.mdx +7 -7
- package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow.mdx +3 -3
- package/.docs/raw/server/auth/auth0.mdx +20 -14
- package/.docs/raw/server/auth/clerk.mdx +16 -9
- package/.docs/raw/server/auth/firebase.mdx +21 -15
- package/.docs/raw/server/auth/jwt.mdx +14 -7
- package/.docs/raw/server/auth/supabase.mdx +16 -9
- package/.docs/raw/server/auth/workos.mdx +19 -13
- package/.docs/raw/server/custom-adapters.mdx +10 -10
- package/.docs/raw/server/custom-api-routes.mdx +2 -4
- package/.docs/raw/server/mastra-client.mdx +24 -13
- package/.docs/raw/server/mastra-server.mdx +3 -3
- package/.docs/raw/server/middleware.mdx +7 -7
- package/.docs/raw/server/request-context.mdx +31 -30
- package/.docs/raw/server/server-adapters.mdx +6 -6
- package/.docs/raw/streaming/events.mdx +14 -7
- package/.docs/raw/streaming/overview.mdx +21 -10
- package/.docs/raw/streaming/tool-streaming.mdx +6 -6
- package/.docs/raw/streaming/workflow-streaming.mdx +6 -8
- package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -2
- package/.docs/raw/tools-mcp/mcp-overview.mdx +31 -12
- package/.docs/raw/tools-mcp/overview.mdx +9 -10
- package/.docs/raw/voice/overview.mdx +1 -1
- package/.docs/raw/workflows/agents-and-tools.mdx +28 -19
- package/.docs/raw/workflows/control-flow.mdx +27 -40
- package/.docs/raw/workflows/error-handling.mdx +15 -22
- package/.docs/raw/workflows/human-in-the-loop.mdx +6 -7
- package/.docs/raw/workflows/inngest-workflow.mdx +8 -9
- package/.docs/raw/workflows/input-data-mapping.mdx +7 -7
- package/.docs/raw/workflows/overview.mdx +33 -22
- package/.docs/raw/workflows/snapshots.mdx +14 -44
- package/.docs/raw/workflows/suspend-and-resume.mdx +7 -7
- package/.docs/raw/workflows/time-travel.mdx +16 -16
- package/.docs/raw/workflows/workflow-state.mdx +5 -8
- package/CHANGELOG.md +9 -0
- package/dist/logger.d.ts +3 -0
- package/dist/logger.d.ts.map +1 -1
- package/dist/stdio.js +53 -0
- package/package.json +4 -4
- package/.docs/raw/memory/conversation-history.mdx +0 -24
- package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
- package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
- package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
- package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
- package/.docs/raw/memory/threads-and-resources.mdx +0 -95
|
@@ -24,7 +24,7 @@ Clone this [boilerplate repository](https://github.com/mastra-ai/express-ts-boil
|
|
|
24
24
|
<Tabs>
|
|
25
25
|
<TabItem value="https" label="HTTPS">
|
|
26
26
|
|
|
27
|
-
```bash
|
|
27
|
+
```bash
|
|
28
28
|
git clone https://github.com/mastra-ai/express-ts-boilerplate.git
|
|
29
29
|
cd express-ts-boilerplate
|
|
30
30
|
npm install
|
|
@@ -33,7 +33,7 @@ npm install
|
|
|
33
33
|
</TabItem>
|
|
34
34
|
<TabItem value="ssh" label="SSH">
|
|
35
35
|
|
|
36
|
-
```bash
|
|
36
|
+
```bash
|
|
37
37
|
git clone git@github.com:mastra-ai/express-ts-boilerplate.git
|
|
38
38
|
cd express-ts-boilerplate
|
|
39
39
|
npm install
|
|
@@ -48,7 +48,7 @@ Inside your Express project directory, run [`mastra init`](/reference/v1/cli/mas
|
|
|
48
48
|
|
|
49
49
|
When prompted, choose a provider (e.g. OpenAI) and enter your key:
|
|
50
50
|
|
|
51
|
-
```bash
|
|
51
|
+
```bash
|
|
52
52
|
npx mastra@beta init
|
|
53
53
|
```
|
|
54
54
|
|
|
@@ -64,13 +64,13 @@ You'll pass the `src/mastra/index.ts` file to the Express server adapter later.
|
|
|
64
64
|
|
|
65
65
|
Install the Express server adapter package:
|
|
66
66
|
|
|
67
|
-
```bash
|
|
67
|
+
```bash
|
|
68
68
|
npm install @mastra/express@beta
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
Open the Express entry file at `src/index.ts` and add the required import and initialization code:
|
|
72
72
|
|
|
73
|
-
```typescript
|
|
73
|
+
```typescript {2-3,11-12} title="src/index.ts"
|
|
74
74
|
import express, { type Request, type Response } from "express";
|
|
75
75
|
import { MastraServer } from "@mastra/express";
|
|
76
76
|
import { mastra } from "./mastra";
|
|
@@ -103,13 +103,13 @@ By default, Mastra's endpoints are added under the `/api` subpath and use your a
|
|
|
103
103
|
|
|
104
104
|
Start your Express server:
|
|
105
105
|
|
|
106
|
-
```bash
|
|
106
|
+
```bash
|
|
107
107
|
npm run start
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
In a separate terminal window, use `curl` to ask the weather agent:
|
|
111
111
|
|
|
112
|
-
```bash
|
|
112
|
+
```bash
|
|
113
113
|
curl -X POST http://localhost:3000/api/agents/weather-agent/generate -H "Content-Type: application/json" -d "{\"messages\":[{\"role\":\"user\",\"content\":\"What is the weather like in Seoul?\"}]}"
|
|
114
114
|
```
|
|
115
115
|
|
|
@@ -24,28 +24,28 @@ Run the following command to [create a new Hono app](https://hono.dev/docs/getti
|
|
|
24
24
|
<Tabs groupId="pm">
|
|
25
25
|
<TabItem value="npm" label="npm">
|
|
26
26
|
|
|
27
|
-
```bash
|
|
27
|
+
```bash
|
|
28
28
|
npm create hono@latest mastra-hono -- --template nodejs --install --pm npm
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
</TabItem>
|
|
32
32
|
<TabItem value="pnpm" label="pnpm">
|
|
33
33
|
|
|
34
|
-
```bash
|
|
34
|
+
```bash
|
|
35
35
|
pnpm create hono@latest mastra-hono --template nodejs --install --pm pnpm
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
</TabItem>
|
|
39
39
|
<TabItem value="yarn" label="yarn">
|
|
40
40
|
|
|
41
|
-
```bash
|
|
41
|
+
```bash
|
|
42
42
|
yarn create hono@latest mastra-hono --template nodejs --install --pm yarn
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
</TabItem>
|
|
46
46
|
<TabItem value="bun" label="bun">
|
|
47
47
|
|
|
48
|
-
```bash
|
|
48
|
+
```bash
|
|
49
49
|
bun create hono@latest mastra-hono --template nodejs --install --pm bun
|
|
50
50
|
```
|
|
51
51
|
|
|
@@ -63,7 +63,7 @@ When prompted, choose a provider (e.g. OpenAI) and enter your key:
|
|
|
63
63
|
<Tabs groupId="pm">
|
|
64
64
|
<TabItem value="npm" label="npm">
|
|
65
65
|
|
|
66
|
-
```bash
|
|
66
|
+
```bash
|
|
67
67
|
cd mastra-hono
|
|
68
68
|
npx mastra@beta init
|
|
69
69
|
```
|
|
@@ -71,7 +71,7 @@ npx mastra@beta init
|
|
|
71
71
|
</TabItem>
|
|
72
72
|
<TabItem value="pnpm" label="pnpm">
|
|
73
73
|
|
|
74
|
-
```bash
|
|
74
|
+
```bash
|
|
75
75
|
cd mastra-hono
|
|
76
76
|
pnpm dlx mastra@beta init
|
|
77
77
|
```
|
|
@@ -79,7 +79,7 @@ pnpm dlx mastra@beta init
|
|
|
79
79
|
</TabItem>
|
|
80
80
|
<TabItem value="yarn" label="yarn">
|
|
81
81
|
|
|
82
|
-
```bash
|
|
82
|
+
```bash
|
|
83
83
|
cd mastra-hono
|
|
84
84
|
yarn dlx mastra@beta init
|
|
85
85
|
```
|
|
@@ -87,7 +87,7 @@ yarn dlx mastra@beta init
|
|
|
87
87
|
</TabItem>
|
|
88
88
|
<TabItem value="bun" label="bun">
|
|
89
89
|
|
|
90
|
-
```bash
|
|
90
|
+
```bash
|
|
91
91
|
cd mastra-hono
|
|
92
92
|
bunx mastra@beta init
|
|
93
93
|
```
|
|
@@ -110,28 +110,28 @@ Install the Hono server adapter package:
|
|
|
110
110
|
<Tabs groupId="pm">
|
|
111
111
|
<TabItem value="npm" label="npm">
|
|
112
112
|
|
|
113
|
-
```bash
|
|
113
|
+
```bash
|
|
114
114
|
npm install @mastra/hono@beta
|
|
115
115
|
```
|
|
116
116
|
|
|
117
117
|
</TabItem>
|
|
118
118
|
<TabItem value="pnpm" label="pnpm">
|
|
119
119
|
|
|
120
|
-
```bash
|
|
120
|
+
```bash
|
|
121
121
|
pnpm add @mastra/hono@beta
|
|
122
122
|
```
|
|
123
123
|
|
|
124
124
|
</TabItem>
|
|
125
125
|
<TabItem value="yarn" label="yarn">
|
|
126
126
|
|
|
127
|
-
```bash
|
|
127
|
+
```bash
|
|
128
128
|
yarn add @mastra/hono@beta
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
</TabItem>
|
|
132
132
|
<TabItem value="bun" label="bun">
|
|
133
133
|
|
|
134
|
-
```bash
|
|
134
|
+
```bash
|
|
135
135
|
bun add @mastra/hono@beta
|
|
136
136
|
```
|
|
137
137
|
|
|
@@ -140,7 +140,7 @@ bun add @mastra/hono@beta
|
|
|
140
140
|
|
|
141
141
|
Open the Hono entry file at `src/index.ts` and add the required import and initialization code:
|
|
142
142
|
|
|
143
|
-
```typescript
|
|
143
|
+
```typescript title="src/index.ts" {3-8,10-11,13}
|
|
144
144
|
import { serve } from '@hono/node-server'
|
|
145
145
|
import { Hono } from 'hono'
|
|
146
146
|
import {
|
|
@@ -178,28 +178,28 @@ Start your Hono server:
|
|
|
178
178
|
<Tabs groupId="pm">
|
|
179
179
|
<TabItem value="npm" label="npm">
|
|
180
180
|
|
|
181
|
-
```bash
|
|
181
|
+
```bash
|
|
182
182
|
npm run dev
|
|
183
183
|
```
|
|
184
184
|
|
|
185
185
|
</TabItem>
|
|
186
186
|
<TabItem value="pnpm" label="pnpm">
|
|
187
187
|
|
|
188
|
-
```bash
|
|
188
|
+
```bash
|
|
189
189
|
pnpm run dev
|
|
190
190
|
```
|
|
191
191
|
|
|
192
192
|
</TabItem>
|
|
193
193
|
<TabItem value="yarn" label="yarn">
|
|
194
194
|
|
|
195
|
-
```bash
|
|
195
|
+
```bash
|
|
196
196
|
yarn run dev
|
|
197
197
|
```
|
|
198
198
|
|
|
199
199
|
</TabItem>
|
|
200
200
|
<TabItem value="bun" label="bun">
|
|
201
201
|
|
|
202
|
-
```bash
|
|
202
|
+
```bash
|
|
203
203
|
bun run dev
|
|
204
204
|
```
|
|
205
205
|
|
|
@@ -208,7 +208,7 @@ bun run dev
|
|
|
208
208
|
|
|
209
209
|
In a separate terminal window, use `curl` to ask the weather agent:
|
|
210
210
|
|
|
211
|
-
```bash
|
|
211
|
+
```bash
|
|
212
212
|
curl -X POST http://localhost:3000/api/agents/weather-agent/generate -H "Content-Type: application/json" -d "{\"messages\":[{\"role\":\"user\",\"content\":\"What is the weather like in Seoul?\"}]}"
|
|
213
213
|
```
|
|
214
214
|
|
|
@@ -31,28 +31,28 @@ Run the following command to [create a new Next.js app](https://nextjs.org/docs/
|
|
|
31
31
|
<Tabs groupId="pm">
|
|
32
32
|
<TabItem value="npm" label="npm">
|
|
33
33
|
|
|
34
|
-
```bash
|
|
34
|
+
```bash
|
|
35
35
|
npx create-next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
</TabItem>
|
|
39
39
|
<TabItem value="pnpm" label="pnpm">
|
|
40
40
|
|
|
41
|
-
```bash
|
|
41
|
+
```bash
|
|
42
42
|
pnpm create next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
</TabItem>
|
|
46
46
|
<TabItem value="yarn" label="yarn">
|
|
47
47
|
|
|
48
|
-
```bash
|
|
48
|
+
```bash
|
|
49
49
|
yarn create next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
</TabItem>
|
|
53
53
|
<TabItem value="bun" label="bun">
|
|
54
54
|
|
|
55
|
-
```bash
|
|
55
|
+
```bash
|
|
56
56
|
bun create next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
|
|
57
57
|
```
|
|
58
58
|
|
|
@@ -70,7 +70,7 @@ When prompted, choose a provider (e.g. OpenAI) and enter your key:
|
|
|
70
70
|
<Tabs groupId="pm">
|
|
71
71
|
<TabItem value="npm" label="npm">
|
|
72
72
|
|
|
73
|
-
```bash
|
|
73
|
+
```bash
|
|
74
74
|
cd my-nextjs-agent
|
|
75
75
|
npx --force mastra@beta init
|
|
76
76
|
```
|
|
@@ -78,7 +78,7 @@ npx --force mastra@beta init
|
|
|
78
78
|
</TabItem>
|
|
79
79
|
<TabItem value="pnpm" label="pnpm">
|
|
80
80
|
|
|
81
|
-
```bash
|
|
81
|
+
```bash
|
|
82
82
|
cd my-nextjs-agent
|
|
83
83
|
pnpm dlx mastra@beta init
|
|
84
84
|
```
|
|
@@ -86,7 +86,7 @@ pnpm dlx mastra@beta init
|
|
|
86
86
|
</TabItem>
|
|
87
87
|
<TabItem value="yarn" label="yarn">
|
|
88
88
|
|
|
89
|
-
```bash
|
|
89
|
+
```bash
|
|
90
90
|
cd my-nextjs-agent
|
|
91
91
|
yarn dlx mastra@beta init
|
|
92
92
|
```
|
|
@@ -94,7 +94,7 @@ yarn dlx mastra@beta init
|
|
|
94
94
|
</TabItem>
|
|
95
95
|
<TabItem value="bun" label="bun">
|
|
96
96
|
|
|
97
|
-
```bash
|
|
97
|
+
```bash
|
|
98
98
|
cd my-nextjs-agent
|
|
99
99
|
bunx mastra@beta init
|
|
100
100
|
```
|
|
@@ -117,28 +117,28 @@ Install AI SDK UI along with the Mastra adapter:
|
|
|
117
117
|
<Tabs groupId="pm">
|
|
118
118
|
<TabItem value="npm" label="npm">
|
|
119
119
|
|
|
120
|
-
```bash
|
|
120
|
+
```bash
|
|
121
121
|
npm install @mastra/ai-sdk@beta @ai-sdk/react ai
|
|
122
122
|
```
|
|
123
123
|
|
|
124
124
|
</TabItem>
|
|
125
125
|
<TabItem value="pnpm" label="pnpm">
|
|
126
126
|
|
|
127
|
-
```bash
|
|
127
|
+
```bash
|
|
128
128
|
pnpm add @mastra/ai-sdk@beta @ai-sdk/react ai
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
</TabItem>
|
|
132
132
|
<TabItem value="yarn" label="yarn">
|
|
133
133
|
|
|
134
|
-
```bash
|
|
134
|
+
```bash
|
|
135
135
|
yarn add @mastra/ai-sdk@beta @ai-sdk/react ai
|
|
136
136
|
```
|
|
137
137
|
|
|
138
138
|
</TabItem>
|
|
139
139
|
<TabItem value="bun" label="bun">
|
|
140
140
|
|
|
141
|
-
```bash
|
|
141
|
+
```bash
|
|
142
142
|
bun add @mastra/ai-sdk@beta @ai-sdk/react ai
|
|
143
143
|
```
|
|
144
144
|
|
|
@@ -150,28 +150,28 @@ Next, initialize AI Elements. When prompted, choose the default options:
|
|
|
150
150
|
<Tabs groupId="pm">
|
|
151
151
|
<TabItem value="npm" label="npm">
|
|
152
152
|
|
|
153
|
-
```bash
|
|
153
|
+
```bash
|
|
154
154
|
npx ai-elements@latest
|
|
155
155
|
```
|
|
156
156
|
|
|
157
157
|
</TabItem>
|
|
158
158
|
<TabItem value="pnpm" label="pnpm">
|
|
159
159
|
|
|
160
|
-
```bash
|
|
160
|
+
```bash
|
|
161
161
|
pnpm dlx ai-elements@latest
|
|
162
162
|
```
|
|
163
163
|
|
|
164
164
|
</TabItem>
|
|
165
165
|
<TabItem value="yarn" label="yarn">
|
|
166
166
|
|
|
167
|
-
```bash
|
|
167
|
+
```bash
|
|
168
168
|
yarn dlx ai-elements@latest
|
|
169
169
|
```
|
|
170
170
|
|
|
171
171
|
</TabItem>
|
|
172
172
|
<TabItem value="bun" label="bun">
|
|
173
173
|
|
|
174
|
-
```bash
|
|
174
|
+
```bash
|
|
175
175
|
bunx ai-elements@latest
|
|
176
176
|
```
|
|
177
177
|
|
|
@@ -198,7 +198,7 @@ export async function POST(req: Request) {
|
|
|
198
198
|
const params = await req.json();
|
|
199
199
|
const stream = await handleChatStream({
|
|
200
200
|
mastra,
|
|
201
|
-
agentId: '
|
|
201
|
+
agentId: 'weather-agent',
|
|
202
202
|
params: {
|
|
203
203
|
...params,
|
|
204
204
|
memory: {
|
|
@@ -212,7 +212,7 @@ export async function POST(req: Request) {
|
|
|
212
212
|
}
|
|
213
213
|
|
|
214
214
|
export async function GET() {
|
|
215
|
-
const memory = await mastra.
|
|
215
|
+
const memory = await mastra.getAgentById('weather-agent').getMemory()
|
|
216
216
|
let response = null
|
|
217
217
|
|
|
218
218
|
try {
|
|
@@ -230,7 +230,7 @@ export async function GET() {
|
|
|
230
230
|
}
|
|
231
231
|
```
|
|
232
232
|
|
|
233
|
-
The POST route accepts a prompt and streams the agent's response back in AI SDK format, while the GET route fetches message history from memory so the UI can be hydrated when the client reloads.
|
|
233
|
+
The `POST` route accepts a prompt and streams the agent's response back in AI SDK format, while the `GET` route fetches message history from memory so the UI can be hydrated when the client reloads.
|
|
234
234
|
|
|
235
235
|
## Create a chat page
|
|
236
236
|
|
|
@@ -362,7 +362,6 @@ This component connects [`useChat()`](https://ai-sdk.dev/docs/reference/ai-sdk-u
|
|
|
362
362
|
|
|
363
363
|
It renders the response text using the [`<MessageResponse>`](https://ai-sdk.dev/elements/components/message#messageresponse-) component, and shows any tool invocations with the [`<Tool>`](https://ai-sdk.dev/elements/components/tool) component.
|
|
364
364
|
|
|
365
|
-
|
|
366
365
|
## Test your agent
|
|
367
366
|
|
|
368
367
|
1. Run your Next.js app with `npm run dev`
|
|
@@ -28,28 +28,28 @@ When prompted, choose a provider (e.g. OpenAI) and enter your key:
|
|
|
28
28
|
<Tabs>
|
|
29
29
|
<TabItem value="npm" label="npm">
|
|
30
30
|
|
|
31
|
-
```bash
|
|
31
|
+
```bash
|
|
32
32
|
npm create mastra@beta
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
</TabItem>
|
|
36
36
|
<TabItem value="pnpm" label="pnpm">
|
|
37
37
|
|
|
38
|
-
```bash
|
|
38
|
+
```bash
|
|
39
39
|
pnpm create mastra@beta
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
</TabItem>
|
|
43
43
|
<TabItem value="yarn" label="yarn">
|
|
44
44
|
|
|
45
|
-
```bash
|
|
45
|
+
```bash
|
|
46
46
|
yarn create mastra@beta
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
</TabItem>
|
|
50
50
|
<TabItem value="bun" label="bun">
|
|
51
51
|
|
|
52
|
-
```bash
|
|
52
|
+
```bash
|
|
53
53
|
bun create mastra@beta
|
|
54
54
|
```
|
|
55
55
|
|