@mclawnet/agent 0.6.34 → 0.6.35

package/cli.js

@@ -39,13 +39,39 @@ function printNeedsInit() {
 // === init ===
 program
   .command("init")
-  .description("Initialize ~/.clawnet/settings.json (token + name)")
+  .description("Initialize ~/.clawnet/settings.json (token + name) and check CLI dependencies")
   .option("--token <token>", "Agent token (skip interactive prompt)")
   .option("--name <name>", "Agent name (skip interactive prompt)")
   .option("--hub-url <url>", "Hub WebSocket URL (defaults to wss://mclaw.work/ws/agent)")
+  .option("--skip-deps", "Skip CLI dependency check / install / config patching")
+  .option("--yes", "Non-interactive: accept all install prompts")
   .action(async (opts) => {
     const { saveConfig, loadConfig } = await import("./dist/index.js");
 
+    if (!opts.skipDeps) {
+      const { bootstrapDeps } = await import("./dist/bootstrap-deps.js");
+      const isTty = process.stdin.isTTY === true && process.stdout.isTTY === true;
+      const interactive = isTty && !opts.yes;
+      try {
+        const report = await bootstrapDeps({
+          homeDir: (await import("os")).homedir(),
+          interactive,
+          install: true,
+          promptFn: prompt,
+        });
+        if (report.present.length) console.log(`  ✓ CLIs present: ${report.present.join(", ")}`);
+        if (report.installed.length) console.log(`  ✓ Installed: ${report.installed.join(", ")}`);
+        if (report.missing.filter((m) => !report.installed.includes(m)).length)
+          console.log(`  ⚠ Still missing: ${report.missing.filter((m) => !report.installed.includes(m)).join(", ")}`);
+        for (const c of report.configChanges) console.log(`  • ${c}`);
+        for (const h of report.envHints) console.log(`  ⚠ ${h}`);
+        console.log();
+      } catch (err) {
+        console.error("[clawnet] bootstrap-deps failed:", err.message || err);
+        console.error("  Continuing with token setup. Re-run 'clawnet-agent doctor' to retry.");
+      }
+    }
+
     const existing = loadConfig();
 
     let token = opts.token;
@@ -82,6 +108,48 @@ program
     console.log("  Run 'clawnet-agent start' to start the agent.\n");
   });
 
+// === doctor ===
+program
+  .command("doctor")
+  .description("Diagnose CLI dependencies and config (read-only by default; --fix to install/patch)")
+  .option("--fix", "Install missing CLIs and patch missing config keys")
+  .option("--yes", "Non-interactive: accept all install prompts (only with --fix)")
+  .action(async (opts) => {
+    const { bootstrapDeps } = await import("./dist/bootstrap-deps.js");
+    const { homedir } = await import("os");
+    const isTty = process.stdin.isTTY === true && process.stdout.isTTY === true;
+    const interactive = opts.fix && isTty && !opts.yes;
+    const report = await bootstrapDeps({
+      homeDir: homedir(),
+      interactive,
+      install: Boolean(opts.fix),
+      promptFn: prompt,
+    });
+    console.log("ClawNet Agent — Doctor Report\n");
+    console.log("CLI dependencies:");
+    for (const name of ["claude", "codex"]) {
+      const present = report.present.includes(name);
+      const installed = report.installed.includes(name);
+      const status = installed ? "installed (this run)" : present ? "present" : "MISSING";
+      console.log(`  ${present || installed ? "✓" : "✗"} ${name}: ${status}`);
+    }
+    console.log("\nConfig:");
+    if (report.configChanges.length === 0) {
+      console.log("  ✓ ~/.codex/config.toml and ~/.claude/settings.json look fine");
+    } else {
+      for (const c of report.configChanges) console.log(`  • ${c}`);
+    }
+    if (report.envHints.length > 0) {
+      console.log("\nEnvironment:");
+      for (const h of report.envHints) console.log(`  ⚠ ${h}`);
+    }
+    const stillMissing = report.missing.filter((m) => !report.installed.includes(m));
+    if (stillMissing.length > 0 && !opts.fix) {
+      console.log(`\nRun 'clawnet-agent doctor --fix' to install missing CLIs and patch config.`);
+    }
+    if (stillMissing.length > 0) process.exit(1);
+  });
+
 // === start (default command) ===
 program
   .command("start", { isDefault: true })

package/dist/__tests__/bootstrap-deps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bootstrap-deps.test.d.ts.map

package/dist/__tests__/bootstrap-deps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-deps.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bootstrap-deps.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/runtime-env-defaults.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-env-defaults.test.d.ts.map

package/dist/__tests__/runtime-env-defaults.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-env-defaults.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runtime-env-defaults.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-manager-exit-reason.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-manager-exit-reason.test.d.ts.map

package/dist/__tests__/session-manager-exit-reason.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-exit-reason.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-manager-exit-reason.test.ts"],"names":[],"mappings":""}

package/dist/{backend-factory-RUYUBJVF.js → backend-factory-VRPU3534.js}

@@ -1,9 +1,9 @@
 import {
   __resetBackendFactoryCache,
   createBackendAdapter
-} from "./chunk-MFXF77LG.js";
+} from "./chunk-FYM7CXUI.js";
 export {
   __resetBackendFactoryCache,
   createBackendAdapter
 };
