@maudecode/openclaw-cowtail 0.12.3 → 0.13.0

package/dist/index.js

@@ -13874,6 +13874,20 @@ 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,
@@ -13932,6 +13946,7 @@ var openclawActionResultCommandSchema = exports_external.object({
 var openclawRealtimeClientMessageSchema = exports_external.union([
   openclawPluginMessageCommandSchema,
   openclawPluginMessageUpdateCommandSchema,
+  openclawMessageStreamSnapshotCommandSchema,
   openclawIosNewThreadCommandSchema,
   openclawIosReplyCommandSchema,
   openclawIosActionCommandSchema,
@@ -13954,6 +13969,7 @@ var openclawRealtimeErrorSchema = exports_external.object({
 });
 var openclawRealtimeServerMessageSchema = exports_external.union([
   openclawEventEnvelopeSchema,
+  openclawMessageStreamSnapshotServerMessageSchema,
   openclawRealtimeAckSchema,
   openclawRealtimeErrorSchema
 ]);
@@ -14212,6 +14228,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 +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);
   }
@@ -14387,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) {
@@ -14491,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) {
@@ -14626,7 +14666,10 @@ async function dispatchCowtailTextTurn(params) {
   });
   const streamState = {
     idempotencyKey: `cowtail:reply:${message.id}`,
+    streamId: `cowtail:stream:${message.id}`,
     updateIndex: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
     text: "",
     links: [],
     toolCalls: []
@@ -14636,12 +14679,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 +14706,9 @@ async function dispatchCowtailTextTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
 }
@@ -14688,7 +14739,10 @@ async function dispatchCowtailActionTurn(params) {
   let dispatchFailed = false;
   const streamState = {
     idempotencyKey: `cowtail:action:${action.id}`,
+    streamId: `cowtail:action-stream:${action.id}`,
     updateIndex: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
     text: "",
     links: [],
     toolCalls: []
@@ -14698,12 +14752,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 +14780,9 @@ async function dispatchCowtailActionTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
   return !dispatchFailed;
@@ -14754,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"
+        });
+      }
     }
   });
 }
@@ -14774,10 +14908,20 @@ 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,
@@ -14789,11 +14933,11 @@ 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({
@@ -14812,8 +14956,18 @@ 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,
@@ -14825,11 +14979,11 @@ 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({
@@ -14855,10 +15009,21 @@ 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,
@@ -14870,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) {
@@ -14886,8 +15066,117 @@ 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) {
@@ -14983,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;
 }

package/dist/setup-entry.js

@@ -13874,6 +13874,20 @@ 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,
@@ -13932,6 +13946,7 @@ var openclawActionResultCommandSchema = exports_external.object({
 var openclawRealtimeClientMessageSchema = exports_external.union([
   openclawPluginMessageCommandSchema,
   openclawPluginMessageUpdateCommandSchema,
+  openclawMessageStreamSnapshotCommandSchema,
   openclawIosNewThreadCommandSchema,
   openclawIosReplyCommandSchema,
   openclawIosActionCommandSchema,
@@ -13954,6 +13969,7 @@ var openclawRealtimeErrorSchema = exports_external.object({
 });
 var openclawRealtimeServerMessageSchema = exports_external.union([
   openclawEventEnvelopeSchema,
+  openclawMessageStreamSnapshotServerMessageSchema,
   openclawRealtimeAckSchema,
   openclawRealtimeErrorSchema
 ]);
@@ -14212,6 +14228,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 +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);
   }
@@ -14387,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) {
@@ -14491,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) {
@@ -14626,7 +14666,10 @@ async function dispatchCowtailTextTurn(params) {
   });
   const streamState = {
     idempotencyKey: `cowtail:reply:${message.id}`,
+    streamId: `cowtail:stream:${message.id}`,
     updateIndex: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
     text: "",
     links: [],
     toolCalls: []
@@ -14636,12 +14679,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 +14706,9 @@ async function dispatchCowtailTextTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
 }
@@ -14688,7 +14739,10 @@ async function dispatchCowtailActionTurn(params) {
   let dispatchFailed = false;
   const streamState = {
     idempotencyKey: `cowtail:action:${action.id}`,
+    streamId: `cowtail:action-stream:${action.id}`,
     updateIndex: 0,
+    toolFallbackIndex: 0,
+    toolFallbackIds: {},
     text: "",
     links: [],
     toolCalls: []
@@ -14698,12 +14752,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 +14780,9 @@ async function dispatchCowtailActionTurn(params) {
   });
   await finalizeCowtailStreamedReply({
     client,
+    logger,
+    route,
+    thread,
     streamState
   });
   return !dispatchFailed;
@@ -14754,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"
+        });
+      }
     }
   });
 }
@@ -14774,10 +14908,20 @@ 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,
@@ -14789,11 +14933,11 @@ 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({
@@ -14812,8 +14956,18 @@ 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,
@@ -14825,11 +14979,11 @@ 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({
@@ -14855,10 +15009,21 @@ 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,
@@ -14870,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) {
@@ -14886,8 +15066,117 @@ 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) {
@@ -14983,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;
 }

package/package.json

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