@cloudbase/cloudbase-mcp 2.17.1 → 2.18.0

package/dist/index.cjs

@@ -1902,6 +1902,7 @@ function formatDeviceAuthHint(deviceAuthInfo) {
     if (!deviceAuthInfo) {
         return "";
     }
+    const verificationUriComplete = (0, auth_js_1.buildVerificationUriComplete)(deviceAuthInfo);
     const lines = [
         "",
         "### Device Flow 授权信息",
@@ -1910,8 +1911,11 @@ function formatDeviceAuthHint(deviceAuthInfo) {
     if (deviceAuthInfo.verification_uri) {
         lines.push(`- verification_uri: ${deviceAuthInfo.verification_uri}`);
     }
+    if (verificationUriComplete) {
+        lines.push(`- verification_uri_complete: ${verificationUriComplete}`);
+    }
     lines.push(`- expires_in: ${deviceAuthInfo.expires_in}s`);
-    lines.push("", "请在另一台可用浏览器设备打开 `verification_uri` 并输入 `user_code` 完成授权。");
+    lines.push("", "请优先向用户展示完整的 `verification_uri_complete`，不要截断或改写 URL。");
     return lines.join("\n");
 }
 function emitDeviceAuthNotice(server, deviceAuthInfo) {
@@ -2337,13 +2341,7 @@ function registerEnvTools(server) {
             (0, auth_js_1.setPendingAuthProgressState)(info, "device");
             // emitDeviceAuthNotice(server, info);
         };
-        const authChallenge = () => deviceAuthInfo
-            ? {
-                user_code: deviceAuthInfo.user_code,
-                verification_uri: deviceAuthInfo.verification_uri,
-                expires_in: deviceAuthInfo.expires_in,
-            }
-            : undefined;
+        const authChallenge = () => (0, auth_js_1.buildDeviceAuthChallengePayload)(deviceAuthInfo);
         try {
             if (!supportedAuthActions.includes(action)) {
                 return (0, tool_result_js_1.buildJsonToolResult)({
@@ -2390,12 +2388,8 @@ function registerEnvTools(server) {
                             current_env_id: null,
                             ...buildEnvCandidatePayload([]),
                         }),
-                    auth_challenge: authFlowState.status === "PENDING" && authFlowState.authChallenge
-                        ? {
-                            user_code: authFlowState.authChallenge.user_code,
-                            verification_uri: authFlowState.authChallenge.verification_uri,
-                            expires_in: authFlowState.authChallenge.expires_in,
-                        }
+                    auth_challenge: authFlowState.status === "PENDING"
+                        ? (0, auth_js_1.buildDeviceAuthChallengePayload)(authFlowState.authChallenge)
                         : undefined,
                     message,
                     next_step: authStatus === "REQUIRED"
@@ -2416,11 +2410,7 @@ function registerEnvTools(server) {
                         ok: true,
                         code: "AUTH_PENDING",
                         message: "设备码授权进行中，请在浏览器中打开 verification_uri 并输入 user_code 完成授权。",
-                        auth_challenge: {
-                            user_code: authFlowState.authChallenge.user_code,
-                            verification_uri: authFlowState.authChallenge.verification_uri,
-                            expires_in: authFlowState.authChallenge.expires_in,
-                        },
+                        auth_challenge: (0, auth_js_1.buildDeviceAuthChallengePayload)(authFlowState.authChallenge),
                         next_step: (0, tool_result_js_1.buildAuthNextStep)("status", {
                             suggestedArgs: { action: "status" },
                         }),
@@ -24602,13 +24592,7 @@ async function throwPendingAuthError() {
         ok: false,
         code: "AUTH_PENDING",
         message: authState.lastError || "设备码授权进行中，请先完成登录后再重试当前工具。",
-        auth_challenge: authState.authChallenge
-            ? {
-                user_code: authState.authChallenge.user_code,
-                verification_uri: authState.authChallenge.verification_uri,
-                expires_in: authState.authChallenge.expires_in,
-            }
-            : undefined,
+        auth_challenge: (0, auth_js_1.buildDeviceAuthChallengePayload)(authState.authChallenge),
         next_step: (0, tool_result_js_1.buildAuthNextStep)("status", {
             suggestedArgs: {
                 action: "status",
@@ -89374,13 +89358,13 @@ function registerFunctionTools(server) {
                 .enum(exports.MANAGE_FUNCTION_ACTIONS)
                 .describe("写操作类型，例如 createFunction、invokeFunction、attachLayer"),
             func: CREATE_FUNCTION_SCHEMA.optional().describe("createFunction 操作的函数配置"),
-            functionRootPath: zod_1.z.string().optional().describe("函数根目录（父目录绝对路径）。" +
+            functionRootPath: zod_1.z.string().optional().describe("创建或更新函数代码时默认推荐的本地目录方式。函数根目录（父目录绝对路径）。" +
                 "本地应按 cloudfunctions/<functionName>/index.js 布局，" +
                 "此参数传 cloudfunctions 目录的绝对路径（如 /abs/path/cloudfunctions），不要传到函数名子目录。" +
-                "SDK 会自动拼接函数名子目录。"),
+                "SDK 会自动拼接函数名子目录，无需预先压缩 zip 或 base64 编码。"),
             force: zod_1.z.boolean().optional().describe("createFunction 时是否覆盖"),
             functionName: zod_1.z.string().optional().describe("函数名称。大多数 action 使用该字段作为统一目标"),
-            zipFile: zod_1.z.string().optional().describe("代码包的 base64 编码"),
+            zipFile: zod_1.z.string().optional().describe("仅兼容特殊场景：预先准备好的代码包 base64 编码。普通 createFunction/updateFunctionCode 默认不要先压缩 zip，优先使用 functionRootPath。"),
             handler: zod_1.z.string().optional().describe("函数入口"),
             timeout: zod_1.z.number().optional().describe("配置更新时的超时时间"),
             envVariables: zod_1.z.record(zod_1.z.string()).optional().describe("配置更新时要合并的环境变量"),
@@ -108450,10 +108434,10 @@ function registerDataModelTools(server) {
                 throw new Error(`不支持的操作类型: ${action}`);
         }
     });
-    // modifyDataModel - 数据模型修改工具（创建/更新）
+    // modifyDataModel - 数据模型写工具（兼容名称，当前仅支持创建）
     server.registerTool?.("modifyDataModel", {
-        title: "修改数据模型",
-        description: "基于Mermaid classDiagram创建或更新数据模型。支持创建新模型和更新现有模型结构。内置异步任务监控，自动轮询直至完成或超时。",
+        title: "修改数据模型（当前仅支持创建）",
+        description: "基于Mermaid classDiagram创建数据模型。为保持兼容性，工具名仍为 modifyDataModel；当前仅支持创建新模型，不支持更新现有模型结构。内置异步任务监控，自动轮询直至完成或超时。",
         inputSchema: {
             mermaidDiagram: zod_1.z.string()
                 .describe(`Mermaid classDiagram代码，描述数据模型结构。
@@ -108613,10 +108597,10 @@ classDiagram
                         status: status,
                         action: action,
                         message: status === "success"
-                            ? `数据模型${action === "create" ? "创建" : "更新"}成功，共处理${models.length}个模型`
+                            ? `数据模型创建成功，共处理${models.length}个模型`
                             : status === "init"
                                 ? `任务超时，任务ID: ${taskId}，请稍后手动查询状态`
-                                : `数据模型${action === "create" ? "创建" : "更新"}失败`,
+                                : `数据模型创建失败`,
                         taskResult: statusResult?.Data,
                     }, null, 2),
                 },
@@ -111843,14 +111827,15 @@ exports.CLOUDRUN_SERVICE_TYPES = ['function', 'container'];
 exports.CLOUDRUN_ACCESS_TYPES = ['OA', 'PUBLIC', 'MINIAPP', 'VPC'];
 // Input schema for queryCloudRun tool
 const queryCloudRunInputSchema = {
-    action: zod_1.z.enum(['list', 'detail', 'templates']).describe('查询操作类型：list=获取云托管服务列表（支持分页和筛选），detail=查询指定服务的详细信息（包括配置、版本、访问地址等），templates=获取可用的项目模板列表（用于初始化新项目）'),
+    action: zod_1.z.enum(['list', 'detail', 'templates', 'getDeployLog']).describe('查询操作类型：list=获取云托管服务列表（支持分页和筛选），detail=查询指定服务的详细信息（包含服务配置和最新部署状态），templates=获取可用的项目模板列表（用于初始化新项目），getDeployLog=获取指定服务最近一次或指定构建的部署日志'),
     // List operation parameters
     pageSize: zod_1.z.number().min(1).max(100).optional().default(10).describe('分页大小，控制每页返回的服务数量。取值范围：1-100，默认值：10。建议根据网络性能和显示需求调整'),
     pageNum: zod_1.z.number().min(1).optional().default(1).describe('页码，用于分页查询。从1开始，默认值：1。配合pageSize使用可实现分页浏览'),
     serverName: zod_1.z.string().optional().describe('服务名称筛选条件，支持模糊匹配。例如：输入"test"可匹配"test-service"、"my-test-app"等服务名称。留空则查询所有服务'),
     serverType: zod_1.z.enum(exports.CLOUDRUN_SERVICE_TYPES).optional().describe('服务类型筛选条件：function=函数型云托管（仅支持Node.js，有特殊的开发要求和限制，适合简单的API服务），container=容器型服务（推荐使用，支持任意语言和框架如Java/Go/Python/PHP/.NET等，适合大多数应用场景）'),
-    // Detail operation parameters
-    detailServerName: zod_1.z.string().optional().describe('要查询详细信息的服务名称。当action为detail时必需提供，必须是已存在的服务名称。可通过list操作获取可用的服务名称列表'),
+    // Detail and log operation parameters
+    detailServerName: zod_1.z.string().optional().describe('要查询详细信息或部署日志的服务名称。当action为detail或getDeployLog时建议提供，必须是已存在的服务名称。可通过list操作获取可用的服务名称列表'),
+    buildId: zod_1.z.number().optional().describe('构建ID，仅在action=getDeployLog时使用。不传时默认返回最近一次部署的构建日志'),
 };
 // Input schema for manageCloudRun tool
 const ManageCloudRunInputSchema = {
@@ -111958,6 +111943,28 @@ function buildManageCloudRunErrorMessage(action, serverName, error) {
     }
     return `[manageCloudRun/${action}] ${baseMessage}\n建议：${suggestions.join(" ")}`;
 }
+function getCloudRunQueryServerName(input) {
+    return input.detailServerName || input.serverName;
+}
+function normalizeProcessLogText(logs) {
+    return logs
+        .map((log) => {
+        if (typeof log === "string") {
+            return log;
+        }
+        if (log && typeof log === "object") {
+            if ("Log" in log && typeof log.Log === "string") {
+                return log.Log;
+            }
+            if ("Text" in log && typeof log.Text === "string") {
+                return log.Text;
+            }
+            return JSON.stringify(log);
+        }
+        return String(log);
+    })
+        .join("\n");
+}
 /**
  * Format CloudRun service info for display
  */
@@ -111972,7 +111979,7 @@ function registerCloudRunTools(server) {
     // Tool 1: Get CloudRun service information (read operations)
     server.registerTool("queryCloudRun", {
         title: "查询 CloudRun 服务信息",
-        description: "查询云托管服务信息，支持获取服务列表、查询服务详情和获取可用模板列表。返回的服务信息包括服务名称、状态、访问类型、配置详情等。",
+        description: "查询云托管服务信息，支持获取服务列表、查询服务详情、获取可用模板列表和部署日志。返回的服务信息包括服务名称、状态、访问类型、配置详情以及最近部署上下文。",
         inputSchema: queryCloudRunInputSchema,
         annotations: {
             readOnlyHint: true,
@@ -112021,7 +112028,21 @@ function registerCloudRunTools(server) {
                 };
             }
             case 'detail': {
-                const serverName = input.detailServerName || input.serverName;
+                const serverName = getCloudRunQueryServerName(input);
+                if (!serverName) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: "detailServerName or serverName is required for detail action",
+                                    message: "Please provide detailServerName or serverName."
+                                }, null, 2)
+                            }
+                        ]
+                    };
+                }
                 const result = await cloudrunService.detail({ serverName });
                 if (!result) {
                     return {
@@ -112037,6 +112058,30 @@ function registerCloudRunTools(server) {
                         ]
                     };
                 }
+                let latestDeploy = null;
+                let deployRecordsWarning;
+                let message;
+                try {
+                    const deployRecords = await cloudrunService.getDeployRecords({ serverName });
+                    latestDeploy = deployRecords?.DeployRecords?.[0] ?? null;
+                    if (!latestDeploy) {
+                        message = `Retrieved details for service '${serverName}'. No deploy records found yet.`;
+                    }
+                    else if (typeof latestDeploy.Status === 'string' && latestDeploy.Status.includes('failed')) {
+                        message = `Service '${serverName}' latest deploy failed. Please use queryCloudRun(action="getDeployLog") for details.`;
+                    }
+                    else if (typeof latestDeploy.Status === 'string' && latestDeploy.Status.includes('creating')) {
+                        message = `Service '${serverName}' latest deploy is still running. Please check again later or query the deploy log for progress.`;
+                    }
+                    else {
+                        message = `Retrieved details for service '${serverName}'. Latest service status: ${result.BaseInfo?.Status || 'unknown'}, latest deploy status: ${latestDeploy.Status || 'unknown'}.`;
+                    }
+                }
+                catch (error) {
+                    const baseMessage = error instanceof Error ? error.message : String(error);
+                    deployRecordsWarning = `Failed to fetch deploy records: ${baseMessage}`;
+                    message = `Retrieved details for service '${serverName}', but deploy records are currently unavailable.`;
+                }
                 return {
                     content: [
                         {
@@ -112044,9 +112089,11 @@ function registerCloudRunTools(server) {
                             text: JSON.stringify({
                                 success: true,
                                 data: {
-                                    service: result
+                                    service: result,
+                                    latestDeploy,
+                                    ...(deployRecordsWarning ? { deployRecordsWarning } : {})
                                 },
-                                message: `Retrieved details for service '${serverName}'`
+                                message
                             }, null, 2)
                         }
                     ]
@@ -112069,6 +112116,79 @@ function registerCloudRunTools(server) {
                     ]
                 };
             }
+            case 'getDeployLog': {
+                const serverName = getCloudRunQueryServerName(input);
+                if (!serverName) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: "detailServerName or serverName is required for getDeployLog action",
+                                    message: "Please provide detailServerName or serverName."
+                                }, null, 2)
+                            }
+                        ]
+                    };
+                }
+                const deployRecords = await cloudrunService.getDeployRecords({ serverName });
+                const latestDeploy = deployRecords?.DeployRecords?.[0];
+                if (!latestDeploy) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: `Service '${serverName}' has no deploy records.`,
+                                    message: "Please deploy the service first, then query the deploy log again."
+                                }, null, 2)
+                            }
+                        ]
+                    };
+                }
+                const buildId = input.buildId ?? latestDeploy.BuildId;
+                const buildLogResult = await cloudrunService.getBuildLog({
+                    serverName,
+                    buildId,
+                });
+                let processLogs = [];
+                let processLogsWarning;
+                if (latestDeploy.RunId && typeof cloudrunService.getProcessLog === 'function') {
+                    try {
+                        const processLogResult = await cloudrunService.getProcessLog({
+                            RunId: latestDeploy.RunId,
+                        });
+                        processLogs = processLogResult?.Logs || [];
+                    }
+                    catch (error) {
+                        processLogsWarning = error instanceof Error ? error.message : String(error);
+                    }
+                }
+                const buildLogText = typeof buildLogResult?.Log?.Text === 'string' ? buildLogResult.Log.Text : '';
+                const processLogText = Array.isArray(processLogs) && processLogs.length > 0 ? normalizeProcessLogText(processLogs) : '';
+                const combinedLogText = [buildLogText, processLogText].filter(Boolean).join('\n');
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                data: {
+                                    buildId,
+                                    deployRecord: latestDeploy,
+                                    buildLog: buildLogResult?.Log || null,
+                                    processLogs,
+                                    combinedLogText,
+                                    ...(processLogsWarning ? { processLogsWarning } : {})
+                                },
+                                message: `Retrieved deploy log for service '${serverName}'`
+                            }, null, 2)
+                        }
+                    ]
+                };
+            }
             default:
                 throw new Error(`Unsupported action: ${input.action}`);
         }
@@ -112336,6 +112456,7 @@ for await (let x of res.textStream) {
                         name: input.serverName
                     }
                 };
+                const consoleUrl = `https://tcb.cloud.tencent.com/dev?envId=${currentEnvId}#/platform-run/service/detail?serverName=${input.serverName}&tabId=overview&envId=${currentEnvId}`;
                 try {
                     fs_1.default.writeFileSync(cloudbasercPath, JSON.stringify(cloudbasercContent, null, 2));
                 }
@@ -112379,8 +112500,6 @@ for await (let x of res.textStream) {
                     }
                     // Extract project name from targetPath
                     const projectName = path_1.default.basename(targetPath);
-                    // Build console URL
-                    const consoleUrl = `https://tcb.cloud.tencent.com/dev?envId=${currentEnvId}#/platform-run/service/detail?serverName=${input.serverName}&tabId=overview&envId=${currentEnvId}`;
                     // Send notification
                     await (0, notification_js_1.sendDeployNotification)(server, {
                         deployType: 'cloudrun',
@@ -112402,12 +112521,13 @@ for await (let x of res.textStream) {
                                 success: true,
                                 data: {
                                     serviceName: input.serverName,
-                                    status: 'deployed',
+                                    status: 'deploying',
                                     deployPath: targetPath,
                                     serverType: serverType,
-                                    cloudbasercGenerated: true
+                                    cloudbasercGenerated: true,
+                                    consoleUrl
                                 },
-                                message: `Successfully deployed ${serverType} service '${input.serverName}' from ${targetPath}`
+                                message: `Triggered deployment for ${serverType} service '${input.serverName}' from ${targetPath}. You can follow the progress in ${consoleUrl}`
                             }, null, 2)
                         }
                     ]
@@ -133564,7 +133684,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.17.1" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.18.0" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -191431,7 +191551,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.17.1" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.18.0" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -205973,7 +206093,7 @@ function registerSetupTools(server) {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。⚠️ **MANDATORY FOR NEW PROJECTS** ⚠️
 
-**CRITICAL**: This tool MUST be called FIRST when starting a new project.\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.17.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**CRITICAL**: This tool MUST be called FIRST when starting a new project.\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.18.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -207265,6 +207385,8 @@ module.exports.sync = path => {
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.buildVerificationUriComplete = buildVerificationUriComplete;
+exports.buildDeviceAuthChallengePayload = buildDeviceAuthChallengePayload;
 exports.getAuthProgressStateSync = getAuthProgressStateSync;
 exports.getAuthProgressState = getAuthProgressState;
 exports.resolveAuthOptions = resolveAuthOptions;
@@ -207293,6 +207415,54 @@ function normalizeOptionalString(value) {
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : undefined;
 }
+function buildVerificationUriComplete(deviceAuthInfo) {
+    const explicitComplete = normalizeOptionalString(deviceAuthInfo?.verification_uri_complete);
+    if (explicitComplete) {
+        return explicitComplete;
+    }
+    const verificationUri = normalizeOptionalString(deviceAuthInfo?.verification_uri);
+    const userCode = normalizeOptionalString(deviceAuthInfo?.user_code);
+    if (!verificationUri || !userCode) {
+        return undefined;
+    }
+    try {
+        const url = new URL(verificationUri);
+        const hash = url.hash.startsWith("#") ? url.hash.slice(1) : url.hash;
+        if (hash) {
+            const [hashPath, hashQuery = ""] = hash.split("?");
+            const hashParams = new URLSearchParams(hashQuery);
+            if (!hashParams.has("user_code")) {
+                hashParams.set("user_code", userCode);
+            }
+            url.hash = hashParams.toString()
+                ? `#${hashPath}?${hashParams.toString()}`
+                : `#${hashPath}`;
+            return url.toString();
+        }
+        if (!url.searchParams.has("user_code")) {
+            url.searchParams.set("user_code", userCode);
+        }
+        return url.toString();
+    }
+    catch {
+        if (verificationUri.includes("user_code=")) {
+            return verificationUri;
+        }
+        const separator = verificationUri.includes("?") ? "&" : "?";
+        return `${verificationUri}${separator}user_code=${encodeURIComponent(userCode)}`;
+    }
+}
+function buildDeviceAuthChallengePayload(deviceAuthInfo) {
+    if (!deviceAuthInfo) {
+        return undefined;
+    }
+    return {
+        user_code: deviceAuthInfo.user_code,
+        verification_uri: deviceAuthInfo.verification_uri,
+        verification_uri_complete: buildVerificationUriComplete(deviceAuthInfo),
+        expires_in: deviceAuthInfo.expires_in,
+    };
+}
 function normalizeAuthMode(value) {
     return value === "web" || value === "device" ? value : undefined;
 }

package/dist/index.d.ts

@@ -104,6 +104,7 @@ export declare interface DeleteFileParams {
 export declare interface DeviceFlowAuthInfo {
     user_code: string;
     verification_uri?: string;
+    verification_uri_complete?: string;
     device_code: string;
     expires_in: number;
 }