@aix-chat/core 0.1.0

package/dist/types/openclaw-blocks.d.ts

@@ -0,0 +1,77 @@
+/**
+ * OpenClaw 协议消息块类型
+ *
+ * 这是 OpenClawParser 的输出 schema，专属于 OpenClaw 协议。
+ * 其他协议定义各自的 block 类型，通过 Block 基础接口兼容。
+ */
+/** 工具执行状态 */
+export type ToolStatus = 'success' | 'error' | 'running' | 'pending';
+/** 审批状态 */
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected';
+/** 文本块 */
+export interface TextBlock {
+    type: 'text';
+    /** 文本内容（支持 Markdown） */
+    content: string;
+}
+/** 思考过程块 */
+export interface ThinkingBlock {
+    type: 'thinking';
+    /** 思考内容 */
+    content: string;
+    /** 是否正在思考中（显示加载态） */
+    isLoading?: boolean;
+}
+/** 工具执行步骤 */
+export interface ToolStep {
+    /** 步骤唯一标识 */
+    id: string;
+    /** 工具名称 */
+    tool: string;
+    /** 操作描述 */
+    title: string;
+    /** 执行状态 */
+    status: ToolStatus;
+    /** 执行耗时（毫秒） */
+    duration?: number;
+    /** 输入参数（JSON 字符串） */
+    input?: string;
+    /** 输出结果（JSON 字符串） */
+    output?: string;
+}
+/** 工具执行块 */
+export interface ToolExecutionBlock {
+    type: 'tool_execution';
+    /** 工具执行步骤列表 */
+    steps: ToolStep[];
+}
+/** 审批块 */
+export interface ApprovalBlock {
+    type: 'approval';
+    /** 审批 ID（用于回调标识） */
+    approvalId?: string;
+    /** 审批标题 */
+    title: string;
+    /** 审批描述 */
+    description: string;
+    /** 审批状态 */
+    status: ApprovalStatus;
+    /** 操作详情（可折叠显示） */
+    details?: string;
+    /** 批准回调 */
+    onApprove?: () => void;
+    /** 拒绝回调 */
+    onReject?: () => void;
+}
+/** 图片块 */
+export interface ImageBlock {
+    type: 'image';
+    /** 图片数据（Base64 Data URI） */
+    data: string;
+    /** 图片名称 */
+    name: string;
+    /** MIME 类型 */
+    mimeType: string;
+}
+/** OpenClaw 协议消息块联合类型 */
+export type OpenClawBlock = TextBlock | ThinkingBlock | ToolExecutionBlock | ApprovalBlock | ImageBlock;

package/dist/types/openclaw-blocks.js

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

package/dist/types/panel.d.ts

@@ -0,0 +1,71 @@
+export interface PanelTab {
+    /** Agent 定义的语义 ID，如 "main_flow" */
+    id: string;
+    title: string;
+    /** 对应注册的渲染器 key,如 "dag" */
+    type: string;
+    /** OC event 透传的数据,SDK 不解析 */
+    payload?: Record<string, any>;
+    /** 是否显示关闭按钮,默认 false */
+    closable?: boolean;
+    /**
+     * 该 tab 激活时,右栏 TopBar 右侧槽内容(操作按钮等)。
+     * 切换 tab 时随 activeTab 联动。类型为 ReactNode,core 不依赖 React 故用 unknown。
+     */
+    slotRight?: unknown;
+    /**
+     * 该 tab 关联的事件总线(可选),供 tab 内组件订阅/触发命名事件。
+     * 通常由 ChatBridge 维护,关闭 tab 时由消费方调用 removeAllListeners 清理。
+     * 为避免在 core 引入具体实现,使用 PanelTabEventEmitter 接口形式声明。
+     */
+    eventEmitter?: PanelTabEventEmitter;
+}
+/**
+ * Tab 事件总线最小接口,与 core/utils/EventEmitter 兼容。
+ */
+export interface PanelTabEventEmitter {
+    on(event: string, handler: (...args: any[]) => void): () => void;
+    emit(event: string, ...args: any[]): void;
+    removeAllListeners(event?: string): void;
+}
+export type PanelAction = {
+    type: 'send_message';
+    content: string;
+} | {
+    type: 'fill_input';
+    content: string;
+};
+export interface PanelActionEvent {
+    event: 'panel_action';
+    /** 语义 ID：首次出现新建 tab，已存在则更新 payload */
+    tabId: string;
+    /** 仅首次建 tab 时必须提供 */
+    type?: string;
+    /** 无则自动生成，如 "Panel 1" */
+    title?: string;
+    /** SDK 级别容器指令 */
+    panelCommand?: 'expand' | 'collapse';
+    /** 透传给组件，SDK 不解析 */
+    payload?: Record<string, any>;
+}
+export interface PanelHandle {
+    openTab(tab: PanelTab): void;
+    closeTab(id: string): void;
+    updateTab(id: string, update: Partial<Omit<PanelTab, 'id'>>): void;
+    focusTab(id: string): void;
+    openPanel(): void;
+    closePanel(): void;
+    /** 强制关闭面板并清空所有 tabs */
+    closePanelForce(): void;
+    /**
+     * 取出完整上下文并清空交互缓冲。
+     * 发消息前调用，将返回值作为 panelContext 注入请求。
+     */
+    flushContext(): import('./context').AixContext;
+}
+export interface PanelEvent {
+    /** 事件类型，如 'highlight-node', 'reset-view' */
+    type: string;
+    /** 事件数据，任意结构 */
+    payload?: Record<string, any>;
+}

