@maudecode/openclaw-cowtail 0.12.1 → 0.13.0

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(),
@@ -13871,49 +13874,71 @@ var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(
   actions: exports_external.array(openclawActionDraftSchema).optional(),
   deliveryState: openclawDeliveryStateSchema.optional()
 }));
+var openclawMessageStreamSnapshotCommandBaseSchema = exports_external.object({
+  type: exports_external.literal("openclaw_message_stream_snapshot"),
+  requestId: openclawRequestIdSchema,
+  streamId: nonEmptyStringSchema,
+  sessionKey: nonEmptyStringSchema,
+  threadId: nonEmptyStringSchema,
+  text: openclawMessageTextSchema,
+  links: exports_external.array(openclawLinkSchema).default([]),
+  toolCalls: exports_external.array(openclawToolCallRecordSchema).default([]),
+  isFinal: exports_external.boolean(),
+  updatedAt: timestampSchema
+});
+var openclawMessageStreamSnapshotCommandSchema = requireOpenClawRenderableContent(openclawMessageStreamSnapshotCommandBaseSchema);
+var openclawMessageStreamSnapshotServerMessageSchema = requireOpenClawRenderableContent(openclawMessageStreamSnapshotCommandBaseSchema.omit({ requestId: true }));
 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()
@@ -13921,6 +13946,7 @@ var openclawActionResultCommandSchema = exports_external.object({
 var openclawRealtimeClientMessageSchema = exports_external.union([
   openclawPluginMessageCommandSchema,
   openclawPluginMessageUpdateCommandSchema,
+  openclawMessageStreamSnapshotCommandSchema,
   openclawIosNewThreadCommandSchema,
   openclawIosReplyCommandSchema,
   openclawIosActionCommandSchema,
@@ -13943,6 +13969,7 @@ var openclawRealtimeErrorSchema = exports_external.object({
 });
 var openclawRealtimeServerMessageSchema = exports_external.union([
   openclawEventEnvelopeSchema,
+  openclawMessageStreamSnapshotServerMessageSchema,
   openclawRealtimeAckSchema,
   openclawRealtimeErrorSchema
 ]);
@@ -14164,35 +14191,49 @@ 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);
   }
+  sendOpenClawStreamSnapshot(command) {
+    return this.#sendTransientCommand({
+      ...command,
+      requestId: this.#requestIdFactory()
+    });
+  }
   #connect() {
     if (!this.#started || this.#socket) {
       return;
@@ -14292,6 +14333,9 @@ class CowtailRealtimeClient {
       this.#rejectPendingRequest(message);
       return;
     }
+    if (message.type === "openclaw_message_stream_snapshot") {
+      return;
+    }
     await this.#onEvent(message);
     await this.#stateStore.writeLastSeenSequence(message.sequence);
   }
@@ -14368,6 +14412,19 @@ class CowtailRealtimeClient {
       }
     });
   }
