humanish 0.97.0 → 0.98.0

package/dist/guest-chromium-text.js.map

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

package/dist/guest-desktop-executor.d.ts

@@ -0,0 +1,22 @@
+import type { CuaExecutor } from "./computer-use.js";
+/** Internal guest port. Implementations recheck signal synchronously before native dispatch. */
+export interface GuestDesktopTools {
+    capture(signal: AbortSignal): Promise<Buffer>;
+    input(args: readonly string[], signal: AbortSignal): Promise<void>;
+    prepareText(text: string, signal: AbortSignal): Promise<{
+        paste(): Promise<void>;
+        close(): Promise<void>;
+    }>;
+}
+/** xdotool has a command language: never send an unchecked key name to it. */
+export declare function guestDesktopChord(keys: readonly string[]): string;
+export interface GuestDesktopExecutorOptions {
+    width: number;
+    height: number;
+    tools: GuestDesktopTools;
+    authoritySignal: AbortSignal;
+    /** Owner must stop the private display/browser after a partial/uncertain input. */
+    onTerminal: () => void;
+}
+/** Headed X11 input and full-frame captures. Browser metadata is deliberately absent. */
+export declare function createGuestDesktopExecutor(options: GuestDesktopExecutorOptions): CuaExecutor;

package/dist/guest-desktop-executor.js

