@oharness/engine 0.7.1 → 0.9.0

package/dist/browser/extension.js

@@ -0,0 +1,297 @@
+import { connect } from "node:net";
+import { BrowserError } from "../core/errors.js";
+import { CdpConnection } from "./cdp.js";
+import { ScreencastHub } from "./screencast.js";
+import { extensionSocketPath } from "./socket.js";
+/** Open the socket the native messaging host listens on. */
+export function connectExtensionChannel(path = extensionSocketPath()) {
+    return new Promise((resolve, reject) => {
+        const socket = connect(path);
+        const messageHandlers = new Set();
+        const closeHandlers = new Set();
+        let buffer = "";
+        socket.setEncoding("utf8");
+        socket.on("data", (chunk) => {
+            buffer += chunk;
+            let newline;
+            while ((newline = buffer.indexOf("\n")) !== -1) {
+                const line = buffer.slice(0, newline).trim();
+                buffer = buffer.slice(newline + 1);
+                if (line === "")
+                    continue;
+                let parsed;
+                try {
+                    parsed = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                for (const handler of messageHandlers)
+                    handler(parsed);
+            }
+        });
+        socket.once("error", (err) => {
+            reject(new BrowserError(`no browser extension is connected. Add the OHarness extension to Chrome, Edge or Brave and keep that browser open; outside the desktop app, also run \`oharness-browser-host install\` once. (${err.message})`, err));
+        });
+        socket.on("close", () => {
+            for (const handler of closeHandlers)
+                handler("the extension disconnected");
+        });
+        socket.once("connect", () => {
+            socket.removeAllListeners("error");
+            socket.on("error", () => {
+                for (const handler of closeHandlers)
+                    handler("the extension connection failed");
+            });
+            resolve({
+                send: (message) => socket.write(`${JSON.stringify(message)}\n`),
+                onMessage: (handler) => void messageHandlers.add(handler),
+                onClose: (handler) => void closeHandlers.add(handler),
+                close: () => socket.end(),
+            });
+        });
+    });
+}
+export async function extensionTarget(channel, context = {}) {
+    return new ExtensionTarget(channel ?? (await connectExtensionChannel()), context);
+}
+class ExtensionTarget {
+    kind = "extension";
+    channel;
+    cdp;
+    attached = new Map();
+    /** Tabs this conversation opened, as against the person's own it was pointed at. */
+    openedTabs = new Set();
+    control = new Map();
+    nextControlId = 1;
+    context;
+    constructor(channel, context = {}) {
+        this.channel = channel;
+        this.context = context;
+        this.cdp = new CdpConnection((message) => channel.send({ t: "cdp", ...message }));
+        channel.onMessage((message) => {
+            if (typeof message !== "object" || message === null)
+                return;
+            const envelope = message;
+            if (envelope["t"] === "cdp") {
+                // The person cancelled the debugging banner, or the tab went away. The
+                // page is no longer ours; the next use of it attaches again.
+                if (envelope["method"] === "Inspector.detached" && envelope["sessionId"] !== undefined) {
+                    this.attached.delete(String(envelope["sessionId"]));
+                }
+                const { t: _ignored, ...rest } = envelope;
+                this.cdp.deliver(rest);
+                return;
+            }
+            if (envelope["t"] === "ctl") {
+                const reply = envelope;
+                const pending = this.control.get(reply.id);
+                if (!pending)
+                    return;
+                this.control.delete(reply.id);
+                if (reply.error)
+                    pending.reject(new BrowserError(reply.error));
+                else
+                    pending.resolve(reply.result);
+            }
+        });
+        channel.onClose((reason) => {
+            this.cdp.fail(reason ?? "the extension disconnected");
+            for (const pending of this.control.values()) {
+                pending.reject(new BrowserError(reason ?? "the extension disconnected"));
+            }
+            this.control.clear();
+            this.attached.clear();
+        });
+    }
+    /**
+     * Ask the extension something CDP has no browser-level answer for.
+     *
+     * `chrome.debugger` is scoped to a tab, so listing and opening tabs go through
+     * `chrome.tabs` on the extension side and come back here as control replies.
+     */
+    ask(op, params = {}) {
+        const id = this.nextControlId++;
+        return new Promise((resolve, reject) => {
+            this.control.set(id, { resolve, reject });
+            const timer = setTimeout(() => {
+                if (!this.control.delete(id))
+                    return;
+                reject(new BrowserError(`the extension did not answer ${op}`));
+            }, 15_000);
+            timer.unref?.();
+            try {
+                this.channel.send({ t: "ctl", id, op, ...params });
+            }
+            catch (err) {
+                this.control.delete(id);
+                reject(new BrowserError(`could not reach the extension`, err));
+            }
+        });
+    }
+    /**
+     * The tabs this conversation is driving — never the rest of the window.
+     *
+     * Every other target answers with all of its pages, because all of them are
+     * the agent's. Here the rest are the person's, and several conversations may
+     * be using the browser at once: attaching everything would put a banner on
+     * every tab and have each conversation start on whichever tab came first.
+     * The others are listed by `pageInfos` and attached when one is chosen.
+     */
+    async pages() {
+        const open = new Set((await this.tabRecords()).map((entry) => String(entry.tabId)));
+        return [...this.attached.values()].filter((page) => open.has(page.id));
+    }
+    async tabRecords() {
+        const result = await this.ask("tabs");
+        return Array.isArray(result) ? result : [];
+    }
+    async pageInfos() {
+        return (await this.tabRecords()).flatMap((entry) => {
+            if (typeof entry.tabId !== "number" && typeof entry.tabId !== "string")
+                return [];
+            const title = typeof entry.title === "string" ? entry.title.trim() : "";
+            return [{
+                    id: String(entry.tabId),
+                    url: typeof entry.url === "string" ? entry.url : "",
+                    ...(title ? { title } : {}),
+                }];
+        });
+    }
+    async pageById(id) {
+        const known = (await this.pageInfos()).some((page) => page.id === id);
+        return known ? this.attach(id) : undefined;
+    }
+    async newPage(url = "about:blank") {
+        // Grouped per conversation, so the person can see which tabs belong to
+        // which piece of work, and several conversations never share a tab.
+        const title = this.context.label?.()?.trim();
+        const result = (await this.ask("newTab", {
+            url,
+            group: {
+                key: this.context.sessionId ?? "oharness",
+                ...(title ? { title } : {}),
+                // So the side panel, finding the person in this group, can open the
+                // conversation in its project.
+                ...(this.context.cwd ? { cwd: this.context.cwd } : {}),
+            },
+        }));
+        const tabId = result?.tabId;
+        if (typeof tabId !== "number" && typeof tabId !== "string") {
+            throw new BrowserError("the extension opened no tab");
+        }
+        this.openedTabs.add(String(tabId));
+        return this.attach(String(tabId));
+    }
+    opened(id) {
+        return this.openedTabs.has(id);
+    }
+    /** Let go of one tab — the banner goes, the tab stays where the person had it. */
+    async release(page) {
+        this.attached.delete(page.id);
+        await this.ask("detach", { tabId: page.id });
+    }
+    async activate(page) {
+        await this.ask("activate", { tabId: page.id });
+    }
+    /** The browser the extension runs in. An extension older than `info` cannot say. */
+    async describe() {
+        const result = (await this.ask("info"));
+        const name = typeof result?.name === "string" && result.name.trim() ? result.name.trim() : "Chrome";
+        return { name, ...(typeof result?.version === "string" ? { version: result.version } : {}) };
+    }
+    async attach(tabId) {
+        const existing = this.attached.get(tabId);
+        if (existing)
+            return existing;
+        await this.ask("attach", { tabId });
+        const page = new ExtensionPage(tabId, this.cdp, (op, params) => this.ask(op, params), () => {
+            this.attached.delete(tabId);
+            this.openedTabs.delete(tabId);
+        });
+        this.attached.set(tabId, page);
+        await page.prepare();
+        return page;
+    }
+    async close() {
+        // Detach rather than close: these are the person's own tabs, and shutting
+        // the harness down must not take their browsing with it.
+        for (const tabId of this.attached.keys()) {
+            await this.ask("detach", { tabId }).catch(() => { });
+        }
+        this.attached.clear();
+        this.channel.close();
+    }
+}
+class ExtensionPage {
+    id;
+    cdp;
+    ask;
+    forget;
+    screencast;
+    constructor(id, cdp, ask, forget) {
+        this.id = id;
+        this.cdp = cdp;
+        this.ask = ask;
+        this.forget = forget;
+        this.screencast = new ScreencastHub(this);
+    }
+    async prepare() {
+        for (const domain of ["Page.enable", "Runtime.enable", "DOM.enable", "Log.enable"]) {
+            await this.send(domain).catch(() => { });
+        }
+    }
+    send(method, params = {}) {
+        return this.cdp.send(method, params, this.id);
+    }
+    on(event, handler) {
+        return this.cdp.on(event, handler, this.id);
+    }
+    /** Frames, shared with every other watcher of this tab. */
+    frames(opts = {}) {
+        return this.screencast.frames(opts);
+    }
+    async input(event) {
+        if (event.type === "text") {
+            await this.send("Input.insertText", { text: event.text });
+            return;
+        }
+        if (event.type === "key") {
+            const type = event.action === "char" ? "char" : event.action === "down" ? "keyDown" : "keyUp";
+            await this.send("Input.dispatchKeyEvent", {
+                type,
+                ...(event.key ? { key: event.key } : {}),
+                ...(event.code ? { code: event.code } : {}),
+                ...(event.text ? { text: event.text } : {}),
+                modifiers: event.modifiers ?? 0,
+            });
+            return;
+        }
+        if (event.action === "wheel") {
+            await this.send("Input.dispatchMouseEvent", {
+                type: "mouseWheel",
+                x: event.x,
+                y: event.y,
+                deltaX: event.deltaX ?? 0,
+                deltaY: event.deltaY ?? 0,
+                modifiers: event.modifiers ?? 0,
+            });
+            return;
+        }
+        await this.send("Input.dispatchMouseEvent", {
+            type: event.action === "move" ? "mouseMoved" : event.action === "down" ? "mousePressed" : "mouseReleased",
+            x: event.x,
+            y: event.y,
+            button: event.button ?? "left",
+            clickCount: event.clickCount ?? (event.action === "move" ? 0 : 1),
+            modifiers: event.modifiers ?? 0,
+        });
+    }
+    /** Explicit tab close. Target shutdown still only detaches the person's other tabs. */
+    async close() {
+        this.forget();
+        this.screencast.close();
+        await this.ask("closeTab", { tabId: this.id });
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/browser/extension.js.map

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

package/dist/browser/host-manifest.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Registering the native messaging host.
+ *
+ * Chrome will only start a host it has a manifest for, and will only let the
+ * named extensions talk to it. The manifest is a small JSON file in a
+ * per-browser directory — except on Windows, where a registry value points at
+ * the file.
+ *
+ * What the manifest names is a launcher this writes, never the host script
+ * itself. Chrome starts hosts with almost no environment: from the Dock on a
+ * Mac, `PATH` has no Homebrew in it, so a script beginning `#!/usr/bin/env node`
+ * fails with nothing but "native host has exited". Nor can a script inside a
+ * packaged app's archive be run at all. The launcher names the runtime by its
+ * absolute path — the Node running the install, or the desktop app's own
+ * executable told to behave as Node — and is the one file here that has to be
+ * executable.
+ */
+export declare const HOST_NAME = "ai.oharness.browser";
+/**
+ * The extension's id, pinned by the `key` in its manifest.
+ *
+ * Without a key an unpacked extension's id is derived from the directory it
+ * was loaded from, so it differs per machine and every install needed the
+ * person to copy it across by hand. The key makes it the same everywhere, so
+ * registering needs no argument and the desktop app can do it unasked.
+ */
+export declare const EXTENSION_ID = "ccflolhofpnacaokjapodnphjjgiddmi";
+/**
+ * Where somebody gets the extension, for the settings page to send them.
+ *
+ * PLACEHOLDER until the store listing exists. When it does, this becomes the
+ * listing's URL and EXTENSION_ID above becomes the listing's id.
+ */
+export declare const EXTENSION_INSTALL_URL = "https://oharness.ai/extension";
+interface BrowserSlot {
+    id: string;
+    label: string;
+    dir: string;
+}
+/** Every Chromium the manifest can be installed for, on this platform. */
+export declare function nativeHostTargets(platform?: NodeJS.Platform, home?: string): BrowserSlot[];
+/** Where each Chromium on Windows looks for a host, under HKEY_CURRENT_USER. */
+export declare function windowsRegistryKeys(): string[];
+export interface NativeHostManifest {
+    name: string;
+    description: string;
+    path: string;
+    type: "stdio";
+    allowed_origins: string[];
+}
+export declare function nativeHostManifest(executable: string, extensionIds: string[]): NativeHostManifest;
+export interface InstallResult {
+    /** The launcher, then every manifest written. */
+    written: string[];
+    /** Set only when something could not be finished here, with what is left to run. */
+    manual?: string;
+}
+export interface InstallOptions {
+    /** An absolute path to Node, or to an Electron app that runs scripts as Node. */
+    runtime: string;
+    /** The host entry script the runtime is given. */
+    script: string;
+    /** The runtime is Electron: tell it to be Node rather than open a window. */
+    runAsNode?: boolean;
+    /** Extensions allowed to start the host. Defaults to the published one. */
+    extensionIds?: string[];
+    platform?: NodeJS.Platform;
+    home?: string;
+    /** Where the launcher and the Windows manifest go. Defaults to the user directory. */
+    dir?: string;
+    /** Restrict to these browser ids; default is every one this platform knows. */
+    browsers?: string[];
+    /** Writes one registry default value. Replaceable so tests never touch a registry. */
+    setRegistry?: (key: string, value: string) => Promise<void>;
+}
+export declare function hostLauncher(opts: Pick<InstallOptions, "runtime" | "script" | "runAsNode">, platform: NodeJS.Platform): string;
+export declare function installNativeHost(opts: InstallOptions): Promise<InstallResult>;
+export {};

package/dist/browser/host-manifest.js

@@ -0,0 +1,166 @@
+import { execFile } from "node:child_process";
+import { chmod, mkdir, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { BrowserError } from "../core/errors.js";
+import { userDir } from "../paths.js";
+/**
+ * Registering the native messaging host.
+ *
+ * Chrome will only start a host it has a manifest for, and will only let the
+ * named extensions talk to it. The manifest is a small JSON file in a
+ * per-browser directory — except on Windows, where a registry value points at
+ * the file.
+ *
+ * What the manifest names is a launcher this writes, never the host script
+ * itself. Chrome starts hosts with almost no environment: from the Dock on a
+ * Mac, `PATH` has no Homebrew in it, so a script beginning `#!/usr/bin/env node`
+ * fails with nothing but "native host has exited". Nor can a script inside a
+ * packaged app's archive be run at all. The launcher names the runtime by its
+ * absolute path — the Node running the install, or the desktop app's own
+ * executable told to behave as Node — and is the one file here that has to be
+ * executable.
+ */
+export const HOST_NAME = "ai.oharness.browser";
+/**
+ * The extension's id, pinned by the `key` in its manifest.
+ *
+ * Without a key an unpacked extension's id is derived from the directory it
+ * was loaded from, so it differs per machine and every install needed the
+ * person to copy it across by hand. The key makes it the same everywhere, so
+ * registering needs no argument and the desktop app can do it unasked.
+ */
+export const EXTENSION_ID = "ccflolhofpnacaokjapodnphjjgiddmi";
+/**
+ * Where somebody gets the extension, for the settings page to send them.
+ *
+ * PLACEHOLDER until the store listing exists. When it does, this becomes the
+ * listing's URL and EXTENSION_ID above becomes the listing's id.
+ */
+export const EXTENSION_INSTALL_URL = "https://oharness.ai/extension";
+/** Every Chromium the manifest can be installed for, on this platform. */
+export function nativeHostTargets(platform = process.platform, home = homedir()) {
+    if (platform === "darwin") {
+        const support = path.join(home, "Library", "Application Support");
+        return [
+            { id: "chrome", label: "Google Chrome", dir: path.join(support, "Google", "Chrome", "NativeMessagingHosts") },
+            { id: "chrome-beta", label: "Chrome Beta", dir: path.join(support, "Google", "Chrome Beta", "NativeMessagingHosts") },
+            { id: "chromium", label: "Chromium", dir: path.join(support, "Chromium", "NativeMessagingHosts") },
+            { id: "edge", label: "Microsoft Edge", dir: path.join(support, "Microsoft Edge", "NativeMessagingHosts") },
+            { id: "brave", label: "Brave", dir: path.join(support, "BraveSoftware", "Brave-Browser", "NativeMessagingHosts") },
+        ];
+    }
+    if (platform === "linux") {
+        const config = process.env["XDG_CONFIG_HOME"] || path.join(home, ".config");
+        return [
+            { id: "chrome", label: "Google Chrome", dir: path.join(config, "google-chrome", "NativeMessagingHosts") },
+            { id: "chromium", label: "Chromium", dir: path.join(config, "chromium", "NativeMessagingHosts") },
+            { id: "edge", label: "Microsoft Edge", dir: path.join(config, "microsoft-edge", "NativeMessagingHosts") },
+            { id: "brave", label: "Brave", dir: path.join(config, "BraveSoftware", "brave-browser", "NativeMessagingHosts") },
+        ];
+    }
+    // Windows reads a registry value rather than a directory; see windowsRegistryKeys.
+    return [];
+}
+/** Where each Chromium on Windows looks for a host, under HKEY_CURRENT_USER. */
+export function windowsRegistryKeys() {
+    return [
+        "Google\\Chrome",
+        "Chromium",
+        "Microsoft\\Edge",
+        "BraveSoftware\\Brave-Browser",
+    ].map((vendor) => `HKCU\\Software\\${vendor}\\NativeMessagingHosts\\${HOST_NAME}`);
+}
+export function nativeHostManifest(executable, extensionIds) {
+    if (extensionIds.length === 0) {
+        throw new BrowserError("an extension id is required: Chrome will not let an unlisted extension start a host");
+    }
+    for (const id of extensionIds) {
+        // Chrome ids are 32 characters of a-p. A wrong one fails silently at
+        // connect time, which is a miserable thing to debug, so it is caught here.
+        if (!/^[a-p]{32}$/.test(id)) {
+            throw new BrowserError(`"${id}" is not a Chrome extension id (32 letters a-p, shown on chrome://extensions)`);
+        }
+    }
+    return {
+        name: HOST_NAME,
+        description: "OHarness browser bridge",
+        path: executable,
+        type: "stdio",
+        allowed_origins: extensionIds.map((id) => `chrome-extension://${id}/`),
+    };
+}
+/** A path inside single quotes, for sh. */
+function shellQuote(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+export function hostLauncher(opts, platform) {
+    if (platform === "win32") {
+        // Nothing may reach stdout but the protocol, so the batch file echoes nothing.
+        return [
+            "@echo off",
+            ...(opts.runAsNode ? ["set ELECTRON_RUN_AS_NODE=1"] : []),
+            `"${opts.runtime}" "${opts.script}" %*`,
+            "",
+        ].join("\r\n");
+    }
+    return [
+        "#!/bin/sh",
+        "# Written by OHarness. Chrome runs this to reach the harness; see host-manifest.ts.",
+        `${opts.runAsNode ? "ELECTRON_RUN_AS_NODE=1 " : ""}exec ${shellQuote(opts.runtime)} ${shellQuote(opts.script)} "$@"`,
+        "",
+    ].join("\n");
+}
+function regAdd(key, value) {
+    return new Promise((resolve, reject) => {
+        execFile("reg", ["add", key, "/ve", "/t", "REG_SZ", "/d", value, "/f"], { windowsHide: true }, (err) => err ? reject(err) : resolve());
+    });
+}
+export async function installNativeHost(opts) {
+    const platform = opts.platform ?? process.platform;
+    const dir = opts.dir ?? (opts.home ? path.join(opts.home, ".oharness") : userDir());
+    const manifestFor = (launcher) => `${JSON.stringify(nativeHostManifest(launcher, opts.extensionIds ?? [EXTENSION_ID]), null, 2)}\n`;
+    const launcher = path.join(dir, platform === "win32" ? "browser-host.bat" : "browser-host");
+    await mkdir(dir, { recursive: true });
+    await writeFile(launcher, hostLauncher(opts, platform), "utf8");
+    if (platform !== "win32")
+        await chmod(launcher, 0o755);
+    const body = manifestFor(launcher);
+    if (platform === "win32") {
+        const file = path.join(dir, `${HOST_NAME}.json`);
+        await writeFile(file, body, "utf8");
+        const setRegistry = opts.setRegistry ?? regAdd;
+        const failed = [];
+        for (const key of windowsRegistryKeys()) {
+            await setRegistry(key, file).catch(() => failed.push(key));
+        }
+        if (failed.length === windowsRegistryKeys().length) {
+            return {
+                written: [launcher, file],
+                manual: `The registry could not be written. Run:\n  reg add "${failed[0]}" /ve /t REG_SZ /d "${file}" /f`,
+            };
+        }
+        return { written: [launcher, file] };
+    }
+    const slots = nativeHostTargets(platform, opts.home).filter((slot) => !opts.browsers || opts.browsers.includes(slot.id));
+    const written = [launcher];
+    for (const slot of slots) {
+        // Written for every browser this platform knows, whether or not it is
+        // installed: the directory is created either way, and a manifest for a
+        // browser somebody installs next week costs a few hundred bytes now.
+        const file = path.join(slot.dir, `${HOST_NAME}.json`);
+        try {
+            await mkdir(slot.dir, { recursive: true });
+            await writeFile(file, body, "utf8");
+            written.push(file);
+        }
+        catch {
+            /* a browser whose support directory cannot be written is simply skipped */
+        }
+    }
+    if (written.length === 1) {
+        throw new BrowserError("could not write the host manifest for any browser");
+    }
+    return { written };
+}
+//# sourceMappingURL=host-manifest.js.map

package/dist/browser/host-manifest.js.map

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

package/dist/browser/host.d.ts

@@ -0,0 +1,27 @@
+export interface HostOptions {
+    /** Chrome's messages in. Required: the engine owns no process streams. */
+    input: NodeJS.ReadableStream;
+    /** Chrome's messages out — the protocol itself, never a log. */
+    output: NodeJS.WritableStream;
+    socketPath?: string;
+    /** Told what went wrong. Dropped if the caller does not want to know. */
+    warn?: (message: string) => void;
+}
+export interface RunningHost {
+    readonly socketPath: string;
+    /**
+     * Settles once the host has shut down — Chrome closed its stdin, or `close`
+     * was called. The process running it should then exit explicitly: left to
+     * wind down on its own, Node closes every handle on the way out, and closing
+     * a unix socket server deletes its path even when a newer host owns it now.
+     */
+    readonly closed: Promise<void>;
+    close(): Promise<void>;
+}
+/** Split Chrome's length-prefixed stream into messages. */
+export declare class NativeMessageFramer {
+    private buffer;
+    push(chunk: Buffer, onMessage: (message: unknown) => void, onError?: (reason: string) => void): void;
+}
+export declare function encodeNativeMessage(message: unknown): Buffer;
+export declare function runBrowserHost(opts: HostOptions): Promise<RunningHost>;