@mseep/clawdcursor 1.5.5

package/dist/platform/uri-handler.d.ts

@@ -0,0 +1,75 @@
+/**
+ * URI-scheme handler resolution + verified launch (Windows).
+ *
+ * Why this exists: the obvious dispatch routes (`explorer.exe mailto:...`,
+ * `rundll32 url.dll,FileProtocolHandler`, `cmd /c start "" "mailto:..."`)
+ * silently fail to open a compose window for New Outlook (`olk.exe`). The
+ * shell-routed paths return without error, no new window appears, and
+ * the agent thinks the dispatch worked. The only reliable Windows path
+ * is to resolve the registered handler executable and invoke IT directly
+ * with the URI as an argument.
+ *
+ * This module:
+ *   1. Resolves the user's default handler for a URI scheme by walking
+ *      HKCU UserChoice -> HKCR ProgId -> shell\open\command.
+ *   2. Falls back to a known-good list of common handlers when the
+ *      registry lookup fails (New Outlook is the main case today).
+ *   3. Launches the handler with the URI and VERIFIES a new visible
+ *      top-level window appeared in the handler process within a
+ *      bounded timeout. Returns honest success/failure.
+ *
+ * macOS and Linux already have reliable shell dispatch (`open` and
+ * `xdg-open`), so this module is Windows-only. Callers should keep
+ * using the platform-native dispatchers there.
+ */
+/**
+ * Resolve the executable path for the user's default handler of `scheme`
+ * (e.g. "mailto", "http", "tel"). Returns null when no handler is
+ * registered or when the registry lookup fails for any reason.
+ */
+export declare function resolveSchemeHandlerExecutable(scheme: string): Promise<string | null>;
+/**
+ * Is `scheme` a registered URI protocol in HKCR (has a `URL Protocol` value)?
+ * Some schemes (ms-settings:, ms-windows-store:, …) ARE registered but route
+ * through a `DelegateExecute` COM handler with an EMPTY shell\open\command — so
+ * resolveSchemeHandlerExecutable() returns null even though the OS can open
+ * them. Only ShellExecute (Start-Process) honors DelegateExecute. This lets the
+ * caller decide to fall back to a shell dispatch instead of failing outright.
+ */
+export declare function isRegisteredUriScheme(scheme: string): Promise<boolean>;
+/**
+ * Dispatch a URI via ShellExecute (PowerShell `Start-Process`) — the ONLY path
+ * that honors `DelegateExecute` COM handlers (ms-settings: et al.) — and verify
+ * a NEW visible top-level window appeared by diffing the full window list
+ * before/after. The handler process is unknown (SystemSettings.exe for
+ * ms-settings, etc.), so this diffs ALL windows rather than one process.
+ *
+ * The URI (agent-controlled) is passed via an ENV VAR, never interpolated into
+ * the command string — no shell-injection surface.
+ */
+export declare function shellDispatchUriAndVerify(uri: string, listWindows: () => Promise<Array<{
+    title?: string;
+    handle?: number | string;
+}>>, opts?: {
+    waitMs?: number;
+}): Promise<{
+    windowOpened: boolean;
+    title?: string;
+    error?: string;
+}>;
+/**
+ * Launch the resolved handler with the URI and verify that a NEW visible
+ * top-level window appeared in the handler process. Returns:
+ *   { success: true,  windowOpened: true,  hwndLabel } when a new window appeared.
+ *   { success: true,  windowOpened: false }            when the handler ran but no new window appeared
+ *                                                       (handler probably routed to an existing instance silently).
+ *   { success: false, error }                           when the launch itself failed.
+ */
+export declare function launchHandlerAndVerify(exePath: string, uri: string, opts?: {
+    waitMs?: number;
+}): Promise<{
+    success: boolean;
+    windowOpened: boolean;
+    hwndLabel?: string;
+    error?: string;
+}>;

