@oharness/engine 0.7.1 → 0.8.0

package/dist/browser/index.d.ts

@@ -0,0 +1,26 @@
+export { BrowserSession, originOf } from "./session.ts";
+export type { BrowserSessionOptions, ConsoleEntry, NetworkEntry } from "./session.ts";
+export { createBrowserTools } from "./tools.ts";
+export { findChrome, launchChrome } from "./chrome.ts";
+export type { LaunchChromeOptions } from "./chrome.ts";
+export { CdpConnection, NulFramer } from "./cdp.ts";
+export type { CdpMessage } from "./cdp.ts";
+export { buildSnapshot } from "./snapshot.ts";
+export type { AxNode, Snapshot, SnapshotOptions } from "./snapshot.ts";
+export type { BrowserInputEvent, BrowserPage, BrowserTarget, BrowserTargetFactory, FrameOptions, BrowserTargetContext, } from "./target.ts";
+export { createBrowserUsePlugin } from "./plugin.ts";
+export type { BrowserUsePlugin, BrowserUseSession, BrowserUseSessionContext, DefaultBrowserUsePluginOptions } from "./plugin.ts";
+export { browserProviderFor, builtinBrowserProvider, extensionBrowserProvider } from "./provider.ts";
+export type { BrowserProviderPlugin } from "./provider.ts";
+export { connectExtensionChannel, extensionTarget } from "./extension.ts";
+export { extensionHostReachable, extensionSocketPath } from "./socket.ts";
+export { announcePresence } from "./presence.ts";
+export type { Presence, PresenceInfo } from "./presence.ts";
+export type { ExtensionChannel } from "./extension.ts";
+export { NativeMessageFramer, encodeNativeMessage, runBrowserHost } from "./host.ts";
+export type { HostOptions, RunningHost } from "./host.ts";
+export { EXTENSION_ID, EXTENSION_INSTALL_URL, HOST_NAME, hostLauncher, installNativeHost, nativeHostManifest, nativeHostTargets, windowsRegistryKeys, } from "./host-manifest.ts";
+export type { InstallOptions, InstallResult, NativeHostManifest } from "./host-manifest.ts";
+export { ScreencastHub } from "./screencast.ts";
+export { LoginImportMemory, cookieInSite, cookieParam, groupSites, hostInSite, normalizeSite, readSiteLoginState } from "./login-import.ts";
+export type { CookieParam, ExternalSite, ImportedSite, SiteLoginState } from "./login-import.ts";

package/dist/browser/index.js

@@ -0,0 +1,15 @@
+export { BrowserSession, originOf } from "./session.js";
+export { createBrowserTools } from "./tools.js";
+export { findChrome, launchChrome } from "./chrome.js";
+export { CdpConnection, NulFramer } from "./cdp.js";
+export { buildSnapshot } from "./snapshot.js";
+export { createBrowserUsePlugin } from "./plugin.js";
+export { browserProviderFor, builtinBrowserProvider, extensionBrowserProvider } from "./provider.js";
+export { connectExtensionChannel, extensionTarget } from "./extension.js";
+export { extensionHostReachable, extensionSocketPath } from "./socket.js";
+export { announcePresence } from "./presence.js";
+export { NativeMessageFramer, encodeNativeMessage, runBrowserHost } from "./host.js";
+export { EXTENSION_ID, EXTENSION_INSTALL_URL, HOST_NAME, hostLauncher, installNativeHost, nativeHostManifest, nativeHostTargets, windowsRegistryKeys, } from "./host-manifest.js";
+export { ScreencastHub } from "./screencast.js";
+export { LoginImportMemory, cookieInSite, cookieParam, groupSites, hostInSite, normalizeSite, readSiteLoginState } from "./login-import.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAU9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAErG,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAErF,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/browser/login-import.d.ts

