@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/computer/motor/platform/windows/helper.js

@@ -0,0 +1,174 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { constants as fsConstants } from "node:fs";
+import { access } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+const SETUP_HELPER_SCRIPT = path.join(PACKAGE_ROOT, "scripts", "setup-helper.mjs");
+const HELPER_SETUP_TIMEOUT_MS = 60_000;
+const COMMAND_TIMEOUT_MS = 15_000;
+export const WINDOWS_HELPER_PROTOCOL_VERSION = 4;
+export const WINDOWS_HELPER_PATH = process.env.ADA_COMPUTER_USE_WINDOWS_HELPER_PATH ||
+    path.join(os.homedir(), ".pi", "agent", "helpers", "ada-computer-use", "windows-bridge.exe");
+async function isExecutable(filePath) {
+    try {
+        await access(filePath, fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function runProcess(command, args, timeoutMs, signal, env) {
+    if (signal?.aborted)
+        throw new Error("Operation aborted.");
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"], env });
+        let stdout = "";
+        let stderr = "";
+        const cleanup = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+        };
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            cleanup();
+            reject(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(" ")}`));
+        }, timeoutMs);
+        const onAbort = () => {
+            child.kill("SIGTERM");
+            cleanup();
+            reject(new Error("Operation aborted."));
+        };
+        child.stdout.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", (error) => {
+            cleanup();
+            reject(error);
+        });
+        child.on("close", (code) => {
+            cleanup();
+            if (code === 0)
+                return resolve();
+            const output = [stderr.trim(), stdout.trim()].filter(Boolean).join("\n");
+            reject(new Error(`Command failed (${code}): ${command} ${args.join(" ")}\n${output}`.trim()));
+        });
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export class WindowsHelperClient {
+    installChecked = false;
+    child;
+    buffer = "";
+    pending = new Map();
+    dispose() {
+        const error = new Error("Windows helper closed because the Pi session ended.");
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+        this.buffer = "";
+        const child = this.child;
+        this.child = undefined;
+        if (!child)
+            return;
+        child.stdin.destroy();
+        child.stdout.destroy();
+        child.stderr.destroy();
+        child.kill("SIGTERM");
+        child.unref();
+    }
+    async ensureInstalled(signal) {
+        if ((await isExecutable(WINDOWS_HELPER_PATH)) && this.installChecked)
+            return;
+        // Re-enter Electron and Bun standalone hosts as their JavaScript runtimes.
+        await runProcess(process.execPath, [SETUP_HELPER_SCRIPT, "--platform", "windows", "--runtime"], HELPER_SETUP_TIMEOUT_MS, signal, { ...process.env, ELECTRON_RUN_AS_NODE: "1", BUN_BE_BUN: "1" });
+        this.installChecked = true;
+        if (!(await isExecutable(WINDOWS_HELPER_PATH)))
+            throw new Error(`Failed to install Windows helper at ${WINDOWS_HELPER_PATH}.`);
+    }
+    async process(signal) {
+        await this.ensureInstalled(signal);
+        if (this.child && this.child.exitCode === null && !this.child.killed)
+            return this.child;
+        const child = spawn(WINDOWS_HELPER_PATH, [], { stdio: ["pipe", "pipe", "pipe"] });
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdin.setDefaultEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.onStdout(chunk));
+        child.on("exit", () => {
+            if (this.child === child)
+                this.child = undefined;
+        });
+        child.on("error", () => {
+            if (this.child === child)
+                this.child = undefined;
+        });
+        this.child = child;
+        this.buffer = "";
+        return child;
+    }
+    onStdout(chunk) {
+        this.buffer += chunk;
+        for (;;) {
+            const newline = this.buffer.indexOf("\n");
+            if (newline < 0)
+                return;
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            const pending = this.pending.get(parsed.id);
+            if (!pending)
+                continue;
+            this.pending.delete(parsed.id);
+            clearTimeout(pending.timer);
+            if (parsed.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {
+                pending.reject(new Error(`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${parsed.protocolVersion ?? "unknown"}. Restart Pi to use the installed helper.`));
+            }
+            else if (parsed.ok === true) {
+                pending.resolve(parsed.result);
+            }
+            else {
+                const error = new Error(parsed.error?.message ?? "Windows helper command failed.");
+                error.code = parsed.error?.code;
+                pending.reject(error);
+            }
+        }
+    }
+    async command(cmd, args = {}, options) {
+        const child = await this.process(options?.signal);
+        const id = randomUUID();
+        const timeoutMs = options?.timeoutMs ?? COMMAND_TIMEOUT_MS;
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Helper command '${cmd}' timed out after ${timeoutMs}ms.`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            child.stdin.write(`${JSON.stringify({ protocolVersion: WINDOWS_HELPER_PROTOCOL_VERSION, id, cmd, args })}\n`, (error) => {
+                if (!error)
+                    return;
+                this.pending.delete(id);
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+}
+export const windowsHelper = new WindowsHelperClient();
+//# sourceMappingURL=helper.js.map

package/dist/core/computer/motor/platform/windows/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/windows/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcessWithoutNullStreams, spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { constants as fsConstants } from \"node:fs\";\nimport { access } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"..\");\nconst SETUP_HELPER_SCRIPT = path.join(PACKAGE_ROOT, \"scripts\", \"setup-helper.mjs\");\nconst HELPER_SETUP_TIMEOUT_MS = 60_000;\nconst COMMAND_TIMEOUT_MS = 15_000;\n\nexport const WINDOWS_HELPER_PROTOCOL_VERSION = 4;\nexport const WINDOWS_HELPER_PATH =\n\tprocess.env.ADA_COMPUTER_USE_WINDOWS_HELPER_PATH ||\n\tpath.join(os.homedir(), \".pi\", \"agent\", \"helpers\", \"ada-computer-use\", \"windows-bridge.exe\");\n\ninterface Pending<T> {\n\tresolve(value: T): void;\n\treject(error: Error): void;\n\ttimer: NodeJS.Timeout;\n}\n\nasync function isExecutable(filePath: string): Promise<boolean> {\n\ttry {\n\t\tawait access(filePath, fsConstants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function runProcess(\n\tcommand: string,\n\targs: string[],\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n\tenv?: NodeJS.ProcessEnv,\n): Promise<void> {\n\tif (signal?.aborted) throw new Error(\"Operation aborted.\");\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, { stdio: [\"ignore\", \"pipe\", \"pipe\"], env });\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t};\n\t\tconst timer = setTimeout(() => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tcleanup();\n\t\t\treject(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(\" \")}`));\n\t\t}, timeoutMs);\n\t\tconst onAbort = () => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tcleanup();\n\t\t\treject(new Error(\"Operation aborted.\"));\n\t\t};\n\t\tchild.stdout.on(\"data\", (chunk) => {\n\t\t\tstdout += String(chunk);\n\t\t});\n\t\tchild.stderr.on(\"data\", (chunk) => {\n\t\t\tstderr += String(chunk);\n\t\t});\n\t\tchild.on(\"error\", (error) => {\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t});\n\t\tchild.on(\"close\", (code) => {\n\t\t\tcleanup();\n\t\t\tif (code === 0) return resolve();\n\t\t\tconst output = [stderr.trim(), stdout.trim()].filter(Boolean).join(\"\\n\");\n\t\t\treject(new Error(`Command failed (${code}): ${command} ${args.join(\" \")}\\n${output}`.trim()));\n\t\t});\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\nexport class WindowsHelperClient {\n\tprivate installChecked = false;\n\tprivate child?: ChildProcessWithoutNullStreams;\n\tprivate buffer = \"\";\n\tprivate pending = new Map<string, Pending<unknown>>();\n\n\tdispose(): void {\n\t\tconst error = new Error(\"Windows helper closed because the Pi session ended.\");\n\t\tfor (const pending of this.pending.values()) {\n\t\t\tclearTimeout(pending.timer);\n\t\t\tpending.reject(error);\n\t\t}\n\t\tthis.pending.clear();\n\t\tthis.buffer = \"\";\n\n\t\tconst child = this.child;\n\t\tthis.child = undefined;\n\t\tif (!child) return;\n\t\tchild.stdin.destroy();\n\t\tchild.stdout.destroy();\n\t\tchild.stderr.destroy();\n\t\tchild.kill(\"SIGTERM\");\n\t\tchild.unref();\n\t}\n\n\tasync ensureInstalled(signal?: AbortSignal): Promise<void> {\n\t\tif ((await isExecutable(WINDOWS_HELPER_PATH)) && this.installChecked) return;\n\t\t// Re-enter Electron and Bun standalone hosts as their JavaScript runtimes.\n\t\tawait runProcess(\n\t\t\tprocess.execPath,\n\t\t\t[SETUP_HELPER_SCRIPT, \"--platform\", \"windows\", \"--runtime\"],\n\t\t\tHELPER_SETUP_TIMEOUT_MS,\n\t\t\tsignal,\n\t\t\t{ ...process.env, ELECTRON_RUN_AS_NODE: \"1\", BUN_BE_BUN: \"1\" },\n\t\t);\n\t\tthis.installChecked = true;\n\t\tif (!(await isExecutable(WINDOWS_HELPER_PATH)))\n\t\t\tthrow new Error(`Failed to install Windows helper at ${WINDOWS_HELPER_PATH}.`);\n\t}\n\n\tprivate async process(signal?: AbortSignal): Promise<ChildProcessWithoutNullStreams> {\n\t\tawait this.ensureInstalled(signal);\n\t\tif (this.child && this.child.exitCode === null && !this.child.killed) return this.child;\n\t\tconst child = spawn(WINDOWS_HELPER_PATH, [], { stdio: [\"pipe\", \"pipe\", \"pipe\"] });\n\t\tchild.stdout.setEncoding(\"utf8\");\n\t\tchild.stderr.setEncoding(\"utf8\");\n\t\tchild.stdin.setDefaultEncoding(\"utf8\");\n\t\tchild.stdout.on(\"data\", (chunk: string) => this.onStdout(chunk));\n\t\tchild.on(\"exit\", () => {\n\t\t\tif (this.child === child) this.child = undefined;\n\t\t});\n\t\tchild.on(\"error\", () => {\n\t\t\tif (this.child === child) this.child = undefined;\n\t\t});\n\t\tthis.child = child;\n\t\tthis.buffer = \"\";\n\t\treturn child;\n\t}\n\n\tprivate onStdout(chunk: string): void {\n\t\tthis.buffer += chunk;\n\t\tfor (;;) {\n\t\t\tconst newline = this.buffer.indexOf(\"\\n\");\n\t\t\tif (newline < 0) return;\n\t\t\tconst line = this.buffer.slice(0, newline).trim();\n\t\t\tthis.buffer = this.buffer.slice(newline + 1);\n\t\t\tif (!line) continue;\n\t\t\tlet parsed: any;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(line);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst pending = this.pending.get(parsed.id);\n\t\t\tif (!pending) continue;\n\t\t\tthis.pending.delete(parsed.id);\n\t\t\tclearTimeout(pending.timer);\n\t\t\tif (parsed.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {\n\t\t\t\tpending.reject(\n\t\t\t\t\tnew Error(\n\t\t\t\t\t\t`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${parsed.protocolVersion ?? \"unknown\"}. Restart Pi to use the installed helper.`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t} else if (parsed.ok === true) {\n\t\t\t\tpending.resolve(parsed.result);\n\t\t\t} else {\n\t\t\t\tconst error = new Error(parsed.error?.message ?? \"Windows helper command failed.\") as Error & {\n\t\t\t\t\tcode?: string;\n\t\t\t\t};\n\t\t\t\terror.code = parsed.error?.code;\n\t\t\t\tpending.reject(error);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync command<T>(\n\t\tcmd: string,\n\t\targs: Record<string, unknown> = {},\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<T> {\n\t\tconst child = await this.process(options?.signal);\n\t\tconst id = randomUUID();\n\t\tconst timeoutMs = options?.timeoutMs ?? COMMAND_TIMEOUT_MS;\n\t\treturn await new Promise<T>((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tthis.pending.delete(id);\n\t\t\t\treject(new Error(`Helper command '${cmd}' timed out after ${timeoutMs}ms.`));\n\t\t\t}, timeoutMs);\n\t\t\tthis.pending.set(id, { resolve: resolve as (value: unknown) => void, reject, timer });\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ protocolVersion: WINDOWS_HELPER_PROTOCOL_VERSION, id, cmd, args })}\\n`,\n\t\t\t\t(error) => {\n\t\t\t\t\tif (!error) return;\n\t\t\t\t\tthis.pending.delete(id);\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t}\n}\n\nexport const windowsHelper = new WindowsHelperClient();\n"]}

package/dist/core/computer/motor/root-selection.d.ts

@@ -0,0 +1,6 @@
+import type { PlatformRoot } from "./platform/types.ts";
+type RankedRoot = Pick<PlatformRoot, "windowId" | "windowRef" | "isModal" | "isFocused" | "isMain" | "isMinimized" | "isOnscreen" | "zOrder" | "title">;
+export declare function scoreWindow(window: RankedRoot): number;
+export declare function shouldPreferForegroundModalWindow(current: RankedRoot, candidate: RankedRoot): boolean;
+export {};
+//# sourceMappingURL=root-selection.d.ts.map

package/dist/core/computer/motor/root-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-selection.d.ts","sourceRoot":"","sources":["../../../../src/core/computer/motor/root-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,KAAK,UAAU,GAAG,IAAI,CACrB,YAAY,EACZ,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CACjH,CAAC;AAEF,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAUtD;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAMrG","sourcesContent":["import type { PlatformRoot } from \"./platform/types.ts\";\n\ntype RankedRoot = Pick<\n\tPlatformRoot,\n\t\"windowId\" | \"windowRef\" | \"isModal\" | \"isFocused\" | \"isMain\" | \"isMinimized\" | \"isOnscreen\" | \"zOrder\" | \"title\"\n>;\n\nexport function scoreWindow(window: RankedRoot): number {\n\tlet score = 0;\n\tif (window.isModal) score += 180;\n\tif (window.isFocused) score += 100;\n\tif (window.isMain) score += 80;\n\tif (!window.isMinimized) score += 40;\n\tif (window.isOnscreen) score += 20;\n\tif (window.windowId && window.windowId > 0) score += 10;\n\tif (window.title.trim().length > 0) score += 2;\n\treturn score;\n}\n\nexport function shouldPreferForegroundModalWindow(current: RankedRoot, candidate: RankedRoot): boolean {\n\tif (candidate.windowId === current.windowId && candidate.windowRef === current.windowRef) return false;\n\tif (!candidate.isOnscreen || candidate.isMinimized || !candidate.isModal) return false;\n\t// AXDialog can describe a background main window, so modality alone is insufficient.\n\tconst candidateIsInFront = candidate.isFocused || candidate.zOrder < current.zOrder;\n\treturn candidateIsInFront && scoreWindow(candidate) >= scoreWindow(current);\n}\n"]}

