@perkos/perkos-a2a 0.12.19 → 0.12.22

package/dist/gateway-health.js

@@ -1,7 +1,7 @@
 /**
  * Gateway health reporter.
  *
- * The PerkOS mini-app's `POST /api/agents/[agentId]/gateways/[type]/status`
+ * The PerkOS API's `POST /agents/:agentId/gateways/:type/status`
  * route flips a gateway's status from "pending" (set when the wallet
  * configures it in the wizard) to "active" or "error". Without
  * something calling it, every gateway sits at "pending" forever in
@@ -15,15 +15,9 @@
  * bridge — the admin panel staying at "pending" is preferable to a
  * dead bridge.
  *
- * Why presence-based reporting (not real Hermes platform polling):
- *   Hermes upstream exposes connected-platform state only as a
- *   Python-internal getter (gateway/config.py: get_connected_platforms).
- *   There's no HTTP route we can hit from the sidecar without first
- *   building one. Reporting "active" for every configured gateway
- *   is the simplest signal that's better than the "pending forever"
- *   floor. Once Hermes adds the route (or we ship our own plugin
- *   that exposes it), this module can be extended to read real
- *   state without changing its contract with the mini-app.
+ * Telegram is probed against Bot API getMe before status is reported. Other
+ * gateways remain pending until they have an equally real provider probe;
+ * environment presence alone is never treated as health.
  *
  * Inputs (env, all optional):
  *   PERKOS_AGENT_ID           — per-wallet agent doc id (required to
@@ -38,7 +32,7 @@
  *                                (same secret the bridge already uses
  *                                to authenticate to chat.perkos.xyz).
  *   PERKOS_GATEWAY_STATUS_URL — base URL, defaults to
- *                                https://app.perkos.xyz/api/agents.
+ *                                https://api.perkos.xyz/agents.
  *   PERKOS_GATEWAY_REPORT_DELAY_MS — how long to wait after bridge
  *                                start before reporting. Default 30s.
  *
@@ -52,7 +46,7 @@
  *                                PerkOS#TBD).
  */
 export const KNOWN_GATEWAYS = ["telegram", "farcaster", "slack"];
-const DEFAULT_BASE_URL = "https://app.perkos.xyz/api/agents";
+const DEFAULT_BASE_URL = "https://api.perkos.xyz/agents";
 const DEFAULT_DELAY_MS = 30_000;
 const POST_TIMEOUT_MS = 10_000;
 function enabledFromEnv(env, gateway) {
@@ -96,23 +90,64 @@ export function startGatewayHealthReporter(opts = {}) {
             const parsed = Number(raw);
             return Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_DELAY_MS;
         })();
-    log.info(`[gateway-health] will report ${enabled.join(", ")} as active in ${delayMs}ms`);
+    log.info(`[gateway-health] will probe ${enabled.join(", ")} in ${delayMs}ms`);
     return new Promise((resolve) => {
         setTimeout(async () => {
             const results = [];
             for (const gateway of enabled) {
+                if (gateway !== "telegram") {
+                    const error = `${gateway} has no provider-backed health probe yet`;
+                    log.info(`[gateway-health] ${error}; leaving status pending`);
+                    results.push({ gateway, ok: false, status: null, error });
+                    continue;
+                }
+                const probe = await probeTelegram(fetcher, env.TELEGRAM_BOT_TOKEN);
                 results.push(await postOne(fetcher, log, {
                     baseUrl,
                     agentId,
                     agentName,
                     relayKey,
                     gateway,
+                    gatewayStatus: probe.ok ? "active" : "error",
+                    message: probe.message,
                 }));
             }
             resolve(results);
         }, delayMs);
     });
 }
