feat(firefox): dashboard live view, bidi module and docs

.github/workflows/ci.yml

@@ -4,7 +4,6 @@ on:
   push:
     branches: [main]
   pull_request:
-    branches: [main]
   workflow_dispatch:
 
 jobs:

README.md

@@ -53,7 +53,7 @@ The CLI sends each command to a background daemon that starts on the first comma
 
 Chrome for Testing is the default browser. You can also attach to a running Chrome with `--cdp` or `--auto-connect` ([CDP mode](https://agent-browser.dev/cdp-mode)), select the [Lightpanda](https://agent-browser.dev/engines/lightpanda) or [Obscura](https://agent-browser.dev/engines/obscura) engine with `--engine`, drive Mobile Safari in the [iOS Simulator](https://agent-browser.dev/ios), or use a cloud browser provider such as [Browserbase](https://agent-browser.dev/providers/browserbase), [Browserless](https://agent-browser.dev/providers/browserless), [Browser Use](https://agent-browser.dev/providers/browser-use), [Kernel](https://agent-browser.dev/providers/kernel), or [AgentCore](https://agent-browser.dev/providers/agentcore).
 
-Select Firefox with `--engine firefox`.
+Select Firefox with `--engine firefox`. It requires Firefox 150 or newer, uses WebDriver BiDi and Firefox's DevTools accessibility tree for snapshots, and starts with a fresh temporary profile. See the [Firefox engine guide](https://agent-browser.dev/engines/firefox).
 
 ## For AI agents
 

agent-browser.schema.json

@@ -203,7 +203,7 @@
     },
     "engine": {
       "type": "string",
-      "enum": ["chrome", "lightpanda", "obscura"],
+      "enum": ["chrome", "lightpanda", "firefox", "obscura"],
       "default": "chrome",
       "description": "Browser engine to use. Obscura is experimental and does not support proxy bypass rules."
     },

cli/src/doctor/chrome.rs

@@ -111,7 +111,7 @@ pub(super) fn check(checks: &mut Vec<Check>) {
                 );
             }
         } else if engine == "firefox" {
-            match crate::native::firefox::process::find_firefox(None) {
+            match crate::native::bidi::firefox::find_firefox(None) {
                 Ok(path) => {
                     let version = query_chrome_version(&path)
                         .map(|v| format!("{v} at "))

cli/src/mcp.rs

@@ -5772,7 +5772,12 @@ mod tests {
             let error = cli_tool_args(&arguments, vec!["open".to_string()], None).unwrap_err();
             assert!(error.message.contains("may not set"), "{:?}", bad);
         }
-        for ok in [vec!["--engine", "obscura"], vec!["--full"], vec!["-i"]] {
+        for ok in [
+            vec!["--engine", "obscura"],
+            vec!["--engine", "firefox"],
+            vec!["--full"],
+            vec!["-i"],
+        ] {
             let arguments = json!({ "extraArgs": ok });
             assert!(cli_tool_args(&arguments, vec!["open".to_string()], None).is_ok());
         }