humanish 0.108.0 → 0.109.1

package/dist/guest/chromium-text.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { CuaExecutorError, isCuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError, isComputerUseExecutorError, } from "../actors/computer-use/executor-error.js";
 const DEADLINE_MS = 5_000;
 // These expressions execute only in this port's isolated world. Actor text is
 // never interpolated into JavaScript, a selector, a world name, or a CDP method.
@@ -103,16 +103,16 @@ function unwatchTargetEvents(settings, handlers) {
 function checkScope(settings, state, expected) {
     const { context, page } = settings;
     if (state.closed || state.unusable)
-        throw new CuaExecutorError("executor_closed", "not_dispatched");
+        throw new ComputerUseExecutorError("executor_closed", "not_dispatched");
     if (state.generation !== expected)
-        throw new CuaExecutorError("session_revoked", "not_dispatched");
+        throw new ComputerUseExecutorError("session_revoked", "not_dispatched");
     const pages = context.pages();
     if (state.dialogSeen ||
         page.isClosed() ||
         page.context() !== context ||
         pages.length !== 1 ||
         pages[0] !== page)
-        throw new CuaExecutorError("action_rejected", "not_dispatched");
+        throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
 }
 /**
  * One bounded operation: a 5 s deadline, the caller's abort, and any interrupt race every step.
@@ -133,7 +133,7 @@ async function runOperation(settings, state, signal, expected, body) {
             return;
         stopped = code;
         controller.abort();
-        rejectStop(new CuaExecutorError(code, dispatched ? "outcome_uncertain" : "not_dispatched"));
+        rejectStop(new ComputerUseExecutorError(code, dispatched ? "outcome_uncertain" : "not_dispatched"));
     };
     const abort = () => interrupt("cancelled");
     const timer = setTimeout(() => interrupt("deadline_exceeded"), DEADLINE_MS);
@@ -143,7 +143,7 @@ async function runOperation(settings, state, signal, expected, body) {
         if (signal.aborted)
             abort();
         if (stopped)
-            throw new CuaExecutorError(stopped, dispatched ? "outcome_uncertain" : "not_dispatched");
+            throw new ComputerUseExecutorError(stopped, dispatched ? "outcome_uncertain" : "not_dispatched");
         checkScope(settings, state, expected);
     };
     try {
@@ -165,8 +165,8 @@ async function runOperation(settings, state, signal, expected, body) {
         controller.abort();
         if (dispatched)
             state.unusable = true;
-        const code = stopped ?? (isCuaExecutorError(error) ? error.code : "transport_failed");
-        throw new CuaExecutorError(code, dispatched ? "outcome_uncertain" : "not_dispatched");
+        const code = stopped ?? (isComputerUseExecutorError(error) ? error.code : "transport_failed");
+        throw new ComputerUseExecutorError(code, dispatched ? "outcome_uncertain" : "not_dispatched");
     }
     finally {
         clearTimeout(timer);
@@ -187,13 +187,13 @@ function sessionDetacher(state) {
                 await Promise.race([
                     session.detach(),
                     new Promise((_resolve, reject) => {
-                        timer = setTimeout(() => reject(new CuaExecutorError("deadline_exceeded", "not_dispatched")), DEADLINE_MS);
+                        timer = setTimeout(() => reject(new ComputerUseExecutorError("deadline_exceeded", "not_dispatched")), DEADLINE_MS);
                     }),
                 ]);
             }
             catch {
                 state.unusable = true;
-                throw new CuaExecutorError("transport_failed", "not_dispatched");
+                throw new ComputerUseExecutorError("transport_failed", "not_dispatched");
             }
             finally {
                 clearTimeout(timer);
@@ -215,7 +215,7 @@ async function assertOwnerReady(settings, op) {
 async function probeElement(op, session, contextId, expression) {
     const result = await op.step(() => session.send("Runtime.evaluate", evaluateParams(expression, contextId)));
     if (!probeAccepted(result))
-        throw new CuaExecutorError("action_rejected", "not_dispatched");
+        throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
 }
 /**
  * Preparation: the owner check, a CDP session (recorded on the handle as soon as it exists, so
@@ -233,14 +233,14 @@ async function acquireIsolatedWorld(settings, state, detach, prepared, op) {
     const tree = await op.step(() => prepared.session.send("Page.getFrameTree"));
     const frameId = ownedFrameId(tree);
     if (frameId === undefined)
-        throw new CuaExecutorError("invalid_response", "not_dispatched");
+        throw new ComputerUseExecutorError("invalid_response", "not_dispatched");
     const world = await op.step(() => prepared.session.send("Page.createIsolatedWorld", {
         frameId,
         worldName: settings.worldName,
     }));
     prepared.contextId = world.executionContextId;
     if (!isExecutionContextId(prepared.contextId))
-        throw new CuaExecutorError("invalid_response", "not_dispatched");
+        throw new ComputerUseExecutorError("invalid_response", "not_dispatched");
     await probeElement(op, prepared.session, prepared.contextId, PREPARE);
 }
 /** Disposes a prepared handle once: aborts its lifetime, detaches its session, releases busy. */
@@ -255,7 +255,7 @@ function disposePrepared(state, detach, prepared, self) {
                     await detach(prepared.session);
             }
             catch (error) {
-                throw new CuaExecutorError(isCuaExecutorError(error) ? error.code : "transport_failed", prepared.dispatchedText ? "outcome_uncertain" : "not_dispatched");
+                throw new ComputerUseExecutorError(isComputerUseExecutorError(error) ? error.code : "transport_failed", prepared.dispatchedText ? "outcome_uncertain" : "not_dispatched");
             }
             finally {
                 state.busy = false;
@@ -274,7 +274,7 @@ function preparedHandle(settings, state, prepared, dispose) {
     return {
         async paste() {
             if (prepared.used || prepared.disposed)
-                throw new CuaExecutorError("action_rejected", "not_dispatched");
+                throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
             prepared.used = true; // A failed attempt cannot be retried through this handle.
             await runOperation(settings, state, prepared.lifetime.signal, prepared.expected, async (op) => {
                 await assertOwnerReady(settings, op);
@@ -345,10 +345,10 @@ export function createGuestChromiumText(options) {
         },
         async prepareText(text, signal) {
             if (!isAdmissibleText(text))
-                throw new CuaExecutorError("invalid_request", "not_dispatched");
+                throw new ComputerUseExecutorError("invalid_request", "not_dispatched");
             checkScope(settings, state, state.generation);
             if (state.busy)
-                throw new CuaExecutorError("executor_busy", "not_dispatched");
+                throw new ComputerUseExecutorError("executor_busy", "not_dispatched");
             state.busy = true;
             const expected = state.generation;
             const lifetime = new AbortController();

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

@@ -1,5 +1,5 @@
 import type { CuaAction, CuaExecutor } from "../actors/computer-use/loop.js";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 /** Internal guest port. Implementations recheck signal synchronously before native dispatch. */
 export interface GuestDesktopTools {
     capture(signal: AbortSignal): Promise<Buffer>;
@@ -48,7 +48,7 @@ export declare function failureEndsSession(progress: Pick<ActionProgress, "prepa
  * session_revoked when the signal aborted, then the executor's own error or execution_failed. It
  * reads signal.aborted only for an undispatched failure, as the inline mapping did.
  */
-export declare function failureError(dispatched: boolean, error: unknown, signal: Pick<AbortSignal, "aborted">): CuaExecutorError;
+export declare function failureError(dispatched: boolean, error: unknown, signal: Pick<AbortSignal, "aborted">): ComputerUseExecutorError;
 /**
  * The native commands for an action, wrapped in keydown/keyup when it holds modifiers. It throws
  * the refusal for an action the desktop cannot take, before anything is sent.

package/dist/guest/desktop-executor.js

@@ -1,13 +1,13 @@
 import { perceptualSignature } from "../evidence/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 "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError, isComputerUseExecutorError, } from "../actors/computer-use/executor-error.js";
 import { xdotoolChord, xdotoolHeldModifiers } from "./desktop-keys.js";
 /** Headed X11 input and full-frame captures. Browser metadata is deliberately absent. */
 export function createGuestDesktopExecutor(options) {
     const { width, height, tools, authoritySignal } = options;
     if (!isValidFrameSize(width, height))
-        throw new CuaExecutorError("invalid_request", "not_dispatched");
+        throw new ComputerUseExecutorError("invalid_request", "not_dispatched");
     const context = {
         width,
         height,
@@ -40,12 +40,12 @@ function terminate(state, context) {
 }
 function assertOpen(state, signal, dispatched = false) {
     if (state.terminal || signal.aborted)
-        throw new CuaExecutorError("session_revoked", dispatched ? "outcome_uncertain" : "not_dispatched");
+        throw new ComputerUseExecutorError("session_revoked", dispatched ? "outcome_uncertain" : "not_dispatched");
 }
 function begin(state, signal) {
     assertOpen(state, signal);
     if (state.busy)
-        throw new CuaExecutorError("executor_busy", "not_dispatched");
+        throw new ComputerUseExecutorError("executor_busy", "not_dispatched");
     state.busy = true;
 }
 /** Captures one full frame and checks it is a PNG of the executor's size. */
@@ -57,15 +57,15 @@ async function observeFrame(context, state) {
         assertOpen(state, authoritySignal);
         validateBrowserControlPng(screenshot);
         if (screenshot.readUInt32BE(16) !== width || screenshot.readUInt32BE(20) !== height) {
-            throw new CuaExecutorError("invalid_response", "not_dispatched");
+            throw new ComputerUseExecutorError("invalid_response", "not_dispatched");
         }
         return { screenshot, stateSignature: perceptualSignature(screenshot) };
     }
     catch (error) {
         terminate(state, context);
-        throw isCuaExecutorError(error)
+        throw isComputerUseExecutorError(error)
             ? error
-            : new CuaExecutorError("execution_failed", "not_dispatched");
+            : new ComputerUseExecutorError("execution_failed", "not_dispatched");
     }
     finally {
         state.busy = false;
@@ -99,7 +99,7 @@ async function executeAction(context, state, value, callerSignal) {
             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")
+                if (isComputerUseExecutorError(error) && error.disposition === "not_dispatched")
                     progress.dispatched = false;
                 throw error;
             }
@@ -143,7 +143,7 @@ async function executeAction(context, state, value, callerSignal) {
         catch {
             terminate(state, context);
             // oxlint-disable-next-line no-unsafe-finally -- a text channel that fails to close makes the action outcome unknowable
-            throw new CuaExecutorError("execution_failed", progress.dispatched ? "outcome_uncertain" : "not_dispatched");
+            throw new ComputerUseExecutorError("execution_failed", progress.dispatched ? "outcome_uncertain" : "not_dispatched");
         }
         finally {
             state.busy = false;
@@ -157,12 +157,12 @@ async function executeAction(context, state, value, callerSignal) {
  */
 export function failureEndsSession(progress, error, signal) {
     return ((progress.preparing &&
-        !(isCuaExecutorError(error) &&
+        !(isComputerUseExecutorError(error) &&
             error.code === "action_rejected" &&
             error.disposition === "not_dispatched")) ||
         progress.dispatched ||
         signal.aborted ||
-        !isCuaExecutorError(error));
+        !isComputerUseExecutorError(error));
 }
 /**
  * The error a failed action throws: outcome_uncertain once anything was dispatched, then
@@ -171,12 +171,12 @@ export function failureEndsSession(progress, error, signal) {
  */
 export function failureError(dispatched, error, signal) {
     if (dispatched)
-        return new CuaExecutorError(isCuaExecutorError(error) ? error.code : "execution_failed", "outcome_uncertain");
+        return new ComputerUseExecutorError(isComputerUseExecutorError(error) ? error.code : "execution_failed", "outcome_uncertain");
     if (signal.aborted)
-        return new CuaExecutorError("session_revoked", "not_dispatched");
-    return isCuaExecutorError(error)
+        return new ComputerUseExecutorError("session_revoked", "not_dispatched");
+    return isComputerUseExecutorError(error)
         ? error
-        : new CuaExecutorError("execution_failed", "not_dispatched");
+        : new ComputerUseExecutorError("execution_failed", "not_dispatched");
 }
 /**
  * The native commands for an action, wrapped in keydown/keyup when it holds modifiers. It throws
@@ -194,7 +194,7 @@ function framePoint(frame, x, y) {
     const { width, height } = frame;
     // 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");
+        throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
     return [String(Math.min(width - 1, Math.round(x))), String(Math.min(height - 1, Math.round(y)))];
 }
 /** The native commands for an action, before any held modifiers. */
@@ -219,13 +219,13 @@ function actionCommands(frame, action) {
             // 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");
+                throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
             return [];
         }
         case "drag": {
             const points = action.path.map((p) => framePoint(frame, p.x, p.y));
             if (points.length < 2)
-                throw new CuaExecutorError("action_rejected", "not_dispatched");
+                throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
             return [
                 ["mousemove", ...points[0]],
                 ["mousedown", "1"],
@@ -238,7 +238,7 @@ function actionCommands(frame, action) {
             // 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");
+                throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
             return horizontal + vertical === 0
                 ? []
                 : [
@@ -251,6 +251,6 @@ function actionCommands(frame, action) {
         case "screenshot":
             return [];
         case "speak":
-            throw new CuaExecutorError("action_rejected", "not_dispatched");
+            throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
     }
 }

package/dist/guest/desktop-keys.js

@@ -1,4 +1,4 @@
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 // Key names for the xdotool-driven desktops: the guest's headed display and the E2B sandbox. Both
 // hand these strings to xdotool, which has a command language, so only names from these tables
 // ever reach it. The guest runtime ships this module, so it lives in src/guest/, which CI's
@@ -56,7 +56,7 @@ function lookup(table, key) {
 }
 function chord(names) {
     if (new Set(names).size !== names.length)
-        throw new CuaExecutorError("action_rejected", "not_dispatched");
+        throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
     return names.join("+");
 }
 /** A keypress chord in xdotool syntax. Unknown or repeated keys are refused before dispatch. */
@@ -68,7 +68,7 @@ export function xdotoolChord(keys) {
             return key.toUpperCase();
         const name = lookup(keyNames, key);
         if (!name)
-            throw new CuaExecutorError("action_rejected", "not_dispatched");
+            throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
         return name;
     }));
 }
@@ -83,7 +83,7 @@ export function xdotoolHeldModifiers(keys) {
     return chord(keys.map((key) => {
         const name = lookup(modifierNames, key);
         if (!name)
-            throw new CuaExecutorError("action_rejected", "not_dispatched");
+            throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
         return name;
     }));
 }

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

@@ -1,6 +1,6 @@
 import type { CuaExecutor } from "../actors/computer-use/loop.js";
 import { type HeardSpeech } from "../actors/computer-use/speech.js";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 interface GuestDesktopMediaDeclaration {
     camera?: {
         source: string;
@@ -64,7 +64,7 @@ export declare function classifyWorkerMessage(value: unknown, ready: boolean): W
 /** Once a speak command is written, its outcome is unknown unless the worker replies. */
 export declare function dispositionAfterWrite(written: boolean): "outcome_uncertain" | "not_dispatched";
 /** A failed speak keeps its own executor error; anything else is an execution failure. */
-export declare function speakFailure(error: unknown, written: boolean): CuaExecutorError;
+export declare function speakFailure(error: unknown, written: boolean): ComputerUseExecutorError;
 /** Starts optional native guest media before Chromium and later decorates its finite executor. */
 export declare function startDesktopMedia(options: GuestDesktopMediaOptions): Promise<GuestDesktopMedia>;
 export {};

package/dist/guest/desktop-media.js

@@ -1,6 +1,6 @@
 import { spawn } from "node:child_process";
 import { CUA_SPEECH_LIMITS } from "../actors/computer-use/speech.js";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 const WORKER_LINE_BYTES = 8_192;
 const READY_TIMEOUT_MS = 35_000;
 const SPEAK_TIMEOUT_MS = 30_000;
@@ -131,9 +131,9 @@ export function dispositionAfterWrite(written) {
 }
 /** A failed speak keeps its own executor error; anything else is an execution failure. */
 export function speakFailure(error, written) {
-    return error instanceof CuaExecutorError
+    return error instanceof ComputerUseExecutorError
         ? error
-        : new CuaExecutorError("execution_failed", dispositionAfterWrite(written));
+        : new ComputerUseExecutorError("execution_failed", dispositionAfterWrite(written));
 }
 function rejectPending(state, error) {
     for (const command of state.pending.values()) {
@@ -147,7 +147,7 @@ function terminateMedia(state, readiness, onTerminal) {
     if (state.closed || state.expectedExit)
         return;
     state.closed = true;
-    const error = new CuaExecutorError("execution_failed", "outcome_uncertain");
+    const error = new ComputerUseExecutorError("execution_failed", "outcome_uncertain");
     readiness.reject(error);
     rejectPending(state, error);
     try {
@@ -182,7 +182,7 @@ function applyWorkerMessage(state, value, readiness, terminate) {
             if (message.ok)
                 command.resolve();
             else
-                command.reject(new CuaExecutorError("execution_failed", "outcome_uncertain"));
+                command.reject(new ComputerUseExecutorError("execution_failed", "outcome_uncertain"));
             return;
         }
         case "terminal":
@@ -223,13 +223,13 @@ async function closeDesktopMedia(state, transport, detach) {
     state.expectedExit = true;
     state.closed = true;
     detach();
-    rejectPending(state, new CuaExecutorError("session_revoked", "outcome_uncertain"));
+    rejectPending(state, new ComputerUseExecutorError("session_revoked", "outcome_uncertain"));
     state.closing = Promise.resolve().then(() => transport.close());
     return state.closing;
 }
 async function awaitWorkerReady(readiness, signal, close, readyTimer) {
     const readinessAbort = () => {
-        readiness.reject(new CuaExecutorError("session_revoked", "not_dispatched"));
+        readiness.reject(new ComputerUseExecutorError("session_revoked", "not_dispatched"));
     };
     signal.addEventListener("abort", readinessAbort, { once: true });
     try {
@@ -247,17 +247,17 @@ async function awaitWorkerReady(readiness, signal, close, readyTimer) {
 /** Adds queued heard speech to each observation, at most HEARD_PER_OBSERVATION at a time. */
 async function observeWithHeardSpeech(state, executor) {
     if (state.closed)
-        throw new CuaExecutorError("execution_failed", "not_dispatched");
+        throw new ComputerUseExecutorError("execution_failed", "not_dispatched");
     const observation = await executor.observe();
     if (state.closed)
-        throw new CuaExecutorError("execution_failed", "not_dispatched");
+        throw new ComputerUseExecutorError("execution_failed", "not_dispatched");
     const items = state.heard.splice(0, HEARD_PER_OBSERVATION);
     return items.length ? { ...observation, heardSpeech: items } : observation;
 }
 /** Passes every action but `speak` to the executor; `speak` goes to the worker and waits for its reply. */
 async function executeWithSpeech(state, executor, channel, action, signal) {
     if (state.closed)
-        throw new CuaExecutorError("execution_failed", "not_dispatched");
+        throw new ComputerUseExecutorError("execution_failed", "not_dispatched");
     const candidate = action;
     if (candidate.kind !== "speak")
         return executor.execute(action, signal);
@@ -266,7 +266,7 @@ async function executeWithSpeech(state, executor, channel, action, signal) {
         state.closed ||
         channel.ownerSignal.aborted ||
         signal?.aborted) {
-        throw new CuaExecutorError("action_rejected", "not_dispatched");
+        throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
     }
     const id = `speak-${state.nextCommand++}`;
     const combined = signal ? AbortSignal.any([channel.ownerSignal, signal]) : channel.ownerSignal;
@@ -274,7 +274,7 @@ async function executeWithSpeech(state, executor, channel, action, signal) {
     const operation = new Promise((resolve, reject) => {
         const timer = setTimeout(() => {
             state.pending.delete(id);
-            reject(new CuaExecutorError("deadline_exceeded", dispositionAfterWrite(written)));
+            reject(new ComputerUseExecutorError("deadline_exceeded", dispositionAfterWrite(written)));
             void channel.close().catch(() => { });
         }, SPEAK_TIMEOUT_MS);
         state.pending.set(id, { resolve, reject, timer });
@@ -286,7 +286,7 @@ async function executeWithSpeech(state, executor, channel, action, signal) {
             return;
         state.pending.delete(id);
         clearTimeout(command.timer);
-        command.reject(new CuaExecutorError("session_revoked", dispositionAfterWrite(written)));
+        command.reject(new ComputerUseExecutorError("session_revoked", dispositionAfterWrite(written)));
         void channel.close().catch(() => { });
     };
     combined.addEventListener("abort", cancelled, { once: true });
@@ -311,7 +311,7 @@ async function executeWithSpeech(state, executor, channel, action, signal) {
 }
 function wrapMediaExecutor(state, executor, channel) {
     if (state.wrapped)
-        throw new CuaExecutorError("invalid_request", "not_dispatched");
+        throw new ComputerUseExecutorError("invalid_request", "not_dispatched");
     state.wrapped = true;
     const wrapped = {
         ...executor,
@@ -324,7 +324,7 @@ function wrapMediaExecutor(state, executor, channel) {
 /** Starts optional native guest media before Chromium and later decorates its finite executor. */
 export async function startDesktopMedia(options) {
     if (!isSupportedMediaDeclaration(options.media))
-        throw new CuaExecutorError("invalid_request", "not_dispatched");
+        throw new ComputerUseExecutorError("invalid_request", "not_dispatched");
     options.signal.throwIfAborted();
     const env = desktopMediaEnv(options.env, options.media);
     const transport = options.transport ??
@@ -365,7 +365,7 @@ export async function startDesktopMedia(options) {
         await transport.close().catch(() => { });
         throw error;
     }
-    const readyTimer = setTimeout(() => readiness.reject(new CuaExecutorError("deadline_exceeded", "not_dispatched")), READY_TIMEOUT_MS);
+    const readyTimer = setTimeout(() => readiness.reject(new ComputerUseExecutorError("deadline_exceeded", "not_dispatched")), READY_TIMEOUT_MS);
     const abort = () => {
         void close();
     };

package/dist/guest/desktop-native.js

@@ -2,9 +2,9 @@ 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 "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 import { BROWSER_CONTROL_LIMITS } from "../browser-control/protocol.js";
-class UnconfirmedHelperExit extends CuaExecutorError {
+class UnconfirmedHelperExit extends ComputerUseExecutorError {
     constructor() {
         super("execution_failed", "outcome_uncertain");
     }
@@ -14,7 +14,7 @@ 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");
+        throw new ComputerUseExecutorError("invalid_request", "not_dispatched");
     }
     const environment = {
         PATH: "/usr/bin:/bin",
@@ -28,7 +28,7 @@ export function createGuestDesktopNativeTools(options) {
     // 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");
+            throw new ComputerUseExecutorError("session_revoked", "not_dispatched");
         return await new Promise((resolve, reject) => {
             const child = spawn(`/usr/bin/${binary}`, [...args], {
                 cwd: options.temporaryDirectory,
@@ -81,7 +81,7 @@ export function createGuestDesktopNativeTools(options) {
                 clearTimeout(killDeadline);
                 signal.removeEventListener("abort", abort);
                 if (failed || code !== 0)
-                    reject(new CuaExecutorError(failureCode, "outcome_uncertain"));
+                    reject(new ComputerUseExecutorError(failureCode, "outcome_uncertain"));
                 else
                     resolve(Buffer.concat(stdout));
             });
@@ -97,19 +97,19 @@ export function createGuestDesktopNativeTools(options) {
         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");
+                throw new ComputerUseExecutorError("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");
+                throw new ComputerUseExecutorError("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");
+                throw new ComputerUseExecutorError("session_revoked", "not_dispatched");
             const directory = await mkdtemp(join(options.temporaryDirectory, "capture-"));
             const path = join(directory, "frame.png");
             let reclaim = true;
@@ -122,7 +122,7 @@ export function createGuestDesktopNativeTools(options) {
                         stat.nlink !== 1 ||
                         stat.size <= 0 ||
                         stat.size > BROWSER_CONTROL_LIMITS.pngBytes) {
-                        throw new CuaExecutorError("invalid_response", "not_dispatched");
+                        throw new ComputerUseExecutorError("invalid_response", "not_dispatched");
                     }
                     const buffer = Buffer.alloc(stat.size + 1);
                     let offset = 0;
@@ -133,7 +133,7 @@ export function createGuestDesktopNativeTools(options) {
                         offset += bytesRead;
                     }
                     if (offset !== stat.size)
-                        throw new CuaExecutorError("invalid_response", "not_dispatched");
+                        throw new ComputerUseExecutorError("invalid_response", "not_dispatched");
                     return buffer.subarray(0, offset);
                 }
                 finally {

package/dist/guest/runtime-desktop.js

@@ -7,7 +7,7 @@ import { createGuestDesktopNativeTools } from "./desktop-native.js";
 import { createGuestChromiumText } from "./chromium-text.js";
 import { createGuestBrowserTools } from "./browser-tools.js";
 import { createGuestDesktopExecutor } from "./desktop-executor.js";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 import { GUEST_BOOTSTRAP_LIMITS, validateGuestInitialUrl } from "./bootstrap.js";
 import { startDesktopMedia, } from "./desktop-media.js";
 import { startDesktopRecorder } from "../evidence/desktop-recorder.js";
@@ -220,7 +220,7 @@ async function verifyBrowserSandbox(context, page, check) {
 function focusGuard(native, window) {
     return async (actionSignal) => {
         if ((await native.activeWindowId(actionSignal)) !== window)
-            throw new CuaExecutorError("action_rejected", "not_dispatched");
+            throw new ComputerUseExecutorError("action_rejected", "not_dispatched");
     };
 }
 async function createGuestExecutorFor(state, browser, signal, onTerminal, check) {

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

@@ -1,6 +1,6 @@
 import { type ChildProcess } from "node:child_process";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
-export declare const setupFailed: () => CuaExecutorError;
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
+export declare const setupFailed: () => ComputerUseExecutorError;
 export interface GuestProcesses {
     /** `done` resolves when the child exits 0 within its bounds and rejects otherwise. */
     spawn(binary: string, args: readonly string[], input?: string, persistent?: boolean): {

package/dist/guest/runtime-processes.js

@@ -1,10 +1,10 @@
 import { spawn } from "node:child_process";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 /** A short-lived helper that has not exited by then is killed. Persistent children have no bound. */
 const HELPER_TIMEOUT_MS = 2000;
 /** Helpers report success through exit status, so stderr past this budget is a failure. */
 const STDERR_LIMIT_BYTES = 16_384;
-export const setupFailed = () => new CuaExecutorError("execution_failed", "not_dispatched");
+export const setupFailed = () => new ComputerUseExecutorError("execution_failed", "not_dispatched");
 /**
  * The guest desktop's fixed child processes. A persistent child (the display server, the window
  * manager) that exits, fails or is killed by the owner's abort reports `onTerminal` unless the

package/dist/guest/runtime.js

@@ -1,6 +1,6 @@
 import { attachBrowserControlDispatcher } from "../browser-control/dispatcher.js";
 import { encodeGuestBootstrap, GuestBootstrapReader, GUEST_BOOTSTRAP_LIMITS, guestReadyTimeoutMs, } from "./bootstrap.js";
-import { CuaExecutorError } from "../actors/computer-use/executor-error.js";
+import { ComputerUseExecutorError } from "../actors/computer-use/executor-error.js";
 /** One admitted desktop and one dispatcher. The owner retains physical teardown. */
 export async function runGuestRuntime(options) {
     const owner = new AbortController();
@@ -77,7 +77,7 @@ export async function runGuestRuntime(options) {
         reader = new GuestBootstrapReader(options.transport, options.revision, authority, false, terminal);
         const identity = await reader.identity;
         if (authority.aborted)
-            throw new CuaExecutorError("session_revoked", "not_dispatched");
+            throw new ComputerUseExecutorError("session_revoked", "not_dispatched");
         clearTimeout(timer);
         timer = setTimeout(() => {
             void close();
@@ -87,7 +87,7 @@ export async function runGuestRuntime(options) {
         desktop = await Promise.race([
             preparing,
             new Promise((_, reject) => {
-                const stop = () => reject(new CuaExecutorError("session_revoked", "not_dispatched"));
+                const stop = () => reject(new ComputerUseExecutorError("session_revoked", "not_dispatched"));
                 authority.addEventListener("abort", stop, { once: true });
                 void preparing.finally(() => authority.removeEventListener("abort", stop)).catch(() => { });
                 if (authority.aborted)
@@ -95,7 +95,7 @@ export async function runGuestRuntime(options) {
             }),
         ]);
         if (authority.aborted)
-            throw new CuaExecutorError("session_revoked", "not_dispatched");
+            throw new ComputerUseExecutorError("session_revoked", "not_dispatched");
         reader.handoff();
         dispatcher = attachBrowserControlDispatcher({
             transport: options.transport,
@@ -112,7 +112,7 @@ export async function runGuestRuntime(options) {
         });
         options.transport.resume();
         if (authority.aborted || options.transport.destroyed)
-            throw new CuaExecutorError("session_revoked", "not_dispatched");
+            throw new ComputerUseExecutorError("session_revoked", "not_dispatched");
         options.marker("R");
         clearTimeout(timer);
         return { close, closed };