@xiashe/cli 0.1.9 → 0.1.11

package/README.md

@@ -17,12 +17,16 @@ node packages/xiashe-cli/bin/xiashe.mjs login --email you@example.com --password
 xiashe skills list
 xiashe skills install copywriting --connection MaxClaw-1 --watch
 xiashe agent issue --name "Local WorkBuddy"
-xiashe agent connect --token "<token>" --name "Local WorkBuddy"
+xiashe agent connect --token "<token>" --name "Local WorkBuddy" --transport npx
 xiashe agent run --ack
 xiashe chat send --chat "New Chat" --content "帮我处理这个文件" --file ./report.pdf --agent "Local WorkBuddy"
 xiashe skills publish draft . --source xiashe
 xiashe skills publish doctor "<submission-id>"
 xiashe skills publish submit "<submission-id>"
+xiashe payment doctor
+# After the Agent shows the Skill and purpose and the user explicitly agrees:
+xiashe payment pay --resource-url "https://<actions-site>/payment/alipay-ai-collect?orderId=<id>" --intent-summary "使用付费 Skill：<name>" --confirm
+xiashe payment status --resource-url "https://<actions-site>/payment/alipay-ai-collect?orderId=<id>"
 ```
 
 Local state is stored in `~/.xiashe/config.json`.
@@ -31,8 +35,22 @@ Local state is stored in `~/.xiashe/config.json`.
 
 `xiashe agent run --ack` is the recommended lightweight receiver for shell-capable Agents. It sends cheap heartbeats and only lists/executes work when the backend reports pending tasks or transfers. Default cadence is about 30s while idle, 10s while work is active, and up to 2 minutes after long idle periods.
 
+Supported transport labels are `a2a`, `mcp`, `http`, `npx`, `claw`, and `manual`. The label is advisory for routing and diagnostics; the runtime token, task lease, ack, and complete events remain the source of truth.
+
 Production defaults:
 
 - Convex: `https://api.xiashe.chat`
 - Actions: `https://actions.xiashe.chat`
 - Relay: `https://relay.xiashe.chat`
+
+## Alipay AI Pay local bridge
+
+`xiashe payment` is the shell-capable Agent path for Alipay AI Pay. It delegates only to the official local `alipay-bot` supplied by `@alipay/agent-payment`; it does not implement or expose `Payment-Needed` / `Payment-Proof` itself.
+
+- `xiashe payment doctor` checks whether the local wallet is enabled.
+- `xiashe payment pay` requires an HTTPS AI-Collect resource URL, a visible purchase-purpose summary, and `--confirm`. The command then waits for the user to approve in Alipay App.
+- `xiashe payment status` returns a normalized status only. No wallet protocol payload or proof is printed.
+
+An Agent must never add `--confirm` before the user has explicitly agreed to the displayed purpose. If the wallet is unavailable, obtain permission before running the official `@alipay/agent-payment` setup, then run `payment doctor` again.
+
+For a clean Codex Task, the XiaShe MCP response provides a version-pinned ephemeral command such as `npx -y @xiashe/cli@0.1.11 payment doctor`. No global `xiashe` installation is required for that path.

package/bin/xiashe.mjs

@@ -34,7 +34,10 @@ const {
   postJson,
   mcpCall,
   decodeMcpToolResult,
-  nowIso
+  nowIso,
+  checkAlipayWallet,
+  payAlipay402Resource,
+  queryAlipay402Resource
 } = sdk;
 
 const EXIT_USAGE = 2;
@@ -75,7 +78,7 @@ Usage:
   ${c} skills publish release <submission-id>
 
   ${c} agent issue [--name <name>] [--kind <kind>] [--json]
-  ${c} agent connect --token <token> [--name <name>] [--kind <kind>] [--webhook-url <https-url>] [--webhook-token <secret>]
+  ${c} agent connect --token <token> [--name <name>] [--kind <kind>] [--transport a2a|mcp|http|npx|claw|manual] [--webhook-url <https-url>] [--webhook-token <secret>]
   ${c} agent heartbeat [--webhook-url <https-url>] [--webhook-token <secret>|--disable-webhook]
   ${c} agent list
   ${c} agent revoke --agent <id-or-name>
@@ -92,6 +95,10 @@ Usage:
   ${c} files upload <path>
   ${c} files list
 
+  ${c} payment doctor
+  ${c} payment pay --resource-url <https-url> --intent-summary <text> --confirm [--wallet-timeout-ms <ms>]
+  ${c} payment status --resource-url <https-url>
+
   ${c} ops doctor
 
 Global flags:
