Hermes、Claude CLIプラグインを修正　引数なしツールによるフォールバック先への切り替えを解消

Nous Researchは9月22日、Hermesのプラグインカタログ更新をマージし、Claude Subscription DirectSDKの固定先コミットを`c92c27c`から`f1c1220`に変更して、5件の修正を取り込んだ。バージョン番号は0.3.0のままのため、バージョン文字列だけでは修正が適用されているか判別できない。カタログ経由でインストールしたユーザーは、コミット値を確認する必要がある。[マージ記録](https://github.com/NousResearch/hermes-agent/pull/118750)

この実験的なプラグインは、ログイン済みの公式Claude Code CLIを介してHermesからモデルを呼び出す。ネイティブの`stream-json`プロトコルを使用し、Python Agent SDKは不要だ。ツールの実行、人による承認、履歴の圧縮は引き続きHermesが担う。モデルへのリクエストごとに別プロセスを起動し、ローカルの中継機構で最初の上流リクエストだけを通すことで、CLIが自動復旧を試みる際に追加のモデル呼び出しが発生するのを防ぐ。[公式ドキュメント](https://hermes-agent.nousresearch.com/docs/plugins/claude-subscription-directsdk)

今回の引数なしツールに関する修正は、ストリーミングプロトコルの境界部分を扱うものだ。引数を必要としないツールでは空の`partial_json`が送られることがあるが、従来のコードは空文字列をそのまま解析していたため、応答の抽出を完了できなくなっていた。その後のリトライも単一リクエスト制限によって拒否され、最終的にHermesがフォールバックプロバイダーへ切り替わる可能性があった。固定先コミットのコードでは、空または空白のみの内容を`{}`に変換し、有効なツール呼び出しの提案をメインエージェントへ渡せるようにした。[問題分析](https://github.com/NousResearch/hermes-plugin-claude-subscription-directsdk/pull/3)、[修正コード](https://raw.githubusercontent.com/NousResearch/hermes-plugin-claude-subscription-directsdk/f1c1220/admission.py)

この問題は、エージェントシステムの障害が複数の層にまたがって波及することも浮き彫りにしている。有効なツール呼び出しがまずパーサーに誤判定され、リトライ制限によって問題が拡大し、最後にはセッションで使用するモデルまで変わる可能性がある。このことから、回帰テストでは出力だけでなく、実際に使用されたプロバイダー、上流リクエストの回数、ツールの結果が完全に保持されているかどうかも確認すべきだと考えられる。そうすることで、修正によって想定どおりのフローが復元されたかを判断し、既存のフォールバックルーティングが障害後も意図せず残っていないかを確認できる。

同時に取り込まれた変更では、Haiku 4.5がサポートしていない適応型思考パラメーター、ツールのトップレベルスキーマの組み合わせ条件に起因するHTTP 400、実行ファイルの検索パス、エラーメッセージの問題も修正された。エンジニアリングチームにとって、これらの修正はモデルによる回答拒否、インターフェースの形式エラー、中継層の障害を区別する助けとなり、インフラ障害をモデルの能力不足と誤認するケースを減らせる。[更新内容](https://github.com/NousResearch/hermes-agent/pull/118750)

導入には引き続きHermes 0.21.4以上とログイン済みのCLIが必要で、自分たちの引数なしツール、キャンセル操作、複数ターンの履歴リプレイを使って再テストする必要がある。メンテナーは、すべての履歴変換やモデルをまたいだリプレイの互換性を保証しているわけではないと明記している。ツール呼び出しの成功も、課金が同じになることの証明にはならない。ドキュメントのコスト数値はAPI料金に換算した参考値にすぎず、実際のサブスクリプション利用枠と超過料金は引き続きアカウント設定によって決まる。[導入上の制約](https://hermes-agent.nousresearch.com/docs/plugins/claude-subscription-directsdk)