@relaymessenger/openclaw-plugin 0.4.7-staging.1 → 0.4.7-staging.11

package/contracts/relay-v1.lock.json

@@ -1,16 +1,16 @@
 {
   "relayServer": {
     "repository": "RelayMessenger/Relay-Server",
-    "commit": "55e12f23fdb559e23e54e4f386a77fd397293834",
+    "commit": "eb83978b6b2c625da82471e4af16acad8de0e618",
     "openapiPath": "contracts/developer/openapi.yaml",
-    "sha256": "de33237b05b09414c1994446f746795ab8bf410cb2c8f1422259103775cfc182"
+    "sha256": "27698655d12500fb9cd2e10dbf1c94025fbc64c288df6151db673a7649877111"
   },
   "relaySdk": {
     "package": "@relaymessenger/sdk",
-    "version": "0.3.6-staging.1",
-    "integrity": "sha512-aGHnNGlKR2M7d6BiRChQ8bG2FBYKm/lSAeBL/9cKJ8O7gwKCrysDWuFhQExoSg+riIT0DiOlNh2hVdHfSWLOKQ==",
-    "operationsSha256": "7b131c1d40779b204fb3cf3ebc0cc6c6f2df19555618958fd17b0c81209452b9",
-    "workspaceOpenapiSha256": "de33237b05b09414c1994446f746795ab8bf410cb2c8f1422259103775cfc182",
+    "version": "0.3.6-staging.9",
+    "integrity": "sha512-3tqlPQV4G3mkHvENP2j1gPKg9Rtstuc+yrSUk0aWRK+cXy4110Pr5LaNy8ea7nPgGpkF/1JoUnxjHtA0L7HHzA==",
+    "operationsSha256": "04e5e1f1f626a2b0607fb0d091f12a4205a9e298fdb6f56e5bfcc446c9fe5ee3",
+    "workspaceOpenapiSha256": "27698655d12500fb9cd2e10dbf1c94025fbc64c288df6151db673a7649877111",
     "usedOperations": [
       {
         "method": "GET",

package/dist/src/channel.js

@@ -249,6 +249,7 @@ export const relayChannelPlugin = createChatChannelPlugin({
                         deliveryQueueId: ctx.deliveryQueueId,
                         deliveryPartIndex: ctx.deliveryPartIndex,
                     }),
+                    onButtonsError: (error) => ctx.log?.warn?.(`relay: buttons block left as text: ${error}`),
                     ...(ctx.onPlatformSendDispatch
                         ? { onPlatformSendDispatch: ctx.onPlatformSendDispatch }
                         : {}),

package/dist/src/dispatch.js

@@ -170,7 +170,9 @@ export async function dispatchRelayEvent(params) {
         reply: {
             to: facts.chatId,
             originatingTo: facts.chatId,
-            ...(facts.replyToId ? { replyToId: facts.replyToId } : {}),
+            ...((facts.replyAnchorId ?? facts.replyToId)
+                ? { replyToId: facts.replyAnchorId ?? facts.replyToId }
+                : {}),
         },
         message: {
             inboundEventKind: "user_request",

package/dist/src/inbound.js

@@ -8,6 +8,10 @@ function renderPart(part) {
             return `[Attachment: ${part.filename} (${part.mime_type})] ${part.url}`;
         case "system":
             return part.value;
+        // The agent's own buttons part reads as nothing, as on the server; its
+        // question is the text beside it. A tap arrives as ordinary text.
+        case "buttons":
+            return undefined;
     }
 }
 export function renderRelayMessageParts(parts) {
@@ -61,7 +65,14 @@ export function buildRelayInboundFacts(event) {
             ? { ownerHandle: event.data.chat.owner_handle }
             : {}),
         ...(event.data.reply_to?.message_id
-            ? { replyToId: event.data.reply_to.message_id }
+            ? {
+                replyToId: event.data.reply_to.message_id,
+                // The answer quotes the person's message, the one it answers (a bot's
+                // reply_to in Telegram and Discord names the person's message). A
+                // tap's reply_to names the agent's buttons part, which no reply may
+                // target, so this is also what keeps a tap answerable.
+                replyAnchorId: event.data.id,
+            }
             : {}),
         ...(Number.isFinite(timestamp) ? { timestamp } : {}),
     };

package/dist/src/outbound.js

@@ -1,5 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
-import { Relay, RelayAPIError, } from "@relaymessenger/sdk";
+import { answerMessages, indexedIdempotencyKey, Relay, RelayAPIError, } from "@relaymessenger/sdk";
 export const RELAY_TEXT_CHUNK_LIMIT = 10_000;
 const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
 export function createRelaySdkClient(account) {
@@ -17,17 +17,35 @@ export function deriveRelayIdempotencyKey(params) {
         ? raw
         : `relay-openclaw:sha256:${createHash("sha256").update(raw).digest("hex")}`;
 }
+/**
+ * OpenClaw hands the agent's words as text, so buttons ride in them as the
+ * SDK's fenced block, lifted here into the buttons part, and a link written
+ * alone on a line goes out as its own link Message. A block that cannot be
+ * read stays in the words and is reported through `onButtonsError`. Without
+ * a block or a link line the words go exactly as OpenClaw handed them, in one
+ * Message; the response is the first Message's, the one the reply anchors to.
+ */
 export async function sendRelayText(params) {
     await params.onPlatformSendDispatch?.();
-    return await params.relay.chats.messages.send(params.chatId, {
-        message: {
-            parts: [{ type: "text", value: params.text }],
-            idempotency_key: params.idempotencyKey,
-            ...(params.replyToId
-                ? { reply_to: { message_id: params.replyToId } }
-                : {}),
-        },
-    }, params.signal ? { signal: params.signal } : undefined);
+    const { messages, error } = answerMessages(params.text);
+    if (error)
+        params.onButtonsError?.(error);
+    if (messages.length === 0)
+        messages.push([{ type: "text", value: params.text }]);
+    let first;
+    for (const [index, parts] of messages.entries()) {
+        const response = await params.relay.chats.messages.send(params.chatId, {
+            message: {
+                parts,
+                idempotency_key: indexedIdempotencyKey(params.idempotencyKey, index),
+                ...(index === 0 && params.replyToId
+                    ? { reply_to: { message_id: params.replyToId } }
+                    : {}),
+            },
+        }, params.signal ? { signal: params.signal } : undefined);
+        first ??= response;
+    }
+    return first;
 }
 export function classifyUnknownRelaySend(error) {
     if (!(error instanceof RelayAPIError)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relaymessenger/openclaw-plugin",
-  "version": "0.4.7-staging.1",
+  "version": "0.4.7-staging.11",
   "description": "Native Relay channel plugin for OpenClaw",
   "license": "MIT",
   "type": "module",
@@ -37,11 +37,11 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@relaymessenger/sdk": "0.3.6-staging.1"
+    "@relaymessenger/sdk": "0.3.6-staging.9"
   },
   "devDependencies": {
-    "@types/node": "^26.0.0",
-    "openclaw": "2026.8.1",
+    "@types/node": "^26.6.2",
+    "openclaw": "2026.9.5",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   },
@@ -164,7 +164,7 @@
       "pluginApi": ">=2026.8.1 <2026.10.0"
     },
     "build": {
-      "openclawVersion": "2026.8.1"
+      "openclawVersion": "2026.9.5"
     }
   }
 }

package/src/channel.ts

@@ -329,6 +329,10 @@ export const relayChannelPlugin: ChannelPlugin<ResolvedRelayAccount> =
               deliveryQueueId: ctx.deliveryQueueId,
               deliveryPartIndex: ctx.deliveryPartIndex,
             }),
+            onButtonsError: (error) =>
+              (ctx as { log?: { warn?: (message: string) => void } }).log?.warn?.(
+                `relay: buttons block left as text: ${error}`,
+              ),
             ...(ctx.onPlatformSendDispatch
               ? { onPlatformSendDispatch: ctx.onPlatformSendDispatch }
               : {}),

package/src/dispatch.ts

@@ -236,7 +236,9 @@ export async function dispatchRelayEvent(params: {
     reply: {
       to: facts.chatId,
       originatingTo: facts.chatId,
-      ...(facts.replyToId ? { replyToId: facts.replyToId } : {}),
+      ...((facts.replyAnchorId ?? facts.replyToId)
+        ? { replyToId: facts.replyAnchorId ?? facts.replyToId }
+        : {}),
     },
     message: {
       inboundEventKind: "user_request",

package/src/inbound.ts

@@ -17,6 +17,10 @@ function renderPart(part: MessagePartResponse): string | undefined {
       return `[Attachment: ${part.filename} (${part.mime_type})] ${part.url}`;
     case "system":
       return part.value;
+    // The agent's own buttons part reads as nothing, as on the server; its
+    // question is the text beside it. A tap arrives as ordinary text.
+    case "buttons":
+      return undefined;
   }
 }
 
@@ -84,7 +88,14 @@ export function buildRelayInboundFacts(
       ? { ownerHandle: event.data.chat.owner_handle }
       : {}),
     ...(event.data.reply_to?.message_id
-      ? { replyToId: event.data.reply_to.message_id }
+      ? {
+        replyToId: event.data.reply_to.message_id,
+        // The answer quotes the person's message, the one it answers (a bot's
+        // reply_to in Telegram and Discord names the person's message). A
+        // tap's reply_to names the agent's buttons part, which no reply may
+        // target, so this is also what keeps a tap answerable.
+        replyAnchorId: event.data.id,
+      }
       : {}),
     ...(Number.isFinite(timestamp) ? { timestamp } : {}),
   };

package/src/outbound.ts

@@ -1,5 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import {
+  answerMessages,
+  indexedIdempotencyKey,
   Relay,
   RelayAPIError,
   type MessageSendResponse,
@@ -32,6 +34,14 @@ export function deriveRelayIdempotencyKey(params: {
     : `relay-openclaw:sha256:${createHash("sha256").update(raw).digest("hex")}`;
 }
 
+/**
+ * OpenClaw hands the agent's words as text, so buttons ride in them as the
+ * SDK's fenced block, lifted here into the buttons part, and a link written
+ * alone on a line goes out as its own link Message. A block that cannot be
+ * read stays in the words and is reported through `onButtonsError`. Without
+ * a block or a link line the words go exactly as OpenClaw handed them, in one
+ * Message; the response is the first Message's, the one the reply anchors to.
+ */
 export async function sendRelayText(params: {
   relay: Pick<Relay, "chats">;
   chatId: string;
@@ -40,21 +50,30 @@ export async function sendRelayText(params: {
   idempotencyKey: string;
   signal?: AbortSignal;
   onPlatformSendDispatch?: () => Promise<void>;
+  onButtonsError?: (error: string) => void;
 }): Promise<MessageSendResponse> {
   await params.onPlatformSendDispatch?.();
-  return await params.relay.chats.messages.send(
-    params.chatId,
-    {
-      message: {
-        parts: [{ type: "text", value: params.text }],
-        idempotency_key: params.idempotencyKey,
-        ...(params.replyToId
-          ? { reply_to: { message_id: params.replyToId } }
-          : {}),
+  const { messages, error } = answerMessages(params.text);
+  if (error) params.onButtonsError?.(error);
+  if (messages.length === 0) messages.push([{ type: "text", value: params.text }]);
+  let first: MessageSendResponse | undefined;
+  for (const [index, parts] of messages.entries()) {
+    const response = await params.relay.chats.messages.send(
+      params.chatId,
+      {
+        message: {
+          parts,
+          idempotency_key: indexedIdempotencyKey(params.idempotencyKey, index),
+          ...(index === 0 && params.replyToId
+            ? { reply_to: { message_id: params.replyToId } }
+            : {}),
+        },
       },
-    },
-    params.signal ? { signal: params.signal } : undefined,
-  );
+      params.signal ? { signal: params.signal } : undefined,
+    );
+    first ??= response;
+  }
+  return first!;
 }
 
 export function classifyUnknownRelaySend(error: unknown): {

package/src/types.ts

@@ -72,5 +72,11 @@ export type RelayInboundFacts = {
   mentionHandles: string[];
   ownerHandle?: ChatHandle;
   replyToId?: string;
+  /**
+   * The Message an outbound reply should quote when the person's Message
+   * was itself a reply: the person's Message. A tap's reply_to names the
+   * agent's buttons part, which no reply may target.
+   */
+  replyAnchorId?: string;
   timestamp?: number;
 };