@cloudbase/cloudbase-mcp 2.36.1 → 2.36.2

package/dist/index.d.ts

@@ -220,6 +220,18 @@ export declare interface EnsureLoginOptions extends AuthOptions {
     onDeviceCode?: (info: DeviceFlowAuthInfo) => void;
 }
 
+/**
+ * Where this resolution got its env id.
+ * The first four values are already in shipped queries. Do not rename them.
+ * `default` stays `default` (an empty result, not a rename to `unresolved`).
+ */
+export declare const ENV_SOURCES: readonly ["cloudBaseOptions", "process.env.CLOUDBASE_ENV_ID", "envManager.cachedEnvId", "project", "login_state", "auto_bound", "default"];
+
+export declare type EnvBinding = {
+    envId: string | null;
+    source: EnvSource;
+};
+
 declare class EnvironmentManager {
     private cachedEnvId;
     private envIdPromise;
@@ -233,6 +245,12 @@ declare class EnvironmentManager {
 
 export declare const envManager: EnvironmentManager;
 
+export declare type EnvSlot = {
+    binding: EnvBinding | null;
+};
+
+export declare type EnvSource = (typeof ENV_SOURCES)[number];
+
 export declare const error: (message: string, data?: object | Error) => void;
 
 export declare interface ExtendedMcpServer extends McpServer {
@@ -261,6 +279,8 @@ export declare interface ExtendedMcpServer extends McpServer {
         inputSchema: any;
         handler: (input: any) => Promise<any>;
     }>;
+    /** Process (stdio) or unused when the caller already opened a request slot. */
+    envSlot: EnvSlot;
     setLogger(logger: Logger): void;
     /**
      * Same as MCP SDK registerTool, but annotations may include CloudBase `category`.
@@ -558,6 +578,13 @@ export declare const reportToolCall: (params: {
     client?: string;
     mcpClientInfo?: McpClientInfo;
     mcpClientCapabilities?: McpClientCapabilities;
+    /**
+     * `auth` 的「环境准备」结果（只有 auth 会给，其余工具恒为 undefined）。
+     * 为什么必须上报：无环境的用户到底卡在购买页、实名、还是 CAM 授权，
+     * payload 里分得很清楚，但没进埋点之前，三种情况在数据里长得一模一样。
+     */
+    envSetupStatus?: string;
+    envSetupFailReason?: string;
 }) => Promise<void>;
 
 export declare const reportToolkitLifecycle: (params: {
@@ -573,6 +600,8 @@ export declare const reportToolkitLifecycle: (params: {
 
 export declare function resetCloudBaseManagerCache(): void;
 
+export declare function runWithEnvSlot<T>(slot: EnvSlot, fn: () => T): T;
+
 /**
  * Check if a tool should be registered in cloud mode
  * @param toolName - The name of the tool
@@ -690,7 +719,13 @@ declare class TelemetryReporter {
     };
     /**
      * 获取设备唯一标识
-     * 基于主机名、CPU信息和MAC地址生成匿名设备指纹
+     *
+     * 锚点与降级顺序见 `utils/device-id.ts`：优先系统级不可变标识（IOPlatformUUID /
+     * MachineGuid / machine-id），取不到才退到 hostname + CPU + 过滤后的物理网卡 MAC。
+     * 容器里 hostname 每次重建都变、macOS 私有 Wi-Fi 地址让 MAC 随 SSID 漂移，
+     * 两者都不能当锚点 —— 旧实现把它们全拼进去，同一台 Mac 一天能上报成几十个设备。
+     *
+     * 子进程（ioreg / reg）只在这里跑一次（构造时），1s 超时即降级。
      */
     private getDeviceId;
     /**