awb-agent-manager 1.0.0

package/dist/lib/host-mcp/screens.js

@@ -0,0 +1,172 @@
+import { findBinary, hostPlatform, isWayland, runCommand, runPowerShell } from './platform.js';
+export async function listScreens() {
+    const plat = hostPlatform();
+    try {
+        if (plat === 'win32')
+            return await listScreensWin();
+        if (plat === 'darwin')
+            return await listScreensMac();
+        return isWayland() ? await listScreensWayland() : await listScreensX11();
+    }
+    catch (err) {
+        return { ok: false, error: `list_screens failed: ${err?.message ?? err}` };
+    }
+}
+async function listScreensWin() {
+    const script = `
+$ErrorActionPreference = 'Stop'
+Add-Type -AssemblyName System.Windows.Forms
+$idx = 0
+$out = foreach ($s in [System.Windows.Forms.Screen]::AllScreens) {
+  $row = [pscustomobject]@{
+    index   = $idx
+    x       = $s.Bounds.X
+    y       = $s.Bounds.Y
+    width   = $s.Bounds.Width
+    height  = $s.Bounds.Height
+    primary = [bool]$s.Primary
+    scale   = $null
+    name    = $s.DeviceName
+  }
+  $idx++
+  $row
+}
+$out | ConvertTo-Json -Depth 3 -Compress
+`;
+    const r = await runPowerShell(script, { timeoutMs: 8000 });
+    if (r.spawnFailed)
+        return { ok: false, error: 'PowerShell not available', hint: 'Install PowerShell or pwsh' };
+    if (r.code !== 0)
+        return { ok: false, error: `Screen.AllScreens failed: ${r.stderr.trim() || `exit ${r.code}`}` };
+    return parseMonitors(r.stdout, 'win32');
+}
+async function listScreensMac() {
+    const script = `
+import json, sys
+try:
+  import AppKit
+except Exception as e:
+  print('[]')
+  sys.exit(0)
+main = AppKit.NSScreen.mainScreen()
+out = []
+for i, s in enumerate(AppKit.NSScreen.screens()):
+  f = s.frame()
+  out.append({
+    'index': i,
+    'x': int(f.origin.x),
+    'y': int(f.origin.y),
+    'width': int(f.size.width),
+    'height': int(f.size.height),
+    'primary': bool(s == main),
+    'scale': float(s.backingScaleFactor()),
+    'name': str(s.localizedName()) if hasattr(s, 'localizedName') else None,
+  })
+print(json.dumps(out))
+`;
+    const r = await runCommand('/usr/bin/python3', ['-c', script], { timeoutMs: 6000 });
+    if (r.spawnFailed) {
+        return {
+            ok: false,
+            error: 'python3 not available for AppKit display enumeration',
+            hint: 'Install python3 (xcode-select --install) or use display=0 implicitly',
+        };
+    }
+    if (r.code !== 0) {
+        return { ok: false, error: `AppKit enumeration exited ${r.code}: ${r.stderr.trim()}` };
+    }
+    return parseMonitors(r.stdout, 'darwin');
+}
+async function listScreensX11() {
+    const bin = await findBinary(['xrandr']);
+    if (!bin) {
+        return {
+            ok: false,
+            error: 'xrandr not installed',
+            hint: 'apt install x11-xserver-utils',
+        };
+    }
+    const r = await runCommand('xrandr', ['--listmonitors'], { timeoutMs: 5000 });
+    if (r.spawnFailed || r.code !== 0) {
+        return { ok: false, error: `xrandr failed: ${r.stderr.trim() || `exit ${r.code}`}` };
+    }
+    const monitors = [];
+    for (const line of r.stdout.split('\n')) {
+        const m = /^\s*(\d+):\s*\+(\*?)\S+\s+(\d+)\/\d+x(\d+)\/\d+\+(-?\d+)\+(-?\d+)\s+(\S+)/.exec(line);
+        if (!m)
+            continue;
+        monitors.push({
+            index: Number(m[1]),
+            x: Number(m[5]),
+            y: Number(m[6]),
+            width: Number(m[3]),
+            height: Number(m[4]),
+            primary: m[2] === '*',
+            scale: null,
+            name: m[7],
+        });
+    }
+    return {
+        ok: true,
+        monitors,
+        platform: 'linux',
+        warning: monitors.length === 0 ? 'xrandr returned no monitor rows' : undefined,
+    };
+}
+async function listScreensWayland() {
+    const wlr = await findBinary(['wlr-randr']);
+    if (wlr) {
+        const r = await runCommand('wlr-randr', ['--json'], { timeoutMs: 5000 });
+        if (!r.spawnFailed && r.code === 0 && r.stdout.trim()) {
+            try {
+                const data = JSON.parse(r.stdout);
+                const monitors = [];
+                let idx = 0;
+                for (const dev of Array.isArray(data) ? data : []) {
+                    const currentMode = (dev.modes || []).find((m) => m.current) || (dev.modes || [])[0];
+                    const pos = dev.position || { x: 0, y: 0 };
+                    monitors.push({
+                        index: idx++,
+                        x: Number(pos.x ?? 0),
+                        y: Number(pos.y ?? 0),
+                        width: Number(currentMode?.width ?? 0),
+                        height: Number(currentMode?.height ?? 0),
+                        primary: idx === 1 && !!dev.enabled,
+                        scale: typeof dev.scale === 'number' ? dev.scale : null,
+                        name: dev.name || dev.make || null,
+                    });
+                }
+                return { ok: true, monitors, platform: 'linux' };
+            }
+            catch (err) {
+                return { ok: false, error: `wlr-randr JSON parse: ${err?.message ?? err}` };
+            }
+        }
+    }
+    return listScreensX11();
+}
+function parseMonitors(stdout, platform) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return { ok: true, monitors: [], platform, warning: 'enumeration returned empty output' };
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch (err) {
+        return { ok: false, error: `JSON parse failed: ${err?.message ?? err}` };
+    }
+    const list = Array.isArray(parsed) ? parsed : [parsed];
+    const monitors = list.map((r, i) => ({
+        index: typeof r.index === 'number' ? r.index : i,
+        x: Number(r.x ?? 0),
+        y: Number(r.y ?? 0),
+        width: Number(r.width ?? 0),
+        height: Number(r.height ?? 0),
+        primary: !!r.primary,
+        scale: typeof r.scale === 'number' ? r.scale : null,
+        name: typeof r.name === 'string' ? r.name : null,
+    }));
+    return { ok: true, monitors, platform };
+}
+//# sourceMappingURL=screens.js.map

