assistant-ui Update
Always verifies against npm ground truth and GitHub commits.
References ./references/ai-sdk-v6.md -- AI SDK v4/v5 → v6 migration (complete guide) ./references/assistant-ui.md -- assistant-ui version migrations ./references/breaking-changes.md -- Quick reference table Phase 1: Detect Versions Get Ground Truth
Installed versions
npm ls @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react 2>/dev/null
Latest from npm
npm view @assistant-ui/react version npm view @assistant-ui/react-ai-sdk version npm view ai version
Version Analysis Package Check For ai < 6.0.0 → needs AI SDK v6 migration @assistant-ui/react < 0.11.0 → needs runtime migration @assistant-ui/react < 0.10.0 → needs ESM migration @assistant-ui/react < 0.8.0 → needs UI split migration @assistant-ui/react-ai-sdk < 1.0.0 → needs AI SDK v6 first Phase 2: Route to Migration AI SDK < 6.0.0? ├─ Yes → See ./references/ai-sdk-v6.md └─ No └─ assistant-ui outdated? ├─ Yes → See ./references/assistant-ui.md └─ No → Already up to date
Migration Order AI SDK first (if < 6.0.0) - Required for @assistant-ui/react-ai-sdk >= 1.0 assistant-ui second - Apply breaking changes for version jump Verify - Type check, build, test Phase 3: Execute Update Packages
pnpm
pnpm add @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest
npm
npm install @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest
Apply Migrations
Based on version jump, apply relevant migrations from references.
Verify npx tsc --noEmit # Type check pnpm build # Build check
Troubleshooting
"Peer dependency conflict"
Update all packages together Check version compatibility in ./references/breaking-changes.md
Type errors after upgrade
Consult breaking changes reference Check specific migration guide
Runtime errors
Verify API patterns match new version Check for renamed/moved APIs