@mastra/mcp-docs-server 1.2.14-alpha.3 → 1.2.14-alpha.4

package/.docs/models/providers/togetherai.md

@@ -11,22 +11,22 @@ TOGETHER_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "togetherai/LiquidAI/LFM2-24B-A2B"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'togetherai/LiquidAI/LFM2-24B-A2B',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -64,31 +64,29 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    id: "togetherai/LiquidAI/LFM2-24B-A2B",
+    id: 'togetherai/LiquidAI/LFM2-24B-A2B',
     apiKey: process.env.TOGETHER_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "togetherai/zai-org/GLM-5.2"
-      : "togetherai/LiquidAI/LFM2-24B-A2B";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'togetherai/zai-org/GLM-5.2' : 'togetherai/LiquidAI/LFM2-24B-A2B'
+  },
+})
 ```
 
 ## Direct provider installation

package/.docs/models/providers/umans-ai-coding-plan.md

@@ -11,22 +11,22 @@ UMANS_AI_CODING_PLAN_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "umans-ai-coding-plan/umans-coder"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'umans-ai-coding-plan/umans-coder',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -51,30 +51,30 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://api.code.umans.ai/v1",
-    id: "umans-ai-coding-plan/umans-coder",
+    url: 'https://api.code.umans.ai/v1',
+    id: 'umans-ai-coding-plan/umans-coder',
     apiKey: process.env.UMANS_AI_CODING_PLAN_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
+    const useAdvanced = requestContext.task === 'complex'
     return useAdvanced
-      ? "umans-ai-coding-plan/umans-qwen3.6-35b-a3b"
-      : "umans-ai-coding-plan/umans-coder";
-  }
-});
+      ? 'umans-ai-coding-plan/umans-qwen3.6-35b-a3b'
+      : 'umans-ai-coding-plan/umans-coder'
+  },
+})
 ```

package/.docs/models/providers/umans-ai.md

@@ -11,22 +11,22 @@ UMANS_AI_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "umans-ai/umans-coder"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'umans-ai/umans-coder',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -50,30 +50,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://api.code.umans.ai/v1",
-    id: "umans-ai/umans-coder",
+    url: 'https://api.code.umans.ai/v1',
+    id: 'umans-ai/umans-coder',
     apiKey: process.env.UMANS_AI_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "umans-ai/umans-kimi-k3"
-      : "umans-ai/umans-coder";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'umans-ai/umans-kimi-k3' : 'umans-ai/umans-coder'
+  },
+})
 ```

package/.docs/models/providers/wandb.md

@@ -11,22 +11,22 @@ WANDB_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'wandb/JetBrains/Mellum2-12B-A2.5B-Instruct',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -70,30 +70,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://api.inference.wandb.ai/v1",
-    id: "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct",
+    url: 'https://api.inference.wandb.ai/v1',
+    id: 'wandb/JetBrains/Mellum2-12B-A2.5B-Instruct',
     apiKey: process.env.WANDB_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "wandb/zai-org/GLM-5.2"
-      : "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'wandb/zai-org/GLM-5.2' : 'wandb/JetBrains/Mellum2-12B-A2.5B-Instruct'
+  },
+})
 ```

package/.docs/models/providers/xai.md

@@ -11,22 +11,22 @@ XAI_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "xai/grok-4.20-0309-non-reasoning"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'xai/grok-4.20-0309-non-reasoning',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -51,31 +51,29 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    id: "xai/grok-4.20-0309-non-reasoning",
+    id: 'xai/grok-4.20-0309-non-reasoning',
     apiKey: process.env.XAI_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "xai/grok-imagine-video-1.5"
-      : "xai/grok-4.20-0309-non-reasoning";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'xai/grok-imagine-video-1.5' : 'xai/grok-4.20-0309-non-reasoning'
+  },
+})
 ```
 
 ## Provider Options
@@ -83,13 +81,13 @@ const agent = new Agent({
 xAI supports the following provider-specific options via the `providerOptions` parameter:
 
 ```typescript
-const response = await agent.generate("Hello!", {
+const response = await agent.generate('Hello!', {
   providerOptions: {
     xai: {
       // See available options in the table below
-    }
-  }
-});
+    },
+  },
+})
 ```
 
 ### Available Options

package/.docs/models/providers/zai-coding-plan.md

@@ -11,22 +11,22 @@ ZHIPU_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "zai-coding-plan/glm-4.7"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'zai-coding-plan/glm-4.7',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -47,30 +47,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://api.z.ai/api/coding/paas/v4",
-    id: "zai-coding-plan/glm-4.7",
+    url: 'https://api.z.ai/api/coding/paas/v4',
+    id: 'zai-coding-plan/glm-4.7',
     apiKey: process.env.ZHIPU_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "zai-coding-plan/glm-5.2-highspeed"
-      : "zai-coding-plan/glm-4.7";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'zai-coding-plan/glm-5.2-highspeed' : 'zai-coding-plan/glm-4.7'
+  },
+})
 ```

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -11,22 +11,22 @@ ZHIPU_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "zhipuai-coding-plan/glm-4.6v"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'zhipuai-coding-plan/glm-4.6v',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -50,30 +50,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://open.bigmodel.cn/api/coding/paas/v4",
-    id: "zhipuai-coding-plan/glm-4.6v",
+    url: 'https://open.bigmodel.cn/api/coding/paas/v4',
+    id: 'zhipuai-coding-plan/glm-4.6v',
     apiKey: process.env.ZHIPU_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "zhipuai-coding-plan/glm-5v-turbo"
