Skip to main content

セッション間メッセージ

セッション間メッセージは、同じマシン上で同じユーザーアカウントで動作している 2 つの Qoder CLI セッションが、互いを検出してメッセージをやり取りできるようにする機能です。あるセッションから別のセッションに Task を引き継いだり、ファイルを渡したり、質問したりできます。ターミナル間でテキストをコピーする必要はありません。 作業が自然に複数のセッションにまたがる場合に向いています。たとえば、一方のターミナルでバックエンド、もう一方でフロントエンドを扱う場合や、長時間動作しているセッションに別のウィンドウから作業を渡す場合です。
Beta セッション間メッセージは現在 beta 機能であり、デフォルトでは有効になっていません。Qoder CLI を起動する前に環境変数で有効化します: QODER_FEATURE_CROSS_SESSION=1 qoder。 QODER_FEATURE_CROSS_SESSION=1 をユーザーレベル設定の .env に保存すると、以降のセッションで自動的に有効になります。ユーザーレベル設定のデフォルトパス: $HOME/.qoder/.env。.env を変更したら Qoder CLI を再起動してください。 この機能は Unix domain socket を使用するため、macOS と Linux でのみ利用できます。

仕組み

有効にすると、各セッションは専用の socket を待ち受け、そのパスをユーザーごとのレジストリに記録します。他のセッションはそのレジストリを読んで peer を検出し、直接接続してメッセージを配信します。
セッション A(ターミナル 1)             セッション B(ターミナル 2)
+-- 自分の socket を待ち受け             +-- 自分の socket を待ち受け
+-- B をメンション  ----------------> レジストリを読み、B を検出
`-- SendMessage --------------------> B の次のターンに配信
socket とそのディレクトリは、自分のユーザーアカウントからのみ読み取れます。同じマシン上の他のユーザーのセッションからは、参照も接続もできません。

peer の検出

/peers を実行すると、到達可能な peer セッションの一覧と、このセッション自身の handle を確認できます。Agent が自分から peer を探すことはありません。あなたが @ メンションでセッションを指定したとき、またはメッセージを送ってきたセッションに返信するときにだけ、相手に連絡します。
Peer sessions (3):
  api-service — interactive, idle, cwd /home/dev/api, handle -3f
  api-7c — interactive, busy, cwd /home/dev/api
  web-2b — interactive, idle, cwd /home/dev/web
セッションの名前は現在のタイトルです。そのため /rename を実行したときや、Agent が会話のタイトルを付け直したときに変わります。ステータス列も同じようにセッションを追跡し、Agent が作業中なら busy、確認を求めているなら waiting、ユーザーが shell プロンプトにいるなら shell、それ以外は idle になります。 タイトルのないセッションは、作業ディレクトリ名にそのセッションの handle(上の -7c)を付けた名前になります。これがないと同じディレクトリで作業しているセッションはすべて同じ名前になり、どれも指定できません。そのため /home/dev/api の 2 つのセッションは api が 2 つではなく、api-7c と api-3f として表示されます。 peer は行のラベルで指定するか、handle だけでも指定できます。handle はそのセッションが待ち受ける socket から導かれるので、どのセッションの一覧でも同じ値になり、セッションの名前が変わっても変わりません。-7c は、そのとき何という名前であってもそのセッションに届きます。タイトルのあるセッションは名前に handle を含まないため、行に handle -3f と明記されます。

プロンプトで peer をメンションする

@ に続けて 1 文字以上入力すると、ファイルや agent と並んで peer セッションが補完候補に出ます。peer の行は @ で始まり、session という説明と、そのセッションの状態および起動からの経過時間が付くため、同名のファイルと見分けられます。
@rev
  @reviewer         session · idle · started 3m ago
行を選ぶと、そのセッションを指す宛先ラベルが挿入されます。空白を含むラベルは、ファイルパスと同じように空白をエスケープした形で挿入されます。 セッションをメンションするのは「どれを指しているか」を Agent に伝えるだけで、それ自体は何も送信しません。同じメッセージ内で用件まで書くと——たとえば「@reviewer に CI を再実行するよう頼んで」——Agent が送信します。メンションしただけのメッセージでは送信されません。 その名前が複数の稼働中セッションに一致する場合、Agent にはそれぞれ 1 つだけを指すラベルの一覧が渡され、推測せずにどれを指しているか確認します。セッション名は各自が付けたもので検証できないため、曖昧なときに名前だけでセッションを宛先にすることはありません。 @ だけを入力しても peer セッションは列挙されません。どのセッションにも一致しないメンションは、書いたままテキストに残ります。

メッセージの送信

Agent は teammate に送るときと同じ SendMessage ツールを使い、宛先に peer の名前を指定します。絶対パスでファイルを添付でき、ファイルは受信側にコピーされて読めるようになります。 送信結果は正確に報告されます。peer がすでに終了している場合は、成功を装わずにその旨を返します。 Agent が peer にメッセージを送るのは、あなたが依頼したとき、または peer からのメッセージが返答を求めているときだけです。頼まれていない進捗報告や確認の返信は送りません。メンションせずにセッションへの連絡を頼んだ場合、Agent はメンションするよう求めます。あなたからのメッセージを挟まずに同じセッションへ 3 件送ると、あなたが次に書き込むまで、そのセッションへの送信は拒否されます。

受信内容の制御

各セッションは security.crossSessionInbound 設定によって、受信した peer メッセージの扱いを自分で決めます。
  • accept: そのセッションの次のターンに配信します。
  • hold: 確認待ちとして保留します。承認するまで Agent からは見えません。
  • refuse: すべて拒否します。配信されず、添付ファイルもディスクに書き込まれません。
未設定の場合のフォールバックは、そのセッションが権限をどう扱っているかで決まります。権限チェックを回避しているセッションは受信した peer メッセージを承認待ちとして保留します。そうしなければ peer が求めた操作が、以後の確認なしにそのまま実行されるためです。確認を求める設定のセッションはそのまま受け入れます。peer がそのセッションを使って、自分も受けるはずの確認を回避することはできないからです。 権限モードにかかわらず、送信元アドレスがこのマシンに登録されたどのセッションとも一致しないメッセージは承認待ちとして保留され、配信後は会話内のその行に (unregistered) と表示されます。アドレスは送信側が自己申告するものなので、これはこのマシンに記録のあるセッションと任意のアドレスを区別するだけで、送信者を証明するものではありません。このセッションが起動したプロセスからのメッセージは対象外です。 確認する人がいないセッション、つまり socket パスを明示して起動した非対話セッションでは、このフォールバックが保留するはずだったメッセージは代わりに拒否されます。起こり得ない確認を待たせるのではなく、送信側にすぐ結果を返すためです。そのようなセッションで peer からの指示を受け取りたい場合は、security.crossSessionInbound に accept を明示的に設定してください。自分で設定した値は、そのようなセッションでも常に尊重されます。 プロジェクトレベルの設定は制限を強める方向にのみ働きます。リポジトリにコミットされた設定で accept を hold に強めることはできますが、hold を accept に緩めることはできません。リポジトリの設定が自分の選択を上書きし得るため、/peers は有効な設定とその出所となるファイルを常に表示します。

保留されたメッセージの承認

信頼の判断を自動で決められずにメッセージが保留された場合、セッションは直接あなたに確認します。
Another session sent this one a message

From worker -7c (name and address are supplied by the sender and are not verified)
This session bypasses permission checks, and the sender did not declare its own.
Anything it asks for would run without a further prompt.

  統合テストを実行して失敗した項目を報告してください

  ❯ Deliver it to this session
    Decline — drop it and tell the sender
この確認は、このセッションが画面に出すもののうち最後に来ます。回答途中の権限確認やダイアログを中断することはなく、他に回答を求めているものがないときにだけ表示されます。承認すると次のターンで配信され、拒否するとメッセージは破棄され、その旨が送信側に伝えられます。表示される本文は短縮されており、承認時に配信されるのは全文です。添付ファイルは件数のみ示されます。メッセージ到着時にすでにコピーされており、拒否すると削除されるためです。 確認は同時に 1 件だけ、しかも画面が空いているときだけ行われます。他の確認やダイアログの表示中に届いたメッセージは保留され、そちらは /peers で確認します。表示中の確認が他のものに画面を譲った場合も、そのメッセージは期限を待たずにキューへ戻ります。 確認を待つ時間は general.dialogExpiry で決まり、既定は 5 分です。時間切れになるとメッセージは破棄され、送信側には「拒否された」ではなく「期限切れ」と伝わります。この違いは送信側の Agent が判断に使えます。never は他のダイアログの期限を取り除きますが、この確認には適用されません。応答のない確認が 1 件あるだけで、以降のすべてのメッセージが確認の機会を失うことを防ぐためです。 自分で hold を設定したために保留されたメッセージは、確認なしで保留されます。自分自身の恒常的な設定は問いかけではないからです。これらは /peers で確認します。 一方、リポジトリの設定ファイル由来の hold は確認を求めます。値は同じですが、それはあなたではなくリポジトリが下した判断なので、本来表示されるはずだった確認を黙って取り除くのではなく、あなたに問いかけます。

保留されたメッセージの確認

/peers を実行すると、有効なポリシー、到達可能な peer、確認待ちのメッセージを表示できます。
/peers
出力の 1 行目には、有効な受信ポリシーとその出所 — 自分の設定、リポジトリの設定、または権限モードによるフォールバック — が常に表示されます。フォールバックの場合は、個々のメッセージの判定結果ではなくルール自体が示されます。メッセージがまったく届かないときは、まずこの行を確認してください。リポジトリ設定による refuse は、理由を示す保留メッセージを一切生成しません。 保留された各メッセージには id、送信元、保留理由、内容のプレビューが表示されます。送信元は、相手が返信先として示したアドレスから導いた handle で識別され、/peers はそのアドレスに到達できるセッションがまだあるかどうかも示します。そのアドレスも隣の名前も検証されたものではありません。誰が送ったかを証明できるセッションはないからです。ただし handle は上の peer 一覧と突き合わせられます。名前は読むことしかできません。 id を指定して承認または拒否します。
/peers approve ab12cd34
/peers deny ab12cd34
承認するとメッセージは次のターンに投入されます。拒否すると破棄され、送信側には拒否されたことが通知されます。

peer メッセージにできること、できないこと

peer からのメッセージは、あなた本人の指示ではなく同僚からの依頼として扱われます。
  • 保留中の権限確認に対する、あなたの承認とは決してみなされません。
  • peer メッセージの先頭の / はプレーンテキストとして扱われ、slash command としては実行されません。
  • 権限の境界はセッションごとです。ある peer が拒否された操作を別のセッションに代行させようとした場合、受信側の Agent はそれを拒否し、あなたに報告します。
  • 受信側の Agent が peer の依頼に応じるのは、それがあなたから任されたタスクに役立つときだけで、返信するのはメッセージが返答を求めているときだけです。

セキュリティに関する注意

分離はファイル権限に依存しています。socket とそのディレクトリは自分のユーザーアカウントに限定されます。その境界の内側では、送信元が名乗る名前は暗号的に検証されないため、すでにあなたの権限で動作しているプロセスであれば任意の peer になりすませます。セッション間メッセージの信頼度は「自分のアカウントで動作しているすべてのもの」と同程度と考え、高い権限で動作しているセッションでは hold の使用を推奨します。

設定リファレンス

  • security.crossSessionInbound: accept、hold、refuse のいずれか。このセッションが受信する peer メッセージの扱いを制御します。
  • general.dialogExpiry: 60s、5m、10m、never のいずれか。承認の確認が何分待ってからメッセージを期限切れとして破棄するかを決めます。既定は 5m。自分の設定からのみ読み込み、リポジトリの設定からは読み込みません。