@alan-ai-hq/agent-manager 0.1.113 → 0.1.115

package/dist/sleep-inhibitor.js

@@ -0,0 +1,297 @@
+// Block system sleep while the daemon runs; best-effort, self-healing, never outlive this process.
+// macOS `-s` is AC-only (man caffeinate); battery+lid sleep needs wake-recovery, not userspace asserts.
+import { spawn } from "node:child_process";
+export const SLEEP_PREVENTION_DISABLED_ENV = "ALAN_DISABLE_SLEEP_PREVENTION";
+const HEALTH_CHECK_INTERVAL_MS = 30_000;
+const noopLog = () => { };
+export function isSleepPreventionDisabled(env = process.env) {
+    const raw = env[SLEEP_PREVENTION_DISABLED_ENV];
+    if (raw === undefined)
+        return false;
+    const normalized = raw.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+class ChildProcessBackend {
+    child = null;
+    // ENOENT: stop respawn storms when the binary is absent.
+    unavailable = false;
+    log;
+    constructor(log) {
+        this.log = log;
+    }
+    onUnexpectedTermination() { }
+    isHealthy() {
+        if (this.unavailable)
+            return true; // nothing to heal; already degraded and logged
+        const child = this.child;
+        return child !== null && child.exitCode === null && child.signalCode === null;
+    }
+    acquire() {
+        if (this.unavailable)
+            return;
+        if (this.isHealthy() && this.child !== null)
+            return;
+        this.child = null;
+        const command = this.command();
+        if (command === null) {
+            this.unavailable = true;
+            this.log(`sleep-inhibitor ${this.name} unavailable: no supported command`);
+            return;
+        }
+        let child;
+        try {
+            child = spawn(command.file, command.args, { stdio: "ignore", detached: false });
+        }
+        catch (error) {
+            this.unavailable = true;
+            this.log(`sleep-inhibitor ${this.name} spawn threw: ${describeError(error)}`);
+            return;
+        }
+        child.on("error", (error) => {
+            const wasActiveChild = this.child === child;
+            if (wasActiveChild)
+                this.child = null;
+            if (error.code === "ENOENT")
+                this.unavailable = true;
+            this.log(`sleep-inhibitor ${this.name} failed: ${describeError(error)}`);
+            if (wasActiveChild)
+                this.onUnexpectedTermination();
+        });
+        child.on("exit", (code, signal) => {
+            const wasActiveChild = this.child === child;
+            if (wasActiveChild)
+                this.child = null;
+            this.log(`sleep-inhibitor ${this.name} exited code=${code} signal=${signal}`);
+            if (wasActiveChild)
+                this.onUnexpectedTermination();
+        });
+        this.child = child;
+        this.log(`sleep-inhibitor ${this.name} acquired pid=${child.pid}`);
+    }
+    release() {
+        const child = this.child;
+        if (child === null)
+            return;
+        this.child = null;
+        try {
+            child.kill("SIGTERM");
+        }
+        catch (error) {
+            this.log(`sleep-inhibitor ${this.name} release failed: ${describeError(error)}`);
+        }
+    }
+}
+// `-w <pid>` drops the assert on process exit, including SIGKILL.
+class MacCaffeinateBackend extends ChildProcessBackend {
+    name = "caffeinate";
+    command() {
+        return { file: "/usr/bin/caffeinate", args: ["-i", "-s", "-w", String(process.pid)] };
+    }
+}
+class LinuxIdleInhibitBackend extends ChildProcessBackend {
+    name = "systemd-inhibit";
+    candidateIndex = 0;
+    candidateCount = 2;
+    command() {
+        const guard = `while kill -0 ${process.pid} 2>/dev/null; do sleep 5; done`;
+        const candidates = [
+            {
+                file: "systemd-inhibit",
+                args: [
+                    "--what=idle:sleep",
+                    "--mode=block",
+                    "--who=alan-agent",
+                    "--why=Alan is running an active agent run",
+                    "--",
+                    "sh",
+                    "-c",
+                    guard,
+                ],
+            },
+            {
+                file: "gnome-session-inhibit",
+                args: [
+                    "--inhibit",
+                    "idle",
+                    "--reason",
+                    "Alan is running an active agent run",
+                    "sh",
+                    "-c",
+                    guard,
+                ],
+            },
+        ];
+        return candidates[this.candidateIndex] ?? null;
+    }
+    acquire() {
+        // Advance past a candidate that proved missing, then retry the next one.
+        const before = this.candidateIndex;
+        super.acquire();
+        if (this.unavailable && this.candidateIndex === before) {
+            this.tryNextCandidate();
+        }
+    }
+    onUnexpectedTermination() {
+        // `systemd-inhibit` can exist but still exit immediately when logind's
+        // system D-Bus is unavailable (containers, remote sessions, or partial
+        // desktop environments). Treat that the same as a missing binary and try
+        // the session-level GNOME inhibitor immediately.
+        this.tryNextCandidate();
+    }
+    tryNextCandidate() {
+        this.candidateIndex += 1;
+        if (this.candidateIndex >= this.candidateCount)
+            return;
+        this.unavailable = false;
+        super.acquire();
+    }
+}
+/**
+ * Windows: a hidden PowerShell helper calling `SetThreadExecutionState`.
+ *
+ * `ES_CONTINUOUS | ES_SYSTEM_REQUIRED` (0x80000001) is the same request the
+ * daemon's own process would make if Node could call the Win32 API directly;
+ * P/Invoke via `Add-Type` is the subprocess-reachable equivalent, matching the
+ * macOS/Linux backends above. The state is scoped to the calling thread, so
+ * Windows clears it the instant this helper process exits — no separate
+ * release step is needed on top of killing the child, mirroring the `-w`/
+ * `kill -0` orphan guards on the other platforms.
+ *
+ * This only runs when nothing else already holds a Windows sleep assertion
+ * for this daemon (see `createPlatformBackends`) — the desktop app's Electron
+ * `powerSaveBlocker` covers the common case, and duplicating it would just
+ * spawn a redundant `powershell.exe` per run for no additional protection.
+ */
+class WindowsPowerRequestBackend extends ChildProcessBackend {
+    name = "windows-power-request";
+    command() {
+        const guard = `while (Get-Process -Id ${process.pid} -ErrorAction SilentlyContinue) ` +
+            "{ Start-Sleep -Seconds 5 }";
+        const script = [
+            "Add-Type -Namespace Alan -Name Power -MemberDefinition " +
+                "'[DllImport(\"kernel32.dll\")] public static extern uint SetThreadExecutionState(uint esFlags);';",
+            "[Alan.Power]::SetThreadExecutionState(0x80000001) | Out-Null;",
+            guard,
+        ].join(" ");
+        return {
+            file: "powershell.exe",
+            args: ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", script],
+        };
+    }
+}
+const externalBackends = new Set();
+export function registerSleepInhibitorBackend(backend) {
+    externalBackends.add(backend);
+    return () => {
+        externalBackends.delete(backend);
+    };
+}
+function createPlatformBackends(log, hasExternalBackend) {
+    switch (process.platform) {
+        case "darwin":
+            return [new MacCaffeinateBackend(log)];
+        case "linux":
+            return [new LinuxIdleInhibitBackend(log)];
+        case "win32":
+            // Headless daemon only: desktop registers powerSaveBlocker externally.
+            return hasExternalBackend ? [] : [new WindowsPowerRequestBackend(log)];
+        default:
+            return [];
+    }
+}
+export class SleepInhibitor {
+    backends;
+    log;
+    enabled;
+    active = false;
+    healthTimer = null;
+    exitHandler = null;
+    disposed = false;
+    constructor(options = {}) {
+        this.log = options.log ?? noopLog;
+        this.enabled = !isSleepPreventionDisabled(options.env ?? process.env);
+        this.backends = this.enabled
+            ? [...createPlatformBackends(this.log, externalBackends.size > 0), ...externalBackends]
+            : [];
+        if (!this.enabled) {
+            this.log(`sleep-inhibitor disabled via ${SLEEP_PREVENTION_DISABLED_ENV}`);
+        }
+    }
+    isActive() {
+        return this.active;
+    }
+    backendNames() {
+        return this.backends.map((backend) => backend.name);
+    }
+    setActive(active) {
+        if (this.disposed)
+            return;
+        if (this.active === active) {
+            if (active)
+                this.healBackends();
+            return;
+        }
+        this.active = active;
+        if (active)
+            this.start();
+        else
+            this.stop();
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.active = false;
+        this.stop();
+    }
+    start() {
+        if (this.backends.length === 0)
+            return;
+        this.healBackends();
+        if (this.healthTimer === null) {
+            this.healthTimer = setInterval(() => this.healBackends(), HEALTH_CHECK_INTERVAL_MS);
+            this.healthTimer.unref?.();
+        }
+        if (this.exitHandler === null) {
+            this.exitHandler = () => {
+                for (const backend of this.backends)
+                    backend.release();
+            };
+            process.on("exit", this.exitHandler);
+        }
+    }
+    stop() {
+        if (this.healthTimer !== null) {
+            clearInterval(this.healthTimer);
+            this.healthTimer = null;
+        }
+        if (this.exitHandler !== null) {
+            process.removeListener("exit", this.exitHandler);
+            this.exitHandler = null;
+        }
+        for (const backend of this.backends) {
+            try {
+                backend.release();
+            }
+            catch (error) {
+                this.log(`sleep-inhibitor release error: ${describeError(error)}`);
+            }
+        }
+    }
+    healBackends() {
+        for (const backend of this.backends) {
+            try {
+                if (backend.isHealthy())
+                    continue;
+                backend.acquire();
+            }
+            catch (error) {
+                this.log(`sleep-inhibitor ${backend.name} acquire error: ${describeError(error)}`);
+            }
+        }
+    }
+}
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=sleep-inhibitor.js.map

package/dist/sleep-inhibitor.js.map

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

package/dist/suspension-detector.d.ts

@@ -0,0 +1,24 @@
+export interface SuspensionDetectorOptions {
+    onSuspensionDetected: (gapMs: number) => void;
+    checkIntervalMs?: number;
+    thresholdMs?: number;
+    now?: () => number;
+    setIntervalFn?: typeof setInterval;
+    clearIntervalFn?: typeof clearInterval;
+}
+export declare class SuspensionDetector {
+    private readonly onSuspensionDetected;
+    private readonly checkIntervalMs;
+    private readonly thresholdMs;
+    private readonly now;
+    private readonly setIntervalFn;
+    private readonly clearIntervalFn;
+    private timer;
+    private lastTickAtMs;
+    constructor(options: SuspensionDetectorOptions);
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+    private tick;
+}
+//# sourceMappingURL=suspension-detector.d.ts.map

package/dist/suspension-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspension-detector.d.ts","sourceRoot":"","sources":["../src/suspension-detector.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,WAAW,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,aAAa,CAAC;CACxC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0B;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAuB;gBAE/B,OAAO,EAAE,yBAAyB;IAS9C,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAOZ,SAAS,IAAI,OAAO;IAIpB,OAAO,CAAC,IAAI;CAiBb"}

package/dist/suspension-detector.js

@@ -0,0 +1,59 @@
+// Missed timer ticks imply host suspension; report after reconnect so watchdog grants grace.
+const DEFAULT_CHECK_INTERVAL_MS = 15_000;
+// 60s overshoot ignores timer coalescing; shorter gaps are inside the watchdog window anyway.
+const DEFAULT_THRESHOLD_MS = 60_000;
+export class SuspensionDetector {
+    onSuspensionDetected;
+    checkIntervalMs;
+    thresholdMs;
+    now;
+    setIntervalFn;
+    clearIntervalFn;
+    timer = null;
+    lastTickAtMs = null;
+    constructor(options) {
+        this.onSuspensionDetected = options.onSuspensionDetected;
+        this.checkIntervalMs = options.checkIntervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
+        this.thresholdMs = options.thresholdMs ?? DEFAULT_THRESHOLD_MS;
+        this.now = options.now ?? Date.now;
+        this.setIntervalFn = options.setIntervalFn ?? setInterval;
+        this.clearIntervalFn = options.clearIntervalFn ?? clearInterval;
+    }
+    start() {
+        if (this.timer !== null)
+            return;
+        this.lastTickAtMs = this.now();
+        this.timer = this.setIntervalFn(() => this.tick(), this.checkIntervalMs);
+        // Detection must never be the reason the process stays alive.
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer === null)
+            return;
+        this.clearIntervalFn(this.timer);
+        this.timer = null;
+        this.lastTickAtMs = null;
+    }
+    isRunning() {
+        return this.timer !== null;
+    }
+    tick() {
+        const nowMs = this.now();
+        const previousMs = this.lastTickAtMs;
+        this.lastTickAtMs = nowMs;
+        if (previousMs === null)
+            return;
+        // Overshoot beyond the scheduled cadence, i.e. time the process was not running.
+        const overshootMs = nowMs - previousMs - this.checkIntervalMs;
+        if (overshootMs < this.thresholdMs)
+            return;
+        try {
+            this.onSuspensionDetected(overshootMs);
+        }
+        catch {
+            // A reporting failure must never break the detection loop; the next
+            // suspension still gets reported.
+        }
+    }
+}
+//# sourceMappingURL=suspension-detector.js.map

