refactor(presenter): rename agent presenters

Author: zerob13

docs/ARCHITECTURE.md

@@ -7,22 +7,22 @@
 ```mermaid
 flowchart LR
     Renderer["Renderer / Stores / Views"] --> Preload["preload IPC bridge"]
-    Preload --> NewAgent["newAgentPresenter"]
+    Preload --> NewAgent["agentSessionPresenter"]
     NewAgent --> Registry["AgentRegistry"]
-    Registry --> DeepChat["deepchatAgentPresenter"]
+    Registry --> DeepChat["agentRuntimePresenter"]
     DeepChat --> Tool["toolPresenter"]
     DeepChat --> Llm["llmProviderPresenter"]
     Tool --> Mcp["mcpPresenter"]
     Tool --> AgentTools["toolPresenter/agentTools"]
     Llm --> Acp["llmProviderPresenter/acp"]
     DeepChat --> SQLite["sqlitePresenter"]
-    NewAgent --> SessionDb["newAgentPresenter/sessionManager"]
+    NewAgent --> SessionDb["agentSessionPresenter/sessionManager"]
 ```
 
 主结论：
 
-- `newAgentPresenter` 是 renderer 唯一会话入口。
-- `deepchatAgentPresenter` 持有聊天 runtime、流式执行、工具交互、暂停恢复。
+- `agentSessionPresenter` 是 renderer 唯一会话入口。
+- `agentRuntimePresenter` 持有聊天 runtime、流式执行、工具交互、暂停恢复。
 - `toolPresenter` 统一路由 MCP tools 与本地 agent tools。
 - `llmProviderPresenter` 统一管理 provider 实例、流状态和 ACP provider helper。
 
@@ -31,8 +31,8 @@ flowchart LR
 | 模块 | 位置 | 职责 |
 | --- | --- | --- |
 | `Presenter` 组装层 | `src/main/presenter/index.ts` | 组装 presenter 依赖，暴露主进程能力 |
-| `NewAgentPresenter` | `src/main/presenter/newAgentPresenter/` | 会话创建、窗口绑定、agent 注册、IPC-facing API |
-| `DeepChatAgentPresenter` | `src/main/presenter/deepchatAgentPresenter/` | 聊天 runtime、stream loop、tool interaction、message persistence |
+| `AgentSessionPresenter` | `src/main/presenter/agentSessionPresenter/` | 会话创建、窗口绑定、agent 注册、IPC-facing API |
+| `AgentRuntimePresenter` | `src/main/presenter/agentRuntimePresenter/` | 聊天 runtime、stream loop、tool interaction、message persistence |
 | `ToolPresenter` | `src/main/presenter/toolPresenter/` | 工具定义聚合、调用路由、权限预检查 |
 | `Agent tools` | `src/main/presenter/toolPresenter/agentTools/` | 文件系统、命令、settings 等本地工具 |
 | `LLMProviderPresenter` | `src/main/presenter/llmProviderPresenter/` | provider 实例、stream state、model 管理、embedding、ACP provider |
@@ -43,7 +43,7 @@ flowchart LR
 
 ### 1. IPC / Session orchestration
 
-`newAgentPresenter` 负责：
+`agentSessionPresenter` 负责：
 
 - 创建/删除/激活会话
 - 绑定 `webContentsId -> sessionId`
@@ -53,7 +53,7 @@ flowchart LR
 
 ### 2. Chat runtime
 
-`deepchatAgentPresenter` 负责：
+`agentRuntimePresenter` 负责：
 
 - `processMessage()` 和 `processStream()` 主循环
 - `sessionStore` / `messageStore` / `pendingInputStore`
@@ -82,7 +82,7 @@ flowchart LR
 
 这次 retirement 后仍然保留的 legacy 边界只有：
 
-- `src/main/presenter/newAgentPresenter/legacyImportService.ts`
+- `src/main/presenter/agentSessionPresenter/legacyImportService.ts`
 - legacy import hook / status tracking
 - 旧 `conversations/messages` 表，作为 import-only 与导出数据源
 - `SessionPresenter` 作为 main 内部数据平面，不再是 renderer 主聊天入口

docs/FLOWS.md

