@mastra/mcp-docs-server 1.2.12-alpha.0 → 1.2.12-alpha.4

package/.docs/models/providers/deepinfra.md

@@ -11,22 +11,22 @@ DEEPINFRA_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "deepinfra/MiniMaxAI/MiniMax-M2.5"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'deepinfra/MiniMaxAI/MiniMax-M2.5',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -62,7 +62,7 @@ for await (const chunk of stream) {
 | `deepinfra/Qwen/Qwen3.5-397B-A17B`                            | 262K    |       |           |       |       |       | $0.45      | $3          |
 | `deepinfra/Qwen/Qwen3.5-9B`                                   | 262K    |       |           |       |       |       | $0.10      | $0.15       |
 | `deepinfra/Qwen/Qwen3.6-27B`                                  | 262K    |       |           |       |       |       | $0.32      | $3          |
-| `deepinfra/Qwen/Qwen3.6-35B-A3B`                              | 262K    |       |           |       |       |       | $0.15      | $0.95       |
+| `deepinfra/Qwen/Qwen3.6-35B-A3B`                              | 262K    |       |           |       |       |       | $0.10      | $0.95       |
 | `deepinfra/Qwen/Qwen3.7-Max`                                  | 256K    |       |           |       |       |       | $3         | $8          |
 | `deepinfra/XiaomiMiMo/MiMo-V2.5`                              | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `deepinfra/XiaomiMiMo/MiMo-V2.5-Pro`                          | 1.0M    |       |           |       |       |       | $1         | $3          |
@@ -79,31 +79,29 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    id: "deepinfra/MiniMaxAI/MiniMax-M2.5",
+    id: 'deepinfra/MiniMaxAI/MiniMax-M2.5',
     apiKey: process.env.DEEPINFRA_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "deepinfra/zai-org/GLM-5.2"
-      : "deepinfra/MiniMaxAI/MiniMax-M2.5";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'deepinfra/zai-org/GLM-5.2' : 'deepinfra/MiniMaxAI/MiniMax-M2.5'
+  },
+})
 ```
 
 ## Direct provider installation

package/.docs/models/providers/hyper.md

@@ -11,22 +11,22 @@ HYPER_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "hyper/deepseek-v4-flash"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'hyper/deepseek-v4-flash',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -38,17 +38,17 @@ for await (const chunk of stream) {
 | ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `hyper/deepseek-v4-flash`                            | 1.0M    |       |           |       |       |       | $0.20      | $0.40       |
 | `hyper/deepseek-v4-pro`                              | 1.0M    |       |           |       |       |       | $2         | $5          |
-| `hyper/gemma-4-26b-a4b-it`                           | 256K    |       |           |       |       |       | $0.13      | $0.42       |
+| `hyper/gemma-4-26b-a4b-it`                           | 256K    |       |           |       |       |       | $0.12      | $0.41       |
 | `hyper/glm-5`                                        | 203K    |       |           |       |       |       | $0.81      | $3          |
 | `hyper/glm-5.1`                                      | 203K    |       |           |       |       |       | $2         | $5          |
 | `hyper/glm-5.2`                                      | 1.0M    |       |           |       |       |       | $1         | $4          |
-| `hyper/gpt-oss-120b`                                 | 131K    |       |           |       |       |       | $0.18      | $0.65       |
+| `hyper/gpt-oss-120b`                                 | 131K    |       |           |       |       |       | $0.18      | $0.68       |
 | `hyper/kimi-k2.5`                                    | 262K    |       |           |       |       |       | $0.53      | $3          |
 | `hyper/kimi-k2.6`                                    | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `hyper/kimi-k2.7-code`                               | 256K    |       |           |       |       |       | $0.95      | $4          |
 | `hyper/llama-3.3-70b-instruct`                       | 128K    |       |           |       |       |       | $0.61      | $1          |
 | `hyper/llama-4-maverick-17b-128e-instruct-fp8`       | 430K    |       |           |       |       |       | $0.28      | $0.93       |
-| `hyper/minimax-m2.7`                                 | 205K    |       |           |       |       |       | $0.35      | $1          |
+| `hyper/minimax-m2.7`                                 | 205K    |       |           |       |       |       | $0.41      | $2          |
 | `hyper/qwen3-coder-480b-a35b-instruct-int4-mixed-ar` | 106K    |       |           |       |       |       | $0.57      | $2          |
 | `hyper/qwen3-next-80b-a3b-instruct`                  | 262K    |       |           |       |       |       | $0.12      | $1          |
 | `hyper/qwen3.6-flash`                                | 1.0M    |       |           |       |       |       | $1         | $4          |
@@ -63,30 +63,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://hyper.charm.land/v1",
-    id: "hyper/deepseek-v4-flash",
+    url: 'https://hyper.charm.land/v1',
+    id: 'hyper/deepseek-v4-flash',
     apiKey: process.env.HYPER_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "hyper/qwen3.7-plus"
-      : "hyper/deepseek-v4-flash";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'hyper/qwen3.7-plus' : 'hyper/deepseek-v4-flash'
+  },
+})
 ```

