@itpay/cli 2.1.40 → 2.1.41

package/dist/src/commands/readyz.js

@@ -8,7 +8,7 @@ export async function runReadyz(backend, options = {}) {
         status: response.status,
         result: { backend: "available", backend_url: backendURL, environment, ...(options.agentType ? { agent_type: options.agentType } : {}) },
         instruction: environment === "development"
-            ? `ItPay 开发环境 ${backendURL} 可用。只证明后端存活。尚未读此次包 Skill 时完整读取；已读同版本则无需重复，继续设备状态检查；后续必须执行返回的完整命令并保持同一 Backend。`
+            ? "ItPay dev 可用。只证明后端存活。尚未读此次包 Skill 时完整读取；已读同版本则无需重复，继续设备状态检查；后续必须执行返回的完整命令并保持同一 dev Backend。"
             : "ItPay 可用。只证明后端存活。尚未读此次包 Skill 时完整读取；已读同版本则无需重复，继续设备状态检查；不自动登录或开始业务。",
         next: { command: "itpay skill show itpay --json", reason: "加载完整操作与安全规则" },
         recovery: [],

package/dist/src/commands/refund.js

@@ -1,4 +1,3 @@
-import { refundStateEnvelope } from "../services/shared/refund.js";
 import { operationID } from "../state/config.js";
 import { formatMoney } from "../render/output.js";
 import { resolveOutput } from "../render/sink.js";
@@ -13,6 +12,46 @@ export async function runRefund(backend, config, options) {
         plainResult: Object.entries(envelope.result).map(([key, value]) => `${key}: ${typeof value === "string" ? value : JSON.stringify(value)}`),
     });
 }