@@ -8,9 +8,9 @@
 ```mermaid
 sequenceDiagram
     participant R as Renderer
-    participant N as NewAgentPresenter
+    participant N as AgentSessionPresenter
     participant A as AgentRegistry
-    participant D as DeepChatAgentPresenter
+    participant D as AgentRuntimePresenter
     participant S as NewSessionManager
 
     R->>N: createSession(input, webContentsId)
@@ -24,9 +24,9 @@ sequenceDiagram
 
 关键文件：
 
-- `src/main/presenter/newAgentPresenter/index.ts`
-- `src/main/presenter/newAgentPresenter/sessionManager.ts`
-- `src/main/presenter/deepchatAgentPresenter/index.ts`
+- `src/main/presenter/agentSessionPresenter/index.ts`
+- `src/main/presenter/agentSessionPresenter/sessionManager.ts`
+- `src/main/presenter/agentRuntimePresenter/index.ts`
 
 ## 2. DeepChat 消息处理主循环
 
@@ -48,16 +48,16 @@ flowchart TD
 
 关键文件：
 
-- `src/main/presenter/deepchatAgentPresenter/process.ts`
-- `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
-- `src/main/presenter/deepchatAgentPresenter/contextBuilder.ts`
-- `src/main/presenter/deepchatAgentPresenter/messageStore.ts`
+- `src/main/presenter/agentRuntimePresenter/process.ts`
+- `src/main/presenter/agentRuntimePresenter/dispatch.ts`
+- `src/main/presenter/agentRuntimePresenter/contextBuilder.ts`
+- `src/main/presenter/agentRuntimePresenter/messageStore.ts`
 
 ## 3. 工具调用与权限
 
 ```mermaid
 sequenceDiagram
-    participant D as DeepChatAgentPresenter
+    participant D as AgentRuntimePresenter
     participant T as ToolPresenter
     participant M as MCP Presenter
     participant G as AgentToolManager
@@ -94,8 +94,8 @@ sequenceDiagram
 ```mermaid
 sequenceDiagram
     participant R as Renderer
-    participant N as NewAgentPresenter
-    participant D as DeepChatAgentPresenter
+    participant N as AgentSessionPresenter
+    participant D as AgentRuntimePresenter
     participant L as LLMProviderPresenter
     participant A as ACP helpers
 
@@ -109,7 +109,7 @@ sequenceDiagram
 
 关键文件：
 
-- `src/main/presenter/newAgentPresenter/index.ts`
+- `src/main/presenter/agentSessionPresenter/index.ts`
 - `src/main/presenter/llmProviderPresenter/index.ts`
 - `src/main/presenter/llmProviderPresenter/acp/`
 
@@ -118,7 +118,7 @@ sequenceDiagram
 ```mermaid
 sequenceDiagram
     participant Hook as lifecycle import hook
-    participant N as NewAgentPresenter
+    participant N as AgentSessionPresenter
     participant I as LegacyChatImportService
     participant DB as SQLite / legacy tables
 
@@ -133,5 +133,5 @@ sequenceDiagram
 
 关键文件：
 
-- `src/main/presenter/newAgentPresenter/legacyImportService.ts`
+- `src/main/presenter/agentSessionPresenter/legacyImportService.ts`
 - `src/main/presenter/lifecyclePresenter/hooks/after-start/legacyImportHook.ts`

docs/README.md

@@ -7,8 +7,8 @@
 ```text
 Renderer
   -> preload IPC
-  -> newAgentPresenter
-  -> deepchatAgentPresenter
+  -> agentSessionPresenter
+  -> agentRuntimePresenter
   -> llmProviderPresenter / toolPresenter / mcpPresenter
   -> sqlitePresenter
 ```
@@ -21,7 +21,7 @@ Renderer
 | --- | --- |
 | [ARCHITECTURE.md](./ARCHITECTURE.md) | 当前主架构总览 |
 | [FLOWS.md](./FLOWS.md) | 当前消息、工具、ACP、导入流程 |
-| [architecture/agent-system.md](./architecture/agent-system.md) | `newAgentPresenter` / `deepchatAgentPresenter` 细节 |
+| [architecture/agent-system.md](./architecture/agent-system.md) | `agentSessionPresenter` / `agentRuntimePresenter` 细节 |
 | [architecture/tool-system.md](./architecture/tool-system.md) | `ToolPresenter`、agent tools、ACP helper 分层 |
 | [architecture/session-management.md](./architecture/session-management.md) | 新会话管理与 legacy 数据平面边界 |
 | [guides/code-navigation.md](./guides/code-navigation.md) | 当前代码导航入口 |

docs/architecture/agent-system.md

@@ -7,9 +7,9 @@
 
 ```mermaid
 flowchart TD
-    UI["Renderer / IPC"] --> NewAgent["NewAgentPresenter"]
+    UI["Renderer / IPC"] --> NewAgent["AgentSessionPresenter"]
     NewAgent --> Registry["AgentRegistry"]
