@scp-dev/cli 0.5.0 → 0.7.0

package/dist/{chunk-XQHPDNVG.js → chunk-277BAY7J.js}

@@ -13,11 +13,11 @@ import {
   psStart,
   relayIdentity,
   sessionKey
-} from "./chunk-AAFHLHXG.js";
+} from "./chunk-3SOIVANO.js";
 
 // src/hooks.ts
 import { Readable } from "stream";
-import { closeSync, fstatSync, openSync, readFileSync, readSync, writeSync } from "fs";
+import { closeSync, fstatSync, openSync, readFileSync, readSync, writeFileSync, writeSync } from "fs";
 import { homedir } from "os";
 import { basename, join } from "path";
 import {
@@ -304,7 +304,9 @@ function titleText(text) {
   return line || void 0;
 }
 function promptTitle(prompt) {
-  return titleText(prompt?.split("\n").find((line) => line.trim()));
+  const first = prompt?.split("\n").find((line) => line.trim());
+  if (first?.startsWith(PREAMBLE) || first?.startsWith(PREAMBLE_BRIEF)) return void 0;
+  return titleText(first);
 }
 function transcriptTitle(path, session) {
   if (!path || !session || !path.startsWith("/") || !path.endsWith(`/${session}.jsonl`)) return void 0;
@@ -409,6 +411,17 @@ function tldrEvery(env) {
   return raw && /^\d{1,6}$/.test(raw) ? Number(raw) : TLDR_EVERY_DEFAULT;
 }
 var NUDGE = `${CLI_NAME} (optional): a title and a one-line now (relay_set_title / relay_set_now) help peers find you; skip it when you only run workers.`;
+var AGY_CONVERSATION = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+function recordAgyConversation(payload, env) {
+  const file = env.SCP_AGY_CONVERSATION_FILE;
+  if (!file || field(payload, "parentConversationId", "parent_conversation_id") !== void 0) return;
+  const id = asString(field(payload, "conversationId", "conversation_id")) ?? env.ANTIGRAVITY_CONVERSATION_ID;
+  if (!id || !AGY_CONVERSATION.test(id)) return;
+  try {
+    writeFileSync(file, id, { flag: "wx", mode: 384 });
+  } catch {
+  }
+}
 async function runHook(args, options) {
   const began = Date.now();
   const blockStop = args.includes(BLOCK_STOP);
@@ -427,6 +440,7 @@ async function runHook(args, options) {
   } catch {
     payload = {};
   }
+  if (harnessArg === "agy") recordAgyConversation(payload, options.env);
   if (Number.isFinite(wakeS) && wakeS > 0) return wakeHook(harnessArg, payload, wakeS, options);
   const event = mapHookPayload(payload, eventArg);
   if (!event || options.env.SCP_TRANSPORT === "cloud") return;
@@ -445,8 +459,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 +572,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,
@@ -1034,6 +1052,8 @@ export {
   TLDR_EVERY_DEFAULT,
   TLDR,
   tldrEvery,
+  AGY_CONVERSATION,
+  recordAgyConversation,
   runHook,
   subagentIntro,
   relayHookCommand,

package/dist/{chunk-AAFHLHXG.js → chunk-3SOIVANO.js}

@@ -67,6 +67,38 @@ function writeShimBinding(claim, env) {
     }
   };
 }
+function museLaunchFile(key, env) {
+  const pid = BINDING_PROCESS.exec(key)?.[1];
+  return pid ? join(relayDir(env), "launch", `muse-${pid}.json`) : void 0;
+}
+function writeMuseLaunch(key, launch, env) {
+  const pid = BINDING_PROCESS.exec(key)?.[1];
+  if (!pid) throw new Error(`muse serve has no process key (${key})`);
+  const path = join(privateDir(join(relayDir(env), "launch")), `muse-${pid}.json`);
+  const text = JSON.stringify({ process: key, ...launch });
+  writeFileSync(path, text, { mode: 384 });
+  chmodSync(path, 384);
+  return () => {
+    try {
+      if (readFileSync(path, "utf8") === text) rmSync(path);
+    } catch {
+    }
+  };
+}
+function readMuseLaunch(key, env) {
+  const path = museLaunchFile(key, env);
+  if (!path) return void 0;
+  try {
+    const launch = JSON.parse(readFileSync(path, "utf8"));
+    if (launch.process !== key) return void 0;
+    return {
+      ...typeof launch.name === "string" && validHandle(launch.name) ? { name: launch.name } : {},
+      ...typeof launch.grant === "string" && launch.grant ? { grant: launch.grant } : {}
+    };
+  } catch {
+    return void 0;
+  }
+}
 function readShimBinding(env, pid, table) {
   const read = (name, expectedPid) => {
     try {
@@ -374,14 +406,23 @@ function hookHarnessPid(env, harness, ppid = process.ppid, parentOf = psParent)
   if (Number.isInteger(pid) && pid > 1) return pid;
   return harnessPid(ppid, parentOf);
 }
+function launcherPid(env, harness = harnessPid, parentOf = psParent) {
+  const pid = Number(env.SCP_HARNESS_PID);
+  if (!Number.isInteger(pid) || pid <= 1) return void 0;
+  return parentOf(harness())?.ppid === pid ? pid : void 0;
+}
+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);
   const harness = GENERIC_HARNESSES.has(resolved) && input.inferHarness?.(pid) || resolved;
   const cwd = isAbsolute(input.cwd) ? input.cwd : resolve(input.cwd);
-  const handle = input.as ?? input.env.SCP_NAME ?? deriveHandle(harness, cwd);
   const harnessProcess = processKey(pid, input.startOf);
+  const launched = harness === "muse" && !input.env.SCP_NAME && !input.env.SCP_GRANT ? readMuseLaunch(harnessProcess, input.env) : void 0;
+  const handle = input.as ?? input.env.SCP_NAME ?? launched?.name ?? deriveHandle(harness, cwd);
+  const grant = input.env.SCP_GRANT || launched?.grant;
   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,
@@ -391,7 +432,8 @@ 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 } : {}
+    ...grant ? { grant } : {},
+    ...harnessSession ? { harness_session: harnessSession } : {}
   };
 }
 
