@cloudbase/manager-node 4.6.4 → 4.7.0-beta.0

package/.cursor/rules/cloudbase-rules.mdc

@@ -0,0 +1,119 @@
+---
+cloudbaseAIVersion：1.8.20
+description: CloudBase AI 开发规则索引 - 防止不同开发场景的规则互相干扰
+globs: 
+alwaysApply: true
+---
+
+#  AI 开发人机协同规则索引
+
+## 核心行为规则
+0. 你擅长调用合适的工具来完成完成各项任务
+1. 你会在对话输出完毕后选择适当的时机向用户提出询问，例如是否需要添加后端能力，是否打开预览，是否需要部署等
+2. 你首先会阅读当前项目的 README.md，遵照当前项目的说明进行开发，如果不存在则会在生成项目后生成一个 README.md 文件
+3. 开发的时候，默认就在当前目录下产出所有项目代码，先检查当前目录的文件  
+4. 开发预览的时候，如果本身项目有依赖后端数据库集合和云函数，可以优先部署后端然后再预览前端
+5. 交互式反馈规则：在需求不明确时主动与用户对话澄清，优先使用自动化工具 interactiveDialog 完成配置。执行高风险操作前必须使用 interactiveDialog 获得用户确认。保持消息简洁并用emoji标记状态。
+6. 如果涉及到实时通信相关的例如实时对战等，可以使用云开发的实时数据库 watch 能力
+
+## 工作流
+
+<workflow>
+0. 请注意！必须遵守以下的规则，每个环节完成后都需要由我进行确认后才可进行下一个环节；
+1. 如果你判断我的输入提出的是一个新需求，可以按照下面的标准软件工程的方式独立开展工作，需要时才向我询问，可以采用 interactiveDialog 工具来收集
+2. 每当我输入新的需求的时候，为了规范需求质量和验收标准，你首先会搞清楚问题和需求，然后再进入下一阶段
+3. 需求文档和验收标准设计：首先完成需求的设计,按照 EARS 简易需求语法方法来描述，跟我进行确认，最终确认清楚后，需求定稿，然后再进入下一阶段，保存在 `specs/spec_name/requirements.md` 中，参考格式如下
+
+```markdown
+# 需求文档
+
+## 介绍
+
+需求描述
+
+## 需求
+
+### 需求 1 - 需求名称
+
+**用户故事：** 用户故事内容
+
+#### 验收标准
+
+1. 采用 ERAS 描述的子句 While <可选前置条件>, when <可选触发器>, the <系统名称> shall <系统响应>，例如 When 选择"静音"时，笔记本电脑应当抑制所有音频输出。
+2. ...
+...
+```
+4. 技术方案设计： 在完成需求的设计之后，你会根据当前的技术架构和前面确认好的需求，进行需求的技术方案设计，精简但是能够准确的描述技术的架构（例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性），必要时可以用 mermaid 来绘图，跟我确认清楚后，保存在  `specs/spec_name/design.md`  中，然后再进入下一阶段
+5. 任务拆分：在完成技术方案设计后，你会根据需求文档和技术方案，细化具体要做的事情，跟我确认清楚后，，保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段，开始正式执行任务，同时需要及时更新任务的状态，执行的时候尽可能独立自主运行，保证效率和质量
+
+任务参考格式如下
+
+``` markdown
+# 实施计划
+
+- [ ] 1. 任务信息
+  - 具体要做的事情
+  - ...
+  - _需求: 相关的需求点的编号
+
+```
+</workflow>
+
+## 专业领域规则文件
+
+**重要：根据具体的开发场景，AI 必须参考对应的规则文件，避免不同场景的规则互相干扰**
+
+### rules/web-development.mdc
+描述前端+云开发 CloudBase 项目开发的专业规则，包含：
+- Web 项目结构和工程化配置
+- 静态托管部署流程
+- Web SDK 使用和认证方式
+- 适用于纯 Web 项目开发时参考
+
+### rules/miniprogram-development.mdc  
+描述微信小程序开发的专业规则，包含：
+- 小程序项目结构和配置
+- 微信云开发能力集成
+- 小程序特有的 API 和权限处理
+- 适用于微信小程序开发时参考
+
+### rules/cloudbase-platform.mdc
+描述 CloudBase 平台的核心知识，包含：
+- 云开发环境和认证
+- 云函数、数据库、存储等服务
+- 数据模型和权限管理
+- 控制台管理页面链接
+- 适用于所有使用 CloudBase 平台的项目
+
+### rules/workflows.mdc
+描述开发工作流程，包含：
+- 部署流程（云函数、静态托管）
+- 素材下载和知识库查询
+- 文档和配置文件生成规则
+- MCP 接口调用规范
+- 适用于项目开发的各个阶段
+
+### rules/database.mdc
+描述云开发 CloudBase 数据库操作的专业规则，包含：
+- CloudBase 数据库操作注意事项
+- 数据库权限管理
+- 数据更新和错误处理
+- 适用于涉及数据库操作的项目
+
+### rules/ui-design.mdc
+描述web/小程序等页面设计和 UI 规范，包含：
+- 高保真原型设计流程
+- UI 设计规范和工具选择
+- 前端样式处理
+- 适用于需要设计界面的项目
+
+## 使用指导
+- **Web 项目开发**：主要参考 `rules/web-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc`
+- **微信小程序开发**：主要参考 `rules/miniprogram-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc`  
+- **数据库相关**：额外参考 `rules/database.mdc`
+- **UI 设计需求**：额外参考 `rules/ui-design.mdc`
+
+**重要提醒：开发微信小程序时，严禁参考 Web SDK 的认证方式，必须使用小程序专用的 API 和云开发方式！**
+
+
+

