@huyooo/ai-chat-bridge-electron 0.1.0

package/dist/renderer/index.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Electron Preload 桥接
+ *
+ * 在 preload 脚本中调用，暴露 API 给渲染进程
+ */
+/** 发送消息参数 */
+interface SendMessageParams {
+    message: string;
+    images?: string[];
+    sessionId?: string;
+    options?: {
+        mode?: string;
+        model?: string;
+        provider?: string;
+        enableWebSearch?: boolean;
+        thinkingMode?: string;
+        thinkingBudget?: number;
+    };
+}
+/** 模型配置 */
+interface ModelConfig$1 {
+    provider: string;
+    model: string;
+    displayName: string;
+    supportsTools: boolean;
+    supportsWebSearch: boolean;
+    supportedThinkingModes: string[];
+}
+/** 会话记录 */
+interface SessionRecord$1 {
+    id: string;
+    appId: string | null;
+    userId: string | null;
+    title: string;
+    model: string;
+    mode: 'agent' | 'plan' | 'ask';
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** 消息记录 */
+interface MessageRecord$1 {
+    id: string;
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    thinking?: string | null;
+    toolCalls?: string | null;
+    searchResults?: string | null;
+    operationIds?: string | null;
+    timestamp: Date;
+}
+/** 操作记录 */
+interface OperationRecord$1 {
+    id: string;
+    sessionId: string;
+    messageId?: string | null;
+    command: string;
+    operationType: string;
+    affectedFiles: string;
+    status: string;
+    timestamp: Date;
+}
+/** 回收站记录 */
+interface TrashRecord$1 {
+    id: string;
+    sessionId: string;
+    originalPath: string;
+    trashPath: string;
+    deletedAt: Date;
+    autoDeleteAt: Date;
+}
+interface AiChatBridge {
+    /** 获取可用模型 */
+    getModels(): Promise<ModelConfig$1[]>;
+    /** 发送消息 */
+    send(params: SendMessageParams): Promise<void>;
+    /** 取消当前请求 */
+    cancel(): Promise<void>;
+    /** 清空 Agent 内存历史 */
+    clearAgentHistory(): Promise<void>;
+    /** 获取 Agent 内存历史 */
+    getAgentHistory(): Promise<unknown[]>;
+    /** 设置工作目录 */
+    setWorkingDir(dir: string): Promise<void>;
+    /** 获取配置 */
+    getConfig(): Promise<unknown>;
+    /** 监听进度事件 */
+    onProgress(callback: (progress: unknown) => void): () => void;
+    /** 获取会话列表 */
+    getSessions(): Promise<SessionRecord$1[]>;
+    /** 获取单个会话 */
+    getSession(id: string): Promise<SessionRecord$1 | null>;
+    /** 创建会话 */
+    createSession(params?: {
+        title?: string;
+        model?: string;
+        mode?: string;
+    }): Promise<SessionRecord$1>;
+    /** 更新会话 */
+    updateSession(id: string, data: {
+        title?: string;
+        model?: string;
+        mode?: string;
+    }): Promise<SessionRecord$1 | null>;
+    /** 删除会话 */
+    deleteSession(id: string): Promise<{
+        success: boolean;
+    }>;
+    /** 获取会话消息 */
+    getMessages(sessionId: string): Promise<MessageRecord$1[]>;
+    /** 保存消息 */
+    saveMessage(params: {
+        sessionId: string;
+        role: 'user' | 'assistant';
+        content: string;
+        thinking?: string;
+        toolCalls?: string;
+        searchResults?: string;
+        operationIds?: string;
+    }): Promise<MessageRecord$1>;
+    /** 删除指定时间之后的消息（用于分叉） */
+    deleteMessagesAfter(sessionId: string, timestamp: number): Promise<{
+        success: boolean;
+    }>;
+    /** 获取操作日志 */
+    getOperations(sessionId: string): Promise<OperationRecord$1[]>;
+    /** 获取回收站 */
+    getTrashItems(): Promise<TrashRecord$1[]>;
+    /** 恢复回收站项目 */
+    restoreFromTrash(id: string): Promise<TrashRecord$1 | undefined>;
+}
+
+/**
+ * Electron 渲染进程 Adapter
+ *
+ * 在渲染进程中使用，创建 ChatAdapter
+ */
+
+type ChatProgressType = 'thinking' | 'search_start' | 'search_result' | 'tool_call' | 'tool_result' | 'text' | 'text_delta' | 'image' | 'video' | 'done' | 'error';
+interface ChatProgress {
+    type: ChatProgressType;
+    data: unknown;
+}
+type ChatMode = 'agent' | 'plan' | 'ask';
+type ModelProvider = 'doubao' | 'deepseek';
+type ThinkingMode = 'enabled' | 'disabled';
+interface ChatOptions {
+    mode?: ChatMode;
+    model?: string;
+    provider?: ModelProvider;
+    enableWebSearch?: boolean;
+    thinkingMode?: ThinkingMode;
+    thinkingBudget?: number;
+}
+interface ModelConfig {
+    provider: ModelProvider;
+    model: string;
+    displayName: string;
+    supportsTools: boolean;
+    supportsWebSearch: boolean;
+    supportedThinkingModes: ThinkingMode[];
+}
+interface SessionRecord {
+    id: string;
+    appId: string | null;
+    userId: string | null;
+    title: string;
+    model: string;
+    mode: ChatMode;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface MessageRecord {
+    id: string;
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    thinking?: string | null;
+    toolCalls?: string | null;
+    searchResults?: string | null;
+    operationIds?: string | null;
+    timestamp: Date;
+}
+interface OperationRecord {
+    id: string;
+    sessionId: string;
+    messageId?: string | null;
+    command: string;
+    operationType: string;
+    affectedFiles: string;
+    status: string;
+    timestamp: Date;
+}
+interface TrashRecord {
+    id: string;
+    sessionId: string;
+    originalPath: string;
+    trashPath: string;
+    deletedAt: Date;
+    autoDeleteAt: Date;
+}
+interface ChatAdapter {
+    /** 获取可用模型 */
+    getModels(): Promise<ModelConfig[]>;
+    /** 发送消息，返回异步迭代器 */
+    sendMessage(message: string, options?: ChatOptions, images?: string[]): AsyncIterable<ChatProgress>;
+    /** 取消当前请求 */
+    cancel(): void;
+    /** 清空 Agent 内存历史 */
+    clearAgentHistory?(): void;
+    /** 获取 Agent 内存历史 */
+    getAgentHistory?(): Promise<unknown[]>;
+    /** 设置工作目录 */
+    setWorkingDir?(dir: string): void;
+    /** 获取会话列表 */
+    getSessions(): Promise<SessionRecord[]>;
+    /** 获取单个会话 */
+    getSession(id: string): Promise<SessionRecord | null>;
+    /** 创建会话 */
+    createSession(params?: {
+        title?: string;
+        model?: string;
+        mode?: string;
+    }): Promise<SessionRecord>;
+    /** 更新会话 */
+    updateSession(id: string, data: {
+        title?: string;
+        model?: string;
+        mode?: string;
+    }): Promise<SessionRecord | null>;
+    /** 删除会话 */
+    deleteSession(id: string): Promise<void>;
+    /** 获取会话消息 */
+    getMessages(sessionId: string): Promise<MessageRecord[]>;
+    /** 保存消息 */
+    saveMessage(params: {
+        sessionId: string;
+        role: 'user' | 'assistant';
+        content: string;
+        thinking?: string;
+        toolCalls?: string;
+        searchResults?: string;
+        operationIds?: string;
+    }): Promise<MessageRecord>;
+    /** 删除指定时间之后的消息（用于分叉） */
+    deleteMessagesAfter(sessionId: string, timestamp: number): Promise<void>;
+    /** 获取操作日志 */
+    getOperations(sessionId: string): Promise<OperationRecord[]>;
+    /** 获取回收站 */
+    getTrashItems(): Promise<TrashRecord[]>;
+    /** 恢复回收站项目 */
+    restoreFromTrash(id: string): Promise<TrashRecord | undefined>;
+}
+declare global {
+    interface Window {
+        aiChatBridge?: AiChatBridge;
+    }
+}
+interface CreateAdapterOptions {
+    /** 全局变量名 */
+    bridgeName?: string;
+}
+/**
+ * 创建 Electron Adapter
+ */
+declare function createElectronAdapter(options?: CreateAdapterOptions): ChatAdapter;
+
+export { type ChatAdapter, type ChatMode, type ChatOptions, type ChatProgress, type ChatProgressType, type CreateAdapterOptions, type MessageRecord, type ModelConfig, type ModelProvider, type OperationRecord, type SessionRecord, type ThinkingMode, type TrashRecord, createElectronAdapter };

package/dist/renderer/index.js

@@ -0,0 +1,105 @@
+// src/renderer/index.ts
+function createElectronAdapter(options = {}) {
+  const { bridgeName = "aiChatBridge" } = options;
+  const getBridge = () => {
+    const bridge = window[bridgeName];
+    if (!bridge) {
+      throw new Error(`AI Chat Bridge not found. Make sure to call exposeElectronBridge() in preload.`);
+    }
+    return bridge;
+  };
+  return {
+    // ============ Chat API ============
+    async getModels() {
+      const bridge = getBridge();
+      const models = await bridge.getModels();
+      return models.map((m) => ({
+        ...m,
+        provider: m.provider,
+        supportedThinkingModes: m.supportedThinkingModes
+      }));
+    },
+    async *sendMessage(message, options2, images) {
+      const bridge = getBridge();
+      const queue = [];
+      let resolveNext = null;
+      let done = false;
+      const cleanup = bridge.onProgress((progress) => {
+        queue.push(progress);
+        resolveNext?.();
+        if (progress.type === "done" || progress.type === "error") {
+          done = true;
+        }
+      });
+      bridge.send({ message, images, options: options2 });
+      try {
+        while (!done || queue.length > 0) {
+          while (queue.length === 0 && !done) {
+            await new Promise((r) => resolveNext = r);
+          }
+          if (queue.length > 0) {
+            const progress = queue.shift();
+            yield progress;
+            if (progress.type === "done" || progress.type === "error") {
+              break;
+            }
+          }
+        }
+      } finally {
+        cleanup();
+      }
+    },
+    cancel() {
+      getBridge().cancel();
+    },
+    clearAgentHistory() {
+      getBridge().clearAgentHistory();
+    },
+    async getAgentHistory() {
+      return getBridge().getAgentHistory();
+    },
+    setWorkingDir(dir) {
+      getBridge().setWorkingDir(dir);
+    },
+    // ============ Sessions API ============
+    async getSessions() {
+      return getBridge().getSessions();
+    },
+    async getSession(id) {
+      return getBridge().getSession(id);
+    },
+    async createSession(params) {
+      return getBridge().createSession(params);
+    },
+    async updateSession(id, data) {
+      return getBridge().updateSession(id, data);
+    },
+    async deleteSession(id) {
+      await getBridge().deleteSession(id);
+    },
+    // ============ Messages API ============
+    async getMessages(sessionId) {
+      return getBridge().getMessages(sessionId);
+    },
+    async saveMessage(params) {
+      return getBridge().saveMessage(params);
+    },
+    async deleteMessagesAfter(sessionId, timestamp) {
+      await getBridge().deleteMessagesAfter(sessionId, timestamp);
+    },
+    // ============ Operations API ============
+    async getOperations(sessionId) {
+      return getBridge().getOperations(sessionId);
+    },
+    // ============ Trash API ============
+    async getTrashItems() {
+      return getBridge().getTrashItems();
+    },
+    async restoreFromTrash(id) {
+      return getBridge().restoreFromTrash(id);
+    }
+  };
+}
+export {
+  createElectronAdapter
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@huyooo/ai-chat-bridge-electron",
+  "version": "0.1.0",
+  "description": "AI Chat Electron Bridge - IPC integration for Electron apps",
+  "type": "module",
+  "main": "./dist/main/index.cjs",
+  "module": "./dist/main/index.js",
+  "types": "./dist/main/index.d.ts",
+  "exports": {
+    "./main": {
+      "types": "./dist/main/index.d.ts",
+      "import": "./dist/main/index.js",
+      "require": "./dist/main/index.cjs"
+    },
+    "./preload": {
+      "types": "./dist/preload/index.d.ts",
+      "import": "./dist/preload/index.js",
+      "require": "./dist/preload/index.cjs"
+    },
+    "./renderer": {
+      "types": "./dist/renderer/index.d.ts",
+      "import": "./dist/renderer/index.js",
+      "require": "./dist/renderer/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@huyooo/ai-chat-core": "*",
+    "@huyooo/ai-chat-storage": "*"
+  },
+  "peerDependencies": {
+    "electron": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "electron": "^33.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "ai",
+    "chat",
+    "electron",
+    "ipc",
+    "bridge"
+  ],
+  "author": "huyooo",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}