@relaymessenger/openclaw-plugin 0.3.0 → 0.3.3

package/dist/src/channel.js

@@ -27,6 +27,7 @@ import { buildRelayInboundFacts } from "./inbound.js";
 import { createRelayAccountLifecycleRegistry } from "./lifecycle.js";
 import { deriveRelayIdempotencyKey, RELAY_TEXT_CHUNK_LIMIT, reconcileRelayUnknownSend, sendRelayText, } from "./outbound.js";
 import { runRelayPollLoop } from "./poll-loop.js";
+import { markRespondingBeforeAttempt } from "./responding.js";
 import { getRelayRuntime } from "./runtime.js";
 import { relaySenderIsAllowed, resolveRelayAllowedSenderIds } from "./security.js";
 export const RELAY_CHANNEL_ID = "relay";
@@ -244,7 +245,13 @@ async function dispatchRelayInbound(params) {
     // Admission, runtime resolution, route/session lookup, envelope building,
     // and context finalization above are replay-safe. The durable attempt starts
     // immediately before OpenClaw can invoke the agent or its tools.
-    await params.markAttempt();
+    await markRespondingBeforeAttempt({
+        client: params.client,
+        conversationId: facts.conversationId,
+        messageId: facts.messageId,
+        label: "OpenClaw",
+        markAttempt: params.markAttempt,
+    });
     await runtime.channel.inbound.dispatchReply({
         cfg: params.cfg,
         channel: RELAY_CHANNEL_ID,
@@ -434,11 +441,6 @@ async function startRelayAccount(ctx) {
                     allowedSenderIds,
                     markAttempt,
                 });
-                // Read watermark after the turn is handled: read implies delivered;
-                // best effort — a failed receipt must not replay the event.
-                await client
-                    .markRead({ conversationId: facts.conversationId, messageId: facts.messageId })
-                    .catch((error) => log(`[relay] markRead failed: ${String(error)}`));
             },
         });
     }

package/dist/src/client.js

@@ -1,7 +1,6 @@
-// Thin Relay REST client for the OpenClaw channel plugin. Bespoke fetch until
-// the Relay SDK ships. Owns the abort-aware long poll, idempotent
-// sends, typing, and read watermarks. No SDK imports so unit tests run
-// without an OpenClaw runtime.
+// Thin Relay REST client boundary for the standalone OpenClaw channel plugin.
+// Owns the abort-aware long poll, idempotent sends, typing, responding, and
+// read watermarks without loading an OpenClaw runtime in unit tests.
 import { isIP } from "node:net";
 export const DEFAULT_RELAY_BASE_URL = "https://api.relayapp.im";
 function isLoopbackHostname(hostname) {
@@ -207,6 +206,17 @@ export function createRelayClient(options) {
                 signal: params.signal,
             });
         },
