@cloudbase/cli 2.10.0-beta.0 → 2.11.0-beta.0

package/lib/commands/ag/delete.js

@@ -0,0 +1,200 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDeleteCommand = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const common_1 = require("../common");
+const decorators_1 = require("../../decorators");
+const base_1 = require("./base");
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
+const i18n_1 = require("../../i18n");
+const base_2 = require("./base");
+let AgentDeleteCommand = class AgentDeleteCommand extends common_1.Command {
+    get options() {
+        return {
+            cmd: 'ag',
+            childCmd: 'delete [agentName]',
+            options: [
+                {
+                    flags: '-e, --envId <envId>',
+                    desc: (0, i18n_1.t)('环境 ID')
+                },
+                {
+                    flags: '--agentId <agentId>',
+                    desc: (0, i18n_1.t)('Agent ID'),
+                    defaultValue: ''
+                },
+                {
+                    flags: '--force',
+                    desc: (0, i18n_1.t)('强制删除，不提示确认'),
+                    defaultValue: false
+                },
+                {
+                    flags: '--all',
+                    desc: (0, i18n_1.t)('删除配置文件中的所有 Agent'),
+                    defaultValue: false
+                }
+            ],
+            requiredEnvId: false,
+            autoRunLogin: true,
+            desc: (0, i18n_1.t)('删除 Agent')
+        };
+    }
+    async execute(ctx, envId, log, params, options) {
+        const agentName = params[0];
+        const { force, all, agentId: agId } = options;
+        if (!envId) {
+            envId = await this.selectEnv();
+        }
+        log.info((0, i18n_1.t)('当前环境：{{envId}}', { envId }));
+        const agentService = await (0, base_1.getAgentService)(envId);
+        const agentId = agId ? agId : await (0, base_2.getAgentIdFromConfig)(agentName, process.cwd());
+        if (all) {
+            await this.deleteAllAgents(agentService, force, log);
+        }
+        else {
+            await this.deleteAgent({ agentService, agentName, agentId, force, log: log });
+        }
+    }
+    async selectEnv() {
+        return (0, utils_1.selectEnv)({ source: [constants_1.EnvSource.MINIAPP, constants_1.EnvSource.QCLOUD] });
+    }
+    async deleteAgent(options) {
+        const { agentService, agentName, agentId, force, log } = options;
+        try {
+            if (!force) {
+                const confirmed = await (0, base_1.confirmOperation)((0, i18n_1.t)(`确定要删除 Agent "${agentName}" 吗？此操作不可恢复。`));
+                if (!confirmed) {
+                    log.info((0, i18n_1.t)('删除操作已取消'));
+                    return;
+                }
+            }
+            const spinner = (0, ora_1.default)({
+                text: (0, i18n_1.t)('正在删除 Agent...'),
+                color: 'red'
+            }).start();
+            try {
+                if (agentId) {
+                    const deleteRes = await agentService.delete({ agentId });
+                    console.log('deleteRes', deleteRes);
+                }
+                await (0, base_1.removeAgentConfig)(agentName);
+                spinner.succeed((0, i18n_1.t)('Agent 删除成功'));
+                log.success((0, i18n_1.t)(`Agent "${agentName}" 已成功删除`));
+            }
+            catch (error) {
+                spinner.fail((0, i18n_1.t)('Agent 删除失败'));
+                throw error;
+            }
+        }
+        catch (error) {
+            if (error.code === 'ResourceNotFound' || error.message.includes('not found')) {
+                log.warn((0, i18n_1.t)('Agent {{agentId}} 在云端不存在，仅删除本地配置', { agentId }));
+                await (0, base_1.removeAgentConfig)(agentId);
+                log.success((0, i18n_1.t)('本地配置已删除'));
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    async deleteAllAgents(agentService, force, log) {
+        try {
+            const config = await (0, base_1.getCloudbaseConfig)();
+            const agents = config.agents || [];
+            if (agents.length === 0) {
+                log.info((0, i18n_1.t)('没有找到需要删除的 Agent'));
+                return;
+            }
+            console.log(chalk_1.default.yellow((0, i18n_1.t)('\n将要删除的 Agent:')));
+            agents.forEach((agent, index) => {
+                console.log(`${index + 1}. ${agent.name}`);
+            });
+            if (!force) {
+                const confirmed = await (0, base_1.confirmOperation)((0, i18n_1.t)('确定要删除以上 {{count}} 个 Agent 吗？此操作不可恢复。', { count: agents.length }), false);
+                if (!confirmed) {
+                    log.info((0, i18n_1.t)('删除操作已取消'));
+                    return;
+                }
+            }
+            const spinner = (0, ora_1.default)({
+                text: (0, i18n_1.t)('正在批量删除 Agent...'),
+                color: 'red'
+            }).start();
+            let successCount = 0;
+            let failedCount = 0;
+            const failedAgents = [];
+            for (const agent of agents) {
+                try {
+                    spinner.text = (0, i18n_1.t)(`正在删除 ${agent.name}...`);
+                    if (agent.id) {
+                        try {
+                            await agentService.delete({ agentId: agent.id });
+                        }
+                        catch (error) {
+                            if (!(error.code === 'ResourceNotFound' || error.message.includes('not found'))) {
+                                throw error;
+                            }
+                        }
+                    }
+                    successCount++;
+                }
+                catch (error) {
+                    failedCount++;
+                    failedAgents.push(`${agent.name}`);
+                    log.warn((0, i18n_1.t)(`删除 ${agent.name} 失败：${error.message}`));
+                }
+            }
+            await (0, base_1.updateCloudbaseConfig)({ agents: [] });
+            if (failedCount === 0) {
+                spinner.succeed((0, i18n_1.t)('所有 Agent 删除成功'));
+                log.success((0, i18n_1.t)(`成功删除 ${successCount} 个 Agent`));
+            }
+            else {
+                spinner.warn((0, i18n_1.t)('部分 Agent 删除失败'));
+                log.info((0, i18n_1.t)(`成功删除 ${successCount} 个，失败 ${failedCount} 个`));
+                if (failedAgents.length > 0) {
+                    console.log(chalk_1.default.red((0, i18n_1.t)('\n删除失败的 Agent:')));
+                    failedAgents.forEach(agent => {
+                        console.log(`• ${agent}`);
+                    });
+                }
+            }
+        }
+        catch (error) {
+            log.error((0, i18n_1.t)(`批量删除失败：${error.message}`));
+            throw error;
+        }
+    }
+};
+__decorate([
+    (0, decorators_1.InjectParams)(),
+    __param(0, (0, decorators_1.CmdContext)()),
+    __param(1, (0, decorators_1.EnvId)()),
+    __param(2, (0, decorators_1.Log)()),
+    __param(3, (0, decorators_1.ArgsParams)()),
+    __param(4, (0, decorators_1.ArgsOptions)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, decorators_1.Logger, Array, Object]),
+    __metadata("design:returntype", Promise)
+], AgentDeleteCommand.prototype, "execute", null);
+AgentDeleteCommand = __decorate([
+    (0, common_1.ICommand)()
+], AgentDeleteCommand);
+exports.AgentDeleteCommand = AgentDeleteCommand;

package/lib/commands/ag/deploy.js

@@ -0,0 +1,185 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDeployCommand = void 0;
+const path_1 = __importDefault(require("path"));
+const ora_1 = __importDefault(require("ora"));
+const common_1 = require("../common");
+const decorators_1 = require("../../decorators");
+const base_1 = require("./base");
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
+const i18n_1 = require("../../i18n");
+const base_2 = require("../cloudrun/base");
+const base_3 = require("./base");
+let AgentDeployCommand = class AgentDeployCommand extends common_1.Command {
+    get options() {
+        return {
+            cmd: 'ag',
+            childCmd: 'deploy [agentName]',
+            options: [
+                {
+                    flags: '-e, --envId <envId>',
+                    desc: (0, i18n_1.t)('环境 ID')
+                },
+                {
+                    flags: '--deployMode <deployMode>',
+                    desc: (0, i18n_1.t)('部署模式（webFn: Web 函数，cloudrun: 云托管，默认: webFn）')
+                },
+                {
+                    flags: '--force',
+                    desc: (0, i18n_1.t)('强制部署，跳过确认提示'),
+                    defaultValue: false
+                },
+                {
+                    flags: '--source <source>',
+                    desc: (0, i18n_1.t)('指定要部署的代码目录路径')
+                },
+                {
+                    flags: '--port <port>',
+                    desc: (0, i18n_1.t)('部署模式为云托管时，支持设置服务端口')
+                }
+            ],
+            requiredEnvId: false,
+            autoRunLogin: true,
+            desc: (0, i18n_1.t)('部署 Agent 到云端')
+        };
+    }
+    async execute(ctx, envId, log, params, options) {
+        const agentName = params[0];
+        console.log('params', params);
+        console.log('options', options);
+        const { deployMode = 'webFn', force, source, port } = options;
+        const rootDir = process.cwd();
+        const cloudbaseConfig = await (0, base_1.getCloudbaseConfig)(rootDir);
+        if (!envId) {
+            if (cloudbaseConfig.envId) {
+                envId = cloudbaseConfig.envId;
+            }
+            else {
+                envId = await this.selectEnv();
+            }
+        }
+        log.info((0, i18n_1.t)('当前环境：{{envId}}', { envId }));
+        let agentConfig;
+        try {
+            agentConfig = await (0, base_1.getAgentConfig)(agentName, rootDir);
+        }
+        catch (error) {
+            throw new base_1.AgentError((0, i18n_1.t)('未找到 Agent 配置，请先运行 tcb ag create {{agentName}}', { agentName }));
+        }
+        const agentService = await (0, base_1.getAgentService)(envId);
+        const spinner = (0, ora_1.default)({
+            text: (0, i18n_1.t)('正在部署 Agent...'),
+            color: 'blue'
+        }).start();
+        const agentRootPath = path_1.default.join(process.cwd(), cloudbaseConfig.agentRoot);
+        try {
+            console.log('deployMode', deployMode);
+            const agentId = await (0, base_3.getAgentIdFromConfig)(agentName, process.cwd());
+            if (deployMode === 'cloudrun') {
+                await this.deployAgentInCloudrun({
+                    agentName,
+                    agentConfig,
+                    agentPath: source,
+                    agentRootPath,
+                    envId,
+                    log,
+                    port,
+                });
+                spinner.stop();
+            }
+            else if (deployMode === 'webFn') {
+                const isFirstDeploy = await this.checkIfFirstDeploy(agentService, agentId);
+                const deployConfig = {
+                    timeout: agentConfig.timeout,
+                    runtime: agentConfig.runtime,
+                    memorySize: agentConfig.memorySize,
+                    installDependency: agentConfig.installDependency || false,
+                    sessionConfig: agentConfig.sessionConfig,
+                    ignore: agentConfig.ignore,
+                    resources: agentConfig.resources,
+                    functionName: agentConfig.id,
+                    environment: {
+                        Variables: Object.entries(agentConfig.environment).map(([key, value]) => ({
+                            Name: key,
+                            Value: value
+                        }))
+                    }
+                };
+                const deployRes = await agentService.deployWebFn({
+                    agentId,
+                    name: agentName,
+                    agentPath: source,
+                    agentRootPath: agentRootPath,
+                    deployConfig: {
+                        ...deployConfig,
+                    }
+                }, isFirstDeploy);
+                spinner.succeed((0, i18n_1.t)(`Agent ${isFirstDeploy ? '创建' : '更新'}成功`));
+                await (0, base_1.updateAgentIdInConfig)(agentConfig.name, deployRes.AgentId, process.cwd());
+            }
+        }
+        catch (error) {
+            spinner.fail((0, i18n_1.t)('Agent 部署失败'));
+            throw error;
+        }
+    }
+    async deployAgentInCloudrun(options) {
+        const { agentName, agentConfig, agentPath, agentRootPath, envId, log, port } = options;
+        await (0, base_2.cloudRunDeploy)({
+            envId,
+            serviceName: agentName,
+            targetDir: agentPath || path_1.default.resolve(agentRootPath, agentName),
+            serverType: 'container',
+            port,
+            installDependency: 'true',
+            log: log
+        });
+    }
+    async selectEnv() {
+        return (0, utils_1.selectEnv)({ source: [constants_1.EnvSource.MINIAPP, constants_1.EnvSource.QCLOUD] });
+    }
+    async checkIfFirstDeploy(agentService, agentId) {
+        if (!agentId) {
+            return true;
+        }
+        try {
+            const agentInfo = await agentService.getAgentInfo({ agentId });
+            console.log('agentInfo', agentInfo);
+            return !agentInfo.AgentId;
+        }
+        catch (error) {
+            return true;
+        }
+    }
+};
+__decorate([
+    (0, decorators_1.InjectParams)(),
+    __param(0, (0, decorators_1.CmdContext)()),
+    __param(1, (0, decorators_1.EnvId)()),
+    __param(2, (0, decorators_1.Log)()),
+    __param(3, (0, decorators_1.ArgsParams)()),
+    __param(4, (0, decorators_1.ArgsOptions)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, decorators_1.Logger, Array, Object]),
+    __metadata("design:returntype", Promise)
+], AgentDeployCommand.prototype, "execute", null);
+AgentDeployCommand = __decorate([
+    (0, common_1.ICommand)()
+], AgentDeployCommand);
+exports.AgentDeployCommand = AgentDeployCommand;

package/lib/commands/ag/detail.js

@@ -0,0 +1,113 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDetailCommand = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const common_1 = require("../common");
+const decorators_1 = require("../../decorators");
+const base_1 = require("./base");
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
+const i18n_1 = require("../../i18n");
+let AgentDetailCommand = class AgentDetailCommand extends common_1.Command {
+    get options() {
+        return {
+            cmd: 'ag',
+            childCmd: 'detail <agentName>',
+            options: [
+                {
+                    flags: '-e, --envId <envId>',
+                    desc: (0, i18n_1.t)('环境 ID')
+                },
+                {
+                    flags: '--format <format>',
+                    desc: (0, i18n_1.t)('输出格式（table | json，默认: table）'),
+                    choices: ['table', 'json'],
+                    defaultValue: 'table'
+                }
+            ],
+            requiredEnvId: false,
+            autoRunLogin: true,
+            desc: (0, i18n_1.t)('查看 Agent 详情')
+        };
+    }
+    async execute(ctx, envId, log, params, options) {
+        const agentName = params[0];
+        const { format } = options;
+        if (!envId) {
+            envId = await this.selectEnv();
+        }
+        log.info((0, i18n_1.t)('当前环境：{{envId}}', { envId }));
+        const agentService = await (0, base_1.getAgentService)(envId);
+        const agentId = await (0, base_1.getAgentIdFromConfig)(agentName, process.cwd());
+        if (!agentId) {
+            throw new base_1.AgentError((0, i18n_1.t)(`请先部署 Agent: ${agentName}`));
+        }
+        try {
+            const agentDetail = await agentService.getAgentInfo({ agentId });
+            if (format === 'json') {
+                this.outputJson(agentDetail);
+            }
+            else {
+                this.outputTable(agentDetail, log);
+            }
+        }
+        catch (error) {
+            log.error((0, i18n_1.t)('获取 Agent 详情失败：{{error}}', { error: error.message }));
+            throw error;
+        }
+    }
+    async selectEnv() {
+        return (0, utils_1.selectEnv)({ source: [constants_1.EnvSource.MINIAPP, constants_1.EnvSource.QCLOUD] });
+    }
+    outputTable(agentDetail, log) {
+        console.log(chalk_1.default.green((0, i18n_1.t)('\n=== Agent 基本信息 ===')));
+        const basicInfo = [
+            [(0, i18n_1.t)('Agent ID'), agentDetail.AgentId],
+            [(0, i18n_1.t)('名称'), agentDetail.Name],
+            [(0, i18n_1.t)('运行时'), agentDetail.RuntimeConfig.Runtime],
+            [(0, i18n_1.t)('内存'), agentDetail.RuntimeConfig.MemorySize],
+            [(0, i18n_1.t)('更新时间'), (0, base_1.formatTime)(agentDetail.UpdateTime)]
+        ];
+        basicInfo.forEach(([key, value]) => {
+            console.log(`${chalk_1.default.cyan(key + ':')} ${value}`);
+        });
+        console.log(chalk_1.default.green((0, i18n_1.t)('\n=== 相关操作 ===')));
+        console.log(chalk_1.default.white((0, i18n_1.t)(`• 本地调试：tcb ag run ${agentDetail.AgentId}`)));
+        console.log(chalk_1.default.white((0, i18n_1.t)(`• 重新部署：tcb ag deploy ${agentDetail.AgentId}`)));
+        console.log(chalk_1.default.white((0, i18n_1.t)(`• 调用测试：tcb ag invoke ${agentDetail.AgentId} -d '{"prompt": "test"}'`)));
+        console.log(chalk_1.default.white((0, i18n_1.t)(`• 下载代码：tcb ag download ${agentDetail.AgentId}`)));
+    }
+    outputJson(agentDetail) {
+        console.log(JSON.stringify(agentDetail, null, 2));
+    }
+};
+__decorate([
+    (0, decorators_1.InjectParams)(),
+    __param(0, (0, decorators_1.CmdContext)()),
+    __param(1, (0, decorators_1.EnvId)()),
+    __param(2, (0, decorators_1.Log)()),
+    __param(3, (0, decorators_1.ArgsParams)()),
+    __param(4, (0, decorators_1.ArgsOptions)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, decorators_1.Logger, Array, Object]),
+    __metadata("design:returntype", Promise)
+], AgentDetailCommand.prototype, "execute", null);
+AgentDetailCommand = __decorate([
+    (0, common_1.ICommand)()
+], AgentDetailCommand);
+exports.AgentDetailCommand = AgentDetailCommand;

