multiclaws 0.4.14 → 0.4.16

package/dist/infra/frp.js

@@ -362,8 +362,9 @@ class FrpTunnelManager {
                 (0, node_child_process_1.execSync)(`tar -xzf "${archivePath}" -C "${downloadDir}"`, { stdio: "ignore" });
             }
             else {
-                // Windows: tar does not support .zip; use PowerShell's Expand-Archive instead
-                (0, node_child_process_1.execSync)(`powershell -NoProfile -Command "Expand-Archive -LiteralPath '${archivePath}' -DestinationPath '${downloadDir}' -Force"`, { stdio: "ignore" });
+                // Windows: suppress progress bar to prevent silent failure in headless environments;
+                // use stdio:"pipe" so execSync captures errors if PowerShell exits non-zero
+                (0, node_child_process_1.execSync)(`powershell -NoProfile -Command "$ProgressPreference = 'SilentlyContinue'; Expand-Archive -LiteralPath '${archivePath}' -DestinationPath '${downloadDir}' -Force"`, { stdio: "pipe" });
             }
             // Move binary to target
             const extractedBinary = node_path_1.default.join(downloadDir, archiveName, binaryName);

package/dist/service/a2a-adapter.d.ts

@@ -27,17 +27,20 @@ export declare class OpenClawAgentExecutor implements AgentExecutor {
     constructor(options: A2AAdapterOptions);
     execute(context: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
     /**
-     * Poll sessions_history until the subagent produces a final assistant message.
-     * Uses backoff: 2s, 3s, 4s, then 5s intervals.
+     * Poll sessions_history until the subagent session completes.
+     * Collects ALL assistant text messages and returns them joined.
      */
     private waitForCompletion;
     /**
-     * Extract the final assistant response from session history.
+     * Extract all assistant text from session history once the session is complete.
      * Returns null if the session is still running.
+     * Returns all assistant text messages joined (not just the last one).
      *
      * Gateway /tools/invoke returns: { content: [...], details: { messages: [...], isComplete?: boolean } }
      */
     private extractCompletedResult;
+    /** Extract text content from a single history message. */
+    private extractTextFromHistoryMessage;
     cancelTask(taskId: string, eventBus: ExecutionEventBus): Promise<void>;
     updateGatewayConfig(config: GatewayConfig): void;
     private publishMessage;

package/dist/service/a2a-adapter.js

@@ -103,14 +103,13 @@ class OpenClawAgentExecutor {
         eventBus.finished();
     }
     /**
-     * Poll sessions_history until the subagent produces a final assistant message.
-     * Uses backoff: 2s, 3s, 4s, then 5s intervals.
+     * Poll sessions_history until the subagent session completes.
+     * Collects ALL assistant text messages and returns them joined.
      */
     async waitForCompletion(sessionKey, timeoutMs) {
         const gateway = this.gatewayConfig;
         const startTime = Date.now();
         let attempt = 0;
-        // Start aggressive, max out at 500ms to minimize result latency
         const pollDelays = [100, 200, 300, 500];
         while (Date.now() - startTime < timeoutMs) {
             const delay = pollDelays[Math.min(attempt, pollDelays.length - 1)];
@@ -122,7 +121,7 @@ class OpenClawAgentExecutor {
                     tool: "sessions_history",
                     args: {
                         sessionKey,
-                        limit: 20,
+                        limit: 50,
                         includeTools: false,
                     },
                     timeoutMs: 8_000,
@@ -140,8 +139,9 @@ class OpenClawAgentExecutor {
         throw new Error(`task timed out after ${Math.round(timeoutMs / 1000)}s waiting for subagent`);
     }
     /**
-     * Extract the final assistant response from session history.
+     * Extract all assistant text from session history once the session is complete.
      * Returns null if the session is still running.
+     * Returns all assistant text messages joined (not just the last one).
      *
      * Gateway /tools/invoke returns: { content: [...], details: { messages: [...], isComplete?: boolean } }
      */
@@ -155,34 +155,51 @@ class OpenClawAgentExecutor {
         const messages = (details.messages ?? []);
         if (messages.length === 0)
             return null;
-        // If no explicit flag, check the last message for signs of ongoing execution
+        // If no explicit isComplete flag, use heuristic: check if the session is still executing
         if (details.isComplete === undefined) {
             const lastMsg = messages[messages.length - 1];
             if (lastMsg && Array.isArray(lastMsg.content)) {
                 const content = lastMsg.content;
                 const hasToolCalls = content.some((c) => c?.type === "toolCall" || c?.type === "tool_use");
+                // If the last message only has tool calls (no text), still running
                 const hasText = content.some((c) => c?.type === "text" && typeof c.text === "string" && c.text.trim());
                 if (hasToolCalls && !hasText)
                     return null;
             }
+            // If the last message is a user message, the agent hasn't responded yet
+            const lastMsg2 = messages[messages.length - 1];
+            if (lastMsg2?.role === "user")
+                return null;
         }
-        // Walk backwards to find the last assistant message with text content
-        for (let i = messages.length - 1; i >= 0; i--) {
-            const msg = messages[i];
+        // Session is complete — collect ALL assistant text messages in order
+        const allTexts = [];
+        for (const msg of messages) {
             if (msg.role !== "assistant")
                 continue;
-            const content = msg.content;
-            if (typeof content === "string" && content.trim()) {
-                return content;
-            }
-            if (Array.isArray(content)) {
-                const parts = content;
-                const textParts = parts
-                    .filter((c) => c?.type === "text" && typeof c.text === "string" && c.text.trim())
-                    .map((c) => c.text);
-                if (textParts.length > 0) {
-                    return textParts.join("\n");
-                }
+            const text = this.extractTextFromHistoryMessage(msg);
+            if (text)
+                allTexts.push(text);
+        }
+        // Session completed but no text output — return a marker instead of null
+        // to avoid infinite polling / timeout
+        if (allTexts.length === 0) {
+            return "(task completed with no text output)";
+        }
+        return allTexts.join("\n\n");
+    }
+    /** Extract text content from a single history message. */
+    extractTextFromHistoryMessage(msg) {
+        const content = msg.content;
+        if (typeof content === "string" && content.trim()) {
+            return content;
+        }
+        if (Array.isArray(content)) {
+            const parts = content;
+            const textParts = parts
+                .filter((c) => c?.type === "text" && typeof c.text === "string" && c.text.trim())
+                .map((c) => c.text);
+            if (textParts.length > 0) {
+                return textParts.join("\n");
             }
         }
         return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multiclaws",
-  "version": "0.4.14",
+  "version": "0.4.16",
   "description": "MultiClaws plugin for OpenClaw collaboration via A2A protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/multiclaws/SKILL.md

@@ -137,7 +137,9 @@ multiclaws_profile_show()
    → 自动同步所有团队成员
 ```
 
-### 智能委派
+### 智能委派（单轮）
+
+适用于一次性任务，不需要来回沟通。
 
 ```
 1. multiclaws_agents()                    — 列出智能体，读 bio
@@ -151,6 +153,53 @@ multiclaws_profile_show()
 - 匹配数据需求（如「检查 API 代码」→ bio 中有该代码库的智能体）
 - 多个匹配时选最具体的
 
+### 多轮协作（需要来回沟通）
+
+适用于需要协商、确认、多次沟通才能完成的任务（如约会议、对需求、联合调试）。
+
+**根据用户是否需要看到中间过程，选择以下两种模式：**
+
+#### 模式 A：交互式多轮（推荐 — 用户能看到每一步进展）
+
+主 AI 直接处理多轮沟通，每轮之间向用户汇报进展。
+
+```
+用户: "帮我和小明约明天下午的会议"
+
+1. multiclaws_agents()                    — 找到小明
+2. multiclaws_delegate(agentUrl="小明", task="我想约明天下午开会，你什么时候有空？")
+3. → 向用户汇报: "小明说明天下午 3 点和 4 点都可以"
+4.（用户说"约 3 点"或 AI 自行判断）
+5. multiclaws_delegate(agentUrl="小明", task="确认明天下午 3 点开会")
+6. → 向用户汇报: "已和小明确认明天下午 3 点"
+```
+
+**关键规则：**
+- 每次 `multiclaws_delegate` 返回后，**立即向用户汇报结果**，不要等全部完成
+- 如果能自行判断下一步（如对方给了选项，用户已表达偏好），直接继续
+- 如果需要用户决策（如对方提出多个方案），暂停并询问用户
+- 协商未达成一致时，继续发 `multiclaws_delegate`，最多 5 轮
+
+#### 模式 B：自主式多轮（AI 全自动完成，只报告最终结果）
+
+适用于用户明确授权自主处理、不需要看中间过程的场景。使用 `sessions_spawn` 启动子 agent，子 agent 自主完成全部沟通。
+
+```
+用户: "帮我和小明约个会，我明天下午都行，你自己搞定"
+
+1. sessions_spawn(task="联系小明协商明天下午的会议时间。我这边下午都可以。
+   使用 multiclaws_delegate 与小明沟通，协商确定具体时间。
+   完成后汇报最终结果。", mode="run")
+2.（子 agent 自主多轮沟通）
+3. 子 agent 完成 → announce 回父 agent → 向用户报告最终结果
+```
+
+**何时用模式 B：**
+- 用户明确说「你自己搞定」「自动处理」「不用问我」
+- 任务参数已完全明确，不需要用户中间决策
+
+**默认用模式 A。** 除非用户明确要求自主处理，否则始终用交互式模式，确保用户看到每一步。
+
 ---
 
 ## 网络配置