package/dist/lib/host-mcp/screens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screens.js","sourceRoot":"","sources":["../../../src/lib/host-mcp/screens.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA8B/F,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,MAAM,cAAc,EAAE,CAAC;QACpD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,cAAc,EAAE,CAAC;QACrD,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC;IAC3E,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,EAAE,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc;IAI3B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;CAmBhB,CAAC;IACA,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;IAC/G,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;IAClH,OAAO,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,cAAc;IAM3B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBhB,CAAC;IACA,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,sDAAsD;YAC7D,IAAI,EAAE,sEAAsE;SAC7E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,cAAc;IAI3B,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,+BAA+B;SACtC,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;IACvF,CAAC;IACD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,2EAA2E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjG,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;YACrB,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SACX,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,SAAS;KAC/E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB;IAI/B,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM,QAAQ,GAAkB,EAAE,CAAC;gBACnC,IAAI,GAAG,GAAG,CAAC,CAAC;gBACZ,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBAClD,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1F,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC3C,QAAQ,CAAC,IAAI,CAAC;wBACZ,KAAK,EAAE,GAAG,EAAE;wBACZ,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;wBACrB,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;wBACrB,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,CAAC;wBACtC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;wBACxC,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO;wBACnC,KAAK,EAAE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;wBACvD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI;qBACnC,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YACnD,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,EAAE,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,QAAgB;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IACxG,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAkB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;QAC/D,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QACpB,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACnD,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;KACjD,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

package/dist/lib/host-mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createHostMcpServer(): McpServer;
+export declare function runHostMcpServerOverStdio(): Promise<void>;

package/dist/lib/host-mcp/server.js

