@mastra/mcp-docs-server 1.3.9-alpha.1 → 1.3.9-alpha.4

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

@@ -65,6 +65,50 @@ const selected = await mastraClient.getTrace(list.spans[0].traceId)
 
 It accepts the same filtering, ordering and delta-polling arguments as `listTraces()`. Use `listTraces()` when you actually need the full span payloads.
 
+## Querying spans
+
+`querySpans()` returns completed span summaries across traces. It requires a positive ISO timestamp range over span start time and supports cursor pagination:
+
+```typescript
+const result = await mastraClient.querySpans({
+  timeRange: {
+    from: '2026-10-01T00:00:00.000Z',
+    to: '2026-10-02T00:00:00.000Z',
+  },
+  where: {
+    op: 'and',
+    args: [
+      { op: 'eq', left: { path: 'threadId' }, right: { literal: 'thread-123' } },
+      { op: 'gte', left: { path: 'durationMs' }, right: { literal: 1000 } },
+    ],
+  },
+  orderBy: [{ field: 'startedAt', direction: 'desc' }],
+  page: { limit: 100 },
+})
+
+// Pass result.page.next as page.after to continue with the same filters and ordering.
+console.log(result.spans)
+```
+
+Pages default to 100 rows and allow at most 1,000. The response is `{ spans, page: { next } }`, without a total count. Ordering accepts exactly one of `startedAt` or `endedAt`, ascending or descending, and defaults to descending start time.
+
+| Fields                                                                                                                                       | Operators                                                                                                  |
+| -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `traceId`, `spanId`, `parentSpanId`, `threadId`                                                                                              | `eq`, `ne`, `in`, `notIn`, `exists`, `notExists`                                                           |
+| `organizationId`, `resourceId`, `runId`, `sessionId`, `userId`, `requestId`, `serviceName`, `experimentId`, `environment`, `executionSource` | Same string operators                                                                                      |
+| Entity, parent entity and root entity `Type`, `Id`, `Name`, `VersionId` fields, such as `parentEntityId`                                     | Same string operators                                                                                      |
+| `name`, `spanType`, `status`                                                                                                                 | Same string operators; `name` also accepts `matches` / `notMatches` for normalized whole words and phrases |
+| `startedAt`, `endedAt`, `durationMs`                                                                                                         | Comparisons, membership and presence                                                                       |
+| `error`                                                                                                                                      | `exists`, `notExists`                                                                                      |
+
+Combine predicates with `and`, `or` and `not`. Membership uses `{ op: 'in', value: { path: 'spanType' }, set: ['agent_run', 'tool_call'] }`. A span's status is `error` when it has an error and `success` otherwise.
+
+Each summary includes identity, context, entity lineage, status, timestamps, `durationMs`, model/provider and input/output/error previews. Model/provider are available in returned rows but aren't filterable.
+
+The additional identity, context and parent/root entity filters require an updated storage adapter. With an older adapter, requests using these filters return a structured `422` error.
+
+DuckDB returns `null` for parent/root entity type, ID and name, and for `executionSource`. Equality filters on these fields match no spans. Parent/root entity version IDs remain available.
+
 ## Querying traces
 
 `queryTraces()` finds completed logical traces using trace fields and conditions over related spans. Every query requires an ISO timestamp range.

package/.docs/reference/connect/channels.md

