@mastra/mcp-docs-server 0.0.13 → 0.0.14-alpha.1

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

@@ -1,5 +1,38 @@
 # @mastra/voice-playai
 
+## 0.1.18-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [ab80e7e]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4-alpha.1
+
+## 0.1.18-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+  - @mastra/core@0.9.4-alpha.0
+
+## 0.1.17
+
+### Patch Changes
+
+- Updated dependencies [e450778]
+- Updated dependencies [8902157]
+- Updated dependencies [ca0dc88]
+- Updated dependencies [526c570]
+- Updated dependencies [d7a6a33]
+- Updated dependencies [9cd1a46]
+- Updated dependencies [b5d2de0]
+- Updated dependencies [644f8ad]
+- Updated dependencies [70dbf51]
+  - @mastra/core@0.9.3
+
 ## 0.1.17-alpha.1
 
 ### Patch Changes
@@ -265,38 +298,5 @@
 
 ## 0.1.14-alpha.3
 
-### Patch Changes
-
-- Updated dependencies [fe3ae4d]
-  - @mastra/core@0.9.0-alpha.3
-
-## 0.1.14-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [9ee4293]
-  - @mastra/core@0.8.4-alpha.2
-
-## 0.1.14-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [8a8a73b]
-- Updated dependencies [6f92295]
-  - @mastra/core@0.8.4-alpha.1
-
-## 0.1.14-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [03f3cd0]
-  - @mastra/core@0.8.4-alpha.0
-
-## 0.1.13
-
-### Patch Changes
-
-- 37bb612: Add Elastic-2.0 licensing for packages
-- Updated dependencies [d72318f]
 
-... 702 more lines hidden. See full changelog in package directory.
+... 735 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,38 @@
 # @mastra/voice-sarvam
 
+## 0.1.13-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [ab80e7e]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4-alpha.1
+
+## 0.1.13-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+  - @mastra/core@0.9.4-alpha.0
+
+## 0.1.12
+
+### Patch Changes
+
+- Updated dependencies [e450778]
+- Updated dependencies [8902157]
+- Updated dependencies [ca0dc88]
+- Updated dependencies [526c570]
+- Updated dependencies [d7a6a33]
+- Updated dependencies [9cd1a46]
+- Updated dependencies [b5d2de0]
+- Updated dependencies [644f8ad]
+- Updated dependencies [70dbf51]
+  - @mastra/core@0.9.3
+
 ## 0.1.12-alpha.1
 
 ### Patch Changes
@@ -265,38 +298,5 @@
 - Updated dependencies [7e92011]
   - @mastra/core@0.9.0-alpha.4
 
-## 0.1.9-alpha.3
-
-### Patch Changes
-
-- Updated dependencies [fe3ae4d]
-  - @mastra/core@0.9.0-alpha.3
-
-## 0.1.9-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [9ee4293]
-  - @mastra/core@0.8.4-alpha.2
-
-## 0.1.9-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [8a8a73b]
-- Updated dependencies [6f92295]
-  - @mastra/core@0.8.4-alpha.1
-
-## 0.1.9-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [03f3cd0]
-  - @mastra/core@0.8.4-alpha.0
-
-## 0.1.8
-
-### Patch Changes
-
 
-... 352 more lines hidden. See full changelog in package directory.
+... 385 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,38 @@
 # @mastra/voice-speechify
 
+## 0.1.18-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [ab80e7e]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4-alpha.1
+
+## 0.1.18-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+  - @mastra/core@0.9.4-alpha.0
+
+## 0.1.17
+
+### Patch Changes
+
+- Updated dependencies [e450778]
+- Updated dependencies [8902157]
+- Updated dependencies [ca0dc88]
+- Updated dependencies [526c570]
+- Updated dependencies [d7a6a33]
+- Updated dependencies [9cd1a46]
+- Updated dependencies [b5d2de0]
+- Updated dependencies [644f8ad]
+- Updated dependencies [70dbf51]
+  - @mastra/core@0.9.3
+
 ## 0.1.17-alpha.1
 
 ### Patch Changes
