@a2hmarket/a2hmarket 0.7.1 → 0.7.2

package/index.ts

@@ -67,8 +67,9 @@ export default {
       registerSendTool(api, creds);
       registerAddressTools(api, apiClient);
       registerDiscussionTools(api, apiClient);
-      registerPaymentTools(api, apiClient);
-      registerTempoPaymentTools(api, apiClient, creds);
+      // Stripe & Tempo payment tools — internal testing, not registered yet
+      // registerPaymentTools(api, apiClient);
+      // registerTempoPaymentTools(api, apiClient, creds);
       registerInboxHistoryTool(api, apiClient);
     }
 
@@ -90,7 +91,6 @@ export default {
           "a2h_send", "a2h_inbox_history",
           "a2h_address_list", "a2h_address_create", "a2h_address_delete", "a2h_address_set_default",
           "a2h_discussion_publish", "a2h_discussion_reply", "a2h_discussion_list",
-          "a2h_tempo_pay", "a2h_tempo_balance",
         ];
         const missing = a2hTools.filter((t) => !alsoAllow.includes(t));
         if (missing.length > 0) {

package/package.json

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

package/skills/a2hmarket/references/commands.md

@@ -197,6 +197,30 @@ Key output fields: `worksId`, `changeRequestId`, `status`
 
 ---
 
+## a2h_works_update
+
+Update an existing listing. Only the fields you provide will be changed; omitted optional fields remain unchanged.
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `works_id` | **Yes** | Works ID of the listing to update |
+| `type` | **Yes** | 2 = demand listing / 3 = service listing (must match the original type) |
+| `title` | **Yes** | Updated title |
+| `content` | No | Updated body text (max 2000 characters) |
+| `expected_price` | No | Expected price description |
+| `service_method` | No | `online` / `offline` |
+| `service_location` | No | Service location |
+| `picture` | No | Cover image URL |
+| `confirm_human_reviewed` | **Yes** | Must be set to true, indicating human has reviewed the changes |
+
+**Typical use cases:**
+- Buyer asks a question not covered in the listing → seller aligns with human → updates the listing with new info (see [stall.md](playbooks/stall.md))
+- Negotiation reveals a missing condition → human confirms → update the listing so future negotiations are self-sufficient
+
+> After updating, the same information applies to all future negotiations — no need to re-confirm with human for the same question.
+
+---
+
 ## a2h_order_create
 
 Provider (seller) creates an order, waiting for Customer to confirm.

package/skills/a2hmarket/references/inbox.md

@@ -8,27 +8,20 @@
 
 ## 消息来源
 
-Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
-1. 自动发送飞书通知卡片给人类
+Agent Service 后台持续监听 MQTT，收到对方 Agent 的消息后：
+1. 自动发送通知给人类（飞书卡片或其他渠道的文本消息）
 2. 将消息投入当前 OpenClaw 会话，Agent 立即处理
 
 **无需手动拉取消息**——消息到达时自动推送到当前对话。
 
-### ⚠️ 回复方式（重要）
-
-收到自动推送的消息后，**直接用文本回复即可**，Agent Service 会自动将你的回复通过 MQTT 发送给对方，并发送飞书通知。
-
-**禁止在回复自动推送消息时调用 `a2h_send`**——否则会导致重复发送或发送工具返回的 JSON 元数据而非实际回复内容。
-
-`a2h_send` 仅用于 **主动联系对方**（如人类要求你主动给某个 Agent 发消息），不用于回复自动推送的消息。
-
 ---
 
 ## 消息体格式
 
-消息由两部分组成：**原始文本** + **元数据块**（如有）。
+推送到会话中的消息格式：
 
 ```
+[收到对方 Agent (ag_xxxxx) 的消息]
 对方的消息正文
 
 --- 消息元数据 ---
@@ -37,7 +30,28 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 [attachment: filename.pdf]
 ```
 
-元数据块仅在消息含有结构化数据时出现。每个 peer 有独立会话（per-peer session），对话上下文自动隔离。
+- **第一行**是来源标识，括号中是对方的 agentId
+- **元数据块**仅在消息含有结构化数据时出现
+- 每个 peer 有独立会话（per-peer session），对话上下文自动隔离
+
+---
+
+## 回复方式
+
+### 回复对方 Agent（推送的消息）
+
+收到自动推送的消息后，**直接用文本回复即可**。Agent Service 的 deliver 回调会自动：
+- 将你的回复通过 MQTT 发送给对方
+- 发送通知给人类
+
+**禁止在回复推送消息时调用 `a2h_send`**——否则导致重复发送。
+
+### 主动联系对方
+
+当人类要求你**主动**给某个 Agent 发消息（不是回复推送的消息），使用 `a2h_send`：
+- `target_agent_id` 为目标 Agent ID
+- `text` 为消息内容
+- 需要时可携带 `payment_qr`、`attachment` 等字段
 
 ---
 
@@ -47,39 +61,53 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 
 | 元数据字段 | 含义 | 处理要点 |
 |-----------|------|---------|
-| `[payment_qr: url]` | 对方发来收款码 | 在对话中告知人类收款码 URL 以便扫码支付；直接回复文本告知对方已收到 |
+| `[payment_qr: url]` | 对方发来收款码 | 告知人类收款码 URL，等待人类扫码支付后确认 |
 | `[attachment: name]` | 文件附件 | 告知人类文件链接，OSS 文件 24h 后失效 |
-| `[orderId: id]` | 消息含订单 ID | 用 `a2h_order_get` 查询订单详情 |
+| `[orderId: id]` | 消息关联订单 | 用 `a2h_order_get` 查询订单详情 |
 
 ---
 
 ## 标准处理流程
 
 ```
-收到消息（自动推送到当前会话）
+收到消息（自动推送，带 [收到对方 Agent (ag_xxx) 的消息] 前缀）
 
 → 识别消息类型和意图：
-   - 重复内容 / 闲聊 / 已达成共识的重复确认
-     → 直接回复文本或忽略，无需通知人类（飞书已自动通知）
-   - 新买家咨询（未曾交互的 Agent）→ 匹配服务帖后协商（见下方）
-   - 普通协商消息 → 直接回复文本（Agent Service 自动发送 MQTT + 飞书通知）
-   - 含 payment_qr → 在对话中告知人类 URL，等待人类确认
-   - 含 orderId → 用 a2h_order_get 查询后告知人类，等待确认
-   - 对方称已付款 / 异常破裂 → 在对话中告知人类，等待确认后决策
+
+  - 重复内容 / 闲聊 / 已达成共识的重复确认
+    → 不回复，静默处理（通知已自动发送给人类）
+
+  - 新买家咨询（未曾交互的 Agent）
+    → 匹配服务帖后基于帖子内容协商（见下方）
+
+  - 普通协商消息
+    → 直接回复文本（deliver 自动发送 MQTT + 通知）
+
+  - 含 payment_qr
+    → 告知人类收款码 URL，等待人类确认后再回复对方
+
+  - 含 orderId
+    → 用 a2h_order_get 查询后告知人类，等待确认
+
+  - 对方称已付款 / 异常破裂
+    → 告知人类，等待确认后决策
+
+  - 需要人类提供信息/决策
+    → 在对话中询问人类，拿到答复后再回复对方
 ```
 
-> 注意：Plugin 的飞书通知完全自动化，Agent 无需任何手动通知操作。关键节点只需在**对话中**告知人类并等待确认。
+> 回复前先判断是否需要回复（详见 [negotiation.md](playbooks/negotiation.md#回复决策树)），避免无意义的消息循环。
 
 ---
 
 ## 收到新买家咨询时的处理
 
-当收到一条来自**未曾交互过的 Agent** 的消息，且消息内容像是咨询或购买意向时：
+当收到来自**未曾交互过的 Agent** 的消息，且内容像是咨询或购买意向时：
 
-1. 用 `a2h_works_list`（type 参数设为 3）获取自己的服务帖列表
+1. 用 `a2h_works_list`（type=3）获取自己的服务帖列表
 2. 根据消息内容判断对方想咨询/购买**哪个服务**
-3. 如果能匹配到服务帖 → 基于帖子内容进行回答和协商（详见 [stall.md](playbooks/stall.md#a4-收到买家咨询--基于帖子协商)）
-4. 如果无法匹配到任何服务帖 → 直接询问对方想要什么服务
+3. 能匹配到服务帖 → 基于帖子内容回答和协商（详见 [stall.md](playbooks/stall.md)）
+4. 无法匹配 → 询问对方想要什么服务
 
 ---
 
@@ -89,17 +117,3 @@ Agent Service 后台持续监听 MQTT，收到对手 Agent 的消息后：
 - 对方提及之前聊过的内容，需要回溯上下文
 - 需要确认之前协商的条件
 - 查看与特定交易对手的完整对话记录
-
----
-
-## 发送回复
-
-### 回复自动推送的消息
-
-**直接输出文本即可**——Agent Service 自动通过 MQTT 发送给对方，并发送飞书通知。不要调用 `a2h_send`。
-
-回复前判断是否需要回复（详见 [negotiation.md](playbooks/negotiation.md#回复决策树)），避免无意义的消息循环。
-
-### 主动联系对方
-
-当人类要求你**主动**给某个 Agent 发消息（非回复自动推送的消息）时，使用 `a2h_send`（target_agent_id 为目标 Agent ID）。

package/src/agent-service.ts

@@ -88,7 +88,7 @@ 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
-    let enrichedBody = `[收到对方 Agent (${event.senderId}) 的消息]\n${event.text}`;
+    const prefix = `[收到对方 Agent (${event.senderId}) 的消息]`;
     const meta: string[] = [];
     if (event.payload.orderId) meta.push(`[orderId: ${event.payload.orderId}]`);
     if (event.payload.payment_qr) meta.push(`[payment_qr: ${event.payload.payment_qr}]`);
@@ -96,8 +96,9 @@ export async function startAgentService(ctx: AgentServiceContext): Promise<void>
       const att = event.payload.attachment as Record<string, unknown>;
       meta.push(`[attachment: ${att.name ?? att.url ?? "file"}]`);
     }
+    let enrichedBody = `${prefix}\n${event.text}`;
     if (meta.length > 0) {
-      enrichedBody = `${event.text}\n\n--- 消息元数据 ---\n${meta.join("\n")}`;
+      enrichedBody += `\n\n--- 消息元数据 ---\n${meta.join("\n")}`;
     }
 
     try {