aiterm-mcp 0.27.6 → 0.27.8

package/dist/agent-shared.js

@@ -0,0 +1,209 @@
+// vendor中立の共有プリミティブ。core と vendors/ の両方が依存する最下層で、
+// tmux-runtime / errors 以外の内部moduleへ依存しない（依存方向: core → vendors → agent-shared）。
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { randomBytes } from "node:crypto";
+import { AitermError } from "./errors.js";
+export const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
+export function currentUid() {
+    // Windows(native)は process.getuid を持たない。以前はここで throw していたが、
+    // agent metadata の存在確認経由で素の pty_send まで巻き込んで全 send を殺していた。
+    // Windows の fs.Stats.uid は常に 0 なので、ここも 0 を返せば owner 比較
+    // (st.uid !== currentUid()) は自然に通過する。Windows は POSIX owner 検証を
+    // 持たない（NTFS ACL は別体系）という既知の制約の明示的受容であり、POSIX 側は
+    // getuid をそのまま返すため挙動不変。
+    if (typeof process.getuid !== "function")
+        return 0;
+    return process.getuid();
+}
+export function runtimeStateBase() {
+    const xdg = process.env.XDG_RUNTIME_DIR;
+    if (xdg) {
+        try {
+            if (fs.statSync(xdg).isDirectory())
+                return xdg;
+        }
+        catch {
+            /* XDG_RUNTIME_DIR が壊れている CI/非 login 環境では os.tmpdir() に戻す */
+        }
+    }
+    return os.tmpdir();
+}
+export function safeStatSize(p) {
+    try {
+        return fs.statSync(p).size;
+    }
+    catch {
+        return 0;
+    }
+}
+export function readFileRange(p, from, to) {
+    const len = Math.max(0, to - from);
+    if (len === 0)
+        return Buffer.alloc(0);
+    let fd;
+    try {
+        fd = fs.openSync(p, "r");
+        const buf = Buffer.alloc(len);
+        const n = fs.readSync(fd, buf, 0, len, from);
+        return n === len ? buf : buf.subarray(0, Math.max(0, n));
+    }
+    catch {
+        return Buffer.alloc(0);
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch {
+                /* noop */
+            }
+        }
+    }
+}
+export function writeJson0600(p, v) {
+    // truncate-in-place はクラッシュ/ENOSPC の窓で空・途中 JSON を残すので、temp→rename の原子的置換にする
+    const tmp = `${p}.${randomBytes(6).toString("hex")}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(v, null, 2) + "\n", { mode: 0o600, flag: "wx" });
+    try {
+        fs.chmodSync(tmp, 0o600);
+    }
+    catch {
+        /* noop */
+    }
+    try {
+        fs.renameSync(tmp, p);
+    }
+    catch (e) {
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch {
+            /* noop */
+        }
+        throw e;
+    }
+}
+export function writeText0600(p, text) {
+    fs.writeFileSync(p, text, { mode: 0o600 });
+    try {
+        fs.chmodSync(p, 0o600);
+    }
+    catch {
+        /* noop */
+    }
+}
+export function createEmpty0600(p) {
+    // O_EXCL が「既存 path なら失敗」を保証するため、新規作成の一意性はこれで足りる。
+    // O_NOFOLLOW は撤去した（オーナー裁定 2026-08-19）。
+    const fd = fs.openSync(p, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY, 0o600);
+    fs.closeSync(fd);
+}
+// 単一引用符で安全に包む（' は '\'' で脱出）。send は raw:true で送るため自前で quote する。
+export function shq(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+export const LAUNCH_ID_RE = /^[0-9a-f]{32}$/;
+export const AGENT_DONE_POLL_MS = 100;
+export const AGENT_EVENT_MAX_BYTES = 1024 * 1024;
+export const AGENT_EVENT_TAIL_BYTES = 64 * 1024;
+export const CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
+export const GROK_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
+// session 名はファイルパス（logpath 等）と pipe-pane の /bin/sh 文字列へ流れる。英数 _ - のみ・64字に
+// 限定し、パストラバーサル（../）とシェルインジェクション（' でのクオート破り・$・; 等）を全入口で断つ。
+export function assertSessionName(name) {
+    if (!/^[A-Za-z0-9_-]{1,64}$/.test(name))
+        throw new AitermError(`session 名は英数字と _ - のみ・64文字以内にしてください: ${JSON.stringify(name)}`, 2);
+}
+export function stateRoot() {
+    const uid = currentUid();
+    const base = runtimeStateBase();
+    return path.join(base, `aiterm-mcp-${uid}`);
+}
+export function ensureStateRoot() {
+    // state root は OS が与える per-user runtime dir（XDG_RUNTIME_DIR / os.tmpdir()）の下に作る。
+    // 以前はここで symlink・owner・mode を検査していたが、共有 /tmp に敵対的な同居主体がいる
+    // 前提の防御であり、対応 OS の既定配置では成立しない（オーナー裁定 2026-08-19）。
+    // 作成時の 0o700 は検査ではなく妥当な既定として残す。経路の異常は以降の
+    // open/stat が OS エラーとしてそのまま露出させる。
+    const root = stateRoot();
+    fs.mkdirSync(root, { recursive: true, mode: 0o700 });
+    fs.mkdirSync(path.join(root, "agents"), { recursive: true, mode: 0o700 });
+    return root;
+}
+export function agentsDir() {
+    return path.join(ensureStateRoot(), "agents");
+}
+export function agentEventPath(name, launchId) {
+    assertSessionName(name);
+    if (!LAUNCH_ID_RE.test(launchId))
+        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
+    return path.join(agentsDir(), `${name}.${launchId}.events.jsonl`);
+}
+export function agentMetadataPath(name, launchId) {
+    assertSessionName(name);
+    if (!LAUNCH_ID_RE.test(launchId))
+        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
+    return path.join(agentsDir(), `${name}.${launchId}.agent.json`);
+}
+export function agentWaitLockPath(name, launchId) {
+    assertSessionName(name);
+    if (!LAUNCH_ID_RE.test(launchId))
+        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
+    return path.join(agentsDir(), `${name}.${launchId}.wait.lock`);
+}
+export function writeAgentMetadata(meta) {
+    writeJson0600(agentMetadataPath(meta.aiterm_session, meta.launch_id), meta);
+}
+export function agentLabel(kind) {
+    return kind === "claude"
+        ? "Claude Code"
+        : kind === "composer"
+            ? "Grok Build(Composer)"
+            : kind === "grok"
+                ? "Grok Build(Grok)"
+                : "Codex";
+}
+export function subagentInstruction(meta) {
+    if (meta.agent_role !== "subagent" ||
+        !meta.parent_session_id ||
+        !Number.isSafeInteger(meta.delegation_depth) ||
+        !meta.lineage ||
+        meta.delegation_allowed !== true) {
+        throw new AitermError("sub-agent instructionに必要なlineage metadataがありません", 2);
+    }
+    return [
+        "<aiterm_subagent_context>",
+        "あなたはaitermから起動されたsub-agentであり、root agentではありません。",
+        `AITERM_AGENT_LAUNCH_ID=${meta.launch_id}`,
+        `role=${meta.agent_role}`,
+        `parent_session_id=${meta.parent_session_id}`,
+        `delegation_depth=${meta.delegation_depth}`,
+        `lineage=${meta.lineage}`,
+        "delegation_allowed=true",
+        "任務の所有権を保ち、結果を親へ返してください。必要なら追加のsub-agentへ委譲してよいです。",
+        "ただし、同じ任務全体を同型agentへ反射的に丸投げして自己複製ループを作らないでください。",
+        "</aiterm_subagent_context>",
+    ].join("\n");
+}
+// launch noteのwrite_scope説明。文言はkindに依存する分岐まで含めて単一実装で持つ
+// （vendor別noteへ複製すると文言が発散する）。
+export function writeScopeLaunchNote(kind, writeScope) {
+    return writeScope === undefined
+        ? ""
+        : (kind === "codex" || kind === "grok" || kind === "composer") && writeScope === "read-only"
+            ? `\n能力宣言: write_scope=${JSON.stringify(writeScope)}。${agentLabel(kind)} CLIへ --sandbox read-only を付与し、書込みを実効禁止。` +
+                (kind === "codex" ? "" : "MCPツール許可は --always-approve で自動承認（sandbox内のため能力拡大なし）。")
+            : `\n能力宣言: write_scope=${JSON.stringify(writeScope)}。パス単位のsandbox allowlistに対応するCLI引数がないため宣言の記録のみ（構造的unsupported）。`;
+}
+export function agentLineageFields(context) {
+    return {
+        agent_role: context.agentRole,
+        parent_session_id: context.parentSessionId,
+        delegation_depth: context.delegationDepth,
+        lineage: context.lineage,
+        delegation_allowed: context.delegationAllowed,
+    };
+}