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

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,44 @@
 # mastra
 
+## 1.0.0-beta.12
+
+### Minor Changes
+
+- Add Antigravity IDE support to create-mastra CLI. Users can now select Antigravity during project initialization and automatically configure the global Mastra MCP server for the IDE, reducing manual setup and enabling immediate use of Mastra agents. ([#11374](https://github.com/mastra-ai/mastra/pull/11374))
+
+- Add --studio flag to bundle playground UI with mastra build ([#11327](https://github.com/mastra-ai/mastra/pull/11327))
+
+  Enables bundling the studio/playground UI into the build output so it can be served from the deployed server.
+
+  ```bash
+  mastra build --studio
+  ```
+
+- Added CLI options to configure Mastra Studio runtime settings, allowing you to customize the server connection details, and protocol. ([#11265](https://github.com/mastra-ai/mastra/pull/11265))
+
+  You can now override the default studio configuration using command-line arguments:
+
+  ```bash
+  mastra studio \
+    --server-host api.example.com \
+    --server-port 8080 \
+    --server-protocol https
+  ```
+
+  These options configure the `window.MASTRA_*` environment variables that the Studio frontend uses to connect to your API server.
+
+### Patch Changes
+
+- Extract getDurationMs helper method to simplify command execution timing in CLI analytics. Replaces repeated process.hrtime logic with a reusable private helper method, improving code maintainability and reducing duplication. ([#11316](https://github.com/mastra-ai/mastra/pull/11316))
+
+- Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
+
+- Detect installed Mastra packages during dev and pass version information to the playground server via `MASTRA_PACKAGES_FILE` env var ([#11211](https://github.com/mastra-ai/mastra/pull/11211))
+
+- Updated dependencies [[`403c643`](https://github.com/mastra-ai/mastra/commit/403c643ea02862f3177d4b92e85b09f83aed3eb3), [`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`2fe69cb`](https://github.com/mastra-ai/mastra/commit/2fe69cbfda1025a7cf440308eed26c77ec553e1a), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`4da09a4`](https://github.com/mastra-ai/mastra/commit/4da09a4b95262be57c912821d6d8108868ae59db), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
+  - @mastra/deployer@1.0.0-beta.15
+  - @mastra/core@1.0.0-beta.15
+
 ## 1.0.0-beta.11
 
 ### Patch Changes
@@ -460,43 +499,4 @@
 
 - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
 
-- Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
-
-- Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
-
-- Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
-
-- Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
-
-- Updated dependencies [[`0fb6616`](https://github.com/mastra-ai/mastra/commit/0fb66169600ed2a3dc1297b1bfa8a7693ebb6e3c), [`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`1dbd76a`](https://github.com/mastra-ai/mastra/commit/1dbd76aff29cc764d3a1ac7bb01172fe59cb5992), [`f59fc1e`](https://github.com/mastra-ai/mastra/commit/f59fc1e406b8912e692f6bff6cfd4754cc8d165c), [`ca5a01f`](https://github.com/mastra-ai/mastra/commit/ca5a01f0dd4dabdbfde3beeaf92c7333e0f9bb39), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`a1799bc`](https://github.com/mastra-ai/mastra/commit/a1799bcc1b5a1cdc188f2ac0165f17a1c4ac6f7b), [`6ff6094`](https://github.com/mastra-ai/mastra/commit/6ff60946f4ecfebdeef6e21d2b230c2204f2c9b8), [`2ddb851`](https://github.com/mastra-ai/mastra/commit/2ddb8519c4b6f1d31be10ffd33b41d2b649a04ff), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`dfe856f`](https://github.com/mastra-ai/mastra/commit/dfe856f7f60ff4765b75930e7b5d82dd0f0f7d89), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1908ca0`](https://github.com/mastra-ai/mastra/commit/1908ca0521f90e43779cc29ab590173ca560443c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`ee68e82`](https://github.com/mastra-ai/mastra/commit/ee68e8289ea4408d29849e899bc6e78b3bd4e843), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`ea33930`](https://github.com/mastra-ai/mastra/commit/ea339301e82d6318257720d811b043014ee44064), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`e0e1cf1`](https://github.com/mastra-ai/mastra/commit/e0e1cf1e37b9dc61099ab331a6d386e44b816310), [`135d6f2`](https://github.com/mastra-ai/mastra/commit/135d6f22a326ed1dffff858700669dff09d2c9eb)]:
-  - @mastra/deployer@0.21.0
-  - @mastra/core@0.21.0
-  - @mastra/loggers@0.10.16
-  - @mastra/mcp@0.13.5
-
-## 0.16.0-alpha.1
-
-### Minor Changes
-
-- Update peer dependencies to match core package version bump (0.21.0) ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
-
-### Patch Changes
-
-- Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
-
-- Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
-
-- Add support for --debug options to build/dev commands to add more logging ([#8792](https://github.com/mastra-ai/mastra/pull/8792))
-
-- Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
-
-- Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
-
-- Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
-
-- Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
-
-- Updated dependencies [[`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`ca5a01f`](https://github.com/mastra-ai/mastra/commit/ca5a01f0dd4dabdbfde3beeaf92c7333e0f9bb39), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`dfe856f`](https://github.com/mastra-ai/mastra/commit/dfe856f7f60ff4765b75930e7b5d82dd0f0f7d89), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61), [`e0e1cf1`](https://github.com/mastra-ai/mastra/commit/e0e1cf1e37b9dc61099ab331a6d386e44b816310)]:
-  - @mastra/core@0.21.0-alpha.1
-
-... 6420 more lines hidden. See full changelog in package directory.
+... 6459 more lines hidden. See full changelog in package directory.

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" />