@relaymessenger/openclaw-plugin 0.4.7-staging.14 → 0.4.7-staging.16

package/README.md

@@ -12,6 +12,22 @@ delivers events over its v1 WebSocket, and the plugin sends replies through
 the Relay v1 REST Message API. The plugin imports `@relaymessenger/sdk`; it
 does not contain a copied Relay client or protocol implementation.
 
+## Selection, coming soon
+
+These are local candidate sources, not a claim that the published package or
+hosted API supports selection yet.
+
+End the final answer with a `selection` JSON fence after the question.
+`BodyForAgent` carries structured response and rich-message JSON; `RawBody` and
+`CommandBody` retain readable text. Stable values are not executable commands.
+
+New human reply text is literal `• ` + each selected source label joined with
+`\n`, followed by `selection_response` metadata in source-option order. Dispatch
+with `selected_values` and the explicit source target, never label parsing.
+Exact legacy comma-joined text remains a server compatibility input. Tapping a
+selected option deselects it locally; the sole submit action is a centered
+compact light-blue Send button. iOS checked circles are presentation only.
+
 ## Install
 
 ```bash

package/contracts/relay-v1.lock.json

@@ -1,16 +1,16 @@
 {
   "relayServer": {
     "repository": "RelayMessenger/Relay-Server",
-    "commit": "a25111520f7fc92c25ecd945d1dfc9afa9f60a1f",
+    "commit": "b89d90c0b325a94402456de2e91a59b66c7d9603",
     "openapiPath": "contracts/developer/openapi.yaml",
-    "sha256": "9f3e662a13cd0e6b16a52fba4b53c75fe5817d134dcf152e00b054699c37839c"
+    "sha256": "503646bcd2b3fbc1170046880ef39f4219592fb9e5d9d00cef022b801abbb4bb"
   },
   "relaySdk": {
     "package": "@relaymessenger/sdk",
-    "version": "0.3.6-staging.12",
-    "integrity": "sha512-Om/9eiTFnXuiBUIBbA85hahE4f+ry7sOKq/ZXGJ208BoqXPKD5+LZkCQ4NG08kzDkXEbwc5Lsldk0GCpXDNnLQ==",
+    "version": "0.3.6-staging.14",
+    "integrity": "sha512-0zUTLWzkFoW24w62yeSknuSKg27EeM8fmemxAsoyrWtCv5myxTm5h/FFFbnv8Guie2XxNXnwrMix6ullU/8FLw==",
     "operationsSha256": "1691197e8db0705bcad5d0704042e98ed8c3f2262875b5e773b0e12ae0a33022",
-    "workspaceOpenapiSha256": "9f3e662a13cd0e6b16a52fba4b53c75fe5817d134dcf152e00b054699c37839c",
+    "workspaceOpenapiSha256": "503646bcd2b3fbc1170046880ef39f4219592fb9e5d9d00cef022b801abbb4bb",
     "usedOperations": [
       {
         "method": "GET",

package/dist/src/channel.js

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

package/dist/src/dispatch.js

@@ -1,3 +1,4 @@
+import { BUTTONS_GUIDANCE, BUTTONS_BLOCK_INSTRUCTION, LINK_LINE_INSTRUCTION, SELECTION_GUIDANCE, SELECTION_BLOCK_INSTRUCTION, selectionReplyContext } from "@relaymessenger/sdk";
 import { buildChannelInboundEventContext, resolveChannelInboundRouteEnvelope, } from "openclaw/plugin-sdk/channel-inbound";
 import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import { bindIngressLifecycleToReplyOptions } from "openclaw/plugin-sdk/channel-outbound";
@@ -177,7 +178,9 @@ export async function dispatchRelayEvent(params) {
         message: {
             inboundEventKind: "user_request",
             body,
-            bodyForAgent: facts.text,
+            bodyForAgent: [facts.text, selectionReplyContext(facts.selection, facts.richMessage),
+                `${BUTTONS_BLOCK_INSTRUCTION} ${LINK_LINE_INSTRUCTION} ${BUTTONS_GUIDANCE} ${SELECTION_BLOCK_INSTRUCTION} ${SELECTION_GUIDANCE}`,
+            ].filter(Boolean).join("\n\n"),
             rawBody: facts.text,
             commandBody: facts.text,
         },

package/dist/src/inbound.js

@@ -1,3 +1,4 @@
+import { selectionReply, selectionReplyContext } from "@relaymessenger/sdk";
 function renderPart(part) {
     switch (part.type) {
         case "text":
@@ -11,6 +12,8 @@ function renderPart(part) {
         // 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":
+        case "selection":
+        case "selection_response":
             return undefined;
     }
 }
@@ -41,7 +44,9 @@ export function buildRelayInboundFacts(event) {
         event.data.sender_handle.kind !== "agent")
         return null;
     const text = renderRelayMessageParts(event.data.parts);
-    if (!text.trim())
+    const message = { parts: event.data.parts, ...(event.data.reply_to ? { reply_to: event.data.reply_to } : {}) };
+    const richMessage = selectionReplyContext(undefined, message) ? message : undefined;
+    if (!text.trim() && !richMessage)
         return null;
     const mentionHandles = event.data.parts.flatMap((part) => part.type === "text" &&
         typeof part.mention === "string" &&
@@ -50,7 +55,10 @@ export function buildRelayInboundFacts(event) {
         : []);
     const timestampValue = event.data.sent_at ?? event.created_at;
     const timestamp = Date.parse(timestampValue);
+    const selection = selectionReply(event.data.parts, event.data.reply_to);
     return {
+        ...(selection ? { selection } : {}),
+        ...(richMessage ? { richMessage } : {}),
         eventId: event.event_id,
         messageId: event.data.id,
         chatId: event.data.chat.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relaymessenger/openclaw-plugin",
-  "version": "0.4.7-staging.14",
+  "version": "0.4.7-staging.16",
   "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.12"
+    "@relaymessenger/sdk": "0.3.6-staging.14"
   },
   "devDependencies": {
     "@types/node": "^26.6.2",

package/src/channel.ts

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

package/src/dispatch.ts

@@ -1,3 +1,4 @@
+import { BUTTONS_GUIDANCE, BUTTONS_BLOCK_INSTRUCTION, LINK_LINE_INSTRUCTION, SELECTION_GUIDANCE, SELECTION_BLOCK_INSTRUCTION, selectionReplyContext } from "@relaymessenger/sdk";
 import type {
   Message,
   Relay,
@@ -243,7 +244,9 @@ export async function dispatchRelayEvent(params: {
     message: {
       inboundEventKind: "user_request",
       body,
-      bodyForAgent: facts.text,
+      bodyForAgent: [facts.text, selectionReplyContext(facts.selection, facts.richMessage),
+        `${BUTTONS_BLOCK_INSTRUCTION} ${LINK_LINE_INSTRUCTION} ${BUTTONS_GUIDANCE} ${SELECTION_BLOCK_INSTRUCTION} ${SELECTION_GUIDANCE}`,
+      ].filter(Boolean).join("\n\n"),
       rawBody: facts.text,
       commandBody: facts.text,
     },

package/src/inbound.ts

@@ -1,3 +1,4 @@
+import { selectionReply, selectionReplyContext } from "@relaymessenger/sdk";
 import type {
   MessagePartResponse,
   RelayWebhookEvent,
@@ -20,6 +21,8 @@ function renderPart(part: MessagePartResponse): string | undefined {
     // 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":
+    case "selection":
+    case "selection_response":
       return undefined;
   }
 }
@@ -61,7 +64,9 @@ export function buildRelayInboundFacts(
   ) return null;
 
   const text = renderRelayMessageParts(event.data.parts);
-  if (!text.trim()) return null;
+  const message = { parts: event.data.parts, ...(event.data.reply_to ? { reply_to: event.data.reply_to } : {}) };
+  const richMessage = selectionReplyContext(undefined, message) ? message : undefined;
+  if (!text.trim() && !richMessage) return null;
 
   const mentionHandles = event.data.parts.flatMap((part) =>
     part.type === "text" &&
@@ -72,7 +77,10 @@ export function buildRelayInboundFacts(
   );
   const timestampValue = event.data.sent_at ?? event.created_at;
   const timestamp = Date.parse(timestampValue);
+  const selection = selectionReply(event.data.parts, event.data.reply_to);
   return {
+    ...(selection ? { selection } : {}),
+    ...(richMessage ? { richMessage } : {}),
     eventId: event.event_id,
     messageId: event.data.id,
     chatId: event.data.chat.id,

package/src/types.ts

@@ -1,5 +1,8 @@
 import type {
   Chat,
+  SelectionReply,
+  MessagePartResponse,
+  ReplyTo,
   ChatHandle,
   MessageWebhookData,
   Message,
@@ -61,6 +64,8 @@ export type RelayMessageReceivedEvent = RelayWebhookEnvelope<
 >;
 
 export type RelayInboundFacts = {
+  selection?: SelectionReply;
+  richMessage?: { parts: MessagePartResponse[]; reply_to?: ReplyTo | null };
   eventId: string;
   messageId: string;
   chatId: string;