@mastra/mcp-docs-server 1.1.32 → 1.1.33-alpha.3

package/.docs/models/providers/ollama-cloud.md

@@ -59,7 +59,7 @@ for await (const chunk of stream) {
 | `ollama-cloud/minimax-m2`             | 205K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/minimax-m2.1`           | 205K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/minimax-m2.5`           | 205K    |       |           |       |       |       | —          | —           |
-| `ollama-cloud/minimax-m2.7`           | 205K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/minimax-m2.7`           | 197K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/ministral-3:14b`        | 262K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/ministral-3:3b`         | 262K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/ministral-3:8b`         | 262K    |       |           |       |       |       | —          | —           |

package/.docs/models/providers/vivgrid.md

@@ -1,6 +1,6 @@
 # ![Vivgrid logo](https://models.dev/logos/vivgrid.svg)Vivgrid
 
-Access 12 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
+Access 13 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
 
 Learn more in the [Vivgrid documentation](https://docs.vivgrid.com/models).
 
@@ -35,9 +35,9 @@ for await (const chunk of stream) {
 | Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `vivgrid/deepseek-v3.2`                 | 128K    |       |           |       |       |       | $0.28      | $0.42       |
+| `vivgrid/deepseek-v4-pro`               | 1.0M    |       |           |       |       |       | $2         | $3          |
 | `vivgrid/gemini-3.1-flash-lite-preview` | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `vivgrid/gemini-3.1-pro-preview`        | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `vivgrid/glm-5`                         | 203K    |       |           |       |       |       | $1         | $3          |
 | `vivgrid/gpt-5-mini`                    | 272K    |       |           |       |       |       | $0.25      | $2          |
 | `vivgrid/gpt-5.1-codex`                 | 400K    |       |           |       |       |       | $1         | $10         |
 | `vivgrid/gpt-5.1-codex-max`             | 400K    |       |           |       |       |       | $1         | $10         |
@@ -46,6 +46,7 @@ for await (const chunk of stream) {
 | `vivgrid/gpt-5.4`                       | 400K    |       |           |       |       |       | $3         | $15         |
 | `vivgrid/gpt-5.4-mini`                  | 400K    |       |           |       |       |       | $0.75      | $5          |
 | `vivgrid/gpt-5.4-nano`                  | 400K    |       |           |       |       |       | $0.20      | $1          |
+| `vivgrid/gpt-5.5`                       | 1.1M    |       |           |       |       |       | $5         | $30         |
 
 ## Advanced configuration
 
@@ -75,7 +76,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "vivgrid/gpt-5.4-nano"
+      ? "vivgrid/gpt-5.5"
       : "vivgrid/deepseek-v3.2";
   }
 });

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

@@ -1,6 +1,6 @@
 # ![xAI logo](https://models.dev/logos/xai.svg)xAI
 
-Access 25 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
+Access 26 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
 
 Learn more in the [xAI documentation](https://docs.x.ai/docs/models).
 
@@ -54,6 +54,7 @@ for await (const chunk of stream) {
 | `xai/grok-4.20-0309-non-reasoning` | 2.0M    |       |           |       |       |       | $2         | $6          |
 | `xai/grok-4.20-0309-reasoning`     | 2.0M    |       |           |       |       |       | $2         | $6          |
 | `xai/grok-4.20-multi-agent-0309`   | 2.0M    |       |           |       |       |       | $2         | $6          |
+| `xai/grok-4.3`                     | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `xai/grok-beta`                    | 131K    |       |           |       |       |       | $5         | $15         |
 | `xai/grok-code-fast-1`             | 256K    |       |           |       |       |       | $0.20      | $2          |
 | `xai/grok-vision-beta`             | 8K      |       |           |       |       |       | $5         | $15         |

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

@@ -208,4 +208,53 @@ A workflow run result yields the following:
 
 **eventTimestamp** (`Date`): The timestamp of the event
 
-**payload** (`object`): Contains currentStep (id, status, output, payload) and workflowState (status, steps record)
+**payload** (`object`): Contains currentStep (id, status, output, payload) and workflowState (status, steps record)
+
+## Schedules
+
+Schedules are declared in code via the `schedule` field on `createWorkflow`. The client SDK exposes read and operational methods for managing them at runtime. See [Scheduled workflows](https://mastra.ai/docs/workflows/scheduled-workflows).
+
+### `listSchedules()`
+
+List all schedules, optionally filtered by workflow id or status.
+
+```typescript
+const schedules = await mastraClient.listSchedules({
+  workflowId: 'daily-report',
+  status: 'active',
+})
+```
+
+### `getSchedule()`
+
+Fetch a single schedule by id.
+
+```typescript
+const schedule = await mastraClient.getSchedule('daily-report')
+```
+
+### `pauseSchedule()`
+
+Pause a schedule so the scheduler stops firing it. Returns the updated schedule. Idempotent.
+
+```typescript
+await mastraClient.pauseSchedule('daily-report')
+```
+
+### `resumeSchedule()`
+
+Resume a paused schedule. The next fire time is recomputed from now, so a long-paused schedule does not fire a backlog. Returns the updated schedule. Idempotent.
+
+```typescript
+await mastraClient.resumeSchedule('daily-report')
+```
+
+### `listScheduleTriggers()`
+
+List the trigger history for a schedule, including the joined run summary for each fire.
+
+```typescript
+const { triggers } = await mastraClient.listScheduleTriggers('daily-report', {
+  limit: 50,
+})
+```

package/.docs/reference/observability/tracing/bridges/datadog.md

@@ -0,0 +1,211 @@
+# DatadogBridge
+
+> **Warning:** The Datadog Bridge is currently **experimental**. APIs and configuration options may change in future releases.
+
+Enables bidirectional integration between Mastra tracing and Datadog. Creates native `dd-trace` APM spans in real time so that auto-instrumented operations inside tools and processors are correctly nested under their parent Mastra span. Emits LLM Observability data through `dd-trace`'s pipeline when spans end.
+
+## Constructor
+
+```typescript
+new DatadogBridge(config?: DatadogBridgeConfig)
+```
+
+## `DatadogBridgeConfig`
+
+```typescript
+interface DatadogBridgeConfig extends BaseExporterConfig {
+  apiKey?: string
+  mlApp?: string
+  site?: string
+  service?: string
+  env?: string
+  agentless?: boolean
+  integrationsEnabled?: boolean
+  requestContextKeys?: string[]
+}
+```
+
+Extends `BaseExporterConfig`, which includes:
+
+- `logger?: IMastraLogger` - Logger instance
+- `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: INFO)
+
+## Methods
+
+### `createSpan`
+
+```typescript
+createSpan(options: CreateSpanOptions<SpanType>): SpanIds | undefined
+```
+
+Called by the Mastra observability instance during span construction. Creates a dd-trace APM span eagerly via `tracer.startSpan()` and returns Mastra-compatible identifiers. The returned IDs are used by Mastra throughout the span's lifetime; the dd-trace span object is stored internally and used for scope activation.
+
+**Returns:** `SpanIds | undefined` - `{ spanId, traceId, parentSpanId }`, or `undefined` if the bridge is disabled.
+
+### `executeInContext`
+
+```typescript
+executeInContext<T>(spanId: string, fn: () => Promise<T>): Promise<T>
+```
+
+Executes an async function within the dd-trace context of a Mastra span. dd-trace auto-instrumented operations running inside the function (HTTP, database, etc.) will be parented to this span.
+
+**Returns:** `Promise<T>` - The result of the function execution.
+
+### `executeInContextSync`
+
+```typescript
+executeInContextSync<T>(spanId: string, fn: () => T): T
+```
+
+Executes a synchronous function within the dd-trace context of a Mastra span.
+
+**Returns:** `T` - The result of the function execution.
+
+### `flush`
+
+```typescript
+async flush(): Promise<void>
+```
+
+Force-flushes any buffered LLM Observability data to Datadog without shutting down the bridge. Useful in serverless environments where you need to ensure data is exported before the runtime terminates.
+
+### `shutdown`
+
+```typescript
+async shutdown(): Promise<void>
+```
+
+Force-finishes any APM spans that weren't properly closed, flushes pending LLM Observability data, disables the LLM Observability integration, and clears all internal state.
+
+## Usage examples
+
+### Basic Usage
+
+```typescript
+import tracer from 'dd-trace'
+
+tracer.init({
+  service: process.env.DD_SERVICE || 'my-mastra-app',
+  env: process.env.DD_ENV || 'production',
+})
+
+import { Mastra } from '@mastra/core'
+import { Observability } from '@mastra/observability'
+import { DatadogBridge } from '@mastra/datadog'
+
+const mastra = new Mastra({
+  observability: new Observability({
+    configs: {
+      default: {
+        serviceName: 'my-mastra-app',
+        bridge: new DatadogBridge({
+          mlApp: process.env.DD_LLMOBS_ML_APP!,
+        }),
+      },
+    },
+  }),
+  agents: { myAgent },
+})
+```
+
+### Agentless Mode (LLM Observability only, no local agent)
+
+If you don't have a local Datadog Agent and only want LLM Observability data, enable agentless mode:
+
+```typescript
+new DatadogBridge({
+  mlApp: process.env.DD_LLMOBS_ML_APP!,
+  apiKey: process.env.DD_API_KEY!,
+  agentless: true,
+})
+```
+
+Note: APM data cannot be sent in agentless mode. If you only need LLM Observability data without `dd-trace` APM, the [Datadog Exporter](https://mastra.ai/reference/observability/tracing/exporters/datadog) is a simpler choice.
+
+### With Additional Exporters
+
+The bridge can be combined with non-Datadog exporters to send traces to additional destinations:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { Observability, DefaultExporter } from '@mastra/observability'
+import { DatadogBridge } from '@mastra/datadog'
+
+const mastra = new Mastra({
+  observability: new Observability({
+    configs: {
+      default: {
+        serviceName: 'my-mastra-app',
+        bridge: new DatadogBridge({
+          mlApp: process.env.DD_LLMOBS_ML_APP!,
+        }),
+        exporters: [
+          new DefaultExporter(), // Studio access
+        ],
+      },
+    },
+  }),
+})
+```
+
+> **Note:** Don't combine `DatadogBridge` with `DatadogExporter` in the same configuration — both emit to LLM Observability and would double-write the same data.
+
+## Setup requirements
+
+The DatadogBridge requires `dd-trace` to be initialized before any other imports so its auto-instrumentation can patch HTTP, database, and framework libraries at load time.
+
+See the [DatadogBridge Guide](https://mastra.ai/docs/observability/tracing/bridges/datadog) for complete setup instructions, including dd-trace initialization, bundler externals, and agent configuration.
+
+## Span mapping
+
+Mastra span types are mapped to Datadog LLM Observability span kinds:
+
+| Mastra SpanType    | Datadog Kind |
+| ------------------ | ------------ |
+| `AGENT_RUN`        | `agent`      |
+| `MODEL_GENERATION` | `workflow`   |
+| `MODEL_STEP`       | `llm`        |
+| `TOOL_CALL`        | `tool`       |
+| `MCP_TOOL_CALL`    | `tool`       |
+| `WORKFLOW_RUN`     | `workflow`   |
+| All other types    | `task`       |
+
+## Tags support
+
+`tracingOptions.tags` values become structured LLM Observability annotation tags: `key:value` entries are split into key/value pairs, and tags without a colon are set to `true`.
+
+```typescript
+const result = await agent.generate('Hello', {
+  tracingOptions: {
+    tags: ['production', 'instance_name:career-scout-api'],
+  },
+})
+```
+
+This produces:
+
+```json
+{
+  "production": true,
+  "instance_name": "career-scout-api"
+}
+```
+
+## Environment variables
+
+The bridge reads configuration from these environment variables:
+
+| Variable                      | Description                                        |
+| ----------------------------- | -------------------------------------------------- |
+| `DD_API_KEY`                  | Datadog API key (only required for agentless mode) |
+| `DD_LLMOBS_ML_APP`            | ML application name                                |
+| `DD_SITE`                     | Datadog site                                       |
+| `DD_ENV`                      | Environment name                                   |
+| `DD_LLMOBS_AGENTLESS_ENABLED` | Set to `'true'` or `'1'` to enable agentless mode  |
+
+## Related
+
+- [DatadogBridge Guide](https://mastra.ai/docs/observability/tracing/bridges/datadog) - Setup guide with examples
+- [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview) - General tracing concepts
+- [DatadogExporter Reference](https://mastra.ai/reference/observability/tracing/exporters/datadog) - LLM Observability only, no `dd-trace` APM

package/.docs/reference/observability/tracing/exporters/datadog.md

@@ -2,6 +2,8 @@
 
 Sends Tracing data to Datadog's LLM Observability product for monitoring and analytics.
 
+> **Info:** If you also use `dd-trace` APM auto-instrumentation and need it correctly parented under Mastra spans, use the [DatadogBridge](https://mastra.ai/reference/observability/tracing/bridges/datadog) instead. The exporter sends LLM Observability data after execution completes, so it doesn't participate in `dd-trace`'s live scope.
+
 ## Constructor
 
 ```typescript
@@ -89,7 +91,7 @@ const exporter = new DatadogExporter({
 
 ## Span mapping
 
-Mastra span types are mapped to Datadog LLMObs span kinds:
+Mastra span types are mapped to Datadog LLM Observability span kinds:
 
 | Mastra SpanType    | Datadog Kind |
 | ------------------ | ------------ |

package/.docs/reference/workflows/workflow.md

@@ -99,6 +99,22 @@ export const testWorkflow = createWorkflow({
 
 **requestContextSchema** (`StandardJSONSchemaV1`): Standard JSON Schema for validating request context values. When provided, the context is validated at the start of run.start(), throwing an error if validation fails.
 
+**schedule** (`WorkflowScheduleConfig | WorkflowScheduleConfig[]`): Optional cron schedule for the workflow. Accepts a single config or an array of configs to fire on multiple cadences. Setting this auto-promotes the workflow to the evented execution engine. See the scheduled workflows guide for usage.
+
+**schedule.id** (`string`): Stable identifier for the schedule. Required when passing an array of schedules. Defaults to the workflow id when passing a single schedule object.
+
+**schedule.cron** (`string`): A 5-, 6-, or 7-part cron expression. Validated at workflow construction time.
+
+**schedule.timezone** (`string`): IANA timezone, for example "America/New\_York". Defaults to the host's local timezone. Set this explicitly in production so fire times do not depend on server locale.
+
+**schedule.inputData** (`TInput`): Payload passed as the workflow's input on every fire.
+
+**schedule.initialState** (`TState`): Initial state for the run.
+
+**schedule.requestContext** (`Record<string, unknown>`): Request context attached to the run.
+
+**schedule.metadata** (`Record<string, unknown>`): Arbitrary metadata persisted alongside the schedule row.
+
 **options** (`WorkflowOptions`): Optional options for the workflow
 
 **options.tracingPolicy** (`TracingPolicy`): Optional tracing policy for the workflow

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 1.1.33-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`c05c9a1`](https://github.com/mastra-ai/mastra/commit/c05c9a13230988cef6d438a62f37760f31927bc7), [`e24aacb`](https://github.com/mastra-ai/mastra/commit/e24aacba07bd66f5d95b636dc24016fca26b52cf), [`c721164`](https://github.com/mastra-ai/mastra/commit/c7211643f7ac861f83b19a3757cc921487fc9d75), [`1b55954`](https://github.com/mastra-ai/mastra/commit/1b559541c1e08a10e49d01ffc51a634dfc37a286), [`5adc55e`](https://github.com/mastra-ai/mastra/commit/5adc55e63407be8ee977914957d68bcc2a075ceb), [`70017d7`](https://github.com/mastra-ai/mastra/commit/70017d72ab741b5d7040e2a15c251a317782e39e), [`e4942bc`](https://github.com/mastra-ai/mastra/commit/e4942bc7fdc903572f7d84f26d5e15f9d39c763d)]:
+  - @mastra/core@1.32.0-alpha.1
+
+## 1.1.33-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`6dcd65f`](https://github.com/mastra-ai/mastra/commit/6dcd65f2a34069e6dc43ba35f1d11119b9b40bef), [`1c2dda8`](https://github.com/mastra-ai/mastra/commit/1c2dda805fbfccc0abf55d4cb20cc34402dc3f0c), [`568777e`](https://github.com/mastra-ai/mastra/commit/568777ea8af77a672270b448dfd3996f9e75a964)]:
+  - @mastra/core@1.31.1-alpha.0
+  - @mastra/mcp@1.6.1-alpha.0
+
 ## 1.1.32
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.32",
+  "version": "1.1.33-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/core": "1.31.0",
-    "@mastra/mcp": "^1.6.0"
+    "@mastra/core": "1.32.0-alpha.1",
+    "@mastra/mcp": "^1.6.1-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -47,8 +47,8 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.5",
     "@internal/lint": "0.0.90",
-    "@internal/types-builder": "0.0.65",
-    "@mastra/core": "1.31.0"
+    "@mastra/core": "1.32.0-alpha.1",
+    "@internal/types-builder": "0.0.65"
   },
   "homepage": "https://mastra.ai",
   "repository": {