@relaymessenger/openclaw-plugin 0.4.7-staging.39 → 0.4.7-staging.40

package/contracts/relay-v1.lock.json

@@ -1,16 +1,16 @@
 {
   "relayServer": {
     "repository": "RelayMessenger/Relay-Server",
-    "commit": "6645d5f8de90de4a9e40105d69524374a71be29c",
+    "commit": "65c4473526e4bbd3fedcd747ab09d218d00920ce",
     "openapiPath": "contracts/developer/openapi.yaml",
-    "sha256": "f3fd943df25536ae40346ba0fed7dc261ee537875348d6ecdd65021fcc9853f3"
+    "sha256": "44d3202de07206707c8914c37029abc365c144be4245e677574210d2a1cf6f41"
   },
   "relaySdk": {
     "package": "@relaymessenger/sdk",
-    "version": "0.3.6-staging.46",
-    "integrity": "sha512-4OmsVlebKPTqZ/qsR07ccjBfPLkVWFmVg1XO8UEVjComqZs8EnXZqgcjB8ZAWSF6rM5EwZV5h1XbVLEKuxvbgw==",
+    "version": "0.3.6-staging.47",
+    "integrity": "sha512-CI67lgtiuYyhSwuttqXF6x07OC9fDwTIpT3eCZPiqHGxWDo6Tx/zNmAAUzEDcw9ExoGOHP2VXnIlcDFMlQrslw==",
     "operationsSha256": "3e09d345c249709d942d2efb89ed7e84934c19552767d8f4438eb086dd917e1c",
-    "workspaceOpenapiSha256": "f3fd943df25536ae40346ba0fed7dc261ee537875348d6ecdd65021fcc9853f3",
+    "workspaceOpenapiSha256": "44d3202de07206707c8914c37029abc365c144be4245e677574210d2a1cf6f41",
     "usedOperations": [
       {
         "method": "GET",

package/dist/src/dispatch.js

@@ -2,7 +2,7 @@ import { BUTTONS_GUIDANCE, BUTTONS_BLOCK_INSTRUCTION, PAYMENT_BLOCK_INSTRUCTION,
 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";
-import { buildRelayInboundFacts } from "./inbound.js";
+import { buildRelayInboundFacts, renderRelayMessageParts } from "./inbound.js";
 import { waitForIdleChat } from "./turns.js";
 function isReplyToAgentMessage(message, chatId) {
     return message.chat_id === chatId && message.is_from_me === true;
@@ -30,7 +30,8 @@ export async function resolveRelayTurnActivation(params) {
     }
     if (!params.facts.replyToId)
         return null;
-    const replyTarget = await params.relay.messages.retrieve(params.facts.replyToId);
+    const replyTarget = params.replyTarget
+        ?? await params.relay.messages.retrieve(params.facts.replyToId);
     if (!isReplyToAgentMessage(replyTarget, params.facts.chatId))
         return null;
     return {
@@ -39,6 +40,48 @@ export async function resolveRelayTurnActivation(params) {
         implicitMentionKinds: ["reply_to_bot"],
     };
 }
+/**
+ * The Message a swipe-reply answers, read once for the quote and for group
+ * activation. A failed read is logged and the turn runs without the quote;
+ * group activation then reads it itself and fails the delivery as before.
+ */
+async function readReplyTarget(params) {
+    if (!params.facts.replyToId)
+        return undefined;
+    try {
+        return await params.relay.messages.retrieve(params.facts.replyToId);
+    }
+    catch (error) {
+        params.warn?.(`relay: could not read the Message ${params.facts.replyToId} that ${params.facts.messageId} replies to: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+}
+/**
+ * OpenClaw's own reply context, `supplemental.quote`, which it renders to the
+ * model as "Reply target of current user message" (id, sender, body), as its
+ * Telegram channel fills it from Telegram's `reply_to_message`. A reply names
+ * one bubble: when the target has more than one part, only the swiped part is
+ * quoted, the rule Relay's iOS app uses to draw the quote.
+ */
+export function relayReplyQuote(facts, target) {
+    if (!target || target.chat_id !== facts.chatId)
+        return undefined;
+    const parts = target.parts ?? [];
+    const swiped = parts.length > 1 && facts.replyToPartIndex !== undefined
+        ? parts[facts.replyToPartIndex]
+        : undefined;
+    const body = renderRelayMessageParts(swiped ? [swiped] : parts);
+    const sender = target.from_handle?.display_name?.trim()
+        || target.from_handle?.handle
+        || target.from
+        || undefined;
+    return {
+        id: target.id,
+        ...(body ? { body } : {}),
+        ...(sender ? { sender } : {}),
+        senderAllowed: true,
+    };
+}
 /**
  * The answer to another agent names the Message it answers: the model's own
  * reply target when it chose one, else the agent's Message. Where no reply may
@@ -60,9 +103,15 @@ export async function dispatchRelayEvent(params) {
         params.warn?.(`relay: durably accepted ${params.event.event_type} event ${params.event.event_id} without an agent turn`);
         return;
     }
+    const repliedTo = await readReplyTarget({
+        facts,
+        relay: params.relay,
+        warn: params.warn,
+    });
     const activation = await resolveRelayTurnActivation({
         facts,
         relay: params.relay,
+        ...(repliedTo ? { replyTarget: repliedTo } : {}),
     });
     if (!activation) {
         params.warn?.(`relay: durably accepted unmentioned group Message ${facts.messageId} without an agent turn`);
@@ -164,6 +213,7 @@ export async function dispatchRelayEvent(params) {
         ...(facts.timestamp ? { timestamp: facts.timestamp } : {}),
         body: facts.text,
     });
+    const quote = relayReplyQuote(facts, repliedTo);
     const ctxPayload = buildChannelInboundEventContext({
         channel: "relay",
         accountId: route.accountId ?? params.account.accountId,
@@ -203,6 +253,7 @@ export async function dispatchRelayEvent(params) {
             rawBody: facts.text,
             commandBody: facts.text,
         },
+        ...(quote ? { supplemental: { quote } } : {}),
         channelIngress: access,
         access: {
             commands: {

package/dist/src/inbound.js

@@ -88,6 +88,9 @@ export function buildRelayInboundFacts(event) {
         ...(event.data.reply_to?.message_id
             ? {
                 replyToId: event.data.reply_to.message_id,
+                ...(event.data.reply_to.part_index === undefined
+                    ? {}
+                    : { replyToPartIndex: event.data.reply_to.part_index }),
                 // 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

package/package.json

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

package/src/dispatch.ts

@@ -12,7 +12,7 @@ import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-
 import { bindIngressLifecycleToReplyOptions } from "openclaw/plugin-sdk/channel-outbound";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-payload";
-import { buildRelayInboundFacts } from "./inbound.js";
+import { buildRelayInboundFacts, renderRelayMessageParts } from "./inbound.js";
 import type { RelayIngressLifecycle } from "./ingress.js";
 import type { PluginRuntime } from "./runtime.js";
 import { type RelayChatTurns, waitForIdleChat } from "./turns.js";
@@ -55,6 +55,8 @@ function isReplyToAgentMessage(
 export async function resolveRelayTurnActivation(params: {
   facts: RelayInboundFacts;
   relay: RelayReplyLookup;
+  /** The replied-to Message when the caller already read it. */
+  replyTarget?: Message;
 }): Promise<RelayTurnActivation | null> {
   if (params.facts.chatType === "direct") {
     return {
@@ -77,9 +79,8 @@ export async function resolveRelayTurnActivation(params: {
   }
 
   if (!params.facts.replyToId) return null;
-  const replyTarget = await params.relay.messages.retrieve(
-    params.facts.replyToId,
-  );
+  const replyTarget = params.replyTarget
+    ?? await params.relay.messages.retrieve(params.facts.replyToId);
   if (!isReplyToAgentMessage(replyTarget, params.facts.chatId)) return null;
   return {
     kind: "reply",
@@ -88,6 +89,56 @@ export async function resolveRelayTurnActivation(params: {
   };
 }
 
+/**
+ * The Message a swipe-reply answers, read once for the quote and for group
+ * activation. A failed read is logged and the turn runs without the quote;
+ * group activation then reads it itself and fails the delivery as before.
+ */
+async function readReplyTarget(params: {
+  facts: RelayInboundFacts;
+  relay: RelayReplyLookup;
+  warn: ((message: string) => void) | undefined;
+}): Promise<Message | undefined> {
+  if (!params.facts.replyToId) return undefined;
+  try {
+    return await params.relay.messages.retrieve(params.facts.replyToId);
+  } catch (error) {
+    params.warn?.(
+      `relay: could not read the Message ${params.facts.replyToId} that ${params.facts.messageId} replies to: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    return undefined;
+  }
+}
+
+/**
+ * OpenClaw's own reply context, `supplemental.quote`, which it renders to the
+ * model as "Reply target of current user message" (id, sender, body), as its
+ * Telegram channel fills it from Telegram's `reply_to_message`. A reply names
+ * one bubble: when the target has more than one part, only the swiped part is
+ * quoted, the rule Relay's iOS app uses to draw the quote.
+ */
+export function relayReplyQuote(
+  facts: Pick<RelayInboundFacts, "chatId" | "replyToPartIndex">,
+  target: Message | undefined,
+) {
+  if (!target || target.chat_id !== facts.chatId) return undefined;
+  const parts = target.parts ?? [];
+  const swiped = parts.length > 1 && facts.replyToPartIndex !== undefined
+    ? parts[facts.replyToPartIndex]
+    : undefined;
+  const body = renderRelayMessageParts(swiped ? [swiped] : parts);
+  const sender = target.from_handle?.display_name?.trim()
+    || target.from_handle?.handle
+    || target.from
+    || undefined;
+  return {
+    id: target.id,
+    ...(body ? { body } : {}),
+    ...(sender ? { sender } : {}),
+    senderAllowed: true,
+  };
+}
+
 /**
  * The answer to another agent names the Message it answers: the model's own
  * reply target when it chose one, else the agent's Message. Where no reply may
@@ -124,9 +175,15 @@ export async function dispatchRelayEvent(params: {
     return;
   }
 
+  const repliedTo = await readReplyTarget({
+    facts,
+    relay: params.relay,
+    warn: params.warn,
+  });
   const activation = await resolveRelayTurnActivation({
     facts,
     relay: params.relay,
+    ...(repliedTo ? { replyTarget: repliedTo } : {}),
   });
   if (!activation) {
     params.warn?.(
@@ -235,6 +292,7 @@ export async function dispatchRelayEvent(params: {
     ...(facts.timestamp ? { timestamp: facts.timestamp } : {}),
     body: facts.text,
   });
+  const quote = relayReplyQuote(facts, repliedTo);
   const ctxPayload = buildChannelInboundEventContext({
     channel: "relay",
     accountId: route.accountId ?? params.account.accountId,
@@ -274,6 +332,7 @@ export async function dispatchRelayEvent(params: {
       rawBody: facts.text,
       commandBody: facts.text,
     },
+    ...(quote ? { supplemental: { quote } } : {}),
     channelIngress: access,
     access: {
       commands: {

package/src/inbound.ts

@@ -111,6 +111,9 @@ export function buildRelayInboundFacts(
     ...(event.data.reply_to?.message_id
       ? {
         replyToId: event.data.reply_to.message_id,
+        ...(event.data.reply_to.part_index === undefined
+          ? {}
+          : { replyToPartIndex: event.data.reply_to.part_index }),
         // 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

package/src/types.ts

@@ -77,6 +77,8 @@ export type RelayInboundFacts = {
   mentionHandles: string[];
   ownerHandle?: ChatHandle;
   replyToId?: string;
+  /** The part of the replied-to Message the person swiped (`reply_to.part_index`). */
+  replyToPartIndex?: number;
   /**
    * 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