package/lib/agent/index.js

@@ -15,14 +15,18 @@ const utils_1 = require("../utils");
 const path_1 = __importDefault(require("path"));
 /**
  * Agent 管理类
+ * 提供新版 Agent 的完整生命周期管理功能
  */
 class AgentService {
     constructor(environment) {
         this.environment = environment;
         this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+        this.scfService = new utils_1.CloudService(environment.cloudBaseContext, 'scf', '2018-04-16');
+        this.functionService = environment.getFunctionService();
+        this.userService = environment.getUserService();
     }
     /**
-     * 创建函数型 Agent
+     * 创建函数型 Agent（兼容旧版本）
      * @param {string} [cwd=process.cwd()] 工作目录
      * @param {ICreateFunctionAgentParams} agentInfo Agent 信息
      * @returns {Promise<{ BotId: string; RequestId: string }>} Agent 创建结果
@@ -63,8 +67,145 @@ class AgentService {
         });
         return this.tcbService.request('CreateBot', Object.assign(Object.assign({}, agentInfo), { EnvId: envConfig.EnvId, PackageName: packageName, PackageVersion: packageVersion }));
     }
+    /**
+     * 部署新版 Agent 到 web云函数
+     * @param {ICreateAgentParams} params 创建参数
+     * @returns {Promise<IResponseInfo>} 创建结果
+     */
+    async deployWebFn(params, isFirstDeploy = true) {
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const { name, agentId, agentPath, agentRootPath, deployConfig } = params;
+        // 构造部署参数
+        const deployAgentData = Object.assign({}, deployConfig);
+        // 上传代码包到 COS
+        const uploadRes = await this.functionService.uploadFunctionZipToCos({ func: { name: name, ignore: deployConfig.ignore }, functionPath: agentPath, functionRootPath: agentRootPath }, 'FALSE');
+        console.log('uploadRes', uploadRes);
+        const { Key } = uploadRes;
+        console.log('tempobjectkey', Key);
+        deployAgentData.code = {
+            cosBucketRegion: 'ap-shanghai',
+            tempCosObjectName: `/${Key}`
+        };
+        // 使用 zipFile 上传
+        // deployAgentData.code = await this.getCodeParams({ deployConfig, agentPath, agentRootPath })
+        try {
+            let res;
+            if (isFirstDeploy) {
+                // 调用创建接口 TODO: 临时屏蔽 resourceList
+                res = await this.tcbService.request('CreateAgent', (0, utils_1.upperCaseObjKey)({
+                    envId: envConfig.EnvId,
+                    // agentId,
+                    name,
+                    runtimeConfig: Object.assign(Object.assign({}, deployAgentData), { ignore: undefined, resources: undefined, environment: undefined, functionName: undefined })
+                }));
+                console.log('CreateAgent res', res);
+                // 等待函数状态正常
+                await this.functionService.waitFunctionActive(res.AgentId);
+            }
+            else {
+                // 调用函数代码更新接口
+                res = await this.scfService.request('UpdateFunctionCode', {
+                    FunctionName: agentId,
+                    Namespace: envConfig.EnvId,
+                    InstallDependency: 'FALSE',
+                    Code: deployAgentData.code
+                });
+                console.log('UpdateFunctionCode res', res);
+                // 等待函数状态正常
+                await this.functionService.waitFunctionActive(agentId);
+            }
+            return res;
+        }
+        catch (error) {
+            throw new Error(`${isFirstDeploy ? '创建' : '更新'} Agent 失败: ${error.message}`);
+        }
+    }
+    /**
+     * 获取 Agent 列表
+     * @param {IListAgentsParams} [params] 查询参数
+     * @returns {Promise<IListAgentsResponse>} Agent 列表
+     */
+    async list(params) {
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const { limit = 20, offset = 0, agentId } = params || {};
+        // 转化为 pageSize 和 pageNum
+        const pageSize = limit;
+        const pageNumber = Math.floor(offset / limit) + 1;
+        try {
+            const params = {
+                EnvId: envConfig.EnvId,
+            };
+            if (agentId) {
+                params.AgentId = agentId;
+            }
+            else {
+                params.PageSize = pageSize;
+                params.PageNumber = pageNumber;
+            }
+            const res = await this.tcbService.request('DescribeAgentList', params);
+            console.log('DescribeAgentList res', JSON.stringify(res, null, 2));
+            const transformAggentList = await Promise.all(res.AgentList.map(async (item) => {
+                const fnDetail = await this.functionService.getFunctionDetail(item.AgentId);
+                return Object.assign(Object.assign({}, item), { RuntimeConfig: Object.assign(Object.assign({}, item.RuntimeConfig), { Runtime: fnDetail.Runtime, MemorySize: fnDetail.MemorySize, Timeout: fnDetail.Timeout }) });
+            }));
+            return Object.assign(Object.assign({}, res), { AgentList: transformAggentList });
+        }
+        catch (error) {
+            throw new Error(`获取 Agent 列表失败: ${error.message}`);
+        }
+    }
+    /**
+     * 获取 Agent 详情
+     * @param {object} params 查询参数
+     * @param {string} params.agentId Agent ID
+     * @returns {Promise<IAgentDetailResponse>} Agent 详情
+     */
+    async getAgentInfo(params) {
+        const listRes = await this.list({ agentId: params.agentId });
+        if (listRes.Total > 0) {
+            return listRes.AgentList[0];
+        }
+        else {
+            return null;
+        }
+    }
+    /**
+     * 删除 Agent
+     * @param {IDeleteAgentParams} params 删除参数
+     * @returns {Promise<IResponseInfo>} 删除结果
+     */
+    async delete(params) {
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const { agentId } = params;
+        try {
+            // 1. 删除 Agent 实体
+            const res = await this.tcbService.request('DeleteAgent', {
+                EnvId: envConfig.EnvId,
+                AgentId: agentId
+            });
+            // 2. 删除 agentId 对应的函数
+            const deleteFunctionRes = await this.functionService.deleteFunction({ name: agentId });
+            console.log('deleteFunctionRes', deleteFunctionRes);
+            return res;
+        }
+        catch (error) {
+            throw new Error(`删除 Agent 失败: ${error.message}`);
+        }
+    }
 }
 exports.AgentService = AgentService;
 __decorate([
     (0, utils_1.preLazy)()
 ], AgentService.prototype, "createFunctionAgent", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AgentService.prototype, "deployWebFn", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AgentService.prototype, "list", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AgentService.prototype, "getAgentInfo", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AgentService.prototype, "delete", null);

