converge-provider 3.9.0

The capability and backend selection contract for Converge providers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

// Copyright 2024-2026 Reflective Labs

// SPDX-License-Identifier: MIT

//! # Converge Provider
//!
//! This crate defines the provider-facing capability contract for Converge.
//! It is deliberately separate from pack authoring:
//!
//! - chat traits and request/response types live here
//! - [`Backend`] and [`BackendKind`] describe provider identity
//! - [`Capability`] describes what a provider can do
//! - [`BackendRequirements`] and [`BackendSelector`] drive routing
//! - [`BackendError`] is the generic provider error surface
//!
//! Suggestor and invariant authoring do not live here. Those contracts belong to
//! `converge-pack`.

pub mod backend;
pub mod capability;
pub mod chat;
pub mod error;
pub mod registry;
pub mod selection;

pub use backend::{Backend, BackendKind};
pub use capability::Capability;
pub use chat::{
    BoxFuture, ChatBackend, ChatMessage, ChatRequest, ChatResponse, ChatRole, DynChatBackend,
    FinishReason, LlmError, ResponseFormat, TokenUsage, ToolCall, ToolDefinition,
};
pub use error::{BackendError, BackendErrorKind};
pub use registry::{
    ChatBackendCapabilities, ChatBackendDescriptor, ChatBackendRegistry, ContextWindowTokens,
    LatencyMillis, ModelName, ProviderName, QualityScore, RegisteredChatBackend,
    RegistryValueError, ResolvedChatBackend,
};
pub use selection::{
    AgentRequirements, BackendRequirements, BackendSelector, CapabilityAssignment,
    ChatBackendSelectionConfig, ChatBackendSelectionConfigError, ComplianceLevel, CostClass,
    CostTier, DataSovereignty, Jurisdiction, LatencyClass, ModelSelectorTrait, ProviderAssignment,
    ProviderRequest, RequiredCapabilities, SelectionCriteria, TaskComplexity,
};