refactor(子会话): 重构子会话实现为独立会话模型

feat(存储): 引入新的JSONL事件schema支持会话、消息、部件分离
feat(UI): 添加子会话引用卡片展示与导航
feat(工具): 改造Task工具为子会话创建器
chore: 清理旧subagent相关代码与JSONL格式

Author: echoVic

docs/subagent-subsession-plan.md

@@ -0,0 +1,186 @@
+# 子会话语义化对齐落地方案（不向下兼容）
+
+## 目标
+- 将 subagent 的执行结果从“工具输出”升级为“独立子会话”
+- 主会话仅保存对子会话的引用与摘要，完整过程在子会话中保留
+- CLI 与 Web 的 UI 体验一致，可浏览子会话的完整消息流
+
+## 不做的事
+- 不考虑向下兼容既有 JSONL schema 或旧会话加载逻辑
+- 不保留旧 subagent JSONL 文件与旧会话列表过滤逻辑
+
+## 现状基线
+- 会话持久化基于 JSONL，写入入口在 PersistentStore
+- subagent 当前由 Task 工具执行，结果回填主会话
+
+## 新的领域模型
+### Session
+字段建议
+- id
+- rootId
+- parentId
+- relationType: "subagent" | null
+- title
+- status: "running" | "completed" | "failed"
+- agentType
+- model
+- permission
+- createdAt
+- updatedAt
+
+### Message
+- id
+- sessionId
+- role: "system" | "user" | "assistant"
+- parentId
+- createdAt
+
+### Part
+类型建议
+- text
+- tool_call
+- tool_result
+- diff
+- patch
+- summary
+- subtask_ref
+
+### SubtaskRef
+挂载在主会话的 message.parts 中
+- childSessionId
+- agentType
+- model
+- status
+- summary
+- startedAt
+- finishedAt
+
+## 新的 JSONL schema
+建议按事件序列化，一行一条
+- session_created
+- session_updated
+- message_created
+- part_created
+- part_updated
+
+示例
+- {"type":"session_created","data":{...}}
+- {"type":"message_created","data":{...}}
+- {"type":"part_created","data":{"partType":"subtask_ref",...}}
+
+## 存储与索引
+- session 元信息与消息、part 仍落在 JSONL
+- 增加子会话索引文件 children/{parentId}.json
+- 子会话不再使用 agent_*.jsonl 命名，统一 sessionId.jsonl
+
+## API 设计
+### Session API
+- createSession({parentId, relationType, agentType, model, permission})
+- listSessions({parentId})
+- getSession(sessionId)
+- updateSession(sessionId, patch)
+
+### Message API
+- listMessages(sessionId)
+- appendMessage(sessionId, message)
+- appendPart(messageId, part)
+
+### Subtask API
+- createSubtask({parentSessionId, agentType, prompt, model, permission})
+- getSubtask(childSessionId)
+- summarizeSubtask(childSessionId)
+
+### Event API
+- subscribeSession(sessionId)
+- subscribeChildren(parentSessionId)
+
+## 运行时执行流
+1. 主会话触发 subagent
+2. 生成子会话 sessionId 与 parentId
+3. 子会话进入独立 Agent loop
+4. 子会话完成时生成 summary part
+5. 主会话写入 subtask_ref part
+
+## 权限与治理
+- 子会话权限默认独立配置
+- 主会话只控制是否允许创建子会话
+- 子会话工具权限与模型选择由 agentType 或显式配置决定
+
+## CLI UI 设计
+### 主会话展示
+- Subtask 卡片
+  - 标题：@agentType
+  - 状态：running/completed/failed
+  - 摘要：summary
+  - 快捷键：打开子会话
+
+### 子会话展示
+- 与主会话一致的消息流展示
+- 支持返回父会话
+
+## Web UI 设计
+### 主会话展示
+- SubtaskCard 组件
+  - 展示状态与摘要
+  - 点击打开子会话面板
+
+### 子会话面板
+- 独立消息流
+- 实时更新状态与新消息
+
+## 关键改造点
+### 工具层
+- Task 工具不再直接返回完整文本结果
+- Task 工具返回 subtask_ref 并触发子会话创建
+
+### 存储层
+- SessionService 统一加载新 JSONL 事件
+- 删除旧 agent_*.jsonl 的过滤逻辑
+
+### Agent 运行时
+- Subagent 执行器从“工具执行”转为“子会话执行”
+- 子会话完成后生成 summary part
+
+## 任务拆解
+### 数据与存储
+- 设计新的 JSONL 事件 schema 与类型定义
+- 实现 Session/Message/Part 的新读写层
+- 实现 children 索引与查询
+- 统一 sessionId 命名与文件路径规则
+
+### 运行时与执行
+- Task 工具改造为子会话创建器
+- Subagent 执行器改为独立会话运行
+- 子会话完成后写入 summary part
+- 主会话追加 subtask_ref part
+
+### 权限与配置
+- 子会话权限规则定义与解析
+- 子会话模型选择规则
+- 主会话创建子会话的权限控制
+
+### CLI UI
+- SubtaskCard 组件
+- 子会话视图与导航
+- 主会话与子会话的状态同步
+
+### Web UI
+- SubtaskCard 组件
+- 子会话面板与路由
+- Session 与 Subsession 的 store 拆分
+
+### 观测与测试
+- JSONL 事件写入完整性测试
+- 子会话创建与回放测试
+- CLI/Web UI 的状态一致性验证
+
+## 风险与约束
+- 旧会话不可读取
+- 子会话与主会话的权限隔离需严格执行
+- JSONL 事件增长可能带来性能压力
+
+## 交付里程碑
+1. 新 JSONL schema 与 Session/Message/Part 基础读写
+2. Task → 子会话执行链路打通
+3. CLI 与 Web 子会话 UI 完成
+4. 权限与模型策略完善