package/dist/suspension-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspension-detector.js","sourceRoot":"","sources":["../src/suspension-detector.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEzC,8FAA8F;AAC9F,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAWpC,MAAM,OAAO,kBAAkB;IACZ,oBAAoB,CAA0B;IAC9C,eAAe,CAAS;IACxB,WAAW,CAAS;IACpB,GAAG,CAAe;IAClB,aAAa,CAAqB;IAClC,eAAe,CAAuB;IAC/C,KAAK,GAA0C,IAAI,CAAC;IACpD,YAAY,GAAkB,IAAI,CAAC;IAE3C,YAAY,OAAkC;QAC5C,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;QACzD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;QAC5E,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC/D,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,WAAW,CAAC;QAC1D,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,aAAa,CAAC;IAClE,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACzE,8DAA8D;QAC7D,IAAI,CAAC,KAAgC,CAAC,KAAK,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAChC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7B,CAAC;IAEO,IAAI;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO;QAEhC,iFAAiF;QACjF,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;QAC9D,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW;YAAE,OAAO;QAE3C,IAAI,CAAC;YACH,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,kCAAkC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export * from "@alan-ai/shared/agent";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export * from "@alan-ai/shared/agent";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const AGENT_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,QAA6C,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const AGENT_VERSION = process.env.__AGENT_VERSION__ ?? "0.1.107";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,CAAC"}

