@cloudbase/manager-node 4.11.0-alpha.5 → 4.11.0-alpha.7

package/lib/function/index.js

@@ -924,6 +924,56 @@ class FunctionService {
             });
         }
     }
+    /**
+     * 更新函数代码和配置（带进度信息）
+     * 支持同时更新代码和配置，按顺序执行：等待就绪 → 更新代码 → 等待就绪 → 更新配置 → 等待就绪
+     * @param options 更新选项
+     * @returns 更新结果，包含耗时信息
+     */
+    async updateFunctionWithProgress(options) {
+        const { name, code, config } = options;
+        const startTime = Date.now();
+        const details = [];
+        // codeSecret 在不同阶段可能不同：
+        // - 更新代码前/后：用旧的 codeSecret（函数此时还是旧密钥）
+        // - 更新配置后：如果 config 中带了新 codeSecret，函数密钥已变更，需用新值
+        const oldCodeSecret = (code === null || code === void 0 ? void 0 : code.codeSecret) || (config === null || config === void 0 ? void 0 : config.codeSecret);
+        const newCodeSecret = (config === null || config === void 0 ? void 0 : config.codeSecret) || (code === null || code === void 0 ? void 0 : code.codeSecret);
+        // 1. 等待函数状态就绪（此时函数还是旧密钥）
+        details.push('等待函数状态就绪...');
+        await this.waitFunctionActive(name, oldCodeSecret);
+        details.push(`函数状态就绪 (${Math.round((Date.now() - startTime) / 1000)}s)`);
+        // 2. 更新代码
+        if (code && (code.functionPath || code.base64Code)) {
+            details.push('开始更新代码...');
+            await this.updateFunctionCode(Object.assign({ func: {
+                    name,
+                    // 从 config 取公共字段
+                    runtime: config === null || config === void 0 ? void 0 : config.runtime,
+                    installDependency: config === null || config === void 0 ? void 0 : config.installDependency,
+                    ignore: config === null || config === void 0 ? void 0 : config.ignore,
+                    codeSecret: oldCodeSecret
+                } }, code));
+            details.push(`代码更新完成 (${Math.round((Date.now() - startTime) / 1000)}s)`);
+            // 等待函数再次就绪（代码更新不改变 codeSecret，仍用旧值）
+            await this.waitFunctionActive(name, oldCodeSecret);
+        }
+        // 3. 更新配置
+        if (config) {
+            details.push('开始更新配置...');
+            await this.updateFunctionConfig(Object.assign({ name }, config));
+            details.push(`配置更新完成 (${Math.round((Date.now() - startTime) / 1000)}s)`);
+            // 等待函数再次就绪（配置更新后 codeSecret 可能已变更，用新值）
+            await this.waitFunctionActive(name, newCodeSecret);
+        }
+        const elapsedTime = Date.now() - startTime;
+        details.push(`全部更新完成 (${Math.round(elapsedTime / 1000)}s)`);
+        return {
+            elapsedTime,
+            message: `更新成功，总耗时 ${Math.round(elapsedTime / 1000)}s`,
+            details
+        };
+    }
     /**
      * 调用云函数
      * @param {string} name 云函数名称
@@ -1471,7 +1521,13 @@ class FunctionService {
             }
         });
         return new Promise((resolve, reject) => {
+            // 添加超时保护
+            const timeout = setTimeout(() => {
+                packer.clean();
+                reject(new error_1.CloudBaseError(`[${func.name}] COS 上传超时（60秒）`));
+            }, 60000);
             cos.sliceUploadFile(uploadParams, async (err, data) => {
+                clearTimeout(timeout);
                 // 清理临时文件
                 await packer.clean();
                 if (err) {
@@ -1550,29 +1606,6 @@ class FunctionService {
             UnixTimestamp
         };
     }
-    async createAccessPath(name, path) {
-        const access = this.environment.getAccessService();
-        try {
-            await access.createAccess({
-                name,
-                path
-            });
-        }
-        catch (e) {
-            // 当 Path 存在时，校验 Path 绑定的函数是不是当前函数
-            if (e.code === 'InvalidParameter.APICreated') {
-                const { APISet } = await access.getAccessList({
-                    name
-                });
-                if ((APISet === null || APISet === void 0 ? void 0 : APISet[0].Name) !== name || (APISet === null || APISet === void 0 ? void 0 : APISet[0].Type) !== 1) {
-                    throw e;
-                }
-            }
-            else {
-                throw e;
-            }
-        }
-    }
     async getCodeParams(options, installDependency) {
         const { func, functionPath, functionRootPath, base64Code, deployMode } = options;
         // 直接传入 base64Code 的情况，校验大小
@@ -1625,6 +1658,29 @@ class FunctionService {
             TempCosObjectName: `/${legacyResult.Key}`
         };
     }
+    async createAccessPath(name, path) {
+        const access = this.environment.getAccessService();
+        try {
+            await access.createAccess({
+                name,
+                path
+            });
+        }
+        catch (e) {
+            // 当 Path 存在时，校验 Path 绑定的函数是不是当前函数
+            if (e.code === 'InvalidParameter.APICreated') {
+                const { APISet } = await access.getAccessList({
+                    name
+                });
+                if ((APISet === null || APISet === void 0 ? void 0 : APISet[0].Name) !== name || (APISet === null || APISet === void 0 ? void 0 : APISet[0].Type) !== 1) {
+                    throw e;
+                }
+            }
+            else {
+                throw e;
+            }
+        }
+    }
     // 获取 COS 临时信息
     async getTempCosInfo(name) {
         const { env, appId } = await this.getFunctionConfig();
@@ -1755,6 +1811,9 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "updateFunctionCode", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], FunctionService.prototype, "updateFunctionWithProgress", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "invokeFunction", null);
@@ -1829,10 +1888,10 @@ __decorate([
 ], FunctionService.prototype, "uploadFunctionZipToCos", null);
 __decorate([
     (0, utils_1.preLazy)()
-], FunctionService.prototype, "createAccessPath", null);
+], FunctionService.prototype, "getCodeParams", null);
 __decorate([
     (0, utils_1.preLazy)()
-], FunctionService.prototype, "getCodeParams", null);
+], FunctionService.prototype, "createAccessPath", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "getTempCosInfo", null);

package/lib/index.js

@@ -79,6 +79,9 @@ class CloudBase {
     get env() {
         return this.currentEnvironment().getEnvService();
     }
+    get log() {
+        return this.currentEnvironment().getLogService();
+    }
     get third() {
         return this.currentEnvironment().getThirdService();
     }

package/lib/log/index.js

@@ -0,0 +1,57 @@
+"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 });
+exports.LogService = void 0;
+const utils_1 = require("../utils");
+__exportStar(require("./types"), exports);
+class LogService {
+    constructor(environment) {
+        this.envId = environment.getEnvId();
+        this.cloudService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+        this.tcbrService = new utils_1.CloudService(environment.cloudBaseContext, 'tcbr', '2022-02-17');
+    }
+    /**
+     * 搜索 CLS 日志
+     *
+     * @param params 查询参数，通过 queryString 使用 CLS 原生检索分析语法
+     * @returns 日志搜索结果
+     *
+     * @remarks
+     * - 纯检索结果在 `LogResults.Results` 中
+     * - SQL 分析结果（queryString 含 `| select ...`）在 `LogResults.AnalysisRecords` 中
+     * - 详细的 QueryString 语法参考见 README.md
+     */
+    async searchClsLog(params) {
+        const { queryString, StartTime, EndTime, Limit, Context, Sort, UseLucene, service } = params;
+        const requestService = service === 'tcbr' ? this.tcbrService : this.cloudService;
+        const requestParams = {
+            EnvId: this.envId,
+            StartTime,
+            EndTime,
+            QueryString: queryString,
+            Limit,
+            Context,
+            Sort,
+            UseLucene
+        };
+        // TenantModel 仅 tcb 服务需要，tcbr 不支持该参数
+        if (service !== 'tcbr') {
+            requestParams.TenantModel = 'public';
+        }
+        return requestService.request('SearchClsLog', requestParams);
+    }
+}
+exports.LogService = LogService;