package/dist/core/computer/motor/root-selection.js

@@ -0,0 +1,28 @@
+export function scoreWindow(window) {
+    let score = 0;
+    if (window.isModal)
+        score += 180;
+    if (window.isFocused)
+        score += 100;
+    if (window.isMain)
+        score += 80;
+    if (!window.isMinimized)
+        score += 40;
+    if (window.isOnscreen)
+        score += 20;
+    if (window.windowId && window.windowId > 0)
+        score += 10;
+    if (window.title.trim().length > 0)
+        score += 2;
+    return score;
+}
+export function shouldPreferForegroundModalWindow(current, candidate) {
+    if (candidate.windowId === current.windowId && candidate.windowRef === current.windowRef)
+        return false;
+    if (!candidate.isOnscreen || candidate.isMinimized || !candidate.isModal)
+        return false;
+    // AXDialog can describe a background main window, so modality alone is insufficient.
+    const candidateIsInFront = candidate.isFocused || candidate.zOrder < current.zOrder;
+    return candidateIsInFront && scoreWindow(candidate) >= scoreWindow(current);
+}
+//# sourceMappingURL=root-selection.js.map

package/dist/core/computer/motor/root-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-selection.js","sourceRoot":"","sources":["../../../../src/core/computer/motor/root-selection.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,WAAW,CAAC,MAAkB,EAAU;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,IAAI,GAAG,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,IAAI,GAAG,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,KAAK,IAAI,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC;QAAE,KAAK,IAAI,EAAE,CAAC;IACxD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,UAAU,iCAAiC,CAAC,OAAmB,EAAE,SAAqB,EAAW;IACtG,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACvG,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACvF,qFAAqF;IACrF,MAAM,kBAAkB,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpF,OAAO,kBAAkB,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAAA,CAC5E","sourcesContent":["import type { PlatformRoot } from \"./platform/types.ts\";\n\ntype RankedRoot = Pick<\n\tPlatformRoot,\n\t\"windowId\" | \"windowRef\" | \"isModal\" | \"isFocused\" | \"isMain\" | \"isMinimized\" | \"isOnscreen\" | \"zOrder\" | \"title\"\n>;\n\nexport function scoreWindow(window: RankedRoot): number {\n\tlet score = 0;\n\tif (window.isModal) score += 180;\n\tif (window.isFocused) score += 100;\n\tif (window.isMain) score += 80;\n\tif (!window.isMinimized) score += 40;\n\tif (window.isOnscreen) score += 20;\n\tif (window.windowId && window.windowId > 0) score += 10;\n\tif (window.title.trim().length > 0) score += 2;\n\treturn score;\n}\n\nexport function shouldPreferForegroundModalWindow(current: RankedRoot, candidate: RankedRoot): boolean {\n\tif (candidate.windowId === current.windowId && candidate.windowRef === current.windowRef) return false;\n\tif (!candidate.isOnscreen || candidate.isMinimized || !candidate.isModal) return false;\n\t// AXDialog can describe a background main window, so modality alone is insufficient.\n\tconst candidateIsInFront = candidate.isFocused || candidate.zOrder < current.zOrder;\n\treturn candidateIsInFront && scoreWindow(candidate) >= scoreWindow(current);\n}\n"]}

