@aiden-ade/sandbox-agent 0.1.59 → 0.1.60

package/dist/service-manager.js

@@ -0,0 +1,259 @@
+import { spawnSync } from "node:child_process";
+import { chmodSync, mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { configExistsAtPath, resolveAgentConfigPath, resolveEndpointProfileFromArgs, } from "./runtime-config.js";
+const SERVICE_LABEL = "ai.tryalan.agent";
+const SYSTEMD_UNIT = "alan-agent.service";
+const WINDOWS_TASK = "Alan Agent";
+function xml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+function systemdArg(value) {
+    return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+function powershellLiteral(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+export function buildDaemonServicePlan(input) {
+    const daemonArgs = [input.nodeExecutable, input.cliEntry, "daemon", "--profile", input.profile];
+    if (input.platform === "darwin") {
+        const userId = input.userId ?? process.getuid?.();
+        if (userId === undefined)
+            throw new Error("Cannot determine the current macOS user ID");
+        const domain = `gui/${userId}`;
+        const serviceTarget = `${domain}/${SERVICE_LABEL}`;
+        const manifestPath = join(input.homeDir, "Library", "LaunchAgents", `${SERVICE_LABEL}.plist`);
+        const logDir = join(input.homeDir, ".alan", "agent", "logs");
+        const programArguments = daemonArgs.map((arg) => `    <string>${xml(arg)}</string>`).join("\n");
+        const manifest = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${SERVICE_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${programArguments}
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>ThrottleInterval</key>
+  <integer>5</integer>
+  <key>StandardOutPath</key>
+  <string>${xml(join(logDir, "daemon.log"))}</string>
+  <key>StandardErrorPath</key>
+  <string>${xml(join(logDir, "daemon-error.log"))}</string>
+</dict>
+</plist>
+`;
+        return {
+            manifestPath,
+            manifest,
+            installCommands: [
+                {
+                    command: "launchctl",
+                    args: ["bootout", domain, manifestPath],
+                    tolerateFailure: true,
+                },
+                {
+                    command: "launchctl",
+                    args: ["bootstrap", domain, manifestPath],
+                    tolerateFailure: false,
+                },
+                {
+                    command: "launchctl",
+                    args: ["kickstart", "-k", serviceTarget],
+                    tolerateFailure: false,
+                },
+            ],
+            uninstallCommands: [
+                {
+                    command: "launchctl",
+                    args: ["bootout", domain, manifestPath],
+                    tolerateFailure: true,
+                },
+            ],
+            statusCommand: {
+                command: "launchctl",
+                args: ["print", serviceTarget],
+                tolerateFailure: false,
+            },
+        };
+    }
+    if (input.platform === "linux") {
+        const manifestPath = join(input.homeDir, ".config", "systemd", "user", SYSTEMD_UNIT);
+        const manifest = `[Unit]
+Description=Alan local agent daemon
+After=network-online.target
+Wants=network-online.target
+StartLimitIntervalSec=300
+StartLimitBurst=3
+
+[Service]
+Type=simple
+ExecStart=${daemonArgs.map(systemdArg).join(" ")}
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+`;
+        return {
+            manifestPath,
+            manifest,
+            installCommands: [
+                {
+                    command: "systemctl",
+                    args: ["--user", "daemon-reload"],
+                    tolerateFailure: false,
+                },
+                {
+                    command: "systemctl",
+                    args: ["--user", "enable", "--now", SYSTEMD_UNIT],
+                    tolerateFailure: false,
+                },
+            ],
+            uninstallCommands: [
+                {
+                    command: "systemctl",
+                    args: ["--user", "disable", "--now", SYSTEMD_UNIT],
+                    tolerateFailure: true,
+                },
+                {
+                    command: "systemctl",
+                    args: ["--user", "daemon-reload"],
+                    tolerateFailure: false,
+                },
+            ],
+            statusCommand: {
+                command: "systemctl",
+                args: ["--user", "status", SYSTEMD_UNIT, "--no-pager"],
+                tolerateFailure: false,
+            },
+        };
+    }
+    const executable = powershellLiteral(input.nodeExecutable);
+    const argument = powershellLiteral([input.cliEntry, "daemon", "--profile", input.profile]
+        .map((part) => (part.includes(" ") ? `"${part}"` : part))
+        .join(" "));
+    const installScript = [
+        `$action = New-ScheduledTaskAction -Execute ${executable} -Argument ${argument}`,
+        "$trigger = New-ScheduledTaskTrigger -AtLogOn",
+        "$settings = New-ScheduledTaskSettingsSet -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1) -ExecutionTimeLimit ([TimeSpan]::Zero)",
+        `Register-ScheduledTask -TaskName ${powershellLiteral(WINDOWS_TASK)} -Action $action -Trigger $trigger -Settings $settings -Force | Out-Null`,
+        `Start-ScheduledTask -TaskName ${powershellLiteral(WINDOWS_TASK)}`,
+    ].join("; ");
+    return {
+        manifestPath: null,
+        manifest: null,
+        installCommands: [
+            {
+                command: "powershell.exe",
+                args: ["-NoProfile", "-NonInteractive", "-Command", installScript],
+                tolerateFailure: false,
+            },
+        ],
+        uninstallCommands: [
+            {
+                command: "powershell.exe",
+                args: [
+                    "-NoProfile",
+                    "-NonInteractive",
+                    "-Command",
+                    `Unregister-ScheduledTask -TaskName ${powershellLiteral(WINDOWS_TASK)} -Confirm:$false -ErrorAction SilentlyContinue`,
+                ],
+                tolerateFailure: true,
+            },
+        ],
+        statusCommand: {
+            command: "powershell.exe",
+            args: [
+                "-NoProfile",
+                "-NonInteractive",
+                "-Command",
+                `Get-ScheduledTask -TaskName ${powershellLiteral(WINDOWS_TASK)} | Format-List TaskName,State`,
+            ],
+            tolerateFailure: false,
+        },
+    };
+}
+function currentServicePlan(args) {
+    const currentPlatform = platform();
+    if (currentPlatform !== "darwin" && currentPlatform !== "linux" && currentPlatform !== "win32") {
+        throw new Error(`Daemon service installation is not supported on ${currentPlatform}`);
+    }
+    const profile = resolveEndpointProfileFromArgs(args);
+    const cliEntry = process.argv[1];
+    if (!cliEntry)
+        throw new Error("Cannot determine the alan-agent executable path");
+    return buildDaemonServicePlan({
+        platform: currentPlatform,
+        homeDir: homedir(),
+        nodeExecutable: process.execPath,
+        cliEntry: resolve(cliEntry),
+        profile,
+    });
+}
+function writeManifest(path, contents) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const pendingPath = `${path}.pending-${process.pid}`;
+    try {
+        writeFileSync(pendingPath, contents, { mode: 0o600 });
+        chmodSync(pendingPath, 0o600);
+        renameSync(pendingPath, path);
+    }
+    finally {
+        rmSync(pendingPath, { force: true });
+    }
+}
+function runServiceCommand(command) {
+    const result = spawnSync(command.command, command.args, { encoding: "utf8" });
+    const status = result.status ?? 1;
+    const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
+    if (status !== 0 && !command.tolerateFailure) {
+        throw new Error(`Service command failed (${command.command} ${command.args.join(" ")}): ${output || `exit ${status}`}`);
+    }
+    return { status, output };
+}
+export function installDaemonService(args = []) {
+    const profile = resolveEndpointProfileFromArgs(args);
+    const configPath = resolveAgentConfigPath({ profile });
+    if (!configExistsAtPath(configPath)) {
+        throw new Error(`No ${profile} runtime is configured. Run alan-agent setup or login first.`);
+    }
+    const plan = currentServicePlan(args);
+    if (plan.manifestPath && plan.manifest) {
+        if (platform() === "darwin") {
+            mkdirSync(join(homedir(), ".alan", "agent", "logs"), { recursive: true, mode: 0o700 });
+        }
+        writeManifest(plan.manifestPath, plan.manifest);
+    }
+    for (const command of plan.installCommands)
+        runServiceCommand(command);
+    console.info("[alan-agent] Per-user daemon service installed", { profile });
+}
+export function uninstallDaemonService(args = []) {
+    const plan = currentServicePlan(args);
+    for (const command of plan.uninstallCommands)
+        runServiceCommand(command);
+    if (plan.manifestPath)
+        rmSync(plan.manifestPath, { force: true });
+    console.info("[alan-agent] Per-user daemon service removed");
+}
+export function printDaemonServiceStatus(args = []) {
+    const plan = currentServicePlan(args);
+    const result = runServiceCommand(plan.statusCommand);
+    process.stdout.write(`${result.output}\n`);
+}
+//# sourceMappingURL=service-manager.js.map

package/dist/service-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-manager.js","sourceRoot":"","sources":["../src/service-manager.ts"],"names":[],"mappings":"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"}

package/dist/sleep-inhibitor.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Cross-platform sleep prevention for the duration of active local agent runs.
+ *
+ * Why this exists: a local run executes in-process with the daemon. When the
+ * machine idle-sleeps, the socket, the runtime heartbeat and the provider CLI
+ * all freeze together; the backend watchdog then fails the run as "Agent
+ * unresponsive". Holding an OS-level sleep assertion while at least one run is
+ * active removes the most common cause of that failure.
+ *
+ * Design constraints learned the hard way:
+ *
+ * - **Never throw, never reject a run.** Sleep prevention is best-effort. A
+ *   missing `caffeinate`/`systemd-inhibit` binary, a sandboxed environment, or
+ *   a spawn failure must degrade to "machine may sleep", never to a failed run.
+ * - **Self-heal.** The helper process can die mid-run (OOM, user kill, session
+ *   teardown). Acquiring once at run start is not enough, so a low-frequency
+ *   watchdog re-checks and respawns while runs are active.
+ * - **Never outlive the daemon.** A leaked `caffeinate` keeps a laptop awake
+ *   forever, which is a far worse bug than the one being fixed. Every backend
+ *   is tied to this process's lifetime by the OS itself (see below), in
+ *   addition to explicit release.
+ *
+ * Platform coverage:
+ *
+ * | Platform | Mechanism                                            |
+ * |----------|------------------------------------------------------|
+ * | macOS    | `caffeinate -i -s -w <pid>`                           |
+ * | Linux    | `systemd-inhibit`, falling back to `gnome-session-inhibit` |
+ * | Windows  | desktop: Electron's `powerSaveBlocker`, registered externally. Standalone/headless daemon (e.g. installed as a Windows Scheduled Task via service-manager.ts): a PowerShell `SetThreadExecutionState` helper, used only when nothing else is already registered |
+ *
+ * `-w <pid>` (macOS) and the `kill -0`/`Get-Process` guard loops (Linux,
+ * Windows) make the OS release the assertion when *this* process exits, even
+ * on SIGKILL where no JS cleanup handler can run. That is the Node-reachable
+ * equivalent of the `PR_SET_PDEATHSIG` guard the Codex sleep-inhibitor uses.
+ *
+ * Known limitation: on macOS the `-s` assertion is only honoured while the
+ * machine is on AC power (see `man caffeinate`). A laptop on battery with the
+ * lid closed will still sleep, and no userspace assertion can prevent that.
+ * Surviving that case is the job of wake-recovery, not of this module.
+ */
+/**
+ * Set to `1`/`true` to disable sleep prevention entirely. An escape hatch for
+ * users who would rather have their machine sleep than have runs survive.
+ */
+export declare const SLEEP_PREVENTION_DISABLED_ENV = "ALAN_DISABLE_SLEEP_PREVENTION";
+/**
+ * A single OS-level "keep the machine awake" mechanism.
+ *
+ * Implementations must be idempotent: `acquire()` on an already-held assertion
+ * is a no-op, and `release()` on a released one is a no-op.
+ */
+export interface SleepInhibitorBackend {
+    readonly name: string;
+    /** Take the assertion. Must not throw. */
+    acquire(): void;
+    /** Drop the assertion. Must not throw. */
+    release(): void;
+    /** False when the assertion was expected to be held but is not (e.g. helper died). */
+    isHealthy(): boolean;
+}
+type Logger = (message: string) => void;
+export declare function isSleepPreventionDisabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Register an additional backend. Returns a disposer that unregisters it.
+ *
+ * Registration must happen before the daemon starts to affect its inhibitor;
+ * inhibitors snapshot the registry at construction time.
+ */
+export declare function registerSleepInhibitorBackend(backend: SleepInhibitorBackend): () => void;
+/**
+ * Holds an OS sleep assertion while `setActive(true)` is in effect.
+ *
+ * Mirrors the Codex `SleepInhibitor` contract: idempotent, self-healing, and
+ * silent on platforms where nothing is available.
+ */
+export declare class SleepInhibitor {
+    private readonly backends;
+    private readonly log;
+    private readonly enabled;
+    private active;
+    private healthTimer;
+    private exitHandler;
+    private disposed;
+    constructor(options?: {
+        log?: Logger;
+        env?: NodeJS.ProcessEnv;
+    });
+    isActive(): boolean;
+    /** Names of the backends this inhibitor will drive. Exposed for diagnostics. */
+    backendNames(): string[];
+    /**
+     * Turn sleep prevention on or off. Safe to call repeatedly with the same
+     * value; only edges do work.
+     */
+    setActive(active: boolean): void;
+    /** Release everything and detach timers/handlers. Idempotent. */
+    dispose(): void;
+    private start;
+    private stop;
+    /**
+     * Acquire anything not currently held. This is the self-healing step: a
+     * backend whose helper died is respawned here.
+     *
+     * Healthy backends are skipped rather than re-acquired, so concurrent runs
+     * can never stack assertions even if a backend's own `acquire()` is not
+     * defensively idempotent.
+     */
+    private healBackends;
+}
+export {};
+//# sourceMappingURL=sleep-inhibitor.d.ts.map

package/dist/sleep-inhibitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-inhibitor.d.ts","sourceRoot":"","sources":["../src/sleep-inhibitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH;;;GAGG;AACH,eAAO,MAAM,6BAA6B,kCAAkC,CAAC;AAK7E;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAC;IAChB,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAC;IAChB,sFAAsF;IACtF,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAIxC,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAKvF;AA8ND;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAKxF;AAmBD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAO;IAWnE,QAAQ,IAAI,OAAO;IAInB,gFAAgF;IAChF,YAAY,IAAI,MAAM,EAAE;IAIxB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAahC,iEAAiE;IACjE,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,IAAI;IAkBZ;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAUrB"}