jev-codex-cua 0.1.0

package/dist/sky/client.js

@@ -0,0 +1,274 @@
+// Adapted from manaflow-ai/pi-codex-cua (MIT). See LICENSE.pi-codex-cua.
+// Changes: bounded framing, cancellation/deadlines, fail-closed lifecycle and redacted diagnostics.
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { StringDecoder } from "node:string_decoder";
+export class SkyTimeoutError extends Error {
+    constructor(phase, timeoutMs) {
+        super(`Sky timeout after ${timeoutMs}ms during ${phase}. The connection was closed; no retry was attempted.`);
+        this.name = "SkyTimeoutError";
+    }
+}
+export function newTurnIdentity(sessionId, model, reasoningEffort) {
+    return { sessionId, threadId: sessionId, turnId: randomUUID(), startedAt: Date.now(), model, reasoningEffort };
+}
+export function requestMeta(turn) {
+    return {
+        "x-codex-turn-metadata": {
+            session_id: turn.sessionId, thread_id: turn.threadId, turn_id: turn.turnId,
+            turn_started_at_unix_ms: turn.startedAt, model: turn.model,
+            ...(turn.reasoningEffort ? { reasoning_effort: turn.reasoningEffort } : {}), sandbox: "danger-full-access",
+        },
+        "codex/plugin_id": "computer-use@openai-bundled", threadId: turn.threadId,
+    };
+}
+export function prepareArguments(args) {
+    return { ...args, ...(typeof args.element_index === "number" ? { element_index: String(args.element_index) } : {}) };
+}
+export class SkyClient {
+    child;
+    pending = new Map();
+    nextId = 1;
+    closed = false;
+    busy = false;
+    initialized = false;
+    phase = "not_started";
+    schemas = new Map();
+    approvalHandler;
+    callSignal;
+    pauseDeadline;
+    resumeDeadline;
+    approvalRequested = false;
+    buffer = "";
+    decoder = new StringDecoder("utf8");
+    runtime;
+    timeoutMs;
+    constructor(runtime, timeoutMs = 30_000) {
+        this.runtime = runtime;
+        this.timeoutMs = timeoutMs;
+    }
+    async callSky(method, args, turn, signal, approve) {
+        if (this.closed)
+            throw new Error("Sky connection closed. Start a new task and observe before acting.");
+        if (this.busy)
+            throw new Error("Sky connection is busy; concurrent CU calls are not supported.");
+        signal?.throwIfAborted();
+        this.busy = true;
+        const controller = new AbortController();
+        let remainingMs = this.timeoutMs;
+        let timer;
+        let armedAt = 0;
+        this.pauseDeadline = () => {
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+                remainingMs -= performance.now() - armedAt;
+            }
+        };
+        this.resumeDeadline = () => {
+            if (timer || this.closed)
+                return;
+            armedAt = performance.now();
+            timer = setTimeout(() => controller.abort(new SkyTimeoutError(this.phase, this.timeoutMs)), Math.max(0, remainingMs));
+        };
+        this.resumeDeadline();
+        const combined = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
+        this.callSignal = combined;
+        this.approvalHandler = approve;
+        this.approvalRequested = false;
+        try {
+            if (!this.initialized)
+                await this.start(combined);
+            combined.throwIfAborted();
+            const schema = this.schemas.get(method);
+            if (!schema)
+                throw new Error(`Sky does not advertise tool ${method}.`);
+            const prepared = prepareArguments(args);
+            // Some Sky versions expose disableDiff at a higher-level JS layer only.
+            // Never send unsupported options through the strict native MCP interface.
+            if (method === "get_app_state" && !Object.hasOwn(schema.inputSchema?.properties ?? {}, "disableDiff"))
+                delete prepared.disableDiff;
+            if (method === "select_text" && prepared.selection_type !== undefined
+                && !Object.hasOwn(schema.inputSchema?.properties ?? {}, "selection_type") && Object.hasOwn(schema.inputSchema?.properties ?? {}, "selection")) {
+                prepared.selection = prepared.selection_type;
+                delete prepared.selection_type;
+            }
+            if (schema.inputSchema?.additionalProperties === false) {
+                const unexpected = Object.keys(prepared).filter((key) => !Object.hasOwn(schema.inputSchema?.properties ?? {}, key));
+                if (unexpected.length)
+                    throw new Error(`Unsupported Sky arguments for ${method}: ${unexpected.join(", ")}`);
+            }
+            this.phase = method;
+            return await this.request("tools/call", { name: method, arguments: prepared, _meta: requestMeta(turn) }, combined);
+        }
+        catch (error) {
+            this.close();
+            if (controller.signal.aborted && !signal?.aborted)
+                throw controller.signal.reason;
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            this.approvalHandler = undefined;
+            this.callSignal = undefined;
+            this.pauseDeadline = undefined;
+            this.resumeDeadline = undefined;
+            this.busy = false;
+        }
+    }
+    async start(signal) {
+        signal.throwIfAborted();
+        const env = { ...process.env };
+        // The desktop bridge has no need for the Jev credential.
+        delete env.TYPESAFE_API_KEY;
+        // This is the first-party signed process chain used upstream, not a permission bypass.
+        const child = spawn(this.runtime.codexCliPath, [
+            "sandbox", "-P", ":danger-full-access", "--allow-unix-socket", this.runtime.socketDirectory,
+            this.runtime.clientPath, "mcp",
+        ], { stdio: ["pipe", "pipe", "pipe"], cwd: this.runtime.cwd, env });
+        this.child = child;
+        child.stdout.on("data", (chunk) => {
+            this.buffer += this.decoder.write(chunk);
+            if (Buffer.byteLength(this.buffer) > 64 * 1024 * 1024) {
+                this.fail(new Error("Sky response exceeded 64 MiB."));
+                return;
+            }
+            let newline;
+            while ((newline = this.buffer.indexOf("\n")) !== -1) {
+                const line = this.buffer.slice(0, newline);
+                this.buffer = this.buffer.slice(newline + 1);
+                this.onLine(line);
+            }
+        });
+        // Drain diagnostics without retaining or echoing possibly sensitive app content.
+        child.stderr.resume();
+        child.stdin.on("error", () => this.fail(new Error("Sky input pipe failed.")));
+        child.stdout.on("error", () => this.fail(new Error("Sky output pipe failed.")));
+        child.once("error", () => this.fail(new Error("Sky process failed to launch.")));
+        child.once("exit", () => this.fail(new Error("Sky process exited. Outcome may be unknown; do not replay actions.")));
+        this.phase = "initialize";
+        await this.request("initialize", {
+            protocolVersion: "2025-06-18", capabilities: { elicitation: {} }, clientInfo: { name: "jev-codex-cua", version: "0.1.0" },
+        }, signal);
+        signal.throwIfAborted();
+        this.write({ jsonrpc: "2.0", method: "notifications/initialized", params: {} });
+        this.phase = "tools/list";
+        const discovery = await this.request("tools/list", {}, signal);
+        if (!Array.isArray(discovery.tools) || discovery.tools.some((tool) => !tool || typeof tool.name !== "string"))
+            throw new Error("Sky returned an invalid tool catalog.");
+        this.schemas = new Map(discovery.tools.map((tool) => [tool.name, tool]));
+        this.initialized = true;
+    }
+    onLine(line) {
+        let message;
+        try {
+            const value = JSON.parse(line);
+            if (!value || typeof value !== "object" || Array.isArray(value))
+                throw new Error("bad frame");
+            message = value;
+        }
+        catch {
+            this.fail(new Error("Invalid Sky protocol frame."));
+            return;
+        }
+        // Server-initiated JSON-RPC requests may use STRING IDs, independent of our numeric IDs.
+        if (typeof message.method === "string" && (typeof message.id === "string" || typeof message.id === "number")) {
+            void this.onServerRequest(message.id, message.method, message.params);
+            return;
+        }
+        if (typeof message.id !== "number")
+            return;
+        const pending = this.pending.get(message.id);
+        if (pending && ("result" in message || "error" in message)) {
+            this.pending.delete(message.id);
+            if (message.error) {
+                const error = message.error;
+                pending.reject(new Error(`Sky RPC error ${typeof error.code === "number" ? error.code : "unknown"}. Check desktop permissions and runtime compatibility.`));
+            }
+            else if (message.result && typeof message.result === "object" && !Array.isArray(message.result)) {
+                pending.resolve(message.result);
+            }
+            else {
+                pending.reject(new Error("Invalid Sky RPC response."));
+            }
+        }
+    }
+    async onServerRequest(id, method, params) {
+        if (method !== "elicitation/create") {
+            this.write({ jsonrpc: "2.0", id, error: { code: -32601, message: "Unsupported client method" } });
+            return;
+        }
+        const request = params;
+        const schema = request?.requestedSchema;
+        // We support confirmation only: never collect credentials, fill arbitrary forms or open URLs.
+        const emptyObject = schema?.type === "object" && schema.properties != null && typeof schema.properties === "object"
+            && !Array.isArray(schema.properties) && Object.keys(schema.properties).length === 0
+            && (schema.required === undefined || (Array.isArray(schema.required) && schema.required.length === 0));
+        const valid = request && typeof request.message === "string" && request.message.length > 0 && request.message.length <= 4000
+            && (request.mode === undefined || request.mode === "form") && emptyObject;
+        const signal = this.callSignal;
+        if (!valid || !signal || signal.aborted || !this.approvalHandler || this.approvalRequested) {
+            this.write({ jsonrpc: "2.0", id, result: { action: "decline" } });
+            return;
+        }
+        this.approvalRequested = true;
+        this.pauseDeadline?.();
+        try {
+            const accepted = await this.approvalHandler(request.message, signal);
+            this.write({ jsonrpc: "2.0", id, result: signal.aborted ? { action: "cancel" } : accepted === true ? { action: "accept", content: {} } : { action: "decline" } });
+        }
+        catch {
+            this.write({ jsonrpc: "2.0", id, result: { action: "cancel" } });
+        }
+        finally {
+            this.resumeDeadline?.();
+        }
+    }
+    request(method, params, signal) {
+        signal.throwIfAborted();
+        if (!this.child || this.closed)
+            return Promise.reject(new Error("Sky is not running."));
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                this.pending.delete(id);
+                signal.removeEventListener("abort", abort);
+                this.write({ jsonrpc: "2.0", method: "notifications/cancelled", params: { requestId: id, reason: "Task cancelled" } });
+                reject(signal.reason instanceof SkyTimeoutError ? signal.reason : new Error(`Sky call cancelled by caller during ${this.phase}; no retry was attempted.`));
+                this.close();
+            };
+            this.pending.set(id, {
+                resolve: (value) => { signal.removeEventListener("abort", abort); resolve(value); },
+                reject: (error) => { signal.removeEventListener("abort", abort); reject(error); },
+            });
+            signal.addEventListener("abort", abort, { once: true });
+            if (signal.aborted) {
+                abort();
+                return;
+            }
+            this.write({ jsonrpc: "2.0", id, method, params });
+        });
+    }
+    write(message) {
+        if (!this.closed)
+            this.child?.stdin.write(JSON.stringify(message) + "\n");
+    }
+    fail(error) {
+        for (const pending of this.pending.values())
+            pending.reject(error);
+        this.pending.clear();
+        this.close();
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const pending of this.pending.values())
+            pending.reject(new Error("Sky connection closed; pending outcome may be unknown."));
+        this.pending.clear();
+        this.child?.kill("SIGKILL");
+        this.child = undefined;
+        this.buffer = "";
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/sky/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/sky/client.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,oGAAoG;AACpG,OAAO,EAAE,KAAK,EAAuC,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,KAAa,EAAE,SAAiB;QAC1C,KAAK,CAAC,qBAAqB,SAAS,aAAa,KAAK,sDAAsD,CAAC,CAAC;QAC9G,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAID,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,KAAa,EAAE,eAAwB;IACxF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;AACjH,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,OAAO;QACL,uBAAuB,EAAE;YACvB,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM;YAC1E,uBAAuB,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK;YAC1D,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,oBAAoB;SAC3G;QACD,iBAAiB,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ;KAC1E,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvH,CAAC;AAGD,MAAM,OAAO,SAAS;IACZ,KAAK,CAAkC;IACvC,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrC,MAAM,GAAG,CAAC,CAAC;IACX,MAAM,GAAG,KAAK,CAAC;IACf,IAAI,GAAG,KAAK,CAAC;IACb,WAAW,GAAG,KAAK,CAAC;IACpB,KAAK,GAAG,aAAa,CAAC;IACtB,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,eAAe,CAAsB;IACrC,UAAU,CAAe;IACzB,aAAa,CAAc;IAC3B,cAAc,CAAc;IAC5B,iBAAiB,GAAG,KAAK,CAAC;IAC1B,MAAM,GAAG,EAAE,CAAC;IACH,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO,CAAa;IACpB,SAAS,CAAS;IACnC,YAAY,OAAmB,EAAE,SAAS,GAAG,MAAM;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,IAA6B,EAAE,IAAkB,EAAE,MAAoB,EAAE,OAA4B;QACjI,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACvG,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACjG,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,KAAgD,CAAC;QACrD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE;YACxB,IAAI,KAAK,EAAE,CAAC;gBAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAAC,KAAK,GAAG,SAAS,CAAC;gBAAC,WAAW,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;YAAC,CAAC;QACpG,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,GAAG,EAAE;YACzB,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACjC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC5B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QACxH,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QAC3F,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QAC/B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClD,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,GAAG,CAAC,CAAC;YACvE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACxC,wEAAwE;YACxE,0EAA0E;YAC1E,IAAI,MAAM,KAAK,eAAe,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE,EAAE,aAAa,CAAC;gBAAE,OAAO,QAAQ,CAAC,WAAW,CAAC;YACnI,IAAI,MAAM,KAAK,aAAa,IAAI,QAAQ,CAAC,cAAc,KAAK,SAAS;mBAC9D,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC;gBAClJ,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC;gBAC7C,OAAO,QAAQ,CAAC,cAAc,CAAC;YACjC,CAAC;YACD,IAAI,MAAM,CAAC,WAAW,EAAE,oBAAoB,KAAK,KAAK,EAAE,CAAC;gBACvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;gBACpH,IAAI,UAAU,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9G,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;YAClF,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC9D,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAAC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,MAAmB;QACrC,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,yDAAyD;QACzD,OAAO,GAAG,CAAC,gBAAgB,CAAC;QAC5B,uFAAuF;QACvF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;YAC7C,SAAS,EAAE,IAAI,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe;YAC3F,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK;SAC/B,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACzH,IAAI,OAAe,CAAC;YACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,iFAAiF;QACjF,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;QAC9E,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC,CAAC,CAAC;QACrH,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;YAC/B,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;SAC1H,EAAE,MAAM,CAAC,CAAC;QACX,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,MAAM,CAAoB,CAAC;QAClF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACxK,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,IAAI,OAAgC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;YAC9F,OAAO,GAAG,KAAgC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACxE,yFAAyF;QACzF,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC7G,KAAK,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,OAAO,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,OAAO,CAAC,KAA2B,CAAC;gBAClD,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,wDAAwD,CAAC,CAAC,CAAC;YAC9J,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAmB,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;YAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,EAAmB,EAAE,MAAc,EAAE,MAAe;QAChF,IAAI,MAAM,KAAK,oBAAoB,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAAE,CAAC,CAAC;YAClG,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAsI,CAAC;QACvJ,MAAM,MAAM,GAAG,OAAO,EAAE,eAAe,CAAC;QACxC,8FAA8F;QAC9F,MAAM,WAAW,GAAG,MAAM,EAAE,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;eAC9G,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;eAChF,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;QACzG,MAAM,KAAK,GAAG,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI;eACvH,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3F,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAiB,EAAE,MAAM,CAAC,CAAC;YAC/E,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACpK,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAAC,CAAC;IACxC,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,MAA+B,EAAE,MAAmB;QAClF,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACxF,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC3C,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBACvH,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,KAAK,2BAA2B,CAAC,CAAC,CAAC;gBAC3J,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnF,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAClF,CAAC,CAAC;YACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAAC,KAAK,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IACO,KAAK,CAAC,OAAgB;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5E,CAAC;IACO,IAAI,CAAC,KAAY;QACvB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IACD,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC,CAAC;QACjI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/sky/runtime.d.ts