@@ -119,7 +126,8 @@ function parseGlobal(argv) {
     actionsUrl: '',
     market: '',
     locale: '',
-    timeoutMs: 20_000
+    timeoutMs: 20_000,
+    timeoutMsExplicit: false
   };
   for (let i = 0; i < argv.length; i += 1) {
     const value = argv[i];
@@ -166,6 +174,7 @@ function parseGlobal(argv) {
       if (!Number.isFinite(global.timeoutMs) || global.timeoutMs < 1000) {
         fail('Invalid --timeout-ms value.', EXIT_USAGE);
       }
+      global.timeoutMsExplicit = true;
       i += 1;
       continue;
     }
@@ -600,6 +609,21 @@ async function cmdSkillPublish(flags, client, global) {
       );
       return;
     }
+    if (result.searchable || result.skillCatalogId) {
+      print(
+        [
+          `Published searchable Skill listing: ${result.skillCatalogId || result.submissionId}`,
+          `Submission: ${result.submissionId}`,
+          `Name: ${printableDraft.name}`,
+          `Market: ${printableDraft.market}`,
+          `Source fingerprint: ${printableDraft.packageSha256 || 'not attached'}`,
+          '',
+          'No extra creator login is required. Continue with Red Skill upload and Agent Ack verification.'
+        ].join('\n'),
+        global
+      );
+      return;
+    }
     print(
       [
         `Created Skill submission draft: ${result.submissionId}`,
@@ -635,7 +659,12 @@ async function cmdSkillPublish(flags, client, global) {
       print(result, global);
       return;
     }
-    print(`Submitted Skill for review: ${submissionId}`, global);
+    print(
+      result.searchable
+        ? `Published searchable Skill listing: ${result.skillCatalogId || submissionId}`
+        : `Submitted Skill for review: ${submissionId}`,
+      global
+    );
     return;
   }
   if (action === 'admin-list') {
@@ -1114,6 +1143,40 @@ async function cmdFiles(sub, args, global) {
   fail(`Unknown files command: ${sub}`, EXIT_USAGE);
 }
 
+async function cmdPayment(sub, args, global) {
+  const flags = parseFlags(args);
+  const walletTimeoutValue = flags['wallet-timeout-ms'] ?? flags.walletTimeoutMs ?? (global.timeoutMsExplicit ? global.timeoutMs : undefined);
+  const walletTimeoutMs = walletTimeoutValue === undefined
+    ? undefined
+    : numericFlag({ walletTimeoutMs: walletTimeoutValue }, 'walletTimeoutMs', 0);
+  if (walletTimeoutValue !== undefined && !walletTimeoutMs) {
+    fail('Invalid --wallet-timeout-ms value.', EXIT_USAGE);
+  }
+  if (sub === 'doctor' || sub === 'wallet' || sub === 'wallet-status') {
+    const result = await checkAlipayWallet({ timeoutMs: global.timeoutMs });
+    print(result, global);
+    return;
+  }
+  if (sub === 'pay') {
+    const resourceUrl = requireArg(flags['resource-url'] || flags.resourceUrl || flags.r, '--resource-url');
+    const intentSummary = requireArg(flags['intent-summary'] || flags.intentSummary || flags.i, '--intent-summary');
+    const result = await payAlipay402Resource({
+      resourceUrl,
+      intentSummary,
+      confirm: flags.confirm === true
+    }, walletTimeoutMs ? { timeoutMs: walletTimeoutMs } : {});
+    print(result, global);
+    return;
+  }
+  if (sub === 'status') {
+    const resourceUrl = requireArg(flags['resource-url'] || flags.resourceUrl || flags.r, '--resource-url');
+    const result = await queryAlipay402Resource({ resourceUrl }, { timeoutMs: global.timeoutMs });
+    print(result, global);
+    return;
+  }
+  fail(`Usage: ${COMMAND_NAME} payment doctor|pay|status`, EXIT_USAGE);
+}
+
 async function cmdOps(sub, args, global) {
   const flags = parseFlags(args);
   const { client } = await makeClient(global);
@@ -1328,6 +1391,7 @@ async function main() {
     if (command === 'agent' || command === 'agents') return await cmdAgent(sub, args, global);
     if (command === 'chat' || command === 'chats') return await cmdChat(sub, args, global);
     if (command === 'files' || command === 'file') return await cmdFiles(sub, args, global);
+    if (command === 'payment' || command === 'payments') return await cmdPayment(sub, args, global);
     if (command === 'ops') return await cmdOps(sub, args, global);
     fail(`Unknown command: ${command}\n\n${usage()}`, EXIT_USAGE);
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiashe/cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "type": "module",
   "bin": {
     "xiashe": "bin/xiashe.mjs"
@@ -10,7 +10,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@xiashe/sdk": "0.1.9"
+    "@xiashe/sdk": "0.1.11"
   },
   "engines": {
     "node": ">=20"