@maudecode/openclaw-cowtail 0.12.3 → 0.14.0

package/dist/index.js

@@ -13801,6 +13801,7 @@ var openclawThreadRecordSchema = exports_external.object({
 var openclawMessageRecordBaseSchema = exports_external.object({
   id: nonEmptyStringSchema,
   threadId: nonEmptyStringSchema,
+  streamId: nonEmptyStringSchema.optional(),
   direction: openclawMessageDirectionSchema,
   authorLabel: nonEmptyStringSchema.optional(),
   text: openclawMessageTextSchema,
@@ -13855,13 +13856,16 @@ var openclawPluginMessageCommandSchema = requireOpenClawRenderableContent(export
   requestId: openclawRequestIdSchema,
   idempotencyKey: openclawIdempotencyKeySchema,
   sessionKey: nonEmptyStringSchema,
+  threadId: nonEmptyStringSchema.optional(),
+  threadHint: nonEmptyStringSchema.optional(),
   title: nonEmptyStringSchema.optional(),
   text: openclawMessageTextSchema,
   authorLabel: nonEmptyStringSchema.optional(),
   links: exports_external.array(openclawLinkSchema).default([]),
   toolCalls: exports_external.array(openclawToolCallRecordSchema).default([]),
   actions: exports_external.array(openclawActionDraftSchema).default([]),
-  deliveryState: openclawDeliveryStateSchema.optional()
+  deliveryState: openclawDeliveryStateSchema.optional(),
+  streamId: nonEmptyStringSchema
 }));
 var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(exports_external.object({
   type: exports_external.literal("openclaw_message_update"),
@@ -13872,8 +13876,24 @@ var openclawPluginMessageUpdateCommandSchema = requireOpenClawRenderableContent(
   links: exports_external.array(openclawLinkSchema).optional(),
   toolCalls: exports_external.array(openclawToolCallRecordSchema).optional(),
   actions: exports_external.array(openclawActionDraftSchema).optional(),
-  deliveryState: openclawDeliveryStateSchema.optional()
+  deliveryState: openclawDeliveryStateSchema.optional(),
+  streamId: nonEmptyStringSchema
 }));
+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(),
+  snapshotSequence: exports_external.number().int().nonnegative(),
+  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,
@@ -13932,6 +13952,7 @@ var openclawActionResultCommandSchema = exports_external.object({
 var openclawRealtimeClientMessageSchema = exports_external.union([
   openclawPluginMessageCommandSchema,
   openclawPluginMessageUpdateCommandSchema,
+  openclawMessageStreamSnapshotCommandSchema,
   openclawIosNewThreadCommandSchema,
   openclawIosReplyCommandSchema,
   openclawIosActionCommandSchema,
@@ -13941,11 +13962,18 @@ var openclawRealtimeClientMessageSchema = exports_external.union([
   openclawSessionBoundCommandSchema,
   openclawActionResultCommandSchema
 ]);
+var openclawRealtimeAckPayloadSchema = exports_external.object({
+  threadId: nonEmptyStringSchema.optional(),
+  messageId: nonEmptyStringSchema.optional(),
+  dropped: exports_external.literal(true).optional(),
+  duplicate: exports_external.literal(true).optional(),
+  reason: nonEmptyStringSchema.optional()
+});
 var openclawRealtimeAckSchema = exports_external.object({
   type: exports_external.literal("ack"),
   requestId: openclawRequestIdSchema,
   sequence: openclawSequenceSchema.optional(),
-  payload: jsonObjectSchema.optional()
+  payload: openclawRealtimeAckPayloadSchema.optional()
 });
 var openclawRealtimeErrorSchema = exports_external.object({
   type: exports_external.literal("realtime_error"),
@@ -13954,6 +13982,7 @@ var openclawRealtimeErrorSchema = exports_external.object({
 });
 var openclawRealtimeServerMessageSchema = exports_external.union([
   openclawEventEnvelopeSchema,
+  openclawMessageStreamSnapshotServerMessageSchema,
   openclawRealtimeAckSchema,
   openclawRealtimeErrorSchema
 ]);
@@ -13993,6 +14022,13 @@ var openclawEventReplayResponseSchema = exports_external.object({
   ok: exports_external.literal(true),
   events: exports_external.array(openclawEventEnvelopeSchema)
 });
+var openclawPushNotificationPayloadSchema = exports_external.object({
+  kind: exports_external.literal("openclaw"),
+  version: exports_external.literal(1),
+  threadId: nonEmptyStringSchema,
+  messageId: nonEmptyStringSchema,
+  url: nonEmptyStringSchema.optional()
+});
 // ../protocol/src/fixes.ts
 var fixScopeSchema = exports_external.enum(fixScopes);
 var fixCreateRequestSchema = exports_external.object({
@@ -14048,11 +14084,12 @@ var healthResponseSchema = exports_external.object({
   storageUnit: nonEmptyStringSchema
 });
 // ../protocol/src/push.ts
+var pushEnvironmentSchema = exports_external.enum(["development", "production"]);
 var pushRegisterRequestSchema = exports_external.object({
   identityToken: nonEmptyStringSchema,
   deviceToken: nonEmptyStringSchema,
   platform: nonEmptyStringSchema.optional(),
-  environment: nonEmptyStringSchema.optional(),
+  environment: pushEnvironmentSchema.optional(),
   deviceName: nonEmptyStringSchema.optional()
 });
 var pushRegisterResponseSchema = exports_external.object({
@@ -14061,6 +14098,7 @@ var pushRegisterResponseSchema = exports_external.object({
   id: nonEmptyStringSchema
 });
 var pushUnregisterRequestSchema = exports_external.object({
+  identityToken: nonEmptyStringSchema,
   deviceToken: nonEmptyStringSchema
 });
 var pushUnregisterResponseSchema = exports_external.object({
@@ -14084,6 +14122,7 @@ var pushResultSchema = exports_external.object({
   userId: nonEmptyStringSchema,
   sent: exports_external.number().int().nonnegative(),
   failed: exports_external.number().int().nonnegative(),
+  skipped: exports_external.number().int().nonnegative().default(0),
   results: exports_external.array(jsonObjectSchema)
 });
 // ../protocol/src/responses.ts
@@ -14104,7 +14143,8 @@ var usersListEntrySchema = exports_external.object({
   enabledDeviceCount: exports_external.number().int().nonnegative()
 });
 var userDeviceSchema = exports_external.object({
-  deviceToken: nonEmptyStringSchema,
+  id: nonEmptyStringSchema,
+  deviceTokenPreview: nonEmptyStringSchema,
   platform: nonEmptyStringSchema,
   environment: nonEmptyStringSchema,
   enabled: exports_external.boolean(),
@@ -14176,10 +14216,12 @@ class CowtailRealtimeClient {
   }
   sendOpenClawMessage(command) {
     const requestId = this.#requestIdFactory();
+    const idempotencyKey = command.idempotencyKey ?? `cowtail:request:${requestId}`;
     return this.#sendCommand({
       ...command,
       requestId,
-      idempotencyKey: command.idempotencyKey ?? `cowtail:request:${requestId}`,
+      idempotencyKey,
+      streamId: command.streamId ?? idempotencyKey,
       links: command.links ?? [],
       toolCalls: command.toolCalls ?? [],
       actions: command.actions ?? []
@@ -14212,6 +14254,12 @@ class CowtailRealtimeClient {
       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;
@@ -14311,6 +14359,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);
   }
@@ -14387,6 +14438,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) {
@@ -14491,6 +14555,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) {
@@ -14626,7 +14692,11 @@ async function dispatchCowtailTextTurn(params) {
   });
   const streamState = {
     idempotencyKey: `cowtail:reply:${message.id}`,
+    streamId: `cowtail:stream:${message.id}`,
     updateIndex: 0,
+    snapshotSequence: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
     text: "",
     links: [],
     toolCalls: []
@@ -14636,12 +14706,17 @@ async function dispatchCowtailTextTurn(params) {
     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,
@@ -14658,6 +14733,9 @@ async function dispatchCowtailTextTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
 }
@@ -14688,7 +14766,11 @@ async function dispatchCowtailActionTurn(params) {
   let dispatchFailed = false;
   const streamState = {
     idempotencyKey: `cowtail:action:${action.id}`,
+    streamId: `cowtail:action-stream:${action.id}`,
     updateIndex: 0,
+    snapshotSequence: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
     text: "",
     links: [],
     toolCalls: []
@@ -14698,12 +14780,17 @@ async function dispatchCowtailActionTurn(params) {
     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,
@@ -14721,6 +14808,9 @@ async function dispatchCowtailActionTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
   return !dispatchFailed;
@@ -14754,7 +14844,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"
+        });
+      }
     }
   });
 }
@@ -14774,31 +14936,30 @@ 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({
-        type: "openclaw_message",
-        idempotencyKey: params.streamState.idempotencyKey,
-        sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
-        title: params.thread.title,
+      await createDurableCowtailReply(params, {
         text: messageText,
-        authorLabel: "OpenClaw",
         links,
-        toolCalls: params.streamState.toolCalls,
-        actions: [],
         deliveryState: "pending"
       });
-      const messageId = recordCreatedOpenClawMessageId(params.streamState, result);
-      if (!messageId) {
-        return;
-      }
-      params.streamState.messageId = messageId;
       return;
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
       idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
+      streamId: params.streamState.streamId,
       messageId: params.streamState.messageId,
       text: messageText,
       links,
@@ -14812,29 +14973,28 @@ 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({
-        type: "openclaw_message",
-        idempotencyKey: params.streamState.idempotencyKey,
-        sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
-        title: params.thread.title,
+      await createDurableCowtailReply(params, {
         text: params.streamState.text,
-        authorLabel: "OpenClaw",
         links,
-        toolCalls: params.streamState.toolCalls,
-        actions: [],
         deliveryState: "pending"
       });
-      const messageId = recordCreatedOpenClawMessageId(params.streamState, result);
-      if (!messageId) {
-        return;
-      }
-      params.streamState.messageId = messageId;
       return;
     }
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
       idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
+      streamId: params.streamState.streamId,
       messageId: params.streamState.messageId,
       text: params.streamState.text,
       links,
@@ -14848,6 +15008,7 @@ async function deliverCowtailReply(params) {
     await params.client.sendOpenClawMessageUpdate({
       type: "openclaw_message_update",
       idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
+      streamId: params.streamState.streamId,
       messageId: params.streamState.messageId,
       text,
       links,
@@ -14855,23 +15016,67 @@ 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({
-    type: "openclaw_message",
-    idempotencyKey: params.streamState.idempotencyKey,
-    sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
-    title: params.thread.title,
+  params.streamState.text = text;
+  const messageId = await createDurableCowtailReply(params, {
     text,
-    authorLabel: "OpenClaw",
     links,
-    toolCalls: params.streamState.toolCalls,
-    actions: [],
     deliveryState: "sent"
   });
+  if (!messageId) {
+    return;
+  }
+  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 createDurableCowtailReply(params, message) {
+  try {
+    const result = await params.client.sendOpenClawMessage({
+      type: "openclaw_message",
+      idempotencyKey: params.streamState.idempotencyKey,
+      streamId: params.streamState.streamId,
+      sessionKey: params.thread.sessionKey ?? params.route.sessionKey,
+      title: params.thread.title,
+      text: message.text,
+      authorLabel: "OpenClaw",
+      links: message.links,
+      toolCalls: params.streamState.toolCalls,
+      actions: [],
+      deliveryState: message.deliveryState
+    });
+    const messageId = recordCreatedOpenClawMessageId(params.streamState, result);
+    if (!messageId) {
+      failCowtailStreamBeforeDurableCreate(params);
+      return;
+    }
+    params.streamState.messageId = messageId;
+    return messageId;
+  } catch (error48) {
+    failCowtailStreamBeforeDurableCreate(params);
+    throw error48;
+  }
+}
 async function finalizeCowtailStreamedReply(params) {
   if (params.streamState.failed || params.streamState.completed || !params.streamState.messageId || !params.streamState.text.trim() && params.streamState.toolCalls.length === 0) {
     return;
@@ -14879,6 +15084,7 @@ async function finalizeCowtailStreamedReply(params) {
   await params.client.sendOpenClawMessageUpdate({
     type: "openclaw_message_update",
     idempotencyKey: nextStreamUpdateIdempotencyKey(params.streamState),
+    streamId: params.streamState.streamId,
     messageId: params.streamState.messageId,
     text: params.streamState.text,
     links: params.streamState.links,
@@ -14886,8 +15092,137 @@ 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.allowFailed !== true || !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.streamState.snapshotSequence += 1;
+  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,
+    snapshotSequence: params.streamState.snapshotSequence,
+    updatedAt: params.updatedAt
+  }).catch((error48) => {
+    params.logger?.warn?.(`Cowtail stream snapshot send failed: ${errorMessage(error48)}`);
+  });
+}
+function failCowtailStreamBeforeDurableCreate(params) {
+  if (!params.streamState.messageId && params.streamState.snapshotSequence > 0) {
+    const text = params.streamState.text.trim() ? params.streamState.text : currentLiveCowtailStreamText(params.streamState);
+    emitCowtailStreamSnapshot({
+      client: params.client,
+      logger: params.logger,
+      route: params.route,
+      thread: params.thread,
+      streamState: params.streamState,
+      text,
+      isFinal: true,
+      updatedAt: Date.now(),
+      allowFailed: true
+    });
+  }
+  params.streamState.failed = true;
+  params.streamState.completed = true;
+}
+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) {
@@ -14983,6 +15318,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;
 }
@@ -15105,23 +15482,29 @@ function resolveCowtailTarget(to) {
   if (!normalizedTarget) {
     throw new Error("Cowtail target must not be blank");
   }
-  return buildCowtailTarget(normalizedTarget);
+  return normalizedTarget;
 }
 async function sendCowtailText(params) {
   const { client, to } = params;
   const text = ensureNonBlankText(params.text);
   const target = resolveCowtailTarget(to);
+  const sessionKey = buildCowtailTarget(target);
   const result = await client.sendOpenClawMessage({
     type: "openclaw_message",
-    sessionKey: target,
+    sessionKey,
+    threadHint: target,
     text,
     links: [],
     actions: []
   });
+  const messageId = result.payload?.messageId;
+  if (typeof messageId !== "string" || messageId.trim() === "") {
+    throw new Error("Cowtail did not acknowledge a durable message id");
+  }
   return {
     channel: "cowtail",
-    messageId: String(result.sequence ?? result.requestId),
-    to: target
+    messageId,
+    to: buildCowtailTarget(target)
   };
 }