@@ -265,38 +298,5 @@
 
 ## 0.1.14-alpha.3
 
-### Patch Changes
-
-- Updated dependencies [fe3ae4d]
-  - @mastra/core@0.9.0-alpha.3
-
-## 0.1.14-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [9ee4293]
-  - @mastra/core@0.8.4-alpha.2
-
-## 0.1.14-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [8a8a73b]
-- Updated dependencies [6f92295]
-  - @mastra/core@0.8.4-alpha.1
-
-## 0.1.14-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [03f3cd0]
-  - @mastra/core@0.8.4-alpha.0
-
-## 0.1.13
-
-### Patch Changes
-
-- 37bb612: Add Elastic-2.0 licensing for packages
-- Updated dependencies [d72318f]
 
-... 689 more lines hidden. See full changelog in package directory.
+... 722 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,16 @@
 # create-mastra
 
+## 0.3.2
+
+### Patch Changes
+
+- 0db0992: - add new --mcp option to cli
+  - add support for mcp in vscode
+  - include examples with --default flag
+- b5d2de0: In vNext workflow serializedStepGraph, return only serializedStepFlow for steps created from a workflow
+  allow viewing inner nested workflows in a multi-layered nested vnext workflow on the playground
+- 62c9e7d: Fix disappearing tool calls in streaming
+
 ## 0.3.2-alpha.1
 
 ### Patch Changes
@@ -288,15 +299,4 @@
 
 ## 0.2.4-alpha.1
 
-### Patch Changes
-
-- 789bef3: Make runId optional for workflow startAsync api
-- 8393832: Handle nested workflow view on workflow graph
-
-## 0.2.4-alpha.0
-
-### Patch Changes
-
-- 8076ecf: Unify workflow watch/start response
-
-... 615 more lines hidden. See full changelog in package directory.
+... 626 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,50 @@
 # mastra
 
+## 0.6.3-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [ab80e7e]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4-alpha.1
+  - @mastra/deployer@0.3.4-alpha.1
+
+## 0.6.3-alpha.0
+
+### Patch Changes
+
+- 15dc8e4: Use detected package manager in post-create instructions
+- cb1f698: Set runtimeContext from playground for agents, tools, workflows
+- Updated dependencies [cb1f698]
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+  - @mastra/deployer@0.3.4-alpha.0
+  - @mastra/core@0.9.4-alpha.0
+
+## 0.6.2
+
+### Patch Changes
+
+- 0db0992: - add new --mcp option to cli
+  - add support for mcp in vscode
+  - include examples with --default flag
+- b5d2de0: In vNext workflow serializedStepGraph, return only serializedStepFlow for steps created from a workflow
+  allow viewing inner nested workflows in a multi-layered nested vnext workflow on the playground
+- 62c9e7d: Fix disappearing tool calls in streaming
+- Updated dependencies [e450778]
+- Updated dependencies [8902157]
+- Updated dependencies [ca0dc88]
+- Updated dependencies [526c570]
+- Updated dependencies [d7a6a33]
+- Updated dependencies [9cd1a46]
+- Updated dependencies [b5d2de0]
+- Updated dependencies [644f8ad]
+- Updated dependencies [70dbf51]
+  - @mastra/core@0.9.3
+  - @mastra/deployer@0.3.3
+
 ## 0.6.2-alpha.1
 
 ### Patch Changes
@@ -254,49 +299,4 @@
 
 ### Patch Changes
 
