Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 右侧栏独立子窗口(RSB window)的跨进程共享类型。
*
* 三方共用:main(controller / IPC handler)、preload(桥接签名)、renderer
* (主窗镜像 store + 子窗口根组件)。只放纯类型,不放运行时代码。
*/
import type { SubagentProvider } from '@cindy/maker-shared/subagent-workspace';
import type { ConversationSearchJump } from './conversationSearchJump.js';
/** 子窗口全局状态:均仅在当前进程有效;重启后 detached / lastOpen 重置。 */
export interface RsbWindowState {
/** 当前运行期是否在独立窗口中显示。 */
detached: boolean;
/** 当前运行期是否曾请求保持窗口打开;不跨客户端重启。 */
lastOpen: boolean;
/** 运行时:子窗口当前是否存在。不持久化。 */
open: boolean;
/** 子窗口最近一次真正展示的宿主 session。关窗后仍保留,供主窗写折叠归属。 */
hostSessionId?: string | null;
}
/**
* 侧边栏渲染上下文 —— 由主窗 MainLayout 上报(单一真相:草稿会话 / remote 会话的
* workdir 语义只有主窗路由视图知道,子窗口不能自查),main 缓存并转发子窗口。
*/
export interface RsbWindowContext {
sessionId: string | null;
workdir: string | null;
remoteHostId: string | null;
/** device-link 会话归属:null = 已确认本机,undefined = 尚未解析。 */
deviceLinkDeviceId?: string | null;
/** Pi is the only harness that exposes the Subagents sidebar surface. */
subagentsAvailable?: boolean;
/** Only the linked Bot identity needed by the detached add-tab menu. Absent on older senders. */
botOwner?: { botId: string; canonical: boolean } | null;
/** 当前主窗视图是否有侧边栏语义(设置页等无会话视图为 false,子窗口显示占位空态)。 */
available: boolean;
}
/** main → 子窗口的命令推送(如主窗终端快捷键转发 / detached RSB 内定位文件)。 */
export type RsbWindowCommand =
| { type: 'open-routines-tab'; sessionId: string; botId: string }
/** 打开 / 聚焦插件任务页(taskView):instanceId 是已装插件实例的存储键。 */
| {
type: 'open-plugin-task';
sessionId: string;
instanceId: string;
/** Main 从路由请求写入的来源;缺省为被动,仅用于保留选中与焦点语义。 */
userInitiated?: boolean;
}
| { type: 'open-terminal'; sessionId: string }
| { type: 'toggle-review-tab'; sessionId: string }
| { type: 'open-web-browser'; sessionId: string; url: string }
| { type: 'open-mail-preview'; sessionId: string; url: string }
| { type: 'open-mail-card'; sessionId: string; callId: string }
| {
type: 'ensure-orca-workers-tab';
sessionId: string;
focusWorkerSessionId?: string | null;
searchJump?: ConversationSearchJump | null;
focusTab?: boolean;
}
| { type: 'close-orca-workers-tab'; sessionId: string }
/** 打开/聚焦「后台任务」页签(每会话单例);focusTaskId 定位到对应 workflow 详情。 */
| {
type: 'open-background-tasks-tab';
sessionId: string;
focusTaskId?: string | null;
}
/** 打开/聚焦 Cindy 持久化的 Subagent 工作区(每个父任务单例)。 */
| {
type: 'open-subagents-tab';
sessionId: string;
focusRunId?: string | null;
focusProvider?: SubagentProvider | null;
/** False adds the singleton without replacing the user's active tab. */
focusTab?: boolean;
/** False persists the tab without expanding the sidebar. */
revealSidebar?: boolean;
}
| {
type: 'open-turn-review';
sessionId: string;
changeSetIds: string[];
selectedDiffId?: string | null;
selectedPath?: string | null;
requestNonce: number;
/**
* 承载 review tab 的 RSB 桶(缺省 = sessionId 自身)。协同面板里 worker
* 流的入口传 lead sessionId:worker 自己的桶在协同视图下不可见。
*/
hostSessionId?: string | null;
}
| {
type: 'open-file-browser';
sessionId: string;
relPath: string;
targetKind: 'file' | 'directory';
}
| {
type: 'open-file-browser';
sessionId: string;
absPath: string;
targetKind: 'external-file';
};
/** renderer 请求 main 原子裁决当前 RSB command 的宿主。 */
export interface RsbWindowCommandRouteRequest {
command: RsbWindowCommand;
/** false 时 detached host 关闭/未 ready 不得重开,main 会保存 intent。 */
allowOpen: boolean;
/**
* 这条命令是不是用户当次手势直接要求的(点链接 / 点菜单 / 点按钮)。
*
* 缺省 true —— 绝大多数调用点都是用户手势,保持既有「带出子窗口」观感。
* 插件 preview 槽开页、agent 浏览器自动化这类**程序自发**的命令必须显式传
* false:内容照常送进子窗口,但不得 show/focus 抢走用户当前前台应用
* (Windows 上 focus() 就是抢前台,后台干活弹窗口是硬伤)。
*/
userInitiated?: boolean;
}
/** main-owned 宿主裁决;renderer 只有 attached 可以写本地 store。 */
export type RsbWindowCommandRouteResult =
| 'attached'
| 'routed'
| 'queued'
| 'stale-context';
/**
* 主 renderer 与分离侧栏 renderer 切换宿主时双向交接的内存态 tab 快照。
*
* 只用于 persistable=false 的 session。普通本地 session 的权威来源仍是
* SQLite,避免用子窗口里可能过期的 renderer 快照覆盖持久化真相。
*/
export interface RsbWindowTabSnapshot {
sessionId: string;
tabs: Array<{ id: string; kind: string; state: unknown }>;
activeTabId: string | null;
persistable: boolean;
}
export interface RsbWindowTabHandoff {
snapshots: RsbWindowTabSnapshot[];
}
// ── 预热/就绪/隐藏复用 IPC channel 常量 ──────────────────────────────
// renderer → main(invoke):轻量窗口根组件已经挂载(Renderer shell 可展示)。
export const RSB_WINDOW_RENDERER_READY_CHANNEL = 'rsb-window:renderer-ready';
// renderer → main(invoke):首份业务内容已提交(context+store 就绪,至少 EmptyState 可见)。
export const RSB_WINDOW_PRESENTATION_READY_CHANNEL = 'rsb-window:presentation-ready';
// main → renderer(send):隐藏/显示时通知子窗口刷新 context 与重置瞬时交互态。
export const RSB_WINDOW_VISIBILITY_CHANGED_CHANNEL = 'rsb-window:visibility-changed';
// renderer → main(invoke):子窗口请求刷新 context(从 main 缓存拉最新值)。
export const RSB_WINDOW_REFRESH_CONTEXT_CHANNEL = 'rsb-window:refresh-context';
export const RSB_WINDOW_LOCALE_CHANGED_CHANNEL = 'rsb-window:locale-changed';
/** main → 主 renderer:合并前交接不可持久化 session 的 tab 快照。 */
export const RSB_WINDOW_TAB_HANDOFF_CHANNEL = 'maker:rsb-window:tab-handoff';
// 以下三条是 main → renderer(send) 的主动推送。channel 名必须与 main 端
// MAKER_PUSH.* 完全一致:子窗口 preload 曾按不存在的 `maker:push:*` 订阅,导致
// 主窗转发过来的 open-web-browser 命令(链接触发 / 插件预览 / 文件审查)
// 全部静默丢失,分离侧栏表现为“点了没反应、页签不出现”。(#3390 / #4403)
// 统一收口到这里,main 与两个 preload 都只引用常量,不再各写一份字符串。
/** main → 全部窗口:子窗口状态广播(detached / open)。 */
export const RSB_WINDOW_STATE_CHANGED_CHANNEL = 'maker:rsb-window:state-changed';
/** main → 子窗口:侧边栏渲染上下文变化(主窗切会话)。 */
export const RSB_WINDOW_CONTEXT_CHANGED_CHANNEL = 'maker:rsb-window:context-changed';
/** main → 子窗口:命令推送(open-web-browser / open-terminal / tab 定位等)。 */
export const RSB_WINDOW_COMMAND_CHANNEL = 'maker:rsb-window:command';