Module concepts 

Core concepts for understanding and using agent-client-protocol Core concepts for understanding and using agent-client-protocol.

This module provides detailed explanations of the key concepts you need to work effectively with the agent-client-protocol SDK. Read these in order for a progressive introduction, or jump to specific topics as needed.

Table of Contents

1. ACP Basics - The roles in the protocol: clients, agents, proxies, and conductors.

2. Connections - How to establish connections using link types and connection builders.

3. Sessions - Creating and managing sessions for multi-turn conversations with agents.

4. Callbacks - Handling incoming messages with on_receive_* methods.

5. Explicit Peers - Using _to and _from variants when you need to specify which peer you’re communicating with.

6. Ordering - How the dispatch loop processes messages and what ordering guarantees you get.

7. Proxies and Conductors - Building proxies that intercept and modify messages between clients and agents.

8. Error Handling - Protocol errors vs connection errors, and how to handle them.

Modules

acp_basics

The roles in ACP: clients, agents, proxies, and conductors.

callbacks

Handling incoming messages with on_receive_* callbacks.

connections

Establishing connections using role types and connection builders.

error_handling

Error handling patterns in agent-client-protocol.

ordering

Message ordering, concurrency, and the dispatch loop.

peers

Explicit peers: using _to and _from variants.

proxies

Building proxies that intercept and modify messages.

sessions

Creating and managing sessions for multi-turn conversations.