wtfai 1.5.7 → 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,7 +52,8 @@ 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) {
@@ -97,6 +98,7 @@ class IframeBridgeHost {
             'executeWorkflow',
             'uploadFile',
             'updateSessionTitle',
+            'getSessionId',
             'createRecord',
             'getRecord',
             'updateRecord',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfai",
-  "version": "1.5.7",
+  "version": "1.5.8",
   "type": "module",
   "exports": {
     ".": {
@@ -13,18 +13,18 @@
     "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",