-//# sourceMappingURL=backend-factory-RUYUBJVF.js.map
+//# sourceMappingURL=backend-factory-VRPU3534.js.map

package/dist/bootstrap-deps.d.ts

@@ -0,0 +1,62 @@
+export interface DetectResult {
+    found: boolean;
+    path?: string;
+}
+export interface DetectOptions {
+    /** Override which/where lookup. Tests inject a fake; runtime defaults to execFileSync. */
+    whichFn?: (bin: string) => string;
+}
+export declare function detectCli(bin: string, opts?: DetectOptions): DetectResult;
+export interface PatchResult {
+    /** Human-readable change log entries; empty array = no changes. */
+    patched: string[];
+}
+export interface PatchOptions {
+    homeDir: string;
+}
+/**
+ * Merge defaults into ~/.codex/config.toml.
+ *
+ * Two paths:
+ *   - File absent → write a fresh stringified TOML with our defaults.
+ *   - File exists → parse to detect missing keys, then APPEND missing
+ *     fragments as raw text. We never re-stringify the parsed AST, because
+ *     smol-toml's stringify drops comments and may reorder keys (verified
+ *     by regression test). Appending preserves the user's original bytes.
+ *
+ * Never touches user-set model_provider / model / per-provider fields.
+ */
+export declare function patchCodexConfig(opts: PatchOptions): PatchResult;
+/**
+ * Ensure ~/.claude/settings.json exists.
+ *
+ * Currently a thin presence-check: claude-code's own config schema evolves
+ * fast and we don't want to fight it. Just create an empty object if absent
+ * so downstream tools can rely on the file's existence.
+ */
+export declare function patchClaudeConfig(opts: PatchOptions): PatchResult;
+export declare function detectEnvVar(name: string): boolean;
+export interface BootstrapOptions {
+    homeDir: string;
+    /** When true, prompt user before installing CLIs. */
+    interactive: boolean;
+    /** When false, never install (doctor mode). */
+    install: boolean;
+    whichFn?: (bin: string) => string;
+    installFn?: (cliName: "claude" | "codex") => Promise<void>;
+    promptFn?: (question: string) => Promise<string>;
+}
+export interface BootstrapReport {
+    /** CLIs that were already installed. */
+    present: string[];
+    /** CLIs missing at start. */
+    missing: string[];
+    /** CLIs installed during this run. */
+    installed: string[];
+    /** Config patcher change logs (codex + claude). */
+    configChanges: string[];
+    /** Hint strings to print to user about env vars that need attention. */
+    envHints: string[];
+}
+export declare function bootstrapDeps(opts: BootstrapOptions): Promise<BootstrapReport>;
+//# sourceMappingURL=bootstrap-deps.d.ts.map

