@mastra/mcp-docs-server 1.0.0-beta.9 → 1.0.0

package/.docs/organized/code-examples/a2a.md

@@ -7,13 +7,13 @@
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
     "@mastra/loggers": "link:../../packages/loggers",
-    "dotenv": "^16.3.1",
+    "dotenv": "^17.2.3",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "mastra": "latest",
     "tsx": "^4.7.0",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/agent-v6.md

@@ -0,0 +1,221 @@
+### package.json
+```json
+{
+  "name": "examples-agent",
+  "dependencies": {
+    "zod": "^3",
+    "typescript": "^5.9.3",
+    "@ai-sdk/openai": "^3.0.0",
+    "@ai-sdk/provider": "^3.0.0",
+    "ai": "^6.0.1",
+    "@mastra/client-js": "beta",
+    "@mastra/core": "beta",
+    "@mastra/evals": "beta",
+    "@mastra/libsql": "beta",
+    "@mastra/loggers": "beta",
+    "@mastra/mcp": "beta",
+    "@mastra/memory": "beta",
+    "@mastra/observability": "beta",
+    "@mastra/voice-openai": "beta",
+    "@mastra/ai-sdk": "beta"
+  },
+  "devDependencies": {
+    "mastra": "beta",
+    "msw": "^2.12.2"
+  }
+}
+```
+
+### js-client-structured-output-example.ts
+```typescript
+import z from 'zod';
+import { MastraClient } from '@mastra/client-js';
+
+const client = new MastraClient({
+  baseUrl: 'http://localhost:4111',
+});
+
+const agent = client.getAgent('weather-agent');
+
+const result = await agent.generate('weather in new york', {
+  structuredOutput: {
+    schema: z.object({
+      weather: z.string(),
+      temperature: z.number(),
+      humidity: z.number(),
+    }),
+  },
+});
+
+console.log(result.object);
+
+```
+
+### mastra/agents/index.ts
+```typescript
+import { Memory } from '@mastra/memory';
+import { Agent } from '@mastra/core/agent';
+import { stepCountIs, ToolLoopAgent } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { weatherInfo, weatherTool } from '../tools';
+
+const memory = new Memory();
+
+export const weatherAgent = new Agent({
+  id: 'weather-agent',
+  name: 'Weather Agent v6',
+  instructions: `Your goal is to provide weather information for cities when requested`,
+  description: `An agent that can help you get weather information for a given city`,
+  model: openai('gpt-4o-mini'),
+  defaultOptions: {
+    stopWhen: stepCountIs(1),
+  },
+  tools: {
+    weatherInfo,
+  },
+  memory,
+});
+
+// AI SDK ToolLoopAgent
+export const weatherToolLoopAgent = new ToolLoopAgent({
+  model: openai('gpt-4o-mini'),
+  instructions: 'You are a helpful weather assistant. Use the weather tool to get current conditions.',
+  stopWhen: stepCountIs(1),
+  tools: {
+    weather: weatherTool,
+  },
+  // temperature: 0.7,
+  // maxRetries: 2,
+  // stopWhen: stepCountIs(1),
+  // prepareCall: async args => {
+  //   console.log('prepareCall', args);
+  //   return args;
+  // },
+  // prepareStep: args => {
+  //   console.log('prepareStep', args);
+  //   return args;
+  // },
+  // onStepFinish: event => {
+  //   console.log('onStepFinish', event);
+  // },
+  // onFinish: event => {
+  //   console.log('onFinish', event);
+  // },
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core/mastra';
+import { LibSQLStore } from '@mastra/libsql';
+import { weatherAgent, weatherToolLoopAgent } from './agents';
+import { Observability, DefaultExporter, CloudExporter, SensitiveDataFilter } from '@mastra/observability';
+
+const storage = new LibSQLStore({
+  id: 'mastra-storage',
+  url: 'file:./mastra.db',
+});
+
+export const mastra = new Mastra({
+  storage,
+  agents: {
+    weatherToolLoopAgent,
+    weatherAgent,
+  },
+  bundler: {
+    sourcemap: true,
+  },
+  server: {
+    build: {
+      swaggerUI: true,
+    },
+  },
+  observability: new Observability({
+    configs: {
+      default: {
+        serviceName: 'mastra',
+        exporters: [
+          new DefaultExporter(), // Persists traces to storage for Mastra Studio
+          new CloudExporter(), // Sends traces to Mastra Cloud (if MASTRA_CLOUD_ACCESS_TOKEN is set)
+        ],
+        spanOutputProcessors: [
+          new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys
+        ],
+      },
+    },
+  }),
+});
+
+```
+
+### mastra/tools/index.ts
+```typescript
+import { createTool } from '@mastra/core/tools';
+import { tool } from 'ai';
+import { z } from 'zod';
+
+export const weatherInfo = createTool({
+  id: 'weather-info',
+  description: 'Fetches the current weather information for a given city',
+  inputSchema: z.object({
+    city: z.string(),
+  }),
+  execute: async ({ city }) => {
+    return {
+      city,
+      weather: 'sunny',
+      temperature_celsius: 19,
+      temperature_fahrenheit: 66,
+      humidity: 50,
+      wind: '10 mph',
+    };
+  },
+});
+
+// Create a tool using AI SDK's tool() helper
+export const weatherTool = tool({
+  description: 'Get the current weather for a city',
+  inputSchema: z.object({
+    city: z.string().describe('The city to get weather for'),
+  }),
+  outputSchema: z.object({
+    city: z.string(),
+    weather: z.string(),
+    temperature: z.number(),
+    unit: z.string(),
+  }),
+  execute: async ({ city }) => {
+    // Simulated weather data
+    return {
+      city,
+      weather: 'sunny',
+      temperature: 72,
+      unit: 'fahrenheit',
+    };
+  },
+});
+
+```
+
+### structured-output-example.ts
+```typescript
+import z from 'zod';
+import { mastra } from './mastra/index';
+// import { weatherAgent } from './mastra/agents';
+
+const weatherAgent = mastra.getAgent('weatherToolLoopAgent');
+
+const result = await weatherAgent.generate('weather in new york', {
+  structuredOutput: {
+    schema: z.object({
+      weather: z.string(),
+      temperature: z.number(),
+      humidity: z.number(),
+    }),
+  },
+});
+
+console.log(result.object);
+
+```

