@mastra/mcp-docs-server 1.1.40-alpha.1 → 1.1.40-alpha.3

package/.docs/models/gateways/openrouter.md

@@ -1,6 +1,6 @@
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 357 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 358 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -373,6 +373,7 @@ ANTHROPIC_API_KEY=ant-...
 | `x-ai/grok-4.20`                                                |
 | `x-ai/grok-4.20-multi-agent`                                    |
 | `x-ai/grok-4.3`                                                 |
+| `x-ai/grok-build-0.1`                                           |
 | `xiaomi/mimo-v2-flash`                                          |
 | `xiaomi/mimo-v2-omni`                                           |
 | `xiaomi/mimo-v2-pro`                                            |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4207 models from 121 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4209 models from 122 providers through a single API.
 
 ## Features
 

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

@@ -1,6 +1,6 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 41 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 40 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).
 
@@ -74,7 +74,6 @@ for await (const chunk of stream) {
 | `opencode/nemotron-3-super-free`  | 205K    |       |           |       |       |       | —          | —           |
 | `opencode/qwen3.5-plus`           | 262K    |       |           |       |       |       | $0.20      | $1          |
 | `opencode/qwen3.6-plus`           | 262K    |       |           |       |       |       | $0.50      | $3          |
-| `opencode/qwen3.6-plus-free`      | 262K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -104,7 +103,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "opencode/qwen3.6-plus-free"
+      ? "opencode/qwen3.6-plus"
       : "opencode/big-pickle";
   }
 });

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

@@ -0,0 +1,72 @@
+# ![StepFun logo](https://models.dev/logos/stepfun-ai.svg)StepFun
+
+Access 2 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+
+Learn more in the [StepFun documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code).
+
+```bash
+STEPFUN_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "stepfun-ai/step-3.5-flash"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code) for details.
+
+## Models
+
+| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `stepfun-ai/step-3.5-flash`      | 256K    |       |           |       |       |       | $0.10      | $0.29       |
+| `stepfun-ai/step-3.5-flash-2603` | 256K    |       |           |       |       |       | $0.10      | $0.30       |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.stepfun.ai/step_plan/v1",
+    id: "stepfun-ai/step-3.5-flash",
+    apiKey: process.env.STEPFUN_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "stepfun-ai/step-3.5-flash-2603"
+      : "stepfun-ai/step-3.5-flash";
+  }
+});
+```

package/.docs/models/providers.md

@@ -96,6 +96,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)
 - [STACKIT](https://mastra.ai/models/providers/stackit)
 - [StepFun](https://mastra.ai/models/providers/stepfun)
+- [StepFun](https://mastra.ai/models/providers/stepfun-ai)
 - [submodel](https://mastra.ai/models/providers/submodel)
 - [Synthetic](https://mastra.ai/models/providers/synthetic)
 - [Tencent Coding Plan (China)](https://mastra.ai/models/providers/tencent-coding-plan)

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

@@ -464,6 +464,37 @@ response.processDataStream({
 })
 ```
 
+### Tracing client tools
+
+When `@mastra/observability` is installed and configured on the server, a client-side tool records a `CLIENT_TOOL_CALL` span as a child of the current `AGENT_RUN` span. The server creates that span when the model emits the client tool call, injects a W3C trace carrier into the outgoing tool-call chunk, and ends the span once the tool arguments are available. Without server-side observability configured, client tool tracing is a no-op.
+
+The client SDK also measures the wall-clock duration of each client tool's `execute` function and ships it back to the server, where it's emitted as a `mastra_tool_duration_ms` metric with `toolType: "client"`.
+
+For richer telemetry from inside your tool's `execute` function, use the `observe` helper on the execution context to add child spans and structured logs:
+
+```typescript
+import { createTool } from '@mastra/client-js'
+import { z } from 'zod'
+
+const fetchUserTool = createTool({
+  id: 'fetchUser',
+  description: 'Fetches the current user profile',
+  inputSchema: z.object({ userId: z.string() }),
+  execute: async ({ userId }, { observe }) => {
+    observe.log('info', 'fetching user', { userId })
+    const user = await observe.span('http GET /users', async () => {
+      const res = await fetch(`/api/users/${userId}`)
+      return res.json()
+    })
+    return user
+  },
+})
+```
+
+`observe` is always available — when no tracing context is active (e.g. running outside a traced agent), `span` runs the function directly and `log` is a no-op. No null-checking needed.
+
+The SDK serializes everything the collector buffered as OTLP/JSON and ships it back in the next request body. The server's `@mastra/observability` package validates that the spans belong to the correct trace (preventing cross-trace injection) and forwards each span/log into the same observability bus that server-side telemetry uses. Your existing exporters pick them up automatically after observability is configured.
+
 ## Stored agents
 
 Stored agents are agent configurations stored in a database that can be created, updated, and deleted at runtime. They reference primitives (tools, workflows, other agents, scorers) by key, which are resolved from the Mastra registry when the agent is instantiated. Memory is configured inline as a `SerializedMemoryConfig` object with options such as `lastMessages` and `semanticRecall`.

package/.docs/reference/observability/tracing/interfaces.md

@@ -43,6 +43,7 @@ interface SpanTypeMap {
   MODEL_STEP: ModelStepAttributes
   MODEL_CHUNK: ModelChunkAttributes
   TOOL_CALL: ToolCallAttributes
+  CLIENT_TOOL_CALL: ClientToolCallAttributes
   MCP_TOOL_CALL: MCPToolCallAttributes
   PROCESSOR_RUN: ProcessorRunAttributes
   WORKFLOW_STEP: WorkflowStepAttributes
@@ -255,6 +256,18 @@ enum SpanType {
   /** Function/tool execution with inputs, outputs, errors */
   TOOL_CALL = 'tool_call',
 
+  /**
+   * Client-side tool execution marker. The server creates this span
+   * when the model emits a client tool call, injects its W3C carrier
+   * into the outgoing tool-call chunk, then ends the span once tool
+   * args are available. Child spans/logs from the client SDK flow back
+   * as OTLP/JSON via the ClientObservabilityProxy interface in
+   * @mastra/observability and parent themselves under this span.
+   * See the "Client tools" section in the @mastra/client-js reference
+   * for the full flow.
+   */
+  CLIENT_TOOL_CALL = 'client_tool_call',
+
   /** Workflow run - root span for workflow processes */
   WORKFLOW_RUN = 'workflow_run',
 

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.1.40-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`2f5f58a`](https://github.com/mastra-ai/mastra/commit/2f5f58a9a8bb13bcdc6789db221eef7c9bf1ff02)]:
+  - @mastra/core@1.37.0-alpha.1
+
 ## 1.1.40-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.40-alpha.1",
+  "version": "1.1.40-alpha.3",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/mcp": "^1.8.0",
-    "@mastra/core": "1.36.1-alpha.0"
+    "@mastra/core": "1.37.0-alpha.1",
+    "@mastra/mcp": "^1.8.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -48,7 +48,7 @@
     "vitest": "4.1.5",
     "@internal/lint": "0.0.97",
     "@internal/types-builder": "0.0.72",
-    "@mastra/core": "1.36.1-alpha.0"
+    "@mastra/core": "1.37.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {