browser-control 0.2.2

CLI that manages browsers and exposes them over CDP/BiDi for agent-driven development. Includes an optional MCP server.
Documentation
//! `browser-control mcp` subcommand entry point.

use anyhow::{anyhow, Result};

use crate::cli::env_resolver::{self, ResolvedBrowser, Source};
use crate::mcp::server::{run, ServerState, ToolRegistry};
use crate::registry::Registry;

/// Entry point for `browser-control mcp`.
pub async fn run_cli(browser_arg: Option<String>, playwright: bool) -> Result<()> {
    if playwright {
        let resolved = resolve_browser(browser_arg).await?;
        let code = crate::mcp::playwright::run(&resolved).await?;
        std::process::exit(code);
    }
    let resolved = resolve_browser(browser_arg).await?;
    let state = ServerState::new(resolved);
    let tools = ToolRegistry::new();
    crate::mcp::tools::register_all(&tools);
    run(state, tools).await
}

/// Resolution order: positional arg / `BROWSER_CONTROL` env (arg wins, env is
/// the fallback — both are merged by clap into `browser_arg`) > persisted
/// default (`browser-control set default ...`) > most-recent-alive > error.
pub async fn resolve_browser(browser_arg: Option<String>) -> Result<ResolvedBrowser> {
    let registry = Registry::open()?;
    if let Some(arg) = browser_arg.as_deref().filter(|s| !s.is_empty()) {
        let sel = env_resolver::parse(arg)?;
        return env_resolver::resolve(sel, &registry).await;
    }
    if let Some(value) = crate::config::load()?.default {
        let sel = env_resolver::parse(&value)?;
        return env_resolver::resolve(sel, &registry).await;
    }
    if let Some(row) = registry.most_recent_alive()? {
        return Ok(ResolvedBrowser {
            endpoint: row.endpoint,
            engine: row.engine,
            source: Source::Registered { name: row.name },
        });
    }
    Err(anyhow!(
        "no browser selected: pass a browser argument, set BROWSER_CONTROL, run `browser-control set default <value>`, or run `browser-control start`"
    ))
}