@@ -0,0 +1,98 @@
+import type { BrowserTarget } from "./target.ts";
+/**
+ * Moving a site's sign-in from the person's own browser into the built-in one.
+ *
+ * The external browser is only ever reached through the OHarness extension —
+ * the same sanctioned relay extension mode drives — so nothing here reads
+ * another browser's cookie database off disk or asks the keychain for its key.
+ * Chrome shows its "being debugged" banner while a tab is read, which is the
+ * disclosure this deserves.
+ *
+ * The unit is a site, not a browser. Copying a whole cookie jar would hand the
+ * agent every account the person has, for the sake of the one it needed; a site
+ * is what the person can reason about in a confirmation dialog, and what the
+ * dialog names. Nothing in this module runs without that confirmation: the
+ * server only calls `readSiteLoginState` from the dialog's import action.
+ */
+/** A cookie as `Network.setCookies` accepts it. */
+export type CookieParam = Record<string, unknown> & {
+    name: string;
+    value: string;
+};
+export interface SiteLoginState {
+    site: string;
+    cookies: CookieParam[];
+    /** localStorage per origin, read from the site's open tabs. */
+    origins: Array<{
+        origin: string;
+        url: string;
+        localStorage: Array<[string, string]>;
+    }>;
+}
+export interface ExternalSite {
+    site: string;
+    /** The most useful page to reopen in the built-in browser. */
+    url: string;
+    title?: string;
+    tabs: number;
+}
+export interface ImportedSite {
+    site: string;
+    cookies: number;
+    localStorage: number;
+    url?: string;
+}
+/**
+ * The site a URL or typed domain names: lower-case host, `www.` dropped so
+ * `github.com` and `www.github.com` are one choice in the dialog.
+ */
+export declare function normalizeSite(input: string): string | undefined;
+/** Whether a host belongs to a site: the site itself or any subdomain of it. */
+export declare function hostInSite(host: string, site: string): boolean;
+/**
+ * Whether a cookie is part of signing in to `site`.
+ *
+ * Its own and its subdomains' cookies, and the parent domain's too: signing in
+ * to `mail.example.com` often lives in a cookie set on `.example.com`. A public
+ * suffix can never carry a cookie, so the parent walk cannot reach `.com`.
+ */
+export declare function cookieInSite(domain: string, site: string): boolean;
+/** The http(s) sites open in a browser, grouped the way the dialog lists them. */
+export declare function groupSites(tabs: Array<{
+    url: string;
+    title?: string;
+}>): ExternalSite[];
+/** Which browser the extension lives in, for the dialog. Older extensions cannot say. */
+export declare function externalBrowserName(target: BrowserTarget): Promise<string>;
+export declare function listExternalSites(target: BrowserTarget): Promise<ExternalSite[]>;
+/**
+ * Read one site's cookies and localStorage from the external browser.
+ *
+ * Cookies come from the browser-wide store, so any attached tab can answer;
+ * localStorage only exists inside a page of its own origin, so it is read from
+ * the site's open tabs and is simply absent for a site with none.
+ */
+export declare function readSiteLoginState(target: BrowserTarget, site: string): Promise<SiteLoginState>;
+/**
+ * A read cookie, rewritten as one `Network.setCookies` will store identically.
+ *
+ * A host-only cookie is reported with a bare domain, and passing that back as
+ * `domain` would widen it to every subdomain (and make a `__Host-` cookie
+ * invalid). So host-only cookies are set by `url`, domain cookies by `domain`.
+ * Partitioning and source-port fields are left out: their shapes differ across
+ * Chromium versions, and the embedded one rejects what it does not know.
+ */
+export declare function cookieParam(cookie: Record<string, unknown>): CookieParam | undefined;
+/**
+ * Sites the person already answered for — imported, or told the suggestion to
+ * go away. The built-in profile is shared and persistent, so the answer is too:
+ * asking again in the next conversation would be asking the same question.
+ */
+export declare class LoginImportMemory {
+    private readonly file;
+    private loaded?;
+    constructor(file?: string);
+    private sites;
+    has(site: string): Promise<boolean>;
+    add(site: string): Promise<void>;
+}

package/dist/browser/login-import.js