+  async#sendTransientCommand(command) {
+    const socket = this.#socket;
+    const handshake = this.#handshake;
+    if (!socket || !handshake) {
+      throw new Error("Cowtail websocket is disconnected");
+    }
+    await handshake.promise;
+    const currentSocket = this.#socket;
+    if (!currentSocket || socket !== currentSocket || handshake !== this.#handshake || !this.#isSocketOpen(currentSocket)) {
+      throw new Error("Cowtail websocket is disconnected");
+    }
+    currentSocket.send(JSON.stringify(command));
+  }
   #resolvePendingRequest(requestId, sequence, payload) {
     const pending = this.#pendingRequests.get(requestId);
     if (!pending) {
@@ -14472,6 +14529,8 @@ var CHANNEL_LABEL = "Cowtail";
 var SENDER_LABEL = "Cowtail iOS";
 var SENDER_ID = "cowtail-ios";
 var SENDER_ADDRESS = "cowtail:ios";
+var STREAM_MIN_INTERVAL_MS = 45;
+var STREAM_MIN_CHARS_DELTA = 3;
 async function handleCowtailEvent(params) {
   const { event, account, client, runtime, logger } = params;
   switch (event.type) {
@@ -14498,6 +14557,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 +14626,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 +14634,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,18 +14664,32 @@ async function dispatchCowtailTextTurn(params) {
     body,
     timestamp: message.createdAt
   });
-  const streamState = { text: "", links: [], toolCalls: [] };
+  const streamState = {
+    idempotencyKey: `cowtail:reply:${message.id}`,
+    streamId: `cowtail:stream:${message.id}`,
+    updateIndex: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
+    text: "",
+    links: [],
+    toolCalls: []
+  };
   await recordCowtailInboundSessionAndDispatchReply({
     cfg: runtime.config.loadConfig(),
     channel: CHANNEL_ID,
     accountId: account.accountId,
     agentId: route.agentId,
+    client,
+    logger,
     route,
+    thread,
     storePath,
     ctxPayload,
     runtime,
+    streamState,
     deliver: async (payload, info, rawPayload) => deliverCowtailReply({
       client,
+      logger,
       route,
       thread,
       payload,
@@ -14630,6 +14706,9 @@ async function dispatchCowtailTextTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
 }
@@ -14658,18 +14737,32 @@ async function dispatchCowtailActionTurn(params) {
     timestamp
   });
   let dispatchFailed = false;
-  const streamState = { text: "", links: [], toolCalls: [] };
+  const streamState = {
+    idempotencyKey: `cowtail:action:${action.id}`,
+    streamId: `cowtail:action-stream:${action.id}`,
+    updateIndex: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
+    text: "",
+    links: [],
+    toolCalls: []
+  };
   await recordCowtailInboundSessionAndDispatchReply({
     cfg: runtime.config.loadConfig(),
     channel: CHANNEL_ID,
     accountId: account.accountId,
     agentId: route.agentId,
+    client,
+    logger,
     route,
+    thread,
     storePath,
     ctxPayload,
     runtime,
+    streamState,
     deliver: async (replyPayload, info, rawPayload) => deliverCowtailReply({
       client,
+      logger,
       route,
       thread,
       payload: replyPayload,
@@ -14687,6 +14780,9 @@ async function dispatchCowtailActionTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
   return !dispatchFailed;
@@ -14720,7 +14816,79 @@ async function recordCowtailInboundSessionAndDispatchReply(params) {
     },
     replyOptions: {
       disableBlockStreaming: false,
-      onModelSelected
+      onModelSelected,
+      onPartialReply: (payload) => {
+        deliverCowtailPartialReply({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          payload: normalizeCowtailReplyPayload(payload),
+          streamState: params.streamState
+        });
+      },
+      onToolStart: (payload) => {
+        deliverCowtailToolProgress({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          streamState: params.streamState,
+          payload,
+          requireStableId: true
+        });
+      },
+      onItemEvent: (payload) => {
+        deliverCowtailToolProgress({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          streamState: params.streamState,
+          payload
+        });
+      },
+      onCommandOutput: (payload) => {
+        deliverCowtailToolProgress({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          streamState: params.streamState,
+          payload
+        });
+      },
+      onPatchSummary: (payload) => {
+        deliverCowtailToolProgress({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          streamState: params.streamState,
+          payload
+        });
+      },
+      onApprovalEvent: (payload) => {
+        deliverCowtailToolProgress({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          streamState: params.streamState,
+          payload
+        });
+      },
+      onToolResult: (payload) => {
+        deliverCowtailToolProgress({
+          client: params.client,
+          logger: params.logger,
+          route: params.route,
+          thread: params.thread,
+          streamState: params.streamState,
+          payload,
+          status: "complete"
+        });
+      }
     }
   });
 }
@@ -14740,11 +14908,22 @@ async function deliverCowtailReply(params) {
       rawPayload: params.rawPayload,
       streamState: params.streamState
     });
-    params.streamState.toolCalls = [...params.streamState.toolCalls, toolCall];
+    upsertCowtailToolCall(params.streamState, toolCall);
     const messageText = params.streamState.text;
+    emitCowtailStreamSnapshot({
+      client: params.client,
+      logger: params.logger,
+      route: params.route,
+      thread: params.thread,
+      streamState: params.streamState,
+      text: currentLiveCowtailStreamText(params.streamState),
+      isFinal: false,
+      updatedAt: Date.now()
+    });
     if (!params.streamState.messageId) {
-      const result = await params.client.sendOpenClawMessage({
+      const result2 = await params.client.sendOpenClawMessage({
         type: "openclaw_message",
+        idempotencyKey: params.streamState.idempotencyKey,
         sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
         title: params.thread.title,
         text: messageText,
@@ -14754,15 +14933,16 @@ async function deliverCowtailReply(params) {
         actions: [],
         deliveryState: "pending"
       });
-      const messageId = recordCreatedOpenClawMessageId(params.streamState, result);
-      if (!messageId) {
+      const messageId2 = recordCreatedOpenClawMessageId(params.streamState, result2);
+      if (!messageId2) {
         return;
       }
-      params.streamState.messageId = messageId;
+      params.streamState.messageId = messageId2;
       return;
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text: messageText,
       links,
@@ -14776,9 +14956,20 @@ async function deliverCowtailReply(params) {
   }
   if (kind === "block") {
     params.streamState.text = appendReplyBlock(params.streamState.text, text);
+    emitCowtailStreamSnapshot({
+      client: params.client,
+      logger: params.logger,
+      route: params.route,
+      thread: params.thread,
+      streamState: params.streamState,
+      text: params.streamState.text,
+      isFinal: false,
+      updatedAt: Date.now()
+    });
     if (!params.streamState.messageId) {
-      const result = await params.client.sendOpenClawMessage({
+      const result2 = 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,
@@ -14788,15 +14979,16 @@ async function deliverCowtailReply(params) {
         actions: [],
         deliveryState: "pending"
       });
-      const messageId = recordCreatedOpenClawMessageId(params.streamState, result);
-      if (!messageId) {
+      const messageId2 = recordCreatedOpenClawMessageId(params.streamState, result2);
+      if (!messageId2) {
         return;
       }
-      params.streamState.messageId = messageId;
+      params.streamState.messageId = messageId2;
       return;
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
+      idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
       messageId: params.streamState.messageId,
       text: params.streamState.text,
       links,
@@ -14809,6 +15001,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,
@@ -14816,11 +15009,23 @@ async function deliverCowtailReply(params) {
       actions: [],
       deliveryState: "sent"
     });
+    emitCowtailStreamSnapshot({
+      client: params.client,
+      logger: params.logger,
+      route: params.route,
+      thread: params.thread,
+      streamState: params.streamState,
+      text,
+      isFinal: true,
+      updatedAt: Date.now()
+    });
     params.streamState.completed = true;
     return;
   }
-  await params.client.sendOpenClawMessage({
+  params.streamState.text = text;
+  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,
@@ -14830,6 +15035,21 @@ async function deliverCowtailReply(params) {
     actions: [],
     deliveryState: "sent"
   });
+  const messageId = recordCreatedOpenClawMessageId(params.streamState, result);
+  if (!messageId) {
+    return;
+  }
+  params.streamState.messageId = messageId;
+  emitCowtailStreamSnapshot({
+    client: params.client,
+    logger: params.logger,
+    route: params.route,
+    thread: params.thread,
+    streamState: params.streamState,
+    text,
+    isFinal: true,
+    updatedAt: Date.now()
+  });
   params.streamState.completed = true;
 }
 async function finalizeCowtailStreamedReply(params) {
@@ -14838,6 +15058,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,
@@ -14845,10 +15066,125 @@ async function finalizeCowtailStreamedReply(params) {
     actions: [],
     deliveryState: "sent"
   });
+  emitCowtailStreamSnapshot({
+    client: params.client,
+    logger: params.logger,
+    route: params.route,
+    thread: params.thread,
+    streamState: params.streamState,
+    text: params.streamState.text,
+    isFinal: true,
+    updatedAt: Date.now()
+  });
   params.streamState.completed = true;
 }
+function deliverCowtailPartialReply(params) {
+  const text = params.payload.text;
+  if (params.streamState.failed || typeof text !== "string" || !text.trim()) {
+    return;
+  }
+  const now = Date.now();
+  const previous = params.streamState.lastSnapshotText ?? "";
+  const changedChars = Math.abs(text.length - previous.length);
+  const sentRecently = params.streamState.lastSnapshotSentAt !== undefined && now - params.streamState.lastSnapshotSentAt < STREAM_MIN_INTERVAL_MS;
+  if (text === previous || sentRecently && changedChars < STREAM_MIN_CHARS_DELTA) {
+    return;
+  }
+  emitCowtailStreamSnapshot({
+    client: params.client,
+    logger: params.logger,
+    route: params.route,
+    thread: params.thread,
+    streamState: params.streamState,
+    text,
+    isFinal: false,
+    updatedAt: now
+  });
+}
+function deliverCowtailToolProgress(params) {
+  if (params.streamState.failed) {
+    return;
+  }
+  const payload = readRecord(params.payload) ?? {};
+  const stableId = readString(payload.itemId) ?? readString(payload.toolCallId) ?? readString(payload.id);
+  if (params.requireStableId && !stableId) {
+    return;
+  }
+  const id = stableId ?? fallbackCowtailToolCallId(params.streamState, payload);
+  const name = readString(payload.name) ?? readString(payload.title) ?? readString(payload.command) ?? "tool_result";
+  const status = params.status ?? normalizeCowtailToolCallStatus(payload.status) ?? normalizeCowtailToolCallStatus(payload.phase) ?? "running";
+  const result = readCowtailToolProgressResult(payload);
+  const args = readRecord(payload.args) ?? readRecord(payload.input);
+  const now = Date.now();
+  const currentText = currentLiveCowtailStreamText(params.streamState);
+  const nextToolCall = {
+    id,
+    name,
+    ...args ? { args } : {},
+    ...result !== undefined ? { result } : {},
+    status,
+    ...status === "complete" || status === "error" ? { completedAt: now } : {},
+    insertedAtContentLength: currentText.length,
+    contentSnapshotAtStart: currentText
+  };
+  upsertCowtailToolCall(params.streamState, nextToolCall);
+  emitCowtailStreamSnapshot({
+    client: params.client,
+    logger: params.logger,
+    route: params.route,
+    thread: params.thread,
+    streamState: params.streamState,
+    text: currentText,
+    isFinal: false,
+    updatedAt: now
+  });
+}
+function emitCowtailStreamSnapshot(params) {
+  if (params.streamState.failed || !params.text.trim() && params.streamState.links.length === 0 && params.streamState.toolCalls.length === 0) {
+    return;
+  }
+  params.streamState.liveText = params.text;
+  params.streamState.lastSnapshotText = params.text;
+  params.streamState.lastSnapshotSentAt = params.updatedAt;
+  params.client.sendOpenClawStreamSnapshot({
+    type: "openclaw_message_stream_snapshot",
+    streamId: params.streamState.streamId,
+    sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
+    threadId: params.thread.id,
+    text: params.text,
+    links: params.streamState.links.map((link) => ({ ...link })),
+    toolCalls: structuredClone(params.streamState.toolCalls),
+    isFinal: params.isFinal,
+    updatedAt: params.updatedAt
+  }).catch((error48) => {
+    params.logger?.warn?.(`Cowtail stream snapshot send failed: ${errorMessage(error48)}`);
+  });
+}
+function currentLiveCowtailStreamText(streamState) {
+  return streamState.liveText ?? streamState.text;
+}
+function upsertCowtailToolCall(streamState, toolCall) {
+  const index = streamState.toolCalls.findIndex((candidate) => candidate.id === toolCall.id);
+  if (index < 0) {
+    streamState.toolCalls = [...streamState.toolCalls, toolCall];
+    return;
+  }
+  const existing = streamState.toolCalls[index];
+  streamState.toolCalls[index] = {
+    ...existing,
+    ...toolCall,
+    insertedAtContentLength: existing.insertedAtContentLength ?? toolCall.insertedAtContentLength,
+    contentSnapshotAtStart: existing.contentSnapshotAtStart ?? toolCall.contentSnapshotAtStart
+  };
+}
 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 +15196,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 : [],
@@ -14932,6 +15272,48 @@ function readRecord(value) {
 function readToolCallStatus(value) {
   return value === "pending" || value === "running" || value === "complete" || value === "error" ? value : undefined;
 }
+function normalizeCowtailToolCallStatus(value) {
+  const status = readToolCallStatus(value);
+  if (status) {
+    return status;
+  }
+  if (value === "start" || value === "started" || value === "working") {
+    return "running";
+  }
+  if (value === "end" || value === "done" || value === "completed" || value === "success") {
+    return "complete";
+  }
+  if (value === "failed" || value === "failure") {
+    return "error";
+  }
+  return;
+}
+function readCowtailToolProgressResult(payload) {
+  const stringResult = readString(payload.output) ?? readString(payload.summary) ?? readString(payload.message) ?? readString(payload.progressText) ?? readString(payload.text);
+  if (stringResult !== undefined) {
+    return stringResult;
+  }
+  if (payload.result !== undefined) {
+    return payload.result;
+  }
+  const structuredPatch = {
+    ...Array.isArray(payload.added) ? { added: payload.added } : {},
+    ...Array.isArray(payload.modified) ? { modified: payload.modified } : {},
+    ...Array.isArray(payload.deleted) ? { deleted: payload.deleted } : {}
+  };
+  return Object.keys(structuredPatch).length > 0 ? structuredPatch : undefined;
+}
+function fallbackCowtailToolCallId(streamState, payload) {
+  const key = readString(payload.name) ?? readString(payload.title) ?? readString(payload.command) ?? JSON.stringify(Object.keys(payload).sort());
+  const existing = streamState.toolFallbackIds[key];
+  if (existing) {
+    return existing;
+  }
+  streamState.toolFallbackIndex += 1;
+  const next = `tool-${streamState.toolFallbackIndex}`;
+  streamState.toolFallbackIds[key] = next;
+  return next;
+}
 function readTimestamp(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : undefined;
 }