screenhand 0.4.5 → 0.4.6

package/dist/mcp-desktop.js

@@ -164,6 +164,48 @@ Docs: https://github.com/manushi4/Screenhand
 `);
     process.exit(0);
 }
+// ── Startup cleanup: remove corrupt/empty state files ──
+{
+    const stateDir = path.join(os.homedir(), ".screenhand", "state");
+    if (fs.existsSync(stateDir)) {
+        try {
+            const files = fs.readdirSync(stateDir).filter(f => f.endsWith(".json"));
+            let removed = 0;
+            for (const file of files) {
+                const filePath = path.join(stateDir, file);
+                try {
+                    const stat = fs.statSync(filePath);
+                    // Remove empty files
+                    if (stat.size === 0) {
+                        fs.unlinkSync(filePath);
+                        removed++;
+                        continue;
+                    }
+                    // Remove files older than 7 days
+                    if (Date.now() - stat.mtimeMs > 7 * 24 * 60 * 60 * 1000) {
+                        fs.unlinkSync(filePath);
+                        removed++;
+                        continue;
+                    }
+                    // Remove corrupt JSON (can't parse)
+                    const content = fs.readFileSync(filePath, "utf-8");
+                    JSON.parse(content);
+                }
+                catch {
+                    try {
+                        fs.unlinkSync(filePath);
+                        removed++;
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            if (removed > 0) {
+                console.error(`[screenhand] Cleaned up ${removed} stale/corrupt state files from ${stateDir}`);
+            }
+        }
+        catch { /* ignore if dir can't be read */ }
+    }
+}
 // ── Audit logging for dangerous tools ──
 const AUDIT_LOG_PATH = path.resolve(__dirname, ".audit-log.jsonl");
 function auditLog(tool, params) {

package/dist/src/native/bridge-client.js

@@ -251,13 +251,28 @@ export class BridgeClient extends EventEmitter {
         return [...this.recentStderr];
     }
     async spawn() {
+        // Check binary exists before spawning — give actionable error instead of cryptic ENOENT
+        if (!fs.existsSync(this.binaryPath)) {
+            const platform = process.platform;
+            const hint = platform === "darwin"
+                ? `Run: npm run build:native (requires Xcode + Swift)`
+                : platform === "win32"
+                    ? `Run: npm run build:native:windows (requires .NET 8 SDK)`
+                    : `Native bridge is only available on macOS and Windows.`;
+            throw new Error(`ScreenHand native bridge not found at: ${this.binaryPath}\n` +
+                `${hint}\n` +
+                `If installed via npm, try: npm rebuild screenhand`);
+        }
         const child = spawn(this.binaryPath, [], {
             stdio: ["pipe", "pipe", "pipe"],
         });
         // Track which process this is so stale event handlers don't trigger restarts
         const spawnedProcess = child;
         child.on("error", (err) => {
-            this.emit("error", err);
+            const msg = err.code === "ENOENT"
+                ? new Error(`ScreenHand native bridge binary not found: ${this.binaryPath}. Run: npm run build:native`)
+                : err;
+            this.emit("error", msg);
             // Only auto-restart if this is still the active process
             if (this.started && this.process === spawnedProcess) {
                 this.restart().catch(() => { });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "screenhand",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "mcpName": "io.github.manushi4/screenhand",
   "description": "Give AI eyes and hands on your desktop. ScreenHand is an open-source MCP server that lets Claude and other AI agents see your screen, click buttons, type text, and control any app on macOS and Windows.",
   "homepage": "https://screenhand.com",
@@ -70,6 +70,9 @@
     "ocr",
     "computer-use"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.78.0",
     "@modelcontextprotocol/sdk": "^1.27.1",