@maudecode/openclaw-cowtail 0.12.1 → 0.12.3

package/dist/index.js

@@ -13844,6 +13844,7 @@ var openclawActionSubmittedEventSchema = openclawEventEnvelopeSchema.extend({
   payload: jsonObjectSchema
 });
 var openclawRequestIdSchema = nonEmptyStringSchema;
+var openclawIdempotencyKeySchema = nonEmptyStringSchema;
 var openclawActionDraftSchema = exports_external.object({
   label: nonEmptyStringSchema,
   kind: nonEmptyStringSchema,
@@ -13852,6 +13853,7 @@ var openclawActionDraftSchema = exports_external.object({
 var openclawPluginMessageCommandSchema = requireOpenClawRenderableContent(exports_external.object({
   type: exports_external.literal("openclaw_message"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   sessionKey: nonEmptyStringSchema,
   title: nonEmptyStringSchema.optional(),
   text: openclawMessageTextSchema,
@@ -13864,6 +13866,7 @@ var openclawPluginMessageCommandSchema = requireOpenClawRenderableContent(export
 var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(exports_external.object({
   type: exports_external.literal("openclaw_message_update"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   messageId: nonEmptyStringSchema,
   text: openclawMessageTextSchema,
   links: exports_external.array(openclawLinkSchema).optional(),
@@ -13874,46 +13877,54 @@ var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(
 var openclawIosNewThreadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_new_thread"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   title: nonEmptyStringSchema.optional(),
   text: nonEmptyStringSchema
 });
 var openclawIosReplyCommandSchema = exports_external.object({
   type: exports_external.literal("ios_reply"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema,
   text: nonEmptyStringSchema
 });
 var openclawIosActionCommandSchema = exports_external.object({
   type: exports_external.literal("ios_action"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   actionId: nonEmptyStringSchema,
   payload: jsonObjectSchema
 });
 var openclawIosMarkThreadReadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_mark_thread_read"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema
 });
 var openclawIosRenameThreadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_rename_thread"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema,
   title: nonEmptyStringSchema
 });
 var openclawIosDeleteThreadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_delete_thread"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema
 });
 var openclawSessionBoundCommandSchema = exports_external.object({
   type: exports_external.literal("openclaw_session_bound"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema,
   sessionKey: nonEmptyStringSchema
 });
 var openclawActionResultCommandSchema = exports_external.object({
   type: exports_external.literal("openclaw_action_result"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   actionId: nonEmptyStringSchema,
   state: exports_external.enum(["submitted", "failed", "expired"]),
   resultMetadata: jsonObjectSchema.optional()
@@ -14164,33 +14175,41 @@ class CowtailRealtimeClient {
     this.#closeSocket();
   }
   sendOpenClawMessage(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory(),
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`,
       links: command.links ?? [],
       toolCalls: command.toolCalls ?? [],
       actions: command.actions ?? []
     });
   }
   sendOpenClawMessageUpdate(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory(),
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`,
       ...command.links ? { links: command.links } : {},
       ...command.toolCalls ? { toolCalls: command.toolCalls } : {},
       ...command.actions ? { actions: command.actions } : {}
     });
   }
   sendSessionBound(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory()
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`
     }).then((result) => result.sequence);
   }
   sendActionResult(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory()
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`
     }).then((result) => result.sequence);
   }
   #connect() {
@@ -14498,6 +14517,7 @@ async function handleCowtailEvent(params) {
       if (!thread.sessionKey) {
         await client.sendSessionBound({
           type: "openclaw_session_bound",
+          idempotencyKey: `cowtail:session-bound:${thread.id}`,
           threadId: thread.id,
           sessionKey: route.sessionKey
         });
@@ -14566,6 +14586,7 @@ async function handleCowtailEvent(params) {
         });
         await client.sendActionResult({
           type: "openclaw_action_result",
+          idempotencyKey: `cowtail:action-result:${action.id}:${dispatchSucceeded ? "submitted" : "failed"}`,
           actionId: action.id,
           state: dispatchSucceeded ? "submitted" : "failed"
         });
@@ -14573,6 +14594,7 @@ async function handleCowtailEvent(params) {
         logger?.error?.(`Cowtail action dispatch failed: ${errorMessage(error48)}`);
         await client.sendActionResult({
           type: "openclaw_action_result",
+          idempotencyKey: `cowtail:action-result:${action.id}:failed`,
           actionId: action.id,
           state: "failed"
         });
@@ -14602,7 +14624,13 @@ async function dispatchCowtailTextTurn(params) {
     body,
     timestamp: message.createdAt
   });
-  const streamState = { text: "", links: [], toolCalls: [] };
+  const streamState = {
+    idempotencyKey: `cowtail:reply:${message.id}`,
+    updateIndex: 0,
+    text: "",
+    links: [],
+    toolCalls: []
+  };
   await recordCowtailInboundSessionAndDispatchReply({
     cfg: runtime.config.loadConfig(),
     channel: CHANNEL_ID,
@@ -14658,7 +14686,13 @@ async function dispatchCowtailActionTurn(params) {
     timestamp
   });
   let dispatchFailed = false;
-  const streamState = { text: "", links: [], toolCalls: [] };
+  const streamState = {
+    idempotencyKey: `cowtail:action:${action.id}`,
+    updateIndex: 0,
+    text: "",
+    links: [],
+    toolCalls: []
+  };
   await recordCowtailInboundSessionAndDispatchReply({
     cfg: runtime.config.loadConfig(),
     channel: CHANNEL_ID,
@@ -14745,6 +14779,7 @@ async function deliverCowtailReply(params) {
     if (!params.streamState.messageId) {
       const result = await params.client.sendOpenClawMessage({
         type: "openclaw_message",
+        idempotencyKey: params.streamState.idempotencyKey,
         sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
         title: params.thread.title,
         text: messageText,
@@ -14763,6 +14798,7 @@ async function deliverCowtailReply(params) {
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text: messageText,
       links,
@@ -14779,6 +14815,7 @@ async function deliverCowtailReply(params) {
     if (!params.streamState.messageId) {
       const result = await params.client.sendOpenClawMessage({
         type: "openclaw_message",
+        idempotencyKey: params.streamState.idempotencyKey,
         sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
         title: params.thread.title,
         text: params.streamState.text,
@@ -14797,6 +14834,7 @@ async function deliverCowtailReply(params) {
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text: params.streamState.text,
       links,
@@ -14809,6 +14847,7 @@ async function deliverCowtailReply(params) {
     params.streamState.text = text;
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text,
       links,
@@ -14821,6 +14860,7 @@ async function deliverCowtailReply(params) {
   }
   await params.client.sendOpenClawMessage({
     type: "openclaw_message",
+    idempotencyKey: params.streamState.idempotencyKey,
     sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
     title: params.thread.title,
     text,
@@ -14838,6 +14878,7 @@ async function finalizeCowtailStreamedReply(params) {
   }
   await params.client.sendOpenClawMessageUpdate({
     type: "openclaw_message_update",
+    idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
     messageId: params.streamState.messageId,
     text: params.streamState.text,
     links: params.streamState.links,
@@ -14849,6 +14890,12 @@ async function finalizeCowtailStreamedReply(params) {
 }
 function recordCreatedOpenClawMessageId(streamState, result) {
   if (result.payload?.dropped === true) {
+    if (result.payload.duplicate === true) {
+      const duplicateMessageId = result.payload.messageId;
+      if (typeof duplicateMessageId === "string" && duplicateMessageId.trim()) {
+        return duplicateMessageId;
+      }
+    }
     streamState.failed = true;
     streamState.completed = true;
     return;
@@ -14860,6 +14907,10 @@ function recordCreatedOpenClawMessageId(streamState, result) {
   streamState.failed = true;
   throw new Error("Cowtail realtime ack missing messageId for streamed OpenClaw reply");
 }
+function nextStreamUpdateIdempotencyKey(streamState) {
+  streamState.updateIndex += 1;
+  return `${streamState.idempotencyKey}:update:${streamState.updateIndex}`;
+}
 function resolveCowtailReplyLinks(payload) {
   const urls = [
     ...Array.isArray(payload.mediaUrls) ? payload.mediaUrls : [],

package/dist/setup-entry.js

@@ -13844,6 +13844,7 @@ var openclawActionSubmittedEventSchema = openclawEventEnvelopeSchema.extend({
   payload: jsonObjectSchema
 });
 var openclawRequestIdSchema = nonEmptyStringSchema;
+var openclawIdempotencyKeySchema = nonEmptyStringSchema;
 var openclawActionDraftSchema = exports_external.object({
   label: nonEmptyStringSchema,
   kind: nonEmptyStringSchema,
@@ -13852,6 +13853,7 @@ var openclawActionDraftSchema = exports_external.object({
 var openclawPluginMessageCommandSchema = requireOpenClawRenderableContent(exports_external.object({
   type: exports_external.literal("openclaw_message"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   sessionKey: nonEmptyStringSchema,
   title: nonEmptyStringSchema.optional(),
   text: openclawMessageTextSchema,
@@ -13864,6 +13866,7 @@ var openclawPluginMessageCommandSchema = requireOpenClawRenderableContent(export
 var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(exports_external.object({
   type: exports_external.literal("openclaw_message_update"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   messageId: nonEmptyStringSchema,
   text: openclawMessageTextSchema,
   links: exports_external.array(openclawLinkSchema).optional(),
@@ -13874,46 +13877,54 @@ var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(
 var openclawIosNewThreadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_new_thread"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   title: nonEmptyStringSchema.optional(),
   text: nonEmptyStringSchema
 });
 var openclawIosReplyCommandSchema = exports_external.object({
   type: exports_external.literal("ios_reply"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema,
   text: nonEmptyStringSchema
 });
 var openclawIosActionCommandSchema = exports_external.object({
   type: exports_external.literal("ios_action"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   actionId: nonEmptyStringSchema,
   payload: jsonObjectSchema
 });
 var openclawIosMarkThreadReadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_mark_thread_read"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema
 });
 var openclawIosRenameThreadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_rename_thread"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema,
   title: nonEmptyStringSchema
 });
 var openclawIosDeleteThreadCommandSchema = exports_external.object({
   type: exports_external.literal("ios_delete_thread"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema
 });
 var openclawSessionBoundCommandSchema = exports_external.object({
   type: exports_external.literal("openclaw_session_bound"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   threadId: nonEmptyStringSchema,
   sessionKey: nonEmptyStringSchema
 });
 var openclawActionResultCommandSchema = exports_external.object({
   type: exports_external.literal("openclaw_action_result"),
   requestId: openclawRequestIdSchema,
+  idempotencyKey: openclawIdempotencyKeySchema,
   actionId: nonEmptyStringSchema,
   state: exports_external.enum(["submitted", "failed", "expired"]),
   resultMetadata: jsonObjectSchema.optional()
@@ -14164,33 +14175,41 @@ class CowtailRealtimeClient {
     this.#closeSocket();
   }
   sendOpenClawMessage(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory(),
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`,
       links: command.links ?? [],
       toolCalls: command.toolCalls ?? [],
       actions: command.actions ?? []
     });
   }
   sendOpenClawMessageUpdate(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory(),
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`,
       ...command.links ? { links: command.links } : {},
       ...command.toolCalls ? { toolCalls: command.toolCalls } : {},
       ...command.actions ? { actions: command.actions } : {}
     });
   }
   sendSessionBound(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory()
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`
     }).then((result) => result.sequence);
   }
   sendActionResult(command) {
+    const requestId = this.#requestIdFactory();
     return this.#sendCommand({
       ...command,
-      requestId: this.#requestIdFactory()
+      requestId,
+      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`
     }).then((result) => result.sequence);
   }
   #connect() {
@@ -14498,6 +14517,7 @@ async function handleCowtailEvent(params) {
       if (!thread.sessionKey) {
         await client.sendSessionBound({
           type: "openclaw_session_bound",
+          idempotencyKey: `cowtail:session-bound:${thread.id}`,
           threadId: thread.id,
           sessionKey: route.sessionKey
         });
@@ -14566,6 +14586,7 @@ async function handleCowtailEvent(params) {
         });
         await client.sendActionResult({
           type: "openclaw_action_result",
+          idempotencyKey: `cowtail:action-result:${action.id}:${dispatchSucceeded ? "submitted" : "failed"}`,
           actionId: action.id,
           state: dispatchSucceeded ? "submitted" : "failed"
         });
@@ -14573,6 +14594,7 @@ async function handleCowtailEvent(params) {
         logger?.error?.(`Cowtail action dispatch failed: ${errorMessage(error48)}`);
         await client.sendActionResult({
           type: "openclaw_action_result",
+          idempotencyKey: `cowtail:action-result:${action.id}:failed`,
           actionId: action.id,
           state: "failed"
         });
@@ -14602,7 +14624,13 @@ async function dispatchCowtailTextTurn(params) {
     body,
     timestamp: message.createdAt
   });
-  const streamState = { text: "", links: [], toolCalls: [] };
+  const streamState = {
+    idempotencyKey: `cowtail:reply:${message.id}`,
+    updateIndex: 0,
+    text: "",
+    links: [],
+    toolCalls: []
+  };
   await recordCowtailInboundSessionAndDispatchReply({
     cfg: runtime.config.loadConfig(),
     channel: CHANNEL_ID,
@@ -14658,7 +14686,13 @@ async function dispatchCowtailActionTurn(params) {
     timestamp
   });
   let dispatchFailed = false;
-  const streamState = { text: "", links: [], toolCalls: [] };
+  const streamState = {
+    idempotencyKey: `cowtail:action:${action.id}`,
+    updateIndex: 0,
+    text: "",
+    links: [],
+    toolCalls: []
+  };
   await recordCowtailInboundSessionAndDispatchReply({
     cfg: runtime.config.loadConfig(),
     channel: CHANNEL_ID,
@@ -14745,6 +14779,7 @@ async function deliverCowtailReply(params) {
     if (!params.streamState.messageId) {
       const result = await params.client.sendOpenClawMessage({
         type: "openclaw_message",
+        idempotencyKey: params.streamState.idempotencyKey,
         sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
         title: params.thread.title,
         text: messageText,
@@ -14763,6 +14798,7 @@ async function deliverCowtailReply(params) {
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text: messageText,
       links,
@@ -14779,6 +14815,7 @@ async function deliverCowtailReply(params) {
     if (!params.streamState.messageId) {
       const result = await params.client.sendOpenClawMessage({
         type: "openclaw_message",
+        idempotencyKey: params.streamState.idempotencyKey,
         sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
         title: params.thread.title,
         text: params.streamState.text,
@@ -14797,6 +14834,7 @@ async function deliverCowtailReply(params) {
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text: params.streamState.text,
       links,
@@ -14809,6 +14847,7 @@ async function deliverCowtailReply(params) {
     params.streamState.text = text;
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text,
       links,
@@ -14821,6 +14860,7 @@ async function deliverCowtailReply(params) {
   }
   await params.client.sendOpenClawMessage({
     type: "openclaw_message",
+    idempotencyKey: params.streamState.idempotencyKey,
     sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
     title: params.thread.title,
     text,
@@ -14838,6 +14878,7 @@ async function finalizeCowtailStreamedReply(params) {
   }
   await params.client.sendOpenClawMessageUpdate({
     type: "openclaw_message_update",
+    idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
     messageId: params.streamState.messageId,
     text: params.streamState.text,
     links: params.streamState.links,
@@ -14849,6 +14890,12 @@ async function finalizeCowtailStreamedReply(params) {
 }
 function recordCreatedOpenClawMessageId(streamState, result) {
   if (result.payload?.dropped === true) {
+    if (result.payload.duplicate === true) {
+      const duplicateMessageId = result.payload.messageId;
+      if (typeof duplicateMessageId === "string" && duplicateMessageId.trim()) {
+        return duplicateMessageId;
+      }
+    }
     streamState.failed = true;
     streamState.completed = true;
     return;
@@ -14860,6 +14907,10 @@ function recordCreatedOpenClawMessageId(streamState, result) {
   streamState.failed = true;
   throw new Error("Cowtail realtime ack missing messageId for streamed OpenClaw reply");
 }
+function nextStreamUpdateIdempotencyKey(streamState) {
+  streamState.updateIndex += 1;
+  return `${streamState.idempotencyKey}:update:${streamState.updateIndex}`;
+}
 function resolveCowtailReplyLinks(payload) {
   const urls = [
     ...Array.isArray(payload.mediaUrls) ? payload.mediaUrls : [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maudecode/openclaw-cowtail",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "Cowtail channel plugin for OpenClaw",
   "type": "module",
   "repository": {