blink-sdk 0.2.0

Rust SDK for Blink agent sandboxes — BoxLite VM execution, sessions, and V-Hub
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

use std::path::Path;

use anyhow::Context;
use boxlite::BoxliteRuntime;
use boxlite::runtime::options::{BoxOptions, BoxliteOptions, NetworkSpec, RootfsSpec};
use tracing::info;

use crate::exec::exec_agent_script;
use crate::AgentResult;
use blink_shared::DEFAULT_ROOTFS_IMAGE;

/// Execute a guest agent binary inside an ephemeral BoxLite sandbox.
pub async fn run_agent_script(script_path: &Path, image: &str) -> anyhow::Result<AgentResult> {
    let script_path = script_path
        .canonicalize()
        .with_context(|| format!("agent binary not found: {}", script_path.display()))?;

    info!(script = %script_path.display(), image, "ephemeral run");

    let runtime = BoxliteRuntime::new(BoxliteOptions::default())
        .context("failed to initialize BoxLite runtime")?;

    let options = BoxOptions {
        rootfs: RootfsSpec::Image(image.to_string()),
        network: NetworkSpec::Disabled,
        auto_remove: true,
        detach: false,
        ..Default::default()
    };

    let litebox = runtime.create(options, None).await.context("create box")?;
    exec_agent_script(&litebox, &script_path).await
}

/// Execute a guest agent binary in an ephemeral sandbox (default rootfs image).
pub async fn run_agent_script_default(script_path: &Path) -> anyhow::Result<AgentResult> {
    run_agent_script(script_path, DEFAULT_ROOTFS_IMAGE).await
}