@hybridlabor-api/aos 4.0.2 → 4.1.0

package/mcps/computer-use-mcp/dist/native.d.ts

@@ -1,212 +0,0 @@
-/**
- * Native NAPI module loader — loads the compiled .node addon.
- * Supports macOS (darwin) and Windows (win32) with platform-specific binaries.
- */
-export interface AXBounds {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface AXElement {
-    role: string;
-    label: string | null;
-    value: string | null;
-    bounds: AXBounds;
-    actions: string[];
-    /** Present on full tree nodes; omitted by flat find_element results. */
-    children?: AXElement[];
-    /** Present on find_element results — indices from the walk root. */
-    path?: number[];
-    /** Set when a subtree or the whole tree hit the depth / node cap. */
-    truncated?: boolean;
-}
-export interface MenuItem {
-    title: string;
-    enabled: boolean;
-    shortcut?: string;
-    submenu?: MenuItem[];
-}
-export interface MenuBarEntry {
-    title: string;
-    enabled: boolean;
-    items: MenuItem[];
-}
-export interface WindowRecord {
-    windowId: number;
-    bundleId: string | null;
-    displayName: string;
-    pid: number;
-    title: string | null;
-    bounds: AXBounds;
-    isOnScreen: boolean;
-    isFocused: boolean;
-    displayId: number;
-}
-export interface NativeModule {
-    mouseMove(x: number, y: number): void;
-    mouseClick(x: number, y: number, button: string, count: number): void;
-    mouseButton(action: string, x: number, y: number): void;
-    mouseScroll(dy: number, dx: number): void;
-    mouseDrag(x: number, y: number): void;
-    cursorPosition(): {
-        x: number;
-        y: number;
-    };
-    keyPress(combo: string, repeat?: number): void;
-    typeText(text: string): void;
-    holdKey(keys: string[], durationMs: number): void;
-    activateApp(bundleId: string, timeoutMs?: number): {
-        bundleId: string;
-        activated: boolean;
-        displayName?: string;
-    };
-    getFrontmostApp(): {
-        bundleId: string;
-        displayName: string;
-        pid: number;
-    } | null;
-    getWindow(windowId: number): WindowRecord | null;
-    getCursorWindow(): WindowRecord | null;
-    activateWindow(windowId: number, timeoutMs?: number): {
-        windowId: number;
-        activated: boolean;
-        reason: string | null;
-    };
-    listWindows(bundleId?: string): Array<WindowRecord>;
-    listRunningApps(): Array<{
-        bundleId: string;
-        displayName: string;
-        pid: number;
-        isHidden: boolean;
-    }>;
-    hideApp(bundleId: string): boolean;
-    unhideApp(bundleId: string): boolean;
-    getDisplaySize(displayId?: number): {
-        width: number;
-        height: number;
-        pixelWidth: number;
-        pixelHeight: number;
-        scaleFactor: number;
-        displayId: number;
-    };
-    listDisplays(): Array<{
-        width: number;
-        height: number;
-        scaleFactor: number;
-        displayId: number;
-    }>;
-    takeScreenshot(width?: number, targetApp?: string, quality?: number, previousHash?: string, windowId?: number): {
-        base64?: string;
-        width: number;
-        height: number;
-        mimeType: string;
-        hash: string;
-        unchanged: boolean;
-    };
-    /** Depth-limited AX tree rooted at the window; caps at 500 nodes. */
-    getUiTree(windowId: number, maxDepth?: number): AXElement;
-    /** Currently focused AX element (or null). */
-    getFocusedElement(): AXElement | null;
-    /** Depth-first search within the window's AX tree. */
-    findElement(windowId: number, role?: string, label?: string, value?: string, maxResults?: number): AXElement[];
-    /** Perform an AX action (e.g. AXPress) on the first (role, label) match. */
-    performAction(windowId: number, role: string, label: string, action: string): {
-        performed: boolean;
-        reason?: string;
-        bounds?: AXBounds;
-    };
-    /** Set AXValue on the first (role, label) match. */
-    setElementValue(windowId: number, role: string, label: string, value: string): {
-        set: boolean;
-        reason?: string;
-    };
-    /** Walk the app's menu bar and return nested menu structure. */
-    getMenuBar(bundleId: string): MenuBarEntry[];
-    /** Press a named menu item, optionally nested under a submenu. */
-    pressMenuItem(bundleId: string, menu: string, item: string, submenu?: string): {
-        pressed: boolean;
-        reason?: string;
-    };
-    /** List user Spaces grouped by display, with the active Space ID. */
-    listSpaces(): {
-        supported: boolean;
-        reason?: string;
-        active_space_id: number | null;
-        displays: Array<{
-            display_id: string;
-            spaces: Array<{
-                id: number;
-                type: number;
-                uuid: string;
-            }>;
-        }>;
-    };
-    /** Active Space ID or null if CGS is unreachable. */
-    getActiveSpace(): number | null;
-    /** Create a new Space. Reports `attached: false` when the created Space is
-     *  orphaned (not visible in Mission Control). */
-    createAgentSpace(): {
-        supported: boolean;
-        spaceId?: number;
-        attached?: boolean;
-        reason?: string;
-        note?: string;
-    };
-    /** Move a window into a Space. `verified: true` only when the window
-     *  visibly disappears from the on-screen window list. */
-    moveWindowToSpace(windowId: number, spaceId: number): {
-        moved: boolean;
-        verified?: boolean;
-        reason?: string;
-        note?: string;
-        window_on_screen_before?: boolean;
-        window_on_screen_after?: boolean;
-    };
-    /** Remove a window from a Space (restores visibility). */
-    removeWindowFromSpace(windowId: number, spaceId: number): {
-        removed: boolean;
-        reason?: string;
-    };
-    /** Destroy a Space created via createAgentSpace. */
-    destroySpace(spaceId: number): {
-        destroyed: boolean;
-        reason?: string;
-    };
-    /**
-     * Pump the main CFRunLoop once. Used by the session layer during a CU
-     * session to keep NSWorkspace / AX state fresh. Cheap when idle.
-     */
-    drainRunloop(): void;
-    /** Read clipboard text (Windows native). Undefined on macOS. */
-    readClipboard?(): string;
-    /** Write text to clipboard (Windows native). Undefined on macOS. */
-    writeClipboard?(text: string): void;
-    /** Draw annotations and grid lines on an image. Cross-platform. */
-    annotateImage(base64Jpeg: string, annotations: string | null, gridCols: number | null, gridRows: number | null, quality: number | null): {
-        base64: string;
-        width: number;
-        height: number;
-        mimeType: string;
-    };
-    /** Crop a region from a base64 image at full resolution. Cross-platform. */
-    cropImage(base64Image: string, x1: number, y1: number, x2: number, y2: number, quality: number | null): {
-        base64: string;
-        width: number;
-        height: number;
-        mimeType: string;
-    };
-    /**
-     * Hide every regular running app except the target and the keep-visible
-     * set. Defends against focus-stealing background apps (screenshot
-     * watchers, notification panels) before input dispatch.
-     *
-     * Returns the bundle IDs we actually hid — apps already hidden are NOT
-     * included, so callers can restore exactly the state they changed.
-     */
-    prepareDisplay(targetBundleId: string, keepVisible: string[]): {
-        targetBundleId: string;
-        hiddenBundleIds: string[];
-    };
-}
-export declare function loadNative(): NativeModule;

package/mcps/computer-use-mcp/dist/native.js

@@ -1,50 +0,0 @@
-/**
- * Native NAPI module loader — loads the compiled .node addon.
- * Supports macOS (darwin) and Windows (win32) with platform-specific binaries.
- */
-import { createRequire } from 'module';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { fileURLToPath } from 'url';
-/**
- * Supported platform + architecture combinations.
- * Each entry maps to a binary named `computer-use-napi.${platform}-${arch}.node`.
- */
-const SUPPORTED_TARGETS = [
-    { platform: 'darwin', arch: 'arm64' },
-    { platform: 'darwin', arch: 'x64' },
-    { platform: 'win32', arch: 'x64' },
-    { platform: 'linux', arch: 'x64' },
-    { platform: 'linux', arch: 'arm64' },
-];
-/**
- * Resolve the path to the platform-specific native binary.
- * Throws a descriptive error on unsupported platforms or missing binaries.
- */
-function resolveAddonPath() {
-    const platform = process.platform;
-    const arch = process.arch;
-    const isSupported = SUPPORTED_TARGETS.some((t) => t.platform === platform && t.arch === arch);
-    if (!isSupported) {
-        const supported = SUPPORTED_TARGETS.map((t) => `${t.platform}-${t.arch}`).join(', ');
-        throw new Error(`Unsupported platform: ${platform}-${arch}. ` +
-            `Supported platforms: ${supported}.`);
-    }
-    const binaryName = `computer-use-napi.${platform}-${arch}.node`;
-    const binaryPath = join(fileURLToPath(import.meta.url), '..', '..', binaryName);
-    if (!existsSync(binaryPath)) {
-        throw new Error(`Native binary not found: ${binaryName}. ` +
-            `Expected at ${binaryPath}. ` +
-            `Run the appropriate build script to compile the native module for ${platform}-${arch}.`);
-    }
-    return binaryPath;
-}
-const require = createRequire(import.meta.url);
-const ADDON_PATH = resolveAddonPath();
-let cached;
-export function loadNative() {
-    if (cached)
-        return cached;
-    cached = require(ADDON_PATH);
-    return cached;
-}

package/mcps/computer-use-mcp/dist/server.d.ts

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-/**
- * Computer Use MCP Server — exposes tools over MCP protocol.
- * Backed by in-process Rust NAPI module via session.
- */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type Session, type SessionOptions } from './session.js';
-/**
- * v5.2 — How each tool reaches the target app.
- *
- * - `scripting`: executes via AppleScript / JXA (`osascript`). Works even when
- *   the target app is backgrounded or hidden. Cheapest path for scriptable
- *   apps (Mail, Safari, Finder, Numbers, Music, Messages, Notes, Calendar).
- * - `ax`: reads or mutates via the AXUIElement (Accessibility) API. Needs
- *   Accessibility permission. Reads are always safe; mutations typically
- *   require the target frontmost but some apps allow background AXPress.
- * - `cgevent`: synthesizes keyboard / mouse events via CGEvent. **Requires
- *   the target app to be frontmost** — events route to whatever has focus.
- * - `none`: pure observation of system state (clipboard, display size,
- *   cursor position). No target needed.
- */
-export type FocusRequired = 'scripting' | 'ax' | 'cgevent' | 'none';
-export interface ToolMeta {
-    focusRequired: FocusRequired;
-    /** Whether this tool is classified as mutating by the session layer. */
-    mutates: boolean;
-}
-export interface ServerOptions extends SessionOptions {
-    /** Override session instance for tests */
-    session?: Session;
-}
-export declare function createComputerUseServer(opts?: ServerOptions): McpServer;

