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

package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md

@@ -1,5 +1,14 @@
 # @mastra/clickhouse
 
+## 0.13.3-alpha.0
+
+### Patch Changes
+
+- [#7020](https://github.com/mastra-ai/mastra/pull/7020) [`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6) Thanks [@YujohnNattrass](https://github.com/YujohnNattrass)! - Add column to ai spans table to tell if it's an event
+
+- Updated dependencies [[`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/core@0.14.2-alpha.2
+
 ## 0.13.2
 
 ### Patch Changes
@@ -290,13 +299,4 @@
 
 - 8a3bfd2: Update peerdeps to latest core
 
-### Patch Changes
-
-- Updated dependencies [792c4c0]
-- Updated dependencies [502fe05]
-- Updated dependencies [4efcfa0]
-  - @mastra/core@0.10.7-alpha.3
-
-## 0.11.1-alpha.2
-
-... 834 more lines hidden. See full changelog in package directory.
+... 843 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.11.0-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/core@0.14.2-alpha.2
+
 ## 0.11.0-alpha.1
 
 ### Minor Changes
@@ -291,12 +298,5 @@
 
 ## 0.10.18
 
-### Patch Changes
-
-- 6690a16: dependencies updates:
-  - Updated dependency [`@ag-ui/client@^0.0.35` ↗︎](https://www.npmjs.com/package/@ag-ui/client/v/0.0.35) (from `^0.0.27`, in `dependencies`)
-- Updated dependencies [33dcb07]
-- Updated dependencies [d0d9500]
-- Updated dependencies [d30b1a0]
 
-... 2141 more lines hidden. See full changelog in package directory.
+... 2148 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,11 @@
 # @mastra/core
 
+## 0.14.2-alpha.2
+
+### Patch Changes
+
+- [#7020](https://github.com/mastra-ai/mastra/pull/7020) [`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6) Thanks [@YujohnNattrass](https://github.com/YujohnNattrass)! - Add column to ai spans table to tell if it's an event
+
 ## 0.14.2-alpha.1
 
 ### Patch Changes
@@ -292,11 +298,5 @@
 
 ### Minor Changes
 
-- ea0c5f2: Update scorer api
-
-### Patch Changes
-
-- b0e43c1: Fixed an issue where branching workflow steps maintained "suspended" status even after they've been successfully resumed and executed.
-- 1fb812e: Fixed a bug in parallel workflow execution where resuming only one of multiple suspended parallel steps incorrectly completed the entire parallel block. The fix ensures proper execution and state management when resuming from suspension in parallel workflows.
 
-... 2728 more lines hidden. See full changelog in package directory.
+... 2734 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md

@@ -0,0 +1,11 @@
+# @mastra/deployer-cloud
+
+## 0.14.2-alpha.2
+
+### Patch Changes
+
+- [#6866](https://github.com/mastra-ai/mastra/pull/6866) [`3562fd1`](https://github.com/mastra-ai/mastra/commit/3562fd14b782dc7ed00f4f03df8fbb5fe6e5ff4b) Thanks [@rphansen91](https://github.com/rphansen91)! - @mastra/deployer-cloud
+
+- Updated dependencies [[`2a96802`](https://github.com/mastra-ai/mastra/commit/2a96802f76790ebb86a1bcb254398dccf27e5479), [`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/deployer@0.14.2-alpha.2
+  - @mastra/core@0.14.2-alpha.2

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md

@@ -1,5 +1,15 @@
 # @mastra/deployer-cloudflare
 
+## 0.12.3-alpha.2
+
+### Patch Changes
+
+- [#7017](https://github.com/mastra-ai/mastra/pull/7017) [`2a96802`](https://github.com/mastra-ai/mastra/commit/2a96802f76790ebb86a1bcb254398dccf27e5479) Thanks [@TheIsrael1](https://github.com/TheIsrael1)! - Fix cloudflare deployer - disable esmShim for cloudflare
+
+- Updated dependencies [[`2a96802`](https://github.com/mastra-ai/mastra/commit/2a96802f76790ebb86a1bcb254398dccf27e5479), [`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/deployer@0.14.2-alpha.2
+  - @mastra/core@0.14.2-alpha.2
+
 ## 0.12.3-alpha.1
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 - Updated dependencies [510e2c8]
 - Updated dependencies [2f72fb2]
 - Updated dependencies [27cc97a]
-- Updated dependencies [832691b]
-- Updated dependencies [557bb9d]
-- Updated dependencies [27cc97a]
-- Updated dependencies [3f89307]
-- Updated dependencies [9eda7d4]
-- Updated dependencies [9d49408]
-- Updated dependencies [bc6b44a]
-- Updated dependencies [41daa63]
-- Updated dependencies [ad0a58b]
-- Updated dependencies [254a36b]
-
-... 3288 more lines hidden. See full changelog in package directory.
+
+... 3298 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,15 @@
 # @mastra/deployer
 
+## 0.14.2-alpha.2
+
+### Patch Changes
+
+- [#7017](https://github.com/mastra-ai/mastra/pull/7017) [`2a96802`](https://github.com/mastra-ai/mastra/commit/2a96802f76790ebb86a1bcb254398dccf27e5479) Thanks [@TheIsrael1](https://github.com/TheIsrael1)! - Fix cloudflare deployer - disable esmShim for cloudflare
+
+- Updated dependencies [[`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/core@0.14.2-alpha.2
+  - @mastra/server@0.14.2-alpha.2
+
 ## 0.14.2-alpha.1
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 
 ## 0.13.1
 
-### Patch Changes
-
-- Updated dependencies [cd0042e]
-  - @mastra/core@0.13.1
-  - @mastra/server@0.13.1
-
-## 0.13.1-alpha.0
-
-### Patch Changes
-
 
-... 3582 more lines hidden. See full changelog in package directory.
+... 3592 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.14-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/core@0.14.2-alpha.2
+
 ## 0.13.14-alpha.1
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - Updated dependencies [d30b1a0]
 - Updated dependencies [bff87f7]
 - Updated dependencies [b4a8df0]
-  - @mastra/core@0.12.1
-  - @mastra/mcp@0.10.9
-
-## 0.13.8-alpha.1
-
-### Patch Changes
-
 
-... 1408 more lines hidden. See full changelog in package directory.
+... 1415 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,12 @@
 # @mastra/server
 
+## 0.14.2-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`2e58325`](https://github.com/mastra-ai/mastra/commit/2e58325beb170f5b92f856e27d915cd26917e5e6)]:
+  - @mastra/core@0.14.2-alpha.2
+
 ## 0.14.2-alpha.1
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ### Patch Changes
 
-- e202b82: Add getThreadsByResourceIdPaginated to the Memory Class
-- Updated dependencies [94f4812]
-- Updated dependencies [e202b82]
-- Updated dependencies [e00f6a0]
-  - @mastra/core@0.12.2-alpha.0
-
-
-... 2946 more lines hidden. See full changelog in package directory.
+... 2953 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.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,7 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.14.2-alpha.1",
+    "@mastra/core": "0.14.2-alpha.2",
     "@mastra/mcp": "^0.10.13-alpha.1"
   },
   "devDependencies": {
@@ -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.14.2-alpha.2"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",