package/lib/cloudrun/index.js

@@ -180,7 +180,7 @@ class CloudRunService {
         /**
          * 上传部署包
          */
-        const zipFile = await codeToZip(targetPath, { installDependency: true });
+        const zipFile = await codeToZip(targetPath, { installDependency: (serverConfig === null || serverConfig === void 0 ? void 0 : serverConfig.InstallDependency) !== undefined ? serverConfig.InstallDependency : true });
         await (0, utils_1.upload)({
             url: uploadUrl,
             file: zipFile,

package/lib/environment.js

@@ -23,6 +23,7 @@ class Environment {
         this.cloudBaseContext = context;
         this.envType = context.envType;
         // 拉取当前环境 的环境信息 todo
+        this.userService = new user_1.UserService(this);
         this.functionService = new function_1.FunctionService(this);
         this.cloudRunService = new cloudrun_1.CloudRunService(this);
         this.agentService = new agent_1.AgentService(this);
@@ -32,7 +33,6 @@ class Environment {
         this.hostingService = new hosting_1.HostingService(this);
         this.thirdService = new third_1.ThirdService(this);
         this.accessService = new access_1.AccessService(this);
-        this.userService = new user_1.UserService(this);
         this.cloudBaseRunService = new cloudBaseRun_1.CloudBaseRunService(this);
     }
     async lazyInit() {

package/lib/function/index.js

@@ -17,6 +17,7 @@ const packer_1 = require("./packer");
 const error_1 = require("../error");
 const utils_1 = require("../utils");
 const constant_1 = require("../constant");
+const cos_nodejs_sdk_v5_1 = __importDefault(require("cos-nodejs-sdk-v5"));
 // 是否为 Node 函数
 function isNodeFunction(runtime) {
     // 不严格限制
@@ -85,6 +86,7 @@ class FunctionService {
         this.scfService = new utils_1.CloudService(environment.cloudBaseContext, 'scf', '2018-04-16');
         this.vpcService = new utils_1.CloudService(environment.cloudBaseContext, 'vpc', '2017-03-12');
         this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+        this.userService = environment.getUserService();
     }
     /**
      * 增量更新函数代码
@@ -989,6 +991,45 @@ class FunctionService {
             LayerVersion: version
         });
     }
+    // 检查函数状态，部分操作在函数更新中时不可进行
+    async waitFunctionActive(funcName, codeSecret) {
+        let ticker;
+        let timer;
+        let resolved;
+        return new Promise((resolve, reject) => {
+            // 超时时间 5 分钟
+            timer = setTimeout(() => {
+                clearInterval(ticker);
+                if (!resolved) {
+                    reject(new error_1.CloudBaseError('函数状态异常，检查超时'));
+                }
+            }, 300000);
+            ticker = setInterval(async () => {
+                try {
+                    const { Status, StatusDesc, StatusReasons, RequestId } = await this.getFunctionDetail(funcName, codeSecret);
+                    // 更新中
+                    if (Status === constant_1.SCF_STATUS.CREATING || Status === constant_1.SCF_STATUS.UPDATING)
+                        return;
+                    // 创建失败
+                    if (Status === constant_1.SCF_STATUS.CREATE_FAILED) {
+                        StatusDesc && console.log(`函数状态描述: ${StatusDesc}`);
+                        const errorDetails = StatusReasons.map(item => `[${item.ErrorCode}] ${item.ErrorMessage}`).join('\n');
+                        throw new error_1.CloudBaseError(`云函数创建失败\n失败信息: ${errorDetails}\nRequestId: ${RequestId}`);
+                    }
+                    // 函数状态正常
+                    clearInterval(ticker);
+                    clearTimeout(timer);
+                    resolve();
+                }
+                catch (e) {
+                    clearInterval(ticker);
+                    clearTimeout(timer);
+                    reject(e);
+                }
+                resolved = true;
+            }, 1000);
+        });
+    }
     /**
      * 设置预置并发
      * @private
@@ -1104,6 +1145,56 @@ class FunctionService {
             Namespace: namespace
         });
     }
+    async uploadFunctionZipToCos(options, installDependency) {
+        const { func, functionPath, functionRootPath, base64Code } = options;
+        const { env } = await this.getFunctionConfig();
+        const { CloudAppId } = await this.userService.getTcbAccountInfo();
+        const objectPath = `${CloudAppId}/${env}/${func.name}.zip`;
+        console.log('objectPath', objectPath);
+        // 1. 生成存放函数包的临时 Cos 目录
+        const { Date, Sign, RequestId } = await this.scfService.request('GetTempCosInfo', {
+            ObjectPath: `${objectPath}`
+        });
+        // 2. 本地压缩
+        const codeType = packer_1.CodeType.File;
+        // 云端安装依赖，自动忽略 node_modules 目录
+        const ignore = installDependency === 'TRUE'
+            ? ['node_modules/**/*', 'node_modules', ...(func.ignore || [])]
+            : [...(func.ignore || [])];
+        const packer = new packer_1.FunctionPacker({
+            ignore,
+            codeType,
+            functionPath,
+            name: func.name,
+            root: functionRootPath
+        });
+        const zipFilePath = await packer.compressFiles();
+        // 3. 初始化 cos 并上传
+        const tempCosObjectName = `/${Date}/${objectPath}`;
+        const TEMP_COS_APPID = '1253665819';
+        const uploadParams = {
+            Bucket: `shtempcos-${TEMP_COS_APPID}`,
+            Key: tempCosObjectName,
+            Region: 'ap-shanghai',
+            FilePath: zipFilePath,
+        };
+        const cos = new cos_nodejs_sdk_v5_1.default({
+            getAuthorization: function (options, callback) {
+                // 注入上一步获取的临时密钥
+                callback(Sign);
+            }
+        });
+        return new Promise((resolve, reject) => {
+            cos.sliceUploadFile(uploadParams, (err, data) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(data);
+                }
+            });
+        });
+    }
     async createAccessPath(name, path) {
         const access = this.environment.getAccessService();
         try {
@@ -1250,45 +1341,6 @@ class FunctionService {
         });
         return SubnetSet;
     }
-    // 检查函数状态，部分操作在函数更新中时不可进行
-    async waitFunctionActive(funcName, codeSecret) {
-        let ticker;
-        let timer;
-        let resolved;
-        return new Promise((resolve, reject) => {
-            // 超时时间 5 分钟
-            timer = setTimeout(() => {
-                clearInterval(ticker);
-                if (!resolved) {
-                    reject(new error_1.CloudBaseError('函数状态异常，检查超时'));
-                }
-            }, 300000);
-            ticker = setInterval(async () => {
-                try {
-                    const { Status, StatusDesc, StatusReasons, RequestId } = await this.getFunctionDetail(funcName, codeSecret);
-                    // 更新中
-                    if (Status === constant_1.SCF_STATUS.CREATING || Status === constant_1.SCF_STATUS.UPDATING)
-                        return;
-                    // 创建失败
-                    if (Status === constant_1.SCF_STATUS.CREATE_FAILED) {
-                        StatusDesc && console.log(`函数状态描述: ${StatusDesc}`);
-                        const errorDetails = StatusReasons.map(item => `[${item.ErrorCode}] ${item.ErrorMessage}`).join('\n');
-                        throw new error_1.CloudBaseError(`云函数创建失败\n失败信息: ${errorDetails}\nRequestId: ${RequestId}`);
-                    }
-                    // 函数状态正常
-                    clearInterval(ticker);
-                    clearTimeout(timer);
-                    resolve();
-                }
-                catch (e) {
-                    clearInterval(ticker);
-                    clearTimeout(timer);
-                    reject(e);
-                }
-                resolved = true;
-            }, 1000);
-        });
-    }
 }
 exports.FunctionService = FunctionService;
 __decorate([
@@ -1399,6 +1451,9 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "getFunctionAlias", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], FunctionService.prototype, "uploadFunctionZipToCos", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "createAccessPath", null);

package/lib/function/packer.js

@@ -88,6 +88,7 @@ class FunctionPacker {
             zipOption.pattern = this.incrementalPath;
         }
         await (0, utils_1.compressToZip)(zipOption);
+        return this.zipFilePath;
     }
     // 获取 Java 代码
     getJavaFile() {

package/lib/user/index.js

@@ -111,6 +111,9 @@ class UserService {
                 }]
         });
     }