package/dist/platform/uri-handler.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * URI-scheme handler resolution + verified launch (Windows).
+ *
+ * Why this exists: the obvious dispatch routes (`explorer.exe mailto:...`,
+ * `rundll32 url.dll,FileProtocolHandler`, `cmd /c start "" "mailto:..."`)
+ * silently fail to open a compose window for New Outlook (`olk.exe`). The
+ * shell-routed paths return without error, no new window appears, and
+ * the agent thinks the dispatch worked. The only reliable Windows path
+ * is to resolve the registered handler executable and invoke IT directly
+ * with the URI as an argument.
+ *
+ * This module:
+ *   1. Resolves the user's default handler for a URI scheme by walking
+ *      HKCU UserChoice -> HKCR ProgId -> shell\open\command.
+ *   2. Falls back to a known-good list of common handlers when the
+ *      registry lookup fails (New Outlook is the main case today).
+ *   3. Launches the handler with the URI and VERIFIES a new visible
+ *      top-level window appeared in the handler process within a
+ *      bounded timeout. Returns honest success/failure.
+ *
+ * macOS and Linux already have reliable shell dispatch (`open` and
+ * `xdg-open`), so this module is Windows-only. Callers should keep
+ * using the platform-native dispatchers there.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSchemeHandlerExecutable = resolveSchemeHandlerExecutable;
+exports.isRegisteredUriScheme = isRegisteredUriScheme;
+exports.shellDispatchUriAndVerify = shellDispatchUriAndVerify;
+exports.launchHandlerAndVerify = launchHandlerAndVerify;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Resolve the executable path for the user's default handler of `scheme`
+ * (e.g. "mailto", "http", "tel"). Returns null when no handler is
+ * registered or when the registry lookup fails for any reason.
+ */
+async function resolveSchemeHandlerExecutable(scheme) {
+    if (process.platform !== 'win32')
+        return null;
+    const s = scheme.toLowerCase();
+    // Step 1: HKCU\SOFTWARE\Microsoft\Windows\Shell\Associations\UrlAssociations\<scheme>\UserChoice
+    //   -> ProgId
+    const userChoicePath = `HKCU\\SOFTWARE\\Microsoft\\Windows\\Shell\\Associations\\UrlAssociations\\${s}\\UserChoice`;
+    let progId = null;
+    try {
+        const { stdout } = await execFileAsync('reg', ['query', userChoicePath, '/v', 'ProgId'], { timeout: 3000 });
+        const m = stdout.match(/ProgId\s+REG_SZ\s+(.+?)[\r\n]/);
+        if (m)
+            progId = m[1].trim();
+    }
+    catch {
+        // No UserChoice — fall through.
+    }
+    // Step 2: HKCR\<ProgId>\Shell\open\command -> (default)
+    if (progId) {
+        const cmdPath = `HKCR\\${progId}\\Shell\\open\\command`;
+        try {
+            const { stdout } = await execFileAsync('reg', ['query', cmdPath, '/ve'], { timeout: 3000 });
+            const m = stdout.match(/\(Default\)\s+REG_(?:SZ|EXPAND_SZ)\s+(.+?)[\r\n]/);
+            if (m) {
+                const exe = extractExecutableFromCommand(m[1]);
+                if (exe)
+                    return exe;
+            }
+        }
+        catch {
+            // ProgId points at a UWP app that doesn't expose shell\open\command
+            // (Microsoft.OutlookForWindows for example). Fall through to the
+            // known-handler list below.
+        }
+    }
+    // Step 3: known-handler fallbacks. Add new entries here as needed.
+    return resolveKnownHandlerForScheme(s);
+}
+/**
+ * Parse a Windows shell command-line string and pull out the executable
+ * path. Handles quoted paths, environment variable expansion (%ProgramFiles%),
+ * and strips trailing placeholder arguments like %1.
+ */
+function extractExecutableFromCommand(cmd) {
+    const trimmed = cmd.trim();
+    let exe;
+    if (trimmed.startsWith('"')) {
+        const end = trimmed.indexOf('"', 1);
+        if (end < 0)
+            return null;
+        exe = trimmed.slice(1, end);
+    }
+    else {
+        const spaceIdx = trimmed.indexOf(' ');
+        exe = spaceIdx < 0 ? trimmed : trimmed.slice(0, spaceIdx);
+    }
+    // Expand %VAR% references.
+    exe = exe.replace(/%([^%]+)%/g, (_, v) => process.env[v] ?? `%${v}%`);
+    return exe || null;
+}
+/**
+ * Look up a known-good handler executable for a scheme when the registry
+ * walk fails. UWP-packaged handlers (modern Outlook, Mail, etc.) don't
+ * expose a classic shell\open\command, so we have to know the executable
+ * location ourselves.
+ */
+function resolveKnownHandlerForScheme(scheme) {
+    if (scheme !== 'mailto')
+        return null;
+    // 1. Already-running New Outlook (`olk.exe`). Pull its path off the
+    //    live process when possible — that's the version actually installed.
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { execSync } = require('node:child_process');
+        const out = execSync('wmic process where "name=\'olk.exe\'" get ExecutablePath /value', { timeout: 3000, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+        const m = out.match(/ExecutablePath=(.+)/);
+        if (m && m[1].trim())
+            return m[1].trim();
+    }
+    catch {
+        // wmic missing or olk not running.
+    }
+    // 2. Glob WindowsApps for the latest Microsoft.OutlookForWindows install.
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { readdirSync, existsSync } = require('node:fs');
+        const base = 'C:\\Program Files\\WindowsApps';
+        if (existsSync(base)) {
+            const dirs = readdirSync(base).filter(d => d.startsWith('Microsoft.OutlookForWindows_'));
+            if (dirs.length) {
+                // Most-recent install wins (filesystem readdir order isn't sorted).
+                dirs.sort();
+                const exe = `${base}\\${dirs[dirs.length - 1]}\\olk.exe`;
+                if (existsSync(exe))
+                    return exe;
+            }
+        }
+    }
+    catch {
+        // No permission to enumerate WindowsApps — that's fine.
+    }
+    return null;
+}
+/**
+ * Is `scheme` a registered URI protocol in HKCR (has a `URL Protocol` value)?
+ * Some schemes (ms-settings:, ms-windows-store:, …) ARE registered but route
+ * through a `DelegateExecute` COM handler with an EMPTY shell\open\command — so
+ * resolveSchemeHandlerExecutable() returns null even though the OS can open
+ * them. Only ShellExecute (Start-Process) honors DelegateExecute. This lets the
+ * caller decide to fall back to a shell dispatch instead of failing outright.
+ */
+async function isRegisteredUriScheme(scheme) {
+    if (process.platform !== 'win32')
+        return false;
+    const s = scheme.toLowerCase().replace(/[^a-z0-9+.-]/g, ''); // defensive: scheme charset only
+    if (!s)
+        return false;
+    try {
+        const { stdout } = await execFileAsync('reg', ['query', `HKCR\\${s}`, '/v', 'URL Protocol'], { timeout: 3000 });
+        return /URL Protocol/i.test(stdout);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Dispatch a URI via ShellExecute (PowerShell `Start-Process`) — the ONLY path
+ * that honors `DelegateExecute` COM handlers (ms-settings: et al.) — and verify
+ * a NEW visible top-level window appeared by diffing the full window list
+ * before/after. The handler process is unknown (SystemSettings.exe for
+ * ms-settings, etc.), so this diffs ALL windows rather than one process.
+ *
+ * The URI (agent-controlled) is passed via an ENV VAR, never interpolated into
+ * the command string — no shell-injection surface.
+ */
+async function shellDispatchUriAndVerify(uri, listWindows, opts = {}) {
+    if (process.platform !== 'win32')
+        return { windowOpened: false, error: 'windows-only' };
+    const waitMs = opts.waitMs ?? 5000;
+    const snapshot = async () => {
+        const m = new Map();
+        try {
+            for (const w of await listWindows())
+                m.set(String(w.handle), w.title ?? '');
+        }
+        catch { /* empty */ }
+        return m;
+    };
+    const before = await snapshot();
+    try {
+        const child = (0, node_child_process_1.spawn)('powershell.exe', ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', 'Start-Process -FilePath $env:CLAWD_URI'], { detached: true, stdio: 'ignore', windowsHide: true, env: { ...process.env, CLAWD_URI: uri } });
+        child.unref();
+        child.on('error', () => { });
+    }
+    catch (err) {
+        return { windowOpened: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    const deadline = Date.now() + waitMs;
+    while (Date.now() < deadline) {
+        await new Promise(r => setTimeout(r, 300));
+        const after = await snapshot();
+        for (const [handle, title] of after) {
+            if (!before.has(handle))
+                return { windowOpened: true, title };
+        }
+    }
+    return { windowOpened: false };
+}
+/**
+ * Snapshot all visible top-level windows belonging to the given process
+ * name (case-insensitive). Returns a Set of HWND-like identifiers so the
+ * caller can diff "before" vs "after" launching a handler.
+ */
+async function snapshotProcessWindows(processNameLower) {
+    if (process.platform !== 'win32')
+        return new Set();
+    try {
+        // Use PowerShell to enumerate; it's already a dependency for the
+        // a11y bridge so we're not adding a new runtime.
+        //
+        // processNameLower flows in from registry / WindowsApps lookups (not
+        // LLM-controlled), but defense-in-depth: double single-quotes to
+        // escape any embedded apostrophe so it can't break out of the PS
+        // string literal. Same pattern as Windows.psQuote.
+        const safeName = processNameLower.replace(/'/g, "''");
+        const { stdout } = await execFileAsync('powershell.exe', [
+            '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command',
+            `Get-Process | Where-Object { $_.MainWindowHandle -ne 0 -and $_.MainWindowTitle -ne '' -and $_.ProcessName.ToLower() -eq '${safeName}' } | ForEach-Object { "$($_.MainWindowHandle)|$($_.MainWindowTitle)" }`,
+        ], { timeout: 3000 });
+        return new Set(stdout.split(/\r?\n/).map(l => l.trim()).filter(Boolean));
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * Launch the resolved handler with the URI and verify that a NEW visible
+ * top-level window appeared in the handler process. Returns:
+ *   { success: true,  windowOpened: true,  hwndLabel } when a new window appeared.
+ *   { success: true,  windowOpened: false }            when the handler ran but no new window appeared
+ *                                                       (handler probably routed to an existing instance silently).
+ *   { success: false, error }                           when the launch itself failed.
+ */
+async function launchHandlerAndVerify(exePath, uri, opts = {}) {
+    const waitMs = opts.waitMs ?? 5000;
+    // Derive the process name (lowercased, no extension) so we can diff
+    // its visible windows before vs after.
+    const exeBaseLower = exePath.split(/[\\/]/).pop().replace(/\.exe$/i, '').toLowerCase();
+    const before = await snapshotProcessWindows(exeBaseLower);
+    try {
+        // detached + ignored stdio so we don't keep a pipe open to the GUI
+        // app. unref() lets the daemon exit cleanly later. Any synchronous
+        // spawn error throws into the catch below; the 'error' event handler
+        // is registered so async failures don't crash the process either.
+        const child = (0, node_child_process_1.spawn)(exePath, [uri], { detached: true, stdio: 'ignore', windowsHide: false });
+        child.unref();
+        child.on('error', () => { });
+    }
+    catch (err) {
+        return { success: false, windowOpened: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    // Poll for a new visible top-level window. Compose windows take 500ms-2s
+    // to mount in New Outlook depending on cold/warm state.
+    const deadline = Date.now() + waitMs;
+    while (Date.now() < deadline) {
+        await new Promise(r => setTimeout(r, 250));
+        const after = await snapshotProcessWindows(exeBaseLower);
+        const fresh = [...after].find(label => !before.has(label));
+        if (fresh) {
+            return { success: true, windowOpened: true, hwndLabel: fresh };
+        }
+    }
+    return { success: true, windowOpened: false };
+}
+//# sourceMappingURL=uri-handler.js.map

package/dist/platform/uri-handler.js.map

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

package/dist/platform/wayland-backend.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Wayland input routing via ydotool / wtype.
+ *
+ * The Linux adapter's nut-js path silently fails on most Wayland
+ * compositors because synthetic input events are blocked at the
+ * compositor layer unless injected through a privileged daemon.
+ * This module provides a minimal backend that routes mouse + keyboard
+ * operations through `ydotool` (requires `ydotoold` running with
+ * uinput access) or `wtype` (keyboard-only).
+ *
+ * Detection order at construction:
+ *   1. `ydotool` + socket reachable → preferred (mouse + keyboard)
+ *   2. `wtype` → keyboard-only fallback
+ *   3. neither → `none`; caller must return graceful error
+ *
+ * ydotool reference:
+ *   mousemove --absolute <x> <y>
+ *   click 0xC0                  (left)   0xC1 (right)   0xC2 (middle)
+ *   key <code>:1                (down)   <code>:0      (up)
+ *   type --delay 10 "text"
+ *   mousemove -x <dx> -y <dy>  (relative)
+ *
+ * All command construction goes through `execFile` (not shell), so
+ * there is NO shell interpolation of user text — clawdcursor typing
+ * a string with `$` or backticks is safe.
+ */
+/** Which backend the LinuxAdapter should use on Wayland. */
+export type WaylandInputKind = 'ydotool' | 'wtype-keyboard-only' | 'none';
+export declare class WaylandBackend {
+    readonly kind: WaylandInputKind;
+    private readonly mod2code;
+    constructor(kind: WaylandInputKind);
+    static detect(hasBinary: (name: string) => Promise<boolean>): Promise<WaylandBackend>;
+    canMouse(): boolean;
+    canKeyboard(): boolean;
+    mouseMoveAbsolute(x: number, y: number): Promise<void>;
+    mouseMoveRelative(dx: number, dy: number): Promise<void>;
+    /** `click` is a down+up in one ydotool call. For separate down/up, use mouseDown/mouseUp. */
+    mouseClick(button?: 'left' | 'right' | 'middle', count?: number): Promise<void>;
+    mouseDown(button?: 'left' | 'right' | 'middle'): Promise<void>;
+    mouseUp(button?: 'left' | 'right' | 'middle'): Promise<void>;
+    mouseScroll(direction: 'up' | 'down' | 'left' | 'right', amount?: number): Promise<void>;
+    /**
+     * Press a key combo. On ydotool we map each component to a Linux
+     * keycode and emit paired down/up events. On wtype we use wtype's
+     * native combo syntax (e.g. `wtype -M ctrl -k s`).
+     */
+    keyPress(combo: string): Promise<void>;
+    keyDown(key: string): Promise<void>;
+    keyUp(key: string): Promise<void>;
+    typeText(text: string): Promise<void>;
+    private keyToCode;
+}