Migrating from 0.4.x to 0.5.0

0.5.0 fixes defects found in a full audit of the 0.4.0 line and adds tool timeouts, tool replay, loop detection, provider fallback, and support for the MCP Python SDK 2.x. New API is additive, but several fixes change behaviour you may have relied on. Read this list before upgrading.

Three defaults to check first

Sessions

Streaming

Reliability primitives

Pricing and output parsing

Guards and compliance

Telemetry

MCP

The [mcp] extra now accepts mcp>=1.10,<3. The floor moved because versions before 1.10 lack structuredContent. MCPToolAdapter accepts a 1.x or 2.x ClientSession or a 2.x Client, and tool() takes a timeout.