@mastra/mcp-docs-server 1.1.14-alpha.2 → 1.1.14-alpha.4

package/.docs/course/01-first-agent/07-creating-your-agent.md

@@ -42,7 +42,7 @@ SUCCESS CRITERIA
 - Deliver accurate and helpful analysis of transaction data.
 - Achieve high user satisfaction through clear and helpful responses.
 - Maintain user trust by ensuring data privacy and security.`,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: {}, // We'll add tools in a later step
 })
 ```

package/.docs/course/01-first-agent/12-connecting-tool-to-agent.md

@@ -19,7 +19,7 @@ export const financialAgent = new Agent({
   TOOLS
   - Use the getTransactions tool to fetch financial transaction data.
   - Analyze the transaction data to answer user questions about their spending.`,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { getTransactionsTool }, // Add our tool here
 })
 ```

package/.docs/course/01-first-agent/16-adding-memory-to-agent.md

@@ -19,7 +19,7 @@ export const financialAgent = new Agent({
   instructions: `ROLE DEFINITION
   // ... existing instructions ...
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { getTransactionsTool },
   memory: new Memory({
     storage: new LibSQLStore({

package/.docs/course/02-agent-tools-mcp/05-updating-your-agent.md

@@ -10,7 +10,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools }, // Add MCP tools to your agent
 })
 ```

package/.docs/course/02-agent-tools-mcp/10-updating-agent-instructions-zapier.md

@@ -18,7 +18,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/16-updating-agent-instructions-github.md

@@ -22,7 +22,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/21-updating-agent-instructions-hackernews.md

@@ -27,7 +27,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/27-updating-agent-instructions-filesystem.md

@@ -34,7 +34,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md

@@ -61,7 +61,7 @@ export const personalAssistantAgent = new Agent({
     Always maintain a helpful and professional tone.
     Use the stored information to provide more personalized responses.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/03-agent-memory/04-creating-basic-memory-agent.md

@@ -26,7 +26,7 @@ export const memoryAgent = new Agent({
     When a user shares information about themselves, acknowledge it and remember it for future reference.
     If asked about something mentioned earlier in the conversation, recall it accurately.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/08-configuring-conversation-history.md

@@ -26,7 +26,7 @@ export const memoryAgent = new Agent({
     When a user shares information about themselves, acknowledge it and remember it for future reference.
     If asked about something mentioned earlier in the conversation, recall it accurately.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/16-configuring-semantic-recall.md

@@ -34,7 +34,7 @@ export const memoryAgent = new Agent({
     If asked about something mentioned earlier in the conversation, recall it accurately.
     You can also recall relevant information from older conversations when appropriate.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/21-configuring-working-memory.md

@@ -51,7 +51,7 @@ export const memoryAgent = new Agent({
     Always refer to your working memory before asking for information the user has already provided.
     Use the information in your working memory to provide personalized responses.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/22-custom-working-memory-templates.md

@@ -73,7 +73,7 @@ export const memoryAgent = new Agent({
     When the user shares personal information such as their name, location, or preferences,
     acknowledge it and update your working memory accordingly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/27-creating-learning-assistant.md

@@ -87,7 +87,7 @@ export const learningAssistantAgent = new Agent({
     Always be encouraging and supportive. Focus on building the user's confidence
     and celebrating their progress.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: learningMemory,
 })
 

package/.docs/course/04-workflows/11-creating-an-ai-agent.md

@@ -22,7 +22,7 @@ export const contentAgent = new Agent({
     
     Always provide constructive, actionable feedback.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
 })
 ```
 
@@ -31,7 +31,7 @@ export const contentAgent = new Agent({
 - **Name**: Unique identifier for the agent
 - **Description**: What the agent does
 - **Instructions**: Detailed prompts that guide the AI's behavior
-- **Model**: Which AI model to use (GPT-4.1-mini is fast and cost-effective)
+- **Model**: Which AI model to use
 
 ## Registering and Testing Your Agent
 

package/.docs/docs/agents/adding-voice.md

@@ -20,7 +20,7 @@ export const agent = new Agent({
   id: 'voice-agent',
   name: 'Voice Agent',
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   voice,
 })
 
@@ -109,7 +109,7 @@ export const agent = new Agent({
   id: 'speech-to-speech-agent',
   name: 'Speech-to-Speech Agent',
   instructions: `You are a helpful assistant with speech-to-speech capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   tools: {
     // Tools configured on Agent are passed to voice provider
     search,
@@ -209,7 +209,7 @@ export const convertToText = async (input: string | NodeJS.ReadableStream): Prom
 export const hybridVoiceAgent = new Agent({
   id: 'hybrid-voice-agent',
   name: 'Hybrid Voice Agent',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   instructions: 'You can speak and listen using different providers.',
   voice: new CompositeVoice({
     input: new OpenAIVoice(),
@@ -221,7 +221,7 @@ export const unifiedVoiceAgent = new Agent({
   id: 'unified-voice-agent',
   name: 'Unified Voice Agent',
   instructions: 'You are an agent with both STT and TTS capabilities.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   voice: new OpenAIVoice(),
 })
 
@@ -263,7 +263,7 @@ export const agent = new Agent({
   id: 'voice-agent',
   name: 'Voice Agent',
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
 
   // Create a composite voice using OpenAI for listening and PlayAI for speaking
   voice: new CompositeVoice({
@@ -288,7 +288,7 @@ export const agent = new Agent({
   id: 'aisdk-voice-agent',
   name: 'AI SDK Voice Agent',
   instructions: `You are a helpful assistant with voice capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
 
   // Pass AI SDK models directly to CompositeVoice
   voice: new CompositeVoice({

package/.docs/docs/agents/agent-approval.md

@@ -278,7 +278,7 @@ const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { weatherTool },
   memory: new Memory(),
   defaultOptions: {
@@ -343,7 +343,7 @@ const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { weatherTool },
   memory: new Memory(),
   defaultOptions: {
@@ -445,7 +445,7 @@ const dataAgent = new Agent({
   id: 'data-agent',
   name: 'Data Agent',
   description: 'Handles database queries and user data retrieval',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { findUserTool },
 })
 
@@ -454,7 +454,7 @@ const supervisorAgent = new Agent({
   name: 'Supervisor Agent',
   instructions: `You coordinate data retrieval tasks.
     Delegate to data-agent for user lookups.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: { dataAgent },
   memory: new Memory(),
 })

package/.docs/docs/agents/guardrails.md

@@ -25,7 +25,7 @@ export const moderatedAgent = new Agent({
   id: 'moderated-agent',
   name: 'Moderated Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new ModerationProcessor({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',

package/.docs/docs/agents/network-approval.md

@@ -176,7 +176,7 @@ const routingAgent = new Agent({
   id: 'routing-agent',
   name: 'Routing Agent',
   instructions: 'You coordinate tasks across multiple agents',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: { confirmationTool },
   memory: new Memory(),
   defaultNetworkOptions: {

package/.docs/docs/agents/networks.md

@@ -48,7 +48,7 @@ export const routingAgent = new Agent({
       Always respond with a complete report—no bullet points.
       Write in full paragraphs, like a blog post.
       Do not answer with incomplete or uncertain information.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: {
     researchAgent,
     writingAgent,

package/.docs/docs/agents/overview.md

@@ -53,7 +53,7 @@ Agents use LLMs and tools to solve open-ended tasks. They reason about goals, de
      id: 'test-agent',
      name: 'Test Agent',
      instructions: 'You are a helpful assistant.',
-     model: 'openai/gpt-5.1',
+     model: 'openai/gpt-5.4',
    })
    ```
 
@@ -283,7 +283,7 @@ export const testAgent = new Agent({
   model: ({ requestContext }) => {
     const userTier = requestContext.get('user-tier') as UserTier['user-tier']
 
-    return userTier === 'enterprise' ? 'openai/gpt-5' : 'openai/gpt-4.1-nano'
+    return userTier === 'enterprise' ? 'openai/gpt-5.4' : 'openai/gpt-5-mini'
   },
 })
 ```

package/.docs/docs/agents/processors.md

@@ -37,10 +37,10 @@ import { ModerationProcessor } from '@mastra/core/processors'
 export const moderatedAgent = new Agent({
   name: 'moderated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   inputProcessors: [
     new ModerationProcessor({
-      model: 'openai/gpt-4.1-nano',
+      model: 'openai/gpt-5-mini',
       categories: ['hate', 'harassment', 'violence'],
       threshold: 0.7,
       strategy: 'block',
@@ -178,7 +178,7 @@ export class DynamicModelProcessor implements Processor {
   }: ProcessInputStepArgs): Promise<ProcessInputStepResult> {
     // Use a fast model for initial response
     if (stepNumber === 0) {
-      return { model: 'openai/gpt-4o-mini' }
+      return { model: 'openai/gpt-5-mini' }
     }
 
     // Disable tools after 5 steps to force completion
@@ -270,7 +270,7 @@ const MAX_STEPS = 5
 const agent = new Agent({
   id: 'bounded-agent',
   name: 'Bounded Agent',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
   tools: {
     /* your tools */
   },
@@ -291,7 +291,7 @@ For simpler per-step logic, you can use the `prepareStep` callback on `generate(
 await agent.generate('Complex task', {
   prepareStep: async ({ stepNumber, model }) => {
     if (stepNumber === 0) {
-      return { model: 'openai/gpt-4o-mini' }
+      return { model: 'openai/gpt-5-mini' }
     }
     if (stepNumber > 5) {
       return { toolChoice: 'none' }
@@ -482,7 +482,7 @@ import { TokenLimiter } from '@mastra/core/processors'
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     // Ensure the total tokens don't exceed ~127k
     new TokenLimiter(127000),
@@ -490,7 +490,7 @@ const agent = new Agent({
 })
 ```
 
-The `TokenLimiter` uses the `o200k_base` encoding by default (suitable for GPT-4o). You can specify other encodings for different models:
+The `TokenLimiter` uses the `o200k_base` encoding by default. You can specify other encodings for different models:
 
 ```typescript
 import cl100k_base from 'js-tiktoken/ranks/cl100k_base'
@@ -516,7 +516,7 @@ import { ToolCallFilter, TokenLimiter } from '@mastra/core/processors'
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     // Example 1: Remove all tool calls/results
     new ToolCallFilter(),
@@ -542,7 +542,7 @@ import { ToolSearchProcessor } from '@mastra/core/processors'
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new ToolSearchProcessor({
       tools: {
@@ -584,7 +584,7 @@ const moderationWorkflow = createWorkflow({
 const agent = new Agent({
   id: 'moderated-agent',
   name: 'Moderated Agent',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [moderationWorkflow],
 })
 ```
@@ -619,7 +619,7 @@ export class QualityChecker implements Processor {
 const agent = new Agent({
   id: 'quality-agent',
   name: 'Quality Agent',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   outputProcessors: [new QualityChecker()],
   maxProcessorRetries: 3, // Maximum retry attempts (default: 3)
 })

package/.docs/docs/agents/structured-output.md

@@ -137,7 +137,7 @@ const response = await testAgent.generate('Analyze the TypeScript programming la
         differentiators: z.array(z.string()),
       }),
     }),
-    model: 'openai/gpt-4o',
+    model: 'openai/gpt-5.4',
   },
 })
 
@@ -207,7 +207,7 @@ When `model` is provided to the `structuredOutput` property, Mastra uses a separ
 const response = await testAgent.generate("Tell me about TypeScript.", {
   structuredOutput: {
     schema: yourSchema
-    model: 'openai/gpt-4o'
+    model: 'openai/gpt-5.4'
   }
 });
 ```
@@ -221,7 +221,7 @@ const result = await agent.stream('weather in vancouver?', {
   prepareStep: async ({ stepNumber }) => {
     if (stepNumber === 0) {
       return {
-        model: 'anthropic/claude-sonnet-4-20250514',
+        model: 'openai/gpt-5.4',
         tools: {
           weatherTool,
         },
@@ -229,7 +229,7 @@ const result = await agent.stream('weather in vancouver?', {
       }
     }
     return {
-      model: 'anthropic/claude-sonnet-4-20250514',
+      model: 'openai/gpt-5.4',
       tools: undefined,
       structuredOutput: {
         schema: z.object({

package/.docs/docs/agents/supervisor-agents.md

@@ -24,20 +24,20 @@ import { LibSQLStore } from '@mastra/libsql'
 const researchAgent = new Agent({
   id: 'research-agent',
   description: 'Gathers factual information and returns bullet-point summaries.',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
 })
 
 const writingAgent = new Agent({
   id: 'writing-agent',
   description: 'Transforms research into well-structured articles.',
-  model: 'openai/gpt-4o-mini',
+  model: 'openai/gpt-5-mini',
 })
 
 const supervisor = new Agent({
   id: 'supervisor',
   instructions: `You coordinate research and writing using specialized agents.
     Delegate to research-agent for facts, then writing-agent for content.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: { researchAgent, writingAgent },
   memory: new Memory({
     storage: new LibSQLStore({ id: 'storage', url: 'file:mastra.db' }),

package/.docs/docs/agents/using-tools.md

@@ -86,7 +86,7 @@ export const weatherAgent = new Agent({
   instructions: `
       You are a helpful weather assistant.
       Use the weatherTool to fetch current weather data.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   tools: { weatherTool },
 })
 ```
@@ -118,7 +118,7 @@ export const parentAgent = new Agent({
   name: 'Parent Agent',
   description: 'Take care in writing a good description here',
   instructions: `Instructions`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   agents: {
     subAgent,
   },
@@ -129,7 +129,7 @@ const subAgent = new Agent({
   name: 'Sub Agent',
   description: 'Take care in writing a good description here',
   instructions: `Instructions`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
 })
 ```
 
@@ -149,7 +149,7 @@ export const researchAgent = new Agent({
   instructions: `
       You are a research assistant.
       Use the research workflow to gather and compile information on topics.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   tools: {
     weatherTool,
   },

package/.docs/docs/evals/custom-scorers.md

@@ -44,7 +44,7 @@ const glutenCheckerScorer = createScorer({
   id: 'gluten-checker',
   description: 'Check if recipes contain gluten ingredients',
   judge: {                    // Optional: for prompt object steps
-    model: 'openai/gpt-5.1',
+    model: 'openai/gpt-5.4',
     instructions: 'You are a Chef that identifies if recipes contain gluten.'
   }
 })
@@ -71,7 +71,7 @@ const quoteSourcesScorer = createScorer({
   id: 'quote-sources',
   description: 'Check if the response includes sources',
   judge: {
-    model: 'openai/gpt-4.1-nano',
+    model: 'openai/gpt-5-mini',
     instructions: 'You are a strict evaluator.',
   },
 })
@@ -341,7 +341,7 @@ export const glutenCheckerScorer = createScorer({
   id: 'gluten-checker',
   description: 'Check if the output contains any gluten',
   judge: {
-    model: 'openai/gpt-4.1-nano',
+    model: 'openai/gpt-5-mini',
     instructions: GLUTEN_INSTRUCTIONS,
   },
 })
@@ -376,7 +376,7 @@ Sets up the LLM model and defines its role as a domain expert.
 
 ```typescript
 judge: {
-  model: 'openai/gpt-4.1-nano',
+  model: 'openai/gpt-5-mini',
   instructions: GLUTEN_INSTRUCTIONS,
 }
 ```

package/.docs/docs/evals/overview.md

@@ -57,11 +57,11 @@ import { createAnswerRelevancyScorer, createToxicityScorer } from '@mastra/evals
 export const evaluatedAgent = new Agent({
   scorers: {
     relevancy: {
-      scorer: createAnswerRelevancyScorer({ model: 'openai/gpt-4.1-nano' }),
+      scorer: createAnswerRelevancyScorer({ model: 'openai/gpt-5-mini' }),
       sampling: { type: 'ratio', rate: 0.5 },
     },
     safety: {
-      scorer: createToxicityScorer({ model: 'openai/gpt-4.1-nano' }),
+      scorer: createToxicityScorer({ model: 'openai/gpt-5-mini' }),
       sampling: { type: 'ratio', rate: 1 },
     },
   },

package/.docs/docs/mcp/overview.md

@@ -82,7 +82,7 @@ export const testAgent = new Agent({
       - US National Weather Service
 
       Answer questions using the information you find using the MCP Servers.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   tools: await testMcpClient.listTools(),
 })
 ```

package/.docs/docs/memory/memory-processors.md

@@ -45,7 +45,7 @@ const agent = new Agent({
   id: 'test-agent',
   name: 'Test Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -95,7 +95,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'semantic-agent',
   instructions: 'You are a helpful assistant with semantic memory',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -148,7 +148,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'working-memory-agent',
   instructions: 'You are an assistant with working memory',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -180,7 +180,7 @@ const customMessageHistory = new MessageHistory({
 const agent = new Agent({
   name: 'custom-memory-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new LibSQLStore({ id: 'memory-store', url: 'file:memory.db' }),
     lastMessages: 10, // This would normally add MessageHistory(10)
@@ -250,7 +250,7 @@ const contentBlocker = {
 const agent = new Agent({
   name: 'safe-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({ lastMessages: 10 }),
   // Your guardrail runs BEFORE memory saves
   outputProcessors: [contentBlocker],
@@ -289,7 +289,7 @@ const inputValidator = {
 const agent = new Agent({
   name: 'validated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({ lastMessages: 10 }),
   // Your guardrail runs AFTER memory loads history
   inputProcessors: [inputValidator],

package/.docs/docs/memory/semantic-recall.md

@@ -28,7 +28,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory(),
 })
 ```

package/.docs/docs/memory/storage.md

@@ -180,7 +180,7 @@ export const agent = new Agent({
   memory: new Memory({
     options: {
       generateTitle: {
-        model: 'openai/gpt-4o-mini',
+        model: 'openai/gpt-5-mini',
         instructions: 'Generate a 1 word title',
       },
     },

package/.docs/docs/memory/working-memory.md

@@ -26,7 +26,7 @@ const agent = new Agent({
   id: 'personal-assistant',
   name: 'PersonalAssistant',
   instructions: 'You are a helpful personal assistant.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -268,7 +268,7 @@ Schema-based working memory uses **merge semantics**, meaning the agent only nee
 ## Choosing between template and schema
 
 - Use a **template** (Markdown) if you want the agent to maintain memory as a free-form text block, such as a user profile or scratchpad. Templates use **replace semantics** — the agent must provide the complete memory content on each update.
-- Use a **schema** if you need structured, type-safe data that can be validated and programmatically accessed as JSON. Schemas use **merge semantics** — the agent only provides fields to update, and existing fields are preserved.
+- Use a **schema** if you need structured, type-safe data that can be validated and programmatically accessed as JSON. The `workingMemory.schema` field accepts any `PublicSchema`-compatible schema (including Zod v3, Zod v4, JSON Schema, or already-standard schemas). Schemas use **merge semantics** — the agent only provides fields to update, and existing fields are preserved.
 - Only one mode can be active at a time: setting both `template` and `schema` isn't supported.
 
 ## Example: Multi-step retention