@mastra/mcp-docs-server 0.13.14-alpha.1 → 0.13.14-alpha.3

package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md

@@ -1,5 +1,16 @@
 # @mastra/voice-elevenlabs
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.9-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [b3a3d63]
 - Updated dependencies [344f453]
 - Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-- Updated dependencies [f53a6ac]
-- Updated dependencies [5eb5a99]
-- Updated dependencies [7e632c5]
-- Updated dependencies [1e9fbfa]
-- Updated dependencies [eabdcd9]
-- Updated dependencies [90be034]
-- Updated dependencies [99f050a]
-- Updated dependencies [d0ee3c6]
-- Updated dependencies [b2ae5aa]
-- Updated dependencies [23f258c]
-
-... 1112 more lines hidden. See full changelog in package directory.
+
+... 1123 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md

@@ -1,5 +1,16 @@
 # @mastra/voice-gladia
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.4-alpha.0
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md

@@ -1,5 +1,16 @@
 # @mastra/voice-google
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.9-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [c5bf1ce]
 - Updated dependencies [add596e]
 - Updated dependencies [8dc94d8]
-- Updated dependencies [ecebbeb]
-- Updated dependencies [79d5145]
-- Updated dependencies [12b7002]
-- Updated dependencies [2901125]
-  - @mastra/core@0.10.2
-
-## 0.10.1-alpha.0
-
-### Patch Changes
-
-- f0d559f: Fix peerdeps for alpha channel
 
-... 1138 more lines hidden. See full changelog in package directory.
+... 1149 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md

@@ -1,5 +1,16 @@
 # @mastra/voice-murf
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.10-alpha.0
 
 ### Patch Changes
@@ -288,15 +299,4 @@
 
 ## 0.10.0
 
-### Minor Changes
-
-- 83da932: Move @mastra/core to peerdeps
-
-### Patch Changes
-
-- Updated dependencies [b3a3d63]
-- Updated dependencies [344f453]
-- Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-
-... 1130 more lines hidden. See full changelog in package directory.
+... 1141 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md

@@ -1,5 +1,16 @@
 # @mastra/voice-openai-realtime
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.9-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [ab5adbe]
 - Updated dependencies [1e8bb40]
 - Updated dependencies [1b5fc55]
-- Updated dependencies [195c428]
-- Updated dependencies [f73e11b]
-- Updated dependencies [37643b8]
-- Updated dependencies [99fd6cf]
-- Updated dependencies [c5bf1ce]
-- Updated dependencies [add596e]
-- Updated dependencies [8dc94d8]
-- Updated dependencies [ecebbeb]
-- Updated dependencies [79d5145]
-- Updated dependencies [12b7002]
-- Updated dependencies [2901125]
-
-... 840 more lines hidden. See full changelog in package directory.
+
+... 851 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md

@@ -1,5 +1,16 @@
 # @mastra/voice-openai
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.10-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [d1ed912]
 - Updated dependencies [f1f1f1b]
 - Updated dependencies [f9816ae]
-- Updated dependencies [82090c1]
-- Updated dependencies [1b443fd]
-- Updated dependencies [ce97900]
-- Updated dependencies [14a2566]
-  - @mastra/core@0.10.4-alpha.0
-
-## 0.10.1
-
-### Patch Changes
-
-- f0d559f: Fix peerdeps for alpha channel
 
-... 1160 more lines hidden. See full changelog in package directory.
+... 1171 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md

@@ -1,5 +1,16 @@
 # @mastra/voice-playai
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.9-alpha.0
 
 ### Patch Changes
@@ -288,15 +299,4 @@
 
 ## 0.2.0-alpha.1
 
-### Minor Changes
-
-- 83da932: Move @mastra/core to peerdeps
-
-### Patch Changes
-
-- Updated dependencies [b3a3d63]
-- Updated dependencies [344f453]
-- Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-
-... 1100 more lines hidden. See full changelog in package directory.
+... 1111 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md

@@ -1,5 +1,16 @@
 # @mastra/voice-sarvam
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.9-alpha.0
 
 ### Patch Changes
@@ -288,15 +299,4 @@
 
 ## 0.2.0-alpha.1
 
-### Minor Changes
-
-- 83da932: Move @mastra/core to peerdeps
-
-### Patch Changes
-
-- Updated dependencies [b3a3d63]
-- Updated dependencies [344f453]
-- Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-
-... 750 more lines hidden. See full changelog in package directory.
+... 761 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md

@@ -1,5 +1,16 @@
 # @mastra/voice-speechify
 
+## 0.11.0-alpha.1
+
+### Minor Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump core peerdependency
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.9-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [b3a3d63]
 - Updated dependencies [344f453]
 - Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-- Updated dependencies [f53a6ac]
-- Updated dependencies [5eb5a99]
-- Updated dependencies [7e632c5]
-- Updated dependencies [1e9fbfa]
-- Updated dependencies [eabdcd9]
-- Updated dependencies [90be034]
-- Updated dependencies [99f050a]
-- Updated dependencies [d0ee3c6]
-- Updated dependencies [b2ae5aa]
-- Updated dependencies [23f258c]
-
-... 1104 more lines hidden. See full changelog in package directory.
+
+... 1115 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,7 @@
 # create-mastra
 
