@instaclaw/dispatch 0.1.0 → 0.1.1

package/dist/index.js

@@ -7,21 +7,44 @@
  *   npx @instaclaw/dispatch --token XXX --vm HOST  # Direct connect
  */
 import { loadConfig, saveConfig, getConfigPath } from "./config.js";
-import { checkPermissions, printPermissionGuide } from "./permissions.js";
+import { checkPermissions, printPermissionGuide, runPermissionTest } from "./permissions.js";
 import { connect, disconnect } from "./connection.js";
 import { closeSupervisor } from "./supervisor.js";
 import readline from "readline";
+import os from "os";
 async function main() {
     console.log(`
   InstaClaw Dispatch — Remote Computer Control
   ─────────────────────────────────────────────
   `);
-    // 1. Check/request permissions
-    const perms = checkPermissions();
-    if (!perms.accessibility || !perms.screenRecording) {
+    // 1. Check permissions (macOS only)
+    if (os.platform() === "darwin") {
         console.log("  Checking permissions...");
-        printPermissionGuide();
-        await waitForEnter();
+        const perms = checkPermissions();
+        printPermissionGuide(perms);
+        if (perms.screenRecording === false || perms.accessibility === false) {
+            await waitForEnter();
+            // Re-check after user grants
+            const recheck = checkPermissions();
+            if (recheck.screenRecording === false) {
+                console.log("  Warning: Screen Recording still not granted. Screenshots may fail.\n");
+            }
+            if (recheck.accessibility === false) {
+                console.log("  Warning: Accessibility still not granted. Click/type may fail.\n");
+            }
+        }
+        else {
+            // Run a functional test to be sure
+            console.log("  Running permission test...");
+            const test = await runPermissionTest();
+            if (test.ok) {
+                console.log("  Permissions: all OK\n");
+            }
+            else {
+                console.log(`  Warning: ${test.error}`);
+                console.log("  Continuing anyway — some commands may fail.\n");
+            }
+        }
     }
     // 2. Load or create config
     let config = loadConfig();

package/dist/permissions.d.ts

@@ -1,8 +1,16 @@
 interface PermissionStatus {
-    accessibility: boolean;
-    screenRecording: boolean;
+    accessibility: boolean | "unknown";
+    screenRecording: boolean | "unknown";
     platform: string;
 }
 export declare function checkPermissions(): PermissionStatus;
-export declare function printPermissionGuide(): void;
+/**
+ * Run a quick functional test: take a screenshot via usecomputer.
+ * If it fails, permissions are likely missing.
+ */
+export declare function runPermissionTest(): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function printPermissionGuide(status: PermissionStatus): void;
 export {};

package/dist/permissions.js

@@ -1,44 +1,118 @@
+import { execSync } from "child_process";
 import os from "os";
+import fs from "fs";
+import path from "path";
 export function checkPermissions() {
     const platform = os.platform();
     if (platform === "darwin") {
         return checkMacPermissions();
     }
-    // Linux/Windows — no special permissions needed for X11
+    // Linux/Windows — no special permissions needed
     return { accessibility: true, screenRecording: true, platform };
 }
 function checkMacPermissions() {
-    let accessibility = false;
-    let screenRecording = false;
-    // Check accessibility: try to create a CGEvent (will fail without permission)
-    // We can't check directly from Node — usecomputer will fail at runtime if missing
-    // For now, assume true and catch errors at execution time
-    accessibility = true; // Will validate on first command
-    // Screen recording: same — can't check from Node without native module
-    screenRecording = true;
+    let accessibility = "unknown";
+    let screenRecording = "unknown";
+    // Check Accessibility via TCC database
+    // macOS stores permission grants in ~/Library/Application Support/com.apple.TCC/TCC.db
+    // and /Library/Application Support/com.apple.TCC/TCC.db (system)
+    // We can try a quick test: usecomputer mouse position (fails without accessibility)
+    try {
+        const result = execSync('osascript -e \'tell application "System Events" to get name of first process\'', { timeout: 3000, stdio: ["pipe", "pipe", "pipe"] });
+        accessibility = true;
+    }
+    catch {
+        // AppleScript fails without Accessibility permission
+        accessibility = false;
+    }
+    // Check Screen Recording by attempting a tiny screenshot
+    // CGWindowListCreateImage returns a null/empty image without Screen Recording permission
+    try {
+        const tmpFile = path.join(os.tmpdir(), `dispatch-perm-check-${Date.now()}.png`);
+        execSync(`screencapture -x -t png "${tmpFile}" 2>/dev/null`, { timeout: 5000 });
+        if (fs.existsSync(tmpFile)) {
+            const size = fs.statSync(tmpFile).size;
+            fs.unlinkSync(tmpFile);
+            // A valid screenshot is at least a few KB. A blocked capture may produce a tiny or empty file.
+            screenRecording = size > 500;
+        }
+        else {
+            screenRecording = false;
+        }
+    }
+    catch {
+        screenRecording = false;
+    }
     return { accessibility, screenRecording, platform: "darwin" };
 }
-export function printPermissionGuide() {
-    const platform = os.platform();
+/**
+ * Run a quick functional test: take a screenshot via usecomputer.
+ * If it fails, permissions are likely missing.
+ */
+export async function runPermissionTest() {
+    try {
+        const uc = await import("usecomputer");
+        const tmpPath = path.join(os.tmpdir(), `dispatch-test-${Date.now()}.png`);
+        await uc.screenshot({ path: tmpPath, display: null, window: null, region: null, annotate: null });
+        if (fs.existsSync(tmpPath)) {
+            const size = fs.statSync(tmpPath).size;
+            fs.unlinkSync(tmpPath);
+            if (size > 500)
+                return { ok: true };
+            return { ok: false, error: "Screenshot captured but empty — Screen Recording permission may be missing" };
+        }
+        return { ok: false, error: "Screenshot file not created" };
+    }
+    catch (err) {
+        const msg = String(err);
+        if (msg.includes("EVENT_POST_FAILED") || msg.includes("CGEvent")) {
+            return { ok: false, error: "Accessibility permission not granted" };
+        }
+        if (msg.includes("CAPTURE_FAILED")) {
+            return { ok: false, error: "Screen Recording permission not granted" };
+        }
+        return { ok: false, error: msg.slice(0, 100) };
+    }
+}
+export function printPermissionGuide(status) {
+    const platform = status.platform;
     if (platform === "darwin") {
-        console.log(`
-  To grant permissions (macOS):
-    1. System Settings → Privacy & Security → Accessibility
-       → Add your terminal app (Terminal, iTerm, Warp, etc.)
-    2. System Settings → Privacy & Security → Screen Recording
-       → Add your terminal app
-
-  Press Enter after granting permissions...`);
+        const terminal = process.env.TERM_PROGRAM || "your terminal app";
+        const terminalName = {
+            "Apple_Terminal": "Terminal",
+            "iTerm.app": "iTerm2",
+            "vscode": "Visual Studio Code",
+            "WarpTerminal": "Warp",
+        }[terminal] || terminal;
+        console.log("");
+        if (status.screenRecording === false) {
+            console.log(`  Screen Recording: NOT GRANTED`);
+            console.log(`    → System Settings → Privacy & Security → Screen Recording`);
+            console.log(`    → Enable "${terminalName}"`);
+            console.log(`    → You may need to restart ${terminalName} after granting`);
+            console.log("");
+        }
+        else {
+            console.log(`  Screen Recording: OK`);
+        }
+        if (status.accessibility === false) {
+            console.log(`  Accessibility: NOT GRANTED`);
+            console.log(`    → System Settings → Privacy & Security → Accessibility`);
+            console.log(`    → Enable "${terminalName}"`);
+            console.log("");
+        }
+        else {
+            console.log(`  Accessibility: OK`);
+        }
+        if (status.screenRecording === false || status.accessibility === false) {
+            console.log(`  After granting permissions, press Enter to continue...`);
+        }
     }
     else if (platform === "linux") {
-        console.log(`
-  Linux: No special permissions needed.
-  Ensure DISPLAY is set if using X11.`);
+        console.log(`  Linux: No special permissions needed.`);
     }
     else {
-        console.log(`
-  Windows: No special permissions needed.
-  Run as administrator if controlling elevated apps.`);
+        console.log(`  Windows: No special permissions needed.`);
     }
 }
 //# sourceMappingURL=permissions.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instaclaw/dispatch",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Let your InstaClaw AI agent control your computer — screenshots, clicks, typing, and more via a secure WebSocket relay",
   "bin": {
     "instaclaw-dispatch": "./dist/index.js"