@mastra/mcp-docs-server 1.0.0-beta.14 → 1.0.0-beta.15

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

@@ -5,9 +5,9 @@
   "dependencies": {
     "zod": "^3",
     "typescript": "^5.8.3",
-    "@ai-sdk/openai": "3.0.0-beta.96",
-    "@ai-sdk/provider": "3.0.0-beta.26",
-    "ai": "^6.0.0-beta.149",
+    "@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",
@@ -16,7 +16,8 @@
     "@mastra/mcp": "beta",
     "@mastra/memory": "beta",
     "@mastra/observability": "beta",
-    "@mastra/voice-openai": "beta"
+    "@mastra/voice-openai": "beta",
+    "@mastra/ai-sdk": "beta"
   },
   "devDependencies": {
     "mastra": "beta",
@@ -54,8 +55,9 @@ console.log(result.object);
 ```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 } from '../tools';
+import { weatherInfo, weatherTool } from '../tools';
 
 const memory = new Memory();
 
@@ -65,21 +67,51 @@ export const weatherAgent = new Agent({
   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'),
-  tools: { weatherInfo },
+  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 { PinoLogger } from '@mastra/loggers';
 import { LibSQLStore } from '@mastra/libsql';
+import { weatherAgent, weatherToolLoopAgent } from './agents';
 import { Observability } from '@mastra/observability';
 
-import { weatherAgent } from './agents';
-
 const storage = new LibSQLStore({
   id: 'mastra-storage',
   url: 'file:./mastra.db',
@@ -88,6 +120,7 @@ const storage = new LibSQLStore({
 export const mastra = new Mastra({
   storage,
   agents: {
+    weatherToolLoopAgent,
     weatherAgent,
   },
   bundler: {
@@ -98,7 +131,6 @@ export const mastra = new Mastra({
       swaggerUI: true,
     },
   },
-  logger: new PinoLogger({ name: 'Chef', level: 'debug' }),
   observability: new Observability({
     default: { enabled: true },
   }),
@@ -109,6 +141,7 @@ export const mastra = new Mastra({
 ### mastra/tools/index.ts
 ```typescript
 import { createTool } from '@mastra/core/tools';
+import { tool } from 'ai';
 import { z } from 'zod';
 
 export const weatherInfo = createTool({
@@ -129,12 +162,38 @@ export const weatherInfo = createTool({
   },
 });
 
+// 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 { weatherAgent } from './mastra/agents';
+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: {

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

@@ -21,7 +21,7 @@
     "globals": "^16.5.0",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.38.0",
-    "vite": "^7.1.9"
+    "vite": "^7.3.0"
   }
 }
 ```

package/.docs/raw/agents/adding-voice.mdx

@@ -1,8 +1,8 @@
 ---
-title: "Adding Voice to Agents | Agents"
+title: "Voice | Agents"
 ---
 
-# Adding Voice to Agents
+# Voice
 
 Mastra agents can be enhanced with voice capabilities, allowing them to speak responses and listen to user input. You can configure an agent to use either a single voice provider or combine multiple providers for different operations.
 
@@ -348,4 +348,9 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 | Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](/reference/v1/voice/mastra-voice)    |
 | Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](/reference/v1/voice/mastra-voice)    |
 
-For more details on voice capabilities, see the [Voice API Reference](/reference/v1/voice/mastra-voice).
+## Next Steps
+
+- [Voice API Reference](/reference/v1/voice/mastra-voice) - Detailed API documentation for voice capabilities
+- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech) - Interactive story generator and other TTS implementations
+- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text) - Voice memo app and other STT implementations
+- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech) - Real-time voice conversation with call analysis

package/.docs/raw/deployment/overview.mdx

@@ -22,7 +22,7 @@ Mastra can run against any of these runtime environments:
 
 Mastra provides a [server](/docs/v1/server/mastra-server) powered by Hono that can be deployed independently. Use the `mastra build` command to build your application and deploy the output to your preferred VM, container, or PaaS platform.
 
-See the [Mastra server deployment guide](/docs/v1/deployment/mastra-server).
+Visit the [Mastra server deployment guide](/docs/v1/deployment/mastra-server).
 
 ### Monorepo
 
@@ -58,7 +58,6 @@ Learn more in the [Mastra Cloud docs](/docs/v1/mastra-cloud/overview).
 
 ## Workflow Runners
 
-Mastra supports deploying workflows to specialized workflow execution platforms that handle orchestration, monitoring, and reliability. [Inngest](https://www.inngest.com) is a developer platform for running background workflows without managing infrastructure. Mastra workflows can be deployed to Inngest, which provides step memoization, automatic retries, real-time monitoring, and suspend/resume capabilities.
+Mastra workflows run using the built-in execution engine by default. For production workloads requiring managed infrastructure, workflows can also be deployed to specialized platforms like [Inngest](https://www.inngest.com) that provide step memoization, automatic retries, and real-time monitoring.
 
-- [Inngest deployment guide](/guides/v1/deployment/inngest)
-- [Inngest workflow example](https://github.com/mastra-ai/mastra/tree/main/examples/inngest)
+Visit the [Workflow Runners guide](/docs/v1/deployment/workflow-runners) for execution options and the [Inngest deployment guide](/guides/v1/deployment/inngest) for setup instructions.

package/.docs/raw/deployment/workflow-runners.mdx

@@ -0,0 +1,14 @@
+---
+title: "Workflow Runners | Deployment"
+description: "Deploy Mastra workflows to specialized workflow execution platforms"
+---
+
+# Workflow Runners
+
+Mastra [workflows](../workflows/overview.mdx) can be executed using the built-in workflow runner or deployed to specialized workflow execution platforms that handle orchestration, monitoring, and reliability.
+
+## Inngest
+
+Inngest is a developer platform for running background workflows without managing infrastructure. Mastra workflows can be deployed to Inngest, which provides step memoization, automatic retries, real-time monitoring, and suspend/resume capabilities.
+
+Visit the [Inngest deployment guide](/guides/v1/deployment/inngest) for setup instructions and the [Inngest workflow example](https://github.com/mastra-ai/mastra/tree/main/examples/inngest) for a complete implementation.

package/.docs/raw/getting-started/studio.mdx

@@ -14,7 +14,7 @@ Studio provides an interactive UI for building and testing your agents, along wi
 
 As your project evolves, Studio's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
 
-To get started, run Studio locally using the instructions below, or [create a project in Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
+To get started, run Studio locally using the instructions below, or [create a project in Mastra Cloud](/docs/v1/mastra-cloud/setup) to collaborate with your team.
 
 <YouTube id="ojGu6Bi4wYk" />