agent-office-cli 0.1.5 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-office-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Run and manage AI agent sessions locally, with optional relay to agentoffice.top",
   "license": "MIT",
   "engines": {

package/src/index.js

@@ -19,6 +19,7 @@ const {
   createPtyManager,
   defaultTransportForProvider,
   ensureNodePtySpawnHelper,
+  startSleepInhibitor,
   listSessionRecords,
   removeSessionRecord,
   applyClaudeHookConfig,
@@ -172,6 +173,13 @@ async function main() {
       throw new Error("tmux is required for AgentOffice local sessions. Install it first, for example with `brew install tmux`.");
     }
 
+    const sleepInhibitor = startSleepInhibitor({ commandExists });
+    if (sleepInhibitor.started) {
+      console.log("- sleep guard: caffeinate active");
+    } else if (process.platform === "darwin") {
+      console.log("- sleep guard: skipped (caffeinate unavailable)");
+    }
+
     const store = createSessionStore();
     const ptyManager = createPtyManager({ store });
     const restored = ptyManager.restoreManagedSessions();

package/src/runtime/index.js

@@ -18,6 +18,7 @@ const {
   removeSessionRecord
 } = require("./session-registry");
 const { ensureNodePtySpawnHelper } = require("./ensure-node-pty");
+const { startSleepInhibitor } = require("./sleep-inhibitor");
 const {
   applyClaudeHookConfig,
   claudeSettingsPath,
@@ -45,6 +46,7 @@ module.exports = {
   persistSessionRecord,
   removeSessionRecord,
   ensureNodePtySpawnHelper,
+  startSleepInhibitor,
   applyClaudeHookConfig,
   claudeSettingsPath,
   commandExists,

package/src/runtime/sleep-inhibitor.js

@@ -0,0 +1,31 @@
+const { spawn } = require("node:child_process");
+
+function startSleepInhibitor({
+  pid = process.pid,
+  platform = process.platform,
+  commandExists = () => true,
+  spawn: spawnProcess = spawn
+} = {}) {
+  if (platform !== "darwin") {
+    return { started: false, reason: "unsupported_platform" };
+  }
+
+  if (!commandExists("caffeinate")) {
+    return { started: false, reason: "missing_command" };
+  }
+
+  const child = spawnProcess("caffeinate", ["-dimsu", "-w", String(pid)], {
+    stdio: "ignore"
+  });
+  child.unref?.();
+
+  return {
+    started: true,
+    reason: "started",
+    child
+  };
+}
+
+module.exports = {
+  startSleepInhibitor
+};

package/src/runtime/sleep-inhibitor.test.js

@@ -0,0 +1,63 @@
+const test = require("node:test");
+const assert = require("node:assert/strict");
+
+const { startSleepInhibitor } = require("./sleep-inhibitor");
+
+test("startSleepInhibitor starts caffeinate by default on macOS", () => {
+  const calls = [];
+  const child = {
+    unrefCalled: false,
+    unref() {
+      this.unrefCalled = true;
+    }
+  };
+
+  const result = startSleepInhibitor({
+    pid: 4321,
+    platform: "darwin",
+    commandExists: (command) => command === "caffeinate",
+    spawn: (command, args, options) => {
+      calls.push({ command, args, options });
+      return child;
+    }
+  });
+
+  assert.deepEqual(calls, [
+    {
+      command: "caffeinate",
+      args: ["-dimsu", "-w", "4321"],
+      options: { stdio: "ignore" }
+    }
+  ]);
+  assert.equal(child.unrefCalled, true);
+  assert.equal(result.started, true);
+  assert.equal(result.reason, "started");
+});
+
+test("startSleepInhibitor skips non-macOS platforms", () => {
+  const result = startSleepInhibitor({
+    pid: 4321,
+    platform: "linux",
+    commandExists: () => true,
+    spawn: () => {
+      throw new Error("spawn should not be called");
+    }
+  });
+
+  assert.equal(result.started, false);
+  assert.equal(result.reason, "unsupported_platform");
+});
+
+test("startSleepInhibitor skips when caffeinate is unavailable", () => {
+  const result = startSleepInhibitor({
+    pid: 4321,
+    platform: "darwin",
+    commandExists: () => false,
+    spawn: () => {
+      throw new Error("spawn should not be called");
+    }
+  });
+
+  assert.equal(result.started, false);
+  assert.equal(result.reason, "missing_command");
+});