@mastra/mcp-docs-server 0.13.8-alpha.0 → 0.13.8

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

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.10.18-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [d0d9500]
+  - @mastra/core@0.12.1-alpha.1
+
 ## 0.10.18-alpha.0
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ### Patch Changes
 
-- 9468be4: Fix error on agent generate while using antropic
-- 44731a4: Client SDK - Expose processTextStream util for agent textstream with structured output
-- Updated dependencies [b4a9811]
-- Updated dependencies [4d5583d]
-  - @mastra/core@0.10.12
-
-
-... 1832 more lines hidden. See full changelog in package directory.
+... 1839 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,11 @@
 # @mastra/core
 
+## 0.12.1-alpha.1
+
+### Patch Changes
+
+- d0d9500: Fixed an issue where AWS Bedrock is expecting a user message at the beginning of the message list
+
 ## 0.12.1-alpha.0
 
 ### Patch Changes
@@ -292,11 +298,5 @@
 
 ## 0.10.11
 
-### Patch Changes
-
-- 2873c7f: dependencies updates:
-  - Updated dependency [`dotenv@^16.6.1` ↗︎](https://www.npmjs.com/package/dotenv/v/16.6.1) (from `^16.5.0`, in `dependencies`)
-- 1c1c6a1: dependencies updates:
-  - Updated dependency [`hono@^4.8.4` ↗︎](https://www.npmjs.com/package/hono/v/4.8.4) (from `^4.8.3`, in `dependencies`)
 
-... 2397 more lines hidden. See full changelog in package directory.
+... 2403 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,13 @@
 # @mastra/deployer
 
+## 0.12.1-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [d0d9500]
+  - @mastra/core@0.12.1-alpha.1
+  - @mastra/server@0.12.1-alpha.1
+
 ## 0.12.1-alpha.0
 
 ### Patch Changes
@@ -291,12 +299,4 @@
 
 ## 0.11.0-alpha.0
 
-### Minor Changes
-
-- 0938991: Refactored the hono server structure by extracting route logic into route groups based on namespace.
-
-### Patch Changes
-
-- 6f50efd: Only enforce authorization on protected routes
-
-... 3178 more lines hidden. See full changelog in package directory.
+... 3186 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.8-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [d0d9500]
+  - @mastra/core@0.12.1-alpha.1
+
 ## 0.13.8-alpha.0
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - Updated dependencies [4fb0cc2]
 - Updated dependencies [d2a7a31]
 - Updated dependencies [0e17048]
-  - @mastra/core@0.10.7-alpha.1
-  - @mastra/mcp@0.10.5-alpha.0
-
-## 0.13.1
-
-### Patch Changes
-
 
-... 1107 more lines hidden. See full changelog in package directory.
+... 1114 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,12 @@
 # @mastra/deployer
 
+## 0.12.1-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [d0d9500]
+  - @mastra/core@0.12.1-alpha.1
+
 ## 0.12.1-alpha.0
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ### Patch Changes
 
-- @mastra/core@0.10.14
-
-## 0.10.12
-
-### Patch Changes
-
-
-... 2630 more lines hidden. See full changelog in package directory.
+... 2637 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,14 @@
 # mastra
 
+## 0.10.17-alpha.1
+
+### Patch Changes
+
+- 9862477: Install specific ai v4 deps when scaffolding a project
+- Updated dependencies [d0d9500]
+  - @mastra/core@0.12.1-alpha.1
+  - @mastra/deployer@0.12.1-alpha.1
+
 ## 0.10.17-alpha.0
 
 ### Patch Changes
@@ -289,14 +298,5 @@
   - Updated dependency [`swr@^2.3.4` ↗︎](https://www.npmjs.com/package/swr/v/2.3.4) (from `^2.3.3`, in `dependencies`)
 - 984887a: dependencies updates:
   - Updated dependency [`prettier@^3.6.2` ↗︎](https://www.npmjs.com/package/prettier/v/3.6.2) (from `^3.5.3`, in `dependencies`)
-- aa9528a: Display reasoning in playground
-- 45174f3: share network list between core and cloud
-- 48f5532: export workflow list for usage in cloud
-- 3e484be: Added CLI template option
-- 626b0f4: [Cloud-126] Working Memory Playground - Added working memory to playground to allow users to view/edit working memory
-- e1d0080: abstract Link component between cloud and core
-- f9b1508: add the same agent table as in cloud and export it from the playground
-- dfbeec6: Fix navigation to vnext AgentNetwork agents
-- Updated dependencies [7776324]
-
-... 4674 more lines hidden. See full changelog in package directory.
+
+... 4683 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/overview.mdx

@@ -15,21 +15,21 @@ Additionally, agents support dynamic configuration, allowing you to change their
 
 To create an agent in Mastra, you use the `Agent` class and define its properties:
 
-```ts showLineNumbers filename="src/mastra/agents/index.ts" copy
-import { Agent } from "@mastra/core/agent";
+```typescript filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { openai } from "@ai-sdk/openai";
+import { Agent } from "@mastra/core/agent";
 
-export const myAgent = new Agent({
-  name: "My Agent",
+const testAgent = new Agent({
+  name: "test-agent",
   instructions: "You are a helpful assistant.",
-  model: openai("gpt-4o-mini"),
+  model: openai("gpt-4o")
 });
 ```
 
 **Note:** Ensure that you have set the necessary environment variables, such as your OpenAI API key, in your `.env` file:
 
-```.env filename=".env" copy
-OPENAI_API_KEY=your_openai_api_key
+```bash filename=".env" copy
+OPENAI_API_KEY=<your-api-key>
 ```
 
 Also, make sure you have the `@mastra/core` package installed:
@@ -44,12 +44,13 @@ All agent properties (instructions, model, tools, memory) can be configured dyna
 
 Register your agent with Mastra to enable logging and access to configured tools and integrations:
 
-```ts showLineNumbers filename="src/mastra/index.ts" copy
+```typescript showLineNumbers filename="src/mastra/index.ts" copy
 import { Mastra } from "@mastra/core";
-import { myAgent } from "./agents";
+import { testAgent } from './agents/test-agent';
 
 export const mastra = new Mastra({
-  agents: { myAgent },
+  // ...
+  agents: { testAgent },
 });
 ```
 
@@ -59,8 +60,8 @@ export const mastra = new Mastra({
 
 Use the `.generate()` method to have your agent produce text responses:
 
-```ts showLineNumbers filename="src/mastra/index.ts" copy
-const response = await myAgent.generate([
+```typescript showLineNumbers copy
+const response = await testAgent.generate([
   { role: "user", content: "Hello, how can you assist me today?" },
 ]);
 
@@ -73,8 +74,8 @@ For more details about the generate method and its options, see the [generate re
 
 For more real-time responses, you can stream the agent's response:
 
-```ts showLineNumbers filename="src/mastra/index.ts" copy
-const stream = await myAgent.stream([
+```typescript showLineNumbers copy
+const stream = await testAgent.stream([
   { role: "user", content: "Tell me a story." },
 ]);
 
@@ -87,13 +88,35 @@ for await (const chunk of stream.textStream) {
 
 For more details about streaming responses, see the [stream reference documentation](/reference/agents/stream).
 
-## 3. Structured Output
+## 3. Describing images
+
+Agents can analyze and describe images by processing both the visual content and any text within them. To enable image analysis, pass an object with `type: 'image'` and the image URL in the content array. You can combine image content with text prompts to guide the agent's analysis.
+
+```typescript showLineNumbers copy
+await testAgent.generate([
+  {
+    role: 'user',
+    content: [
+      {
+        type: 'image',
+        image: "https://example.com/images/test-image.jpg",
+      },
+      {
+        type: 'text',
+        text: 'Describe the image in detail, and extract all the text in the image.',
+      },
+    ],
+  },
+]);
+```
+
+## 4. Structured Output
 
 Agents can return structured data by providing a JSON Schema or using a Zod schema.
 
 ### Using JSON Schema
 
-```typescript
+```typescript showLineNumbers copy
 const schema = {
   type: "object",
   properties: {
@@ -104,7 +127,7 @@ const schema = {
   required: ["summary", "keywords"],
 };
 
-const response = await myAgent.generate(
+const response = await testAgent.generate(
   [
     {
       role: "user",
@@ -132,7 +155,7 @@ npm install zod
 
 Then, define a Zod schema and use it with the agent:
 
-```ts showLineNumbers filename="src/mastra/index.ts" copy
+```typescript showLineNumbers copy
 import { z } from "zod";
 
 // Define the Zod schema
@@ -142,7 +165,7 @@ const schema = z.object({
 });
 
 // Use the schema with the agent
-const response = await myAgent.generate(
+const response = await testAgent.generate(
   [
     {
       role: "user",
@@ -162,13 +185,13 @@ console.log("Structured Output:", response.object);
 
 If you need to generate structured output alongside tool calls, you'll need to use the `experimental_output` property instead of `output`. Here's how:
 
-```typescript
+```typescript showLineNumbers copy
 const schema = z.object({
   summary: z.string(),
   keywords: z.array(z.string()),
 });
 
-const response = await myAgent.generate(
+const response = await testAgent.generate(
   [
     {
       role: "user",
@@ -189,7 +212,7 @@ console.log("Structured Output:", response.object);
 
 This allows you to have strong typing and validation for the structured data returned by the agent.
 
-## 4. Multi-step tool use
+## 5. Multi-step tool use
 
 Agents can be enhanced with tools - functions that extend their capabilities beyond text generation. Tools allow agents to perform calculations, access external systems, and process data. Agents not only decide whether to call tools they're given, they determine the parameters that should be given to that tool.
 
@@ -199,26 +222,8 @@ For a detailed guide to creating and configuring tools, see the [Adding Tools do
 
 The `maxSteps` parameter controls the maximum number of sequential LLM calls an agent can make, particularly important when using tool calls. By default, it is set to 1 to prevent infinite loops in case of misconfigured tools. You can increase this limit based on your use case:
 
-```ts showLineNumbers filename="src/mastra/agents/index.ts" copy
-import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
-import * as mathjs from "mathjs";
-import { z } from "zod";
-
-export const myAgent = new Agent({
-  name: "My Agent",
-  instructions: "You are a helpful assistant that can solve math problems.",
-  model: openai("gpt-4o-mini"),
-  tools: {
-    calculate: {
-      description: "Calculator for mathematical expressions",
-      schema: z.object({ expression: z.string() }),
-      execute: async ({ expression }) => mathjs.evaluate(expression),
-    },
-  },
-});
-
-const response = await myAgent.generate(
+```typescript showLineNumbers copy
+const response = await testAgent.generate(
   [
     {
       role: "user",
@@ -238,8 +243,8 @@ You can monitor the progress of multi-step operations using the `onStepFinish` c
 
 `onStepFinish` is only available when streaming or generating text without structured output.
 
-```ts showLineNumbers filename="src/mastra/agents/index.ts" copy
-const response = await myAgent.generate(
+```typescript showLineNumbers copy
+const response = await testAgent.generate(
   [{ role: "user", content: "Calculate the taxi driver's daily earnings." }],
   {
     maxSteps: 5,
@@ -255,8 +260,8 @@ const response = await myAgent.generate(
 The `onFinish` callback is available when streaming responses and provides detailed information about the completed interaction. It is called after the LLM has finished generating its response and all tool executions have completed.
 This callback receives the final response text, execution steps, token usage statistics, and other metadata that can be useful for monitoring and logging:
 
-```ts showLineNumbers filename="src/mastra/agents/index.ts" copy
-const stream = await myAgent.stream(
+```typescript showLineNumbers copy
+const stream = await testAgent.stream(
   [{ role: "user", content: "Calculate the taxi driver's daily earnings." }],
   {
     maxSteps: 5,
@@ -277,7 +282,7 @@ const stream = await myAgent.stream(
 );
 ```
 
-## 5. Testing agents locally
+## 6. Testing agents locally
 
 Mastra provides a CLI command `mastra dev` to run your agents behind an API. By default, this looks for exported agents in files in the `src/mastra/agents` directory. It generates endpoints for testing your agent (eg `http://localhost:4111/api/agents/myAgent/generate`) and provides a visual playground where you can chat with an agent and view traces.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.8-alpha.0",
+  "version": "0.13.8",
   "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/mcp": "^0.10.9-alpha.0",
-    "@mastra/core": "0.12.1-alpha.0"
+    "@mastra/core": "0.12.1",
+    "@mastra/mcp": "^0.10.9"
   },
   "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.12.1-alpha.0",
-    "@internal/lint": "0.0.24"
+    "@mastra/core": "0.12.1",
+    "@internal/lint": "0.0.25"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",