@a2hmarket/a2hmarket 0.2.0 → 0.2.1

package/index.ts

@@ -26,7 +26,7 @@ import { startAgentService } from "./src/agent-service.js";
 import { initReplyBridge } from "./src/reply-bridge.js";
 
 // Tool registrations
-import { registerStatusTool } from "./src/tools/status.js";
+import { registerStatusTool, registerInboxHistoryTool } from "./src/tools/status.js";
 import { registerProfileTools } from "./src/tools/profile.js";
 import { registerFileTools } from "./src/tools/file.js";
 import { registerWorksTools } from "./src/tools/works.js";
@@ -61,6 +61,7 @@ export default {
       registerWorksTools(api, apiClient);
       registerOrderTools(api, apiClient);
       registerSendTool(api, creds);
+      registerInboxHistoryTool(api, apiClient);
     }
 
     // ── Track last channel when a2h_* tools are used ─────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2hmarket/a2hmarket",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "A2H Market OpenClaw plugin — AI agent marketplace with A2A messaging via MQTT.",
   "license": "MIT-0",

package/src/mqtt-listener.ts

@@ -24,6 +24,11 @@ export class MqttListener {
   private handler: MessageHandler | null = null;
   private log: { info: (m: string) => void; error: (m: string) => void; warn: (m: string) => void };
 
+  /** Rapid-reconnect detection: timestamps of recent reconnects within the sliding window. */
+  private reconnectTimestamps: number[] = [];
+  private static readonly RECONNECT_WINDOW_MS = 60_000; // 60 seconds
+  private static readonly RECONNECT_THRESHOLD = 5;
+
   constructor(
     creds: A2HCredentials,
     log?: { info: (m: string) => void; error: (m: string) => void; warn: (m: string) => void },
@@ -57,8 +62,21 @@ export class MqttListener {
     });
 
     this.transport.onReconnect(() => {
-      // Reconnects are expected when another client uses the same clientId (e.g. mobile app).
-      // Log at warn level but don't flood — this is a known RocketMQ P2P clientId constraint.
+      const now = Date.now();
+      // Prune timestamps outside the sliding window
+      this.reconnectTimestamps = this.reconnectTimestamps.filter(
+        (ts) => now - ts < MqttListener.RECONNECT_WINDOW_MS,
+      );
+      this.reconnectTimestamps.push(now);
+
+      if (this.reconnectTimestamps.length >= MqttListener.RECONNECT_THRESHOLD) {
+        this.log.warn(
+          `clientId conflict detected: ${this.reconnectTimestamps.length} reconnects in the last 60s. ` +
+            `Another client (mobile app, second instance) is likely using the same clientId ` +
+            `"${buildClientId(this.creds.agentId)}". RocketMQ will keep kicking both clients. ` +
+            `Stop the other client or run on a different agentId.`,
+        );
+      }
     });
 
     try {

package/src/tools/send.ts

@@ -8,19 +8,34 @@ export function registerSendTool(api: OpenClawPluginApi, creds: A2HCredentials)
   api.registerTool({
     name: "a2h_send",
     description:
-      "Send an A2A message to another agent. Supports text, attachment URL, payment QR code, and structured payload.",
+      "Send an A2A message to another agent. Supports text, payment QR code (payload.payment_qr), " +
+      "external attachment (payload.attachment with url/source/name/mime_type), and arbitrary extra payload fields. " +
+      "payment_qr and attachment can coexist in the same message.",
     parameters: {
       type: "object",
       properties: {
         target_agent_id: { type: "string", description: "Target agent ID" },
-        text: { type: "string", description: "Message text" },
-        payment_qr: { type: "string", description: "Payment QR code image URL" },
-        attachment_url: { type: "string", description: "External attachment URL" },
-        attachment_name: { type: "string", description: "Filename hint for attachment" },
+        text: { type: "string", description: "Message text (sets payload.text)" },
+        payment_qr: {
+          type: "string",
+          description: "Payment QR code image URL (must start with http:// or https://). Sets payload.payment_qr",
+        },
+        attachment_url: {
+          type: "string",
+          description: "External attachment URL (must start with http:// or https://). Creates payload.attachment object",
+        },
+        attachment_name: {
+          type: "string",
+          description: "Filename hint for attachment (used as payload.attachment.name)",
+        },
+        attachment_mime: {
+          type: "string",
+          description: "MIME type hint for attachment (e.g. image/png, application/pdf). Sets payload.attachment.mime_type",
+        },
         message_type: { type: "string", description: "Message type (default: chat.request)" },
         extra_payload: {
           type: "object",
-          description: "Additional payload fields (e.g. orderId)",
+          description: "Additional payload fields merged into the envelope payload (e.g. orderId)",
         },
       },
       required: ["target_agent_id"],
@@ -42,6 +57,7 @@ export function registerSendTool(api: OpenClawPluginApi, creds: A2HCredentials)
           source: "external",
         };
         if (params.attachment_name) att.name = params.attachment_name;
+        if (params.attachment_mime) att.mime_type = params.attachment_mime;
         payload.attachment = att;
       }
 

package/src/tools/status.ts

@@ -24,3 +24,60 @@ export function registerStatusTool(api: OpenClawPluginApi, client: A2HApiClient)
     },
   });
 }
+
+interface InboxMessage {
+  id?: string;
+  messageId?: string;
+  senderId?: string;
+  content?: string;
+  createdAt?: string;
+  createTime?: string;
+}
+
+export function registerInboxHistoryTool(api: OpenClawPluginApi, client: A2HApiClient) {
+  api.registerTool({
+    name: "a2h_inbox_history",
+    description:
+      "Retrieve message history with a specific agent. Returns messages in reverse chronological order.",
+    parameters: {
+      type: "object",
+      properties: {
+        peer_id: { type: "string", description: "The other agent's ID" },
+        page: { type: "number", description: "Page number (default 1)" },
+        limit: { type: "number", description: "Messages per page (default 20, max 100)" },
+      },
+      required: ["peer_id"],
+    },
+    execute: async (params: Record<string, unknown>) => {
+      const peerId = params.peer_id as string;
+      const page = (params.page as number) || 1;
+      const limit = Math.min((params.limit as number) || 20, 100);
+
+      const sessionId = [client.agentId, peerId].sort().join("_");
+      const qs = `?sessionId=${sessionId}&page=${page}&limit=${limit}`;
+      const apiPath = `/agent-message/api/v1/agents/sessions/messages${qs}`;
+      const signPath = "/agent-message/api/v1/agents/sessions/messages";
+
+      const data = await client.getJSON<{ records?: InboxMessage[] }>(apiPath, signPath);
+      const records = (data as unknown as { records?: InboxMessage[] })?.records ?? [];
+
+      const messages = records.map((msg) => {
+        let text = "";
+        try {
+          const envelope = JSON.parse(msg.content ?? "{}");
+          text = envelope?.payload?.text ?? "";
+        } catch {
+          text = msg.content ?? "";
+        }
+        return {
+          message_id: msg.messageId ?? msg.id ?? "",
+          direction: msg.senderId === client.agentId ? "sent" : "recv",
+          timestamp: msg.createdAt ?? msg.createTime ?? "",
+          text,
+        };
+      });
+
+      return { result: JSON.stringify({ session_id: sessionId, page, limit, messages }, null, 2) };
+    },
+  });
+}