@different-ai/opencode-browser 4.2.2 → 4.2.4

package/.opencode/skill/browser-automation/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: browser-automation
+description: Reliable, composable browser automation using minimal OpenCode Browser primitives.
+license: MIT
+compatibility: opencode
+metadata:
+  audience: agents
+  domain: browser
+---
+
+## What I do
+
+- Provide a safe, composable workflow for browsing tasks
+- Use `browser_query` list and index selection to click reliably
+- Confirm state changes after each action
+
+## Best-practice workflow
+
+1. Inspect tabs with `browser_get_tabs`
+2. Navigate with `browser_navigate` if needed
+3. Wait for UI using `browser_query` with `timeoutMs`
+4. Discover candidates using `browser_query` with `mode=list`
+5. Click or type using `index`
+6. Confirm using `browser_query` or `browser_snapshot`
+
+## Query modes
+
+- `text`: read visible text from a matched element
+- `value`: read input values
+- `list`: list many matches with text/metadata
+- `exists`: check presence and count
+- `page_text`: extract visible page text
+
+## Troubleshooting
+
+- If a selector fails, run `browser_query` with `mode=page_text` to confirm the content exists
+- Use `mode=list` on broad selectors (`button`, `a`, `*[role="button"]`) and choose by index
+- Confirm results after each action

package/bin/cli.js

@@ -275,13 +275,6 @@ Find it at ${color("cyan", "chrome://extensions")}:
 
   header("Step 7: Configure OpenCode");
 
-  // OpenCode config discovery (per upstream docs):
-  // - $HOME/.opencode.json
-  // - $XDG_CONFIG_HOME/opencode/.opencode.json
-  // - ./.opencode.json (project-local)
-  // We write the project-local config to avoid touching global state.
-  const opencodeJsonPath = join(process.cwd(), ".opencode.json");
-
   const desiredPlugin = "@different-ai/opencode-browser";
 
   function normalizePlugins(val) {
@@ -290,51 +283,128 @@ Find it at ${color("cyan", "chrome://extensions")}:
     return [];
   }
 