+        setResponding: async (params) => {
+            await request({
+                method: "POST",
+                path: `/v1/conversations/${encodeURIComponent(params.conversationId)}/responding`,
+                body: {
+                    message_id: params.messageId,
+                    ...(params.label ? { label: params.label } : {}),
+                },
+                signal: params.signal,
+            });
+        },
         markRead: async (params) => {
             await request({
                 method: "POST",

package/dist/src/responding.js

@@ -0,0 +1,13 @@
+/**
+ * The receipt must commit before OpenClaw can run an agent or tool. A rejected
+ * receipt leaves the durable attempt marker untouched, so the poll loop can
+ * replay the event safely instead of hiding the failure after execution.
+ */
+export async function markRespondingBeforeAttempt(params) {
+    await params.client.setResponding({
+        conversationId: params.conversationId,
+        messageId: params.messageId,
+        label: params.label,
+    });
+    await params.markAttempt();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relaymessenger/openclaw-plugin",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "Relay channel plugin for OpenClaw. Text your OpenClaw like a friend.",
   "license": "MIT",
   "publishConfig": {

package/src/channel.ts

@@ -50,6 +50,7 @@ import {
   sendRelayText,
 } from "./outbound.js";
 import { runRelayPollLoop } from "./poll-loop.js";
+import { markRespondingBeforeAttempt } from "./responding.js";
 import { getRelayRuntime } from "./runtime.js";
 import { relaySenderIsAllowed, resolveRelayAllowedSenderIds } from "./security.js";
 import type { RelayCoreConfig, ResolvedRelayAccount } from "./types.js";
@@ -286,7 +287,13 @@ async function dispatchRelayInbound(params: {
   // Admission, runtime resolution, route/session lookup, envelope building,
   // and context finalization above are replay-safe. The durable attempt starts
   // immediately before OpenClaw can invoke the agent or its tools.
-  await params.markAttempt();
+  await markRespondingBeforeAttempt({
+    client: params.client,
+    conversationId: facts.conversationId,
+    messageId: facts.messageId,
+    label: "OpenClaw",
+    markAttempt: params.markAttempt,
+  });
   await runtime.channel.inbound.dispatchReply({
     cfg: params.cfg,
     channel: RELAY_CHANNEL_ID,
@@ -492,11 +499,6 @@ async function startRelayAccount(ctx: ChannelGatewayContext<ResolvedRelayAccount
           allowedSenderIds,
           markAttempt,
         });
-        // Read watermark after the turn is handled: read implies delivered;
-        // best effort — a failed receipt must not replay the event.
-        await client
-          .markRead({ conversationId: facts.conversationId, messageId: facts.messageId })
-          .catch((error) => log(`[relay] markRead failed: ${String(error)}`));
       },
     });
   } catch (error) {

package/src/client.ts

@@ -1,7 +1,6 @@
-// Thin Relay REST client for the OpenClaw channel plugin. Bespoke fetch until
-// the Relay SDK ships. Owns the abort-aware long poll, idempotent
-// sends, typing, and read watermarks. No SDK imports so unit tests run
-// without an OpenClaw runtime.
+// Thin Relay REST client boundary for the standalone OpenClaw channel plugin.
+// Owns the abort-aware long poll, idempotent sends, typing, responding, and
+// read watermarks without loading an OpenClaw runtime in unit tests.
 import { isIP } from "node:net";
 import type {
   RelayAgentProfile,
@@ -146,6 +145,12 @@ export type RelayClient = {
     label?: string;
     signal?: AbortSignal;
   }) => Promise<void>;
+  setResponding: (params: {
+    conversationId: string;
+    messageId: string;
+    label?: string;
+    signal?: AbortSignal;
+  }) => Promise<void>;
   markRead: (params: {
     conversationId: string;
     messageId: string;
@@ -301,6 +306,18 @@ export function createRelayClient(options: RelayClientOptions): RelayClient {
       });
     },
 
+    setResponding: async (params) => {
+      await request({
+        method: "POST",
+        path: `/v1/conversations/${encodeURIComponent(params.conversationId)}/responding`,
+        body: {
+          message_id: params.messageId,
+          ...(params.label ? { label: params.label } : {}),
+        },
+        signal: params.signal,
+      });
+    },
+
     markRead: async (params) => {
       await request({
         method: "POST",

package/src/responding.ts

@@ -0,0 +1,21 @@
+import type { RelayClient } from "./client.js";
+
+/**
+ * The receipt must commit before OpenClaw can run an agent or tool. A rejected
+ * receipt leaves the durable attempt marker untouched, so the poll loop can
+ * replay the event safely instead of hiding the failure after execution.
+ */
+export async function markRespondingBeforeAttempt(params: {
+  client: RelayClient;
+  conversationId: string;
+  messageId: string;
+  label: string;
+  markAttempt: () => Promise<void>;
+}): Promise<void> {
+  await params.client.setResponding({
+    conversationId: params.conversationId,
+    messageId: params.messageId,
+    label: params.label,
+  });
+  await params.markAttempt();
+}