wtfai 1.8.0 → 1.8.2

package/README.md

@@ -680,6 +680,50 @@ Content-Type: application/json
 
 ---
 
+---
+
+### RealtimeService
+
+提供跨端的实时消息总线功能（通过 `client.realtime` 访问）。
+
+##### `subscribe(topic: string, onEvent: (event: RealtimeEvent) => void)`
+
+订阅实时消息流。适合大屏端监听由其他端发送的指令或通知。
+
+- **自动管理**：方法内部会自动计算并附加当前浏览器的设备指纹（deviceId），激活在线状态追踪。
+- **返回值**：返回一个对象，包含 `unsubscribe()` 方法用于断开连接。
+
+```typescript
+const sub = await client.realtime.subscribe('class:101', (event) => {
+  console.log('收到实时更新:', event.data);
+  // event.event 为事件名称，event.data 为业务数据
+});
+
+// 当页面销毁或不需要监听时，请务必手动释放：
+// sub.unsubscribe();
+```
+
+##### `push(topic: string, event: string, data: any)`
+
+推送实时消息。适合手机端（或其他客户端）发送指令。
+
+```typescript
+await client.realtime.push('class:101', 'msgA', {
+  foo: 'bar'
+});
+```
+
+##### `getPresence(topic: string)`
+
+获取指定主题下的在线状态详情（如当前有多少个大屏在线）。
+
+```typescript
+const { onlineCount, clients } = await client.realtime.getPresence('class:101');
+console.log(`当前在线设备数: ${onlineCount}`);
+```
+
+---
+
 ### UploadService
 
 文件上传服务（通过 `client.upload` 访问）。

package/dist/client.d.ts

@@ -2,6 +2,7 @@ import type { Workflow, WorkflowListResponse, DeviceInfo } from '@our-llm/shared
 import type { ClientConfig, SessionOptions } from './types';
 import { WorkflowSession } from './session';
 import { UploadService } from './upload';
+import { RealtimeService } from './realtime';
 /**
  * Wtfai 客户端
  *
@@ -33,6 +34,10 @@ export declare class Wtfai {
      * 文件上传服务
      */
     readonly upload: UploadService;
+    /**
+     * 实时同步服务
+     */
+    readonly realtime: RealtimeService;
     private readonly headers;
     constructor(config: ClientConfig);
     /**

package/dist/client.js

@@ -1,6 +1,7 @@
 import { getDeviceInfo } from "@our-llm/shared/fingerprint";
 import { WorkflowSession } from "./session.js";
 import { UploadService } from "./upload.js";
+import { RealtimeService } from "./realtime.js";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -40,8 +41,9 @@ class Wtfai {
         _define_property(this, "baseUrl", void 0);
         _define_property(this, "uploadService", void 0);
         _define_property(this, "upload", void 0);
+        _define_property(this, "realtime", void 0);
         _define_property(this, "headers", void 0);
-        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.baseUrl = (config.baseUrl || 'https://llm-api.ourschool.cc').replace(/\/$/, '');
         const headers = {
             ...config.headers
         };
@@ -52,6 +54,7 @@ class Wtfai {
         this.headers = headers;
         this.uploadService = new UploadService(this.baseUrl, this.headers);
         this.upload = this.uploadService;
+        this.realtime = new RealtimeService(this.baseUrl, this.headers);
     }
 }
 export { Wtfai };

package/dist/index.d.ts

@@ -2,7 +2,8 @@ import { Wtfai } from './client';
 export default Wtfai;
 export { WorkflowSession } from './session';
 export { UploadService } from './upload';
+export { RealtimeService } from './realtime';
 export type { ClientConfig, SessionOptions, SessionState, SessionEventListeners, SendInput, UploadParams, UploadImageParams, CompressOptions, WorkflowInfo, ContentPart, ContentAction, } from './types';
-export type { SimpleMessage, Workflow, WorkflowConfig, } from '@our-llm/shared/types';
+export type { SimpleMessage, Workflow, WorkflowConfig, RealtimeEvent, RealtimePresence, RealtimePushDto, } from '@our-llm/shared/types';
 export { Markdown, type MarkdownProps, WorkflowRegistry } from './ui/markdown';
 export type { WorkflowInfoMapping } from './ui/context';

package/dist/index.js

@@ -2,5 +2,6 @@ import { Wtfai } from "./client.js";
 const src = Wtfai;
 export { WorkflowSession } from "./session.js";
 export { UploadService } from "./upload.js";
+export { RealtimeService } from "./realtime.js";
 export { Markdown, WorkflowRegistry } from "./ui/markdown.js";
 export default src;

package/dist/realtime.d.ts

@@ -0,0 +1,23 @@
+import type { RealtimeEvent, RealtimePresence } from '@our-llm/shared/types';
+export declare class RealtimeService {
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(baseUrl: string, headers: Record<string, string>);
+    /**
+     * 订阅实时消息流 (适合大屏端)
+     * @param topic 主题名称
+     * @param onEvent 事件回调
+     * @returns 返回一个包含 unsubscribe 方法的对象
+     */
+    subscribe(topic: string, onEvent: (event: RealtimeEvent) => void): Promise<{
+        unsubscribe: () => void;
+    }>;
+    /**
+     * 推送实时消息 (适合手机端)
+     */
+    push(topic: string, event: string, data: any): Promise<void>;
+    /**
+     * 获取当前主题的在线状态
+     */
+    getPresence(topic: string): Promise<RealtimePresence>;
+}

