@huyooo/ai-chat-types 0.2.22

package/dist/index.d.ts

@@ -0,0 +1,389 @@
+export { AbortEvent, ChatEvent, ChatEventType, DoneEvent, ErrorCategory, ErrorDetails, ErrorEvent, PlanStep, PlanStepStatus, SearchEndEvent, SearchEvent, SearchResult, SearchResultEvent, SearchStartEvent, SideEffect, StatusEvent, StepEndEvent, StepEvent, StepStartEvent, TextDeltaEvent, TextEvent, ThinkingDeltaEvent, ThinkingEndEvent, ThinkingEvent, ThinkingStartEvent, TokenUsage, ToolApprovalRequestEvent, ToolCallInfo, ToolCallOutputEvent, ToolCallResultEvent, ToolCallStartEvent, ToolCallStatus, ToolEvent, createAbort, createApiError, createDone, createError, createParseError, createRateLimitError, createSearchEnd, createSearchResult, createSearchStart, createStepEnd, createStepStart, createTextDelta, createThinkingDelta, createThinkingEnd, createThinkingStart, createTimeoutError, createToolCallOutput, createToolCallResult, createToolCallStart, createToolError, isAbortEvent, isErrorEvent, isRetryableError, isSearchEvent, isStatusEvent, isStepEvent, isTextEvent, isThinkingEvent, isToolEvent } from '@huyooo/ai-chat-core/events';
+import { ModelOption, ChatEvent } from '@huyooo/ai-chat-core';
+export { AutoRunConfig, AutoRunMode, McpConnectionInfo, McpConnectionStatus, McpServerConfig, ModelOption, ProviderType, ThinkingMode } from '@huyooo/ai-chat-core';
+
+/**
+ * @huyooo/ai-chat-types
+ *
+ * AI Chat 公共类型定义
+ *
+ * 架构层级：
+ * 1. ai-chat-core - 核心引擎（定义事件、工具等核心类型）
+ * 2. ai-chat-types - 公共接口（导出 ChatAdapter、重新导出 ChatEvent）
+ * 3. 各适配器包 - 实现 ChatAdapter 接口
+ */
+
+/** 对话模式（扩展支持 'plan'，兼容旧数据） */
+type ChatMode = 'agent' | 'ask' | 'plan';
+/** 聊天历史消息（无状态架构传入） */
+interface ChatHistoryMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+}
+/** 聊天选项（使用本地 ChatMode） */
+interface ChatOptions {
+    mode?: ChatMode;
+    model?: string;
+    provider?: string;
+    enableWebSearch?: boolean;
+    thinkingMode?: 'enabled' | 'disabled';
+    enabledTools?: string[];
+    autoRunConfig?: {
+        mode?: 'run-everything' | 'manual';
+    };
+    history?: ChatHistoryMessage[];
+    /** Skills 内容（启用的 Skills 的 content 数组，前端拼好传入） */
+    skillContents?: string[];
+}
+/** 会话记录 */
+interface SessionRecord {
+    id: string;
+    appId: string | null;
+    userId: string | null;
+    title: string;
+    model: string;
+    mode: ChatMode;
+    webSearchEnabled: boolean;
+    thinkingEnabled: boolean;
+    /** 是否在 tab 栏隐藏（关闭但不删除） */
+    hidden: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** 消息记录 */
+interface MessageRecord {
+    id: string;
+    /** 前端关联 ID（本地模式与 id 相同，云端模式为前端生成的 UUID） */
+    clientId?: string | null;
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    /** 用户消息附带的图片（data URL 或 base64） */
+    images: string[];
+    /** 生成此消息时使用的模型 */
+    model?: string | null;
+    /** 生成此消息时使用的模式 (ask/agent) */
+    mode?: string | null;
+    /** 生成此消息时是否启用 web 搜索 */
+    webSearchEnabled?: boolean | null;
+    /** 生成此消息时是否启用深度思考 */
+    thinkingEnabled?: boolean | null;
+    /** 执行步骤列表 JSON */
+    steps?: string | null;
+    operationIds?: string | null;
+    /** Token 使用统计（JSON 字符串） */
+    usage?: string | null;
+    /** 响应耗时（毫秒） */
+    duration?: number | null;
+    /** 消息序号（会话内递增，用于分叉删除） */
+    sequence: number;
+    /** 时间戳（毫秒，Unix 时间戳） */
+    timestamp: number;
+}
+/** 操作记录 */
+interface OperationRecord {
+    id: string;
+    sessionId: string;
+    messageId?: string | null;
+    command: string;
+    operationType: string;
+    affectedFiles: string;
+    status: string;
+    timestamp: Date;
+}
+/** 回收站记录 */
+interface TrashRecord {
+    id: string;
+    sessionId: string;
+    originalPath: string;
+    trashPath: string;
+    deletedAt: Date;
+    autoDeleteAt: Date;
+}
+/** Skill 记录（云端管理的 system prompt 片段） */
+interface SkillRecord {
+    id: string;
+    name: string;
+    description: string;
+    content: string;
+    icon: string;
+    enabled: boolean;
+    builtIn: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** 文件信息 */
+interface FileInfo {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    modifiedAt: Date;
+    extension: string;
+}
+/** 工具信息 */
+interface ToolInfo {
+    name: string;
+    description: string;
+}
+/** 工具批准请求 */
+interface ToolApprovalRequest {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+/** ASR 会话配置 */
+interface AsrSessionConfig {
+    /** 音频格式 */
+    format?: 'pcm' | 'wav';
+    /** 采样率 */
+    sampleRate?: number;
+    /** 启用标点 */
+    enablePunc?: boolean;
+    /** 启用 ITN（数字规整） */
+    enableItn?: boolean;
+    /** 启用语义顺滑 */
+    enableDdc?: boolean;
+    /** 输出分句信息 */
+    showUtterances?: boolean;
+}
+/** ASR 识别结果 */
+interface AsrResultData {
+    result?: {
+        text: string;
+        utterances?: Array<{
+            text: string;
+            start_time: number;
+            end_time: number;
+            definite: boolean;
+        }>;
+    };
+    audio_info?: {
+        duration: number;
+    };
+}
+
+/**
+ * ChatAdapter 接口
+ *
+ * 统一的聊天适配器接口，支持多种实现：
+ * - Electron IPC（ai-chat-bridge-electron）
+ * - HTTP/SSE（ai-chat-adapter-http）
+ * - 直连（ai-chat-adapter-direct，CLI 用）
+ *
+ * 行为统一保证：无论使用哪种实现（本地直连 / HTTP / 混合），对调用方接口一致——
+ * getModels()、sendMessage()、getSessions() 等语义相同，sendMessage 产出的事件均为
+ * ChatEvent 类型集（见 ai-chat-core/events），事件 type 与 data 形状由类型定义约束，
+ * 不因适配器或模型而异。core 层通过契约测试（CHAT_EVENT_TYPES）保证 Orchestrator
+ * 产出合法事件。
+ */
+interface ChatAdapter {
+    /** 获取可用模型 */
+    getModels(): Promise<ModelOption[]>;
+    /** 获取所有工具列表（用于设置面板） */
+    getAllTools?(): Promise<ToolInfo[]>;
+    /** 发送消息，返回异步迭代器 */
+    sendMessage(message: string, options?: ChatOptions, images?: string[], sessionId?: string): AsyncIterable<ChatEvent>;
+    /** 取消当前请求 */
+    cancel(): void;
+    /** 设置当前工作目录 */
+    setCwd?(dir: string): void;
+    /** 获取会话列表 */
+    getSessions(): Promise<SessionRecord[]>;
+    /** 获取单个会话 */
+    getSession(id: string): Promise<SessionRecord | null>;
+    /** 创建会话 */
+    createSession(params?: CreateSessionParams): Promise<SessionRecord>;
+    /** 更新会话 */
+    updateSession(id: string, data: UpdateSessionParams): Promise<SessionRecord | null>;
+    /** 删除会话 */
+    deleteSession(id: string): Promise<void>;
+    /** 获取会话消息 */
+    getMessages(sessionId: string): Promise<MessageRecord[]>;
+    /** 保存消息 */
+    saveMessage(params: SaveMessageParams): Promise<MessageRecord>;
+    /** 更新消息（增量保存） */
+    updateMessage(params: UpdateMessageParams): Promise<void>;
+    /** 删除指定时间之后的消息（用于分叉） */
+    deleteMessagesAfter(sessionId: string, timestamp: number): Promise<void>;
+    /** 删除指定消息之后的所有消息（用于分叉） */
+    deleteMessagesAfterMessageId(sessionId: string, messageId: string): Promise<void>;
+    /** 获取操作日志 */
+    getOperations(sessionId: string): Promise<OperationRecord[]>;
+    /** 获取回收站 */
+    getTrashItems(): Promise<TrashRecord[]>;
+    /** 恢复回收站项目 */
+    restoreFromTrash(id: string): Promise<TrashRecord | undefined>;
+    listDir?(dirPath: string): Promise<FileInfo[]>;
+    exists?(filePath: string): Promise<boolean>;
+    stat?(filePath: string): Promise<FileInfo | null>;
+    readFile?(filePath: string): Promise<string | null>;
+    readFileBase64?(filePath: string): Promise<string | null>;
+    homeDir?(): Promise<string>;
+    resolvePath?(inputPath: string): Promise<string>;
+    parentDir?(dirPath: string): Promise<string>;
+    watchDir?(dirPath: string): Promise<boolean>;
+    unwatchDir?(dirPath: string): Promise<void>;
+    onDirChange?(callback: (data: {
+        dirPath: string;
+        eventType: string;
+        filename: string | null;
+    }) => void): () => void;
+    getSetting?(key: string): Promise<string | null>;
+    setSetting?(key: string, value: string): Promise<void>;
+    getAllSettings?(): Promise<Record<string, string>>;
+    deleteSetting?(key: string): Promise<void>;
+    getIndexStats?(): Promise<{
+        totalDocuments: number;
+        indexSize: number;
+        lastUpdated: string | null;
+    }>;
+    getIndexStatus?(): Promise<{
+        isIndexing: boolean;
+        lastProgress: {
+            indexed: number;
+            total: number;
+            currentFile?: string;
+            stage: string;
+        } | null;
+    }>;
+    syncIndex?(): Promise<{
+        success: boolean;
+    }>;
+    cancelIndex?(): Promise<{
+        success: boolean;
+    }>;
+    deleteIndex?(): Promise<{
+        success: boolean;
+    }>;
+    registerIndexListener?(): Promise<{
+        success: boolean;
+    }>;
+    unregisterIndexListener?(): Promise<{
+        success: boolean;
+    }>;
+    onIndexProgress?(callback: (progress: {
+        indexed: number;
+        total: number;
+        currentFile?: string;
+        stage: string;
+        error?: string;
+    }) => void): () => void;
+    /** 获取 Skills 列表 */
+    getSkills?(): Promise<SkillRecord[]>;
+    /** 创建 Skill */
+    createSkill?(data: {
+        name: string;
+        description?: string;
+        content: string;
+        icon?: string;
+    }): Promise<SkillRecord>;
+    /** 更新 Skill */
+    updateSkill?(id: string, data: {
+        name?: string;
+        description?: string;
+        content?: string;
+        icon?: string;
+        enabled?: boolean;
+    }): Promise<void>;
+    /** 删除 Skill */
+    deleteSkill?(id: string): Promise<void>;
+    /** 切换 Skill 启用状态 */
+    toggleSkill?(id: string): Promise<{
+        enabled: boolean;
+    }>;
+    onToolApprovalRequest?(callback: (request: ToolApprovalRequest) => void): () => void;
+    respondToolApproval?(id: string, approved: boolean): Promise<void>;
+    asrStart?(config?: AsrSessionConfig): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    asrSendAudio?(audioData: ArrayBufferLike): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    asrFinish?(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    asrStop?(): Promise<{
+        success: boolean;
+    }>;
+    asrStatus?(): Promise<{
+        connected: boolean;
+    }>;
+    asrWarmup?(config?: AsrSessionConfig): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    onAsrConnected?(callback: () => void): () => void;
+    onAsrResult?(callback: (data: {
+        result: AsrResultData;
+        isLast: boolean;
+    }) => void): () => void;
+    onAsrError?(callback: (error: {
+        message: string;
+    }) => void): () => void;
+    onAsrClosed?(callback: () => void): () => void;
+    openExternal?(url: string): Promise<void>;
+}
+/** 创建会话参数 */
+interface CreateSessionParams {
+    title?: string;
+    model?: string;
+    mode?: string;
+    webSearchEnabled?: boolean;
+    thinkingEnabled?: boolean;
+    hidden?: boolean;
+}
+/** 更新会话参数 */
+interface UpdateSessionParams {
+    title?: string;
+    model?: string;
+    mode?: string;
+    webSearchEnabled?: boolean;
+    thinkingEnabled?: boolean;
+    hidden?: boolean;
+}
+/** 保存消息参数 */
+interface SaveMessageParams {
+    id?: string;
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    images?: string[];
+    model?: string;
+    mode?: string;
+    webSearchEnabled?: boolean;
+    thinkingEnabled?: boolean;
+    steps?: string;
+    operationIds?: string;
+}
+/** 更新消息参数 */
+interface UpdateMessageParams {
+    id: string;
+    content?: string;
+    steps?: string;
+    operationIds?: string;
+    /** Token 使用统计（JSON 字符串） */
+    usage?: string;
+    /** 响应耗时（毫秒） */
+    duration?: number;
+}
+/** 发送消息参数 */
+interface SendMessageParams {
+    message: string;
+    images?: string[];
+    sessionId?: string;
+    options?: {
+        mode?: string;
+        model?: string;
+        provider?: string;
+        enableWebSearch?: boolean;
+        thinkingMode?: string;
+        thinkingBudget?: number;
+        history?: ChatHistoryMessage[];
+    };
+}
+
+export type { AsrResultData, AsrSessionConfig, ChatAdapter, ChatHistoryMessage, ChatMode, ChatOptions, CreateSessionParams, FileInfo, MessageRecord, OperationRecord, SaveMessageParams, SendMessageParams, SessionRecord, SkillRecord, ToolApprovalRequest, ToolInfo, TrashRecord, UpdateMessageParams, UpdateSessionParams };

package/dist/index.js

@@ -0,0 +1 @@
+import{createThinkingStart as o,createThinkingDelta as e,createThinkingEnd as r,createSearchStart as t,createSearchResult as a,createSearchEnd as c,createToolCallStart as h,createToolCallResult as i,createToolCallOutput as m,createTextDelta as p,createDone as f,createError as n,createApiError as s,createRateLimitError as u,createToolError as v,createTimeoutError as x,createParseError as y,createAbort as b,createStepStart as d,createStepEnd as g,isThinkingEvent as j,isSearchEvent as k,isToolEvent as l,isTextEvent as q,isStatusEvent as w,isErrorEvent as z,isAbortEvent as A,isStepEvent as B,isRetryableError as C}from"@huyooo/ai-chat-core/events";export{b as createAbort,s as createApiError,f as createDone,n as createError,y as createParseError,u as createRateLimitError,c as createSearchEnd,a as createSearchResult,t as createSearchStart,g as createStepEnd,d as createStepStart,p as createTextDelta,e as createThinkingDelta,r as createThinkingEnd,o as createThinkingStart,x as createTimeoutError,m as createToolCallOutput,i as createToolCallResult,h as createToolCallStart,v as createToolError,A as isAbortEvent,z as isErrorEvent,C as isRetryableError,k as isSearchEvent,w as isStatusEvent,B as isStepEvent,q as isTextEvent,j as isThinkingEvent,l as isToolEvent};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@huyooo/ai-chat-types",
+  "version": "0.2.22",
+  "description": "AI Chat 通用类型定义 - 支持 Electron/Web/CLI 多端",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@huyooo/ai-chat-core": "^0.2.22"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "ai",
+    "chat",
+    "types",
+    "typescript"
+  ],
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,486 @@
+/**
+ * @huyooo/ai-chat-types
+ * 
+ * AI Chat 公共类型定义
+ * 
+ * 架构层级：
+ * 1. ai-chat-core - 核心引擎（定义事件、工具等核心类型）
+ * 2. ai-chat-types - 公共接口（导出 ChatAdapter、重新导出 ChatEvent）
+ * 3. 各适配器包 - 实现 ChatAdapter 接口
+ */
+
+// ==================== 从 ai-chat-core/events 重新导出事件类型 ====================
+// 使用子路径导出，避免在 renderer 中拉入 ai-chat-core 整个模块图
+// （ai-chat-core 主入口包含 HybridAgent → MCP SDK 等 Node.js 依赖）
+
+export type {
+  // 聚合类型
+  ChatEvent,
+  ChatEventType,
+  
+  // 基础类型
+  SearchResult,
+  ToolCallStatus,
+  ToolCallInfo,
+  TokenUsage,
+  ErrorCategory,
+  ErrorDetails,
+  SideEffect,
+  
+  // 思考事件
+  ThinkingStartEvent,
+  ThinkingDeltaEvent,
+  ThinkingEndEvent,
+  ThinkingEvent,
+  
+  // 搜索事件
+  SearchStartEvent,
+  SearchResultEvent,
+  SearchEndEvent,
+  SearchEvent,
+  
+  // 工具事件
+  ToolCallStartEvent,
+  ToolCallResultEvent,
+  ToolCallOutputEvent,
+  ToolApprovalRequestEvent,
+  ToolEvent,
+  
+  // 文本事件
+  TextDeltaEvent,
+  TextEvent,
+  
+  // 计划类型
+  PlanStep,
+  PlanStepStatus,
+  
+  // 状态事件
+  DoneEvent,
+  ErrorEvent,
+  AbortEvent,
+  StatusEvent,
+  
+  // 步骤事件
+  StepStartEvent,
+  StepEndEvent,
+  StepEvent,
+} from '@huyooo/ai-chat-core/events'
+
+// 重新导出事件创建函数和类型守卫（从子路径导入，renderer 安全）
+export {
+  createThinkingStart,
+  createThinkingDelta,
+  createThinkingEnd,
+  createSearchStart,
+  createSearchResult,
+  createSearchEnd,
+  createToolCallStart,
+  createToolCallResult,
+  createToolCallOutput,
+  createTextDelta,
+  createDone,
+  createError,
+  createApiError,
+  createRateLimitError,
+  createToolError,
+  createTimeoutError,
+  createParseError,
+  createAbort,
+  createStepStart,
+  createStepEnd,
+  isThinkingEvent,
+  isSearchEvent,
+  isToolEvent,
+  isTextEvent,
+  isStatusEvent,
+  isErrorEvent,
+  isAbortEvent,
+  isStepEvent,
+  isRetryableError,
+} from '@huyooo/ai-chat-core/events'
+
+// ==================== 从 ai-chat-core 重新导出配置类型 ====================
+
+export type {
+  // 模式类型（ChatMode 本地定义以支持更多值）
+  ThinkingMode,
+  AutoRunMode,
+  AutoRunConfig,
+  
+  // 模型类型
+  ModelOption,
+  ProviderType,
+  
+  // 聊天选项（使用本地 ChatOptions）
+  
+  // MCP 类型
+  McpServerConfig,
+  McpConnectionStatus,
+  McpConnectionInfo,
+} from '@huyooo/ai-chat-core'
+
+/** 对话模式（扩展支持 'plan'，兼容旧数据） */
+export type ChatMode = 'agent' | 'ask' | 'plan'
+
+// ==================== 适配器专用类型（本包定义）====================
+
+/** 聊天历史消息（无状态架构传入） */
+export interface ChatHistoryMessage {
+  role: 'user' | 'assistant' | 'system' | 'tool'
+  content: string
+}
+
+/** 聊天选项（使用本地 ChatMode） */
+export interface ChatOptions {
+  mode?: ChatMode
+  model?: string
+  provider?: string
+  enableWebSearch?: boolean
+  thinkingMode?: 'enabled' | 'disabled'
+  enabledTools?: string[]
+  autoRunConfig?: {
+    mode?: 'run-everything' | 'manual'
+  }
+  history?: ChatHistoryMessage[]
+  /** Skills 内容（启用的 Skills 的 content 数组，前端拼好传入） */
+  skillContents?: string[]
+}
+
+/** 会话记录 */
+export interface SessionRecord {
+  id: string
+  appId: string | null
+  userId: string | null
+  title: string
+  model: string
+  mode: ChatMode
+  webSearchEnabled: boolean
+  thinkingEnabled: boolean
+  /** 是否在 tab 栏隐藏（关闭但不删除） */
+  hidden: boolean
+  createdAt: Date
+  updatedAt: Date
+}
+
+/** 消息记录 */
+export interface MessageRecord {
+  id: string
+  /** 前端关联 ID（本地模式与 id 相同，云端模式为前端生成的 UUID） */
+  clientId?: string | null
+  sessionId: string
+  role: 'user' | 'assistant'
+  content: string
+  /** 用户消息附带的图片（data URL 或 base64） */
+  images: string[]
+  /** 生成此消息时使用的模型 */
+  model?: string | null
+  /** 生成此消息时使用的模式 (ask/agent) */
+  mode?: string | null
+  /** 生成此消息时是否启用 web 搜索 */
+  webSearchEnabled?: boolean | null
+  /** 生成此消息时是否启用深度思考 */
+  thinkingEnabled?: boolean | null
+  /** 执行步骤列表 JSON */
+  steps?: string | null
+  operationIds?: string | null
+  /** Token 使用统计（JSON 字符串） */
+  usage?: string | null
+  /** 响应耗时（毫秒） */
+  duration?: number | null
+  /** 消息序号（会话内递增，用于分叉删除） */
+  sequence: number
+  /** 时间戳（毫秒，Unix 时间戳） */
+  timestamp: number
+}
+
+/** 操作记录 */
+export interface OperationRecord {
+  id: string
+  sessionId: string
+  messageId?: string | null
+  command: string
+  operationType: string
+  affectedFiles: string
+  status: string
+  timestamp: Date
+}
+
+/** 回收站记录 */
+export interface TrashRecord {
+  id: string
+  sessionId: string
+  originalPath: string
+  trashPath: string
+  deletedAt: Date
+  autoDeleteAt: Date
+}
+
+/** Skill 记录（云端管理的 system prompt 片段） */
+export interface SkillRecord {
+  id: string
+  name: string
+  description: string
+  content: string
+  icon: string
+  enabled: boolean
+  builtIn: boolean
+  createdAt: Date
+  updatedAt: Date
+}
+
+/** 文件信息 */
+export interface FileInfo {
+  name: string
+  path: string
+  isDirectory: boolean
+  size: number
+  modifiedAt: Date
+  extension: string
+}
+
+/** 工具信息 */
+export interface ToolInfo {
+  name: string
+  description: string
+}
+
+/** 工具批准请求 */
+export interface ToolApprovalRequest {
+  id: string
+  name: string
+  args: Record<string, unknown>
+}
+
+// ==================== ASR 语音识别 ====================
+
+/** ASR 会话配置 */
+export interface AsrSessionConfig {
+  /** 音频格式 */
+  format?: 'pcm' | 'wav'
+  /** 采样率 */
+  sampleRate?: number
+  /** 启用标点 */
+  enablePunc?: boolean
+  /** 启用 ITN（数字规整） */
+  enableItn?: boolean
+  /** 启用语义顺滑 */
+  enableDdc?: boolean
+  /** 输出分句信息 */
+  showUtterances?: boolean
+}
+
+/** ASR 识别结果 */
+export interface AsrResultData {
+  result?: {
+    text: string
+    utterances?: Array<{
+      text: string
+      start_time: number
+      end_time: number
+      definite: boolean
+    }>
+  }
+  audio_info?: {
+    duration: number
+  }
+}
+
+// ==================== ChatAdapter 接口 ====================
+
+// 导入 ChatEvent 和 ModelOption 用于 ChatAdapter 接口
+// ChatOptions 使用本地定义（支持 'plan' 模式）
+import type { ChatEvent, ModelOption } from '@huyooo/ai-chat-core'
+
+/**
+ * ChatAdapter 接口
+ *
+ * 统一的聊天适配器接口，支持多种实现：
+ * - Electron IPC（ai-chat-bridge-electron）
+ * - HTTP/SSE（ai-chat-adapter-http）
+ * - 直连（ai-chat-adapter-direct，CLI 用）
+ *
+ * 行为统一保证：无论使用哪种实现（本地直连 / HTTP / 混合），对调用方接口一致——
+ * getModels()、sendMessage()、getSessions() 等语义相同，sendMessage 产出的事件均为
+ * ChatEvent 类型集（见 ai-chat-core/events），事件 type 与 data 形状由类型定义约束，
+ * 不因适配器或模型而异。core 层通过契约测试（CHAT_EVENT_TYPES）保证 Orchestrator
+ * 产出合法事件。
+ */
+export interface ChatAdapter {
+  // ============ Chat API ============
+  /** 获取可用模型 */
+  getModels(): Promise<ModelOption[]>
+  /** 获取所有工具列表（用于设置面板） */
+  getAllTools?(): Promise<ToolInfo[]>
+  /** 发送消息，返回异步迭代器 */
+  sendMessage(
+    message: string,
+    options?: ChatOptions,
+    images?: string[],
+    sessionId?: string
+  ): AsyncIterable<ChatEvent>
+  /** 取消当前请求 */
+  cancel(): void
+  /** 设置当前工作目录 */
+  setCwd?(dir: string): void
+
+  // ============ Sessions API ============
+  /** 获取会话列表 */
+  getSessions(): Promise<SessionRecord[]>
+  /** 获取单个会话 */
+  getSession(id: string): Promise<SessionRecord | null>
+  /** 创建会话 */
+  createSession(params?: CreateSessionParams): Promise<SessionRecord>
+  /** 更新会话 */
+  updateSession(id: string, data: UpdateSessionParams): Promise<SessionRecord | null>
+  /** 删除会话 */
+  deleteSession(id: string): Promise<void>
+
+  // ============ Messages API ============
+  /** 获取会话消息 */
+  getMessages(sessionId: string): Promise<MessageRecord[]>
+  /** 保存消息 */
+  saveMessage(params: SaveMessageParams): Promise<MessageRecord>
+  /** 更新消息（增量保存） */
+  updateMessage(params: UpdateMessageParams): Promise<void>
+  /** 删除指定时间之后的消息（用于分叉） */
+  deleteMessagesAfter(sessionId: string, timestamp: number): Promise<void>
+  /** 删除指定消息之后的所有消息（用于分叉） */
+  deleteMessagesAfterMessageId(sessionId: string, messageId: string): Promise<void>
+
+  // ============ Operations API ============
+  /** 获取操作日志 */
+  getOperations(sessionId: string): Promise<OperationRecord[]>
+
+  // ============ Trash API ============
+  /** 获取回收站 */
+  getTrashItems(): Promise<TrashRecord[]>
+  /** 恢复回收站项目 */
+  restoreFromTrash(id: string): Promise<TrashRecord | undefined>
+
+  // ============ File System API（可选，Electron/CLI 特有）============
+  listDir?(dirPath: string): Promise<FileInfo[]>
+  exists?(filePath: string): Promise<boolean>
+  stat?(filePath: string): Promise<FileInfo | null>
+  readFile?(filePath: string): Promise<string | null>
+  readFileBase64?(filePath: string): Promise<string | null>
+  homeDir?(): Promise<string>
+  resolvePath?(inputPath: string): Promise<string>
+  parentDir?(dirPath: string): Promise<string>
+  watchDir?(dirPath: string): Promise<boolean>
+  unwatchDir?(dirPath: string): Promise<void>
+  onDirChange?(callback: (data: { dirPath: string; eventType: string; filename: string | null }) => void): () => void
+
+  // ============ Settings API ============
+  getSetting?(key: string): Promise<string | null>
+  setSetting?(key: string, value: string): Promise<void>
+  getAllSettings?(): Promise<Record<string, string>>
+  deleteSetting?(key: string): Promise<void>
+
+  // ============ Index API（可选，文档索引）============
+  getIndexStats?(): Promise<{ totalDocuments: number; indexSize: number; lastUpdated: string | null }>
+  getIndexStatus?(): Promise<{ isIndexing: boolean; lastProgress: { indexed: number; total: number; currentFile?: string; stage: string } | null }>
+  syncIndex?(): Promise<{ success: boolean }>
+  cancelIndex?(): Promise<{ success: boolean }>
+  deleteIndex?(): Promise<{ success: boolean }>
+  registerIndexListener?(): Promise<{ success: boolean }>
+  unregisterIndexListener?(): Promise<{ success: boolean }>
+  onIndexProgress?(callback: (progress: { indexed: number; total: number; currentFile?: string; stage: string; error?: string }) => void): () => void
+
+  // ============ Skills API（可选，云端管理）============
+  /** 获取 Skills 列表 */
+  getSkills?(): Promise<SkillRecord[]>
+  /** 创建 Skill */
+  createSkill?(data: { name: string; description?: string; content: string; icon?: string }): Promise<SkillRecord>
+  /** 更新 Skill */
+  updateSkill?(id: string, data: { name?: string; description?: string; content?: string; icon?: string; enabled?: boolean }): Promise<void>
+  /** 删除 Skill */
+  deleteSkill?(id: string): Promise<void>
+  /** 切换 Skill 启用状态 */
+  toggleSkill?(id: string): Promise<{ enabled: boolean }>
+
+  // ============ Tool Approval API ============
+  onToolApprovalRequest?(callback: (request: ToolApprovalRequest) => void): () => void
+  respondToolApproval?(id: string, approved: boolean): Promise<void>
+
+  // ============ ASR API（可选）============
+  asrStart?(config?: AsrSessionConfig): Promise<{ success: boolean; error?: string }>
+  asrSendAudio?(audioData: ArrayBufferLike): Promise<{ success: boolean; error?: string }>
+  asrFinish?(): Promise<{ success: boolean; error?: string }>
+  asrStop?(): Promise<{ success: boolean }>
+  asrStatus?(): Promise<{ connected: boolean }>
+  asrWarmup?(config?: AsrSessionConfig): Promise<{ success: boolean; error?: string }>
+  onAsrConnected?(callback: () => void): () => void
+  onAsrResult?(callback: (data: { result: AsrResultData; isLast: boolean }) => void): () => void
+  onAsrError?(callback: (error: { message: string }) => void): () => void
+  onAsrClosed?(callback: () => void): () => void
+
+  // ============ System API（可选）============
+  openExternal?(url: string): Promise<void>
+}
+
+// ==================== 辅助参数类型 ====================
+
+/** 创建会话参数 */
+export interface CreateSessionParams {
+  title?: string
+  model?: string
+  mode?: string
+  webSearchEnabled?: boolean
+  thinkingEnabled?: boolean
+  hidden?: boolean
+}
+
+/** 更新会话参数 */
+export interface UpdateSessionParams {
+  title?: string
+  model?: string
+  mode?: string
+  webSearchEnabled?: boolean
+  thinkingEnabled?: boolean
+  hidden?: boolean
+}
+
+/** 保存消息参数 */
+export interface SaveMessageParams {
+  id?: string
+  sessionId: string
+  role: 'user' | 'assistant'
+  content: string
+  images?: string[]
+  model?: string
+  mode?: string
+  webSearchEnabled?: boolean
+  thinkingEnabled?: boolean
+  steps?: string
+  operationIds?: string
+}
+
+/** 更新消息参数 */
+export interface UpdateMessageParams {
+  id: string
+  content?: string
+  steps?: string
+  operationIds?: string
+  /** Token 使用统计（JSON 字符串） */
+  usage?: string
+  /** 响应耗时（毫秒） */
+  duration?: number
+}
+
+// ==================== 发送消息参数（用于 IPC）====================
+
+/** 发送消息参数 */
+export interface SendMessageParams {
+  message: string
+  images?: string[]
+  sessionId?: string
+  options?: {
+    mode?: string
+    model?: string
+    provider?: string
+    enableWebSearch?: boolean
+    thinkingMode?: string
+    thinkingBudget?: number
+    history?: ChatHistoryMessage[]
+  }
+}