package/.docs/organized/code-examples/agui.md

@@ -22,14 +22,14 @@
     "@eslint/js": "^9.25.0",
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
-    "@typescript-eslint/parser": "^8.38.0",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
     "@vitejs/plugin-react": "^5.0.4",
     "eslint": "^9.37.0",
-    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
     "globals": "^16.0.0",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "vite": "^7.1.9"
   }
 }

package/.docs/organized/code-examples/ai-elements.md

@@ -21,7 +21,7 @@
     "embla-carousel-react": "^8.6.0",
     "lucide-react": "^0.544.0",
     "nanoid": "^5.1.6",
-    "next": "15.5.7",
+    "next": "15.5.9",
     "react": "19.1.0",
     "react-dom": "19.1.0",
     "react-syntax-highlighter": "^15.6.6",
@@ -38,10 +38,10 @@
     "@types/react-dom": "^19",
     "@types/react-syntax-highlighter": "^15.5.13",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "tailwindcss": "^4",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/ai-sdk-useChat.md

@@ -17,10 +17,10 @@
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/ai-sdk-v5.md

@@ -12,7 +12,7 @@
     "@mastra/pg": "latest",
     "@mastra/rag": "latest",
     "@mastra/server": "latest",
-    "hono": "^4.10.3",
+    "hono": "^4.11.3",
     "next": "^15.5.7",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
@@ -25,11 +25,11 @@
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "mastra": "latest",
     "postcss": "^8",
     "tailwindcss": "^3.4.1",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/assistant-ui.md

