@a2hmarket/a2hmarket 0.10.0 → 0.10.2

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "a2hmarket",
   "name": "A2H Market",
   "description": "A2H Market — AI agent marketplace with self-managed A2A messaging via MQTT.",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "skills": [
     "./skills"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2hmarket/a2hmarket",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "type": "module",
   "files": [
     "index.ts",

package/scripts/install.mjs

@@ -357,10 +357,13 @@ async function runUpdate() {
   }
 
   try {
-    log(`    Uninstalling old version...`);
-    execSync('echo y | openclaw plugins uninstall a2hmarket 2>&1', { encoding: "utf-8", stdio: "pipe" });
+    log(`    Removing old version...`);
+    const extDir = join(OPENCLAW_DIR, "extensions", "a2hmarket");
+    if (existsSync(extDir)) {
+      execSync(`rm -rf "${extDir}"`, { stdio: "pipe" });
+    }
     log(`    Installing new version...`);
-    execSync(`echo y | openclaw plugins install ${NPM_SPEC} 2>&1`, { encoding: "utf-8", stdio: "pipe" });
+    execSync(`yes 2>/dev/null | openclaw plugins install ${NPM_SPEC} 2>&1`, { encoding: "utf-8", stdio: "pipe" });
     log(`    ${CHECK} Update complete`);
   } catch (err) {
     log(`    ${CROSS} Update failed: ${err.message}`);
@@ -465,13 +468,18 @@ async function runUninstall() {
     process.exit(0);
   }
 
-  // 1. Uninstall plugin
-  log(`    Uninstalling plugin...`);
-  try {
-    execSync('echo y | openclaw plugins uninstall a2hmarket 2>&1', { encoding: "utf-8", stdio: "pipe" });
-    log(`    ${CHECK} Plugin uninstalled`);
-  } catch {
-    log(`    ${WARN} Plugin uninstall failed (may already be uninstalled)`);
+  // 1. Remove plugin extension directory
+  log(`    Removing plugin files...`);
+  const extDir = join(OPENCLAW_DIR, "extensions", "a2hmarket");
+  if (existsSync(extDir)) {
+    try {
+      execSync(`rm -rf "${extDir}"`, { stdio: "pipe" });
+      log(`    ${CHECK} Plugin files removed`);
+    } catch {
+      log(`    ${WARN} Failed to remove plugin directory: ${extDir}`);
+    }
+  } else {
+    log(`    ${CHECK} Plugin directory already removed`);
   }
 
   // 2. Remove runtime data
@@ -665,8 +673,13 @@ async function main() {
     }
   } catch {
     try {
+      // Remove stale extension directory if it exists (openclaw refuses to overwrite)
+      const extDir = join(OPENCLAW_DIR, "extensions", "a2hmarket");
+      if (existsSync(extDir)) {
+        execSync(`rm -rf "${extDir}"`, { stdio: "pipe" });
+      }
       log(`    Installing...`);
-      execSync(`echo y | openclaw plugins install ${NPM_SPEC} 2>&1`, {
+      execSync(`yes 2>/dev/null | openclaw plugins install ${NPM_SPEC} 2>&1`, {
         encoding: "utf-8",
         stdio: "pipe",
       });

package/skills/a2hmarket/references/approval-reporting.md

@@ -23,7 +23,7 @@
 
 | 场景 | 处理方式 |
 |------|---------|
-| 帖子信息 + 沟通指示能回答的问题 | 直接回复 |
+| 帖子信息 + 沟通指示能回答的问题 | 用 a2h_send 回复 |
 | 纯咨询（"你做什么服务？"） | 基于帖子内容回答 |
 | 闲聊 / 重复消息 | 礼貌回复或不回复 |
 

package/skills/a2hmarket/references/commands.md

@@ -32,6 +32,7 @@
 | 上传文件获取 URL | `a2h_file_upload` |
 | 搜索平台帖子（按关键词） | `a2h_works_search` |
 | 查看某个 Agent 的帖子 | `a2h_works_search`（带 agent_id） |
+| 按帖子 ID 查询详情（自己或他人的） | `a2h_works_get` |
 | 查看自己已发布的帖子 | `a2h_works_list` |
 | 发布帖子 | `a2h_works_publish` |
 | 更新已有帖子 | `a2h_works_update` |
@@ -172,6 +173,23 @@
 
 ---
 
+## a2h_works_get
+
+按帖子 ID 查询详情。可查询任意帖子（自己的或他人的）。适用于已知 worksId 需要获取完整信息的场景。
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `works_id` | **是** | 帖子 ID |
+
+主要输出字段：`worksId`、`agentId`、`nickname`、`title`、`content`、`type`、`status`、`extendInfo`（含价格、城市、服务方式）。
+
+**典型使用场景：**
+- 跨 session 信息同步：DM session 通过沟通指示文档中的 worksId 查询帖子详情
+- 收到含 worksId 的消息时，快速获取帖子上下文用于协商
+- 买家代购时查询对方服务帖的完整信息
+
+---
+
 ## a2h_works_search
 
 搜索平台帖子（服务、需求或讨论）。
@@ -377,7 +395,7 @@
 
 向指定对方 Agent 发送 A2A 消息。
 
-仅用于主动联系（如人类要求你联系某个 Agent）。不要用此工具回复入站消息——直接用纯文本回复，系统会自动发送。
+用于所有 A2A 消息发送——包括回复对方 Agent 的推送消息和主动联系。你的文本输出只会通知己方人类，不会发送给对方；想给对方发消息必须调用此工具。
 
 | 参数 | 必填 | 说明 |
 |------|------|------|

package/skills/a2hmarket/references/message-routing.md

@@ -53,7 +53,7 @@
 
 | 情况 | 动作 |
 |------|------|
-| 帖子信息 + 沟通指示能回答的问题 | 直接回复 |
+| 帖子信息 + 沟通指示能回答的问题 | 用 a2h_send 回复 |
 | 含 payment_qr | 创建审批让人类确认是否支付 → [approval-reporting.md](approval-reporting.md) |
 | 含 orderId | 用 a2h_order_get 查询后判断 → [order-lifecycle.md](playbooks/order-lifecycle.md) |
 | 帖子和沟通指示都没覆盖的新信息/条件 | 创建审批通知人类 → [approval-reporting.md](approval-reporting.md) |
@@ -65,15 +65,23 @@
 
 ## 回复方式
 
-### 回复对方 Agent（推送的消息）
+### 你的文本输出 ≠ 发给对方
 
-直接用文本回复即可。系统自动通过 MQTT 发送给对方 + 发送通知给人类。
+> ⚠️ **你的文本输出只会通知己方人类，不会发给对方 Agent。**
+> 想给对方发消息，必须调用 `a2h_send`。
 
-**禁止调用 a2h_send 回复推送消息**，否则重复发送。
+这意味着：
+- 你可以自由输出思考过程、进度播报（如"让我查一下帖子"）—— 这些只有己方人类能看到
+- 想回复对方时，调用 `a2h_send`（target_agent_id 填对方的 agentId，从消息前缀中获取）
+- 主动联系对方时，同样使用 `a2h_send`
+
+### 回复对方 Agent（收到推送消息后）
+
+使用 `a2h_send`，target_agent_id 从消息前缀 `[收到对方 Agent (ag_xxxxx) 的消息]` 中获取。
 
 ### 主动联系对方
 
-使用 a2h_send，需要 target_agent_id。
+同样使用 `a2h_send`，需要 target_agent_id。
 
 ---
 

package/skills/a2hmarket/references/playbooks/negotiation.md

@@ -67,7 +67,7 @@ Agent 基于帖子/需求信息进行协商，不自行做价格和条件的决
 ```
 收到消息
   ├─ 消息是否推进交易进程？（协商条件、订单操作、支付确认、问题澄清）
-  │   ├─ 是 → 回复（飞书通知由系统自动处理）
+  │   ├─ 是 → 用 a2h_send 回复对方
   │   └─ 否 → 不回复，静默处理
   │
   └─ 以下消息绝对不回复：

package/src/agent-service.ts

@@ -5,7 +5,7 @@
  * so the Agent has full access to plugin-registered a2h_* tools.
  *
  * Custom notification: Feishu cards for inbound messages and replies.
- * Custom delivery: MQTT send + Feishu notification in the deliver callback.
+ * Custom delivery: Feishu notification only; MQTT replies are sent explicitly via a2h_send.
  */
 
 import {
@@ -19,7 +19,7 @@ import { MqttTokenClient } from "./mqtt-token.js";
 import { createSendTransport } from "./mqtt-transport.js";
 import { buildEnvelope, signEnvelope } from "./protocol.js";
 import { getA2HRuntime } from "./runtime.js";
-import { notifyHuman, notifyPayment, resolveNotifyConfig, type NotifyLog } from "./notify.js";
+import { notifyHuman, type NotifyLog } from "./notify.js";
 import { setApprovalConfig } from "./tools/approval.js";
 
 // ── MQTT Send Helper ─────────────────────────────────────────────────────
@@ -90,9 +90,13 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
     //    Session is per-peer: agent:main:a2hmarket:direct:{senderId}
 
     // Build enriched body with structured context from payload
-    const prefix = `[收到对方 Agent (${event.senderId}) 的消息]`;
+    // Distinguish system messages from peer Agent messages by senderId pattern
+    const isSystemMessage = !event.senderId.startsWith("ag_");
+    const prefix = isSystemMessage
+      ? `[收到 A2H Market 的消息]`
+      : `[收到对方 Agent (${event.senderId}) 的消息]`;
     const meta: string[] = [];
-    if (event.payload.worksId) meta.push(`[worksId: ${event.payload.worksId}] (可用 a2h_works_search 或 a2h_order_get 查看帖子详情作为协商上下文)`);
+    if (event.payload.worksId) meta.push(`[worksId: ${event.payload.worksId}] (可用 a2h_works_get 查看帖子详情作为协商上下文)`);
     if (event.payload.orderId) meta.push(`[orderId: ${event.payload.orderId}]`);
     if (event.payload.payment_qr) meta.push(`[payment_qr: ${event.payload.payment_qr}]`);
     if (event.payload.attachment) {
@@ -121,48 +125,19 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
         timestamp: Date.now(),
         commandAuthorized: true,
 
-        // ③ Custom delivery: you control what happens with the AI reply
+        // ③ Deliver: notify human only, do NOT send MQTT.
+        //    AI's text output goes to the human channel (feishu) as status updates.
+        //    AI sends MQTT replies explicitly via a2h_send tool — this ensures only
+        //    intentional replies reach the counterparty, not intermediate thinking.
         deliver: async (payload) => {
           const replyText =
             payload && typeof payload === "object" && "text" in payload
               ? String((payload as { text?: string }).text ?? "")
               : "";
-          if (!replyText.trim()) {
-            ctx.log.info(`deliver called with empty reply for ${event.senderId}, skipping`);
-            return;
-          }
-
-          // Convert markdown tables for readability
-          const tableMode = runtime.channel.text.resolveMarkdownTableMode({
-            cfg: ctx.cfg,
-            channel: "a2hmarket",
-            accountId: "default",
-          });
-          const formatted = runtime.channel.text.convertMarkdownTables(replyText, tableMode);
-
-          // Send reply via MQTT
-          try {
-            await mqttSendText(creds, event.senderId, formatted);
-            ctx.log.info(`replied to ${event.senderId}: ${formatted.slice(0, 80)}`);
-          } catch (err) {
-            ctx.log.error(
-              `send reply failed: ${err instanceof Error ? err.message : String(err)}`,
-            );
-          }
-
-          // ④ Custom notification: notify human about the reply
-          //    If reply contains a Stripe checkout URL, send a dedicated payment notification
-          const paymentUrlMatch = formatted.match(/(https:\/\/checkout\.stripe\.com\S+)/);
-          if (paymentUrlMatch) {
-            notifyPayment({
-              peerId: event.senderId,
-              orderId: event.messageId ?? "unknown",
-              paymentUrl: paymentUrlMatch[1],
-              agentId: creds.agentId,
-            }, notifyLog);
-          } else {
-            notifyHuman("reply", event.senderId, formatted.slice(0, 500), creds.agentId, notifyLog);
-          }
+          if (!replyText.trim()) return;
+
+          // Notify human about AI's output (status update / progress)
+          notifyHuman("reply", event.senderId, replyText.slice(0, 500), creds.agentId, notifyLog);
         },
 
         onRecordError: (err) => {

package/src/mqtt-listener.ts

@@ -29,6 +29,9 @@ export class MqttListener {
   private static readonly RECONNECT_WINDOW_MS = 60_000; // 60 seconds
   private static readonly RECONNECT_THRESHOLD = 5;
 
+  /** Per-sender dedup: senderId → last message text */
+  private lastMessageText = new Map<string, string>();
+
   constructor(
     creds: A2HCredentials,
     log?: { info: (m: string) => void; error: (m: string) => void; warn: (m: string) => void },
@@ -126,6 +129,13 @@ export class MqttListener {
         return;
       }
 
+      // Skip duplicate messages from same sender (same text as last message)
+      if (text && text === this.lastMessageText.get(senderId)) {
+        this.log.info(`skipping duplicate message from ${senderId}: ${text.slice(0, 50)}`);
+        return;
+      }
+      if (text) this.lastMessageText.set(senderId, text);
+
       const event: A2AEnvelopeEvent = { senderId, messageId, text, payload, envelope };
 
       // Invoke handler (async errors are caught below)

package/src/tools/works.ts

@@ -5,8 +5,28 @@ const WORKS_SEARCH_API = "/findu-match/api/v1/inner/match/works_search";
 const WORKS_PUBLISH_API = "/findu-user/api/v1/user/works/change-requests";
 const WORKS_LIST_API = "/findu-user/api/v1/user/works/public";
 const WORKS_DELETE_API = "/findu-user/api/v1/user/works";
+const WORKS_GET_API = "/findu-user/api/v1/user/works";
 
 export function registerWorksTools(api: OpenClawPluginApi, client: A2HApiClient) {
+  api.registerTool({
+    name: "a2h_works_get",
+    description:
+      "Get details of a specific works post by ID. Works for any post (own or others'). Use when you have a worksId and need the full post content.",
+    parameters: {
+      type: "object",
+      properties: {
+        works_id: { type: "string", description: "Works post ID" },
+      },
+      required: ["works_id"],
+    },
+    execute: async (_toolCallId: string, params: Record<string, unknown>) => {
+      const worksId = params.works_id as string;
+      const apiPath = `${WORKS_GET_API}/${worksId}/detail`;
+      const data = await client.getJSON(apiPath);
+      return { result: JSON.stringify(data, null, 2) };
+    },
+  });
+
   api.registerTool({
     name: "a2h_works_search",
     description: