@vymalo/opencode-browser 0.7.0

package/dist/protocol.js

@@ -0,0 +1,126 @@
+/**
+ * Wire protocol shared by the OpenCode plugin (the bridge **server**) and the
+ * browser extension (the **client**). This module is intentionally
+ * dependency-free and runtime-agnostic so the extension can mirror it verbatim
+ * into a browser bundle without pulling in any Bun/Node code.
+ *
+ * Canonical copy lives here (`packages/opencode-browser/src/protocol.ts`); the
+ * extension keeps a byte-for-byte copy at
+ * `apps/browser-extension/src/shared/protocol.ts`. Keep them in sync.
+ *
+ * Topology: extensions cannot host servers, so the plugin opens the WebSocket
+ * server on 127.0.0.1 and the extension's background worker dials out to it.
+ * The extension authenticates with a `hello`; the server replies `ready`. From
+ * then on the server issues `command` frames and the extension answers with a
+ * matching `result` frame (correlated by `id`). The extension may also push
+ * unsolicited `event` frames. Heartbeats use `ping`/`pong`.
+ */
+/** Bump when the frame shapes change incompatibly. */
+export const PROTOCOL_VERSION = 1;
+export const BROWSER_ACTIONS = [
+    "open",
+    "navigate",
+    "click",
+    "double_click",
+    "type",
+    "fill",
+    "select",
+    "scroll",
+    "press_key",
+    "screenshot",
+    "snapshot",
+    "get_text",
+    "wait",
+    "tabs",
+    "close",
+    "back",
+    "forward",
+    "reload",
+    "hover",
+    "activate",
+    "drag",
+    "upload",
+    "get_html",
+    "get_attribute",
+    "query",
+    "eval",
+    "console",
+    "network",
+    "handle_dialog",
+    "set_viewport",
+    "cookies",
+    "targets",
+    "release"
+];
+/** Serialize a frame for the wire. */
+export function encodeFrame(frame) {
+    return JSON.stringify(frame);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+/**
+ * Parse and shape-check an inbound frame. Returns the typed frame, or `null` if
+ * the payload is not a recognizable frame (caller decides whether to drop or
+ * log). Validation is deliberately lightweight — both ends are trusted once the
+ * token handshake succeeds; this guards against malformed JSON and version skew,
+ * not a hostile peer.
+ */
+export function decodeFrame(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed) || typeof parsed.type !== "string") {
+        return null;
+    }
+    switch (parsed.type) {
+        case "hello":
+            return typeof parsed.token === "string" ? parsed : null;
+        case "ready":
+            return parsed;
+        case "command":
+            return typeof parsed.id === "string" &&
+                typeof parsed.action === "string" &&
+                typeof parsed.group === "string"
+                ? parsed
+                : null;
+        case "result":
+            return typeof parsed.id === "string" && typeof parsed.ok === "boolean"
+                ? parsed
+                : null;
+        case "event":
+            return typeof parsed.name === "string" ? parsed : null;
+        case "release":
+            return { v: PROTOCOL_VERSION, type: "release" };
+        case "ping":
+            return { v: PROTOCOL_VERSION, type: "ping" };
+        case "pong":
+            return { v: PROTOCOL_VERSION, type: "pong" };
+        default:
+            return null;
+    }
+}
+let idCounter = 0;
+/**
+ * Monotonic correlation id for command frames. Process-local and collision-free
+ * within a single bridge instance, which is all that's required (the server is
+ * the only id minter).
+ */
+export function nextId() {
+    idCounter = (idCounter + 1) % Number.MAX_SAFE_INTEGER;
+    return `c${idCounter.toString(36)}`;
+}
+export function helloFrame(token, opts = {}) {
+    return { v: PROTOCOL_VERSION, type: "hello", token, ...opts };
+}
+export function resultFrame(id, data) {
+    return { v: PROTOCOL_VERSION, type: "result", id, ok: true, data };
+}
+export function errorFrame(id, message, code) {
+    return { v: PROTOCOL_VERSION, type: "result", id, ok: false, error: { message, code } };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A tiny, neutral schema vocabulary for tool arguments. The tool catalog
+ * (`catalog.ts`) is the single source of truth; each adapter turns these specs
+ * into its own format:
+ *   - the OpenCode plugin builds a zod shape (see `inputToZodShape` in tools.ts),
+ *   - the MCP server emits standard JSON Schema via `toJsonSchema` below.
+ *
+ * Keeping the vocabulary small (string/number/boolean/array/object + enum +
+ * optional + description) avoids dragging a specific zod version across the
+ * package boundary while still covering every tool's args.
+ */
+export type ToolGroup = "page" | "control" | "debug";
+export interface StringField {
+    type: "string";
+    description?: string;
+    optional?: boolean;
+    enum?: readonly string[];
+}
+export interface NumberField {
+    type: "number";
+    description?: string;
+    optional?: boolean;
+}
+export interface BooleanField {
+    type: "boolean";
+    description?: string;
+    optional?: boolean;
+}
+export interface ArrayField {
+    type: "array";
+    description?: string;
+    optional?: boolean;
+    items: Field;
+}
+export interface ObjectField {
+    type: "object";
+    description?: string;
+    optional?: boolean;
+    properties: Record<string, Field>;
+}
+export type Field = StringField | NumberField | BooleanField | ArrayField | ObjectField;
+/** Top-level argument map for a tool. */
+export type JsonInput = Record<string, Field>;
+export interface JsonSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: false;
+}
+/** Convert a tool's input spec to a standard JSON Schema object (for MCP). */
+export declare function toJsonSchema(input: JsonInput): JsonSchema;