@@ -0,0 +1,233 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { clipboardRead, clipboardWrite, focusWindow, killProcess, launchProcess, listProcesses, listWindows, mouseClick, mouseMove, osInfo, readFileTail, screenshotWindow, sendKeys, shellExec, takeScreenshot, waitForFile, } from './tools.js';
+import { listScreens } from './screens.js';
+import { findUnityLogs } from './logs.js';
+function okText(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+}
+function errText(message, extra) {
+    const payload = extra ? { error: message, ...extra } : { error: message };
+    return { content: [{ type: 'text', text: JSON.stringify(payload) }], isError: true };
+}
+function imageReply(base64Png, meta) {
+    return {
+        content: [
+            { type: 'image', data: base64Png, mimeType: 'image/png' },
+            { type: 'text', text: JSON.stringify(meta, null, 2) },
+        ],
+    };
+}
+const HOST_MCP_SERVER_NAME = 'awb-host';
+const HOST_MCP_SERVER_VERSION = '1.0.0';
+export function createHostMcpServer() {
+    const server = new McpServer({ name: HOST_MCP_SERVER_NAME, version: HOST_MCP_SERVER_VERSION }, { capabilities: {} });
+    server.tool('screenshot', 'Capture a full-screen screenshot of the host the agent-manager is running on. ' +
+        'Returns the PNG inline as an image content block (the model can see it directly) plus a JSON text block with width, height, saved_path, platform, backend. ' +
+        'Use this when you suspect a GUI tool (Unity Editor, browser, IDE) has popped up a modal, crashed, or otherwise stalled — a screenshot will tell you what state the screen is in. ' +
+        'Cross-OS: Windows uses System.Drawing, macOS uses screencapture, Linux uses grim / scrot / gnome-screenshot / import depending on what is installed.', {
+        save_path: z.string().optional().describe('Optional absolute path to also write the PNG to (in addition to returning base64).'),
+        display: z.number().int().optional().describe('Display index, 0 = primary. Honored on Windows / Linux X11.'),
+    }, async (args) => {
+        const result = await takeScreenshot(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint, details: result.details });
+        return imageReply(result.base64_png, {
+            width: result.width,
+            height: result.height,
+            saved_path: result.saved_path,
+            platform: result.platform,
+            backend: result.backend,
+        });
+    });
+    server.tool('window_screenshot', 'Capture a screenshot of the first visible window whose title matches a regex pattern. ' +
+        'Useful when the agent needs to focus on a single app (e.g. Unity Editor, Visual Studio) without the rest of the desktop in frame. ' +
+        'On Linux Wayland (no per-window capture API) the implementation falls back to a full-screen capture and marks the backend with `wayland-fallback-fullscreen`. ' +
+        'Default `focus_first=true` brings the window to the foreground before capturing.', {
+        title_pattern: z.string().describe('Regex (JS syntax, case-insensitive) matched against window titles. First visible match wins.'),
+        save_path: z.string().optional().describe('Optional absolute path to also write the PNG to.'),
+        focus_first: z.boolean().optional().describe('Focus the target window before capture. Default true.'),
+    }, async (args) => {
+        const result = await screenshotWindow(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint, details: result.details });
+        return imageReply(result.base64_png, {
+            width: result.width,
+            height: result.height,
+            saved_path: result.saved_path,
+            platform: result.platform,
+            backend: result.backend,
+        });
+    });
+    server.tool('list_windows', 'List visible windows on the host with their pid, title, and geometry. ' +
+        'Pass `title_pattern` to filter by regex. Use this to discover which window to target with `focus_window` / `window_screenshot` / `send_keys`. ' +
+        'On Linux Wayland this returns an empty list (no portable API).', {
+        title_pattern: z.string().optional().describe('Optional regex (JS syntax) to filter by window title.'),
+        include_hidden: z.boolean().optional().describe('Include not-currently-visible windows. Default false. Honored only on Windows.'),
+    }, async (args) => {
+        const result = await listWindows(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText({ count: result.windows.length, windows: result.windows, platform: result.platform });
+    });
+    server.tool('focus_window', 'Bring the first visible window matching `title_pattern` to the foreground. ' +
+        'Required as a precondition for `send_keys` / `mouse_click` on most platforms — input gets routed to whatever window currently has focus.', {
+        title_pattern: z.string().describe('Regex (JS syntax, case-insensitive) matched against window titles. First visible match wins.'),
+    }, async (args) => {
+        const result = await focusWindow(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({ title: result.title, platform: result.platform });
+    });
+    server.tool('send_keys', 'Send keystrokes to the currently-focused window (or focus a window first by passing `focus_window`). ' +
+        'Two modes: literal typing (default — `keys` is typed verbatim) OR hotkey chord (`chord:true` — `keys` is parsed as `ctrl+shift+p`, `cmd+s`, `f5`, `enter`, etc.). ' +
+        'On macOS, `cmd` maps to Command; on Windows, `cmd` falls back to Ctrl (Win key is not exposed via SendKeys). ' +
+        'Linux Wayland requires `wtype` (or `ydotool` with the daemon running).', {
+        keys: z.string().describe('Text to type, or hotkey chord like "ctrl+p" when `chord` is true.'),
+        chord: z.boolean().optional().describe('Parse `keys` as a hotkey chord instead of literal text. Default false.'),
+        focus_window: z.string().optional().describe('Optional title regex — focus this window before sending keys.'),
+    }, async (args) => {
+        const result = await sendKeys(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({ sent: true, platform: result.platform });
+    });
+    server.tool('mouse_click', 'Click at absolute screen coordinates (x, y). Use with prior `window_screenshot` to figure out where buttons are. ' +
+        'macOS requires `cliclick` (brew install cliclick) for non-left-click. Linux Wayland requires `ydotool`.', {
+        x: z.number().int().describe('Absolute screen x coordinate.'),
+        y: z.number().int().describe('Absolute screen y coordinate.'),
+        button: z.enum(['left', 'middle', 'right']).optional().describe('Button. Default left.'),
+        count: z.number().int().min(1).max(5).optional().describe('Click count (1 = single, 2 = double). Default 1.'),
+    }, async (args) => {
+        const result = await mouseClick(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({ clicked: true, platform: result.platform });
+    });
+    server.tool('mouse_move', 'Move the mouse cursor to absolute screen coordinates without clicking. Useful to hover before screenshotting (some IDE/editor surfaces only render tooltips on hover).', {
+        x: z.number().int().describe('Absolute screen x coordinate.'),
+        y: z.number().int().describe('Absolute screen y coordinate.'),
+    }, async (args) => {
+        const result = await mouseMove(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({ moved: true, platform: result.platform });
+    });
+    server.tool('list_processes', 'List running processes on the host (pid, name, cpu, mem_kb, ppid, user when available). ' +
+        'Pass `name_pattern` to filter by regex. Use this to check whether Unity / Editor / a build tool is still alive, find PIDs to kill, etc.', {
+        name_pattern: z.string().optional().describe('Regex (JS syntax) to filter process names / cmdlines.'),
+    }, async (args) => {
+        const result = await listProcesses(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText({ count: result.processes.length, processes: result.processes, platform: result.platform });
+    });
+    server.tool('kill_process', 'Kill a process by pid or by name regex. Default uses SIGTERM (graceful); pass `force:true` to use SIGKILL / `taskkill /F`. ' +
+        'Returns the list of pids actually killed. Common usage: after detecting Unity has frozen via `list_processes`, kill and then `launch_process` to relaunch it.', {
+        pid: z.number().int().optional().describe('PID to kill.'),
+        name_pattern: z.string().optional().describe('Regex matching process names — kills all matching processes.'),
+        force: z.boolean().optional().describe('Force kill (SIGKILL / taskkill /F). Default false (SIGTERM).'),
+    }, async (args) => {
+        const result = await killProcess(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText({ killed: result.killed, count: result.killed.length, platform: result.platform });
+    });
+    server.tool('launch_process', 'Launch a program on the host. Returns the pid (when available). The launched process is detached by default so it outlives the agent-manager; pass `detach:false` to tie its lifetime to the manager.', {
+        command: z.string().describe('Executable path or name on PATH.'),
+        args: z.array(z.string()).optional().describe('Command-line arguments.'),
+        cwd: z.string().optional().describe('Working directory.'),
+        env: z.record(z.string(), z.string()).optional().describe('Environment variables to set/override.'),
+        detach: z.boolean().optional().describe('Detach the launched process. Default true.'),
+    }, async (args) => {
+        const result = await launchProcess(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText({ pid: result.pid, platform: result.platform });
+    });
+    server.tool('wait_for_file', 'Poll for a file to appear (and optionally satisfy a content regex) within a timeout. Used to synchronize with external tools that signal completion via a file — e.g. Unity Editor writes a play-ready JSON signal once the play-mode loop has stabilized.', {
+        path: z.string().describe('Absolute path to wait for.'),
+        timeout_seconds: z.number().int().min(1).max(600).optional().describe('Max wait time. Default 30s, cap 600s.'),
+        poll_ms: z.number().int().min(50).max(10_000).optional().describe('Poll interval. Default 500ms.'),
+        newer_than_ms: z.number().int().optional().describe('Only succeed if the file mtime is at least this Unix-ms timestamp. Use to skip stale signal files.'),
+        content_pattern: z.string().optional().describe('Only succeed if file content matches this regex (first 64 KiB checked).'),
+    }, async (args) => {
+        const result = await waitForFile(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText(result);
+    });
+    server.tool('read_file_tail', 'Read the tail of a text file (default last 8 KiB, max 1 MiB). Use to inspect Unity Editor.log, build logs, error logs, etc., without paging through the whole file.', {
+        path: z.string().describe('Absolute path to read.'),
+        bytes: z.number().int().min(1).max(1024 * 1024).optional().describe('Bytes from end. Default 8192, max 1 MiB.'),
+    }, async (args) => {
+        const result = await readFileTail(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText(result);
+    });
+    server.tool('clipboard_read', 'Read the system clipboard as text. Cross-OS: PowerShell on Windows, pbpaste on macOS, wl-paste / xclip / xsel on Linux.', {}, async () => {
+        const result = await clipboardRead();
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({ text: result.text, length: result.text.length, platform: result.platform });
+    });
+    server.tool('clipboard_write', 'Write text to the system clipboard. Useful when the agent has prepared a code snippet / answer for a human to paste somewhere the agent cannot directly type into.', {
+        text: z.string().describe('Text to put on the clipboard.'),
+    }, async (args) => {
+        const result = await clipboardWrite(args);
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({ written: true, length: args.text.length, platform: result.platform });
+    });
+    server.tool('os_info', 'Report basic info about the host the agent-manager is running on (platform, hostname, user, OS release, arch, cpu count, memory, DISPLAY / WAYLAND_DISPLAY). ' +
+        'Use this once at the start of a session that needs to drive the GUI — different OS branches need different follow-up tools.', {}, async () => {
+        const result = await osInfo();
+        return okText(result.info);
+    });
+    server.tool('list_screens', 'Enumerate attached monitors with their virtual-desktop position, size, scale, and primary flag. Coordinates are in the same space `screenshot` / `mouse_click` / `mouse_move` expect, so use this before computing absolute pixel positions on a multi-monitor host.', {}, async () => {
+        const result = await listScreens();
+        if (!result.ok)
+            return errText(result.error, { hint: result.hint });
+        return okText({
+            count: result.monitors.length,
+            monitors: result.monitors,
+            platform: result.platform,
+            warning: result.warning,
+        });
+    });
+    server.tool('find_unity_logs', 'Resolve canonical Unity log paths for the host OS (Editor.log, Editor-prev.log, crash dir, Hub log). When `project_path` is supplied, also computes Player.log / Player-prev.log from the project\'s ProjectSettings companyName + productName. Pair with `read_file_tail` to inspect the contents. Use this when investigating a stuck Unity Editor — different OSes put Unity logs in completely different places.', {
+        project_path: z.string().optional().describe('Absolute path to a Unity project (the dir containing ProjectSettings/). Required for Player.log resolution.'),
+    }, async (args) => {
+        const result = await findUnityLogs(args);
+        return okText(result);
+    });
+    server.tool('shell_exec', 'Execute an arbitrary command on the host and return its stdout / stderr / exit code. Use as an escape hatch when a host_* tool above does not cover the workflow (e.g. Unity Editor batch mode invocation, custom build script). ' +
+        'Default timeout 30s; clamped to 600s. The command runs with the agent-manager process credentials.', {
+        command: z.string().describe('Executable path or name.'),
+        args: z.array(z.string()).optional().describe('Arguments.'),
+        cwd: z.string().optional().describe('Working directory.'),
+        timeout_seconds: z.number().int().min(1).max(600).optional().describe('Timeout. Default 30s, max 600s.'),
+        stdin: z.string().optional().describe('String to pipe into the child stdin.'),
+    }, async (args) => {
+        const result = await shellExec(args);
+        if (!result.ok)
+            return errText(result.error);
+        return okText({ code: result.code, stdout: result.stdout, stderr: result.stderr });
+    });
+    return server;
+}
+export async function runHostMcpServerOverStdio() {
+    const server = createHostMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[awb-host-mcp] ${HOST_MCP_SERVER_NAME} v${HOST_MCP_SERVER_VERSION} running on stdio (platform=${process.platform})\n`);
+    await new Promise((resolve) => {
+        const close = () => resolve();
+        process.on('SIGTERM', close);
+        process.on('SIGINT', close);
+        transport.onclose = close;
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/lib/host-mcp/server.js.map

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

package/dist/lib/host-mcp/tools.d.ts

@@ -0,0 +1,172 @@
+export interface ToolError {
+    ok: false;
+    error: string;
+    hint?: string;
+    details?: Record<string, unknown>;
+}
+export interface ScreenshotResult {
+    ok: true;
+    base64_png: string;
+    width: number;
+    height: number;
+    saved_path?: string;
+    platform: string;
+    backend: string;
+}
+export interface WindowInfo {
+    id?: string;
+    title: string;
+    pid?: number;
+    app?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    focused?: boolean;
+}
+export interface ProcessInfo {
+    pid: number;
+    name: string;
+    ppid?: number;
+    user?: string;
+    cpu?: number;
+    mem_kb?: number;
+    cmdline?: string;
+}
+export interface ScreenshotArgs {
+    save_path?: string;
+    display?: number;
+}
+export declare function takeScreenshot(args?: ScreenshotArgs): Promise<ScreenshotResult | ToolError>;
+export interface WindowScreenshotArgs {
+    title_pattern: string;
+    save_path?: string;
+    focus_first?: boolean;
+}
+export declare function screenshotWindow(args: WindowScreenshotArgs): Promise<ScreenshotResult | ToolError>;
+export interface ListWindowsArgs {
+    title_pattern?: string;
+    include_hidden?: boolean;
+}
+export declare function listWindows(args?: ListWindowsArgs): Promise<{
+    ok: true;
+    windows: WindowInfo[];
+    platform: string;
+} | ToolError>;
+export interface FocusWindowArgs {
+    title_pattern: string;
+}
+export declare function focusWindow(args: FocusWindowArgs): Promise<{
+    ok: true;
+    title: string;
+    platform: string;
+} | ToolError>;
+export interface SendKeysArgs {
+    keys: string;
+    chord?: boolean;
+    focus_window?: string;
+}
+export declare function sendKeys(args: SendKeysArgs): Promise<{
+    ok: true;
+    platform: string;
+} | ToolError>;
+export interface MouseClickArgs {
+    x: number;
+    y: number;
+    button?: 'left' | 'middle' | 'right';
+    count?: number;
+}
+export declare function mouseClick(args: MouseClickArgs): Promise<{
+    ok: true;
+    platform: string;
+} | ToolError>;
+export interface MouseMoveArgs {
+    x: number;
+    y: number;
+}
+export declare function mouseMove(args: MouseMoveArgs): Promise<{
+    ok: true;
+    platform: string;
+} | ToolError>;
+export interface ListProcessesArgs {
+    name_pattern?: string;
+}
+export declare function listProcesses(args?: ListProcessesArgs): Promise<{
+    ok: true;
+    processes: ProcessInfo[];
+    platform: string;
+} | ToolError>;
+export interface KillProcessArgs {
+    pid?: number;
+    name_pattern?: string;
+    force?: boolean;
+}
+export declare function killProcess(args: KillProcessArgs): Promise<{
+    ok: true;
+    killed: number[];
+    platform: string;
+} | ToolError>;
+export interface LaunchProcessArgs {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    detach?: boolean;
+}
+export declare function launchProcess(args: LaunchProcessArgs): Promise<{
+    ok: true;
+    pid: number | null;
+    platform: string;
+} | ToolError>;
+export interface WaitForFileArgs {
+    path: string;
+    timeout_seconds?: number;
+    poll_ms?: number;
+    newer_than_ms?: number;
+    content_pattern?: string;
+}
+export declare function waitForFile(args: WaitForFileArgs): Promise<{
+    ok: true;
+    appeared_at: string;
+    size: number;
+    content?: string;
+} | ToolError>;
+export interface ReadFileTailArgs {
+    path: string;
+    bytes?: number;
+}
+export declare function readFileTail(args: ReadFileTailArgs): Promise<{
+    ok: true;
+    content: string;
+    size: number;
+    mtime: string;
+} | ToolError>;
+export declare function clipboardRead(): Promise<{
+    ok: true;
+    text: string;
+    platform: string;
+} | ToolError>;
+export interface ClipboardWriteArgs {
+    text: string;
+}
+export declare function clipboardWrite(args: ClipboardWriteArgs): Promise<{
+    ok: true;
+    platform: string;
+} | ToolError>;
+export declare function osInfo(): Promise<{
+    ok: true;
+    info: Record<string, unknown>;
+}>;
+export interface ShellExecArgs {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    timeout_seconds?: number;
+    stdin?: string;
+}
+export declare function shellExec(args: ShellExecArgs): Promise<{
+    ok: true;
+    code: number;
+    stdout: string;
+    stderr: string;
+} | ToolError>;