@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.09899c4

package/dist/api/deploy/schemas.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = void 0;
+exports.nodeStatusText = nodeStatusText;
+exports.nodeStatusFromText = nodeStatusFromText;
+const output_1 = require("../../utils/output");
+const types_1 = require("./types");
+const NODE_STATUS_TEXT = {
+    [types_1.NodeStatus.UNSPECIFIED]: 'unknown',
+    [types_1.NodeStatus.TODO]: 'todo',
+    [types_1.NodeStatus.RUNNING]: 'running',
+    [types_1.NodeStatus.SUCCESS]: 'success',
+    [types_1.NodeStatus.FAILED]: 'failed',
+    [types_1.NodeStatus.CANCELED]: 'canceled',
+    [types_1.NodeStatus.HOLD_ON]: 'hold_on',
+};
+function nodeStatusText(v) {
+    if (typeof v === 'string')
+        return v;
+    if (typeof v !== 'number')
+        return undefined;
+    return NODE_STATUS_TEXT[v];
+}
+/** NodeStatus 文本（CLI flag 字符串）→ 枚举数值 */
+function nodeStatusFromText(text) {
+    const lower = text.toLowerCase();
+    for (const [num, label] of Object.entries(NODE_STATUS_TEXT)) {
+        if (label === lower)
+            return Number(num);
+    }
+    return undefined;
+}
+function pipelineDurationMs(row) {
+    // SimpleInstance.createdAt / updatedAt：BAM IDL 未注单位，e2e 看是 ms。
+    const start = Number(row.createdAt);
+    const end = Number(row.updatedAt);
+    if (!Number.isFinite(start) || !Number.isFinite(end))
+        return undefined;
+    return end - start;
+}
+/**
+ * deploy history 列表的 pretty 渲染契约。
+ *
+ * BAM 返回 SimpleInstance（pipeline 实例），状态走 NodeStatus。
+ * 默认列：deploy-id（=ID）/ status / creator / created-at / duration（updatedAt-createdAt）。
+ */
+exports.deployHistorySchema = {
+    columns: [
+        { key: 'ID', label: 'deploy-id' },
+        {
+            key: 'status_text',
+            label: 'status',
+            derive: (row) => nodeStatusText(row.status),
+        },
+        { key: 'creator', label: 'creator' },
+        { key: 'createdAt', label: 'created-at', format: output_1.fmt.ms() },
+        {
+            key: 'duration',
+            label: 'duration',
+            format: output_1.fmt.durationMs(),
+            derive: pipelineDurationMs,
+        },
+    ],
+    strict: true,
+};
+/**
+ * deploy get 单条详情的 key-value 渲染契约（基于 SimpleInstance）。
+ *
+ * 由于 BAM 没有 by-ID 的查询接口，handler 用 listPipelineInstances 在最近窗口
+ * 里筛一条 SimpleInstance 透传过来。
+ */
+exports.deployGetSchema = {
+    columns: [
+        { key: 'ID', label: 'deploy-id' },
+        {
+            key: 'status_text',
+            label: 'status',
+            derive: (row) => nodeStatusText(row.status),
+        },
+        { key: 'creator', label: 'creator' },
+        { key: 'updater', label: 'updater' },
+        { key: 'createdAt', label: 'created-at', format: output_1.fmt.ms() },
+        { key: 'updatedAt', label: 'updated-at', format: output_1.fmt.ms() },
+        {
+            key: 'duration',
+            label: 'duration',
+            format: output_1.fmt.durationMs(),
+            derive: pipelineDurationMs,
+        },
+        { key: 'templateID', label: 'template' },
+        { key: 'description' },
+        { key: 'parameters' },
+        { key: 'envVariables', label: 'env-vars' },
+    ],
+    strict: true,
+};
+/** deploy error-log 表格渲染契约 */
+exports.errorJobSchema = {
+    columns: [
+        { key: 'jobID', label: 'job-id' },
+        { key: 'componentName', label: 'component' },
+        { key: 'errorMsg', label: 'error' },
+    ],
+    strict: true,
+};