@@ -0,0 +1,244 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { BrowserError } from "../core/errors.js";
+import { userPath } from "../paths.js";
+/** A page's localStorage can be large; the import is for sign-in, not caches. */
+const LOCAL_STORAGE_LIMIT = 5 * 1024 * 1024;
+/**
+ * The site a URL or typed domain names: lower-case host, `www.` dropped so
+ * `github.com` and `www.github.com` are one choice in the dialog.
+ */
+export function normalizeSite(input) {
+    const raw = input.trim().toLowerCase();
+    if (!raw)
+        return undefined;
+    let host;
+    try {
+        host = new URL(/^[a-z][a-z0-9+.-]*:\/\//.test(raw) ? raw : `https://${raw}`).hostname;
+    }
+    catch {
+        return undefined;
+    }
+    host = host.replace(/^\.+/, "").replace(/\.$/, "");
+    if (!host || /\s/.test(host))
+        return undefined;
+    // A bare label ("com", "localhost") would match every cookie under it.
+    if (!host.includes(".") && host !== "localhost")
+        return undefined;
+    return host.startsWith("www.") ? host.slice(4) : host;
+}
+/** Whether a host belongs to a site: the site itself or any subdomain of it. */
+export function hostInSite(host, site) {
+    const value = host.toLowerCase().replace(/^\.+/, "");
+    return value === site || value.endsWith(`.${site}`);
+}
+/**
+ * Whether a cookie is part of signing in to `site`.
+ *
+ * Its own and its subdomains' cookies, and the parent domain's too: signing in
+ * to `mail.example.com` often lives in a cookie set on `.example.com`. A public
+ * suffix can never carry a cookie, so the parent walk cannot reach `.com`.
+ */
+export function cookieInSite(domain, site) {
+    const value = domain.toLowerCase().replace(/^\.+/, "");
+    if (!value)
+        return false;
+    return value === site || value.endsWith(`.${site}`) || site.endsWith(`.${value}`);
+}
+/** The http(s) sites open in a browser, grouped the way the dialog lists them. */
+export function groupSites(tabs) {
+    const sites = new Map();
+    for (const tab of tabs) {
+        let parsed;
+        try {
+            parsed = new URL(tab.url);
+        }
+        catch {
+            continue;
+        }
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
+            continue;
+        const site = normalizeSite(parsed.hostname);
+        if (!site)
+            continue;
+        const existing = sites.get(site);
+        if (existing) {
+            existing.tabs++;
+            continue;
+        }
+        sites.set(site, { site, url: parsed.href, ...(tab.title ? { title: tab.title } : {}), tabs: 1 });
+    }
+    return [...sites.values()];
+}
+/** Which browser the extension lives in, for the dialog. Older extensions cannot say. */
+export async function externalBrowserName(target) {
+    const described = await target.describe?.().catch(() => undefined);
+    return described?.name || "Chrome";
+}
+async function tabInfos(target) {
+    if (target.pageInfos)
+        return target.pageInfos();
+    const pages = await target.pages();
+    return Promise.all(pages.map(async (page) => ({ id: page.id, url: await evaluateString(page, "location.href") })));
+}
+export async function listExternalSites(target) {
+    return groupSites(await tabInfos(target));
+}
+/**
+ * Read one site's cookies and localStorage from the external browser.
+ *
+ * Cookies come from the browser-wide store, so any attached tab can answer;
+ * localStorage only exists inside a page of its own origin, so it is read from
+ * the site's open tabs and is simply absent for a site with none.
+ */
+export async function readSiteLoginState(target, site) {
+    const infos = await tabInfos(target);
+    const web = infos.filter((info) => /^https?:/i.test(info.url));
+    const matching = web.filter((info) => {
+        try {
+            return hostInSite(new URL(info.url).hostname, site);
+        }
+        catch {
+            return false;
+        }
+    });
+    const reader = matching[0] ?? web[0];
+    if (!reader)
+        throw new BrowserError(`open ${site} in your browser first, so its sign-in can be read`);
+    const readerPage = await pageFor(target, reader.id);
+    if (!readerPage)
+        throw new BrowserError("the browser tab closed before it could be read");
+    const cookies = (await readCookies(readerPage, matching.map((info) => info.url).concat(`https://${site}/`, `http://${site}/`)))
+        .filter((cookie) => typeof cookie["domain"] === "string" && cookieInSite(cookie["domain"], site))
+        .flatMap((cookie) => {
+        const param = cookieParam(cookie);
+        return param ? [param] : [];
+    });
+    const origins = [];
+    const seen = new Set();
+    let budget = LOCAL_STORAGE_LIMIT;
+    for (const info of matching) {
+        const origin = new URL(info.url).origin;
+        if (seen.has(origin))
+            continue;
+        seen.add(origin);
+        const page = info.id === reader.id ? readerPage : await pageFor(target, info.id);
+        if (!page)
+            continue;
+        const entries = await readLocalStorage(page).catch(() => []);
+        const kept = [];
+        for (const entry of entries) {
+            const size = entry[0].length + entry[1].length;
+            if (size > budget)
+                continue;
+            budget -= size;
+            kept.push(entry);
+        }
+        origins.push({ origin, url: info.url, localStorage: kept });
+    }
+    return { site, cookies, origins };
+}
+async function pageFor(target, id) {
+    if (target.pageById)
+        return target.pageById(id);
+    return (await target.pages()).find((page) => page.id === id);
+}
+async function readCookies(page, urls) {
+    const pick = (result) => Array.isArray(result["cookies"])
+        ? result["cookies"].filter((cookie) => typeof cookie === "object" && cookie !== null)
+        : [];
+    // Every cookie, so a subdomain's is not missed; the per-URL form is the
+    // fallback for a relay that refuses the browser-wide call.
+    try {
+        return pick(await page.send("Network.getAllCookies"));
+    }
+    catch {
+        return pick(await page.send("Network.getCookies", { urls: [...new Set(urls)] }));
+    }
+}
+async function readLocalStorage(page) {
+    const result = await page.send("Runtime.evaluate", {
+        expression: "JSON.stringify(Object.entries(localStorage))",
+        returnByValue: true,
+    });
+    const value = (result["result"] ?? {})["value"];
+    if (typeof value !== "string")
+        return [];
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed)
+        ? parsed.flatMap((entry) => Array.isArray(entry) && typeof entry[0] === "string" && typeof entry[1] === "string"
+            ? [[entry[0], entry[1]]]
+            : [])
+        : [];
+}
+async function evaluateString(page, expression) {
+    const result = await page.send("Runtime.evaluate", { expression, returnByValue: true });
+    return String((result["result"] ?? {})["value"] ?? "");
+}
+/**
+ * A read cookie, rewritten as one `Network.setCookies` will store identically.
+ *
+ * A host-only cookie is reported with a bare domain, and passing that back as
+ * `domain` would widen it to every subdomain (and make a `__Host-` cookie
+ * invalid). So host-only cookies are set by `url`, domain cookies by `domain`.
+ * Partitioning and source-port fields are left out: their shapes differ across
+ * Chromium versions, and the embedded one rejects what it does not know.
+ */
+export function cookieParam(cookie) {
+    const { name, value, domain } = cookie;
+    if (typeof name !== "string" || typeof value !== "string" || typeof domain !== "string" || !domain)
+        return undefined;
+    const cookiePath = typeof cookie["path"] === "string" && cookie["path"] ? cookie["path"] : "/";
+    const secure = cookie["secure"] === true;
+    const param = { name, value, path: cookiePath, secure };
+    if (domain.startsWith("."))
+        param["domain"] = domain;
+    else
+        param["url"] = `${secure ? "https" : "http"}://${domain}${cookiePath}`;
+    if (cookie["httpOnly"] === true)
+        param["httpOnly"] = true;
+    if (cookie["sameSite"] === "Strict" || cookie["sameSite"] === "Lax" || cookie["sameSite"] === "None") {
+        param["sameSite"] = cookie["sameSite"];
+    }
+    // A session cookie reads as -1; leaving `expires` out keeps it one.
+    if (cookie["session"] !== true && typeof cookie["expires"] === "number" && cookie["expires"] > 0) {
+        param["expires"] = cookie["expires"];
+    }
+    if (cookie["priority"] === "Low" || cookie["priority"] === "Medium" || cookie["priority"] === "High") {
+        param["priority"] = cookie["priority"];
+    }
+    return param;
+}
+/**
+ * Sites the person already answered for — imported, or told the suggestion to
+ * go away. The built-in profile is shared and persistent, so the answer is too:
+ * asking again in the next conversation would be asking the same question.
+ */
+export class LoginImportMemory {
+    file;
+    loaded;
+    constructor(file = userPath("browser-import.json")) {
+        this.file = file;
+    }
+    sites() {
+        this.loaded ??= readFile(this.file, "utf8")
+            .then((text) => {
+            const parsed = JSON.parse(text);
+            return new Set(Array.isArray(parsed.quiet) ? parsed.quiet.filter((site) => typeof site === "string") : []);
+        })
+            .catch(() => new Set());
+        return this.loaded;
+    }
+    async has(site) {
+        return (await this.sites()).has(site);
+    }
+    async add(site) {
+        const sites = await this.sites();
+        if (sites.has(site))
+            return;
+        sites.add(site);
+        await mkdir(path.dirname(this.file), { recursive: true });
+        await writeFile(this.file, `${JSON.stringify({ quiet: [...sites].sort() }, null, 2)}\n`, "utf8").catch(() => { });
+    }
+}
+//# sourceMappingURL=login-import.js.map

