claude-agent-sdk-python v0.1.65 リリース

概要

このバージョンではセッション管理の効率化、ローカルセッションのリモートストア移行機能、思考プロセスの表示制御、サーバー側のツール実行結果の可視化など、複数の新機能が追加されました。また、メッセージパーサーでサーバー側ツール呼び出しが喪失していたバグが修正され、ドキュメントの誤記も訂正されています。内部的には、CLIフラグの準備やセッションミラー機能の改善が行われ、バンドルされたClaude CLIもv2.1.118に更新されました。

何が変わったか

• ・SessionStore.list_session_summaries()というオプショナルプロトコルメソッドとfold_session_summary()ヘルパー関数を追加。これによりフルトランスクリプトを読み込まずにO(1)の効率でセッション一覧を返せるようになり、N個のセッションを取得する場合のラウンドトリップがNから1に削減される。
• ・import_session_to_store()メソッドを追加。ローカルディスクに保存されているセッションを任意のSessionStoreアダプターにリプレイでき、ローカルストレージからリモートストレージへの移行が可能になる。
• ・ThinkingConfigタイプにdisplayフィールドを追加し、CLIの--thinking-displayオプションとして転送。これによりOpus 4.7のデフォルト「omitted」動作をオーバーライドし、要約された思考テキストを受け取ることができるようになる。
• ・ServerToolUseBlockとAdvisorToolResultBlockという新しいコンテンツブロックタイプを追加。advisor、web_searchなどのサーバー実行ツール呼び出しと、それまで無視されていたその実行結果をサーフェスする。
• ・メッセージパーサーがserver_tool_useとadvisor_tool_resultコンテンツブロックを無視していたバグを修正。これにより、サーバー側ツール呼び出しのみを含むメッセージが、空のAssistantMessage(content=[])として到着する問題が解消される。
• ・permission_modeのドキュメント文字列の誤りを修正。dontAskが未承認ツールを拒否する動作として正しく説明され、autoがモデル分類器を使用することが明確化される。
• ・トランスポート層からの--debug-to-stderrの検出を削除し、CLIフラグ削除に向けた準備を実施。標準エラーへのパイピングは、stderrコールバックが登録されているかどうかのみに依存するようになる。
• ・セッションミラー追記時のバウンド付きリトライとUUID冪等性ドキュメントを追加。
• ・バンドルされたClaude CLIをバージョン2.1.118に更新。

影響

大規模なセッション管理を行う開発者は、list_sessions_from_store()の性能が飛躍的に向上することで、リアルタイム応答性が改善されます。既存のローカルセッションを扱う開発者は、移行ツールを使ってリモートストレージへの切り替えがスムーズに行えるようになります。メッセージ処理では、サーバー実行ツール結果の喪失バグが修正されるため、エージェントの意思決定ロジックを正確に追跡できるようになり、デバッグやモニタリングの精度が向上します。

対象ユーザー

Claude Agent SDKユーザー・AIエンジニア・Python開発者・エンタープライズアプリケーション開発者

ソース

claude-agent-sdk-python v0.1.65