Struct TextAgentTool 

pub struct TextAgentTool { /* private fields */ }

Wraps a TextAgent as a ToolFunction for live session tool dispatch.

Unlike AgentTool (which wraps a live Agent), TextAgentTool wraps a text-mode agent that uses BaseLlm::generate(). This enables multi-step LLM reasoning pipelines to be invoked as tools from a voice session.

State Sharing

The text agent operates on the same shared State as the voice session. This means:

• The agent can read live-extracted values (emotional_state, risk_level)
• Agent state mutations are visible to watchers and phase transitions
• No explicit “promote state” step is needed

Example

let verifier = LlmTextAgent::new("verifier", flash)
    .instruction("Cross-reference identity against account record")
    .tools(Arc::new(db_dispatcher));

let tool = TextAgentTool::new("verify_identity", "Verify caller identity", verifier, state);
dispatcher.register(tool);

Implementations

impl TextAgentTool

pub fn new( name: impl Into<String>, description: impl Into<String>, agent: impl TextAgent + 'static, state: State, ) -> Self

Create a new TextAgentTool wrapping the given text agent.

state should be the session’s shared State so mutations flow bidirectionally between the voice session and the text agent.

pub fn from_arc( name: impl Into<String>, description: impl Into<String>, agent: Arc<dyn TextAgent>, state: State, ) -> Self

Create from an already-Arc’d text agent.

pub fn with_parameters(self, params: Value) -> Self

Override the tool parameters schema.

Trait Implementations

impl ToolFunction for TextAgentTool

fn name(&self) -> &str

The unique name of this tool.

fn description(&self) -> &str

Human-readable description of what this tool does.

fn parameters(&self) -> Option<Value>

JSON Schema for the tool’s input parameters, or None if parameterless.

fn call<'life0, 'async_trait>( &'life0 self, args: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, ToolError>> + Send + 'async_trait>>

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

Execute the tool with the given arguments and return the result.