wtfai 1.5.6 → 1.5.8

package/README.md

@@ -34,7 +34,7 @@ const client = new Wtfai({
 const session = client.createSession('workflow-id')
 
 // 3. 发送消息
-await session.send({ content: '你好' })
+await session.send({ parts: [{ type: 'text', text: '你好' }] })
 ```
 
 ## API 文档
@@ -442,6 +442,128 @@ const url = await IframeBridge.uploadFile(file, {
 
 ---
 
+### Session Data CRUD API
+
+用于会话级数据的持久化存储，与 `saveData/loadData` 不同，这是一套完整的 CRUD 接口，支持集合（Collection）概念，适合存储结构化数据。
+
+> **与 saveData/loadData 的区别**：
+> - `saveData/loadData` 存储在工作流 state 中（适合简单 key-value）
+> - Session Data API 存储在独立数据表中（适合结构化数据、列表数据）
+
+#### `IframeBridge.createRecord(collection, data)`
+
+在指定集合中创建一条记录。
+
+```javascript
+const id = await IframeBridge.createRecord('notes', {
+  title: 'My Note',
+  content: 'Hello World',
+  createdAt: Date.now()
+});
+console.log('创建成功, ID:', id);
+```
+
+#### `IframeBridge.getRecord(collection, id)`
+
+获取单条记录。
+
+```javascript
+const data = await IframeBridge.getRecord('notes', id);
+if (data) {
+  console.log('记录内容:', data.title, data.content);
+} else {
+  console.log('记录不存在');
+}
+```
+
+#### `IframeBridge.updateRecord(collection, id, data)`
+
+更新记录（完整替换）。
+
+```javascript
+await IframeBridge.updateRecord('notes', id, {
+  title: 'Updated Title',
+  content: 'New content',
+  updatedAt: Date.now()
+});
+```
+
+#### `IframeBridge.deleteRecord(collection, id)`
+
+删除单条记录。
+
+```javascript
+await IframeBridge.deleteRecord('notes', id);
+```
+
+#### `IframeBridge.listRecords(collection, options?)`
+
+分页查询集合中的记录。
+
+```javascript
+const result = await IframeBridge.listRecords('notes', {
+  page: 1,
+  pageSize: 10
+});
+console.log(`共 ${result.total} 条记录`);
+result.records.forEach(r => {
+  console.log(r.id, r.data.title);
+});
+```
+
+#### `IframeBridge.clearCollection(collection)`
+
+清空集合中的所有记录。
+
+```javascript
+const count = await IframeBridge.clearCollection('notes');
+console.log(`已删除 ${count} 条记录`);
+```
+
+**使用场景**：
+- 待办事项列表
+- 用户收藏/历史记录
+- 表单草稿
+- 游戏存档
+
+---
+
+## HTTP API
+
+以下 API 可直接通过 HTTP 调用，无需使用 SDK。
+
+### 中断工作流执行
+
+中断正在运行的工作流。工作流会返回 `error` 事件携带中断原因后关闭连接。
+
+**请求**
+
+```http
+POST /workflows/:workflowId/interrupt
+Content-Type: application/json
+
+{
+  "threadId": "会话ID",
+  "reason": "中断原因"
+}
+```
+
+**响应**
+
+```json
+{
+  "success": true,
+  "local": true  // true=本地实例中断, false=通过集群广播
+}
+```
+
+**说明**：
+- 支持集群模式，会通过 Redis Pub/Sub 广播中断信号到所有实例
+- 工作流被中断后会触发 `error` 事件，`message` 为传入的 `reason`
+- 如果找不到对应的执行会话，返回 404
+
+---
+
 ### UploadService
 
 文件上传服务（通过 `client.upload` 访问）。

package/dist/iframe-bridge.js

@@ -52,9 +52,28 @@ class IframeBridgeHost {
                 const [title] = params;
                 await this.session.updateSessionTitle(title);
                 result = true;
-            } else if ('uploadFile' === method) {
+            } else if ('getSessionId' === method) result = this.session.getState().threadId;
+            else if ('uploadFile' === method) {
                 const [options] = params;
                 result = await this.session.uploadFileFromIframe(options);
+            } else if ('createRecord' === method) {
+                const [collection, data] = params;
+                result = await this.session.createRecord(collection, data);
+            } else if ('getRecord' === method) {
+                const [collection, id] = params;
+                result = await this.session.getRecord(collection, id);
+            } else if ('updateRecord' === method) {
+                const [collection, id, data] = params;
+                result = await this.session.updateRecord(collection, id, data);
+            } else if ('deleteRecord' === method) {
+                const [collection, id] = params;
+                result = await this.session.deleteRecord(collection, id);
+            } else if ('listRecords' === method) {
+                const [collection, options] = params;
+                result = await this.session.listRecords(collection, options);
+            } else if ('clearCollection' === method) {
+                const [collection] = params;
+                result = await this.session.clearCollection(collection);
             } else {
                 const userMethods = this.session.getIframeMethods();
                 const fn = userMethods[method];
@@ -78,7 +97,14 @@ class IframeBridgeHost {
             'hasMethod',
             'executeWorkflow',
             'uploadFile',
-            'updateSessionTitle'
+            'updateSessionTitle',
+            'getSessionId',
+            'createRecord',
+            'getRecord',
+            'updateRecord',
+            'deleteRecord',
+            'listRecords',
+            'clearCollection'
         ];
         if (builtIns.includes(methodName)) return true;
         const userMethods = this.session.getIframeMethods();

package/dist/session.d.ts

@@ -71,6 +71,54 @@ export declare class WorkflowSession {
      * @param title 新的标题
      */
     updateSessionTitle(title: string): Promise<void>;
+    /**
+     * 创建数据记录
+     * @param collection 集合名称
+     * @param data 数据内容
+     * @returns 新创建记录的 ID
+     */
+    createRecord(collection: string, data: Record<string, unknown>): Promise<string>;
+    /**
+     * 获取数据记录
+     * @param collection 集合名称
+     * @param id 记录 ID
+     * @returns 记录数据，不存在时返回 null
+     */
+    getRecord(collection: string, id: string): Promise<Record<string, unknown> | null>;
+    /**
+     * 更新数据记录
+     * @param collection 集合名称
+     * @param id 记录 ID
+     * @param data 新的数据内容
+     */
+    updateRecord(collection: string, id: string, data: Record<string, unknown>): Promise<void>;
+    /**
+     * 删除数据记录
+     * @param collection 集合名称
+     * @param id 记录 ID
+     */
+    deleteRecord(collection: string, id: string): Promise<void>;
+    /**
+     * 列表查询数据记录
+     * @param collection 集合名称
+     * @param options 分页选项
+     */
+    listRecords(collection: string, options?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        records: Array<{
+            id: string;
+            data: Record<string, unknown>;
+        }>;
+        total: number;
+    }>;
+    /**
+     * 清空集合中的所有数据
+     * @param collection 集合名称
+     * @returns 被删除的记录数量
+     */
+    clearCollection(collection: string): Promise<number>;
     /**
      * 执行指定的工作流（临时/嵌套执行），工作流需要使用消息生成组件来生成消息供收集
      * 不会影响当前会话的状态（messages 等）

package/dist/session.js

@@ -158,6 +158,90 @@ class WorkflowSession {
             }, this.headers).catch(reject);
         });
     }
+    async createRecord(collection, data) {
+        this.assertNotDisposed();
+        if (!this.state.threadId) throw new Error('No active session (missing threadId)');
+        const response = await fetch(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers
+            },
+            body: JSON.stringify({
+                threadId: this.state.threadId,
+                data
+            })
+        });
+        if (!response.ok) throw new Error('Failed to create record');
+        const result = await response.json();
+        return result.id;
+    }
+    async getRecord(collection, id) {
+        this.assertNotDisposed();
+        if (!this.state.threadId) throw new Error('No active session (missing threadId)');
+        const url = new URL(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`);
+        url.searchParams.set('threadId', this.state.threadId);
+        const response = await fetch(url.toString(), {
+            headers: this.headers
+        });
+        if (404 === response.status) return null;
+        if (!response.ok) throw new Error('Failed to get record');
+        const result = await response.json();
+        return result.data;
+    }
+    async updateRecord(collection, id, data) {
+        this.assertNotDisposed();
+        if (!this.state.threadId) throw new Error('No active session (missing threadId)');
+        const response = await fetch(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`, {
+            method: 'PUT',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers
+            },
+            body: JSON.stringify({
+                threadId: this.state.threadId,
+                data
+            })
+        });
+        if (!response.ok) throw new Error('Failed to update record');
+    }
+    async deleteRecord(collection, id) {
+        this.assertNotDisposed();
+        if (!this.state.threadId) throw new Error('No active session (missing threadId)');
+        const url = new URL(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`);
+        url.searchParams.set('threadId', this.state.threadId);
+        const response = await fetch(url.toString(), {
+            method: 'DELETE',
+            headers: this.headers
+        });
+        if (!response.ok) throw new Error('Failed to delete record');
+    }
+    async listRecords(collection, options) {
+        this.assertNotDisposed();
+        if (!this.state.threadId) throw new Error('No active session (missing threadId)');
+        const url = new URL(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}`);
+        url.searchParams.set('threadId', this.state.threadId);
+        if (null == options ? void 0 : options.page) url.searchParams.set('page', String(options.page));
+        if (null == options ? void 0 : options.pageSize) url.searchParams.set('pageSize', String(options.pageSize));
+        const response = await fetch(url.toString(), {
+            headers: this.headers
+        });
+        if (!response.ok) throw new Error('Failed to list records');
+        return response.json();
+    }
+    async clearCollection(collection) {
+        this.assertNotDisposed();
+        if (!this.state.threadId) throw new Error('No active session (missing threadId)');
+        const url = new URL(`${this.baseUrl}/workflows/${this.workflowId}/data/${encodeURIComponent(collection)}`);
+        url.searchParams.set('threadId', this.state.threadId);
+        const response = await fetch(url.toString(), {
+            method: 'DELETE',
+            headers: this.headers
+        });
+        if (!response.ok) throw new Error('Failed to clear collection');
+        const result = await response.json();
+        return result.deleted;
+    }
     async executeWorkflow(workflowId, input) {
         this.assertNotDisposed();
         const { parts: inputParts, ...rest } = input;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfai",
-  "version": "1.5.6",
+  "version": "1.5.8",
   "type": "module",
   "exports": {
     ".": {
@@ -13,26 +13,26 @@
     "dist"
   ],
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
+    "@eslint/js": "^9.39.3",
     "@rsbuild/plugin-react": "^1.4.5",
-    "@rslib/core": "^0.19.5",
-    "@types/react": "^19.2.13",
-    "eslint": "^9.39.2",
+    "@rslib/core": "^0.19.6",
+    "@types/react": "^19.2.14",
+    "eslint": "^9.39.3",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "globals": "^17.3.0",
     "prettier": "^3.8.1",
     "react": "^19.2.4",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.54.0"
+    "typescript-eslint": "^8.56.1"
   },
   "peerDependencies": {
     "react": ">=16.9.0",
     "react-dom": ">=16.9.0"
   },
   "dependencies": {
-    "@ant-design/x": "^2.2.1",
-    "@ant-design/x-markdown": "^2.2.1",
+    "@ant-design/x": "^2.2.2",
+    "@ant-design/x-markdown": "^2.2.2",
     "@microsoft/fetch-event-source": "^2.0.1",
     "clsx": "^2.1.1",
     "compressorjs": "^1.2.1",