@aix-chat/core 0.1.0

package/dist/bridge/ChatBridge.d.ts

@@ -0,0 +1,111 @@
+/**
+ * ChatBridge — 命令式聊天控制 API
+ *
+ * 纯 JS 实现，零 React 依赖。通过 handler 注册模式与 React 层解耦：
+ * - adapters 的 useChatBridge hook 注册 submit/abort/getMessages 等 handler
+ * - 外部代码（ReactRender sandbox、action 按钮、父页面）调用公共 API
+ */
+import { EventEmitter } from '../utils/EventEmitter';
+export { EventEmitter };
+export interface ChatBridgeConfig {
+    /** 是否挂载到 window.aixBridge（默认 false） */
+    installGlobal?: boolean;
+}
+/**
+ * 输入框控制接口
+ * 与 ui 包的 ChatInputRef 结构兼容，但不依赖 ui 包
+ */
+export interface BridgeInputRef {
+    focus(): void;
+    blur(): void;
+    clear(): void;
+    getValue(): string;
+    insert(text: string, position?: 'start' | 'end' | number): void;
+}
+export type BridgeHandler = (...args: any[]) => any;
+export declare class ChatBridge {
+    private handlers;
+    private inputRef;
+    private config;
+    /** 存储 tabId 到 eventEmitter 的映射 */
+    private panelEmitters;
+    constructor(config?: ChatBridgeConfig);
+    /**
+     * 注册一个命令处理器
+     */
+    registerHandler(name: string, handler: BridgeHandler): void;
+    /**
+     * 注销一个命令处理器
+     */
+    unregisterHandler(name: string): void;
+    /**
+     * 发送消息（触发聊天 submit）
+     */
+    submit(content: string, extra?: Record<string, any>): any;
+    /**
+     * 发送消息（submit 的别名，与 Panel 代码保持兼容）
+     * 支持 isInject 参数标记为注入消息
+     */
+    sendMessage(content: string, extra?: Record<string, any>): any;
+    /**
+     * 中止当前请求
+     */
+    abort(): void;
+    /**
+     * 获取当前消息列表
+     */
+    getMessages(): any[];
+    /**
+     * 是否正在请求中
+     */
+    getIsRequesting(): boolean;
+    /**
+     * 设置输入框 ref（由 useChatBridge 调用）
+     */
+    setInputRef(ref: BridgeInputRef | null): void;
+    /**
+     * 获取输入框 ref（外部可调用 focus/clear/insert 等）
+     */
+    getInputRef(): BridgeInputRef | null;
+    /**
+     * 打开（或激活）副屏中的指定 tab。
+     * tab 不存在时新建，已存在时更新 payload 并切换到该 tab。
+     * 自动为每个 tab 创建一个 EventEmitter，供事件通信使用。
+     */
+    openPanelTab(tab: import('../types/panel').PanelTab): void;
+    /**
+     * 关闭副屏中的指定 tab。
+     * 同时清理存储的 eventEmitter（如果有）。
+     */
+    closePanelTab(id: string): void;
+    /**
+     * 展开副屏面板容器（不影响 tab 内容）。
+     */
+    openPanel(): void;
+    /**
+     * 收起副屏面板容器（tab 仍保留，只是不可见）。
+     */
+    closePanel(): void;
+    /**
+     * 强制关闭副屏面板并清空所有 tabs。
+     */
+    closePanelForce(): void;
+    /**
+     * 更新副屏中的指定 tab。
+     * 如果 tab 不存在，此方法无效果。
+     */
+    updatePanelTab(id: string, update: Partial<Omit<import('../types/panel').PanelTab, 'id'>>): void;
+    /**
+     * 向副屏中的指定 tab 发送事件。
+     * 事件由副屏组件订阅和消费，通过 EventEmitter 实现。
+     */
+    emitPanelEvent(id: string, event: import('../types/panel').PanelEvent): void;
+    /**
+     * 获取指定 tab 的 EventEmitter（供 SidePanelContent 注入到 payload）
+     */
+    getPanelEventEmitter(id: string): EventEmitter | undefined;
+    /**
+     * 销毁 bridge，清理所有 handler 和全局引用
+     */
+    destroy(): void;
+}

package/dist/bridge/ChatBridge.js