package/dist/browser/login-import.js.map

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

package/dist/browser/plugin.d.ts

@@ -0,0 +1,109 @@
+import type { Logger } from "../util/logger.ts";
+import type { Tool } from "../tools/types.ts";
+import type { BrowserSessionOptions } from "./session.ts";
+import type { BrowserProviderPlugin } from "./provider.ts";
+import type { ExternalSite, ImportedSite } from "./login-import.ts";
+import type { BrowserInputEvent, FrameOptions } from "./target.ts";
+/** Host-facing surface; custom feature plugins need not subclass BrowserSession. */
+export interface BrowserUseSession {
+    readonly running: boolean;
+    /** Called once when the eager tool façade is assigned to its first conversation. */
+    bind(sessionId: string): void;
+    state(): {
+        running: boolean;
+        origin?: string;
+        presentation?: "stream" | "native";
+        /** The browser in use now. */
+        mode?: "builtin" | "extension";
+        /** Which browsers the session may use. */
+        policy?: "auto" | "builtin" | "extension";
+    };
+    viewport(): Promise<{
+        width: number;
+        height: number;
+    } | undefined>;
+    url(): Promise<string>;
+    frames(opts?: FrameOptions): AsyncIterable<Buffer>;
+    forward(event: BrowserInputEvent): Promise<void>;
+    navigate(url: string): Promise<{
+        url: string;
+        status?: number;
+    }>;
+    reload(): Promise<{
+        url: string;
+    }>;
+    /** Tabs visible to the Browser pane. Optional for third-party feature plugins. */
+    paneTabs?(): Promise<Array<{
+        id: string;
+        url: string;
+        title?: string;
+        active: boolean;
+        mine?: false;
+    }>>;
+    /** Hand one of the person's own tabs to this conversation, at their request. */
+    adoptYourTab?(id: string): Promise<{
+        id: string;
+        url: string;
+    }>;
+    /** Make a tab the one used by both the tools and the Browser pane. */
+    selectPaneTab?(id: string): Promise<{
+        id: string;
+        url: string;
+    }>;
+    /** Close one tab, releasing the browser target when it was the last one. */
+    closePaneTab?(id: string): Promise<{
+        closed: string;
+        active?: string;
+        running: boolean;
+    }>;
+    close(): Promise<void>;
+    /** Name the conversation this browser works for; see BrowserTargetContext.label. */
+    setLabel?(label: () => string | undefined): void;
+    /** Move to the other browser; the next call opens it. Optional for third-party feature plugins. */
+    setMode?(mode: "auto" | "builtin" | "extension"): Promise<void>;
+    /** The external browser and the sites it has open. Lists tabs; attaches to none. */
+    loginImportSources?(): Promise<{
+        browser: string;
+        sites: ExternalSite[];
+        current?: string;
+    }>;
+    /** Person-confirmed only: copy these sites' sign-in into the built-in profile. */
+    importLogin?(sites: readonly string[]): Promise<{
+        browser: string;
+        imported: ImportedSite[];
+        migrated: boolean;
+        url?: string;
+    }>;
+    /** A site the built-in browser is on that the external browser has open too. Never blocks. */
+    loginImportSuggestion?(): {
+        site: string;
+        browser: string;
+    } | undefined;
+    dismissLoginImport?(site: string): Promise<void>;
+}
+export interface BrowserUseSessionContext {
+    sessionId?: string;
+    mode: "auto" | "builtin" | "extension";
+    logger?: Logger;
+    label?: () => string | undefined;
+    cwd?: string;
+}
+/**
+ * Complete project-level Browser Use feature plugin.
+ *
+ * This is not an agent-installed plugin. The Harness host loads one feature
+ * implementation, then asks it for a session and its tools. Keeping these two
+ * operations together means another implementation can replace the entire
+ * Browser Use stack rather than only swapping the browser executable.
+ */
+export interface BrowserUsePlugin {
+    readonly id: string;
+    createSession(context: BrowserUseSessionContext): BrowserUseSession;
+    tools(session: BrowserUseSession): Tool[];
+}
+export interface DefaultBrowserUsePluginOptions {
+    providers?: readonly BrowserProviderPlugin[];
+    /** Compatibility seam for older embedders and focused tests. */
+    target?: BrowserSessionOptions["target"];
+}
+export declare function createBrowserUsePlugin(opts?: DefaultBrowserUsePluginOptions): BrowserUsePlugin;

