ferridriver-cli 0.1.0

ferridriver CLI -- MCP server for browser automation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//! CLI argument definitions.
//!
//! The ferridriver binary is dedicated to running the MCP server.
//! Test running (E2E, BDD, CT) is handled by the TS CLI (`ferridriver-test`)
//! or by Rust macros (`main!()`, `bdd_main!()`) via `cargo test`.

use std::path::PathBuf;

use clap::{Args, Parser, ValueEnum};
use ferridriver::backend::BackendKind;
use ferridriver::state::ConnectMode;

#[derive(Parser)]
#[command(
  name = "ferridriver",
  about = "High-performance browser automation -- MCP server",
  version,
  propagate_version = true
)]
pub struct Cli {
  /// Verbose output (-v = debug, -vv = trace including CDP protocol)
  #[arg(short, long, action = clap::ArgAction::Count, global = true)]
  pub verbose: u8,

  /// Config file path (YAML, TOML, or JSON). Auto-searches if not specified.
  #[arg(short, long, global = true)]
  pub config: Option<PathBuf>,

  #[command(flatten)]
  pub browser: BrowserArgs,

  #[command(flatten)]
  pub transport: TransportArgs,
}

// ── Browser / transport args ────────────────────────────────────────────

/// Browser backend and connection options.
#[derive(Args)]
pub struct BrowserArgs {
  /// Browser backend to use
  #[arg(long, default_value = "cdp-pipe")]
  pub backend: Backend,

  /// Run headless (default: true)
  #[arg(long)]
  pub headless: bool,

  /// Path to Chrome/Chromium binary
  #[arg(long)]
  pub executable_path: Option<String>,

  /// Connect to running browser at WebSocket URL
  #[arg(long)]
  pub connect: Option<String>,

  /// Auto-connect to running Chrome (by channel name)
  #[arg(long)]
  pub auto_connect: Option<String>,

  /// User data directory for auto-connect
  #[arg(long)]
  pub user_data_dir: Option<String>,
}

impl BrowserArgs {
  pub fn backend_kind(&self) -> BackendKind {
    backend_to_kind(&self.backend)
  }

  pub fn connect_mode(&self) -> ConnectMode {
    resolve_connect_mode(self)
  }
}

#[derive(Args)]
pub struct TransportArgs {
  /// Transport protocol: stdio (default) or http
  #[arg(long, default_value = "stdio")]
  pub transport: Transport,

  /// Port for HTTP transport
  #[arg(long, default_value = "8080")]
  pub port: u16,
}

#[derive(Clone, ValueEnum)]
pub enum Backend {
  CdpPipe,
  CdpRaw,
  #[cfg(target_os = "macos")]
  Webkit,
  Bidi,
}

#[derive(Clone, ValueEnum)]
pub enum Transport {
  Stdio,
  Http,
}

/// Convert Backend enum to BackendKind.
pub fn backend_to_kind(b: &Backend) -> BackendKind {
  match b {
    Backend::CdpPipe => BackendKind::CdpPipe,
    Backend::CdpRaw => BackendKind::CdpRaw,
    #[cfg(target_os = "macos")]
    Backend::Webkit => BackendKind::WebKit,
    Backend::Bidi => BackendKind::Bidi,
  }
}

/// Resolve the connect mode from CLI arguments.
pub fn resolve_connect_mode(args: &BrowserArgs) -> ConnectMode {
  if let Some(ref url) = args.connect {
    ConnectMode::ConnectUrl(url.clone())
  } else if let Some(ref channel) = args.auto_connect {
    ConnectMode::AutoConnect {
      channel: channel.clone(),
      user_data_dir: args.user_data_dir.clone(),
    }
  } else {
    ConnectMode::Launch
  }
}