llm-trait 0.1.0

//! # llm-trait
//!
//! Trait definitions and core types for LLM providers.
//!
//! This crate is the **interface layer** — extremely lightweight, with no heavy
//! dependencies. It defines the traits and types that both `llm-unified`
//! (implementation) and consumer applications (runtimes, CLIs, servers) depend on.
//!
//! ## Architecture
//!
//! ```text
//! ┌──────────────────────────┐    ┌──────────────────────────┐
//! │     llm-unified          │    │     your app             │
//! │     (implementation)     │    │     (runtime)            │
//! └──────────┬───────────────┘    └──────────┬───────────────┘
//!            │                               │
//!            │  depends on                   │  depends on
//!            ▼                               ▼
//! ┌──────────────────────────────────────────────────────────┐
//! │                    llm-trait (this crate)                 │
//! │  LlmProvider trait, RawAdapter trait, core types         │
//! └──────────────────────────────────────────────────────────┘
//! ```
//!
//! ## Quick Start
//!
//! ```
//! use llm_trait::{LlmConfig, LlmProvider, ChatRequest, ChatMessage};
//! ```

pub mod backend;
pub mod capabilities;
pub mod config;
pub mod error;
pub mod http_client;
pub mod message;
pub mod provider;
pub mod raw_adapter;
pub mod reasoning;
pub mod request;
pub mod response;
pub mod types;

// Re-export key types at crate root for convenience.
pub use backend::Protocol;
pub use capabilities::{Capabilities, ProviderInfo};
pub use config::LlmConfig;
pub use error::LlmError;
pub use http_client::{HttpClient, HttpResponse, ReqwestHttpClient};
pub use message::{ChatMessage, ImageAttachment, ImageDetail, ToolCallMessage};
pub use provider::LlmProvider;
pub use raw_adapter::{CallMode, HttpMethod, RawAdapter, RawRequest, StreamState};
pub use reasoning::{ReasoningConfig, ReasoningEffort, ReasoningMode, ReasoningSpec};
pub use request::{ChatRequest, ResponseFormat};
pub use response::{
    ChatResponse, ChatStream, FinishReason, StreamChunk, ToolCall, extract_tool_calls,
    parse_finish_reason,
};
pub use types::UsageInfo;