@scp-dev/cli 0.4.0 → 0.6.0

package/dist/{chunk-2LIJXXTL.js → chunk-BSX24XMZ.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-MNTIEWKF.js";
 
 // src/relay.ts
-import { chmodSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "fs";
+import { chmodSync as chmodSync2, mkdirSync, readFileSync as readFileSync2, renameSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { join as join3, dirname as dirname2 } from "path";
 import { randomUUID } from "crypto";
 import { CLI_NAME as CLI_NAME3 } from "@scp-dev/core";
@@ -16,13 +16,13 @@ import { spawn } from "child_process";
 import { closeSync, openSync, statSync, truncateSync } from "fs";
 import { join as join2 } from "path";
 import { CLI_NAME as CLI_NAME2 } from "@scp-dev/core";
-import { connectBroker, privateDir, relayDir as relayDir2 } from "@scp-dev/broker";
+import { connectBroker, privateDir as privateDir2, relayDir as relayDir3 } from "@scp-dev/broker";
 
 // src/identity.ts
-import { existsSync, realpathSync } from "fs";
+import { chmodSync, existsSync, readFileSync, realpathSync, rmSync, writeFileSync } from "fs";
 import { tmpdir } from "os";
 import { basename, dirname, isAbsolute, join, resolve } from "path";
-import { shortHostname } from "@scp-dev/broker";
+import { privateDir, relayDir, shortHostname } from "@scp-dev/broker";
 import { GENERIC_HARNESSES, LIMITS, validHandle, validHarness } from "@scp-dev/core";
 var SHORT = { "claude-code": "claude" };
 var SHELLS = /* @__PURE__ */ new Set(["sh", "bash", "zsh", "dash", "fish"]);
@@ -34,6 +34,61 @@ function detectHarness(env) {
   if (env.ANTIGRAVITY_AGENT === "1" || env.ANTIGRAVITY_CONVERSATION_ID) return "agy";
   if (env.CLAUDECODE === "1") return "claude-code";
   if (env.CODEX_THREAD_ID) return "codex";
+  if (inferring(env) && (env.CODEX_SANDBOX || env.CODEX_SANDBOX_NETWORK_DISABLED)) return "codex";
+  return void 0;
+}
+var BINDING_KEY = /^[0-9a-f]{1,128}$/;
+var BINDING_PROCESS = /^pid:([1-9][0-9]*):[A-Za-z0-9:-]{1,64}$/;
+function codexShell(env) {
+  return env.SCP_HARNESS === "codex" || inferring(env) && detectHarness(env) === "codex";
+}
+function writeShimBinding(claim, env) {
+  const pid = BINDING_PROCESS.exec(claim.process)?.[1];
+  if (claim.harness !== "codex" || !pid) return () => {
+  };
+  const text = JSON.stringify({ process: claim.process, handle: claim.handle, harness: claim.harness });
+  const names = [`pid-${pid}`, ...BINDING_KEY.test(env.SCP_SHIM_BINDING ?? "") ? [`key-${env.SCP_SHIM_BINDING}`] : []];
+  const paths = [];
+  for (const name of names) {
+    try {
+      const path = join(privateDir(join(relayDir(env), "bindings")), `${name}.json`);
+      writeFileSync(path, text, { mode: 384 });
+      chmodSync(path, 384);
+      paths.push(path);
+    } catch {
+    }
+  }
+  return () => {
+    for (const path of paths) {
+      try {
+        if (readFileSync(path, "utf8") === text) rmSync(path);
+      } catch {
+      }
+    }
+  };
+}
+function readShimBinding(env, pid, table) {
+  const read = (name, expectedPid) => {
+    try {
+      const binding = JSON.parse(readFileSync(join(relayDir(env), "bindings", `${name}.json`), "utf8"));
+      const match = typeof binding.process === "string" ? BINDING_PROCESS.exec(binding.process) : null;
+      if (match && Number(match[1]) > 1 && (expectedPid === void 0 || Number(match[1]) === expectedPid) && binding.harness === "codex" && typeof binding.handle === "string" && validHandle(binding.handle))
+        return binding;
+    } catch {
+    }
+    return void 0;
+  };
+  if (BINDING_KEY.test(env.SCP_SHIM_BINDING ?? "")) {
+    const binding = read(`key-${env.SCP_SHIM_BINDING}`);
+    if (binding) return binding;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  while (pid > 1 && !seen.has(pid)) {
+    seen.add(pid);
+    const entry = table?.get(pid);
+    if (!entry) return read(`pid-${pid}`, pid);
+    pid = entry.ppid;
+  }
   return void 0;
 }
 function normalizeHarness(raw, fallback) {
@@ -319,6 +374,7 @@ function hookHarnessPid(env, harness, ppid = process.ppid, parentOf = psParent)
   if (Number.isInteger(pid) && pid > 1) return pid;
   return harnessPid(ppid, parentOf);
 }
+var HARNESS_SESSION = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
 function relayIdentity(input) {
   const resolved = resolveHarness(input.harness, input.env, input.fallbackHarness);
   const pid = input.harnessPid(resolved);
@@ -327,6 +383,7 @@ function relayIdentity(input) {
   const handle = input.as ?? input.env.SCP_NAME ?? deriveHandle(harness, cwd);
   const harnessProcess = processKey(pid, input.startOf);
   const keys = input.lineageOf ? input.lineageOf(pid) : lineage(pid);
+  const harnessSession = harness === "claude-code" ? [input.harnessSession, input.env.CLAUDE_CODE_SESSION_ID].find((id) => id !== void 0 && HARNESS_SESSION.test(id)) : void 0;
   return {
     handle,
     harness,
@@ -336,15 +393,16 @@ function relayIdentity(input) {
     labels: labelsFor(input.env),
     ...input.env.SCP_PARENT ? { parent: input.env.SCP_PARENT } : {},
     ...keys.length ? { lineage: keys } : {},
-    ...input.env.SCP_GRANT ? { grant: input.env.SCP_GRANT } : {}
+    ...input.env.SCP_GRANT ? { grant: input.env.SCP_GRANT } : {},
+    ...harnessSession ? { harness_session: harnessSession } : {}
   };
 }
 
 // src/session.ts
 import { CLI_NAME } from "@scp-dev/core";
-import { readSessionMarker, relayDir } from "@scp-dev/broker";
+import { readSessionMarker, relayDir as relayDir2 } from "@scp-dev/broker";
 function membership(env, session) {
-  const marker = readSessionMarker(relayDir(env), session);
+  const marker = readSessionMarker(relayDir2(env), session);
   if (marker?.joined === false) return { dark: `this session left the relay; ${CLI_NAME} join (or relay_join) joins it again` };
   if (!marker?.joined && joinMode(env) === "manual") return { dark: `this session has not joined the relay; ${CLI_NAME} join <name> (or relay_join) joins it` };
   return marker?.handle ? { handle: marker.handle } : {};
@@ -411,6 +469,7 @@ var OPTIONS = {
   who: { type: "boolean" },
   peek: { type: "string" },
   endpoint: { type: "string" },
+  "take-over": { type: "boolean" },
   live: { type: "boolean" },
   parent: { type: "string" }
 };
@@ -471,7 +530,7 @@ var DAEMON_ENV = [
 ];
 var LOG_MAX_BYTES = 1024 * 1024;
 function startDaemon(dir) {
-  privateDir(dir);
+  privateDir2(dir);
   const logFile = join2(dir, "broker.log");
   if ((statSync(logFile, { throwIfNoEntry: false })?.size ?? 0) > LOG_MAX_BYTES) truncateSync(logFile, 0);
   const log = openSync(logFile, "a", 384);
@@ -499,11 +558,18 @@ function localHandle(raw) {
   if (handle.includes("/")) throw new RelayUsage(`--as names a local handle, not ${JSON.stringify(raw)}`);
   return handle;
 }
-function walkNow() {
-  const table = readPsTable();
-  const self = harnessLineage(process.ppid, table);
+function walkNow(env = process.env, pid = process.ppid, table = readPsTable()) {
+  const keys = lineage(pid, table);
+  const self = harnessLineage(pid, table);
+  if (!self.length && codexShell(env)) {
+    const binding = readShimBinding(env, pid, table);
+    if (binding) {
+      const bound = [...keys, binding.process];
+      return { keys: bound, self: bound, harness: "codex" };
+    }
+  }
   const harness = self.length ? harnessAt(Number(/^pid:(\d+)/.exec(self.at(-1))?.[1]), table) : void 0;
-  return { keys: lineage(process.ppid, table), self, ...harness ? { harness } : {} };
+  return { keys, self, ...harness ? { harness } : {} };
 }
 function claimHarness(values, env, walk) {
   return values.harness ?? env.SCP_HARNESS ?? (inferring(env) ? walk?.harness ?? detectHarness(env) : void 0) ?? "cli";
@@ -529,7 +595,7 @@ async function open(verb, values, cwd, bodyFromStdin, walk) {
         `${CLI_NAME2} ${verb} needs an identity: --as HANDLE (or $SCP_NAME) for an agent, or --human for your own inbox me/ (no terminal is attached, so me/ is not assumed)`
       );
     }
-    const { machineName, openCloud } = await import("./remote-P4GFUIAP.js");
+    const { machineName, openCloud } = await import("./remote-3R4GRDGI.js");
     const handle2 = named ? localHandle(named) : void 0;
     const claim = handle2 ? {
       handle: handle2,
@@ -558,7 +624,7 @@ async function open(verb, values, cwd, bodyFromStdin, walk) {
   const handle = "handle" in joined && joined.handle ? joined.handle : named ? localHandle(named) : void 0;
   const harnessPid2 = self.length ? Number(/^pid:(\d+)/.exec(self.at(-1))?.[1]) : void 0;
   const lineageClaim = keys.length ? { lineage: keys } : {};
-  const dir = relayDir2();
+  const dir = relayDir3();
   const client = await connectBroker(dir, () => startDaemon(dir));
   try {
     let bound;
@@ -688,7 +754,7 @@ function checkRelayUrl(text, what = "relay URL") {
 function readObject(path) {
   let text;
   try {
-    text = readFileSync(path, "utf8");
+    text = readFileSync2(path, "utf8");
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
     throw new RelayUsage(`could not read ${path}`);
@@ -704,15 +770,15 @@ function readObject(path) {
 function writePrivateJson(path, value) {
   const dir = dirname2(path);
   mkdirSync(dir, { recursive: true, mode: 448 });
-  chmodSync(dir, 448);
+  chmodSync2(dir, 448);
   const temp = join3(dir, `.${randomUUID()}.tmp`);
   try {
-    writeFileSync(temp, `${JSON.stringify(value, null, 2)}
+    writeFileSync2(temp, `${JSON.stringify(value, null, 2)}
 `, { mode: 384, flag: "wx" });
-    chmodSync(temp, 384);
+    chmodSync2(temp, 384);
     renameSync(temp, path);
   } finally {
-    rmSync(temp, { force: true });
+    rmSync2(temp, { force: true });
   }
 }
 function activeRelay(env = process.env) {
@@ -787,7 +853,7 @@ function relayVerb(positionals, asJson, env = process.env) {
 }
 async function loginMain(positionals, values) {
   if (positionals.length) throw new RelayUsage(`${CLI_NAME3} login takes only flags`);
-  return (await import("./login-AUMLI4FS.js")).login(values);
+  return (await import("./login-4IF26HH5.js")).login(values);
 }
 function logoutMain(positionals, asJson, env = process.env) {
   if (positionals.length) throw new RelayUsage(`${CLI_NAME3} logout takes no arguments`);
@@ -802,6 +868,8 @@ function logoutMain(positionals, asJson, env = process.env) {
 export {
   shortHostname,
   detectHarness,
+  codexShell,
+  writeShimBinding,
   normalizeHarness,
   hookHarness,
   gitToplevel,
@@ -835,6 +903,7 @@ export {
   OPTIONS,
   SPAWN_OPTIONS,
   startDaemon,
+  terminalAttached,
   localHandle,
   walkNow,
   open,

package/dist/{chunk-VQU5CPE4.js → chunk-C5PYVRJE.js}

@@ -10,11 +10,11 @@ import {
   mergeHooks,
   musePlugin,
   opencodePlugin
-} from "./chunk-B2G3XTW7.js";
+} from "./chunk-GG33NSBW.js";
 import {
   RelayUsage,
   gitToplevel
-} from "./chunk-2LIJXXTL.js";
+} from "./chunk-BSX24XMZ.js";
 
 // src/install.ts
 import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "fs";

package/dist/{chunk-IEFXYBX7.js → chunk-C7ZUACP7.js}

@@ -5,7 +5,7 @@ import {
   configDir,
   relayCredential,
   writePrivateJson
-} from "./chunk-2LIJXXTL.js";
+} from "./chunk-BSX24XMZ.js";
 import {
   note,
   printTable

package/dist/{chunk-HHVNSHGB.js → chunk-CVW3INZO.js}

@@ -3,10 +3,10 @@ import {
   agySettingsFile,
   mcpFile,
   mountedEntry
-} from "./chunk-VW7DYSGM.js";
+} from "./chunk-DEK3TE6T.js";
 import {
   steerPrompt
-} from "./chunk-B2G3XTW7.js";
+} from "./chunk-GG33NSBW.js";
 import {
   OPTIONS,
   RelayUsage,
@@ -18,7 +18,7 @@ import {
   selectorList,
   spawnerKey,
   walkNow
-} from "./chunk-2LIJXXTL.js";
+} from "./chunk-BSX24XMZ.js";
 import {
   SELF,
   note
@@ -44,8 +44,8 @@ import {
 } from "@scp-dev/core";
 var SERVER = "scp";
 var SPAWN_RUNNER = "SCP_SPAWN_RUNNER";
-var SPAWNER_IDENTITY = ["SCP_NAME", "SCP_SESSION", "SCP_GRANT", "SCP_PARENT", "SCP_HARNESS", SPAWN_RUNNER];
-var SHIM_ENV = ["SCP_GRANT", "SCP_NAME", "SCP_LABELS", "SCP_DIR", "XDG_STATE_HOME"];
+var SPAWNER_IDENTITY = ["SCP_NAME", "SCP_SESSION", "SCP_GRANT", "SCP_PARENT", "SCP_HARNESS", "SCP_SHIM_BINDING", SPAWN_RUNNER];
+var SHIM_ENV = ["SCP_GRANT", "SCP_NAME", "SCP_LABELS", "SCP_DIR", "XDG_STATE_HOME", "SCP_SHIM_BINDING"];
 function spawnEnvironment(parent, grant, labels) {
   const env = {};
   for (const [key, value] of Object.entries(parent)) if (value !== void 0 && !SPAWNER_IDENTITY.includes(key)) env[key] = value;

package/dist/{chunk-VW7DYSGM.js → chunk-DEK3TE6T.js}

@@ -1,6 +1,6 @@
 import {
   hooksTarget
-} from "./chunk-VQU5CPE4.js";
+} from "./chunk-C5PYVRJE.js";
 import {
   AGY_HOOK_SET,
   BLOCK_STOP,
@@ -12,12 +12,12 @@ import {
   mergeHooks,
   musePlugin,
   opencodePlugin
-} from "./chunk-B2G3XTW7.js";
+} from "./chunk-GG33NSBW.js";
 import {
   RelayUsage,
   gitToplevel,
   setJoinMode
-} from "./chunk-2LIJXXTL.js";
+} from "./chunk-BSX24XMZ.js";
 
 // src/setup.ts
 import { spawnSync } from "child_process";

package/dist/{chunk-B2G3XTW7.js → chunk-GG33NSBW.js}

@@ -13,7 +13,7 @@ import {
   psStart,
   relayIdentity,
   sessionKey
-} from "./chunk-2LIJXXTL.js";
+} from "./chunk-BSX24XMZ.js";
 
 // src/hooks.ts
 import { Readable } from "stream";
@@ -445,8 +445,10 @@ async function runHook(args, options) {
     )
   );
   if ("dark" in joined) return;
+  const harnessSession = event.agent ? void 0 : asString(field(payload, "session_id", "sessionId"));
   const claim = relayIdentity({
     ...joined.handle ? { as: joined.handle } : {},
+    ...harnessSession ? { harnessSession } : {},
     harness,
     fallbackHarness: "hook",
     cwd: event.cwd ?? options.cwd,
@@ -556,8 +558,10 @@ async function wakeHook(harnessArg, payload, waitS, options) {
     )
   );
   if ("dark" in joined) return;
+  const harnessSession = asString(field(payload, "session_id", "sessionId"));
   const claim = relayIdentity({
     ...joined.handle ? { as: joined.handle } : {},
+    ...harnessSession ? { harnessSession } : {},
     harness,
     fallbackHarness: "hook",
     cwd: asString(payload.cwd) ?? options.cwd,

package/dist/claude-NCPNZLIX.js

@@ -0,0 +1,290 @@
+import {
+  entryArgv,
+  mcpFile,
+  mountedEntry,
+  whichOnPath
+} from "./chunk-DEK3TE6T.js";
+import "./chunk-C5PYVRJE.js";
+import "./chunk-GG33NSBW.js";
+import "./chunk-YYSLYVNZ.js";
+import {
+  CHANNELS_ENV,
+  RelayUsage,
+  deriveHandle,
+  joinMode
+} from "./chunk-BSX24XMZ.js";
+import {
+  SELF
+} from "./chunk-MNTIEWKF.js";
+
+// src/claude.ts
+import { spawn, spawnSync } from "child_process";
+import { randomBytes } from "crypto";
+import { existsSync, readFileSync, symlinkSync, unlinkSync, writeFileSync } from "fs";
+import { basename, join } from "path";
+import { privateDir, relayDir } from "@scp-dev/broker";
+import { CLI_NAME, validHandle } from "@scp-dev/core";
+var CHANNEL_FLAGS = ["--dangerously-load-development-channels", "server:scp"];
+function claudeArgv(argv) {
+  let name;
+  let bg = false;
+  let i = 0;
+  for (; ; ) {
+    const arg = argv[i];
+    if (arg === "--bg" || arg === "--background") {
+      bg = true;
+      i++;
+    } else if (arg === "--name" || arg === "--as") {
+      if (argv[i + 1] === void 0) throw new RelayUsage(`${CLI_NAME} claude ${arg} takes a handle`);
+      name = argv[i + 1];
+      i += 2;
+    } else if (arg?.startsWith("--name=") || arg?.startsWith("--as=")) {
+      name = arg.slice(arg.indexOf("=") + 1);
+      i++;
+    } else break;
+  }
+  if (argv[i] === "--") i++;
+  name = name?.replace(/^me\//, "");
+  if (name !== void 0 && !validHandle(name)) throw new RelayUsage(`--name ${JSON.stringify(name)} is not a valid agent handle`);
+  const args = argv.slice(i);
+  if (!bg) bg = optionsOf(args).some((arg) => arg === "--bg" || arg === "--background");
+  return { ...name !== void 0 ? { name } : {}, ...bg ? { bg: true } : {}, args };
+}
+var optionsOf = (args) => args.includes("--") ? args.slice(0, args.indexOf("--")) : args;
+function beforeDashes(args, added) {
+  const at = optionsOf(args).length;
+  return [...args.slice(0, at), ...added, ...args.slice(at)];
+}
+function claudeLaunchArgs(args, added) {
+  const channels = optionsOf(args).some((arg) => arg === "server:scp" || arg === `${CHANNEL_FLAGS[0]}=server:scp`) ? [] : CHANNEL_FLAGS;
+  return beforeDashes(args, [...channels, ...added]);
+}
+var LAUNCHER_IDENTITY = ["SCP_NAME", "SCP_GRANT", "SCP_SESSION", "SCP_PARENT", "SCP_HARNESS", "SCP_SHIM_BINDING", "SCP_SPAWN_RUNNER", CHANNELS_ENV];
+var SHIM_VARS = ["SCP_LABELS", "SCP_DIR", "XDG_STATE_HOME"];
+var bgDir = (env) => join(relayDir(env), "claude-bg");
+function bgMount(env, name) {
+  let entry;
+  try {
+    entry = mountedEntry("claude", mcpFile("claude", env));
+  } catch {
+  }
+  const mounted = entry ? entryArgv("claude", entry) : [];
+  const argv = mounted.includes("--channels") ? mounted : [...SELF, "mcp", "--harness", "claude", "--channels"];
+  const base = entry?.env && typeof entry.env === "object" ? entry.env : {};
+  const vars = Object.fromEntries(SHIM_VARS.flatMap((key) => env[key] ? [[key, env[key]]] : []));
+  return {
+    type: "stdio",
+    command: argv[0],
+    args: argv.slice(1),
+    env: { ...base, ...vars, ...name !== void 0 ? { SCP_NAME: name } : {}, SCP_GRANT: env.SCP_GRANT ?? "" }
+  };
+}
+var STRICT_HINT = `${CLI_NAME} claude: --strict-mcp-config without --mcp-config drops the scp mount, so messages cannot wake this session`;
+function externalMcp(args) {
+  return args.some((arg) => arg === "--mcp-config" || arg.startsWith("--mcp-config="));
+}
+function namePrompt(name, args, env, cwd) {
+  if (name !== void 0 || joinMode(env) === "manual" || args.some((arg) => /^--(append-)?system-prompt/.test(arg))) return [];
+  const handle = env.SCP_NAME || deriveHandle("claude-code", cwd);
+  return [
+    "--append-system-prompt",
+    `You are on the SCP network as ${handle}. Pick a short descriptive name for yourself with \`${CLI_NAME} name <name>\` when you know what you're working on.`
+  ];
+}
+function mountHint(env, cwd = process.cwd()) {
+  const file = mcpFile("claude", env);
+  const entries = [];
+  try {
+    const user = mountedEntry("claude", file);
+    if (user) entries.push(user);
+    const config = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")) : {};
+    const local = config.projects?.[cwd]?.mcpServers?.scp;
+    if (local && typeof local === "object") entries.push(local);
+  } catch {
+    return `${CLI_NAME} claude: ${file} is unreadable, so the scp mount is unchecked; fix it or run ${CLI_NAME} setup --write`;
+  }
+  const project = join(cwd, ".mcp.json");
+  try {
+    const entry = existsSync(project) ? mountedEntry("claude", project) : void 0;
+    if (entry) entries.push(entry);
+  } catch {
+  }
+  if (!entries.length) return `${CLI_NAME} claude: Claude Code has no scp MCP mount, so messages cannot wake this session; run ${CLI_NAME} setup --write`;
+  if (!entries.some((entry) => entryArgv("claude", entry).includes("--channels")))
+    return `${CLI_NAME} claude: the scp mount lacks --channels, so messages cannot wake this session; run ${CLI_NAME} setup --write`;
+  return void 0;
+}
+var SHORT_ID = /^[0-9a-f]{8}$/;
+var BACKGROUNDED = /backgrounded\s*\S\s*([0-9a-f]{8})/;
+function liveAgents(bin, env) {
+  const run = spawnSync(bin, ["agents", "--json"], { env, encoding: "utf8", timeout: 15e3 });
+  try {
+    const listed = JSON.parse(run.stdout);
+    return Array.isArray(listed) ? listed.filter((agent) => typeof agent?.id === "string" && agent.state !== "failed") : [];
+  } catch {
+    return [];
+  }
+}
+function resumeTarget(args) {
+  const options = optionsOf(args);
+  for (const [i, arg] of options.entries()) {
+    if (arg.startsWith("--resume=")) return arg.slice("--resume=".length);
+    if ((arg === "--resume" || arg === "-r") && options[i + 1] && !options[i + 1].startsWith("-")) return options[i + 1];
+  }
+  return void 0;
+}
+async function runClaude(bin, args, env, cwd, stdout = "inherit", onOut) {
+  const child = spawn(bin, args, { cwd, stdio: ["inherit", stdout, "inherit"], env });
+  child.stdout?.on("data", (chunk) => {
+    process.stdout.write(chunk);
+    onOut?.(chunk.toString("utf8"));
+  });
+  const forward = (signal) => () => void child.kill(signal);
+  const handlers = ["SIGTERM", "SIGHUP"].map((signal) => [signal, forward(signal)]);
+  const ignore = () => {
+  };
+  process.on("SIGINT", ignore);
+  for (const [signal, handler] of handlers) process.on(signal, handler);
+  try {
+    return await new Promise((resolve, reject) => {
+      child.once("error", reject);
+      child.once("close", (code, signal) => resolve(code ?? (signal ? 128 + (signalNumber(signal) ?? 1) : 1)));
+    });
+  } finally {
+    process.off("SIGINT", ignore);
+    for (const [signal, handler] of handlers) process.off(signal, handler);
+  }
+}
+async function backgroundCommand(name, args, env, cwd, bin, out) {
+  const handle = name ?? (env.SCP_NAME || void 0);
+  const dir = privateDir(bgDir(env));
+  const file = join(dir, `${randomBytes(8).toString("hex")}.json`);
+  writeFileSync(file, `${JSON.stringify({ mcpServers: { scp: bgMount(env, handle) } }, null, 2)}
+`, { mode: 384 });
+  const options = optionsOf(args);
+  const added = [
+    ...options.includes("--bg") || options.includes("--background") ? [] : ["--bg"],
+    ...handle !== void 0 && !options.some((arg) => arg === "-n" || arg === "--name" || arg.startsWith("--name=")) ? ["--name", handle] : [],
+    ...namePrompt(handle, args, env, cwd),
+    "--mcp-config",
+    file
+  ];
+  const clean = Object.fromEntries(Object.entries(env).filter(([key]) => !LAUNCHER_IDENTITY.includes(key)));
+  let printed = "";
+  const code = await runClaude(bin, beforeDashes(args, added), clean, cwd, "pipe", (text) => {
+    printed += text;
+  });
+  const id = BACKGROUNDED.exec(printed)?.[1];
+  if (!id) {
+    unlinkSync(file);
+    return code || 1;
+  }
+  try {
+    unlinkSync(join(dir, `${id}.json`));
+  } catch {
+  }
+  symlinkSync(basename(file), join(dir, `${id}.json`));
+  const address = `me/${handle ?? deriveHandle("claude-code", cwd)}`;
+  out(`${CLI_NAME} claude: background session ${id} is ${address} on SCP; messages wake it through its inbox. ${CLI_NAME} claude attach ${id} opens it`);
+  return code;
+}
+async function attachCommand(argv, env, err, cwd, bin, deps) {
+  let target;
+  let rename;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--name" || arg === "--as") {
+      rename = argv[++i];
+      if (rename === void 0) throw new RelayUsage(`${CLI_NAME} claude attach ${arg} takes a handle`);
+    } else if (arg.startsWith("--name=") || arg.startsWith("--as=")) rename = arg.slice(arg.indexOf("=") + 1);
+    else if (target === void 0) target = arg;
+    else throw new RelayUsage(`${CLI_NAME} claude attach takes one session: <id|name> [--name N]`);
+  }
+  if (target === void 0) throw new RelayUsage(`${CLI_NAME} claude attach takes a background session: <id|name> [--name N]`);
+  rename = rename?.replace(/^me\//, "");
+  if (rename !== void 0) {
+    if (!validHandle(rename)) throw new RelayUsage(`--name ${JSON.stringify(rename)} is not a valid agent handle`);
+    await renameBackground(target, rename, env, err, bin, deps);
+  }
+  return runClaude(bin, ["attach", target], env, cwd);
+}
+async function renameBackground(target, to, env, err, bin, deps) {
+  const agent = SHORT_ID.test(target) ? void 0 : liveAgents(bin, env).find((a) => a.name === target || a.sessionId === target);
+  const id = SHORT_ID.test(target) ? target : agent?.id;
+  const link = id ? join(bgDir(env), `${id}.json`) : void 0;
+  let config;
+  try {
+    config = link ? JSON.parse(readFileSync(link, "utf8")) : void 0;
+  } catch {
+  }
+  const from = config?.mcpServers?.scp?.env?.SCP_NAME ?? (SHORT_ID.test(target) ? void 0 : target);
+  if (!link || !config?.mcpServers?.scp?.env || from === void 0) {
+    err(`${CLI_NAME} claude: ${target} was not started by ${CLI_NAME} claude --bg --name, so its name is unknown; run ${CLI_NAME} name ${to} in it`);
+    return;
+  }
+  if (from === to) return;
+  const code = await (deps.rename ?? renameEndpoint)(from, to);
+  if (code !== 0) {
+    err(`${CLI_NAME} claude: me/${from} keeps its name`);
+    return;
+  }
+  config.mcpServers.scp.env.SCP_NAME = to;
+  writeFileSync(link, `${JSON.stringify(config, null, 2)}
+`, { mode: 384 });
+}
+async function renameEndpoint(from, to) {
+  return (await import("./main-RA3MP25N.js")).relayMain(["name", "--endpoint", `me/${from}`, to]);
+}
+async function claudeCommand(argv, env = process.env, err = (line) => void process.stderr.write(`${line}
+`), cwd = process.cwd(), deps = {}) {
+  if (argv[0] === "--help" || argv[0] === "-h") {
+    process.stdout.write(CLAUDE_HELP);
+    return 0;
+  }
+  const out = deps.out ?? ((line) => void process.stdout.write(`${line}
+`));
+  const bin = whichOnPath("claude", env);
+  if (argv[0] === "attach") {
+    if (!bin) throw new RelayUsage("claude is not on PATH");
+    return attachCommand(argv.slice(1), env, err, cwd, bin, deps);
+  }
+  const { name, bg, args } = claudeArgv(argv);
+  if (!bin) throw new RelayUsage("claude is not on PATH");
+  if (bg) return backgroundCommand(name, args, env, cwd, bin, out);
+  const resume = resumeTarget(args);
+  const live = resume === void 0 ? void 0 : liveAgents(bin, env).find((agent) => agent.id === resume || agent.sessionId === resume);
+  if (live) {
+    err(`${CLI_NAME} claude: ${resume} is a live background session, already woken through claude-inbox; attaching to it (claude attach ${live.id})`);
+    return runClaude(bin, ["attach", live.id], env, cwd);
+  }
+  const external = externalMcp(args);
+  const hint = external ? void 0 : args.includes("--strict-mcp-config") ? STRICT_HINT : mountHint(env, cwd);
+  if (hint) throw new RelayUsage(hint);
+  if (external) err(`${CLI_NAME} claude: using your --mcp-config; it needs the scp server with --channels for messages to wake this session`);
+  return runClaude(
+    bin,
+    claudeLaunchArgs(args, namePrompt(name, args, env, cwd)),
+    { ...env, ...name !== void 0 ? { SCP_NAME: name } : {}, [CHANNELS_ENV]: String(process.pid) },
+    cwd
+  );
+}
+var CLAUDE_HELP = `${CLI_NAME} claude [--name N | --as N] [--] [claude args...]   start Claude Code with the scp channel loaded, so peer messages wake it
+${CLI_NAME} claude --bg [--name N] [--] [claude args...]   start it in the background (claude --bg) with an scp mount that claims N and
+                                                 $SCP_GRANT, so env $(${CLI_NAME} spawn-env --name N) links it under you; messages wake it
+                                                 through its inbox. Prints its short id and address
+${CLI_NAME} claude attach <id|name> [--name N]    claude attach, renaming its endpoint to N first
+  --resume <id> of a live background session attaches to it: it is already woken through claude-inbox
+`;
+var SIGNALS = { SIGHUP: 1, SIGINT: 2, SIGKILL: 9, SIGTERM: 15 };
+var signalNumber = (signal) => SIGNALS[signal];
+export {
+  CHANNEL_FLAGS,
+  bgDir,
+  bgMount,
+  claudeArgv,
+  claudeCommand,
+  claudeLaunchArgs,
+  mountHint,
+  namePrompt,
+  resumeTarget
+};

package/dist/cli.js

@@ -17,6 +17,6 @@ function quietSqliteWarning() {
 // src/cli.ts
 if (!await subagentFastPath(process.argv.slice(2))) {
   quietSqliteWarning();
-  const { run } = await import("./main-STUKDZ5L.js");
+  const { run } = await import("./main-RA3MP25N.js");
   await run(process.argv.slice(2));
 }