knip.json

@@ -6,23 +6,18 @@
       "project": ["src/**/*.{ts,tsx}"],
       "ignore": ["**/*.test.ts", "**/*.spec.ts", "tests/**/*"]
     },
-    "packages/web": {
+    "packages/cli/web": {
       "entry": ["src/main.tsx"],
       "project": ["src/**/*.{ts,tsx}"],
       "ignore": ["**/*.test.ts", "**/*.spec.ts"]
     },
     "packages/vscode": {
-      "entry": ["src/extension.ts"],
-      "project": ["src/**/*.ts"],
-      "ignore": ["**/*.test.ts", "**/*.spec.ts"]
-    },
-    "packages/shared": {
-      "entry": ["src/index.ts"],
       "project": ["src/**/*.ts"],
       "ignore": ["**/*.test.ts", "**/*.spec.ts"]
     }
   },
-  "ignoreDependencies": ["@azure/identity", "pino-pretty", "vscode"],
+  "ignoreBinaries": ["vite"],
+  "ignoreDependencies": [],
   "ignoreExportsUsedInFile": true,
   "rules": {
     "enumMembers": "off"

packages/cli/package.json

@@ -62,36 +62,15 @@
     "@ai-sdk/azure": "^3.0.5",
     "@ai-sdk/deepseek": "^2.0.4",
     "@ai-sdk/google": "^3.0.4",
-    "@ai-sdk/openai": "^3.0.5",
     "@ai-sdk/openai-compatible": "^2.0.4",
-    "@anthropic-ai/sdk": "^0.71.2",
-    "@azure/identity": "^4.13.0",
-    "@fontsource/jetbrains-mono": "^5.2.8",
-    "@google/genai": "^1.34.0",
     "@inkjs/ui": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.17.4",
-    "@radix-ui/react-dialog": "^1.1.15",
-    "@radix-ui/react-dropdown-menu": "^2.1.16",
-    "@radix-ui/react-label": "^2.1.8",
-    "@radix-ui/react-popover": "^1.1.15",
-    "@radix-ui/react-scroll-area": "^1.2.10",
-    "@radix-ui/react-select": "^2.2.6",
-    "@radix-ui/react-separator": "^1.1.8",
-    "@radix-ui/react-slot": "^1.0.2",
-    "@radix-ui/react-tabs": "^1.1.13",
-    "@radix-ui/react-tooltip": "^1.2.8",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/addon-web-links": "^0.12.0",
-    "@xterm/xterm": "^6.0.0",
     "ahooks": "^3.9.6",
     "ai": "^6.0.39",
     "ansi-escapes": "^7.2.0",
     "async-mutex": "^0.5.0",
     "axios": "^1.12.2",
     "chalk": "^5.4.1",
-    "class-variance-authority": "^0.7.0",
-    "clsx": "^2.1.0",
-    "cmdk": "^1.1.1",
     "diff": "^8.0.2",
     "fast-glob": "^3.3.3",
     "fuse.js": "^7.1.0",
@@ -107,21 +86,14 @@
     "lodash-es": "^4.17.21",
     "lowlight": "^3.3.0",
     "lru-cache": "^11.2.4",
-    "lucide-react": "^0.300.0",
     "nanoid": "^5.1.6",
     "open": "^10.1.2",
     "openai": "^6.2.0",
     "picomatch": "^4.0.3",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
-    "react-markdown": "^10.1.0",
-    "react-syntax-highlighter": "^16.1.0",
-    "remark-gfm": "^4.0.1",
     "semver": "^7.7.3",
     "string-width": "^8.1.0",
-    "swr": "^2.2.4",
-    "tailwind-merge": "^2.2.0",
-    "tailwindcss-animate": "^1.0.7",
     "undici": "^7.16.0",
     "write-file-atomic": "^7.0.0",
     "ws": "^8.18.0",
@@ -133,27 +105,20 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.4",
-    "@monaco-editor/react": "^4.7.0",
     "@types/bun": "^1.3.4",
     "@types/json-schema": "^7.0.15",
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^22.15.24",
     "@types/picomatch": "^4.0.2",
     "@types/react": "^19.1.1",
     "@types/react-dom": "^19.1.1",
-    "@types/react-syntax-highlighter": "^15.5.13",
     "@types/semver": "^7.7.1",
     "@types/write-file-atomic": "^4.0.3",
     "@types/ws": "^8.5.12",
     "@types/yargs": "^17.0.33",
-    "@vitejs/plugin-react": "^4.2.1",
     "@vitest/coverage-v8": "^3.0.0",
-    "autoprefixer": "^10.4.16",
     "jsdom": "^26.0.0",
-    "postcss": "^8.4.32",
-    "tailwindcss": "^3.4.0",
     "typescript": "^5.9.2",
-    "vite": "^5.0.8",
     "vitest": "^3.0.0"
   }
 }

