gopherhole_openclaw_a2a 0.4.5 → 0.4.7

package/dist/src/channel.js

@@ -227,9 +227,19 @@ export const a2aPlugin = {
             const config = account.config;
             ctx.log?.info(`[a2a] Starting A2A channel`);
             ctx.setStatus({ accountId: account.accountId });
-            connectionManager = new A2AConnectionManager(config);
+            const localConnection = new A2AConnectionManager(config);
+            // Defensive: prior plugin versions leaked a connection on every
+            // supervisor auto-restart. If a stale manager is still around, stop it
+            // before overwriting the module-level singleton.
+            if (connectionManager && connectionManager !== localConnection) {
+                try {
+                    await connectionManager.stop();
+                }
+                catch { /* ignore */ }
+            }
+            connectionManager = localConnection;
             // Set up message handler for incoming messages
-            connectionManager.setMessageHandler(async (agentId, message) => {
+            localConnection.setMessageHandler(async (agentId, message) => {
                 if (message.type === 'message' && message.from) {
                     const text = message.content?.parts
                         ?.filter((p) => p.kind === 'text')
@@ -276,24 +286,46 @@ export const a2aPlugin = {
                     }
                 }
             });
-            await connectionManager.start();
+            await localConnection.start();
             ctx.setStatus({
                 accountId: account.accountId,
                 running: true,
                 lastStartAt: Date.now(),
             });
             ctx.log?.info(`[a2a] A2A channel started`);
-            // Return cleanup function
-            return async () => {
+            // OpenClaw's channel supervisor treats resolution of this promise as
+            // "channel exited" and immediately schedules an auto-restart. Hold the
+            // channel open for its lifetime by blocking on the abort signal — the
+            // supervisor aborts it only when it actually wants us to stop.
+            try {
+                await new Promise((resolve) => {
+                    const signal = ctx.abortSignal;
+                    if (!signal)
+                        return; // no signal provided: never resolve
+                    if (signal.aborted) {
+                        resolve();
+                        return;
+                    }
+                    signal.addEventListener('abort', () => resolve(), { once: true });
+                });
+            }
+            finally {
                 ctx.log?.info(`[a2a] Stopping A2A channel`);
-                await connectionManager?.stop();
-                connectionManager = null;
+                try {
+                    await localConnection.stop();
+                }
+                catch (err) {
+                    ctx.log?.error?.(`[a2a] Error during stop: ${err.message}`);
+                }
+                if (connectionManager === localConnection) {
+                    connectionManager = null;
+                }
                 ctx.setStatus({
                     accountId: account.accountId,
                     running: false,
                     lastStopAt: Date.now(),
                 });
-            };
+            }
         },
     },
 };

package/dist/src/gateway-client.d.ts

@@ -1,11 +1,12 @@
 /**
  * Gateway WebSocket Client
- * Sends messages to the Clawdbot gateway via its WebSocket protocol
+ * Sends messages to the OpenClaw gateway via its WebSocket protocol
  *
  * chat.send is non-blocking - it returns a runId immediately and
  * streams the response via chat events. We accumulate deltas and
  * resolve when we get state: "final".
  */