package/lib/log/types.js

@@ -0,0 +1,24 @@
+"use strict";
+// =====================================================
+// CLS 日志字段枚举 & Module 查询 Schema
+// =====================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLS_MODULE_SCHEMA = void 0;
+// =====================================================
+// CLS Module 运行时常量
+// =====================================================
+/**
+ * ClsModuleSchema 的运行时版本，用于动态生成查询条件 / MCP tool description
+ *
+ * - key 与 ClsLogModule 类型保持同步
+ * - eventTypes / logTypes 为字符串数组，空数组表示该维度不可过滤
+ */
+exports.CLS_MODULE_SCHEMA = {
+    database: { label: '云数据库(文档型)', eventTypes: ['MongoSlowQuery'], logTypes: [] },
+    rdb: { label: '云数据库(SQL型)', eventTypes: ['MysqlFreeze', 'MysqlRecover', 'MysqlSlowQuery'], logTypes: [] },
+    model: { label: '数据模型', eventTypes: [], logTypes: [] },
+    workflow: { label: '审批流', eventTypes: [], logTypes: [] },
+    auth: { label: '用户权限', eventTypes: [], logTypes: [] },
+    llm: { label: '大模型', eventTypes: [], logTypes: ['llm-tracelog'] },
+    app: { label: '应用', eventTypes: ['AppProdPub', 'AppProdDel'], logTypes: [] },
+};

