screenhand 0.4.9 → 0.5.2

package/dist/src/state/state-watcher.js

@@ -0,0 +1,144 @@
+// Copyright (C) 2025 Clazro Technology Private Limited
+// SPDX-License-Identifier: AGPL-3.0-only
+//
+// This file is part of ScreenHand.
+//
+// ScreenHand is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, version 3.
+//
+// ScreenHand is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with ScreenHand. If not, see <https://www.gnu.org/licenses/>.
+export class StateWatcher {
+    worldModel;
+    execute;
+    rules = new Map();
+    interval = null;
+    pollMs;
+    constructor(worldModel, execute, pollMs = 2_000) {
+        this.worldModel = worldModel;
+        this.execute = execute;
+        this.pollMs = pollMs;
+    }
+    static MAX_RULES = 50;
+    /**
+     * Register a watch rule. Returns the rule ID for later removal.
+     */
+    register(rule) {
+        if (this.rules.size >= StateWatcher.MAX_RULES && !this.rules.has(rule.id)) {
+            throw new Error(`Maximum watch rules (${StateWatcher.MAX_RULES}) reached. Remove existing rules first.`);
+        }
+        this.rules.set(rule.id, {
+            rule,
+            fireCount: 0,
+            lastFiredAt: 0,
+        });
+        return rule.id;
+    }
+    /** Register a convenience rule: fire action when a control with matching title appears. */
+    watchForElement(id, elementTitle, action, bundleId) {
+        const titleLower = elementTitle.toLowerCase();
+        return this.register({
+            id,
+            description: `Watch for element "${elementTitle}"`,
+            condition: (state) => {
+                for (const win of state.windows.values()) {
+                    for (const ctrl of win.controls.values()) {
+                        if (ctrl.label?.value?.toLowerCase().includes(titleLower)) {
+                            return true;
+                        }
+                    }
+                }
+                return false;
+            },
+            action,
+            maxFires: 1,
+            cooldownMs: 10_000,
+            ...(bundleId ? { bundleId } : {}),
+        });
+    }
+    /** Register: fire action when a dialog appears with matching text. */
+    watchForDialog(id, titlePattern, action) {
+        return this.register({
+            id,
+            description: `Watch for dialog matching ${titlePattern}`,
+            condition: (state) => state.activeDialogs.some((d) => titlePattern.test(d.title ?? "")),
+            action,
+            maxFires: 0, // unlimited — dialogs can recur
+            cooldownMs: 5_000,
+        });
+    }
+    /** Remove a watch rule by ID. */
+    unregister(id) {
+        return this.rules.delete(id);
+    }
+    /** Remove all rules. */
+    clear() {
+        this.rules.clear();
+    }
+    /** Get all registered rules. */
+    getRules() {
+        return [...this.rules.values()].map((rs) => ({
+            id: rs.rule.id,
+            description: rs.rule.description,
+            fireCount: rs.fireCount,
+        }));
+    }
+    /** Start the polling loop. */
+    start() {
+        if (this.interval)
+            return;
+        this.interval = setInterval(() => {
+            void this.tick();
+        }, this.pollMs);
+    }
+    /** Stop the polling loop. */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    get isRunning() {
+        return this.interval !== null;
+    }
+    async tick() {
+        const state = this.worldModel.getState();
+        const now = Date.now();
+        const focusedBundleId = state.focusedApp?.bundleId;
+        for (const [id, rs] of this.rules) {
+            // Max fires check
+            if (rs.rule.maxFires > 0 && rs.fireCount >= rs.rule.maxFires)
+                continue;
+            // Cooldown check
+            if (now - rs.lastFiredAt < rs.rule.cooldownMs)
+                continue;
+            // BundleId filter
+            if (rs.rule.bundleId && rs.rule.bundleId !== focusedBundleId)
+                continue;
+            try {
+                if (rs.rule.condition(state)) {
+                    rs.fireCount++;
+                    rs.lastFiredAt = now;
+                    process.stderr.write(`[state-watcher] Rule "${id}" fired (${rs.fireCount}x): ${rs.rule.description}\n`);
+                    // Fire and forget — don't block the poll loop
+                    this.execute(rs.rule.action.tool, rs.rule.action.params).catch((err) => {
+                        process.stderr.write(`[state-watcher] Rule "${id}" action failed: ${err instanceof Error ? err.message : String(err)}\n`);
+                    });
+                    // Remove exhausted rules
+                    if (rs.rule.maxFires > 0 && rs.fireCount >= rs.rule.maxFires) {
+                        this.rules.delete(id);
+                    }
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[state-watcher] Rule "${id}" condition threw: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+    }
+}

package/dist/src/supervisor/supervisor.js

@@ -297,7 +297,7 @@ export class SessionSupervisor {
             this.log(`Poll error (${this.consecutiveErrors}/${this.config.maxConsecutiveErrors}): ${err instanceof Error ? err.message : String(err)}`);
             if (this.consecutiveErrors >= this.config.maxConsecutiveErrors) {
                 this.log("Max consecutive errors reached — stopping supervisor");
-                this.stop().catch(() => { });
+                this.stop().catch((e) => { process.stderr.write(`[supervisor] stop after max errors failed: ${e instanceof Error ? e.message : String(e)}\n`); });
             }
         }
     }