@@ -0,0 +1,273 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * ChatBridge — 命令式聊天控制 API
+ *
+ * 纯 JS 实现，零 React 依赖。通过 handler 注册模式与 React 层解耦：
+ * - adapters 的 useChatBridge hook 注册 submit/abort/getMessages 等 handler
+ * - 外部代码（ReactRender sandbox、action 按钮、父页面）调用公共 API
+ */
+
+import { EventEmitter } from "../utils/EventEmitter";
+
+// 导出 EventEmitter，方便业务组件直接使用
+export { EventEmitter };
+
+// ======================== 类型定义 ========================
+
+/**
+ * 输入框控制接口
+ * 与 ui 包的 ChatInputRef 结构兼容，但不依赖 ui 包
+ */
+
+// ======================== ChatBridge ========================
+
+export var ChatBridge = /*#__PURE__*/function () {
+  function ChatBridge(config) {
+    _classCallCheck(this, ChatBridge);
+    _defineProperty(this, "handlers", new Map());
+    _defineProperty(this, "inputRef", null);
+    _defineProperty(this, "config", void 0);
+    /** 存储 tabId 到 eventEmitter 的映射 */
+    _defineProperty(this, "panelEmitters", new Map());
+    this.config = config || {};
+    if (this.config.installGlobal && typeof window !== 'undefined') {
+      window.aixBridge = this;
+    }
+  }
+
+  // -------------------- Handler 注册（由 adapters 调用） --------------------
+
+  /**
+   * 注册一个命令处理器
+   */
+  _createClass(ChatBridge, [{
+    key: "registerHandler",
+    value: function registerHandler(name, handler) {
+      this.handlers.set(name, handler);
+    }
+
+    /**
+     * 注销一个命令处理器
+     */
+  }, {
+    key: "unregisterHandler",
+    value: function unregisterHandler(name) {
+      this.handlers.delete(name);
+    }
+
+    // -------------------- 公共 API（由外部代码调用） --------------------
+
+    /**
+     * 发送消息（触发聊天 submit）
+     */
+  }, {
+    key: "submit",
+    value: function submit(content, extra) {
+      var handler = this.handlers.get('submit');
+      if (!handler) {
+        console.warn('[ChatBridge] No "submit" handler registered. Ensure useChatBridge is mounted.');
+        return;
+      }
+      return handler(content, extra);
+    }
+
+    /**
+     * 发送消息（submit 的别名，与 Panel 代码保持兼容）
+     * 支持 isInject 参数标记为注入消息
+     */
+  }, {
+    key: "sendMessage",
+    value: function sendMessage(content, extra) {
+      return this.submit(content, extra);
+    }
+
+    /**
+     * 中止当前请求
+     */
+  }, {
+    key: "abort",
+    value: function abort() {
+      var _this$handlers$get;
+      (_this$handlers$get = this.handlers.get('abort')) === null || _this$handlers$get === void 0 || _this$handlers$get();
+    }
+
+    /**
+     * 获取当前消息列表
+     */
+  }, {
+    key: "getMessages",
+    value: function getMessages() {
+      var _this$handlers$get2, _this$handlers$get3;
+      return (_this$handlers$get2 = (_this$handlers$get3 = this.handlers.get('getMessages')) === null || _this$handlers$get3 === void 0 ? void 0 : _this$handlers$get3()) !== null && _this$handlers$get2 !== void 0 ? _this$handlers$get2 : [];
+    }
+
+    /**
+     * 是否正在请求中
+     */
+  }, {
+    key: "getIsRequesting",
+    value: function getIsRequesting() {
+      var _this$handlers$get4, _this$handlers$get5;
+      return (_this$handlers$get4 = (_this$handlers$get5 = this.handlers.get('getIsRequesting')) === null || _this$handlers$get5 === void 0 ? void 0 : _this$handlers$get5()) !== null && _this$handlers$get4 !== void 0 ? _this$handlers$get4 : false;
+    }
+
+    // -------------------- Input 控制 --------------------
+
+    /**
+     * 设置输入框 ref（由 useChatBridge 调用）
+     */
+  }, {
+    key: "setInputRef",
+    value: function setInputRef(ref) {
+      this.inputRef = ref;
+    }
+
+    /**
+     * 获取输入框 ref（外部可调用 focus/clear/insert 等）
+     */
+  }, {
+    key: "getInputRef",
+    value: function getInputRef() {
+      return this.inputRef;
+    }
+
+    // -------------------- Panel 控制 --------------------
+    // 与 ChatLayout.Panel 配合：Panel mount 时注册 handler，unmount 时注销。
+    // 业务卡片（任意位置）通过这组方法命令式唤起副屏。
+
+    /**
+     * 打开（或激活）副屏中的指定 tab。
+     * tab 不存在时新建，已存在时更新 payload 并切换到该 tab。
+     * 自动为每个 tab 创建一个 EventEmitter，供事件通信使用。
+     */
+  }, {
+    key: "openPanelTab",
+    value: function openPanelTab(tab) {
+      var handler = this.handlers.get('openPanelTab');
+      if (!handler) {
+        console.warn('[ChatBridge] No "openPanelTab" handler registered. Ensure ChatLayout.Panel is mounted.');
+        return;
+      }
+
+      // 自动为每个 tab 创建 EventEmitter（如果不存在）
+      if (!this.panelEmitters.has(tab.id)) {
+        this.panelEmitters.set(tab.id, new EventEmitter());
+      }
+      handler(tab);
+    }
+
+    /**
+     * 关闭副屏中的指定 tab。
+     * 同时清理存储的 eventEmitter（如果有）。
+     */
+  }, {
+    key: "closePanelTab",
+    value: function closePanelTab(id) {
+      var _this$handlers$get6;
+      // 清理存储的 eventEmitter
+      var emitter = this.panelEmitters.get(id);
+      if (emitter) {
+        emitter.removeAllListeners();
+        this.panelEmitters.delete(id);
+      }
+      (_this$handlers$get6 = this.handlers.get('closePanelTab')) === null || _this$handlers$get6 === void 0 || _this$handlers$get6(id);
+    }
+
+    /**
+     * 展开副屏面板容器（不影响 tab 内容）。
+     */
+  }, {
+    key: "openPanel",
+    value: function openPanel() {
+      var _this$handlers$get7;
+      (_this$handlers$get7 = this.handlers.get('openPanel')) === null || _this$handlers$get7 === void 0 || _this$handlers$get7();
+    }
+
+    /**
+     * 收起副屏面板容器（tab 仍保留，只是不可见）。
+     */
+  }, {
+    key: "closePanel",
+    value: function closePanel() {
+      var _this$handlers$get8;
+      (_this$handlers$get8 = this.handlers.get('closePanel')) === null || _this$handlers$get8 === void 0 || _this$handlers$get8();
+    }
+
+    /**
+     * 强制关闭副屏面板并清空所有 tabs。
+     */
+  }, {
+    key: "closePanelForce",
+    value: function closePanelForce() {
+      var _this$handlers$get9;
+      (_this$handlers$get9 = this.handlers.get('closePanelForce')) === null || _this$handlers$get9 === void 0 || _this$handlers$get9();
+    }
+
+    /**
+     * 更新副屏中的指定 tab。
+     * 如果 tab 不存在，此方法无效果。
+     */
+  }, {
+    key: "updatePanelTab",
+    value: function updatePanelTab(id, update) {
+      var handler = this.handlers.get('updatePanelTab');
+      if (!handler) {
+        console.warn('[ChatBridge] No "updatePanelTab" handler registered. Ensure ChatLayout.Panel is mounted.');
+        return;
+      }
+      handler(id, update);
+    }
+
+    /**
+     * 向副屏中的指定 tab 发送事件。
+     * 事件由副屏组件订阅和消费，通过 EventEmitter 实现。
+     */
+  }, {
+    key: "emitPanelEvent",
+    value: function emitPanelEvent(id, event) {
+      var emitter = this.panelEmitters.get(id);
+      if (!emitter) {
+        console.warn("[ChatBridge] No EventEmitter found for tab \"".concat(id, "\". Ensure openPanelTab was called."));
+        return;
+      }
+      emitter.emit(event.type, event.payload);
+    }
+
+    /**
+     * 获取指定 tab 的 EventEmitter（供 SidePanelContent 注入到 payload）
+     */
+  }, {
+    key: "getPanelEventEmitter",
+    value: function getPanelEventEmitter(id) {
+      return this.panelEmitters.get(id);
+    }
+
+    // -------------------- 生命周期 --------------------
+
+    /**
+     * 销毁 bridge，清理所有 handler 和全局引用
+     */
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.handlers.clear();
+      this.inputRef = null;
+
+      // 清理所有 EventEmitter
+      this.panelEmitters.forEach(function (emitter) {
+        return emitter.removeAllListeners();
+      });
+      this.panelEmitters.clear();
+      if (this.config.installGlobal && typeof window !== 'undefined' && window.aixBridge === this) {
+        delete window.aixBridge;
+      }
+    }
+  }]);
+  return ChatBridge;
+}();

