Struct ControlPlaneClient 

pub struct ControlPlaneClient { /* private fields */ }

Calls the control-plane API on behalf of the CLI.

Cheap to clone (reqwest::Client is an Arc inside). Holds the bearer token the API requires; None is only useful against a --no-auth control plane.

Implementations

impl ControlPlaneClient

pub fn new(base_url: impl Into<String>) -> Self

Target the control plane at base_url (e.g. http://127.0.0.1:9090).

A trailing slash is trimmed, so a pasted URL and a typed one behave the same.

pub fn with_token(self, token: impl Into<String>) -> Self

Present this bearer token on every request.

pub fn with_optional_token(self, token: Option<impl Into<String>>) -> Self

Present token if there is one — the Option-shaped form of with_token, so a caller resolving a flag or an env var does not have to branch.

pub fn base_url(&self) -> &str

The control plane this client talks to.

pub async fn deploy( &self, config_toml: impl Into<String>, ) -> Result<DeployedAgent, ControlPlaneClientError>

Deploy an agent from raw, unexpanded config TOML.

Deliberately takes the text as it sits on disk: ${VAR} refs are the control plane’s to resolve, against its own environment and its allowlist. Expanding them here would put the operator’s secrets on the wire and require the deploying machine to hold them.

pub async fn list( &self, filter: ListFilter, ) -> Result<Vec<DeployedAgent>, ControlPlaneClientError>

Deployed agents with their endpoint and current health.

ListFilter::Live hides agents that have been stopped; the control plane keeps their entries (their logs are still readable) but they are not part of what is running.

pub async fn status( &self, id: &AgentId, ) -> Result<AgentStatus, ControlPlaneClientError>

One agent’s current health.

pub async fn logs( &self, id: &AgentId, tail: Option<usize>, ) -> Result<AgentLogs, ControlPlaneClientError>

An agent’s captured output, oldest line first, limited to the last tail lines when given.

pub async fn undeploy( &self, id: &AgentId, ) -> Result<(), ControlPlaneClientError>

Stop an agent and remove it from discovery.

Trait Implementations

impl Clone for ControlPlaneClient

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ControlPlaneClient

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

Formats the value using the given formatter.