@prur/dsh-chat-service 0.1.17 → 0.3.0

package/lib/events.d.ts

@@ -11,6 +11,15 @@
 import type { Context } from '@deepseek-ai/cordis';
 /** The three chat events a client may receive on the downlink. */
 export type ChatDownlinkEvent = 'chat/message' | 'chat/chunk' | 'chat/status';
+/** Cross-plugin cordis event emitted when a chat turn completes (B4 E2E push hook). */
+export interface ChatTurnEndEvent {
+    conversationId: string;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        'chat/turn-end'(evt: ChatTurnEndEvent): void;
+    }
+}
 /**
  * Downlink frame: the full `server-request` envelope the DSH downlink
  * transport uses (exact same shape as `/api/events.host` remote-event

package/lib/events.js

@@ -15,6 +15,8 @@ import WebSocket, { WebSocketServer } from 'ws';
 export const CHAT_EVENTS_PATH = '/chat/events';
 /** Heartbeat interval; keeps proxies from dropping an idle downlink. */
 const HEARTBEAT_INTERVAL_MS = 15_000;
+/** /chat/events 下行背压水位：客户端 ws `bufferedAmount` 超过该值视为慢性慢消费者，断开让其重连 + 历史基线回填自愈。 */
+const CHAT_DOWNLINK_BACKPRESSURE_BYTES = 16 * 1024 * 1024;
 /**
  * In-process event bus. The service publishes; the gateway subscribes and
  * broadcasts to every connected client. Synchronous, listener failures are
@@ -82,8 +84,16 @@ export class ChatEventsGateway {
     broadcast(frame) {
         const payload = JSON.stringify(frame);
         for (const client of this.clients) {
-            if (client.readyState === WebSocket.OPEN)
-                client.send(payload);
+            if (client.readyState !== WebSocket.OPEN)
+                continue;
+            // 慢消费者背压：ws send 缓冲区（bufferedAmount）无界增长会令宿主进程内存滞留到 OOM
+            // （手机经中继弱网消费慢）。超过水位即断开该客户端——其重连后经 chat/history 尾页基线
+            // + chat/status 快照回填自愈，不因积压把宿主进程拖垮。
+            if (client.bufferedAmount > CHAT_DOWNLINK_BACKPRESSURE_BYTES) {
+                client.terminate();
+                continue;
+            }
+            client.send(payload);
         }
     }
     handleUpgrade(req, socket, head) {

package/lib/index.d.ts

@@ -54,6 +54,8 @@ export declare class ChatService extends TypertRemoteService {
     private readonly runners;
     private readonly bus;
     private readonly gateway;
+    /** Cordis context for emitting cross-plugin events (e.g. chat turn completion for push). */
+    private _ctx;
     constructor(ctx: Context, config: ChatServiceConfig);
     /** Re-run queued sends and settle half-finished conversations on startup. */
     private recover;

package/lib/index.js

@@ -140,8 +140,11 @@ let ChatService = (() => {
         runners = new Map();
         bus = new ChatEventBus();
         gateway;
+        /** Cordis context for emitting cross-plugin events (e.g. chat turn completion for push). */
+        _ctx;
         constructor(ctx, config) {
             super(ctx, 'chat');
+            this._ctx = ctx;
             this.gateway = new ChatEventsGateway(ctx, config.trustedHosts, config.apiToken);
             this.bus.subscribe(frame => this.gateway.broadcast(frame));
             // Recover pending queues after a host restart: a half-finished turn can
@@ -564,6 +567,12 @@ let ChatService = (() => {
         }
         emitStatus(conversationId, status) {
             this.bus.publish('chat/status', [conversationId, status]);
+            // B4 E2E: on a real turn completion (running→false, not user-aborted), broadcast a
+            // cross-plugin cordis event so the push-bridge can emit a wake-up push carrying the
+            // conversationId (client routes to the Chat surface).
+            if (status.running === false && status.reason !== 'aborted') {
+                this._ctx.emit('chat/turn-end', { conversationId });
+            }
         }
     };
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prur/dsh-chat-service",
-  "version": "0.1.17",
+  "version": "0.3.0",
   "description": "Typert Remote namespace exposing a plain streaming model chat (no agent loop) to DSH Mobile clients",
   "repository": {
     "type": "git",
@@ -35,7 +35,7 @@
     "@deepseek-ai/schemastery": "^3.18.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@prur/dsh-client-connection-mobile": "^0.1.17"
+    "@prur/dsh-client-connection-mobile": "^0.3.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",