package/dist/bootstrap-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-deps.d.ts","sourceRoot":"","sources":["../src/bootstrap-deps.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACnC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAyB7E;AAED,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAqEhE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAejE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqDpF"}

package/dist/bootstrap-deps.js

@@ -0,0 +1,154 @@
+// src/bootstrap-deps.ts
+import { execFileSync } from "child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { platform } from "os";
+import { join } from "path";
+import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
+var isWin = platform() === "win32";
+function detectCli(bin, opts = {}) {
+  const whichFn = opts.whichFn ?? ((b) => {
+    const cmd = isWin ? "where" : "which";
+    return execFileSync(cmd, [b], {
+      encoding: "utf-8",
+      timeout: 1500,
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim().split(/\r?\n/)[0];
+  });
+  try {
+    const path = whichFn(bin);
+    if (path) return { found: true, path };
+    return { found: false };
+  } catch {
+    return { found: false };
+  }
+}
+var COPILOT_PROVIDER_DEFAULTS = {
+  name: "copilot-api",
+  base_url: "http://localhost:4141/v1",
+  wire_api: "responses",
+  env_key: "COPILOT_API_KEY"
+};
+function patchCodexConfig(opts) {
+  const codexDir = join(opts.homeDir, ".codex");
+  const cfgPath = join(codexDir, "config.toml");
+  if (!existsSync(cfgPath)) {
+    const fresh = {
+      model_provider: "copilot-api",
+      model_providers: { "copilot-api": COPILOT_PROVIDER_DEFAULTS }
+    };
+    mkdirSync(codexDir, { recursive: true });
+    writeFileSync(cfgPath, stringifyToml(fresh) + "\n");
+    return { patched: ["created ~/.codex/config.toml"] };
+  }
+  const originalText = readFileSync(cfgPath, "utf-8");
+  let cfg;
+  try {
+    cfg = parseToml(originalText);
+  } catch {
+    return { patched: ["~/.codex/config.toml could not be parsed; left untouched"] };
+  }
+  const mp = cfg.model_providers;
+  if (mp !== void 0 && (typeof mp !== "object" || Array.isArray(mp))) {
+    return {
+      patched: ["~/.codex/config.toml has model_providers that is not a table; left untouched"]
+    };
+  }
+  const needsTopLevel = cfg.model_provider === void 0;
+  const providers = mp ?? {};
+  const needsProvider = !providers["copilot-api"];
+  if (!needsTopLevel && !needsProvider) {
+    return { patched: [] };
+  }
+  const fragments = [];
+  const patched = [];
+  if (needsTopLevel) {
+    fragments.push(`model_provider = "copilot-api"`);
+    patched.push("set model_provider=copilot-api");
+  }
+  let updated = originalText;
+  if (fragments.length > 0) {
+    updated = fragments.join("\n") + "\n\n" + updated;
+  }
+  if (needsProvider) {
+    const sectionToml = stringifyToml({
+      model_providers: { "copilot-api": COPILOT_PROVIDER_DEFAULTS }
+    });
+    const sep = updated.endsWith("\n") ? "\n" : "\n\n";
+    updated = updated + sep + sectionToml + "\n";
+    patched.push("added [model_providers.copilot-api]");
+  }
+  writeFileSync(cfgPath, updated);
+  return { patched };
+}
+function patchClaudeConfig(opts) {
+  const claudeDir = join(opts.homeDir, ".claude");
+  const cfgPath = join(claudeDir, "settings.json");
+  if (existsSync(cfgPath)) {
+    try {
+      JSON.parse(readFileSync(cfgPath, "utf-8"));
+      return { patched: [] };
+    } catch {
+      return { patched: ["~/.claude/settings.json is not valid JSON; left untouched"] };
+    }
+  }
+  mkdirSync(claudeDir, { recursive: true });
+  writeFileSync(cfgPath, "{}\n");
+  return { patched: ["created ~/.claude/settings.json"] };
+}
+function detectEnvVar(name) {
+  const v = process.env[name];
+  return typeof v === "string" && v.length > 0;
+}
+async function defaultInstall(name) {
+  const pkg = name === "claude" ? "@anthropic-ai/claude-code" : "@openai/codex";
+  execFileSync("npm", ["install", "-g", pkg], { stdio: "inherit" });
+}
+async function bootstrapDeps(opts) {
+  const installFn = opts.installFn ?? defaultInstall;
+  const promptFn = opts.promptFn ?? (async () => "y");
+  const report = {
+    present: [],
+    missing: [],
+    installed: [],
+    configChanges: [],
+    envHints: []
+  };
+  const cliNames = ["claude", "codex"];
+  for (const name of cliNames) {
+    const r = detectCli(name, { whichFn: opts.whichFn });
+    if (r.found) report.present.push(name);
+    else report.missing.push(name);
+  }
+  if (opts.install && report.missing.length > 0) {
+    for (const name of report.missing) {
+      let shouldInstall = true;
+      if (opts.interactive) {
+        const ans = (await promptFn(`Install ${name} CLI via npm? [Y/n]: `)).trim().toLowerCase();
+        shouldInstall = ans === "" || ans === "y" || ans === "yes";
+      }
+      if (shouldInstall) {
+        await installFn(name);
+        report.installed.push(name);
+      }
+    }
+  }
+  const codexR = patchCodexConfig({ homeDir: opts.homeDir });
+  report.configChanges.push(...codexR.patched);
+  const claudeR = patchClaudeConfig({ homeDir: opts.homeDir });
+  report.configChanges.push(...claudeR.patched);
+  if (!detectEnvVar("COPILOT_API_KEY")) {
+    const shellHint = isWin ? "Set COPILOT_API_KEY in System \u2192 Environment Variables (any non-empty value, e.g. 'dummy')" : "Add to ~/.zshrc (or ~/.bashrc): export COPILOT_API_KEY=dummy";
+    report.envHints.push(
+      `COPILOT_API_KEY is not set. ${shellHint}. The copilot-api proxy does not validate the value, but codex requires the variable to exist.`
+    );
+  }
+  return report;
+}
+export {
+  bootstrapDeps,
+  detectCli,
+  detectEnvVar,
+  patchClaudeConfig,
+  patchCodexConfig
+};
+//# sourceMappingURL=bootstrap-deps.js.map

package/dist/bootstrap-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bootstrap-deps.ts"],"sourcesContent":["/**\n * bootstrap-deps — `clawnet-agent init` / `doctor` shared logic.\n *\n * Responsibilities (all idempotent, safe to re-run):\n *   - detect whether claude / codex CLIs are installed (which / where)\n *   - idempotent-merge ~/.codex/config.toml (default to copilot-api provider)\n *   - idempotent-merge ~/.claude/settings.json (create if absent, never overwrite)\n *   - detect env vars (COPILOT_API_KEY) and return user-facing hints when missing\n *\n * Side-effects deliberately NOT taken:\n *   - never modifies ~/.zshrc / ~/.bashrc / Windows env — dotfiles are sacred.\n *     Missing env is reported via `envHints[]` so the caller can print them.\n *   - never overwrites user-set TOML / JSON values; only adds missing keys.\n *   - when patching an EXISTING TOML file we never round-trip through\n *     stringify (smol-toml drops comments). We parse only to detect which\n *     keys are missing, then append the missing bits as raw text so user\n *     comments and key order survive untouched.\n *\n * Network / subprocess side-effects (npm install) are injected via `installFn`\n * so tests can verify call shape without actually spawning npm.\n */\nimport { execFileSync } from \"node:child_process\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { platform } from \"node:os\";\nimport { join } from \"node:path\";\nimport { parse as parseToml, stringify as stringifyToml } from \"smol-toml\";\n\nconst isWin = platform() === \"win32\";\n\nexport interface DetectResult {\n  found: boolean;\n  path?: string;\n}\n\nexport interface DetectOptions {\n  /** Override which/where lookup. Tests inject a fake; runtime defaults to execFileSync. */\n  whichFn?: (bin: string) => string;\n}\n\nexport function detectCli(bin: string, opts: DetectOptions = {}): DetectResult {\n  const whichFn =\n    opts.whichFn ??\n    ((b: string) => {\n      const cmd = isWin ? \"where\" : \"which\";\n      // execFileSync (not execSync) — pass `b` as an arg, never interpolate\n      // into a shell string. Today callers pass only literal \"claude\"/\"codex\"\n      // but the signature accepts any string; using execFile is defense in\n      // depth so a future caller passing user input can't smuggle a shell\n      // metacharacter and turn this into a command-injection sink.\n      return execFileSync(cmd, [b], {\n        encoding: \"utf-8\",\n        timeout: 1500,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      })\n        .trim()\n        .split(/\\r?\\n/)[0];\n    });\n  try {\n    const path = whichFn(bin);\n    if (path) return { found: true, path };\n    return { found: false };\n  } catch {\n    return { found: false };\n  }\n}\n\nexport interface PatchResult {\n  /** Human-readable change log entries; empty array = no changes. */\n  patched: string[];\n}\n\nexport interface PatchOptions {\n  homeDir: string;\n}\n\nconst COPILOT_PROVIDER_DEFAULTS = {\n  name: \"copilot-api\",\n  base_url: \"http://localhost:4141/v1\",\n  wire_api: \"responses\",\n  env_key: \"COPILOT_API_KEY\",\n} as const;\n\n/**\n * Merge defaults into ~/.codex/config.toml.\n *\n * Two paths:\n *   - File absent → write a fresh stringified TOML with our defaults.\n *   - File exists → parse to detect missing keys, then APPEND missing\n *     fragments as raw text. We never re-stringify the parsed AST, because\n *     smol-toml's stringify drops comments and may reorder keys (verified\n *     by regression test). Appending preserves the user's original bytes.\n *\n * Never touches user-set model_provider / model / per-provider fields.\n */\nexport function patchCodexConfig(opts: PatchOptions): PatchResult {\n  const codexDir = join(opts.homeDir, \".codex\");\n  const cfgPath = join(codexDir, \"config.toml\");\n\n  // Fresh-write path.\n  if (!existsSync(cfgPath)) {\n    const fresh = {\n      model_provider: \"copilot-api\",\n      model_providers: { \"copilot-api\": COPILOT_PROVIDER_DEFAULTS },\n    };\n    mkdirSync(codexDir, { recursive: true });\n    writeFileSync(cfgPath, stringifyToml(fresh) + \"\\n\");\n    return { patched: [\"created ~/.codex/config.toml\"] };\n  }\n\n  // Existing-file path: parse-then-append-raw.\n  const originalText = readFileSync(cfgPath, \"utf-8\");\n  let cfg: Record<string, unknown>;\n  try {\n    cfg = parseToml(originalText) as Record<string, unknown>;\n  } catch {\n    return { patched: [\"~/.codex/config.toml could not be parsed; left untouched\"] };\n  }\n\n  // Type-guard model_providers: smol-toml will faithfully parse a wrong-typed\n  // `model_providers = \"string\"` as a string, and our previous .cast-and-poke\n  // approach would silently overwrite it. Bail loudly instead.\n  const mp = cfg.model_providers;\n  if (mp !== undefined && (typeof mp !== \"object\" || Array.isArray(mp))) {\n    return {\n      patched: [\"~/.codex/config.toml has model_providers that is not a table; left untouched\"],\n    };\n  }\n\n  const needsTopLevel = cfg.model_provider === undefined;\n  const providers = (mp ?? {}) as Record<string, unknown>;\n  const needsProvider = !providers[\"copilot-api\"];\n\n  if (!needsTopLevel && !needsProvider) {\n    return { patched: [] };\n  }\n\n  const fragments: string[] = [];\n  const patched: string[] = [];\n\n  if (needsTopLevel) {\n    // Top-level scalar key must precede any [section] header to remain\n    // top-level. The safest place to insert is at the very top of the file.\n    // We accumulate scalar additions and prepend them in a single splice.\n    fragments.push(`model_provider = \"copilot-api\"`);\n    patched.push(\"set model_provider=copilot-api\");\n  }\n\n  let updated = originalText;\n  if (fragments.length > 0) {\n    updated = fragments.join(\"\\n\") + \"\\n\\n\" + updated;\n  }\n\n  if (needsProvider) {\n    const sectionToml = stringifyToml({\n      model_providers: { \"copilot-api\": COPILOT_PROVIDER_DEFAULTS },\n    });\n    const sep = updated.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n    updated = updated + sep + sectionToml + \"\\n\";\n    patched.push(\"added [model_providers.copilot-api]\");\n  }\n\n  writeFileSync(cfgPath, updated);\n  return { patched };\n}\n\n/**\n * Ensure ~/.claude/settings.json exists.\n *\n * Currently a thin presence-check: claude-code's own config schema evolves\n * fast and we don't want to fight it. Just create an empty object if absent\n * so downstream tools can rely on the file's existence.\n */\nexport function patchClaudeConfig(opts: PatchOptions): PatchResult {\n  const claudeDir = join(opts.homeDir, \".claude\");\n  const cfgPath = join(claudeDir, \"settings.json\");\n  if (existsSync(cfgPath)) {\n    // Validate it parses; if not, surface but don't rewrite.\n    try {\n      JSON.parse(readFileSync(cfgPath, \"utf-8\"));\n      return { patched: [] };\n    } catch {\n      return { patched: [\"~/.claude/settings.json is not valid JSON; left untouched\"] };\n    }\n  }\n  mkdirSync(claudeDir, { recursive: true });\n  writeFileSync(cfgPath, \"{}\\n\");\n  return { patched: [\"created ~/.claude/settings.json\"] };\n}\n\nexport function detectEnvVar(name: string): boolean {\n  const v = process.env[name];\n  return typeof v === \"string\" && v.length > 0;\n}\n\nexport interface BootstrapOptions {\n  homeDir: string;\n  /** When true, prompt user before installing CLIs. */\n  interactive: boolean;\n  /** When false, never install (doctor mode). */\n  install: boolean;\n  whichFn?: (bin: string) => string;\n  installFn?: (cliName: \"claude\" | \"codex\") => Promise<void>;\n  promptFn?: (question: string) => Promise<string>;\n}\n\nexport interface BootstrapReport {\n  /** CLIs that were already installed. */\n  present: string[];\n  /** CLIs missing at start. */\n  missing: string[];\n  /** CLIs installed during this run. */\n  installed: string[];\n  /** Config patcher change logs (codex + claude). */\n  configChanges: string[];\n  /** Hint strings to print to user about env vars that need attention. */\n  envHints: string[];\n}\n\n/**\n * Default npm-based install. Kept here (not in detect.ts) so production\n * callers don't have to wire it; tests inject their own spy.\n *\n * Why npm and not brew/cargo/winget: we picked one source per CLI to keep\n * the matrix small. claude-code is npm-only anyway, and codex npm package\n * works on both macOS and Windows (our codex-adapter already handles the\n * Windows .cmd shim).\n */\nasync function defaultInstall(name: \"claude\" | \"codex\"): Promise<void> {\n  const pkg = name === \"claude\" ? \"@anthropic-ai/claude-code\" : \"@openai/codex\";\n  // Inherit stdio so the user sees npm's progress; init is interactive.\n  // execFileSync with explicit args — never interpolate the package name\n  // into a shell string even though it's hardcoded today.\n  execFileSync(\"npm\", [\"install\", \"-g\", pkg], { stdio: \"inherit\" });\n}\n\nexport async function bootstrapDeps(opts: BootstrapOptions): Promise<BootstrapReport> {\n  const installFn = opts.installFn ?? defaultInstall;\n  const promptFn = opts.promptFn ?? (async () => \"y\");\n\n  const report: BootstrapReport = {\n    present: [],\n    missing: [],\n    installed: [],\n    configChanges: [],\n    envHints: [],\n  };\n\n  // 1. Detect CLIs\n  const cliNames: Array<\"claude\" | \"codex\"> = [\"claude\", \"codex\"];\n  for (const name of cliNames) {\n    const r = detectCli(name, { whichFn: opts.whichFn });\n    if (r.found) report.present.push(name);\n    else report.missing.push(name);\n  }\n\n  // 2. Optionally install missing\n  if (opts.install && report.missing.length > 0) {\n    for (const name of report.missing as Array<\"claude\" | \"codex\">) {\n      let shouldInstall = true;\n      if (opts.interactive) {\n        const ans = (await promptFn(`Install ${name} CLI via npm? [Y/n]: `)).trim().toLowerCase();\n        // Default Y (empty input → yes); only explicit \"n\"/\"no\" skips.\n        shouldInstall = ans === \"\" || ans === \"y\" || ans === \"yes\";\n      }\n      if (shouldInstall) {\n        await installFn(name);\n        report.installed.push(name);\n      }\n    }\n  }\n\n  // 3. Patch configs (always — they're idempotent)\n  const codexR = patchCodexConfig({ homeDir: opts.homeDir });\n  report.configChanges.push(...codexR.patched);\n  const claudeR = patchClaudeConfig({ homeDir: opts.homeDir });\n  report.configChanges.push(...claudeR.patched);\n\n  // 4. Env hints (no dotfile mutation — print only)\n  if (!detectEnvVar(\"COPILOT_API_KEY\")) {\n    const shellHint = isWin\n      ? \"Set COPILOT_API_KEY in System → Environment Variables (any non-empty value, e.g. 'dummy')\"\n      : \"Add to ~/.zshrc (or ~/.bashrc): export COPILOT_API_KEY=dummy\";\n    report.envHints.push(\n      `COPILOT_API_KEY is not set. ${shellHint}. The copilot-api proxy does not validate the value, but codex requires the variable to exist.`,\n    );\n  }\n\n  return report;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-2JDX6XFD.js → chunk-B733MQCA.js}

@@ -2281,6 +2281,12 @@ var SessionManager = class {
   // handler. A leftover entry would only matter if a session id were reused,
   // which createSession already forbids (line 193 throws on duplicate).
   expectedExits = /* @__PURE__ */ new Set();
+  // Most recent adapter-emitted error per session, used to enrich the
+  // otherwise opaque "exit code=N" reason that swarm coordinator's crash
+  // inbox surfaces. Entries are auto-pruned on session exit and ignored if
+  // older than 5s (so a stale entry from a long-lived session doesn't
+  // misattribute a later unrelated exit).
+  lastSessionError = /* @__PURE__ */ new Map();
   idleSweepTimer = null;
   // PR-A: effective sweeper config. Initialized from env at construct time
   // and overridable per-instance via startIdleSweeper(overrides) — the
@@ -2487,6 +2493,7 @@ ${notice.text}`;
       });
       spawnAdapter.onError?.(process2, (error) => {
         this.activelyExecuting.delete(options.sessionId);
+        this.lastSessionError.set(options.sessionId, { message: error.message, ts: Date.now() });
         this.onSessionError(options.sessionId, error.message);
       });
       spawnAdapter.onTokenBudgetWarning?.(process2, (info) => {
@@ -2573,6 +2580,10 @@ ${notice.text}`;
         });
       }
       spawnAdapter.onExit?.(process2, (code) => {
+        const lastErr = this.lastSessionError.get(options.sessionId);
+        this.lastSessionError.delete(options.sessionId);
+        const enriched = lastErr && Date.now() - lastErr.ts < 5e3 ? lastErr.message : void 0;
+        const reasonText = enriched ? `exit code=${code ?? "null"} \u2014 ${enriched}` : `exit code=${code ?? "null"}`;
         if (this.sessions.get(options.sessionId) === process2) {
           const expected = this.expectedExits.delete(options.sessionId);
           this.sessions.delete(options.sessionId);
@@ -2581,7 +2592,7 @@ ${notice.text}`;
           this.conversationBuffer.delete(options.sessionId);
           this.scheduleCheckpoint();
           if (!expected) {
-            log5.warn({ sessionId: options.sessionId, exitCode: code }, "backend process exited unexpectedly, evicted from session map");
+            log5.warn({ sessionId: options.sessionId, exitCode: code, reason: enriched }, "backend process exited unexpectedly, evicted from session map");
             this.onSessionError(options.sessionId, `backend process exited (code=${code ?? "null"})`);
           } else {
             log5.debug({ sessionId: options.sessionId, exitCode: code }, "backend process exited as expected");
@@ -2590,7 +2601,7 @@ ${notice.text}`;
             this.onSessionExit?.(options.sessionId, {
               code: code ?? null,
               expected,
-              ...expected ? {} : { reason: `exit code=${code ?? "null"}` }
+              ...expected ? {} : { reason: reasonText }
             });
           } catch (err) {
             log5.warn({ err, sessionId: options.sessionId }, "onSessionExit listener threw");
@@ -2965,8 +2976,15 @@ ${content}`;
   }
 };
 
+// src/runtime-env-defaults.ts
+function ensureRuntimeEnvDefaults() {
+  if (!process.env.COPILOT_API_KEY) {
+    process.env.COPILOT_API_KEY = "dummy";
+  }
+}
+
 // src/start.ts
-import { SwarmCoordinator, initRoles } from "@mclawnet/swarm";
+import { SwarmCoordinator, initRoles, WakeupScheduler, listRecoverableSwarmIds as listRecoverableSwarmIds2 } from "@mclawnet/swarm";
 import { TaskStore as TaskStore2 } from "@mclawnet/task";
 
 // src/brain-bridge.ts
@@ -3485,6 +3503,7 @@ import {
 import { PROJECTS_RPC_CAPABILITY } from "@mclawnet/shared";
 var log10 = createLogger10({ module: "agent" });
 async function startAgent(options) {
+  ensureRuntimeEnvDefaults();
   const config = loadConfig(options.config);
   if (!config.token) {
     log10.error("no token configured \u2014 set CLAWNET_TOKEN or use --token");
@@ -3586,7 +3605,7 @@ async function startAgent(options) {
   const sessionManager = new SessionManager({
     adapter: options.adapter,
     resolveAdapter: async (kind) => {
-      const { createBackendAdapter } = await import("./backend-factory-RUYUBJVF.js");
+      const { createBackendAdapter } = await import("./backend-factory-VRPU3534.js");
       return createBackendAdapter(kind);
     },
     onOutput: (sessionId, data) => {
@@ -3667,6 +3686,17 @@ async function startAgent(options) {
   }, process.env.CLAWNET_HOME ?? homedir5());
   hub.setSessionManager(sessionManager);
   hub.setSwarmCoordinator(swarmCoordinator);
+  const wakeupHome = process.env.CLAWNET_HOME ?? homedir5();
+  const wakeupScheduler = new WakeupScheduler(swarmCoordinator.inboxRelay);
+  try {
+    const knownSwarms = listRecoverableSwarmIds2().map(({ swarmId, workDir }) => ({
+      swarmId,
+      workDir
+    }));
+    await wakeupScheduler.restoreFromInbox(wakeupHome, knownSwarms);
+  } catch (err) {
+    log10.warn({ err }, "WakeupScheduler.restoreFromInbox failed (non-fatal)");
+  }
   const scheduleRuntime = new ScheduleRuntime({ hub, sessionManager, swarmCoordinator });
   hub.setScheduleRuntime(scheduleRuntime);
   await scheduleRuntime.start();
@@ -3676,6 +3706,7 @@ async function startAgent(options) {
   sessionManager.startIdleSweeper();
   const shutdown = async () => {
     log10.info("shutting down");
+    wakeupScheduler.dispose();
     await sessionManager.closeAll();
     await scheduleRuntime.stop();
     hub.destroy();
@@ -3701,4 +3732,4 @@ export {
   FsBridge,
   startAgent
 };
-//# sourceMappingURL=chunk-2JDX6XFD.js.map
+//# sourceMappingURL=chunk-B733MQCA.js.map