Struct LaunchConfig 

pub struct LaunchConfig { /* private fields */ }

Cloneable description of an application to launch.

Implementations

impl LaunchConfig

pub fn new(program: impl Into<OsString>) -> Self

Create a launch configuration for an executable name or path.

Examples found in repository

examples/basic.rs (line 15)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut arguments = std::env::args_os().skip(1);
    let program = arguments
        .next()
        .unwrap_or_else(|| "gnome-calculator".into());
    let harness = ComputerUse::builder()
        .native_timeout(Duration::from_secs(8))
        .fallback_timeout(Duration::from_secs(30))
        .bridge_geometry(1280, 800)
        .build()?;
    let mut app = harness.launch(LaunchConfig::new(program).args(arguments))?;

    let frame = app.capture()?;
    println!(
        "controlled pid={} transport={:?} frame={}x{}",
        app.pid(),
        app.transport(),
        frame.width,
        frame.height
    );
    frame.image.save("agent-seat-frame.png")?;

    // Harmlessly focus the center of the captured app to prove pointer input.
    app.click(
        f64::from(frame.width) / 2.0,
        f64::from(frame.height) / 2.0,
        PointerButton::Left,
        1,
    )?;

    app.stop();
    Ok(())
}

examples/agent_loop.rs (line 16)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut args = env::args().skip(1);
    let program = args
        .next()
        .unwrap_or_else(|| "gnome-calculator".to_string());

    let mut config = LaunchConfig::new(&program);
    for extra in args {
        config = config.arg(extra);
    }

    let harness = ComputerUse::new()?;
    let mut app = harness.launch(config)?;
    println!("launched {program} via {:?}", app.transport());

    // 1. Perceive: capture the initial frame.
    let before = app.capture()?;
    before.image.save("agent-loop-before.png")?;
    println!(
        "captured {}x{} -> agent-loop-before.png",
        before.image.width(),
        before.image.height()
    );

    // 2. Act: focus, select-all, and type, exercising keyboard + text paths.
    app.click(
        before.image.width() as f64 / 2.0,
        before.image.height() as f64 / 2.0,
        PointerButton::Left,
        1,
    )?;
    app.press_key("ctrl+a")?;
    app.type_text("agent-seat-linux")?;

    // 3. Perceive again: capture the post-action frame.
    let after = app.capture()?;
    after.image.save("agent-loop-after.png")?;
    println!(
        "captured {}x{} -> agent-loop-after.png",
        after.image.width(),
        after.image.height()
    );

    // 4. Teardown: stop the app, then close the seat.
    app.stop();
    harness.close();
    println!("done");
    Ok(())
}

pub fn arg(self, argument: impl Into<OsString>) -> Self

Append one command-line argument.

Examples found in repository

examples/agent_loop.rs (line 18)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut args = env::args().skip(1);
    let program = args
        .next()
        .unwrap_or_else(|| "gnome-calculator".to_string());

    let mut config = LaunchConfig::new(&program);
    for extra in args {
        config = config.arg(extra);
    }

    let harness = ComputerUse::new()?;
    let mut app = harness.launch(config)?;
    println!("launched {program} via {:?}", app.transport());

    // 1. Perceive: capture the initial frame.
    let before = app.capture()?;
    before.image.save("agent-loop-before.png")?;
    println!(
        "captured {}x{} -> agent-loop-before.png",
        before.image.width(),
        before.image.height()
    );

    // 2. Act: focus, select-all, and type, exercising keyboard + text paths.
    app.click(
        before.image.width() as f64 / 2.0,
        before.image.height() as f64 / 2.0,
        PointerButton::Left,
        1,
    )?;
    app.press_key("ctrl+a")?;
    app.type_text("agent-seat-linux")?;

    // 3. Perceive again: capture the post-action frame.
    let after = app.capture()?;
    after.image.save("agent-loop-after.png")?;
    println!(
        "captured {}x{} -> agent-loop-after.png",
        after.image.width(),
        after.image.height()
    );

    // 4. Teardown: stop the app, then close the seat.
    app.stop();
    harness.close();
    println!("done");
    Ok(())
}

pub fn args<I, S>(self, arguments: I) -> Self

where I: IntoIterator<Item = S>, S: Into<OsString>,

Append several command-line arguments.

Examples found in repository

examples/basic.rs (line 15)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut arguments = std::env::args_os().skip(1);
    let program = arguments
        .next()
        .unwrap_or_else(|| "gnome-calculator".into());
    let harness = ComputerUse::builder()
        .native_timeout(Duration::from_secs(8))
        .fallback_timeout(Duration::from_secs(30))
        .bridge_geometry(1280, 800)
        .build()?;
    let mut app = harness.launch(LaunchConfig::new(program).args(arguments))?;

    let frame = app.capture()?;
    println!(
        "controlled pid={} transport={:?} frame={}x{}",
        app.pid(),
        app.transport(),
        frame.width,
        frame.height
    );
    frame.image.save("agent-seat-frame.png")?;

    // Harmlessly focus the center of the captured app to prove pointer input.
    app.click(
        f64::from(frame.width) / 2.0,
        f64::from(frame.height) / 2.0,
        PointerButton::Left,
        1,
    )?;

    app.stop();
    Ok(())
}

pub fn env(self, key: impl Into<OsString>, value: impl Into<OsString>) -> Self

Set one environment variable for the application.

pub fn env_remove(self, key: impl Into<OsString>) -> Self

Remove one inherited environment variable from the application.

pub fn current_dir(self, directory: impl Into<PathBuf>) -> Self

Set the application’s working directory.

pub fn inherit_diagnostics(self, inherit: bool) -> Self

Inherit stdout and stderr, which is useful while integrating a new toolkit. They are null by default so controlled apps do not block on closed harness pipes.

pub fn program(&self) -> &OsStr

Executable configured for this launch.

Trait Implementations

impl Clone for LaunchConfig

fn clone(&self) -> LaunchConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LaunchConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.