Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

23.5 KB
Raw Blame
import { CONTRIBUTION_ERROR_CODES } from './pluginContributionContract';
import type { BrowserOpenForLoginErrorCode } from './browserBackend';

/** main / preload / renderer 共用的 IPC 错误类型。 */

// Local companion-import errors. Remote Resource keeps its existing wire codes.
export const COMPANION_IMPORT_ERROR_CODES = [
  'AUTOMATION_CANCELLED',
  'AUTOMATION_COMMAND_FAILED',
  'AUTOMATION_DATA_READ_FAILED',
  'AUTOMATION_DEPENDENCY_NOT_SELECTED',
  'AUTOMATION_HANDOVER_REQUIRED',
  'AUTOMATION_NOT_FOUND',
  'AUTOMATION_OUTPUT_TOO_LARGE',
  'AUTOMATION_SCRIPT_MISSING',
  'AUTOMATION_TIMEOUT',
  'AUTOMATION_TIME_PASSED',
  'COMPANION_DELETED',
  'CONNECTION_CANCELLED',
  'CONNECTION_FAILED',
  'CONNECTION_LIMIT',
  'CONNECTION_TIMEOUT',
  'CREDENTIAL_STORAGE_FAILED',
  'CREDENTIAL_STORAGE_INVALID',
  'CREDENTIAL_STORAGE_UNAVAILABLE',
  'DELIVERY_CREDENTIAL_MISSING',
  'DELIVERY_FAILED',
  'DELIVERY_NOT_VERIFIED',
  'IMPORT_CALLER_UNAVAILABLE',
  'IMPORT_CANCELLED',
  'IMPORT_FAILED',
  'IMPORT_NAME_EXISTS',
  'INVALID_COMPANION',
  'INVALID_REQUEST',
  'INVALID_PACKAGE',
  'INVALID_SELECTION',
  'INVALID_TARGET',
  'OWNER_CHANGED',
  'PREVIEW_EXPIRED',
  'PROFILE_TEXT_TOO_LARGE',
  'REQUEST_ALREADY_USED',
  'SELECTION_CHANGED',
  'SOURCE_AGENT_INVALID',
  'SOURCE_AUTOMATIONS_INVALID',
  'SOURCE_AUTOMATION_CHANGED',
  'SOURCE_AUTOMATION_INVALID',
  'SOURCE_AUTOMATION_RUNNING',
  'SOURCE_CHANGED',
  'SOURCE_COMMAND_UNAVAILABLE',
  'SOURCE_CONFIG_INCLUDE_CYCLE',
  'SOURCE_CONFIG_INVALID',
  'SOURCE_CREDENTIAL_INVALID',
  'SOURCE_DATABASE_UNAVAILABLE',
  'SOURCE_DATABASE_DRIVER_UNAVAILABLE',
  'SOURCE_DATABASE_TOO_LARGE',
  'SOURCE_DATABASE_INVALID',
  'SOURCE_FILE_TOO_LARGE',
  'SOURCE_HANDOVER_COMMAND_FAILED',
  'SOURCE_HANDOVER_NOT_CONFIRMED',
  'SOURCE_HANDOVER_PENDING',
  'SOURCE_HANDOVER_UNCERTAIN',
  'SOURCE_ITEM_TOO_LARGE',
  'SOURCE_LINK_CYCLE',
  'SOURCE_LINK_OUTSIDE_FOLDER',
  'SOURCE_NOT_REGULAR_FILE',
  'SOURCE_SNAPSHOT_TOO_LARGE',
  'SOURCE_TOO_MANY_FILES',
  'SOURCE_TOO_MANY_ITEMS',
  'TARGET_AUTOMATION_CHANGED',
  'TARGET_HANDOVER_UNCERTAIN',
] as const;

