# Migration & Versions

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](/docs/sdk/reference/api-surface)
- [Provider API](/docs/sdk/reference/provider-api)
- [Interrupts and Resume](/docs/sdk/guides/interrupts-and-resume)

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