@mastra/mcp-docs-server 1.2.17-alpha.7 → 1.2.17

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

@@ -154,7 +154,7 @@ Return a fully custom `Client` implementation when you need to change the standa
 
 ## Related
 
-- [Agent Client Protocol docs](https://mastra.ai/docs/agents/acp)
+- [Agent Client Protocol docs](https://mastra.ai/docs/connections/acp)
 - [AcpAgent class reference](https://mastra.ai/reference/acp/acp-agent)
 - [Tool reference](https://mastra.ai/reference/tools/create-tool)
 - [Agent Client Protocol introduction](https://agentclientprotocol.com/overview/introduction)

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

@@ -497,5 +497,5 @@ await controller.stopIntervals()
 - [AgentController guide](https://mastra.ai/docs/harness/agent-controller)
 - [Session reference](https://mastra.ai/reference/agent-controller/session)
 - [Agents](https://mastra.ai/docs/agents/overview)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
-- [Channels](https://mastra.ai/docs/capabilities/channels)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)
+- [Channels](https://mastra.ai/docs/channels)

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

@@ -387,7 +387,7 @@ const result = await agent.sendNotificationSignal(
 
 Returns `{ record: NotificationRecord, decision: NotificationDeliveryDecision, runId?: string, signal?: CreatedAgentSignal, persisted?: Promise<void>, accepted?: Promise<SendAgentSignalAccepted> }`. `record` is the stored inbox record. `decision` is the delivery-policy result. `signal` and `runId` are present when ingress emits a signal immediately, including the immediate summary emitted for active high-priority notifications. `persisted` is present when the emitted signal is persisted without waking an idle thread. `accepted` is present when a signal is emitted and resolves at decision-time, once Mastra decides what to do with it: `{ 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, or `{ action: 'persist' }` / `{ action: 'discard' }` when nothing ran. `runId` on the accepted result is present only on `wake` and `deliver`. On the `wake` action, `output` is the agent stream for in-process consumption.
 
-Default delivery is priority-aware. `urgent` notifications deliver immediately. `high` notifications deliver immediately when the thread is idle. When the thread is active, Mastra emits a summary immediately and keeps `deliverAt` for later full delivery when the thread is idle. `medium` notifications deliver immediately when idle and batch into summaries when active. `low` notifications batch into summaries in both active and idle threads. Idle low-priority summaries reach subscribers without waking the model loop. For the full flow, visit [Signals](https://mastra.ai/docs/long-running-agents/signals).
+Default delivery is priority-aware. `urgent` notifications deliver immediately. `high` notifications deliver immediately when the thread is idle. When the thread is active, Mastra emits a summary immediately and keeps `deliverAt` for later full delivery when the thread is idle. `medium` notifications deliver immediately when idle and batch into summaries when active. `low` notifications batch into summaries in both active and idle threads. Idle low-priority summaries reach subscribers without waking the model loop. For the full flow, visit [Signals](https://mastra.ai/docs/harness/signals).
 
 Configure `notifications.deliveryPolicy` on the agent when some notifications should wait for a different dispatch window or summary rollup:
 
@@ -564,7 +564,7 @@ When you register the [`MastraEditor`](https://mastra.ai/reference/editor/mastra
 
 **editor** (`false | { instructions?: boolean; tools?: boolean | { description?: boolean } }`): Omit to allow editing instructions and tools. Set to false to lock the agent. Set instructions: true to allow instruction edits. Set tools: true to allow tool membership and description edits, or tools: { description: true } to allow only description edits.
 
-The agent's `id`, `name`, and `model` always come from code and can't be overridden through Editor. See [Editor](https://mastra.ai/docs/editor/overview) for usage.
+The agent's `id`, `name`, and `model` always come from code and can't be overridden through Editor. See [Editor](https://mastra.ai/docs/studio/editor) for usage.
 
 ## Returns
 

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

@@ -4,7 +4,7 @@
 
 **Added in:** `@mastra/core@1.22.0`
 
-Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels overview](https://mastra.ai/docs/capabilities/channels) for concepts and platform setup instructions.
+Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels overview](https://mastra.ai/docs/channels) for concepts and platform setup instructions.
 
 ## Usage example
 
@@ -382,6 +382,6 @@ type InlineLinkEntry =
 
 ## Related
 
-- [Channels overview](https://mastra.ai/docs/capabilities/channels): Concepts, quickstart, and platform setup
+- [Channels overview](https://mastra.ai/docs/channels): Concepts, quickstart, and platform setup
 - [Agent class](https://mastra.ai/reference/agents/agent): Constructor parameters and methods
 - [Chat SDK adapters](https://chat-sdk.dev/adapters): Adapter configuration and platform setup

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

@@ -74,7 +74,7 @@ createSkill({ name: '', description: 'test', instructions: 'test' })
 
 ## Related
 
-- [Agent skills](https://mastra.ai/docs/agents/skills)
-- [Workspace skills](https://mastra.ai/docs/workspace/skills)
+- [Agent skills](https://mastra.ai/docs/skills)
+- [Workspace skills](https://mastra.ai/docs/sandbox/skills)
 - [`.getSkill()` reference](https://mastra.ai/reference/agents/getSkill)
 - [`.listSkills()` reference](https://mastra.ai/reference/agents/listSkills)

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

@@ -338,7 +338,7 @@ Returns: [`Promise<DurableAgentStreamResult>`](#durableagentstreamresult)
 
 **onSuspended** (`(data: AgentSuspendedEventData) => void | Promise<void>`): Called when the run suspends, for example for tool approval.
 
-**onAbort** (`AgentExecutionOptions['onAbort']`): Called when the run is aborted via abortSignal or result.abort().
+**onAbort** (`AgentExecutionOptions['onAbort']`): Called when the run is aborted via abortSignal or result.abort(). Receives the steps completed before the abort and, in text, the assistant text streamed so far.
 
 **onIterationComplete** (`AgentExecutionOptions['onIterationComplete']`): Called after every agentic-loop iteration with the latest messageList, finishReason, and isFinal flag. Observation-only on durable agents: returning continue: false or feedback does not influence the loop.
 

package/.docs/reference/agents/generate.md

@@ -78,7 +78,7 @@ const result = await agent.generate('message for agent')
 
 **options.onError** (`({ error }: { error: Error | string }) => Promise<void> | void`): Callback function called when an error occurs during generation.
 
-**options.onAbort** (`(event: any) => Promise<void> | void`): Callback function called when the generation is aborted.
+**options.onAbort** (`(event: { steps: any[]; text?: string }) => Promise<void> | void`): Callback function called when the generation is aborted. steps contains the steps that completed before the abort, and text contains the assistant text generated so far for the step that was in flight.
 
 **options.activeTools** (`Array<keyof ToolSet> | undefined`): Array of tool names that should be active during execution. If undefined, all available tools are active.
 
@@ -164,6 +164,8 @@ const result = await agent.generate('message for agent')
 
 **options.modelSettings.frequencyPenalty** (`number`): Penalty for token frequency (-2 to 2). Reduces repetition of frequent tokens.
 
+**options.modelSettings.timeout** (`object`): Time-based execution budget for the run. Accepts totalMs, the maximum duration of the entire agent run across every loop iteration, tool call and retry, and stepMs, the maximum duration of a single model call including the time spent consuming its stream. Exceeding either budget fails with a MastraTimeoutError. A totalMs timeout ends the run and does not try fallback models, because it is a hard deadline for the whole run. A stepMs timeout is not retried against the same model but does advance to the next entry in models when fallback models are configured.
+
 **options.modelSettings.stopSequences** (`string[]`): Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.
 
 **options.toolChoice** (`'auto' | 'none' | 'required' | { type: 'tool'; toolName: string }`): Controls how tools are selected during generation.

package/.docs/reference/agents/getSkill.md

@@ -55,6 +55,6 @@ When both agent-level skills and workspace skills are configured, `.getSkill()`
 
 ## Related
 
-- [Agent skills](https://mastra.ai/docs/agents/skills)
+- [Agent skills](https://mastra.ai/docs/skills)
 - [`.listSkills()` reference](https://mastra.ai/reference/agents/listSkills)
 - [`createSkill()` reference](https://mastra.ai/reference/agents/createSkill)

package/.docs/reference/agents/listSkills.md

@@ -50,6 +50,6 @@ When both agent-level skills and workspace skills are configured, `.listSkills()
 
 ## Related
 
-- [Agent skills](https://mastra.ai/docs/agents/skills)
+- [Agent skills](https://mastra.ai/docs/skills)
 - [`.getSkill()` reference](https://mastra.ai/reference/agents/getSkill)
 - [`createSkill()` reference](https://mastra.ai/reference/agents/createSkill)

package/.docs/reference/agents/listSuspendedRuns.md

@@ -4,9 +4,9 @@
 
 **Added in:** `@mastra/core@1.43.0`
 
-The `.listSuspendedRuns()` method lists suspended agent runs from workflow snapshot storage: runs waiting on a tool call requiring [approval](https://mastra.ai/docs/agents/agent-approval), or on a tool that called `suspend()`. Because discovery is backed by storage rather than in-memory state, it works after a server restart and across multiple server instances.
+The `.listSuspendedRuns()` method lists suspended agent runs from workflow snapshot storage: runs waiting on a tool call requiring [approval](https://mastra.ai/docs/agents/human-in-the-loop), or on a tool that called `suspend()`. Because discovery is backed by storage rather than in-memory state, it works after a server restart and across multiple server instances.
 
-Pass the returned `runId` to [`resumeStream()`](https://mastra.ai/docs/agents/agent-approval), `approveToolCall()`, or `declineToolCall()` to continue the run.
+Pass the returned `runId` to [`resumeStream()`](https://mastra.ai/docs/agents/human-in-the-loop), `approveToolCall()`, or `declineToolCall()` to continue the run.
 
 The filter contract mirrors the workflow run listing APIs (`listWorkflowRuns`), plus the agent-level `threadId` filter.
 
@@ -83,11 +83,11 @@ interface AgentRunToolCall {
 
 ## Discovery scope
 
-Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/agent-approval) the supervisor sees its outer run (the one to resume), while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
+Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/human-in-the-loop) the supervisor sees its outer run (the one to resume), while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
 
-Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/storage/overview) configured. With the default in-memory store, snapshots are lost on restart.
+Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/storage) configured. With the default in-memory store, snapshots are lost on restart.
 
 ## Related
 
-- [Agent approval](https://mastra.ai/docs/agents/agent-approval)
-- [Storage](https://mastra.ai/docs/storage/overview)
+- [Agent approval](https://mastra.ai/docs/agents/human-in-the-loop)
+- [Storage](https://mastra.ai/docs/storage)

package/.docs/reference/agents/listTools.md

@@ -30,5 +30,5 @@ await agent.listTools({
 
 ## Related
 
-- [Using tools with agents](https://mastra.ai/docs/agents/using-tools)
-- [Creating tools](https://mastra.ai/docs/mcp/overview)
+- [Using tools with agents](https://mastra.ai/docs/agents/tools)
+- [Creating tools](https://mastra.ai/docs/connections/mcp)

package/.docs/reference/agents/network.md

@@ -4,7 +4,7 @@
 
 The `.network()` method enables multi-agent collaboration and routing. This method accepts messages and optional execution options.
 
-> **Deprecated:** The `.network()` primitive has been deprecated and will be removed in a future major release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** The `.network()` primitive has been deprecated and will be removed in a future major release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 ## Usage example
 
@@ -100,6 +100,8 @@ await agent.network(`
 
 **options.modelSettings.frequencyPenalty** (`number`): Penalty for token frequency (-2 to 2). Reduces repetition of frequent tokens.
 
+**options.modelSettings.timeout** (`object`): Time-based execution budget for the run. Accepts totalMs, the maximum duration of the entire agent run across every loop iteration, tool call and retry, and stepMs, the maximum duration of a single model call including the time spent consuming its stream. Exceeding either budget fails with a MastraTimeoutError. A totalMs timeout ends the run and does not try fallback models, because it is a hard deadline for the whole run. A stepMs timeout is not retried against the same model but does advance to the next entry in models when fallback models are configured.
+
 **options.modelSettings.stopSequences** (`string[]`): Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.
 
 **options.structuredOutput** (`StructuredOutputOptions`): Configuration for generating a typed structured output from the network result.

package/.docs/reference/ai-sdk/chat-route.md

@@ -51,7 +51,7 @@ export const mastra = new Mastra({
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **path** (`string`): The route path (e.g., /chat or /chat/:agentId). Include :agentId for dynamic agent routing. (Default: `'/chat/:agentId'`)
 

package/.docs/reference/ai-sdk/handle-chat-stream.md

@@ -50,7 +50,7 @@ export async function POST(req: Request) {
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **mastra** (`Mastra`): The Mastra instance containing registered agents.
 

package/.docs/reference/ai-sdk/handle-network-stream.md

@@ -2,7 +2,7 @@
 
 # handleNetworkStream()
 
-> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 Framework-agnostic handler for streaming network execution in AI SDK-compatible format. Use this function directly when you need to handle network streaming outside Hono or Mastra's own [apiRoutes](https://mastra.ai/docs/server/custom-api-routes) feature.
 
@@ -34,7 +34,7 @@ export async function POST(req: Request) {
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **mastra** (`Mastra`): The Mastra instance to use for agent lookup and execution.
 

package/.docs/reference/ai-sdk/handle-workflow-stream.md

@@ -36,7 +36,7 @@ export async function POST(req: Request) {
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **mastra** (`Mastra`): The Mastra instance containing registered workflows.
 

package/.docs/reference/ai-sdk/network-route.md

@@ -2,7 +2,7 @@
 
 # networkRoute()
 
-> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 Creates a network route handler for streaming network execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent network, and streams the response back to the client in AI SDK-compatible format. Agent networks allow a routing agent to delegate tasks to other agents. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 
@@ -49,7 +49,7 @@ export const mastra = new Mastra({
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **path** (`string`): The route path (e.g., /network or /network/:agentId). Include :agentId for dynamic agent routing. (Default: `'/network/:agentId'`)
 

package/.docs/reference/ai-sdk/to-ai-sdk-messages.md

@@ -44,7 +44,7 @@ export default function Chat() {
 
 **messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
 
-**options.version** (`'v5' | 'v6'`): Selects the AI SDK message type to return. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 useChat() message types.
+**options.version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK message type to return. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 useChat() message types. Pass 'v7' when your app is typed against AI SDK v7.
 
 ## Returns
 

package/.docs/reference/ai-sdk/to-ai-sdk-stream.md

@@ -64,7 +64,7 @@ The first parameter is the Mastra stream to convert. It can be one of:
 
 The second parameter is an options object:
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **from** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
 

package/.docs/reference/ai-sdk/workflow-route.md

@@ -51,7 +51,7 @@ export const mastra = new Mastra({
 
 ## Parameters
 
-**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+**version** (`'v5' | 'v6' | 'v7'`): Selects the AI SDK stream contract to emit. Omit it or pass 'v5' for the existing default behavior. Pass 'v6' when your app is typed against AI SDK v6 response helpers. Pass 'v7' when your app is typed against AI SDK v7. (Default: `'v5'`)
 
 **path** (`string`): The route path (e.g., /workflow or /workflow/:workflowId). Include :workflowId for dynamic workflow routing. (Default: `'/api/workflows/:workflowId/stream'`)
 

package/.docs/reference/auth/fga.md

@@ -4,7 +4,7 @@
 
 The `IFGAProvider` interface defines a fine-grained authorization (FGA) provider. Mastra calls it to decide whether a user or a system actor may perform a permission on a specific resource. Implement it to connect Mastra to an FGA backend, such as WorkOS Authorization.
 
-For concepts, configuration, and the lifecycle points where Mastra enforces FGA, see [Fine-grained authorization](https://mastra.ai/docs/server/auth/fga).
+For concepts, configuration, and the lifecycle points where Mastra enforces FGA, see [Fine-grained authorization](https://mastra.ai/docs/auth/fga).
 
 ## Usage example
 
@@ -47,7 +47,7 @@ Returns: `Promise<boolean>`
 
 ### `require(user, params)`
 
-Throws `FGADeniedError` when `user` lacks the permission. Mastra calls this at its [enforcement points](https://mastra.ai/docs/server/auth/fga).
+Throws `FGADeniedError` when `user` lacks the permission. Mastra calls this at its [enforcement points](https://mastra.ai/docs/auth/fga).
 
 Returns: `Promise<void>`
 
@@ -63,7 +63,7 @@ Authorizes a non-user system actor, such as an autonomous or scheduled agent. Op
 
 System actors skip the user-centric `require()` path, so implement `requireActor` to enforce per-agent least privilege for them. Throw `FGADeniedError` to deny. When a provider doesn't implement `requireActor`, Mastra preserves the trusted-actor bypass (allow after the tenant-scope check), so adding the method remains backward compatible.
 
-Treat `actor.permissions` as an untrusted claim. Resolve the agent's authoritative grants from a trusted source keyed by `actor.agentId`, rather than trusting the inline values. See [System actors](https://mastra.ai/docs/server/auth/fga).
+Treat `actor.permissions` as an untrusted claim. Resolve the agent's authoritative grants from a trusted source keyed by `actor.agentId`, rather than trusting the inline values. See [System actors](https://mastra.ai/docs/auth/fga).
 
 ```typescript
 import { FGADeniedError } from '@mastra/core/auth/ee'
@@ -122,6 +122,8 @@ Identifies a call made by a trusted non-user actor rather than an authenticated
 
 **sourceWorkflow** (`string`): Name of the workflow that started the actor run, when applicable.
 
+**propagate** (`boolean`): Forwards this actor into the agent and tool calls the framework makes for the run's declarative .then(agent) and .then(tool) steps. Custom step execute functions aren't covered and must pass actor explicitly. Ignored by authorization itself. (Default: `false`)
+
 ## `FGADeniedError`
 
 Thrown when an authorization check is denied. `require` and `requireActor` throw it to deny, and Mastra surfaces it as an HTTP `403`.
@@ -135,6 +137,6 @@ throw new FGADeniedError(user, { type: 'agent', id: 'reporter' }, 'agents:execut
 
 ## Related
 
-- [Fine-grained authorization](https://mastra.ai/docs/server/auth/fga)
-- [System actors](https://mastra.ai/docs/server/auth/fga)
+- [Fine-grained authorization](https://mastra.ai/docs/auth/fga)
+- [System actors](https://mastra.ai/docs/auth/fga)
 - [WorkOS authentication](https://mastra.ai/reference/auth/workos)

package/.docs/reference/auth/jwt.md

@@ -25,4 +25,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-- [JSON Web Token](https://mastra.ai/docs/server/auth/jwt)
+- [JSON Web Token](https://mastra.ai/docs/auth/jwt)

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

@@ -54,7 +54,7 @@ then interact with elements using their refs (e.g., @e5).`,
 
 `AgentBrowser` provides 16 deterministic tools for browser automation. All tools that interact with elements use refs from the accessibility tree snapshot.
 
-When `recording` is configured, `AgentBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser/overview).
+When `recording` is configured, `AgentBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser).
 
 ### Core tools
 
@@ -403,5 +403,5 @@ The `browser_snapshot` tool returns an accessibility tree with element refs like
 
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser): AI-powered alternative
-- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
+- [Browser overview](https://mastra.ai/docs/browser): Conceptual guide
 - [agent-browser guide](https://mastra.ai/integrations/browsers/agent-browser): Usage guide

package/.docs/reference/browser/browser-viewer.md

@@ -194,7 +194,7 @@ await viewer.injectKeyboardEvent({
 
 ## Supported CLIs
 
-Each CLI must be installed separately. Each also publishes a [skill](https://mastra.ai/docs/workspace/skills) that teaches the agent its commands and workflows. When a CLI command runs through `workspace_execute_command`, Mastra detects it and injects the CDP URL automatically using the correct flag.
+Each CLI must be installed separately. Each also publishes a [skill](https://mastra.ai/docs/sandbox/skills) that teaches the agent its commands and workflows. When a CLI command runs through `workspace_execute_command`, Mastra detects it and injects the CDP URL automatically using the correct flag.
 
 Unlike SDK providers, `BrowserViewer` doesn't provide agent tools. The agent uses CLI commands through `workspace_execute_command` instead.
 
@@ -229,4 +229,4 @@ browse skills install
 
 - [BrowserViewer guide](https://mastra.ai/integrations/browsers/browser-viewer): Setup and usage walkthrough
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class API reference
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox): Workspace configuration
+- [Sandbox](https://mastra.ai/docs/sandbox/overview): Workspace configuration

package/.docs/reference/browser/firecrawl-browser.md

@@ -68,4 +68,4 @@ In both cases, `FirecrawlBrowser` deletes the remote Firecrawl session when the
 
 - [Firecrawl docs](https://mastra.ai/integrations/browsers/firecrawl)
 - [`AgentBrowser` reference](https://mastra.ai/reference/browser/agent-browser)
-- [Browser overview](https://mastra.ai/docs/browser/overview)
+- [Browser overview](https://mastra.ai/docs/browser)

package/.docs/reference/browser/mastra-browser.md

@@ -285,4 +285,4 @@ const browser = new AgentBrowser({
 
 - [AgentBrowser](https://mastra.ai/reference/browser/agent-browser): Deterministic browser automation
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser): AI-powered browser automation
-- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide to browser automation
+- [Browser overview](https://mastra.ai/docs/browser): Conceptual guide to browser automation

package/.docs/reference/browser/stagehand-browser.md

@@ -71,7 +71,7 @@ Use stagehand_extract to get data from pages.`,
 
 `StagehandBrowser` provides 7 AI-powered tools for browser automation.
 
-When `recording` is configured, `StagehandBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser/overview).
+When `recording` is configured, `StagehandBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser).
 
 Core tools:
 
@@ -316,5 +316,5 @@ Choose `AgentBrowser` for precise, reproducible automation. Choose `StagehandBro
 
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
 - [AgentBrowser](https://mastra.ai/reference/browser/agent-browser): Deterministic alternative
-- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
+- [Browser overview](https://mastra.ai/docs/browser): Conceptual guide
 - [Stagehand guide](https://mastra.ai/integrations/browsers/stagehand): Usage guide

package/.docs/reference/build-with-ai.md

@@ -2,7 +2,7 @@
 
 # Build with AI
 
-For everyday AI-assisted development with Mastra skills and the CLI, see [Develop](https://mastra.ai/docs/getting-started/develop). This page covers other ways to give coding agents access to Mastra documentation.
+For everyday AI-assisted development with Mastra skills and the CLI, see [Develop](https://mastra.ai/docs/develop). This page covers other ways to give coding agents access to Mastra documentation.
 
 ## Embedded package docs
 
@@ -29,7 +29,7 @@ Examples for the [introduction page](https://mastra.ai/docs):
 
 ## MCP docs server
 
-> **Warning:** The MCP docs server isn't recommended for everyday development. Use the [Mastra skill](https://mastra.ai/docs/getting-started/develop) instead because it's more up to date and performs better.
+> **Warning:** The MCP docs server isn't recommended for everyday development. Use the [Mastra skill](https://mastra.ai/docs/develop) instead because it's more up to date and performs better.
 
 The `@mastra/mcp-docs-server` package provides direct local access to Mastra’s full documentation via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro). It works with Cursor, Windsurf, Cline, Claude Code, VS Code, Codex or any tool that supports MCP.
 

package/.docs/reference/channels/channel-provider.md

@@ -64,4 +64,4 @@ const all = mastra.getChannelProviders()
 ## Related
 
 - [SlackProvider](https://mastra.ai/reference/channels/slack-provider)
-- [Channels](https://mastra.ai/docs/capabilities/channels)
+- [Channels](https://mastra.ai/docs/channels)

package/.docs/reference/channels/slack-provider.md

@@ -226,5 +226,5 @@ const result = await slack.connect('support-agent')
 ## Related
 
 - [ChannelProvider](https://mastra.ai/reference/channels/channel-provider): the interface `SlackProvider` implements
-- [Channels](https://mastra.ai/docs/capabilities/channels): concepts, platform setup, and the `createSlackAdapter` path
+- [Channels](https://mastra.ai/docs/channels): concepts, platform setup, and the `createSlackAdapter` path
 - [Channels reference](https://mastra.ai/reference/agents/channels): the `channels` config on the `Agent` constructor

package/.docs/reference/cli/mastra.md

@@ -1771,6 +1771,8 @@ When a server started with `mastra dev` or `mastra start` has observability metr
 
 At server startup, Mastra also sends an anonymous project-surface snapshot: counts of registered agents, agent controllers, workflows, tools, processors, vector stores, scorers, workspaces, MCP servers, gateways, and channels, plus booleans for memory, voice, editor, and observability usage and the coarse storage backend category. It doesn't send names or identifiers. You can read the [source code](https://github.com/mastra-ai/mastra/blob/main/packages/core/src/telemetry/feature-telemetry.ts) to check what's collected.
 
+The Studio UI also collects anonymous browser-side usage analytics, such as page views and UI interactions. You can read the [source code](https://github.com/mastra-ai/mastra/blob/main/packages/playground/src/lib/analytics.tsx) to check what's collected. Setting `MASTRA_TELEMETRY_DISABLED` disables this too: the value is injected into the served page, so it applies to `mastra dev` and self-hosted builds alike.
+
 You can opt out of all CLI and usage analytics by setting an environment variable:
 
 ```bash

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

@@ -285,7 +285,7 @@ await subscription.processDataStream({
 
 ### `streamUntilIdle()`
 
-Stream a response and keep the stream open until every [background task](https://mastra.ai/docs/long-running-agents/background-tasks) dispatched during the run completes. The server re-enters the agentic loop on each task completion so the LLM can react to results in the same call. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call uses a plain `stream()`.
+Stream a response and keep the stream open until every [background task](https://mastra.ai/docs/harness/background-tasks) dispatched during the run completes. The server re-enters the agentic loop on each task completion so the LLM can react to results in the same call. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call uses a plain `stream()`.
 
 ```typescript
 const response = await agent.streamUntilIdle('Research solana for me', {
@@ -307,7 +307,7 @@ response.processDataStream({
 
 ### `resumeStreamUntilIdle()`
 
-Resume a suspended agent stream with custom data and keep the stream open until every [background task](https://mastra.ai/docs/long-running-agents/background-tasks) dispatched during the run completes. Use this to continue execution after a suspension point, such as a workflow suspend within an agent. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call uses a plain `resumeStream()`:
+Resume a suspended agent stream with custom data and keep the stream open until every [background task](https://mastra.ai/docs/harness/background-tasks) dispatched during the run completes. Use this to continue execution after a suspension point, such as a workflow suspend within an agent. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call uses a plain `resumeStream()`:
 
 ```typescript
 const response = await agent.resumeStreamUntilIdle(
@@ -497,7 +497,7 @@ if (output.finishReason === 'suspended') {
 
 ## Agent schedules
 
-Use the client SDK schedule methods to manage persisted agent schedules over the `/api/schedules` routes. For concepts and server-side examples, see [Schedules](https://mastra.ai/docs/long-running-agents/schedules) and the [`mastra.schedules` reference](https://mastra.ai/reference/schedules/overview).
+Use the client SDK schedule methods to manage persisted agent schedules over the `/api/schedules` routes. For concepts and server-side examples, see [Schedules](https://mastra.ai/docs/harness/schedules) and the [`mastra.schedules` reference](https://mastra.ai/reference/schedules/overview).
 
 ### `createSchedule()`
 
@@ -778,9 +778,29 @@ const agent = await mastraClient.createStoredAgent({
     version: '1.0',
     team: 'engineering',
   },
+  durable: true,
 })
 ```
 
+#### Durable stored agents
+
+Set `durable` to run the agent as a [durable agent](https://mastra.ai/docs/harness/durable-agents) once the server hydrates it. Pass `true` to accept the defaults, or an object to tune the durable loop:
+
+```typescript
+const agent = await mastraClient.createStoredAgent({
+  id: 'durable-agent',
+  name: 'Durable Agent',
+  instructions: 'You are a helpful assistant.',
+  model: {
+    provider: 'openai',
+    name: 'gpt-5.4',
+  },
+  durable: { maxSteps: 50, cleanupTimeoutMs: 0 },
+})
+```
+
+Only serializable options are accepted. The durable cache and pubsub are inherited from the server's `Mastra` instance. If it has no distributed cache or pubsub configured, durability is process-local. Automatic recovery is still configured in code through `recovery.durableAgents`.
+
 ### `getStoredAgent()`
 
 Get an instance of a specific stored agent:
@@ -839,7 +859,7 @@ console.log(result.success) // true
 
 ## Version management
 
-Both `Agent` (code-defined) and `StoredAgent` instances have methods for managing configuration versions. See [Editor versioning](https://mastra.ai/docs/editor/overview) for lifecycle and selection behavior.
+Both `Agent` (code-defined) and `StoredAgent` instances have methods for managing configuration versions. See [Editor versioning](https://mastra.ai/docs/studio/editor) for lifecycle and selection behavior.
 
 ### Getting an agent with a specific version