@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,44 @@
1
+ // 受け取った添付と、返した画像を消す時期(ADR 0005)。
2
+
3
+ import { readdirSync, rmSync, statSync } from "node:fs"
4
+ import { join } from "node:path"
5
+ import type { Log } from "./relay.ts"
6
+
7
+ /** 受け取った添付と公開した画像を残す期間 */
8
+ export const RETENTION_MS = 7 * 24 * 60 * 60 * 1000
9
+
10
+ /** dir の直下で、更新から maxAgeMs を過ぎたファイルを消す。消した数を返す */
11
+ export function pruneOld(dir: string, maxAgeMs: number): number {
12
+ let names: string[]
13
+ try {
14
+ names = readdirSync(dir)
15
+ } catch {
16
+ return 0
17
+ }
18
+ let n = 0
19
+ for (const name of names) {
20
+ const p = join(dir, name)
21
+ try {
22
+ const st = statSync(p)
23
+ if (st.isFile() && Date.now() - st.mtimeMs > maxAgeMs) {
24
+ rmSync(p)
25
+ n++
26
+ }
27
+ } catch {
28
+ // 途中で消えたものは無視する
29
+ }
30
+ }
31
+ return n
32
+ }
33
+
34
+ /** dir の中の、保存から 7 日を過ぎたファイルを、今と 1 時間ごとに消す。止める関数を返す */
35
+ export function schedulePrune(dir: string, what: string, log: Log): () => void {
36
+ const prune = () => {
37
+ const removed = pruneOld(dir, RETENTION_MS)
38
+ if (removed > 0) log.info(`7 日を過ぎた${what}を消しました`, { removed })
39
+ }
40
+ prune()
41
+ const timer = setInterval(prune, 60 * 60 * 1000)
42
+ timer.unref()
43
+ return () => clearInterval(timer)
44
+ }
@@ -0,0 +1,137 @@
1
+ // ハーネスごとの起動方法。実行承認と設定の読み込みに関わる部分は安全境界(AGENTS.md、ADR 0017)。
2
+
3
+ import { existsSync, readFileSync, writeFileSync } from "node:fs"
4
+ import { join } from "node:path"
5
+ import { fileURLToPath } from "node:url"
6
+ import type { HarnessConfig } from "./harness.ts"
7
+ import type { HarnessName } from "../serve-args.ts"
8
+ import type { Log } from "../core/relay.ts"
9
+
10
+ /**
11
+ * Bun で別のプログラムを動かすときの先頭部分。Bun は、cwd の .env を環境変数に読み込み、cwd の bunfig.toml の preload を実行する。
12
+ * cwd は作業ディレクトリで、エージェントが書けるか、管理者のプロジェクトの .env がありうるので、どちらも読ませない(ADR 0019)
13
+ */
14
+ export const BUN_ISOLATED = [process.execPath, "--no-env-file", "--config=/dev/null"]
15
+
16
+ /** claude-agent-acp の入り口。起動したディレクトリではなく、このパッケージの依存から探す */
17
+ const ADAPTER = fileURLToPath(import.meta.resolve("@agentclientprotocol/claude-agent-acp/dist/index.js"))
18
+
19
+ /**
20
+ * Claude Code に読み込ませない指示のファイル。CLAUDE.local.md と .claude/rules/ も、上位のディレクトリから読まれる
21
+ * (Claude Code 2.1.327 で、CLAUDE.md・AGENTS.md だけを除くと、この 2 つが残ることを確認した)
22
+ */
23
+ export const CLAUDE_MD_EXCLUDES = ["**/AGENTS.md", "**/CLAUDE.md", "**/CLAUDE.local.md", "**/.claude/rules/**"]
24
+
25
+ /** 管理者が環境変数で選ぶ、ハーネスの設定の読み込み(ADR 0017) */
26
+ export type HarnessOptions = {
27
+ /** RELAY_HARNESS_SETTINGS=default。ユーザー設定・CLAUDE.md などを、その環境の既定どおりに読ませる */
28
+ inheritSettings: boolean
29
+ /** RELAY_HARNESS_MEMORY=1。自動メモリを有効にする */
30
+ memory: boolean
31
+ }
32
+
33
+ /** 決めた値以外は、書き間違いとして起動しない。空の値は指定なしとして扱う */
34
+ export function harnessOptionsFromEnv(env: Record<string, string | undefined>): HarnessOptions {
35
+ return {
36
+ inheritSettings: flag(env, "RELAY_HARNESS_SETTINGS", "default"),
37
+ memory: flag(env, "RELAY_HARNESS_MEMORY", "1"),
38
+ }
39
+ }
40
+
41
+ function flag(env: Record<string, string | undefined>, name: string, on: string): boolean {
42
+ const v = env[name]
43
+ if (!v) return false
44
+ if (v !== on) throw new Error(`${name} に指定できるのは ${on} だけです(今は ${JSON.stringify(v)})`)
45
+ return true
46
+ }
47
+
48
+ export function harnessConfig(
49
+ name: Exclude<HarnessName, "pi">,
50
+ cwd: string,
51
+ mcp: HarnessConfig["mcp"],
52
+ opts: HarnessOptions,
53
+ log: Log,
54
+ /** 管理者が指定した作業ディレクトリ(RELAY_WORKSPACE)か。中継専用でなければ、管理者のファイルを上書きしない */
55
+ specified = false,
56
+ env: Record<string, string | undefined> = process.env,
57
+ ): Omit<HarnessConfig, "stderrPath"> {
58
+ switch (name) {
59
+ case "claude": {
60
+ const claude = Bun.which("claude", { PATH: env.PATH ?? "" })
61
+ if (!claude) throw new Error("claude が見つかりません")
62
+ return {
63
+ // Agent SDK に同梱の CLI ではなく、インストール済みの claude を使う
64
+ command: [...BUN_ISOLATED, ADAPTER],
65
+ env: { CLAUDE_CODE_EXECUTABLE: claude },
66
+ cwd,
67
+ mcp,
68
+ mode: "default",
69
+ meta: { claudeCode: { options: claudeOptions(opts) } },
70
+ }
71
+ }
72
+ case "opencode": {
73
+ // 今は実行承認が働かない(#6)。安全境界を割るので、明示しない限り起動しない
74
+ if (env.RELAY_ALLOW_UNSAFE_HARNESS !== "1") {
75
+ throw new Error("opencode では実行承認が働かない(#6)ため、RELAY_ALLOW_UNSAFE_HARNESS=1 がないと起動しません")
76
+ }
77
+ // OpenCode は今もユーザーの設定を読み、自動メモリもない
78
+ if (opts.inheritSettings || opts.memory) log.info("RELAY_HARNESS_SETTINGS・RELAY_HARNESS_MEMORY は、opencode には効きません")
79
+ writeOpencodeConfig(cwd, env.RELAY_OPENCODE_MODEL, specified)
80
+ return { command: ["opencode", "acp"], cwd, mcp }
81
+ }
82
+ }
83
+ }
84
+
85
+ /** Claude Code の Agent SDK の options。指定のない項目は、その環境の claude の既定になる */
86
+ export function claudeOptions(opts: HarnessOptions): Record<string, unknown> {
87
+ return {
88
+ // ユーザー設定(~/.claude/settings.json)の allow ルールや hooks を読み込ませない
89
+ ...(opts.inheritSettings ? {} : { settingSources: ["project", "local"] }),
90
+ settings: {
91
+ // ユーザーや上位ディレクトリの CLAUDE.md・AGENTS.md などを読み込ませない
92
+ ...(opts.inheritSettings ? {} : { claudeMdExcludes: CLAUDE_MD_EXCLUDES }),
93
+ // ユーザー設定で切っていても、指定があれば有効にする(ここで渡す値は、ユーザー・project の設定より優先される)
94
+ autoMemoryEnabled: opts.memory,
95
+ // ツールを実行するたびに承認を求める。指定しないと、claude-agent-acp は auto モード(分類器による自動承認)で始める。
96
+ // mcp__chat だけは承認なし(送り先は中継が、登録したルームと許可した DM に限る。ADR 0008)。
97
+ // どちらも、設定の読み込みを管理者の環境に合わせても外さない(ADR 0017)
98
+ permissions: { defaultMode: "default", allow: ["mcp__chat"] },
99
+ },
100
+ }
101
+ }
102
+
103
+ /**
104
+ * 作業ディレクトリに opencode.json を書く。管理者が指定した作業ディレクトリでは、管理者の書いた設定を上書きしない(ADR 0017)。
105
+ * そこでは、前回の起動で中継が書いたもの(中身が同じもの)だけを、そのまま使う
106
+ */
107
+ function writeOpencodeConfig(cwd: string, model: string | undefined, specified: boolean): void {
108
+ // 既定ではほぼすべてを承認なしで実行するので、すべて尋ねたうえで、読み取りとチャット用ツールだけを許す。
109
+ // 組み込みの build エージェントの規則(* を許可)より後に効くよう、エージェントの規則として書く(後の規則ほど優先される)
110
+ const config = {
111
+ $schema: "https://opencode.ai/config.json",
112
+ ...(model ? { model } : {}),
113
+ agents: {
114
+ build: {
115
+ permissions: [
116
+ { action: "*", resource: "*", effect: "ask" },
117
+ ...["read", "glob", "grep", "subagent"].map((action) => ({ action, resource: "*", effect: "allow" })),
118
+ { action: "chat_*", resource: "*", effect: "allow" },
119
+ // 選択肢での質問は中継しない。チャットで尋ねさせる
120
+ { action: "question", resource: "*", effect: "deny" },
121
+ // 作業ディレクトリの外は、読み取りでも尋ねる
122
+ { action: "external_directory", resource: "*", effect: "ask" },
123
+ ],
124
+ },
125
+ },
126
+ }
127
+ const text = JSON.stringify(config, null, 2) + "\n"
128
+ const path = join(cwd, "opencode.json")
129
+ if (specified) {
130
+ // opencode.jsonc は、中継の書く権限の設定より優先されるかもしれない(未確認)
131
+ if (existsSync(join(cwd, "opencode.jsonc"))) throw new Error(`作業ディレクトリに opencode.jsonc があるため、起動しません: ${cwd}`)
132
+ if (existsSync(path) && readFileSync(path, "utf8") !== text) {
133
+ throw new Error(`作業ディレクトリの opencode.json が中継の書く内容と違うため、起動しません(上書きしません。中継が前回書いたものなら、消してから起動してください): ${path}`)
134
+ }
135
+ }
136
+ writeFileSync(path, text)
137
+ }
@@ -0,0 +1,254 @@
1
+ // ハーネスを ACP で動かす(ADR 0006)。中継が ACP のクライアントになり、ハーネスを子プロセスとして起動する。
2
+ // セッションは 1 つ。チャット用ツールの MCP サーバーを session/new(再開なら session/resume か session/load)で渡し、発言は session/prompt で渡し、作業中に届いた発言は、対応していれば _session/steering で差し込む(ADR 0018)。
3
+
4
+ import * as acp from "@agentclientprotocol/sdk"
5
+ import type { Log, PermissionRequest, Session, Verdict } from "../core/relay.ts"
6
+ import { RotatingFile } from "./log-file.ts"
7
+ import { VERSION } from "../version.ts"
8
+
9
+ export type HarnessConfig = {
10
+ command: string[]
11
+ env?: Record<string, string>
12
+ /** false のときは env で明示した変数だけを子に渡す。 */
13
+ inheritEnv?: false
14
+ /** 操作と対象を省略した承認を受け付けないハーネスに指定する。 */
15
+ requireFullPermissionDisplay?: true
16
+ /** 中継の環境変数のうち、ハーネスに渡さないもの(RELAY_*・DOTENV_* のほかに) */
17
+ withheld?: string[]
18
+ /** セッションの作業ディレクトリ(絶対パス) */
19
+ cwd: string
20
+ mcp: { url: string; token: string }
21
+ /** 再開するセッションの ID。なければ新しく作る。作業ディレクトリ(cwd)で作ったセッションだけを再開する */
22
+ sessionId?: string
23
+ /** session/new・session/resume・session/load の _meta(ハーネス固有の設定。Claude Code の設定の読み込みなど) */
24
+ meta?: Record<string, unknown>
25
+ /**
26
+ * セッションのモード(ACP の session mode)。違うモードで始まったら、最初の発言の前に切り替える。安全境界。
27
+ * 再開でも会話記録のモードは引き継がない(権限は会話ではなく、中継の起動設定に属する。docs/relay.md)
28
+ */
29
+ mode?: string
30
+ /** ハーネスの stderr を追記するファイル。画面には出さない。10MB を超えそうになったら <path>.1 に移して新しく始める */
31
+ stderrPath: string
32
+ }
33
+
34
+ const MAX_STDERR_BYTES = 10 * 1024 * 1024
35
+
36
+ /**
37
+ * ハーネスの stdin を、ACP の SDK に渡す stream にする。書き込みの失敗(ハーネスが読まずに終了したときの EPIPE など)は
38
+ * Promise で返し、SDK に接続を閉じさせる。受けずに捨てると、受け手のない reject になり、中継のプロセスごと終了する
39
+ */
40
+ export function stdinStream(sink: Bun.FileSink): WritableStream<Uint8Array> {
41
+ return new WritableStream<Uint8Array>({
42
+ async write(chunk) {
43
+ await sink.write(chunk)
44
+ await sink.flush()
45
+ },
46
+ async close() {
47
+ await sink.end()
48
+ },
49
+ })
50
+ }
51
+
52
+ export async function startHarness(
53
+ cfg: HarnessConfig,
54
+ onPermission: (req: PermissionRequest) => Promise<Verdict>,
55
+ log: Log,
56
+ ): Promise<{ sessionId: string; session: Session; exited: Promise<number>; stop: () => void }> {
57
+ // stderr はファイルへ直接つながず、中継が受けて書く。サイズを数えてローテーションするため
58
+ const stderrLog = new RotatingFile(cfg.stderrPath, MAX_STDERR_BYTES)
59
+ const proc = Bun.spawn(cfg.command, {
60
+ cwd: cfg.cwd,
61
+ // 中継の秘密情報(LINE のトークンなど)をハーネスへ渡さない。渡すと、エージェントが送信先の制限を迂回できる
62
+ env: cfg.inheritEnv === false ? (cfg.env ?? {}) : { ...withoutRelaySecrets(process.env, cfg.withheld ?? []), ...cfg.env },
63
+ stdin: "pipe",
64
+ stdout: "pipe",
65
+ stderr: "pipe",
66
+ })
67
+ const stderrDrained = (async () => {
68
+ let failed = false
69
+ try {
70
+ // 書けなくても読み続ける。読むのをやめると、パイプが詰まってハーネスが止まる
71
+ for await (const chunk of proc.stderr) {
72
+ try {
73
+ stderrLog.write(chunk)
74
+ } catch (err) {
75
+ if (!failed) log.error("harness.log に書けませんでした", { error: String(err) })
76
+ failed = true
77
+ }
78
+ }
79
+ } finally {
80
+ stderrLog.close()
81
+ }
82
+ })()
83
+ const stream = acp.ndJsonStream(stdinStream(proc.stdin), proc.stdout as ReadableStream<Uint8Array>)
84
+
85
+ let turnText = ""
86
+ // session/load が応答の前に再送する履歴は、新しい出力として扱わない
87
+ let replaying = false
88
+ const app = acp
89
+ .client({ name: "agent-chat-relay" })
90
+ .onRequest("session/request_permission", async ({ params }) => {
91
+ const tc = params.toolCall
92
+ const title = tc.title ?? tc.kind ?? "ツールの実行"
93
+ const input = tc.rawInput === undefined ? "" : JSON.stringify(tc.rawInput, null, 2)
94
+ const always = alwaysOption(tc.kind, params.options)
95
+ // そのターンでエージェントが書いた文も渡す。承認依頼の送り先を推すのに使う(ADR 0026)
96
+ const verdict = await onPermission({ title, input, always: always?.name, agentText: turnText, ...(cfg.requireFullPermissionDisplay ? { requireFullDisplay: true } : {}) })
97
+ const option = verdict === "always" && always ? always : params.options.find((o) => o.kind === (verdict === "deny" ? "reject_once" : "allow_once"))
98
+ log.info(`実行承認:${verdict}`, { tool: title })
99
+ if (!option) return { outcome: { outcome: "cancelled" } }
100
+ return { outcome: { outcome: "selected", optionId: option.optionId } }
101
+ })
102
+ .onNotification("session/update", ({ params }) => {
103
+ if (replaying) return
104
+ const u = params.update
105
+ if (u.sessionUpdate === "agent_message_chunk" && u.content.type === "text") turnText += u.content.text
106
+ if (u.sessionUpdate === "tool_call") log.info(`ツール:${u.title}`)
107
+ })
108
+
109
+ const ready = Promise.withResolvers<{ sessionId: string; session: Session }>()
110
+ const done = Promise.withResolvers<void>()
111
+ void app
112
+ .connectWith(stream, async (ctx) => {
113
+ const init = await ctx.request("initialize", {
114
+ protocolVersion: acp.PROTOCOL_VERSION,
115
+ clientCapabilities: {},
116
+ clientInfo: { name: "agent-chat-relay", version: VERSION },
117
+ })
118
+ if (!init.agentCapabilities?.mcpCapabilities?.http) {
119
+ throw new Error("このハーネスは HTTP の MCP サーバーに対応していません")
120
+ }
121
+ const { sessionId, modes, start } = await openSession(ctx, init.agentCapabilities, cfg, log, (on) => (replaying = on))
122
+ let mode = modes?.currentModeId
123
+ if (cfg.mode && mode !== cfg.mode) {
124
+ if (!modes?.availableModes.some((m) => m.id === cfg.mode)) throw new Error(`モード ${cfg.mode} を使えません(今は ${mode})`)
125
+ await ctx.request("session/set_mode", { sessionId, modeId: cfg.mode })
126
+ log.info(`モードを ${mode} から ${cfg.mode} に切り替えました`)
127
+ mode = cfg.mode
128
+ }
129
+ const steering = (init._meta as { steering?: { supported?: unknown } } | null | undefined)?.steering?.supported === true
130
+ log.info(start === "new" ? "セッションを開始しました" : "セッションを再開しました", {
131
+ sessionId,
132
+ start,
133
+ agent: init.agentInfo?.name,
134
+ version: init.agentInfo?.version,
135
+ protocol: init.protocolVersion,
136
+ mode,
137
+ steering,
138
+ })
139
+ const session: Session = {
140
+ async prompt(text) {
141
+ turnText = ""
142
+ const res = await ctx.request("session/prompt", { sessionId, prompt: [{ type: "text", text }] })
143
+ // reply を使わずに書いた文章はチャットに届かない。気づけるようにログに出す
144
+ if (turnText.trim()) log.info("ターンの出力(チャットには届いていない)", { stopReason: res.stopReason, text: turnText.trim().slice(0, 300) })
145
+ },
146
+ // 標準化前の拡張(ADR 0018)。宣言しているハーネスでだけ使う
147
+ ...(steering ? { steer: (text: string) => steer(ctx, sessionId, text, log) } : {}),
148
+ }
149
+ ready.resolve({ sessionId, session })
150
+ await done.promise
151
+ })
152
+ .catch((err) => {
153
+ ready.reject(err)
154
+ // 始められなかったハーネスを残さない
155
+ proc.kill()
156
+ })
157
+
158
+ // stderr を書き終えてから終了を通知する(異常終了のとき、呼び出し側がログの末尾を読む)
159
+ const exited = Promise.all([proc.exited, stderrDrained.catch(() => {})]).then(([code]) => {
160
+ done.resolve()
161
+ ready.reject(new Error(`ハーネスが終了しました(終了コード ${code})`))
162
+ return code
163
+ })
164
+ return { ...await ready.promise, exited, stop: () => proc.kill() }
165
+ }
166
+
167
+ type Opened = { sessionId: string; modes?: acp.SessionModeState | null; start: "new" | "resume" | "load" }
168
+
169
+ /**
170
+ * セッションを新しく作るか、cfg.sessionId のセッションを再開する(docs/relay.md の「セッションの再開」)。
171
+ * resume を優先し(履歴を再送しない)、失敗しても load には切り替えず、新しくも作らない
172
+ */
173
+ async function openSession(
174
+ ctx: acp.ClientContext,
175
+ caps: acp.AgentCapabilities | undefined,
176
+ cfg: HarnessConfig,
177
+ log: Log,
178
+ setReplaying: (on: boolean) => void,
179
+ ): Promise<Opened> {
180
+ // 再開でも、起動ごとの MCP の認証情報と _meta(設定の読み込み)を毎回渡す
181
+ const setup: acp.NewSessionRequest = {
182
+ cwd: cfg.cwd,
183
+ mcpServers: [{ type: "http", name: "chat", url: cfg.mcp.url, headers: [{ name: "Authorization", value: `Bearer ${cfg.mcp.token}` }] }],
184
+ ...(cfg.meta ? { _meta: cfg.meta } : {}),
185
+ }
186
+ const sessionId = cfg.sessionId
187
+ if (sessionId === undefined) return { ...(await ctx.request("session/new", setup)), start: "new" }
188
+
189
+ const start = caps?.sessionCapabilities?.resume ? "resume" : caps?.loadSession ? "load" : undefined
190
+ if (!start) throw new Error("このハーネスは、セッションの再開(session/resume・session/load)に対応していません")
191
+ // 作業ディレクトリで作ったセッションだけを再開する。一覧で確認できなければハーネスに任せる
192
+ if (!caps?.sessionCapabilities?.list) {
193
+ log.info("ハーネスがセッションの一覧に対応していないため、作業ディレクトリのセッションかどうかは確かめずに再開します", { sessionId })
194
+ } else if (!(await listed(ctx, sessionId, cfg.cwd))) {
195
+ throw new Error(`作業ディレクトリのセッションに ${sessionId} がありません。再開できるのは、中継の作業ディレクトリ(${cfg.cwd})で作ったセッションだけです`)
196
+ }
197
+ try {
198
+ if (start === "resume") return { sessionId, modes: (await ctx.request("session/resume", { sessionId, ...setup })).modes, start }
199
+ setReplaying(true)
200
+ try {
201
+ return { sessionId, modes: (await ctx.request("session/load", { sessionId, ...setup }))?.modes, start }
202
+ } finally {
203
+ setReplaying(false)
204
+ }
205
+ } catch (err) {
206
+ throw new Error(`セッション ${sessionId} を再開できませんでした(session/${start}): ${err instanceof Error ? err.message : String(err)}`)
207
+ }
208
+ }
209
+
210
+ /** 作業ディレクトリを cwd にした session/list に、その ID があるか。全ページを読む */
211
+ /**
212
+ * 作業中のターンに発言を差し込む(`_session/steering`。ADR 0018)。
213
+ * idleBehavior: promptRequired を付け、ターンが終わっていたら、ハーネスに新しいターンを始めさせず、発言を中継の手元に残す
214
+ */
215
+ async function steer(ctx: acp.ClientContext, sessionId: string, text: string, log: Log): Promise<boolean> {
216
+ const res = await ctx.request<{ outcome?: string }>("_session/steering", {
217
+ sessionId,
218
+ prompt: [{ type: "text", text }],
219
+ _meta: { steering: { idleBehavior: "promptRequired" } },
220
+ })
221
+ if (res?.outcome === "injected") {
222
+ log.info("作業中のターンに、届いた発言を差し込みました")
223
+ return true
224
+ }
225
+ if (res?.outcome === "promptRequired") return false
226
+ // それ以外(startedNewTurn など)は、発言がどう扱われたか中継からは分からない
227
+ throw new Error(`_session/steering の結果が想定外です:${JSON.stringify(res)}`)
228
+ }
229
+
230
+ async function listed(ctx: acp.ClientContext, sessionId: string, cwd: string): Promise<boolean> {
231
+ const seen = new Set<string>()
232
+ let cursor: string | undefined
233
+ for (;;) {
234
+ const page = await ctx.request("session/list", { cwd, ...(cursor ? { cursor } : {}) })
235
+ if (page.sessions.some((s) => s.sessionId === sessionId)) return true
236
+ cursor = page.nextCursor ?? undefined
237
+ // 最後のページか、同じカーソルが戻ってきたら終える
238
+ if (cursor === undefined || seen.has(cursor)) return false
239
+ seen.add(cursor)
240
+ }
241
+ }
242
+
243
+ function withoutRelaySecrets(env: Record<string, string | undefined>, withheld: string[]): Record<string, string | undefined> {
244
+ return Object.fromEntries(Object.entries(env).filter(([k]) => !/^(RELAY_|DOTENV_)/.test(k) && !withheld.includes(k)))
245
+ }
246
+
247
+ /**
248
+ * 承認者に示す「常に許可」の選択肢(ADR 0015)。複数あれば先頭の 1 つ。
249
+ * モードの切り替え(Claude Code では計画の承認から auto などに移る)と、ファイルの編集(セッションのあいだ編集をすべて許す)には示さない
250
+ */
251
+ export function alwaysOption(kind: acp.ToolKind | null | undefined, options: acp.PermissionOption[]): acp.PermissionOption | undefined {
252
+ if (kind === "switch_mode" || kind === "edit") return undefined
253
+ return options.find((o) => o.kind === "allow_always")
254
+ }
@@ -0,0 +1,34 @@
1
+ // ハーネスの stderr を書くファイル。
2
+
3
+ import { closeSync, fstatSync, mkdirSync, openSync, renameSync, writeSync } from "node:fs"
4
+ import { dirname } from "node:path"
5
+
6
+ /** 追記用のファイル。max バイトを超えそうになったら <path>.1 に移し(前の .1 は消える)、新しく始める */
7
+ export class RotatingFile {
8
+ private fd: number
9
+ private size: number
10
+
11
+ constructor(
12
+ private readonly path: string,
13
+ private readonly max: number,
14
+ ) {
15
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 })
16
+ this.fd = openSync(path, "a", 0o600)
17
+ this.size = fstatSync(this.fd).size
18
+ }
19
+
20
+ write(chunk: Uint8Array): void {
21
+ if (this.size > 0 && this.size + chunk.length > this.max) {
22
+ closeSync(this.fd)
23
+ renameSync(this.path, `${this.path}.1`)
24
+ this.fd = openSync(this.path, "a", 0o600)
25
+ this.size = 0
26
+ }
27
+ writeSync(this.fd, chunk)
28
+ this.size += chunk.length
29
+ }
30
+
31
+ close(): void {
32
+ closeSync(this.fd)
33
+ }
34
+ }
@@ -0,0 +1,49 @@
1
+ import { homedir } from "node:os"
2
+ import { join, resolve } from "node:path"
3
+ import { fileURLToPath } from "node:url"
4
+ import type { Log, PermissionRequest, Verdict } from "../../core/relay.ts"
5
+ import { BUN_ISOLATED, type HarnessOptions } from "../config.ts"
6
+ import { startHarness, type HarnessConfig } from "../harness.ts"
7
+ import { preparePiState } from "./state.ts"
8
+
9
+ const ADAPTER = fileURLToPath(new URL("../../vendor/pi/adapter.js", import.meta.url))
10
+
11
+ type PiLaunch = Pick<HarnessConfig, "cwd" | "sessionId" | "stderrPath"> & { home: string; options: HarnessOptions }
12
+
13
+ /** コネクターを起動する前に設定・台帳を確認する。 */
14
+ export function preparePiLaunch({ home, options, cwd, sessionId, stderrPath }: PiLaunch, log: Log) {
15
+ if (options.memory) throw new Error("pi では自動メモリを指定できません")
16
+ const state = preparePiState(home, cwd)
17
+ if (sessionId !== undefined) state.requireSession(sessionId)
18
+ state.checkModelFiles()
19
+ const inherited = options.inheritSettings ? resolve(process.env.PI_CODING_AGENT_DIR || join(homedir(), ".pi", "agent")) : undefined
20
+ return async (mcp: HarnessConfig["mcp"], onPermission: (req: PermissionRequest) => Promise<Verdict>) => {
21
+ if (inherited) log.error("警告:pi の端末・プロジェクト設定を引き継ぎます。信頼済みの拡張などが実行承認を通らずに動くことがあります")
22
+ const launched = await startHarness({
23
+ command: [...BUN_ISOLATED, ADAPTER],
24
+ cwd: state.workspace, mcp, sessionId, stderrPath,
25
+ inheritEnv: false,
26
+ requireFullPermissionDisplay: true,
27
+ env: {
28
+ HOME: state.childHome,
29
+ PATH: "/usr/bin:/bin",
30
+ TMPDIR: state.temp,
31
+ PI_OFFLINE: "1",
32
+ PI_TELEMETRY: "0",
33
+ PI_ACP_MANAGED_CHAT_WORKSPACE: state.workspace,
34
+ PI_CODING_AGENT_DIR: state.agentDir,
35
+ ...(inherited ? { PI_ACP_INHERITED_AGENT_DIR: inherited } : {}),
36
+ },
37
+ }, onPermission, log)
38
+ if (sessionId === undefined) {
39
+ try {
40
+ state.registerSession(launched.sessionId)
41
+ } catch {
42
+ launched.stop()
43
+ await launched.exited
44
+ throw new Error("中継の pi セッション台帳に記録できませんでした")
45
+ }
46
+ }
47
+ return launched
48
+ }
49
+ }
@@ -0,0 +1,97 @@
1
+ import { constants, closeSync, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, writeFileSync } from "node:fs"
2
+ import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path"
3
+
4
+ const SESSION_ID = /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/
5
+
6
+ function contains(dir: string, path: string): boolean {
7
+ const rel = relative(dir, path)
8
+ return rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel)
9
+ }
10
+
11
+ /** まだない部分は、その親の実パスに名前を足す。リンク切れはエラーにする。 */
12
+ function realLocation(path: string): string {
13
+ if (lstatSync(path, { throwIfNoEntry: false })) return realpathSync(path)
14
+ return join(realLocation(dirname(path)), basename(path))
15
+ }
16
+
17
+ function directory(path: string, allowed: number, recursive = false): void {
18
+ try {
19
+ mkdirSync(path, { mode: 0o700, recursive })
20
+ } catch (err) {
21
+ if ((err as NodeJS.ErrnoException).code !== "EEXIST") throw err
22
+ }
23
+ const entry = lstatSync(path)
24
+ if (!entry.isDirectory() || entry.uid !== process.getuid?.() || (entry.mode & 0o777 & ~allowed) !== 0 || realpathSync(path) !== path) {
25
+ throw new Error(`pi の管理領域は、自分が所有する実ディレクトリを指定してください: ${path}`)
26
+ }
27
+ }
28
+
29
+ /** 秘密情報・台帳を、リンク経由や他の利用者が読めるファイルから取らない。 */
30
+ function privateFile(path: string): Buffer {
31
+ const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK)
32
+ try {
33
+ const entry = fstatSync(fd)
34
+ if (!entry.isFile() || entry.nlink !== 1 || entry.uid !== process.getuid?.() || (entry.mode & 0o077) !== 0 || entry.size > 1024 * 1024) throw new Error()
35
+ return readFileSync(fd)
36
+ } finally {
37
+ closeSync(fd)
38
+ }
39
+ }
40
+
41
+ export function preparePiState(home: string, cwd: string) {
42
+ const workspace = realpathSync(cwd)
43
+ const root = realLocation(resolve(home))
44
+ const pi = join(root, "pi")
45
+ if (contains(workspace, root) || contains(pi, workspace)) throw new Error("pi の管理領域と作業ディレクトリは分けてください")
46
+ directory(root, 0o755, true)
47
+ directory(pi, 0o700)
48
+ const agentDir = join(pi, "agent")
49
+ const childHome = join(pi, "home")
50
+ const temp = join(pi, "tmp")
51
+ const registry = join(pi, "registered-sessions")
52
+ for (const path of [agentDir, join(agentDir, "sessions"), childHome, temp, registry]) directory(path, 0o700)
53
+ // pi-acp が開いて更新するファイル。既存の対応表を通じて、別のファイルへ書かない。
54
+ const map = lstatSync(join(agentDir, "pi-acp-session-map.json"), { throwIfNoEntry: false })
55
+ if (map && (!map.isFile() || map.nlink !== 1 || map.uid !== process.getuid?.() || (map.mode & 0o022) !== 0)) {
56
+ throw new Error("pi-acp の対応表は、自分が所有する通常ファイルでなければ使えません")
57
+ }
58
+
59
+ function sessionFile(id: string) {
60
+ if (!SESSION_ID.test(id)) throw new Error("pi のセッション ID が不正です")
61
+ return join(registry, `${id}.json`)
62
+ }
63
+ function record(id: string) {
64
+ return { harness: "pi", workspace, sessionId: id }
65
+ }
66
+ return {
67
+ workspace, agentDir, childHome, temp,
68
+ checkModelFiles() {
69
+ const settings = join(agentDir, "settings.json")
70
+ const auth = join(agentDir, "auth.json")
71
+ const models = join(agentDir, "models.json")
72
+ for (const path of [settings, auth, ...(lstatSync(models, { throwIfNoEntry: false }) ? [models] : [])]) {
73
+ try {
74
+ const value: unknown = JSON.parse(privateFile(path).toString("utf8"))
75
+ if (typeof value !== "object" || value === null || Array.isArray(value) || Object.keys(value).length === 0) throw new Error()
76
+ } catch {
77
+ throw new Error(`pi 専用の設定・認証を、自分だけが読める通常の JSON ファイルに用意してください: ${path}`)
78
+ }
79
+ }
80
+ },
81
+ requireSession(id: string) {
82
+ const path = sessionFile(id)
83
+ try {
84
+ const saved = JSON.parse(privateFile(path).toString("utf8")) as ReturnType<typeof record>
85
+ const expected = record(id)
86
+ if (saved.harness === expected.harness && saved.workspace === expected.workspace && saved.sessionId === expected.sessionId) return
87
+ } catch {
88
+ // 台帳を読めない場合も、記録がない場合と同じように起動しない。
89
+ }
90
+ throw new Error("同じ作業ディレクトリで中継が作った pi のセッションに限って再開できます")
91
+ },
92
+ registerSession(id: string) {
93
+ // セッション ID は新規。既存の台帳やリンクには書かない。
94
+ writeFileSync(sessionFile(id), JSON.stringify(record(id)) + "\n", { flag: "wx", mode: 0o600 })
95
+ },
96
+ }
97
+ }