From 2fa0f417d881d21a2315e0709a7ae181e0d274b2 Mon Sep 17 00:00:00 2001
From: zerob13 <zerob13@gmail.com>
Date: Fri, 3 Apr 2026 19:06:31 +0800
Subject: [PATCH 1/3] refactor(architecture): simplify boundaries

---
 archives/code/dead-code-batch-2/README.md     |   36 -
 .../main/presenter/agentPresenter/events.ts   |    1 -
 .../presenter/agentPresenter/message/index.ts |    5 -
 .../message/systemEnvPromptBuilder.ts         |    5 -
 .../agentPresenter/permission/index.ts        |    1 -
 .../presenter/agentPresenter/session/index.ts |    4 -
 .../agentPresenter/streaming/index.ts         |    4 -
 .../presenter/agentPresenter/tool/index.ts    |    6 -
 .../agentPresenter/tools/questionTool.ts      |    6 -
 .../presenter/agentPresenter/utility/index.ts |    2 -
 .../src/main/presenter/searchPrompts/index.ts |    1 -
 .../sessionPresenter/persistence/index.ts     |    2 -
 .../presenter/sessionPresenter/tab/index.ts   |    2 -
 .../renderer/src/components/NewThreadMock.vue |   98 --
 .../src/components/mock/MockChatPage.vue      |   34 -
 .../src/components/mock/MockInputBox.vue      |   20 -
 .../src/components/mock/MockInputToolbar.vue  |   52 -
 .../src/components/mock/MockMessageList.vue   |  104 --
 .../src/components/mock/MockStatusBar.vue     |  104 --
 .../src/components/mock/MockTopBar.vue        |   66 -
 .../src/components/mock/MockWelcomePage.vue   |  130 --
 .../src/composables/useMockViewState.ts       |   23 -
 archives/code/dead-code-batch-3/README.md     |   14 -
 .../inMemoryServers/meetingServer.ts          |   98 --
 archives/code/dead-renderer-batch-1/README.md |   17 -
 .../components/MessageNavigationSidebar.vue   |  366 -----
 .../src/components/message/MessageMinimap.vue |  291 ----
 .../composables/message/useMessageMinimap.ts  |   16 -
 .../renderer/src/lib/messageRuntimeCache.ts   |  102 --
 .../README.md                                 |   17 -
 .../acp/backgroundExecSessionManager.ts       |    5 -
 .../presenter/agentPresenter/acp/index.ts     |   38 -
 .../agentPresenter/acp/shellEnvHelper.ts      |    5 -
 .../presenter/agentPresenter/agent/index.ts   |    1 -
 .../main/presenter/agentPresenter/index.ts    |  674 ---------
 .../agentPresenter/loop/agentLoopHandler.ts   |  669 ---------
 .../loop/errorClassification.ts               |  102 --
 .../presenter/agentPresenter/loop/index.ts    |    6 -
 .../agentPresenter/loop/loopOrchestrator.ts   |   24 -
 .../agentPresenter/loop/loopState.ts          |   25 -
 .../agentPresenter/loop/toolCallHandler.ts    |  610 --------
 .../agentPresenter/loop/toolCallProcessor.ts  |  726 ----------
 .../agentPresenter/message/messageBuilder.ts  |  405 ------
 .../message/messageCompressor.ts              |  111 --
 .../message/messageTruncator.ts               |  161 ---
 .../message/skillsPromptBuilder.ts            |   86 --
 .../permission/permissionHandler.ts           | 1221 -----------------
 .../agentPresenter/persistence/index.ts       |    1 -
 .../presenter/agentPresenter/runtimePorts.ts  |   46 -
 .../agentPresenter/session/sessionContext.ts  |   53 -
 .../agentPresenter/session/sessionManager.ts  |  438 ------
 .../agentPresenter/session/sessionResolver.ts |   47 -
 .../session/sessionRuntimePort.ts             |   39 -
 .../streaming/contentBufferHandler.ts         |  196 ---
 .../streaming/llmEventHandler.ts              |  569 --------
 .../streaming/streamGenerationHandler.ts      |  597 --------
 .../streaming/streamUpdateScheduler.ts        |  433 ------
 .../agentPresenter/streaming/types.ts         |   38 -
 .../agentPresenter/tool/toolCallCenter.ts     |   34 -
 .../agentPresenter/tool/toolRegistry.ts       |   22 -
 .../agentPresenter/tool/toolRouter.ts         |   10 -
 .../main/presenter/agentPresenter/types.ts    |    7 -
 .../agentPresenter/types/handlerContext.ts    |   82 --
 .../agentPresenter/utility/promptEnhancer.ts  |   16 -
 .../agentPresenter/utility/utilityHandler.ts  |  329 -----
 .../types/presenters/agent.presenter.d.ts     |   42 -
 .../agentPresenter/agentPresenter.test.ts     |    8 -
 .../loop/agentLoopHandler.test.ts             |   89 --
 .../loop/toolCallProcessor.test.ts            |  310 -----
 .../message/systemEnvPromptBuilder.test.ts    |  145 --
 .../agentPresenter/messageBuilder.test.ts     |  104 --
 .../agentPresenter/messageCompressor.test.ts  |  109 --
 .../permissionHandler.resume.test.ts          |  168 ---
 .../agentPresenter/promptBuilder.test.ts      |  226 ---
 .../agentPresenter/sessionManager.test.ts     |   99 --
 .../skillsPromptBuilder.test.ts               |   54 -
 .../streaming/llmEventHandler.test.ts         |  172 ---
 .../streaming/streamGenerationHandler.test.ts |  146 --
 .../permissionHandler.test.ts                 |  393 ------
 docs/ARCHITECTURE.md                          |    2 +-
 docs/README.md                                |   10 +-
 docs/architecture/agent-system.md             |    2 +-
 .../baselines/archive-reference-report.md     |    6 +
 .../baselines/dependency-report.md            |  118 ++
 .../baselines/test-failure-groups.md          |   38 +
 .../baselines/zero-inbound-candidates.md      |   76 +
 .../new-ui-implementation-plan.md             |    4 +-
 .../legacy-agentpresenter-architecture.md     |   36 +-
 docs/guides/code-navigation.md                |    2 +-
 docs/guides/getting-started.md                |    2 +-
 docs/specs/agent-cleanup/spec.md              |    6 +-
 docs/specs/agent-cleanup/tasks.md             |   14 +-
 .../specs/architecture-simplification/plan.md |   37 +
 .../specs/architecture-simplification/spec.md |   40 +
 .../architecture-simplification/tasks.md      |   31 +
 .../legacy-agentpresenter-retirement/spec.md  |   14 +-
 docs/specs/new-ui-chat-components/spec.md     |   24 +-
 docs/specs/new-ui-implementation/todo.md      |   40 +-
 docs/specs/new-ui-pages/spec.md               |   16 +-
 package.json                                  |    4 +-
 scripts/architecture-guard.mjs                |  152 ++
 scripts/generate-architecture-baseline.mjs    |  358 +++++
 .../agentRuntime/systemEnvPromptBuilder.ts    |   24 +-
 .../deepchatAgentPresenter/dispatch.ts        |   42 +-
 .../presenter/deepchatAgentPresenter/index.ts |   74 +-
 .../presenter/deepchatAgentPresenter/types.ts |    3 +
 src/main/presenter/index.ts                   |   68 +-
 src/main/presenter/newAgentPresenter/index.ts |   72 +-
 src/main/presenter/runtimePorts.ts            |   37 +
 src/renderer/src/App.vue                      |  119 +-
 .../src/composables/useAppIpcRuntime.ts       |   56 +
 .../src/composables/useModelCapabilities.ts   |   24 +-
 src/renderer/src/composables/usePresenter.ts  |   17 +-
 .../src/composables/useSearchConfig.ts        |   27 +
 src/renderer/src/lib/ipcSubscription.ts       |   43 +
 src/renderer/src/lib/storeInitializer.ts      |   10 +-
 src/renderer/src/lib/windowContext.ts         |   45 +
 src/renderer/src/stores/ui/message.ts         |   96 +-
 src/renderer/src/stores/ui/messageIpc.ts      |   84 ++
 src/renderer/src/stores/ui/session.ts         |   89 +-
 src/renderer/src/stores/ui/sessionIpc.ts      |   46 +
 src/renderer/src/stores/ui/stream.ts          |   33 +
 122 files changed, 1657 insertions(+), 11902 deletions(-)
 delete mode 100644 archives/code/dead-code-batch-2/README.md
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/events.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/systemEnvPromptBuilder.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/permission/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/session/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/streaming/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tool/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tools/questionTool.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/utility/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/searchPrompts/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/persistence/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/tab/index.ts
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/NewThreadMock.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockChatPage.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputBox.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputToolbar.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockMessageList.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockStatusBar.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockTopBar.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockWelcomePage.vue
 delete mode 100644 archives/code/dead-code-batch-2/src/renderer/src/composables/useMockViewState.ts
 delete mode 100644 archives/code/dead-code-batch-3/README.md
 delete mode 100644 archives/code/dead-code-batch-3/src/main/presenter/mcpPresenter/inMemoryServers/meetingServer.ts
 delete mode 100644 archives/code/dead-renderer-batch-1/README.md
 delete mode 100644 archives/code/dead-renderer-batch-1/src/renderer/src/components/MessageNavigationSidebar.vue
 delete mode 100644 archives/code/dead-renderer-batch-1/src/renderer/src/components/message/MessageMinimap.vue
 delete mode 100644 archives/code/dead-renderer-batch-1/src/renderer/src/composables/message/useMessageMinimap.ts
 delete mode 100644 archives/code/dead-renderer-batch-1/src/renderer/src/lib/messageRuntimeCache.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/README.md
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/backgroundExecSessionManager.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/index.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/shellEnvHelper.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/agent/index.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/index.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/agentLoopHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/errorClassification.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/index.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopOrchestrator.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopState.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallProcessor.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageBuilder.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageCompressor.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageTruncator.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/skillsPromptBuilder.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/permission/permissionHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/persistence/index.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/runtimePorts.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionContext.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionManager.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionResolver.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionRuntimePort.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/contentBufferHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/llmEventHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamGenerationHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamUpdateScheduler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/types.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolCallCenter.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRegistry.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRouter.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types/handlerContext.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/promptEnhancer.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/utilityHandler.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/src/shared/types/presenters/agent.presenter.d.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/agentPresenter.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/agentLoopHandler.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/toolCallProcessor.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/message/systemEnvPromptBuilder.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageBuilder.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageCompressor.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/permission/permissionHandler.resume.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/promptBuilder.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/sessionManager.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/skillsPromptBuilder.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/llmEventHandler.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/streamGenerationHandler.test.ts
 delete mode 100644 archives/code/legacy-agentpresenter-retirement/test/main/presenter/sessionPresenter/permissionHandler.test.ts
 create mode 100644 docs/architecture/baselines/archive-reference-report.md
 create mode 100644 docs/architecture/baselines/dependency-report.md
 create mode 100644 docs/architecture/baselines/test-failure-groups.md
 create mode 100644 docs/architecture/baselines/zero-inbound-candidates.md
 create mode 100644 docs/specs/architecture-simplification/plan.md
 create mode 100644 docs/specs/architecture-simplification/spec.md
 create mode 100644 docs/specs/architecture-simplification/tasks.md
 create mode 100644 scripts/architecture-guard.mjs
 create mode 100644 scripts/generate-architecture-baseline.mjs
 create mode 100644 src/main/presenter/runtimePorts.ts
 create mode 100644 src/renderer/src/composables/useAppIpcRuntime.ts
 create mode 100644 src/renderer/src/composables/useSearchConfig.ts
 create mode 100644 src/renderer/src/lib/ipcSubscription.ts
 create mode 100644 src/renderer/src/lib/windowContext.ts
 create mode 100644 src/renderer/src/stores/ui/messageIpc.ts
 create mode 100644 src/renderer/src/stores/ui/sessionIpc.ts
 create mode 100644 src/renderer/src/stores/ui/stream.ts

diff --git a/archives/code/dead-code-batch-2/README.md b/archives/code/dead-code-batch-2/README.md
deleted file mode 100644
index c6cd9131b..000000000
--- a/archives/code/dead-code-batch-2/README.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# Dead Code Batch 2
-
-- Purpose: archive dead code that no longer participates in the active renderer or main runtime.
-- Archived at: 2026-03-15
-- Rationale: static inspection confirmed these files have no live code references and are kept in
-  source form for precise rollback only.
-
-## Archived Paths
-
-- `src/renderer/src/components/NewThreadMock.vue`
-- `src/renderer/src/components/mock/MockChatPage.vue`
-- `src/renderer/src/components/mock/MockInputBox.vue`
-- `src/renderer/src/components/mock/MockInputToolbar.vue`
-- `src/renderer/src/components/mock/MockMessageList.vue`
-- `src/renderer/src/components/mock/MockStatusBar.vue`
-- `src/renderer/src/components/mock/MockTopBar.vue`
-- `src/renderer/src/components/mock/MockWelcomePage.vue`
-- `src/renderer/src/composables/useMockViewState.ts`
-- `src/main/presenter/agentPresenter/tools/questionTool.ts`
-- `src/main/presenter/agentPresenter/message/systemEnvPromptBuilder.ts`
-- `src/main/presenter/agentPresenter/events.ts`
-- `src/main/presenter/agentPresenter/message/index.ts`
-- `src/main/presenter/agentPresenter/permission/index.ts`
-- `src/main/presenter/agentPresenter/session/index.ts`
-- `src/main/presenter/agentPresenter/streaming/index.ts`
-- `src/main/presenter/agentPresenter/tool/index.ts`
-- `src/main/presenter/agentPresenter/utility/index.ts`
-- `src/main/presenter/searchPrompts/index.ts`
-- `src/main/presenter/sessionPresenter/persistence/index.ts`
-- `src/main/presenter/sessionPresenter/tab/index.ts`
-
-## Notes
-
-- This directory is not part of the runtime, build, typecheck, or test target set.
-- Restore by moving files back to their original paths if a later audit proves they are still
-  needed.
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/events.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/events.ts
deleted file mode 100644
index 336ce12bb..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/events.ts
+++ /dev/null
@@ -1 +0,0 @@
-export {}
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/index.ts
deleted file mode 100644
index 4be94eb85..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/index.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export * from './messageBuilder'
-export * from './messageCompressor'
-export * from './messageFormatter'
-export * from './messageTruncator'
-export * from './systemEnvPromptBuilder'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/systemEnvPromptBuilder.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/systemEnvPromptBuilder.ts
deleted file mode 100644
index c39ec9ffb..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/message/systemEnvPromptBuilder.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export {
-  buildRuntimeCapabilitiesPrompt,
-  buildSystemEnvPrompt,
-  type BuildSystemEnvPromptOptions
-} from '../../../lib/agentRuntime/systemEnvPromptBuilder'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/permission/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/permission/index.ts
deleted file mode 100644
index 60da88787..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/permission/index.ts
+++ /dev/null
@@ -1 +0,0 @@
-export { PermissionHandler } from './permissionHandler'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/session/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/session/index.ts
deleted file mode 100644
index 44666fa75..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/session/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export type { SessionContext, SessionContextResolved, SessionStatus } from './sessionContext'
-export { resolveSessionContext } from './sessionResolver'
-export type { SessionResolveInput } from './sessionResolver'
-export { SessionManager } from './sessionManager'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/streaming/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/streaming/index.ts
deleted file mode 100644
index f86db5c7c..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/streaming/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export { ContentBufferHandler } from './contentBufferHandler'
-export { LLMEventHandler } from './llmEventHandler'
-export { StreamGenerationHandler } from './streamGenerationHandler'
-export type { GeneratingMessageState } from './types'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tool/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tool/index.ts
deleted file mode 100644
index 824fcc298..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tool/index.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-export { ToolCallCenter } from './toolCallCenter'
-export { ToolRegistry } from './toolRegistry'
-export { resolveToolRoute } from './toolRouter'
-export type { ToolCallContext } from './toolCallCenter'
-export type { ToolRegistryEntry, ToolRegistrySource } from './toolRegistry'
-export type { ToolRouteDecision } from './toolRouter'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tools/questionTool.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tools/questionTool.ts
deleted file mode 100644
index 1979f7342..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/tools/questionTool.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-export {
-  parseQuestionToolArgs,
-  QUESTION_TOOL_NAME,
-  questionToolSchema,
-  type QuestionToolInput
-} from '../../../lib/agentRuntime/questionTool'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/utility/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/utility/index.ts
deleted file mode 100644
index 7271098b3..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/agentPresenter/utility/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export { UtilityHandler } from './utilityHandler'
-export { enhanceSystemPromptWithDateTime } from './promptEnhancer'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/searchPrompts/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/searchPrompts/index.ts
deleted file mode 100644
index 5bb802615..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/searchPrompts/index.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from './searchPrompts'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/persistence/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/persistence/index.ts
deleted file mode 100644
index 60f29b2b6..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/persistence/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export { ConversationPersister } from './conversationPersister.js'
-export { MessagePersister } from './messagePersister.js'
diff --git a/archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/tab/index.ts b/archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/tab/index.ts
deleted file mode 100644
index 30a2de58a..000000000
--- a/archives/code/dead-code-batch-2/src/main/presenter/sessionPresenter/tab/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export { TabManager, type ITabAdapter, type TabMetadata } from './tabManager.js'
-export { TabAdapter } from './tabAdapter.js'
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/NewThreadMock.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/NewThreadMock.vue
deleted file mode 100644
index 55862f267..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/NewThreadMock.vue
+++ /dev/null
@@ -1,98 +0,0 @@
-<template>
-  <TooltipProvider :delay-duration="200">
-    <div class="h-full w-full flex flex-col">
-      <!-- Main content area (centered) -->
-      <div class="flex-1 flex flex-col items-center justify-center px-6">
-        <!-- Logo -->
-        <div class="mb-4">
-          <img src="@/assets/logo-dark.png" class="w-14 h-14" loading="lazy" />
-        </div>
-
-        <!-- Heading -->
-        <h1 class="text-3xl font-semibold text-foreground mb-4">
-          {{ t('chat.newThread.title') }}
-        </h1>
-
-        <!-- Project selector -->
-        <DropdownMenu>
-          <DropdownMenuTrigger as-child>
-            <Button
-              variant="ghost"
-              size="sm"
-              class="h-7 px-2.5 gap-1.5 text-xs text-muted-foreground hover:text-foreground mb-6"
-            >
-              <Icon icon="lucide:folder" class="w-3.5 h-3.5" />
-              <span>{{ selectedProject }}</span>
-              <Icon icon="lucide:chevron-down" class="w-3 h-3" />
-            </Button>
-          </DropdownMenuTrigger>
-          <DropdownMenuContent align="center" class="min-w-[200px]">
-            <DropdownMenuLabel class="text-xs">{{ t('common.project.recent') }}</DropdownMenuLabel>
-            <DropdownMenuItem
-              v-for="project in recentProjects"
-              :key="project.path"
-              class="gap-2 text-xs py-1.5 px-2"
-              @click="selectedProject = project.name"
-            >
-              <Icon icon="lucide:folder" class="w-3.5 h-3.5 text-muted-foreground" />
-              <div class="flex flex-col min-w-0">
-                <span class="truncate">{{ project.name }}</span>
-                <span class="text-[10px] text-muted-foreground truncate">{{ project.path }}</span>
-              </div>
-            </DropdownMenuItem>
-            <DropdownMenuSeparator />
-            <DropdownMenuItem class="gap-2 text-xs py-1.5 px-2" @click="selectCustomProject">
-              <Icon icon="lucide:folder-open" class="w-3.5 h-3.5 text-muted-foreground" />
-              <span>{{ t('common.project.openFolder') }}</span>
-            </DropdownMenuItem>
-          </DropdownMenuContent>
-        </DropdownMenu>
-
-        <!-- Input area -->
-        <MockInputBox>
-          <template #toolbar>
-            <MockInputToolbar />
-          </template>
-        </MockInputBox>
-
-        <!-- Status bar -->
-        <MockStatusBar />
-      </div>
-    </div>
-  </TooltipProvider>
-</template>
-
-<script setup lang="ts">
-import { ref } from 'vue'
-import { useI18n } from 'vue-i18n'
-import { TooltipProvider } from '@shadcn/components/ui/tooltip'
-import { Button } from '@shadcn/components/ui/button'
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
-  DropdownMenuLabel,
-  DropdownMenuSeparator,
-  DropdownMenuTrigger
-} from '@shadcn/components/ui/dropdown-menu'
-import { Icon } from '@iconify/vue'
-import MockInputBox from './mock/MockInputBox.vue'
-import MockInputToolbar from './mock/MockInputToolbar.vue'
-import MockStatusBar from './mock/MockStatusBar.vue'
-
-const { t } = useI18n()
-
-const recentProjects = [
-  { name: 'deepchat', path: '~/Code/deepchat' },
-  { name: 'api-server', path: '~/Code/api-server' },
-  { name: 'infra', path: '~/Code/infra' },
-  { name: 'personal-site', path: '~/Projects/personal-site' }
-]
-
-const selectedProject = ref('deepchat')
-
-const selectCustomProject = () => {
-  // Mock: would open a native folder picker
-  selectedProject.value = 'Custom folder'
-}
-</script>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockChatPage.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockChatPage.vue
deleted file mode 100644
index fda8eaa27..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockChatPage.vue
+++ /dev/null
@@ -1,34 +0,0 @@
-<template>
-  <TooltipProvider :delay-duration="200">
-    <div class="h-full overflow-y-auto">
-      <MockTopBar :title="title" :project="project" />
-      <MockMessageList />
-
-      <!-- Input area (sticky bottom, messages scroll under) -->
-      <div class="sticky bottom-0 z-10 px-6 pt-3 pb-3">
-        <div class="flex flex-col items-center">
-          <MockInputBox>
-            <template #toolbar>
-              <MockInputToolbar />
-            </template>
-          </MockInputBox>
-          <MockStatusBar />
-        </div>
-      </div>
-    </div>
-  </TooltipProvider>
-</template>
-
-<script setup lang="ts">
-import { TooltipProvider } from '@shadcn/components/ui/tooltip'
-import MockTopBar from './MockTopBar.vue'
-import MockMessageList from './MockMessageList.vue'
-import MockInputBox from './MockInputBox.vue'
-import MockInputToolbar from './MockInputToolbar.vue'
-import MockStatusBar from './MockStatusBar.vue'
-
-defineProps<{
-  title: string
-  project: string
-}>()
-</script>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputBox.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputBox.vue
deleted file mode 100644
index 7e2fb8f50..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputBox.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<template>
-  <div
-    class="w-full max-w-2xl rounded-xl border bg-card/30 backdrop-blur-lg shadow-sm overflow-hidden"
-  >
-    <Textarea
-      :placeholder="t('chat.input.placeholder')"
-      class="min-h-[80px] resize-none border-0 shadow-none focus-visible:ring-0 focus-visible:border-0 bg-transparent! dark:bg-transparent placeholder:text-muted-foreground px-4 pt-4 pb-2 text-sm"
-      :model-value="''"
-    />
-
-    <slot name="toolbar" />
-  </div>
-</template>
-
-<script setup lang="ts">
-import { Textarea } from '@shadcn/components/ui/textarea'
-import { useI18n } from 'vue-i18n'
-
-const { t } = useI18n()
-</script>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputToolbar.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputToolbar.vue
deleted file mode 100644
index 7c7d695ad..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputToolbar.vue
+++ /dev/null
@@ -1,52 +0,0 @@
-<template>
-  <div class="flex items-center justify-between px-3 py-2">
-    <div class="flex items-center gap-1">
-      <!-- Attach button -->
-      <Tooltip>
-        <TooltipTrigger as-child>
-          <Button
-            variant="ghost"
-            size="icon"
-            class="h-7 w-7 rounded-lg text-muted-foreground hover:text-foreground"
-          >
-            <Icon icon="lucide:plus" class="w-4 h-4" />
-          </Button>
-        </TooltipTrigger>
-        <TooltipContent>
-          <p>Attach</p>
-        </TooltipContent>
-      </Tooltip>
-    </div>
-
-    <div class="flex items-center gap-1">
-      <!-- Mic button -->
-      <Tooltip v-if="SHOW_VOICE_INPUT">
-        <TooltipTrigger as-child>
-          <Button
-            variant="ghost"
-            size="icon"
-            class="h-7 w-7 rounded-lg text-muted-foreground hover:text-foreground"
-          >
-            <Icon icon="lucide:mic" class="w-4 h-4" />
-          </Button>
-        </TooltipTrigger>
-        <TooltipContent>
-          <p>Voice input</p>
-        </TooltipContent>
-      </Tooltip>
-
-      <!-- Send button -->
-      <Button size="icon" class="h-7 w-7 rounded-full">
-        <Icon icon="lucide:arrow-up" class="w-4 h-4" />
-      </Button>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { Button } from '@shadcn/components/ui/button'
-import { Tooltip, TooltipContent, TooltipTrigger } from '@shadcn/components/ui/tooltip'
-import { Icon } from '@iconify/vue'
-
-const SHOW_VOICE_INPUT = false
-</script>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockMessageList.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockMessageList.vue
deleted file mode 100644
index df483226e..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockMessageList.vue
+++ /dev/null
@@ -1,104 +0,0 @@
-<template>
-  <div class="flex-1 overflow-y-auto">
-    <div class="max-w-3xl mx-auto px-4 py-6 space-y-6">
-      <div v-for="msg in messages" :key="msg.id">
-        <!-- User message -->
-        <div v-if="msg.role === 'user'" class="flex justify-end mb-6">
-          <div class="max-w-[80%] rounded-2xl bg-muted px-4 py-2.5">
-            <p class="text-sm whitespace-pre-wrap">{{ msg.content }}</p>
-          </div>
-        </div>
-
-        <!-- Assistant message -->
-        <div v-else class="flex gap-3 mb-6">
-          <div class="shrink-0 mt-1">
-            <div class="w-6 h-6 rounded-md bg-primary/10 flex items-center justify-center">
-              <ModelIcon model-id="anthropic" custom-class="w-4 h-4" :is-dark="themeStore.isDark" />
-            </div>
-          </div>
-          <div class="min-w-0 flex-1">
-            <p class="text-xs text-muted-foreground mb-1">Claude 4 Sonnet</p>
-            <div class="text-sm leading-relaxed whitespace-pre-wrap">{{ msg.content }}</div>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import ModelIcon from '../icons/ModelIcon.vue'
-import { useThemeStore } from '@/stores/theme'
-
-const themeStore = useThemeStore()
-
-const messages = [
-  {
-    id: '1',
-    role: 'user',
-    content:
-      'I\'m getting a login error when users try to sign in with their Google account. The error says "invalid_grant" and it happens intermittently.'
-  },
-  {
-    id: '2',
-    role: 'assistant',
-    content: `This is a common OAuth2 issue. The "invalid_grant" error typically occurs for a few reasons:
-
-1. Expired refresh token — Google refresh tokens can expire if the user hasn't used your app in 6 months, or if you've exceeded the 50 token limit per user account.
-
-2. Clock skew — If your server's clock is out of sync by more than a few minutes, token validation will fail.
-
-3. Token already used — Refresh tokens are single-use by default. If a retry mechanism sends the same token twice, the second attempt will fail.
-
-Can you share your OAuth configuration and the token refresh logic? That will help me narrow down the root cause.`
-  },
-  {
-    id: '3',
-    role: 'user',
-    content: `Here's our auth setup:
-
-const oauthConfig = {
-  clientId: process.env.GOOGLE_CLIENT_ID,
-  clientSecret: process.env.GOOGLE_CLIENT_SECRET,
-  tokenEndpoint: "https://oauth2.googleapis.com/token",
-  grantType: "refresh_token"
-}`
-  },
-  {
-    id: '4',
-    role: 'assistant',
-    content: `I can see a couple of potential issues:
-
-First, you should add retry logic with a fresh token fetch on failure. The intermittent nature suggests it might be a race condition where multiple requests try to refresh the same token simultaneously.
-
-Here's what I'd recommend:
-• Add a token refresh mutex/lock to prevent concurrent refresh attempts
-• Implement a retry mechanism that fetches a fresh token on "invalid_grant"
-• Store the refresh token atomically to prevent stale reads
-
-Second, make sure you're storing the new refresh token returned in each refresh response — Google rotates them on every use.
-
-Want me to write the updated token refresh handler with these fixes?`
-  },
-  {
-    id: '5',
-    role: 'user',
-    content: 'Yes please, that would be great.'
-  },
-  {
-    id: '6',
-    role: 'assistant',
-    content: `Here's the updated token refresh handler with mutex locking and retry logic:
-
-The key changes are:
-• Added a refresh lock using a simple promise-based mutex to prevent concurrent refresh attempts
-• On "invalid_grant" error, the handler invalidates the cached token and retries once with a fresh token
-• New refresh tokens from the response are stored atomically before using the access token
-• Added exponential backoff for transient network errors
-
-This should resolve the intermittent failures. The mutex ensures that when multiple API calls trigger a refresh simultaneously, only the first one actually performs the refresh and the others wait for its result.
-
-Let me know if you'd like me to also add logging to help debug any remaining issues.`
-  }
-]
-</script>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockStatusBar.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockStatusBar.vue
deleted file mode 100644
index 017b0b70e..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockStatusBar.vue
+++ /dev/null
@@ -1,104 +0,0 @@
-<template>
-  <div class="w-full max-w-2xl flex items-center justify-between px-1 py-2">
-    <div class="flex items-center gap-1">
-      <!-- Model selector -->
-      <DropdownMenu>
-        <DropdownMenuTrigger as-child>
-          <Button
-            variant="ghost"
-            size="sm"
-            class="h-6 px-2 gap-1 text-xs text-muted-foreground hover:text-foreground backdrop-blur-lg"
-          >
-            <ModelIcon
-              model-id="anthropic"
-              custom-class="w-3.5 h-3.5"
-              :is-dark="themeStore.isDark"
-            />
-            <span>Claude 4 Sonnet</span>
-            <Icon icon="lucide:chevron-down" class="w-3 h-3" />
-          </Button>
-        </DropdownMenuTrigger>
-        <DropdownMenuContent align="start" class="min-w-0">
-          <DropdownMenuItem class="gap-2 text-xs py-1.5 px-2">
-            <ModelIcon
-              model-id="anthropic"
-              custom-class="w-3.5 h-3.5"
-              :is-dark="themeStore.isDark"
-            />
-            <span>Claude 4 Sonnet</span>
-          </DropdownMenuItem>
-          <DropdownMenuItem class="gap-2 text-xs py-1.5 px-2">
-            <ModelIcon model-id="openai" custom-class="w-3.5 h-3.5" :is-dark="themeStore.isDark" />
-            <span>GPT-4o</span>
-          </DropdownMenuItem>
-          <DropdownMenuItem class="gap-2 text-xs py-1.5 px-2">
-            <ModelIcon model-id="google" custom-class="w-3.5 h-3.5" :is-dark="themeStore.isDark" />
-            <span>Gemini 2.5 Pro</span>
-          </DropdownMenuItem>
-        </DropdownMenuContent>
-      </DropdownMenu>
-
-      <!-- Effort selector -->
-      <DropdownMenu>
-        <DropdownMenuTrigger as-child>
-          <Button
-            variant="ghost"
-            size="sm"
-            class="h-6 px-2 gap-1 text-xs text-muted-foreground hover:text-foreground backdrop-blur-lg"
-          >
-            <Icon icon="lucide:gauge" class="w-3.5 h-3.5" />
-            <span>High</span>
-            <Icon icon="lucide:chevron-down" class="w-3 h-3" />
-          </Button>
-        </DropdownMenuTrigger>
-        <DropdownMenuContent align="start" class="min-w-0">
-          <DropdownMenuItem class="text-xs py-1.5 px-2">Low</DropdownMenuItem>
-          <DropdownMenuItem class="text-xs py-1.5 px-2">Medium</DropdownMenuItem>
-          <DropdownMenuItem class="text-xs py-1.5 px-2">High</DropdownMenuItem>
-          <DropdownMenuItem class="text-xs py-1.5 px-2">Extra High</DropdownMenuItem>
-        </DropdownMenuContent>
-      </DropdownMenu>
-    </div>
-
-    <!-- Permissions -->
-    <DropdownMenu>
-      <DropdownMenuTrigger as-child>
-        <Button
-          variant="ghost"
-          size="sm"
-          class="h-6 px-2 gap-1.5 text-xs text-muted-foreground hover:text-foreground backdrop-blur-lg"
-        >
-          <Icon icon="lucide:shield" class="w-3.5 h-3.5" />
-          <span>{{ t('chat.permissionMode.default') }}</span>
-          <Icon icon="lucide:chevron-down" class="w-3 h-3" />
-        </Button>
-      </DropdownMenuTrigger>
-      <DropdownMenuContent align="end" class="min-w-0">
-        <DropdownMenuItem class="text-xs py-1.5 px-2">{{
-          t('chat.permissionMode.default')
-        }}</DropdownMenuItem>
-        <DropdownMenuItem class="text-xs py-1.5 px-2">Restricted</DropdownMenuItem>
-        <DropdownMenuItem class="text-xs py-1.5 px-2">{{
-          t('chat.permissionMode.fullAccess')
-        }}</DropdownMenuItem>
-      </DropdownMenuContent>
-    </DropdownMenu>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { Button } from '@shadcn/components/ui/button'
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
-  DropdownMenuTrigger
-} from '@shadcn/components/ui/dropdown-menu'
-import { Icon } from '@iconify/vue'
-import { useI18n } from 'vue-i18n'
-import ModelIcon from '../icons/ModelIcon.vue'
-import { useThemeStore } from '@/stores/theme'
-
-const themeStore = useThemeStore()
-const { t } = useI18n()
-</script>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockTopBar.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockTopBar.vue
deleted file mode 100644
index 91ab932ec..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockTopBar.vue
+++ /dev/null
@@ -1,66 +0,0 @@
-<template>
-  <div
-    class="sticky top-0 z-10 flex items-center justify-between h-12 px-4 bg-background/60 backdrop-blur-lg window-drag-region"
-  >
-    <div class="flex items-center gap-2 min-w-0">
-      <div v-if="project" class="flex items-center gap-1.5 text-muted-foreground">
-        <Icon icon="lucide:folder" class="w-3.5 h-3.5 shrink-0" />
-        <span class="text-xs truncate">{{ projectName }}</span>
-        <Icon icon="lucide:chevron-right" class="w-3 h-3 shrink-0" />
-      </div>
-      <h2 class="text-sm font-medium truncate">{{ title }}</h2>
-    </div>
-
-    <div class="flex items-center gap-1">
-      <Tooltip>
-        <TooltipTrigger as-child>
-          <Button
-            variant="ghost"
-            size="icon"
-            class="h-7 w-7 text-muted-foreground hover:text-foreground"
-          >
-            <Icon icon="lucide:share" class="w-4 h-4" />
-          </Button>
-        </TooltipTrigger>
-        <TooltipContent>Share</TooltipContent>
-      </Tooltip>
-
-      <Tooltip>
-        <TooltipTrigger as-child>
-          <Button
-            variant="ghost"
-            size="icon"
-            class="h-7 w-7 text-muted-foreground hover:text-foreground"
-          >
-            <Icon icon="lucide:ellipsis" class="w-4 h-4" />
-          </Button>
-        </TooltipTrigger>
-        <TooltipContent>More</TooltipContent>
-      </Tooltip>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { computed } from 'vue'
-import { Button } from '@shadcn/components/ui/button'
-import { Tooltip, TooltipContent, TooltipTrigger } from '@shadcn/components/ui/tooltip'
-import { Icon } from '@iconify/vue'
-
-const props = defineProps<{
-  title: string
-  project: string
-}>()
-
-const projectName = computed(() => props.project.split('/').pop() ?? props.project)
-</script>
-
-<style scoped>
-.window-drag-region {
-  -webkit-app-region: drag;
-}
-
-button {
-  -webkit-app-region: no-drag;
-}
-</style>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockWelcomePage.vue b/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockWelcomePage.vue
deleted file mode 100644
index b25407d95..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockWelcomePage.vue
+++ /dev/null
@@ -1,130 +0,0 @@
-<template>
-  <div class="h-full w-full flex flex-col window-drag-region">
-    <div class="flex-1 flex flex-col items-center justify-center px-6">
-      <!-- Logo -->
-      <div class="mb-5">
-        <img src="@/assets/logo-dark.png" class="w-16 h-16" loading="lazy" />
-      </div>
-
-      <!-- Heading -->
-      <h1 class="text-3xl font-semibold text-foreground mb-2">
-        {{ t('welcome.page.title') }}
-      </h1>
-      <p class="text-sm text-muted-foreground text-center max-w-md mb-10">
-        {{ t('welcome.page.description') }}
-      </p>
-
-      <!-- Provider grid -->
-      <div class="grid grid-cols-3 gap-2 w-full max-w-sm mb-4">
-        <button
-          v-for="provider in providers"
-          :key="provider.id"
-          class="flex flex-col items-center gap-2 rounded-xl border border-border/60 bg-card/40 px-3 py-4 hover:bg-accent/50 hover:border-border transition-all duration-150"
-          @click="onAddProvider"
-        >
-          <ModelIcon :model-id="provider.id" custom-class="w-6 h-6" :is-dark="themeStore.isDark" />
-          <span class="text-xs text-foreground/80">{{ t(provider.nameKey) }}</span>
-        </button>
-      </div>
-
-      <button
-        class="text-xs text-muted-foreground hover:text-foreground transition-colors mb-12"
-        @click="onAddProvider"
-      >
-        {{ t('welcome.page.browseProviders') }}
-      </button>
-
-      <!-- ACP agent section (optional) -->
-      <div class="flex flex-col items-center gap-3 w-full max-w-sm">
-        <div class="flex items-center gap-3 w-full">
-          <div class="flex-1 h-px bg-border"></div>
-          <span class="text-xs text-muted-foreground/60">{{ t('welcome.page.connectAgent') }}</span>
-          <div class="flex-1 h-px bg-border"></div>
-        </div>
-
-        <button
-          class="flex items-center gap-3 w-full rounded-xl border border-dashed border-border/60 px-4 py-3 hover:bg-accent/30 hover:border-border transition-all duration-150"
-          @click="onSetupAcp"
-        >
-          <div class="flex items-center justify-center w-8 h-8 rounded-lg bg-muted/60 shrink-0">
-            <Icon icon="lucide:terminal" class="w-4 h-4 text-muted-foreground" />
-          </div>
-          <div class="text-left">
-            <p class="text-sm text-foreground/80">{{ t('welcome.page.acpTitle') }}</p>
-            <p class="text-xs text-muted-foreground/60">{{ t('welcome.page.acpDescription') }}</p>
-          </div>
-          <Icon icon="lucide:chevron-right" class="w-4 h-4 text-muted-foreground/40 ml-auto" />
-        </button>
-      </div>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { Icon } from '@iconify/vue'
-import { useI18n } from 'vue-i18n'
-import { usePresenter } from '@/composables/usePresenter'
-import { SETTINGS_EVENTS } from '@/events'
-import { useThemeStore } from '@/stores/theme'
-import ModelIcon from '../icons/ModelIcon.vue'
-
-const { t } = useI18n()
-const windowPresenter = usePresenter('windowPresenter')
-const themeStore = useThemeStore()
-
-const providers = [
-  { id: 'claude', nameKey: 'welcome.page.providers.claude' },
-  { id: 'openai', nameKey: 'welcome.page.providers.openai' },
-  { id: 'deepseek', nameKey: 'welcome.page.providers.deepseek' },
-  { id: 'gemini', nameKey: 'welcome.page.providers.gemini' },
-  { id: 'ollama', nameKey: 'welcome.page.providers.ollama' },
-  { id: 'openrouter', nameKey: 'welcome.page.providers.openrouter' }
-]
-
-type SettingsRouteName = 'settings-provider' | 'settings-acp'
-
-const navigateToSettings = (windowId: number, routeName: SettingsRouteName) => {
-  windowPresenter.sendToWindow(windowId, SETTINGS_EVENTS.NAVIGATE, {
-    routeName
-  })
-}
-
-const openSettings = async (routeName: SettingsRouteName) => {
-  const windowId = window.api.getWindowId()
-  if (windowId != null) {
-    await windowPresenter.createSettingsWindow()
-    const settingsWindowId = windowPresenter.getSettingsWindowId()
-    if (settingsWindowId != null) {
-      navigateToSettings(settingsWindowId, routeName)
-      window.setTimeout(() => {
-        if (windowPresenter.getSettingsWindowId() === settingsWindowId) {
-          navigateToSettings(settingsWindowId, routeName)
-        }
-      }, 250)
-    }
-  }
-}
-
-const onAddProvider = async () => {
-  await openSettings('settings-provider')
-}
-
-const onSetupAcp = async () => {
-  await openSettings('settings-acp')
-}
-</script>
-
-<style scoped>
-.window-drag-region {
-  -webkit-app-region: drag;
-}
-
-button,
-a,
-input,
-select,
-textarea,
-[role='button'] {
-  -webkit-app-region: no-drag;
-}
-</style>
diff --git a/archives/code/dead-code-batch-2/src/renderer/src/composables/useMockViewState.ts b/archives/code/dead-code-batch-2/src/renderer/src/composables/useMockViewState.ts
deleted file mode 100644
index ebf8a8cb2..000000000
--- a/archives/code/dead-code-batch-2/src/renderer/src/composables/useMockViewState.ts
+++ /dev/null
@@ -1,23 +0,0 @@
-import { ref, computed } from 'vue'
-
-const _selectedSessionId = ref<string | null>(null)
-const _selectedSessionTitle = ref('')
-const _selectedSessionProject = ref('')
-const _showMockWelcome = ref(false)
-
-export function useMockViewState() {
-  const selectSession = (id: string | null, title: string = '', projectDir: string = '') => {
-    _selectedSessionId.value = id
-    _selectedSessionTitle.value = title
-    _selectedSessionProject.value = projectDir
-  }
-
-  return {
-    mockSessionId: _selectedSessionId,
-    mockSessionTitle: _selectedSessionTitle,
-    mockSessionProject: _selectedSessionProject,
-    showMockWelcome: _showMockWelcome,
-    isMockChatActive: computed(() => _selectedSessionId.value !== null),
-    selectSession
-  }
-}
diff --git a/archives/code/dead-code-batch-3/README.md b/archives/code/dead-code-batch-3/README.md
deleted file mode 100644
index bea975789..000000000
--- a/archives/code/dead-code-batch-3/README.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Dead Code Batch 3
-
-- Purpose: archive retired MCP runtime code that is no longer part of the active in-memory server set.
-- Archived at: 2026-03-26
-- Rationale: `meetingServer.ts` has been removed from live MCP registration and default config, but is retained in source form for precise rollback if the feature is rebuilt later.
-
-## Archived Paths
-
-- `src/main/presenter/mcpPresenter/inMemoryServers/meetingServer.ts`
-
-## Notes
-
-- This directory is not part of the runtime, build, typecheck, or test target set.
-- Restore by moving files back to their original paths only if a future audit proves the retired MCP server is needed again.
diff --git a/archives/code/dead-code-batch-3/src/main/presenter/mcpPresenter/inMemoryServers/meetingServer.ts b/archives/code/dead-code-batch-3/src/main/presenter/mcpPresenter/inMemoryServers/meetingServer.ts
deleted file mode 100644
index 991bc4f38..000000000
--- a/archives/code/dead-code-batch-3/src/main/presenter/mcpPresenter/inMemoryServers/meetingServer.ts
+++ /dev/null
@@ -1,98 +0,0 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js'
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js'
-import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js'
-import { z } from 'zod'
-import { zodToJsonSchema } from 'zod-to-json-schema'
-
-const ParticipantSchema = z
-  .object({
-    tab_id: z.number().optional(),
-    tab_title: z.string().optional(),
-    profile: z.string().optional()
-  })
-  .refine(
-    (data) => {
-      const hasId = data.tab_id !== undefined && data.tab_id !== -1
-      const hasTitle = data.tab_title !== undefined && data.tab_title.trim() !== ''
-      return (hasId && !hasTitle) || (!hasId && hasTitle)
-    },
-    {
-      message:
-        '错误：必须且只能通过 "tab_id" 或 "tab_title" 中的一个来指定参会者，两者不能同时提供，也不能都为空。'
-    }
-  )
-
-const StartMeetingArgsSchema = z.object({
-  participants: z
-    .array(ParticipantSchema)
-    .min(2, { message: '会议至少需要两位参会者。' })
-    .describe('参会者列表。'),
-  topic: z.string().describe('会议的核心讨论主题。'),
-  rounds: z.number().optional().default(3).describe('讨论的轮次数，默认为3轮。')
-})
-
-export class MeetingServer {
-  private server: Server
-
-  constructor() {
-    this.server = new Server(
-      { name: 'meeting-server', version: '1.0.0' },
-      { capabilities: { tools: {} } }
-    )
-    this.setupRequestHandlers()
-  }
-
-  public startServer(transport: Transport): void {
-    this.server.connect(transport)
-  }
-
-  private setupRequestHandlers(): void {
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-      tools: [
-        {
-          name: 'start_meeting',
-          description:
-            'Legacy helper. Disabled while the app migrates to the window-native architecture.',
-          inputSchema: zodToJsonSchema(StartMeetingArgsSchema),
-          annotations: {
-            title: 'Start Meeting',
-            destructiveHint: false
-          }
-        }
-      ]
-    }))
-
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      const { name, arguments: args } = request.params
-      if (name !== 'start_meeting') {
-        throw new Error(`未知的工具: ${name}`)
-      }
-
-      try {
-        StartMeetingArgsSchema.parse(args)
-        return {
-          content: [
-            {
-              type: 'text',
-              text: [
-                'Legacy helper disabled.',
-                'Reason: the old multi-tab meeting flow no longer matches the window-native architecture.'
-              ].join(' ')
-            }
-          ],
-          isError: true
-        }
-      } catch (error) {
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `会议启动失败: ${error instanceof Error ? error.message : String(error)}`
-            }
-          ],
-          isError: true
-        }
-      }
-    })
-  }
-}
diff --git a/archives/code/dead-renderer-batch-1/README.md b/archives/code/dead-renderer-batch-1/README.md
deleted file mode 100644
index c7d250859..000000000
--- a/archives/code/dead-renderer-batch-1/README.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# Dead Renderer Batch 1
-
-- Purpose: archive renderer dead code that is no longer on the active chat path.
-- Archived at: 2026-03-15
-- Rationale: static inspection confirmed there are no active references in `src/`, `test/`, or live docs. Files are kept in source form for precise rollback only.
-
-## Archived Paths
-
-- `src/renderer/src/components/message/MessageMinimap.vue`
-- `src/renderer/src/composables/message/useMessageMinimap.ts`
-- `src/renderer/src/components/MessageNavigationSidebar.vue`
-- `src/renderer/src/lib/messageRuntimeCache.ts`
-
-## Notes
-
-- This directory is not part of the runtime, build, typecheck, or test target set.
-- Restore by moving files back to their original paths if a later audit proves they are still needed.
diff --git a/archives/code/dead-renderer-batch-1/src/renderer/src/components/MessageNavigationSidebar.vue b/archives/code/dead-renderer-batch-1/src/renderer/src/components/MessageNavigationSidebar.vue
deleted file mode 100644
index 15d2fd9e1..000000000
--- a/archives/code/dead-renderer-batch-1/src/renderer/src/components/MessageNavigationSidebar.vue
+++ /dev/null
@@ -1,366 +0,0 @@
-<template>
-  <div
-    class="message-navigation-sidebar h-full w-full bg-card border-l border-border flex flex-col"
-  >
-    <!-- 头部 -->
-    <div class="flex items-center justify-between p-4 border-b border-border">
-      <h3 class="text-sm font-medium text-foreground">{{ t('chat.navigation.title') }}</h3>
-      <Button variant="ghost" size="icon" class="h-6 w-6" @click="$emit('close')">
-        <Icon icon="lucide:x" class="h-4 w-4" />
-      </Button>
-    </div>
-
-    <!-- 搜索框 -->
-    <div class="p-4 border-b border-border">
-      <div class="relative">
-        <Icon
-          icon="lucide:search"
-          class="absolute left-3 top-1/2 transform -translate-y-1/2 h-4 w-4 text-muted-foreground"
-        />
-        <Input
-          v-model="searchQuery"
-          :placeholder="t('chat.navigation.searchPlaceholder')"
-          class="pl-10 pr-8 h-8 text-sm"
-        />
-        <Button
-          v-if="searchQuery.trim()"
-          variant="ghost"
-          size="icon"
-          class="absolute right-1 top-1/2 transform -translate-y-1/2 h-6 w-6"
-          @click="searchQuery = ''"
-        >
-          <Icon icon="lucide:x" class="h-3 w-3" />
-        </Button>
-      </div>
-
-      <!-- 搜索结果计数 -->
-      <div v-if="searchQuery.trim()" class="mt-2 text-xs text-muted-foreground">
-        {{
-          t('chat.navigation.searchResults', {
-            count: filteredMessages.length,
-            total: totalMessages
-          })
-        }}
-      </div>
-    </div>
-
-    <!-- 消息列表 -->
-    <div ref="messagesContainer" class="flex-1 overflow-y-auto scroll-smooth relative">
-      <div class="p-2 space-y-1">
-        <div
-          v-for="(message, index) in filteredMessages"
-          :key="message.id"
-          class="message-nav-item p-3 rounded-lg cursor-pointer transition-colors hover:bg-accent/50"
-          :class="{
-            'bg-accent': activeMessageId === message.id,
-            'border-l-2 border-primary': activeMessageId === message.id
-          }"
-          @click="scrollToMessage(message.id)"
-        >
-          <div class="flex items-center justify-between mb-2">
-            <div class="flex items-center gap-2">
-              <div class="shrink-0">
-                <div
-                  v-if="message.role === 'assistant'"
-                  class="w-4 h-4 flex items-center justify-center bg-base-900/5 dark:bg-base-100/10 border border-input rounded-sm"
-                >
-                  <ModelIcon
-                    :model-id="message.model_provider || 'default'"
-                    class="w-2.5 h-2.5"
-                    :is-dark="themeStore.isDark"
-                  />
-                </div>
-                <div v-else class="w-4 h-4 bg-muted rounded-sm flex items-center justify-center">
-                  <Icon icon="lucide:user" class="w-2.5 h-2.5 text-muted-foreground" />
-                </div>
-              </div>
-
-              <span class="text-xs text-muted-foreground font-mono"> #{{ index + 1 }} </span>
-            </div>
-
-            <span class="text-xs text-muted-foreground">
-              {{ formatTime(message.timestamp) }}
-            </span>
-          </div>
-
-          <div class="text-sm text-foreground/80 line-clamp-2">
-            <span v-html="highlightSearchQuery(getMessagePreview(message))"></span>
-          </div>
-        </div>
-      </div>
-
-      <div
-        v-if="filteredMessages.length === 0"
-        class="flex flex-col items-center justify-center h-32 text-muted-foreground"
-      >
-        <Icon icon="lucide:message-circle" class="h-8 w-8 mb-2" />
-        <p class="text-sm">
-          {{ searchQuery ? t('chat.navigation.noResults') : t('chat.navigation.noMessages') }}
-        </p>
-      </div>
-
-      <!-- 滚动锚点 -->
-      <div ref="scrollAnchor" class="h-2" />
-
-      <!-- 滚动到底部按钮 -->
-      <div v-if="showScrollToBottomButton && !searchQuery.trim()" class="absolute bottom-4 right-4">
-        <Button
-          variant="outline"
-          size="icon"
-          class="h-8 w-8 rounded-full shadow-lg bg-background border"
-          @click="scrollToBottom"
-        >
-          <Icon icon="lucide:arrow-down" class="h-4 w-4" />
-        </Button>
-      </div>
-    </div>
-
-    <div class="p-4 border-t border-border">
-      <div class="text-xs text-muted-foreground text-center">
-        {{ t('chat.navigation.totalMessages', { count: totalMessages }) }}
-      </div>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { ref, computed, watch, nextTick, onMounted, onUnmounted } from 'vue'
-import { Icon } from '@iconify/vue'
-import { Button } from '@shadcn/components/ui/button'
-import { Input } from '@shadcn/components/ui/input'
-import { useI18n } from 'vue-i18n'
-import { useThemeStore } from '@/stores/theme'
-import ModelIcon from '@/components/icons/ModelIcon.vue'
-import type { Message } from '@shared/chat'
-import { isSafeRegexPattern } from '@shared/regexValidator'
-
-interface Props {
-  messages: Message[]
-  totalMessages: number
-  isOpen: boolean
-  activeMessageId?: string
-}
-
-const props = defineProps<Props>()
-
-const emit = defineEmits<{
-  close: []
-  scrollToMessage: [messageId: string]
-}>()
-
-const { t } = useI18n()
-const themeStore = useThemeStore()
-
-const searchQuery = ref('')
-const messagesContainer = ref<HTMLDivElement>()
-const scrollAnchor = ref<HTMLDivElement>()
-const showScrollToBottomButton = ref(false)
-
-// 获取消息完整内容用于搜索
-const getFullMessageContent = (message: Message): string => {
-  if (message.role === 'user') {
-    const userContent = message.content as import('@shared/chat').UserMessageContent
-    return userContent.text || ''
-  } else if (message.role === 'assistant') {
-    const assistantMessage = message as import('@shared/chat').AssistantMessage
-    const contentToDisplay =
-      assistantMessage.content as import('@shared/chat').AssistantMessageBlock[]
-    return contentToDisplay
-      .filter((block: import('@shared/chat').AssistantMessageBlock) => block.type === 'content')
-      .map((block: import('@shared/chat').AssistantMessageBlock) => block.content || '')
-      .join(' ')
-  }
-  return ''
-}
-
-// 获取搜索匹配的上下文
-const getSearchContext = (content: string, query: string, contextLength: number = 30): string => {
-  const lowerContent = content.toLowerCase()
-  const lowerQuery = query.toLowerCase()
-  const matchIndex = lowerContent.indexOf(lowerQuery)
-  if (matchIndex === -1) return content.slice(0, 100)
-  const start = Math.max(0, matchIndex - contextLength)
-  const end = Math.min(content.length, matchIndex + query.length + contextLength)
-  let result = content.slice(start, end)
-  if (start > 0) result = '...' + result
-  if (end < content.length) result = result + '...'
-  return result
-}
-
-// 过滤消息
-const filteredMessages = computed(() => {
-  if (!searchQuery.value.trim()) {
-    return props.messages
-  }
-  const query = searchQuery.value.toLowerCase()
-  return props.messages.filter((message) => {
-    const fullContent = getFullMessageContent(message).toLowerCase()
-    return fullContent.includes(query)
-  })
-})
-
-// 获取消息预览文本
-const getMessagePreview = (message: Message): string => {
-  const fullContent = getFullMessageContent(message)
-  if (!fullContent) {
-    if (message.role === 'user') {
-      return t('chat.navigation.userMessage')
-    } else if (message.role === 'assistant') {
-      return t('chat.navigation.assistantMessage')
-    }
-    return t('chat.navigation.unknownMessage')
-  }
-  // 如果有搜索查询，显示搜索上下文
-  if (searchQuery.value.trim()) {
-    return getSearchContext(fullContent, searchQuery.value)
-  }
-  return fullContent.slice(0, 100) + (fullContent.length > 100 ? '...' : '')
-}
-
-// 格式化时间
-const formatTime = (timestamp: number): string => {
-  const date = new Date(timestamp)
-  const now = new Date()
-  const diff = now.getTime() - date.getTime()
-  if (diff < 24 * 60 * 60 * 1000 && date.getDate() === now.getDate()) {
-    return date.toLocaleTimeString('zh-CN', {
-      hour: '2-digit',
-      minute: '2-digit'
-    })
-  }
-  return date.toLocaleDateString('zh-CN', {
-    month: 'short',
-    day: 'numeric',
-    hour: '2-digit',
-    minute: '2-digit'
-  })
-}
-
-// 高亮搜索关键词
-const highlightSearchQuery = (text: string): string => {
-  if (!searchQuery.value.trim()) {
-    return text
-  }
-
-  const query = searchQuery.value.trim()
-  // Escape special characters and validate pattern for ReDoS safety
-  const escapedQuery = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-  const pattern = `(${escapedQuery})`
-  if (!isSafeRegexPattern(pattern)) {
-    // If pattern is unsafe, return text without highlighting
-    return text
-  }
-  const regex = new RegExp(pattern, 'gi')
-  return text.replace(
-    regex,
-    '<mark class="bg-yellow-200 dark:bg-yellow-800 px-1 rounded">$1</mark>'
-  )
-}
-
-// 滚动到底部
-const scrollToBottom = () => {
-  nextTick(() => {
-    scrollAnchor.value?.scrollIntoView({
-      behavior: 'instant',
-      block: 'end'
-    })
-  })
-}
-
-// 滚动到指定消息
-const scrollToMessage = (messageId: string) => {
-  emit('scrollToMessage', messageId)
-}
-
-watch(
-  () => props.messages.length,
-  (newLength, oldLength) => {
-    // 只在新增消息时滚动，避免过度滚动
-    if (newLength > oldLength && !searchQuery.value.trim()) {
-      nextTick(() => {
-        scrollToBottom()
-      })
-    }
-  }
-)
-
-watch(
-  () => props.isOpen,
-  (newIsOpen) => {
-    if (newIsOpen && !searchQuery.value.trim()) {
-      nextTick(() => {
-        scrollToBottom()
-        setupScrollObserver()
-      })
-    } else if (newIsOpen) {
-      nextTick(() => {
-        setupScrollObserver()
-      })
-    }
-  }
-)
-
-let intersectionObserver: IntersectionObserver | null = null
-
-const setupScrollObserver = () => {
-  if (intersectionObserver) {
-    intersectionObserver.disconnect()
-  }
-
-  intersectionObserver = new IntersectionObserver(
-    (entries) => {
-      const entry = entries[0]
-      showScrollToBottomButton.value = !entry.isIntersecting
-    },
-    {
-      root: messagesContainer.value,
-      rootMargin: '0px 0px 20px 0px',
-      threshold: 0
-    }
-  )
-
-  if (scrollAnchor.value) {
-    intersectionObserver.observe(scrollAnchor.value)
-  }
-}
-
-// 组件挂载时滚动到底部
-onMounted(() => {
-  if (props.isOpen && !searchQuery.value.trim()) {
-    nextTick(() => {
-      scrollToBottom()
-      setupScrollObserver()
-    })
-  } else {
-    nextTick(() => {
-      setupScrollObserver()
-    })
-  }
-})
-
-// 清理观察器
-onUnmounted(() => {
-  if (intersectionObserver) {
-    intersectionObserver.disconnect()
-    intersectionObserver = null
-  }
-})
-</script>
-
-<style scoped>
-.message-nav-item {
-  transition: all 0.2s ease;
-}
-
-.message-nav-item:hover {
-  transform: translateX(2px);
-}
-
-.line-clamp-2 {
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  line-clamp: 2;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}
-</style>
diff --git a/archives/code/dead-renderer-batch-1/src/renderer/src/components/message/MessageMinimap.vue b/archives/code/dead-renderer-batch-1/src/renderer/src/components/message/MessageMinimap.vue
deleted file mode 100644
index 2e440aa51..000000000
--- a/archives/code/dead-renderer-batch-1/src/renderer/src/components/message/MessageMinimap.vue
+++ /dev/null
@@ -1,291 +0,0 @@
-<template>
-  <div
-    class="absolute top-0 right-0 w-14 min-h-[148px] box-border rounded-md py-4 px-3 flex flex-col items-stretch gap-0 pointer-events-none z-[5] overflow-hidden"
-  >
-    <div
-      class="map-list relative max-h-[70vh] flex-1 flex justify-end w-full pointer-events-auto overflow-y-auto"
-    >
-      <TooltipProvider :delay-duration="80">
-        <div class="flex flex-col items-end gap-1 w-full relative z-2" role="list">
-          <TooltipRoot v-for="bar in bars" :key="bar.id">
-            <TooltipTrigger>
-              <button
-                type="button"
-                class="w-full h-2.5 pl-2 pr-1.5 flex items-center justify-end gap-1 rounded-sm transition-[transform,opacity] duration-200 ease-out outline-none border-0 cursor-pointer focus-visible:outline-none"
-                :class="[isActiveBar(bar.id) ? 'opacity-100' : 'opacity-60']"
-                :aria-label="bar.ariaLabel"
-                role="listitem"
-                @mouseenter="handleBarEnter(bar.id)"
-                @mouseleave="handleBarLeave"
-                @focus="handleBarEnter(bar.id)"
-                @blur="handleBarLeave"
-                @click.stop="handleBarClick(bar.id)"
-              >
-                <span
-                  class="block h-1.5 rounded-xs transition-[transform,background-color] duration-200 ease-out pointer-events-none"
-                  :class="[
-                    bar.role === 'assistant'
-                      ? isActiveBar(bar.id)
-                        ? 'bg-[rgba(37,37,37,0.75)] dark:bg-[rgba(255,255,255,0.95)]'
-                        : 'bg-[rgba(37,37,37,0.3)] dark:bg-[rgba(255,255,255,0.5)]'
-                      : isActiveBar(bar.id)
-                        ? 'bg-[rgba(37,37,37,0.55)] dark:bg-[rgba(255,255,255,0.8)]'
-                        : 'bg-[rgba(37,37,37,0.2)] dark:bg-[rgba(255,255,255,0.35)]',
-                    isActiveBar(bar.id) ? 'scale-x-110 -translate-x-0.5' : ''
-                  ]"
-                  :style="{ width: `${bar.width}px` }"
-                />
-              </button>
-            </TooltipTrigger>
-            <TooltipContent
-              v-if="getPreviewData(bar.id)"
-              class="max-w-64 border border-border/60 bg-background/95 dark:bg-base-900/90 text-[11px] leading-snug rounded-md shadow-sm px-3 py-2"
-              side="left"
-              :side-offset="6"
-              align="end"
-            >
-              <div class="text-[11px] font-medium text-muted-foreground mb-1 leading-none">
-                #{{ getPreviewData(bar.id)?.index }} · {{ getPreviewData(bar.id)?.role }}
-              </div>
-              <div class="text-[11px] text-foreground/85 whitespace-pre-line">
-                {{ getPreviewData(bar.id)?.preview }}
-              </div>
-            </TooltipContent>
-          </TooltipRoot>
-        </div>
-      </TooltipProvider>
-    </div>
-    <div
-      v-if="overallContextUsage !== null"
-      class="font-['Geist\\ Mono',ui-monospace,SFMono-Regular,SFMono,Menlo,Monaco,Consolas,'Liberation\\ Mono','Courier\\ New',monospace] text-[11px] leading-none text-[rgba(37,37,37,0.6)] mt-[6px] self-end pointer-events-auto dark:text-[rgba(255,255,255,0.6)]"
-    >
-      {{ overallContextUsage.toFixed(0) }}%
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { computed, ref, watch } from 'vue'
-import type { AssistantMessage, Message, UserMessage } from '@shared/chat'
-import { TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger } from 'reka-ui'
-
-interface ScrollInfo {
-  viewportHeight: number
-  contentHeight: number
-  scrollTop: number
-}
-
-interface Props {
-  messages: Message[]
-  hoveredMessageId?: string | null
-  activeMessageId?: string | null
-  scrollInfo?: ScrollInfo
-}
-
-const props = defineProps<Props>()
-
-const emit = defineEmits<{
-  (e: 'bar-hover', messageId: string | null): void
-  (e: 'bar-click', messageId: string): void
-}>()
-
-const localHoveredId = ref<string | null>(null)
-
-const MIN_WIDTH = 8
-const MAX_WIDTH = 20
-
-const getMessageContentLength = (message: Message) => {
-  if (message.role === 'assistant') {
-    const assistantMessage = message as AssistantMessage
-    const blocks = assistantMessage.content ?? []
-    const combined = blocks
-      .filter((block) => block.type === 'content' || block.type === 'reasoning_content')
-      .map((block) => block.content ?? '')
-      .join(' ')
-    const usageTokens = assistantMessage.usage?.total_tokens ?? 0
-    return usageTokens > 0 ? usageTokens : combined.length
-  }
-
-  const userMessage = message as UserMessage
-  const content = userMessage.content
-  const textParts: string[] = []
-  const resolveUserBlockText = (block: {
-    type?: string
-    content?: string
-    category?: string
-    id?: string
-  }) => {
-    if (block?.type === 'mention' && block?.category === 'context') {
-      const label = block.id?.trim() || 'context'
-      return `@${label}`
-    }
-    return typeof block?.content === 'string' ? block.content : ''
-  }
-
-  if (content?.text) {
-    textParts.push(content.text)
-  } else if (content?.content) {
-    content.content.forEach((block) => {
-      textParts.push(resolveUserBlockText(block))
-    })
-  }
-  if (content?.files?.length) {
-    textParts.push(content.files.map((file) => file.name ?? '').join(' '))
-  }
-  return textParts.join(' ').length || (userMessage.usage?.input_tokens ?? 0)
-}
-
-const bars = computed(() => {
-  if (!props.messages?.length) {
-    return []
-  }
-
-  const messageLengths = props.messages.map((message) => ({
-    id: message.id,
-    role: message.role,
-    length: getMessageContentLength(message),
-    contextUsage: message.usage?.context_usage ?? 0
-  }))
-
-  const maxLength = Math.max(...messageLengths.map((item) => item.length), 1)
-
-  return messageLengths.map((item, index) => {
-    const normalized = maxLength === 0 ? 0 : item.length / maxLength
-    const width = MIN_WIDTH + normalized * (MAX_WIDTH - MIN_WIDTH)
-    return {
-      id: item.id,
-      role: item.role,
-      width: Math.min(MAX_WIDTH, Math.max(MIN_WIDTH, width)),
-      ariaLabel: `Message ${index + 1}, ${item.role}`,
-      contextUsage: item.contextUsage
-    }
-  })
-})
-
-const overallContextUsage = computed(() => {
-  const usageValues = props.messages
-    ?.map((message) => message.usage?.context_usage)
-    .filter((value): value is number => typeof value === 'number' && !Number.isNaN(value))
-
-  if (!usageValues?.length) {
-    return null
-  }
-
-  return Math.max(...usageValues)
-})
-
-watch(
-  () => props.hoveredMessageId,
-  (value) => {
-    localHoveredId.value = value as string | null
-  }
-)
-
-const hoveredMessageId = computed(() => props.hoveredMessageId ?? localHoveredId.value)
-const activeMessageId = computed(() => props.activeMessageId ?? null)
-
-const formatUserBlock = (block: {
-  type?: string
-  content?: string
-  category?: string
-  id?: string
-}) => {
-  if (block?.type === 'mention' && block?.category === 'context') {
-    const label = block.id?.trim() || 'context'
-    return `@${label}`
-  }
-  return typeof block?.content === 'string' ? block.content : ''
-}
-
-const buildPreview = (message: Message) => {
-  if (message.role === 'assistant') {
-    const assistant = message as AssistantMessage
-    const text = (assistant.content ?? [])
-      .filter((block) => block.type === 'content' || block.type === 'reasoning_content')
-      .map((block) => block.content ?? '')
-      .join(' ')
-    return text || 'assistant'
-  }
-  const user = message as UserMessage
-  const parts: string[] = []
-  if (user.content?.text) parts.push(user.content.text)
-  if (Array.isArray(user.content?.content)) {
-    parts.push(...user.content.content.map((block) => formatUserBlock(block)))
-  }
-  if (user.content?.files?.length) {
-    parts.push(user.content.files.map((file) => file.name ?? '').join(' '))
-  }
-  return parts.join(' ').trim() || 'user'
-}
-
-const getPreviewData = (messageId: string) => {
-  const messageIndex = props.messages.findIndex((msg) => msg.id === messageId)
-  if (messageIndex === -1) return null
-  const message = props.messages[messageIndex]
-  const previewText = buildPreview(message)
-  const roleLabel = message.role === 'assistant' ? 'assistant' : 'user'
-  const truncated =
-    previewText.length > 30 ? `${previewText.slice(0, 27).trimEnd()}...` : previewText
-  return {
-    index: messageIndex + 1,
-    role: roleLabel,
-    preview: truncated
-  }
-}
-
-const isActiveBar = (messageId: string) => {
-  return hoveredMessageId.value === messageId || activeMessageId.value === messageId
-}
-
-const handleBarEnter = (messageId: string) => {
-  localHoveredId.value = messageId
-  emit('bar-hover', messageId)
-}
-
-const handleBarLeave = () => {
-  localHoveredId.value = null
-  emit('bar-hover', null)
-}
-
-const handleBarClick = (messageId: string) => {
-  emit('bar-click', messageId)
-}
-</script>
-
-<style scoped>
-/* 自定义滚动条样式，不占用布局空间 */
-.map-list::-webkit-scrollbar {
-  width: 4px;
-}
-
-.map-list::-webkit-scrollbar-track {
-  background: transparent;
-}
-
-.map-list::-webkit-scrollbar-thumb {
-  background-color: rgba(0, 0, 0, 0.2);
-  border-radius: 2px;
-}
-
-.dark .map-list::-webkit-scrollbar-thumb {
-  background-color: rgba(255, 255, 255, 0.2);
-}
-
-.map-list::-webkit-scrollbar-thumb:hover {
-  background-color: rgba(0, 0, 0, 0.3);
-}
-
-.dark .map-list::-webkit-scrollbar-thumb:hover {
-  background-color: rgba(255, 255, 255, 0.3);
-}
-
-/* Firefox */
-.map-list {
-  scrollbar-width: thin;
-  scrollbar-color: rgba(0, 0, 0, 0.2) transparent;
-}
-
-.dark .map-list {
-  scrollbar-color: rgba(255, 255, 255, 0.2) transparent;
-}
-</style>
diff --git a/archives/code/dead-renderer-batch-1/src/renderer/src/composables/message/useMessageMinimap.ts b/archives/code/dead-renderer-batch-1/src/renderer/src/composables/message/useMessageMinimap.ts
deleted file mode 100644
index d4f250ec3..000000000
--- a/archives/code/dead-renderer-batch-1/src/renderer/src/composables/message/useMessageMinimap.ts
+++ /dev/null
@@ -1,16 +0,0 @@
-import { ref, readonly, type DeepReadonly } from 'vue'
-import type { ScrollInfo } from './types'
-
-export function useMessageMinimap(scrollInfoRef: DeepReadonly<ScrollInfo>) {
-  const hoveredMessageId = ref<string | null>(null)
-
-  const handleHover = (messageId: string | null) => {
-    hoveredMessageId.value = messageId
-  }
-
-  return {
-    hoveredMessageId: readonly(hoveredMessageId),
-    scrollInfo: scrollInfoRef,
-    handleHover
-  }
-}
diff --git a/archives/code/dead-renderer-batch-1/src/renderer/src/lib/messageRuntimeCache.ts b/archives/code/dead-renderer-batch-1/src/renderer/src/lib/messageRuntimeCache.ts
deleted file mode 100644
index 842b7b1e3..000000000
--- a/archives/code/dead-renderer-batch-1/src/renderer/src/lib/messageRuntimeCache.ts
+++ /dev/null
@@ -1,102 +0,0 @@
-import type { Message } from '@shared/chat'
-
-type DomInfo = {
-  top: number
-  height: number
-}
-
-type DomInfoEntry = {
-  id: string
-  top: number
-  height: number
-}
-
-const MAX_CACHE_ENTRIES = 800
-
-const messageCache = new Map<string, Message>()
-const messageThreadMap = new Map<string, string>()
-const messageDomInfo = new Map<string, DomInfo>()
-
-const touch = (messageId: string, message: Message) => {
-  if (!messageCache.has(messageId)) return
-  messageCache.delete(messageId)
-  messageCache.set(messageId, message)
-}
-
-const prune = () => {
-  while (messageCache.size > MAX_CACHE_ENTRIES) {
-    const oldestId = messageCache.keys().next().value as string | undefined
-    if (!oldestId) return
-    messageCache.delete(oldestId)
-    messageThreadMap.delete(oldestId)
-    messageDomInfo.delete(oldestId)
-  }
-}
-
-export const getCachedMessage = (messageId: string): Message | null => {
-  const message = messageCache.get(messageId)
-  if (!message) return null
-  touch(messageId, message)
-  return message
-}
-
-export const hasCachedMessage = (messageId: string): boolean => {
-  return messageCache.has(messageId)
-}
-
-export const cacheMessage = (message: Message) => {
-  messageCache.set(message.id, message)
-  messageThreadMap.set(message.id, message.conversationId)
-  touch(message.id, message)
-  prune()
-}
-
-export const cacheMessages = (messages: Message[]) => {
-  for (const message of messages) {
-    cacheMessage(message)
-  }
-}
-
-export const deleteCachedMessage = (messageId: string) => {
-  messageCache.delete(messageId)
-  messageThreadMap.delete(messageId)
-  messageDomInfo.delete(messageId)
-}
-
-export const clearCachedMessagesForThread = (threadId: string) => {
-  for (const [messageId, conversationId] of messageThreadMap.entries()) {
-    if (conversationId === threadId) {
-      messageCache.delete(messageId)
-      messageThreadMap.delete(messageId)
-      messageDomInfo.delete(messageId)
-    }
-  }
-}
-
-export const clearMessageCache = () => {
-  messageCache.clear()
-  messageThreadMap.clear()
-  messageDomInfo.clear()
-}
-
-export const setMessageDomInfo = (entries: Array<{ id: string; top: number; height: number }>) => {
-  for (const entry of entries) {
-    messageDomInfo.set(entry.id, { top: entry.top, height: entry.height })
-  }
-}
-
-export const getMessageDomInfo = (messageId: string): DomInfo | null => {
-  return messageDomInfo.get(messageId) ?? null
-}
-
-export const getAllMessageDomInfo = (): DomInfoEntry[] => {
-  return Array.from(messageDomInfo.entries()).map(([id, info]) => ({
-    id,
-    top: info.top,
-    height: info.height
-  }))
-}
-
-export const clearMessageDomInfo = () => {
-  messageDomInfo.clear()
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/README.md b/archives/code/legacy-agentpresenter-retirement/README.md
deleted file mode 100644
index cd30dfa9a..000000000
--- a/archives/code/legacy-agentpresenter-retirement/README.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# Legacy AgentPresenter Retirement
-
-- Purpose: archive the retired `AgentPresenter` runtime after `newAgentPresenter + deepchatAgentPresenter` became the only live chat execution path.
-- Archived at: 2026-03-23
-- Rationale: the remaining legacy runtime wiring, legacy loop compatibility surface, and legacy-only tests were removed from the live tree. Retained ACP/tool/message-formatting helpers were moved to new owner modules before archiving.
-
-## Archived Paths
-
-- `src/main/presenter/agentPresenter/`
-- `src/shared/types/presenters/agent.presenter.d.ts`
-- `test/main/presenter/agentPresenter/`
-- `test/main/presenter/sessionPresenter/permissionHandler.test.ts`
-
-## Notes
-
-- This directory is not part of the runtime, build, typecheck, or test target set.
-- Restore by moving files back to their original paths only if a future audit proves the retired legacy runtime is still needed.
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/backgroundExecSessionManager.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/backgroundExecSessionManager.ts
deleted file mode 100644
index c4dc8700c..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/backgroundExecSessionManager.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export {
-  BackgroundExecSessionManager,
-  backgroundExecSessionManager,
-  type SessionMeta
-} from '@/lib/agentRuntime/backgroundExecSessionManager'
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/index.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/index.ts
deleted file mode 100644
index fe82c8297..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/index.ts
+++ /dev/null
@@ -1,38 +0,0 @@
-export type * from './types'
-
-export {
-  AcpProcessManager,
-  type AcpProcessHandle,
-  type SessionNotificationHandler,
-  type PermissionResolver
-} from './acpProcessManager'
-export { AcpSessionManager, type AcpSessionRecord } from './acpSessionManager'
-export { AcpSessionPersistence } from './acpSessionPersistence'
-export { buildClientCapabilities, type AcpCapabilityOptions } from './acpCapabilities'
-export { AcpMessageFormatter } from './acpMessageFormatter'
-export { AcpContentMapper } from './acpContentMapper'
-export {
-  LEGACY_MODEL_CONFIG_ID,
-  LEGACY_MODE_CONFIG_ID,
-  createEmptyAcpConfigState,
-  getAcpConfigOption,
-  getAcpConfigOptionByCategory,
-  getAcpConfigOptionLabel,
-  hasAcpConfigStateData,
-  getLegacyModeState,
-  normalizeAcpConfigState,
-  updateAcpConfigStateValue
-} from './acpConfigState'
-export { AcpFsHandler } from './acpFsHandler'
-export { AcpTerminalManager } from './acpTerminalManager'
-export { AgentFileSystemHandler } from './agentFileSystemHandler'
-export { AgentToolManager, type AgentToolCallResult } from './agentToolManager'
-export { AgentBashHandler } from './agentBashHandler'
-export {
-  BackgroundExecSessionManager,
-  backgroundExecSessionManager,
-  type SessionMeta
-} from './backgroundExecSessionManager'
-export { getShellEnvironment, clearShellEnvironmentCache } from './shellEnvHelper'
-export { convertMcpConfigToAcpFormat } from './mcpConfigConverter'
-export { filterMcpServersByTransportSupport } from './mcpTransportFilter'
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/shellEnvHelper.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/shellEnvHelper.ts
deleted file mode 100644
index 846227653..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/shellEnvHelper.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export {
-  clearShellEnvironmentCache,
-  getShellEnvironment,
-  getUserShell
-} from '@/lib/agentRuntime/shellEnvHelper'
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/agent/index.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/agent/index.ts
deleted file mode 100644
index 336ce12bb..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/agent/index.ts
+++ /dev/null
@@ -1 +0,0 @@
-export {}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/index.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/index.ts
deleted file mode 100644
index 03b076f5f..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/index.ts
+++ /dev/null
@@ -1,674 +0,0 @@
-import type {
-  CONVERSATION,
-  IAgentPresenter,
-  IConfigPresenter,
-  ILlmProviderPresenter,
-  IMCPPresenter,
-  ISessionPresenter,
-  ISkillPresenter,
-  ISQLitePresenter,
-  IToolPresenter,
-  MESSAGE_METADATA
-} from '@shared/presenter'
-import type { AssistantMessage, AssistantMessageBlock, UserMessageContent } from '@shared/chat'
-import { eventBus, SendTarget } from '@/eventbus'
-import { STREAM_EVENTS } from '@/events'
-import type { SessionContextResolved } from './session/sessionContext'
-import type { SessionManager } from './session/sessionManager'
-import type { AgentSessionRuntimePort } from './session/sessionRuntimePort'
-import type {
-  AgentMcpRuntimePort,
-  AgentPermissionRuntimePort,
-  AgentPromptRuntimePort
-} from './runtimePorts'
-import { MessageManager } from '../sessionPresenter/managers/messageManager'
-import type { ThreadHandlerContext } from './types/handlerContext'
-import { CommandPermissionService } from '../permission/commandPermissionService'
-import { ContentBufferHandler } from './streaming/contentBufferHandler'
-import { LLMEventHandler } from './streaming/llmEventHandler'
-import { StreamGenerationHandler } from './streaming/streamGenerationHandler'
-import type { GeneratingMessageState } from './streaming/types'
-import { StreamUpdateScheduler } from './streaming/streamUpdateScheduler'
-import { ToolCallHandler } from './loop/toolCallHandler'
-import { PermissionHandler } from './permission/permissionHandler'
-import { UtilityHandler } from './utility/utilityHandler'
-
-type AgentPresenterDependencies = {
-  sessionPresenter: ISessionPresenter
-  sessionManager: SessionManager
-  sqlitePresenter: ISQLitePresenter
-  llmProviderPresenter: ILlmProviderPresenter
-  configPresenter: IConfigPresenter
-  mcpPresenter: IMCPPresenter
-  skillPresenter: ISkillPresenter
-  toolPresenter: IToolPresenter
-  commandPermissionService: CommandPermissionService
-  permissionRuntime: AgentPermissionRuntimePort
-  messageManager?: MessageManager
-}
-
-export class AgentPresenter implements IAgentPresenter {
-  private sessionPresenter: ISessionPresenter
-  private sessionManager: SessionManager
-  private sqlitePresenter: ISQLitePresenter
-  private llmProviderPresenter: ILlmProviderPresenter
-  private configPresenter: IConfigPresenter
-  private messageManager: MessageManager
-  private commandPermissionService: CommandPermissionService
-  private generatingMessages: Map<string, GeneratingMessageState> = new Map()
-  private contentBufferHandler: ContentBufferHandler
-  private toolCallHandler: ToolCallHandler
-  private llmEventHandler: LLMEventHandler
-  private streamGenerationHandler: StreamGenerationHandler
-  private permissionHandler: PermissionHandler
-  private utilityHandler: UtilityHandler
-  private streamUpdateScheduler: StreamUpdateScheduler
-  private readonly sessionRuntime: AgentSessionRuntimePort
-  private readonly mcpRuntime: AgentMcpRuntimePort
-  private readonly promptRuntime: AgentPromptRuntimePort
-  private readonly permissionRuntime: AgentPermissionRuntimePort
-
-  constructor(options: AgentPresenterDependencies) {
-    this.sessionPresenter = options.sessionPresenter
-    this.sessionManager = options.sessionManager
-    this.sqlitePresenter = options.sqlitePresenter
-    this.llmProviderPresenter = options.llmProviderPresenter
-    this.configPresenter = options.configPresenter
-    this.messageManager = options.messageManager ?? new MessageManager(options.sqlitePresenter)
-    this.commandPermissionService = options.commandPermissionService
-    this.permissionRuntime = options.permissionRuntime
-    this.sessionRuntime = {
-      getSession: (agentId) => this.sessionManager.getSession(agentId),
-      getSessionSync: (agentId) => this.sessionManager.getSessionSync(agentId),
-      resolveWorkspaceContext: (conversationId, modelId) =>
-        this.sessionManager.resolveWorkspaceContext(conversationId, modelId),
-      startLoop: (agentId, messageId, runtimeOptions) =>
-        this.sessionManager.startLoop(agentId, messageId, runtimeOptions),
-      setStatus: (agentId, status) => this.sessionManager.setStatus(agentId, status),
-      getStatus: (agentId) => this.sessionManager.getStatus(agentId),
-      updateRuntime: (agentId, updates) => this.sessionManager.updateRuntime(agentId, updates),
-      incrementToolCallCount: (agentId) => this.sessionManager.incrementToolCallCount(agentId),
-      clearPendingPermission: (agentId) => this.sessionManager.clearPendingPermission(agentId),
-      clearPendingQuestion: (agentId) => this.sessionManager.clearPendingQuestion(agentId),
-      addPendingPermission: (agentId, permission) =>
-        this.sessionManager.addPendingPermission(agentId, permission),
-      removePendingPermission: (agentId, messageId, toolCallId) =>
-        this.sessionManager.removePendingPermission(agentId, messageId, toolCallId),
-      getPendingPermissions: (agentId) => this.sessionManager.getPendingPermissions(agentId),
-      hasPendingPermissions: (agentId, messageId) =>
-        this.sessionManager.hasPendingPermissions(agentId, messageId),
-      acquirePermissionResumeLock: (agentId, messageId) =>
-        this.sessionManager.acquirePermissionResumeLock(agentId, messageId),
-      releasePermissionResumeLock: (agentId) =>
-        this.sessionManager.releasePermissionResumeLock(agentId),
-      getPermissionResumeLock: (agentId) => this.sessionManager.getPermissionResumeLock(agentId)
-    }
-    this.mcpRuntime = {
-      callTool: (request) => options.mcpPresenter.callTool(request),
-      grantPermission: (serverName, permissionType, remember, conversationId) =>
-        options.mcpPresenter.grantPermission(serverName, permissionType, remember, conversationId),
-      isServerRunning: (serverName) => options.mcpPresenter.isServerRunning(serverName)
-    }
-    this.promptRuntime = {
-      getInputChatMode: async () =>
-        options.configPresenter.getSetting<string>('input_chatMode') ?? undefined,
-      getSkillsEnabled: () => options.configPresenter.getSkillsEnabled(),
-      getActiveSkills: (conversationId) => options.skillPresenter.getActiveSkills(conversationId),
-      loadSkillContent: (name) => options.skillPresenter.loadSkillContent(name),
-      getMetadataPrompt: () => options.skillPresenter.getMetadataPrompt(),
-      getActiveSkillsAllowedTools: (conversationId) =>
-        options.skillPresenter.getActiveSkillsAllowedTools(conversationId)
-    }
-
-    this.streamUpdateScheduler = new StreamUpdateScheduler({
-      messageManager: this.messageManager
-    })
-
-    const handlerContext: ThreadHandlerContext = {
-      sqlitePresenter: this.sqlitePresenter,
-      messageManager: this.messageManager,
-      llmProviderPresenter: this.llmProviderPresenter,
-      configPresenter: this.configPresenter,
-      sessionRuntime: this.sessionRuntime,
-      toolPresenter: options.toolPresenter,
-      mcpRuntime: this.mcpRuntime,
-      promptRuntime: this.promptRuntime,
-      permissionRuntime: this.permissionRuntime
-    }
-
-    this.contentBufferHandler = new ContentBufferHandler({
-      generatingMessages: this.generatingMessages,
-      streamUpdateScheduler: this.streamUpdateScheduler
-    })
-
-    this.toolCallHandler = new ToolCallHandler({
-      sqlitePresenter: this.sqlitePresenter,
-      commandPermissionHandler: this.commandPermissionService,
-      streamUpdateScheduler: this.streamUpdateScheduler
-    })
-
-    this.llmEventHandler = new LLMEventHandler({
-      generatingMessages: this.generatingMessages,
-      messageManager: this.messageManager,
-      contentBufferHandler: this.contentBufferHandler,
-      toolCallHandler: this.toolCallHandler,
-      streamUpdateScheduler: this.streamUpdateScheduler,
-      sessionRuntime: this.sessionRuntime,
-      onConversationUpdated: (state) => this.handleConversationUpdates(state)
-    })
-
-    this.streamGenerationHandler = new StreamGenerationHandler(handlerContext, {
-      generatingMessages: this.generatingMessages,
-      llmEventHandler: this.llmEventHandler
-    })
-
-    this.permissionHandler = new PermissionHandler(handlerContext, {
-      generatingMessages: this.generatingMessages,
-      streamGenerationHandler: this.streamGenerationHandler,
-      llmEventHandler: this.llmEventHandler,
-      commandPermissionHandler: this.commandPermissionService
-    })
-
-    this.utilityHandler = new UtilityHandler(handlerContext, {
-      getActiveConversation: (webContentsId) =>
-        this.sessionPresenter.getActiveConversation(webContentsId),
-      getActiveConversationId: (webContentsId) =>
-        this.sessionPresenter.getActiveConversationId(webContentsId),
-      createConversation: (title, settings, webContentsId) =>
-        this.sessionPresenter.createConversation(title, settings, webContentsId)
-    })
-
-    // Legacy IPC surface: dynamic proxy for ISessionPresenter methods.
-    this.bindSessionPresenterMethods()
-  }
-
-  async sendMessage(
-    agentId: string,
-    content: string,
-    webContentsId?: number,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage | null> {
-    await this.logResolvedIfEnabled(agentId)
-
-    const conversation = await this.sessionPresenter.getConversation(agentId)
-    const userMessage = await this.messageManager.sendMessage(
-      agentId,
-      content,
-      'user',
-      '',
-      false,
-      this.buildMessageMetadata(conversation)
-    )
-    try {
-      await this.resolvePendingQuestionIfNeeded(agentId, userMessage.id, content)
-    } catch (error) {
-      console.warn('[AgentPresenter] Failed to auto-resolve pending question:', error)
-    }
-
-    const assistantMessage = await this.streamGenerationHandler.generateAIResponse(
-      agentId,
-      userMessage.id
-    )
-
-    this.trackGeneratingMessage(assistantMessage, agentId, webContentsId)
-    await this.updateConversationAfterUserMessage(agentId)
-    // Normal flow: skip lock acquisition (lock is only for permission resume)
-    await this.sessionManager.startLoop(agentId, assistantMessage.id, { skipLockAcquisition: true })
-
-    void this.streamGenerationHandler
-      .startStreamCompletion(agentId, assistantMessage.id, selectedVariantsMap)
-      .catch((error) => {
-        console.error('[AgentPresenter] Failed to start stream completion:', error)
-        const errorMessage = error instanceof Error ? error.message : String(error)
-        eventBus.sendToRenderer(STREAM_EVENTS.ERROR, SendTarget.ALL_WINDOWS, {
-          eventId: assistantMessage.id,
-          error: errorMessage
-        })
-      })
-
-    return assistantMessage
-  }
-
-  async continueLoop(
-    agentId: string,
-    messageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage | null> {
-    await this.logResolvedIfEnabled(agentId)
-
-    const assistantMessage = await this.createContinueMessage(agentId)
-    if (!assistantMessage) {
-      return null
-    }
-
-    this.trackGeneratingMessage(assistantMessage, agentId)
-    await this.updateConversationAfterUserMessage(agentId)
-    // Normal flow: skip lock acquisition (lock is only for permission resume)
-    await this.sessionManager.startLoop(agentId, assistantMessage.id, { skipLockAcquisition: true })
-
-    void this.streamGenerationHandler
-      .continueStreamCompletion(agentId, messageId, selectedVariantsMap)
-      .catch((error) => {
-        console.error('[AgentPresenter] Failed to continue stream completion:', error)
-        const errorMessage = error instanceof Error ? error.message : String(error)
-        eventBus.sendToRenderer(STREAM_EVENTS.ERROR, SendTarget.ALL_WINDOWS, {
-          eventId: assistantMessage.id,
-          error: errorMessage
-        })
-      })
-
-    return assistantMessage
-  }
-
-  async cancelLoop(messageId: string): Promise<void> {
-    try {
-      const message = await this.sessionPresenter.getMessage(messageId)
-      if (message) {
-        this.sessionManager.updateRuntime(message.conversationId, { userStopRequested: true })
-        this.sessionManager.setStatus(message.conversationId, 'paused')
-      }
-    } catch (error) {
-      console.warn('[AgentPresenter] Failed to update session state for cancel:', error)
-    }
-    await this.stopMessageGeneration(messageId)
-  }
-
-  async cleanupConversation(conversationId: string): Promise<void> {
-    for (const [messageId, state] of this.generatingMessages) {
-      if (state.conversationId === conversationId) {
-        await this.stopMessageGeneration(messageId)
-        break
-      }
-    }
-
-    this.sessionManager.removeSession(conversationId)
-
-    try {
-      await this.llmProviderPresenter.clearAcpSession(conversationId)
-    } catch (error) {
-      console.warn('[AgentPresenter] Failed to clear ACP session:', error)
-    }
-  }
-
-  async retryMessage(
-    messageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage> {
-    const message = await this.messageManager.getMessage(messageId)
-    if (message.role !== 'assistant') {
-      throw new Error('只能重试助手消息')
-    }
-
-    const userMessage = await this.messageManager.getMessage(message.parentId || '')
-    if (!userMessage) {
-      throw new Error('找不到对应的用户消息')
-    }
-
-    const conversation = await this.sessionPresenter.getConversation(message.conversationId)
-    const assistantMessage = (await this.messageManager.retryMessage(
-      messageId,
-      this.buildMessageMetadata(conversation)
-    )) as AssistantMessage
-
-    this.trackGeneratingMessage(assistantMessage, message.conversationId)
-    // Normal flow: skip lock acquisition (lock is only for permission resume)
-    await this.sessionManager.startLoop(message.conversationId, assistantMessage.id, {
-      skipLockAcquisition: true
-    })
-
-    void this.streamGenerationHandler
-      .startStreamCompletion(message.conversationId, messageId, selectedVariantsMap)
-      .catch((error) => {
-        console.error('[AgentPresenter] Failed to retry stream completion:', error)
-        const errorMessage = error instanceof Error ? error.message : String(error)
-        eventBus.sendToRenderer(STREAM_EVENTS.ERROR, SendTarget.ALL_WINDOWS, {
-          eventId: assistantMessage.id,
-          error: errorMessage
-        })
-      })
-
-    return assistantMessage
-  }
-
-  async regenerateFromUserMessage(
-    agentId: string,
-    userMessageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage> {
-    await this.logResolvedIfEnabled(agentId)
-    return this.streamGenerationHandler.regenerateFromUserMessage(
-      agentId,
-      userMessageId,
-      selectedVariantsMap
-    )
-  }
-
-  async translateText(text: string, webContentsId: number): Promise<string> {
-    return this.utilityHandler.translateText(text, webContentsId)
-  }
-
-  async askAI(text: string, webContentsId: number): Promise<string> {
-    return this.utilityHandler.askAI(text, webContentsId)
-  }
-
-  async handlePermissionResponse(
-    messageId: string,
-    toolCallId: string,
-    granted: boolean,
-    permissionType: 'read' | 'write' | 'all' | 'command',
-    remember?: boolean
-  ): Promise<void> {
-    await this.permissionHandler.handlePermissionResponse(
-      messageId,
-      toolCallId,
-      granted,
-      permissionType,
-      remember
-    )
-  }
-
-  async resolveQuestion(
-    messageId: string,
-    toolCallId: string,
-    answerText: string,
-    answerMessageId?: string
-  ): Promise<void> {
-    await this.handleQuestionResolution(messageId, toolCallId, {
-      resolution: 'replied',
-      answerText,
-      answerMessageId
-    })
-  }
-
-  async rejectQuestion(messageId: string, toolCallId: string): Promise<void> {
-    await this.handleQuestionResolution(messageId, toolCallId, {
-      resolution: 'rejected'
-    })
-  }
-
-  private async handleQuestionResolution(
-    messageId: string,
-    toolCallId: string,
-    payload: {
-      resolution: 'replied' | 'rejected'
-      answerText?: string
-      answerMessageId?: string
-    }
-  ): Promise<void> {
-    if (!messageId || !toolCallId) {
-      return
-    }
-
-    const message = await this.messageManager.getMessage(messageId)
-    if (!message || message.role !== 'assistant') {
-      throw new Error(`Message not found or not assistant (${messageId})`)
-    }
-
-    const content = message.content as AssistantMessageBlock[]
-    const questionBlock = content.find(
-      (block) =>
-        block.type === 'action' &&
-        block.action_type === 'question_request' &&
-        block.tool_call?.id === toolCallId
-    )
-
-    if (!questionBlock) {
-      throw new Error(
-        `Question block not found (messageId: ${messageId}, toolCallId: ${toolCallId})`
-      )
-    }
-
-    if (questionBlock.status !== 'pending') {
-      return
-    }
-
-    const isReplied = payload.resolution === 'replied'
-    questionBlock.status = isReplied ? 'success' : 'denied'
-    questionBlock.extra = {
-      ...questionBlock.extra,
-      needsUserAction: false,
-      questionResolution: payload.resolution,
-      ...(isReplied && payload.answerText ? { answerText: payload.answerText } : {}),
-      ...(isReplied && payload.answerMessageId ? { answerMessageId: payload.answerMessageId } : {})
-    }
-
-    const generatingState = this.generatingMessages.get(messageId)
-    if (generatingState) {
-      const questionIndex = generatingState.message.content.findIndex(
-        (block) =>
-          block.type === 'action' &&
-          block.action_type === 'question_request' &&
-          block.tool_call?.id === toolCallId
-      )
-      if (questionIndex !== -1) {
-        const stateBlock = generatingState.message.content[questionIndex]
-        generatingState.message.content[questionIndex] = {
-          ...stateBlock,
-          ...questionBlock,
-          extra: questionBlock.extra ? { ...questionBlock.extra } : undefined,
-          tool_call: questionBlock.tool_call ? { ...questionBlock.tool_call } : undefined
-        }
-      }
-    }
-
-    await this.messageManager.editMessage(messageId, JSON.stringify(content))
-    if (message.status === 'pending') {
-      await this.messageManager.updateMessageStatus(messageId, 'sent')
-    }
-    this.sessionRuntime.clearPendingQuestion(message.conversationId)
-    this.sessionRuntime.setStatus(message.conversationId, 'idle')
-  }
-
-  private async resolvePendingQuestionIfNeeded(
-    conversationId: string,
-    userMessageId: string,
-    rawContent: string
-  ): Promise<void> {
-    const session = await this.sessionManager.getSession(conversationId)
-    const pendingQuestion = session.runtime?.pendingQuestion
-    if (!pendingQuestion?.messageId || !pendingQuestion.toolCallId) {
-      return
-    }
-
-    const answerText = this.extractUserMessageText(rawContent)
-    if (!answerText.trim()) {
-      return
-    }
-
-    await this.handleQuestionResolution(pendingQuestion.messageId, pendingQuestion.toolCallId, {
-      resolution: 'replied',
-      answerText,
-      answerMessageId: userMessageId
-    })
-  }
-
-  private extractUserMessageText(rawContent: string): string {
-    if (!rawContent) return ''
-    try {
-      const parsed = JSON.parse(rawContent) as UserMessageContent
-      if (typeof parsed.text === 'string') {
-        return parsed.text
-      }
-      if (Array.isArray(parsed.content)) {
-        return parsed.content.map((block) => block.content || '').join('')
-      }
-    } catch (error) {
-      console.warn('[AgentPresenter] Failed to parse user message content:', error)
-    }
-    return rawContent
-  }
-
-  private buildMessageMetadata(conversation: CONVERSATION): MESSAGE_METADATA {
-    const { providerId, modelId } = conversation.settings
-    return {
-      contextUsage: 0,
-      totalTokens: 0,
-      generationTime: 0,
-      firstTokenTime: 0,
-      tokensPerSecond: 0,
-      inputTokens: 0,
-      outputTokens: 0,
-      model: modelId,
-      provider: providerId
-    }
-  }
-
-  private trackGeneratingMessage(
-    message: AssistantMessage,
-    conversationId: string,
-    webContentsId?: number
-  ): void {
-    this.generatingMessages.set(message.id, {
-      message,
-      conversationId,
-      startTime: Date.now(),
-      firstTokenTime: null,
-      promptTokens: 0,
-      reasoningStartTime: null,
-      reasoningEndTime: null,
-      lastReasoningTime: null,
-      webContentsId
-    })
-  }
-
-  private async updateConversationAfterUserMessage(conversationId: string): Promise<void> {
-    const { list: messages } = await this.messageManager.getMessageThread(conversationId, 1, 2)
-    if (messages.length === 1) {
-      await this.sqlitePresenter.updateConversation(conversationId, {
-        is_new: 0,
-        updatedAt: Date.now()
-      })
-      return
-    }
-
-    await this.sqlitePresenter.updateConversation(conversationId, {
-      updatedAt: Date.now()
-    })
-  }
-
-  private async createContinueMessage(agentId: string): Promise<AssistantMessage> {
-    const continuePayload = JSON.stringify({
-      text: 'continue',
-      files: [],
-      links: [],
-      search: false,
-      think: false,
-      continue: true
-    })
-
-    const conversation = await this.sessionPresenter.getConversation(agentId)
-    const userMessage = await this.messageManager.sendMessage(
-      agentId,
-      continuePayload,
-      'user',
-      '',
-      false,
-      this.buildMessageMetadata(conversation)
-    )
-
-    return this.streamGenerationHandler.generateAIResponse(agentId, userMessage.id)
-  }
-
-  private async handleConversationUpdates(state: GeneratingMessageState): Promise<void> {
-    const conversation = await this.sessionPresenter.getConversation(state.conversationId)
-
-    if (conversation.is_new === 1) {
-      try {
-        const title = await this.sessionPresenter.generateTitle(state.conversationId)
-        await this.sessionPresenter.renameConversation(state.conversationId, title)
-      } catch (error) {
-        console.error('[AgentPresenter] Failed to summarize title', {
-          conversationId: state.conversationId,
-          err: error
-        })
-      }
-    }
-
-    await this.sqlitePresenter.updateConversation(state.conversationId, {
-      updatedAt: Date.now()
-    })
-
-    const sessionPresenter = this.sessionPresenter as unknown as {
-      broadcastThreadListUpdate?: () => Promise<void>
-    }
-    if (sessionPresenter.broadcastThreadListUpdate) {
-      await sessionPresenter.broadcastThreadListUpdate()
-    }
-  }
-
-  private async stopMessageGeneration(messageId: string): Promise<void> {
-    const state = this.generatingMessages.get(messageId)
-    if (!state) {
-      return
-    }
-
-    this.sessionManager.updateRuntime(state.conversationId, { userStopRequested: true })
-    this.sessionManager.setStatus(state.conversationId, 'paused')
-    this.sessionManager.clearPendingPermission(state.conversationId)
-    this.sessionManager.clearPendingQuestion(state.conversationId)
-    state.isCancelled = true
-
-    if (state.adaptiveBuffer) {
-      await this.contentBufferHandler.flushAdaptiveBuffer(messageId)
-    }
-
-    this.contentBufferHandler.cleanupContentBuffer(state)
-
-    state.message.content.forEach((block) => {
-      if (
-        block.status === 'loading' ||
-        block.status === 'reading' ||
-        block.status === 'optimizing'
-      ) {
-        block.status = 'success'
-      }
-    })
-
-    state.message.content.push({
-      type: 'error',
-      content: 'common.error.userCanceledGeneration',
-      status: 'cancel',
-      timestamp: Date.now()
-    })
-
-    await this.messageManager.updateMessageStatus(messageId, 'error')
-    await this.messageManager.editMessage(messageId, JSON.stringify(state.message.content))
-    await this.llmProviderPresenter.stopStream(messageId)
-
-    this.generatingMessages.delete(messageId)
-  }
-
-  private shouldLogResolved(): boolean {
-    return import.meta.env.VITE_AGENT_PRESENTER_DEBUG === '1'
-  }
-
-  private async logResolvedIfEnabled(agentId: string): Promise<void> {
-    if (!this.shouldLogResolved()) {
-      return
-    }
-    try {
-      const resolved = await this.resolveSession(agentId)
-      console.log('[AgentPresenter] SessionContext.resolved', { agentId, resolved })
-    } catch (error) {
-      console.warn('[AgentPresenter] Failed to resolve session context', { agentId, error })
-    }
-  }
-
-  private async resolveSession(agentId: string): Promise<SessionContextResolved> {
-    const session = await this.sessionManager.getSession(agentId)
-    return session.resolved
-  }
-
-  private bindSessionPresenterMethods(): void {
-    const sessionPresenter = this.sessionPresenter as unknown as Record<string, unknown>
-    const sessionProto = Object.getPrototypeOf(sessionPresenter) as Record<string, unknown>
-    for (const key of Object.getOwnPropertyNames(sessionProto)) {
-      if (key === 'constructor') continue
-      if (key in this) continue
-      const value = sessionPresenter[key]
-      if (typeof value === 'function') {
-        ;(this as Record<string, unknown>)[key] = value.bind(this.sessionPresenter)
-      }
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/agentLoopHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/agentLoopHandler.ts
deleted file mode 100644
index 42f1e0440..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/agentLoopHandler.ts
+++ /dev/null
@@ -1,669 +0,0 @@
-import {
-  ChatMessage,
-  IConfigPresenter,
-  IToolPresenter,
-  LLMAgentEvent,
-  MCPToolCall
-} from '@shared/presenter'
-import { BaseLLMProvider } from '@/presenter/llmProviderPresenter/baseProvider'
-import { StreamState } from './loopState'
-import { RateLimitManager } from '@/presenter/llmProviderPresenter/managers/rateLimitManager'
-import { ToolCallProcessor } from './toolCallProcessor'
-import { getAgentFilteredTools } from '../../mcpPresenter/agentMcpFilter'
-import type { AgentSessionRuntimePort } from '../session/sessionRuntimePort'
-
-interface AgentLoopHandlerOptions {
-  configPresenter: IConfigPresenter
-  getProviderInstance: (providerId: string) => BaseLLMProvider
-  activeStreams: Map<string, StreamState>
-  canStartNewStream: () => boolean
-  rateLimitManager: RateLimitManager
-  sessionRuntime: Pick<AgentSessionRuntimePort, 'getSession' | 'resolveWorkspaceContext'>
-  getToolPresenter: () => IToolPresenter
-}
-
-export class AgentLoopHandler {
-  private readonly toolCallProcessor: ToolCallProcessor
-  private currentSupportsVision = false
-
-  constructor(private readonly options: AgentLoopHandlerOptions) {
-    this.toolCallProcessor = new ToolCallProcessor({
-      getAllToolDefinitions: async (context) => {
-        // Get modelId from session
-        let modelId: string | undefined
-        if (context.conversationId) {
-          try {
-            const session = await this.options.sessionRuntime.getSession(context.conversationId)
-            modelId = session?.resolved.modelId
-          } catch {
-            // Ignore errors, modelId will be undefined
-          }
-        }
-
-        const { chatMode, agentWorkspacePath } = await this.resolveWorkspaceContext(
-          context.conversationId,
-          modelId
-        )
-
-        const toolDefs = await this.getToolPresenter().getAllToolDefinitions({
-          enabledMcpTools: context.enabledMcpTools,
-          chatMode,
-          supportsVision: this.currentSupportsVision,
-          agentWorkspacePath,
-          conversationId: context.conversationId
-        })
-
-        return await this.filterToolsForChatMode(toolDefs, chatMode, modelId)
-      },
-      callTool: async (request: MCPToolCall) => {
-        return await this.getToolPresenter().callTool(request)
-      },
-      preCheckToolPermission: async (request: MCPToolCall) => {
-        const toolPresenter = this.getToolPresenter()
-        if (!toolPresenter.preCheckToolPermission) {
-          return null
-        }
-        return await toolPresenter.preCheckToolPermission(request)
-      }
-    })
-  }
-
-  private getToolPresenter(): IToolPresenter {
-    const toolPresenter = this.options.getToolPresenter()
-    if (!toolPresenter) {
-      throw new Error('ToolPresenter is unavailable')
-    }
-    return toolPresenter
-  }
-
-  /**
-   * Resolve workspace context (chatMode and agentWorkspacePath) for tool definitions
-   * @param conversationId Optional conversation ID
-   * @param modelId Optional model ID (required for acp agent mode)
-   * @returns Resolved workspace context
-   */
-  private async resolveWorkspaceContext(
-    conversationId?: string,
-    modelId?: string
-  ): Promise<{ chatMode: 'agent' | 'acp agent'; agentWorkspacePath: string | null }> {
-    return this.options.sessionRuntime.resolveWorkspaceContext(conversationId, modelId)
-  }
-
-  private requiresReasoningField(modelId: string): boolean {
-    const lower = modelId.toLowerCase()
-    return (
-      lower.includes('deepseek-reasoner') ||
-      lower.includes('kimi-k2-thinking') ||
-      lower.includes('glm-4.7')
-    )
-  }
-
-  private isAgentToolDefinition(tool: { server?: { name: string } }): boolean {
-    const name = tool.server?.name
-    return Boolean(name && (name === 'yo-browser' || name.startsWith('agent-')))
-  }
-
-  private async filterToolsForChatMode(
-    tools: Awaited<ReturnType<IToolPresenter['getAllToolDefinitions']>>,
-    chatMode: 'agent' | 'acp agent',
-    agentId?: string
-  ): Promise<Awaited<ReturnType<IToolPresenter['getAllToolDefinitions']>>> {
-    if (chatMode !== 'acp agent') return tools
-    if (!agentId) return []
-
-    const agentTools = tools.filter((tool) => this.isAgentToolDefinition(tool))
-    const mcpTools = tools.filter((tool) => !this.isAgentToolDefinition(tool))
-    const filteredMcp = await getAgentFilteredTools(
-      agentId,
-      undefined,
-      mcpTools,
-      this.options.configPresenter
-    )
-    return [...filteredMcp, ...agentTools]
-  }
-
-  async *startStreamCompletion(
-    providerId: string,
-    initialMessages: ChatMessage[],
-    modelId: string,
-    eventId: string,
-    temperature: number = 0.6,
-    maxTokens: number = 4096,
-    enabledMcpTools?: string[],
-    thinkingBudget?: number,
-    reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high',
-    verbosity?: 'low' | 'medium' | 'high',
-    conversationId?: string
-  ): AsyncGenerator<LLMAgentEvent, void, unknown> {
-    console.log(`[Agent Loop] Starting agent loop for event: ${eventId} with model: ${modelId}`)
-    if (!this.options.canStartNewStream()) {
-      // Instead of throwing, yield an error event
-      yield { type: 'error', data: { eventId, error: 'Maximum concurrent stream limit reached' } }
-      return
-      // throw new Error('Maximum concurrent stream limit reached')
-    }
-
-    const provider = this.options.getProviderInstance(providerId)
-    const abortController = new AbortController()
-    const modelConfig = this.options.configPresenter.getModelConfig(modelId, providerId)
-
-    if (conversationId) {
-      modelConfig.conversationId = conversationId
-    }
-
-    if (thinkingBudget !== undefined) {
-      modelConfig.thinkingBudget = thinkingBudget
-    }
-    if (reasoningEffort !== undefined) {
-      modelConfig.reasoningEffort = reasoningEffort
-    }
-    if (verbosity !== undefined) {
-      modelConfig.verbosity = verbosity
-    }
-    this.currentSupportsVision = Boolean(modelConfig?.vision)
-
-    this.options.activeStreams.set(eventId, {
-      isGenerating: true,
-      providerId,
-      modelId,
-      abortController,
-      provider
-    })
-
-    // Agent Loop Variables
-    const conversationMessages: ChatMessage[] = [...initialMessages]
-    let needContinueConversation = true
-    let toolCallCount = 0
-    const MAX_TOOL_CALLS = BaseLLMProvider.getMaxToolCalls()
-    const totalUsage: {
-      prompt_tokens: number
-      completion_tokens: number
-      total_tokens: number
-      context_length: number
-    } = {
-      prompt_tokens: 0,
-      completion_tokens: 0,
-      total_tokens: 0,
-      context_length: modelConfig?.contextLength || 0
-    }
-
-    try {
-      // --- Agent Loop ---
-      while (needContinueConversation) {
-        if (abortController.signal.aborted) {
-          console.log('Agent loop aborted for event:', eventId)
-          break
-        }
-
-        if (toolCallCount >= MAX_TOOL_CALLS) {
-          console.warn('Maximum tool call limit reached for event:', eventId)
-          yield {
-            type: 'response',
-            data: {
-              eventId,
-              maximum_tool_calls_reached: true
-            }
-          }
-
-          break
-        }
-
-        needContinueConversation = false
-
-        // Prepare for LLM call
-        let currentContent = ''
-        let currentReasoning = ''
-        const currentToolCalls: Array<{
-          id: string
-          name: string
-          arguments: string
-        }> = []
-        const currentToolChunks: Record<
-          string,
-          {
-            name: string
-            arguments_chunk: string
-            server_name?: string
-            server_icons?: string
-            server_description?: string
-          }
-        > = {}
-
-        try {
-          console.log(`[Agent Loop] Iteration ${toolCallCount + 1} for event: ${eventId}`)
-          // Resolve workspace context
-          const { chatMode, agentWorkspacePath } = await this.resolveWorkspaceContext(
-            conversationId,
-            modelId
-          )
-
-          // Get all tool definitions using ToolPresenter
-          const toolDefs = await this.getToolPresenter().getAllToolDefinitions({
-            enabledMcpTools,
-            chatMode,
-            supportsVision: this.currentSupportsVision,
-            agentWorkspacePath,
-            conversationId
-          })
-          const filteredToolDefs = await this.filterToolsForChatMode(toolDefs, chatMode, modelId)
-
-          const canExecute = this.options.rateLimitManager.canExecuteImmediately(providerId)
-          if (!canExecute) {
-            const config = this.options.rateLimitManager.getProviderRateLimitConfig(providerId)
-            const currentQps = this.options.rateLimitManager.getCurrentQps(providerId)
-            const queueLength = this.options.rateLimitManager.getQueueLength(providerId)
-
-            yield {
-              type: 'response',
-              data: {
-                eventId,
-                rate_limit: {
-                  providerId,
-                  qpsLimit: config.qpsLimit,
-                  currentQps,
-                  queueLength,
-                  estimatedWaitTime: Math.max(0, 1000 - (Date.now() % 1000))
-                }
-              }
-            }
-
-            await this.options.rateLimitManager.executeWithRateLimit(providerId)
-          } else {
-            await this.options.rateLimitManager.executeWithRateLimit(providerId)
-          }
-
-          // Call the provider's core stream method, expecting LLMCoreStreamEvent
-          const stream = provider.coreStream(
-            conversationMessages,
-            modelId,
-            modelConfig,
-            temperature,
-            maxTokens,
-            filteredToolDefs
-          )
-
-          // Process the standardized stream events
-          for await (const chunk of stream) {
-            if (abortController.signal.aborted) {
-              break
-            }
-            // console.log('presenter chunk', JSON.stringify(chunk), currentContent)
-
-            // --- Event Handling (using LLMCoreStreamEvent structure) ---
-            switch (chunk.type) {
-              case 'text':
-                if (chunk.content) {
-                  currentContent += chunk.content
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      content: chunk.content
-                    }
-                  }
-                }
-                break
-              case 'reasoning':
-                if (chunk.reasoning_content) {
-                  currentReasoning += chunk.reasoning_content
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      reasoning_content: chunk.reasoning_content
-                    }
-                  }
-                }
-                break
-              case 'tool_call_start':
-                if (chunk.tool_call_id && chunk.tool_call_name) {
-                  const toolDef = filteredToolDefs.find(
-                    (tool) => tool.function.name === chunk.tool_call_name
-                  )
-                  const serverName = toolDef?.server?.name
-                  const serverIcons = toolDef?.server?.icons
-                  const serverDescription = toolDef?.server?.description
-
-                  currentToolChunks[chunk.tool_call_id] = {
-                    name: chunk.tool_call_name,
-                    arguments_chunk: '',
-                    server_name: serverName,
-                    server_icons: serverIcons,
-                    server_description: serverDescription
-                  }
-                  // Immediately send the start event to indicate the tool call has begun
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      tool_call: 'start',
-                      tool_call_id: chunk.tool_call_id,
-                      tool_call_name: chunk.tool_call_name,
-                      tool_call_params: '', // Initial parameters are empty
-                      tool_call_server_name: serverName,
-                      tool_call_server_icons: serverIcons,
-                      tool_call_server_description: serverDescription
-                    }
-                  }
-                }
-                break
-              case 'tool_call_chunk':
-                if (
-                  chunk.tool_call_id &&
-                  currentToolChunks[chunk.tool_call_id] &&
-                  chunk.tool_call_arguments_chunk
-                ) {
-                  currentToolChunks[chunk.tool_call_id].arguments_chunk +=
-                    chunk.tool_call_arguments_chunk
-
-                  // Send update event to update parameter content in real-time
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      tool_call: 'update',
-                      tool_call_id: chunk.tool_call_id,
-                      tool_call_name: currentToolChunks[chunk.tool_call_id].name,
-                      tool_call_params: currentToolChunks[chunk.tool_call_id].arguments_chunk,
-                      tool_call_server_name: currentToolChunks[chunk.tool_call_id].server_name,
-                      tool_call_server_icons: currentToolChunks[chunk.tool_call_id].server_icons,
-                      tool_call_server_description:
-                        currentToolChunks[chunk.tool_call_id].server_description
-                    }
-                  }
-                }
-                break
-              case 'tool_call_end':
-                if (chunk.tool_call_id && currentToolChunks[chunk.tool_call_id]) {
-                  const completeArgs =
-                    chunk.tool_call_arguments_complete ??
-                    currentToolChunks[chunk.tool_call_id].arguments_chunk
-                  const toolCallName = currentToolChunks[chunk.tool_call_id].name
-                  const serverName = currentToolChunks[chunk.tool_call_id].server_name
-                  const serverIcons = currentToolChunks[chunk.tool_call_id].server_icons
-                  const serverDescription = currentToolChunks[chunk.tool_call_id].server_description
-
-                  // For ACP provider, tool call execution is completed on agent side
-                  // The tool_call_arguments_complete contains the execution result
-                  // So we should immediately send 'end' event to mark it as successful
-                  if (providerId === 'acp') {
-                    // For ACP, tool_call_arguments_complete contains the execution result
-                    // Use it directly as the response
-                    yield {
-                      type: 'response',
-                      data: {
-                        eventId,
-                        tool_call: 'end',
-                        tool_call_id: chunk.tool_call_id,
-                        tool_call_name: toolCallName,
-                        tool_call_params: completeArgs,
-                        tool_call_response: completeArgs,
-                        tool_call_server_name: serverName,
-                        tool_call_server_icons: serverIcons,
-                        tool_call_server_description: serverDescription
-                      }
-                    }
-
-                    // Don't add to currentToolCalls for ACP - execution already completed
-                    delete currentToolChunks[chunk.tool_call_id]
-                  } else {
-                    // For non-ACP providers, tool call needs to be executed by ToolCallProcessor
-                    currentToolCalls.push({
-                      id: chunk.tool_call_id,
-                      name: toolCallName,
-                      arguments: completeArgs
-                    })
-
-                    // Send final update event to ensure parameter completeness
-                    yield {
-                      type: 'response',
-                      data: {
-                        eventId,
-                        tool_call: 'update',
-                        tool_call_id: chunk.tool_call_id,
-                        tool_call_name: toolCallName,
-                        tool_call_params: completeArgs,
-                        tool_call_server_name: serverName,
-                        tool_call_server_icons: serverIcons,
-                        tool_call_server_description: serverDescription
-                      }
-                    }
-
-                    delete currentToolChunks[chunk.tool_call_id]
-                  }
-                }
-                break
-              case 'permission': {
-                const permission = chunk.permission
-                const permissionType = permission.permissionType ?? 'read'
-                const description = permission.description ?? ''
-                const toolName = permission.tool_call_name ?? permission.tool_call_id
-                const serverName =
-                  permission.server_name ?? permission.agentName ?? permission.providerName ?? ''
-
-                yield {
-                  type: 'response',
-                  data: {
-                    eventId,
-                    tool_call: 'permission-required',
-                    tool_call_id: permission.tool_call_id,
-                    tool_call_name: toolName,
-                    tool_call_params: permission.tool_call_params,
-                    tool_call_server_name: serverName,
-                    tool_call_server_icons: permission.server_icons,
-                    tool_call_server_description:
-                      permission.server_description ?? permission.agentName,
-                    tool_call_response: description,
-                    permission_request: {
-                      toolName,
-                      serverName,
-                      permissionType,
-                      description,
-                      providerId: permission.providerId,
-                      requestId: permission.requestId,
-                      sessionId: permission.sessionId,
-                      agentId: permission.agentId,
-                      agentName: permission.agentName,
-                      conversationId: permission.conversationId,
-                      options: permission.options,
-                      rememberable: permission.metadata?.rememberable === false ? false : true
-                    }
-                  }
-                }
-                break
-              }
-              case 'usage':
-                if (chunk.usage) {
-                  // console.log('usage', chunk.usage, totalUsage)
-                  totalUsage.prompt_tokens += chunk.usage.prompt_tokens
-                  totalUsage.completion_tokens += chunk.usage.completion_tokens
-                  totalUsage.total_tokens += chunk.usage.total_tokens
-                  totalUsage.context_length = modelConfig.contextLength
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      totalUsage: { ...totalUsage } // Yield accumulated usage
-                    }
-                  }
-                }
-                break
-              case 'image_data':
-                if (chunk.image_data) {
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      image_data: chunk.image_data
-                    }
-                  }
-
-                  currentContent += `\n[Image data received: ${chunk.image_data.mimeType}]\n`
-                }
-                break
-              case 'error':
-                console.error(`Provider stream error for event ${eventId}:`, chunk.error_message)
-                yield {
-                  type: 'error',
-                  data: {
-                    eventId,
-                    error: chunk.error_message || 'Provider stream error'
-                  }
-                }
-
-                needContinueConversation = false
-                break // Break inner loop on provider error
-              case 'rate_limit':
-                if (chunk.rate_limit) {
-                  yield {
-                    type: 'response',
-                    data: {
-                      eventId,
-                      rate_limit: chunk.rate_limit
-                    }
-                  }
-                }
-                break
-              case 'stop':
-                console.log(
-                  `Provider stream stopped for event ${eventId}. Reason: ${chunk.stop_reason}`
-                )
-                if (chunk.stop_reason === 'tool_use') {
-                  // Consolidate any remaining tool call chunks
-                  for (const id in currentToolChunks) {
-                    currentToolCalls.push({
-                      id: id,
-                      name: currentToolChunks[id].name,
-                      arguments: currentToolChunks[id].arguments_chunk
-                    })
-                  }
-
-                  if (currentToolCalls.length > 0) {
-                    needContinueConversation = true
-                  } else {
-                    console.warn(
-                      `Stop reason was 'tool_use' but no tool calls were fully parsed for event ${eventId}.`
-                    )
-                    needContinueConversation = false // Don't continue if no tools parsed
-                  }
-                } else {
-                  needContinueConversation = false
-                }
-                // Stop event itself doesn't need to be yielded here, handled by loop logic
-                break
-            }
-          } // End of inner loop (for await...of stream)
-
-          if (abortController.signal.aborted) break // Break outer loop if aborted
-
-          // --- Post-Stream Processing ---
-
-          // 1. Add Assistant Message
-          const assistantMessage: ChatMessage = {
-            role: 'assistant',
-            content: currentContent
-          }
-          if (
-            this.requiresReasoningField(modelId) &&
-            currentToolCalls.length > 0 &&
-            currentReasoning
-          ) {
-            ;(assistantMessage as any).reasoning_content = currentReasoning
-          }
-          // Only add if there's content or tool calls are expected
-          if (currentContent || (needContinueConversation && currentToolCalls.length > 0)) {
-            conversationMessages.push(assistantMessage)
-          }
-
-          // 2. Execute Tool Calls if needed
-          if (needContinueConversation && currentToolCalls.length > 0) {
-            const processor = this.toolCallProcessor.process({
-              eventId,
-              toolCalls: currentToolCalls,
-              enabledMcpTools,
-              conversationMessages,
-              modelConfig,
-              providerId,
-              abortSignal: abortController.signal,
-              currentToolCallCount: toolCallCount,
-              maxToolCalls: MAX_TOOL_CALLS,
-              conversationId
-            })
-
-            while (true) {
-              const { value, done } = await processor.next()
-              if (done) {
-                toolCallCount = value.toolCallCount
-                needContinueConversation = value.needContinueConversation
-                break
-              }
-              yield value
-            }
-
-            if (abortController.signal.aborted) {
-              break // Check after tool loop
-            }
-
-            if (!needContinueConversation) {
-              // If max tool calls reached or explicit stop, break outer loop
-              break
-            }
-          } else {
-            // No tool calls needed or requested, end the loop
-            needContinueConversation = false
-          }
-        } catch (error) {
-          if (abortController.signal.aborted) {
-            console.log(`Agent loop aborted during inner try-catch for event ${eventId}`)
-            break // Break outer loop if aborted here
-          }
-          console.error(`Agent loop inner error for event ${eventId}:`, error)
-          yield {
-            type: 'error',
-            data: {
-              eventId,
-              error: error instanceof Error ? error.message : String(error)
-            }
-          }
-
-          needContinueConversation = false // Stop loop on inner error
-        }
-      } // --- End of Agent Loop (while) ---
-      console.log(
-        `[Agent Loop] Agent loop completed for event: ${eventId}, iterations: ${toolCallCount}`
-      )
-    } catch (error) {
-      // Catch errors from the generator setup phase (before the loop)
-      if (abortController.signal.aborted) {
-        console.log(`Agent loop aborted during outer try-catch for event ${eventId}`)
-      } else {
-        console.error(`Agent loop outer error for event ${eventId}:`, error)
-        yield {
-          type: 'error',
-          data: {
-            eventId,
-            error: error instanceof Error ? error.message : String(error)
-          }
-        }
-      }
-    } finally {
-      // Finalize stream regardless of how the loop ended (completion, error, abort)
-      const userStop = abortController.signal.aborted
-      if (!userStop) {
-        // Yield final aggregated usage if not aborted
-        yield {
-          type: 'response',
-          data: {
-            eventId,
-            totalUsage
-          }
-        }
-      }
-      // Yield the final END event
-      yield { type: 'end', data: { eventId, userStop } }
-
-      this.options.activeStreams.delete(eventId)
-      console.log('Agent loop finished for event:', eventId, 'User stopped:', userStop)
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/errorClassification.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/errorClassification.ts
deleted file mode 100644
index 9c028a96d..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/errorClassification.ts
+++ /dev/null
@@ -1,102 +0,0 @@
-/**
- * Error classification utility to identify non-retryable errors.
- * Non-retryable errors should stop the agent loop, while all other errors
- * should allow the loop to continue so LLM can decide whether to retry.
- */
-
-/**
- * Checks if an error is non-retryable (should stop the agent loop).
- *
- * Non-retryable errors are those that won't be resolved by retrying:
- * - Invalid input format (invalid URL, malformed JSON, etc.)
- * - Explicit permission denied
- * - Schema validation failures
- * - Authentication errors that can't be resolved by retry
- * - Malformed requests that won't work on retry
- *
- * All other errors (network errors, timeouts, destroyed objects, etc.)
- * are considered retryable by default and should allow the loop to continue.
- *
- * @param error - The error to classify (Error object or string)
- * @returns true if the error is non-retryable (should stop loop), false otherwise
- */
-export function isNonRetryableError(error: Error | string): boolean {
-  const errorMessage = error instanceof Error ? error.message : String(error)
-  const lowerMessage = errorMessage.toLowerCase()
-
-  // Invalid URL format - won't work on retry
-  if (
-    lowerMessage.includes('invalid url') ||
-    lowerMessage.includes('malformed url') ||
-    lowerMessage.includes('url parse error') ||
-    lowerMessage.includes('invalid uri')
-  ) {
-    return true
-  }
-
-  // Invalid JSON format in arguments - won't work on retry
-  if (
-    lowerMessage.includes('invalid json') ||
-    lowerMessage.includes('json parse error') ||
-    lowerMessage.includes('unexpected token') ||
-    lowerMessage.includes('malformed json')
-  ) {
-    return true
-  }
-
-  // Schema validation failures - wrong parameter types, missing required fields
-  if (
-    lowerMessage.includes('schema validation') ||
-    lowerMessage.includes('validation error') ||
-    lowerMessage.includes('invalid argument') ||
-    lowerMessage.includes('invalid parameter') ||
-    lowerMessage.includes('required field') ||
-    lowerMessage.includes('missing required') ||
-    lowerMessage.includes('type error') ||
-    lowerMessage.includes('type mismatch')
-  ) {
-    return false
-  }
-
-  // Explicit permission denied (user explicitly denied, not a transient error)
-  if (
-    lowerMessage.includes('permission denied') &&
-    (lowerMessage.includes('explicitly') || lowerMessage.includes('user denied'))
-  ) {
-    return true
-  }
-
-  // Authentication errors that can't be resolved by retry
-  if (
-    lowerMessage.includes('authentication failed') &&
-    (lowerMessage.includes('invalid credentials') ||
-      lowerMessage.includes('invalid api key') ||
-      lowerMessage.includes('unauthorized'))
-  ) {
-    return true
-  }
-
-  // Malformed requests that won't work on retry
-  if (
-    lowerMessage.includes('malformed request') ||
-    lowerMessage.includes('invalid request format') ||
-    lowerMessage.includes('bad request format')
-  ) {
-    return true
-  }
-
-  // Tool definition not found - won't work on retry
-  if (lowerMessage.includes('tool definition not found') || lowerMessage.includes('unknown tool')) {
-    return true
-  }
-
-  // All other errors are considered retryable by default
-  // This includes:
-  // - "Object has been destroyed" / "WebContents destroyed"
-  // - Network errors (SSL failures, connection errors, error codes -3, -100)
-  // - Timeout errors
-  // - Loading errors
-  // - Transient service errors
-  // - Rate limiting
-  return false
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/index.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/index.ts
deleted file mode 100644
index 7892b7822..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/index.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-export { AgentLoopHandler } from './agentLoopHandler'
-export { LoopOrchestrator } from './loopOrchestrator'
-export { ToolCallHandler } from './toolCallHandler'
-export { ToolCallProcessor } from './toolCallProcessor'
-export { isNonRetryableError } from './errorClassification'
-export type { StreamState } from './loopState'
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopOrchestrator.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopOrchestrator.ts
deleted file mode 100644
index 1e93f905c..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopOrchestrator.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-import type { LLMAgentEvent, LLMAgentEventData } from '@shared/presenter'
-
-type LLMEventConsumer = {
-  handleLLMAgentResponse: (msg: LLMAgentEventData) => Promise<void>
-  handleLLMAgentError: (msg: LLMAgentEventData) => Promise<void>
-  handleLLMAgentEnd: (msg: LLMAgentEventData) => Promise<void>
-}
-
-export class LoopOrchestrator {
-  constructor(private readonly consumer: LLMEventConsumer) {}
-
-  async consume(stream: AsyncGenerator<LLMAgentEvent, void, unknown>): Promise<void> {
-    for await (const event of stream) {
-      const msg = event.data
-      if (event.type === 'response') {
-        await this.consumer.handleLLMAgentResponse(msg)
-      } else if (event.type === 'error') {
-        await this.consumer.handleLLMAgentError(msg)
-      } else if (event.type === 'end') {
-        await this.consumer.handleLLMAgentEnd(msg)
-      }
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopState.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopState.ts
deleted file mode 100644
index 4586112a3..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopState.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-import type { BaseLLMProvider } from '@/presenter/llmProviderPresenter/baseProvider'
-
-export interface StreamState {
-  isGenerating: boolean
-  providerId: string
-  modelId: string
-  abortController: AbortController
-  provider: BaseLLMProvider
-}
-
-export type LoopState = {
-  loopId: string
-  conversationMessages: any[]
-  toolCallCount: number
-  needContinueConversation: boolean
-  currentContent: string
-  currentReasoning?: string
-  currentToolCalls: Array<{ id: string; name: string; arguments: string }>
-  totalUsage: {
-    prompt_tokens: number
-    completion_tokens: number
-    total_tokens: number
-    context_length: number
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallHandler.ts
deleted file mode 100644
index 835c6c32e..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallHandler.ts
+++ /dev/null
@@ -1,610 +0,0 @@
-import type { AssistantMessageBlock } from '@shared/chat'
-import type { QuestionInfo } from '@shared/types/core/question'
-import { finalizeAssistantMessageBlocks } from '@shared/chat/messageBlocks'
-import type {
-  LLMAgentEventData,
-  MCPToolResponse,
-  ISQLitePresenter,
-  MCPContentItem,
-  MCPResourceContent
-} from '@shared/presenter'
-import { nanoid } from 'nanoid'
-import type { GeneratingMessageState } from '../streaming/types'
-import type { StreamUpdateScheduler } from '../streaming/streamUpdateScheduler'
-import type { CommandPermissionService } from '../../permission/commandPermissionService'
-
-interface PermissionRequestPayload {
-  permissionType?: string
-  toolName?: string
-  serverName?: string
-  providerId?: string
-  requestId?: string
-  sessionId?: string
-  agentId?: string
-  agentName?: string
-  conversationId?: string
-  command?: string
-  commandSignature?: string
-  commandInfo?: {
-    command: string
-    riskLevel: 'low' | 'medium' | 'high' | 'critical'
-    suggestion: string
-    signature?: string
-    baseCommand?: string
-  }
-  rememberable?: boolean
-  [key: string]: unknown
-}
-
-export class ToolCallHandler {
-  private static readonly MCP_UI_MIME_TYPES = new Set([
-    'text/html',
-    'text/uri-list',
-    'application/vnd.mcp-ui.remote-dom'
-  ])
-
-  private readonly sqlitePresenter: ISQLitePresenter
-  private readonly commandPermissionHandler?: CommandPermissionService
-  private readonly streamUpdateScheduler: StreamUpdateScheduler
-
-  constructor(options: {
-    sqlitePresenter: ISQLitePresenter
-    commandPermissionHandler?: CommandPermissionService
-    streamUpdateScheduler: StreamUpdateScheduler
-  }) {
-    this.sqlitePresenter = options.sqlitePresenter
-    this.commandPermissionHandler = options.commandPermissionHandler
-    this.streamUpdateScheduler = options.streamUpdateScheduler
-  }
-
-  async processToolCallStart(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData,
-    currentTime: number
-  ): Promise<void> {
-    this.finalizeLastBlock(state)
-    state.message.content.push({
-      type: 'tool_call',
-      content: '',
-      status: 'loading',
-      timestamp: currentTime,
-      tool_call: {
-        id: event.tool_call_id,
-        name: event.tool_call_name,
-        params: event.tool_call_params || '',
-        server_name: event.tool_call_server_name,
-        server_icons: event.tool_call_server_icons,
-        server_description: event.tool_call_server_description
-      }
-    })
-  }
-
-  async processToolCallUpdate(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData
-  ): Promise<void> {
-    const block = state.message.content.find(
-      (item) =>
-        item.type === 'tool_call' &&
-        item.tool_call?.id === event.tool_call_id &&
-        item.status === 'loading'
-    )
-
-    if (!block || block.type !== 'tool_call' || !block.tool_call) {
-      return
-    }
-
-    block.tool_call.params = event.tool_call_params || ''
-
-    if (event.tool_call_server_name) {
-      block.tool_call.server_name = event.tool_call_server_name
-    }
-    if (event.tool_call_server_icons) {
-      block.tool_call.server_icons = event.tool_call_server_icons
-    }
-    if (event.tool_call_server_description) {
-      block.tool_call.server_description = event.tool_call_server_description
-    }
-  }
-
-  async processToolCallEnd(state: GeneratingMessageState, event: LLMAgentEventData): Promise<void> {
-    const toolCallBlock = state.message.content.find(
-      (block) =>
-        block.type === 'tool_call' &&
-        block.tool_call?.id === event.tool_call_id &&
-        block.status === 'loading'
-    )
-
-    if (toolCallBlock && toolCallBlock.type === 'tool_call') {
-      toolCallBlock.status = 'success'
-      if (toolCallBlock.tool_call) {
-        toolCallBlock.tool_call.response = event.tool_call_response || ''
-      }
-    }
-
-    const lastBlock = state.message.content[state.message.content.length - 1]
-    if (
-      lastBlock &&
-      lastBlock.type === 'action' &&
-      lastBlock.action_type === 'tool_call_permission'
-    ) {
-      lastBlock.status = 'success'
-    }
-
-    state.pendingToolCall = undefined
-  }
-
-  async processToolCallError(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData
-  ): Promise<void> {
-    const toolCallBlock = state.message.content.find(
-      (block) =>
-        block.type === 'tool_call' &&
-        block.tool_call?.id === event.tool_call_id &&
-        block.status === 'loading'
-    )
-
-    if (toolCallBlock && toolCallBlock.type === 'tool_call') {
-      toolCallBlock.status = 'error'
-      if (toolCallBlock.tool_call) {
-        toolCallBlock.tool_call.response = event.tool_call_response || ''
-      }
-    }
-
-    state.pendingToolCall = undefined
-  }
-
-  async processToolCallPermission(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData,
-    currentTime: number
-  ): Promise<void> {
-    if (event.tool_call === 'permission-required') {
-      this.handlePermissionRequired(state, event, currentTime)
-      return
-    }
-
-    const lastBlock = state.message.content[state.message.content.length - 1]
-    if (
-      lastBlock &&
-      lastBlock.type === 'action' &&
-      lastBlock.action_type === 'tool_call_permission'
-    ) {
-      if (event.tool_call === 'permission-granted') {
-        lastBlock.status = 'granted'
-        lastBlock.content = event.tool_call_response || ''
-        if (lastBlock.extra) {
-          lastBlock.extra.needsUserAction = false
-          if (
-            !lastBlock.extra.grantedPermissions &&
-            typeof lastBlock.extra.permissionType === 'string'
-          ) {
-            lastBlock.extra.grantedPermissions = lastBlock.extra.permissionType
-          }
-        }
-
-        // CRITICAL FIX: Create the tool_call block so processToolCallUpdate/End can find it
-        // This ensures frontend state updates correctly after permission is granted
-        this.finalizeLastBlock(state)
-        state.message.content.push({
-          type: 'tool_call',
-          content: '',
-          status: 'loading',
-          timestamp: currentTime,
-          tool_call: {
-            id: event.tool_call_id,
-            name: event.tool_call_name,
-            params: event.tool_call_params || '',
-            server_name: event.tool_call_server_name,
-            server_icons: event.tool_call_server_icons,
-            server_description: event.tool_call_server_description
-          }
-        })
-
-        state.pendingToolCall = this.buildPendingToolCall(event)
-        return
-      }
-
-      if (event.tool_call === 'permission-denied') {
-        lastBlock.status = 'denied'
-        lastBlock.content = event.tool_call_response || ''
-        if (lastBlock.extra) {
-          lastBlock.extra.needsUserAction = false
-        }
-        state.pendingToolCall = undefined
-        return
-      }
-
-      if (event.tool_call === 'continue') {
-        lastBlock.status = 'success'
-        return
-      }
-    }
-  }
-
-  async processQuestionRequest(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData,
-    currentTime: number
-  ): Promise<void> {
-    const payload = event.question_request as QuestionInfo | undefined
-    if (!payload) return
-
-    this.finalizeLastBlock(state)
-
-    state.message.content.push({
-      type: 'action',
-      content: '',
-      status: 'pending',
-      timestamp: currentTime,
-      action_type: 'question_request',
-      tool_call: {
-        id: event.tool_call_id,
-        name: event.tool_call_name,
-        params: event.tool_call_params || '',
-        server_name: event.tool_call_server_name,
-        server_icons: event.tool_call_server_icons,
-        server_description: event.tool_call_server_description
-      },
-      extra: {
-        needsUserAction: true,
-        questionHeader: payload.header ?? '',
-        questionText: payload.question,
-        questionOptions: payload.options,
-        questionMultiple: Boolean(payload.multiple),
-        questionCustom: payload.custom !== false,
-        questionResolution: 'asked'
-      }
-    })
-
-    state.pendingToolCall = undefined
-  }
-
-  async processMcpUiResourcesFromToolCall(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData,
-    currentTime: number
-  ): Promise<boolean> {
-    if (event.tool_call !== 'end') {
-      return false
-    }
-
-    try {
-      const response = event.tool_call_response_raw as MCPToolResponse | null
-      const contentItems = Array.isArray(response?.content)
-        ? (response.content as MCPContentItem[])
-        : []
-
-      const uiResourceItems = contentItems.filter((item): item is MCPResourceContent => {
-        if (item.type !== 'resource') {
-          return false
-        }
-        const uri = item.resource?.uri
-        const mimeType = item.resource?.mimeType || ''
-        return (
-          typeof uri === 'string' &&
-          uri.startsWith('ui://') &&
-          ToolCallHandler.MCP_UI_MIME_TYPES.has(mimeType)
-        )
-      })
-
-      if (uiResourceItems.length === 0) {
-        return false
-      }
-
-      const uiBlocks: AssistantMessageBlock[] = uiResourceItems
-        .map((item) => {
-          const resource = item.resource
-          if (!resource?.uri) {
-            return null
-          }
-
-          const mimeType = resource.mimeType || ''
-          if (!ToolCallHandler.MCP_UI_MIME_TYPES.has(mimeType)) {
-            return null
-          }
-          const typedMimeType = mimeType as
-            | 'text/html'
-            | 'text/uri-list'
-            | 'application/vnd.mcp-ui.remote-dom'
-
-          const meta = (
-            resource as MCPResourceContent['resource'] & { _meta?: Record<string, unknown> }
-          )._meta
-
-          return {
-            type: 'mcp_ui_resource',
-            status: 'success',
-            timestamp: currentTime,
-            mcp_ui_resource: {
-              uri: resource.uri,
-              mimeType: typedMimeType,
-              text: typeof resource.text === 'string' ? resource.text : undefined,
-              blob: typeof resource.blob === 'string' ? resource.blob : undefined,
-              _meta: meta && typeof meta === 'object' ? meta : undefined
-            }
-          }
-        })
-        .filter(Boolean) as AssistantMessageBlock[]
-
-      if (uiBlocks.length === 0) {
-        return false
-      }
-
-      this.finalizeLastBlock(state)
-      state.message.content.push(...uiBlocks)
-      this.streamUpdateScheduler.enqueueDelta(
-        event.eventId,
-        state.conversationId,
-        state.message.parentId,
-        Boolean(state.message.is_variant),
-        state.webContentsId,
-        {},
-        state.message.content
-      )
-      return true
-    } catch (error) {
-      console.error('[ToolCallHandler] Error processing MCP UI resources from tool call:', error)
-      return false
-    }
-  }
-
-  async processSearchResultsFromToolCall(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData,
-    currentTime: number
-  ): Promise<boolean> {
-    if (event.tool_call !== 'end') {
-      return false
-    }
-
-    try {
-      const response = event.tool_call_response_raw as MCPToolResponse | null
-      const contentItems = Array.isArray(response?.content)
-        ? (response?.content as MCPContentItem[])
-        : []
-
-      const resourceItems = contentItems.filter((item): item is MCPResourceContent => {
-        return (
-          item.type === 'resource' && item.resource?.mimeType === 'application/deepchat-webpage'
-        )
-      })
-
-      if (resourceItems.length === 0) {
-        return false
-      }
-
-      const searchResults = resourceItems
-        .map((item) => {
-          try {
-            const blobContent = JSON.parse(item.resource?.text ?? '{}') as {
-              title?: string
-              url?: string
-              content?: string
-              icon?: string
-              description?: string
-              favicon?: string
-              rank?: number
-            }
-            return {
-              title: blobContent.title || '',
-              url: blobContent.url || item.resource?.uri || '',
-              content: blobContent.content || '',
-              description: blobContent.description || blobContent.content || '',
-              icon: blobContent.icon || '',
-              favicon: blobContent.favicon || '',
-              rank: blobContent.rank
-            }
-          } catch (error) {
-            console.error('[ToolCallHandler] Failed to parse search result blob:', error)
-            return null
-          }
-        })
-        .filter(Boolean) as Array<{
-        title: string
-        url: string
-        content: string
-        description: string
-        icon: string
-        favicon?: string
-        rank?: number
-      }>
-
-      if (searchResults.length === 0) {
-        return false
-      }
-
-      const searchId = nanoid()
-      const pages = searchResults
-        .filter((item) => item.icon || item.favicon)
-        .slice(0, 6)
-        .map((item) => ({
-          url: item.url,
-          icon: item.icon || item.favicon || ''
-        }))
-
-      const searchBlock: AssistantMessageBlock = {
-        id: searchId,
-        type: 'search',
-        content: '',
-        status: 'success',
-        timestamp: currentTime,
-        extra: {
-          total: searchResults.length,
-          searchId,
-          pages,
-          label: event.tool_call_name || 'web_search',
-          name: event.tool_call_name || 'web_search',
-          engine: event.tool_call_server_name || undefined,
-          provider: event.tool_call_server_name || undefined
-        }
-      }
-
-      this.finalizeLastBlock(state)
-      state.message.content.push(searchBlock)
-
-      for (const result of searchResults) {
-        await this.sqlitePresenter.addMessageAttachment(
-          event.eventId,
-          'search_result',
-          JSON.stringify({
-            title: result.title,
-            url: result.url,
-            content: result.content,
-            description: result.description,
-            icon: result.icon || result.favicon || '',
-            rank: typeof result.rank === 'number' ? result.rank : undefined,
-            searchId
-          })
-        )
-      }
-
-      this.streamUpdateScheduler.enqueueDelta(
-        event.eventId,
-        state.conversationId,
-        state.message.parentId,
-        Boolean(state.message.is_variant),
-        state.webContentsId,
-        {},
-        state.message.content
-      )
-      return true
-    } catch (error) {
-      console.error('[ToolCallHandler] Error processing search results from tool call:', error)
-      return false
-    }
-  }
-
-  private handlePermissionRequired(
-    state: GeneratingMessageState,
-    event: LLMAgentEventData,
-    currentTime: number
-  ): void {
-    const ALLOWED_PERMISSION_TYPES = ['read', 'write', 'all', 'command'] as const
-    type PermissionType = (typeof ALLOWED_PERMISSION_TYPES)[number]
-
-    let permissionType: PermissionType = 'read'
-    const requestedType = event.permission_request?.permissionType
-    if (typeof requestedType === 'string') {
-      const normalizedType = requestedType.toLowerCase()
-      if (ALLOWED_PERMISSION_TYPES.includes(normalizedType as PermissionType)) {
-        permissionType = normalizedType as PermissionType
-      } else {
-        console.warn(
-          `[ToolCallHandler] Invalid permission type received: "${requestedType}". Defaulting to "read".`
-        )
-      }
-    } else if (requestedType !== undefined) {
-      console.warn(
-        `[ToolCallHandler] Permission type is not a string: ${typeof requestedType}. Defaulting to "read".`
-      )
-    }
-
-    const lastBlock = state.message.content[state.message.content.length - 1]
-    if (lastBlock && lastBlock.type === 'tool_call' && lastBlock.tool_call) {
-    }
-
-    this.finalizeLastBlock(state)
-    const permissionExtra: Record<string, string | boolean> = {
-      needsUserAction: true
-    }
-
-    const permissionRequest = event.permission_request as PermissionRequestPayload | undefined
-    permissionExtra.permissionType = permissionRequest?.permissionType ?? permissionType
-    if (permissionRequest) {
-      permissionExtra.permissionRequest = JSON.stringify(permissionRequest)
-      if (permissionRequest.commandInfo) {
-        permissionExtra.commandInfo = JSON.stringify(permissionRequest.commandInfo)
-      } else {
-        const commandFromRequest = permissionRequest.command
-        if (commandFromRequest && this.commandPermissionHandler) {
-          permissionExtra.commandInfo = JSON.stringify(
-            this.commandPermissionHandler.buildCommandInfo(commandFromRequest)
-          )
-        }
-      }
-      if (permissionRequest.toolName) {
-        permissionExtra.toolName = permissionRequest.toolName
-      }
-      if (permissionRequest.serverName) {
-        permissionExtra.serverName = permissionRequest.serverName
-      }
-      if (permissionRequest.providerId) {
-        permissionExtra.providerId = permissionRequest.providerId
-      }
-      if (permissionRequest.requestId) {
-        permissionExtra.permissionRequestId = permissionRequest.requestId
-      }
-      if (permissionRequest.rememberable === false) {
-        permissionExtra.rememberable = false
-      }
-      if (permissionRequest.agentId) {
-        permissionExtra.agentId = permissionRequest.agentId
-      }
-      if (permissionRequest.agentName) {
-        permissionExtra.agentName = permissionRequest.agentName
-      }
-      if (permissionRequest.sessionId) {
-        permissionExtra.sessionId = permissionRequest.sessionId
-      }
-      if (!permissionExtra.commandInfo && this.commandPermissionHandler) {
-        try {
-          const parsedParams = JSON.parse(event.tool_call_params || '{}') as { command?: string }
-          if (typeof parsedParams.command === 'string' && parsedParams.command.trim()) {
-            permissionExtra.commandInfo = JSON.stringify(
-              this.commandPermissionHandler.buildCommandInfo(parsedParams.command)
-            )
-          }
-        } catch {
-          // Ignore parsing failures for command info fallback.
-        }
-      }
-    } else {
-      if (event.tool_call_name) {
-        permissionExtra.toolName = event.tool_call_name
-      }
-      if (event.tool_call_server_name) {
-        permissionExtra.serverName = event.tool_call_server_name
-      }
-    }
-
-    state.message.content.push({
-      type: 'action',
-      content: event.tool_call_response || '',
-      status: 'pending',
-      timestamp: currentTime,
-      action_type: 'tool_call_permission',
-      tool_call: {
-        id: event.tool_call_id,
-        name: event.tool_call_name,
-        params: event.tool_call_params || '',
-        server_name: event.tool_call_server_name,
-        server_icons: event.tool_call_server_icons,
-        server_description: event.tool_call_server_description
-      },
-      extra: permissionExtra
-    })
-
-    state.pendingToolCall = this.buildPendingToolCall(event)
-  }
-
-  private buildPendingToolCall(event: LLMAgentEventData) {
-    if (!event.tool_call_id && !event.tool_call_name) {
-      return undefined
-    }
-
-    return {
-      id: event.tool_call_id || '',
-      name: event.tool_call_name || '',
-      params: event.tool_call_params || '',
-      serverName: event.tool_call_server_name,
-      serverIcons: event.tool_call_server_icons,
-      serverDescription: event.tool_call_server_description
-    }
-  }
-
-  private finalizeLastBlock(state: GeneratingMessageState): void {
-    finalizeAssistantMessageBlocks(state.message.content)
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallProcessor.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallProcessor.ts
deleted file mode 100644
index 50a93f979..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallProcessor.ts
+++ /dev/null
@@ -1,726 +0,0 @@
-import {
-  ChatMessage,
-  LLMAgentEvent,
-  MCPToolCall,
-  MCPToolDefinition,
-  MCPToolResponse,
-  ModelConfig
-} from '@shared/presenter'
-import fs from 'fs/promises'
-import path from 'path'
-import { isNonRetryableError } from './errorClassification'
-import { resolveToolOffloadPath } from '../../sessionPresenter/sessionPaths'
-import { parseQuestionToolArgs, QUESTION_TOOL_NAME } from '@/lib/agentRuntime/questionTool'
-
-interface ToolCallProcessorOptions {
-  getAllToolDefinitions: (context: ToolCallExecutionContext) => Promise<MCPToolDefinition[]>
-  callTool: (request: MCPToolCall) => Promise<{ content: unknown; rawData: MCPToolResponse }>
-  preCheckToolPermission?: (request: MCPToolCall) => Promise<PermissionRequestPayload | null>
-  onToolCallFinished?: (info: {
-    toolName: string
-    toolCallId: string
-    toolServerName?: string
-    conversationId?: string
-    status: 'success' | 'error' | 'permission'
-  }) => void
-}
-
-interface ToolCallExecutionContext {
-  eventId: string
-  toolCalls: Array<{ id: string; name: string; arguments: string }>
-  enabledMcpTools?: string[]
-  conversationMessages: ChatMessage[]
-  modelConfig: ModelConfig
-  providerId?: string
-  abortSignal: AbortSignal
-  currentToolCallCount: number
-  maxToolCalls: number
-  conversationId?: string
-}
-
-interface ToolCallProcessResult {
-  toolCallCount: number
-  needContinueConversation: boolean
-}
-
-interface ToolCall {
-  id: string
-  name: string
-  arguments: string
-}
-
-type PermissionType = 'read' | 'write' | 'all' | 'command'
-
-interface CommandInfoPayload {
-  command: string
-  riskLevel: 'low' | 'medium' | 'high' | 'critical'
-  suggestion: string
-  signature?: string
-  baseCommand?: string
-}
-
-interface PermissionRequestPayload {
-  needsPermission: true
-  toolName: string
-  serverName: string
-  permissionType: PermissionType
-  description: string
-  command?: string
-  commandSignature?: string
-  commandInfo?: CommandInfoPayload
-  paths?: string[]
-  providerId?: string
-  requestId?: string
-  sessionId?: string
-  agentId?: string
-  agentName?: string
-  conversationId?: string
-  rememberable?: boolean
-  [key: string]: unknown
-}
-
-interface PermissionRequestInfo {
-  toolCall: ToolCall
-  serverName: string
-  serverIcons?: string
-  serverDescription?: string
-  payload: PermissionRequestPayload
-}
-
-const TOOL_OUTPUT_OFFLOAD_THRESHOLD = 5000
-const TOOL_OUTPUT_PREVIEW_LENGTH = 1024
-const QUESTION_ERROR_KEY = 'common.error.invalidQuestionRequest'
-
-// Tools that require offload when output exceeds threshold
-// Tools not in this list will never trigger offload (e.g., read has its own pagination)
-const TOOLS_REQUIRING_OFFLOAD = new Set(['exec', 'ls', 'find', 'grep', 'cdp_send'])
-
-export class ToolCallProcessor {
-  constructor(private readonly options: ToolCallProcessorOptions) {}
-
-  async *process(
-    context: ToolCallExecutionContext
-  ): AsyncGenerator<LLMAgentEvent, ToolCallProcessResult, void> {
-    let toolCallCount = context.currentToolCallCount
-    let needContinueConversation = context.toolCalls.length > 0
-    let toolDefinitions = await this.options.getAllToolDefinitions(context)
-
-    // Step 1: Pre-check all tool permissions in batch
-    // If any tool requires permission, we pause and request permission for all at once
-    const permissionCheckResult = await this.batchPreCheckPermissions(context, toolDefinitions)
-
-    if (permissionCheckResult.hasPendingPermissions) {
-      // Yield permission request event for all tools that need permission
-      for (const permissionRequest of permissionCheckResult.permissionRequests) {
-        const permissionPayload = {
-          ...permissionRequest.payload,
-          toolName: permissionRequest.toolCall.name,
-          serverName: permissionRequest.serverName,
-          permissionType: permissionRequest.payload.permissionType,
-          description: permissionRequest.payload.description,
-          conversationId: permissionRequest.payload.conversationId ?? context.conversationId,
-          // Mark this as part of a batch
-          isBatchPermission: true,
-          totalInBatch: permissionCheckResult.permissionRequests.length
-        }
-
-        yield {
-          type: 'response',
-          data: {
-            eventId: context.eventId,
-            tool_call: 'permission-required',
-            tool_call_id: permissionRequest.toolCall.id,
-            tool_call_name: permissionRequest.toolCall.name,
-            tool_call_params: permissionRequest.toolCall.arguments,
-            tool_call_server_name: permissionRequest.serverName,
-            tool_call_server_icons: permissionRequest.serverIcons,
-            tool_call_server_description: permissionRequest.serverDescription,
-            tool_call_response: permissionRequest.payload.description,
-            permission_request: permissionPayload
-          }
-        }
-      }
-
-      // Stop here and wait for user to grant permissions
-      // The loop will be restarted after permissions are granted
-      needContinueConversation = false
-      return {
-        toolCallCount,
-        needContinueConversation
-      }
-    }
-
-    const resolveToolDefinition = async (
-      toolName: string
-    ): Promise<MCPToolDefinition | undefined> => {
-      const match = toolDefinitions.find((tool) => tool.function.name === toolName)
-      if (match) return match
-      toolDefinitions = await this.options.getAllToolDefinitions(context)
-      return toolDefinitions.find((tool) => tool.function.name === toolName)
-    }
-
-    for (const [index, toolCall] of context.toolCalls.entries()) {
-      if (context.abortSignal.aborted) break
-
-      if (toolCallCount >= context.maxToolCalls) {
-        console.warn('Max tool calls reached during execution phase for event:', context.eventId)
-        yield {
-          type: 'response',
-          data: {
-            eventId: context.eventId,
-            maximum_tool_calls_reached: true,
-            tool_call_id: toolCall.id,
-            tool_call_name: toolCall.name
-          }
-        }
-
-        needContinueConversation = false
-        break
-      }
-
-      toolCallCount++
-
-      const toolDef = await resolveToolDefinition(toolCall.name)
-
-      if (!toolDef) {
-        console.error(`Tool definition not found for ${toolCall.name}. Skipping execution.`)
-        const errorMsg = `Tool definition for ${toolCall.name} not found.`
-        yield {
-          type: 'response',
-          data: {
-            eventId: context.eventId,
-            tool_call: 'error',
-            tool_call_id: toolCall.id,
-            tool_call_name: toolCall.name,
-            tool_call_response: errorMsg
-          }
-        }
-
-        context.conversationMessages.push({
-          role: 'user',
-          content: `Error: ${errorMsg}`
-        })
-        continue
-      }
-
-      const notifyToolCallFinished = (status: 'success' | 'error' | 'permission') => {
-        if (!this.options.onToolCallFinished) return
-        try {
-          this.options.onToolCallFinished({
-            toolName: toolCall.name,
-            toolCallId: toolCall.id,
-            toolServerName: toolDef.server?.name,
-            conversationId: context.conversationId,
-            status
-          })
-        } catch (error) {
-          console.warn('[ToolCallProcessor] onToolCallFinished handler failed:', error)
-        }
-      }
-
-      const mcpToolInput: MCPToolCall = {
-        id: toolCall.id,
-        type: 'function',
-        function: {
-          name: toolCall.name,
-          arguments: toolCall.arguments
-        },
-        server: toolDef.server,
-        conversationId: context.conversationId
-      }
-
-      if (toolCall.name === QUESTION_TOOL_NAME) {
-        const isStandalone = context.toolCalls.length === 1
-        const isLast = index === context.toolCalls.length - 1
-        if (!isStandalone || !isLast) {
-          notifyToolCallFinished('error')
-          this.appendToolError(
-            context.conversationMessages,
-            context.modelConfig,
-            toolCall,
-            'Question tool must be the only tool call in a turn.'
-          )
-          yield {
-            type: 'response',
-            data: {
-              eventId: context.eventId,
-              question_error: QUESTION_ERROR_KEY,
-              tool_call_id: toolCall.id,
-              tool_call_name: toolCall.name
-            }
-          }
-          continue
-        }
-
-        const parsedQuestion = parseQuestionToolArgs(toolCall.arguments || '')
-        if (!parsedQuestion.success) {
-          notifyToolCallFinished('error')
-          this.appendToolError(
-            context.conversationMessages,
-            context.modelConfig,
-            toolCall,
-            `Invalid question tool arguments: ${parsedQuestion.error}`
-          )
-          yield {
-            type: 'response',
-            data: {
-              eventId: context.eventId,
-              question_error: QUESTION_ERROR_KEY,
-              tool_call_id: toolCall.id,
-              tool_call_name: toolCall.name
-            }
-          }
-          continue
-        }
-
-        notifyToolCallFinished('success')
-        yield {
-          type: 'response',
-          data: {
-            eventId: context.eventId,
-            tool_call: 'question-required',
-            tool_call_id: toolCall.id,
-            tool_call_name: toolCall.name,
-            tool_call_params: toolCall.arguments,
-            tool_call_server_name: toolDef.server.name,
-            tool_call_server_icons: toolDef.server.icons,
-            tool_call_server_description: toolDef.server.description,
-            question_request: parsedQuestion.data
-          }
-        }
-
-        needContinueConversation = false
-        break
-      }
-
-      yield {
-        type: 'response',
-        data: {
-          eventId: context.eventId,
-          tool_call: 'running',
-          tool_call_id: toolCall.id,
-          tool_call_name: toolCall.name,
-          tool_call_params: toolCall.arguments,
-          tool_call_server_name: toolDef.server.name,
-          tool_call_server_icons: toolDef.server.icons,
-          tool_call_server_description: toolDef.server.description
-        }
-      }
-
-      try {
-        const toolResponse = await this.options.callTool(mcpToolInput)
-        const requiresPermission = Boolean(toolResponse.rawData?.requiresPermission)
-
-        if (requiresPermission) {
-          notifyToolCallFinished('permission')
-          console.log(
-            `[Agent Loop] Permission required for tool ${toolCall.name}, creating permission request`
-          )
-
-          yield {
-            type: 'response',
-            data: {
-              eventId: context.eventId,
-              tool_call: 'permission-required',
-              tool_call_id: toolCall.id,
-              tool_call_name: toolCall.name,
-              tool_call_params: toolCall.arguments,
-              tool_call_server_name: toolResponse.rawData.permissionRequest?.serverName,
-              tool_call_server_icons: toolDef.server.icons,
-              tool_call_server_description: toolDef.server.description,
-              tool_call_response: toolResponse.content,
-              permission_request: toolResponse.rawData.permissionRequest
-            }
-          }
-
-          needContinueConversation = false
-          break
-        }
-
-        notifyToolCallFinished('success')
-
-        if (context.abortSignal.aborted) break
-
-        const supportsFunctionCall = context.modelConfig?.functionCall || false
-
-        const toolContent = this.stringifyToolContent(toolResponse.content)
-        const toolContentForModel = await this.offloadToolContentIfNeeded(
-          toolContent,
-          toolCall.id,
-          context.conversationId,
-          toolCall.name
-        )
-
-        if (supportsFunctionCall) {
-          this.appendNativeFunctionCallMessages(context.conversationMessages, toolCall, {
-            content: toolContentForModel
-          })
-
-          yield {
-            type: 'response',
-            data: {
-              eventId: context.eventId,
-              tool_call: 'end',
-              tool_call_id: toolCall.id,
-              tool_call_response: toolContentForModel,
-              tool_call_name: toolCall.name,
-              tool_call_params: toolCall.arguments,
-              tool_call_server_name: toolDef.server.name,
-              tool_call_server_icons: toolDef.server.icons,
-              tool_call_server_description: toolDef.server.description,
-              tool_call_response_raw: toolResponse.rawData
-            }
-          }
-        } else {
-          this.appendLegacyFunctionCallMessages(context.conversationMessages, toolCall, {
-            content: toolContentForModel
-          })
-
-          yield {
-            type: 'response',
-            data: {
-              eventId: context.eventId,
-              tool_call: 'end',
-              tool_call_id: toolCall.id,
-              tool_call_response: toolContentForModel,
-              tool_call_name: toolCall.name,
-              tool_call_params: toolCall.arguments,
-              tool_call_server_name: toolDef.server.name,
-              tool_call_server_icons: toolDef.server.icons,
-              tool_call_server_description: toolDef.server.description,
-              tool_call_response_raw: toolResponse.rawData
-            }
-          }
-        }
-      } catch (toolError) {
-        notifyToolCallFinished('error')
-        if (context.abortSignal.aborted) break
-
-        console.error(
-          `Tool execution error for ${toolCall.name} (event ${context.eventId}):`,
-          toolError
-        )
-        const errorMessage = toolError instanceof Error ? toolError.message : String(toolError)
-
-        // Check if error is non-retryable (should stop the loop)
-        const errorForClassification: Error | string =
-          toolError instanceof Error ? toolError : String(toolError)
-        const isNonRetryable = isNonRetryableError(errorForClassification)
-
-        this.appendToolError(
-          context.conversationMessages,
-          context.modelConfig,
-          toolCall,
-          errorMessage
-        )
-
-        yield {
-          type: 'response',
-          data: {
-            eventId: context.eventId,
-            tool_call: 'error',
-            tool_call_id: toolCall.id,
-            tool_call_name: toolCall.name,
-            tool_call_params: toolCall.arguments,
-            tool_call_response: errorMessage,
-            tool_call_server_name: toolDef.server.name,
-            tool_call_server_icons: toolDef.server.icons,
-            tool_call_server_description: toolDef.server.description
-          }
-        }
-
-        // If error is non-retryable, stop the loop
-        // Otherwise, keep needContinueConversation = true (default) to let LLM decide
-        if (isNonRetryable) {
-          needContinueConversation = false
-          break
-        }
-        // For retryable errors, continue the loop (needContinueConversation remains true)
-      }
-    }
-
-    return {
-      toolCallCount,
-      needContinueConversation
-    }
-  }
-
-  private appendNativeFunctionCallMessages(
-    conversationMessages: ChatMessage[],
-    toolCall: { id: string; name: string; arguments: string },
-    toolResponse: { content: unknown }
-  ): void {
-    const lastAssistantMsg = conversationMessages.findLast(
-      (message) => message.role === 'assistant'
-    )
-    if (lastAssistantMsg) {
-      if (!lastAssistantMsg.tool_calls) lastAssistantMsg.tool_calls = []
-      lastAssistantMsg.tool_calls.push({
-        function: {
-          arguments: toolCall.arguments,
-          name: toolCall.name
-        },
-        id: toolCall.id,
-        type: 'function'
-      })
-    } else {
-      conversationMessages.push({
-        role: 'assistant',
-        tool_calls: [
-          {
-            function: {
-              arguments: toolCall.arguments,
-              name: toolCall.name
-            },
-            id: toolCall.id,
-            type: 'function'
-          }
-        ]
-      })
-    }
-
-    const toolContent = this.stringifyToolContent(toolResponse.content)
-    conversationMessages.push({
-      role: 'tool',
-      content: toolContent,
-      tool_call_id: toolCall.id
-    })
-  }
-
-  private appendLegacyFunctionCallMessages(
-    conversationMessages: ChatMessage[],
-    toolCall: { id: string; name: string; arguments: string },
-    toolResponse: { content: unknown; rawData?: unknown }
-  ): void {
-    const formattedToolRecordText =
-      '<function_call>' +
-      JSON.stringify({
-        function_call_record: {
-          name: toolCall.name,
-          arguments: toolCall.arguments,
-          response: toolResponse.content
-        }
-      }) +
-      '</function_call>'
-
-    let lastAssistantMessage = conversationMessages.findLast(
-      (message) => message.role === 'assistant'
-    )
-
-    if (lastAssistantMessage) {
-      if (typeof lastAssistantMessage.content === 'string') {
-        lastAssistantMessage.content += formattedToolRecordText + '\n'
-      } else if (Array.isArray(lastAssistantMessage.content)) {
-        lastAssistantMessage.content.push({
-          type: 'text',
-          text: formattedToolRecordText + '\n'
-        })
-      } else {
-        lastAssistantMessage.content = [{ type: 'text', text: formattedToolRecordText + '\n' }]
-      }
-    } else {
-      conversationMessages.push({
-        role: 'assistant',
-        content: [{ type: 'text', text: formattedToolRecordText + '\n' }]
-      })
-    }
-
-    const userPromptText =
-      '以上是你刚执行的工具调用及其响应信息，已帮你插入，请仔细阅读工具响应，并继续你的回答。'
-    conversationMessages.push({
-      role: 'user',
-      content: [{ type: 'text', text: userPromptText }]
-    })
-  }
-
-  private async offloadToolContentIfNeeded(
-    content: string,
-    toolCallId: string,
-    conversationId?: string,
-    toolName?: string
-  ): Promise<string> {
-    // Only offload tools in the whitelist
-    if (toolName && !TOOLS_REQUIRING_OFFLOAD.has(toolName)) {
-      return content
-    }
-
-    if (content.length <= TOOL_OUTPUT_OFFLOAD_THRESHOLD) return content
-    if (!conversationId) return content
-
-    const filePath = resolveToolOffloadPath(conversationId, toolCallId)
-    if (!filePath) return content
-    const sessionDir = path.dirname(filePath)
-
-    try {
-      await fs.mkdir(sessionDir, { recursive: true })
-      await fs.writeFile(filePath, content, 'utf-8')
-    } catch (error) {
-      console.warn('[ToolCallProcessor] Failed to offload tool output:', error)
-      return content
-    }
-
-    const preview = content.slice(0, TOOL_OUTPUT_PREVIEW_LENGTH)
-    return this.buildToolOutputStub(content.length, preview, filePath)
-  }
-
-  private buildToolOutputStub(totalLength: number, preview: string, filePath: string): string {
-    return [
-      '[Tool output offloaded]',
-      `Total characters: ${totalLength}`,
-      `Full output saved to: ${filePath}`,
-      `first ${preview.length} chars:`,
-      preview
-    ].join('\n')
-  }
-
-  private appendToolError(
-    conversationMessages: ChatMessage[],
-    modelConfig: ModelConfig,
-    toolCall: { id: string; name: string; arguments: string },
-    errorMessage: string
-  ): void {
-    if (modelConfig?.functionCall) {
-      // For native function-calling models, ensure every tool error is still paired
-      // with a preceding assistant message that declares the tool_call in tool_calls.
-      const toolCallEntry = {
-        id: toolCall.id,
-        type: 'function' as const,
-        function: {
-          name: toolCall.name,
-          arguments: toolCall.arguments
-        }
-      }
-
-      let lastAssistantMessage = conversationMessages.findLast(
-        (message) => message.role === 'assistant'
-      )
-
-      if (lastAssistantMessage) {
-        if (!lastAssistantMessage.tool_calls) {
-          lastAssistantMessage.tool_calls = []
-        }
-        lastAssistantMessage.tool_calls.push(toolCallEntry)
-      } else {
-        // Extremely defensive fallback – create a synthetic assistant message
-        // so the OpenAI API still sees a valid tool_calls declaration.
-        lastAssistantMessage = {
-          role: 'assistant',
-          tool_calls: [toolCallEntry]
-        }
-        conversationMessages.push(lastAssistantMessage)
-      }
-
-      conversationMessages.push({
-        role: 'tool',
-        content: `The tool call with ID ${toolCall.id} and name ${toolCall.name} failed to execute: ${errorMessage}`,
-        tool_call_id: toolCall.id
-      })
-      return
-    }
-
-    const formattedErrorText = `编号为 ${toolCall.id} 的工具 ${toolCall.name} 调用执行失败: ${errorMessage}`
-    let lastAssistantMessage = conversationMessages.findLast(
-      (message) => message.role === 'assistant'
-    )
-    if (lastAssistantMessage) {
-      if (typeof lastAssistantMessage.content === 'string') {
-        lastAssistantMessage.content += '\n' + formattedErrorText + '\n'
-      } else if (Array.isArray(lastAssistantMessage.content)) {
-        lastAssistantMessage.content.push({
-          type: 'text',
-          text: '\n' + formattedErrorText + '\n'
-        })
-      } else {
-        lastAssistantMessage.content = [{ type: 'text', text: '\n' + formattedErrorText + '\n' }]
-      }
-    } else {
-      conversationMessages.push({
-        role: 'assistant',
-        content: [{ type: 'text', text: formattedErrorText + '\n' }]
-      })
-    }
-
-    const userPromptText =
-      '以上是你刚调用的工具及其执行的错误信息，已帮你插入，请根据情况继续回答或重新尝试。'
-    conversationMessages.push({
-      role: 'user',
-      content: [{ type: 'text', text: userPromptText }]
-    })
-  }
-
-  private stringifyToolContent(content: unknown): string {
-    return typeof content === 'string' ? content : JSON.stringify(content)
-  }
-
-  /**
-   * Batch pre-check permissions for all tool calls
-   * Returns info about tools that need permission, or empty if all have permission
-   */
-  private async batchPreCheckPermissions(
-    context: ToolCallExecutionContext,
-    toolDefinitions: MCPToolDefinition[]
-  ): Promise<{
-    hasPendingPermissions: boolean
-    permissionRequests: PermissionRequestInfo[]
-  }> {
-    // If no permission pre-check function provided, skip batch check
-    if (!this.options.preCheckToolPermission) {
-      return { hasPendingPermissions: false, permissionRequests: [] }
-    }
-
-    const permissionRequests: PermissionRequestInfo[] = []
-    const toolNameToDefMap = new Map(toolDefinitions.map((t) => [t.function.name, t]))
-
-    for (const toolCall of context.toolCalls) {
-      const toolDef = toolNameToDefMap.get(toolCall.name)
-      if (!toolDef) continue
-
-      // Skip question tool for permission check
-      if (toolCall.name === QUESTION_TOOL_NAME) continue
-
-      const mcpToolInput: MCPToolCall = {
-        id: toolCall.id,
-        type: 'function',
-        function: {
-          name: toolCall.name,
-          arguments: toolCall.arguments
-        },
-        server: toolDef.server,
-        conversationId: context.conversationId
-      }
-
-      try {
-        const permissionResult = await this.options.preCheckToolPermission(mcpToolInput)
-        if (permissionResult) {
-          const permissionPayload: PermissionRequestPayload = {
-            ...permissionResult,
-            toolName: permissionResult.toolName || toolCall.name,
-            serverName: permissionResult.serverName || toolDef.server.name,
-            permissionType: permissionResult.permissionType,
-            description: permissionResult.description
-          }
-
-          // Preserve the full permission payload (paths and custom fields included)
-          permissionRequests.push({
-            toolCall,
-            serverName: permissionPayload.serverName,
-            serverIcons: toolDef.server?.icons,
-            serverDescription: toolDef.server?.description,
-            payload: permissionPayload
-          })
-        }
-      } catch (error) {
-        console.warn(
-          `[ToolCallProcessor] Failed to pre-check permission for ${toolCall.name}:`,
-          error
-        )
-        // If pre-check fails, we'll let the actual execution handle it
-      }
-    }
-
-    return {
-      hasPendingPermissions: permissionRequests.length > 0,
-      permissionRequests
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageBuilder.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageBuilder.ts
deleted file mode 100644
index 8599fe871..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageBuilder.ts
+++ /dev/null
@@ -1,405 +0,0 @@
-import { approximateTokenSize } from 'tokenx'
-import { AssistantMessage, Message, MessageFile, UserMessageContent } from '@shared/chat'
-import { ModelType } from '@shared/model'
-import {
-  CONVERSATION,
-  IToolPresenter,
-  ModelConfig,
-  SearchResult,
-  ChatMessage
-} from '@shared/presenter'
-import type { MCPToolDefinition } from '@shared/presenter'
-
-import { modelCapabilities } from '../../configPresenter/modelCapabilities'
-import { enhanceSystemPromptWithDateTime } from '../utility/promptEnhancer'
-import { ToolCallCenter } from '../tool/toolCallCenter'
-import { nanoid } from 'nanoid'
-
-import {
-  addContextMessages,
-  buildUserMessageContext,
-  formatMessagesForCompletion,
-  mergeConsecutiveMessages
-} from './messageFormatter'
-import { selectContextMessages } from './messageTruncator'
-import {
-  buildSkillsMetadataPrompt,
-  buildSkillsPrompt,
-  getSkillsAllowedTools
-} from './skillsPromptBuilder'
-import {
-  buildRuntimeCapabilitiesPrompt,
-  buildSystemEnvPrompt
-} from '@/lib/agentRuntime/systemEnvPromptBuilder'
-import type { AgentPromptRuntimePort } from '../runtimePorts'
-
-export type PendingToolCall = {
-  id: string
-  name: string
-  params: string
-  serverName?: string
-  serverIcons?: string
-  serverDescription?: string
-}
-
-export interface PreparePromptContentParams {
-  conversation: CONVERSATION
-  userContent: string
-  contextMessages: Message[]
-  searchResults: SearchResult[] | null
-  userMessage: Message
-  vision: boolean
-  imageFiles: MessageFile[]
-  supportsFunctionCall: boolean
-  modelType?: ModelType
-  toolPresenter: IToolPresenter
-  promptRuntime: AgentPromptRuntimePort
-}
-
-export interface ContinueToolCallContextParams {
-  conversation: CONVERSATION
-  contextMessages: Message[]
-  userMessage: Message
-  pendingToolCall: PendingToolCall
-  modelConfig: ModelConfig
-}
-
-export interface PostToolExecutionContextParams {
-  conversation: CONVERSATION
-  contextMessages: Message[]
-  userMessage: Message
-  currentAssistantMessage: AssistantMessage
-  completedToolCall: PendingToolCall & { response: string }
-  modelConfig: ModelConfig
-}
-
-function mergeToolSelections(base?: string[], extra?: string[]): string[] | undefined {
-  const merged = new Set<string>()
-  base?.forEach((tool) => merged.add(tool))
-  extra?.forEach((tool) => merged.add(tool))
-  if (merged.size === 0) {
-    return undefined
-  }
-  return Array.from(merged)
-}
-
-function appendPromptSection(base: string, section: string): string {
-  const trimmedSection = section.trim()
-  if (!trimmedSection) {
-    return base
-  }
-  if (!base) {
-    return trimmedSection
-  }
-  return `${base}\n\n${trimmedSection}`
-}
-
-export interface AgentSystemPromptSections {
-  basePrompt: string
-  runtimePrompt?: string
-  skillsMetadataPrompt?: string
-  skillsPrompt?: string
-  envPrompt?: string
-  toolingPrompt?: string
-}
-
-export function composeAgentSystemPromptSections(sections: AgentSystemPromptSections): string {
-  let composed = sections.basePrompt?.trim() ?? ''
-  composed = appendPromptSection(composed, sections.runtimePrompt ?? '')
-  composed = appendPromptSection(composed, sections.skillsMetadataPrompt ?? '')
-  composed = appendPromptSection(composed, sections.skillsPrompt ?? '')
-  composed = appendPromptSection(composed, sections.envPrompt ?? '')
-  composed = appendPromptSection(composed, sections.toolingPrompt ?? '')
-  return composed
-}
-
-export async function preparePromptContent({
-  conversation,
-  userContent,
-  contextMessages,
-  searchResults: _searchResults,
-  userMessage,
-  vision,
-  imageFiles,
-  supportsFunctionCall,
-  modelType,
-  toolPresenter,
-  promptRuntime
-}: PreparePromptContentParams): Promise<{
-  finalContent: ChatMessage[]
-  promptTokens: number
-}> {
-  const { systemPrompt, contextLength, artifacts, enabledMcpTools } = conversation.settings
-
-  function normalizeChatMode(mode: string | undefined): 'agent' | 'acp agent' | undefined {
-    if (mode === 'agent' || mode === 'acp agent') return mode
-    return undefined
-  }
-
-  const rawChatMode = conversation.settings.chatMode
-  const rawFallback = await promptRuntime.getInputChatMode()
-  const chatMode: 'agent' | 'acp agent' =
-    normalizeChatMode(rawChatMode) ?? normalizeChatMode(rawFallback) ?? 'agent'
-
-  const isImageGeneration = modelType === ModelType.ImageGeneration
-
-  const finalSystemPrompt = enhanceSystemPromptWithDateTime(systemPrompt, {
-    isImageGeneration,
-    agentWorkspacePath: conversation.settings.agentWorkspacePath?.trim() || null
-  })
-
-  const { providerId, modelId } = conversation.settings
-  const supportsVision = modelCapabilities.supportsVision(providerId, modelId)
-  const toolCallCenter = new ToolCallCenter(toolPresenter)
-  let toolDefinitions: MCPToolDefinition[] = []
-  let effectiveEnabledMcpTools = enabledMcpTools
-
-  if (!isImageGeneration && chatMode === 'agent') {
-    const skillsAllowedTools = await getSkillsAllowedTools(promptRuntime, conversation.id)
-    effectiveEnabledMcpTools = mergeToolSelections(enabledMcpTools, skillsAllowedTools)
-  }
-
-  if (!isImageGeneration) {
-    try {
-      toolDefinitions = await toolCallCenter.getAllToolDefinitions({
-        enabledMcpTools: effectiveEnabledMcpTools,
-        chatMode,
-        supportsVision,
-        agentWorkspacePath: conversation.settings.agentWorkspacePath?.trim() || null,
-        conversationId: conversation.id
-      })
-    } catch (error) {
-      console.warn('AgentPresenter: Failed to load tool definitions', error)
-      toolDefinitions = []
-    }
-  }
-
-  let runtimePrompt = ''
-  let skillsMetadataPrompt = ''
-  let skillsPrompt = ''
-  let envPrompt = ''
-  let toolingPrompt = ''
-
-  if (!isImageGeneration && chatMode === 'agent') {
-    runtimePrompt = buildRuntimeCapabilitiesPrompt()
-    try {
-      skillsMetadataPrompt = await buildSkillsMetadataPrompt(promptRuntime)
-      skillsPrompt = await buildSkillsPrompt(promptRuntime, conversation.id)
-    } catch (error) {
-      console.warn('AgentPresenter: Failed to build skills prompt', error)
-    }
-
-    try {
-      envPrompt = await buildSystemEnvPrompt({
-        providerId,
-        modelId,
-        workdir: conversation.settings.agentWorkspacePath?.trim() || null
-      })
-    } catch (error) {
-      console.warn('AgentPresenter: Failed to build system env prompt', error)
-    }
-  }
-
-  if (!isImageGeneration && toolDefinitions.length > 0) {
-    toolingPrompt = toolCallCenter.buildToolSystemPrompt({
-      conversationId: conversation.id
-    })
-  }
-
-  const finalSystemPromptWithExtras = composeAgentSystemPromptSections({
-    basePrompt: finalSystemPrompt,
-    runtimePrompt,
-    skillsMetadataPrompt,
-    skillsPrompt,
-    envPrompt,
-    toolingPrompt
-  })
-
-  const systemPromptTokens =
-    !isImageGeneration && finalSystemPromptWithExtras
-      ? approximateTokenSize(finalSystemPromptWithExtras)
-      : 0
-  const userMessageTokens = approximateTokenSize(userContent)
-  const toolDefinitionsTokens = toolDefinitions.reduce((acc, tool) => {
-    return acc + approximateTokenSize(JSON.stringify(tool))
-  }, 0)
-
-  const reservedTokens = systemPromptTokens + userMessageTokens + toolDefinitionsTokens
-  const remainingContextLength = contextLength - reservedTokens
-
-  const selectedContextMessages = selectContextMessages(
-    contextMessages,
-    userMessage,
-    remainingContextLength,
-    supportsFunctionCall,
-    vision
-  )
-
-  const formattedMessages = formatMessagesForCompletion(
-    selectedContextMessages,
-    isImageGeneration ? '' : finalSystemPromptWithExtras,
-    artifacts,
-    userContent,
-    '',
-    imageFiles,
-    vision,
-    supportsFunctionCall
-  )
-
-  const mergedMessages = mergeConsecutiveMessages(formattedMessages)
-
-  let promptTokens = 0
-  const imageTokenCost = imageFiles.reduce((acc, file) => acc + (file.token ?? 0), 0)
-  for (let i = 0; i < mergedMessages.length; i++) {
-    const msg = mergedMessages[i]
-
-    if (typeof msg.content === 'string' || msg.content === undefined) {
-      promptTokens += approximateTokenSize(msg.content || '')
-      continue
-    }
-
-    const textContent =
-      msg.content?.reduce((acc, item) => {
-        if (item.type === 'text' && typeof item.text === 'string') {
-          return acc + item.text
-        }
-        return acc
-      }, '') ?? ''
-
-    promptTokens += approximateTokenSize(textContent)
-
-    const isFinalUserWithImages =
-      i === mergedMessages.length - 1 &&
-      msg.role === 'user' &&
-      Array.isArray(msg.content) &&
-      msg.content.some((block) => block.type === 'image_url')
-
-    if (isFinalUserWithImages && imageTokenCost > 0) {
-      promptTokens += imageTokenCost
-    }
-  }
-
-  return { finalContent: mergedMessages, promptTokens }
-}
-
-export async function buildContinueToolCallContext({
-  conversation,
-  contextMessages,
-  userMessage,
-  pendingToolCall,
-  modelConfig
-}: ContinueToolCallContextParams): Promise<ChatMessage[]> {
-  const { systemPrompt } = conversation.settings
-  const formattedMessages: ChatMessage[] = []
-
-  if (systemPrompt) {
-    const finalSystemPrompt = enhanceSystemPromptWithDateTime(systemPrompt, {})
-    formattedMessages.push({
-      role: 'system',
-      content: finalSystemPrompt
-    })
-  }
-
-  const contextChatMessages = addContextMessages(contextMessages, false, modelConfig.functionCall)
-  formattedMessages.push(...contextChatMessages)
-
-  const userContent = userMessage.content as UserMessageContent
-  const finalUserContent = buildUserMessageContext(userContent)
-
-  formattedMessages.push({
-    role: 'user',
-    content: `${finalUserContent}\n\nTool call interrupted: ${pendingToolCall.name}`
-  })
-
-  return formattedMessages
-}
-
-export async function buildPostToolExecutionContext({
-  conversation,
-  contextMessages,
-  userMessage,
-  currentAssistantMessage,
-  completedToolCall,
-  modelConfig
-}: PostToolExecutionContextParams): Promise<ChatMessage[]> {
-  const { systemPrompt } = conversation.settings
-  const formattedMessages: ChatMessage[] = []
-  const supportsFunctionCall = Boolean(modelConfig?.functionCall)
-
-  if (systemPrompt) {
-    const finalSystemPrompt = enhanceSystemPromptWithDateTime(systemPrompt, {})
-    formattedMessages.push({
-      role: 'system',
-      content: finalSystemPrompt
-    })
-  }
-
-  const contextChatMessages = addContextMessages(contextMessages, false, modelConfig.functionCall)
-  formattedMessages.push(...contextChatMessages)
-
-  const userContent = userMessage.content as UserMessageContent
-  const finalUserContent = buildUserMessageContext(userContent)
-
-  formattedMessages.push({
-    role: 'user',
-    content: finalUserContent
-  })
-
-  const assistantText = currentAssistantMessage.content
-    .filter((block) => block.type === 'content')
-    .map((block) => block.content || '')
-    .join('\n')
-    .trim()
-
-  // OpenAI-compatible function-calling requires:
-  // assistant(tool_calls: [...]) -> tool(tool_call_id=...) pairing.
-  if (supportsFunctionCall) {
-    const toolCallId = completedToolCall.id || nanoid(8)
-    formattedMessages.push({
-      role: 'assistant',
-      content: assistantText || undefined,
-      tool_calls: [
-        {
-          id: toolCallId,
-          type: 'function',
-          function: {
-            name: completedToolCall.name,
-            arguments: completedToolCall.params || ''
-          }
-        }
-      ]
-    })
-
-    formattedMessages.push({
-      role: 'tool',
-      content: completedToolCall.response,
-      tool_call_id: toolCallId
-    })
-  } else {
-    const formattedToolRecordText =
-      '<function_call>' +
-      JSON.stringify({
-        function_call_record: {
-          name: completedToolCall.name,
-          arguments: completedToolCall.params,
-          response: completedToolCall.response
-        }
-      }) +
-      '</function_call>'
-
-    const combinedText = [assistantText, formattedToolRecordText].filter(Boolean).join('\n')
-    formattedMessages.push({
-      role: 'assistant',
-      content: combinedText || undefined
-    })
-
-    const userPromptText =
-      '以上是你刚执行的工具调用及其响应信息，已帮你插入，请仔细阅读工具响应，并继续你的回答。'
-    formattedMessages.push({
-      role: 'user',
-      content: userPromptText
-    })
-  }
-
-  return formattedMessages
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageCompressor.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageCompressor.ts
deleted file mode 100644
index 3ca9ea1f0..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageCompressor.ts
+++ /dev/null
@@ -1,111 +0,0 @@
-import { approximateTokenSize } from 'tokenx'
-import type { AssistantMessageBlock, Message } from '@shared/chat'
-
-function calculateToolCallBlockTokens(block: AssistantMessageBlock): number {
-  if (block.type !== 'tool_call' || !block.tool_call?.response) {
-    return 0
-  }
-
-  const nameTokens = approximateTokenSize(block.tool_call.name || '')
-  const paramsTokens = approximateTokenSize(block.tool_call.params || '')
-  const responseTokens = approximateTokenSize(block.tool_call.response || '')
-
-  return nameTokens + paramsTokens + responseTokens
-}
-
-function cloneMessageWithContent(message: Message): Message {
-  const cloned: Message = { ...message }
-
-  if (Array.isArray(message.content)) {
-    cloned.content = message.content.map((block) => {
-      const clonedBlock: AssistantMessageBlock = { ...(block as AssistantMessageBlock) }
-      if (block.type === 'tool_call' && block.tool_call) {
-        clonedBlock.tool_call = { ...block.tool_call }
-      }
-      return clonedBlock
-    })
-  } else if (message.content && typeof message.content === 'object') {
-    cloned.content = JSON.parse(JSON.stringify(message.content))
-  } else {
-    cloned.content = message.content
-  }
-
-  return cloned
-}
-
-function removeToolCallsFromAssistant(message: Message): {
-  updatedMessage: Message
-  removedTokens: number
-  removedToolCalls: number
-} {
-  if (message.role !== 'assistant' || !Array.isArray(message.content)) {
-    return { updatedMessage: message, removedTokens: 0, removedToolCalls: 0 }
-  }
-
-  const clonedMessage = cloneMessageWithContent(message)
-  const clonedContent = clonedMessage.content as AssistantMessageBlock[]
-
-  let removedTokens = 0
-  let removedToolCalls = 0
-
-  const filteredBlocks = clonedContent.filter((block) => {
-    if (block.type !== 'tool_call' || !block.tool_call) {
-      return true
-    }
-
-    removedTokens += calculateToolCallBlockTokens(block)
-    removedToolCalls += 1
-    return false
-  })
-
-  clonedMessage.content = filteredBlocks
-
-  return { updatedMessage: clonedMessage, removedTokens, removedToolCalls }
-}
-
-export function compressToolCallsFromContext(
-  messages: Message[],
-  excessTokens: number,
-  supportsFunctionCall: boolean
-): { compressedMessages: Message[]; removedTokens: number } {
-  if (!supportsFunctionCall || excessTokens <= 0) {
-    return { compressedMessages: messages, removedTokens: 0 }
-  }
-
-  const messagesToEdit = messages.map((msg) => cloneMessageWithContent(msg))
-
-  const lastUserIndex = messagesToEdit.findLastIndex((message) => message.role === 'user')
-  let removedTokens = 0
-
-  for (let i = 0; i < messagesToEdit.length; i++) {
-    if (lastUserIndex !== -1 && i >= lastUserIndex) {
-      break
-    }
-
-    const message = messagesToEdit[i]
-    if (message.role !== 'assistant') {
-      continue
-    }
-
-    const {
-      updatedMessage,
-      removedTokens: toolCallTokens,
-      removedToolCalls
-    } = removeToolCallsFromAssistant(message)
-
-    if (removedToolCalls > 0) {
-      messagesToEdit[i] = updatedMessage
-      console.debug(
-        `MessageCompressor: removed ${removedToolCalls} tool call block(s) (${toolCallTokens} tokens) from context`
-      )
-    }
-
-    removedTokens += toolCallTokens
-
-    if (removedTokens >= excessTokens) {
-      break
-    }
-  }
-
-  return { compressedMessages: messagesToEdit, removedTokens }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageTruncator.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageTruncator.ts
deleted file mode 100644
index 00767b86d..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageTruncator.ts
+++ /dev/null
@@ -1,161 +0,0 @@
-import { approximateTokenSize } from 'tokenx'
-import type { AssistantMessageBlock, Message } from '@shared/chat'
-import type { ChatMessage } from '@shared/presenter'
-import { addContextMessages } from './messageFormatter'
-import { compressToolCallsFromContext } from './messageCompressor'
-
-function calculateToolCallTokens(toolCall: NonNullable<ChatMessage['tool_calls']>[number]): number {
-  const nameTokens = approximateTokenSize(toolCall.function?.name || '')
-  const argumentsTokens = approximateTokenSize(toolCall.function?.arguments || '')
-  return nameTokens + argumentsTokens
-}
-
-function calculateMessageTokens(message: ChatMessage): number {
-  let tokens = 0
-
-  if (typeof message.content === 'string') {
-    tokens += approximateTokenSize(message.content)
-  } else if (Array.isArray(message.content)) {
-    const textContent = message.content.reduce((acc, item) => {
-      if (item.type === 'text' && typeof item.text === 'string') {
-        return acc + item.text
-      }
-      return acc
-    }, '')
-    tokens += approximateTokenSize(textContent)
-  }
-
-  if (message.role === 'assistant' && Array.isArray(message.tool_calls)) {
-    message.tool_calls.forEach((toolCall) => {
-      tokens += calculateToolCallTokens(toolCall)
-    })
-  }
-
-  return tokens
-}
-
-function calculateMessagesTokens(messages: ChatMessage[]): number {
-  return messages.reduce((acc, message) => acc + calculateMessageTokens(message), 0)
-}
-
-function cloneMessageWithContent(message: Message): Message {
-  const cloned: Message = { ...message }
-
-  if (Array.isArray(message.content)) {
-    cloned.content = message.content.map((block) => {
-      const clonedBlock: AssistantMessageBlock = { ...(block as AssistantMessageBlock) }
-      if (block.type === 'tool_call' && block.tool_call) {
-        clonedBlock.tool_call = { ...block.tool_call }
-      }
-      return clonedBlock
-    })
-  } else if (message.content && typeof message.content === 'object') {
-    cloned.content = JSON.parse(JSON.stringify(message.content))
-  } else {
-    cloned.content = message.content
-  }
-
-  return cloned
-}
-
-export function selectContextMessages(
-  contextMessages: Message[],
-  userMessage: Message,
-  remainingContextLength: number,
-  supportsFunctionCall: boolean,
-  vision: boolean
-): Message[] {
-  if (remainingContextLength <= 0) {
-    return []
-  }
-
-  const messages = contextMessages
-    .filter((msg) => msg.id !== userMessage?.id)
-    .map((msg) => cloneMessageWithContent(msg))
-    .reverse()
-  let selectedMessages = messages.filter((msg) => msg.status === 'sent')
-
-  if (selectedMessages.length === 0) {
-    return []
-  }
-
-  let chatMessages = addContextMessages(selectedMessages, vision, supportsFunctionCall)
-  let totalTokens = calculateMessagesTokens(chatMessages)
-  console.log('totalTokens', totalTokens, 'remainingContextLength', remainingContextLength)
-  if (totalTokens > remainingContextLength) {
-    let excessTokens = totalTokens - remainingContextLength
-
-    if (supportsFunctionCall) {
-      const { removedTokens } = compressToolCallsFromContext(
-        selectedMessages,
-        excessTokens,
-        supportsFunctionCall
-      )
-
-      totalTokens = Math.max(0, totalTokens - removedTokens)
-      chatMessages = addContextMessages(selectedMessages, vision, supportsFunctionCall)
-      totalTokens = calculateMessagesTokens(chatMessages)
-    }
-
-    if (totalTokens > remainingContextLength) {
-      excessTokens = totalTokens - remainingContextLength
-      let removedTokens = 0
-
-      while (removedTokens < excessTokens && selectedMessages.length > 0) {
-        const userIndex = selectedMessages.findIndex((msg) => msg.role === 'user')
-        if (userIndex === -1) {
-          break
-        }
-
-        const lastUserIndex = selectedMessages.findLastIndex((msg) => msg.role === 'user')
-        if (userIndex === lastUserIndex) {
-          break
-        }
-
-        const userMsg = selectedMessages[userIndex]
-        const matchingAssistants = selectedMessages
-          .map((msg, idx) => ({ msg, idx }))
-          .filter(({ msg }) => msg.role === 'assistant' && msg.parentId === userMsg.id)
-          .sort((a, b) => a.msg.is_variant - b.msg.is_variant)
-
-        if (matchingAssistants.length === 0) {
-          selectedMessages.splice(userIndex, 1)
-          continue
-        }
-
-        const assistantIndex = matchingAssistants[0].idx
-
-        const startIndex = Math.min(userIndex, assistantIndex)
-        const endIndex = Math.max(userIndex, assistantIndex)
-
-        const pairMessages = selectedMessages.slice(startIndex, endIndex + 1)
-        const pairTokens = calculateMessagesTokens(
-          addContextMessages(pairMessages, vision, supportsFunctionCall)
-        )
-
-        console.log(
-          `PromptBuilder: removing one user/assistant pair from context (${pairTokens} tokens)`
-        )
-
-        selectedMessages.splice(startIndex, endIndex - startIndex + 1)
-        removedTokens += pairTokens
-        totalTokens = Math.max(0, totalTokens - pairTokens)
-      }
-    }
-
-    chatMessages = addContextMessages(selectedMessages, vision, supportsFunctionCall)
-    totalTokens = calculateMessagesTokens(chatMessages)
-  }
-
-  const userIds = new Set(
-    selectedMessages.filter((msg) => msg.role === 'user').map((msg) => msg.id)
-  )
-  selectedMessages = selectedMessages.filter((msg) => {
-    if (msg.role === 'assistant') {
-      return msg.parentId && userIds.has(msg.parentId)
-    }
-    return true
-  })
-
-  return selectedMessages.reverse()
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/skillsPromptBuilder.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/skillsPromptBuilder.ts
deleted file mode 100644
index 0f868c42f..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/skillsPromptBuilder.ts
+++ /dev/null
@@ -1,86 +0,0 @@
-import type { AgentPromptRuntimePort } from '../runtimePorts'
-
-/**
- * Build the skills prompt section for the system prompt.
- * Loads active skills content and formats them for injection.
- *
- * @param conversationId - The conversation ID to get active skills for
- * @returns A formatted string containing all active skill contents, or empty string if no skills active
- */
-export async function buildSkillsPrompt(
-  promptRuntime: AgentPromptRuntimePort,
-  conversationId: string
-): Promise<string> {
-  try {
-    if (!promptRuntime.getSkillsEnabled()) {
-      return ''
-    }
-
-    const activeSkills = await promptRuntime.getActiveSkills(conversationId)
-
-    if (activeSkills.length === 0) {
-      return ''
-    }
-
-    const skillContents: string[] = []
-
-    for (const skillName of activeSkills) {
-      const skillContent = await promptRuntime.loadSkillContent(skillName)
-      if (skillContent && skillContent.content) {
-        skillContents.push(`## Skill: ${skillName}\n\n${skillContent.content}`)
-      }
-    }
-
-    if (skillContents.length === 0) {
-      return ''
-    }
-
-    return `# Active Skills\n\nThe following skills are currently active and provide specialized guidance:\n\n${skillContents.join('\n\n---\n\n')}`
-  } catch (error) {
-    console.warn('[SkillsPromptBuilder] Failed to build skills prompt:', error)
-    return ''
-  }
-}
-
-/**
- * Build the skills metadata prompt section for the system prompt.
- * Lists available skills and how to activate them.
- * Delegates to skillPresenter.getMetadataPrompt() to avoid code duplication.
- */
-export async function buildSkillsMetadataPrompt(
-  promptRuntime: AgentPromptRuntimePort
-): Promise<string> {
-  try {
-    if (!promptRuntime.getSkillsEnabled()) {
-      return ''
-    }
-
-    return await promptRuntime.getMetadataPrompt()
-  } catch (error) {
-    console.warn('[SkillsPromptBuilder] Failed to build skills metadata prompt:', error)
-    return ''
-  }
-}
-
-/**
- * Get allowed tools from active skills for a conversation.
- * Used to extend MCP tool filtering based on skill requirements.
- *
- * @param conversationId - The conversation ID
- * @returns Array of allowed tool names from active skills
- */
-export async function getSkillsAllowedTools(
-  promptRuntime: AgentPromptRuntimePort,
-  conversationId: string
-): Promise<string[]> {
-  try {
-    if (!promptRuntime.getSkillsEnabled()) {
-      return []
-    }
-
-    return await promptRuntime.getActiveSkillsAllowedTools(conversationId)
-  } catch (error) {
-    console.warn('[SkillsPromptBuilder] Failed to get skills allowed tools:', error)
-    return []
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/permission/permissionHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/permission/permissionHandler.ts
deleted file mode 100644
index 5fd0ed4b2..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/permission/permissionHandler.ts
+++ /dev/null
@@ -1,1221 +0,0 @@
-import type { AssistantMessage, AssistantMessageBlock } from '@shared/chat'
-import type { MCPToolDefinition, MCPToolResponse } from '@shared/presenter'
-import { buildPostToolExecutionContext, type PendingToolCall } from '../message/messageBuilder'
-import type { GeneratingMessageState } from '../streaming/types'
-import type { StreamGenerationHandler } from '../streaming/streamGenerationHandler'
-import type { LLMEventHandler } from '../streaming/llmEventHandler'
-import { BaseHandler, type ThreadHandlerContext } from '../types/handlerContext'
-import { CommandPermissionService } from '../../permission/commandPermissionService'
-import { eventBus, SendTarget } from '@/eventbus'
-import { STREAM_EVENTS } from '@/events'
-
-// Permission level hierarchy: all > write > read
-// 'command' is a special type that only matches itself
-const PERMISSION_LEVELS: Record<string, number> = {
-  all: 3,
-  write: 2,
-  read: 1,
-  command: 0 // command only matches command (exact match required)
-}
-
-function isPermissionSufficient(granted: string, required: string): boolean {
-  // Special case: command permission only applies to command-type permissions
-  if (granted === 'command' || required === 'command') {
-    return granted === required
-  }
-  return (PERMISSION_LEVELS[granted] || 0) >= (PERMISSION_LEVELS[required] || 0)
-}
-
-function canBatchUpdate(
-  targetPermission: AssistantMessageBlock,
-  grantedPermission: AssistantMessageBlock,
-  grantedPermissionType: string
-): boolean {
-  if (targetPermission.status !== 'pending') return false
-  if (targetPermission.action_type !== 'tool_call_permission') return false
-
-  const targetServerName = targetPermission.extra?.serverName as string
-  const grantedServerName = grantedPermission.extra?.serverName as string
-
-  // Must be same server
-  if (targetServerName !== grantedServerName) return false
-
-  // CRITICAL FIX: Only batch the exact same tool call (same tool_call.id)
-  // This ensures user approval of one tool doesn't auto-approve other tools from the same server
-  if (targetPermission.tool_call?.id !== grantedPermission.tool_call?.id) return false
-
-  // Check permission type hierarchy
-  const targetPermissionType = (targetPermission.extra?.permissionType as string) || 'read'
-  if (!isPermissionSufficient(grantedPermissionType, targetPermissionType)) return false
-
-  // For special permission types, still require exact tool call matching (already checked above)
-  const targetType = targetPermission.extra?.permissionType as string
-  if (
-    targetType === 'command' ||
-    targetServerName === 'agent-filesystem' ||
-    targetServerName === 'deepchat-settings'
-  ) {
-    // Additional safety: these types should never be batched across different tool calls
-    return targetPermission.tool_call?.id === grantedPermission.tool_call?.id
-  }
-
-  return true
-}
-
-export class PermissionHandler extends BaseHandler {
-  private readonly generatingMessages: Map<string, GeneratingMessageState>
-  private readonly streamGenerationHandler: StreamGenerationHandler
-  private readonly llmEventHandler: LLMEventHandler
-  private readonly commandPermissionHandler: CommandPermissionService
-
-  constructor(
-    context: ThreadHandlerContext,
-    options: {
-      generatingMessages: Map<string, GeneratingMessageState>
-      streamGenerationHandler: StreamGenerationHandler
-      llmEventHandler: LLMEventHandler
-      commandPermissionHandler: CommandPermissionService
-    }
-  ) {
-    super(context)
-    this.generatingMessages = options.generatingMessages
-    this.streamGenerationHandler = options.streamGenerationHandler
-    this.llmEventHandler = options.llmEventHandler
-    this.commandPermissionHandler = options.commandPermissionHandler
-    this.assertDependencies()
-  }
-
-  private assertDependencies(): void {
-    void this.generatingMessages
-    void this.streamGenerationHandler
-    void this.llmEventHandler
-    void this.commandPermissionHandler
-  }
-
-  async handlePermissionResponse(
-    messageId: string,
-    toolCallId: string,
-    granted: boolean,
-    permissionType: 'read' | 'write' | 'all' | 'command',
-    remember: boolean = true
-  ): Promise<void> {
-    console.log('[PermissionHandler] Handling permission response', {
-      messageId,
-      toolCallId,
-      granted,
-      permissionType,
-      remember
-    })
-
-    try {
-      const message = await this.ctx.messageManager.getMessage(messageId)
-      if (!message || message.role !== 'assistant') {
-        throw new Error(`Message not found or not assistant message (${messageId})`)
-      }
-
-      const conversationId = message.conversationId
-
-      // Step 1: Update permission blocks status (separate from resume)
-      const { updatedCount, targetPermissionBlock } = await this.updatePermissionBlocks(
-        messageId,
-        toolCallId,
-        granted,
-        permissionType
-      )
-
-      console.log(`[PermissionHandler] Updated ${updatedCount} permission block(s)`)
-
-      // Debug: if updatedCount is 0, print details
-      if (updatedCount === 0) {
-        const content = message.content as AssistantMessageBlock[]
-        const pendingBlocks = content.filter(
-          (b) =>
-            b.type === 'action' &&
-            b.action_type === 'tool_call_permission' &&
-            b.status === 'pending'
-        )
-        console.log(
-          '[PermissionHandler] Debug - All pending permission blocks:',
-          pendingBlocks.map((b) => ({
-            toolCallId: b.tool_call?.id,
-            status: b.status,
-            serverName: b.extra?.serverName
-          }))
-        )
-        console.log('[PermissionHandler] Debug - Looking for toolCallId:', toolCallId)
-      }
-
-      // Step 2: Remove this permission from pending list (only if we actually updated something)
-      if (updatedCount > 0) {
-        this.sessionRuntime.removePendingPermission(conversationId, messageId, toolCallId)
-        this.notifyFrontendPermissionUpdate(conversationId, messageId)
-      } else {
-        console.warn(
-          '[PermissionHandler] No permission blocks were updated, skipping removal from pending list'
-        )
-        // Still need to notify frontend to refresh in case there's a mismatch
-        this.notifyFrontendPermissionUpdate(conversationId, messageId)
-        return
-      }
-
-      // Step 3: Check if this is ACP permission (special handling)
-      if (targetPermissionBlock) {
-        const parsedPermissionRequest = this.parsePermissionRequest(targetPermissionBlock)
-        const isAcpPermission = this.isAcpPermissionBlock(
-          targetPermissionBlock,
-          parsedPermissionRequest
-        )
-
-        if (isAcpPermission) {
-          await this.handleAcpPermissionFlow(
-            messageId,
-            targetPermissionBlock,
-            parsedPermissionRequest,
-            granted
-          )
-          this.sessionRuntime.clearPendingPermission(conversationId)
-          this.sessionRuntime.setStatus(conversationId, 'generating')
-          return
-        }
-      }
-
-      // Step 4: Handle specific permission types (command, agent-filesystem, deepchat-settings)
-      if (targetPermissionBlock && permissionType === 'command') {
-        if (granted) {
-          const command = this.getCommandFromPermissionBlock(targetPermissionBlock)
-          if (!command) {
-            throw new Error(`Unable to extract command from permission block (${messageId})`)
-          }
-          const signature = this.commandPermissionHandler.extractCommandSignature(command)
-          this.commandPermissionHandler.approve(conversationId, signature, remember)
-        }
-        // Continue to check for resume (don't return early)
-      } else if (targetPermissionBlock && granted && permissionType !== 'command') {
-        const serverName = targetPermissionBlock?.extra?.serverName as string
-        if (!serverName) {
-          throw new Error(`Server name not found in permission block (${messageId})`)
-        }
-
-        if (serverName === 'agent-filesystem') {
-          const parsedPermissionRequest = this.parsePermissionRequest(targetPermissionBlock)
-          const paths = this.getStringArrayFromObject(parsedPermissionRequest, 'paths')
-          if (paths.length === 0) {
-            console.warn('[PermissionHandler] Missing filesystem paths in permission request')
-            // Mark as denied and continue
-            await this.updatePermissionBlocks(messageId, toolCallId, false, permissionType)
-          } else {
-            this.permissionRuntime.approveFileAccess?.(conversationId, paths, remember)
-          }
-        } else if (serverName === 'deepchat-settings') {
-          const parsedPermissionRequest = this.parsePermissionRequest(targetPermissionBlock)
-          const toolName =
-            this.getStringFromObject(parsedPermissionRequest, 'toolName') ||
-            this.getStringFromObject(
-              targetPermissionBlock.extra as Record<string, unknown>,
-              'toolName'
-            )
-          if (!toolName) {
-            console.warn('[PermissionHandler] Missing tool name in settings permission request')
-            await this.updatePermissionBlocks(messageId, toolCallId, false, permissionType)
-          } else {
-            this.permissionRuntime.approveSettingsAccess?.(conversationId, toolName, remember)
-          }
-        } else {
-          // MCP server permission
-          try {
-            await this.mcpRuntime.grantPermission(
-              serverName,
-              permissionType,
-              remember,
-              conversationId
-            )
-            await this.waitForMcpServiceReady(serverName)
-          } catch (error) {
-            console.error('[PermissionHandler] Failed to grant MCP permission:', error)
-            throw error
-          }
-        }
-      }
-
-      // Step 5: Check if there are still pending permissions in this message
-      const hasPendingPermissions = await this.hasPendingPermissionsInMessage(messageId)
-      if (hasPendingPermissions) {
-        console.log(
-          '[PermissionHandler] Still has pending permissions, waiting for all to be resolved'
-        )
-        // Notify frontend to refresh permission UI (show next pending permission)
-        this.notifyFrontendPermissionUpdate(conversationId, messageId)
-        return
-      }
-
-      // Step 6: All permissions resolved - try to acquire resume lock and execute
-      const lockAcquired = this.sessionRuntime.acquirePermissionResumeLock(
-        conversationId,
-        messageId
-      )
-      if (!lockAcquired) {
-        console.log('[PermissionHandler] Resume already in progress for this message, skipping')
-        return
-      }
-
-      // Step 7: Resume tool execution (idempotent - only one resume per message)
-      // Resume all resolved tool calls in this message (granted and denied handling)
-      // CRITICAL: Lock is released inside resumeToolExecutionAfterPermissions (success or error)
-      await this.resumeToolExecutionAfterPermissions(messageId, granted)
-    } catch (error) {
-      console.error('[PermissionHandler] Failed to handle permission response:', error)
-
-      // CRITICAL: Ensure lock is released on error (belt-and-suspenders approach)
-      try {
-        const conversationId = await this.getConversationIdFromMessage(messageId)
-        if (conversationId) {
-          this.sessionRuntime.releasePermissionResumeLock(conversationId)
-        }
-      } catch (lockError) {
-        console.warn('[PermissionHandler] Failed to release lock during error handling:', lockError)
-      }
-
-      try {
-        const message = await this.ctx.messageManager.getMessage(messageId)
-        if (message) {
-          await this.ctx.messageManager.handleMessageError(messageId, String(error))
-        }
-      } catch (updateError) {
-        console.error('[PermissionHandler] Failed to update message status:', updateError)
-      }
-
-      throw error
-    }
-  }
-
-  /**
-   * Update permission block(s) status
-   * Returns the number of updated blocks and the target permission block
-   */
-  private async updatePermissionBlocks(
-    messageId: string,
-    toolCallId: string,
-    granted: boolean,
-    permissionType: string
-  ): Promise<{ updatedCount: number; targetPermissionBlock: AssistantMessageBlock | undefined }> {
-    const message = await this.ctx.messageManager.getMessage(messageId)
-    if (!message || message.role !== 'assistant') {
-      throw new Error(`Message not found or not assistant message (${messageId})`)
-    }
-
-    const content = message.content as AssistantMessageBlock[]
-    const targetPermissionBlock = content.find(
-      (block) =>
-        block.type === 'action' &&
-        block.action_type === 'tool_call_permission' &&
-        block.tool_call?.id === toolCallId
-    )
-
-    if (!targetPermissionBlock) {
-      throw new Error(
-        `Permission block not found (messageId: ${messageId}, toolCallId: ${toolCallId})`
-      )
-    }
-
-    let updatedCount = 0
-
-    // Batch update: only update blocks that can be safely batched
-    for (const block of content) {
-      if (canBatchUpdate(block, targetPermissionBlock, permissionType)) {
-        block.status = granted ? 'granted' : 'denied'
-        if (block.extra) {
-          block.extra.needsUserAction = false
-          if (granted) {
-            // Only store valid MCP permission types; 'command' is handled separately
-            if (
-              permissionType === 'read' ||
-              permissionType === 'write' ||
-              permissionType === 'all'
-            ) {
-              block.extra.grantedPermissions = permissionType
-            }
-          }
-        }
-        updatedCount++
-      }
-    }
-
-    // Update generating state snapshot
-    const generatingState = this.generatingMessages.get(messageId)
-    if (generatingState) {
-      for (let i = 0; i < generatingState.message.content.length; i++) {
-        const block = generatingState.message.content[i]
-        if (
-          block.type === 'action' &&
-          block.action_type === 'tool_call_permission' &&
-          block.status === 'pending'
-        ) {
-          // Check if this block was updated in the main content
-          const updatedBlock = content.find(
-            (b) =>
-              b.type === 'action' &&
-              b.action_type === 'tool_call_permission' &&
-              b.tool_call?.id === block.tool_call?.id
-          )
-          if (updatedBlock && updatedBlock.status !== 'pending') {
-            generatingState.message.content[i] = {
-              ...block,
-              status: updatedBlock.status,
-              extra: updatedBlock.extra
-            }
-          }
-        }
-      }
-    }
-
-    await this.ctx.messageManager.editMessage(messageId, JSON.stringify(content))
-
-    return { updatedCount, targetPermissionBlock }
-  }
-
-  /**
-   * Resume stream completion when no tools need to be executed
-   */
-  private async resumeStreamCompletion(conversationId: string, messageId: string): Promise<void> {
-    // Use streamGenerationHandler's startStreamCompletion which handles the full context
-    await this.streamGenerationHandler.startStreamCompletion(conversationId, messageId)
-  }
-
-  /**
-   * Check if there are still pending permissions in the message
-   */
-  private async hasPendingPermissionsInMessage(messageId: string): Promise<boolean> {
-    const message = await this.ctx.messageManager.getMessage(messageId)
-    if (!message || message.role !== 'assistant') {
-      return false
-    }
-
-    const content = message.content as AssistantMessageBlock[]
-    return content.some(
-      (block) =>
-        block.type === 'action' &&
-        block.action_type === 'tool_call_permission' &&
-        block.status === 'pending'
-    )
-  }
-
-  /**
-   * Get conversation ID from message ID
-   */
-  private async getConversationIdFromMessage(messageId: string): Promise<string | null> {
-    const message = await this.ctx.messageManager.getMessage(messageId)
-    if (!message) {
-      return null
-    }
-    return message.conversationId
-  }
-
-  /**
-   * Resume tool execution after permission is granted
-   * CRITICAL SECTION: Lock is held throughout the entire resume flow
-   * - Early-exit checks prevent stale execution
-   * - Synchronous flush before executing tools
-   * - Lock released only at single exit point
-   * - All tools executed atomically (no lock release between tools)
-   */
-  private async resumeToolExecutionAfterPermissions(
-    messageId: string,
-    _lastGranted: boolean,
-    grantedToolCallId?: string
-  ): Promise<void> {
-    console.log(
-      '[PermissionHandler] Resuming tool execution after permissions',
-      messageId,
-      'grantedToolCallId:',
-      grantedToolCallId
-    )
-
-    const conversationId = await this.getConversationIdFromMessage(messageId)
-    if (!conversationId) {
-      throw new Error(`Message not found (${messageId})`)
-    }
-
-    // CRITICAL SECTION: Lock must be held throughout this entire method
-    // Early-exit checks: Validate session state before proceeding
-    const session = this.sessionRuntime.getSessionSync(conversationId)
-    if (!session) {
-      console.warn('[PermissionHandler] Session not found, skipping resume:', conversationId)
-      this.sessionRuntime.releasePermissionResumeLock(conversationId)
-      return
-    }
-
-    // Verify the lock is still valid (same message)
-    const currentLock = this.sessionRuntime.getPermissionResumeLock(conversationId)
-    if (!currentLock || currentLock.messageId !== messageId) {
-      console.warn(
-        '[PermissionHandler] Lock mismatch or expired, skipping resume. Expected:',
-        messageId,
-        'Got:',
-        currentLock?.messageId
-      )
-      // CRITICAL: Always release lock if we don't proceed - it was acquired in handlePermissionResponse
-      if (currentLock) {
-        this.sessionRuntime.releasePermissionResumeLock(conversationId)
-      }
-      return
-    }
-
-    // Ensure status is appropriate for tool execution
-    // Transition from waiting_permission to generating since we're resuming
-    const currentStatus = this.sessionRuntime.getStatus(conversationId)
-    if (currentStatus === 'waiting_permission') {
-      console.log('[PermissionHandler] Transitioning session from waiting_permission to generating')
-      this.sessionRuntime.setStatus(conversationId, 'generating')
-    } else if (
-      currentStatus === 'idle' &&
-      this.sessionRuntime.hasPendingPermissions(conversationId, messageId)
-    ) {
-      console.warn(
-        '[PermissionHandler] Session was idle during permission resume, forcing generating status'
-      )
-      this.sessionRuntime.setStatus(conversationId, 'generating')
-    } else if (currentStatus !== 'generating') {
-      console.warn(
-        '[PermissionHandler] Session status not suitable for resume. Status:',
-        currentStatus
-      )
-      this.sessionRuntime.releasePermissionResumeLock(conversationId)
-      return
-    }
-
-    try {
-      // Step 1: Start the agent loop with pending permissions preservation
-      // skipLockAcquisition: PermissionHandler already holds the lock
-      await this.sessionRuntime.startLoop(conversationId, messageId, {
-        preservePendingPermissions: true,
-        skipLockAcquisition: true
-      })
-
-      // Step 2: Re-fetch message to get updated permission block statuses
-      const updatedMessage = await this.ctx.messageManager.getMessage(messageId)
-      if (!updatedMessage) {
-        throw new Error(`Message not found after permission update (${messageId})`)
-      }
-
-      // Step 3: Get tool calls to execute
-      const toolCallsToExecute = this.getToolCallsToExecute(
-        updatedMessage.content as AssistantMessageBlock[],
-        grantedToolCallId
-      )
-
-      if (toolCallsToExecute.length === 0) {
-        console.log(
-          '[PermissionHandler] No tool calls to execute, continuing with stream completion'
-        )
-        await this.resumeStreamCompletion(conversationId, messageId)
-        // SINGLE EXIT POINT: Release lock
-        this.sessionRuntime.releasePermissionResumeLock(conversationId)
-        return
-      }
-
-      // Step 4: Set up generating state
-      let state = this.generatingMessages.get(messageId)
-      if (!state) {
-        state = {
-          message: updatedMessage as AssistantMessage,
-          conversationId,
-          startTime: Date.now(),
-          firstTokenTime: null,
-          promptTokens: 0,
-          reasoningStartTime: null,
-          reasoningEndTime: null,
-          lastReasoningTime: null
-        }
-        this.generatingMessages.set(messageId, state)
-      } else {
-        // CRITICAL FIX: Sync state.message.content with database to ensure tool_call blocks
-        // created by the frontend are available for processToolCallEnd to update
-        state.message.content = (updatedMessage as AssistantMessage).content
-      }
-
-      // Step 5: SYNCHRONOUS FLUSH before executing tools
-      // This ensures all pending UI updates are persisted to DB before tool execution
-      await this.llmEventHandler.flushStreamUpdates(messageId)
-
-      // Step 6: Execute tools sequentially (lock held throughout - NO RELEASE BETWEEN TOOLS)
-      let hasNewPermissionRequest = false
-      for (const toolCall of toolCallsToExecute) {
-        const canContinue = await this.executeSingleToolCall(state, toolCall, conversationId)
-
-        if (!canContinue) {
-          // Permission required again - but we keep the lock until end of critical section
-          hasNewPermissionRequest = true
-          break
-        }
-      }
-
-      // Ensure tool_call end/error updates are persisted before rebuilding next-turn context.
-      await this.llmEventHandler.flushStreamUpdates(messageId)
-
-      // Step 7: Check if there are still pending permissions
-      const stillHasPending = await this.hasPendingPermissionsInMessage(messageId)
-      if (stillHasPending || hasNewPermissionRequest) {
-        console.log(
-          '[PermissionHandler] Tool(s) executed but more permissions pending, releasing lock and waiting'
-        )
-        // SINGLE EXIT POINT: Release lock
-        this.sessionRuntime.releasePermissionResumeLock(conversationId)
-        this.notifyFrontendPermissionUpdate(conversationId, messageId)
-        return
-      }
-
-      // Step 8: All permissions resolved, continue with stream completion
-      await this.continueAfterToolsExecuted(state, conversationId, messageId)
-      // SINGLE EXIT POINT: Release lock after successful completion
-      this.sessionRuntime.releasePermissionResumeLock(conversationId)
-    } catch (error) {
-      console.error('[PermissionHandler] Failed to resume tool execution:', error)
-      this.generatingMessages.delete(messageId)
-
-      try {
-        const message = await this.ctx.messageManager.getMessage(messageId)
-        if (message) {
-          await this.ctx.messageManager.handleMessageError(messageId, String(error))
-        }
-      } catch (updateError) {
-        console.error('[PermissionHandler] Failed to update message error status:', updateError)
-      }
-
-      // SINGLE EXIT POINT: Ensure lock is released on error
-      this.sessionRuntime.releasePermissionResumeLock(conversationId)
-      throw error
-    }
-  }
-
-  /**
-   * Get tool calls that should be executed
-   * If specificToolCallId is provided, only returns that specific tool call
-   * Otherwise returns all granted tool calls
-   */
-  private getToolCallsToExecute(
-    content: AssistantMessageBlock[],
-    specificToolCallId?: string
-  ): PendingToolCall[] {
-    const toolCalls: PendingToolCall[] = []
-
-    for (const block of content) {
-      if (block.type !== 'tool_call' || !block.tool_call) continue
-
-      const toolCallId = block.tool_call.id
-      if (!toolCallId) continue
-      // Only resume unfinished tool calls.
-      // Completed blocks (success/error) are historical records and must not be re-executed.
-      if (block.status !== 'loading') continue
-
-      // If specific tool call ID is specified, only process that one
-      if (specificToolCallId && toolCallId !== specificToolCallId) {
-        continue
-      }
-
-      // Find the associated permission block
-      const permissionBlock = content.find(
-        (b) =>
-          b.type === 'action' &&
-          b.action_type === 'tool_call_permission' &&
-          b.tool_call?.id === toolCallId
-      )
-
-      // If there's a permission block, check its status
-      if (permissionBlock) {
-        if (permissionBlock.status === 'granted') {
-          const pendingCall = this.buildPendingToolCallFromBlock(block)
-          if (pendingCall) toolCalls.push(pendingCall)
-        } else if (permissionBlock.status === 'denied') {
-          // Denied - will generate error response later
-          const pendingCall = this.buildPendingToolCallFromBlock(block)
-          if (pendingCall) {
-            toolCalls.push({ ...pendingCall, denied: true } as PendingToolCall)
-          }
-        }
-        // If pending, skip (should not happen after permission resolution)
-      } else {
-        // No permission block needed - execute directly
-        const pendingCall = this.buildPendingToolCallFromBlock(block)
-        if (pendingCall) toolCalls.push(pendingCall)
-      }
-    }
-
-    console.log(
-      `[PermissionHandler] Found ${toolCalls.length} tool calls to execute` +
-        (specificToolCallId ? ` (specific: ${specificToolCallId})` : ' (all granted)')
-    )
-    return toolCalls
-  }
-
-  private buildPendingToolCallFromBlock(block: AssistantMessageBlock): PendingToolCall | undefined {
-    if (!block.tool_call) return undefined
-
-    const { id, name, params } = block.tool_call
-    if (!id || !name) {
-      console.warn('[PermissionHandler] Incomplete tool call info:', block.tool_call)
-      return undefined
-    }
-
-    return {
-      id,
-      name,
-      params: params || '{}',
-      serverName: block.tool_call.server_name,
-      serverIcons: block.tool_call.server_icons,
-      serverDescription: block.tool_call.server_description
-    }
-  }
-
-  /**
-   * Execute a single tool call
-   * Returns false if permission is required again
-   */
-  private async executeSingleToolCall(
-    state: GeneratingMessageState,
-    toolCall: PendingToolCall,
-    conversationId: string
-  ): Promise<boolean> {
-    // Check if this tool was denied
-    const message = await this.ctx.messageManager.getMessage(state.message.id)
-    if (!message) {
-      console.warn(
-        '[PermissionHandler] Message not found while executing tool call, aborting execution:',
-        state.message.id
-      )
-      return false
-    }
-    const content = message.content as AssistantMessageBlock[]
-    const permissionBlock = content.find(
-      (b) =>
-        b.type === 'action' &&
-        b.action_type === 'tool_call_permission' &&
-        b.tool_call?.id === toolCall.id
-    )
-
-    if (permissionBlock?.status === 'denied') {
-      // Generate error response for denied tool
-      await this.llmEventHandler.handleLLMAgentResponse({
-        eventId: state.message.id,
-        tool_call: 'error',
-        tool_call_id: toolCall.id,
-        tool_call_name: toolCall.name,
-        tool_call_params: toolCall.params,
-        tool_call_response: 'User denied the request.',
-        tool_call_server_name: toolCall.serverName,
-        tool_call_server_icons: toolCall.serverIcons,
-        tool_call_server_description: toolCall.serverDescription
-      } as any)
-      return true
-    }
-
-    // Normal tool execution
-    try {
-      const { conversation } = await this.streamGenerationHandler.prepareConversationContext(
-        conversationId,
-        state.message.id
-      )
-
-      let toolDef: MCPToolDefinition | undefined
-      try {
-        const { chatMode, agentWorkspacePath } = await this.sessionRuntime.resolveWorkspaceContext(
-          conversationId,
-          conversation.settings.modelId
-        )
-        const toolDefinitions = await this.toolPresenter.getAllToolDefinitions({
-          enabledMcpTools: conversation.settings.enabledMcpTools,
-          chatMode,
-          supportsVision: false,
-          agentWorkspacePath,
-          conversationId
-        })
-        toolDef = toolDefinitions.find((definition) => {
-          if (definition.function.name !== toolCall.name) return false
-          if (toolCall.serverName) {
-            return definition.server.name === toolCall.serverName
-          }
-          return true
-        })
-      } catch (error) {
-        console.error('[PermissionHandler] Failed to load tool definitions:', error)
-      }
-
-      if (!toolDef) {
-        console.warn('[PermissionHandler] Tool definition not found:', toolCall.name)
-        return true // Continue with next tool
-      }
-
-      const resolvedServer = toolDef.server
-
-      // Emit running state
-      await this.llmEventHandler.handleLLMAgentResponse({
-        eventId: state.message.id,
-        tool_call: 'running',
-        tool_call_id: toolCall.id,
-        tool_call_name: toolCall.name,
-        tool_call_params: toolCall.params,
-        tool_call_server_name: resolvedServer?.name || toolCall.serverName,
-        tool_call_server_icons: resolvedServer?.icons || toolCall.serverIcons,
-        tool_call_server_description: resolvedServer?.description || toolCall.serverDescription
-      } as any)
-
-      // Execute tool
-      let toolContent = ''
-      let toolRawData: MCPToolResponse | null = null
-      try {
-        const toolCallResult = await this.toolPresenter.callTool({
-          id: toolCall.id,
-          type: 'function',
-          function: {
-            name: toolCall.name,
-            arguments: toolCall.params
-          },
-          server: resolvedServer,
-          conversationId
-        })
-        toolContent =
-          typeof toolCallResult.content === 'string'
-            ? toolCallResult.content
-            : JSON.stringify(toolCallResult.content)
-        toolRawData = toolCallResult.rawData
-      } catch (toolError) {
-        console.error('[PermissionHandler] Failed to execute tool:', toolError)
-        await this.llmEventHandler.handleLLMAgentResponse({
-          eventId: state.message.id,
-          tool_call: 'error',
-          tool_call_id: toolCall.id,
-          tool_call_name: toolCall.name,
-          tool_call_params: toolCall.params,
-          tool_call_response: toolError instanceof Error ? toolError.message : String(toolError),
-          tool_call_server_name: resolvedServer?.name || toolCall.serverName,
-          tool_call_server_icons: resolvedServer?.icons || toolCall.serverIcons,
-          tool_call_server_description: resolvedServer?.description || toolCall.serverDescription
-        } as any)
-        return true // Continue with next tool
-      }
-
-      // Check if permission is required again
-      if (toolRawData?.requiresPermission) {
-        // Add this permission to pending list and set session status
-        this.sessionRuntime.addPendingPermission(conversationId, {
-          messageId: state.message.id,
-          toolCallId: toolCall.id,
-          permissionType:
-            (toolRawData.permissionRequest?.permissionType as
-              | 'read'
-              | 'write'
-              | 'all'
-              | 'command') || 'read',
-          payload: toolRawData.permissionRequest ?? {}
-        })
-        this.sessionRuntime.setStatus(conversationId, 'waiting_permission')
-
-        await this.llmEventHandler.handleLLMAgentResponse({
-          eventId: state.message.id,
-          tool_call: 'permission-required',
-          tool_call_id: toolCall.id,
-          tool_call_name: toolCall.name,
-          tool_call_params: toolCall.params,
-          tool_call_server_name:
-            toolRawData.permissionRequest?.serverName ||
-            resolvedServer?.name ||
-            toolCall.serverName,
-          tool_call_server_icons: resolvedServer?.icons || toolCall.serverIcons,
-          tool_call_server_description: resolvedServer?.description || toolCall.serverDescription,
-          tool_call_response: toolContent,
-          permission_request: toolRawData.permissionRequest
-        } as any)
-        return false // Stop execution, permission required
-      }
-
-      // Tool completed successfully
-      await this.llmEventHandler.handleLLMAgentResponse({
-        eventId: state.message.id,
-        tool_call: 'end',
-        tool_call_id: toolCall.id,
-        tool_call_name: toolCall.name,
-        tool_call_params: toolCall.params,
-        tool_call_response: toolContent,
-        tool_call_server_name: resolvedServer?.name || toolCall.serverName,
-        tool_call_server_icons: resolvedServer?.icons || toolCall.serverIcons,
-        tool_call_server_description: resolvedServer?.description || toolCall.serverDescription,
-        tool_call_response_raw: toolRawData ?? undefined
-      } as any)
-
-      return true
-    } catch (error) {
-      console.error('[PermissionHandler] Error executing single tool call:', error)
-      return true // Continue with next tool
-    }
-  }
-
-  /**
-   * Continue with model generation after all tools are executed
-   */
-  private async continueAfterToolsExecuted(
-    _state: GeneratingMessageState,
-    conversationId: string,
-    messageId: string
-  ): Promise<void> {
-    // Simplified: use streamGenerationHandler which handles full context
-    await this.streamGenerationHandler.startStreamCompletion(conversationId, messageId)
-  }
-
-  /**
-   * Restart agent loop after permission is granted
-   * UNIFIED FLOW: Uses resumeToolExecutionAfterPermissions for all cases
-   */
-  async restartAgentLoopAfterPermission(messageId: string, toolCallId?: string): Promise<void> {
-    console.log('[PermissionHandler] Restarting agent loop after permission', messageId)
-
-    try {
-      const message = await this.ctx.messageManager.getMessage(messageId)
-      if (!message) {
-        throw new Error(`Message not found (${messageId})`)
-      }
-
-      // const conversationId = message.conversationId
-
-      // Check server permissions for logging/debugging
-      const content = message.content as AssistantMessageBlock[]
-      const permissionBlock = content.find(
-        (block) =>
-          block.type === 'action' &&
-          block.action_type === 'tool_call_permission' &&
-          block.tool_call?.id === toolCallId
-      )
-
-      if (permissionBlock?.extra?.serverName) {
-        try {
-          const servers = await this.ctx.configPresenter.getMcpServers()
-          const serverConfig = servers[permissionBlock.extra.serverName as string]
-          console.log('[PermissionHandler] Server permissions:', serverConfig?.autoApprove || [])
-        } catch (configError) {
-          console.warn('[PermissionHandler] Failed to verify server permissions:', configError)
-        }
-      }
-
-      if (!permissionBlock) {
-        console.warn('[PermissionHandler] Granted permission block missing; continuing', messageId)
-      }
-
-      // UNIFIED FLOW: Use resumeToolExecutionAfterPermissions for all cases
-      // This method handles:
-      // 1. Setting up the generating state
-      // 2. Finding and executing all granted tool calls
-      // 3. Continuing with stream completion
-      await this.resumeToolExecutionAfterPermissions(messageId, true)
-    } catch (error) {
-      console.error('[PermissionHandler] Failed to restart agent loop:', error)
-      this.generatingMessages.delete(messageId)
-
-      try {
-        await this.ctx.messageManager.handleMessageError(messageId, String(error))
-      } catch (updateError) {
-        console.error('[PermissionHandler] Failed to update message error status:', updateError)
-      }
-
-      throw error
-    }
-  }
-
-  async continueAfterPermissionDenied(
-    messageId: string,
-    resolvedPermissionBlock?: AssistantMessageBlock
-  ): Promise<void> {
-    console.log('[PermissionHandler] Continuing after permission denied', messageId)
-
-    try {
-      const message = await this.ctx.messageManager.getMessage(messageId)
-      if (!message || message.role !== 'assistant') {
-        throw new Error(`Message not found or not assistant (${messageId})`)
-      }
-
-      const conversationId = message.conversationId
-      // Permission denied flow: skip lock acquisition (not part of permission resume critical section)
-      await this.sessionRuntime.startLoop(conversationId, messageId, {
-        preservePendingPermissions: true,
-        skipLockAcquisition: true
-      })
-      const content = message.content as AssistantMessageBlock[]
-      const deniedPermissionBlock =
-        resolvedPermissionBlock ||
-        content.find(
-          (block) =>
-            block.type === 'action' &&
-            block.action_type === 'tool_call_permission' &&
-            block.status === 'denied'
-        )
-
-      if (!deniedPermissionBlock?.tool_call) {
-        console.warn('[PermissionHandler] No denied permission block for', messageId)
-        return
-      }
-
-      const toolCall = deniedPermissionBlock.tool_call
-      const errorMessage = 'User denied the request.'
-
-      let state = this.generatingMessages.get(messageId)
-      if (!state) {
-        state = {
-          message: message as AssistantMessage,
-          conversationId,
-          startTime: Date.now(),
-          firstTokenTime: null,
-          promptTokens: 0,
-          reasoningStartTime: null,
-          reasoningEndTime: null,
-          lastReasoningTime: null
-        }
-        this.generatingMessages.set(messageId, state)
-      }
-
-      state.pendingToolCall = undefined
-
-      await this.llmEventHandler.handleLLMAgentResponse({
-        eventId: messageId,
-        tool_call: 'error',
-        tool_call_id: toolCall.id,
-        tool_call_name: toolCall.name,
-        tool_call_params: toolCall.params,
-        tool_call_response: errorMessage,
-        tool_call_server_name: toolCall.server_name,
-        tool_call_server_icons: toolCall.server_icons,
-        tool_call_server_description: toolCall.server_description
-      } as any)
-
-      const { conversation, contextMessages, userMessage } =
-        await this.streamGenerationHandler.prepareConversationContext(conversationId, messageId)
-
-      const {
-        providerId,
-        modelId,
-        temperature,
-        maxTokens,
-        enabledMcpTools,
-        thinkingBudget,
-        reasoningEffort,
-        verbosity
-      } = conversation.settings
-
-      const modelConfig = this.ctx.configPresenter.getModelConfig(modelId, providerId)
-      const completedToolCall = {
-        id: toolCall.id || '',
-        name: toolCall.name || '',
-        params: toolCall.params || '',
-        response: errorMessage,
-        serverName: toolCall.server_name,
-        serverIcons: toolCall.server_icons,
-        serverDescription: toolCall.server_description
-      }
-
-      const finalContent = await buildPostToolExecutionContext({
-        conversation,
-        contextMessages,
-        userMessage,
-        currentAssistantMessage: state.message,
-        completedToolCall,
-        modelConfig
-      })
-
-      const stream = this.llmProviderPresenter.startStreamCompletion(
-        providerId,
-        finalContent,
-        modelId,
-        messageId,
-        temperature,
-        maxTokens,
-        enabledMcpTools,
-        thinkingBudget,
-        reasoningEffort,
-        verbosity,
-        conversation.id
-      )
-
-      for await (const event of stream) {
-        const msg = event.data
-        if (event.type === 'response') {
-          await this.llmEventHandler.handleLLMAgentResponse(msg)
-        } else if (event.type === 'error') {
-          await this.llmEventHandler.handleLLMAgentError(msg)
-        } else if (event.type === 'end') {
-          await this.llmEventHandler.handleLLMAgentEnd(msg)
-        }
-      }
-    } catch (error) {
-      console.error('[PermissionHandler] Failed to continue after permission denied:', error)
-      this.generatingMessages.delete(messageId)
-
-      try {
-        await this.ctx.messageManager.handleMessageError(messageId, String(error))
-      } catch (updateError) {
-        console.error('[PermissionHandler] Failed to update message error status:', updateError)
-      }
-
-      throw error
-    }
-  }
-
-  async waitForMcpServiceReady(serverName: string, maxWaitTime: number = 3000): Promise<void> {
-    const startTime = Date.now()
-    const checkInterval = 100
-
-    return new Promise((resolve) => {
-      const checkReady = async () => {
-        try {
-          const isRunning = await this.mcpRuntime.isServerRunning(serverName)
-          if (isRunning) {
-            setTimeout(() => resolve(), 200)
-            return
-          }
-
-          if (Date.now() - startTime > maxWaitTime) {
-            console.warn('[PermissionHandler] Timeout waiting for MCP service', serverName)
-            resolve()
-            return
-          }
-
-          setTimeout(checkReady, checkInterval)
-        } catch (error) {
-          console.error('[PermissionHandler] Error checking MCP service status:', error)
-          resolve()
-        }
-      }
-
-      checkReady()
-    })
-  }
-
-  private parsePermissionRequest(block: AssistantMessageBlock): Record<string, unknown> | null {
-    const raw = this.getExtraString(block, 'permissionRequest')
-    if (!raw) {
-      return null
-    }
-    try {
-      return JSON.parse(raw) as Record<string, unknown>
-    } catch (error) {
-      console.warn('[PermissionHandler] Failed to parse permissionRequest payload:', error)
-      return null
-    }
-  }
-
-  private isAcpPermissionBlock(
-    block: AssistantMessageBlock,
-    permissionRequest: Record<string, unknown> | null
-  ): boolean {
-    const providerIdFromExtra = this.getExtraString(block, 'providerId')
-    const providerIdFromPayload = this.getStringFromObject(permissionRequest, 'providerId')
-    return providerIdFromExtra === 'acp' || providerIdFromPayload === 'acp'
-  }
-
-  private async handleAcpPermissionFlow(
-    messageId: string,
-    block: AssistantMessageBlock,
-    permissionRequest: Record<string, unknown> | null,
-    granted: boolean
-  ): Promise<void> {
-    const requestId =
-      this.getExtraString(block, 'permissionRequestId') ||
-      this.getStringFromObject(permissionRequest, 'requestId')
-
-    if (!requestId) {
-      throw new Error(`Missing ACP permission request identifier for message ${messageId}`)
-    }
-
-    await this.ctx.llmProviderPresenter.resolveAgentPermission(requestId, granted)
-  }
-
-  private getExtraString(block: AssistantMessageBlock, key: string): string | undefined {
-    const extraValue = block.extra?.[key]
-    return typeof extraValue === 'string' ? extraValue : undefined
-  }
-
-  private getStringFromObject(
-    source: Record<string, unknown> | null,
-    key: string
-  ): string | undefined {
-    if (!source) {
-      return undefined
-    }
-    const value = source[key]
-    return typeof value === 'string' ? value : undefined
-  }
-
-  private getStringArrayFromObject(source: Record<string, unknown> | null, key: string): string[] {
-    if (!source) return []
-    const value = source[key]
-    if (!Array.isArray(value)) return []
-    return value.filter(
-      (entry): entry is string => typeof entry === 'string' && entry.trim().length > 0
-    )
-  }
-
-  private getCommandFromPermissionBlock(block: AssistantMessageBlock): string | undefined {
-    const extraCommandInfo = this.getExtraString(block, 'commandInfo')
-    if (extraCommandInfo) {
-      try {
-        const parsed = JSON.parse(extraCommandInfo) as { command?: string }
-        if (parsed?.command) {
-          return parsed.command
-        }
-      } catch (error) {
-        console.warn('[PermissionHandler] Failed to parse commandInfo:', error)
-      }
-    }
-
-    const permissionRequest = this.parsePermissionRequest(block)
-    const commandFromRequest = this.getStringFromObject(permissionRequest, 'command')
-    if (commandFromRequest) {
-      return commandFromRequest
-    }
-
-    const commandInfoFromRequest = permissionRequest?.commandInfo
-    if (commandInfoFromRequest && typeof commandInfoFromRequest === 'object') {
-      const commandValue = (commandInfoFromRequest as { command?: unknown }).command
-      if (typeof commandValue === 'string') {
-        return commandValue
-      }
-    }
-
-    const params = block.tool_call?.params
-    if (typeof params === 'string' && params.trim()) {
-      try {
-        const parsed = JSON.parse(params) as { command?: string }
-        if (typeof parsed.command === 'string') {
-          return parsed.command
-        }
-      } catch {
-        // Ignore parse errors; fall through to return undefined.
-      }
-    }
-
-    console.warn('[PermissionHandler] No command found in permission block')
-    return undefined
-  }
-
-  /**
-   * Notify frontend to refresh permission UI
-   * Called when a permission is processed and there may be more pending permissions
-   */
-  private notifyFrontendPermissionUpdate(conversationId: string, messageId: string): void {
-    try {
-      const pendingPermissions = this.sessionRuntime.getPendingPermissions(conversationId) ?? []
-      const nextPermission = pendingPermissions[0]
-      console.log('[PermissionHandler] Notifying frontend of permission update:', {
-        conversationId,
-        messageId,
-        remainingCount: pendingPermissions.length,
-        nextToolCallId: nextPermission?.toolCallId
-      })
-      // Always notify so renderer can clear stale permission UI when count becomes zero.
-      eventBus.sendToRenderer(STREAM_EVENTS.PERMISSION_UPDATED, SendTarget.ALL_WINDOWS, {
-        conversationId,
-        messageId,
-        type: 'permission_update',
-        pendingCount: pendingPermissions.length,
-        nextPermission
-      })
-    } catch (error) {
-      console.error('[PermissionHandler] Failed to notify frontend:', error)
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/persistence/index.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/persistence/index.ts
deleted file mode 100644
index 336ce12bb..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/persistence/index.ts
+++ /dev/null
@@ -1 +0,0 @@
-export {}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/runtimePorts.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/runtimePorts.ts
deleted file mode 100644
index f10baf47d..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/runtimePorts.ts
+++ /dev/null
@@ -1,46 +0,0 @@
-import type {
-  IFilePresenter,
-  ILlmProviderPresenter,
-  IMCPPresenter,
-  IWindowPresenter,
-  IYoBrowserPresenter
-} from '@shared/presenter'
-import type { ISkillPresenter, SkillContent } from '@shared/types/skill'
-
-export interface AgentMcpRuntimePort {
-  callTool: IMCPPresenter['callTool']
-  grantPermission: IMCPPresenter['grantPermission']
-  isServerRunning: IMCPPresenter['isServerRunning']
-}
-
-export interface AgentPromptRuntimePort {
-  getInputChatMode(): Promise<string | undefined>
-  getSkillsEnabled(): boolean
-  getActiveSkills(conversationId: string): Promise<string[]>
-  loadSkillContent(name: string): Promise<SkillContent | null>
-  getMetadataPrompt(): Promise<string>
-  getActiveSkillsAllowedTools(conversationId: string): Promise<string[]>
-}
-
-export interface AgentPermissionRuntimePort {
-  approveFileAccess?(conversationId: string, paths: string[], remember: boolean): void
-  getApprovedFilePaths?(conversationId: string): string[]
-  approveSettingsAccess?(conversationId: string, toolName: string, remember: boolean): void
-  consumeSettingsApproval?(conversationId: string, toolName: string): boolean
-}
-
-export interface AgentToolRuntimePort {
-  resolveConversationWorkdir(conversationId: string): Promise<string | null>
-  getSkillPresenter(): ISkillPresenter
-  getYoBrowserToolHandler(): IYoBrowserPresenter['toolHandler']
-  getFilePresenter(): Pick<IFilePresenter, 'getMimeType' | 'prepareFileCompletely'>
-  getLlmProviderPresenter(): Pick<ILlmProviderPresenter, 'generateCompletionStandalone'>
-  createSettingsWindow(): ReturnType<IWindowPresenter['createSettingsWindow']>
-  sendToWindow(
-    windowId: number,
-    channel: string,
-    ...args: unknown[]
-  ): ReturnType<IWindowPresenter['sendToWindow']>
-  getApprovedFilePaths?(conversationId: string): string[]
-  consumeSettingsApproval?(conversationId: string, toolName: string): boolean
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionContext.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionContext.ts
deleted file mode 100644
index 86f3e009a..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionContext.ts
+++ /dev/null
@@ -1,53 +0,0 @@
-export type SessionStatus =
-  | 'idle'
-  | 'generating'
-  | 'paused'
-  | 'waiting_permission'
-  | 'waiting_question'
-  | 'error'
-
-export type SessionContextResolved = {
-  chatMode: 'agent' | 'acp agent'
-  providerId: string
-  modelId: string
-  supportsVision: boolean
-  supportsFunctionCall: boolean
-  agentWorkspacePath: string | null
-  enabledMcpTools?: string[]
-  acpWorkdirMap?: Record<string, string | null>
-}
-
-export type PendingPermission = {
-  messageId: string
-  toolCallId: string
-  permissionType: 'read' | 'write' | 'all' | 'command'
-  payload: unknown
-}
-
-export type PermissionResumeLock = {
-  messageId: string
-  startedAt: number
-}
-
-export type SessionContext = {
-  sessionId: string
-  agentId: string
-  status: SessionStatus
-  createdAt: number
-  updatedAt: number
-  resolved: SessionContextResolved
-  runtime?: {
-    loopId?: string
-    currentMessageId?: string
-    toolCallCount: number
-    userStopRequested: boolean
-    pendingPermission?: PendingPermission
-    pendingPermissions?: PendingPermission[]
-    permissionResumeLock?: PermissionResumeLock
-    pendingQuestion?: {
-      messageId: string
-      toolCallId: string
-    }
-    pendingQuestionInitialized?: boolean
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionManager.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionManager.ts
deleted file mode 100644
index 6b571d758..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionManager.ts
+++ /dev/null
@@ -1,438 +0,0 @@
-import fs from 'fs'
-import path from 'path'
-import { app } from 'electron'
-import type { IConfigPresenter, ISessionPresenter } from '@shared/presenter'
-import type { AssistantMessageBlock } from '@shared/chat'
-import type {
-  PendingPermission,
-  SessionContext,
-  SessionContextResolved,
-  SessionStatus
-} from './sessionContext'
-import { resolveSessionContext, type ChatMode } from './sessionResolver'
-
-type WorkspaceContext = {
-  chatMode: ChatMode
-  agentWorkspacePath: string | null
-}
-
-interface SessionManagerOptions {
-  configPresenter: IConfigPresenter
-  sessionPresenter: ISessionPresenter
-}
-
-export class SessionManager {
-  private readonly sessions = new Map<string, SessionContext>()
-  private readonly options: SessionManagerOptions
-
-  constructor(options: SessionManagerOptions) {
-    this.options = options
-  }
-
-  /**
-   * Sessions are keyed by agentId (conversationId in agent/chat flows).
-   * ACP sessions use AcpSessionManager with separate ACP session IDs.
-   */
-  getSessionSync(agentId: string): SessionContext | null {
-    return this.sessions.get(agentId) ?? null
-  }
-
-  /** Resolves (or creates) the session keyed by agentId/conversationId. */
-  async getSession(agentId: string): Promise<SessionContext> {
-    const existing = this.sessions.get(agentId)
-    const resolved = await this.resolveSession(agentId)
-    const now = Date.now()
-
-    if (existing) {
-      existing.resolved = resolved
-      existing.updatedAt = now
-      this.ensureRuntime(existing)
-      await this.hydratePendingQuestion(existing)
-      return existing
-    }
-
-    const session: SessionContext = {
-      sessionId: agentId,
-      agentId,
-      status: 'idle',
-      createdAt: now,
-      updatedAt: now,
-      resolved,
-      runtime: {
-        toolCallCount: 0,
-        userStopRequested: false
-      }
-    }
-    this.sessions.set(agentId, session)
-    await this.hydratePendingQuestion(session)
-    return session
-  }
-
-  async resolveSession(agentId: string): Promise<SessionContextResolved> {
-    const conversation = await this.options.sessionPresenter.getConversation(agentId)
-    const rawFallback = this.options.configPresenter.getSetting('input_chatMode') as
-      | string
-      | undefined
-    const modelConfig = this.options.configPresenter.getModelDefaultConfig(
-      conversation.settings.modelId,
-      conversation.settings.providerId
-    )
-
-    const resolved = resolveSessionContext({
-      settings: conversation.settings,
-      fallbackChatMode: rawFallback === 'acp agent' ? 'acp agent' : undefined,
-      modelConfig
-    })
-
-    if (resolved.needsMigration) {
-      try {
-        await this.options.sessionPresenter.updateConversationSettings(agentId, {
-          chatMode: 'agent'
-        })
-      } catch (error) {
-        console.warn('[SessionManager] Failed to migrate legacy chatMode:', error)
-      }
-    }
-
-    if (rawFallback === 'chat') {
-      try {
-        await this.options.configPresenter.setSetting('input_chatMode', 'agent')
-      } catch (error) {
-        console.warn('[SessionManager] Failed to migrate legacy input_chatMode:', error)
-      }
-    }
-
-    if (resolved.chatMode === 'agent') {
-      resolved.agentWorkspacePath = await this.resolveAgentWorkspacePath(
-        agentId,
-        conversation.settings.agentWorkspacePath ?? null
-      )
-    } else if (resolved.chatMode === 'acp agent') {
-      const modelId = conversation.settings.modelId
-      resolved.agentWorkspacePath =
-        modelId && conversation.settings.acpWorkdirMap
-          ? (conversation.settings.acpWorkdirMap[modelId] ?? null)
-          : null
-      resolved.acpWorkdirMap = conversation.settings.acpWorkdirMap
-    } else {
-      resolved.agentWorkspacePath = null
-    }
-
-    return resolved
-  }
-
-  async resolveWorkspaceContext(
-    conversationId?: string,
-    modelId?: string
-  ): Promise<WorkspaceContext> {
-    if (!conversationId) {
-      const rawFallback = this.options.configPresenter.getSetting('input_chatMode') as
-        | string
-        | undefined
-      const fallbackChatMode: ChatMode = rawFallback === 'acp agent' ? 'acp agent' : 'agent'
-      return { chatMode: fallbackChatMode, agentWorkspacePath: null }
-    }
-
-    try {
-      const session = await this.getSession(conversationId)
-      const resolved = session.resolved
-      if (resolved.chatMode === 'acp agent') {
-        const resolvedModelId = modelId ?? resolved.modelId
-        const map = resolved.acpWorkdirMap
-        const agentWorkspacePath = resolvedModelId && map ? (map[resolvedModelId] ?? null) : null
-        return { chatMode: resolved.chatMode, agentWorkspacePath }
-      }
-
-      return {
-        chatMode: resolved.chatMode,
-        agentWorkspacePath: resolved.agentWorkspacePath ?? null
-      }
-    } catch (error) {
-      console.warn('[SessionManager] Failed to resolve workspace context:', error)
-      const rawFallback = this.options.configPresenter.getSetting('input_chatMode') as
-        | string
-        | undefined
-      const fallbackChatMode: ChatMode = rawFallback === 'acp agent' ? 'acp agent' : 'agent'
-      return { chatMode: fallbackChatMode, agentWorkspacePath: null }
-    }
-  }
-
-  async startLoop(
-    agentId: string,
-    messageId: string,
-    options?: { preservePendingPermissions?: boolean; skipLockAcquisition?: boolean }
-  ): Promise<void> {
-    const session = await this.getSession(agentId)
-    session.status = 'generating'
-    session.updatedAt = Date.now()
-    const runtime = this.ensureRuntime(session)
-    runtime.loopId = messageId
-    runtime.currentMessageId = messageId
-    runtime.toolCallCount = 0
-    runtime.userStopRequested = false
-
-    // CRITICAL: Acquire permission resume lock BEFORE clearing pending permissions
-    // This ensures atomic state transition during permission resume flow
-    // skipLockAcquisition is used when PermissionHandler already holds the lock
-    if (!options?.skipLockAcquisition) {
-      const hasExistingLock = this.acquirePermissionResumeLock(agentId, messageId)
-      if (!hasExistingLock) {
-        console.warn(
-          `[SessionManager] Lock already exists for message ${messageId}, skipping startLoop initialization`
-        )
-        return
-      }
-    }
-
-    // CRITICAL: Only clear pending permissions if not preserving them
-    // This is essential for multi-tool permission scenarios where we need to
-    // execute one tool while waiting for approval of others
-    if (!options?.preservePendingPermissions) {
-      runtime.pendingPermission = undefined
-      runtime.pendingPermissions = undefined
-    }
-    runtime.pendingQuestion = undefined
-
-    // Note: lock is held via permissionResumeLock, will be released in PermissionHandler
-    // after all tools in this resume batch are processed
-  }
-
-  setStatus(agentId: string, status: SessionStatus): void {
-    const session = this.sessions.get(agentId)
-    if (!session) return
-    session.status = status
-    session.updatedAt = Date.now()
-  }
-
-  getStatus(agentId: string): SessionStatus | null {
-    const session = this.sessions.get(agentId)
-    if (!session) return null
-    return session.status
-  }
-
-  updateRuntime(agentId: string, updates: Partial<SessionContext['runtime']>): void {
-    const session = this.sessions.get(agentId)
-    if (!session) return
-    const runtime = this.ensureRuntime(session)
-    session.runtime = { ...runtime, ...updates }
-    session.updatedAt = Date.now()
-  }
-
-  incrementToolCallCount(agentId: string): void {
-    const session = this.sessions.get(agentId)
-    if (!session) return
-    const runtime = this.ensureRuntime(session)
-    runtime.toolCallCount = (runtime.toolCallCount ?? 0) + 1
-    session.updatedAt = Date.now()
-  }
-
-  clearPendingPermission(agentId: string): void {
-    this.updateRuntime(agentId, { pendingPermission: undefined, pendingPermissions: undefined })
-  }
-
-  clearPendingQuestion(agentId: string): void {
-    this.updateRuntime(agentId, { pendingQuestion: undefined })
-  }
-
-  addPendingPermission(agentId: string, permission: PendingPermission): void {
-    const session = this.sessions.get(agentId)
-    if (!session) return
-    const runtime = this.ensureRuntime(session)
-    if (!runtime.pendingPermissions) {
-      runtime.pendingPermissions = []
-    }
-    const existingIndex = runtime.pendingPermissions.findIndex(
-      (p) => p.messageId === permission.messageId && p.toolCallId === permission.toolCallId
-    )
-    if (existingIndex >= 0) {
-      runtime.pendingPermissions[existingIndex] = permission
-    } else {
-      runtime.pendingPermissions.push(permission)
-    }
-    runtime.pendingPermission = runtime.pendingPermissions[0]
-    session.updatedAt = Date.now()
-  }
-
-  removePendingPermission(agentId: string, messageId: string, toolCallId: string): void {
-    const session = this.sessions.get(agentId)
-    if (!session) return
-    const runtime = this.ensureRuntime(session)
-    if (runtime.pendingPermissions) {
-      runtime.pendingPermissions = runtime.pendingPermissions.filter(
-        (p) => !(p.messageId === messageId && p.toolCallId === toolCallId)
-      )
-      runtime.pendingPermission = runtime.pendingPermissions[0]
-    }
-    session.updatedAt = Date.now()
-  }
-
-  getPendingPermissions(agentId: string): PendingPermission[] | undefined {
-    const session = this.sessions.get(agentId)
-    if (!session) return undefined
-    const runtime = this.ensureRuntime(session)
-    return runtime.pendingPermissions
-  }
-
-  hasPendingPermissions(agentId: string, messageId?: string): boolean {
-    const pendingPerms = this.getPendingPermissions(agentId)
-    if (!pendingPerms || pendingPerms.length === 0) return false
-    if (messageId) {
-      return pendingPerms.some((p) => p.messageId === messageId)
-    }
-    return true
-  }
-
-  acquirePermissionResumeLock(agentId: string, messageId: string): boolean {
-    const session = this.sessions.get(agentId)
-    if (!session) return false
-    const runtime = this.ensureRuntime(session)
-    if (runtime.permissionResumeLock?.messageId === messageId) {
-      return false
-    }
-    runtime.permissionResumeLock = { messageId, startedAt: Date.now() }
-    session.updatedAt = Date.now()
-    return true
-  }
-
-  releasePermissionResumeLock(agentId: string): void {
-    this.updateRuntime(agentId, { permissionResumeLock: undefined })
-  }
-
-  private ensureRuntime(session: SessionContext): NonNullable<SessionContext['runtime']> {
-    if (!session.runtime) {
-      session.runtime = {
-        toolCallCount: 0,
-        userStopRequested: false
-      }
-    } else {
-      if (session.runtime.toolCallCount === undefined) {
-        session.runtime.toolCallCount = 0
-      }
-      if (session.runtime.userStopRequested === undefined) {
-        session.runtime.userStopRequested = false
-      }
-    }
-    return session.runtime
-  }
-
-  getPermissionResumeLock(agentId: string): { messageId: string; startedAt: number } | undefined {
-    const session = this.sessions.get(agentId)
-    if (!session) return undefined
-    const runtime = this.ensureRuntime(session)
-    return runtime.permissionResumeLock
-  }
-
-  /**
-   * Remove a session and clean up all pending state.
-   * Critical for preventing stale permission data from affecting new sessions.
-   */
-  removeSession(agentId: string): void {
-    const session = this.sessions.get(agentId)
-    if (session?.runtime) {
-      // Clear pending permissions to prevent stale data
-      session.runtime.pendingPermissions = undefined
-      session.runtime.pendingPermission = undefined
-      // Clear permission resume lock
-      session.runtime.permissionResumeLock = undefined
-      // Clear pending question
-      session.runtime.pendingQuestion = undefined
-    }
-    this.sessions.delete(agentId)
-  }
-
-  private async hydratePendingQuestion(session: SessionContext): Promise<void> {
-    const runtime = this.ensureRuntime(session)
-    if (runtime.pendingQuestionInitialized) return
-    runtime.pendingQuestionInitialized = true
-    if (runtime.pendingQuestion) return
-
-    try {
-      const lastAssistant = await this.options.sessionPresenter.getLastAssistantMessage(
-        session.agentId
-      )
-      if (!lastAssistant || lastAssistant.role !== 'assistant') {
-        return
-      }
-
-      const blocks = lastAssistant.content as AssistantMessageBlock[]
-      if (!Array.isArray(blocks) || blocks.length === 0) {
-        return
-      }
-
-      const pendingQuestionBlock = [...blocks].reverse().find((block) => {
-        if (
-          block.type !== 'action' ||
-          block.action_type !== 'question_request' ||
-          block.status !== 'pending'
-        ) {
-          return false
-        }
-        if (block.extra && block.extra.needsUserAction === false) {
-          return false
-        }
-        return Boolean(block.tool_call?.id)
-      })
-
-      const toolCallId = pendingQuestionBlock?.tool_call?.id
-      if (!toolCallId) return
-
-      runtime.pendingQuestion = {
-        messageId: lastAssistant.id,
-        toolCallId
-      }
-      session.status = 'waiting_question'
-      session.updatedAt = Date.now()
-    } catch (error) {
-      console.warn('[SessionManager] Failed to hydrate pending question:', error)
-    }
-  }
-
-  private async resolveAgentWorkspacePath(
-    conversationId: string | null,
-    currentPath: string | null
-  ): Promise<string | null> {
-    const trimmedPath = currentPath?.trim()
-    if (trimmedPath) return trimmedPath
-
-    const fallback = await this.getDefaultAgentWorkspacePath(conversationId)
-    if (conversationId && fallback) {
-      try {
-        await this.options.sessionPresenter.updateConversationSettings(conversationId, {
-          agentWorkspacePath: fallback
-        })
-      } catch (error) {
-        console.warn('[SessionManager] Failed to persist agent workspace path:', error)
-      }
-    }
-    return fallback
-  }
-
-  private async getDefaultAgentWorkspacePath(conversationId?: string | null): Promise<string> {
-    const tempRoot = path.join(app.getPath('temp'), 'deepchat-agent', 'workspaces')
-    try {
-      await fs.promises.mkdir(tempRoot, { recursive: true })
-    } catch (error) {
-      console.warn(
-        '[SessionManager] Failed to create default workspace root, using system temp:',
-        error
-      )
-      return app.getPath('temp')
-    }
-
-    if (!conversationId) {
-      return tempRoot
-    }
-
-    const workspaceDir = path.join(tempRoot, conversationId)
-    try {
-      await fs.promises.mkdir(workspaceDir, { recursive: true })
-      return workspaceDir
-    } catch (error) {
-      console.warn(
-        '[SessionManager] Failed to create conversation workspace, using root temp workspace:',
-        error
-      )
-      return tempRoot
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionResolver.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionResolver.ts
deleted file mode 100644
index 614325631..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionResolver.ts
+++ /dev/null
@@ -1,47 +0,0 @@
-import type { CONVERSATION_SETTINGS, ModelConfig } from '@shared/presenter'
-import type { SessionContextResolved } from './sessionContext'
-
-export type ChatMode = 'agent' | 'acp agent'
-
-export type SessionResolveInput = {
-  settings: CONVERSATION_SETTINGS
-  fallbackChatMode?: ChatMode
-  modelConfig?: ModelConfig
-}
-
-export type SessionResolveResult = SessionContextResolved & {
-  needsMigration?: boolean
-}
-
-function validateChatMode(mode: string | undefined): ChatMode | undefined {
-  if (mode === 'acp agent') return 'acp agent'
-  if (mode === 'agent') return 'agent'
-  return undefined
-}
-
-function isLegacyChatMode(mode: string | undefined): boolean {
-  return mode === 'chat'
-}
-
-export function resolveSessionContext(input: SessionResolveInput): SessionResolveResult {
-  const { settings, modelConfig } = input
-
-  const rawChatMode = settings.chatMode
-  const rawFallback = input.fallbackChatMode
-
-  const settingsNeedsMigration = isLegacyChatMode(rawChatMode)
-
-  const chatMode = validateChatMode(rawChatMode) ?? validateChatMode(rawFallback) ?? 'agent'
-
-  return {
-    chatMode,
-    providerId: settings.providerId,
-    modelId: settings.modelId,
-    supportsVision: modelConfig?.vision ?? false,
-    supportsFunctionCall: modelConfig?.functionCall ?? false,
-    agentWorkspacePath: chatMode === 'agent' ? (settings.agentWorkspacePath ?? null) : null,
-    enabledMcpTools: settings.enabledMcpTools,
-    acpWorkdirMap: chatMode === 'acp agent' ? settings.acpWorkdirMap : undefined,
-    needsMigration: settingsNeedsMigration
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionRuntimePort.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionRuntimePort.ts
deleted file mode 100644
index 41c054308..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/session/sessionRuntimePort.ts
+++ /dev/null
@@ -1,39 +0,0 @@
-import type {
-  PendingPermission,
-  PermissionResumeLock,
-  SessionContext,
-  SessionStatus
-} from './sessionContext'
-
-export type SessionRuntimeLoopOptions = {
-  preservePendingPermissions?: boolean
-  skipLockAcquisition?: boolean
-}
-
-export type SessionRuntimeWorkspaceContext = {
-  chatMode: 'agent' | 'acp agent'
-  agentWorkspacePath: string | null
-}
-
-export interface AgentSessionRuntimePort {
-  getSession(agentId: string): Promise<SessionContext>
-  getSessionSync(agentId: string): SessionContext | null
-  resolveWorkspaceContext(
-    conversationId?: string,
-    modelId?: string
-  ): Promise<SessionRuntimeWorkspaceContext>
-  startLoop(agentId: string, messageId: string, options?: SessionRuntimeLoopOptions): Promise<void>
-  setStatus(agentId: string, status: SessionStatus): void
-  getStatus(agentId: string): SessionStatus | null
-  updateRuntime(agentId: string, updates: Partial<SessionContext['runtime']>): void
-  incrementToolCallCount(agentId: string): void
-  clearPendingPermission(agentId: string): void
-  clearPendingQuestion(agentId: string): void
-  addPendingPermission(agentId: string, permission: PendingPermission): void
-  removePendingPermission(agentId: string, messageId: string, toolCallId: string): void
-  getPendingPermissions(agentId: string): PendingPermission[] | undefined
-  hasPendingPermissions(agentId: string, messageId?: string): boolean
-  acquirePermissionResumeLock(agentId: string, messageId: string): boolean
-  releasePermissionResumeLock(agentId: string): void
-  getPermissionResumeLock(agentId: string): PermissionResumeLock | undefined
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/contentBufferHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/contentBufferHandler.ts
deleted file mode 100644
index 386c46b63..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/contentBufferHandler.ts
+++ /dev/null
@@ -1,196 +0,0 @@
-import { finalizeAssistantMessageBlocks } from '@shared/chat/messageBlocks'
-import type { GeneratingMessageState } from './types'
-import type { StreamUpdateScheduler } from './streamUpdateScheduler'
-
-export class ContentBufferHandler {
-  private readonly generatingMessages: Map<string, GeneratingMessageState>
-  private readonly streamUpdateScheduler: StreamUpdateScheduler
-
-  constructor(options: {
-    generatingMessages: Map<string, GeneratingMessageState>
-    streamUpdateScheduler: StreamUpdateScheduler
-  }) {
-    this.generatingMessages = options.generatingMessages
-    this.streamUpdateScheduler = options.streamUpdateScheduler
-  }
-
-  async flushAdaptiveBuffer(eventId: string): Promise<void> {
-    const state = this.generatingMessages.get(eventId)
-    if (!state?.adaptiveBuffer) return
-
-    const buffer = state.adaptiveBuffer
-    const now = Date.now()
-
-    if (state.flushTimeout) {
-      clearTimeout(state.flushTimeout)
-      state.flushTimeout = undefined
-    }
-
-    try {
-      if (buffer.content && buffer.sentPosition < buffer.content.length) {
-        const newContent = buffer.content.slice(buffer.sentPosition)
-        if (newContent) {
-          await this.processBufferedContent(state, eventId, newContent, now)
-          buffer.sentPosition = buffer.content.length
-        }
-      }
-    } catch (error) {
-      console.error('[ContentBufferHandler] ERROR flushing adaptive buffer', {
-        eventId,
-        err: error
-      })
-      throw error
-    } finally {
-      state.adaptiveBuffer = undefined
-    }
-  }
-
-  async processBufferedContent(
-    state: GeneratingMessageState,
-    eventId: string,
-    content: string,
-    currentTime: number
-  ): Promise<void> {
-    const buffer = state.adaptiveBuffer
-
-    if (buffer?.isLargeContent) {
-      await this.processLargeContentAsynchronously(state, eventId, content, currentTime)
-      return
-    }
-
-    await this.processNormalContent(state, eventId, content, currentTime)
-  }
-
-  async processLargeContentAsynchronously(
-    state: GeneratingMessageState,
-    eventId: string,
-    content: string,
-    currentTime: number
-  ): Promise<void> {
-    const buffer = state.adaptiveBuffer
-    if (!buffer) return
-
-    buffer.isProcessing = true
-
-    try {
-      const chunks = this.splitLargeContent(content)
-      const totalChunks = chunks.length
-
-      console.log(
-        `[ContentBufferHandler] Processing ${totalChunks} chunks asynchronously for ${content.length} bytes`
-      )
-
-      const lastBlock = state.message.content[state.message.content.length - 1]
-      let contentBlock: any
-
-      if (lastBlock && lastBlock.type === 'content') {
-        contentBlock = lastBlock
-      } else {
-        this.finalizeLastBlock(state)
-        contentBlock = {
-          type: 'content',
-          content: '',
-          status: 'loading',
-          timestamp: currentTime
-        }
-        state.message.content.push(contentBlock)
-      }
-
-      const batchSize = 5
-      for (let batchStart = 0; batchStart < chunks.length; batchStart += batchSize) {
-        const batchEnd = Math.min(batchStart + batchSize, chunks.length)
-        const batch = chunks.slice(batchStart, batchEnd)
-
-        const batchContent = batch.join('')
-        contentBlock.content += batchContent
-
-        this.streamUpdateScheduler.enqueueDelta(
-          eventId,
-          state.conversationId,
-          state.message.parentId,
-          Boolean(state.message.is_variant),
-          state.webContentsId,
-          { content: batchContent },
-          state.message.content
-        )
-
-        if (batchEnd < chunks.length) {
-          await new Promise((resolve) => setImmediate(resolve))
-        }
-      }
-
-      console.log(`[ContentBufferHandler] Completed processing ${totalChunks} chunks`)
-    } catch (error) {
-      console.error('[ContentBufferHandler] Error in processLargeContentAsynchronously:', error)
-    } finally {
-      buffer.isProcessing = false
-    }
-  }
-
-  async processNormalContent(
-    state: GeneratingMessageState,
-    eventId: string,
-    content: string,
-    currentTime: number
-  ): Promise<void> {
-    const lastBlock = state.message.content[state.message.content.length - 1]
-
-    if (lastBlock && lastBlock.type === 'content') {
-      lastBlock.content += content
-    } else {
-      this.finalizeLastBlock(state)
-      state.message.content.push({
-        type: 'content',
-        content,
-        status: 'loading',
-        timestamp: currentTime
-      })
-    }
-
-    this.streamUpdateScheduler.enqueueDelta(
-      eventId,
-      state.conversationId,
-      state.message.parentId,
-      Boolean(state.message.is_variant),
-      state.webContentsId,
-      { content },
-      state.message.content
-    )
-  }
-
-  splitLargeContent(content: string): string[] {
-    const chunks: string[] = []
-    let maxChunkSize = 4096
-
-    if (content.includes('data:image/')) {
-      maxChunkSize = 512
-    }
-
-    if (content.length > 50000) {
-      maxChunkSize = Math.min(maxChunkSize, 256)
-    }
-
-    for (let i = 0; i < content.length; i += maxChunkSize) {
-      chunks.push(content.slice(i, i + maxChunkSize))
-    }
-
-    return chunks
-  }
-
-  cleanupContentBuffer(state: GeneratingMessageState): void {
-    if (state.flushTimeout) {
-      clearTimeout(state.flushTimeout)
-      state.flushTimeout = undefined
-    }
-    if (state.throttleTimeout) {
-      clearTimeout(state.throttleTimeout)
-      state.throttleTimeout = undefined
-    }
-    state.adaptiveBuffer = undefined
-    state.lastRendererUpdateTime = undefined
-  }
-
-  private finalizeLastBlock(state: GeneratingMessageState): void {
-    finalizeAssistantMessageBlocks(state.message.content)
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/llmEventHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/llmEventHandler.ts
deleted file mode 100644
index 404d8b85a..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/llmEventHandler.ts
+++ /dev/null
@@ -1,569 +0,0 @@
-import { eventBus, SendTarget } from '@/eventbus'
-import { CONVERSATION_EVENTS, STREAM_EVENTS } from '@/events'
-import type { AssistantMessageBlock } from '@shared/chat'
-import { finalizeAssistantMessageBlocks } from '@shared/chat/messageBlocks'
-import type { LLMAgentEventData, MESSAGE_METADATA } from '@shared/presenter'
-import { approximateTokenSize } from 'tokenx'
-import type { MessageManager } from '../../sessionPresenter/managers/messageManager'
-import type { GeneratingMessageState } from './types'
-import type { ContentBufferHandler } from './contentBufferHandler'
-import type { ToolCallHandler } from '../loop/toolCallHandler'
-import type { StreamUpdateScheduler } from './streamUpdateScheduler'
-import type { AgentSessionRuntimePort } from '../session/sessionRuntimePort'
-
-type ConversationUpdateHandler = (state: GeneratingMessageState) => Promise<void>
-
-type HookErrorSnapshot = {
-  error: { message: string; stack?: string }
-  usage?: Record<string, number> | null
-  conversationId?: string
-  providerId?: string
-  modelId?: string
-}
-
-export class LLMEventHandler {
-  private readonly generatingMessages: Map<string, GeneratingMessageState>
-  private readonly messageManager: MessageManager
-  private readonly contentBufferHandler: ContentBufferHandler
-  private readonly toolCallHandler: ToolCallHandler
-  private readonly streamUpdateScheduler: StreamUpdateScheduler
-  private readonly sessionRuntime: AgentSessionRuntimePort
-  private readonly onConversationUpdated?: ConversationUpdateHandler
-  private readonly errorByEventId: Map<string, HookErrorSnapshot> = new Map()
-
-  constructor(options: {
-    generatingMessages: Map<string, GeneratingMessageState>
-    messageManager: MessageManager
-    contentBufferHandler: ContentBufferHandler
-    toolCallHandler: ToolCallHandler
-    streamUpdateScheduler: StreamUpdateScheduler
-    sessionRuntime: AgentSessionRuntimePort
-    onConversationUpdated?: ConversationUpdateHandler
-  }) {
-    this.generatingMessages = options.generatingMessages
-    this.messageManager = options.messageManager
-    this.contentBufferHandler = options.contentBufferHandler
-    this.toolCallHandler = options.toolCallHandler
-    this.streamUpdateScheduler = options.streamUpdateScheduler
-    this.sessionRuntime = options.sessionRuntime
-    this.onConversationUpdated = options.onConversationUpdated
-  }
-
-  async handleLLMAgentResponse(msg: LLMAgentEventData): Promise<void> {
-    const currentTime = Date.now()
-    const {
-      eventId,
-      content,
-      reasoning_content,
-      tool_call_id,
-      tool_call_name,
-      tool_call_params,
-      maximum_tool_calls_reached,
-      tool_call_server_name,
-      tool_call_server_icons,
-      tool_call_server_description,
-      tool_call_response_raw,
-      tool_call,
-      question_request,
-      question_error,
-      totalUsage,
-      image_data
-    } = msg
-
-    const state = this.generatingMessages.get(eventId)
-    if (!state) {
-      return
-    }
-
-    if (state.firstTokenTime === null && (content || reasoning_content)) {
-      state.firstTokenTime = currentTime
-      await this.messageManager.updateMessageMetadata(eventId, {
-        firstTokenTime: currentTime - state.startTime
-      })
-    }
-
-    if (totalUsage) {
-      state.totalUsage = totalUsage
-      state.promptTokens = totalUsage.prompt_tokens
-    }
-
-    if (maximum_tool_calls_reached) {
-      this.finalizeLastBlock(state)
-      state.message.content.push({
-        type: 'action',
-        content: 'common.error.maximumToolCallsReached',
-        status: 'success',
-        timestamp: currentTime,
-        action_type: 'maximum_tool_calls_reached',
-        tool_call: {
-          id: tool_call_id,
-          name: tool_call_name,
-          params: tool_call_params,
-          server_name: tool_call_server_name,
-          server_icons: tool_call_server_icons,
-          server_description: tool_call_server_description
-        },
-        extra: { needContinue: true }
-      })
-      this.streamUpdateScheduler.enqueueDelta(
-        eventId,
-        state.conversationId,
-        state.message.parentId,
-        Boolean(state.message.is_variant),
-        state.webContentsId,
-        {},
-        state.message.content
-      )
-      return
-    }
-
-    if (question_error) {
-      this.finalizeLastBlock(state)
-      state.message.content.push({
-        type: 'error',
-        content: question_error,
-        status: 'error',
-        timestamp: currentTime
-      })
-    }
-
-    if (reasoning_content) {
-      if (state.reasoningStartTime === null) {
-        state.reasoningStartTime = currentTime
-        await this.messageManager.updateMessageMetadata(eventId, {
-          reasoningStartTime: currentTime - state.startTime
-        })
-      }
-      state.lastReasoningTime = currentTime
-      // Update reasoningEndTime in metadata for real-time display
-      await this.messageManager.updateMessageMetadata(eventId, {
-        reasoningEndTime: currentTime - state.startTime
-      })
-    }
-
-    const lastBlock = state.message.content[state.message.content.length - 1]
-
-    if (tool_call_response_raw && tool_call === 'end') {
-      await this.toolCallHandler.processSearchResultsFromToolCall(state, msg, currentTime)
-      await this.toolCallHandler.processMcpUiResourcesFromToolCall(state, msg, currentTime)
-    }
-
-    const shouldSkipToolCall =
-      tool_call && tool_call_name === 'question' && tool_call !== 'question-required'
-    const isAcpProvider = state.message.model_provider === 'acp'
-
-    if (tool_call && !shouldSkipToolCall) {
-      if (isAcpProvider) {
-        // Legacy hook dispatch disabled. New session hooks are emitted by the new agent pipeline.
-      }
-
-      switch (tool_call) {
-        case 'start':
-          this.sessionRuntime.incrementToolCallCount(state.conversationId)
-          await this.toolCallHandler.processToolCallStart(state, msg, currentTime)
-          break
-        case 'update':
-        case 'running':
-          await this.toolCallHandler.processToolCallUpdate(state, msg)
-          break
-        case 'permission-required':
-          this.sessionRuntime.addPendingPermission(state.conversationId, {
-            messageId: eventId,
-            toolCallId: tool_call_id || '',
-            permissionType:
-              (msg.permission_request?.permissionType as 'read' | 'write' | 'all' | 'command') ||
-              'read',
-            payload: msg.permission_request ?? {}
-          })
-          this.sessionRuntime.setStatus(state.conversationId, 'waiting_permission')
-          await this.toolCallHandler.processToolCallPermission(state, msg, currentTime)
-          break
-        case 'question-required':
-          this.sessionRuntime.updateRuntime(state.conversationId, {
-            pendingQuestion: {
-              messageId: eventId,
-              toolCallId: tool_call_id || ''
-            }
-          })
-          this.sessionRuntime.setStatus(state.conversationId, 'waiting_question')
-          await this.toolCallHandler.processQuestionRequest(state, msg, currentTime)
-          break
-        case 'permission-granted':
-        case 'permission-denied':
-        case 'continue':
-          await this.toolCallHandler.processToolCallPermission(state, msg, currentTime)
-          break
-        case 'error':
-          await this.toolCallHandler.processToolCallError(state, msg)
-          break
-        case 'end':
-          await this.toolCallHandler.processToolCallEnd(state, msg)
-          break
-        default:
-          break
-      }
-    }
-
-    if (image_data?.data) {
-      const rawData = image_data.data ?? ''
-      let normalizedData = rawData
-      let normalizedMimeType = image_data.mimeType?.trim() ?? ''
-
-      if (
-        rawData.startsWith('imgcache://') ||
-        rawData.startsWith('http://') ||
-        rawData.startsWith('https://')
-      ) {
-        normalizedMimeType = 'deepchat/image-url'
-      } else if (rawData.startsWith('data:image/')) {
-        const match = rawData.match(/^data:([^;]+);base64,(.*)$/)
-        if (match?.[1] && match?.[2]) {
-          normalizedMimeType = match[1]
-          normalizedData = match[2]
-        }
-      } else if (!normalizedMimeType) {
-        normalizedMimeType = 'image/png'
-      }
-
-      const imageBlock: AssistantMessageBlock = {
-        type: 'image',
-        status: 'success',
-        timestamp: currentTime,
-        content: 'image',
-        image_data: {
-          data: normalizedData,
-          mimeType: normalizedMimeType
-        }
-      }
-      state.message.content.push(imageBlock)
-    }
-
-    if (content) {
-      if (!lastBlock || lastBlock.type !== 'content' || lastBlock.status !== 'loading') {
-        this.finalizeLastBlock(state)
-        state.message.content.push({
-          type: 'content',
-          content: content || '',
-          status: 'loading',
-          timestamp: currentTime
-        })
-      } else if (lastBlock.type === 'content') {
-        lastBlock.content += content
-      }
-    }
-
-    if (reasoning_content) {
-      // Re-get lastBlock in case new blocks were added above
-      const currentLastBlock = state.message.content[state.message.content.length - 1]
-      if (!currentLastBlock || currentLastBlock.type !== 'reasoning_content') {
-        this.finalizeLastBlock(state)
-        const reasoningStartTime = currentTime
-        state.message.content.push({
-          type: 'reasoning_content',
-          content: reasoning_content || '',
-          status: 'loading',
-          timestamp: currentTime,
-          reasoning_time: {
-            start: reasoningStartTime,
-            end: currentTime
-          }
-        })
-      } else if (currentLastBlock.type === 'reasoning_content') {
-        currentLastBlock.content += reasoning_content
-        // Update reasoning_time.end in real-time during streaming
-        if (currentLastBlock.reasoning_time) {
-          currentLastBlock.reasoning_time.end = currentTime
-        } else {
-          const reasoningStartTime = currentLastBlock.timestamp ?? currentTime
-          currentLastBlock.reasoning_time = {
-            start: reasoningStartTime,
-            end: currentTime
-          }
-        }
-      }
-    }
-
-    const delta: Partial<LLMAgentEventData> = {}
-    if (content) delta.content = content
-    if (reasoning_content) {
-      delta.reasoning_content = reasoning_content
-      // Get the current reasoning_time from the last reasoning_content block
-      const lastBlock = state.message.content[state.message.content.length - 1]
-      if (lastBlock?.type === 'reasoning_content' && lastBlock.reasoning_time) {
-        delta.reasoning_time = lastBlock.reasoning_time
-      }
-    }
-    if (image_data) delta.image_data = image_data
-    if (totalUsage) delta.totalUsage = totalUsage
-
-    if (tool_call && !shouldSkipToolCall) {
-      delta.tool_call = tool_call
-      delta.tool_call_id = tool_call_id
-      delta.tool_call_name = tool_call_name
-      delta.tool_call_params = tool_call_params
-      delta.tool_call_response = msg.tool_call_response
-      delta.tool_call_server_name = tool_call_server_name
-      delta.tool_call_server_icons = tool_call_server_icons
-      delta.tool_call_server_description = tool_call_server_description
-      delta.tool_call_response_raw = tool_call_response_raw
-      if (msg.permission_request !== undefined) {
-        delta.permission_request = msg.permission_request
-      }
-      if (question_request !== undefined) {
-        delta.question_request = question_request
-      }
-    }
-
-    if (question_error) {
-      delta.question_error = question_error
-    }
-
-    this.streamUpdateScheduler.enqueueDelta(
-      eventId,
-      state.conversationId,
-      state.message.parentId,
-      Boolean(state.message.is_variant),
-      state.webContentsId,
-      delta,
-      state.message.content
-    )
-  }
-
-  async handleLLMAgentError(msg: LLMAgentEventData): Promise<void> {
-    const { eventId, error } = msg
-    const errorMessage = error instanceof Error ? error.message : String(error)
-    const errorStack = error instanceof Error ? error.stack : undefined
-    const state = this.generatingMessages.get(eventId)
-    const errorSnapshot: HookErrorSnapshot = {
-      error: errorStack ? { message: errorMessage, stack: errorStack } : { message: errorMessage },
-      usage: state?.totalUsage,
-      conversationId: state?.conversationId,
-      providerId: state?.message.model_provider,
-      modelId: state?.message.model_id
-    }
-
-    if (!errorSnapshot.conversationId) {
-      try {
-        const message = await this.messageManager.getMessage(eventId)
-        errorSnapshot.conversationId = message.conversationId
-        errorSnapshot.providerId = errorSnapshot.providerId ?? message.model_provider
-        errorSnapshot.modelId = errorSnapshot.modelId ?? message.model_id
-      } catch {
-        // ignore
-      }
-    }
-
-    this.errorByEventId.set(eventId, errorSnapshot)
-
-    if (state) {
-      if (state.adaptiveBuffer) {
-        await this.contentBufferHandler.flushAdaptiveBuffer(eventId)
-      }
-
-      this.contentBufferHandler.cleanupContentBuffer(state)
-    }
-
-    // Flush stream buffers before persisting error to avoid stale snapshot overwrites.
-    await this.streamUpdateScheduler.flushAll(eventId, 'final')
-
-    await this.messageManager.handleMessageError(eventId, errorMessage)
-
-    if (state) {
-      this.generatingMessages.delete(eventId)
-      this.sessionRuntime.setStatus(state.conversationId, 'error')
-      this.sessionRuntime.clearPendingPermission(state.conversationId)
-      this.sessionRuntime.clearPendingQuestion(state.conversationId)
-    } else {
-      const message = await this.messageManager.getMessage(eventId)
-      if (message) {
-        this.sessionRuntime.setStatus(message.conversationId, 'error')
-        this.sessionRuntime.clearPendingPermission(message.conversationId)
-        this.sessionRuntime.clearPendingQuestion(message.conversationId)
-      }
-    }
-
-    eventBus.sendToRenderer(STREAM_EVENTS.ERROR, SendTarget.ALL_WINDOWS, msg)
-  }
-
-  async handleLLMAgentEnd(msg: LLMAgentEventData): Promise<void> {
-    const { eventId, userStop } = msg
-    const state = this.generatingMessages.get(eventId)
-    if (state) {
-      if (state.adaptiveBuffer) {
-        await this.contentBufferHandler.flushAdaptiveBuffer(eventId)
-      }
-
-      this.contentBufferHandler.cleanupContentBuffer(state)
-
-      const hasPendingPermissions = state.message.content.some(
-        (block) =>
-          block.type === 'action' &&
-          block.action_type === 'tool_call_permission' &&
-          block.status === 'pending'
-      )
-      const hasPendingQuestions = state.message.content.some(
-        (block) =>
-          block.type === 'action' &&
-          block.action_type === 'question_request' &&
-          block.status === 'pending'
-      )
-
-      if (hasPendingPermissions || hasPendingQuestions) {
-        state.message.content.forEach((block) => {
-          if (
-            !(
-              block.type === 'action' &&
-              (block.action_type === 'tool_call_permission' ||
-                block.action_type === 'question_request')
-            ) &&
-            block.status === 'loading'
-          ) {
-            if (block.type !== 'tool_call') {
-              block.status = 'success'
-            }
-          }
-        })
-        this.streamUpdateScheduler.enqueueDelta(
-          eventId,
-          state.conversationId,
-          state.message.parentId,
-          Boolean(state.message.is_variant),
-          state.webContentsId,
-          {},
-          state.message.content
-        )
-        if (hasPendingQuestions) {
-          // Question tool ends the assistant message even when waiting for user input.
-          await this.messageManager.updateMessageStatus(eventId, 'sent')
-        }
-        this.sessionRuntime.setStatus(state.conversationId, 'waiting_permission')
-        if (!hasPendingPermissions) {
-          this.sessionRuntime.setStatus(state.conversationId, 'waiting_question')
-        }
-        await this.streamUpdateScheduler.flushAll(eventId, 'final')
-        this.generatingMessages.delete(eventId)
-        eventBus.sendToRenderer(STREAM_EVENTS.END, SendTarget.ALL_WINDOWS, msg)
-        this.errorByEventId.delete(eventId)
-        return
-      }
-
-      await this.finalizeMessage(state, eventId, Boolean(userStop))
-      this.sessionRuntime.setStatus(state.conversationId, 'idle')
-      this.sessionRuntime.clearPendingPermission(state.conversationId)
-      this.sessionRuntime.clearPendingQuestion(state.conversationId)
-    }
-
-    try {
-      // Legacy hook dispatch disabled. New session hooks are emitted by the new agent pipeline.
-    } finally {
-      this.errorByEventId.delete(eventId)
-    }
-
-    await this.streamUpdateScheduler.flushAll(eventId, 'final')
-    eventBus.sendToRenderer(STREAM_EVENTS.END, SendTarget.ALL_WINDOWS, msg)
-  }
-
-  async finalizeMessage(
-    state: GeneratingMessageState,
-    eventId: string,
-    userStop: boolean
-  ): Promise<void> {
-    state.message.content.forEach((block) => {
-      if (
-        block.type === 'action' &&
-        (block.action_type === 'tool_call_permission' || block.action_type === 'question_request')
-      ) {
-        return
-      }
-      block.status = 'success'
-    })
-
-    let completionTokens = 0
-    if (state.totalUsage) {
-      completionTokens = state.totalUsage.completion_tokens
-    } else {
-      for (const block of state.message.content) {
-        if (
-          block.type === 'content' ||
-          block.type === 'reasoning_content' ||
-          block.type === 'tool_call'
-        ) {
-          completionTokens += approximateTokenSize(block.content)
-        }
-      }
-    }
-
-    const hasContentBlock = state.message.content.some(
-      (block) =>
-        block.type === 'content' ||
-        block.type === 'reasoning_content' ||
-        block.type === 'tool_call' ||
-        block.type === 'image'
-    )
-
-    if (!hasContentBlock && !userStop) {
-      state.message.content.push({
-        type: 'error',
-        content: 'common.error.noModelResponse',
-        status: 'error',
-        timestamp: Date.now()
-      })
-    }
-
-    const totalTokens = state.promptTokens + completionTokens
-    const generationTime = Date.now() - (state.firstTokenTime ?? state.startTime)
-    const safeMs = Math.max(1, generationTime)
-    const tokensPerSecond = completionTokens / (safeMs / 1000)
-    const contextUsage = state?.totalUsage?.context_length
-      ? (totalTokens / state.totalUsage.context_length) * 100
-      : 0
-
-    const metadata: Partial<MESSAGE_METADATA> = {
-      totalTokens,
-      inputTokens: state.promptTokens,
-      outputTokens: completionTokens,
-      generationTime,
-      firstTokenTime: state.firstTokenTime ? state.firstTokenTime - state.startTime : 0,
-      tokensPerSecond,
-      contextUsage
-    }
-
-    if (state.reasoningStartTime !== null && state.lastReasoningTime !== null) {
-      metadata.reasoningStartTime = state.reasoningStartTime - state.startTime
-      metadata.reasoningEndTime = state.lastReasoningTime - state.startTime
-    }
-
-    await this.messageManager.updateMessageMetadata(eventId, metadata)
-    await this.messageManager.updateMessageStatus(eventId, 'sent')
-    await this.messageManager.editMessage(eventId, JSON.stringify(state.message.content))
-    this.generatingMessages.delete(eventId)
-
-    if (this.onConversationUpdated) {
-      await this.onConversationUpdated(state)
-    }
-
-    const finalMessage = await this.messageManager.getMessage(eventId)
-    if (finalMessage) {
-      eventBus.sendToMain(CONVERSATION_EVENTS.MESSAGE_GENERATED, {
-        conversationId: finalMessage.conversationId,
-        message: finalMessage
-      })
-    }
-  }
-
-  finalizeLastBlock(state: GeneratingMessageState): void {
-    finalizeAssistantMessageBlocks(state.message.content)
-  }
-
-  /**
-   * Flush all pending stream updates for a message
-   * Used during permission resume to ensure UI state is synchronized with DB
-   */
-  async flushStreamUpdates(eventId: string): Promise<void> {
-    try {
-      await this.streamUpdateScheduler.flushAll(eventId, 'final')
-    } catch (error) {
-      console.error('[LLMEventHandler] Failed to flush stream updates:', error)
-    }
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamGenerationHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamGenerationHandler.ts
deleted file mode 100644
index c91f30339..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamGenerationHandler.ts
+++ /dev/null
@@ -1,597 +0,0 @@
-import { eventBus, SendTarget } from '@/eventbus'
-import { STREAM_EVENTS } from '@/events'
-import type {
-  AssistantMessage,
-  AssistantMessageBlock,
-  Message,
-  MessageFile,
-  UserMessage,
-  UserMessageContent
-} from '@shared/chat'
-import type { CONVERSATION, MCPToolResponse } from '@shared/presenter'
-import { buildUserMessageContext, formatUserMessageContent } from '../message/messageFormatter'
-import { preparePromptContent } from '../message/messageBuilder'
-import type { GeneratingMessageState } from './types'
-import { BaseHandler, type ThreadHandlerContext } from '../types/handlerContext'
-import type { LLMEventHandler } from './llmEventHandler'
-import { LoopOrchestrator } from '../loop/loopOrchestrator'
-
-interface StreamGenerationHandlerDeps {
-  generatingMessages: Map<string, GeneratingMessageState>
-  llmEventHandler: LLMEventHandler
-}
-
-export class StreamGenerationHandler extends BaseHandler {
-  private readonly generatingMessages: Map<string, GeneratingMessageState>
-  private readonly llmEventHandler: LLMEventHandler
-  private readonly loopOrchestrator: LoopOrchestrator
-
-  constructor(context: ThreadHandlerContext, deps: StreamGenerationHandlerDeps) {
-    super(context)
-    this.generatingMessages = deps.generatingMessages
-    this.llmEventHandler = deps.llmEventHandler
-    this.loopOrchestrator = new LoopOrchestrator(this.llmEventHandler)
-    this.assertDependencies()
-  }
-
-  private assertDependencies(): void {
-    void this.generatingMessages
-    void this.llmEventHandler
-    void this.loopOrchestrator
-  }
-
-  async startStreamCompletion(
-    conversationId: string,
-    queryMsgId?: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<void> {
-    const state = this.findGeneratingState(conversationId)
-    if (!state) {
-      console.warn('[StreamGenerationHandler] State not found, conversationId:', conversationId)
-      return
-    }
-
-    try {
-      state.isCancelled = false
-      // Normal flow: skip lock acquisition (lock is only for permission resume)
-      await this.sessionRuntime.startLoop(conversationId, state.message.id, {
-        skipLockAcquisition: true
-      })
-
-      const { conversation, userMessage, contextMessages } = await this.prepareConversationContext(
-        conversationId,
-        queryMsgId,
-        selectedVariantsMap
-      )
-
-      const { chatMode, agentWorkspacePath } = await this.sessionRuntime.resolveWorkspaceContext(
-        conversationId,
-        conversation.settings.modelId
-      )
-      if (chatMode === 'agent' && agentWorkspacePath) {
-        conversation.settings.agentWorkspacePath = agentWorkspacePath
-      }
-
-      const { providerId, modelId } = conversation.settings
-      const modelConfig = this.ctx.configPresenter.getModelConfig(modelId, providerId)
-      if (!modelConfig) {
-        throw new Error(`Model config not found for provider ${providerId} and model ${modelId}`)
-      }
-
-      this.throwIfCancelled(state.message.id)
-
-      const { userContent, imageFiles } = await this.processUserMessageContent(
-        userMessage as UserMessage
-      )
-
-      this.throwIfCancelled(state.message.id)
-
-      const { finalContent, promptTokens } = await preparePromptContent({
-        conversation,
-        userContent,
-        contextMessages,
-        searchResults: null,
-        userMessage,
-        vision: Boolean(modelConfig?.vision),
-        imageFiles: modelConfig?.vision ? imageFiles : [],
-        supportsFunctionCall: modelConfig.functionCall,
-        modelType: modelConfig.type,
-        toolPresenter: this.toolPresenter,
-        promptRuntime: this.promptRuntime
-      })
-
-      this.throwIfCancelled(state.message.id)
-
-      await this.updateGenerationState(state, promptTokens)
-
-      this.throwIfCancelled(state.message.id)
-
-      const currentConversation = await this.getConversation(conversationId)
-      const {
-        providerId: currentProviderId,
-        modelId: currentModelId,
-        temperature: currentTemperature,
-        maxTokens: currentMaxTokens,
-        enabledMcpTools: currentEnabledMcpTools,
-        thinkingBudget: currentThinkingBudget,
-        reasoningEffort: currentReasoningEffort,
-        verbosity: currentVerbosity
-      } = currentConversation.settings
-
-      const stream = this.ctx.llmProviderPresenter.startStreamCompletion(
-        currentProviderId,
-        finalContent,
-        currentModelId,
-        state.message.id,
-        currentTemperature,
-        currentMaxTokens,
-        currentEnabledMcpTools,
-        currentThinkingBudget,
-        currentReasoningEffort,
-        currentVerbosity,
-        conversationId
-      )
-
-      await this.loopOrchestrator.consume(stream)
-    } catch (error) {
-      if (String(error).includes('userCanceledGeneration')) {
-        console.log('[StreamGenerationHandler] Message generation cancelled by user')
-        return
-      }
-
-      console.error('[StreamGenerationHandler] Error during streaming generation:', error)
-      await this.ctx.messageManager.handleMessageError(state.message.id, String(error))
-      throw error
-    }
-  }
-
-  async continueStreamCompletion(
-    conversationId: string,
-    queryMsgId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<void> {
-    const state = this.findGeneratingState(conversationId)
-    if (!state) {
-      console.warn('[StreamGenerationHandler] State not found, conversationId:', conversationId)
-      return
-    }
-
-    try {
-      state.isCancelled = false
-      // Normal flow: skip lock acquisition (lock is only for permission resume)
-      await this.sessionRuntime.startLoop(conversationId, state.message.id, {
-        skipLockAcquisition: true
-      })
-
-      const queryMessage = await this.ctx.messageManager.getMessage(queryMsgId)
-      if (!queryMessage) {
-        throw new Error('Message not found')
-      }
-
-      const content = queryMessage.content as AssistantMessageBlock[]
-      const lastActionBlock = content.filter((block) => block.type === 'action').pop()
-
-      if (!lastActionBlock || lastActionBlock.type !== 'action') {
-        throw new Error('Last action block not found')
-      }
-
-      let toolCallResponse: { content: string; rawData: MCPToolResponse } | null = null
-      const toolCall = lastActionBlock.tool_call
-
-      if (lastActionBlock.action_type === 'maximum_tool_calls_reached' && toolCall) {
-        if (lastActionBlock.extra) {
-          lastActionBlock.extra = {
-            ...lastActionBlock.extra,
-            needContinue: false
-          }
-        }
-        await this.ctx.messageManager.editMessage(queryMsgId, JSON.stringify(content))
-
-        if (!toolCall.id || !toolCall.name || !toolCall.params) {
-          console.warn('[StreamGenerationHandler] Tool call parameters incomplete')
-        } else {
-          toolCallResponse = await this.mcpRuntime.callTool({
-            id: toolCall.id,
-            type: 'function',
-            function: {
-              name: toolCall.name,
-              arguments: toolCall.params
-            },
-            server: {
-              name: toolCall.server_name || '',
-              icons: toolCall.server_icons || '',
-              description: toolCall.server_description || ''
-            }
-          })
-        }
-      }
-
-      this.throwIfCancelled(state.message.id)
-
-      const { conversation, contextMessages, userMessage } = await this.prepareConversationContext(
-        conversationId,
-        state.message.id,
-        selectedVariantsMap
-      )
-
-      this.throwIfCancelled(state.message.id)
-
-      const {
-        providerId,
-        modelId,
-        temperature,
-        maxTokens,
-        enabledMcpTools,
-        thinkingBudget,
-        reasoningEffort,
-        verbosity
-      } = conversation.settings
-      const modelConfig = this.ctx.configPresenter.getModelConfig(modelId, providerId)
-      if (!modelConfig) {
-        throw new Error(`Model config not found for ${providerId}/${modelId}`)
-      }
-
-      const { finalContent, promptTokens } = await preparePromptContent({
-        conversation,
-        userContent: 'continue',
-        contextMessages,
-        searchResults: null,
-        userMessage,
-        vision: false,
-        imageFiles: [],
-        supportsFunctionCall: modelConfig.functionCall,
-        modelType: modelConfig.type,
-        toolPresenter: this.toolPresenter,
-        promptRuntime: this.promptRuntime
-      })
-
-      await this.updateGenerationState(state, promptTokens)
-
-      if (toolCallResponse && toolCall) {
-        eventBus.sendToRenderer(STREAM_EVENTS.RESPONSE, SendTarget.ALL_WINDOWS, {
-          eventId: state.message.id,
-          content: '',
-          tool_call: 'start',
-          tool_call_id: toolCall.id,
-          tool_call_name: toolCall.name,
-          tool_call_params: toolCall.params,
-          tool_call_response: toolCallResponse.content,
-          tool_call_server_name: toolCall.server_name,
-          tool_call_server_icons: toolCall.server_icons,
-          tool_call_server_description: toolCall.server_description
-        })
-        eventBus.sendToRenderer(STREAM_EVENTS.RESPONSE, SendTarget.ALL_WINDOWS, {
-          eventId: state.message.id,
-          content: '',
-          tool_call: 'running',
-          tool_call_id: toolCall.id,
-          tool_call_name: toolCall.name,
-          tool_call_params: toolCall.params,
-          tool_call_response: toolCallResponse.content,
-          tool_call_server_name: toolCall.server_name,
-          tool_call_server_icons: toolCall.server_icons,
-          tool_call_server_description: toolCall.server_description
-        })
-        eventBus.sendToRenderer(STREAM_EVENTS.RESPONSE, SendTarget.ALL_WINDOWS, {
-          eventId: state.message.id,
-          content: '',
-          tool_call: 'end',
-          tool_call_id: toolCall.id,
-          tool_call_response: toolCallResponse.content,
-          tool_call_name: toolCall.name,
-          tool_call_params: toolCall.params,
-          tool_call_server_name: toolCall.server_name,
-          tool_call_server_icons: toolCall.server_icons,
-          tool_call_server_description: toolCall.server_description,
-          tool_call_response_raw: toolCallResponse.rawData
-        })
-      }
-
-      const stream = this.ctx.llmProviderPresenter.startStreamCompletion(
-        providerId,
-        finalContent,
-        modelId,
-        state.message.id,
-        temperature,
-        maxTokens,
-        enabledMcpTools,
-        thinkingBudget,
-        reasoningEffort,
-        verbosity,
-        conversationId
-      )
-
-      await this.loopOrchestrator.consume(stream)
-    } catch (error) {
-      if (String(error).includes('userCanceledGeneration')) {
-        console.log('[StreamGenerationHandler] Message generation cancelled by user')
-        return
-      }
-
-      console.error('[StreamGenerationHandler] Error during continue generation:', error)
-      await this.ctx.messageManager.handleMessageError(state.message.id, String(error))
-      throw error
-    }
-  }
-
-  async prepareConversationContext(
-    conversationId: string,
-    queryMsgId?: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<{
-    conversation: CONVERSATION
-    userMessage: Message
-    contextMessages: Message[]
-  }> {
-    const hasUsableAssistantContent = (msg: Message): boolean => {
-      if (msg.role !== 'assistant') return true
-      const blocks = msg.content as AssistantMessageBlock[]
-      return (
-        Array.isArray(blocks) &&
-        blocks.some((block) => {
-          if (block.type === 'content' && block.content) return true
-          if (block.type === 'tool_call' && block.tool_call) return true
-          if (block.type === 'reasoning_content' && block.content) return true
-          return false
-        })
-      )
-    }
-
-    const applyVariantToAssistant = (msg: Message, variantId?: string): Message => {
-      if (msg.role !== 'assistant' || !msg.variants || msg.variants.length === 0) {
-        return msg
-      }
-
-      const variants = msg.variants
-
-      const findVariantById = (id?: string): Message | undefined =>
-        id ? variants.find((variant) => variant.id === id) : undefined
-
-      const findFallbackVariant = (): Message | undefined => {
-        for (let i = variants.length - 1; i >= 0; i--) {
-          const variant = variants[i]
-          if (hasUsableAssistantContent(variant)) {
-            return variant
-          }
-        }
-        return variants[variants.length - 1]
-      }
-
-      const selectedVariant = findVariantById(variantId) || findFallbackVariant()
-      if (!selectedVariant) return msg
-
-      return {
-        ...msg,
-        content: selectedVariant.content,
-        usage: selectedVariant.usage,
-        model_id: selectedVariant.model_id,
-        model_provider: selectedVariant.model_provider,
-        model_name: selectedVariant.model_name
-      }
-    }
-
-    const conversation = await this.getConversation(conversationId)
-    let contextMessages: Message[] = []
-    let userMessage: Message | null = null
-
-    if (queryMsgId) {
-      const queryMessage = await this.ctx.messageManager.getMessage(queryMsgId)
-      if (!queryMessage) {
-        throw new Error('Message not found')
-      }
-
-      if (queryMessage.role === 'user') {
-        userMessage = queryMessage
-      } else if (queryMessage.role === 'assistant') {
-        if (!queryMessage.parentId) {
-          throw new Error('Assistant message missing parentId')
-        }
-        userMessage = await this.ctx.messageManager.getMessage(queryMessage.parentId)
-        if (!userMessage) {
-          throw new Error('Trigger message not found')
-        }
-      } else {
-        throw new Error('Unsupported message type')
-      }
-
-      contextMessages = await this.ctx.messageManager.getMessageHistory(
-        userMessage.id,
-        conversation.settings.contextLength
-      )
-    } else {
-      userMessage = await this.ctx.messageManager.getLastUserMessage(conversationId)
-      if (!userMessage) {
-        throw new Error('User message not found')
-      }
-      contextMessages = await this.getContextMessages(conversation)
-    }
-
-    if (selectedVariantsMap && Object.keys(selectedVariantsMap).length > 0) {
-      contextMessages = contextMessages.map((msg) => {
-        if (msg.role === 'assistant' && selectedVariantsMap[msg.id] && msg.variants) {
-          return applyVariantToAssistant(msg, selectedVariantsMap[msg.id])
-        }
-        return msg
-      })
-    }
-
-    // Fallback: if assistant content is empty and no variant was explicitly chosen, pick a usable variant
-    contextMessages = contextMessages.map((msg) => {
-      if (msg.role === 'assistant' && !hasUsableAssistantContent(msg)) {
-        return applyVariantToAssistant(msg)
-      }
-      return msg
-    })
-
-    if (userMessage.role === 'user') {
-      const msgContent = userMessage.content as UserMessageContent
-      if (msgContent.content && !msgContent.text) {
-        msgContent.text = formatUserMessageContent(msgContent.content)
-      }
-    }
-
-    const thinkEnabled = this.ctx.configPresenter.getSetting('input_deepThinking') as boolean
-    ;(userMessage.content as UserMessageContent).think = thinkEnabled
-
-    return { conversation, userMessage, contextMessages }
-  }
-
-  async processUserMessageContent(
-    userMessage: UserMessage
-  ): Promise<{ userContent: string; imageFiles: MessageFile[] }> {
-    const userContent = buildUserMessageContext(userMessage.content)
-
-    const imageFiles =
-      userMessage.content.files?.filter((file) => {
-        const isImage =
-          file.mimeType.startsWith('data:image') ||
-          /\.(jpg|jpeg|png|gif|bmp|webp|svg)$/i.test(file.name || '')
-        return isImage
-      }) || []
-
-    return { userContent, imageFiles }
-  }
-
-  async updateGenerationState(state: GeneratingMessageState, promptTokens: number): Promise<void> {
-    this.generatingMessages.set(state.message.id, {
-      ...state,
-      startTime: Date.now(),
-      firstTokenTime: null,
-      promptTokens
-    })
-
-    await this.ctx.messageManager.updateMessageMetadata(state.message.id, {
-      totalTokens: promptTokens,
-      generationTime: 0,
-      firstTokenTime: 0,
-      tokensPerSecond: 0
-    })
-  }
-
-  findGeneratingState(conversationId: string): GeneratingMessageState | null {
-    return (
-      Array.from(this.generatingMessages.values()).find(
-        (state) => state.conversationId === conversationId
-      ) || null
-    )
-  }
-
-  async regenerateFromUserMessage(
-    conversationId: string,
-    userMessageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage> {
-    const userMessage = await this.ctx.messageManager.getMessage(userMessageId)
-    if (!userMessage || userMessage.role !== 'user') {
-      throw new Error('Can only regenerate based on user messages.')
-    }
-
-    const conversation = await this.getConversation(conversationId)
-    const { providerId, modelId } = conversation.settings
-
-    const assistantMessage = (await this.ctx.messageManager.sendMessage(
-      conversationId,
-      JSON.stringify([]),
-      'assistant',
-      userMessageId,
-      false,
-      {
-        totalTokens: 0,
-        generationTime: 0,
-        firstTokenTime: 0,
-        tokensPerSecond: 0,
-        contextUsage: 0,
-        inputTokens: 0,
-        outputTokens: 0,
-        model: modelId,
-        provider: providerId
-      }
-    )) as AssistantMessage
-
-    this.generatingMessages.set(assistantMessage.id, {
-      message: assistantMessage,
-      conversationId,
-      startTime: Date.now(),
-      firstTokenTime: null,
-      promptTokens: 0,
-      reasoningStartTime: null,
-      reasoningEndTime: null,
-      lastReasoningTime: null
-    })
-
-    this.startStreamCompletion(conversationId, userMessageId, selectedVariantsMap).catch(
-      (error) => {
-        console.error(
-          '[StreamGenerationHandler] Failed to start regeneration from user message:',
-          error
-        )
-      }
-    )
-
-    return assistantMessage
-  }
-
-  async generateAIResponse(
-    conversationId: string,
-    userMessageId: string
-  ): Promise<AssistantMessage> {
-    try {
-      const triggerMessage = await this.ctx.messageManager.getMessage(userMessageId)
-      if (!triggerMessage) {
-        throw new Error('Trigger message not found')
-      }
-
-      await this.ctx.messageManager.updateMessageStatus(userMessageId, 'sent')
-
-      const conversation = await this.getConversation(conversationId)
-      const { providerId, modelId } = conversation.settings
-      const assistantMessage = (await this.ctx.messageManager.sendMessage(
-        conversationId,
-        JSON.stringify([]),
-        'assistant',
-        userMessageId,
-        false,
-        {
-          contextUsage: 0,
-          totalTokens: 0,
-          generationTime: 0,
-          firstTokenTime: 0,
-          tokensPerSecond: 0,
-          inputTokens: 0,
-          outputTokens: 0,
-          model: modelId,
-          provider: providerId
-        }
-      )) as AssistantMessage
-
-      return assistantMessage
-    } catch (error) {
-      await this.ctx.messageManager.updateMessageStatus(userMessageId, 'error')
-      console.error('[StreamGenerationHandler] Failed to generate AI response:', error)
-      throw error
-    }
-  }
-
-  async getMessageHistory(messageId: string, limit: number = 100): Promise<Message[]> {
-    return this.ctx.messageManager.getMessageHistory(messageId, limit)
-  }
-
-  private async getContextMessages(conversation: CONVERSATION): Promise<Message[]> {
-    let messageCount = Math.ceil(conversation.settings.contextLength / 300)
-    if (messageCount < 2) {
-      messageCount = 2
-    }
-    return this.ctx.messageManager.getContextMessages(conversation.id, messageCount)
-  }
-
-  private throwIfCancelled(messageId: string): void {
-    if (this.isMessageCancelled(messageId)) {
-      throw new Error('common.error.userCanceledGeneration')
-    }
-  }
-
-  private isMessageCancelled(messageId: string): boolean {
-    const state = this.generatingMessages.get(messageId)
-    return !state || state.isCancelled === true
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamUpdateScheduler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamUpdateScheduler.ts
deleted file mode 100644
index cbcf4e646..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamUpdateScheduler.ts
+++ /dev/null
@@ -1,433 +0,0 @@
-import { eventBus, SendTarget } from '@/eventbus'
-import { STREAM_EVENTS } from '@/events'
-import type { LLMAgentEventData } from '@shared/presenter'
-
-export const STREAM_RENDER_FLUSH_INTERVAL_MS = 120
-export const STREAM_DB_FLUSH_INTERVAL_MS = 600
-
-interface PendingDelta {
-  content?: string
-  reasoning_content?: string
-  reasoning_time?: { start: number; end: number }
-  tool_call?: LLMAgentEventData['tool_call']
-  tool_call_id?: string
-  tool_call_name?: string
-  tool_call_params?: string
-  tool_call_response?: string | Array<unknown>
-  tool_call_server_name?: string
-  tool_call_server_icons?: string
-  tool_call_server_description?: string
-  tool_call_response_raw?: unknown
-  permission_request?: LLMAgentEventData['permission_request']
-  question_request?: LLMAgentEventData['question_request']
-  question_error?: LLMAgentEventData['question_error']
-  maximum_tool_calls_reached?: boolean
-  image_data?: { data: string; mimeType: string }
-  rate_limit?: LLMAgentEventData['rate_limit']
-  totalUsage?: LLMAgentEventData['totalUsage']
-}
-
-interface SchedulerState {
-  eventId: string
-  conversationId: string
-  parentId?: string
-  isVariant: boolean
-  webContentsId?: number
-  pendingDelta: PendingDelta
-  contentSnapshot?: unknown
-  seq: number
-  hasSentInit: boolean
-  lastRenderFlushAt: number
-  lastDbFlushAt: number
-  renderTimer?: NodeJS.Timeout
-  dbTimer?: NodeJS.Timeout
-}
-
-export class StreamUpdateScheduler {
-  private readonly states: Map<string, SchedulerState> = new Map()
-  private readonly messageManager: any
-  private readonly onFlushRender?: () => void
-
-  constructor(options: { messageManager: any; onFlushRender?: () => void }) {
-    this.messageManager = options.messageManager
-    this.onFlushRender = options.onFlushRender
-  }
-
-  private getStateOrCreate(options: {
-    eventId: string
-    conversationId: string
-    parentId?: string
-    isVariant: boolean
-    webContentsId?: number
-  }): SchedulerState {
-    let state = this.states.get(options.eventId)
-    if (!state) {
-      state = {
-        eventId: options.eventId,
-        conversationId: options.conversationId,
-        parentId: options.parentId,
-        isVariant: options.isVariant,
-        webContentsId: options.webContentsId,
-        pendingDelta: {},
-        seq: 0,
-        hasSentInit: false,
-        lastRenderFlushAt: 0,
-        lastDbFlushAt: 0
-      }
-      this.states.set(options.eventId, state)
-    }
-    return state
-  }
-
-  enqueueDelta(
-    eventId: string,
-    conversationId: string,
-    parentId: string | undefined,
-    isVariant: boolean,
-    webContentsId: number | undefined,
-    delta: Partial<LLMAgentEventData>,
-    contentSnapshot?: unknown
-  ): void {
-    if (delta.content && delta.reasoning_content) {
-      const { content, reasoning_content, ...rest } = delta
-      this.enqueueDelta(
-        eventId,
-        conversationId,
-        parentId,
-        isVariant,
-        webContentsId,
-        {
-          ...rest,
-          content
-        },
-        contentSnapshot
-      )
-      this.enqueueDelta(
-        eventId,
-        conversationId,
-        parentId,
-        isVariant,
-        webContentsId,
-        {
-          reasoning_content
-        },
-        contentSnapshot
-      )
-      return
-    }
-
-    const state = this.getStateOrCreate({
-      eventId,
-      conversationId,
-      parentId,
-      isVariant,
-      webContentsId
-    })
-
-    if (contentSnapshot !== undefined) {
-      state.contentSnapshot = contentSnapshot
-    }
-
-    if (!state.hasSentInit) {
-      this.sendInit(state)
-    }
-
-    const shouldFlushImmediately = this.shouldFlushBeforeEnqueue(state, delta)
-    if (shouldFlushImmediately) {
-      this.flushRender(state)
-    }
-
-    if (delta.content) {
-      state.pendingDelta.content = (state.pendingDelta.content ?? '') + delta.content
-    }
-    if (delta.reasoning_content) {
-      state.pendingDelta.reasoning_content =
-        (state.pendingDelta.reasoning_content ?? '') + delta.reasoning_content
-    }
-    if (delta.reasoning_time) {
-      // Always use the latest reasoning_time (contains updated end time)
-      state.pendingDelta.reasoning_time = delta.reasoning_time
-    }
-    if (delta.tool_call !== undefined) {
-      state.pendingDelta.tool_call = delta.tool_call
-    }
-    if (delta.tool_call_id !== undefined) {
-      state.pendingDelta.tool_call_id = delta.tool_call_id
-    }
-    if (delta.tool_call_name !== undefined) {
-      state.pendingDelta.tool_call_name = delta.tool_call_name
-    }
-    if (delta.tool_call_params !== undefined) {
-      state.pendingDelta.tool_call_params = delta.tool_call_params
-    }
-    if (delta.tool_call_response !== undefined) {
-      state.pendingDelta.tool_call_response = delta.tool_call_response
-    }
-    if (delta.tool_call_server_name !== undefined) {
-      state.pendingDelta.tool_call_server_name = delta.tool_call_server_name
-    }
-    if (delta.tool_call_server_icons !== undefined) {
-      state.pendingDelta.tool_call_server_icons = delta.tool_call_server_icons
-    }
-    if (delta.tool_call_server_description !== undefined) {
-      state.pendingDelta.tool_call_server_description = delta.tool_call_server_description
-    }
-    if (delta.tool_call_response_raw !== undefined) {
-      state.pendingDelta.tool_call_response_raw = delta.tool_call_response_raw
-    }
-    if (delta.permission_request !== undefined) {
-      state.pendingDelta.permission_request = delta.permission_request
-    }
-    if (delta.question_request !== undefined) {
-      state.pendingDelta.question_request = delta.question_request
-    }
-    if (delta.question_error !== undefined) {
-      state.pendingDelta.question_error = delta.question_error
-    }
-    if (delta.maximum_tool_calls_reached !== undefined) {
-      state.pendingDelta.maximum_tool_calls_reached = delta.maximum_tool_calls_reached
-    }
-    if (delta.image_data !== undefined) {
-      state.pendingDelta.image_data = delta.image_data
-    }
-    if (delta.rate_limit !== undefined) {
-      state.pendingDelta.rate_limit = delta.rate_limit
-    }
-    if (delta.totalUsage !== undefined) {
-      state.pendingDelta.totalUsage = delta.totalUsage
-    }
-
-    const now = Date.now()
-
-    if (shouldFlushImmediately) {
-      this.flushRender(state)
-    } else {
-      const renderDelay = Math.max(
-        0,
-        STREAM_RENDER_FLUSH_INTERVAL_MS - (now - state.lastRenderFlushAt)
-      )
-      this.scheduleRenderFlush(state, renderDelay)
-    }
-
-    const dbDelay = Math.max(0, STREAM_DB_FLUSH_INTERVAL_MS - (now - state.lastDbFlushAt))
-    this.scheduleDbFlush(state, dbDelay)
-  }
-
-  private sendInit(state: SchedulerState): void {
-    state.hasSentInit = true
-
-    const eventData: LLMAgentEventData = {
-      eventId: state.eventId,
-      conversationId: state.conversationId,
-      parentId: state.parentId,
-      is_variant: state.isVariant,
-      stream_kind: 'init',
-      seq: state.seq
-    }
-
-    eventBus.sendToRenderer(STREAM_EVENTS.RESPONSE, SendTarget.ALL_WINDOWS, eventData)
-  }
-
-  private scheduleRenderFlush(state: SchedulerState, delayMs: number): void {
-    if (state.renderTimer) return
-
-    state.renderTimer = setTimeout(() => {
-      this.flushRender(state)
-    }, delayMs)
-  }
-
-  private flushRender(state: SchedulerState): void {
-    if (state.renderTimer) {
-      clearTimeout(state.renderTimer)
-      state.renderTimer = undefined
-    }
-
-    const delta = state.pendingDelta
-    const hasContent = Object.keys(delta).length > 0
-
-    if (hasContent) {
-      state.lastRenderFlushAt = Date.now()
-      state.seq += 1
-
-      const eventData: LLMAgentEventData = {
-        eventId: state.eventId,
-        conversationId: state.conversationId,
-        parentId: state.parentId,
-        is_variant: state.isVariant,
-        stream_kind: 'delta',
-        seq: state.seq,
-        content: delta.content,
-        reasoning_content: delta.reasoning_content,
-        reasoning_time: delta.reasoning_time,
-        tool_call: delta.tool_call,
-        tool_call_id: delta.tool_call_id,
-        tool_call_name: delta.tool_call_name,
-        tool_call_params: delta.tool_call_params,
-        tool_call_response: delta.tool_call_response,
-        tool_call_server_name: delta.tool_call_server_name,
-        tool_call_server_icons: delta.tool_call_server_icons,
-        tool_call_server_description: delta.tool_call_server_description,
-        tool_call_response_raw: delta.tool_call_response_raw,
-        permission_request: delta.permission_request,
-        question_request: delta.question_request,
-        question_error: delta.question_error,
-        maximum_tool_calls_reached: delta.maximum_tool_calls_reached,
-        image_data: delta.image_data,
-        rate_limit: delta.rate_limit,
-        totalUsage: delta.totalUsage
-      }
-
-      eventBus.sendToRenderer(STREAM_EVENTS.RESPONSE, SendTarget.ALL_WINDOWS, eventData)
-      state.pendingDelta = {}
-    }
-
-    this.onFlushRender?.()
-  }
-
-  private scheduleDbFlush(state: SchedulerState, delayMs: number): void {
-    if (state.dbTimer) return
-
-    state.dbTimer = setTimeout(() => {
-      void this.flushDb(state)
-    }, delayMs)
-  }
-
-  private getDeltaKind(
-    delta: Partial<LLMAgentEventData> | PendingDelta
-  ): 'tool_call' | 'image' | 'rate_limit' | 'reasoning' | 'content' | 'mixed' | null {
-    if (delta.tool_call !== undefined) return 'tool_call'
-    if (delta.image_data !== undefined) return 'image'
-    if (delta.rate_limit !== undefined) return 'rate_limit'
-    if (delta.content && delta.reasoning_content) return 'mixed'
-    if (delta.reasoning_content) return 'reasoning'
-    if (delta.content) return 'content'
-    return null
-  }
-
-  private shouldFlushBeforeEnqueue(
-    state: SchedulerState,
-    delta: Partial<LLMAgentEventData>
-  ): boolean {
-    if (Object.keys(state.pendingDelta).length === 0) return false
-
-    const pendingKind = this.getDeltaKind(state.pendingDelta)
-    const incomingKind = this.getDeltaKind(delta)
-    if (!pendingKind || !incomingKind) return false
-
-    if (pendingKind !== incomingKind) return true
-
-    if (pendingKind === 'image' || pendingKind === 'rate_limit') {
-      return true
-    }
-
-    if (pendingKind === 'tool_call') {
-      if (state.pendingDelta.tool_call !== delta.tool_call) return true
-      if (
-        state.pendingDelta.tool_call_id &&
-        delta.tool_call_id &&
-        state.pendingDelta.tool_call_id !== delta.tool_call_id
-      ) {
-        return true
-      }
-      if (
-        state.pendingDelta.tool_call_name &&
-        delta.tool_call_name &&
-        state.pendingDelta.tool_call_name !== delta.tool_call_name
-      ) {
-        return true
-      }
-    }
-
-    return false
-  }
-
-  private flushDb(state: SchedulerState): Promise<void> {
-    state.lastDbFlushAt = Date.now()
-
-    if (state.dbTimer) {
-      clearTimeout(state.dbTimer)
-      state.dbTimer = undefined
-    }
-
-    if (!state.contentSnapshot) {
-      return Promise.resolve()
-    }
-
-    return this.messageManager
-      .editMessageSilently(state.eventId, JSON.stringify(state.contentSnapshot))
-      .catch((err: unknown) => {
-        console.error('[StreamUpdateScheduler] Failed to flush DB:', err)
-      })
-  }
-
-  async flushAll(eventId: string, kind: 'final' = 'final'): Promise<void> {
-    const state = this.states.get(eventId)
-    if (!state) return
-
-    if (state.renderTimer) {
-      clearTimeout(state.renderTimer)
-      state.renderTimer = undefined
-    }
-    if (state.dbTimer) {
-      clearTimeout(state.dbTimer)
-      state.dbTimer = undefined
-    }
-
-    const delta = state.pendingDelta
-    const hasContent = Object.keys(delta).length > 0
-
-    if (hasContent) {
-      state.seq += 1
-
-      const eventData: LLMAgentEventData = {
-        eventId: state.eventId,
-        conversationId: state.conversationId,
-        parentId: state.parentId,
-        is_variant: state.isVariant,
-        stream_kind: kind,
-        seq: state.seq,
-        content: delta.content,
-        reasoning_content: delta.reasoning_content,
-        reasoning_time: delta.reasoning_time,
-        tool_call: delta.tool_call,
-        tool_call_id: delta.tool_call_id,
-        tool_call_name: delta.tool_call_name,
-        tool_call_params: delta.tool_call_params,
-        tool_call_response: delta.tool_call_response,
-        tool_call_server_name: delta.tool_call_server_name,
-        tool_call_server_icons: delta.tool_call_server_icons,
-        tool_call_server_description: delta.tool_call_server_description,
-        tool_call_response_raw: delta.tool_call_response_raw,
-        permission_request: delta.permission_request,
-        question_request: delta.question_request,
-        question_error: delta.question_error,
-        maximum_tool_calls_reached: delta.maximum_tool_calls_reached,
-        image_data: delta.image_data,
-        rate_limit: delta.rate_limit,
-        totalUsage: delta.totalUsage
-      }
-
-      eventBus.sendToRenderer(STREAM_EVENTS.RESPONSE, SendTarget.ALL_WINDOWS, eventData)
-    }
-
-    await this.flushDb(state)
-
-    this.states.delete(eventId)
-  }
-
-  cleanup(eventId: string): void {
-    const state = this.states.get(eventId)
-    if (!state) return
-
-    if (state.renderTimer) {
-      clearTimeout(state.renderTimer)
-      state.renderTimer = undefined
-    }
-    if (state.dbTimer) {
-      clearTimeout(state.dbTimer)
-      state.dbTimer = undefined
-    }
-
-    this.states.delete(eventId)
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/types.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/types.ts
deleted file mode 100644
index e960eedf5..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/types.ts
+++ /dev/null
@@ -1,38 +0,0 @@
-import type { AssistantMessage } from '@shared/chat'
-import type { PendingToolCall } from '../message/messageBuilder'
-
-export interface GeneratingMessageState {
-  message: AssistantMessage
-  conversationId: string
-  startTime: number
-  firstTokenTime: number | null
-  promptTokens: number
-  reasoningStartTime: number | null
-  reasoningEndTime: number | null
-  lastReasoningTime: number | null
-  isCancelled?: boolean
-  pendingToolCall?: PendingToolCall
-  totalUsage?: {
-    prompt_tokens: number
-    completion_tokens: number
-    total_tokens: number
-    context_length: number
-  }
-  adaptiveBuffer?: {
-    content: string
-    lastUpdateTime: number
-    updateCount: number
-    totalSize: number
-    isLargeContent: boolean
-    chunks?: string[]
-    currentChunkIndex?: number
-    sentPosition: number
-    isProcessing?: boolean
-  }
-  flushTimeout?: NodeJS.Timeout
-  throttleTimeout?: NodeJS.Timeout
-  lastRendererUpdateTime?: number
-  webContentsId?: number
-}
-
-export type { StreamUpdateScheduler } from './streamUpdateScheduler'
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolCallCenter.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolCallCenter.ts
deleted file mode 100644
index 86e09d92d..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolCallCenter.ts
+++ /dev/null
@@ -1,34 +0,0 @@
-import type {
-  IToolPresenter,
-  MCPToolCall,
-  MCPToolDefinition,
-  MCPToolResponse
-} from '@shared/presenter'
-
-export type ToolCallContext = {
-  enabledMcpTools?: string[]
-  disabledAgentTools?: string[]
-  chatMode?: 'agent' | 'acp agent'
-  supportsVision?: boolean
-  agentWorkspacePath?: string | null
-  conversationId?: string
-}
-
-export class ToolCallCenter {
-  constructor(private readonly toolPresenter: IToolPresenter) {}
-
-  async getAllToolDefinitions(context: ToolCallContext): Promise<MCPToolDefinition[]> {
-    return this.toolPresenter.getAllToolDefinitions(context)
-  }
-
-  async callTool(request: MCPToolCall): Promise<{ content: unknown; rawData: MCPToolResponse }> {
-    return this.toolPresenter.callTool(request)
-  }
-
-  buildToolSystemPrompt(context: {
-    conversationId?: string
-    toolDefinitions?: MCPToolDefinition[]
-  }): string {
-    return this.toolPresenter.buildToolSystemPrompt(context)
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRegistry.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRegistry.ts
deleted file mode 100644
index 1836bb876..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRegistry.ts
+++ /dev/null
@@ -1,22 +0,0 @@
-export type ToolRegistrySource = 'mcp' | 'agent' | 'browser' | 'builtin'
-
-export type ToolRegistryEntry = {
-  name: string
-  source: ToolRegistrySource
-}
-
-export class ToolRegistry {
-  private readonly registry = new Map<string, ToolRegistryEntry>()
-
-  register(entry: ToolRegistryEntry): void {
-    this.registry.set(entry.name, entry)
-  }
-
-  get(name: string): ToolRegistryEntry | undefined {
-    return this.registry.get(name)
-  }
-
-  list(): ToolRegistryEntry[] {
-    return Array.from(this.registry.values())
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRouter.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRouter.ts
deleted file mode 100644
index 15a70cd65..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/tool/toolRouter.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-import type { ToolRegistrySource } from './toolRegistry'
-
-export type ToolRouteDecision = {
-  target: ToolRegistrySource
-  permissionType?: 'read' | 'write' | 'all' | 'command'
-}
-
-export function resolveToolRoute(_toolName: string): ToolRouteDecision {
-  return { target: 'mcp' }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types.ts
deleted file mode 100644
index 88ffb3de0..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types.ts
+++ /dev/null
@@ -1,7 +0,0 @@
-export type {
-  SessionContext,
-  SessionContextResolved,
-  SessionStatus
-} from './session/sessionContext'
-export type { SessionResolveInput } from './session/sessionResolver'
-export { resolveSessionContext } from './session/sessionResolver'
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types/handlerContext.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types/handlerContext.ts
deleted file mode 100644
index 08e76622a..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/types/handlerContext.ts
+++ /dev/null
@@ -1,82 +0,0 @@
-import type {
-  IConfigPresenter,
-  ILlmProviderPresenter,
-  ISQLitePresenter,
-  IToolPresenter
-} from '@shared/presenter'
-import type { CONVERSATION } from '@shared/presenter'
-import type { MessageManager } from '../../sessionPresenter/managers/messageManager'
-import type { AgentSessionRuntimePort } from '../session/sessionRuntimePort'
-import type {
-  AgentMcpRuntimePort,
-  AgentPermissionRuntimePort,
-  AgentPromptRuntimePort
-} from '../runtimePorts'
-
-export type ThreadHandlerContext = {
-  sqlitePresenter: ISQLitePresenter
-  messageManager: MessageManager
-  llmProviderPresenter: ILlmProviderPresenter
-  configPresenter: IConfigPresenter
-  sessionRuntime: AgentSessionRuntimePort
-  toolPresenter: IToolPresenter
-  mcpRuntime: AgentMcpRuntimePort
-  promptRuntime: AgentPromptRuntimePort
-  permissionRuntime: AgentPermissionRuntimePort
-}
-
-export class BaseHandler {
-  protected ctx: ThreadHandlerContext
-
-  constructor(context: ThreadHandlerContext) {
-    this.ctx = context
-  }
-
-  protected get sqlitePresenter(): ISQLitePresenter {
-    return this.ctx.sqlitePresenter
-  }
-
-  protected get messageManager(): MessageManager {
-    return this.ctx.messageManager
-  }
-
-  protected get llmProviderPresenter(): ILlmProviderPresenter {
-    return this.ctx.llmProviderPresenter
-  }
-
-  protected get configPresenter(): IConfigPresenter {
-    return this.ctx.configPresenter
-  }
-
-  protected get sessionRuntime(): AgentSessionRuntimePort {
-    return this.ctx.sessionRuntime
-  }
-
-  protected get toolPresenter(): IToolPresenter {
-    return this.ctx.toolPresenter
-  }
-
-  protected get mcpRuntime(): AgentMcpRuntimePort {
-    return this.ctx.mcpRuntime
-  }
-
-  protected get promptRuntime(): AgentPromptRuntimePort {
-    return this.ctx.promptRuntime
-  }
-
-  protected get permissionRuntime(): AgentPermissionRuntimePort {
-    return this.ctx.permissionRuntime
-  }
-
-  protected async getMessage(messageId: string) {
-    return this.messageManager.getMessage(messageId)
-  }
-
-  protected async getConversation(conversationId: string): Promise<CONVERSATION> {
-    const conversation = await this.ctx.sqlitePresenter.getConversation(conversationId)
-    if (!conversation) {
-      throw new Error('Conversation not found')
-    }
-    return conversation
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/promptEnhancer.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/promptEnhancer.ts
deleted file mode 100644
index 3f412787e..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/promptEnhancer.ts
+++ /dev/null
@@ -1,16 +0,0 @@
-interface EnhanceOptions {
-  isImageGeneration?: boolean
-  agentWorkspacePath?: string | null
-  platform?: NodeJS.Platform
-}
-
-export function enhanceSystemPromptWithDateTime(
-  systemPrompt: string,
-  options: EnhanceOptions = {}
-): string {
-  const { isImageGeneration = false } = options
-
-  if (isImageGeneration) return systemPrompt
-
-  return systemPrompt?.trim() ?? ''
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/utilityHandler.ts b/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/utilityHandler.ts
deleted file mode 100644
index 39cc2ed69..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/utility/utilityHandler.ts
+++ /dev/null
@@ -1,329 +0,0 @@
-import type {
-  ChatMessage,
-  CONVERSATION,
-  CONVERSATION_SETTINGS,
-  LLMAgentEventData
-} from '@shared/presenter'
-import type { AssistantMessageBlock, Message, UserMessageContent } from '@shared/chat'
-import { BaseHandler, type ThreadHandlerContext } from '../types/handlerContext'
-import { buildUserMessageContext } from '../message/messageFormatter'
-import {
-  buildConversationExportContent,
-  generateExportFilename,
-  type ConversationExportFormat
-} from '../../exporter/formats/conversationExporter'
-
-// Translation constants
-const TRANSLATION_TEMPERATURE = 0.3
-const TRANSLATION_TIMEOUT_MS = 1000
-
-// Message length constant for context calculation
-const DEFAULT_MESSAGE_LENGTH = 300
-
-export interface UtilityHandlerOptions {
-  getActiveConversation: (webContentsId: number) => Promise<CONVERSATION | null>
-  getActiveConversationId: (webContentsId: number) => Promise<string | null>
-  createConversation: (
-    title: string,
-    settings: Partial<CONVERSATION_SETTINGS>,
-    webContentsId: number
-  ) => Promise<string>
-}
-
-export class UtilityHandler extends BaseHandler {
-  private readonly getActiveConversation: (webContentsId: number) => Promise<CONVERSATION | null>
-  private readonly getActiveConversationId: (webContentsId: number) => Promise<string | null>
-  private readonly createConversation: (
-    title: string,
-    settings: Partial<CONVERSATION_SETTINGS>,
-    webContentsId: number
-  ) => Promise<string>
-
-  constructor(context: ThreadHandlerContext, options: UtilityHandlerOptions) {
-    super(context)
-    this.getActiveConversation = options.getActiveConversation
-    this.getActiveConversationId = options.getActiveConversationId
-    this.createConversation = options.createConversation
-  }
-
-  async translateText(text: string, webContentsId: number): Promise<string> {
-    try {
-      let conversation = await this.getActiveConversation(webContentsId)
-      if (!conversation) {
-        // Create a temporary conversation for translation
-        const defaultProvider = this.ctx.configPresenter.getDefaultProviders()[0]
-        const models = await this.ctx.llmProviderPresenter.getModelList(defaultProvider.id)
-        const defaultModel = models[0]
-        const conversationId = await this.createConversation(
-          'Temporary translation conversation',
-          {
-            modelId: defaultModel.id,
-            providerId: defaultProvider.id
-          },
-          webContentsId
-        )
-        conversation = await this.getConversation(conversationId)
-      }
-
-      const { providerId, modelId } = conversation.settings
-      const messages: ChatMessage[] = [
-        {
-          role: 'system',
-          content:
-            'You are a translation assistant. Translate the user input to Chinese and return only the translated text without any additional content.'
-        },
-        {
-          role: 'user',
-          content: text
-        }
-      ]
-
-      let translatedText = ''
-      const stream = this.ctx.llmProviderPresenter.startStreamCompletion(
-        providerId,
-        messages,
-        modelId,
-        'translate-' + Date.now(),
-        TRANSLATION_TEMPERATURE,
-        TRANSLATION_TIMEOUT_MS
-      )
-
-      for await (const event of stream) {
-        if (event.type === 'response') {
-          const msg = event.data as LLMAgentEventData
-          if (msg.content) {
-            translatedText += msg.content
-          }
-        } else if (event.type === 'error') {
-          const msg = event.data as { eventId: string; error: string }
-          throw new Error(msg.error || 'Translation failed')
-        }
-      }
-
-      return translatedText.trim()
-    } catch (error) {
-      console.error('Translation failed:', error)
-      if (error instanceof Error) {
-        error.message = 'Translation failed'
-        throw error
-      }
-      throw new Error('Translation failed')
-    }
-  }
-
-  async askAI(text: string, webContentsId: number): Promise<string> {
-    try {
-      let conversation = await this.getActiveConversation(webContentsId)
-      if (!conversation) {
-        // Create a temporary conversation for AI query
-        const defaultProvider = this.ctx.configPresenter.getDefaultProviders()[0]
-        const models = await this.ctx.llmProviderPresenter.getModelList(defaultProvider.id)
-        const defaultModel = models[0]
-        const conversationId = await this.createConversation(
-          '临时AI对话',
-          {
-            modelId: defaultModel.id,
-            providerId: defaultProvider.id
-          },
-          webContentsId
-        )
-        conversation = await this.getConversation(conversationId)
-      }
-
-      const { providerId, modelId } = conversation.settings
-      const messages: ChatMessage[] = [
-        {
-          role: 'system',
-          content: '你是一个AI助手。请简洁地回答用户的问题。'
-        },
-        {
-          role: 'user',
-          content: text
-        }
-      ]
-
-      let aiAnswer = ''
-      const stream = this.ctx.llmProviderPresenter.startStreamCompletion(
-        providerId,
-        messages,
-        modelId,
-        'ask-ai-' + Date.now(),
-        0.7,
-        1000
-      )
-
-      for await (const event of stream) {
-        if (event.type === 'response') {
-          const msg = event.data as LLMAgentEventData
-          if (msg.content) {
-            aiAnswer += msg.content
-          }
-        } else if (event.type === 'error') {
-          const msg = event.data as { eventId: string; error: string }
-          throw new Error(msg.error || 'AI回答失败')
-        }
-      }
-
-      return aiAnswer.trim()
-    } catch (error) {
-      console.error('AI query failed:', error)
-      throw error
-    }
-  }
-
-  async exportConversation(
-    conversationId: string,
-    format: ConversationExportFormat = 'markdown'
-  ): Promise<{ filename: string; content: string }> {
-    try {
-      // Get conversation
-      const conversation = await this.getConversation(conversationId)
-      if (!conversation) {
-        throw new Error('Conversation not found')
-      }
-
-      // Get all messages
-      const { list: messages } = await this.ctx.messageManager.getMessageThread(
-        conversationId,
-        1,
-        10000
-      )
-
-      // Filter out unsent messages
-      const validMessages = messages.filter((msg) => msg.status === 'sent')
-
-      // Apply variant selection
-      const selectedVariantsMap = conversation.settings.selectedVariantsMap || {}
-      const variantAwareMessages = this.applyVariantSelection(validMessages, selectedVariantsMap)
-
-      // Generate filename
-      const filename = generateExportFilename(format)
-      const content = buildConversationExportContent(conversation, variantAwareMessages, format)
-
-      return { filename, content }
-    } catch (error) {
-      console.error('Failed to export conversation:', error)
-      throw error
-    }
-  }
-
-  async summaryTitles(webContentsId?: number, conversationId?: string): Promise<string> {
-    const activeId =
-      webContentsId !== undefined ? await this.getActiveConversationId(webContentsId) : null
-    const targetConversationId = conversationId ?? activeId ?? undefined
-    if (!targetConversationId) {
-      throw new Error('Conversation not found')
-    }
-    const conversation = await this.getConversation(targetConversationId)
-    if (!conversation) {
-      throw new Error('Conversation not found')
-    }
-
-    // Get context messages
-    let messageCount = Math.ceil(conversation.settings.contextLength / DEFAULT_MESSAGE_LENGTH)
-    if (messageCount < 2) {
-      messageCount = 2
-    }
-    const messages = await this.ctx.messageManager.getContextMessages(conversation.id, messageCount)
-
-    const selectedVariantsMap = conversation.settings.selectedVariantsMap || {}
-    const variantAwareMessages = this.applyVariantSelection(messages, selectedVariantsMap)
-    const messagesWithLength = variantAwareMessages
-      .map((msg) => {
-        if (msg.role === 'user') {
-          const userContent = msg.content as UserMessageContent
-          const serializedContent = buildUserMessageContext(userContent)
-          return {
-            message: msg,
-            length: serializedContent.length,
-            formattedMessage: {
-              role: 'user' as const,
-              content: serializedContent
-            }
-          }
-        } else {
-          const content = (msg.content as AssistantMessageBlock[])
-            .filter((block) => block.type === 'content')
-            .map((block) => block.content)
-            .join('\n')
-          return {
-            message: msg,
-            length: content.length,
-            formattedMessage: {
-              role: 'assistant' as const,
-              content: content
-            }
-          }
-        }
-      })
-      .filter((item) => item.formattedMessage.content.length > 0)
-    const assistantModel = this.ctx.configPresenter.getSetting<{
-      providerId: string
-      modelId: string
-    }>('assistantModel')
-    const fallbackProviderId = conversation.settings.providerId
-    const fallbackModelId = conversation.settings.modelId
-    const preferredProviderId = assistantModel?.providerId || fallbackProviderId
-    const preferredModelId = assistantModel?.modelId || fallbackModelId
-
-    let title: string
-    try {
-      title = await this.ctx.llmProviderPresenter.summaryTitles(
-        messagesWithLength.map((item) => item.formattedMessage),
-        preferredProviderId,
-        preferredModelId
-      )
-    } catch (error) {
-      const shouldFallback =
-        preferredProviderId !== fallbackProviderId || preferredModelId !== fallbackModelId
-      if (!shouldFallback) {
-        throw error
-      }
-      console.warn(
-        '[UtilityHandler] Failed to generate title with assistant model, fallback to conversation model',
-        {
-          preferredProviderId,
-          preferredModelId,
-          fallbackProviderId,
-          fallbackModelId,
-          error
-        }
-      )
-      title = await this.ctx.llmProviderPresenter.summaryTitles(
-        messagesWithLength.map((item) => item.formattedMessage),
-        fallbackProviderId,
-        fallbackModelId
-      )
-    }
-    let cleanedTitle = title.replace(/<think>.*?<\/think>/g, '').trim()
-    cleanedTitle = cleanedTitle.replace(/^<think>/, '').trim()
-    return cleanedTitle
-  }
-
-  /**
-   * Applies variant selection to messages based on selectedVariantsMap.
-   * Returns messages with selected variant fields applied when a variant is selected.
-   */
-  private applyVariantSelection(
-    messages: Message[],
-    selectedVariantsMap: Record<string, string>
-  ): Message[] {
-    return messages.map((msg) => {
-      if (msg.role === 'assistant' && selectedVariantsMap[msg.id] && msg.variants) {
-        const selectedVariantId = selectedVariantsMap[msg.id]
-        const selectedVariant = msg.variants.find((v) => v.id === selectedVariantId)
-
-        if (selectedVariant) {
-          const newMsg = JSON.parse(JSON.stringify(msg))
-          newMsg.content = selectedVariant.content
-          newMsg.usage = selectedVariant.usage
-          newMsg.model_id = selectedVariant.model_id
-          newMsg.model_provider = selectedVariant.model_provider
-          newMsg.model_name = selectedVariant.model_name
-          return newMsg
-        }
-      }
-      return msg
-    })
-  }
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/src/shared/types/presenters/agent.presenter.d.ts b/archives/code/legacy-agentpresenter-retirement/src/shared/types/presenters/agent.presenter.d.ts
deleted file mode 100644
index 84ef9a2d7..000000000
--- a/archives/code/legacy-agentpresenter-retirement/src/shared/types/presenters/agent.presenter.d.ts
+++ /dev/null
@@ -1,42 +0,0 @@
-import type { AssistantMessage } from '@shared/chat'
-
-export interface IAgentPresenter {
-  sendMessage(
-    agentId: string,
-    content: string,
-    webContentsId?: number,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage | null>
-  continueLoop(
-    agentId: string,
-    messageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage | null>
-  cancelLoop(messageId: string): Promise<void>
-  retryMessage(
-    messageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage>
-  regenerateFromUserMessage(
-    agentId: string,
-    userMessageId: string,
-    selectedVariantsMap?: Record<string, string>
-  ): Promise<AssistantMessage>
-  translateText(text: string, webContentsId: number): Promise<string>
-  askAI(text: string, webContentsId: number): Promise<string>
-  handlePermissionResponse(
-    messageId: string,
-    toolCallId: string,
-    granted: boolean,
-    permissionType: 'read' | 'write' | 'all' | 'command',
-    remember?: boolean
-  ): Promise<void>
-  resolveQuestion(
-    messageId: string,
-    toolCallId: string,
-    answerText: string,
-    answerMessageId?: string
-  ): Promise<void>
-  rejectQuestion(messageId: string, toolCallId: string): Promise<void>
-  cleanupConversation(conversationId: string): Promise<void>
-}
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/agentPresenter.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/agentPresenter.test.ts
deleted file mode 100644
index 32ebdf072..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/agentPresenter.test.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import * as agentPresenterModule from '../../../../src/main/presenter/agentPresenter'
-
-describe('AgentPresenter scaffolding', () => {
-  it('loads module entrypoint', () => {
-    expect(agentPresenterModule).toBeDefined()
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/agentLoopHandler.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/agentLoopHandler.test.ts
deleted file mode 100644
index 8b3203c8b..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/agentLoopHandler.test.ts
+++ /dev/null
@@ -1,89 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { AgentLoopHandler } from '@/presenter/agentPresenter/loop/agentLoopHandler'
-
-vi.mock('@/eventbus', () => ({
-  eventBus: {
-    sendToRenderer: vi.fn()
-  },
-  SendTarget: {
-    ALL_WINDOWS: 'ALL_WINDOWS'
-  }
-}))
-
-describe('AgentLoopHandler session runtime wiring', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('resolves model and workspace through injected session runtime in tool processing', async () => {
-    const toolPresenter = {
-      getAllToolDefinitions: vi.fn().mockResolvedValue([
-        {
-          function: {
-            name: 'read'
-          },
-          server: {
-            name: 'agent-filesystem',
-            icons: '',
-            description: 'Filesystem'
-          }
-        }
-      ]),
-      preCheckToolPermission: vi.fn().mockResolvedValue(null),
-      callTool: vi.fn().mockResolvedValue({
-        content: 'ok',
-        rawData: {}
-      })
-    }
-    const sessionRuntime = {
-      getSession: vi.fn().mockResolvedValue({
-        resolved: {
-          modelId: 'model-from-session'
-        }
-      }),
-      resolveWorkspaceContext: vi.fn().mockResolvedValue({
-        chatMode: 'agent',
-        agentWorkspacePath: 'C:/workspace'
-      })
-    }
-    const handler = new AgentLoopHandler({
-      configPresenter: {} as any,
-      getProviderInstance: vi.fn() as any,
-      activeStreams: new Map(),
-      canStartNewStream: vi.fn().mockReturnValue(true),
-      rateLimitManager: {} as any,
-      sessionRuntime,
-      getToolPresenter: () => toolPresenter as any
-    })
-
-    const processor = (handler as any).toolCallProcessor.process({
-      eventId: 'evt-loop',
-      toolCalls: [{ id: 'tool-1', name: 'read', arguments: '{}' }],
-      enabledMcpTools: [],
-      conversationMessages: [],
-      modelConfig: {
-        functionCall: false,
-        type: 'chat'
-      },
-      abortSignal: new AbortController().signal,
-      currentToolCallCount: 0,
-      maxToolCalls: 5,
-      conversationId: 'conv-loop',
-      providerId: 'mock-provider'
-    })
-
-    while (true) {
-      const next = await processor.next()
-      if (next.done) {
-        break
-      }
-    }
-
-    expect(sessionRuntime.getSession).toHaveBeenCalledWith('conv-loop')
-    expect(sessionRuntime.resolveWorkspaceContext).toHaveBeenCalledWith(
-      'conv-loop',
-      'model-from-session'
-    )
-    expect(toolPresenter.getAllToolDefinitions).toHaveBeenCalled()
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/toolCallProcessor.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/toolCallProcessor.test.ts
deleted file mode 100644
index b6efea844..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/loop/toolCallProcessor.test.ts
+++ /dev/null
@@ -1,310 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import fs from 'fs/promises'
-import os from 'os'
-import path from 'path'
-import { app } from 'electron'
-import { ToolCallProcessor } from '@/presenter/agentPresenter/loop/toolCallProcessor'
-import type {
-  ChatMessage,
-  MCPToolDefinition,
-  MCPToolResponse,
-  ModelConfig
-} from '@shared/presenter'
-
-vi.mock('@/presenter', () => ({
-  presenter: {
-    hooksNotifications: {
-      dispatchEvent: vi.fn()
-    }
-  }
-}))
-
-describe('ToolCallProcessor tool output offload', () => {
-  let tempHome: string
-  let getPathSpy: ReturnType<typeof vi.spyOn>
-
-  const toolDefinition = {
-    type: 'function',
-    function: {
-      name: 'exec',
-      description: 'execute command',
-      parameters: {
-        type: 'object',
-        properties: {}
-      }
-    },
-    server: {
-      name: 'mock',
-      icons: '',
-      description: ''
-    }
-  } as MCPToolDefinition
-
-  beforeEach(async () => {
-    tempHome = await fs.mkdtemp(path.join(os.tmpdir(), 'tool-offload-'))
-    getPathSpy = vi.spyOn(app, 'getPath').mockReturnValue(tempHome)
-  })
-
-  afterEach(async () => {
-    getPathSpy.mockRestore()
-    await fs.rm(tempHome, { recursive: true, force: true })
-  })
-
-  it('offloads large tool responses and returns stub content', async () => {
-    const longOutput = 'x'.repeat(5001)
-    const rawData = { content: longOutput } as MCPToolResponse
-    const processor = new ToolCallProcessor({
-      getAllToolDefinitions: async () => [toolDefinition],
-      callTool: async () => ({ content: longOutput, rawData })
-    })
-
-    const conversationMessages: ChatMessage[] = [{ role: 'assistant', content: 'hello' }]
-    const conversationId = 'conv-123'
-    const modelConfig = { functionCall: true } as ModelConfig
-
-    const events: any[] = []
-    for await (const event of processor.process({
-      eventId: 'event-1',
-      toolCalls: [{ id: 'tool:1', name: 'exec', arguments: '{}' }],
-      enabledMcpTools: [],
-      conversationMessages,
-      modelConfig,
-      abortSignal: new AbortController().signal,
-      currentToolCallCount: 0,
-      maxToolCalls: 5,
-      conversationId
-    })) {
-      events.push(event)
-    }
-
-    const endEvent = events.find(
-      (event) => event.type === 'response' && event.data?.tool_call === 'end'
-    )
-    expect(endEvent).toBeDefined()
-
-    const stub = endEvent.data.tool_call_response as string
-    const expectedPath = path.join(
-      tempHome,
-      '.deepchat',
-      'sessions',
-      conversationId,
-      'tool_tool_1.offload'
-    )
-    expect(stub).toContain('[Tool output offloaded]')
-    expect(stub).toContain(`Total characters: ${longOutput.length}`)
-    expect(stub).toContain(expectedPath)
-    expect(endEvent.data.tool_call_response_raw).toBe(rawData)
-
-    const saved = await fs.readFile(expectedPath, 'utf-8')
-    expect(saved).toBe(longOutput)
-
-    const toolMessage = conversationMessages.find((message) => message.role === 'tool')
-    expect(toolMessage?.content).toContain('[Tool output offloaded]')
-  })
-})
-
-describe('ToolCallProcessor question tool', () => {
-  const questionToolDef = {
-    type: 'function',
-    function: {
-      name: 'deepchat_question',
-      description: 'question tool',
-      parameters: {
-        type: 'object',
-        properties: {}
-      }
-    },
-    server: {
-      name: 'agent-core',
-      icons: '❓',
-      description: 'Agent core tools'
-    }
-  } as MCPToolDefinition
-
-  const executeCommandDef = {
-    type: 'function',
-    function: {
-      name: 'exec',
-      description: 'execute command',
-      parameters: {
-        type: 'object',
-        properties: {}
-      }
-    },
-    server: {
-      name: 'mock',
-      icons: '',
-      description: ''
-    }
-  } as MCPToolDefinition
-
-  const basicQuestionArgs = JSON.stringify({
-    question: 'Choose one',
-    options: [{ label: 'A' }, { label: 'B' }]
-  })
-
-  it('emits question-required and pauses the loop', async () => {
-    const callTool = vi.fn()
-    const processor = new ToolCallProcessor({
-      getAllToolDefinitions: async () => [questionToolDef],
-      callTool
-    })
-
-    const conversationMessages: ChatMessage[] = [{ role: 'assistant', content: 'hello' }]
-    const iterator = processor.process({
-      eventId: 'event-question-1',
-      toolCalls: [{ id: 'tool-q1', name: 'deepchat_question', arguments: basicQuestionArgs }],
-      enabledMcpTools: [],
-      conversationMessages,
-      modelConfig: { functionCall: true } as ModelConfig,
-      abortSignal: new AbortController().signal,
-      currentToolCallCount: 0,
-      maxToolCalls: 5,
-      conversationId: 'conv-question'
-    })
-
-    const events: any[] = []
-    let result: any = null
-    while (true) {
-      const { value, done } = await iterator.next()
-      if (done) {
-        result = value
-        break
-      }
-      events.push(value)
-    }
-
-    const questionEvent = events.find(
-      (event) => event.type === 'response' && event.data?.tool_call === 'question-required'
-    )
-    expect(questionEvent).toBeDefined()
-    expect(questionEvent.data.question_request?.question).toBe('Choose one')
-    expect(result.needContinueConversation).toBe(false)
-    expect(callTool).not.toHaveBeenCalled()
-  })
-
-  it('rejects non-standalone question tool calls', async () => {
-    const callTool = vi.fn(async () => ({
-      content: 'ok',
-      rawData: { content: 'ok' } as MCPToolResponse
-    }))
-    const processor = new ToolCallProcessor({
-      getAllToolDefinitions: async () => [questionToolDef, executeCommandDef],
-      callTool
-    })
-
-    const conversationMessages: ChatMessage[] = [{ role: 'assistant', content: 'hello' }]
-    const iterator = processor.process({
-      eventId: 'event-question-2',
-      toolCalls: [
-        { id: 'tool-q1', name: 'deepchat_question', arguments: basicQuestionArgs },
-        { id: 'tool-2', name: 'exec', arguments: '{}' }
-      ],
-      enabledMcpTools: [],
-      conversationMessages,
-      modelConfig: { functionCall: true } as ModelConfig,
-      abortSignal: new AbortController().signal,
-      currentToolCallCount: 0,
-      maxToolCalls: 5,
-      conversationId: 'conv-question'
-    })
-
-    const events: any[] = []
-    let result: any = null
-    while (true) {
-      const { value, done } = await iterator.next()
-      if (done) {
-        result = value
-        break
-      }
-      events.push(value)
-    }
-
-    const errorEvent = events.find(
-      (event) => event.type === 'response' && event.data?.question_error
-    )
-    expect(errorEvent).toBeDefined()
-    expect(result.needContinueConversation).toBe(true)
-    expect(callTool).toHaveBeenCalled()
-  })
-})
-
-describe('ToolCallProcessor batch permission pre-check', () => {
-  it('preserves extended permission payload fields for batch permission requests', async () => {
-    const toolDefinition = {
-      type: 'function',
-      function: {
-        name: 'edit',
-        description: 'edit file',
-        parameters: {
-          type: 'object',
-          properties: {}
-        }
-      },
-      server: {
-        name: 'agent-filesystem',
-        icons: '📁',
-        description: 'Agent filesystem'
-      }
-    } as MCPToolDefinition
-
-    const callTool = vi.fn(async () => ({
-      content: 'ok',
-      rawData: { content: 'ok' } as MCPToolResponse
-    }))
-    const preCheckToolPermission = vi.fn(async () => ({
-      needsPermission: true as const,
-      toolName: 'edit',
-      serverName: 'agent-filesystem',
-      permissionType: 'write' as const,
-      description: 'Write access requires approval',
-      paths: ['src/main.ts'],
-      customMeta: {
-        source: 'batch-precheck'
-      }
-    }))
-
-    const processor = new ToolCallProcessor({
-      getAllToolDefinitions: async () => [toolDefinition],
-      callTool,
-      preCheckToolPermission
-    })
-
-    const conversationMessages: ChatMessage[] = [{ role: 'assistant', content: 'hello' }]
-    const iterator = processor.process({
-      eventId: 'event-batch-permission',
-      toolCalls: [{ id: 'tool-1', name: 'edit', arguments: '{"path":"src/main.ts"}' }],
-      enabledMcpTools: [],
-      conversationMessages,
-      modelConfig: { functionCall: true } as ModelConfig,
-      abortSignal: new AbortController().signal,
-      currentToolCallCount: 0,
-      maxToolCalls: 5,
-      conversationId: 'conv-batch-permission'
-    })
-
-    const events: any[] = []
-    let result: any = null
-    while (true) {
-      const { value, done } = await iterator.next()
-      if (done) {
-        result = value
-        break
-      }
-      events.push(value)
-    }
-
-    const permissionEvent = events.find(
-      (event) => event.type === 'response' && event.data?.tool_call === 'permission-required'
-    )
-    expect(permissionEvent).toBeDefined()
-    expect(permissionEvent.data.permission_request.paths).toEqual(['src/main.ts'])
-    expect(permissionEvent.data.permission_request.customMeta).toEqual({
-      source: 'batch-precheck'
-    })
-    expect(permissionEvent.data.permission_request.isBatchPermission).toBe(true)
-    expect(permissionEvent.data.permission_request.totalInBatch).toBe(1)
-    expect(callTool).not.toHaveBeenCalled()
-    expect(result.needContinueConversation).toBe(false)
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/message/systemEnvPromptBuilder.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/message/systemEnvPromptBuilder.test.ts
deleted file mode 100644
index 4fef8fe73..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/message/systemEnvPromptBuilder.test.ts
+++ /dev/null
@@ -1,145 +0,0 @@
-import path from 'node:path'
-import * as fs from 'node:fs'
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { presenter } from '@/presenter'
-import logger from '@shared/logger'
-import {
-  buildRuntimeCapabilitiesPrompt,
-  buildSystemEnvPrompt
-} from '@/lib/agentRuntime/systemEnvPromptBuilder'
-
-vi.mock('node:fs', async (importOriginal) => {
-  const actual = await importOriginal<typeof import('node:fs')>()
-  return {
-    ...actual,
-    existsSync: vi.fn(),
-    promises: {
-      ...actual.promises,
-      readFile: vi.fn()
-    }
-  }
-})
-
-vi.mock('@/presenter', () => ({
-  presenter: {
-    configPresenter: {
-      getProviderModels: vi.fn(),
-      getCustomModels: vi.fn()
-    }
-  }
-}))
-
-vi.mock('@shared/logger', () => ({
-  default: {
-    warn: vi.fn()
-  }
-}))
-
-describe('systemEnvPromptBuilder', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-    ;(presenter.configPresenter.getProviderModels as ReturnType<typeof vi.fn>).mockReturnValue([])
-    ;(presenter.configPresenter.getCustomModels as ReturnType<typeof vi.fn>).mockReturnValue([])
-    ;(fs.existsSync as unknown as ReturnType<typeof vi.fn>).mockReturnValue(false)
-    ;(fs.promises.readFile as unknown as ReturnType<typeof vi.fn>).mockRejectedValue(
-      new Error('ENOENT')
-    )
-  })
-
-  it('builds env prompt with git=yes and AGENTS instructions', async () => {
-    const workdir = path.resolve(path.sep, 'workspace', 'deepchat')
-    const gitPath = path.join(workdir, '.git')
-    const agentsPath = path.join(workdir, 'AGENTS.md')
-
-    ;(fs.existsSync as unknown as ReturnType<typeof vi.fn>).mockImplementation(
-      (targetPath: string) => targetPath === gitPath
-    )
-    ;(fs.promises.readFile as unknown as ReturnType<typeof vi.fn>).mockResolvedValue(
-      '# Repository Guidelines\nLine 2'
-    )
-    ;(presenter.configPresenter.getProviderModels as ReturnType<typeof vi.fn>).mockReturnValue([
-      { id: 'model-a', name: 'Model A' }
-    ])
-
-    const prompt = await buildSystemEnvPrompt({
-      providerId: 'provider-x',
-      modelId: 'model-a',
-      workdir,
-      platform: 'win32',
-      now: new Date('2026-02-11T12:00:00.000Z')
-    })
-
-    expect(prompt).toContain('You are powered by the model named Model A.')
-    expect(prompt).toContain('The exact model ID is provider-x/model-a')
-    expect(prompt).toContain(`Working directory: ${workdir}`)
-    expect(prompt).toContain('Is directory a git repo: yes')
-    expect(prompt).toContain('Platform: win32')
-    expect(prompt).toContain("Today's date: Wed Feb 11 2026")
-    expect(prompt).toContain(`Instructions from: ${agentsPath}`)
-    expect(prompt).toContain('# Repository Guidelines\nLine 2')
-  })
-
-  it('falls back when AGENTS.md is missing and git=no', async () => {
-    const workdir = path.resolve(path.sep, 'workspace', 'deepchat')
-    const prompt = await buildSystemEnvPrompt({
-      providerId: 'provider-y',
-      modelId: 'model-b',
-      workdir,
-      platform: 'linux',
-      now: new Date('2026-02-11T12:00:00.000Z')
-    })
-
-    expect(prompt).toContain('You are powered by the model named model-b.')
-    expect(prompt).toContain('The exact model ID is provider-y/model-b')
-    expect(prompt).toContain('Is directory a git repo: no')
-    expect(prompt).not.toContain('Instructions from:')
-    expect(prompt).not.toContain('[SystemEnvPromptBuilder] AGENTS.md not available')
-    expect(logger.warn).toHaveBeenCalledWith(
-      '[SystemEnvPromptBuilder] Failed to read AGENTS.md',
-      expect.objectContaining({ sourcePath: path.join(workdir, 'AGENTS.md') })
-    )
-  })
-
-  it('builds stable runtime capabilities prompt', () => {
-    const prompt = buildRuntimeCapabilitiesPrompt()
-    expect(prompt).toContain('## Runtime Capabilities')
-    expect(prompt).toContain('YoBrowser')
-    expect(prompt).toContain('process(list|poll|log|write|kill|remove)')
-  })
-
-  it('omits runtime capability lines when related tools are unavailable', () => {
-    const prompt = buildRuntimeCapabilitiesPrompt({
-      hasYoBrowser: false,
-      hasExec: false,
-      hasProcess: false
-    })
-
-    expect(prompt).toBe('')
-  })
-
-  it('builds a partial runtime capabilities prompt when only exec is enabled', () => {
-    const prompt = buildRuntimeCapabilitiesPrompt({
-      hasYoBrowser: false,
-      hasExec: true,
-      hasProcess: false
-    })
-
-    expect(prompt).toContain('exec(background: true)')
-    expect(prompt).toContain('yield window')
-    expect(prompt).not.toContain('YoBrowser')
-    expect(prompt).not.toContain('process(list|poll|log|write|kill|remove)')
-  })
-
-  it('falls back to unknown provider/model identity', async () => {
-    const workdir = path.resolve(path.sep, 'workspace', 'deepchat')
-    const prompt = await buildSystemEnvPrompt({
-      providerId: '  ',
-      modelId: '',
-      workdir,
-      now: new Date('2026-02-11T12:00:00.000Z')
-    })
-
-    expect(prompt).toContain('You are powered by the model named unknown-model.')
-    expect(prompt).toContain('The exact model ID is unknown-provider/unknown-model')
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageBuilder.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageBuilder.test.ts
deleted file mode 100644
index 0648c15e7..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageBuilder.test.ts
+++ /dev/null
@@ -1,104 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-
-// messageBuilder imports the full main-process presenter graph; mock it out so we can unit-test
-// pure message-building utilities without initializing Electron/main presenters.
-vi.mock('@/presenter', () => ({ presenter: {} }))
-
-describe('messageBuilder.composeAgentSystemPromptSections', () => {
-  it('keeps fixed V2.1 section order', async () => {
-    const { composeAgentSystemPromptSections } =
-      await import('@/presenter/agentPresenter/message/messageBuilder')
-
-    const composed = composeAgentSystemPromptSections({
-      basePrompt: 'BASE',
-      runtimePrompt: 'RUNTIME',
-      skillsMetadataPrompt: 'SKILLS_META',
-      skillsPrompt: 'SKILLS_ACTIVE',
-      envPrompt: 'ENV',
-      toolingPrompt: 'TOOLING'
-    })
-
-    expect(composed).toBe('BASE\n\nRUNTIME\n\nSKILLS_META\n\nSKILLS_ACTIVE\n\nENV\n\nTOOLING')
-  })
-})
-
-describe('messageBuilder.buildPostToolExecutionContext', () => {
-  it('emits assistant(tool_calls) -> tool(tool_call_id) pairing when functionCall is enabled', async () => {
-    const { buildPostToolExecutionContext } =
-      await import('@/presenter/agentPresenter/message/messageBuilder')
-
-    const messages = await buildPostToolExecutionContext({
-      conversation: { settings: { systemPrompt: '' } } as any,
-      contextMessages: [],
-      userMessage: { role: 'user', content: { text: 'hi', files: [] } } as any,
-      currentAssistantMessage: {
-        role: 'assistant',
-        content: [{ type: 'content', content: 'calling tool' }]
-      } as any,
-      completedToolCall: {
-        id: 'call_1',
-        name: 'exec',
-        params: '{"command":"pwd"}',
-        response: '/tmp'
-      },
-      modelConfig: { functionCall: true } as any
-    })
-
-    expect(messages.map((m) => m.role)).toEqual(['user', 'assistant', 'tool'])
-    expect(messages[1].tool_calls?.[0]?.id).toBe('call_1')
-    expect(messages[2].tool_call_id).toBe('call_1')
-  })
-
-  it('generates a stable tool_call_id when upstream id is empty', async () => {
-    const { buildPostToolExecutionContext } =
-      await import('@/presenter/agentPresenter/message/messageBuilder')
-
-    const messages = await buildPostToolExecutionContext({
-      conversation: { settings: { systemPrompt: '' } } as any,
-      contextMessages: [],
-      userMessage: { role: 'user', content: { text: 'hi', files: [] } } as any,
-      currentAssistantMessage: {
-        role: 'assistant',
-        content: [{ type: 'content', content: 'calling tool' }]
-      } as any,
-      completedToolCall: {
-        id: '',
-        name: 'exec',
-        params: '{"command":"pwd"}',
-        response: '/tmp'
-      },
-      modelConfig: { functionCall: true } as any
-    })
-
-    const toolCallId = messages[1].tool_calls?.[0]?.id
-    expect(typeof toolCallId).toBe('string')
-    expect(toolCallId).toBeTruthy()
-    expect(messages[2].tool_call_id).toBe(toolCallId)
-  })
-
-  it('falls back to legacy function_call_record injection when functionCall is disabled', async () => {
-    const { buildPostToolExecutionContext } =
-      await import('@/presenter/agentPresenter/message/messageBuilder')
-
-    const messages = await buildPostToolExecutionContext({
-      conversation: { settings: { systemPrompt: '' } } as any,
-      contextMessages: [],
-      userMessage: { role: 'user', content: { text: 'hi', files: [] } } as any,
-      currentAssistantMessage: {
-        role: 'assistant',
-        content: [{ type: 'content', content: 'calling tool' }]
-      } as any,
-      completedToolCall: {
-        id: 'call_1',
-        name: 'exec',
-        params: '{"command":"pwd"}',
-        response: '/tmp'
-      },
-      modelConfig: { functionCall: false } as any
-    })
-
-    expect(messages.map((m) => m.role)).toEqual(['user', 'assistant', 'user'])
-    expect(String(messages[1].content)).toContain('<function_call>')
-    expect(messages.some((m) => m.role === 'tool')).toBe(false)
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageCompressor.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageCompressor.test.ts
deleted file mode 100644
index 4fe004b73..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/messageCompressor.test.ts
+++ /dev/null
@@ -1,109 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import type { AssistantMessageBlock, Message, UserMessageContent } from '@shared/chat'
-import { compressToolCallsFromContext } from '@/presenter/agentPresenter/message/messageCompressor'
-
-const baseUsage = {
-  context_usage: 0,
-  tokens_per_second: 0,
-  total_tokens: 0,
-  generation_time: 0,
-  first_token_time: 0,
-  reasoning_start_time: 0,
-  reasoning_end_time: 0,
-  input_tokens: 0,
-  output_tokens: 0
-}
-
-function createMessage(id: string, role: Message['role'], content: Message['content']): Message {
-  return {
-    id,
-    role,
-    content,
-    timestamp: Date.now(),
-    avatar: '',
-    name: '',
-    model_name: '',
-    model_id: '',
-    model_provider: '',
-    status: 'sent',
-    error: '',
-    usage: baseUsage,
-    conversationId: 'conversation',
-    is_variant: 0
-  }
-}
-
-function createUserContent(text: string): UserMessageContent {
-  return {
-    files: [],
-    links: [],
-    think: false,
-    search: false,
-    text,
-    content: [{ type: 'text', content: text }]
-  }
-}
-
-function createAssistantWithToolCall(id: string): Message {
-  const toolCallBlock: AssistantMessageBlock = {
-    type: 'tool_call',
-    status: 'success',
-    timestamp: Date.now(),
-    tool_call: {
-      id: 'tool-1',
-      name: 'search',
-      params: '{"q":"hi"}',
-      response: 'ok'
-    }
-  }
-
-  return createMessage(id, 'assistant', [toolCallBlock])
-}
-
-describe('messageCompressor', () => {
-  it('removes tool calls before the last user message when over budget', () => {
-    const assistant = createAssistantWithToolCall('assistant-1')
-    const user = createMessage('user-1', 'user', createUserContent('hello'))
-
-    const { compressedMessages, removedTokens } = compressToolCallsFromContext(
-      [assistant, user],
-      1,
-      true
-    )
-
-    const assistantBlocks = compressedMessages[0].content as AssistantMessageBlock[]
-    const hasToolCall = assistantBlocks.some((block) => block.type === 'tool_call')
-
-    expect(hasToolCall).toBe(false)
-    expect(removedTokens).toBeGreaterThan(0)
-  })
-
-  it('keeps tool calls when function calling is disabled', () => {
-    const assistant = createAssistantWithToolCall('assistant-1')
-    const user = createMessage('user-1', 'user', createUserContent('hello'))
-
-    const { compressedMessages, removedTokens } = compressToolCallsFromContext(
-      [assistant, user],
-      1,
-      false
-    )
-
-    const assistantBlocks = compressedMessages[0].content as AssistantMessageBlock[]
-    const hasToolCall = assistantBlocks.some((block) => block.type === 'tool_call')
-
-    expect(hasToolCall).toBe(true)
-    expect(removedTokens).toBe(0)
-  })
-
-  it('does not remove tool calls after the last user message', () => {
-    const user = createMessage('user-1', 'user', createUserContent('hello'))
-    const assistant = createAssistantWithToolCall('assistant-1')
-
-    const { compressedMessages } = compressToolCallsFromContext([user, assistant], 1, true)
-
-    const assistantBlocks = compressedMessages[1].content as AssistantMessageBlock[]
-    const hasToolCall = assistantBlocks.some((block) => block.type === 'tool_call')
-
-    expect(hasToolCall).toBe(true)
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/permission/permissionHandler.resume.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/permission/permissionHandler.resume.test.ts
deleted file mode 100644
index 46d1000e7..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/permission/permissionHandler.resume.test.ts
+++ /dev/null
@@ -1,168 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import type { AssistantMessage, AssistantMessageBlock } from '@shared/chat'
-import { PermissionHandler } from '@/presenter/agentPresenter/permission/permissionHandler'
-import type { ThreadHandlerContext } from '@/presenter/agentPresenter/types/handlerContext'
-import type { MessageManager } from '@/presenter/sessionPresenter/managers/messageManager'
-import type { StreamGenerationHandler } from '@/presenter/agentPresenter/streaming/streamGenerationHandler'
-import type { LLMEventHandler } from '@/presenter/agentPresenter/streaming/llmEventHandler'
-import type { GeneratingMessageState } from '@/presenter/agentPresenter/streaming/types'
-import { CommandPermissionService } from '@/presenter/permission'
-
-vi.mock('@/presenter', () => ({
-  presenter: {}
-}))
-
-describe('PermissionHandler resume behavior', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('resumes all resolved tool calls after the final permission decision', async () => {
-    const conversationId = 'conv-resume'
-    const messageId = 'msg-resume'
-    let content: AssistantMessageBlock[] = [
-      {
-        type: 'tool_call',
-        status: 'loading',
-        timestamp: Date.now(),
-        tool_call: { id: 'tool-1', name: 'read', params: '{}' }
-      },
-      {
-        type: 'action',
-        action_type: 'tool_call_permission',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'Permission required',
-        tool_call: { id: 'tool-1', name: 'read', params: '{}' },
-        extra: {
-          needsUserAction: true,
-          serverName: 'agent-filesystem',
-          permissionType: 'read',
-          permissionRequest: JSON.stringify({
-            toolName: 'read',
-            serverName: 'agent-filesystem',
-            permissionType: 'read',
-            description: 'Read access requires approval',
-            paths: ['src/a.txt']
-          })
-        }
-      },
-      {
-        type: 'tool_call',
-        status: 'loading',
-        timestamp: Date.now(),
-        tool_call: { id: 'tool-2', name: 'read', params: '{}' }
-      },
-      {
-        type: 'action',
-        action_type: 'tool_call_permission',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'Permission required',
-        tool_call: { id: 'tool-2', name: 'read', params: '{}' },
-        extra: {
-          needsUserAction: true,
-          serverName: 'agent-filesystem',
-          permissionType: 'read',
-          permissionRequest: JSON.stringify({
-            toolName: 'read',
-            serverName: 'agent-filesystem',
-            permissionType: 'read',
-            description: 'Read access requires approval',
-            paths: ['src/b.txt']
-          })
-        }
-      }
-    ]
-
-    const getCurrentMessage = (): AssistantMessage =>
-      ({
-        id: messageId,
-        conversationId,
-        role: 'assistant',
-        content
-      }) as AssistantMessage
-
-    const messageManager = {
-      getMessage: vi.fn(async () => getCurrentMessage()),
-      editMessage: vi.fn(async (_id: string, nextContent: string) => {
-        content = JSON.parse(nextContent) as AssistantMessageBlock[]
-        return getCurrentMessage()
-      }),
-      handleMessageError: vi.fn()
-    } as unknown as MessageManager
-
-    const sessionRuntime = {
-      removePendingPermission: vi.fn(),
-      acquirePermissionResumeLock: vi.fn().mockReturnValue(true),
-      releasePermissionResumeLock: vi.fn(),
-      getPendingPermissions: vi.fn().mockReturnValue([]),
-      clearPendingPermission: vi.fn(),
-      setStatus: vi.fn()
-    }
-    const mcpRuntime = {
-      grantPermission: vi.fn(),
-      isServerRunning: vi.fn().mockResolvedValue(true)
-    }
-    const permissionRuntime = {
-      approveFileAccess: vi.fn()
-    }
-
-    const ctx: ThreadHandlerContext = {
-      sqlitePresenter: {} as never,
-      messageManager,
-      llmProviderPresenter: {} as never,
-      configPresenter: {} as never,
-      sessionRuntime: sessionRuntime as never,
-      toolPresenter: {
-        getAllToolDefinitions: vi.fn(),
-        callTool: vi.fn(),
-        buildToolSystemPrompt: vi.fn()
-      } as never,
-      mcpRuntime: mcpRuntime as never,
-      promptRuntime: {
-        getInputChatMode: vi.fn(),
-        getSkillsEnabled: vi.fn(),
-        getActiveSkills: vi.fn(),
-        loadSkillContent: vi.fn(),
-        getMetadataPrompt: vi.fn(),
-        getActiveSkillsAllowedTools: vi.fn()
-      } as never,
-      permissionRuntime: permissionRuntime as never
-    }
-
-    const generatingMessages = new Map<string, GeneratingMessageState>()
-    generatingMessages.set(messageId, {
-      message: getCurrentMessage(),
-      conversationId,
-      startTime: Date.now(),
-      firstTokenTime: null,
-      promptTokens: 0,
-      reasoningStartTime: null,
-      reasoningEndTime: null,
-      lastReasoningTime: null
-    })
-
-    const handler = new PermissionHandler(ctx, {
-      generatingMessages,
-      streamGenerationHandler: {} as StreamGenerationHandler,
-      llmEventHandler: {} as LLMEventHandler,
-      commandPermissionHandler: new CommandPermissionService()
-    })
-
-    const resumeSpy = vi
-      .spyOn(
-        handler as unknown as { resumeToolExecutionAfterPermissions: (...args: any[]) => any },
-        'resumeToolExecutionAfterPermissions'
-      )
-      .mockResolvedValue(undefined)
-
-    await handler.handlePermissionResponse(messageId, 'tool-1', true, 'read', false)
-    expect(resumeSpy).not.toHaveBeenCalled()
-
-    await handler.handlePermissionResponse(messageId, 'tool-2', true, 'read', false)
-    expect(resumeSpy).toHaveBeenCalledTimes(1)
-    expect(resumeSpy).toHaveBeenCalledWith(messageId, true)
-    expect(resumeSpy.mock.calls[0][2]).toBeUndefined()
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/promptBuilder.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/promptBuilder.test.ts
deleted file mode 100644
index 8e075bcb3..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/promptBuilder.test.ts
+++ /dev/null
@@ -1,226 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { approximateTokenSize } from 'tokenx'
-import type { AssistantMessageBlock, Message, UserMessageContent } from '@shared/chat'
-import { buildUserMessageContext } from '@/presenter/agentPresenter/message/messageFormatter'
-import { selectContextMessages } from '@/presenter/agentPresenter/message/messageTruncator'
-
-const baseUsage = {
-  context_usage: 0,
-  tokens_per_second: 0,
-  total_tokens: 0,
-  generation_time: 0,
-  first_token_time: 0,
-  reasoning_start_time: 0,
-  reasoning_end_time: 0,
-  input_tokens: 0,
-  output_tokens: 0
-}
-
-function createUserContent(text: string): UserMessageContent {
-  return {
-    files: [],
-    links: [],
-    think: false,
-    search: false,
-    text,
-    content: [{ type: 'text', content: text }]
-  }
-}
-
-function createMessage(id: string, role: Message['role'], content: Message['content']): Message {
-  return {
-    id,
-    role,
-    content,
-    timestamp: Date.now(),
-    avatar: '',
-    name: '',
-    model_name: '',
-    model_id: '',
-    model_provider: '',
-    status: 'sent',
-    error: '',
-    usage: baseUsage,
-    conversationId: 'conversation',
-    is_variant: 0
-  }
-}
-
-function createAssistantBlocks(text: string, toolCall?: AssistantMessageBlock['tool_call']) {
-  const blocks: AssistantMessageBlock[] = [
-    {
-      type: 'content',
-      content: text,
-      status: 'success',
-      timestamp: Date.now()
-    }
-  ]
-
-  if (toolCall) {
-    blocks.push({
-      type: 'tool_call',
-      status: 'success',
-      timestamp: Date.now(),
-      tool_call: toolCall
-    })
-  }
-
-  return blocks
-}
-
-function countUserTokens(content: UserMessageContent): number {
-  return approximateTokenSize(buildUserMessageContext(content))
-}
-
-function countAssistantTokens(text: string): number {
-  return approximateTokenSize(text)
-}
-
-function countToolCallTokens(name: string, params: string, response: string): number {
-  return approximateTokenSize(name) + approximateTokenSize(params) + approximateTokenSize(response)
-}
-
-describe('selectContextMessages', () => {
-  it('drops oldest pairs when no tool calls are present', () => {
-    const user1 = createMessage('user-1', 'user', createUserContent('hello one'))
-    const assistant1 = createMessage('assistant-1', 'assistant', createAssistantBlocks('reply one'))
-    const user2 = createMessage('user-2', 'user', createUserContent('hello two'))
-    const assistant2 = createMessage('assistant-2', 'assistant', createAssistantBlocks('reply two'))
-    const currentUser = createMessage('user-3', 'user', createUserContent('new question'))
-
-    const pair2Tokens =
-      countUserTokens(user2.content as UserMessageContent) + countAssistantTokens('reply two')
-
-    const selected = selectContextMessages(
-      [user1, assistant1, user2, assistant2],
-      currentUser,
-      pair2Tokens,
-      false,
-      false
-    )
-
-    expect(selected.map((message) => message.id)).toEqual(['user-2', 'assistant-2'])
-  })
-
-  it('removes tool call blocks before deleting message pairs', () => {
-    const toolCall = {
-      id: 'tool-1',
-      name: 'search',
-      params: '{"q":"hi"}',
-      response: 'tool response'
-    }
-    const user = createMessage('user-1', 'user', createUserContent('hello'))
-    const assistant = createMessage(
-      'assistant-1',
-      'assistant',
-      createAssistantBlocks('reply', toolCall)
-    )
-    const currentUser = createMessage('user-2', 'user', createUserContent('new question'))
-
-    const totalTokens =
-      countUserTokens(user.content as UserMessageContent) +
-      countAssistantTokens('reply') +
-      countToolCallTokens(toolCall.name, toolCall.params, toolCall.response)
-
-    const remainingContextLength =
-      totalTokens - countToolCallTokens(toolCall.name, toolCall.params, toolCall.response) + 1
-
-    const selected = selectContextMessages(
-      [user, assistant],
-      currentUser,
-      remainingContextLength,
-      true,
-      false
-    )
-
-    const assistantBlocks = selected.find((message) => message.role === 'assistant')
-      ?.content as AssistantMessageBlock[]
-    const hasToolCallBlock = assistantBlocks.some((block) => block.type === 'tool_call')
-
-    expect(selected.map((message) => message.id)).toEqual(['user-1', 'assistant-1'])
-    expect(hasToolCallBlock).toBe(false)
-  })
-
-  it('removes tool calls then drops oldest pairs when still over limit', () => {
-    const toolCall = {
-      id: 'tool-1',
-      name: 'search',
-      params: '{"q":"hi"}',
-      response: 'tool response'
-    }
-    const user1 = createMessage('user-1', 'user', createUserContent('hello one'))
-    const assistant1 = createMessage(
-      'assistant-1',
-      'assistant',
-      createAssistantBlocks('reply one', toolCall)
-    )
-    const user2 = createMessage('user-2', 'user', createUserContent('hello two'))
-    const assistant2 = createMessage('assistant-2', 'assistant', createAssistantBlocks('reply two'))
-    const currentUser = createMessage('user-3', 'user', createUserContent('new question'))
-
-    const pair2Tokens =
-      countUserTokens(user2.content as UserMessageContent) + countAssistantTokens('reply two')
-
-    const remainingContextLength = pair2Tokens - 1
-
-    const selected = selectContextMessages(
-      [user1, assistant1, user2, assistant2],
-      currentUser,
-      remainingContextLength,
-      true,
-      false
-    )
-
-    expect(selected.map((message) => message.id)).toEqual(['user-2', 'assistant-2'])
-  })
-
-  it('returns empty when remaining context length is non-positive', () => {
-    const user = createMessage('user-1', 'user', createUserContent('hello'))
-    const assistant = createMessage('assistant-1', 'assistant', createAssistantBlocks('reply'))
-
-    const selected = selectContextMessages([user, assistant], user, 0, false, false)
-
-    expect(selected).toEqual([])
-  })
-
-  it('returns empty when no sent context messages exist', () => {
-    const user = createMessage('user-1', 'user', createUserContent('hello'))
-    const assistant = createMessage('assistant-1', 'assistant', createAssistantBlocks('reply'))
-    user.status = 'pending'
-    assistant.status = 'pending'
-
-    const selected = selectContextMessages([user, assistant], user, 100, false, false)
-
-    expect(selected).toEqual([])
-  })
-
-  it('retains image user messages when vision is enabled', () => {
-    const userWithImage = createMessage('user-1', 'user', createUserContent('hello'))
-    const imageContent = userWithImage.content as UserMessageContent & { images?: string[] }
-    imageContent.images = ['data:image/png;base64,abc']
-    const assistant = createMessage('assistant-1', 'assistant', createAssistantBlocks('reply'))
-    const currentUser = createMessage('user-2', 'user', createUserContent('new question'))
-
-    const selected = selectContextMessages(
-      [userWithImage, assistant],
-      currentUser,
-      1000,
-      true,
-      true
-    )
-
-    expect(selected.map((message) => message.id)).toEqual(['user-1', 'assistant-1'])
-  })
-
-  it('keeps context edge messages when within limits', () => {
-    const user = createMessage('user-1', 'user', createUserContent('edge message'))
-    const assistant = createMessage('assistant-1', 'assistant', createAssistantBlocks('reply'))
-    const edgeUser = user as Message & { is_context_edge?: boolean }
-    edgeUser.is_context_edge = true
-    const currentUser = createMessage('user-2', 'user', createUserContent('new question'))
-
-    const selected = selectContextMessages([user, assistant], currentUser, 1000, false, false)
-
-    expect(selected.map((message) => message.id)).toEqual(['user-1', 'assistant-1'])
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/sessionManager.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/sessionManager.test.ts
deleted file mode 100644
index e023f709f..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/sessionManager.test.ts
+++ /dev/null
@@ -1,99 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-import path from 'path'
-import { SessionManager } from '@/presenter/agentPresenter/session/sessionManager'
-
-vi.mock('electron', () => ({
-  app: {
-    getPath: () => 'C:\\\\temp'
-  }
-}))
-
-const baseSettings = {
-  providerId: 'provider-1',
-  modelId: 'model-1',
-  chatMode: 'agent' as const,
-  enabledMcpTools: [],
-  acpWorkdirMap: {},
-  agentWorkspacePath: null
-}
-
-const createConversation = (overrides?: Partial<typeof baseSettings>) => ({
-  id: 'conv-1',
-  settings: {
-    ...baseSettings,
-    ...overrides
-  }
-})
-
-const createManager = (conversation: ReturnType<typeof createConversation>) => {
-  const sessionPresenter = {
-    getConversation: vi.fn().mockResolvedValue(conversation),
-    updateConversationSettings: vi.fn().mockResolvedValue(undefined)
-  } as any
-  const configPresenter = {
-    getSetting: vi.fn().mockReturnValue('agent'),
-    getModelDefaultConfig: vi.fn().mockReturnValue({
-      maxTokens: 0,
-      contextLength: 0,
-      vision: false,
-      functionCall: true,
-      reasoning: false,
-      type: 'chat'
-    })
-  } as any
-
-  return {
-    manager: new SessionManager({ configPresenter, sessionPresenter }),
-    sessionPresenter,
-    configPresenter
-  }
-}
-
-describe('SessionManager', () => {
-  it('migrates legacy chat mode to agent mode silently', async () => {
-    const conversation = createConversation({ chatMode: 'chat' as any })
-    const { manager } = createManager(conversation)
-
-    const context = await manager.resolveWorkspaceContext(
-      conversation.id,
-      conversation.settings.modelId
-    )
-
-    // Chat mode should be migrated to agent mode
-    expect(context.chatMode).toBe('agent')
-  })
-
-  it('generates and persists workspace path for agent mode', async () => {
-    const conversation = createConversation({ chatMode: 'agent', agentWorkspacePath: null })
-    const { manager, sessionPresenter } = createManager(conversation)
-
-    const context = await manager.resolveWorkspaceContext(
-      conversation.id,
-      conversation.settings.modelId
-    )
-    const expected = path.join('C:\\\\temp', 'deepchat-agent', 'workspaces', conversation.id)
-
-    expect(context.chatMode).toBe('agent')
-    expect(context.agentWorkspacePath).toBe(expected)
-    expect(sessionPresenter.updateConversationSettings).toHaveBeenCalledWith(conversation.id, {
-      agentWorkspacePath: expected
-    })
-  })
-
-  it('uses ACP workdir map for acp agent mode', async () => {
-    const conversation = createConversation({
-      chatMode: 'acp agent',
-      acpWorkdirMap: { 'model-1': 'C:\\\\acp-workdir' }
-    })
-    const { manager, sessionPresenter } = createManager(conversation)
-
-    const context = await manager.resolveWorkspaceContext(
-      conversation.id,
-      conversation.settings.modelId
-    )
-
-    expect(context.chatMode).toBe('acp agent')
-    expect(context.agentWorkspacePath).toBe('C:\\\\acp-workdir')
-    expect(sessionPresenter.updateConversationSettings).not.toHaveBeenCalled()
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/skillsPromptBuilder.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/skillsPromptBuilder.test.ts
deleted file mode 100644
index 237449ac8..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/skillsPromptBuilder.test.ts
+++ /dev/null
@@ -1,54 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-import {
-  buildSkillsMetadataPrompt,
-  buildSkillsPrompt,
-  getSkillsAllowedTools
-} from '@/presenter/agentPresenter/message/skillsPromptBuilder'
-
-describe('skillsPromptBuilder', () => {
-  it('returns empty outputs when skills are disabled', async () => {
-    const promptRuntime = {
-      getSkillsEnabled: vi.fn().mockReturnValue(false),
-      getMetadataPrompt: vi.fn(),
-      getActiveSkills: vi.fn(),
-      loadSkillContent: vi.fn(),
-      getActiveSkillsAllowedTools: vi.fn()
-    } as any
-
-    await expect(buildSkillsMetadataPrompt(promptRuntime)).resolves.toBe('')
-    await expect(buildSkillsPrompt(promptRuntime, 'conv-1')).resolves.toBe('')
-    await expect(getSkillsAllowedTools(promptRuntime, 'conv-1')).resolves.toEqual([])
-    expect(promptRuntime.getMetadataPrompt).not.toHaveBeenCalled()
-    expect(promptRuntime.getActiveSkills).not.toHaveBeenCalled()
-  })
-
-  it('builds metadata, active skill prompt, and allowed tools from prompt runtime', async () => {
-    const promptRuntime = {
-      getSkillsEnabled: vi.fn().mockReturnValue(true),
-      getMetadataPrompt: vi.fn().mockResolvedValue('# Metadata'),
-      getActiveSkills: vi.fn().mockResolvedValue(['ocr', 'coder']),
-      loadSkillContent: vi.fn(async (name: string) =>
-        name === 'ocr'
-          ? { name: 'ocr', content: 'OCR content' }
-          : { name: 'coder', content: 'Coder content' }
-      ),
-      getActiveSkillsAllowedTools: vi.fn().mockResolvedValue(['read', 'grep'])
-    } as any
-
-    await expect(buildSkillsMetadataPrompt(promptRuntime)).resolves.toBe('# Metadata')
-    const prompt = await buildSkillsPrompt(promptRuntime, 'conv-1')
-    expect(prompt).toContain('## Skill: ocr')
-    expect(prompt).toContain('Coder content')
-    await expect(getSkillsAllowedTools(promptRuntime, 'conv-1')).resolves.toEqual(['read', 'grep'])
-  })
-
-  it('returns empty active skill prompt when no skill content can be loaded', async () => {
-    const promptRuntime = {
-      getSkillsEnabled: vi.fn().mockReturnValue(true),
-      getActiveSkills: vi.fn().mockResolvedValue(['ocr']),
-      loadSkillContent: vi.fn().mockResolvedValue(null)
-    } as any
-
-    await expect(buildSkillsPrompt(promptRuntime, 'conv-1')).resolves.toBe('')
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/llmEventHandler.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/llmEventHandler.test.ts
deleted file mode 100644
index f3c59a246..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/llmEventHandler.test.ts
+++ /dev/null
@@ -1,172 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { LLMEventHandler } from '@/presenter/agentPresenter/streaming/llmEventHandler'
-import type { AgentSessionRuntimePort } from '@/presenter/agentPresenter/session/sessionRuntimePort'
-import type { MessageManager } from '@/presenter/sessionPresenter/managers/messageManager'
-import type { GeneratingMessageState } from '@/presenter/agentPresenter/streaming/types'
-
-const eventBusMock = vi.hoisted(() => ({
-  sendToRenderer: vi.fn(),
-  sendToMain: vi.fn()
-}))
-
-vi.mock('@/eventbus', () => ({
-  eventBus: eventBusMock,
-  SendTarget: {
-    ALL_WINDOWS: 'ALL_WINDOWS'
-  }
-}))
-
-function createState(eventId: string, blocks: any[] = []): GeneratingMessageState {
-  return {
-    message: {
-      id: eventId,
-      conversationId: 'conv-1',
-      parentId: 'user-1',
-      is_variant: false,
-      content: blocks
-    } as any,
-    conversationId: 'conv-1',
-    startTime: Date.now(),
-    firstTokenTime: null,
-    promptTokens: 0,
-    reasoningStartTime: null,
-    reasoningEndTime: null,
-    lastReasoningTime: null
-  }
-}
-
-function createHandler(state: GeneratingMessageState) {
-  const generatingMessages = new Map([[state.message.id, state]])
-  const messageManager = {
-    updateMessageMetadata: vi.fn().mockResolvedValue(undefined),
-    handleMessageError: vi.fn().mockResolvedValue(undefined),
-    getMessage: vi.fn().mockResolvedValue(state.message),
-    updateMessageStatus: vi.fn().mockResolvedValue(undefined),
-    editMessage: vi.fn().mockResolvedValue(undefined)
-  } as unknown as MessageManager
-  const sessionRuntime = {
-    incrementToolCallCount: vi.fn(),
-    addPendingPermission: vi.fn(),
-    setStatus: vi.fn(),
-    updateRuntime: vi.fn(),
-    clearPendingPermission: vi.fn(),
-    clearPendingQuestion: vi.fn()
-  } as unknown as AgentSessionRuntimePort
-  const handler = new LLMEventHandler({
-    generatingMessages,
-    messageManager,
-    contentBufferHandler: {
-      cleanupContentBuffer: vi.fn(),
-      flushAdaptiveBuffer: vi.fn().mockResolvedValue(undefined)
-    } as any,
-    toolCallHandler: {
-      processToolCallStart: vi.fn().mockResolvedValue(undefined),
-      processToolCallUpdate: vi.fn().mockResolvedValue(undefined),
-      processToolCallPermission: vi.fn().mockResolvedValue(undefined),
-      processQuestionRequest: vi.fn().mockResolvedValue(undefined),
-      processToolCallError: vi.fn().mockResolvedValue(undefined),
-      processToolCallEnd: vi.fn().mockResolvedValue(undefined),
-      processSearchResultsFromToolCall: vi.fn().mockResolvedValue(undefined),
-      processMcpUiResourcesFromToolCall: vi.fn().mockResolvedValue(undefined)
-    } as any,
-    streamUpdateScheduler: {
-      enqueueDelta: vi.fn(),
-      flushAll: vi.fn().mockResolvedValue(undefined)
-    } as any,
-    sessionRuntime
-  })
-
-  return {
-    handler,
-    generatingMessages,
-    messageManager,
-    sessionRuntime
-  }
-}
-
-describe('LLMEventHandler session runtime wiring', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('stores pending permissions through injected session runtime', async () => {
-    const state = createState('evt-permission')
-    const { handler, sessionRuntime } = createHandler(state)
-
-    await handler.handleLLMAgentResponse({
-      eventId: state.message.id,
-      tool_call: 'permission-required',
-      tool_call_id: 'tool-1',
-      permission_request: {
-        permissionType: 'write'
-      }
-    } as any)
-
-    expect(sessionRuntime.addPendingPermission).toHaveBeenCalledWith('conv-1', {
-      messageId: state.message.id,
-      toolCallId: 'tool-1',
-      permissionType: 'write',
-      payload: {
-        permissionType: 'write'
-      }
-    })
-    expect(sessionRuntime.setStatus).toHaveBeenCalledWith('conv-1', 'waiting_permission')
-  })
-
-  it('stores pending question through injected session runtime', async () => {
-    const state = createState('evt-question')
-    const { handler, sessionRuntime } = createHandler(state)
-
-    await handler.handleLLMAgentResponse({
-      eventId: state.message.id,
-      tool_call: 'question-required',
-      tool_call_id: 'tool-2'
-    } as any)
-
-    expect(sessionRuntime.updateRuntime).toHaveBeenCalledWith('conv-1', {
-      pendingQuestion: {
-        messageId: state.message.id,
-        toolCallId: 'tool-2'
-      }
-    })
-    expect(sessionRuntime.setStatus).toHaveBeenCalledWith('conv-1', 'waiting_question')
-  })
-
-  it('marks runtime as error through injected session runtime', async () => {
-    const state = createState('evt-error')
-    const { handler, generatingMessages, messageManager, sessionRuntime } = createHandler(state)
-
-    await handler.handleLLMAgentError({
-      eventId: state.message.id,
-      error: 'boom'
-    } as any)
-
-    expect(messageManager.handleMessageError).toHaveBeenCalledWith(state.message.id, 'boom')
-    expect(sessionRuntime.setStatus).toHaveBeenCalledWith('conv-1', 'error')
-    expect(sessionRuntime.clearPendingPermission).toHaveBeenCalledWith('conv-1')
-    expect(sessionRuntime.clearPendingQuestion).toHaveBeenCalledWith('conv-1')
-    expect(generatingMessages.has(state.message.id)).toBe(false)
-  })
-
-  it('keeps waiting question status on end when pending question remains', async () => {
-    const state = createState('evt-end', [
-      {
-        type: 'action',
-        action_type: 'question_request',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'Need answer',
-        tool_call: { id: 'tool-3', name: 'question', params: '{}' }
-      }
-    ])
-    const { handler, messageManager, sessionRuntime } = createHandler(state)
-
-    await handler.handleLLMAgentEnd({
-      eventId: state.message.id
-    } as any)
-
-    expect(messageManager.updateMessageStatus).toHaveBeenCalledWith(state.message.id, 'sent')
-    expect(sessionRuntime.setStatus).toHaveBeenCalledWith('conv-1', 'waiting_permission')
-    expect(sessionRuntime.setStatus).toHaveBeenCalledWith('conv-1', 'waiting_question')
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/streamGenerationHandler.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/streamGenerationHandler.test.ts
deleted file mode 100644
index 4421bcfe8..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/agentPresenter/streaming/streamGenerationHandler.test.ts
+++ /dev/null
@@ -1,146 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { StreamGenerationHandler } from '@/presenter/agentPresenter/streaming/streamGenerationHandler'
-import type { ThreadHandlerContext } from '@/presenter/agentPresenter/types/handlerContext'
-import type { AgentSessionRuntimePort } from '@/presenter/agentPresenter/session/sessionRuntimePort'
-import type { MessageManager } from '@/presenter/sessionPresenter/managers/messageManager'
-import type { GeneratingMessageState } from '@/presenter/agentPresenter/streaming/types'
-
-vi.mock('@/presenter/agentPresenter/message/messageBuilder', () => ({
-  preparePromptContent: vi.fn().mockResolvedValue({
-    finalContent: [{ role: 'user', content: 'hello' }],
-    promptTokens: 12
-  })
-}))
-
-describe('StreamGenerationHandler session runtime wiring', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('uses injected session runtime for loop start and workspace resolution', async () => {
-    const conversationId = 'conv-stream'
-    const messageId = 'assistant-1'
-    const userMessageId = 'user-1'
-    const sessionRuntime = {
-      startLoop: vi.fn().mockResolvedValue(undefined),
-      resolveWorkspaceContext: vi.fn().mockResolvedValue({
-        chatMode: 'agent',
-        agentWorkspacePath: 'C:/workspace'
-      })
-    } as unknown as AgentSessionRuntimePort
-    const messageManager = {
-      getMessage: vi.fn().mockImplementation(async (id: string) => {
-        if (id === userMessageId) {
-          return {
-            id: userMessageId,
-            conversationId,
-            role: 'user',
-            content: {
-              text: 'hello',
-              files: []
-            }
-          }
-        }
-        throw new Error(`Unexpected message lookup: ${id}`)
-      }),
-      getMessageHistory: vi.fn().mockResolvedValue([]),
-      updateMessageMetadata: vi.fn().mockResolvedValue(undefined)
-    } as unknown as MessageManager
-    const ctx: ThreadHandlerContext = {
-      sqlitePresenter: {
-        getConversation: vi.fn().mockResolvedValue({
-          id: conversationId,
-          settings: {
-            providerId: 'mock-provider',
-            modelId: 'mock-model',
-            temperature: 0.7,
-            maxTokens: 1024,
-            enabledMcpTools: [],
-            thinkingBudget: undefined,
-            reasoningEffort: undefined,
-            verbosity: undefined,
-            contextLength: 2048
-          }
-        })
-      } as any,
-      messageManager,
-      llmProviderPresenter: {
-        startStreamCompletion: vi.fn().mockReturnValue(
-          (async function* () {
-            yield { type: 'end', data: { eventId: messageId } }
-          })()
-        )
-      } as any,
-      configPresenter: {
-        getModelConfig: vi.fn().mockReturnValue({
-          functionCall: false,
-          vision: false,
-          type: 'chat'
-        }),
-        getSetting: vi.fn().mockReturnValue(false)
-      } as any,
-      sessionRuntime,
-      toolPresenter: {
-        getAllToolDefinitions: vi.fn().mockResolvedValue([]),
-        buildToolSystemPrompt: vi.fn().mockReturnValue(''),
-        callTool: vi.fn()
-      } as any,
-      mcpRuntime: {
-        callTool: vi.fn(),
-        grantPermission: vi.fn(),
-        isServerRunning: vi.fn()
-      } as any,
-      promptRuntime: {
-        getInputChatMode: vi.fn(),
-        getSkillsEnabled: vi.fn().mockReturnValue(false),
-        getActiveSkills: vi.fn(),
-        loadSkillContent: vi.fn(),
-        getMetadataPrompt: vi.fn(),
-        getActiveSkillsAllowedTools: vi.fn().mockResolvedValue([])
-      } as any,
-      permissionRuntime: {} as any
-    }
-    const llmEventHandler = {
-      handleLLMAgentResponse: vi.fn().mockResolvedValue(undefined),
-      handleLLMAgentError: vi.fn().mockResolvedValue(undefined),
-      handleLLMAgentEnd: vi.fn().mockResolvedValue(undefined)
-    }
-    const generatingMessages = new Map<string, GeneratingMessageState>([
-      [
-        messageId,
-        {
-          message: {
-            id: messageId,
-            conversationId,
-            role: 'assistant',
-            content: [],
-            parentId: userMessageId
-          } as any,
-          conversationId,
-          startTime: Date.now(),
-          firstTokenTime: null,
-          promptTokens: 0,
-          reasoningStartTime: null,
-          reasoningEndTime: null,
-          lastReasoningTime: null
-        }
-      ]
-    ])
-
-    const handler = new StreamGenerationHandler(ctx, {
-      generatingMessages,
-      llmEventHandler: llmEventHandler as any
-    })
-
-    await handler.startStreamCompletion(conversationId, userMessageId)
-
-    expect(sessionRuntime.startLoop).toHaveBeenCalledWith(conversationId, messageId, {
-      skipLockAcquisition: true
-    })
-    expect(sessionRuntime.resolveWorkspaceContext).toHaveBeenCalledWith(
-      conversationId,
-      'mock-model'
-    )
-    expect(ctx.llmProviderPresenter.startStreamCompletion).toHaveBeenCalled()
-  })
-})
diff --git a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/sessionPresenter/permissionHandler.test.ts b/archives/code/legacy-agentpresenter-retirement/test/main/presenter/sessionPresenter/permissionHandler.test.ts
deleted file mode 100644
index 5718839cf..000000000
--- a/archives/code/legacy-agentpresenter-retirement/test/main/presenter/sessionPresenter/permissionHandler.test.ts
+++ /dev/null
@@ -1,393 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest'
-import type { AssistantMessage, AssistantMessageBlock } from '@shared/chat'
-import type { ILlmProviderPresenter } from '@shared/presenter'
-import { PermissionHandler } from '@/presenter/agentPresenter/permission/permissionHandler'
-import { CommandPermissionService } from '@/presenter/permission'
-import { presenter } from '@/presenter'
-import type { ThreadHandlerContext } from '@/presenter/agentPresenter/types/handlerContext'
-import type { StreamGenerationHandler } from '@/presenter/agentPresenter/streaming/streamGenerationHandler'
-import type { LLMEventHandler } from '@/presenter/agentPresenter/streaming/llmEventHandler'
-import type { MessageManager } from '@/presenter/sessionPresenter/managers/messageManager'
-import type { GeneratingMessageState } from '@/presenter/agentPresenter/streaming/types'
-
-const sessionState = vi.hoisted(() => ({
-  pendingPermissions: new Map<
-    string,
-    Array<{
-      messageId: string
-      toolCallId: string
-      permissionType: 'read' | 'write' | 'all' | 'command'
-      payload: Record<string, unknown>
-    }>
-  >(),
-  locks: new Map<string, { messageId: string; startedAt: number }>(),
-  status: new Map<string, string>(),
-  sessions: new Map<string, { id: string }>()
-}))
-
-const presenterMock = vi.hoisted(() => ({
-  sessionManager: {
-    clearPendingPermission: vi.fn((agentId: string) => {
-      sessionState.pendingPermissions.delete(agentId)
-    }),
-    setStatus: vi.fn((agentId: string, status: string) => {
-      sessionState.status.set(agentId, status)
-    }),
-    getStatus: vi.fn((agentId: string) => {
-      return (
-        (sessionState.status.get(agentId) as
-          | 'idle'
-          | 'generating'
-          | 'waiting_permission'
-          | 'waiting_question'
-          | null) ?? 'waiting_permission'
-      )
-    }),
-    startLoop: vi.fn().mockResolvedValue(undefined),
-    removePendingPermission: vi.fn((agentId: string, messageId: string, toolCallId: string) => {
-      const pending = sessionState.pendingPermissions.get(agentId) ?? []
-      sessionState.pendingPermissions.set(
-        agentId,
-        pending.filter((item) => !(item.messageId === messageId && item.toolCallId === toolCallId))
-      )
-    }),
-    addPendingPermission: vi.fn(
-      (
-        agentId: string,
-        permission: {
-          messageId: string
-          toolCallId: string
-          permissionType: 'read' | 'write' | 'all' | 'command'
-          payload: Record<string, unknown>
-        }
-      ) => {
-        const pending = sessionState.pendingPermissions.get(agentId) ?? []
-        pending.push(permission)
-        sessionState.pendingPermissions.set(agentId, pending)
-      }
-    ),
-    getPendingPermissions: vi.fn((agentId: string) => {
-      return sessionState.pendingPermissions.get(agentId) ?? []
-    }),
-    hasPendingPermissions: vi.fn((agentId: string, messageId?: string) => {
-      const pending = sessionState.pendingPermissions.get(agentId) ?? []
-      if (!messageId) {
-        return pending.length > 0
-      }
-      return pending.some((item) => item.messageId === messageId)
-    }),
-    acquirePermissionResumeLock: vi.fn((agentId: string, messageId: string) => {
-      if (sessionState.locks.get(agentId)?.messageId === messageId) {
-        return false
-      }
-      sessionState.locks.set(agentId, { messageId, startedAt: Date.now() })
-      return true
-    }),
-    getPermissionResumeLock: vi.fn((agentId: string) => {
-      return sessionState.locks.get(agentId)
-    }),
-    releasePermissionResumeLock: vi.fn((agentId: string) => {
-      sessionState.locks.delete(agentId)
-    }),
-    getSessionSync: vi.fn((agentId: string) => {
-      return sessionState.sessions.get(agentId) ?? null
-    })
-  }
-}))
-
-vi.mock('@/presenter', () => ({
-  presenter: presenterMock
-}))
-
-const createAssistantMessage = (
-  blocks: AssistantMessageBlock[],
-  conversationId: string,
-  messageId: string
-): AssistantMessage => {
-  return {
-    id: messageId,
-    conversationId,
-    role: 'assistant',
-    content: blocks
-  } as AssistantMessage
-}
-
-const createPermissionHandler = (options: {
-  message: AssistantMessage
-  llmProviderPresenter?: ILlmProviderPresenter
-}) => {
-  let currentMessage = options.message
-  const messageManager = {
-    getMessage: vi.fn().mockImplementation(async () => currentMessage),
-    editMessage: vi.fn().mockImplementation(async (_id: string, rawContent: string) => {
-      const next = JSON.parse(rawContent) as AssistantMessageBlock[]
-      currentMessage = {
-        ...currentMessage,
-        content: next
-      }
-      return currentMessage
-    }),
-    handleMessageError: vi.fn()
-  } as unknown as MessageManager
-
-  const ctx: ThreadHandlerContext = {
-    sqlitePresenter: {} as never,
-    messageManager,
-    llmProviderPresenter: options.llmProviderPresenter ?? ({} as ILlmProviderPresenter),
-    configPresenter: {} as never,
-    sessionRuntime: presenter.sessionManager as never,
-    toolPresenter: {
-      getAllToolDefinitions: vi.fn(),
-      callTool: vi.fn(),
-      buildToolSystemPrompt: vi.fn()
-    } as never,
-    mcpRuntime: {
-      grantPermission: vi.fn(),
-      isServerRunning: vi.fn().mockResolvedValue(true),
-      callTool: vi.fn()
-    } as never,
-    promptRuntime: {
-      getInputChatMode: vi.fn(),
-      getSkillsEnabled: vi.fn(),
-      getActiveSkills: vi.fn(),
-      loadSkillContent: vi.fn(),
-      getMetadataPrompt: vi.fn(),
-      getActiveSkillsAllowedTools: vi.fn()
-    } as never,
-    permissionRuntime: {
-      approveFileAccess: vi.fn(),
-      approveSettingsAccess: vi.fn()
-    } as never
-  }
-
-  const generatingMessages = new Map<string, GeneratingMessageState>()
-  generatingMessages.set(currentMessage.id, {
-    message: currentMessage,
-    conversationId: currentMessage.conversationId,
-    startTime: Date.now(),
-    firstTokenTime: null,
-    promptTokens: 0,
-    reasoningStartTime: null,
-    reasoningEndTime: null,
-    lastReasoningTime: null
-  })
-
-  const handler = new PermissionHandler(ctx, {
-    generatingMessages,
-    streamGenerationHandler: {} as StreamGenerationHandler,
-    llmEventHandler: {} as LLMEventHandler,
-    commandPermissionHandler: new CommandPermissionService()
-  })
-
-  return { handler, messageManager, getCurrentMessage: () => currentMessage }
-}
-
-describe('PermissionHandler', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-    sessionState.pendingPermissions.clear()
-    sessionState.locks.clear()
-    sessionState.status.clear()
-    sessionState.sessions.clear()
-  })
-
-  describe('ACP permissions', () => {
-    it('routes granted permissions through llmProviderPresenter for ACP blocks', async () => {
-      const conversationId = 'conv-1'
-      const messageId = 'msg-1'
-      const toolCallId = 'tool-1'
-      sessionState.sessions.set(conversationId, { id: conversationId })
-
-      const permissionBlock = {
-        type: 'action',
-        action_type: 'tool_call_permission',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'components.messageBlockPermissionRequest.description.write',
-        tool_call: { id: toolCallId, name: 'acp-tool' },
-        extra: {
-          needsUserAction: true,
-          providerId: 'acp',
-          permissionRequestId: 'req-123',
-          permissionRequest: JSON.stringify({ providerId: 'acp', requestId: 'req-123' }),
-          permissionType: 'write'
-        }
-      } as AssistantMessageBlock
-
-      const message = createAssistantMessage([permissionBlock], conversationId, messageId)
-      const llmProviderPresenter = {
-        resolveAgentPermission: vi.fn().mockResolvedValue(undefined)
-      } as unknown as ILlmProviderPresenter
-
-      const { handler } = createPermissionHandler({
-        message,
-        llmProviderPresenter
-      })
-
-      await handler.handlePermissionResponse(messageId, toolCallId, true, 'write', false)
-
-      expect(llmProviderPresenter.resolveAgentPermission).toHaveBeenCalledWith('req-123', true)
-      expect(presenter.sessionManager.clearPendingPermission).toHaveBeenCalledWith(conversationId)
-      expect(presenter.sessionManager.setStatus).toHaveBeenCalledWith(conversationId, 'generating')
-    })
-
-    it('routes denied permissions through llmProviderPresenter for ACP blocks', async () => {
-      const conversationId = 'conv-1'
-      const messageId = 'msg-1'
-      const toolCallId = 'tool-1'
-      sessionState.sessions.set(conversationId, { id: conversationId })
-
-      const permissionBlock = {
-        type: 'action',
-        action_type: 'tool_call_permission',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'components.messageBlockPermissionRequest.description.write',
-        tool_call: { id: toolCallId, name: 'acp-tool' },
-        extra: {
-          needsUserAction: true,
-          providerId: 'acp',
-          permissionRequestId: 'req-123',
-          permissionRequest: JSON.stringify({ providerId: 'acp', requestId: 'req-123' }),
-          permissionType: 'write'
-        }
-      } as AssistantMessageBlock
-
-      const message = createAssistantMessage([permissionBlock], conversationId, messageId)
-      const llmProviderPresenter = {
-        resolveAgentPermission: vi.fn().mockResolvedValue(undefined)
-      } as unknown as ILlmProviderPresenter
-
-      const { handler } = createPermissionHandler({
-        message,
-        llmProviderPresenter
-      })
-
-      await handler.handlePermissionResponse(messageId, toolCallId, false, 'write', false)
-
-      expect(llmProviderPresenter.resolveAgentPermission).toHaveBeenCalledWith('req-123', false)
-    })
-  })
-
-  describe('Session manager helpers', () => {
-    it('stores and filters pending permissions by messageId', () => {
-      const sessionManager = presenter.sessionManager as unknown as {
-        addPendingPermission: (agentId: string, permission: any) => void
-        getPendingPermissions: (agentId: string) => Array<{ toolCallId: string }>
-        hasPendingPermissions: (agentId: string, messageId?: string) => boolean
-      }
-
-      sessionManager.addPendingPermission('agent-1', {
-        messageId: 'msg-1',
-        toolCallId: 'tool-1',
-        permissionType: 'read',
-        payload: {}
-      })
-      sessionManager.addPendingPermission('agent-1', {
-        messageId: 'msg-2',
-        toolCallId: 'tool-2',
-        permissionType: 'write',
-        payload: {}
-      })
-
-      const pending = sessionManager.getPendingPermissions('agent-1')
-      expect(pending).toHaveLength(2)
-      expect(sessionManager.hasPendingPermissions('agent-1', 'msg-1')).toBe(true)
-      expect(sessionManager.hasPendingPermissions('agent-1', 'msg-3')).toBe(false)
-    })
-
-    it('acquires and releases permission resume lock', () => {
-      const sessionManager = presenter.sessionManager as unknown as {
-        acquirePermissionResumeLock: (agentId: string, messageId: string) => boolean
-        getPermissionResumeLock: (
-          agentId: string
-        ) => { messageId: string; startedAt: number } | undefined
-        releasePermissionResumeLock: (agentId: string) => void
-      }
-
-      const firstAcquire = sessionManager.acquirePermissionResumeLock('agent-1', 'msg-1')
-      const secondAcquire = sessionManager.acquirePermissionResumeLock('agent-1', 'msg-1')
-      const lock = sessionManager.getPermissionResumeLock('agent-1')
-
-      expect(firstAcquire).toBe(true)
-      expect(secondAcquire).toBe(false)
-      expect(lock?.messageId).toBe('msg-1')
-      expect(lock?.startedAt).toBeGreaterThan(0)
-
-      sessionManager.releasePermissionResumeLock('agent-1')
-      expect(sessionManager.getPermissionResumeLock('agent-1')).toBeUndefined()
-    })
-  })
-
-  describe('Permission level hierarchy', () => {
-    it('updates same tool-call permission blocks with same or lower required levels', async () => {
-      const conversationId = 'conv-2'
-      const messageId = 'msg-2'
-      const toolCallId = 'tool-1'
-      sessionState.sessions.set(conversationId, { id: conversationId })
-
-      const readPermissionBlock: AssistantMessageBlock = {
-        type: 'action',
-        action_type: 'tool_call_permission',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'Permission required',
-        tool_call: {
-          id: toolCallId,
-          name: 'write_file',
-          params: '{"path":"a.txt"}'
-        },
-        extra: {
-          needsUserAction: true,
-          serverName: 'mock-server',
-          permissionType: 'read'
-        }
-      }
-
-      const writePermissionBlock: AssistantMessageBlock = {
-        type: 'action',
-        action_type: 'tool_call_permission',
-        status: 'pending',
-        timestamp: Date.now(),
-        content: 'Permission required',
-        tool_call: {
-          id: toolCallId,
-          name: 'write_file',
-          params: '{"path":"a.txt"}'
-        },
-        extra: {
-          needsUserAction: true,
-          serverName: 'mock-server',
-          permissionType: 'write'
-        }
-      }
-
-      const message = createAssistantMessage(
-        [readPermissionBlock, writePermissionBlock],
-        conversationId,
-        messageId
-      )
-      const { handler, messageManager } = createPermissionHandler({ message })
-      vi.spyOn(
-        handler as unknown as { resumeToolExecutionAfterPermissions: (...args: any[]) => any },
-        'resumeToolExecutionAfterPermissions'
-      ).mockResolvedValue(undefined)
-
-      await handler.handlePermissionResponse(messageId, toolCallId, true, 'write', false)
-
-      const updatedContent = JSON.parse(
-        (messageManager.editMessage as unknown as { mock: { calls: Array<[string, string]> } }).mock
-          .calls[0][1]
-      ) as AssistantMessageBlock[]
-
-      const updatedPermissionBlocks = updatedContent.filter(
-        (block) => block.type === 'action' && block.action_type === 'tool_call_permission'
-      )
-      expect(updatedPermissionBlocks).toHaveLength(2)
-      expect(updatedPermissionBlocks.every((block) => block.status === 'granted')).toBe(true)
-      expect(updatedPermissionBlocks.every((block) => block.extra?.needsUserAction === false)).toBe(
-        true
-      )
-    })
-  })
-})
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index e6a6e7173..bdc6198f4 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -95,7 +95,7 @@ flowchart LR
 
 ## 归档与防回归
 
-- 退休代码已归档到 `archives/code/legacy-agentpresenter-retirement/`
+- 退休 runtime 的历史结构已经固化到 `docs/archives/` 文档，不再保留源码级导航入口
 - 历史架构文档见 [archives/legacy-agentpresenter-architecture.md](./archives/legacy-agentpresenter-architecture.md)
 - 历史流程文档见 [archives/legacy-agentpresenter-flows.md](./archives/legacy-agentpresenter-flows.md)
 - 防回归脚本：`scripts/agent-cleanup-guard.mjs`
diff --git a/docs/README.md b/docs/README.md
index 86f523566..d6ac77005 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -26,6 +26,8 @@ Renderer
 | [architecture/session-management.md](./architecture/session-management.md) | 新会话管理与 legacy 数据平面边界 |
 | [guides/code-navigation.md](./guides/code-navigation.md) | 当前代码导航入口 |
 | [guides/getting-started.md](./guides/getting-started.md) | 新开发者快速上手 |
+| [architecture/baselines/dependency-report.md](./architecture/baselines/dependency-report.md) | 当前依赖与耦合基线 |
+| [architecture/baselines/test-failure-groups.md](./architecture/baselines/test-failure-groups.md) | 当前测试失败分组基线 |
 
 ## 本次清理落库
 
@@ -34,7 +36,9 @@ Renderer
 | [docs/specs/legacy-agentpresenter-retirement/spec.md](./specs/legacy-agentpresenter-retirement/spec.md) | 本次 retirement 的目标、范围、兼容边界 |
 | [docs/specs/legacy-agentpresenter-retirement/plan.md](./specs/legacy-agentpresenter-retirement/plan.md) | 迁移/归档/验证计划 |
 | [docs/specs/legacy-agentpresenter-retirement/tasks.md](./specs/legacy-agentpresenter-retirement/tasks.md) | 已执行清单 |
-| [archives/code/legacy-agentpresenter-retirement/README.md](../archives/code/legacy-agentpresenter-retirement/README.md) | 代码归档说明 |
+| [docs/specs/architecture-simplification/spec.md](./specs/architecture-simplification/spec.md) | 整体减负治理规格 |
+| [docs/specs/architecture-simplification/plan.md](./specs/architecture-simplification/plan.md) | 分层/基线/guard 计划 |
+| [docs/specs/architecture-simplification/tasks.md](./specs/architecture-simplification/tasks.md) | 首期实施清单 |
 | [docs/specs/agent-cleanup/spec.md](./specs/agent-cleanup/spec.md) | cleanup 主规格，已更新到 retirement 完成态 |
 
 ## 活跃架构地图
@@ -46,6 +50,7 @@ docs/
 ├── FLOWS.md
 ├── architecture/
 │   ├── agent-system.md
+│   ├── baselines/
 │   ├── session-management.md
 │   ├── tool-system.md
 │   ├── event-system.md
@@ -56,6 +61,7 @@ docs/
 │   └── debugging.md
 ├── specs/
 │   ├── agent-cleanup/
+│   ├── architecture-simplification/
 │   └── legacy-agentpresenter-retirement/
 └── archives/
     ├── legacy-agentpresenter-architecture.md
@@ -83,4 +89,4 @@ docs/
    - 聊天执行链路： [architecture/agent-system.md](./architecture/agent-system.md)
    - 工具与权限： [architecture/tool-system.md](./architecture/tool-system.md)
    - 会话与兼容边界： [architecture/session-management.md](./architecture/session-management.md)
-4. 如果需要对照旧实现，再去看 `archives/`。
+4. 如果需要对照旧实现，再去看 `archives/` 历史文档，不要依赖已经移除的历史源码快照。
diff --git a/docs/architecture/agent-system.md b/docs/architecture/agent-system.md
index ff0610ece..b9b74f111 100644
--- a/docs/architecture/agent-system.md
+++ b/docs/architecture/agent-system.md
@@ -117,4 +117,4 @@ deepchatAgentPresenter/
 - `permissionHandler`
 - `startStreamCompletion`
 
-需要对照旧实现时，只看归档文档和 `archives/code/legacy-agentpresenter-retirement/`。
+需要对照旧实现时，只看归档文档，不再把历史源码快照当作活跃导航入口。
diff --git a/docs/architecture/baselines/archive-reference-report.md b/docs/architecture/baselines/archive-reference-report.md
new file mode 100644
index 000000000..79b127297
--- /dev/null
+++ b/docs/architecture/baselines/archive-reference-report.md
@@ -0,0 +1,6 @@
+# Archive Reference Baseline
+
+Generated on 2026-04-03.
+
+- Total references: 0
+
diff --git a/docs/architecture/baselines/dependency-report.md b/docs/architecture/baselines/dependency-report.md
new file mode 100644
index 000000000..81d7f8e58
--- /dev/null
+++ b/docs/architecture/baselines/dependency-report.md
@@ -0,0 +1,118 @@
+# Dependency Baseline
+
+Generated on 2026-04-03.
+
+## main
+
+- Total files: 333
+- Internal dependency edges: 826
+- Cycles detected: 30
+
+### Top outgoing dependencies
+
+- `presenter/index.ts`: 39
+- `presenter/llmProviderPresenter/managers/providerInstanceManager.ts`: 38
+- `presenter/configPresenter/index.ts`: 22
+- `presenter/deepchatAgentPresenter/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/llmProviderPresenter/acp/index.ts`: 12
+- `presenter/filePresenter/mime.ts`: 11
+- `presenter/mcpPresenter/inMemoryServers/builder.ts`: 11
+- `presenter/skillSyncPresenter/adapters/index.ts`: 11
+- `presenter/filePresenter/FileAdapterConstructor.ts`: 10
+
+### Top incoming dependencies
+
+- `events.ts`: 58
+- `eventbus.ts`: 57
+- `presenter/index.ts`: 44
+- `presenter/llmProviderPresenter/runtimePorts.ts`: 34
+- `presenter/llmProviderPresenter/providers/openAICompatibleProvider.ts`: 24
+- `presenter/llmProviderPresenter/baseProvider.ts`: 19
+- `presenter/remoteControlPresenter/types.ts`: 18
+- `presenter/sqlitePresenter/tables/baseTable.ts`: 16
+- `presenter/sqlitePresenter/index.ts`: 12
+- `presenter/configPresenter/modelCapabilities.ts`: 11
+- `presenter/filePresenter/BaseFileAdapter.ts`: 11
+- `presenter/proxyConfig.ts`: 10
+- `lib/runtimeHelper.ts`: 9
+- `presenter/configPresenter/providerDbLoader.ts`: 9
+- `presenter/configPresenter/acpRegistryConstants.ts`: 8
+
+### Cycle samples
+
+- `presenter/index.ts -> presenter/windowPresenter/index.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/windowPresenter/index.ts -> presenter/tabPresenter.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/windowPresenter/index.ts -> presenter/windowPresenter/FloatingChatWindow.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/shortcutPresenter.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/llmProviderPresenter/index.ts -> presenter/llmProviderPresenter/baseProvider.ts -> presenter/devicePresenter/index.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/llmProviderPresenter/index.ts -> presenter/llmProviderPresenter/managers/providerInstanceManager.ts -> presenter/llmProviderPresenter/providers/deepseekProvider.ts -> presenter/llmProviderPresenter/providers/openAICompatibleProvider.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/llmProviderPresenter/index.ts -> presenter/llmProviderPresenter/managers/providerInstanceManager.ts -> presenter/llmProviderPresenter/providers/githubCopilotProvider.ts -> presenter/githubCopilotDeviceFlow.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/llmProviderPresenter/index.ts -> presenter/llmProviderPresenter/managers/providerInstanceManager.ts -> presenter/llmProviderPresenter/providers/openAIResponsesProvider.ts -> presenter/index.ts`
+- `presenter/filePresenter/mime.ts -> presenter/filePresenter/CsvFileAdapter.ts -> presenter/filePresenter/BaseFileAdapter.ts -> presenter/filePresenter/mime.ts`
+- `presenter/index.ts -> presenter/sessionPresenter/index.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/sessionPresenter/index.ts -> presenter/sessionPresenter/managers/conversationManager.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/mcpPresenter/serverManager.ts -> presenter/mcpPresenter/mcpClient.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/mcpPresenter/serverManager.ts -> presenter/mcpPresenter/mcpClient.ts -> presenter/mcpPresenter/inMemoryServers/builder.ts -> presenter/mcpPresenter/inMemoryServers/deepResearchServer.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/mcpPresenter/serverManager.ts -> presenter/mcpPresenter/mcpClient.ts -> presenter/mcpPresenter/inMemoryServers/builder.ts -> presenter/mcpPresenter/inMemoryServers/autoPromptingServer.ts -> presenter/index.ts`
+- `presenter/index.ts -> presenter/mcpPresenter/index.ts -> presenter/mcpPresenter/serverManager.ts -> presenter/mcpPresenter/mcpClient.ts -> presenter/mcpPresenter/inMemoryServers/builder.ts -> presenter/mcpPresenter/inMemoryServers/conversationSearchServer.ts -> presenter/index.ts`
+- `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/index.ts -> presenter/syncPresenter/index.ts -> presenter/index.ts`
+
+## renderer
+
+- Total files: 235
+- Internal dependency edges: 478
+- Cycles detected: 4
+
+### Top outgoing dependencies
+
+- `App.vue`: 24
+- `pages/ChatPage.vue`: 17
+- `views/PlaygroundTabView.vue`: 16
+- `components/message/MessageItemAssistant.vue`: 15
+- `i18n/index.ts`: 12
+- `components/chat/ChatStatusBar.vue`: 11
+- `components/ChatConfig.vue`: 9
+- `components/sidepanel/WorkspacePanel.vue`: 9
+- `pages/NewThreadPage.vue`: 9
+- `views/ChatTabView.vue`: 9
+- `components/AppBar.vue`: 8
+- `components/WindowSideBar.vue`: 8
+- `components/mcp-config/components/McpServers.vue`: 8
+- `components/message/MessageBlockContent.vue`: 8
+- `components/chat/composables/useChatInputMentions.ts`: 7
+
+### Top incoming dependencies
+
+- `composables/usePresenter.ts`: 64
+- `events.ts`: 32
+- `components/chat/messageListItems.ts`: 16
+- `stores/ui/session.ts`: 15
+- `stores/artifact.ts`: 13
+- `stores/providerStore.ts`: 13
+- `stores/theme.ts`: 12
+- `stores/modelStore.ts`: 11
+- `stores/ui/agent.ts`: 11
+- `stores/uiSettingsStore.ts`: 10
+- `stores/mcp.ts`: 8
+- `stores/ui/sidepanel.ts`: 8
+- `components/icons/ModelIcon.vue`: 6
+- `components/use-toast.ts`: 6
+- `stores/language.ts`: 6
+
+### Cycle samples
+
+- `stores/ui/session.ts -> stores/ui/message.ts -> stores/ui/session.ts`
+- `components/json-viewer/JsonValue.ts -> components/json-viewer/JsonObject.ts -> components/json-viewer/JsonValue.ts`
+- `components/json-viewer/JsonArray.ts -> components/json-viewer/JsonValue.ts -> components/json-viewer/JsonArray.ts`
+- `composables/usePageCapture.example.ts -> composables/usePageCapture.example.ts`
+
diff --git a/docs/architecture/baselines/test-failure-groups.md b/docs/architecture/baselines/test-failure-groups.md
new file mode 100644
index 000000000..eb5861c4c
--- /dev/null
+++ b/docs/architecture/baselines/test-failure-groups.md
@@ -0,0 +1,38 @@
+# Test Failure Groups
+
+Baseline captured on `2026-04-03`.
+
+## 真实行为回归 / 契约漂移
+
+- `test/main/presenter/newAgentPresenter/integration.test.ts`
+  - `configPresenter.getAgentType()` mock 契约缺失暴露了会话编排对配置查询的硬依赖。
+- `test/main/presenter/floatingButtonPresenter/*.test.ts`
+  - 布局断言和当前窗口吸边行为不一致。
+- `test/main/presenter/skillSyncPresenter/*.test.ts`
+  - Cursor format / conversion warnings 的行为与测试契约漂移。
+- `test/renderer/stores/sessionStore.test.ts`
+  - sidebar group 逻辑对 `sessionKind` 缺省值不兼容。
+- `test/renderer/composables/useModelCapabilities.test.ts`
+  - search capability 返回值未对齐测试预期。
+
+## 测试陈旧 / 遗留测试未跟上实现
+
+- `test/main/presenter/mcpClient.test.ts`
+  - 仍然断言旧的 runtime command translation 细节。
+- `test/main/presenter/newAgentPresenter/messageManager.test.ts`
+  - 仍然调用已不再暴露的方法。
+- `test/renderer/composables/useSearchConfig.test.ts`
+  - 测试存在，但实现文件缺失。
+- `test/renderer/components/MermaidArtifact.test.ts`
+  - 组件结构与测试查询方式不再匹配。
+- 多个 renderer store test 的 `pinia` mock
+  - 当前 mock 方式污染 `setActivePinia/createPinia`。
+
+## 环境问题
+
+- `test/main/presenter/SyncPresenter.test.ts`
+  - `better-sqlite3-multiple-ciphers` 二进制与当前 Node ABI 不匹配。
+- `test/main/presenter/llmProviderPresenter.test.ts`
+  - 用例依赖超时 / 网络模拟不稳定。
+- 若干 renderer test 中的 `jsdom` navigation not implemented
+  - 不是业务行为错误，而是测试环境能力限制。
diff --git a/docs/architecture/baselines/zero-inbound-candidates.md b/docs/architecture/baselines/zero-inbound-candidates.md
new file mode 100644
index 000000000..907b5d066
--- /dev/null
+++ b/docs/architecture/baselines/zero-inbound-candidates.md
@@ -0,0 +1,76 @@
+# Zero Inbound Candidates
+
+Generated on 2026-04-03.
+
+These files have no in-repo importers inside their scope and need manual classification before deletion.
+
+## main
+
+- Candidate count: 16
+
+- `env.d.ts`
+- `lib/system.ts`
+- `lib/terminalHelper.ts`
+- `presenter/browser/BrowserContextBuilder.ts`
+- `presenter/configPresenter/aes.ts`
+- `presenter/llmProviderPresenter/oauthHelper.ts`
+- `presenter/llmProviderPresenter/providers/openAIProvider.ts`
+- `presenter/mcpPresenter/agentMcpFilter.ts`
+- `presenter/searchPrompts/searchPrompts.ts`
+- `presenter/sessionPresenter/events.ts`
+- `presenter/sessionPresenter/persistence/conversationPersister.ts`
+- `presenter/sessionPresenter/persistence/messagePersister.ts`
+- `presenter/sessionPresenter/tab/tabAdapter.ts`
+- `presenter/sessionPresenter/types.ts`
+- `presenter/sqlitePresenter/tables/attachments.ts`
+- `presenter/workspacePresenter/fileCache.ts`
+
+## renderer
+
+- Candidate count: 44
+
+- `components/ChatConfig.vue`
+- `components/ChatConfig/ConfigSwitchField.vue`
+- `components/FileItem.vue`
+- `components/ModelSelect.vue`
+- `components/ScrollablePopover.vue`
+- `components/artifacts/ArtifactBlock.vue`
+- `components/chat-input/SkillsIndicator.vue`
+- `components/chat-input/VoiceCallWidget.vue`
+- `components/chat-input/components/ToolbarButton.vue`
+- `components/chat-input/composables/useAgentMcpData.ts`
+- `components/chat-input/composables/useContextLength.ts`
+- `components/chat-input/composables/useDragAndDrop.ts`
+- `components/chat-input/composables/useInputHistory.ts`
+- `components/chat-input/composables/useInputSettings.ts`
+- `components/chat-input/composables/usePromptInputFiles.ts`
+- `components/chat-input/composables/useRateLimitStatus.ts`
+- `components/editor/mention/PromptParamsDialog.vue`
+- `components/editor/mention/mention.ts`
+- `components/editor/mention/slashMention.ts`
+- `components/mcp-config/AgentMcpSelector.vue`
+- `components/message/MessageActionButtons.vue`
+- `components/message/MessageItemPlaceholder.vue`
+- `components/message/ReferencePreview.vue`
+- `components/settings/ModelConfigItem.vue`
+- `composables/message/useMessageScroll.ts`
+- `composables/useArtifactCodeEditor.ts`
+- `composables/useArtifactContext.ts`
+- `composables/useArtifactExport.ts`
+- `composables/useArtifactViewMode.ts`
+- `composables/useSearchConfig.ts`
+- `composables/useViewportSize.ts`
+- `env.d.ts`
+- `lib/float.cursor.ts`
+- `lib/gemini.ts`
+- `lib/sanitizeText.ts`
+- `main.ts`
+- `stores/floatingButton.ts`
+- `stores/prompts.ts`
+- `stores/providerDeeplinkImport.ts`
+- `stores/shortcutKey.ts`
+- `stores/sync.ts`
+- `stores/systemPromptStore.ts`
+- `utils/maxOutputTokens.ts`
+- `views/SettingsTabView.vue`
+
diff --git a/docs/architecture/new-ui-implementation-plan.md b/docs/architecture/new-ui-implementation-plan.md
index bab6f5058..b03c83387 100644
--- a/docs/architecture/new-ui-implementation-plan.md
+++ b/docs/architecture/new-ui-implementation-plan.md
@@ -556,8 +556,8 @@ sessionStore.selectSession(id)
 - `chat.ts`: Remove session management logic, keep message logic
 
 **Deprecated**:
-- `components/mock/*.vue`: Archived in `archives/code/dead-code-batch-2/`
-- `composables/useMockViewState.ts`: Archived in `archives/code/dead-code-batch-2/`
+- `components/mock/*.vue`: Removed after the new UI rollout, only historical docs remain
+- `composables/useMockViewState.ts`: Removed after stores took over the state flow
 
 ---
 
diff --git a/docs/archives/legacy-agentpresenter-architecture.md b/docs/archives/legacy-agentpresenter-architecture.md
index 4f96c4368..e1d534f5d 100644
--- a/docs/archives/legacy-agentpresenter-architecture.md
+++ b/docs/archives/legacy-agentpresenter-architecture.md
@@ -118,16 +118,16 @@ graph TB
 
 **职责**：管理 Agent Loop、LLM 流式响应、工具调用、权限协调
 
-| 组件 | 文件位置 | 行数 | 核心职责 |
+| 组件 | 历史模块标识 | 行数 | 核心职责 |
 |------|---------|------|---------|
-| AgentPresenter | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/index.ts` | 472 | Agent 编排入口，sendMessage/cancelLoop/continueLoop |
-| agentLoopHandler | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/agentLoopHandler.ts` | 670 | Agent Loop 主循环（while 循环） |
-| streamGenerationHandler | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamGenerationHandler.ts` | 645 | 流生成协调，准备上下文、启动 Stream |
-| loopOrchestrator | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/loopOrchestrator.ts` | ~30 | Loop 状态管理 |
-| toolCallProcessor | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/toolCallProcessor.ts` | 445 | 工具调用执行、结果处理 |
-| llmEventHandler | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/llmEventHandler.ts` | ~400 | 标准化 LLM 事件到内部格式 |
-| permissionHandler | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/permission/permissionHandler.ts` | ~600 | 权限请求响应协调 |
-| messageBuilder | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageBuilder.ts` | ~285 | 提示词构建、上下文压缩 |
+| AgentPresenter | `legacy agent runtime / agentPresenter/index.ts` | 472 | Agent 编排入口，sendMessage/cancelLoop/continueLoop |
+| agentLoopHandler | `legacy agent runtime / loop/agentLoopHandler.ts` | 670 | Agent Loop 主循环（while 循环） |
+| streamGenerationHandler | `legacy agent runtime / streaming/streamGenerationHandler.ts` | 645 | 流生成协调，准备上下文、启动 Stream |
+| loopOrchestrator | `legacy agent runtime / loop/loopOrchestrator.ts` | ~30 | Loop 状态管理 |
+| toolCallProcessor | `legacy agent runtime / loop/toolCallProcessor.ts` | 445 | 工具调用执行、结果处理 |
+| llmEventHandler | `legacy agent runtime / streaming/llmEventHandler.ts` | ~400 | 标准化 LLM 事件到内部格式 |
+| permissionHandler | `legacy agent runtime / permission/permissionHandler.ts` | ~600 | 权限请求响应协调 |
+| messageBuilder | `legacy agent runtime / message/messageBuilder.ts` | ~285 | 提示词构建、上下文压缩 |
 
 **关键流程**：
 1. 用户发送消息 → `AgentPresenter.sendMessage()`
@@ -143,13 +143,13 @@ graph TB
 
 **职责**：统一管理所有工具（MCP + Agent）、工具名称解析、路由分发
 
-| 组件 | 文件位置 | 行数 | 核心职责 |
+| 组件 | 历史模块标识 | 行数 | 核心职责 |
 |------|---------|------|---------|
 | ToolPresenter | `src/main/presenter/toolPresenter/index.ts` | 161 | 统一工具定义接口、工具调用路由 |
 | ToolMapper | `src/main/presenter/toolPresenter/toolMapper.ts` | ~100 | 工具名→来源映射（mcp/agent） |
 | McpPresenter | `src/main/presenter/mcpPresenter/index.ts` | ~500 | MCP 服务器管理、工具定义、工具调用 |
-| AgentToolManager | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/agentToolManager.ts` | 577 | Agent 文件系统 + Browser 工具 |
-| AgentFileSystemHandler | `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/agentFileSystemHandler.ts` | 960 | 文件系统工具实现 |
+| AgentToolManager | `legacy agent runtime / acp/agentToolManager.ts` | 577 | Agent 文件系统 + Browser 工具 |
+| AgentFileSystemHandler | `legacy agent runtime / acp/agentFileSystemHandler.ts` | 960 | 文件系统工具实现 |
 
 **工具来源**：
 1. **MCP 工具**：外部 MCP 服务器提供，通过 `McpPresenter` 管理
@@ -291,16 +291,16 @@ const response = await toolPresenter.callTool({
 - ConversationManager: `src/main/presenter/sessionPresenter/managers/conversationManager.ts`
 
 **Agent 系统**：
-- AgentPresenter: `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/index.ts:1-472`
-- Agent Loop: `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/loop/agentLoopHandler.ts:1-670`
-- Stream Generation: `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/streaming/streamGenerationHandler.ts:1-645`
-- Message Builder: `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/message/messageBuilder.ts`
+- AgentPresenter: `legacy agent runtime / agentPresenter/index.ts`
+- Agent Loop: `legacy agent runtime / loop/agentLoopHandler.ts`
+- Stream Generation: `legacy agent runtime / streaming/streamGenerationHandler.ts`
+- Message Builder: `legacy agent runtime / message/messageBuilder.ts`
 
 **工具系统**：
 - ToolPresenter: `src/main/presenter/toolPresenter/index.ts:1-161`
 - ToolMapper: `src/main/presenter/toolPresenter/toolMapper.ts`
-- AgentToolManager: `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/agentToolManager.ts:1-577`
-- AgentFileSystemHandler: `archives/code/legacy-agentpresenter-retirement/src/main/presenter/agentPresenter/acp/agentFileSystemHandler.ts:1-960`
+- AgentToolManager: `legacy agent runtime / acp/agentToolManager.ts`
+- AgentFileSystemHandler: `legacy agent runtime / acp/agentFileSystemHandler.ts`
 - McpPresenter: `src/main/presenter/mcpPresenter/index.ts`
 
 **事件系统**：
diff --git a/docs/guides/code-navigation.md b/docs/guides/code-navigation.md
index 61978b062..08991d61f 100644
--- a/docs/guides/code-navigation.md
+++ b/docs/guides/code-navigation.md
@@ -104,4 +104,4 @@ rg --files src/main/presenter | rg "newAgentPresenter|deepchatAgentPresenter|age
 
 - `docs/archives/legacy-agentpresenter-architecture.md`
 - `docs/archives/legacy-agentpresenter-flows.md`
-- `archives/code/legacy-agentpresenter-retirement/`
+- `docs/archives/thread-presenter-migration-plan.md`
diff --git a/docs/guides/getting-started.md b/docs/guides/getting-started.md
index 2f5fc37d0..f416b5547 100644
--- a/docs/guides/getting-started.md
+++ b/docs/guides/getting-started.md
@@ -137,4 +137,4 @@ node scripts/agent-cleanup-guard.mjs
 
 - `docs/archives/legacy-agentpresenter-architecture.md`
 - `docs/archives/legacy-agentpresenter-flows.md`
-- `archives/code/legacy-agentpresenter-retirement/`
+- `docs/archives/thread-presenter-migration-plan.md`
diff --git a/docs/specs/agent-cleanup/spec.md b/docs/specs/agent-cleanup/spec.md
index fc11936e5..52b80b461 100644
--- a/docs/specs/agent-cleanup/spec.md
+++ b/docs/specs/agent-cleanup/spec.md
@@ -20,7 +20,7 @@ Completed in this retirement slice:
 - migrated retained ACP helpers into `src/main/presenter/llmProviderPresenter/acp/`
 - migrated retained agent tools into `src/main/presenter/toolPresenter/agentTools/`
 - moved retained user message formatting helpers into `src/main/presenter/sessionPresenter/`
-- archived retired source and tests under `archives/code/legacy-agentpresenter-retirement/`
+- removed retired source and tests from the active tree, with history preserved in docs
 
 ## Compatibility Boundary
 
@@ -49,11 +49,11 @@ It now protects these invariants:
 
 - shared helper ownership moved to `src/main/lib/agentRuntime`
 - active renderer chat path moved off legacy message protocol
-- dead renderer and mock/orphan code archived under `archives/code/`
+- dead renderer and mock/orphan code removed from the active tree
 - new-session skills persisted in `new_sessions.active_skills`
 - legacy `agentPresenter/**` removed from global presenter access
 - provider-layer MCP global access removed
-- final legacy runtime retirement completed and archived
+- final legacy runtime retirement completed and documented
 
 ## Remaining Backlog
 
diff --git a/docs/specs/agent-cleanup/tasks.md b/docs/specs/agent-cleanup/tasks.md
index e2fcd6148..fd0785884 100644
--- a/docs/specs/agent-cleanup/tasks.md
+++ b/docs/specs/agent-cleanup/tasks.md
@@ -5,8 +5,8 @@
 - [x] Added cleanup docs and static guardrails
 - [x] Moved shared runtime helpers out of legacy presenter folders
 - [x] Moved active renderer chat path off `@shared/chat`
-- [x] Archived dead renderer path code in `archives/code/dead-renderer-batch-1/`
-- [x] Archived renderer mock/orphan code in `archives/code/dead-code-batch-2/`
+- [x] Removed dead renderer path code from the active tree
+- [x] Removed renderer mock/orphan code from the active tree
 - [x] Persisted new-session skills in `new_sessions.active_skills`
 - [x] Retired old-session skill fallback to legacy conversation settings
 - [x] Removed global `presenter.*` access from legacy runtime modules
@@ -17,7 +17,7 @@
 - [x] Migrated retained ACP helpers to `src/main/presenter/llmProviderPresenter/acp/`
 - [x] Migrated retained agent tools to `src/main/presenter/toolPresenter/agentTools/`
 - [x] Migrated retained message formatting helper to `src/main/presenter/sessionPresenter/`
-- [x] Archived retired source and tests in `archives/code/legacy-agentpresenter-retirement/`
+- [x] Removed retired source and tests from the active tree and preserved history in docs
 - [x] Refreshed active architecture / flow / navigation docs
 
 ## Kept Intentionally
@@ -35,8 +35,8 @@
 - [ ] review adjacent provider globals such as `devicePresenter` / `oauthPresenter`
 - [ ] normalize older historical specs that still mention retired legacy paths
 
-## Archive Batches
+## Historical Cleanup Batches
 
-- [x] `archives/code/dead-renderer-batch-1/`
-- [x] `archives/code/dead-code-batch-2/`
-- [x] `archives/code/legacy-agentpresenter-retirement/`
+- [x] dead renderer batch
+- [x] mock / orphan UI batch
+- [x] legacy agent runtime batch
diff --git a/docs/specs/architecture-simplification/plan.md b/docs/specs/architecture-simplification/plan.md
new file mode 100644
index 000000000..2ca77fcd0
--- /dev/null
+++ b/docs/specs/architecture-simplification/plan.md
@@ -0,0 +1,37 @@
+# Architecture Simplification Plan
+
+## Workstreams
+
+### 1. Quality Baseline
+
+- 添加 `scripts/generate-architecture-baseline.mjs`，把依赖环、零入边候选、归档引用报告落到 `docs/architecture/baselines/`。
+- 维护一份失败测试分组文档，区分真实行为回归、测试陈旧、环境问题。
+- 把这批基线纳入文档入口，后续每轮治理都基于同一套报告更新。
+
+### 2. Main Composition / Lifecycle
+
+- 新增 `ConfigQueryPort`、`SessionRuntimePort`、`WindowRoutingPort` 等窄接口。
+- 让 `Presenter` 只在 composition root 组装 port；`newAgentPresenter`、`deepchatAgentPresenter` 只依赖 port。
+- 首批迁移目标：
+  - 会话 UI 刷新
+  - 权限批准 / 清理
+  - model catalog 查询
+
+### 3. Renderer Transport / State
+
+- 增加 window context helper，避免各处各自读 `window.api`。
+- 增加 IPC subscription helper，把 `App.vue`、`stores/ui/session.ts`、`stores/ui/message.ts` 的监听注册收口。
+- 把流式状态拆到独立 `stream` store，消息缓存仍保留在 `message` store。
+
+### 4. Archive / Docs
+
+- 首先把开发者导航从历史源码快照切到稳定历史文档。
+- 在文档脱钩和 guard 到位后删除历史源码实体。
+
+## Validation
+
+- `pnpm run format`
+- `pnpm run i18n`
+- `pnpm run lint`
+- `pnpm run typecheck`
+- 针对本次改动的主链路测试与 composable/store 测试
diff --git a/docs/specs/architecture-simplification/spec.md b/docs/specs/architecture-simplification/spec.md
new file mode 100644
index 000000000..b9f03687d
--- /dev/null
+++ b/docs/specs/architecture-simplification/spec.md
@@ -0,0 +1,40 @@
+# Architecture Simplification
+
+## Summary
+
+本规格定义首期“整体减负治理”的目标：不引入新功能，优先降低 `main` / `renderer` 的心智负担，清理无用代码，减少隐式调用链，并把生命周期、边界与兼容层显式化。
+
+首期只做四类工作：
+
+- 基线收敛
+- 分层与依赖收口
+- 历史归档脱钩
+- 测试可信度恢复
+
+## Goals
+
+- 为 `main` 和 `renderer` 建立可持续更新的结构基线，而不是一次性口头结论。
+- 限制活跃路径继续依赖全局 `presenter`、分散 IPC 监听和历史归档代码。
+- 让 `newAgentPresenter`、`deepchatAgentPresenter`、`App.vue`、`stores/ui/*` 的职责边界更清楚。
+- 为后续删除历史源码归档目录和死文件清理建立前置条件。
+
+## Non-Goals
+
+- 不做新功能。
+- 不在首期重命名对外 IPC channel。
+- 不在首期移除 `SessionPresenter`、legacy import、旧表结构这些兼容边界。
+- 不要求一次性解决全部失败测试，只要求把失败分类、责任边界和修复入口理清。
+
+## Acceptance Criteria
+
+- 仓库存在一组可更新的基线报告，至少覆盖依赖环、零入边候选、归档引用、失败测试分组。
+- 活跃主链路新增 anti-regression guard，阻止历史源码重新进入运行时依赖，阻止首批主链路继续回跳全局 `presenter`。
+- `newAgentPresenter` / `deepchatAgentPresenter` 首批关键路径改为依赖窄接口 port，而不是直接 import `presenter/index.ts`。
+- `renderer` 至少将 `App`、`session`、`message` 这条活跃链路的 IPC 监听收口到 helper / subscription hub，并把流式状态独立成单独状态面。
+- 文档中存在本次治理的 `spec.md`、`plan.md`、`tasks.md`，并且 `docs/README.md` 能导航到这些内容。
+
+## Constraints
+
+- 行为兼容优先，优先保留用户可见行为和现有 IPC surface。
+- 只有经过人工分类的“真正死文件”可以删除。
+- 任何 archive 清理都要先完成文档脱钩。
diff --git a/docs/specs/architecture-simplification/tasks.md b/docs/specs/architecture-simplification/tasks.md
new file mode 100644
index 000000000..c0609fe98
--- /dev/null
+++ b/docs/specs/architecture-simplification/tasks.md
@@ -0,0 +1,31 @@
+# Architecture Simplification Tasks
+
+## Baseline
+
+- [x] 建立 architecture simplification spec / plan / tasks
+- [x] 新增依赖 / 死代码 / archive 引用基线生成脚本
+- [x] 新增失败测试分组基线文档
+
+## Main
+
+- [x] 引入窄接口 ports
+- [x] 将 `newAgentPresenter` 的会话 UI 刷新与权限清理改成依赖 port
+- [x] 将 `deepchatAgentPresenter` 的权限批准与 env prompt model lookup 改成依赖 port
+- [x] 让 `Presenter` 成为 port 的唯一组装入口
+
+## Renderer
+
+- [x] 引入 window context helper
+- [x] 引入 IPC subscription helper
+- [x] 收口 `App.vue`、`session`、`message` 的活跃监听链路
+- [x] 拆出独立 stream state store
+- [x] 修复 `session store` 对缺失 `sessionKind` 的兼容分类
+- [x] 补齐 `useSearchConfig` 与 search capability 组合逻辑
+
+## Guardrails / Docs
+
+- [x] 新增 architecture guard
+- [x] 将 lint 串上 architecture guard
+- [x] 更新 `docs/README.md`、`guides/*`、架构文档的治理入口
+- [x] 清理剩余 specs 对历史源码快照的直接文件级引用
+- [x] 删除历史源码归档实体
diff --git a/docs/specs/legacy-agentpresenter-retirement/spec.md b/docs/specs/legacy-agentpresenter-retirement/spec.md
index 0c9799fa4..d95403ce7 100644
--- a/docs/specs/legacy-agentpresenter-retirement/spec.md
+++ b/docs/specs/legacy-agentpresenter-retirement/spec.md
@@ -16,7 +16,7 @@ In scope:
 - migrate still-needed ACP helpers into `llmProviderPresenter/acp/`
 - migrate still-needed agent tools into `toolPresenter/agentTools/`
 - migrate retained message-formatting helpers into `sessionPresenter/`
-- archive retired source and tests
+- retire source and tests from the active tree and preserve history in docs
 - document the retirement in active docs and specs
 
 Out of scope:
@@ -34,14 +34,12 @@ The boundary kept after retirement:
 - old `conversations/messages` tables as import-only or export-facing sources
 - `SessionPresenter` as a main-internal compatibility/data adapter
 
-## Archive Policy
+## Historical Preservation Policy
 
-Retired live code must move to:
+Retired live code must leave the active tree.
 
-- `archives/code/legacy-agentpresenter-retirement/`
-
-Only fully retired files go to archive. Files still used by active runtime are migrated into live
-modules instead of archived in place.
+Historical structure is preserved in `docs/archives/` and related cleanup specs. Files still used by
+active runtime are migrated into live modules instead of being kept as dormant source snapshots.
 
 ## Acceptance
 
@@ -51,5 +49,5 @@ The retirement is done when:
 2. renderer no longer has public `agentPresenter` / `sessionPresenter` dependency
 3. `ILlmProviderPresenter.startStreamCompletion()` is removed
 4. migrated ACP / agent tool helpers compile and tests pass from their new locations
-5. retired source/tests exist only under `archives/code/legacy-agentpresenter-retirement/`
+5. retired source/tests no longer exist in the active tree, and their historical shape is preserved in docs
 6. active docs describe the current architecture and link historical docs as archive material
diff --git a/docs/specs/new-ui-chat-components/spec.md b/docs/specs/new-ui-chat-components/spec.md
index 79fd0587d..7217a79bc 100644
--- a/docs/specs/new-ui-chat-components/spec.md
+++ b/docs/specs/new-ui-chat-components/spec.md
@@ -4,15 +4,15 @@
 
 Chat components handle message display, input, and status configuration during active sessions. Each component's visual design must match its mock counterpart exactly.
 
-## Archived Reference Files
+## Historical Reference Map
 
-| Component | Archived Mock File |
+| Component | Historical Mock |
 |-----------|-----------|
-| ChatTopBar | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockTopBar.vue` |
-| MessageList | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockMessageList.vue` |
-| InputBox | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputBox.vue` |
-| InputToolbar | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputToolbar.vue` |
-| StatusBar | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockStatusBar.vue` |
+| ChatTopBar | `MockTopBar` |
+| MessageList | `MockMessageList` |
+| InputBox | `MockInputBox` |
+| InputToolbar | `MockInputToolbar` |
+| StatusBar | `MockStatusBar` |
 
 ## File Locations
 
@@ -29,7 +29,7 @@ src/renderer/src/components/chat/
 
 ## 1. ChatTopBar
 
-**Archived mock reference**: `dead-code-batch-2/.../MockTopBar.vue`
+**Historical mock reference**: `MockTopBar` (removed from repo)
 
 **Layout**:
 ```
@@ -57,7 +57,7 @@ interface Props {
 
 ## 2. MessageList
 
-**Archived mock reference**: `dead-code-batch-2/.../MockMessageList.vue`
+**Historical mock reference**: `MockMessageList` (removed from repo)
 
 **Layout**:
 ```
@@ -96,7 +96,7 @@ Note: The existing `useChatStore` already handles message fetching and caching v
 
 ## 3. ChatInputBox
 
-**Archived mock reference**: `dead-code-batch-2/.../MockInputBox.vue`
+**Historical mock reference**: `MockInputBox` (removed from repo)
 
 **Layout**:
 ```
@@ -133,7 +133,7 @@ interface Emits {
 
 ## 4. ChatInputToolbar
 
-**Archived mock reference**: `dead-code-batch-2/.../MockInputToolbar.vue`
+**Historical mock reference**: `MockInputToolbar` (removed from repo)
 
 **Layout**:
 ```
@@ -159,7 +159,7 @@ interface Emits {
 
 ## 5. ChatStatusBar
 
-**Archived mock reference**: `dead-code-batch-2/.../MockStatusBar.vue`
+**Historical mock reference**: `MockStatusBar` (removed from repo)
 
 **Layout**:
 ```
diff --git a/docs/specs/new-ui-implementation/todo.md b/docs/specs/new-ui-implementation/todo.md
index 02e7e6c67..ea6674b93 100644
--- a/docs/specs/new-ui-implementation/todo.md
+++ b/docs/specs/new-ui-implementation/todo.md
@@ -6,20 +6,20 @@ This document tracks the development progress of new UI feature implementation.
 
 **Architecture Design**: [new-ui-implementation-plan.md](../../architecture/new-ui-implementation-plan.md)
 
-## Archived Reference File List
+## Historical Reference Map
 
-| Archived Mock File | Purpose | Target Replacement |
+| Historical Mock | Purpose | Target Replacement |
 |-----------|---------|-------------------|
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockWelcomePage.vue` | Welcome page | `pages/WelcomePage.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/NewThreadMock.vue` | NewThread page | `pages/NewThreadPage.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockChatPage.vue` | Chat page | `pages/ChatPage.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockTopBar.vue` | Top bar | `components/chat/ChatTopBar.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockMessageList.vue` | Message list | `components/chat/MessageList.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputBox.vue` | Input box | `components/chat/ChatInputBox.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockInputToolbar.vue` | Input toolbar | `components/chat/ChatInputToolbar.vue` |
-| `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockStatusBar.vue` | Status bar | `components/chat/ChatStatusBar.vue` |
+| `MockWelcomePage` | Welcome page | `pages/WelcomePage.vue` |
+| `NewThreadMock` | NewThread page | `pages/NewThreadPage.vue` |
+| `MockChatPage` | Chat page | `pages/ChatPage.vue` |
+| `MockTopBar` | Top bar | `components/chat/ChatTopBar.vue` |
+| `MockMessageList` | Message list | `components/chat/MessageList.vue` |
+| `MockInputBox` | Input box | `components/chat/ChatInputBox.vue` |
+| `MockInputToolbar` | Input toolbar | `components/chat/ChatInputToolbar.vue` |
+| `MockStatusBar` | Status bar | `components/chat/ChatStatusBar.vue` |
 | `components/WindowSideBar.vue` | Sidebar | (refactored in place) |
-| `archives/code/dead-code-batch-2/src/renderer/src/composables/useMockViewState.ts` | State management | Replaced by stores |
+| `useMockViewState` | State management | Replaced by stores |
 
 ---
 
@@ -240,15 +240,15 @@ This document tracks the development progress of new UI feature implementation.
 
 ### 5.5 Cleanup
 
-- [x] Archive `components/mock/MockWelcomePage.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/mock/MockChatPage.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/mock/MockTopBar.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/mock/MockMessageList.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/mock/MockInputBox.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/mock/MockInputToolbar.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/mock/MockStatusBar.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `components/NewThreadMock.vue` -> `archives/code/dead-code-batch-2/`
-- [x] Archive `composables/useMockViewState.ts` -> `archives/code/dead-code-batch-2/`
+- [x] Remove `components/mock/MockWelcomePage.vue` from the active tree
+- [x] Remove `components/mock/MockChatPage.vue` from the active tree
+- [x] Remove `components/mock/MockTopBar.vue` from the active tree
+- [x] Remove `components/mock/MockMessageList.vue` from the active tree
+- [x] Remove `components/mock/MockInputBox.vue` from the active tree
+- [x] Remove `components/mock/MockInputToolbar.vue` from the active tree
+- [x] Remove `components/mock/MockStatusBar.vue` from the active tree
+- [x] Remove `components/NewThreadMock.vue` from the active tree
+- [x] Remove `composables/useMockViewState.ts` from the active tree
 
 ---
 
diff --git a/docs/specs/new-ui-pages/spec.md b/docs/specs/new-ui-pages/spec.md
index c6f1fcbce..c32903e17 100644
--- a/docs/specs/new-ui-pages/spec.md
+++ b/docs/specs/new-ui-pages/spec.md
@@ -4,13 +4,13 @@
 
 Three page components driven by the Page Router. No fallback to old ChatView — this is a full replacement.
 
-## Archived Reference Files
+## Historical Reference Map
 
-| Page | Archived Mock File |
+| Page | Historical Mock |
 |------|-----------|
-| WelcomePage | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockWelcomePage.vue` |
-| NewThreadPage | `archives/code/dead-code-batch-2/src/renderer/src/components/NewThreadMock.vue` |
-| ChatPage | `archives/code/dead-code-batch-2/src/renderer/src/components/mock/MockChatPage.vue` |
+| WelcomePage | `MockWelcomePage` |
+| NewThreadPage | `NewThreadMock` |
+| ChatPage | `MockChatPage` |
 
 ## File Locations
 
@@ -84,7 +84,7 @@ onMounted(async () => {
 
 ## 2. WelcomePage
 
-**Archived mock reference**: `dead-code-batch-2/.../MockWelcomePage.vue`
+**Historical mock reference**: `MockWelcomePage` (removed from repo)
 
 **Layout**:
 ```
@@ -133,7 +133,7 @@ onMounted(async () => {
 
 ## 3. NewThreadPage
 
-**Archived mock reference**: `dead-code-batch-2/.../NewThreadMock.vue`
+**Historical mock reference**: `NewThreadMock` (removed from repo)
 
 **Layout**:
 ```
@@ -188,7 +188,7 @@ const handleSubmit = (message: string) => {
 
 ## 4. ChatPage
 
-**Archived mock reference**: `dead-code-batch-2/.../MockChatPage.vue`
+**Historical mock reference**: `MockChatPage` (removed from repo)
 
 **Props**:
 ```typescript
diff --git a/package.json b/package.json
index 5412ac6c2..007524dd3 100644
--- a/package.json
+++ b/package.json
@@ -21,8 +21,10 @@
     "test:ui": "vitest --ui",
     "format:check": "oxfmt --check .",
     "format": "oxfmt .",
-    "lint": "pnpm run lint:agent-cleanup && oxlint .",
+    "lint": "pnpm run lint:agent-cleanup && pnpm run lint:architecture && oxlint .",
+    "lint:architecture": "node scripts/architecture-guard.mjs",
     "lint:agent-cleanup": "node scripts/agent-cleanup-guard.mjs",
+    "architecture:baseline": "node scripts/generate-architecture-baseline.mjs",
     "typecheck:node": "tsgo --noEmit -p tsconfig.node.json --composite false",
     "typecheck:web": "vue-tsgo --project tsconfig.app.tsgo.json",
     "typecheck": "pnpm run typecheck:node && pnpm run typecheck:web",
diff --git a/scripts/architecture-guard.mjs b/scripts/architecture-guard.mjs
new file mode 100644
index 000000000..18103b2fb
--- /dev/null
+++ b/scripts/architecture-guard.mjs
@@ -0,0 +1,152 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import process from 'node:process'
+
+const ROOT = process.cwd()
+const SOURCE_EXTENSIONS = new Set([
+  '.js',
+  '.jsx',
+  '.mjs',
+  '.cjs',
+  '.ts',
+  '.tsx',
+  '.mts',
+  '.cts',
+  '.vue'
+])
+
+const MAIN_GUARD_PATHS = [
+  path.join(ROOT, 'src/main/presenter/newAgentPresenter'),
+  path.join(ROOT, 'src/main/presenter/deepchatAgentPresenter'),
+  path.join(ROOT, 'src/main/lib/agentRuntime')
+]
+
+const RENDERER_IPC_GUARD_PATHS = [
+  path.join(ROOT, 'src/renderer/src/App.vue'),
+  path.join(ROOT, 'src/renderer/src/stores/ui/session.ts'),
+  path.join(ROOT, 'src/renderer/src/stores/ui/message.ts'),
+  path.join(ROOT, 'src/renderer/src/lib/storeInitializer.ts')
+]
+
+function toPosix(value) {
+  return value.split(path.sep).join('/')
+}
+
+function relativePath(filePath) {
+  return toPosix(path.relative(ROOT, filePath))
+}
+
+function isSourceFile(filePath) {
+  return SOURCE_EXTENSIONS.has(path.extname(filePath))
+}
+
+function isUnder(targetPath, parentPath) {
+  const normalizedTarget = path.resolve(targetPath)
+  const normalizedParent = path.resolve(parentPath)
+  return (
+    normalizedTarget === normalizedParent ||
+    normalizedTarget.startsWith(`${normalizedParent}${path.sep}`)
+  )
+}
+
+async function collectFiles(entryPath) {
+  const stats = await fs.stat(entryPath)
+  if (stats.isFile()) {
+    return isSourceFile(entryPath) ? [entryPath] : []
+  }
+
+  const entries = await fs.readdir(entryPath, { withFileTypes: true })
+  const files = []
+  for (const entry of entries) {
+    const nextPath = path.join(entryPath, entry.name)
+    if (entry.isDirectory()) {
+      files.push(...(await collectFiles(nextPath)))
+      continue
+    }
+    if (entry.isFile() && isSourceFile(nextPath)) {
+      files.push(nextPath)
+    }
+  }
+  return files
+}
+
+function extractModuleSpecifiers(source) {
+  const specifiers = new Set()
+  const patterns = [
+    /\bimport\s+(?:type\s+)?[\s\S]*?\bfrom\s*['"]([^'"]+)['"]/g,
+    /\bexport\s+[\s\S]*?\bfrom\s*['"]([^'"]+)['"]/g,
+    /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g
+  ]
+
+  for (const pattern of patterns) {
+    let match
+    while ((match = pattern.exec(source)) !== null) {
+      specifiers.add(match[1])
+    }
+  }
+
+  return [...specifiers]
+}
+
+async function main() {
+  const scanRoots = [path.join(ROOT, 'src'), path.join(ROOT, 'docs')]
+  const fileSet = new Set()
+
+  for (const root of scanRoots) {
+    for (const file of await collectFiles(root)) {
+      fileSet.add(file)
+    }
+  }
+
+  const violations = []
+
+  for (const filePath of [...fileSet].sort()) {
+    const source = await fs.readFile(filePath, 'utf8')
+    const specifiers = extractModuleSpecifiers(source)
+
+    if (isUnder(filePath, path.join(ROOT, 'src'))) {
+      for (const specifier of specifiers) {
+        if (specifier.includes('archives/code/')) {
+          violations.push(`[archive-import] ${relativePath(filePath)} -> ${specifier}`)
+        }
+      }
+    }
+
+    if (MAIN_GUARD_PATHS.some((guardPath) => isUnder(filePath, guardPath))) {
+      for (const specifier of specifiers) {
+        if (
+          specifier === '@/presenter' ||
+          specifier === '@/presenter/index' ||
+          specifier === '../index' ||
+          specifier === '../../index'
+        ) {
+          violations.push(`[main-global-presenter] ${relativePath(filePath)} -> ${specifier}`)
+        }
+      }
+    }
+
+    if (RENDERER_IPC_GUARD_PATHS.some((guardPath) => isUnder(filePath, guardPath))) {
+      if (source.includes('window.electron.ipcRenderer.on(')) {
+        violations.push(`[renderer-direct-ipc] ${relativePath(filePath)}`)
+      }
+      if (source.includes('window.electron.ipcRenderer.removeAllListeners(')) {
+        violations.push(`[renderer-remove-all-listeners] ${relativePath(filePath)}`)
+      }
+    }
+  }
+
+  if (violations.length > 0) {
+    console.error('Architecture guard failed.')
+    for (const violation of violations) {
+      console.error(`- ${violation}`)
+    }
+    process.exit(1)
+  }
+
+  console.log('Architecture guard passed.')
+}
+
+main().catch((error) => {
+  console.error('Architecture guard failed to run:', error)
+  process.exit(1)
+})
diff --git a/scripts/generate-architecture-baseline.mjs b/scripts/generate-architecture-baseline.mjs
new file mode 100644
index 000000000..e1691eacd
--- /dev/null
+++ b/scripts/generate-architecture-baseline.mjs
@@ -0,0 +1,358 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import process from 'node:process'
+
+const ROOT = process.cwd()
+const REPORT_DIR = path.join(ROOT, 'docs/architecture/baselines')
+const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.vue', '.d.ts'])
+const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'dist', 'out', 'build'])
+
+const ANALYSIS_TARGETS = [
+  {
+    label: 'main',
+    root: path.join(ROOT, 'src/main')
+  },
+  {
+    label: 'renderer',
+    root: path.join(ROOT, 'src/renderer/src')
+  }
+]
+
+function toPosix(value) {
+  return value.split(path.sep).join('/')
+}
+
+async function ensureDir(dirPath) {
+  await fs.mkdir(dirPath, { recursive: true })
+}
+
+async function walk(dirPath, output = []) {
+  const entries = await fs.readdir(dirPath, { withFileTypes: true })
+
+  for (const entry of entries) {
+    if (EXCLUDED_DIRS.has(entry.name)) {
+      continue
+    }
+
+    const nextPath = path.join(dirPath, entry.name)
+    if (entry.isDirectory()) {
+      await walk(nextPath, output)
+      continue
+    }
+
+    if (entry.isFile() && SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+      output.push(nextPath)
+    }
+  }
+
+  return output
+}
+
+function extractSpecifiers(source) {
+  const specifiers = new Set()
+  const patterns = [
+    /\bimport\s+(?:type\s+)?[\s\S]*?\bfrom\s*['"]([^'"]+)['"]/g,
+    /\bexport\s+[\s\S]*?\bfrom\s*['"]([^'"]+)['"]/g,
+    /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g
+  ]
+
+  for (const pattern of patterns) {
+    let match
+    while ((match = pattern.exec(source)) !== null) {
+      specifiers.add(match[1])
+    }
+  }
+
+  return [...specifiers]
+}
+
+async function resolveImport(specifier, importer, scopeRoot) {
+  const tryFile = async (basePath) => {
+    const candidates = [
+      basePath,
+      `${basePath}.ts`,
+      `${basePath}.tsx`,
+      `${basePath}.js`,
+      `${basePath}.jsx`,
+      `${basePath}.vue`,
+      `${basePath}.d.ts`,
+      path.join(basePath, 'index.ts'),
+      path.join(basePath, 'index.tsx'),
+      path.join(basePath, 'index.js'),
+      path.join(basePath, 'index.jsx'),
+      path.join(basePath, 'index.vue'),
+      path.join(basePath, 'index.d.ts')
+    ]
+
+    for (const candidate of candidates) {
+      try {
+        const stat = await fs.stat(candidate)
+        if (stat.isFile()) {
+          return candidate
+        }
+      } catch {}
+    }
+
+    return null
+  }
+
+  if (specifier.startsWith('@/')) {
+    return await tryFile(path.join(scopeRoot, specifier.slice(2)))
+  }
+
+  if (specifier.startsWith('@shared/')) {
+    return await tryFile(path.join(ROOT, 'src/shared', specifier.slice('@shared/'.length)))
+  }
+
+  if (specifier.startsWith('.')) {
+    return await tryFile(path.resolve(path.dirname(importer), specifier))
+  }
+
+  return null
+}
+
+async function analyzeScope(label, scopeRoot) {
+  const files = await walk(scopeRoot)
+  const fileSet = new Set(files)
+  const edges = new Map(files.map((file) => [file, new Set()]))
+  const reverseEdges = new Map(files.map((file) => [file, new Set()]))
+
+  for (const file of files) {
+    const source = await fs.readFile(file, 'utf8')
+    for (const specifier of extractSpecifiers(source)) {
+      const resolved = await resolveImport(specifier, file, scopeRoot)
+      if (!resolved || !fileSet.has(resolved)) {
+        continue
+      }
+
+      edges.get(file).add(resolved)
+      reverseEdges.get(resolved).add(file)
+    }
+  }
+
+  const cycles = []
+  const cycleKeys = new Set()
+  const visiting = new Set()
+  const visited = new Set()
+  const stack = []
+
+  function traverse(node) {
+    visiting.add(node)
+    stack.push(node)
+
+    for (const next of edges.get(node)) {
+      if (!visiting.has(next) && !visited.has(next)) {
+        traverse(next)
+        continue
+      }
+
+      if (visiting.has(next)) {
+        const startIndex = stack.indexOf(next)
+        const cycle = stack.slice(startIndex).concat(next)
+        const key = cycle
+          .slice(0, -1)
+          .map((file) => path.relative(scopeRoot, file))
+          .sort()
+          .join('|')
+
+        if (!cycleKeys.has(key)) {
+          cycleKeys.add(key)
+          cycles.push(cycle)
+        }
+      }
+    }
+
+    stack.pop()
+    visiting.delete(node)
+    visited.add(node)
+  }
+
+  for (const file of files) {
+    if (!visited.has(file)) {
+      traverse(file)
+    }
+  }
+
+  const topOutgoing = [...edges.entries()]
+    .map(([file, refs]) => ({
+      file: path.relative(scopeRoot, file),
+      count: refs.size
+    }))
+    .sort((left, right) => right.count - left.count)
+    .slice(0, 15)
+
+  const topIncoming = [...reverseEdges.entries()]
+    .map(([file, refs]) => ({
+      file: path.relative(scopeRoot, file),
+      count: refs.size
+    }))
+    .sort((left, right) => right.count - left.count)
+    .slice(0, 15)
+
+  const zeroInbound = [...reverseEdges.entries()]
+    .filter(([, refs]) => refs.size === 0)
+    .map(([file]) => path.relative(scopeRoot, file))
+    .filter((file) => !/index\.(ts|tsx|js|jsx|vue|d\.ts)$/.test(file))
+    .sort()
+
+  return {
+    label,
+    totalFiles: files.length,
+    totalEdges: [...edges.values()].reduce((sum, refs) => sum + refs.size, 0),
+    cycles: cycles.map((cycle) => cycle.map((file) => path.relative(scopeRoot, file))),
+    topOutgoing,
+    topIncoming,
+    zeroInbound
+  }
+}
+
+async function collectArchiveReferences() {
+  const scanRoots = [path.join(ROOT, 'docs'), path.join(ROOT, 'src')]
+  const references = []
+
+  for (const scanRoot of scanRoots) {
+    const files = await walk(scanRoot)
+    for (const file of files) {
+      const source = await fs.readFile(file, 'utf8')
+      const lines = source.split('\n')
+
+      lines.forEach((line, index) => {
+        if (!line.includes('archives/code/')) {
+          return
+        }
+
+        references.push({
+          file: toPosix(path.relative(ROOT, file)),
+          line: index + 1,
+          text: line.trim()
+        })
+      })
+    }
+  }
+
+  return references.sort((left, right) =>
+    `${left.file}:${left.line}`.localeCompare(`${right.file}:${right.line}`)
+  )
+}
+
+function renderDependencyReport(scopes) {
+  const lines = [
+    '# Dependency Baseline',
+    '',
+    `Generated on ${new Date().toISOString().slice(0, 10)}.`,
+    ''
+  ]
+
+  for (const scope of scopes) {
+    lines.push(`## ${scope.label}`)
+    lines.push('')
+    lines.push(`- Total files: ${scope.totalFiles}`)
+    lines.push(`- Internal dependency edges: ${scope.totalEdges}`)
+    lines.push(`- Cycles detected: ${scope.cycles.length}`)
+    lines.push('')
+    lines.push('### Top outgoing dependencies')
+    lines.push('')
+
+    for (const item of scope.topOutgoing) {
+      lines.push(`- \`${item.file}\`: ${item.count}`)
+    }
+
+    lines.push('')
+    lines.push('### Top incoming dependencies')
+    lines.push('')
+
+    for (const item of scope.topIncoming) {
+      lines.push(`- \`${item.file}\`: ${item.count}`)
+    }
+
+    lines.push('')
+    lines.push('### Cycle samples')
+    lines.push('')
+
+    if (scope.cycles.length === 0) {
+      lines.push('- None')
+    } else {
+      for (const cycle of scope.cycles.slice(0, 20)) {
+        lines.push(`- \`${cycle.join(' -> ')}\``)
+      }
+    }
+
+    lines.push('')
+  }
+
+  return lines.join('\n')
+}
+
+function renderZeroInboundReport(scopes) {
+  const lines = [
+    '# Zero Inbound Candidates',
+    '',
+    `Generated on ${new Date().toISOString().slice(0, 10)}.`,
+    '',
+    'These files have no in-repo importers inside their scope and need manual classification before deletion.',
+    ''
+  ]
+
+  for (const scope of scopes) {
+    lines.push(`## ${scope.label}`)
+    lines.push('')
+    lines.push(`- Candidate count: ${scope.zeroInbound.length}`)
+    lines.push('')
+    for (const file of scope.zeroInbound) {
+      lines.push(`- \`${file}\``)
+    }
+    lines.push('')
+  }
+
+  return lines.join('\n')
+}
+
+function renderArchiveReferenceReport(references) {
+  const lines = [
+    '# Archive Reference Baseline',
+    '',
+    `Generated on ${new Date().toISOString().slice(0, 10)}.`,
+    '',
+    `- Total references: ${references.length}`,
+    ''
+  ]
+
+  for (const reference of references) {
+    lines.push(`- \`${reference.file}:${reference.line}\` ${reference.text}`)
+  }
+
+  return lines.join('\n')
+}
+
+async function main() {
+  await ensureDir(REPORT_DIR)
+  const scopes = []
+
+  for (const target of ANALYSIS_TARGETS) {
+    scopes.push(await analyzeScope(target.label, target.root))
+  }
+
+  const archiveReferences = await collectArchiveReferences()
+
+  await Promise.all([
+    fs.writeFile(
+      path.join(REPORT_DIR, 'dependency-report.md'),
+      `${renderDependencyReport(scopes)}\n`
+    ),
+    fs.writeFile(
+      path.join(REPORT_DIR, 'zero-inbound-candidates.md'),
+      `${renderZeroInboundReport(scopes)}\n`
+    ),
+    fs.writeFile(
+      path.join(REPORT_DIR, 'archive-reference-report.md'),
+      `${renderArchiveReferenceReport(archiveReferences)}\n`
+    )
+  ])
+
+  console.log('Architecture baseline reports updated in docs/architecture/baselines.')
+}
+
+main().catch((error) => {
+  console.error('Failed to generate architecture baseline reports:', error)
+  process.exit(1)
+})
diff --git a/src/main/lib/agentRuntime/systemEnvPromptBuilder.ts b/src/main/lib/agentRuntime/systemEnvPromptBuilder.ts
index 1579b1196..5dfa52787 100644
--- a/src/main/lib/agentRuntime/systemEnvPromptBuilder.ts
+++ b/src/main/lib/agentRuntime/systemEnvPromptBuilder.ts
@@ -1,7 +1,7 @@
 import * as fs from 'node:fs'
 import path from 'node:path'
-import { presenter } from '@/presenter'
 import logger from '@shared/logger'
+import type { ConfigQueryPort } from '@/presenter/runtimePorts'
 
 export interface BuildSystemEnvPromptOptions {
   providerId?: string
@@ -10,6 +10,7 @@ export interface BuildSystemEnvPromptOptions {
   platform?: NodeJS.Platform
   now?: Date
   agentsFilePath?: string
+  modelLookup?: Pick<ConfigQueryPort, 'getProviderModels' | 'getCustomModels'>
 }
 
 export interface RuntimeCapabilitiesPromptOptions {
@@ -18,15 +19,19 @@ export interface RuntimeCapabilitiesPromptOptions {
   hasProcess?: boolean
 }
 
-function resolveModelDisplayName(providerId: string, modelId: string): string | undefined {
+function resolveModelDisplayName(
+  providerId: string,
+  modelId: string,
+  modelLookup?: Pick<ConfigQueryPort, 'getProviderModels' | 'getCustomModels'>
+): string | undefined {
   try {
-    const models = presenter.configPresenter?.getProviderModels?.(providerId) || []
+    const models = modelLookup?.getProviderModels(providerId) || []
     const match = models.find((model) => model.id === modelId)
     if (match?.name) {
       return match.name
     }
 
-    const customModels = presenter.configPresenter?.getCustomModels?.(providerId) || []
+    const customModels = modelLookup?.getCustomModels(providerId) || []
     const customMatch = customModels.find((model) => model.id === modelId)
     if (customMatch?.name) {
       return customMatch.name
@@ -43,14 +48,15 @@ function resolveModelDisplayName(providerId: string, modelId: string): string |
 
 function resolveModelIdentity(
   providerId?: string,
-  modelId?: string
+  modelId?: string,
+  modelLookup?: Pick<ConfigQueryPort, 'getProviderModels' | 'getCustomModels'>
 ): {
   modelName: string
   exactModelId: string
 } {
   const trimmedProviderId = providerId?.trim() || 'unknown-provider'
   const trimmedModelId = modelId?.trim() || 'unknown-model'
-  const displayName = resolveModelDisplayName(trimmedProviderId, trimmedModelId)
+  const displayName = resolveModelDisplayName(trimmedProviderId, trimmedModelId, modelLookup)
 
   return {
     modelName: displayName || trimmedModelId,
@@ -133,7 +139,11 @@ export async function buildSystemEnvPrompt(
     ? path.resolve(options.agentsFilePath)
     : path.join(workdir, 'AGENTS.md')
   const agentsContent = await readAgentsInstructions(agentsFilePath)
-  const { modelName, exactModelId } = resolveModelIdentity(options.providerId, options.modelId)
+  const { modelName, exactModelId } = resolveModelIdentity(
+    options.providerId,
+    options.modelId,
+    options.modelLookup
+  )
 
   const promptLines = [
     `You are powered by the model named ${modelName}.`,
diff --git a/src/main/presenter/deepchatAgentPresenter/dispatch.ts b/src/main/presenter/deepchatAgentPresenter/dispatch.ts
index 7e893058c..1c3dc95a9 100644
--- a/src/main/presenter/deepchatAgentPresenter/dispatch.ts
+++ b/src/main/presenter/deepchatAgentPresenter/dispatch.ts
@@ -1,6 +1,5 @@
 import { eventBus, SendTarget } from '@/eventbus'
 import { STREAM_EVENTS } from '@/events'
-import { presenter } from '@/presenter'
 import type {
   MCPToolCall,
   MCPContentItem,
@@ -399,41 +398,12 @@ function normalizePermissionRequest(
 }
 
 async function autoGrantPermission(
-  conversationId: string,
+  hooks: ProcessHooks | undefined,
+  _conversationId: string,
   permission: NonNullable<PendingToolInteraction['permission']>
 ): Promise<void> {
-  const type = permission.permissionType
-  const serverName = permission.serverName || ''
-  const toolName = permission.toolName || ''
-
-  if (type === 'command') {
-    const command = permission.command || permission.commandInfo?.command || ''
-    const signature =
-      permission.commandSignature ||
-      permission.commandInfo?.signature ||
-      (command ? presenter.commandPermissionService.extractCommandSignature(command) : '')
-    if (signature) {
-      presenter.commandPermissionService.approve(conversationId, signature, false)
-    }
-    return
-  }
-
-  if (
-    serverName === 'agent-filesystem' &&
-    Array.isArray(permission.paths) &&
-    permission.paths.length
-  ) {
-    presenter.filePermissionService?.approve(conversationId, permission.paths, false)
-    return
-  }
-
-  if (serverName === 'deepchat-settings' && toolName) {
-    presenter.settingsPermissionService?.approve(conversationId, toolName, false)
-    return
-  }
-
-  if (serverName && (type === 'read' || type === 'write' || type === 'all')) {
-    await presenter.mcpPresenter.grantPermission(serverName, type, false, conversationId)
+  if (hooks?.autoGrantPermission) {
+    await hooks.autoGrantPermission(permission)
   }
 }
 
@@ -698,7 +668,7 @@ export async function executeTools(
 
       if (preCheckedPermission) {
         if (permissionMode === 'full_access') {
-          await autoGrantPermission(io.sessionId, preCheckedPermission)
+          await autoGrantPermission(hooks, io.sessionId, preCheckedPermission)
         } else {
           hooks?.onPermissionRequest?.(preCheckedPermission, {
             callId: tc.id,
@@ -756,7 +726,7 @@ export async function executeTools(
 
         if (pendingPermission) {
           if (permissionMode === 'full_access') {
-            await autoGrantPermission(io.sessionId, pendingPermission)
+            await autoGrantPermission(hooks, io.sessionId, pendingPermission)
             const retryCallResult = await toolPresenter.callTool(toolCall, {
               onProgress: applyProgressUpdate,
               signal: io.abortSignal
diff --git a/src/main/presenter/deepchatAgentPresenter/index.ts b/src/main/presenter/deepchatAgentPresenter/index.ts
index e7668a163..0df4a1fd8 100644
--- a/src/main/presenter/deepchatAgentPresenter/index.ts
+++ b/src/main/presenter/deepchatAgentPresenter/index.ts
@@ -18,6 +18,7 @@ import type { ChatMessage } from '@shared/types/core/chat-message'
 import type {
   IConfigPresenter,
   ILlmProviderPresenter,
+  ISkillPresenter,
   ModelConfig,
   RateLimitQueueSnapshot
 } from '@shared/presenter'
@@ -38,7 +39,6 @@ import {
   buildRuntimeCapabilitiesPrompt,
   buildSystemEnvPrompt
 } from '@/lib/agentRuntime/systemEnvPromptBuilder'
-import { presenter } from '@/presenter'
 import {
   buildContext,
   buildResumeContext,
@@ -58,6 +58,7 @@ import type { ProviderRequestTracePayload } from '../llmProviderPresenter/reques
 import type { NewSessionHooksBridge } from '../hooksNotifications/newSessionBridge'
 import { providerDbLoader } from '../configPresenter/providerDbLoader'
 import { resolveSessionVisionTarget } from '../vision/sessionVisionResolver'
+import type { ConfigQueryPort, SessionRuntimePort } from '../runtimePorts'
 import {
   buildAssistantPreviewMarkdown,
   buildAssistantResponseMarkdown,
@@ -155,6 +156,12 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
   private readonly compactionService: CompactionService
   private readonly toolOutputGuard: ToolOutputGuard
   private readonly hooksBridge?: NewSessionHooksBridge
+  private readonly configQueryPort: Pick<ConfigQueryPort, 'getProviderModels' | 'getCustomModels'>
+  private readonly sessionRuntimePort?: SessionRuntimePort
+  private readonly skillPresenter?: Pick<
+    ISkillPresenter,
+    'getMetadataList' | 'getActiveSkills' | 'loadSkillContent'
+  >
   private nextRunSequence = 0
 
   constructor(
@@ -162,7 +169,15 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
     configPresenter: IConfigPresenter,
     sqlitePresenter: SQLitePresenter,
     toolPresenter?: IToolPresenter,
-    hooksBridge?: NewSessionHooksBridge
+    hooksBridge?: NewSessionHooksBridge,
+    runtimePorts?: {
+      configQueryPort?: Pick<ConfigQueryPort, 'getProviderModels' | 'getCustomModels'>
+      sessionRuntimePort?: SessionRuntimePort
+      skillPresenter?: Pick<
+        ISkillPresenter,
+        'getMetadataList' | 'getActiveSkills' | 'loadSkillContent'
+      >
+    }
   ) {
     this.llmProviderPresenter = llmProviderPresenter
     this.configPresenter = configPresenter
@@ -179,11 +194,21 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
       this.configPresenter,
       async (sessionId) => {
         const agentId = this.getSessionAgentId(sessionId) ?? 'deepchat'
+        if (typeof this.configPresenter.resolveDeepChatAgentConfig !== 'function') {
+          return {}
+        }
+
         return await this.configPresenter.resolveDeepChatAgentConfig(agentId)
       }
     )
     this.toolOutputGuard = new ToolOutputGuard()
     this.hooksBridge = hooksBridge
+    this.configQueryPort = runtimePorts?.configQueryPort ?? {
+      getProviderModels: (providerId) => this.configPresenter.getProviderModels?.(providerId) ?? [],
+      getCustomModels: (providerId) => this.configPresenter.getCustomModels?.(providerId) ?? []
+    }
+    this.sessionRuntimePort = runtimePorts?.sessionRuntimePort
+    this.skillPresenter = runtimePorts?.skillPresenter
 
     const recovered = this.messageStore.recoverPendingMessages()
     if (recovered > 0) {
@@ -1595,6 +1620,9 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
               }
             })
           },
+          autoGrantPermission: async (permission) => {
+            await this.sessionRuntimePort?.approvePermission(sessionId, permission)
+          },
           normalizeToolResult: async (tool) =>
             await this.normalizeToolResultContent({
               sessionId: tool.sessionId,
@@ -1998,7 +2026,7 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
     const dayKey = this.buildLocalDayKey(now)
 
     const skillsEnabled = this.configPresenter.getSkillsEnabled()
-    const skillPresenter = presenter?.skillPresenter
+    const skillPresenter = this.skillPresenter
     const availableSkillNames: string[] = []
     const activeSkillNames: string[] = []
 
@@ -2102,7 +2130,8 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
         providerId,
         modelId,
         workdir,
-        now
+        now,
+        modelLookup: this.configQueryPort
       })
     } catch (error) {
       console.warn(`[DeepChatAgent] Failed to build env prompt for session ${sessionId}:`, error)
@@ -3057,23 +3086,34 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
 
     if (permissionType === 'command') {
       const command = payload.command || payload.commandInfo?.command || ''
-      const signature =
-        payload.commandSignature ||
-        payload.commandInfo?.signature ||
-        (command ? presenter.commandPermissionService.extractCommandSignature(command) : '')
+      const signature = payload.commandSignature || payload.commandInfo?.signature || command
       if (signature) {
-        presenter.commandPermissionService.approve(sessionId, signature, false)
+        await this.sessionRuntimePort?.approvePermission(sessionId, {
+          permissionType: 'command',
+          command,
+          commandSignature: signature,
+          commandInfo: payload.commandInfo
+        })
       }
       return
     }
 
     if (serverName === 'agent-filesystem' && Array.isArray(payload.paths) && payload.paths.length) {
-      presenter.filePermissionService?.approve(sessionId, payload.paths, false)
+      await this.sessionRuntimePort?.approvePermission(sessionId, {
+        permissionType: 'write',
+        serverName,
+        toolName,
+        paths: payload.paths
+      })
       return
     }
 
     if (serverName === 'deepchat-settings' && toolName) {
-      presenter.settingsPermissionService?.approve(sessionId, toolName, false)
+      await this.sessionRuntimePort?.approvePermission(sessionId, {
+        permissionType: 'write',
+        serverName,
+        toolName
+      })
       return
     }
 
@@ -3081,7 +3121,11 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
       serverName &&
       (permissionType === 'read' || permissionType === 'write' || permissionType === 'all')
     ) {
-      await presenter.mcpPresenter.grantPermission(serverName, permissionType, false, sessionId)
+      await this.sessionRuntimePort?.approvePermission(sessionId, {
+        permissionType,
+        serverName,
+        toolName
+      })
     }
   }
 
@@ -3720,11 +3764,7 @@ export class DeepChatAgentPresenter implements IAgentImplementation {
       status
     })
 
-    try {
-      void presenter.floatingButtonPresenter.refreshWidgetState()
-    } catch (error) {
-      console.warn('[DeepChatAgent] Failed to refresh floating widget state:', error)
-    }
+    this.sessionRuntimePort?.refreshSessionUi()
   }
 
   private emitMessageRefresh(sessionId: string, messageId: string): void {
diff --git a/src/main/presenter/deepchatAgentPresenter/types.ts b/src/main/presenter/deepchatAgentPresenter/types.ts
index df53d0936..84263e9d3 100644
--- a/src/main/presenter/deepchatAgentPresenter/types.ts
+++ b/src/main/presenter/deepchatAgentPresenter/types.ts
@@ -76,6 +76,9 @@ export interface ProcessHooks {
     reasoningContentLength: number
     toolCallCount: number
   }) => void
+  autoGrantPermission?: (
+    permission: NonNullable<PendingToolInteraction['permission']>
+  ) => Promise<void>
   normalizeToolResult?: (tool: {
     sessionId: string
     toolCallId: string
diff --git a/src/main/presenter/index.ts b/src/main/presenter/index.ts
index 03da74983..72846a05a 100644
--- a/src/main/presenter/index.ts
+++ b/src/main/presenter/index.ts
@@ -73,6 +73,7 @@ import { AgentRepository } from './agentRepository'
 import type { SQLitePresenter } from './sqlitePresenter'
 import { normalizeDeepChatSubagentSlots } from '@shared/lib/deepchatSubagents'
 import { subscribeDeepChatInternalSessionUpdates } from './deepchatAgentPresenter/internalSessionEvents'
+import type { ConfigQueryPort, SessionRuntimePort } from './runtimePorts'
 
 // IPC调用上下文接口
 interface IPCCallContext {
@@ -411,6 +412,63 @@ export class Presenter implements IPresenter {
       getMessage: async () => null
     })
     const newSessionHooksBridge = new NewSessionHooksBridge(this.hooksNotifications)
+    const configQueryPort: ConfigQueryPort = {
+      getProviderModels: (providerId) => this.configPresenter.getProviderModels?.(providerId) ?? [],
+      getCustomModels: (providerId) => this.configPresenter.getCustomModels?.(providerId) ?? [],
+      getAgentType: async (agentId) => await this.configPresenter.getAgentType(agentId)
+    }
+    const sessionRuntimePort: SessionRuntimePort = {
+      refreshSessionUi: () => {
+        try {
+          void this.floatingButtonPresenter.refreshWidgetState()
+        } catch (error) {
+          console.warn('[Presenter] Failed to refresh floating widget state:', error)
+        }
+      },
+      clearSessionPermissions: (sessionId) => {
+        this.commandPermissionService.clearConversation(sessionId)
+        this.filePermissionService.clearConversation(sessionId)
+        this.settingsPermissionService.clearConversation(sessionId)
+      },
+      approvePermission: async (sessionId, permission) => {
+        const permissionType = permission.permissionType
+        const serverName = permission.serverName || ''
+        const toolName = permission.toolName || ''
+
+        if (permissionType === 'command') {
+          const command = permission.command || permission.commandInfo?.command || ''
+          const signature =
+            permission.commandSignature ||
+            permission.commandInfo?.signature ||
+            (command ? this.commandPermissionService.extractCommandSignature(command) : '')
+          if (signature) {
+            this.commandPermissionService.approve(sessionId, signature, false)
+          }
+          return
+        }
+
+        if (
+          serverName === 'agent-filesystem' &&
+          Array.isArray(permission.paths) &&
+          permission.paths.length > 0
+        ) {
+          this.filePermissionService.approve(sessionId, permission.paths, false)
+          return
+        }
+
+        if (serverName === 'deepchat-settings' && toolName) {
+          this.settingsPermissionService.approve(sessionId, toolName, false)
+          return
+        }
+
+        if (
+          serverName &&
+          (permissionType === 'read' || permissionType === 'write' || permissionType === 'all')
+        ) {
+          await this.mcpPresenter.grantPermission(serverName, permissionType, false, sessionId)
+        }
+      }
+    }
 
     // Initialize new agent architecture presenters
     const deepchatAgentPresenter = new DeepChatAgentPresenter(
@@ -418,14 +476,20 @@ export class Presenter implements IPresenter {
       this.configPresenter,
       this.sqlitePresenter as unknown as import('./sqlitePresenter').SQLitePresenter,
       this.toolPresenter,
-      newSessionHooksBridge
+      newSessionHooksBridge,
+      {
+        configQueryPort,
+        sessionRuntimePort,
+        skillPresenter: this.skillPresenter
+      }
     )
     this.newAgentPresenter = new NewAgentPresenter(
       deepchatAgentPresenter,
       this.llmproviderPresenter as unknown as ILlmProviderPresenter,
       this.configPresenter,
       this.sqlitePresenter as unknown as import('./sqlitePresenter').SQLitePresenter,
-      this.skillPresenter
+      this.skillPresenter,
+      sessionRuntimePort
     )
     this.projectPresenter = new ProjectPresenter(
       this.sqlitePresenter as unknown as import('./sqlitePresenter').SQLitePresenter,
diff --git a/src/main/presenter/newAgentPresenter/index.ts b/src/main/presenter/newAgentPresenter/index.ts
index c3860d7ee..4c2f46608 100644
--- a/src/main/presenter/newAgentPresenter/index.ts
+++ b/src/main/presenter/newAgentPresenter/index.ts
@@ -43,7 +43,6 @@ import { NewMessageManager } from './messageManager'
 import { LegacyChatImportService } from './legacyImportService'
 import { eventBus, SendTarget } from '@/eventbus'
 import { SESSION_EVENTS } from '@/events'
-import { presenter } from '@/presenter'
 import {
   buildConversationExportContent,
   generateExportFilename,
@@ -63,6 +62,7 @@ import {
 } from '../usageStats'
 import { rtkRuntimeService } from '@/lib/agentRuntime/rtkRuntimeService'
 import { resolveAcpAgentAlias } from '../configPresenter/acpRegistryConstants'
+import type { SessionRuntimePort } from '../runtimePorts'
 
 type SearchableSessionRow = {
   id: string
@@ -221,6 +221,7 @@ export class NewAgentPresenter {
   private configPresenter: IConfigPresenter
   private legacyImportService: LegacyChatImportService
   private skillPresenter?: Pick<ISkillPresenter, 'setActiveSkills' | 'clearNewAgentSessionSkills'>
+  private sessionRuntimePort?: SessionRuntimePort
   private usageStatsBackfillPromise: Promise<void> | null = null
 
   constructor(
@@ -228,7 +229,8 @@ export class NewAgentPresenter {
     llmProviderPresenter: ILlmProviderPresenter,
     configPresenter: IConfigPresenter,
     sqlitePresenter: SQLitePresenter,
-    skillPresenter?: Pick<ISkillPresenter, 'setActiveSkills' | 'clearNewAgentSessionSkills'>
+    skillPresenter?: Pick<ISkillPresenter, 'setActiveSkills' | 'clearNewAgentSessionSkills'>,
+    sessionRuntimePort?: SessionRuntimePort
   ) {
     this.sqlitePresenter = sqlitePresenter
     this.llmProviderPresenter = llmProviderPresenter
@@ -238,6 +240,7 @@ export class NewAgentPresenter {
     this.sessionManager = new NewSessionManager(sqlitePresenter)
     this.messageManager = new NewMessageManager(this.agentRegistry)
     this.legacyImportService = new LegacyChatImportService(sqlitePresenter)
+    this.sessionRuntimePort = sessionRuntimePort
 
     // Register the built-in deepchat agent
     this.agentRegistry.register(
@@ -254,13 +257,11 @@ export class NewAgentPresenter {
     const normalizedInput = this.normalizeCreateSessionInput(input)
     const agentType = await this.getAgentType(agentId)
     const deepChatAgentConfig =
-      agentType === 'deepchat'
-        ? await this.configPresenter.resolveDeepChatAgentConfig(agentId)
-        : null
+      agentType === 'deepchat' ? await this.resolveDeepChatAgentConfigCompat(agentId) : null
     const projectDir =
       input.projectDir?.trim() ||
       deepChatAgentConfig?.defaultProjectPath?.trim() ||
-      this.configPresenter.getDefaultProjectPath() ||
+      this.getDefaultProjectPathCompat() ||
       null
     const disabledAgentTools =
       agentType === 'deepchat'
@@ -397,13 +398,11 @@ export class NewAgentPresenter {
     const title = input.title?.trim() || 'New Chat'
     const agentType = await this.getAgentType(agentId)
     const deepChatAgentConfig =
-      agentType === 'deepchat'
-        ? await this.configPresenter.resolveDeepChatAgentConfig(agentId)
-        : null
+      agentType === 'deepchat' ? await this.resolveDeepChatAgentConfigCompat(agentId) : null
     const projectDir =
       input.projectDir?.trim() ||
       deepChatAgentConfig?.defaultProjectPath?.trim() ||
-      this.configPresenter.getDefaultProjectPath() ||
+      this.getDefaultProjectPathCompat() ||
       null
     const disabledAgentTools =
       agentType === 'deepchat'
@@ -1649,12 +1648,7 @@ export class NewAgentPresenter {
 
   private emitSessionListUpdated(): void {
     eventBus.sendToRenderer(SESSION_EVENTS.LIST_UPDATED, SendTarget.ALL_WINDOWS)
-
-    try {
-      void presenter.floatingButtonPresenter.refreshWidgetState()
-    } catch (error) {
-      console.warn('[NewAgentPresenter] Failed to refresh floating widget state:', error)
-    }
+    this.sessionRuntimePort?.refreshSessionUi()
   }
 
   private async waitForSessionIdle(sessionId: string): Promise<boolean> {
@@ -1725,18 +1719,54 @@ export class NewAgentPresenter {
   }
 
   private async getAgentType(agentId: string): Promise<'deepchat' | 'acp' | null> {
+    if (typeof this.configPresenter.getAgentType !== 'function') {
+      const resolvedAgentId = resolveAcpAgentAlias(agentId)
+      if (resolvedAgentId === 'deepchat') {
+        return 'deepchat'
+      }
+      const fallbackAgent = await this.configPresenter.getAgent?.(resolvedAgentId)
+      if (fallbackAgent?.type === 'acp' || fallbackAgent?.type === 'deepchat') {
+        return fallbackAgent.type
+      }
+
+      const acpAgents = await this.configPresenter.getAcpAgents?.()
+      if (acpAgents?.some((agent) => resolveAcpAgentAlias(agent.id) === resolvedAgentId)) {
+        return 'acp'
+      }
+
+      return null
+    }
+
     return await this.configPresenter.getAgentType(resolveAcpAgentAlias(agentId))
   }
 
+  private async resolveDeepChatAgentConfigCompat(
+    agentId: string
+  ): Promise<Awaited<ReturnType<IConfigPresenter['resolveDeepChatAgentConfig']>> | null> {
+    if (typeof this.configPresenter.resolveDeepChatAgentConfig !== 'function') {
+      return {} as Awaited<ReturnType<IConfigPresenter['resolveDeepChatAgentConfig']>>
+    }
+
+    return await this.configPresenter.resolveDeepChatAgentConfig(agentId)
+  }
+
+  private getDefaultProjectPathCompat(): string | null {
+    if (typeof this.configPresenter.getDefaultProjectPath !== 'function') {
+      return null
+    }
+
+    return this.configPresenter.getDefaultProjectPath() ?? null
+  }
+
   private async resolveAssistantModelSelection(
     agentId: string,
     fallbackProviderId: string,
     fallbackModelId: string
   ): Promise<{ providerId: string; modelId: string }> {
     if ((await this.getAgentType(agentId)) === 'deepchat') {
-      const config = await this.configPresenter.resolveDeepChatAgentConfig(agentId)
-      const providerId = config.assistantModel?.providerId?.trim()
-      const modelId = config.assistantModel?.modelId?.trim()
+      const config = await this.resolveDeepChatAgentConfigCompat(agentId)
+      const providerId = config?.assistantModel?.providerId?.trim()
+      const modelId = config?.assistantModel?.modelId?.trim()
       if (providerId && modelId) {
         return {
           providerId,
@@ -1809,9 +1839,7 @@ export class NewAgentPresenter {
       await this.llmProviderPresenter.clearAcpSession(sessionId)
     }
     await agent.destroySession(sessionId)
-    presenter.commandPermissionService.clearConversation(sessionId)
-    presenter.filePermissionService?.clearConversation(sessionId)
-    presenter.settingsPermissionService?.clearConversation(sessionId)
+    this.sessionRuntimePort?.clearSessionPermissions(sessionId)
     await this.skillPresenter?.clearNewAgentSessionSkills?.(sessionId)
     this.sessionManager.delete(sessionId)
   }
diff --git a/src/main/presenter/runtimePorts.ts b/src/main/presenter/runtimePorts.ts
new file mode 100644
index 000000000..133dd251d
--- /dev/null
+++ b/src/main/presenter/runtimePorts.ts
@@ -0,0 +1,37 @@
+type ModelIdentity = {
+  id: string
+  name?: string | null
+}
+
+export type SessionPermissionRequest = {
+  permissionType: 'read' | 'write' | 'all' | 'command'
+  serverName?: string
+  toolName?: string
+  command?: string
+  commandSignature?: string
+  paths?: string[]
+  commandInfo?: {
+    command: string
+    riskLevel: 'low' | 'medium' | 'high' | 'critical'
+    suggestion: string
+    signature?: string
+    baseCommand?: string
+  }
+}
+
+export interface ConfigQueryPort {
+  getProviderModels(providerId: string): ModelIdentity[]
+  getCustomModels(providerId: string): ModelIdentity[]
+  getAgentType(agentId: string): Promise<'deepchat' | 'acp' | null>
+}
+
+export interface SessionRuntimePort {
+  refreshSessionUi(): void
+  clearSessionPermissions(sessionId: string): void
+  approvePermission(sessionId: string, permission: SessionPermissionRequest): Promise<void>
+}
+
+export interface WindowRoutingPort {
+  createSettingsWindow(): Promise<number>
+  sendToWindow(windowId: number, channel: string, ...args: unknown[]): void
+}
diff --git a/src/renderer/src/App.vue b/src/renderer/src/App.vue
index 16c4f6b8d..62187761e 100644
--- a/src/renderer/src/App.vue
+++ b/src/renderer/src/App.vue
@@ -8,7 +8,6 @@ import { useSessionStore } from '@/stores/ui/session'
 import { useAgentStore } from '@/stores/ui/agent'
 import { useDraftStore, type StartDeeplinkPayload } from '@/stores/ui/draft'
 import { usePageRouterStore } from '@/stores/ui/pageRouter'
-import { DEEPLINK_EVENTS, NOTIFICATION_EVENTS, SHORTCUT_EVENTS } from './events'
 import { Toaster } from '@shadcn/components/ui/sonner'
 import { useToast } from '@/components/use-toast'
 import { useUiSettingsStore } from '@/stores/uiSettingsStore'
@@ -28,6 +27,7 @@ import { useDeviceVersion } from '@/composables/useDeviceVersion'
 import WindowSideBar from './components/WindowSideBar.vue'
 import SpotlightOverlay from '@/components/spotlight/SpotlightOverlay.vue'
 import { useSpotlightStore } from '@/stores/ui/spotlight'
+import { useAppIpcRuntime } from '@/composables/useAppIpcRuntime'
 
 const DEV_WELCOME_OVERRIDE_KEY = '__deepchat_dev_force_welcome'
 
@@ -291,9 +291,44 @@ const handleStartDeeplink = (_event: unknown, payload?: Omit<StartDeeplinkPayloa
   void activatePendingStartDeeplink()
 }
 
-if (window?.electron?.ipcRenderer) {
-  window.electron.ipcRenderer.on(DEEPLINK_EVENTS.START, handleStartDeeplink)
-}
+const { setup: setupAppIpcRuntime, cleanup: cleanupAppIpcRuntime } = useAppIpcRuntime({
+  handleStartDeeplink: (event, payload) => {
+    handleStartDeeplink(event, payload as Omit<StartDeeplinkPayload, 'token'> | undefined)
+  },
+  showErrorToast,
+  handleZoomIn,
+  handleZoomOut,
+  handleZoomResume,
+  handleCreateNewConversation,
+  openSpotlight: () => {
+    spotlightStore.openSpotlight()
+  },
+  handleDataResetComplete: () => {
+    toast({
+      title: t('settings.data.resetCompleteDevTitle'),
+      description: t('settings.data.resetCompleteDevMessage'),
+      variant: 'default',
+      duration: 15000
+    })
+  },
+  handleSystemNotificationClick: (msg) => {
+    let sessionId: string | null = null
+
+    if (typeof msg === 'string' && msg.startsWith('chat/')) {
+      const parts = msg.split('/')
+      if (parts.length === 3) {
+        sessionId = parts[1]
+      }
+    } else if (msg && typeof msg === 'object' && 'threadId' in msg) {
+      sessionId = (msg as { threadId?: string }).threadId ?? null
+    }
+
+    if (sessionId) {
+      void sessionStore.selectSession(sessionId)
+    }
+  },
+  getCurrentRouteName: () => router.currentRoute.value.name
+})
 
 // Handle ESC key - close floating chat window
 const handleEscKey = (event: KeyboardEvent) => {
@@ -319,69 +354,7 @@ onMounted(() => {
   // initialize store data
   void initAppStores()
   setupMcpDeeplink()
-
-  // Listen for global error notification events
-  window.electron.ipcRenderer.on(NOTIFICATION_EVENTS.SHOW_ERROR, (_event, error) => {
-    showErrorToast(error)
-  })
-
-  // Listen for shortcut key events
-  window.electron.ipcRenderer.on(SHORTCUT_EVENTS.ZOOM_IN, () => {
-    handleZoomIn()
-  })
-
-  window.electron.ipcRenderer.on(SHORTCUT_EVENTS.ZOOM_OUT, () => {
-    handleZoomOut()
-  })
-
-  window.electron.ipcRenderer.on(SHORTCUT_EVENTS.ZOOM_RESUME, () => {
-    handleZoomResume()
-  })
-
-  window.electron.ipcRenderer.on(SHORTCUT_EVENTS.CREATE_NEW_CONVERSATION, () => {
-    // Check if current route is chat page
-    const currentRoute = router.currentRoute.value
-    if (currentRoute.name !== 'chat') {
-      return
-    }
-    void handleCreateNewConversation()
-  })
-
-  window.electron.ipcRenderer.on(SHORTCUT_EVENTS.TOGGLE_SPOTLIGHT, () => {
-    spotlightStore.openSpotlight()
-  })
-
-  // GO_SETTINGS is now handled in main process (open/focus Settings tab)
-
-  window.electron.ipcRenderer.on(NOTIFICATION_EVENTS.DATA_RESET_COMPLETE_DEV, () => {
-    toast({
-      title: t('settings.data.resetCompleteDevTitle'),
-      description: t('settings.data.resetCompleteDevMessage'),
-      variant: 'default',
-      duration: 15000
-    })
-  })
-
-  window.electron.ipcRenderer.on(NOTIFICATION_EVENTS.SYS_NOTIFY_CLICKED, (_, msg) => {
-    let sessionId: string | null = null
-
-    // Check if msg is string and starts with chat/
-    if (typeof msg === 'string' && msg.startsWith('chat/')) {
-      // Split by /, check if there are three segments
-      const parts = msg.split('/')
-      if (parts.length === 3) {
-        // Extract middle part as sessionId
-        sessionId = parts[1]
-      }
-    } else if (msg && msg.threadId) {
-      // Compatible with original format, if msg is object and contains threadId property
-      sessionId = msg.threadId
-    }
-
-    if (sessionId) {
-      void sessionStore.selectSession(sessionId)
-    }
-  })
+  setupAppIpcRuntime()
 
   watch(
     () => activeTab.value,
@@ -424,17 +397,7 @@ onBeforeUnmount(() => {
   }
 
   window.removeEventListener('keydown', handleEscKey)
-
-  // Remove shortcut key event listeners
-  window.electron.ipcRenderer.removeAllListeners(SHORTCUT_EVENTS.ZOOM_IN)
-  window.electron.ipcRenderer.removeAllListeners(SHORTCUT_EVENTS.ZOOM_OUT)
-  window.electron.ipcRenderer.removeAllListeners(SHORTCUT_EVENTS.ZOOM_RESUME)
-  window.electron.ipcRenderer.removeAllListeners(SHORTCUT_EVENTS.CREATE_NEW_CONVERSATION)
-  window.electron.ipcRenderer.removeAllListeners(SHORTCUT_EVENTS.TOGGLE_SPOTLIGHT)
-  // GO_SETTINGS listener removed; handled in main
-  window.electron.ipcRenderer.removeAllListeners(NOTIFICATION_EVENTS.SYS_NOTIFY_CLICKED)
-  window.electron.ipcRenderer.removeAllListeners(NOTIFICATION_EVENTS.DATA_RESET_COMPLETE_DEV)
-  window.electron.ipcRenderer.removeAllListeners(DEEPLINK_EVENTS.START)
+  cleanupAppIpcRuntime()
   cleanupMcpDeeplink()
 })
 </script>
diff --git a/src/renderer/src/composables/useAppIpcRuntime.ts b/src/renderer/src/composables/useAppIpcRuntime.ts
new file mode 100644
index 000000000..7e0a19c23
--- /dev/null
+++ b/src/renderer/src/composables/useAppIpcRuntime.ts
@@ -0,0 +1,56 @@
+import { DEEPLINK_EVENTS, NOTIFICATION_EVENTS, SHORTCUT_EVENTS } from '@/events'
+import { createIpcSubscriptionScope } from '@/lib/ipcSubscription'
+
+interface UseAppIpcRuntimeOptions {
+  handleStartDeeplink: (event: unknown, payload?: unknown) => void
+  showErrorToast: (error: { id: string; title: string; message: string; type: string }) => void
+  handleZoomIn: () => void
+  handleZoomOut: () => void
+  handleZoomResume: () => void
+  handleCreateNewConversation: () => void | Promise<void>
+  openSpotlight: () => void
+  handleDataResetComplete: () => void
+  handleSystemNotificationClick: (payload: unknown) => void
+  getCurrentRouteName: () => string | symbol | null | undefined
+}
+
+export function useAppIpcRuntime(options: UseAppIpcRuntimeOptions) {
+  let cleanupListeners: (() => void) | null = null
+
+  const setup = () => {
+    cleanupListeners?.()
+    const scope = createIpcSubscriptionScope()
+
+    scope.on(DEEPLINK_EVENTS.START, options.handleStartDeeplink)
+    scope.on(NOTIFICATION_EVENTS.SHOW_ERROR, (_event, error) => {
+      options.showErrorToast(error as { id: string; title: string; message: string; type: string })
+    })
+    scope.on(SHORTCUT_EVENTS.ZOOM_IN, options.handleZoomIn)
+    scope.on(SHORTCUT_EVENTS.ZOOM_OUT, options.handleZoomOut)
+    scope.on(SHORTCUT_EVENTS.ZOOM_RESUME, options.handleZoomResume)
+    scope.on(SHORTCUT_EVENTS.CREATE_NEW_CONVERSATION, () => {
+      if (options.getCurrentRouteName() !== 'chat') {
+        return
+      }
+
+      void options.handleCreateNewConversation()
+    })
+    scope.on(SHORTCUT_EVENTS.TOGGLE_SPOTLIGHT, options.openSpotlight)
+    scope.on(NOTIFICATION_EVENTS.DATA_RESET_COMPLETE_DEV, options.handleDataResetComplete)
+    scope.on(NOTIFICATION_EVENTS.SYS_NOTIFY_CLICKED, (_event, payload) => {
+      options.handleSystemNotificationClick(payload)
+    })
+
+    cleanupListeners = scope.cleanup
+  }
+
+  const cleanup = () => {
+    cleanupListeners?.()
+    cleanupListeners = null
+  }
+
+  return {
+    setup,
+    cleanup
+  }
+}
diff --git a/src/renderer/src/composables/useModelCapabilities.ts b/src/renderer/src/composables/useModelCapabilities.ts
index ca6702b3a..df8255e3b 100644
--- a/src/renderer/src/composables/useModelCapabilities.ts
+++ b/src/renderer/src/composables/useModelCapabilities.ts
@@ -14,6 +14,12 @@ export interface ModelCapabilities {
     max?: number
     default?: number
   } | null
+  supportsSearch: boolean | null
+  searchDefaults: {
+    default?: boolean
+    forced?: boolean
+    strategy?: 'turbo' | 'max'
+  } | null
 }
 
 export interface UseModelCapabilitiesOptions {
@@ -36,12 +42,20 @@ export function useModelCapabilities(options: UseModelCapabilitiesOptions) {
     max?: number
     default?: number
   } | null>(null)
+  const capabilitySupportsSearch = ref<boolean | null>(null)
+  const capabilitySearchDefaults = ref<{
+    default?: boolean
+    forced?: boolean
+    strategy?: 'turbo' | 'max'
+  } | null>(null)
   const isLoading = ref(false)
 
   // === Internal Methods ===
   const resetCapabilities = () => {
     capabilitySupportsReasoning.value = null
     capabilityBudgetRange.value = null
+    capabilitySupportsSearch.value = null
+    capabilitySearchDefaults.value = null
   }
 
   const fetchCapabilities = async () => {
@@ -52,13 +66,17 @@ export function useModelCapabilities(options: UseModelCapabilitiesOptions) {
 
     isLoading.value = true
     try {
-      const [sr, br] = await Promise.all([
+      const [sr, br, ss, sd] = await Promise.all([
         configPresenter.supportsReasoningCapability?.(providerId.value, modelId.value),
-        configPresenter.getThinkingBudgetRange?.(providerId.value, modelId.value)
+        configPresenter.getThinkingBudgetRange?.(providerId.value, modelId.value),
+        configPresenter.supportsSearchCapability?.(providerId.value, modelId.value),
+        configPresenter.getSearchDefaults?.(providerId.value, modelId.value)
       ])
 
       capabilitySupportsReasoning.value = typeof sr === 'boolean' ? sr : null
       capabilityBudgetRange.value = br || {}
+      capabilitySupportsSearch.value = typeof ss === 'boolean' ? ss : null
+      capabilitySearchDefaults.value = sd || {}
     } catch (error) {
       resetCapabilities()
       console.error(error)
@@ -75,6 +93,8 @@ export function useModelCapabilities(options: UseModelCapabilitiesOptions) {
     // Read-only state
     supportsReasoning: capabilitySupportsReasoning,
     budgetRange: capabilityBudgetRange,
+    supportsSearch: capabilitySupportsSearch,
+    searchDefaults: capabilitySearchDefaults,
     isLoading,
     // Methods
     refresh: fetchCapabilities
diff --git a/src/renderer/src/composables/usePresenter.ts b/src/renderer/src/composables/usePresenter.ts
index a8db8fbcb..e8fd67105 100644
--- a/src/renderer/src/composables/usePresenter.ts
+++ b/src/renderer/src/composables/usePresenter.ts
@@ -1,23 +1,10 @@
 import { type IPresenter, type IRemoteControlPresenter } from '@shared/presenter'
 import { toRaw } from 'vue'
-
-// WebContentsId 缓存
-let cachedWebContentsId: number | null = null
+import { getRendererWindowContext } from '@/lib/windowContext'
 
 // 获取当前webContentsId
 export function getWebContentsId(): number | null {
-  if (cachedWebContentsId !== null) {
-    return cachedWebContentsId
-  }
-
-  try {
-    // 通过preload API获取webContentsId
-    cachedWebContentsId = window.api.getWebContentsId()
-    return cachedWebContentsId
-  } catch (error) {
-    console.warn('Failed to get webContentsId:', error)
-    return null
-  }
+  return getRendererWindowContext().webContentsId
 }
 // 安全的序列化函数，避免克隆不可序列化的对象
 function safeSerialize(obj: unknown): unknown {
diff --git a/src/renderer/src/composables/useSearchConfig.ts b/src/renderer/src/composables/useSearchConfig.ts
new file mode 100644
index 000000000..66f9bf26f
--- /dev/null
+++ b/src/renderer/src/composables/useSearchConfig.ts
@@ -0,0 +1,27 @@
+import { computed, type Ref } from 'vue'
+
+interface SearchDefaults {
+  forced?: boolean
+  strategy?: 'turbo' | 'max'
+}
+
+interface UseSearchConfigOptions {
+  supportsSearch: Ref<boolean | null>
+  searchDefaults: Ref<SearchDefaults | null>
+}
+
+export function useSearchConfig(options: UseSearchConfigOptions) {
+  const showSearchConfig = computed(() => options.supportsSearch.value === true)
+  const hasForcedSearchOption = computed(
+    () => showSearchConfig.value && typeof options.searchDefaults.value?.forced === 'boolean'
+  )
+  const hasSearchStrategyOption = computed(
+    () => showSearchConfig.value && typeof options.searchDefaults.value?.strategy === 'string'
+  )
+
+  return {
+    showSearchConfig,
+    hasForcedSearchOption,
+    hasSearchStrategyOption
+  }
+}
diff --git a/src/renderer/src/lib/ipcSubscription.ts b/src/renderer/src/lib/ipcSubscription.ts
new file mode 100644
index 000000000..06f494b5a
--- /dev/null
+++ b/src/renderer/src/lib/ipcSubscription.ts
@@ -0,0 +1,43 @@
+type IpcListener = (...args: any[]) => void
+
+type IpcRegistration = {
+  channel: string
+  listener: IpcListener
+}
+
+function resolveIpcRenderer() {
+  return window?.electron?.ipcRenderer
+}
+
+export function createIpcSubscriptionScope() {
+  const registrations: IpcRegistration[] = []
+
+  const on = (channel: string, listener: IpcListener) => {
+    const ipcRenderer = resolveIpcRenderer()
+    if (!ipcRenderer) {
+      return
+    }
+
+    ipcRenderer.on(channel, listener)
+    registrations.push({ channel, listener })
+  }
+
+  const cleanup = () => {
+    const ipcRenderer = resolveIpcRenderer()
+    if (!ipcRenderer) {
+      registrations.length = 0
+      return
+    }
+
+    for (const registration of registrations.splice(0)) {
+      if (typeof ipcRenderer.removeListener === 'function') {
+        ipcRenderer.removeListener(registration.channel, registration.listener)
+      }
+    }
+  }
+
+  return {
+    on,
+    cleanup
+  }
+}
diff --git a/src/renderer/src/lib/storeInitializer.ts b/src/renderer/src/lib/storeInitializer.ts
index e92b937ff..5e8cff804 100644
--- a/src/renderer/src/lib/storeInitializer.ts
+++ b/src/renderer/src/lib/storeInitializer.ts
@@ -5,6 +5,7 @@ import { useModelStore } from '@/stores/modelStore'
 import { useOllamaStore } from '@/stores/ollamaStore'
 import { useMcpStore } from '@/stores/mcp'
 import { DEEPLINK_EVENTS } from '@/events'
+import { createIpcSubscriptionScope } from '@/lib/ipcSubscription'
 
 export const initAppStores = async () => {
   const uiSettingsStore = useUiSettingsStore()
@@ -26,6 +27,7 @@ export const initAppStores = async () => {
 export const useMcpInstallDeeplinkHandler = () => {
   const router = useRouter()
   const mcpStore = useMcpStore()
+  let cleanupIpcListeners: (() => void) | null = null
 
   const navigateToMcpSettings = async () => {
     await router.isReady()
@@ -78,11 +80,15 @@ export const useMcpInstallDeeplinkHandler = () => {
   }
 
   const setup = () => {
-    window.electron.ipcRenderer.on(DEEPLINK_EVENTS.MCP_INSTALL, handleMcpInstall)
+    cleanupIpcListeners?.()
+    const scope = createIpcSubscriptionScope()
+    scope.on(DEEPLINK_EVENTS.MCP_INSTALL, handleMcpInstall)
+    cleanupIpcListeners = scope.cleanup
   }
 
   const cleanup = () => {
-    window.electron.ipcRenderer.removeAllListeners(DEEPLINK_EVENTS.MCP_INSTALL)
+    cleanupIpcListeners?.()
+    cleanupIpcListeners = null
   }
 
   return { setup, cleanup }
diff --git a/src/renderer/src/lib/windowContext.ts b/src/renderer/src/lib/windowContext.ts
new file mode 100644
index 000000000..af99e5d70
--- /dev/null
+++ b/src/renderer/src/lib/windowContext.ts
@@ -0,0 +1,45 @@
+export interface RendererWindowContext {
+  windowId: number | null
+  webContentsId: number | null
+}
+
+let cachedWindowContext: RendererWindowContext | null = null
+
+function readWindowContext(): RendererWindowContext {
+  if (typeof window === 'undefined' || !window.api) {
+    return {
+      windowId: null,
+      webContentsId: null
+    }
+  }
+
+  try {
+    return {
+      windowId:
+        typeof window.api.getWindowId === 'function' ? (window.api.getWindowId() ?? null) : null,
+      webContentsId:
+        typeof window.api.getWebContentsId === 'function'
+          ? (window.api.getWebContentsId() ?? null)
+          : null
+    }
+  } catch (error) {
+    console.warn('Failed to read renderer window context:', error)
+    return {
+      windowId: null,
+      webContentsId: null
+    }
+  }
+}
+
+export function getRendererWindowContext(): RendererWindowContext {
+  if (cachedWindowContext) {
+    return cachedWindowContext
+  }
+
+  cachedWindowContext = readWindowContext()
+  return cachedWindowContext
+}
+
+export function resetRendererWindowContext(): void {
+  cachedWindowContext = null
+}
diff --git a/src/renderer/src/stores/ui/message.ts b/src/renderer/src/stores/ui/message.ts
index 32b99f29c..f62ff1f01 100644
--- a/src/renderer/src/stores/ui/message.ts
+++ b/src/renderer/src/stores/ui/message.ts
@@ -1,13 +1,14 @@
 import { defineStore } from 'pinia'
-import { ref, computed } from 'vue'
+import { ref, computed, onScopeDispose, getCurrentScope } from 'vue'
 import { usePresenter } from '@/composables/usePresenter'
-import { STREAM_EVENTS } from '@/events'
 import type {
   ChatMessageRecord,
   AssistantMessageBlock,
   MessageFile
 } from '@shared/types/agent-interface'
 import { useSessionStore } from './session'
+import { useStreamStateStore } from './stream'
+import { bindMessageStoreIpc } from './messageIpc'
 
 const EPHEMERAL_STREAM_MESSAGE_PREFIXES = ['__rate_limit__:']
 
@@ -15,14 +16,11 @@ const EPHEMERAL_STREAM_MESSAGE_PREFIXES = ['__rate_limit__:']
 
 export const useMessageStore = defineStore('message', () => {
   const newAgentPresenter = usePresenter('newAgentPresenter')
+  const streamStateStore = useStreamStateStore()
 
   // --- State ---
   const messageIds = ref<string[]>([])
   const messageCache = ref<Map<string, ChatMessageRecord>>(new Map())
-  const isStreaming = ref(false)
-  const streamingBlocks = ref<AssistantMessageBlock[]>([])
-  const currentStreamSessionId = ref<string | null>(null)
-  const currentStreamMessageId = ref<string | null>(null)
   const hydratingStreamMessageIds = new Set<string>()
   let latestLoadRequestId = 0
 
@@ -120,10 +118,7 @@ export const useMessageStore = defineStore('message', () => {
   }
 
   function clearStreamingState(): void {
-    isStreaming.value = false
-    streamingBlocks.value = []
-    currentStreamSessionId.value = null
-    currentStreamMessageId.value = null
+    streamStateStore.clearStreamingState()
   }
 
   function isEphemeralStreamMessageId(messageId: string): boolean {
@@ -170,72 +165,24 @@ export const useMessageStore = defineStore('message', () => {
       })
   }
 
-  // --- Event Listeners ---
-
-  window.electron.ipcRenderer.on(
-    STREAM_EVENTS.RESPONSE,
-    (
-      _: unknown,
-      msg: {
-        conversationId: string
-        blocks: AssistantMessageBlock[]
-        messageId?: string
-        eventId?: string
-      }
-    ) => {
-      const sessionStore = useSessionStore()
-      if (msg.conversationId === sessionStore.activeSessionId) {
-        const streamMessageId = msg.messageId ?? msg.eventId
-        isStreaming.value = true
-        currentStreamSessionId.value = msg.conversationId
-        currentStreamMessageId.value = streamMessageId ?? null
-        streamingBlocks.value = msg.blocks
-        if (streamMessageId && !isEphemeralStreamMessageId(streamMessageId)) {
-          applyStreamingBlocksToMessage(streamMessageId, msg.conversationId, msg.blocks)
-        }
-      }
-    }
-  )
-
-  window.electron.ipcRenderer.on(
-    STREAM_EVENTS.END,
-    (_: unknown, msg: { conversationId: string; messageId?: string; eventId?: string }) => {
-      const sessionStore = useSessionStore()
-      if (msg.conversationId === sessionStore.activeSessionId) {
-        isStreaming.value = false
-        streamingBlocks.value = []
-        currentStreamSessionId.value = null
-        currentStreamMessageId.value = null
-        // Reload messages from DB to get finalized content
-        void loadMessages(msg.conversationId)
-      }
-    }
-  )
-
-  window.electron.ipcRenderer.on(
-    STREAM_EVENTS.ERROR,
-    (
-      _: unknown,
-      msg: { conversationId: string; error: string; messageId?: string; eventId?: string }
-    ) => {
-      const sessionStore = useSessionStore()
-      if (msg.conversationId === sessionStore.activeSessionId) {
-        isStreaming.value = false
-        streamingBlocks.value = []
-        currentStreamSessionId.value = null
-        currentStreamMessageId.value = null
-        // Reload messages from DB to get error state
-        void loadMessages(msg.conversationId)
-      }
-    }
-  )
+  const cleanupIpcBindings = bindMessageStoreIpc({
+    getActiveSessionId: () => useSessionStore().activeSessionId,
+    setStreamingState: ({ sessionId, messageId, blocks }) => {
+      streamStateStore.setStream(sessionId, blocks, messageId)
+    },
+    clearStreamingState,
+    loadMessages,
+    applyStreamingBlocksToMessage,
+    isEphemeralStreamMessageId
+  })
+  registerStoreCleanup(cleanupIpcBindings)
 
   return {
     messageIds,
     messageCache,
-    isStreaming,
-    streamingBlocks,
-    currentStreamMessageId,
+    isStreaming: streamStateStore.isStreaming,
+    streamingBlocks: streamStateStore.streamingBlocks,
+    currentStreamMessageId: streamStateStore.currentStreamMessageId,
     messages,
     loadMessages,
     getMessage,
@@ -244,3 +191,8 @@ export const useMessageStore = defineStore('message', () => {
     clear
   }
 })
+const registerStoreCleanup = (cleanup: () => void) => {
+  if (getCurrentScope()) {
+    onScopeDispose(cleanup)
+  }
+}
diff --git a/src/renderer/src/stores/ui/messageIpc.ts b/src/renderer/src/stores/ui/messageIpc.ts
new file mode 100644
index 000000000..0500b8f3a
--- /dev/null
+++ b/src/renderer/src/stores/ui/messageIpc.ts
@@ -0,0 +1,84 @@
+import { STREAM_EVENTS } from '@/events'
+import type { AssistantMessageBlock } from '@shared/types/agent-interface'
+import { createIpcSubscriptionScope } from '@/lib/ipcSubscription'
+
+interface BindMessageStoreIpcOptions {
+  getActiveSessionId: () => string | null
+  setStreamingState: (payload: {
+    sessionId: string
+    messageId?: string
+    blocks: AssistantMessageBlock[]
+  }) => void
+  clearStreamingState: () => void
+  loadMessages: (sessionId: string) => void | Promise<void>
+  applyStreamingBlocksToMessage: (
+    messageId: string,
+    sessionId: string,
+    blocks: AssistantMessageBlock[]
+  ) => void
+  isEphemeralStreamMessageId: (messageId: string) => boolean
+}
+
+export function bindMessageStoreIpc(options: BindMessageStoreIpcOptions): () => void {
+  const scope = createIpcSubscriptionScope()
+
+  scope.on(
+    STREAM_EVENTS.RESPONSE,
+    (
+      _event,
+      payload: {
+        conversationId: string
+        blocks: AssistantMessageBlock[]
+        messageId?: string
+        eventId?: string
+      }
+    ) => {
+      if (payload?.conversationId !== options.getActiveSessionId()) {
+        return
+      }
+
+      const streamMessageId = payload.messageId ?? payload.eventId
+      options.setStreamingState({
+        sessionId: payload.conversationId,
+        messageId: streamMessageId,
+        blocks: payload.blocks
+      })
+
+      if (streamMessageId && !options.isEphemeralStreamMessageId(streamMessageId)) {
+        options.applyStreamingBlocksToMessage(
+          streamMessageId,
+          payload.conversationId,
+          payload.blocks
+        )
+      }
+    }
+  )
+
+  const clearAndReload = (payload: { conversationId: string }) => {
+    if (payload?.conversationId !== options.getActiveSessionId()) {
+      return
+    }
+
+    options.clearStreamingState()
+    void options.loadMessages(payload.conversationId)
+  }
+
+  scope.on(
+    STREAM_EVENTS.END,
+    (_event, payload: { conversationId: string; messageId?: string; eventId?: string }) => {
+      clearAndReload(payload)
+    }
+  )
+
+  scope.on(
+    STREAM_EVENTS.ERROR,
+    (
+      _event,
+      payload: { conversationId: string; error: string; messageId?: string; eventId?: string }
+    ) => {
+      clearAndReload(payload)
+    }
+  )
+
+  return scope.cleanup
+}
diff --git a/src/renderer/src/stores/ui/session.ts b/src/renderer/src/stores/ui/session.ts
index e28f60245..5a22c8efa 100644
--- a/src/renderer/src/stores/ui/session.ts
+++ b/src/renderer/src/stores/ui/session.ts
@@ -1,8 +1,7 @@
 import { defineStore } from 'pinia'
-import { ref, computed } from 'vue'
+import { ref, computed, onScopeDispose, getCurrentScope } from 'vue'
 import type { ComputedRef } from 'vue'
 import { usePresenter } from '@/composables/usePresenter'
-import { SESSION_EVENTS } from '@/events'
 import type {
   DeepChatSubagentMeta,
   SessionWithState,
@@ -13,6 +12,8 @@ import type {
 import { downloadBlob } from '@/lib/download'
 import { usePageRouterStore } from './pageRouter'
 import { useMessageStore } from './message'
+import { bindSessionStoreIpc } from './sessionIpc'
+import { getRendererWindowContext } from '@/lib/windowContext'
 
 // --- Type Definitions ---
 
@@ -79,6 +80,20 @@ function mapToUISession(session: SessionWithState): UISession {
   }
 }
 
+function isRegularSession(session: Pick<UISession, 'sessionKind'>): boolean {
+  return (session.sessionKind ?? 'regular') === 'regular'
+}
+
+function getCurrentWebContentsId(): number {
+  return getRendererWindowContext().webContentsId ?? -1
+}
+
+function registerStoreCleanup(cleanup: () => void): void {
+  if (getCurrentScope()) {
+    onScopeDispose(cleanup)
+  }
+}
+
 function startOfDay(timestamp: number): number {
   const d = new Date(timestamp)
   d.setHours(0, 0, 0, 0)
@@ -146,7 +161,7 @@ export const useSessionStore = defineStore('session', () => {
   const tabPresenter = usePresenter('tabPresenter')
   const pageRouter = usePageRouterStore()
   const messageStore = useMessageStore()
-  const myWebContentsId = window.api.getWebContentsId()
+  const myWebContentsId = getCurrentWebContentsId()
   let rendererReadyNotified = false
 
   // --- State ---
@@ -179,7 +194,7 @@ export const useSessionStore = defineStore('session', () => {
     loading.value = true
     error.value = null
     try {
-      const webContentsId = window.api.getWebContentsId()
+      const webContentsId = getCurrentWebContentsId()
       const previousActiveSessionId = activeSessionId.value
       const [result, activeSession] = await Promise.all([
         newAgentPresenter.getSessionList({ includeSubagents: true }),
@@ -207,7 +222,7 @@ export const useSessionStore = defineStore('session', () => {
   async function createSession(input: CreateSessionInput): Promise<void> {
     error.value = null
     try {
-      const webContentsId = window.api.getWebContentsId()
+      const webContentsId = getCurrentWebContentsId()
       const session = await newAgentPresenter.createSession(input, webContentsId)
       activeSessionId.value = session.id
 
@@ -224,7 +239,7 @@ export const useSessionStore = defineStore('session', () => {
       if (activeSessionId.value && activeSessionId.value !== sessionId) {
         messageStore.clearStreamingState()
       }
-      const webContentsId = window.api.getWebContentsId()
+      const webContentsId = getCurrentWebContentsId()
       await newAgentPresenter.activateSession(webContentsId, sessionId)
       activeSessionId.value = sessionId
       pageRouter.goToChat(sessionId)
@@ -237,7 +252,7 @@ export const useSessionStore = defineStore('session', () => {
     error.value = null
     try {
       messageStore.clearStreamingState()
-      const webContentsId = window.api.getWebContentsId()
+      const webContentsId = getCurrentWebContentsId()
       await newAgentPresenter.deactivateSession(webContentsId)
       activeSessionId.value = null
       pageRouter.goToNewThread()
@@ -373,9 +388,7 @@ export const useSessionStore = defineStore('session', () => {
 
   function getPinnedSessions(agentId: string | null): UISession[] {
     const pinned = sessions.value
-      .filter(
-        (session) => session.sessionKind === 'regular' && session.isPinned && !session.isDraft
-      )
+      .filter((session) => isRegularSession(session) && session.isPinned && !session.isDraft)
       .sort((a, b) => b.updatedAt - a.updatedAt)
 
     if (agentId === null) return pinned
@@ -385,7 +398,7 @@ export const useSessionStore = defineStore('session', () => {
 
   function getFilteredGroups(agentId: string | null): SessionGroup[] {
     const visibleSessions = sessions.value.filter(
-      (session) => session.sessionKind === 'regular' && !session.isDraft && !session.isPinned
+      (session) => isRegularSession(session) && !session.isDraft && !session.isPinned
     )
     const grouped =
       groupMode.value === 'time' ? groupByTime(visibleSessions) : groupByProject(visibleSessions)
@@ -401,46 +414,30 @@ export const useSessionStore = defineStore('session', () => {
       .filter((group) => group.sessions.length > 0)
   }
 
-  // --- Event Listeners ---
-
-  window.electron.ipcRenderer.on(SESSION_EVENTS.LIST_UPDATED, () => {
-    fetchSessions()
-  })
-
-  window.electron.ipcRenderer.on(
-    SESSION_EVENTS.ACTIVATED,
-    (_: unknown, msg: { webContentsId: number; sessionId: string }) => {
-      if (msg.webContentsId === myWebContentsId) {
-        if (activeSessionId.value && activeSessionId.value !== msg.sessionId) {
-          messageStore.clearStreamingState()
-        }
-        activeSessionId.value = msg.sessionId
-        pageRouter.goToChat(msg.sessionId)
-        void tabPresenter.onRendererTabActivated(msg.sessionId)
-      }
-    }
-  )
-
-  window.electron.ipcRenderer.on(
-    SESSION_EVENTS.DEACTIVATED,
-    (_: unknown, msg: { webContentsId: number }) => {
-      if (msg.webContentsId === myWebContentsId) {
+  const cleanupIpcBindings = bindSessionStoreIpc({
+    webContentsId: myWebContentsId,
+    fetchSessions,
+    onActivated: (sessionId) => {
+      if (activeSessionId.value && activeSessionId.value !== sessionId) {
         messageStore.clearStreamingState()
-        activeSessionId.value = null
-        pageRouter.goToNewThread()
       }
-    }
-  )
-
-  window.electron.ipcRenderer.on(
-    SESSION_EVENTS.STATUS_CHANGED,
-    (_: unknown, msg: { sessionId: string; status: string }) => {
-      const session = sessions.value.find((s) => s.id === msg.sessionId)
+      activeSessionId.value = sessionId
+      pageRouter.goToChat(sessionId)
+      void tabPresenter.onRendererTabActivated(sessionId)
+    },
+    onDeactivated: () => {
+      messageStore.clearStreamingState()
+      activeSessionId.value = null
+      pageRouter.goToNewThread()
+    },
+    onStatusChanged: (payload) => {
+      const session = sessions.value.find((item) => item.id === payload.sessionId)
       if (session) {
-        session.status = mapSessionStatus(msg.status)
+        session.status = mapSessionStatus(payload.status)
       }
     }
-  )
+  })
+  registerStoreCleanup(cleanupIpcBindings)
 
   return {
     sessions,
diff --git a/src/renderer/src/stores/ui/sessionIpc.ts b/src/renderer/src/stores/ui/sessionIpc.ts
new file mode 100644
index 000000000..5e58f981a
--- /dev/null
+++ b/src/renderer/src/stores/ui/sessionIpc.ts
@@ -0,0 +1,46 @@
+import { SESSION_EVENTS } from '@/events'
+import { createIpcSubscriptionScope } from '@/lib/ipcSubscription'
+
+interface BindSessionStoreIpcOptions {
+  webContentsId: number | null
+  fetchSessions: () => void | Promise<void>
+  onActivated: (sessionId: string) => void
+  onDeactivated: () => void
+  onStatusChanged: (payload: { sessionId: string; status: string }) => void
+}
+
+export function bindSessionStoreIpc(options: BindSessionStoreIpcOptions): () => void {
+  const scope = createIpcSubscriptionScope()
+
+  scope.on(SESSION_EVENTS.LIST_UPDATED, () => {
+    void options.fetchSessions()
+  })
+
+  scope.on(
+    SESSION_EVENTS.ACTIVATED,
+    (_event, payload: { webContentsId: number; sessionId: string }) => {
+      if (payload?.webContentsId !== options.webContentsId) {
+        return
+      }
+
+      options.onActivated(payload.sessionId)
+    }
+  )
+
+  scope.on(SESSION_EVENTS.DEACTIVATED, (_event, payload: { webContentsId: number }) => {
+    if (payload?.webContentsId !== options.webContentsId) {
+      return
+    }
+
+    options.onDeactivated()
+  })
+
+  scope.on(
+    SESSION_EVENTS.STATUS_CHANGED,
+    (_event, payload: { sessionId: string; status: string }) => {
+      options.onStatusChanged(payload)
+    }
+  )
+
+  return scope.cleanup
+}
diff --git a/src/renderer/src/stores/ui/stream.ts b/src/renderer/src/stores/ui/stream.ts
new file mode 100644
index 000000000..ecf0f1521
--- /dev/null
+++ b/src/renderer/src/stores/ui/stream.ts
@@ -0,0 +1,33 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import type { AssistantMessageBlock } from '@shared/types/agent-interface'
+
+export const useStreamStateStore = defineStore('streamState', () => {
+  const isStreaming = ref(false)
+  const streamingBlocks = ref<AssistantMessageBlock[]>([])
+  const currentStreamSessionId = ref<string | null>(null)
+  const currentStreamMessageId = ref<string | null>(null)
+
+  function setStream(sessionId: string, blocks: AssistantMessageBlock[], messageId?: string): void {
+    isStreaming.value = true
+    currentStreamSessionId.value = sessionId
+    currentStreamMessageId.value = messageId ?? null
+    streamingBlocks.value = blocks
+  }
+
+  function clearStreamingState(): void {
+    isStreaming.value = false
+    streamingBlocks.value = []
+    currentStreamSessionId.value = null
+    currentStreamMessageId.value = null
+  }
+
+  return {
+    isStreaming,
+    streamingBlocks,
+    currentStreamSessionId,
+    currentStreamMessageId,
+    setStream,
+    clearStreamingState
+  }
+})

From 374129d4b3980f8cf865563a8f823ccfb18c084e Mon Sep 17 00:00:00 2001
From: zerob13 <zerob13@gmail.com>
Date: Fri, 3 Apr 2026 21:09:52 +0800
Subject: [PATCH 2/3] refactor(presenter): rename agent presenters

---
 docs/ARCHITECTURE.md                          | 20 ++---
 docs/FLOWS.md                                 | 30 +++----
 docs/README.md                                |  6 +-
 docs/architecture/agent-system.md             | 38 ++++-----
 .../baselines/dependency-report.md            |  6 +-
 .../baselines/test-failure-groups.md          |  4 +-
 docs/architecture/session-management.md       | 18 ++---
 docs/architecture/tool-system.md              |  8 +-
 .../legacy-agentpresenter-architecture.md     |  2 +-
 docs/archives/legacy-agentpresenter-flows.md  |  2 +-
 docs/guides/code-navigation.md                | 46 +++++------
 docs/guides/getting-started.md                | 20 ++---
 docs/specs/acp-session-config-options/plan.md |  4 +-
 docs/specs/acp-session-config-options/spec.md |  2 +-
 .../specs/acp-session-config-options/tasks.md |  4 +-
 docs/specs/agent-cleanup/spec.md              |  6 +-
 docs/specs/agent-cleanup/tasks.md             |  2 +-
 docs/specs/agent-db-legacy-import/plan.md     |  8 +-
 docs/specs/agent-db-legacy-import/spec.md     |  2 +-
 .../specs/agent-input-advanced-config/plan.md |  8 +-
 .../agent-input-advanced-config/tasks.md      |  8 +-
 .../gap-analysis.md                           | 76 +++++++++---------
 .../agentpresenter-mvp-replacement/plan.md    | 14 ++--
 .../agentpresenter-mvp-replacement/spec.md    | 10 +--
 .../agentpresenter-mvp-replacement/tasks.md   | 32 ++++----
 docs/specs/app-spotlight-search/plan.md       |  2 +-
 docs/specs/app-spotlight-search/tasks.md      |  2 +-
 .../specs/architecture-simplification/plan.md |  2 +-
 .../specs/architecture-simplification/spec.md |  4 +-
 .../architecture-simplification/tasks.md      |  4 +-
 docs/specs/floating-agent-widget/plan.md      | 10 +--
 .../legacy-agentpresenter-retirement/spec.md  |  2 +-
 docs/specs/message-toolbar-actions/plan.md    |  4 +-
 docs/specs/message-toolbar-actions/spec.md    |  6 +-
 docs/specs/message-toolbar-actions/tasks.md   |  6 +-
 docs/specs/message-trace-storage/plan.md      |  4 +-
 docs/specs/message-trace-storage/tasks.md     |  4 +-
 docs/specs/new-agent/plan.md                  | 40 +++++-----
 docs/specs/new-agent/spec.md                  | 32 ++++----
 docs/specs/new-agent/tasks.md                 | 44 +++++-----
 docs/specs/new-agent/v2-spec.md               |  2 +-
 docs/specs/new-agent/v3-spec.md               |  2 +-
 docs/specs/remote-tool-interactions/plan.md   |  4 +-
 docs/specs/settings-dashboard/plan.md         |  2 +-
 docs/specs/settings-dashboard/tasks.md        |  2 +-
 docs/specs/subagent-orchestrator/plan.md      | 14 ++--
 docs/specs/subagent-orchestrator/spec.md      |  2 +-
 docs/specs/subagent-orchestrator/tasks.md     |  6 +-
 docs/specs/telegram-remote-control/plan.md    | 10 +--
 docs/specs/telegram-remote-control/tasks.md   |  2 +-
 docs/specs/tool-output-guardrails/plan.md     |  2 +-
 scripts/agent-cleanup-guard.mjs               | 10 +--
 scripts/architecture-guard.mjs                |  4 +-
 .../accumulator.ts                            |  0
 .../compactionService.ts                      |  0
 .../contextBuilder.ts                         |  0
 .../dispatch.ts                               |  0
 .../echo.ts                                   |  0
 .../index.ts                                  |  2 +-
 .../internalSessionEvents.ts                  |  0
 .../messageStore.ts                           |  0
 .../messageTracePayload.ts                    |  0
 .../pendingInputCoordinator.ts                |  0
 .../pendingInputStore.ts                      |  0
 .../process.ts                                |  0
 .../sessionStore.ts                           |  0
 .../toolOutputGuard.ts                        |  0
 .../types.ts                                  |  0
 .../agentRegistry.ts                          |  0
 .../index.ts                                  | 41 +++++-----
 .../legacyImportService.ts                    |  0
 .../messageManager.ts                         |  0
 .../sessionManager.ts                         |  0
 .../floatingButtonPresenter/index.ts          | 12 +--
 src/main/presenter/index.ts                   | 60 +++++++-------
 .../hooks/after-start/legacyImportHook.ts     |  6 +-
 .../hooks/after-start/rtkHealthCheckHook.ts   |  6 +-
 .../after-start/usageStatsBackfillHook.ts     |  6 +-
 .../conversationSearchServer.ts               |  4 +-
 .../presenter/mcpPresenter/toolManager.ts     |  2 +-
 .../presenter/remoteControlPresenter/index.ts |  4 +-
 .../remoteControlPresenter/interface.ts       |  8 +-
 .../services/remoteConversationRunner.ts      | 52 ++++++------
 src/main/presenter/sqlitePresenter/index.ts   |  2 +-
 .../presenter/toolPresenter/runtimePorts.ts   |  2 +-
 .../settings/components/DashboardSettings.vue |  6 +-
 .../settings/components/RemoteSettings.vue    |  4 +-
 .../components/chat-input/McpIndicator.vue    |  6 +-
 .../src/components/chat/ChatStatusBar.vue     | 18 +++--
 .../chat/composables/useChatInputMentions.ts  |  4 +-
 .../components/markdown/MarkdownRenderer.vue  |  6 +-
 .../message/MessageBlockContent.vue           |  4 +-
 .../src/components/popup/TranslatePopup.vue   |  4 +-
 .../src/components/trace/TraceDialog.vue      |  4 +-
 src/renderer/src/pages/ChatPage.vue           | 16 ++--
 src/renderer/src/pages/NewThreadPage.vue      |  4 +-
 src/renderer/src/stores/ui/agent.ts           |  4 +-
 src/renderer/src/stores/ui/message.ts         |  8 +-
 src/renderer/src/stores/ui/pageRouter.ts      | 10 +--
 src/renderer/src/stores/ui/pendingInput.ts    | 16 ++--
 src/renderer/src/stores/ui/session.ts         | 28 +++----
 src/renderer/src/stores/ui/spotlight.ts       |  4 +-
 ...nter.d.ts => agent-session.presenter.d.ts} |  2 +-
 src/shared/types/presenters/index.d.ts        |  4 +-
 .../types/presenters/legacy.presenters.d.ts   |  4 +-
 .../accumulator.test.ts                       |  6 +-
 .../agentRuntimePresenter.test.ts}            | 61 ++++++++++----
 .../compactionService.test.ts                 | 10 +--
 .../contextBuilder.test.ts                    |  2 +-
 .../dispatch.test.ts                          | 12 +--
 .../echo.test.ts                              |  6 +-
 .../internalSessionEvents.test.ts             |  2 +-
 .../messageStore.test.ts                      |  2 +-
 .../messageTracePayload.test.ts               |  2 +-
 .../pendingInputStore.test.ts                 |  2 +-
 .../process.test.ts                           |  6 +-
 .../agentRegistry.test.ts                     |  2 +-
 .../agentSessionPresenter.test.ts}            | 16 ++--
 .../integration.test.ts                       | 28 +++----
 .../legacyImportService.test.ts               |  2 +-
 .../messageManager.test.ts                    |  6 +-
 .../sessionManager.test.ts                    |  2 +-
 .../usageDashboard.test.ts                    |  8 +-
 .../floatingButtonPresenter/index.test.ts     |  2 +-
 .../mcpPresenter/toolManager.test.ts          | 14 ++--
 .../remoteControlPresenter.test.ts            | 24 +++---
 .../remoteConversationRunner.test.ts          | 80 +++++++++----------
 .../subagentOrchestratorTool.test.ts          |  2 +-
 test/renderer/components/ChatPage.test.ts     |  4 +-
 .../renderer/components/ChatStatusBar.test.ts | 62 +++++++-------
 test/renderer/components/McpIndicator.test.ts | 24 +++---
 .../renderer/components/NewThreadPage.test.ts | 14 ++--
 .../components/RemoteSettings.test.ts         |  6 +-
 .../renderer/composables/usePresenter.test.ts |  2 +-
 test/renderer/pages/NewThreadPage.test.ts     |  4 +-
 test/renderer/stores/messageStore.test.ts     | 22 ++---
 test/renderer/stores/pageRouter.test.ts       | 34 ++++----
 .../renderer/stores/pendingInputStore.test.ts | 14 ++--
 test/renderer/stores/sessionStore.test.ts     | 32 ++++----
 test/renderer/stores/spotlight.test.ts        |  6 +-
 140 files changed, 766 insertions(+), 722 deletions(-)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/accumulator.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/compactionService.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/contextBuilder.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/dispatch.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/echo.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/index.ts (99%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/internalSessionEvents.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/messageStore.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/messageTracePayload.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/pendingInputCoordinator.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/pendingInputStore.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/process.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/sessionStore.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/toolOutputGuard.ts (100%)
 rename src/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/types.ts (100%)
 rename src/main/presenter/{newAgentPresenter => agentSessionPresenter}/agentRegistry.ts (100%)
 rename src/main/presenter/{newAgentPresenter => agentSessionPresenter}/index.ts (98%)
 rename src/main/presenter/{newAgentPresenter => agentSessionPresenter}/legacyImportService.ts (100%)
 rename src/main/presenter/{newAgentPresenter => agentSessionPresenter}/messageManager.ts (100%)
 rename src/main/presenter/{newAgentPresenter => agentSessionPresenter}/sessionManager.ts (100%)
 rename src/shared/types/presenters/{new-agent.presenter.d.ts => agent-session.presenter.d.ts} (99%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/accumulator.test.ts (97%)
 rename test/main/presenter/{deepchatAgentPresenter/deepchatAgentPresenter.test.ts => agentRuntimePresenter/agentRuntimePresenter.test.ts} (98%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/compactionService.test.ts (97%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/contextBuilder.test.ts (99%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/dispatch.test.ts (99%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/echo.test.ts (93%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/internalSessionEvents.test.ts (97%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/messageStore.test.ts (99%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/messageTracePayload.test.ts (97%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/pendingInputStore.test.ts (97%)
 rename test/main/presenter/{deepchatAgentPresenter => agentRuntimePresenter}/process.test.ts (99%)
 rename test/main/presenter/{newAgentPresenter => agentSessionPresenter}/agentRegistry.test.ts (96%)
 rename test/main/presenter/{newAgentPresenter/newAgentPresenter.test.ts => agentSessionPresenter/agentSessionPresenter.test.ts} (98%)
 rename test/main/presenter/{newAgentPresenter => agentSessionPresenter}/integration.test.ts (98%)
 rename test/main/presenter/{newAgentPresenter => agentSessionPresenter}/legacyImportService.test.ts (98%)
 rename test/main/presenter/{newAgentPresenter => agentSessionPresenter}/messageManager.test.ts (91%)
 rename test/main/presenter/{newAgentPresenter => agentSessionPresenter}/sessionManager.test.ts (98%)
 rename test/main/presenter/{newAgentPresenter => agentSessionPresenter}/usageDashboard.test.ts (98%)

diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index bdc6198f4..a69af7b1c 100644
--- a/docs/ARCHITECTURE.md
+++ b/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 主聊天入口
diff --git a/docs/FLOWS.md b/docs/FLOWS.md
index 331399129..6b81c206b 100644
--- a/docs/FLOWS.md
+++ b/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`
diff --git a/docs/README.md b/docs/README.md
index d6ac77005..c4bf30e04 100644
--- a/docs/README.md
+++ b/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) | 当前代码导航入口 |
diff --git a/docs/architecture/agent-system.md b/docs/architecture/agent-system.md
index b9b74f111..48422d0e3 100644
--- a/docs/architecture/agent-system.md
+++ b/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`
 
 ## 历史说明
diff --git a/docs/architecture/baselines/dependency-report.md b/docs/architecture/baselines/dependency-report.md
index 81d7f8e58..46a2b1137 100644
--- a/docs/architecture/baselines/dependency-report.md
+++ b/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
diff --git a/docs/architecture/baselines/test-failure-groups.md b/docs/architecture/baselines/test-failure-groups.md
index eb5861c4c..0ef19eaaf 100644
--- a/docs/architecture/baselines/test-failure-groups.md
+++ b/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`
   - 测试存在，但实现文件缺失。
diff --git a/docs/architecture/session-management.md b/docs/architecture/session-management.md
index c07da96e4..2598678b5 100644
--- a/docs/architecture/session-management.md
+++ b/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` 开始读。
diff --git a/docs/architecture/tool-system.md b/docs/architecture/tool-system.md
index f5d05846a..e6730f2e1 100644
--- a/docs/architecture/tool-system.md
+++ b/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` 会话上下文桥接
 
 权限能力拆分：
 
diff --git a/docs/archives/legacy-agentpresenter-architecture.md b/docs/archives/legacy-agentpresenter-architecture.md
index e1d534f5d..fc641c25f 100644
--- a/docs/archives/legacy-agentpresenter-architecture.md
+++ b/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)。
 
 ## 🏗️ 核心组件关系
 
diff --git a/docs/archives/legacy-agentpresenter-flows.md b/docs/archives/legacy-agentpresenter-flows.md
index baf6d0c46..31a44cff7 100644
--- a/docs/archives/legacy-agentpresenter-flows.md
+++ b/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. 发送消息完整流程
 
diff --git a/docs/guides/code-navigation.md b/docs/guides/code-navigation.md
index 08991d61f..2c68751cd 100644
--- a/docs/guides/code-navigation.md
+++ b/docs/guides/code-navigation.md
@@ -7,10 +7,10 @@
 如果你要追主聊天链路，按这个顺序跳：
 
 1. `src/main/presenter/index.ts`
-2. `src/main/presenter/newAgentPresenter/index.ts`
-3. `src/main/presenter/deepchatAgentPresenter/index.ts`
-4. `src/main/presenter/deepchatAgentPresenter/process.ts`
-5. `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
+2. `src/main/presenter/agentSessionPresenter/index.ts`
+3. `src/main/presenter/agentRuntimePresenter/index.ts`
+4. `src/main/presenter/agentRuntimePresenter/process.ts`
+5. `src/main/presenter/agentRuntimePresenter/dispatch.ts`
 
 ## 按功能找代码
 
@@ -18,30 +18,30 @@
 
 | 功能 | 位置 | 备注 |
 | --- | --- | --- |
-| 创建会话 | `src/main/presenter/newAgentPresenter/index.ts` | `createSession()` |
-| ACP draft 会话 | `src/main/presenter/newAgentPresenter/index.ts` | `ensureAcpDraftSession()` |
-| session 记录管理 | `src/main/presenter/newAgentPresenter/sessionManager.ts` | `create/get/delete/bindWindow` |
-| agent 注册 | `src/main/presenter/newAgentPresenter/agentRegistry.ts` | `register/resolve` |
+| 创建会话 | `src/main/presenter/agentSessionPresenter/index.ts` | `createSession()` |
+| ACP draft 会话 | `src/main/presenter/agentSessionPresenter/index.ts` | `ensureAcpDraftSession()` |
+| session 记录管理 | `src/main/presenter/agentSessionPresenter/sessionManager.ts` | `create/get/delete/bindWindow` |
+| agent 注册 | `src/main/presenter/agentSessionPresenter/agentRegistry.ts` | `register/resolve` |
 
 ### 消息发送与流式处理
 
 | 功能 | 位置 | 备注 |
 | --- | --- | --- |
-| 发送消息入口 | `src/main/presenter/newAgentPresenter/index.ts` | `sendMessage()` |
-| agent runtime 入口 | `src/main/presenter/deepchatAgentPresenter/index.ts` | `processMessage()` |
-| 主循环 | `src/main/presenter/deepchatAgentPresenter/process.ts` | stream + tool loop |
-| 工具调度 | `src/main/presenter/deepchatAgentPresenter/dispatch.ts` | tool call / paused interaction |
-| 上下文构建 | `src/main/presenter/deepchatAgentPresenter/contextBuilder.ts` | history fitting / resume context |
-| 流式 echo | `src/main/presenter/deepchatAgentPresenter/echo.ts` | renderer 增量回显 |
+| 发送消息入口 | `src/main/presenter/agentSessionPresenter/index.ts` | `sendMessage()` |
+| agent runtime 入口 | `src/main/presenter/agentRuntimePresenter/index.ts` | `processMessage()` |
+| 主循环 | `src/main/presenter/agentRuntimePresenter/process.ts` | stream + tool loop |
+| 工具调度 | `src/main/presenter/agentRuntimePresenter/dispatch.ts` | tool call / paused interaction |
+| 上下文构建 | `src/main/presenter/agentRuntimePresenter/contextBuilder.ts` | history fitting / resume context |
+| 流式 echo | `src/main/presenter/agentRuntimePresenter/echo.ts` | renderer 增量回显 |
 
 ### 消息与状态持久化
 
 | 功能 | 位置 | 备注 |
 | --- | --- | --- |
-| runtime session state | `src/main/presenter/deepchatAgentPresenter/sessionStore.ts` | provider/model/permission/status |
-| message persistence | `src/main/presenter/deepchatAgentPresenter/messageStore.ts` | assistant/user message write |
-| pending input | `src/main/presenter/deepchatAgentPresenter/pendingInputStore.ts` | 启动后恢复 |
-| compaction | `src/main/presenter/deepchatAgentPresenter/compactionService.ts` | 长上下文摘要 |
+| runtime session state | `src/main/presenter/agentRuntimePresenter/sessionStore.ts` | provider/model/permission/status |
+| message persistence | `src/main/presenter/agentRuntimePresenter/messageStore.ts` | assistant/user message write |
+| pending input | `src/main/presenter/agentRuntimePresenter/pendingInputStore.ts` | 启动后恢复 |
+| compaction | `src/main/presenter/agentRuntimePresenter/compactionService.ts` | 长上下文摘要 |
 
 ### 工具系统
 
@@ -67,7 +67,7 @@
 
 | 功能 | 位置 | 备注 |
 | --- | --- | --- |
-| legacy import | `src/main/presenter/newAgentPresenter/legacyImportService.ts` | 旧数据导入新表 |
+| legacy import | `src/main/presenter/agentSessionPresenter/legacyImportService.ts` | 旧数据导入新表 |
 | legacy 会话兼容 | `src/main/presenter/sessionPresenter/index.ts` | main 内部 compatibility layer |
 | 用户消息格式化 | `src/main/presenter/sessionPresenter/messageFormatter.ts` | exporter 复用 |
 
@@ -77,17 +77,17 @@
 
 ```bash
 rg "createSession\\(" src/main
-rg "processMessage\\(" src/main/presenter/deepchatAgentPresenter
+rg "processMessage\\(" src/main/presenter/agentRuntimePresenter
 rg "callTool\\(" src/main/presenter/toolPresenter
-rg --files src/main/presenter | rg "newAgentPresenter|deepchatAgentPresenter|agentTools|acp"
+rg --files src/main/presenter | rg "agentSessionPresenter|agentRuntimePresenter|agentTools|acp"
 ```
 
 ## 看到这些词时怎么理解
 
 | 词 | 当前含义 |
 | --- | --- |
-| `newAgentPresenter` | renderer 唯一聊天会话入口 |
-| `deepchatAgentPresenter` | 当前聊天 runtime |
+| `agentSessionPresenter` | renderer 唯一聊天会话入口 |
+| `agentRuntimePresenter` | 当前聊天 runtime |
 | `SessionPresenter` | legacy conversation 兼容层，不是主链路 |
 | `agentPresenter` | 已退休；只会出现在 archive 或历史 spec 里 |
 
diff --git a/docs/guides/getting-started.md b/docs/guides/getting-started.md
index f416b5547..53cbaafa7 100644
--- a/docs/guides/getting-started.md
+++ b/docs/guides/getting-started.md
@@ -37,8 +37,8 @@ pnpm test
 
 ```text
 Renderer
-  -> newAgentPresenter
-  -> deepchatAgentPresenter
+  -> agentSessionPresenter
+  -> agentRuntimePresenter
   -> toolPresenter / llmProviderPresenter
 ```
 
@@ -51,8 +51,8 @@ Renderer
 src/
 ├── main/
 │   ├── presenter/
-│   │   ├── newAgentPresenter/        # 当前会话入口
-│   │   ├── deepchatAgentPresenter/   # 当前聊天 runtime
+│   │   ├── agentSessionPresenter/        # 当前会话入口
+│   │   ├── agentRuntimePresenter/   # 当前聊天 runtime
 │   │   ├── toolPresenter/            # 工具路由
 │   │   │   └── agentTools/           # 本地 agent tools
 │   │   ├── llmProviderPresenter/     # provider 管理
@@ -72,8 +72,8 @@ src/
 ## 进入代码的推荐顺序
 
 1. `src/main/presenter/index.ts`
-2. `src/main/presenter/newAgentPresenter/index.ts`
-3. `src/main/presenter/deepchatAgentPresenter/index.ts`
+2. `src/main/presenter/agentSessionPresenter/index.ts`
+3. `src/main/presenter/agentRuntimePresenter/index.ts`
 4. `src/main/presenter/toolPresenter/index.ts`
 5. `src/main/presenter/llmProviderPresenter/index.ts`
 
@@ -83,9 +83,9 @@ src/
 
 优先看：
 
-- `src/main/presenter/newAgentPresenter/index.ts`
-- `src/main/presenter/deepchatAgentPresenter/process.ts`
-- `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
+- `src/main/presenter/agentSessionPresenter/index.ts`
+- `src/main/presenter/agentRuntimePresenter/process.ts`
+- `src/main/presenter/agentRuntimePresenter/dispatch.ts`
 
 ### 添加或修改 agent tool
 
@@ -110,7 +110,7 @@ src/
 
 优先看：
 
-- `src/main/presenter/newAgentPresenter/legacyImportService.ts`
+- `src/main/presenter/agentSessionPresenter/legacyImportService.ts`
 - `src/main/presenter/sessionPresenter/index.ts`
 - `src/main/presenter/exporter/formats/`
 
diff --git a/docs/specs/acp-session-config-options/plan.md b/docs/specs/acp-session-config-options/plan.md
index 07f3037c9..cb625505c 100644
--- a/docs/specs/acp-session-config-options/plan.md
+++ b/docs/specs/acp-session-config-options/plan.md
@@ -82,7 +82,7 @@ UI refinement：
 ### Phase 3：Presenter 与事件
 
 1. `AcpProvider` 增加 process/session config 读写接口
-2. `LLMProviderPresenter` 和 `NewAgentPresenter` 暴露代理方法
+2. `LLMProviderPresenter` 和 `AgentSessionPresenter` 暴露代理方法
 3. 发出 `SESSION_CONFIG_OPTIONS_READY`
 
 ### Phase 4：Renderer 状态栏
@@ -98,7 +98,7 @@ UI refinement：
 1. `AcpContentMapper` 覆盖 `config_option_update`
 2. `AcpProvider.prepareSession` 发出 config-ready 事件
 3. `AcpProvider.setSessionConfigOption` 使用 agent 返回的全量 state 回写缓存
-4. `NewAgentPresenter` 覆盖 ACP session config 读写代理
+4. `AgentSessionPresenter` 覆盖 ACP session config 读写代理
 
 ### 4.2 Renderer
 
diff --git a/docs/specs/acp-session-config-options/spec.md b/docs/specs/acp-session-config-options/spec.md
index 20478b9ff..124c15d10 100644
--- a/docs/specs/acp-session-config-options/spec.md
+++ b/docs/specs/acp-session-config-options/spec.md
@@ -65,7 +65,7 @@
 
 - [ ] 新增 `AcpConfigOption`、`AcpConfigOptionValue`、`AcpConfigState`
 - [ ] `ILlmProviderPresenter` 增加 ACP process/session config 读写接口
-- [ ] `INewAgentPresenter` 增加 ACP session config 读写接口
+- [ ] `IAgentSessionPresenter` 增加 ACP session config 读写接口
 - [ ] 新增 renderer 事件 `ACP_WORKSPACE_EVENTS.SESSION_CONFIG_OPTIONS_READY`
 
 ## 验收标准
diff --git a/docs/specs/acp-session-config-options/tasks.md b/docs/specs/acp-session-config-options/tasks.md
index 95eb0e862..cac639748 100644
--- a/docs/specs/acp-session-config-options/tasks.md
+++ b/docs/specs/acp-session-config-options/tasks.md
@@ -27,7 +27,7 @@
 - [x] `AcpProcessHandle` / `AcpSessionRecord` 缓存统一 config state
 - [x] 新增 `SESSION_CONFIG_OPTIONS_READY` 事件
 - [x] `ILlmProviderPresenter` 增加 ACP process/session config 读写接口
-- [x] `INewAgentPresenter` 增加 ACP session config 读写接口
+- [x] `IAgentSessionPresenter` 增加 ACP session config 读写接口
 
 ## T4 Renderer 状态栏
 
@@ -41,7 +41,7 @@
 
 - [x] 更新 `acpContentMapper.test.ts`
 - [x] 更新 `acpProvider.test.ts`
-- [x] 更新 `newAgentPresenter.test.ts`
+- [x] 更新 `agentSessionPresenter.test.ts`
 - [x] 更新 `ChatStatusBar.test.ts`
 
 ## T6 质量门禁
diff --git a/docs/specs/agent-cleanup/spec.md b/docs/specs/agent-cleanup/spec.md
index 52b80b461..99e78ed53 100644
--- a/docs/specs/agent-cleanup/spec.md
+++ b/docs/specs/agent-cleanup/spec.md
@@ -7,8 +7,8 @@ The cleanup reached final runtime retirement on March 23, 2026.
 Current primary flow:
 
 - renderer active chat pages/stores/components
-- `newAgentPresenter`
-- `deepchatAgentPresenter`
+- `agentSessionPresenter`
+- `agentRuntimePresenter`
 - `toolPresenter`
 - `llmProviderPresenter`
 
@@ -59,7 +59,7 @@ It now protects these invariants:
 
 The remaining work is no longer runtime-retirement work. It is adjacent cleanup only:
 
-- export-only `@shared/chat` coupling in `newAgentPresenter`
+- export-only `@shared/chat` coupling in `agentSessionPresenter`
 - non-active renderer residual import in `PromptEditorSheet`
 - adjacent provider globals such as `devicePresenter` / `oauthPresenter`
 - optional archival/normalization of older specs that still mention retired paths
diff --git a/docs/specs/agent-cleanup/tasks.md b/docs/specs/agent-cleanup/tasks.md
index fd0785884..b2f0b1cb6 100644
--- a/docs/specs/agent-cleanup/tasks.md
+++ b/docs/specs/agent-cleanup/tasks.md
@@ -30,7 +30,7 @@
 
 ## Remaining Backlog
 
-- [ ] remove export-only `@shared/chat` coupling in `src/main/presenter/newAgentPresenter/index.ts`
+- [ ] remove export-only `@shared/chat` coupling in `src/main/presenter/agentSessionPresenter/index.ts`
 - [ ] remove non-active renderer residual import in `PromptEditorSheet`
 - [ ] review adjacent provider globals such as `devicePresenter` / `oauthPresenter`
 - [ ] normalize older historical specs that still mention retired legacy paths
diff --git a/docs/specs/agent-db-legacy-import/plan.md b/docs/specs/agent-db-legacy-import/plan.md
index 3159dc53a..78b9ad031 100644
--- a/docs/specs/agent-db-legacy-import/plan.md
+++ b/docs/specs/agent-db-legacy-import/plan.md
@@ -10,12 +10,12 @@
      - `legacy_import_status`
 
 2. Searchresult migration
-   - `deepchatAgentPresenter/dispatch.ts` 解析 `application/deepchat-webpage`
+   - `agentRuntimePresenter/dispatch.ts` 解析 `application/deepchat-webpage`
    - 同时写入：
      - assistant `search` block
      - `deepchat_message_search_results`
-   - `newAgentPresenter.getSearchResults()` 从新表读取
-   - 前端引用点改为 `newAgentPresenter.getSearchResults()`
+   - `agentSessionPresenter.getSearchResults()` 从新表读取
+   - 前端引用点改为 `agentSessionPresenter.getSearchResults()`
 
 3. Legacy import pipeline
    - 新增 `LegacyChatImportService`
@@ -25,7 +25,7 @@
    - 导入状态与错误写入 `legacy_import_status`
 
 4. Retry and observability
-   - `newAgentPresenter` 暴露：
+   - `agentSessionPresenter` 暴露：
      - `getLegacyImportStatus()`
      - `retryLegacyImport()`
    - 失败后允许手动重试，重复导入保持幂等
diff --git a/docs/specs/agent-db-legacy-import/spec.md b/docs/specs/agent-db-legacy-import/spec.md
index f5845a23b..7c75a6f15 100644
--- a/docs/specs/agent-db-legacy-import/spec.md
+++ b/docs/specs/agent-db-legacy-import/spec.md
@@ -13,7 +13,7 @@
    - `message_attachments(search_result/search_results)` -> `deepchat_message_search_results`
 3. `searchresult` 读写统一走新结构：
    - 新链路写入：tool 结果中的 `application/deepchat-webpage`
-   - 新链路读取：`newAgentPresenter.getSearchResults()`
+   - 新链路读取：`agentSessionPresenter.getSearchResults()`
 4. 导入状态持久化与重试：
    - 新表 `legacy_import_status`
    - IPC：`getLegacyImportStatus` / `retryLegacyImport`
diff --git a/docs/specs/agent-input-advanced-config/plan.md b/docs/specs/agent-input-advanced-config/plan.md
index 76cfceea5..be421ee45 100644
--- a/docs/specs/agent-input-advanced-config/plan.md
+++ b/docs/specs/agent-input-advanced-config/plan.md
@@ -4,7 +4,7 @@
 
 1. 新增 `SessionGenerationSettings`（共享类型）。
 2. `CreateSessionInput` 增加 `generationSettings?: Partial<SessionGenerationSettings>`。
-3. `INewAgentPresenter` 增加：
+3. `IAgentSessionPresenter` 增加：
    - `getSessionGenerationSettings(sessionId)`
    - `updateSessionGenerationSettings(sessionId, settings)`
 4. `IAgentImplementation` 增加可选：
@@ -13,9 +13,9 @@
 
 ## 2. 主进程（newAgent + deepchat）
 
-1. `newAgentPresenter.createSession` 透传 `generationSettings` 到 `agent.initSession`。
-2. `newAgentPresenter` 新增 generation settings 读写代理，保持 permission 相关接口不变。
-3. `deepchatAgentPresenter`：
+1. `agentSessionPresenter.createSession` 透传 `generationSettings` 到 `agent.initSession`。
+2. `agentSessionPresenter` 新增 generation settings 读写代理，保持 permission 相关接口不变。
+3. `agentRuntimePresenter`：
    - `initSession` 构造并持久化会话配置（模型默认 + 默认 system prompt + 覆盖值）。
    - `processMessage` / `resumeAssistantMessage` 读取会话配置构建上下文。
    - `runStreamForMessage` 使用会话 `temperature/maxTokens`，并将
diff --git a/docs/specs/agent-input-advanced-config/tasks.md b/docs/specs/agent-input-advanced-config/tasks.md
index 3331854ba..b4234e46f 100644
--- a/docs/specs/agent-input-advanced-config/tasks.md
+++ b/docs/specs/agent-input-advanced-config/tasks.md
@@ -10,7 +10,7 @@
 
 - [x] 新增 `SessionGenerationSettings`
 - [x] `CreateSessionInput` 增加 `generationSettings`
-- [x] `INewAgentPresenter` 增加 generation settings 读写接口
+- [x] `IAgentSessionPresenter` 增加 generation settings 读写接口
 - [x] `IAgentImplementation` 增加可选 generation settings 读写接口
 
 ## T2 持久化层
@@ -50,10 +50,10 @@
 
 ## T7 测试
 
-- [x] 更新 `deepchatAgentPresenter.test.ts`
-- [x] 更新 `newAgentPresenter.test.ts`
+- [x] 更新 `agentRuntimePresenter.test.ts`
+- [x] 更新 `agentSessionPresenter.test.ts`
 - [x] 更新 `NewThreadPage.test.ts`
-- [x] 更新 `newAgentPresenter/integration.test.ts` 兼容新参数
+- [x] 更新 `agentSessionPresenter/integration.test.ts` 兼容新参数
 
 ## T8 质量门禁
 
diff --git a/docs/specs/agentpresenter-mvp-replacement/gap-analysis.md b/docs/specs/agentpresenter-mvp-replacement/gap-analysis.md
index 08d7882e1..9df5ae5e6 100644
--- a/docs/specs/agentpresenter-mvp-replacement/gap-analysis.md
+++ b/docs/specs/agentpresenter-mvp-replacement/gap-analysis.md
@@ -2,7 +2,7 @@
 
 ## Executive Summary
 
-This document analyzes the functional gaps between the old architecture (`agentPresenter` + `sessionPresenter` + `chatStore`) and the new architecture (`deepchatAgentPresenter` + `newAgentPresenter` + `sessionStore`/`messageStore`).
+This document analyzes the functional gaps between the old architecture (`agentPresenter` + `sessionPresenter` + `chatStore`) and the new architecture (`agentRuntimePresenter` + `agentSessionPresenter` + `sessionStore`/`messageStore`).
 
 **Critical Finding**: The new architecture has successfully implemented the core streaming and message persistence infrastructure, but lacks critical functionality in five key areas:
 
@@ -21,7 +21,7 @@ This document analyzes the functional gaps between the old architecture (`agentP
 ### Current State (New Architecture)
 
 **Implemented:**
-- ✅ Basic session creation via `newAgentPresenter.createSession()`
+- ✅ Basic session creation via `agentSessionPresenter.createSession()`
 - ✅ Model resolution from default settings (`configPresenter.getDefaultModel()`)
 - ✅ Preferred model fallback logic
 - ✅ Project/workspace binding via `projectStore.selectedProject.path`
@@ -29,7 +29,7 @@ This document analyzes the functional gaps between the old architecture (`agentP
 
 **File References:**
 - `src/renderer/src/pages/NewThreadPage.vue` (lines 70-112)
-- `src/main/presenter/newAgentPresenter/index.ts` (lines 24-60)
+- `src/main/presenter/agentSessionPresenter/index.ts` (lines 24-60)
 
 ### Missing Functionality
 
@@ -44,7 +44,7 @@ This document analyzes the functional gaps between the old architecture (`agentP
 
 **New Architecture:**
 - `ChatStatusBar.vue` line 91: Shows "Default permissions" as **read-only button** (no dropdown)
-- `newAgentPresenter` has no `permissionMode` parameter in `createSession()`
+- `agentSessionPresenter` has no `permissionMode` parameter in `createSession()`
 - `new_sessions` table has no `permission_mode` column
 
 **Impact**: Users cannot choose permission level; all sessions default to unknown behavior.
@@ -59,7 +59,7 @@ This document analyzes the functional gaps between the old architecture (`agentP
 
 **New Architecture:**
 - No validation in `NewThreadPage.onSubmit()`
-- No validation in `newAgentPresenter.createSession()`
+- No validation in `agentSessionPresenter.createSession()`
 
 #### 1.3 Default Model Loading from Settings
 
@@ -85,7 +85,7 @@ This document analyzes the functional gaps between the old architecture (`agentP
    - Disable "Full access" if `!projectStore.selectedProject`
    - Show tooltip: "Bind workspace first to enable Full access"
 
-3. **Update newAgentPresenter.createSession():**
+3. **Update agentSessionPresenter.createSession():**
    ```typescript
    async createSession(input: {
      message: string
@@ -104,12 +104,12 @@ This document analyzes the functional gaps between the old architecture (`agentP
 ### Current State (New Architecture)
 
 **Implemented:**
-- ✅ `deepchatAgentPresenter.process.ts` executes tool calls
-- ✅ `deepchatAgentPresenter.dispatch.ts` builds tool conversations
+- ✅ `agentRuntimePresenter.process.ts` executes tool calls
+- ✅ `agentRuntimePresenter.dispatch.ts` builds tool conversations
 
 **File References:**
-- `src/main/presenter/deepchatAgentPresenter/process.ts`
-- `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
+- `src/main/presenter/agentRuntimePresenter/process.ts`
+- `src/main/presenter/agentRuntimePresenter/dispatch.ts`
 
 ### Missing Functionality
 
@@ -152,7 +152,7 @@ New Flow (BROKEN):
 - `handlePermissionResponse()` resumed loop with approved tool calls
 
 **New Architecture:**
-- `deepchatAgentPresenter` has no pause state
+- `agentRuntimePresenter` has no pause state
 - `processStream()` is synchronous - no yield points for user input
 - No IPC method to resume after permission approval
 
@@ -168,7 +168,7 @@ New Flow (BROKEN):
 **New Architecture:**
 - `messageStore` receives `STREAM_EVENTS.RESPONSE` with blocks
 - `MessageList` component unchanged (should still render blocks)
-- **Missing**: No handler to call `newAgentPresenter` permission methods (don't exist yet)
+- **Missing**: No handler to call `agentSessionPresenter` permission methods (don't exist yet)
 
 #### 2.4 Permission Approval Handler
 
@@ -187,8 +187,8 @@ async handlePermissionResponse(
 ```
 
 **New Architecture:**
-- ❌ No `handlePermissionResponse()` in `newAgentPresenter`
-- ❌ No `handlePermissionResponse()` in `deepchatAgentPresenter`
+- ❌ No `handlePermissionResponse()` in `agentSessionPresenter`
+- ❌ No `handlePermissionResponse()` in `agentRuntimePresenter`
 
 #### 2.5 Whitelist Management
 
@@ -260,9 +260,9 @@ NEW ARCHITECTURE (CURRENT - BROKEN):
 
 ### Required Implementation
 
-1. **Add permission checker to deepchatAgentPresenter:**
+1. **Add permission checker to agentRuntimePresenter:**
    ```typescript
-   // deepchatAgentPresenter/index.ts
+   // agentRuntimePresenter/index.ts
    private permissionChecker: PermissionChecker
    
    constructor(..., toolPresenter: IToolPresenter) {
@@ -290,7 +290,7 @@ NEW ARCHITECTURE (CURRENT - BROKEN):
 
 3. **Add IPC methods:**
    ```typescript
-   // newAgentPresenter/index.ts
+   // agentSessionPresenter/index.ts
    async handlePermissionResponse(
      sessionId: string,
      messageId: string,
@@ -315,15 +315,15 @@ NEW ARCHITECTURE (CURRENT - BROKEN):
 **Implemented:**
 - ✅ `NewSessionManager.create()` - creates session records
 - ✅ `NewSessionManager.bindWindow()` - binds session to window
-- ✅ `newAgentPresenter.createSession()` - full creation flow
-- ✅ `newAgentPresenter.activateSession()` - activation
-- ✅ `newAgentPresenter.deactivateSession()` - deactivation
+- ✅ `agentSessionPresenter.createSession()` - full creation flow
+- ✅ `agentSessionPresenter.activateSession()` - activation
+- ✅ `agentSessionPresenter.deactivateSession()` - deactivation
 - ✅ Session status tracking via `runtimeState` Map
 - ✅ Event emission: `SESSION_EVENTS.ACTIVATED`, `DEACTIVATED`, `STATUS_CHANGED`
 
 **File References:**
-- `src/main/presenter/newAgentPresenter/sessionManager.ts`
-- `src/main/presenter/newAgentPresenter/index.ts`
+- `src/main/presenter/agentSessionPresenter/sessionManager.ts`
+- `src/main/presenter/agentSessionPresenter/index.ts`
 - `src/renderer/src/stores/ui/session.ts`
 
 ### Missing Functionality
@@ -345,7 +345,7 @@ settings: {
 
 **New Architecture:**
 ```typescript
-// newAgentPresenter.createSession()
+// agentSessionPresenter.createSession()
 input: {
   message, projectDir, agentId, providerId, modelId
   // MISSING: temperature, contextLength, maxTokens, 
@@ -384,7 +384,7 @@ input: {
 **Notes:**
 - `new_sessions` table stores sessions
 - `sessionStore.fetchSessions()` loads from DB
-- State rebuilt from `deepchatAgentPresenter.getSessionState()`
+- State rebuilt from `agentRuntimePresenter.getSessionState()`
 
 #### 3.5 Session Deletion and Cleanup
 
@@ -464,9 +464,9 @@ createSession → initSession → bindWindow → processMessage → stream
 - ✅ Frontend `messageStore` listens to events and updates `streamingBlocks`
 
 **File References:**
-- `src/main/presenter/deepchatAgentPresenter/process.ts`
-- `src/main/presenter/deepchatAgentPresenter/accumulator.ts`
-- `src/main/presenter/deepchatAgentPresenter/messageStore.ts`
+- `src/main/presenter/agentRuntimePresenter/process.ts`
+- `src/main/presenter/agentRuntimePresenter/accumulator.ts`
+- `src/main/presenter/agentRuntimePresenter/messageStore.ts`
 - `src/renderer/src/stores/ui/message.ts`
 
 ### Missing Functionality
@@ -521,7 +521,7 @@ AssistantMessageBlock:
 **Status**: ✅ Implemented
 
 **Notes:**
-- Session status set to `'generating'` before stream (deepchatAgentPresenter line 101)
+- Session status set to `'generating'` before stream (agentRuntimePresenter line 101)
 - Status set to `'idle'` or `'error'` after completion (lines 167, 175)
 - `SESSION_EVENTS.STATUS_CHANGED` emitted
 - `sessionStore` updates session status
@@ -575,8 +575,8 @@ processMessage → create user message → create assistant message
 - ✅ Error handling for tool failures
 
 **File References:**
-- `src/main/presenter/deepchatAgentPresenter/process.ts`
-- `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
+- `src/main/presenter/agentRuntimePresenter/process.ts`
+- `src/main/presenter/agentRuntimePresenter/dispatch.ts`
 
 ### Missing Functionality
 
@@ -771,7 +771,7 @@ NEW ARCHITECTURE (CURRENT):
 
 2. **Add resume method:**
    ```typescript
-   // deepchatAgentPresenter/index.ts
+   // agentRuntimePresenter/index.ts
    async resumeAfterPermission(
      sessionId: string,
      messageId: string,
@@ -809,7 +809,7 @@ NEW ARCHITECTURE (CURRENT):
    - Pause stream waiting for approval
 
 3. **Permission Response Handler**
-   - Add `handlePermissionResponse()` to newAgentPresenter
+   - Add `handlePermissionResponse()` to agentSessionPresenter
    - Implement resume mechanism after approval
    - Update session status ('paused' → 'generating')
 
@@ -847,7 +847,7 @@ NEW ARCHITECTURE (CURRENT):
 
 10. **Frontend Permission UI**
     - Ensure MessageList renders permission blocks
-    - Connect approve/reject buttons to newAgentPresenter
+    - Connect approve/reject buttons to agentSessionPresenter
     - Add "remember" checkbox
 
 ### P2: Medium (Nice to Have)
@@ -942,11 +942,11 @@ NEW ARCHITECTURE (CURRENT):
 
 | Component | File Path |
 |-----------|-----------|
-| NewAgentPresenter | `src/main/presenter/newAgentPresenter/index.ts` |
-| DeepChatAgentPresenter | `src/main/presenter/deepchatAgentPresenter/index.ts` |
-| ProcessStream | `src/main/presenter/deepchatAgentPresenter/process.ts` |
-| Dispatch | `src/main/presenter/deepchatAgentPresenter/dispatch.ts` |
-| MessageStore | `src/main/presenter/deepchatAgentPresenter/messageStore.ts` |
+| AgentSessionPresenter | `src/main/presenter/agentSessionPresenter/index.ts` |
+| AgentRuntimePresenter | `src/main/presenter/agentRuntimePresenter/index.ts` |
+| ProcessStream | `src/main/presenter/agentRuntimePresenter/process.ts` |
+| Dispatch | `src/main/presenter/agentRuntimePresenter/dispatch.ts` |
+| MessageStore | `src/main/presenter/agentRuntimePresenter/messageStore.ts` |
 | SessionStore (UI) | `src/renderer/src/stores/ui/session.ts` |
 | MessageStore (UI) | `src/renderer/src/stores/ui/message.ts` |
 | NewThreadPage | `src/renderer/src/pages/NewThreadPage.vue` |
diff --git a/docs/specs/agentpresenter-mvp-replacement/plan.md b/docs/specs/agentpresenter-mvp-replacement/plan.md
index 597125e3e..c41dc9d67 100644
--- a/docs/specs/agentpresenter-mvp-replacement/plan.md
+++ b/docs/specs/agentpresenter-mvp-replacement/plan.md
@@ -2,16 +2,16 @@
 
 ## 1. 当前基线（Updated 2026-02-28）
 
-1. 新旧双栈并存：`newAgentPresenter/deepchatAgentPresenter` 与旧 `sessionPresenter/useChatStore` 同时存在。
+1. 新旧双栈并存：`agentSessionPresenter/agentRuntimePresenter` 与旧 `sessionPresenter/useChatStore` 同时存在。
 2. 新 loop 已可运行，**streaming 和 message persistence 已完成**，但**权限流程完全缺失**。
 3. 产品方向已确定：MVP 先替换核心能力，再完成 chat 模式彻底移除。
-4. **关键发现**：`deepchatAgentPresenter/dispatch.ts` 的 `executeTools()` 直接调用工具，**无任何权限检查**。
+4. **关键发现**：`agentRuntimePresenter/dispatch.ts` 的 `executeTools()` 直接调用工具，**无任何权限检查**。
 
 ## 2. 核心架构决策
 
 1. 会话真源：`new_sessions + deepchat_sessions`。
 2. 消息真源：`deepchat_messages`。
-3. 主执行链路：`newAgentPresenter -> deepchatAgentPresenter`。
+3. 主执行链路：`agentSessionPresenter -> agentRuntimePresenter`。
 4. 新 UI 页面不再依赖 `useChatStore` 与旧 `sessionPresenter` 主流程。
 5. variants 本轮下线，fork 保留为唯一分叉能力。
 
@@ -65,7 +65,7 @@
 ### Phase 0：稳定主链路
 
 1. 清理新 UI 对 `useChatStore` 的依赖点。
-2. active session 查询与事件分发统一到 `newAgentPresenter`。
+2. active session 查询与事件分发统一到 `agentSessionPresenter`。
 3. 建立最小回归测试基线。
 
 ### Phase 1：权限 + Workspace（MVP 核心）
@@ -94,7 +94,7 @@
 
 ## 6. IPC 与类型面
 
-1. `INewAgentPresenter` 扩展：
+1. `IAgentSessionPresenter` 扩展：
    - `setSessionPermissionMode`
    - `editUserMessage`
    - `retryAssistantMessage`
@@ -138,9 +138,9 @@
 - ❌ Session configuration: PARTIAL (missing advanced options)
 
 **Immediate Next Steps**:
-1. Create `PermissionChecker` class in `deepchatAgentPresenter/`
+1. Create `PermissionChecker` class in `agentRuntimePresenter/`
 2. Modify `executeTools()` in `dispatch.ts` to check permissions before tool calls
-3. Add `handlePermissionResponse()` IPC method to `newAgentPresenter`
+3. Add `handlePermissionResponse()` IPC method to `agentSessionPresenter`
 4. Update `ChatStatusBar.vue` to show permission mode dropdown
 5. Add `permission_mode` column to `new_sessions` table
 6. Create `permission_whitelists` table for session-scoped whitelists
diff --git a/docs/specs/agentpresenter-mvp-replacement/spec.md b/docs/specs/agentpresenter-mvp-replacement/spec.md
index 7ae21bdd2..e09c7005a 100644
--- a/docs/specs/agentpresenter-mvp-replacement/spec.md
+++ b/docs/specs/agentpresenter-mvp-replacement/spec.md
@@ -2,7 +2,7 @@
 
 ## 概述
 
-以 `deepchatAgentPresenter` 新 loop 为唯一核心，分阶段替换旧 chat 体系。MVP 先完成权限、workspace 绑定、消息编辑、retry/regenerate、fork 五个核心能力，再推进设置收敛与 chat 模式清理。
+以 `agentRuntimePresenter` 新 loop 为唯一核心，分阶段替换旧 chat 体系。MVP 先完成权限、workspace 绑定、消息编辑、retry/regenerate、fork 五个核心能力，再推进设置收敛与 chat 模式清理。
 
 ## 背景与目标
 
@@ -61,8 +61,8 @@
 - [x] 权限判定与消息归属基于同一 `sessionId`。
 
 **Implementation Notes** (added 2026-02-28):
-- `newAgentPresenter.createSession()` already passes `projectDir` to session manager
-- `deepchatAgentPresenter.processStream()` uses `sessionId` throughout
+- `agentSessionPresenter.createSession()` already passes `projectDir` to session manager
+- `agentRuntimePresenter.processStream()` uses `sessionId` throughout
 - CRITICAL GAP: `executeTools()` in dispatch.ts does NOT check permissions before calling tools
 - Must add `PermissionChecker` class and integrate before tool execution
 
@@ -115,7 +115,7 @@
 **Implementation Notes** (added 2026-02-28):
 - PARTIALLY IMPLEMENTED: new architecture uses agent defaults
 - MISSING: session-level configuration (temperature, contextLength, maxTokens)
-- `newAgentPresenter.createSession()` only accepts providerId/modelId
+- `agentSessionPresenter.createSession()` only accepts providerId/modelId
 - Must extend CreateSessionInput to include all config options
 - Old architecture: CONVERSATION_SETTINGS had 12+ fields
 - New architecture: must decide which settings to persist at session level
@@ -123,7 +123,7 @@
 ### G. 架构替换
 
 - [x] 新 UI 主链路不依赖 `useChatStore` 与旧 `sessionPresenter`。
-- [x] `newAgentPresenter + deepchatAgentPresenter` 成为唯一主执行链路。
+- [x] `agentSessionPresenter + agentRuntimePresenter` 成为唯一主执行链路。
 
 **Implementation Notes** (added 2026-02-28):
 - MOSTLY COMPLETE: New UI uses sessionStore/messageStore
diff --git a/docs/specs/agentpresenter-mvp-replacement/tasks.md b/docs/specs/agentpresenter-mvp-replacement/tasks.md
index 8ce4e848a..0a51de678 100644
--- a/docs/specs/agentpresenter-mvp-replacement/tasks.md
+++ b/docs/specs/agentpresenter-mvp-replacement/tasks.md
@@ -16,7 +16,7 @@
   - **SQL**: `ALTER TABLE new_sessions ADD COLUMN permission_mode TEXT DEFAULT 'default'`
   - **File**: `src/main/presenter/sqlitePresenter/tables/newSessionsTable.ts`
 - [ ] session manager 增加读写 `permission_mode` 能力。
-  - **File**: `src/main/presenter/newAgentPresenter/sessionManager.ts`
+  - **File**: `src/main/presenter/agentSessionPresenter/sessionManager.ts`
   - Add `permissionMode` to `create()` method
   - Add getter/setter methods
 - [ ] 补齐迁移与回填策略测试。
@@ -38,7 +38,7 @@
 - [ ] `Full access` 禁用态提示“先绑定 workspace"。
   - Add tooltip on disabled option
 - [ ] 选择结果写回 session 并可恢复。
-  - Call `newAgentPresenter.updateSessionPermissionMode()` (NEW IPC)
+  - Call `agentSessionPresenter.updateSessionPermissionMode()` (NEW IPC)
   - Load on session activation
 
 **Priority**: P0 - MVP Blocker
@@ -49,13 +49,13 @@
 ## T3 Default 权限流程 🔴 P0 CRITICAL
 
 - [ ] 新链路接入权限请求消息块与审批动作。
-  - **File**: `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
+  - **File**: `src/main/presenter/agentRuntimePresenter/dispatch.ts`
   - Modify `executeTools()` to check permissions BEFORE calling tools
   - Create permission request block: `{ type: 'action', action_type: 'tool_call_permission', ... }`
   - Emit `STREAM_EVENTS.RESPONSE` with permission block
   - PAUSE stream processing (set session status to 'paused')
 - [ ] 实现 session 级白名单存储与查询。
-  - **CREATE**: `src/main/presenter/deepchatAgentPresenter/permissionChecker.ts`
+  - **CREATE**: `src/main/presenter/agentRuntimePresenter/permissionChecker.ts`
   - Create `permission_whitelists` table: `{ sessionId, toolName, pathPattern, permissionType, createdAt }`
   - Query: `SELECT * FROM permission_whitelists WHERE sessionId = ? AND toolName = ?`
 - [ ] 白名单匹配规则为 `toolName + pathPattern`。
@@ -71,14 +71,14 @@
 **Status**: NOT STARTED
 **Dependencies**: T1
 **Key Files**:
-- CREATE: `src/main/presenter/deepchatAgentPresenter/permissionChecker.ts`
-- MODIFY: `src/main/presenter/deepchatAgentPresenter/dispatch.ts`
-- MODIFY: `src/main/presenter/newAgentPresenter/index.ts`
+- CREATE: `src/main/presenter/agentRuntimePresenter/permissionChecker.ts`
+- MODIFY: `src/main/presenter/agentRuntimePresenter/dispatch.ts`
+- MODIFY: `src/main/presenter/agentSessionPresenter/index.ts`
 
 ## T4 Full access 边界控制 🔴 P0 CRITICAL
 
 - [ ] 实现自动通过逻辑（仅对 `projectDir` 内操作）。
-  - **File**: `src/main/presenter/deepchatAgentPresenter/permissionChecker.ts`
+  - **File**: `src/main/presenter/agentRuntimePresenter/permissionChecker.ts`
   - Check `session.permission_mode === 'full'`
   - If full access: auto-approve tools within projectDir
 - [ ] 实现路径归一化与越界检测。
@@ -99,9 +99,9 @@
 ## T5 Workspace 与会话绑定 ✅ P0 COMPLETE
 
 - [x] 工具执行上下文绑定 `session.projectDir`。
-  - **Status**: COMPLETE - `newAgentPresenter.createSession()` passes projectDir
+  - **Status**: COMPLETE - `agentSessionPresenter.createSession()` passes projectDir
 - [x] 统一传递 `conversationId = sessionId`。
-  - **Status**: COMPLETE - `deepchatAgentPresenter.processStream()` uses sessionId throughout
+  - **Status**: COMPLETE - `agentRuntimePresenter.processStream()` uses sessionId throughout
 - [x] 权限与消息归属链路统一按 `sessionId` 路由。
   - **Status**: COMPLETE - All new architecture uses sessionId
 
@@ -112,11 +112,11 @@
 ## T6 编辑历史 user 消息 🟡 P1 HIGH
 
 - [ ] 实现 `editUserMessage(sessionId, messageId, newContent)`。
-  - **File**: `src/main/presenter/newAgentPresenter/index.ts`
+  - **File**: `src/main/presenter/agentSessionPresenter/index.ts`
   - **IPC**: Add `editUserMessage(sessionId, messageId, newContent)` method
   - Validate: only user messages can be edited
 - [ ] 执行"编辑点后消息截断"。
-  - **File**: `src/main/presenter/deepchatAgentPresenter/messageStore.ts`
+  - **File**: `src/main/presenter/agentRuntimePresenter/messageStore.ts`
   - Add `deleteMessagesAfter(messageId)` method
   - Delete all messages with `orderSeq > editedMessage.orderSeq`
 - [ ] 自动触发 regenerate 并同步状态。
@@ -140,7 +140,7 @@
   - Old: `agentPresenter.retryMessage()` created variants
   - New: Must create NEW assistant message (not replace)
 - [ ] 实现 retry/regenerate 追加 assistant 消息。
-  - **File**: `src/main/presenter/newAgentPresenter/index.ts`
+  - **File**: `src/main/presenter/agentSessionPresenter/index.ts`
   - **IPC**: Add `retryMessage(sessionId, messageId)` method
   - Find the assistant message by messageId
   - Create new assistant message with same context
@@ -162,7 +162,7 @@
 ## T8 Fork 🟡 P1 HIGH
 
 - [ ] 实现 `forkSessionFromMessage(sessionId, messageId)`。
-  - **File**: `src/main/presenter/newAgentPresenter/index.ts`
+  - **File**: `src/main/presenter/agentSessionPresenter/index.ts`
   - **IPC**: Add `forkSessionFromMessage(sessionId, messageId)` method
   - Get all messages up to and including messageId
   - Create new session with copied messages
@@ -171,7 +171,7 @@
   - Include the assistant message at fork point
   - New session can continue from that point
 - [ ] fork 后新 session 可继续发送与生成。
-  - Initialize new session with deepchatAgentPresenter
+  - Initialize new session with agentRuntimePresenter
   - Enable sending messages and generating responses
 - [ ] 补齐 fork 前后消息隔离测试。
   - Test: fork creates independent session
@@ -191,7 +191,7 @@
   - Remove conversation settings UI from ChatPage
   - Migrate to session-level config
 - [ ] 将 agent 默认配置下沉到 session 存储。
-  - **File**: `src/main/presenter/newAgentPresenter/index.ts`
+  - **File**: `src/main/presenter/agentSessionPresenter/index.ts`
   - Extend `CreateSessionInput` to include:
     - `temperature?: number`
     - `contextLength?: number`
diff --git a/docs/specs/app-spotlight-search/plan.md b/docs/specs/app-spotlight-search/plan.md
index cd701d07e..1affdf968 100644
--- a/docs/specs/app-spotlight-search/plan.md
+++ b/docs/specs/app-spotlight-search/plan.md
@@ -142,7 +142,7 @@ Spotlight 作为 follow-up feature 分两层：
 
 新增 Presenter 接口：
 
-- `INewAgentPresenter.searchHistory(query, options?)`
+- `IAgentSessionPresenter.searchHistory(query, options?)`
 
 说明：
 
diff --git a/docs/specs/app-spotlight-search/tasks.md b/docs/specs/app-spotlight-search/tasks.md
index 156b76444..4973f3809 100644
--- a/docs/specs/app-spotlight-search/tasks.md
+++ b/docs/specs/app-spotlight-search/tasks.md
@@ -28,7 +28,7 @@
 
 - [ ] 新增 `HistorySearchOptions`
 - [ ] 新增 `HistorySearchHit / SessionHit / MessageHit`
-- [ ] `INewAgentPresenter` 增加 `searchHistory(query, options?)`
+- [ ] `IAgentSessionPresenter` 增加 `searchHistory(query, options?)`
 - [ ] 补充共享类型导出
 
 ## T4 设置导航 registry
diff --git a/docs/specs/architecture-simplification/plan.md b/docs/specs/architecture-simplification/plan.md
index 2ca77fcd0..7008d31e1 100644
--- a/docs/specs/architecture-simplification/plan.md
+++ b/docs/specs/architecture-simplification/plan.md
@@ -11,7 +11,7 @@
 ### 2. Main Composition / Lifecycle
 
 - 新增 `ConfigQueryPort`、`SessionRuntimePort`、`WindowRoutingPort` 等窄接口。
-- 让 `Presenter` 只在 composition root 组装 port；`newAgentPresenter`、`deepchatAgentPresenter` 只依赖 port。
+- 让 `Presenter` 只在 composition root 组装 port；`agentSessionPresenter`、`agentRuntimePresenter` 只依赖 port。
 - 首批迁移目标：
   - 会话 UI 刷新
   - 权限批准 / 清理
diff --git a/docs/specs/architecture-simplification/spec.md b/docs/specs/architecture-simplification/spec.md
index b9f03687d..e18998936 100644
--- a/docs/specs/architecture-simplification/spec.md
+++ b/docs/specs/architecture-simplification/spec.md
@@ -15,7 +15,7 @@
 
 - 为 `main` 和 `renderer` 建立可持续更新的结构基线，而不是一次性口头结论。
 - 限制活跃路径继续依赖全局 `presenter`、分散 IPC 监听和历史归档代码。
-- 让 `newAgentPresenter`、`deepchatAgentPresenter`、`App.vue`、`stores/ui/*` 的职责边界更清楚。
+- 让 `agentSessionPresenter`、`agentRuntimePresenter`、`App.vue`、`stores/ui/*` 的职责边界更清楚。
 - 为后续删除历史源码归档目录和死文件清理建立前置条件。
 
 ## Non-Goals
@@ -29,7 +29,7 @@
 
 - 仓库存在一组可更新的基线报告，至少覆盖依赖环、零入边候选、归档引用、失败测试分组。
 - 活跃主链路新增 anti-regression guard，阻止历史源码重新进入运行时依赖，阻止首批主链路继续回跳全局 `presenter`。
-- `newAgentPresenter` / `deepchatAgentPresenter` 首批关键路径改为依赖窄接口 port，而不是直接 import `presenter/index.ts`。
+- `agentSessionPresenter` / `agentRuntimePresenter` 首批关键路径改为依赖窄接口 port，而不是直接 import `presenter/index.ts`。
 - `renderer` 至少将 `App`、`session`、`message` 这条活跃链路的 IPC 监听收口到 helper / subscription hub，并把流式状态独立成单独状态面。
 - 文档中存在本次治理的 `spec.md`、`plan.md`、`tasks.md`，并且 `docs/README.md` 能导航到这些内容。
 
diff --git a/docs/specs/architecture-simplification/tasks.md b/docs/specs/architecture-simplification/tasks.md
index c0609fe98..9c1421fad 100644
--- a/docs/specs/architecture-simplification/tasks.md
+++ b/docs/specs/architecture-simplification/tasks.md
@@ -9,8 +9,8 @@
 ## Main
 
 - [x] 引入窄接口 ports
-- [x] 将 `newAgentPresenter` 的会话 UI 刷新与权限清理改成依赖 port
-- [x] 将 `deepchatAgentPresenter` 的权限批准与 env prompt model lookup 改成依赖 port
+- [x] 将 `agentSessionPresenter` 的会话 UI 刷新与权限清理改成依赖 port
+- [x] 将 `agentRuntimePresenter` 的权限批准与 env prompt model lookup 改成依赖 port
 - [x] 让 `Presenter` 成为 port 的唯一组装入口
 
 ## Renderer
diff --git a/docs/specs/floating-agent-widget/plan.md b/docs/specs/floating-agent-widget/plan.md
index 45cb02bd5..11034c940 100644
--- a/docs/specs/floating-agent-widget/plan.md
+++ b/docs/specs/floating-agent-widget/plan.md
@@ -4,7 +4,7 @@
 
 1. 保留现有独立悬浮窗口入口，但将其内容从“按钮 + 外部悬浮聊天窗入口”收敛为“任务小部件”。
 2. 小部件数据由主进程聚合，renderer 只负责展示和交互。
-3. 仅复用 `newAgentPresenter.getSessionList()` 与 `DeepChatAgentPresenter` 的状态事件，不新增独立数据库表。
+3. 仅复用 `agentSessionPresenter.getSessionList()` 与 `AgentRuntimePresenter` 的状态事件，不新增独立数据库表。
 4. 点击会话时不再打开旧的 `FloatingChatWindow`，而是唤起主窗口并激活对应会话。
 
 ## 数据模型
@@ -17,7 +17,7 @@
 
 状态来源：
 
-- 会话列表：`newAgentPresenter.getSessionList({ agentId: 'deepchat' })`
+- 会话列表：`agentSessionPresenter.getSessionList({ agentId: 'deepchat' })`
 - 会话状态：`SessionWithState.status`
 - 语言：`configPresenter.getLanguage()`
 
@@ -39,8 +39,8 @@
 
 以下场景统一触发 `floatingButtonPresenter.refreshWidgetState()`：
 
-- `newAgentPresenter` 发出列表更新时
-- `deepchatAgentPresenter` 会话状态变化时
+- `agentSessionPresenter` 发出列表更新时
+- `agentRuntimePresenter` 会话状态变化时
 - 标题自动生成完成时
 
 主进程刷新后向悬浮 renderer 发送最新 snapshot。
@@ -49,7 +49,7 @@
 
 1. 悬浮 renderer 发送 `open-session(sessionId)`
 2. 主进程选择目标 chat 窗口；若不存在则创建
-3. 主进程调用 `newAgentPresenter.activateSession(targetWebContentsId, sessionId)`
+3. 主进程调用 `agentSessionPresenter.activateSession(targetWebContentsId, sessionId)`
 4. 主进程显示并聚焦目标窗口
 5. 目标 renderer 收到 `SESSION_EVENTS.ACTIVATED` 后切换到对应 chat route
 
diff --git a/docs/specs/legacy-agentpresenter-retirement/spec.md b/docs/specs/legacy-agentpresenter-retirement/spec.md
index d95403ce7..b80cd16e7 100644
--- a/docs/specs/legacy-agentpresenter-retirement/spec.md
+++ b/docs/specs/legacy-agentpresenter-retirement/spec.md
@@ -3,7 +3,7 @@
 ## Summary
 
 Retire the live legacy `AgentPresenter -> SessionManager -> streaming/permission/loop` runtime
-chain and make the current `newAgentPresenter + deepchatAgentPresenter` path the only active chat
+chain and make the current `agentSessionPresenter + agentRuntimePresenter` path the only active chat
 execution flow.
 
 ## Scope
diff --git a/docs/specs/message-toolbar-actions/plan.md b/docs/specs/message-toolbar-actions/plan.md
index 7552d97a7..3525e0062 100644
--- a/docs/specs/message-toolbar-actions/plan.md
+++ b/docs/specs/message-toolbar-actions/plan.md
@@ -2,7 +2,7 @@
 
 ## 1. 关键决策
 
-1. 新页面消息操作以 `newAgentPresenter` 为唯一目标接口。
+1. 新页面消息操作以 `agentSessionPresenter` 为唯一目标接口。
 2. 新架构下线 variants，不再做版本切换状态维护。
 3. 交付拆两阶段：
    - Phase 1：前端接线、显隐与禁用策略。
@@ -33,7 +33,7 @@
 
 ## 3. 新 API 设计（Phase 2）
 
-在 `INewAgentPresenter` 增加：
+在 `IAgentSessionPresenter` 增加：
 
 1. `editUserMessage(sessionId: string, messageId: string, newText: string): Promise<void>`
 2. `retryFromUserMessage(sessionId: string, messageId: string): Promise<void>`
diff --git a/docs/specs/message-toolbar-actions/spec.md b/docs/specs/message-toolbar-actions/spec.md
index 57b94c353..f1d961c8f 100644
--- a/docs/specs/message-toolbar-actions/spec.md
+++ b/docs/specs/message-toolbar-actions/spec.md
@@ -2,13 +2,13 @@
 
 ## 概述
 
-本规格定义新架构会话页（`ChatPage + stores/ui/* + newAgentPresenter`）下的 `MessageToolbar` 功能补齐范围，目标是让按钮行为与产品语义一致，避免“可见但不可用/行为不一致”。
+本规格定义新架构会话页（`ChatPage + stores/ui/* + agentSessionPresenter`）下的 `MessageToolbar` 功能补齐范围，目标是让按钮行为与产品语义一致，避免“可见但不可用/行为不一致”。
 
 本规格**不包含 Trace 数据落库设计**，Trace 由独立规格处理：`docs/specs/message-trace-storage/`。
 
 ## 背景与目标
 
-1. 新 UI 主链路已迁移到 `newAgentPresenter + deepchatAgentPresenter`，但 `MessageToolbar` 仍大量依赖旧 `chatStore/sessionPresenter` 语义。
+1. 新 UI 主链路已迁移到 `agentSessionPresenter + agentRuntimePresenter`，但 `MessageToolbar` 仍大量依赖旧 `chatStore/sessionPresenter` 语义。
 2. 当前按钮存在“新旧链路行为不一致”与“有 UI 无闭环”的问题。
 3. 需要明确分阶段交付：先修前端行为与禁用策略，再补后端消息操作 API。
 
@@ -38,7 +38,7 @@
 
 ### A. 架构范围
 
-- [ ] 新会话页链路仅使用 `stores/ui/session.ts`、`stores/ui/message.ts`、`newAgentPresenter`。
+- [ ] 新会话页链路仅使用 `stores/ui/session.ts`、`stores/ui/message.ts`、`agentSessionPresenter`。
 - [ ] 不再依赖旧 `chatStore` 作为新页面消息操作入口。
 - [ ] 旧页面链路可保留兼容，但不作为新页面实现基线。
 
diff --git a/docs/specs/message-toolbar-actions/tasks.md b/docs/specs/message-toolbar-actions/tasks.md
index 8ca603caa..dcc04ee75 100644
--- a/docs/specs/message-toolbar-actions/tasks.md
+++ b/docs/specs/message-toolbar-actions/tasks.md
@@ -16,9 +16,9 @@
 
 ## T2 Phase 2：新后端消息操作 API
 
-- [ ] `INewAgentPresenter` 增加消息操作接口定义
-- [ ] `newAgentPresenter` 增加消息操作代理实现
-- [ ] `deepchatAgentPresenter` 实现编辑/重试/删除/fork 语义
+- [ ] `IAgentSessionPresenter` 增加消息操作接口定义
+- [ ] `agentSessionPresenter` 增加消息操作代理实现
+- [ ] `agentRuntimePresenter` 实现编辑/重试/删除/fork 语义
 - [ ] MessageStore/SQLite 层补齐对应读写方法
 
 ## T3 渲染层动作闭环
diff --git a/docs/specs/message-trace-storage/plan.md b/docs/specs/message-trace-storage/plan.md
index f897ebaa8..f539e295f 100644
--- a/docs/specs/message-trace-storage/plan.md
+++ b/docs/specs/message-trace-storage/plan.md
@@ -35,7 +35,7 @@
 
 ### 3.1 Trace 上下文
 
-在 `deepchatAgentPresenter.runStreamForMessage` 构建 trace context：
+在 `agentRuntimePresenter.runStreamForMessage` 构建 trace context：
 
 1. `sessionId`
 2. `messageId`
@@ -69,7 +69,7 @@
 
 ### 5.1 IPC / Presenter
 
-在 `INewAgentPresenter` 增加：
+在 `IAgentSessionPresenter` 增加：
 
 1. `listMessageTraces(messageId: string): Promise<MessageTraceRecord[]>`
 2. `getMessageTraceCount(messageId: string): Promise<number>`（可选；也可在消息查询时聚合）
diff --git a/docs/specs/message-trace-storage/tasks.md b/docs/specs/message-trace-storage/tasks.md
index 76e88b1da..a5c8afc31 100644
--- a/docs/specs/message-trace-storage/tasks.md
+++ b/docs/specs/message-trace-storage/tasks.md
@@ -16,8 +16,8 @@
 ## T2 类型与接口
 
 - [x] 新增 `MessageTraceRecord` 共享类型
-- [x] `INewAgentPresenter` 增加 trace 查询接口
-- [x] `newAgentPresenter` 增加 trace 查询代理实现
+- [x] `IAgentSessionPresenter` 增加 trace 查询接口
+- [x] `agentSessionPresenter` 增加 trace 查询代理实现
 
 ## T3 脱敏与截断
 
diff --git a/docs/specs/new-agent/plan.md b/docs/specs/new-agent/plan.md
index 4ad4d7b64..7b0313084 100644
--- a/docs/specs/new-agent/plan.md
+++ b/docs/specs/new-agent/plan.md
@@ -33,23 +33,23 @@
 
 ## 2. Design Decisions
 
-### 2.1 Naming: `newAgentPresenter` not `agentPresenter`
+### 2.1 Naming: `agentSessionPresenter` not `agentPresenter`
 
-The old `agentPresenter` still exists and must keep working. The new one is registered as `newAgentPresenter` in IPresenter to avoid name collision. Renderer calls `usePresenter('newAgentPresenter')`. When old UI is removed, rename to `agentPresenter`.
+The old `agentPresenter` still exists and must keep working. The new one is registered as `agentSessionPresenter` in IPresenter to avoid name collision. Renderer calls `usePresenter('agentSessionPresenter')`. When old UI is removed, rename to `agentPresenter`.
 
 ### 2.2 Database: new tables in same chat.db
 
 No separate DB file. New tables coexist with old tables in `chat.db`:
 - `new_sessions` — agentPresenter's thin session registry
 - `new_projects` — project directory history
-- `deepchat_sessions` — deepchatAgentPresenter's session config
-- `deepchat_messages` — deepchatAgentPresenter's messages
+- `deepchat_sessions` — agentRuntimePresenter's session config
+- `deepchat_messages` — agentRuntimePresenter's messages
 
 Prefix `new_` on `sessions` and `projects` to avoid any conflict with potential future SQLite reserved words or collisions.
 
 ### 2.3 Stream handling: reuse LLMCoreStreamEvent, transform to LLMAgentEventData
 
-deepchatAgentPresenter consumes `LLMCoreStreamEvent` from `coreStream()` and:
+agentRuntimePresenter consumes `LLMCoreStreamEvent` from `coreStream()` and:
 1. Accumulates content into `AssistantMessageBlock[]` structure
 2. Persists structured JSON content to `deepchat_messages` (batched DB writes every 600ms)
 3. Transforms to `LLMAgentEventData` format with `conversationId` + `eventId` for routing
@@ -126,9 +126,9 @@ On stream end, both flush immediately with final content.
 
 - `Agent`, `Session`, `SessionStatus`, `CreateSessionInput`, `ChatMessage`, `UserMessageContent`, `AssistantMessageBlock`, `MessageMetadata`, `Project`
 
-**`presenters/new-agent.presenter.d.ts`** — IPC-facing interface:
+**`presenters/agent-session.presenter.d.ts`** — IPC-facing interface:
 
-- `INewAgentPresenter` — what the renderer can call: `createSession`, `sendMessage`, `getSessionList`, `getSession`, `getMessages`, `getMessageIds`, `getMessage`, `activateSession`, `deactivateSession`, `getActiveSession`, `getAgents`, `deleteSession`
+- `IAgentSessionPresenter` — what the renderer can call: `createSession`, `sendMessage`, `getSessionList`, `getSession`, `getMessages`, `getMessageIds`, `getMessage`, `activateSession`, `deactivateSession`, `getActiveSession`, `getAgents`, `deleteSession`
 
 **`presenters/project.presenter.d.ts`** — IPC-facing interface:
 
@@ -182,14 +182,14 @@ On stream end, both flush immediately with final content.
 
 Index: `CREATE INDEX idx_deepchat_messages_session ON deepchat_messages(session_id, order_seq)`
 
-### 3.3 agentPresenter (`src/main/presenter/newAgentPresenter/`)
+### 3.3 agentPresenter (`src/main/presenter/agentSessionPresenter/`)
 
-**`index.ts`** — main presenter class implementing `INewAgentPresenter`
+**`index.ts`** — main presenter class implementing `IAgentSessionPresenter`
 
 Owns:
 - `sessionManager` — thin CRUD over `new_sessions` table
 - `messageManager` — proxy that resolves agentId then delegates to agent
-- `agentRegistry` — `Map<string, IAgentImplementation>`, populated in constructor with deepchatAgentPresenter
+- `agentRegistry` — `Map<string, IAgentImplementation>`, populated in constructor with agentRuntimePresenter
 
 Methods (IPC-facing):
 - `createSession(input, webContentsId)` → sessionManager.create() + agent.initSession() + agent.processMessage() + emit ACTIVATED
@@ -230,7 +230,7 @@ Event relay:
 - `resolve(agentId)` → returns `IAgentImplementation` or throws
 - `getAll()` → returns `Agent[]` list (for v0: just deepchat)
 
-### 3.4 deepchatAgentPresenter (`src/main/presenter/deepchatAgentPresenter/`)
+### 3.4 agentRuntimePresenter (`src/main/presenter/agentRuntimePresenter/`)
 
 **`index.ts`** — implements `IAgentImplementation`
 
@@ -299,14 +299,14 @@ Methods:
 
 3 touchpoints:
 
-1. Import and add to IPresenter: `newAgentPresenter: INewAgentPresenter`, `projectPresenter: IProjectPresenter`
+1. Import and add to IPresenter: `agentSessionPresenter: IAgentSessionPresenter`, `projectPresenter: IProjectPresenter`
 2. Add class properties
 3. Instantiate in constructor:
-   - `this.deepchatAgentPresenter = new DeepChatAgentPresenter(this.llmProviderPresenter, this.configPresenter, this.sqlitePresenter)`
-   - `this.newAgentPresenter = new NewAgentPresenter(this.deepchatAgentPresenter, this.configPresenter, this.sqlitePresenter, this.eventBus)`
+   - `this.agentRuntimePresenter = new AgentRuntimePresenter(this.llmProviderPresenter, this.configPresenter, this.sqlitePresenter)`
+   - `this.agentSessionPresenter = new AgentSessionPresenter(this.agentRuntimePresenter, this.configPresenter, this.sqlitePresenter, this.eventBus)`
    - `this.projectPresenter = new ProjectPresenter(this.sqlitePresenter, this.devicePresenter)`
 
-Note: `deepchatAgentPresenter` is NOT exposed on IPresenter — it's internal. Only `newAgentPresenter` and `projectPresenter` are IPC-accessible.
+Note: `agentRuntimePresenter` is NOT exposed on IPresenter — it's internal. Only `agentSessionPresenter` and `projectPresenter` are IPC-accessible.
 
 ### 3.7 Events (`src/main/events.ts`)
 
@@ -327,14 +327,14 @@ STREAM_EVENTS reused as-is — same event names, same payload format. All stream
 
 **`session.ts`** — rewrite
 
-- Uses `usePresenter('newAgentPresenter')`
+- Uses `usePresenter('agentSessionPresenter')`
 - State: `sessions: Session[]`, `activeSessionId`, `groupMode`
 - Actions: `fetchSessions()`, `createSession(input)`, `selectSession(id)`, `closeSession()`
 - Listens to: `SESSION_EVENTS.LIST_UPDATED`, `SESSION_EVENTS.ACTIVATED`, `SESSION_EVENTS.DEACTIVATED`, `SESSION_EVENTS.STATUS_CHANGED`
 
 **`message.ts`** — new
 
-- Uses `usePresenter('newAgentPresenter')`
+- Uses `usePresenter('agentSessionPresenter')`
 - State: `messageIds: string[]`, `messageCache: Map<string, ChatMessage>`, `isStreaming: boolean`, `streamingBlocks: AssistantMessageBlock[]`
 - Actions: `loadMessages(sessionId)`, `getMessage(id)`
 - Listens to: `STREAM_EVENTS.RESPONSE` (update streaming blocks from `LLMAgentEventData`), `STREAM_EVENTS.END` (finalize), `STREAM_EVENTS.ERROR`
@@ -342,7 +342,7 @@ STREAM_EVENTS reused as-is — same event names, same payload format. All stream
 
 **`agent.ts`** — rewrite
 
-- Uses `usePresenter('newAgentPresenter')`
+- Uses `usePresenter('agentSessionPresenter')`
 - State: `agents: Agent[]`, `selectedAgentId`
 - Actions: `fetchAgents()`, `selectAgent(id)`
 
@@ -373,7 +373,7 @@ STREAM_EVENTS reused as-is — same event names, same payload format. All stream
 - `agentRegistry.register/resolve/getAll` — correct routing
 - `createSession` → calls sessionManager.create + agent.initSession + agent.processMessage
 
-**deepchatAgentPresenter:**
+**agentRuntimePresenter:**
 - `processMessage` → creates user message (JSON content), calls LLM, creates assistant message (JSON blocks)
 - `streamHandler` — given mock `AsyncGenerator<LLMCoreStreamEvent>`, verify: block accumulation, batched DB writes at 600ms, renderer flush at 120ms, final flush on stop
 - `messageStore` — CRUD operations against in-memory SQLite, verify JSON content round-trip
@@ -386,7 +386,7 @@ STREAM_EVENTS reused as-is — same event names, same payload format. All stream
 
 ### 4.2 Integration Tests
 
-- End-to-end: `newAgentPresenter.createSession()` → verify new_sessions row + deepchat_sessions row + deepchat_messages rows (with valid JSON content) + events emitted with conversationId
+- End-to-end: `agentSessionPresenter.createSession()` → verify new_sessions row + deepchat_sessions row + deepchat_messages rows (with valid JSON content) + events emitted with conversationId
 - Coexistence: old `sessionPresenter.createSession()` still works — old tables unaffected
 - Crash recovery: insert pending message, reinitialize presenter, verify status changed to error
 
diff --git a/docs/specs/new-agent/spec.md b/docs/specs/new-agent/spec.md
index 0e99a155e..9a9f58487 100644
--- a/docs/specs/new-agent/spec.md
+++ b/docs/specs/new-agent/spec.md
@@ -18,7 +18,7 @@ See [Full-Stack Mismatch Analysis](../../architecture/new-ui-store-presenter-mis
 
 1. **Agent interface protocol** — define the unified contract all agents implement
 2. **agentPresenter** — router, thin session registry, event relay
-3. **deepchatAgentPresenter** — single-turn chat: message → LLM → streamed response → persist
+3. **agentRuntimePresenter** — single-turn chat: message → LLM → streamed response → persist
 4. **projectPresenter** — thin project directory CRUD
 5. **New DB tables** — `new_sessions`, `new_projects`, `deepchat_sessions`, `deepchat_messages`
 6. **New renderer stores** — sessionStore, messageStore, agentStore, projectStore, draftStore
@@ -41,14 +41,14 @@ See [Full-Stack Mismatch Analysis](../../architecture/new-ui-store-presenter-mis
 **Main process:**
 - `src/shared/types/agent-interface.d.ts` — agent interface protocol
 - `src/shared/types/chat-types.d.ts` — Agent, Session, Project, CreateSessionInput, ChatMessage, MessageBlock types
-- `src/main/presenter/newAgentPresenter/index.ts` — agentPresenter (router)
-- `src/main/presenter/newAgentPresenter/sessionManager.ts` — thin session registry
-- `src/main/presenter/newAgentPresenter/messageManager.ts` — message proxy
-- `src/main/presenter/newAgentPresenter/agentRegistry.ts` — agent discovery + routing
-- `src/main/presenter/deepchatAgentPresenter/index.ts` — deepchat agent implementation
-- `src/main/presenter/deepchatAgentPresenter/sessionStore.ts` — agent-owned session persistence
-- `src/main/presenter/deepchatAgentPresenter/messageStore.ts` — agent-owned message persistence
-- `src/main/presenter/deepchatAgentPresenter/streamHandler.ts` — LLM stream → message persistence + event emission
+- `src/main/presenter/agentSessionPresenter/index.ts` — agentPresenter (router)
+- `src/main/presenter/agentSessionPresenter/sessionManager.ts` — thin session registry
+- `src/main/presenter/agentSessionPresenter/messageManager.ts` — message proxy
+- `src/main/presenter/agentSessionPresenter/agentRegistry.ts` — agent discovery + routing
+- `src/main/presenter/agentRuntimePresenter/index.ts` — deepchat agent implementation
+- `src/main/presenter/agentRuntimePresenter/sessionStore.ts` — agent-owned session persistence
+- `src/main/presenter/agentRuntimePresenter/messageStore.ts` — agent-owned message persistence
+- `src/main/presenter/agentRuntimePresenter/streamHandler.ts` — LLM stream → message persistence + event emission
 - `src/main/presenter/projectPresenter/index.ts` — project CRUD
 - `src/main/presenter/sqlitePresenter/tables/` — new table definitions
 - `src/main/events.ts` — add SESSION_EVENTS
@@ -81,13 +81,13 @@ See [Full-Stack Mismatch Analysis](../../architecture/new-ui-store-presenter-mis
 ### Functional Requirements
 
 - [ ] Agent interface protocol defined as TypeScript types in `src/shared/types/`
-- [ ] agentPresenter registered in Presenter class, accessible via `usePresenter('newAgentPresenter')`
+- [ ] agentPresenter registered in Presenter class, accessible via `usePresenter('agentSessionPresenter')`
 - [ ] agentPresenter.sessionManager creates session records in new `new_sessions` table
 - [ ] agentPresenter.agentRegistry returns `[{ id: 'deepchat', name: 'DeepChat', type: 'deepchat', enabled: true }]`
-- [ ] agentPresenter routes `sendMessage()` to deepchatAgentPresenter based on session's agentId
-- [ ] deepchatAgentPresenter calls LLM provider's `coreStream()` and receives `LLMCoreStreamEvent` stream
-- [ ] deepchatAgentPresenter persists user message and assistant message in `deepchat_messages` table with structured JSON content
-- [ ] deepchatAgentPresenter emits stream events (response/end/error) via EventBus with `conversationId` for routing
+- [ ] agentPresenter routes `sendMessage()` to agentRuntimePresenter based on session's agentId
+- [ ] agentRuntimePresenter calls LLM provider's `coreStream()` and receives `LLMCoreStreamEvent` stream
+- [ ] agentRuntimePresenter persists user message and assistant message in `deepchat_messages` table with structured JSON content
+- [ ] agentRuntimePresenter emits stream events (response/end/error) via EventBus with `conversationId` for routing
 - [ ] agentPresenter relays all stream events to renderer
 - [ ] Stream events batched: 120ms flush to renderer, 600ms flush to DB
 - [ ] On app restart, any messages with `status = 'pending'` are marked as `'error'` (crash recovery)
@@ -104,11 +104,11 @@ See [Full-Stack Mismatch Analysis](../../architecture/new-ui-store-presenter-mis
 - [ ] `pnpm run typecheck` passes
 - [ ] `pnpm run lint` passes
 - [ ] `pnpm run format` passes
-- [ ] Unit tests for agentPresenter routing, deepchatAgentPresenter stream handling, sessionManager CRUD
+- [ ] Unit tests for agentPresenter routing, agentRuntimePresenter stream handling, sessionManager CRUD
 
 ## Constraints
 
-- LLM provider HTTP clients are reused directly — deepchatAgentPresenter calls `BaseLLMProvider.coreStream()` and consumes the `AsyncGenerator<LLMCoreStreamEvent>`
+- LLM provider HTTP clients are reused directly — agentRuntimePresenter calls `BaseLLMProvider.coreStream()` and consumes the `AsyncGenerator<LLMCoreStreamEvent>`
 - New tables live in the same SQLite database (`chat.db`) alongside old tables — no separate DB file
 - IPC routing is dynamic (`presenter[name]`) — no route registration needed beyond the 3 touchpoints
 - v0 sends a single user message and gets a single assistant response — no multi-turn context, no tool use
diff --git a/docs/specs/new-agent/tasks.md b/docs/specs/new-agent/tasks.md
index 144c9cd32..da2e045ef 100644
--- a/docs/specs/new-agent/tasks.md
+++ b/docs/specs/new-agent/tasks.md
@@ -3,7 +3,7 @@
 ## T0 Shared Types & Events
 
 - [x] Create `src/shared/types/agent-interface.d.ts` — `IAgentImplementation`, `Agent`, `Session`, `SessionStatus`, `CreateSessionInput`, `ChatMessageRecord`, `UserMessageContent`, `AssistantMessageBlock`, `MessageMetadata`, `Project` (merged chat-types into this file)
-- [x] Create `src/shared/types/presenters/new-agent.presenter.d.ts` — `INewAgentPresenter` interface
+- [x] Create `src/shared/types/presenters/agent-session.presenter.d.ts` — `IAgentSessionPresenter` interface
 - [x] Create `src/shared/types/presenters/project.presenter.d.ts` — `IProjectPresenter` interface
 - [x] Export new types from `src/shared/types/presenters/index.d.ts`
 - [x] Add `SESSION_EVENTS` to `src/main/events.ts` (list-updated, activated, deactivated, status-changed)
@@ -17,24 +17,24 @@
 - [x] Create `src/main/presenter/sqlitePresenter/tables/deepchatMessages.ts` — `deepchat_messages` table with order_seq, JSON content, status (pending/sent/error), is_context_edge, metadata; index on (session_id, order_seq)
 - [x] Register new tables in `sqlitePresenter/index.ts` (initTables + migrate array)
 
-## T2 deepchatAgentPresenter
+## T2 agentRuntimePresenter
 
 - [x] Create `messageStore.ts` — CRUD over `deepchat_messages`
 - [x] Create `sessionStore.ts` — CRUD over `deepchat_sessions`
 - [x] Create `index.ts` — implements `IAgentImplementation`, wires sessionStore + messageStore + llmProviderPresenter, runs crash recovery on init
-- [x] Unit tests: processMessage, recoverPendingMessages (`deepchatAgentPresenter.test.ts`)
+- [x] Unit tests: processMessage, recoverPendingMessages (`agentRuntimePresenter.test.ts`)
 
-## T3 agentPresenter (newAgentPresenter)
+## T3 agentPresenter (agentSessionPresenter)
 
-- [x] Create `src/main/presenter/newAgentPresenter/agentRegistry.ts` — register/resolve/getAll
-- [x] Create `src/main/presenter/newAgentPresenter/sessionManager.ts` — CRUD over `new_sessions`, in-memory window bindings (webContentsId → sessionId)
-- [x] Create `src/main/presenter/newAgentPresenter/messageManager.ts` — proxy resolves agentId then delegates to agent
-- [x] Create `src/main/presenter/newAgentPresenter/index.ts` — implements `INewAgentPresenter`, wires sessionManager + messageManager + agentRegistry + event relay (all stream events carry conversationId)
-- [x] Unit tests: sessionManager CRUD + window bindings (`test/main/presenter/newAgentPresenter/sessionManager.test.ts`)
-- [x] Unit tests: agentRegistry register/resolve/getAll/has (`test/main/presenter/newAgentPresenter/agentRegistry.test.ts`)
-- [x] Unit tests: messageManager delegation (`test/main/presenter/newAgentPresenter/messageManager.test.ts`)
-- [x] Unit tests: createSession → verify sessionManager.create + agent.initSession + agent.processMessage called (`test/main/presenter/newAgentPresenter/newAgentPresenter.test.ts`)
-- [x] Unit tests: sendMessage → verify agent routing (`test/main/presenter/newAgentPresenter/newAgentPresenter.test.ts`)
+- [x] Create `src/main/presenter/agentSessionPresenter/agentRegistry.ts` — register/resolve/getAll
+- [x] Create `src/main/presenter/agentSessionPresenter/sessionManager.ts` — CRUD over `new_sessions`, in-memory window bindings (webContentsId → sessionId)
+- [x] Create `src/main/presenter/agentSessionPresenter/messageManager.ts` — proxy resolves agentId then delegates to agent
+- [x] Create `src/main/presenter/agentSessionPresenter/index.ts` — implements `IAgentSessionPresenter`, wires sessionManager + messageManager + agentRegistry + event relay (all stream events carry conversationId)
+- [x] Unit tests: sessionManager CRUD + window bindings (`test/main/presenter/agentSessionPresenter/sessionManager.test.ts`)
+- [x] Unit tests: agentRegistry register/resolve/getAll/has (`test/main/presenter/agentSessionPresenter/agentRegistry.test.ts`)
+- [x] Unit tests: messageManager delegation (`test/main/presenter/agentSessionPresenter/messageManager.test.ts`)
+- [x] Unit tests: createSession → verify sessionManager.create + agent.initSession + agent.processMessage called (`test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts`)
+- [x] Unit tests: sendMessage → verify agent routing (`test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts`)
 
 ## T4 projectPresenter
 
@@ -43,15 +43,15 @@
 
 ## T5 Presenter Registration
 
-- [x] Add `INewAgentPresenter` and `IProjectPresenter` to `IPresenter` interface in `src/shared/types/presenters/legacy.presenters.d.ts`
+- [x] Add `IAgentSessionPresenter` and `IProjectPresenter` to `IPresenter` interface in `src/shared/types/presenters/legacy.presenters.d.ts`
 - [x] Add properties and constructor instantiation in `src/main/presenter/index.ts`
-- [x] Verify: `usePresenter('newAgentPresenter')` and `usePresenter('projectPresenter')` callable from renderer
+- [x] Verify: `usePresenter('agentSessionPresenter')` and `usePresenter('projectPresenter')` callable from renderer
 
 ## T6 Renderer Stores
 
-- [x] Rewrite `src/renderer/src/stores/ui/session.ts` — uses `newAgentPresenter`, listens to `SESSION_EVENTS`, uses `webContentsId` for activation
-- [x] Create `src/renderer/src/stores/ui/message.ts` — uses `newAgentPresenter`, listens to `STREAM_EVENTS`, filters by conversationId, maintains streamingBlocks as AssistantMessageBlock[]
-- [x] Rewrite `src/renderer/src/stores/ui/agent.ts` — uses `newAgentPresenter.getAgents()`
+- [x] Rewrite `src/renderer/src/stores/ui/session.ts` — uses `agentSessionPresenter`, listens to `SESSION_EVENTS`, uses `webContentsId` for activation
+- [x] Create `src/renderer/src/stores/ui/message.ts` — uses `agentSessionPresenter`, listens to `STREAM_EVENTS`, filters by conversationId, maintains streamingBlocks as AssistantMessageBlock[]
+- [x] Rewrite `src/renderer/src/stores/ui/agent.ts` — uses `agentSessionPresenter.getAgents()`
 - [x] Rewrite `src/renderer/src/stores/ui/project.ts` — uses `projectPresenter`
 - [x] Create `src/renderer/src/stores/ui/draft.ts` — pre-session config, toCreateInput()
 
@@ -68,8 +68,8 @@
 - [x] `pnpm run lint` — passes (0 warnings, 0 errors)
 - [x] `pnpm run format` — passes
 - [x] Unit tests: all new modules passing
-- [x] Integration test: createSession end-to-end — new_sessions row + deepchat_sessions row + deepchat_messages rows (valid JSON content) + events with conversationId (`test/main/presenter/newAgentPresenter/integration.test.ts`)
-- [x] Integration test: crash recovery — insert pending message, reinit, verify status = error (`test/main/presenter/newAgentPresenter/integration.test.ts`)
+- [x] Integration test: createSession end-to-end — new_sessions row + deepchat_sessions row + deepchat_messages rows (valid JSON content) + events with conversationId (`test/main/presenter/agentSessionPresenter/integration.test.ts`)
+- [x] Integration test: crash recovery — insert pending message, reinit, verify status = error (`test/main/presenter/agentSessionPresenter/integration.test.ts`)
 - [x] Verify old UI regression: old `sessionPresenter` / `chatStore` still functional — zero impact
 - [x] Manual verify: run `pnpm run dev`, create session via NewThreadPage, see streamed response
 
@@ -80,7 +80,7 @@
 - [x] Create `contextBuilder.ts` — context assembly + truncation
 - [x] Modify `processMessage` in `index.ts` — wire context builder
 - [x] Unit tests for context builder (`contextBuilder.test.ts`)
-- [x] Update `deepchatAgentPresenter.test.ts` — mock `getDefaultSystemPrompt`, verify multi-turn messages
+- [x] Update `agentRuntimePresenter.test.ts` — mock `getDefaultSystemPrompt`, verify multi-turn messages
 - [x] Update `integration.test.ts` — verify multi-turn flow end-to-end
 - [x] Quality gate: typecheck, lint, format, tests
 
@@ -108,5 +108,5 @@
 - [x] Create `process.ts` — unified `processStream()` loop, single code path for tools and no-tools
 - [x] Update `index.ts` — replace `handleStream`/`agentLoop` with single `processStream()` call
 - [x] Delete `streamHandler.ts` and `agentLoop.ts`
-- [x] Tests: `throttle.test.ts` (7), `accumulator.test.ts` (14), `echo.test.ts` (5), `dispatch.test.ts` (14), `process.test.ts` (9), updated `deepchatAgentPresenter.test.ts` (19)
+- [x] Tests: `throttle.test.ts` (7), `accumulator.test.ts` (14), `echo.test.ts` (5), `dispatch.test.ts` (14), `process.test.ts` (9), updated `agentRuntimePresenter.test.ts` (19)
 - [x] Quality gate: typecheck, lint, format, 89 tests passing
diff --git a/docs/specs/new-agent/v2-spec.md b/docs/specs/new-agent/v2-spec.md
index 02c9cf93e..fb79edeb2 100644
--- a/docs/specs/new-agent/v2-spec.md
+++ b/docs/specs/new-agent/v2-spec.md
@@ -38,7 +38,7 @@ No new DB tables. Changes to existing types:
 The v2 goals are implemented in the v3 module structure. The original `streamHandler.ts` + `agentLoop.ts` were refactored into five focused modules:
 
 ```
-deepchatAgentPresenter/
+agentRuntimePresenter/
   index.ts           — session lifecycle + single processStream() call
   process.ts         — unified loop: stream → accumulate → echo → dispatch
   accumulator.ts     — accumulate(state, event): pure block mutations
diff --git a/docs/specs/new-agent/v3-spec.md b/docs/specs/new-agent/v3-spec.md
index f44bb005b..0cc94dec3 100644
--- a/docs/specs/new-agent/v3-spec.md
+++ b/docs/specs/new-agent/v3-spec.md
@@ -26,7 +26,7 @@ v3 refactored the stream processing into five focused pieces with clear boundari
 ## Current Structure
 
 ```
-deepchatAgentPresenter/
+agentRuntimePresenter/
   index.ts           — session lifecycle only (init, destroy, getState, cancel, getMessages)
   process.ts         — the loop: stream → accumulate → echo → dispatch
   accumulator.ts     — accumulate(state, event): mutate blocks by event type
diff --git a/docs/specs/remote-tool-interactions/plan.md b/docs/specs/remote-tool-interactions/plan.md
index 9c758ec0d..096970dd2 100644
--- a/docs/specs/remote-tool-interactions/plan.md
+++ b/docs/specs/remote-tool-interactions/plan.md
@@ -2,7 +2,7 @@
 
 ## Summary
 
-Implement a structured remote interaction loop for Telegram and Feishu so remote endpoints can resolve paused permission and question interactions without falling back to a generic desktop-only notice. The feature stays inside Electron main and reuses the existing `RemoteConversationRunner`, `RemoteCommandRouter`, `FeishuCommandRouter`, and `newAgentPresenter.respondToolInteraction(...)` flow.
+Implement a structured remote interaction loop for Telegram and Feishu so remote endpoints can resolve paused permission and question interactions without falling back to a generic desktop-only notice. The feature stays inside Electron main and reuses the existing `RemoteConversationRunner`, `RemoteCommandRouter`, `FeishuCommandRouter`, and `agentSessionPresenter.respondToolInteraction(...)` flow.
 
 ## Goals
 
@@ -30,7 +30,7 @@ Implement a structured remote interaction loop for Telegram and Feishu so remote
 ## Dependencies
 
 - `RemoteConversationSnapshot.pendingInteraction` in `RemoteConversationRunner`
-- `newAgentPresenter.respondToolInteraction(...)`
+- `agentSessionPresenter.respondToolInteraction(...)`
 - Existing Telegram outbound edit/send flows in `TelegramPoller`
 - Existing Feishu outbound text flow extended with card sending in `FeishuRuntime`
 - In-memory callback/token state in `RemoteBindingStore`
diff --git a/docs/specs/settings-dashboard/plan.md b/docs/specs/settings-dashboard/plan.md
index 1bc7f2831..09b9113f9 100644
--- a/docs/specs/settings-dashboard/plan.md
+++ b/docs/specs/settings-dashboard/plan.md
@@ -27,7 +27,7 @@
 
 ## Dashboard Query
 
-- Expose `newAgentPresenter.getUsageDashboard()`.
+- Expose `agentSessionPresenter.getUsageDashboard()`.
 - Aggregate summary, 365-day calendar, provider breakdown, and model breakdown from `deepchat_usage_stats`.
 
 ## UI
diff --git a/docs/specs/settings-dashboard/tasks.md b/docs/specs/settings-dashboard/tasks.md
index b88f42874..fd2e3e02f 100644
--- a/docs/specs/settings-dashboard/tasks.md
+++ b/docs/specs/settings-dashboard/tasks.md
@@ -3,6 +3,6 @@
 1. Add shared dashboard types and cached token usage plumbing.
 2. Add `deepchat_usage_stats` table and wire it into `SQLitePresenter`.
 3. Record live usage stats on assistant finalize and error finalize.
-4. Implement one-time historical backfill and dashboard query methods in `NewAgentPresenter`.
+4. Implement one-time historical backfill and dashboard query methods in `AgentSessionPresenter`.
 5. Add settings route, dashboard page, and i18n strings.
 6. Add focused main/renderer tests and run format, i18n, and lint.
diff --git a/docs/specs/subagent-orchestrator/plan.md b/docs/specs/subagent-orchestrator/plan.md
index 439b34356..81986ebbb 100644
--- a/docs/specs/subagent-orchestrator/plan.md
+++ b/docs/specs/subagent-orchestrator/plan.md
@@ -5,9 +5,9 @@
 当前代码已经具备：
 
 1. `new_sessions` + `deepchat_sessions` 的新会话栈
-2. `NewAgentPresenter` 负责 session 生命周期与 renderer IPC
+2. `AgentSessionPresenter` 负责 session 生命周期与 renderer IPC
 3. `ToolPresenter -> AgentToolManager` 的 agent tool 路由
-4. `DeepChatAgentPresenter` 的 tool call / permission / question / resume 流
+4. `AgentRuntimePresenter` 的 tool call / permission / question / resume 流
 5. renderer 的 `MessageBlockToolCall`、`ChatToolInteractionOverlay`、`WorkspacePanel`
 
 缺的部分是：
@@ -41,7 +41,7 @@
 采用 main-only event：
 
 1. `dispatch.flushBlocksToRenderer()` 在 child assistant block 流式刷新时，同时发 main-only event
-2. `DeepChatAgentPresenter.setSessionStatus()` 和 `emitMessageRefresh()` 也发 main-only event
+2. `AgentRuntimePresenter.setSessionStatus()` 和 `emitMessageRefresh()` 也发 main-only event
 3. orchestrator 订阅这些事件，维护自己的内存态 queue
 
 这样避免：
@@ -80,7 +80,7 @@ tool 执行时通过 `IToolPresenter.callTool(..., { onProgress })` 回调：
 
 1. 扩展 `DeepChatAgentConfig`、session record、tool progress、presenter interface
 2. 更新 `new_sessions` schema / migration / table accessors
-3. 扩展 `NewSessionManager` 与 `NewAgentPresenter` 的 create/list/delete API
+3. 扩展 `NewSessionManager` 与 `AgentSessionPresenter` 的 create/list/delete API
 
 ### Phase 2：Tool Runtime
 
@@ -98,7 +98,7 @@ tool 执行时通过 `IToolPresenter.callTool(..., { onProgress })` 回调：
 
 1. 增加 main-only subagent runtime event 常量
 2. `dispatch` 在 child assistant block streaming 时发 event
-3. `DeepChatAgentPresenter` 在 message refresh / session status change 时发 event
+3. `AgentRuntimePresenter` 在 message refresh / session status change 时发 event
 4. `dispatch.executeTools()` 与 `executeDeferredToolCall()` 透传 `onProgress` / `signal`
 
 ### Phase 4：Renderer
@@ -153,7 +153,7 @@ tool 执行时通过 `IToolPresenter.callTool(..., { onProgress })` 回调：
 
 ### 4.4 父删子级联
 
-在 `NewAgentPresenter.deleteSession()` 递归查 child：
+在 `AgentSessionPresenter.deleteSession()` 递归查 child：
 
 1. 父删除时先深度删除所有 child
 2. child 单独删除不反查父
@@ -165,7 +165,7 @@ tool 执行时通过 `IToolPresenter.callTool(..., { onProgress })` 回调：
 
 1. SQLite migration / default columns
 2. `NewSessionManager` 读写新字段
-3. `NewAgentPresenter.getSessionList()` 过滤与级联删除
+3. `AgentSessionPresenter.getSessionList()` 过滤与级联删除
 4. `AgentToolManager` tool gating
 5. `subagent_orchestrator` 的 parallel / chain 执行顺序
 6. progress snapshot 与 preview 裁剪
diff --git a/docs/specs/subagent-orchestrator/spec.md b/docs/specs/subagent-orchestrator/spec.md
index d86aa2e4f..919b7bab3 100644
--- a/docs/specs/subagent-orchestrator/spec.md
+++ b/docs/specs/subagent-orchestrator/spec.md
@@ -133,7 +133,7 @@ V1 目标是把能力收口为单一 agent tool `subagent_orchestrator`，由 to
 
 ### 创建
 
-tool 内部通过 runtime port 调 `NewAgentPresenter` 创建 child session：
+tool 内部通过 runtime port 调 `AgentSessionPresenter` 创建 child session：
 
 1. `self` slot 继承父 `agentId`
 2. `agent` slot 使用 `slot.targetAgentId`
diff --git a/docs/specs/subagent-orchestrator/tasks.md b/docs/specs/subagent-orchestrator/tasks.md
index e6b9e7511..2e07710d0 100644
--- a/docs/specs/subagent-orchestrator/tasks.md
+++ b/docs/specs/subagent-orchestrator/tasks.md
@@ -3,13 +3,13 @@
 ## 1. Shared / Schema
 
 1. 扩展 `DeepChatAgentConfig`、`DeepChatSubagentSlot`、session record、tool progress 类型
-2. 扩展 `INewAgentPresenter` / `IToolPresenter`
+2. 扩展 `IAgentSessionPresenter` / `IToolPresenter`
 3. 为 `new_sessions` 增加 subagent 相关列与迁移测试
 
 ## 2. Main Session Layer
 
 1. 更新 `NewSessionsTable` / `NewSessionManager` create-get-list-update
-2. 更新 `NewAgentPresenter`：
+2. 更新 `AgentSessionPresenter`：
    - create session / detached session 支持 `subagentEnabled`
    - `getSessionList()` 支持 `includeSubagents` / `parentSessionId`
    - `setSessionSubagentEnabled()`
@@ -28,7 +28,7 @@
 
 1. 定义 main-only subagent runtime events
 2. `dispatch` 发 child block update event
-3. `DeepChatAgentPresenter` 发 child status / refresh event
+3. `AgentRuntimePresenter` 发 child status / refresh event
 4. `dispatch.executeTools()` / `executeDeferredToolCall()` 接 `onProgress`
 5. 把 `subagentProgress` / `subagentFinal` 写回 assistant block extra
 
diff --git a/docs/specs/telegram-remote-control/plan.md b/docs/specs/telegram-remote-control/plan.md
index 886ab706c..85c3f30ae 100644
--- a/docs/specs/telegram-remote-control/plan.md
+++ b/docs/specs/telegram-remote-control/plan.md
@@ -4,8 +4,8 @@
 
 - Add `src/main/presenter/remoteControlPresenter/` as a main-process presenter that exposes a small shared contract to the renderer through the existing `presenter:call` IPC path.
 - Keep Telegram transport in Electron main using native `fetch` and Bot API long polling.
-- Reuse `newAgentPresenter.sendMessage()` and `DeepChatAgentPresenter` for message persistence, stream state, title generation, and stop behavior.
-- Add detached session creation to `newAgentPresenter` so remote conversations do not require a renderer-bound window.
+- Reuse `agentSessionPresenter.sendMessage()` and `AgentRuntimePresenter` for message persistence, stream state, title generation, and stop behavior.
+- Add detached session creation to `agentSessionPresenter` so remote conversations do not require a renderer-bound window.
 
 ## Main-Process Modules
 
@@ -21,8 +21,8 @@
   - Creates detached sessions when needed.
   - Resolves a valid enabled DeepChat default agent before creating unbound Telegram sessions.
   - Lists recent sessions by the currently bound session's agent when a valid binding exists; otherwise falls back to the default DeepChat agent.
-  - Exposes current-session lookup and bound-session model switching through `newAgentPresenter.setSessionModel()`.
-  - Reuses `newAgentPresenter.sendMessage()` for plain-text Telegram input.
+  - Exposes current-session lookup and bound-session model switching through `agentSessionPresenter.setSessionModel()`.
+  - Reuses `agentSessionPresenter.sendMessage()` for plain-text Telegram input.
   - Tracks the active assistant message/event for `/stop`.
   - Exposes `statusText`, streamed answer `text`, and `finalText` for remote delivery while preserving compatibility snapshot fields.
 - `remoteCommandRouter`
@@ -80,7 +80,7 @@
 3. Telegram poller receives private updates through `getUpdates`.
 4. Parser normalizes message and callback payloads.
 5. Router applies auth, command handling, and `/model` inline-menu transitions.
-6. Plain text enters `newAgentPresenter.sendMessage()` using the bound or newly created detached session.
+6. Plain text enters `agentSessionPresenter.sendMessage()` using the bound or newly created detached session.
 7. `/model` callback actions edit a single bot menu message in place and answer the callback query.
 8. Poller watches assistant message state, edits a temporary status message as status changes, streams answer text into a separate message, and deletes the status message after final sync.
 9. If the assistant pauses on a permission/question action, Telegram returns a desktop-confirmation notice instead of bypassing approval.
diff --git a/docs/specs/telegram-remote-control/tasks.md b/docs/specs/telegram-remote-control/tasks.md
index a1beaf5cd..e5bcd65fa 100644
--- a/docs/specs/telegram-remote-control/tasks.md
+++ b/docs/specs/telegram-remote-control/tasks.md
@@ -5,7 +5,7 @@
    - Rebuild runtime on settings changes and app init.
 
 2. Detached session support
-   - Add `createDetachedSession()` to `newAgentPresenter`.
+   - Add `createDetachedSession()` to `agentSessionPresenter`.
    - Ensure first remote message still triggers title generation through the shared send path.
 
 3. Remote runtime services
diff --git a/docs/specs/tool-output-guardrails/plan.md b/docs/specs/tool-output-guardrails/plan.md
index 784ab5e35..3cd0e1bd8 100644
--- a/docs/specs/tool-output-guardrails/plan.md
+++ b/docs/specs/tool-output-guardrails/plan.md
@@ -15,7 +15,7 @@
   - downgrades tail items one by one to the fixed failure message
   - cleans up offload files for downgraded items
   - returns terminal fallback if the fully downgraded batch still does not fit
-- Refactor `executeTools()` in `deepchatAgentPresenter/dispatch.ts` into two phases:
+- Refactor `executeTools()` in `agentRuntimePresenter/dispatch.ts` into two phases:
   - execute tools and stage candidate outputs plus side effects
   - fit the staged batch, then commit final tool messages, blocks, hooks, and search persistence once
 - Keep `question` and `permission` pauses on the immediate path; they are not part of staged batch fitting.
diff --git a/scripts/agent-cleanup-guard.mjs b/scripts/agent-cleanup-guard.mjs
index 5a6dcdd23..08a19e447 100644
--- a/scripts/agent-cleanup-guard.mjs
+++ b/scripts/agent-cleanup-guard.mjs
@@ -22,8 +22,8 @@ const LEGACY_MAIN_DIRS = [
 ]
 
 const PRIMARY_MAIN_GUARD_PATHS = [
-  path.join(ROOT, 'src/main/presenter/newAgentPresenter'),
-  path.join(ROOT, 'src/main/presenter/deepchatAgentPresenter'),
+  path.join(ROOT, 'src/main/presenter/agentSessionPresenter'),
+  path.join(ROOT, 'src/main/presenter/agentRuntimePresenter'),
   path.join(ROOT, 'src/main/presenter/skillPresenter'),
   path.join(ROOT, 'src/main/presenter/mcpPresenter/toolManager.ts'),
   path.join(ROOT, 'src/main/presenter/syncPresenter/index.ts')
@@ -52,7 +52,7 @@ const LEGACY_AGENT_RUNTIME_GLOBALS = [
   'skillPresenter',
   'filePermissionService',
   'settingsPermissionService',
-  'newAgentPresenter',
+  'agentSessionPresenter',
   'sessionPresenter',
   'yoBrowserPresenter',
   'filePresenter',
@@ -152,8 +152,8 @@ function buildViolation(kind, filePath, specifier) {
 
 async function findViolations() {
   const scanRoots = [
-    path.join(ROOT, 'src/main/presenter/newAgentPresenter'),
-    path.join(ROOT, 'src/main/presenter/deepchatAgentPresenter'),
+    path.join(ROOT, 'src/main/presenter/agentSessionPresenter'),
+    path.join(ROOT, 'src/main/presenter/agentRuntimePresenter'),
     path.join(ROOT, 'src/main/presenter/skillPresenter'),
     path.join(ROOT, 'src/main/presenter/mcpPresenter/toolManager.ts'),
     path.join(ROOT, 'src/main/presenter/syncPresenter/index.ts'),
diff --git a/scripts/architecture-guard.mjs b/scripts/architecture-guard.mjs
index 18103b2fb..5fe127058 100644
--- a/scripts/architecture-guard.mjs
+++ b/scripts/architecture-guard.mjs
@@ -16,8 +16,8 @@ const SOURCE_EXTENSIONS = new Set([
 ])
 
 const MAIN_GUARD_PATHS = [
-  path.join(ROOT, 'src/main/presenter/newAgentPresenter'),
-  path.join(ROOT, 'src/main/presenter/deepchatAgentPresenter'),
+  path.join(ROOT, 'src/main/presenter/agentSessionPresenter'),
+  path.join(ROOT, 'src/main/presenter/agentRuntimePresenter'),
   path.join(ROOT, 'src/main/lib/agentRuntime')
 ]
 
diff --git a/src/main/presenter/deepchatAgentPresenter/accumulator.ts b/src/main/presenter/agentRuntimePresenter/accumulator.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/accumulator.ts
rename to src/main/presenter/agentRuntimePresenter/accumulator.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/compactionService.ts b/src/main/presenter/agentRuntimePresenter/compactionService.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/compactionService.ts
rename to src/main/presenter/agentRuntimePresenter/compactionService.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/contextBuilder.ts b/src/main/presenter/agentRuntimePresenter/contextBuilder.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/contextBuilder.ts
rename to src/main/presenter/agentRuntimePresenter/contextBuilder.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/dispatch.ts b/src/main/presenter/agentRuntimePresenter/dispatch.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/dispatch.ts
rename to src/main/presenter/agentRuntimePresenter/dispatch.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/echo.ts b/src/main/presenter/agentRuntimePresenter/echo.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/echo.ts
rename to src/main/presenter/agentRuntimePresenter/echo.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/index.ts b/src/main/presenter/agentRuntimePresenter/index.ts
similarity index 99%
rename from src/main/presenter/deepchatAgentPresenter/index.ts
rename to src/main/presenter/agentRuntimePresenter/index.ts
index 0df4a1fd8..b413216b5 100644
--- a/src/main/presenter/deepchatAgentPresenter/index.ts
+++ b/src/main/presenter/agentRuntimePresenter/index.ts
@@ -132,7 +132,7 @@ const createAbortError = (): Error => {
   return error
 }
 
-export class DeepChatAgentPresenter implements IAgentImplementation {
+export class AgentRuntimePresenter implements IAgentImplementation {
   private readonly llmProviderPresenter: ILlmProviderPresenter
   private readonly configPresenter: IConfigPresenter
   private readonly sqlitePresenter: SQLitePresenter
diff --git a/src/main/presenter/deepchatAgentPresenter/internalSessionEvents.ts b/src/main/presenter/agentRuntimePresenter/internalSessionEvents.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/internalSessionEvents.ts
rename to src/main/presenter/agentRuntimePresenter/internalSessionEvents.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/messageStore.ts b/src/main/presenter/agentRuntimePresenter/messageStore.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/messageStore.ts
rename to src/main/presenter/agentRuntimePresenter/messageStore.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/messageTracePayload.ts b/src/main/presenter/agentRuntimePresenter/messageTracePayload.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/messageTracePayload.ts
rename to src/main/presenter/agentRuntimePresenter/messageTracePayload.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/pendingInputCoordinator.ts b/src/main/presenter/agentRuntimePresenter/pendingInputCoordinator.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/pendingInputCoordinator.ts
rename to src/main/presenter/agentRuntimePresenter/pendingInputCoordinator.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/pendingInputStore.ts b/src/main/presenter/agentRuntimePresenter/pendingInputStore.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/pendingInputStore.ts
rename to src/main/presenter/agentRuntimePresenter/pendingInputStore.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/process.ts b/src/main/presenter/agentRuntimePresenter/process.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/process.ts
rename to src/main/presenter/agentRuntimePresenter/process.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/sessionStore.ts b/src/main/presenter/agentRuntimePresenter/sessionStore.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/sessionStore.ts
rename to src/main/presenter/agentRuntimePresenter/sessionStore.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/toolOutputGuard.ts b/src/main/presenter/agentRuntimePresenter/toolOutputGuard.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/toolOutputGuard.ts
rename to src/main/presenter/agentRuntimePresenter/toolOutputGuard.ts
diff --git a/src/main/presenter/deepchatAgentPresenter/types.ts b/src/main/presenter/agentRuntimePresenter/types.ts
similarity index 100%
rename from src/main/presenter/deepchatAgentPresenter/types.ts
rename to src/main/presenter/agentRuntimePresenter/types.ts
diff --git a/src/main/presenter/newAgentPresenter/agentRegistry.ts b/src/main/presenter/agentSessionPresenter/agentRegistry.ts
similarity index 100%
rename from src/main/presenter/newAgentPresenter/agentRegistry.ts
rename to src/main/presenter/agentSessionPresenter/agentRegistry.ts
diff --git a/src/main/presenter/newAgentPresenter/index.ts b/src/main/presenter/agentSessionPresenter/index.ts
similarity index 98%
rename from src/main/presenter/newAgentPresenter/index.ts
rename to src/main/presenter/agentSessionPresenter/index.ts
index 4c2f46608..344cd4ec2 100644
--- a/src/main/presenter/newAgentPresenter/index.ts
+++ b/src/main/presenter/agentSessionPresenter/index.ts
@@ -36,7 +36,7 @@ import type {
   CONVERSATION
 } from '@shared/presenter'
 import type { SQLitePresenter } from '../sqlitePresenter'
-import type { DeepChatAgentPresenter } from '../deepchatAgentPresenter'
+import type { AgentRuntimePresenter } from '../agentRuntimePresenter'
 import { AgentRegistry } from './agentRegistry'
 import { NewSessionManager } from './sessionManager'
 import { NewMessageManager } from './messageManager'
@@ -212,7 +212,7 @@ const extractSearchableMessageContent = (rawContent: string): string => {
   return rawContent
 }
 
-export class NewAgentPresenter {
+export class AgentSessionPresenter {
   private agentRegistry: AgentRegistry
   private sessionManager: NewSessionManager
   private messageManager: NewMessageManager
@@ -225,7 +225,7 @@ export class NewAgentPresenter {
   private usageStatsBackfillPromise: Promise<void> | null = null
 
   constructor(
-    deepchatAgent: DeepChatAgentPresenter,
+    agentRuntimePresenter: AgentRuntimePresenter,
     llmProviderPresenter: ILlmProviderPresenter,
     configPresenter: IConfigPresenter,
     sqlitePresenter: SQLitePresenter,
@@ -245,7 +245,7 @@ export class NewAgentPresenter {
     // Register the built-in deepchat agent
     this.agentRegistry.register(
       { id: 'deepchat', name: 'DeepChat', type: 'deepchat', enabled: true },
-      deepchatAgent
+      agentRuntimePresenter
     )
   }
 
@@ -253,7 +253,9 @@ export class NewAgentPresenter {
 
   async createSession(input: CreateSessionInput, webContentsId: number): Promise<SessionWithState> {
     const agentId = input.agentId || 'deepchat'
-    console.log(`[NewAgentPresenter] createSession agent=${agentId} webContentsId=${webContentsId}`)
+    console.log(
+      `[AgentSessionPresenter] createSession agent=${agentId} webContentsId=${webContentsId}`
+    )
     const normalizedInput = this.normalizeCreateSessionInput(input)
     const agentType = await this.getAgentType(agentId)
     const deepChatAgentConfig =
@@ -301,7 +303,7 @@ export class NewAgentPresenter {
       deepChatAgentConfig,
       input.generationSettings
     )
-    console.log(`[NewAgentPresenter] resolved provider=${providerId} model=${modelId}`)
+    console.log(`[AgentSessionPresenter] resolved provider=${providerId} model=${modelId}`)
 
     if (!providerId || !modelId) {
       throw new Error('No provider or model configured. Please set a default model in settings.')
@@ -315,7 +317,7 @@ export class NewAgentPresenter {
       disabledAgentTools,
       subagentEnabled
     })
-    console.log(`[NewAgentPresenter] session created id=${sessionId} title="${title}"`)
+    console.log(`[AgentSessionPresenter] session created id=${sessionId} title="${title}"`)
 
     // Initialize agent-side session
     const initConfig: {
@@ -341,7 +343,7 @@ export class NewAgentPresenter {
       await this.cleanupFailedSessionInitialization(agent, sessionId)
       throw error
     }
-    console.log(`[NewAgentPresenter] agent.initSession done`)
+    console.log(`[AgentSessionPresenter] agent.initSession done`)
 
     // Bind to window and emit activated
     this.sessionManager.bindWindow(webContentsId, sessionId)
@@ -377,14 +379,14 @@ export class NewAgentPresenter {
 
     // Queue the first message (non-blocking) after returning session ID
     if (normalizedInput.text.trim() || (normalizedInput.files?.length ?? 0) > 0) {
-      console.log(`[NewAgentPresenter] firing queuePendingInput (non-blocking)`)
+      console.log(`[AgentSessionPresenter] firing queuePendingInput (non-blocking)`)
       if (agent.queuePendingInput) {
         agent.queuePendingInput(sessionId, normalizedInput).catch((err) => {
-          console.error('[NewAgentPresenter] queuePendingInput failed:', err)
+          console.error('[AgentSessionPresenter] queuePendingInput failed:', err)
         })
       } else {
         agent.processMessage(sessionId, normalizedInput, { projectDir }).catch((err) => {
-          console.error('[NewAgentPresenter] processMessage failed:', err)
+          console.error('[AgentSessionPresenter] processMessage failed:', err)
         })
       }
     }
@@ -874,7 +876,7 @@ export class NewAgentPresenter {
         await agent.destroySession(targetSessionId)
       } catch (cleanupError) {
         console.warn(
-          `[NewAgentPresenter] Failed to cleanup forked session runtime ${targetSessionId}:`,
+          `[AgentSessionPresenter] Failed to cleanup forked session runtime ${targetSessionId}:`,
           cleanupError
         )
       }
@@ -1057,7 +1059,7 @@ export class NewAgentPresenter {
           searchId: result.searchId ?? row.search_id ?? undefined
         })
       } catch (error) {
-        console.warn('[NewAgentPresenter] Failed to parse search result row:', error)
+        console.warn('[AgentSessionPresenter] Failed to parse search result row:', error)
       }
     }
 
@@ -1642,7 +1644,10 @@ export class NewAgentPresenter {
       this.sessionManager.update(sessionId, { title: normalized })
       this.emitSessionListUpdated()
     } catch (error) {
-      console.warn(`[NewAgentPresenter] title generation skipped for session=${sessionId}:`, error)
+      console.warn(
+        `[AgentSessionPresenter] title generation skipped for session=${sessionId}:`,
+        error
+      )
     }
   }
 
@@ -1689,7 +1694,7 @@ export class NewAgentPresenter {
       return await this.buildSessionWithState(record)
     } catch (error) {
       console.warn(
-        `[NewAgentPresenter] Skipping unavailable session id=${record.id} agent=${record.agentId}:`,
+        `[AgentSessionPresenter] Skipping unavailable session id=${record.id} agent=${record.agentId}:`,
         error
       )
       return null
@@ -1882,7 +1887,7 @@ export class NewAgentPresenter {
       return ids.length > 0
     } catch (error) {
       console.warn(
-        `[NewAgentPresenter] Failed to inspect message ids for session=${sessionId}:`,
+        `[AgentSessionPresenter] Failed to inspect message ids for session=${sessionId}:`,
         error
       )
       return true
@@ -1965,7 +1970,7 @@ export class NewAgentPresenter {
         normalizedProjectDir
       )
     } catch (error) {
-      console.warn('[NewAgentPresenter] Failed to sync ACP workdir for session:', {
+      console.warn('[AgentSessionPresenter] Failed to sync ACP workdir for session:', {
         conversationId,
         agentId,
         projectDir: normalizedProjectDir,
@@ -1983,7 +1988,7 @@ export class NewAgentPresenter {
       await agent.destroySession(sessionId)
     } catch (cleanupError) {
       console.warn(
-        `[NewAgentPresenter] Failed to cleanup session runtime after initialization error ${sessionId}:`,
+        `[AgentSessionPresenter] Failed to cleanup session runtime after initialization error ${sessionId}:`,
         cleanupError
       )
     }
diff --git a/src/main/presenter/newAgentPresenter/legacyImportService.ts b/src/main/presenter/agentSessionPresenter/legacyImportService.ts
similarity index 100%
rename from src/main/presenter/newAgentPresenter/legacyImportService.ts
rename to src/main/presenter/agentSessionPresenter/legacyImportService.ts
diff --git a/src/main/presenter/newAgentPresenter/messageManager.ts b/src/main/presenter/agentSessionPresenter/messageManager.ts
similarity index 100%
rename from src/main/presenter/newAgentPresenter/messageManager.ts
rename to src/main/presenter/agentSessionPresenter/messageManager.ts
diff --git a/src/main/presenter/newAgentPresenter/sessionManager.ts b/src/main/presenter/agentSessionPresenter/sessionManager.ts
similarity index 100%
rename from src/main/presenter/newAgentPresenter/sessionManager.ts
rename to src/main/presenter/agentSessionPresenter/sessionManager.ts
diff --git a/src/main/presenter/floatingButtonPresenter/index.ts b/src/main/presenter/floatingButtonPresenter/index.ts
index f22aec505..6676aa5c8 100644
--- a/src/main/presenter/floatingButtonPresenter/index.ts
+++ b/src/main/presenter/floatingButtonPresenter/index.ts
@@ -545,28 +545,28 @@ export class FloatingButtonPresenter {
   }
 
   private async loadDeepChatSessions(): Promise<SessionWithState[]> {
-    const newAgentPresenter = presenter.newAgentPresenter as
+    const agentSessionPresenter = presenter.agentSessionPresenter as
       | {
           getSessionList?: (filters?: { agentId?: string }) => Promise<SessionWithState[]>
         }
       | undefined
 
-    if (!newAgentPresenter?.getSessionList) {
+    if (!agentSessionPresenter?.getSessionList) {
       return []
     }
 
-    return await newAgentPresenter.getSessionList({ agentId: 'deepchat' })
+    return await agentSessionPresenter.getSessionList({ agentId: 'deepchat' })
   }
 
   private async openSession(sessionId: string): Promise<void> {
     try {
-      const newAgentPresenter = presenter.newAgentPresenter as
+      const agentSessionPresenter = presenter.agentSessionPresenter as
         | {
             activateSession?: (webContentsId: number, sessionId: string) => Promise<void>
           }
         | undefined
 
-      if (!newAgentPresenter?.activateSession) {
+      if (!agentSessionPresenter?.activateSession) {
         return
       }
 
@@ -575,7 +575,7 @@ export class FloatingButtonPresenter {
         return
       }
 
-      await newAgentPresenter.activateSession(targetWindow.webContents.id, sessionId)
+      await agentSessionPresenter.activateSession(targetWindow.webContents.id, sessionId)
       presenter.windowPresenter.show(targetWindow.id, true)
       this.setExpanded(false)
     } catch (error) {
diff --git a/src/main/presenter/index.ts b/src/main/presenter/index.ts
index 72846a05a..3f1c1f667 100644
--- a/src/main/presenter/index.ts
+++ b/src/main/presenter/index.ts
@@ -27,7 +27,7 @@ import {
   IYoBrowserPresenter,
   ISkillPresenter,
   ISkillSyncPresenter,
-  INewAgentPresenter,
+  IAgentSessionPresenter,
   IProjectPresenter,
   IRemoteControlPresenter
 } from '@shared/presenter'
@@ -64,15 +64,15 @@ import type { SkillSessionStatePort } from './skillPresenter'
 import { SkillSyncPresenter } from './skillSyncPresenter'
 import { HooksNotificationsService } from './hooksNotifications'
 import { NewSessionHooksBridge } from './hooksNotifications/newSessionBridge'
-import { NewAgentPresenter } from './newAgentPresenter'
-import { DeepChatAgentPresenter } from './deepchatAgentPresenter'
+import { AgentSessionPresenter } from './agentSessionPresenter'
+import { AgentRuntimePresenter } from './agentRuntimePresenter'
 import { ProjectPresenter } from './projectPresenter'
 import { RemoteControlPresenter } from './remoteControlPresenter'
 import type { RemoteControlPresenterLike } from './remoteControlPresenter/interface'
 import { AgentRepository } from './agentRepository'
 import type { SQLitePresenter } from './sqlitePresenter'
 import { normalizeDeepChatSubagentSlots } from '@shared/lib/deepchatSubagents'
-import { subscribeDeepChatInternalSessionUpdates } from './deepchatAgentPresenter/internalSessionEvents'
+import { subscribeDeepChatInternalSessionUpdates } from './agentRuntimePresenter/internalSessionEvents'
 import type { ConfigQueryPort, SessionRuntimePort } from './runtimePorts'
 
 // IPC调用上下文接口
@@ -114,7 +114,7 @@ export class Presenter implements IPresenter {
     'toolPresenter',
     'skillPresenter',
     'skillSyncPresenter',
-    'newAgentPresenter',
+    'agentSessionPresenter',
     'projectPresenter'
   ])
 
@@ -166,7 +166,7 @@ export class Presenter implements IPresenter {
   lifecycleManager: ILifecycleManager
   skillPresenter: ISkillPresenter
   skillSyncPresenter: ISkillSyncPresenter
-  newAgentPresenter: INewAgentPresenter
+  agentSessionPresenter: IAgentSessionPresenter
   projectPresenter: IProjectPresenter
   hooksNotifications: HooksNotificationsService
   commandPermissionService: CommandPermissionService
@@ -248,7 +248,7 @@ export class Presenter implements IPresenter {
     const agentToolRuntime: AgentToolRuntimePort = {
       resolveConversationWorkdir: async (conversationId) => {
         try {
-          const session = await this.newAgentPresenter?.getSession(conversationId)
+          const session = await this.agentSessionPresenter?.getSession(conversationId)
           const normalized = session?.projectDir?.trim()
           if (normalized) {
             return normalized
@@ -263,7 +263,7 @@ export class Presenter implements IPresenter {
         return null
       },
       resolveConversationSessionInfo: async (conversationId) => {
-        const session = await this.newAgentPresenter?.getSession(conversationId)
+        const session = await this.agentSessionPresenter?.getSession(conversationId)
         if (!session) {
           return null
         }
@@ -271,16 +271,16 @@ export class Presenter implements IPresenter {
         const agent = await this.configPresenter.getAgent(session.agentId)
         const agentType = await this.configPresenter.getAgentType(session.agentId)
         const permissionMode =
-          typeof this.newAgentPresenter?.getPermissionMode === 'function'
-            ? await this.newAgentPresenter.getPermissionMode(session.id)
+          typeof this.agentSessionPresenter?.getPermissionMode === 'function'
+            ? await this.agentSessionPresenter.getPermissionMode(session.id)
             : 'full_access'
         const generationSettings =
-          typeof this.newAgentPresenter?.getSessionGenerationSettings === 'function'
-            ? await this.newAgentPresenter.getSessionGenerationSettings(session.id)
+          typeof this.agentSessionPresenter?.getSessionGenerationSettings === 'function'
+            ? await this.agentSessionPresenter.getSessionGenerationSettings(session.id)
             : null
         const disabledAgentTools =
-          typeof this.newAgentPresenter?.getSessionDisabledAgentTools === 'function'
-            ? await this.newAgentPresenter.getSessionDisabledAgentTools(session.id)
+          typeof this.agentSessionPresenter?.getSessionDisabledAgentTools === 'function'
+            ? await this.agentSessionPresenter.getSessionDisabledAgentTools(session.id)
             : []
         const activeSkills = await this.skillPresenter.getActiveSkills(session.id)
         const availableSubagentSlots =
@@ -310,12 +310,12 @@ export class Presenter implements IPresenter {
         }
       },
       createSubagentSession: async (input) => {
-        const newAgentPresenter = this.newAgentPresenter as INewAgentPresenter & {
+        const agentSessionPresenter = this.agentSessionPresenter as IAgentSessionPresenter & {
           createSubagentSession?: (createInput: typeof input) => Promise<{
             id: string
           } | null>
         }
-        const created = await newAgentPresenter.createSubagentSession?.(input)
+        const created = await agentSessionPresenter.createSubagentSession?.(input)
         if (!created?.id) {
           return null
         }
@@ -323,10 +323,10 @@ export class Presenter implements IPresenter {
         return await agentToolRuntime.resolveConversationSessionInfo(created.id)
       },
       sendConversationMessage: async (conversationId, content) => {
-        await this.newAgentPresenter.sendMessage(conversationId, content)
+        await this.agentSessionPresenter.sendMessage(conversationId, content)
       },
       cancelConversation: async (conversationId) => {
-        await this.newAgentPresenter.cancelGeneration(conversationId)
+        await this.agentSessionPresenter.cancelGeneration(conversationId)
       },
       subscribeDeepChatSessionUpdates: (listener) =>
         subscribeDeepChatInternalSessionUpdates(listener),
@@ -377,7 +377,7 @@ export class Presenter implements IPresenter {
     const skillSessionStatePort: SkillSessionStatePort = {
       hasNewSession: async (conversationId) => {
         try {
-          return Boolean(await this.newAgentPresenter?.getSession(conversationId))
+          return Boolean(await this.agentSessionPresenter?.getSession(conversationId))
         } catch {
           return false
         }
@@ -393,10 +393,12 @@ export class Presenter implements IPresenter {
         sqlitePresenter.newEnvironmentsTable?.syncForSession(conversationId)
       },
       repairImportedLegacySessionSkills: async (conversationId) => {
-        const newAgentPresenter = this.newAgentPresenter as INewAgentPresenter & {
+        const agentSessionPresenter = this.agentSessionPresenter as IAgentSessionPresenter & {
           repairImportedLegacySessionSkills?: (sessionId: string) => Promise<string[]>
         }
-        return (await newAgentPresenter.repairImportedLegacySessionSkills?.(conversationId)) ?? []
+        return (
+          (await agentSessionPresenter.repairImportedLegacySessionSkills?.(conversationId)) ?? []
+        )
       }
     }
 
@@ -471,7 +473,7 @@ export class Presenter implements IPresenter {
     }
 
     // Initialize new agent architecture presenters
-    const deepchatAgentPresenter = new DeepChatAgentPresenter(
+    const agentRuntimePresenter = new AgentRuntimePresenter(
       this.llmproviderPresenter as unknown as ILlmProviderPresenter,
       this.configPresenter,
       this.sqlitePresenter as unknown as import('./sqlitePresenter').SQLitePresenter,
@@ -483,8 +485,8 @@ export class Presenter implements IPresenter {
         skillPresenter: this.skillPresenter
       }
     )
-    this.newAgentPresenter = new NewAgentPresenter(
-      deepchatAgentPresenter,
+    this.agentSessionPresenter = new AgentSessionPresenter(
+      agentRuntimePresenter,
       this.llmproviderPresenter as unknown as ILlmProviderPresenter,
       this.configPresenter,
       this.sqlitePresenter as unknown as import('./sqlitePresenter').SQLitePresenter,
@@ -497,8 +499,8 @@ export class Presenter implements IPresenter {
     )
     this.#remoteControlPresenter = new RemoteControlPresenter({
       configPresenter: this.configPresenter,
-      newAgentPresenter: this.newAgentPresenter,
-      deepchatAgentPresenter,
+      agentSessionPresenter: this.agentSessionPresenter,
+      agentRuntimePresenter,
       windowPresenter: this.windowPresenter,
       tabPresenter: this.tabPresenter,
       getHooksNotificationsConfig: () => this.configPresenter.getHooksNotificationsConfig(),
@@ -508,10 +510,10 @@ export class Presenter implements IPresenter {
     })
     this.#remoteControlBridge = this.#remoteControlPresenter
 
-    // Update hooksNotifications with actual dependencies now that newAgentPresenter is ready
+    // Update hooksNotifications with actual dependencies now that agentSessionPresenter is ready
     this.hooksNotifications = new HooksNotificationsService(this.configPresenter, {
-      getSession: this.newAgentPresenter.getSession.bind(this.newAgentPresenter),
-      getMessage: this.newAgentPresenter.getMessage.bind(this.newAgentPresenter)
+      getSession: this.agentSessionPresenter.getSession.bind(this.agentSessionPresenter),
+      getMessage: this.agentSessionPresenter.getMessage.bind(this.agentSessionPresenter)
     })
 
     this.setupEventBus() // 设置事件总线监听
diff --git a/src/main/presenter/lifecyclePresenter/hooks/after-start/legacyImportHook.ts b/src/main/presenter/lifecyclePresenter/hooks/after-start/legacyImportHook.ts
index 4ceae3b40..b5f695aad 100644
--- a/src/main/presenter/lifecyclePresenter/hooks/after-start/legacyImportHook.ts
+++ b/src/main/presenter/lifecyclePresenter/hooks/after-start/legacyImportHook.ts
@@ -12,15 +12,15 @@ export const legacyImportHook: LifecycleHook = {
       throw new Error('legacyImportHook: Presenter not initialized')
     }
 
-    const newAgentPresenter = presenter.newAgentPresenter as unknown as {
+    const agentSessionPresenter = presenter.agentSessionPresenter as unknown as {
       startLegacyImport?: () => Promise<void>
     }
-    if (!newAgentPresenter.startLegacyImport) {
+    if (!agentSessionPresenter.startLegacyImport) {
       return
     }
 
     // Fire and forget to avoid blocking app startup.
-    void newAgentPresenter.startLegacyImport().catch((error) => {
+    void agentSessionPresenter.startLegacyImport().catch((error) => {
       console.error('legacyImportHook: failed to start legacy import task:', error)
     })
   }
diff --git a/src/main/presenter/lifecyclePresenter/hooks/after-start/rtkHealthCheckHook.ts b/src/main/presenter/lifecyclePresenter/hooks/after-start/rtkHealthCheckHook.ts
index 7f2deb8b9..3c0f7f495 100644
--- a/src/main/presenter/lifecyclePresenter/hooks/after-start/rtkHealthCheckHook.ts
+++ b/src/main/presenter/lifecyclePresenter/hooks/after-start/rtkHealthCheckHook.ts
@@ -12,14 +12,14 @@ export const rtkHealthCheckHook: LifecycleHook = {
       throw new Error('rtkHealthCheckHook: Presenter not initialized')
     }
 
-    const newAgentPresenter = presenter.newAgentPresenter as unknown as {
+    const agentSessionPresenter = presenter.agentSessionPresenter as unknown as {
       startRtkHealthCheck?: () => Promise<void>
     }
-    if (!newAgentPresenter.startRtkHealthCheck) {
+    if (!agentSessionPresenter.startRtkHealthCheck) {
       return
     }
 
-    void newAgentPresenter.startRtkHealthCheck().catch((error) => {
+    void agentSessionPresenter.startRtkHealthCheck().catch((error) => {
       console.error('rtkHealthCheckHook: failed to start RTK health check:', error)
     })
   }
diff --git a/src/main/presenter/lifecyclePresenter/hooks/after-start/usageStatsBackfillHook.ts b/src/main/presenter/lifecyclePresenter/hooks/after-start/usageStatsBackfillHook.ts
index 178ea261f..6b3b06a42 100644
--- a/src/main/presenter/lifecyclePresenter/hooks/after-start/usageStatsBackfillHook.ts
+++ b/src/main/presenter/lifecyclePresenter/hooks/after-start/usageStatsBackfillHook.ts
@@ -12,14 +12,14 @@ export const usageStatsBackfillHook: LifecycleHook = {
       throw new Error('usageStatsBackfillHook: Presenter not initialized')
     }
 
-    const newAgentPresenter = presenter.newAgentPresenter as unknown as {
+    const agentSessionPresenter = presenter.agentSessionPresenter as unknown as {
       startUsageStatsBackfill?: () => Promise<void>
     }
-    if (!newAgentPresenter.startUsageStatsBackfill) {
+    if (!agentSessionPresenter.startUsageStatsBackfill) {
       return
     }
 
-    void newAgentPresenter.startUsageStatsBackfill().catch((error) => {
+    void agentSessionPresenter.startUsageStatsBackfill().catch((error) => {
       console.error('usageStatsBackfillHook: failed to start usage stats backfill:', error)
     })
   }
diff --git a/src/main/presenter/mcpPresenter/inMemoryServers/conversationSearchServer.ts b/src/main/presenter/mcpPresenter/inMemoryServers/conversationSearchServer.ts
index 85a445624..74306ec15 100644
--- a/src/main/presenter/mcpPresenter/inMemoryServers/conversationSearchServer.ts
+++ b/src/main/presenter/mcpPresenter/inMemoryServers/conversationSearchServer.ts
@@ -266,11 +266,11 @@ export class ConversationSearchServer {
   // 获取对话历史
   private async getConversationHistory(conversationId: string, includeSystem: boolean = false) {
     try {
-      const session = await presenter.newAgentPresenter.getSession(conversationId)
+      const session = await presenter.agentSessionPresenter.getSession(conversationId)
       if (!session) {
         throw new Error(`Session not found: ${conversationId}`)
       }
-      const records = await presenter.newAgentPresenter.getMessages(conversationId)
+      const records = await presenter.agentSessionPresenter.getMessages(conversationId)
 
       const filteredMessages = includeSystem
         ? records
diff --git a/src/main/presenter/mcpPresenter/toolManager.ts b/src/main/presenter/mcpPresenter/toolManager.ts
index 282c04be9..134895241 100644
--- a/src/main/presenter/mcpPresenter/toolManager.ts
+++ b/src/main/presenter/mcpPresenter/toolManager.ts
@@ -281,7 +281,7 @@ export class ToolManager {
     }
 
     try {
-      const session = await presenter.newAgentPresenter.getSession(sessionId)
+      const session = await presenter.agentSessionPresenter.getSession(sessionId)
       const agentId = session?.agentId?.trim()
       const providerId = session?.providerId?.trim()
       if (session && providerId === 'acp' && agentId) {
diff --git a/src/main/presenter/remoteControlPresenter/index.ts b/src/main/presenter/remoteControlPresenter/index.ts
index 96965ff75..8f0c69343 100644
--- a/src/main/presenter/remoteControlPresenter/index.ts
+++ b/src/main/presenter/remoteControlPresenter/index.ts
@@ -683,8 +683,8 @@ export class RemoteControlPresenter {
     return new RemoteConversationRunner(
       {
         configPresenter: this.deps.configPresenter,
-        newAgentPresenter: this.deps.newAgentPresenter,
-        deepchatAgentPresenter: this.deps.deepchatAgentPresenter,
+        agentSessionPresenter: this.deps.agentSessionPresenter,
+        agentRuntimePresenter: this.deps.agentRuntimePresenter,
         windowPresenter: this.deps.windowPresenter,
         tabPresenter: this.deps.tabPresenter,
         resolveDefaultAgentId: async () =>
diff --git a/src/main/presenter/remoteControlPresenter/interface.ts b/src/main/presenter/remoteControlPresenter/interface.ts
index cdcd74b01..63b130564 100644
--- a/src/main/presenter/remoteControlPresenter/interface.ts
+++ b/src/main/presenter/remoteControlPresenter/interface.ts
@@ -2,18 +2,18 @@ import type { HookTestResult, HooksNotificationsSettings } from '@shared/hooksNo
 import type {
   FeishuRemoteSettings,
   IConfigPresenter,
-  INewAgentPresenter,
+  IAgentSessionPresenter,
   IRemoteControlPresenter,
   ITabPresenter,
   IWindowPresenter,
   TelegramRemoteSettings
 } from '@shared/presenter'
-import type { DeepChatAgentPresenter } from '../deepchatAgentPresenter'
+import type { AgentRuntimePresenter } from '../agentRuntimePresenter'
 
 export interface RemoteControlPresenterDeps {
   configPresenter: IConfigPresenter
-  newAgentPresenter: INewAgentPresenter
-  deepchatAgentPresenter: DeepChatAgentPresenter
+  agentSessionPresenter: IAgentSessionPresenter
+  agentRuntimePresenter: AgentRuntimePresenter
   windowPresenter: IWindowPresenter
   tabPresenter: ITabPresenter
   getHooksNotificationsConfig: () => HooksNotificationsSettings
diff --git a/src/main/presenter/remoteControlPresenter/services/remoteConversationRunner.ts b/src/main/presenter/remoteControlPresenter/services/remoteConversationRunner.ts
index 71196f548..82913a99b 100644
--- a/src/main/presenter/remoteControlPresenter/services/remoteConversationRunner.ts
+++ b/src/main/presenter/remoteControlPresenter/services/remoteConversationRunner.ts
@@ -7,12 +7,12 @@ import type {
 import type { SearchResult } from '@shared/types/core/search'
 import type {
   IConfigPresenter,
-  INewAgentPresenter,
+  IAgentSessionPresenter,
   RemoteChannel,
   ITabPresenter,
   IWindowPresenter
 } from '@shared/presenter'
-import type { DeepChatAgentPresenter } from '../../deepchatAgentPresenter'
+import type { AgentRuntimePresenter } from '../../agentRuntimePresenter'
 import {
   TELEGRAM_RECENT_SESSION_LIMIT,
   TELEGRAM_STREAM_POLL_INTERVAL_MS,
@@ -77,8 +77,8 @@ export type RemoteOpenSessionResult =
 
 type RemoteConversationRunnerDeps = {
   configPresenter: IConfigPresenter
-  newAgentPresenter: INewAgentPresenter
-  deepchatAgentPresenter: DeepChatAgentPresenter
+  agentSessionPresenter: IAgentSessionPresenter
+  agentRuntimePresenter: AgentRuntimePresenter
   windowPresenter: IWindowPresenter
   tabPresenter: ITabPresenter
   resolveDefaultAgentId: () => Promise<string>
@@ -113,7 +113,7 @@ export class RemoteConversationRunner {
       )
     }
 
-    const session = await this.deps.newAgentPresenter.createDetachedSession({
+    const session = await this.deps.agentSessionPresenter.createDetachedSession({
       title: title?.trim() || 'New Chat',
       agentId,
       ...(agentType === 'acp'
@@ -138,7 +138,7 @@ export class RemoteConversationRunner {
       return null
     }
 
-    const session = await this.deps.newAgentPresenter.getSession(binding.sessionId)
+    const session = await this.deps.agentSessionPresenter.getSession(binding.sessionId)
     if (!session) {
       this.bindingStore.clearBinding(endpointKey)
       return null
@@ -161,7 +161,7 @@ export class RemoteConversationRunner {
 
   async listSessions(endpointKey: string): Promise<SessionWithState[]> {
     const agentId = await this.resolveSessionListAgentId(endpointKey)
-    const sessions = await this.deps.newAgentPresenter.getSessionList({
+    const sessions = await this.deps.agentSessionPresenter.getSessionList({
       agentId
     })
     const sorted = [...sessions]
@@ -189,7 +189,7 @@ export class RemoteConversationRunner {
       throw new Error('Session index is out of range.')
     }
 
-    const session = await this.deps.newAgentPresenter.getSession(sessionId)
+    const session = await this.deps.agentSessionPresenter.getSession(sessionId)
     if (!session) {
       throw new Error('Selected session no longer exists.')
     }
@@ -231,7 +231,7 @@ export class RemoteConversationRunner {
       throw new Error('No bound session. Send a message, /new, or /use first.')
     }
 
-    return await this.deps.newAgentPresenter.setSessionModel(session.id, providerId, modelId)
+    return await this.deps.agentSessionPresenter.setSessionModel(session.id, providerId, modelId)
   }
 
   async sendText(
@@ -240,12 +240,12 @@ export class RemoteConversationRunner {
     bindingMeta?: RemoteEndpointBindingMeta
   ): Promise<RemoteConversationExecution> {
     const session = await this.ensureBoundSession(endpointKey, bindingMeta)
-    const beforeMessages = await this.deps.newAgentPresenter.getMessages(session.id)
+    const beforeMessages = await this.deps.agentSessionPresenter.getMessages(session.id)
     const lastOrderSeq = beforeMessages.at(-1)?.orderSeq ?? 0
     const previousActiveEventId =
-      this.deps.deepchatAgentPresenter.getActiveGeneration(session.id)?.eventId ?? null
+      this.deps.agentRuntimePresenter.getActiveGeneration(session.id)?.eventId ?? null
 
-    await this.deps.newAgentPresenter.sendMessage(session.id, text)
+    await this.deps.agentSessionPresenter.sendMessage(session.id, text)
 
     const seededMessage = await this.waitForAssistantMessage(session.id, lastOrderSeq, 800, {
       ignoreMessageId: previousActiveEventId
@@ -293,7 +293,7 @@ export class RemoteConversationRunner {
       throw new Error('No pending interaction was found.')
     }
 
-    const result = await this.deps.newAgentPresenter.respondToolInteraction(
+    const result = await this.deps.agentSessionPresenter.respondToolInteraction(
       session.id,
       interaction.messageId,
       interaction.toolCallId,
@@ -327,14 +327,14 @@ export class RemoteConversationRunner {
 
     const activeEventId =
       this.bindingStore.getActiveEvent(endpointKey) ??
-      this.deps.deepchatAgentPresenter.getActiveGeneration(session.id)?.eventId ??
+      this.deps.agentRuntimePresenter.getActiveGeneration(session.id)?.eventId ??
       null
 
     if (!activeEventId) {
       return false
     }
 
-    const stopped = await this.deps.deepchatAgentPresenter.cancelGenerationByEventId(
+    const stopped = await this.deps.agentRuntimePresenter.cancelGenerationByEventId(
       session.id,
       activeEventId
     )
@@ -359,7 +359,7 @@ export class RemoteConversationRunner {
       }
     }
 
-    await this.deps.newAgentPresenter.activateSession(window.webContents.id, session.id)
+    await this.deps.agentSessionPresenter.activateSession(window.webContents.id, session.id)
     this.deps.windowPresenter.show(window.id, true)
     return {
       status: 'ok',
@@ -382,7 +382,7 @@ export class RemoteConversationRunner {
 
     const activeEventId =
       this.bindingStore.getActiveEvent(endpointKey) ??
-      this.deps.deepchatAgentPresenter.getActiveGeneration(session.id)?.eventId ??
+      this.deps.agentRuntimePresenter.getActiveGeneration(session.id)?.eventId ??
       null
 
     return {
@@ -454,7 +454,7 @@ export class RemoteConversationRunner {
       ignoreMessageId: string | null
     }
   ): Promise<RemoteConversationSnapshot> {
-    const session = await this.deps.newAgentPresenter.getSession(sessionId)
+    const session = await this.deps.agentSessionPresenter.getSession(sessionId)
     if (!session) {
       this.bindingStore.clearBinding(endpointKey)
       return {
@@ -470,7 +470,7 @@ export class RemoteConversationRunner {
       }
     }
 
-    const activeGeneration = this.deps.deepchatAgentPresenter.getActiveGeneration(sessionId)
+    const activeGeneration = this.deps.agentRuntimePresenter.getActiveGeneration(sessionId)
     const trackedMessage = await this.resolveTrackedAssistantMessage(
       sessionId,
       tracking,
@@ -547,12 +547,12 @@ export class RemoteConversationRunner {
   }
 
   private async loadSearchResults(messageId: string, searchId?: string): Promise<SearchResult[]> {
-    if (typeof this.deps.newAgentPresenter.getSearchResults !== 'function') {
+    if (typeof this.deps.agentSessionPresenter.getSearchResults !== 'function') {
       return []
     }
 
     try {
-      return await this.deps.newAgentPresenter.getSearchResults(messageId, searchId)
+      return await this.deps.agentSessionPresenter.getSearchResults(messageId, searchId)
     } catch (error) {
       console.warn('[RemoteConversationRunner] Failed to load search results:', {
         messageId,
@@ -573,9 +573,9 @@ export class RemoteConversationRunner {
   ): Promise<ChatMessageRecord | null> {
     const deadline = Date.now() + timeoutMs
     while (Date.now() < deadline) {
-      const activeGeneration = this.deps.deepchatAgentPresenter.getActiveGeneration(sessionId)
+      const activeGeneration = this.deps.agentRuntimePresenter.getActiveGeneration(sessionId)
       if (activeGeneration?.eventId && activeGeneration.eventId !== options?.ignoreMessageId) {
-        const message = await this.deps.newAgentPresenter.getMessage(activeGeneration.eventId)
+        const message = await this.deps.agentSessionPresenter.getMessage(activeGeneration.eventId)
         if (message?.role === 'assistant') {
           return message
         }
@@ -611,7 +611,7 @@ export class RemoteConversationRunner {
         continue
       }
 
-      const message = await this.deps.newAgentPresenter.getMessage(messageId)
+      const message = await this.deps.agentSessionPresenter.getMessage(messageId)
       if (message?.role === 'assistant') {
         return message
       }
@@ -629,7 +629,7 @@ export class RemoteConversationRunner {
     afterOrderSeq: number,
     ignoreMessageId?: string | null
   ): Promise<ChatMessageRecord | null> {
-    const messages = await this.deps.newAgentPresenter.getMessages(sessionId)
+    const messages = await this.deps.agentSessionPresenter.getMessages(sessionId)
     const assistants = messages.filter(
       (message) =>
         message.role === 'assistant' &&
@@ -662,7 +662,7 @@ export class RemoteConversationRunner {
   private async getCurrentPendingInteractionDetails(
     sessionId: string
   ): Promise<PendingInteractionDetails | null> {
-    const messages = await this.deps.newAgentPresenter.getMessages(sessionId)
+    const messages = await this.deps.agentSessionPresenter.getMessages(sessionId)
     const assistants = [...messages]
       .filter((message) => message.role === 'assistant')
       .sort((left, right) => right.orderSeq - left.orderSeq)
diff --git a/src/main/presenter/sqlitePresenter/index.ts b/src/main/presenter/sqlitePresenter/index.ts
index e1cf019fb..e3ff5e9b6 100644
--- a/src/main/presenter/sqlitePresenter/index.ts
+++ b/src/main/presenter/sqlitePresenter/index.ts
@@ -323,7 +323,7 @@ export class SQLitePresenter implements ISQLitePresenter {
     importedMessages: number
     importedSearchResults: number
   }> {
-    const { LegacyChatImportService } = await import('../newAgentPresenter/legacyImportService')
+    const { LegacyChatImportService } = await import('../agentSessionPresenter/legacyImportService')
     const service = new LegacyChatImportService(this)
     return await service.importFromSourceDb(sourceDbPath, mode)
   }
diff --git a/src/main/presenter/toolPresenter/runtimePorts.ts b/src/main/presenter/toolPresenter/runtimePorts.ts
index 12f52266e..84d7cd529 100644
--- a/src/main/presenter/toolPresenter/runtimePorts.ts
+++ b/src/main/presenter/toolPresenter/runtimePorts.ts
@@ -13,7 +13,7 @@ import type {
   SessionKind
 } from '@shared/types/agent-interface'
 import type { ISkillPresenter } from '@shared/types/skill'
-import type { DeepChatInternalSessionUpdate } from '../deepchatAgentPresenter/internalSessionEvents'
+import type { DeepChatInternalSessionUpdate } from '../agentRuntimePresenter/internalSessionEvents'
 
 export interface ConversationSessionInfo {
   sessionId: string
diff --git a/src/renderer/settings/components/DashboardSettings.vue b/src/renderer/settings/components/DashboardSettings.vue
index 9a3278e77..f4ebcd474 100644
--- a/src/renderer/settings/components/DashboardSettings.vue
+++ b/src/renderer/settings/components/DashboardSettings.vue
@@ -718,7 +718,7 @@ type NostalgiaDetailItem = {
 }
 
 const { t, locale } = useI18n()
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 
 const isLoading = ref(true)
 const isRetryingRtk = ref(false)
@@ -1044,7 +1044,7 @@ async function loadDashboard(): Promise<void> {
   try {
     isLoading.value = true
     errorMessage.value = ''
-    const nextDashboard = await newAgentPresenter.getUsageDashboard()
+    const nextDashboard = await agentSessionPresenter.getUsageDashboard()
     if (!isDashboardMounted) {
       return
     }
@@ -1073,7 +1073,7 @@ async function retryRtkHealthCheck(): Promise<void> {
 
   try {
     isRetryingRtk.value = true
-    await newAgentPresenter.retryRtkHealthCheck()
+    await agentSessionPresenter.retryRtkHealthCheck()
     await loadDashboard()
   } catch (error) {
     errorMessage.value =
diff --git a/src/renderer/settings/components/RemoteSettings.vue b/src/renderer/settings/components/RemoteSettings.vue
index 069c2a943..07677bade 100644
--- a/src/renderer/settings/components/RemoteSettings.vue
+++ b/src/renderer/settings/components/RemoteSettings.vue
@@ -896,7 +896,7 @@ import type {
 
 const channels: RemoteChannel[] = ['telegram', 'feishu']
 const remoteControlPresenter = useRemoteControlPresenter()
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const projectPresenter = usePresenter('projectPresenter')
 const { t } = useI18n()
 const { toast } = useToast()
@@ -1331,7 +1331,7 @@ const refreshPairingSnapshot = async (channel: RemoteChannel): Promise<RemotePai
 }
 
 const loadAvailableAgents = async () => {
-  availableAgents.value = await newAgentPresenter.getAgents()
+  availableAgents.value = await agentSessionPresenter.getAgents()
 }
 
 const loadRecentProjects = async () => {
diff --git a/src/renderer/src/components/chat-input/McpIndicator.vue b/src/renderer/src/components/chat-input/McpIndicator.vue
index 42bf21e32..55881a1f2 100644
--- a/src/renderer/src/components/chat-input/McpIndicator.vue
+++ b/src/renderer/src/components/chat-input/McpIndicator.vue
@@ -295,7 +295,7 @@ const agentStore = useAgentStore()
 const projectStore = useProjectStore()
 const windowPresenter = usePresenter('windowPresenter')
 const toolPresenter = usePresenter('toolPresenter')
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 
 const panelOpen = ref(false)
 const toolsLoading = ref(false)
@@ -503,7 +503,7 @@ const loadDeepchatTools = async () => {
         agentWorkspacePath: workspacePath.value
       }),
       deepchatSessionId.value
-        ? newAgentPresenter.getSessionDisabledAgentTools(deepchatSessionId.value)
+        ? agentSessionPresenter.getSessionDisabledAgentTools(deepchatSessionId.value)
         : Promise.resolve([...draftStore.disabledAgentTools])
     ])
 
@@ -554,7 +554,7 @@ const persistDisabledTools = async (nextList: string[], affectedToolNames: strin
 
   setToolsPending(affectedToolNames, true)
   try {
-    const persisted = await newAgentPresenter.updateSessionDisabledAgentTools(
+    const persisted = await agentSessionPresenter.updateSessionDisabledAgentTools(
       deepchatSessionId.value,
       nextList
     )
diff --git a/src/renderer/src/components/chat/ChatStatusBar.vue b/src/renderer/src/components/chat/ChatStatusBar.vue
index e398d486b..bcd1228a4 100644
--- a/src/renderer/src/components/chat/ChatStatusBar.vue
+++ b/src/renderer/src/components/chat/ChatStatusBar.vue
@@ -817,7 +817,7 @@ const draftStore = useDraftStore()
 const projectStore = useProjectStore()
 const configPresenter = usePresenter('configPresenter')
 const llmproviderPresenter = usePresenter('llmproviderPresenter')
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const { t } = useI18n()
 
 const draftModelSelection = ref<ModelSelection | null>(null)
@@ -1898,7 +1898,7 @@ const flushGenerationPatch = async () => {
   const requestToken = ++generationPersistRequestToken
   const localRevisionAtRequest = generationLocalRevision
   try {
-    const updated = await newAgentPresenter.updateSessionGenerationSettings(sessionId, patch)
+    const updated = await agentSessionPresenter.updateSessionGenerationSettings(sessionId, patch)
     if (requestToken !== generationPersistRequestToken) {
       return
     }
@@ -2003,7 +2003,7 @@ const syncGenerationSettings = async () => {
   const sessionId = sessionStore.activeSessionId
   if (sessionId) {
     try {
-      const settings = await newAgentPresenter.getSessionGenerationSettings(sessionId)
+      const settings = await agentSessionPresenter.getSessionGenerationSettings(sessionId)
       if (token !== generationSyncToken) {
         return
       }
@@ -2060,7 +2060,7 @@ const syncAcpConfigOptions = async () => {
     acpConfigLoadedRequestKey.value = null
 
     try {
-      const state = await newAgentPresenter.getAcpSessionConfigOptions(activeAcpSessionId.value)
+      const state = await agentSessionPresenter.getAcpSessionConfigOptions(activeAcpSessionId.value)
       if (token !== acpConfigSyncToken || acpConfigRequestKey.value !== requestKey) {
         return
       }
@@ -2144,7 +2144,11 @@ const updateAcpConfigOption = async (configId: string, value: string | boolean)
 
   acpOptionSavingIds.value = [...acpOptionSavingIds.value, configId]
   try {
-    const updated = await newAgentPresenter.setAcpSessionConfigOption(sessionId, configId, value)
+    const updated = await agentSessionPresenter.setAcpSessionConfigOption(
+      sessionId,
+      configId,
+      value
+    )
     setCachedAcpConfigState(agentId, updated)
     if (activeAcpSessionId.value !== sessionId) {
       return
@@ -2228,7 +2232,7 @@ watch(
     }
 
     try {
-      const mode = await newAgentPresenter.getPermissionMode(sessionId)
+      const mode = await agentSessionPresenter.getPermissionMode(sessionId)
       if (token !== permissionSyncToken) return
       permissionMode.value = mode === 'default' ? 'default' : 'full_access'
     } catch (error) {
@@ -2706,7 +2710,7 @@ async function selectPermissionMode(mode: PermissionMode) {
     return
   }
   try {
-    await newAgentPresenter.setPermissionMode(sessionId, mode)
+    await agentSessionPresenter.setPermissionMode(sessionId, mode)
   } catch (error) {
     console.warn('[ChatStatusBar] Failed to set permission mode:', error)
   }
diff --git a/src/renderer/src/components/chat/composables/useChatInputMentions.ts b/src/renderer/src/components/chat/composables/useChatInputMentions.ts
index 92f1de34a..90e37dd51 100644
--- a/src/renderer/src/components/chat/composables/useChatInputMentions.ts
+++ b/src/renderer/src/components/chat/composables/useChatInputMentions.ts
@@ -85,7 +85,7 @@ const normalizeAcpCommands = (commands: unknown): AcpSessionCommand[] => {
 
 export function useChatInputMentions(options: UseChatInputMentionsOptions) {
   const workspacePresenter = usePresenter('workspacePresenter')
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
   const skillPresenter = usePresenter('skillPresenter')
   const mcpStore = useMcpStore()
   const skillsStore = useSkillsStore()
@@ -237,7 +237,7 @@ export function useChatInputMentions(options: UseChatInputMentionsOptions) {
     }
 
     try {
-      const commands = await newAgentPresenter.getAcpSessionCommands(sessionId)
+      const commands = await agentSessionPresenter.getAcpSessionCommands(sessionId)
       if (fetchSeq !== acpCommandFetchSeq.value) {
         return
       }
diff --git a/src/renderer/src/components/markdown/MarkdownRenderer.vue b/src/renderer/src/components/markdown/MarkdownRenderer.vue
index 25a00d87c..586755066 100644
--- a/src/renderer/src/components/markdown/MarkdownRenderer.vue
+++ b/src/renderer/src/components/markdown/MarkdownRenderer.vue
@@ -41,7 +41,7 @@ const artifactStore = useArtifactStore()
 const fallbackMessageId = `artifact-msg-${nanoid()}`
 const fallbackThreadId = `artifact-thread-${nanoid()}`
 const referenceStore = useReferenceStore()
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const referenceNode = ref<HTMLElement | null>(null)
 const debouncedContent = ref(props.content)
 const effectiveMessageId = computed(() => props.messageId ?? fallbackMessageId)
@@ -76,7 +76,7 @@ setCustomComponents({
       threadId: effectiveThreadId.value,
       onClick() {
         // TODO: remove this temporary fallback after search result loading is fully unified.
-        newAgentPresenter.getSearchResults(effectiveMessageId.value).then((results) => {
+        agentSessionPresenter.getSearchResults(effectiveMessageId.value).then((results) => {
           const index = parseInt(_props.node.id)
           if (index < results.length) {
             window.open(results[index - 1].url, '_blank', 'noopener,noreferrer')
@@ -86,7 +86,7 @@ setCustomComponents({
       onMouseEnter() {
         console.log('Mouse entered')
         referenceStore.hideReference()
-        newAgentPresenter.getSearchResults(effectiveMessageId.value).then((results) => {
+        agentSessionPresenter.getSearchResults(effectiveMessageId.value).then((results) => {
           const index = parseInt(_props.node.id)
           if (index - 1 < results.length && referenceNode.value) {
             referenceStore.showReference(
diff --git a/src/renderer/src/components/message/MessageBlockContent.vue b/src/renderer/src/components/message/MessageBlockContent.vue
index 13674b5d5..acf368b20 100644
--- a/src/renderer/src/components/message/MessageBlockContent.vue
+++ b/src/renderer/src/components/message/MessageBlockContent.vue
@@ -34,7 +34,7 @@ import { ref, nextTick, watch, onMounted } from 'vue'
 import { usePresenter } from '@/composables/usePresenter'
 import type { SearchResult } from '@shared/types/core/search'
 
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const searchResults = ref<SearchResult[]>([])
 
 import ArtifactThinking from '../artifacts/ArtifactThinking.vue'
@@ -104,7 +104,7 @@ watch(
 onMounted(async () => {
   if (props.isSearchResult) {
     // TODO: remove this temporary fallback after search result loading is fully unified.
-    searchResults.value = await newAgentPresenter.getSearchResults(props.messageId)
+    searchResults.value = await agentSessionPresenter.getSearchResults(props.messageId)
   }
 })
 </script>
diff --git a/src/renderer/src/components/popup/TranslatePopup.vue b/src/renderer/src/components/popup/TranslatePopup.vue
index c3b267d9c..513d5e5e6 100644
--- a/src/renderer/src/components/popup/TranslatePopup.vue
+++ b/src/renderer/src/components/popup/TranslatePopup.vue
@@ -44,7 +44,7 @@ import { Button } from '@shadcn/components/ui/button'
 import { Icon } from '@iconify/vue'
 
 const { t, locale } = useI18n()
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const agentStore = useAgentStore()
 
 // 状态
@@ -127,7 +127,7 @@ const handleTranslateRequest = async (event: Event) => {
   translatedText.value = ''
 
   try {
-    const result = await newAgentPresenter.translateText(
+    const result = await agentSessionPresenter.translateText(
       newText,
       locale.value,
       agentStore.selectedAgentId ?? 'deepchat'
diff --git a/src/renderer/src/components/trace/TraceDialog.vue b/src/renderer/src/components/trace/TraceDialog.vue
index 0af594f5f..7a0771cb1 100644
--- a/src/renderer/src/components/trace/TraceDialog.vue
+++ b/src/renderer/src/components/trace/TraceDialog.vue
@@ -100,7 +100,7 @@ import { useUiSettingsStore } from '@/stores/uiSettingsStore'
 import type { MessageTraceRecord } from '@shared/types/agent-interface'
 
 const { t } = useI18n()
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const uiSettingsStore = useUiSettingsStore()
 
 const jsonEditor = ref<HTMLElement | null>(null)
@@ -274,7 +274,7 @@ const loadTraces = async (messageId: string) => {
   selectedTraceId.value = null
 
   try {
-    const result = await newAgentPresenter.listMessageTraces(messageId)
+    const result = await agentSessionPresenter.listMessageTraces(messageId)
     if (currentRequestId !== requestId.value) {
       return
     }
diff --git a/src/renderer/src/pages/ChatPage.vue b/src/renderer/src/pages/ChatPage.vue
index 494fa2f7c..78e2114ae 100644
--- a/src/renderer/src/pages/ChatPage.vue
+++ b/src/renderer/src/pages/ChatPage.vue
@@ -150,7 +150,7 @@ const messageStore = useMessageStore()
 const pendingInputStore = usePendingInputStore()
 const spotlightStore = useSpotlightStore()
 const modelStore = useModelStore()
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const { t } = useI18n()
 
 const sessionTitle = computed(() => sessionStore.activeSession?.title ?? t('common.newChat'))
@@ -814,7 +814,7 @@ async function onToolInteractionRespond(response: ToolInteractionResponse) {
 
   isHandlingInteraction.value = true
   try {
-    await newAgentPresenter.respondToolInteraction(
+    await agentSessionPresenter.respondToolInteraction(
       interaction.sessionId,
       interaction.messageId,
       interaction.toolCallId,
@@ -832,7 +832,7 @@ async function onStop() {
   if (isReadOnlySession.value) return
   if (!isGenerating.value) return
   try {
-    await newAgentPresenter.cancelGeneration(props.sessionId)
+    await agentSessionPresenter.cancelGeneration(props.sessionId)
   } catch (error) {
     console.error('[ChatPage] cancel generation failed:', error)
   }
@@ -844,7 +844,7 @@ async function onMessageRetry(messageId: string) {
   if (activePendingInteraction.value || isHandlingInteraction.value) return
   try {
     messageStore.clearStreamingState()
-    await newAgentPresenter.retryMessage(props.sessionId, messageId)
+    await agentSessionPresenter.retryMessage(props.sessionId, messageId)
   } catch (error) {
     console.error('[ChatPage] retry message failed:', error)
     await messageStore.loadMessages(props.sessionId)
@@ -856,7 +856,7 @@ async function onMessageDelete(messageId: string) {
   if (!messageId) return
   try {
     messageStore.clearStreamingState()
-    await newAgentPresenter.deleteMessage(props.sessionId, messageId)
+    await agentSessionPresenter.deleteMessage(props.sessionId, messageId)
     await messageStore.loadMessages(props.sessionId)
   } catch (error) {
     console.error('[ChatPage] delete message failed:', error)
@@ -870,7 +870,7 @@ async function onMessageEditSave(payload: { messageId: string; text: string }) {
   if (!messageId || !text) return
 
   try {
-    await newAgentPresenter.editUserMessage(props.sessionId, messageId, text)
+    await agentSessionPresenter.editUserMessage(props.sessionId, messageId, text)
     await onMessageRetry(messageId)
   } catch (error) {
     console.error('[ChatPage] edit message failed:', error)
@@ -881,7 +881,7 @@ async function onMessageFork(messageId: string) {
   if (isReadOnlySession.value) return
   if (!messageId) return
   try {
-    const forked = await newAgentPresenter.forkSession(props.sessionId, messageId)
+    const forked = await agentSessionPresenter.forkSession(props.sessionId, messageId)
     await sessionStore.fetchSessions()
     await sessionStore.selectSession(forked.id)
   } catch (error) {
@@ -894,7 +894,7 @@ async function onMessageContinue(_conversationId: string, messageId: string) {
   if (!messageId) return
   try {
     messageStore.clearStreamingState()
-    await newAgentPresenter.retryMessage(props.sessionId, messageId)
+    await agentSessionPresenter.retryMessage(props.sessionId, messageId)
   } catch (error) {
     console.error('[ChatPage] continue message failed:', error)
     await messageStore.loadMessages(props.sessionId)
diff --git a/src/renderer/src/pages/NewThreadPage.vue b/src/renderer/src/pages/NewThreadPage.vue
index 28534f81f..47329e395 100644
--- a/src/renderer/src/pages/NewThreadPage.vue
+++ b/src/renderer/src/pages/NewThreadPage.vue
@@ -117,7 +117,7 @@ const agentStore = useAgentStore()
 const modelStore = useModelStore()
 const draftStore = useDraftStore()
 const configPresenter = usePresenter('configPresenter')
-const newAgentPresenter = usePresenter('newAgentPresenter')
+const agentSessionPresenter = usePresenter('agentSessionPresenter')
 const { t } = useI18n()
 
 const message = ref('')
@@ -459,7 +459,7 @@ const ensureAcpDraftSession = async (agentId: string, projectPath: string) => {
   const requestSeq = ++acpDraftRequestSeq.value
 
   try {
-    const session = await newAgentPresenter.ensureAcpDraftSession({
+    const session = await agentSessionPresenter.ensureAcpDraftSession({
       agentId,
       projectDir,
       permissionMode: draftStore.permissionMode
diff --git a/src/renderer/src/stores/ui/agent.ts b/src/renderer/src/stores/ui/agent.ts
index adc6491eb..203fd7856 100644
--- a/src/renderer/src/stores/ui/agent.ts
+++ b/src/renderer/src/stores/ui/agent.ts
@@ -24,7 +24,7 @@ export interface UIAgent {
 // --- Store ---
 
 export const useAgentStore = defineStore('agent', () => {
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
 
   // --- State ---
   const agents = ref<UIAgent[]>([])
@@ -42,7 +42,7 @@ export const useAgentStore = defineStore('agent', () => {
     loading.value = true
     error.value = null
     try {
-      const result: Agent[] = await newAgentPresenter.getAgents()
+      const result: Agent[] = await agentSessionPresenter.getAgents()
       agents.value = result.map((a) => ({
         id: a.id,
         name: a.name,
diff --git a/src/renderer/src/stores/ui/message.ts b/src/renderer/src/stores/ui/message.ts
index f62ff1f01..50bbc253e 100644
--- a/src/renderer/src/stores/ui/message.ts
+++ b/src/renderer/src/stores/ui/message.ts
@@ -15,7 +15,7 @@ const EPHEMERAL_STREAM_MESSAGE_PREFIXES = ['__rate_limit__:']
 // --- Store ---
 
 export const useMessageStore = defineStore('message', () => {
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
   const streamStateStore = useStreamStateStore()
 
   // --- State ---
@@ -48,7 +48,7 @@ export const useMessageStore = defineStore('message', () => {
   async function loadMessages(sessionId: string): Promise<void> {
     const requestId = ++latestLoadRequestId
     try {
-      const result = await newAgentPresenter.getMessages(sessionId)
+      const result = await agentSessionPresenter.getMessages(sessionId)
       if (requestId !== latestLoadRequestId) {
         return
       }
@@ -69,7 +69,7 @@ export const useMessageStore = defineStore('message', () => {
     if (cached) return cached
 
     try {
-      const msg = await newAgentPresenter.getMessage(id)
+      const msg = await agentSessionPresenter.getMessage(id)
       if (msg) {
         messageCache.value.set(msg.id, msg)
       }
@@ -146,7 +146,7 @@ export const useMessageStore = defineStore('message', () => {
     if (hydratingStreamMessageIds.has(messageId)) return
     hydratingStreamMessageIds.add(messageId)
 
-    void newAgentPresenter
+    void agentSessionPresenter
       .getMessage(messageId)
       .then((fetched) => {
         if (!fetched || fetched.sessionId !== conversationId) return
diff --git a/src/renderer/src/stores/ui/pageRouter.ts b/src/renderer/src/stores/ui/pageRouter.ts
index 01c0e3306..0777c2067 100644
--- a/src/renderer/src/stores/ui/pageRouter.ts
+++ b/src/renderer/src/stores/ui/pageRouter.ts
@@ -8,7 +8,7 @@ type GoToNewThreadOptions = {
 }
 
 export const usePageRouterStore = defineStore('pageRouter', () => {
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
 
   // --- State ---
   const route = ref<PageRoute>({ name: 'newThread' })
@@ -19,11 +19,11 @@ export const usePageRouterStore = defineStore('pageRouter', () => {
 
   async function initialize(): Promise<void> {
     try {
-      // 1. Check for active new-agent session on this window content first
+      // 1. Check for the active agent session on this webContents first
       const webContentsId = window.api.getWebContentsId()
-      const activeNewSession = await newAgentPresenter.getActiveSession(webContentsId)
-      if (activeNewSession) {
-        route.value = { name: 'chat', sessionId: activeNewSession.id }
+      const activeAgentSession = await agentSessionPresenter.getActiveSession(webContentsId)
+      if (activeAgentSession) {
+        route.value = { name: 'chat', sessionId: activeAgentSession.id }
         return
       }
 
diff --git a/src/renderer/src/stores/ui/pendingInput.ts b/src/renderer/src/stores/ui/pendingInput.ts
index 342aaa4ba..fa77ac132 100644
--- a/src/renderer/src/stores/ui/pendingInput.ts
+++ b/src/renderer/src/stores/ui/pendingInput.ts
@@ -7,7 +7,7 @@ import type { PendingSessionInputRecord, SendMessageInput } from '@shared/types/
 const MAX_PENDING_INPUTS = 5
 
 export const usePendingInputStore = defineStore('pendingInput', () => {
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
 
   const currentSessionId = ref<string | null>(null)
   const items = ref<PendingSessionInputRecord[]>([])
@@ -29,7 +29,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
     loading.value = true
     error.value = null
     try {
-      const loadedItems = await newAgentPresenter.listPendingInputs(requestedId)
+      const loadedItems = await agentSessionPresenter.listPendingInputs(requestedId)
       if (requestedId !== currentSessionId.value) {
         return
       }
@@ -49,7 +49,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
   async function queueInput(sessionId: string, input: string | SendMessageInput): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.queuePendingInput(sessionId, input)
+      await agentSessionPresenter.queuePendingInput(sessionId, input)
       if (currentSessionId.value === sessionId) {
         await loadPendingInputs(sessionId)
       }
@@ -66,7 +66,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
   ): Promise<void> {
     error.value = null
     try {
-      const updated = await newAgentPresenter.updateQueuedInput(sessionId, itemId, input)
+      const updated = await agentSessionPresenter.updateQueuedInput(sessionId, itemId, input)
       items.value = items.value.map((item) => (item.id === updated.id ? updated : item))
       if (currentSessionId.value === sessionId) {
         await loadPendingInputs(sessionId)
@@ -80,7 +80,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
   async function moveQueueInput(sessionId: string, itemId: string, toIndex: number): Promise<void> {
     error.value = null
     try {
-      items.value = await newAgentPresenter.moveQueuedInput(sessionId, itemId, toIndex)
+      items.value = await agentSessionPresenter.moveQueuedInput(sessionId, itemId, toIndex)
     } catch (e) {
       error.value = `Failed to reorder queued message: ${e}`
       throw e
@@ -90,7 +90,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
   async function convertToSteer(sessionId: string, itemId: string): Promise<void> {
     error.value = null
     try {
-      const updated = await newAgentPresenter.convertPendingInputToSteer(sessionId, itemId)
+      const updated = await agentSessionPresenter.convertPendingInputToSteer(sessionId, itemId)
       items.value = items.value.map((item) => (item.id === updated.id ? updated : item))
       if (currentSessionId.value === sessionId) {
         await loadPendingInputs(sessionId)
@@ -104,7 +104,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
   async function deleteInput(sessionId: string, itemId: string): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.deletePendingInput(sessionId, itemId)
+      await agentSessionPresenter.deletePendingInput(sessionId, itemId)
       items.value = items.value.filter((item) => item.id !== itemId)
     } catch (e) {
       error.value = `Failed to delete queued message: ${e}`
@@ -115,7 +115,7 @@ export const usePendingInputStore = defineStore('pendingInput', () => {
   async function resumeQueue(sessionId: string): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.resumePendingQueue(sessionId)
+      await agentSessionPresenter.resumePendingQueue(sessionId)
       if (currentSessionId.value === sessionId) {
         await loadPendingInputs(sessionId)
       }
diff --git a/src/renderer/src/stores/ui/session.ts b/src/renderer/src/stores/ui/session.ts
index 5a22c8efa..0d98c17e9 100644
--- a/src/renderer/src/stores/ui/session.ts
+++ b/src/renderer/src/stores/ui/session.ts
@@ -157,7 +157,7 @@ function getContentType(format: 'markdown' | 'html' | 'txt' | 'nowledge-mem'): s
 // --- Store ---
 
 export const useSessionStore = defineStore('session', () => {
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
   const tabPresenter = usePresenter('tabPresenter')
   const pageRouter = usePageRouterStore()
   const messageStore = useMessageStore()
@@ -197,8 +197,8 @@ export const useSessionStore = defineStore('session', () => {
       const webContentsId = getCurrentWebContentsId()
       const previousActiveSessionId = activeSessionId.value
       const [result, activeSession] = await Promise.all([
-        newAgentPresenter.getSessionList({ includeSubagents: true }),
-        newAgentPresenter.getActiveSession(webContentsId)
+        agentSessionPresenter.getSessionList({ includeSubagents: true }),
+        agentSessionPresenter.getActiveSession(webContentsId)
       ])
       sessions.value = result.map(mapToUISession)
 
@@ -223,7 +223,7 @@ export const useSessionStore = defineStore('session', () => {
     error.value = null
     try {
       const webContentsId = getCurrentWebContentsId()
-      const session = await newAgentPresenter.createSession(input, webContentsId)
+      const session = await agentSessionPresenter.createSession(input, webContentsId)
       activeSessionId.value = session.id
 
       await fetchSessions()
@@ -240,7 +240,7 @@ export const useSessionStore = defineStore('session', () => {
         messageStore.clearStreamingState()
       }
       const webContentsId = getCurrentWebContentsId()
-      await newAgentPresenter.activateSession(webContentsId, sessionId)
+      await agentSessionPresenter.activateSession(webContentsId, sessionId)
       activeSessionId.value = sessionId
       pageRouter.goToChat(sessionId)
     } catch (e) {
@@ -253,7 +253,7 @@ export const useSessionStore = defineStore('session', () => {
     try {
       messageStore.clearStreamingState()
       const webContentsId = getCurrentWebContentsId()
-      await newAgentPresenter.deactivateSession(webContentsId)
+      await agentSessionPresenter.deactivateSession(webContentsId)
       activeSessionId.value = null
       pageRouter.goToNewThread()
     } catch (e) {
@@ -264,7 +264,7 @@ export const useSessionStore = defineStore('session', () => {
   async function sendMessage(sessionId: string, content: string | SendMessageInput): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.sendMessage(sessionId, content)
+      await agentSessionPresenter.sendMessage(sessionId, content)
     } catch (e) {
       error.value = `Failed to send message: ${e}`
     }
@@ -277,7 +277,7 @@ export const useSessionStore = defineStore('session', () => {
   ): Promise<void> {
     error.value = null
     try {
-      const updated = await newAgentPresenter.setSessionModel(sessionId, providerId, modelId)
+      const updated = await agentSessionPresenter.setSessionModel(sessionId, providerId, modelId)
       const index = sessions.value.findIndex((item) => item.id === sessionId)
       if (index >= 0) {
         sessions.value[index] = mapToUISession(updated)
@@ -291,7 +291,7 @@ export const useSessionStore = defineStore('session', () => {
   async function deleteSession(sessionId: string): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.deleteSession(sessionId)
+      await agentSessionPresenter.deleteSession(sessionId)
       if (activeSessionId.value === sessionId) {
         activeSessionId.value = null
         pageRouter.goToNewThread()
@@ -305,7 +305,7 @@ export const useSessionStore = defineStore('session', () => {
   async function setSessionSubagentEnabled(sessionId: string, enabled: boolean): Promise<void> {
     error.value = null
     try {
-      const updated = await newAgentPresenter.setSessionSubagentEnabled(sessionId, enabled)
+      const updated = await agentSessionPresenter.setSessionSubagentEnabled(sessionId, enabled)
       const index = sessions.value.findIndex((item) => item.id === sessionId)
       if (index >= 0) {
         sessions.value[index] = mapToUISession(updated)
@@ -325,7 +325,7 @@ export const useSessionStore = defineStore('session', () => {
       if (!normalized) {
         return
       }
-      await newAgentPresenter.renameSession(sessionId, normalized)
+      await agentSessionPresenter.renameSession(sessionId, normalized)
       const target = sessions.value.find((session) => session.id === sessionId)
       if (target) {
         target.title = normalized
@@ -339,7 +339,7 @@ export const useSessionStore = defineStore('session', () => {
   async function toggleSessionPinned(sessionId: string, pinned: boolean): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.toggleSessionPinned(sessionId, pinned)
+      await agentSessionPresenter.toggleSessionPinned(sessionId, pinned)
       const target = sessions.value.find((session) => session.id === sessionId)
       if (target) {
         target.isPinned = pinned
@@ -353,7 +353,7 @@ export const useSessionStore = defineStore('session', () => {
   async function clearSessionMessages(sessionId: string): Promise<void> {
     error.value = null
     try {
-      await newAgentPresenter.clearSessionMessages(sessionId)
+      await agentSessionPresenter.clearSessionMessages(sessionId)
       if (activeSessionId.value === sessionId) {
         messageStore.clearStreamingState()
         await messageStore.loadMessages(sessionId)
@@ -370,7 +370,7 @@ export const useSessionStore = defineStore('session', () => {
   ): Promise<{ filename: string; content: string }> {
     error.value = null
     try {
-      const result = await newAgentPresenter.exportSession(sessionId, format)
+      const result = await agentSessionPresenter.exportSession(sessionId, format)
       const blob = new Blob([result.content], {
         type: getContentType(format)
       })
diff --git a/src/renderer/src/stores/ui/spotlight.ts b/src/renderer/src/stores/ui/spotlight.ts
index d8846e73d..3bbb5d142 100644
--- a/src/renderer/src/stores/ui/spotlight.ts
+++ b/src/renderer/src/stores/ui/spotlight.ts
@@ -126,7 +126,7 @@ const actionItems: Array<{
 ]
 
 export const useSpotlightStore = defineStore('spotlight', () => {
-  const newAgentPresenter = usePresenter('newAgentPresenter')
+  const agentSessionPresenter = usePresenter('agentSessionPresenter')
   const windowPresenter = usePresenter('windowPresenter')
   const providerStore = useProviderStore()
   const sessionStore = useSessionStore()
@@ -301,7 +301,7 @@ export const useSpotlightStore = defineStore('spotlight', () => {
       return
     }
 
-    const historyHits = await newAgentPresenter.searchHistory(normalizedQuery, {
+    const historyHits = await agentSessionPresenter.searchHistory(normalizedQuery, {
       limit: MAX_RESULTS
     })
 
diff --git a/src/shared/types/presenters/new-agent.presenter.d.ts b/src/shared/types/presenters/agent-session.presenter.d.ts
similarity index 99%
rename from src/shared/types/presenters/new-agent.presenter.d.ts
rename to src/shared/types/presenters/agent-session.presenter.d.ts
index 1ea181ecc..625eb3bc0 100644
--- a/src/shared/types/presenters/new-agent.presenter.d.ts
+++ b/src/shared/types/presenters/agent-session.presenter.d.ts
@@ -42,7 +42,7 @@ export interface HistorySearchMessageHit {
 
 export type HistorySearchHit = HistorySearchSessionHit | HistorySearchMessageHit
 
-export interface INewAgentPresenter {
+export interface IAgentSessionPresenter {
   createSession(input: CreateSessionInput, webContentsId: number): Promise<SessionWithState>
   createDetachedSession(input: CreateDetachedSessionInput): Promise<SessionWithState>
   ensureAcpDraftSession(input: {
diff --git a/src/shared/types/presenters/index.d.ts b/src/shared/types/presenters/index.d.ts
index e2911af55..09adef9d4 100644
--- a/src/shared/types/presenters/index.d.ts
+++ b/src/shared/types/presenters/index.d.ts
@@ -82,12 +82,12 @@ export type { IToolPresenter } from './tool.presenter'
 
 // New agent architecture types
 export type {
-  INewAgentPresenter,
+  IAgentSessionPresenter,
   HistorySearchHit,
   HistorySearchMessageHit,
   HistorySearchOptions,
   HistorySearchSessionHit
-} from './new-agent.presenter'
+} from './agent-session.presenter'
 export type { IProjectPresenter } from './project.presenter'
 export type {
   FeishuPairingSnapshot,
diff --git a/src/shared/types/presenters/legacy.presenters.d.ts b/src/shared/types/presenters/legacy.presenters.d.ts
index c37201851..5d1f3fcc7 100644
--- a/src/shared/types/presenters/legacy.presenters.d.ts
+++ b/src/shared/types/presenters/legacy.presenters.d.ts
@@ -19,7 +19,7 @@ import type { IWorkspacePresenter } from './workspace'
 import type { IToolPresenter } from './tool.presenter'
 import type { ISkillPresenter } from '../skill'
 import type { ISkillSyncPresenter } from '../skillSync'
-import type { INewAgentPresenter } from './new-agent.presenter'
+import type { IAgentSessionPresenter } from './agent-session.presenter'
 import type { IProjectPresenter } from './project.presenter'
 import type { BrowserPageInfo, DownloadInfo, ScreenshotOptions, YoBrowserStatus } from '../browser'
 import type {
@@ -488,7 +488,7 @@ export interface IPresenter {
   toolPresenter: IToolPresenter
   skillPresenter: ISkillPresenter
   skillSyncPresenter: ISkillSyncPresenter
-  newAgentPresenter: INewAgentPresenter
+  agentSessionPresenter: IAgentSessionPresenter
   projectPresenter: IProjectPresenter
   init(): void
   destroy(): Promise<void>
diff --git a/test/main/presenter/deepchatAgentPresenter/accumulator.test.ts b/test/main/presenter/agentRuntimePresenter/accumulator.test.ts
similarity index 97%
rename from test/main/presenter/deepchatAgentPresenter/accumulator.test.ts
rename to test/main/presenter/agentRuntimePresenter/accumulator.test.ts
index 29672a968..e5b19ecda 100644
--- a/test/main/presenter/deepchatAgentPresenter/accumulator.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/accumulator.test.ts
@@ -1,7 +1,7 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
-import { accumulate } from '@/presenter/deepchatAgentPresenter/accumulator'
-import { createState } from '@/presenter/deepchatAgentPresenter/types'
-import type { StreamState } from '@/presenter/deepchatAgentPresenter/types'
+import { accumulate } from '@/presenter/agentRuntimePresenter/accumulator'
+import { createState } from '@/presenter/agentRuntimePresenter/types'
+import type { StreamState } from '@/presenter/agentRuntimePresenter/types'
 
 describe('accumulate', () => {
   let state: StreamState
diff --git a/test/main/presenter/deepchatAgentPresenter/deepchatAgentPresenter.test.ts b/test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts
similarity index 98%
rename from test/main/presenter/deepchatAgentPresenter/deepchatAgentPresenter.test.ts
rename to test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts
index a1e6d4a8b..807f236c9 100644
--- a/test/main/presenter/deepchatAgentPresenter/deepchatAgentPresenter.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts
@@ -4,7 +4,7 @@ import os from 'os'
 import path from 'path'
 import { app } from 'electron'
 import type { DeepChatSessionState } from '@shared/types/agent-interface'
-import { DeepChatAgentPresenter } from '@/presenter/deepchatAgentPresenter/index'
+import { AgentRuntimePresenter } from '@/presenter/agentRuntimePresenter/index'
 import { NewSessionHooksBridge } from '@/presenter/hooksNotifications/newSessionBridge'
 
 vi.mock('nanoid', () => ({ nanoid: vi.fn(() => 'mock-msg-id') }))
@@ -63,18 +63,26 @@ vi.mock('@/lib/agentRuntime/systemEnvPromptBuilder', () => ({
 }))
 
 // Mock processStream to avoid timer/async complexity
-vi.mock('@/presenter/deepchatAgentPresenter/process', () => ({
+vi.mock('@/presenter/agentRuntimePresenter/process', () => ({
   processStream: vi.fn().mockResolvedValue({ status: 'completed' })
 }))
 
 import { eventBus } from '@/eventbus'
-import { processStream } from '@/presenter/deepchatAgentPresenter/process'
+import { processStream } from '@/presenter/agentRuntimePresenter/process'
 import { presenter } from '@/presenter'
 import {
   buildRuntimeCapabilitiesPrompt,
   buildSystemEnvPrompt
 } from '@/lib/agentRuntime/systemEnvPromptBuilder'
 
+function getSkillPresenterMock() {
+  return presenter.skillPresenter as {
+    getMetadataList: ReturnType<typeof vi.fn>
+    getActiveSkills: ReturnType<typeof vi.fn>
+    loadSkillContent: ReturnType<typeof vi.fn>
+  }
+}
+
 function createMockSqlitePresenter() {
   const summaryState = {
     summary_text: null,
@@ -246,23 +254,19 @@ function createMockToolPresenter(toolDefs: any[] = []) {
   } as any
 }
 
-describe('DeepChatAgentPresenter', () => {
+describe('AgentRuntimePresenter', () => {
   let sqlitePresenter: ReturnType<typeof createMockSqlitePresenter>
   let llmProvider: ReturnType<typeof createMockLlmProviderPresenter>
   let configPresenter: ReturnType<typeof createMockConfigPresenter>
   let toolPresenter: ReturnType<typeof createMockToolPresenter>
-  let agent: DeepChatAgentPresenter
+  let agent: AgentRuntimePresenter
   let hookDispatcher: { dispatchEvent: ReturnType<typeof vi.fn> }
   let tempHome: string | null = null
   let getPathSpy: ReturnType<typeof vi.spyOn> | null = null
 
   beforeEach(() => {
     vi.clearAllMocks()
-    const skillPresenter = presenter.skillPresenter as {
-      getMetadataList: ReturnType<typeof vi.fn>
-      getActiveSkills: ReturnType<typeof vi.fn>
-      loadSkillContent: ReturnType<typeof vi.fn>
-    }
+    const skillPresenter = getSkillPresenterMock()
     skillPresenter.getMetadataList.mockResolvedValue([])
     skillPresenter.getActiveSkills.mockResolvedValue([])
     skillPresenter.loadSkillContent.mockResolvedValue(null)
@@ -271,12 +275,15 @@ describe('DeepChatAgentPresenter', () => {
     configPresenter = createMockConfigPresenter()
     toolPresenter = createMockToolPresenter()
     hookDispatcher = { dispatchEvent: vi.fn() }
-    agent = new DeepChatAgentPresenter(
+    agent = new AgentRuntimePresenter(
       llmProvider,
       configPresenter,
       sqlitePresenter,
       toolPresenter,
-      new NewSessionHooksBridge(hookDispatcher)
+      new NewSessionHooksBridge(hookDispatcher),
+      {
+        skillPresenter
+      }
     )
   })
 
@@ -307,7 +314,16 @@ describe('DeepChatAgentPresenter', () => {
         }
       ])
 
-      new DeepChatAgentPresenter(llmProvider, configPresenter, sqlitePresenter, toolPresenter)
+      new AgentRuntimePresenter(
+        llmProvider,
+        configPresenter,
+        sqlitePresenter,
+        toolPresenter,
+        undefined,
+        {
+          skillPresenter: getSkillPresenterMock()
+        }
+      )
 
       expect(consoleSpy).toHaveBeenCalledWith(
         'DeepChatAgent: recovered 1 pending messages to error status'
@@ -347,7 +363,16 @@ describe('DeepChatAgentPresenter', () => {
         sessionId === 's1' ? { id: 's1' } : null
       )
 
-      new DeepChatAgentPresenter(llmProvider, configPresenter, sqlitePresenter, toolPresenter)
+      new AgentRuntimePresenter(
+        llmProvider,
+        configPresenter,
+        sqlitePresenter,
+        toolPresenter,
+        undefined,
+        {
+          skillPresenter: getSkillPresenterMock()
+        }
+      )
 
       expect(sqlitePresenter.deepchatPendingInputsTable.update).toHaveBeenCalledTimes(1)
       expect(sqlitePresenter.deepchatPendingInputsTable.update).toHaveBeenCalledWith(
@@ -2540,11 +2565,15 @@ describe('DeepChatAgentPresenter', () => {
         permission_mode: 'full_access'
       })
 
-      const reopenedAgent = new DeepChatAgentPresenter(
+      const reopenedAgent = new AgentRuntimePresenter(
         llmProvider,
         configPresenter,
         sqlitePresenter,
-        toolPresenter
+        toolPresenter,
+        undefined,
+        {
+          skillPresenter: getSkillPresenterMock()
+        }
       )
       const compactionState = await reopenedAgent.getSessionCompactionState('s1')
 
diff --git a/test/main/presenter/deepchatAgentPresenter/compactionService.test.ts b/test/main/presenter/agentRuntimePresenter/compactionService.test.ts
similarity index 97%
rename from test/main/presenter/deepchatAgentPresenter/compactionService.test.ts
rename to test/main/presenter/agentRuntimePresenter/compactionService.test.ts
index 0ec00e6a1..9fdeaaba8 100644
--- a/test/main/presenter/deepchatAgentPresenter/compactionService.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/compactionService.test.ts
@@ -1,20 +1,20 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
-import * as contextBuilderModule from '@/presenter/deepchatAgentPresenter/contextBuilder'
+import * as contextBuilderModule from '@/presenter/agentRuntimePresenter/contextBuilder'
 import {
   appendSummarySection,
   CompactionService,
   type ModelSpec
-} from '@/presenter/deepchatAgentPresenter/compactionService'
-import type { SessionSummaryState } from '@/presenter/deepchatAgentPresenter/sessionStore'
+} from '@/presenter/agentRuntimePresenter/compactionService'
+import type { SessionSummaryState } from '@/presenter/agentRuntimePresenter/sessionStore'
 import type { DeepChatAgentConfig } from '@shared/types/agent-interface'
 
 vi.mock('tokenx', () => ({
   approximateTokenSize: vi.fn((text: string) => text.length)
 }))
 
-vi.mock('@/presenter/deepchatAgentPresenter/contextBuilder', async (importOriginal) => {
+vi.mock('@/presenter/agentRuntimePresenter/contextBuilder', async (importOriginal) => {
   const actual =
-    await importOriginal<typeof import('@/presenter/deepchatAgentPresenter/contextBuilder')>()
+    await importOriginal<typeof import('@/presenter/agentRuntimePresenter/contextBuilder')>()
   return {
     ...actual,
     buildHistoryTurns: vi.fn(actual.buildHistoryTurns)
diff --git a/test/main/presenter/deepchatAgentPresenter/contextBuilder.test.ts b/test/main/presenter/agentRuntimePresenter/contextBuilder.test.ts
similarity index 99%
rename from test/main/presenter/deepchatAgentPresenter/contextBuilder.test.ts
rename to test/main/presenter/agentRuntimePresenter/contextBuilder.test.ts
index 204971662..3184c6340 100644
--- a/test/main/presenter/deepchatAgentPresenter/contextBuilder.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/contextBuilder.test.ts
@@ -4,7 +4,7 @@ import {
   buildResumeContext,
   fitMessagesToContextWindow,
   truncateContext
-} from '@/presenter/deepchatAgentPresenter/contextBuilder'
+} from '@/presenter/agentRuntimePresenter/contextBuilder'
 
 vi.mock('tokenx', () => ({
   approximateTokenSize: vi.fn((text: string) => {
diff --git a/test/main/presenter/deepchatAgentPresenter/dispatch.test.ts b/test/main/presenter/agentRuntimePresenter/dispatch.test.ts
similarity index 99%
rename from test/main/presenter/deepchatAgentPresenter/dispatch.test.ts
rename to test/main/presenter/agentRuntimePresenter/dispatch.test.ts
index baace17be..1ee50a6da 100644
--- a/test/main/presenter/deepchatAgentPresenter/dispatch.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/dispatch.test.ts
@@ -8,12 +8,12 @@ import type {
   InterleavedReasoningConfig,
   IoParams,
   StreamState
-} from '@/presenter/deepchatAgentPresenter/types'
-import { createState } from '@/presenter/deepchatAgentPresenter/types'
-import { estimateMessagesTokens } from '@/presenter/deepchatAgentPresenter/contextBuilder'
+} from '@/presenter/agentRuntimePresenter/types'
+import { createState } from '@/presenter/agentRuntimePresenter/types'
+import { estimateMessagesTokens } from '@/presenter/agentRuntimePresenter/contextBuilder'
 import type { MCPToolDefinition } from '@shared/presenter'
 import type { IToolPresenter } from '@shared/types/presenters/tool.presenter'
-import { ToolOutputGuard } from '@/presenter/deepchatAgentPresenter/toolOutputGuard'
+import { ToolOutputGuard } from '@/presenter/agentRuntimePresenter/toolOutputGuard'
 import { QUESTION_TOOL_NAME } from '@/lib/agentRuntime/questionTool'
 
 vi.mock('@/eventbus', () => ({
@@ -47,8 +47,8 @@ import {
   executeTools as executeToolsInternal,
   finalize,
   finalizeError
-} from '@/presenter/deepchatAgentPresenter/dispatch'
-import { accumulate } from '@/presenter/deepchatAgentPresenter/accumulator'
+} from '@/presenter/agentRuntimePresenter/dispatch'
+import { accumulate } from '@/presenter/agentRuntimePresenter/accumulator'
 import { eventBus } from '@/eventbus'
 
 function createIo(overrides?: Partial<IoParams>): IoParams {
diff --git a/test/main/presenter/deepchatAgentPresenter/echo.test.ts b/test/main/presenter/agentRuntimePresenter/echo.test.ts
similarity index 93%
rename from test/main/presenter/deepchatAgentPresenter/echo.test.ts
rename to test/main/presenter/agentRuntimePresenter/echo.test.ts
index de2cdf89c..1366ffa65 100644
--- a/test/main/presenter/deepchatAgentPresenter/echo.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/echo.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
-import type { StreamState, IoParams } from '@/presenter/deepchatAgentPresenter/types'
-import { createState } from '@/presenter/deepchatAgentPresenter/types'
+import type { StreamState, IoParams } from '@/presenter/agentRuntimePresenter/types'
+import { createState } from '@/presenter/agentRuntimePresenter/types'
 
 vi.mock('@/eventbus', () => ({
   eventBus: { sendToRenderer: vi.fn() },
@@ -15,7 +15,7 @@ vi.mock('@/events', () => ({
   }
 }))
 
-import { startEcho } from '@/presenter/deepchatAgentPresenter/echo'
+import { startEcho } from '@/presenter/agentRuntimePresenter/echo'
 import { eventBus } from '@/eventbus'
 
 function createIo(): IoParams {
diff --git a/test/main/presenter/deepchatAgentPresenter/internalSessionEvents.test.ts b/test/main/presenter/agentRuntimePresenter/internalSessionEvents.test.ts
similarity index 97%
rename from test/main/presenter/deepchatAgentPresenter/internalSessionEvents.test.ts
rename to test/main/presenter/agentRuntimePresenter/internalSessionEvents.test.ts
index d2976b408..2f15c489e 100644
--- a/test/main/presenter/deepchatAgentPresenter/internalSessionEvents.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/internalSessionEvents.test.ts
@@ -4,7 +4,7 @@ import {
   extractWaitingInteraction,
   emitDeepChatInternalSessionUpdate,
   subscribeDeepChatInternalSessionUpdates
-} from '@/presenter/deepchatAgentPresenter/internalSessionEvents'
+} from '@/presenter/agentRuntimePresenter/internalSessionEvents'
 
 describe('internalSessionEvents', () => {
   afterEach(() => {
diff --git a/test/main/presenter/deepchatAgentPresenter/messageStore.test.ts b/test/main/presenter/agentRuntimePresenter/messageStore.test.ts
similarity index 99%
rename from test/main/presenter/deepchatAgentPresenter/messageStore.test.ts
rename to test/main/presenter/agentRuntimePresenter/messageStore.test.ts
index fe1919fe7..615b66196 100644
--- a/test/main/presenter/deepchatAgentPresenter/messageStore.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/messageStore.test.ts
@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
-import { DeepChatMessageStore } from '@/presenter/deepchatAgentPresenter/messageStore'
+import { DeepChatMessageStore } from '@/presenter/agentRuntimePresenter/messageStore'
 import logger from '@shared/logger'
 
 vi.mock('nanoid', () => ({ nanoid: vi.fn(() => 'mock-msg-id') }))
diff --git a/test/main/presenter/deepchatAgentPresenter/messageTracePayload.test.ts b/test/main/presenter/agentRuntimePresenter/messageTracePayload.test.ts
similarity index 97%
rename from test/main/presenter/deepchatAgentPresenter/messageTracePayload.test.ts
rename to test/main/presenter/agentRuntimePresenter/messageTracePayload.test.ts
index 36cef22ee..b182aefe3 100644
--- a/test/main/presenter/deepchatAgentPresenter/messageTracePayload.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/messageTracePayload.test.ts
@@ -2,7 +2,7 @@ import { describe, expect, it } from 'vitest'
 import {
   buildPersistableMessageTracePayload,
   MESSAGE_TRACE_MAX_BYTES
-} from '@/presenter/deepchatAgentPresenter/messageTracePayload'
+} from '@/presenter/agentRuntimePresenter/messageTracePayload'
 
 describe('buildPersistableMessageTracePayload', () => {
   it('redacts sensitive headers/body with tail-4 mask strategy', () => {
diff --git a/test/main/presenter/deepchatAgentPresenter/pendingInputStore.test.ts b/test/main/presenter/agentRuntimePresenter/pendingInputStore.test.ts
similarity index 97%
rename from test/main/presenter/deepchatAgentPresenter/pendingInputStore.test.ts
rename to test/main/presenter/agentRuntimePresenter/pendingInputStore.test.ts
index 16ed62388..c827bfe46 100644
--- a/test/main/presenter/deepchatAgentPresenter/pendingInputStore.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/pendingInputStore.test.ts
@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 import { nanoid } from 'nanoid'
-import { DeepChatPendingInputStore } from '@/presenter/deepchatAgentPresenter/pendingInputStore'
+import { DeepChatPendingInputStore } from '@/presenter/agentRuntimePresenter/pendingInputStore'
 import type { DeepChatPendingInputRow } from '@/presenter/sqlitePresenter/tables/deepchatPendingInputs'
 
 vi.mock('nanoid', () => ({
diff --git a/test/main/presenter/deepchatAgentPresenter/process.test.ts b/test/main/presenter/agentRuntimePresenter/process.test.ts
similarity index 99%
rename from test/main/presenter/deepchatAgentPresenter/process.test.ts
rename to test/main/presenter/agentRuntimePresenter/process.test.ts
index 13b2576b4..381f8c6a9 100644
--- a/test/main/presenter/deepchatAgentPresenter/process.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/process.test.ts
@@ -6,8 +6,8 @@ import { app } from 'electron'
 import type { LLMCoreStreamEvent } from '@shared/types/core/llm-events'
 import type { MCPToolDefinition } from '@shared/presenter'
 import type { IToolPresenter } from '@shared/types/presenters/tool.presenter'
-import type { ProcessParams } from '@/presenter/deepchatAgentPresenter/types'
-import { ToolOutputGuard } from '@/presenter/deepchatAgentPresenter/toolOutputGuard'
+import type { ProcessParams } from '@/presenter/agentRuntimePresenter/types'
+import { ToolOutputGuard } from '@/presenter/agentRuntimePresenter/toolOutputGuard'
 
 vi.mock('@/eventbus', () => ({
   eventBus: { sendToRenderer: vi.fn() },
@@ -36,7 +36,7 @@ vi.mock('@/presenter', () => ({
   }
 }))
 
-import { processStream } from '@/presenter/deepchatAgentPresenter/process'
+import { processStream } from '@/presenter/agentRuntimePresenter/process'
 import { eventBus } from '@/eventbus'
 
 const DEFAULT_INTERLEAVED_REASONING = {
diff --git a/test/main/presenter/newAgentPresenter/agentRegistry.test.ts b/test/main/presenter/agentSessionPresenter/agentRegistry.test.ts
similarity index 96%
rename from test/main/presenter/newAgentPresenter/agentRegistry.test.ts
rename to test/main/presenter/agentSessionPresenter/agentRegistry.test.ts
index 91e136bfc..8cf0c3afe 100644
--- a/test/main/presenter/newAgentPresenter/agentRegistry.test.ts
+++ b/test/main/presenter/agentSessionPresenter/agentRegistry.test.ts
@@ -1,5 +1,5 @@
 import { describe, it, expect, vi } from 'vitest'
-import { AgentRegistry } from '@/presenter/newAgentPresenter/agentRegistry'
+import { AgentRegistry } from '@/presenter/agentSessionPresenter/agentRegistry'
 import type { IAgentImplementation, Agent } from '@shared/types/agent-interface'
 
 function createMockAgent(): IAgentImplementation {
diff --git a/test/main/presenter/newAgentPresenter/newAgentPresenter.test.ts b/test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts
similarity index 98%
rename from test/main/presenter/newAgentPresenter/newAgentPresenter.test.ts
rename to test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts
index 953ad0c1e..1314ca87c 100644
--- a/test/main/presenter/newAgentPresenter/newAgentPresenter.test.ts
+++ b/test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts
@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
-import { NewAgentPresenter } from '@/presenter/newAgentPresenter/index'
+import { AgentSessionPresenter } from '@/presenter/agentSessionPresenter/index'
 
 vi.mock('nanoid', () => ({ nanoid: vi.fn(() => 'mock-session-id') }))
 
@@ -249,13 +249,13 @@ function createMockSqlitePresenter() {
   } as any
 }
 
-describe('NewAgentPresenter', () => {
+describe('AgentSessionPresenter', () => {
   let deepChatAgent: ReturnType<typeof createMockDeepChatAgent>
   let llmProviderPresenter: ReturnType<typeof createMockLlmProviderPresenter>
   let configPresenter: ReturnType<typeof createMockConfigPresenter>
   let sqlitePresenter: ReturnType<typeof createMockSqlitePresenter>
   let skillPresenter: ReturnType<typeof createMockSkillPresenter>
-  let presenter: NewAgentPresenter
+  let presenter: AgentSessionPresenter
 
   beforeEach(() => {
     vi.clearAllMocks()
@@ -264,7 +264,7 @@ describe('NewAgentPresenter', () => {
     configPresenter = createMockConfigPresenter()
     sqlitePresenter = createMockSqlitePresenter()
     skillPresenter = createMockSkillPresenter()
-    presenter = new NewAgentPresenter(
+    presenter = new AgentSessionPresenter(
       deepChatAgent as any,
       llmProviderPresenter,
       configPresenter,
@@ -992,7 +992,7 @@ describe('NewAgentPresenter', () => {
       expect(sessions).toHaveLength(1)
       expect(sessions[0].id).toBe('s1')
       expect(warnSpy).toHaveBeenCalledWith(
-        '[NewAgentPresenter] Skipping unavailable session id=missing-agent agent=disabled-agent:',
+        '[AgentSessionPresenter] Skipping unavailable session id=missing-agent agent=disabled-agent:',
         expect.any(Error)
       )
       warnSpy.mockRestore()
@@ -1037,7 +1037,7 @@ describe('NewAgentPresenter', () => {
       expect(sessions).toHaveLength(1)
       expect(sessions[0].id).toBe('healthy-state')
       expect(warnSpy).toHaveBeenCalledWith(
-        '[NewAgentPresenter] Skipping unavailable session id=broken-state agent=deepchat:',
+        '[AgentSessionPresenter] Skipping unavailable session id=broken-state agent=deepchat:',
         expect.any(Error)
       )
       warnSpy.mockRestore()
@@ -1080,7 +1080,7 @@ describe('NewAgentPresenter', () => {
 
       expect(await presenter.getSession('s-disabled')).toBeNull()
       expect(warnSpy).toHaveBeenCalledWith(
-        '[NewAgentPresenter] Skipping unavailable session id=s-disabled agent=disabled-agent:',
+        '[AgentSessionPresenter] Skipping unavailable session id=s-disabled agent=disabled-agent:',
         expect.any(Error)
       )
       warnSpy.mockRestore()
@@ -1773,7 +1773,7 @@ describe('NewAgentPresenter', () => {
       })
       await expect(presenter.getActiveSession(1)).resolves.toBeNull()
       expect(warnSpy).toHaveBeenCalledWith(
-        '[NewAgentPresenter] Skipping unavailable session id=s-disabled agent=disabled-agent:',
+        '[AgentSessionPresenter] Skipping unavailable session id=s-disabled agent=disabled-agent:',
         expect.any(Error)
       )
       warnSpy.mockRestore()
diff --git a/test/main/presenter/newAgentPresenter/integration.test.ts b/test/main/presenter/agentSessionPresenter/integration.test.ts
similarity index 98%
rename from test/main/presenter/newAgentPresenter/integration.test.ts
rename to test/main/presenter/agentSessionPresenter/integration.test.ts
index 029a4c5fb..787a676b0 100644
--- a/test/main/presenter/newAgentPresenter/integration.test.ts
+++ b/test/main/presenter/agentSessionPresenter/integration.test.ts
@@ -1,7 +1,7 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
-import { NewAgentPresenter } from '@/presenter/newAgentPresenter/index'
-import { DeepChatAgentPresenter } from '@/presenter/deepchatAgentPresenter/index'
-import { estimateMessagesTokens } from '@/presenter/deepchatAgentPresenter/contextBuilder'
+import { AgentSessionPresenter } from '@/presenter/agentSessionPresenter/index'
+import { AgentRuntimePresenter } from '@/presenter/agentRuntimePresenter/index'
+import { estimateMessagesTokens } from '@/presenter/agentRuntimePresenter/contextBuilder'
 import { NewSessionHooksBridge } from '@/presenter/hooksNotifications/newSessionBridge'
 
 vi.mock('nanoid', () => {
@@ -484,7 +484,7 @@ describe('Integration: createSession end-to-end', () => {
   let sqlitePresenter: ReturnType<typeof createMockSqlitePresenter>
   let llmProvider: ReturnType<typeof createMockLlmProviderPresenter>
   let configPresenter: ReturnType<typeof createMockConfigPresenter>
-  let agentPresenter: NewAgentPresenter
+  let agentPresenter: AgentSessionPresenter
 
   beforeEach(() => {
     vi.clearAllMocks()
@@ -492,13 +492,13 @@ describe('Integration: createSession end-to-end', () => {
     llmProvider = createMockLlmProviderPresenter()
     configPresenter = createMockConfigPresenter()
 
-    const deepchatAgent = new DeepChatAgentPresenter(
+    const deepchatAgent = new AgentRuntimePresenter(
       llmProvider,
       configPresenter,
       sqlitePresenter,
       createMockToolPresenter()
     )
-    agentPresenter = new NewAgentPresenter(
+    agentPresenter = new AgentSessionPresenter(
       deepchatAgent as any,
       llmProvider,
       configPresenter,
@@ -631,7 +631,7 @@ describe('Integration: ACP hooks bridge', () => {
   let sqlitePresenter: ReturnType<typeof createMockSqlitePresenter>
   let llmProvider: ReturnType<typeof createMockLlmProviderPresenter>
   let configPresenter: ReturnType<typeof createMockConfigPresenter>
-  let agentPresenter: NewAgentPresenter
+  let agentPresenter: AgentSessionPresenter
   let hookDispatcher: { dispatchEvent: ReturnType<typeof vi.fn> }
 
   beforeEach(() => {
@@ -642,14 +642,14 @@ describe('Integration: ACP hooks bridge', () => {
     configPresenter.getAcpAgents.mockResolvedValue([{ id: 'coder', name: 'Coder' }])
     hookDispatcher = { dispatchEvent: vi.fn() }
 
-    const deepchatAgent = new DeepChatAgentPresenter(
+    const deepchatAgent = new AgentRuntimePresenter(
       llmProvider,
       configPresenter,
       sqlitePresenter,
       createMockToolPresenter(),
       new NewSessionHooksBridge(hookDispatcher)
     )
-    agentPresenter = new NewAgentPresenter(
+    agentPresenter = new AgentSessionPresenter(
       deepchatAgent as any,
       llmProvider,
       configPresenter,
@@ -713,8 +713,8 @@ describe('Integration: multi-turn context', () => {
   let sqlitePresenter: ReturnType<typeof createMockSqlitePresenter>
   let llmProvider: ReturnType<typeof createMockLlmProviderPresenter>
   let configPresenter: ReturnType<typeof createMockConfigPresenter>
-  let deepchatAgent: DeepChatAgentPresenter
-  let agentPresenter: NewAgentPresenter
+  let deepchatAgent: AgentRuntimePresenter
+  let agentPresenter: AgentSessionPresenter
 
   beforeEach(() => {
     vi.clearAllMocks()
@@ -722,13 +722,13 @@ describe('Integration: multi-turn context', () => {
     llmProvider = createMockLlmProviderPresenter()
     configPresenter = createMockConfigPresenter()
 
-    deepchatAgent = new DeepChatAgentPresenter(
+    deepchatAgent = new AgentRuntimePresenter(
       llmProvider,
       configPresenter,
       sqlitePresenter,
       createMockToolPresenter()
     )
-    agentPresenter = new NewAgentPresenter(
+    agentPresenter = new AgentSessionPresenter(
       deepchatAgent as any,
       llmProvider,
       configPresenter,
@@ -1236,7 +1236,7 @@ describe('Integration: crash recovery', () => {
     const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {})
 
     // Creating the agent triggers crash recovery
-    new DeepChatAgentPresenter(
+    new AgentRuntimePresenter(
       llmProvider,
       configPresenter,
       sqlitePresenter,
diff --git a/test/main/presenter/newAgentPresenter/legacyImportService.test.ts b/test/main/presenter/agentSessionPresenter/legacyImportService.test.ts
similarity index 98%
rename from test/main/presenter/newAgentPresenter/legacyImportService.test.ts
rename to test/main/presenter/agentSessionPresenter/legacyImportService.test.ts
index 899757014..0bd8ce971 100644
--- a/test/main/presenter/newAgentPresenter/legacyImportService.test.ts
+++ b/test/main/presenter/agentSessionPresenter/legacyImportService.test.ts
@@ -15,7 +15,7 @@ vi.mock('better-sqlite3-multiple-ciphers', () => ({
   default: vi.fn()
 }))
 
-import { LegacyChatImportService } from '@/presenter/newAgentPresenter/legacyImportService'
+import { LegacyChatImportService } from '@/presenter/agentSessionPresenter/legacyImportService'
 
 function createMockSqlitePresenter() {
   const statusStore = new Map<string, any>()
diff --git a/test/main/presenter/newAgentPresenter/messageManager.test.ts b/test/main/presenter/agentSessionPresenter/messageManager.test.ts
similarity index 91%
rename from test/main/presenter/newAgentPresenter/messageManager.test.ts
rename to test/main/presenter/agentSessionPresenter/messageManager.test.ts
index f27383b06..8367e1c88 100644
--- a/test/main/presenter/newAgentPresenter/messageManager.test.ts
+++ b/test/main/presenter/agentSessionPresenter/messageManager.test.ts
@@ -1,7 +1,7 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
-import { NewMessageManager } from '@/presenter/newAgentPresenter/messageManager'
-import type { AgentRegistry } from '@/presenter/newAgentPresenter/agentRegistry'
-import type { NewSessionManager } from '@/presenter/newAgentPresenter/sessionManager'
+import { NewMessageManager } from '@/presenter/agentSessionPresenter/messageManager'
+import type { AgentRegistry } from '@/presenter/agentSessionPresenter/agentRegistry'
+import type { NewSessionManager } from '@/presenter/agentSessionPresenter/sessionManager'
 import type { ChatMessageRecord } from '@shared/types/agent-interface'
 
 const mockMessage: ChatMessageRecord = {
diff --git a/test/main/presenter/newAgentPresenter/sessionManager.test.ts b/test/main/presenter/agentSessionPresenter/sessionManager.test.ts
similarity index 98%
rename from test/main/presenter/newAgentPresenter/sessionManager.test.ts
rename to test/main/presenter/agentSessionPresenter/sessionManager.test.ts
index 66686a1a7..d8dbc2c5e 100644
--- a/test/main/presenter/newAgentPresenter/sessionManager.test.ts
+++ b/test/main/presenter/agentSessionPresenter/sessionManager.test.ts
@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { NewSessionManager } from '@/presenter/newAgentPresenter/sessionManager'
+import { NewSessionManager } from '@/presenter/agentSessionPresenter/sessionManager'
 
 vi.mock('nanoid', () => ({ nanoid: vi.fn(() => 'mock-id-123') }))
 
diff --git a/test/main/presenter/newAgentPresenter/usageDashboard.test.ts b/test/main/presenter/agentSessionPresenter/usageDashboard.test.ts
similarity index 98%
rename from test/main/presenter/newAgentPresenter/usageDashboard.test.ts
rename to test/main/presenter/agentSessionPresenter/usageDashboard.test.ts
index 04c50f4c2..09d882d1b 100644
--- a/test/main/presenter/newAgentPresenter/usageDashboard.test.ts
+++ b/test/main/presenter/agentSessionPresenter/usageDashboard.test.ts
@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest'
-import { NewAgentPresenter } from '@/presenter/newAgentPresenter/index'
-import { DeepChatMessageStore } from '@/presenter/deepchatAgentPresenter/messageStore'
+import { AgentSessionPresenter } from '@/presenter/agentSessionPresenter/index'
+import { DeepChatMessageStore } from '@/presenter/agentRuntimePresenter/messageStore'
 import { DASHBOARD_STATS_BACKFILL_KEY, type UsageStatsRecordInput } from '@/presenter/usageStats'
 
 vi.mock('@/eventbus', () => ({
@@ -413,7 +413,7 @@ function createMockSqlitePresenter() {
   } as any
 }
 
-describe('NewAgentPresenter usage dashboard', () => {
+describe('AgentSessionPresenter usage dashboard', () => {
   beforeEach(() => {
     vi.clearAllMocks()
   })
@@ -421,7 +421,7 @@ describe('NewAgentPresenter usage dashboard', () => {
   function createPresenter() {
     const sqlitePresenter = createMockSqlitePresenter()
     const configPresenter = createMockConfigPresenter()
-    const presenter = new NewAgentPresenter(
+    const presenter = new AgentSessionPresenter(
       createMockDeepChatAgent() as any,
       createMockLlmProviderPresenter() as any,
       configPresenter as any,
diff --git a/test/main/presenter/floatingButtonPresenter/index.test.ts b/test/main/presenter/floatingButtonPresenter/index.test.ts
index 993d00a35..070e16dce 100644
--- a/test/main/presenter/floatingButtonPresenter/index.test.ts
+++ b/test/main/presenter/floatingButtonPresenter/index.test.ts
@@ -138,7 +138,7 @@ vi.mock('../../../../src/main/presenter/floatingButtonPresenter/FloatingButtonWi
 
 vi.mock('../../../../src/main/presenter/index', () => ({
   presenter: {
-    newAgentPresenter: {
+    agentSessionPresenter: {
       getSessionList: vi.fn(async () => presenterState.sessions),
       activateSession: vi.fn()
     },
diff --git a/test/main/presenter/mcpPresenter/toolManager.test.ts b/test/main/presenter/mcpPresenter/toolManager.test.ts
index 79e7e0e83..d39b690be 100644
--- a/test/main/presenter/mcpPresenter/toolManager.test.ts
+++ b/test/main/presenter/mcpPresenter/toolManager.test.ts
@@ -8,7 +8,7 @@ const eventBusMocks = vi.hoisted(() => ({
 }))
 
 const presenterMocks = vi.hoisted(() => ({
-  newAgentPresenter: {
+  agentSessionPresenter: {
     getSession: vi.fn()
   }
 }))
@@ -95,7 +95,7 @@ describe('ToolManager ACP MCP access control', () => {
     configPresenter.getAcpAgents.mockResolvedValue([{ id: 'agent-1', name: 'Agent 1' }])
     configPresenter.getAgentMcpSelections.mockResolvedValue([])
 
-    presenterMocks.newAgentPresenter.getSession.mockResolvedValue({
+    presenterMocks.agentSessionPresenter.getSession.mockResolvedValue({
       id: 'session-1',
       agentId: 'agent-1',
       title: 'New Chat',
@@ -137,7 +137,7 @@ describe('ToolManager ACP MCP access control', () => {
   it('skips ACP session resolution when provider hint is non-ACP', async () => {
     const client = createClient('open-server')
     const configPresenter = createConfigPresenter('open-server')
-    presenterMocks.newAgentPresenter.getSession.mockResolvedValue(null)
+    presenterMocks.agentSessionPresenter.getSession.mockResolvedValue(null)
 
     const manager = new ToolManager(
       configPresenter as never,
@@ -160,7 +160,7 @@ describe('ToolManager ACP MCP access control', () => {
     expect(result.isError).toBe(false)
     expect(result.content).toBe('ok')
     expect(client.callTool).toHaveBeenCalledWith('echo', {})
-    expect(presenterMocks.newAgentPresenter.getSession).not.toHaveBeenCalled()
+    expect(presenterMocks.agentSessionPresenter.getSession).not.toHaveBeenCalled()
     expect(configPresenter.getAgentMcpSelections).not.toHaveBeenCalled()
     expect(
       warnSpy.mock.calls.some((call) =>
@@ -173,7 +173,7 @@ describe('ToolManager ACP MCP access control', () => {
     const client = createClient('open-server')
     const configPresenter = createConfigPresenter('open-server')
 
-    presenterMocks.newAgentPresenter.getSession.mockResolvedValue({
+    presenterMocks.agentSessionPresenter.getSession.mockResolvedValue({
       id: 'session-2',
       agentId: 'deepchat',
       title: 'Normal Chat',
@@ -213,7 +213,7 @@ describe('ToolManager ACP MCP access control', () => {
   it('treats missing provider hint as a fallback to new session resolution', async () => {
     const client = createClient('open-server')
     const configPresenter = createConfigPresenter('open-server')
-    presenterMocks.newAgentPresenter.getSession.mockResolvedValue(null)
+    presenterMocks.agentSessionPresenter.getSession.mockResolvedValue(null)
 
     const manager = new ToolManager(
       configPresenter as never,
@@ -235,7 +235,7 @@ describe('ToolManager ACP MCP access control', () => {
     expect(result.isError).toBe(false)
     expect(result.content).toBe('ok')
     expect(client.callTool).toHaveBeenCalledWith('echo', {})
-    expect(presenterMocks.newAgentPresenter.getSession).toHaveBeenCalledWith('conv-fallback')
+    expect(presenterMocks.agentSessionPresenter.getSession).toHaveBeenCalledWith('conv-fallback')
     expect(configPresenter.getAgentMcpSelections).not.toHaveBeenCalled()
   })
 })
diff --git a/test/main/presenter/remoteControlPresenter/remoteControlPresenter.test.ts b/test/main/presenter/remoteControlPresenter/remoteControlPresenter.test.ts
index 510727a1c..2f7a03dc0 100644
--- a/test/main/presenter/remoteControlPresenter/remoteControlPresenter.test.ts
+++ b/test/main/presenter/remoteControlPresenter/remoteControlPresenter.test.ts
@@ -127,8 +127,8 @@ describe('RemoteControlPresenter', () => {
 
     const presenter = new RemoteControlPresenter({
       configPresenter: configPresenter as any,
-      newAgentPresenter: {} as any,
-      deepchatAgentPresenter: {} as any,
+      agentSessionPresenter: {} as any,
+      agentRuntimePresenter: {} as any,
       windowPresenter: {} as any,
       tabPresenter: {} as any,
       getHooksNotificationsConfig: () => hooksConfig,
@@ -175,8 +175,8 @@ describe('RemoteControlPresenter', () => {
 
     const presenter = new RemoteControlPresenter({
       configPresenter: configPresenter as any,
-      newAgentPresenter: {} as any,
-      deepchatAgentPresenter: {} as any,
+      agentSessionPresenter: {} as any,
+      agentRuntimePresenter: {} as any,
       windowPresenter: {} as any,
       tabPresenter: {} as any,
       getHooksNotificationsConfig: () => hooksConfig,
@@ -210,8 +210,8 @@ describe('RemoteControlPresenter', () => {
 
     const presenter = new RemoteControlPresenter({
       configPresenter: configPresenter as any,
-      newAgentPresenter: {} as any,
-      deepchatAgentPresenter: {} as any,
+      agentSessionPresenter: {} as any,
+      agentRuntimePresenter: {} as any,
       windowPresenter: {} as any,
       tabPresenter: {} as any,
       getHooksNotificationsConfig: () => hooksConfig,
@@ -278,8 +278,8 @@ describe('RemoteControlPresenter', () => {
 
     const presenter = new RemoteControlPresenter({
       configPresenter: configPresenter as any,
-      newAgentPresenter: {} as any,
-      deepchatAgentPresenter: {} as any,
+      agentSessionPresenter: {} as any,
+      agentRuntimePresenter: {} as any,
       windowPresenter: {} as any,
       tabPresenter: {} as any,
       getHooksNotificationsConfig: () => hooksConfig,
@@ -344,8 +344,8 @@ describe('RemoteControlPresenter', () => {
         ...configPresenter,
         listAgents
       } as any,
-      newAgentPresenter: {} as any,
-      deepchatAgentPresenter: {} as any,
+      agentSessionPresenter: {} as any,
+      agentRuntimePresenter: {} as any,
       windowPresenter: {} as any,
       tabPresenter: {} as any,
       getHooksNotificationsConfig: () => hooksConfig,
@@ -393,8 +393,8 @@ describe('RemoteControlPresenter', () => {
 
     const presenter = new RemoteControlPresenter({
       configPresenter: configPresenter as any,
-      newAgentPresenter: {} as any,
-      deepchatAgentPresenter: {} as any,
+      agentSessionPresenter: {} as any,
+      agentRuntimePresenter: {} as any,
       windowPresenter: {} as any,
       tabPresenter: {} as any,
       getHooksNotificationsConfig: () => hooksConfig,
diff --git a/test/main/presenter/remoteControlPresenter/remoteConversationRunner.test.ts b/test/main/presenter/remoteControlPresenter/remoteConversationRunner.test.ts
index 32ad38c0c..bcfb248e9 100644
--- a/test/main/presenter/remoteControlPresenter/remoteConversationRunner.test.ts
+++ b/test/main/presenter/remoteControlPresenter/remoteConversationRunner.test.ts
@@ -30,12 +30,12 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           createDetachedSession: vi
             .fn()
             .mockResolvedValue(createSession({ agentId: 'deepchat-alt' }))
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('deepchat-alt')
@@ -50,7 +50,7 @@ describe('RemoteConversationRunner', () => {
   })
 
   it('keeps using the bound session even after the default agent changes', async () => {
-    const newAgentPresenter = {
+    const agentSessionPresenter = {
       createDetachedSession: vi.fn(),
       getSession: vi.fn().mockResolvedValue(
         createSession({
@@ -78,7 +78,7 @@ describe('RemoteConversationRunner', () => {
       rememberActiveEvent: vi.fn(),
       setBinding: vi.fn()
     }
-    const deepchatAgentPresenter = {
+    const agentRuntimePresenter = {
       getActiveGeneration: vi.fn().mockReturnValue({
         eventId: 'msg-1',
         runId: 'run-1'
@@ -87,8 +87,8 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: newAgentPresenter as any,
-        deepchatAgentPresenter: deepchatAgentPresenter as any,
+        agentSessionPresenter: agentSessionPresenter as any,
+        agentRuntimePresenter: agentRuntimePresenter as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('deepchat-new')
@@ -99,12 +99,12 @@ describe('RemoteConversationRunner', () => {
     const execution = await runner.sendText('telegram:100:0', 'hello')
 
     expect(execution.sessionId).toBe('session-legacy')
-    expect(newAgentPresenter.sendMessage).toHaveBeenCalledWith('session-legacy', 'hello')
-    expect(newAgentPresenter.createDetachedSession).not.toHaveBeenCalled()
+    expect(agentSessionPresenter.sendMessage).toHaveBeenCalledWith('session-legacy', 'hello')
+    expect(agentSessionPresenter.createDetachedSession).not.toHaveBeenCalled()
   })
 
   it('lists recent sessions for the currently bound agent before falling back to default agent', async () => {
-    const newAgentPresenter = {
+    const agentSessionPresenter = {
       getSession: vi.fn().mockResolvedValue(
         createSession({
           id: 'session-bound',
@@ -134,8 +134,8 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: newAgentPresenter as any,
-        deepchatAgentPresenter: {} as any,
+        agentSessionPresenter: agentSessionPresenter as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('deepchat-default')
@@ -145,7 +145,7 @@ describe('RemoteConversationRunner', () => {
 
     const sessions = await runner.listSessions('telegram:100:0')
 
-    expect(newAgentPresenter.getSessionList).toHaveBeenCalledWith({
+    expect(agentSessionPresenter.getSessionList).toHaveBeenCalledWith({
       agentId: 'deepchat-bound'
     })
     expect(sessions.map((session) => session.id)).toEqual(['session-b', 'session-a'])
@@ -156,7 +156,7 @@ describe('RemoteConversationRunner', () => {
   })
 
   it('delegates remote model switching to the bound session', async () => {
-    const newAgentPresenter = {
+    const agentSessionPresenter = {
       getSession: vi.fn().mockResolvedValue(
         createSession({
           id: 'session-bound',
@@ -175,8 +175,8 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: newAgentPresenter as any,
-        deepchatAgentPresenter: {} as any,
+        agentSessionPresenter: agentSessionPresenter as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('deepchat-default')
@@ -191,7 +191,7 @@ describe('RemoteConversationRunner', () => {
 
     const updated = await runner.setSessionModel('telegram:100:0', 'anthropic', 'claude-3-5-sonnet')
 
-    expect(newAgentPresenter.setSessionModel).toHaveBeenCalledWith(
+    expect(agentSessionPresenter.setSessionModel).toHaveBeenCalledWith(
       'session-bound',
       'anthropic',
       'claude-3-5-sonnet'
@@ -204,10 +204,10 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           getSession: vi.fn()
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {
           getAllWindows: vi.fn(),
           getFocusedWindow: vi.fn(),
@@ -236,11 +236,11 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           getSession: vi.fn().mockResolvedValue(createSession()),
           activateSession
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {
           getAllWindows: vi.fn().mockReturnValue([]),
           getFocusedWindow: vi.fn().mockReturnValue(null),
@@ -285,11 +285,11 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           getSession: vi.fn().mockResolvedValue(session),
           activateSession
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {
           getAllWindows: vi.fn().mockReturnValue([chatWindow]),
           getFocusedWindow: vi.fn().mockReturnValue(chatWindow),
@@ -334,7 +334,7 @@ describe('RemoteConversationRunner', () => {
       orderSeq: 2
     }
 
-    const newAgentPresenter = {
+    const agentSessionPresenter = {
       getSession: vi.fn().mockResolvedValue(session),
       getMessages: vi
         .fn()
@@ -361,7 +361,7 @@ describe('RemoteConversationRunner', () => {
       rememberActiveEvent: vi.fn(),
       setBinding: vi.fn()
     }
-    const deepchatAgentPresenter = {
+    const agentRuntimePresenter = {
       getActiveGeneration: vi
         .fn()
         .mockReturnValueOnce({
@@ -373,8 +373,8 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: newAgentPresenter as any,
-        deepchatAgentPresenter: deepchatAgentPresenter as any,
+        agentSessionPresenter: agentSessionPresenter as any,
+        agentRuntimePresenter: agentRuntimePresenter as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('deepchat-new')
@@ -410,7 +410,7 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           getSession: vi.fn().mockResolvedValue(createSession()),
           sendMessage: vi.fn().mockResolvedValue(undefined),
           getMessages: vi.fn().mockResolvedValue([
@@ -455,7 +455,7 @@ describe('RemoteConversationRunner', () => {
             }
           ])
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('deepchat')
@@ -492,7 +492,7 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           getSession: vi.fn().mockResolvedValue(createSession()),
           getMessages: vi.fn().mockResolvedValue([
             {
@@ -525,7 +525,7 @@ describe('RemoteConversationRunner', () => {
             ])
           })
         } as any,
-        deepchatAgentPresenter: {
+        agentRuntimePresenter: {
           getActiveGeneration: vi.fn().mockReturnValue({
             eventId: 'assistant-1',
             runId: 'run-1'
@@ -571,7 +571,7 @@ describe('RemoteConversationRunner', () => {
         }
       ])
     })
-    const newAgentPresenter = {
+    const agentSessionPresenter = {
       getSession: vi.fn().mockResolvedValue(createSession()),
       getMessages: vi
         .fn()
@@ -638,8 +638,8 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: newAgentPresenter as any,
-        deepchatAgentPresenter: {
+        agentSessionPresenter: agentSessionPresenter as any,
+        agentRuntimePresenter: {
           getActiveGeneration: vi.fn().mockReturnValue(null)
         } as any,
         windowPresenter: {} as any,
@@ -654,7 +654,7 @@ describe('RemoteConversationRunner', () => {
       granted: true
     })
 
-    expect(newAgentPresenter.respondToolInteraction).toHaveBeenCalledWith(
+    expect(agentSessionPresenter.respondToolInteraction).toHaveBeenCalledWith(
       'session-1',
       'assistant-2',
       'tool-2',
@@ -696,10 +696,10 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           createDetachedSession
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('acp-agent')
@@ -729,8 +729,8 @@ describe('RemoteConversationRunner', () => {
         configPresenter: createConfigPresenter({
           getDefaultProjectPath: vi.fn(() => '/workspaces/global')
         }) as any,
-        newAgentPresenter: {} as any,
-        deepchatAgentPresenter: {} as any,
+        agentSessionPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('acp-agent')
@@ -749,10 +749,10 @@ describe('RemoteConversationRunner', () => {
     const runner = new RemoteConversationRunner(
       {
         configPresenter: createConfigPresenter() as any,
-        newAgentPresenter: {
+        agentSessionPresenter: {
           createDetachedSession: vi.fn()
         } as any,
-        deepchatAgentPresenter: {} as any,
+        agentRuntimePresenter: {} as any,
         windowPresenter: {} as any,
         tabPresenter: {} as any,
         resolveDefaultAgentId: vi.fn().mockResolvedValue('acp-agent')
diff --git a/test/main/presenter/toolPresenter/agentTools/subagentOrchestratorTool.test.ts b/test/main/presenter/toolPresenter/agentTools/subagentOrchestratorTool.test.ts
index c7137db5d..4389f115b 100644
--- a/test/main/presenter/toolPresenter/agentTools/subagentOrchestratorTool.test.ts
+++ b/test/main/presenter/toolPresenter/agentTools/subagentOrchestratorTool.test.ts
@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest'
-import type { DeepChatInternalSessionUpdate } from '@/presenter/deepchatAgentPresenter/internalSessionEvents'
+import type { DeepChatInternalSessionUpdate } from '@/presenter/agentRuntimePresenter/internalSessionEvents'
 import {
   SubagentOrchestratorTool,
   SUBAGENT_ORCHESTRATOR_TOOL_NAME
diff --git a/test/renderer/components/ChatPage.test.ts b/test/renderer/components/ChatPage.test.ts
index 821d184f5..c1ea922de 100644
--- a/test/renderer/components/ChatPage.test.ts
+++ b/test/renderer/components/ChatPage.test.ts
@@ -99,7 +99,7 @@ const setup = async (options: SetupOptions = {}) => {
     }))
   })
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     respondToolInteraction: vi.fn().mockResolvedValue(undefined),
     cancelGeneration: vi.fn().mockResolvedValue(undefined),
     retryMessage: vi.fn().mockResolvedValue(undefined),
@@ -128,7 +128,7 @@ const setup = async (options: SetupOptions = {}) => {
     useModelStore: () => modelStore
   }))
   vi.doMock('@/composables/usePresenter', () => ({
-    usePresenter: () => newAgentPresenter
+    usePresenter: () => agentSessionPresenter
   }))
   vi.doMock('@/stores/ui/spotlight', () => ({
     useSpotlightStore: () => spotlightStore
diff --git a/test/renderer/components/ChatStatusBar.test.ts b/test/renderer/components/ChatStatusBar.test.ts
index f63f0b175..481657b22 100644
--- a/test/renderer/components/ChatStatusBar.test.ts
+++ b/test/renderer/components/ChatStatusBar.test.ts
@@ -381,7 +381,7 @@ const setup = async (options: SetupOptions = {}) => {
   const sessionSettingsResult =
     options.sessionSettings === null ? null : ({ ...baseSessionSettings } as TestGenerationSettings)
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     getPermissionMode: vi.fn().mockResolvedValue('full_access'),
     setPermissionMode: vi.fn().mockResolvedValue(undefined),
     getSessionGenerationSettings: vi.fn().mockResolvedValue(sessionSettingsResult),
@@ -463,7 +463,7 @@ const setup = async (options: SetupOptions = {}) => {
     usePresenter: (name: string) => {
       if (name === 'configPresenter') return configPresenter
       if (name === 'llmproviderPresenter') return llmproviderPresenter
-      return newAgentPresenter
+      return agentSessionPresenter
     }
   }))
   vi.doMock('vue-i18n', () => ({
@@ -532,7 +532,7 @@ const setup = async (options: SetupOptions = {}) => {
 
   return {
     wrapper,
-    newAgentPresenter,
+    agentSessionPresenter,
     llmproviderPresenter,
     agentStore,
     sessionStore,
@@ -685,7 +685,7 @@ describe('ChatStatusBar model and session panels', () => {
   })
 
   it('keeps showing loading until settings finish loading for the current model selection', async () => {
-    const { wrapper, sessionStore, newAgentPresenter } = await setup({
+    const { wrapper, sessionStore, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeProviderId: 'openai',
       activeModelId: 'gpt-4'
@@ -707,8 +707,10 @@ describe('ChatStatusBar model and session panels', () => {
         sessionStore.activeSession.modelId = 'claude-3-5-sonnet'
       }
     })
-    newAgentPresenter.getSessionGenerationSettings.mockClear()
-    newAgentPresenter.getSessionGenerationSettings.mockImplementation(() => pendingSettings.promise)
+    agentSessionPresenter.getSessionGenerationSettings.mockClear()
+    agentSessionPresenter.getSessionGenerationSettings.mockImplementation(
+      () => pendingSettings.promise
+    )
 
     await (wrapper.vm as any).openModelSettings('anthropic', 'claude-3-5-sonnet')
     await flushPromises()
@@ -874,7 +876,7 @@ describe('ChatStatusBar model and session panels', () => {
   })
 
   it('falls back to model defaults when the active session has no saved generation settings', async () => {
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       agentId: 'deepchat',
       hasActiveSession: true,
       activeProviderId: 'openai',
@@ -882,7 +884,7 @@ describe('ChatStatusBar model and session panels', () => {
       sessionSettings: null
     })
 
-    expect(newAgentPresenter.getSessionGenerationSettings).toHaveBeenCalledWith('s1')
+    expect(agentSessionPresenter.getSessionGenerationSettings).toHaveBeenCalledWith('s1')
     expect((wrapper.vm as any).localSettings).toEqual({
       systemPrompt: 'Default prompt',
       temperature: 0.7,
@@ -1013,7 +1015,7 @@ describe('ChatStatusBar model and session panels', () => {
   it('debounces generation setting persistence to a single session update', async () => {
     vi.useFakeTimers()
 
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeProviderId: 'openai',
       activeModelId: 'gpt-4'
@@ -1027,13 +1029,13 @@ describe('ChatStatusBar model and session panels', () => {
 
     vi.advanceTimersByTime(299)
     await flushPromises()
-    expect(newAgentPresenter.updateSessionGenerationSettings).not.toHaveBeenCalled()
+    expect(agentSessionPresenter.updateSessionGenerationSettings).not.toHaveBeenCalled()
 
     vi.advanceTimersByTime(1)
     await flushPromises()
 
-    expect(newAgentPresenter.updateSessionGenerationSettings).toHaveBeenCalledTimes(1)
-    expect(newAgentPresenter.updateSessionGenerationSettings).toHaveBeenCalledWith(
+    expect(agentSessionPresenter.updateSessionGenerationSettings).toHaveBeenCalledTimes(1)
+    expect(agentSessionPresenter.updateSessionGenerationSettings).toHaveBeenCalledWith(
       's1',
       expect.objectContaining({ temperature: 1.2 })
     )
@@ -1045,7 +1047,7 @@ describe('ChatStatusBar model and session panels', () => {
   it('turns thinking budget off with the switch and clears the persisted field', async () => {
     vi.useFakeTimers()
 
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeProviderId: 'openai',
       activeModelId: 'gpt-4'
@@ -1059,7 +1061,7 @@ describe('ChatStatusBar model and session panels', () => {
     vi.advanceTimersByTime(300)
     await flushPromises()
 
-    expect(newAgentPresenter.updateSessionGenerationSettings).toHaveBeenCalledWith(
+    expect(agentSessionPresenter.updateSessionGenerationSettings).toHaveBeenCalledWith(
       's1',
       expect.objectContaining({ thinkingBudget: undefined })
     )
@@ -1071,7 +1073,7 @@ describe('ChatStatusBar model and session panels', () => {
   it('sends an explicit false when interleaved thinking is turned off', async () => {
     vi.useFakeTimers()
 
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeProviderId: 'openai',
       activeModelId: 'gpt-4',
@@ -1099,7 +1101,7 @@ describe('ChatStatusBar model and session panels', () => {
     vi.advanceTimersByTime(300)
     await flushPromises()
 
-    expect(newAgentPresenter.updateSessionGenerationSettings).toHaveBeenCalledWith(
+    expect(agentSessionPresenter.updateSessionGenerationSettings).toHaveBeenCalledWith(
       's1',
       expect.objectContaining({
         forceInterleavedThinkingCompat: false
@@ -1115,13 +1117,13 @@ describe('ChatStatusBar model and session panels', () => {
 
     const firstResponse = createDeferred<TestGenerationSettings>()
 
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeProviderId: 'openai',
       activeModelId: 'gpt-4'
     })
 
-    newAgentPresenter.updateSessionGenerationSettings.mockImplementation(
+    agentSessionPresenter.updateSessionGenerationSettings.mockImplementation(
       () => firstResponse.promise
     )
 
@@ -1163,13 +1165,13 @@ describe('ChatStatusBar model and session panels', () => {
     const secondResponse = createDeferred<TestGenerationSettings>()
     const responseQueue = [firstResponse.promise, secondResponse.promise]
 
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeProviderId: 'openai',
       activeModelId: 'gpt-4'
     })
 
-    newAgentPresenter.updateSessionGenerationSettings.mockImplementation(
+    agentSessionPresenter.updateSessionGenerationSettings.mockImplementation(
       () => responseQueue.shift() ?? Promise.reject(new Error('missing mocked response'))
     )
 
@@ -1234,7 +1236,7 @@ describe('ChatStatusBar model and session panels', () => {
   })
 
   it('reloads active session generation settings after switching models', async () => {
-    const { wrapper, sessionStore, newAgentPresenter } = await setup({
+    const { wrapper, sessionStore, agentSessionPresenter } = await setup({
       agentId: 'deepchat',
       hasActiveSession: true,
       activeProviderId: 'openai',
@@ -1257,13 +1259,13 @@ describe('ChatStatusBar model and session panels', () => {
         sessionStore.activeSession.modelId = 'claude-3-5-sonnet'
       }
     })
-    newAgentPresenter.getSessionGenerationSettings.mockClear()
-    newAgentPresenter.getSessionGenerationSettings.mockResolvedValue(nextSettings)
+    agentSessionPresenter.getSessionGenerationSettings.mockClear()
+    agentSessionPresenter.getSessionGenerationSettings.mockResolvedValue(nextSettings)
 
     await (wrapper.vm as any).selectModel('anthropic', 'claude-3-5-sonnet')
     await flushPromises()
 
-    expect(newAgentPresenter.getSessionGenerationSettings).toHaveBeenCalledWith('s1')
+    expect(agentSessionPresenter.getSessionGenerationSettings).toHaveBeenCalledWith('s1')
     expect((wrapper.vm as any).localSettings).toEqual(nextSettings)
   })
 
@@ -1607,21 +1609,21 @@ describe('ChatStatusBar model and session panels', () => {
     const processConfig = createAcpConfigState({}, 'gpt-5')
     const sessionConfig = createAcpConfigState({}, 'gpt-5-mini')
     const pendingSessionConfig = createDeferred<AcpConfigState | null>()
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       agentId: 'acp-agent',
       hasActiveSession: false,
       projectPath: '/tmp/workspace',
       acpProcessConfig: processConfig
     })
 
-    newAgentPresenter.getAcpSessionConfigOptions.mockImplementation(
+    agentSessionPresenter.getAcpSessionConfigOptions.mockImplementation(
       () => pendingSessionConfig.promise
     )
 
     await wrapper.setProps({ acpDraftSessionId: 'draft-1' })
     await flushPromises()
 
-    expect(newAgentPresenter.getAcpSessionConfigOptions).toHaveBeenCalledWith('draft-1')
+    expect(agentSessionPresenter.getAcpSessionConfigOptions).toHaveBeenCalledWith('draft-1')
     expect((wrapper.vm as any).acpConfigState).toBeNull()
     expect((wrapper.vm as any).acpConfigReadOnly).toBe(true)
     expect(wrapper.findAll('.acp-inline-option')).toHaveLength(0)
@@ -1639,7 +1641,7 @@ describe('ChatStatusBar model and session panels', () => {
   it('switches from warmup config to session config and writes ACP options through the session presenter', async () => {
     const processConfig = createAcpConfigState({}, 'gpt-5')
     const sessionConfig = createAcpConfigState({}, 'gpt-5-mini')
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       agentId: 'acp-agent',
       hasActiveSession: false,
       projectPath: '/tmp/workspace',
@@ -1653,7 +1655,7 @@ describe('ChatStatusBar model and session panels', () => {
     await wrapper.setProps({ acpDraftSessionId: 'draft-1' })
     await flushPromises()
 
-    expect(newAgentPresenter.getAcpSessionConfigOptions).toHaveBeenCalledWith('draft-1')
+    expect(agentSessionPresenter.getAcpSessionConfigOptions).toHaveBeenCalledWith('draft-1')
     expect(wrapper.text()).toContain('gpt-5-mini')
     expect((wrapper.vm as any).acpConfigReadOnly).toBe(false)
     ;(wrapper.vm as any).onAcpInlineOptionOpenChange('model', true)
@@ -1664,7 +1666,7 @@ describe('ChatStatusBar model and session panels', () => {
       .trigger('click')
     await flushPromises()
 
-    expect(newAgentPresenter.setAcpSessionConfigOption).toHaveBeenCalledWith(
+    expect(agentSessionPresenter.setAcpSessionConfigOption).toHaveBeenCalledWith(
       'draft-1',
       'model',
       'gpt-5'
diff --git a/test/renderer/components/McpIndicator.test.ts b/test/renderer/components/McpIndicator.test.ts
index a8f0f019f..ecd3142e5 100644
--- a/test/renderer/components/McpIndicator.test.ts
+++ b/test/renderer/components/McpIndicator.test.ts
@@ -104,7 +104,7 @@ const setup = async (options?: {
       ])
   }
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     getSessionDisabledAgentTools: vi
       .fn()
       .mockResolvedValue([...(options?.disabledAgentTools ?? [])]),
@@ -137,7 +137,7 @@ const setup = async (options?: {
   vi.doMock('@/composables/usePresenter', () => ({
     usePresenter: (name: string) => {
       if (name === 'toolPresenter') return toolPresenter
-      if (name === 'newAgentPresenter') return newAgentPresenter
+      if (name === 'agentSessionPresenter') return agentSessionPresenter
       return windowPresenter
     }
   }))
@@ -209,13 +209,13 @@ const setup = async (options?: {
     wrapper,
     draftStore,
     toolPresenter,
-    newAgentPresenter
+    agentSessionPresenter
   }
 }
 
 describe('McpIndicator', () => {
   it('renders icon-only trigger for deepchat and keeps built-in tools session scoped', async () => {
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeAgentId: 'deepchat'
     })
@@ -232,11 +232,13 @@ describe('McpIndicator', () => {
     await execButton!.trigger('click')
     await flushPromises()
 
-    expect(newAgentPresenter.updateSessionDisabledAgentTools).toHaveBeenCalledWith('s1', ['exec'])
+    expect(agentSessionPresenter.updateSessionDisabledAgentTools).toHaveBeenCalledWith('s1', [
+      'exec'
+    ])
   })
 
   it('supports enabling and disabling a whole tool group', async () => {
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeAgentId: 'deepchat',
       disabledAgentTools: ['exec']
@@ -250,14 +252,14 @@ describe('McpIndicator', () => {
     await filesystemSwitch.trigger('click')
     await flushPromises()
 
-    expect(newAgentPresenter.updateSessionDisabledAgentTools).toHaveBeenCalledWith('s1', [
+    expect(agentSessionPresenter.updateSessionDisabledAgentTools).toHaveBeenCalledWith('s1', [
       'exec',
       'read'
     ])
   })
 
   it('resets a fully disabled tool group back to all enabled when switched on', async () => {
-    const { wrapper, newAgentPresenter } = await setup({
+    const { wrapper, agentSessionPresenter } = await setup({
       hasActiveSession: true,
       activeAgentId: 'deepchat',
       disabledAgentTools: ['exec', 'read']
@@ -271,7 +273,7 @@ describe('McpIndicator', () => {
     await filesystemSwitch.trigger('click')
     await flushPromises()
 
-    expect(newAgentPresenter.updateSessionDisabledAgentTools).toHaveBeenCalledWith('s1', [])
+    expect(agentSessionPresenter.updateSessionDisabledAgentTools).toHaveBeenCalledWith('s1', [])
   })
 
   it('renders MCP badge for ACP sessions and keeps built-in tools hidden', async () => {
@@ -287,7 +289,7 @@ describe('McpIndicator', () => {
   })
 
   it('updates draft disabled tools for deepchat new thread mode', async () => {
-    const { wrapper, draftStore, newAgentPresenter } = await setup({
+    const { wrapper, draftStore, agentSessionPresenter } = await setup({
       hasActiveSession: false,
       selectedAgentId: 'deepchat'
     })
@@ -299,7 +301,7 @@ describe('McpIndicator', () => {
     await flushPromises()
 
     expect(draftStore.disabledAgentTools).toEqual(['exec'])
-    expect(newAgentPresenter.updateSessionDisabledAgentTools).not.toHaveBeenCalled()
+    expect(agentSessionPresenter.updateSessionDisabledAgentTools).not.toHaveBeenCalled()
   })
 
   it('renders subagent as a regular tool button inside Agent Core and emits updates', async () => {
diff --git a/test/renderer/components/NewThreadPage.test.ts b/test/renderer/components/NewThreadPage.test.ts
index 60e6d8cf6..0c89df8c8 100644
--- a/test/renderer/components/NewThreadPage.test.ts
+++ b/test/renderer/components/NewThreadPage.test.ts
@@ -126,7 +126,7 @@ const setup = async (options?: {
     )
   }
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     ensureAcpDraftSession: vi.fn().mockImplementation(
       options?.ensureAcpDraftSession ??
         (() => {
@@ -152,7 +152,7 @@ const setup = async (options?: {
   }))
   vi.doMock('@/composables/usePresenter', () => ({
     usePresenter: (name: string) =>
-      name === 'configPresenter' ? configPresenter : newAgentPresenter
+      name === 'configPresenter' ? configPresenter : agentSessionPresenter
   }))
   vi.doMock('vue-i18n', () => ({
     useI18n: () => ({
@@ -202,20 +202,20 @@ const setup = async (options?: {
     agentStore,
     modelStore,
     draftStore,
-    newAgentPresenter
+    agentSessionPresenter
   }
 }
 
 describe('NewThreadPage ACP draft session bootstrap', () => {
   it('uses the preselected project path when default project selection is already applied', async () => {
-    const { newAgentPresenter } = await setup({
+    const { agentSessionPresenter } = await setup({
       selectedProject: {
         path: '/tmp/default-workspace',
         name: 'default-workspace'
       }
     })
 
-    expect(newAgentPresenter.ensureAcpDraftSession).toHaveBeenCalledWith({
+    expect(agentSessionPresenter.ensureAcpDraftSession).toHaveBeenCalledWith({
       agentId: 'acp-agent',
       projectDir: '/tmp/default-workspace',
       permissionMode: 'full_access'
@@ -223,9 +223,9 @@ describe('NewThreadPage ACP draft session bootstrap', () => {
   })
 
   it('ensures ACP draft session and passes session-id to ChatInputBox', async () => {
-    const { wrapper, newAgentPresenter } = await setup()
+    const { wrapper, agentSessionPresenter } = await setup()
 
-    expect(newAgentPresenter.ensureAcpDraftSession).toHaveBeenCalledWith({
+    expect(agentSessionPresenter.ensureAcpDraftSession).toHaveBeenCalledWith({
       agentId: 'acp-agent',
       projectDir: '/tmp/workspace',
       permissionMode: 'full_access'
diff --git a/test/renderer/components/RemoteSettings.test.ts b/test/renderer/components/RemoteSettings.test.ts
index 9c0de3d82..2bf2a18a3 100644
--- a/test/renderer/components/RemoteSettings.test.ts
+++ b/test/renderer/components/RemoteSettings.test.ts
@@ -321,7 +321,7 @@ const setup = async (options: SetupOptions = {}) => {
     }))
   }
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     getAgents: vi.fn(async () => [
       { id: 'deepchat', name: 'DeepChat', type: 'deepchat', enabled: true },
       { id: 'deepchat-alt', name: 'DeepChat Alt', type: 'deepchat', enabled: false },
@@ -435,7 +435,7 @@ const setup = async (options: SetupOptions = {}) => {
 
   vi.doMock('@/composables/usePresenter', () => ({
     usePresenter: (name: string) => {
-      if (name === 'newAgentPresenter') return newAgentPresenter
+      if (name === 'agentSessionPresenter') return agentSessionPresenter
       if (name === 'projectPresenter') return projectPresenter
       return null
     },
@@ -562,7 +562,7 @@ const setup = async (options: SetupOptions = {}) => {
     remoteState,
     feishuState,
     remoteControlPresenter,
-    newAgentPresenter,
+    agentSessionPresenter,
     projectPresenter,
     toast,
     tabsComponents
diff --git a/test/renderer/composables/usePresenter.test.ts b/test/renderer/composables/usePresenter.test.ts
index 28d0f727b..fe1e23c63 100644
--- a/test/renderer/composables/usePresenter.test.ts
+++ b/test/renderer/composables/usePresenter.test.ts
@@ -15,7 +15,7 @@ describe('usePresenter', () => {
 
   it('preserves undefined properties in object payloads across IPC', async () => {
     const { usePresenter } = await import('@/composables/usePresenter')
-    const presenter = usePresenter('newAgentPresenter')
+    const presenter = usePresenter('agentSessionPresenter')
 
     await presenter.updateSessionGenerationSettings('s1', {
       temperature: 0.7,
diff --git a/test/renderer/pages/NewThreadPage.test.ts b/test/renderer/pages/NewThreadPage.test.ts
index c92a8f29f..de7ebca8a 100644
--- a/test/renderer/pages/NewThreadPage.test.ts
+++ b/test/renderer/pages/NewThreadPage.test.ts
@@ -77,7 +77,7 @@ const setup = async (pendingModelId: string) => {
       disabledAgentTools: []
     })
   }
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     ensureAcpDraftSession: vi.fn()
   }
 
@@ -99,7 +99,7 @@ const setup = async (pendingModelId: string) => {
   vi.doMock('@/composables/usePresenter', () => ({
     usePresenter: (name: string) => {
       if (name === 'configPresenter') return configPresenter
-      if (name === 'newAgentPresenter') return newAgentPresenter
+      if (name === 'agentSessionPresenter') return agentSessionPresenter
       return {}
     }
   }))
diff --git a/test/renderer/stores/messageStore.test.ts b/test/renderer/stores/messageStore.test.ts
index c6a26ae07..ce5d5012a 100644
--- a/test/renderer/stores/messageStore.test.ts
+++ b/test/renderer/stores/messageStore.test.ts
@@ -12,7 +12,7 @@ function createDeferred<T>() {
 const setupStore = async () => {
   vi.resetModules()
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     getMessages: vi.fn().mockResolvedValue([]),
     getMessage: vi.fn().mockResolvedValue(null)
   }
@@ -25,7 +25,7 @@ const setupStore = async () => {
   }))
 
   vi.doMock('@/composables/usePresenter', () => ({
-    usePresenter: () => newAgentPresenter
+    usePresenter: () => agentSessionPresenter
   }))
 
   vi.doMock('@/stores/ui/session', () => ({
@@ -40,13 +40,13 @@ const setupStore = async () => {
 
   const { useMessageStore } = await import('@/stores/ui/message')
   const store = useMessageStore()
-  return { store, newAgentPresenter }
+  return { store, agentSessionPresenter }
 }
 
 describe('messageStore', () => {
   it('loadMessages only hydrates persisted messages', async () => {
-    const { store, newAgentPresenter } = await setupStore()
-    newAgentPresenter.getMessages.mockResolvedValueOnce([
+    const { store, agentSessionPresenter } = await setupStore()
+    agentSessionPresenter.getMessages.mockResolvedValueOnce([
       {
         id: 'm1',
         sessionId: 's1',
@@ -64,17 +64,17 @@ describe('messageStore', () => {
 
     await store.loadMessages('s1')
 
-    expect(newAgentPresenter.getMessages).toHaveBeenCalledWith('s1')
+    expect(agentSessionPresenter.getMessages).toHaveBeenCalledWith('s1')
     expect(store.messages.value).toHaveLength(1)
     expect(store.messages.value[0]?.metadata).toContain('"messageType":"compaction"')
   })
 
   it('ignores stale loadMessages results', async () => {
-    const { store, newAgentPresenter } = await setupStore()
+    const { store, agentSessionPresenter } = await setupStore()
     const firstLoad = createDeferred<any[]>()
     const secondLoad = createDeferred<any[]>()
 
-    newAgentPresenter.getMessages
+    agentSessionPresenter.getMessages
       .mockReturnValueOnce(firstLoad.promise)
       .mockReturnValueOnce(secondLoad.promise)
 
@@ -120,7 +120,7 @@ describe('messageStore', () => {
   })
 
   it('keeps rate-limit stream messages ephemeral and skips message hydration', async () => {
-    const { store, newAgentPresenter } = await setupStore()
+    const { store, agentSessionPresenter } = await setupStore()
     const responseHandler = (
       (window as any).electron.ipcRenderer.on as ReturnType<typeof vi.fn>
     ).mock.calls.find(([eventName]) => eventName === 'stream:response')?.[1]
@@ -154,7 +154,7 @@ describe('messageStore', () => {
     expect(store.currentStreamMessageId.value).toBe('__rate_limit__:s1:1')
     expect(store.streamingBlocks.value).toHaveLength(1)
     expect(store.messages.value).toHaveLength(0)
-    expect(newAgentPresenter.getMessage).not.toHaveBeenCalled()
+    expect(agentSessionPresenter.getMessage).not.toHaveBeenCalled()
 
     responseHandler(
       {},
@@ -167,6 +167,6 @@ describe('messageStore', () => {
 
     expect(store.streamingBlocks.value).toEqual([])
     expect(store.messages.value).toHaveLength(0)
-    expect(newAgentPresenter.getMessage).not.toHaveBeenCalled()
+    expect(agentSessionPresenter.getMessage).not.toHaveBeenCalled()
   })
 })
diff --git a/test/renderer/stores/pageRouter.test.ts b/test/renderer/stores/pageRouter.test.ts
index 07c184e2e..16871cf6c 100644
--- a/test/renderer/stores/pageRouter.test.ts
+++ b/test/renderer/stores/pageRouter.test.ts
@@ -1,9 +1,9 @@
 import { describe, expect, it, vi } from 'vitest'
 
-const setupStore = async (options?: { activeNewSession?: { id: string } | null }) => {
+const setupStore = async (options?: { activeAgentSession?: { id: string } | null }) => {
   vi.resetModules()
-  const newAgentPresenter = {
-    getActiveSession: vi.fn().mockResolvedValue(options?.activeNewSession ?? null)
+  const agentSessionPresenter = {
+    getActiveSession: vi.fn().mockResolvedValue(options?.activeAgentSession ?? null)
   }
 
   vi.doMock('pinia', () => ({
@@ -12,7 +12,7 @@ const setupStore = async (options?: { activeNewSession?: { id: string } | null }
 
   vi.doMock('@/composables/usePresenter', () => ({
     usePresenter: (name: string) => {
-      if (name === 'newAgentPresenter') return newAgentPresenter
+      if (name === 'agentSessionPresenter') return agentSessionPresenter
       return {}
     }
   }))
@@ -31,36 +31,36 @@ const setupStore = async (options?: { activeNewSession?: { id: string } | null }
 
   return {
     store,
-    newAgentPresenter
+    agentSessionPresenter
   }
 }
 
 describe('pageRouter.initialize', () => {
-  it('uses the active new-agent session when it exists', async () => {
-    const { store, newAgentPresenter } = await setupStore({
-      activeNewSession: { id: 'new-session-1' }
+  it('uses the active agent session when it exists', async () => {
+    const { store, agentSessionPresenter } = await setupStore({
+      activeAgentSession: { id: 'new-session-1' }
     })
 
     await store.initialize()
 
-    expect(newAgentPresenter.getActiveSession).toHaveBeenCalledWith(1)
+    expect(agentSessionPresenter.getActiveSession).toHaveBeenCalledWith(1)
     expect(store.route.value).toEqual({ name: 'chat', sessionId: 'new-session-1' })
   })
 
-  it('defaults to new thread when no new-agent active session exists', async () => {
-    const { store, newAgentPresenter } = await setupStore({
-      activeNewSession: null
+  it('defaults to new thread when no active agent session exists', async () => {
+    const { store, agentSessionPresenter } = await setupStore({
+      activeAgentSession: null
     })
 
     await store.initialize()
 
-    expect(newAgentPresenter.getActiveSession).toHaveBeenCalledWith(1)
+    expect(agentSessionPresenter.getActiveSession).toHaveBeenCalledWith(1)
     expect(store.route.value).toEqual({ name: 'newThread' })
   })
 
   it('allows manually going to new thread', async () => {
     const { store } = await setupStore({
-      activeNewSession: null
+      activeAgentSession: null
     })
     store.goToNewThread()
 
@@ -69,7 +69,7 @@ describe('pageRouter.initialize', () => {
 
   it('can force-refresh the new thread view', async () => {
     const { store } = await setupStore({
-      activeNewSession: null
+      activeAgentSession: null
     })
 
     expect(store.newThreadRefreshKey.value).toBe(0)
@@ -84,7 +84,7 @@ describe('pageRouter.initialize', () => {
   it('falls back to new thread when active session lookup fails', async () => {
     vi.resetModules()
 
-    const newAgentPresenter = {
+    const agentSessionPresenter = {
       getActiveSession: vi.fn().mockRejectedValue(new Error('boom'))
     }
 
@@ -94,7 +94,7 @@ describe('pageRouter.initialize', () => {
 
     vi.doMock('@/composables/usePresenter', () => ({
       usePresenter: (name: string) => {
-        if (name === 'newAgentPresenter') return newAgentPresenter
+        if (name === 'agentSessionPresenter') return agentSessionPresenter
         return {}
       }
     }))
diff --git a/test/renderer/stores/pendingInputStore.test.ts b/test/renderer/stores/pendingInputStore.test.ts
index a130ab7e3..d613d0220 100644
--- a/test/renderer/stores/pendingInputStore.test.ts
+++ b/test/renderer/stores/pendingInputStore.test.ts
@@ -31,7 +31,7 @@ const setupStore = async () => {
   vi.resetModules()
   setActivePinia(createPinia())
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     listPendingInputs: vi.fn(),
     queuePendingInput: vi.fn(),
     updateQueuedInput: vi.fn(),
@@ -42,7 +42,7 @@ const setupStore = async () => {
   }
 
   vi.doMock('@/composables/usePresenter', () => ({
-    usePresenter: () => newAgentPresenter
+    usePresenter: () => agentSessionPresenter
   }))
   ;(
     window as typeof window & {
@@ -64,17 +64,17 @@ const setupStore = async () => {
 
   return {
     store: usePendingInputStore(),
-    newAgentPresenter
+    agentSessionPresenter
   }
 }
 
 describe('pendingInput store', () => {
   it('ignores stale load results after the active session changes', async () => {
-    const { store, newAgentPresenter } = await setupStore()
+    const { store, agentSessionPresenter } = await setupStore()
     const firstLoad = createDeferred<ReturnType<typeof createPendingItem>[]>()
     const secondLoad = createDeferred<ReturnType<typeof createPendingItem>[]>()
 
-    newAgentPresenter.listPendingInputs
+    agentSessionPresenter.listPendingInputs
       .mockReturnValueOnce(firstLoad.promise)
       .mockReturnValueOnce(secondLoad.promise)
 
@@ -99,10 +99,10 @@ describe('pendingInput store', () => {
   })
 
   it('preserves clear state when an in-flight load later fails', async () => {
-    const { store, newAgentPresenter } = await setupStore()
+    const { store, agentSessionPresenter } = await setupStore()
     const load = createDeferred<ReturnType<typeof createPendingItem>[]>()
 
-    newAgentPresenter.listPendingInputs.mockReturnValueOnce(load.promise)
+    agentSessionPresenter.listPendingInputs.mockReturnValueOnce(load.promise)
 
     const loadPromise = store.loadPendingInputs('s1')
     expect(store.currentSessionId).toBe('s1')
diff --git a/test/renderer/stores/sessionStore.test.ts b/test/renderer/stores/sessionStore.test.ts
index ea5387ddc..9ca6c5c89 100644
--- a/test/renderer/stores/sessionStore.test.ts
+++ b/test/renderer/stores/sessionStore.test.ts
@@ -3,7 +3,7 @@ import { describe, expect, it, vi } from 'vitest'
 const setupStore = async () => {
   vi.resetModules()
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     getSessionList: vi.fn().mockResolvedValue([]),
     getActiveSession: vi.fn().mockResolvedValue(null),
     createSession: vi.fn(),
@@ -32,7 +32,7 @@ const setupStore = async () => {
   }))
 
   vi.doMock('@/composables/usePresenter', () => ({
-    usePresenter: (name: string) => (name === 'tabPresenter' ? tabPresenter : newAgentPresenter)
+    usePresenter: (name: string) => (name === 'tabPresenter' ? tabPresenter : agentSessionPresenter)
   }))
 
   vi.doMock('@/stores/ui/pageRouter', () => ({
@@ -67,7 +67,7 @@ const setupStore = async () => {
       handler(undefined, payload)
     }
   }
-  return { store, clearStreamingState, newAgentPresenter, pageRouter, emitIpc, SESSION_EVENTS }
+  return { store, clearStreamingState, agentSessionPresenter, pageRouter, emitIpc, SESSION_EVENTS }
 }
 
 describe('sessionStore.getFilteredGroups', () => {
@@ -156,18 +156,18 @@ describe('sessionStore.getFilteredGroups', () => {
 
 describe('sessionStore streaming cleanup', () => {
   it('clears streaming state when switching active session', async () => {
-    const { store, clearStreamingState, newAgentPresenter } = await setupStore()
+    const { store, clearStreamingState, agentSessionPresenter } = await setupStore()
     store.activeSessionId.value = 'session-a'
 
     await store.selectSession('session-b')
 
-    expect(newAgentPresenter.activateSession).toHaveBeenCalledWith(1, 'session-b')
+    expect(agentSessionPresenter.activateSession).toHaveBeenCalledWith(1, 'session-b')
     expect(clearStreamingState).toHaveBeenCalledTimes(1)
   })
 
   it('syncs active session from presenter when fetching sessions', async () => {
-    const { store, newAgentPresenter } = await setupStore()
-    newAgentPresenter.getSessionList.mockResolvedValueOnce([
+    const { store, agentSessionPresenter } = await setupStore()
+    agentSessionPresenter.getSessionList.mockResolvedValueOnce([
       {
         id: 'session-sync-1',
         title: 'Session Sync',
@@ -182,20 +182,20 @@ describe('sessionStore streaming cleanup', () => {
         updatedAt: 2
       }
     ])
-    newAgentPresenter.getActiveSession.mockResolvedValueOnce({
+    agentSessionPresenter.getActiveSession.mockResolvedValueOnce({
       id: 'session-sync-1'
     })
 
     await store.fetchSessions()
 
-    expect(newAgentPresenter.getActiveSession).toHaveBeenCalledWith(1)
+    expect(agentSessionPresenter.getActiveSession).toHaveBeenCalledWith(1)
     expect(store.activeSessionId.value).toBe('session-sync-1')
   })
 
   it('clears streaming when fetch detects active session switch', async () => {
-    const { store, clearStreamingState, newAgentPresenter } = await setupStore()
+    const { store, clearStreamingState, agentSessionPresenter } = await setupStore()
     store.activeSessionId.value = 'session-a'
-    newAgentPresenter.getActiveSession.mockResolvedValueOnce({
+    agentSessionPresenter.getActiveSession.mockResolvedValueOnce({
       id: 'session-b'
     })
 
@@ -206,10 +206,10 @@ describe('sessionStore streaming cleanup', () => {
   })
 
   it('returns to new thread when active session becomes unavailable', async () => {
-    const { store, clearStreamingState, newAgentPresenter, pageRouter } = await setupStore()
+    const { store, clearStreamingState, agentSessionPresenter, pageRouter } = await setupStore()
     store.activeSessionId.value = 'session-a'
     pageRouter.currentRoute = 'chat'
-    newAgentPresenter.getActiveSession.mockResolvedValueOnce(null)
+    agentSessionPresenter.getActiveSession.mockResolvedValueOnce(null)
 
     await store.fetchSessions()
 
@@ -219,13 +219,13 @@ describe('sessionStore streaming cleanup', () => {
   })
 
   it('reloads sessions when the session list update event fires', async () => {
-    const { newAgentPresenter, emitIpc, SESSION_EVENTS } = await setupStore()
+    const { agentSessionPresenter, emitIpc, SESSION_EVENTS } = await setupStore()
 
     emitIpc(SESSION_EVENTS.LIST_UPDATED)
     await new Promise((resolve) => setTimeout(resolve, 0))
 
-    expect(newAgentPresenter.getSessionList).toHaveBeenCalledTimes(1)
-    expect(newAgentPresenter.getActiveSession).toHaveBeenCalledTimes(1)
+    expect(agentSessionPresenter.getSessionList).toHaveBeenCalledTimes(1)
+    expect(agentSessionPresenter.getActiveSession).toHaveBeenCalledTimes(1)
   })
 
   it('routes to chat when an external session activation targets this renderer', async () => {
diff --git a/test/renderer/stores/spotlight.test.ts b/test/renderer/stores/spotlight.test.ts
index 5f8d805a3..b51cec64a 100644
--- a/test/renderer/stores/spotlight.test.ts
+++ b/test/renderer/stores/spotlight.test.ts
@@ -8,7 +8,7 @@ const setupStore = async (options?: {
 }) => {
   vi.resetModules()
 
-  const newAgentPresenter = {
+  const agentSessionPresenter = {
     searchHistory: vi.fn().mockResolvedValue(options?.historyHits ?? [])
   }
   const windowPresenter = {
@@ -56,8 +56,8 @@ const setupStore = async (options?: {
 
   vi.doMock('@/composables/usePresenter', () => ({
     usePresenter: (name: string) => {
-      if (name === 'newAgentPresenter') {
-        return newAgentPresenter
+      if (name === 'agentSessionPresenter') {
+        return agentSessionPresenter
       }
 
       if (name === 'windowPresenter') {

From 0f4f851773154205367bb329b1e127a3e5c3f0c2 Mon Sep 17 00:00:00 2001
From: zerob13 <zerob13@gmail.com>
Date: Fri, 3 Apr 2026 22:35:16 +0800
Subject: [PATCH 3/3] fix(agent-runtime): preserve queued inputs

---
 .../presenter/agentRuntimePresenter/index.ts  | 53 ++++++++++++++++---
 .../presenter/agentSessionPresenter/index.ts  |  6 +--
 src/shared/types/agent-interface.d.ts         | 16 +++++-
 .../agentRuntimePresenter.test.ts             | 29 ++++++++++
 .../agentSessionPresenter.test.ts             | 36 +++++++++++++
 .../agentSessionPresenter/integration.test.ts | 31 ++++++++++-
 6 files changed, 157 insertions(+), 14 deletions(-)

diff --git a/src/main/presenter/agentRuntimePresenter/index.ts b/src/main/presenter/agentRuntimePresenter/index.ts
index b413216b5..969c63518 100644
--- a/src/main/presenter/agentRuntimePresenter/index.ts
+++ b/src/main/presenter/agentRuntimePresenter/index.ts
@@ -4,8 +4,10 @@ import type {
   DeepChatSessionState,
   IAgentImplementation,
   MessageFile,
+  PendingInputEnqueueSource,
   PendingSessionInputRecord,
   PermissionMode,
+  QueuePendingInputOptions,
   SendMessageInput,
   SessionCompactionState,
   SessionGenerationSettings,
@@ -322,7 +324,8 @@ export class AgentRuntimePresenter implements IAgentImplementation {
 
   async queuePendingInput(
     sessionId: string,
-    content: string | SendMessageInput
+    content: string | SendMessageInput,
+    options?: QueuePendingInputOptions
   ): Promise<PendingSessionInputRecord> {
     const state = await this.getSessionState(sessionId)
     if (!state) {
@@ -330,7 +333,7 @@ export class AgentRuntimePresenter implements IAgentImplementation {
     }
 
     const shouldClaimImmediately =
-      this.isAwaitingToolQuestionFollowUp(sessionId) ||
+      ((options?.source ?? 'send') === 'send' && this.isAwaitingToolQuestionFollowUp(sessionId)) ||
       this.shouldStartQueuedInputImmediately(sessionId, state.status)
     const record = this.pendingInputCoordinator.queuePendingInput(sessionId, content, {
       state: shouldClaimImmediately ? 'claimed' : 'pending'
@@ -339,7 +342,8 @@ export class AgentRuntimePresenter implements IAgentImplementation {
     if (record.state === 'claimed') {
       void this.processMessage(sessionId, record.payload, {
         projectDir: this.resolveProjectDir(sessionId),
-        pendingQueueItemId: record.id
+        pendingQueueItemId: record.id,
+        pendingQueueItemSource: options?.source ?? 'send'
       })
       return record
     }
@@ -398,6 +402,7 @@ export class AgentRuntimePresenter implements IAgentImplementation {
       projectDir?: string | null
       emitRefreshBeforeStream?: boolean
       pendingQueueItemId?: string
+      pendingQueueItemSource?: PendingInputEnqueueSource
     }
   ): Promise<void> {
     const state = this.runtimeState.get(sessionId)
@@ -528,7 +533,7 @@ export class AgentRuntimePresenter implements IAgentImplementation {
       assistantMessageId = this.messageStore.createAssistantMessage(sessionId, assistantOrderSeq)
       this.throwIfAbortRequested(preStreamAbortSignal)
 
-      if (context?.pendingQueueItemId) {
+      if (context?.pendingQueueItemId && context.pendingQueueItemSource !== 'queue') {
         this.pendingInputCoordinator.consumeQueuedInput(sessionId, context.pendingQueueItemId)
         consumedPendingQueueItem = true
       }
@@ -546,6 +551,20 @@ export class AgentRuntimePresenter implements IAgentImplementation {
         tools,
         interleavedReasoning
       })
+      if (context?.pendingQueueItemId && !consumedPendingQueueItem) {
+        if (context.pendingQueueItemSource === 'queue') {
+          if (result.status === 'completed' || result.status === 'paused') {
+            this.pendingInputCoordinator.consumeQueuedInput(sessionId, context.pendingQueueItemId)
+            consumedPendingQueueItem = true
+          } else {
+            this.rollbackClaimedQueueInputTurn(sessionId, context.pendingQueueItemId, userMessageId)
+            consumedPendingQueueItem = true
+          }
+        } else {
+          this.pendingInputCoordinator.consumeQueuedInput(sessionId, context.pendingQueueItemId)
+          consumedPendingQueueItem = true
+        }
+      }
       try {
         this.applyProcessResultStatus(sessionId, result, runId)
       } finally {
@@ -558,10 +577,15 @@ export class AgentRuntimePresenter implements IAgentImplementation {
       console.error('[DeepChatAgent] processMessage error:', err)
       if (context?.pendingQueueItemId && !consumedPendingQueueItem) {
         try {
-          this.pendingInputCoordinator.releaseClaimedQueueInput(
-            sessionId,
-            context.pendingQueueItemId
-          )
+          if (context.pendingQueueItemSource === 'queue') {
+            this.rollbackClaimedQueueInputTurn(sessionId, context.pendingQueueItemId, userMessageId)
+          } else {
+            this.pendingInputCoordinator.releaseClaimedQueueInput(
+              sessionId,
+              context.pendingQueueItemId
+            )
+          }
+          consumedPendingQueueItem = true
         } catch (releaseError) {
           console.warn('[DeepChatAgent] failed to release claimed queue input:', releaseError)
         }
@@ -1758,6 +1782,19 @@ export class AgentRuntimePresenter implements IAgentImplementation {
     return (reason === 'enqueue' || reason === 'resume') && status === 'error'
   }
 
+  private rollbackClaimedQueueInputTurn(
+    sessionId: string,
+    pendingQueueItemId: string,
+    userMessageId: string | null
+  ): void {
+    const userMessage = userMessageId ? this.messageStore.getMessage(userMessageId) : null
+    if (userMessage) {
+      this.invalidateSummaryIfNeeded(sessionId, userMessage.orderSeq)
+      this.messageStore.deleteFromOrderSeq(sessionId, userMessage.orderSeq)
+    }
+    this.pendingInputCoordinator.releaseClaimedQueueInput(sessionId, pendingQueueItemId)
+  }
+
   private registerActiveGeneration(
     sessionId: string,
     messageId: string,
diff --git a/src/main/presenter/agentSessionPresenter/index.ts b/src/main/presenter/agentSessionPresenter/index.ts
index 344cd4ec2..ef662be83 100644
--- a/src/main/presenter/agentSessionPresenter/index.ts
+++ b/src/main/presenter/agentSessionPresenter/index.ts
@@ -381,7 +381,7 @@ export class AgentSessionPresenter {
     if (normalizedInput.text.trim() || (normalizedInput.files?.length ?? 0) > 0) {
       console.log(`[AgentSessionPresenter] firing queuePendingInput (non-blocking)`)
       if (agent.queuePendingInput) {
-        agent.queuePendingInput(sessionId, normalizedInput).catch((err) => {
+        agent.queuePendingInput(sessionId, normalizedInput, { source: 'send' }).catch((err) => {
           console.error('[AgentSessionPresenter] queuePendingInput failed:', err)
         })
       } else {
@@ -667,7 +667,7 @@ export class AgentSessionPresenter {
       session.projectDir ?? null
     )
     if (agent.queuePendingInput) {
-      await agent.queuePendingInput(sessionId, normalizedInput)
+      await agent.queuePendingInput(sessionId, normalizedInput, { source: 'send' })
       if (!hadMessages && !wasDraft) {
         void this.generateSessionTitle(sessionId, session.title, providerId, state?.modelId ?? '')
       }
@@ -726,7 +726,7 @@ export class AgentSessionPresenter {
       currentSession.agentId,
       currentSession.projectDir ?? null
     )
-    return await agent.queuePendingInput(sessionId, normalizedInput)
+    return await agent.queuePendingInput(sessionId, normalizedInput, { source: 'queue' })
   }
 
   async updateQueuedInput(sessionId: string, itemId: string, content: string | SendMessageInput) {
diff --git a/src/shared/types/agent-interface.d.ts b/src/shared/types/agent-interface.d.ts
index ed6b299a9..641eed68a 100644
--- a/src/shared/types/agent-interface.d.ts
+++ b/src/shared/types/agent-interface.d.ts
@@ -33,6 +33,12 @@ export interface DeepChatSessionState {
   permissionMode: PermissionMode
 }
 
+export type PendingInputEnqueueSource = 'send' | 'queue'
+
+export interface QueuePendingInputOptions {
+  source?: PendingInputEnqueueSource
+}
+
 export interface IAgentImplementation {
   /** Initialize a new session for this agent */
   initSession(
@@ -57,14 +63,20 @@ export interface IAgentImplementation {
   processMessage(
     sessionId: string,
     content: string | SendMessageInput,
-    context?: { projectDir?: string | null; emitRefreshBeforeStream?: boolean }
+    context?: {
+      projectDir?: string | null
+      emitRefreshBeforeStream?: boolean
+      pendingQueueItemId?: string
+      pendingQueueItemSource?: PendingInputEnqueueSource
+    }
   ): Promise<void>
 
   /** Manage waiting lane inputs */
   listPendingInputs?(sessionId: string): Promise<PendingSessionInputRecord[]>
   queuePendingInput?(
     sessionId: string,
-    content: string | SendMessageInput
+    content: string | SendMessageInput,
+    options?: QueuePendingInputOptions
   ): Promise<PendingSessionInputRecord>
   updateQueuedInput?(
     sessionId: string,
diff --git a/test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts b/test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts
index 807f236c9..e888b5ea3 100644
--- a/test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts
+++ b/test/main/presenter/agentRuntimePresenter/agentRuntimePresenter.test.ts
@@ -2256,6 +2256,35 @@ describe('AgentRuntimePresenter', () => {
       )
       expect(result).toBe(claimedRecord)
     })
+
+    it('keeps queue-origin inputs pending while waiting for a tool follow-up', async () => {
+      await agent.initSession('s1', { providerId: 'openai', modelId: 'gpt-4' })
+
+      const pendingRecord = {
+        id: 'q1',
+        sessionId: 's1',
+        mode: 'queue',
+        state: 'pending',
+        payload: { text: 'Queued later', files: [] },
+        queueOrder: 1,
+        claimedAt: null,
+        consumedAt: null,
+        createdAt: 1,
+        updatedAt: 1
+      }
+      const queueSpy = vi
+        .spyOn((agent as any).pendingInputCoordinator, 'queuePendingInput')
+        .mockReturnValue(pendingRecord)
+      const processSpy = vi.spyOn(agent, 'processMessage').mockResolvedValue()
+      vi.spyOn(agent as any, 'isAwaitingToolQuestionFollowUp').mockReturnValue(true)
+      vi.spyOn(agent as any, 'shouldStartQueuedInputImmediately').mockReturnValue(false)
+
+      const result = await agent.queuePendingInput('s1', 'Queued later', { source: 'queue' })
+
+      expect(queueSpy).toHaveBeenCalledWith('s1', 'Queued later', { state: 'pending' })
+      expect(processSpy).not.toHaveBeenCalled()
+      expect(result).toBe(pendingRecord)
+    })
   })
 
   describe('getMessages / getMessageIds / getMessage', () => {
diff --git a/test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts b/test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts
index 1314ca87c..3a6d3d850 100644
--- a/test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts
+++ b/test/main/presenter/agentSessionPresenter/agentSessionPresenter.test.ts
@@ -849,6 +849,42 @@ describe('AgentSessionPresenter', () => {
     })
   })
 
+  describe('queuePendingInput', () => {
+    it('passes queue-origin metadata to agents for explicit queued inputs', async () => {
+      const queuePendingInput = vi.fn().mockResolvedValue({
+        id: 'q1',
+        sessionId: 's1',
+        mode: 'queue',
+        state: 'pending',
+        payload: { text: 'Later', files: [] },
+        queueOrder: 1,
+        claimedAt: null,
+        consumedAt: null,
+        createdAt: 1,
+        updatedAt: 1
+      })
+      ;(deepChatAgent as any).queuePendingInput = queuePendingInput
+      sqlitePresenter.newSessionsTable.get.mockReturnValue({
+        id: 's1',
+        agent_id: 'deepchat',
+        title: 'Test',
+        project_dir: '/tmp/workspace',
+        is_pinned: 0,
+        is_draft: 0,
+        created_at: 1000,
+        updated_at: 1000
+      })
+
+      await presenter.queuePendingInput('s1', 'Later')
+
+      expect(queuePendingInput).toHaveBeenCalledWith(
+        's1',
+        { text: 'Later', files: [] },
+        { source: 'queue' }
+      )
+    })
+  })
+
   describe('ensureAcpDraftSession', () => {
     it('creates draft session and prepares ACP session setup', async () => {
       configPresenter.getAcpAgents.mockResolvedValue([
diff --git a/test/main/presenter/agentSessionPresenter/integration.test.ts b/test/main/presenter/agentSessionPresenter/integration.test.ts
index 787a676b0..e38e76da6 100644
--- a/test/main/presenter/agentSessionPresenter/integration.test.ts
+++ b/test/main/presenter/agentSessionPresenter/integration.test.ts
@@ -83,7 +83,35 @@ function createMockSqlitePresenter() {
         }
       ),
       get: vi.fn((id: string) => sessionsStore.get(id)),
-      list: vi.fn(() => Array.from(sessionsStore.values())),
+      list: vi.fn(
+        (filters?: {
+          agentId?: string
+          projectDir?: string
+          includeSubagents?: boolean
+          parentSessionId?: string
+        }) => {
+          return Array.from(sessionsStore.values())
+            .filter((row) => {
+              if (filters?.agentId && row.agent_id !== filters.agentId) {
+                return false
+              }
+              if (filters?.projectDir && row.project_dir !== filters.projectDir) {
+                return false
+              }
+              if (filters?.includeSubagents !== true && filters?.parentSessionId === undefined) {
+                return (row.session_kind ?? 'regular') === 'regular'
+              }
+              if (
+                filters?.parentSessionId !== undefined &&
+                (row.parent_session_id ?? null) !== filters.parentSessionId
+              ) {
+                return false
+              }
+              return true
+            })
+            .sort((left, right) => right.updated_at - left.updated_at)
+        }
+      ),
       getDisabledAgentTools: vi.fn().mockReturnValue([]),
       updateDisabledAgentTools: vi.fn(),
       update: vi.fn(),
@@ -439,6 +467,7 @@ function createMockLlmProviderPresenter() {
         })()
       })
     }),
+    executeWithRateLimit: vi.fn().mockResolvedValue(undefined),
     generateText: vi.fn().mockResolvedValue({
       content: ['## Current Goal', '- Continue the conversation'].join('\n')
     }),