package/dist/types/panel.js

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

package/dist/types/protocol.d.ts

@@ -0,0 +1,48 @@
+import type { OpenClawBlock } from './openclaw-blocks';
+import type { ApprovalRequestPayload, ToolCallInfo } from './message';
+/**
+ * 协议解析结果
+ *
+ * 结构化输出，不包含任何 HTML 标签。
+ * UI 层根据 blocks 数组渲染对应组件。
+ */
+export interface ParseResult {
+    /** 结构化内容块（OpenClaw 协议输出） */
+    blocks: OpenClawBlock[];
+    /** 纯文本内容（向后兼容，从 TextBlock 拼接生成） */
+    content: string;
+    /** 是否完成 */
+    done: boolean;
+    /** 工具调用列表（结构化数据） */
+    toolCalls: ToolCallInfo[];
+    /** 会话 key */
+    sessionKey?: string;
+    /** 是否有待审批 */
+    isApproval?: boolean;
+    /** 审批请求数据 */
+    approvalRequest?: ApprovalRequestPayload;
+    /** inject 消息的 runId（以 'inject-' 开头），用于区分不同的 inject 消息 */
+    runId?: string;
+}
+/**
+ * 协议解析器接口
+ *
+ * 接收 WebSocket 原始事件，输出结构化 ParseResult。
+ * 不生成任何 HTML 标签，渲染决策交给 UI 层。
+ */
+export interface ProtocolParser<TInput = any> {
+    /** 处理原始消息事件 */
+    handleMessage(message: Record<string, any>): boolean;
+    /** 构造请求消息 */
+    buildRequest(params: TInput): Record<string, any>;
+    /** 获取当前解析结果 */
+    getResult(): ParseResult;
+    /** 重置状态 */
+    reset(): void;
+    /** 更新回调 */
+    onUpdate?: (result: ParseResult) => void;
+    /** 完成回调 */
+    onComplete?: (result: ParseResult) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+}

package/dist/types/protocol.js

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

package/dist/types/provider.d.ts

@@ -0,0 +1,15 @@
+import type { ChatMessage } from './message';
+/**
+ * Provider 接口 — 暴露给 Chat 实体
+ * 具体实现（OpenClawProvider、SSEProvider 等）位于 @aix-chat/adapters
+ */
+export interface ChatProvider<TInput = any> {
+    connect(): Promise<void>;
+    disconnect(): void;
+    readonly isConnected: boolean;
+    request(params: TInput, messageId?: string): Promise<void>;
+    abort(): void;
+    onMessage?: (message: ChatMessage) => void;
+    onComplete?: (messages: ChatMessage[]) => void;
+    onError?: (error: Error) => void;
+}

package/dist/types/provider.js

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

package/dist/utils/EventEmitter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 简单的事件发射器
+ */
+export declare class EventEmitter {
+    private listeners;
+    /**
+     * 监听事件
+     */
+    on(event: string, handler: (...args: any[]) => void): () => void;
+    /**
+     * 触发事件
+     */
+    emit(event: string, ...args: any[]): void;
+    /**
+     * 移除所有监听器
+     */
+    removeAllListeners(): void;
+}

package/dist/utils/EventEmitter.js

@@ -0,0 +1,65 @@
+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); }
+/**
+ * 简单的事件发射器
+ */
+export var EventEmitter = /*#__PURE__*/function () {
+  function EventEmitter() {
+    _classCallCheck(this, EventEmitter);
+    _defineProperty(this, "listeners", new Map());
+  }
+  _createClass(EventEmitter, [{
+    key: "on",
+    value:
+    /**
+     * 监听事件
+     */
+    function on(event, handler) {
+      if (!this.listeners.has(event)) {
+        this.listeners.set(event, []);
+      }
+      var handlers = this.listeners.get(event);
+      handlers.push(handler);
+
+      // 返回取消订阅函数
+      return function () {
+        var idx = handlers.indexOf(handler);
+        if (idx > -1) {
+          handlers.splice(idx, 1);
+        }
+      };
+    }
+
+    /**
+     * 触发事件
+     */
+  }, {
+    key: "emit",
+    value: function emit(event) {
+      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+        args[_key - 1] = arguments[_key];
+      }
+      var handlers = this.listeners.get(event);
+      if (handlers) {
+        handlers.forEach(function (handler) {
+          return handler.apply(void 0, args);
+        });
+      }
+    }
+
+    /**
+     * 移除所有监听器
+     */
+  }, {
+    key: "removeAllListeners",
+    value: function removeAllListeners() {
+      this.listeners.clear();
+    }
+  }]);
+  return EventEmitter;
+}();