+async function probeTelegram(fetcher, rawToken) {
+    const token = rawToken?.trim();
+    if (!token)
+        return { ok: false, message: "Telegram bot token is missing." };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), POST_TIMEOUT_MS);
+    try {
+        const response = await fetcher(`https://api.telegram.org/bot${encodeURIComponent(token)}/getMe`, { signal: controller.signal });
+        const body = (await response.json().catch(() => null));
+        if (!response.ok || body?.ok !== true) {
+            return {
+                ok: false,
+                message: body?.description || `Telegram getMe failed (${response.status}).`,
+            };
+        }
+        const identity = body.result?.username
+            ? `@${body.result.username}`
+            : body.result?.id
+                ? String(body.result.id)
+                : "bot";
+        return { ok: true, message: `Telegram authenticated as ${identity}.` };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `Telegram probe failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 async function postOne(fetcher, log, args) {
     const url = `${args.baseUrl}/${encodeURIComponent(args.agentId)}/gateways/${args.gateway}/status`;
     const controller = new AbortController();
@@ -126,10 +161,13 @@ async function postOne(fetcher, log, args) {
                 "x-agent-name": args.agentName,
                 "content-type": "application/json",
             },
-            body: JSON.stringify({ status: "active" }),
+            body: JSON.stringify({
+                status: args.gatewayStatus,
+                message: args.message,
+            }),
         });
         if (response.ok) {
-            log.info(`[gateway-health] reported ${args.gateway} → active (${response.status})`);
+            log.info(`[gateway-health] reported ${args.gateway} → ${args.gatewayStatus} (${response.status})`);
             return { gateway: args.gateway, ok: true, status: response.status };
         }
         const text = await response.text().catch(() => "");

package/dist/gateway-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-health.js","sourceRoot":"","sources":["../src/gateway-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAUH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAG1E,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAC7D,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,SAAS,cAAc,CAAC,GAAQ,EAAE,OAAqB;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;AAClD,CAAC;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA6B,EAAE;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAK,OAAO,CAAC,GAAW,CAAC;IAC7C,MAAM,GAAG,GAAW,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IAEtC,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAE/C,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxC,kEAAkE;QAClE,gEAAgE;QAChE,yCAAyC;QACzC,GAAG,CAAC,IAAI,CACN,gHAAgH,CACjH,CAAC;QACF,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChG,MAAM,OAAO,GACX,IAAI,CAAC,OAAO;QACZ,CAAC,GAAG,EAAE;YACJ,MAAM,GAAG,GAAG,GAAG,CAAC,8BAA8B,CAAC;YAC/C,IAAI,CAAC,GAAG;gBAAE,OAAO,gBAAgB,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC5E,CAAC,CAAC,EAAE,CAAC;IAEP,GAAG,CAAC,IAAI,CACN,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,OAAO,IAAI,CAC/E,CAAC;IAEF,OAAO,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;QAC9C,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,OAAO,GAAoB,EAAE,CAAC;YACpC,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CACV,MAAM,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE;oBAC1B,OAAO;oBACP,OAAO;oBACP,SAAS;oBACT,QAAQ;oBACR,OAAO;iBACR,CAAC,CACH,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,OAAqB,EACrB,GAAW,EACX,IAMC;IAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,SAAS,CAAC;IAClG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,QAAQ,EAAE;gBACxC,cAAc,EAAE,IAAI,CAAC,SAAS;gBAC9B,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;SAC3C,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,OAAO,cAAc,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACpF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACtE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,OAAO,oBAAoB,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvG,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,OAAO,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACxE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"gateway-health.js","sourceRoot":"","sources":["../src/gateway-health.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  * v0.8.0: Uses enqueueSystemEvent + WebSocket wake for immediate task processing.
  */
 import type { A2APluginConfig } from "./types.js";
+import type { ChatMessage } from "./chat-types.js";
 export { A2AServer, detectNetworking } from "./server.js";
 export { RelayHub } from "./relay.js";
 export { RelayClient } from "./relay-client.js";
@@ -16,5 +17,7 @@ export { ChatStore } from "./chat-store.js";
 export * from "./types.js";
 /** Keep every chat thread in its own OpenClaw runtime session. */
 export declare function openclawChatSessionKey(config: A2APluginConfig, convId: string): string;
+/** Build a bounded, agent-local transcript so every runtime turn has continuity. */
+export declare function formatRecentChatContext(messages: ChatMessage[], currentMessageId: string): string;
 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;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,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;AAiC3B,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAItF;AAkDD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA4vBxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,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;AAiC3B,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAItF;AAYD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAWR;AA2CD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAwwBxC"}

package/dist/index.js

@@ -22632,6 +22632,218 @@ 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) {
@@ -22692,7 +22904,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);
@@ -23140,6 +23352,55 @@ 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) {
@@ -23331,7 +23592,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);
         };
@@ -26252,6 +26513,8 @@ import { randomUUID } from "crypto";
 var MIN_RECONNECT_MS = 1e3;
 var MAX_RECONNECT_MS = 6e4;
 var HEARTBEAT_INTERVAL_MS = 25e3;
+var ORPHAN_TTL_MS = 10 * 6e4;
+var ORPHAN_MAX = 256;
 var RelayClient = class {
   ws = null;
   options;
@@ -26262,6 +26525,8 @@ var RelayClient = class {
   connected = false;
   stopped = false;
   pendingCallbacks = /* @__PURE__ */ new Map();
+  /** Responses that arrived with nobody waiting, claimable by a retry. */
+  orphanResponses = /* @__PURE__ */ new Map();
   constructor(options) {
     this.options = options;
     this.logger = options.logger || { info: console.log, error: console.error };
@@ -26282,12 +26547,25 @@ var RelayClient = class {
     }
     this.connected = false;
   }
-  /** Send a task to another agent via the relay */
-  async sendTask(targetAgent, payload) {
+  /**
+   * Send a task to another agent via the relay.
+   *
+   * Pass `taskId` to retry a task that already went out: the relay dedups on
+   * the id and will not run the work twice, and if the first attempt's response
+   * arrived after we gave up it is claimed from the orphan buffer instead of
+   * waiting again. Omit it for genuinely new work.
+   */
+  async sendTask(targetAgent, payload, taskId) {
+    const id = taskId ?? randomUUID();
+    const alreadyAnswered = this.claimOrphan(id);
+    if (alreadyAnswered) {
+      this.logger.info(`[perkos-a2a] Reusing buffered response for task ${id}`);
+      return alreadyAnswered;
+    }
     return this.sendAndWait({
       type: "task",
       to: targetAgent,
-      id: randomUUID(),
+      id,
       from: this.options.agentName,
       payload,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
@@ -26372,10 +26650,10 @@ var RelayClient = class {
     this.send(msg);
   }
   handleMessage(msg) {
-    const callback = this.pendingCallbacks.get(msg.id);
-    if (callback) {
+    const pending = this.pendingCallbacks.get(msg.id);
+    if (pending && (msg.type === pending.expectedType || msg.type === "error")) {
       this.pendingCallbacks.delete(msg.id);
-      callback(msg);
+      pending.settle(msg);
       return;
     }
     switch (msg.type) {
@@ -26385,8 +26663,15 @@ var RelayClient = class {
       case "task":
         this.options.onTask(msg);
         break;
+      case "task_ack":
+        if (msg.payload?.deduplicated) {
+          this.logger.info(`[perkos-a2a] Relay deduplicated task ${msg.id}; awaiting the original response`);
+        }
+        break;
       case "task_response":
-        this.logger.info(`[perkos-a2a] Received unmatched task response: ${msg.id}`);
+        this.bufferOrphan(msg);
+        this.logger.info(`[perkos-a2a] Buffered unmatched task response: ${msg.id}`);
+        this.options.onOrphanTaskResponse?.(msg);
         break;
       case "discover_response":
         if (this.options.onDiscoverResponse) {
@@ -26407,18 +26692,39 @@ var RelayClient = class {
       this.ws.send(JSON.stringify(msg));
     }
   }
+  /** Take a buffered response for `id`, if one arrived while nobody waited. */
+  claimOrphan(id) {
+    const entry = this.orphanResponses.get(id);
+    if (!entry) return null;
+    this.orphanResponses.delete(id);
+    if (entry.expiresAt <= Date.now()) return null;
+    return entry.msg;
+  }
+  bufferOrphan(msg) {
+    const now = Date.now();
+    for (const [id, entry] of this.orphanResponses) {
+      if (entry.expiresAt <= now) this.orphanResponses.delete(id);
+    }
+    this.orphanResponses.set(msg.id, { msg, expiresAt: now + ORPHAN_TTL_MS });
+    while (this.orphanResponses.size > ORPHAN_MAX) {
+      this.orphanResponses.delete(this.orphanResponses.keys().next().value);
+    }
+  }
   async sendAndWait(msg, expectedType, timeoutMs) {
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         this.pendingCallbacks.delete(msg.id);
         reject(new Error(`Relay request timed out after ${timeoutMs}ms`));
       }, timeoutMs);
-      this.pendingCallbacks.set(msg.id, (response) => {
-        clearTimeout(timer);
-        if (response.type === "error") {
-          reject(new Error(`Relay error: ${response.payload.message}`));
-        } else {
-          resolve(response);
+      this.pendingCallbacks.set(msg.id, {
+        expectedType,
+        settle: (response) => {
+          clearTimeout(timer);
+          if (response.type === "error") {
+            reject(new Error(`Relay error: ${response.payload.message}`));
+          } else {
+            resolve(response);
+          }
         }
       });
       this.send(msg);
@@ -27034,6 +27340,7 @@ var A2AServer = class {
       messages: [message],
       artifacts: [],
       metadata: {
+        ...message?.metadata,
         fromAgent: message?.metadata?.fromAgent || "unknown"
       },
       sessionKeyHint: "agent:main"
@@ -27281,9 +27588,9 @@ var A2AServer = class {
     const payload = msg.payload;
     const params = payload.params || payload;
     const rpcId = payload.id || msg.id;
-    const acceptQueued = params?.message?.metadata?.acceptQueued === true;
     this.handleSendMessage(params, rpcId).then(async (response) => {
       const task = response.result;
+      const acceptQueued = task?.messages?.[0]?.metadata?.acceptQueued === true;
       if (task?.id && !isTerminalTaskState(task.status?.state)) {
         if (acceptQueued) {
           this.relayClient?.sendTaskResponse(
@@ -27301,7 +27608,12 @@ var A2AServer = class {
           return;
         }
       }
-      this.relayClient?.sendTaskResponse(msg, response);
+      if (!acceptQueued) {
+        this.relayClient?.sendTaskResponse(
+          msg,
+          response
+        );
+      }
     }).catch((err) => {
       const errMsg2 = err instanceof Error ? err.message : String(err);
       this.logger.error(`[perkos-a2a] Failed to process relay task: ${errMsg2}`);
@@ -28449,6 +28761,14 @@ function parseWalletFromIdentity(identity) {
   const addr = identity.slice("user:".length);
   return addr.startsWith("0x") ? addr.toLowerCase() : null;
 }
+var CHAT_CONTEXT_MESSAGE_LIMIT = 12;
+var CHAT_CONTEXT_CHAR_LIMIT = 6e3;
+function formatRecentChatContext(messages, currentMessageId) {
+  const prior = messages.filter((message) => message.id !== currentMessageId).slice(-CHAT_CONTEXT_MESSAGE_LIMIT).map((message) => `${message.from}: ${message.text.trim()}`).filter((line) => line.length > 0);
+  if (prior.length === 0) return "(No earlier messages in this conversation.)";
+  const transcript = prior.join("\n");
+  return transcript.length <= CHAT_CONTEXT_CHAR_LIMIT ? transcript : `\u2026${transcript.slice(-CHAT_CONTEXT_CHAR_LIMIT)}`;
+}
 async function deliverToHermes(config, message, logger) {
   const runtime = config.runtime || {};
   const baseUrl = (runtime.hermesUrl || "http://127.0.0.1:8642").replace(/\/+$/, "");
@@ -28681,6 +29001,13 @@ function register(api) {
       onChatDeliver: async (frame) => {
         const walletAddress = parseWalletFromIdentity(frame.from);
         const marker = `[PERKOS_CHAT:${frame.convId}]`;
+        const recentPage = await chatClient?.getStore().readPage(frame.convId, {
+          limit: CHAT_CONTEXT_MESSAGE_LIMIT + 1
+        });
+        const recentContext = formatRecentChatContext(
+          recentPage?.messages ?? [],
+          frame.id
+        );
         const eventText = [
           marker,
           `From: ${frame.from}`,
@@ -28694,6 +29021,11 @@ function register(api) {
           walletAddress ? `  walletAddress: "${walletAddress}"` : `  walletAddress: <derived from From>`,
           `  text: <your reply>`,
           "",
+          "Recent conversation context (oldest to newest):",
+          recentContext,
+          "",
+          "Use the recent context. Do not ask again for information the user already provided.",
+          "",
           "Message body:",
           frame.text
         ].filter(Boolean).join("\n");
@@ -29124,6 +29456,7 @@ export {
   RelayHub,
   register as default,
   detectNetworking,
+  formatRecentChatContext,
   isWebhookEvent,
   openclawChatSessionKey
 };