@actionway/cli 0.17.1 → 0.18.0

package/README.md

@@ -12,7 +12,9 @@ actionway CLI 的本地端壳（迁移文档 `docs/DL_TO_ACTIONWAY_CLI_MIGRATION
   - 高频 typed command 继续提供参数与文件 UX，但投影到同一个 Tool Call；
   - `account usage / wallet / transactions` 只读 Actionway Business 数据；
   - 本壳另有 `init` / `update` / `login` / `logout` / `whoami`，cli-core
-    继续提供 wait/poll 与已冻结的共享 typed commands。
+  继续提供 wait/poll 与已冻结的共享 typed commands。
+
+- **账户响应无本地换算**：`account` 响应同时保留精确整数 micros 与可直接展示的 USD 十进制字符串；钱包包含快照更新时间，交易包含状态、说明、完成时间和 signed balance delta。Usage/Transactions 支持 ISO 时间窗口、领域筛选和 opaque cursor，返回的 summary 覆盖完整筛选集合而非当前页。CLI 不自行换算资金，也不改变服务端返回的字段语义。
 - **计费零逻辑**：报价、扣费、错误面裁剪全在 gateway；本壳只透传。旧
   stock download 直连 CDN、Gateway 无法观察结局，因此在阶段二的
   command-level 计费编排完成前明确 fail-closed，不把迁移缺口当免费能力。
@@ -39,6 +41,8 @@ pnpm cli update --check  # 查新版（24h 缓存）
 pnpm cli -- tools search "generate a product image"
 pnpm cli -- tools inspect media.image.generate
 pnpm cli -- account usage
+pnpm cli -- account usage --from 2026-08-01 --to 2026-09-01 --service generate-image
+pnpm cli -- account transactions --from 2026-08-01 --kind top_up
 pnpm cli -- generate-video --print-schema
 ```
 

package/dist/index.js

@@ -12876,6 +12876,23 @@ function failAccount(error) {
   }
   fail({ code: "E_BACKEND", message: error instanceof Error ? error.message : String(error) });
 }
+function accountEndpoint(path, options) {
+  const parameters = new URLSearchParams();
+  for (const [name, value] of [
+    ["limit", options.limit],
+    ["cursor", options.cursor],
+    ["from", options.from],
+    ["to", options.to],
+    ["status", options.status],
+    ["service_id", options.service],
+    ["pricing_kind", options.pricingKind],
+    ["kind", options.kind]
+  ]) {
+    if (value !== void 0) parameters.set(name, value);
+  }
+  const query = parameters.toString();
+  return `v1/account/${path}${query ? `?${query}` : ""}`;
+}
 async function read(endpoint, getTransport3) {
   try {
     ok(await getTransport3().getBusiness(endpoint, { retries: 1 }));
@@ -12885,9 +12902,9 @@ async function read(endpoint, getTransport3) {
 }
 function registerAccountCommands(program2, getTransport3) {
   const account = program2.command("account").description("Read your Actionway USD wallet, service usage, and wallet transactions.");
-  account.command("usage").description("List recent held, charged, released, and free capability calls.").action(() => read("v1/account/usage", getTransport3));
+  account.command("usage").description("Query held, charged, released, and free capability calls.").option("--limit <count>", "Maximum records in this page (1-100).").option("--cursor <cursor>", "Opaque nextCursor returned by the previous page.").option("--from <date>", "Inclusive ISO date or timestamp (UTC for date-only values).").option("--to <date>", "Exclusive ISO date or timestamp (UTC for date-only values).").option("--status <status>", "held, settled, or expired.").option("--service <service-id>", "Exact public serviceId.").option("--pricing-kind <kind>", "priced or free.").action((options) => read(accountEndpoint("usage", options), getTransport3));
   account.command("wallet").description("Show the current available and held Actionway USD wallet balance.").action(() => read("v1/account/wallet", getTransport3));
-  account.command("transactions").description("List wallet top-ups, charges, releases, and other fund movements.").action(() => read("v1/account/transactions", getTransport3));
+  account.command("transactions").description("Query wallet top-ups, charges, promotions, refunds, and other fund movements.").option("--limit <count>", "Maximum records in this page (1-50).").option("--cursor <cursor>", "Opaque nextCursor returned by the previous page.").option("--from <date>", "Inclusive ISO date or timestamp (UTC for date-only values).").option("--to <date>", "Exclusive ISO date or timestamp (UTC for date-only values).").option("--status <status>", "pending, succeeded, or failed.").option("--kind <kind>", "top_up, charge, refund, dispute, or promotion kind.").action((options) => read(accountEndpoint("transactions", options), getTransport3));
 }
 
 // src/lib/install-session.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actionway/cli",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "description": "actionway CLI 的本地端壳：Clerk OAuth 鉴权 + cli-core 共享命令面 + init / update / skill 物化 / 版本三链路（终端用户本地 Codex / Claude Code 使用）",
   "type": "module",
   "bin": {