palz-connector 1.3.3 → 1.3.4

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "palz-connector",
   "name": "Palz Connector Channel",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Palz IM 接入 OpenClaw",
   "channels": [
     "palz-connector"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palz-connector",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "type": "module",
   "main": "index.ts",
   "description": "Palz IM 接入 OpenClaw — 模块化架构，基于 OpenClaw Runtime 消息管道",

package/palz-connector.config.json

@@ -4,5 +4,5 @@
   "apiBaseUrl": "http://14.103.148.99:8090/api",
   "sessionTimeout": 1800000,
   "groupContextCache": true,
-  "showProcess":true
+  "showProcess": true
 }

package/palz-connector.dev.config.json

@@ -4,5 +4,5 @@
   "apiBaseUrl": "https://claw-server.csaiagent.com/api",
   "sessionTimeout": 1800000,
   "groupContextCache": true,
-  "showProcess":true
+  "showProcess": true
 }

package/palz-connector.prod.config.json

@@ -4,5 +4,5 @@
   "apiBaseUrl": "https://claw-server.csagentai.com/api",
   "sessionTimeout": 1800000,
   "groupContextCache": true,
-  "showProcess":true
+  "showProcess": true
 }

package/palz-connector.staging.config.json

@@ -4,5 +4,5 @@
   "apiBaseUrl": "https://claw-server.csjkagent.com/api",
   "sessionTimeout": 1800000,
   "groupContextCache": true,
-  "showProcess":true
+  "showProcess": true
 }

package/src/reply-dispatcher.ts

@@ -72,6 +72,22 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
   const streamState = enableStreaming ? createStreamingState() : null;
   const tag = `palz[${accountId}]`;
 
+  // 会话级串行队列：保证同一会话内 IM 消息按入队顺序到达
+  // (不同 dispatcher 实例对应不同会话，天然隔离)
+  let imSendQueue: Promise<unknown> = Promise.resolve();
+  const enqueueIMSend = (
+    content: OpenAIContent,
+    streamOpts: StreamChunkOpts | undefined,
+    palzMsgType: string | undefined,
+    label: string,
+  ): Promise<unknown> => {
+    const next = imSendQueue.then(() => sendToIM(content, streamOpts, palzMsgType)).catch((err: any) => {
+      error(`${tag}: [IM_QUEUE] ${label} 发送失败: ${err?.message ?? String(err)}`);
+    });
+    imSendQueue = next;
+    return next;
+  };
+
   log(
     `${tag}: [DISPATCHER 创建] conv=${conversationId} sender=${senderId} streaming=${enableStreaming}${streamState ? ` streamId=${streamState.streamId}` : ""}`,
   );
@@ -131,9 +147,7 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
             const display = resolveToolDisplay(toolName, data.args);
             const text = formatToolStartText(toolName, data.args);
             log(`${tag}: [TOOL_EVENTS] tool_start name=${toolName} detail=${display.detail ?? "(none)"}`);
-            sendToIM(text, undefined, "tool_start").catch((err: any) => {
-              error(`${tag}: [TOOL_EVENTS] tool_start 发送失败: ${err.message}`);
-            });
+            enqueueIMSend(text, undefined, "tool_start", "tool_start");
           }
 
           if (phase === "result") {
@@ -142,9 +156,7 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
             const text = formatToolResultText(toolName, data.result, isError, meta);
             const resultSummary = isError ? "Error" : formatResultSummary(data.result);
             log(`${tag}: [TOOL_EVENTS] tool_result name=${toolName} is_error=${isError} summary=${resultSummary}`);
-            sendToIM(text, undefined, "tool_result").catch((err: any) => {
-              error(`${tag}: [TOOL_EVENTS] tool_result 发送失败: ${err.message}`);
-            });
+            enqueueIMSend(text, undefined, "tool_result", "tool_result");
           }
         }
       });
@@ -201,18 +213,24 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
 
         if (streamState && kind === "final" && typeof content === "string") {
           const delta = content.slice(streamState.lastSentLength);
+          const seq = streamState.seq++;
           log(
-            `${tag}: [DELIVER 流式最终] seq=${streamState.seq} totalLen=${content.length} deltaLen=${delta.length} delta="${delta.slice(0, 120)}"`,
+            `${tag}: [DELIVER 流式最终] seq=${seq} totalLen=${content.length} deltaLen=${delta.length} delta="${delta.slice(0, 120)}"`,
+          );
+          await enqueueIMSend(
+            content,
+            {
+              streamId: streamState.streamId,
+              seq,
+              isFinal: true,
+              delta,
+            },
+            undefined,
+            `final seq=${seq}`,
           );
-          await sendToIM(content, {
-            streamId: streamState.streamId,
-            seq: streamState.seq++,
-            isFinal: true,
-            delta,
-          });
         } else {
           log(`${tag}: [DELIVER 非流式] contentType=${typeof content === "string" ? "string" : "array"}`);
-          await sendToIM(content);
+          await enqueueIMSend(content, undefined, undefined, "deliver");
         }
 
         log(`${tag}: [DELIVER 完成] kind=${kind}`);
@@ -260,14 +278,17 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
             `${tag}: [PARTIAL 输出] seq=${seq} totalLen=${text.length} deltaLen=${delta.length} delta="${delta.slice(0, 120)}" elapsed=${elapsed}ms`,
           );
 
-          sendToIM(text, {
-            streamId: streamState.streamId,
-            seq,
-            isFinal: false,
-            delta,
-          }).catch((err: any) => {
-            error(`${tag}: [PARTIAL 发送失败] seq=${seq} error=${err.message}`);
-          });
+          enqueueIMSend(
+            text,
+            {
+              streamId: streamState.streamId,
+              seq,
+              isFinal: false,
+              delta,
+            },
+            undefined,
+            `partial seq=${seq}`,
+          );
         }
       : undefined,
     onReasoningStream: showProcess
@@ -287,9 +308,7 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
           text = text.replace(/^Reasoning:\n/, "");
           text = text.replace(/^_|_$/gm, "");
           log(`${tag}: [THINKING] 思考完成, len=${text.length}`);
-          sendToIM(text, undefined, "thinking").catch((err: any) => {
-            error(`${tag}: [THINKING] 发送失败: ${err.message}`);
-          });
+          enqueueIMSend(text, undefined, "thinking", "thinking");
         }
       : undefined,
   };