//! `agent-browser connect` — zero-confirmation control of the user's real, //! logged-in Chrome via the `ab-connect` MV3 extension over Chrome **native //! messaging** (no localhost port, no token; Chrome authenticates the extension //! to this host by id). //! //! Two pieces live here: //! - `run_connect` — `--install` writes the native-messaging host manifest (and //! a tiny launcher) so Chrome will spawn us; with no flag it reports status. //! - `run_nm_host` — the hidden `__nm-host` mode Chrome launches: it speaks the //! native-messaging stdio framing (4-byte little-endian length + JSON). //! //! This step wires the transport end-to-end (Chrome ⇄ host). Bridging the host //! to the daemon's relay + CdpClient is layered on next. use std::io::Write; use std::path::PathBuf; /// Native-messaging host name; must match `HOST_NAME` in the extension and the /// manifest filename. pub const HOST_NAME: &str = "com.agent_browser.connect"; /// Stable id of the `ab-connect` extension, pinned by the `key` in its /// manifest.json (and the signing key of the published `.crx`). Chrome only lets /// that extension talk to this host, and the force-install policy references it. pub const EXTENSION_ID: &str = "ciiljdlhdpfckdcfkphgmfalanpdejep"; /// Update URL the force-install policy points at. MUST be the Chrome Web Store /// endpoint: Chrome 149 tags any **off-Web-Store** force-installed extension /// `[BLOCKED]` on an unmanaged browser (verified on macOS — chrome://policy shows /// `[BLOCKED]…` / "Error, Warning"). Self-hosting a `.crx` therefore does NOT /// work on consumer Chrome; the extension must be published to the Web Store, and /// then this policy force-installs it silently (Web Store extensions are allowed). pub const UPDATE_URL: &str = "https://clients2.google.com/service/update2/crx"; /// Public Web Store listing — the guaranteed one-click "Add to Chrome" path, /// and the fallback when the force-install profile can't be approved headlessly. pub const STORE_URL: &str = "https://chromewebstore.google.com/detail/ciiljdlhdpfckdcfkphgmfalanpdejep"; /// Stable identifiers for the generated Chrome configuration profile, so a /// re-install replaces (rather than duplicates) it in System Settings. const PROFILE_ID: &str = "work.pwtk.agent-browser.ab-connect"; const PROFILE_UUID: &str = "A1B2C3D4-AB00-4CCE-9E10-AAAABBBBCCCC"; const PROFILE_PAYLOAD_UUID: &str = "A1B2C3D4-AB01-4CCE-9E10-DDDDEEEEFFFF"; /// `agent-browser extension ` (local; no daemon). /// `args` is the cleaned argv including the leading "extension". pub fn run_connect(args: &[String], json: bool) { let install = args.iter().any(|a| a == "--install" || a == "install"); let uninstall = args.iter().any(|a| a == "--uninstall" || a == "uninstall"); if uninstall { let removed = remove_host_manifests(); let profile_removed = remove_force_install_profile(); if json { report(json, true, &format!("removed {removed} native-host manifest(s)")); } else { println!("✓ removed {removed} native-host manifest(s)."); if profile_removed { println!("✓ removed ~/.agent-browser/ab-connect.mobileconfig"); } if cfg!(target_os = "macos") { println!( " To fully remove the extension, delete the \"agent-browser connect\" profile\n\ in System Settings → Profiles (or run: profiles remove -identifier {PROFILE_ID})." ); } } return; } if install { let no_open = args.iter().any(|a| a == "--no-open"); match install_native_host() { Ok(paths) => { let profile = install_force_install_profile(no_open); if json { println!( "{}", serde_json::to_string(&serde_json::json!({ "success": true, "data": { "installed": paths, "extensionId": EXTENSION_ID, "profile": profile.as_ref().ok().map(|p| p.display().to_string()), "profileError": profile.as_ref().err(), "updateUrl": UPDATE_URL, } })) .unwrap_or_default() ); } else { println!("✓ native-messaging host installed:"); for p in &paths { println!(" {p}"); } match profile { Ok(path) => { println!("\n✓ Chrome force-install profile written:\n {}", path.display()); if cfg!(target_os = "macos") { println!( "\nGet the extension into Chrome (one-time). Either:\n\ A) One click: open {STORE_URL}\n and press \"Add to Chrome\".\n\ B) Silent: approve the profile, then restart Chrome —\n \ System Settings → General → Device Management → double-click\n \ \"agent-browser connect\" → Install. Chrome then force-installs +\n \ auto-updates it (no token, no per-use confirmation).\n\ Both need the extension published to the Web Store; until then use\n \ chrome://extensions → Developer mode → Load unpacked → extensions/ab-connect." ); } } Err(e) => { println!("\n! could not write the force-install profile: {e}"); println!( " Fallback: load extensions/ab-connect via chrome://extensions →\n\ Developer mode → Load unpacked." ); } } } } Err(e) => report(json, false, &format!("install failed: {e}")), } return; } // Status. let manifest = host_manifest_path_for_chrome(); let installed = manifest.as_ref().map(|p| p.exists()).unwrap_or(false); if json { println!( "{}", serde_json::to_string(&serde_json::json!({ "success": true, "data": { "installed": installed, "manifest": manifest.as_ref().map(|p| p.display().to_string()), "extensionId": EXTENSION_ID, } })) .unwrap_or_default() ); } else if installed { println!("✓ native-messaging host installed ({HOST_NAME})."); println!(" Load the ab-connect extension and it connects automatically."); } else { println!("✗ not installed. Run: agent-browser connect --install"); } } /// Write the launcher script + native-messaging host manifest(s). fn install_native_host() -> Result, String> { let home = dirs::home_dir().ok_or("no home dir")?; let ab_dir = home.join(".agent-browser"); std::fs::create_dir_all(&ab_dir).map_err(|e| e.to_string())?; // Chrome execs the manifest `path` directly with the calling extension's // origin as argv[1]; a launcher lets us run the binary in __nm-host mode // regardless of how/where agent-browser is installed. let exe = std::env::current_exe().map_err(|e| e.to_string())?; let launcher = ab_dir.join("nm-host.sh"); let script = format!( "#!/bin/sh\n# agent-browser native-messaging host launcher (auto-generated)\nexec \"{}\" __nm-host \"$@\"\n", exe.display() ); std::fs::write(&launcher, script).map_err(|e| e.to_string())?; #[cfg(unix)] { use std::os::unix::fs::PermissionsExt; let _ = std::fs::set_permissions(&launcher, std::fs::Permissions::from_mode(0o755)); } let manifest = serde_json::json!({ "name": HOST_NAME, "description": "agent-browser connect — native messaging host", "path": launcher.display().to_string(), "type": "stdio", "allowed_origins": [format!("chrome-extension://{EXTENSION_ID}/")], }); let body = serde_json::to_string_pretty(&manifest).map_err(|e| e.to_string())?; let mut written = Vec::new(); for dir in native_messaging_dirs() { if let Some(parent) = dir.parent() { if !parent.exists() { continue; // that browser isn't installed } } std::fs::create_dir_all(&dir).map_err(|e| e.to_string())?; let path = dir.join(format!("{HOST_NAME}.json")); std::fs::write(&path, &body).map_err(|e| e.to_string())?; written.push(path.display().to_string()); } if written.is_empty() { return Err("no Chrome/Chromium NativeMessagingHosts directory found".into()); } Ok(written) } /// Write a Chrome configuration profile that force-installs `ab-connect` from /// [`UPDATE_URL`], and (unless `no_open`) `open` it so the user approves it once /// in System Settings. Returns the profile path. macOS only — elsewhere it /// returns an error and the caller prints the manual fallback. fn install_force_install_profile(no_open: bool) -> Result { if !cfg!(target_os = "macos") { return Err("force-install profile is macOS-only; on Linux set Chrome's \ ExtensionInstallForcelist policy JSON, or Load unpacked from chrome://extensions" .into()); } let home = dirs::home_dir().ok_or("no home dir")?; let ab_dir = home.join(".agent-browser"); std::fs::create_dir_all(&ab_dir).map_err(|e| e.to_string())?; let path = ab_dir.join("ab-connect.mobileconfig"); std::fs::write(&path, force_install_mobileconfig()).map_err(|e| e.to_string())?; if !no_open { // `open` queues the profile in System Settings for one-time approval. let _ = std::process::Command::new("open").arg(&path).status(); } Ok(path) } /// The `.mobileconfig` payload: a user-scope Chrome policy that force-installs /// the extension by id from our hosted update manifest. User scope installs /// without admin — just a one-time approval click. fn force_install_mobileconfig() -> String { let forcelist = format!("{EXTENSION_ID};{UPDATE_URL}"); format!( r#" PayloadContent PayloadTypecom.google.Chrome PayloadVersion1 PayloadIdentifier{PROFILE_ID}.chrome PayloadUUID{PROFILE_PAYLOAD_UUID} PayloadEnabled PayloadDisplayNameagent-browser connect (Chrome) ExtensionInstallForcelist {forcelist} PayloadTypeConfiguration PayloadVersion1 PayloadIdentifier{PROFILE_ID} PayloadUUID{PROFILE_UUID} PayloadDisplayNameagent-browser connect PayloadDescriptionForce-installs the agent-browser connect extension so agent-browser can drive your logged-in Chrome. No token, no per-use confirmation. PayloadOrganizationagent-browser-stealth PayloadScopeUser PayloadRemovalDisallowed "# ) } /// Remove the generated `.mobileconfig` file (the profile itself is removed by /// the user from System Settings, or via `profiles remove`). fn remove_force_install_profile() -> bool { dirs::home_dir() .map(|h| h.join(".agent-browser").join("ab-connect.mobileconfig")) .filter(|p| p.exists()) .map(|p| std::fs::remove_file(&p).is_ok()) .unwrap_or(false) } fn remove_host_manifests() -> usize { let mut n = 0; for dir in native_messaging_dirs() { let path = dir.join(format!("{HOST_NAME}.json")); if path.exists() && std::fs::remove_file(&path).is_ok() { n += 1; } } n } /// Per-OS NativeMessagingHosts directories for Chrome + Chromium-family browsers. fn native_messaging_dirs() -> Vec { let mut dirs_out = Vec::new(); #[cfg(target_os = "macos")] { if let Some(app_support) = dirs::config_dir() { for sub in [ "Google/Chrome", "Google/Chrome Beta", "Google/Chrome Canary", "Chromium", "Microsoft Edge", "BraveSoftware/Brave-Browser", ] { dirs_out.push(app_support.join(sub).join("NativeMessagingHosts")); } } } #[cfg(all(unix, not(target_os = "macos")))] { if let Some(config) = dirs::config_dir() { for sub in ["google-chrome", "chromium", "microsoft-edge", "BraveSoftware/Brave-Browser"] { dirs_out.push(config.join(sub).join("NativeMessagingHosts")); } } } dirs_out } fn host_manifest_path_for_chrome() -> Option { native_messaging_dirs() .into_iter() .map(|d| d.join(format!("{HOST_NAME}.json"))) .find(|p| p.exists()) .or_else(|| { native_messaging_dirs() .into_iter() .next() .map(|d| d.join(format!("{HOST_NAME}.json"))) }) } fn report(json: bool, ok: bool, msg: &str) { if json { println!( "{}", serde_json::to_string(&serde_json::json!({ "success": ok, "error": if ok { serde_json::Value::Null } else { serde_json::json!(msg) }, "message": msg })) .unwrap_or_default() ); } else if ok { println!("✓ {msg}"); } else { eprintln!("✗ {msg}"); } if !ok { std::process::exit(1); } } // ---- native messaging host (`__nm-host`) ---------------------------------- fn nm_log(line: &str) { let path = dirs::home_dir() .map(|h| h.join(".agent-browser").join("nm-host.log")) .unwrap_or_else(|| PathBuf::from("/tmp/ab-nm-host.log")); if let Some(p) = path.parent() { let _ = std::fs::create_dir_all(p); } if let Ok(mut f) = std::fs::OpenOptions::new().create(true).append(true).open(&path) { let _ = writeln!(f, "{line}"); } } fn random_guid() -> String { let mut b = [0u8; 16]; let _ = getrandom::getrandom(&mut b); b.iter().map(|x| format!("{x:02x}")).collect() } /// Where the daemon/CLI reads the relay's CDP WebSocket URL (perms 600). fn relay_url_path() -> PathBuf { dirs::home_dir() .map(|h| h.join(".agent-browser").join("relay-cdp-url")) .unwrap_or_else(|| PathBuf::from("/tmp/ab-relay-cdp-url")) } /// The live relay CDP WebSocket URL, if the native-messaging host is running /// (it writes the file on connect and removes it on exit). Used by /// `agent-browser extension connect` to attach without the user copying a URL. pub fn relay_url() -> Option { let s = std::fs::read_to_string(relay_url_path()).ok()?; let s = s.trim().to_string(); if s.starts_with("ws://") { Some(s) } else { None } } /// Hidden `__nm-host` mode: launched by Chrome for the ab-connect extension. /// /// Bridges the extension (native-messaging stdio, envelope protocol) to a local /// **CDP WebSocket endpoint** that agent-browser connects to like any Chrome. /// `relay::RelayState` translates envelope ⇄ raw CDP and emulates browser-level /// Target discovery. The ws URL carries an unguessable guid (written to a 600 /// file) so only this user's agent-browser — not arbitrary local processes — /// can drive the browser. No token, no user interaction. pub fn run_nm_host() { let rt = match tokio::runtime::Builder::new_multi_thread().enable_all().build() { Ok(rt) => rt, Err(e) => { nm_log(&format!("[nm-host] runtime build failed: {e}")); return; } }; rt.block_on(nm_host_main()); } async fn nm_host_main() { use crate::native::relay::{RelayOut, RelayState}; use std::collections::HashMap; use std::sync::atomic::{AtomicU64, Ordering}; use std::sync::Arc; use tokio::io::{AsyncReadExt, AsyncWriteExt}; use tokio::sync::{mpsc, Mutex}; /// client_id -> unbounded sender feeding that client's ws writer. type ClientMap = Arc>>>; nm_log(&format!( "[nm-host] start argv={:?}", std::env::args().skip(1).collect::>() )); let listener = match tokio::net::TcpListener::bind("127.0.0.1:0").await { Ok(l) => l, Err(e) => { nm_log(&format!("[nm-host] bind failed: {e}")); return; } }; let port = listener.local_addr().map(|a| a.port()).unwrap_or(0); let guid = random_guid(); let url = format!("ws://127.0.0.1:{port}/{guid}"); let url_path = relay_url_path(); if let Some(p) = url_path.parent() { let _ = std::fs::create_dir_all(p); } if std::fs::write(&url_path, &url).is_ok() { #[cfg(unix)] { use std::os::unix::fs::PermissionsExt; let _ = std::fs::set_permissions(&url_path, std::fs::Permissions::from_mode(0o600)); } } nm_log(&format!("[nm-host] cdp endpoint {url}")); let state = Arc::new(Mutex::new(RelayState::new())); let clients: ClientMap = Arc::new(Mutex::new(HashMap::new())); let next_client_id = Arc::new(AtomicU64::new(1)); let (to_ext, mut to_ext_rx) = mpsc::channel::>(4096); // Single writer to Chrome (extension) over stdout, native-messaging framed. tokio::spawn(async move { let mut out = tokio::io::stdout(); while let Some(frame) = to_ext_rx.recv().await { let len = (frame.len() as u32).to_ne_bytes(); if out.write_all(&len).await.is_err() || out.write_all(&frame).await.is_err() { break; } let _ = out.flush().await; } }); // Accept agent-browser CDP clients on the guid-scoped ws endpoint. { let state = state.clone(); let clients = clients.clone(); let next_client_id = next_client_id.clone(); let to_ext = to_ext.clone(); let guid = guid.clone(); tokio::spawn(async move { loop { let (stream, _) = match listener.accept().await { Ok(x) => x, Err(_) => break, }; let st = state.clone(); let client_id = next_client_id.fetch_add(1, Ordering::Relaxed); let (ctx, crx) = mpsc::unbounded_channel::(); clients.lock().await.insert(client_id, ctx); let tx = to_ext.clone(); let g = guid.clone(); let cls = clients.clone(); tokio::spawn(async move { handle_cdp_client(stream, g, st, client_id, crx, tx, cls).await; }); } }); } // Extension → host frames. let mut stdin = tokio::io::stdin(); loop { let mut len_buf = [0u8; 4]; if stdin.read_exact(&mut len_buf).await.is_err() { break; } let len = u32::from_ne_bytes(len_buf) as usize; let mut buf = vec![0u8; len]; if stdin.read_exact(&mut buf).await.is_err() { break; } let v: serde_json::Value = match serde_json::from_slice(&buf) { Ok(v) => v, Err(_) => continue, }; let outs = { let mut s = state.lock().await; s.handle_ext_message(&v, "") }; for o in outs { match o { RelayOut::ToClient { to, msg } => { let text = msg.to_string(); let cls = clients.lock().await; match to { // Command reply → only the client that issued it. Some(cid) => { if let Some(tx) = cls.get(&cid) { let _ = tx.send(text); } } // CDP event → fan out to every connected client. None => { for tx in cls.values() { let _ = tx.send(text.clone()); } } } } RelayOut::ToExt(m) => { let _ = to_ext.send(m.to_string().into_bytes()).await; } } } } nm_log("[nm-host] stdin EOF — Chrome closed the port"); let _ = std::fs::remove_file(relay_url_path()); } #[allow(clippy::too_many_arguments)] async fn handle_cdp_client( stream: tokio::net::TcpStream, guid: String, state: std::sync::Arc>, client_id: u64, mut from_relay: tokio::sync::mpsc::UnboundedReceiver, to_ext: tokio::sync::mpsc::Sender>, clients: std::sync::Arc< tokio::sync::Mutex>>, >, ) { use crate::native::relay::ClientRoute; use futures_util::{SinkExt, StreamExt}; use tokio_tungstenite::tungstenite::Message; let want_path = format!("/{guid}"); let cb = |req: &tokio_tungstenite::tungstenite::handshake::server::Request, resp: tokio_tungstenite::tungstenite::handshake::server::Response| { if req.uri().path() == want_path { Ok(resp) } else { let mut reject = tokio_tungstenite::tungstenite::handshake::server::ErrorResponse::new( Some("forbidden".to_string()), ); *reject.status_mut() = tokio_tungstenite::tungstenite::http::StatusCode::FORBIDDEN; Err(reject) } }; let ws = match tokio_tungstenite::accept_hdr_async(stream, cb).await { Ok(ws) => ws, Err(_) => return, }; nm_log("[nm-host] cdp client connected"); // Ask the extension to (re)attach + announce every tab so this client // discovers the user's existing tabs instead of racing an empty list. let _ = to_ext.send(br#"{"method":"attachAll"}"#.to_vec()).await; let (mut tx, mut rx) = ws.split(); loop { tokio::select! { relayed = from_relay.recv() => match relayed { Some(text) => { if tx.send(Message::Text(text)).await.is_err() { break } } None => break, }, incoming = rx.next() => match incoming { Some(Ok(Message::Text(text))) => { let v: serde_json::Value = match serde_json::from_str(&text) { Ok(v) => v, Err(_) => continue, }; let route = { state.lock().await.route_client_command(client_id, &v) }; match route { ClientRoute::Local(reply) => { if tx.send(Message::Text(reply.to_string())).await.is_err() { break } } ClientRoute::Forward(env) => { let _ = to_ext.send(env.to_string().into_bytes()).await; } } } Some(Ok(Message::Close(_))) | None => break, _ => {} }, } } // Unregister and forget this client's in-flight commands. clients.lock().await.remove(&client_id); state.lock().await.drop_client(client_id); nm_log("[nm-host] cdp client disconnected"); }