package/dist/core/computer/motor/runtime.d.ts

@@ -0,0 +1,50 @@
+export interface StoredState<T> {
+    stateId: string;
+    resourceKey: string;
+    epoch: number;
+    value: T;
+}
+export declare class StaleResourceStateError extends Error {
+    readonly resourceKey: string;
+    readonly expectedEpoch: number;
+    readonly actualEpoch: number;
+    constructor(resourceKey: string, expectedEpoch: number, actualEpoch: number);
+}
+/** Bounded insertion-ordered store for immutable agent-facing observations. */
+export declare class StateStore<T> {
+    private readonly records;
+    private readonly limit;
+    constructor(limit?: number);
+    create(resourceKey: string, epoch: number, value: T): StoredState<T>;
+    set(record: StoredState<T>): void;
+    get(stateId: string): StoredState<T> | undefined;
+    clear(): void;
+    get size(): number;
+}
+/**
+ * Orders live operations per physical resource while allowing unrelated
+ * resources to overlap. Cached state queries bypass this scheduler entirely.
+ */
+export declare class ResourceScheduler {
+    private readonly resources;
+    private closed;
+    epoch(resourceKey: string): number;
+    restoreEpoch(resourceKey: string, epoch: number): void;
+    read<T>(resourceKey: string, work: (epoch: number) => Promise<T>): Promise<{
+        value: T;
+        epoch: number;
+    }>;
+    readAt<T>(resourceKey: string, expectedEpoch: number, work: (epoch: number) => Promise<T>): Promise<{
+        value: T;
+        epoch: number;
+    }>;
+    write<T>(resourceKey: string, baseEpoch: number, work: (nextEpoch: number) => Promise<T>): Promise<{
+        value: T;
+        epoch: number;
+    }>;
+    drain(): Promise<void>;
+    close(): Promise<void>;
+    private resource;
+    private enqueue;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/computer/motor/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/core/computer/motor/runtime.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACT;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,YAAY,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAM1E;CACD;AAED,+EAA+E;AAC/E,qBAAa,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YAAY,KAAK,SAAM,EAEtB;IAED,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAInE;IAED,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAQhC;IAED,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAE/C;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACD;AAOD;;;GAGG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,MAAM,CAAS;IAEvB,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjC;IAED,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGrD;IAEK,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAK5G;IAEK,MAAM,CAAC,CAAC,EACb,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAMtC;IAEK,KAAK,CAAC,CAAC,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAStC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;IAED,OAAO,CAAC,QAAQ;YASF,OAAO;CAgBrB","sourcesContent":["import { randomUUID } from \"node:crypto\";\n\nexport interface StoredState<T> {\n\tstateId: string;\n\tresourceKey: string;\n\tepoch: number;\n\tvalue: T;\n}\n\nexport class StaleResourceStateError extends Error {\n\treadonly resourceKey: string;\n\treadonly expectedEpoch: number;\n\treadonly actualEpoch: number;\n\n\tconstructor(resourceKey: string, expectedEpoch: number, actualEpoch: number) {\n\t\tsuper(`State is stale for ${resourceKey}: expected epoch ${expectedEpoch}, current epoch ${actualEpoch}.`);\n\t\tthis.name = \"StaleResourceStateError\";\n\t\tthis.resourceKey = resourceKey;\n\t\tthis.expectedEpoch = expectedEpoch;\n\t\tthis.actualEpoch = actualEpoch;\n\t}\n}\n\n/** Bounded insertion-ordered store for immutable agent-facing observations. */\nexport class StateStore<T> {\n\tprivate readonly records = new Map<string, StoredState<T>>();\n\n\tprivate readonly limit: number;\n\n\tconstructor(limit = 128) {\n\t\tthis.limit = limit;\n\t}\n\n\tcreate(resourceKey: string, epoch: number, value: T): StoredState<T> {\n\t\tconst record = { stateId: randomUUID(), resourceKey, epoch, value };\n\t\tthis.set(record);\n\t\treturn record;\n\t}\n\n\tset(record: StoredState<T>): void {\n\t\tthis.records.delete(record.stateId);\n\t\tthis.records.set(record.stateId, record);\n\t\twhile (this.records.size > this.limit) {\n\t\t\tconst oldest = this.records.keys().next().value as string | undefined;\n\t\t\tif (!oldest) break;\n\t\t\tthis.records.delete(oldest);\n\t\t}\n\t}\n\n\tget(stateId: string): StoredState<T> | undefined {\n\t\treturn this.records.get(stateId);\n\t}\n\n\tclear(): void {\n\t\tthis.records.clear();\n\t}\n\n\tget size(): number {\n\t\treturn this.records.size;\n\t}\n}\n\ninterface ResourceRecord {\n\tepoch: number;\n\ttail: Promise<void>;\n}\n\n/**\n * Orders live operations per physical resource while allowing unrelated\n * resources to overlap. Cached state queries bypass this scheduler entirely.\n */\nexport class ResourceScheduler {\n\tprivate readonly resources = new Map<string, ResourceRecord>();\n\tprivate closed = false;\n\n\tepoch(resourceKey: string): number {\n\t\treturn this.resource(resourceKey).epoch;\n\t}\n\n\trestoreEpoch(resourceKey: string, epoch: number): void {\n\t\tconst record = this.resource(resourceKey);\n\t\trecord.epoch = Math.max(record.epoch, Math.max(0, Math.trunc(epoch)));\n\t}\n\n\tasync read<T>(resourceKey: string, work: (epoch: number) => Promise<T>): Promise<{ value: T; epoch: number }> {\n\t\treturn await this.enqueue(resourceKey, async (record) => ({\n\t\t\tvalue: await work(record.epoch),\n\t\t\tepoch: record.epoch,\n\t\t}));\n\t}\n\n\tasync readAt<T>(\n\t\tresourceKey: string,\n\t\texpectedEpoch: number,\n\t\twork: (epoch: number) => Promise<T>,\n\t): Promise<{ value: T; epoch: number }> {\n\t\treturn await this.enqueue(resourceKey, async (record) => {\n\t\t\tif (record.epoch !== expectedEpoch)\n\t\t\t\tthrow new StaleResourceStateError(resourceKey, expectedEpoch, record.epoch);\n\t\t\treturn { value: await work(record.epoch), epoch: record.epoch };\n\t\t});\n\t}\n\n\tasync write<T>(\n\t\tresourceKey: string,\n\t\tbaseEpoch: number,\n\t\twork: (nextEpoch: number) => Promise<T>,\n\t): Promise<{ value: T; epoch: number }> {\n\t\treturn await this.enqueue(resourceKey, async (record) => {\n\t\t\tif (record.epoch !== baseEpoch) throw new StaleResourceStateError(resourceKey, baseEpoch, record.epoch);\n\t\t\tconst nextEpoch = record.epoch + 1;\n\t\t\t// Invalidate the base state before dispatch. If native execution becomes\n\t\t\t// uncertain or throws after a partial effect, later writes still fail safe.\n\t\t\trecord.epoch = nextEpoch;\n\t\t\treturn { value: await work(nextEpoch), epoch: nextEpoch };\n\t\t});\n\t}\n\n\tasync drain(): Promise<void> {\n\t\tawait Promise.all([...this.resources.values()].map((record) => record.tail.catch(() => undefined)));\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.closed = true;\n\t\tawait this.drain();\n\t\tthis.resources.clear();\n\t}\n\n\tprivate resource(resourceKey: string): ResourceRecord {\n\t\tlet record = this.resources.get(resourceKey);\n\t\tif (!record) {\n\t\t\trecord = { epoch: 0, tail: Promise.resolve() };\n\t\t\tthis.resources.set(resourceKey, record);\n\t\t}\n\t\treturn record;\n\t}\n\n\tprivate async enqueue<T>(resourceKey: string, work: (record: ResourceRecord) => Promise<T>): Promise<T> {\n\t\tif (this.closed) throw new Error(\"Computer-use session is shutting down.\");\n\t\tconst record = this.resource(resourceKey);\n\t\tconst previous = record.tail;\n\t\tlet release!: () => void;\n\t\tconst next = new Promise<void>((resolve) => {\n\t\t\trelease = resolve;\n\t\t});\n\t\trecord.tail = previous.catch(() => undefined).then(() => next);\n\t\tawait previous.catch(() => undefined);\n\t\ttry {\n\t\t\treturn await work(record);\n\t\t} finally {\n\t\t\trelease();\n\t\t}\n\t}\n}\n"]}

