@monotykamary/localterm-server 1.21.0 → 1.23.0

package/dist/constants.d.ts

@@ -9,6 +9,11 @@ export declare const COLORTERM_VALUE = "truecolor";
 export declare const LOCALTERM_VALUE = "1";
 export declare const CAFFEINATE_BINARY = "caffeinate";
 export declare const CAFFEINATE_ARGS: readonly string[];
+export declare const CAFFEINATE_AUTO_DEFAULT_COMMANDS: readonly string[];
+export declare const CAFFEINATE_PREFERENCES_FILE_VERSION = 1;
+export declare const CAFFEINATE_AUTO_POKE_DEBOUNCE_MS = 150;
+export declare const MAX_CAFFEINATE_COMMANDS = 50;
+export declare const MAX_CAFFEINATE_COMMAND_LENGTH = 128;
 export declare const TITLE_MAX_PATH_SEGMENTS = 1;
 /**
  * Strip terminal-emulator identity env vars inherited from the daemon's parent.
@@ -57,7 +62,7 @@ export declare const MAX_AUTOMATIONS = 100;
 export declare const MAX_AUTOMATION_NAME_LENGTH = 120;
 export declare const MAX_AUTOMATION_COMMAND_LENGTH = 4096;
 export declare const MAX_CRON_EXPRESSION_LENGTH = 256;
-export declare const AUTOMATIONS_FILE_VERSION = 2;
+export declare const AUTOMATIONS_FILE_VERSION = 3;
 export declare const AUTOMATION_RUN_LIMIT_MAX = 100000;
 export declare const AUTOMATION_RUN_HISTORY_CAP = 50;
 export declare const AUTOMATION_DOWNTIME_RECONCILE_CAP = 10;
@@ -67,6 +72,7 @@ export declare const AUTOMATION_RECONCILE_LOOKBACK_MS: number;
 export declare const DAEMON_HEARTBEAT_FILE_VERSION = 1;
 export declare const AUTOMATION_TICK_ALIGNMENT_DELAY_MS = 50;
 export declare const AUTOMATION_PENDING_RUN_EXPIRY_MS: number;
+export declare const AUTOMATION_WATCH_DEBOUNCE_MS = 500;
 export declare const CRON_NEXT_OCCURRENCE_SCAN_LIMIT_DAYS = 1466;
 export declare const MAX_AUTOMATION_EXIT_CODE_DIGITS = 4;
 export declare const WS_READY_STATE_OPEN = 1;

package/dist/constants.d.ts.map

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

package/dist/constants.js

@@ -11,6 +11,23 @@ export const LOCALTERM_VALUE = "1";
 // sleep — held for as long as the spawned process lives.
 export const CAFFEINATE_BINARY = "caffeinate";
 export const CAFFEINATE_ARGS = ["-dims"];
+// Keep-awake "automatic" mode recognizes these commands out of the box and
+// caffeinates whenever one is running in any localterm session. Fixed — the
+// user can add their own on top but cannot remove these.
+export const CAFFEINATE_AUTO_DEFAULT_COMMANDS = [
+    "claude",
+    "codex",
+    "opencode",
+    "pi",
+];
+export const CAFFEINATE_PREFERENCES_FILE_VERSION = 1;
+// Automatic detection is event-driven (no timer): a `ps` snapshot is taken only
+// in response to a foreground change or a session connect/disconnect. This
+// debounce window coalesces a burst of such events into a single snapshot; it
+// fires once and does not repeat.
+export const CAFFEINATE_AUTO_POKE_DEBOUNCE_MS = 150;
+export const MAX_CAFFEINATE_COMMANDS = 50;
+export const MAX_CAFFEINATE_COMMAND_LENGTH = 128;
 export const TITLE_MAX_PATH_SEGMENTS = 1;
 /**
  * Strip terminal-emulator identity env vars inherited from the daemon's parent.
@@ -129,9 +146,11 @@ export const MAX_AUTOMATION_COMMAND_LENGTH = 4096;
 export const MAX_CRON_EXPRESSION_LENGTH = 256;
 // v1 stored a raw cron string + a single lastRun. v2 stores a structured
 // schedule (with a derived cron computed on the fly), a run-count limit, a
-// lifecycle, and a capped run-history array. AutomationStore.load() migrates
-// v1 -> v2 in place on first boot so existing automations are never lost.
-export const AUTOMATIONS_FILE_VERSION = 2;
+// lifecycle, and a capped run-history array. v3 wraps the schedule in a
+// top-level `trigger` union so an automation can fire on a schedule OR when a
+// folder changes. AutomationStore.load() migrates v1/v2 -> v3 in place on first
+// boot so existing automations are never lost.
+export const AUTOMATIONS_FILE_VERSION = 3;
 // Largest "stop after N runs" budget. Generous — a limit is opt-in; the common
 // case is "forever".
 export const AUTOMATION_RUN_LIMIT_MAX = 100_000;
@@ -159,6 +178,11 @@ export const AUTOMATION_TICK_ALIGNMENT_DELAY_MS = 50;
 // A launched run that no browser tab claims within this window is marked
 // "missed" (browser closed, headless host, open() failed silently).
 export const AUTOMATION_PENDING_RUN_EXPIRY_MS = 5 * 60 * 1000;
+// Quiet period after the last filesystem event before a folder-watch trigger
+// fires. Coalesces an event storm (one editor save emits several events; a
+// build emits thousands) into a single run. Trailing-edge: the timer resets on
+// every event and fires once the directory settles.
+export const AUTOMATION_WATCH_DEBOUNCE_MS = 500;
 // Covers schedules that only fire on Feb 29 (the rarest valid cron target).
 export const CRON_NEXT_OCCURRENCE_SCAN_LIMIT_DAYS = 1466;
 export const MAX_AUTOMATION_EXIT_CODE_DIGITS = 4;

package/dist/constants.js.map

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

package/dist/folder-watch-manager.d.ts

@@ -0,0 +1,33 @@
+import { EventEmitter } from "node:events";
+import type { Automation } from "./types.js";
+interface FolderWatchManagerEvents {
+    due: [automation: Automation];
+}
+interface WatchHandle {
+    close: () => void;
+    unref?: () => void;
+}
+type WatchFn = (target: string, options: {
+    recursive: boolean;
+}, listener: () => void) => WatchHandle;
+interface FolderWatchManagerOptions {
+    debounceMs: number;
+    isRunInFlight: (automationId: string) => boolean;
+    getAutomation: (automationId: string) => Automation | null;
+    watch?: WatchFn;
+}
+export declare class FolderWatchManager extends EventEmitter<FolderWatchManagerEvents> {
+    private readonly options;
+    private readonly entries;
+    private readonly watch;
+    private disposed;
+    constructor(options: FolderWatchManagerOptions);
+    sync(automations: Automation[]): void;
+    dispose(): void;
+    private startEntry;
+    private onFsEvent;
+    private fire;
+    private stopEntry;
+}
+export {};
+//# sourceMappingURL=folder-watch-manager.d.ts.map

package/dist/folder-watch-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-watch-manager.d.ts","sourceRoot":"","sources":["../src/folder-watch-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,UAAU,wBAAwB;IAChC,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;CAC/B;AAGD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAID,KAAK,OAAO,GAAG,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,EAC/B,QAAQ,EAAE,MAAM,IAAI,KACjB,WAAW,CAAC;AAEjB,UAAU,yBAAyB;IAIjC,UAAU,EAAE,MAAM,CAAC;IAInB,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;IAIjD,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC;IAG3D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAkBD,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,wBAAwB,CAAC;IAKhE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAS;gBAEI,OAAO,EAAE,yBAAyB;IAS/D,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI;IAoBrC,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,SAAS;CAgBlB"}

package/dist/folder-watch-manager.js

@@ -0,0 +1,129 @@
+import { EventEmitter } from "node:events";
+import fs from "node:fs";
+const signatureOf = (automation) => automation.trigger.kind === "watch"
+    ? `${automation.trigger.recursive}:${automation.cwd}`
+    : automation.cwd;
+// Event-driven folder triggers for automations: one native fs.watch per "watch"
+// automation, on its cwd. No polling — mirrors GitDiffWatcher. A burst of events
+// is coalesced by a trailing debounce, and a launch is suppressed while a prior
+// run is still in-flight (at most one run per automation at a time).
+export class FolderWatchManager extends EventEmitter {
+    options;
+    entries = new Map();
+    watch;
+    disposed = false;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.watch =
+            options.watch ??
+                ((target, watchOptions, listener) => fs.watch(target, watchOptions, () => listener()));
+    }
+    // Reconcile the live watchers with the desired set (enabled + active + watch).
+    // Idempotent and cheap, so it can be called after any automation mutation.
+    sync(automations) {
+        if (this.disposed)
+            return;
+        const desired = new Map();
+        for (const automation of automations) {
+            if (!automation.enabled)
+                continue;
+            if (automation.lifecycle !== "active")
+                continue;
+            if (automation.trigger.kind !== "watch")
+                continue;
+            desired.set(automation.id, automation);
+        }
+        // Stop watchers that are no longer desired or whose target changed.
+        for (const [id, entry] of this.entries) {
+            const automation = desired.get(id);
+            if (!automation || signatureOf(automation) !== entry.signature)
+                this.stopEntry(id);
+        }
+        // Start watchers for newly-desired (or just-rebuilt) automations.
+        for (const [id, automation] of desired) {
+            if (!this.entries.has(id))
+                this.startEntry(automation);
+        }
+    }
+    dispose() {
+        this.disposed = true;
+        for (const id of [...this.entries.keys()])
+            this.stopEntry(id);
+        this.removeAllListeners();
+    }
+    startEntry(automation) {
+        if (automation.trigger.kind !== "watch")
+            return;
+        const { recursive } = automation.trigger;
+        const entry = {
+            watchers: [],
+            signature: signatureOf(automation),
+            debounceTimer: null,
+        };
+        try {
+            const watcher = this.watch(automation.cwd, { recursive }, () => {
+                this.onFsEvent(automation.id);
+            });
+            // Don't keep the daemon alive on the watch alone (the http server does).
+            watcher.unref?.();
+            entry.watchers.push(watcher);
+        }
+        catch {
+            // cwd doesn't exist or isn't watchable right now — leave the entry empty;
+            // a later sync (after the directory is fixed) retries.
+        }
+        this.entries.set(automation.id, entry);
+    }
+    onFsEvent(automationId) {
+        if (this.disposed)
+            return;
+        const entry = this.entries.get(automationId);
+        if (!entry)
+            return;
+        if (entry.debounceTimer !== null)
+            clearTimeout(entry.debounceTimer);
+        entry.debounceTimer = setTimeout(() => {
+            entry.debounceTimer = null;
+            this.fire(automationId);
+        }, this.options.debounceMs);
+        entry.debounceTimer.unref?.();
+    }
+    fire(automationId) {
+        if (this.disposed)
+            return;
+        if (!this.entries.has(automationId))
+            return;
+        // No overlap: drop this change if a run is still in-flight. The next event
+        // after it settles re-arms, so writes made *during* the run are ignored.
+        if (this.options.isRunInFlight(automationId))
+            return;
+        // Re-read live state — the automation may have been disabled, hit its limit,
+        // or switched to a schedule while the debounce was pending.
+        const automation = this.options.getAutomation(automationId);
+        if (!automation || !automation.enabled || automation.lifecycle !== "active")
+            return;
+        if (automation.trigger.kind !== "watch")
+            return;
+        this.emit("due", automation);
+    }
+    stopEntry(automationId) {
+        const entry = this.entries.get(automationId);
+        if (!entry)
+            return;
+        if (entry.debounceTimer !== null) {
+            clearTimeout(entry.debounceTimer);
+            entry.debounceTimer = null;
+        }
+        for (const watcher of entry.watchers) {
+            try {
+                watcher.close();
+            }
+            catch {
+                /* already closed */
+            }
+        }
+        this.entries.delete(automationId);
+    }
+}
+//# sourceMappingURL=folder-watch-manager.js.map