@@ -0,0 +1,177 @@
+import { perceptualSignature } from "./frame-signature.js";
+import { setTimeout as delay } from "node:timers/promises";
+import { BROWSER_CONTROL_LIMITS, validateBrowserControlAction, validateBrowserControlPng } from "./browser-control-protocol.js";
+import { CuaExecutorError, isCuaExecutorError } from "./cua-executor-error.js";
+const keyNames = Object.freeze({
+    CTRL: "ctrl", CONTROL: "ctrl", ALT: "alt", SHIFT: "shift", META: "super", SUPER: "super", CMD: "super",
+    ENTER: "Return", RETURN: "Return", TAB: "Tab", ESC: "Escape", ESCAPE: "Escape", SPACE: "space", " ": "space",
+    BACKSPACE: "BackSpace", DELETE: "Delete", INSERT: "Insert", HOME: "Home", END: "End",
+    PAGEUP: "Prior", PAGEDOWN: "Next", ARROWUP: "Up", ARROWDOWN: "Down", ARROWLEFT: "Left", ARROWRIGHT: "Right",
+    UP: "Up", DOWN: "Down", LEFT: "Left", RIGHT: "Right",
+    "+": "plus", "-": "minus", "=": "equal", ",": "comma", ".": "period", "/": "slash", "\\": "backslash",
+    ";": "semicolon", "'": "apostrophe", "[": "bracketleft", "]": "bracketright", "`": "grave"
+});
+/** xdotool has a command language: never send an unchecked key name to it. */
+export function guestDesktopChord(keys) {
+    const normalized = keys.map(key => {
+        if (/^[a-z0-9]$/i.test(key))
+            return key.toLowerCase();
+        if (/^F(?:[1-9]|1[0-2])$/i.test(key))
+            return key.toUpperCase();
+        const name = Object.hasOwn(keyNames, key.toUpperCase()) ? keyNames[key.toUpperCase()] : undefined;
+        if (!name)
+            throw new CuaExecutorError("action_rejected", "not_dispatched");
+        return name;
+    });
+    if (new Set(normalized).size !== normalized.length)
+        throw new CuaExecutorError("action_rejected", "not_dispatched");
+    return normalized.join("+");
+}
+/** Headed X11 input and full-frame captures. Browser metadata is deliberately absent. */
+export function createGuestDesktopExecutor(options) {
+    const { width, height, tools, authoritySignal } = options;
+    if (![width, height].every(n => Number.isSafeInteger(n) && n > 0 && n <= BROWSER_CONTROL_LIMITS.dimension)
+        || width * height > BROWSER_CONTROL_LIMITS.pixels)
+        throw new CuaExecutorError("invalid_request", "not_dispatched");
+    let busy = false;
+    let terminal = false;
+    function terminate() {
+        if (terminal)
+            return;
+        terminal = true;
+        try {
+            options.onTerminal();
+        }
+        catch { /* Terminal state remains closed even if the owner fails. */ }
+    }
+    function assertOpen(signal, dispatched = false) {
+        if (terminal || signal.aborted)
+            throw new CuaExecutorError("session_revoked", dispatched ? "outcome_uncertain" : "not_dispatched");
+    }
+    function begin(signal) {
+        assertOpen(signal);
+        if (busy)
+            throw new CuaExecutorError("executor_busy", "not_dispatched");
+        busy = true;
+    }
+    function point(x, y) {
+        // Reject out-of-frame input instead of clicking a clamped, unintended target.
+        if (x < 0 || y < 0 || x >= width || y >= height)
+            throw new CuaExecutorError("action_rejected", "not_dispatched");
+        return [String(Math.min(width - 1, Math.round(x))), String(Math.min(height - 1, Math.round(y)))];
+    }
+    function plan(action) {
+        switch (action.kind) {
+            case "move": return [["mousemove", ...point(action.x, action.y)]];
+            case "click": return [["mousemove", ...point(action.x, action.y)], ["click", { left: "1", middle: "2", right: "3" }[action.button ?? "left"]]];
+            case "double_click": return [["mousemove", ...point(action.x, action.y)], ["click", "--repeat", "2", "--delay", "100", "1"]];
+            case "keypress": return [["key", "--clearmodifiers", guestDesktopChord(action.keys)]];
+            case "type": {
+                // Text transports require exact UTF-8; NUL truncation and lone surrogates
+                // must be refused instead of silently changing the requested text.
+                if (action.text.includes("\0") || Buffer.from(action.text, "utf8").toString("utf8") !== action.text)
+                    throw new CuaExecutorError("action_rejected", "not_dispatched");
+                return [];
+            }
+            case "drag": {
+                const points = action.path.map(p => point(p.x, p.y));
+                if (points.length < 2)
+                    throw new CuaExecutorError("action_rejected", "not_dispatched");
+                return [["mousemove", ...points[0]], ["mousedown", "1"], ...points.slice(1).map(p => ["mousemove", ...p]), ["mouseup", "1"]];
+            }
+            case "scroll": {
+                const origin = point(action.x, action.y);
+                // Native X11 wheel steps do not promise exact pixel scroll distances.
+                const horizontal = Math.ceil(Math.abs(action.dx) / 120), vertical = Math.ceil(Math.abs(action.dy) / 120);
+                if (horizontal + vertical > 100)
+                    throw new CuaExecutorError("action_rejected", "not_dispatched");
+                return horizontal + vertical === 0 ? [] : [["mousemove", ...origin],
+                    ...Array.from({ length: horizontal }, () => ["click", action.dx > 0 ? "7" : "6"]),
+                    ...Array.from({ length: vertical }, () => ["click", action.dy > 0 ? "5" : "4"])];
+            }
+            case "wait":
+            case "screenshot": return [];
+        }
+    }
+    return {
+        stallRecovery: "fail_closed",
+        async observe() {
+            begin(authoritySignal);
+            try {
+                const screenshot = await tools.capture(authoritySignal);
+                assertOpen(authoritySignal);
+                validateBrowserControlPng(screenshot);
+                if (screenshot.readUInt32BE(16) !== width || screenshot.readUInt32BE(20) !== height) {
+                    throw new CuaExecutorError("invalid_response", "not_dispatched");
+                }
+                return { screenshot, stateSignature: perceptualSignature(screenshot) };
+            }
+            catch (error) {
+                terminate();
+                throw isCuaExecutorError(error) ? error : new CuaExecutorError("execution_failed", "not_dispatched");
+            }
+            finally {
+                busy = false;
+            }
+        },
+        async execute(value, callerSignal) {
+            const signal = callerSignal ? AbortSignal.any([authoritySignal, callerSignal]) : authoritySignal;
+            begin(signal);
+            let dispatched = false;
+            let preparing = false;
+            let text;
+            try {
+                const action = validateBrowserControlAction(value);
+                const commands = plan(action); // Validate the entire action before any preparation/input.
+                if (action.kind === "type" && action.text.length) {
+                    preparing = true;
+                    text = await tools.prepareText(action.text, signal);
+                    assertOpen(signal);
+                    dispatched = true;
+                    try {
+                        await text.paste();
+                    }
+                    catch (error) {
+                        // This transaction has no earlier input. Its private bridge can
+                        // prove that no insertion or native input was sent.
+                        if (isCuaExecutorError(error) && error.disposition === "not_dispatched")
+                            dispatched = false;
+                        throw error;
+                    }
+                }
+                if (action.kind === "wait")
+                    await delay(action.ms ?? 250, undefined, { signal });
+                for (const command of commands) {
+                    assertOpen(signal, dispatched);
+                    // No await between authority check and the native port invocation.
+                    dispatched = true;
+                    await tools.input(command, signal);
+                }
+                assertOpen(signal, dispatched);
+            }
+            catch (error) {
+                if ((preparing && !(isCuaExecutorError(error) && error.code === "action_rejected" && error.disposition === "not_dispatched")) || dispatched || signal.aborted || !isCuaExecutorError(error))
+                    terminate();
+                // Do not send mouseup/key-release after revocation: it can itself click/drop.
+                if (dispatched)
+                    throw new CuaExecutorError(isCuaExecutorError(error) ? error.code : "execution_failed", "outcome_uncertain");
+                if (signal.aborted)
+                    throw new CuaExecutorError("session_revoked", "not_dispatched");
+                throw isCuaExecutorError(error) ? error : new CuaExecutorError("execution_failed", "not_dispatched");
+            }
+            finally {
+                try {
+                    await text?.close();
+                }
+                catch {
+                    terminate();
+                    throw new CuaExecutorError("execution_failed", dispatched ? "outcome_uncertain" : "not_dispatched");
+                }
+                finally {
+                    busy = false;
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=guest-desktop-executor.js.map

package/dist/guest-desktop-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-desktop-executor.js","sourceRoot":"","sources":["../src/guest-desktop-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAChI,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAS/E,MAAM,QAAQ,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC/D,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO;IACtG,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO;IAC5G,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK;IACpF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO;IAC3G,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IACpD,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW;IACrG,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO;CAC3F,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAChC,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClG,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM;QAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACpH,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAWD,yFAAyF;AACzF,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC7E,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAC1D,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,SAAS,CAAC;WACrG,KAAK,GAAG,MAAM,GAAG,sBAAsB,CAAC,MAAM;QAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACrH,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,SAAS,SAAS;QAChB,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC;YAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,4DAA4D,CAAC,CAAC;IACtG,CAAC;IACD,SAAS,UAAU,CAAC,MAAmB,EAAE,UAAU,GAAG,KAAK;QACzD,IAAI,QAAQ,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACrI,CAAC;IACD,SAAS,KAAK,CAAC,MAAmB;QAChC,UAAU,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,IAAI;YAAE,MAAM,IAAI,gBAAgB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;QACxE,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,SAAS,KAAK,CAAC,CAAS,EAAE,CAAS;QACjC,8EAA8E;QAC9E,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM;YAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QACjH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,CAAC;IACD,SAAS,IAAI,CAAC,MAAiB;QAC7B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,KAAK,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/I,KAAK,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7H,KAAK,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtF,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,0EAA0E;gBAC1E,mEAAmE;gBACnE,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,IAAI;oBAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;gBACrK,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;gBACvF,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;YAChI,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;gBACzC,sEAAsE;gBACtE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;gBACzG,IAAI,UAAU,GAAG,QAAQ,GAAG,GAAG;oBAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;gBACjG,OAAO,UAAU,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC;oBACjE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACjF,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrF,CAAC;YACD,KAAK,MAAM,CAAC;YAAC,KAAK,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO;QACL,aAAa,EAAE,aAAa;QAC5B,KAAK,CAAC,OAAO;YACX,KAAK,CAAC,eAAe,CAAC,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;gBACxD,UAAU,CAAC,eAAe,CAAC,CAAC;gBAC5B,yBAAyB,CAAC,UAAU,CAAC,CAAC;gBACtC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;oBACpF,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;gBACnE,CAAC;gBACD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;YACzE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;YACvG,CAAC;oBAAS,CAAC;gBAAC,IAAI,GAAG,KAAK,CAAC;YAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY;YAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;YACjG,KAAK,CAAC,MAAM,CAAC,CAAC;YACd,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,IAAuE,CAAC;YAC5E,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,2DAA2D;gBAC1F,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACjD,SAAS,GAAG,IAAI,CAAC;oBACjB,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBACpD,UAAU,CAAC,MAAM,CAAC,CAAC;oBACnB,UAAU,GAAG,IAAI,CAAC;oBAClB,IAAI,CAAC;wBAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;oBAAC,CAAC;oBAC3B,OAAO,KAAK,EAAE,CAAC;wBACb,gEAAgE;wBAChE,oDAAoD;wBACpD,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,gBAAgB;4BAAE,UAAU,GAAG,KAAK,CAAC;wBAC5F,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;oBAAE,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACjF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAC/B,mEAAmE;oBACnE,UAAU,GAAG,IAAI,CAAC;oBAClB,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACrC,CAAC;gBACD,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,WAAW,KAAK,gBAAgB,CAAC,CAAC,IAAI,UAAU,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;oBAAE,SAAS,EAAE,CAAC;gBACzM,8EAA8E;gBAC9E,IAAI,UAAU;oBAAE,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;gBAC7H,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;gBACpF,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;YACvG,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBAAC,MAAM,IAAI,EAAE,KAAK,EAAE,CAAC;gBAAC,CAAC;gBAC5B,MAAM,CAAC;oBAAC,SAAS,EAAE,CAAC;oBAAC,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;gBAAC,CAAC;wBACnH,CAAC;oBAAC,IAAI,GAAG,KAAK,CAAC;gBAAC,CAAC;YAC3B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/guest-desktop-native.d.ts

@@ -0,0 +1,14 @@
+import type { GuestDesktopTools } from "./guest-desktop-executor.js";
+/** Private owner port; never expose its command array to a participant. */
+export interface GuestDesktopNativeTools extends Pick<GuestDesktopTools, "input" | "capture"> {
+    activeWindowId(signal: AbortSignal): Promise<string>;
+    typeAscii(text: string, signal: AbortSignal): Promise<void>;
+}
+/** Guest-only helpers. Not a host administration API or an actor-visible command runner. */
+export declare function createGuestDesktopNativeTools(options: {
+    display: string;
+    /** An owner-created private directory inside the disposable guest. */
+    temporaryDirectory: string;
+    /** Owner-created cookie file; never inherit an operator's XAUTHORITY. */
+    xauthority: string;
+}): GuestDesktopNativeTools;

package/dist/guest-desktop-native.js

@@ -0,0 +1,131 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { mkdtemp, open, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { CuaExecutorError } from "./cua-executor-error.js";
+import { BROWSER_CONTROL_LIMITS } from "./browser-control-protocol.js";
+class UnconfirmedHelperExit extends CuaExecutorError {
+    constructor() { super("execution_failed", "outcome_uncertain"); }
+}
+/** Guest-only helpers. Not a host administration API or an actor-visible command runner. */
+export function createGuestDesktopNativeTools(options) {
+    if (!/^:[0-9]{1,3}(?:\.[0-9])?$/.test(options.display) || !options.temporaryDirectory.startsWith("/") || !options.xauthority.startsWith("/")) {
+        throw new CuaExecutorError("invalid_request", "not_dispatched");
+    }
+    const environment = { PATH: "/usr/bin:/bin", HOME: options.temporaryDirectory, DISPLAY: options.display,
+        XAUTHORITY: options.xauthority, LANG: "C.UTF-8", LC_ALL: "C.UTF-8" };
+    // The direct child handle remains the only termination authority. Native helper
+    // stderr can contain user text; consume it with a bound, never return or log it.
+    async function helper(binary, args, signal, text) {
+        if (signal.aborted)
+            throw new CuaExecutorError("session_revoked", "not_dispatched");
+        return await new Promise((resolve, reject) => {
+            const child = spawn(`/usr/bin/${binary}`, [...args], {
+                cwd: options.temporaryDirectory, env: environment, stdio: ["pipe", "pipe", "pipe"]
+            });
+            let live = true, failed = false, outputBytes = 0;
+            const stdout = [];
+            let killDeadline;
+            let failureCode = "execution_failed";
+            const fail = (code) => {
+                if (failed)
+                    return;
+                failed = true;
+                failureCode = code;
+                if (live)
+                    child.kill("SIGKILL");
+                killDeadline = setTimeout(() => {
+                    signal.removeEventListener("abort", abort);
+                    reject(new UnconfirmedHelperExit());
+                }, 2000);
+            };
+            const abort = () => fail("session_revoked");
+            signal.addEventListener("abort", abort, { once: true });
+            const deadline = setTimeout(() => fail("deadline_exceeded"), 10_000);
+            const consume = (data) => { outputBytes += data.length; if (outputBytes > 16_384)
+                fail("execution_failed"); };
+            child.stdout.on("data", (data) => { consume(data); if (!failed)
+                stdout.push(data); });
+            child.stderr.on("data", (data) => {
+                consume(data);
+                // xdotool can report a skipped character while still exiting zero.
+                if (text !== undefined && data.length)
+                    fail("execution_failed");
+            });
+            child.on("error", () => fail("execution_failed"));
+            child.stdin.on("error", () => fail("execution_failed"));
+            child.once("exit", () => { live = false; });
+            child.once("close", code => {
+                live = false;
+                clearTimeout(deadline);
+                clearTimeout(killDeadline);
+                signal.removeEventListener("abort", abort);
+                if (failed || code !== 0)
+                    reject(new CuaExecutorError(failureCode, "outcome_uncertain"));
+                else
+                    resolve(Buffer.concat(stdout));
+            });
+            child.stdin.end(text);
+            if (signal.aborted)
+                abort();
+        });
+    }
+    return {
+        async input(args, signal) { await helper("xdotool", args, signal); },
+        async activeWindowId(signal) {
+            const value = (await helper("xdotool", ["getactivewindow"], signal)).toString("utf8");
+            if (!/^[1-9][0-9]{0,9}\n?$/.test(value) || Number(value.trim()) > 0xffffffff)
+                throw new CuaExecutorError("action_rejected", "not_dispatched");
+            return value.trim();
+        },
+        async typeAscii(text, signal) {
+            if (!/^[\x20-\x7e]+$/.test(text) || Buffer.byteLength(text) > BROWSER_CONTROL_LIMITS.textBytes) {
+                throw new CuaExecutorError("action_rejected", "not_dispatched");
+            }
+            await helper("xdotool", ["type", "--clearmodifiers", "--delay", "0", "--file", "-"], signal, text);
+        },
+        async capture(signal) {
+            if (signal.aborted)
+                throw new CuaExecutorError("session_revoked", "not_dispatched");
+            const directory = await mkdtemp(join(options.temporaryDirectory, "capture-"));
+            const path = join(directory, "frame.png");
+            let reclaim = true;
+            try {
+                await helper("scrot", ["--silent", path], signal);
+                const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+                try {
+                    const stat = await file.stat();
+                    if (!stat.isFile() || stat.nlink !== 1 || stat.size <= 0 || stat.size > BROWSER_CONTROL_LIMITS.pngBytes) {
+                        throw new CuaExecutorError("invalid_response", "not_dispatched");
+                    }
+                    const buffer = Buffer.alloc(stat.size + 1);
+                    let offset = 0;
+                    while (offset < buffer.length) {
+                        const { bytesRead } = await file.read(buffer, offset, buffer.length - offset, null);
+                        if (!bytesRead)
+                            break;
+                        offset += bytesRead;
+                    }
+                    if (offset !== stat.size)
+                        throw new CuaExecutorError("invalid_response", "not_dispatched");
+                    return buffer.subarray(0, offset);
+                }
+                finally {
+                    await file.close();
+                }
+            }
+            catch (error) {
+                if (error instanceof UnconfirmedHelperExit)
+                    reclaim = false;
+                throw error;
+            }
+            finally {
+                // A helper whose exit is unconfirmed might still be writing. Leave this
+                // private guest state for the owner to reclaim with the runtime.
+                if (reclaim)
+                    await rm(directory, { recursive: true, force: true });
+            }
+        }
+    };
+}
+//# sourceMappingURL=guest-desktop-native.js.map

package/dist/guest-desktop-native.js.map

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

package/dist/guest-runtime-desktop.d.ts

@@ -0,0 +1,35 @@
+import { type BrowserContext, type Page } from "playwright-core";
+import type { GuestRuntimeDesktop } from "./guest-runtime.js";
+export declare const GUEST_RUNTIME_PATHS: Readonly<{
+    root: "/opt/humanish/control";
+    run: "/run/humanish";
+    home: "/home/humanish";
+}>;
+export declare const GUEST_RUNTIME_ENV: Readonly<{
+    PATH: "/usr/bin:/bin";
+    HOME: "/home/humanish";
+    USER: "humanish";
+    LOGNAME: "humanish";
+    LANG: "C.UTF-8";
+    LC_ALL: "C.UTF-8";
+    DISPLAY: ":0";
+    XAUTHORITY: "/run/humanish/Xauthority";
+    XDG_RUNTIME_DIR: "/run/humanish/xdg";
+    XDG_CACHE_HOME: "/home/humanish/.cache";
+    XDG_CONFIG_HOME: "/home/humanish/.config";
+    TMPDIR: "/tmp";
+}>;
+export type GuestRuntimePhase = "layout" | "xauthority" | "display" | "window_manager" | "browser" | "sandbox" | "focus" | "fixture";
+/** Fixed guest layout. No caller paths, environment, command, page selector or URL. */
+export declare function createGuestRuntimeDesktop(options: {
+    signal: AbortSignal;
+    onTerminal(): void;
+    onPhase?(phase: GuestRuntimePhase): void;
+}): Promise<GuestRuntimeDesktop & {
+    readonly owner: {
+        context: BrowserContext;
+        page: Page;
+        sandboxReport: string;
+        configSha256: string;
+    };
+}>;