packages/cli/src/agent/Agent.ts

@@ -1245,14 +1245,44 @@ IMPORTANT: Execute according to the approved plan above. Follow the steps exactl
           try {
             const contextMgr = this.executionEngine?.getContextManager();
             if (contextMgr && context.sessionId) {
+              const metadata =
+                result.metadata && typeof result.metadata === 'object'
+                  ? (result.metadata as Record<string, unknown>)
+                  : undefined;
+              const isSubagentStatus = (
+                value: unknown
+              ): value is 'running' | 'completed' | 'failed' | 'cancelled' =>
+                value === 'running' ||
+                value === 'completed' ||
+                value === 'failed' ||
+                value === 'cancelled';
+              const subagentStatus = isSubagentStatus(metadata?.subagentStatus)
+                ? metadata.subagentStatus
+                : 'completed';
+              const subagentRef =
+                metadata && typeof metadata.subagentSessionId === 'string'
+                  ? {
+                      subagentSessionId: metadata.subagentSessionId,
+                      subagentType:
+                        typeof metadata.subagentType === 'string'
+                          ? metadata.subagentType
+                          : toolCall.function.name,
+                      subagentStatus,
+                      subagentSummary:
+                        typeof metadata.subagentSummary === 'string'
+                          ? metadata.subagentSummary
+                          : undefined,
+                    }
+                  : undefined;
               lastMessageUuid = await contextMgr.saveToolResult(
                 context.sessionId,
                 toolCall.id,
                 toolCall.function.name,
                 result.success ? toJsonValue(result.llmContent) : null,
                 toolUseUuid,
                 result.success ? undefined : result.error?.message,
-                context.subagentInfo
+                context.subagentInfo,
+                subagentRef
               );
             }
           } catch (err) {

packages/cli/src/agent/subagents/BackgroundAgentManager.ts

@@ -7,7 +7,7 @@
  * - 支持等待完成、恢复、终止
  */
 
-import { randomUUID } from 'crypto';
+import { nanoid } from 'nanoid';
 import type { PermissionMode } from '../../config/types.js';
 import { createLogger, LogCategory } from '../../logging/Logger.js';
 import type { Message } from '../../services/ChatServiceInterface.js';
@@ -129,7 +129,7 @@ export class BackgroundAgentManager {
     } = options;
 
     // 生成或使用已有的 agent ID
-    const id = agentId || `agent_${randomUUID()}`;
+    const id = agentId || nanoid();
 
     // 创建 AbortController 用于取消
     const abortController = new AbortController();
@@ -213,7 +213,7 @@ export class BackgroundAgentManager {
         subagentInfo: {
           parentSessionId: parentSessionId || '',
           subagentType: config.name,
-          isSidechain: true,
+          isSidechain: false,
         },
       };
 
@@ -437,5 +437,3 @@ export class BackgroundAgentManager {
     return this.sessionStore.cleanupExpiredSessions(maxAgeMs);
   }
 }
-
-