agent_client_protocol/concepts/mod.rs
1//! Core concepts for understanding and using agent-client-protocol.
2//!
3//! This module provides detailed explanations of the key concepts you need
4//! to work effectively with the agent-client-protocol SDK. Read these in order for a progressive
5//! introduction, or jump to specific topics as needed.
6//!
7//! # Table of Contents
8//!
9//! 1. [ACP Basics][`crate::concepts::acp_basics`] - The roles in the protocol: clients,
10//! agents, proxies, and conductors.
11//!
12//! 2. [Connections][`crate::concepts::connections`] - How to establish connections
13//! using link types and connection builders.
14//!
15//! 3. [Sessions][`crate::concepts::sessions`] - Creating and managing sessions for
16//! multi-turn conversations with agents.
17//!
18//! 4. [Callbacks][`crate::concepts::callbacks`] - Handling incoming messages with
19//! `on_receive_*` methods.
20//!
21//! 5. [Explicit Peers][`crate::concepts::peers`] - Using `_to` and `_from` variants
22//! when you need to specify which peer you're communicating with.
23//!
24//! 6. [Ordering][`crate::concepts::ordering`] - How the dispatch loop processes
25//! messages and what ordering guarantees you get.
26//!
27//! 7. [Proxies and Conductors][`crate::concepts::proxies`] - Building proxies that
28//! intercept and modify messages between clients and agents.
29//!
30//! 8. [Error Handling][`crate::concepts::error_handling`] - Protocol errors vs
31//! connection errors, and how to handle them.
32
33pub mod acp_basics;
34pub mod callbacks;
35pub mod connections;
36pub mod error_handling;
37pub mod ordering;
38pub mod peers;
39pub mod proxies;
40pub mod sessions;