Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 远程 IPC 隧道的 channel 白名单(默认拒绝制)。
*
* 准入判据(逐条核对 apps/desktop 的 maker-ipc/channels.ts 与 local-db ipc 后收录):
* 1. handler 不依赖 event.sender / 窗口对象;
* 2. 无本机 UI / shell / 对话框副作用;
* 3. 语义在「被控端」执行才正确(数据真相在被控端)。
*
* 永不放行的类别(列在这里供 review):窗口/UI 类(window-* / page-zoom / find-in-page /
* maker:open-session-in-new-window)、本机对话框(show-open-directory-dialog)、shell 副作用
* (shell:* / maker:mivo:open-model-file)、账号与密钥(auth:* / safe-storage / api-key 读写;
* 唯一例外是 presence-only 探测 maker:api-key:present,只回 boolean、不含密钥材料,见下)、
* updater / release-notes、被控端全局设置写(maker:compat-mode:set 等 *_SET 设置类——
* 远程改被控端全局设置越权)、local-db 裸写(sessions:create/update、messages:create——
* 写库必须经业务 handler,不开裸写)、maker:execute-desktop-command(UI 副作用)、
* 通用 migration / session-import、skillhub 写操作。任务迁移仅放行下述受限业务通道,
* 不开放通用导入、任意路径写入或裸数据库迁移。
*
* 双层校验:控制端发送前(快速失败)+ 被控端执行前(权威)。
* 新增 channel 不进表即天然不可远程调用(代码保证确定性)。
*
* 远程桌面专用例外: device-link:remote-desktop:v1 的 permissions/guide 只能
* 显示 Cindy 自己的权限引导,需同账号鉴权、远控与远程桌面两个本机 opt-in、未撤销。
* 不接受 URL、不直接打开系统设置/请求 OS 授权、不修改开关;系统权限按钮仅本机可信
* Renderer 可调用。它由业务 dispatch 拦截,绝不放行通用 UI / shell IPC。
*/
import { FILE_PEER_CHANNEL } from './filePeer.js';
import { PROVIDER_GROUP_REMOTE_CHANNEL } from './providerGroup.js';
import { REMOTE_AGENT_CHANNEL } from './remoteAgent.js';
import {
ORCA_EXECUTION_DEVICES_CHANNEL,
ORCA_REMOTE_WORKER_CAPS_CHANNEL,
ORCA_REMOTE_WORKER_BRIDGE_CHANNEL,
ORCA_REMOTE_WORKER_MODELS_CHANNEL,
ORCA_REMOTE_WORKER_OPEN_CHANNEL,
ORCA_REMOTE_WORKER_OPEN_TIMEOUT_MS,
ORCA_REMOTE_WORKER_RELEASE_CHANNEL,
} from './orcaRemoteWorker.js';
import { TASK_MIGRATION_CHANNEL } from './taskMigration.js';
import {
COMPANION_CLOUD_CAPS_CHANNEL,
COMPANION_CLOUD_FLUSH_CHANNEL,
COMPANION_CLOUD_HAND_OVER_CHANNEL,
COMPANION_CLOUD_HAND_OVER_TIMEOUT_MS,
COMPANION_CLOUD_MERGE_CHANNEL,
COMPANION_CLOUD_MERGE_TIMEOUT_MS,
COMPANION_CLOUD_TARGETS_CHANNEL,
} from './companionCloud.js';
import { SESSION_ACTIVITY_CHANNEL, SESSION_SYNC_CHANNEL } from './topics.js';
import { REMOTE_DESKTOP_INVOKE_MS } from './remoteDesktopIce.js';
import {
REMOTE_RESOURCE_CHANGED_CHANNEL,
REMOTE_RESOURCE_CHANNELS,
} from './remoteResources.js';
/**
* 订阅控制帧 channel(控制端 → 被控端,push 驱动):注册 / 注销对某 topic 的变更推送。
* 走 invoke 帧承载,被控端 dispatch 在通用 dispatch 前拦截(用 server 填的 env.src 作
* controllerDeviceId,防伪造),不进 ipcMain handler。client-agnostic:mobile/web 用同名 channel。
*/
export const DL_SUBSCRIBE_CHANNEL = 'device-link:subscribe';
export const DL_UNSUBSCRIBE_CHANNEL = 'device-link:unsubscribe';
/**
* cindy_helper 跨设备历史读取。被控端只接受单 session 的结构化只读查询,
* 并复用本机 history reader 的过滤、排序与游标语义。
*
* 响应除分页结果外附带可选 `terminal` 字段(会话尾部终态安全标记,
* { status:'error', createdAt? } 或 null):被控端与页面读取在同一次
* handler 调用内计算,保证标记与消息快照来自同一数据库时刻;错误正文
* 不出被控端。老被控端响应无此字段 → 控制端按无终态降级。
*/
export const DL_HISTORY_MESSAGES_CHANNEL = 'local-db:history:messages';
/** Same-account, linked, read-only history discovery/search. No shared-task or unlinked access. */
export const DL_HISTORY_QUERY_CHANNEL = 'local-db:history:query';
/**
* 同账号另一台电脑上的任务,把一条消息发给本机的既有任务(Agent 的 send_to_session
* 传 `deviceId::sessionId`)。只投递到既有任务,不新建;来源由被控端按服务端认证的
* 控制端设备 id 盖章。不进 unlinked / shared-task 白名单。老被控端无此 channel →
* CHANNEL_NOT_ALLOWED,发送方明确报「对方版本不支持」。
*/
export const DL_SESSION_HANDOFF_CHANNEL = 'maker:session:handoff';
/**
* 会话引用消费能力探针。控制端在发送含引用快照的队列消息前必须先调用;
* 老被控端不在 allowlist 中会返回 CHANNEL_NOT_ALLOWED,控制端据此显式拒绝,
* 避免消息看似发送成功但 Agent 只收到一条普通深链文本。
*/
export const DL_SESSION_REFERENCE_CAPABILITY_CHANNEL =
'maker:input:session-reference-capability';
/**
* 入方向媒体取件 channel(控制端 → 被控端):控制端要查看被控端会话里的媒体
* (图片/视频/文件/音频,字节在被控端本地缓存)时,发此 invoke 让被控端把原始媒体
* 解析成本地文件 → 上传 OSS 中转区(明文 + 同账号 key)→ 回 { ossKey, mimeType, size }。
* 与 subscribe 同样不是 ipcMain handler,被控端 dispatch 在通用 dispatch 前拦截执行
* (复用 remoteControlEnabled + 撤销黑名单 + allowlist 三道 gate,但绕过 ipcMain 路由)。
* 列入 allowlist 作契约登记 + 老被控端不识别时回 CHANNEL_NOT_ALLOWED 供控制端探测能力
* (无入方向媒体支持 → 控制端回退媒体占位)。
*/
export const DL_MEDIA_FETCH_CHANNEL = 'device-link:media:fetch';
/**
* Legacy 出方向语音转写 channel(控制端 → 被控端):早期方案里手机端录音后先经 server
* `/api/device-link/media/presign-put` 上传 OSS 中转区,再把 ossKey 交给被控桌面。
* 被控端下载音频并使用本机 voice-input batch ASR 配置转写,返回文本给手机插入 composer。
*
* 当前手机版语音主流程已改为 credential sync + 手机端实时 ASR/refine,此 channel
* 仅作为协议兼容面保留,不是 ipcMain handler,由 device-link dispatch 拦截执行。
*/
export const DL_VOICE_TRANSCRIBE_CHANNEL = 'device-link:voice:transcribe';
/**
* 手机端云端语音输入的临时 credential 同步 channel。
*
* 这是账号体系补齐前的窄口径例外:只允许同步 voice ASR/refine 所需的 XD Gateway key
* 与模型配置,由被控端 dispatch 专门拦截,不落通用 ipcMain,也不是 safe-storage/api-key
* 的通用远程读写能力。长期方案应改为「AI key 绑定用户账号,移动端登录后读自己的 key」。
*/
export const DL_VOICE_CREDENTIAL_SYNC_CHANNEL = 'device-link:voice:credential-sync';
/**
* 个人 Telegram bot 的跨设备上下线 channel(控制端 → 被控端)。
*
* 背景:个人 Telegram bot 是 BYO token 直连 Bot API 的 getUpdates 长轮询,
* 同一 token 同时只有一台设备能收消息(Telegram 侧 409),而两台设备之间**没有
* 任何通信通道**。换机器时想让另一端让位, 除了人肉去那台机器操作, 没有别的办法
* —— 这两个 channel 就是补这个缺口。
*
* 为什么不直接把 telegramBot:set-online 放进 allowlist: IM 的所有 IPC 在
* host.ipc.handle 里统一包了 assertTrustedAppRendererEvent(见 im/host.ts),
* 只认 Electron 持有的真实 sender; 而 dispatchLocalInvoke 用的是合成 event
* (sender: undefined), 必然判定不可信。那道闸是有意拦着的(IM 凭证/配置面全算
* 敏感面), 不该为远程下线放宽 —— 故与 media:fetch / voice:* 同款: 不是
* ipcMain handler, 由被控端 dispatch 在通用路由前拦截执行。
*
* 准入论证(对照本文件顶部三条判据):
* 1. 不依赖 event.sender / 窗口;
* 2. 无本机 UI / shell / 对话框副作用;
* 3. 语义只在被控端执行才正确 —— 要停的正是那台机器的轮询。
* 与"永不放行"的两类刻意划清界限:**不碰凭证**(token / owner id 不读不写不
* 外传, 下线只写一个布尔标志、解绑仍然只能本机操作), 也**不是通用设置写**
* (单一用途、只切轮询, 不是 *_SET 那种任意配置面)。
*
* status 是只读投影, 且刻意不含 ownerUserId —— 控制端只需要知道"哪台在用、
* 用的哪个 bot", 没有理由让 Telegram 用户 id 过网线。
*
* 老被控端不识别 → CHANNEL_NOT_ALLOWED, 控制端据此显示「该设备版本不支持」
* 而不是静默失败。
*/
export const DL_TELEGRAM_STATUS_CHANNEL = 'device-link:telegram:status';
export const DL_TELEGRAM_SET_ONLINE_CHANNEL = 'device-link:telegram:set-online';
/**
* 手机端语音词典学习回写 channel。
*
* 手机端只负责检测用户是否把一次 voice refine 结果改成了专有名词/术语修正;
* 词典 advisor 与写入仍在被控桌面执行,避免移动端维护一份会分叉的本地词典。
*/
export const DL_VOICE_DICTIONARY_LEARNING_CHANNEL = 'device-link:voice:dictionary-learning';
/**
* 手机端拉取被控桌面的语音词典快照(只读)。
*
* 桌面之间的词典靠 push 帧对等同步,手机不参与 CRDT 合并而只接收桌面主动推送的
* 只读投影;本 channel 保留作为旧版兼容和丢 push 时的主动刷新兜底。返回的是**只读投影**:
* 词条文本 + 频次 + 别名,外加一个
* 版本向量(`stateVector`)供手机判断多台电脑的快照谁包含谁。化身、墓碑、抑制项、
* 时钟都不外泄 —— 手机不参与合并,不持有可写状态,避免移动端词典分叉。
*
* 符合准入判据:不依赖 event.sender、无本机 UI 副作用、词典真相在被控端。
*
* invoke 仍属于 relay 的 CONTROL_KINDS,转发前会校验目标的 remoteControlEnabled;
* 因此新版本优先使用独立的只读 push 快照通道,即使桌面关闭「允许被控」也能查看词典。
* 本 channel 保留用于旧版桌面兼容和 push 丢失后的主动刷新,不能把 REMOTE_DISABLED
* 当成“真的没有词条”。
*/
export const DL_VOICE_DICTIONARY_GET_CHANNEL = 'device-link:voice:dictionary:get';
/**
* M3 核心集:远程会话全生命周期(新建/发消息/事件流/审批/中断/运行时切换)+ 基础读模型。
* M4 将扩展 scheduler / orca worker / rewind / usage 等完整控制面。
*/
const CORE_INVOKE_CHANNELS: readonly string[] = [
// —— 会话生命周期 ——
'maker:create-session',
'maker:close-session',
'maker:abort-session',
'maker:send',
// Task-bound official MCP App bridge. No credentials or arbitrary endpoint selection.
'maker:mcp-apps:v1',
DL_SESSION_HANDOFF_CHANNEL,
'maker:steer',
// 控制端输入框开始打字时,请被控端提前启动该任务的 Agent。被控端只对普通任务、
// 本机运行的 Agent 生效,限量并空闲回收;旧被控端 CHANNEL_NOT_ALLOWED → 控制端静默忽略。
'maker:session:prewarm',
'maker:list-active',
'maker:any-session-in-turn',
'maker:session-in-turn',
// Review evidence and the Reviewer session are created on the data-owning
// device. The handler remains host-owned; this only permits the explicit
// start request to cross the device-link tunnel.
'maker:review:start',
// —— 输入队列(input queue 全集,无本机副作用)——
DL_SESSION_REFERENCE_CAPABILITY_CHANNEL,
'maker:input:get-projection',
'maker:input:enqueue',
'maker:input:compact',
// 手动压缩(pi 原生 compact,capability-aware):上下文环 / 会话菜单对远程 pi 会话
// 隧道到被控端执行。业务 handler 无 sender / 本机 UI 副作用,真相在被控端。
// 长 LLM 摘要请求可能远超默认 30s → INVOKE_TIMEOUT_OVERRIDES_MS 覆盖(见下)。
'maker:compact-session',
'maker:input:steer',
'maker:input:stop',
'maker:input:resume',
'maker:images:retry',
'maker:input:retry-last-error',
'maker:input:clear-error',
'maker:input:cancel-usage-limit-wait',
'maker:input:remove',
'maker:input:update-text',
// 整条内容替换(文本+附件),手机端排队消息复用 composer 编辑;老被控端无 handler →
// CHANNEL_NOT_ALLOWED,控制端按「仅文本变化降级 update-text / 附件变化提示升级」处理。
'maker:input:update-content',
'maker:input:move',
'maker:input:set-expanded',
'maker:input:set-interaction-lock',
'maker:input:set-edit-lock',
'maker:input:clear-session',
// device-link:auth error 重试失败/放弃时控制端调此补落被控端 DB;被控端 main 执行无 sender 依赖。
'maker:persist-turn-error-deferred',
// —— 交互审批(permission / ask / plan)——
'maker:resolve-interaction',
// 打开/重连/刷新会话时拉当前挂起交互快照,重建可操作面板(只读)。
'maker:get-pending-interactions',
// —— 运行时切换 ——
'maker:set-model',
// 同一会话 Claude Code / Codex 切换采用 pending intent:写入口只登记意图,
// 只读入口供控制端重连后恢复 main 权威状态;两者都无 event.sender / 本机 UI 副作用。
'maker:switch-session-agent',
'maker:get-session-agent-switch-intent',
'maker:set-effort',
'maker:set-permission-mode',
'maker:set-fast-mode',
// Pi 本机模型思考开关。runtime-only,无 session 列;老被控端无 handler →
// CHANNEL_NOT_ALLOWED,控制端按 capabilities.thinkingToggle 隐藏入口。
'maker:set-thinking-enabled',
// 计划模式一级开关(runtime-only, 持久化经 dispatch persistRemoteSetting 回流)。
// 老被控端无 handler → CHANNEL_NOT_ALLOWED → 控制端 UI 本就按 capabilities.planMode 缺失隐藏入口。
'maker:set-plan-mode',
// 任务级工作上下文窗口档位(会话级设置, 无本机 shell/UI 副作用; 控制端 DB 是被控端那份,
// 写本机不生效)。被控端落库并应用到活实例。老被控端无 handler → CHANNEL_NOT_ALLOWED
// → 控制端提示「该设备版本不支持」并保留原档位。
'maker:set-context-window-budget',
// 任务级窗口边界的只读查询(路由默认/物理上限/该路由模型级上限):控制端打开远程档位
// 菜单时拉一次,才能给出「更大」的档位。无 event.sender / 无本机副作用,不写任何存储。
// 老被控端无 handler → CHANNEL_NOT_ALLOWED → 控制端退回「只允许收紧」。
'maker:get-context-window-bounds',
'maker:set-extra-dirs',
'maker:set-writable-dirs',
// Pi 原生分支树:只读快照 + 当前会话内导航。导航业务 handler 在被控端原子同步
// SDK leaf 与 SQLite 可见时间线,不依赖 sender/窗口,真相也只在被控端。
'maker:get-session-tree',
'maker:navigate-session-tree',
// 会话「非选中模型」effort/fast 写穿(控制端 → 被控端):控制端纯显示,改非选中行的预设记忆时
// 通知被控端,被控端调它原来的本地 setter(setSessionModelEffort/Fast)写真实存储。选中模型仍走
// maker:set-model/effort/fast-mode + sessions:patched,不经此 channel。被控端转发给自身 renderer
// 执行(无 sender 依赖、无本机副作用)。老被控端无 handler → CHANNEL_NOT_ALLOWED → 控制端吞掉降级。
'maker:set-session-model-pref',
// —— 能力查询 ——
'maker:get-capabilities',
'maker:list-available-agents',
// device-link 远程草稿镜像(只读):控制端为被控设备新建项目草稿时,读被控端**当前 New Maker
// 草稿**在该 vendor 的完整选择(model/effort/fast/permission/source),1:1 seed 控制端草稿。
// 数据真相在被控端(其 renderer 草稿),无 sender 依赖、无本机副作用 → 准入。老被控端无此 handler
// → 控制端收 CHANNEL_NOT_ALLOWED → 回退被控端 capabilities 默认。
'maker:get-new-maker-defaults',
'maker:model-favorites:get',
'maker:model-favorites:apply',
// device-link 草稿「每个模型 effort/fast」写穿(控制端 → 被控端):控制端在远程项目草稿里改
// 选中 / 非选中模型的 effort/fast 时通知被控端,被控端调它原来的本地 setter(setEffortForModel /
// setFastModeForModel)写真实草稿;被控端 newMakerDraft 变更自动经既有 maker:sync-new-maker-draft
// re-mirror 回 main 并广播。被控端转发给自身 renderer 执行(无 sender 依赖、无本机副作用)。
// 老被控端无 handler → CHANNEL_NOT_ALLOWED → 控制端吞掉,退回一次性 pull 行为。
'maker:apply-new-maker-draft-pref',
// device-link 草稿「新建会话默认启用 worktree」写穿(控制端 → 被控端):worktree 勾选记忆是
// 被控端 newMakerDraft 的 vendor 无关根字段,「这台工作端新建会话是否默认进 worktree」的真相
// 在被控端。被控端 handler 校验布尔后转发给自身 renderer 写真实草稿(无 sender 依赖、无本机
// UI 副作用);回读经 maker:get-new-maker-defaults + NEW_MAKER_DRAFT_CHANGED 回流。
// 老被控端无 handler → CHANNEL_NOT_ALLOWED → 控制端吞掉降级(勾选仅本次草稿生效)。
'maker:apply-new-maker-worktree-pref',
// device-link 新建 worktree 源分支镜像:branch 选择属于被控端 canonical baseRepo,
// 控制端先按 repo 拉取、显式选择时写穿,被控端返回/广播带 revision 的权威 snapshot。
// GET 只读 main 内存镜像;APPLY 只更新该 repo 的 future-session 偏好,不执行 git/fs。
'maker:get-new-maker-worktree-branch-pref',
'maker:apply-new-maker-worktree-branch-pref',
// 被控端侧栏项目顺序(显示偏好,真相在被控端 Main)。GET 只读;APPLY 写被控端
// owner 作用域快照。不用 `:set` 后缀(全局设置写禁模式)。老被控端无 handler
// → CHANNEL_NOT_ALLOWED → 控制端吞掉,回退本机/按时间。
'sidebar-settings:get-project-order',
'sidebar-settings:apply-project-order',
// Host-owned project names are read-only on controllers. Local overrides and write channels stay local.
'sidebar-settings:get-project-aliases',
// 模型供应商目录(只读):远程会话的模型选择器据此 1:1 镜像被控端的「供应商+模型」结构。
// 被控端 dispatch 在返回前剥离 routing 等执行字段(见 device-link/dispatch.ts),只回显示用字段。
'maker:provider:list',
// 供应商分享(只读):被控电脑收到的、别人分享给它的供应商目录(经被控电脑代读,手机读不到
// 另一个账号的电脑)。只回显示用字段,供手机模型列表的远程供应商区域使用。
'maker:provider-share:received-catalogs', // PROVIDER_SHARE_RECEIVED_CATALOGS_CHANNEL
// Git safety 设置(只读):远程 Codex Rewind 入口必须按被控端是否会创建 safety snapshot
// 决定显隐。SET/RESET 不放行,控制端不能改被控端全局偏好。
'maker:git-safety:get',
// 会话标题旁的 Git / GitHub 上下文(分支、PR 引用与实时状态)必须在被控端查询,
// 因为控制端本地没有远端 session 的 DB、工作目录或 gh 登录态。
'git-context:get-for-session',
'git-context:pr-refs:list',
'git-context:pr-status',
// —— 通用远程资源面——
// 固定的 manifest / list / get / invoke 入口。业务模块只在被控端 provider
// registry 注册资源与动作,后续新增模块或动作不再扩张 device-link channel 表。
...REMOTE_RESOURCE_CHANNELS,
// —— 读模型(被控端本地 DB 是数据真相)——
'local-db:sessions:list',
'local-db:task-tags:execute',
'local-db:sessions:get',
// Bounded metadata reconciliation. Old hosts reject this; controllers fall back to GET.
'local-db:sessions:get-many',
// Read-only indexed task search for the remote Composer @ palette and the
// controller sidebar task search. Older controlled clients reject this
// channel and the controller falls back to the bounded legacy sessions:list
// projection.
'local-db:conversations:search',
DL_HISTORY_MESSAGES_CHANNEL,
DL_HISTORY_QUERY_CHANNEL,
'local-db:messages:list',
// Read-only visible history and recoverable work ranges; same session authorization as list.
'local-db:messages:view',
'local-db:messages:work-details',
'local-db:messages:view-intent',
// 会话内搜索跳转定位(loadAroundMessage):只读,与 messages:list 同安全级。
'local-db:messages:around',
// 以 message clientId 定位上下文,供移动端轻量跳转 / fork 来源定位;只读,与 messages:around 同安全级。
'local-db:messages:around-client-id',
// 订阅形态会话「本会话价值」历史汇总(assistant agent_meta 估算值求和):只读聚合,
// 无 sender 依赖、无副作用,与 messages:list 同安全级。控制端底部 $ chip 的历史初值
// 必须查被控端(查本机是空库恒 0);老被控端无此 channel → CHANNEL_NOT_ALLOWED →
// 控制端吞错,仅靠已加载消息 + 实时 turn-cost 推送呈现部分值。
'local-db:messages:estimatedSessionValue',
'local-db:recent-workdirs:list',
// Host-owned project display names. No remote mutation of viewer preferences.
'local-db:project-aliases:list',
// 窄口径写:从被控端「最近项目」列表移除一条(专用 handler,path 归一后按主键删,
// 幂等,不动 sessions / 磁盘)。控制端项目选择器的删除入口与本机语义对等;
// 老被控端无此 handler → CHANNEL_NOT_ALLOWED → 控制端隐藏/忽略删除能力即可。
'local-db:recent-workdirs:remove',
// 窄口径元数据写:仅 status / title / pinnedAt(归档/删除/恢复/重命名/置顶)。专用
// handler、白名单字段、不是裸 update(update 写任意字段、不放行)。支撑远程删/归档/改名/置顶对等。
'local-db:sessions:patch-meta',
// 只读:「疑似中断」(startedAt > endedAt)的 active 会话 id(错误红点数据源)。
// 与 sessions:list 同安全级。
'local-db:sessions:interrupted-pending',
// 窄口径写:中断提示的「继续/忽略」—— 仅写 sessions.last_turn_ended_at = now
// (专用 handler,单字段幂等,不是裸 update)。远程会话的确认必须落被控端 DB,
// 否则重开会话提示复活。老被控端无此 handler → CHANNEL_NOT_ALLOWED → 控制端
// 吞错退化为本视图内存隐藏。
'local-db:sessions:ack-interrupted',
// 窄口径写:error-tail-banner 的「关闭/忽略」——仅把 role='error' 行的 content
// merge dismissed:true(handler 内校验 role,原字段保留,不是裸 updateContent,
// updateContent 本身不放行)。远程会话的忽略必须落被控端 DB,否则重连/重拉后
// 红条复活。老被控端无此 handler → CHANNEL_NOT_ALLOWED → 控制端吞错退化为
// 本视图内存隐藏。
'local-db:messages:dismiss-error',
// 消息菜单单条内容删除:在被控端清旧原生上下文并写 context rebuild handoff。
'maker:message:delete',
// 订阅控制帧(push 驱动):被控端 dispatch 拦截执行,不落到 ipcMain handler。
// 列入 allowlist 作契约登记 + 老被控端不识别时回 CHANNEL_NOT_ALLOWED 供控制端探测能力(回退 poll)。
DL_SUBSCRIBE_CHANNEL,
DL_UNSUBSCRIBE_CHANNEL,
// 入方向媒体取件(被控端 dispatch 拦截执行,不落 ipcMain handler;契约登记 + 能力探测)。
DL_MEDIA_FETCH_CHANNEL,
FILE_PEER_CHANNEL,
TASK_MIGRATION_CHANNEL,
// 远程 Agent(被控端 dispatch 拦截执行,不落 ipcMain handler):在被控端用它自己的登录与
// 供应商运行 Agent,文件、命令与 Cindy 工具回到控制端执行。准入同 fs:list-dir 的论证:
// 同账号 + 被控端显式打开远程控制时,控制端本就能驱动被控端的 Agent;不进共享任务白名单。
REMOTE_AGENT_CHANNEL,
// 供应商组(被控端 dispatch 拦截执行,不落 ipcMain handler):同账号电脑问组所在电脑该用组里哪台、
// 报告运行中的任务与需要冷却的电脑。只给同账号,分享受邀者与共享任务访客在 dispatch 再拒一次。
PROVIDER_GROUP_REMOTE_CHANNEL,
// 出方向语音转写(被控端 dispatch 拦截执行,不落 ipcMain handler;复用被控端 ASR 配置)。
DL_VOICE_TRANSCRIBE_CHANNEL,
// 临时 voice credential 同步(被控端 dispatch 拦截执行,不落 ipcMain handler;禁止泛化)。
DL_VOICE_CREDENTIAL_SYNC_CHANNEL,
// voice dictionary learning evidence 回写(被控端 dispatch 拦截执行,不落 ipcMain handler)。
DL_VOICE_DICTIONARY_LEARNING_CHANNEL,
// 手机拉取被控桌面的词典只读快照(被控端 dispatch 拦截执行,不落 ipcMain handler;
// 老被控端不识别时回 CHANNEL_NOT_ALLOWED,手机据此回退到「无词典」而不是报错)。
DL_VOICE_DICTIONARY_GET_CHANNEL,
];
/**
* M4 扩展集:完整控制面。scheduler / orca worker / rewind·fork / usage /
* memory 读 / 命令与技能列举 / 路径解析。仍恪守准入判据(无 event.sender 依赖、
* 无本机 UI/shell 副作用、语义在被控端执行才正确)。
*/
const EXTENDED_INVOKE_CHANNELS: readonly string[] = [
// —— Scheduler(读 + 改 schedule 都在被控端执行才有意义)——
'maker:schedule:list',
'maker:schedule:get',
'maker:schedule:create',
'maker:schedule:update',
'maker:schedule:delete',
'maker:schedule:pause',
'maker:schedule:resume',
'maker:schedule:run-now',
'maker:schedule:list-runs',
'maker:schedule:list-sidebar-index-runs',
'maker:schedule:list-cost-summaries',
'maker:schedule:delete-run',
'maker:schedule:get-runtime-state',
'maker:schedule:get-inflight-count',
'maker:schedule:get-unread-count',
'maker:schedule:mark-run-read',
'maker:schedule:mark-all-runs-read',
'maker:schedule:mark-schedule-runs-read',
'maker:schedule:list-templates',
'maker:schedule:create-from-template',
// script 任务能力选择器的可用性探测:纯只读查询,意识状态在被控端才有意义
'maker:schedule:script-capability-status',
// —— 会话未读已读回执(控制端真实展示会话内容后,把被控端的会话未读态清掉)——
// 准入:会话粒度状态操作(与 mark-run-read 同类),无 event.sender 依赖、无 shell/UI
// 副作用;语义在被控端执行才正确(灵动岛 / Dock 角标 / 侧栏红绿点的未读真相都在被控端
// main)。老被控端无此 channel → CHANNEL_NOT_ALLOWED → 控制端吞掉降级(仅本地清点)。
'notification:clear-session-attention',
// Completed-card action, guarded by an owner-issued token before any mutation.
// Old hosts reject this channel; callers must not fall back to unguarded writes.
'agent-island:completion-action',
// —— Project automation ——
'maker:project-automation:reconcile',
'maker:project-automation:list-consents',
'maker:project-automation:revoke-consent',
'maker:project-automation:upsert-schedule',
'maker:project-automation:remove-schedule',
// —— Orca 协同(Lead 控多 Worker;在被控端进程内编排)——
'maker:worker:create',
'maker:worker:dispatch-ui-assignment',
'maker:worker:list',
'maker:worker:switch-focus',
'maker:worker:idle',
'maker:worker:acknowledge-done',
'maker:worker:archive',
'maker:worker:update',
'maker:team:end',
'maker:session:enable-orca',
'maker:session:disable-orca',
'maker:mark-orca-role',
'maker:collaboration-settings:get',
'local-db:orca-workflows:get-by-lead',
'local-db:orca-workflows:get-by-worker-session',
'local-db:orca-workflows:list-workers-by-lead',
// 协同远端 Worker:本机作为运行设备,承接另一台电脑上 Lead 派来的 Worker 任务。
// 准入同 maker:create-session:同账号 + 本机开启远程控制时控制端本就能在这里建任务;
// 业务 handler 不依赖 sender、无本机 UI 副作用;来源电脑取 server 盖章的 src。
// 老版本无 handler → CHANNEL_NOT_ALLOWED,控制端提示更新而不回退普通建任务。
ORCA_REMOTE_WORKER_CAPS_CHANNEL,
ORCA_REMOTE_WORKER_BRIDGE_CHANNEL,
ORCA_REMOTE_WORKER_MODELS_CHANNEL,
ORCA_REMOTE_WORKER_OPEN_CHANNEL,
ORCA_REMOTE_WORKER_RELEASE_CHANNEL,
// 远程控制 Lead 所在电脑时,读取那台视角下可选的运行设备(只读,真相在被控端)。
ORCA_EXECUTION_DEVICES_CHANNEL,
// 云端伙伴:交出伙伴前探测目标电脑是否支持接手(只读常量,无 sender 依赖、无本机 UI 副作用)。
// 老版本无 handler → CHANNEL_NOT_ALLOWED,交出方拒绝该目标。
COMPANION_CLOUD_CAPS_CHANNEL,
// 云端伙伴:在任一台电脑上更换伙伴的主力电脑。只读读取主力电脑视角的可接手电脑,以及请主力电脑
// 交出伙伴(写)。准入同本机伙伴设置的「主力电脑」一行:同账号 + 主力电脑开启远程控制时控制端本就
// 能远程改这个伙伴;交出走被控端同一业务流程(同步、忙碌检查、比较后改主力电脑),handler 不依赖
// sender、无本机 UI 副作用。仅同账号远控,不进 sharedTask 访客白名单。老版本无 handler →
// CHANNEL_NOT_ALLOWED;控制端按 caps 版本隐藏入口。
COMPANION_CLOUD_TARGETS_CHANNEL,
COMPANION_CLOUD_HAND_OVER_CHANNEL,
// 云端伙伴:请保留的那个 Cindy 所在电脑合并其他 Cindy(写;同账号远控,准入同上,业务 handler 只在
// 本机运行保留的那个 Cindy 时执行)。合并前请各来源 Cindy 的主力电脑先同步(写,只上传、不改主力电脑)。
COMPANION_CLOUD_MERGE_CHANNEL,
COMPANION_CLOUD_FLUSH_CHANNEL,
// —— Rewind / Fork / Title / Context ——
'maker:rewind:preview',
'maker:rewind:commit',
// Shared action via dispatch injection; local IPC retains its trusted-renderer guard.
'maker:turn-change-set:apply',
'maker:fork',
// Independent history branch on the task's host; same authority as fork.
'maker:side-chat:v1',
'maker:side-chat:list:v1',
'maker:fork-strip-encrypted',
'maker:generate-title',
// 重命名输入框 Magic 按钮:被控端读自己 DB 里的最新对话素材、用自己的 provider 凭证
// 重生成标题(与 generate-title 同一 oneShot 通道)。老被控端无此 channel →
// CHANNEL_NOT_ALLOWED → 控制端按生成失败提示。
'maker:regenerate-title',
// 输入框推荐提示词:在被控端读取会话素材并使用被控端模型凭证生成。
'maker:predict-prompt',
'maker:get-context-usage',
// workflow 逐 agent 进度树(只读):handler 纯 fs 读 Claude Code workflow 记录文件,
// 无 event.sender 依赖、无副作用;记录文件真相在被控端 HOME(控制端本机读必落空)。
// 老被控端无此 channel → CHANNEL_NOT_ALLOWED → 控制端降级为无数据(回退 workflow 级
// 卡片)。不进 INVOKE_TIMEOUT_OVERRIDES_MS:读小 JSON,默认 30s 足够。
'maker:get-workflow-progress',
// 后台命令输出尾部(只读):入参 (sessionId, taskId),handler 按被控端活跃会话的
// 后台任务登记解析 SDK `.output` 路径并只读末尾一段,控制端无法指定路径;
// 无 event.sender 依赖、无副作用;输出文件真相在被控端(控制端本机读必落空)。
// 老被控端无此 channel → CHANNEL_NOT_ALLOWED → 控制端不显示「最近输出」。
'maker:background-task:output-tail',
// 会话仍在运行的后台任务快照(只读):handler 只查活跃会话内存句柄的任务列表,
// 无 event.sender 依赖、无副作用;任务真身在被控端(控制端 main 无该会话 handle,
// 本机查必空)。后台任务面板挂载水合用。老被控端无此 channel → CHANNEL_NOT_ALLOWED
// → 控制端降级空表(面板退化为事件流 + 消息扫描两源)。
'maker:session-background-tasks:list',
'maker:session-background-activity',
// 后台任务停止(写):单个任务精确停止 / 会话级「全部停止」。handler 只按 sessionId
// (+ taskId)操作被控端活跃会话,无 event.sender 依赖、无本机 UI 副作用;任务真身在
// 被控端,控制端本机调用只会假成功。仅同账号远控,不进 sharedTask 访客白名单。
// 老被控端无此 channel → CHANNEL_NOT_ALLOWED → 控制端提示升级被控端。
'maker:agent-task:stop',
'maker:session-background-tasks:stop',
// Durable PI Subagent truth and process handles live on the data-owning device.
// Reads and exact controls must execute there; the controller must never fall
// back to its own pi-agent-home for a remote task.
'local-db:subagent-runs:list',
'local-db:subagent-runs:detail',
'local-db:subagent-runs:transcript',
'maker:pi-subagent:control',
// —— Goal(目标模式;goal 状态机在被控端 GoalController 执行才有意义)——
'maker:goal:set',
'maker:goal:clear',
'maker:goal:get-status',
'maker:goal:pause',
'maker:goal:resume',
'maker:goal:update',
// —— Agent 状态 / 用量(只读)——
'maker:agent:status',
'maker:agent:binary-version',
'maker:auth:get-state',
'maker:usage:today',
'maker:usage:account',
// Codex app-server 官方控制面:额度/reset 次数读取 + 经 desktop 账号绑定 offer 的
// 人工 reset。mutation 不接收 creditId,不能泛化成任意账号/凭证控制入口。
'maker:usage:codex-rate-limits',
'maker:usage:codex-rate-limit-reset',
'maker:usage:codex-reset-auto-use',
// Claude 订阅账号余量快照(只读,cached-first):控制端远程会话状态栏 chip 显示
// 被控端订阅的 5h/周/分模型窗口剩余(数据真相在被控端 —— turn 在被控端消耗其
// 订阅额度)。快照只含利用率百分比、reset 时间与账号归属指纹(单向 scrypt 哈希,
// 与本机 renderer 收到的广播 payload 同形),不含凭证材料。无 sender 依赖、无副
// 作用;老被控端无此 channel → CHANNEL_NOT_ALLOWED → 控制端降级为原「仅会话
// 金额」占位显示。
'maker:usage:claude-subscription',
// xAI(SuperGrok)订阅周用量快照(只读):与 claude-subscription 同定位。该 channel
// 的 ipcMain handler 挂了 assertTrustedSender(合成 event 必然不可信,那道闸不为
// 远程放宽)—— 与 device-link:telegram:* 同先例,由被控端 dispatch 在通用 dispatch
// 前拦截、直读 usage reader,不进 ipcMain。列入 allowlist 作契约登记 + 老被控端
// CHANNEL_NOT_ALLOWED 供控制端探测降级。
'maker:usage:xai-subscription',
// cc 默认路由会话的生效计费路由观察值(只读,'gateway' | 'subscription' | null):
// 控制端远程会话据此判定订阅 / 网关显示形态 —— 路由真值在被控端 proxy 的按请求
// 观察 registry 里,控制端拿本机凭证状态重算必然张冠李戴。入参 sessionId,无
// sender 依赖、无副作用;老被控端 CHANNEL_NOT_ALLOWED → 控制端对默认路由远程
// 会话维持「仅会话金额」占位(与旧行为一致)。
'maker:claude-session-route:get',
// 模型单价表(只读,main 侧 Model Access model-groups 投影缓存):控制端模型选择器展示
// 被控端视角的单价(与被控端桌面 tooltip 同源)。无 sender 依赖、无副作用;老被控端无此 channel
// → CHANNEL_NOT_ALLOWED → 控制端隐藏价格(与桌面「无价不显示」口径一致)。
'maker:usage:model-pricing',
// 用量历史跨设备合并(只读):同账号另一台电脑读取被控端 daily_spend / daily_model_usage
// 原始行,合并进它自己的「所有设备」用量历史。数据真相在被控端;只含按天 × 模型聚合的
// token 与金额,不含会话、消息或凭证。入参仅可选 sinceDay(YYYY-MM-DD),无 sender 依赖、
// 无副作用;响应 gzip 编码,超帧预算回结构化 oversize。老被控端无此 channel →
// CHANNEL_NOT_ALLOWED → 控制端把该设备标为「版本过旧」,不影响其它设备。
'maker:usage:device-rows',
// 网关 API key **presence-only** 探测:只回 { present: boolean },不回、也永不扩展为读取
// 密钥材料 —— 这是「账号与密钥永不放行」大类下的窄口径例外(同 DL_VOICE_CREDENTIAL_SYNC
// 的例外定位,禁止泛化)。用途:控制端模型选择器判断折扣版(codex/)是否该置灰,判定依据
// 在被控端(key 存被控端 safeStorage、请求也从被控端发)。老被控端无此 channel →
// CHANNEL_NOT_ALLOWED → 控制端按 unknown 处理(不置灰)。
'maker:api-key:present',
// —— Memory 读(写全局设置不放行)——
// Teammate directory: handlers explicitly recognize the authorized device-link
// context and return only identity/status/canonical task, without local paths,
// memory, prompts, configuration, or native UI/file mutations.
'local-db:bots:list',
'local-db:bots:get',
// 伙伴自主跟进的工作台「一眼」:只读宿主内存状态表的投影(任务标题、等你的一句话摘要、
// 分钟数、设备名),不含工作目录、提示词、工具入参或代输入值;handler 只放远程可见的伙伴。
// 放行标准:① 只读 ② 同账号已授权控制端本就能经 maker:list-active / sessions:get-many 看到
// 同样的任务标题与状态 ③ 没有任何写入或本机特权动作。设置读写(settings-*)不放行。
'local-db:bots:autonomy:glance',
// Same-account opted-in controllers may inspect and stop a companion's own
// child task and read a participant-checked private thread. No profile mutation.
'maker:bot-delegations:list',
'maker:bot-delegation:cancel',
'maker:bot-direct-message-thread:get',
'maker:memory:get',
'maker:memory:get-settings',
// —— 命令 / 技能 / at 资源 列举(只读)——
'maker:list-desktop-commands',
'maker:list-agent-commands',
'maker:list-agent-skills',
'maker:list-customizations',
'maker:scan-at-resources',
// —— 插件列表(只读)——
// Public composer metadata only; no paths, secrets, lifecycle writes or shared guests.
'ghosts:composer-list',
'maker:plugins:list',
// 单个插件的启停状态(只读)。与 maker:plugins:list 同类,差别只在它不跳过
// HOSTED_ELSEWHERE 插件、且按 id 精确查。准入三条:handler 只读 settings + 项目
// `.cindy/plugins.json`,不依赖 event.sender、无 UI/shell 副作用;插件启停真相在
// 被控端(控制端拿被控端的路径查自己本机只会读到自己的用户级开关,判定可能与被控端
// main 的 assertCollabProjectEnabled 相反 —— issue #1170 的「入口能点但走不完」)。
// 用途:device-link 项目的协同入口按被控端的项目级 collab 开关置灰。老被控端无此
// channel → CHANNEL_NOT_ALLOWED → 控制端 fail-closed 置灰并提示设备版本过旧。
'maker:plugins:get-state',
// —— 路径解析(被控端解析语义正确;新建会话选目录用)——
'fs:resolve-path',
'fs:resolve-path-batch',
// —— 本机目录浏览(「添加远程项目」逐级选被控端项目目录用)——
// 准入:只读目录枚举 + mkdir -p,**无**文件写/删/exec;且 device-link 已是同账号 +
// remoteControlEnabled 显式 opt-in,控制端本就能在 workingDir 跑 agent(可执行任意命令),
// 故列目录/建目录落在既有信任域内,不扩大攻击面。见 apps/desktop/src/main/fsBrowse/ipc.ts。
'fs:list-dir',
'fs:stat-path',
'fs:mkdir-p',
// —— 远程文件浏览(右侧栏 / doc 模式,读写增删 + 文件名索引 + 非流式搜索)——
// 单聚合 channel:被控端专用 handler(见 apps/desktop/src/main/file-browser/device-op.ts),
// 不复用依赖 event.sender 的既有 file-browser handler。准入:
// - workdir 参数先实时探测被控端本地可访问性,再结合 SSH session 归属解析
// 唯一执行端点;本地 / SSH 或多 SSH 歧义时 fail closed。路径穿越在
// scanner 层拦(assertInsideWorkdir + realpath)。
// - device-link 已是同账号 + remoteControlEnabled 显式 opt-in,控制端本就能在
// workingDir 跑 agent(任意读写/exec),文件浏览不扩大攻击面(fs:list-dir 同款论证)。
// - readFile 结果超帧限前被控端预判回结构化 oversize,不裸炸 FRAME_TOO_LARGE。
// - 老被控端无此 channel → CHANNEL_NOT_ALLOWED,控制端渲染"设备版本过旧"占位。
'file-browser:remote-op',
// —— 远程 git 审查(右侧栏审查面板,只读)——
// 单聚合 channel:被控端专用 handler(见 apps/desktop/src/main/git-review/device-op.ts),
// 不复用本机 renderer 的 git-review:* handler。准入:
// - 只读 git 数据(status / diff / commit 列表 / 文件 diff / 图片与 Markdown 预览),
// **不放行任何写 op**(stage / discard / commit / push 不在被控端 handler 实现)。
// - 入参只有 sessionId + 结构化查询字段,不接受任何客户端路径:workdir 一律由被控端
// resolveReviewScope 从它自己的 session 记录解析,路径越界在 fsPathGuard 层拦。
// - device-link 已是同账号 + remoteControlEnabled 显式 opt-in,控制端本就能在
// workingDir 跑 agent(任意读/exec),只读 git 数据不扩大攻击面(fs:list-dir 同款论证)。
// - 响应超帧限前被控端预判:先 gzip,仍超回结构化 OVERSIZE,不裸炸 FRAME_TOO_LARGE。
// - 老被控端无此 channel → CHANNEL_NOT_ALLOWED,控制端渲染"设备版本过旧"占位。
'git-review:remote-op',
// —— 窄口径文本预览(消息附件 / tool 文件引用只读查看)——
// 不是裸文件读:handler 要求绝对路径,复用系统目录 blocklist,10MB 上限,
// 并用 reason 明确 oversize / not_found / forbidden。见 bootstrap-electron text-file:read-preview。
'text-file:read-preview',
// —— /learn 远程(learn-host 全流程在被控端:证据查它自己的 DB、staging 在它的
// userData、skill 落它的 ~/.agents/skills;语义在被控端执行才正确)——
// learn:apply 写被控端 skill 目录的越权论证:提案由被控端 staging 校验 + redaction
// 双程扫描后生成,且 device-link 已是同账号 + remoteControlEnabled 显式 opt-in,
// 控制端本就能经 agent 会话在被控端写文件,不扩大攻击面。入参只有 runId / 结构化
// 请求体,不接受任何客户端路径(staging 路径全部由被控端生成)。
'learn:start',
'learn:list-runs',
'learn:get-proposal-diff',
'learn:apply',
'learn:discard',
'learn:cancel',
// —— /cmd 远程(远程会话的 shell 命令在被控端 workingDir 执行才是正确语义)——
// handler 对 cwd 走 remote-workdir-guard 实时可访问性探测,
// 准入论证同 fs:list-dir:同账号 + 显式 opt-in 下控制端本就能驱动 agent 执行任意命令。
'desktop-cmd:run',
// —— Worktree(为被控端项目预建独立 git worktree;git/fs 语义在被控端执行才正确——
// 控制端本机 git 探测被控端路径必然误报"不是 git 仓库")——
// 准入:detect-cwd / list-branches / suggest-name 是只读 git 探测,无写副作用;
// create 只在 baseRepo/.cindy-worktrees/<name> 下派生新目录(name 经被控端
// validateWorktreeName 白名单校验,不接受任意路径),且 baseRepo 在被控端 dispatch
// 层过 remote-workdir-guard 同款收敛(见 dispatch.ts PATH_GUARDED)。device-link
// 已是同账号 + remoteControlEnabled 显式 opt-in,控制端本就能在项目目录跑 agent
// (任意 exec),不扩大攻击面。removal-preview 只读、用于删除前警告;通用删除路径仍不放行。
// discard-precreated 是唯一窄删除例外:常规收 sessionId + create 回包的精确 path;
// 若手机在 create 回包前退出,则收其在 create 前已持久化、并与被控端 worktree
// 元数据精确匹配的随机 recoveryKey。两路都重新核对 store 归属、无 DB/live
// session、无 dirty/keep/live-ref 后才删;recoveryKey create/discard 另按 sessionId
// 串行,且本口与 maker:create-session 共用 session 锁,专门补偿两步创建的失败窗口。
// 老被控端无这些 channel → CHANNEL_NOT_ALLOWED → 控制端按对应能力降级。
'worktree:detect-cwd',
'worktree:list-branches',
// Sync status is local-only; sync mutates only by explicit fetch + fast-forward.
// sync-branch baseRepo also passes dispatch PATH_GUARDED_CHANNELS.
'worktree:branch-sync-status',
'worktree:sync-branch',
'worktree:suggest-name',
'worktree:create',
'worktree:discard-precreated',
'worktree:cancel-precreated',
'worktree:removal-preview',
// —— 个人 Telegram bot 跨设备上下线(准入论证见上方 DL_TELEGRAM_* 常量注释)——
// 两条都由被控端 dispatch 拦截执行, 不是 ipcMain handler。
DL_TELEGRAM_STATUS_CHANNEL,
DL_TELEGRAM_SET_ONLINE_CHANNEL,
];
/**
* Session-scoped input mutations that must be re-authorized by the controlled
* Desktop before dispatch. Review tasks are visible over device-link but are
* host-owned audit runs, so none of these channels may inject or mutate input.
*/
export const REMOTE_REVIEW_EXTERNAL_INPUT_CHANNELS: ReadonlySet<string> = new Set([
'maker:send',
'maker:steer',
'maker:input:enqueue',
'maker:input:compact',
'maker:input:steer',
'maker:input:stop',
'maker:input:resume',
'maker:input:retry-last-error',
'maker:input:clear-error',
'maker:input:cancel-usage-limit-wait',
'maker:input:remove',
'maker:input:update-text',
'maker:input:update-content',
'maker:input:move',
'maker:input:set-expanded',
'maker:input:set-interaction-lock',
'maker:input:set-edit-lock',
'maker:input:clear-session',
]);
/** 远程可调用的 invoke channel 全集(被控端 dispatch 前的权威校验依据) */
export const REMOTE_INVOKE_ALLOWLIST: ReadonlySet<string> = new Set([
// Same-account owner controls only; guest task dispatch has its own deny-by-default gate.
'maker:shared-task',
// Dedicated Host-only OAuth transaction. Args/replies are never forwarded to Renderer.
'device-link:plugin-oauth:v3',
'device-link:remote-desktop:v1',
...CORE_INVOKE_CHANNELS,
...EXTENDED_INVOKE_CHANNELS,
]);
/**
* 被控端 → 控制端的广播转发白名单:本机 broadcastToAllWindows 时,
* 命中这些 channel 的事件才会经 link 转发给控制端。
*/
export const PUSH_FORWARD_ALLOWLIST: ReadonlySet<string> = new Set([
'maker:bot-delegation:changed',
// 伙伴自主跟进状态变化(payload 只有 { botIds? },节流 ≤1 次/秒),控制端据此重读「一眼」。
'maker:bot-autonomy:changed',
'maker:bot-direct-message:changed',
// maker-ipc MAKER_PUSH
'maker:event',
'maker:history-view-changed',
// Running work item replacement for controllers whose latest view read asked for work lines.
'maker:history-work-patch',
// Device-level runtime Agent roster changes; controllers refresh their local availability cache.
'maker:agents:changed',
// Host-owned resource provider 的通用失效通知;payload 只含 collection/ref/revision。
REMOTE_RESOURCE_CHANGED_CHANNEL,
'maker:status-changed',
'maker:input:projection',
'maker:interaction-request',
'maker:interaction-dismissed',
// Claude Auto classifier 故障后降级到 ask;payload 带 sessionId,控制端显示同款提示。
'maker:auto-permission:fallback',
// Deferred model-provider outcome. Both payloads contain only task identity
// and selected route or a bounded failure code; no native error text.
'maker:session-credential-switch-applied',
'maker:session-credential-switch-failed',
// 被控端 active-catalog revision 变化:控制端按 deviceId 驱逐并重拉 provider 目录。
'maker:provider:changed',
// 注:maker:auth:state-changed 曾在此 —— 但发射点不 tap、控制端也不消费(被控端 agent 鉴权
// 状态推给控制端语义存疑),是死条目,已移除避免误导。真要转发需先想清控制端如何路由。
'maker:schedule:event',
'maker:project-automation:event',
'maker:orca:worker-changed',
// goal 状态变化(payload 顶层 sessionId → 路由到 session:<id> topic,打开该会话的控制端可见)
'maker:goal:status-changed',
// Bounded historical-turn summary only; full patches are fetched through git-review:remote-op.
'maker:turn-change-set:updated',
'usage:message-turn-cost',
// 本轮模型降级标记(payload 顶层 sessionId → 默认路由到 session:<id> topic):
// 控制端把 agent_meta.modelMismatch 实时 patch 进已打开的远程会话消息流。
'usage:message-model-mismatch',
// session 终身累计 cost / token(topics.ts 归入 sessions topic:列表订阅常开,会话
// 未打开也保持镜像新鲜):被控端 sessionSpendBroadcaster 走裸 UPDATE 落库、不发
// sessions:patched,控制端远程会话底部 $ chip 依赖这两条把累计值镜像成被控端真相。
'usage:session-spend-changed',
'usage:session-tokens-changed',
// Claude 订阅账号余量变化(账号级,无 sessionId → topics.ts 归入 sessions topic):
// 控制端远程会话 chip 据此实时镜像被控端订阅窗口剩余。推送频率有上限:被控端
// headers 观察器按 (5h,7d,status) 签名去抖、端点刷新 180s 节流,只有数值变化才
// 广播,不随 turn 内逐请求刷帧。
'usage:claude-subscription-changed',
// Codex 账号订阅用量变化(账号级组合 payload:app-server 桶表 + WHAM web 槽):
// 控制端远程 codex / chatgpt-bridge 会话 chip 镜像被控端限额窗口。频率上限:
// app-server 每 turn 记录一次、WHAM 后台刷新 10s 节流。
'usage:codex-account-changed',
// Same provider-scoped payloads consumed by the local usage hooks.
'usage:codex-provider-account-changed',
'usage:subscription-provider-account-changed',
// Claude 网关配额变化(LiteLLM 月度/今日,账号级):控制端远程网关形态会话 chip
// 镜像被控端 daily/monthly。被控端刷新自带 10s 节流 + turn-done 触发。
'usage:claude-account-changed',
// xAI 订阅周用量变化(账号级):同上定位;被控端周用量刷新低频。
'usage:xai-subscription-changed',
// xAI 限流头快照(账号级,纯内存瞬时值):tooltip 尽力显示;bridge 每成功请求
// 至多一帧,xai/ 会话低频。
'usage:xai-rate-limit-changed',
// 独立 xAI 账号的限流头({ providerId, snapshot }):与 codex-provider 同口径按账号分路。
'usage:xai-provider-rate-limit-changed',
// cc 默认路由会话路由观察值变化(payload 顶层 sessionId → session:<id> topic,
// 打开该会话的控制端可见;每会话生命周期通常仅一次)。
'maker:claude-session-route-changed',
// local-db 推送(读模型增量)
'local-db:sessions:created',
'local-db:task-tags:changed',
'local-db:sessions:patched',
SESSION_ACTIVITY_CHANNEL,
SESSION_SYNC_CHANNEL,
'local-db:messages:created',
'local-db:messages:deleted',
// 被控端 Subagent 记录变化(payload 顶层 sessionId → session:<id> topic):控制端的
// Subagent 页签发现据此重读一次,不再每 5 秒轮询 local-db:subagent-runs:list。
'local-db:subagent-runs:changed',
// 被控端 terminal error 落库脏信号:控制端据此把已加载历史的远程会话标脏,下次打开重拉。
'local-db:session:error-persisted',
// 被控端项目手动顺序变化:控制端 / 手机首页按被控端正本重排。
'sidebar-settings:project-order-changed',
'local-db:project-aliases:changed',
// 被控端「当前 New Maker 草稿」全量变更:被控端草稿 effort/fast/选中 等任意变化时广播,
// 控制端的远程项目草稿据此实时刷新显示镜像(remoteDraftState)。账号 / 全局级、无 sessionId →
// topics.ts 的 ACCOUNT_CHANNELS 把它并入 `sessions` topic(控制端按设备订阅 sessions)。
'maker:new-maker-draft:changed',
'maker:model-favorites:changed',
// 被控端 repo-scoped worktree 源分支选择变化;无 sessionId,topics.ts 按账号级
// 并入 sessions topic,控制端再按来源 deviceId + payload.baseRepo 精确消费。
'maker:new-maker-worktree-branch:changed',
// 被控端会话「非选中模型」effort/fast 变更:被控端本地改 / 应用控制端写后广播,带 sessionId →
// 默认路由到 session:<id> topic;控制端打开该远程会话时已订阅,据此刷新显示镜像。
'maker:session-model-pref:changed',
// /learn run 状态机流转:payload = { type:'state-changed', run }(账号级,不绑单会话)→
// topics.ts 的 ACCOUNT_CHANNELS 并入 `sessions` topic,随设备列表订阅到达(状态卡 / 审查
// 面板可能在触发会话与蒸馏会话两处打开,按 run 内的 sessionId 路由会漏一边)。
'learn:event',
]);
/**
* 逐 channel 的 invoke 隧道超时覆盖(ms),双向使用:
*
* **放宽**:client 默认 requestTimeoutMs(30s)对「被控端自身持有同量级执行预算」的
* channel 会产生对撞:desktop-cmd:run 在被控端有 30s 命令超时 + 5s SIGKILL 宽限,隧道
* 30s 必然先放弃 —— 命令在被控端继续跑完但输出被丢弃,控制端永远看不到 timedOut:true
* 的正确语义。此表给这类 channel「执行预算 + 回程余量」的覆盖值。
*
* **收紧**:listing tier 的轻量 DB 读(sessions:list / sessions:get)在被控端是毫秒级
* 查询,等满默认 30s 只可能是链路不通。它们又是控制端周期对账的高频 channel,弱网下
* 每个 30s 超时都占着重试与并发预算(2026-08 实测:单日 2253 次 sessions:list 等满
* 30s 超时)。给短超时让失败尽快暴露,把「设备无响应」判定交给控制端熔断器。
* 注意:被控端 dispatch 的 REMOTE_INVOKE_MAX_CLIENT_WAIT_MS 取 max(30s, ...本表),
* 收紧条目不影响被控端的等待窗口。
*
* client-agnostic:mobile/web 控制端应使用同一映射(与 allowlist 同为协议契约)。
*/
export const INVOKE_TIMEOUT_OVERRIDES_MS: Readonly<Record<string, number>> = {
// Evidence collection may include git diff and bounded artifact reads before
// the host can acknowledge the newly-created Reviewer session.
'maker:review:start': 90_000,
// Two Git preflight/apply stages each allow 30s, plus snapshot and queue overhead.
'maker:turn-change-set:apply': 90_000,
[FILE_PEER_CHANNEL]: 30_000,
// Capture renderer readiness + source enumeration + offer, then reply delivery.
"device-link:remote-desktop:v1": REMOTE_DESKTOP_INVOKE_MS,
// 被控端 CMD_TIMEOUT_MS(30s)+ CMD_KILL_GRACE_MS(5s)+ 5s 回程余量
'desktop-cmd:run': 40_000,
// 被控端 worktree:create 含 git worktree add(--no-checkout)+ 白名单文件选择性
// checkout + .claude/.sivi 拷贝;大仓库 / 慢盘上可能超默认 30s,给足执行预算 + 回程余量。
'worktree:create': 60_000,
// User-triggered fetch (30s) plus local probes and process cleanup. Never replay.
'worktree:sync-branch': 90_000,
// 可能先等待同 sessionId 的晚到 create 释放互斥锁,再执行 git worktree remove。
'worktree:discard-precreated': 60_000,
'worktree:cancel-precreated': 60_000,
// pi 手动压缩调 LLM 生成摘要,大上下文 + 网关排队可达分钟级(core 侧
// PI_COMPACT_TIMEOUT_MS = 10min);默认 30s 隧道超时会截断远程压缩请求,
// 用户在控制端看到的就是「无反馈失败」。给足执行预算 + 回程余量:
// 被控端在请求穿过 relay 后才开始跑 PI_COMPACT_TIMEOUT_MS,控制端若只给相同
// 10min,压缩恰好到预算上限时会先 INVOKE_TIMEOUT,被误判为「设备无响应」并
// 可能触发 peer-link 恢复(codex P2)——同 desktop-cmd:run 模式加 1min 余量。
'maker:compact-session': 11 * 60_000,
// Persist drain + credentials refresh + 12s model request + return delivery.
// Shared by desktop/mobile; only this invoke gets the longer wait, no peer reset.
'maker:predict-prompt': 45_000,
// 被控端先等 Lead history 最多 30s,再 resume/queue Worker;默认 30s 会与服务端
// deadline 对撞,把边沿成功误报成 DEVICE_LINK_TIMEOUT。留出派发和回程余量。
'maker:worker:dispatch-ui-assignment': 65_000,
// 被控端要等目标任务的发送锁、必要时恢复 Agent(冷启动 / SSH 就绪)后才回执;默认 30s 会把
// 已经送达的慢恢复报成「结果未知」,调用方重发就成了重复消息。
[DL_SESSION_HANDOFF_CHANNEL]: 65_000,
// 运行设备准备工作目录并启动 Worker 的 Agent,可能超过默认 30s。
[ORCA_REMOTE_WORKER_OPEN_CHANNEL]: ORCA_REMOTE_WORKER_OPEN_TIMEOUT_MS,
// 交出伙伴先把积压对话与全部资料传到服务器,再改主力电脑。
[COMPANION_CLOUD_HAND_OVER_CHANNEL]: COMPANION_CLOUD_HAND_OVER_TIMEOUT_MS,
[COMPANION_CLOUD_MERGE_CHANNEL]: COMPANION_CLOUD_MERGE_TIMEOUT_MS,
[COMPANION_CLOUD_FLUSH_CHANNEL]: COMPANION_CLOUD_HAND_OVER_TIMEOUT_MS,
// listing tier 轻量 DB 读:毫秒级查询,12s 仍等不到只能是链路问题,快速失败喂给熔断器。
// 12s 同时覆盖被控端冷启动 DB 迁移的常见时长(那类失败是快速返回的 DbClient not ready,
// 不吃满超时),不会误伤首拉重试。
'local-db:sessions:list': 12_000,
'local-db:sessions:get': 12_000,
'local-db:sessions:get-many': 12_000,
};
/**
* allowlist 指纹:link-accept 回给控制端,用于探测两端版本差异
* (控制端据此提示「对方版本不一致」而不是静默 CHANNEL_NOT_ALLOWED)。
* FNV-1a over 排序后的 channel 列表,稳定且无依赖。
*/
export function computeAllowlistHash(): string {
const sorted = [...REMOTE_INVOKE_ALLOWLIST].sort().join('\n');
let hash = 0x811c9dc5;
for (let i = 0; i < sorted.length; i++) {
hash ^= sorted.charCodeAt(i);
hash = Math.imul(hash, 0x01000193) >>> 0;
}
return hash.toString(16).padStart(8, '0');
}