a2a-xmtp 1.4.0 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a2a-xmtp",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "type": "module",
   "main": "src/index.ts",
   "description": "Decentralized Agent-to-Agent E2EE messaging for OpenClaw via XMTP",

package/src/coordination/group-scheduler.ts

@@ -39,6 +39,7 @@ export class GroupScheduler {
 
   /**
    * 初始化或获取群组状态。成员变化时自动重算。
+   * @param members 参与轮询的成员地址（调用方已按角色过滤，仅含 agent）
    */
   getOrInitGroup(groupId: string, members: string[]): GroupConversationState {
     const existing = this.groups.get(groupId);

package/src/coordination/message-orchestrator.ts

@@ -122,15 +122,16 @@ export class MessageOrchestrator {
         const replyText = this.extractReplyText(messages);
         if (!replyText) return;
 
-        // 记录本 agent 的 turn
-        this.policyEngine.recordTurn(payload.conversation.id);
-
+        // recordTurn 由 bridge.sendMessage 内部调用，此处不重复
         await bridge.sendMessage(payload.from.xmtpAddress, replyText, {
           conversationId: payload.conversation.id,
         });
 
-        // 群聊：清除 claim 状态（回复已发送）
+        // 群聊：计入自己的消息 + 清除 claim
         if (payload.conversation.isGroup) {
+          // 自己发的消息 handleIncoming 不会收到（跳过 self），
+          // 手动递增以保持与其他 agent 的 messageCount 同步
+          this.groupScheduler.recordMessage(payload.conversation.id);
           this.groupScheduler.clearClaim(payload.conversation.id);
         }
 
@@ -152,11 +153,17 @@ export class MessageOrchestrator {
     payload: A2AInjectPayload,
   ): Promise<boolean> {
     const convId = payload.conversation.id;
-    const members = payload.conversation.participants;
     const myAddress = bridge.address;
 
+    // 用 XMTP 原生角色信息筛选：只有普通 Member (permissionLevel=0) 参与轮询
+    // Admin/SuperAdmin 通常是人类，不参与 round-robin
+    const details = payload.conversation.participantDetails;
+    const agentMembers = details
+      ? details.filter((p) => p.permissionLevel === 0).map((p) => p.address)
+      : payload.conversation.participants; // fallback：无角色信息时用全部成员
+
     // 初始化群组状态
-    this.groupScheduler.getOrInitGroup(convId, members);
+    this.groupScheduler.getOrInitGroup(convId, agentMembers);
 
     // 检查 turn budget 是否耗尽
     if (this.policyEngine.isTurnExhausted(convId)) {

package/src/coordination/policy-engine.ts

@@ -28,10 +28,11 @@ export class PolicyEngine {
     this.localAgentIds.add(agentId);
   }
 
-  checkOutgoing(params: PolicyCheckParams): PolicyCheckResult {
-    return this.check(params);
-  }
-
+  /**
+   * 入站检查：consent + TTL（不检查 turn budget 和 cool-down）
+   * turn budget 仅在出站/调度层检查，确保 turn 耗尽后仍能接收消息、
+   * 缓存到 inbox、维持 messageCount 同步。
+   */
   checkIncoming(params: PolicyCheckParams): PolicyCheckResult {
     const consent = this.getConsent(params.from);
     if (consent === "deny") {
@@ -43,10 +44,19 @@ export class PolicyEngine {
         reason: `Sender ${params.from} not explicitly allowed (consent: ${consent})`,
       };
     }
-    return this.check(params);
+    const state = this.getOrCreateState(params.conversationId);
+    const now = Date.now();
+    const ttlMs = this.policy.ttlMinutes * 60 * 1000;
+    if (now - state.createdAt > ttlMs) {
+      return { allowed: false, reason: `Conversation TTL expired (${this.policy.ttlMinutes} min)` };
+    }
+    return { allowed: true };
   }
 
-  private check(params: PolicyCheckParams): PolicyCheckResult {
+  /**
+   * 出站检查：TTL + turn budget + cool-down
+   */
+  checkOutgoing(params: PolicyCheckParams): PolicyCheckResult {
     const state = this.getOrCreateState(params.conversationId);
     const now = Date.now();
 

package/src/transport/xmtp-bridge.ts

@@ -7,7 +7,7 @@ import { Agent, createUser, createSigner } from "@xmtp/agent-sdk";
 import type { IdentityRegistry } from "./identity-registry.js";
 import { PolicyEngine } from "../coordination/policy-engine.js";
 import type { XmtpWalletConfig, InboxMessage, A2AContentType, A2AInjectPayload, GroupInfo } from "../types.js";
-import { createA2APayload, CLAIM_PREFIX } from "../types.js";
+import { createA2APayload, CLAIM_PREFIX, type GroupParticipant } from "../types.js";
 import { GroupScheduler } from "../coordination/group-scheduler.js";
 
 /** IdentifierKind.Ethereum = 0 (const enum, 不能在 isolatedModules 下直接访问) */
@@ -258,8 +258,9 @@ export class XmtpBridge {
     const convState = this.policyEngine.getConversationState(ctx.conversation.id);
     const turn = convState?.turn ?? 0;
 
-    // 群聊时获取参与者列表
+    // 群聊时获取参与者列表（含角色信息）
     let participants: string[] = [];
+    let participantDetails: GroupParticipant[] | undefined;
     const isGroup = ctx.conversation.isGroup ?? false;
     if (isGroup) {
       try {
@@ -267,6 +268,10 @@ export class XmtpBridge {
         participants = members.map((m: any) =>
           m.accountAddresses?.[0]?.toLowerCase() ?? m.inboxId,
         );
+        participantDetails = members.map((m: any) => ({
+          address: (m.accountAddresses?.[0]?.toLowerCase() ?? m.inboxId) as string,
+          permissionLevel: (m.permissionLevel ?? 0) as number,
+        }));
       } catch { /* 获取成员失败时保持空数组 */ }
     }
 
@@ -276,6 +281,7 @@ export class XmtpBridge {
       conversationId: ctx.conversation.id,
       isGroup,
       participants,
+      participantDetails,
       messageId: ctx.message.id ?? crypto.randomUUID(),
       content,
       contentType,

package/src/types.ts

@@ -12,6 +12,13 @@ export interface XmtpWalletConfig {
 
 export type XmtpEnv = "dev" | "production";
 
+/** 群成员信息（含角色） */
+export interface GroupParticipant {
+  address: string;
+  /** XMTP PermissionLevel: 0=Member, 1=Admin, 2=SuperAdmin */
+  permissionLevel: number;
+}
+
 /** 注入 Agent session 的消息格式 */
 export interface A2AInjectPayload {
   type: "a2a-xmtp";
@@ -24,6 +31,8 @@ export interface A2AInjectPayload {
     id: string;
     isGroup: boolean;
     participants: string[];
+    /** 群成员详细信息（含角色），仅群聊时有值 */
+    participantDetails?: GroupParticipant[];
   };
   message: {
     id: string;
@@ -86,8 +95,8 @@ export interface GroupConversationState {
   lastClaim: { sender: string; timestamp: number; messageId: string } | null;
 }
 
-/** Claim 消息前缀（零宽空格 + [processing]:） */
-export const CLAIM_PREFIX = "\u200B[processing]:";
+/** Claim 消息前缀（可见标记，避免 XMTP 传输时被 strip） */
+export const CLAIM_PREFIX = "__CLAIM__:";
 
 /** 默认群聊调度配置 */
 export const DEFAULT_GROUP_SCHEDULING: GroupSchedulingConfig = {
@@ -150,6 +159,7 @@ export function createA2APayload(params: {
   conversationId: string;
   isGroup: boolean;
   participants: string[];
+  participantDetails?: GroupParticipant[];
   messageId: string;
   content: string;
   contentType: A2AContentType;
@@ -168,6 +178,7 @@ export function createA2APayload(params: {
       id: params.conversationId,
       isGroup: params.isGroup,
       participants: params.participants,
+      participantDetails: params.participantDetails,
     },
     message: {
       id: params.messageId,