@ganglion/xacpx 0.19.0 → 0.19.2

package/README.md

@@ -23,6 +23,8 @@ English · **[中文](./docs/zh/README_zh.md)**
 
 If you need to code or work remotely on a temporary basis, `xacpx` gives you a fast, convenient **remote entry point** so you can get things done from WeChat or Feishu anytime, anywhere.
 
+Chat isn't the only entry point: xacpx also ships a self-hostable **[relay hub](#self-hosted-relay-hub--web-dashboard)** — a multi-tenant web dashboard that drives every one of your xacpx instances from a single browser tab (installable as a PWA on your phone).
+
 > For everyday use, remember `/ss` first: it creates or reuses an xacpx logical session. If you want to attach to an existing native session of a local agent such as Codex, use `/ssn`; see [native sessions](./docs/native-sessions.md).
 
 ## 5-minute quick start
@@ -173,9 +175,17 @@ take a look at today's API timeout issue
 /ssn 1
 ```
 
-## Self-hosted relay hub (optional)
+## Self-hosted relay hub — web dashboard
+
+If you run one or more xacpx instances and want to drive them from a browser instead of (or in addition to) chat, self-host the **relay hub**. Each instance dials out to the hub over WebSocket and registers; you log in to a multi-tenant web dashboard and manage every instance's sessions from one place.
+
+What you get:
 
-If you run several xacpx instances and want to drive them all from one browser dashboard, you can self-host the **relay hub**. Each instance dials out to the hub over WebSocket and registers; you log in to a multi-tenant web dashboard and manage every instance's sessions — chat, scheduled tasks, and orchestration — from one place. The hub ships as an npm package (`@ganglion/xacpx-relay`) with the dashboard **bundled in**, served on a single port, with a single **access token** for both web login and connector pairing.
+- **A three-pane IM-style dashboard** — instance/session tree on the left, live chat in the middle, scheduled tasks & orchestration panel on the right. English + 中文 UI.
+- **Live streaming replies** rendered as markdown, with tool-call and subagent activity inline; cancel running turns from the browser.
+- **Mobile-ready** — installs as a PWA, so it feels like an app on your phone.
+- **One package, one port** — `@ganglion/xacpx-relay` ships the dashboard **bundled in**; HTTP API, web socket, and instance gateway share a single port by default. SQLite storage via the built-in `node:sqlite`/`bun:sqlite` — no native addons to compile.
+- **Multi-tenant & token-based** — every token is a user who only sees their own instances; tokens and credentials are stored hashed. Onboard teammates with **single-use invite links** (`xacpx-relay add invite`) instead of handing out tokens.
 
 ```bash
 npm i -g @ganglion/xacpx-relay