package/.docs/models/providers/llmgateway.md

@@ -2,7 +2,7 @@
 
 # ![LLM Gateway logo](https://models.dev/logos/llmgateway.svg)LLM Gateway
 
-Access 185 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
+Access 186 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
 
 Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
 
@@ -11,22 +11,22 @@ LLMGATEWAY_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "llmgateway/auto"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'llmgateway/auto',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -200,9 +200,9 @@ for await (const chunk of stream) {
 | `llmgateway/qwen3-max`                         | 262K    |       |           |       |       |       | $0.84      | $3          |
 | `llmgateway/qwen3-next-80b-a3b-instruct`       | 131K    |       |           |       |       |       | $0.15      | $1          |
 | `llmgateway/qwen3-next-80b-a3b-thinking`       | 131K    |       |           |       |       |       | $0.15      | $1          |
-| `llmgateway/qwen3-vl-235b-a22b-instruct`       | 131K    |       |           |       |       |       | $0.30      | $2          |
+| `llmgateway/qwen3-vl-235b-a22b-instruct`       | 262K    |       |           |       |       |       | $0.20      | $0.88       |
 | `llmgateway/qwen3-vl-235b-a22b-thinking`       | 131K    |       |           |       |       |       | $0.98      | $4          |
-| `llmgateway/qwen3-vl-30b-a3b-instruct`         | 131K    |       |           |       |       |       | $0.20      | $0.70       |
+| `llmgateway/qwen3-vl-30b-a3b-instruct`         | 262K    |       |           |       |       |       | $0.15      | $0.60       |
 | `llmgateway/qwen3-vl-flash`                    | 262K    |       |           |       |       |       | $0.05      | $0.40       |
 | `llmgateway/qwen3-vl-plus`                     | 262K    |       |           |       |       |       | $0.20      | $2          |
 | `llmgateway/qwen3.5-9b`                        | 262K    |       |           |       |       |       | $0.10      | $0.15       |
@@ -210,6 +210,7 @@ for await (const chunk of stream) {
 | `llmgateway/qwen3.6-flash`                     | 262K    |       |           |       |       |       | $0.15      | $0.90       |
 | `llmgateway/qwen3.6-max-preview`               | 262K    |       |           |       |       |       | $1         | $8          |
 | `llmgateway/qwen3.6-plus`                      | 262K    |       |           |       |       |       | $0.50      | $3          |
+| `llmgateway/qwen3.7-flash`                     | 1.0M    |       |           |       |       |       | $0.03      | $0.13       |
 | `llmgateway/qwen3.7-max`                       | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `llmgateway/qwen3.7-plus`                      | 1.0M    |       |           |       |       |       | $0.40      | $2          |
 | `llmgateway/qwen35-397b-a17b`                  | 262K    |       |           |       |       |       | $0.60      | $4          |
@@ -227,30 +228,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://api.llmgateway.io/v1",
-    id: "llmgateway/auto",
+    url: 'https://api.llmgateway.io/v1',
+    id: 'llmgateway/auto',
     apiKey: process.env.LLMGATEWAY_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "llmgateway/sonar-reasoning-pro"
-      : "llmgateway/auto";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'llmgateway/sonar-reasoning-pro' : 'llmgateway/auto'
+  },
+})
 ```

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

@@ -2,7 +2,7 @@
 
 # ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
 
-Access 30 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
+Access 31 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
 
 Learn more in the [Weights & Biases documentation](https://docs.wandb.ai).
 
@@ -11,22 +11,22 @@ WANDB_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'wandb/JetBrains/Mellum2-12B-A2.5B-Instruct',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -50,6 +50,7 @@ for await (const chunk of stream) {
 | `wandb/moonshotai/Kimi-K2.5`                         | 262K    |       |           |       |       |       | $0.60      | $3          |
 | `wandb/moonshotai/Kimi-K2.6`                         | 262K    |       |           |       |       |       | $0.65      | $3          |
 | `wandb/moonshotai/Kimi-K2.7-Code`                    | 262K    |       |           |       |       |       | $0.71      | $4          |
+| `wandb/moonshotai/Kimi-K3`                           | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `wandb/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-FP8` | 262K    |       |           |       |       |       | $0.20      | $0.80       |
 | `wandb/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B`     | 262K    |       |           |       |       |       | $0.75      | $3          |
 | `wandb/openai/gpt-oss-120b`                          | 131K    |       |           |       |       |       | $0.03      | $0.17       |
@@ -69,30 +70,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://api.inference.wandb.ai/v1",
-    id: "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct",
+    url: 'https://api.inference.wandb.ai/v1',
+    id: 'wandb/JetBrains/Mellum2-12B-A2.5B-Instruct',
     apiKey: process.env.WANDB_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "wandb/zai-org/GLM-5.2"
-      : "wandb/JetBrains/Mellum2-12B-A2.5B-Instruct";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'wandb/zai-org/GLM-5.2' : 'wandb/JetBrains/Mellum2-12B-A2.5B-Instruct'
+  },
+})
 ```

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

