humanish 0.97.0 → 0.98.0

package/dist/browser-control-client.js.map

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

package/dist/browser-control-dispatcher.d.ts

@@ -0,0 +1,14 @@
+import type { Duplex } from "node:stream";
+import type { CuaExecutor } from "./computer-use.js";
+import { type BrowserControlIdentity } from "./browser-control-protocol.js";
+export interface BrowserControlDispatcherOptions {
+    transport: Duplex;
+    identity: BrowserControlIdentity;
+    executor: CuaExecutor;
+    isAuthorized: () => boolean;
+    authoritySignal: AbortSignal;
+}
+/** Caller retains physical runtime ownership. Closing this channel does not claim the browser stopped. */
+export declare function attachBrowserControlDispatcher(options: BrowserControlDispatcherOptions): {
+    close(): void;
+};

package/dist/browser-control-dispatcher.js

@@ -0,0 +1,109 @@
+import { CuaExecutorError } from "./cua-executor-error.js";
+import { BROWSER_CONTROL_LIMITS, BROWSER_CONTROL_VERSION, encodeBrowserControlObservation, parseBrowserControlRequest, safeBrowserControlFailure, sameBrowserControlIdentity, validateBrowserControlIdentity } from "./browser-control-protocol.js";
+import { BrowserControlTransport } from "./browser-control-transport.js";
+/** Caller retains physical runtime ownership. Closing this channel does not claim the browser stopped. */
+export function attachBrowserControlDispatcher(options) {
+    const identity = validateBrowserControlIdentity(options.identity);
+    let lastSeq = 0, busy = false, ready = false, closed = false;
+    let active;
+    let timer;
+    const dispose = () => { clearTimeout(timer); timer = undefined; active?.abort(); active = undefined; };
+    const authorized = () => {
+        try {
+            return !options.authoritySignal.aborted && options.isAuthorized() === true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const transport = new BrowserControlTransport(options.transport, value => {
+        if (closed)
+            return;
+        if (busy) {
+            transport.close("executor_busy");
+            return;
+        }
+        let request;
+        try {
+            request = parseBrowserControlRequest(value);
+        }
+        catch {
+            transport.close("invalid_request");
+            return;
+        }
+        if (!sameBrowserControlIdentity(identity, request.identity) || request.seq !== lastSeq + 1
+            || (request.operation === "HELLO" ? ready || request.seq !== 1 : !ready)) {
+            transport.close("protocol_mismatch");
+            return;
+        }
+        // Reserve before invoking any async work: coalesced frames cannot race this boundary.
+        busy = true;
+        lastSeq = request.seq;
+        active = new AbortController();
+        timer = setTimeout(() => transport.close("deadline_exceeded"), BROWSER_CONTROL_LIMITS.requestTimeoutMs);
+        void dispatch(request, active.signal);
+    }, () => {
+        closed = true;
+        dispose();
+        options.authoritySignal.removeEventListener("abort", revoke);
+    });
+    function revoke() { transport.close("session_revoked"); }
+    async function dispatch(request, signal) {
+        const common = { version: BROWSER_CONTROL_VERSION, type: "reply", identity, seq: request.seq,
+            requestId: request.requestId, operation: request.operation,
+            ...(request.operation === "EXECUTE" ? { actionId: request.actionId } : {}) };
+        let invoked = false, reply;
+        try {
+            if (!authorized() || signal.aborted)
+                throw new CuaExecutorError("session_revoked", "not_dispatched");
+            if (request.operation === "HELLO") {
+                ready = true;
+                reply = { ...common, ok: true };
+            }
+            else if (request.operation === "OBSERVE") {
+                invoked = true;
+                const observation = await options.executor.observe();
+                if (closed || signal.aborted || !authorized()) {
+                    transport.close("session_revoked");
+                    return;
+                }
+                reply = { ...common, ok: true, observation: encodeBrowserControlObservation(observation) };
+            }
+            else {
+                // No await between the owner gate above and invocation. The physical driver must
+                // check this signal again immediately before each actual input after preparation.
+                invoked = true;
+                await options.executor.execute(request.action, signal);
+                if (closed || signal.aborted || !authorized()) {
+                    transport.close("session_revoked");
+                    return;
+                }
+                reply = { ...common, ok: true };
+            }
+        }
+        catch (error) {
+            reply = { ...common, ok: false, error: safeBrowserControlFailure(error, invoked) };
+        }
+        if (closed)
+            return;
+        try {
+            await transport.send(reply);
+            if (!reply.ok) {
+                transport.close(reply.error.code);
+                return;
+            }
+        }
+        catch {
+            transport.close("transport_failed");
+        }
+        finally {
+            dispose();
+            busy = false;
+        }
+    }
+    options.authoritySignal.addEventListener("abort", revoke, { once: true });
+    if (!authorized())
+        transport.close("session_revoked");
+    return { close: () => transport.close() };
+}
+//# sourceMappingURL=browser-control-dispatcher.js.map

package/dist/browser-control-dispatcher.js.map

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

package/dist/browser-control-protocol.d.ts

@@ -0,0 +1,371 @@
+import { z } from "zod";
+import type { CuaAction, CuaObservation } from "./computer-use.js";
+import { type CuaExecutorErrorCode } from "./cua-executor-error.js";
+export declare const BROWSER_CONTROL_VERSION = 1;
+export declare const BROWSER_CONTROL_LIMITS: Readonly<{
+    frameBytes: number;
+    pngBytes: number;
+    dimension: 4096;
+    pixels: 16000000;
+    textBytes: number;
+    chordKeys: 16;
+    keyCharacters: 64;
+    dragPoints: 1024;
+    waitMs: 30000;
+    requestTimeoutMs: 35000;
+    maxRequestTimeoutMs: 60000;
+}>;
+export interface BrowserControlIdentity {
+    generation: string;
+    challenge: string;
+    runtimeRevision: string;
+}
+export declare const browserControlActionSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        right: "right";
+        middle: "middle";
+    }>>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    kind: z.ZodLiteral<"click">;
+}, z.core.$strict>, z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    kind: z.ZodLiteral<"double_click">;
+}, z.core.$strict>, z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    kind: z.ZodLiteral<"move">;
+}, z.core.$strict>, z.ZodObject<{
+    dx: z.ZodNumber;
+    dy: z.ZodNumber;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    kind: z.ZodLiteral<"scroll">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"type">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"keypress">;
+    keys: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"drag">;
+    path: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"wait">;
+    ms: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"screenshot">;
+}, z.core.$strict>], "kind">, z.ZodTransform<{
+    kind: "click";
+    x: number;
+    y: number;
+    button?: "left" | "right" | "middle";
+} | {
+    kind: "double_click";
+    x: number;
+    y: number;
+} | {
+    kind: "move";
+    x: number;
+    y: number;
+} | {
+    kind: "scroll";
+    x: number;
+    y: number;
+    dx: number;
+    dy: number;
+} | {
+    kind: "type";
+    text: string;
+} | {
+    kind: "keypress";
+    keys: string[];
+} | {
+    kind: "drag";
+    path: Array<{
+        x: number;
+        y: number;
+    }>;
+} | {
+    kind: "wait";
+    ms?: number;
+} | {
+    kind: "screenshot";
+}, {
+    x: number;
+    y: number;
+    kind: "click";
+    button?: "left" | "right" | "middle" | undefined;
+} | {
+    x: number;
+    y: number;
+    kind: "double_click";
+} | {
+    x: number;
+    y: number;
+    kind: "move";
+} | {
+    dx: number;
+    dy: number;
+    x: number;
+    y: number;
+    kind: "scroll";
+} | {
+    kind: "type";
+    text: string;
+} | {
+    kind: "keypress";
+    keys: string[];
+} | {
+    kind: "drag";
+    path: {
+        x: number;
+        y: number;
+    }[];
+} | {
+    kind: "wait";
+    ms?: number | undefined;
+} | {
+    kind: "screenshot";
+}>>;
+declare const observationSchema: z.ZodObject<{
+    png: z.ZodString;
+    stateSignature: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    scrollY: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type WireObservation = z.infer<typeof observationSchema>;
+declare const requestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"request">;
+    operation: z.ZodLiteral<"HELLO">;
+    version: z.ZodLiteral<1>;
+    identity: z.ZodObject<{
+        generation: z.ZodString;
+        challenge: z.ZodString;
+        runtimeRevision: z.ZodString;
+    }, z.core.$strict>;
+    seq: z.ZodNumber;
+    requestId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"request">;
+    operation: z.ZodLiteral<"OBSERVE">;
+    version: z.ZodLiteral<1>;
+    identity: z.ZodObject<{
+        generation: z.ZodString;
+        challenge: z.ZodString;
+        runtimeRevision: z.ZodString;
+    }, z.core.$strict>;
+    seq: z.ZodNumber;
+    requestId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"request">;
+    operation: z.ZodLiteral<"EXECUTE">;
+    actionId: z.ZodString;
+    action: z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            middle: "middle";
+        }>>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        kind: z.ZodLiteral<"click">;
+    }, z.core.$strict>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        kind: z.ZodLiteral<"double_click">;
+    }, z.core.$strict>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        kind: z.ZodLiteral<"move">;
+    }, z.core.$strict>, z.ZodObject<{
+        dx: z.ZodNumber;
+        dy: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        kind: z.ZodLiteral<"scroll">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"type">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"keypress">;
+        keys: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"drag">;
+        path: z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"wait">;
+        ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"screenshot">;
+    }, z.core.$strict>], "kind">, z.ZodTransform<{
+        kind: "click";
+        x: number;
+        y: number;
+        button?: "left" | "right" | "middle";
+    } | {
+        kind: "double_click";
+        x: number;
+        y: number;
+    } | {
+        kind: "move";
+        x: number;
+        y: number;
+    } | {
+        kind: "scroll";
+        x: number;
+        y: number;
+        dx: number;
+        dy: number;
+    } | {
+        kind: "type";
+        text: string;
+    } | {
+        kind: "keypress";
+        keys: string[];
+    } | {
+        kind: "drag";
+        path: Array<{
+            x: number;
+            y: number;
+        }>;
+    } | {
+        kind: "wait";
+        ms?: number;
+    } | {
+        kind: "screenshot";
+    }, {
+        x: number;
+        y: number;
+        kind: "click";
+        button?: "left" | "right" | "middle" | undefined;
+    } | {
+        x: number;
+        y: number;
+        kind: "double_click";
+    } | {
+        x: number;
+        y: number;
+        kind: "move";
+    } | {
+        dx: number;
+        dy: number;
+        x: number;
+        y: number;
+        kind: "scroll";
+    } | {
+        kind: "type";
+        text: string;
+    } | {
+        kind: "keypress";
+        keys: string[];
+    } | {
+        kind: "drag";
+        path: {
+            x: number;
+            y: number;
+        }[];
+    } | {
+        kind: "wait";
+        ms?: number | undefined;
+    } | {
+        kind: "screenshot";
+    }>>;
+    version: z.ZodLiteral<1>;
+    identity: z.ZodObject<{
+        generation: z.ZodString;
+        challenge: z.ZodString;
+        runtimeRevision: z.ZodString;
+    }, z.core.$strict>;
+    seq: z.ZodNumber;
+    requestId: z.ZodString;
+}, z.core.$strict>], "operation">;
+declare const replySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    observation: z.ZodOptional<z.ZodObject<{
+        png: z.ZodString;
+        stateSignature: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        scrollY: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    type: z.ZodLiteral<"reply">;
+    operation: z.ZodEnum<{
+        HELLO: "HELLO";
+        OBSERVE: "OBSERVE";
+        EXECUTE: "EXECUTE";
+    }>;
+    actionId: z.ZodOptional<z.ZodString>;
+    version: z.ZodLiteral<1>;
+    identity: z.ZodObject<{
+        generation: z.ZodString;
+        challenge: z.ZodString;
+        runtimeRevision: z.ZodString;
+    }, z.core.$strict>;
+    seq: z.ZodNumber;
+    requestId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            invalid_response: "invalid_response";
+            cancelled: "cancelled";
+            executor_closed: "executor_closed";
+            executor_not_ready: "executor_not_ready";
+            executor_busy: "executor_busy";
+            invalid_request: "invalid_request";
+            protocol_mismatch: "protocol_mismatch";
+            session_revoked: "session_revoked";
+            transport_failed: "transport_failed";
+            deadline_exceeded: "deadline_exceeded";
+            action_rejected: "action_rejected";
+            execution_failed: "execution_failed";
+        }>;
+        disposition: z.ZodEnum<{
+            not_dispatched: "not_dispatched";
+            outcome_uncertain: "outcome_uncertain";
+        }>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"reply">;
+    operation: z.ZodEnum<{
+        HELLO: "HELLO";
+        OBSERVE: "OBSERVE";
+        EXECUTE: "EXECUTE";
+    }>;
+    actionId: z.ZodOptional<z.ZodString>;
+    version: z.ZodLiteral<1>;
+    identity: z.ZodObject<{
+        generation: z.ZodString;
+        challenge: z.ZodString;
+        runtimeRevision: z.ZodString;
+    }, z.core.$strict>;
+    seq: z.ZodNumber;
+    requestId: z.ZodString;
+}, z.core.$strict>], "ok">;
+export type BrowserControlRequest = z.infer<typeof requestSchema>;
+export type BrowserControlReply = z.infer<typeof replySchema>;
+export declare function validateBrowserControlIdentity(value: unknown): BrowserControlIdentity;
+export declare function sameBrowserControlIdentity(a: BrowserControlIdentity, b: BrowserControlIdentity): boolean;
+export declare function parseBrowserControlRequest(value: unknown): BrowserControlRequest;
+export declare function parseBrowserControlReply(value: unknown): BrowserControlReply;
+export declare function validateBrowserControlAction(value: unknown): CuaAction;
+/** Check dimensions before allocating decoder output; v1 accepts browser-style 8-bit, noninterlaced PNG. */
+export declare function validateBrowserControlPng(bytes: Buffer): void;
+export declare function encodeBrowserControlObservation(observation: CuaObservation): WireObservation;
+export declare function decodeBrowserControlObservation(value: unknown): CuaObservation;
+export declare function safeBrowserControlFailure(error: unknown, dispatched: boolean): {
+    code: CuaExecutorErrorCode;
+    disposition: "not_dispatched" | "outcome_uncertain";
+};
+export {};

