@cloudbase/cloudbase-mcp 2.28.0 → 2.29.0

package/dist/index.cjs

@@ -86626,6 +86626,182 @@ class Profiler {
 module.exports = Profiler;
 
 
+/***/ }),
+
+/***/ 23656:
+/***/ ((__unused_webpack_module, exports) => {
+
+"use strict";
+
+/**
+ * Guidance + bounded wait when a cloud function is not Active.
+ * SCF rejects UpdateFunctionConfiguration / UpdateFunctionCode while Status=Updating.
+ */
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.functionUpdatingRuntime = exports.FUNCTION_UPDATING_WAIT = exports.FUNCTION_BUSY_STATUSES = exports.FUNCTION_UPDATING_RETRY_AFTER_SECONDS = exports.FUNCTION_UPDATING_ERROR_CODE = void 0;
+exports.getErrorMessage = getErrorMessage;
+exports.isFunctionBusyStatus = isFunctionBusyStatus;
+exports.isFunctionUpdatingError = isFunctionUpdatingError;
+exports.buildFunctionUpdatingMessage = buildFunctionUpdatingMessage;
+exports.buildFunctionUpdatingNextActions = buildFunctionUpdatingNextActions;
+exports.buildFunctionUpdatingPayload = buildFunctionUpdatingPayload;
+exports.waitUntilFunctionActive = waitUntilFunctionActive;
+exports.FUNCTION_UPDATING_ERROR_CODE = "FUNCTION_UPDATING";
+/** Agents must wait at least this long before retrying the same write. */
+exports.FUNCTION_UPDATING_RETRY_AFTER_SECONDS = 10;
+exports.FUNCTION_BUSY_STATUSES = [
+    "Updating",
+    "Creating",
+    "Publishing",
+    "Deleting",
+];
+exports.FUNCTION_UPDATING_WAIT = {
+    intervalMs: 2000,
+    maxAttempts: 5,
+    timeoutMs: 12_000,
+};
+/**
+ * Injectable sleep for unit tests. Production uses setTimeout.
+ * Tests must restore the original function in afterEach.
+ */
+exports.functionUpdatingRuntime = {
+    sleep: (ms) => new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    }),
+};
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function isFunctionBusyStatus(status) {
+    if (typeof status !== "string") {
+        return false;
+    }
+    return exports.FUNCTION_BUSY_STATUSES.includes(status);
+}
+const UPDATING_ERROR_PATTERNS = [
+    /当前函数处于\s*Updating/i,
+    /函数处于\s*Updating/i,
+    /currently\s+(?:in\s+)?updating/i,
+    /function\s+is\s+(?:currently\s+)?updating/i,
+    /Status\s*(?:is|=|:)?\s*Updating/i,
+    /scf\/UpdateFunction(?:Configuration|Code).{0,80}Updating/i,
+    /函数状态异常，检查超时/,
+];
+function isFunctionUpdatingError(error) {
+    const message = getErrorMessage(error);
+    return UPDATING_ERROR_PATTERNS.some((pattern) => pattern.test(message));
+}
+function buildFunctionUpdatingMessage(params) {
+    const namePart = params.functionName
+        ? `函数 \`${params.functionName}\``
+        : "目标函数";
+    const statusPart = params.status ? `（当前 Status=${params.status}）` : "";
+    const lines = [
+        `${namePart} 尚未就绪${statusPart}，无法执行 manageFunctions(action="${params.action}")。`,
+        `不要立即重试同一写操作（SCF 会在 Updating 期间连续拒绝 UpdateFunctionConfiguration / UpdateFunctionCode）。`,
+        `请等待 ${exports.FUNCTION_UPDATING_RETRY_AFTER_SECONDS} 秒后重试，或先调用 queryFunctions(action="getFunctionDetail") 确认 Status 为 Active。`,
+    ];
+    if (params.rawMessage) {
+        lines.push(`原始错误: ${params.rawMessage}`);
+    }
+    return lines.join("\n");
+}
+function buildFunctionUpdatingNextActions(params) {
+    const functionName = params.functionName;
+    return [
+        {
+            tool: "queryFunctions",
+            action: "getFunctionDetail",
+            reason: "查看函数 Status，等到 Active 后再写配置/代码",
+            suggested_args: {
+                action: "getFunctionDetail",
+                ...(functionName ? { functionName } : {}),
+            },
+        },
+        {
+            tool: "manageFunctions",
+            action: params.action,
+            reason: `等待 ${exports.FUNCTION_UPDATING_RETRY_AFTER_SECONDS} 秒且 Status=Active 后，用相同参数重试；禁止立刻连打`,
+            suggested_args: {
+                action: params.action,
+                ...(functionName ? { functionName } : {}),
+            },
+        },
+    ];
+}
+function buildFunctionUpdatingPayload(params) {
+    return {
+        success: false,
+        errorCode: exports.FUNCTION_UPDATING_ERROR_CODE,
+        retryAfterSeconds: exports.FUNCTION_UPDATING_RETRY_AFTER_SECONDS,
+        message: buildFunctionUpdatingMessage(params),
+        data: {
+            action: params.action,
+            ...(params.functionName ? { functionName: params.functionName } : {}),
+            ...(params.status ? { status: params.status } : {}),
+            retryAfterSeconds: exports.FUNCTION_UPDATING_RETRY_AFTER_SECONDS,
+            doNotRetryImmediately: true,
+            ...(typeof params.waitedAttempts === "number"
+                ? { waitedAttempts: params.waitedAttempts }
+                : {}),
+            ...(params.timedOut ? { waitTimedOut: true } : {}),
+            ...(params.rawMessage ? { rawError: params.rawMessage.slice(0, 500) } : {}),
+        },
+        nextActions: buildFunctionUpdatingNextActions(params),
+    };
+}
+/**
+ * Poll function Status until it leaves a busy state.
+ * Always bounded: maxAttempts AND timeoutMs; never spins without a sleep between polls.
+ */
+async function waitUntilFunctionActive(getStatus, options = {}) {
+    const intervalMs = options.intervalMs ?? exports.FUNCTION_UPDATING_WAIT.intervalMs;
+    const maxAttempts = options.maxAttempts ?? exports.FUNCTION_UPDATING_WAIT.maxAttempts;
+    const timeoutMs = options.timeoutMs ?? exports.FUNCTION_UPDATING_WAIT.timeoutMs;
+    const sleep = options.sleep ?? ((ms) => exports.functionUpdatingRuntime.sleep(ms));
+    const now = options.now ?? Date.now;
+    if (maxAttempts < 1) {
+        throw new Error("waitUntilFunctionActive maxAttempts must be >= 1");
+    }
+    if (intervalMs < 0 || timeoutMs < 0) {
+        throw new Error("waitUntilFunctionActive intervalMs/timeoutMs must be >= 0");
+    }
+    if (options.initialStatus !== undefined &&
+        !isFunctionBusyStatus(options.initialStatus)) {
+        return {
+            ready: true,
+            status: options.initialStatus,
+            attempts: 0,
+            timedOut: false,
+        };
+    }
+    const startedAt = now();
+    let attempts = 0;
+    let status = options.initialStatus;
+    while (attempts < maxAttempts) {
+        if (now() - startedAt >= timeoutMs) {
+            return { ready: false, status, attempts, timedOut: true };
+        }
+        attempts += 1;
+        status = await getStatus();
+        if (!isFunctionBusyStatus(status)) {
+            return { ready: true, status, attempts, timedOut: false };
+        }
+        if (attempts >= maxAttempts) {
+            break;
+        }
+        if (now() - startedAt + intervalMs >= timeoutMs) {
+            return { ready: false, status, attempts, timedOut: true };
+        }
+        await sleep(intervalMs);
+    }
+    return { ready: false, status, attempts, timedOut: false };
+}
+
+
 /***/ }),
 
 /***/ 23670:
