docs(pydanticai): 10 source-verified class deep dives for v2.46.0

src/content/docs/pydanticai-guide/index.mdx

@@ -19,8 +19,8 @@ import { Card, CardGrid, LinkCard, Aside } from '@astrojs/starlight/components';
     ```
   </Card>
   <Card title="Version" icon="information">
-    **v2.43.0** · September 2026 · Python 3.10+
-    _Each page carries its own "verified against" stamp: the newest deep dives are on 2.43.0, the class reference on 2.33.0, and some older topic pages still sit on the 1.10x line._
+    **v2.46.0** · September 2026 · Python 3.10+
+    _Each page carries its own "verified against" stamp: the newest deep dives are on 2.46.0, the class reference on 2.33.0, and some older topic pages still sit on the 1.10x line._
   </Card>
   <Card title="Best for" icon="puzzle">
     Typed APIs, structured output, validated data pipelines, evals-driven agents.
@@ -97,6 +97,7 @@ import { Card, CardGrid, LinkCard, Aside } from '@astrojs/starlight/components';
   <LinkCard title="10 more class deep dives (Aug 2026 · v2.36.0)" href="./pydantic_ai_class_deep_dives_v2_36/" description="AgentRun, AgentRunResult, StreamedRunResult, ModelSettings, Tool, ToolDefinition, RunUsage/RequestUsage, ConcurrencyLimiter, MCPToolset, ApprovalRequiredToolset/DynamicToolset — verified against pydantic-ai 2.36.0." />
   <LinkCard title="10 class deep dives (Sep 2026 · v2.40.0)" href="./pydantic_ai_class_deep_dives_v2_40/" description="RealtimeSession, RealtimeModelSettings/TurnDetection, AgentRealtime, Capability, Hooks, TemplateStr, ExternalToolset, RetryConfig/HTTPX2TenacityTransport, DuckDuckGoSearchTool, ImageGenerationSubagentTool — verified against pydantic-ai 2.40.0." />
   <LinkCard title="10 class deep dives (Sep 2026 · v2.43.0)" href="./pydantic_ai_class_deep_dives_v2_43/" description="ToolFailed, RunCancelled, ToolSelector, ToolOrOutput, ServiceTier/ThinkingLevel, AgentStream/StreamedRunResult, SkipModelRequest/SkipToolValidation/SkipToolExecution, ToolDefinition.sequential, OutputContext, ApprovalRequired/DeferredToolRequests — verified against pydantic-ai 2.43.0." />
+  <LinkCard title="10 class deep dives (Sep 2026 · v2.46.0)" href="./pydantic_ai_class_deep_dives_v2_46/" description="FallbackModel, FunctionToolset, TextOutput/ToolOutput/NativeOutput/PromptedOutput, Embedder/EmbeddingResult, MCPToolset (FastMCP 4), load_mcp_toolsets, CombinedToolset, StructuredDict, ModelSettings lesser-known fields, AdvisorTool — verified against pydantic-ai 2.46.0." />
   <LinkCard title="Advanced patterns" href="./pydantic_ai_advanced_patterns/" />
   <LinkCard title="Error handling & testing" href="./pydantic_ai_advanced_error_testing/" />
   <LinkCard title="Hooks" href="./pydantic_ai_hooks/" description="Lifecycle callbacks: Hooks capability." />
@@ -134,7 +135,8 @@ Condensed version history (superseded the previous per-volume changelog — full
 | 2.33.0 | Aug 2026 | Consolidated [Class & API Reference](./pydantic_ai_comprehensive_guide/#class--api-reference) added to the comprehensive guide — 44 sprawling deep-dive volumes folded into 16 organised sections; guide version currency refreshed end-to-end |
 | 2.36.0 | Aug 2026 | New [10-class deep-dive page (v2.36.0)](./pydantic_ai_class_deep_dives_v2_36/) — `AgentRun`, `AgentRunResult`, `StreamedRunResult`, `ModelSettings`, `Tool`, `ToolDefinition`, `RunUsage`/`RequestUsage`, `ConcurrencyLimiter`/`ConcurrencyLimit`, `MCPToolset`, `ApprovalRequiredToolset`/`DynamicToolset`. |
 | 2.40.0 | Sep 2026 | New [10-class deep-dive page (v2.40.0)](./pydantic_ai_class_deep_dives_v2_40/) — `RealtimeSession`, `RealtimeModelSettings`/`TurnDetection`, `AgentRealtime`, `Capability`, `Hooks`, `TemplateStr`, `ExternalToolset`, `RetryConfig`/`HTTPX2TenacityTransport`, `DuckDuckGoSearchTool`, `ImageGenerationSubagentTool` — all source-verified with runnable examples. |
-| **2.43.0** | Sep 2026 | **Current.** New [10-class deep-dive page (v2.43.0)](./pydantic_ai_class_deep_dives_v2_43/) — `ToolFailed`, `RunCancelled`, `ToolSelector`, `ToolOrOutput`, `ServiceTier`/`ThinkingLevel`, `AgentStream`/`StreamedRunResult`, `SkipModelRequest`/`SkipToolValidation`/`SkipToolExecution`, `ToolDefinition.sequential`, `OutputContext`, `ApprovalRequired`/`DeferredToolRequests` — all source-verified with runnable examples. |
+| 2.43.0 | Sep 2026 | New [10-class deep-dive page (v2.43.0)](./pydantic_ai_class_deep_dives_v2_43/) — `ToolFailed`, `RunCancelled`, `ToolSelector`, `ToolOrOutput`, `ServiceTier`/`ThinkingLevel`, `AgentStream`/`StreamedRunResult`, `SkipModelRequest`/`SkipToolValidation`/`SkipToolExecution`, `ToolDefinition.sequential`, `OutputContext`, `ApprovalRequired`/`DeferredToolRequests` — all source-verified with runnable examples. |
+| **2.46.0** | Sep 2026 | **Current.** New [10-class deep-dive page (v2.46.0)](./pydantic_ai_class_deep_dives_v2_46/) — `FallbackModel` (response handlers), `FunctionToolset` (full constructor), `TextOutput`/`ToolOutput`/`NativeOutput`/`PromptedOutput` output quartet, `Embedder`/`EmbeddingResult`, `MCPToolset` FastMCP 4, `load_mcp_toolsets`, `CombinedToolset`, `StructuredDict`, `ModelSettings` lesser-known fields, `AdvisorTool` — all source-verified with runnable examples. |
 
 ## Install, minimal example
 
@@ -162,6 +164,7 @@ Condensed — one row per meaningfully distinct change to this index/guide pairi
 
 | Date | Framework version | Summary |
 |------|-------------------|---------|
+| 2026-09-21 | pydantic-ai 2.46.0 | Added `pydantic_ai_class_deep_dives_v2_46.md` — 10 source-verified deep dives for 2.46.0 (`FallbackModel` with response handlers, `FunctionToolset` full constructor, output quartet `TextOutput`/`ToolOutput`/`NativeOutput`/`PromptedOutput`, `Embedder`/`EmbeddingResult`, `MCPToolset` FastMCP 4 API, `load_mcp_toolsets`, `CombinedToolset`, `StructuredDict`, `ModelSettings` lesser-known fields, `AdvisorTool`). Sources read: `pydantic_ai/models/fallback.py`, `pydantic_ai/toolsets/function.py`, `pydantic_ai/output.py`, `pydantic_ai/embeddings/base.py`, `pydantic_ai/embeddings/__init__.py`, `pydantic_ai/mcp.py`, `pydantic_ai/toolsets/combined.py`, `pydantic_ai/settings.py`, `pydantic_ai/native_tools/__init__.py`. Version bumped from 2.43.0 → 2.46.0. Reference grid and changelog updated. |
 | 2026-09-14 | pydantic-ai 2.43.0 | Added `pydantic_ai_class_deep_dives_v2_43.md` — 10 source-verified deep dives for 2.43.0 (`ToolFailed`, `RunCancelled`, `ToolSelector`, `ToolOrOutput`, `ServiceTier`/`ThinkingLevel`, `AgentStream`/`StreamedRunResult`, `SkipModelRequest`/`SkipToolValidation`/`SkipToolExecution`, `ToolDefinition.sequential`, `OutputContext`, `ApprovalRequired`/`DeferredToolRequests`). Sources read: `pydantic_ai/exceptions.py`, `pydantic_ai/tools.py`, `pydantic_ai/settings.py`, `pydantic_ai/result.py`, `pydantic_ai/output.py`, `pydantic_ai/tool_manager.py`. Version bumped from 2.40.0 → 2.43.0. Comprehensive guide addendum and v2.40.0 cross-link added. |
 | 2026-09-07 | pydantic-ai 2.40.0 | Added `pydantic_ai_class_deep_dives_v2_40.md` — 10 source-verified deep dives for 2.40.0 (`RealtimeSession`, `RealtimeModelSettings`/`TurnDetection`, `AgentRealtime`, `Capability`, `Hooks`, `TemplateStr`, `ExternalToolset`, `RetryConfig`/`HTTPX2TenacityTransport`, `DuckDuckGoSearchTool`, `ImageGenerationSubagentTool`). Sources read: `pydantic_ai/realtime/_session.py`, `pydantic_ai/realtime/settings.py`, `pydantic_ai/agent/abstract.py`, `pydantic_ai/capabilities/capability.py`, `pydantic_ai/capabilities/hooks.py`, `pydantic_ai/template.py`, `pydantic_ai/toolsets/external.py`, `pydantic_ai/retries.py`, `pydantic_ai/common_tools/duckduckgo.py`, `pydantic_ai/common_tools/image_generation.py`. Version bumped from 2.36.0 → 2.40.0. |
 | 2026-08-31 | pydantic-ai 2.36.0 | Added `pydantic_ai_class_deep_dives_v2_36.md` — 10 more source-verified deep dives with runnable code examples (`AgentRun`, `AgentRunResult`, `StreamedRunResult`, `ModelSettings`, `Tool`, `ToolDefinition`, `RunUsage`/`RequestUsage`, `ConcurrencyLimiter`/`ConcurrencyLimit`, `MCPToolset`, `ApprovalRequiredToolset`/`DynamicToolset`). Linked from the Reference grid. Sources read: `pydantic_ai/run.py`, `pydantic_ai/result.py`, `pydantic_ai/settings.py`, `pydantic_ai/tools.py`, `pydantic_ai/usage.py`, `pydantic_ai/concurrency.py`, `pydantic_ai/mcp.py`, `pydantic_ai/toolsets/{approval_required,_dynamic}.py`. Version bumped from 2.33.0 → 2.36.0. |