package/dist/api/deploy/types.js

@@ -0,0 +1,22 @@
+"use strict";
+// 与 BAM lark.apaas.devops v1.0.326 / 1.0.327 + lark.apaas.devops_platform v1.0.247 对齐：
+//   - CLICreateForceRelease       (4070318)  创建发布          lark.apaas.devops
+//   - CliQueryPipelineInstance    (4069872)  轮询发布状态      lark.apaas.devops_platform
+//   - CliListPipelineInstances    (4073969)  分页获取发布历史  lark.apaas.devops_platform
+//   - CliGetToolInstanceErrorJobs (4073972)  获取发布错误日志  lark.apaas.devops_platform
+//
+// 发布单的唯一标识是 pipelineTaskID，对外即 deploy-id；error-log 等接口直接用它做
+// URL 路径段（instanceID）。曾经的 Release/releaseID 概念已全面废弃。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeStatus = void 0;
+/** Pipeline 节点状态（devops_platform） */
+var NodeStatus;
+(function (NodeStatus) {
+    NodeStatus[NodeStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    NodeStatus[NodeStatus["TODO"] = 1] = "TODO";
+    NodeStatus[NodeStatus["RUNNING"] = 2] = "RUNNING";
+    NodeStatus[NodeStatus["SUCCESS"] = 3] = "SUCCESS";
+    NodeStatus[NodeStatus["FAILED"] = 4] = "FAILED";
+    NodeStatus[NodeStatus["CANCELED"] = 5] = "CANCELED";
+    NodeStatus[NodeStatus["HOLD_ON"] = 6] = "HOLD_ON";
+})(NodeStatus || (exports.NodeStatus = NodeStatus = {}));

package/dist/api/file/api.js

@@ -8,8 +8,10 @@ exports.uploadFile = uploadFile;
 exports.signDownload = signDownload;
 exports.downloadFile = downloadFile;
 exports.deleteFiles = deleteFiles;
+exports.getStorageQuota = getStorageQuota;
 const error_1 = require("../../utils/error");
 const logger_1 = require("../../utils/logger");
+const time_1 = require("../../utils/time");
 const client_1 = require("./client");
 const detect_1 = require("./detect");
 const parsers_1 = require("./parsers");
@@ -19,18 +21,18 @@ const parsers_1 = require("./parsers");
  * 所有进入 API 层的 path 都要 strip 前导 `/`。
  */
 function toApiPath(filePath) {
-    return filePath.replace(/^\/+/, "");
+    return filePath.replace(/^\/+/, '');
 }
 function encodePath(filePath) {
     return toApiPath(filePath)
-        .split("/")
+        .split('/')
         .map((seg) => encodeURIComponent(seg))
-        .join("/");
+        .join('/');
 }
 function extractEnvelope(body) {
     (0, client_1.ensureSuccess)(body);
     if (!body.data) {
-        throw new error_1.AppError("INTERNAL_FILE_API_ERROR", "API returned empty data");
+        throw new error_1.AppError('INTERNAL_FILE_API_ERROR', 'API returned empty data');
     }
     return body.data;
 }
@@ -49,7 +51,7 @@ async function listOnce(appId, bucketId, opts) {
     if (opts.sortBy && opts.sortBy.length > 0)
         reqBody.sortBy = opts.sortBy;
     const body = await (0, client_1.doPost)(url, reqBody, {
-        errorContext: "list files",
+        errorContext: 'list files',
     });
     return extractEnvelope(body);
 }
@@ -70,29 +72,29 @@ function buildFilterExpr(opts) {
         return opts.filterExpr;
     const conds = [];
     if (opts.name) {
-        conds.push({ field: "name", operator: "eq", value: opts.name });
+        conds.push({ field: 'name', operator: 'eq', value: opts.name });
     }
     if (opts.type) {
-        conds.push({ field: "type", operator: "eq", value: opts.type });
+        conds.push({ field: 'type', operator: 'eq', value: opts.type });
     }
     if (opts.sizeGt !== undefined) {
-        conds.push({ field: "size", operator: "gt", value: String(opts.sizeGt) });
+        conds.push({ field: 'size', operator: 'gt', value: String(opts.sizeGt) });
     }
     if (opts.sizeLt !== undefined) {
-        conds.push({ field: "size", operator: "lt", value: String(opts.sizeLt) });
+        conds.push({ field: 'size', operator: 'lt', value: String(opts.sizeLt) });
     }
     if (opts.uploadedSince) {
         // 后端期望毫秒 timestamp（strconv.ParseInt → time.UnixMilli）
-        const ms = parseTimeFilterMs(opts.uploadedSince, "--uploaded-since");
-        conds.push({ field: "createdAt", operator: "gte", value: String(ms) });
+        const ms = parseTimeFilterMs(opts.uploadedSince, '--uploaded-since');
+        conds.push({ field: 'createdAt', operator: 'gte', value: String(ms) });
     }
     if (opts.uploadedUntil) {
-        const ms = parseTimeFilterMs(opts.uploadedUntil, "--uploaded-until");
-        conds.push({ field: "createdAt", operator: "lte", value: String(ms) });
+        const ms = parseTimeFilterMs(opts.uploadedUntil, '--uploaded-until');
+        conds.push({ field: 'createdAt', operator: 'lte', value: String(ms) });
     }
     if (conds.length === 0)
         return undefined;
-    return { logic: "and", groups: [{ conditions: conds }] };
+    return { logic: 'and', groups: [{ conditions: conds }] };
 }
 /**
  * 解析时间过滤参数（--uploaded-since / --uploaded-until）的三种输入格式
@@ -107,31 +109,17 @@ function buildFilterExpr(opts) {
  * flagName 用于错误信息，调用方传 "--uploaded-since" 或 "--uploaded-until"。
  */
 function parseTimeFilterMs(input, flagName) {
-    // 相对时间：<positive int><unit>，单位 s/m/h/d/w
-    const RELATIVE = /^(\d+)([smhdw])$/;
-    const rel = RELATIVE.exec(input);
-    if (rel) {
-        const n = parseInt(rel[1], 10);
-        if (n <= 0) {
-            throw new error_1.AppError("ARGS_INVALID", `${flagName} "${input}" 必须是正整数 + 单位（s / m / h / d / w）`);
-        }
-        const UNIT_MS = {
-            s: 1_000,
-            m: 60_000,
-            h: 3_600_000,
-            d: 86_400_000,
-            w: 604_800_000,
-        };
-        return Date.now() - n * UNIT_MS[rel[2]];
+    try {
+        return (0, time_1.parseTimeToMs)(input);
     }
-    // 绝对时间：date / ISO 8601。Date.parse 对 "YYYY-MM-DD" 按 UTC 00:00:00 解析，
-    // 对带 Z 的 ISO 8601 也直接出 UTC ms。
-    const ms = Date.parse(input);
-    if (Number.isNaN(ms)) {
-        throw new error_1.AppError("ARGS_INVALID", `${flagName} "${input}" 格式无法识别。支持：` +
-            `相对时间（如 1h / 2d / 1w）、日期（YYYY-MM-DD）、ISO 8601（如 2026-04-01T10:00:00Z）`);
+    catch (err) {
+        if (err instanceof error_1.AppError) {
+            throw new error_1.AppError(err.code, `${flagName}: ${err.message}`, {
+                next_actions: err.next_actions,
+            });
+        }
+        throw err;
     }
-    return ms;
 }
 /**
  * 列出文件：所有过滤下推到后端 FilterExpression，纯精确匹配，无 glob。
@@ -147,7 +135,7 @@ async function listFiles(opts) {
     let hasMore = false;
     // 分页 cursor 用 raw attachment.id（后端 continuationToken 语义）；
     // CLI 对外不暴露 attachment.id，所以这里单独追踪最后一页的 raw id
-    let lastRawId = "";
+    let lastRawId = '';
     for (;;) {
         const fetchLimit = opts.all ? 200 : pageSize;
         const data = await listOnce(opts.appId, bucketId, {
@@ -159,7 +147,7 @@ async function listFiles(opts) {
         const rawItems = data.attachments ?? [];
         hasMore = Boolean(data.hasMore);
         if (rawItems.length > 0) {
-            lastRawId = rawItems[rawItems.length - 1].id ?? "";
+            lastRawId = rawItems[rawItems.length - 1].id ?? '';
         }
         for (const raw of rawItems) {
             const info = (0, parsers_1.parseAttachment)(raw);
@@ -208,8 +196,8 @@ async function resolveInputs(opts) {
     if (opts.inputs.length === 0)
         return [];
     return Promise.all(opts.inputs.map((input) => {
-        const kind = opts.forceAs ?? ((0, detect_1.looksLikePath)(input) ? "path" : "name");
-        return kind === "path" ? resolveByPath(opts.appId, input) : resolveByName(opts.appId, input);
+        const kind = opts.forceAs ?? ((0, detect_1.looksLikePath)(input) ? 'path' : 'name');
+        return kind === 'path' ? resolveByPath(opts.appId, input) : resolveByName(opts.appId, input);
     }));
 }
 /** path 输入：HEAD 判存在性，path 在 bucket 内 unique 无需反查。 */
@@ -218,17 +206,17 @@ async function resolveByPath(appId, input) {
     const filePath = (0, detect_1.toAbsolutePath)(input);
     try {
         const info = await statFile({ appId, filePath });
-        return { status: "ok", input, file: info };
+        return { status: 'ok', input, file: info };
     }
     catch (err) {
-        if (err instanceof error_1.AppError && err.code === "FILE_NOT_FOUND") {
+        if (err instanceof error_1.AppError && err.code === 'FILE_NOT_FOUND') {
             return {
-                status: "error",
+                status: 'error',
                 input,
                 error: {
-                    code: "FILE_NOT_FOUND",
+                    code: 'FILE_NOT_FOUND',
                     message: `File '${input}' does not exist`,
-                    hint: "Run `miaoda file ls` to see available files.",
+                    hint: 'Run `miaoda file ls` to see available files.',
                 },
             };
         }
@@ -238,38 +226,38 @@ async function resolveByPath(appId, input) {
 /** file_name 输入：list + FilterExpression `name eq X`，多匹配 AMBIGUOUS。 */
 async function resolveByName(appId, input) {
     const filterExpr = {
-        logic: "and",
-        groups: [{ conditions: [{ field: "name", operator: "eq", value: input }] }],
+        logic: 'and',
+        groups: [{ conditions: [{ field: 'name', operator: 'eq', value: input }] }],
     };
     const result = await listFiles({ appId, filterExpr, limit: 200 });
     // 后端返 name 精确匹配的所有 attachments。basename fallback 防御（后端某些场景 name 可能为空）
     const matches = result.items.filter((i) => {
-        const basename = i.path.split("/").pop() ?? i.path;
+        const basename = i.path.split('/').pop() ?? i.path;
         return i.file_name === input || basename === input;
     });
     if (matches.length === 0) {
         return {
-            status: "error",
+            status: 'error',
             input,
             error: {
-                code: "FILE_NOT_FOUND",
+                code: 'FILE_NOT_FOUND',
                 message: `File '${input}' does not exist`,
-                hint: "Run `miaoda file ls` to see available files.",
+                hint: 'Run `miaoda file ls` to see available files.',
             },
         };
     }
     if (matches.length > 1) {
         return {
-            status: "error",
+            status: 'error',
             input,
             error: {
-                code: "AMBIGUOUS_FILE_NAME",
+                code: 'AMBIGUOUS_FILE_NAME',
                 message: `Multiple files match name '${input}' (${String(matches.length)} found)`,
                 hint: `Use path instead. Run \`miaoda file ls --name ${input}\` to see candidates.`,
             },
         };
     }
-    return { status: "ok", input, file: matches[0] };
+    return { status: 'ok', input, file: matches[0] };
 }
 // ── stat ──
 /**
@@ -281,10 +269,10 @@ async function statFile(opts) {
     // 对齐 file-storage-skill Py 版：URL 顺序是 .../object/{bucket}/head/{path}
     const url = `/v1/storage/app/${encodeURIComponent(opts.appId)}/object/${encodeURIComponent(bucketId)}/head/${encodePath(opts.filePath)}`;
     const body = await (0, client_1.doGet)(url, {
-        notFoundCode: "FILE_NOT_FOUND",
+        notFoundCode: 'FILE_NOT_FOUND',
         notFoundMessage: `File '${opts.filePath}' does not exist`,
-        notFoundHint: "Run `miaoda file ls` to see available files.",
-        errorContext: "stat file",
+        notFoundHint: 'Run `miaoda file ls` to see available files.',
+        errorContext: 'stat file',
     });
     return (0, parsers_1.parseHead)(extractEnvelope(body), opts.filePath);
 }
@@ -292,7 +280,7 @@ async function statFile(opts) {
 async function preUpload(appId, req) {
     const bucketId = await (0, client_1.getDefaultBucketId)(appId);
     const url = `/v1/storage/app/${encodeURIComponent(appId)}/bucket/${encodeURIComponent(bucketId)}/preUpload`;
-    const body = await (0, client_1.doPost)(url, { bucketID: bucketId, appID: appId, ...req }, { errorContext: "pre-upload" });
+    const body = await (0, client_1.doPost)(url, { bucketID: bucketId, appID: appId, ...req }, { errorContext: 'pre-upload' });
     return extractEnvelope(body);
 }
 /**
@@ -308,14 +296,14 @@ async function preUpload(appId, req) {
 async function uploadCallback(appId, req) {
     const url = `/v1/storage/app/${encodeURIComponent(appId)}/object/callback`;
     const body = await (0, client_1.doPost)(url, req, {
-        errorContext: "upload callback",
+        errorContext: 'upload callback',
     });
     const data = extractEnvelope(body);
     const metadata = data.metadata;
     if (!metadata) {
         return {};
     }
-    if (typeof metadata === "object") {
+    if (typeof metadata === 'object') {
         return metadata;
     }
     // string 形态兜底
@@ -342,10 +330,10 @@ async function uploadFile(opts) {
         filePath: opts.remotePath ? toApiPath(opts.remotePath) : undefined,
     });
     if (!pre.uploadURL || !pre.uploadID) {
-        throw new error_1.AppError("FILE_UPLOAD_FAILED", "preUpload did not return uploadURL/uploadID");
+        throw new error_1.AppError('FILE_UPLOAD_FAILED', 'preUpload did not return uploadURL/uploadID');
     }
     const body = await opts.readFile();
-    let etag = "";
+    let etag = '';
     try {
         // Node 20+ 内置 fetch 运行时接受 Buffer，但 TS 的 BodyInit 要求更严格的类型；
         // 这里复制到独立 ArrayBuffer 以满足 lib.dom.d.ts 的 BodyInit 约束
@@ -355,27 +343,27 @@ async function uploadFile(opts) {
         // header 作为对象 metadata 存住，服务端 callback 阶段 HeadObject 读回并解析
         // filename 写入 DB。我们要不传 header，服务端走兜底会把 storage key 当文件名。
         const res = await fetch(pre.uploadURL, {
-            method: "PUT",
+            method: 'PUT',
             headers: {
-                "Content-Type": opts.contentType,
-                "Content-Length": String(opts.fileSize),
-                "Content-Disposition": `attachment; filename="${sanitizeFileName(opts.fileName)}"`,
+                'Content-Type': opts.contentType,
+                'Content-Length': String(opts.fileSize),
+                'Content-Disposition': `attachment; filename="${sanitizeFileName(opts.fileName)}"`,
             },
             body: ab,
         });
         (0, logger_1.debug)(`http PUT <upload-cdn> ${String(res.status)} cost=${String(Date.now() - uploadStart)}ms size=${String(opts.fileSize)}`);
         if (!res.ok) {
-            throw new error_1.AppError("FILE_UPLOAD_FAILED", `Upload PUT failed with status ${String(res.status)}`);
+            throw new error_1.AppError('FILE_UPLOAD_FAILED', `Upload PUT failed with status ${String(res.status)}`);
         }
-        etag = res.headers.get("ETag") ?? "";
+        etag = res.headers.get('ETag') ?? '';
     }
     catch (err) {
         if (err instanceof error_1.AppError)
             throw err;
-        throw new error_1.AppError("FILE_UPLOAD_FAILED", `Upload PUT failed: ${err instanceof Error ? err.message : String(err)}`);
+        throw new error_1.AppError('FILE_UPLOAD_FAILED', `Upload PUT failed: ${err instanceof Error ? err.message : String(err)}`);
     }
     if (!etag) {
-        throw new error_1.AppError("FILE_UPLOAD_FAILED", "Upload PUT returned no ETag");
+        throw new error_1.AppError('FILE_UPLOAD_FAILED', 'Upload PUT returned no ETag');
     }
     // callback 返回服务端实际生成的对象元数据（filePath / file_name / download_url）。
     // path 末段是平台生成的 16 位 GID，CLI 无法靠本地信息推断；callback 失败 /
@@ -389,20 +377,20 @@ async function uploadFile(opts) {
     }
     catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
-        throw new error_1.AppError("FILE_UPLOAD_CALLBACK_INCOMPLETE", `Upload callback failed: ${reason}; file may already exist in storage`, {
+        throw new error_1.AppError('FILE_UPLOAD_CALLBACK_INCOMPLETE', `Upload callback failed: ${reason}; file may already exist in storage`, {
             next_actions: [
                 `Run \`miaoda file ls --name ${opts.fileName}\` to locate the uploaded file.`,
             ],
         });
     }
     if (!metadata.filePath) {
-        throw new error_1.AppError("FILE_UPLOAD_CALLBACK_INCOMPLETE", "Upload callback returned no filePath; file may already exist in storage", {
+        throw new error_1.AppError('FILE_UPLOAD_CALLBACK_INCOMPLETE', 'Upload callback returned no filePath; file may already exist in storage', {
             next_actions: [
                 `Run \`miaoda file ls --name ${opts.fileName}\` to locate the uploaded file.`,
             ],
         });
     }
-    const path = metadata.filePath.startsWith("/") ? metadata.filePath : "/" + metadata.filePath;
+    const path = metadata.filePath.startsWith('/') ? metadata.filePath : '/' + metadata.filePath;
     const result = {
         // 优先取服务端 ObjectVO.name（来自 PUT 时带的 Content-Disposition），
         // 与后续 file ls / file stat 返回的展示名保持一致；缺失时降级用本地 fileName。
@@ -425,7 +413,7 @@ async function uploadFile(opts) {
  */
 function sanitizeFileName(fileName) {
     const illegalChars = /[:"\\/*?<>|,;]/g;
-    return encodeURIComponent(fileName.replace(illegalChars, "")) || "download_file";
+    return encodeURIComponent(fileName.replace(illegalChars, '')) || 'download_file';
 }
 // ── 预签下载 URL ──
 /**
@@ -441,15 +429,15 @@ async function signDownload(opts) {
         expiresIn: opts.expiresIn,
     };
     const body = await (0, client_1.doPost)(url, reqBody, {
-        errorContext: "sign download URL",
+        errorContext: 'sign download URL',
     });
     // 后端对不存在文件走业务 ErrorCode（status_code=k_img_ec_000034），
     // 由 ensureSuccess → BIZ_ERR_MAP 统一抛出 FILE_NOT_FOUND，此处无需兜底
     const data = extractEnvelope(body);
-    const signed = data.signedURL ?? "";
+    const signed = data.signedURL ?? '';
     const expiresAt = new Date(Date.now() + opts.expiresIn * 1000).toISOString();
-    const displayPath = opts.filePath.startsWith("/") ? opts.filePath : `/${opts.filePath}`;
-    const fileName = displayPath.split("/").pop() ?? displayPath;
+    const displayPath = opts.filePath.startsWith('/') ? opts.filePath : `/${opts.filePath}`;
+    const fileName = displayPath.split('/').pop() ?? displayPath;
     return {
         file_name: fileName,
         path: displayPath,
@@ -468,11 +456,11 @@ async function downloadFile(opts) {
     }
     catch (err) {
         (0, logger_1.debug)(`http GET <download-cdn> 0 cost=${String(Date.now() - downloadStart)}ms err=${err instanceof Error ? err.message : String(err)}`);
-        throw new error_1.AppError("FILE_DOWNLOAD_FAILED", `Download GET failed: ${err instanceof Error ? err.message : String(err)}`);
+        throw new error_1.AppError('FILE_DOWNLOAD_FAILED', `Download GET failed: ${err instanceof Error ? err.message : String(err)}`);
     }
     (0, logger_1.debug)(`http GET <download-cdn> ${String(res.status)} cost=${String(Date.now() - downloadStart)}ms`);
     if (!res.ok) {
-        throw new error_1.AppError("FILE_DOWNLOAD_FAILED", `Download failed with status ${String(res.status)}`);
+        throw new error_1.AppError('FILE_DOWNLOAD_FAILED', `Download failed with status ${String(res.status)}`);
     }
     const array = new Uint8Array(await res.arrayBuffer());
     const buf = Buffer.from(array);
@@ -492,17 +480,17 @@ async function deleteFiles(opts) {
         filePaths: opts.filePaths.map(toApiPath),
     };
     const body = await (0, client_1.doRequest)({
-        method: "DELETE",
+        method: 'DELETE',
         url,
-        headers: { "Content-Type": "application/json" },
+        headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify(reqBody),
-    }, { errorContext: "delete files" });
+    }, { errorContext: 'delete files' });
     const data = extractEnvelope(body);
     // 后端响应里只给出被删除成功的 attachments（无前导 /），没删掉的靠对比输入判断
-    const toDisplay = (p) => (p.startsWith("/") ? p : `/${p}`);
+    const toDisplay = (p) => (p.startsWith('/') ? p : `/${p}`);
     const deletedSet = new Set();
     for (const att of data.attachments ?? []) {
-        const p = att.filePath ?? att.name ?? "";
+        const p = att.filePath ?? att.name ?? '';
         if (p)
             deletedSet.add(toApiPath(p));
     }
@@ -514,8 +502,22 @@ async function deleteFiles(opts) {
             deleted.push(toDisplay(normalized));
         }
         else {
-            failed.push({ path: toDisplay(normalized), error: "file not found or not deleted" });
+            failed.push({ path: toDisplay(normalized), error: 'file not found or not deleted' });
         }
     }
     return { deleted, failed };
 }
+// ── storage quota ──
+/**
+ * 后端：GET /v1/storage/app/{appId}/bucket/{bucketId}/quota
+ * 单 bucket 用量；StorageQuotaBytes 暂未对接，CLI 拿到 0 时按 "—" 渲染。
+ * bucketId 缺省时走默认 bucket（与 ls / stat / cp 等一致）。
+ */
+async function getStorageQuota(opts) {
+    const bucketId = opts.bucketId ?? (await (0, client_1.getDefaultBucketId)(opts.appId));
+    const url = `/v1/storage/app/${encodeURIComponent(opts.appId)}/bucket/${encodeURIComponent(bucketId)}/quota`;
+    const body = await (0, client_1.doGet)(url, {
+        errorContext: `fetch storage quota for app '${opts.appId}' bucket '${bucketId}'`,
+    });
+    return extractEnvelope(body);
+}