package/mcps/computer-use-mcp/dist/server.js

@@ -1,342 +0,0 @@
-#!/usr/bin/env node
-/**
- * Computer Use MCP Server — exposes tools over MCP protocol.
- * Backed by in-process Rust NAPI module via session.
- */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-import { createSession } from './session.js';
-import { isStdioEntrypoint } from './entrypoint.js';
-const targetAppParam = z.string().optional().describe('Bundle ID of target app (auto-focuses before action)');
-const targetWindowIdParam = z.number().int().optional().describe('CGWindowID to target. Takes precedence over target_app.');
-const focusStrategyParam = z.enum(['strict', 'best_effort', 'none', 'prepare_display']).optional().describe('Focus strategy: strict (fail if unconfirmed), best_effort (try and proceed), none (skip activation), prepare_display (hide every non-target app before acting — v5.2, defeats focus-stealing background apps)');
-const coord = { coordinate: z.tuple([z.number(), z.number()]).describe('[x, y] pixels') };
-const withTargeting = (schema) => ({
-    ...schema,
-    target_app: targetAppParam,
-    target_window_id: targetWindowIdParam,
-    focus_strategy: focusStrategyParam,
-});
-const PROVIDERS = ['anthropic', 'openai', 'openai-low', 'gemini', 'llama', 'grok', 'mistral', 'qwen', 'nova', 'deepseek-vl', 'phi', 'auto'];
-export function createComputerUseServer(opts = {}) {
-    const server = new McpServer({ name: 'computer-use', version: '6.1.0' });
-    const session = opts.session ?? createSession({
-        vision: opts.vision ?? (process.env.COMPUTER_USE_VISION !== 'false'),
-        provider: opts.provider ?? process.env.COMPUTER_USE_PROVIDER,
-        native: opts.native,
-    });
-    // v5.2: Per-tool metadata registry. Populated as each `tool()` call runs.
-    // Exposed to clients via the new `get_tool_metadata` tool and appended to
-    // each tool's description as `[focusRequired: X]` so agents that read
-    // descriptions can filter without a separate call.
-    const toolMeta = new Map();
-    // Shorthand for common metadata combos, so each tool() call stays readable.
-    const CG_MUT = { focusRequired: 'cgevent', mutates: true };
-    const AX_MUT = { focusRequired: 'ax', mutates: true };
-    const AX_READ = { focusRequired: 'ax', mutates: false };
-    const SCRIPTING = { focusRequired: 'scripting', mutates: true };
-    const SCRIPT_READ = { focusRequired: 'scripting', mutates: false };
-    const NONE_READ = { focusRequired: 'none', mutates: false };
-    const NONE_MUT = { focusRequired: 'none', mutates: true };
-    const tool = (name, desc, schema, meta) => {
-        toolMeta.set(name, meta);
-        const tagged = `${desc} [focusRequired: ${meta.focusRequired}]`;
-        server.tool(name, tagged, schema, async (args) => {
-            const result = await session.dispatch(name, args);
-            return {
-                content: result.content.map(c => c.type === 'image'
-                    ? { type: 'image', data: c.data, mimeType: c.mimeType }
-                    : { type: 'text', text: c.text }),
-                isError: result.isError,
-            };
-        });
-    };
-    tool('screenshot', 'Capture the screen or a specific window. BEFORE using this, consider get_ui_tree or find_element to discover UI by role/label — structured queries are cheaper than visual parsing. Auto-targets the active session window when no explicit target is given.', {
-        width: z.number().int().positive().optional()
-            .describe('Override width in pixels. Omit to use provider-optimal default.'),
-        quality: z.number().int().min(0).max(100).optional()
-            .describe('Image quality. 1-100 = JPEG quality. 0 = PNG (lossless). Default: 80 (JPEG).'),
-        target_app: z.string().optional()
-            .describe('Bundle ID of app to capture (window only). Omit for full screen.'),
-        target_window_id: targetWindowIdParam,
-        provider: z.enum(PROVIDERS).optional()
-            .describe('AI provider — sets optimal default width. anthropic=1024px, openai=1024px, gemini=768px, qwen/deepseek-vl/phi=896px. Default: auto (1024px).'),
-    }, NONE_READ);
-    tool('zoom', 'View a specific region of the screen at full resolution. Useful for reading small text, inspecting UI details, or verifying pixel-level content. Returns the cropped region without downscaling.', {
-        region: z.tuple([z.number().int(), z.number().int(), z.number().int(), z.number().int()])
-            .describe('[x1, y1, x2, y2] — top-left and bottom-right corners of the region to inspect'),
-        quality: z.number().int().min(0).max(100).optional()
-            .describe('Image quality. 0 = PNG (lossless, best for text). 1-100 = JPEG. Default: 0 (PNG).'),
-    }, NONE_READ);
-    // Pointer / keyboard — CGEvent, target must be frontmost.
-    tool('left_click', 'Left-click at coordinates', withTargeting(coord), CG_MUT);
-    tool('right_click', 'Right-click at coordinates', withTargeting(coord), CG_MUT);
-    tool('middle_click', 'Middle-click at coordinates', withTargeting(coord), CG_MUT);
-    tool('double_click', 'Double-click at coordinates', withTargeting(coord), CG_MUT);
-    tool('triple_click', 'Triple-click at coordinates', withTargeting(coord), CG_MUT);
-    tool('mouse_move', 'Move cursor to coordinates', withTargeting(coord), CG_MUT);
-    tool('left_click_drag', 'Click and drag', withTargeting({
-        coordinate: z.tuple([z.number(), z.number()]),
-        start_coordinate: z.tuple([z.number(), z.number()]).optional(),
-    }), CG_MUT);
-    tool('cursor_position', 'Get current cursor position', {}, NONE_READ);
-    tool('left_mouse_down', 'Press left mouse button', withTargeting(coord), CG_MUT);
-    tool('left_mouse_up', 'Release left mouse button', withTargeting(coord), CG_MUT);
-    tool('scroll', 'Scroll at position', {
-        ...coord,
-        direction: z.enum(['up', 'down', 'left', 'right']),
-        amount: z.number().int().positive().default(3),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-        focus_strategy: focusStrategyParam,
-    }, CG_MUT);
-    tool('type', 'Type text into the focused app. For form fields, prefer set_value or fill_form — accessibility-based writes are more reliable and need no click-to-focus.', {
-        text: z.string(),
-        clear: z.boolean().optional().describe('Clear existing text before typing (Ctrl+A, Delete)'),
-        press_enter: z.boolean().optional().describe('Press Enter/Return after typing to submit'),
-        caret_position: z.enum(['start', 'end', 'idle']).optional().describe('Move caret before typing: start (Home), end (End), idle (leave as-is)'),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-        focus_strategy: focusStrategyParam,
-    }, CG_MUT);
-    tool('key', 'Press a key combination (e.g. "command+c", "return"). Tab and Shift+Tab navigate between form fields; keyboard shortcuts are usually faster than coordinate-based clicks.', {
-        text: z.string().describe('Key combo like "command+c" or "return"'),
-        repeat: z.number().int().positive().optional(),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-        focus_strategy: focusStrategyParam,
-    }, CG_MUT);
-    tool('hold_key', 'Hold keys for a duration', {
-        keys: z.array(z.string()),
-        duration: z.number().positive().describe('Seconds'),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-        focus_strategy: focusStrategyParam,
-    }, CG_MUT);
-    // Clipboard — touches pasteboard only, no focus dependency.
-    tool('read_clipboard', 'Read clipboard contents', {}, NONE_READ);
-    tool('write_clipboard', 'Write text to clipboard', { text: z.string() }, NONE_MUT);
-    // App / window lifecycle — NSWorkspace/AX mutations.
-    tool('open_application', 'Open and focus an app by bundle ID', {
-        bundle_id: z.string().describe('macOS bundle ID e.g. "com.apple.Safari"'),
-    }, AX_MUT);
-    tool('get_frontmost_app', 'Get the currently frontmost app', {}, AX_READ);
-    tool('list_windows', 'List visible on-screen windows, optionally filtered by bundle ID', {
-        bundle_id: z.string().optional().describe('Bundle ID to filter windows by'),
-    }, AX_READ);
-    tool('list_running_apps', 'List all running regular applications', {}, AX_READ);
-    tool('hide_app', 'Hide an app by bundle ID', { bundle_id: z.string() }, AX_MUT);
-    tool('unhide_app', 'Unhide an app by bundle ID', { bundle_id: z.string() }, AX_MUT);
-    tool('get_display_size', 'Get display dimensions and scale factor', {
-        display_id: z.number().optional().describe('Display ID (omit for main display)'),
-    }, NONE_READ);
-    tool('list_displays', 'List all connected displays', {}, NONE_READ);
-    tool('get_window', 'Look up a window by its CGWindowID', {
-        window_id: z.number().int().describe('CGWindowID of the window to look up'),
-    }, AX_READ);
-    tool('get_cursor_window', 'Get the window currently under the mouse cursor', {}, AX_READ);
-    tool('activate_app', 'Activate an app and return structured before/after diagnostics', {
-        bundle_id: z.string().describe('macOS bundle ID'),
-        timeout_ms: z.number().int().positive().optional().describe('Activation polling timeout in ms'),
-    }, AX_MUT);
-    tool('activate_window', 'Raise a specific window by CGWindowID', {
-        window_id: z.number().int().describe('CGWindowID of the window to raise'),
-        timeout_ms: z.number().int().positive().optional().describe('Activation polling timeout in ms'),
-    }, AX_MUT);
-    tool('resize_window', 'Resize and/or move a window. Omit window_name to target the foreground window.', {
-        window_name: z.string().optional().describe('Window title or process name to target (omit for foreground)'),
-        window_id: z.number().int().optional().describe('Window ID to target (takes precedence over window_name)'),
-        window_size: z.tuple([z.number().int(), z.number().int()]).optional().describe('[width, height] in pixels'),
-        window_loc: z.tuple([z.number().int(), z.number().int()]).optional().describe('[x, y] top-left position'),
-    }, AX_MUT);
-    tool('wait', 'Wait for N seconds', { duration: z.number().positive().max(300) }, NONE_READ);
-    tool('snapshot', 'Combined screenshot + UI tree + window list + desktop info in one call. Returns structured text with all desktop state. Set use_vision=true to include screenshot image. Set use_annotation=true to draw bounding boxes on UI elements. Set grid_lines=[cols,rows] to overlay reference grid.', {
-        use_vision: z.boolean().optional().default(false).describe('Include screenshot image in response'),
-        use_annotation: z.boolean().optional().default(false).describe('Draw bounding boxes on detected UI elements'),
-        grid_lines: z.tuple([z.number().int(), z.number().int()]).optional().describe('[columns, rows] for reference grid overlay'),
-        display: z.array(z.number().int()).optional().describe('Monitor indices to capture (omit for all)'),
-        width: z.number().int().positive().optional().describe('Resize screenshot width'),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-    }, NONE_READ);
-    // ── v5: Accessibility observation ───────────────────────────────────────
-    tool('get_ui_tree', 'Get the accessibility tree for a window — discover UI elements by role/label instead of parsing pixels. Returns role, label, value, bounds, actions, children per node. Capped at 500 nodes.', {
-        window_id: z.number().int().describe('CGWindowID to introspect'),
-        max_depth: z.number().int().positive().max(20).optional().describe('Maximum tree depth (default 10, max 20)'),
-    }, AX_READ);
-    tool('get_focused_element', 'Get the currently focused UI element — where typed text will go. Returns null if no element has focus.', {}, AX_READ);
-    tool('find_element', 'Search for UI elements in a window by role, label, or value (AND of the provided criteria). Faster than walking the full tree.', {
-        window_id: z.number().int().describe('CGWindowID to search within'),
-        role: z.string().optional().describe('AX role — e.g. AXButton, AXTextField, AXStaticText, AXMenuItem'),
-        label: z.string().optional().describe('Element label (AXTitle or AXDescription); case-insensitive substring match'),
-        value: z.string().optional().describe('Element value (AXValue); case-insensitive substring match'),
-        max_results: z.number().int().positive().max(100).optional().describe('Max matches to return (default 25)'),
-    }, AX_READ);
-    // ── v5: Semantic actions ────────────────────────────────────────────────
-    tool('click_element', 'Click a UI element by role and label — more reliable than pixel clicks (survives window moves and resolution changes). Falls back to coordinate click if AXPress is unsupported.', {
-        window_id: z.number().int().describe('CGWindowID of the window containing the element'),
-        role: z.string().describe('AX role of the element to click (e.g. AXButton)'),
-        label: z.string().describe('Element label — matched against AXTitle/AXDescription'),
-        focus_strategy: focusStrategyParam,
-    }, AX_MUT);
-    tool('set_value', 'Set a UI element\'s value directly (e.g. text field content). Avoids the click → type dance. Defaults to strict focus since it writes text.', {
-        window_id: z.number().int().describe('CGWindowID of the window containing the element'),
-        role: z.string().describe('AX role (usually AXTextField or AXTextArea)'),
-        label: z.string().describe('Element label'),
-        value: z.string().describe('New value to set'),
-        focus_strategy: focusStrategyParam,
-    }, AX_MUT);
-    tool('press_button', 'Press a button by its label. Shortcut over click_element for role=AXButton.', {
-        window_id: z.number().int().describe('CGWindowID of the window containing the button'),
-        label: z.string().describe('Button label'),
-        focus_strategy: focusStrategyParam,
-    }, AX_MUT);
-    tool('select_menu_item', 'Select an app menu item programmatically — walks AXMenuBar. Returns list of available menus on miss.', {
-        bundle_id: z.string().describe('Bundle ID of the app'),
-        menu: z.string().describe('Top-level menu title (e.g. "File")'),
-        item: z.string().describe('Menu item title (e.g. "New")'),
-        submenu: z.string().optional().describe('Submenu title when the item is nested'),
-    }, AX_MUT);
-    tool('fill_form', 'Set multiple UI element values in a single call — collapses click+type loops into one tool call. Partial failures are reported per field without aborting the batch.', {
-        window_id: z.number().int().describe('CGWindowID of the form window'),
-        fields: z.array(z.object({
-            role: z.string(),
-            label: z.string(),
-            value: z.string(),
-        })).describe('Ordered list of fields to fill'),
-        focus_strategy: focusStrategyParam,
-    }, AX_MUT);
-    // ── v5: Scripting bridge ────────────────────────────────────────────────
-    tool('run_script', 'Execute a script and return the output. On macOS: AppleScript or JXA for scriptable apps. On Windows: PowerShell. Bounded by timeout_ms.', {
-        language: z.enum(['applescript', 'javascript', 'powershell']).describe('Scripting language (applescript/javascript on macOS, powershell on Windows)'),
-        script: z.string().describe('Script body to execute'),
-        timeout_ms: z.number().int().positive().max(120_000).optional().describe('Hard timeout in ms (default 30000, max 120000)'),
-    }, SCRIPTING);
-    tool('get_app_dictionary', 'Get a scriptable app\'s dictionary (suites, commands, classes). Returns summarized names by default; pass `suite` for full details of one suite.', {
-        bundle_id: z.string().describe('Bundle ID of the scriptable app'),
-        suite: z.string().optional().describe('Limit to a specific suite; omit for a summary'),
-    }, SCRIPT_READ);
-    // ── v5.1: Menu bar introspection ────────────────────────────────────────
-    tool('list_menu_bar', 'List an app\'s full menu bar structure with keyboard shortcuts. Use this BEFORE select_menu_item to see what menus / items / shortcuts exist — agents can then press the shortcut directly (faster than walking the menu) or pass the exact item title to select_menu_item.', {
-        bundle_id: z.string().describe('Bundle ID of the app whose menu bar to read'),
-    }, AX_READ);
-    // ── v5: Strategy advisor ────────────────────────────────────────────────
-    tool('get_tool_guide', 'Recommend the best automation approach for a task. Call this BEFORE committing to screenshot-and-click — it suggests scripting or accessibility paths when they exist.', {
-        task_description: z.string().describe('Natural-language description of the task to automate'),
-    }, NONE_READ);
-    tool('get_app_capabilities', 'Discover what automation approaches work for an app: scriptable? accessible? running? hidden?', {
-        bundle_id: z.string().describe('Bundle ID to probe'),
-    }, AX_READ);
-    // ── v5: Agent Spaces ────────────────────────────────────────────────────
-    // macOS Space mutation uses best-effort backends selected by
-    // COMPUTER_USE_SPACES_BACKEND: yabai, Mission Control gestures, then CGS.
-    // CGS-created Spaces can be orphaned on SIP-enabled Macs.
-    tool('list_spaces', 'List user Spaces grouped by display. Always works — pure read via CGS.', {}, NONE_READ);
-    tool('get_active_space', 'Get the currently active Space ID.', {}, NONE_READ);
-    tool('create_agent_space', 'Create a new virtual desktop/Space. On macOS, auto-selects yabai, Mission Control gesture automation, or CGS fallback. On Windows uses Ctrl+Win+D keyboard shortcut.', {}, AX_MUT);
-    tool('move_window_to_space', 'Move a window to a virtual desktop/Space. On macOS, prefers yabai and falls back to private CGS APIs.', {
-        window_id: z.number().int().describe('Window ID to move'),
-        space_id: z.number().int().describe('Target Space/desktop ID'),
-    }, AX_MUT);
-    tool('remove_window_from_space', 'Remove a window from a virtual desktop/Space. Best effort on macOS because private CGS APIs may no-op without elevated entitlements.', {
-        window_id: z.number().int().describe('Window ID to remove'),
-        space_id: z.number().int().describe('Space/desktop ID to remove the window from'),
-    }, AX_MUT);
-    tool('destroy_space', 'Close a virtual desktop/Space. On macOS, prefers yabai and falls back to private CGS APIs. On Windows uses Ctrl+Win+F4.', {
-        space_id: z.number().int().optional().describe('Space ID to destroy (ignored on Windows — always closes current)'),
-    }, AX_MUT);
-    // ── v5.2: Tool metadata introspection ───────────────────────────────────
-    //
-    // This is the only tool that doesn't go through session.dispatch —
-    // it reads directly from the toolMeta registry populated by each
-    // tool() registration above. Pure read; no side effects.
-    server.tool('get_tool_metadata', 'Get structured metadata for a tool: focusRequired (scripting|ax|cgevent|none) and mutates (bool). Useful for agents that want to filter tools by their focus requirements — e.g. "show me only tools I can use while Safari is backgrounded". [focusRequired: none]', { tool_name: z.string().describe('Name of the tool to inspect') }, async (args) => {
-        const name = typeof args.tool_name === 'string' ? args.tool_name : '';
-        const meta = toolMeta.get(name);
-        if (!meta) {
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify({ error: 'unknown_tool', tool_name: name }),
-                    }],
-                isError: true,
-            };
-        }
-        return {
-            content: [{ type: 'text', text: JSON.stringify({ tool_name: name, ...meta }) }],
-        };
-    });
-    toolMeta.set('get_tool_metadata', { focusRequired: 'none', mutates: false });
-    // ── Windows-parity tools (cross-platform where possible) ────────────────
-    // FileSystem tool — Node.js fs, cross-platform
-    tool('filesystem', 'File and directory operations: read, write, copy, move, delete, list, search, info. Relative paths resolve from Desktop.', {
-        mode: z.enum(['read', 'write', 'copy', 'move', 'delete', 'list', 'search', 'info']).describe('Operation mode'),
-        path: z.string().describe('File or directory path'),
-        destination: z.string().optional().describe('Destination path for copy/move'),
-        content: z.string().optional().describe('Content for write mode'),
-        pattern: z.string().optional().describe('Glob pattern for list/search'),
-        recursive: z.boolean().optional().default(false).describe('Recursive delete/list/search'),
-        append: z.boolean().optional().default(false).describe('Append instead of overwrite'),
-        overwrite: z.boolean().optional().default(false).describe('Overwrite existing for copy/move'),
-        offset: z.number().int().optional().describe('Line offset for read'),
-        limit: z.number().int().optional().describe('Line limit for read'),
-        encoding: z.string().optional().default('utf-8').describe('File encoding'),
-        show_hidden: z.boolean().optional().default(false).describe('Show hidden files in list'),
-    }, NONE_MUT);
-    // Process tool — list and kill processes
-    tool('process_kill', 'List and kill running processes. mode=list for process listing, mode=kill to terminate by name or PID.', {
-        mode: z.enum(['list', 'kill']).describe('Operation mode'),
-        name: z.string().optional().describe('Process name to filter/kill'),
-        pid: z.number().int().optional().describe('Process ID to kill'),
-        force: z.boolean().optional().default(false).describe('Force kill without graceful close'),
-        sort_by: z.enum(['memory', 'cpu', 'name']).optional().default('memory').describe('Sort field for list'),
-        limit: z.number().int().optional().default(20).describe('Max processes to list'),
-    }, NONE_MUT);
-    // Registry tool — Windows only
-    tool('registry', 'Windows Registry operations: get, set, delete, list. Paths use PowerShell format (HKCU:\\Software\\...). Windows only.', {
-        mode: z.enum(['get', 'set', 'delete', 'list']).describe('Operation mode'),
-        path: z.string().describe('Registry path in PowerShell format'),
-        name: z.string().optional().describe('Value name'),
-        value: z.string().optional().describe('Value data for set mode'),
-        type: z.enum(['String', 'DWord', 'QWord', 'Binary', 'MultiString', 'ExpandString']).optional().default('String').describe('Value type for set'),
-    }, NONE_MUT);
-    // Notification tool — Windows only
-    tool('notification', 'Send a Windows toast notification. Windows only.', {
-        title: z.string().describe('Notification title'),
-        message: z.string().describe('Notification body text'),
-        app_id: z.string().optional().describe('Application User Model ID'),
-    }, NONE_MUT);
-    // MultiSelect tool — batch click with optional Ctrl hold
-    tool('multi_select', 'Select multiple items by clicking coordinates or UI element labels. Set press_ctrl=true for additive selection.', {
-        locs: z.array(z.tuple([z.number(), z.number()])).optional().describe('List of [x,y] coordinates'),
-        labels: z.array(z.string()).optional().describe('List of UI element labels'),
-        press_ctrl: z.boolean().optional().default(true).describe('Hold Ctrl for additive selection'),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-        focus_strategy: focusStrategyParam,
-    }, CG_MUT);
-    // MultiEdit tool — batch click+type
-    tool('multi_edit', 'Enter text into multiple fields. Provide locs as [[x,y,text],...] or labels as [[label,text],...].', {
-        locs: z.array(z.tuple([z.number(), z.number(), z.string()])).optional().describe('List of [x,y,text] tuples'),
-        labels: z.array(z.tuple([z.string(), z.string()])).optional().describe('List of [label,text] tuples'),
-        target_app: targetAppParam,
-        target_window_id: targetWindowIdParam,
-        focus_strategy: focusStrategyParam,
-    }, CG_MUT);
-    // Scrape tool — fetch web page content
-    tool('scrape', 'Fetch and extract content from a URL. Returns clean text from web pages. Set use_dom=true to extract from active browser tab DOM instead of HTTP fetch.', {
-        url: z.string().describe('URL to fetch'),
-        query: z.string().optional().describe('Focus extraction on specific information'),
-        use_dom: z.boolean().optional().default(false).describe('Extract from active browser tab DOM instead of HTTP'),
-    }, NONE_READ);
-    return server;
-}
-// Standalone stdio entrypoint. Detection lives in ./entrypoint.ts so it is
-// unit-testable without loading the native NAPI binary.
-if (isStdioEntrypoint(process.argv[1])) {
-    const server = createComputerUseServer();
-    const transport = new StdioServerTransport();
-    server.connect(transport).then(() => console.error('[computer-use-mcp] Server running'))
-        .catch(err => { console.error('Fatal:', err); process.exit(1); });
-}