@dotlabo/agent-chat-relay 0.0.0-stage → 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.
Files changed (40) hide show
  1. package/CHANGELOG.md +109 -0
  2. package/LICENSE +21 -0
  3. package/README.md +154 -2
  4. package/bin/agent-chat-relay +22 -0
  5. package/package.json +69 -4
  6. package/src/connectors/chatwork.ts +289 -0
  7. package/src/connectors/common.ts +106 -0
  8. package/src/connectors/discord.ts +335 -0
  9. package/src/connectors/http.ts +137 -0
  10. package/src/connectors/line-media.ts +63 -0
  11. package/src/connectors/line.ts +444 -0
  12. package/src/connectors/terminal.ts +367 -0
  13. package/src/core/access.ts +250 -0
  14. package/src/core/instructions.ts +21 -0
  15. package/src/core/mcp.ts +160 -0
  16. package/src/core/relay.ts +1063 -0
  17. package/src/core/retention.ts +44 -0
  18. package/src/harness/config.ts +137 -0
  19. package/src/harness/harness.ts +327 -0
  20. package/src/harness/log-file.ts +34 -0
  21. package/src/harness/pi/config.ts +51 -0
  22. package/src/harness/pi/state.ts +97 -0
  23. package/src/harness/pi/tool-approval.ts +128 -0
  24. package/src/harness/protect.ts +37 -0
  25. package/src/home.ts +67 -0
  26. package/src/jev.ts +201 -0
  27. package/src/main.ts +275 -0
  28. package/src/prompt.ts +12 -0
  29. package/src/serve-args.ts +56 -0
  30. package/src/shutdown.ts +52 -0
  31. package/src/terminal.ts +172 -0
  32. package/src/vendor/pi/adapter.js +3238 -0
  33. package/src/vendor/pi/managed-extension.ts +94 -0
  34. package/src/vendor/pi/managed-pi-rpc.ts +102 -0
  35. package/src/vendor/pi/managed-read.ts +99 -0
  36. package/src/vendor/pi/package.json +7 -0
  37. package/src/vendor/pi/pi-LICENSE +21 -0
  38. package/src/vendor/pi/pi-acp-LICENSE +21 -0
  39. package/src/version.ts +4 -0
  40. package/src/workspace.ts +117 -0
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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 yamato
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,155 @@
1
- # Temporary Holding Version
1
+ # agent-chat-relay
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ LINE・Chatwork・Discord のルームから、Claude Code などのコーディングエージェントに作業を依頼するための中継サーバーです。
4
+
5
+ ルームでの発言をエージェントのセッションに渡し、エージェントは MCP ツールを使ってルームに返信します。エージェントとは ACP(Agent Client Protocol)でやり取りするので、特定のエージェントに固有の機能には依存しません。設計の経緯は [ADR 0006](docs/adr/0006-own-core-drives-any-harness-over-acp.md) にあります。
6
+
7
+ ## 主な機能
8
+
9
+ - 登録したルームで Bot 宛ての発言があると、エージェントに渡して、返事をルームに投稿します。
10
+ - エージェントは、ほかのルームへの投稿、過去の発言の参照、添付ファイルの受け取りと送信ができます。
11
+ - エージェントがファイルの書き込みやコマンドの実行をするときは、承認者の DM に承認を依頼します。
12
+ - ルームと承認者は、ペアリング用のコードで登録します。
13
+ - 管理者は、中継の PC の端末から、同じセッションに話しかけ、途中経過を見て、承認に答えられます。チャットサービスを設定する前に、端末だけで始めることもできます。
14
+
15
+ ## 対応状況
16
+
17
+ | 種類 | 対象 | 状況 |
18
+ |---|---|---|
19
+ | チャットサービス | LINE・Discord | 対応済み(実環境で確認済み) |
20
+ | | Chatwork | 対応済み(モックで確認済み。実環境では未確認) |
21
+ | | LINE WORKS | 未対応 |
22
+ | ハーネス | Claude Code | 対応済み |
23
+ | | pi | macOS(Apple Silicon)でモックを使って確認済み。Linux(x86_64)は配布物のテストが通ることのみ確認済み。Linux(arm64)は未確認 |
24
+ | | OpenCode | 試験的。実行承認が働かないため、既定では起動しません([#7](https://github.com/Dot-labo/agent-chat-relay/issues/7)) |
25
+ | OS | macOS(Apple Silicon) | 動作確認済み |
26
+ | | Ubuntu 24.04(x86_64) | CI でテストが通ることのみ確認済み |
27
+
28
+ ## 前提条件
29
+
30
+ - [Bun](https://bun.sh/) 1.4 以降:中継は Bun で動きます。npm でインストールする場合も必要です。
31
+ - Claude Code を使う場合:[Claude Code](https://code.claude.com/docs/en/setup) をインストールしてログインしておいてください。中継は PATH 上の `claude` を起動します。
32
+ - pi を使う場合:pi の別途インストールは不要です。[pi のモデルと認証の準備](docs/relay-setup.md#pi-のモデルと認証の準備)のあと、`agent-chat-relay serve pi` で起動します。
33
+ - git:既定の作業ディレクトリを、独立した git リポジトリにするために使います。
34
+ - [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)(LINE を使う場合):Webhook を公開するために使います。
35
+
36
+ ## インストール
37
+
38
+ ```sh
39
+ bun install -g @dotlabo/agent-chat-relay
40
+ ```
41
+
42
+ `npm install -g @dotlabo/agent-chat-relay` でもインストールできます(実行には Bun を使います)。コマンドは `agent-chat-relay` で、`ac-relay` という短い別名もあります。
43
+
44
+ バージョンごとの変更は、パッケージに入れた `CHANGELOG.md` にあります。旧パッケージ `agent-chat-relay` から移る場合も、そこを読んでください。
45
+
46
+ ## 使い方
47
+
48
+ Chatwork を使う場合の流れです。Bot のアカウントの準備や、LINE・Discord を使う場合の手順は [docs/relay-setup.md](docs/relay-setup.md) を参照してください。
49
+
50
+ ```sh
51
+ # 1. Bot の API トークンを保存する(入力内容は表示されません)
52
+ agent-chat-relay secrets chatwork
53
+
54
+ # 2. 中継を起動する
55
+ agent-chat-relay serve
56
+ ```
57
+
58
+ 起動したら、Bot に DM(Chatwork ではダイレクトチャット。先に Bot とコンタクトになっておく必要があります)を送ってください。ペアリング用のコードが返ってくるので、別のターミナルで承認します。これで自分が承認者として登録されます。ルームも同じ手順で登録できます。
59
+
60
+ ```sh
61
+ agent-chat-relay pair <コード>
62
+ ```
63
+
64
+ エージェントは、既定では中継専用の作業ディレクトリ(`~/.agent-chat-relay/workspace/`)で作業します。普段のフォルダで作業させるには、`--workspace` で明示します。そのフォルダの中身は、登録したルームの誰の依頼からでも、実行承認なしで読まれ、ルームへ送られえます。秘密情報を置いたフォルダは指定しないでください([docs/relay-setup.md](docs/relay-setup.md#普段の環境で動かす))。
65
+
66
+ ```sh
67
+ cd ~/work/project
68
+ agent-chat-relay serve --workspace .
69
+ ```
70
+
71
+ 中継のデータ(ルームの登録、許可リスト、秘密情報、作業ディレクトリ、ログ)は `~/.agent-chat-relay/` に置きます。`RELAY_HOME` で変えられます。
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
+
96
+ ## 秘密情報の管理
97
+
98
+ チャットサービスのトークンなどの秘密情報は、`agent-chat-relay secrets` で `~/.agent-chat-relay/.env` に保存します。ファイルは平文で、権限を 0600(自分だけが読み書きできる)にします。
99
+
100
+ ファイルに保存せず、環境変数で渡すこともできます。環境変数は、ファイルより優先します。値をコマンドラインに直接書くとシェルの履歴に残るため、`read -rs` などで入力してください。
101
+
102
+ ```sh
103
+ read -rs RELAY_CHATWORK_API_TOKEN && export RELAY_CHATWORK_API_TOKEN
104
+ agent-chat-relay serve
105
+ ```
106
+
107
+ 環境変数の名前は次のとおりです。
108
+
109
+ | チャットサービス | 環境変数 |
110
+ |---|---|
111
+ | LINE | `RELAY_LINE_CHANNEL_SECRET`・`RELAY_LINE_CHANNEL_TOKEN` |
112
+ | Chatwork | `RELAY_CHATWORK_API_TOKEN` |
113
+ | Discord | `RELAY_DISCORD_BOT_TOKEN` |
114
+
115
+ ## 開発
116
+
117
+ リポジトリを clone し、`scripts/relay.sh` で動かします。コマンドは `agent-chat-relay` と同じです。データはリポジトリ内の `.local/relay/` に置き、秘密情報は dotenvx で暗号化してリポジトリ直下の `.env` に保存します(public リポジトリに誤ってコミットしても漏れないようにするため)。
118
+
119
+ ```sh
120
+ git clone https://github.com/Dot-labo/agent-chat-relay.git
121
+ cd agent-chat-relay
122
+ mise trust
123
+ mise install
124
+ mise exec -- bun install
125
+ scripts/relay.sh secrets chatwork
126
+ scripts/relay.sh serve
127
+ ```
128
+
129
+ - [mise](https://mise.jdx.dev/):Bun と cloudflared は、`mise.toml` で固定したバージョンを mise でインストールします。Ubuntu では、git と curl も必要です(`sudo apt install git curl`)。
130
+ - [dotenvx](https://dotenvx.com/):`scripts/relay.sh secrets` で使います。1.51 と 2.38 で動作を確認しています。インストール方法は、`brew tap dotenvx/brew && brew trust dotenvx/brew && brew install dotenvx`、`mise use -g dotenvx`、`curl -sfS https://dotenvx.sh | sh`、`npm i -g @dotenvx/dotenvx` のいずれかです。使わない場合は、`.env` を作らずに、秘密情報を環境変数で渡してください。
131
+ - テストは `mise exec -- bun test`、型検査と lint(Oxlint)は `mise exec -- bun run check`、変更した行のミューテーションテストは `mise exec -- bun run mutation` です(ADR 0021)。`bun run mutation` は、走らせる e2e も表示します(ADR 0023)。PR を出す前は `mise exec -- bun run pre-pr` で、これらをまとめて走らせ、PR 本文の「確認」の下書きを得ます。書いた本文は、PR を作る前に `mise exec -- bun run pr-body <本文のファイル>` で確かめます。CI も PR の本文に同じ検査をかけます(ADR 0025)。実際のハーネスを使う確認は [docs/relay-setup.md](docs/relay-setup.md#モックでの確認) にあります。
132
+
133
+ ### clone して使っていた環境からの移行
134
+
135
+ `scripts/relay.sh` で使っていたデータは、自動では移りません。インストールした `agent-chat-relay` に移るときは、中継を止めてから、次のようにします。
136
+
137
+ ```sh
138
+ mkdir -p ~/.agent-chat-relay && chmod 700 ~/.agent-chat-relay
139
+ cp <リポジトリ>/.local/relay/access.json ~/.agent-chat-relay/
140
+ agent-chat-relay secrets chatwork # 使っているサービスの分だけ、入れ直す
141
+ ```
142
+
143
+ - ルームの登録と許可リスト(`access.json`)は、そのまま使えます。
144
+ - 秘密情報は、dotenvx で暗号化した `.env` を読めないので、入れ直します。
145
+ - 作業ディレクトリの場所が変わるので、前のセッションは `--session-id` で再開できません(再開できるのは、同じ作業ディレクトリで作ったセッションだけです)。前の作業ディレクトリの中身が必要なら、`~/.agent-chat-relay/workspace/` に移してください。
146
+
147
+ ## ドキュメント
148
+
149
+ | ファイル | 内容 |
150
+ |---|---|
151
+ | [docs/relay-setup.md](docs/relay-setup.md) | チャットサービスの準備、起動、ペアリング、動作確認の項目 |
152
+ | [docs/relay.md](docs/relay.md) | 仕様 |
153
+ | [docs/releasing.md](docs/releasing.md) | npm へのリリースの手順 |
154
+ | [docs/adr/](docs/adr/) | 設計判断の記録 |
155
+ | [GLOSSARY.md](GLOSSARY.md) | 用語集 |
@@ -0,0 +1,22 @@
1
+ #!/bin/sh
2
+ # agent-chat-relay の入り口(ADR 0019)。中継の本体を Bun で動かす。
3
+ # Bun は、起動したディレクトリの .env を環境変数に読み込み、bunfig.toml の preload を実行する。
4
+ # どこからでも起動するので、どちらも読ませない(--no-env-file --config=/dev/null)
5
+ set -e
6
+
7
+ # npm や bun は、このファイルへのシンボリックリンクを PATH に置くので、リンクをたどってパッケージの場所を求める
8
+ self=$0
9
+ while [ -L "$self" ]; do
10
+ link=$(readlink "$self")
11
+ case $link in
12
+ /*) self=$link ;;
13
+ *) self=$(dirname "$self")/$link ;;
14
+ esac
15
+ done
16
+ root=$(cd "$(dirname "$self")/.." && pwd -P)
17
+
18
+ if ! command -v bun >/dev/null 2>&1; then
19
+ echo "agent-chat-relay: bun が見つかりません。https://bun.sh の手順でインストールしてください" >&2
20
+ exit 1
21
+ fi
22
+ exec bun --no-env-file --config=/dev/null "$root/src/main.ts" "$@"
package/package.json CHANGED
@@ -1,6 +1,71 @@
1
1
  {
2
2
  "name": "@dotlabo/agent-chat-relay",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.0",
4
+ "description": "LINE・Chatwork・Discord のルームから、Claude Code などのコーディングエージェントに作業を依頼するための中継サーバー(ACP・MCP)",
5
+ "license": "MIT",
6
+ "publishConfig": {
7
+ "access": "public"
8
+ },
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/Dot-labo/agent-chat-relay.git"
12
+ },
13
+ "homepage": "https://github.com/Dot-labo/agent-chat-relay#readme",
14
+ "bugs": "https://github.com/Dot-labo/agent-chat-relay/issues",
15
+ "keywords": [
16
+ "acp",
17
+ "mcp",
18
+ "claude-code",
19
+ "line",
20
+ "chatwork",
21
+ "discord",
22
+ "agent"
23
+ ],
24
+ "type": "module",
25
+ "bin": {
26
+ "agent-chat-relay": "bin/agent-chat-relay",
27
+ "ac-relay": "bin/agent-chat-relay"
28
+ },
29
+ "files": [
30
+ "bin/",
31
+ "src/",
32
+ "CHANGELOG.md"
33
+ ],
34
+ "engines": {
35
+ "bun": ">=1.4.0"
36
+ },
37
+ "os": [
38
+ "darwin",
39
+ "linux"
40
+ ],
41
+ "scripts": {
42
+ "relay": "bin/agent-chat-relay",
43
+ "test": "bun test",
44
+ "check": "tsc --noEmit && oxlint && bun --no-env-file --config=/dev/null scripts/check.ts",
45
+ "docs:adr": "bun --no-env-file --config=/dev/null scripts/adr-index.ts",
46
+ "mutation": "scripts/mutation.sh",
47
+ "pre-pr": "bun --no-env-file --config=/dev/null scripts/pre-pr.ts",
48
+ "pr-body": "bun --no-env-file --config=/dev/null scripts/pr-body.ts"
49
+ },
50
+ "dependencies": {
51
+ "@agentclientprotocol/claude-agent-acp": "0.101.0",
52
+ "@agentclientprotocol/sdk": "2.4.0",
53
+ "@earendil-works/pi-coding-agent": "1.5.2",
54
+ "@modelcontextprotocol/sdk": "1.32.2",
55
+ "cross-spawn": "7.0.6",
56
+ "discord.js": "14.28.1",
57
+ "ink": "8.0.0",
58
+ "pi-acp-protocol-sdk": "npm:@agentclientprotocol/sdk@0.26.0",
59
+ "react": "19.3.1",
60
+ "zod": "4.6.7"
61
+ },
62
+ "devDependencies": {
63
+ "@types/bun": "1.4.5",
64
+ "@types/react": "19.3.0",
65
+ "fallow": "3.44.0",
66
+ "fast-check": "4.10.3",
67
+ "oxlint": "1.94.0",
68
+ "oxlint-tsgolint": "7.0.2007",
69
+ "typescript": "7.0.2"
70
+ }
71
+ }