@@ -91433,6 +91609,8 @@ const cloud_mode_js_1 = __webpack_require__(89684);
 const gateway_access_urls_js_1 = __webpack_require__(22435);
 const json_content_js_1 = __webpack_require__(4365);
 const logger_js_1 = __webpack_require__(13039);
+const tool_result_js_1 = __webpack_require__(9835);
+const function_updating_js_1 = __webpack_require__(23656);
 const fs_1 = __webpack_require__(29021);
 const path_1 = __importDefault(__webpack_require__(33873));
 exports.SUPPORTED_RUNTIMES = {
@@ -91753,6 +91931,10 @@ function buildFunctionOperationErrorMessage(operation, functionName, functionRoo
         suggestions.push("如果 HTTP 函数只使用原生 Node.js API 且没有第三方依赖，可以保留函数目录中的 index.js 和 scf_bootstrap，工具会跳过依赖安装。");
         suggestions.push("如果你确实依赖 npm 包，请在函数目录下补充 package.json 后重试。");
     }
+    if ((0, function_updating_js_1.isFunctionUpdatingError)(error)) {
+        suggestions.push(`函数当前处于 Updating/非 Active，不要立即重试 ${operation}。` +
+            `请等待约 10 秒，或先 queryFunctions(action="getFunctionDetail") 确认 Status 为 Active 后再重试。`);
+    }
     // Handle invalid parameter value errors from CloudBase API
     if (/invalid parameter value/i.test(baseMessage)) {
         suggestions.push("检测到参数值格式错误。请重点检查以下配置项：");
@@ -91780,6 +91962,24 @@ function wrapFunctionOperationError(operation, functionName, functionRootPath, e
     }
     return wrappedError;
 }
+async function waitForManageWriteOrGuide(action, functionName, getFunctionDetail, initialDetail) {
+    const waitResult = await (0, function_updating_js_1.waitUntilFunctionActive)(async () => {
+        const latest = await getFunctionDetail(functionName);
+        return typeof latest?.Status === "string" ? latest.Status : undefined;
+    }, {
+        initialStatus: typeof initialDetail?.Status === "string" ? initialDetail.Status : undefined,
+    });
+    if (waitResult.ready) {
+        return undefined;
+    }
+    return (0, function_updating_js_1.buildFunctionUpdatingPayload)({
+        action,
+        functionName,
+        status: waitResult.status,
+        waitedAttempts: waitResult.attempts,
+        timedOut: waitResult.timedOut,
+    });
+}
 function registerFunctionTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const deployOverrides = server.pluginOptions?.functions;
@@ -91802,6 +92002,15 @@ function registerFunctionTools(server) {
             return (0, json_content_js_1.jsonContent)(await handler());
         }
         catch (error) {
+            if ((0, tool_result_js_1.isToolPayloadError)(error)) {
+                return (0, json_content_js_1.jsonContent)(error.payload);
+            }
+            if ((0, function_updating_js_1.isFunctionUpdatingError)(error)) {
+                return (0, json_content_js_1.jsonContent)((0, function_updating_js_1.buildFunctionUpdatingPayload)({
+                    action: "manageFunctions",
+                    rawMessage: (0, function_updating_js_1.getErrorMessage)(error),
+                }));
+            }
             return (0, json_content_js_1.jsonContent)(buildErrorEnvelope(error));
         }
     };
