@different-ai/opencode-browser 4.5.1 → 4.6.1

package/bin/cli.js

@@ -21,12 +21,12 @@ import {
   unlinkSync,
   chmodSync,
 } from "fs";
-import { homedir, platform } from "os";
+import { homedir, platform, userInfo } from "os";
 import { join, dirname } from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath, pathToFileURL } from "url";
 import { createInterface } from "readline";
 import { createConnection } from "net";
-import { execSync, spawn } from "child_process";
+import { execSync, spawn, spawnSync } from "child_process";
 import { createHash } from "crypto";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -38,11 +38,15 @@ const EXTENSION_DIR = join(BASE_DIR, "extension");
 const EXTENSION_MANIFEST_PATH = join(PACKAGE_ROOT, "extension", "manifest.json");
 const BROKER_DST = join(BASE_DIR, "broker.cjs");
 const NATIVE_HOST_DST = join(BASE_DIR, "native-host.cjs");
-const NATIVE_HOST_WRAPPER = join(BASE_DIR, "host-wrapper.sh");
 const CONFIG_DST = join(BASE_DIR, "config.json");
-const BROKER_SOCKET = join(BASE_DIR, "broker.sock");
 
 const NATIVE_HOST_NAME = "com.opencode.browser_automation";
+const OS_NAME = platform();
+const NATIVE_HOST_WRAPPER = join(
+  BASE_DIR,
+  OS_NAME === "win32" ? "host-wrapper.cmd" : "host-wrapper.sh"
+);
+const BROKER_SOCKET = getBrokerSocketPath();
 
 const COLORS = {
   reset: "\x1b[0m",
@@ -57,6 +61,56 @@ function color(c, text) {
   return `${COLORS[c]}${text}${COLORS.reset}`;
 }
 
+function isWindows() {
+  return OS_NAME === "win32";
+}
+
+function getSafePipeName() {
+  try {
+    const username = userInfo().username || "user";
+    return `opencode-browser-${username}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+  } catch {
+    return "opencode-browser";
+  }
+}
+
+function getBrokerSocketPath() {
+  const override = process.env.OPENCODE_BROWSER_BROKER_SOCKET;
+  if (override) return override;
+  if (OS_NAME === "win32") return `\\\\.\\pipe\\${getSafePipeName()}`;
+  return join(BASE_DIR, "broker.sock");
+}
+
+function getWindowsRegistryTargets() {
+  return [
+    { name: "Chrome", key: "HKCU\\Software\\Google\\Chrome\\NativeMessagingHosts" },
+    { name: "Chromium", key: "HKCU\\Software\\Chromium\\NativeMessagingHosts" },
+    { name: "Brave", key: "HKCU\\Software\\BraveSoftware\\Brave-Browser\\NativeMessagingHosts" },
+    { name: "Edge", key: "HKCU\\Software\\Microsoft\\Edge\\NativeMessagingHosts" },
+  ];
+}
+
+function runRegCommand(args) {
+  try {
+    const result = spawnSync("reg", args, { stdio: "ignore" });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+function queryRegistryDefaultValue(key) {
+  try {
+    const result = spawnSync("reg", ["query", key, "/ve"], { encoding: "utf8" });
+    if (result.status !== 0) return null;
+    const output = String(result.stdout || "");
+    const match = output.match(/REG_SZ\s+(.+)\s*$/m);
+    return match ? match[1].trim() : null;
+  } catch {
+    return null;
+  }
+}
+
 function log(msg) {
   console.log(msg);
 }
@@ -180,7 +234,8 @@ function resolveNodePath() {
   if (process.env.OPENCODE_BROWSER_NODE) return process.env.OPENCODE_BROWSER_NODE;
   if (process.execPath && /node(\.exe)?$/.test(process.execPath)) return process.execPath;
   try {
-    const output = execSync("which node", { stdio: ["ignore", "pipe", "ignore"] })
+    const command = isWindows() ? "where node" : "which node";
+    const output = execSync(command, { stdio: ["ignore", "pipe", "ignore"] })
       .toString("utf8")
       .trim();
     if (output) return output;
@@ -190,6 +245,11 @@ function resolveNodePath() {
 
 function writeHostWrapper(nodePath) {
   ensureDir(BASE_DIR);
+  if (isWindows()) {
+    const script = `@echo off\r\n"${nodePath}" "${NATIVE_HOST_DST}"\r\n`;
+    writeFileSync(NATIVE_HOST_WRAPPER, script);
+    return NATIVE_HOST_WRAPPER;
+  }
   const script = `#!/bin/sh\n"${nodePath}" "${NATIVE_HOST_DST}"\n`;
   writeFileSync(NATIVE_HOST_WRAPPER, script, { mode: 0o755 });
   chmodSync(NATIVE_HOST_WRAPPER, 0o755);
@@ -276,6 +336,7 @@ function copyDirRecursive(srcDir, destDir) {
 }
 
 function getNativeHostDirs(osName) {
+  if (osName === "win32") return [];
   if (osName === "darwin") {
     const base = join(homedir(), "Library", "Application Support");
     return [
@@ -312,6 +373,58 @@ function writeNativeHostManifest(dir, extensionId, hostPath) {
   writeFileSync(nativeHostManifestPath(dir), JSON.stringify(manifest, null, 2) + "\n");
 }
 
+function writeWindowsNativeHostManifest(extensionId, hostPath) {
+  const manifestPath = nativeHostManifestPath(BASE_DIR);
+  writeNativeHostManifest(BASE_DIR, extensionId, hostPath);
+  return manifestPath;
+}
+
+function registerWindowsNativeHost(manifestPath) {
+  for (const target of getWindowsRegistryTargets()) {
+    const key = `${target.key}\\${NATIVE_HOST_NAME}`;
+    const ok = runRegCommand(["add", key, "/ve", "/t", "REG_SZ", "/d", manifestPath, "/f"]);
+    if (ok) {
+      success(`Registered native host for ${target.name}: ${key}`);
+    } else {
+      warn(`Could not register native host for ${target.name}: ${key}`);
+    }
+  }
+}
+
+function unregisterWindowsNativeHost() {
+  for (const target of getWindowsRegistryTargets()) {
+    const key = `${target.key}\\${NATIVE_HOST_NAME}`;
+    const ok = runRegCommand(["delete", key, "/f"]);
+    if (ok) {
+      success(`Removed native host registry: ${key}`);
+    } else {
+      warn(`Could not remove native host registry: ${key}`);
+    }
+  }
+}
+
+function reportWindowsNativeHostStatus() {
+  const manifestPath = nativeHostManifestPath(BASE_DIR);
+  if (existsSync(manifestPath)) {
+    success(`Native host manifest: ${manifestPath}`);
+  } else {
+    warn(`Native host manifest missing: ${manifestPath}`);
+  }
+
+  let foundAny = false;
+  for (const target of getWindowsRegistryTargets()) {
+    const key = `${target.key}\\${NATIVE_HOST_NAME}`;
+    const value = queryRegistryDefaultValue(key);
+    if (value) {
+      foundAny = true;
+      success(`Registry (${target.name}): ${key}`);
+    }
+  }
+  if (!foundAny) {
+    warn("No native host registry entries found. Run: npx @different-ai/opencode-browser install");
+  }
+}
+
 function loadConfig() {
   try {
     if (!existsSync(CONFIG_DST)) return null;
@@ -326,6 +439,179 @@ function saveConfig(config) {
   writeFileSync(CONFIG_DST, JSON.stringify(config, null, 2) + "\n");
 }
 
+async function loadPluginTools() {
+  const pluginPath = join(PACKAGE_ROOT, "dist", "plugin.js");
+  if (!existsSync(pluginPath)) {
+    throw new Error("dist/plugin.js is missing. Run `bun run build` first.");
+  }
+
+  const mod = await import(pathToFileURL(pluginPath).href);
+  const factory = mod?.default;
+  if (typeof factory !== "function") {
+    throw new Error("Could not load plugin factory from dist/plugin.js");
+  }
+
+  const pluginInstance = await factory({});
+  const tools = pluginInstance?.tool;
+  if (!tools || typeof tools !== "object") {
+    throw new Error("Plugin did not expose any tools");
+  }
+  return tools;
+}
+
+function parseJsonArg(raw, fallback = {}) {
+  if (!raw) return fallback;
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`Expected JSON args. Received: ${raw}`);
+  }
+}
+
+function parseMaybeJson(value) {
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (!trimmed) return value;
+  if (!["{", "[", '"'].includes(trimmed[0])) return value;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return value;
+  }
+}
+
+function getToolArgJson() {
+  const byFlag = getFlagValue("--args");
+  if (byFlag != null) return byFlag;
+  return process.argv[4] || null;
+}
+
+async function executeTool(toolName, args = {}) {
+  const tools = await loadPluginTools();
+  const tool = tools?.[toolName];
+  if (!tool || typeof tool.execute !== "function") {
+    const available = Object.keys(tools || {})
+      .sort()
+      .join(", ");
+    throw new Error(`Unknown tool: ${toolName}. Available: ${available}`);
+  }
+
+  return await tool.execute(args, {});
+}
+
+async function listTools() {
+  header("Browser Tools");
+  const tools = await loadPluginTools();
+  const names = Object.keys(tools).sort();
+  if (!names.length) {
+    warn("No tools found in plugin.");
+    return;
+  }
+
+  log(`Found ${names.length} tools:\n`);
+  for (const name of names) {
+    const description = tools[name]?.description || "(no description)";
+    log(`- ${name}: ${description}`);
+  }
+}
+
+async function runToolCommand() {
+  const toolName = process.argv[3];
+  if (!toolName) {
+    throw new Error("Usage: npx @different-ai/opencode-browser tool <toolName> [argsJson]");
+  }
+
+  const args = parseJsonArg(getToolArgJson(), {});
+  const result = await executeTool(toolName, args);
+
+  if (typeof result === "string") {
+    log(result);
+    return;
+  }
+  log(JSON.stringify(result, null, 2));
+}
+
+function asNumber(value, fallback = 0) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : fallback;
+}
+
+function readTabId(value) {
+  const parsed = parseMaybeJson(value);
+  if (parsed && Number.isFinite(parsed.tabId)) return parsed.tabId;
+  if (parsed?.content && Number.isFinite(parsed.content.tabId)) return parsed.content.tabId;
+  return null;
+}
+
+async function selfTest() {
+  header("CLI Self-Test");
+  log("Running extension-backed smoke test via plugin tools...");
+
+  const statusRaw = await executeTool("browser_status", {});
+  const status = parseMaybeJson(statusRaw);
+  if (!status || status.broker !== true || status.hostConnected !== true) {
+    throw new Error(
+      "browser_status indicates the extension is not connected. Run `npx @different-ai/opencode-browser install` and click the extension icon in Chrome."
+    );
+  }
+
+  const fixtureUrl = "https://www.w3.org/WAI/ARIA/apg/patterns/listbox/examples/listbox-scrollable/";
+  const openRaw = await executeTool("browser_open_tab", { url: fixtureUrl, active: false });
+  const tabId = readTabId(openRaw);
+  if (!Number.isFinite(tabId)) {
+    throw new Error("Failed to read tabId from browser_open_tab output");
+  }
+  await executeTool("browser_wait", { ms: 250 });
+
+  const beforeRaw = await executeTool("browser_query", {
+    selector: "[role='listbox']",
+    mode: "property",
+    property: "scrollTop",
+    tabId,
+  });
+  const before = asNumber(parseMaybeJson(beforeRaw)?.value, 0);
+
+  await executeTool("browser_click", {
+    selector: "text:Neptunium",
+    tabId,
+    timeoutMs: 3000,
+    pollMs: 150,
+  });
+
+  const selectedRaw = await executeTool("browser_query", {
+    selector: "[aria-selected='true']",
+    mode: "text",
+    tabId,
+  });
+  const selectedText = String(parseMaybeJson(selectedRaw) || "");
+  if (!selectedText.toLowerCase().includes("neptunium")) {
+    throw new Error(`Click verification failed. Expected selected text to include Neptunium, got: ${selectedText}`);
+  }
+
+  await executeTool("browser_scroll", {
+    selector: "[role='listbox']",
+    y: 320,
+    tabId,
+    timeoutMs: 2000,
+    pollMs: 100,
+  });
+  await executeTool("browser_wait", { ms: 250 });
+
+  const afterRaw = await executeTool("browser_query", {
+    selector: "[role='listbox']",
+    mode: "property",
+    property: "scrollTop",
+    tabId,
+  });
+  const after = asNumber(parseMaybeJson(afterRaw)?.value, 0);
+
+  if (after <= before) {
+    throw new Error(`Scroll verification failed. Expected scrollTop to increase (before=${before}, after=${after}).`);
+  }
+
+  success("Self-test passed: click + selector text + container scroll are working.");
+}
+
 async function main() {
   const command = process.argv[2];
 
@@ -338,6 +624,12 @@ ${color("cyan", "Browser automation plugin (native messaging + per-tab ownership
     await install();
   } else if (command === "update") {
     await update();
+  } else if (command === "tools") {
+    await listTools();
+  } else if (command === "tool") {
+    await runToolCommand();
+  } else if (command === "self-test") {
+    await selfTest();
   } else if (command === "uninstall") {
     await uninstall();
   } else if (command === "status") {
@@ -353,11 +645,15 @@ ${color("bright", "Usage:")}
   npx @different-ai/opencode-browser update
   npx @different-ai/opencode-browser status
   npx @different-ai/opencode-browser uninstall
+  npx @different-ai/opencode-browser tools
+  npx @different-ai/opencode-browser tool <toolName> [argsJson]
+  npx @different-ai/opencode-browser self-test
   npx @different-ai/opencode-browser agent-install
   npx @different-ai/opencode-browser agent-gateway
 
 ${color("bright", "Options:")}
   --extension-id <id> (or OPENCODE_BROWSER_EXTENSION_ID)
+  --args '{"selector":"text:Inbox"}' (for tool command)
 
 ${color("bright", "Quick Start:")}
   1. Run: npx @different-ai/opencode-browser install
@@ -372,18 +668,19 @@ ${color("bright", "Agent Mode:")}
   }
 
   rl.close();
+  process.exit(0);
 }
 
 async function install() {
   header("Step 1: Check Platform");
 
-  const osName = platform();
-  if (osName !== "darwin" && osName !== "linux") {
+  const osName = OS_NAME;
+  if (osName !== "darwin" && osName !== "linux" && osName !== "win32") {
     error(`Unsupported platform: ${osName}`);
-    error("OpenCode Browser currently supports macOS and Linux only.");
+    error("OpenCode Browser currently supports macOS, Linux, and Windows only.");
     process.exit(1);
   }
-  success(`Platform: ${osName === "darwin" ? "macOS" : "Linux"}`);
+  success(`Platform: ${osName === "darwin" ? "macOS" : osName === "win32" ? "Windows" : "Linux"}`);
 
   header("Step 2: Copy Extension Files");
 
@@ -472,13 +769,19 @@ Find it at ${color("cyan", "chrome://extensions")}:
 
   header("Step 6: Register Native Messaging Host");
 
-  const hostDirs = getNativeHostDirs(osName);
-  for (const dir of hostDirs) {
-    try {
-      writeNativeHostManifest(dir, extensionId, hostPath);
-      success(`Wrote native host manifest: ${nativeHostManifestPath(dir)}`);
-    } catch (e) {
-      warn(`Could not write native host manifest to: ${dir}`);
+  if (osName === "win32") {
+    const manifestPath = writeWindowsNativeHostManifest(extensionId, hostPath);
+    success(`Wrote native host manifest: ${manifestPath}`);
+    registerWindowsNativeHost(manifestPath);
+  } else {
+    const hostDirs = getNativeHostDirs(osName);
+    for (const dir of hostDirs) {
+      try {
+        writeNativeHostManifest(dir, extensionId, hostPath);
+        success(`Wrote native host manifest: ${nativeHostManifestPath(dir)}`);
+      } catch (e) {
+        warn(`Could not write native host manifest to: ${dir}`);
+      }
     }
   }
 
@@ -509,9 +812,13 @@ Find it at ${color("cyan", "chrome://extensions")}:
     return jsonPath;
   }
 
+  const globalConfigLabel =
+    osName === "win32"
+      ? "2) Global (%USERPROFILE%\\.config\\opencode\\opencode.json)"
+      : "2) Global (~/.config/opencode/opencode.json)";
   const configOptions = [
     "1) Project (./opencode.json or opencode.jsonc)",
-    "2) Global (~/.config/opencode/opencode.json)",
+    globalConfigLabel,
     "3) Custom path",
     "4) Skip (does nothing)",
   ];
@@ -526,8 +833,12 @@ Find it at ${color("cyan", "chrome://extensions")}:
     configDir = process.cwd();
     configPath = findOpenCodeConfigPath(configDir);
   } else if (selection === "2") {
-    const xdgConfig = process.env.XDG_CONFIG_HOME;
-    configDir = xdgConfig ? join(xdgConfig, "opencode") : join(homedir(), ".config", "opencode");
+    if (osName === "win32") {
+      configDir = join(homedir(), ".config", "opencode");
+    } else {
+      const xdgConfig = process.env.XDG_CONFIG_HOME;
+      configDir = xdgConfig ? join(xdgConfig, "opencode") : join(homedir(), ".config", "opencode");
+    }
     configPath = findOpenCodeConfigPath(configDir);
   } else if (selection === "3") {
     const customPath = await ask("Enter full path to opencode.json or opencode.jsonc: ");
@@ -660,13 +971,13 @@ Open Chrome and:
 async function update() {
   header("Update: Check Platform");
 
-  const osName = platform();
-  if (osName !== "darwin" && osName !== "linux") {
+  const osName = OS_NAME;
+  if (osName !== "darwin" && osName !== "linux" && osName !== "win32") {
     error(`Unsupported platform: ${osName}`);
-    error("OpenCode Browser currently supports macOS and Linux only.");
+    error("OpenCode Browser currently supports macOS, Linux, and Windows only.");
     process.exit(1);
   }
-  success(`Platform: ${osName === "darwin" ? "macOS" : "Linux"}`);
+  success(`Platform: ${osName === "darwin" ? "macOS" : osName === "win32" ? "Windows" : "Linux"}`);
 
   header("Step 1: Copy Extension Files");
 
@@ -743,13 +1054,19 @@ Find it at ${color("cyan", "chrome://extensions")}:
 
   header("Step 4: Register Native Messaging Host");
 
-  const hostDirs = getNativeHostDirs(osName);
-  for (const dir of hostDirs) {
-    try {
-      writeNativeHostManifest(dir, extensionId, hostPath);
-      success(`Wrote native host manifest: ${nativeHostManifestPath(dir)}`);
-    } catch {
-      warn(`Could not write native host manifest to: ${dir}`);
+  if (osName === "win32") {
+    const manifestPath = writeWindowsNativeHostManifest(extensionId, hostPath);
+    success(`Wrote native host manifest: ${manifestPath}`);
+    registerWindowsNativeHost(manifestPath);
+  } else {
+    const hostDirs = getNativeHostDirs(osName);
+    for (const dir of hostDirs) {
+      try {
+        writeNativeHostManifest(dir, extensionId, hostPath);
+        success(`Wrote native host manifest: ${nativeHostManifestPath(dir)}`);
+      } catch {
+        warn(`Could not write native host manifest to: ${dir}`);
+      }
     }
   }
 
@@ -770,6 +1087,7 @@ async function status() {
   success(`Broker installed: ${existsSync(BROKER_DST)}`);
   success(`Native host installed: ${existsSync(NATIVE_HOST_DST)}`);
   success(`Host wrapper installed: ${existsSync(NATIVE_HOST_WRAPPER)}`);
+  success(`Broker socket: ${BROKER_SOCKET}`);
 
   const cfg = loadConfig();
   if (cfg?.extensionId) {
@@ -787,18 +1105,29 @@ async function status() {
     success(`Node path: ${cfg.nodePath}`);
   }
 
-  const osName = platform();
-  const hostDirs = getNativeHostDirs(osName);
-  let foundAny = false;
-  for (const dir of hostDirs) {
-    const p = nativeHostManifestPath(dir);
-    if (existsSync(p)) {
-      foundAny = true;
-      success(`Native host manifest: ${p}`);
+  const osName = OS_NAME;
+  if (osName === "win32") {
+    reportWindowsNativeHostStatus();
+  } else {
+    const hostDirs = getNativeHostDirs(osName);
+    let foundAny = false;
+    for (const dir of hostDirs) {
+      const p = nativeHostManifestPath(dir);
+      if (existsSync(p)) {
+        foundAny = true;
+        success(`Native host manifest: ${p}`);
+      }
+    }
+    if (!foundAny) {
+      warn("No native host manifest found. Run: npx @different-ai/opencode-browser install");
     }
   }
-  if (!foundAny) {
-    warn("No native host manifest found. Run: npx @different-ai/opencode-browser install");
+
+  const brokerStatus = await getBrokerStatus(1000);
+  if (brokerStatus.ok) {
+    success(`Broker status: ok (hostConnected=${!!brokerStatus.data?.hostConnected})`);
+  } else {
+    warn(`Broker status: ${brokerStatus.error || "unavailable"}`);
   }
 }
 
@@ -830,20 +1159,34 @@ async function agentGateway() {
 async function uninstall() {
   header("Uninstall");
 
-  const osName = platform();
-  const hostDirs = getNativeHostDirs(osName);
-  for (const dir of hostDirs) {
-    const p = nativeHostManifestPath(dir);
-    if (!existsSync(p)) continue;
-    try {
-      unlinkSync(p);
-      success(`Removed native host manifest: ${p}`);
-    } catch {
-      warn(`Could not remove: ${p}`);
+  const osName = OS_NAME;
+  if (osName === "win32") {
+    unregisterWindowsNativeHost();
+    const manifestPath = nativeHostManifestPath(BASE_DIR);
+    if (existsSync(manifestPath)) {
+      try {
+        unlinkSync(manifestPath);
+        success(`Removed native host manifest: ${manifestPath}`);
+      } catch {
+        warn(`Could not remove: ${manifestPath}`);
+      }
+    }
+  } else {
+    const hostDirs = getNativeHostDirs(osName);
+    for (const dir of hostDirs) {
+      const p = nativeHostManifestPath(dir);
+      if (!existsSync(p)) continue;
+      try {
+        unlinkSync(p);
+        success(`Removed native host manifest: ${p}`);
+      } catch {
+        warn(`Could not remove: ${p}`);
+      }
     }
   }
 
-  for (const p of [BROKER_DST, NATIVE_HOST_DST, CONFIG_DST, join(BASE_DIR, "broker.sock")]) {
+  const unixSocketPath = join(BASE_DIR, "broker.sock");
+  for (const p of [BROKER_DST, NATIVE_HOST_DST, CONFIG_DST, unixSocketPath, BROKER_SOCKET]) {
     if (!existsSync(p)) continue;
     try {
       unlinkSync(p);

package/bin/native-host.cjs

@@ -11,9 +11,25 @@ const path = require("path");
 const { spawn } = require("child_process");
 
 const BASE_DIR = path.join(os.homedir(), ".opencode-browser");
-const SOCKET_PATH = path.join(BASE_DIR, "broker.sock");
+const SOCKET_PATH = getBrokerSocketPath();
 const BROKER_PATH = path.join(BASE_DIR, "broker.cjs");
 
+function getSafePipeName() {
+  try {
+    const username = os.userInfo().username || "user";
+    return `opencode-browser-${username}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+  } catch {
+    return "opencode-browser";
+  }
+}
+
+function getBrokerSocketPath() {
+  const override = process.env.OPENCODE_BROWSER_BROKER_SOCKET;
+  if (override) return override;
+  if (process.platform === "win32") return `\\\\.\\pipe\\${getSafePipeName()}`;
+  return path.join(BASE_DIR, "broker.sock");
+}
+
 fs.mkdirSync(BASE_DIR, { recursive: true });
 
 function createJsonLineParser(onMessage) {