frely-cli 0.9.5 → 0.9.7

package/dist/computer/image.d.ts

@@ -0,0 +1,22 @@
+/** Long edge cap for screenshots sent to the model (plan computer-use D6); keeps a frame far below the 8 MiB relay limit. */
+export declare const SCREENSHOT_MAX_EDGE = 1280;
+export interface ScaledPng {
+    data: Buffer;
+    width: number;
+    height: number; /** original / scaled; multiply model coordinates by this to get device pixels. */
+    scale: number;
+}
+/** Returns null when the PNG is not a plain 8-bit non-interlaced grey/RGB(A) image (caller then passes it through or rejects it by size). */
+export declare function downscalePng(png: Buffer, maxEdge?: number): ScaledPng | null;
+export declare function pngSize(png: Buffer): {
+    width: number;
+    height: number;
+} | null;
+/** Encode raw 8-bit RGBA pixels as a PNG (used by tests and fixtures). */
+export declare function encodeRgbaPng(width: number, height: number, rgba: Buffer): Buffer;
+export declare function decodePngPixels(png: Buffer): {
+    width: number;
+    height: number;
+    channels: number;
+    data: Buffer;
+} | null;

package/dist/computer/image.js

@@ -0,0 +1,183 @@
+import { deflateSync, inflateSync } from "node:zlib";
+/** Long edge cap for screenshots sent to the model (plan computer-use D6); keeps a frame far below the 8 MiB relay limit. */
+export const SCREENSHOT_MAX_EDGE = 1280;
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/** Returns null when the PNG is not a plain 8-bit non-interlaced grey/RGB(A) image (caller then passes it through or rejects it by size). */
+export function downscalePng(png, maxEdge = SCREENSHOT_MAX_EDGE) {
+    const raster = decodePng(png);
+    if (!raster)
+        return null;
+    const longEdge = Math.max(raster.width, raster.height);
+    if (longEdge <= maxEdge)
+        return { data: png, width: raster.width, height: raster.height, scale: 1 };
+    const ratio = maxEdge / longEdge;
+    const width = Math.max(1, Math.round(raster.width * ratio));
+    const height = Math.max(1, Math.round(raster.height * ratio));
+    return { data: encodePng(resize(raster, width, height)), width, height, scale: raster.width / width };
+}
+export function pngSize(png) {
+    if (png.length < 24 || !png.subarray(0, 8).equals(PNG_SIGNATURE))
+        return null;
+    return { width: png.readUInt32BE(16), height: png.readUInt32BE(20) };
+}
+function decodePng(png) {
+    if (png.length < 33 || !png.subarray(0, 8).equals(PNG_SIGNATURE))
+        return null;
+    let offset = 8;
+    let width = 0;
+    let height = 0;
+    let bitDepth = 0;
+    let colorType = -1;
+    let interlace = 0;
+    const idat = [];
+    while (offset + 8 <= png.length) {
+        const length = png.readUInt32BE(offset);
+        const type = png.toString("latin1", offset + 4, offset + 8);
+        const body = png.subarray(offset + 8, offset + 8 + length);
+        if (body.length !== length)
+            return null;
+        if (type === "IHDR") {
+            width = body.readUInt32BE(0);
+            height = body.readUInt32BE(4);
+            bitDepth = body[8];
+            colorType = body[9];
+            interlace = body[12];
+        }
+        else if (type === "IDAT")
+            idat.push(body);
+        else if (type === "IEND")
+            break;
+        offset += 12 + length;
+    }
+    const channels = { 0: 1, 2: 3, 4: 2, 6: 4 }[colorType];
+    if (!channels || bitDepth !== 8 || interlace !== 0 || width === 0 || height === 0 || width * height > 64_000_000)
+        return null;
+    let raw;
+    try {
+        raw = inflateSync(Buffer.concat(idat));
+    }
+    catch {
+        return null;
+    }
+    const stride = width * channels;
+    if (raw.length !== (stride + 1) * height)
+        return null;
+    const out = Buffer.alloc(stride * height);
+    for (let y = 0; y < height; y += 1) {
+        const filter = raw[y * (stride + 1)];
+        const src = raw.subarray(y * (stride + 1) + 1, (y + 1) * (stride + 1));
+        const row = out.subarray(y * stride, (y + 1) * stride);
+        const prev = y > 0 ? out.subarray((y - 1) * stride, y * stride) : null;
+        for (let x = 0; x < stride; x += 1) {
+            const a = x >= channels ? row[x - channels] : 0;
+            const b = prev ? prev[x] : 0;
+            const c = prev && x >= channels ? prev[x - channels] : 0;
+            let value;
+            switch (filter) {
+                case 0:
+                    value = src[x];
+                    break;
+                case 1:
+                    value = src[x] + a;
+                    break;
+                case 2:
+                    value = src[x] + b;
+                    break;
+                case 3:
+                    value = src[x] + ((a + b) >> 1);
+                    break;
+                case 4:
+                    value = src[x] + paeth(a, b, c);
+                    break;
+                default: return null;
+            }
+            row[x] = value & 0xff;
+        }
+    }
+    return { width, height, channels, data: out };
+}
+function paeth(a, b, c) {
+    const p = a + b - c;
+    const pa = Math.abs(p - a);
+    const pb = Math.abs(p - b);
+    const pc = Math.abs(p - c);
+    return pa <= pb && pa <= pc ? a : pb <= pc ? b : c;
+}
+/** Area-average resize: each target pixel averages the source box it covers. */
+function resize(source, width, height) {
+    const { channels } = source;
+    const out = Buffer.alloc(width * height * channels);
+    const xRatio = source.width / width;
+    const yRatio = source.height / height;
+    for (let y = 0; y < height; y += 1) {
+        const y0 = Math.floor(y * yRatio);
+        const y1 = Math.min(source.height, Math.max(y0 + 1, Math.ceil((y + 1) * yRatio)));
+        for (let x = 0; x < width; x += 1) {
+            const x0 = Math.floor(x * xRatio);
+            const x1 = Math.min(source.width, Math.max(x0 + 1, Math.ceil((x + 1) * xRatio)));
+            const count = (y1 - y0) * (x1 - x0);
+            for (let channel = 0; channel < channels; channel += 1) {
+                let sum = 0;
+                for (let sy = y0; sy < y1; sy += 1) {
+                    let index = (sy * source.width + x0) * channels + channel;
+                    for (let sx = x0; sx < x1; sx += 1, index += channels)
+                        sum += source.data[index];
+                }
+                out[(y * width + x) * channels + channel] = Math.round(sum / count);
+            }
+        }
+    }
+    return { width, height, channels, data: out };
+}
+function encodePng(raster) {
+    const { width, height, channels } = raster;
+    const stride = width * channels;
+    const raw = Buffer.alloc((stride + 1) * height);
+    for (let y = 0; y < height; y += 1) {
+        const base = y * (stride + 1);
+        raw[base] = 1; // Sub filter compresses UI screenshots noticeably better than None.
+        for (let x = 0; x < stride; x += 1) {
+            const left = x >= channels ? raster.data[y * stride + x - channels] : 0;
+            raw[base + 1 + x] = (raster.data[y * stride + x] - left) & 0xff;
+        }
+    }
+    const colorType = { 1: 0, 2: 4, 3: 2, 4: 6 }[channels];
+    const header = Buffer.alloc(13);
+    header.writeUInt32BE(width, 0);
+    header.writeUInt32BE(height, 4);
+    header[8] = 8;
+    header[9] = colorType;
+    return Buffer.concat([PNG_SIGNATURE, chunk("IHDR", header), chunk("IDAT", deflateSync(raw, { level: 6 })), chunk("IEND", Buffer.alloc(0))]);
+}
+function chunk(type, body) {
+    const head = Buffer.alloc(8);
+    head.writeUInt32BE(body.length, 0);
+    head.write(type, 4, "latin1");
+    const crc = Buffer.alloc(4);
+    crc.writeUInt32BE(crc32(Buffer.concat([head.subarray(4), body])), 0);
+    return Buffer.concat([head, body, crc]);
+}
+let crcTable;
+function crc32(data) {
+    if (!crcTable) {
+        crcTable = new Uint32Array(256);
+        for (let n = 0; n < 256; n += 1) {
+            let c = n;
+            for (let k = 0; k < 8; k += 1)
+                c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+            crcTable[n] = c >>> 0;
+        }
+    }
+    let crc = 0xffffffff;
+    for (const byte of data)
+        crc = crcTable[(crc ^ byte) & 0xff] ^ (crc >>> 8);
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Encode raw 8-bit RGBA pixels as a PNG (used by tests and fixtures). */
+export function encodeRgbaPng(width, height, rgba) {
+    return encodePng({ width, height, channels: 4, data: rgba });
+}
+export function decodePngPixels(png) {
+    return decodePng(png);
+}
+//# sourceMappingURL=image.js.map

package/dist/computer/image.js.map

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

package/dist/computer/ocu.d.ts

@@ -0,0 +1,40 @@
+/** Pinned open-computer-use release the CLI is built and tested against (plan computer-use D1/D7). */
+export declare const OCU_VERSION = "0.3.6";
+export interface OcuTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}
+export interface OcuContent {
+    type: string;
+    text?: string;
+    data?: string;
+    mimeType?: string;
+    [key: string]: unknown;
+}
+export interface OcuResult {
+    content: OcuContent[];
+    isError?: boolean;
+}
+/** The part of the open-computer-use MCP server the toolset depends on; tests substitute a fake. */
+export interface OcuBackend {
+    listTools(): Promise<OcuTool[]>;
+    callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<OcuResult>;
+    close(): Promise<void>;
+}
+export declare function ocuBinaryPath(): string;
+export declare class OcuNotInstalledError extends Error {
+    constructor(path: string);
+}
+/** Lazily started stdio client for the open-computer-use binary; restarts on the next call after it dies. */
+export declare class StdioOcuBackend implements OcuBackend {
+    private readonly binary;
+    private client;
+    private starting;
+    constructor(binary?: string);
+    private connect;
+    listTools(): Promise<OcuTool[]>;
+    callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<OcuResult>;
+    close(): Promise<void>;
+}