@@ -92356,6 +92565,24 @@ function registerFunctionTools(server) {
                     throw new Error("updateFunctionCode 操作时，functionName 参数是必需的");
                 }
                 const cloudbase = await getManager();
+                if (typeof cloudbase.functions.getFunctionDetail === "function") {
+                    try {
+                        const currentDetail = await cloudbase.functions.getFunctionDetail(input.functionName);
+                        const waited = await waitForManageWriteOrGuide("updateFunctionCode", input.functionName, (name) => cloudbase.functions.getFunctionDetail(name), currentDetail);
+                        if (waited) {
+                            return waited;
+                        }
+                    }
+                    catch (error) {
+                        if ((0, function_updating_js_1.isFunctionUpdatingError)(error)) {
+                            return (0, function_updating_js_1.buildFunctionUpdatingPayload)({
+                                action: "updateFunctionCode",
+                                functionName: input.functionName,
+                                rawMessage: (0, function_updating_js_1.getErrorMessage)(error),
+                            });
+                        }
+                    }
+                }
                 // 镜像更新分支：后续迭代只需用新镜像 tag 更新函数。
                 const updateImageConfig = input.imageConfig ??
                     input.func?.imageConfig;
@@ -92374,6 +92601,13 @@ function registerFunctionTools(server) {
                         });
                     }
                     catch (error) {
+                        if ((0, function_updating_js_1.isFunctionUpdatingError)(error)) {
+                            return (0, function_updating_js_1.buildFunctionUpdatingPayload)({
+                                action: "updateFunctionCode",
+                                functionName: input.functionName,
+                                rawMessage: (0, function_updating_js_1.getErrorMessage)(error),
+                            });
+                        }
                         throw wrapFunctionOperationError("updateFunctionCode", input.functionName, undefined, error);
                     }
                     (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, imageResult);