+    async getTcbAccountInfo() {
+        return this.tcbService.request('DescribeTcbAccountInfo');
+    }
     isValidStr(obj) {
         return typeof obj === 'string' && obj.trim().length > 0;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "4.6.4",
+    "version": "4.7.0-beta.0",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/agent/index.d.ts

@@ -1,14 +1,19 @@
 import { Environment } from '../environment';
-import { ICreateFunctionAgentParams } from './type';
+import { IResponseInfo } from '../interfaces';
+import { ICreateFunctionAgentParams, ICreateAgentParams, IAgentListItem, IListAgentsParams, IListAgentsResponse, IDeleteAgentParams } from './type';
 /**
  * Agent 管理类
+ * 提供新版 Agent 的完整生命周期管理功能
  */
 export declare class AgentService {
     private environment;
     private tcbService;
+    private scfService;
+    private functionService;
+    private userService;
     constructor(environment: Environment);
     /**
-     * 创建函数型 Agent
+     * 创建函数型 Agent（兼容旧版本）
      * @param {string} [cwd=process.cwd()] 工作目录
      * @param {ICreateFunctionAgentParams} agentInfo Agent 信息
      * @returns {Promise<{ BotId: string; RequestId: string }>} Agent 创建结果
@@ -17,4 +22,33 @@ export declare class AgentService {
         BotId: string;
         RequestId: string;
     }>;
+    /**
+     * 部署新版 Agent 到 web云函数
+     * @param {ICreateAgentParams} params 创建参数
+     * @returns {Promise<IResponseInfo>} 创建结果
+     */
+    deployWebFn(params: ICreateAgentParams, isFirstDeploy?: boolean): Promise<IResponseInfo & {
+        AgentId?: string;
+    }>;
+    /**
+     * 获取 Agent 列表
+     * @param {IListAgentsParams} [params] 查询参数
+     * @returns {Promise<IListAgentsResponse>} Agent 列表
+     */
+    list(params?: IListAgentsParams): Promise<IListAgentsResponse>;
+    /**
+     * 获取 Agent 详情
+     * @param {object} params 查询参数
+     * @param {string} params.agentId Agent ID
+     * @returns {Promise<IAgentDetailResponse>} Agent 详情
+     */
+    getAgentInfo(params: {
+        agentId: string;
+    }): Promise<IAgentListItem | null>;
+    /**
+     * 删除 Agent
+     * @param {IDeleteAgentParams} params 删除参数
+     * @returns {Promise<IResponseInfo>} 删除结果
+     */
+    delete(params: IDeleteAgentParams): Promise<IResponseInfo>;
 }

package/types/agent/type.d.ts

@@ -20,3 +20,357 @@ export interface ICreateFunctionAgentParams {
      */
     Avatar?: string;
 }
+export interface IEnvironmentVariable {
+    Name: string;
+    Value: string;
+}
+export interface IEnvironment {
+    Variables: IEnvironmentVariable[];
+}
+/**
+ * Agent 配置接口
+ */
+export interface IAgentConfig {
+    /**
+     * 函数名称
+     */
+    functionName: string;
+    /**
+     * 代码结构
+     */
+    code?: {
+        cosBucketRegion?: string;
+        cosBucketName?: string;
+        cosObjectName?: string;
+        tempCosObjectName?: string;
+        zipFile?: string;
+    };
+    /**
+     * 超时时间（秒）
+     */
+    timeout?: number;
+    /**
+     * 环境变量
+     */
+    environment?: IEnvironment;
+    /**
+     * 运行时
+     */
+    runtime?: string;
+    /**
+     * 内存大小（MB）
+     */
+    memorySize?: number;
+    /**
+     * 描述
+     */
+    description?: string;
+    /**
+     * 会话配置
+     */
+    sessionConfig?: {
+        enable: boolean;
+    };
+    /**
+     * 绑定的资源
+     */
+    resourceList?: IAgentResource[];
+    /**
+     * 忽略的文件或目录
+     */
+    ignore?: string[];
+    installDependency?: boolean;
+}
+/**
+ * Agent 资源接口
+ */
+export interface IAgentResource {
+    agentId: string;
+    /**
+     * 资源 ID
+     */
+    resourceId: string;
+    /**
+     * 资源类型
+     */
+    resourceType: string;
+    /**
+     * 子类型
+     */
+    subType: string;
+    /**
+     * 资源配置
+     */
+    resourceConfig: {
+        apiKey: string;
+    };
+}
+/**
+ * Agent 创建参数
+ */
+export interface ICreateAgentParams {
+    /**
+     * Agent ID
+     */
+    agentId?: string;
+    /**
+     * Agent 名称
+     */
+    name: string;
+    /**
+     * 指定的 Agent 路径
+     */
+    agentPath: string;
+    /**
+     * Agent 根路径
+     */
+    agentRootPath: string;
+    deployConfig: IAgentConfig;
+}
+export interface ICreateAgentRes {
+    /**
+     *
+     */
+    agentId: string;
+}
+/**
+ * Agent 更新参数
+ */
+export type IUpdateAgentParams = ICreateAgentParams;
+/**
+ * Agent 列表查询参数
+ */
+export interface IListAgentsParams {
+    /**
+     * 每页数量
+     */
+    limit?: number;
+    /**
+     * 偏移量
+     */
+    offset?: number;
+    /**
+     * Agent ID
+     */
+    agentId?: string;
+}
+/**
+ * Agent 列表响应
+ */
+export interface IListAgentsResponse {
+    /**
+     * Agent 列表
+     */
+    AgentList: IAgentListItem[];
+    /**
+     * 总数
+     */
+    Total: number;
+}
+/**
+ * Agent 列表项
+ */
+export interface IAgentListItem {
+    /**
+     * Agent ID
+     */
+    AgentId: string;
+    /**
+     * Agent 名称
+     */
+    Name: string;
+    /**
+     * 状态
+     */
+    UpdateTime: string;
+    /**
+     * 运行时配置
+     */
+    RuntimeConfig: IRuntimeConfig;
+}
+export interface IRuntimeConfig {
+    Runtime: string;
+    MemorySize: number;
+    Timeout: number;
+    Environment: string;
+    SessionConfig: {
+        Enable: boolean;
+    };
+}
+export interface IAgentDetailParams {
+    agentId: string;
+}
+/**
+ * Agent 详情响应
+ */
+export interface IAgentDetailResponse {
+    /**
+     * Agent ID
+     */
+    id: string;
+    /**
+     * Agent 名称
+     */
+    name: string;
+    /**
+     * 状态
+     */
+    status: string;
+    /**
+     * 运行时
+     */
+    runtime: string;
+    /**
+     * 内存大小（MB）
+     */
+    memorySize: number;
+    /**
+     * 超时时间（秒）
+     */
+    timeout: number;
+    /**
+     * 描述
+     */
+    description: string;
+    /**
+     * 创建时间
+     */
+    createTime: string;
+    /**
+     * 更新时间
+     */
+    updateTime: string;
+    /**
+     * 环境变量
+     */
+    environment: IEnvironment;
+    /**
+     * 会话配置
+     */
+    sessionConfig: {
+        enable: boolean;
+    };
+    /**
+     * 绑定的资源
+     */
+    resources: IAgentResource[];
+    /**
+     * 部署信息
+     */
+    deployInfo?: {
+        mode: string;
+        version: string;
+        codeSize: number;
+        lastDeploy: string;
+    };
+}
+/**
+ * Agent 删除参数
+ */
+export interface IDeleteAgentParams {
+    /**
+     * Agent ID
+     */
+    agentId: string;
+}
+/**
+ * Agent 代码下载参数
+ */
+export interface IDownloadAgentCodeParams {
+    /**
+     * Agent ID
+     */
+    agentId: string;
+    /**
+     * 目标路径
+     */
+    targetPath: string;
+}
+/**
+ * 资源绑定参数
+ */
+export interface IBindResourceParams {
+    /**
+     * Agent ID
+     */
+    agentId: string;
+    /**
+     * 资源列表
+     */
+    resourceList: IAgentResource[];
+}
+export interface IBindResourceRes {
+    /**
+     * 受影响的行数
+     */
+    Affected: number;
+}
+/**
+ * 资源解绑参数
+ */
+export interface IUnbindResourceParams {
+    /**
+     * Agent ID
+     */
+    agentId: string;
+    /**
+     * 资源 ID
+     */
+    resourceId: string;
+}
+/**
+ * 资源解绑响应
+ */
+export interface IUnbindResourceRes {
+    /**
+     *
+     */
+    Affected: number;
+}
+/**
+ * 获取资源绑定参数
+ */
+export interface IGetResourceBindingParams {
+    /**
+     * Agent ID
+     */
+    agentId: string;
+    /**
+     * 资源 ID
+     */
+    resourceId: string;
+    /**
+     * 资源类型
+     */
+    resourceType: string;
+}
+/**
+ * 获取 Agent 资源参数
+ */
+export interface IGetAgentResourcesParams {
+    /**
+     * Agent ID
+     */
+    agentId: string;
+}
+/**
+ * 资源绑定响应
+ */
+export interface IResourceBindingResponse {
+    Total: number;
+    AgentResourceList: IAgentResource[];
+}
+/**
+ * Agent 资源响应
+ */
+export interface IAgentResourcesResponse {
+    /**
+     * 资源列表
+     */
+    resources: IAgentResource[];
+}
+export interface IAgentCodeOptions {
+    deployConfig: IAgentConfig;
+    agentRootPath?: string;
+    agentPath?: string;
+}

package/types/cloudrun/index.d.ts

@@ -99,7 +99,7 @@ export declare class CloudRunService {
     deploy(params: {
         serverName: string;
         targetPath: string;
-        serverConfig?: Partial<Pick<ICloudrunServerBaseConfig, 'OpenAccessTypes' | 'Cpu' | 'Mem' | 'MinNum' | 'MaxNum' | 'PolicyDetails' | 'CustomLogs' | 'EnvParams' | 'Port' | 'Dockerfile' | 'BuildDir' | 'InternalAccess' | 'InternalDomain' | 'EntryPoint' | 'Cmd'>>;
+        serverConfig?: Partial<Pick<ICloudrunServerBaseConfig, 'OpenAccessTypes' | 'Cpu' | 'Mem' | 'MinNum' | 'MaxNum' | 'PolicyDetails' | 'CustomLogs' | 'EnvParams' | 'Port' | 'Dockerfile' | 'BuildDir' | 'InternalAccess' | 'InternalDomain' | 'EntryPoint' | 'Cmd' | 'InstallDependency'>>;
     }): Promise<IResponseInfo>;
     /**
      * 获取云托管服务模板列表

package/types/cloudrun/type.d.ts

@@ -245,6 +245,10 @@ export interface ICloudrunServerBaseConfig {
      * @example ["echo", "test"]
      */
     Cmd?: string[];
+    /**
+     * 是否在线安装依赖，true 则本地不打包 node_modules，依赖在线装（如Docker）
+     */
+    InstallDependency?: boolean;
 }
 export interface IDiffConfigItem {
     Key: string;

package/types/function/index.d.ts

@@ -225,6 +225,7 @@ export declare class FunctionService {
     private vpcService;
     private scfService;
     private tcbService;
+    private userService;
     constructor(environment: Environment);
     /**
      * 增量更新函数代码
@@ -425,6 +426,7 @@ export declare class FunctionService {
     listLayerVersions(options: IVersionListOptions): Promise<IListLayerVersionsRes>;
     listLayers(options: ILayerListOptions): Promise<IListLayerRes>;
     getLayerVersion(options: ILayerOptions): Promise<IGetLayerVersionRes>;
+    waitFunctionActive(funcName: string, codeSecret?: string): Promise<void>;
     /**
      * 设置预置并发
      * @private
@@ -477,6 +479,9 @@ export declare class FunctionService {
      * @memberof FunctionService
      */
     getFunctionAlias(params: IGetFunctionAlias): Promise<IGetFunctionAliasRes>;
+    uploadFunctionZipToCos(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
+        Key: string;
+    }>;
     private createAccessPath;
     private getCodeParams;
     private getTempCosInfo;
@@ -503,5 +508,4 @@ export declare class FunctionService {
      * @returns
      */
     private getSubnets;
-    private waitFunctionActive;
 }

package/types/function/packer.d.ts

@@ -27,7 +27,7 @@ export declare class FunctionPacker {
     incrementalPath: string;
     codeType: CodeType;
     constructor(options: IPackerOptions);
-    compressFiles(): Promise<void>;
+    compressFiles(): Promise<string>;
     getJavaFile(): void;
     build(): Promise<void>;
     isBigFile(): Promise<boolean>;

package/types/user/index.d.ts

@@ -48,5 +48,11 @@ export declare class UserService {
     }): Promise<{
         RequestId: string;
     }>;
+    getTcbAccountInfo(): Promise<{
+        CloudUin: string;
+        CloudAppId: string;
+        WxAppId: string;
+        Channel: "ide" | "low_code";
+    }>;
     private isValidStr;
 }