Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
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);
}