87 lines
3.3 KiB
Rust
87 lines
3.3 KiB
Rust
//! # Agent Abstraction Layer (SACP 版本)
|
||
//!
|
||
//! 此 crate 提供 Agent 管理的抽象接口，是 RCoder 架构的中间层。
|
||
//!
|
||
//! ## SACP 迁移说明
|
||
//!
|
||
//! 本模块已迁移至 SACP (Symposium ACP) 实现：
|
||
//! - **移除 Client trait**: `AcpSessionManager<N, R>` 不再需要 `Client` 泛型参数
|
||
//! - **支持 Send trait**: 可使用标准 `tokio::spawn`，无需 `LocalSet`
|
||
//! - **简化架构**: 移除了 channel handler，SACP 内部使用回调处理
|
||
//!
|
||
//! ## 架构位置
|
||
//!
|
||
//! ```text
|
||
//! shared_types (基础类型: ProjectAndAgentInfo, AgentLifecycleGuard)
|
||
//! ↓
|
||
//! agent_abstraction (抽象接口) ← 你在这里
|
||
//! ↓
|
||
//! agent_runner (具体实现: AgentSessionRegistry, SseSessionNotifier)
|
||
//! ```
|
||
//!
|
||
//! ## 模块职责
|
||
//!
|
||
//! | 模块 | 职责 | 关键类型 |
|
||
//! |------|------|---------|
|
||
//! | [`traits`] | 核心抽象接口定义 | `SessionRegistry`, `SessionNotifier` |
|
||
//! | [`session`] | 会话管理和 Worker 抽象 | `AcpSessionManager`, `AcpAgentWorker` |
|
||
//! | [`launcher`] | Agent 启动和生命周期管理 | `SacpClaudeCodeLauncher` |
|
||
//! | [`acp`] | ACP 协议连接抽象 | `CancelResult` |
|
||
//!
|
||
//! ## Trait 实现指南
|
||
//!
|
||
//! 本 crate 定义的 trait 预期在 `agent_runner` 中实现：
|
||
//!
|
||
//! - [`SessionRegistry`] → `agent_runner::service::AgentSessionRegistry` (全局 `AGENT_REGISTRY`)
|
||
//! - [`SessionNotifier`] → `agent_runner::service::SseSessionNotifier`
|
||
//!
|
||
//! ### 使用模式 (SACP)
|
||
//!
|
||
//! ```ignore
|
||
//! // 在 agent_runner 中：
|
||
//! // 1. 实现 SessionRegistry trait
|
||
//! impl SessionRegistry for AgentSessionRegistry { ... }
|
||
//!
|
||
//! // 2. 通过依赖注入传入 AcpSessionManager（不再需要 Client 类型参数）
|
||
//! let session_manager = AcpSessionManager::new(
|
||
//! Arc::new(notifier), // SessionNotifier 实现
|
||
//! AGENT_REGISTRY.clone(), // SessionRegistry 实现
|
||
//! );
|
||
//! ```
|
||
//!
|
||
//! ## 设计模式
|
||
//!
|
||
//! - **依赖反转（DIP）**: Trait 在此定义，实现在上层 crate
|
||
//! - **泛型参数**: `AcpSessionManager<N, R>` 支持可插拔实现
|
||
//! - **RAII**: 通过 `AgentLifecycleGuard` 管理 Agent 资源生命周期
|
||
//!
|
||
//! ## 与 AGENT_REGISTRY 的关系
|
||
//!
|
||
//! `AGENT_REGISTRY` 是 `agent_runner` 中的全局单例，实现了 `SessionRegistry` trait。
|
||
//! 通过依赖注入传入 `AcpSessionManager`，使得抽象层不依赖具体实现。
|
||
//!
|
||
//! - **直接访问 AGENT_REGISTRY**: 仅在 `agent_runner` 内部使用（如清理任务、状态查询）
|
||
//! - **通过 SessionRegistry trait**: 在 `agent_abstraction` 内部使用（会话管理逻辑）
|
||
|
||
pub mod acp;
|
||
pub mod error;
|
||
pub mod launcher;
|
||
pub mod mirror_env;
|
||
pub mod path_env;
|
||
pub mod session;
|
||
pub mod traits;
|
||
|
||
// Re-export types from submodules
|
||
pub use acp::{CancelNotificationRequestWrapper, CancelResult};
|
||
pub use error::AgentAbstractionError;
|
||
pub use launcher::{
|
||
AgentLaunchConfig, AgentLifecycleGuard, ClaudeCodeLauncher, LauncherConnectionInfoComplete,
|
||
convert_context_servers, get_default_agent_config, load_agent_config,
|
||
};
|
||
pub use session::{
|
||
AcpAgentWorker, AcpSessionManager, AgentWorker, SessionHandles, WorkerRequest, WorkerResponse,
|
||
};
|
||
pub use traits::agent::{AgentStartConfig, PromptMessage};
|
||
pub use traits::session_notifier::SessionNotifier;
|
||
pub use traits::session_registry::SessionRegistry;
|