+function refundStateEnvelope(refund, status) {
+    const terminal = ["succeeded", "failed", "cancelled", "rejected"].includes(refund.status);
+    let instruction = refund.decision_mode === "manual"
+        ? "先告诉用户退款已进入人工审核，原交付保持冻结；人工审核不等于拒绝，等待服务器决定，不要重复申请或承诺结果。"
+        : "先告诉用户退款申请已经记录，原交付已冻结；自动路径表示系统会继续处理，但只有最终 succeeded 才能确认退款成功。然后只跟踪同一退款，不要重复申请、reveal、授权或读取结果。";
+    if (!refund.access_locked)
+        instruction = "先告诉用户退款当前没有锁定交付；按服务器事实解释当前状态，不要自行推断退款结果、到账时间或交付资格。";
+    if (refund.status === "succeeded")
+        instruction = "先告诉用户退款已由 ItPay 确认成功，原交付永久关闭；不需要继续跟踪或重复申请。";
+    if (refund.status === "cancelled" || refund.status === "rejected")
+        instruction = "先告诉用户退款没有执行，交付资格可以恢复；旧读取授权不会复活，需要用户重新授权。不要把取消或拒绝说成退款成功。";
+    if (refund.status === "failed") {
+        if (refund.failure_class === "known_no_effect")
+            instruction = "先告诉用户本次退款请求确认未发送，不能说退款已成功；Agent 不自行重试，请用户等待平台管理员决定是否重新执行。";
+        else if (refund.failure_class === "retryable")
+            instruction = "先告诉用户渠道明确返回可重试失败，但 Agent 不会自行重试或重复申请；请用户等待平台管理员处理。";
+        else if (refund.failure_class === "outcome_unknown")
+            instruction = "先告诉用户退款渠道结果未知，原交付继续锁定且必须先由平台对账；禁止重试、重复申请或承诺退款结果。";
+        else if (refund.failure_class === "permanent")
+            instruction = "先告诉用户渠道明确拒绝本次退款，当前不能承诺退款成功；不要重试，请用户联系平台支持。";
+        else
+            instruction = "先告诉用户退款没有正常完成，当前不能承诺退款成功；不要重试或重复申请，请用户联系平台支持。";
+    }
+    return {
+        status,
+        result: {
+            refund_request_id: refund.refund_request_id,
+            order_id: refund.order_id,
+            decision_mode: refund.decision_mode,
+            refund_status: refund.status,
+            consumption_state: refund.consumption_state,
+            ...(refund.failure_class ? { failure_class: refund.failure_class } : {}),
+            access_locked: refund.access_locked,
+            can_cancel: refund.can_cancel,
+        },
+        instruction,
+        next: terminal ? null : { command: `itpay refund watch ${refund.refund_request_id} --json`, reason: "跟踪同一退款" },
+        recovery: [],
+    };
+}
 export async function runListRefunds(backend, options) {
     const out = resolveOutput(options.output);
     const response = await backend.listOrderRefunds(options.orderID);
@@ -34,7 +73,7 @@ export async function runListRefunds(backend, options) {
                 : "该订单没有退款记录；确认用户确实要求退款后再创建。",
         next: selected
             ? { command: `itpay refund get ${selected.refund_request_id} --json`, reason: active ? "读取活跃退款" : "读取最新退款" }
-            : null,
+            : { command: `itpay refund create --order ${options.orderID} --json`, reason: "为该订单创建退款" },
         recovery: [],
     };
     writeCommandEnvelope(envelope, {
@@ -57,13 +96,13 @@ export async function runGetRefund(backend, refundID, options = {}) {
 export async function runCancelRefund(backend, refundID, reason, options = {}) {
     const refund = await backend.cancelRefund(refundID, reason?.trim() || "buyer_cancelled");
     const envelope = {
-        status: refund.status,
+        status: "cancelled",
         result: {
             refund_request_id: refund.refund_request_id,
             order_id: refund.order_id,
             access_locked: refund.access_locked,
         },
-        instruction: refund.status === "cancelled" ? "Backend确认退款已取消；如需交付，重新进入原订单核对当前权限，旧grant不自动复活；后端要求时取得新的授权。" : "Backend未确认取消；按返回的退款权威状态核对原订单，不重复提交取消。",
+        instruction: "退款已取消；如需交付，重新进入订单并取得新的授权。",
         next: { command: `itpay order ${refund.order_id} --json`, reason: "确认订单访问状态" },
         recovery: [],
     };
@@ -71,30 +110,36 @@ export async function runCancelRefund(backend, refundID, reason, options = {}) {
 }
 export async function runWatchRefund(backend, refundID, options = {}) {
     const intervalSeconds = options.intervalSeconds ?? 2;
-    const timeoutSeconds = options.timeoutSeconds ?? 20;
+    const timeoutSeconds = options.timeoutSeconds ?? 120;
     if (!Number.isFinite(intervalSeconds) || intervalSeconds < 1)
         throw new Error("--interval must be at least 1 second");
     if (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0)
         throw new Error("--timeout must be a positive number");
     const deadline = Date.now() + timeoutSeconds * 1000;
     let refund;
-    let initialState;
     for (;;) {
         refund = await backend.getRefund(refundID);
-        const state = JSON.stringify([refund.status, refund.decision_mode, refund.failure_class, refund.access_locked, refund.can_cancel]);
-        if (["succeeded", "failed", "cancelled", "rejected"].includes(refund.status) || refund.decision_mode === "manual" || refund.failure_class === "outcome_unknown" || (initialState !== undefined && state !== initialState)) {
+        if (["succeeded", "failed", "cancelled", "rejected"].includes(refund.status)) {
             writeRefundEnvelope(refundStateEnvelope(refund, "watch_complete"), options);
             return;
         }
-        initialState ??= state;
         const remaining = deadline - Date.now();
         if (remaining <= 0)
             break;
         await new Promise((resolve) => setTimeout(resolve, Math.min(intervalSeconds * 1000, remaining)));
     }
-    const latest = refundStateEnvelope(refund, "watch_timeout");
-    writeRefundEnvelope({ ...latest, result: { ...latest.result, last_status: refund.status, wait_ended: true },
-        instruction: `本次等待结束，并不表示退款失败。${latest.instruction} 稍后按需读取同一退款，不自动重启等待，不要重复申请。` }, options);
+    writeRefundEnvelope({
+        status: "watch_timeout",
+        result: {
+            refund_request_id: refund.refund_request_id,
+            last_status: refund.status,
+            access_locked: refund.access_locked,
+            can_cancel: refund.can_cancel,
+        },
+        instruction: "先告诉用户退款仍在处理，Timeout 只表示本次等待结束，并不表示退款失败；稍后继续跟踪同一退款，不要重复申请或承诺结果。",
+        next: { command: `itpay refund watch ${refund.refund_request_id} --json`, reason: "恢复轮询" },
+        recovery: [],
+    }, options);
 }
 function writeRefundEnvelope(envelope, options) {
     writeCommandEnvelope(envelope, {
@@ -103,4 +148,3 @@ function writeRefundEnvelope(envelope, options) {
         plainResult: Object.entries(envelope.result).map(([key, value]) => `${key}: ${typeof value === "string" ? value : JSON.stringify(value)}`),
     });
 }
-export { refundStateEnvelope } from "../services/shared/refund.js";