package/dist/computer/ocu.js

@@ -0,0 +1,59 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { computerDir } from "./state.js";
+/** Pinned open-computer-use release the CLI is built and tested against (plan computer-use D1/D7). */
+export const OCU_VERSION = "0.3.6";
+export function ocuBinaryPath() {
+    if (process.env.FRELY_COMPUTER_BIN)
+        return process.env.FRELY_COMPUTER_BIN;
+    const dir = join(computerDir(), "bin", OCU_VERSION);
+    if (process.platform === "darwin")
+        return join(dir, "Open Computer Use.app", "Contents", "MacOS", "OpenComputerUse");
+    return join(dir, process.platform === "win32" ? "open-computer-use.exe" : "open-computer-use");
+}
+export class OcuNotInstalledError extends Error {
+    constructor(path) {
+        super(`The computer-use runtime is not installed (expected ${path}). Run \`frely computer enable\` on this device to install it.`);
+        this.name = "OcuNotInstalledError";
+    }
+}
+/** Lazily started stdio client for the open-computer-use binary; restarts on the next call after it dies. */
+export class StdioOcuBackend {
+    binary;
+    client;
+    starting;
+    constructor(binary = ocuBinaryPath()) {
+        this.binary = binary;
+    }
+    async connect() {
+        if (this.client)
+            return this.client;
+        this.starting ??= (async () => {
+            await access(this.binary).catch(() => { throw new OcuNotInstalledError(this.binary); });
+            const transport = new StdioClientTransport({ command: this.binary, args: ["mcp"], stderr: "ignore" });
+            const client = new Client({ name: "frely-cli-computer", version: "1" });
+            client.onclose = () => { if (this.client === client)
+                this.client = undefined; };
+            await client.connect(transport);
+            this.client = client;
+            return client;
+        })().finally(() => { this.starting = undefined; });
+        return this.starting;
+    }
+    async listTools() {
+        const result = await (await this.connect()).listTools();
+        return result.tools;
+    }
+    async callTool(name, args, signal) {
+        const result = await (await this.connect()).callTool({ name, arguments: args }, undefined, { ...(signal ? { signal } : {}), timeout: 60_000 });
+        return { content: (result.content ?? []), ...(result.isError ? { isError: true } : {}) };
+    }
+    async close() {
+        const client = this.client;
+        this.client = undefined;
+        await client?.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=ocu.js.map

package/dist/computer/ocu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocu.js","sourceRoot":"","sources":["../../src/computer/ocu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,sGAAsG;AACtG,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAanC,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,uBAAuB,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACrH,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,IAAY;QACtB,KAAK,CAAC,uDAAuD,IAAI,gEAAgE,CAAC,CAAC;QACnI,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,6GAA6G;AAC7G,MAAM,OAAO,eAAe;IAIG;IAHrB,MAAM,CAAqB;IAC3B,QAAQ,CAA8B;IAE9C,YAA6B,SAAiB,aAAa,EAAE;QAAhC,WAAM,GAAN,MAAM,CAA0B;IAAG,CAAC;IAEzD,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxF,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtG,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YACxE,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAChF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,KAAkB,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA6B,EAAE,MAAoB;QAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/I,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3G,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACpD,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/computer/runtime.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The pinned open-computer-use release (plan computer-use D7): the npm tarball bundles every platform's
+ * binary, and its sha512 integrity is fixed here, so a changed or tampered download is refused.
+ * Bumping OCU_VERSION means updating both constants from `npm view open-computer-use@<version> dist`.
+ */
+export declare const OCU_TARBALL_URL = "https://registry.npmjs.org/open-computer-use/-/open-computer-use-0.3.6.tgz";
+export declare const OCU_TARBALL_INTEGRITY = "sha512-pGNfWBBefl5qzQMo6rkC/e28sOfeczTQ0hEKkYn2sXwti38uz+fC4Y0oBdtnNACemsNVR06Dzp6SozJjkpkbSg==";
+export declare class OcuRuntimeError extends Error {
+    readonly code: "unsupported_platform" | "download_failed" | "integrity_mismatch" | "extract_failed";
+    constructor(code: "unsupported_platform" | "download_failed" | "integrity_mismatch" | "extract_failed", message: string);
+}
+export interface OcuRuntimeOptions {
+    fetchImpl?: typeof fetch;
+    url?: string;
+    integrity?: string;
+    platform?: NodeJS.Platform;
+    arch?: string;
+    /** Install target; defaults to the directory the toolset launches the binary from. */
+    binaryPath?: string;
+}
+/** Download the pinned tarball, verify its integrity, and install this platform's runtime. Idempotent. */
+export declare function installOcuRuntime(options?: OcuRuntimeOptions): Promise<string>;

package/dist/computer/runtime.js

@@ -0,0 +1,85 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { createHash } from "node:crypto";
+import { chmod, cp, mkdir, mkdtemp, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { promisify } from "node:util";
+import { OCU_VERSION, ocuBinaryPath } from "./ocu.js";
+const execFile = promisify(execFileCallback);
+/**
+ * The pinned open-computer-use release (plan computer-use D7): the npm tarball bundles every platform's
+ * binary, and its sha512 integrity is fixed here, so a changed or tampered download is refused.
+ * Bumping OCU_VERSION means updating both constants from `npm view open-computer-use@<version> dist`.
+ */
+export const OCU_TARBALL_URL = `https://registry.npmjs.org/open-computer-use/-/open-computer-use-${OCU_VERSION}.tgz`;
+export const OCU_TARBALL_INTEGRITY = "sha512-pGNfWBBefl5qzQMo6rkC/e28sOfeczTQ0hEKkYn2sXwti38uz+fC4Y0oBdtnNACemsNVR06Dzp6SozJjkpkbSg==";
+const MAX_TARBALL_BYTES = 64 * 1024 * 1024;
+export class OcuRuntimeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "OcuRuntimeError";
+    }
+}
+/** Path of the part of the tarball to extract for this platform, and what it becomes in the install directory. */
+function layout(platform, arch) {
+    const cpu = arch === "arm64" ? "arm64" : arch === "x64" ? "amd64" : undefined;
+    if (platform === "darwin" && (arch === "arm64" || arch === "x64"))
+        return { member: "package/dist/Open Computer Use.app", kind: "app", source: "Open Computer Use.app" };
+    if (platform === "linux" && cpu)
+        return { member: `package/dist/linux/${cpu}/open-computer-use`, kind: "binary", source: `dist/linux/${cpu}/open-computer-use` };
+    if (platform === "win32" && cpu)
+        return { member: `package/dist/windows/${cpu}/open-computer-use.exe`, kind: "binary", source: `dist/windows/${cpu}/open-computer-use.exe` };
+    throw new OcuRuntimeError("unsupported_platform", `Computer use is not available for ${platform}-${arch}.`);
+}
+/** Download the pinned tarball, verify its integrity, and install this platform's runtime. Idempotent. */
+export async function installOcuRuntime(options = {}) {
+    const target = options.binaryPath ?? ocuBinaryPath();
+    const plan = layout(options.platform ?? process.platform, options.arch ?? process.arch);
+    const url = options.url ?? OCU_TARBALL_URL;
+    if (!url.startsWith("https://") && !(options.url && options.fetchImpl))
+        throw new OcuRuntimeError("download_failed", "The runtime must be downloaded over HTTPS.");
+    const response = await (options.fetchImpl ?? fetch)(url).catch((error) => {
+        throw new OcuRuntimeError("download_failed", `Could not download the computer-use runtime: ${error instanceof Error ? error.message : "network error"}`);
+    });
+    if (!response.ok)
+        throw new OcuRuntimeError("download_failed", `Could not download the computer-use runtime (HTTP ${response.status}).`);
+    const bytes = Buffer.from(await response.arrayBuffer());
+    if (bytes.length > MAX_TARBALL_BYTES)
+        throw new OcuRuntimeError("download_failed", "The runtime download is larger than expected.");
+    const expected = options.integrity ?? OCU_TARBALL_INTEGRITY;
+    if (`sha512-${createHash("sha512").update(bytes).digest("base64")}` !== expected) {
+        throw new OcuRuntimeError("integrity_mismatch", "The downloaded runtime does not match the pinned checksum and was discarded.");
+    }
+    const installDir = plan.kind === "app" ? dirname(dirname(dirname(dirname(target)))) : dirname(target);
+    await mkdir(dirname(installDir), { recursive: true });
+    const stage = await mkdtemp(join(dirname(installDir), ".computer-install-"));
+    try {
+        const archive = join(stage, "runtime.tgz");
+        await writeFile(archive, bytes);
+        try {
+            await execFile("tar", ["-xzf", archive, "-C", stage, plan.member], { timeout: 120_000 });
+        }
+        catch (error) {
+            throw new OcuRuntimeError("extract_failed", `Could not unpack the computer-use runtime: ${error instanceof Error ? error.message : "tar failed"}`);
+        }
+        const extracted = join(stage, "package", "dist", ...(plan.kind === "app" ? [plan.source] : plan.source.split("/").slice(1)));
+        const staged = join(stage, "ready");
+        await mkdir(staged, { recursive: true });
+        if (plan.kind === "app")
+            await cp(extracted, join(staged, plan.source), { recursive: true });
+        else {
+            await cp(extracted, join(staged, plan.source.split("/").pop()));
+            if (process.platform !== "win32")
+                await chmod(join(staged, plan.source.split("/").pop()), 0o755);
+        }
+        await rm(installDir, { recursive: true, force: true });
+        await mkdir(dirname(installDir), { recursive: true });
+        await rename(staged, installDir);
+    }
+    finally {
+        await rm(stage, { recursive: true, force: true });
+    }
+    return target;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/computer/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/computer/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,oEAAoE,WAAW,MAAM,CAAC;AACrH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iGAAiG,CAAC;AACvI,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACnB;IAArB,YAAqB,IAA0F,EAAE,OAAe;QAC9H,KAAK,CAAC,OAAO,CAAC,CAAC;QADI,SAAI,GAAJ,IAAI,CAAsF;QAE7G,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAYD,kHAAkH;AAClH,SAAS,MAAM,CAAC,QAAyB,EAAE,IAAY;IACrD,MAAM,GAAG,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACzK,IAAI,QAAQ,KAAK,OAAO,IAAI,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,GAAG,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,oBAAoB,EAAE,CAAC;IACjK,IAAI,QAAQ,KAAK,OAAO,IAAI,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,wBAAwB,GAAG,wBAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,wBAAwB,EAAE,CAAC;IAC7K,MAAM,IAAI,eAAe,CAAC,sBAAsB,EAAE,qCAAqC,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC;AAC9G,CAAC;AAED,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAA6B,EAAE;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,IAAI,aAAa,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,eAAe,CAAC;IAC3C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,4CAA4C,CAAC,CAAC;IACnK,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAChF,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,gDAAgD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3J,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,qDAAqD,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IACzI,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAiB;QAAE,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,+CAA+C,CAAC,CAAC;IACpI,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,IAAI,qBAAqB,CAAC;IAC5D,IAAI,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACjF,MAAM,IAAI,eAAe,CAAC,oBAAoB,EAAE,8EAA8E,CAAC,CAAC;IAClI,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtG,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CAAC,gBAAgB,EAAE,8CAA8C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACrJ,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7H,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;aACxF,CAAC;YACJ,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,CAAC,CAAC;YACjE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/computer/server.d.ts

@@ -0,0 +1,11 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { ComputerToolset } from "./toolset.js";
+/** Name `frely computer enable` registers in the local MCP list; the web page turns it on by this name. */
+export declare const COMPUTER_MCP_NAME = "computer";
+/** The local key of the two-key rule: computer use works only while its entry is in the local MCP list. */
+export declare function computerEntryRegistered(): Promise<boolean>;
+export declare function createComputerToolset(): ComputerToolset;
+/** MCP server over the guarded toolset. Local MCP forwarding starts it as a stdio server (`frely computer mcp`). */
+export declare function createComputerMcpServer(toolset: ComputerToolset): Server;
+export declare function runComputerMcpServer(transport?: Transport, toolset?: ComputerToolset): Promise<void>;

package/dist/computer/server.js

@@ -0,0 +1,31 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { VERSION } from "../version.js";
+import { loadManualEntries } from "../runtime/local-mcp.js";
+import { StdioOcuBackend } from "./ocu.js";
+import { ComputerToolset } from "./toolset.js";
+/** Name `frely computer enable` registers in the local MCP list; the web page turns it on by this name. */
+export const COMPUTER_MCP_NAME = "computer";
+/** The local key of the two-key rule: computer use works only while its entry is in the local MCP list. */
+export async function computerEntryRegistered() {
+    return (await loadManualEntries().catch(() => [])).some((entry) => entry.name === COMPUTER_MCP_NAME && entry.transport === "stdio");
+}
+export function createComputerToolset() {
+    return new ComputerToolset({ backend: new StdioOcuBackend(), isLocallyEnabled: computerEntryRegistered });
+}
+/** MCP server over the guarded toolset. Local MCP forwarding starts it as a stdio server (`frely computer mcp`). */
+export function createComputerMcpServer(toolset) {
+    const server = new Server({ name: "frely-computer", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: await toolset.listTools() }));
+    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+        const result = await toolset.call(request.params.name, (request.params.arguments ?? {}), extra.signal);
+        return { content: result.content, ...(result.isError ? { isError: true } : {}) };
+    });
+    server.onclose = () => { void toolset.close(); };
+    return server;
+}
+export async function runComputerMcpServer(transport = new StdioServerTransport(), toolset = createComputerToolset()) {
+    await createComputerMcpServer(toolset).connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/computer/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/computer/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,2GAA2G;AAC3G,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C,2GAA2G;AAC3G,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,CAAC,MAAM,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;AACtI,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,eAAe,EAAE,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC,CAAC;AAC5G,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzG,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACrG,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClI,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAsE,CAAC;IACvJ,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,YAAuB,IAAI,oBAAoB,EAAE,EAAE,UAA2B,qBAAqB,EAAE;IAC9I,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAC5D,CAAC"}

package/dist/computer/state.d.ts

@@ -0,0 +1,11 @@
+export declare function computerDir(): string;
+export interface ComputerAuditEntry {
+    ts: string;
+    tool: string;
+    app?: string;
+    ok: boolean;
+    ms: number;
+    reason?: string;
+}
+/** Metadata only: never the screenshot, the typed text or any tool output. Failures here never affect the call. */
+export declare function appendComputerAudit(entry: ComputerAuditEntry): Promise<void>;

package/dist/computer/state.js

@@ -0,0 +1,17 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function computerDir() {
+    return join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "frely", "computer");
+}
+const auditPath = () => join(computerDir(), "audit.jsonl");
+/** Metadata only: never the screenshot, the typed text or any tool output. Failures here never affect the call. */
+export async function appendComputerAudit(entry) {
+    try {
+        const path = auditPath();
+        await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+        await appendFile(path, `${JSON.stringify(entry)}\n`, { mode: 0o600 });
+    }
+    catch { /* best effort */ }
+}
+//# sourceMappingURL=state.js.map

package/dist/computer/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/computer/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;AAI3D,mHAAmH;AACnH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAyB;IACjE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC"}

package/dist/computer/toolset.d.ts

@@ -0,0 +1,22 @@
+import type { OcuBackend, OcuResult, OcuTool } from "./ocu.js";
+import { type ComputerAuditEntry } from "./state.js";
+export interface ComputerToolsetOptions {
+    backend: OcuBackend;
+    /** Local key of the two-key rule (the registered local MCP entry); checked on every list and call so `frely computer disable` takes effect at once. */
+    isLocallyEnabled: () => Promise<boolean>;
+    audit?: (entry: ComputerAuditEntry) => Promise<void>;
+}
+export declare class ComputerToolset {
+    private readonly backend;
+    private readonly isLocallyEnabled;
+    private readonly audit;
+    /** original / sent size per app, from its latest screenshot, to map model coordinates back to device pixels. */
+    private readonly scales;
+    constructor(options: ComputerToolsetOptions);
+    available(): Promise<boolean>;
+    listTools(): Promise<OcuTool[]>;
+    call(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<OcuResult>;
+    close(): Promise<void>;
+    private scaleCoordinates;
+    private shapeScreenshots;
+}