NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #636 most downloaded on PyPI
Graph and state machine library
Latest stable
2.69.0
Last release 5 days ago
17 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
2 years old
340 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Make Advisor accept native= and local= like the other NativeOrLocalTool capabilities, deprecating mode by @adtyavrdhn in #13149
RequestInput into HandleDeferredToolCalls, whose handler can take a resume token by @DouweM in #13285gemini-4-hydrogen) on GoogleModel by @dsfaccini in #13299tool_call_ids_are_response_scoped profile flag by @DouweM in #13128service_tier support to GroqModel by @dsfaccini in #13521DetectLoops by @mpfaffenberger in #12222Advisor accept native= and local= like the other NativeOrLocalTool capabilities, deprecating mode by @adtyavrdhn in #13149ToolFailed calls as failed results by @pydanty in #13076DelegationTasks owner's memory by @DouweM in #13221ModelQuotaExceededError for Anthropic's tier spend cap and user-set spend limits by @dsfaccini in #13269GoogleModel.count_tokens as ModelAPIError by @dsfaccini in #13312GoogleImageGenerationModel.generate as its error category, like ModelRateLimitError by @dsfaccini in #13335ModelHTTPError by @dsfaccini in #13356GoogleModel batch methods as ModelHTTPError by @dsfaccini in #13327TextOutput function that takes a model, dataclass or TypedDict when the agent is created by @dsfaccini in #13422HTTPX2TenacityTransport and AsyncHTTPX2TenacityTransport gave up on by @dsfaccini in #13411OpenAIImageGenerationModel.generate as their error category, like ModelRateLimitError by @dsfaccini in #13433ModelRateLimitError by @dsfaccini in #13436ModelContextWindowExceededError for Mistral 3059 prompt-too-long errors, not for other 3051 invalid-argument errors by @pydanty in #12882ModelQuotaExceededError by @dsfaccini in #13485is_byok flag as a usage detail by @pydanty in #13025IMAGE_RECITATION and TOO_MANY_TOOL_CALLS finish reasons to content_filter and error by @pydanty in #10918TestModel integers satisfy mixed inclusive and exclusive bounds, and fractional bounds by @pydanty in #13298minimax_model_profile and use it for MiniMax models on Bedrock, OpenAICompatibleProvider, LiteLLMProvider and TogetherProvider by @pydanty in #12693thinking levels to its low/medium/high reasoning_effort values by @pydanty in #12876FunctionToolset's strict, sequential, defer_loading and include_return_schema defaults to Tool instances by @pydanty in #12572TestModel streamed usage match run() for tool calls and text by @pydanty in #11877count_tokens_before_request asks for in its own durable unit by @dsfaccini in #13460TieredCompaction tier on model errors, and let tiers omit their trigger by @mpfaffenberger in #13660subagents, filesystem and spend packages to their capability names and align store, ACP* and *Error class names by @mpfaffenberger in #13401DockerSandbox harness capability to DockerContainer, keeping DockerSandbox as a deprecated alias by @adtyavrdhn in #13245BubblewrapSandbox to BubblewrappedWorkspace and clarify its docs by @mpfaffenberger in #13179Coder's default instructions and add Coder(autonomy=...) by @mpfaffenberger in #12542RequestInput into HandleDeferredToolCalls, whose handler can take a resume token by @DouweM in #13285gemini-4-hydrogen) on GoogleModel by @dsfaccini in #13299is_retry to find retries in message history and list the v2.60.0 RetryPromptPart change as breaking by @DouweM in #11404Coder instructions into opt-in BenchmarkInstructions by @mpfaffenberger in #13395tool_call_ids_are_response_scoped profile flag by @DouweM in #13128Peers in pydantic-ai-harness by @dsfaccini in #11671anthropic_inference_geo setting for Anthropic data residency by @rscholz98 in #12769GraphBuilder.add_reachable() by @dsfaccini in #12706WindowsWorkspace, a PowerShell workspace for Windows hosts by @mpfaffenberger in #13475service_tier support to GroqModel by @dsfaccini in #13521KubernetesSandbox for kubernetes-sigs/agent-sandbox pods by @adtyavrdhn in #10612E2BSandbox(network=), passing E2B's network options through to a new sandbox by @adtyavrdhn in #13587BoxdSandbox(secrets=), naming the boxd secrets a new machine gets by @adtyavrdhn in #13589pin(source=) so harness compaction re-injects tool- and model-written pins as framed data, not the user's words by @mpfaffenberger in #13615Advisor.max_uses take a callable so a consultation budget can span several runs by @mpfaffenberger in #13617DynamicWorkflowToolset.create_executor so subclasses can customize how sub-agent calls are scheduled by @mpfaffenberger in #13623DetectLoops by @mpfaffenberger in #12222openai_safety_identifier model setting by @pydanty in #12258DaytonaSandbox(secrets=), mounting Daytona secrets in a new sandbox by @adtyavrdhn in #13590OpenSandbox(network_policy=) and OpenSandboxBackend(credential_proxy=), passing OpenSandbox's egress options through by @adtyavrdhn in #13591retry_after durably before DBOS retries a model request, via a shared model_error_retry_after helper by @DouweM in #13270CapabilityCreation.load_active(workspace), which refuses a store directory below 'operator' authority before loading it by @mpfaffenberger in #13641pydantic-ai-harness in MongoDB handshake driver metadata by @pydanty in #13394Reminder(skip_unchanged=True) so SystemReminders stops re-recording an unchanged lasting reminder by @mpfaffenberger in #13618ToolBudgets to answer over-budget and repeated tool calls instead of raising by @mpfaffenberger in #13646DynamicWorkflow(call_scheduler=) to decide when sub-agent calls start by @mpfaffenberger in #13668pin_accepted_files, capping the authority of accepted instruction files that have changed by @mpfaffenberger in #13677SubAgent(keep_partial_output=), passing a sub-agent's last text to the parent when its own timeout or usage budget stops it by @mpfaffenberger in #13696Advisor accept native= and local= like the other NativeOrLocalTool capabilities, deprecating mode by @adtyavrdhn in #13149authority and path_authority to the sandbox and SSHWorkspace capabilities by @DouweM in #13213when_to_use in the Skills catalog by @mpfaffenberger in #13619SmolSandbox commands' env variables named p or q from being overwritten by the launcher by @adtyavrdhn in #13248ToolFailed calls as failed results by @pydanty in #13076DelegationTasks owner's memory by @DouweM in #13221DynamicWorkflow sub-agents durably: in parallel under AWSLambdaDurability, and one at a time under DBOSDurability by @mpfaffenberger in #12710CodeMode(os_policy=...) to set the sandbox clock and time zone by @mpfaffenberger in #13277ToolOutputLimits by @mpfaffenberger in #13281SqliteMemoryStore by @mpfaffenberger in #13278BaseToolCallPart.args_as_dict under python -O by @dsfaccini in #13268ConversationStore.save from re-storing a serialized output tool conversation as a new branch every turn by @dsfaccini in #13272ModelQuotaExceededError for Anthropic's tier spend cap and user-set spend limits by @dsfaccini in #13269OpenAIResponsesModel runs from failing on a web_search_call without action, and read the reported web search count on newer openai SDKs by @dsfaccini in #13304MCPSamplingModel system prompt separator and conditional <system> announcement by @pydanty in #12488GoogleModel.count_tokens as ModelAPIError by @dsfaccini in #13312DecisionModel, and keep the capability catalog out of its question framing by @DouweM in #8759FallbackModel's rejected responses when an outer fallback handles the error it raises by @dsfaccini in #13325Dataset files, and drop the positional spec schema form for keyword-only parameters by @dsfaccini in #13332GoogleImageGenerationModel.generate as its error category, like ModelRateLimitError by @dsfaccini in #13335KeyError, and pass **kwargs and SkipJsonSchema argument values through by @dsfaccini in #13323ModelHTTPError by @dsfaccini in #13356GraphRun.next_task after a map over an empty list by @adtyavrdhn in #13357- in the MCP capability's derived id by @adtyavrdhn in #13358SpritesSandbox command timeout once its exec socket is open by @adtyavrdhn in #13360Advisor and SubAgents child runs without inherited count_tokens_before_request when their model cannot count tokens by @mpfaffenberger in #10139ctx.tracer from the worker agent inside Temporal activities so Memory tools run by @mpfaffenberger in #10199ModelRequestRejectedError for HTTP 413 by @adtyavrdhn in #13366{SetToolMetadata: [...]} and {SetToolMetadata: 'all'} agent spec short forms instead of failing by @dsfaccini in #13380$defs in zai.glm-5.3 tool and output schemas on Bedrock by @dsfaccini in #13187GoogleModel batch methods as ModelHTTPError by @dsfaccini in #13327register_tag's late-registration UserWarning by @dsfaccini in #12450DelegationTasks close without crashing on a cleanup timeout by @mpfaffenberger in #12972TextOutput function that takes a model, dataclass or TypedDict when the agent is created by @dsfaccini in #13422Dataset and AgentSpec JSON schemas match how a single dict- or model-typed spec parameter loads by @dsfaccini in #13423HTTPX2TenacityTransport and AsyncHTTPX2TenacityTransport gave up on by @dsfaccini in #13411TextOutput function by its aliased str parameter's Python name next to a SkipJsonSchema or **kwargs parameter by @dsfaccini in #13350tool_search_output returns wrapped in a NamespaceTool by @dsfaccini in #13473OpenAIImageGenerationModel.generate as their error category, like ModelRateLimitError by @dsfaccini in #13433ModelRateLimitError by @dsfaccini in #13436Field required by @dsfaccini in #13434AgentSpec JSON schema accept the NativeTool flat form {NativeTool: {kind: ...}} by @dsfaccini in #13469CompactionPart from OpenAIDecisionsModel as framed user text by @dsfaccini in #13478DBOSDurability and PrefectDurability by @adtyavrdhn in #13466AgentSpec and Dataset JSON schemas reject empty entries and string-keyed short forms that fail to load by @dsfaccini in Note truncated.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
…parent_task_id fields, keeping the old names as deprecated aliases by @mpfaffenberger in #13074
OutputTokenLimitExceeded, and fall back to the next model in ModelFallback when a response is cut off at max_tokens by @DouweM in #12407RequestInput, put AskUser on the deferred pipeline, and mark deferred calls with kind and answered_by by @DouweM in #12757DelegationTasks.discover() and stop one damaged saved task from blocking DelegationTasks.opened() by @mpfaffenberger in #10140WorkspaceBackendSuite by @mpfaffenberger in #13070PromptInjectionDefender semantic classification as durable operations so it works on Temporal by @mpfaffenberger in #12424Event suffix and past-participle names, with agent_name and parent_task_id fields, keeping the old names as deprecated aliases by @mpfaffenberger in #13074pydantic_ai_harness, renaming num_results to max_results and max_duration_secs to max_duration_seconds by @mpfaffenberger in #13075CapabilityEvent fields to *_count, *_name, duration_ms and previous_item, keeping the old names as deprecated aliases by @mpfaffenberger in #13068CapabilityEvent outliers to <Subject><PastParticiple>Event and add STEP_PERSISTENCE_EVENTS by @mpfaffenberger in #13065RefineOutput harness capability by @mpfaffenberger in #13120ConversationStore with conversation_store by @DouweM in #12326GoogleModel and BedrockConverseModel streams by @ddanielcruzz in #13168SubAgents delegations to durable delegates as Temporal and DBOS child workflows by @mpfaffenberger in #12516RefineOutput harness capability by @mpfaffenberger in #13120cwd to Workspace.run by @mpfaffenberger in #12642WorkspaceBackendSuite by @mpfaffenberger in #13070DelegationTasks.discover() and stop one damaged saved task from blocking DelegationTasks.opened() by @mpfaffenberger in #10140WorkspaceBackendSuite reattach rule by @mpfaffenberger in #13081RequestInput, put AskUser on the deferred pipeline, and mark deferred calls with kind and answered_by by @DouweM in #12757OutputTokenLimitExceeded, and fall back to the next model in ModelFallback when a response is cut off at max_tokens by @DouweM in #12407CancellationToken fired from a workflow signal to cancel a Temporal durable run by @DouweM in #7210GoogleDecisionsModel backend for the Gemini Decisions API by @dsfaccini in #13181vendor/model ids through one case-insensitive family map on OpenAICompatibleProvider, LiteLLMProvider and TogetherProvider by @DouweM in #12743thinking to reasoning_effort for Z.AI GLM and DeepSeek V3.2 on Bedrock by @EdAbati in #11491Permissions remembered approvals inside durable execution by @mpfaffenberger in #12410AnthropicModel.count_tokens send the request's betas and raise its all-deferred tools UserError by @dsfaccini in #13098AnthropicStaleThinkingBlockWarning, since Claude Fable 5.2 and Mythos 5.2 bind thinking blocks on every account by @dsfaccini in #13155PromptInjectionDefender semantic classification as durable operations so it works on Temporal by @mpfaffenberger in #12424ModelResponse.canonical_system through the Vercel AI and AG-UI event streams by @DouweM in #13134max_tokens above a Claude model's maximum output to it instead of sending it by @DouweM in #12427TieredCompaction can't reach target_tokens because its tiers keep more than the target by @DouweM in #12650SummarizingCompaction(keep_user_messages=True) copies displace instead of dropping them by @DouweM in #12652genai-prices floor to 0.2.3 so Anthropic fast mode responses are priced at fast mode rates by @dsfaccini in #13104Full Changelog: v2.67.0...v2.68.0
Support SubAgents(dynamic_agents=...) under durable execution by @mpfaffenberger in #12418
SubAgents(dynamic_agents=...) under durable execution by @mpfaffenberger in #12418ArtifactScanner phrase matching and flag hidden variation selectors by @mpfaffenberger in #11475RepoContext, add walk_up, and have Coder build on them by @DouweM in #11691RepoContext(nested_max_chars=...) by @DouweM in #11699mimetypes knows, with the format taken from it by @arjun-krishna1 in #12365provider_settings by @adtyavrdhn in #7807framing_announcement setting and only announce the <system> voice tag once a conversation needs it by @DouweM in #12661RepoContext instruction files when the model writes or edits in a directory by @DouweM in #11701InputGuardrail, OutputGuardrail and ToolGuardrail verdicts as durable operations by @mpfaffenberger in #12428CapabilityCreation run when directory is below 'operator' authority by @DouweM in #12558history_digest through openai_previous_response_id by @DouweM in #12575CodeMode tools named after Python builtins, which the sandbox called instead of the tool by @adtyavrdhn in #12698ModelProfile.may_tokenize_special_tokens_in_content by @DouweM in #12556serialization_failure for durable capability results by @maksimzayats in #11057FileSearchTool.max_num_results to OpenAI Responses by @adtyavrdhn in #12728UserError when validation requests approval for an external tool, keep single-model tool arguments through durable re-validation, and document concurrent DBOS runs and shared MCP http_clients by @dsfaccini in #12958StepPersistence tool call that ends in ModelRetry or ToolFailed as failed instead of leaving it started by @dsfaccini in #12638UserError from StreamedRunResult.result when a run_stream() run stops while finishing by @dsfaccini in #13087CodeMode remote sandboxes over gRPC with pydantic-monty 1.5.0 by @dmontagu in #12673httpx with httpx2 in pydantic-ai-harness by @Kludex in #13026KnownModelName and the provider model-name literals to the models a user would pick by @dsfaccini in #12817dequeue and set_enqueue_priority to change a message queued with enqueue before delivery by @adtyavrdhn in #12345SubAgents(dynamic_agents=...) under durable execution by @mpfaffenberger in #12418child_workflow tool metadata in DBOSDurability by @mpfaffenberger in #12445TrajectoryJudge evaluations as a durable operation when the judge has an id by @mpfaffenberger in #12414pydantic-ai in their gRPC user agent by @tamirdresher in #12493client to ModalSandbox and ModalSandboxBackend by @adtyavrdhn in #12501ArtifactScanner phrase matching and flag hidden variation selectors by @mpfaffenberger in #11475client to E2BSandbox and E2BSandboxBackend by @adtyavrdhn in #12500Workspace.authority_of by @DouweM in #12473openai_include_unmapped_response_data to keep Chat Completions response data Pydantic AI doesn't map by @DouweM in #12034RepoContext, add walk_up, and have Coder build on them by @DouweM in #11691RepoContext(nested_max_chars=...) by @DouweM in #11699fast and ultrafast service tiers in openai_service_tier by @adtyavrdhn in #12527mimetypes knows, with the format taken from it by @arjun-krishna1 in #12365KeenableSearch capability for keyless web research by @ilya-bogin-keenable in #9079gateway/bedrock:global.moonshotai.kimi-k3 and gateway/bedrock:global.moonshotai.kimi-k3.1 to KnownModelName by @dsfaccini in #12869web_search_20260318 and web_fetch_20260318 via provider_settings by @adtyavrdhn in #12610provider_settings by @adtyavrdhn in #7807SubAgents(task_control=...) under Temporal and DBOS durability by @mpfaffenberger in #12521gpt-image-2.6-flare and gpt-image-2.6-sunburst image models by @dsfaccini in #12820claude-fable-5-2) and Claude Mythos 5.2 (claude-mythos-5-2) support by @dsfaccini in #12970global.anthropic.claude-fable-5-2) and send per-message effort to it on OpenRouter by @dsfaccini in #13037gemini-4-carbon) on GoogleModel by @dsfaccini in #13057framing_announcement setting and only announce the <system> voice tag once a conversation needs it by @DouweM in #12661RepoContext instruction files when the model writes or edits in a directory by @DouweM in #11701InputGuardrail, OutputGuardrail and ToolGuardrail verdicts as durable operations by @mpfaffenberger in #12428crun 1.14.1 in DockerSandbox and build AsyncDaytona off the event loop by @adtyavrdhn in #12509Advisor, SmartSearch and ConversationSearch tool I/O as durable operations by @mpfaffenberger in #12415FallbackModel attempts in the usage BrowserUse reports to browser-use by @mpfaffenberger in #11879BoxdSandbox fields in the agent spec schema by @adtyavrdhn in #12518DaytonaSandbox fields in the agent spec schema by @adtyavrdhn in #12517RenderSandbox fields in the agent spec schema by @adtyavrdhn in #12520SpritesSandbox fields in the agent spec schema by @adtyavrdhn in #12519$ref key as JSON text, which Gemini otherwise rejects by @DouweM in #12429retry_after before retrying the model request activity by @DouweM in #12106NativeOutput or PromptedOutput text that fails validation, instead of retrying by @DouweM in #12406ModelQuotaExceededError for the Gemini API's daily quota and disabled billing, and Moonshot's exhausted balance by @DouweM in #12422SummarizingCompaction, SlidingWindowCompaction and RelevanceCompaction by recording them again as a ToolAvailabilityDeltaPart by @DouweM in #11773on_complete on the current OpenTelemetry span by @DouweM in #12541There is no current event loop on Python 3.12 and 3.13 by @DouweM in #12540max_tokens setting to DeepSeek as max_tokens instead of max_completion_tokens by @dsfaccini in #12385WebSearchTool from non-compound GroqModel profiles so web search fallbacks run by @dsfaccini in #12386UserError from JsonSchemaTransformer on nodes that are not JSON Schemas by @adtyavrdhn in #8620Shell job's log within max_log_bytes when the job ends as its log watcher starts by @dsfaccini in #12578RepoContext.home_dir spelled through a symlink by @dsfaccini in #12614FunctionSignature type one name and one definition in rendered tool catalogs by @adtyavrdhn in #12513ClampOversizedMessages and ClearToolResults edits without the item ID that makes OpenAI Responses ignore them by @DouweM in #12561CapabilityCreation run when directory is below 'operator' authority by @DouweM in #12558history_digest through openai_previous_response_id by @DouweM in #12575CodeMode and IPythonCodeMode by @dmontagu in #12669CodeMode tools named after Python builtins, which the sandbox called instead of the tool by @adtyavrdhn in #12698max_retries raising a TypeError on AsyncAnthropicBedrock clients with anthropic 2.6 by @dsfaccini in #12707google-genai<3 so fresh installs keep GoogleModel on the v1beta Gemini API by @dsfaccini in #12700event_stream_handler the recorded events by @dsfaccini in #12675FileSystem search_files patterns whose repeat count overflows re, such as a{99999999999}, instead of aborting the run by @dsfaccini in #12726Shell job's supervisor and log watcher outliving a command that removes its job directory by @dsfaccini in #12730ModelProfile.may_tokenize_special_tokens_in_content by @DouweM in #12556CerebrasProvider reasoning flags for Qwen 3.8, Kimi K3 and GLM-5.3 by @DouweM in #12746CodeMode setup errors to callers, correct timeout advice, and reset local and remote sessions after memory/output limits by @dmontagu in #12689SpritesSandboxBackend.run raising a TypeError for a non-number timeout by @dsfaccini in #12729Shell job supervisor hang when a command removes its job directory or makes it read-only by @dsfaccini in #12814User-Agent header on Google requests by @dsfaccini in #12583Shell job whose command makes its job directory read-only, and stop it without a retry by @dsfaccini in #12830Shell failing to stop a macOS job whose process group holds only zombies, and keep a failed call's own error when its stop fails too by @dsfaccini in #12858gh-aw engine putting the checkout on sys.path ahead of installed packages by @dsfaccini in #12818serialization_failure for durable capability results by @maksimzayats in #11057FileSearchTool.max_num_results to OpenAI Responses by @adtyavrdhn in #12728extra_headers user-agent in any spelling in place of ours on OpenAI, Anthropic and Groq requests by @dsfaccini in #12871anthropic-beta header from extra_headers with the other Anthropic betas however its name is capitalized by @dsfaccini in #12875extra_headers as one header line on Google requests by @dsfaccini in #12877default_headers betas with ours, and accept a user-agent in batch extra_headers in any spelling by @dsfaccini in #12878UserError when validation requests approval for an external tool, keep single-model tool arguments through durable re-validation, and document concurrent DBOS runs and shared MCP http_clients by @dsfaccini in #12958thinking=False on more OpenRouter mandatory-reasoning routes by @DouweM in #12744$defs in gpt-oss tool schemas by @DouweM in #12759ToolOutput for gpt-oss on BedrockMantleProvider by not forcing tool_choice by @DouweM in #12761::ffff:0:0:0/96, 100:0:0:1::/64, 2001:2::/48, 3fff::/20 and 5f00::/16 as private addresses by @dsfaccini in #12953shell foreground wait replay the same workspace calls under durable execution by @mpfaffenberger in #12978task_backgrounded for a background task that settles before delegate_task resumes, as on durable replay by @dsfaccini in #13008tool_call_id on the tool call arguments the special-token restorer sends when a stream ends by @dsfaccini in #13062ModelAPIError.retry_after from Gemini's RetryInfo.retryDelay by Note truncated.
GHSA-m5vj-8mcw-82qx (high): web_fetch_tool and the WebFetch capability's local fallback re-indented a JSON response on the event loop before applying
web_fetch_tool and the WebFetch capability's local fallback re-indented a JSON response on the event loop before applying the returned-content limit, so a deeply nested document within the download size limit could expand to hundreds of times its size, using large amounts of memory and delaying other work in the same process. You are affected if an attacker can choose or influence the URLs the tool fetches. Provider-native web fetching is not affected. Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim).private_key pattern in Pydantic AI Harness's secret redaction backtracked exponentially on crafted text, so a few hundred characters that begin like a private key could occupy the event loop for minutes or longer. You are affected if you use redact_secrets or secret_data() with the private_key pattern, which is included by default, on text an attacker can influence. Fixed in pydantic-ai-harness 0.66.0.169.254.0.23, so someone who can supply a URL the application downloads could have it fetch the instance's temporary role credentials. You are affected if you run on Tencent Cloud and allow local URLs, through force_download='allow-local' on a FileUrl or web_fetch_tool(allow_local_urls=True). Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim).extra_headers and extra_body embedding settings, so credentials passed through them could be read by anyone with access to the exported traces. You are affected if you instrument embedding models and pass secrets through those settings. Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim). Restrict access to historical traces and rotate credentials they exposed.$defs and $ref, a small tool schema whose definitions reference one another repeatedly expanded exponentially when inlined on the event loop, which can take minutes of CPU time and gigabytes of memory. You are affected if you serve such a model through the AG-UI adapter, where clients submit their own frontend tool schemas. Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim).DecisionModel subclasses such as OpenAIDecisionsModel, and TypeSafeModel) resolved every $ref in a tool's argument schema again at each place it appears, so a small crafted schema could take exponential time and memory on the event loop. You are affected if you use a decision model from v2.46.0 onward with tools whose schemas an attacker can supply, most directly through an AG-UI endpoint. Fixed in v2.66.0 (pydantic-ai, pydantic-ai-slim).VercelAIAdapter or AGUIAdapter. Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim).s3:// object or uploaded file with the application's credentials. You are affected if tool results can contain data third parties control, that history is stored and reloaded, held on the server by a UI adapter, or carried by Temporal, DBOS or Prefect durable execution, and your model or its provider fetches or resolves such files; the advisory lists which do. Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim).allowed_domains on the local web-fetch tool, and PlaywrightBrowser egress policies whose allowlist bounds every request kind, looked a refused hostname up in DNS before rejecting it, so data encoded in the hostname could reach that domain's nameserver. Domain lists are now checked before resolution. You are affected only if you rely on such an allowlist while the model processes content untrusted parties can influence. Fixed in v2.66.0 and v1.107.10 (pydantic-ai, pydantic-ai-slim), and pydantic-ai-harness 0.66.0.MCP capability configured with a server URL and no explicit id derived its identifier from the URL's hostname and last path segment, and the AG-UI and Vercel AI adapters sent that identifier to the frontend with MCP Apps tool results, so a credential in that segment could reach users of the chat frontend. This affects v2.57.0 up to but not including v2.60.0, and was fixed in v2.60.0; it is disclosed with this batch. Rotate MCP server credentials that were carried in the URL path.20260209 web tools directly on the Anthropic API when citations are requested by @dsfaccini in #12278FunctionToolset(requires_approval=True) to Tool instances passed to the toolset by @dsfaccini in #12378SummarizingCompaction(keep_user_messages=True) copies only by the marker on their text by @DouweM in #12316OpenSandbox for self-hosted agent workspaces by @adtyavrdhn in #11841pydantic_ai_harness by @DouweM in #11332Pixeltable tools and memory storage to Harness by @pierrebrunelle in #9369RenderSandbox to run agent workspaces in Render sandboxes by @ojusave in #10238include_instructions to the MCP capability so server instructions can be left out of the agent's instructions by @DouweM in #12269segment timestamps with output_speech_timestamps by @DouweM in #11782retries field to SummarizingCompaction by @gouyu-hou in #12315Workspace.authority and AuthorityWorkspace for workspaces whose files the operator does not control by @adtyavrdhn in #11836ModalSandbox failing with AttributeError on Modal 1.6, which removed FilesystemExecutionError by @adtyavrdhn in #1224720260209 web tools directly on the Anthropic API when citations are requested by @dsfaccini in #12278CohereModel by @Julien-ser in #6100tool_search and load_capability message history by @pydanty in #7933$defs in tool schemas for GLM-5.3 on Together, Nebius, Fireworks, Vercel, Ollama, Hugging Face, Cerebras, Mistral and OpenAI-compatible gateways by @pydanty in #12138RepoContext from following symlinks out of the working directory or to files that aren't instruction files by @DouweM in #12044manage_message_history='server' by @DouweM in #12313FunctionToolset(requires_approval=True) to Tool instances passed to the toolset by @dsfaccini in #12378SummarizingCompaction(keep_user_messages=True) copies only by the marker on their text by @DouweM in #12316SummarizingCompaction, SlidingWindowCompaction and RelevanceCompaction, recording every removed load again as a CapabilityLoadDeltaPart by @DouweM in #12270openai_chat_send_back_thinking_parts='field' mode by @DouweM in #12309RepairToolArguments repairs back to the ToolCallPart in history by @DouweM in #12319AnthropicModel.compact_messages()'s focus prompt by @DouweM in #11915SqliteStepStore and SqliteMediaStore connections whose WAL switch fails on a locked database by @DouweM in #12147embeddings attribute when include_content=True by @pydanty in #8295OpenAIChatModel's batch hint, OpenAI realtime models and harness Advisor on provider names by @DouweM in #11796Full Changelog: v2.65.0...v2.66.0
Protect the gh-aw canonical session capture from agent tools by @dsfaccini in #10606
gh-aw canonical session capture from agent tools by @dsfaccini in #10606AskUserAnswer by @dsfaccini in #11664BrowserUse model calls toward the host run's usage and UsageLimits by @mpfaffenberger in #11860OpenAIModel or MCPServerStdio by @DouweM in #12035ModelFallback when a model refuses, and let ContentFilterError in fallback_on match refusals by @DouweM in #12039ModelQuotaExceededError instead of ModelRateLimitError for Z.ai balance and plan-limit 429s by @DouweM in #12042'12h' prompt cache retention on the OpenAI Responses API for GPT-5.6 and later by @DouweM in #12046non_retryable_model_errors by @DouweM in #12107ConversationStore, which keeps a conversation as a log of messages stored once, and Conversation.revision to catch conflicting saves by @DouweM in #10658AskUserAnswer by @dsfaccini in #11664anthropic_web_tools_allowed_callers to set allowed_callers on Anthropic's web tools by @aweis89 in #10489'12h' prompt cache retention on the OpenAI Responses API for GPT-5.6 and later by @DouweM in #12046OpenAIModel or MCPServerStdio by @DouweM in #12035ModelFallback when a model refuses, and let ContentFilterError in fallback_on match refusals by @DouweM in #12039ModelContextWindowExceededError and ModelQuotaExceededError for Bedrock errors on AsyncAnthropicBedrock by @DouweM in #12040ContentFilterError instead of TypeError when Azure filters a streamed OpenAIChatModel prompt by @DouweM in #12041RepoContext instruction files after compaction, and stop repeating notes still in history by @DouweM in #11704ContentFilterError when the provider also reports a finish reason by @DouweM in #12036ModelQuotaExceededError instead of ModelRateLimitError for Z.ai balance and plan-limit 429s by @DouweM in #12042gh-aw canonical session capture from agent tools by @dsfaccini in #10606PlaywrightBrowser's Chromium and driver when an anyio scope cancels a run by @dsfaccini in #12047Coder to match the surrounding code's style instead of applying SOLID by @mpfaffenberger in #12120Coder tool's error to the model once its retries run out instead of ending the run by @mpfaffenberger in #12121*args and **kwargs docstring descriptions on tool parameters by @Aryapatel-007 in #12126Keyword Args and Other Parameters docstring sections by @roydonsequeira in #10035aws_lambda agent loop finish its own cleanup at the grace deadline by @dsfaccini in #12140auth='' as unset alongside client in GitHub, Notion, Ordinal, PostHog, Pylon, and Slack by @mpfaffenberger in #11852BrowserUse model calls toward the host run's usage and UsageLimits by @mpfaffenberger in #11860FileSystem tools emit their events under PrefixTools by @mpfaffenberger in #11867cache='1h' to Claude Haiku 5.5 on Bedrock instead of snapping it to '5m' by @DouweM in #12045<context> elements in user and tool content as not from the application by @DouweM in #12050ContentFilterError or a UserError subclass by @DouweM in #12105non_retryable_model_errors by @DouweM in #12107close() workaround and require daytona>=0.226.1 by @mislavivanda in #11977Full Changelog: v2.64.0...v2.65.0
<!-- Release notes generated using configuration in .github/release.yml at a56a6d6f138d1e3a9c45a9697ea513bef47a6cea -->
gh-aw canonical session capture from agent tools by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/10606AskUserAnswer by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11664BrowserUse model calls toward the host run's usage and UsageLimits by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11860OpenAIModel or MCPServerStdio by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12035ModelFallback when a model refuses, and let ContentFilterError in fallback_on match refusals by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12039ModelQuotaExceededError instead of ModelRateLimitError for Z.ai balance and plan-limit 429s by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12042'12h' prompt cache retention on the OpenAI Responses API for GPT-5.6 and later by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12046non_retryable_model_errors by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12107ConversationStore, which keeps a conversation as a log of messages stored once, and Conversation.revision to catch conflicting saves by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10658AskUserAnswer by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11664anthropic_web_tools_allowed_callers to set allowed_callers on Anthropic's web tools by @aweis89 in https://github.com/pydantic/pydantic-ai/pull/10489'12h' prompt cache retention on the OpenAI Responses API for GPT-5.6 and later by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12046OpenAIModel or MCPServerStdio by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12035ModelFallback when a model refuses, and let ContentFilterError in fallback_on match refusals by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12039ModelContextWindowExceededError and ModelQuotaExceededError for Bedrock errors on AsyncAnthropicBedrock by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12040ContentFilterError instead of TypeError when Azure filters a streamed OpenAIChatModel prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12041RepoContext instruction files after compaction, and stop repeating notes still in history by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11704ContentFilterError when the provider also reports a finish reason by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12036ModelQuotaExceededError instead of ModelRateLimitError for Z.ai balance and plan-limit 429s by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12042gh-aw canonical session capture from agent tools by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/10606PlaywrightBrowser's Chromium and driver when an anyio scope cancels a run by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/12047Coder to match the surrounding code's style instead of applying SOLID by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/12120Coder tool's error to the model once its retries run out instead of ending the run by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/12121*args and **kwargs docstring descriptions on tool parameters by @Aryapatel-007 in https://github.com/pydantic/pydantic-ai/pull/12126Keyword Args and Other Parameters docstring sections by @roydonsequeira in https://github.com/pydantic/pydantic-ai/pull/10035aws_lambda agent loop finish its own cleanup at the grace deadline by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/12140auth='' as unset alongside client in GitHub, Notion, Ordinal, PostHog, Pylon, and Slack by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11852BrowserUse model calls toward the host run's usage and UsageLimits by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11860FileSystem tools emit their events under PrefixTools by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11867cache='1h' to Claude Haiku 5.5 on Bedrock instead of snapping it to '5m' by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12045<context> elements in user and tool content as not from the application by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12050ContentFilterError or a UserError subclass by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12105non_retryable_model_errors by @DouweM in https://github.com/pydantic/pydantic-ai/pull/12107close() workaround and require daytona>=0.226.1 by @mislavivanda in https://github.com/pydantic/pydantic-ai/pull/11977Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v2.64.0...v2.65.0
<!-- Release notes generated using configuration in .github/release.yml at cde1d10f88ce6d0ab4743e226d51a9ac65810f50 -->
<!-- Release notes generated using configuration in .github/release.yml at cde1d10f88ce6d0ab4743e226d51a9ac65810f50 -->
ModelHTTPError, so fallback moves on by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11934Model.accepts_server_state by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11774json-repair an optional dependency, needed only by Coder and RepairToolArguments by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11768Coder's tools by default, with Coder(strict=True) to opt in by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11743RepoContext instruction file between a traversed path and the working directory, without repeating the root file by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11687output_speech_timestamps to report word timing of realtime speech, on Azure AI Voice Live by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11685ModelFallback capability constructible from agent specs by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11679first_event_timeout model setting so a stream that never starts can fall back by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11582OnlineEvaluation evaluators once per durable run instead of on every replay by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11577Planning plan in the plan tools' results instead of a per-request reminder copy by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11521Memory and Skills with ArtifactScanner by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11470AnthropicModel.count_tokens rejecting all-deferred tool requests and undercounting server tools on the Anthropic API by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11343pydantic_evals by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/10292RealtimeEvent from pydantic_ai.agent.__all__ by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/10189RunContext.load_capability to load on-demand capabilities from code by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/10090ModelFallback capability, a per-attempt prepare_model_request hook, and RetryModelRequest by @DouweM in https://github.com/pydantic/pydantic-ai/pull/9348@agent.system_prompt(dynamic=True) append its changes with on_change='append' to keep the cached prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11445DetectLoops tool results with the response that made the calls by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11551BoxdSandbox: a workspace that runs Coder, Shell, FileSystem and every other harness capability in a boxd machine by @MichielMAnalytics in https://github.com/pydantic/pydantic-ai/pull/11367ModelFallback capability, a per-attempt prepare_model_request hook, and RetryModelRequest by @DouweM in https://github.com/pydantic/pydantic-ai/pull/9348Reminder(scope='conversation') for reminders that stay in the message history by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11642output_speech_timestamps to report word timing of realtime speech, on Azure AI Voice Live by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11685ModelRequestContext durable capability operations across agent construction by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11776ModelFallback capability constructible from agent specs by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11679output_speech_timestamps by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11784vcs.* and cicd.* attributes by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/10294pydantic_evals by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/10292logfire.scorer.score_type and logfire.scorer.run_id to online evaluation result events by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/10293test.suite.name and test.case.name attributes to Pydantic Evals spans by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/11538Coder's tools by default, with Coder(strict=True) to opt in by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11743json-repair an optional dependency, needed only by Coder and RepairToolArguments by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11768Coder to read what the task names, check stated requirements, and delegate only when asked by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11811AskUser answerers receive RunContext by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11662Memory and Skills with ArtifactScanner by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11470ModelResponse.model_id recording the model the agent sent each request to by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11807Dataset files under the function's name by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/10425RepoContext instructions when nested_traversal is on by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11698first_event_timeout model setting so a stream that never starts can fall back by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11582sticky to ModelFallback to keep a conversation on the fallback model that answered by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11330RunContext.load_capability to load on-demand capabilities from code by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/10090SpanTree attributes during JSON round-trips and mark omitted Google embedding and ElevenLabs usage as unmeasured to avoid false zero automatic costs by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11912botocore predates outputConfig by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11694IPythonKernel client's zmq context on shutdown with jupyter-client before 8.7 by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11716CodeMode Tool Search corpus with search_tools, so a native deferred tool no longer declares the sandboxed ones by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11638Planning plan in the plan tools' results instead of a per-request reminder copy by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11521OnlineEvaluation evaluators once per durable run instead of on every replay by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11577AnthropicModel.count_tokens rejecting all-deferred tool requests and undercounting server tools on the Anthropic API by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11343CodeExecutionTool on the Bedrock AnthropicModel clients by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11790cache setting for GPT-5.6 and later with the Azure OpenAI v1 API by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11749Shell's job files in a private temp directory when the workspace isn't writable by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11809$refs under propertyNames and contains for OpenRouter Google models and custom prefer_inlined_defs transformers by @jukebox in https://github.com/pydantic/pydantic-ai/pull/10859BedrockJsonSchemaTransformer by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/11831RealtimeEvent from pydantic_ai.agent.__all__ by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/10189BackgroundTools results in the history when a run pauses for deferred tools by @wangrat in https://github.com/pydantic/pydantic-ai/pull/11752FileSystem edit_file edit non-UTF-8 text files that read_file reads, honoring expected_hash by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11851SubAgents children that share usage run under the parent's usage_limits by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11853AgentSpec schema fields for Advisor, SummarizingCompaction, ManagedPrompt and PyaiDocs by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11857asyncpg pool type-check as PostgresMemoryStore's PostgresPool by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11856AbstractCapability base fields id, description and defer_loading by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11858AgentSpec schema fields for CodeMode, ModalSandbox, and Skills by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11859SubAgents under Temporal for a named agent with its own model and self with a model menu by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11862prefix_tools() by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11863result.usage() warn instead of raising TypeError by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11884content from OpenAI-compatible Chat Completions servers by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11885BedrockConverseModel call or stream read when its request is cancelled or times out by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11850SystemPromptParts visible: false in OTel spans of requests the model no longer sees them on by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11772Model.accepts_server_state by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11774system entry on Claude Haiku 5.5, so it doesn't read the entry as tool output by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11785ModelResponse.canonical_system through Vercel AI and AG-UI message round-trips by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11794FileUnderstanding, and let prepare_model_request persist history changes by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11802RepoContext instruction files above the working directory as ../AGENTS.md instead of by absolute path by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11689on_run_error, shielded capability cleanup and the model stream close run when an anyio scope cancels a run by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/10479DynamicWorkflow sub-agents under the parent run's usage_limits instead of the 50-request default by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11962web_fetch leaking script/style source into markdown content by @pydanty[bot] in https://github.com/pydantic/pydantic-ai/pull/8329StepPersistence failure records when an anyio scope cancels a run by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11993max_retries in OpenAI, Anthropic and Gemini batch requests instead of raising UserError by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11931ModelHTTPError, so fallback moves on by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11934RepoContext instruction file between a traversed path and the working directory, without repeating the root file by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11687Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v2.63.0...v2.64.0
ModelHTTPError, so fallback moves on by @DouweM in #11934Model.accepts_server_state by @DouweM in #11774json-repair an optional dependency, needed only by Coder and RepairToolArguments by @mpfaffenberger in #11768Coder's tools by default, with Coder(strict=True) to opt in by @mpfaffenberger in #11743RepoContext instruction file between a traversed path and the working directory, without repeating the root file by @DouweM in #11687output_speech_timestamps to report word timing of realtime speech, on Azure AI Voice Live by @DouweM in #11685ModelFallback capability constructible from agent specs by @DouweM in #11679first_event_timeout model setting so a stream that never starts can fall back by @DouweM in #11582OnlineEvaluation evaluators once per durable run instead of on every replay by @DouweM in #11577Planning plan in the plan tools' results instead of a per-request reminder copy by @DouweM in #11521Memory and Skills with ArtifactScanner by @mpfaffenberger in #11470AnthropicModel.count_tokens rejecting all-deferred tool requests and undercounting server tools on the Anthropic API by @dsfaccini in #11343pydantic_evals by @dmontagu in #10292RealtimeEvent from pydantic_ai.agent.__all__ by @adtyavrdhn in #10189RunContext.load_capability to load on-demand capabilities from code by @adtyavrdhn in #10090ModelFallback capability, a per-attempt prepare_model_request hook, and RetryModelRequest by @DouweM in #9348@agent.system_prompt(dynamic=True) append its changes with on_change='append' to keep the cached prompt by @DouweM in #11445DetectLoops tool results with the response that made the calls by @mpfaffenberger in #11551BoxdSandbox: a workspace that runs Coder, Shell, FileSystem and every other harness capability in a boxd machine by @MichielMAnalytics in #11367ModelFallback capability, a per-attempt prepare_model_request hook, and RetryModelRequest by @DouweM in #9348Reminder(scope='conversation') for reminders that stay in the message history by @DouweM in #11642output_speech_timestamps to report word timing of realtime speech, on Azure AI Voice Live by @DouweM in #11685ModelRequestContext durable capability operations across agent construction by @DouweM in #11776ModelFallback capability constructible from agent specs by @DouweM in #11679output_speech_timestamps by @DouweM in #11784vcs.* and cicd.* attributes by @dmontagu in #10294pydantic_evals by @dmontagu in #10292logfire.scorer.score_type and logfire.scorer.run_id to online evaluation result events by @dmontagu in #10293test.suite.name and test.case.name attributes to Pydantic Evals spans by @dmontagu in #11538Coder's tools by default, with Coder(strict=True) to opt in by @mpfaffenberger in #11743json-repair an optional dependency, needed only by Coder and RepairToolArguments by @mpfaffenberger in #11768Coder to read what the task names, check stated requirements, and delegate only when asked by @mpfaffenberger in #11811AskUser answerers receive RunContext by @dsfaccini in #11662Memory and Skills with ArtifactScanner by @mpfaffenberger in #11470ModelResponse.model_id recording the model the agent sent each request to by @DouweM in #11807Dataset files under the function's name by @dmontagu in #10425RepoContext instructions when nested_traversal is on by @DouweM in #11698first_event_timeout model setting so a stream that never starts can fall back by @DouweM in #11582sticky to ModelFallback to keep a conversation on the fallback model that answered by @DouweM in #11330RunContext.load_capability to load on-demand capabilities from code by @adtyavrdhn in #10090SpanTree attributes during JSON round-trips and mark omitted Google embedding and ElevenLabs usage as unmeasured to avoid false zero automatic costs by @dsfaccini in #11912botocore predates outputConfig by @DouweM in #11694IPythonKernel client's zmq context on shutdown with jupyter-client before 8.7 by @DouweM in #11716CodeMode Tool Search corpus with search_tools, so a native deferred tool no longer declares the sandboxed ones by @DouweM in #11638Planning plan in the plan tools' results instead of a per-request reminder copy by @DouweM in #11521OnlineEvaluation evaluators once per durable run instead of on every replay by @DouweM in #11577AnthropicModel.count_tokens rejecting all-deferred tool requests and undercounting server tools on the Anthropic API by @dsfaccini in #11343CodeExecutionTool on the Bedrock AnthropicModel clients by @DouweM in #11790cache setting for GPT-5.6 and later with the Azure OpenAI v1 API by @DouweM in #11749Shell's job files in a private temp directory when the workspace isn't writable by @mpfaffenberger in #11809$refs under propertyNames and contains for OpenRouter Google models and custom prefer_inlined_defs transformers by @jukebox in #10859BedrockJsonSchemaTransformer by @adtyavrdhn in #11831RealtimeEvent from pydantic_ai.agent.__all__ by @adtyavrdhn in #10189BackgroundTools results in the history when a run pauses for deferred tools by @wangrat in #11752FileSystem edit_file edit non-UTF-8 text files that read_file reads, honoring expected_hash by @mpfaffenberger in #11851SubAgents children that share usage run under the parent's usage_limits by @mpfaffenberger in #11853AgentSpec schema fields for Advisor, SummarizingCompaction, ManagedPrompt and PyaiDocs by @mpfaffenberger in #11857asyncpg pool type-check as PostgresMemoryStore's PostgresPool by @mpfaffenberger in #11856AbstractCapability base fields id, description and defer_loading by @mpfaffenberger in #11858AgentSpec schema fields for CodeMode, ModalSandbox, and Skills by @mpfaffenberger in #11859SubAgents under Temporal for a named agent with its own model and self with a model menu by @mpfaffenberger in #11862prefix_tools() by @mpfaffenberger in #11863result.usage() warn instead of raising TypeError by @DouweM in #11884content from OpenAI-compatible Chat Completions servers by @DouweM in #11885BedrockConverseModel call or stream read when its request is cancelled or times out by @DouweM in #11850SystemPromptParts visible: false in OTel spans of requests the model no longer sees them on by @DouweM in #11772Model.accepts_server_state by @DouweM in #11774system entry on Claude Haiku 5.5, so it doesn't read the entry as tool output by @DouweM in #11785ModelResponse.canonical_system through Vercel AI and AG-UI message round-trips by @DouweM in #11794FileUnderstanding, and let prepare_model_request persist history changes by @DouweM in #11802RepoContext instruction files above the working directory as ../AGENTS.md instead of by absolute path by @DouweM in #11689on_run_error, shielded capability cleanup and the model stream close run when an anyio scope cancels a run by @dsfaccini in #10479DynamicWorkflow sub-agents under the parent run's usage_limits instead of the 50-request default by @mpfaffenberger in #11962web_fetch leaking script/style source into markdown content by @pydanty[bot] in #8329StepPersistence failure records when an anyio scope cancels a run by @dsfaccini in #11993max_retries in OpenAI, Anthropic and Gemini batch requests instead of raising UserError by @DouweM in #11931ModelHTTPError, so fallback moves on by @DouweM in #11934RepoContext instruction file between a traversed path and the working directory, without repeating the root file by @DouweM in #11687Full Changelog: v2.63.0...v2.64.0
<!-- Release notes generated using configuration in .github/release.yml at e2fbcf609852600e2f2e2eabb18c0b233c49a937 -->
<!-- Release notes generated using configuration in .github/release.yml at e2fbcf609852600e2f2e2eabb18c0b233c49a937 -->
CodeMode to dynamic_catalog=True, so a revealed tool is appended instead of rewriting the cached prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11358GoogleRealtimeConnection's dial as a keyword-only replay argument by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11515LLMReminder a default interval=10 instead of generating on every request by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11641canonical_system by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11504CombinedCapability load as one capability, with members keeping their global ordering by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/10321<system> tag means and escape it in user and tool text on models without mid-conversation system messages by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11506task_timeout to Dataset.evaluate to bound each task attempt by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/10291ag-ui-protocol 1.0 by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/8627CodeMode to dynamic_catalog=True, so a revealed tool is appended instead of rewriting the cached prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11358GoogleRealtimeConnection's dial as a keyword-only replay argument by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11515gpt-6.1-terra model support by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11393IPythonCodeMode) alongside the Monty-based CodeMode by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11570LLMReminder a default interval=10 instead of generating on every request by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11641DetectLoops capability to interrupt repeated-action loops by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11471manage_message_history to UI adapters so a server-held history isn't sent to the model twice by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11431pydantic_ai.framing module with wrap, neutralize_tags and register_tag, so extensions can frame their own tags by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10957canonical_system by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11504PostgresSpendStore so harness SpendLimits budgets can be shared through PostgreSQL by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11527CombinedCapability load as one capability, with members keeping their global ordering by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/10321CodeMode run_code description by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11459mistralai>=3.1.0 and drop the legacy httpx import so MistralModel imports on fresh installs by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/11549too_many_requests Responses failures on openai>=3.32.0 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11532ToolOutputLimits spill writes in a durable_operation so replays do not write them again by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11460before_model_request hook sent when it rewrote the history with a copy of the request by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11501before_model_request hook loaded it by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11516BackgroundTools, RepoContext, TrajectoryJudge and Planning frames by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11530thinking change after an unanswered ModelSettingsDeltaPart instead of replacing it, so UI streams and hook-rebuilt requests keep it by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11514gemini-robotics-er realtime models see the image sent just before them by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11484PendingModelResponse by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11517AsyncAnthropicBedrockMantle on Claude Opus 5.5 by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11486AsyncAnthropicBedrockMantle by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11487AdvisorTool on AsyncAnthropicBedrockMantle, which rejects it by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11488CodeMode REPL state when repl_store load fails, instead of saving a fresh REPL over it by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11483RuntimeError: coroutine ignored GeneratorExit and an escaping KeyboardInterrupt on Agent.iter() teardown by @pydanty in https://github.com/pydantic/pydantic-ai/pull/10258wrap_run or on_run_error recovery result from run_stream() instead of raising AgentRunError by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11571<system> tag means and escape it in user and tool text on models without mid-conversation system messages by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11506SummarizingCompaction summarizer transcript by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11583allowed_patterns on the real path when search_files targets a single symlinked file by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11639None type arguments in Dataset by @pydanty in https://github.com/pydantic/pydantic-ai/pull/11254WebSearchTool and WebFetchTool on AsyncAnthropicBedrockMantle, which rejects them by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11489SummarizingCompaction summary that would make the history larger by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11649stream_transcripts(delta=True) when a transcript is corrected to empty by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11667OnlineEvaluation capability on an agent, not just the outermost by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11663model_settings when include_content=False by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11668AsyncAnthropicBedrockMantle the Bedrock Messages API, not Claude Platform on AWS, in comments and docstrings by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11482SpeechPart.id by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11675Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v2.62.0...v2.63.0
CodeMode to dynamic_catalog=True, so a revealed tool is appended instead of rewriting the cached prompt by @DouweM in #11358GoogleRealtimeConnection's dial as a keyword-only replay argument by @DouweM in #11515LLMReminder a default interval=10 instead of generating on every request by @DouweM in #11641canonical_system by @DouweM in #11504CombinedCapability load as one capability, with members keeping their global ordering by @adtyavrdhn in #10321<system> tag means and escape it in user and tool text on models without mid-conversation system messages by @DouweM in #11506task_timeout to Dataset.evaluate to bound each task attempt by @dmontagu in #10291ag-ui-protocol 1.0 by @adtyavrdhn in #8627CodeMode to dynamic_catalog=True, so a revealed tool is appended instead of rewriting the cached prompt by @DouweM in #11358GoogleRealtimeConnection's dial as a keyword-only replay argument by @DouweM in #11515gpt-6.1-terra model support by @dsfaccini in #11393IPythonCodeMode) alongside the Monty-based CodeMode by @mpfaffenberger in #11570LLMReminder a default interval=10 instead of generating on every request by @DouweM in #11641DetectLoops capability to interrupt repeated-action loops by @mpfaffenberger in #11471manage_message_history to UI adapters so a server-held history isn't sent to the model twice by @DouweM in #11431pydantic_ai.framing module with wrap, neutralize_tags and register_tag, so extensions can frame their own tags by @DouweM in #10957canonical_system by @DouweM in #11504PostgresSpendStore so harness SpendLimits budgets can be shared through PostgreSQL by @DouweM in #11527CombinedCapability load as one capability, with members keeping their global ordering by @adtyavrdhn in #10321CodeMode run_code description by @mpfaffenberger in #11459mistralai>=3.1.0 and drop the legacy httpx import so MistralModel imports on fresh installs by @adtyavrdhn in #11549too_many_requests Responses failures on openai>=3.32.0 by @dsfaccini in #11532ToolOutputLimits spill writes in a durable_operation so replays do not write them again by @mpfaffenberger in #11460before_model_request hook sent when it rewrote the history with a copy of the request by @DouweM in #11501before_model_request hook loaded it by @DouweM in #11516BackgroundTools, RepoContext, TrajectoryJudge and Planning frames by @DouweM in #11530thinking change after an unanswered ModelSettingsDeltaPart instead of replacing it, so UI streams and hook-rebuilt requests keep it by @DouweM in #11514gemini-robotics-er realtime models see the image sent just before them by @DouweM in #11484PendingModelResponse by @DouweM in #11517AsyncAnthropicBedrockMantle on Claude Opus 5.5 by @DouweM in #11486AsyncAnthropicBedrockMantle by @DouweM in #11487AdvisorTool on AsyncAnthropicBedrockMantle, which rejects it by @DouweM in #11488CodeMode REPL state when repl_store load fails, instead of saving a fresh REPL over it by @mpfaffenberger in #11483RuntimeError: coroutine ignored GeneratorExit and an escaping KeyboardInterrupt on Agent.iter() teardown by @pydanty in #10258wrap_run or on_run_error recovery result from run_stream() instead of raising AgentRunError by @DouweM in #11571<system> tag means and escape it in user and tool text on models without mid-conversation system messages by @DouweM in #11506SummarizingCompaction summarizer transcript by @DouweM in #11583allowed_patterns on the real path when search_files targets a single symlinked file by @mpfaffenberger in #11639None type arguments in Dataset by @pydanty in #11254WebSearchTool and WebFetchTool on AsyncAnthropicBedrockMantle, which rejects them by @DouweM in #11489SummarizingCompaction summary that would make the history larger by @DouweM in #11649stream_transcripts(delta=True) when a transcript is corrected to empty by @DouweM in #11667OnlineEvaluation capability on an agent, not just the outermost by @DouweM in #11663model_settings when include_content=False by @DouweM in #11668AsyncAnthropicBedrockMantle the Bedrock Messages API, not Claude Platform on AWS, in comments and docstrings by @DouweM in #11482SpeechPart.id by @DouweM in #11675Full Changelog: v2.62.0...v2.63.0
Build Harness SystemReminders on request-scoped system prompts and deprecate cache_ttl by @DouweM in https://github.com/pydantic/pydantic-ai/pull/9712
<!-- Release notes generated using configuration in .github/release.yml at 79685d18af7c8ea174029f23f40eec7c4af18e2b -->
configuration_update and Anthropic per-message output_config, recorded as ModelSettingsDeltaPart by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11111ModelRequestRejectedError, ModelAuthenticationError and ModelNotFoundError model error categories by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11081before_model_request by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11103tool_prefix by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10376SummarizingCompaction summary as a CompactionPart instead of a system prompt, and send provider-less CompactionParts to every model by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10573SystemPromptParts on each provider's operator channel with session.send() by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11379on_change='append', and give an id-less URL MCPToolset its hostname as id by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10791Memory snapshots in history once per changed run, so requests stay append-only by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10903ctx.emit() by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11157SpeechPart instead of splitting it at each delegated tool call by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11187ctx.emit() events into the realtime session event stream by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11369ModelSettings: forced tool_choice raises on Gemini Live, parallel_tool_calls=False warns by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11066configuration_update system message by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11426GraphBuilder broadcast branches in .to() order instead of reversed, which can break replay of durable workflows paused across the upgrade by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11408on_change='append' instruction blocks behind a second cache point after the static instructions by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11351SystemReminders on request-scoped system prompts and deprecate cache_ttl by @DouweM in https://github.com/pydantic/pydantic-ai/pull/9712CodeMode(monty_sandbox=...), which takes a remote Monty URL or a function that builds the pool, and deprecate monty_sandbox_url by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/11141configuration_update and Anthropic per-message output_config, recorded as ModelSettingsDeltaPart by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11111ModelRequestRejectedError, ModelAuthenticationError and ModelNotFoundError model error categories by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11081conversation_id_from_run_id from pydantic_ai.durable_exec for third-party durability engines by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11338child_workflow tool metadata in TemporalDurability by @YHallouard in https://github.com/pydantic/pydantic-ai/pull/7329tool_choice subsets with allowed_tools on OpenAI Chat Completions to preserve the prompt cache by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10396before_model_request by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11103tool_prefix by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10376SummarizingCompaction summary as a CompactionPart instead of a system prompt, and send provider-less CompactionParts to every model by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10573tool_prefix to the MCP capability by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11364SubAgents run delegations as tasks the model can background, steer, answer and cancel, behind task_control by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10893Coder(task_control=) to turn on SubAgents task control by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11007StructuredContent user content, sent as its value to decision models by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10529RequestUsage.cost by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/7337CompactOnRequest by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11422SystemPromptParts on each provider's operator channel with session.send() by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11379AnthropicModel.compact_messages() for on-demand native compaction by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11432BatchModelRequests capability and a get_wrapper_model capability hook by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10672GraphRun iterator and ToolManager context reference cycles by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11158Agent.run_stream name inference from keeping deps alive until garbage collection by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11219ModelResponse.provider_response_id by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11223deepseek-flash in DeepSeekProvider by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11249AgentStream event stream when a consumer leaves node.stream() early by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/11009thinking=False on OpenRouter's anthropic/claude-sonnet-5.5, which can't turn reasoning off by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11261on_change='append', and give an id-less URL MCPToolset its hostname as id by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10791dump_messages() by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11188too_many_requests stream errors for FallbackModel by @pydanty in https://github.com/pydantic/pydantic-ai/pull/11253google_proactive_audio work on the default Gemini provider with a separate v1alpha Live client by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11067load_messages() reloads a dumped history by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11192openai_previous_response_id chaining when a rewrite-mode instruction changes beside an on_change='append' block by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11331Memory snapshots in history once per changed run, so requests stay append-only by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10903thinking=False on OpenRouter routes that make reasoning mandatory by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11347ctx.emit() by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11157SpeechPart instead of splitting it at each delegated tool call by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11187CompactionPart with an empty summary instead of treating it as a compaction boundary by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11368AGUIAdapter.dump_messages injecting newlines between adjacent TextParts by @pydanty in https://github.com/pydantic/pydantic-ai/pull/8660AGUIAdapter.dump_messages does by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11391UIMessage of a split request its own id in Vercel AI dump_messages() by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11193FileUrl media_type win over the downloaded Content-Type, and treat binary/octet-stream as unknown by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11407ctx.emit() events into the realtime session event stream by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11369search_tools result as "No matching tools found" on Anthropic when its matches are no longer declared by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11411SummarizingCompaction and RelevanceCompaction transcript by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11370OpenAIChatModel and OpenAIResponsesModel by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11410reconnect policy by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11070ModelSettings: forced tool_choice raises on Gemini Live, parallel_tool_calls=False warns by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11066code_interpreter_call events by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11166ToolOutputLimits from reducing load_capability and search_tools returns, so loaded capabilities' tools unlock by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11446configuration_update system message by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11426GraphBuilder broadcast branches in .to() order instead of reversed, which can break replay of durable workflows paused across the upgrade by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11408capture_run_messages by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11413on_change='append' instruction blocks behind a second cache point after the static instructions by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11351ToolOutputLimits bands largest-first after combine, with the later band winning a shared threshold by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11453ToolReturn.content from CodeMode run_code to the model instead of silently dropping it by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11456ModelRetry raised after a BackgroundTools tool's step has ended toward max_retries by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11458SystemReminders on request-scoped system prompts and deprecate cache_ttl by @DouweM in https://github.com/pydantic/pydantic-ai/pull/9712SummarizingCompaction, SlidingWindowCompaction and RelevanceCompaction remove their load_capability exchange by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11394SSHWorkspaceBackend timeout and output-limit errors by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11479Shell persistent shell tool after a durable (DBOS) replay by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11457Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v2.61.0...v2.62.0
configuration_update and Anthropic per-message output_config, recorded as ModelSettingsDeltaPart by @DouweM in #11111ModelRequestRejectedError, ModelAuthenticationError and ModelNotFoundError model error categories by @DouweM in #11081before_model_request by @DouweM in #11103tool_prefix by @DouweM in #10376SummarizingCompaction summary as a CompactionPart instead of a system prompt, and send provider-less CompactionParts to every model by @DouweM in #10573SystemPromptParts on each provider's operator channel with session.send() by @DouweM in #11379on_change='append', and give an id-less URL MCPToolset its hostname as id by @DouweM in #10791Memory snapshots in history once per changed run, so requests stay append-only by @DouweM in #10903ctx.emit() by @dsfaccini in #11157SpeechPart instead of splitting it at each delegated tool call by @DouweM in #11187ctx.emit() events into the realtime session event stream by @DouweM in #11369ModelSettings: forced tool_choice raises on Gemini Live, parallel_tool_calls=False warns by @DouweM in #11066configuration_update system message by @DouweM in #11426GraphBuilder broadcast branches in .to() order instead of reversed, which can break replay of durable workflows paused across the upgrade by @DouweM in #11408on_change='append' instruction blocks behind a second cache point after the static instructions by @DouweM in #11351SystemReminders on request-scoped system prompts and deprecate cache_ttl by @DouweM in #9712CodeMode(monty_sandbox=...), which takes a remote Monty URL or a function that builds the pool, and deprecate monty_sandbox_url by @adtyavrdhn in #11141configuration_update and Anthropic per-message output_config, recorded as ModelSettingsDeltaPart by @DouweM in #11111ModelRequestRejectedError, ModelAuthenticationError and ModelNotFoundError model error categories by @DouweM in #11081conversation_id_from_run_id from pydantic_ai.durable_exec for third-party durability engines by @DouweM in #11338child_workflow tool metadata in TemporalDurability by @YHallouard in #7329tool_choice subsets with allowed_tools on OpenAI Chat Completions to preserve the prompt cache by @DouweM in #10396before_model_request by @DouweM in #11103tool_prefix by @DouweM in #10376SummarizingCompaction summary as a CompactionPart instead of a system prompt, and send provider-less CompactionParts to every model by @DouweM in #10573tool_prefix to the MCP capability by @DouweM in #11364SubAgents run delegations as tasks the model can background, steer, answer and cancel, behind task_control by @mpfaffenberger in #10893Coder(task_control=) to turn on SubAgents task control by @mpfaffenberger in #11007StructuredContent user content, sent as its value to decision models by @DouweM in #10529RequestUsage.cost by @adtyavrdhn in #7337CompactOnRequest by @mpfaffenberger in #11422SystemPromptParts on each provider's operator channel with session.send() by @DouweM in #11379AnthropicModel.compact_messages() for on-demand native compaction by @DouweM in #11432BatchModelRequests capability and a get_wrapper_model capability hook by @DouweM in #10672GraphRun iterator and ToolManager context reference cycles by @dsfaccini in #11158Agent.run_stream name inference from keeping deps alive until garbage collection by @dsfaccini in #11219ModelResponse.provider_response_id by @dsfaccini in #11223deepseek-flash in DeepSeekProvider by @dsfaccini in #11249AgentStream event stream when a consumer leaves node.stream() early by @adtyavrdhn in #11009thinking=False on OpenRouter's anthropic/claude-sonnet-5.5, which can't turn reasoning off by @dsfaccini in #11261on_change='append', and give an id-less URL MCPToolset its hostname as id by @DouweM in #10791dump_messages() by @DouweM in #11188too_many_requests stream errors for FallbackModel by @pydanty in #11253google_proactive_audio work on the default Gemini provider with a separate v1alpha Live client by @DouweM in #11067load_messages() reloads a dumped history by @DouweM in #11192openai_previous_response_id chaining when a rewrite-mode instruction changes beside an on_change='append' block by @DouweM in #11331Memory snapshots in history once per changed run, so requests stay append-only by @DouweM in #10903thinking=False on OpenRouter routes that make reasoning mandatory by @DouweM in #11347ctx.emit() by @dsfaccini in #11157SpeechPart instead of splitting it at each delegated tool call by @DouweM in #11187CompactionPart with an empty summary instead of treating it as a compaction boundary by @DouweM in #11368AGUIAdapter.dump_messages injecting newlines between adjacent TextParts by @pydanty in #8660AGUIAdapter.dump_messages does by @DouweM in #11391UIMessage of a split request its own id in Vercel AI dump_messages() by @DouweM in #11193FileUrl media_type win over the downloaded Content-Type, and treat binary/octet-stream as unknown by @DouweM in #11407ctx.emit() events into the realtime session event stream by @DouweM in #11369search_tools result as "No matching tools found" on Anthropic when its matches are no longer declared by @DouweM in #11411SummarizingCompaction and RelevanceCompaction transcript by @DouweM in #11370OpenAIChatModel and OpenAIResponsesModel by @DouweM in #11410reconnect policy by @DouweM in #11070ModelSettings: forced tool_choice raises on Gemini Live, parallel_tool_calls=False warns by @DouweM in #11066code_interpreter_call events by @dsfaccini in #11166ToolOutputLimits from reducing load_capability and search_tools returns, so loaded capabilities' tools unlock by @mpfaffenberger in #11446configuration_update system message by @DouweM in #11426GraphBuilder broadcast branches in .to() order instead of reversed, which can break replay of durable workflows paused across the upgrade by @DouweM in #11408capture_run_messages by @DouweM in #11413on_change='append' instruction blocks behind a second cache point after the static instructions by @DouweM in #11351ToolOutputLimits bands largest-first after combine, with the later band winning a shared threshold by @mpfaffenberger in #11453ToolReturn.content from CodeMode run_code to the model instead of silently dropping it by @mpfaffenberger in #11456ModelRetry raised after a BackgroundTools tool's step has ended toward max_retries by @mpfaffenberger in #11458SystemReminders on request-scoped system prompts and deprecate cache_ttl by @DouweM in #9712SummarizingCompaction, SlidingWindowCompaction and RelevanceCompaction remove their load_capability exchange by @DouweM in #11394SSHWorkspaceBackend timeout and output-limit errors by @DouweM in #11479Shell persistent shell tool after a durable (DBOS) replay by @mpfaffenberger in #11457Full Changelog: v2.61.0...v2.62.0
Deprecate google_multi_speaker on GoogleRealtimeModel , which no Gemini Live model supports by @DouweM in #11064
thinking by @dsfaccini in #10231thinking=False on models that can't turn thinking off by @DouweM in #11036NotImplementedError for a file in a CohereModel tool return instead of dropping it by @dsfaccini in #11114bool and int inputs on separate Literal decision branches in pydantic_graph by @dafyy321-pixel in #9091google_multi_speaker on GoogleRealtimeModel, which no Gemini Live model supports by @DouweM in #11064auth functions in the hosted MCP capabilities by @mpfaffenberger in #10835CapabilityStore.load_active and stop overwriting unreadable manifests by @mpfaffenberger in #10731CapabilityStore lock per directory, and let runs cancel authoring by @mpfaffenberger in #10767BrowserUse prohibited lists browser-use would match by exact hostname, and retry when redacted schema keys collide by @mpfaffenberger in #10775LocalStack container inside async with agent:, stop service-list bypasses and aws configure writes to ~/.aws, and cap aws_cli output by @mpfaffenberger in #10828InputGuardrail redact the user's own prompt and close fail-open paths in guardrails by @mpfaffenberger in #10841CodeMode(dynamic_catalog=True) discoveries from rewriting the cached prompt by @DouweM in #10906auth functions in the hosted MCP capabilities by @mpfaffenberger in #10835TextPart by @adtyavrdhn in #7434shell job logs with Shell.max_log_bytes by @mpfaffenberger in #10712kimi-k3.1-pro and kimi-k3.1-pro-highspeed model names by @dsfaccini in #11173transport= in create_async_httpx2_client() and give the httpx2 retry transports its pool limits by @DouweM in #11073RealtimeClientSecret.webrtc_url, which carries webrtcfilter=on on Azure OpenAI by @DouweM in #11076RealtimeModelProfile.supports_audio_output so text-only realtime models like Gemini's robotics streaming models default to text output by @DouweM in #11102ParameterTransports, DurableRunContext and run identity hooks by @DouweM in #11088reasoning that arrives without reasoning_details by @dsfaccini in #11104UserError instead of an AssertionError for an unconverted response SpeechPart in BedrockConverseModel by @dsfaccini in #11107NotImplementedError for a file in a CohereModel tool return instead of dropping it by @dsfaccini in #11114TOOL_CALL_ID_PREFIX instead of a hardcoded 'pyd_ai_' by @dsfaccini in #11109bool and int inputs on separate Literal decision branches in pydantic_graph by @dafyy321-pixel in #9091NativeOutput on every FireworksProvider model by @pydanty in #10157thinking by @dsfaccini in #10231XaiModel native tool return parts by @dsfaccini in #11105OpenAIChatModel response with a non-standard finish_reason instead of raising UnexpectedModelBehavior by @dsfaccini in #11119InputGuardrail redact the user's own prompt and close fail-open paths in guardrails by @mpfaffenberger in #10841CapabilityStore.load_active and stop overwriting unreadable manifests by @mpfaffenberger in #10731Linear(id=None) uncombined like GitHub(id=None) by @mpfaffenberger in #10813ExaAgent poll leaves behind, and stop retrying Exa errors the model can't fix by @mpfaffenberger in #10840Shell commands over SSHWorkspaceBackend, and return a command too long to start to the model by @mpfaffenberger in #11004E2BSandbox probe timeouts and validate env and sandbox_timeout at construction by @mpfaffenberger in #10811ExaSearch and ExaAgent client on a new event loop, and build ExaAgent's once by @mpfaffenberger in #10848CapabilityStore lock per directory, and let runs cancel authoring by @mpfaffenberger in #10767ConversationSearch returning inherited history once per run, and clip excerpts around the matched term by @mpfaffenberger in #10749BrowserUse prohibited lists browser-use would match by exact hostname, and retry when redacted schema keys collide by @mpfaffenberger in #10775LocalStack container inside async with agent:, stop service-list bypasses and aws configure writes to ~/.aws, and cap aws_cli output by @mpfaffenberger in #10828InputGuardrail redaction also rewrite the history prompt when the model was sent a copy, and tighten the guardrails docs by @mpfaffenberger in #10852BrowserUse secrets in browse_web results by @mpfaffenberger in #10827arguments in HuggingFaceModel message history by @canblmz1 in #11139RunCancelled across the durable tool-call boundary as a failed tool result by @dsfaccini in #11163XaiModel native tool call as a call part and one return part by @dsfaccini in #11164gemini-2.5-flash-image, which rejects it by @DouweM in #11099logfire-cli wizard --task pydantic-ai by @DouweM in #11069OpenAIResponsesModel force a tool revealed mid-run on models before GPT-5.6 by @dsfaccini in #10273CodeMode(dynamic_catalog=True) discoveries from rewriting the cached prompt by @DouweM in #10906SpeechPart by @DouweM in #11159defer_loading=True capability is loaded on Anthropic by @DouweM in #11091thinking=False on models that can't turn thinking off by @DouweM in #11036google_multi_speaker on GoogleRealtimeModel, which no Gemini Live model supports by @DouweM in #11064hang_up() for Azure OpenAI WebRTC calls by @DouweM in #11075session.started by @DouweM in #11115__pydantic_ai__ metadata out of sanitize_messages output, as the UI adapters do by @DouweM in #11089Full Changelog: v2.60.0...v2.61.0
<!-- Release notes generated using configuration in .github/release.yml at dd82a00ae3ef9a5f147405153eb877221d74d1c7 -->
thinking by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/10231thinking=False on models that can't turn thinking off by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11036NotImplementedError for a file in a CohereModel tool return instead of dropping it by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11114bool and int inputs on separate Literal decision branches in pydantic_graph by @dafyy321-pixel in https://github.com/pydantic/pydantic-ai/pull/9091google_multi_speaker on GoogleRealtimeModel, which no Gemini Live model supports by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11064auth functions in the hosted MCP capabilities by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10835CapabilityStore.load_active and stop overwriting unreadable manifests by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10731CapabilityStore lock per directory, and let runs cancel authoring by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10767BrowserUse prohibited lists browser-use would match by exact hostname, and retry when redacted schema keys collide by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10775LocalStack container inside async with agent:, stop service-list bypasses and aws configure writes to ~/.aws, and cap aws_cli output by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10828InputGuardrail redact the user's own prompt and close fail-open paths in guardrails by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10841CodeMode(dynamic_catalog=True) discoveries from rewriting the cached prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10906auth functions in the hosted MCP capabilities by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10835TextPart by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/7434shell job logs with Shell.max_log_bytes by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10712kimi-k3.1-pro and kimi-k3.1-pro-highspeed model names by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11173transport= in create_async_httpx2_client() and give the httpx2 retry transports its pool limits by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11073RealtimeClientSecret.webrtc_url, which carries webrtcfilter=on on Azure OpenAI by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11076RealtimeModelProfile.supports_audio_output so text-only realtime models like Gemini's robotics streaming models default to text output by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11102ParameterTransports, DurableRunContext and run identity hooks by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11088reasoning that arrives without reasoning_details by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11104UserError instead of an AssertionError for an unconverted response SpeechPart in BedrockConverseModel by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11107NotImplementedError for a file in a CohereModel tool return instead of dropping it by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11114TOOL_CALL_ID_PREFIX instead of a hardcoded 'pyd_ai_' by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11109bool and int inputs on separate Literal decision branches in pydantic_graph by @dafyy321-pixel in https://github.com/pydantic/pydantic-ai/pull/9091NativeOutput on every FireworksProvider model by @pydanty in https://github.com/pydantic/pydantic-ai/pull/10157thinking by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/10231XaiModel native tool return parts by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11105OpenAIChatModel response with a non-standard finish_reason instead of raising UnexpectedModelBehavior by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11119InputGuardrail redact the user's own prompt and close fail-open paths in guardrails by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10841CapabilityStore.load_active and stop overwriting unreadable manifests by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10731Linear(id=None) uncombined like GitHub(id=None) by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10813ExaAgent poll leaves behind, and stop retrying Exa errors the model can't fix by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10840Shell commands over SSHWorkspaceBackend, and return a command too long to start to the model by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/11004E2BSandbox probe timeouts and validate env and sandbox_timeout at construction by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10811ExaSearch and ExaAgent client on a new event loop, and build ExaAgent's once by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10848CapabilityStore lock per directory, and let runs cancel authoring by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10767ConversationSearch returning inherited history once per run, and clip excerpts around the matched term by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10749BrowserUse prohibited lists browser-use would match by exact hostname, and retry when redacted schema keys collide by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10775LocalStack container inside async with agent:, stop service-list bypasses and aws configure writes to ~/.aws, and cap aws_cli output by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10828InputGuardrail redaction also rewrite the history prompt when the model was sent a copy, and tighten the guardrails docs by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10852BrowserUse secrets in browse_web results by @mpfaffenberger in https://github.com/pydantic/pydantic-ai/pull/10827arguments in HuggingFaceModel message history by @canblmz1 in https://github.com/pydantic/pydantic-ai/pull/11139RunCancelled across the durable tool-call boundary as a failed tool result by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11163XaiModel native tool call as a call part and one return part by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/11164gemini-2.5-flash-image, which rejects it by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11099logfire-cli wizard --task pydantic-ai by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11069OpenAIResponsesModel force a tool revealed mid-run on models before GPT-5.6 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/10273CodeMode(dynamic_catalog=True) discoveries from rewriting the cached prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/10906SpeechPart by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11159defer_loading=True capability is loaded on Anthropic by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11091thinking=False on models that can't turn thinking off by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11036google_multi_speaker on GoogleRealtimeModel, which no Gemini Live model supports by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11064hang_up() for Azure OpenAI WebRTC calls by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11075session.started by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11115__pydantic_ai__ metadata out of sanitize_messages output, as the UI adapters do by @DouweM in https://github.com/pydantic/pydantic-ai/pull/11089Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v2.60.0...v2.61.0
One column per month.