@mastra/mcp-docs-server 1.2.4-alpha.1 → 1.2.4-alpha.6

package/.docs/models/providers/requesty.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Requesty logo](https://models.dev/logos/requesty.svg)Requesty
 
 Access 38 Requesty models through Mastra's model router. Authentication is handled automatically using the `REQUESTY_API_KEY` environment variable.

package/.docs/models/providers/routing-run.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![routing.run logo](https://models.dev/logos/routing-run.svg)routing.run
 
 Access 26 routing.run models through Mastra's model router. Authentication is handled automatically using the `ROUTING_RUN_API_KEY` environment variable.

package/.docs/models/providers/sakana.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Sakana AI logo](https://models.dev/logos/sakana.svg)Sakana AI
 
 Access 3 Sakana AI models through Mastra's model router. Authentication is handled automatically using the `SAKANA_API_KEY` environment variable.

package/.docs/models/providers/sarvam.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Sarvam AI logo](https://models.dev/logos/sarvam.svg)Sarvam AI
 
 Access 2 Sarvam AI models through Mastra's model router. Authentication is handled automatically using the `SARVAM_API_KEY` environment variable.

package/.docs/models/providers/scaleway.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Scaleway logo](https://models.dev/logos/scaleway.svg)Scaleway
 
 Access 16 Scaleway models through Mastra's model router. Authentication is handled automatically using the `SCALEWAY_API_KEY` environment variable.

package/.docs/models/providers/siliconflow-cn.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![SiliconFlow (China) logo](https://models.dev/logos/siliconflow-cn.svg)SiliconFlow (China)
 
 Access 47 SiliconFlow (China) models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_CN_API_KEY` environment variable.

package/.docs/models/providers/siliconflow.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![SiliconFlow logo](https://models.dev/logos/siliconflow.svg)SiliconFlow
 
 Access 49 SiliconFlow models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_API_KEY` environment variable.

package/.docs/models/providers/snowflake-cortex.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Snowflake Cortex logo](https://models.dev/logos/snowflake-cortex.svg)Snowflake Cortex
 
 Access 18 Snowflake Cortex models through Mastra's model router. Authentication is handled automatically using the `SNOWFLAKE_CORTEX_PAT` environment variable. Configure `SNOWFLAKE_ACCOUNT` as well.

package/.docs/models/providers/stackit.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![STACKIT logo](https://models.dev/logos/stackit.svg)STACKIT
 
 Access 8 STACKIT models through Mastra's model router. Authentication is handled automatically using the `STACKIT_API_KEY` environment variable.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![StepFun AI logo](https://models.dev/logos/stepfun-ai.svg)StepFun AI
 
 Access 2 StepFun AI models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![StepFun logo](https://models.dev/logos/stepfun.svg)StepFun
 
 Access 5 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.

package/.docs/models/providers/subconscious.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Subconscious logo](https://models.dev/logos/subconscious.svg)Subconscious
 
 Access 1 Subconscious model through Mastra's model router. Authentication is handled automatically using the `SUBCONSCIOUS_API_KEY` environment variable.

package/.docs/models/providers/submodel.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![submodel logo](https://models.dev/logos/submodel.svg)submodel
 
 Access 9 submodel models through Mastra's model router. Authentication is handled automatically using the `SUBMODEL_INSTAGEN_ACCESS_KEY` environment variable.

package/.docs/models/providers/synthetic.md

@@ -1,6 +1,8 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Synthetic logo](https://models.dev/logos/synthetic.svg)Synthetic
 
-Access 10 Synthetic models through Mastra's model router. Authentication is handled automatically using the `SYNTHETIC_API_KEY` environment variable.
+Access 7 Synthetic models through Mastra's model router. Authentication is handled automatically using the `SYNTHETIC_API_KEY` environment variable.
 
 Learn more in the [Synthetic documentation](https://synthetic.new/pricing).
 
@@ -35,14 +37,11 @@ for await (const chunk of stream) {
 | Model                                                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `synthetic/hf:MiniMaxAI/MiniMax-M3`                           | 524K    |       |           |       |       |       | $0.60      | $1          |
-| `synthetic/hf:moonshotai/Kimi-K2.6`                           | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `synthetic/hf:moonshotai/Kimi-K2.7-Code`                      | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `synthetic/hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4` | 262K    |       |           |       |       |       | $0.30      | $1          |
 | `synthetic/hf:openai/gpt-oss-120b`                            | 131K    |       |           |       |       |       | $0.10      | $0.10       |
-| `synthetic/hf:Qwen/Qwen3.5-397B-A17B`                         | 262K    |       |           |       |       |       | $0.60      | $4          |
 | `synthetic/hf:Qwen/Qwen3.6-27B`                               | 262K    |       |           |       |       |       | $0.45      | $4          |
-| `synthetic/hf:zai-org/GLM-4.7`                                | 203K    |       |           |       |       |       | $0.45      | $2          |
 | `synthetic/hf:zai-org/GLM-4.7-Flash`                          | 197K    |       |           |       |       |       | $0.10      | $0.50       |
-| `synthetic/hf:zai-org/GLM-5.1`                                | 197K    |       |           |       |       |       | $1         | $3          |
 | `synthetic/hf:zai-org/GLM-5.2`                                | 524K    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration

package/.docs/models/providers/tencent-coding-plan.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Tencent Coding Plan (China) logo](https://models.dev/logos/tencent-coding-plan.svg)Tencent Coding Plan (China)
 
 Access 8 Tencent Coding Plan (China) models through Mastra's model router. Authentication is handled automatically using the `TENCENT_CODING_PLAN_API_KEY` environment variable.

package/.docs/models/providers/tencent-token-plan.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Tencent Token Plan logo](https://models.dev/logos/tencent-token-plan.svg)Tencent Token Plan
 
 Access 1 Tencent Token Plan model through Mastra's model router. Authentication is handled automatically using the `TENCENT_TOKEN_PLAN_API_KEY` environment variable.

package/.docs/models/providers/tencent-tokenhub.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Tencent TokenHub logo](https://models.dev/logos/tencent-tokenhub.svg)Tencent TokenHub
 
 Access 1 Tencent TokenHub model through Mastra's model router. Authentication is handled automatically using the `TENCENT_TOKENHUB_API_KEY` environment variable.

package/.docs/models/providers/the-grid-ai.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![The Grid AI logo](https://models.dev/logos/the-grid-ai.svg)The Grid AI
 
 Access 9 The Grid AI models through Mastra's model router. Authentication is handled automatically using the `THEGRIDAI_API_KEY` environment variable.

package/.docs/models/providers/tinfoil.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Tinfoil logo](https://models.dev/logos/tinfoil.svg)Tinfoil
 
 Access 7 Tinfoil models through Mastra's model router. Authentication is handled automatically using the `TINFOIL_API_KEY` environment variable.

package/.docs/models/providers/togetherai.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Together AI logo](https://models.dev/logos/togetherai.svg)Together AI
 
 Access 25 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.

package/.docs/models/providers/umans-ai-coding-plan.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Umans AI Coding Plan logo](https://models.dev/logos/umans-ai-coding-plan.svg)Umans AI Coding Plan
 
 Access 6 Umans AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_CODING_PLAN_API_KEY` environment variable.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Umans AI logo](https://models.dev/logos/umans-ai.svg)Umans AI
 
 Access 5 Umans AI models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_API_KEY` environment variable.

package/.docs/models/providers/upstage.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Upstage logo](https://models.dev/logos/upstage.svg)Upstage
 
 Access 3 Upstage models through Mastra's model router. Authentication is handled automatically using the `UPSTAGE_API_KEY` environment variable.

package/.docs/models/providers/venice.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Venice AI logo](https://models.dev/logos/venice.svg)Venice AI
 
 Access 25 Venice AI models through Mastra's model router. Authentication is handled automatically using the `VENICE_API_KEY` environment variable.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Vivgrid logo](https://models.dev/logos/vivgrid.svg)Vivgrid
 
 Access 13 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.

package/.docs/models/providers/vultr.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Vultr logo](https://models.dev/logos/vultr.svg)Vultr
 
 Access 7 Vultr models through Mastra's model router. Authentication is handled automatically using the `VULTR_API_KEY` environment variable.

package/.docs/models/providers/wafer.ai.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Wafer logo](https://models.dev/logos/wafer.ai.svg)Wafer
 
 Access 8 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.

package/.docs/models/providers/wandb.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
 
 Access 18 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![xAI logo](https://models.dev/logos/xai.svg)xAI
 
 Access 8 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.

package/.docs/models/providers/xiaomi-token-plan-ams.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Xiaomi Token Plan (Europe) logo](https://models.dev/logos/xiaomi-token-plan-ams.svg)Xiaomi Token Plan (Europe)
 
 Access 6 Xiaomi Token Plan (Europe) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.

package/.docs/models/providers/xiaomi-token-plan-cn.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Xiaomi Token Plan (China) logo](https://models.dev/logos/xiaomi-token-plan-cn.svg)Xiaomi Token Plan (China)
 
 Access 6 Xiaomi Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.

package/.docs/models/providers/xiaomi-token-plan-sgp.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Xiaomi Token Plan (Singapore) logo](https://models.dev/logos/xiaomi-token-plan-sgp.svg)Xiaomi Token Plan (Singapore)
 
 Access 6 Xiaomi Token Plan (Singapore) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.

package/.docs/models/providers/xiaomi.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Xiaomi logo](https://models.dev/logos/xiaomi.svg)Xiaomi
 
 Access 3 Xiaomi models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.

package/.docs/models/providers/xpersona.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Xpersona logo](https://models.dev/logos/xpersona.svg)Xpersona
 
 Access 2 Xpersona models through Mastra's model router. Authentication is handled automatically using the `XPERSONA_API_KEY` environment variable.

package/.docs/models/providers/zai-coding-plan.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Z.AI Coding Plan logo](https://models.dev/logos/zai-coding-plan.svg)Z.AI Coding Plan
 
 Access 6 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.

package/.docs/models/providers/zai.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Z.AI logo](https://models.dev/logos/zai.svg)Z.AI
 
 Access 14 Z.AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.

package/.docs/models/providers/zeldoc.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Zeldoc logo](https://models.dev/logos/zeldoc.svg)Zeldoc
 
 Access 1 Zeldoc model through Mastra's model router. Authentication is handled automatically using the `ZELDOC_API_KEY` environment variable.

package/.docs/models/providers/zenmux.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![ZenMux logo](https://models.dev/logos/zenmux.svg)ZenMux
 
 Access 112 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Zhipu AI Coding Plan logo](https://models.dev/logos/zhipuai-coding-plan.svg)Zhipu AI Coding Plan
 
 Access 7 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.

package/.docs/models/providers/zhipuai.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # ![Zhipu AI logo](https://models.dev/logos/zhipuai.svg)Zhipu AI
 
 Access 13 Zhipu AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
@@ -44,7 +46,7 @@ for await (const chunk of stream) {
 | `zhipuai/glm-4.7-flash`  | 200K    |       |           |       |       |       | —          | —           |
 | `zhipuai/glm-4.7-flashx` | 200K    |       |           |       |       |       | $0.07      | $0.40       |
 | `zhipuai/glm-5`          | 205K    |       |           |       |       |       | $1         | $3          |
-| `zhipuai/glm-5.1`        | 200K    |       |           |       |       |       | $6         | $24         |
+| `zhipuai/glm-5.1`        | 200K    |       |           |       |       |       | $1         | $4          |
 | `zhipuai/glm-5.2`        | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `zhipuai/glm-5v-turbo`   | 200K    |       |           |       |       |       | $5         | $22         |
 

package/.docs/models/providers.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Model Providers
 
 Direct access to individual AI model providers. Each provider offers unique models with specific capabilities and pricing.

package/.docs/reference/acp/acp-agent.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # AcpAgent class
 
 The `AcpAgent` class wraps an Agent Client Protocol (ACP)-compatible coding agent as a Mastra subagent. Use it when a parent Mastra agent should delegate repository inspection, code edits, or other ACP-backed tasks to a named subagent.

package/.docs/reference/acp/create-acp-tool.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # createACPTool()
 
 The `createACPTool()` function creates a Mastra tool that sends a `task` string to an Agent Client Protocol (ACP)-compatible coding agent and returns the final ACP response as `output`. Use it when a parent agent should decide when to call the ACP agent as a tool.

package/.docs/reference/agent-controller/agent-controller-class.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # AgentController class
 
 > **Beta:** The `AgentController` feature is in beta stage and subject to breaking changes in minor versions until it graduates from its beta status.

package/.docs/reference/agent-controller/session.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Session class
 
 > **Beta:** The `AgentController` feature is in beta stage and subject to breaking changes in minor versions until it graduates from its beta status.

package/.docs/reference/agents/agent.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Agent class
 
 The `Agent` class is the foundation for creating AI agents in Mastra. It provides methods for generating responses, streaming interactions, and handling voice capabilities.
@@ -215,7 +217,7 @@ agent.sendMessage('Continue with the next step.', {
 })
 ```
 
-Returns `{ accepted: Promise<SendAgentSignalAccepted>, signal: CreatedAgentSignal, persisted?: Promise<void> }`. `accepted` resolves at decision-time, once Mastra decides what to do with the message: `{ action: 'wake', runId, output }` when this process runs the agent (it started or won the lease to start the run), `{ action: 'deliver', runId }` when the message is forwarded onto an existing run (including when this process loses a cross-process wake race), or `{ action: 'persist' }` / `{ action: 'discard' }` when nothing ran. `runId` is the authoritative id of the run that handled the message and is present only on `wake` and `deliver`; for `persist`/`discard` use `result.signal.id` to correlate the stored message. `accepted` resolves for routing — a generation error on a `wake` run surfaces through `output.consumeStream()` — and rejects only when the message could not be routed or started at all (e.g. a misconfigured agent). `persisted` is only present for `persist` behavior and resolves when Mastra finishes writing the message to memory. On the `wake` action, `output` is the agent stream for in-process consumption.
+Returns `{ accepted: Promise<SendAgentSignalAccepted>, signal: CreatedAgentSignal, persisted?: Promise<void> }`. `accepted` resolves at decision-time, once Mastra decides what to do with the message: `{ action: 'wake', runId, output }` when this process runs the agent (it started or won the lease to start the run), `{ action: 'deliver', runId }` when the message is forwarded onto an existing run (including when this process loses a cross-process wake race), or `{ action: 'persist' }` / `{ action: 'discard' }` when nothing ran. `runId` is the authoritative id of the run that handled the message and is present only on `wake` and `deliver`; for `persist`/`discard` use `result.signal.id` to correlate the stored message. `accepted` resolves for routing — a generation error on a `wake` run surfaces through `output.consumeStream()` — and rejects only when the message couldn't be routed or started at all (e.g. a misconfigured agent). `persisted` is only present for `persist` behavior and resolves when Mastra finishes writing the message to memory. On the `wake` action, `output` is the agent stream for in-process consumption.
 
 ### `queueMessage(message, options)`
 
@@ -258,7 +260,7 @@ Sends a signal to an active run or memory thread.
 
 **options.ifIdle.attributes** (`Record<string, string | number | boolean>`): Attributes merged into the signal when Mastra accepts it while the target thread is idle.
 
-Returns `{ accepted: Promise<SendAgentSignalAccepted>, signal: CreatedAgentSignal, persisted?: Promise<void> }`. `accepted` resolves at decision-time, once Mastra decides what to do with the signal: `{ action: 'wake', runId, output }` when this process runs the agent (it started or won the lease to start the run), `{ action: 'deliver', runId }` when the signal is forwarded onto an existing run (including when this process loses a cross-process wake race), or `{ action: 'persist' }` / `{ action: 'discard' }` when nothing ran. `action` mirrors the winning `behavior` from `ifActive`/`ifIdle`. `runId` is the authoritative id of the run that handled the signal and is present only on `wake` and `deliver`; for `persist`/`discard` use `result.signal.id` to correlate the stored signal. `accepted` resolves for routing — a generation error on a `wake` run surfaces through `output.consumeStream()` — and rejects only when the signal could not be routed or started at all (e.g. a misconfigured agent). `persisted` is only present for `persist` behavior and resolves when Mastra finishes writing the signal to memory. On the `wake` action, `output` is the agent stream for in-process consumption.
+Returns `{ accepted: Promise<SendAgentSignalAccepted>, signal: CreatedAgentSignal, persisted?: Promise<void> }`. `accepted` resolves at decision-time, once Mastra decides what to do with the signal: `{ action: 'wake', runId, output }` when this process runs the agent (it started or won the lease to start the run), `{ action: 'deliver', runId }` when the signal is forwarded onto an existing run (including when this process loses a cross-process wake race), or `{ action: 'persist' }` / `{ action: 'discard' }` when nothing ran. `action` mirrors the winning `behavior` from `ifActive`/`ifIdle`. `runId` is the authoritative id of the run that handled the signal and is present only on `wake` and `deliver`; for `persist`/`discard` use `result.signal.id` to correlate the stored signal. `accepted` resolves for routing — a generation error on a `wake` run surfaces through `output.consumeStream()` — and rejects only when the signal couldn't be routed or started at all (e.g. a misconfigured agent). `persisted` is only present for `persist` behavior and resolves when Mastra finishes writing the signal to memory. On the `wake` action, `output` is the agent stream for in-process consumption.
 
 In serverless handlers, await `accepted` and pass the `wake` output to your platform's `waitUntil` equivalent so the winning process can drain the stream after the HTTP response returns.
 
@@ -423,9 +425,9 @@ Returns an `AgentThreadSubscription` object with these members:
 
 ## Constructor parameters
 
-**id** (`string`): Unique identifier for the agent. Defaults to \`name\` if not provided.
+**id** (`string`): Unique identifier for the agent.
 
-**name** (`string`): Display name for the agent. Used as the identifier if \`id\` is not provided.
+**name** (`string`): Display name for the agent.
 
 **description** (`string`): Optional description of the agent's purpose and capabilities.
 
@@ -477,6 +479,34 @@ Returns an `AgentThreadSubscription` object with these members:
 
 **editor** (`false | { instructions?: boolean; tools?: boolean | { description?: boolean } }`): Controls which fields the editor can override for this code-defined agent. Omit to allow editing instructions and tools. See Editor overrides below.
 
+## `generate()` memory options
+
+Pass `memory` when you call `agent.generate()` to choose which conversation thread the run should read from and write to. The common shape is `memory: { resource: string, thread: string }`, where `resource` identifies the owner and `thread` identifies the conversation. See [Threads and resources](https://mastra.ai/docs/memory/storage) for the concept model.
+
+```typescript
+const response = await agent.generate('What did we decide about retries?', {
+  memory: {
+    resource: 'user-123',
+    thread: 'support-thread-456',
+  },
+})
+```
+
+Use a thread object when you need to create or update thread metadata during the call:
+
+```typescript
+const response = await agent.generate('Continue the support conversation.', {
+  memory: {
+    resource: 'user-123',
+    thread: {
+      id: 'support-thread-456',
+      title: 'Billing support',
+      metadata: { category: 'billing' },
+    },
+  },
+})
+```
+
 ## Tool hooks
 
 Use `hooks` to run logic around every tool call the agent makes, including assigned tools, memory tools, toolsets, client tools, and workspace tools.
@@ -485,6 +515,7 @@ Use `hooks` to run logic around every tool call the agent makes, including assig
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'support-agent',
   name: 'support-agent',
   instructions: 'Help users with their questions.',
   model: 'openai/gpt-5.5',

package/.docs/reference/agents/channels.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Channels
 
 **Added in:** `@mastra/core@1.22.0`
@@ -63,6 +65,7 @@ import { createDiscordAdapter } from '@chat-adapter/discord'
 import { createSlackAdapter } from '@chat-adapter/slack'
 
 const agent = new Agent({
+  id: 'example',
   name: 'Example',
   instructions: '...',
   model: 'openai/gpt-5.5',
@@ -118,6 +121,7 @@ import { Agent } from '@mastra/core/agent'
 import { createSlackAdapter } from '@chat-adapter/slack'
 
 const agent = new Agent({
+  id: 'streaming-agent',
   name: 'Streaming Agent',
   instructions: '...',
   model: 'openai/gpt-5.5',
@@ -145,6 +149,7 @@ import { defaultTypingStatus } from '@mastra/core/channels'
 import { createDiscordAdapter } from '@chat-adapter/discord'
 
 const agent = new Agent({
+  id: 'custom-typing-agent',
   name: 'Custom Typing Agent',
   instructions: '...',
   model: 'openai/gpt-5.5',
@@ -177,6 +182,7 @@ import { Agent } from '@mastra/core/agent'
 import { createSlackAdapter } from '@chat-adapter/slack'
 
 const agent = new Agent({
+  id: 'custom-handler-agent',
   name: 'Custom Handler Agent',
   instructions: '...',
   model: 'openai/gpt-5.5',
@@ -222,6 +228,7 @@ import { Agent } from '@mastra/core/agent'
 import { createSlackAdapter } from '@chat-adapter/slack'
 
 const agent = new Agent({
+  id: 'sso-agent',
   name: 'SSO Agent',
   instructions: '...',
   model: 'openai/gpt-5.5',

package/.docs/reference/agents/createSkill.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # `createSkill()`
 
 Creates an inline skill that can be passed directly to an agent's `skills` config without a filesystem or workspace.

package/.docs/reference/agents/durable-agent.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # DurableAgent
 
 `DurableAgent` wraps an existing [`Agent`](https://mastra.ai/reference/agents/agent) with durable execution and resumable streams. It runs the agentic loop so that a client can disconnect and reconnect without missing events, and it streams those events over [PubSub](https://mastra.ai/docs/server/pubsub). Use it when a run must outlive a single request or survive a dropped connection.