@perkos/perkos-a2a 0.12.63 → 0.12.65

package/dist/index.js

@@ -29244,18 +29244,10 @@ function usesHttpDelivery(runtimeKind) {
   return runtimeKind === "hermes" || runtimeKind === "hermes-api" || runtimeKind === "zeroclaw" || runtimeKind === "custom";
 }
 
-// src/voice-capability.ts
-var PERKOS_VOICE_PROBE_MARKER = "PERKOS_VOICE_PROBE";
-var PERKOS_VOICE_ENROLL_MARKER = "PERKOS_VOICE_ENROLL";
-function runtime(runtimeKind) {
-  if (runtimeKind === "hermes" || runtimeKind === "hermes-api") return "hermes";
-  if (runtimeKind === "openclaw") return "openclaw";
-  if (runtimeKind === "zeroclaw") return "zeroclaw";
-  return null;
-}
-function controlPlane(config) {
-  const heartbeat = config.platform?.heartbeatUrl;
-  const relayApiKey = config.relay?.apiKey || config.chat?.apiKey;
+// src/platform-control-plane.ts
+function resolvePlatformControlPlane(config, env = process.env) {
+  const heartbeat = config.platform?.heartbeatUrl?.trim() || env.PERKOS_HEARTBEAT_URL?.trim();
+  const relayApiKey = config.relay?.apiKey?.trim() || config.chat?.apiKey?.trim() || env.A2A_RELAY_API_KEY?.trim() || env.A2A_CHAT_API_KEY?.trim();
   if (!heartbeat || !relayApiKey) return null;
   let url;
   try {
@@ -29264,13 +29256,23 @@ function controlPlane(config) {
     return null;
   }
   const match = url.pathname.match(/^(.*)\/agents\/([^/]+)\/heartbeat\/?$/u);
-  const agentId = config.platform?.agentId || (match ? decodeURIComponent(match[2]) : "");
+  const agentId = config.platform?.agentId?.trim() || (match ? decodeURIComponent(match[2]) : "") || env.PERKOS_AGENT_ID?.trim();
   if (!match || !agentId) return null;
   return { apiBaseUrl: `${url.origin}${match[1]}`, agentId, relayApiKey };
 }
+
+// src/voice-capability.ts
+var PERKOS_VOICE_PROBE_MARKER = "PERKOS_VOICE_PROBE";
+var PERKOS_VOICE_ENROLL_MARKER = "PERKOS_VOICE_ENROLL";
+function runtime(runtimeKind) {
+  if (runtimeKind === "hermes" || runtimeKind === "hermes-api") return "hermes";
+  if (runtimeKind === "openclaw") return "openclaw";
+  if (runtimeKind === "zeroclaw") return "zeroclaw";
+  return null;
+}
 async function reportPluginMissing(message, config) {
   if (message !== PERKOS_VOICE_PROBE_MARKER) return "PERKOS_VOICE_FAILED:voice_plugin_missing";
-  const target = controlPlane(config);
+  const target = resolvePlatformControlPlane(config);
   if (!target) return "PERKOS_VOICE_FAILED:a2a_identity_unavailable";
   const response = await fetch(`${target.apiBaseUrl}/agents/${encodeURIComponent(target.agentId)}/voice-credential/capability-report`, {
     method: "POST",
@@ -29286,7 +29288,7 @@ async function defaultLoader() {
 async function tryHandleInstalledVoiceMarker(message, config, loadVoice = defaultLoader) {
   const marker = message.trim();
   if (marker !== PERKOS_VOICE_PROBE_MARKER && marker !== PERKOS_VOICE_ENROLL_MARKER) return null;
-  const target = controlPlane(config);
+  const target = resolvePlatformControlPlane(config);
   if (!target) return "PERKOS_VOICE_FAILED:a2a_identity_unavailable";
   const runtimeKind = runtime(config.runtime?.kind);
   if (!runtimeKind) return reportPluginMissing(marker, config);
@@ -29314,27 +29316,14 @@ import { dirname as dirname3, join as join4 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var PERKOS_A2A_UPDATE_PREFIX = "PERKOS_A2A_UPDATE:";
 var REQUEST_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var BRIDGE_INSTANCE_ID = REQUEST_ID;
 function parseA2AUpdateMarker(message) {
   const marker = message.trim();
   if (!marker.startsWith(PERKOS_A2A_UPDATE_PREFIX)) return null;
-  const requestId = marker.slice(PERKOS_A2A_UPDATE_PREFIX.length);
-  return REQUEST_ID.test(requestId) ? requestId : null;
-}
-function maintenanceControlPlane(config) {
-  const heartbeat = config.platform?.heartbeatUrl;
-  const relayApiKey = config.relay?.apiKey || config.chat?.apiKey;
-  if (!heartbeat || !relayApiKey) return null;
-  let url;
-  try {
-    url = new URL(heartbeat);
-  } catch {
-    return null;
-  }
-  const match = url.pathname.match(/^(.*)\/agents\/([^/]+)\/heartbeat\/?$/u);
-  const agentId = config.platform?.agentId || (match ? decodeURIComponent(match[2]) : "");
-  if (!match || !agentId) return null;
-  return { apiBaseUrl: `${url.origin}${match[1]}`, agentId, relayApiKey };
+  const [requestId, bridgeInstanceId, extra] = marker.slice(PERKOS_A2A_UPDATE_PREFIX.length).split(":");
+  return !extra && requestId && bridgeInstanceId && REQUEST_ID.test(requestId) && BRIDGE_INSTANCE_ID.test(bridgeInstanceId) ? { requestId, bridgeInstanceId } : null;
 }
+var maintenanceControlPlane = resolvePlatformControlPlane;
 function maintenanceRoot(agentId) {
   return join4(homedir5(), ".perkos", "a2a", "hermes", agentId, "maintenance");
 }
@@ -29360,11 +29349,11 @@ async function authorizedJson(url, relayApiKey, init = {}) {
   if (!response.ok || !body) throw new Error(`control_plane_${response.status}`);
   return body;
 }
-async function claimRequest(target, requestId) {
+async function claimRequest(target, requestId, bridgeInstanceId) {
   const body = await authorizedJson(
     `${target.apiBaseUrl}/agents/${encodeURIComponent(target.agentId)}/maintenance/a2a-update/${requestId}/claim`,
     target.relayApiKey,
-    { method: "POST", body: "{}" }
+    { method: "POST", body: "{}", headers: { "x-perkos-bridge-instance": bridgeInstanceId } }
   );
   const request = body.request;
   if (typeof request?.targetVersion !== "string" || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(request.targetVersion)) {
@@ -29384,15 +29373,19 @@ async function queueHermesMaintenanceJob(job) {
   child.unref();
 }
 async function tryHandleA2AMaintenanceMarker(message, config, deps = {}) {
-  const requestId = parseA2AUpdateMarker(message);
-  if (!requestId) return null;
+  const marker = parseA2AUpdateMarker(message);
+  if (!marker) return null;
+  const { requestId, bridgeInstanceId } = marker;
+  if (!deps.bridgeInstanceId || deps.bridgeInstanceId !== bridgeInstanceId) {
+    return "PERKOS_A2A_UPDATE_FAILED:bridge_instance_mismatch";
+  }
   if (config.runtime?.kind !== "hermes" && config.runtime?.kind !== "hermes-api") {
     return "PERKOS_A2A_UPDATE_FAILED:runtime_unsupported";
   }
   const target = maintenanceControlPlane(config);
   if (!target) return "PERKOS_A2A_UPDATE_FAILED:a2a_identity_unavailable";
   try {
-    const { targetVersion } = await (deps.claim ?? claimRequest)(target, requestId);
+    const { targetVersion } = await (deps.claim ?? claimRequest)(target, requestId, bridgeInstanceId);
     await (deps.queue ?? queueHermesMaintenanceJob)({
       schemaVersion: 1,
       requestId,
@@ -29463,6 +29456,11 @@ var ChatClient = class {
   authed = false;
   stopped = false;
   generation = 0;
+  setAuthed(value) {
+    if (this.authed === value) return;
+    this.authed = value;
+    this.handlers.onConnectionStateChange?.(value);
+  }
   constructor(opts) {
     this.agentName = opts.agentName;
     const cfg = opts.config;
@@ -29624,7 +29622,7 @@ var ChatClient = class {
       }
       if (!this.isCurrent(generation, socket)) return;
       this.connected = false;
-      this.authed = false;
+      this.setAuthed(false);
       this.clearTimers();
       if (!this.stopped) {
         this.logger.info(`[perkos-chat] disconnected (${code}: ${reason?.toString() || "no reason"}); reconnecting`);
@@ -29639,7 +29637,7 @@ var ChatClient = class {
   async handleFrame(frame) {
     switch (frame.type) {
       case "auth_ok":
-        this.authed = true;
+        this.setAuthed(true);
         this.logger.info(`[perkos-chat] authed as agent:${this.agentName}`);
         this.startHeartbeat();
         return;
@@ -29850,7 +29848,7 @@ var ChatClient = class {
     const socket = this.ws;
     this.ws = null;
     this.connected = false;
-    this.authed = false;
+    this.setAuthed(false);
     return socket;
   }
 };