ChatLab/electron/shared/types.ts

/**
 * Electron 主进程 / Preload / 渲染进程共享的 Agent 类型定义
 *
 * 此文件是 AgentRuntimeStatus、TokenUsage 等跨进程类型的唯一定义源。
 * 所有使用方应从此处导入，避免重复定义导致类型漂移。
 */

/**
 * 序列化后的结构化错误信息，跨进程传输 & 持久化存储。
 * 所有字段可选——仅在原始错误中存在时才填充。
 */
export interface SerializedErrorInfo {
  name: string | null
  message: string | null
  stack: string | null
  statusCode?: number | null
  url?: string | null
  responseBody?: string | null
  responseHeaders?: Record<string, string> | null
  requestBody?: string | null
  cause?: string | null
  provider?: string | null
  /** formatAIError 生成的用户友好摘要 */
  friendlyMessage?: string | null
}

export interface TokenUsage {
  promptTokens: number
  completionTokens: number
  totalTokens: number
}

export interface AgentRuntimeStatus {
  phase: 'compressing' | 'preparing' | 'thinking' | 'tool_running' | 'responding' | 'completed' | 'aborted' | 'error'
  round: number
  toolsUsed: number
  currentTool?: string
  contextTokens: number
  totalUsage: TokenUsage
  updatedAt: number
}