-    Registry --> DeepChat["DeepChatAgentPresenter"]
+    Registry --> DeepChat["AgentRuntimePresenter"]
     DeepChat --> Context["contextBuilder"]
     DeepChat --> Process["process.ts"]
     DeepChat --> Dispatch["dispatch.ts"]
@@ -21,16 +21,16 @@ flowchart TD
 
 主原则：
 
-- renderer 只面向 `newAgentPresenter`
-- `newAgentPresenter` 只做 session orchestration，不执行聊天 loop
-- `deepchatAgentPresenter` 独占聊天 runtime
+- renderer 只面向 `agentSessionPresenter`
+- `agentSessionPresenter` 只做 session orchestration，不执行聊天 loop
+- `agentRuntimePresenter` 独占聊天 runtime
 
 ## 模块布局
 
-### `newAgentPresenter/`
+### `agentSessionPresenter/`
 
 ```text
-newAgentPresenter/
+agentSessionPresenter/
 ├── index.ts
 ├── agentRegistry.ts
 ├── sessionManager.ts
@@ -46,10 +46,10 @@ newAgentPresenter/
 - 暴露 renderer IPC 方法
 - 保留 legacy import 流程
 
-### `deepchatAgentPresenter/`
+### `agentRuntimePresenter/`
 
 ```text
-deepchatAgentPresenter/
+agentRuntimePresenter/
 ├── index.ts
 ├── process.ts
 ├── dispatch.ts
@@ -75,12 +75,12 @@ deepchatAgentPresenter/
 
 | 层 | 主文件 | 责任 |
 | --- | --- | --- |
-| Session orchestration | `src/main/presenter/newAgentPresenter/index.ts` | session 生命周期与 IPC |
-| Agent runtime | `src/main/presenter/deepchatAgentPresenter/index.ts` | run state、取消、恢复、模型/权限切换 |
-| Stream loop | `src/main/presenter/deepchatAgentPresenter/process.ts` | 调用 provider、累计 blocks、驱动 tool loop |
-| Tool dispatch | `src/main/presenter/deepchatAgentPresenter/dispatch.ts` | 调用 `ToolPresenter`、暂停交互、生成 tool 结果 |
-| Context build | `src/main/presenter/deepchatAgentPresenter/contextBuilder.ts` | 历史裁剪、resume context、token budget |
-| Persistence | `src/main/presenter/deepchatAgentPresenter/messageStore.ts` | 消息持久化与故障恢复 |
+| Session orchestration | `src/main/presenter/agentSessionPresenter/index.ts` | session 生命周期与 IPC |
+| Agent runtime | `src/main/presenter/agentRuntimePresenter/index.ts` | run state、取消、恢复、模型/权限切换 |
+| Stream loop | `src/main/presenter/agentRuntimePresenter/process.ts` | 调用 provider、累计 blocks、驱动 tool loop |
+| Tool dispatch | `src/main/presenter/agentRuntimePresenter/dispatch.ts` | 调用 `ToolPresenter`、暂停交互、生成 tool 结果 |
+| Context build | `src/main/presenter/agentRuntimePresenter/contextBuilder.ts` | 历史裁剪、resume context、token budget |
+| Persistence | `src/main/presenter/agentRuntimePresenter/messageStore.ts` | 消息持久化与故障恢复 |
 
 ## 兼容边界
 
@@ -101,10 +101,10 @@ deepchatAgentPresenter/
 
 如果要追一条真实消息链路，推荐顺序：
 