-  function removeLegacyMcp(config) {
-    if (config.mcp?.browser) {
-      delete config.mcp.browser;
-      if (Object.keys(config.mcp).length === 0) delete config.mcp;
-      warn("Removed old MCP browser config (replaced by plugin)");
-    }
-    if (config.mcpServers?.browser) {
-      delete config.mcpServers.browser;
-      if (Object.keys(config.mcpServers).length === 0) delete config.mcpServers;
-      warn("Removed old MCP browser config (replaced by plugin)");
+  function stripJsoncComments(contents) {
+    return contents
+      .replace(/\/\*[\s\S]*?\*\//g, "")
+      .replace(/^\s*\/\/.*$/gm, "");
+  }
+
+  function sanitizeJson(contents) {
+    return stripJsoncComments(contents).replace(/,\s*(\]|\})/g, "$1");
+  }
+
+  function findOpenCodeConfigPath(configDir) {
+    const jsoncPath = join(configDir, "opencode.jsonc");
+    if (existsSync(jsoncPath)) return jsoncPath;
+    const jsonPath = join(configDir, "opencode.json");
+    return jsonPath;
+  }
+
+  const configOptions = [
+    "1) Project (./opencode.json or opencode.jsonc)",
+    "2) Global (~/.config/opencode/opencode.json)",
+    "3) Custom path",
+    "4) Skip (does nothing)",
+  ];
+
+  log(`\n${configOptions.join("\n")}`);
+  const selection = await ask("Choose config location [1-4]: ");
+
+  let configPath = null;
+  let configDir = null;
+
+  if (selection === "1") {
+    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");
+    configPath = findOpenCodeConfigPath(configDir);
+  } else if (selection === "3") {
+    const customPath = await ask("Enter full path to opencode.json or opencode.jsonc: ");
+    if (customPath) {
+      configPath = customPath;
+      configDir = dirname(customPath);
+    } else {
+      warn("No path provided. Skipping OpenCode config.");
     }
+  } else if (selection === "4") {
+    warn("Skipping OpenCode config (does nothing).");
+  } else {
+    warn("Invalid selection. Skipping OpenCode config.");
   }
 
-  if (existsSync(opencodeJsonPath)) {
-    const shouldUpdate = await confirm("Found .opencode.json. Add plugin automatically?");
+  if (configPath && configDir) {
+    const hasExistingConfig = existsSync(configPath);
+    const shouldUpdate = hasExistingConfig
+      ? await confirm(`Found ${configPath}. Add plugin automatically?`)
+      : await confirm(`No config found at ${configPath}. Create one?`);
+
     if (shouldUpdate) {
       try {
-        const config = JSON.parse(readFileSync(opencodeJsonPath, "utf-8"));
+        let config = { $schema: "https://opencode.ai/config.json", plugin: [] };
+        let canWriteConfig = true;
+
+        if (hasExistingConfig) {
+          const rawConfig = readFileSync(configPath, "utf-8");
+          try {
+            config = JSON.parse(sanitizeJson(rawConfig));
+          } catch (e) {
+            error(`Failed to parse ${configPath}: ${e.message}`);
+            const shouldOverwrite = await confirm("Config is invalid JSON. Back up and recreate it?");
+            if (shouldOverwrite) {
+              const backupPath = `${configPath}.bak-${Date.now()}`;
+              writeFileSync(backupPath, rawConfig);
+              warn(`Backed up invalid config to ${backupPath}`);
+              config = { $schema: "https://opencode.ai/config.json", plugin: [] };
+            } else {
+              canWriteConfig = false;
+            }
+          }
+        }
+
+        if (canWriteConfig) {
+          config.plugin = normalizePlugins(config.plugin);
+          if (!config.plugin.includes(desiredPlugin)) config.plugin.push(desiredPlugin);
+          if (typeof config.$schema !== "string") config.$schema = "https://opencode.ai/config.json";
+
+          ensureDir(configDir);
+          writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+          success(`Updated ${configPath} with plugin`);
+        } else {
+          warn(`Skipped updating ${configPath}. Fix JSON manually and rerun install.`);
+        }
+      } catch (e) {
+        error(`Failed to update ${configPath}: ${e.message}`);
+      }
+    }
+  }
 
-        // Make sure plugin is an array.
-        config.plugin = normalizePlugins(config.plugin);
-        if (!config.plugin.includes(desiredPlugin)) config.plugin.push(desiredPlugin);
+  header("Step 8: Optional Agent Skill");
 
-        removeLegacyMcp(config);
+  log(`
+Agent Skills are reusable instructions discovered by OpenCode.
 
-        // Ensure schema is correct if present.
-        if (typeof config.$schema !== "string") config.$schema = "https://opencode.ai/config.json";
+Format rules (summary):
+- Place a skill at .opencode/skill/<name>/SKILL.md
+- SKILL.md must start with YAML frontmatter with name + description
+- name must match the directory and use: ^[a-z0-9]+(-[a-z0-9]+)*$
+`);
 
-        writeFileSync(opencodeJsonPath, JSON.stringify(config, null, 2) + "\n");
-        success("Updated .opencode.json with plugin");
-      } catch (e) {
-        error(`Failed to update .opencode.json: ${e.message}`);
-      }
+  const skillName = "browser-automation";
+  const skillSrc = join(PACKAGE_ROOT, ".opencode", "skill", skillName, "SKILL.md");
+  const skillDstDir = join(process.cwd(), ".opencode", "skill", skillName);
+  const skillDst = join(skillDstDir, "SKILL.md");
+
+  if (existsSync(skillSrc)) {
+    const shouldAddSkill = await confirm(`Add ${skillName} skill to this repo?`);
+    if (shouldAddSkill) {
+      ensureDir(skillDstDir);
+      copyFileSync(skillSrc, skillDst);
+      success(`Added skill: ${skillDst}`);
     }
   } else {
-    const shouldCreate = await confirm("No .opencode.json found. Create one?");
-    if (shouldCreate) {
-      const config = {
-        $schema: "https://opencode.ai/config.json",
-        theme: "opencode",
-        plugin: [desiredPlugin],
-      };
-      writeFileSync(opencodeJsonPath, JSON.stringify(config, null, 2) + "\n");
-      success("Created .opencode.json with plugin");
-    }
+    warn("Skill template missing from package; skipping.");
   }
 
   header("Installation Complete!");
@@ -410,7 +480,7 @@ async function uninstall() {
 ${color("bright", "Note:")}
 - The unpacked extension folder remains at: ${EXTENSION_DIR}
 - Remove it manually in ${color("cyan", "chrome://extensions")}
-- Remove ${color("bright", "@different-ai/opencode-browser")} from your opencode.json plugin list if desired.
+- Remove ${color("bright", "@different-ai/opencode-browser")} from your opencode.json/opencode.jsonc plugin list if desired.
 `);
 }
 

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "OpenCode Browser Automation",
-  "version": "4.2.1",
+  "version": "4.2.4",
   "description": "Browser automation for OpenCode",
   "permissions": [
     "tabs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@different-ai/opencode-browser",
-  "version": "4.2.2",
+  "version": "4.2.4",
   "description": "Browser automation plugin for OpenCode (native messaging + per-tab ownership).",
   "type": "module",
   "bin": {
@@ -12,6 +12,7 @@
     "./plugin": "./dist/plugin.js"
   },
   "files": [
+    ".opencode",
     "bin",
     "dist",
     "extension",