export type IpcErrorCode =
  | (typeof CONTRIBUTION_ERROR_CODES)[number]
  | (typeof COMPANION_IMPORT_ERROR_CODES)[number]
  // 通用错误
  | 'INVALID_PARAMS'
  | 'NOT_FOUND'
  | 'INTERNAL'
  | 'ALREADY_EXISTS'
  | 'PRECONDITION_FAILED'
  | 'OFFICIAL_PLUGIN_GITHUB_REQUIRED' // 客户端提审限制,不扩展服务端 wire 错误
  | 'VOICE_SPEECH_TIMEOUT' // 本机语音合成等待响应或音频读取超时
  | 'PROVIDER_GROUP_CHANGED' // 编辑期间组设置已变化,拒绝覆盖,需重新读取
  | 'SHARE_NOT_CONFIGURED'
  | 'SHARE_UNAVAILABLE'
  | 'SHARE_READ_FAILED'
  | 'HTML_PREVIEW_TOO_LARGE'
  | 'HTML_PREVIEW_UNSUPPORTED'
  // 本地模型切换窗口保护的可行动失败原因。device-link 继续降级为
  // PRECONDITION_FAILED,避免把新增 Electron IPC code 变成跨版本 wire 契约。
  | 'MODEL_CONTEXT_USAGE_UNKNOWN'
  | 'MODEL_VISIBILITY_NOT_READY'
  | 'BOT_CREATION_MODEL_UNAVAILABLE'
  | 'MODEL_WINDOW_CURRENT_CONTEXT_UNKNOWN'
  | 'MODEL_WINDOW_TARGET_CONTEXT_UNKNOWN'
  | 'MODEL_WINDOW_REMOTE_REBUILD_UNSUPPORTED'
  | 'MODEL_WINDOW_PROTECTION_UNAVAILABLE'
  | 'MODEL_SWITCH_TASK_RUNNING'
  | 'MODEL_WINDOW_PREPARATION_IN_PROGRESS'
  // 远程 Agent 选择准入(选模型时目标电脑不可达 / 目录里没有)。device-link 同样降级为
  // PRECONDITION_FAILED,只在本机窗口给可行动的说明。
  | 'REMOTE_AGENT_DEVICE_UNREACHABLE'
  | 'REMOTE_AGENT_MODEL_UNAVAILABLE'
  | 'MAKER_MEMORY_NOT_READY'
  | 'SCHEDULER_NOT_READY'
  | 'PERMISSION_DENIED'
  | 'UNSUPPORTED_CAPABILITY'
  | 'SSH_HARNESS_SWITCH_UNSUPPORTED'
  | 'MODEL_SELECTION_UNAVAILABLE'
  | 'HARNESS_SWITCH_NOT_READY'
  | 'SHARED_TASK_HOST_LIMIT'
  | 'SHARED_TASK_JOIN_LIMIT'
  | 'SHARED_TASK_GUEST_LIMIT'
  | 'SHARED_TASK_SELF_JOIN'
  // 供应商分享(docs/provider-sharing-contract.md §3.3)
  | 'PROVIDER_SHARE_LINK_USED'
  | 'PROVIDER_SHARE_LINK_EXPIRED'
  | 'PROVIDER_SHARE_SELF'
  | 'PROVIDER_SHARE_ALREADY_MEMBER'
  | 'PROVIDER_SHARE_IDENTITY_INVALID'
  | 'PROVIDER_SHARE_NOT_HOST_DEVICE'
  | 'PROVIDER_SHARE_CROSS_REGION_DISABLED'
  | 'REMOTE_AGENT_SHARE_PAUSED'
  | 'REMOTE_AGENT_SHARE_REMOVED'
  | 'REMOTE_AGENT_SHARE_UNAVAILABLE'
  | 'APP_SHORTCUTS_WRITE_FAILED'
  | 'NO_ACTIVE_TURN'
  | 'SESSION_RUNNING'
  // 共享 codex 进程要切凭证形态但有其它本地会话在忙(可能等很久)。与 SESSION_RUNNING
  // 分开:后者是"本会话在跑"的短时状态;混用会让「新建会话/切模型」场景弹出误导性的
  // "会话运行中"文案(实际是别的会话挡住了凭证切换)。
  | 'CREDENTIAL_SWITCH_BUSY'
  // Pi 热切 SuperGrok 时 switch_session 未确认,任务已终止。
  | 'PI_CATALOG_RELOAD_UNCONFIRMED'
  // 远端 Claude 路由 materialization 失败(remote-claude-route.ts):
  // 供应商凭证 mutation 窗口(稍后重试)/ 远端不可表达(换来源)/ 订阅未连接(连接 Claude.ai)。
  | 'REMOTE_PROVIDER_UPDATING'
  | 'REMOTE_PROVIDER_UNSUPPORTED'
  | 'REMOTE_NATIVE_OAUTH_UNAVAILABLE'
  // 工作区 .claude 设置会改写 Claude 订阅会话的上游 / 鉴权 / TLS 信任(workspace-settings-guard),
  // 拒绝启动订阅会话。
  | 'CLAUDE_SUBSCRIPTION_WORKSPACE_OVERRIDE'
  // 远端 Pi 会话启动时 Cindy AI gateway endpoint 未就绪(登录后自动下发):
  // renderer 走 logic.errors.remoteError.REMOTE_GATEWAY_ENDPOINT_UNAVAILABLE。
  | 'REMOTE_GATEWAY_ENDPOINT_UNAVAILABLE'
  // 远端 Pi 会话选了 baseUrl 指向本机 loopback 的 BYOM provider(Ollama 等):
  // 远端进程连不到本机服务, 创建时拒绝并引导换网关/远端可达 BYOM。
  | 'REMOTE_LOCAL_ONLY_PROVIDER'
  // 本机托管 Ollama sidecar 尚未就绪:引导去设置 → 模型供应商 → Ollama。
  | 'LOCAL_OLLAMA_NOT_READY'
  // 远端切模/切来源需要不同路由(claude-code setModel 守卫):提示重建会话。
  | 'REMOTE_MODEL_SWITCH_ROUTE_CHANGE'
  | 'NO_LIVE_QUERY'
  // 已保存账号切换 / 同步 / 新增账号。保留 auth 业务码跨 Electron IPC,
  // renderer 才能区分重新登录、区域不匹配与本地凭证库故障。
  | 'INVALID_AUTH_ACTION'
  | 'PASSIVE_AUTH_MUTATION_BLOCKED'
  | 'ACCOUNT_NOT_FOUND'
  | 'ACCOUNT_REAUTH_REQUIRED'
  | 'REGION_MISMATCH'
  | 'CREDENTIAL_STORE_UNAVAILABLE'
  | 'AUTH_FLOW_SUPERSEDED'
  // 智能通讯录: (platform, value) 身份已属于另一个联系人 — message 里带占用者 id
  | 'IDENTITY_CONFLICT'
  // domain-specific
  | 'STALE_DIFF'
  | 'PUSH_LEASE_EXPIRED'
  | 'PUSH_NO_REMOTE'
  | 'MARK_DONE_FAILED'
  | 'SOURCE_NEVER_RAN'
  | 'NO_PRIOR_ASSISTANT'
  | 'CODEX_FORK_STATE_UNAVAILABLE'
  | 'FORK_UNSUPPORTED_HISTORY'
  | 'REWIND_GIT_CONFLICT'
  | 'REWIND_GIT_FAILED'
  | 'REWIND_UNSUPPORTED_HISTORY'
  | 'REWIND_TARGET_NOT_LATEST'
  | 'TURN_CHANGE_GIT_UNAVAILABLE'
  // multi-worker
  | 'DUPLICATE_LABEL'
  | 'WORKER_CREATION_IN_PROGRESS'
  | 'WORKER_LIMIT_HARD_EXCEEDED'
  | 'WORKER_NOT_FOUND'
  | 'ALREADY_IDLE'
  | 'WORKER_STATE_CHANGED'
  | 'BUDGET_MODEL_REQUIRES_API_MODE'
  | 'NO_PROVIDER_FOR_AGENT'
  | 'PROVIDER_ROUTE_UNAVAILABLE'
  // AI 重新命名:仅暴露用户可以采取明确行动的失败原因。
  | 'TITLE_NO_MATERIAL'
  | 'TITLE_PROVIDER_UNSUPPORTED'
  // 会话内 /goal
  | 'GOAL_ALREADY_ACTIVE'
  | 'GOAL_NOT_FOUND'
  // /learn 蒸馏(learn-host)
  | 'LEARN_BUSY' // 已有 learn run 在进行(全局并发 1)
  | 'LEARN_INVALID_STATE' // run 状态不允许该操作(如对非 awaiting-review 调 apply)
  // remote-ssh:连接阶段
  | 'SSH_HOST_KEY_MISMATCH'
  | 'SSH_CONNECT_FAILED'
  | 'SSH_AUTH_FAILED'
  | 'SSH_CONFIG_IO_FAILED'
  | 'SSH_CONFIG_CONCURRENT_MODIFICATION'
  | 'SSH_CONFIG_OWNERSHIP_REQUIRED'
  | 'SSH_CONFIG_RELOAD_REQUIRED'
  | 'SSH_CONFIG_AUTH_UNSUPPORTED'
  | 'SSH_AGENT_UNAVAILABLE'
  | 'SSH_HOST_PREFS_WRITE_FAILED'
  | 'SSH_HOST_NOT_FOUND'
  // remote-ssh:配置的私钥文件在磁盘上不存在/不可读。与 SSH_CONNECT_FAILED 分开——
  // 这是本机路径问题(缺失 / ~ 未展开 / 路径被改写),不是网络或服务器错误,renderer
  // 据此显示明确的路径错误并允许重新选择密钥 / 编辑主机。
  | 'SSH_KEY_FILE_NOT_FOUND'
  // remote-ssh:远端 agent 阶段
  | 'SSH_NOT_CONNECTED'
  | 'SSH_INSTALL_FAILED'
  | 'SSH_EXEC_FAILED'
  | 'SSH_AGENT_NOT_INSTALLED'
  // remote-ssh:项目选择器远端目录列表
  | 'SSH_REMOTE_LS_FAILED'
  // remote-ssh:file-service(SSH 远程会话的文件浏览 daemon)不可用——
  // 连接失败 / 安装失败 / daemon 版本无法对齐 / RPC 通道断开
  | 'REMOTE_FS_UNAVAILABLE'
  // hook-control: 连接未处于 connected 状态(Slack 绑定发起/解除要求在线)
  | 'HOOK_NOT_CONNECTED'
  // hook-control: 目录偏好读写往返超时 —— server 大概率是不认识 prefs.* 帧的
  // 旧版本(丢帧不应答), 也可能是卡死; renderer 据此显示"服务器版本过旧"
  | 'HOOK_PREFS_TIMEOUT'
  // hook-control: server 未宣告 multi-team 能力(多 workspace 绑定操作不可用;
  // renderer 本就按 serverMultiTeam 隐藏入口, 本码是防御性兜底)
  | 'HOOK_MULTI_TEAM_UNSUPPORTED'
  // 本机文件系统浏览(项目选择器;device-link 经隧道在被控端执行)
  | 'FS_BROWSE_FAILED'
  // device-link(跨设备远程控制)
  | 'DEVICE_LINK_UNAVAILABLE' // relay 不可达 / server 未启用该功能
  | 'DEVICE_LINK_NOT_CONNECTED' // 本机尚未连上 relay(未登录 / 断线中)
  | 'DEVICE_LINK_BUSY' // 请求队列繁忙,连接仍可能正常
  | 'DEVICE_LINK_STANDBY' // 本实例处于单持有者仲裁的被动态(同机另一实例持有 relay 连接)
  | 'DEVICE_LINK_DEVICE_OFFLINE' // 目标设备离线
  | 'DEVICE_LINK_REMOTE_DISABLED' // 目标设备「允许被控」开关关闭
  | 'DEVICE_LINK_CHANNEL_NOT_ALLOWED' // channel 不在远程白名单
  | 'DEVICE_LINK_ACCESS_REVOKED' // 目标设备已撤销本机的访问权限(逐设备黑名单)
  | 'DEVICE_LINK_CONTROL_DISABLED' // 本机已关闭对该目标设备的控制(控制端本地偏好)
  | 'DEVICE_LINK_TIMEOUT' // 等待远端响应超时
  | 'DEVICE_LINK_DEVICE_UNRESPONSIVE' // 目标设备连续超时被熔断判定无响应(弱网 / 对端卡死),快速失败中
  | 'DEVICE_LINK_VERSION_MISMATCH' // 两端协议/版本不匹配
  | 'DEVICE_LINK_MEDIA_TRANSFER_FAILED' // 远程媒体经 OSS 中转失败(出方向附件上传 / 入方向取媒体)
  | 'DEVICE_LINK_MEDIA_ACCESS_DENIED' // 控制端源附件不可读,需重新添加可访问的副本
  | 'REMOTE_WORKDIR_INVALID' // 被控端工作目录路径非法
  | 'REMOTE_WORKDIR_NOT_FOUND' // 被控端工作目录不存在
  | 'REMOTE_WORKDIR_NOT_DIRECTORY' // 被控端工作路径存在但不是目录
  | 'REMOTE_WORKDIR_UNAVAILABLE' // 被控端网络目录不可访问 / 探测超时
  | 'SESSION_REFERENCE_UNAVAILABLE' // 会话引用不存在、离线、撤权、预算/形状非法
  | 'SESSION_REFERENCE_UNSUPPORTED' // 目标端版本不能消费可信会话引用快照
  // right-sidebar tabs(对标 Codex in-app browser sidebar 多 Tab 容器)
  | 'RIGHT_SIDEBAR_TOO_MANY_TABS' // 单 session 超 20 个 tab
  | 'RIGHT_SIDEBAR_UNKNOWN_KIND' // kind 不在 plugin registry 里
  | 'RIGHT_SIDEBAR_STATE_TOO_LARGE' // 单 tab state JSON 序列化 > 16KB
  | 'INVALID_ARGUMENT'
  | 'DEVICE_BUSY'
  | 'MUTATION_CANCELLED'
  | 'PI_PACKAGE_LIST_FAILED'
  | 'PI_PACKAGE_MUTATION_FAILED'
  | 'TERMINAL_NOT_FOUND' // 指定 ptyId 不存在(可能已 dispose / 从未创建)
  | 'TERMINAL_SPAWN_FAILED' // node-pty spawn 抛错(权限 / 路径不可达等)
  | 'TERMINAL_SHELL_NOT_FOUND' // 用户偏好的 shell 二进制不在系统上
  | 'TERMINAL_ALREADY_DISPOSED' // 在已 dispose 的 session 上调 restart 等操作
  // 意识(.cindy 装入)
  | 'GHOST_FILE_INVALID' // 不是合法 zip / 缺 ghost.json / 清单不合格 / 超限
  | 'GHOST_DOWNLOAD_TIMEOUT' // 市场包下载总时限或无进展超时
  | 'GHOST_DOWNLOAD_FAILED' // 市场包下载网络失败
  | 'GHOST_HOST_UNSUPPORTED' // 插件包使用了当前 Cindy 不认识的未来 schema
  | 'GHOST_COMMAND_CONFLICT' // 显式指令与已装意识撞名(装入拒绝)
  | 'GHOST_ID_RESERVED' // id 属 shared/ghost.ts 登记的官方保留前缀,用户通道拒装(防抢注蹭凭证别名)
  | 'GHOST_BROKER_MANUAL_INSTALL_NOT_AUTHORIZED' // 本地 .cindy 来源无权使用授权 broker
  | 'GHOST_BROKER_REDIRECT_PORT_REQUIRED' // 新包声明授权 broker 时缺少本机回跳端口
  // 自定义插件市场源(Git / 本地文件夹)
  | 'MARKET_SOURCE_INVALID' // 来源格式非法 / 本地路径不是目录 / 参数组合不允许
  | 'MARKET_GIT_UNAVAILABLE' // 未安装 Git 或版本 < 2.25(稀疏检出下限)
  | 'MARKET_CLONE_AUTH_FAILED' // 克隆被拒绝:私有仓库未配置认证
  | 'MARKET_CLONE_FAILED' // 克隆/拉取失败:网络、代理或远端其它错误
  | 'MARKET_REF_NOT_FOUND' // 指定的 Git 引用(分支/tag/commit)在远端不存在
  | 'MARKET_MANIFEST_MISSING' // 来源内找不到受支持的 marketplace.json
  | 'PLUGIN_NAMESPACE_CLIENT_REQUIRED' // 企业插件需要支持 namespace 的客户端
  | 'PLUGIN_ORGANIZATION_CONTEXT_UNAVAILABLE' // 暂时无法确认企业身份,可重试
  | 'PLUGIN_NAMESPACE_CONFIG_REQUIRED' // 企业插件服务配置不可用
  | 'PLUGIN_LIST_CHANGED' // 企业准入在翻页期间变化,需要从头重拉
  // 网关凭据自动下发(model-access)
  | 'MODEL_ACCESS_FAILED' // 拉取/轮换失败(网络或服务端错误),可重试
  | 'MODEL_ACCESS_DISABLED' // 服务端灰度未启用(503)——走手填兜底
  | 'MODEL_ACCESS_UNSUPPORTED' // 企业未接入(403)——XD 网关不可用,不重试
  | 'MODEL_CATALOG_FETCH_DISABLED' // 模型目录远程拉取被禁用(XDT_DISABLE_MODELS_FETCH),未发起请求
  | 'PLAN_CHANGE_RENEWAL_PREPAID' // 下一期已付未生效,等待本期结束后升级
  | 'PLAN_CHANGE_NOT_AVAILABLE' // 当前订阅不能切换到目标套餐,可返回候选列表重选
  | 'RESUME_NOT_AVAILABLE' // 当前订阅已到期、渠道协议失效或状态不可恢复
  // 钉钉机器人连接
  | 'DINGTALK_AUTH_FAILED' // Client ID / Client Secret 被钉钉拒绝
  | 'DINGTALK_NETWORK_FAILED' // 钉钉凭证校验接口不可达
  | 'DINGTALK_STREAM_CONNECTION_FAILED' // 凭证有效,但 Stream WebSocket 未建立
  // 个人资料自助修改(settings → 用户卡片;服务端直写)
  | 'PROFILE_AVATAR_UPLOAD_FAILED' // 头像经 oss-server 预签名直传失败(presign 或 PUT 阶段)
  | 'PROFILE_UPDATE_FAILED' // PATCH /api/me/profile 失败(网络 / 服务端拒绝)
  // 打开 Agent 专用浏览器:只跨 IPC 暴露受控原因,不暴露路径或底层异常。
  | BrowserOpenForLoginErrorCode
  // 本机 HTML 页面打开到系统浏览器
  | 'BROWSER_FILE_INVALID_TARGET'
  | 'BROWSER_FILE_PATH_NOT_ALLOWED'
  | 'BROWSER_FILE_UNSUPPORTED_TYPE'
  | 'BROWSER_FILE_NOT_FOUND'
  | 'BROWSER_FILE_OPEN_FAILED'
  | 'HTML_PREVIEW_CANCELLED'
  // 会话分享(.cshare 导出/导入)
  | 'SHARE_FILE_INVALID' // 不是 .cshare / 头或 manifest 损坏 / payload 不是 zip
  | 'SHARE_PASSWORD_REQUIRED' // 文件已加密但未提供密码
  | 'SHARE_PASSWORD_WRONG' // GCM tag 校验失败:密码错误或文件被篡改
  | 'SHARE_VERSION_UNSUPPORTED' // 包要求的 reader 版本高于本端
  | 'SHARE_CONFLICT' // 同 sdkSessionId/threadId 的会话或转录已存在
  | 'SHARE_EXPORT_FAILED' // 导出编排失败(含超出体积上限)
  | 'SHARE_IMPORT_FAILED' // 导入编排失败(已回滚)
  | 'SHARE_WORKTREE_NOT_GIT' // 导入勾选 worktree 但所选目录不在 git 仓库内
  | 'SHARE_WORKTREE_FAILED' // 导入时 worktree 创建失败(已中止导入)
  // 主题导入(local-themes:import)
  | 'THEME_NOT_A_FILE' // 选中路径不是普通文件
  | 'THEME_FILE_TOO_LARGE' // 超 4MB 上限
  | 'THEME_UNSUPPORTED_FILE' // 无法识别为 VSCode / Obsidian 主题
  | 'THEME_CONTRAST_UNSUPPORTED' // 主题色板无法满足控件对比度约束
  | 'THEME_USES_INCLUDE' // VSCode 主题含 include(需基底才能完整解析)
  | 'THEME_WRITE_ERROR' // 落盘失败(权限/磁盘)
  | 'THEME_IMPORT_INTERNAL' // 意外异常
  // 客户端日志上报(log-upload:upload-now)。四种失败要能被 renderer 区分成不同文案:
  // 「本构建没配上报目标」「还没同意隐私政策」「采到 0 条」「网络失败」是四种不同的用户处置。
  | 'LOG_UPLOAD_UNAVAILABLE' // 本构建未配置上报目标 = 功能整体关闭
  | 'PRIVACY_CONSENT_REQUIRED' // 未明示同意《隐私政策》
  | 'LOG_UPLOAD_EMPTY' // 采集后没有任何可上报的记录
  | 'LOG_UPLOAD_FAILED' // 上传失败(离线 / 被拒 / 超时)
  | 'LOG_UPLOAD_BUSY'; // 已有一次上报在进行中

