Struct AgentKernel 

pub struct AgentKernel { /* private fields */ }

Client for the agentkernel HTTP API.

Example

let client = agentkernel_sdk::AgentKernel::builder().build()?;
let output = client.run(&["echo", "hello"], None).await?;
println!("{}", output.output);

Implementations

impl AgentKernel

pub fn builder() -> AgentKernelBuilder

Create a new builder with defaults resolved from env vars.

pub async fn health(&self) -> Result<String>

Health check. Returns "ok".

pub async fn run( &self, command: &[&str], opts: Option<RunOptions>, ) -> Result<RunOutput>

Run a command in a temporary sandbox.

pub async fn list_sandboxes(&self) -> Result<Vec<SandboxInfo>>

List all sandboxes.

pub async fn create_sandbox( &self, name: &str, opts: Option<CreateSandboxOptions>, ) -> Result<SandboxInfo>

Create a new sandbox with optional configuration.

pub async fn get_sandbox(&self, name: &str) -> Result<SandboxInfo>

Get info about a sandbox.

pub async fn remove_sandbox(&self, name: &str) -> Result<()>

Remove a sandbox.

pub async fn exec_in_sandbox( &self, name: &str, command: &[&str], opts: Option<ExecOptions>, ) -> Result<RunOutput>

Run a command in an existing sandbox.

pub async fn with_sandbox<F, Fut, T>( &self, name: &str, opts: Option<CreateSandboxOptions>, f: F, ) -> Result<T>

where F: FnOnce(SandboxHandle) -> Fut, Fut: Future<Output = Result<T>>,

Create a sandbox and return a guard that removes it on drop.

Use with_sandbox for guaranteed cleanup via a closure.

pub async fn write_files( &self, name: &str, files: HashMap<String, String>, ) -> Result<BatchFileWriteResponse>

Write multiple files to a sandbox in one request.

pub async fn read_file( &self, name: &str, path: &str, ) -> Result<FileReadResponse>

Read a file from a sandbox.

pub async fn write_file( &self, name: &str, path: &str, content: &str, encoding: Option<&str>, ) -> Result<String>

Write a file to a sandbox.

pub async fn delete_file(&self, name: &str, path: &str) -> Result<String>

Delete a file from a sandbox.

pub async fn get_sandbox_logs(&self, name: &str) -> Result<Vec<Value>>

Get audit log entries for a sandbox.

pub async fn exec_detached( &self, name: &str, command: &[&str], opts: Option<ExecOptions>, ) -> Result<DetachedCommand>

Start a detached (background) command in a sandbox.

pub async fn detached_status( &self, name: &str, cmd_id: &str, ) -> Result<DetachedCommand>

Get the status of a detached command.

pub async fn detached_logs( &self, name: &str, cmd_id: &str, stream: Option<&str>, ) -> Result<DetachedLogsResponse>

Get logs from a detached command.

pub async fn detached_kill(&self, name: &str, cmd_id: &str) -> Result<String>

Kill a detached command.

pub async fn detached_list(&self, name: &str) -> Result<Vec<DetachedCommand>>

List detached commands in a sandbox.

pub async fn batch_run( &self, commands: Vec<BatchCommand>, ) -> Result<BatchRunResponse>

Run multiple commands in parallel.

Trait Implementations

impl Clone for AgentKernel

fn clone(&self) -> AgentKernel

Returns a duplicate of the value.

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

Performs copy-assignment from source.