pydantic-ai v2.67.0 — v2.67.0 (2026-11-10)
- Source
- github.com
- Author
- dsfaccini
- Date

Context
Pydantic AI is a Python framework for building LLM agents from the team behind Pydantic. Version 2.67.0, released November 10, 2026, changes by default which instruction files an reads from a code repository. The change is in RepoContext, the component that loads files such as AGENTS.md and CLAUDE.md into an agent's , and it reaches Coder, the framework's bundled coding agent, which uses RepoContext. Teams that keep both files, or that run Coder on durable execution, should check the release's compatibility notes before upgrading.
According to the main pull request, RepoContext now loads one instruction file per directory, AGENTS.md first and CLAUDE.md as the fallback, so a directory that holds both now contributes only AGENTS.md. Instruction files in subdirectories are now picked up by default: when the agent reads or lists something in a directory, that directory's file is added to the conversation, and a companion change extends this to writing and editing files there. A new walk_up option sets how far up the directory tree loading goes. By default RepoContext looks only in the working directory, while Coder now loads files from the repository root down to the working directory. To bound that extra text, nested files are capped at 32,000 characters per conversation by default, and a file that would pass the cap appears as a pointer naming it rather than its contents. The pull request gives the old behavior back with filenames=('CLAUDE.md', 'AGENTS.md') and nested_traversal=False.
The less visible cost falls on durable execution, where a journal records an agent run's completed steps so that, in the documentation's words, a restarted run "replays the completed ones from the journal." Because Coder now makes extra file checks when a run starts, the pull request warns that its Temporal and DBOS runs started before the upgrade "no longer replay," and advises letting in-flight runs finish or versioning the deployment first. A separate change makes SubAgents with no id fail when the agent is built under DBOS, Prefect and the durability engines, as it already did under Temporal.
The rest of the release is a long list described only by pull-request titles. It adds support for Anthropic's Claude Fable 5.2 and Claude Mythos 5.2 models, Google's Gemini 4 Carbon and OpenAI's fast and ultrafast service tiers, along with many fixes to durable execution, sandboxes and provider requests.
- Pydantic AI v2.67.0 changes `RepoContext` defaults: it now loads one instruction file per directory plus nested files, and caps inlined nested instructions at 32,000 characters per conversation, adjustable with `nested_max_chars`.
- Listed as a compatibility change, provider-specific native-tool fields move into `provider_settings`, which is also how the release exposes Anthropic's `web_search_20260318` and `web_fetch_20260318` tools.
- Durable execution coverage widens: guardrail verdicts and `Advisor` and search tool I/O are recorded as durable operations, `TrajectoryJudge` runs are checkpointed when the judge has an `id`, and tool calls can run as DBOS child workflows.
- Two fixes close safety gaps: `CodeMode` now rejects tools named after Python builtins, which the had called instead of the tool, and `ArtifactScanner` strips default-ignorable characters and flags hidden variation selectors before phrase matching.
- The release adds Claude Fable 5.2 and Mythos 5.2, Gemini 4 Carbon on `GoogleModel`, OpenAI's gpt-image-2.6 Flare and Sunburst image models, and OpenAI's `fast` and `ultrafast` service tiers.
- AI agent — An AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.
- context window — The maximum amount of text a model can consider at once — its working memory for the current conversation or task.
- agent harness — The scaffolding around a model that turns it into a working agent — the loop, the tools it can call, and the rules for when to stop.
- sandbox — An isolated environment where AI-generated code or agent actions run without being able to touch anything real.
Checking sign-in…
Loading comments…