package/dist/bridge/index.d.ts

@@ -0,0 +1,16 @@
+import { ChatBridge, EventEmitter } from './ChatBridge';
+export { ChatBridge, EventEmitter };
+export type { ChatBridgeConfig, BridgeInputRef, BridgeHandler } from './ChatBridge';
+type BridgeKey = string | number | symbol;
+/**
+ * ChatBridge 全局注册表
+ * 类比 chatMessagesStoreHelper，支持多实例管理
+ */
+export declare const chatBridgeHelper: {
+    _bridges: Map<BridgeKey, ChatBridge>;
+    get(key: BridgeKey): ChatBridge | undefined;
+    set(key: BridgeKey, bridge: ChatBridge): void;
+    delete(key: BridgeKey): void;
+    /** 获取第一个注册的 bridge（单实例场景的快捷方式） */
+    getDefault(): ChatBridge | undefined;
+};

package/dist/bridge/index.js

@@ -0,0 +1,25 @@
+import { ChatBridge, EventEmitter } from "./ChatBridge";
+export { ChatBridge, EventEmitter };
+
+// ======================== 全局注册表 ========================
+
+/**
+ * ChatBridge 全局注册表
+ * 类比 chatMessagesStoreHelper，支持多实例管理
+ */
+export var chatBridgeHelper = {
+  _bridges: new Map(),
+  get: function get(key) {
+    return chatBridgeHelper._bridges.get(key);
+  },
+  set: function set(key, bridge) {
+    chatBridgeHelper._bridges.set(key, bridge);
+  },
+  delete: function _delete(key) {
+    chatBridgeHelper._bridges.delete(key);
+  },
+  /** 获取第一个注册的 bridge（单实例场景的快捷方式） */getDefault: function getDefault() {
+    var first = chatBridgeHelper._bridges.values().next();
+    return first.done ? undefined : first.value;
+  }
+};

