@cloudbase/cloudbase-mcp 2.34.4 → 2.34.6

package/dist/index.d.ts

@@ -48,6 +48,15 @@ export declare type CloudBaseOptions = CloudBaseConfigBase & {
      * 注意：不要用 token 字段的有无来推断权限范围——sessionToken 本身不携带范围语义。
      */
     credentialScope?: 'env' | 'account';
+    /**
+     * 环境归属账号（主账号）uin（可选，由宿主显式注入）。
+     * 用于遥测的账号级归因：hosted 宿主从 OAuth 授权信息取 ownerUin 传入
+     * （调用方可能是协作者/子账号，其 uin 不等于环境归属账号），
+     * 免去 MCP 侧为此单独发一次云 API 调用；与 DescribeEnvInfo 返回的
+     * EnvInfo.UserInfo.Uin 口径一致。
+     * 注意：不要从 secretId / token / envId 反推 uin——它们之间没有可靠映射。
+     */
+    uin?: string;
 };
 
 /**
@@ -388,6 +397,12 @@ declare interface LoginState {
     secretKey: string;
     token?: string;
     envId?: string;
+    /**
+     * 主账号 uin。本地凭证（`~/.config/.cloudbase/auth.json`）自带，
+     * 由 `@cloudbase/toolbox` 的 `resolveCredential()` 透传。
+     * 注意：临时密钥续期响应里没有 uin，须由调用方保留旧值（见 resolveSiteLoginState）。
+     */
+    uin?: string | number;
 }
 
 export declare function logout(options?: {
@@ -579,8 +594,9 @@ export declare const SUPPORTED_RUNTIMES: {
  *
  * 隐私保护：
  * - 可通过环境变量 CLOUDBASE_MCP_TELEMETRY_DISABLED=true 完全关闭
- * - 不收集敏感信息（代码内容、具体文件路径等）
- * - 使用设备指纹而非真实用户信息
+ * - 不收集敏感信息（代码内容、具体文件路径、密钥等）
+ * - 设备标识使用匿名设备指纹
+ * - 账号归因使用 `login_uin`（主账号 uin，字段名与 CloudBase CLI 对齐），取不到时上报 unknown
  * - 所有数据仅用于产品改进，不用于其他用途
  */
 declare class TelemetryReporter {