-- 3b74a74: add badge for failure / successful traces
-- 5a66ced: add click on trace row
-- Updated dependencies [e4943b8]
-- Updated dependencies [479f490]
-  - @mastra/core@0.9.1-alpha.4
-  - @mastra/deployer@0.3.1-alpha.4
-
-## 0.6.0-alpha.4
-
-### Patch Changes
-
-- 5ebe2aa: Adds ability to add a global configuration for cursor for the Mastra docs MCP server during creation of a Mastra project. Allowing all cursor projects to have access to the MCP server.
-
-## 0.6.0-alpha.3
-
-### Patch Changes
-
-- 34a76ca: Call workflow cleanup function when closing watch stream controller
-- 0c3c4f4: Playground routing model settings for AgentNetworks
-- 1700eca: fixing overflow on agent traces
-- Updated dependencies [6262bd5]
-  - @mastra/deployer@0.3.1-alpha.3
-  - @mastra/core@0.9.1-alpha.3
-
-## 0.6.0-alpha.2
-
-### Patch Changes
-
-- 70124e1: revamp the ui for traces
-- 926821d: Fix triggerSchema default not showing in workflow ui
-- 57b25ed: Use resumeSchema to show inputs on the playground for suspended workflows
-- f1d4b7a: Add x-mastra-dev-playground header to all playground requests
-- Updated dependencies [405b63d]
-- Updated dependencies [61e92f5]
-- Updated dependencies [c71013a]
-  - @mastra/core@0.9.1-alpha.2
-  - @mastra/deployer@0.3.1-alpha.2
-
-## 0.6.0-alpha.1
-
-### Minor Changes
-
-- e126a44: improve non-interactive mode of the mastra cli and create-mastra by adding --no-example and --dir flags
-
-
-... 3040 more lines hidden. See full changelog in package directory.
+... 3085 more lines hidden. See full changelog in package directory.

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

