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
impl Client
pub fn new(address: impl Into<String>) -> Self
Sourcepub fn signature(self, signature: impl Into<String>) -> Self
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.
Sourcepub fn identity(self, identity: Identity) -> Self
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.
Sourcepub async fn open_sse(&self, route: &str) -> Result<EventSource, Error>
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.
Sourcepub fn request(&self, method: Method, route: &str) -> RequestBuilder
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.
Sourcepub async fn command_listener(&self) -> Result<CommandListener, Error>
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.
Sourcepub async fn agents_instances_list_listener(
&self,
) -> Result<AgentsInstancesListListener, Error>
pub async fn agents_instances_list_listener( &self, ) -> Result<AgentsInstancesListListener, Error>
The /agents/instances/list view: every agent’s
active/inactive status, live.
Sourcepub async fn agents_instances_listener(
&self,
agent_instance_hierarchy: &str,
) -> Result<AgentsInstancesListener, Error>
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.
Sourcepub async fn laboratories_list_listener(
&self,
) -> Result<LaboratoriesListListener, Error>
pub async fn laboratories_list_listener( &self, ) -> Result<LaboratoriesListListener, Error>
The /laboratories/list view: the live laboratories merge
(connected ∪ local scan).
Sourcepub async fn laboratories_listener(
&self,
laboratory_id: &str,
) -> Result<LaboratoriesListener, Error>
pub async fn laboratories_listener( &self, laboratory_id: &str, ) -> Result<LaboratoriesListener, Error>
The /laboratories/{id} view: ONE laboratory’s record with
attachments.
Sourcepub async fn channel_listener(&self) -> Result<ChannelListener, Error>
pub async fn channel_listener(&self) -> Result<ChannelListener, Error>
The /channels offer-lifecycle view — answer its offers with
accept_channel.
Sourcepub async fn accept_channel(&self, channel_id: &str) -> Result<String, Error>
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.
Sourcepub async fn file_tree(&self, laboratory_id: &str) -> Result<FileTree, Error>
pub async fn file_tree(&self, laboratory_id: &str) -> Result<FileTree, Error>
The /laboratories/{id}/filetree view: one laboratory’s live
file tree.
Sourcepub async fn get_viewer_plugin(
&self,
owner: &str,
name: &str,
version: &str,
) -> Result<ViewerPlugin, Error>
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 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.
impl CommandExecutor for Client
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.
type Error = ExecuteError
type Stream<T> = Pin<Box<dyn Stream<Item = Result<T, ExecuteError>> + Send>> where T: Send + 'static
async fn execute<R, T>(
&self,
request: R,
identity: Option<&Identity>,
) -> Result<Self::Stream<T>, ExecuteError>where
R: CommandRequest + Send + Serialize,
T: CommandResponse + Serialize + DeserializeOwned + Send + 'static,
Source§async fn execute_one<R, T>(
&self,
request: R,
identity: Option<&Identity>,
) -> Result<T, ExecuteError>where
R: CommandRequest + Send + Serialize,
T: CommandResponse + Serialize + DeserializeOwned + Send + 'static,
async fn execute_one<R, T>(
&self,
request: R,
identity: Option<&Identity>,
) -> Result<T, ExecuteError>where
R: CommandRequest + Send + Serialize,
T: CommandResponse + Serialize + DeserializeOwned + Send + 'static,
Auto Trait Implementations§
impl !RefUnwindSafe for Client
impl !UnwindSafe for Client
impl Freeze for Client
impl Send for Client
impl Sync for Client
impl Unpin for Client
impl UnsafeUnpin for Client
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
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