Migration & Versions

Updated 3 days ago • October 4, 2026

This section tracks upgrade guidance and behavior changes across versions.

Current policy

• Within the same SDK major version, docs are updated in place.
• The latest SDK docs use /docs/sdk/.... Previous majors remain available at /docs/sdk/vN/....
• Studio has its own documentation and version history at /docs/studio.
• New major versions should include dedicated upgrade notes and breaking-change guidance.

What to check before upgrading

1. API changes across agent/runtime/hooks/providers packages.
2. Provider setup and model initialization expectations.
3. Streaming and interrupt/resume behavior in your app path.

Related docs

• API Surface
• Provider API
• Interrupts and Resume

Good to know: When your app is production-critical, validate upgrade changes in a staging workflow before rollout.