@@ -92431,6 +92665,13 @@ function registerFunctionTools(server) {
                     result = await cloudbase.functions.updateFunctionCode(updateParams);
                 }
                 catch (error) {
+                    if ((0, function_updating_js_1.isFunctionUpdatingError)(error)) {
+                        return (0, function_updating_js_1.buildFunctionUpdatingPayload)({
+                            action: "updateFunctionCode",
+                            functionName: input.functionName,
+                            rawMessage: (0, function_updating_js_1.getErrorMessage)(error),
+                        });
+                    }
                     throw wrapFunctionOperationError("updateFunctionCode", input.functionName, processedRootPath, error);
                 }
                 (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
@@ -92475,6 +92716,10 @@ function registerFunctionTools(server) {
                 if (!functionDetail) {
                     throw new Error(`函数 ${input.functionName} 不存在或无法获取详情`);
                 }
+                const configBusy = await waitForManageWriteOrGuide("updateFunctionConfig", input.functionName, (name) => cloudbase.functions.getFunctionDetail(name), functionDetail);
+                if (configBusy) {
+                    return configBusy;
+                }
                 const currentVpc = typeof functionDetail.VpcConfig === "object" &&
                     functionDetail.VpcConfig !== null &&
                     functionDetail.VpcConfig.SubnetId &&
@@ -92484,27 +92729,39 @@ function registerFunctionTools(server) {
                         vpcId: functionDetail.VpcConfig.VpcId,
                     }
                     : undefined;
-                const result = await cloudbase.functions.updateFunctionConfig({
-                    name: input.functionName,
-                    envVariables: Object.assign({}, (functionDetail.Environment?.Variables || []).reduce((acc, curr) => {
-                        acc[curr.Key] = curr.Value;
-                        return acc;
-                    }, {}), input.envVariables ?? {}),
-                    timeout: input.timeout ?? functionDetail.Timeout,
-                    vpc: Object.assign({}, currentVpc, input.vpc ?? {}),
-                });
-                (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
-                return buildEnvelope({
-                    action: input.action,
-                    functionName: input.functionName,
-                    raw: result,
-                }, `已更新函数 ${input.functionName} 的配置`, [
-                    {
-                        tool: "queryFunctions",
-                        action: "getFunctionDetail",
-                        reason: "确认配置变更结果",
-                    },
-                ]);
+                try {
+                    const result = await cloudbase.functions.updateFunctionConfig({
+                        name: input.functionName,
+                        envVariables: Object.assign({}, (functionDetail.Environment?.Variables || []).reduce((acc, curr) => {
+                            acc[curr.Key] = curr.Value;
+                            return acc;
+                        }, {}), input.envVariables ?? {}),
+                        timeout: input.timeout ?? functionDetail.Timeout,
+                        vpc: Object.assign({}, currentVpc, input.vpc ?? {}),
+                    });
+                    (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
+                    return buildEnvelope({
+                        action: input.action,
+                        functionName: input.functionName,
+                        raw: result,
+                    }, `已更新函数 ${input.functionName} 的配置`, [
+                        {
+                            tool: "queryFunctions",
+                            action: "getFunctionDetail",
+                            reason: "确认配置变更结果",
+                        },
+                    ]);
+                }
+                catch (error) {
+                    if ((0, function_updating_js_1.isFunctionUpdatingError)(error)) {
+                        return (0, function_updating_js_1.buildFunctionUpdatingPayload)({
+                            action: "updateFunctionConfig",
+                            functionName: input.functionName,
+                            rawMessage: (0, function_updating_js_1.getErrorMessage)(error),
+                        });
+                    }
+                    throw error;
+                }
             }
             case "invokeFunction": {
                 if (!input.functionName) {
@@ -117417,8 +117674,8 @@ async function describeCloudRunEnvStatus(manager, envId) {
         : "unknown";
     return { isExist: true, status, baseInfo };
 }
-/** CloudRun EnvType for CreateCloudRunEnv (tcbr DescribeEnvBaseInfo enum). */
-exports.CLOUDRUN_ENV_TYPE = "tcbr";
+/** CloudRun EnvType for CreateCloudRunEnv (baas DescribeEnvBaseInfo enum). */
+exports.CLOUDRUN_ENV_TYPE = "baas";
 /**
  * Extract VPC binding from DescribeEnvBaseInfo.EnvBaseInfo when the env was
  * opened with an explicit VPC.
@@ -117463,7 +117720,7 @@ function resolveCloudRunDeployVpcInfo(options) {
     };
 }
 /**
- * Build CreateCloudRunEnv Param, always including EnvType=tcbr.
+ * Build CreateCloudRunEnv Param, always including EnvType=baas.
  * Optional vpcId/subnetIds are used when the platform requires an explicit VPC.
  */
 function buildCreateCloudRunEnvParam(options) {
@@ -118180,7 +118437,7 @@ function registerCloudRunTools(server) {
                     };
                 }
                 // 未开通 → 发起异步开通（CreateCloudRunEnv 异步，不阻塞等待）。
-                // Always pass EnvType=tcbr; optional vpcId/subnetIds when an explicit VPC is required.
+                // Always pass EnvType=baas; optional vpcId/subnetIds when an explicit VPC is required.
                 let createResult;
                 try {
                     createResult = await manager
@@ -143366,7 +143623,7 @@ class TelemetryReporter {
         const arch = os_1.default.arch(); // 系统架构
         // Build-time injected version; guard for vitest / non-webpack runtimes.
         const mcpVersion = process.env.npm_package_version ||
-            ( true ? "2.28.0" : 0);
+            ( true ? "2.29.0" : 0);
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -225080,7 +225337,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || ( true ? "2.28.0" : 0)}
+- MCP 版本：${process.env.npm_package_version || ( true ? "2.29.0" : 0)}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -225161,7 +225418,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.28.0" : 0;
+            const mcpVersion =  true ? "2.29.0" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -242604,7 +242861,7 @@ function registerSetupTools(server) {
     server.registerTool("downloadTemplate", {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。
-**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.28.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.29.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])