@mseep/clawdcursor 1.5.5

package/dist/tools/electron_bridge.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * v0.8.2 — Electron / WebView2 / WKWebView detection + CDP bridging hints.
+ *
+ * Modern "native" apps on Windows and macOS are frequently Electron or
+ * WebView2 wrappers around Chromium. Their accessibility trees often
+ * contain only the window chrome — the entire document body is inside
+ * the web view and is NOT reachable via UIA or AX directly.
+ *
+ * Examples on Windows (WebView2 / Electron):
+ *   - New Outlook (olk)
+ *   - Microsoft Teams
+ *   - Discord
+ *   - Slack
+ *   - VS Code
+ *   - GitHub Desktop
+ *   - Notion
+ *
+ * The clean fix is to bridge to their embedded Chromium via CDP. That
+ * requires the app to be launched with a remote-debugging port. We
+ * cannot attach to an already-running app that wasn't launched that
+ * way, but we CAN:
+ *
+ *   1. Detect which running processes are Electron/WebView2 shells by
+ *      process-name heuristics + module snooping (on Windows).
+ *   2. Scan the common Electron remote-debug port range for already-
+ *      enabled /json endpoints.
+ *   3. Tell the agent HOW to relaunch the app with debugging enabled
+ *      so a bridge can attach.
+ *
+ * This file ships two tools:
+ *   - `detect_webview_apps`  — enumerate candidates + their CDP status
+ *   - `attach_webview_cdp`   — discover the debugger URL and connect
+ *                              the existing cdp_driver to it
+ *
+ * Linux TODO: the same heuristics apply (look for
+ * /proc/{pid}/cmdline containing `--type=renderer` or `.asar`), but
+ * AT-SPI already gives us a richer tree on Linux Electron apps than
+ * UIA does on Windows. Follow-up.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getElectronBridgeTools = getElectronBridgeTools;
+const KNOWN_APPS = [
+    // Windows New Outlook — WebView2
+    { processNames: ['olk'], titleSubstrings: ['- outlook'], displayName: 'New Outlook', kind: 'webview2' },
+    // Teams (v2 is WebView2, v1 was Electron)
+    { processNames: ['ms-teams', 'teams'], titleSubstrings: ['microsoft teams'], displayName: 'Microsoft Teams', kind: 'webview2' },
+    // Discord — Electron
+    { processNames: ['discord'], titleSubstrings: ['discord'], displayName: 'Discord', kind: 'electron', debugFlag: '--remote-debugging-port=9222' },
+    // Slack — Electron
+    { processNames: ['slack'], titleSubstrings: ['slack'], displayName: 'Slack', kind: 'electron', debugFlag: '--remote-debugging-port=9222' },
+    // VS Code — Electron
+    { processNames: ['code', 'code - insiders'], titleSubstrings: ['visual studio code'], displayName: 'VS Code', kind: 'electron', debugFlag: '--inspect=9222' },
+    // GitHub Desktop — Electron
+    { processNames: ['github desktop', 'githubdesktop'], titleSubstrings: ['github desktop'], displayName: 'GitHub Desktop', kind: 'electron' },
+    // Notion — Electron
+    { processNames: ['notion'], titleSubstrings: ['notion'], displayName: 'Notion', kind: 'electron' },
+    // Obsidian — Electron
+    { processNames: ['obsidian'], titleSubstrings: ['obsidian'], displayName: 'Obsidian', kind: 'electron' },
+    // Spotify — Chromium shell
+    { processNames: ['spotify'], titleSubstrings: ['spotify'], displayName: 'Spotify', kind: 'chromium-shell' },
+];
+/**
+ * Match a window to a known WebView app fingerprint. Returns null when
+ * the window is a plain native app.
+ */
+function matchFingerprint(processName, title) {
+    const pn = processName.toLowerCase();
+    const t = (title || '').toLowerCase();
+    for (const fp of KNOWN_APPS) {
+        const pnMatch = fp.processNames.some(n => pn.startsWith(n.toLowerCase()));
+        const titleMatch = fp.titleSubstrings.some(s => t.includes(s));
+        if (pnMatch || titleMatch)
+            return fp;
+    }
+    return null;
+}
+/** Probe a single TCP port for a running /json Chrome DevTools endpoint. */
+async function probeCdpPort(port) {
+    try {
+        const res = await fetch(`http://127.0.0.1:${port}/json/version`, {
+            signal: AbortSignal.timeout(500),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** Scan the common Electron remote-debug port range. */
+async function findLiveCdpPort() {
+    // Electron defaults to 9222; developers sometimes pick 9223/9229. Chrome
+    // and Edge when launched with --remote-debugging-port also use 9222.
+    const candidates = [9222, 9223, 9229, 8315];
+    for (const p of candidates) {
+        if (await probeCdpPort(p))
+            return p;
+    }
+    return null;
+}
+function buildHint(fp, cdpPort, title) {
+    if (cdpPort !== null) {
+        return (`${fp.displayName} detected and CDP is already live on port ${cdpPort}. ` +
+            `Call \`browser({"action":"connect","port":${cdpPort}})\` (or \`cdp_connect\` in granular mode) to attach, then ` +
+            `\`browser({"action":"page_context"})\` to enumerate its DOM elements — far richer than the UIA tree.`);
+    }
+    const flag = fp.debugFlag ?? '--remote-debugging-port=9222';
+    return (`${fp.displayName} ("${title}") is a ${fp.kind} app whose accessibility tree is largely empty — ` +
+        `its UI is inside an embedded Chromium. To get a reliable DOM-level bridge, ask the user to relaunch it ` +
+        `with \`${flag}\` (e.g. \`${fp.processNames[0]} ${flag}\`). Then call ` +
+        `\`browser({"action":"connect"})\` to attach. ` +
+        `Until then, fall back to \`system({"action":"ocr"})\` + coord clicks, OR \`accessibility({"action":"invoke","name":"..."})\` against whatever names DO show up.`);
+}
+function getElectronBridgeTools() {
+    return [
+        {
+            name: 'detect_webview_apps',
+            description: 'Enumerate running Electron / WebView2 / Chromium-shell apps (e.g. New Outlook, Teams, Discord, Slack, VS Code) whose ' +
+                'accessibility trees are typically sparse because the UI is rendered inside a web view. Returns each candidate with a ' +
+                'CDP-discovery hint — if a remote-debugging port is already live, you can attach to it via `browser({"action":"connect"})`; ' +
+                'otherwise the hint shows the relaunch command the user should run to enable CDP. Use this WHEN `read_screen` returns an ' +
+                'unexpectedly empty tree on a "native" app.',
+            parameters: {},
+            category: 'perception',
+            compactGroup: 'system',
+            safetyTier: 0,
+            handler: async (_params, ctx) => {
+                await ctx.ensureInitialized();
+                if (!ctx.platform) {
+                    return { text: 'detect_webview_apps: platform adapter not initialized', isError: true };
+                }
+                const windows = await ctx.platform.listWindows();
+                const candidates = [];
+                // Port scan is cheap; do it once and reuse.
+                const cdpPort = await findLiveCdpPort();
+                const seenPids = new Set();
+                for (const w of windows) {
+                    const fp = matchFingerprint(w.processName, w.title);
+                    if (!fp)
+                        continue;
+                    // Apps can expose multiple top-level windows for the same process
+                    // (e.g. Outlook's main window + a hidden notification host). One
+                    // candidate per pid is what callers actually want.
+                    if (seenPids.has(w.processId))
+                        continue;
+                    seenPids.add(w.processId);
+                    candidates.push({
+                        processName: w.processName,
+                        processId: w.processId,
+                        title: w.title,
+                        displayName: fp.displayName,
+                        kind: fp.kind,
+                        cdpPort,
+                        hint: buildHint(fp, cdpPort, w.title),
+                    });
+                }
+                if (candidates.length === 0) {
+                    return {
+                        text: 'No known Electron / WebView2 apps detected in the current window list. ' +
+                            `${cdpPort !== null ? `A CDP endpoint IS live on port ${cdpPort} — call browser({"action":"connect"}) to attach.` : 'No CDP endpoint is currently live on the standard ports (9222/9223/9229/8315).'}`,
+                    };
+                }
+                return { text: JSON.stringify({ candidates, cdpPort }, null, 2) };
+            },
+        },
+        {
+            name: 'relaunch_with_cdp',
+            description: 'Relaunch a WebView2 / Electron app with a remote-debugging port enabled so `browser` tools can attach. ' +
+                'The relaunch closes the existing instance (asks the OS to close politely via window_close first), then ' +
+                'starts a new one with `--remote-debugging-port=<port>`. The user MUST consent — this WILL lose any unsaved work ' +
+                'in the app. Returns instructions + the new port. Prefer the hint from `detect_webview_apps` when possible.',
+            parameters: {
+                appName: { type: 'string', description: 'Process name of the app (e.g. "discord", "slack", "olk")', required: true },
+                port: { type: 'number', description: 'Port to open for CDP. Default 9222.', required: false, default: 9222 },
+            },
+            category: 'orchestration',
+            compactGroup: 'system',
+            safetyTier: 3,
+            handler: async ({ appName, port }, ctx) => {
+                await ctx.ensureInitialized();
+                if (!ctx.platform) {
+                    return { text: 'relaunch_with_cdp: platform adapter not initialized', isError: true };
+                }
+                const p = typeof port === 'number' ? port : 9222;
+                const name = String(appName);
+                // Try to close the existing instance gracefully.
+                await ctx.platform.setWindowState('close', { processName: name }).catch(() => false);
+                // Wait briefly for the close to propagate.
+                await new Promise(r => setTimeout(r, 600));
+                try {
+                    // Relaunch with the debug flag. On Windows we pass args via launchApp's
+                    // url field as a positional argument to Start-Process — adapter handles
+                    // the quoting.
+                    const flag = `--remote-debugging-port=${p}`;
+                    if (ctx.platform.platform === 'win32') {
+                        const { spawn } = await Promise.resolve().then(() => __importStar(require('child_process')));
+                        const child = spawn('powershell.exe', [
+                            '-NoProfile', '-Command',
+                            `Start-Process -FilePath '${name.replace(/'/g, "''")}' -ArgumentList '${flag}'`,
+                        ], { stdio: 'ignore', detached: true, windowsHide: true });
+                        child.unref();
+                    }
+                    else {
+                        // macOS / Linux — open -a / direct spawn.
+                        await ctx.platform.launchApp(name, { url: flag }).catch(() => ({}));
+                    }
+                    await new Promise(r => setTimeout(r, 1500));
+                    const alive = await fetch(`http://127.0.0.1:${p}/json/version`, { signal: AbortSignal.timeout(2000) })
+                        .then(r => r.ok).catch(() => false);
+                    return {
+                        text: JSON.stringify({
+                            appName: name, port: p, cdpLive: alive,
+                            nextStep: alive ? `Call browser({"action":"connect","port":${p}}).` : 'Relaunch attempted but CDP endpoint not detected. The app may not support this flag.',
+                        }, null, 2),
+                        isError: !alive,
+                    };
+                }
+                catch (err) {
+                    return {
+                        text: `relaunch_with_cdp failed: ${err instanceof Error ? err.message : String(err)}`,
+                        isError: true,
+                    };
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=electron_bridge.js.map

package/dist/tools/electron_bridge.js.map

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

package/dist/tools/extras.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tranche 1B tools — thin wrappers over the PlatformAdapter primitives
+ * added in Tranche 1A.
+ *
+ * Every tool here is OS-agnostic by construction: it calls through
+ * `ctx.platform.*` and the adapter decides how to land the action on
+ * the current OS (Windows PowerShell + UIA, macOS osascript + nut-js,
+ * Linux wmctrl/xdotool/nut-js). When a primitive isn't supported on the
+ * current OS, the adapter returns a falsy value and the tool reports it
+ * as `not_supported_on_platform` rather than throwing.
+ *
+ * Coordinate convention: all mouse tools here take IMAGE-SPACE coords
+ * (matching desktop_screenshot), scaled through `getMouseScaleFactor()`
+ * just like the existing `mouse_click`. Window / keyboard tools do not
+ * carry coords.
+ *
+ * Safety tier: tools default to 'input' via `safety/layer.ts` TOOL_TIER;
+ * `close_window` is tagged 'destructive' and will require confirm when
+ * SafetyLayer surfaces block/confirm.
+ */
+import type { ToolDefinition } from './types';
+export declare function getExtraTools(): ToolDefinition[];