Skip to main content

wordval_agent/
lib.rs

1//! # wordval-agent
2//!
3//! Wordval Agent 框架插件:完整 Agent 能力(ReasonAct 循环、工具系统、MCP)。
4//!
5//! ## 模块导览
6//!
7//! - [`core`] — 执行核心:消息模型、事件流、ReasonAct 循环、中间件、分层记忆
8//! - [`tools`] — 工具系统:`#[tool]` 宏注册表 + 文件/命令/Web/插件工具
9//! - [`skill`] — 技能系统:SKILL.md 目录扫描 + use_skill 工具
10//! - [`llm`] — LLM 客户端:OpenAI 兼容 / ollama 流式对话
11//! - [`mcp_server`] — MCP server 端点(streamable HTTP,工具暴露给大模型)
12//! - [`a2a_server`] — A2A server 端点(AgentCard 发布 + JSON-RPC,供外部 Agent 编排)
13//!
14//! ## 启用方式
15//!
16//! 在 `config.toml` 中设置 `plugins.enabled = ["agent"]`,框架会自动装配 `AgentPlugin`。
17//!
18//! ## 设计原则
19//!
20//! Agent 核心是框架层,不绑定具体业务表;LLM 模型配置加载等业务逻辑由使用方注入。
21
22#![allow(dead_code)]
23
24pub mod a2a_server;
25pub mod core;
26pub mod llm;
27pub mod mcp_server;
28pub mod plugin;
29pub mod skill;
30pub mod tools;
31
32/// 常用导出
33pub use plugin::AgentPlugin;
34
35/// HITL(人工确认中断/恢复)常用导出
36pub use core::hitl::{
37    CallDecision, ConfirmMode, InMemoryPendingStore, InterruptedRun, JsonFilePendingStore,
38    MySqlPendingStore, PendingConfirm, PendingInterrupt, PendingInterruptStore, PendingStatus,
39    RedisPendingStore, ResumeRequest,
40};
41pub use core::loop_runner::{abort_pause, resume_loop};
42
43/// wordval-agent 内部 prelude(对应 wordval::prelude 的等价物)
44///
45/// agent 核心代码统一从这里取 ApiError / JsonValue / cfg() / db() / cache(),
46/// 使 crate 不依赖 wordval 聚合 crate(避免 wordval → wordval-plugin → wordval-agent 循环依赖)。
47pub mod prelude {
48    pub use serde_json::{json, Value as JsonValue};
49    pub use wordval_cache::Cache;
50    pub use wordval_core::{trace_error, ApiError, Error, Plugin, PluginManager, Result};
51    pub use wordval_db::{Db, Row, RowExt, Q};
52    pub use wordval_utils::{StrExt, Valid};
53    pub use wordval_web::resources::{
54        cache, cfg, db, db_default, set_cache, set_config, set_db, try_cache, try_config, try_db,
55    };
56}