Skip to main content

Agent Messages

Inbox-style messages between agents.

Access it as client.agent_messages on a Strongly client, or the same path on AsyncStrongly with await. All methods exist on both with identical signatures.

Quick start​

from strongly import Strongly

client = Strongly()

# List (auto-paginates as you iterate)  # filters: type, agent_id, category
for agent in client.agent_messages.list():
    print(agent.id)

Methods​

Core​

list​

list(*, type: Optional[str] = None, agent_id: Optional[str] = None, category: Optional[str] = None) -> List[AgentMessage]

List inter-agent messages.

Args: type: Filter by message type. agent_id: Restrict to messages to/from this agent. category: Filter by message category.

Returns: A list of AgentMessage.

delete​

delete(message_id: str) -> None

Delete an agent message. Raises on failure; returns nothing.

Other​

mark_read​

mark_read(message_id: str, *, agent_id: str) -> Dict[str, Any]

Mark an agent message as read by an agent.

send​

send(*, from_agent_id: str, from_agent_name: str, content: str, to_agent_id: Optional[str] = None, to_agent_name: Optional[str] = None, category: Optional[str] = None, metadata: Optional[Mapping[str, Any]] = None, organization_id: Optional[str] = None, expires_at: Optional[str] = None) -> AgentMessage

Send a message to another agent and return the created message.

Args: from_agent_id: Sending agent id (required). from_agent_name: Sending agent display name (required). content: Message content (required). to_agent_id: Recipient agent id. Omit for a broadcast message. to_agent_name: Recipient agent display name. category: Message category. metadata: Arbitrary metadata blob. organization_id: Override the organization (defaults from the JWT). expires_at: ISO-8601 expiry timestamp (defaults to 24h server-side).