@dotlabo/agent-chat-relay 0.0.0-stage → 0.1.1

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.
@@ -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
+ }