エラー型の細分化でハンドリングが楽に。SSE デコード最適化とパストラバーサル対策も地味だが効く。
Anthropic TypeScript SDK v1.5.0公開、エラーハンドリング強化
原題: anthropics/anthropic-sdk-typescript: sdk-v1.5.0
重要度の根拠: 既存ユーザーに直接の運用影響があるエラーハンドリング改善とセキュリティパッチ、パフォーマンス最適化が含まれるマイナーバージョンアップ。
要約
Anthropic が TypeScript SDK v1.5.0 をリリースしました。このバージョンでは、API エラーの詳細情報を扱うための新しい型が追加され、HTTP ステータスコードと API エラーコード別の専用エラークラスが導入されます。また、ストリーミング時のサーバー送信イベント(SSE)のデコード処理を最適化し、パス操作の脆弱性(;x や ..;x の悪用)を防ぐセキュリティパッチが含まれています。メモリツールの実装改善と、ドキュメント記述の明確化も行われました。開発者にとって、より堅牢なエラーハンドリングと安全な API 呼び出しが可能になります。
要点
- APIError に apiMessage、errorCode、details を追加し型安全なエラーハンドリングが可能に
- HTTP ステータス・API エラーコード別の専用エラークラスで細かい分岐制御が可能
- SSE デコード処理を最適化、ストリーミング性能を向上
- パス走査攻撃対策として ";x"、".;x"、"..;x" パターンを拒否
- メモリツール保護と広範なドキュメント記述の明確化
開発者向け技術解説(API・実装詳細・破壊的変更)を見る
TypeScript SDK v1.5.0 では、APIError クラスに apiMessage、errorCode、details プロパティが追加されました。HTTP ステータス別および API エラーコード別の専用エラークラスが実装され、エラーハンドリングの型安全性が向上します。ストリーミング機能では SSE デコード処理が一度に実行されるよう最適化され、パフォーマンスが改善されました。パス走査攻撃対策として、";x"、".;x"、"..;x" パターンのパスパラメータが拒否されます。メモリツールは /memories ディレクトリの削除または名前変更を防止します。API スキーマの例値更新、CMEK 型名の大文字化、エラー詳細型の適切なリソースへの移行も含まれます。
本文の日本語訳(全文)を見る
### 機能追加
* **API**: エラー詳細型と新しいエラー型値を追加
* **API**: リスト ワークスペース API に ids フィルターを追加
* **client**: HTTP ステータスおよび API エラーコード向けのエラークラスを追加、APIError に apiMessage、errorCode、details プロパティを追加
### バグ修正
* **API**: エラー詳細型名内の CMEK を大文字化
* **API**: 一部のエラー詳細型を、それが説明するリソースに移動
* **client**: ";x"、".;x"、"..;x" のようなパスパラメータを拒否(パス走査攻撃対策)
* **tools**: メモリツールが /memories ディレクトリを削除または名前変更しないよう修正
### パフォーマンス改善
* **streaming**: サーバー送信イベント(SSE)を 1 チャンクあたり 1 回デコード
### その他の改善
* **API**: パターン制約のある文字列フィールドの例値を更新
* **docs**: プラグインのリーチ値を明確化
* **docs**: プラグインバージョン説明とプラグインリーチを明確化
* **docs**: プラグインバージョン説明の長さを明確化
* **docs**: 一部の API フィールド説明を明確化
* **docs**: 3 つのエラー説明を明確化
* **docs**: フォールバックブロック周辺で送信すべきブロックを明確化
* **docs**: Claude Tag ダイレクトメッセージの利用レポートの注記を訂正
* **docs**: Dream および RBAC ロール権限説明を言い換え
* **docs**: テレメトリー宛先ヘッダー説明を更新
* **docs**: アナリティクスフィルタードキュメント内で Claude Platform 名を使用
* **internal**: チェンジログ確認でチェンジログエントリファイルを受け入れるよう対応
* **internal**: チェンジログエントリファイルを無視
* **internal**: エラークラスがレスポンス本体を読む方法を簡素化
### ドキュメント
* **API**: `speed` フィールドの各フィールド固有説明を表示
* ドキュメントコメント内のエスケープとコードスパンを削除
* 必須パラメータ引数を省略した例を修正
出典: https://github.com/anthropics/anthropic-sdk-typescript/releases/tag/sdk-v1.5.0
媒体: SDK (anthropic-sdk-typescript)
※本記事は Anthropic / Claude 関連の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。