@mastra/mcp-docs-server 1.2.8-alpha.19 → 1.2.8-alpha.23

package/.docs/docs/getting-started/build-with-ai.md

@@ -142,13 +142,9 @@ If you're unable to use a local MCP server and need to connect to a remote serve
 
 ### Installation
 
-#### create-mastra
+The [`create-mastra`](https://mastra.ai/reference/cli/create-mastra) command installs Mastra skills automatically. It doesn't configure the MCP docs server. Add the server manually when you need MCP-specific tools such as the migration tool.
 
-During the interactive [create-mastra](https://mastra.ai/reference/cli/create-mastra) wizard, choose one of your tools in the MCP step.
-
-#### Manual setup
-
-If there are no specific instructions for your tool below, you may be able to add the MCP server with this common JSON configuration anyways.
+If there are no specific instructions for your tool below, you may be able to add the MCP server with this common JSON configuration.
 
 ```json
 {

package/.docs/docs/getting-started/manual-install.md

@@ -4,7 +4,7 @@
 
 **For AI agents:** Use this guide when tasked to create a runnable Mastra project from scratch without a CLI/boilerplate. It provides code examples for agents, tools, model configuration and how to install dependencies. Do not navigate to the quickstart guide, which is for humans. The model string is Mastra's model router format ('provider/model'; use / and not : to separate provider and model). Do not install any ai-sdk packages.
 
-Use this guide to manually build a standalone Mastra server step by step. In most cases, it's quicker to follow the [quickstart guide](https://mastra.ai/guides/getting-started/quickstart), which achieves the same result using the [`mastra create`](https://mastra.ai/reference/cli/create-mastra) command. For existing projects, you can also use [`mastra init`](https://mastra.ai/reference/cli/mastra).
+Use this guide to manually build a standalone Mastra server step by step. In most cases, it's quicker to follow the [quickstart guide](https://mastra.ai/guides/getting-started/quickstart), which achieves the same result using the [`create-mastra`](https://mastra.ai/reference/cli/create-mastra) command. For existing projects, you can also use [`mastra init`](https://mastra.ai/reference/cli/mastra).
 
 ## Instructions
 

package/.docs/docs/long-running-agents/goals.md

@@ -59,7 +59,7 @@ A goal step runs inside the agentic execution loop, right after `isTaskComplete`
 
 - **Not satisfied, budget remaining** → the loop continues; per-evaluation feedback is injected so the agent iterates.
 - **Satisfied** → the loop stops and the objective is marked `done`.
-- **Budget exhausted** (`runsUsed >= maxRuns`) → the loop stops but the objective stays `active`, so raising `maxRuns` later can resume it.
+- **Budget exhausted** (`runsUsed >= maxRuns`) → the loop stops and the objective is marked `paused`. Raise `maxRuns`, then resume the objective to continue.
 
 The step is a no-op for background-task, mid-tool-loop, and working-memory-only iterations — the same gating as `isTaskComplete`.
 
@@ -103,6 +103,8 @@ await worker.updateObjectiveOptions({ threadId, maxRuns: 100 })
 await worker.clearObjective({ threadId })
 ```
 
+Objective records include an optional `activeDurationMs` value for user interfaces that display active pursuit time. Mastra advances this value while an agent runs toward an active objective and checkpoints it when the run ends or waits for tool approval. Missing values represent zero, and the duration measures agent execution rather than the goal's wall-clock age.
+
 Per-objective values written by `setObjective` / `updateObjectiveOptions` take precedence over the agent's `goal` config, and that precedence is remembered in thread state. See the [`GoalEvaluationPayload` in the ChunkType reference](https://mastra.ai/reference/streaming/ChunkType) for the full goal chunk shape.
 
 ## Related

package/.docs/docs/mastra-platform/observability.md

@@ -4,15 +4,15 @@
 
 Observability on Mastra platform is a standalone hosted product for searchable traces, logs, and metrics across Mastra projects and deploys. Use it when you want observability without deploying Studio first or setting up local storage.
 
-Mastra can configure platform observability during project setup. The CLI provisions a platform project, writes the required environment variables, and registers observability exporters in your Mastra config.
+Use `mastra init` to configure platform observability while adding Mastra to an existing application, or configure it manually in a newly created Mastra project.
 
 ## Quickstart
 
-Choose the setup path that matches your project. New and existing projects can use the CLI to provision Observability automatically, while manual setup is available when you already manage platform projects and environment variables yourself.
+Choose the setup path that matches your project.
 
 ### New project
 
-Create a new Mastra project:
+Create a managed Mastra project. When prompted, opt into Mastra Platform Observability to configure it automatically:
 
 **npm**:
 
@@ -38,15 +38,7 @@ yarn create mastra
 bunx create-mastra
 ```
 
-When prompted, enable Mastra Observability:
-
-```bash
-Enable Mastra Observability? (will open auth flow)
-
-> Yes
-```
-
-The CLI authenticates with Mastra platform, creates a platform project, writes the required environment variables, and configures the observability exporters.
+When you select observability, the create command authenticates with Mastra Platform, provisions a platform project, and writes the credentials to your project. If you skip platform setup or use a prompt-free creation flow, follow the [manual setup](#manual-setup) steps instead.
 
 ### Existing non-Mastra projects
 

package/.docs/docs/mastra-platform/workspace.md

@@ -72,12 +72,12 @@ export const mastra = new Mastra({
 
 Every deploy that runs on a platform environment with a workspace receives these variables:
 
-| Variable                       | Contents                                                                                             |
-| ------------------------------ | ---------------------------------------------------------------------------------------------------- |
-| `MASTRA_PLATFORM_ACCESS_TOKEN` | Access token scoped to the deploy. Used by the workspace providers to authenticate.                  |
-| `MASTRA_PROJECT_ID`            | Project the deploy belongs to.                                                                       |
-| `MASTRA_ENVIRONMENT_ID`        | Environment the deploy belongs to. Selects which sandbox pool the platform uses.                     |
-| `MASTRA_PLATFORM_BUCKET_NAME`  | Bucket name attached to the environment. Selects which bucket `PlatformFilesystem` reads and writes. |
+| Variable                      | Contents                                                                                                                                                 |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MASTRA_PLATFORM_SECRET_KEY`  | Secret key scoped to the deploy. Used by the workspace providers to authenticate. `MASTRA_PLATFORM_ACCESS_TOKEN` is also injected as a deprecated alias. |
+| `MASTRA_PROJECT_ID`           | Project the deploy belongs to.                                                                                                                           |
+| `MASTRA_ENVIRONMENT_ID`       | Environment the deploy belongs to. Selects which sandbox pool the platform uses.                                                                         |
+| `MASTRA_PLATFORM_BUCKET_NAME` | Bucket name attached to the environment. Selects which bucket `PlatformFilesystem` reads and writes.                                                     |
 
 These names are reserved. If your project sets any of them explicitly, the platform-managed values take precedence.
 
@@ -86,7 +86,7 @@ These names are reserved. If your project sets any of them explicitly, the platf
 Reuse the same providers locally by putting the four variables in your `.env` file. Get the values from your project's Workspaces tab:
 
 ```bash
-MASTRA_PLATFORM_ACCESS_TOKEN=your-access-token
+MASTRA_PLATFORM_SECRET_KEY=your-secret-key
 MASTRA_PROJECT_ID=your-project-id
 MASTRA_ENVIRONMENT_ID=your-environment-id
 MASTRA_PLATFORM_BUCKET_NAME=your-bucket-name

package/.docs/docs/observability/feedback.md

@@ -127,6 +127,10 @@ const ratingsOverTime = await observability!.getFeedbackTimeSeries({
 
 See the [feedback reference](https://mastra.ai/reference/observability/feedback) for all fields, filters, return types, and percentile query parameters.
 
+## Export feedback to external platforms
+
+Feedback flows through the observability event bus, so exporters that support feedback forward it automatically. The [PostHog exporter](https://mastra.ai/reference/observability/tracing/exporters/posthog) sends feedback as native `$ai_feedback` events that appear on the linked trace in PostHog.
+
 ## Related
 
 - [Observability overview](https://mastra.ai/docs/observability/overview)

package/.docs/docs/server/auth/fga.md

@@ -254,6 +254,46 @@ class MyFGAProvider implements IFGAProvider {
 }
 ```
 
+## System actors
+
+Autonomous and scheduled agents run without an end user. Mark these calls with an actor signal so FGA can tell them apart from user requests:
+
+- `true` or `{ actorKind: 'system' }` identifies an anonymous system actor.
+- The object form can also carry `agentId`, `permissions`, and `scope` to identify and constrain the acting agent.
+
+By default, a trusted actor skips the user-centric `require()` check after a tenant-scope check. To enforce per-agent least privilege, implement the optional `requireActor` method on your provider. It receives the actor and the same `FGACheckParams` as `require`, and throws `FGADeniedError` to deny. When your provider doesn't implement `requireActor`, the trusted-actor bypass is preserved, so adding it is backward compatible.
+
+```typescript
+import { FGADeniedError } from '@mastra/core/auth/ee'
+import type { ActorSignal, FGACheckParams, IFGAProvider } from '@mastra/core/auth/ee'
+
+class MyFGAProvider implements IFGAProvider {
+  // ...check, require, filterAccessible...
+
+  async requireActor(actor: ActorSignal, params: FGACheckParams): Promise<void> {
+    const agentId = actor === true ? undefined : actor.agentId
+    // Resolve the agent's real grants from a trusted source keyed by agentId.
+    const granted = await this.grantsForAgent(agentId)
+    const required = Array.isArray(params.permission) ? params.permission : [params.permission]
+    if (!required.some(permission => granted.includes(permission))) {
+      throw new FGADeniedError(null, params.resource, params.permission)
+    }
+  }
+}
+```
+
+### Trust requirements
+
+The actor signal is trusted input, so construct it server-side:
+
+- Treat `actor` as a per-call signal. Durable workflows forward it when a run starts, but don't restore the initial actor on resume. Pass it explicitly on every trusted resume, or resolve a fresh actor through agent `defaultOptions`. Without a current actor, user authorization applies and a missing user fails closed.
+- Mastra strips `actor` from execution options handled by its built-in agent HTTP routes. Set it in server-side code, for example a scheduled job or a workflow, never from client input.
+- Establish tenant scope server-side. Built-in agent HTTP routes ignore a client-supplied `organizationId` in the request context, and the trusted-actor path requires an `organizationId` to be set.
+- Durable resume keeps its existing request-context recovery and merge behavior. This doesn't make a persisted actor trusted for a later workflow segment.
+- The tenant-scope check confirms that a trusted `organizationId` exists. It doesn't verify that `actor.agentId` belongs to that organization. When that relationship matters, verify it in `requireActor` using authoritative provider data.
+- Treat `actor.permissions` as a claim, not a grant. A provider that enforces least privilege resolves the agent's authoritative permissions from a trusted source, for example a manifest or your FGA backend keyed by `agentId`, rather than trusting the inline values.
+- Once a provider implements `requireActor`, errors from that method stop execution. Mastra doesn't fall back to organization-only authorization.
+
 ## Related
 
 - [Authentication overview](https://mastra.ai/docs/server/auth)

package/.docs/guides/getting-started/quickstart.md

@@ -2,21 +2,21 @@
 
 # Mastra Quickstart
 
-**For AI agents:** This page provides information for humans on how to run an interactive CLI to create a boilerplate Mastra project (with agents, workflows, and tools). You can run it non-interactively like so: `npm create mastra@latest <project-name> -- --default`. If you need to build a Mastra project from scratch (e.g. as a Node.js script printing to stdout), navigate to <https://mastra.ai/docs/getting-started/manual-install> instead.
+**For AI agents:** Create a new Mastra project non-interactively with `npm create mastra@latest <project-name> -- --llm <provider>`, replacing `<provider>` with `openai`, `anthropic`, `google`, or `xai`. For a minimal project without an agent or model provider, use `npm create mastra@latest <project-name> -- --empty`. To build a Mastra project from scratch, see the [manual installation guide](https://mastra.ai/docs/getting-started/manual-install).
 
-The `create mastra` CLI command is the quickest way to get started. It walks you through setup and creates example agents, workflows, and tools for you to run locally or adapt.
+The `create-mastra` CLI is the quickest way to start a Mastra project. It creates an agent harness with workspace tools, memory, task tracking, web access, schedules, storage, and observability.
 
-If you need more control over the setup, see the [manual installation guide](https://mastra.ai/docs/getting-started/manual-install). You can also use [`mastra init`](https://mastra.ai/reference/cli/mastra) for existing projects.
+For more control, see the [manual installation guide](https://mastra.ai/docs/getting-started/manual-install). To add Mastra to an existing project, use [`mastra init`](https://mastra.ai/reference/cli/mastra).
 
-> **📹 Watch:** Watch [Mastra AI agent course](https://www.youtube.com/watch?v=lCmf_qrGfGA) for a guided introduction to building agents with Mastra.
+> **📹 Watch:** Watch the [Mastra AI agent course](https://www.youtube.com/watch?v=lCmf_qrGfGA) for a guided introduction to building agents with Mastra.
 
 ## Before you begin
 
-- You'll need an API key from a supported [model provider](https://mastra.ai/models). If you don't have a preference, use [OpenAI](https://mastra.ai/models/providers/openai).
+You'll need an API key from OpenAI, Anthropic, Google Gemini, or xAI. You can skip entering it during setup and add it to `.env` later.
 
-## Initialize Mastra
+## Create the project
 
-You can run `create mastra` anywhere on your machine. Start the setup wizard:
+Run the interactive setup:
 
 **npm**:
 
@@ -42,32 +42,47 @@ yarn create mastra
 bunx create-mastra
 ```
 
-You'll be prompted for various configuration options, including your LLM provider and whether to enable [Observability](https://mastra.ai/docs/mastra-platform/observability) on the Mastra platform.
+The command asks for a project name, model provider, and optional API key. It then installs dependencies, installs Mastra skills for your coding assistants, and creates an initial Git commit when you aren't already inside a repository.
 
-The wizard creates a new directory for your project with a `src/mastra` folder containing an example weather agent and the following files:
+The generated `src/mastra` directory contains the Mastra entry point, agent, workspace tools, and supporting code. See the [project structure reference](https://mastra.ai/reference/project-structure) for the standard Mastra layout.
 
-- `index.ts`: Entry point for all Mastra-related code and configuration
-- `agents/weather-agent.ts`: A weather agent with a prompt that uses the tool
-- `tools/weather-tool.ts`: A tool to fetch weather for a given location
-- `workflows/weather-workflow.ts`: A workflow that runs the weather agent
-- `scorers/weather-scorer.ts`: A scorer to evaluate the weather agent's responses
+> **Tip:** Use `--template <template>` to start from a template, or `--empty` to create a minimal provider-free project. Use `--no-skills` or `--no-git` to skip automatic setup. See the [`create-mastra` reference](https://mastra.ai/reference/cli/create-mastra) for all flags.
 
-Depending on your choices, you'll also end up with [Mastra Skills](https://mastra.ai/docs/getting-started/build-with-ai) or the [MCP Docs Server](https://mastra.ai/docs/getting-started/build-with-ai) installed. Learn more about Mastra's [project structure](https://mastra.ai/reference/project-structure).
+## Test your agent
 
-> **Tip:** You can use [flags](https://mastra.ai/reference/cli/create-mastra) with `create mastra` like `--no-example` to skip the example weather agent or `--template` to start from a specific [template](https://mastra.ai/templates).
+Follow the terminal instructions to enter the project directory and start the development server:
 
-## Test your agent
+**npm**:
+
+```bash
+npm run dev
+```
+
+**pnpm**:
+
+```bash
+pnpm run dev
+```
+
+**Yarn**:
+
+```bash
+yarn dev
+```
+
+**Bun**:
 
-Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open Studio at [localhost:4111](http://localhost:4111).
+```bash
+bun run dev
+```
 
-Try asking about the weather. If your API key is set up correctly, you'll get a response in Studio.
+Open [Studio at localhost:4111](http://localhost:4111), select the agent, and send a message. Add the provider API key named in `.env.example` to an `.env` file if you skipped it during setup.
 
-[Studio](https://mastra.ai/docs/studio/overview) lets you rapidly build and prototype agents without needing to build a UI. Once you're ready, you can integrate your Mastra agent into your app using the guides below.
+[Studio](https://mastra.ai/docs/studio/overview) lets you build and test agents without creating a separate UI.
 
 ## Next steps
 
-- Integrate Mastra with your frontend framework: [Next.js](https://mastra.ai/guides/getting-started/next-js), [React](https://mastra.ai/guides/getting-started/vite-react), or [Astro](https://mastra.ai/guides/getting-started/astro)
-- Read more about [Mastra's features](https://mastra.ai/docs)
-- Learn how you can [build Mastra with AI](https://mastra.ai/docs/getting-started/build-with-ai)
-- Build an agent from scratch following one of our [guides](https://mastra.ai/guides)
-- Watch conceptual guides on our [YouTube channel](https://www.youtube.com/@mastra-ai) and [subscribe](https://www.youtube.com/@mastra-ai?sub_confirmation=1)
+- Integrate Mastra with [Next.js](https://mastra.ai/guides/getting-started/next-js), [React](https://mastra.ai/guides/getting-started/vite-react), or [Astro](https://mastra.ai/guides/getting-started/astro)
+- Learn how to [build Mastra with AI](https://mastra.ai/docs/getting-started/build-with-ai)
+- Build an agent from scratch with a [guide](https://mastra.ai/guides)
+- Watch the [Mastra YouTube channel](https://www.youtube.com/@mastra-ai)

package/.docs/guides/index.md

@@ -6,7 +6,7 @@ Mastra offers a variety of guides to help you build and work with Mastra, from b
 
 ## New project
 
-The `create mastra` command is the fastest way to build your first agent. It walks you through setup and generates an example agent you can run and adapt in [Studio](https://mastra.ai/docs/studio/overview) right away. You can always integrate Mastra with your framework or UI when you’re ready.
+The `npm create mastra@latest` command is the fastest way to build your first agent. It creates a ready-to-run agent harness that you can explore and adapt in [Studio](https://mastra.ai/docs/studio/overview) right away. You can always integrate Mastra with your framework or UI when you’re ready.
 
 - [Quickstart](https://mastra.ai/guides/getting-started/quickstart)
 

package/.docs/models/environment-variables.md

@@ -10,6 +10,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Abacus](https://mastra.ai/models/providers/abacus)                                            | `abacus/*`                 | `ABACUS_API_KEY`                                                                                      |
 | [abliteration.ai](https://mastra.ai/models/providers/abliteration-ai)                          | `abliteration-ai/*`        | `ABLIT_KEY`                                                                                           |
 | [AI-ROUTER](https://mastra.ai/models/providers/ai-router)                                      | `ai-router/*`              | `AI_ROUTER_API_KEY`                                                                                   |
+| [AKI.IO](https://mastra.ai/models/providers/aki-io)                                            | `aki-io/*`                 | `AKI_IO_API_KEY`                                                                                      |
 | [Alibaba](https://mastra.ai/models/providers/alibaba)                                          | `alibaba/*`                | `DASHSCOPE_API_KEY`                                                                                   |
 | [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)                               | `alibaba-cn/*`             | `DASHSCOPE_API_KEY`                                                                                   |
 | [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)                  | `alibaba-coding-plan/*`    | `ALIBABA_CODING_PLAN_API_KEY`                                                                         |
@@ -29,6 +30,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Chutes](https://mastra.ai/models/providers/chutes)                                            | `chutes/*`                 | `CHUTES_API_KEY`                                                                                      |
 | [Clarifai](https://mastra.ai/models/providers/clarifai)                                        | `clarifai/*`               | `CLARIFAI_PAT`                                                                                        |
 | [Claudinio](https://mastra.ai/models/providers/claudinio)                                      | `claudinio/*`              | `CLAUDINIO_API_KEY`                                                                                   |
+| [ClinePass](https://mastra.ai/models/providers/cline-pass)                                     | `cline-pass/*`             | `CLINE_API_KEY`                                                                                       |
 | [CloudFerro Sherlock](https://mastra.ai/models/providers/cloudferro-sherlock)                  | `cloudferro-sherlock/*`    | `CLOUDFERRO_SHERLOCK_API_KEY`                                                                         |
 | [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)              | `cloudflare-workers-ai/*`  | `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_API_KEY`                                                         |
 | [Cortecs](https://mastra.ai/models/providers/cortecs)                                          | `cortecs/*`                | `CORTECS_API_KEY`                                                                                     |

package/.docs/models/gateways/netlify.md

@@ -2,7 +2,7 @@
 
 # Netlify
 
-Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 70 models through Mastra's model router.
+Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 72 models through Mastra's model router.
 
 Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
 
@@ -62,6 +62,8 @@ ANTHROPIC_API_KEY=ant-...
 | `gemini/gemini-3.1-pro-preview`             |
 | `gemini/gemini-3.1-pro-preview-customtools` |
 | `gemini/gemini-3.5-flash`                   |
+| `gemini/gemini-3.5-flash-lite`              |
+| `gemini/gemini-3.6-flash`                   |
 | `gemini/gemini-flash-latest`                |
 | `gemini/gemini-flash-lite-latest`           |
 | `openai/chat-latest`                        |

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

@@ -2,7 +2,7 @@
 
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 337 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 340 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -116,6 +116,8 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.1-pro-preview`                            |
 | `google/gemini-3.1-pro-preview-customtools`                |
 | `google/gemini-3.5-flash`                                  |
+| `google/gemini-3.5-flash-lite`                             |
+| `google/gemini-3.6-flash`                                  |
 | `google/gemma-2-27b-it`                                    |
 | `google/gemma-3-12b-it`                                    |
 | `google/gemma-3-27b-it`                                    |
@@ -283,6 +285,8 @@ ANTHROPIC_API_KEY=ant-...
 | `perplexity/sonar-reasoning-pro`                           |
 | `poolside/laguna-m.1`                                      |
 | `poolside/laguna-m.1:free`                                 |
+| `poolside/laguna-s-2.1`                                    |
+| `poolside/laguna-s-2.1:free`                               |
 | `poolside/laguna-xs-2.1`                                   |
 | `poolside/laguna-xs-2.1:free`                              |
 | `qwen/qwen-2.5-72b-instruct`                               |
@@ -345,7 +349,6 @@ ANTHROPIC_API_KEY=ant-...
 | `tencent/hunyuan-a13b-instruct`                            |
 | `tencent/hy3`                                              |
 | `tencent/hy3-preview`                                      |
-| `tencent/hy3:free`                                         |
 | `thedrummer/cydonia-24b-v4.1`                              |
 | `thedrummer/rocinante-12b`                                 |
 | `thedrummer/skyfall-36b-v2`                                |

package/.docs/models/gateways/vercel.md

@@ -2,7 +2,7 @@
 
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 301 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 303 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -140,6 +140,8 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.1-flash-lite-preview`   |
 | `google/gemini-3.1-pro-preview`          |
 | `google/gemini-3.5-flash`                |
+| `google/gemini-3.5-flash-lite`           |
+| `google/gemini-3.6-flash`                |
 | `google/gemini-embedding-001`            |
 | `google/gemini-embedding-2`              |
 | `google/gemini-omni-flash-preview`       |

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 4852 models from 156 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4882 models from 158 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/aki-io.md

@@ -0,0 +1,78 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![AKI.IO logo](https://models.dev/logos/aki-io.svg)AKI.IO
+
+Access 6 AKI.IO models through Mastra's model router. Authentication is handled automatically using the `AKI_IO_API_KEY` environment variable.
+
+Learn more in the [AKI.IO documentation](https://aki.io/docs/).
+
+```bash
+AKI_IO_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: "aki-io/gemma4-26b"
+});
+
+// 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 [AKI.IO documentation](https://aki.io/docs/) for details.
+
+## Models
+
+| Model                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `aki-io/gemma4-26b`           | 256K    |       |           |       |       |       | $0.10      | $0.50       |
+| `aki-io/gpt-oss-120b`         | 128K    |       |           |       |       |       | $0.15      | $0.55       |
+| `aki-io/kimi-k2.7-code-1100b` | 262K    |       |           |       |       |       | $0.86      | $3          |
+| `aki-io/minimax-m2.5-230b`    | 197K    |       |           |       |       |       | $0.25      | $1          |
+| `aki-io/mistral4-119b`        | 262K    |       |           |       |       |       | $0.20      | $0.60       |
+| `aki-io/qwen3.6-35b`          | 256K    |       |           |       |       |       | $0.15      | $0.50       |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://aki.io/v1",
+    id: "aki-io/gemma4-26b",
+    apiKey: process.env.AKI_IO_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
+      ? "aki-io/qwen3.6-35b"
+      : "aki-io/gemma4-26b";
+  }
+});
+```

package/.docs/models/providers/cline-pass.md

@@ -0,0 +1,82 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![ClinePass logo](https://models.dev/logos/cline-pass.svg)ClinePass
+
+Access 10 ClinePass models through Mastra's model router. Authentication is handled automatically using the `CLINE_API_KEY` environment variable.
+
+Learn more in the [ClinePass documentation](https://docs.cline.bot/getting-started/clinepass).
+
+```bash
+CLINE_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: "cline-pass/cline-pass/deepseek-v4-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 [ClinePass documentation](https://docs.cline.bot/getting-started/clinepass) for details.
+
+## Models
+
+| Model                                     | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `cline-pass/cline-pass/deepseek-v4-flash` | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `cline-pass/cline-pass/deepseek-v4-pro`   | 1.0M    |       |           |       |       |       | $2         | $3          |
+| `cline-pass/cline-pass/glm-5.2`           | 1.0M    |       |           |       |       |       | $1         | $4          |
+| `cline-pass/cline-pass/kimi-k2.6`         | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `cline-pass/cline-pass/kimi-k2.7-code`    | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `cline-pass/cline-pass/mimo-v2.5`         | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `cline-pass/cline-pass/mimo-v2.5-pro`     | 1.0M    |       |           |       |       |       | $2         | $3          |
+| `cline-pass/cline-pass/minimax-m3`        | 512K    |       |           |       |       |       | $0.30      | $1          |
+| `cline-pass/cline-pass/qwen3.7-max`       | 1.0M    |       |           |       |       |       | $3         | $8          |
+| `cline-pass/cline-pass/qwen3.7-plus`      | 1.0M    |       |           |       |       |       | $0.40      | $2          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.cline.bot/api/v1",
+    id: "cline-pass/cline-pass/deepseek-v4-flash",
+    apiKey: process.env.CLINE_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
+      ? "cline-pass/cline-pass/qwen3.7-plus"
+      : "cline-pass/cline-pass/deepseek-v4-flash";
+  }
+});
+```

package/.docs/models/providers/deepseek.md

@@ -91,4 +91,6 @@ const response = await agent.generate("Hello!", {
 
 **thinking** (`{ type?: "adaptive" | "enabled" | "disabled" | undefined; } | undefined`)
 
-**reasoningEffort** (`"low" | "medium" | "high" | "xhigh" | "max" | undefined`)
+**reasoningEffort** (`"low" | "medium" | "high" | "xhigh" | "max" | undefined`)
+
+**strictJsonSchema** (`boolean | undefined`)

package/.docs/models/providers/google.md

@@ -2,7 +2,7 @@
 
 # ![Google logo](https://models.dev/logos/google.svg)Google
 
-Access 19 Google models through Mastra's model router. Authentication is handled automatically using one of the following environment variables: `GOOGLE_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`.
+Access 21 Google models through Mastra's model router. Authentication is handled automatically using one of the following environment variables: `GOOGLE_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`.
 
 Learn more in the [Google documentation](https://ai.google.dev/gemini-api/docs/models).
 
@@ -48,6 +48,8 @@ for await (const chunk of stream) {
 | `google/gemini-3.1-pro-preview`             | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `google/gemini-3.1-pro-preview-customtools` | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `google/gemini-3.5-flash`                   | 1.0M    |       |           |       |       |       | $2         | $9          |
+| `google/gemini-3.5-flash-lite`              | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `google/gemini-3.6-flash`                   | 1.0M    |       |           |       |       |       | $2         | $8          |
 | `google/gemini-embedding-001`               | 2K      |       |           |       |       |       | $0.15      | —           |
 | `google/gemini-flash-latest`                | 1.0M    |       |           |       |       |       | $2         | $9          |
 | `google/gemini-flash-lite-latest`           | 1.0M    |       |           |       |       |       | $0.25      | $2          |
@@ -122,7 +124,7 @@ const response = await agent.generate("Hello!", {
 
 **mediaResolution** (`"MEDIA_RESOLUTION_UNSPECIFIED" | "MEDIA_RESOLUTION_LOW" | "MEDIA_RESOLUTION_MEDIUM" | "MEDIA_RESOLUTION_HIGH" | undefined`)
 
-**imageConfig** (`{ aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | "1:8" | "8:1" | "1:4" | "4:1" | undefined; imageSize?: "1K" | "2K" | "4K" | "512" | undefined; } | undefined`)
+**imageConfig** (`{ aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | "1:8" | "8:1" | "1:4" | "4:1" | undefined; imageSize?: "1K" | "2K" | "4K" | "512" | undefined; personGeneration?: "PERSON_GENERATION_UNSPECIFIED" | ... 3 more ... | undefined; prominentPeople?: "PROMINENT_PEOPLE_UNSPEC...`)
 
 **retrievalConfig** (`{ latLng?: { latitude: number; longitude: number; } | undefined; } | undefined`)
 

package/.docs/models/providers/inferx.md

@@ -37,11 +37,11 @@ for await (const chunk of stream) {
 | Model                                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `inferx/google/gemma-4-31b-it-fp8`    | 262K    |       |           |       |       |       | —          | —           |
-| `inferx/qwen/qwen3-coder-next-fp8`    | 256K    |       |           |       |       |       | —          | —           |
-| `inferx/qwen/qwen3-coder-next-fp8-1m` | 1.0M    |       |           |       |       |       | —          | —           |
 | `inferx/qwen/qwen3.5-122b-a10b-nvfp4` | 256K    |       |           |       |       |       | —          | —           |
 | `inferx/qwen/qwen3.6-27b-fp8`         | 262K    |       |           |       |       |       | —          | —           |
 | `inferx/qwen/qwen3.6-35b-a3b-fp8`     | 262K    |       |           |       |       |       | —          | —           |
+| `inferx/qwen3-coder-next-fp8`         | 256K    |       |           |       |       |       | —          | —           |
+| `inferx/qwen3-coder-next-fp8-1m`      | 1.0M    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -71,7 +71,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "inferx/qwen/qwen3.6-35b-a3b-fp8"
+      ? "inferx/qwen3-coder-next-fp8-1m"
       : "inferx/google/gemma-4-31b-it-fp8";
   }
 });