-1. `src/main/presenter/newAgentPresenter/index.ts`
-2. `src/main/presenter/deepchatAgentPresenter/index.ts`
-3. `src/main/presenter/deepchatAgentPresenter/process.ts`
-4. `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
+1. `src/main/presenter/agentSessionPresenter/index.ts`
+2. `src/main/presenter/agentRuntimePresenter/index.ts`
+3. `src/main/presenter/agentRuntimePresenter/process.ts`
+4. `src/main/presenter/agentRuntimePresenter/dispatch.ts`
 5. `src/main/presenter/toolPresenter/index.ts`
 
 ## 历史说明

docs/architecture/baselines/dependency-report.md

@@ -13,13 +13,13 @@ Generated on 2026-04-03.
 - `presenter/index.ts`: 39
 - `presenter/llmProviderPresenter/managers/providerInstanceManager.ts`: 38
 - `presenter/configPresenter/index.ts`: 22
-- `presenter/deepchatAgentPresenter/index.ts`: 20
+- `presenter/agentRuntimePresenter/index.ts`: 20
 - `presenter/lifecyclePresenter/hooks/index.ts`: 17
 - `presenter/sqlitePresenter/index.ts`: 16
 - `presenter/remoteControlPresenter/index.ts`: 15
 - `presenter/llmProviderPresenter/index.ts`: 14
 - `presenter/toolPresenter/agentTools/agentToolManager.ts`: 14
-- `presenter/newAgentPresenter/index.ts`: 13
+- `presenter/agentSessionPresenter/index.ts`: 13
 - `presenter/llmProviderPresenter/acp/index.ts`: 12
 - `presenter/filePresenter/mime.ts`: 11
 - `presenter/mcpPresenter/inMemoryServers/builder.ts`: 11
@@ -64,7 +64,7 @@ Generated on 2026-04-03.
 - `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/mcpPresenter/serverManager.ts -> presenter/mcpPresenter/mcpClient.ts -> presenter/mcpPresenter/inMemoryServers/builder.ts -> presenter/mcpPresenter/inMemoryServers/builtinKnowledgeServer.ts -> presenter/index.ts`
 - `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/mcpPresenter/toolManager.ts -> presenter/index.ts`
 - `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/index.ts`
-- `presenter/sqlitePresenter/index.ts -> presenter/newAgentPresenter/legacyImportService.ts -> presenter/sqlitePresenter/index.ts`
+- `presenter/sqlitePresenter/index.ts -> presenter/agentSessionPresenter/legacyImportService.ts -> presenter/sqlitePresenter/index.ts`
 - `presenter/index.ts -> presenter/syncPresenter/index.ts -> presenter/index.ts`
 
 ## renderer

docs/architecture/baselines/test-failure-groups.md

@@ -4,7 +4,7 @@ Baseline captured on `2026-04-03`.
 
 ## 真实行为回归 / 契约漂移
 
-- `test/main/presenter/newAgentPresenter/integration.test.ts`
+- `test/main/presenter/agentSessionPresenter/integration.test.ts`
   - `configPresenter.getAgentType()` mock 契约缺失暴露了会话编排对配置查询的硬依赖。
 - `test/main/presenter/floatingButtonPresenter/*.test.ts`
   - 布局断言和当前窗口吸边行为不一致。
@@ -19,7 +19,7 @@ Baseline captured on `2026-04-03`.
 
 - `test/main/presenter/mcpClient.test.ts`
   - 仍然断言旧的 runtime command translation 细节。
-- `test/main/presenter/newAgentPresenter/messageManager.test.ts`
+- `test/main/presenter/agentSessionPresenter/messageManager.test.ts`
   - 仍然调用已不再暴露的方法。
 - `test/renderer/composables/useSearchConfig.test.ts`
   - 测试存在，但实现文件缺失。

docs/architecture/session-management.md

@@ -2,18 +2,18 @@
 
 retirement 之后，会话管理被明确拆成两层：
 
-- 活跃聊天层：`newAgentPresenter` + `NewSessionManager`
+- 活跃聊天层：`agentSessionPresenter` + `NewSessionManager`
 - 兼容数据层：`SessionPresenter`
 
 ## 当前职责边界
 
 | 组件 | 位置 | 当前职责 |
 | --- | --- | --- |
-| `NewAgentPresenter` | `src/main/presenter/newAgentPresenter/index.ts` | renderer 唯一 session 入口 |
-| `NewSessionManager` | `src/main/presenter/newAgentPresenter/sessionManager.ts` | `new_sessions` 记录、窗口绑定、session CRUD |
-| `NewMessageManager` | `src/main/presenter/newAgentPresenter/messageManager.ts` | 新会话消息读取与 agent routing |
-| `DeepChatSessionStore` | `src/main/presenter/deepchatAgentPresenter/sessionStore.ts` | 活跃 runtime 状态 |
-| `DeepChatMessageStore` | `src/main/presenter/deepchatAgentPresenter/messageStore.ts` | 新消息持久化 |
+| `AgentSessionPresenter` | `src/main/presenter/agentSessionPresenter/index.ts` | renderer 唯一 session 入口 |
+| `NewSessionManager` | `src/main/presenter/agentSessionPresenter/sessionManager.ts` | `new_sessions` 记录、窗口绑定、session CRUD |
+| `NewMessageManager` | `src/main/presenter/agentSessionPresenter/messageManager.ts` | 新会话消息读取与 agent routing |
+| `DeepChatSessionStore` | `src/main/presenter/agentRuntimePresenter/sessionStore.ts` | 活跃 runtime 状态 |
+| `DeepChatMessageStore` | `src/main/presenter/agentRuntimePresenter/messageStore.ts` | 新消息持久化 |
 | `SessionPresenter` | `src/main/presenter/sessionPresenter/index.ts` | legacy conversation/thread/export 兼容层 |
 | `sessionPresenter/messageFormatter.ts` | `src/main/presenter/sessionPresenter/messageFormatter.ts` | 用户消息上下文格式化与 exporter 复用 |
 
@@ -22,9 +22,9 @@ retirement 之后，会话管理被明确拆成两层：
 ```mermaid
 sequenceDiagram
     participant R as Renderer
-    participant N as NewAgentPresenter
+    participant N as AgentSessionPresenter
     participant S as NewSessionManager
-    participant D as DeepChatAgentPresenter
+    participant D as AgentRuntimePresenter
 
     R->>N: createSession()
     N->>S: create()
@@ -70,4 +70,4 @@ sequenceDiagram
 - 维护 exporter 使用的用户消息归一化
 
 如果是当前聊天会话创建、发送消息、取消生成、tool interaction，请直接从
-`newAgentPresenter` 和 `deepchatAgentPresenter` 开始读。
+`agentSessionPresenter` 和 `agentRuntimePresenter` 开始读。

docs/architecture/tool-system.md

@@ -20,7 +20,7 @@
 
 ```mermaid
 graph LR
-    DeepChat["DeepChatAgentPresenter"] --> ToolPresenter["ToolPresenter"]
+    DeepChat["AgentRuntimePresenter"] --> ToolPresenter["ToolPresenter"]
     ToolPresenter --> Mapper["ToolMapper"]
     ToolPresenter --> Mcp["McpPresenter"]
     ToolPresenter --> AgentTools["AgentToolManager"]
@@ -37,14 +37,14 @@ graph LR
 2. 从 `AgentToolManager` 拉取本地 agent tools。
 3. 用 `ToolMapper` 记录来源，并在重名时优先保留 MCP tool。
 
-这意味着 `deepchatAgentPresenter` 不需要知道 tool 的真实来源，只需要持有统一的
+这意味着 `agentRuntimePresenter` 不需要知道 tool 的真实来源，只需要持有统一的
 `MCPToolDefinition[]`。
 
 ## 调用工具
 
 ```mermaid
 sequenceDiagram
-    participant D as DeepChatAgentPresenter
+    participant D as AgentRuntimePresenter
     participant T as ToolPresenter
     participant Map as ToolMapper
     participant M as MCP tools
@@ -76,7 +76,7 @@ port 负责提供：
 - conversation workdir 解析
 - 已批准路径查询
 - settings approval 消费
-- `newAgentPresenter` 会话上下文桥接
+- `agentSessionPresenter` 会话上下文桥接
 
 权限能力拆分：
 

docs/archives/legacy-agentpresenter-architecture.md

@@ -2,7 +2,7 @@
 
 本文档从高层视角介绍 DeepChat 的系统架构，帮助开发者快速理解项目结构和组件关系。
 
-> **Note (2026-03-09):** 本文档描述的是原始 AgentPresenter 架构。新架构（P0 实现）使用 `newAgentPresenter` + `deepchatAgentPresenter` 作为主要入口，详见 [P0 Implementation Summary](./P0_IMPLEMENTATION_SUMMARY.md)。
+> **Note (2026-03-09):** 本文档描述的是原始 AgentPresenter 架构。当前主入口是 `agentSessionPresenter` + `agentRuntimePresenter`（formerly `newAgentPresenter` + `deepchatAgentPresenter`），详见 [P0 Implementation Summary](./P0_IMPLEMENTATION_SUMMARY.md)。
 
 ## 🏗️ 核心组件关系
 

docs/archives/legacy-agentpresenter-flows.md

@@ -2,7 +2,7 @@
 
 本文档使用时序图详细描述 DeepChat 的关键业务流程，帮助开发者理解运行时行为。
 
-> **Note (2026-03-09):** 本文档描述的是原始 AgentPresenter 流程。新架构流程（newAgentPresenter + deepchatAgentPresenter）已实现，核心流程类似但入口不同。详见 [P0 Implementation Summary](./P0_IMPLEMENTATION_SUMMARY.md)。
+> **Note (2026-03-09):** 本文档描述的是原始 AgentPresenter 流程。当前主流程入口是 `agentSessionPresenter` + `agentRuntimePresenter`（formerly `newAgentPresenter` + `deepchatAgentPresenter`）；核心流程类似但入口不同。详见 [P0 Implementation Summary](./P0_IMPLEMENTATION_SUMMARY.md)。
 
 ## 1. 发送消息完整流程