@xiashe/sdk 0.1.24 → 0.1.26

package/alipayWallet.mjs

@@ -861,7 +861,7 @@ export async function diagnoseAlipay402Resource(input, options = {}) {
       message: '没有找到本地付款尝试；请不要因此重复付款。'
     };
   }
-  return {
+  const result = {
     ok: state.status !== 'failed' && state.status !== 'wallet_command_failed',
     status: state.status || 'unknown',
     provider: 'alipay-agent-payment',
@@ -877,4 +877,72 @@ export async function diagnoseAlipay402Resource(input, options = {}) {
     } : {}),
     updatedAt: state.updatedAt || null
   };
+  // TRADE_PROGRESS_FAILED is deliberately generic in the official wallet
+  // output. Attach a redacted report to the one diagnose command an Agent is
+  // already required to run, rather than relying on it to remember a second
+  // optional command after a failed payment.
+  if (state.lastFailureCode === 'wallet_trade_progress_failed') {
+    const support = await createAlipay402SupportReport({ resourceUrl }, options);
+    if (support.ok && support.report) result.supportReport = support.report;
+  }
+  return result;
+}
+
+/**
+ * Creates a deliberately redacted support summary for an already-failed
+ * official-wallet attempt. This never invokes the wallet, re-fetches the
+ * resource, or reads/prints the Payment-Needed payload. It is intended for
+ * the official `alipay-bot problem-feedback` flow, where a generic wallet
+ * trade-creation error otherwise leaves an operator with no safe facts to
+ * report.
+ */
+export async function createAlipay402SupportReport(input, options = {}) {
+  const resourceUrl = normalizeResourceUrl(input?.resourceUrl);
+  const state = await readPaymentState(resourceUrl, options);
+  if (!state) {
+    return {
+      ok: false,
+      status: 'no_local_attempt',
+      provider: 'alipay-agent-payment',
+      walletInvoked: false,
+      message: '没有找到本地付款尝试，无法生成问题反馈材料。'
+    };
+  }
+
+  const failureCode = state.lastFailureCode || null;
+  const diagnosis = state.lastDiagnosis || null;
+  const failedBeforeConfirmation = !state.queryCredential?.value &&
+    ['failed', 'wallet_command_failed'].includes(state.status);
+  const { stdout, stderr } = await runOfficialCli(['--version'], options);
+  const runtimeVersion = safeRuntimeVersion(stdout, stderr) || null;
+  const lines = [
+    '[环节]：402 支付 / 官方钱包创建交易',
+    `[结果]：${failedBeforeConfirmation ? '未创建可确认交易，未获得 Payment-Proof' : '请以本地诊断状态为准'}`,
+    `[桥接诊断]：${diagnosis?.code || failureCode || 'unknown'}`,
+    `[官方代码]：${diagnosis?.officialCode || '未返回'}`,
+    `[官方运行时]：${runtimeVersion || '未知'}`,
+    `[发生时间]：${state.updatedAt || state.createdAt || '未知'}`,
+    '[已确认]：卖方资源返回字段结构有效的 402 账单；本次未生成可查询交易凭证。',
+    '[请协助]：返回本次 TRADE_PROGRESS_FAILED 的子码、requestId/traceId，以及交易创建被拒绝的具体校验项。'
+  ];
+  return {
+    ok: true,
+    status: 'support_report_ready',
+    provider: 'alipay-agent-payment',
+    walletInvoked: false,
+    report: {
+      category: 'ALIPAY_402_TRADE_CREATION_FAILED',
+      attemptId: `alipay-402:${state.resourceDigest.slice(0, 16)}`,
+      occurredAt: state.updatedAt || state.createdAt || null,
+      officialRuntimeVersion: runtimeVersion,
+      failureCode,
+      ...(diagnosis?.officialCode ? { officialCode: diagnosis.officialCode } : {}),
+      ...(diagnosis?.officialSubCode ? { officialSubCode: diagnosis.officialSubCode } : {}),
+      billShapeValidated: state.merchantResource?.billShapeValidated === true,
+      paymentNeededReceived: state.merchantResource?.paymentNeededReceived === true,
+      queryCredentialCreated: Boolean(state.queryCredential?.value),
+      text: lines.join('\n')
+    },
+    message: '已生成脱敏的问题反馈材料；其中不包含订单号、资源 URL、账单、Payment-Proof 或钱包凭证。'
+  };
 }

package/index.mjs

@@ -6,7 +6,7 @@ import path from 'node:path';
 import { ConvexHttpClient } from 'convex/browser';
 import { anyApi as api } from 'convex/server';
 
-export const VERSION = '0.1.24';
+export const VERSION = '0.1.26';
 
 export const DEFAULTS = {
   cn: {
@@ -1365,5 +1365,6 @@ export {
   preflightAlipay402Resource,
   payAlipay402Resource,
   queryAlipay402Resource,
-  diagnoseAlipay402Resource
+  diagnoseAlipay402Resource,
+  createAlipay402SupportReport
 } from './alipayWallet.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiashe/sdk",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "type": "module",
   "main": "index.mjs",
   "exports": {