@@ -466,6 +508,7 @@ var OPTIONS = {
   who: { type: "boolean" },
   peek: { type: "string" },
   endpoint: { type: "string" },
+  "take-over": { type: "boolean" },
   live: { type: "boolean" },
   parent: { type: "string" }
 };
@@ -591,7 +634,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-UQJ5YYCC.js");
+    const { machineName, openCloud } = await import("./remote-YO5B2HQI.js");
     const handle2 = named ? localHandle(named) : void 0;
     const claim = handle2 ? {
       handle: handle2,
@@ -849,7 +892,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-6MVD3VLC.js")).login(values);
+  return (await import("./login-DCNCC3RS.js")).login(values);
 }
 function logoutMain(positionals, asJson, env = process.env) {
   if (positionals.length) throw new RelayUsage(`${CLI_NAME3} logout takes no arguments`);
@@ -866,6 +909,7 @@ export {
   detectHarness,
   codexShell,
   writeShimBinding,
+  writeMuseLaunch,
   normalizeHarness,
   hookHarness,
   gitToplevel,
@@ -879,6 +923,7 @@ export {
   psParent,
   harnessPid,
   hookHarnessPid,
+  launcherPid,
   relayIdentity,
   DEFAULT_RELAY,
   configDir,

package/dist/{chunk-2342GTME.js → chunk-LRQP25RI.js}

@@ -10,11 +10,11 @@ import {
   mergeHooks,
   musePlugin,
   opencodePlugin
-} from "./chunk-XQHPDNVG.js";
+} from "./chunk-277BAY7J.js";
 import {
   RelayUsage,
   gitToplevel
-} from "./chunk-AAFHLHXG.js";
+} from "./chunk-3SOIVANO.js";
 
 // src/install.ts
 import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "fs";

package/dist/{chunk-H2XQXMZU.js → chunk-LUDLDWH2.js}

@@ -5,7 +5,7 @@ import {
   configDir,
   relayCredential,
   writePrivateJson
-} from "./chunk-AAFHLHXG.js";
+} from "./chunk-3SOIVANO.js";
 import {
   note,
   printTable

package/dist/{codex-OSGHQMK6.js → chunk-LWMTZH36.js}

@@ -3,18 +3,13 @@ import {
   codexMount,
   codexOverrides,
   toml
-} from "./chunk-7RA7E5WR.js";
-import "./chunk-KN7WEIE4.js";
-import "./chunk-UKQBH4AQ.js";
-import "./chunk-2342GTME.js";
-import "./chunk-XQHPDNVG.js";
-import "./chunk-YYSLYVNZ.js";
+} from "./chunk-RZUQ422C.js";
 import {
   RelayUsage,
   readPsTable,
   relayIdentity,
   startDaemon
-} from "./chunk-AAFHLHXG.js";
+} from "./chunk-3SOIVANO.js";
 import {
   SELF
 } from "./chunk-MNTIEWKF.js";
@@ -611,12 +606,13 @@ ${stderr.toString().trim()}` : ""}`
     rmSync(dir, { recursive: true, force: true });
   }
 }
+
 export {
   CODEX_HELP,
+  codexLaunch,
   CodexSocket,
   CodexWaker,
-  codexCommand,
-  codexLaunch,
+  serverOptions,
   connectCodexChannel,
-  serverOptions
+  codexCommand
 };

package/dist/{chunk-7RA7E5WR.js → chunk-RZUQ422C.js}

