refactor: remove the ExploreAgent tool (#4176)

* refactor: remove the ExploreAgent tool

Remove the bounded scanner, its production registration and prompt wiring, and its dedicated transcript presentation. Keep Deep Research on the standard read-only tools and preserve old persisted results by folding them to ordinary historical text.

Generated-by: Codex

* fix: preserve retired ExploreAgent history

Select the first non-empty historical result text and fold retired ExploreAgent RuntimeEvent results before model replay. Rename the remaining Deep Research session-profile test to remove stale tool naming.

Generated-by: Codex

* fix: simplify retired ExploreAgent compatibility

Generated-by: Codex

* chore: finish ExploreAgent removal cleanup

Generated-by: Codex

* chore: remove retired story imports

Generated-by: Codex

* test: preserve generic long-intent containment

Generated-by: Codex

* chore: align protocol compatibility declaration

Generated-by: Codex

* chore: remove retired ExploreAgent examples

Generated-by: Codex

Author: Astro-Han

apps/desktop/src/main/__tests__/create-session-input.test.ts

@@ -30,7 +30,7 @@
 
 import { strict as assert } from 'node:assert';
 import { describe, it } from 'node:test';
-import { DEEP_RESEARCH_SESSION_LABEL } from '@maka/core/explore-agent';
+import { DEEP_RESEARCH_SESSION_LABEL } from '@maka/core/deep-research';
 
 import { DEFAULT_SESSION_NAME } from '@maka/core/session-name';
 

apps/desktop/src/main/create-session-input.ts

@@ -43,7 +43,7 @@ import type { OrchestrationMode } from '@maka/core/orchestration';
 
 import type { PermissionMode } from '@maka/core/permission';
 
-import type { SessionStartMode } from '@maka/core/explore-agent';
+import type { SessionStartMode } from '@maka/core/deep-research';
 import { DEFAULT_SESSION_NAME } from '@maka/core/session-name';
 
 import { isChatDefaultPermissionMode } from '@maka/core/settings';
@@ -52,7 +52,7 @@ import { isCollaborationMode } from '@maka/core/collaboration';
 
 import { isOrchestrationMode } from '@maka/core/orchestration';
 
-import { isSessionStartMode } from '@maka/core/explore-agent';
+import { isSessionStartMode } from '@maka/core/deep-research';
 
 /**
  * `unknown`, because this is an IPC boundary and the renderer's type is a

apps/desktop/src/renderer/app-shell-command-actions.ts

@@ -20,7 +20,7 @@
 import { useMemo, useRef } from "react";
 import type { LlmConnection } from '@maka/core/llm-connections';
 import type { PermissionMode } from '@maka/core/permission';
-import type { SessionStartMode } from '@maka/core/explore-agent';
+import type { SessionStartMode } from '@maka/core/deep-research';
 import type { SessionSummary, StoredMessage } from '@maka/core/session';
 import type { SettingsSection, ThemePreference } from '@maka/core/settings';
 import type { UiLocale } from '@maka/core/ui-locale';

apps/desktop/src/renderer/app-shell-session-start-actions.ts

@@ -17,7 +17,7 @@
  * under the License.
  */
 
-import type { SessionStartMode } from '@maka/core/explore-agent';
+import type { SessionStartMode } from '@maka/core/deep-research';
 import type { UiLocale } from '@maka/core/ui-locale';
 import type { NavSelection } from '@maka/ui';
 import type { DesktopNewTaskTarget } from '../preload/bridge-contract.js';

apps/desktop/src/renderer/chat-message-surface.tsx

@@ -18,7 +18,7 @@
  */
 
 import { useMemo, useState, type ComponentProps, type ReactNode } from 'react';
-import { isDeepResearchSession } from '@maka/core/explore-agent';
+import { isDeepResearchSession } from '@maka/core/deep-research';
 import { type LlmConnection, type ProviderType } from '@maka/core/llm-connections';
 import { type OnboardingState } from '@maka/core/onboarding';
 import { type SettingsSection } from '@maka/core/settings';

docs/archive/expert-team-implementation.md

@@ -325,7 +325,7 @@ guards: isValidPluginFolderName（无 ../\/前导.）; BLOCKED{员工管理,招
 2. **磁盘 artifact + JSON 指针 fan-in（两家都用）**：member 把重产物落盘，只回小 JSON 指针，orchestrator 上下文保持极小。maka 实现专家团时必须这样，否则 lead 上下文爆炸。
 
 ## C3. maka 落地要点（详见 [expert-team-plan.md](expert-team-plan.md)）
-- **单专家** = `mode:expert:<id>` 标签 + 人格 fragment（照抄 Deep Research 的 `explore-agent.ts` 路径），人格经 `childInstruction` 边界注入（继承权限/隐私/工作区）。`defaultInitPrompt` 学 WorkBuddy 只 pre-fill composer（P0 简单）。
+- **单专家** = `mode:expert:<id>` 标签 + 人格 fragment（照抄 Deep Research 的 `deep-research.ts` 路径），人格经 `childInstruction` 边界注入（继承权限/隐私/工作区）。`defaultInitPrompt` 学 WorkBuddy 只 pre-fill composer（P0 简单）。
 - **专家团** = lead 用 `mode:expert:<teamId>` + orchestrator 人格，member 注册进 `agent-catalog.ts` 的 `BUILTIN_AGENT_DEFINITIONS`（各带窄 `tools`），lead 用现有 `agent_spawn`/`spawnChildAgent` 派生（星型，非隔离，单轮 fan-out + await fan-in，回指针）。**先不做 Teams mailbox**。
 - **专家中心** = 克隆 `skills-panel.tsx`（市场/内置/已安装）+ `managed-skill-sources.ts`（加 `sourceType:'remote'` 拉 COS 式 manifest，`contentSha256` 已就绪）。
 - **数字同事** = P2 持久化外壳（雇佣专家 + 昵称/头像/仓库/资料库/模型），IM 绑定/云端是最重的 P3+，需评估是否值得（WorkBuddy 靠云后端 + IM CLI 子进程，成本高）。

docs/archive/expert-team-plan.md

@@ -102,7 +102,7 @@ QoderWork **没有**命名人格选择器。它的三层值得参考：
 
 | 关注点 | 复用/扩展 | 位置 |
 |---|---|---|
-| 专家**人格注入** | `mode:` 标签 + prompt fragment（照抄 Deep Research） | `apps/desktop/src/main/system-prompt-main.ts`（已有 `childInstruction` seam）；`packages/core/src/explore-agent.ts`（`mode:deep_research` 先例） |
+| 专家**人格注入** | `mode:` 标签 + prompt fragment（照抄 Deep Research） | `apps/desktop/src/main/system-prompt-main.ts`（已有 `childInstruction` seam）；`packages/core/src/deep-research.ts`（`mode:deep_research` 先例） |
 | 专家=**带工具作用域的专业 agent** | 扩展 `BUILTIN_AGENT_DEFINITIONS`（每条已带 `systemPrompt`） | `packages/runtime/src/agent-catalog.ts`、`subagent-tools.ts`（`agent_spawn`/`SessionManager.spawnChildAgent`） |
 | 专家**目录 + 按需安装** | 克隆 managed/bundled 技能目录 | `apps/desktop/src/main/managed-skill-sources.ts`、`bundled-skill-catalog.generated.ts`、`skills.ts`（install→`skill.lock.json`→baseline→update diff，PR #842） |
 | 专家**定义文件格式** | 复用 SKILL.md frontmatter 解析 | `packages/runtime/src/skills.ts`（`parseSkillFrontMatter`） |

docs/astryx-surface-file-inventory.md

@@ -5,7 +5,7 @@ Each row is one on-disk product surface file. Regenerated inventory must stay in
 
 Wiki bar: Design Conventions · API Use-the-System · Theming · Container Padding.
 
-**Totals:** 224 files — blocker 0, polish 1, aligned 223.
+**Totals:** 223 files — blocker 0, polish 1, aligned 222.
 
 ## Exclusions (explicit)
 
@@ -242,7 +242,6 @@ Wiki bar: Design Conventions · API Use-the-System · Theming · Container Paddi
 | `packages/ui/src/titlebar-session-identity.tsx` | shell-chrome-or-panel | BreadcrumbItem, Breadcrumbs | aligned — uses Astryx (BreadcrumbItem, Breadcrumbs) | aligned |
 | `packages/ui/src/toast.tsx` | ui-composition | Button, HStack, Text, VStack | aligned — uses Astryx (Button, HStack, Text, VStack) | aligned |
 | `packages/ui/src/tool-activity.tsx` | ui-composition | Banner, Button, ChatToolCalls, List, ListItem, Text | aligned — uses Astryx (Banner, Button, ChatToolCalls, List, ListItem, Text) | aligned |
-| `packages/ui/src/tool-activity/agent-preview.tsx` | ui-composition | Button | aligned — uses Astryx (Button) | aligned |
 | `packages/ui/src/tool-activity/diff-code-preview.tsx` | ui-composition | none | aligned — no raw controls; no Astryx JSX usage | aligned |
 | `packages/ui/src/tool-activity/tool-code-block.tsx` | ui-composition | none | aligned — no raw controls; no Astryx JSX usage | aligned |
 | `packages/ui/src/tool-activity/tool-result-preview.tsx` | ui-composition | Button | aligned — uses Astryx (Button) | aligned |

docs/astryx-surface-file-inventory.paths

@@ -214,7 +214,6 @@ packages/ui/src/task-ledger-panel.tsx
 packages/ui/src/titlebar-session-identity.tsx
 packages/ui/src/toast.tsx
 packages/ui/src/tool-activity.tsx
-packages/ui/src/tool-activity/agent-preview.tsx
 packages/ui/src/tool-activity/diff-code-preview.tsx
 packages/ui/src/tool-activity/tool-code-block.tsx
 packages/ui/src/tool-activity/tool-result-preview.tsx

packages/cli/src/__tests__/pi-transcript.test.ts

@@ -4292,8 +4292,8 @@ describe('Maka Pi TUI transcript', () => {
       state,
       event({
         type: 'tool_start',
-        toolUseId: 'explore-intent',
-        toolName: 'ExploreAgent',
+        toolUseId: 'grep-intent',
+        toolName: 'Grep',
         args: undefined,
         intent: '  inspect   render entry with sk-1234567890abcdef  ',
       }),