@relaymessenger/openclaw-plugin 0.4.7-staging.21 → 0.4.7-staging.23

package/README.md

@@ -26,11 +26,13 @@ checks any number of options and submits them once; checking sends nothing, and
 a person answers a given selection once. iOS may draw a checkmark in place of
 each bullet and repeat the prompt's title, as presentation only.
 
-## Invoice
+## Payment
 
-A verified agent ends the final answer with an `invoice` JSON fence holding a
-Stripe checkout link; the words go first and the invoice follows as its own
-Message.
+The agent ends the final answer with a `payment` JSON fence holding the
+payment request's fields (`description`, `category`, and `amount` with
+`currency`, or `mode: "subscription"` with `price_id`). The plugin creates the
+request with its own Relay token, on the card's own idempotency key; the words
+go first and the payment card follows as its own Message.
 
 ## Install
 

package/contracts/relay-v1.lock.json

@@ -1,16 +1,16 @@
 {
   "relayServer": {
     "repository": "RelayMessenger/Relay-Server",
-    "commit": "3b7425e5bafcf25cdc8ceff009715e4f06877d18",
+    "commit": "51bc3ecd9b203a3fc75fe0ab7a105b6751080678",
     "openapiPath": "contracts/developer/openapi.yaml",
-    "sha256": "3fb4873a3c09b7dade09012ecfc57acfef8cfb983b6b35fff9d320cf62bb3b00"
+    "sha256": "7b41c21bebd99d28d103da1c3fe380642542e5b6243bb4319e501d7609d8ab0f"
   },
   "relaySdk": {
     "package": "@relaymessenger/sdk",
-    "version": "0.3.6-staging.22",
-    "integrity": "sha512-PnMaOgFgLcYD8xTspki0mGpySfVnkxC/EjnyTiNYioWuy+hJjtYzE3xwjJEnDYyJ6HlucDzZqmFCE07PgILCGw==",
-    "operationsSha256": "5d9cc3d0eed738d85deb3842b6efc0db5fe720299aa53e959f87e83c8585be36",
-    "workspaceOpenapiSha256": "3fb4873a3c09b7dade09012ecfc57acfef8cfb983b6b35fff9d320cf62bb3b00",
+    "version": "0.3.6-staging.25",
+    "integrity": "sha512-OHmpqxGHc5DRjIaNc+5v5m7zuf7+y+5032Ca6lCvNajUUtkLeYp4TGMxzGTzCUg3Kmv62Kj7HE2wpQn1hfZxuQ==",
+    "operationsSha256": "2480be91815b2e9e35305026b0a6ef61ddf2bb6db1b349d2a6da3eb875f4707f",
+    "workspaceOpenapiSha256": "7b41c21bebd99d28d103da1c3fe380642542e5b6243bb4319e501d7609d8ab0f",
     "usedOperations": [
       {
         "method": "GET",

package/dist/src/dispatch.js

@@ -1,4 +1,4 @@
-import { BUTTONS_GUIDANCE, BUTTONS_BLOCK_INSTRUCTION, INVOICE_BLOCK_INSTRUCTION, INVOICE_GUIDANCE, LINK_LINE_INSTRUCTION, SELECTION_GUIDANCE, SELECTION_BLOCK_INSTRUCTION, selectionReplyContext } from "@relaymessenger/sdk";
+import { BUTTONS_GUIDANCE, BUTTONS_BLOCK_INSTRUCTION, PAYMENT_BLOCK_INSTRUCTION, PAYMENT_GUIDANCE, 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";
@@ -179,7 +179,7 @@ export async function dispatchRelayEvent(params) {
             inboundEventKind: "user_request",
             body,
             bodyForAgent: [facts.text, selectionReplyContext(facts.selection, facts.richMessage),
-                `${BUTTONS_BLOCK_INSTRUCTION} ${LINK_LINE_INSTRUCTION} ${BUTTONS_GUIDANCE} ${SELECTION_BLOCK_INSTRUCTION} ${SELECTION_GUIDANCE} ${INVOICE_BLOCK_INSTRUCTION} ${INVOICE_GUIDANCE}`,
+                `${BUTTONS_BLOCK_INSTRUCTION} ${LINK_LINE_INSTRUCTION} ${BUTTONS_GUIDANCE} ${SELECTION_BLOCK_INSTRUCTION} ${SELECTION_GUIDANCE} ${PAYMENT_BLOCK_INSTRUCTION} ${PAYMENT_GUIDANCE}`,
             ].filter(Boolean).join("\n\n"),
             rawBody: facts.text,
             commandBody: facts.text,

package/dist/src/outbound.js

@@ -1,5 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
-import { answerMessages, indexedIdempotencyKey, Relay, RelayAPIError, } from "@relaymessenger/sdk";
+import { answerMessages, createPaymentPart, indexedIdempotencyKey, Relay, RelayAPIError, } from "@relaymessenger/sdk";
 export const RELAY_TEXT_CHUNK_LIMIT = 10_000;
 const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
 export function createRelaySdkClient(account) {
@@ -27,11 +27,25 @@ export function deriveRelayIdempotencyKey(params) {
  */
 export async function sendRelayText(params) {
     await params.onPlatformSendDispatch?.();
-    const { messages, error } = answerMessages(params.text);
+    const { messages, payment, error } = answerMessages(params.text);
     if (error)
         params.onButtonsError?.(error);
-    if (messages.length === 0)
+    if (messages.length === 0 && !payment)
         messages.push([{ type: "text", value: params.text }]);
+    if (payment) {
+        // Created with the card's own key, so a retry of this delivery returns
+        // the same request. A refusal after words went out is reported and the
+        // words stand; with nothing sent yet, it is the delivery's own error.
+        const key = indexedIdempotencyKey(params.idempotencyKey, messages.length);
+        try {
+            messages.push([await createPaymentPart(params.relay, payment, key, params.signal ? { signal: params.signal } : undefined)]);
+        }
+        catch (refusal) {
+            if (!(refusal instanceof RelayAPIError) || refusal.retryable || messages.length === 0)
+                throw refusal;
+            params.onButtonsError?.(`the payment was not sent: ${refusal.message}`);
+        }
+    }
     let first;
     for (const [index, parts] of messages.entries()) {
         const response = await params.relay.chats.messages.send(params.chatId, {

package/package.json

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

package/src/dispatch.ts

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

package/src/outbound.ts

@@ -1,6 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import {
   answerMessages,
+  createPaymentPart,
   indexedIdempotencyKey,
   Relay,
   RelayAPIError,
@@ -43,7 +44,7 @@ export function deriveRelayIdempotencyKey(params: {
  * Message; the response is the first Message's, the one the reply anchors to.
  */
 export async function sendRelayText(params: {
-  relay: Pick<Relay, "chats">;
+  relay: Pick<Relay, "chats" | "paymentRequests">;
   chatId: string;
   text: string;
   replyToId?: string | null | undefined;
@@ -53,9 +54,21 @@ export async function sendRelayText(params: {
   onButtonsError?: (error: string) => void;
 }): Promise<MessageSendResponse> {
   await params.onPlatformSendDispatch?.();
-  const { messages, error } = answerMessages(params.text);
+  const { messages, payment, error } = answerMessages(params.text);
   if (error) params.onButtonsError?.(error);
-  if (messages.length === 0) messages.push([{ type: "text", value: params.text }]);
+  if (messages.length === 0 && !payment) messages.push([{ type: "text", value: params.text }]);
+  if (payment) {
+    // Created with the card's own key, so a retry of this delivery returns
+    // the same request. A refusal after words went out is reported and the
+    // words stand; with nothing sent yet, it is the delivery's own error.
+    const key = indexedIdempotencyKey(params.idempotencyKey, messages.length);
+    try {
+      messages.push([await createPaymentPart(params.relay, payment, key, params.signal ? { signal: params.signal } : undefined)]);
+    } catch (refusal) {
+      if (!(refusal instanceof RelayAPIError) || refusal.retryable || messages.length === 0) throw refusal;
+      params.onButtonsError?.(`the payment was not sent: ${refusal.message}`);
+    }
+  }
   let first: MessageSendResponse | undefined;
   for (const [index, parts] of messages.entries()) {
     const response = await params.relay.chats.messages.send(