@@ -188,7 +198,7 @@ xacpx channel add relay --url wss://relay.example.com --token <access-token> --n
 xacpx restart
 ```
 
-Full walkthrough — pairing, TLS/reverse-proxy, systemd, backups, troubleshooting: **[Self-Hosting the Relay Hub](https://gadzan.github.io/xacpx/guide/relay-self-hosting)** (or [relay-deployment.md](./docs/relay-deployment.md) for the terse runbook).
+The same access token works for both web login and connector pairing. Full walkthrough — pairing, invites, TLS/reverse-proxy, systemd, backups, troubleshooting: **[Self-Hosting the Relay Hub](https://gadzan.github.io/xacpx/guide/relay-self-hosting)** (or [relay-deployment.md](./docs/relay-deployment.md) for the terse runbook).
 
 ## Config and runtime files
 

package/dist/bridge/bridge-main.js

@@ -3223,6 +3223,7 @@ function createStreamingPromptState(formatToolCalls = false, options) {
   let onCommands;
   let rawStream = false;
   let driver;
+  let onBeforeActivityEvent;
   if (options === undefined) {
     toolEventMode = "text";
     onToolEvent = undefined;
@@ -3237,6 +3238,7 @@ function createStreamingPromptState(formatToolCalls = false, options) {
     onCommands = options.onCommands;
     rawStream = options.rawStream ?? false;
     driver = options.driver?.trim().toLowerCase() || undefined;
+    onBeforeActivityEvent = options.onBeforeActivityEvent;
     toolEventMode = resolveToolEventMode({
       toolEventMode: options.mode,
       onToolEvent
@@ -3249,10 +3251,14 @@ function createStreamingPromptState(formatToolCalls = false, options) {
     pendingLine: "",
     formatToolCalls,
     emittedToolCallIds: new Set,
+    positionedToolCallIds: new Set,
     toolCalls: new Map,
     toolEventMode,
     driver,
     rawStream,
+    lastTextTail: "",
+    activitySinceLastText: false,
+    onBeforeActivityEvent,
     onToolEvent,
     onThought,
     onPlan,
@@ -3295,6 +3301,14 @@ function parseStreamingChunks(state, line) {
   if (!update)
     return;
   if (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update") {
+    const isInitialToolEvent = typeof update.toolCallId === "string" ? !state.positionedToolCallIds.has(update.toolCallId) : update.sessionUpdate === "tool_call";
+    if (isInitialToolEvent) {
+      if (update.toolCallId)
+        state.positionedToolCallIds.add(update.toolCallId);
+      markActivityBoundary(state);
+    } else {
+      flushBeforeActivityEvent(state);
+    }
     const wantsStructured = state.toolEventMode === "structured" || state.toolEventMode === "both";
     const wantsText = (state.toolEventMode === "text" || state.toolEventMode === "both") && state.formatToolCalls;
     if (wantsStructured && state.onToolEvent) {
@@ -3343,6 +3357,7 @@ function parseStreamingChunks(state, line) {
   if (isThoughtChunk) {
     const chunk2 = update.content.text;
     if (chunk2.length > 0) {
+      markActivityBoundary(state);
       state.onThought?.(chunk2);
     }
     return;
@@ -3351,10 +3366,22 @@ function parseStreamingChunks(state, line) {
   if (!isMessageChunk)
     return;
   state.hasAgentMessage = true;
-  const chunk = update.content.text ?? "";
+  let chunk = update.content.text ?? "";
   if (chunk.length === 0)
     return;
+  const messageId = typeof update.messageId === "string" && update.messageId.length > 0 ? update.messageId : undefined;
+  const messageIdChanged = state.lastMessageId !== undefined && messageId !== undefined && state.lastMessageId !== messageId;
+  const fallbackBoundary = state.activitySinceLastText && (state.lastMessageId === undefined || messageId === undefined) && endsWithSentenceTerminal(state.lastTextTail);
+  if ((messageIdChanged || fallbackBoundary) && !hasParagraphBoundaryAtJoin(state.lastTextTail, chunk)) {
+    chunk = `
+
+${chunk}`;
+    state.lastTextTail = "";
+  }
   state.buffer += chunk;
+  state.lastMessageId = messageId;
+  state.activitySinceLastText = false;
+  state.lastTextTail = `${state.lastTextTail}${chunk}`.slice(-256);
   if (state.rawStream)
     return;
   let boundary;
@@ -3368,6 +3395,24 @@ function parseStreamingChunks(state, line) {
     }
   }
 }
+function endsWithSentenceTerminal(text) {
+  return SENTENCE_TERMINAL_AT_END.test(text.trimEnd());
+}
+function hasParagraphBoundaryAtJoin(left, right) {
+  const leftHasBoundary = PARAGRAPH_BOUNDARY_AT_END.test(left);
+  const rightHasBoundary = PARAGRAPH_BOUNDARY_AT_START.test(right);
+  const boundarySpansJoin = LINE_BREAK_AT_END.test(left) && LINE_BREAK_AT_START.test(right);
+  const crlfBoundarySpansJoin = PARTIAL_CRLF_PARAGRAPH_BOUNDARY_AT_END.test(left) && right.startsWith(`
+`);
+  return leftHasBoundary || rightHasBoundary || boundarySpansJoin || crlfBoundarySpansJoin;
+}
+function markActivityBoundary(state) {
+  flushBeforeActivityEvent(state);
+  state.activitySinceLastText = state.hasAgentMessage;
+}
+function flushBeforeActivityEvent(state) {
+  state.onBeforeActivityEvent?.();
+}
 function formatToolCallEvent(update, sessionUpdate) {
   if (!update)
     return null;
@@ -3629,10 +3674,16 @@ function isGenericToolTitle(kind, title) {
   }
   return false;
 }
-var USAGE_BREAKDOWN_FIELDS;
+var SENTENCE_TERMINAL_AT_END, PARAGRAPH_BOUNDARY_AT_END, PARAGRAPH_BOUNDARY_AT_START, LINE_BREAK_AT_END, LINE_BREAK_AT_START, PARTIAL_CRLF_PARAGRAPH_BOUNDARY_AT_END, USAGE_BREAKDOWN_FIELDS;
 var init_streaming_prompt = __esm(() => {
   init_background_followup();
   init_tool_kind_emoji();
+  SENTENCE_TERMINAL_AT_END = /(?:\p{Sentence_Terminal}|…|⋯)[\p{Close_Punctuation}\p{Final_Punctuation}"“”‘’*_~`]*$/u;
+  PARAGRAPH_BOUNDARY_AT_END = /\r?\n[\t ]*\r?\n[\t ]*$/;
+  PARAGRAPH_BOUNDARY_AT_START = /^[\t ]*\r?\n[\t ]*\r?\n/;
+  LINE_BREAK_AT_END = /\r?\n[\t ]*$/;
+  LINE_BREAK_AT_START = /^[\t ]*\r?\n/;
+  PARTIAL_CRLF_PARAGRAPH_BOUNDARY_AT_END = /\r?\n[\t ]*\r$/;
   USAGE_BREAKDOWN_FIELDS = [
     ["inputTokens", ["inputTokens", "input_tokens"]],
     ["outputTokens", ["outputTokens", "output_tokens"]],
@@ -7534,10 +7585,14 @@ async function runStreamingPrompt(command, args, onEvent, options = {}) {
     let stdout = "";
     let stderr = "";
     const toolEventMode = options.toolEventMode ?? "text";
+    let flushPendingText = () => {};
     const state = createStreamingPromptState(options.formatToolCalls ?? false, {
       mode: toolEventMode,
       driver: options.driver,
       rawStream,
+      onBeforeActivityEvent: () => {
+        flushPendingText();
+      },
       ...onEvent && (toolEventMode === "structured" || toolEventMode === "both") ? { onToolEvent: (toolEvent) => onEvent({ type: "prompt.tool_event", event: toolEvent }) } : {},
       ...onEvent ? { onThought: (chunk) => onEvent({ type: "prompt.thought", text: chunk }) } : {},
       ...onEvent ? { onPlan: (entries) => onEvent({ type: "prompt.plan", entries }) } : {},
@@ -7553,6 +7608,13 @@ async function runStreamingPrompt(command, args, onEvent, options = {}) {
         lastReplyAt = now();
       }
     };
+    flushPendingText = () => {
+      for (const segment of state.segments.splice(0)) {
+        onEvent?.({ type: "prompt.segment", text: segment });
+        lastReplyAt = now();
+      }
+      flushBuffer();
+    };
     const timer = setIntervalFn(() => {
       if (state.buffer.trim().length > 0 && now() - lastReplyAt >= maxSegmentWaitMs) {
         flushBuffer();

package/dist/cli.js

@@ -5762,6 +5762,10 @@ var init_agent_templates = __esm(() => {
     "grok-build": {
       driver: "grok-build"
     },
+    hermes: {
+      driver: "hermes",
+      command: "hermes acp"
+    },
     iflow: {
       driver: "iflow"
     },
@@ -32775,6 +32779,25 @@ var init_quota_gated_reply_sink = __esm(() => {
   ADAPTIVE_WINDOW_SCHEDULE_MS = [3000, 6000, 12000, 24000, 48000, 60000];
 });
 
+// src/transport/serialized-callback-queue.ts
+function createSerializedCallbackQueue() {
+  let chain = Promise.resolve();
+  let firstError;
+  return {
+    enqueue(callback) {
+      chain = chain.then(callback).catch((error2) => {
+        firstError ??= error2;
+      });
+    },
+    async drain() {
+      await chain;
+    },
+    getError() {
+      return firstError;
+    }
+  };
+}
+
 // src/transport/tool-event-mode.ts
 function resolveToolEventMode(input) {
   if (input?.toolEventMode !== undefined) {
@@ -32827,12 +32850,7 @@ class AcpxBridgeTransport {
       reply,
       ...replyContext ? { replyContext } : {}
     }) : null;
-    let segmentError;
-    let segmentChain = Promise.resolve();
-    let toolEventError;
-    let toolEventChain = Promise.resolve();
-    let thoughtError;
-    let thoughtChain = Promise.resolve();
+    const transcriptEvents = createSerializedCallbackQueue();
     let planError;
     let planChain = Promise.resolve();
     let usageError;
@@ -32852,22 +32870,19 @@ class AcpxBridgeTransport {
     }, (event) => {
       if (event.type === "prompt.segment") {
         const onSegment = options?.onSegment;
-        if (onSegment) {
-          const segmentText = event.text;
-          segmentChain = segmentChain.then(() => onSegment(segmentText)).catch((error2) => {
-            segmentError ??= error2;
-          });
-        }
-        sink2?.feedSegment(event.text);
+        const segmentText = event.text;
+        transcriptEvents.enqueue(async () => {
+          const segmentResult = onSegment?.(segmentText);
+          sink2?.feedSegment(segmentText);
+          await segmentResult;
+        });
         return;
       }
       if (event.type === "prompt.tool_event") {
         const onToolEvent = options?.onToolEvent;
         if (onToolEvent) {
           const toolEvent = event.event;
-          toolEventChain = toolEventChain.then(() => onToolEvent(toolEvent)).catch((error2) => {
-            toolEventError ??= error2;
-          });
+          transcriptEvents.enqueue(() => onToolEvent(toolEvent));
         }
         return;
       }
@@ -32875,9 +32890,7 @@ class AcpxBridgeTransport {
         const onThought = options?.onThought;
         if (onThought) {
           const thoughtText = event.text;
-          thoughtChain = thoughtChain.then(() => onThought(thoughtText)).catch((error2) => {
-            thoughtError ??= error2;
-          });
+          transcriptEvents.enqueue(() => onThought(thoughtText));
         }
         return;
       }
@@ -32912,9 +32925,7 @@ class AcpxBridgeTransport {
         return;
       }
     });
-    await segmentChain;
-    await toolEventChain;
-    await thoughtChain;
+    await transcriptEvents.drain();
     await planChain;
     await usageChain;
     await commandsChain;
@@ -32926,14 +32937,9 @@ class AcpxBridgeTransport {
         throw deferred;
       }
       const summary = buildOverflowSummary(overflowCount);
-      if (segmentError) {
-        throw segmentError;
-      }
-      if (toolEventError) {
-        throw toolEventError;
-      }
-      if (thoughtError) {
-        throw thoughtError;
+      const transcriptError2 = transcriptEvents.getError();
+      if (transcriptError2) {
+        throw transcriptError2;
       }
       if (planError) {
         throw planError;
@@ -32948,14 +32954,9 @@ class AcpxBridgeTransport {
 
 ${result.text}` : "" };
     }
-    if (segmentError) {
-      throw segmentError;
-    }
-    if (toolEventError) {
-      throw toolEventError;
-    }
-    if (thoughtError) {
-      throw thoughtError;
+    const transcriptError = transcriptEvents.getError();
+    if (transcriptError) {
+      throw transcriptError;
     }
     if (planError) {
       throw planError;
@@ -33756,6 +33757,7 @@ function createStreamingPromptState(formatToolCalls = false, options) {
   let onCommands;
   let rawStream = false;
   let driver;
+  let onBeforeActivityEvent;
   if (options === undefined) {
     toolEventMode = "text";
     onToolEvent = undefined;
@@ -33770,6 +33772,7 @@ function createStreamingPromptState(formatToolCalls = false, options) {
     onCommands = options.onCommands;
     rawStream = options.rawStream ?? false;
     driver = options.driver?.trim().toLowerCase() || undefined;
+    onBeforeActivityEvent = options.onBeforeActivityEvent;
     toolEventMode = resolveToolEventMode({
       toolEventMode: options.mode,
       onToolEvent
@@ -33782,10 +33785,14 @@ function createStreamingPromptState(formatToolCalls = false, options) {
     pendingLine: "",
     formatToolCalls,
     emittedToolCallIds: new Set,
+    positionedToolCallIds: new Set,
     toolCalls: new Map,
     toolEventMode,
     driver,
     rawStream,
+    lastTextTail: "",
+    activitySinceLastText: false,
+    onBeforeActivityEvent,
     onToolEvent,
     onThought,
     onPlan,
@@ -33828,6 +33835,14 @@ function parseStreamingChunks(state, line) {
   if (!update)
     return;
   if (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update") {
+    const isInitialToolEvent = typeof update.toolCallId === "string" ? !state.positionedToolCallIds.has(update.toolCallId) : update.sessionUpdate === "tool_call";
+    if (isInitialToolEvent) {
+      if (update.toolCallId)
+        state.positionedToolCallIds.add(update.toolCallId);
+      markActivityBoundary(state);
+    } else {
+      flushBeforeActivityEvent(state);
+    }
     const wantsStructured = state.toolEventMode === "structured" || state.toolEventMode === "both";
     const wantsText = (state.toolEventMode === "text" || state.toolEventMode === "both") && state.formatToolCalls;
     if (wantsStructured && state.onToolEvent) {
@@ -33876,6 +33891,7 @@ function parseStreamingChunks(state, line) {
   if (isThoughtChunk) {
     const chunk2 = update.content.text;
     if (chunk2.length > 0) {
+      markActivityBoundary(state);
       state.onThought?.(chunk2);
     }
     return;
@@ -33884,10 +33900,22 @@ function parseStreamingChunks(state, line) {
   if (!isMessageChunk)
     return;
   state.hasAgentMessage = true;
-  const chunk = update.content.text ?? "";
+  let chunk = update.content.text ?? "";
   if (chunk.length === 0)
     return;
+  const messageId = typeof update.messageId === "string" && update.messageId.length > 0 ? update.messageId : undefined;
+  const messageIdChanged = state.lastMessageId !== undefined && messageId !== undefined && state.lastMessageId !== messageId;
+  const fallbackBoundary = state.activitySinceLastText && (state.lastMessageId === undefined || messageId === undefined) && endsWithSentenceTerminal(state.lastTextTail);
+  if ((messageIdChanged || fallbackBoundary) && !hasParagraphBoundaryAtJoin(state.lastTextTail, chunk)) {
+    chunk = `
+
+${chunk}`;
+    state.lastTextTail = "";
+  }
   state.buffer += chunk;
+  state.lastMessageId = messageId;
+  state.activitySinceLastText = false;
+  state.lastTextTail = `${state.lastTextTail}${chunk}`.slice(-256);
   if (state.rawStream)
     return;
   let boundary;
@@ -33901,6 +33929,24 @@ function parseStreamingChunks(state, line) {
     }
   }
 }
+function endsWithSentenceTerminal(text) {
+  return SENTENCE_TERMINAL_AT_END.test(text.trimEnd());
+}
+function hasParagraphBoundaryAtJoin(left, right) {
+  const leftHasBoundary = PARAGRAPH_BOUNDARY_AT_END.test(left);
+  const rightHasBoundary = PARAGRAPH_BOUNDARY_AT_START.test(right);
+  const boundarySpansJoin = LINE_BREAK_AT_END.test(left) && LINE_BREAK_AT_START.test(right);
+  const crlfBoundarySpansJoin = PARTIAL_CRLF_PARAGRAPH_BOUNDARY_AT_END.test(left) && right.startsWith(`
+`);
+  return leftHasBoundary || rightHasBoundary || boundarySpansJoin || crlfBoundarySpansJoin;
+}
+function markActivityBoundary(state) {
+  flushBeforeActivityEvent(state);
+  state.activitySinceLastText = state.hasAgentMessage;
+}
+function flushBeforeActivityEvent(state) {
+  state.onBeforeActivityEvent?.();
+}
 function formatToolCallEvent(update, sessionUpdate) {
   if (!update)
     return null;
@@ -34162,10 +34208,16 @@ function isGenericToolTitle(kind, title) {
   }
   return false;
 }
-var USAGE_BREAKDOWN_FIELDS;
+var SENTENCE_TERMINAL_AT_END, PARAGRAPH_BOUNDARY_AT_END, PARAGRAPH_BOUNDARY_AT_START, LINE_BREAK_AT_END, LINE_BREAK_AT_START, PARTIAL_CRLF_PARAGRAPH_BOUNDARY_AT_END, USAGE_BREAKDOWN_FIELDS;
 var init_streaming_prompt = __esm(() => {
   init_background_followup();
   init_tool_kind_emoji();
+  SENTENCE_TERMINAL_AT_END = /(?:\p{Sentence_Terminal}|…|⋯)[\p{Close_Punctuation}\p{Final_Punctuation}"“”‘’*_~`]*$/u;
+  PARAGRAPH_BOUNDARY_AT_END = /\r?\n[\t ]*\r?\n[\t ]*$/;
+  PARAGRAPH_BOUNDARY_AT_START = /^[\t ]*\r?\n[\t ]*\r?\n/;
+  LINE_BREAK_AT_END = /\r?\n[\t ]*$/;
+  LINE_BREAK_AT_START = /^[\t ]*\r?\n/;
+  PARTIAL_CRLF_PARAGRAPH_BOUNDARY_AT_END = /\r?\n[\t ]*\r$/;
   USAGE_BREAKDOWN_FIELDS = [
     ["inputTokens", ["inputTokens", "input_tokens"]],
     ["outputTokens", ["outputTokens", "output_tokens"]],
@@ -35074,12 +35126,7 @@ ${baseText}` : "" };
       let stdout2 = "";
       let stderr = "";
       let lastReplyAt = now();
-      let segmentChain = Promise.resolve();
-      let segmentError;
-      let toolEventChain = Promise.resolve();
-      let toolEventError;
-      let thoughtChain = Promise.resolve();
-      let thoughtError;
+      const transcriptEvents = createSerializedCallbackQueue();
       let planChain = Promise.resolve();
       let planError;
       let usageChain = Promise.resolve();
@@ -35091,22 +35138,22 @@ ${baseText}` : "" };
       const userOnPlan = onPlan;
       const userOnUsage = onUsage;
       const userOnCommands = onCommands;
+      let flushPendingText = () => {};
       const state = createStreamingPromptState(formatToolCalls, {
         mode: toolEventMode,
         driver,
         rawStream,
+        onBeforeActivityEvent: () => {
+          flushPendingText();
+        },
         ...userOnToolEvent ? {
           onToolEvent: (event) => {
-            toolEventChain = toolEventChain.then(() => userOnToolEvent(event)).catch((error2) => {
-              toolEventError ??= error2;
-            });
+            transcriptEvents.enqueue(() => userOnToolEvent(event));
           }
         } : {},
         ...userOnThought ? {
           onThought: (chunk) => {
-            thoughtChain = thoughtChain.then(() => userOnThought(chunk)).catch((error2) => {
-              thoughtError ??= error2;
-            });
+            transcriptEvents.enqueue(() => userOnThought(chunk));
           }
         } : {},
         ...userOnPlan ? {
@@ -35136,12 +35183,11 @@ ${baseText}` : "" };
         ...replyContext ? { replyContext } : {}
       }) : null;
       const feedSegment = (segment) => {
-        if (onSegment) {
-          segmentChain = segmentChain.then(() => onSegment(segment)).catch((error2) => {
-            segmentError ??= error2;
-          });
-        }
-        sink2?.feedSegment(segment);
+        transcriptEvents.enqueue(async () => {
+          const segmentResult = onSegment?.(segment);
+          sink2?.feedSegment(segment);
+          await segmentResult;
+        });
         lastReplyAt = now();
       };
       const flushBuffer = () => {
@@ -35151,6 +35197,12 @@ ${baseText}` : "" };
           feedSegment(remaining);
         }
       };
+      flushPendingText = () => {
+        for (const segment of state.segments.splice(0)) {
+          feedSegment(segment);
+        }
+        flushBuffer();
+      };
       const timer = setIntervalFn(() => {
         if (state.buffer.trim().length > 0 && now() - lastReplyAt >= maxSegmentWaitMs) {
           flushBuffer();
@@ -35177,31 +35229,23 @@ ${baseText}` : "" };
         if (remaining.length > 0) {
           feedSegment(remaining);
         }
-        const { overflowCount } = sink2?.finalize() ?? { overflowCount: 0 };
-        Promise.all([
-          sink2?.drain({ timeoutMs: 30000 }) ?? Promise.resolve(),
-          segmentChain,
-          toolEventChain,
-          thoughtChain,
-          planChain,
-          usageChain,
-          commandsChain
-        ]).then(() => {
+        (async () => {
+          await Promise.all([
+            transcriptEvents.drain(),
+            planChain,
+            usageChain,
+            commandsChain
+          ]);
+          const { overflowCount } = sink2?.finalize() ?? { overflowCount: 0 };
+          await (sink2?.drain({ timeoutMs: 30000 }) ?? Promise.resolve());
           const deferred = sink2?.getPendingError();
           if (deferred) {
             reject(deferred);
             return;
           }
-          if (segmentError) {
-            reject(segmentError);
-            return;
-          }
-          if (toolEventError) {
-            reject(toolEventError);
-            return;
-          }
-          if (thoughtError) {
-            reject(thoughtError);
+          const transcriptError = transcriptEvents.getError();
+          if (transcriptError) {
+            reject(transcriptError);
             return;
           }
           if (planError) {
@@ -35220,7 +35264,7 @@ ${baseText}` : "" };
             result: { code: code ?? 1, stdout: stdout2, stderr },
             overflowCount
           });
-        }).catch((error2) => {
+        })().catch((error2) => {
           reject(error2);
         });
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganglion/xacpx",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",