export interface IpcError {
  code: IpcErrorCode;
  message: string;
}

const IPC_ERROR_CODES: ReadonlySet<IpcErrorCode> = new Set<IpcErrorCode>([
  ...COMPANION_IMPORT_ERROR_CODES,
  ...CONTRIBUTION_ERROR_CODES,
  'INVALID_PARAMS',
  'NOT_FOUND',
  'INTERNAL',
  'ALREADY_EXISTS',
  'IDENTITY_CONFLICT',
  'PRECONDITION_FAILED',
  'OFFICIAL_PLUGIN_GITHUB_REQUIRED',
  'VOICE_SPEECH_TIMEOUT',
  'PROVIDER_GROUP_CHANGED',
  'SHARE_NOT_CONFIGURED',
  'SHARE_UNAVAILABLE',
  'SHARE_READ_FAILED',
  'HTML_PREVIEW_TOO_LARGE',
  'HTML_PREVIEW_UNSUPPORTED',
  'MODEL_CONTEXT_USAGE_UNKNOWN',
  'MODEL_VISIBILITY_NOT_READY',
  'BOT_CREATION_MODEL_UNAVAILABLE',
  'MODEL_WINDOW_CURRENT_CONTEXT_UNKNOWN',
  'MODEL_WINDOW_TARGET_CONTEXT_UNKNOWN',
  'MODEL_WINDOW_REMOTE_REBUILD_UNSUPPORTED',
  'MODEL_WINDOW_PROTECTION_UNAVAILABLE',
  'MODEL_SWITCH_TASK_RUNNING',
  'MODEL_WINDOW_PREPARATION_IN_PROGRESS',
  'REMOTE_AGENT_DEVICE_UNREACHABLE',
  'REMOTE_AGENT_MODEL_UNAVAILABLE',
  'MAKER_MEMORY_NOT_READY',
  'SCHEDULER_NOT_READY',
  'PERMISSION_DENIED',
  'UNSUPPORTED_CAPABILITY',
  'SSH_HARNESS_SWITCH_UNSUPPORTED',
  'MODEL_SELECTION_UNAVAILABLE',
  'HARNESS_SWITCH_NOT_READY',
  'SHARED_TASK_HOST_LIMIT',
  'SHARED_TASK_JOIN_LIMIT',
  'SHARED_TASK_GUEST_LIMIT',
  'SHARED_TASK_SELF_JOIN',
  'PROVIDER_SHARE_LINK_USED',
  'PROVIDER_SHARE_LINK_EXPIRED',
  'PROVIDER_SHARE_SELF',
  'PROVIDER_SHARE_ALREADY_MEMBER',
  'PROVIDER_SHARE_IDENTITY_INVALID',
  'PROVIDER_SHARE_NOT_HOST_DEVICE',
  'PROVIDER_SHARE_CROSS_REGION_DISABLED',
  'REMOTE_AGENT_SHARE_PAUSED',
  'REMOTE_AGENT_SHARE_REMOVED',
  'REMOTE_AGENT_SHARE_UNAVAILABLE',
  'APP_SHORTCUTS_WRITE_FAILED',
  'NO_ACTIVE_TURN',
  'SESSION_RUNNING',
  'CREDENTIAL_SWITCH_BUSY',
  'PI_CATALOG_RELOAD_UNCONFIRMED',
  'REMOTE_PROVIDER_UPDATING',
  'REMOTE_PROVIDER_UNSUPPORTED',
  'REMOTE_NATIVE_OAUTH_UNAVAILABLE',
  'CLAUDE_SUBSCRIPTION_WORKSPACE_OVERRIDE',
  'REMOTE_GATEWAY_ENDPOINT_UNAVAILABLE',
  'REMOTE_LOCAL_ONLY_PROVIDER',
  'LOCAL_OLLAMA_NOT_READY',
  'REMOTE_MODEL_SWITCH_ROUTE_CHANGE',
  'NO_LIVE_QUERY',
  'INVALID_AUTH_ACTION',
  'PASSIVE_AUTH_MUTATION_BLOCKED',
  'ACCOUNT_NOT_FOUND',
  'ACCOUNT_REAUTH_REQUIRED',
  'REGION_MISMATCH',
  'CREDENTIAL_STORE_UNAVAILABLE',
  'AUTH_FLOW_SUPERSEDED',
  'STALE_DIFF',
  'PUSH_LEASE_EXPIRED',
  'PUSH_NO_REMOTE',
  'MARK_DONE_FAILED',
  'SOURCE_NEVER_RAN',
  'NO_PRIOR_ASSISTANT',
  'CODEX_FORK_STATE_UNAVAILABLE',
  'FORK_UNSUPPORTED_HISTORY',
  'REWIND_GIT_CONFLICT',
  'REWIND_GIT_FAILED',
  'REWIND_UNSUPPORTED_HISTORY',
  'REWIND_TARGET_NOT_LATEST',
  'TURN_CHANGE_GIT_UNAVAILABLE',
  'DUPLICATE_LABEL',
  'WORKER_CREATION_IN_PROGRESS',
  'WORKER_LIMIT_HARD_EXCEEDED',
  'WORKER_NOT_FOUND',
  'ALREADY_IDLE',
  'WORKER_STATE_CHANGED',
  'BUDGET_MODEL_REQUIRES_API_MODE',
  'NO_PROVIDER_FOR_AGENT',
  'PROVIDER_ROUTE_UNAVAILABLE',
  'TITLE_NO_MATERIAL',
  'TITLE_PROVIDER_UNSUPPORTED',
  'GOAL_ALREADY_ACTIVE',
  'GOAL_NOT_FOUND',
  'LEARN_BUSY',
  'LEARN_INVALID_STATE',
  'SSH_HOST_KEY_MISMATCH',
  'SSH_CONNECT_FAILED',
  'SSH_AUTH_FAILED',
  'SSH_CONFIG_IO_FAILED',
  'SSH_CONFIG_CONCURRENT_MODIFICATION',
  'SSH_CONFIG_OWNERSHIP_REQUIRED',
  'SSH_CONFIG_RELOAD_REQUIRED',
  'SSH_CONFIG_AUTH_UNSUPPORTED',
  'SSH_AGENT_UNAVAILABLE',
  'SSH_HOST_PREFS_WRITE_FAILED',
  'SSH_HOST_NOT_FOUND',
  'SSH_KEY_FILE_NOT_FOUND',
  'SSH_NOT_CONNECTED',
  'SSH_INSTALL_FAILED',
  'SSH_EXEC_FAILED',
  'SSH_AGENT_NOT_INSTALLED',
  'SSH_REMOTE_LS_FAILED',
  'REMOTE_FS_UNAVAILABLE',
  'HOOK_NOT_CONNECTED',
  'HOOK_PREFS_TIMEOUT',
  'HOOK_MULTI_TEAM_UNSUPPORTED',
  'FS_BROWSE_FAILED',
  'DEVICE_LINK_UNAVAILABLE',
  'DEVICE_LINK_NOT_CONNECTED',
  'DEVICE_LINK_BUSY',
  'DEVICE_LINK_STANDBY',
  'DEVICE_LINK_DEVICE_OFFLINE',
  'DEVICE_LINK_REMOTE_DISABLED',
  'DEVICE_LINK_CHANNEL_NOT_ALLOWED',
  'DEVICE_LINK_ACCESS_REVOKED',
  'DEVICE_LINK_CONTROL_DISABLED',
  'DEVICE_LINK_TIMEOUT',
  'DEVICE_LINK_DEVICE_UNRESPONSIVE',
  'DEVICE_LINK_VERSION_MISMATCH',
  'DEVICE_LINK_MEDIA_TRANSFER_FAILED',
  'DEVICE_LINK_MEDIA_ACCESS_DENIED',
  'REMOTE_WORKDIR_INVALID',
  'REMOTE_WORKDIR_NOT_FOUND',
  'REMOTE_WORKDIR_NOT_DIRECTORY',
  'REMOTE_WORKDIR_UNAVAILABLE',
  'SESSION_REFERENCE_UNAVAILABLE',
  'SESSION_REFERENCE_UNSUPPORTED',
  'RIGHT_SIDEBAR_TOO_MANY_TABS',
  'RIGHT_SIDEBAR_UNKNOWN_KIND',
  'RIGHT_SIDEBAR_STATE_TOO_LARGE',
  'INVALID_ARGUMENT',
  'DEVICE_BUSY',
  'MUTATION_CANCELLED',
  'PI_PACKAGE_LIST_FAILED',
  'PI_PACKAGE_MUTATION_FAILED',
  'TERMINAL_NOT_FOUND',
  'TERMINAL_SPAWN_FAILED',
  'TERMINAL_SHELL_NOT_FOUND',
  'TERMINAL_ALREADY_DISPOSED',
  'GHOST_FILE_INVALID',
  'GHOST_DOWNLOAD_TIMEOUT',
  'GHOST_DOWNLOAD_FAILED',
  'GHOST_HOST_UNSUPPORTED',
  'GHOST_COMMAND_CONFLICT',
  'GHOST_ID_RESERVED',
  'GHOST_BROKER_MANUAL_INSTALL_NOT_AUTHORIZED',
  'GHOST_BROKER_REDIRECT_PORT_REQUIRED',
  'MARKET_SOURCE_INVALID',
  'MARKET_GIT_UNAVAILABLE',
  'MARKET_CLONE_AUTH_FAILED',
  'MARKET_CLONE_FAILED',
  'MARKET_REF_NOT_FOUND',
  'MARKET_MANIFEST_MISSING',
  'PLUGIN_NAMESPACE_CLIENT_REQUIRED',
  'PLUGIN_ORGANIZATION_CONTEXT_UNAVAILABLE',
  'PLUGIN_NAMESPACE_CONFIG_REQUIRED',
  'PLUGIN_LIST_CHANGED',
  'MODEL_ACCESS_FAILED',
  'MODEL_ACCESS_DISABLED',
  'MODEL_ACCESS_UNSUPPORTED',
  'MODEL_CATALOG_FETCH_DISABLED',
  'PLAN_CHANGE_RENEWAL_PREPAID',
  'PLAN_CHANGE_NOT_AVAILABLE',
  'RESUME_NOT_AVAILABLE',
  'DINGTALK_AUTH_FAILED',
  'DINGTALK_NETWORK_FAILED',
  'DINGTALK_STREAM_CONNECTION_FAILED',
  'PROFILE_AVATAR_UPLOAD_FAILED',
  'PROFILE_UPDATE_FAILED',
  'PROFILE_LOCKED',
  'REAL_PROFILE_READ_DENIED',
  'NO_CHROMIUM',
  'NO_AUTH_DB',
  'COPY_FAILED',
  'HEADLESS_FORBIDDEN',
  'STOP_FAILED',
  'FOREIGN_AGENT_BROWSER',
  'APP_BOUND_ENCRYPTION_UNSUPPORTED',
  'BROWSER_FILE_INVALID_TARGET',
  'BROWSER_FILE_PATH_NOT_ALLOWED',
  'BROWSER_FILE_UNSUPPORTED_TYPE',
  'BROWSER_FILE_NOT_FOUND',
  'BROWSER_FILE_OPEN_FAILED',
  'HTML_PREVIEW_CANCELLED',
  'SHARE_FILE_INVALID',
  'SHARE_PASSWORD_REQUIRED',
  'SHARE_PASSWORD_WRONG',
  'SHARE_VERSION_UNSUPPORTED',
  'SHARE_CONFLICT',
  'SHARE_EXPORT_FAILED',
  'SHARE_IMPORT_FAILED',
  'SHARE_WORKTREE_NOT_GIT',
  'SHARE_WORKTREE_FAILED',
  'THEME_NOT_A_FILE',
  'THEME_FILE_TOO_LARGE',
  'THEME_UNSUPPORTED_FILE',
  'THEME_CONTRAST_UNSUPPORTED',
  'THEME_USES_INCLUDE',
  'THEME_WRITE_ERROR',
  'THEME_IMPORT_INTERNAL',
  'LOG_UPLOAD_UNAVAILABLE',
  'PRIVACY_CONSENT_REQUIRED',
  'LOG_UPLOAD_EMPTY',
  'LOG_UPLOAD_FAILED',
  'LOG_UPLOAD_BUSY',
]);

export function isIpcErrorCode(code: unknown): code is IpcErrorCode {
  return typeof code === 'string' && IPC_ERROR_CODES.has(code as IpcErrorCode);
}

/**
 * 标准 IpcError 构造器 —— main 的 throwIpcError 与 renderer 侧预检共用同一形状
 * (`[code] message` + err.code),避免两处手写漂移。isIpcError 按 err.code 判定,
 * 不依赖 err.name。
 */
export function createIpcError(
  code: IpcErrorCode,
  message: string,
): Error & { code: IpcErrorCode } {
  const err = new Error(`[${code}] ${message}`) as Error & { code: IpcErrorCode };
  err.code = code;
  return err;
}

export function isIpcError(err: unknown): err is Error & { code: IpcErrorCode } {
  return err instanceof Error && isIpcErrorCode((err as { code?: unknown }).code);
}