@ynhcj/xiaoyi-channel 0.0.225-next → 0.0.227-next

package/dist/index.js

@@ -406,9 +406,10 @@ function registerSubagentHooks(api) {
             if (transition?.shouldFinalize) {
                 logger.log(`[XY-SUBAGENT-END] Starting finalization...`);
                 // Grace: announce 投递的 sendText 与 subagent_ended hook 并发到达
-                // （实测 sendText 可能先于 hook 约 1s，也可能略晚于 hook），
-                // 短等让最后一条完成文本先落入 completionTexts 再合并发 final 帧。
-                await new Promise((r) => setTimeout(r, 1500));
+                // （实测 sendText 可能先于 hook 约 1s，也可能晚于 hook；长文本还会
+                // 被 textChunkLimit 分片成多次 sendText）。捕获窗口直到
+                // finalDeliveryStarted 才关闭，此处的等待直接扩大迟到来片的入窗机会。
+                await new Promise((r) => setTimeout(r, 3000));
                 // 最终交付由对话管理层统一负责（含 config 解析、final 帧、清理）
                 await deliverSubagentFinalResult({
                     state: transition.state,

package/dist/src/conversation/conversation-manager.js

@@ -261,6 +261,7 @@ export function markSubagentSpawned(sessionKey) {
             completionTexts: [],
             parentSettled: false,
             finalizationClaimed: false,
+            finalDeliveryStarted: false,
         };
         states.push(state);
     }
@@ -367,6 +368,9 @@ export async function deliverSubagentFinalResult(params) {
         log.error(`[SUBAGENT-FINAL] No cached XY config, cannot deliver final result`);
         return;
     }
+    // 关闭捕获窗口：此后到达的 sendText 不再并入 final 文本。
+    // 等待态在发送后立即清除，迟到的 announce 文本回退 push 通道兜底（不丢消息）。
+    state.finalDeliveryStarted = true;
     const finalText = state.completionTexts.length > 0
         ? state.completionTexts.join("\n\n")
         : (params.text || undefined) ?? "子任务已完成";

package/dist/src/conversation/conversation-session.d.ts

@@ -16,6 +16,12 @@ export interface SubagentWaitState {
     completionTexts: string[];
     parentSettled: boolean;
     finalizationClaimed: boolean;
+    /**
+     * final 帧开始交付（deliverSubagentFinalResult 入口）后置位。
+     * 捕获窗口以此为准：grace 期间迟到的 announce 文本仍可并入 final；
+     * 置位后到达的 sendText 不再捕获（等待态随即清除，回退 push 兜底）。
+     */
+    finalDeliveryStarted: boolean;
 }
 export interface SubagentWaitTransition {
     state: SubagentWaitState;

package/dist/src/dispatch/outbound.js

@@ -115,16 +115,18 @@ export const xyOutbound = {
                 chatId: typeof to === "string" ? to : "",
             };
         }
-        // ── Subagent completion text capture ─────────────────────────
+        // ── Subagent completion text capture + push 抑制 ─────────────
         // Subagent completions may arrive here when openclaw's announce
         // flow delivers through the channel outbound. We capture the text
         // for the final A2A response but do NOT track delivery count here.
         // Delivery tracking is done by the subagent_ended hook (index.ts).
         //
-        // IMPORTANT: We do NOT return early here. The OpenClaw core's announce
-        // flow needs sendText to complete normally (push delivery) to avoid
-        // triggering the direct-primary fallback retry loop. Text is captured
-        // for the A2A final response, but push delivery proceeds normally.
+        // 正常对话的 subagent announce 一律不发 push：结果由保活机制经
+        // A2A final 帧交付，push webhook 通知冗余。返回合成成功（与 cron
+        // 吞没路径同理），保证 openclaw durable-delivery 记账正常，避免
+        // 触发 direct-primary fallback 重试。
+        // cron 的 announce 不受此分支影响：cron sendText 无 target
+        // （DEFAULT_PUSH_MARKER），且 cron 会话不存在 wait state，push 照常。
         if (to && to !== DEFAULT_PUSH_MARKER) {
             const [targetSessionId, targetTaskId] = String(to).split("::");
             const waitState = getWaitState(targetSessionId, targetTaskId);
@@ -132,15 +134,30 @@ export const xyOutbound = {
             // 同样携带父会话 ALS 上下文（resolveTarget 据此增强 target），ALS guard
             // 会把 announce 误判为父 turn 自己的 sendText 而漏捕获。
             // 改用 parentSettled 区分：父 run 存活期间的 sendText 是父自己的 message
-            // 工具调用（不捕获）；父 settle 后命中 waitState 的 sendText 即为
-            // subagent 完成结果的 announce 投递（捕获）。
+            // 工具调用（不捕获、push 照常）；父 settle 后命中 waitState 的 sendText
+            // 即为 subagent 完成结果的 announce 投递（捕获 + 吞掉 push）。
+            // 捕获窗口以 finalDeliveryStarted 为准（而非 finalizationClaimed）：
+            // finalizationClaimed 在 markSubagentEnded 时就置位，若 announce 的
+            // sendText 晚于 subagent_ended hook 到达（如长文本被 textChunkLimit
+            // 分片、投递时序竞争），claim 会提前关闭捕获导致内容丢失——配合
+            // push 抑制，丢失是永久的。finalDeliveryStarted 在 grace 结束后、
+            // final 帧发送前才置位，grace 期间迟到的文本仍能并入 final。
             const isFromWaitState = waitState && waitState.parentSettled;
-            if (isFromWaitState && !waitState.finalizationClaimed) {
+            if (isFromWaitState) {
                 const log = logger.withContext(waitState.sessionId, waitState.taskId);
-                log.log(`[xyOutbound.sendText] Subagent completion text captured, len=${text?.length ?? 0}`);
-                addCompletionText(targetSessionId, targetTaskId, text);
-                // Fall through to normal push delivery — core needs sendText to
-                // complete normally to avoid retry/announce-failure loops.
+                if (!waitState.finalDeliveryStarted) {
+                    log.log(`[xyOutbound.sendText] Subagent completion text captured, len=${text?.length ?? 0}`);
+                    addCompletionText(targetSessionId, targetTaskId, text);
+                    log.log(`[xyOutbound.sendText] Subagent announce — swallowing push (result delivered via A2A final frame)`);
+                    return {
+                        channel: "xiaoyi-channel",
+                        messageId: `subagent-swallowed-${Date.now()}`,
+                        chatId: typeof to === "string" ? to : "",
+                    };
+                }
+                // final 帧已开始交付：不再捕获也不再吞没，fall through 走 push 兜底，
+                // 避免迟到的 announce 文本被静默丢弃。
+                log.log(`[xyOutbound.sendText] Subagent announce arrived after final delivery started — falling back to push`);
             }
         }
         // ── End subagent text capture ───────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ynhcj/xiaoyi-channel",
-  "version": "0.0.225-next",
+  "version": "0.0.227-next",
   "description": "OpenClaw Xiaoyi Channel plugin - Xiaoyi A2A protocol integration",
   "type": "module",
   "main": "./dist/index.js",