package/dist/browser-control-protocol.js

@@ -0,0 +1,155 @@
+import { PNG } from "pngjs";
+import { z } from "zod";
+import { CuaExecutorError, isCuaExecutorError } from "./cua-executor-error.js";
+export const BROWSER_CONTROL_VERSION = 1;
+export const BROWSER_CONTROL_LIMITS = Object.freeze({
+    frameBytes: 12 * 1024 * 1024, pngBytes: 8 * 1024 * 1024,
+    dimension: 4096, pixels: 16_000_000, textBytes: 64 * 1024,
+    chordKeys: 16, keyCharacters: 64, dragPoints: 1024, waitMs: 30_000,
+    requestTimeoutMs: 35_000, maxRequestTimeoutMs: 60_000
+});
+const token = z.string().min(1).max(128).regex(/^[A-Za-z0-9._-]+$/);
+const identitySchema = z.strictObject({ generation: token, challenge: token, runtimeRevision: token });
+const text = z.string().max(BROWSER_CONTROL_LIMITS.textBytes).refine(value => Buffer.byteLength(value) <= BROWSER_CONTROL_LIMITS.textBytes);
+const coordinate = z.number().finite().min(-1_000_000).max(1_000_000);
+const point = { x: coordinate, y: coordinate };
+export const browserControlActionSchema = z.discriminatedUnion("kind", [
+    z.strictObject({ kind: z.literal("click"), ...point, button: z.enum(["left", "right", "middle"]).optional() }),
+    z.strictObject({ kind: z.literal("double_click"), ...point }),
+    z.strictObject({ kind: z.literal("move"), ...point }),
+    z.strictObject({ kind: z.literal("scroll"), ...point, dx: coordinate, dy: coordinate }),
+    z.strictObject({ kind: z.literal("type"), text }),
+    z.strictObject({ kind: z.literal("keypress"), keys: z.array(z.string().min(1).max(BROWSER_CONTROL_LIMITS.keyCharacters)).min(1).max(BROWSER_CONTROL_LIMITS.chordKeys) }),
+    z.strictObject({ kind: z.literal("drag"), path: z.array(z.strictObject(point)).min(1).max(BROWSER_CONTROL_LIMITS.dragPoints) }),
+    z.strictObject({ kind: z.literal("wait"), ms: z.number().finite().min(0).max(BROWSER_CONTROL_LIMITS.waitMs).optional() }),
+    z.strictObject({ kind: z.literal("screenshot") })
+]).transform((action) => {
+    if (action.kind === "click")
+        return { kind: action.kind, x: action.x, y: action.y, ...(action.button !== undefined ? { button: action.button } : {}) };
+    if (action.kind === "wait")
+        return { kind: action.kind, ...(action.ms !== undefined ? { ms: action.ms } : {}) };
+    return action;
+});
+const observationSchema = z.strictObject({
+    png: z.string().min(1).max(4 * Math.ceil(BROWSER_CONTROL_LIMITS.pngBytes / 3)).regex(/^[A-Za-z0-9+/]*={0,2}$/).refine(value => value.length % 4 === 0),
+    stateSignature: text, url: text.optional(), title: text.optional(), text: text.optional(), scrollY: coordinate.optional()
+});
+const common = {
+    version: z.literal(BROWSER_CONTROL_VERSION), identity: identitySchema,
+    seq: z.number().int().min(1).max(Number.MAX_SAFE_INTEGER), requestId: token
+};
+const requestSchema = z.discriminatedUnion("operation", [
+    z.strictObject({ ...common, type: z.literal("request"), operation: z.literal("HELLO") }),
+    z.strictObject({ ...common, type: z.literal("request"), operation: z.literal("OBSERVE") }),
+    z.strictObject({ ...common, type: z.literal("request"), operation: z.literal("EXECUTE"), actionId: token, action: browserControlActionSchema })
+]);
+const errorCode = z.enum(["executor_closed", "executor_not_ready", "executor_busy", "cancelled", "invalid_request", "invalid_response", "protocol_mismatch", "session_revoked", "transport_failed", "deadline_exceeded", "action_rejected", "execution_failed"]);
+const replyBase = { ...common, type: z.literal("reply"), operation: z.enum(["HELLO", "OBSERVE", "EXECUTE"]), actionId: token.optional() };
+const replySchema = z.discriminatedUnion("ok", [
+    z.strictObject({ ...replyBase, ok: z.literal(true), observation: observationSchema.optional() }),
+    z.strictObject({ ...replyBase, ok: z.literal(false), error: z.strictObject({ code: errorCode, disposition: z.enum(["not_dispatched", "outcome_uncertain"]) }) })
+]);
+export function validateBrowserControlIdentity(value) {
+    const parsed = identitySchema.safeParse(value);
+    if (!parsed.success)
+        throw new CuaExecutorError("invalid_request", "not_dispatched");
+    return parsed.data;
+}
+export function sameBrowserControlIdentity(a, b) {
+    return a.generation === b.generation && a.challenge === b.challenge && a.runtimeRevision === b.runtimeRevision;
+}
+export function parseBrowserControlRequest(value) {
+    const parsed = requestSchema.safeParse(value);
+    if (!parsed.success)
+        throw new CuaExecutorError("invalid_request", "not_dispatched");
+    const request = parsed.data;
+    if (request.requestId !== `request-${request.seq}` || (request.operation === "EXECUTE" && request.actionId !== `action-${request.seq}`))
+        throw new CuaExecutorError("invalid_request", "not_dispatched");
+    return request;
+}
+export function parseBrowserControlReply(value) {
+    const parsed = replySchema.safeParse(value);
+    if (!parsed.success)
+        throw new CuaExecutorError("invalid_response", "outcome_uncertain");
+    const reply = parsed.data;
+    if ((reply.operation === "EXECUTE") !== (reply.actionId !== undefined)
+        || (reply.ok && (reply.operation === "OBSERVE") !== (reply.observation !== undefined)))
+        throw new CuaExecutorError("invalid_response", "outcome_uncertain");
+    return reply;
+}
+export function validateBrowserControlAction(value) {
+    const parsed = browserControlActionSchema.safeParse(value);
+    if (!parsed.success)
+        throw new CuaExecutorError("invalid_request", "not_dispatched");
+    return parsed.data;
+}
+/** Check dimensions before allocating decoder output; v1 accepts browser-style 8-bit, noninterlaced PNG. */
+export function validateBrowserControlPng(bytes) {
+    const fail = () => { throw new CuaExecutorError("invalid_response", "outcome_uncertain"); };
+    if (bytes.length < 45 || bytes.length > BROWSER_CONTROL_LIMITS.pngBytes
+        || !bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))
+        || bytes.readUInt32BE(8) !== 13 || bytes.toString("ascii", 12, 16) !== "IHDR")
+        fail();
+    const width = bytes.readUInt32BE(16), height = bytes.readUInt32BE(20);
+    if (width === 0 || height === 0 || width > BROWSER_CONTROL_LIMITS.dimension || height > BROWSER_CONTROL_LIMITS.dimension
+        || width * height > BROWSER_CONTROL_LIMITS.pixels || bytes[24] !== 8 || ![0, 2, 3, 4, 6].includes(bytes[25])
+        || bytes[26] !== 0 || bytes[27] !== 0 || bytes[28] !== 0)
+        fail();
+    // Reject trailing bytes, malformed chunk lengths, duplicate IHDR and absent image data.
+    let offset = 8, sawData = false, sawEnd = false;
+    while (offset + 12 <= bytes.length) {
+        const length = bytes.readUInt32BE(offset), kind = bytes.toString("ascii", offset + 4, offset + 8);
+        if (length > bytes.length - offset - 12 || (kind === "IHDR" && offset !== 8))
+            fail();
+        if (kind === "IDAT")
+            sawData = true;
+        offset += 12 + length;
+        if (kind === "IEND") {
+            if (length !== 0 || offset !== bytes.length)
+                fail();
+            sawEnd = true;
+            break;
+        }
+    }
+    if (!sawData || !sawEnd)
+        fail();
+    try {
+        const decoded = PNG.sync.read(bytes, { checkCRC: true });
+        if (decoded.width !== width || decoded.height !== height)
+            fail();
+    }
+    catch {
+        fail();
+    }
+}
+export function encodeBrowserControlObservation(observation) {
+    // appState has no closed browser schema in v1. Refuse rather than silently drop it.
+    if (!observation || observation.appState !== undefined || !Buffer.isBuffer(observation.screenshot))
+        throw new CuaExecutorError("invalid_response", "outcome_uncertain");
+    validateBrowserControlPng(observation.screenshot);
+    const parsed = observationSchema.safeParse({ png: observation.screenshot.toString("base64"), stateSignature: observation.stateSignature,
+        ...(observation.url !== undefined ? { url: observation.url } : {}), ...(observation.title !== undefined ? { title: observation.title } : {}),
+        ...(observation.text !== undefined ? { text: observation.text } : {}), ...(observation.scrollY !== undefined ? { scrollY: observation.scrollY } : {}) });
+    if (!parsed.success)
+        throw new CuaExecutorError("invalid_response", "outcome_uncertain");
+    return parsed.data;
+}
+export function decodeBrowserControlObservation(value) {
+    const parsed = observationSchema.safeParse(value);
+    if (!parsed.success)
+        throw new CuaExecutorError("invalid_response", "outcome_uncertain");
+    const { png, ...state } = parsed.data;
+    const screenshot = Buffer.from(png, "base64");
+    if (screenshot.toString("base64") !== png)
+        throw new CuaExecutorError("invalid_response", "outcome_uncertain");
+    validateBrowserControlPng(screenshot);
+    return { screenshot, stateSignature: state.stateSignature,
+        ...(state.url !== undefined ? { url: state.url } : {}), ...(state.title !== undefined ? { title: state.title } : {}),
+        ...(state.text !== undefined ? { text: state.text } : {}), ...(state.scrollY !== undefined ? { scrollY: state.scrollY } : {}) };
+}
+export function safeBrowserControlFailure(error, dispatched) {
+    if (isCuaExecutorError(error))
+        return { code: error.code, disposition: error.disposition };
+    return { code: "action_rejected", disposition: dispatched ? "outcome_uncertain" : "not_dispatched" };
+}
+//# sourceMappingURL=browser-control-protocol.js.map