package/dist/utils/InteractionBuffer.d.ts

@@ -0,0 +1,17 @@
+import type { InteractionRecord } from '../types/interaction';
+/**
+ * InteractionBuffer
+ *
+ * 收集副屏用户交互记录的缓冲区。纯 JS 工具类，无 React 依赖。
+ * 消费方自行决定何时调用 flush() 及如何处理数据（上报埋点、注入请求、本地展示等）。
+ */
+export declare class InteractionBuffer {
+    private _records;
+    push(record: Omit<InteractionRecord, 'id' | 'timestamp'>): void;
+    /** 返回并清空所有记录 */
+    flush(): InteractionRecord[];
+    /** 只读预览，不清空 */
+    peek(): InteractionRecord[];
+    clear(): void;
+    get size(): number;
+}

package/dist/utils/InteractionBuffer.js

@@ -0,0 +1,64 @@
+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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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); }
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * InteractionBuffer
+ *
+ * 收集副屏用户交互记录的缓冲区。纯 JS 工具类，无 React 依赖。
+ * 消费方自行决定何时调用 flush() 及如何处理数据（上报埋点、注入请求、本地展示等）。
+ */
+export var InteractionBuffer = /*#__PURE__*/function () {
+  function InteractionBuffer() {
+    _classCallCheck(this, InteractionBuffer);
+    _defineProperty(this, "_records", []);
+  }
+  _createClass(InteractionBuffer, [{
+    key: "push",
+    value: function push(record) {
+      this._records.push(_objectSpread({
+        id: uuidv4(),
+        timestamp: Date.now()
+      }, record));
+    }
+
+    /** 返回并清空所有记录 */
+  }, {
+    key: "flush",
+    value: function flush() {
+      var records = this._records;
+      this._records = [];
+      return records;
+    }
+
+    /** 只读预览，不清空 */
+  }, {
+    key: "peek",
+    value: function peek() {
+      return _toConsumableArray(this._records);
+    }
+  }, {
+    key: "clear",
+    value: function clear() {
+      this._records = [];
+    }
+  }, {
+    key: "size",
+    get: function get() {
+      return this._records.length;
+    }
+  }]);
+  return InteractionBuffer;
+}();

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@aix-chat/core",
+  "version": "0.1.0",
+  "description": "Aix-Chat 核心业务逻辑包，提供聊天会话管理、消息处理、插件扩展等核心能力",
+  "keywords": [
+    "chat",
+    "ai",
+    "conversation",
+    "message",
+    "plugin",
+    "aix",
+    "alipay"
+  ],
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://github.com/alipay/Aix-Chat-Packages/tree/master/packages/core",
+  "bugs": {
+    "url": "https://github.com/alipay/Aix-Chat-Packages/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aix-chat/aix-chat"
+  },
+  "author": "yubai.zly",
+  "module": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "libType": "UTIL",
+  "scripts": {
+    "build": "father build",
+    "build:watch": "father build -w",
+    "ci": "npm run lint && jest --coverage --passWithNoTests",
+    "cov": "jest --coverage",
+    "dev": "dumi dev",
+    "lint": "eslint src --ext .ts,.tsx",
+    "start": "npm run dev",
+    "test": "jest",
+    "typecheck": "tsc --noEmit"
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "lint-staged": {
+    "*.{md,json}": [
+      "prettier --cache --write --no-error-on-unmatched-pattern"
+    ],
+    "*.{js,jsx}": [
+      "eslint --fix",
+      "prettier --cache --write"
+    ],
+    "*.{css,less}": [
+      "prettier --cache --write"
+    ],
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --cache --parser=typescript --write"
+    ]
+  },
+  "dependencies": {
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^17.3.0",
+    "@commitlint/config-conventional": "^17.3.0",
+    "@types/jest": "^29.4.0",
+    "@types/uuid": "^10.0.0",
+    "dumi": "^2.0.0",
+    "father": "^4.0.0",
+    "husky": "^8.0.0",
+    "jest": "^29.4.3",
+    "jest-environment-jsdom": "^29.4.3",
+    "lint-staged": "^13.0.0",
+    "prettier": "^2.0.0"
+  },
+  "engines": {},
+  "ci": {
+    "type": "aci"
+  },
+  "tnpm": {
+    "mode": "npm"
+  },
+  "main": "dist/index.js"
+}