codeam-cli 2.23.12 → 2.23.14

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `codeam-cli` are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.23.12] — 2026-05-27
+
+### Fixed
+
+- **cli:** Auto-enable codespace keep-alive on start
+
 ## [2.23.11] — 2026-05-27
 
 ### Fixed

package/dist/index.js

@@ -441,7 +441,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.23.12",
+  version: "2.23.14",
   description: "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device \u2014 async. The terminal companion for CodeAgent Mobile.",
   type: "commonjs",
   main: "dist/index.js",
@@ -5774,7 +5774,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.23.12" : "0.0.0-dev",
+    cliVersion: true ? "2.23.14" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5869,14 +5869,16 @@ var API_BASE2 = resolveApiBaseUrl();
 var SSE_LIVENESS_TIMEOUT_MS = 45e3;
 var SSE_WATCHDOG_INTERVAL_MS = 1e4;
 var CommandRelayService = class {
-  constructor(pluginId, onCommand, agentMeta) {
+  constructor(pluginId, onCommand, agentMeta, agentsOverride) {
     this.pluginId = pluginId;
     this.onCommand = onCommand;
     this.agentMeta = agentMeta;
+    this.agentsOverride = agentsOverride;
   }
   pluginId;
   onCommand;
   agentMeta;
+  agentsOverride;
   _running = false;
   heartbeatTimer = null;
   agentsTimer = null;
@@ -6142,16 +6144,17 @@ var CommandRelayService = class {
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   reportAgents() {
+    const agents = this.agentsOverride ? [...this.agentsOverride] : [
+      {
+        id: this.agentMeta.id,
+        name: this.agentMeta.displayName,
+        icon: this.agentMeta.id,
+        installed: true
+      }
+    ];
     _postJson(`${API_BASE2}/api/plugin/agents`, {
       pluginId: this.pluginId,
-      agents: [
-        {
-          id: this.agentMeta.id,
-          name: this.agentMeta.displayName,
-          icon: this.agentMeta.id,
-          installed: true
-        }
-      ]
+      agents
     }).then(() => {
       this.agentsRegistered = true;
     }).catch(() => {
@@ -16169,6 +16172,157 @@ async function autoLinkAfterPair(opts) {
 var fs28 = __toESM(require("fs"));
 var os24 = __toESM(require("os"));
 var import_crypto7 = require("crypto");
+
+// src/commands/start-infra-only.ts
+var INFRA_ONLY_COMMAND_TYPES = /* @__PURE__ */ new Set([
+  // File ops (drive the dashboard's Files panel + open-file).
+  "read_file",
+  "write_file",
+  "list_files",
+  "search_files",
+  // IDE terminal — the user opens a shell inside the codespace
+  // from the dashboard. Independent of any agent.
+  "terminal_open",
+  "terminal_write",
+  "terminal_resize",
+  "terminal_close",
+  // Git surface — repo browsing / commit / push from the
+  // dashboard. Calls plain `git`, no agent involved.
+  "git_status",
+  "git_diff",
+  "git_diff_staged",
+  "git_log",
+  "git_commit",
+  "git_push",
+  "git_pull",
+  "git_resolve",
+  // Review apply path (dashboard's per-file review surface).
+  "apply_file_review",
+  // CLI-side handoff for `codeam link <agent>` (claims tokens
+  // for the user's LinkedAgents from inside the codespace).
+  "request_link_credentials",
+  // Lets the dashboard toggle the codespace idle-timeout
+  // (defaults to 240 min inside a codespace).
+  "set_keep_alive"
+]);
+async function startInfraOnly(agentId) {
+  const session = getActiveSession();
+  if (!session?.pluginId) {
+    throw new Error("startInfraOnly: no active session found in config");
+  }
+  const pluginId = session.pluginId;
+  const cwd = process.cwd();
+  const agentMeta = AGENT_REGISTRY[agentId];
+  if (!agentMeta) {
+    throw new Error(`startInfraOnly: unknown agent id "${agentId}"`);
+  }
+  const keepAliveCtx = {
+    inCodespace: process.env.CODESPACES === "true",
+    codespaceName: process.env.CODESPACE_NAME
+  };
+  const { apply: setKeepAlive2 } = buildKeepAlive(keepAliveCtx);
+  if (keepAliveCtx.inCodespace) {
+    setKeepAlive2(true);
+  }
+  const fileWatcher = session.pluginAuthToken ? new FileWatcherService({
+    workingDir: cwd,
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken
+  }) : null;
+  let relayRef = null;
+  const ctx = {
+    // Agent-touching fields are not used by any of the commands
+    // we dispatch in this mode. Casting through `unknown` keeps
+    // TypeScript happy without forcing a HandlerContext refactor
+    // — the field-touching commands are filtered out by
+    // INFRA_ONLY_COMMAND_TYPES before the handler is even called.
+    agent: null,
+    outputSvc: null,
+    historySvc: null,
+    runtime: null,
+    relay: null,
+    setKeepAlive: setKeepAlive2,
+    keepAliveCtx,
+    pluginId,
+    sessionId: session.id,
+    pluginAuthToken: session.pluginAuthToken ?? void 0
+  };
+  const relay = new CommandRelayService(
+    pluginId,
+    async (cmd) => {
+      if (!INFRA_ONLY_COMMAND_TYPES.has(cmd.type)) {
+        log.trace("infra-only", `dropping agent-only command type=${cmd.type}`);
+        return;
+      }
+      const handler = handlers[cmd.type];
+      if (!handler) {
+        log.trace("infra-only", `no handler registered for type=${cmd.type}`);
+        return;
+      }
+      const parsed = parsePayload2(startCommandSchema, cmd.payload);
+      if (!parsed) {
+        log.trace("infra-only", `malformed payload for type=${cmd.type}`);
+        return;
+      }
+      try {
+        await handler(ctx, cmd, parsed);
+      } catch (err) {
+        log.warn("infra-only", `handler ${cmd.type} threw`, err);
+      }
+    },
+    agentMeta,
+    []
+    // empty agents list → dashboard renders NoAgentHero
+  );
+  ctx.relay = relay;
+  relayRef = relay;
+  const terminalEmitter = new ChunkEmitter({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken
+  });
+  registerTerminalHandlers({
+    onData: ({ sessionId: termSessionId, data }) => {
+      void terminalEmitter.send({
+        type: "terminal_data",
+        terminalSessionId: termSessionId,
+        data,
+        done: false
+      });
+    },
+    onExit: ({ sessionId: termSessionId, exitCode }) => {
+      void terminalEmitter.send({
+        type: "terminal_exit",
+        terminalSessionId: termSessionId,
+        exitCode,
+        done: true
+      });
+    }
+  });
+  relay.start();
+  if (fileWatcher) {
+    fileWatcher.start().catch(() => {
+    });
+  }
+  const sigHandler = () => {
+    try {
+      relayRef?.stop();
+    } catch {
+    }
+    void fileWatcher?.stop();
+    closeAllTerminals();
+    cleanupAttachmentTempFiles();
+    process.exit(0);
+  };
+  process.once("SIGINT", sigHandler);
+  process.once("SIGTERM", sigHandler);
+  process.once("SIGHUP", sigHandler);
+  await new Promise(() => {
+  });
+}
+
+// src/commands/pair-auto.ts
 var API_BASE8 = resolveApiBaseUrl();
 function fail(msg) {
   console.error(`
@@ -16317,6 +16471,7 @@ async function pairAuto(args2) {
     console.log(
       "  Skipping agent launch \u2014 install an agent from the dashboard to start chatting."
     );
+    await startInfraOnly(claimed.agent);
     return;
   }
   console.log("  Starting agent loop\u2026");
@@ -18565,7 +18720,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.23.12" : "0.0.0-dev";
+  const cliVersion = true ? "2.23.14" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto5.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -18764,7 +18919,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.23.12" : "unknown";
+  const v = true ? "2.23.14" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -18992,7 +19147,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current = true ? "2.23.12" : null;
+  const current = true ? "2.23.14" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.23.12",
+  "version": "2.23.14",
   "description": "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device — async. The terminal companion for CodeAgent Mobile.",
   "type": "commonjs",
   "main": "dist/index.js",