package/lib/user/index.js

@@ -114,6 +114,194 @@ class UserService {
     async getTcbAccountInfo() {
         return this.tcbService.request('DescribeTcbAccountInfo');
     }
+    async createUser(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { name, uid, type, password, userStatus, nickName, phone, email, avatarUrl, description } = options;
+        // name 校验：1-64，字母/数字开头，仅字母数字._-
+        if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(name)) {
+            throw new Error('Invalid name');
+        }
+        // uid 校验：<=64
+        if (uid && uid.length > 64) {
+            throw new Error('Invalid uid');
+        }
+        // type / status 白名单
+        if (type && !['internalUser', 'externalUser'].includes(type)) {
+            throw new Error('Invalid type');
+        }
+        if (userStatus && !['ACTIVE', 'BLOCKED'].includes(userStatus)) {
+            throw new Error('Invalid userStatus');
+        }
+        if (password) {
+            if (password.length < 8 || password.length > 32) {
+                throw new Error('Invalid password length');
+            }
+            if (!/^[A-Za-z0-9]/.test(password)) {
+                throw new Error('Password cannot start with special character');
+            }
+            const kinds = [
+                /[a-z]/.test(password),
+                /[A-Z]/.test(password),
+                /[0-9]/.test(password),
+                /[()!@#$%^&*|?><_-]/.test(password)
+            ].filter(Boolean).length;
+            if (kinds < 3) {
+                throw new Error('Password must include at least 3 character categories');
+            }
+        }
+        // 其他字段校验
+        if (nickName && (nickName.length < 2 || nickName.length > 64)) {
+            throw new Error('Invalid nickName');
+        }
+        if (description && description.length > 200) {
+            throw new Error('Invalid description');
+        }
+        if (phone && !/^1\d{10}$/.test(phone)) {
+            throw new Error('Invalid phone');
+        }
+        if (email && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+            throw new Error('Invalid email');
+        }
+        const reqData = {
+            EnvId,
+            Name: name
+        };
+        if (uid)
+            reqData.Uid = uid;
+        if (type)
+            reqData.Type = type;
+        if (password)
+            reqData.Password = password;
+        if (userStatus)
+            reqData.UserStatus = userStatus;
+        if (nickName)
+            reqData.NickName = nickName;
+        if (phone)
+            reqData.Phone = phone;
+        if (email)
+            reqData.Email = email;
+        if (avatarUrl)
+            reqData.AvatarUrl = avatarUrl;
+        if (description)
+            reqData.Description = description;
+        return this.tcbService.request('CreateUser', reqData);
+    }
+    async describeUserList(options = {}) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { pageNo = 1, pageSize = 20, name, nickName, phone, email } = options;
+        if (!Number.isInteger(pageNo) || pageNo < 1) {
+            throw new Error('Invalid pageNo');
+        }
+        if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) {
+            throw new Error('Invalid pageSize');
+        }
+        const reqData = {
+            EnvId,
+            PageNo: pageNo,
+            PageSize: pageSize
+        };
+        if (this.isValidStr(name))
+            reqData.Name = name;
+        if (this.isValidStr(nickName))
+            reqData.NickName = nickName;
+        if (this.isValidStr(phone))
+            reqData.Phone = phone;
+        if (this.isValidStr(email))
+            reqData.Email = email;
+        return this.tcbService.request('DescribeUserList', reqData);
+    }
+    async modifyUser(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { uid, name, type, password, userStatus, nickName, phone, email, avatarUrl, description } = options;
+        if (!this.isValidStr(uid) || uid.length > 64) {
+            throw new Error('Invalid uid');
+        }
+        // Name: 不传或空字符串 => 不修改；传了非空则校验
+        if (name !== undefined && name !== '' && !/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(name)) {
+            throw new Error('Invalid name');
+        }
+        // Type / UserStatus: 不传或空字符串 => 不修改；非空时白名单校验
+        if (type !== undefined && !['internalUser', 'externalUser'].includes(type)) {
+            throw new Error('Invalid type');
+        }
+        if (userStatus !== undefined && !['ACTIVE', 'BLOCKED'].includes(userStatus)) {
+            throw new Error('Invalid userStatus');
+        }
+        // Password: 不传或空字符串 => 不修改；非空时校验复杂度
+        if (password !== undefined && password !== '') {
+            if (password.length < 8 || password.length > 32) {
+                throw new Error('Invalid password length');
+            }
+            if (!/^[A-Za-z0-9]/.test(password)) {
+                throw new Error('Password cannot start with special character');
+            }
+            const kinds = [
+                /[a-z]/.test(password),
+                /[A-Z]/.test(password),
+                /[0-9]/.test(password),
+                /[()!@#$%^&*|?><_-]/.test(password)
+            ].filter(Boolean).length;
+            if (kinds < 3) {
+                throw new Error('Password must include at least 3 character categories');
+            }
+        }
+        // 这些字段：不传 => 不修改；传空字符串 => 清空（允许）
+        if (nickName !== undefined && nickName !== '' && (nickName.length < 2 || nickName.length > 64)) {
+            throw new Error('Invalid nickName');
+        }
+        if (phone !== undefined && phone !== '' && !/^1\d{10}$/.test(phone)) {
+            throw new Error('Invalid phone');
+        }
+        if (email !== undefined && email !== '' && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+            throw new Error('Invalid email');
+        }
+        if (description !== undefined && description !== '' && description.length > 200) {
+            throw new Error('Invalid description');
+        }
+        const reqData = {
+            EnvId,
+            Uid: uid
+        };
+        // Name/Type/Password/UserStatus：空字符串视为不修改
+        if (name !== undefined && name !== '')
+            reqData.Name = name;
+        if (type !== undefined)
+            reqData.Type = type;
+        if (password !== undefined && password !== '')
+            reqData.Password = password;
+        if (userStatus !== undefined)
+            reqData.UserStatus = userStatus;
+        // 这些字段支持传空字符串清空：只要“传了”就下发
+        if (Object.prototype.hasOwnProperty.call(options, 'nickName'))
+            reqData.NickName = nickName;
+        if (Object.prototype.hasOwnProperty.call(options, 'phone'))
+            reqData.Phone = phone;
+        if (Object.prototype.hasOwnProperty.call(options, 'email'))
+            reqData.Email = email;
+        if (Object.prototype.hasOwnProperty.call(options, 'avatarUrl'))
+            reqData.AvatarUrl = avatarUrl;
+        if (Object.prototype.hasOwnProperty.call(options, 'description'))
+            reqData.Description = description;
+        return this.tcbService.request('ModifyUser', reqData);
+    }
+    async deleteUsers(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { uids } = options;
+        if (!Array.isArray(uids) || uids.length === 0) {
+            throw new Error('uids is required');
+        }
+        if (uids.length > 100) {
+            throw new Error('uids length must be <= 100');
+        }
+        const invalidUid = uids.find(uid => !this.isValidStr(uid));
+        if (invalidUid) {
+            throw new Error('Invalid uid in uids');
+        }
+        return this.tcbService.request('DeleteUsers', {
+            EnvId,
+            Uids: uids
+        });
+    }
     isValidStr(obj) {
         return typeof obj === 'string' && obj.trim().length > 0;
     }
@@ -137,3 +325,15 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], UserService.prototype, "updateEndUser", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], UserService.prototype, "createUser", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], UserService.prototype, "describeUserList", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], UserService.prototype, "modifyUser", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], UserService.prototype, "deleteUsers", null);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "4.11.0-alpha.5",
+    "version": "4.11.0-alpha.7",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/agent/index.d.ts