+export declare const GATEWAY_PROTOCOL_VERSION = 4;
 export declare function connectToGateway(port?: number): Promise<void>;
 export declare function callGateway(method: string, params: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
 /**

package/dist/src/gateway-client.js

@@ -1,6 +1,6 @@
 /**
  * Gateway WebSocket Client
- * Sends messages to the Clawdbot gateway via its WebSocket protocol
+ * Sends messages to the OpenClaw gateway via its WebSocket protocol
  *
  * chat.send is non-blocking - it returns a runId immediately and
  * streams the response via chat events. We accumulate deltas and
@@ -16,6 +16,10 @@ let pendingRequests = new Map();
 let pendingChats = new Map(); // keyed by runId
 let connected = false;
 let handshakeComplete = false;
+// OpenClaw 2026.7+ requires gateway protocol v4. Keep this explicit so a
+// protocol bump fails a focused compatibility test instead of silently
+// breaking inbound A2A replies at runtime.
+export const GATEWAY_PROTOCOL_VERSION = 4;
 function getGatewayToken() {
     // Try the current OpenClaw config location first, then the legacy
     // Clawdbot path as a fallback for users still on older installs.
@@ -56,12 +60,12 @@ export async function connectToGateway(port = 18789) {
                 id: connectId,
                 method: 'connect',
                 params: {
-                    minProtocol: 3,
-                    maxProtocol: 3,
+                    minProtocol: GATEWAY_PROTOCOL_VERSION,
+                    maxProtocol: GATEWAY_PROTOCOL_VERSION,
                     client: {
                         id: 'gateway-client',
                         displayName: 'A2A Channel Plugin',
-                        version: '0.3.4',
+                        version: '0.4.7',
                         platform: process.platform,
                         mode: 'backend',
                     },

package/openclaw.plugin.json

@@ -10,5 +10,119 @@
         "description": "Enable the plugin"
       }
     }
+  },
+  "channelConfigs": {
+    "a2a": {
+      "label": "A2A (GopherHole)",
+      "description": "Agent-to-agent communication over the GopherHole hub. Lets other AI agents discover and message this OpenClaw instance.",
+      "schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable the A2A channel"
+          },
+          "apiKey": {
+            "type": "string",
+            "description": "GopherHole API key (starts with gph_)"
+          },
+          "bridgeUrl": {
+            "type": "string",
+            "format": "uri",
+            "default": "wss://hub.gopherhole.ai/ws",
+            "description": "WebSocket URL for the GopherHole hub"
+          },
+          "agentId": {
+            "type": "string",
+            "description": "Canonical hub-side agent ID (e.g. agent-9a2fb7a8). Assigned by the hub; look it up via the GopherHole admin dashboard."
+          },
+          "agentName": {
+            "type": "string",
+            "description": "Display name for this agent; used to build the default agent card when agentCard is not provided."
+          },
+          "agentCard": {
+            "type": "object",
+            "description": "Override the default agent card sent to the hub on connect.",
+            "properties": {
+              "name": { "type": "string" },
+              "description": { "type": "string" },
+              "url": { "type": "string", "format": "uri" },
+              "version": { "type": "string" },
+              "skills": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": { "type": "string" },
+                    "name": { "type": "string" },
+                    "description": { "type": "string" },
+                    "tags": { "type": "array", "items": { "type": "string" } },
+                    "examples": { "type": "array", "items": { "type": "string" } },
+                    "inputModes": { "type": "array", "items": { "type": "string" } },
+                    "outputModes": { "type": "array", "items": { "type": "string" } }
+                  },
+                  "required": ["id", "name"]
+                }
+              }
+            }
+          },
+          "reconnectIntervalMs": {
+            "type": "integer",
+            "minimum": 100,
+            "default": 5000,
+            "description": "Initial reconnect delay in milliseconds. The SDK backs off exponentially up to a 5-minute cap."
+          },
+          "requestTimeoutMs": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 180000,
+            "description": "Timeout in milliseconds for outbound requests and inbound message-response waits."
+          }
+        }
+      },
+      "uiHints": {
+        "": {
+          "label": "A2A (GopherHole)",
+          "help": "Connect this OpenClaw instance to the GopherHole hub so other AI agents can discover and message it. Get an API key at https://gopherhole.ai."
+        },
+        "apiKey": {
+          "label": "API Key",
+          "help": "Your GopherHole API key (starts with gph_). Create one at https://gopherhole.ai settings.",
+          "sensitive": true,
+          "placeholder": "gph_..."
+        },
+        "bridgeUrl": {
+          "label": "Bridge URL",
+          "help": "WebSocket endpoint of the GopherHole hub. Only override for self-hosted deployments.",
+          "advanced": true,
+          "placeholder": "wss://hub.gopherhole.ai/ws"
+        },
+        "agentId": {
+          "label": "Agent ID",
+          "help": "Hub-assigned agent ID. Find it in your GopherHole admin dashboard.",
+          "advanced": true,
+          "placeholder": "agent-xxxxxxxx"
+        },
+        "agentName": {
+          "label": "Display Name",
+          "help": "Human-readable name shown in agent cards and discovery listings."
+        },
+        "agentCard": {
+          "label": "Agent Card",
+          "help": "Advanced: fully override the agent card metadata (name, description, version, skills) registered with the hub on connect.",
+          "advanced": true
+        },
+        "reconnectIntervalMs": {
+          "label": "Reconnect Interval (ms)",
+          "advanced": true
+        },
+        "requestTimeoutMs": {
+          "label": "Request Timeout (ms)",
+          "advanced": true
+        }
+      }
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gopherhole_openclaw_a2a",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "GopherHole A2A plugin for OpenClaw - connect your AI agent to the GopherHole network",
   "type": "module",
   "main": "dist/index.js",
@@ -53,4 +53,4 @@
     "README.md",
     "SKILL.md"
   ]
-}
+}