@dotlabo/agent-chat-relay 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,109 @@
1
+ # 変更の履歴
2
+
3
+ `@dotlabo/agent-chat-relay` の、バージョンごとの変更です。新しいものを上に書きます。
4
+
5
+ 旧パッケージ `agent-chat-relay` の 0.1.1 までの変更は、[元のリポジトリのリリース](https://github.com/yamatakeru/agent-chat-relay/releases)にあります。このファイルは、そのあとの変更から書いています。`#番号` と ADR のリンクは、元のリポジトリのものです。
6
+
7
+ ## 0.2.0(2026-11-22)
8
+
9
+ 管理者の端末から、セッションに話しかけられるようにしたバージョンです。
10
+
11
+ ```sh
12
+ bun install -g @dotlabo/agent-chat-relay@0.2.0
13
+ ```
14
+
15
+ 旧パッケージ `agent-chat-relay` から移る場合は、下の「@dotlabo/agent-chat-relay 0.1.1」の「パッケージの名前」の手順で入れ直してください。
16
+
17
+ ### 管理者の端末
18
+
19
+ - `serve` を動かしたまま、別の端末で `agent-chat-relay terminal` を実行すると、同じセッションに管理者として参加できるようにしました。話しかける、途中経過(ツールの実行とエージェントの文)を見る、実行承認に `yes <ID>`・`no <ID>`・`always <ID>` で答える、ができます。画面は Esc か `/quit` で抜けます。抜けても、中継とセッションは動き続けます。
20
+ - 端末の人は、ペアリングを経ずに、`serve` の間だけ承認者になります。`access.json` には書きません。
21
+ - 端末とルームの間では、作業に差し込みません。ルームの作業中に端末から送った発言は、その作業が終わってから渡ります。急ぐときは、`/now <本文>` でルームの作業に差し込みます。
22
+ - チャットサービスの秘密情報がなくても、`serve` が端末だけで起動するようにしました。端末でエージェントに設定やルールを教えてから、`serve --session-id <id>` で同じセッションにルームをつなげます。
23
+ - 端末で話した内容は、ほかのルームの人もエージェントから引き出せます。端末に秘密情報を入力しないでください。
24
+
25
+ ### 実行承認
26
+
27
+ - `serve` の間は、端末の人がいつも承認者に入ります。そのため、許可リストに承認者がいなくても、承認依頼はすぐには拒否されなくなりました。依頼は端末に届き(画面を開いていなければ、開いたときに出し直します)、答えがなければ、今までどおり 30 分で拒否します。
28
+
29
+ ### 安全境界
30
+
31
+ - `serve` は、`<RELAY_HOME>/terminal.sock`(Unix ソケット)で待ち受け、起動のたびに作るトークンを `<RELAY_HOME>/terminal.token` に置きます。どちらも権限は 0600 です。TCP のポートは開きません。
32
+ - 対象のパスがトークンかソケットを含む依頼は、承認者に尋ねずに拒否し、中継のログに残します。Claude Code と pi のどちらでも拒否します。次の場合は例外です。
33
+ - pi で、モデルの提供元がツールの呼び出しに ID を付けないとき(ID を返さない OpenAI 互換のサーバーなど)は、拒否はしますが、ログには残りません。ログがないことは、接続用のファイルへの依頼がなかったことの証拠にはなりません。
34
+ - pi で、端末の設定を引き継いだとき(`--harness-settings default`)に読み込む拡張は、ツールの入力を書き換えて、この拒否を迂回しえます。
35
+ - Claude Code では、対象のディレクトリがトークンかソケットを含む読み取り・検索の依頼には、「常に許可」を出しません。読み取りの「常に許可」が、ファイルのディレクトリ全体に効くためです。
36
+ - Bash など、対象のパスを示さない依頼は、見分けられません。`<RELAY_HOME>` に触れるコマンドを許可すると、エージェントがトークンを読み、端末の人として自分の依頼に答えられるようになります。許可しないでください。
37
+
38
+ ### 起動しない場合
39
+
40
+ - 同じ `RELAY_HOME` で、ほかの中継がソケットで待ち受けているとき。動かせる中継は 1 つです。異常終了で残ったソケットとトークンは、次の起動で片付けます。
41
+ - ソケットのパスに、ソケットでないもの(通常のファイル、シンボリックリンクなど)があるとき。トークンのパスに、通常のファイルでないものがあるとき。
42
+ - `RELAY_HOME` のパスが長すぎる(ソケットのパスが 103 バイトを超える)とき。
43
+
44
+ ### 対応状況
45
+
46
+ - Discord:実環境で確認しました。
47
+ - pi:Linux(x86_64)で、配布物のテストが通ることを確認しました。
48
+ - そのほかは、`@dotlabo/agent-chat-relay` の 0.1.1 から変わりません(README の「対応状況」)。
49
+
50
+ ## @dotlabo/agent-chat-relay 0.1.1(2026-11-21)
51
+
52
+ npm のパッケージの名前を `@dotlabo/agent-chat-relay` に変えて、最初に公開したバージョンです。同じ 0.1.1 でも、旧パッケージ `agent-chat-relay` の 0.1.1 とは中身が違います。旧パッケージの 0.1.1 のあとに入った、下の変更を含みます。
53
+
54
+ ### パッケージの名前
55
+
56
+ - npm のパッケージを `@dotlabo/agent-chat-relay` に変えました。旧パッケージ `agent-chat-relay` は非推奨にしました。コマンド(`agent-chat-relay`、`ac-relay`)と、データの置き場(`~/.agent-chat-relay/`)は変わりません。
57
+ - 旧パッケージから移る場合は、先に旧パッケージを外してから、新しいパッケージを入れてください。
58
+
59
+ ```sh
60
+ bun remove -g agent-chat-relay
61
+ bun install -g @dotlabo/agent-chat-relay
62
+ ```
63
+
64
+ npm で入れていた場合は、`npm uninstall -g agent-chat-relay` のあとに `npm install -g @dotlabo/agent-chat-relay` です。
65
+
66
+ ### pi
67
+
68
+ - pi を同梱し、`agent-chat-relay serve pi` で起動できるようにしました([#104](https://github.com/yamatakeru/agent-chat-relay/pull/104)、[ADR 0027](https://github.com/yamatakeru/agent-chat-relay/blob/main/docs/adr/0027-harness-approval-and-settings.md))。pi を別にインストールする必要はありません。
69
+ - 中継専用のモデルと API キーを、`<RELAY_HOME>/pi/agent/` に用意します。`settings.json`(例 `{"defaultProvider":"anthropic","defaultModel":"利用するモデルのID"}`)と `auth.json`(例 `{"anthropic":{"type":"api_key","key":"中継専用のAPIキー"}}`)を、権限 0600 で置きます。端末の pi の認証は引き継がず、中継から対話式のログインはしません。
70
+ - チャット用ツールは MCP で渡し、ファイルの変更やシェルなどは、承認者に実行承認を依頼します。
71
+ - pi の設定・認証・状態は、既定で端末のものと分けます。`--harness-settings default` を指定したときだけ、端末とプロジェクトの指示・設定・拡張を読み込みます。拡張は、中継の実行承認を通らずに動くことがあるので、信頼できるものに限ってください。
72
+ - pi では、`--harness-memory`(`RELAY_HARNESS_MEMORY`)を指定すると起動しません。
73
+
74
+ ### 実行承認の送り先
75
+
76
+ - 承認依頼を、そのターンの依頼者が 1 人に決まれば、その人だけに送るようにしました([#103](https://github.com/yamatakeru/agent-chat-relay/pull/103)、[ADR 0026](https://github.com/yamatakeru/agent-chat-relay/blob/main/docs/adr/0026-route-permission-requests-to-requester.md))。1 人に決まらないときは、Jev(TypeSafe AI の判定モデル)で依頼者を推します。推せなければ、今までどおり承認者の全員に送り、文面にそのターンの依頼者とほかの発言の送り手を並べます。
77
+ - Jev は、`agent-chat-relay secrets typesafe` で API キーを保存したときだけ使います。推した確率の下限は `RELAY_JEV_MIN_PROBABILITY`(既定 0.8、0 より大きく 1 以下)で変えられます。
78
+
79
+ ### 受信モードと、エージェントへの案内
80
+
81
+ - ルームの受信モードに、次の 2 つを足しました([#106](https://github.com/yamatakeru/agent-chat-relay/pull/106)・[#109](https://github.com/yamatakeru/agent-chat-relay/pull/109)、[ADR 0028](https://github.com/yamatakeru/agent-chat-relay/blob/main/docs/adr/0028-except-messages-to-others.md)・[ADR 0029](https://github.com/yamatakeru/agent-chat-relay/blob/main/docs/adr/0029-screen-messages-to-others-with-jev.md))。外した発言は、エージェントに渡さずに記録だけします。
82
+ - 「他人宛てを除く」(`exceptOthers`):Bot へのメンションがなく、ほかの人へのメンションか、ほかの人の発言への返信・引用がある発言を外します。
83
+ - 「他人宛てを除く(Jev)」(`exceptOthersJev`):上に加えて、メンションも返信もない発言を Jev で判定し、名前で特定の人に呼びかけただけの発言や、それへの返事も外します。そのルームの発言を TypeSafe AI に送るので、ルームの人に断ってから使ってください。一緒に送る直前の発言の数は、`RELAY_JEV_CONTEXT_MESSAGES`(既定 10、0〜30)で変えられます。Jev の API キーがなければ、起動時と `access mode` で警告し、「他人宛てを除く」と同じに動きます。
84
+ - 受信モードは、`agent-chat-relay access mode <番号か ID> <mention|exceptOthers|exceptOthersJev|all>` で変えます。番号は `agent-chat-relay access` の一覧のものです。
85
+ - 受信モードを `access.json` の `receive` に持つようにしました。古い形(`requireMention`)は読み替え、保存するときに書き換えます。
86
+ - エージェントへの案内を変えました。メンション(DM を含む)の発言には `mentioned="true"` を付け、`list_rooms` には各ルームの受信モードを付けます。メンションのない発言では、だれに向けたかを書いていない問いかけや、全員に向けた問いには答え、特定のほかの人に向けた発言や雑談には黙るように案内します。
87
+
88
+ ### ルームへの知らせ
89
+
90
+ - エージェントが返事をできないとき、ルームに固定の知らせを出すようにしました([#91](https://github.com/yamatakeru/agent-chat-relay/pull/91)・[#92](https://github.com/yamatakeru/agent-chat-relay/pull/92)、[ADR 0024](https://github.com/yamatakeru/agent-chat-relay/blob/main/docs/adr/0024-notify-rooms-when-turn-stalls.md))。知らせは、そのターンでメンションのあったルームにだけ出します。
91
+ - 失敗:ハーネスへの依頼が失敗した、またはハーネスが異常終了した。
92
+ - 承認待ち:承認依頼に答えが出ないまま、10 分たった(`RELAY_APPROVAL_NOTICE_MIN`、1〜29)。
93
+ - 時間がかかっている:返事もターンの終わりもないまま、20 分たった(`RELAY_SLOW_NOTICE_MIN`、1〜1440)。
94
+ - 返事のない終わり:ルームに返事をしないまま、ターンが終わった。
95
+ - LINE では、Reply トークンがないとき、1 対 1 のトークでだけ Push で知らせます。グループと複数人トークでは送りません(人数分の通数になるため)。
96
+
97
+ ### 作業ディレクトリ
98
+
99
+ - 既定の作業ディレクトリ(`<RELAY_HOME>/workspace`)が独立した git リポジトリかを、git に確かめるようにしました([#91](https://github.com/yamatakeru/agent-chat-relay/pull/91))。`RELAY_WORKSPACE`(`--workspace`)で指定した作業ディレクトリの扱いは変わりません。
100
+ - 画像は、中継では縮小せず、ハーネスに縮小させます([#91](https://github.com/yamatakeru/agent-chat-relay/pull/91))。
101
+
102
+ ### 起動しない場合
103
+
104
+ - 既定の作業ディレクトリで、次のとき。エラーの文に直し方を書いています。
105
+ - git がないとき。
106
+ - `.git` がシンボリックリンクか、`gitdir:` を書いたファイルのとき。
107
+ - 中身のある `.git` が、git から見て作業ディレクトリ自身のリポジトリになっていないとき(壊れている、別の場所を指している、など)。
108
+ - リポジトリの場所を変える git の環境変数(`GIT_DIR`・`GIT_WORK_TREE`・`GIT_COMMON_DIR`・`GIT_OBJECT_DIRECTORY`・`GIT_INDEX_FILE`)に値があるとき。
109
+ - 上に書いた環境変数(`RELAY_APPROVAL_NOTICE_MIN`・`RELAY_SLOW_NOTICE_MIN`・`RELAY_JEV_MIN_PROBABILITY`・`RELAY_JEV_CONTEXT_MESSAGES`)が、範囲の外のとき。`RELAY_JEV_MIN_PROBABILITY` のほかは、整数でないときも起動しません。
package/README.md CHANGED
@@ -10,17 +10,18 @@ LINE・Chatwork・Discord のルームから、Claude Code などのコーディ
10
10
  - エージェントは、ほかのルームへの投稿、過去の発言の参照、添付ファイルの受け取りと送信ができます。
11
11
  - エージェントがファイルの書き込みやコマンドの実行をするときは、承認者の DM に承認を依頼します。
12
12
  - ルームと承認者は、ペアリング用のコードで登録します。
13
+ - 管理者は、中継の PC の端末から、同じセッションに話しかけ、途中経過を見て、承認に答えられます。チャットサービスを設定する前に、端末だけで始めることもできます。
13
14
 
14
15
  ## 対応状況
15
16
 
16
17
  | 種類 | 対象 | 状況 |
17
18
  |---|---|---|
18
- | チャットサービス | LINE | 対応済み(実環境で確認済み) |
19
- | | Chatwork・Discord | 対応済み(モックで確認済み。実環境では未確認) |
19
+ | チャットサービス | LINE・Discord | 対応済み(実環境で確認済み) |
20
+ | | Chatwork | 対応済み(モックで確認済み。実環境では未確認) |
20
21
  | | LINE WORKS | 未対応 |
21
22
  | ハーネス | Claude Code | 対応済み |
22
- | | pi | macOS(Apple Silicon)でモックを使って確認済み。Linux は [#23](https://github.com/Dot-labo/harness-chat-adapter/issues/23) で確認予定 |
23
- | | OpenCode | 試験的。実行承認が働かないため、既定では起動しません([#7](https://github.com/Dot-labo/harness-chat-adapter/issues/7)) |
23
+ | | pi | macOS(Apple Silicon)でモックを使って確認済み。Linux(x86_64)は配布物のテストが通ることのみ確認済み。Linux(arm64)は未確認 |
24
+ | | OpenCode | 試験的。実行承認が働かないため、既定では起動しません([#7](https://github.com/Dot-labo/agent-chat-relay/issues/7)) |
24
25
  | OS | macOS(Apple Silicon) | 動作確認済み |
25
26
  | | Ubuntu 24.04(x86_64) | CI でテストが通ることのみ確認済み |
26
27
 
@@ -40,6 +41,8 @@ bun install -g @dotlabo/agent-chat-relay
40
41
 
41
42
  `npm install -g @dotlabo/agent-chat-relay` でもインストールできます(実行には Bun を使います)。コマンドは `agent-chat-relay` で、`ac-relay` という短い別名もあります。
42
43
 
44
+ バージョンごとの変更は、パッケージに入れた `CHANGELOG.md` にあります。旧パッケージ `agent-chat-relay` から移る場合も、そこを読んでください。
45
+
43
46
  ## 使い方
44
47
 
45
48
  Chatwork を使う場合の流れです。Bot のアカウントの準備や、LINE・Discord を使う場合の手順は [docs/relay-setup.md](docs/relay-setup.md) を参照してください。
@@ -67,6 +70,29 @@ agent-chat-relay serve --workspace .
67
70
 
68
71
  中継のデータ(ルームの登録、許可リスト、秘密情報、作業ディレクトリ、ログ)は `~/.agent-chat-relay/` に置きます。`RELAY_HOME` で変えられます。
69
72
 
73
+ ### 管理者の端末から話しかける
74
+
75
+ `serve` を動かしたまま、別の端末で `agent-chat-relay terminal` を実行すると、同じセッションに管理者として参加できます。話しかける、途中経過(ツールの実行とエージェントの文)を見る、実行承認に `yes <ID>`・`no <ID>`・`always <ID>` で答える、ができます。画面は Esc か `/quit` で抜けます。抜けても、中継とセッションは動き続けます。
76
+
77
+ 端末とルームの間では、作業に差し込みません。ルームの作業中に端末から送った発言は、その作業が終わってから渡ります。急ぐときは `/now <本文>` で送ると、ルームの作業に差し込みます。端末で話した内容は、ほかのルームの人もエージェントから引き出せるので、秘密情報は入力しないでください([docs/relay.md](docs/relay.md#管理者の端末)、ADR 0030)。
78
+
79
+ チャットサービスを設定する前に、端末だけで始めて、あとからルームをつなぐこともできます。
80
+
81
+ ```sh
82
+ # 1. チャットサービスの秘密情報なしで起動する(端末だけで動く)
83
+ agent-chat-relay serve
84
+ # 起動ログの「セッションを開始しました」の sessionId を控える
85
+
86
+ # 2. 別の端末で参加し、エージェントに設定やルールを教える
87
+ agent-chat-relay terminal
88
+
89
+ # 3. serve を Ctrl+C で止め、チャットサービスの秘密情報を保存する
90
+ agent-chat-relay secrets line
91
+
92
+ # 4. 同じセッションで起動し直す(教えた内容を覚えている)
93
+ agent-chat-relay serve --session-id <控えた sessionId>
94
+ ```
95
+
70
96
  ## 秘密情報の管理
71
97
 
72
98
  チャットサービスのトークンなどの秘密情報は、`agent-chat-relay secrets` で `~/.agent-chat-relay/.env` に保存します。ファイルは平文で、権限を 0600(自分だけが読み書きできる)にします。
@@ -127,7 +153,3 @@ agent-chat-relay secrets chatwork # 使っているサービスの分だけ、
127
153
  | [docs/releasing.md](docs/releasing.md) | npm へのリリースの手順 |
128
154
  | [docs/adr/](docs/adr/) | 設計判断の記録 |
129
155
  | [GLOSSARY.md](GLOSSARY.md) | 用語集 |
130
-
131
- ## 経緯
132
-
133
- 当初は cc-connect の外部アダプターとして作っていました。その実装と記録は、タグ `cc-connect-final` の `old/` にあります。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotlabo/agent-chat-relay",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
4
  "description": "LINE・Chatwork・Discord のルームから、Claude Code などのコーディングエージェントに作業を依頼するための中継サーバー(ACP・MCP)",
5
5
  "license": "MIT",
6
6
  "publishConfig": {
@@ -28,7 +28,8 @@
28
28
  },
29
29
  "files": [
30
30
  "bin/",
31
- "src/"
31
+ "src/",
32
+ "CHANGELOG.md"
32
33
  ],
33
34
  "engines": {
34
35
  "bun": ">=1.4.0"
@@ -53,11 +54,14 @@
53
54
  "@modelcontextprotocol/sdk": "1.32.2",
54
55
  "cross-spawn": "7.0.6",
55
56
  "discord.js": "14.28.1",
57
+ "ink": "8.0.0",
56
58
  "pi-acp-protocol-sdk": "npm:@agentclientprotocol/sdk@0.26.0",
59
+ "react": "19.3.1",
57
60
  "zod": "4.6.7"
58
61
  },
59
62
  "devDependencies": {
60
- "@types/bun": "1.4.4",
63
+ "@types/bun": "1.4.5",
64
+ "@types/react": "19.3.0",
61
65
  "fallow": "3.44.0",
62
66
  "fast-check": "4.10.3",
63
67
  "oxlint": "1.94.0",
@@ -0,0 +1,367 @@
1
+ // 管理者の端末のコネクター(ADR 0030)。<RELAY_HOME> の Unix ソケットで、agent-chat-relay terminal の画面とつなぐ。
2
+ // 端末は今のセッションの 1 つのルーム(terminal:local)で、端末の人は組み込みの承認者(AccessStore の builtin)。
3
+ // 端末とルームの間では、作業に差し込まない(ownTurns)。途中経過と中継の状態は、端末にだけ流す
4
+
5
+ import { randomBytes, randomUUID, timingSafeEqual } from "node:crypto"
6
+ import { chmodSync, lstatSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, type Stats } from "node:fs"
7
+ import { createConnection, createServer, type Server, type Socket } from "node:net"
8
+ import { dirname, join } from "node:path"
9
+ import { truncate } from "./common.ts"
10
+ import type { Connector, Log, Progress, Relay, RelayEvent, RelayStatus } from "../core/relay.ts"
11
+
12
+ export const TERMINAL_SERVICE = "terminal"
13
+ /** 端末のルームと、端末の人の ID。DM と同じく、ルームの ID が相手の ID になる */
14
+ export const TERMINAL_ID = `${TERMINAL_SERVICE}:local`
15
+
16
+ /** 端末の画面へ送るもの。approval と status 以外は、あとから接続した画面にも見せる(履歴。keeps) */
17
+ export type TerminalEvent =
18
+ /** 端末から送った発言 */
19
+ | { type: "input"; text: string; cutIn?: boolean }
20
+ /** エージェントが端末へ送った返事 */
21
+ | { type: "reply"; text: string }
22
+ /** エージェントがほかのルームへ送った発言。room はルームの名前(なければ ID) */
23
+ | { type: "sent"; room: string; text: string }
24
+ | { type: "progress"; progress: Progress }
25
+ | { type: "approval"; text: string }
26
+ | { type: "notice"; text: string }
27
+ | { type: "status"; status: RelayStatus }
28
+
29
+ /** 画面に並べるもの(状態のほか) */
30
+ export type HistoryEvent = Exclude<TerminalEvent, { type: "status" }>
31
+
32
+ /** 端末の画面から送るもの。最初の 1 行は接続用のトークン。cutIn は、ほかのルームの作業中でも差し込む(/now) */
33
+ export type TerminalFrame = { token: string } | { text: string; cutIn?: boolean }
34
+
35
+ export function terminalPaths(home: string): { socket: string; token: string } {
36
+ return { socket: join(home, "terminal.sock"), token: join(home, "terminal.token") }
37
+ }
38
+
39
+ /** 1 行(1 つの JSON)の上限 */
40
+ const MAX_FRAME = 64 * 1024
41
+ /** 端末から送れる本文の上限 */
42
+ export const MAX_INPUT = 16_000
43
+ /** 途中経過のツールの名前の上限。画面は 200 字までしか出さない */
44
+ const MAX_TITLE = 2000
45
+ /** 履歴に残す上限(件数と、本文の合計の文字数) */
46
+ const MAX_EVENTS = 300
47
+ const MAX_CHARS = 128 * 1024
48
+ /** 送りきれずにたまった量がこれを超えた画面は、切る(遅い画面で中継を止めない) */
49
+ const MAX_UNSENT = 1024 * 1024
50
+ /** Unix ソケットのパスの上限(macOS の sun_path は 104 バイトで、終端を含む) */
51
+ const MAX_SOCKET_PATH = 103
52
+ /** 接続してからトークンを受け取るまでの時間 */
53
+ const AUTH_TIMEOUT_MS = 5000
54
+
55
+ /** JSON Lines を 1 行ずつ渡す。上限を超えた行があれば onInvalid を呼ぶ。chunk は setEncoding("utf8") で受けた文字列 */
56
+ export function readLines(onLine: (line: string) => void, onInvalid: () => void): (chunk: string) => void {
57
+ let pending = ""
58
+ return (chunk) => {
59
+ pending += chunk
60
+ for (let end = pending.indexOf("\n"); end >= 0; end = pending.indexOf("\n")) {
61
+ const line = pending.slice(0, end)
62
+ pending = pending.slice(end + 1)
63
+ if (line.length > MAX_FRAME) return onInvalid()
64
+ if (line.trim()) onLine(line)
65
+ }
66
+ if (pending.length > MAX_FRAME) onInvalid()
67
+ }
68
+ }
69
+
70
+ /** 画面から受けた 1 行。形が違えば undefined */
71
+ function parseFrame(line: string): TerminalFrame | undefined {
72
+ let v: unknown
73
+ try {
74
+ v = JSON.parse(line)
75
+ } catch {
76
+ return undefined
77
+ }
78
+ if (typeof v !== "object" || v === null) return undefined
79
+ const f = v as Record<string, unknown>
80
+ if (typeof f.token === "string") return { token: f.token }
81
+ if (typeof f.text === "string" && (f.cutIn === undefined || typeof f.cutIn === "boolean")) return { text: f.text, ...(f.cutIn ? { cutIn: true } : {}) }
82
+ return undefined
83
+ }
84
+
85
+ function eventChars(e: HistoryEvent): number {
86
+ if (e.type !== "progress") return e.text.length
87
+ return e.progress.kind === "text" ? e.progress.text.length : e.progress.title.length
88
+ }
89
+
90
+ /**
91
+ * 履歴に 1 つ足す。エージェントの文の続きは前の文につなぎ、同じツールの更新は、そのツールの行を置き換える。
92
+ * 上限を超えたら古いものから捨てる。中継の履歴と、画面の表示の両方で使う
93
+ */
94
+ export function appendEvent(list: HistoryEvent[], e: HistoryEvent, maxEvents = MAX_EVENTS, maxChars = MAX_CHARS): HistoryEvent[] {
95
+ const last = list.at(-1)
96
+ let next: HistoryEvent[]
97
+ if (e.type === "progress" && e.progress.kind === "text" && last?.type === "progress" && last.progress.kind === "text") {
98
+ next = [...list.slice(0, -1), { type: "progress", progress: { kind: "text", text: (last.progress.text + e.progress.text).slice(-MAX_INPUT) } }]
99
+ } else if (e.type === "progress" && e.progress.kind === "tool") {
100
+ const id = e.progress.id
101
+ const i = list.findLastIndex((x) => x.type === "progress" && x.progress.kind === "tool" && x.progress.id === id)
102
+ next = i >= 0 ? list.with(i, e) : [...list, e]
103
+ } else next = [...list, e]
104
+ let chars = next.reduce((n, x) => n + eventChars(x), 0)
105
+ let drop = 0
106
+ while (next.length - drop > maxEvents || (chars > maxChars && next.length - drop > 1)) chars -= eventChars(next[drop++]!)
107
+ return next.slice(drop)
108
+ }
109
+
110
+ /** 履歴に残すか。答えていない承認依頼は中核が出し直し、状態は今のものだけを見せるので、残さない */
111
+ function keeps(e: TerminalEvent): e is Exclude<HistoryEvent, { type: "approval" }> {
112
+ return e.type !== "status" && e.type !== "approval"
113
+ }
114
+
115
+ function lstatOrUndefined(path: string): Stats | undefined {
116
+ try {
117
+ return lstatSync(path)
118
+ } catch (err) {
119
+ if ((err as NodeJS.ErrnoException).code === "ENOENT") return undefined
120
+ throw err
121
+ }
122
+ }
123
+
124
+ /**
125
+ * 途中経過を、1 行の上限(MAX_FRAME)に収まる長さに切る。Bash のツールの名前はコマンドの全文(claude-agent-acp)で、
126
+ * 長いヒアドキュメントで上限を超えると、画面がつなぎを切り、入り直すたびに履歴で同じことが起きる
127
+ */
128
+ function fitProgress(p: Progress): Progress {
129
+ return p.kind === "tool" ? { ...p, title: truncate(p.title, MAX_TITLE) } : { ...p, text: truncate(p.text, MAX_INPUT) }
130
+ }
131
+
132
+ /** ファイルの中身。読めなければ undefined(止めるときに、確かめられないものは消さない) */
133
+ function readOrUndefined(path: string): string | undefined {
134
+ try {
135
+ return readFileSync(path, "utf8")
136
+ } catch {
137
+ return undefined
138
+ }
139
+ }
140
+
141
+ /** そのソケットで、ほかの中継が接続を受け付けているか。受け付けていなければ(接続拒否)、異常終了で残ったもの */
142
+ function answers(path: string): Promise<boolean> {
143
+ return new Promise((resolve, reject) => {
144
+ const probe = createConnection(path)
145
+ probe.setTimeout(1000, () => {
146
+ probe.destroy()
147
+ reject(new Error(`${path} の確認が時間切れになりました。動いている中継がないか確かめてから、起動し直してください`))
148
+ })
149
+ probe.once("connect", () => {
150
+ probe.destroy()
151
+ resolve(true)
152
+ })
153
+ probe.once("error", (err: NodeJS.ErrnoException) => {
154
+ probe.destroy()
155
+ if (err.code === "ECONNREFUSED" || err.code === "ENOENT") resolve(false)
156
+ else reject(err)
157
+ })
158
+ })
159
+ }
160
+
161
+ /**
162
+ * 前の中継が異常終了(SIGKILL など)で残したソケットを片付ける。
163
+ * 動いている中継のソケットと、ソケットでないもの(通常のファイル、シンボリックリンクなど)には触らず、起動をやめる。
164
+ * トークンには触らない。トークンは、ソケットで待ち受けられた中継だけが置き換える(writeToken)。待ち受けは 1 つの中継しかできないので、同時に起動しても、動いている中継のトークンを消さない
165
+ */
166
+ export async function clearStale(paths: { socket: string }): Promise<void> {
167
+ const socket = lstatOrUndefined(paths.socket)
168
+ if (!socket) return
169
+ if (!socket.isSocket())
170
+ throw new Error(`${paths.socket} がソケットではありません(ファイルやシンボリックリンクなど)。中継は触りません。中身を確かめ、退避してから起動してください`)
171
+ if (await answers(paths.socket)) throw new Error(`別の中継が ${paths.socket} で動いています。同じ RELAY_HOME では、中継を 1 つだけ起動できます`)
172
+ // 確かめている間に置き換わったものは消さない
173
+ const again = lstatOrUndefined(paths.socket)
174
+ if (!again) return
175
+ if (again.ino !== socket.ino || again.dev !== socket.dev)
176
+ throw new Error(`${paths.socket} が確かめている間に置き換わりました。動いている中継がないか確かめてから、起動し直してください`)
177
+ unlinkSync(paths.socket)
178
+ }
179
+
180
+ /** 異常終了で残ったトークンを消し、新しいトークンを書く。通常のファイルでないもの(シンボリックリンクなど)には触らず、起動をやめる */
181
+ export function writeToken(path: string, token: string): void {
182
+ const old = lstatOrUndefined(path)
183
+ if (old && !old.isFile()) throw new Error(`${path} が通常のファイルではありません(シンボリックリンクなど)。中継は触りません。中身を確かめ、退避してから起動してください`)
184
+ if (old) unlinkSync(path)
185
+ // 消したあとに置かれたもの(シンボリックリンクを含む)には書かない
186
+ writeFileSync(path, token, { mode: 0o600, flag: "wx" })
187
+ }
188
+
189
+ export class TerminalConnector implements Connector {
190
+ readonly service = TERMINAL_SERVICE
191
+ readonly label = "管理者の端末"
192
+ readonly ownTurns = true
193
+ readonly capabilities = { text: { max: MAX_INPUT, parts: 1 } }
194
+ private readonly paths
195
+ private server?: Server
196
+ private token = ""
197
+ /**
198
+ * 作ったソケットとトークン。止めるときに、同じものだけを消す。
199
+ * Linux(ext4 など)は消したファイルの inode の番号をすぐ使い回すので、トークンは中身も比べる
200
+ */
201
+ private created: { path: string; ino: number; dev: number; content?: string }[] = []
202
+ private readonly clients = new Set<Socket>()
203
+ private backlog: HistoryEvent[] = []
204
+ private unobserve?: () => void
205
+
206
+ constructor(
207
+ private readonly relay: Relay,
208
+ home: string,
209
+ private readonly log: Log,
210
+ /** 接続してからトークンを受け取るまでの時間(テストで短くする) */
211
+ private readonly authTimeoutMs = AUTH_TIMEOUT_MS,
212
+ ) {
213
+ this.paths = terminalPaths(home)
214
+ }
215
+
216
+ async start(): Promise<void> {
217
+ if (Buffer.byteLength(this.paths.socket) > MAX_SOCKET_PATH)
218
+ throw new Error(`端末のソケットのパスが長すぎます(${MAX_SOCKET_PATH} バイトまで): ${this.paths.socket}。RELAY_HOME を短いパスにしてください`)
219
+ mkdirSync(dirname(this.paths.socket), { recursive: true, mode: 0o700 })
220
+ await clearStale(this.paths)
221
+ const server = createServer((socket) => this.connect(socket))
222
+ await new Promise<void>((resolve, reject) => {
223
+ server.once("error", reject)
224
+ // 初めから自分だけが読み書きできるソケットにする
225
+ const mask = process.umask(0o177)
226
+ try {
227
+ server.listen(this.paths.socket, () => resolve())
228
+ } finally {
229
+ process.umask(mask)
230
+ }
231
+ })
232
+ this.server = server
233
+ try {
234
+ this.remember(this.paths.socket)
235
+ chmodSync(this.paths.socket, 0o600)
236
+ this.token = randomBytes(32).toString("base64url")
237
+ writeToken(this.paths.token, this.token)
238
+ this.remember(this.paths.token, this.token)
239
+ } catch (err) {
240
+ // 待ち受けたソケットを残さない
241
+ this.stop()
242
+ throw err
243
+ }
244
+ this.unobserve = this.relay.observe((e) => this.fromRelay(e))
245
+ this.log.info("管理者の端末のエンドポイントを開きました。別の端末で agent-chat-relay terminal を実行すると参加できます", { socket: this.paths.socket })
246
+ }
247
+
248
+ stop(): void {
249
+ this.unobserve?.()
250
+ for (const c of this.clients) c.destroy()
251
+ this.server?.close()
252
+ this.server = undefined
253
+ this.token = ""
254
+ for (const f of this.created) {
255
+ const st = lstatOrUndefined(f.path)
256
+ if (st && st.ino === f.ino && st.dev === f.dev && (f.content === undefined || readOrUndefined(f.path) === f.content)) unlinkSync(f.path)
257
+ }
258
+ this.created = []
259
+ }
260
+
261
+ private remember(path: string, content?: string): void {
262
+ const st = lstatSync(path)
263
+ this.created.push({ path, ino: st.ino, dev: st.dev, content })
264
+ }
265
+
266
+ private connect(socket: Socket): void {
267
+ let authed = false
268
+ socket.setEncoding("utf8")
269
+ socket.setTimeout(this.authTimeoutMs, () => socket.destroy())
270
+ socket.on("error", () => socket.destroy())
271
+ socket.on("close", () => {
272
+ if (this.clients.delete(socket)) this.log.info("管理者の端末が離れました")
273
+ })
274
+ socket.on(
275
+ "data",
276
+ readLines(
277
+ (line) => {
278
+ if (socket.destroyed) return
279
+ const frame = parseFrame(line)
280
+ if (!authed) {
281
+ if (!frame || !("token" in frame) || !this.matches(frame.token)) return void socket.destroy()
282
+ authed = true
283
+ socket.setTimeout(0)
284
+ this.clients.add(socket)
285
+ this.log.info("管理者の端末が接続しました")
286
+ this.write(socket, { type: "status", status: this.relay.status() })
287
+ for (const e of this.backlog) this.write(socket, e)
288
+ // 答えていない承認依頼は、履歴ではなく中核から出し直す
289
+ this.relay.remindPending(TERMINAL_ID)
290
+ return
291
+ }
292
+ if (!frame || !("text" in frame) || frame.text.length > MAX_INPUT || !frame.text.trim()) return void socket.destroy()
293
+ this.input(frame.text, frame.cutIn === true)
294
+ },
295
+ () => socket.destroy(),
296
+ ),
297
+ )
298
+ }
299
+
300
+ private matches(given: string): boolean {
301
+ const a = Buffer.from(given)
302
+ const b = Buffer.from(this.token)
303
+ return b.length > 0 && a.length === b.length && timingSafeEqual(a, b)
304
+ }
305
+
306
+ private input(text: string, cutIn: boolean): void {
307
+ this.broadcast({ type: "input", text, ...(cutIn ? { cutIn } : {}) })
308
+ this.relay.receive({
309
+ id: randomUUID(),
310
+ room: TERMINAL_ID,
311
+ sender: TERMINAL_ID,
312
+ senderName: "管理者",
313
+ text,
314
+ ts: Date.now(),
315
+ attachments: [],
316
+ isDM: true,
317
+ mentioned: true,
318
+ ...(cutIn ? { cutIn } : {}),
319
+ })
320
+ }
321
+
322
+ private fromRelay(e: RelayEvent): void {
323
+ switch (e.type) {
324
+ case "status":
325
+ return this.broadcast({ type: "status", status: e.status })
326
+ case "progress":
327
+ return this.broadcast({ type: "progress", progress: fitProgress(e.progress) })
328
+ case "sent":
329
+ // 端末への返事は、send が reply として流す
330
+ if (e.room !== TERMINAL_ID) this.broadcast({ type: "sent", room: e.name ?? e.room, text: truncate(e.text, 2000) })
331
+ }
332
+ }
333
+
334
+ private broadcast(e: TerminalEvent): void {
335
+ if (keeps(e)) this.backlog = appendEvent(this.backlog, e)
336
+ for (const c of this.clients) this.write(c, e)
337
+ }
338
+
339
+ private write(socket: Socket, e: TerminalEvent): void {
340
+ if (socket.writableLength > MAX_UNSENT) return void socket.destroy()
341
+ socket.write(`${JSON.stringify(e)}\n`)
342
+ }
343
+
344
+ async send(room: string, text: string): Promise<string[]> {
345
+ if (room !== TERMINAL_ID) throw new Error(`管理者の端末の ID は ${TERMINAL_ID} だけです`)
346
+ this.broadcast({ type: "reply", text: truncate(text, MAX_INPUT) })
347
+ return [randomUUID()]
348
+ }
349
+
350
+ async sendApproval(user: string, text: string): Promise<void> {
351
+ if (user === TERMINAL_ID) this.broadcast({ type: "approval", text })
352
+ }
353
+
354
+ async notice(room: string, text: string): Promise<boolean> {
355
+ if (room !== TERMINAL_ID) return false
356
+ this.broadcast({ type: "notice", text })
357
+ return true
358
+ }
359
+
360
+ async download(): Promise<string[]> {
361
+ throw new Error("管理者の端末の発言には、添付ファイルがありません")
362
+ }
363
+
364
+ async roomName(): Promise<string> {
365
+ return this.label
366
+ }
367
+ }
@@ -76,6 +76,11 @@ export class AccessStore {
76
76
  constructor(
77
77
  private readonly path: string,
78
78
  private readonly now: () => number = Date.now,
79
+ /**
80
+ * ペアリングなしに許可リストに入る人(管理者の端末。ADR 0030)。読むたびに足し、access.json には書かない。
81
+ * serve の間だけ許可し、端末のコネクターのない起動や他のコマンドには持ち越さない
82
+ */
83
+ private readonly builtin: readonly string[] = [],
79
84
  ) {}
80
85
 
81
86
  /** 受信のたびに読み直すので、登録や許可の変更に再起動は不要 */
@@ -84,24 +89,25 @@ export class AccessStore {
84
89
  try {
85
90
  raw = readFileSync(this.path, "utf8")
86
91
  } catch (err) {
87
- if ((err as NodeJS.ErrnoException).code === "ENOENT") return emptyAccess()
92
+ if ((err as NodeJS.ErrnoException).code === "ENOENT") return { ...emptyAccess(), allowFrom: this.withBuiltin([]) }
88
93
  throw err
89
94
  }
90
95
  try {
91
96
  const a = JSON.parse(raw) as Partial<Access>
92
- return { allowFrom: a.allowFrom ?? [], rooms: this.normalizeRooms(a.rooms ?? {}), pending: a.pending ?? {} }
97
+ return { allowFrom: this.withBuiltin(a.allowFrom ?? []), rooms: this.normalizeRooms(a.rooms ?? {}), pending: a.pending ?? {} }
93
98
  } catch {
94
99
  // 壊れたファイルは退避して、空の状態から始める。誰の発言も渡さない状態で動く(フェイルクローズ)
95
100
  renameSync(this.path, `${this.path}.corrupt-${this.now()}`)
96
101
  console.error(`relay: ${this.path} が壊れていたため脇へ移しました`)
97
- return emptyAccess()
102
+ return { ...emptyAccess(), allowFrom: this.withBuiltin([]) }
98
103
  }
99
104
  }
100
105
 
101
106
  save(a: Access): void {
102
107
  mkdirSync(dirname(this.path), { recursive: true, mode: 0o700 })
103
108
  const tmp = `${this.path}.tmp`
104
- writeFileSync(tmp, JSON.stringify(a, null, 2) + "\n", { mode: 0o600 })
109
+ const stored = { ...a, allowFrom: a.allowFrom.filter((u) => !this.builtin.includes(u)) }
110
+ writeFileSync(tmp, JSON.stringify(stored, null, 2) + "\n", { mode: 0o600 })
105
111
  chmodSync(tmp, 0o600)
106
112
  renameSync(tmp, this.path)
107
113
  }
@@ -153,6 +159,10 @@ export class AccessStore {
153
159
  return p
154
160
  }
155
161
 
162
+ private withBuiltin(allowFrom: string[]): string[] {
163
+ return [...allowFrom, ...this.builtin.filter((u) => !allowFrom.includes(u))]
164
+ }
165
+
156
166
  /** 登録したルームの受信モードを変える */
157
167
  setReceive(room: string, mode: ReceiveMode): void {
158
168
  const a = this.load()