@@ -1,17 +1,127 @@
 import { Environment } from '../environment';
-import { ICreateFunctionAgentParams } from './type';
+import { ICreateFunctionAgentParams, ICreateScfAgentParams, ICreateTcbrAgentByImageParams, ICreateTcbrAgentByPackageParams, ICreateTcbrAgentByCodeParams, IDescribeAgentListParams, IDescribeAgentListResponse, IDescribeAgentResponse, IDeleteAgentParams, IDescribeCloudBaseBuildServiceParams, IDescribeCloudBaseBuildServiceResponse, ICreateAgentResponse, IDeleteAgentResponse, ICommonResponse, IUpdateAgentParams, IUpdateScfAgentParams, IUpdateScfAgentResponse, IUpdateTcbrAgentParams, IGetAgentLogsParams } from './type';
 /**
  * Agent 管理类
+ * 支持三种部署方式：
+ * - SCF 云函数：轻量级、按需计费
+ * - TCBR 云托管-镜像：容器化部署
+ * - TCBR 云托管-代码包：源码部署
  */
 export declare class AgentService {
     private environment;
     private tcbService;
     constructor(environment: Environment);
     /**
-     * 创建函数型 Agent
-     * @param {string} [cwd=process.cwd()] 工作目录
-     * @param {ICreateFunctionAgentParams} agentInfo Agent 信息
-     * @returns {Promise<{ BotId: string; RequestId: string }>} Agent 创建结果
+     * 创建 SCF Agent
+     * 支持两种方式：
+     * 1. 传入 cwd 代码目录，自动打包上传
+     * 2. 传入 ZipFile / CosBucketRegion + TempCosObjectName，直接上传
+     * @param params 创建参数
+     * @returns Agent 创建结果
+     */
+    createScfAgent(params: ICreateScfAgentParams): Promise<ICreateAgentResponse>;
+    /**
+     * 查询 Agent 列表
+     * @param params 查询参数
+     * @returns Agent 列表
+     */
+    describeAgentList(params?: IDescribeAgentListParams): Promise<IDescribeAgentListResponse>;
+    /**
+     * 查询单个 Agent 详情（包含可用状态）
+     * @param agentId Agent ID
+     * @returns Agent 详情，IsReady 表示是否可用
+     * @example
+     * ```typescript
+     * const result = await agentService.describeAgent('agent-xxx')
+     * if (result.IsReady) {
+     *     console.log('Agent 已就绪，可以调用')
+     * } else {
+     *     console.log('Agent 不可用:', result.NotReadyReason)
+     * }
+     * ```
+     */
+    describeAgent(agentId: string): Promise<IDescribeAgentResponse>;
+    /**
+     * 删除 Agent
+     * 先删除 Agent 记录，再尝试删除底层的云函数或云托管服务
+     * @param params 删除参数
+     * @returns 操作结果，包含 Agent 和底层资源的删除状态
+     */
+    deleteAgent(params: IDeleteAgentParams): Promise<IDeleteAgentResponse>;
+    /**
+     * 更新 Agent（自动判断类型）
+     * 先查询 Agent 类型，然后调用对应的更新方法
+     * @param params 更新参数
+     * @returns 操作结果
+     */
+    updateAgent(params: IUpdateAgentParams): Promise<IUpdateScfAgentResponse>;
+    /**
+     * 更新 SCF Agent（云函数）
+     * 支持两种方式：本地代码目录、ZIP 文件
+     * @param params 更新参数
+     * @returns 更新结果，包含耗时信息
+     */
+    updateScfAgent(params: IUpdateScfAgentParams): Promise<IUpdateScfAgentResponse>;
+    /**
+     * 获取 Agent 调用日志（自动判断类型）
+     * @param params 查询参数
+     * @returns 日志结果，根据 Agent 类型返回不同结构：
+     *   - SCF: IFunctionLogDetailRes[]
+     *   - TCBR: ISearchClsLogResponse
+     * @example
+     * ```typescript
+     * const logs = await agentService.getAgentLogs({
+     *     AgentId: 'agent-xxx',
+     *     limit: 20,
+     *     startTime: '2025-01-01 00:00:00',
+     *     endTime: '2025-01-01 23:59:59'
+     * })
+     * ```
+     */
+    getAgentLogs(params: IGetAgentLogsParams): Promise<any>;
+    /**
+     * 通过镜像创建 TCBR Agent
+     * @internal 暂不对外暴露，后续版本开放
+     * @param params 创建参数
+     * @returns Agent 创建结果
+     */
+    createTcbrAgentByImage(params: ICreateTcbrAgentByImageParams): Promise<ICreateAgentResponse>;
+    /**
+     * 获取代码包上传信息
+     * @internal 暂不对外暴露，后续版本开放
+     * @param params 查询参数
+     * @returns 上传信息
+     */
+    describeCloudBaseBuildService(params: IDescribeCloudBaseBuildServiceParams): Promise<IDescribeCloudBaseBuildServiceResponse>;
+    /**
+     * 通过代码包信息创建 TCBR Agent（已上传代码包）
+     * @internal 暂不对外暴露，后续版本开放
+     * @param params 创建参数
+     * @returns Agent 创建结果
+     */
+    createTcbrAgentByPackage(params: ICreateTcbrAgentByPackageParams): Promise<ICreateAgentResponse>;
+    /**
+     * 通过本地代码创建 TCBR Agent（自动打包上传）
+     * @internal 暂不对外暴露，后续版本开放
+     * @param cwd 代码目录，默认当前工作目录
+     * @param params 创建参数
+     * @returns Agent 创建结果
+     */
+    createTcbrAgentByCode(cwd: string, params: ICreateTcbrAgentByCodeParams): Promise<ICreateAgentResponse>;
+    /**
+     * 更新 TCBR Agent（云托管）
+     * 支持两种方式：本地代码目录、镜像
+     * @internal 暂不对外暴露，后续版本开放
+     * @param params 更新参数
+     * @returns 操作结果
+     */
+    updateTcbrAgent(params: IUpdateTcbrAgentParams): Promise<ICommonResponse>;
+    /**
+     * @deprecated 请使用 createTcbrAgentByCode
+     * 创建函数型 Agent（旧版）
+     * @param cwd 工作目录
+     * @param agentInfo Agent 信息
+     * @returns Agent 创建结果
      */
     createFunctionAgent(cwd: string, agentInfo: ICreateFunctionAgentParams): Promise<{
         BotId: string;