Praison AI

Outbound Messenger Protocol • AI Agent SDK

OutboundMessengerProtocol: Protocol for agent-facing proactive message delivery.

OutboundMessengerProtocol

Defined in the protocols module.

AI Agent

Protocol for agent-facing proactive message delivery.

A concrete implementation is provided by the running gateway/bot (in the praisonai wrapper) and registered into the per-turn context so the built-in `send_message` tool can resolve it. It bridges to the existing delivery stack (DeliveryRouter, HomeChannelRegistry, outbox, mirroring).

Example usage (implementation in praisonai_bot.gateway)::

messenger = BotOutboundMessenger(bot, resolver, router) token = register_outbound_messenger(messenger) try: … # agent runs; send_message tool resolves the messenger finally: clear_outbound_messenger(token)

Methods

send()

Deliver a message to a symbolic target.

 list_targets()

List the targets currently reachable from this runtime.

 react()

Add (or remove) a reaction on a message (Issue #3917).

 create_thread()

Open a new thread/topic under `target` (Issue #3987).

 edit()

Edit a prior message this agent/session sent (Issue #5054).

 delete()

Delete/unsend a prior message this agent/session sent (Issue #5054).

Source

View on GitHub

praisonaiagents/gateway/protocols.py at line 3569