@@ -0,0 +1,202 @@
+### package.json
+```json
+{
+  "name": "examples-a2a",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "description": "Example of using Mastra's A2A protocol with the client SDK",
+  "main": "dist/index.js",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "mastra:dev": "mastra dev",
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts"
+  },
+  "keywords": [
+    "mastra",
+    "a2a",
+    "agent-to-agent",
+    "example"
+  ],
+  "author": "Mastra Team",
+  "license": "MIT",
+  "dependencies": {
+    "@ai-sdk/openai": "^1.3.22",
+    "@mastra/client-js": "latest",
+    "@mastra/core": "latest",
+    "dotenv": "^16.3.1",
+    "zod": "^3.22.2"
+  },
+  "devDependencies": {
+    "mastra": "latest",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "pnpm": {
+    "overrides": {
+      "@mastra/core": "link:../../packages/core",
+      "mastra": "link:../../packages/cli",
+      "@mastra/client-js": "link:../../client-sdks/client-js"
+    }
+  },
+  "packageManager": "pnpm@10.9.0+sha512.0486e394640d3c1fb3c9d43d49cf92879ff74f8516959c235308f5a8f62e2e19528a65cdc2a3058f587cde71eba3d5b56327c8c33a97e4c4051ca48a10ca2d5f"
+}
+
+```
+
+### index.ts
+```typescript
+import { MastraClient } from '@mastra/client-js';
+
+// Initialize the Mastra client
+const client = new MastraClient({
+  baseUrl: process.env.MASTRA_BASE_URL || 'http://localhost:4111',
+});
+
+/**
+ * Example of using the A2A protocol to interact with agents
+ */
+async function main() {
+  try {
+    // Get the agent ID - this would be the ID of an agent you've created
+    const agentId = 'myAgent';
+
+    console.log(`🤖 Connecting to agent: ${agentId} via A2A protocol\n`);
+
+    // Get the A2A client for the agent
+    const a2aClient = client.getA2A(agentId);
+
+    // Step 1: Get the agent card to see its capabilities
+    console.log('📋 Fetching agent card...');
+    const agentCard = await a2aClient.getCard();
+
+    console.log(`\nAgent Name: ${agentCard.name}`);
+    console.log(`Description: ${agentCard.description}`);
+    console.log(`Capabilities: ${JSON.stringify(agentCard.capabilities)}`);
+    console.log(`API Version: ${agentCard.version}`);
+    console.log('\n-------------------\n');
+
+    // Step 2: Send a message to the agent
+    const taskId = `task-${Date.now()}`;
+    console.log(`📤 Sending message to agent (Task ID: ${taskId})...`);
+
+    const query = 'What are the latest developments in AI agent networks?';
+    console.log(`Query: ${query}`);
+
+    const response = await a2aClient.sendMessage({
+      id: taskId,
+      message: {
+        role: 'user',
+        parts: [{ type: 'text', text: query }],
+      },
+    });
+
+    console.log(response);
+
+    console.log(`\nTask Status: ${response.task.status}`);
+    console.log('\n🤖 Agent Response:');
+    console.log(
+      response.task.status.message?.parts[0]?.type === 'text'
+        ? response.task.status.message.parts[0].text
+        : 'No response content',
+    );
+
+    console.log('\n-------------------\n');
+
+    // Step 3: Get task status
+    console.log(`📥 Checking task status (Task ID: ${taskId})...`);
+
+    const taskStatus = await a2aClient.getTask({
+      id: taskId,
+    });
+
+    console.log(`Task Status: ${taskStatus.status}`);
+    console.log('\n-------------------\n');
+
+    // Step 4: Demonstrate agent-to-agent communication
+    console.log('🔄 Demonstrating agent-to-agent communication...');
+
+    // Get another agent for A2A communication
+    const secondAgentId = process.env.SECOND_AGENT_ID || 'contentCreatorAgent';
+    console.log(`Connecting to second agent: ${secondAgentId}`);
+
+    const secondA2aClient = client.getA2A(secondAgentId);
+
+    // First agent gathers information
+    const researchTaskId = `research-${Date.now()}`;
+    console.log(`\nStep 1: First agent (${agentId}) researches the topic...`);
+
+    const researchQuery = 'Provide a brief summary of agent networks in AI';
+    const researchResponse = await a2aClient.sendMessage({
+      id: researchTaskId,
+      message: {
+        role: 'user',
+        parts: [{ type: 'text', text: researchQuery }],
+      },
+    });
+
+    const researchResult =
+      researchResponse.task.status.message?.parts[0]?.type === 'text'
+        ? researchResponse.task.status.message.parts[0].text
+        : '';
+    console.log('\nResearch Results:');
+    console.log(researchResult.substring(0, 150) + '...');
+
+    // Second agent transforms the research into content
+    const contentTaskId = `content-${Date.now()}`;
+    console.log(`\nStep 2: Second agent (${secondAgentId}) transforms research into content...`);
+
+    const contentPrompt = `Transform this research into an engaging blog post introduction:\n\n${researchResult}`;
+    const contentResponse = await secondA2aClient.sendMessage({
+      id: contentTaskId,
+      message: {
+        role: 'user',
+        parts: [{ type: 'text', text: contentPrompt }],
+      },
+    });
+
+    console.log('\nFinal Content:');
+    console.log(
+      contentResponse.task.status.message?.parts[0]?.type === 'text'
+        ? contentResponse.task.status.message.parts[0].text
+        : 'No content generated',
+    );
+
+    console.log('\n-------------------\n');
+    console.log('✅ A2A example completed successfully!');
+  } catch (error) {
+    console.error('❌ Error in A2A example:', error);
+  }
+}
+
+// Run the example
+main();
+
+```
+
+### mastra/agents/index.ts
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
+
+export const myAgent = new Agent({
+  name: 'myAgent',
+  instructions: 'My Agent Instructions',
+  model: openai('gpt-4o'),
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core/mastra';
+import { myAgent } from './agents';
+
+export const mastra = new Mastra({
+  agents: {
+    myAgent,
+  },
+});
+
+```

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

@@ -14,7 +14,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@ai-sdk/openai": "^1.2.5",
+    "@ai-sdk/openai": "^1.3.22",
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
     "zod": "^3.24.3"