@lark-apaas/miaoda-cli 0.1.2 → 0.1.3

package/README.md

@@ -14,22 +14,22 @@ pnpm add -g @lark-apaas/miaoda-cli
 # 设置默认应用（需要应用上下文的命令可用 --app-id 覆盖）
 export MIAODA_APP_ID=app_demo_xxx
 
-# 插件管理
-miaoda plugin list-packages
-miaoda plugin install @demo/example-plugin
+# 文件操作
+miaoda file ls
+miaoda file upload ./local/path
 ```
 
 JSON 结构化输出（Agent 推荐）：
 
 ```bash
 # 输出全部字段
-miaoda plugin list --json
+miaoda file ls --json
 
 # 可选字段级选择
-miaoda plugin list --json id,name
+miaoda file ls --json id,name
 
 # 或通过 --output 指定格式
-miaoda plugin list --output json
+miaoda file ls --output json
 ```
 
 ## 命令树
@@ -38,7 +38,8 @@ miaoda plugin list --output json
 
 | 域 | 用途 |
 |---|---|
-| `miaoda plugin ...` | 插件管理：安装、更新、移除、插件实例查询 |
+| `miaoda file ...` | 文件操作：上传、下载、元数据、签名下载、批量删除 |
+| `miaoda db ...` | 数据操作：SQL 执行、表结构查询、数据导入导出 |
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
 

package/dist/api/app/api.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAppInfo = getAppInfo;
+exports.updateAppMeta = updateAppMeta;
+const http_1 = require("../../utils/http");
+const devops_error_1 = require("../../utils/devops-error");
+const DEFAULT_ERR_CODE = "INTERNAL_DEVOPS_ERROR";
+function envelopeOpts(errPrefix) {
+    return {
+        errPrefix,
+        defaultErrCode: DEFAULT_ERR_CODE,
+        mapErr: devops_error_1.mapDevopsError,
+    };
+}
+/** GET /v1/devops/app/:appID — 获取应用详情 */
+async function getAppInfo(appID) {
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}`;
+    return (0, http_1.getInnerApi)(url, envelopeOpts("Failed to get app info"));
+}
+/** POST /v1/devops/app/:appID/meta — 更新应用元数据 */
+async function updateAppMeta(req) {
+    const url = `/v1/devops/app/${encodeURIComponent(req.appID)}/meta`;
+    // 路径已带 appID，body 里也保留以匹配 BAM IDL 的 sensitive:"no" 透传约定
+    return (0, http_1.postInnerApi)(url, req, envelopeOpts("Failed to update app"));
+}