@@ -3,10 +3,10 @@ import {
   agySettingsFile,
   mcpFile,
   mountedEntry
-} from "./chunk-UKQBH4AQ.js";
+} from "./chunk-SNW53KT3.js";
 import {
   steerPrompt
-} from "./chunk-XQHPDNVG.js";
+} from "./chunk-277BAY7J.js";
 import {
   OPTIONS,
   RelayUsage,
@@ -18,7 +18,7 @@ import {
   selectorList,
   spawnerKey,
   walkNow
-} from "./chunk-AAFHLHXG.js";
+} from "./chunk-3SOIVANO.js";
 import {
   SELF,
   note
@@ -44,7 +44,7 @@ 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", "SCP_SHIM_BINDING", SPAWN_RUNNER];
+var SPAWNER_IDENTITY = ["SCP_NAME", "SCP_SESSION", "SCP_GRANT", "SCP_PARENT", "SCP_HARNESS", "SCP_SHIM_BINDING", "SCP_HARNESS_PID", 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 = {};
@@ -164,6 +164,10 @@ var PRESETS = {
     allow: MESSAGING.flatMap((tool) => ["--allow", tool])
   }
 };
+function messagingAllow(harness, args) {
+  const preset = PRESETS[harness];
+  return preset && !hasFlag(args, preset.own) ? preset.allow : [];
+}
 var MUSE_VALUED = /* @__PURE__ */ new Set([
   "--agents",
   "--provider",
@@ -477,7 +481,7 @@ function workerName(command, random = nameSuffix) {
   const harness = (program === void 0 ? "" : basename(program)).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[^a-z0-9]+|[^a-z0-9]+$/g, "").slice(0, 57);
   return `${harness || "worker"}-${random()}`;
 }
-function agyNote(command, env) {
+function agyNote(command, env, verb = "spawn") {
   const at = programAt(command);
   const args = command.slice(at + 1);
   if (command[at] === void 0 || basename(command[at]) !== "agy" || !hasFlag(args, ["-p", "--print", "--prompt"]) || hasFlag(args, ["--dangerously-skip-permissions"]))
@@ -488,7 +492,7 @@ function agyNote(command, env) {
   } catch {
   }
   if (Array.isArray(allow) && agyRules().every((rule) => allow.includes(rule))) return null;
-  return `${CLI_NAME} spawn: headless agy denies the relay tools without the permission rules ${CLI_NAME} setup writes to ${agySettingsFile(env)}; run ${CLI_NAME} setup`;
+  return `${CLI_NAME} ${verb}: headless agy denies the relay tools without the permission rules ${CLI_NAME} setup writes to ${agySettingsFile(env)}; run ${CLI_NAME} setup`;
 }
 var FORWARDED = ["SIGINT", "SIGQUIT", "SIGTERM", "SIGHUP"];
 var TAIL_BYTES = 16 * 1024;
@@ -924,6 +928,10 @@ export {
   codexOverrideAt,
   programAt,
   MESSAGING,
+  messagingAllow,
+  MUSE_MODE,
+  MUSE_MODES_ALLOWED,
+  museModes,
   contributorRefusal,
   codexSkipsGitCheck,
   closedStdin,

package/dist/{chunk-UKQBH4AQ.js → chunk-SNW53KT3.js}

@@ -1,6 +1,6 @@
 import {
   hooksTarget
-} from "./chunk-2342GTME.js";
+} from "./chunk-LRQP25RI.js";
 import {
   AGY_HOOK_SET,
   BLOCK_STOP,
@@ -12,12 +12,12 @@ import {
   mergeHooks,
   musePlugin,
   opencodePlugin
-} from "./chunk-XQHPDNVG.js";
+} from "./chunk-277BAY7J.js";
 import {
   RelayUsage,
   gitToplevel,
   setJoinMode
-} from "./chunk-AAFHLHXG.js";
+} from "./chunk-3SOIVANO.js";
 
 // src/setup.ts
 import { spawnSync } from "child_process";

package/dist/claude-WEHOLJ26.js

@@ -0,0 +1,290 @@
+import {
+  entryArgv,
+  mcpFile,
+  mountedEntry,
+  whichOnPath
+} from "./chunk-SNW53KT3.js";
+import "./chunk-LRQP25RI.js";
+import "./chunk-277BAY7J.js";
+import "./chunk-YYSLYVNZ.js";
+import {
+  CHANNELS_ENV,
+  RelayUsage,
+  deriveHandle,
+  joinMode
+} from "./chunk-3SOIVANO.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-CDLW3MV5.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-F2NFQ2KC.js");
+  const { run } = await import("./main-CDLW3MV5.js");
   await run(process.argv.slice(2));
 }

package/dist/codex-54UWPDY5.js

@@ -0,0 +1,26 @@
+import {
+  CODEX_HELP,
+  CodexSocket,
+  CodexWaker,
+  codexCommand,
+  codexLaunch,
+  connectCodexChannel,
+  serverOptions
+} from "./chunk-LWMTZH36.js";
+import "./chunk-RZUQ422C.js";
+import "./chunk-KN7WEIE4.js";
+import "./chunk-SNW53KT3.js";
+import "./chunk-LRQP25RI.js";
+import "./chunk-277BAY7J.js";
+import "./chunk-YYSLYVNZ.js";
+import "./chunk-3SOIVANO.js";
+import "./chunk-MNTIEWKF.js";
+export {
+  CODEX_HELP,
+  CodexSocket,
+  CodexWaker,
+  codexCommand,
+  codexLaunch,
+  connectCodexChannel,
+  serverOptions
+};