@itpay/cli 0.2.7 → 0.2.8

package/README.md

@@ -240,6 +240,7 @@ Payment QR rules:
 - Use `mobile_wallet_url` only as a human mobile fallback.
 - Do not generate your own QR from payment URLs.
 - In agent app clients, execute `render_plan.selected` first. Send its media, text/markdown, real links, and native buttons when the adapter supports them.
+- In OpenClaw Telegram, send `render_plan.selected.openclaw_message` with OpenClaw `message send --media ... --presentation ...`; do not put legacy inline media directives inside human prose.
 - Do not rewrite `render_plan.selected` into a custom table or omit the real URL.
 - If status is `payment_handoff_required`, `next` is the human reply step, not payment wait.
 - Treat only `payment_intent.verified` as payment success.

package/docs/agent/buyer/payment-qr.json

@@ -45,6 +45,7 @@
     "Do not rewrite response.render_plan.selected into a custom table. Use selected.text/markdown, selected.media, selected.links, and selected.buttons as provided.",
     "If selected.links exists, include the real URL. Do not only show the link label.",
     "If selected.buttons exists but the current adapter cannot render native buttons, degrade to selected.links plus short text; do not fake payment success or skip the status check.",
+    "In OpenClaw Telegram, prefer selected.openclaw_message: send its message/media/presentation through OpenClaw message send. Do not place legacy inline media directives inside prose; that fallback cannot render inline buttons.",
     "In Codex or Claude Code app clients, send response.human_visible_markdown or response.render_plan.platforms.codex_app.markdown to the human first. Do not start a hidden long wait before the human-visible message is sent.",
     "For Telegram-style message clients, use response.render_plan.platforms.telegram: send photo media first, include links, and expose native buttons for refresh/status when the adapter supports them.",
     "For plain chat clients, show response.human_visible_markdown and stop unless the human asks you to check status or returns with a payment question.",

package/docs/agent/buyer/quickstart.json

@@ -68,7 +68,7 @@
     "Show the returned payment QR exactly as provided before starting payment wait.",
     "Payment truth comes only from payment_intent.verified.",
     "Secure delivery goes to the human first; report redacted delivery status only.",
-    "When a response includes render_plan.selected, execute that selected plan first; do not make the model choose a different platform branch or rewrite the payment/auth UI."
+    "When a response includes render_plan.selected, execute that selected plan first; do not make the model choose a different platform branch or rewrite the payment/auth UI. In OpenClaw Telegram, use selected.openclaw_message instead of handwritten legacy media directive prose."
   ],
   "forbidden": [
     "Do not call ops commands from the buyer path.",

package/lib/buyer.js

@@ -1649,6 +1649,7 @@ function compactHumanAction(action = null) {
     qr_image_url: action.qr_image_url,
     preferred_qr_url: action.preferred_qr_url,
     mobile_wallet_url: action.mobile_wallet_url,
+    presentation: action.presentation,
     agent_display_hint: action.agent_display_hint,
     expires_at: action.expires_at
   });

package/lib/render-human.js

@@ -377,10 +377,50 @@ function telegramRenderPlan(action = {}, { localQRPath = "", preferredQRURL = ""
       ? "请扫码或点击链接完成支付。付款后点“我已付款，查询状态”。"
       : "请打开 ItPay 授权入口，完成后回到当前对话。",
     links,
-    buttons
+    buttons,
+    openclaw_message: openclawTelegramMessage({ action, media, links, buttons })
   };
 }
 
+function openclawTelegramMessage({ action = {}, media = [], links = [], buttons = [] } = {}) {
+  const mediaURL = media[0]?.local_path || media[0]?.fallback_url || "";
+  const text = action.kind === "payment_qr"
+    ? "请扫码或点击链接完成支付。付款完成后点“我已付款，查询状态”，或直接回复“我已付款”。"
+    : "请打开 ItPay 授权入口，完成后回到当前对话。";
+  const presentationButtons = links.map((link) => ({ label: link.label, url: link.url }));
+  if (action.kind === "payment_qr") {
+    presentationButtons.push(
+      { label: "支付遇到问题 / 刷新", action: { type: "command", command: "刷新付款二维码" } },
+      { label: "我已付款，查询状态", action: { type: "command", command: "我已付款，查询状态" } }
+    );
+  } else {
+    for (const button of buttons) {
+      if (button.url && !presentationButtons.some((item) => item.url === button.url)) {
+        presentationButtons.push({ label: button.text || "打开链接", url: button.url });
+      }
+    }
+  }
+  const presentation = {
+    blocks: [
+      { type: "text", text },
+      ...(presentationButtons.length ? [{ type: "buttons", buttons: presentationButtons }] : [])
+    ]
+  };
+  return compactObject({
+    adapter: "openclaw",
+    channel: "telegram",
+    use: "message send --media/--presentation; do not use legacy inline media directives",
+    message: text,
+    media: mediaURL || undefined,
+    presentation,
+    command_args: compactObject({
+      message: text,
+      media: mediaURL || undefined,
+      presentation
+    })
+  });
+}
+
 function selectedRenderPlatform(host = "") {
   const normalized = String(host || "").toLowerCase().replaceAll("-", "_");
   if (["codex", "codex_app", "codex_cli"].includes(normalized)) return "codex_app";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itpay/cli",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "ItPay CLI, buyer skill, and agent-readable docs for agent-native commerce.",
   "type": "module",
   "bin": {