Skip to main content

SessionAgent

Struct SessionAgent 

Source
pub struct SessionAgent<M, C, T, R>
where M: Clone + Serialize + DeserializeOwned + Into<InputItem> + Send + Sync + 'static, C: TypedTool + Clone + Serialize + DeserializeOwned + Send + Sync + 'static, T: Clone + Serialize + DeserializeOwned + Send + Sync + 'static, R: Clone + Serialize + DeserializeOwned + JsonSchema + Send + Sync + 'static,
{ /* private fields */ }
Expand description

Default model-backed implementation of super::Agent.

SessionAgent owns the runner, context manager, execution profile, optional typed tool execution, and the mutable turn/session state required to drive a conversation.

Implementations§

Source§

impl<M, C, T, R> SessionAgent<M, C, T, R>
where M: Clone + Serialize + DeserializeOwned + Into<InputItem> + Send + Sync + 'static, C: TypedTool + Clone + Serialize + DeserializeOwned + Send + Sync + 'static, T: Clone + Serialize + DeserializeOwned + Send + Sync + 'static, R: Clone + Serialize + DeserializeOwned + JsonSchema + Send + Sync + 'static,

Source

pub async fn send(&mut self, input: AgentInput<M>) -> AgentResult<()>

Source

pub async fn send_with_profile( &mut self, input: AgentInput<M>, profile: ExecutionProfile, ) -> AgentResult<()>

Source

pub async fn next(&mut self) -> AgentResult<Option<AgentEvent<C, T, R>>>

Source

pub async fn spawn( self, ) -> AgentResult<(AgentRunInput<M>, AgentRunOutput<C, T, R>)>

Source

pub async fn transcript(&self) -> AgentResult<Vec<InputItem>>

Source

pub fn active_turn(&self) -> Option<u64>

Source

pub fn queued_turn_count(&self) -> usize

Source§

impl SessionAgent<String, (), (), String>

Source§

impl SessionAgent<InputItem, (), (), String>

Trait Implementations§

Source§

impl<M, C, T, R> Agent for SessionAgent<M, C, T, R>
where M: Clone + Serialize + DeserializeOwned + Into<InputItem> + Send + Sync + 'static, C: TypedTool + Clone + Serialize + DeserializeOwned + Send + Sync + 'static, T: Clone + Serialize + DeserializeOwned + Send + Sync + 'static, R: Clone + Serialize + DeserializeOwned + JsonSchema + Send + Sync + 'static,

Source§

type Input = M

Input message type accepted by the agent.
Source§

type ToolCall = C

Tool call type emitted by the agent.
Source§

type ToolResult = T

Tool result type returned into the agent after execution.
Source§

type Output = R

Final structured reply type produced by the agent.
Source§

async fn send(&mut self, input: AgentInput<Self::Input>) -> AgentResult<()>

Sends an input into the session.
Source§

async fn next( &mut self, ) -> AgentResult<Option<AgentEvent<Self::ToolCall, Self::ToolResult, Self::Output>>>

Advances the session and yields the next event, if any.
Source§

async fn spawn( self, ) -> AgentResult<(AgentRunInput<Self::Input>, AgentRunOutput<Self::ToolCall, Self::ToolResult, Self::Output>)>

Spawns the agent as a background task and exposes channel-based I/O.
Source§

async fn cast(&mut self, input: Self::Input) -> AgentResult<()>

Sends a normal user message without waiting for completion.
Source§

async fn call(&mut self, input: Self::Input) -> AgentResult<Self::Output>

Sends a normal user message and waits for the terminal reply.
Source§

async fn steer(&mut self, input: Self::Input) -> AgentResult<Self::Output>

Sends steering input and waits for the resulting terminal reply.
Source§

async fn cancel(&mut self) -> AgentResult<()>

Requests cancellation and waits until the session observes it.

Auto Trait Implementations§

§

impl<M, C, T, R> Freeze for SessionAgent<M, C, T, R>
where C: Freeze,

§

impl<M, C, T, R> !RefUnwindSafe for SessionAgent<M, C, T, R>

§

impl<M, C, T, R> Send for SessionAgent<M, C, T, R>

§

impl<M, C, T, R> Sync for SessionAgent<M, C, T, R>

§

impl<M, C, T, R> Unpin for SessionAgent<M, C, T, R>
where M: Unpin, R: Unpin, C: Unpin, T: Unpin,

§

impl<M, C, T, R> UnsafeUnpin for SessionAgent<M, C, T, R>
where C: UnsafeUnpin,

§

impl<M, C, T, R> !UnwindSafe for SessionAgent<M, C, T, R>

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