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。

8.9 KB
Raw Blame
import { contextBridge, ipcRenderer } from 'electron';
import type { PluginModelPickerOptions, PluginModelPickerResult } from '../shared/pluginModelPicker';

/**
 * 意识电子脑的最小管子桥(脑机接口;docs/dev-rules/plugin-security-and-authoring.md)。
 *
 * 只注入**离屏逻辑页**(电子脑);面板页零桥零特权(面板与逻辑页走同源
 * BroadcastChannel,主机零中转)。身份不自报:main 侧按 sender webContents
 * 与意识 id 的绑定表验身,冒名调用直接拒(结构隔离,见 electronSandboxAdapter)。
 *
 * 暴露面刻意极小(管子三口 + network 一口):
 * - ping():握手/自检,回自己的意识 id;
 * - onHostMessage(cb):订阅主机下行(工具调用派发等,后续切片投递);
 * - send(payload):上行投递(工具结果/Host 请求等);主机按消息类型、
 *   调用上下文与插件自主能力声明守门,未开闸的类型一律拒;
 * - request(req):读取宿主公开上下文的便捷口——就是
 *   send({type:'host-request',…req}) 的语法糖;目前只支持 app-context(region),
 *   不含用户数据与凭证,也不扩张其它主机能力。
 * - fetch(req):主机代理 HTTP 的便捷口——就是 send({type:'fetch-request',
 *   …req}) 的语法糖。Agent 在途调用凭 callId 复用 Agent 授权;自主调用
 *   按 network 声明守门,托管凭证始终只按声明注入。
 * - fs(req):主机文件操作的便捷口——send({type:'fs-request', …req}) 的
 *   语法糖。workdir 写入可复用 Agent 在途授权,data 私有目录按 fs 声明守门。
 * - library(req):持久作品库的便捷口——send({type:'library-request', …req})
 *   的语法糖;资格审、binding 根解析、owner scope 复核与 SQL 语句门都在
 *   主机侧 librarySlot,失败返回结构化 errorCode。
 * - agent.errand(req) / agent.queryErrand(req):派活取件便捷口——
 *   send({type:'agent-errand-request', kind:'run'/'query', …req}) 的语法糖;
 * - agent.run(req):Agent 新回合的便捷口——send({type:'agent-request',
 *   …req}) 的语法糖;一次性用户票、后台权限和会话归属由主机校验。
 * - node.request(req):随包 Node / stdio MCP 的便捷口。Node 只能经本管子与
 *   main.js 收发 JSON-RPC,不能直接拿到 Cindy API。
 * - pick(req):pick 槽的便捷口——send({type:'pick-request', …req}) 的语法糖;
 *   系统选文件夹窗口由主机弹,用户亲选即授权,守门全在主机侧 pickSlot。
 * - preview(req):preview 槽的便捷口——send({type:'preview-request', …req})
 *   的语法糖;URL 白名单守门在主机侧 previewSlot。
 * - taskView(req):taskView 槽的便捷口——send({type:'task-view-request', …req});
 *   在任务右侧栏打开 / 聚焦本插件的任务页,回执 {ok, sessionId} 带回落点任务;
 *   {peek:true} 只回答落点、不开页签。
 * - workspace(req):workspace 槽的便捷口——send({type:'workspace-request',
 *   …req}) 的语法糖;目录授权与会话创建守门全在主机侧 workspaceSlot。
 * - confirm(req):confirm 槽的便捷口——send({type:'confirm-request', …req}) 的
 *   语法糖;主机弹自己那套确认框并把用户的真实点击回给沙箱,资格审/净化/限速/
 *   单飞/超时兜底全在主机侧 confirmSlot 与 ghostConfirmDialogBridge。
 */

type HostMessageListener = (payload: unknown) => void;
const listeners = new Set<HostMessageListener>();
ipcRenderer.on('ghost-pipe:message', (_event, payload: unknown) => {
  listeners.forEach((listener) => listener(payload));
});

