@perkos/perkos-a2a 0.12.62 → 0.12.63

package/dist/index.js

@@ -18441,10 +18441,10 @@ var require_view = __commonJS({
     var debug = require_src()("express:view");
     var path = __require("path");
     var fs = __require("fs");
-    var dirname4 = path.dirname;
+    var dirname5 = path.dirname;
     var basename = path.basename;
     var extname = path.extname;
-    var join4 = path.join;
+    var join5 = path.join;
     var resolve4 = path.resolve;
     module.exports = View;
     function View(name, options) {
@@ -18480,7 +18480,7 @@ var require_view = __commonJS({
       for (var i = 0; i < roots.length && !path2; i++) {
         var root = roots[i];
         var loc = resolve4(root, name);
-        var dir = dirname4(loc);
+        var dir = dirname5(loc);
         var file = basename(loc);
         path2 = this.resolve(dir, file);
       }
@@ -18492,12 +18492,12 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve5(dir, file) {
       var ext = this.ext;
-      var path2 = join4(dir, file);
+      var path2 = join5(dir, file);
       var stat = tryStat(path2);
       if (stat && stat.isFile()) {
         return path2;
       }
-      path2 = join4(dir, basename(file, ext), "index" + ext);
+      path2 = join5(dir, basename(file, ext), "index" + ext);
       stat = tryStat(path2);
       if (stat && stat.isFile()) {
         return path2;
@@ -19130,7 +19130,7 @@ var require_send = __commonJS({
     var Stream = __require("stream");
     var util = __require("util");
     var extname = path.extname;
-    var join4 = path.join;
+    var join5 = path.join;
     var normalize = path.normalize;
     var resolve4 = path.resolve;
     var sep = path.sep;
@@ -19349,7 +19349,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path2.split(sep);
-        path2 = normalize(join4(root, path2));
+        path2 = normalize(join5(root, path2));
       } else {
         if (UP_PATH_REGEXP.test(path2)) {
           debug('malicious path "%s"', path2);
@@ -19484,7 +19484,7 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join4(path2, self._index[i]);
+        var p = join5(path2, self._index[i]);
         debug('stat "%s"', p);
         fs.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -27779,8 +27779,8 @@ var A2AServer = class {
 // src/index.ts
 import { randomUUID as randomUUID7 } from "crypto";
 import { readFileSync as readFileSync5 } from "node:fs";
-import { dirname as dirname3, resolve as resolve3 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { dirname as dirname4, resolve as resolve3 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/task-context.ts
 function perkosTaskContext(task, trustedDispatcher = process.env.PERKOS_DISPATCHER_AGENT_NAME || "perkos-ci-probe-dispatcher") {
@@ -29306,6 +29306,138 @@ async function tryHandleInstalledVoiceMarker(message, config, loadVoice = defaul
   });
 }
 
+// src/a2a-maintenance.ts
+import { spawn as spawn2 } from "node:child_process";
+import { chmod, mkdir as mkdir2, readdir, readFile as readFile2, rename, unlink, writeFile as writeFile2 } from "node:fs/promises";
+import { homedir as homedir5 } from "node:os";
+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;
+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 };
+}
+function maintenanceRoot(agentId) {
+  return join4(homedir5(), ".perkos", "a2a", "hermes", agentId, "maintenance");
+}
+async function atomicPrivateJson(path, value) {
+  await mkdir2(dirname3(path), { recursive: true, mode: 448 });
+  const temporary = `${path}.${process.pid}.tmp`;
+  await writeFile2(temporary, `${JSON.stringify(value)}
+`, { mode: 384 });
+  await chmod(temporary, 384);
+  await rename(temporary, path);
+}
+async function authorizedJson(url, relayApiKey, init = {}) {
+  const response = await fetch(url, {
+    ...init,
+    headers: {
+      authorization: `Bearer ${relayApiKey}`,
+      "content-type": "application/json",
+      ...init.headers ?? {}
+    },
+    signal: AbortSignal.timeout(15e3)
+  });
+  const body = await response.json().catch(() => null);
+  if (!response.ok || !body) throw new Error(`control_plane_${response.status}`);
+  return body;
+}
+async function claimRequest(target, requestId) {
+  const body = await authorizedJson(
+    `${target.apiBaseUrl}/agents/${encodeURIComponent(target.agentId)}/maintenance/a2a-update/${requestId}/claim`,
+    target.relayApiKey,
+    { method: "POST", body: "{}" }
+  );
+  const request = body.request;
+  if (typeof request?.targetVersion !== "string" || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(request.targetVersion)) {
+    throw new Error("invalid_target_version");
+  }
+  return { targetVersion: request.targetVersion };
+}
+async function queueHermesMaintenanceJob(job) {
+  const root = maintenanceRoot(job.agentId);
+  const jobPath = join4(root, "jobs", `${job.requestId}.json`);
+  await atomicPrivateJson(jobPath, job);
+  const runnerPath = fileURLToPath2(new URL("./maintenance-runner.js", import.meta.url));
+  const child = spawn2(process.execPath, [runnerPath, "--job", jobPath], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+}
+async function tryHandleA2AMaintenanceMarker(message, config, deps = {}) {
+  const requestId = parseA2AUpdateMarker(message);
+  if (!requestId) return null;
+  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);
+    await (deps.queue ?? queueHermesMaintenanceJob)({
+      schemaVersion: 1,
+      requestId,
+      agentId: target.agentId,
+      targetVersion,
+      apiBaseUrl: target.apiBaseUrl,
+      relayApiKey: target.relayApiKey
+    });
+    return `PERKOS_A2A_UPDATE_ACCEPTED:${requestId}`;
+  } catch {
+    return "PERKOS_A2A_UPDATE_FAILED:request_rejected";
+  }
+}
+async function reportReceipt(receipt, target) {
+  await authorizedJson(
+    `${target.apiBaseUrl}/agents/${encodeURIComponent(target.agentId)}/maintenance/a2a-update/${receipt.requestId}/report`,
+    target.relayApiKey,
+    {
+      method: "POST",
+      body: JSON.stringify({
+        state: receipt.state,
+        ...receipt.installedVersion ? { installedVersion: receipt.installedVersion } : {},
+        ...receipt.errorCode ? { errorCode: receipt.errorCode } : {}
+      })
+    }
+  );
+}
+async function flushMaintenanceReceipts(config) {
+  const target = maintenanceControlPlane(config);
+  if (!target) return;
+  const receiptsDir = join4(maintenanceRoot(target.agentId), "receipts");
+  const files = await readdir(receiptsDir).catch(() => []);
+  for (const file of files) {
+    if (!file.endsWith(".json")) continue;
+    const path = join4(receiptsDir, file);
+    try {
+      const receipt = JSON.parse(await readFile2(path, "utf8"));
+      if (receipt.agentId !== target.agentId || receipt.apiBaseUrl !== target.apiBaseUrl || !REQUEST_ID.test(receipt.requestId)) continue;
+      await reportReceipt(receipt, target);
+      await unlink(path);
+    } catch {
+    }
+  }
+}
+
 // src/chat-client.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 var DEFAULT_URL = "wss://chat.perkos.xyz/chat";
@@ -30164,7 +30296,7 @@ function register(api) {
   );
   const logger = api.logger || console;
   const pluginVersion = loadedPluginVersion();
-  const pluginRoot = resolve3(dirname3(fileURLToPath2(import.meta.url)), "..");
+  const pluginRoot = resolve3(dirname4(fileURLToPath3(import.meta.url)), "..");
   const server = new A2AServer(pluginConfig, logger, { relayOwnership: "external-required" });
   const lifecycleKey = a2aLifecycleKey(pluginConfig);
   const lifecycleInstanceId = randomUUID7();
@@ -30349,6 +30481,13 @@ function register(api) {
   let supervisorClient;
   const handleSupervisorChatDeliver = async (frame) => {
     const walletAddress = parseWalletFromIdentity(frame.from);
+    const maintenanceReply = await tryHandleA2AMaintenanceMarker(frame.text, pluginConfig);
+    if (maintenanceReply) {
+      if (walletAddress) {
+        await supervisorClient.sendChatReply({ convId: frame.convId, walletAddress, text: maintenanceReply, replyTo: frame.id });
+      }
+      return;
+    }
     const voiceReply = await tryHandleInstalledVoiceMarker(frame.text, pluginConfig);
     if (voiceReply) {
       if (walletAddress) {
@@ -30485,6 +30624,7 @@ function register(api) {
     start: async () => {
       try {
         await supervisorClient.start();
+        void flushMaintenanceReceipts(pluginConfig);
         const ownerHealth = supervisorClient.currentHealth();
         recordRuntimeLoadEvidence({
           config: pluginConfig,
@@ -30887,6 +31027,7 @@ export {
   A2AServer,
   ChatClient,
   ChatStore,
+  PERKOS_A2A_UPDATE_PREFIX,
   PERKOS_VOICE_ENROLL_MARKER,
   PERKOS_VOICE_PROBE_MARKER,
   RelayClient,
@@ -30896,15 +31037,20 @@ export {
   register as default,
   detectNetworking,
   extractOpenClawChatReply,
+  flushMaintenanceReceipts,
   formatRecentChatContext,
   isWebhookEvent,
+  maintenanceControlPlane,
   normalizeOpenClawPluginConfig,
   omitUnavailableAgentHarness,
   openclawChatSessionKey,
+  parseA2AUpdateMarker,
   prepareOpenClawChatSession,
+  queueHermesMaintenanceJob,
   resolveOpenClawRuntimeModelRoute,
   runOpenClawChatTurn,
   stripPerkosChatTransportMarker,
+  tryHandleA2AMaintenanceMarker,
   tryHandleInstalledVoiceMarker,
   useNativeHarnessForResolvedRoute
 };