Struct DeepAgent 

pub struct DeepAgent { /* private fields */ }

Core Deep Agent runtime implementation

This struct contains all the runtime state and behavior for a Deep Agent, including middleware management, tool execution, HITL support, and state persistence.

Implementations

impl DeepAgent

pub async fn save_state(&self, thread_id: &String) -> Result<(), Error>

Save the current agent state to the configured checkpointer.

pub async fn load_state(&self, thread_id: &String) -> Result<bool, Error>

Load agent state from the configured checkpointer.

pub async fn delete_thread(&self, thread_id: &String) -> Result<(), Error>

Delete saved state for the specified thread.

pub async fn list_threads(&self) -> Result<Vec<String>, Error>

List all threads with saved state.

pub fn current_interrupt(&self) -> Option<AgentInterrupt>

Get the current pending interrupt, if any.

pub async fn resume_with_approval( &self, action: HitlAction, ) -> Result<AgentMessage, Error>

Resume execution after human approval of an interrupt.

pub async fn handle_message( &self, input: impl AsRef<str>, state: Arc<AgentStateSnapshot>, ) -> Result<AgentMessage, Error>

Handle message from string input - converts string to AgentMessage internally

pub async fn handle_message_with_metadata( &self, input: impl AsRef<str>, metadata: Option<MessageMetadata>, state: Arc<AgentStateSnapshot>, ) -> Result<AgentMessage, Error>

Handle message from string input with metadata - converts string to AgentMessage internally

Trait Implementations

impl AgentHandle for DeepAgent

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

where 'life0: 'async_trait, DeepAgent: 'async_trait,

fn handle_message<'life0, 'async_trait>( &'life0 self, input: AgentMessage, _state: Arc<AgentStateSnapshot>, ) -> Pin<Box<dyn Future<Output = Result<AgentMessage, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, DeepAgent: 'async_trait,

fn handle_message_stream<'life0, 'async_trait>( &'life0 self, input: AgentMessage, _state: Arc<AgentStateSnapshot>, ) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn Stream<Item = Result<StreamChunk, Error>> + Send>>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, DeepAgent: 'async_trait,

Handle a message with streaming response Default implementation falls back to non-streaming handle_message()