contextBridge.exposeInMainWorld('cindy', {
  ping: (): Promise<{ ok: true; id: string }> => ipcRenderer.invoke('ghost-pipe:ping'),
  onHostMessage: (cb: HostMessageListener): (() => void) => {
    listeners.add(cb);
    return () => listeners.delete(cb);
  },
  send: (payload: unknown): Promise<unknown> => ipcRenderer.invoke('ghost-pipe:send', payload),
  recommendations: (items: unknown[]): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { type: 'recommendations-update', items }),
  request: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'host-request' }),
  fetch: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'fetch-request' }),
  downloads: {
    start: (req: Record<string, unknown>): Promise<unknown> => ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'download-request', kind: 'start' }),
    cancel: (req: Record<string, unknown>): Promise<unknown> => ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'download-request', kind: 'cancel' }),
  },
  fs: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'fs-request' }),
  deviceSync: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'device-sync-request' }),
  library: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'library-request' }),
  targets: Object.fromEntries(['list', 'resolve', 'send', 'cancel'].map(kind => [kind,
    async (req: Record<string, unknown> = {}): Promise<unknown> => {
      const result = await ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'targets-request', kind });
      if (result?.ok === true) return result.data;
      throw Object.assign(new Error(result?.error?.message ?? 'Target request failed'), { code: result?.error?.code ?? 'HOST_NOT_READY' });
    },
  ])),
  tasks: Object.fromEntries(
    ['capabilities', 'models', 'setModel', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'create', 'list', 'get', 'send', 'getRun', 'listRuns', 'cancel', 'readMessages', 'setHidden', 'archive'].map(kind => [
      kind, async (req: Record<string, unknown> = {}): Promise<unknown> => {
        const result = await ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'tasks-request', kind });
        if (result?.ok === true) return result.data;
        throw Object.assign(new Error(result?.error?.message ?? 'Task request failed'), { code: result?.error?.code ?? 'HOST_NOT_READY', retryable: result?.error?.retryable === true });
      },
    ]),
  ),
  agent: {
    run: (req: Record<string, unknown>): Promise<unknown> =>
      ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'agent-request' }),
    // 派活取件(agent.errand 加档)的便捷口:errand = 提交(kind:'run'),
    // queryErrand = 取件(kind:'query')。都是 send({type:'agent-errand-request'})
    // 的语法糖,资格审与频控在主机 errandSlot。
    errand: (req: Record<string, unknown>): Promise<unknown> =>
      ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'agent-errand-request', kind: 'run' }),
    queryErrand: (req: Record<string, unknown>): Promise<unknown> =>
      ipcRenderer.invoke('ghost-pipe:send', {
        ...req,
        type: 'agent-errand-request',
        kind: 'query',
      }),
    // 请用户新建一条自动化(agent.schedule 加档):只能**打开预填好的创建面板**,
    // 建不建由用户在面板上选好模型后亲手保存。{ ok:true } 只表示"请求已被接受并投递",
    // 既不保证面板真开了(用户正编辑另一个表单时本次草稿会被丢弃),也不表示任务已创建
    // ——本版没有回执通道,绑定与查改由后续版本提供(语义见 GhostPipeScheduleDraftResult)。
    // 资格审 / 净化 / 频率钳制 / 限速都在主机 scheduleSlot。
    requestSchedule: (req: Record<string, unknown>): Promise<unknown> =>
      ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'schedule-request' }),
  },
  routines: {
    request: (req: Record<string, unknown>): Promise<unknown> =>
      ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'routine-request' }),
  },
  node: {
    request: (req: Record<string, unknown>): Promise<unknown> =>
      ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'node-request' }),
  },
  pick: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'pick-request' }),
  pickModel: (req: PluginModelPickerOptions = {}): Promise<PluginModelPickerResult> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'model-picker-request' }),
  preview: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'preview-request' }),
  // 在任务右侧栏打开 / 聚焦本插件的任务页(taskView);缺省落台前任务,回执带回落点任务。
  taskView: (req: Record<string, unknown> = {}): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'task-view-request' }),
  workspace: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'workspace-request' }),
  confirm: (req: Record<string, unknown>): Promise<unknown> =>
    ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'confirm-request' }),
});