@wzfukui/ani 2026.3.28 → 2026.3.281

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wzfukui/ani",
-  "version": "2026.3.28",
+  "version": "2026.3.281",
   "type": "module",
   "description": "ANI Agent-Native IM channel plugin",
   "license": "MIT",

package/src/monitor/handler.ts

@@ -11,10 +11,12 @@ import {
   sendAniMessage,
   sendAniProgress,
   fetchConversation,
+  fetchAniMessage,
   fetchConversationMemories,
   toggleAniReaction,
   type AniArtifact,
   type AniConversation,
+  type AniMessage,
   type AniMemory,
 } from "./send.js";
 import { createInboundDebouncer } from "./debounce.js";
@@ -27,6 +29,7 @@ export type AniWsMessage = {
     conversation_id?: number;
     sender_id?: number;
     sender_type?: string;
+    reply_to?: number;
     layers?: {
       summary?: string;
       detail?: string;
@@ -164,6 +167,33 @@ export function isTextFile(mimeType?: string, filename?: string): boolean {
   return false;
 }
 
+export function messageTextOf(message: Pick<AniMessage, "layers"> | null | undefined): string {
+  const dataBody = typeof message?.layers?.data === "object" && message.layers?.data !== null
+    ? (message.layers.data as Record<string, unknown>).body
+    : undefined;
+  return (typeof dataBody === "string" ? dataBody : null) ??
+    message?.layers?.summary ??
+    message?.layers?.detail ??
+    "";
+}
+
+export function formatReplyContext(message: AniMessage | null | undefined): string {
+  if (!message?.id) return "";
+  const senderName = message.sender?.display_name ?? `entity-${message.sender_id ?? "unknown"}`;
+  const sentAt = message.created_at ? ` at ${message.created_at}` : "";
+  const text = messageTextOf(message).trim();
+  const attachments = message.attachments ?? [];
+  const attachmentText = attachments.length > 0
+    ? ` Attachments: ${attachments.map((attachment) => attachment.filename || attachment.type || "file").join(", ")}.`
+    : "";
+  const excerpt = text ? ` ${text}` : "";
+  return [
+    "Reply context:",
+    `This message replies to ANI message #${message.id} from ${senderName}${sentAt}.`,
+    `${excerpt}${attachmentText}`.trim(),
+  ].filter(Boolean).join("\n");
+}
+
 function formatFileSize(bytes?: number): string {
   if (bytes == null) return 'unknown size';
   if (bytes < 1024) return `${bytes} B`;
@@ -674,7 +704,16 @@ export function createAniMessageHandler(params: AniHandlerParams) {
         sessionKey: route.sessionKey,
       });
 
-      const rawBody = attachmentText ? `${text}\n\n${attachmentText}` : text;
+      let replyContext = "";
+      if (msg.reply_to) {
+        const parentMessage = await fetchAniMessage({ serverUrl, apiKey, messageId: msg.reply_to });
+        replyContext = parentMessage
+          ? formatReplyContext(parentMessage)
+          : `Reply context:\nThis message replies to ANI message #${msg.reply_to}, but the original message could not be fetched. Use ani_fetch_chat_history_messages if that missing context matters.`;
+      }
+
+      const rawBodyParts = [replyContext, text, attachmentText].filter((part) => part && part.trim());
+      const rawBody = rawBodyParts.join("\n\n");
       logVerbose(`ani: rawBody for envelope (${rawBody.length} chars): ${rawBody.slice(0, 500)}`);
 
       const body = core.channel.reply.formatAgentEnvelope({
@@ -989,7 +1028,7 @@ export function createAniMessageHandler(params: AniHandlerParams) {
       const dataBody = typeof msg.layers?.data === "object" && msg.layers?.data !== null
         ? (msg.layers.data as Record<string, unknown>).body
         : undefined;
-      const text = (typeof dataBody === "string" ? dataBody : null) ?? msg.layers?.summary ?? msg.layers?.detail ?? "";
+      const text = messageTextOf(msg);
 
       // Process attachments:
       // 1. Download and save to disk for OpenClaw media pipeline (MediaPath/MediaType)

package/src/monitor/send.ts

@@ -119,6 +119,26 @@ export interface AniAttachment {
   content?: string;
 }
 
+export interface AniMessage {
+  id?: number;
+  conversation_id?: number;
+  sender_id?: number;
+  sender_type?: string;
+  reply_to?: number;
+  created_at?: string;
+  sender?: {
+    id?: number;
+    display_name?: string;
+    entity_type?: string;
+  };
+  layers?: {
+    summary?: string;
+    detail?: string;
+    data?: unknown;
+  };
+  attachments?: AniAttachment[];
+}
+
 /** Send a message to an ANI conversation via REST API. */
 export async function sendAniMessage(opts: {
   serverUrl: string;
@@ -211,6 +231,26 @@ export async function fetchConversation(opts: {
   }
 }
 
+/** Fetch a single message with sender details for reply-context reconstruction. */
+export async function fetchAniMessage(opts: {
+  serverUrl: string;
+  apiKey: string;
+  messageId: number;
+}): Promise<AniMessage | null> {
+  const url = `${opts.serverUrl}/api/v1/messages/${opts.messageId}`;
+  try {
+    const res = await fetchWithRetry(url, {
+      headers: { Authorization: `Bearer ${opts.apiKey}` },
+      signal: AbortSignal.timeout(30_000),
+    });
+    if (!res.ok) return null;
+    const json = (await res.json()) as { data?: AniMessage };
+    return json.data ?? null;
+  } catch {
+    return null;
+  }
+}
+
 /** Fetch conversation memories. */
 export async function fetchConversationMemories(opts: {
   serverUrl: string;

package/src/tools.ts

@@ -261,14 +261,16 @@ export function createGetHistoryTool(): ChannelAgentTool {
 
         // Format messages for LLM readability
         const formatted = messages.map((m: Record<string, unknown>) => {
+          const id = typeof m.id === "number" ? `#${m.id}` : "#?";
           const sender = (m.sender as Record<string, unknown>)?.display_name ?? `entity-${m.sender_id}`;
           const text = ((m.layers as Record<string, unknown>)?.summary as string) ?? "";
           const time = m.created_at as string;
+          const replyTo = typeof m.reply_to === "number" ? ` ↪ reply_to #${m.reply_to}` : "";
           const atts = (m.attachments as Array<Record<string, unknown>>) ?? [];
           const attDesc = atts.length > 0
             ? ` [${atts.length} attachment(s): ${atts.map((a) => a.filename ?? a.type).join(", ")}]`
             : "";
-          return `[${time}] ${sender}: ${text}${attDesc}`;
+          return `[${time}] ${id}${replyTo} ${sender}: ${text}${attDesc}`;
         }).reverse(); // oldest first for readability
 
         return {