package/lib/commands/ag/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create"), exports);
+__exportStar(require("./deploy"), exports);
+__exportStar(require("./run"), exports);
+__exportStar(require("./list"), exports);
+__exportStar(require("./detail"), exports);
+__exportStar(require("./delete"), exports);

package/lib/commands/ag/list.js

@@ -0,0 +1,155 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentListCommand = void 0;
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const common_1 = require("../common");
+const decorators_1 = require("../../decorators");
+const base_1 = require("./base");
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
+const i18n_1 = require("../../i18n");
+const base_2 = require("./base");
+let AgentListCommand = class AgentListCommand extends common_1.Command {
+    get options() {
+        return {
+            cmd: 'ag',
+            childCmd: 'list',
+            options: [
+                {
+                    flags: '-e, --envId <envId>',
+                    desc: (0, i18n_1.t)('环境 ID')
+                },
+                {
+                    flags: '-l, --limit <limit>',
+                    desc: (0, i18n_1.t)('数据长度（默认值: 20）'),
+                    defaultValue: 20
+                },
+                {
+                    flags: '-o, --offset <offset>',
+                    desc: (0, i18n_1.t)('偏移量（默认值: 0）'),
+                    defaultValue: 0
+                },
+                {
+                    flags: '--format <format>',
+                    desc: (0, i18n_1.t)('输出格式（table | json，默认: table）'),
+                    choices: ['table', 'json'],
+                    defaultValue: 'table'
+                }
+            ],
+            requiredEnvId: false,
+            autoRunLogin: true,
+            desc: (0, i18n_1.t)('查看 Agent 列表')
+        };
+    }
+    async execute(ctx, envId, log, options) {
+        const { limit = 20, offset = 0, format } = options;
+        if (!envId) {
+            envId = await this.selectEnv();
+        }
+        log.info((0, i18n_1.t)('当前环境：{{envId}}', { envId }));
+        const agentService = await (0, base_1.getAgentService)(envId);
+        try {
+            const result = await agentService.list({
+                limit: parseInt(String(limit)),
+                offset: parseInt(String(offset))
+            });
+            const agents = result.AgentList || [];
+            const total = result.Total || 0;
+            if (agents.length === 0) {
+                log.info((0, i18n_1.t)('当前环境没有 Agent'));
+                return;
+            }
+            if (format === 'json') {
+                this.outputJson(agents, total, limit, offset);
+            }
+            else {
+                this.outputTable(agents, total, limit, offset, log);
+            }
+        }
+        catch (error) {
+            log.error((0, i18n_1.t)(`获取 Agent 列表失败：${error.message}`));
+            throw new base_2.AgentError((0, i18n_1.t)(`获取 Agent 列表失败：${error.message}`));
+        }
+    }
+    async selectEnv() {
+        return (0, utils_1.selectEnv)({ source: [constants_1.EnvSource.MINIAPP, constants_1.EnvSource.QCLOUD] });
+    }
+    outputTable(agents, total, limit, offset, log) {
+        const table = new cli_table3_1.default({
+            head: [
+                (0, i18n_1.t)('Agent ID'),
+                (0, i18n_1.t)('名称'),
+                (0, i18n_1.t)('运行时'),
+                (0, i18n_1.t)('内存'),
+                (0, i18n_1.t)('更新时间'),
+            ],
+            style: {
+                head: ['green']
+            },
+            colWidths: [20, 20, 10, 10, 30]
+        });
+        agents.forEach(agent => {
+            table.push([
+                agent.AgentId,
+                agent.Name,
+                agent.RuntimeConfig.Runtime || 'N/A',
+                agent.RuntimeConfig.MemorySize ? `${agent.RuntimeConfig.MemorySize}MB` : 'N/A',
+                (0, base_1.formatTime)(agent.UpdateTime),
+            ]);
+        });
+        console.log(table.toString());
+        const currentPage = Math.floor(offset / limit) + 1;
+        const totalPages = Math.ceil(total / limit);
+        log.info((0, i18n_1.t)(`显示 ${offset + 1}-${Math.min(offset + agents.length, total)} 条，共 ${total} 条 (第 ${currentPage} 页，共 ${totalPages} 页)`));
+        if (totalPages > 1) {
+            if (currentPage < totalPages) {
+                log.info((0, i18n_1.t)(`查看下一页：tcb ag list -o ${offset + limit} -l ${limit}`));
+            }
+            if (currentPage > 1) {
+                log.info((0, i18n_1.t)(`查看上一页：tcb ag list -o ${Math.max(0, offset - limit)} -l ${limit}`));
+            }
+        }
+    }
+    outputJson(agents, total, limit, offset) {
+        const result = {
+            agents,
+            pagination: {
+                total,
+                limit,
+                offset,
+                count: agents.length,
+                hasMore: offset + agents.length < total
+            }
+        };
+        console.log(JSON.stringify(result, null, 2));
+    }
+};
+__decorate([
+    (0, decorators_1.InjectParams)(),
+    __param(0, (0, decorators_1.CmdContext)()),
+    __param(1, (0, decorators_1.EnvId)()),
+    __param(2, (0, decorators_1.Log)()),
+    __param(3, (0, decorators_1.ArgsOptions)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, decorators_1.Logger, Object]),
+    __metadata("design:returntype", Promise)
+], AgentListCommand.prototype, "execute", null);
+AgentListCommand = __decorate([
+    (0, common_1.ICommand)()
+], AgentListCommand);
+exports.AgentListCommand = AgentListCommand;