@@ -4,9 +4,9 @@
   "name": "examples-assistant-ui",
   "dependencies": {
     "@ai-sdk/openai": "latest",
-    "@assistant-ui/react": "0.10.45",
-    "@assistant-ui/react-markdown": "^0.10.9",
-    "@assistant-ui/react-ui": "^0.1.8",
+    "@assistant-ui/react": "0.11.53",
+    "@assistant-ui/react-markdown": "0.11.9",
+    "@assistant-ui/react-ui": "0.2.1",
     "@mastra/client-js": "latest",
     "next": "^15.5.7",
     "react": "^19.1.1",
@@ -19,10 +19,10 @@
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/bird-checker-with-express.md

@@ -11,7 +11,7 @@
     "nodemon": "^3.1.9",
     "ts-node": "^10.9.2",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "latest",

package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md

@@ -24,10 +24,10 @@
     "@types/react": "^19.1.12",
     "@types/react-dom": "^19.1.9",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/bird-checker-with-nextjs.md

@@ -8,7 +8,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.454.0",
-    "next": "^15.5.7",
+    "next": "^15.5.8",
     "next-themes": "^0.4.5",
     "nuqs": "^2.4.1",
     "react": "19.1.1",
@@ -24,10 +24,10 @@
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/client-side-tools.md

@@ -16,12 +16,12 @@
     "@types/react-dom": "^19.1.7",
     "@vitejs/plugin-react": "^5.0.4",
     "eslint": "^9.37.0",
-    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
     "globals": "^16.5.0",
-    "typescript": "~5.8.3",
-    "typescript-eslint": "^8.38.0",
-    "vite": "^7.1.9"
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.51.0",
+    "vite": "^7.3.0"
   }
 }
 ```

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -20,7 +20,7 @@
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.7",
     "@radix-ui/react-visually-hidden": "^1.2.3",
-    "@typescript-eslint/parser": "^8.38.0",
+    "@typescript-eslint/parser": "^8.51.0",
     "@vercel/analytics": "^1.5.0",
     "@vercel/blob": "^1.0.0",
     "@vercel/postgres": "^0.10.0",
@@ -31,12 +31,12 @@
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
     "diff-match-patch": "^1.0.5",
-    "dotenv": "^16.4.7",
+    "dotenv": "^17.2.3",
     "drizzle-orm": "^0.44.2",
     "framer-motion": "^12.7.4",
     "geist": "^1.3.1",
     "lucide-react": "^0.503.0",
-    "next": "^15.5.7",
+    "next": "^15.5.8",
     "next-auth": "4.24.12",
     "next-themes": "^0.4.6",
     "orderedmap": "^2.1.1",
@@ -72,7 +72,7 @@
     "@types/react-dom": "^19.1.7",
     "drizzle-kit": "^0.31.0",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
@@ -81,7 +81,7 @@
     "prettier": "^3.6.2",
     "tailwindcss": "^3.4.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/experimental-auth-weather-agent.md

@@ -16,7 +16,7 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "dotenv-cli": "^8.0.0"
+    "dotenv-cli": "^11.0.0"
   }
 }
 ```

package/.docs/organized/code-examples/fireworks-r1.md

@@ -11,7 +11,7 @@
     "@types/tinycolor2": "^1.4.6",
     "chalk": "^5.4.1",
     "gradient-string": "^3.0.0",
-    "ora": "^8.2.0",
+    "ora": "^9.0.0",
     "tinycolor2": "^1.6.0",
     "zod": "^3.25.76"
   },
@@ -20,7 +20,7 @@
     "dotenv": "^17.0.0",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/heads-up-game.md

@@ -7,16 +7,16 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.23",
-    "@mastra/core": "^0.23.1",
-    "@mastra/libsql": "^0.16.1",
-    "@mastra/loggers": "^0.10.18",
-    "@mastra/memory": "^0.15.9",
+    "@mastra/core": "^0.24.9",
+    "@mastra/libsql": "^0.16.4",
+    "@mastra/loggers": "^0.10.19",
+    "@mastra/memory": "^0.15.13",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "22.13.17",
-    "mastra": "^0.17.5",
-    "typescript": "^5.9.2"
+    "mastra": "^0.18.9",
+    "typescript": "^5.9.3"
   }
 }
 ```
@@ -47,7 +47,7 @@ Return only the person's name, nothing else.`,
   model: openai('gpt-4o'),
   memory: new Memory({
     vector: new LibSQLVector({
-      connectionUrl: 'file:../mastra.db',
+      url: 'file:../mastra.db',
     }),
     embedder: openai.embedding('text-embedding-3-small'),
     options: {