package/dist/core/computer/motor/runtime.js

@@ -0,0 +1,119 @@
+import { randomUUID } from "node:crypto";
+export class StaleResourceStateError extends Error {
+    resourceKey;
+    expectedEpoch;
+    actualEpoch;
+    constructor(resourceKey, expectedEpoch, actualEpoch) {
+        super(`State is stale for ${resourceKey}: expected epoch ${expectedEpoch}, current epoch ${actualEpoch}.`);
+        this.name = "StaleResourceStateError";
+        this.resourceKey = resourceKey;
+        this.expectedEpoch = expectedEpoch;
+        this.actualEpoch = actualEpoch;
+    }
+}
+/** Bounded insertion-ordered store for immutable agent-facing observations. */
+export class StateStore {
+    records = new Map();
+    limit;
+    constructor(limit = 128) {
+        this.limit = limit;
+    }
+    create(resourceKey, epoch, value) {
+        const record = { stateId: randomUUID(), resourceKey, epoch, value };
+        this.set(record);
+        return record;
+    }
+    set(record) {
+        this.records.delete(record.stateId);
+        this.records.set(record.stateId, record);
+        while (this.records.size > this.limit) {
+            const oldest = this.records.keys().next().value;
+            if (!oldest)
+                break;
+            this.records.delete(oldest);
+        }
+    }
+    get(stateId) {
+        return this.records.get(stateId);
+    }
+    clear() {
+        this.records.clear();
+    }
+    get size() {
+        return this.records.size;
+    }
+}
+/**
+ * Orders live operations per physical resource while allowing unrelated
+ * resources to overlap. Cached state queries bypass this scheduler entirely.
+ */
+export class ResourceScheduler {
+    resources = new Map();
+    closed = false;
+    epoch(resourceKey) {
+        return this.resource(resourceKey).epoch;
+    }
+    restoreEpoch(resourceKey, epoch) {
+        const record = this.resource(resourceKey);
+        record.epoch = Math.max(record.epoch, Math.max(0, Math.trunc(epoch)));
+    }
+    async read(resourceKey, work) {
+        return await this.enqueue(resourceKey, async (record) => ({
+            value: await work(record.epoch),
+            epoch: record.epoch,
+        }));
+    }
+    async readAt(resourceKey, expectedEpoch, work) {
+        return await this.enqueue(resourceKey, async (record) => {
+            if (record.epoch !== expectedEpoch)
+                throw new StaleResourceStateError(resourceKey, expectedEpoch, record.epoch);
+            return { value: await work(record.epoch), epoch: record.epoch };
+        });
+    }
+    async write(resourceKey, baseEpoch, work) {
+        return await this.enqueue(resourceKey, async (record) => {
+            if (record.epoch !== baseEpoch)
+                throw new StaleResourceStateError(resourceKey, baseEpoch, record.epoch);
+            const nextEpoch = record.epoch + 1;
+            // Invalidate the base state before dispatch. If native execution becomes
+            // uncertain or throws after a partial effect, later writes still fail safe.
+            record.epoch = nextEpoch;
+            return { value: await work(nextEpoch), epoch: nextEpoch };
+        });
+    }
+    async drain() {
+        await Promise.all([...this.resources.values()].map((record) => record.tail.catch(() => undefined)));
+    }
+    async close() {
+        this.closed = true;
+        await this.drain();
+        this.resources.clear();
+    }
+    resource(resourceKey) {
+        let record = this.resources.get(resourceKey);
+        if (!record) {
+            record = { epoch: 0, tail: Promise.resolve() };
+            this.resources.set(resourceKey, record);
+        }
+        return record;
+    }
+    async enqueue(resourceKey, work) {
+        if (this.closed)
+            throw new Error("Computer-use session is shutting down.");
+        const record = this.resource(resourceKey);
+        const previous = record.tail;
+        let release;
+        const next = new Promise((resolve) => {
+            release = resolve;
+        });
+        record.tail = previous.catch(() => undefined).then(() => next);
+        await previous.catch(() => undefined);
+        try {
+            return await work(record);
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/computer/motor/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../../src/core/computer/motor/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\n\nexport interface StoredState<T> {\n\tstateId: string;\n\tresourceKey: string;\n\tepoch: number;\n\tvalue: T;\n}\n\nexport class StaleResourceStateError extends Error {\n\treadonly resourceKey: string;\n\treadonly expectedEpoch: number;\n\treadonly actualEpoch: number;\n\n\tconstructor(resourceKey: string, expectedEpoch: number, actualEpoch: number) {\n\t\tsuper(`State is stale for ${resourceKey}: expected epoch ${expectedEpoch}, current epoch ${actualEpoch}.`);\n\t\tthis.name = \"StaleResourceStateError\";\n\t\tthis.resourceKey = resourceKey;\n\t\tthis.expectedEpoch = expectedEpoch;\n\t\tthis.actualEpoch = actualEpoch;\n\t}\n}\n\n/** Bounded insertion-ordered store for immutable agent-facing observations. */\nexport class StateStore<T> {\n\tprivate readonly records = new Map<string, StoredState<T>>();\n\n\tprivate readonly limit: number;\n\n\tconstructor(limit = 128) {\n\t\tthis.limit = limit;\n\t}\n\n\tcreate(resourceKey: string, epoch: number, value: T): StoredState<T> {\n\t\tconst record = { stateId: randomUUID(), resourceKey, epoch, value };\n\t\tthis.set(record);\n\t\treturn record;\n\t}\n\n\tset(record: StoredState<T>): void {\n\t\tthis.records.delete(record.stateId);\n\t\tthis.records.set(record.stateId, record);\n\t\twhile (this.records.size > this.limit) {\n\t\t\tconst oldest = this.records.keys().next().value as string | undefined;\n\t\t\tif (!oldest) break;\n\t\t\tthis.records.delete(oldest);\n\t\t}\n\t}\n\n\tget(stateId: string): StoredState<T> | undefined {\n\t\treturn this.records.get(stateId);\n\t}\n\n\tclear(): void {\n\t\tthis.records.clear();\n\t}\n\n\tget size(): number {\n\t\treturn this.records.size;\n\t}\n}\n\ninterface ResourceRecord {\n\tepoch: number;\n\ttail: Promise<void>;\n}\n\n/**\n * Orders live operations per physical resource while allowing unrelated\n * resources to overlap. Cached state queries bypass this scheduler entirely.\n */\nexport class ResourceScheduler {\n\tprivate readonly resources = new Map<string, ResourceRecord>();\n\tprivate closed = false;\n\n\tepoch(resourceKey: string): number {\n\t\treturn this.resource(resourceKey).epoch;\n\t}\n\n\trestoreEpoch(resourceKey: string, epoch: number): void {\n\t\tconst record = this.resource(resourceKey);\n\t\trecord.epoch = Math.max(record.epoch, Math.max(0, Math.trunc(epoch)));\n\t}\n\n\tasync read<T>(resourceKey: string, work: (epoch: number) => Promise<T>): Promise<{ value: T; epoch: number }> {\n\t\treturn await this.enqueue(resourceKey, async (record) => ({\n\t\t\tvalue: await work(record.epoch),\n\t\t\tepoch: record.epoch,\n\t\t}));\n\t}\n\n\tasync readAt<T>(\n\t\tresourceKey: string,\n\t\texpectedEpoch: number,\n\t\twork: (epoch: number) => Promise<T>,\n\t): Promise<{ value: T; epoch: number }> {\n\t\treturn await this.enqueue(resourceKey, async (record) => {\n\t\t\tif (record.epoch !== expectedEpoch)\n\t\t\t\tthrow new StaleResourceStateError(resourceKey, expectedEpoch, record.epoch);\n\t\t\treturn { value: await work(record.epoch), epoch: record.epoch };\n\t\t});\n\t}\n\n\tasync write<T>(\n\t\tresourceKey: string,\n\t\tbaseEpoch: number,\n\t\twork: (nextEpoch: number) => Promise<T>,\n\t): Promise<{ value: T; epoch: number }> {\n\t\treturn await this.enqueue(resourceKey, async (record) => {\n\t\t\tif (record.epoch !== baseEpoch) throw new StaleResourceStateError(resourceKey, baseEpoch, record.epoch);\n\t\t\tconst nextEpoch = record.epoch + 1;\n\t\t\t// Invalidate the base state before dispatch. If native execution becomes\n\t\t\t// uncertain or throws after a partial effect, later writes still fail safe.\n\t\t\trecord.epoch = nextEpoch;\n\t\t\treturn { value: await work(nextEpoch), epoch: nextEpoch };\n\t\t});\n\t}\n\n\tasync drain(): Promise<void> {\n\t\tawait Promise.all([...this.resources.values()].map((record) => record.tail.catch(() => undefined)));\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.closed = true;\n\t\tawait this.drain();\n\t\tthis.resources.clear();\n\t}\n\n\tprivate resource(resourceKey: string): ResourceRecord {\n\t\tlet record = this.resources.get(resourceKey);\n\t\tif (!record) {\n\t\t\trecord = { epoch: 0, tail: Promise.resolve() };\n\t\t\tthis.resources.set(resourceKey, record);\n\t\t}\n\t\treturn record;\n\t}\n\n\tprivate async enqueue<T>(resourceKey: string, work: (record: ResourceRecord) => Promise<T>): Promise<T> {\n\t\tif (this.closed) throw new Error(\"Computer-use session is shutting down.\");\n\t\tconst record = this.resource(resourceKey);\n\t\tconst previous = record.tail;\n\t\tlet release!: () => void;\n\t\tconst next = new Promise<void>((resolve) => {\n\t\t\trelease = resolve;\n\t\t});\n\t\trecord.tail = previous.catch(() => undefined).then(() => next);\n\t\tawait previous.catch(() => undefined);\n\t\ttry {\n\t\t\treturn await work(record);\n\t\t} finally {\n\t\t\trelease();\n\t\t}\n\t}\n}\n"]}

package/dist/core/computer/motor/state.d.ts

@@ -0,0 +1,68 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { CdpPageSnapshot } from "./cdp.ts";
+import type { ImageMode } from "./contract.ts";
+import type { WindowNote } from "./note.ts";
+import { type LookResponse, type Outline, type SerializedOutline } from "./outline.ts";
+import { StateStore, type StoredState } from "./runtime.ts";
+interface StateTargetSnapshot {
+    pid: number;
+    windowId: number;
+    windowRef?: string;
+}
+export interface CurrentTarget {
+    appName: string;
+    bundleId?: string;
+    pid: number;
+    windowTitle: string;
+    windowId: number;
+    windowRef?: string;
+    nativeWindowRef?: string;
+}
+export interface CurrentCapture {
+    stateId: string;
+    width: number;
+    height: number;
+    scaleFactor: number;
+    timestamp: number;
+}
+export interface OperationState {
+    currentTarget?: CurrentTarget;
+    currentCapture?: CurrentCapture;
+    currentStateTarget?: StateTargetSnapshot;
+    currentImageMode?: ImageMode;
+    currentLook?: LookResponse;
+    currentOutline?: Outline;
+    currentNote?: WindowNote;
+    resourceKey?: string;
+    epoch?: number;
+    lastSearchOcrEscalatedLookId?: string;
+    browserSnapshot?: CdpPageSnapshot;
+    contextId?: string;
+}
+interface DesktopObservation {
+    kind: "desktop";
+    target: CurrentTarget;
+    capture: CurrentCapture;
+    look: Omit<LookResponse, "parsedOutline" | "outline">;
+    outline: SerializedOutline;
+    note?: WindowNote;
+    imageMode?: ImageMode;
+}
+interface BrowserObservation {
+    kind: "browser";
+    snapshot: CdpPageSnapshot;
+    outline: SerializedOutline;
+}
+export type UiObservation = DesktopObservation | BrowserObservation;
+export declare class SavedStates {
+    readonly store: StateStore<UiObservation>;
+    readonly operations: AsyncLocalStorage<OperationState>;
+    current(): OperationState;
+    get(stateId: string): StoredState<UiObservation> | undefined;
+    set(record: StoredState<UiObservation>): void;
+    clear(): void;
+    hydrate(record: StoredState<UiObservation> | undefined): OperationState;
+    saveDesktop(state: OperationState, resourceKey: string, epoch: number): void;
+}
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/core/computer/motor/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/core/computer/motor/state.ts"],"names":[],"mappings":"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","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { CdpPageSnapshot } from \"./cdp.ts\";\nimport type { ImageMode } from \"./contract.ts\";\nimport type { WindowNote } from \"./note.ts\";\nimport {\n\ttype LookResponse,\n\ttype Outline,\n\trestoreOutline,\n\ttype SerializedOutline,\n\tserializeOutline,\n} from \"./outline.ts\";\nimport { StateStore, type StoredState } from \"./runtime.ts\";\n\ninterface StateTargetSnapshot {\n\tpid: number;\n\twindowId: number;\n\twindowRef?: string;\n}\n\nexport interface CurrentTarget {\n\tappName: string;\n\tbundleId?: string;\n\tpid: number;\n\twindowTitle: string;\n\twindowId: number;\n\twindowRef?: string;\n\tnativeWindowRef?: string;\n}\n\nexport interface CurrentCapture {\n\tstateId: string;\n\twidth: number;\n\theight: number;\n\tscaleFactor: number;\n\ttimestamp: number;\n}\n\nexport interface OperationState {\n\tcurrentTarget?: CurrentTarget;\n\tcurrentCapture?: CurrentCapture;\n\tcurrentStateTarget?: StateTargetSnapshot;\n\tcurrentImageMode?: ImageMode;\n\tcurrentLook?: LookResponse;\n\tcurrentOutline?: Outline;\n\tcurrentNote?: WindowNote;\n\tresourceKey?: string;\n\tepoch?: number;\n\tlastSearchOcrEscalatedLookId?: string;\n\tbrowserSnapshot?: CdpPageSnapshot;\n\tcontextId?: string;\n}\n\ninterface DesktopObservation {\n\tkind: \"desktop\";\n\ttarget: CurrentTarget;\n\tcapture: CurrentCapture;\n\tlook: Omit<LookResponse, \"parsedOutline\" | \"outline\">;\n\toutline: SerializedOutline;\n\tnote?: WindowNote;\n\timageMode?: ImageMode;\n}\n\ninterface BrowserObservation {\n\tkind: \"browser\";\n\tsnapshot: CdpPageSnapshot;\n\toutline: SerializedOutline;\n}\n\nexport type UiObservation = DesktopObservation | BrowserObservation;\n\nexport class SavedStates {\n\treadonly store = new StateStore<UiObservation>(128);\n\treadonly operations = new AsyncLocalStorage<OperationState>();\n\n\tcurrent(): OperationState {\n\t\tconst state = this.operations.getStore();\n\t\tif (!state) throw new Error(\"Computer-use operation state is unavailable.\");\n\t\treturn state;\n\t}\n\n\tget(stateId: string): StoredState<UiObservation> | undefined {\n\t\treturn this.store.get(stateId);\n\t}\n\n\tset(record: StoredState<UiObservation>): void {\n\t\tthis.store.set(record);\n\t}\n\n\tclear(): void {\n\t\tthis.store.clear();\n\t}\n\n\thydrate(record: StoredState<UiObservation> | undefined): OperationState {\n\t\tif (!record) return {};\n\t\tif (record.value.kind === \"browser\") {\n\t\t\tconst outline = restoreOutline(record.value.outline);\n\t\t\treturn {\n\t\t\t\tcurrentCapture: {\n\t\t\t\t\tstateId: record.stateId,\n\t\t\t\t\twidth: 0,\n\t\t\t\t\theight: 0,\n\t\t\t\t\tscaleFactor: 1,\n\t\t\t\t\ttimestamp: record.value.snapshot.capturedAt,\n\t\t\t\t},\n\t\t\t\tcurrentLook: {\n\t\t\t\t\tlookId: record.value.snapshot.snapshotId,\n\t\t\t\t\tcapturedAt: record.value.snapshot.capturedAt / 1000,\n\t\t\t\t\twindow: {\n\t\t\t\t\t\twindowId: 0,\n\t\t\t\t\t\tframePoints: { x: 0, y: 0, w: 1, h: 1 },\n\t\t\t\t\t\tscaleFactor: 1,\n\t\t\t\t\t\tisModal: false,\n\t\t\t\t\t\trole: \"document\",\n\t\t\t\t\t\tsubrole: \"\",\n\t\t\t\t\t},\n\t\t\t\t\toutline: outline.root,\n\t\t\t\t\ttimings: {},\n\t\t\t\t\tparsedOutline: outline,\n\t\t\t\t},\n\t\t\t\tcurrentOutline: outline,\n\t\t\t\tresourceKey: record.resourceKey,\n\t\t\t\tepoch: record.epoch,\n\t\t\t\tbrowserSnapshot: record.value.snapshot,\n\t\t\t\tcontextId: record.value.snapshot.contextId,\n\t\t\t};\n\t\t}\n\t\tconst outline = restoreOutline(record.value.outline);\n\t\treturn {\n\t\t\tcurrentTarget: { ...record.value.target },\n\t\t\tcurrentCapture: { ...record.value.capture },\n\t\t\tcurrentStateTarget: {\n\t\t\t\tpid: record.value.target.pid,\n\t\t\t\twindowId: record.value.target.windowId,\n\t\t\t\twindowRef: record.value.target.windowRef,\n\t\t\t},\n\t\t\tcurrentImageMode: record.value.imageMode,\n\t\t\tcurrentLook: { ...record.value.look, outline: outline.root, parsedOutline: outline },\n\t\t\tcurrentOutline: outline,\n\t\t\tcurrentNote: record.value.note ? structuredClone(record.value.note) : undefined,\n\t\t\tresourceKey: record.resourceKey,\n\t\t\tepoch: record.epoch,\n\t\t};\n\t}\n\n\tsaveDesktop(state: OperationState, resourceKey: string, epoch: number): void {\n\t\tif (!state.currentTarget || !state.currentCapture || !state.currentLook || !state.currentOutline) return;\n\t\tthis.store.set({\n\t\t\tstateId: state.currentCapture.stateId,\n\t\t\tresourceKey,\n\t\t\tepoch,\n\t\t\tvalue: {\n\t\t\t\tkind: \"desktop\",\n\t\t\t\ttarget: { ...state.currentTarget },\n\t\t\t\tcapture: { ...state.currentCapture },\n\t\t\t\tlook: {\n\t\t\t\t\tlookId: state.currentLook.lookId,\n\t\t\t\t\tcapturedAt: state.currentLook.capturedAt,\n\t\t\t\t\twindow: structuredClone(state.currentLook.window),\n\t\t\t\t\timage: state.currentLook.image ? { ...state.currentLook.image } : undefined,\n\t\t\t\t\ttimings: { ...state.currentLook.timings },\n\t\t\t\t\treadText: state.currentLook.readText ? { ...state.currentLook.readText } : undefined,\n\t\t\t\t},\n\t\t\t\toutline: serializeOutline(state.currentOutline),\n\t\t\t\tnote: state.currentNote ? structuredClone(state.currentNote) : undefined,\n\t\t\t\timageMode: state.currentImageMode,\n\t\t\t},\n\t\t});\n\t}\n}\n"]}

package/dist/core/computer/motor/state.js

@@ -0,0 +1,100 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { restoreOutline, serializeOutline, } from "./outline.js";
+import { StateStore } from "./runtime.js";
+export class SavedStates {
+    store = new StateStore(128);
+    operations = new AsyncLocalStorage();
+    current() {
+        const state = this.operations.getStore();
+        if (!state)
+            throw new Error("Computer-use operation state is unavailable.");
+        return state;
+    }
+    get(stateId) {
+        return this.store.get(stateId);
+    }
+    set(record) {
+        this.store.set(record);
+    }
+    clear() {
+        this.store.clear();
+    }
+    hydrate(record) {
+        if (!record)
+            return {};
+        if (record.value.kind === "browser") {
+            const outline = restoreOutline(record.value.outline);
+            return {
+                currentCapture: {
+                    stateId: record.stateId,
+                    width: 0,
+                    height: 0,
+                    scaleFactor: 1,
+                    timestamp: record.value.snapshot.capturedAt,
+                },
+                currentLook: {
+                    lookId: record.value.snapshot.snapshotId,
+                    capturedAt: record.value.snapshot.capturedAt / 1000,
+                    window: {
+                        windowId: 0,
+                        framePoints: { x: 0, y: 0, w: 1, h: 1 },
+                        scaleFactor: 1,
+                        isModal: false,
+                        role: "document",
+                        subrole: "",
+                    },
+                    outline: outline.root,
+                    timings: {},
+                    parsedOutline: outline,
+                },
+                currentOutline: outline,
+                resourceKey: record.resourceKey,
+                epoch: record.epoch,
+                browserSnapshot: record.value.snapshot,
+                contextId: record.value.snapshot.contextId,
+            };
+        }
+        const outline = restoreOutline(record.value.outline);
+        return {
+            currentTarget: { ...record.value.target },
+            currentCapture: { ...record.value.capture },
+            currentStateTarget: {
+                pid: record.value.target.pid,
+                windowId: record.value.target.windowId,
+                windowRef: record.value.target.windowRef,
+            },
+            currentImageMode: record.value.imageMode,
+            currentLook: { ...record.value.look, outline: outline.root, parsedOutline: outline },
+            currentOutline: outline,
+            currentNote: record.value.note ? structuredClone(record.value.note) : undefined,
+            resourceKey: record.resourceKey,
+            epoch: record.epoch,
+        };
+    }
+    saveDesktop(state, resourceKey, epoch) {
+        if (!state.currentTarget || !state.currentCapture || !state.currentLook || !state.currentOutline)
+            return;
+        this.store.set({
+            stateId: state.currentCapture.stateId,
+            resourceKey,
+            epoch,
+            value: {
+                kind: "desktop",
+                target: { ...state.currentTarget },
+                capture: { ...state.currentCapture },
+                look: {
+                    lookId: state.currentLook.lookId,
+                    capturedAt: state.currentLook.capturedAt,
+                    window: structuredClone(state.currentLook.window),
+                    image: state.currentLook.image ? { ...state.currentLook.image } : undefined,
+                    timings: { ...state.currentLook.timings },
+                    readText: state.currentLook.readText ? { ...state.currentLook.readText } : undefined,
+                },
+                outline: serializeOutline(state.currentOutline),
+                note: state.currentNote ? structuredClone(state.currentNote) : undefined,
+                imageMode: state.currentImageMode,
+            },
+        });
+    }
+}
+//# sourceMappingURL=state.js.map