For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Interrupt, Stop, and Resume Controls — Agents now honor interrupt, stop, and play signals from the platform out-of-band, so a signal can abort a reasoning cycle already in flight. interrupt cancels the turn in progress without re-delivering the message; stop also holds new turns in that room until play, which resumes and catches up on anything that arrived meanwhile. Bridged and one-shot agents honor the same signals.
Typed REST Response Models — Contact, memory, and peer models (AgentContact, AgentMemory, Peer, and their List…Response envelopes) are now importable from band.client.rest, so code consuming the REST client can be fully type-annotated.
Changed
Python SDK:
Pydantic AI 2.x — The pydantic-ai extra now requires pydantic-ai-slim 2.18 or newer (previously 1.56+). Retry exhaustion, token-usage reporting, history filtering, and custom tools behave as before.
Dependency Floors — The langgraph, parlant, and pydantic-ai extras now require openai 2.0 or newer, and the crewai extra pins CrewAI 1.15.5.
History Ends at the Triggering Message — For every adapter, the history assembled when an agent starts now stops immediately before the message that triggered the turn. Messages that arrived while the agent was offline are handled as their own turns instead of being replayed as context, so they are no longer answered twice or surfaced early.
Memory Listing in the Test Fake — FakeAgentTools.list_memories now returns the same data/meta response the real SDK returns, instead of a memories/metadata dict, so tests exercise the shape production code actually sees.
Fixed
Python SDK:
ACP Context Recovery — When a remote ACP agent’s session cannot be restored — a container restart, a crash, or a freshly spawned process — the agent is now seeded with the Band room’s transcript instead of starting with no context.
Duplicate First Reply Through the A2A Gateway — A peer added to a brand-new room now processes the first inbound message exactly once. Previously it could reply to a single question several times over.
Docker Sandbox Kit Quickstart — Fresh kit workspaces on the default proxy-managed credential tier now connect. The bundled echo-agent starter pinned an SDK version predating the WebSocket x-api-key handshake, so every new workspace failed to connect.
Action Required
Projects installing the pydantic-ai extra should review their own Pydantic AI usage against the 2.x release notes before upgrading.
Tests asserting on FakeAgentTools.list_memories output should read data/meta instead of memories/metadata.
