@cloudbase/cloudbase-mcp 2.35.1 → 2.36.0

package/dist/index.d.ts

@@ -132,6 +132,15 @@ export declare function createCloudBaseMcpServer(options?: {
         name: string;
         version?: string;
     };
+    /**
+     * 会话标识的取值入口（**调用点注入**，可选）。
+     *
+     * 有状态 HTTP / 托管路径把当前 transport 的 `sessionId` 传进来（那是公开 getter）；
+     * stdio、以及无状态托管（`sessionIdGenerator: undefined`）没有会话概念 ⇒ **不注入**，
+     * 会话级上报回落到常量，等价于"这个实例就是一个会话"。
+     * 只有会话级遥测用得到它；不注入时行为与"每实例一条"完全一致。
+     */
+    getSessionId?: () => string | undefined;
     logger?: Logger;
     pluginsEnabled?: string[];
     pluginsDisabled?: string[];
@@ -315,11 +324,6 @@ export declare interface GetFileInfoParams {
     cloudPath: string;
 }
 
-/**
- * Get interactive server instance (CommonJS compatible)
- */
-export declare function getInteractiveServerAsync(): Promise<InteractiveServer>;
-
 export declare function getLoginState(options?: EnsureLoginOptions): Promise<LoginState | null>;
 
 declare interface GetManagerOptions {
@@ -389,57 +393,6 @@ declare interface IdeFileDescriptor {
 
 export declare const info: (message: string, data?: object | Error) => void;
 
-export declare interface InteractiveResult {
-    type: "envId" | "clarification" | "confirmation";
-    data: any;
-    cancelled?: boolean;
-    switch?: boolean;
-    timeout?: boolean;
-    timeoutDuration?: number;
-}
-
-declare class InteractiveServer {
-    private app;
-    private server;
-    private wss;
-    private port;
-    private isRunning;
-    private currentResolver;
-    private sessionData;
-    private _mcpServer;
-    get mcpServer(): any;
-    set mcpServer(server: any);
-    private readonly DEFAULT_PORT;
-    private readonly FALLBACK_PORTS;
-    /** Idle timeout for HTTP/WS connections (e.g. long login). Avoids "connection disconnected" after ~1 min. */
-    private static readonly SERVER_IDLE_MS;
-    /** WebSocket ping interval to keep connection alive past proxies/firewalls. */
-    private static readonly WS_PING_INTERVAL_MS;
-    constructor(mcpServer?: any);
-    private cleanup;
-    /** Apply timeouts so long-lived login does not cause "connection disconnected". */
-    private applyServerTimeouts;
-    private setupExpress;
-    private setupWebSocket;
-    start(): Promise<number>;
-    stop(): Promise<void>;
-    collectEnvId(availableEnvs: any[], accountInfo?: {
-        uin?: string;
-        region?: string;
-        site?: string;
-    }, errorContext?: any, // EnvSetupContext
-    manager?: any, // CloudBase manager instance for refreshing env list
-    mcpServer?: any): Promise<InteractiveResult>;
-    clarifyRequest(message: string, options?: string[]): Promise<InteractiveResult>;
-    private escapeHtml;
-    private getEnvSetupHTML;
-    private getEnvSetupHTML_OLD;
-    private getClarificationHTML;
-    private getConfirmationHTML;
-    get running(): boolean;
-    get currentPort(): number;
-}
-
 /**
  * Check if MCP is running in cloud mode
  * Cloud mode is enabled by:
@@ -494,6 +447,24 @@ export declare function logout(_options?: {
     site?: string;
 }): Promise<void>;
 
+/**
+ * 归一化后的客户端能力（字段名保持语义，报表侧再映射到列）。
+ * `undefined` = 握手未完成，与「握手完成但什么都没声明」必须分开：
+ * 后者是客户端事实，前者只是我们还没拿到。
+ */
+declare type McpClientCapabilities = {
+    /** 表单模式 elicitation（客户端声明 `elicitation:{}` 或 `elicitation.form`） */
+    elicitationForm: boolean;
+    /** URL 模式 elicitation（凭据跳转用；本期不做，只记录） */
+    elicitationUrl: boolean;
+    /** 声明了 MCP Apps 扩展 */
+    ui: boolean;
+    roots: boolean;
+    sampling: boolean;
+    /** 报表友好摘要：`none` 或稳定排序的逗号串（elicitation:form / elicitation:url / ui / roots / sampling） */
+    summary: string;
+};
+
 /** MCP initialize clientInfo fields available after handshake via Server.getClientVersion(). */
 declare type McpClientInfo = {
     name?: string;
@@ -569,10 +540,13 @@ export declare const reportToolCall: (params: {
     duration?: number;
     error?: string;
     inputParams?: any;
+    /** 工具级 action（如 auth 的 status/set_env），用于区分"同一个工具做了什么" */
+    action?: string;
     cloudBaseOptions?: CloudBaseOptions;
     ide?: string;
     client?: string;
     mcpClientInfo?: McpClientInfo;
+    mcpClientCapabilities?: McpClientCapabilities;
 }) => Promise<void>;
 
 export declare const reportToolkitLifecycle: (params: {