@@ -0,0 +1,7 @@
+export interface SkyRuntime {
+    clientPath: string;
+    codexCliPath: string;
+    socketDirectory: string;
+    cwd: string;
+}
+export declare function resolveSkyRuntime(env?: NodeJS.ProcessEnv, home?: string): SkyRuntime;

package/dist/sky/runtime.js

@@ -0,0 +1,32 @@
+// Adapted from manaflow-ai/pi-codex-cua (MIT). See LICENSE.pi-codex-cua.
+import { accessSync, constants } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function accessible(path, mode = constants.R_OK) {
+    try {
+        accessSync(path, mode);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveSkyRuntime(env = process.env, home = homedir()) {
+    if (process.platform !== "darwin")
+        throw new Error("Sky Computer Use requires macOS.");
+    const service = env.PI_CODEX_CUA_SERVICE ?? join(home, ".codex/computer-use/Codex Computer Use.app");
+    const clientPath = env.PI_CODEX_CUA_CLIENT ?? join(service, "Contents/SharedSupport/SkyComputerUseClient.app/Contents/MacOS/SkyComputerUseClient");
+    const codexCliPath = env.PI_CODEX_CUA_CODEX ?? join(env.PI_CODEX_CUA_RESOURCES ?? "/Applications/ChatGPT.app/Contents/Resources", "codex");
+    const socketDirectory = env.PI_CODEX_CUA_SOCKET_DIRECTORY ?? join(home, "Library/Group Containers/2DC432GLL2.com.openai.sky.CUAService/IPC");
+    const cwd = env.CODEX_HOME ?? join(home, ".codex/computer-use");
+    const missing = [
+        !accessible(clientPath, constants.X_OK) && "SkyComputerUseClient",
+        !accessible(codexCliPath, constants.X_OK) && "Codex CLI",
+        !accessible(socketDirectory) && "Computer Use IPC directory",
+        !accessible(cwd) && "Computer Use working directory",
+    ].filter(Boolean);
+    if (missing.length)
+        throw new Error(`Codex Computer Use runtime unavailable: ${missing.join(", ")}. Install/update the official desktop runtime and grant its permissions.`);
+    return { clientPath, codexCliPath, socketDirectory, cwd };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/sky/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/sky/runtime.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,SAAS,UAAU,CAAC,IAAY,EAAE,IAAI,GAAG,SAAS,CAAC,IAAI;IACrD,IAAI,CAAC;QAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACtE,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,EAAE;IACtF,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,IAAI,EAAE,4CAA4C,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,OAAO,EAAE,qFAAqF,CAAC,CAAC;IACnJ,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,GAAG,CAAC,sBAAsB,IAAI,8CAA8C,EAAE,OAAO,CAAC,CAAC;IAC3I,MAAM,eAAe,GAAG,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC,IAAI,EAAE,mEAAmE,CAAC,CAAC;IAC7I,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG;QACd,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,sBAAsB;QACjE,CAAC,UAAU,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,WAAW;QACxD,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,4BAA4B;QAC5D,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,gCAAgC;KACrD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IAC7K,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC;AAC5D,CAAC"}

package/dist/sky-driver.d.ts

@@ -0,0 +1,7 @@
+import type { Driver } from "./types.ts";
+import type { SkyResult, TurnIdentity, SkyApprovalHandler } from "./sky/client.ts";
+export interface SkyCaller {
+    callSky(method: string, args: Record<string, unknown>, turn: TurnIdentity, signal?: AbortSignal, approve?: SkyApprovalHandler): Promise<SkyResult>;
+}
+export declare function skyText(result: SkyResult): string;
+export declare function createSkyDriver(client: SkyCaller, turn: TurnIdentity, signal?: AbortSignal, approve?: SkyApprovalHandler): Driver;

package/dist/sky-driver.js

@@ -0,0 +1,42 @@
+import { parseAX } from "./ax.js";
+export function skyText(result) {
+    if (result.isError)
+        throw new Error("Sky reported an error; check app approval, permissions, screen lock and runtime compatibility.");
+    if (!Array.isArray(result.content))
+        throw new Error("Sky did not return content.");
+    const text = result.content.filter((item) => item.type === "text" && typeof item.text === "string").map((item) => item.type === "text" ? item.text : "").join("\n");
+    if (!text.trim())
+        throw new Error("Sky did not return AX text.");
+    if (Buffer.byteLength(text) > 1024 * 1024)
+        throw new Error("AX text exceeds 1 MiB; use a smaller window.");
+    // With native runtimes that omit disableDiff, never assume a partial update is a full tree.
+    if (!parseAX(text).some((element) => element.role === "standard window")) {
+        throw new Error("Sky did not return a recognizable full AX window tree; no decision or action is safe. Partial updates are not supported.");
+    }
+    return text;
+}
+export function createSkyDriver(client, turn, signal, approve) {
+    let app;
+    const call = async (method, args) => {
+        signal?.throwIfAborted();
+        if (!app)
+            throw new Error("Bind an app before using Sky.");
+        const result = await client.callSky(method, { app, ...args }, turn, signal, approve);
+        if (result.isError)
+            throw new Error("Sky action failed; do not replay it without fresh observation.");
+        return result;
+    };
+    return {
+        async bind(name) { signal?.throwIfAborted(); app = name; },
+        async observe() { return skyText(await call("get_app_state", { disableDiff: true })); },
+        async click(index) { return call("click", { element_index: index }); },
+        async setValue(index, value) { return call("set_value", { element_index: index, value }); },
+        async typeText(text) { return call("type_text", { text }); },
+        async pressKey(key) {
+            const canonical = { tab: "Tab", "shift+tab": "Shift_L+Tab", escape: "Escape", left: "Left", right: "Right", up: "Up", down: "Down", home: "Home", end: "End", pageup: "Page_Up", pagedown: "Page_Down" };
+            return call("press_key", { key: canonical[key.toLowerCase()] ?? key });
+        },
+        async scroll(index, direction, pages) { return call("scroll", { element_index: index, direction, pages }); },
+    };
+}
+//# sourceMappingURL=sky-driver.js.map

package/dist/sky-driver.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,33 @@
+export type TraceMode = "metadata" | "full";
+export interface TraceEvent {
+    event: "start" | "decision" | "action" | "finish";
+    step?: number;
+    action?: string | null;
+    index?: number | null;
+    confidence?: number | null;
+    risk?: number | null;
+    done?: number | null;
+    latencyMs?: number;
+    status?: string;
+    reason?: string;
+    changed?: boolean;
+    elapsedMs?: number;
+    candidateCount?: number;
+}
+export interface FullTraceEvent {
+    event: "task" | "snapshot" | "decision_input" | "decision_output" | "jev" | "action_prepared" | "gate" | "dispatch_start" | "dispatch_return" | "verification" | "failure" | "outcome";
+    step?: number;
+    [key: string]: unknown;
+}
+export interface TraceOptions {
+    mode?: TraceMode;
+    secrets?: readonly string[];
+    maxBytes?: number;
+}
+export declare function createTrace(directory?: string, options?: TraceOptions): {
+    path: string | undefined;
+    readonly incomplete: boolean;
+    record(event: TraceEvent): void;
+    full(event: FullTraceEvent): void;
+    close(): void;
+};

package/dist/trace.js

@@ -0,0 +1,77 @@
+import { closeSync, constants, lstatSync, mkdirSync, openSync, writeSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { join } from "node:path";
+export function createTrace(directory, options = {}) {
+    const mode = options.mode ?? "metadata";
+    if (mode === "full" && !directory)
+        throw new Error("Full tracing requires an explicit local directory.");
+    const runId = randomUUID();
+    let path;
+    let fd;
+    if (directory) {
+        mkdirSync(directory, { recursive: true, mode: 0o700 });
+        if (mode === "full") {
+            const info = lstatSync(directory);
+            if (!info.isDirectory() || info.isSymbolicLink() || (info.mode & 0o077) !== 0 || (process.getuid && info.uid !== process.getuid())) {
+                throw new Error("Full trace directory must be an owner-only directory (700), not a symlink.");
+            }
+        }
+        path = join(directory, `${runId}.jsonl`);
+        fd = openSync(path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_APPEND | constants.O_NOFOLLOW, 0o600);
+    }
+    let sequence = 0;
+    let bytes = 0;
+    let failed = false;
+    const started = performance.now();
+    const maxBytes = options.maxBytes ?? 64 * 1024 * 1024;
+    // Redact the credential after JSON serialization too (including escaped forms).
+    // Do not serialize process.env, provider headers or the JevOptions object.
+    const secrets = [...new Set((options.secrets ?? []).filter(Boolean).map((secret) => JSON.stringify(secret).slice(1, -1)))].sort((a, b) => b.length - a.length);
+    function append(event) {
+        if (fd === undefined)
+            return;
+        if (failed)
+            throw new Error("Trace is incomplete; no further desktop actions may be dispatched.");
+        try {
+            let line = JSON.stringify({ ...event, schemaVersion: 1, runId, mode, seq: ++sequence,
+                ts: new Date().toISOString(), sinceStartMs: Math.round(performance.now() - started) });
+            for (const secret of secrets)
+                line = line.replaceAll(secret, "[REDACTED]");
+            const buffer = Buffer.from(line + "\n");
+            if (bytes + buffer.length > maxBytes)
+                throw new Error("Trace exceeded its 64 MiB budget; task stopped instead of silently dropping events.");
+            let written = 0;
+            while (written < buffer.length) {
+                const count = writeSync(fd, buffer, written, buffer.length - written);
+                if (count === 0)
+                    throw new Error("Trace write made no progress.");
+                written += count;
+            }
+            bytes += buffer.length;
+        }
+        catch (error) {
+            failed = true;
+            throw error;
+        }
+    }
+    return {
+        path,
+        get incomplete() { return failed; },
+        record(event) { append(event); },
+        full(event) { if (mode === "full")
+            append(event); },
+        close() {
+            if (fd !== undefined) {
+                const previous = fd;
+                fd = undefined;
+                try {
+                    closeSync(previous);
+                }
+                catch {
+                    failed = true;
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+export interface AXElement {
+    index: number;
+    role: string;
+    label: string;
+    depth: number;
+    raw: string;
+}
+export interface Candidate extends AXElement {
+    score: number;
+}
+export declare const ACTIONS: readonly ["click_element", "click_at", "drag", "set_value", "type_text", "press_key", "scroll", "wait", "ask_user"];
+export type ActionKind = typeof ACTIONS[number];
+export interface Decision {
+    action: ActionKind | null;
+    targetIndex: number | null;
+    confidence: number | null;
+    risk: number | null;
+    done: number | null;
+    latencyMs?: number;
+    usage?: Record<string, unknown>;
+}
+export interface DecisionInput {
+    goal: string;
+    app: string;
+    candidates: readonly AXElement[];
+    context: string;
+    recentActions: readonly string[];
+    constraints: string;
+}
+export type Decider = (input: DecisionInput) => Promise<Decision>;
+export type Direction = "up" | "down" | "left" | "right";
+export type Point = readonly [number, number];
+export interface Resources {
+    text?: string;
+    key?: string;
+    direction?: Direction;
+    at?: Point;
+    from?: Point;
+    to?: Point;
+}
+export type PreparedAction = {
+    kind: "click_element";
+    index: number;
+} | {
+    kind: "set_value" | "type_text";
+    index: number;
+    text: string;
+} | {
+    kind: "press_key";
+    index: number;
+    key: string;
+} | {
+    kind: "scroll";
+    index: number;
+    direction: Direction;
+} | {
+    kind: "click_at";
+    at: Point;
+} | {
+    kind: "drag";
+    from: Point;
+    to: Point;
+} | {
+    kind: "wait";
+} | {
+    kind: "ask_user";
+};
+export interface Driver {
+    bind(appName: string): Promise<unknown>;
+    observe(): Promise<string>;
+    click?(index: number): Promise<unknown>;
+    setValue?(index: number, value: string): Promise<unknown>;
+    typeText?(text: string): Promise<unknown>;
+    pressKey?(key: string): Promise<unknown>;
+    scroll?(index: number, direction: Direction, pages: number): Promise<unknown>;
+}
+export type Verdict = "proceed" | "confirm" | "escalate" | "stop" | "model_done";
+export interface Gate {
+    verdict: Verdict;
+    reason: string;
+}
+export type Status = Exclude<Verdict, "proceed"> | "done" | "dry_run" | "max_steps" | "error" | "needs_planner";
+export interface TaskResult {
+    status: Status;
+    steps: number;
+    verified: boolean;
+    elapsedMs: number;
+    reason: string;
+    planned?: PreparedAction;
+    target?: {
+        role: string;
+        label: string;
+    };
+    decision?: Decision;
+    tracePath?: string;
+    traceIncomplete?: boolean;
+    outcomeUnknown?: boolean;
+    handoff?: {
+        appName: string;
+        goal: string;
+        remainingSteps: number;
+        context: string;
+        recentActions: string[];
+        candidates: {
+            index: number;
+            role: string;
+            label: string;
+        }[];
+        candidatesTruncated: boolean;
+        instruction: string;
+    };
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const ACTIONS = ["click_element", "click_at", "drag", "set_value", "type_text", "press_key", "scroll", "wait", "ask_user"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC"}