package/dist/domain/block.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Block — 协议无关的最小基类
+ * 所有 Parser 输出的 block 均实现此接口
+ */
+export interface Block {
+    type: string;
+}

package/dist/domain/block.js

@@ -0,0 +1 @@
+export {};

package/dist/domain/chat.d.ts

@@ -0,0 +1,77 @@
+import type { ChatProvider } from '../types/provider';
+import type { ChatMessage } from './message';
+export interface ChatSnapshot {
+    messages: ChatMessage[];
+    isRequesting: boolean;
+    error?: Error;
+    /** 是否可以重试（最后一个 Turn 处于 error / aborted 状态） */
+    canRetry: boolean;
+}
+/**
+ * Chat — 核心交互实体
+ *
+ * 职责：
+ *   - 接管 Provider 的 onMessage / onComplete / onError 回调
+ *   - 维护消息列表与请求状态
+ *   - 提供 subscribe / getSnapshot 供 React hooks 订阅
+ *   - 支持 Turn 级重试（retry）
+ *   - 通过 onComplete / onError 向外透传会话级事件
+ *
+ * 不负责：
+ *   - WebSocket 连接管理（ConnectionStatus 由 hooks 层管理）
+ *   - 历史分页加载
+ *   - Provider 的创建与生命周期
+ */
+export declare class Chat<TInput = any> {
+    readonly provider: ChatProvider<TInput>;
+    /** 会话完成后的外部回调（由 useSessions 等注入） */
+    onComplete?: (messages: ChatMessage[]) => void;
+    /** 会话出错后的外部回调 */
+    onError?: (error: Error) => void;
+    onMessage?: (message: ChatMessage) => void;
+    private _messages;
+    private _isRequesting;
+    private _error?;
+    private _lastInput?;
+    private _listeners;
+    constructor(provider: ChatProvider<TInput>);
+    private _wireCallbacks;
+    /**
+     * 发起请求
+     * 调用后 isRequesting = true，Provider 回调驱动后续状态转换
+     */
+    send(input: TInput, assistantMessageId?: string): void;
+    /** 中止当前请求 */
+    abort(): void;
+    /**
+     * Turn 级重试
+     *
+     * 找到最后一个 Turn，如果其 assistant message 处于 error / aborted 状态，
+     * 则删除该 assistant message，使用相同的 input 重新发送。
+     *
+     * Turn 从 messages 数组中派生，不额外存储。
+     */
+    retry(): void;
+    /** 是否可以重试（最后一个 Turn 有失败的 assistant message） */
+    canRetry(): boolean;
+    /** 手动添加一条消息（如用户消息、历史消息） */
+    addMessage(message: ChatMessage): void;
+    /** 批量设置消息列表（如加载历史、清空） */
+    setMessages(messages: ChatMessage[]): void;
+    getMessages(): ChatMessage[];
+    getIsRequesting(): boolean;
+    getSnapshot(): ChatSnapshot;
+    /**
+     * 订阅状态变更，返回取消订阅函数
+     * 适用于 useSyncExternalStore / useEffect 场景
+     */
+    subscribe(listener: () => void): () => void;
+    /** 清理所有订阅和 Provider 回调，防止内存泄漏 */
+    destroy(): void;
+    /**
+     * 从消息列表中派生最后一个 Turn
+     * Turn = 最后一条 user 消息 + 其后的 assistant 消息（若有）
+     */
+    private _getLastTurn;
+    private _notify;
+}