package/dist/browser/plugin.js

@@ -0,0 +1,22 @@
+import { BrowserSession } from "./session.js";
+import { createBrowserTools } from "./tools.js";
+export function createBrowserUsePlugin(opts = {}) {
+    return {
+        id: "browser-use",
+        createSession(context) {
+            const session = new BrowserSession({
+                ...(opts.target ? { target: opts.target } : {}),
+                ...(opts.providers ? { providers: opts.providers } : {}),
+                mode: context.mode,
+                ...(context.logger ? { logger: context.logger } : {}),
+                ...(context.label ? { label: context.label } : {}),
+                ...(context.cwd ? { cwd: context.cwd } : {}),
+            });
+            if (context.sessionId)
+                session.bind(context.sessionId);
+            return session;
+        },
+        tools: (session) => createBrowserTools(session),
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/browser/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/browser/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA2EhD,MAAM,UAAU,sBAAsB,CAAC,OAAuC,EAAE;IAC9E,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,aAAa,CAAC,OAAO;YACnB,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;gBACjC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAyB,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/browser/presence.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Telling the browser extension where this OHarness is.
+ *
+ * The extension's side panel shows this process's own page, which lives at a
+ * port chosen at startup and opens only with a token made for this run. The
+ * extension cannot find either on its own, and the token is never written to
+ * disk — so a server says where it is, over the same local socket the
+ * extension's native host already listens on, and the host tells the
+ * extension. Nothing here leaves the machine.
+ *
+ * The host exists only while the browser is open, and a new one starts each
+ * time the extension's worker restarts. So this keeps trying, on a backoff,
+ * and registers again with every host it reaches. None of it keeps the
+ * process alive: a server that is otherwise done exits whether or not a
+ * browser was ever there to hear about it.
+ */
+export interface PresenceInfo {
+    /** Where the page is, without the token. */
+    url: string;
+    token: string;
+    /** Which kind of OHarness, so the extension can prefer the desktop app. */
+    kind: "desktop" | "web";
+}
+export interface Presence {
+    close(): void;
+}
+export declare function announcePresence(info: PresenceInfo, opts?: {
+    socketPath?: string;
+}): Presence;

package/dist/browser/presence.js

@@ -0,0 +1,54 @@
+import { connect } from "node:net";
+import { extensionSocketPath } from "./socket.js";
+/** Seconds between attempts to reach a host: quick at first, patient after. */
+const BACKOFF = [1, 2, 5, 10, 30];
+export function announcePresence(info, opts = {}) {
+    const socketPath = opts.socketPath ?? extensionSocketPath();
+    let socket;
+    let timer;
+    let attempt = 0;
+    let closed = false;
+    const retry = () => {
+        if (closed || timer)
+            return;
+        const seconds = BACKOFF[Math.min(attempt, BACKOFF.length - 1)];
+        attempt += 1;
+        timer = setTimeout(() => {
+            timer = undefined;
+            open();
+        }, seconds * 1000);
+        timer.unref?.();
+    };
+    const open = () => {
+        if (closed)
+            return;
+        const current = connect(socketPath);
+        socket = current;
+        current.unref();
+        current.on("connect", () => {
+            attempt = 0;
+            current.write(`${JSON.stringify({ t: "register", pid: process.pid, ...info })}\n`);
+        });
+        // Replies and the other harnesses' traffic are none of this connection's
+        // business; reading them keeps the socket from backing up.
+        current.on("data", () => { });
+        current.on("error", () => { });
+        current.on("close", () => {
+            if (socket === current)
+                socket = undefined;
+            retry();
+        });
+    };
+    open();
+    return {
+        close() {
+            closed = true;
+            if (timer)
+                clearTimeout(timer);
+            timer = undefined;
+            socket?.destroy();
+            socket = undefined;
+        },
+    };
+}
+//# sourceMappingURL=presence.js.map

package/dist/browser/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/browser/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA+BlD,+EAA+E;AAC/E,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAElC,MAAM,UAAU,gBAAgB,CAAC,IAAkB,EAAE,OAAgC,EAAE;IACrF,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,mBAAmB,EAAE,CAAC;IAC5D,IAAI,MAA0B,CAAC;IAC/B,IAAI,KAAiC,CAAC;IACtC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,MAAM,IAAI,KAAK;YAAE,OAAO;QAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAE,CAAC;QAChE,OAAO,IAAI,CAAC,CAAC;QACb,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,SAAS,CAAC;YAClB,IAAI,EAAE,CAAC;QACT,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;QACnB,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,GAAG,OAAO,CAAC;QACjB,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,OAAO,GAAG,CAAC,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;QACH,yEAAyE;QACzE,2DAA2D;QAC3D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,MAAM,KAAK,OAAO;gBAAE,MAAM,GAAG,SAAS,CAAC;YAC3C,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,EAAE,CAAC;IACP,OAAO;QACL,KAAK;YACH,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,KAAK,GAAG,SAAS,CAAC;YAClB,MAAM,EAAE,OAAO,EAAE,CAAC;YAClB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/browser/provider.d.ts

@@ -0,0 +1,17 @@
+import type { BrowserTargetFactory } from "./target.ts";
+import type { Logger } from "../util/logger.ts";
+/** A replaceable browser runtime used by the Browser Use feature plugin. */
+export interface BrowserProviderPlugin {
+    readonly id: string;
+    readonly mode: "builtin" | "extension";
+    readonly createTarget: BrowserTargetFactory;
+}
+export declare function builtinBrowserProvider(opts?: {
+    headless?: boolean;
+    logger?: Logger;
+}): BrowserProviderPlugin;
+export declare function extensionBrowserProvider(): BrowserProviderPlugin;
+export declare function browserProviderFor(mode: "builtin" | "extension", providers?: readonly BrowserProviderPlugin[], opts?: {
+    headless?: boolean;
+    logger?: Logger;
+}): BrowserProviderPlugin;