multiclaws 0.4.3 → 0.4.5

package/dist/gateway/handlers.js

@@ -3,10 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createGatewayHandlers = createGatewayHandlers;
 const zod_1 = require("zod");
 const nonEmptyString = zod_1.z.string().trim().min(1);
-const agentAddSchema = zod_1.z.object({
-    url: nonEmptyString,
-    apiKey: zod_1.z.string().trim().min(1).optional(),
-});
 const agentRemoveSchema = zod_1.z.object({ url: nonEmptyString });
 const sessionStartSchema = zod_1.z.object({
     agentUrl: nonEmptyString,
@@ -49,17 +45,6 @@ function createGatewayHandlers(getService) {
                 safeHandle(respond, "agent_list_failed", error);
             }
         },
-        "multiclaws.agent.add": async ({ params, respond }) => {
-            try {
-                const parsed = agentAddSchema.parse(params);
-                const service = getService();
-                const agent = await service.addAgent(parsed);
-                respond(true, agent);
-            }
-            catch (error) {
-                safeHandle(respond, "invalid_params", error);
-            }
-        },
         "multiclaws.agent.remove": async ({ params, respond }) => {
             try {
                 const parsed = agentRemoveSchema.parse(params);

package/dist/index.js

@@ -45,31 +45,6 @@ function createTools(getService) {
             return textResult(JSON.stringify({ agents }, null, 2), { agents });
         },
     };
-    const multiclawsAddAgent = {
-        name: "multiclaws_add_agent",
-        description: "Add a remote A2A agent by URL. Automatically fetches its Agent Card.",
-        parameters: {
-            type: "object",
-            additionalProperties: false,
-            properties: {
-                url: { type: "string" },
-                apiKey: { type: "string" },
-            },
-            required: ["url"],
-        },
-        execute: async (_toolCallId, args) => {
-            const service = requireService(getService());
-            const url = typeof args.url === "string" ? args.url.trim() : "";
-            if (!url)
-                throw new Error("url is required");
-            const apiKey = typeof args.apiKey === "string" ? args.apiKey.trim() : undefined;
-            const agent = await service.addAgent({ url, apiKey });
-            const status = agent.reachable
-                ? `Agent added: ${agent.name} (${agent.url})`
-                : `⚠️ Agent added but NOT reachable: ${agent.url} — agent card could not be fetched. Verify the URL and ensure the agent is running.`;
-            return textResult(status, agent);
-        },
-    };
     const multiclawsRemoveAgent = {
         name: "multiclaws_remove_agent",
         description: "Remove a known A2A agent by URL.",
@@ -349,7 +324,6 @@ function createTools(getService) {
     };
     return [
         multiclawsAgents,
-        multiclawsAddAgent,
         multiclawsRemoveAgent,
         multiclawsSessionStart,
         multiclawsSessionReply,
@@ -375,19 +349,34 @@ const plugin = {
         (0, telemetry_1.initializeTelemetry)({ enableConsoleExporter: config.telemetry?.consoleExporter });
         const structured = (0, logger_1.createStructuredLogger)(api.logger, "multiclaws");
         let service = null;
-        // Ensure required tools are in gateway.tools.allow at registration time
-        // so the gateway starts with them already present (no restart needed).
+        // Ensure plugin tools and gateway dependencies are whitelisted at registration time.
+        // tools.alsoAllow is additive and won't override the user's tools.profile setting.
         if (api.config) {
             const gw = api.config.gateway;
             if (gw) {
                 const tools = (gw.tools ?? {});
+                // 1. Gateway tools the plugin depends on → tools.allow
                 const allow = Array.isArray(tools.allow) ? tools.allow : [];
-                const required = ["sessions_spawn", "sessions_history", "message"];
-                const missing = required.filter((t) => !allow.includes(t));
-                if (missing.length > 0) {
-                    tools.allow = [...allow, ...missing];
-                    gw.tools = tools;
+                const requiredGatewayTools = ["sessions_spawn", "sessions_history", "message"];
+                const missingGateway = requiredGatewayTools.filter((t) => !allow.includes(t));
+                if (missingGateway.length > 0) {
+                    tools.allow = [...allow, ...missingGateway];
                 }
+                // 2. Plugin's own tools → tools.alsoAllow (additive, works with any profile)
+                const alsoAllow = Array.isArray(tools.alsoAllow) ? tools.alsoAllow : [];
+                const pluginToolNames = [
+                    "multiclaws_agents", "multiclaws_remove_agent",
+                    "multiclaws_session_start", "multiclaws_session_reply", "multiclaws_session_status",
+                    "multiclaws_session_wait_all", "multiclaws_session_end",
+                    "multiclaws_team_create", "multiclaws_team_join", "multiclaws_team_leave", "multiclaws_team_members",
+                    "multiclaws_profile_set", "multiclaws_profile_show",
+                    "multiclaws_profile_pending_review", "multiclaws_profile_clear_pending_review",
+                ];
+                const missingPlugin = pluginToolNames.filter((t) => !alsoAllow.includes(t));
+                if (missingPlugin.length > 0) {
+                    tools.alsoAllow = [...alsoAllow, ...missingPlugin];
+                }
+                gw.tools = tools;
             }
         }
         const gatewayConfig = (() => {
@@ -466,7 +455,8 @@ const plugin = {
                 return {
                     appendSystemContext: `## MultiClaws 首次安装 — 需要完成档案设置
 
-multiclaws 插件刚安装，需要在本次对话中完成以下初始化流程（优先处理，不管用户说了什么）：
+multiclaws 插件刚安装，需要在本次对话中完成以下初始化流程（优先处理，不管用户说了什么）。
+**务必使用插件工具调用，不要通过命令行或 gateway 方法操作。**
 
 1. **扫描当前环境**，自动生成 bio（markdown 格式），内容包括：
    - 用户角色和职责
@@ -479,9 +469,7 @@ multiclaws 插件刚安装，需要在本次对话中完成以下初始化流程
    - **Bio**：展示生成的 bio，询问是否需要修改
    - **网络情况**：告知用户「同局域网开箱即用；跨网络需安装 Tailscale（https://tailscale.com/download）并重启 OpenClaw」，无需用户回答
 
-3. 根据用户对名字和 bio 的回答更新档案内容（如需修改），然后调用 \`multiclaws_profile_set(ownerName="...", bio="...")\` 保存。
-
-4. 调用 \`multiclaws_profile_clear_pending_review()\` 完成初始化。
+3. 根据用户确认的内容，调用 \`multiclaws_profile_set(ownerName="...", bio="...")\` 保存。保存后初始化自动完成，无需额外操作。
 
 **注意**：名字和 bio 需要用户明确确认；网络情况仅告知无需回答。`,
                 };

package/dist/service/multiclaws-service.d.ts

@@ -50,12 +50,6 @@ export declare class MulticlawsService extends EventEmitter {
     stop(): Promise<void>;
     updateGatewayConfig(config: GatewayConfig): void;
     listAgents(): Promise<AgentRecord[]>;
-    addAgent(params: {
-        url: string;
-        apiKey?: string;
-    }): Promise<AgentRecord & {
-        reachable: boolean;
-    }>;
     removeAgent(url: string): Promise<boolean>;
     startSession(params: {
         agentUrl: string;
@@ -91,6 +85,7 @@ export declare class MulticlawsService extends EventEmitter {
         ownerName?: string;
         bio?: string;
     }): Promise<AgentProfile>;
+    private autoClearPendingReviewIfReady;
     private updateProfileDescription;
     private getPendingReviewPath;
     getPendingProfileReview(): Promise<{

package/dist/service/multiclaws-service.js

@@ -196,30 +196,6 @@ class MulticlawsService extends node_events_1.EventEmitter {
     async listAgents() {
         return await this.agentRegistry.list();
     }
-    async addAgent(params) {
-        const normalizedUrl = params.url.replace(/\/+$/, "");
-        try {
-            const client = await this.clientFactory.createFromUrl(normalizedUrl);
-            const card = await client.getAgentCard();
-            const record = await this.agentRegistry.add({
-                url: normalizedUrl,
-                name: card.name ?? normalizedUrl,
-                description: card.description ?? "",
-                skills: card.skills?.map((s) => s.name ?? s.id) ?? [],
-                apiKey: params.apiKey,
-            });
-            return { ...record, reachable: true };
-        }
-        catch {
-            this.log("warn", `agent at ${normalizedUrl} is not reachable, adding with limited info`);
-            const record = await this.agentRegistry.add({
-                url: normalizedUrl,
-                name: normalizedUrl,
-                apiKey: params.apiKey,
-            });
-            return { ...record, reachable: false };
-        }
-    }
     async removeAgent(url) {
         return await this.agentRegistry.remove(url);
     }
@@ -558,9 +534,20 @@ class MulticlawsService extends node_events_1.EventEmitter {
     async setProfile(patch) {
         const profile = await this.profileStore.update(patch);
         this.updateProfileDescription(profile);
+        // Auto-clear pending review once both ownerName and bio are filled
+        await this.autoClearPendingReviewIfReady(profile);
         await this.broadcastProfileToTeams();
         return profile;
     }
+    async autoClearPendingReviewIfReady(profile) {
+        if (profile.ownerName?.trim() && profile.bio?.trim()) {
+            const review = await this.getPendingProfileReview();
+            if (review.pending) {
+                await this.clearPendingProfileReview();
+                this.log("info", "pending profile review auto-cleared after profile update");
+            }
+        }
+    }
     updateProfileDescription(profile) {
         this.profileDescription = (0, agent_profile_1.renderProfileDescription)(profile);
         if (this.agentCard) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multiclaws",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "MultiClaws plugin for OpenClaw collaboration via A2A protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -53,4 +53,4 @@
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   }
-}
+}

package/skills/multiclaws/SKILL.md

@@ -15,8 +15,9 @@ MultiClaws 让多个 OpenClaw 实例通过 [A2A（Agent-to-Agent）](https://goo
    - **名字**：询问是否需要修改（需用户明确回答）
    - **Bio**：询问是否需要修改（需用户明确回答）
    - **网络情况**：告知「同局域网开箱即用；跨网络需安装 Tailscale」，无需用户回答
-3. 调用 `multiclaws_profile_set(ownerName="...", bio="...")` 保存
-4. 调用 `multiclaws_profile_clear_pending_review()` 完成初始化
+3. 调用 `multiclaws_profile_set(ownerName="...", bio="...")` 保存（pending review 标记会自动清除，无需额外操作）
+
+> **重要**：始终使用插件工具调用，不要通过命令行或 gateway 方法操作 MultiClaws。
 
 ---
 
@@ -131,13 +132,13 @@ multiclaws_profile_show()
 | 工具 | 说明 | 参数 |
 |------|------|------|
 | `multiclaws_agents` | 列出已知 agent 及 bio | — |
-| `multiclaws_add_agent` | 手动添加 agent | `url`, `apiKey`（可选） |
 | `multiclaws_remove_agent` | 移除 agent | `url` |
 
 ---
 
 ## 重要规则
 
+- **始终使用插件工具调用**，不要通过命令行、shell 或 gateway 方法操作 MultiClaws
 - **不要问用户 IP 或 selfUrl**，插件自动处理
 - **Bio 是 markdown**，写得让另一个 AI 能读懂这个 agent 能做什么
 - **名字和 bio 必须用户明确确认**；网络情况仅告知