multiclaws 0.4.20 → 0.4.22

package/dist/service/a2a-adapter.js

@@ -112,6 +112,7 @@ class OpenClawAgentExecutor {
      * Collects ALL assistant text messages and returns them joined.
      */
     async waitForCompletion(sessionKey, timeoutMs, gatewaySessionKey) {
+        this.logger.info(`[a2a-adapter] waitForCompletion(sessionKey=${sessionKey}, timeoutMs=${timeoutMs})`);
         const gateway = this.gatewayConfig;
         const startTime = Date.now();
         let attempt = 0;
@@ -226,6 +227,7 @@ class OpenClawAgentExecutor {
         return null;
     }
     async cancelTask(taskId, eventBus) {
+        this.logger.info(`[a2a-adapter] cancelTask(taskId=${taskId})`);
         this.taskTracker.update(taskId, { status: "failed", error: "canceled" });
         this.publishMessage(eventBus, "Task was canceled.");
         eventBus.finished();

package/dist/service/agent-profile.d.ts

@@ -1,3 +1,4 @@
+import type { BasicLogger } from "../infra/logger";
 export type AgentProfile = {
     ownerName: string;
     /** Free-form markdown describing this agent: role, capabilities, data sources, etc. */
@@ -6,7 +7,9 @@ export type AgentProfile = {
 export declare function renderProfileDescription(profile: AgentProfile): string;
 export declare class ProfileStore {
     private readonly filePath;
-    constructor(filePath: string);
+    private readonly logger?;
+    constructor(filePath: string, logger?: BasicLogger | undefined);
+    private log;
     load(): Promise<AgentProfile>;
     save(profile: AgentProfile): Promise<void>;
     update(patch: Partial<AgentProfile>): Promise<AgentProfile>;

package/dist/service/agent-profile.js

@@ -16,23 +16,44 @@ function renderProfileDescription(profile) {
 }
 class ProfileStore {
     filePath;
-    constructor(filePath) {
+    logger;
+    constructor(filePath, logger) {
         this.filePath = filePath;
+        this.logger = logger;
+    }
+    log(level, message) {
+        const fn = level === "debug" ? this.logger?.debug : this.logger?.[level];
+        fn?.(`[profile-store] ${message}`);
     }
     async load() {
         return await (0, json_store_1.readJsonWithFallback)(this.filePath, emptyProfile());
     }
     async save(profile) {
-        await (0, json_store_1.writeJsonAtomically)(this.filePath, profile);
+        this.log("debug", `save(ownerName=${profile.ownerName})`);
+        try {
+            await (0, json_store_1.writeJsonAtomically)(this.filePath, profile);
+        }
+        catch (err) {
+            this.log("error", `save failed: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
     }
     async update(patch) {
-        const profile = await this.load();
-        if (patch.ownerName !== undefined)
-            profile.ownerName = patch.ownerName;
-        if (patch.bio !== undefined)
-            profile.bio = patch.bio;
-        await this.save(profile);
-        return profile;
+        this.log("debug", `update(keys=${Object.keys(patch).join(",")})`);
+        try {
+            const profile = await this.load();
+            if (patch.ownerName !== undefined)
+                profile.ownerName = patch.ownerName;
+            if (patch.bio !== undefined)
+                profile.bio = patch.bio;
+            await this.save(profile);
+            this.log("debug", `update completed`);
+            return profile;
+        }
+        catch (err) {
+            this.log("error", `update failed: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
     }
 }
 exports.ProfileStore = ProfileStore;

package/dist/service/agent-registry.d.ts

@@ -1,3 +1,4 @@
+import type { BasicLogger } from "../infra/logger";
 export type AgentRecord = {
     url: string;
     name: string;
@@ -9,7 +10,9 @@ export type AgentRecord = {
 };
 export declare class AgentRegistry {
     private readonly filePath;
-    constructor(filePath: string);
+    private readonly logger?;
+    constructor(filePath: string, logger?: BasicLogger | undefined);
+    private log;
     private readStore;
     add(params: {
         url: string;

package/dist/service/agent-registry.js

@@ -19,50 +19,74 @@ function normalizeStore(raw) {
 }
 class AgentRegistry {
     filePath;
-    constructor(filePath) {
+    logger;
+    constructor(filePath, logger) {
         this.filePath = filePath;
+        this.logger = logger;
+    }
+    log(level, message) {
+        const fn = level === "debug" ? this.logger?.debug : this.logger?.[level];
+        fn?.(`[agent-registry] ${message}`);
     }
     async readStore() {
         const store = await (0, json_store_1.readJsonWithFallback)(this.filePath, emptyStore());
         return normalizeStore(store);
     }
     async add(params) {
-        return await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
-            const store = await this.readStore();
-            const normalizedUrl = params.url.replace(/\/+$/, "");
-            const existing = store.agents.findIndex((a) => a.url === normalizedUrl);
-            const now = Date.now();
-            const record = {
-                url: normalizedUrl,
-                name: params.name,
-                description: params.description ?? "",
-                skills: params.skills ?? [],
-                apiKey: params.apiKey,
-                addedAtMs: existing >= 0 ? store.agents[existing].addedAtMs : now,
-                lastSeenAtMs: now,
-            };
-            if (existing >= 0) {
-                store.agents[existing] = record;
-            }
-            else {
-                store.agents.push(record);
-            }
-            await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
-            return record;
-        });
+        const normalizedUrl = params.url.replace(/\/+$/, "");
+        this.log("debug", `add(url=${normalizedUrl}, name=${params.name})`);
+        try {
+            const result = await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+                const store = await this.readStore();
+                const existing = store.agents.findIndex((a) => a.url === normalizedUrl);
+                const now = Date.now();
+                const record = {
+                    url: normalizedUrl,
+                    name: params.name,
+                    description: params.description ?? "",
+                    skills: params.skills ?? [],
+                    apiKey: params.apiKey,
+                    addedAtMs: existing >= 0 ? store.agents[existing].addedAtMs : now,
+                    lastSeenAtMs: now,
+                };
+                if (existing >= 0) {
+                    store.agents[existing] = record;
+                }
+                else {
+                    store.agents.push(record);
+                }
+                await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+                return record;
+            });
+            this.log("debug", `add completed, agent=${result.name}`);
+            return result;
+        }
+        catch (err) {
+            this.log("error", `add failed for url=${normalizedUrl}: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
     }
     async remove(url) {
-        return await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
-            const store = await this.readStore();
-            const normalizedUrl = url.replace(/\/+$/, "");
-            const before = store.agents.length;
-            store.agents = store.agents.filter((a) => a.url !== normalizedUrl);
-            if (store.agents.length === before) {
-                return false;
-            }
-            await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
-            return true;
-        });
+        const normalizedUrl = url.replace(/\/+$/, "");
+        this.log("debug", `remove(url=${normalizedUrl})`);
+        try {
+            const result = await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+                const store = await this.readStore();
+                const before = store.agents.length;
+                store.agents = store.agents.filter((a) => a.url !== normalizedUrl);
+                if (store.agents.length === before) {
+                    return false;
+                }
+                await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+                return true;
+            });
+            this.log("debug", `remove completed, found=${result}`);
+            return result;
+        }
+        catch (err) {
+            this.log("error", `remove failed for url=${normalizedUrl}: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
     }
     async list() {
         const store = await this.readStore();
@@ -74,16 +98,23 @@ class AgentRegistry {
         return store.agents.find((a) => a.url === normalizedUrl) ?? null;
     }
     async updateDescription(url, description) {
-        await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
-            const store = await this.readStore();
-            const normalizedUrl = url.replace(/\/+$/, "");
-            const agent = store.agents.find((a) => a.url === normalizedUrl);
-            if (agent) {
-                agent.description = description;
-                agent.lastSeenAtMs = Date.now();
-                await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
-            }
-        });
+        const normalizedUrl = url.replace(/\/+$/, "");
+        this.log("debug", `updateDescription(url=${normalizedUrl})`);
+        try {
+            await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+                const store = await this.readStore();
+                const agent = store.agents.find((a) => a.url === normalizedUrl);
+                if (agent) {
+                    agent.description = description;
+                    agent.lastSeenAtMs = Date.now();
+                    await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+                }
+            });
+        }
+        catch (err) {
+            this.log("error", `updateDescription failed for url=${normalizedUrl}: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
     }
     async updateLastSeen(url) {
         await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {

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

@@ -42,6 +42,7 @@ export declare class MulticlawsService extends EventEmitter {
     private frpTunnel;
     private selfUrl;
     private profileDescription;
+    private readonly gatewayConfig;
     constructor(options: MulticlawsServiceOptions);
     start(): Promise<void>;
     stop(): Promise<void>;
@@ -56,6 +57,25 @@ export declare class MulticlawsService extends EventEmitter {
         agentUrl: string;
         task: string;
     }): Promise<DelegateTaskResult>;
+    /**
+     * Synchronous delegation: sends A2A task and waits for the result.
+     * Used by sub-agents internally via the multiclaws_delegate_send tool.
+     */
+    delegateTaskSync(params: {
+        agentUrl: string;
+        task: string;
+    }): Promise<DelegateTaskResult>;
+    /**
+     * Spawn a sub-agent to handle delegation asynchronously.
+     * The sub-agent uses multiclaws_delegate_send internally and
+     * reports results back to the user via the message tool.
+     */
+    spawnDelegation(params: {
+        agentUrl: string;
+        task: string;
+    }): Promise<{
+        message: string;
+    }>;
     getTaskStatus(taskId: string): import("../task/tracker").TaskRecord | null;
     getProfile(): Promise<AgentProfile>;
     /**
@@ -103,5 +123,7 @@ export declare class MulticlawsService extends EventEmitter {
     private extractArtifactText;
     /** Fetch with up to 2 retries and exponential backoff. */
     private fetchWithRetry;
+    /** Send a notification message to the local user via the gateway message tool. */
+    private notifyUser;
     private log;
 }