package/dist/realtime.js

@@ -0,0 +1,76 @@
+import { fetchEventSource } from "@microsoft/fetch-event-source";
+import { getFingerprint } from "@our-llm/shared/fingerprint";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class RealtimeService {
+    async subscribe(topic, onEvent) {
+        const deviceId = await getFingerprint();
+        const controller = new AbortController();
+        const query = `?deviceId=${encodeURIComponent(deviceId)}`;
+        const url = `${this.baseUrl}/workflows/realtime/streams/${topic}${query}`;
+        fetchEventSource(url, {
+            method: 'GET',
+            headers: {
+                Accept: 'text/event-stream',
+                ...this.headers
+            },
+            signal: controller.signal,
+            onmessage (msg) {
+                if (!msg.data) return;
+                if ('message' === msg.event || !msg.event) try {
+                    const event = JSON.parse(msg.data);
+                    onEvent(event);
+                } catch (e) {
+                    console.error('[SDK Realtime] Failed to parse message', e);
+                }
+            },
+            onerror (err) {
+                console.error('[SDK Realtime] Connection error', err);
+            }
+        });
+        return {
+            unsubscribe: ()=>{
+                controller.abort();
+            }
+        };
+    }
+    async push(topic, event, data) {
+        const dto = {
+            topic,
+            event,
+            data
+        };
+        const response = await fetch(`${this.baseUrl}/workflows/realtime/push`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers
+            },
+            body: JSON.stringify(dto)
+        });
+        if (!response.ok) throw new Error(`推送实时消息失败: ${response.statusText}`);
+    }
+    async getPresence(topic) {
+        const response = await fetch(`${this.baseUrl}/workflows/realtime/presence/${topic}`, {
+            method: 'GET',
+            headers: this.headers
+        });
+        if (!response.ok) throw new Error(`获取在线状态失败: ${response.statusText}`);
+        return response.json();
+    }
+    constructor(baseUrl, headers){
+        _define_property(this, "baseUrl", void 0);
+        _define_property(this, "headers", void 0);
+        this.baseUrl = baseUrl;
+        this.headers = headers;
+    }
+}
+export { RealtimeService };

package/dist/types.d.ts

@@ -2,8 +2,8 @@
  * SDK 配置类型
  */
 export interface ClientConfig {
-    /** API 服务器地址 */
-    baseUrl: string;
+    /** API 服务器地址，默认为 https://llm-api.ourschool.cc */
+    baseUrl?: string;
     /** 请求超时时间（毫秒） */
     timeout?: number;
     /** 自定义请求头 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfai",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "type": "module",
   "exports": {
     ".": {