package/dist/web-presenter.d.ts

@@ -0,0 +1,52 @@
+import type { AgentActivityEvidence, AgentConfig, AgentPresenter, AgentResult, ExitPlanModeInput, GeneratedImagePayload, SessionMediaPayload, UsageUpdate } from "./types.js";
+import type { WSClient } from "./ws-client.js";
+export declare class WebPresenter implements AgentPresenter {
+    private readonly conversationId;
+    private readonly cwd?;
+    pendingAskUserToolIds?: Set<string>;
+    private wsClient;
+    private readonly emittedGeneratedImageKeys;
+    private readonly emittedSessionMediaKeys;
+    private readonly toolNamesById;
+    private readonly toolInputsById;
+    private readonly browserRecordingPathHints;
+    private suppressSessionLifecycle;
+    private runId;
+    private backendKind;
+    private applicationProblem;
+    private terminalEmitted;
+    constructor(wsClient: WSClient, conversationId: string, cwd?: string | undefined);
+    setSuppressSessionLifecycle(suppress: boolean): void;
+    setRunContext(runId: string | undefined, backendKind?: string): void;
+    onStart(config: AgentConfig): void;
+    onLog(message: string): void;
+    onNotice(kind: string, message: string): void;
+    onAssistantText(text: string, parentToolUseId?: string | null): void;
+    onThinking(text: string, parentToolUseId?: string | null): void;
+    hasKnownToolUse(toolId: string): boolean;
+    onToolUse(tool: string, input: unknown, toolId: string, parentToolUseId?: string | null): void;
+    onToolResult(toolId: string, content: string, isError?: boolean, parentToolUseId?: string | null): void;
+    onGeneratedImage(image: GeneratedImagePayload): void;
+    private emitGeneratedImage;
+    onSessionMedia(media: SessionMediaPayload): void;
+    private emitSessionMedia;
+    onTurnComplete(content: unknown[]): void;
+    onUsageUpdate(usage: UsageUpdate): void;
+    onAskUser(id: string, questions: unknown[]): void;
+    onTodoWrite(todos: unknown[]): void;
+    onExitPlanMode(id: string, input: ExitPlanModeInput, planFilePath?: string): void;
+    onCheckpoint(id: string): void;
+    onActivity(status: string, evidence?: AgentActivityEvidence): void;
+    onOpenBrowserTab(browserId: string, url?: string): void;
+    recordRawTranscript(): void;
+    onError(message: string, isAgentError?: boolean): void;
+    onApplicationError(input: {
+        code: ApplicationProblemCode;
+        message: string;
+        diagnostic?: string;
+    }): void;
+    onComplete(result: AgentResult): void;
+    emitSessionEnd(result: AgentResult): Promise<void>;
+}
+import { type ApplicationProblemCode } from "@alan-ai/shared/agent";
+//# sourceMappingURL=web-presenter.d.ts.map

package/dist/web-presenter.d.ts.map

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