@mastra/mcp-docs-server 1.2.6-alpha.2 → 1.2.6-alpha.4

package/.docs/docs/agents/agent-approval.md

@@ -110,6 +110,29 @@ A tool can also pause _during_ its `execute` function by calling `suspend()`. Th
 
 The stream emits a `tool-call-suspended` chunk with a custom payload defined by the tool's `suspendSchema`. You resume by calling `resumeStream()` with data matching the tool's `resumeSchema`.
 
+```typescript
+const weatherTool = createTool({
+  id: 'get-weather',
+  inputSchema: z.object({
+    location: z.string().optional(),
+  }),
+  suspendSchema: z.object({
+    question: z.string(),
+  }),
+  resumeSchema: z.object({
+    location: z.string(),
+  }),
+  execute: async ({ location }, context) => {
+    if (!location) {
+      return await context?.agent?.suspend({
+        question: 'Which city would you like the weather for?',
+      })
+    }
+    return await fetchWeather(location)
+  },
+})
+```
+
 > **Note:** `suspend()` doesn't throw — return immediately after calling it (e.g. `return await suspend({ ... })`). Code after `await suspend(...)` still runs before the tool pauses.
 
 ## Tool approval with `generate()`

package/.docs/docs/agents/skills.md

@@ -129,6 +129,8 @@ export const agent = new Agent({
 
 The resolver function receives `{ requestContext }` and returns a `SkillInput[]` array or a `Promise<SkillInput[]>`.
 
+See [Request Context](https://mastra.ai/docs/server/request-context) for more on using request context with agents and workflows.
+
 ## Merging with workspace skills
 
 When an agent has both `skills` and a workspace with skills configured, they merge. Agent-level skills take precedence on name conflicts:
@@ -149,7 +151,7 @@ const customReview = createSkill({
   instructions: '...',
 })
 
-export const agent = new Agent({
+export const reviewer = new Agent({
   id: 'reviewer',
   model: 'openai/gpt-5.5',
   workspace,

package/.docs/models/index.md

@@ -2,7 +2,7 @@
 
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4562 models from 140 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4563 models from 140 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/opencode.md

@@ -2,7 +2,7 @@
 
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 50 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 51 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
 
@@ -75,6 +75,7 @@ for await (const chunk of stream) {
 | `opencode/gpt-5.5`                | 1.1M    |       |           |       |       |       | $5         | $30         |
 | `opencode/gpt-5.5-pro`            | 1.1M    |       |           |       |       |       | $30        | $180        |
 | `opencode/grok-build-0.1`         | 256K    |       |           |       |       |       | $1         | $2          |
+| `opencode/hy3-free`               | 256K    |       |           |       |       |       | —          | —           |
 | `opencode/kimi-k2.5`              | 262K    |       |           |       |       |       | $0.60      | $3          |
 | `opencode/kimi-k2.6`              | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `opencode/kimi-k2.7-code`         | 262K    |       |           |       |       |       | $0.95      | $4          |

package/.docs/reference/core/mastra-class.md

@@ -45,7 +45,7 @@ export const mastra = new Mastra({
 })
 ```
 
-`notifications.dispatch.enabled` registers an internal workflow with the default cron `*/1 * * * *`. The dispatcher reads due notification records from storage, groups summaries by `agentId`, `resourceId`, and `threadId`, and emits signals through the agent thread runtime. It isn't a user-facing entrypoint.
+`notifications.dispatch.enabled` allows an internal dispatcher workflow to run with the default cron `*/1 * * * *`. The dispatcher reads due notification records from storage, groups summaries by `agentId`, `resourceId`, and `threadId`, and emits signals through the agent thread runtime. It isn't a user-facing entrypoint. The dispatch schedule (and the workflow scheduler backing it) activates lazily on the first deferred or summarized notification, so apps that never defer notifications don't run a scheduler at all.
 
 ## Constructor parameters
 

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.2.6-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`a940148`](https://github.com/mastra-ai/mastra/commit/a9401483e1bfe85c18a6e73d33c5949239d65a92)]:
+  - @mastra/core@1.50.1-alpha.2
+
 ## 1.2.6-alpha.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.6-alpha.2",
+  "version": "1.2.6-alpha.4",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,15 +28,15 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.50.1-alpha.1",
+    "@mastra/core": "1.50.1-alpha.2",
     "@mastra/mcp": "^1.13.1"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
     "@types/jsdom": "^21.1.7",
     "@types/node": "22.19.21",
-    "@vitest/coverage-v8": "4.1.8",
-    "@vitest/ui": "4.1.8",
+    "@vitest/coverage-v8": "4.1.9",
+    "@vitest/ui": "4.1.9",
     "@wong2/mcp-cli": "^2.0.0",
     "cross-env": "^10.1.0",
     "eslint": "^10.4.1",
@@ -44,9 +44,9 @@
     "tsup": "^8.5.1",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "4.1.8",
+    "vitest": "4.1.9",
     "@internal/lint": "0.0.112",
-    "@mastra/core": "1.50.1-alpha.1",
+    "@mastra/core": "1.50.1-alpha.2",
     "@internal/types-builder": "0.0.87"
   },
   "homepage": "https://mastra.ai",