Skip to main content

ThreadHandle

Struct ThreadHandle 

Source
pub struct ThreadHandle {
    pub events: UnboundedReceiver<AgentEvent>,
    /* private fields */
}
Expand description

A live connection to one thread of a running local system: send it inputs and receive its events. Created by super::ThreadBuilder::launch or by reattaching through super::LaunchingSystem::thread_handle.

Dropping the handle detaches it; the thread itself is unaffected.

Fields§

§events: UnboundedReceiver<AgentEvent>

The thread’s events, in emission order, starting from the moment the handle attached. Every event is either reflected in replay or delivered here, exactly once.

Implementations§

Source§

impl ThreadHandle

Source

pub fn thread_id(&self) -> &ThreadId<str>

The thread this handle is attached to.

Source

pub fn replay(&self) -> &ReplaySnapshot

The state of the thread at the moment the handle attached: committed history plus any in-flight turn and in-progress reasoning.

Source

pub async fn recv(&mut self) -> Option<AgentEvent>

Receive the thread’s next event. Returns None only after the system has shut down.

Source

pub async fn send_user_text( &self, text: impl Into<String>, ) -> Result<(), ChannelSendError>

Send plain user text to the thread.

Source

pub async fn send( &self, message: InputMessage, dedup_id: &str, ) -> Result<(), ChannelSendError>

Send an input message to the thread. The message’s group_id is overwritten with this handle’s thread ID; dedup_id should be stable across redeliveries of the same message.

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> 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> 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, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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<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