package/dist/folder-watch-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-watch-manager.js","sourceRoot":"","sources":["../src/folder-watch-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,SAAS,CAAC;AA8CzB,MAAM,WAAW,GAAG,CAAC,UAAsB,EAAU,EAAE,CACrD,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;IACjC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,GAAG,EAAE;IACrD,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;AAErB,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,qEAAqE;AACrE,MAAM,OAAO,kBAAmB,SAAQ,YAAsC;IAK/C;IAJZ,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,KAAK,CAAU;IACxB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAA6B,OAAkC;QAC7D,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAA2B;QAE7D,IAAI,CAAC,KAAK;YACR,OAAO,CAAC,KAAK;gBACb,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,+EAA+E;IAC/E,2EAA2E;IAC3E,IAAI,CAAC,WAAyB;QAC5B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC9C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,SAAS;YAClC,IAAI,UAAU,CAAC,SAAS,KAAK,QAAQ;gBAAE,SAAS;YAChD,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS;YAClD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;QACD,oEAAoE;QACpE,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,UAAU,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,SAAS;gBAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,kEAAkE;QAClE,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAEO,UAAU,CAAC,UAAsB;QACvC,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QAChD,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;QACzC,MAAM,KAAK,GAAe;YACxB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC;YAClC,aAAa,EAAE,IAAI;SACpB,CAAC;QACF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE;gBAC7D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,yEAAyE;YACzE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,uDAAuD;QACzD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAEO,SAAS,CAAC,YAAoB;QACpC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI;YAAE,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACpE,KAAK,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YACpC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5B,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC;IAChC,CAAC;IAEO,IAAI,CAAC,YAAoB;QAC/B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,OAAO;QAC5C,2EAA2E;QAC3E,yEAAyE;QACzE,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC;YAAE,OAAO;QACrD,6EAA6E;QAC7E,4DAA4D;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO;QACpF,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QAChD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IAEO,SAAS,CAAC,YAAoB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YACjC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAClC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,oBAAoB;YACtB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { CaffeinateController } from "./caffeinate-controller.js";
+import type { SnapshotProcesses } from "./caffeinate-process-match.js";
 import { SessionRegistry } from "./session-registry.js";
 export interface ServerOptions {
     port?: number;
@@ -19,6 +20,12 @@ export interface ServerOptions {
      * power assertion.
      */
     caffeinateController?: CaffeinateController;
+    /**
+     * Override how automatic-mode keep-awake inspects running processes. Defaults
+     * to a real `ps` snapshot. Injectable so tests can drive automatic detection
+     * deterministically without spawning processes.
+     */
+    caffeinateSnapshotProcesses?: SnapshotProcesses;
 }
 /** Opens and (optionally) closes the browser tab for an automation run. */
 export interface AutomationTabController {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAwClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAkBxD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,0EAA0E;IAC1E,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AA+DD,eAAO,MAAM,YAAY,GAAU,UAAS,aAAkB,KAAG,OAAO,CAAC,aAAa,CAkyBrF,CAAC;AAEF,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AA0CvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAkBxD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,iBAAiB,CAAC;CACjD;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,0EAA0E;IAC1E,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AA+DD,eAAO,MAAM,YAAY,GAAU,UAAS,aAAkB,KAAG,OAAO,CAAC,aAAa,CA41BrF,CAAC;AAEF,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -10,9 +10,12 @@ import { AutomationRunTracker } from "./automation-run-tracker.js";
 import { AutomationScheduler } from "./automation-scheduler.js";
 import { AutomationStore } from "./automation-store.js";
 import { CaffeinateController } from "./caffeinate-controller.js";
+import { CaffeinateManager } from "./caffeinate-manager.js";
+import { CaffeinatePreferencesStore } from "./caffeinate-preferences-store.js";
 import { CdpClient } from "./cdp/cdp-client.js";
-import { AUTOMATION_RECONCILE_MIN_DOWNTIME_MS, DEFAULT_HOST, DEFAULT_PORT, FRIENDLY_HOSTNAME, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_CREATED, HTTP_STATUS_NOT_FOUND, MAX_AUTOMATIONS, MAX_CONCURRENT_SESSIONS, MS_PER_MINUTE, OUTPUT_BATCH_FLUSH_BYTES, OUTPUT_BATCH_WINDOW_MS, SERVER_STOP_GRACE_MS, WS_BACKPRESSURE_THRESHOLD_BYTES, WS_CLOSE_BACKPRESSURE, WS_CLOSE_CAPACITY_REACHED, WS_CLOSE_POLICY_VIOLATION, WS_HEARTBEAT_INTERVAL_MS, WS_HEARTBEAT_TIMEOUT_MS, WS_OUTBOUND_DRAIN_POLL_MS, WS_OUTBOUND_PAUSE_HIGH_WATER_BYTES, WS_OUTBOUND_RESUME_LOW_WATER_BYTES, WS_READY_STATE_OPEN, } from "./constants.js";
+import { AUTOMATION_RECONCILE_MIN_DOWNTIME_MS, AUTOMATION_WATCH_DEBOUNCE_MS, DEFAULT_HOST, DEFAULT_PORT, FRIENDLY_HOSTNAME, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_CREATED, HTTP_STATUS_NOT_FOUND, MAX_AUTOMATIONS, MAX_CONCURRENT_SESSIONS, MS_PER_MINUTE, OUTPUT_BATCH_FLUSH_BYTES, OUTPUT_BATCH_WINDOW_MS, SERVER_STOP_GRACE_MS, WS_BACKPRESSURE_THRESHOLD_BYTES, WS_CLOSE_BACKPRESSURE, WS_CLOSE_CAPACITY_REACHED, WS_CLOSE_POLICY_VIOLATION, WS_HEARTBEAT_INTERVAL_MS, WS_HEARTBEAT_TIMEOUT_MS, WS_OUTBOUND_DRAIN_POLL_MS, WS_OUTBOUND_PAUSE_HIGH_WATER_BYTES, WS_OUTBOUND_RESUME_LOW_WATER_BYTES, WS_READY_STATE_OPEN, } from "./constants.js";
 import { ServerErrorException, serverError } from "./errors.js";
+import { FolderWatchManager } from "./folder-watch-manager.js";
 import { getGitDiff, getGitDiffFilePatch, getGitDiffFiles, getGitDiffSummary } from "./git-diff.js";
 import { GitDiffWatcher } from "./git-diff-watcher.js";
 import { HeartbeatStore } from "./heartbeat-store.js";
@@ -22,7 +25,7 @@ import { Session } from "./session.js";
 import { createNetworkPolicyMiddleware, isAllowedSourceIp, isLoopbackHost } from "./security.js";
 import { SessionRegistry } from "./session-registry.js";
 import { resolveStaticAsset } from "./static-resolver.js";
-import { compileSchedule, compileScheduleAll, normalizeScheduleInput, } from "./utils/compile-schedule.js";
+import { compileSchedule, compileScheduleAll, normalizeTriggerInput, } from "./utils/compile-schedule.js";
 import { computeNextAutomationRunAt } from "./utils/compute-next-automation-run-at.js";
 import { enumerateMissedOccurrences } from "./utils/reconcile-downtime.js";
 const getRawBufferedAmount = (raw) => {
@@ -102,8 +105,27 @@ export const createServer = async (options = {}) => {
     const automationStore = new AutomationStore(path.join(stateDirectory, "automations.json"));
     const automationRunTracker = new AutomationRunTracker();
     const automationScheduler = new AutomationScheduler(automationStore);
+    // Folder-watch triggers: one fs.watch per watch automation's cwd (no polling).
+    // isRunInFlight gates overlap (a launched/running latest run blocks a new
+    // launch); getAutomation re-reads live state when the debounce fires.
+    const folderWatchManager = new FolderWatchManager({
+        debounceMs: AUTOMATION_WATCH_DEBOUNCE_MS,
+        isRunInFlight: (automationId) => {
+            const status = automationStore.get(automationId)?.runs[0]?.status;
+            return status === "launched" || status === "running";
+        },
+        getAutomation: (automationId) => automationStore.get(automationId),
+    });
+    const syncFolderWatchers = () => folderWatchManager.sync(automationStore.list());
     const heartbeatStore = new HeartbeatStore(path.join(stateDirectory, "daemon-heartbeat.json"));
     const caffeinateController = options.caffeinateController ?? new CaffeinateController();
+    const caffeinatePreferencesStore = new CaffeinatePreferencesStore(path.join(stateDirectory, "caffeinate.json"));
+    const caffeinateManager = new CaffeinateManager({
+        controller: caffeinateController,
+        store: caffeinatePreferencesStore,
+        listSessionPids: () => registry.pids(),
+        snapshotProcesses: options.caffeinateSnapshotProcesses,
+    });
     const clientSockets = new Set();
     const cdpBackgroundTabsDisabled = process.env.LOCALTERM_DISABLE_CDP_TABS === "1";
     // One persistent CDP socket for the daemon's lifetime — opened once at start
@@ -153,7 +175,7 @@ export const createServer = async (options = {}) => {
     const toAutomationWithNextRun = (automation, from) => ({
         ...automation,
         nextRunAt: computeNextAutomationRunAt(automation, from),
-        cron: compileSchedule(automation.schedule),
+        cron: automation.trigger.kind === "schedule" ? compileSchedule(automation.trigger.schedule) : null,
         lastRun: deriveLastRun(automation),
     });
     const listAutomationsWithNextRun = () => {
@@ -171,29 +193,32 @@ export const createServer = async (options = {}) => {
     };
     const caffeinateStatePayload = () => ({
         type: "caffeinate",
-        active: caffeinateController.active,
-        supported: caffeinateController.supported,
+        supported: caffeinateManager.supported,
+        active: caffeinateManager.active,
+        mode: caffeinateManager.mode,
+        defaultCommands: [...caffeinateManager.defaultCommands],
+        commands: caffeinateManager.commands,
     });
     // The daemon owns the single keep-awake process, so its state is broadcast to
-    // every tab — exactly like automations — and the coffee toggles stay in sync.
+    // every tab — exactly like automations — and the coffee controls stay in sync.
     const broadcastCaffeinate = () => {
         const payload = caffeinateStatePayload();
         for (const clientSocket of clientSockets) {
             safeSend(clientSocket, payload);
         }
     };
-    caffeinateController.on("change", broadcastCaffeinate);
-    // Open a browser tab for a run and record it in history. Scheduled launches
-    // count toward the limit (and can finish the automation); manual launches
-    // never count and are allowed even on a finished/disabled automation.
+    caffeinateManager.on("change", broadcastCaffeinate);
+    // Open a browser tab for a run and record it in history. Scheduled and watch
+    // launches count toward the limit (and can finish the automation); manual
+    // launches never count and are allowed even on a finished/disabled automation.
     const tryLaunch = (automation, trigger) => {
-        if (trigger === "schedule") {
+        if (trigger !== "manual") {
             const current = automationStore.get(automation.id);
             if (!current || !current.enabled || current.lifecycle === "finished")
                 return null;
         }
         const run = automationRunTracker.create(automation);
-        const counts = trigger === "schedule";
+        const counts = trigger !== "manual";
         automationStore.appendRun(automation.id, {
             runId: run.runId,
             scheduledFor: trigger === "schedule"
@@ -209,6 +234,9 @@ export const createServer = async (options = {}) => {
         if (counts)
             automationStore.incrementRunCount(automation.id);
         broadcastAutomations();
+        // A watch automation that just reached its limit is now "finished"; stop
+        // watching its folder promptly instead of waiting for the next mutation.
+        syncFolderWatchers();
         const runUrl = `http://${FRIENDLY_HOSTNAME}:${actualPort}/?run=${run.runId}`;
         void tabController
             .open(runUrl)
@@ -335,10 +363,17 @@ export const createServer = async (options = {}) => {
             return undefined;
         }
     };
-    // A structured schedule (or legacy bare cron string) is valid iff every cron
-    // it compiles to parses.
-    const isValidScheduleInput = (input) => {
-        const crons = compileScheduleAll(normalizeScheduleInput(input));
+    // The trigger (new `trigger` union or legacy bare `schedule`) is valid iff a
+    // schedule trigger compiles to ≥1 parseable cron; a watch trigger is always
+    // valid (its watched cwd is validated separately). Returns true when neither
+    // field is present — a PATCH that doesn't touch the trigger.
+    const isValidTriggerInput = (input) => {
+        if (input.trigger === undefined && input.schedule === undefined)
+            return true;
+        const trigger = normalizeTriggerInput(input);
+        if (trigger.kind === "watch")
+            return true;
+        const crons = compileScheduleAll(trigger.schedule);
         return crons.length > 0 && crons.every((cron) => parseCronExpression(cron) !== null);
     };
     api.get("/automations", (context) => context.json({ automations: listAutomationsWithNextRun() }));
@@ -349,7 +384,7 @@ export const createServer = async (options = {}) => {
         if (automationStore.size() >= MAX_AUTOMATIONS) {
             return context.json({ error: "too_many_automations" }, HTTP_STATUS_BAD_REQUEST);
         }
-        if (!isValidScheduleInput(parsed.data.schedule)) {
+        if (!isValidTriggerInput(parsed.data)) {
             return context.json({ error: "invalid_schedule" }, HTTP_STATUS_BAD_REQUEST);
         }
         if (!resolveCwdQuery(parsed.data.cwd)) {
@@ -357,13 +392,14 @@ export const createServer = async (options = {}) => {
         }
         const automation = automationStore.create(parsed.data);
         broadcastAutomations();
+        syncFolderWatchers();
         return context.json({ automation: toAutomationWithNextRun(automation, new Date()) }, HTTP_STATUS_CREATED);
     });
     api.patch("/automations/:id", async (context) => {
         const parsed = updateAutomationInputSchema.safeParse(await readJsonBody(context));
         if (!parsed.success)
             return context.json({ error: "invalid_body" }, HTTP_STATUS_BAD_REQUEST);
-        if (parsed.data.schedule !== undefined && !isValidScheduleInput(parsed.data.schedule)) {
+        if (!isValidTriggerInput(parsed.data)) {
             return context.json({ error: "invalid_schedule" }, HTTP_STATUS_BAD_REQUEST);
         }
         if (parsed.data.cwd !== undefined && !resolveCwdQuery(parsed.data.cwd)) {
@@ -381,6 +417,7 @@ export const createServer = async (options = {}) => {
         if (!automation)
             return context.json({ error: "not_found" }, HTTP_STATUS_NOT_FOUND);
         broadcastAutomations();
+        syncFolderWatchers();
         return context.json({ automation: toAutomationWithNextRun(automation, new Date()) });
     });
     api.delete("/automations/:id", (context) => {
@@ -388,13 +425,14 @@ export const createServer = async (options = {}) => {
             return context.json({ error: "not_found" }, HTTP_STATUS_NOT_FOUND);
         }
         broadcastAutomations();
+        syncFolderWatchers();
         return context.json({ ok: true });
     });
     api.post("/automations/:id/run", (context) => {
         const automation = automationStore.get(context.req.param("id"));
         if (!automation)
             return context.json({ error: "not_found" }, HTTP_STATUS_NOT_FOUND);
-        // tryLaunch only returns null for the "schedule" trigger (finished/disabled
+        // tryLaunch only returns null for non-manual triggers (the finished/disabled
         // guard); a manual launch always succeeds. The guard satisfies the shared
         // nullable return type before reading run.runId.
         const run = tryLaunch(automation, "manual");
@@ -410,6 +448,8 @@ export const createServer = async (options = {}) => {
         if (!automation)
             return context.json({ error: "not_found" }, HTTP_STATUS_NOT_FOUND);
         broadcastAutomations();
+        // Reset re-enables + reactivates; a watch automation resumes watching.
+        syncFolderWatchers();
         return context.json({ automation: toAutomationWithNextRun(automation, new Date()) });
     });
     api.notFound((context) => context.json({ error: "not_found" }, HTTP_STATUS_NOT_FOUND));
@@ -592,7 +632,12 @@ export const createServer = async (options = {}) => {
                 };
                 const onTitle = (title) => safeSend(ws, { type: "title", title });
                 const onCwd = (cwd) => safeSend(ws, { type: "cwd", cwd });
-                const onForeground = (process) => safeSend(ws, { type: "foreground", process });
+                const onForeground = (process) => {
+                    safeSend(ws, { type: "foreground", process });
+                    // A foreground transition is the cheap signal that a recognized
+                    // program may have started or stopped — nudge automatic detection.
+                    caffeinateManager.pokeAuto();
+                };
                 const onNotification = (body) => safeSend(ws, { type: "notification", body });
                 const onExit = (code) => {
                     if (outputBatchTimer !== null) {
@@ -665,8 +710,11 @@ export const createServer = async (options = {}) => {
                 if (parsed.data.type === "input") {
                     session.write(parsed.data.data);
                 }
-                else if (parsed.data.type === "caffeinate") {
-                    caffeinateController.setActive(parsed.data.enabled);
+                else if (parsed.data.type === "caffeinate-mode") {
+                    caffeinateManager.setMode(parsed.data.mode);
+                }
+                else if (parsed.data.type === "caffeinate-commands") {
+                    caffeinateManager.setCommands(parsed.data.commands);
                 }
                 else {
                     session.resize(parsed.data.cols, parsed.data.rows, parsed.data.pixelWidth, parsed.data.pixelHeight);
@@ -695,6 +743,9 @@ export const createServer = async (options = {}) => {
                 if (!session)
                     return;
                 registry.unregister(session);
+                // A closed session may have been the only one running a trigger;
+                // re-evaluate automatic keep-awake now that its pid is gone.
+                caffeinateManager.pokeAuto();
                 session.dispose();
                 session = null;
                 activeWs = null;
@@ -720,6 +771,9 @@ export const createServer = async (options = {}) => {
                 if (!session)
                     return;
                 registry.unregister(session);
+                // A closed session may have been the only one running a trigger;
+                // re-evaluate automatic keep-awake now that its pid is gone.
+                caffeinateManager.pokeAuto();
                 session.dispose();
                 session = null;
                 activeWs = null;
@@ -771,6 +825,9 @@ export const createServer = async (options = {}) => {
     automationScheduler.on("due", (automation) => {
         tryLaunch(automation, "schedule");
     });
+    folderWatchManager.on("due", (automation) => {
+        tryLaunch(automation, "watch");
+    });
     automationScheduler.on("tick", (now) => {
         // Liveness heartbeat for downtime detection on the next boot.
         heartbeatStore.write(now.getTime());
@@ -791,6 +848,8 @@ export const createServer = async (options = {}) => {
     });
     reconcileOnStartup(Date.now());
     automationScheduler.start();
+    // Arm folder-watch triggers for the automations loaded at boot.
+    syncFolderWatchers();
     // Open the persistent CDP connection now, while the user is present at
     // `start` to clear any one-time remote-debugging prompt. Fire-and-forget:
     // failure just means runs fall back to the OS opener.
@@ -808,7 +867,8 @@ export const createServer = async (options = {}) => {
     }
     const stop = async () => {
         automationScheduler.dispose();
-        caffeinateController.dispose();
+        folderWatchManager.dispose();
+        caffeinateManager.dispose();
         cdpClient?.close();
         registry.disposeAll();
         // Forcibly tear down every WS first. node-pty + ws upgraded sockets