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

update