@perkos/perkos-a2a 0.12.22 → 0.12.27

package/dist/index.js

@@ -22632,218 +22632,6 @@ var require_constants = __commonJS({
   }
 });
 
-// ../../../../node_modules/node-gyp-build/node-gyp-build.js
-var require_node_gyp_build = __commonJS({
-  "../../../../node_modules/node-gyp-build/node-gyp-build.js"(exports, module) {
-    var fs = __require("fs");
-    var path = __require("path");
-    var os = __require("os");
-    var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : __require;
-    var vars = process.config && process.config.variables || {};
-    var prebuildsOnly = !!process.env.PREBUILDS_ONLY;
-    var abi = process.versions.modules;
-    var runtime = isElectron() ? "electron" : isNwjs() ? "node-webkit" : "node";
-    var arch = process.env.npm_config_arch || os.arch();
-    var platform = process.env.npm_config_platform || os.platform();
-    var libc = process.env.LIBC || (isAlpine(platform) ? "musl" : "glibc");
-    var armv = process.env.ARM_VERSION || (arch === "arm64" ? "8" : vars.arm_version) || "";
-    var uv = (process.versions.uv || "").split(".")[0];
-    module.exports = load;
-    function load(dir) {
-      return runtimeRequire(load.resolve(dir));
-    }
-    load.resolve = load.path = function(dir) {
-      dir = path.resolve(dir || ".");
-      try {
-        var name = runtimeRequire(path.join(dir, "package.json")).name.toUpperCase().replace(/-/g, "_");
-        if (process.env[name + "_PREBUILD"]) dir = process.env[name + "_PREBUILD"];
-      } catch (err) {
-      }
-      if (!prebuildsOnly) {
-        var release = getFirst(path.join(dir, "build/Release"), matchBuild);
-        if (release) return release;
-        var debug = getFirst(path.join(dir, "build/Debug"), matchBuild);
-        if (debug) return debug;
-      }
-      var prebuild = resolve(dir);
-      if (prebuild) return prebuild;
-      var nearby = resolve(path.dirname(process.execPath));
-      if (nearby) return nearby;
-      var target = [
-        "platform=" + platform,
-        "arch=" + arch,
-        "runtime=" + runtime,
-        "abi=" + abi,
-        "uv=" + uv,
-        armv ? "armv=" + armv : "",
-        "libc=" + libc,
-        "node=" + process.versions.node,
-        process.versions.electron ? "electron=" + process.versions.electron : "",
-        typeof __webpack_require__ === "function" ? "webpack=true" : ""
-        // eslint-disable-line
-      ].filter(Boolean).join(" ");
-      throw new Error("No native build was found for " + target + "\n    loaded from: " + dir + "\n");
-      function resolve(dir2) {
-        var tuples = readdirSync(path.join(dir2, "prebuilds")).map(parseTuple);
-        var tuple = tuples.filter(matchTuple(platform, arch)).sort(compareTuples)[0];
-        if (!tuple) return;
-        var prebuilds = path.join(dir2, "prebuilds", tuple.name);
-        var parsed = readdirSync(prebuilds).map(parseTags);
-        var candidates = parsed.filter(matchTags(runtime, abi));
-        var winner = candidates.sort(compareTags(runtime))[0];
-        if (winner) return path.join(prebuilds, winner.file);
-      }
-    };
-    function readdirSync(dir) {
-      try {
-        return fs.readdirSync(dir);
-      } catch (err) {
-        return [];
-      }
-    }
-    function getFirst(dir, filter) {
-      var files = readdirSync(dir).filter(filter);
-      return files[0] && path.join(dir, files[0]);
-    }
-    function matchBuild(name) {
-      return /\.node$/.test(name);
-    }
-    function parseTuple(name) {
-      var arr = name.split("-");
-      if (arr.length !== 2) return;
-      var platform2 = arr[0];
-      var architectures = arr[1].split("+");
-      if (!platform2) return;
-      if (!architectures.length) return;
-      if (!architectures.every(Boolean)) return;
-      return { name, platform: platform2, architectures };
-    }
-    function matchTuple(platform2, arch2) {
-      return function(tuple) {
-        if (tuple == null) return false;
-        if (tuple.platform !== platform2) return false;
-        return tuple.architectures.includes(arch2);
-      };
-    }
-    function compareTuples(a, b) {
-      return a.architectures.length - b.architectures.length;
-    }
-    function parseTags(file) {
-      var arr = file.split(".");
-      var extension2 = arr.pop();
-      var tags = { file, specificity: 0 };
-      if (extension2 !== "node") return;
-      for (var i = 0; i < arr.length; i++) {
-        var tag = arr[i];
-        if (tag === "node" || tag === "electron" || tag === "node-webkit") {
-          tags.runtime = tag;
-        } else if (tag === "napi") {
-          tags.napi = true;
-        } else if (tag.slice(0, 3) === "abi") {
-          tags.abi = tag.slice(3);
-        } else if (tag.slice(0, 2) === "uv") {
-          tags.uv = tag.slice(2);
-        } else if (tag.slice(0, 4) === "armv") {
-          tags.armv = tag.slice(4);
-        } else if (tag === "glibc" || tag === "musl") {
-          tags.libc = tag;
-        } else {
-          continue;
-        }
-        tags.specificity++;
-      }
-      return tags;
-    }
-    function matchTags(runtime2, abi2) {
-      return function(tags) {
-        if (tags == null) return false;
-        if (tags.runtime && tags.runtime !== runtime2 && !runtimeAgnostic(tags)) return false;
-        if (tags.abi && tags.abi !== abi2 && !tags.napi) return false;
-        if (tags.uv && tags.uv !== uv) return false;
-        if (tags.armv && tags.armv !== armv) return false;
-        if (tags.libc && tags.libc !== libc) return false;
-        return true;
-      };
-    }
-    function runtimeAgnostic(tags) {
-      return tags.runtime === "node" && tags.napi;
-    }
-    function compareTags(runtime2) {
-      return function(a, b) {
-        if (a.runtime !== b.runtime) {
-          return a.runtime === runtime2 ? -1 : 1;
-        } else if (a.abi !== b.abi) {
-          return a.abi ? -1 : 1;
-        } else if (a.specificity !== b.specificity) {
-          return a.specificity > b.specificity ? -1 : 1;
-        } else {
-          return 0;
-        }
-      };
-    }
-    function isNwjs() {
-      return !!(process.versions && process.versions.nw);
-    }
-    function isElectron() {
-      if (process.versions && process.versions.electron) return true;
-      if (process.env.ELECTRON_RUN_AS_NODE) return true;
-      return typeof window !== "undefined" && window.process && window.process.type === "renderer";
-    }
-    function isAlpine(platform2) {
-      return platform2 === "linux" && fs.existsSync("/etc/alpine-release");
-    }
-    load.parseTags = parseTags;
-    load.matchTags = matchTags;
-    load.compareTags = compareTags;
-    load.parseTuple = parseTuple;
-    load.matchTuple = matchTuple;
-    load.compareTuples = compareTuples;
-  }
-});
-
-// ../../../../node_modules/node-gyp-build/index.js
-var require_node_gyp_build2 = __commonJS({
-  "../../../../node_modules/node-gyp-build/index.js"(exports, module) {
-    var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : __require;
-    if (typeof runtimeRequire.addon === "function") {
-      module.exports = runtimeRequire.addon.bind(runtimeRequire);
-    } else {
-      module.exports = require_node_gyp_build();
-    }
-  }
-});
-
-// ../../../../node_modules/bufferutil/fallback.js
-var require_fallback = __commonJS({
-  "../../../../node_modules/bufferutil/fallback.js"(exports, module) {
-    "use strict";
-    var mask = (source, mask2, output, offset, length) => {
-      for (var i = 0; i < length; i++) {
-        output[offset + i] = source[i] ^ mask2[i & 3];
-      }
-    };
-    var unmask = (buffer, mask2) => {
-      const length = buffer.length;
-      for (var i = 0; i < length; i++) {
-        buffer[i] ^= mask2[i & 3];
-      }
-    };
-    module.exports = { mask, unmask };
-  }
-});
-
-// ../../../../node_modules/bufferutil/index.js
-var require_bufferutil = __commonJS({
-  "../../../../node_modules/bufferutil/index.js"(exports, module) {
-    "use strict";
-    try {
-      module.exports = require_node_gyp_build2()(__dirname);
-    } catch (e) {
-      module.exports = require_fallback();
-    }
-  }
-});
-
 // node_modules/ws/lib/buffer-util.js
 var require_buffer_util = __commonJS({
   "node_modules/ws/lib/buffer-util.js"(exports, module) {
@@ -22904,7 +22692,7 @@ var require_buffer_util = __commonJS({
     };
     if (!process.env.WS_NO_BUFFER_UTIL) {
       try {
-        const bufferUtil = require_bufferutil();
+        const bufferUtil = __require("bufferutil");
         module.exports.mask = function(source, mask, output, offset, length) {
           if (length < 48) _mask(source, mask, output, offset, length);
           else bufferUtil.mask(source, mask, output, offset, length);
@@ -23352,55 +23140,6 @@ var require_permessage_deflate = __commonJS({
   }
 });
 
-// ../../../../node_modules/utf-8-validate/fallback.js
-var require_fallback2 = __commonJS({
-  "../../../../node_modules/utf-8-validate/fallback.js"(exports, module) {
-    "use strict";
-    function isValidUTF8(buf) {
-      const len = buf.length;
-      let i = 0;
-      while (i < len) {
-        if ((buf[i] & 128) === 0) {
-          i++;
-        } else if ((buf[i] & 224) === 192) {
-          if (i + 1 === len || (buf[i + 1] & 192) !== 128 || (buf[i] & 254) === 192) {
-            return false;
-          }
-          i += 2;
-        } else if ((buf[i] & 240) === 224) {
-          if (i + 2 >= len || (buf[i + 1] & 192) !== 128 || (buf[i + 2] & 192) !== 128 || buf[i] === 224 && (buf[i + 1] & 224) === 128 || // overlong
-          buf[i] === 237 && (buf[i + 1] & 224) === 160) {
-            return false;
-          }
-          i += 3;
-        } else if ((buf[i] & 248) === 240) {
-          if (i + 3 >= len || (buf[i + 1] & 192) !== 128 || (buf[i + 2] & 192) !== 128 || (buf[i + 3] & 192) !== 128 || buf[i] === 240 && (buf[i + 1] & 240) === 128 || // overlong
-          buf[i] === 244 && buf[i + 1] > 143 || buf[i] > 244) {
-            return false;
-          }
-          i += 4;
-        } else {
-          return false;
-        }
-      }
-      return true;
-    }
-    module.exports = isValidUTF8;
-  }
-});
-
-// ../../../../node_modules/utf-8-validate/index.js
-var require_utf_8_validate = __commonJS({
-  "../../../../node_modules/utf-8-validate/index.js"(exports, module) {
-    "use strict";
-    try {
-      module.exports = require_node_gyp_build2()(__dirname);
-    } catch (e) {
-      module.exports = require_fallback2();
-    }
-  }
-});
-
 // node_modules/ws/lib/validation.js
 var require_validation = __commonJS({
   "node_modules/ws/lib/validation.js"(exports, module) {
@@ -23592,7 +23331,7 @@ var require_validation = __commonJS({
       };
     } else if (!process.env.WS_NO_UTF_8_VALIDATE) {
       try {
-        const isValidUTF8 = require_utf_8_validate();
+        const isValidUTF8 = __require("utf-8-validate");
         module.exports.isValidUTF8 = function(buf) {
           return buf.length < 32 ? _isValidUTF8(buf) : isValidUTF8(buf);
         };
@@ -28724,6 +28463,69 @@ function errMsg(err) {
   return err instanceof Error ? err.message : String(err);
 }
 
+// src/platform-heartbeat.ts
+var DEFAULT_INTERVAL_MS = 6e4;
+var MIN_INTERVAL_MS = 1e4;
+function startPlatformHeartbeat(opts) {
+  const env = opts.env ?? process.env;
+  const fetcher = opts.fetcher ?? fetch;
+  const url = opts.url?.trim() || env.PERKOS_HEARTBEAT_URL?.trim();
+  const relayKey = opts.relayKey?.trim() || env.A2A_RELAY_API_KEY?.trim();
+  if (!url || !relayKey) return { stop: () => void 0 };
+  const configuredInterval = Number(
+    opts.intervalMs ?? env.PERKOS_HEARTBEAT_INTERVAL_MS ?? DEFAULT_INTERVAL_MS
+  );
+  const intervalMs = Number.isFinite(configuredInterval) ? Math.max(MIN_INTERVAL_MS, configuredInterval) : DEFAULT_INTERVAL_MS;
+  const a2aRuntime = env.A2A_RUNTIME?.trim() || "hermes-api";
+  const runtimeKind = opts.runtimeKind ?? (a2aRuntime === "openclaw" ? "openclaw" : a2aRuntime === "custom" ? "custom" : "hermes");
+  let stopped = false;
+  let firstSuccess = true;
+  const report = async () => {
+    if (stopped) return;
+    try {
+      const res = await fetcher(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${relayKey}`,
+          "x-relay-key": relayKey
+        },
+        body: JSON.stringify({
+          runtimeKind,
+          version: opts.version?.trim() || env.PERKOS_A2A_VERSION?.trim() || "0.12.26",
+          ts: Date.now()
+        })
+      });
+      if (res.ok) {
+        if (firstSuccess) {
+          opts.logger.info(
+            `[perkos-heartbeat] reported online to ${url} (status=${res.status}, every=${intervalMs}ms)`
+          );
+          firstSuccess = false;
+        }
+      } else {
+        opts.logger.warn(
+          `[perkos-heartbeat] ${res.status} from ${url} (continuing)`
+        );
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      opts.logger.warn(
+        `[perkos-heartbeat] POST failed to ${url}: ${msg} (continuing)`
+      );
+    }
+  };
+  void report();
+  const timer = setInterval(() => void report(), intervalMs);
+  timer.unref?.();
+  return {
+    stop: () => {
+      stopped = true;
+      clearInterval(timer);
+    }
+  };
+}
+
 // src/types.ts
 function isWebhookEvent(msg) {
   return msg.type === "webhook_event";
@@ -28756,6 +28558,191 @@ function openclawChatSessionKey(config, convId) {
   const safe = convId.replace(/[^a-zA-Z0-9_.-]/g, "-").slice(0, 120) || "unknown";
   return `${configured}:perkos-chat-${safe}`;
 }
+var MISSING_AGENT_HARNESS_RE = /Requested agent harness "([^"]+)" is not registered\./u;
+function missingAgentHarnessId(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.match(MISSING_AGENT_HARNESS_RE)?.[1]?.trim() || null;
+}
+function omitUnavailableAgentHarness(value, unavailableHarnessId) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => omitUnavailableAgentHarness(entry, unavailableHarnessId));
+  }
+  if (!value || typeof value !== "object") return value;
+  const source = value;
+  const next = {};
+  for (const [key, entry] of Object.entries(source)) {
+    if (key === "agentRuntime" && entry && typeof entry === "object" && String(entry.id ?? "").trim() === unavailableHarnessId) {
+      continue;
+    }
+    if ((key === "embeddedHarness" || key === "agentRuntimeOverride" || key === "agentHarnessId") && typeof entry === "string" && entry.trim() === unavailableHarnessId) {
+      continue;
+    }
+    next[key] = omitUnavailableAgentHarness(entry, unavailableHarnessId);
+  }
+  return next;
+}
+function alignOpenClawChatSessionModel(entry, configuredModel) {
+  const next = { ...entry };
+  for (const key of [
+    "providerOverride",
+    "modelOverride",
+    "modelOverrideSource",
+    "modelOverrideFallbackOriginProvider",
+    "modelOverrideFallbackOriginModel",
+    "agentRuntimeOverride",
+    "agentHarnessId",
+    "modelProvider",
+    "model",
+    "fallbackNoticeSelectedModel",
+    "fallbackNoticeActiveModel",
+    "fallbackNoticeReason"
+  ]) {
+    delete next[key];
+  }
+  const modelRef = configuredModel?.trim();
+  const separator = modelRef?.indexOf("/") ?? -1;
+  if (modelRef && separator > 0 && separator < modelRef.length - 1) {
+    const provider = modelRef.slice(0, separator);
+    const model = modelRef.slice(separator + 1);
+    next.providerOverride = provider;
+    next.modelOverride = model;
+    next.modelOverrideSource = "user";
+    next.modelProvider = provider;
+    next.model = model;
+  }
+  return next;
+}
+async function prepareOpenClawChatSession(api, config, sessionKey, logger) {
+  const patchSessionEntry = api.runtime?.agent?.session?.patchSessionEntry;
+  if (typeof patchSessionEntry !== "function") {
+    logger.info("[perkos-chat] OpenClaw session metadata API unavailable \u2014 using gateway session defaults");
+    return;
+  }
+  try {
+    await patchSessionEntry({
+      sessionKey,
+      fallbackEntry: { sessionId: randomUUID6(), updatedAt: Date.now() },
+      preserveActivity: true,
+      replaceEntry: true,
+      update: (entry) => alignOpenClawChatSessionModel(entry, config.runtime?.model)
+    });
+    logger.info(
+      config.runtime?.model ? `[perkos-chat] session ${sessionKey} pinned to ${config.runtime.model}` : `[perkos-chat] session ${sessionKey} aligned to the gateway's active default model`
+    );
+  } catch (err) {
+    logger.error(
+      `[perkos-chat] failed to align OpenClaw session model: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+async function forceNativeOpenClawChatRuntime(api, config, sessionKey, logger) {
+  const patchSessionEntry = api.runtime?.agent?.session?.patchSessionEntry;
+  if (typeof patchSessionEntry !== "function") return;
+  try {
+    await patchSessionEntry({
+      sessionKey,
+      fallbackEntry: { sessionId: randomUUID6(), updatedAt: Date.now() },
+      preserveActivity: true,
+      replaceEntry: true,
+      update: (entry) => ({
+        ...alignOpenClawChatSessionModel(entry, config.runtime?.model),
+        // OpenClaw <= 2026.5.x calls its built-in runtime "pi". Newer
+        // gateways normalize the alias to their native "openclaw" harness.
+        agentRuntimeOverride: "pi",
+        agentHarnessId: "pi"
+      })
+    });
+    logger.info(`[perkos-chat] session ${sessionKey} retrying with the native OpenClaw harness`);
+  } catch (err) {
+    logger.error(
+      `[perkos-chat] failed to select native OpenClaw harness: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function extractOpenClawChatReply(result) {
+  const finalText = result.meta?.finalAssistantVisibleText?.trim() || result.meta?.finalAssistantRawText?.trim();
+  if (finalText) return finalText;
+  const payloadText = result.payloads?.filter((payload) => !payload.isError && !payload.isReasoning && !payload.isCommentary).map((payload) => payload.text?.trim()).filter((text) => Boolean(text)).join("\n\n").trim();
+  return payloadText || null;
+}
+function openclawAgentId(config) {
+  const sessionKey = config.runtime?.sessionKey || "agent:main";
+  const parts = sessionKey.split(":");
+  return parts[0] === "agent" && parts[1] ? parts[1] : "main";
+}
+async function runOpenClawChatTurn(api, config, sessionKey, prompt, transcriptPrompt, logger) {
+  const runEmbeddedAgent = api.runtime?.agent?.runEmbeddedAgent;
+  const currentConfig = api.runtime?.config?.current;
+  const resolveAgentWorkspaceDir = api.runtime?.agent?.resolveAgentWorkspaceDir;
+  if (typeof runEmbeddedAgent !== "function" || typeof currentConfig !== "function" || typeof resolveAgentWorkspaceDir !== "function") {
+    logger.info("[perkos-chat] embedded OpenClaw runner unavailable \u2014 using gateway wake fallback");
+    return null;
+  }
+  const agentId = openclawAgentId(config);
+  const runtimeConfig = currentConfig();
+  const workspaceDir = resolveAgentWorkspaceDir(runtimeConfig, agentId);
+  const entry = api.runtime?.agent?.session?.getSessionEntry?.({ agentId, sessionKey });
+  const sessionId = typeof entry?.sessionId === "string" && entry.sessionId.trim() ? entry.sessionId : randomUUID6();
+  const configuredTimeout = api.runtime?.agent?.resolveAgentTimeoutMs?.(runtimeConfig);
+  const timeoutMs = Math.min(
+    75e3,
+    typeof configuredTimeout === "number" && configuredTimeout > 0 ? configuredTimeout : 75e3
+  );
+  const run = async (configOverride, retryNative = false) => runEmbeddedAgent({
+    sessionId,
+    sessionKey,
+    agentId,
+    workspaceDir,
+    config: configOverride,
+    prompt,
+    transcriptPrompt,
+    timeoutMs,
+    runId: randomUUID6(),
+    trigger: "user",
+    messageChannel: "perkos-chat",
+    disableTools: true,
+    disableMessageTool: true,
+    terminalReplyExpectation: "required",
+    suppressLiveStreamOutput: true,
+    cleanupBundleMcpOnRunEnd: true,
+    ...retryNative ? {
+      // Cross-version compatibility: 2026.5.x recognizes `pi`, while
+      // current gateways recognize the explicit native runtime override.
+      agentHarnessId: "pi",
+      agentHarnessRuntimeOverride: "openclaw",
+      suppressNextUserMessagePersistence: true
+    } : {}
+  });
+  try {
+    let result;
+    try {
+      result = await run(runtimeConfig);
+    } catch (err) {
+      const unavailableHarnessId = missingAgentHarnessId(err);
+      if (!unavailableHarnessId) throw err;
+      logger.info(
+        `[perkos-chat] configured harness ${unavailableHarnessId} is unavailable; retrying with the native OpenClaw runtime and the same gateway-selected model`
+      );
+      await forceNativeOpenClawChatRuntime(api, config, sessionKey, logger);
+      result = await run(
+        omitUnavailableAgentHarness(runtimeConfig, unavailableHarnessId),
+        true
+      );
+    }
+    const reply = extractOpenClawChatReply(result);
+    if (!reply) {
+      logger.error(`[perkos-chat] embedded OpenClaw run completed without reply text for ${sessionKey}`);
+      return null;
+    }
+    logger.info(`[perkos-chat] embedded OpenClaw run completed for ${sessionKey}`);
+    return reply;
+  } catch (err) {
+    logger.error(
+      `[perkos-chat] embedded OpenClaw run failed for ${sessionKey}: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return null;
+  }
+}
 function parseWalletFromIdentity(identity) {
   if (typeof identity !== "string" || !identity.startsWith("user:")) return null;
   const addr = identity.slice("user:".length);
@@ -28783,7 +28770,8 @@ async function deliverToHermes(config, message, logger) {
   };
   if (token) headers.authorization = `Bearer ${token}`;
   const normalizedEndpoint = endpoint.replace(/^\/?/, "/");
-  const body = normalizedEndpoint.startsWith("/v1/chat/completions") ? { model: "hermes-agent", messages: [{ role: "user", content: message }], stream: false } : normalizedEndpoint.startsWith("/v1/runs") ? { input: message, session_id: sessionKey } : normalizedEndpoint.startsWith("/v1/responses") ? { model: "hermes-agent", input: message, store: true } : { sessionKey, message };
+  const model = runtime.model?.trim();
+  const body = normalizedEndpoint.startsWith("/v1/chat/completions") ? { ...model ? { model } : {}, messages: [{ role: "user", content: message }], stream: false } : normalizedEndpoint.startsWith("/v1/runs") ? { input: message, session_id: sessionKey } : normalizedEndpoint.startsWith("/v1/responses") ? { ...model ? { model } : {}, input: message, store: true } : { sessionKey, message };
   const response = await fetch(url, {
     method: "POST",
     headers,
@@ -29029,6 +29017,22 @@ function register(api) {
           "Message body:",
           frame.text
         ].filter(Boolean).join("\n");
+        const directRunPrompt = [
+          marker,
+          `From: ${frame.from}`,
+          `Conversation: ${frame.convId}`,
+          frame.projectId ? `Canonical projectId: ${frame.projectId}` : "",
+          "",
+          "Reply to this PerkOS chat message using your current runtime configuration.",
+          "Return only the reply text. Do not call messaging tools; the PerkOS plugin delivers the returned text.",
+          "Use the recent context and do not ask again for information already provided.",
+          "",
+          "Recent conversation context (oldest to newest):",
+          recentContext,
+          "",
+          "Message body:",
+          frame.text
+        ].filter(Boolean).join("\n");
         const runtimeKind = pluginConfig.runtime?.kind || "openclaw";
         if (runtimeKind === "hermes" || runtimeKind === "hermes-api") {
           try {
@@ -29042,14 +29046,38 @@ function register(api) {
           logger.info(`[perkos-chat] dropped chat_deliver for ${frame.convId} (runtime=none)`);
           return;
         }
+        const chatSessionKey = openclawChatSessionKey(pluginConfig, frame.convId);
+        await prepareOpenClawChatSession(api, pluginConfig, chatSessionKey, logger);
+        if (walletAddress) {
+          const reply = await runOpenClawChatTurn(
+            api,
+            pluginConfig,
+            chatSessionKey,
+            directRunPrompt,
+            frame.text,
+            logger
+          );
+          if (reply) {
+            const result = await chatClient?.sendReply({
+              convId: frame.convId,
+              walletAddress,
+              text: reply,
+              replyTo: frame.id
+            });
+            logger.info(
+              `[perkos-chat] embedded reply ${result?.delivered ? "delivered" : "queued (offline)"} for ${frame.convId}`
+            );
+            return;
+          }
+        }
         if (enqueueSystemEvent) {
-          enqueueSystemEvent(eventText, { sessionKey: openclawChatSessionKey(pluginConfig, frame.convId) });
+          enqueueSystemEvent(eventText, { sessionKey: chatSessionKey });
         }
         wakeGatewayAgent(
           requestHeartbeatNow,
           `[PerkOS-Chat] inbound message in ${frame.convId}`,
           logger,
-          openclawChatSessionKey(pluginConfig, frame.convId)
+          chatSessionKey
         );
       },
       onChannelJoin: async (frame) => {
@@ -29073,6 +29101,29 @@ function register(api) {
       }
     });
   }
+  if (pluginConfig.platform?.heartbeatUrl) {
+    let platformHeartbeat = null;
+    api.registerService({
+      id: "perkos-a2a-platform-heartbeat",
+      start: () => {
+        platformHeartbeat = startPlatformHeartbeat({
+          logger: {
+            info: (message) => logger.info(message),
+            warn: (message) => (logger.warn || logger.info).call(logger, message)
+          },
+          url: pluginConfig.platform?.heartbeatUrl,
+          relayKey: pluginConfig.relay?.apiKey,
+          runtimeKind: "openclaw",
+          version: "0.12.26",
+          intervalMs: pluginConfig.platform?.heartbeatIntervalMs
+        });
+      },
+      stop: () => {
+        platformHeartbeat?.stop();
+        platformHeartbeat = null;
+      }
+    });
+  }
   api.registerTool({
     name: "perkos_a2a_send",
     description: "Send a task to another agent via PerkOS A2A. Use this to delegate work, ask a peer to research, or route a chain/circular workflow. The message may name additional agents and a final notification target; the bridge preserves the route and prevents loops.",
@@ -29454,11 +29505,15 @@ export {
   ChatStore,
   RelayClient,
   RelayHub,
+  alignOpenClawChatSessionModel,
   register as default,
   detectNetworking,
+  extractOpenClawChatReply,
   formatRecentChatContext,
   isWebhookEvent,
-  openclawChatSessionKey
+  omitUnavailableAgentHarness,
+  openclawChatSessionKey,
+  runOpenClawChatTurn
 };
 /*! Bundled license information: