Skip to main content

lellm/
lib.rs

1//! LeLLM — Rust LLM orchestration framework.
2//!
3//! 默认开启 `provider`(core + provider 适配层)。
4//!
5//! ```toml
6//! # 默认:core + provider
7//! lellm = "0.4"
8//!
9//! # 需要 Graph 编排层
10//! lellm = { version = "0.4", features = ["graph"] }
11//!
12//! # 需要 Agent 运行时
13//! lellm = { version = "0.4", features = ["agent"] }
14//!
15//! # 需要 MCP 协议(完整:agent 集成 + http/sse 传输)
16//! lellm = { version = "0.4", features = ["mcp"] }
17//!
18//! # 轻量 MCP:仅 stdio 传输,不拉入 agent/provider(无 reqwest/hyper/TLS)
19//! lellm = { version = "0.4", default-features = false, features = ["mcp-stdio"] }
20//!
21//! # 全部启用
22//! lellm = { version = "0.4", features = ["full"] }
23//! ```
24
25pub mod prelude {
26    #[cfg(feature = "core")]
27    pub use lellm_core::{
28        ChatRequest, ChatResponse, ContentBlock, LlmError, Message, Prompt, ReasoningConfig,
29        TokenUsage, ToolChoice, ToolDefinition, ToolError, ToolErrorKind, ToolResult,
30    };
31
32    #[cfg(feature = "tool")]
33    pub use lellm_core::{ToolArgs, compute_and_clean_schema, safe_fn};
34
35    #[cfg(feature = "provider")]
36    pub use lellm_provider::{
37        Capabilities, CodecProvider, LlmProvider, ModelRouter, ProviderBuilder, ProviderEvent,
38        ProviderRegistry, ProviderStream, ResolvedModel, RouteEntry, TaskLevel,
39    };
40
41    #[cfg(feature = "graph")]
42    pub use lellm_graph::{
43        BarrierDefaultAction, BarrierNode, BarrierSink, ChannelBarrierSink, ConditionNode, Graph,
44        GraphBuilder, LeafContext, LeafNode, NoopBarrierSink, NoopStepCallback, SubgraphSpec,
45        TaskNode, TerminalError,
46    };
47
48    #[cfg(feature = "agent")]
49    pub use lellm_agent::{
50        AgentBuilder, AgentEvent, AgentState, AgentStream, BackoffStrategy, CatalogDiagnostic,
51        CompositeCatalog, ConflictPolicy, ContextBudget, ExecutableTool, FallbackAction,
52        FallbackContext, FallbackStrategy, IntoToolError, IntoToolResult, LocalCompactor,
53        ParallelSafety, RetryPolicy, StaticCatalog, StopReason, ToolCatalog, ToolCategory,
54        ToolExecutor, ToolFn, ToolSnapshot, ToolUseConfig, ToolUseDeps, ToolUseLoop, ToolUseResult,
55        create_agent, create_agent_full, create_agent_with_system, create_agent_with_tools,
56    };
57
58    #[cfg(feature = "mcp")]
59    pub use lellm_agent::{
60        CatalogRefresh, McpCatalog, McpServerRegistry, NameConflictError, NameConflictPolicy,
61        RegistryError, ServerConfig,
62    };
63
64    #[cfg(feature = "derive")]
65    pub use lellm_derive::ToolDefinition;
66
67    #[cfg(feature = "tool")]
68    pub use lellm_derive::tool;
69}
70
71// ─── Crate 级 re-export(向后兼容)─────────────────────────────────
72
73#[cfg(feature = "core")]
74pub use lellm_core as core;
75
76// Note: `lellm::tool` re-export removed — use `lellm::prelude` instead.
77// ToolArgs, compute_and_clean_schema, safe_fn, and #[tool] macro
78// are all available via `lellm::prelude::*`.
79
80#[cfg(feature = "provider")]
81pub use lellm_provider as provider;
82
83#[cfg(feature = "graph")]
84pub use lellm_graph as graph;
85
86#[cfg(feature = "agent")]
87pub use lellm_agent as agent;
88
89#[cfg(any(feature = "mcp", feature = "mcp-stdio"))]
90pub use lellm_mcp as mcp;
91
92#[cfg(feature = "derive")]
93pub use lellm_derive as derive;