solo-api 0.11.0

// SPDX-License-Identifier: Apache-2.0

//! `solo-api` LLM clients that depend on the MCP transport.
//!
//! Other LLM clients (Anthropic, OpenAI, Ollama) live in `solo-storage::llm`
//! because they're HTTP-only and storage-layer-callable. The
//! MCP-sampling client lives here because it needs `rmcp::Peer<RoleServer>`
//! — only available inside the MCP transport.
//!
//! v0.9.0 P2 ships [`sampling::SamplingLlmClient`] + the
//! [`sampling::SamplingClient`] trait the test fixture
//! ([`super::test_support::fake_mcp_client::FakeMcpClient`]) implements.

pub mod sampling;
pub mod sampling_coordinator;

// v0.10.1 F3 — integration test that drives a real `Peer<RoleServer>`
// + a real `ClientHandler` over `tokio::io::duplex`. Pins the rmcp
// concurrency invariant `PeerSamplingClient::call_peer` assumes when N
// parallel `complete()` calls share a single Peer. `#![cfg(test)]`
// inside the file gates the entire module out of non-test builds.
#[cfg(test)]
mod peer_concurrency;

pub use sampling::{
    SamplingClient, SamplingError, SamplingLlmClient, build_sampling_steward,
    DEFAULT_SAMPLING_TIMEOUT,
};
pub use sampling_coordinator::{
    DEFAULT_COALESCE_MAX_BATCH, DEFAULT_COALESCE_WINDOW, SamplingCoordinator,
};