package/dist/api/app/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchType = exports.Source = exports.BizType = exports.AppType = exports.AppMode = exports.AppStatus = exports.appMetaSchema = exports.updateAppMeta = exports.getAppInfo = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "getAppInfo", { enumerable: true, get: function () { return api_1.getAppInfo; } });
+Object.defineProperty(exports, "updateAppMeta", { enumerable: true, get: function () { return api_1.updateAppMeta; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "appMetaSchema", { enumerable: true, get: function () { return schemas_1.appMetaSchema; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "AppStatus", { enumerable: true, get: function () { return types_1.AppStatus; } });
+Object.defineProperty(exports, "AppMode", { enumerable: true, get: function () { return types_1.AppMode; } });
+Object.defineProperty(exports, "AppType", { enumerable: true, get: function () { return types_1.AppType; } });
+Object.defineProperty(exports, "BizType", { enumerable: true, get: function () { return types_1.BizType; } });
+Object.defineProperty(exports, "Source", { enumerable: true, get: function () { return types_1.Source; } });
+Object.defineProperty(exports, "ArchType", { enumerable: true, get: function () { return types_1.ArchType; } });

package/dist/api/app/schemas.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appMetaSchema = void 0;
+const output_1 = require("../../utils/output");
+const types_1 = require("./types");
+// Partial<Record<...>>：未来 BAM 加新枚举值时这里没声明也不报错，运行期 lookup 自然得 undefined
+const STATUS_TEXT = {
+    [types_1.AppStatus.UNSPECIFIED]: "unknown",
+    [types_1.AppStatus.PREPARING]: "preparing",
+    [types_1.AppStatus.UNRELEASED]: "unreleased",
+    [types_1.AppStatus.RELEASED]: "released",
+    [types_1.AppStatus.DELETED]: "deleted",
+    [types_1.AppStatus.UPGRADING]: "upgrading",
+};
+const MODE_TEXT = {
+    [types_1.AppMode.UNSPECIFIED]: "unknown",
+    [types_1.AppMode.STANDARD]: "standard",
+    [types_1.AppMode.EXPERT]: "expert",
+};
+const TYPE_TEXT = {
+    [types_1.AppType.UNSPECIFIED]: "unknown",
+    [types_1.AppType.STANDARD]: "standard",
+    [types_1.AppType.PROTOTYPE]: "prototype",
+    [types_1.AppType.APPLICATION]: "application",
+    [types_1.AppType.DESIGN]: "design",
+    [types_1.AppType.OPENCLAW]: "openclaw",
+    [types_1.AppType.CLAW_SUB]: "claw_sub",
+};
+const BIZ_TYPE_TEXT = {
+    [types_1.BizType.UNSPECIFIED]: "unknown",
+    [types_1.BizType.MIAODA]: "miaoda",
+    [types_1.BizType.FORCE]: "force",
+};
+const ARCH_TYPE_TEXT = {
+    [types_1.ArchType.UNSPECIFIED]: "unknown",
+    [types_1.ArchType.FULL_STACK]: "full_stack",
+    [types_1.ArchType.NOT_FULL_STACK]: "not_full_stack",
+};
+const SOURCE_TEXT = {
+    [types_1.Source.UNSPECIFIED]: "unknown",
+    [types_1.Source.CHAT]: "chat",
+    [types_1.Source.TEMPLATE]: "template",
+    [types_1.Source.IMPORT_ZIP]: "import_zip",
+    [types_1.Source.IMPORT_BASE]: "import_base",
+};
+function lookup(table) {
+    return (v) => {
+        if (typeof v !== "number")
+            return undefined;
+        return table[v];
+    };
+}
+/**
+ * AppMeta 的 pretty 渲染契约。
+ *
+ * 注：BAM 没给 createdAt / updatedAt 的单位注解；先按 ms（fmt.ms）渲染，
+ * 待 e2e 真值确认后调整。enum 字段通过 derive 翻译成可读字符串，JSON 模式
+ * 仍是 BAM 原值（数字枚举），与 BAM 接口契约保持一致。
+ */
+exports.appMetaSchema = {
+    columns: [
+        { key: "appID", label: "app-id" },
+        { key: "name" },
+        { key: "description" },
+        { key: "status_text", label: "status", derive: (row) => lookup(STATUS_TEXT)(row.status) },
+        { key: "appType_text", label: "type", derive: (row) => lookup(TYPE_TEXT)(row.appType) },
+        { key: "appMode_text", label: "mode", derive: (row) => lookup(MODE_TEXT)(row.appMode) },
+        { key: "bizType_text", label: "biz-type", derive: (row) => lookup(BIZ_TYPE_TEXT)(row.bizType) },
+        { key: "archType_text", label: "arch", derive: (row) => lookup(ARCH_TYPE_TEXT)(row.archType) },
+        { key: "source_text", label: "source", derive: (row) => lookup(SOURCE_TEXT)(row.source) },
+        { key: "ownedBy", label: "owner" },
+        { key: "createdBy", label: "creator" },
+        { key: "dataBranchID", label: "branch" },
+        { key: "parentAppID", label: "parent-app" },
+        { key: "createdAt", label: "created-at", format: output_1.fmt.ms() },
+        { key: "updatedAt", label: "updated-at", format: output_1.fmt.ms() },
+    ],
+    strict: true,
+};

package/dist/api/app/types.js

@@ -0,0 +1,58 @@
+"use strict";
+// 与 BAM lark.apaas.devops v1.0.326 对齐：
+//   - CLIGetAppInfo (4070322)  → AppInfo / AppMeta
+//   - CLIUpdateAppMeta (4070323) → 入参 name? / description?
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchType = exports.Source = exports.BizType = exports.AppType = exports.AppMode = exports.AppStatus = void 0;
+/** 应用状态 */
+var AppStatus;
+(function (AppStatus) {
+    AppStatus[AppStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    AppStatus[AppStatus["PREPARING"] = 1] = "PREPARING";
+    AppStatus[AppStatus["UNRELEASED"] = 2] = "UNRELEASED";
+    AppStatus[AppStatus["RELEASED"] = 3] = "RELEASED";
+    /** BAM 注释为 Deprecated；保留枚举以兼容历史响应数据 */
+    AppStatus[AppStatus["DELETED"] = 4] = "DELETED";
+    AppStatus[AppStatus["UPGRADING"] = 5] = "UPGRADING";
+})(AppStatus || (exports.AppStatus = AppStatus = {}));
+/** 应用模式 */
+var AppMode;
+(function (AppMode) {
+    AppMode[AppMode["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    AppMode[AppMode["STANDARD"] = 1] = "STANDARD";
+    AppMode[AppMode["EXPERT"] = 2] = "EXPERT";
+})(AppMode || (exports.AppMode = AppMode = {}));
+/** 应用类型 */
+var AppType;
+(function (AppType) {
+    AppType[AppType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    AppType[AppType["STANDARD"] = 1] = "STANDARD";
+    AppType[AppType["PROTOTYPE"] = 2] = "PROTOTYPE";
+    AppType[AppType["APPLICATION"] = 3] = "APPLICATION";
+    AppType[AppType["DESIGN"] = 4] = "DESIGN";
+    AppType[AppType["OPENCLAW"] = 5] = "OPENCLAW";
+    AppType[AppType["CLAW_SUB"] = 6] = "CLAW_SUB";
+})(AppType || (exports.AppType = AppType = {}));
+/** 业务线 */
+var BizType;
+(function (BizType) {
+    BizType[BizType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    BizType[BizType["MIAODA"] = 1] = "MIAODA";
+    BizType[BizType["FORCE"] = 2] = "FORCE";
+})(BizType || (exports.BizType = BizType = {}));
+/** 应用来源 */
+var Source;
+(function (Source) {
+    Source[Source["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    Source[Source["CHAT"] = 1] = "CHAT";
+    Source[Source["TEMPLATE"] = 2] = "TEMPLATE";
+    Source[Source["IMPORT_ZIP"] = 3] = "IMPORT_ZIP";
+    Source[Source["IMPORT_BASE"] = 4] = "IMPORT_BASE";
+})(Source || (exports.Source = Source = {}));
+/** 架构类型 */
+var ArchType;
+(function (ArchType) {
+    ArchType[ArchType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    ArchType[ArchType["FULL_STACK"] = 1] = "FULL_STACK";
+    ArchType[ArchType["NOT_FULL_STACK"] = 2] = "NOT_FULL_STACK";
+})(ArchType || (exports.ArchType = ArchType = {}));

package/dist/api/deploy/api.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRelease = createRelease;
+exports.listPipelineInstances = listPipelineInstances;
+exports.getErrorLog = getErrorLog;
+exports.queryPipelineInstance = queryPipelineInstance;
+const http_1 = require("../../utils/http");
+const devops_error_1 = require("../../utils/devops-error");
+const DEFAULT_ERR_CODE = "INTERNAL_DEVOPS_ERROR";
+function envelopeOpts(errPrefix) {
+    return {
+        errPrefix,
+        defaultErrCode: DEFAULT_ERR_CODE,
+        // deploy 与 app 走同一个 PSM；业务码映射复用
+        mapErr: devops_error_1.mapDevopsError,
+    };
+}
+/** POST /v1/devops/app/:appID/release — 触发发布 */
+async function createRelease(req) {
+    const url = `/v1/devops/app/${encodeURIComponent(req.appID)}/release`;
+    return (0, http_1.postInnerApi)(url, req, envelopeOpts("Failed to create release"));
+}
+/**
+ * POST /v1/pipeline/app/:appID/instance/list — 分页查询发布历史
+ *
+ * 走 lark.apaas.devops_platform PSM（同 queryPipelineInstance）。
+ * 不复用 mapDevopsError——那是 lark.apaas.devops 的业务码映射。
+ */
+async function listPipelineInstances(req) {
+    const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/list`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to list deploys",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+/**
+ * GET /v1/pipeline/app/:appID/instance/:instanceID/error_log — 获取发布错误日志
+ *
+ * 走 lark.apaas.devops_platform PSM；instanceID 即 pipelineTaskID == deploy-id。
+ * BAM CliGetToolInstanceErrorJobs（4073972），路径段无 body。
+ */
+async function getErrorLog(req) {
+    const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/${encodeURIComponent(req.instanceID)}/error_log`;
+    return (0, http_1.getInnerApi)(url, {
+        errPrefix: "Failed to get error log",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+/**
+ * GET /v1/pipeline/app/:appID/instance/:instanceID/detail — 轮询发布状态
+ *
+ * 走 lark.apaas.devops_platform PSM；URL 前缀不同但共用同一管理端 gateway。
+ */
+async function queryPipelineInstance(req) {
+    const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/${encodeURIComponent(req.instanceID)}/detail`;
+    return (0, http_1.getInnerApi)(url, {
+        errPrefix: "Failed to query pipeline",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}

package/dist/api/deploy/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
+Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
+Object.defineProperty(exports, "getErrorLog", { enumerable: true, get: function () { return api_1.getErrorLog; } });
+Object.defineProperty(exports, "queryPipelineInstance", { enumerable: true, get: function () { return api_1.queryPipelineInstance; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "deployHistorySchema", { enumerable: true, get: function () { return schemas_1.deployHistorySchema; } });
+Object.defineProperty(exports, "deployGetSchema", { enumerable: true, get: function () { return schemas_1.deployGetSchema; } });
+Object.defineProperty(exports, "errorJobSchema", { enumerable: true, get: function () { return schemas_1.errorJobSchema; } });
+Object.defineProperty(exports, "nodeStatusText", { enumerable: true, get: function () { return schemas_1.nodeStatusText; } });
+Object.defineProperty(exports, "nodeStatusFromText", { enumerable: true, get: function () { return schemas_1.nodeStatusFromText; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "NodeStatus", { enumerable: true, get: function () { return types_1.NodeStatus; } });

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/index.js

@@ -33,10 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.db = exports.file = exports.plugin = void 0;
+exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
 const _plugin = __importStar(require("../api/plugin/index"));
 const _file = __importStar(require("../api/file/index"));
 const _db = __importStar(require("../api/db/index"));
+const _observability = __importStar(require("../api/observability/index"));
+const _app = __importStar(require("../api/app/index"));
+const _deploy = __importStar(require("../api/deploy/index"));
 exports.plugin = { ..._plugin };
 exports.file = { ..._file };
 exports.db = { ..._db };
+exports.observability = { ..._observability };
+exports.app = { ..._app };
+exports.deploy = { ..._deploy };

package/dist/api/observability/api.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchLogs = searchLogs;
+exports.searchTraces = searchTraces;
+exports.getTraces = getTraces;
+exports.queryMetricsData = queryMetricsData;
+exports.queryAnalyticsData = queryAnalyticsData;
+const http_1 = require("../../utils/http");
+const DEFAULT_ERR_CODE = "INTERNAL_OB_ERROR";
+// ── 日志 ──
+async function searchLogs(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/logs/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to search logs",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 链路 ──
+async function searchTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to search traces",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+async function getTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/${encodeURIComponent(req.traceID)}`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to get trace",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 监控指标 ──
+async function queryMetricsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/metrics/data/query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to query metrics",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 运营指标 ──
+//
+// 走 BAM v1.0.122 起的批量端点 CLIBatchQueryAnalyticsData：
+//   - 路径 /analytics/data/batch_query（旧版 /analytics/data/query 已废弃）
+//   - 支持 metricTypes 数组，单次拉多个指标
+async function queryAnalyticsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/analytics/data/batch_query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to query analytics",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}

package/dist/api/observability/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = exports.spanSchema = exports.logItemSchema = exports.queryAnalyticsData = exports.queryMetricsData = exports.getTraces = exports.searchTraces = exports.searchLogs = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "searchLogs", { enumerable: true, get: function () { return api_1.searchLogs; } });
+Object.defineProperty(exports, "searchTraces", { enumerable: true, get: function () { return api_1.searchTraces; } });
+Object.defineProperty(exports, "getTraces", { enumerable: true, get: function () { return api_1.getTraces; } });
+Object.defineProperty(exports, "queryMetricsData", { enumerable: true, get: function () { return api_1.queryMetricsData; } });
+Object.defineProperty(exports, "queryAnalyticsData", { enumerable: true, get: function () { return api_1.queryAnalyticsData; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "logItemSchema", { enumerable: true, get: function () { return schemas_1.logItemSchema; } });
+Object.defineProperty(exports, "spanSchema", { enumerable: true, get: function () { return schemas_1.spanSchema; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "WordOperator", { enumerable: true, get: function () { return types_1.WordOperator; } });
+Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return types_1.SpanKind; } });
+Object.defineProperty(exports, "StatusCode", { enumerable: true, get: function () { return types_1.StatusCode; } });

package/dist/api/observability/schemas.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spanSchema = exports.logItemSchema = void 0;
+const output_1 = require("../../utils/output");
+/** LogItem 渲染契约（log search） */
+exports.logItemSchema = {
+    columns: [
+        { key: "timestampNs", label: "time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        {
+            key: "module",
+            derive: (row) => {
+                return row.attributes?.module;
+            },
+        },
+        {
+            key: "user-id",
+            derive: (row) => {
+                return row.attributes?.user_id;
+            },
+        },
+        { key: "severityText", label: "severity-text" },
+        {
+            key: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: (row) => {
+                return row.attributes?.duration_ms;
+            },
+        },
+        { key: "traceID", label: "trace-id" },
+        { key: "id", label: "log-id" },
+        { key: "body" },
+    ],
+    strict: true,
+};
+/** Span 渲染契约（trace list / trace get 复用）。
+ *  duration 是 client-derived（BAM 只给 start/end，没有原生 durationNs 字段）。 */
+exports.spanSchema = {
+    columns: [
+        { key: "startTimeUnixNano", label: "start-time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        { key: "name", label: "root-span" },
+        {
+            key: "user-id",
+            derive: (row) => {
+                return row.attributes?.user_id;
+            },
+        },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: (row) => {
+                return row.attributes?.duration_ms;
+            },
+        },
+        { key: "traceID", label: "trace-id" },
+    ],
+    strict: true,
+};
+// metric / analytics 都改用 BAM v1.0.123 起的合并响应（points: {timestamp, values}），
+// pretty 渲染走 handler 内 pivot 后的临时 schema；不再导出固定 schema。

package/dist/api/observability/types.js

@@ -0,0 +1,27 @@
+"use strict";
+// ── 通用结构 ──
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = void 0;
+/** 模糊搜索词运算符（对应后端 WordOperator） */
+var WordOperator;
+(function (WordOperator) {
+    WordOperator[WordOperator["AND"] = 0] = "AND";
+    WordOperator[WordOperator["OR"] = 1] = "OR";
+})(WordOperator || (exports.WordOperator = WordOperator = {}));
+/** OpenTelemetry SpanKind（BAM 透传） */
+var SpanKind;
+(function (SpanKind) {
+    SpanKind[SpanKind["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    SpanKind[SpanKind["INTERNAL"] = 1] = "INTERNAL";
+    SpanKind[SpanKind["SERVER"] = 2] = "SERVER";
+    SpanKind[SpanKind["CLIENT"] = 3] = "CLIENT";
+    SpanKind[SpanKind["PRODUCER"] = 4] = "PRODUCER";
+    SpanKind[SpanKind["CONSUMER"] = 5] = "CONSUMER";
+})(SpanKind || (exports.SpanKind = SpanKind = {}));
+/** Span 状态码（BAM 透传） */
+var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["UNSET"] = 0] = "UNSET";
+    StatusCode[StatusCode["OK"] = 1] = "OK";
+    StatusCode[StatusCode["ERROR"] = 2] = "ERROR";
+})(StatusCode || (exports.StatusCode = StatusCode = {}));