codeam-cli 2.4.33 → 2.4.34

package/dist/index.js

@@ -519,9 +519,9 @@ var require_windowsPtyAgent = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.argsToCommandLine = exports2.WindowsPtyAgent = void 0;
-    var fs9 = require("fs");
-    var os8 = require("os");
-    var path16 = require("path");
+    var fs11 = require("fs");
+    var os10 = require("os");
+    var path18 = require("path");
     var child_process_1 = require("child_process");
     var net_1 = require("net");
     var windowsConoutConnection_1 = require_windowsConoutConnection();
@@ -557,7 +557,7 @@ var require_windowsPtyAgent = __commonJS({
             }
           }
           this._ptyNative = this._useConpty ? conptyNative : winptyNative;
-          cwd = path16.resolve(cwd);
+          cwd = path18.resolve(cwd);
           var commandLine = argsToCommandLine(file, args2);
           var term;
           if (this._useConpty) {
@@ -578,7 +578,7 @@ var require_windowsPtyAgent = __commonJS({
           this._outSocket.on("connect", function() {
             _this._outSocket.emit("ready_datapipe");
           });
-          var inSocketFD = fs9.openSync(term.conin, "w");
+          var inSocketFD = fs11.openSync(term.conin, "w");
           this._inSocket = new net_1.Socket({
             fd: inSocketFD,
             readable: false,
@@ -679,7 +679,7 @@ var require_windowsPtyAgent = __commonJS({
         WindowsPtyAgent2.prototype._getConsoleProcessList = function() {
           var _this = this;
           return new Promise(function(resolve2) {
-            var agent = child_process_1.fork(path16.join(__dirname, "conpty_console_list_agent"), [_this._innerPid.toString()]);
+            var agent = child_process_1.fork(path18.join(__dirname, "conpty_console_list_agent"), [_this._innerPid.toString()]);
             agent.on("message", function(message) {
               clearTimeout(timeout);
               resolve2(message.consoleProcessList);
@@ -702,7 +702,7 @@ var require_windowsPtyAgent = __commonJS({
           configurable: true
         });
         WindowsPtyAgent2.prototype._getWindowsBuildNumber = function() {
-          var osVersion = /(\d+)\.(\d+)\.(\d+)/g.exec(os8.release());
+          var osVersion = /(\d+)\.(\d+)\.(\d+)/g.exec(os10.release());
           var buildNumber = 0;
           if (osVersion && osVersion.length === 4) {
             buildNumber = parseInt(osVersion[3]);
@@ -1012,15 +1012,15 @@ var require_unixTerminal = __commonJS({
     })();
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.UnixTerminal = void 0;
-    var fs9 = require("fs");
-    var path16 = require("path");
+    var fs11 = require("fs");
+    var path18 = require("path");
     var tty = require("tty");
     var terminal_1 = require_terminal();
     var utils_1 = require_utils();
     var native = utils_1.loadNativeModule("pty");
     var pty = native.module;
     var helperPath = native.dir + "/spawn-helper";
-    helperPath = path16.resolve(__dirname, helperPath);
+    helperPath = path18.resolve(__dirname, helperPath);
     helperPath = helperPath.replace("app.asar", "app.asar.unpacked");
     helperPath = helperPath.replace("node_modules.asar", "node_modules.asar.unpacked");
     var DEFAULT_FILE = "sh";
@@ -1275,7 +1275,7 @@ var require_unixTerminal = __commonJS({
             return;
           }
           var task = this._writeQueue[0];
-          fs9.write(this._fd, task.buffer, task.offset, function(err, written) {
+          fs11.write(this._fd, task.buffer, task.offset, function(err, written) {
             if (err) {
               if ("code" in err && err.code === "EAGAIN") {
                 _this._writeImmediate = setImmediate(function() {
@@ -1390,9 +1390,9 @@ var require_src = __commonJS({
 });
 
 // src/commands/start.ts
-var fs7 = __toESM(require("fs"));
-var os6 = __toESM(require("os"));
-var path10 = __toESM(require("path"));
+var fs8 = __toESM(require("fs"));
+var os7 = __toESM(require("os"));
+var path11 = __toESM(require("path"));
 var import_crypto = require("crypto");
 var import_child_process5 = require("child_process");
 var import_picocolors2 = __toESM(require("picocolors"));
@@ -1482,8 +1482,9 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.4.33",
+  version: "2.4.34",
   description: "Remote control Claude Code (and other AI coding agents) from your mobile phone. Pair your device, send prompts, stream responses in real-time, and approve commands \u2014 from anywhere.",
+  type: "commonjs",
   main: "dist/index.js",
   bin: {
     codeam: "dist/index.js"
@@ -1611,6 +1612,60 @@ function computePollDelay({ baseMs, failures }) {
   return Math.round(jitter);
 }
 
+// src/services/logger.ts
+var fs2 = __toESM(require("fs"));
+var os2 = __toESM(require("os"));
+var path2 = __toESM(require("path"));
+var LEVELS = { silent: 0, error: 1, warn: 2, info: 3, debug: 4, trace: 5 };
+function currentLevel() {
+  if (process.env.CODEAM_DEBUG === "1") return LEVELS.trace;
+  const raw = (process.env.CODEAM_LOG ?? "error").toLowerCase();
+  return LEVELS[raw] ?? LEVELS.error;
+}
+var fileEnabled = process.env.CODEAM_DEBUG === "1" || process.env.CODEAM_LOG === "debug" || process.env.CODEAM_LOG === "trace";
+var debugFilePath = path2.join(os2.homedir(), ".codeam", "debug.log");
+var fileInitialized = false;
+function appendToFile(line) {
+  if (!fileEnabled) return;
+  try {
+    if (!fileInitialized) {
+      fs2.mkdirSync(path2.dirname(debugFilePath), { recursive: true });
+      fs2.writeFileSync(
+        debugFilePath,
+        `=== codeam debug log \u2014 pid ${process.pid} \u2014 ${(/* @__PURE__ */ new Date()).toISOString()} ===
+platform=${process.platform} node=${process.version} cwd=${process.cwd()}
+
+`
+      );
+      fileInitialized = true;
+    }
+    fs2.appendFileSync(debugFilePath, line);
+  } catch {
+  }
+}
+function emit(level, tag, msg, err) {
+  if (LEVELS[level] > currentLevel()) return;
+  const detail = err instanceof Error ? `: ${err.message}` : err !== void 0 ? `: ${String(err)}` : "";
+  const line = `[codeam:${level}] ${tag} \u2014 ${msg}${detail}
+`;
+  process.stderr.write(line);
+  if (LEVELS[level] >= LEVELS.debug) {
+    appendToFile(`${(/* @__PURE__ */ new Date()).toISOString()} ${line}`);
+  }
+}
+var log = {
+  error: (tag, msg, err) => emit("error", tag, msg, err),
+  warn: (tag, msg, err) => emit("warn", tag, msg, err),
+  info: (tag, msg, err) => emit("info", tag, msg, err),
+  debug: (tag, msg, err) => emit("debug", tag, msg, err),
+  /**
+   * Verbose pipeline breadcrumb. Only fires when CODEAM_LOG=trace or
+   * CODEAM_DEBUG=1, so call sites can be liberal — they have zero
+   * cost in normal runs.
+   */
+  trace: (tag, msg, err) => emit("trace", tag, msg, err)
+};
+
 // src/services/websocket.service.ts
 var API_BASE = process.env.CODEAM_API_URL ?? "https://codeagent-mobile-api.vercel.app";
 var WS_URL = API_BASE.replace("https://", "wss://").replace("http://", "ws://") + "/api/ws";
@@ -1640,6 +1695,7 @@ var WebSocketService = class {
     try {
       this.client = new import_ws.default(WS_URL);
       this.client.on("open", () => {
+        log.trace("ws", `connected to ${WS_URL}`);
         this._connected = true;
         this.reconnectAttempts = 0;
         this.client.send(JSON.stringify({
@@ -1653,12 +1709,18 @@ var WebSocketService = class {
       this.client.on("message", (raw) => {
         try {
           const msg = JSON.parse(raw.toString());
-          if (msg.type === "pong" || msg.type === "auth_success" || msg.type === "auth_error") return;
+          if (msg.type === "pong" || msg.type === "auth_success" || msg.type === "auth_error") {
+            log.trace("ws", `meta msg type=${msg.type}`);
+            return;
+          }
+          log.trace("ws", `dispatch msg type=${msg.type}`);
           this.handlers.forEach((h) => h.onMessage(msg.type, msg.payload ?? {}));
-        } catch {
+        } catch (err) {
+          log.trace("ws", "malformed message", err);
         }
       });
-      this.client.on("close", () => {
+      this.client.on("close", (code, reason) => {
+        log.trace("ws", `closed code=${code} reason=${reason?.toString() || "(empty)"}`);
         this._connected = false;
         this.stopHeartbeat();
         this.handlers.forEach((h) => h.onDisconnected());
@@ -1668,9 +1730,11 @@ var WebSocketService = class {
           this.reconnectTimer = setTimeout(() => this.connect(), delay);
         }
       });
-      this.client.on("error", () => {
+      this.client.on("error", (err) => {
+        log.trace("ws", "error", err);
       });
-    } catch {
+    } catch (err) {
+      log.trace("ws", "sync connect threw", err);
     }
   }
   send(type, payload) {
@@ -1706,7 +1770,7 @@ var WebSocketService = class {
 // src/services/pairing.service.ts
 var https = __toESM(require("https"));
 var http = __toESM(require("http"));
-var os2 = __toESM(require("os"));
+var os3 = __toESM(require("os"));
 var API_BASE2 = process.env.CODEAM_API_URL ?? "https://codeagent-mobile-api.vercel.app";
 async function requestCode(pluginId) {
   try {
@@ -1716,7 +1780,7 @@ async function requestCode(pluginId) {
       pluginId,
       ideName: "Terminal (codeam-cli)",
       ideVersion: package_default.version,
-      hostname: os2.hostname(),
+      hostname: os3.hostname(),
       runtime,
       ...codespaceName ? { codespaceName } : {}
     });
@@ -1880,7 +1944,10 @@ var CommandRelayService = class {
   _running = false;
   pollTimer = null;
   heartbeatTimer = null;
+  agentsTimer = null;
   consecutiveFailures = 0;
+  /** True once `/api/plugin/agents` has accepted at least one report. */
+  agentsRegistered = false;
   start() {
     if (this.pollTimer) {
       clearTimeout(this.pollTimer);
@@ -1890,11 +1957,19 @@ var CommandRelayService = class {
       clearInterval(this.heartbeatTimer);
       this.heartbeatTimer = null;
     }
+    if (this.agentsTimer) {
+      clearInterval(this.agentsTimer);
+      this.agentsTimer = null;
+    }
     this._running = true;
+    this.agentsRegistered = false;
     this.sendHeartbeat(true);
     this.heartbeatTimer = setInterval(() => this.sendHeartbeat(true), 2e4);
     void this.pollLoop();
     this.reportAgents();
+    this.agentsTimer = setInterval(() => {
+      if (this._running && !this.agentsRegistered) this.reportAgents();
+    }, 5e3);
   }
   stop() {
     if (!this._running) return;
@@ -1907,6 +1982,10 @@ var CommandRelayService = class {
       clearInterval(this.heartbeatTimer);
       this.heartbeatTimer = null;
     }
+    if (this.agentsTimer) {
+      clearInterval(this.agentsTimer);
+      this.agentsTimer = null;
+    }
     this.sendHeartbeat(false).catch(() => {
     });
   }
@@ -1932,32 +2011,43 @@ var CommandRelayService = class {
       const commands = data?.data;
       this.consecutiveFailures = 0;
       if (!Array.isArray(commands)) return;
+      if (commands.length > 0) {
+        log.trace("relay", `poll received ${commands.length} command(s)`);
+      }
       for (const obj of commands) {
         try {
+          log.trace("relay", `dispatch type=${obj.type} id=${obj.id}`);
           await this.onCommand({
             id: obj.id,
             sessionId: obj.sessionId,
             type: obj.type,
             payload: obj.payload ?? {}
           });
-        } catch {
+        } catch (err) {
+          log.trace("relay", `command handler threw`, err);
         }
       }
-    } catch {
+    } catch (err) {
       this.consecutiveFailures += 1;
+      log.trace(
+        "relay",
+        `poll failed (failures=${this.consecutiveFailures})`,
+        err
+      );
     }
   }
   async sendHeartbeat(online) {
     await _postJson(`${API_BASE3}/api/plugin/heartbeat`, {
       pluginId: this.pluginId,
       online
-    }).catch(() => {
-    });
+    }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   reportAgents() {
     _postJson(`${API_BASE3}/api/plugin/agents`, {
       pluginId: this.pluginId,
       agents: [{ id: "claude-code", name: "Claude Code", icon: "\u{1F916}", installed: true }]
+    }).then(() => {
+      this.agentsRegistered = true;
     }).catch(() => {
     });
   }
@@ -1965,24 +2055,24 @@ var CommandRelayService = class {
 
 // src/services/pty/unix.strategy.ts
 var import_child_process = require("child_process");
-var fs3 = __toESM(require("fs"));
-var os3 = __toESM(require("os"));
-var path3 = __toESM(require("path"));
+var fs4 = __toESM(require("fs"));
+var os4 = __toESM(require("os"));
+var path4 = __toESM(require("path"));
 
 // src/services/pty/types.ts
-var fs2 = __toESM(require("fs"));
-var path2 = __toESM(require("path"));
+var fs3 = __toESM(require("fs"));
+var path3 = __toESM(require("path"));
 function findInPath(name) {
   const isWin = process.platform === "win32";
-  const dirs = (process.env.PATH ?? "").split(path2.delimiter).filter(Boolean);
-  const hasExt = path2.extname(name).length > 0;
+  const dirs = (process.env.PATH ?? "").split(path3.delimiter).filter(Boolean);
+  const hasExt = path3.extname(name).length > 0;
   const candidates = isWin && !hasExt ? [`${name}.exe`, `${name}.cmd`, `${name}.bat`, `${name}.ps1`, name] : [name];
-  const accessFlag = isWin ? fs2.constants.F_OK : fs2.constants.X_OK;
+  const accessFlag = isWin ? fs3.constants.F_OK : fs3.constants.X_OK;
   for (const dir of dirs) {
     for (const candidate of candidates) {
-      const full = path2.join(dir, candidate);
+      const full = path3.join(dir, candidate);
       try {
-        fs2.accessSync(full, accessFlag);
+        fs3.accessSync(full, accessFlag);
         return full;
       } catch {
       }
@@ -2066,8 +2156,8 @@ var UnixPtyStrategy = class {
     }
     const cols = process.stdout.columns || 220;
     const rows = process.stdout.rows || 50;
-    this.helperPath = path3.join(os3.tmpdir(), "codeam-pty-helper.py");
-    fs3.writeFileSync(this.helperPath, PYTHON_PTY_HELPER, { mode: 420 });
+    this.helperPath = path4.join(os4.tmpdir(), "codeam-pty-helper.py");
+    fs4.writeFileSync(this.helperPath, PYTHON_PTY_HELPER, { mode: 420 });
     this.proc = (0, import_child_process.spawn)(python, [this.helperPath, cmd, ...args2], {
       stdio: ["pipe", "pipe", "inherit"],
       cwd,
@@ -2196,7 +2286,7 @@ var UnixPtyStrategy = class {
   removeTempFile() {
     if (this.helperPath) {
       try {
-        fs3.unlinkSync(this.helperPath);
+        fs4.unlinkSync(this.helperPath);
       } catch {
       }
       this.helperPath = null;
@@ -2268,9 +2358,9 @@ var WindowsPtyStrategy = class {
 };
 
 // src/services/pty/windows-conpty.strategy.ts
-var path4 = __toESM(require("path"));
+var path5 = __toESM(require("path"));
 function loadNodePty() {
-  const vendoredPath = path4.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path5.join(__dirname, "vendor", "node-pty");
   try {
     return require(vendoredPath);
   } catch (vendorErr) {
@@ -2320,11 +2410,17 @@ var WindowsConPtyStrategy = class _WindowsConPtyStrategy {
       useConpty: true,
       conptyInheritCursor: false
     });
+    let traceCount = 0;
     this.dataSub = this.pty.onData((data) => {
       process.stdout.write(data);
       this.opts.onData(data);
+      traceCount++;
+      if (traceCount <= 5 || traceCount % 50 === 0) {
+        log.trace("conpty", `onData #${traceCount} ${data.length}B`);
+      }
     });
     this.exitSub = this.pty.onExit(({ exitCode }) => {
+      log.trace("conpty", `claude exited code=${exitCode ?? 0}`);
       this.dispose();
       this.opts.onExit(exitCode ?? 0);
     });
@@ -2384,8 +2480,8 @@ var WindowsConPtyStrategy = class _WindowsConPtyStrategy {
 
 // src/services/claude-installer.ts
 var import_child_process3 = require("child_process");
-var path5 = __toESM(require("path"));
-var os4 = __toESM(require("os"));
+var path6 = __toESM(require("path"));
+var os5 = __toESM(require("os"));
 
 // ../../node_modules/@clack/prompts/dist/index.mjs
 var dist_exports = {};
@@ -4299,17 +4395,17 @@ ${c2}
 
 // src/services/claude-installer.ts
 function probeInstallDirs() {
-  const home = os4.homedir();
+  const home = os5.homedir();
   if (process.platform === "win32") {
     return [
-      path5.join(home, ".claude", "local"),
-      path5.join(home, "AppData", "Local", "AnthropicClaude"),
-      path5.join(home, "AppData", "Local", "Programs", "AnthropicClaude")
+      path6.join(home, ".claude", "local"),
+      path6.join(home, "AppData", "Local", "AnthropicClaude"),
+      path6.join(home, "AppData", "Local", "Programs", "AnthropicClaude")
     ];
   }
   return [
-    path5.join(home, ".local", "bin"),
-    path5.join(home, ".claude", "local"),
+    path6.join(home, ".local", "bin"),
+    path6.join(home, ".claude", "local"),
     "/usr/local/bin"
   ];
 }
@@ -4318,7 +4414,7 @@ function isAvailable() {
 }
 function augmentPath() {
   const dirs = probeInstallDirs();
-  const sep2 = path5.delimiter;
+  const sep2 = path6.delimiter;
   const current = process.env.PATH ?? "";
   const existing = new Set(current.split(sep2).filter(Boolean));
   const additions = dirs.filter((d3) => !existing.has(d3));
@@ -4376,12 +4472,12 @@ async function ensureClaudeInstalled() {
 }
 
 // src/services/claude-resolver.ts
-var path6 = __toESM(require("path"));
+var path7 = __toESM(require("path"));
 function buildClaudeLaunch(extraArgs = []) {
   const found = findInPath("claude") ?? findInPath("claude-code");
   if (!found) return null;
   if (process.platform === "win32") {
-    const ext = path6.extname(found).toLowerCase();
+    const ext = path7.extname(found).toLowerCase();
     if (ext === ".cmd" || ext === ".bat") {
       return { cmd: "cmd.exe", args: ["/c", found, ...extraArgs] };
     }
@@ -4429,11 +4525,13 @@ var ClaudeService = class {
       }
     }
     if (process.platform === "win32") {
+      log.trace("claude", `spawn (win32) cmd=${launch.cmd} args=${launch.args.join(" ")}`);
       const conpty = WindowsConPtyStrategy.tryCreate(this.strategyOpts);
       if (conpty) {
         try {
           conpty.spawn(launch.cmd, this.opts.cwd, launch.args);
           this.strategy = conpty;
+          log.trace("claude", "ConPTY spawn ok");
           return;
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
@@ -4473,8 +4571,12 @@ var ClaudeService = class {
    * a fresh event-loop tick, after React has flushed the text into input state.
    */
   sendCommand(text) {
-    if (!this.strategy) return;
+    if (!this.strategy) {
+      log.trace("claude", "sendCommand dropped (no strategy)");
+      return;
+    }
     const s = this.strategy;
+    log.trace("claude", `sendCommand text=${text.length}B`);
     s.write(text);
     setTimeout(() => s.write("\r"), 50);
   }
@@ -4548,12 +4650,12 @@ var https2 = __toESM(require("https"));
 var http2 = __toESM(require("http"));
 
 // ../../packages/shared/src/protocol/parseChrome.ts
-var SPINNER_RE = /^[✳✢✶✻✽✴✷✸✹⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏◐◑◒◓▁▂▃▄▅▆▇█]\s/;
+var SPINNER_RE = /^(?:[✳✢✶✻✽✴✷✸✹⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏◐◑◒◓▁▂▃▄▅▆▇█]|🔴|🟠|🟡|🟢|🔵|🟣|🟤|⚫|⚪|🌀|💭|✨)\s/u;
 var BULLET_TOOL_RE = /^•\s+(?:Read(?:ing)?|Edit(?:ing)?|Writ(?:e|ing)|Bash|Runn(?:ing)?|Search(?:ing)?|Glob(?:bing)?|Grep(?:ping)?|Creat(?:e|ing)|Execut(?:e|ing)|Task|Agent|NotebookEdit)\b/i;
 var TREE_LINE_RE = /^└\s/;
-var STATUS_LINE_RE = /^\+\s/;
+var STATUS_LINE_RE = /^(?:\+|[🔴🟠🟡🟢🔵🟣🟤⚫⚪🌀💭✨])\s/u;
 function isChromeLine(line) {
-  const t2 = line.trim();
+  const t2 = line.replace(/️/g, "").trim();
   if (!t2) return false;
   if (/^[─━—═─\-]{3,}$/.test(t2)) return true;
   if (SPINNER_RE.test(t2)) return true;
@@ -4578,7 +4680,7 @@ function isChromeLine(line) {
   return false;
 }
 function parseChromeLine(line) {
-  const t2 = line.trim();
+  const t2 = line.replace(/️/g, "").trim();
   if (!t2) return null;
   if (/^[─━—═─\-]{3,}$/.test(t2)) return null;
   if (/^[❯>]\s*$/.test(t2)) return null;
@@ -4982,6 +5084,7 @@ var OutputService = class _OutputService {
     this.pollTimer = setInterval(() => this.tick(), _OutputService.POLL_MS);
   }
   newTurn() {
+    log.trace("outputSvc", "newTurn() \u2014 activating output stream");
     this.stopPoll();
     this.rawBuffer = "";
     this.lastSentContent = "";
@@ -5019,9 +5122,11 @@ var OutputService = class _OutputService {
         const printable2 = raw.replace(/\x1B\[[^@-~]*[@-~]/g, "").replace(/[\x00-\x1F\x7F]/g, "");
         if (printable2.trim()) {
           this.terminalTurnPending = true;
+          log.trace("outputSvc", `terminal-turn detected (idle, ${raw.length}B)`);
           this.onTerminalTurnDetected?.();
         }
       }
+      log.trace("outputSvc", `push dropped (inactive, ${raw.length}B)`);
       return;
     }
     this.rawBuffer += raw;
@@ -5031,6 +5136,10 @@ var OutputService = class _OutputService {
       this.tryExtractSessionId(printable);
       this.tryDetectRateLimit(printable);
     }
+    log.trace(
+      "outputSvc",
+      `push +${raw.length}B (buf=${this.rawBuffer.length}B printable=${printable.trim().length})`
+    );
   }
   /** Extract Claude conversation ID from output text (e.g., from /cost command or session resume) */
   tryExtractSessionId(text) {
@@ -5073,6 +5182,10 @@ var OutputService = class _OutputService {
     const selector = detectSelector(lines) ?? detectListSelector(lines);
     if (selector) {
       const idleMs2 = this.lastPushTime > 0 ? now - this.lastPushTime : elapsed;
+      log.trace(
+        "outputSvc",
+        `tick selector found (idleMs=${idleMs2}, options=${selector.options.length})`
+      );
       if (idleMs2 >= _OutputService.SELECTOR_IDLE_MS) {
         this.stopPoll();
         this.active = false;
@@ -5083,10 +5196,18 @@ var OutputService = class _OutputService {
     }
     const content = filterChrome(lines).join("\n").replace(/\n{3,}/g, "\n\n").trim();
     if (!content) {
+      log.trace(
+        "outputSvc",
+        `tick empty content (raw=${this.rawBuffer.length}B lines=${lines.length} elapsed=${elapsed}ms)`
+      );
       if (elapsed >= _OutputService.EMPTY_TIMEOUT_MS) this.finalize();
       return;
     }
     const idleMs = this.lastPushTime > 0 ? now - this.lastPushTime : elapsed;
+    log.trace(
+      "outputSvc",
+      `tick content (raw=${this.rawBuffer.length}B lines=${lines.length} content=${content.length} idleMs=${idleMs})`
+    );
     if (idleMs >= _OutputService.IDLE_MS) {
       this.finalize();
       return;
@@ -5153,15 +5274,33 @@ var OutputService = class _OutputService {
     if (this.pluginAuthToken) {
       headers["X-Plugin-Auth-Token"] = this.pluginAuthToken;
     }
+    log.trace(
+      "outputSvc",
+      `postChunk type=${body.type ?? "(clear)"} done=${body.done === true} bytes=${payload.length}`
+    );
     return new Promise((resolve2) => {
       const attempt = (attemptsLeft) => {
         _transport2.sendOutputChunk(`${API_BASE4}/api/commands/output`, headers, payload).then(({ statusCode, body: resBody }) => {
+          log.trace("outputSvc", `postChunk status=${statusCode}`);
+          if (statusCode === 410 || statusCode === 404 && /SESSION_NOT_FOUND|SESSION_GONE/.test(resBody)) {
+            if (this.active) {
+              process.stderr.write("[codeam] session was deleted/disconnected \u2014 stopping output stream.\n");
+              this.dispose();
+            }
+            resolve2();
+            return;
+          }
           if (statusCode >= 400) {
             process.stderr.write(`[codeam] output API error ${statusCode}: ${resBody}
 `);
           }
           resolve2();
-        }).catch(() => {
+        }).catch((err) => {
+          log.trace(
+            "outputSvc",
+            `postChunk error (retries left=${attemptsLeft})`,
+            err
+          );
           if (attemptsLeft > 0) {
             const delay = 200 * (maxRetries - attemptsLeft + 1);
             setTimeout(() => attempt(attemptsLeft - 1), delay);
@@ -5220,33 +5359,12 @@ function _sendOutputChunk(url, headers, payload) {
 }
 
 // src/services/history.service.ts
-var fs4 = __toESM(require("fs"));
-var path7 = __toESM(require("path"));
-var os5 = __toESM(require("os"));
+var fs5 = __toESM(require("fs"));
+var path8 = __toESM(require("path"));
+var os6 = __toESM(require("os"));
 var https3 = __toESM(require("https"));
 var http3 = __toESM(require("http"));
 var import_zod = require("zod");
-
-// src/services/logger.ts
-var LEVELS = { silent: 0, error: 1, warn: 2, info: 3, debug: 4 };
-function currentLevel() {
-  const raw = (process.env.CODEAM_LOG ?? "error").toLowerCase();
-  return LEVELS[raw] ?? LEVELS.error;
-}
-function emit(level, tag, msg, err) {
-  if (LEVELS[level] > currentLevel()) return;
-  const detail = err instanceof Error ? `: ${err.message}` : err !== void 0 ? `: ${String(err)}` : "";
-  process.stderr.write(`[codeam:${level}] ${tag} \u2014 ${msg}${detail}
-`);
-}
-var log = {
-  error: (tag, msg, err) => emit("error", tag, msg, err),
-  warn: (tag, msg, err) => emit("warn", tag, msg, err),
-  info: (tag, msg, err) => emit("info", tag, msg, err),
-  debug: (tag, msg, err) => emit("debug", tag, msg, err)
-};
-
-// src/services/history.service.ts
 var historyRecordSchema = import_zod.z.object({
   type: import_zod.z.string().optional(),
   timestamp: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]).optional(),
@@ -5259,7 +5377,25 @@ var historyRecordSchema = import_zod.z.object({
 }).passthrough();
 var API_BASE5 = process.env.CODEAM_API_URL ?? "https://codeagent-mobile-api.vercel.app";
 function encodeCwd(cwd) {
-  return cwd.replace(/\//g, "-");
+  return cwd.replace(/[\\/:]/g, "-");
+}
+function findProjectDir(cwd) {
+  const projectsRoot = path8.join(os6.homedir(), ".claude", "projects");
+  const primary = path8.join(projectsRoot, encodeCwd(cwd));
+  if (fs5.existsSync(primary)) return primary;
+  try {
+    const entries = fs5.readdirSync(projectsRoot, { withFileTypes: true });
+    const wanted = encodeCwd(cwd);
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const candidate = e.name.replace(/-+/g, "-");
+      if (candidate === wanted.replace(/-+/g, "-")) {
+        return path8.join(projectsRoot, e.name);
+      }
+    }
+  } catch {
+  }
+  return null;
 }
 function extractText(content) {
   if (typeof content === "string") return content;
@@ -5273,7 +5409,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs4.readFileSync(filePath, "utf8");
+    raw = fs5.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -5377,7 +5513,7 @@ var HistoryService = class {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return path7.join(os5.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return findProjectDir(this.cwd) ?? path8.join(os6.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -5389,7 +5525,7 @@ var HistoryService = class {
   /** Return the current message count in the active conversation. */
   getCurrentMessageCount() {
     if (!this.currentConversationId) return 0;
-    const filePath = path7.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+    const filePath = path8.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -5400,7 +5536,7 @@ var HistoryService = class {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       if (!this.currentConversationId) return null;
-      const filePath = path7.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+      const filePath = path8.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -5415,15 +5551,15 @@ var HistoryService = class {
   detectCurrentConversation() {
     const dir = this.projectDir;
     try {
-      const files = fs4.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
+      const files = fs5.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
         try {
-          return { name: e.name, mtime: fs4.statSync(path7.join(dir, e.name)).mtimeMs };
+          return { name: e.name, mtime: fs5.statSync(path8.join(dir, e.name)).mtimeMs };
         } catch {
           return { name: e.name, mtime: 0 };
         }
       }).sort((a, b) => b.mtime - a.mtime);
       if (files.length > 0) {
-        this.currentConversationId = path7.basename(files[0].name, ".jsonl");
+        this.currentConversationId = path8.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -5455,13 +5591,13 @@ var HistoryService = class {
     const dir = this.projectDir;
     let entries;
     try {
-      entries = fs4.readdirSync(dir, { withFileTypes: true });
+      entries = fs5.readdirSync(dir, { withFileTypes: true });
     } catch {
       return null;
     }
     const files = entries.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
       try {
-        return { name: e.name, mtime: fs4.statSync(path7.join(dir, e.name)).mtimeMs };
+        return { name: e.name, mtime: fs5.statSync(path8.join(dir, e.name)).mtimeMs };
       } catch {
         return { name: e.name, mtime: 0 };
       }
@@ -5469,12 +5605,12 @@ var HistoryService = class {
     if (files.length === 0) return null;
     const targetFile = this.currentConversationId ? `${this.currentConversationId}.jsonl` : files[0].name;
     if (!files.some((f) => f.name === targetFile)) return null;
-    return this.extractUsageFromFile(path7.join(dir, targetFile));
+    return this.extractUsageFromFile(path8.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs4.readFileSync(filePath, "utf8");
+      raw = fs5.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -5519,9 +5655,9 @@ var HistoryService = class {
     let totalCost = 0;
     let files;
     try {
-      files = fs4.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs5.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs4.statSync(path7.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs5.statSync(path8.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -5532,7 +5668,7 @@ var HistoryService = class {
     for (const file of files) {
       let raw;
       try {
-        raw = fs4.readFileSync(path7.join(projectDir, file), "utf8");
+        raw = fs5.readFileSync(path8.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -5567,23 +5703,23 @@ var HistoryService = class {
     const dir = this.projectDir;
     let entries;
     try {
-      entries = fs4.readdirSync(dir, { withFileTypes: true });
+      entries = fs5.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     const sessions2 = [];
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.endsWith(".jsonl")) continue;
-      const id = path7.basename(entry.name, ".jsonl");
-      const filePath = path7.join(dir, entry.name);
+      const id = path8.basename(entry.name, ".jsonl");
+      const filePath = path8.join(dir, entry.name);
       let mtime = Date.now();
       try {
-        mtime = fs4.statSync(filePath).mtimeMs;
+        mtime = fs5.statSync(filePath).mtimeMs;
       } catch {
       }
       let summary = "";
       try {
-        const raw = fs4.readFileSync(filePath, "utf8");
+        const raw = fs5.readFileSync(filePath, "utf8");
         for (const line of raw.split("\n")) {
           if (!line.trim()) continue;
           try {
@@ -5616,7 +5752,7 @@ var HistoryService = class {
    * showing an empty conversation.
    */
   async loadConversation(sessionId) {
-    const filePath = path7.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path8.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return;
     const totalBatches = Math.ceil(messages.length / CONVERSATION_BATCH_SIZE);
@@ -5671,8 +5807,8 @@ function parsePayload(schema, raw) {
 }
 
 // src/services/file-ops.service.ts
-var fs5 = __toESM(require("fs/promises"));
-var path8 = __toESM(require("path"));
+var fs6 = __toESM(require("fs/promises"));
+var path9 = __toESM(require("path"));
 var MAX_FILE_BYTES = 5 * 1024 * 1024;
 var MAX_WALK_DEPTH = 6;
 var MAX_VISITED_DIRS = 5e3;
@@ -5707,12 +5843,12 @@ var SUBDIR_IGNORE = /* @__PURE__ */ new Set([
   "__pycache__"
 ]);
 function isUnder(parent, candidate) {
-  const rel = path8.relative(parent, candidate);
-  return rel === "" || !rel.startsWith("..") && !path8.isAbsolute(rel);
+  const rel = path9.relative(parent, candidate);
+  return rel === "" || !rel.startsWith("..") && !path9.isAbsolute(rel);
 }
 async function isExistingFile(absPath) {
   try {
-    const stat3 = await fs5.stat(absPath);
+    const stat3 = await fs6.stat(absPath);
     return stat3.isFile();
   } catch {
     return false;
@@ -5725,13 +5861,13 @@ async function walkForSuffix(dir, needleVariants, depth, ctx) {
   ctx.visited++;
   let entries = [];
   try {
-    entries = await fs5.readdir(dir, { withFileTypes: true });
+    entries = await fs6.readdir(dir, { withFileTypes: true });
   } catch {
     return;
   }
   for (const e of entries) {
     if (!e.isFile()) continue;
-    const full = path8.join(dir, e.name);
+    const full = path9.join(dir, e.name);
     if (needleVariants.some((needle) => full.endsWith(needle))) {
       ctx.matches.push(full);
       if (ctx.matches.length >= ctx.cap) return;
@@ -5741,21 +5877,21 @@ async function walkForSuffix(dir, needleVariants, depth, ctx) {
     if (!e.isDirectory()) continue;
     if (SUBDIR_IGNORE.has(e.name)) continue;
     if (e.name.startsWith(".") && SUBDIR_IGNORE.has(e.name)) continue;
-    await walkForSuffix(path8.join(dir, e.name), needleVariants, depth + 1, ctx);
+    await walkForSuffix(path9.join(dir, e.name), needleVariants, depth + 1, ctx);
     if (ctx.matches.length >= ctx.cap) return;
   }
 }
 async function findFile(rawPath) {
   const cwd = process.cwd();
-  if (path8.isAbsolute(rawPath)) {
-    const abs = path8.normalize(rawPath);
+  if (path9.isAbsolute(rawPath)) {
+    const abs = path9.normalize(rawPath);
     if (isUnder(cwd, abs) && await isExistingFile(abs)) return abs;
   }
-  const direct = path8.resolve(cwd, rawPath);
+  const direct = path9.resolve(cwd, rawPath);
   if (isUnder(cwd, direct) && await isExistingFile(direct)) return direct;
-  const normalized = path8.normalize(rawPath).replace(/^[./\\]+/, "");
+  const normalized = path9.normalize(rawPath).replace(/^[./\\]+/, "");
   const needles = [
-    `${path8.sep}${normalized}`,
+    `${path9.sep}${normalized}`,
     `/${normalized}`
   ].filter((v, i, a) => a.indexOf(v) === i);
   const ctx = { visited: 0, matches: [], cap: 16 };
@@ -5769,7 +5905,7 @@ async function findWriteTarget(rawPath) {
   const found = await findFile(rawPath);
   if (found) return found;
   const cwd = process.cwd();
-  const fallback = path8.isAbsolute(rawPath) ? path8.normalize(rawPath) : path8.resolve(cwd, rawPath);
+  const fallback = path9.isAbsolute(rawPath) ? path9.normalize(rawPath) : path9.resolve(cwd, rawPath);
   if (!isUnder(cwd, fallback)) return null;
   return fallback;
 }
@@ -5786,11 +5922,11 @@ async function readProjectFile(rawPath) {
     if (!abs) {
       return { error: `File not found in the project tree: ${rawPath}` };
     }
-    const stat3 = await fs5.stat(abs);
+    const stat3 = await fs6.stat(abs);
     if (stat3.size > MAX_FILE_BYTES) {
       return { error: `File too large (${(stat3.size / 1024 / 1024).toFixed(1)} MB > ${MAX_FILE_BYTES / 1024 / 1024} MB).` };
     }
-    const buf = await fs5.readFile(abs);
+    const buf = await fs6.readFile(abs);
     if (looksBinary(buf)) {
       return { error: "Binary file \u2014 refusing to open in a code editor." };
     }
@@ -5809,8 +5945,8 @@ async function writeProjectFile(rawPath, content) {
     if (Buffer.byteLength(content, "utf-8") > MAX_FILE_BYTES) {
       return { error: "Content too large." };
     }
-    await fs5.mkdir(path8.dirname(abs), { recursive: true });
-    await fs5.writeFile(abs, content, "utf-8");
+    await fs6.mkdir(path9.dirname(abs), { recursive: true });
+    await fs6.writeFile(abs, content, "utf-8");
     return { ok: true };
   } catch (e) {
     const msg = e instanceof Error ? e.message : "Write failed";
@@ -5821,8 +5957,8 @@ async function writeProjectFile(rawPath, content) {
 // src/services/project-ops.service.ts
 var import_child_process4 = require("child_process");
 var import_util = require("util");
-var fs6 = __toESM(require("fs/promises"));
-var path9 = __toESM(require("path"));
+var fs7 = __toESM(require("fs/promises"));
+var path10 = __toESM(require("path"));
 var execFileP = (0, import_util.promisify)(import_child_process4.execFile);
 var PROJECT_IGNORE = /* @__PURE__ */ new Set([
   "node_modules",
@@ -5870,7 +6006,7 @@ async function listProjectFiles(opts = {}) {
     }
     let entries = [];
     try {
-      entries = await fs6.readdir(dir, { withFileTypes: true });
+      entries = await fs7.readdir(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -5880,18 +6016,18 @@ async function listProjectFiles(opts = {}) {
         return;
       }
       if (PROJECT_IGNORE.has(e.name)) continue;
-      const full = path9.join(dir, e.name);
+      const full = path10.join(dir, e.name);
       if (e.isDirectory()) {
         if (depth >= 12) continue;
         await walk(full, depth + 1);
       } else if (e.isFile()) {
-        const rel = path9.relative(root, full);
+        const rel = path10.relative(root, full);
         if (q2 && !rel.toLowerCase().includes(q2) && !e.name.toLowerCase().includes(q2)) {
           continue;
         }
         let size = 0;
         try {
-          const st3 = await fs6.stat(full);
+          const st3 = await fs7.stat(full);
           size = st3.size;
         } catch {
         }
@@ -5993,8 +6129,8 @@ async function gitStatus(cwd) {
   let hasMergeInProgress = false;
   try {
     const gitDir = (await git(["rev-parse", "--git-dir"], root)).stdout.trim();
-    const mergeHead = path9.isAbsolute(gitDir) ? path9.join(gitDir, "MERGE_HEAD") : path9.join(root, gitDir, "MERGE_HEAD");
-    await fs6.access(mergeHead);
+    const mergeHead = path10.isAbsolute(gitDir) ? path10.join(gitDir, "MERGE_HEAD") : path10.join(root, gitDir, "MERGE_HEAD");
+    await fs7.access(mergeHead);
     hasMergeInProgress = true;
   } catch {
   }
@@ -6071,8 +6207,8 @@ async function gitResolve(file, side, cwd) {
 function saveFilesTemp(files) {
   return files.filter(({ base64 }) => base64 && base64.length > 0).map(({ filename, base64 }) => {
     const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
-    const tmpPath = path10.join(os6.tmpdir(), `codeam-${(0, import_crypto.randomUUID)()}-${safeName}`);
-    fs7.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
+    const tmpPath = path11.join(os7.tmpdir(), `codeam-${(0, import_crypto.randomUUID)()}-${safeName}`);
+    fs8.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     return tmpPath;
   });
 }
@@ -6145,8 +6281,8 @@ try:
     sys.exit((st>>8)&0xFF)
 except Exception:sys.exit(0)
 `;
-    const helperPath = path10.join(os6.tmpdir(), "codeam-quota-helper.py");
-    fs7.writeFileSync(helperPath, helperScript, { mode: 420 });
+    const helperPath = path11.join(os7.tmpdir(), "codeam-quota-helper.py");
+    fs8.writeFileSync(helperPath, helperScript, { mode: 420 });
     const python = findInPath("python3") ?? findInPath("python");
     if (!python) {
       quotaFetchInProgress = false;
@@ -6178,7 +6314,7 @@ except Exception:sys.exit(0)
         } catch {
         }
         try {
-          fs7.unlinkSync(helperPath);
+          fs8.unlinkSync(helperPath);
         } catch {
         }
         quotaFetchInProgress = false;
@@ -6228,7 +6364,7 @@ except Exception:sys.exit(0)
           setTimeout(() => {
             for (const p2 of paths) {
               try {
-                fs7.unlinkSync(p2);
+                fs8.unlinkSync(p2);
               } catch {
               }
             }
@@ -6271,6 +6407,25 @@ except Exception:sys.exit(0)
         }
         break;
       }
+      case "session_terminated": {
+        showInfo("Session was deleted from the app \u2014 exiting.");
+        try {
+          claude.kill();
+        } catch {
+        }
+        try {
+          const proc = (0, import_child_process5.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+            detached: true,
+            stdio: "ignore"
+          });
+          proc.unref();
+        } catch {
+        }
+        outputSvc.dispose();
+        relay.stop();
+        ws.disconnect();
+        process.exit(0);
+      }
       case "shutdown_session": {
         try {
           await relay.sendResult(cmd.id, "success", { ok: true });
@@ -6451,7 +6606,7 @@ except Exception:sys.exit(0)
           setTimeout(() => {
             for (const p2 of paths) {
               try {
-                fs7.unlinkSync(p2);
+                fs8.unlinkSync(p2);
               } catch {
               }
             }
@@ -6746,9 +6901,9 @@ async function logout() {
 
 // src/commands/deploy.ts
 var import_child_process10 = require("child_process");
-var fs8 = __toESM(require("fs"));
-var os7 = __toESM(require("os"));
-var path15 = __toESM(require("path"));
+var fs9 = __toESM(require("fs"));
+var os8 = __toESM(require("os"));
+var path16 = __toESM(require("path"));
 var import_util6 = require("util");
 var import_picocolors9 = __toESM(require("picocolors"));
 
@@ -6756,7 +6911,7 @@ var import_picocolors9 = __toESM(require("picocolors"));
 var import_child_process6 = require("child_process");
 var import_util2 = require("util");
 var import_picocolors7 = __toESM(require("picocolors"));
-var path11 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 var execFileP2 = (0, import_util2.promisify)(import_child_process6.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -7245,7 +7400,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path11.posix.dirname(remotePath);
+    const remoteDir = path12.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -7315,7 +7470,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process7 = require("child_process");
 var import_util3 = require("util");
-var path12 = __toESM(require("path"));
+var path13 = __toESM(require("path"));
 var import_picocolors8 = __toESM(require("picocolors"));
 var execFileP3 = (0, import_util3.promisify)(import_child_process7.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -7555,7 +7710,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path12.posix.dirname(remotePath);
+    const remoteDir = path13.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -7591,7 +7746,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process8 = require("child_process");
 var import_util4 = require("util");
-var path13 = __toESM(require("path"));
+var path14 = __toESM(require("path"));
 var execFileP4 = (0, import_util4.promisify)(import_child_process8.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -7851,7 +8006,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
-    const remoteDir = path13.posix.dirname(remotePath);
+    const remoteDir = path14.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote3(remoteDir)}`, `cat > ${shellQuote3(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote3(remotePath)}`);
@@ -7919,7 +8074,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process9 = require("child_process");
 var import_util5 = require("util");
-var path14 = __toESM(require("path"));
+var path15 = __toESM(require("path"));
 var execFileP5 = (0, import_util5.promisify)(import_child_process9.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -8155,7 +8310,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path14.posix.dirname(remotePath);
+    const remoteDir = path15.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote4(remoteDir)}`, `cat > ${shellQuote4(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote4(remotePath)}`);
@@ -8347,7 +8502,7 @@ async function deploy() {
       process.exit(1);
     }
   }
-  const localClaudeDir = path15.join(os7.homedir(), ".claude");
+  const localClaudeDir = path16.join(os8.homedir(), ".claude");
   const localCredsKind = await detectLocalClaudeCredentials(localClaudeDir);
   let bridged = "none";
   if (localCredsKind !== "none") {
@@ -8391,7 +8546,7 @@ async function deploy() {
     process.exit(1);
   }
   claudeStep.stop("\u2713 Claude CLI installed");
-  const haveLocalClaude = fs8.existsSync(localClaudeDir) && fs8.statSync(localClaudeDir).isDirectory();
+  const haveLocalClaude = fs9.existsSync(localClaudeDir) && fs9.statSync(localClaudeDir).isDirectory();
   if (haveLocalClaude) {
     const copyStep = fe();
     copyStep.start("Copying local Claude config to workspace\u2026");
@@ -8445,10 +8600,10 @@ async function deploy() {
     }
   }
   if (bridged !== "none") {
-    const localClaudeJson = path15.join(os7.homedir(), ".claude.json");
-    if (fs8.existsSync(localClaudeJson)) {
+    const localClaudeJson = path16.join(os8.homedir(), ".claude.json");
+    if (fs9.existsSync(localClaudeJson)) {
       try {
-        const contents = fs8.readFileSync(localClaudeJson);
+        const contents = fs9.readFileSync(localClaudeJson);
         await provider.uploadFile(
           workspace.id,
           "/home/codespace/.claude.json",
@@ -8638,7 +8793,7 @@ async function runRemoteClaudeLogin(provider, workspaceId) {
   }
 }
 async function detectLocalClaudeCredentials(localClaudeDir) {
-  if (fs8.existsSync(path15.join(localClaudeDir, ".credentials.json"))) {
+  if (fs9.existsSync(path16.join(localClaudeDir, ".credentials.json"))) {
     return "flat-file";
   }
   if (process.platform === "darwin") {
@@ -8671,8 +8826,8 @@ async function verifyClaudeAuth(provider, workspaceId) {
   }
 }
 async function bridgeClaudeCredentials(provider, workspaceId, localClaudeDir) {
-  const fileBased = path15.join(localClaudeDir, ".credentials.json");
-  if (fs8.existsSync(fileBased)) return "flat-file";
+  const fileBased = path16.join(localClaudeDir, ".credentials.json");
+  if (fs9.existsSync(fileBased)) return "flat-file";
   if (process.platform === "darwin") {
     try {
       const { stdout } = await execFileP6(
@@ -8877,10 +9032,172 @@ async function stopWorkspaceFromLocal(target) {
   }
 }
 
+// src/commands/version.ts
+var import_picocolors11 = __toESM(require("picocolors"));
+function version() {
+  const v = true ? "2.4.34" : "unknown";
+  console.log(`${import_picocolors11.default.bold("codeam-cli")} ${import_picocolors11.default.cyan(v)}`);
+}
+
+// src/commands/help.ts
+var import_picocolors12 = __toESM(require("picocolors"));
+function help() {
+  const lines = [
+    "",
+    `  ${import_picocolors12.default.bold(import_picocolors12.default.magenta("codeam-cli"))}  ${import_picocolors12.default.dim("\u2014 Claude Code remote control")}`,
+    "",
+    `  ${import_picocolors12.default.bold("Usage")}`,
+    `     ${import_picocolors12.default.cyan("codeam")} ${import_picocolors12.default.dim("[command]")}`,
+    "",
+    `  ${import_picocolors12.default.bold("Commands")}`,
+    `     ${import_picocolors12.default.white("codeam")}              ${import_picocolors12.default.dim("start Claude Code with mobile control")}`,
+    `     ${import_picocolors12.default.white("codeam pair")}         ${import_picocolors12.default.dim("pair a new mobile device")}`,
+    `     ${import_picocolors12.default.white("codeam sessions")}     ${import_picocolors12.default.dim("list paired devices")}`,
+    `     ${import_picocolors12.default.white("codeam status")}       ${import_picocolors12.default.dim("show connection info")}`,
+    `     ${import_picocolors12.default.white("codeam logout")}       ${import_picocolors12.default.dim("remove all paired sessions")}`,
+    `     ${import_picocolors12.default.white("codeam deploy")}       ${import_picocolors12.default.dim("provision a cloud workspace (Codespaces) and pair it")}`,
+    `     ${import_picocolors12.default.white("codeam deploy ls")}    ${import_picocolors12.default.dim("list deployed cloud workspaces")}`,
+    `     ${import_picocolors12.default.white("codeam deploy stop")}  ${import_picocolors12.default.dim("stop a deployed workspace session")}`,
+    "",
+    `  ${import_picocolors12.default.bold("Flags")}`,
+    `     ${import_picocolors12.default.white("-v, --version")}       ${import_picocolors12.default.dim("print the CLI version")}`,
+    `     ${import_picocolors12.default.white("-h, --help")}          ${import_picocolors12.default.dim("show this help")}`,
+    "",
+    `  ${import_picocolors12.default.bold("Links")}`,
+    `     ${import_picocolors12.default.dim("Docs:")}     ${import_picocolors12.default.green("https://www.codeagent-mobile.com")}`,
+    `     ${import_picocolors12.default.dim("Issues:")}   ${import_picocolors12.default.green("https://github.com/edgar-durand/codeagent-mobile-clients/issues")}`,
+    ""
+  ];
+  process.stdout.write(lines.join("\n") + "\n");
+}
+
+// src/lib/updateNotifier.ts
+var fs10 = __toESM(require("fs"));
+var os9 = __toESM(require("os"));
+var path17 = __toESM(require("path"));
+var https4 = __toESM(require("https"));
+var import_picocolors13 = __toESM(require("picocolors"));
+var PKG_NAME = "codeam-cli";
+var REGISTRY_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
+var TTL_MS = 24 * 60 * 60 * 1e3;
+var REQUEST_TIMEOUT_MS = 1500;
+function cachePath() {
+  const dir = path17.join(os9.homedir(), ".codeam");
+  return path17.join(dir, "update-check.json");
+}
+function readCache() {
+  try {
+    const raw = fs10.readFileSync(cachePath(), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.fetchedAt !== "number" || typeof parsed.latest !== "string") return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    const file = cachePath();
+    fs10.mkdirSync(path17.dirname(file), { recursive: true });
+    fs10.writeFileSync(file, JSON.stringify(cache));
+  } catch {
+  }
+}
+function compareSemver(a, b) {
+  const stripPre = (s) => s.split("-")[0];
+  const aParts = stripPre(a).split(".").map(Number);
+  const bParts = stripPre(b).split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const ai = aParts[i] ?? 0;
+    const bi = bParts[i] ?? 0;
+    if (Number.isNaN(ai) || Number.isNaN(bi)) return 0;
+    if (ai > bi) return 1;
+    if (ai < bi) return -1;
+  }
+  return 0;
+}
+function fetchLatest() {
+  return new Promise((resolve2) => {
+    const req = https4.get(
+      REGISTRY_URL,
+      { headers: { Accept: "application/json" }, timeout: REQUEST_TIMEOUT_MS },
+      (res) => {
+        if (res.statusCode !== 200) {
+          res.resume();
+          resolve2(null);
+          return;
+        }
+        let buf = "";
+        res.setEncoding("utf8");
+        res.on("data", (chunk) => {
+          buf += chunk;
+        });
+        res.on("end", () => {
+          try {
+            const json = JSON.parse(buf);
+            if (typeof json.version === "string") {
+              resolve2(json.version);
+            } else {
+              resolve2(null);
+            }
+          } catch {
+            resolve2(null);
+          }
+        });
+      }
+    );
+    req.on("timeout", () => {
+      req.destroy();
+      resolve2(null);
+    });
+    req.on("error", () => resolve2(null));
+  });
+}
+function notifyIfStale(currentVersion, latest) {
+  if (compareSemver(latest, currentVersion) <= 0) return;
+  const arrow = import_picocolors13.default.dim("\u2192");
+  const cmd = import_picocolors13.default.cyan("npm install -g codeam-cli");
+  const lines = [
+    "",
+    `  ${import_picocolors13.default.yellow("\u25CF")} ${import_picocolors13.default.bold("Update available")} ${import_picocolors13.default.dim(currentVersion)} ${arrow} ${import_picocolors13.default.green(latest)}`,
+    `    Run ${cmd} to upgrade.`,
+    ""
+  ];
+  process.stderr.write(lines.join("\n"));
+}
+function checkForUpdates() {
+  if (process.env.NODE_ENV === "test") return;
+  if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
+  if (process.env.CI) return;
+  if (!process.stdout.isTTY) return;
+  const current = true ? "2.4.34" : null;
+  if (!current) return;
+  const cache = readCache();
+  const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
+  if (fresh && cache) {
+    notifyIfStale(current, cache.latest);
+    return;
+  }
+  void fetchLatest().then((latest) => {
+    if (!latest) return;
+    writeCache({ fetchedAt: Date.now(), latest });
+  });
+}
+
 // src/index.ts
 var [, , command, ...args] = process.argv;
 async function main() {
+  const isMetaCommand = command === "--version" || command === "-v" || command === "version" || command === "--help" || command === "-h" || command === "help";
+  if (!isMetaCommand) checkForUpdates();
   switch (command) {
+    case "--version":
+    case "-v":
+    case "version":
+      return version();
+    case "--help":
+    case "-h":
+    case "help":
+      return help();
     case "pair":
       return pair();
     case "sessions":