sessionpipe-core 0.1.1 → 0.2.0

package/dist/index.js

@@ -1,4 +1,9 @@
-// sessionpipe-core 0.1.1 · Apache-2.0 · https://sessionpipe.org
+// sessionpipe-core 0.2.0 · Apache-2.0 · https://sessionpipe.org
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/adapters/antigravity.ts
 import {
@@ -278,7 +283,7 @@ function entryFor(event, harness, cmd, o) {
   const matcher = o.matcherFor(event);
   return {
     ...matcher !== void 0 ? { matcher } : {},
-    hooks: [{ type: "command", command: cmd([harness, event]).command, timeout: o.timeout }]
+    hooks: [{ type: "command", command: cmd([harness, event]).command, timeout: o.timeoutFor?.(event) ?? o.timeout }]
   };
 }
 function installClaudeShaped(file, harness, events, cmd, o) {
@@ -702,7 +707,13 @@ var CLAUDE_EVENTS = [
 ];
 var LEAN_SKIP = /* @__PURE__ */ new Set(["PreToolUse", "PostToolUseFailure"]);
 var eventsFor = (lean) => lean ? CLAUDE_EVENTS.filter((e) => !LEAN_SKIP.has(e)) : [...CLAUDE_EVENTS];
-var OPTS = { matcherFor: (e) => /Tool|Permission/.test(e) ? "" : void 0, timeout: 5 };
+var OPTS = {
+  matcherFor: (e) => /Tool|Permission/.test(e) ? "" : void 0,
+  timeout: 5,
+  // The hook waits up to 125 s for a verified control answer, and only when control
+  // is paired on this machine; everywhere else it exits in milliseconds as before.
+  timeoutFor: (e) => e === "PermissionRequest" ? 130 : void 0
+};
 var DESKTOP_ID = /^local_[A-Za-z0-9-]{1,64}$/;
 function claudeDirs(env = process.env, home = HOME) {
   const out = [];
@@ -1843,17 +1854,366 @@ function prune4(o) {
   return o;
 }
 
+// src/adapters/claude-code-control.ts
+var claude_code_control_exports = {};
+__export(claude_code_control_exports, {
+  JOB_TIMEOUT_MS: () => JOB_TIMEOUT_MS,
+  claudeEnv: () => claudeEnv,
+  detectCaps: () => detectCaps,
+  findClaude: () => findClaude,
+  findTranscript: () => findTranscript,
+  isUuid: () => isUuid,
+  liveProcess: () => liveProcess,
+  modeFlags: () => modeFlags,
+  parseCaps: () => parseCaps,
+  parseResult: () => parseResult,
+  recentlyWritten: () => recentlyWritten,
+  runClaude: () => runClaude,
+  sessionFolder: () => sessionFolder
+});
+import { execFileSync as execFileSync4, spawn } from "node:child_process";
+import { accessSync, closeSync as closeSync2, constants, openSync as openSync2, readdirSync as readdirSync5, readFileSync as readFileSync6, readSync as readSync2, statSync as statSync4 } from "node:fs";
+import os2 from "node:os";
+import path8 from "node:path";
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var JOB_TIMEOUT_MS = 30 * 6e4;
+var OUT_CAP = 1024 * 1024;
+var LIVE_WRITE_MS = 9e4;
+function isExe(p) {
+  try {
+    if (!statSync4(p).isFile()) return false;
+    accessSync(p, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var cmpVersion = (a, b) => {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++)
+    if ((pa[i] ?? 0) !== (pb[i] ?? 0)) return (pa[i] ?? 0) - (pb[i] ?? 0);
+  return 0;
+};
+function findClaude(env = process.env, home = os2.homedir()) {
+  if (env.SESSIONPIPE_CLAUDE && isExe(env.SESSIONPIPE_CLAUDE)) return env.SESSIONPIPE_CLAUDE;
+  const names = process.platform === "win32" ? ["claude.exe", "claude.cmd"] : ["claude"];
+  for (const d of String(env.PATH || "").split(path8.delimiter)) {
+    if (!d || !path8.isAbsolute(d)) continue;
+    for (const n of names) if (isExe(path8.join(d, n))) return path8.join(d, n);
+  }
+  for (const p of [
+    path8.join(home, ".claude", "local", "claude"),
+    path8.join(home, ".local", "bin", "claude"),
+    "/opt/homebrew/bin/claude",
+    "/usr/local/bin/claude"
+  ])
+    if (isExe(p)) return p;
+  const app = path8.join(home, "Library", "Application Support", "Claude", "claude-code");
+  let versions = [];
+  try {
+    versions = readdirSync5(app).filter((n) => /^\d+(\.\d+)*$/.test(n)).sort(cmpVersion).reverse();
+  } catch {
+  }
+  for (const v of versions) {
+    const p = path8.join(app, v, "claude.app", "Contents", "MacOS", "claude");
+    if (isExe(p)) return p;
+  }
+  return null;
+}
+function optionBlock(help, flag) {
+  const lines = help.split("\n");
+  const re = new RegExp(`^\\s{0,4}(?:-\\w, )?${flag.replace(/-/g, "\\-")}(?![\\w-])`);
+  const start = lines.findIndex((l) => re.test(l));
+  if (start < 0) return null;
+  const out = [lines[start]];
+  for (let i = start + 1; i < lines.length && lines[i]?.trim() && !/^\s{0,4}-/.test(lines[i]); i++)
+    out.push(lines[i]);
+  return out.join(" ");
+}
+function parseCaps(help) {
+  const pm = optionBlock(help, "--permission-mode");
+  const pp = optionBlock(help, "--permission-prompts");
+  return {
+    hasMode: !!pm,
+    modes: pm ? [...pm.matchAll(/"([A-Za-z]+)"/g)].map((m) => m[1]) : [],
+    promptsNone: !!pp && /"none"/.test(pp),
+    fork: !!optionBlock(help, "--fork-session")
+  };
+}
+function modeFlags(mode, caps) {
+  if (mode === "auto") {
+    if (!caps.modes.includes("auto"))
+      return { error: "this machine is in auto mode, but its Claude Code has no auto permission mode" };
+    return { args: ["--permission-mode", "auto"] };
+  }
+  if (caps.modes.includes("dontAsk")) return { args: ["--permission-mode", "dontAsk"] };
+  const args = [];
+  if (caps.hasMode)
+    args.push(
+      "--permission-mode",
+      caps.modes.includes("manual") && !caps.modes.includes("default") ? "manual" : "default"
+    );
+  if (caps.promptsNone) args.push("--permission-prompts", "none");
+  return { args };
+}
+function claudeEnv(configDir, env = process.env) {
+  const e = { ...env };
+  for (const k of [
+    "CLAUDECODE",
+    "CLAUDE_CODE_SESSION_ID",
+    "CLAUDE_CODE_HOST_SESSION_ID",
+    "CLAUDE_CODE_ENTRYPOINT",
+    "CLAUDE_CODE_SESSION_ATTENDED",
+    "CLAUDE_CODE_SSE_PORT"
+  ])
+    delete e[k];
+  e.SESSIONPIPE_CONTROL_JOB = "1";
+  if (configDir !== void 0) {
+    if (path8.resolve(configDir) === path8.resolve(os2.homedir(), ".claude")) delete e.CLAUDE_CONFIG_DIR;
+    else e.CLAUDE_CONFIG_DIR = configDir;
+  }
+  return e;
+}
+function detectCaps(bin) {
+  let help = "";
+  try {
+    help = execFileSync4(bin, ["--help"], {
+      encoding: "utf8",
+      timeout: 3e4,
+      env: claudeEnv(),
+      stdio: ["ignore", "pipe", "pipe"],
+      maxBuffer: 4 * 1024 * 1024
+    });
+  } catch (e) {
+    help = String(e?.stdout || "");
+  }
+  return parseCaps(help);
+}
+function findTranscript(session, dirs) {
+  if (!UUID_RE.test(session)) return null;
+  for (const dir of dirs) {
+    let projects = [];
+    try {
+      projects = readdirSync5(path8.join(dir, "projects"), { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const p of projects) {
+      if (!p.isDirectory()) continue;
+      const file = path8.join(dir, "projects", p.name, `${session}.jsonl`);
+      try {
+        if (statSync4(file).isFile()) return { file, configDir: dir, project: p.name };
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+var projectName = (cwd) => cwd.replace(/[^a-zA-Z0-9]/g, "-");
+function sessionFolder(t, cap2 = 8 * 1024 * 1024) {
+  let first = null;
+  let count = 0;
+  let fd;
+  const look = (line) => {
+    if (line.indexOf('"cwd"') < 0) return null;
+    let j;
+    try {
+      j = JSON.parse(line.toString("utf8"));
+    } catch {
+      return null;
+    }
+    if (!j || typeof j.cwd !== "string" || !path8.isAbsolute(j.cwd)) return null;
+    if (projectName(j.cwd) === t.project) return j.cwd;
+    first ??= j.cwd;
+    count++;
+    return null;
+  };
+  try {
+    fd = openSync2(t.file, "r");
+    const buf = Buffer.alloc(256 * 1024);
+    let pos = 0;
+    let rest = Buffer.alloc(0);
+    let skipping = false;
+    while (pos < cap2 && count < 50) {
+      const n = readSync2(fd, buf, 0, buf.length, pos);
+      if (!n) {
+        if (!skipping && rest.length) {
+          const hit = look(rest);
+          if (hit) return hit;
+        }
+        break;
+      }
+      pos += n;
+      let chunk = rest.length ? Buffer.concat([rest, buf.subarray(0, n)]) : buf.subarray(0, n);
+      let nl = chunk.indexOf(10);
+      while (nl >= 0) {
+        const line = chunk.subarray(0, nl);
+        chunk = chunk.subarray(nl + 1);
+        if (skipping) skipping = false;
+        else {
+          const hit = look(line);
+          if (hit) return hit;
+        }
+        nl = chunk.indexOf(10);
+      }
+      if (chunk.length > 2 * 1024 * 1024) {
+        skipping = true;
+        rest = Buffer.alloc(0);
+      } else rest = skipping ? Buffer.alloc(0) : Buffer.from(chunk);
+    }
+  } catch {
+  } finally {
+    if (fd !== void 0)
+      try {
+        closeSync2(fd);
+      } catch {
+      }
+  }
+  return first;
+}
+function pidAlive(pid) {
+  if (!Number.isSafeInteger(pid) || pid <= 1) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e.code === "EPERM";
+  }
+}
+function liveProcess(session, configDir) {
+  let names = [];
+  try {
+    names = readdirSync5(path8.join(configDir, "sessions")).filter((n) => /^\d+\.json$/.test(n));
+  } catch {
+    return false;
+  }
+  for (const n of names) {
+    try {
+      const j = JSON.parse(readFileSync6(path8.join(configDir, "sessions", n), "utf8"));
+      if (String(j.sessionId) !== session) continue;
+      if (pidAlive(Number(j.pid ?? n.slice(0, -5)))) return true;
+    } catch {
+    }
+  }
+  return false;
+}
+function recentlyWritten(file, ourLastEnd, now = Date.now()) {
+  let m;
+  try {
+    m = statSync4(file).mtimeMs;
+  } catch {
+    return false;
+  }
+  if (now - m > LIVE_WRITE_MS) return false;
+  return !(ourLastEnd && m <= ourLastEnd + 2e3);
+}
+function runClaude(bin, args, o) {
+  return new Promise((resolve) => {
+    let out = [];
+    let outLen = 0;
+    let tooBig = false;
+    let errTail = "";
+    let timedOut = false;
+    let settled = false;
+    let child;
+    try {
+      child = spawn(bin, args, {
+        cwd: o.cwd,
+        env: o.env,
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: process.platform !== "win32",
+        windowsHide: true
+      });
+    } catch (e) {
+      resolve({ error: e.message });
+      return;
+    }
+    const kill = (sig) => {
+      try {
+        if (process.platform !== "win32" && child.pid) process.kill(-child.pid, sig);
+        else child.kill(sig);
+      } catch {
+        try {
+          child.kill(sig);
+        } catch {
+        }
+      }
+    };
+    child.stdout?.on("data", (b) => {
+      if (tooBig) return;
+      if (outLen + b.length > OUT_CAP) {
+        tooBig = true;
+        out = [];
+        return;
+      }
+      out.push(b);
+      outLen += b.length;
+    });
+    child.stderr?.on("data", (b) => {
+      errTail = (errTail + b.toString("utf8")).slice(-4e3);
+    });
+    const timer = setTimeout(() => {
+      timedOut = true;
+      kill("SIGTERM");
+      setTimeout(() => kill("SIGKILL"), 1e4).unref();
+    }, o.timeoutMs ?? JOB_TIMEOUT_MS);
+    const result = (code, signal) => ({
+      code,
+      signal,
+      stdout: tooBig ? null : Buffer.concat(out).toString("utf8"),
+      tooBig,
+      stderr: errTail,
+      timedOut
+    });
+    const finish = (r) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(r);
+    };
+    child.on("error", (e) => finish({ error: e.message }));
+    child.on("exit", (code, signal) => setTimeout(() => finish(result(code, signal)), 2e3).unref());
+    child.on("close", (code, signal) => finish(result(code, signal)));
+  });
+}
+function parseResult(stdout) {
+  const s = String(stdout || "").trim();
+  if (!s) return null;
+  const pick = (j) => {
+    if (Array.isArray(j)) {
+      for (let i = j.length - 1; i >= 0; i--) if (j[i]?.type === "result") return j[i];
+      return null;
+    }
+    return j && typeof j === "object" ? j : null;
+  };
+  try {
+    return pick(JSON.parse(s));
+  } catch {
+  }
+  const lines = s.split("\n");
+  for (let i = lines.length - 1; i >= 0; i--) {
+    try {
+      const j = pick(JSON.parse(lines[i]));
+      if (j && (j.type === "result" || "result" in j)) return j;
+    } catch {
+    }
+  }
+  return null;
+}
+var isUuid = (s) => typeof s === "string" && UUID_RE.test(s);
+
 // src/adapters/index.ts
 var ADAPTERS = [claudeCode, codex, geminiCli, antigravity];
 var adapterByName = (name) => ADAPTERS.find((a) => a.name === name);
 
 // src/config.ts
-import { chmodSync, existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
-import path8 from "node:path";
+import { chmodSync, existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
+import path9 from "node:path";
 var DEFAULT_CONFIG = { sinks: [], harnesses: {}, update_check: true, keep_days: 30 };
 function readConfig(file = configFile()) {
   try {
-    const j = JSON.parse(readFileSync6(file, "utf8"));
+    const j = JSON.parse(readFileSync7(file, "utf8"));
     return {
       ...DEFAULT_CONFIG,
       ...j,
@@ -1865,7 +2225,7 @@ function readConfig(file = configFile()) {
   }
 }
 function writeConfig(c, file = configFile()) {
-  mkdirSync4(path8.dirname(file), { recursive: true, mode: 448 });
+  mkdirSync4(path9.dirname(file), { recursive: true, mode: 448 });
   writeFileSync4(file, `${JSON.stringify(c, null, 2)}
 `, { mode: 384 });
   if (process.platform !== "win32" && existsSync6(file)) {
@@ -1934,32 +2294,32 @@ function makeEvent(a, ctx) {
 // src/outbox.ts
 import {
   appendFileSync,
-  closeSync as closeSync2,
+  closeSync as closeSync3,
   existsSync as existsSync7,
   mkdirSync as mkdirSync5,
-  openSync as openSync2,
-  readdirSync as readdirSync5,
-  readFileSync as readFileSync7,
-  readSync as readSync2,
+  openSync as openSync3,
+  readdirSync as readdirSync6,
+  readFileSync as readFileSync8,
+  readSync as readSync3,
   renameSync,
-  statSync as statSync4,
+  statSync as statSync5,
   unlinkSync as unlinkSync3,
   writeFileSync as writeFileSync5
 } from "node:fs";
-import path9 from "node:path";
+import path10 from "node:path";
 var Outbox = class {
   constructor(root) {
     this.root = root;
   }
   root;
   dir(harness) {
-    return path9.join(this.root, "outbox", safeId(harness));
+    return path10.join(this.root, "outbox", safeId(harness));
   }
   file(ref) {
-    return path9.join(this.dir(ref.harness), `${safeId(ref.session)}.jsonl`);
+    return path10.join(this.dir(ref.harness), `${safeId(ref.session)}.jsonl`);
   }
   seqFile(ref) {
-    return path9.join(this.dir(ref.harness), `${safeId(ref.session)}.seq`);
+    return path10.join(this.dir(ref.harness), `${safeId(ref.session)}.seq`);
   }
   /** The next seq for a session, persisted (survives a hibernating machine and a
    *  restart; an in-memory counter would restart at 0 and collide). */
@@ -1967,18 +2327,18 @@ var Outbox = class {
     const f = this.seqFile(ref);
     let n = 0;
     try {
-      n = Number(readFileSync7(f, "utf8")) || 0;
+      n = Number(readFileSync8(f, "utf8")) || 0;
     } catch {
       n = this.lastSeqInFile(ref) + 1;
     }
-    mkdirSync5(path9.dirname(f), { recursive: true, mode: 448 });
+    mkdirSync5(path10.dirname(f), { recursive: true, mode: 448 });
     writeFileSync5(f, String(n + 1), { mode: 384 });
     return n;
   }
   lastSeqInFile(ref) {
     const f = this.file(ref);
     if (!existsSync7(f)) return -1;
-    const lines = readFileSync7(f, "utf8").trim().split("\n");
+    const lines = readFileSync8(f, "utf8").trim().split("\n");
     for (let i = lines.length - 1; i >= 0; i--) {
       try {
         const j = JSON.parse(lines[i] ?? "");
@@ -1997,19 +2357,19 @@ var Outbox = class {
   /** Every session file, newest first. */
   sessions() {
     const out = [];
-    const base = path9.join(this.root, "outbox");
+    const base = path10.join(this.root, "outbox");
     if (!existsSync7(base)) return [];
-    for (const h of readdirSync5(base)) {
-      const d = path9.join(base, h);
+    for (const h of readdirSync6(base)) {
+      const d = path10.join(base, h);
       let names = [];
       try {
-        names = readdirSync5(d).filter((n) => n.endsWith(".jsonl"));
+        names = readdirSync6(d).filter((n) => n.endsWith(".jsonl"));
       } catch {
         continue;
       }
       for (const n of names) {
         try {
-          out.push({ ref: { harness: h, session: n.slice(0, -6) }, mtime: statSync4(path9.join(d, n)).mtimeMs });
+          out.push({ ref: { harness: h, session: n.slice(0, -6) }, mtime: statSync5(path10.join(d, n)).mtimeMs });
         } catch {
         }
       }
@@ -2021,12 +2381,12 @@ var Outbox = class {
   read(ref, from, maxEvents = 500) {
     const f = this.file(ref);
     if (!existsSync7(f)) return { events: [], offset: from };
-    const size = statSync4(f).size;
+    const size = statSync5(f).size;
     if (from >= size) return { events: [], offset: from };
-    const fd = openSync2(f, "r");
+    const fd = openSync3(f, "r");
     try {
       const buf = Buffer.alloc(Math.min(size - from, 8 * 1024 * 1024));
-      const n = readSync2(fd, buf, 0, buf.length, from);
+      const n = readSync3(fd, buf, 0, buf.length, from);
       const text = buf.subarray(0, n).toString("utf8");
       const events = [];
       let offset = from;
@@ -2045,7 +2405,7 @@ var Outbox = class {
       }
       return { events, offset };
     } finally {
-      closeSync2(fd);
+      closeSync3(fd);
     }
   }
   /** Files older than `days` are pruned; the cursor files with them. */
@@ -2055,7 +2415,7 @@ var Outbox = class {
     for (const ref of this.sessions()) {
       const f = this.file(ref);
       try {
-        if (statSync4(f).mtimeMs < cutoff) {
+        if (statSync5(f).mtimeMs < cutoff) {
           unlinkSync3(f);
           try {
             unlinkSync3(this.seqFile(ref));
@@ -2085,18 +2445,18 @@ var Cursors = class {
   root;
   sink;
   file() {
-    return path9.join(this.root, "cursors", `${safeId(this.sink)}.json`);
+    return path10.join(this.root, "cursors", `${safeId(this.sink)}.json`);
   }
   read() {
     try {
-      return JSON.parse(readFileSync7(this.file(), "utf8"));
+      return JSON.parse(readFileSync8(this.file(), "utf8"));
     } catch {
       return {};
     }
   }
   write(c) {
     const f = this.file();
-    mkdirSync5(path9.dirname(f), { recursive: true, mode: 448 });
+    mkdirSync5(path10.dirname(f), { recursive: true, mode: 448 });
     const tmp = `${f}.${process.pid}.tmp`;
     writeFileSync5(tmp, JSON.stringify(c), { mode: 384 });
     renameSync(tmp, f);
@@ -2106,11 +2466,11 @@ var Cursors = class {
   }
 };
 function takeLock(root, ref, staleMs = 5 * 6e4) {
-  const dir = path9.join(root, "locks");
+  const dir = path10.join(root, "locks");
   mkdirSync5(dir, { recursive: true, mode: 448 });
-  const f = path9.join(dir, `${safeId(ref.harness)}-${safeId(ref.session)}.lock`);
+  const f = path10.join(dir, `${safeId(ref.harness)}-${safeId(ref.session)}.lock`);
   try {
-    if (Date.now() - statSync4(f).mtimeMs > staleMs) unlinkSync3(f);
+    if (Date.now() - statSync5(f).mtimeMs > staleMs) unlinkSync3(f);
     else return null;
   } catch {
   }
@@ -2427,7 +2787,7 @@ function filterEvent(event, tier, pii, opts = {}) {
 
 // src/sinks/file.ts
 import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync6 } from "node:fs";
-import path10 from "node:path";
+import path11 from "node:path";
 var FileSink = class {
   constructor(name, file, tier, pii) {
     this.name = name;
@@ -2441,7 +2801,7 @@ var FileSink = class {
   pii;
   async send(events) {
     try {
-      mkdirSync6(path10.dirname(this.file), { recursive: true });
+      mkdirSync6(path11.dirname(this.file), { recursive: true });
       appendFileSync2(this.file, `${events.map((e) => JSON.stringify(e)).join("\n")}
 `);
       return { ok: true, acknowledged: events.length, accepted: events.length, duplicates: 0, rejected: [] };
@@ -2488,6 +2848,8 @@ export {
   adapterByName,
   antigravity,
   claudeCode,
+  claude_code_control_exports as claudeControl,
+  claudeDirs,
   codex,
   configFile,
   filterEvent,