+## 0.10.24-alpha.2
+
 ## 0.10.24-alpha.1
 
 ## 0.10.24-alpha.0
@@ -296,7 +298,5 @@
 - 976a62b: remove persistence capabilities in model settings components
 - 4e809ad: Visualizations for .sleep()/.sleepUntil()/.waitForEvent()
 - f78f399: Make AgentModelSettings shareable between cloud and playground
-- 57929df: agent network display
-
 
-... 1242 more lines hidden. See full changelog in package directory.
+... 1244 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,14 @@
 # mastra
 
+## 0.10.24-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec)]:
+  - @mastra/deployer@0.15.0-alpha.3
+  - @mastra/mcp@0.11.0-alpha.2
+  - @mastra/core@0.15.0-alpha.3
+
 ## 0.10.24-alpha.1
 
 ### Patch Changes
@@ -290,13 +299,4 @@
 
 ### Patch Changes
 
-- ea0c5f2: Update to support new scorer api
-- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
-- 35c5798: Add support for transpilePackages option
-- Updated dependencies [cb36de0]
-- Updated dependencies [d0496e6]
-- Updated dependencies [7b8172f]
-- Updated dependencies [cb36de0]
-- Updated dependencies [d0496e6]
-
-... 5075 more lines hidden. See full changelog in package directory.
+... 5084 more lines hidden. See full changelog in package directory.

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

