claude-agent-sdk-typescript v0.3.174 リリース

概要

このバージョンではSDKのフォールバック機能が大幅に強化され、SDK利用者がすべてのフォールバックトリガーに対して system/model_fallback メッセージを受け取れるようになりました。従来の model_not_found と permission_denied に加えて、overloaded、server_error、last_resort といった新しいフォールバック理由に対応しました。メッセージの trigger フィールドも拡張され、server_error と last_resort という新しい値を利用可能になりました。これにより、開発者はより詳細できめ細かいエラーハンドリングとフォールバック戦略の実装が可能になります。

何が変わったか

• ・SDK利用者がすべてのフォールバックトリガー（overloaded、server_error、last_resort、model_not_found、permission_denied）に対して system/model_fallback メッセージを受け取るようになった
• ・system/model_fallback メッセージの trigger フィールドに server_error と last_resort という新しい値が追加された
• ・従来は model_not_found と permission_denied のみだったフォールバック通知が、サーバー過負荷やサーバーエラー、最後の手段としてのフォールバックにも対応

影響

開発者は system/model_fallback メッセージハンドラーを実装する際に、より広範なフォールバック条件を考慮する必要が出ますが、同時にすべてのフォールバックシナリオを統一的に処理できるようになります。既存のコードとの互換性は保たれますが、サーバーエラーや過負荷時の処理を新たに組み込むことで、本番環境でのシステム安定性が向上します。API統合やエラーリカバリー戦略の設計がより柔軟かつ堅牢になります。

対象ユーザー

Claude Codeユーザー・AIエンジニア・開発者・SDK利用者・エージェント型アプリケーション開発者

ソース

claude-agent-sdk-typescript v0.3.174