@perkos/perkos-a2a 0.12.35 → 0.12.36

package/README.md

@@ -248,7 +248,7 @@ routing.
 
 ```bash
 A2A_RELAY_API_KEY='<credential-from-invitation>' \
-npx --yes @perkos/perkos-a2a@0.12.35 connect \
+npx --yes @perkos/perkos-a2a@0.12.36 connect \
   --artifact ./perkos-a2a.tgz \
   --sha256 '<sha256-from-the-official-invitation>' \
   --agent-name '<agent-name>' \

package/dist/index.d.ts

@@ -53,5 +53,12 @@ export declare function runOpenClawChatTurn(api: any, config: A2APluginConfig, s
 export declare function formatRecentChatContext(messages: ChatMessage[], currentMessageId: string): string;
 /** The identity the relay treats as exclusive; names are display metadata. */
 export declare function a2aLifecycleKey(config: A2APluginConfig): string;
+/**
+ * OpenClaw may briefly call register while a plugin entry is being rewritten.
+ * Treat partial/empty config as an inert, valid shape instead of crashing the
+ * whole service on string operations. The repair CLI restores the complete
+ * identity atomically before the service is enabled.
+ */
+export declare function normalizeOpenClawPluginConfig(value: unknown): A2APluginConfig;
 export default function register(api: any): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAGV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,cAAc,YAAY,CAAC;AA0C3B,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AASpD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CA2BT;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,oBAAoB,EAC3B,eAAe,CAAC,EAAE,MAAM,GACvB,oBAAoB,CA+BtB;AAiED,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,EAAE;QACL,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAYrF;AAQD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,GAClF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuFxB;AAYD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAWR;AA4CD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAe/D;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAuzBxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAGV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,cAAc,YAAY,CAAC;AA0C3B,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AASpD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CA2BT;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,oBAAoB,EAC3B,eAAe,CAAC,EAAE,MAAM,GACvB,oBAAoB,CA+BtB;AAiED,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,EAAE;QACL,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAYrF;AAQD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,GAClF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuFxB;AAYD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAWR;AA4CD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAe/D;AAMD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAc7E;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAozBxC"}

package/dist/index.js

@@ -28530,17 +28530,42 @@ var OpenClawSupervisorClient = class {
       const oldHealth = this.health;
       this.closeSocket(new Error("SUPERVISOR_ROLLOVER"));
       await this.waitForSupervisorStop(oldHealth, 1e4);
-      await this.connectOrSpawn();
-      const target = await this.claimCurrentSupervisor();
-      if (!this.healthMatchesTarget(target.health)) {
-        throw new Error(`SUPERVISOR_ROLLOVER_TARGET_MISMATCH:${reason}`);
-      }
+      const target = await this.claimTargetAfterRollover(reason);
       this.logger.info(`[perkos-a2a] Supervisor rollover complete targetVersion=${this.config.version}`);
       return target;
     } finally {
       releaseLock();
     }
   }
+  /**
+   * OpenClaw can register two adjacent hot-reload generations while its config
+   * file is settling. The first generation may successfully bootstrap the
+   * target supervisor just as its client socket is replaced. Reconnect to that
+   * single fenced supervisor instead of abandoning the agent offline.
+   */
+  async claimTargetAfterRollover(reason) {
+    let lastError;
+    for (let attempt = 1; attempt <= 3; attempt += 1) {
+      try {
+        await this.connectOrSpawn();
+        const target = await this.claimCurrentSupervisor();
+        if (!this.healthMatchesTarget(target.health)) {
+          throw new Error(`SUPERVISOR_ROLLOVER_TARGET_MISMATCH:${reason}`);
+        }
+        return target;
+      } catch (error) {
+        lastError = error;
+        this.closeSocket(new Error("SUPERVISOR_ROLLOVER_TARGET_RETRY"));
+        this.logger.error(
+          `[perkos-a2a] Supervisor target claim retry ${attempt}/3: ${error instanceof Error ? error.message : String(error)}`
+        );
+        if (attempt < 3) await new Promise((resolveWait) => setTimeout(resolveWait, 250));
+      }
+    }
+    throw new Error(
+      `SUPERVISOR_ROLLOVER_TARGET_START_FAILED:${lastError instanceof Error ? lastError.message : String(lastError)}`
+    );
+  }
   async acquireRolloverLock(timeoutMs = 15e3) {
     const path = supervisorRolloverLockPath(this.stateDir, this.ownerHash);
     mkdirSync2(dirname2(path), { recursive: true, mode: 448 });
@@ -29607,16 +29632,29 @@ function a2aLifecycleKey(config) {
   }
   const heartbeatUrl = config.platform?.heartbeatUrl || "";
   const idFromHeartbeat = heartbeatUrl.match(/\/agents\/([^/]+)\/heartbeat(?:\?|$)/u)?.[1];
-  const agentId = config.platform?.agentId || idFromHeartbeat || config.agentName.trim().toLowerCase();
+  const agentId = config.platform?.agentId || idFromHeartbeat || safeAgentName(config.agentName).toLowerCase();
   return `${relayUrl}|${agentId}`;
 }
-function register(api) {
-  const pluginConfig = api.config?.plugins?.entries?.["perkos-a2a"]?.config || {
-    agentName: "agent",
-    port: 5050,
-    skills: [],
-    peers: {}
+function safeAgentName(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : "agent";
+}
+function normalizeOpenClawPluginConfig(value) {
+  const raw = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  const platform = raw.platform && typeof raw.platform === "object" ? raw.platform : void 0;
+  const heartbeatAgentId = platform?.heartbeatUrl?.match(/\/agents\/([^/]+)\/heartbeat/u)?.[1];
+  const agentName = safeAgentName(raw.agentName || platform?.agentId || heartbeatAgentId);
+  return {
+    ...raw,
+    agentName,
+    port: typeof raw.port === "number" ? raw.port : 5050,
+    skills: Array.isArray(raw.skills) ? raw.skills : [],
+    peers: raw.peers && typeof raw.peers === "object" ? raw.peers : {}
   };
+}
+function register(api) {
+  const pluginConfig = normalizeOpenClawPluginConfig(
+    api.config?.plugins?.entries?.["perkos-a2a"]?.config
+  );
   const logger = api.logger || console;
   const pluginVersion = loadedPluginVersion();
   const pluginRoot = resolve3(dirname3(fileURLToPath2(import.meta.url)), "..");
@@ -29880,7 +29918,7 @@ function register(api) {
   if (pluginConfig.chat?.enabled && !chatApiKey) {
     logger.error("[perkos-chat] chat.enabled=true but no apiKey (set chat.apiKey or fall back from relay.apiKey)");
   }
-  const platformAgentId = pluginConfig.platform?.agentId || pluginConfig.platform?.heartbeatUrl?.match(/\/agents\/([^/]+)\/heartbeat/u)?.[1] || pluginConfig.agentName.trim().toLowerCase();
+  const platformAgentId = pluginConfig.platform?.agentId || pluginConfig.platform?.heartbeatUrl?.match(/\/agents\/([^/]+)\/heartbeat/u)?.[1] || safeAgentName(pluginConfig.agentName).toLowerCase();
   supervisorClient = new OpenClawSupervisorClient({
     ownerHash: supervisorOwnerHash(lifecycleKey),
     generation: Date.now(),
@@ -30325,6 +30363,7 @@ export {
   extractOpenClawChatReply,
   formatRecentChatContext,
   isWebhookEvent,
+  normalizeOpenClawPluginConfig,
   omitUnavailableAgentHarness,
   openclawChatSessionKey,
   runOpenClawChatTurn