agentconnect.communication.protocols.base module

Foundation for all communication protocols in the AgentConnect framework.

This module defines the core protocol interface that standardizes message format and validation across different communication patterns, enabling consistent peer-to-peer agent interactions and collaboration.

class BaseProtocol

Bases: ABC

Foundation for all agent communication protocols.

This abstract class defines the common interface and baseline functionality for all communication protocols, ensuring consistent message handling across different interaction patterns. It provides the foundation for both basic agent-to-agent messaging and more complex collaboration patterns based on capability discovery.

The protocol system enables standardized communication without requiring central control of agent behavior - it simply ensures messages are properly formatted, signed, and validated.

abstractmethod async format_message(sender_id, receiver_id, content, sender_identity, message_type=MessageType.TEXT, metadata=None)

Format a message according to protocol specifications.

Parameters:

  • sender_id (str) – ID of the sending agent

  • receiver_id (str) – ID of the receiving agent

  • content (str) – Message content

  • sender_identity (AgentIdentity) – Identity of the sending agent

  • message_type (MessageType) – Type of message being sent

  • metadata (Optional[Dict]) – Additional metadata for the message

Return type:

Message

Returns:

A properly formatted Message object

abstractmethod async validate_message(message)

Validate message format and contents.

Parameters:

message (Message) – The message to validate

Return type:

bool

Returns:

True if the message is valid, False otherwise