@crabcloud/cli 0.1.9 → 0.1.10

package/dist/crab.js

@@ -1,4 +1,18 @@
 #!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 
 // src/index.ts
 import { hostname, homedir as homedir2 } from "node:os";
@@ -980,6 +994,7 @@ function datetime(args) {
   return new RegExp(`^${dateSource}T(?:${timeRegex})$`);
 }
 var anyString = /^[\s\S]{0,}$/;
+var bigint = /^-?\d+n?$/;
 var integer = /^-?\d+$/;
 var number = /^-?\d+(?:\.\d+)?$/;
 var boolean = /^(?:true|false)$/i;
@@ -1885,6 +1900,25 @@ var $ZodBoolean = /* @__PURE__ */ $constructor("$ZodBoolean", (inst, def) => {
     return payload;
   };
 });
+var $ZodBigInt = /* @__PURE__ */ $constructor("$ZodBigInt", (inst, def) => {
+  $ZodType.init(inst, def);
+  inst._zod.pattern = bigint;
+  inst._zod.parse = (payload, _ctx) => {
+    if (def.coerce)
+      try {
+        payload.value = BigInt(payload.value);
+      } catch (_) {}
+    if (typeof payload.value === "bigint")
+      return payload;
+    payload.issues.push({
+      expected: "bigint",
+      code: "invalid_type",
+      input: payload.value,
+      inst
+    });
+    return payload;
+  };
+});
 var $ZodNull = /* @__PURE__ */ $constructor("$ZodNull", (inst, def) => {
   $ZodType.init(inst, def);
   inst._zod.pattern = _null;
@@ -1918,6 +1952,29 @@ var $ZodNever = /* @__PURE__ */ $constructor("$ZodNever", (inst, def) => {
     return payload;
   };
 });
+var $ZodDate = /* @__PURE__ */ $constructor("$ZodDate", (inst, def) => {
+  $ZodType.init(inst, def);
+  inst._zod.parse = (payload, _ctx) => {
+    if (def.coerce) {
+      try {
+        payload.value = new Date(payload.value);
+      } catch (_err) {}
+    }
+    const input = payload.value;
+    const isDate = input instanceof Date;
+    const isValidDate = isDate && !Number.isNaN(input.getTime());
+    if (isValidDate)
+      return payload;
+    payload.issues.push({
+      expected: "date",
+      code: "invalid_type",
+      input,
+      ...isDate ? { received: "Invalid Date" } : {},
+      inst
+    });
+    return payload;
+  };
+});
 function handleArrayResult(result, final, index) {
   if (result.issues.length) {
     final.issues.push(...prefixIssues(index, result.issues));
@@ -3323,6 +3380,9 @@ function snapshotChecks(def) {
 function _string(Class, params) {
   return new Class(snapshotChecks({ type: "string", ...normalizeParams(params) }));
 }
+function _coercedString(Class, params) {
+  return new Class(snapshotChecks({ type: "string", coerce: true, ...normalizeParams(params) }));
+}
 function _email(Class, params) {
   return new Class({
     type: "string",
@@ -3563,6 +3623,9 @@ function _isoDuration(Class, params) {
 function _number(Class, params) {
   return new Class(snapshotChecks({ type: "number", checks: [], ...normalizeParams(params) }));
 }
+function _coercedNumber(Class, params) {
+  return new Class(snapshotChecks({ type: "number", coerce: true, checks: [], ...normalizeParams(params) }));
+}
 function _int(Class, params) {
   return new Class({
     type: "number",
@@ -3578,6 +3641,20 @@ function _boolean(Class, params) {
     ...normalizeParams(params)
   });
 }
+function _coercedBoolean(Class, params) {
+  return new Class({
+    type: "boolean",
+    coerce: true,
+    ...normalizeParams(params)
+  });
+}
+function _coercedBigint(Class, params) {
+  return new Class({
+    type: "bigint",
+    coerce: true,
+    ...normalizeParams(params)
+  });
+}
 function _null2(Class, params) {
   return new Class({
     type: "null",
@@ -3595,6 +3672,13 @@ function _never(Class, params) {
     ...normalizeParams(params)
   });
 }
+function _coercedDate(Class, params) {
+  return new Class({
+    type: "date",
+    coerce: true,
+    ...normalizeParams(params)
+  });
+}
 function _lt(value, params) {
   return new $ZodCheckLessThan({
     check: "less_than",
@@ -4469,6 +4553,9 @@ var numberProcessor = (schema, ctx, _json, params) => {
 var booleanProcessor = (_schema, _ctx, json, _params) => {
   json.type = "boolean";
 };
+var bigintProcessor = (schema, ctx, json, params) => {
+  handleUnrepresentable(schema, ctx, json, params, "BigInt cannot be represented in JSON Schema");
+};
 var nullProcessor = (_schema, ctx, json, _params) => {
   if (ctx.target === "openapi-3.0") {
     json.type = "string";
@@ -4482,6 +4569,9 @@ var neverProcessor = (_schema, _ctx, json, _params) => {
   json.not = {};
 };
 var unknownProcessor = (_schema, _ctx, _json, _params) => {};
+var dateProcessor = (schema, ctx, json, params) => {
+  handleUnrepresentable(schema, ctx, json, params, "Date cannot be represented in JSON Schema");
+};
 var enumProcessor = (schema, _ctx, json, _params) => {
   const def = schema._zod.def;
   const values = getEnumValues(def.entries);
@@ -5346,6 +5436,49 @@ var ZodBoolean = /* @__PURE__ */ $constructor("ZodBoolean", (inst, def) => {
 function boolean2(params) {
   return _boolean(ZodBoolean, params);
 }
+var ZodBigInt = /* @__PURE__ */ $constructor("ZodBigInt", (inst, def) => {
+  $ZodBigInt.init(inst, def);
+  ZodType.init(inst, def);
+  inst._zod.processJSONSchema = (ctx, json, params) => bigintProcessor(inst, ctx, json, params);
+}, /* @__PURE__ */ derived({
+  minValue: (inst) => aggregateChecks(inst).minimum ?? null,
+  maxValue: (inst) => aggregateChecks(inst).maximum ?? null,
+  format: (inst) => aggregateChecks(inst).format ?? null
+}, {
+  gte(value, params) {
+    return this.check(_gte(value, params));
+  },
+  min(value, params) {
+    return this.check(_gte(value, params));
+  },
+  gt(value, params) {
+    return this.check(_gt(value, params));
+  },
+  lt(value, params) {
+    return this.check(_lt(value, params));
+  },
+  lte(value, params) {
+    return this.check(_lte(value, params));
+  },
+  max(value, params) {
+    return this.check(_lte(value, params));
+  },
+  positive(params) {
+    return this.check(_gt(BigInt(0), params));
+  },
+  negative(params) {
+    return this.check(_lt(BigInt(0), params));
+  },
+  nonpositive(params) {
+    return this.check(_lte(BigInt(0), params));
+  },
+  nonnegative(params) {
+    return this.check(_gte(BigInt(0), params));
+  },
+  multipleOf(value, params) {
+    return this.check(_multipleOf(value, params));
+  }
+}));
 var ZodNull = /* @__PURE__ */ $constructor("ZodNull", (inst, def) => {
   $ZodNull.init(inst, def);
   ZodType.init(inst, def);
@@ -5370,6 +5503,22 @@ var ZodNever = /* @__PURE__ */ $constructor("ZodNever", (inst, def) => {
 function never(params) {
   return _never(ZodNever, params);
 }
+var ZodDate = /* @__PURE__ */ $constructor("ZodDate", (inst, def) => {
+  $ZodDate.init(inst, def);
+  ZodType.init(inst, def);
+  inst._zod.processJSONSchema = (ctx, json, params) => dateProcessor(inst, ctx, json, params);
+  inst.min = (value, params) => inst.check(_gte(value, params));
+  inst.max = (value, params) => inst.check(_lte(value, params));
+}, /* @__PURE__ */ derived({
+  minDate: (inst) => {
+    const { minimum } = aggregateChecks(inst);
+    return minimum ? new Date(minimum) : null;
+  },
+  maxDate: (inst) => {
+    const { maximum } = aggregateChecks(inst);
+    return maximum ? new Date(maximum) : null;
+  }
+}, {}));
 var ZodArray = /* @__PURE__ */ $constructor("ZodArray", (inst, def) => {
   _ensureDefaultMemoizer();
   $ZodArray.init(inst, def);
@@ -5720,6 +5869,30 @@ function refine(fn, _params = {}) {
 function superRefine(fn, params) {
   return _superRefine(fn, params);
 }
+// ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/coerce.js
+var exports_coerce = {};
+__export(exports_coerce, {
+  bigint: () => bigint2,
+  boolean: () => boolean3,
+  date: () => date2,
+  number: () => number3,
+  string: () => string3
+});
+function string3(params) {
+  return _coercedString(ZodString, params);
+}
+function number3(params) {
+  return _coercedNumber(ZodNumber, params);
+}
+function boolean3(params) {
+  return _coercedBoolean(ZodBoolean, params);
+}
+function bigint2(params) {
+  return _coercedBigint(ZodBigInt, params);
+}
+function date2(params) {
+  return _coercedDate(ZodDate, params);
+}
 // ../../packages/contracts/src/index.ts
 var accountDomain = "crabcloud.cc";
 var adminDomain = `admin.${accountDomain}`;
@@ -5773,6 +5946,8 @@ var apiErrorSchema = object({
     "expired",
     "insufficient_credits",
     "payload_too_large",
+    "collab_space_not_bound",
+    "collab_space_mismatch",
     "internal"
   ]),
   message: string2()
@@ -5827,7 +6002,8 @@ var sessionSummarySchema = object({
 });
 var deviceStartInput = object({
   name: string2().trim().min(1).max(80),
-  scopes: array(_enum(scopes)).min(1).max(scopes.length)
+  scopes: array(_enum(scopes)).min(1).max(scopes.length),
+  space: string2().trim().min(1).max(80).optional()
 });
 var devicePollInput = object({ deviceCode: string2().min(16).max(200) });
 var deviceDecisionInput = object({
@@ -5839,6 +6015,7 @@ var agentTokenSummarySchema = object({
   id: string2(),
   name: string2(),
   scopes: array(_enum(scopes)),
+  collabSpace: string2().nullable().optional(),
   createdAt: number2(),
   lastUsedAt: number2().nullable(),
   expiresAt: number2().nullable(),
@@ -5886,6 +6063,13 @@ var adminPlanTierUpdateInput = object({
   quotaJson: record(string2(), unknown()).optional(),
   status: _enum(adminPlanTierStatuses).optional()
 });
+var subscriptionChangeInput = object({
+  tierId: string2().trim().min(1).max(50)
+});
+var adminUserSubscriptionInput = object({
+  tierId: string2().trim().min(1).max(50),
+  reason: string2().trim().min(1).max(500)
+});
 var giftFulfillments = ["stock", "webhook"];
 var giftMerchantStatuses = ["active", "disabled"];
 var giftProductStatuses = ["draft", "live", "delisted"];
@@ -5990,6 +6174,49 @@ var contactQueryInput = object({
   limit: number2().int().min(1).max(50).default(20),
   offset: number2().int().min(0).default(0)
 });
+var collabTaskStatuses = ["open", "done"];
+var collabBoostKinds = ["tasks", "members"];
+var COLLAB_RECORD_BODY_MAX = 20000;
+var COLLAB_RECORD_FILES_MAX = 10;
+var COLLAB_RECORD_LINKS_MAX = 10;
+var COLLAB_TITLE_MAX = 200;
+var COLLAB_SPACE_NAME_MAX = 64;
+var COLLAB_SUMMARY_MAX = 2000;
+var collabCreateSpaceInput = object({
+  name: string2().trim().min(1).max(COLLAB_SPACE_NAME_MAX),
+  allocationBytes: number2().int().min(1).max(10 * 1024 * 1024 * 1024).optional()
+});
+var collabRenameSpaceInput = object({ name: string2().trim().min(1).max(COLLAB_SPACE_NAME_MAX) });
+var collabAllocationInput = object({
+  allocationBytes: number2().int().min(1).max(10 * 1024 * 1024 * 1024)
+});
+var collabBoostInput = object({ kind: _enum(collabBoostKinds) });
+var collabInviteInput = object({ username: usernameSchema });
+var collabLinkInput = string2().trim().url().max(2000);
+var collabCreateTaskInput = object({
+  title: string2().trim().min(1).max(COLLAB_TITLE_MAX),
+  body: string2().max(COLLAB_RECORD_BODY_MAX).default(""),
+  fileIds: array(string2().trim().min(1).max(64)).max(COLLAB_RECORD_FILES_MAX).optional(),
+  links: array(collabLinkInput).max(COLLAB_RECORD_LINKS_MAX).optional()
+});
+var collabPushRecordInput = object({
+  body: string2().min(1).max(COLLAB_RECORD_BODY_MAX),
+  fileIds: array(string2().trim().min(1).max(64)).max(COLLAB_RECORD_FILES_MAX).optional(),
+  links: array(collabLinkInput).max(COLLAB_RECORD_LINKS_MAX).optional()
+});
+var collabUpdateSummaryInput = object({
+  summary: string2().trim().max(COLLAB_SUMMARY_MAX)
+});
+var collabTaskListQuery = object({
+  status: _enum(collabTaskStatuses).optional(),
+  q: string2().trim().max(200).optional(),
+  cursor: string2().trim().max(200).optional(),
+  limit: exports_coerce.number().int().min(1).max(100).optional()
+});
+var collabRecordListQuery = object({
+  cursor: string2().trim().max(200).optional(),
+  limit: exports_coerce.number().int().min(1).max(200).optional()
+});
 
 // ../../packages/cloudkit/src/crypto.ts
 var enc = new TextEncoder;
@@ -6309,6 +6536,9 @@ function requireCredentials() {
 function formatTime(ms) {
   return new Date(ms).toLocaleString("sv", { year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
 }
+function fmtCredits(cents) {
+  return cents.toLocaleString("en-US");
+}
 var usage = `crab — Crab Cloud CLI（Agent-first 入口）
 发布物经 npm 分发：npx @crabcloud/cli <command>（全局安装后短名 crab 等价）
 
@@ -6371,6 +6601,10 @@ var usage = `crab — Crab Cloud CLI（Agent-first 入口）
   storage categories [--json]        分类列表
   storage mkcat <名称>               新建分类
   storage tags [--json]              标签汇总
+  credits [--json]                   积分余额（月送/充值/合计；需 credits.read scope）
+  credits history [--limit N] [--offset N] [--json]
+                                     积分流水（变动 ±：消耗为负；需 credits.read）
+  credits pricing [--json]           动作计价标准（公开：动作单价/档位/充值包）
   skills install|list|uninstall [--agent claude,zcode,codex,agents]
                        skills 管理（claude/zcode/agents 复制目录，codex 写 AGENTS.md 段）
   logout               撤销当前 Agent Token 并清除本地凭证
@@ -6473,11 +6707,105 @@ async function whoami() {
   if (subscription)
     console.log(`  订阅: ${subscription.tier_name}`);
   if (credits !== undefined)
-    console.log(`  积分余额: $${(credits / 100).toFixed(2)} (${credits} credit_cents)`);
+    console.log(`  积分余额: ${fmtCredits(credits)} 积分`);
   if (apps?.length)
     console.log(`  已启用应用: ${apps.map((a) => a.title).join("、")}`);
   return 0;
 }
+var CREDIT_REASON_LABELS = {
+  subscription_grant: "月送发放",
+  topup: "充值入账",
+  consume: "动作消耗",
+  refund: "退款",
+  adjustment: "人工调整"
+};
+var CREDIT_ACTION_LABELS = {
+  "mail.send_outbound": "外部出站邮件",
+  "collab.space_create": "创建独立协作空间",
+  "collab.boost_tasks": "协作任务扩容（+20）",
+  "collab.boost_members": "协作成员扩容（+5）"
+};
+function creditMovement(entry) {
+  if (entry.grantedDelta === null && entry.topupDelta === null)
+    return entry.delta;
+  return (entry.grantedDelta ?? 0) + (entry.topupDelta ?? 0);
+}
+async function fetchCredits(credentials, limit, offset) {
+  const res = await api2(credentials.apiBase, `/v1/me/credits?limit=${limit}&offset=${offset}`, { headers: authHeaders(credentials) });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取积分数据失败。"));
+    if (res.body?.error?.code === "scope_denied") {
+      console.error("提示：积分命令需要 credits.read scope——运行 crab login --scopes account 重新授权。");
+    }
+    return exitCodeForApiError(res.body);
+  }
+  return res.body.data;
+}
+async function creditsBalance() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const data = await fetchCredits(credentials, 1, 0);
+  if (typeof data === "number")
+    return data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data.balance, null, 2));
+    return 0;
+  }
+  console.log(`积分余额：${fmtCredits(data.balance.balance)}`);
+  console.log(`  月送 ${fmtCredits(data.balance.granted)}（每周期刷新清零） · 充值 ${fmtCredits(data.balance.topup)}（长期有效）`);
+  return 0;
+}
+async function creditsHistory() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const limit = Math.min(Math.max(Number.parseInt(readFlag("--limit") ?? "", 10) || 20, 1), 100);
+  const offset = Math.max(Number.parseInt(readFlag("--offset") ?? "", 10) || 0, 0);
+  const data = await fetchCredits(credentials, limit, offset);
+  if (typeof data === "number")
+    return data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+  }
+  if (data.ledger.length === 0) {
+    console.log("还没有积分流水。");
+    return 0;
+  }
+  for (const entry of data.ledger) {
+    const movement = creditMovement(entry);
+    const signed = movement > 0 ? `+${fmtCredits(movement)}` : fmtCredits(movement);
+    console.log(`${formatTime(entry.createdAt)}  ${CREDIT_REASON_LABELS[entry.reason] ?? entry.reason}  ${signed}`);
+  }
+  console.log(`
+共 ${fmtCredits(data.total)} 条（本页 ${data.ledger.length} 条，--offset 翻页）`);
+  return 0;
+}
+async function creditsPricing() {
+  const credentials = loadCredentials();
+  const apiBase = credentials ? credentials.apiBase : process.env.CRAB_API ?? readFlag("--api") ?? DEFAULT_API;
+  const res = await api2(apiBase, "/v1/pricing/standard");
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取动作计价失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const actions = res.body.data?.actions ?? [];
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(res.body.data, null, 2));
+    return 0;
+  }
+  if (actions.length === 0) {
+    console.log("暂无动作计价项。");
+    return 0;
+  }
+  console.log("动作计价（credit_cents，100 = $1.00）：");
+  for (const item of actions) {
+    const label = CREDIT_ACTION_LABELS[item.action] ?? item.action;
+    console.log(`  ${item.action.padEnd(24)} ${label}  ${fmtCredits(item.creditCents)} 积分`);
+  }
+  return 0;
+}
 async function tokensList() {
   const credentials = requireCredentials();
   if (typeof credentials === "number")
@@ -6752,7 +7080,7 @@ async function mailSend() {
   if (attachmentIds.length > 0)
     console.log(`  附件 ${attachmentIds.length} 个（云盘引用，不复制）`);
   if (result.chargedCredits > 0)
-    console.log(`  消耗积分：$${(result.chargedCredits / 100).toFixed(2)}（${result.chargedCredits} credit_cents）`);
+    console.log(`  消耗积分：${fmtCredits(result.chargedCredits)}`);
   if (result.failedExternal > 0)
     console.log(`  ⚠ ${result.failedExternal} 个外部收件人发送失败，对应积分已退回`);
   return 0;
@@ -7704,6 +8032,19 @@ switch (command) {
       process.exit(await storageUnshare(args[2]));
     console.error(sub ? `未知子命令：storage ${sub}
 ` : `缺少子命令：storage ls | upload | download | rename | tag | category | publish | unpublish | rm | restore | purge | quota | categories | mkcat | tags | share | shares | unshare
+`);
+    console.log(usage);
+    process.exit(EXIT_USAGE);
+  }
+  case "credits": {
+    const sub = args[1];
+    if (!sub || sub === "balance")
+      process.exit(await creditsBalance());
+    if (sub === "history")
+      process.exit(await creditsHistory());
+    if (sub === "pricing")
+      process.exit(await creditsPricing());
+    console.error(`未知子命令：credits ${sub}
 `);
     console.log(usage);
     process.exit(EXIT_USAGE);

package/dist/skills/crabcloud/SKILL.md

@@ -30,6 +30,9 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
 |---|---|
 | 看账号身份 / 订阅 / 积分 | `crab whoami` |
 | 程序化读取身份 | `crab whoami --json` |
+| 积分余额（月送/充值/合计） | `crab credits`（需 `credits.read`，脚本消费加 `--json`） |
+| 积分流水（花了多少、花在哪） | `crab credits history [--limit N] [--offset N]`（变动 ±：消耗为负；`--json` 含 total） |
+| 查动作计价（如发一封外域邮件扣多少） | `crab credits pricing`（公开端点，无需登录） |
 | 列出已授权的 Agent 令牌 | `crab tokens list`（脚本消费加 `--json`） |
 | 撤销某个令牌（高危，先确认） | `crab tokens revoke <id>` |
 | 重新授权 / 调整 scope | `crab login --scopes mail`（组名整组授权；也可单 scope 如 `mail.read`。浏览器确认，你只发起） |
@@ -39,6 +42,10 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
 | 我的邀请码、邀请链接与受邀名单 | `crab contacts invite [--reset]` / `crab contacts invitees` |
 | 管理登录设备 / 会话、修改密码 | 网页个人中心（crabcloud.cc/account）——CLI 有意不开放 |
 
+积分命令需 `credits.read` scope（`account` 组含它）：退出码 4 报缺该 scope 时，
+引导 `crab login --scopes account` 重新授权。积分额度一律以**积分数**表述
+（100 积分 = $1.00，仅价格类口径用美元）；充值/下单是 Web 会话能力，CLI/Agent
+令牌不动账——用户要充值时引导网页账单页（crabcloud.cc/account/billing）。
 拿不准令牌 id 时先 `crab tokens list` 核对；`revoke` 只接受列表里的 id。
 
 ## 机器可读输出

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@crabcloud/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
-  "description": "Crab Cloud CLI (crab) — agent-first entry to your personal cloud, with skills bundled for Claude Code / Codex / ZCode.",
+  "description": "Crab Cloud CLI (crab) \u2014 agent-first entry to your personal cloud, with skills bundled for Claude Code / Codex / ZCode.",
   "bin": {
     "crab": "dist/crab.js"
   },