Migration Guides

Upgrade assistant-ui versions and migrate deprecated APIs and integrations.

Use these guides when upgrading assistant-ui or moving from APIs that have been deprecated or replaced.

Version upgrades

Replace APIs removed after v0.11 and v0.12, and migrate primitive components props to children render functions.

Move from individual context hooks to the unified state API.

Update code affected by the ContentPart to MessagePart rename.

Move legacy tool and tool UI registrations to the toolkit API.

Upgrade to the simplified LangGraph integration API.

Review compatibility notes for React 18 and React 19.

Review stability guarantees and deprecation timelines for assistant-ui features.