a2a-xmtp 1.4.5 → 1.4.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a2a-xmtp",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "type": "module",
   "main": "src/index.ts",
   "description": "Decentralized Agent-to-Agent E2EE messaging for OpenClaw via XMTP",
@@ -25,6 +25,9 @@
     "@xmtp/agent-sdk": "^2.3.0",
     "@sinclair/typebox": "^0.34.0"
   },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
   "devDependencies": {
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",

package/src/transport/xmtp-bridge.ts

@@ -22,6 +22,14 @@ export class XmtpBridge {
   private inboxBuffer: InboxMessage[] = [];
   private readonly maxInboxBuffer = 100;
 
+  /** 已处理消息 ID 去重集合（防止 SDK 双投或 sync 重放） */
+  private processedMsgIds = new Set<string>();
+  private readonly maxProcessedIds = 200;
+
+  /** 出站去重：conversationId+contentHash → 发送结果（10s TTL） */
+  private recentSends = new Map<string, { conversationId: string; messageId: string }>();
+  private readonly sendDedupWindowMs = 3_000;
+
   /** 消息回调（由 plugin 入口设置，用于触发 subagent 处理） */
   onMessage?: (agentId: string, payload: A2AInjectPayload) => void;
 
@@ -97,13 +105,22 @@ export class XmtpBridge {
       conversation = await (this.agent as any).createDmWithAddress(toAddress);
     }
 
+    // 出站去重：同一会话 + 相同内容在 10s 内只发一次
+    const dedupKey = `${conversation.id}:${simpleHash(content)}`;
+    const cached = this.recentSends.get(dedupKey);
+    if (cached) return cached;
+
     const messageId = opts?.contentType === "markdown"
       ? await conversation.sendMarkdown(content)
       : await conversation.sendText(content);
 
     this.policyEngine.recordTurn(conversation.id);
 
-    return { conversationId: conversation.id, messageId: String(messageId) };
+    const result = { conversationId: conversation.id, messageId: String(messageId) };
+    this.recentSends.set(dedupKey, result);
+    setTimeout(() => this.recentSends.delete(dedupKey), this.sendDedupWindowMs);
+
+    return result;
   }
 
   /**
@@ -235,6 +252,19 @@ export class XmtpBridge {
   }
 
   private async handleIncoming(ctx: any, contentType: A2AContentType): Promise<void> {
+    // 消息去重：同一 XMTP 消息 ID 只处理一次
+    // 防止 SDK 双投（text+markdown 同时触发）或 conversations.sync() 重放
+    const rawMsgId: string | undefined = ctx.message.id;
+    if (rawMsgId) {
+      if (this.processedMsgIds.has(rawMsgId)) return;
+      this.processedMsgIds.add(rawMsgId);
+      if (this.processedMsgIds.size > this.maxProcessedIds) {
+        // 淘汰最旧的条目
+        const first = this.processedMsgIds.values().next().value!;
+        this.processedMsgIds.delete(first);
+      }
+    }
+
     const senderAddress: string = await ctx.getSenderAddress();
     const isSelf = senderAddress.toLowerCase() === this.address.toLowerCase();
     const content = String(ctx.message.content);
@@ -328,3 +358,13 @@ export class XmtpBridge {
     return this.walletConfig.env;
   }
 }
+
+/** FNV-1a 32-bit hash — fast, no crypto dependency */
+function simpleHash(str: string): string {
+  let h = 0x811c9dc5;
+  for (let i = 0; i < str.length; i++) {
+    h ^= str.charCodeAt(i);
+    h = Math.imul(h, 0x01000193);
+  }
+  return (h >>> 0).toString(16);
+}