@@ -18,9 +18,9 @@ export const mastra = new Mastra({
 
 Returns: `Promise<ChannelsResolver>`. See [The resolver](#the-resolver).
 
-The [documented channel setup](https://mastra.ai/docs/mastra-platform/connect/channels) covers Slack, Telegram, and Discord. Their implementations come from `@mastra/slack`, `@mastra/telegram`, and `@mastra/discord`, loaded on demand. Use those packages directly to configure a channel outside the platform connection flow.
+The [documented channel setup](https://mastra.ai/docs/mastra-platform/connect/channels) covers Slack, Telegram, Discord, and Microsoft Teams. Their implementations come from `@mastra/slack`, `@mastra/telegram`, `@mastra/discord`, and `@mastra/teams`, loaded on demand. Use those packages directly to configure a channel outside the platform connection flow.
 
-The SDK also registers `microsoft-teams`, backed by `@mastra/teams`. SDK registration doesn't guarantee availability in the platform catalog. Constructing the Teams provider requires `MASTRA_ENCRYPTION_KEY`, a base64-encoded 32-byte value for protecting stored bot secrets. Without it, the resolver warns and skips Teams, including its routes.
+The Teams provider encrypts stored bot secrets with `MASTRA_ENCRYPTION_KEY` when set. When it isn't, the key is derived from the platform access token and a warning is logged while a Teams connection is active. Rotating the platform access token makes stored bot credentials unreadable (disconnect and reconnect to re-provision). Projects without a Teams connection are unaffected.
 
 ## Parameters
 

package/.docs/reference/connect/providers.md

@@ -4,7 +4,7 @@
 
 # Provider toolsets
 
-This page documents generated toolsets for 21 providers (883 tools in this version of `@mastra/connect`). It isn't an exhaustive list of providers registered in the SDK or available in the platform catalog. [`tools()`](https://mastra.ai/reference/connect/tools) exposes a provider's toolset when the project has an active connection for its provider ID.
+This page documents generated toolsets for 22 providers (910 tools in this version of `@mastra/connect`). It isn't an exhaustive list of providers registered in the SDK or available in the platform catalog. [`tools()`](https://mastra.ai/reference/connect/tools) exposes a provider's toolset when the project has an active connection for its provider ID.
 
 Tool keys are stable identifiers of the form `<provider>_<action>` and are the values accepted by `allowTools` and `disallowTools`. Toolsets are versioned with the package: the exact list depends on the installed `@mastra/connect` version, and this page reflects the version it was generated from.
 
@@ -18,13 +18,14 @@ MCP providers (Attio, Canva, Clay, Neon, Render, Robinhood, and Sanity) serve th
 | ![](https://cdn.simpleicons.org/github?viewbox=auto\&size=28) [GitHub](#github)                           | `github`          | 49    |
 | ![](https://cdn.simpleicons.org/googlecalendar?viewbox=auto\&size=28) [Google Calendar](#google-calendar) | `google-calendar` | 43    |
 | ![](https://cdn.simpleicons.org/googledocs?viewbox=auto\&size=28) [Google Docs](#google-docs)             | `google-docs`     | 37    |
-| ![](https://cdn.simpleicons.org/googledrive?viewbox=auto\&size=28) [Google Drive](#google-drive)          | `google-drive`    | 30    |
+| ![](https://cdn.simpleicons.org/googledrive?viewbox=auto\&size=28) [Google Drive](#google-drive)          | `google-drive`    | 32    |
 | ![](https://cdn.simpleicons.org/gmail?viewbox=auto\&size=28) [Gmail](#gmail)                              | `google-mail`     | 52    |
 | ![](https://cdn.simpleicons.org/googlesheets?viewbox=auto\&size=28) [Google Sheets](#google-sheets)       | `google-sheet`    | 18    |
 | ![](https://cdn.simpleicons.org/hubspot?viewbox=auto\&size=28) [HubSpot](#hubspot)                        | `hubspot`         | 50    |
 | ![](https://app.nango.dev/images/template-logos/incident-io.svg) [incident.io](#incidentio)               | `incident-io`     | 66    |
 | ![](https://cdn.simpleicons.org/jira?viewbox=auto\&size=28) [Jira](#jira)                                 | `jira`            | 38    |
 | ![](https://cdn.simpleicons.org/linear?viewbox=auto\&size=28) [Linear](#linear)                           | `linear`          | 46    |
+| ![](https://cdn.simpleicons.org/microsoftteams?viewbox=auto\&size=28) [Microsoft Teams](#microsoft-teams) | `microsoft-teams` | 25    |
 | ![](https://cdn.simpleicons.org/notion?viewbox=auto\&size=28) [Notion](#notion)                           | `notion`          | 44    |
 | ![](https://svgl.app/library/openai.svg) [OpenAI](#openai)                                                | `openai`          | 26    |
 | ![](https://cdn.simpleicons.org/posthog?viewbox=auto\&size=28) [PostHog](#posthog)                        | `posthog`         | 67    |
@@ -310,7 +311,7 @@ Provider ID: `google-docs` · 37 tools
 
 ## Google Drive
 
-Provider ID: `google-drive` · 30 tools
+Provider ID: `google-drive` · 32 tools
 
 | Tool                                        | Description                                                                                                                    |
 | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
@@ -323,6 +324,7 @@ Provider ID: `google-drive` · 30 tools
 | `google_drive_delete_permission`            | Remove a permission from a file                                                                                                |
 | `google_drive_delete_shared_drive`          | Delete a shared drive                                                                                                          |
 | `google_drive_empty_trash`                  | Permanently delete all trashed files                                                                                           |
+| `google_drive_export_file`                  | Export a Google Workspace file (Doc, Sheet, Slide, etc.) to the specified MIME type.                                           |
 | `google_drive_find_file`                    | Search for files by name or query in Google Drive                                                                              |
 | `google_drive_find_folder`                  | Search for a folder by name or query                                                                                           |
 | `google_drive_get_about`                    | Get the user's drive info and storage quota                                                                                    |
@@ -337,6 +339,7 @@ Provider ID: `google-drive` · 30 tools
 | `google_drive_list_drives`                  | List shared drives the user can access, with cursor pagination and drive metadata like hidden, capabilities, and restrictions. |
 | `google_drive_list_files_non_unified`       | List immediate files and folders for a folder ID, or root when omitted, with cursor pagination and shared-drive support.       |
 | `google_drive_list_permissions`             | List permissions on a file                                                                                                     |
+| `google_drive_list_revisions`               | List the revision history for a Drive file.                                                                                    |
 | `google_drive_move_file`                    | Move a file to a different folder                                                                                              |
 | `google_drive_unhide_shared_drive`          | Restore a hidden shared drive to default view                                                                                  |
 | `google_drive_update_comment`               | Update a comment on a file                                                                                                     |
@@ -657,6 +660,38 @@ Provider ID: `linear` · 46 tools
 | `linear_update_issue_relation` | Update fields on an existing Linear issue relation.            |
 | `linear_update_project`        | Update an existing Linear project.                             |
 
+## Microsoft Teams
+
+Provider ID: `microsoft-teams` · 25 tools
+
+| Tool                                       | Description                                      |
+| ------------------------------------------ | ------------------------------------------------ |
+| `microsoft_teams_add_team_member`          | Add a member to a team                           |
+| `microsoft_teams_create_channel`           | Create a channel in a team.                      |
+| `microsoft_teams_create_channel_message`   | Post a root message in a channel                 |
+| `microsoft_teams_create_channel_tab`       | Add a tab to a channel.                          |
+| `microsoft_teams_create_chat`              | Create a one-on-one or group chat.               |
+| `microsoft_teams_create_chat_message`      | Send a message in a chat                         |
+| `microsoft_teams_create_team`              | Create a team from a template or existing group. |
+| `microsoft_teams_delete_channel`           | Delete a channel from a team                     |
+| `microsoft_teams_get_channel`              | Retrieve a channel by ID.                        |
+| `microsoft_teams_get_channel_message`      | Retrieve a channel message by ID.                |
+| `microsoft_teams_get_chat`                 | Retrieve a chat by ID.                           |
+| `microsoft_teams_get_chat_message`         | Retrieve a chat message by ID.                   |
+| `microsoft_teams_get_team`                 | Retrieve a team by ID.                           |
+| `microsoft_teams_list_channel_messages`    | List root messages in a channel.                 |
+| `microsoft_teams_list_channel_replies`     | List replies under a channel message thread      |
+| `microsoft_teams_list_channel_tabs`        | List tabs configured on a channel.               |
+| `microsoft_teams_list_channels`            | List channels in a team.                         |
+| `microsoft_teams_list_chat_members`        | List members in a chat                           |
+| `microsoft_teams_list_chat_messages`       | List messages in a chat.                         |
+| `microsoft_teams_list_chats`               | List chats for a user.                           |
+| `microsoft_teams_list_joined_teams`        | List teams the user has joined                   |
+| `microsoft_teams_list_team_members`        | List members in a team.                          |
+| `microsoft_teams_remove_team_member`       | Remove a member from a team.                     |
+| `microsoft_teams_reply_to_channel_message` | Reply to a channel message thread.               |
+| `microsoft_teams_update_channel`           | Update mutable channel properties.               |
+
 ## Notion
 
 Provider ID: `notion` · 44 tools

package/.docs/reference/connect/tools.md

@@ -25,7 +25,7 @@ See [Connect](https://mastra.ai/docs/mastra-platform/connect/overview) to get st
 
 ## Parameters
 
-**options** (`ToolsOptions`): Optional discovery and client configuration.
+**options** (`ToolsOptions | ((ctx?: ToolsResolverContext) => ToolsOptions | Promise<ToolsOptions>)`): Optional discovery and client configuration, or a callback returning it per request. See Per-request options below.
 
 **options.projectId** (`string`): Platform project whose connections to discover. Falls back to MASTRA\_PROJECT\_ID.
 
@@ -41,6 +41,25 @@ See [Connect](https://mastra.ai/docs/mastra-platform/connect/overview) to get st
 
 **options.ttlMs** (`number`): How long a resolved snapshot stays fresh, in milliseconds. Default 30000. 0 revalidates on every resolution.
 
+### Per-request options
+
+Pass a callback instead of an options object to vary options per request, for example role-based filters or approval policies. The callback runs on every resolution (sync or async) and receives the same context Mastra passes the resolver (`requestContext` is populated when the resolver is an agent's `tools` option):
+
+```typescript
+const connected = tools(ctx => ({
+  providers: {
+    linear:
+      ctx?.requestContext?.get('role') === 'viewer'
+        ? { allowTools: ['linear_list_*'] }
+        : { requireApproval: ['linear_delete_*'] },
+  },
+}))
+```
+
+The resolver memoizes snapshots per distinct options value, so requests producing the same options share one cached snapshot with the usual `ttlMs` and stale-while-revalidate semantics. Structurally equal options returned from different calls count as the same value; non-serializable values such as a custom `client.fetch` compare by identity. The resolver keeps caches for at most 32 distinct options values and evicts the least recently used one (closing its MCP transports) past that, so derive options from a small, closed set of inputs such as roles, not from unbounded per-request data.
+
+With the callback form, option validation runs at the first resolution that produces a given options value rather than at `tools()` time, and a validation error fails that resolution. `refresh()` fetches for the options the callback returns without a context (the same variant a direct `await connected()` call uses), and `disconnect()` closes every memoized variant.
+
 ### Per-provider options
 
 Each value in the `providers` record form is `true`, `false`, or a `ToolsProviderOptions`:
@@ -89,7 +108,7 @@ The resolver also exposes methods for manual control:
 
 Errors fall into four groups:
 
-- Configuration errors (missing project ID or token, a malformed provider ID, both `allowTools` and `disallowTools` at one level, invalid `ttlMs`) throw when you call `tools()`.
+- Configuration errors (missing project ID or token, a malformed provider ID, both `allowTools` and `disallowTools` at one level, invalid `ttlMs`) throw when you call `tools()`. With [the callback form](#per-request-options), they fail the first resolution that produces the invalid options instead.
 - An enabled provider ID that the platform catalog confirms is unknown fails the resolution with `invalid_options`. An unknown tool key or zero-match glob in a per-provider filter does the same. If the catalog can't be reached, an unknown ID downgrades to a warning and is skipped.
 - If a background refresh fails while a snapshot is cached, the resolver keeps serving the cached toolsets and warns. It rejects only when nothing was ever cached.
 - A problem with one provider, such as a connection that needs reauthorization, logs a warning and skips that provider. The other providers' tools still load.

package/.docs/reference/datasets/list.md

@@ -32,13 +32,19 @@ const filtered = await mastra.datasets.list({
 const forAgents = await mastra.datasets.list({
   filters: { targetIds: ['agent-a', 'agent-b'] },
 })
+
+// Fetch specific datasets by ID, all on one page
+const byId = await mastra.datasets.list({
+  perPage: false,
+  filters: { datasetIds: ['dataset-1', 'dataset-2'] },
+})
 ```
 
 ## Parameters
 
 **page** (`number`): Page number. Defaults to 0.
 
-**perPage** (`number`): Number of datasets per page. Defaults to 20.
+**perPage** (`number | false`): Number of datasets per page, or false to return every match on one page. Defaults to 20.
 
 **filters** (`object`): Optional filters applied at the storage layer.
 
@@ -54,6 +60,8 @@ const forAgents = await mastra.datasets.list({
 
 **filters.targetIds** (`string[]`): Restrict to datasets whose targetIds intersect this list (any-overlap match). Empty array is treated as no filter.
 
+**filters.datasetIds** (`string[]`): Restrict to datasets with these IDs. Empty array matches no datasets. Pass perPage: false to get every match on one page.
+
 **filters.name** (`string`): Case-insensitive substring match on dataset name. Empty string is treated as no filter.
 
 ## Returns

package/.docs/reference/observability/metrics/automatic-metrics.md

@@ -10,7 +10,7 @@ For setup instructions, see the [Metrics overview](https://mastra.ai/docs/observ
 
 ## When Mastra emits automatic metrics
 
-Metrics are extracted from spans when they end. The observability layer inspects each completed span, calculates duration, and (for model generation spans) reads token usage data. No manual instrumentation is needed.
+Metrics are extracted from spans when they end. The observability layer inspects each completed span, calculates duration, and reads token usage data from model generation and classifier evaluation spans. No manual instrumentation is needed.
 
 ### What affects whether a metric is available
 
@@ -35,7 +35,7 @@ Duration metrics record execution time in milliseconds, calculated from the span
 
 ## Token usage metrics
 
-Token metrics are emitted only from `MODEL_GENERATION` spans that include `usage` data. Token metrics require usage data from the provider.
+Token metrics are emitted from `MODEL_GENERATION` and `CLASSIFIER_EVALUATION` spans that include `usage` data. Token metrics require usage data from the provider.
 
 ### Input token metrics
 
@@ -142,7 +142,7 @@ When you spot a spike in latency or token usage on the Metrics dashboard, correl
 
 ### Token metrics are missing
 
-- **Span is a model generation**: Token metrics are only emitted from `MODEL_GENERATION` spans.
+- **Span is a model generation or classifier evaluation**: Token metrics are only emitted from `MODEL_GENERATION` and `CLASSIFIER_EVALUATION` spans.
 - **Provider reports usage**: The model provider must include `usage` data in its response. Usage data is required to emit token metrics.
 
 ## Related

package/.docs/reference/observability/metrics/queries.md

@@ -110,6 +110,7 @@ All metric operations accept the same optional `filters` object. Raw list reques
 | `userId`                | `string`                                                                         | User ID                                                                                                                            |
 | `organizationId`        | `string`                                                                         | Organization ID                                                                                                                    |
 | `experimentId`          | `string`                                                                         | Experiment or evaluation run ID                                                                                                    |
+| `experimentIds`         | `string[]`                                                                       | One to 1,000 experiment IDs                                                                                                        |
 | `serviceName`           | `string`                                                                         | Service name                                                                                                                       |
 | `environment`           | `string`                                                                         | Environment name                                                                                                                   |
 | `resourceId`            | `string`                                                                         | Resource ID                                                                                                                        |

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

@@ -542,6 +542,9 @@ interface AgentRunAttributes {
 
   /** Maximum steps allowed */
   maxSteps?: number
+
+  /** When the run's model streamed its first chunk, copied from the agent's own first generation */
+  completionStartTime?: Date
 }
 ```
 
@@ -639,6 +642,9 @@ interface ModelStepAttributes {
 
   /** Result warnings */
   warnings?: Record<string, any>
+
+  /** When the step's first inference streamed its first chunk */
+  completionStartTime?: Date
 }
 ```
 

package/.docs/reference/streaming/agents/stream.md

@@ -248,6 +248,24 @@ const stream = await agent.stream('message for agent')
 
 **spanId** (`string`): The root span ID associated with this execution when Tracing is enabled. Use this for span-level lookup and correlation.
 
+## `stopWhen` errors
+
+If a `stopWhen` predicate throws, `fullStream` rejects with that error. The stream does not emit a `step-finish`, `finish`, or `error` chunk for the failure. Catch the rejection around stream consumption:
+
+```ts
+async function consumeStream() {
+  try {
+    for await (const chunk of stream.fullStream) {
+      console.log(chunk)
+    }
+  } catch (error) {
+    console.error('stopWhen failed', error)
+  }
+}
+```
+
+Durable transports reconstruct cross-process errors from their serialized name and message. The original stack, cause, and subclass identity are not available to the stream consumer.
+
 ## Signal visibility
 
 Signals, including reactive reminders, appear in `fullStream` by default. Set `hideSignals` to omit selected signal chunks from your stream:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.3.9-alpha.1",
+  "version": "1.3.9-alpha.4",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -26,8 +26,8 @@
     "@mastra/mcp-legacy": "npm:@mastra/mcp@^1.18.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.6.4",
-    "@mastra/core": "1.78.1-alpha.0",
-    "@mastra/mcp": "^2.4.2-alpha.0"
+    "@mastra/mcp": "^2.4.2-alpha.0",
+    "@mastra/core": "1.79.0-alpha.2"
   },
   "devDependencies": {
     "@hono/node-server": "^2.0.0",
@@ -43,9 +43,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.11",
-    "@internal/lint": "0.0.144",
     "@internal/types-builder": "0.0.119",
-    "@mastra/core": "1.78.1-alpha.0"
+    "@internal/lint": "0.0.144",
+    "@mastra/core": "1.79.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {