Skip to main content

Client

Struct Client 

Source
pub struct Client { /* private fields */ }
Expand description

The daemon’s HTTP surface behind one handle — see the module docs. Construct with Client::new from the daemon’s published base address (e.g. http://127.0.0.1:49152).

Implementations§

Source§

impl Client

Source

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

Source

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

Attach the daemon auth signature (the pre-derived sha256=<hex(SHA256(DAEMON_SECRET))>). Without it the daemon must be running without a secret.

Source

pub fn identity(self, identity: Identity) -> Self

Attach this client’s caller identity — the default identity bag for every surface that carries one (/execute’s X-OBJECTIVEAI-* headers). A per-call identity passed to execute overrides it call-by-call.

Source

pub fn address(&self) -> &str

The daemon’s base address (trimmed), as constructed.

Source

pub async fn open_sse(&self, route: &str) -> Result<EventSource, Error>

Open {address}{route} as an SSE stream and WAIT for it to open — the Open frame (the 2xx response) must arrive before this returns. 401s and transport failures surface here.

PUBLIC as a low-level escape hatch: proxies (the viewer’s Rust shell) forward RAW SSE bodies to their own consumers — a shape the materialized listeners deliberately don’t serve.

Source

pub fn request(&self, method: Method, route: &str) -> RequestBuilder

A plain request to {address}{route} with the signature stamped. PUBLIC as a low-level escape hatch (see open_sse); the typed surfaces are the front door.

Source

pub async fn command_listener(&self) -> Result<CommandListener, Error>

The /listen broadcast as a typed stream — CommandListener: every CLI execution the daemon runs, request + response items, dispatched onto the command tree’s leaf types.

Source

pub async fn agents_instances_list_listener( &self, ) -> Result<AgentsInstancesListListener, Error>

The /agents/instances/list view: every agent’s active/inactive status, live.

Source

pub async fn agents_instances_listener( &self, agent_instance_hierarchy: &str, ) -> Result<AgentsInstancesListener, Error>

The /agents/instances/{aih} view: ONE agent’s full conversation, DB history + live rows.

Source

pub async fn laboratories_list_listener( &self, ) -> Result<LaboratoriesListListener, Error>

The /laboratories/list view: the live laboratories merge (connected ∪ local scan).

Source

pub async fn laboratories_listener( &self, laboratory_id: &str, ) -> Result<LaboratoriesListener, Error>

The /laboratories/{id} view: ONE laboratory’s record with attachments.

Source

pub async fn channel_listener(&self) -> Result<ChannelListener, Error>

The /channels offer-lifecycle view — answer its offers with accept_channel.

Source

pub async fn accept_channel(&self, channel_id: &str) -> Result<String, Error>

Accept an open channel offer: a bare POST /channels/{id}/accept (first-wins). Returns the owner secret (S_owner) from the response body — the per-channel capability for channels logs reply|list|open|subscribe and channels close.

Source

pub async fn file_tree(&self, laboratory_id: &str) -> Result<FileTree, Error>

The /laboratories/{id}/filetree view: one laboratory’s live file tree.

Source

pub async fn get_viewer_plugin( &self, owner: &str, name: &str, version: &str, ) -> Result<ViewerPlugin, Error>

Download a plugin’s viewer-extension bundle: GET /plugins/{owner}/{name}/{version}/viewer, the daemon building it on demand and streaming tar.gz back. LOW-LEVEL by design — raw bytes, no filesystem; the caller un-tars its own way. version is the plugin repo’s v-prefixed git tag (v1.2.3), byte-for-byte.

Trait Implementations§

Source§

impl Clone for Client

Source§

fn clone(&self) -> Client

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl CommandExecutor for Client

Available on crate feature cli-executor only.

POST /execute — the Client IS the executor: each command is one POST whose result streams back as SSE, run in-process by the daemon with the crate::identity::Identity headers applied as a per-request config override (a missing header DELETES that field for the run — the daemon never inherits its own resident value). The plugin_* trio is deliberately never stamped: plugin caller identity is unspoofable — only the daemon’s own plugins run may assert it. Dropping the returned stream aborts the request, which cancels the in-process run.

Source§

type Error = ExecuteError

Source§

type Stream<T> = Pin<Box<dyn Stream<Item = Result<T, ExecuteError>> + Send>> where T: Send + 'static

Source§

async fn execute<R, T>( &self, request: R, identity: Option<&Identity>, ) -> Result<Self::Stream<T>, ExecuteError>

Source§

async fn execute_one<R, T>( &self, request: R, identity: Option<&Identity>, ) -> Result<T, ExecuteError>

Convenience for unary commands: run the request and resolve the first item from the stream. Implementations should error with their own “empty stream” variant if the stream closes without producing an item.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToAst for T

Source§

fn ast(self, begin: usize, end: usize) -> Spanned<Self>

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more