ucu-mcp 0.4.0 → 0.4.2

package/dist/src/platform/macos/window.js

@@ -0,0 +1,251 @@
+import { execFileSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { WindowNotFoundError } from "../../util/errors.js";
+import { rethrowAccessibilityError, selectWindowForApp } from "./helpers.js";
+const __windowDirname = dirname(fileURLToPath(import.meta.url));
+export async function listApps() {
+    const jxaScript = `
+    var se = Application('System Events');
+    var result = [];
+    var procs = se.processes();
+    for (var i = 0; i < procs.length; i++) {
+      try {
+        var p = procs[i];
+        var background = false;
+        try { background = p.backgroundOnly(); } catch(e) {}
+        if (background) continue;
+        var wins = [];
+        try { wins = p.windows(); } catch(e) {}
+        result.push({
+          name: p.name() || '',
+          pid: p.unixId ? p.unixId() : 0,
+          isFrontmost: p.frontmost ? !!p.frontmost() : false,
+          windowCount: wins.length || 0
+        });
+      } catch(e) {}
+    }
+    JSON.stringify(result);
+  `;
+    try {
+        const out = execFileSync("osascript", [
+            "-l", "JavaScript",
+            "-e", jxaScript,
+        ], { encoding: "utf-8", timeout: 10000 }).trim();
+        return JSON.parse(out);
+    }
+    catch (error) {
+        rethrowAccessibilityError(error, "list_apps");
+    }
+}
+export async function focusApp(app) {
+    const appLiteral = JSON.stringify(app);
+    this.windowCache = undefined;
+    let target;
+    const deadline = Date.now() + 3000;
+    do {
+        const windows = await this.listWindows(true);
+        target = selectWindowForApp(windows, app);
+        if (target)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, 150));
+    } while (Date.now() < deadline);
+    if (!target) {
+        this.activeTarget = undefined;
+        const err = new WindowNotFoundError(app, { hint: "list_windows returned no match for this app. If the app is running, " +
+                "the most likely cause is that it is an Electron app whose AX tree is " +
+                "not exposed to System Events (System Settings > Privacy & Security > " +
+                "Accessibility must be granted to the Electron process itself, not just " +
+                "to the host terminal). Pixel-level workaround: call screenshot to " +
+                "capture the screen, then ocr to locate UI text and get its bounding " +
+                "box coordinates, then click(x, y) at those screen coordinates. " +
+                "Alternatively, modify the app's config file or database directly." });
+        throw err;
+    }
+    this.activeTarget = {
+        targetId: randomUUID(),
+        appName: target.processName,
+        pid: target.pid,
+        windowId: target.id,
+        title: target.title,
+        capturedAt: new Date().toISOString(),
+    };
+    return this.activeTarget;
+}
+export async function getActiveBrowserContext(app) {
+    const appName = app || this.activeTarget?.appName;
+    if (!appName)
+        return undefined;
+    const normalized = appName.toLowerCase();
+    const knownBrowser = [
+        "safari",
+        "google chrome",
+        "chrome",
+        "arc",
+        "microsoft edge",
+        "edge",
+        "brave browser",
+        "brave",
+    ].some((name) => normalized.includes(name));
+    if (!knownBrowser)
+        return undefined;
+    const appLiteral = JSON.stringify(appName);
+    const jxaScript = `
+    function run() {
+      var appName = ${appLiteral};
+      try {
+        var app = Application(appName);
+        var url = "";
+        var title = "";
+        if (appName.toLowerCase().indexOf("safari") !== -1) {
+          try { url = app.documents[0].url(); } catch(e) {}
+          try { title = app.documents[0].name(); } catch(e) {}
+        } else {
+          try { url = app.windows[0].activeTab.url(); } catch(e) {}
+          try { title = app.windows[0].activeTab.title(); } catch(e) {}
+        }
+        return JSON.stringify({appName: appName, url: url || undefined, title: title || undefined});
+      } catch(e) {
+        return JSON.stringify({appName: appName});
+      }
+    }
+    run();
+  `;
+    try {
+        const out = execFileSync("osascript", [
+            "-l", "JavaScript",
+            "-e", jxaScript,
+        ], { encoding: "utf-8", timeout: 5000 }).trim();
+        const parsed = JSON.parse(out);
+        return parsed.url || parsed.title ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function listWindows(_includeMinimized) {
+    const now = Date.now();
+    if (this.windowCache && now - this.windowCache.cachedAt <= this.windowCacheTtlMs) {
+        return this.windowCache.windows.map((window) => ({
+            ...window,
+            bounds: { ...window.bounds },
+        }));
+    }
+    if (this.windowCacheInFlight) {
+        return this.windowCache?.windows.map((w) => ({ ...w, bounds: { ...w.bounds } })) ?? [];
+    }
+    this.windowCacheInFlight = true;
+    try {
+        let windows;
+        const nativeResult = listWindowsNative.call(this);
+        if (nativeResult !== null) {
+            windows = nativeResult;
+        }
+        else {
+            windows = await listWindowsJxa.call(this);
+        }
+        this.windowCache = {
+            cachedAt: Date.now(),
+            windows: windows.map((window) => ({
+                ...window,
+                bounds: { ...window.bounds },
+            })),
+        };
+        return windows;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        this.windowCacheInFlight = false;
+    }
+}
+function listWindowsNative() {
+    try {
+        const helperPath = resolveNativeHelper.call(this, "windowlist", "windowlist-helper");
+        if (!helperPath)
+            return null;
+        const out = execFileSync(helperPath, [], {
+            encoding: "utf-8",
+            timeout: 5000,
+        });
+        const parsed = JSON.parse(out.trim());
+        if (parsed.error)
+            return null;
+        return parsed.windows.map(w => ({
+            id: w.id,
+            title: w.title,
+            processName: w.processName,
+            pid: w.pid,
+            bounds: w.bounds,
+            isMinimized: !w.isOnScreen,
+            isOnScreen: w.isOnScreen,
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+function resolveNativeHelper(folder, binary) {
+    if (this._nativeHelperPaths && folder in this._nativeHelperPaths) {
+        const override = this._nativeHelperPaths[folder];
+        return override === null ? null : override;
+    }
+    const candidates = [
+        join(__windowDirname, "..", "..", "..", "native", folder, binary),
+        join(__windowDirname, "..", "..", "native", folder, binary),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+async function listWindowsJxa() {
+    const jxaScript = `
+      var se = Application('System Events');
+      var result = [];
+      var procs = se.processes();
+      for (var i = 0; i < procs.length; i++) {
+        var p = procs[i];
+        var pName = '';
+        var pPid = 0;
+        try { pName = p.name(); } catch(e) {}
+        try { pPid = p.unixId(); } catch(e) {}
+        try {
+          var wins = p.windows();
+          for (var j = 0; j < wins.length; j++) {
+            var w = wins[j];
+            var pos, sz;
+            try { pos = w.position(); } catch(e) { pos = [0, 0]; }
+            try { sz = w.size(); } catch(e) { sz = [0, 0]; }
+            if (sz[0] === 0 && sz[1] === 0) continue;
+            var title = '';
+            try { title = w.name() || ''; } catch(e) {}
+            result.push({
+              id: pName + '/win' + j,
+              title: title,
+              processName: pName,
+              pid: pPid,
+              bounds: { x: pos[0], y: pos[1], width: sz[0], height: sz[1] },
+              isMinimized: false,
+              isOnScreen: true
+            });
+          }
+        } catch(e) {}
+      }
+      JSON.stringify(result);
+    `;
+    try {
+        const jxaOut = execFileSync("osascript", [
+            "-l", "JavaScript",
+            "-e", jxaScript
+        ], { encoding: "utf-8", timeout: 15000 });
+        return JSON.parse(jxaOut.trim());
+    }
+    catch (error) {
+        rethrowAccessibilityError(error, "list_windows_jxa");
+    }
+}