Module runtime 

Agent 运行时 — 编排循环、防御机制、工具系统。

提供 ToolUseLoop、AgentBuilder 以及防御机制 （重试策略、Fallback 等）。

Re-exports

pub use tools::BatchExecutionResult;

pub use tools::CompositeCatalog;

pub use tools::StaticCatalog;

pub use tools::ToolCatalog;

pub use tools::ToolExecutor;

pub use tools::ToolSnapshot;

pub use tools::execute_batch_with;

pub use builder::AgentBuilder;

pub use config::ToolCachePolicy;

pub use config::ToolUseConfig;

pub use config::ToolUseDeps;

pub use context::CompactionResult;

pub use context::ContextBudget;

pub use context::ContextCompactor;

pub use context::LocalCompactor;

pub use context::estimate_message;

pub use context::estimate_text;

pub use context::estimate_tokens;

pub use event::AgentEvent;

pub use event::AgentStream;

pub use event::StopReason;

pub use fallback::DefaultFallback;

pub use fallback::FallbackAction;

pub use fallback::FallbackContext;

pub use fallback::FallbackStrategy;

pub use react::StopConfig;

pub use request_opts::RequestOptions;

pub use retry::BackoffStrategy;

pub use retry::RetryPolicy;

pub use runtime::ResolvedRound;

pub use runtime::ToolUseLoop;

pub use runtime::ToolUseResult;

pub use typed_state::AgentMutation;

pub use typed_state::AgentState;

pub use stream_translation::AgentStreamEvent;

pub use stream_translation::TranslationResult;

pub use stream_translation::translate_provider_event;

Modules

builder

AgentBuilder — Agent 链式构建器。

config

ToolUseLoop 配置与请求构建辅助。

context

上下文预算管理 — 控制 Agent Loop 中 messages 的 Token 总量。

event

Agent 层流式事件与停止原因。

event_bridge

AgentEventSink — StreamChunk → AgentEvent 桥接。

fallback

降级策略 — Provider 错误时的恢复决策。

invoker

LlmInvoker — 封装 LLM 调用的防御策略层。

react

ReAct Graph — ToolUseLoop 内部构建的有环图。

request_opts

RequestOptions — Agent 每轮 LLM 调用的生成参数。

retry

工具重试策略 — 瞬时故障恢复（“再试一次”）。

runtime

Agent Loop — LLM ↔ 工具调用闭环。

stream_translation

ProviderEvent → AgentStreamEvent → StreamChunk 三层转换模型。

tools

工具系统 — 执行、目录抽象。

typed_state

Agent Typed State + Mutation — 编译期类型安全的 Agent 状态。

Structs

ExecutableTool

可执行的工具 — 定义 + 安全元数据 + 执行器。

ResolvedModel

解析后的模型 — 从 Registry 中解析 RouteEntry 得到

ToolCategory

工具类别 — 用于 CategoryExclusive 的分组

ToolError

工具执行错误 — 携带错误分类与详细描述。

Enums

ParallelSafety

工具并行安全分级

ToolErrorKind

工具执行错误的分类。

Traits

IntoToolError

将已知错误类型转换为 ToolError。

IntoToolResult

将工具函数返回值统一转换为 ToolResult。

ToolArgs

工具参数 trait — 由 #[tool] 宏自动生成。

Type Aliases

ToolFn

异步工具执行函数类型 — 接受 JSON 参数，返回 boxed future。

ToolResult

工具执行结果 — serde_json::Value 支持结构化数据。