assistant-ui アップデート

npm の最新情報と GitHub のコミットに対して常に検証します。

リファレンス

• ./references/ai-sdk-v6.md -- AI SDK v4/v5 → v6 マイグレーション (完全ガイド)
• ./references/assistant-ui.md -- assistant-ui バージョンマイグレーション
• ./references/breaking-changes.md -- 重大な変更クイックリファレンステーブル

フェーズ 1: バージョン検出

グラウンドトゥルースの確認

# インストール済みバージョン
npm ls @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react 2>/dev/null

# npm の最新版
npm view @assistant-ui/react version
npm view @assistant-ui/react-ai-sdk version
npm view ai version

バージョン分析

パッケージ	確認項目
ai	< 6.0.0 → AI SDK v6 マイグレーションが必要
@assistant-ui/react	< 0.12.0 → 統一状態 API マイグレーションが必要
@assistant-ui/react	< 0.11.0 → ランタイムマイグレーションが必要
@assistant-ui/react	< 0.10.0 → ESM マイグレーションが必要
@assistant-ui/react	< 0.8.0 → UI 分割マイグレーションが必要
@assistant-ui/react-ai-sdk	< 1.0.0 → 最初に AI SDK v6 が必要

フェーズ 2: マイグレーションルーティング

AI SDK < 6.0.0?
├─ はい → ./references/ai-sdk-v6.md を参照
└─ いいえ
   └─ assistant-ui は古いバージョン?
      ├─ はい → ./references/assistant-ui.md を参照
      └─ いいえ → 既に最新版です

マイグレーション順序

1. AI SDK を最初に (< 6.0.0 の場合) - @assistant-ui/react-ai-sdk >= 1.0 に必須
2. assistant-ui を次に - バージョンジャンプの重大な変更を適用
3. 検証 - 型チェック、ビルド、テスト

フェーズ 3: 実行

パッケージのアップデート

# 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

マイグレーションを適用

バージョンジャンプに基づいて、リファレンスから関連するマイグレーションを適用してください。

検証

npx tsc --noEmit  # 型チェック
pnpm build        # ビルドチェック

トラブルシューティング

「ピア依存関係の競合」

• すべてのパッケージを一緒にアップデート
• ./references/breaking-changes.md のバージョン互換性を確認

アップグレード後の型エラー

• 重大な変更リファレンスを参照
• 特定のマイグレーションガイドを確認

ランタイムエラー

• API パターンが新しいバージョンと一致していることを確認
• 名前変更/移動された API を確認