@relaymessenger/openclaw-plugin 0.4.7-staging.4 → 0.4.7-staging.5

package/contracts/relay-v1.lock.json

@@ -1,16 +1,16 @@
 {
   "relayServer": {
     "repository": "RelayMessenger/Relay-Server",
-    "commit": "ef8cedb1015e1e0d0856d61b69057f2b831f7c90",
+    "commit": "1d5ccc3ebb1f6cbf5cc7732e9353a4cfb62703e7",
     "openapiPath": "contracts/developer/openapi.yaml",
-    "sha256": "1b687dc9ffc7a6296a04b570d20fe32bed758deb2ed8f38fc48d0d44a10db2ec"
+    "sha256": "379ba81f3bd4092bf65c445a730c396620a162a37fec775c0e382bf9edce2640"
   },
   "relaySdk": {
     "package": "@relaymessenger/sdk",
-    "version": "0.3.6-staging.4",
-    "integrity": "sha512-WkjSggp1VDo8kLTnUWb4OOED3p1fyPPrE996EGEsn6T6YTk0RPD/HlleqkIPSgaSjwJw7EBunhApwzO6a7kDKg==",
+    "version": "0.3.6-staging.5",
+    "integrity": "sha512-d3LOJaGz0tmJSuGQCVkAZVmSUkBI3vLspItsMlD7ZVL3FMTnR6EekmkPQZX+G2Mr17u0J5PzkjP2Wx17xDlnvw==",
     "operationsSha256": "5c482165296df7d0634a0f57950936887b118e7159baf3bdabc42fce0d4fe6d8",
-    "workspaceOpenapiSha256": "1b687dc9ffc7a6296a04b570d20fe32bed758deb2ed8f38fc48d0d44a10db2ec",
+    "workspaceOpenapiSha256": "379ba81f3bd4092bf65c445a730c396620a162a37fec775c0e382bf9edce2640",
     "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/inbound.js

@@ -8,11 +8,8 @@ function renderPart(part) {
             return `[Attachment: ${part.filename} (${part.mime_type})] ${part.url}`;
         case "system":
             return part.value;
-        // A tap reads as the label the person chose: the same text the server
-        // derives for a button_reply. The agent's own buttons part reads as
-        // nothing, again as the server does; its question is the text beside it.
-        case "button_reply":
-            return part.label;
+        // 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;
     }
@@ -70,9 +67,11 @@ export function buildRelayInboundFacts(event) {
         ...(event.data.reply_to?.message_id
             ? {
                 replyToId: event.data.reply_to.message_id,
-                replyAnchorId: event.data.parts.some((part) => part.type === "button_reply")
-                    ? event.data.id
-                    : 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 { partsWithButtons, Relay, RelayAPIError, splitButtons, } from "@relaymessenger/sdk";
 export const RELAY_TEXT_CHUNK_LIMIT = 10_000;
 const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
 export function createRelaySdkClient(account) {
@@ -17,11 +17,20 @@ 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. A block that cannot
+ * be read stays in the words and is reported through `onButtonsError`.
+ */
 export async function sendRelayText(params) {
     await params.onPlatformSendDispatch?.();
+    const { text, buttons, error } = splitButtons(params.text);
+    if (error)
+        params.onButtonsError?.(error);
     return await params.relay.chats.messages.send(params.chatId, {
         message: {
-            parts: [{ type: "text", value: params.text }],
+            // Without a block the words go exactly as OpenClaw handed them.
+            parts: buttons ? partsWithButtons(text, buttons) : [{ type: "text", value: params.text }],
             idempotency_key: params.idempotencyKey,
             ...(params.replyToId
                 ? { reply_to: { message_id: params.replyToId } }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relaymessenger/openclaw-plugin",
-  "version": "0.4.7-staging.4",
+  "version": "0.4.7-staging.5",
   "description": "Native Relay channel plugin for OpenClaw",
   "license": "MIT",
   "type": "module",
@@ -37,7 +37,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@relaymessenger/sdk": "0.3.6-staging.4"
+    "@relaymessenger/sdk": "0.3.6-staging.5"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",

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/inbound.ts

@@ -17,11 +17,8 @@ function renderPart(part: MessagePartResponse): string | undefined {
       return `[Attachment: ${part.filename} (${part.mime_type})] ${part.url}`;
     case "system":
       return part.value;
-    // A tap reads as the label the person chose: the same text the server
-    // derives for a button_reply. The agent's own buttons part reads as
-    // nothing, again as the server does; its question is the text beside it.
-    case "button_reply":
-      return part.label;
+    // 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;
   }
@@ -93,9 +90,11 @@ export function buildRelayInboundFacts(
     ...(event.data.reply_to?.message_id
       ? {
         replyToId: event.data.reply_to.message_id,
-        replyAnchorId: event.data.parts.some((part) => part.type === "button_reply")
-          ? event.data.id
-          : 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,7 +1,9 @@
 import { createHash, randomUUID } from "node:crypto";
 import {
+  partsWithButtons,
   Relay,
   RelayAPIError,
+  splitButtons,
   type MessageSendResponse,
 } from "@relaymessenger/sdk";
 import type { ResolvedRelayAccount } from "./types.js";
@@ -32,6 +34,11 @@ 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. A block that cannot
+ * be read stays in the words and is reported through `onButtonsError`.
+ */
 export async function sendRelayText(params: {
   relay: Pick<Relay, "chats">;
   chatId: string;
@@ -40,13 +47,17 @@ export async function sendRelayText(params: {
   idempotencyKey: string;
   signal?: AbortSignal;
   onPlatformSendDispatch?: () => Promise<void>;
+  onButtonsError?: (error: string) => void;
 }): Promise<MessageSendResponse> {
   await params.onPlatformSendDispatch?.();
+  const { text, buttons, error } = splitButtons(params.text);
+  if (error) params.onButtonsError?.(error);
   return await params.relay.chats.messages.send(
     params.chatId,
     {
       message: {
-        parts: [{ type: "text", value: params.text }],
+        // Without a block the words go exactly as OpenClaw handed them.
+        parts: buttons ? partsWithButtons(text, buttons) : [{ type: "text", value: params.text }],
         idempotency_key: params.idempotencyKey,
         ...(params.replyToId
           ? { reply_to: { message_id: params.replyToId } }

package/src/types.ts

@@ -73,10 +73,9 @@ export type RelayInboundFacts = {
   ownerHandle?: ChatHandle;
   replyToId?: string;
   /**
-   * The Message an outbound reply should quote. A tap's reply_to names the
-   * agent's buttons part, which only a button_reply may target, so the
-   * agent's answer quotes the tap itself; every other Message quotes what
-   * the person quoted.
+   * 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;