Struct AcpSession 

pub struct AcpSession { /* private fields */ }

A live ACP session (the AgentSession impl).

Reading is INLINE in AcpSession::next_event (no reader task), which keeps memory bounded by [BoundedLines] and is deadlock-free for this protocol: the peer blocks waiting for each permission answer, and the read loop answers permission requests synchronously as they arrive, so stdin writes never wait on a peer that is itself waiting on a full stdout pipe.

Trait Implementations

impl AgentSession for AcpSession

fn session_id(&self) -> String

The session id actually in use (== spec.session_id unless resumed).

fn next_event<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Option<AgentEvent>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Next event from the session stream; None when the stream is closed.

fn send_user_message<'life0, 'life1, 'async_trait>( &'life0 mut self, text: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Inject a user message (streaming-input sessions only; error otherwise).

fn abort<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Terminate the underlying process/stream. Must kill the whole process tree and work on Windows (no bare POSIX signal assumptions — §9).

fn exit_status(&self) -> Option<SessionExit>

Available after the stream has closed.

impl Drop for AcpSession

Available on Unix only.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.