@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/src/main.ts ADDED
@@ -0,0 +1,275 @@
1
+ // agent-chat-relay のエントリーポイント(ADR 0019)。開発時は scripts/relay.sh から呼ばれる。
2
+ //
3
+ // serve [harness] [--session-id <id>] [--workspace <dir>] [--harness-settings default] [--harness-memory]
4
+ // 中継を起動する(チャットサービスのコネクター、チャット用ツールの MCP、ハーネス)。
5
+ // harness の既定は RELAY_HARNESS、なければ claude。--session-id で、そのセッションを再開する。
6
+ // ほかのフラグは、環境変数 RELAY_WORKSPACE・RELAY_HARNESS_SETTINGS・RELAY_HARNESS_MEMORY の別名(ADR 0017)
7
+ // terminal 動いている serve に、管理者の端末として参加する(話しかける、途中経過を見る、承認する。ADR 0030)
8
+ // pair <code> ペアリングのコードを承認する(ルームの登録、DM の相手の許可)
9
+ // access 登録したルームと許可した人の一覧(ID は伏せる)
10
+ // access mode <番号か ID> <mention|exceptOthers|exceptOthersJev|all>
11
+ // 登録したルームの受信モードを変える。番号は access の一覧のもの(ADR 0028、0029)
12
+ // secrets <line|chatwork|discord|typesafe>
13
+ // 秘密情報を、画面に表示せずに入力してもらい、<home>/.env に保存する(typesafe は、承認依頼の送り先を推し、他人宛ての発言を判定する Jev の API キー。ADR 0026、0029)
14
+ // line-tunnel LINE の Webhook を Cloudflare Quick Tunnel で公開する(PATH 上の cloudflared を使う)
15
+ // line-quota LINE の今月の送信数
16
+ //
17
+ // データの置き場は RELAY_HOME(既定は ~/.agent-chat-relay)。秘密情報は <home>/.env(RELAY_ENV_FILE で変えられる)から読み、環境変数を優先する
18
+
19
+ import { randomBytes } from "node:crypto"
20
+ import { dirname, join, resolve } from "node:path"
21
+ import { AccessStore, isReceiveMode, localId, RECEIVE_MODES, serviceOf } from "./core/access.ts"
22
+ import { chatworkFromEnv } from "./connectors/chatwork.ts"
23
+ import { discordFromEnv } from "./connectors/discord.ts"
24
+ import { lineFromEnv } from "./connectors/line.ts"
25
+ import { TERMINAL_ID, TerminalConnector, terminalPaths } from "./connectors/terminal.ts"
26
+ import { terminal } from "./terminal.ts"
27
+ import { harnessConfig, harnessOptionsFromEnv } from "./harness/config.ts"
28
+ import { startHarness, type HarnessConfig, type HarnessHooks } from "./harness/harness.ts"
29
+ import { preparePiLaunch } from "./harness/pi/config.ts"
30
+ import { schedulePrune } from "./core/retention.ts"
31
+ import { mcpHandler } from "./core/mcp.ts"
32
+ import { parseServeArgs, type ServeArgs } from "./serve-args.ts"
33
+ import { type Connector, type ConnectorFactory, type Log, noticeTimingFromEnv, Relay, type Routes } from "./core/relay.ts"
34
+ import { stopper, untilHarnessExits } from "./shutdown.ts"
35
+ import { relayDir, resolveWorkspace } from "./workspace.ts"
36
+ import { jevFromEnv, screenFromEnv } from "./jev.ts"
37
+ import { loadSecrets, relayHome, secretKeys, secretsFile, storeSecrets } from "./home.ts"
38
+ import { readSecret } from "./prompt.ts"
39
+
40
+ /** コネクターの一覧。秘密情報のあるものだけを動かす */
41
+ const CONNECTORS: ConnectorFactory[] = [lineFromEnv, chatworkFromEnv, discordFromEnv]
42
+
43
+ const home = relayHome(process.env)
44
+ const envFile = secretsFile(process.env, home)
45
+ /** このパッケージ(開発時はリポジトリ)の置き場。開発時は、秘密情報(.env・.env.keys)もここに置く */
46
+ const PACKAGE_ROOT = resolve(import.meta.dir, "..")
47
+ const accessPath = join(home, "access.json")
48
+ /** Webhook などのコネクターのエンドポイント。line-tunnel は、ここを公開する */
49
+ const HTTP_PORT = Number(process.env.RELAY_HTTP_PORT ?? 18080)
50
+
51
+ const format = (msg: string, extra?: Record<string, unknown>) => `${new Date().toISOString()} relay: ${msg}${extra ? ` ${JSON.stringify(extra)}` : ""}`
52
+ const log: Log = {
53
+ info: (msg, extra) => console.log(format(msg, extra)),
54
+ error: (msg, extra) => console.error(format(msg, extra)),
55
+ }
56
+
57
+ async function serve(access: AccessStore, args: ServeArgs): Promise<void> {
58
+ // フラグは、同じ意味の環境変数より優先する
59
+ const env = { ...process.env, ...args.env }
60
+ // 不正な指定は、何も起動しないうちに拒否する
61
+ const harnessOptions = harnessOptionsFromEnv(env)
62
+ const noticeTiming = noticeTimingFromEnv(env)
63
+ const attribute = jevFromEnv(env, log)
64
+ const screen = screenFromEnv(env, log)
65
+ // 作業ディレクトリの中は承認なしで読めて返せるので、中継のデータと秘密情報の置き場を含めない(ADR 0017)。
66
+ // 秘密情報のファイル自体も渡すのは、ファイルがシンボリックリンクのとき、実体の場所も含めないため
67
+ const { path: workspace, specified } = resolveWorkspace(env, home, [home, PACKAGE_ROOT, dirname(envFile), envFile])
68
+ if (specified) log.info("管理者が指定した作業ディレクトリを使います", { workspace })
69
+ const { harness: harnessName, sessionId } = args
70
+ const harnessLog = join(home, "harness.log")
71
+ const launch = harnessName === "pi"
72
+ ? preparePiLaunch({ home, cwd: workspace, sessionId, stderrPath: harnessLog, options: harnessOptions }, log)
73
+ : (mcp: HarnessConfig["mcp"], onPermission: Parameters<typeof startHarness>[1], hooks: HarnessHooks) => startHarness({
74
+ ...harnessConfig(harnessName, workspace, mcp, harnessOptions, log, specified, env),
75
+ // 秘密情報のファイルに手で足した行(RELAY_ 以外のキー)も渡さない
76
+ withheld: secretKeys(envFile),
77
+ sessionId,
78
+ stderrPath: harnessLog,
79
+ ...hooks,
80
+ }, onPermission, log)
81
+ const inbox = join(relayDir(workspace), "inbox")
82
+
83
+ // 受け取った添付は 7 日で消す(ADR 0005)
84
+ schedulePrune(inbox, "受け取った添付", log)
85
+
86
+ const relay = new Relay(access, log, workspace, undefined, noticeTiming, attribute, screen)
87
+ if (attribute) log.info("送り手が複数いるターンの承認依頼は、Jev で依頼者を推して送り先を絞ります(ADR 0026)")
88
+ if (!screen && Object.values(access.load().rooms).some((p) => p.receive === "exceptOthersJev")) log.error(NO_JEV_KEY)
89
+ const chats = CONNECTORS.map((make) => make(process.env, { relay, log, home })).filter((c) => c !== undefined)
90
+ if (chats.length === 0) log.info("チャットサービスの秘密情報がないため、管理者の端末だけで起動します。ルームをつなぐには、止めてから agent-chat-relay secrets line などを実行し、--session-id で再開してください")
91
+ // 管理者の端末は、いつも起動する。チャットサービスの秘密情報がなくても、端末だけで動かせる(ADR 0030)
92
+ const connectors: Connector[] = [...chats, new TerminalConnector(relay, home, log)]
93
+ for (const c of connectors) relay.addConnector(c)
94
+
95
+ const token = randomBytes(32).toString("base64url")
96
+ const mcp = Bun.serve({
97
+ hostname: "127.0.0.1",
98
+ port: Number(process.env.RELAY_MCP_PORT ?? 18090),
99
+ idleTimeout: 0,
100
+ routes: { "/mcp": mcpHandler(relay, inbox, token) },
101
+ fetch: () => new Response("not found", { status: 404 }),
102
+ })
103
+ // 終了時に閉じるもの
104
+ const closers: (() => void)[] = [() => void mcp.stop()]
105
+ log.info("チャット用ツールのエンドポイントを開きました", { mcp: `${mcp.url.href}mcp` })
106
+
107
+ // コネクターのエンドポイント(Webhook など)は、1 つのサーバーにまとめる。外へはトンネルで公開する。同じパスを 2 つのコネクターが出したら起動しない
108
+ const routes: Routes = {}
109
+ for (const c of connectors) {
110
+ for (const [path, route] of Object.entries(c.routes ?? {})) {
111
+ if (path in routes) throw new Error(`エンドポイントのパスが重なっています: ${path}(${c.label})`)
112
+ routes[path] = route
113
+ }
114
+ }
115
+ if (Object.keys(routes).length > 0) {
116
+ const http = Bun.serve({
117
+ hostname: "127.0.0.1",
118
+ port: HTTP_PORT,
119
+ routes,
120
+ fetch: () => new Response("not found", { status: 404 }),
121
+ })
122
+ closers.push(() => void http.stop())
123
+ log.info("コネクターのエンドポイントを開きました", { url: http.url.href, routes: Object.keys(routes) })
124
+ }
125
+ for (const c of connectors) closers.push(() => c.stop())
126
+ let harness: Awaited<ReturnType<typeof launch>>
127
+ try {
128
+ // 1 つが失敗しても、ほかの起動が終わってから閉じる。先に閉じると、あとから作ったソケットとトークンが残る
129
+ const started = await Promise.allSettled(connectors.map((c) => c.start()))
130
+ const failed = started.find((r) => r.status === "rejected")
131
+ if (failed) throw failed.reason
132
+ // 端末の接続用のファイルは、エージェントに読ませない(ADR 0030)
133
+ const protect = Object.values(terminalPaths(home))
134
+ harness = await launch({ url: `${mcp.url.href}mcp`, token }, req => relay.requestPermission(req), { onProgress: (p) => relay.progress(p), protect })
135
+ } catch (err) {
136
+ // 起動の途中で失敗しても、端末のソケットとトークンを残さない
137
+ for (const close of closers) close()
138
+ throw err
139
+ }
140
+ relay.attach(harness.session)
141
+
142
+ // Ctrl+C は、端末と dotenvx の両方から届くことがある
143
+ const stop = stopper(() => {
144
+ log.info("停止します")
145
+ harness.stop()
146
+ })
147
+ process.on("SIGINT", stop.stop)
148
+ process.on("SIGTERM", stop.stop)
149
+ // 端末を閉じたときも、端末のソケットを片付けてから止める
150
+ process.on("SIGHUP", stop.stop)
151
+ const code = await untilHarnessExits({ exited: harness.exited, name: harnessName, logPath: harnessLog }, relay, stop, log)
152
+ for (const close of closers) close()
153
+ process.exit(code)
154
+ }
155
+
156
+ /** 秘密情報の項目。サービスごとに、入力してもらう順 */
157
+ const SECRETS: Record<string, { intro: string; items: [key: string, label: string][] }> = {
158
+ line: {
159
+ intro: "LINE Developers コンソールの値を入力します。入力内容は画面に表示されません。",
160
+ items: [
161
+ ["RELAY_LINE_CHANNEL_SECRET", "[1/2] チャネルシークレット: "],
162
+ ["RELAY_LINE_CHANNEL_TOKEN", "[2/2] チャネルアクセストークン(長期): "],
163
+ ],
164
+ },
165
+ chatwork: {
166
+ intro: "Bot の Chatwork アカウントの API トークンを入力します。入力内容は画面に表示されません。",
167
+ items: [["RELAY_CHATWORK_API_TOKEN", "API トークン: "]],
168
+ },
169
+ discord: {
170
+ intro: "Discord Developer Portal の Bot のトークンを入力します。入力内容は画面に表示されません。",
171
+ items: [["RELAY_DISCORD_BOT_TOKEN", "Bot のトークン: "]],
172
+ },
173
+ typesafe: {
174
+ intro: "TypeSafe AI の API キー(Jev。承認依頼の送り先を推すのと、他人宛ての発言を判定するのに使う)を入力します。入力内容は画面に表示されません。",
175
+ items: [["RELAY_TYPESAFE_API_KEY", "API キー: "]],
176
+ },
177
+ }
178
+
179
+ function secrets(service: string | undefined): void {
180
+ const spec = service ? SECRETS[service] : undefined
181
+ if (!spec) throw new Error(`secrets の対象は ${Object.keys(SECRETS).join("・")} のどれかです`)
182
+ process.stderr.write(`${spec.intro}\n`)
183
+ const values: Record<string, string> = {}
184
+ for (const [key, label] of spec.items) values[key] = readSecret(label).trim()
185
+ storeSecrets(envFile, values)
186
+ console.log(`保存しました: ${envFile}`)
187
+ }
188
+
189
+ function lineTunnel(): Promise<number> {
190
+ const cloudflared = Bun.which("cloudflared")
191
+ if (!cloudflared) throw new Error("cloudflared が見つかりません。インストールして PATH に置いてください")
192
+ return Bun.spawn([cloudflared, "tunnel", "--no-autoupdate", "--url", `http://127.0.0.1:${HTTP_PORT}`], { stdio: ["inherit", "inherit", "inherit"] }).exited
193
+ }
194
+
195
+ async function lineQuota(): Promise<void> {
196
+ const token = process.env.RELAY_LINE_CHANNEL_TOKEN
197
+ if (!token) throw new Error("LINE のチャネルアクセストークンがありません。agent-chat-relay secrets line を実行してください")
198
+ for (const path of ["quota", "quota/consumption"]) {
199
+ const res = await fetch(`https://api.line.me/v2/bot/message/${path}`, { headers: { Authorization: `Bearer ${token}` } })
200
+ console.log(`${path}: ${await res.text()}`)
201
+ }
202
+ }
203
+
204
+ function mask(id: string): string {
205
+ // サービス名と、ローカル ID の先頭 1 文字(LINE の C・R・U、Chatwork の r・u、Discord の c・u)だけを残す
206
+ return `${serviceOf(id)}:${localId(id).slice(0, 1)}…`
207
+ }
208
+
209
+ /** 受信モードが「他人宛てを除く(Jev)」のルームがあるのに、Jev の API キーがないとき(ADR 0029) */
210
+ const NO_JEV_KEY = "Jev の API キーがないため、受信モードが「他人宛てを除く(Jev)」のルームは、「他人宛てを除く」と同じに動きます。agent-chat-relay secrets typesafe で保存してください"
211
+
212
+ /**
213
+ * access:登録したルームと許可した人の一覧。ルームには番号を付ける(ID は伏せるため)。
214
+ * access mode <番号か ID> <受信モード>:登録したルームの受信モードを変える(ADR 0028)
215
+ */
216
+ function accessCommand(access: AccessStore, args: string[]): void {
217
+ const a = access.load()
218
+ const rooms = Object.entries(a.rooms)
219
+ if (args[0] === "mode") {
220
+ const [target, mode] = args.slice(1)
221
+ if (!target || !isReceiveMode(mode)) throw new Error(`usage: agent-chat-relay access mode <ルームの番号か ID> <${Object.keys(RECEIVE_MODES).join("|")}>`)
222
+ const room = /^[1-9][0-9]*$/.test(target) ? rooms[Number(target) - 1]?.[0] : target
223
+ if (!room) throw new Error(`${target} 番のルームはありません。access で番号を確かめてください`)
224
+ access.setReceive(room, mode)
225
+ console.log(`受信モードを変えました: ${mask(room)}(${RECEIVE_MODES[mode]})`)
226
+ // 値は読まずに、キーがあるかだけを見る(秘密情報のファイルは暗号化していることがある)
227
+ if (mode === "exceptOthersJev" && !process.env.RELAY_TYPESAFE_API_KEY && !secretKeys(envFile).includes("RELAY_TYPESAFE_API_KEY")) console.error(NO_JEV_KEY)
228
+ return
229
+ }
230
+ console.log("ルーム:")
231
+ for (const [i, [room, p]] of rooms.entries()) console.log(` ${i + 1}. ${mask(room)} ${RECEIVE_MODES[p.receive]}${p.allowFrom.length ? ` 許可 ${p.allowFrom.length} 人` : ""}`)
232
+ console.log("DM と実行承認を許可した人:")
233
+ for (const u of a.allowFrom) console.log(` ${mask(u)}`)
234
+ console.log(`ペアリング待ち: ${Object.keys(a.pending).length} 件`)
235
+ }
236
+
237
+ async function main(): Promise<void> {
238
+ const [cmd, ...rest] = process.argv.slice(2)
239
+ const arg = rest[0]
240
+ // serve の間だけ、管理者の端末を承認者に加える。access.json には書かない(ADR 0030)
241
+ const access = new AccessStore(accessPath, Date.now, cmd === "serve" ? [TERMINAL_ID] : [])
242
+ // 秘密情報は、使うコマンドでだけ読む。値は、まだない環境変数にだけ設定する
243
+ if (cmd === "serve" || cmd === "line-quota") loadSecrets(envFile, process.env, (msg) => log.error(msg))
244
+ switch (cmd) {
245
+ case "serve":
246
+ // 不正な引数は、何も起動しないうちに拒否する
247
+ return serve(access, parseServeArgs(rest, process.env.RELAY_HARNESS ?? "claude"))
248
+ case "secrets":
249
+ return secrets(arg)
250
+ case "terminal":
251
+ return terminal(home)
252
+ case "line-tunnel":
253
+ process.exit(await lineTunnel())
254
+ return
255
+ case "line-quota":
256
+ return lineQuota()
257
+ case "pair": {
258
+ if (!arg) throw new Error("usage: agent-chat-relay pair <code>")
259
+ const p = access.approve(arg)
260
+ console.log(p.kind === "room" ? `ルームを登録しました: ${mask(p.target)}(受信モード:メンション時)` : `DM の相手を許可しました: ${mask(p.target)}(実行承認の依頼も届きます)`)
261
+ return
262
+ }
263
+ case "access":
264
+ return accessCommand(access, rest)
265
+ default:
266
+ throw new Error(
267
+ `usage: agent-chat-relay serve [harness] [--session-id <id>] [--workspace <dir>] [--harness-settings default] [--harness-memory] | terminal | pair <code> | access [mode <番号か ID> <${Object.keys(RECEIVE_MODES).join("|")}>] | secrets <line|chatwork|discord|typesafe> | line-tunnel | line-quota`,
268
+ )
269
+ }
270
+ }
271
+
272
+ main().catch((err) => {
273
+ console.error(`relay: ${err instanceof Error ? err.message : String(err)}`)
274
+ process.exit(1)
275
+ })
package/src/prompt.ts ADDED
@@ -0,0 +1,12 @@
1
+ // 秘密情報を、画面に表示せずに入力してもらう。コマンドの引数に載せない(ps やシェルの履歴に残る)ため
2
+
3
+ /**
4
+ * 1 行を読む。bash の read -s に任せる(表示を消すことと、Ctrl+C で中断したときに端末を元に戻すことを、bash がする)。
5
+ * 端末でなければ(パイプなど)、標準入力の次の行を読む。値はパイプで受け取り、引数には載せない
6
+ */
7
+ export function readSecret(label: string): string {
8
+ process.stderr.write(label)
9
+ const r = Bun.spawnSync(["bash", "-c", 'read -rs v; echo >&2; printf %s "$v"'], { stdin: "inherit", stdout: "pipe", stderr: "inherit" })
10
+ if (r.signalCode || r.exitCode === 130) throw new Error("中止しました")
11
+ return r.stdout.toString().replace(/\r$/, "")
12
+ }
@@ -0,0 +1,56 @@
1
+ // serve の引数:[harness] [--session-id <id>] [--workspace <dir>] [--harness-settings default] [--harness-memory]。
2
+ // 不正な引数は、コネクターやハーネスを起動する前に拒否する。
3
+ // --workspace・--harness-settings・--harness-memory は、それぞれ RELAY_WORKSPACE・RELAY_HARNESS_SETTINGS・RELAY_HARNESS_MEMORY の別名で、環境変数より優先する(ADR 0017・0019)
4
+
5
+ export const HARNESSES = ["claude", "pi", "opencode"] as const
6
+ export type HarnessName = (typeof HARNESSES)[number]
7
+
8
+ /** env は、フラグで指定した環境変数の値。環境変数に重ねて使う */
9
+ export type ServeArgs = { harness: HarnessName; sessionId?: string; env?: Record<string, string> }
10
+
11
+ /** 値を取るフラグと、その別名の環境変数 */
12
+ const VALUE_FLAGS: Record<string, string> = { "--workspace": "RELAY_WORKSPACE", "--harness-settings": "RELAY_HARNESS_SETTINGS" }
13
+ /** 値を取らないフラグと、指定したときの環境変数の値 */
14
+ const SWITCH_FLAGS: Record<string, [string, string]> = { "--harness-memory": ["RELAY_HARNESS_MEMORY", "1"] }
15
+
16
+ const MAX_SESSION_ID = 256
17
+
18
+ export function parseServeArgs(args: string[], defaultHarness = "claude"): ServeArgs {
19
+ let harness: string | undefined
20
+ let sessionId: string | undefined
21
+ const env: Record<string, string> = {}
22
+ const seen = new Set<string>()
23
+ for (let i = 0; i < args.length; i++) {
24
+ const arg = args[i]!
25
+ const name = arg.split("=", 1)[0]!
26
+ if (name.startsWith("--") && seen.has(name)) throw new Error(`${name} が 2 回指定されています`)
27
+ seen.add(name)
28
+ if (name === "--session-id" || Object.hasOwn(VALUE_FLAGS, name)) {
29
+ const value = arg === name ? args[++i] : arg.slice(name.length + 1)
30
+ if (value === undefined || value.startsWith("-")) throw new Error(`${name} の値がありません`)
31
+ if (value === "") throw new Error(`${name} の値が空です`)
32
+ if (name === "--session-id") sessionId = checkSessionId(value)
33
+ else env[VALUE_FLAGS[name]!] = value
34
+ } else if (Object.hasOwn(SWITCH_FLAGS, arg)) {
35
+ const [key, value] = SWITCH_FLAGS[arg]!
36
+ env[key] = value
37
+ } else if (arg.startsWith("-")) {
38
+ throw new Error(`知らないオプションです: ${arg}`)
39
+ } else if (harness !== undefined) {
40
+ throw new Error(`ハーネスは 1 つだけ指定できます: ${harness} と ${arg}`)
41
+ } else {
42
+ harness = arg
43
+ }
44
+ }
45
+ harness ??= defaultHarness
46
+ if (!(HARNESSES as readonly string[]).includes(harness)) throw new Error(`知らないハーネスです: ${harness}(${HARNESSES.join(" か ")})`)
47
+ return { harness: harness as HarnessName, sessionId, ...(Object.keys(env).length > 0 ? { env } : {}) }
48
+ }
49
+
50
+ /** セッション ID の形式はハーネスごとに違う(Claude は UUID)ので、明らかにおかしいものだけを拒否する */
51
+ function checkSessionId(id: string): string {
52
+ if (id === "") throw new Error("--session-id の値が空です")
53
+ if (id.length > MAX_SESSION_ID) throw new Error(`--session-id の値が長すぎます(${MAX_SESSION_ID} 文字まで)`)
54
+ if (/[\s\p{Cc}]/u.test(id)) throw new Error("--session-id の値に空白か制御文字が含まれています")
55
+ return id
56
+ }
@@ -0,0 +1,52 @@
1
+ // 中継の止まり方。ハーネスが終了したら中継も止める。異常終了なら、作業中だったターンのルームへの知らせを送り終わるまで待つ(ADR 0024)。
2
+ // main.ts は子プロセスでしか動かずテストが届かないので、ここに切り出して単体テストで守る。process.exit とシグナルの登録は main.ts に残す
3
+
4
+ import { readFileSync } from "node:fs"
5
+ import type { Log } from "./core/relay.ts"
6
+
7
+ /** ハーネスが異常終了したとき、ルームへの知らせを送り終わるまで待つ上限 */
8
+ export const DRAIN_MS = 10_000
9
+
10
+ /** 管理者による停止(Ctrl+C・SIGTERM)。何度届いても、onStop は 1 回だけ呼ぶ */
11
+ export type Stopper = { readonly stopping: boolean; readonly stopped: Promise<void>; stop: () => void }
12
+
13
+ export function stopper(onStop: () => void): Stopper {
14
+ let stopping = false
15
+ let resolve!: () => void
16
+ const stopped = new Promise<void>((r) => (resolve = r))
17
+ return {
18
+ get stopping() {
19
+ return stopping
20
+ },
21
+ stopped,
22
+ stop: () => {
23
+ if (stopping) return
24
+ stopping = true
25
+ resolve()
26
+ onStop()
27
+ },
28
+ }
29
+ }
30
+
31
+ /**
32
+ * ハーネスの終了を待ってログに書き、中継の終了コードを返す。
33
+ * 管理者が止めたのでなければ、作業中だったターンのルームへの知らせを、送り終わるまで(最大 drainMs)待つ。待っている間に止められたら、待つのをやめる
34
+ */
35
+ export async function untilHarnessExits(
36
+ h: { exited: Promise<number>; name: string; logPath: string },
37
+ relay: { drain(timeoutMs: number): Promise<void> },
38
+ stop: Stopper,
39
+ log: Log,
40
+ drainMs = DRAIN_MS,
41
+ ): Promise<number> {
42
+ const code = await h.exited
43
+ if (code === 0 || stop.stopping) {
44
+ log.info("ハーネスが終了したため、中継も止めます", { harness: h.name, code })
45
+ } else {
46
+ const tail = readFileSync(h.logPath, "utf8").trimEnd().split("\n").slice(-20).join("\n")
47
+ log.error(`ハーネスが異常終了したため、中継も止めます。ハーネスのログ:${h.logPath}(最後の 20 行を下に出す)`, { harness: h.name, code })
48
+ console.error(tail)
49
+ }
50
+ if (!stop.stopping) await Promise.race([relay.drain(drainMs), stop.stopped])
51
+ return code === 0 ? 0 : 1
52
+ }
@@ -0,0 +1,172 @@
1
+ // agent-chat-relay terminal の画面(Ink。ADR 0030)。動いている serve に <RELAY_HOME> の Unix ソケットでつなぐ。
2
+ // 画面を閉じても、中継とセッションは動き続ける
3
+
4
+ import { readFileSync } from "node:fs"
5
+ import { createConnection, type Socket } from "node:net"
6
+ import { stripVTControlCharacters } from "node:util"
7
+ import { createElement, useEffect, useRef, useState } from "react"
8
+ import { Box, Text, render, useApp, useInput } from "ink"
9
+ import { appendEvent, type HistoryEvent, MAX_INPUT, readLines, TERMINAL_SERVICE, terminalPaths, type TerminalEvent, type TerminalFrame } from "./connectors/terminal.ts"
10
+ import type { RelayStatus } from "./core/relay.ts"
11
+
12
+ /** 画面に残す件数 */
13
+ const SHOWN = 200
14
+
15
+ /** エージェントやルームの人が書いた文字列に入った制御文字(ANSI・OSC のエスケープなど)を、画面で実行させない */
16
+ export function displayText(text: string): string {
17
+ return Array.from(stripVTControlCharacters(text))
18
+ .filter((ch) => {
19
+ const c = ch.codePointAt(0)!
20
+ return c === 9 || c === 10 || (c >= 32 && c !== 127 && !(c >= 0x80 && c <= 0x9f))
21
+ })
22
+ .join("")
23
+ }
24
+
25
+ const TOOL_STATUS: Record<string, string> = { pending: "待機中", in_progress: "実行中", completed: "完了", failed: "失敗" }
26
+
27
+ /** 履歴の 1 件を、画面の 1 行(改行を含みうる)と色にする */
28
+ export function eventLine(e: HistoryEvent): { text: string; color?: string } {
29
+ switch (e.type) {
30
+ case "input":
31
+ return { text: `あなた${e.cutIn ? "(差し込み)" : ""}: ${displayText(e.text)}`, color: "cyan" }
32
+ case "reply":
33
+ return { text: `エージェント: ${displayText(e.text)}` }
34
+ case "sent":
35
+ return { text: `→ ${displayText(e.room)} に送りました: ${displayText(e.text)}`, color: "magenta" }
36
+ case "approval":
37
+ return { text: displayText(e.text), color: "yellow" }
38
+ case "notice":
39
+ return { text: `中継: ${displayText(e.text)}`, color: "green" }
40
+ case "progress": {
41
+ const p = e.progress
42
+ if (p.kind === "text") return { text: displayText(p.text.trim().slice(-500)), color: "gray" }
43
+ const status = p.status ? `(${TOOL_STATUS[p.status] ?? displayText(p.status)})` : ""
44
+ return { text: `ツール: ${displayText(p.title).slice(0, 200)}${status}`, color: "gray" }
45
+ }
46
+ }
47
+ }
48
+
49
+ /** 作業中のターンがどちらの側か */
50
+ function turnLabel(turn: RelayStatus["turn"]): string {
51
+ if (!turn) return "作業はしていません"
52
+ if (turn.lane === TERMINAL_SERVICE) return "この端末の作業中"
53
+ return `ルームの作業中(${turn.rooms.map(displayText).join("、")})`
54
+ }
55
+
56
+ /** 中継の状態の行(ADR 0030)。待っている発言があれば、その理由と、差し込む方法を書く */
57
+ export function statusLine(s: RelayStatus): string {
58
+ const parts = [turnLabel(s.turn)]
59
+ if (s.approvals > 0) parts.push(`承認待ち ${s.approvals} 件`)
60
+ const mine = s.queued[TERMINAL_SERVICE] ?? 0
61
+ const rooms = s.queued[""] ?? 0
62
+ if (mine > 0 && s.turn && s.turn.lane !== TERMINAL_SERVICE) {
63
+ const hint = s.steering ? "/now <本文> で今の作業に差し込めます" : "このハーネスは差し込みに対応していないので、/now でも作業が終わるまで待ちます"
64
+ parts.push(`この端末の発言 ${mine} 件は、ルームの作業が終わってから渡します(${hint})`)
65
+ }
66
+ if (rooms > 0) parts.push(`ルームの発言 ${rooms} 件が待っています`)
67
+ return parts.join("・")
68
+ }
69
+
70
+ /**
71
+ * 入力中の行に、受けた文字を足す。貼り付けなどで改行を含んだ入力も、改行で区切って送る(Ink は、ほかの文字と一緒に届いた改行を Enter として扱わない)。
72
+ * lines は送る行、rest は入力中のまま残る行
73
+ */
74
+ export function typeInto(current: string, typed: string): { lines: string[]; rest: string } {
75
+ const parts = (current + typed).split(/\r\n|\r|\n/)
76
+ const rest = displayText(parts.pop()!).slice(0, MAX_INPUT)
77
+ return { lines: parts.map((l) => displayText(l).slice(0, MAX_INPUT)), rest }
78
+ }
79
+
80
+ /** 入力した 1 行。/now <本文> は、ルームの作業中でも差し込む。/quit で抜ける */
81
+ export function parseInput(line: string): TerminalFrame | "quit" | undefined {
82
+ const text = line.trim()
83
+ if (!text) return undefined
84
+ if (text === "/quit" || text === "/exit") return "quit"
85
+ const now = /^\/now(?:\s+([\s\S]*))?$/.exec(text)
86
+ if (now) return now[1]?.trim() ? { text: now[1].trim(), cutIn: true } : undefined
87
+ return { text }
88
+ }
89
+
90
+ type Shown = { events: HistoryEvent[]; status: RelayStatus }
91
+
92
+ function Terminal({ socket, token }: { socket: Socket; token: string }) {
93
+ const { exit } = useApp()
94
+ const [shown, setShown] = useState<Shown>({ events: [], status: { approvals: 0, queued: {}, steering: false } })
95
+ const [input, setInput] = useState("")
96
+ // 続けて届いた入力を、画面の更新を待たずにつなぐ
97
+ const typing = useRef("")
98
+ const edit = (next: string) => {
99
+ typing.current = next
100
+ setInput(next)
101
+ }
102
+ const submit = (line: string) => {
103
+ const parsed = parseInput(line)
104
+ if (parsed === "quit") return exit()
105
+ if (parsed) socket.write(`${JSON.stringify(parsed)}\n`)
106
+ }
107
+ useEffect(() => {
108
+ const data = readLines(
109
+ (line) => {
110
+ const e = JSON.parse(line) as TerminalEvent
111
+ setShown((s) => (e.type === "status" ? { ...s, status: e.status } : { ...s, events: appendEvent(s.events, e, SHOWN) }))
112
+ },
113
+ () => socket.destroy(),
114
+ )
115
+ const close = () => exit(new Error("中継との接続が切れました"))
116
+ socket.on("data", data)
117
+ socket.on("close", close)
118
+ socket.write(`${JSON.stringify({ token })}\n`)
119
+ return () => {
120
+ socket.off("data", data)
121
+ socket.off("close", close)
122
+ }
123
+ }, [socket, token, exit])
124
+ useInput((text, key) => {
125
+ if (key.escape) return exit()
126
+ if (key.return) {
127
+ const line = typing.current
128
+ edit("")
129
+ return submit(line)
130
+ }
131
+ if (key.backspace || key.delete) return edit(Array.from(typing.current).slice(0, -1).join(""))
132
+ if (key.ctrl || key.meta || key.upArrow || key.downArrow || key.leftArrow || key.rightArrow || key.tab) return
133
+ const { lines, rest } = typeInto(typing.current, text)
134
+ edit(rest)
135
+ for (const line of lines) submit(line)
136
+ })
137
+ return createElement(
138
+ Box,
139
+ { flexDirection: "column" },
140
+ createElement(Text, { bold: true }, "管理者の端末(Esc・/quit で抜けます。中継とセッションは動き続けます)"),
141
+ createElement(Text, { dimColor: true }, "ここで話した内容は、ほかのルームの人もエージェントから引き出せます。秘密情報を入力しないでください。"),
142
+ ...shown.events.map((e, i) => {
143
+ const { text, color } = eventLine(e)
144
+ return createElement(Text, { key: i, ...(color ? { color } : {}) }, text)
145
+ }),
146
+ createElement(Text, { color: "blue" }, `状態: ${statusLine(shown.status)}`),
147
+ createElement(Text, {}, `> ${input}`),
148
+ )
149
+ }
150
+
151
+ export async function terminal(home: string): Promise<void> {
152
+ if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("terminal は、対話できる端末で実行してください")
153
+ const paths = terminalPaths(home)
154
+ let token: string
155
+ try {
156
+ token = readFileSync(paths.token, "utf8")
157
+ } catch {
158
+ throw new Error(`中継が動いていないか、別の RELAY_HOME で動いています(${paths.token} がありません)。先に agent-chat-relay serve を起動してください`)
159
+ }
160
+ const socket = createConnection(paths.socket)
161
+ socket.setEncoding("utf8")
162
+ await new Promise<void>((resolve, reject) => {
163
+ socket.once("connect", resolve)
164
+ socket.once("error", (err) => reject(new Error(`中継につなげませんでした(${paths.socket}): ${err.message}`)))
165
+ })
166
+ const app = render(createElement(Terminal, { socket, token }))
167
+ try {
168
+ await app.waitUntilExit()
169
+ } finally {
170
+ socket.destroy()
171
+ }
172
+ }