-      : "zhipuai-coding-plan/glm-4.6v";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'zhipuai-coding-plan/glm-5v-turbo' : 'zhipuai-coding-plan/glm-4.6v'
+  },
+})
 ```

package/.docs/models/providers.md

@@ -101,7 +101,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [NanoGPT](https://mastra.ai/models/providers/nano-gpt)
 - [NEAR AI Cloud](https://mastra.ai/models/providers/nearai)
 - [Nebius Token Factory](https://mastra.ai/models/providers/nebius)
-- [Neon](https://mastra.ai/models/providers/neon)
 - [Neuralwatt](https://mastra.ai/models/providers/neuralwatt)
 - [Nova](https://mastra.ai/models/providers/nova)
 - [NovitaAI](https://mastra.ai/models/providers/novita-ai)

package/.docs/reference/client-js/workflows.md

@@ -212,6 +212,98 @@ A workflow run result yields the following:
 
 **payload** (`object`): Contains currentStep (id, status, output, payload) and workflowState (status, steps record)
 
+## Stored workflows
+
+> **Beta:** Stored workflows are in beta. Breaking changes may occur without a major version bump until the API is stable.
+
+Stored workflows are workflow definitions expressed as JSON. The server persists each definition and registers it as a runnable workflow. See [Stored workflows](https://mastra.ai/docs/workflows/stored-workflows) for the definition format.
+
+### `listStoredWorkflows()`
+
+List stored workflow definitions, optionally filtered by `status` (`'active' | 'archived'`) and `authorId`:
+
+```typescript
+const { definitions, total } = await mastraClient.listStoredWorkflows({
+  status: 'active',
+})
+```
+
+### `upsertStoredWorkflow()`
+
+Create or replace a stored workflow definition. The server validates the definition, persists it, and live-registers it for execution:
+
+```typescript
+const stored = await mastraClient.upsertStoredWorkflow({
+  id: 'greeting-workflow',
+  description: 'Returns a greeting for the supplied name',
+  inputSchema: {
+    type: 'object',
+    properties: { name: { type: 'string' } },
+    required: ['name'],
+  },
+  outputSchema: {
+    type: 'object',
+    properties: { message: { type: 'string' } },
+    required: ['message'],
+  },
+  graph: [
+    {
+      type: 'mapping',
+      id: 'create-greeting',
+      mapConfig: JSON.stringify({
+        message: { template: 'Hello, ${initData.name}!' },
+      }),
+    },
+  ],
+})
+```
+
+When the root definition nests helper workflows that don't exist yet, pass them in the same request through `dependencies`. The server validates and registers the bundle as a unit and echoes the helper ids back as `dependencyIds`:
+
+```typescript
+const stored = await mastraClient.upsertStoredWorkflow({
+  id: 'root-workflow',
+  // ...schemas and graph referencing 'helper-workflow'...
+  dependencies: [helperDefinition],
+})
+
+console.log(stored.dependencyIds) // ['helper-workflow']
+```
+
+### `getStoredWorkflow()`
+
+Get a stored workflow instance for definition management. To execute a stored workflow, use `getWorkflow(id).createRun()` like any other workflow:
+
+```typescript
+const storedWorkflow = mastraClient.getStoredWorkflow('greeting-workflow')
+```
+
+### `storedWorkflow.details()`
+
+Retrieve the persisted definition, including schemas, graph, status, and timestamps:
+
+```typescript
+const definition = await storedWorkflow.details()
+```
+
+### `storedWorkflow.delete()`
+
+Delete the stored definition and unregister the live workflow:
+
+```typescript
+await storedWorkflow.delete()
+```
+
+### Executing a stored workflow
+
+Once registered, a stored workflow runs through the ordinary workflow API:
+
+```typescript
+const workflow = mastraClient.getWorkflow('greeting-workflow')
+const run = await workflow.createRun()
+const result = await run.startAsync({ inputData: { name: 'Ada' } })
+```
+
 ## Schedules
 
 Schedules are declared in code via the `schedule` field on `createWorkflow`. The client SDK exposes read and operational methods for managing workflow schedules at runtime. See [Scheduled workflows](https://mastra.ai/docs/workflows/scheduled-workflows).