添加qiming-rcoder模块

qiming-rcoder/crates/agent_abstraction/src/lib.rs

@@ -0,0 +1,86 @@
+//! # 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;