package/dist/schema.js

@@ -0,0 +1,50 @@
+/**
+ * A tiny, neutral schema vocabulary for tool arguments. The tool catalog
+ * (`catalog.ts`) is the single source of truth; each adapter turns these specs
+ * into its own format:
+ *   - the OpenCode plugin builds a zod shape (see `inputToZodShape` in tools.ts),
+ *   - the MCP server emits standard JSON Schema via `toJsonSchema` below.
+ *
+ * Keeping the vocabulary small (string/number/boolean/array/object + enum +
+ * optional + description) avoids dragging a specific zod version across the
+ * package boundary while still covering every tool's args.
+ */
+function fieldToJsonSchema(field) {
+    const out = { type: field.type };
+    if (field.description) {
+        out.description = field.description;
+    }
+    if (field.type === "string" && field.enum) {
+        out.enum = [...field.enum];
+    }
+    if (field.type === "array") {
+        out.items = fieldToJsonSchema(field.items);
+    }
+    if (field.type === "object") {
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(field.properties)) {
+            properties[key] = fieldToJsonSchema(value);
+            if (!value.optional) {
+                required.push(key);
+            }
+        }
+        out.properties = properties;
+        out.required = required;
+        out.additionalProperties = false;
+    }
+    return out;
+}
+/** Convert a tool's input spec to a standard JSON Schema object (for MCP). */
+export function toJsonSchema(input) {
+    const properties = {};
+    const required = [];
+    for (const [key, field] of Object.entries(input)) {
+        properties[key] = fieldToJsonSchema(field);
+        if (!field.optional) {
+            required.push(key);
+        }
+    }
+    return { type: "object", properties, required, additionalProperties: false };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4CH,SAAS,iBAAiB,CAAC,KAAY;IACrC,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1C,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,UAAU,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;QAC5B,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxB,GAAG,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,UAAU,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;AAC/E,CAAC"}

package/dist/token-file.d.ts

@@ -0,0 +1,12 @@
+export interface BridgeFile {
+    port?: number;
+    token?: string;
+}
+export declare function readBridgeFile(): BridgeFile | null;
+export declare function writeBridgeFile(port: number, token: string): void;
+export type TokenSource = "explicit" | "file" | "generated";
+/** Resolve the bridge token: explicit option wins, else a shared file, else generate. */
+export declare function resolveSharedToken(port: number, explicit: string | undefined, generate: () => string): {
+    token: string;
+    source: TokenSource;
+};

package/dist/token-file.js

@@ -0,0 +1,40 @@
+import { chmodSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Per-user state file so multiple adapters (plugin + MCP server) on one machine
+ * share a bridge token without the operator wiring one up. Best-effort: a
+ * simultaneous cold start can race (each generates its own token before either
+ * writes); set an explicit token if you need that guaranteed. The extension
+ * still needs the token pasted into its dashboard.
+ */
+const FILE = join(tmpdir(), "opencode-browser-bridge.json");
+export function readBridgeFile() {
+    try {
+        return JSON.parse(readFileSync(FILE, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeBridgeFile(port, token) {
+    try {
+        writeFileSync(FILE, JSON.stringify({ port, token }), { mode: 0o600 });
+        chmodSync(FILE, 0o600);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/** Resolve the bridge token: explicit option wins, else a shared file, else generate. */
+export function resolveSharedToken(port, explicit, generate) {
+    if (explicit && explicit.length > 0) {
+        return { token: explicit, source: "explicit" };
+    }
+    const existing = readBridgeFile();
+    if (existing?.token && (existing.port === undefined || existing.port === port)) {
+        return { token: existing.token, source: "file" };
+    }
+    return { token: generate(), source: "generated" };
+}
+//# sourceMappingURL=token-file.js.map

package/dist/token-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-file.js","sourceRoot":"","sources":["../src/token-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,8BAA8B,CAAC,CAAC;AAO5D,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAID,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,QAA4B,EAC5B,QAAsB;IAEtB,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACpD,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,24 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { AgentEndpoint } from "./broker.js";
+import type { Logger } from "./logging.js";
+import type { ResolvedBrowserOptions, ScreenshotResult } from "./types.js";
+/** How a tool reaches the bridge — the endpoint's `send` (host or guest). */
+export type SendFn = AgentEndpoint["send"];
+/** Where the screenshot tool gets its disk-write behavior; swappable in tests. */
+export type SaveScreenshot = (input: {
+    group: string;
+    worktree: string;
+    shot: ScreenshotResult;
+}) => Promise<string>;
+export interface ToolDeps {
+    send: SendFn;
+    options: ResolvedBrowserOptions;
+    logger: Logger;
+    saveScreenshot?: SaveScreenshot;
+}
+/**
+ * Build the `browser_*` tool map registered under `Hooks.tool`, filtered to the
+ * enabled groups. Each tool is a thin adapter over the shared catalog: validate
+ * args (zod), forward to the bridge, render the neutral result.
+ */
+export declare function createBrowserTools(deps: ToolDeps): Record<string, ToolDefinition>;

package/dist/tools.js

@@ -0,0 +1,140 @@
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import { tool } from "@opencode-ai/plugin";
+import { BROWSER_TOOLS } from "./catalog.js";
+const z = tool.schema;
+function asRecord(value) {
+    return typeof value === "object" && value !== null ? value : {};
+}
+/**
+ * Replace anything that isn't filesystem-friendly so a group name is path-safe.
+ * Dots are intentionally NOT allowed — otherwise a group like `..` or `a/../b`
+ * could traverse out of the screenshot directory.
+ */
+function slugifyGroup(group) {
+    const slug = group.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+    return slug.length > 0 ? slug : "default";
+}
+/** Build the real disk-writer bound to the resolved screenshot directory. */
+function makeSaveScreenshot(options) {
+    return async ({ group, worktree, shot }) => {
+        const base = isAbsolute(options.screenshotDir)
+            ? options.screenshotDir
+            : join(worktree, options.screenshotDir);
+        const dir = join(base, slugifyGroup(group));
+        await mkdir(dir, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const finalPath = join(dir, `${stamp}.png`);
+        const tmpPath = `${finalPath}.tmp`;
+        await writeFile(tmpPath, Buffer.from(shot.base64, "base64"), { mode: 0o600 });
+        await rename(tmpPath, finalPath);
+        return finalPath;
+    };
+}
+function fieldToZod(field) {
+    let schema;
+    switch (field.type) {
+        case "string":
+            schema = (field.enum
+                ? z.enum(field.enum)
+                : z.string());
+            break;
+        case "number":
+            schema = z.number();
+            break;
+        case "boolean":
+            schema = z.boolean();
+            break;
+        case "array":
+            schema = z.array(fieldToZod(field.items));
+            break;
+        case "object":
+            schema = z.object(buildShape(field.properties));
+            break;
+    }
+    if (field.description) {
+        schema = schema.describe(field.description);
+    }
+    if (field.optional) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+function buildShape(input) {
+    const shape = {};
+    for (const [key, field] of Object.entries(input)) {
+        shape[key] = fieldToZod(field);
+    }
+    return shape;
+}
+/** Render an adapter-neutral result into OpenCode's text-only ToolResult. */
+async function renderOpenCode(result, deps) {
+    if (result.kind === "text") {
+        return result.text;
+    }
+    if (result.kind === "json") {
+        return { output: result.text, metadata: asRecord(result.data) };
+    }
+    // image → write the PNG to disk and hand back the path (tool output is text).
+    const path = await deps.saveScreenshot({
+        group: deps.group,
+        worktree: deps.worktree,
+        shot: {
+            base64: result.base64,
+            width: result.width,
+            height: result.height,
+            partial: result.partial
+        }
+    });
+    deps.logger.info("browser_screenshot_saved", { group: deps.group, path });
+    const partialNote = result.partial
+        ? " Note: only the viewport was captured — this executor can't capture beyond it."
+        : "";
+    return {
+        output: `Saved screenshot to ${path} (${result.width}×${result.height}). Use the read tool to view it.${partialNote}`,
+        metadata: {
+            path,
+            width: result.width,
+            height: result.height,
+            partial: Boolean(result.partial),
+            group: deps.group
+        }
+    };
+}
+/**
+ * Build the `browser_*` tool map registered under `Hooks.tool`, filtered to the
+ * enabled groups. Each tool is a thin adapter over the shared catalog: validate
+ * args (zod), forward to the bridge, render the neutral result.
+ */
+export function createBrowserTools(deps) {
+    const enabled = new Set(deps.options.groups);
+    const saveScreenshot = deps.saveScreenshot ?? makeSaveScreenshot(deps.options);
+    const tools = {};
+    for (const spec of BROWSER_TOOLS) {
+        if (!enabled.has(spec.group)) {
+            continue;
+        }
+        const definition = {
+            description: spec.description,
+            args: buildShape(spec.input),
+            async execute(args, ctx) {
+                const group = typeof args.group === "string" ? args.group : "";
+                const target = typeof args.target === "string" ? args.target : undefined;
+                const params = spec.params ? spec.params(args) : args;
+                const data = await deps.send(spec.action, group, params, ctx.abort, target);
+                const result = spec.result
+                    ? spec.result(data, args)
+                    : { kind: "text", text: `${spec.name} ok` };
+                return renderOpenCode(result, {
+                    group,
+                    worktree: ctx.worktree,
+                    saveScreenshot,
+                    logger: deps.logger
+                });
+            }
+        };
+        tools[spec.name] = definition;
+    }
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The transport seam for the bridge/broker. The real implementation wraps
+ * `Bun.serve`'s WebSocket support; the MCP server provides a Node `ws` variant;
+ * tests inject a fake. `listen` is **async** and resolves only once the port is
+ * actually bound (and rejects on `EADDRINUSE`) — that's what the broker election
+ * relies on to decide host-vs-guest.
+ */
+/** A single connected client (an extension executor or an agent). */
+export interface ClientConnection {
+    send(data: string): void;
+    close(): void;
+}
+export interface TransportHandlers {
+    onOpen(conn: ClientConnection): void;
+    onMessage(conn: ClientConnection, data: string): void;
+    onClose(conn: ClientConnection): void;
+}
+export interface BridgeTransport {
+    /** Bind + start listening. Resolves when bound; rejects on bind failure. */
+    listen(opts: {
+        host: string;
+        port: number;
+    }, handlers: TransportHandlers): Promise<void>;
+    stop(): void;
+}
+/** True for an "address already in use" style bind error (→ become a guest). */
+export declare function isAddrInUse(err: unknown): boolean;
+/**
+ * Real transport backed by `Bun.serve` — the production path inside OpenCode
+ * (which runs on Bun). Throws if invoked outside Bun.
+ */
+export declare function createBunTransport(): BridgeTransport;

package/dist/transport.js

@@ -0,0 +1,71 @@
+/**
+ * The transport seam for the bridge/broker. The real implementation wraps
+ * `Bun.serve`'s WebSocket support; the MCP server provides a Node `ws` variant;
+ * tests inject a fake. `listen` is **async** and resolves only once the port is
+ * actually bound (and rejects on `EADDRINUSE`) — that's what the broker election
+ * relies on to decide host-vs-guest.
+ */
+/** True for an "address already in use" style bind error (→ become a guest). */
+export function isAddrInUse(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return /eaddrinuse|address already in use|in use/i.test(msg);
+}
+/**
+ * Real transport backed by `Bun.serve` — the production path inside OpenCode
+ * (which runs on Bun). Throws if invoked outside Bun.
+ */
+export function createBunTransport() {
+    const bun = globalThis.Bun;
+    if (!bun) {
+        throw new Error("the opencode-browser bridge requires the Bun runtime (Bun.serve not found)");
+    }
+    let server = null;
+    const conns = new WeakMap();
+    return {
+        listen({ host, port }, handlers) {
+            return new Promise((resolve, reject) => {
+                try {
+                    server = bun.serve({
+                        hostname: host,
+                        port,
+                        fetch(req, srv) {
+                            if (srv.upgrade(req)) {
+                                return undefined;
+                            }
+                            return new Response("opencode-browser bridge: websocket only", { status: 426 });
+                        },
+                        websocket: {
+                            open(ws) {
+                                const conn = { send: (d) => ws.send(d), close: () => ws.close() };
+                                conns.set(ws, conn);
+                                handlers.onOpen(conn);
+                            },
+                            message(ws, message) {
+                                const conn = conns.get(ws);
+                                if (conn) {
+                                    handlers.onMessage(conn, typeof message === "string" ? message : Buffer.from(message).toString());
+                                }
+                            },
+                            close(ws) {
+                                const conn = conns.get(ws);
+                                conns.delete(ws);
+                                if (conn) {
+                                    handlers.onClose(conn);
+                                }
+                            }
+                        }
+                    });
+                    resolve(); // Bun.serve throws synchronously on EADDRINUSE; reaching here = bound.
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        },
+        stop() {
+            server?.stop(true);
+            server = null;
+        }
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/D,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAI,UAAgC,CAAC,GAAG,CAAC;IAClD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,MAAM,GAAiD,IAAI,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,OAAO,EAA4B,CAAC;IAEtD,OAAO;QACL,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ;YAC7B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;wBACjB,QAAQ,EAAE,IAAI;wBACd,IAAI;wBACJ,KAAK,CAAC,GAAY,EAAE,GAAuC;4BACzD,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gCACrB,OAAO,SAAS,CAAC;4BACnB,CAAC;4BACD,OAAO,IAAI,QAAQ,CAAC,yCAAyC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;wBAClF,CAAC;wBACD,SAAS,EAAE;4BACT,IAAI,CAAC,EAAgB;gCACnB,MAAM,IAAI,GAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;gCACpF,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gCACpB,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;4BACxB,CAAC;4BACD,OAAO,CAAC,EAAgB,EAAE,OAAiC;gCACzD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gCAC3B,IAAI,IAAI,EAAE,CAAC;oCACT,QAAQ,CAAC,SAAS,CAChB,IAAI,EACJ,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CACxE,CAAC;gCACJ,CAAC;4BACH,CAAC;4BACD,KAAK,CAAC,EAAgB;gCACpB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gCAC3B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gCACjB,IAAI,IAAI,EAAE,CAAC;oCACT,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gCACzB,CAAC;4BACH,CAAC;yBACF;qBACF,CAAC,CAAC;oBACH,OAAO,EAAE,CAAC,CAAC,uEAAuE;gBACpF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI;YACF,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+import type { ToolGroup } from "./schema.js";
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export type { ToolGroup } from "./schema.js";
+/**
+ * How the extension should drive the page. Mirrored into the extension, which
+ * is where it actually takes effect; the plugin only forwards the preference so
+ * the extension can default sensibly when its own setting is unset.
+ *
+ * - `"auto"`    — CDP (chrome.debugger) on Chromium when permitted, else content-script.
+ * - `"cdp"`     — force the Chrome DevTools Protocol executor (Chromium only).
+ * - `"content"` — force synthetic-event content-script executor (works on Firefox).
+ */
+export type ExecutorMode = "auto" | "cdp" | "content";
+/**
+ * Per-plugin configuration, supplied as the second argument to the plugin
+ * factory by OpenCode (the `[name, options]` tuple form in `plugin`). All
+ * fields are optional; see DEFAULT_OPTIONS for the resolved defaults.
+ */
+export interface BrowserPluginOptions {
+    /** Master switch. When false the bridge never starts and tools no-op-error. */
+    enabled?: boolean;
+    /** Interface to bind. Keep it loopback unless you really mean it. */
+    host?: string;
+    /** TCP port for the WebSocket bridge. */
+    port?: number;
+    /**
+     * Shared secret the extension must present. If omitted, a random token is
+     * generated at startup and logged once so it can be pasted into the extension.
+     */
+    token?: string;
+    /** Forwarded executor preference (see ExecutorMode). */
+    executor?: ExecutorMode;
+    /**
+     * Which tool groups to register: `page` (observe), `control` (drive),
+     * `debug` (powerful/sensitive). Defaults to `["page","control"]` — `debug`
+     * is opt-in. Per-agent control is also possible via OpenCode's tool
+     * allow/deny on the `browser_*` names.
+     */
+    groups?: ToolGroup[];
+    /** Per-command timeout in ms before the tool call rejects. */
+    timeoutMs?: number;
+    /**
+     * Directory screenshots are written to. Relative paths resolve against the
+     * session worktree. Defaults to `.opencode/browser` under the worktree.
+     */
+    screenshotDir?: string;
+}
+/** Fully-resolved options with defaults applied. */
+export interface ResolvedBrowserOptions {
+    enabled: boolean;
+    host: string;
+    port: number;
+    token: string;
+    executor: ExecutorMode;
+    groups: ToolGroup[];
+    timeoutMs: number;
+    screenshotDir: string;
+}
+/**
+ * Shape the extension returns for a `screenshot` command. The PNG travels as
+ * base64 (no binary frames over the text protocol); the plugin decodes and
+ * writes it to disk.
+ */
+export interface ScreenshotResult {
+    /** Base64-encoded PNG bytes (no data: prefix). */
+    base64: string;
+    width: number;
+    height: number;
+    /**
+     * True when `fullPage` was requested but the executor could only capture the
+     * viewport (the content-script backend / Firefox can't capture beyond it).
+     */
+    partial?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map