@@ -27,7 +27,7 @@ export const codeSupervisor = new Agent({
   id: 'code-supervisor',
   name: 'Code Supervisor',
   instructions: 'Delegate code editing tasks to the code-agent subagent.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   agents: {
     codeAgent,
   },

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

@@ -26,7 +26,7 @@ export const codeSupervisor = new Agent({
   id: 'code-supervisor',
   name: 'Code Supervisor',
   instructions: 'Use the code-agent tool when a task requires repository inspection or code edits.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   tools: {
     codeAgentTool,
   },

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

@@ -18,7 +18,7 @@ export const agent = new Agent({
   id: 'test-agent',
   name: 'Test Agent',
   instructions: 'You are a helpful assistant that provides concise answers.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 // System message object
@@ -29,7 +29,7 @@ export const agent2 = new Agent({
     role: 'system',
     content: 'You are an expert programmer',
   },
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 // Array of system messages
@@ -40,7 +40,7 @@ export const agent3 = new Agent({
     { role: 'system', content: 'You are a helpful assistant' },
     { role: 'system', content: 'You have expertise in TypeScript' },
   ],
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 ```
 
@@ -63,7 +63,7 @@ export const agent = new Agent({
       },
     },
   },
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 ```
 
@@ -102,7 +102,7 @@ For the simplest setup, pass `model` as a string in `provider/model` format. Sep
 
 Popular provider strings and credentials:
 
-- **OpenAI**: `openai/gpt-5.5` uses `OPENAI_API_KEY`.
+- **OpenAI**: `openai/gpt-5.6-sol` uses `OPENAI_API_KEY`.
 - **Anthropic**: `anthropic/claude-sonnet-4-6` uses `ANTHROPIC_API_KEY`.
 - **Google**: `google/gemini-2.5-pro` uses `GOOGLE_API_KEY` or `GOOGLE_GENERATIVE_AI_API_KEY`.
 
@@ -396,7 +396,7 @@ export const supportAgent = new Agent({
   id: 'support-agent',
   name: 'Support Agent',
   instructions: 'Help the user triage updates.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   notifications: {
     deliveryPolicy: {
       priorities: {
@@ -530,7 +530,7 @@ export const agent = new Agent({
   id: 'support-agent',
   name: 'support-agent',
   instructions: 'Help users with their questions.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   hooks: {
     beforeToolCall: ({ toolName, input }) => {
       console.log(`Running ${toolName}`, input)

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

@@ -17,7 +17,7 @@ export const supportAgent = new Agent({
   id: 'support-agent',
   name: 'Support Agent',
   instructions: 'You are a helpful support assistant.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       slack: createSlackAdapter(),
@@ -70,7 +70,7 @@ const agent = new Agent({
   id: 'example',
   name: 'Example',
   instructions: '...',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       discord: {
@@ -126,7 +126,7 @@ const agent = new Agent({
   id: 'streaming-agent',
   name: 'Streaming Agent',
   instructions: '...',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       slack: {
@@ -154,7 +154,7 @@ const agent = new Agent({
   id: 'custom-typing-agent',
   name: 'Custom Typing Agent',
   instructions: '...',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       discord: {
@@ -187,7 +187,7 @@ const agent = new Agent({
   id: 'custom-handler-agent',
   name: 'Custom Handler Agent',
   instructions: '...',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       slack: createSlackAdapter(),
@@ -216,19 +216,35 @@ type ChannelHandler = (
   thread: Thread,
   message: Message,
   defaultHandler: (thread: Thread, message: Message) => Promise<void>,
-  ctx?: ChannelHandlerContext,
+  ctx: ChannelHandlerContext,
 ) => Promise<void>
+
+type ChannelHandlerContext = {
+  mastra?: Mastra
+  requestContext: RequestContext
+}
+```
+
+`ctx.mastra` is the resolved `mastra` instance, so a handler can reach storage or other registered primitives without being passed an external accessor:
+
+```typescript
+onDirectMessage: async (thread, message, defaultHandler, ctx) => {
+  const store = await ctx.mastra?.getStorage()?.getStore('memory')
+  await defaultHandler(thread, message)
+}
 ```
 
-`ctx` carries the resolved `mastra` instance, so a handler can reach storage or other registered primitives without being passed an external accessor:
+`ctx.requestContext` is the [`RequestContext`](https://mastra.ai/docs/server/request-context) for the run this message is about to start, built fresh for every message. Write to it before calling `defaultHandler` and the value reaches the run, alongside the channel entries Mastra adds afterward:
 
 ```typescript
 onDirectMessage: async (thread, message, defaultHandler, ctx) => {
-  const store = await ctx?.mastra?.getStorage()?.getStore('memory')
+  ctx.requestContext.set('locale', 'en-GB')
   await defaultHandler(thread, message)
 }
 ```
 
+Anything the run reads from its request context can be decided per message this way, such as which user a platform sender maps to.
+
 ## Resource ID resolution
 
 By default a channel thread's memory `resourceId` is `${platform}:${message.author.userId}`. The sender owns the memory, scoped per platform. For apps with a shared identity, such as single sign-on (SSO), this splits memory: the same user gets `feishu:user_123` in a Feishu DM but `user_123` on the web.
@@ -243,7 +259,7 @@ const agent = new Agent({
   id: 'sso-agent',
   name: 'SSO Agent',
   instructions: '...',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       slack: createSlackAdapter(),
@@ -284,7 +300,7 @@ const agent = new Agent({
   id: 'session-agent',
   name: 'Session Agent',
   instructions: '...',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   channels: {
     adapters: {
       slack: createSlackAdapter(),

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

@@ -17,7 +17,7 @@ const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 const durableAgent = createDurableAgent({ agent })
@@ -49,7 +49,7 @@ const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   durable: true, // or: { maxSteps: 10, cleanupTimeoutMs: 60_000 }
 })
 
@@ -204,6 +204,55 @@ interface PrepareResult {
 }
 ```
 
+### Recovery
+
+#### `recoverActiveRuns(options?)`
+
+Discovers runs stuck in `running` status for this agent and re-drives them from the last persisted snapshot. Recovers up to `options.limit` runs (default: 100). Returns a summary of what was recovered.
+
+```typescript
+const result = await durableAgent.recoverActiveRuns()
+// { recovered: [{ runId, status }], succeeded: 2, failed: 0 }
+```
+
+Pass a `runId` to recover a single known run:
+
+```typescript
+await durableAgent.recoverActiveRuns({ runId: 'run-abc-123' })
+```
+
+Returns:
+
+```typescript
+interface DurableAgentRecoverActiveRunsResult {
+  recovered: Array<{ runId: string; status: 'success' | 'failed'; error?: Error }>
+  succeeded: number
+  failed: number
+}
+```
+
+**options.runId** (`string`): Recover a specific run by ID. When set, discovery filters are ignored.
+
+**options.limit** (`number`): Maximum number of active runs to discover. Defaults to 100.
+
+**options.createdBefore** (`Date`): Only recover runs created before this date.
+
+#### `recover(runId, options?)`
+
+Recovers a single run by ID. Returns a streamable result with the same shape as `stream()`. Use this when you need to observe the recovery stream in real time.
+
+```typescript
+const { output, cleanup } = await durableAgent.recover('run-abc-123', {
+  onChunk: chunk => console.log(chunk),
+  onError: ({ error }) => console.error(error),
+})
+
+await output.text
+cleanup()
+```
+
+Returns: [`Promise<DurableAgentStreamResult>`](#durableagentstreamresult)
+
 ## Stream options
 
 `stream()` accepts a `DurableAgentStreamOptions` object. It supports the agent execution options below, plus lifecycle callbacks.

package/.docs/reference/agents/generateLegacy.md

@@ -205,7 +205,7 @@ await agent.generateLegacy(
         sentiment: z.enum(['positive', 'negative', 'neutral']),
         confidence: z.number(),
       }),
-      model: 'openai/gpt-5.5',
+      model: 'openai/gpt-5.6-sol',
       errorStrategy: 'warn',
     },
     // Output processors for response validation