Struct Confirmer 

pub struct Confirmer { /* private fields */ }

Tool confirmation coordinator for Bot platforms.

One Confirmer is shared across all chat sessions (wrapped in Arc). Pending confirmations are keyed by "{chat_id}:{tool_call_id}".

Implementations

impl Confirmer

pub fn new(platform_sender: Arc<dyn PlatformSender>, timeout: Duration) -> Self

Create a new Confirmer.

pub fn with_keywords( platform_sender: Arc<dyn PlatformSender>, timeout: Duration, keywords: ConfirmKeywords, ) -> Self

Create a Confirmer with custom keywords.

pub async fn request( &self, chat_id: &str, info: &ToolCallInfo, auto_approve: bool, ) -> Result<bool>

Request tool confirmation. Sends a prompt message to the chat and waits for the user to reply with an approve/reject keyword.

• If auto_approve is true, returns true immediately without sending.
• Returns true if approved, false if rejected or timed out.

pub fn check_confirmation_response( &self, chat_id: &str, text: &str, ) -> Option<bool>

Check whether a user message is a confirmation reply for a pending request in chat_id. If it matches a keyword, the pending entry is consumed and the waiting request() is unblocked.

Returns Some(approved) if the message was a confirmation reply, None if there was no pending confirmation or the message didn’t match a keyword.

pub fn cleanup_expired(&self)

Periodically clean up expired pending confirmations.

Expired entries are removed; their waiting request() calls will then time out on their own tokio::time::timeout.