@@ -0,0 +1,276 @@
+### package.json
+```json
+{
+  "name": "example-headsup",
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "dependencies": {
+    "@ai-sdk/openai": "^1.3.23",
+    "@mastra/core": "^0.14.1",
+    "@mastra/libsql": "^0.13.4",
+    "@mastra/loggers": "^0.10.7",
+    "@mastra/memory": "^0.13.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "mastra": "^0.10.23",
+    "typescript": "^5.9.2"
+  }
+}
+```
+
+### mastra/agents/example-famous-person-agent.ts
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { Agent } from '@mastra/core/agent';
+import { Memory } from '@mastra/memory';
+import { LibSQLVector } from '@mastra/libsql';
+
+export const famousPersonAgent = new Agent({
+  name: 'Famous Person Generator',
+  instructions: `You are a famous person generator for a "Heads Up" guessing game.
+
+Generate the name of a well-known famous person who:
+- Is recognizable to most people
+- Has distinctive characteristics that can be described with yes/no questions
+- Is appropriate for all audiences
+- Has a clear, unambiguous name
+
+IMPORTANT: Use your memory to check what famous people you've already suggested and NEVER repeat a person you've already suggested.
+
+Examples: Albert Einstein, Beyoncé, Leonardo da Vinci, Oprah Winfrey, Michael Jordan
+
+Return only the person's name, nothing else.`,
+  model: openai('gpt-4o'),
+  memory: new Memory({
+    vector: new LibSQLVector({
+      connectionUrl: 'file:../mastra.db',
+    }),
+    embedder: openai.embedding('text-embedding-3-small'),
+    options: {
+      lastMessages: 5,
+      semanticRecall: {
+        topK: 10,
+        messageRange: 1,
+      },
+    },
+  }),
+});
+
+```
+
+### mastra/agents/example-game-agent.ts
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { Agent } from '@mastra/core/agent';
+
+export const gameAgent = new Agent({
+  name: 'Game Agent',
+  instructions: `You are a helpful game assistant for a "Heads Up" guessing game.
+
+CRITICAL: You know the famous person's name but you must NEVER reveal it in any response.
+
+When a user asks a question about the famous person:
+- Answer truthfully based on the famous person provided
+- Keep responses concise and friendly
+- NEVER mention the person's name, even if it seems natural
+- NEVER reveal gender, nationality, or other characteristics unless specifically asked about them
+- Answer yes/no questions with clear "Yes" or "No" responses
+- Be consistent - same question asked differently should get the same answer
+- Ask for clarification if a question is unclear
+- If multiple questions are asked at once, ask them to ask one at a time
+
+When they make a guess:
+- If correct: Congratulate them warmly
+- If incorrect: Politely correct them and encourage them to try again
+
+Encourage players to make a guess when they seem to have enough information.
+
+You must return a JSON object with:
+- response: Your response to the user
+- gameWon: true if they guessed correctly, false otherwise`,
+  model: openai('gpt-4o'),
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core/mastra';
+import { PinoLogger } from '@mastra/loggers';
+import { LibSQLStore } from '@mastra/libsql';
+import { headsUpWorkflow } from './workflows/example-heads-up-workflow';
+
+import { famousPersonAgent } from './agents/example-famous-person-agent';
+import { gameAgent } from './agents/example-game-agent';
+import { guessVerifierAgent } from './agents/example-guess-verifier-agent';
+
+export const mastra = new Mastra({
+  workflows: { headsUpWorkflow },
+  agents: { famousPersonAgent, gameAgent, guessVerifierAgent },
+  storage: new LibSQLStore({
+    // stores telemetry, evals, ... into file storage for persistence across playground refreshes
+    url: 'file:../mastra.db',
+  }),
+  logger: new PinoLogger({
+    name: 'Mastra',
+    level: 'info',
+  }),
+});
+
+```
+
+### mastra/workflows/example-heads-up-workflow.ts
+```typescript
+import { createWorkflow, createStep } from '@mastra/core/workflows';
+import { z } from 'zod';
+import { Pool } from 'pg';
+
+// PostgreSQL client
+const pool = new Pool({
+  connectionString: process.env.DATABASE_URL!,
+});
+
+const startStep = createStep({
+  id: 'start-step',
+  description: "Generate a famous person's name",
+  inputSchema: z.object({
+    start: z.boolean(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    guessCount: z.number(),
+  }),
+  execute: async ({ mastra }) => {
+    const agent = mastra.getAgent('famousPersonAgent');
+    const response = await agent.generate("Generate a famous person's name", {
+      temperature: 1.2,
+      topP: 0.9,
+      memory: {
+        resource: 'heads-up-game',
+        thread: 'famous-person-generator',
+      },
+    });
+    const famousPerson = response.text.trim();
+    return { famousPerson, guessCount: 0 };
+  },
+});
+
+const gameStep = createStep({
+  id: 'game-step',
+  description: 'Handles the question-answer-continue loop',
+  inputSchema: z.object({
+    famousPerson: z.string(),
+    guessCount: z.number(),
+  }),
+  resumeSchema: z.object({
+    userMessage: z.string(),
+  }),
+  suspendSchema: z.object({
+    agentResponse: z.string(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    agentResponse: z.string(),
+    guessCount: z.number(),
+  }),
+  execute: async ({ inputData, mastra, resumeData, suspend }) => {
+    let { famousPerson, guessCount } = inputData;
+    const { userMessage } = resumeData ?? {};
+
+    if (!userMessage) {
+      // First time - ask for a question
+      const message = "I'm thinking of a famous person. Ask me yes/no questions to figure out who it is!";
+
+      await suspend({
+        agentResponse: message,
+      });
+
+      return { famousPerson, gameWon: false, agentResponse: message, guessCount };
+    } else {
+      // Check if the user's message is a guess by using the guess verifier agent
+      const guessVerifier = mastra.getAgent('guessVerifierAgent');
+      const verificationResponse = await guessVerifier.generate(
+        [
+          {
+            role: 'user',
+            content: `Actual famous person: ${famousPerson}
+              User's guess: "${userMessage}"
+              Is this correct?`,
+          },
+        ],
+        {
+          output: z.object({
+            isCorrect: z.boolean(),
+          }),
+        },
+      );
+
+      const gameWon = verificationResponse.object.isCorrect;
+
+      // Let the agent handle the user's message (question or guess)
+      const agent = mastra.getAgent('gameAgent');
+      const response = await agent.generate(`
+      The famous person is: ${famousPerson}
+      The user asked: "${userMessage}"
+      Is this a correct guess: ${gameWon}
+      Please respond appropriately.
+    `);
+
+      const agentResponse = response.text;
+
+      // Increment the guess count
+      guessCount++;
+
+      return { famousPerson, gameWon, agentResponse, guessCount };
+    }
+  },
+});
+
+const winStep = createStep({
+  id: 'win-step',
+  description: 'Handle game win logic',
+  inputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    agentResponse: z.string(),
+    guessCount: z.number(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    guessCount: z.number(),
+  }),
+  execute: async ({ inputData }) => {
+    const { famousPerson, gameWon, guessCount } = inputData;
+
+    await pool.query('INSERT INTO heads_up_games (famous_person, game_won, guess_count) VALUES ($1, $2, $3)', [
+      famousPerson,
+      gameWon,
+      guessCount,
+    ]);
+
+    return { famousPerson, gameWon, guessCount };
+  },
+});
+
+export const headsUpWorkflow = createWorkflow({
+  id: 'heads-up-workflow',
+  inputSchema: z.object({
+    start: z.boolean(),
+  }),
+  outputSchema: z.object({
+    famousPerson: z.string(),
+    gameWon: z.boolean(),
+    guessCount: z.number(),
+  }),
+})
+  .then(startStep)
+  .dountil(gameStep, async ({ inputData: { gameWon } }) => gameWon)
+  .then(winStep)
+  .commit();
+
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.14-alpha.1",
+  "version": "0.13.14-alpha.3",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,8 +32,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.14.2-alpha.1",
-    "@mastra/mcp": "^0.10.13-alpha.1"
+    "@mastra/core": "0.15.0-alpha.3",
+    "@mastra/mcp": "^0.11.0-alpha.2"
   },
   "devDependencies": {
     "@hono/node-server": "^1.17.1",
@@ -48,8 +48,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@mastra/core": "0.14.2-alpha.1",
-    "@internal/lint": "0.0.31"
+    "@internal/lint": "0.0.31",
+    "@mastra/core": "0.15.0-alpha.3"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",