refactor(core,server): 统一模块职责并消除类型重复

- 统一 ToolStatus 类型（Core 导出，Server 引用）
- 重命名 Server SessionManager 为 SessionMetadataManager
- 扩展 Core PermissionContext 添加结构化字段
- 统一 Part 类型导出（Core 定义存储格式，Server 定义展示格式）
- 简化 Message 格式（移除 MergedMessage，统一使用 Message）
- 添加向后兼容的类型别名和 @deprecated 注释

packages/server/src/index.ts

@@ -238,7 +238,7 @@ export async function startServer(options: ServerOptions = {}): Promise<void> {
 
 // 导出
 export { app, websocket };
-export { getSessionManager } from './session/manager.js';
+export { getSessionMetadataManager, getSessionManager } from './session/manager.js';
 export { registerTool, getRegisteredTools } from './routes/tools.js';
 export { getConfig, setConfig } from './routes/config.js';
 export {

packages/server/src/permission/handler.ts

@@ -6,12 +6,11 @@
 import { randomUUID } from 'crypto';
 import { broadcastToSession } from '../ws.js';
 import type {
-  PermissionType,
   PermissionRequestPayload,
   PermissionRequestContext,
   ServerMessage,
 } from '../types.js';
-import type { PermissionDecision, PermissionContext } from '@ai-assistant/core';
+import type { PermissionDecision, PermissionContext, PermissionType } from '@ai-assistant/core';
 
 // 等待中的权限请求
 interface PendingRequest {
@@ -57,14 +56,21 @@ function isAutoApproved(sessionId: string, ctx: PermissionContext): boolean {
   const config = sessionAutoApprove.get(sessionId);
   if (!config) return false;
 
-  const command = ctx.command.toLowerCase();
+  // 优先使用结构化字段判断
+  if (ctx.permissionType === 'file') {
+    if (ctx.fileOperation === 'write' && config.file?.write === 'allow') {
+      return true;
+    }
+    if (ctx.fileOperation === 'edit' && config.file?.edit === 'allow') {
+      return true;
+    }
+  }
 
-  // 检查是否为文件写入操作
+  // 向后兼容：解析 command 字符串
+  const command = ctx.command.toLowerCase();
   if (command.startsWith('write ') && config.file?.write === 'allow') {
     return true;
   }
-
-  // 检查是否为文件编辑操作
   if (command.startsWith('edit ') && config.file?.edit === 'allow') {
     return true;
   }
@@ -73,17 +79,22 @@ function isAutoApproved(sessionId: string, ctx: PermissionContext): boolean {
 }
 
 /**
- * 从命令或上下文检测权限类型
+ * 从上下文获取权限类型
+ * 优先使用结构化的 permissionType 字段，否则解析 command 字符串
  */
-function detectPermissionType(ctx: PermissionContext): PermissionType {
+function getPermissionType(ctx: PermissionContext): PermissionType {
+  // 优先使用结构化字段
+  if (ctx.permissionType) {
+    return ctx.permissionType;
+  }
+
+  // 向后兼容：解析 command 字符串
   const command = ctx.command.toLowerCase();
 
-  // 检测 git 操作
   if (command.startsWith('git ')) {
     return 'git';
   }
 
-  // 检测文件操作
   const fileOps = ['read', 'write', 'edit', 'delete', 'move', 'copy', 'mkdir'];
   for (const op of fileOps) {
     if (command.startsWith(`${op} `)) {
@@ -91,46 +102,42 @@ function detectPermissionType(ctx: PermissionContext): PermissionType {
     }
   }
 
-  // 检测 web 操作
-  if (command.includes('fetch') || command.includes('http')) {
+  if (command.includes('fetch') || command.includes('http') || command.startsWith('web_search')) {
     return 'web';
   }
 
-  // 默认为 bash
   return 'bash';
 }
 
 /**
  * 构建权限请求上下文
+ * 使用 Core 传递的结构化字段，减少字符串解析
  */
 function buildRequestContext(ctx: PermissionContext): PermissionRequestContext {
-  const permType = detectPermissionType(ctx);
+  const permType = getPermissionType(ctx);
 
   switch (permType) {
-    case 'file': {
-      const parts = ctx.command.split(' ');
-      const operation = parts[0];
-      const path = parts.slice(1).join(' ');
+    case 'file':
       return {
-        operation,
-        path,
+        command: ctx.command,
+        operation: ctx.fileOperation || ctx.command.split(' ')[0],
+        path: ctx.filePath || ctx.command.split(' ').slice(1).join(' '),
         patterns: ctx.patterns,
         externalPaths: ctx.externalPaths,
       };
-    }
-    case 'git': {
-      const gitOp = ctx.command.replace(/^git\s+/, '').split(' ')[0];
+
+    case 'git':
       return {
         command: ctx.command,
-        gitOperation: gitOp,
+        gitOperation: ctx.gitOperation || ctx.command.replace(/^git\s+/, '').split(' ')[0],
       };
-    }
-    case 'web': {
+
+    case 'web':
       return {
         command: ctx.command,
-        query: ctx.command,
+        query: ctx.webQuery || ctx.command,
       };
-    }
+
     default:
       return {
         command: ctx.command,
@@ -155,7 +162,7 @@ export function createServerPermissionCallback(sessionId: string) {
     }
 
     const requestId = randomUUID();
-    const permissionType = detectPermissionType(permCtx);
+    const permissionType = getPermissionType(permCtx);
     const context = buildRequestContext(permCtx);
 
     // 构建请求 payload

packages/server/src/routes/sessions.ts

@@ -9,7 +9,7 @@ import { getSessionManager } from '../session/manager.js';
 import {
   CreateSessionInputSchema,
   type ToolCallInfo,
-  type MergedMessage,
+  type Message,
   type MessagePart,
 } from '../types.js';
 import type { MessageInfo, Part, ToolPart } from '@ai-assistant/core';
@@ -131,7 +131,7 @@ sessionsRouter.get('/:id/messages', async (c) => {
     const messageInfos = await MessageStorage.listBySession(id);
 
     // 转换为前端格式
-    const messages: MergedMessage[] = [];
+    const messages: Message[] = [];
     for (const msgInfo of messageInfos) {
       const parts = await PartStorage.getByIds(msgInfo.id, msgInfo.partIds);
 

packages/server/src/session/manager.ts

@@ -1,7 +1,11 @@
 /**
- * Session Manager
+ * Session Metadata Manager
  *
  * 管理所有活跃的会话元数据（不存储消息，消息由 Core 负责）
+ *
+ * 注意：此类与 Core 的 SessionManager 职责不同：
+ * - SessionMetadataManager（本类）：管理会话元数据（id、status、messageCount）
+ * - Core SessionManager：管理完整的会话数据（消息、Parts、Todos）
  */
 
 import { v4 as uuidv4 } from 'uuid';
@@ -13,7 +17,7 @@ import type {
 } from '@ai-assistant/core';
 import { SessionManager as CoreSessionManager } from '@ai-assistant/core';
 
-export class SessionManager {
+export class SessionMetadataManager {
   private sessions: Map<string, Session> = new Map();
   private sessionProjects: Map<string, string> = new Map(); // sessionId -> projectId
   private coreManager: CoreSessionManager | null = null;
@@ -48,7 +52,7 @@ export class SessionManager {
 
       // 加载已持久化的 sessions（所有项目）
       const summaries = await this.coreManager.listAllSessions();
-      console.log(`[SessionManager] Found ${summaries.length} persisted sessions`);
+      console.log(`[SessionMetadataManager] Found ${summaries.length} persisted sessions`);
 
       for (const summary of summaries) {
         // 转换为 Server Session 格式（只保存元数据，不存储消息）
@@ -69,9 +73,9 @@ export class SessionManager {
         }
       }
 
-      console.log(`[SessionManager] Loaded ${this.sessions.size} sessions from storage`);
+      console.log(`[SessionMetadataManager] Loaded ${this.sessions.size} sessions from storage`);
     } catch (error) {
-      console.warn('[SessionManager] Storage not available, using memory only:', error);
+      console.warn('[SessionMetadataManager] Storage not available, using memory only:', error);
     }
 
     this.initialized = true;
@@ -207,11 +211,17 @@ export class SessionManager {
 }
 
 // 单例
-let instance: SessionManager | null = null;
+let instance: SessionMetadataManager | null = null;
 
-export function getSessionManager(): SessionManager {
+export function getSessionMetadataManager(): SessionMetadataManager {
   if (!instance) {
-    instance = new SessionManager();
+    instance = new SessionMetadataManager();
   }
   return instance;
 }
+
+// 向后兼容别名（已废弃）
+/** @deprecated 使用 SessionMetadataManager 和 getSessionMetadataManager 代替 */
+export const SessionManager = SessionMetadataManager;
+/** @deprecated 使用 getSessionMetadataManager 代替 */
+export const getSessionManager = getSessionMetadataManager;

packages/server/src/types.ts

@@ -4,6 +4,22 @@
 
 import { z } from 'zod';
 
+// 从 Core 导入共享类型，避免重复定义
+import type {
+  ToolStatus,
+  PermissionType,
+  PermissionContext,
+  Part as CorePart,
+  PartType as CorePartType,
+  TextPart as CoreTextPart,
+  ToolPart as CoreToolPart,
+  ReasoningPart as CoreReasoningPart,
+} from '@ai-assistant/core';
+
+// 重新导出 Core 类型，供其他模块使用
+export type { ToolStatus, PermissionType, PermissionContext };
+export type { CorePart, CorePartType, CoreTextPart, CoreToolPart, CoreReasoningPart };
+
 // ============ Session 相关 ============
 
 export const SessionStatusSchema = z.enum(['idle', 'active', 'busy', 'running', 'paused']);
@@ -30,34 +46,8 @@ export type CreateSessionInput = z.infer<typeof CreateSessionInputSchema>;
 
 // ============ Message 相关 ============
 
-export const MessageRoleSchema = z.enum(['user', 'assistant', 'system', 'tool']);
-
-export const MessageSchema = z.object({
-  id: z.string().uuid(),
-  sessionId: z.string().uuid(),
-  role: MessageRoleSchema,
-  content: z.string(),
-  createdAt: z.string(),
-  toolCalls: z
-    .array(
-      z.object({
-        id: z.string(),
-        name: z.string(),
-        arguments: z.record(z.string(), z.unknown()),
-      })
-    )
-    .optional(),
-  toolResults: z
-    .array(
-      z.object({
-        toolCallId: z.string(),
-        result: z.unknown(),
-      })
-    )
-    .optional(),
-});
-
-export type Message = z.infer<typeof MessageSchema>;
+// 消息角色（仅用于 SendMessageInput，实际消息只有 user/assistant）
+export const MessageRoleSchema = z.enum(['user', 'assistant']);
 
 export const SendMessageInputSchema = z.object({
   role: MessageRoleSchema.default('user'),
@@ -213,10 +203,11 @@ export type SubagentEventPayload =
 
 // ============ Permission 相关 ============
 
-export type PermissionType = 'bash' | 'file' | 'git' | 'web';
+// PermissionType 和 PermissionContext 已从 Core 导入（见文件顶部）
 
 /**
- * 权限请求上下文
+ * 权限请求上下文（Server 专用，已废弃）
+ * @deprecated 使用 PermissionContext（从 Core 导入）代替
  */
 export interface PermissionRequestContext {
   command?: string;           // bash 命令
@@ -280,15 +271,19 @@ export interface SSEEvent {
   };
 }
 
-// ============ 消息 Parts 相关 ============
+// ============ 消息 Parts 相关（前端展示格式）============
+//
+// 说明：这些是前端展示用的扁平化 Part 类型
+// Core 的 Part 类型（CorePart）是存储格式，使用状态机模式
+// Server 在 routes/sessions.ts 中负责将 CorePart 转换为 MessagePart
+
+// ToolCallStatus 已废弃，使用 ToolStatus（从 Core 导入）
+// 保留类型别名以保持向后兼容
+/** @deprecated 使用 ToolStatus 代替 */
+export type ToolCallStatus = ToolStatus;
 
 /**
- * 工具调用状态
- */
-export type ToolCallStatus = 'pending' | 'running' | 'completed' | 'error';
-
-/**
- * 文本 Part
+ * 文本 Part（前端展示格式）
  */
 export interface TextMessagePart {
   type: 'text';
@@ -297,14 +292,15 @@ export interface TextMessagePart {
 }
 
 /**
- * 工具调用 Part
+ * 工具调用 Part（前端展示格式）
+ * 与 Core 的 ToolPart 不同，这里使用扁平结构而非状态机
  */
 export interface ToolMessagePart {
   type: 'tool';
   id: string;
   toolCallId: string;
   toolName: string;
-  status: ToolCallStatus;
+  status: ToolStatus;
   arguments: Record<string, unknown>;
   result?: unknown;
   error?: string;
@@ -312,7 +308,7 @@ export interface ToolMessagePart {
 }
 
 /**
- * 推理 Part
+ * 推理 Part（前端展示格式）
  */
 export interface ReasoningMessagePart {
   type: 'reasoning';
@@ -321,7 +317,8 @@ export interface ReasoningMessagePart {
 }
 
 /**
- * 消息 Part 联合类型
+ * 消息 Part 联合类型（前端展示格式）
+ * 用于 API 响应和 WebSocket 消息
  */
 export type MessagePart = TextMessagePart | ToolMessagePart | ReasoningMessagePart;
 
@@ -332,7 +329,7 @@ export interface ToolCallInfo {
   id: string;
   name: string;
   arguments: Record<string, unknown>;
-  status: ToolCallStatus;
+  status: ToolStatus;
   result?: unknown;
   error?: string;
   duration?: number;
@@ -345,7 +342,7 @@ export interface ToolCallInfo {
  * - user: 用户输入
  * - assistant: AI 回复（包含文本和工具调用，按原始顺序）
  */
-export interface MergedMessage {
+export interface Message {
   id: string;
   sessionId: string;
   role: 'user' | 'assistant';
@@ -363,6 +360,9 @@ export interface MergedMessage {
   };
 }
 
+/** @deprecated 使用 Message 代替 */
+export type MergedMessage = Message;
+
 // ============ API 响应 ============
 
 export interface ApiResponse<T> {