@tencent-ai/cloud-agent-sdk 0.2.12 → 0.2.13-next.2bf8b02.20260209

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AgentCapabilities as AgentCapabilities$1, ClientCapabilities, InitializeResponse, LoadSessionResponse, NewSessionResponse, PromptResponse as PromptResponse$1, RequestPermissionRequest, RequestPermissionRequest as RequestPermissionRequest$1, SessionNotification, SessionNotification as SessionNotification$1, SetSessionModeResponse, SetSessionModelResponse } from "@agentclientprotocol/sdk";
+import { AgentCapabilities as AgentCapabilities$1, ClientCapabilities, InitializeResponse, LoadSessionResponse, NewSessionResponse, PromptResponse as PromptResponse$1, RequestPermissionRequest, RequestPermissionRequest as RequestPermissionRequest$1, SessionNotification, SessionNotification as SessionNotification$1, SetSessionModeResponse, SetSessionModelResponse, StopReason } from "@agentclientprotocol/sdk";
 import { EntryInfo, EntryInfo as EntryInfo$1, Filesystem, FilesystemEvent, FilesystemEvent as FilesystemEvent$1, Sandbox, WatchHandle, WriteInfo } from "e2b";
 import "zod";
 
@@ -339,12 +339,240 @@ interface ClientEvents extends Record<string, unknown> {
  */
 type QuestionAnswers = Record<string, string | string[]>;
 //#endregion
-//#region ../agent-provider/lib/backend/types.d.ts
+//#region ../agent-provider/lib/backend/service/oauth-repository-types.d.ts
 /**
- * Backend Provider 类型定义
+ * OAuth Repository Types
  *
- * 定义 IBackendProvider 接口和配置
+ * 定义 OAuth 连接器相关的仓库和分支操作类型
+ */
+/**
+ * Connector name type for OAuth providers
+ */
+type OauthConnectorName$1 = 'github' | 'gongfeng' | 'cnb';
+/**
+ * Branch information from OAuth connector
+ * GET /console/as/connector/oauth/{name}/branches
+ */
+interface OauthBranch$1 {
+  /** Branch name */
+  name: string;
+  /** Whether the branch is protected */
+  protected: boolean;
+  /** Latest commit SHA */
+  commit_sha: string;
+  /** Latest commit URL */
+  commit_url: string;
+}
+/**
+ * GitHub 分支查询参数
+ */
+interface GitHubBranchParams$1 {
+  /** Repository owner (e.g., "CodeBuddy-Official-Account") */
+  owner: string;
+  /** Repository name (e.g., "CodeBuddyIDE") */
+  repo: string;
+}
+/**
+ * Gongfeng 分支查询参数
+ */
+interface GongfengBranchParams$1 {
+  /** Project ID (e.g., "1611499") */
+  project_id: string;
+}
+/**
+ * CNB 分支查询参数
+ */
+interface CNBBranchParams$1 {
+  /** Repository path: org/repo (e.g., "genie/genie-ide") */
+  repo: string;
+}
+/**
+ * GitHub repository owner information
+ */
+interface OauthGitHubRepoOwner {
+  /** Owner login name */
+  login: string;
+  /** Owner avatar URL */
+  avatar_url: string;
+  /** Owner API URL */
+  url: string;
+  /** Owner HTML URL */
+  html_url: string;
+  /** Owner followers URL */
+  followers_url: string;
+  /** Owner starred URL */
+  starred_url: string;
+  /** Owner repos URL */
+  repos_url: string;
+  /** Owner events URL */
+  events_url: string;
+}
+/**
+ * GitHub repository information
+ * From ListReposResponse.GitHubRepos
+ */
+interface OauthGitHubRepo$1 {
+  /** Repository name */
+  name: string;
+  /** Full repository name (owner/repo) */
+  full_name: string;
+  /** Whether the repository is private */
+  private: boolean;
+  /** Repository HTML URL */
+  html_url: string;
+  /** Repository API URL */
+  url: string;
+  /** Repository teams URL */
+  teams_url: string;
+  /** Repository hooks URL */
+  hooks_url: string;
+  /** Repository events URL */
+  events_url: string;
+  /** Repository branches URL */
+  branches_url: string;
+  /** Repository git commits URL */
+  git_commits_url: string;
+  /** Repository merges URL */
+  merges_url: string;
+  /** Repository pulls URL */
+  pulls_url: string;
+  /** Repository git URL */
+  git_url: string;
+  /** Repository clone URL */
+  clone_url: string;
+  /** Repository SVN URL */
+  svn_url: string;
+  /** Repository downloads URL */
+  downloads_url: string;
+  /** Repository description */
+  description: string;
+  /** Repository owner */
+  owner: OauthGitHubRepoOwner;
+  /** Number of forks */
+  forks_count: number;
+}
+/**
+ * Gongfeng repository namespace information
+ */
+interface OauthGongFengRepoNamespace {
+  /** Namespace name */
+  name: string;
+  /** Namespace description */
+  description: string;
+  /** Namespace path */
+  path: string;
+}
+/**
+ * Gongfeng repository owner information
+ */
+interface OauthGongFengRepoOwner {
+  /** Owner username */
+  username: string;
+  /** Owner web URL */
+  web_url: string;
+  /** Owner name */
+  name: string;
+  /** Owner state */
+  state: string;
+  /** Owner avatar URL */
+  avatar_url: string;
+}
+/**
+ * Gongfeng (工蜂) repository information
+ * From ListReposResponse.GongFengRepos
+ */
+interface OauthGongFengRepo$1 {
+  /** Repository ID */
+  id: number;
+  /** Repository description */
+  description: string;
+  /** Whether the repository is public */
+  public: boolean;
+  /** Whether the repository is archived */
+  archived: boolean;
+  /** Visibility level */
+  visibility_level: string;
+  /** Public visibility */
+  public_visibility: number;
+  /** Repository namespace */
+  namespace: OauthGongFengRepoNamespace;
+  /** Repository owner */
+  owner: OauthGongFengRepoOwner;
+  /** Repository name */
+  name: string;
+  /** Name with namespace */
+  name_with_namespace: string;
+  /** Repository path */
+  path: string;
+  /** Path with namespace */
+  path_with_namespace: string;
+  /** Repository type (Git/SVN) */
+  type: string;
+  /** Default branch */
+  default_branch: string;
+  /** SSH URL to repository */
+  ssh_url_to_repo: string;
+  /** HTTP URL to repository */
+  http_url_to_repo: string;
+  /** HTTPS URL to repository */
+  https_url_to_repo: string;
+  /** Web URL */
+  web_url: string;
+  /** Avatar URL */
+  avatar_url: string;
+  /** Forked from project */
+  forked_from_project: string;
+}
+/**
+ * CNB repository information
+ * From ListReposResponse.CNBRepos
+ */
+interface OauthCNBRepo$1 {
+  /** Created timestamp */
+  created_at: string;
+  /** Repository description */
+  description: string;
+  /** Repository name */
+  name: string;
+  /** Repository path */
+  path: string;
+  /** Repository site */
+  site: string;
+  /** Repository status */
+  status: number;
+  /** Repository topics */
+  topics: string;
+  /** Visibility level */
+  visibility_level: string;
+  /** Web URL */
+  web_url: string;
+}
+/**
+ * Response for listing repositories
+ * GET /console/as/connector/oauth/{name}/repos
  */
+interface ListReposResponse$1 {
+  /**
+   * GitHub repositories grouped by installation id
+   * Map: installation_id => repository list
+   */
+  github_repos?: Record<number, OauthGitHubRepo$1[]>;
+  /** Gongfeng repositories */
+  gongfeng_repos?: OauthGongFengRepo$1[];
+  /** CNB repositories */
+  cnb_repos?: OauthCNBRepo$1[];
+}
+//#endregion
+//#region ../agent-provider/lib/backend/types.d.ts
+type OauthConnectorName = OauthConnectorName$1;
+type OauthBranch = OauthBranch$1;
+type GitHubBranchParams = GitHubBranchParams$1;
+type GongfengBranchParams = GongfengBranchParams$1;
+type CNBBranchParams = CNBBranchParams$1;
+type OauthGitHubRepo = OauthGitHubRepo$1;
+type OauthGongFengRepo = OauthGongFengRepo$1;
+type OauthCNBRepo = OauthCNBRepo$1;
+type ListReposResponse = ListReposResponse$1;
 /**
  * 账号版本类型
  */
@@ -433,6 +661,13 @@ interface AccountPlan {
   /** 所有套餐资源列表 */
   resources?: PlanResource[];
 }
+/**
+ * 账号类型
+ * - sso: SSO 登录账号
+ * - unified: 统一登录账号
+ * - 空字符串: 普通账号
+ */
+type AccountType = 'sso' | 'unified' | '';
 /**
  * 账号信息
  */
@@ -459,6 +694,8 @@ interface Account {
   pluginEnabled?: boolean;
   /** 部署状态 */
   deployStatus?: DeployStatus;
+  /** 账号类型 */
+  accountType?: AccountType;
   /** 是否是 Pro 版本 */
   isPro?: boolean;
   /** 到期时间戳 */
@@ -517,6 +754,7 @@ interface UserConnector {
   oauthClientId: string;
   /** OAuth 重定向 URL */
   oauthRedirectUrl: string;
+  oauthAppName: string;
 }
 /**
  * 获取用户连接器列表响应
@@ -590,6 +828,7 @@ interface TaskConnector {
   connect_at: string;
   /** 连接状态，0未连接，1已连接 */
   connectStatus: 0 | 1;
+  oauthAppName: string;
 }
 /**
  * 添加任务请求
@@ -679,84 +918,6 @@ interface RevokeAllRequest {
   /** 安装ID列表（可选，如果不传则撤销所有） */
   installationIds?: string[];
 }
-/**
- * GitHub 仓库所有者信息
- */
-interface OauthGitHubRepoOwner {
-  login: string;
-  avatar_url: string;
-  url: string;
-  html_url: string;
-  followers_url: string;
-  starred_url: string;
-  repos_url: string;
-  events_url: string;
-}
-/**
- * GitHub 仓库信息
- */
-interface OauthGitHubRepo {
-  name: string;
-  full_name: string;
-  private: boolean;
-  html_url: string;
-  url: string;
-  teams_url: string;
-  hooks_url: string;
-  events_url: string;
-  branches_url: string;
-  git_commits_url: string;
-  merges_url: string;
-  pulls_url: string;
-  git_url: string;
-  clone_url: string;
-  svn_url: string;
-  downloads_url: string;
-  description: string;
-  owner: OauthGitHubRepoOwner;
-  forks_count: number;
-}
-/**
- * 工蜂仓库信息
- */
-interface OauthGongfengRepo {
-  id: number;
-  description: string;
-  public: boolean;
-  archived: boolean;
-  visibility_level: number;
-  public_visibility: number;
-  namespace: {
-    name: string;
-    description: string;
-    path: string;
-  };
-  owner: {
-    username: string;
-    web_url: string;
-    name: string;
-    state: string;
-    avatar_url: string;
-  };
-  name: string;
-  name_with_namespace: string;
-  path: string;
-  path_with_namespace: string;
-  type: string;
-  default_branch: string;
-  ssh_url_to_repo: string;
-  http_url_to_repo: string;
-  https_url_to_repo: string;
-  web_url: string;
-  avatar_url: string;
-}
-/**
- * CNB仓库信息
- */
-interface OauthCnbRepo {
-  name: string;
-  [key: string]: any;
-}
 /**
  * 获取仓库列表响应
  */
@@ -764,8 +925,8 @@ interface GetRepoListResponse {
   github_repos?: {
     [key: string | number]: OauthGitHubRepo[];
   };
-  gongfeng_repos?: OauthGongfengRepo[];
-  cnb_repos?: OauthCnbRepo[];
+  gongfeng_repos?: OauthGongFengRepo[];
+  cnb_repos?: OauthCNBRepo[];
 }
 /**
  * OAuth 用户信息
@@ -966,6 +1127,12 @@ interface IBackendProvider {
    * 用于 Local 模式下点击 Logo 返回 IDE
    */
   closeAgentManager?(): Promise<void>;
+  /**
+   * 在外部浏览器中打开链接（可选，仅 IPC 环境支持）
+   * 用于 Local 模式下打开外部 URL
+   * @param url 要打开的 URL
+   */
+  openExternal?(url: string): Promise<void>;
   /**
    * 监听事件（可选，用于 IPC 环境）
    * @param event 事件名称
@@ -978,6 +1145,34 @@ interface IBackendProvider {
    * @returns Promise<EnterpriseUsage | null> 企业用户用量信息
    */
   getEnterpriseUsage?(enterpriseId: string): Promise<EnterpriseUsage | null>;
+  /**
+   * 刷新 Token（可选）
+   * 通过调用 getAccount 刷新 cookie
+   * 适用于 Cloud 场景下页面切换回来时刷新登录态
+   * @returns Promise<Account | null> 刷新后的账号信息
+   */
+  refreshToken?(): Promise<Account | null>;
+  /**
+   * 获取仓库分支列表
+   * API 端点: GET /console/as/connector/oauth/{name}/branches
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param params 平台特定的查询参数
+   * @param page 页码，从1开始，0表示不分页获取全部
+   * @param perPage 每页数量，最大100
+   * @returns Promise<OauthBranch[]> 分支列表
+   */
+  getBranches?(connector: OauthConnectorName, params: GitHubBranchParams | GongfengBranchParams | CNBBranchParams, page?: number, perPage?: number): Promise<OauthBranch[]>;
+  /**
+   * 获取仓库列表
+   * API 端点: GET /console/as/connector/oauth/{name}/repos
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param page 页码，从1开始，0表示不分页获取全部
+   * @param perPage 每页数量，最大100
+   * @returns Promise<ListReposResponse> 仓库列表响应
+   */
+  getRepositories?(connector: OauthConnectorName, page?: number, perPage?: number): Promise<ListReposResponse>;
 }
 /**
  * 场景中的插件信息
@@ -991,6 +1186,12 @@ interface ScenePlugin {
   /** 插件市场名称 */
   marketplaceName: string;
 }
+/**
+ * 场景模式类型
+ * - coding: 编程相关场景
+ * - working: 工作/通用场景
+ */
+type SupportSceneMode = 'coding' | 'working';
 /**
  * 支持的场景信息
  * 用于 Welcome 页面的 QuickActions 快捷操作
@@ -1005,11 +1206,15 @@ interface SupportScene {
   plugins: ScenePlugin[];
   /** 场景对应的 prompt 列表 */
   prompts: string[];
+  /** 场景模式类型 */
+  mode?: SupportSceneMode;
 }
 /**
  * 插件作用域
+ * 使用 agent-craft 的 PluginInstallScope 类型
+ * 注意: 当前后端 API 只支持 user 和 project,暂不支持 project-local
  */
-type PluginScope = 'user' | 'project';
+type PluginScope = 'user' | 'project' | 'project-local';
 /**
  * 插件操作类型
  */
@@ -1428,6 +1633,15 @@ interface AgentConnection {
     error?: string;
   }>;
   extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+  /**
+   * Report telemetry event through the standard provider chain
+   * - Local: via ACP JSON-RPC → IDE EventService
+   * - Cloud: via StreamableHTTP → cloud telemetry endpoint
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data (already includes mode)
+   */
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): Promise<void>;
 }
 /**
  * Base configuration for connections
@@ -1635,6 +1849,8 @@ interface BaseAgentState {
   updatedAt?: Date;
   /** 是否为 playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * LocalAgentState - 本地 Agent 状态
@@ -1781,16 +1997,38 @@ interface SessionInfo {
   cwd?: string;
   /** Whether the session is a playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * Parameters for creating a new session
  */
 interface CreateSessionParams$1 {
-  /** Working directory */
+  /** Working directory (required) */
   cwd: string;
+  /** Optional configuration */
+  options?: CreateSessionOptions;
+}
+/**
+ * Optional configuration for creating a session
+ */
+interface CreateSessionOptions {
   /** MCP server configurations */
   mcpServers?: McpServerConfig[];
+  /** Initial prompt for the session (Cloud only) */
+  prompt?: string;
+  /** Initial model for the session (Cloud only) */
+  model?: string;
+  /** Mode ID (e.g., 'craft', 'architect') */
+  mode?: string;
+  /** Whether this is a playground session (no cwd) */
+  isPlayground?: boolean;
+  /** Tags for template scenes (Cloud only, format: { scene: 'xxx' }) */
+  tags?: Record<string, string>;
+  /** Additional metadata */
   _meta?: Record<string, unknown>;
+  /** Callback when session is prepared (POST succeeded, before WebSocket connect) */
+  onSessionPrepared?: (sessionInfo: SessionInfo) => void;
 }
 /**
  * Parameters for loading an existing session
@@ -1825,6 +2063,15 @@ interface InitializeWorkspaceResponse {
   /** Error message (if failed) */
   error?: string;
 }
+/**
+ * Parameters for getting available commands
+ */
+interface GetAvailableCommandsParams {
+  /** Session ID to get commands for (optional, for global commands) */
+  sessionId?: string;
+  /** Workspace path for getting custom commands (optional) */
+  workspacePath?: string;
+}
 /**
  * Prompts resource interface (ACP verbs)
  * Operations use the current session automatically
@@ -1862,7 +2109,7 @@ interface ModelsResource {
  */
 interface PromptResponse {
   /** Stop reason */
-  stopReason: 'end_turn' | 'max_tokens' | 'tool_use' | 'cancelled' | 'error';
+  stopReason: StopReason;
   /** Response metadata */
   _meta?: Record<string, unknown>;
 }
@@ -1872,7 +2119,7 @@ interface PromptResponse {
 interface SessionsResourceEvents {
   /** Emitted when the sessions list changes (create, delete, update) */
   sessionsChanged: SessionInfo[];
-  /** Emitted when a new session is created */
+  /** Emitted when a new session is fully connected and ready */
   sessionCreated: SessionInfo;
   /** Emitted when a session is deleted */
   sessionDeleted: {
@@ -1956,6 +2203,8 @@ interface ActiveSession {
   readonly id: string;
   /** Agent ID */
   readonly agentId: string;
+  /** Actual workspace path (set after newSession, useful for Playground scenario) */
+  readonly cwd?: string;
   /** Agent state (direct access to underlying agent state) */
   readonly agentState: AgentState;
   /** Agent capabilities (available after connection) */
@@ -1999,7 +2248,7 @@ interface ActiveSession {
     error?: string;
   }>;
   /** Set the current session mode */
-  setMode(modeId: string): Promise<void>;
+  setMode(modeId: string, skipChecker?: boolean): Promise<void>;
   /** Set the current session model */
   setSessionModel(modelId: string): Promise<void>;
   /** Set available commands (called when available_commands_update is received) */
@@ -2142,6 +2391,13 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @returns Response with search results
    */
   searchFile?(params: SearchFileParams): Promise<SearchFileResponse>;
+  /**
+   * Get subagent list (optional, used by LocalAgentProvider)
+   *
+   * @param params - Query parameters including options
+   * @returns Response with subagent list
+   */
+  getSubagentList?(params: GetSubagentListParams): Promise<GetSubagentListResponse>;
   /**
    * Batch toggle plugins (optional, used by LocalAgentProvider)
    *
@@ -2169,12 +2425,22 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param pluginNames - Array of plugin names to install
    * @param marketplaceName - Marketplace name
    * @param installScope - Install scope ('user' | 'project')
+   * @param marketplaceSource - Marketplace source URL (for auto-adding marketplace when not exists)
    * @returns Result of the operation
    */
-  installPlugins?(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project'): Promise<{
+  installPlugins?(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string, workspacePath?: string): Promise<{
     success: boolean;
     error?: string;
   }>;
+  /**
+   * Get available commands for a session (optional, used by LocalAgentProvider)
+   * If session.availableCommands has cached values, return them
+   * Otherwise, fetch from product configuration
+   *
+   * @param params - Parameters for getting commands
+   * @returns Array of available commands
+   */
+  getAvailableCommands?(params?: GetAvailableCommandsParams): Promise<AvailableCommand[]>;
   /**
    * Register an event listener
    * Provider implementations should forward events to the underlying transport
@@ -2190,6 +2456,49 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param handler - Event handler function to remove
    */
   off?(event: string, handler: (...args: any[]) => void): void;
+  /**
+   * Report telemetry event through the provider chain
+   * - Local: via ACP JSON-RPC → AcpAgent → IDE EventService
+   * - Cloud: via connection → cloud endpoint
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data
+   */
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): Promise<void>;
+  /**
+   * Respond to MCP Sampling confirmation request (optional, used by LocalAgentProvider)
+   * Called when user confirms/rejects a sampling request
+   *
+   * @param sessionId - Session ID
+   * @param response - Sampling confirmation response
+   */
+  respondToSampling?(sessionId: string, response: McpSamplingConfirmResponse): Promise<void>;
+  /**
+   * Respond to MCP Roots confirmation request (optional, used by LocalAgentProvider)
+   * Called when user confirms/rejects a roots request
+   *
+   * @param sessionId - Session ID
+   * @param response - Roots confirmation response
+   */
+  respondToRoots?(sessionId: string, response: McpRootsConfirmResponse): Promise<void>;
+  /**
+   * Subscribe to MCP Sampling confirmation requests (optional, used by LocalAgentProvider)
+   * Called when MCP server initiates a sampling request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeSamplingRequests?(serverName: string, callback: (request: McpSamplingConfirmRequest) => void): () => void;
+  /**
+   * Subscribe to MCP Roots confirmation requests (optional, used by LocalAgentProvider)
+   * Called when MCP server initiates a roots request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeRootsRequests?(serverName: string, callback: (request: McpRootsConfirmRequest) => void): () => void;
 }
 /**
  * AgentClient initialization options
@@ -2277,6 +2586,8 @@ interface ClientSessionsResource {
   uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
   /** Search for files in the workspace (for LocalAgentProvider) */
   searchFile(params: SearchFileParams): Promise<SearchFileResponse>;
+  /** Get subagent list (for LocalAgentProvider) */
+  getSubagentList(params: GetSubagentListParams): Promise<GetSubagentListResponse>;
   /** Batch toggle plugins (for LocalAgentProvider) */
   batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
   /** Get installed plugins (for LocalAgentProvider) */
@@ -2289,15 +2600,32 @@ interface ClientSessionsResource {
     installScope?: 'user' | 'project';
   }>>;
   /** Install plugins (for LocalAgentProvider) */
-  installPlugins(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project'): Promise<{
+  installPlugins(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string, workspacePath?: string): Promise<{
     success: boolean;
     error?: string;
   }>;
   /**
    * Get support scenes from backend API (for LocalAgentProvider)
    * API 端点: GET /v2/as/support/scenes (Local) 或 GET /console/as/support/scenes (Web)
+   * @param locale - 可选，语言环境（如 'zh-CN', 'en-US'），用于获取对应语言的场景数据
+   */
+  getSupportScenes(locale?: string): Promise<Array<{
+    id: number;
+    name: string;
+    plugins: Array<{
+      id: number;
+      name: string;
+      marketplaceName: string;
+    }>;
+    prompts: string[];
+    mode?: 'coding' | 'working';
+  }>>;
+  /**
+   * Get product scenes from ProductManager configuration (for LocalAgentProvider)
+   * 从 ProductManager.waitConfiguration().scenes 获取本地配置的场景数据
+   * @param locale - 可选，语言环境
    */
-  getSupportScenes(): Promise<Array<{
+  getProductScenes?(locale?: string): Promise<Array<{
     id: number;
     name: string;
     plugins: Array<{
@@ -2306,7 +2634,145 @@ interface ClientSessionsResource {
       marketplaceName: string;
     }>;
     prompts: string[];
+    mode?: 'coding' | 'working';
+    target?: 'local' | 'cloud' | 'all';
   }>>;
+  /**
+   * Get available commands for a session
+   * If session.availableCommands has cached values, return them
+   * Otherwise, fetch from provider (for LocalAgentProvider)
+   * @param params - Parameters for getting commands
+   * @returns Promise<AvailableCommand[]> - Array of available commands
+   */
+  getAvailableCommands(params?: GetAvailableCommandsParams): Promise<AvailableCommand[]>;
+  /**
+   * Report telemetry event through the provider chain
+   * Delegates to AgentProvider.reportTelemetry()
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data
+   */
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): Promise<void>;
+  /**
+   * Respond to MCP Sampling confirmation request
+   * Called when user confirms/rejects a sampling request in MCP tool renderer
+   *
+   * @param sessionId - Session ID
+   * @param response - Sampling confirmation response
+   */
+  respondToSampling?(sessionId: string, response: McpSamplingConfirmResponse): Promise<void>;
+  /**
+   * Respond to MCP Roots confirmation request
+   * Called when user confirms/rejects a roots request in MCP tool renderer
+   *
+   * @param sessionId - Session ID
+   * @param response - Roots confirmation response
+   */
+  respondToRoots?(sessionId: string, response: McpRootsConfirmResponse): Promise<void>;
+  /**
+   * Subscribe to MCP Sampling confirmation requests
+   * Called when MCP server initiates a sampling request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeSamplingRequests?(serverName: string, callback: (request: McpSamplingConfirmRequest) => void): () => void;
+  /**
+   * Subscribe to MCP Roots confirmation requests
+   * Called when MCP server initiates a roots request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeRootsRequests?(serverName: string, callback: (request: McpRootsConfirmRequest) => void): () => void;
+}
+/**
+ * MCP Sampling message role
+ */
+type McpSamplingRole = 'user' | 'assistant';
+/**
+ * MCP Sampling message content - text
+ */
+interface McpSamplingTextContent {
+  type: 'text';
+  text: string;
+}
+/**
+ * MCP Sampling message content - image
+ */
+interface McpSamplingImageContent {
+  type: 'image';
+  data: string;
+  mimeType: string;
+}
+/**
+ * MCP Sampling message content - audio
+ */
+interface McpSamplingAudioContent {
+  type: 'audio';
+  data: string;
+  mimeType: string;
+}
+/**
+ * MCP Sampling message content union type
+ */
+type McpSamplingContent = McpSamplingTextContent | McpSamplingImageContent | McpSamplingAudioContent;
+/**
+ * MCP Sampling message
+ */
+interface McpSamplingMessage {
+  role: McpSamplingRole;
+  content: McpSamplingContent;
+}
+/**
+ * MCP Sampling confirmation request
+ * Sent from backend when MCP server requests sampling
+ */
+interface McpSamplingConfirmRequest {
+  id: string;
+  serverName: string;
+  model?: string;
+  messages: McpSamplingMessage[];
+  systemPrompt?: string;
+  maxTokens: number;
+  timestamp: number;
+}
+/**
+ * MCP Sampling confirmation response
+ * Sent from frontend when user confirms/rejects
+ */
+interface McpSamplingConfirmResponse {
+  id: string;
+  approved: boolean;
+  rememberChoice?: boolean;
+}
+/**
+ * MCP Root definition
+ */
+interface McpRoot {
+  uri: string;
+  name?: string;
+}
+/**
+ * MCP Roots confirmation request
+ * Sent from backend when MCP server requests roots access
+ */
+interface McpRootsConfirmRequest {
+  id: string;
+  serverName: string;
+  roots: McpRoot[];
+  timestamp: number;
+}
+/**
+ * MCP Roots confirmation response
+ * Sent from frontend when user confirms/rejects
+ */
+interface McpRootsConfirmResponse {
+  id: string;
+  approved: boolean;
+  rememberChoice?: boolean;
 }
 /**
  * Workspace information (aligned with FolderSelectResult)
@@ -2372,6 +2838,8 @@ interface PickFolderResponse {
 interface UploadFileParams {
   /** Files to upload - File objects in browser, absolute path strings in IDE */
   readonly files: Array<File | string>;
+  /** Optional AbortSignal to cancel the upload */
+  readonly abortSignal?: AbortSignal;
 }
 /**
  * Response from uploading files
@@ -2385,6 +2853,8 @@ interface UploadFileResponse {
   readonly expireSeconds?: number;
   /** Error message (if upload failed) */
   readonly error?: string;
+  /** Whether the upload was cancelled by user */
+  readonly aborted?: boolean;
 }
 /**
  * Mention type for file/folder
@@ -2435,6 +2905,52 @@ interface SearchFileResponse {
   /** Error message (if failed) */
   readonly error?: string;
 }
+/**
+ * Subagent information
+ */
+interface SubagentInfo {
+  /** Subagent name */
+  name: string;
+  /** Subagent description */
+  description: string;
+  /** System prompt */
+  systemPrompt: string;
+  /** File path */
+  filePath?: string;
+  /** Model type */
+  model?: string;
+  /** Agent mode */
+  agentMode?: 'agentic' | 'manual';
+  /** Whether enabled */
+  enabled?: boolean;
+  /** Model ID */
+  modelID?: string;
+  /** Subagent level */
+  level?: 'project' | 'user';
+}
+/**
+ * Parameters for getting subagent list
+ */
+interface GetSubagentListParams {
+  /** Search options */
+  readonly options: {
+    /** Search keyword (filter by name or description) */readonly search?: string; /** Limit number of results */
+    readonly resultNum?: number; /** Agent mode filter */
+    readonly agentMode?: 'agentic' | 'manual' | 'all'; /** Whether to return only enabled subagents */
+    readonly onlyEnabled?: boolean;
+  };
+  /** Working directory (optional, for filtering project-level subagents) */
+  readonly cwd?: string;
+}
+/**
+ * Response from getting subagent list
+ */
+interface GetSubagentListResponse {
+  /** Subagent list */
+  readonly results: SubagentInfo[];
+  /** Error message (if failed) */
+  readonly error?: string;
+}
 //#endregion
 //#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
 /**
@@ -2513,6 +3029,7 @@ declare class CloudAgentConnection implements AgentConnection {
    * Contains sandboxId, link, token, etc.
    */
   get sessionConnectionInfo(): SessionConnectionInfo | undefined;
+  reportTelemetry(eventName: string, payload: Record<string, unknown>): Promise<void>;
   extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
 }
 //#endregion
@@ -2691,8 +3208,9 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   /**
    * Create a new conversation
    * POST {endpoint}/console/as/conversations
+   * @param params - Session params containing cwd and optional configuration
    */
-  create(): Promise<string>;
+  create(params: CreateSessionParams$1): Promise<string>;
   /**
    * Connect to an agent and return the connection
    *
@@ -2778,7 +3296,7 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   /**
    * Upload files to cloud storage via COS presigned URL
    *
-   * @param params - files array (File objects in browser)
+   * @param params - files array (File objects in browser), optional abortSignal
    * @returns Response with corresponding cloud URLs
    */
   uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
@@ -2802,17 +3320,23 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   private emitEvent;
   /**
    * 获取支持的场景列表
-   * API 端点: GET /console/as/support/scenes
+   * API 端点: GET /v2/as/support/scenes (不鉴权)
    * 用于 Welcome 页面的 QuickActions 快捷操作
    *
+   * @param locale - 可选，语言环境（如 'zh-CN', 'en-US'），用于获取对应语言的场景数据
    * @returns Promise<SupportScene[]> 支持的场景列表
    */
-  getSupportScenes(): Promise<SupportScene[]>;
+  getSupportScenes(locale?: string): Promise<SupportScene[]>;
   private toAgentState;
   /**
    * Helper: 将 GET 请求的 body 转换为 URL 查询参数
    */
   private buildGetUrl;
+  /**
+   * 上报 telemetry 事件（Cloud 模式）
+   * 通过 HTTP POST 发送到 /v2/report
+   */
+  reportTelemetry(eventName: string, payload: Record<string, unknown>): Promise<void>;
 }
 //#endregion
 //#region ../agent-provider/lib/common/providers/cloud-agent-provider/e2b-filesystem.d.ts
@@ -2991,6 +3515,7 @@ interface ActiveSessionImplOptions {
 declare class ActiveSessionImpl implements ActiveSession {
   private _id;
   private _agentId;
+  private _cwd?;
   private _availableModes?;
   private _currentMode?;
   private _availableModels?;
@@ -3002,6 +3527,7 @@ declare class ActiveSessionImpl implements ActiveSession {
   private _connectionInfo?;
   private listeners;
   private onceListeners;
+  private connectionListeners;
   /**
    * Agent operations namespace
    */
@@ -3035,6 +3561,14 @@ declare class ActiveSessionImpl implements ActiveSession {
    * Agent ID
    */
   get agentId(): string;
+  /**
+   * Actual workspace path (set from newSession response _meta)
+   */
+  get cwd(): string | undefined;
+  /**
+   * Set actual workspace path (called by SessionManager after createSession)
+   */
+  setCwd(cwd: string): void;
   /**
    * Agent state (live connection state)
    * Returns LocalAgentState or CloudAgentState based on transport type
@@ -3140,7 +3674,7 @@ declare class ActiveSessionImpl implements ActiveSession {
    * await session.setMode('architect');
    * ```
    */
-  setMode(modeId: string): Promise<void>;
+  setMode(modeId: string, skipAvailableChecker?: boolean): Promise<void>;
   /**
    * Set the current session model
    *
@@ -3193,8 +3727,22 @@ declare class ActiveSessionImpl implements ActiveSession {
    */
   [Symbol.dispose](): void;
   private getConnectionOrThrow;
+  /**
+   * 在 connection 上注册 listener 并保存引用，便于 disconnect 时移除
+   */
+  private addConnectionListener;
+  /**
+   * 从 connection 上移除所有本 session 注册的 listener
+   */
+  private removeConnectionListeners;
   private setupConnectionEvents;
   private mapPromptResponse;
+  /**
+   * 判断 artifact 是否应该转发给当前 session
+   * - media 类型：按 cwd 路径隔离（同 cwd 下不同 session 可共享 media）
+   * - 其余类型：按 __sessionId 严格隔离
+   */
+  private shouldForwardArtifact;
 }
 //#endregion
 //#region ../agent-provider/lib/common/client/session-manager.d.ts
@@ -3271,6 +3819,18 @@ declare class SessionManager {
    * 7. Return ActiveSession instance (cached)
    */
   loadSession(params: LoadSessionParams$1): Promise<ActiveSession>;
+  /**
+   * 从 ACP response 中提取可用模型列表
+   *
+   * 优先级:
+   * 1. response.models._meta?.['codebuddy.ai']?.availableModels - 包含完整的模型信息（字段名为 'id'）
+   * 2. response.models?.availableModels - 只包含基本信息（字段名为 'modelId'）
+   * 3. undefined - 都没有时返回 undefined
+   *
+   * @param response - ACP 响应对象
+   * @returns ModelInfo[] | undefined
+   */
+  protected extractAvailableModels(response: LoadSessionResponse): ModelInfo[] | undefined;
 }
 //#endregion
 //#region ../agent-provider/lib/backend/backend-provider.d.ts
@@ -3287,6 +3847,13 @@ declare class SessionManager {
  */
 declare class BackendProvider implements IBackendProvider {
   constructor(config: BackendProviderConfig);
+  /**
+   * 处理 401 未授权错误
+   * 先尝试刷新 token，失败后再执行登出流程
+   *
+   * @throws 如果 token 刷新失败，抛出错误通知 HttpService 不要重试
+   */
+  protected handleUnauthorized(): Promise<void>;
   /**
    * 获取当前账号信息
    * API 端点: GET /console/accounts (返回账号列表)
@@ -3410,6 +3977,38 @@ declare class BackendProvider implements IBackendProvider {
    * API: POST /billing/meter/get-enterprise-user-usage
    */
   getEnterpriseUsage(enterpriseId: string): Promise<EnterpriseUsage | null>;
+  /**
+   * 刷新 Token
+   * 通过调用 getAccount 刷新 cookie，适用于 Cloud 场景下页面切换回来时刷新登录态
+   * @returns Promise<Account | null> 刷新后的账号信息
+   */
+  refreshToken(): Promise<Account | null>;
+  /**
+   * 获取仓库分支列表
+   * API 端点: GET /console/as/connector/oauth/{name}/branches
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param params 平台特定的查询参数
+   * @param page 页码，从1开始，0表示不分页获取全部
+   * @param perPage 每页数量，最大100
+   * @returns Promise<OauthBranch[]> 分支列表
+   */
+  getBranches(connector: OauthConnectorName, params: GitHubBranchParams | GongfengBranchParams | CNBBranchParams, page?: number, perPage?: number): Promise<OauthBranch[]>;
+  /**
+   * 获取仓库列表
+   * API 端点: GET /console/as/connector/oauth/{name}/repos
+   *
+   * Note: 由于工蜂原生支持的 Search 能力会匹配 path/name/description 部分，
+   * 且不支持定制，不满足产品要求（只按 name 匹配），因此前端拉取全量数据后做筛选。
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param page 页码，从1开始，0表示不分页获取全部
+   *             - GitHub 只支持全量数据，必须传 0
+   *             - 工蜂和 CNB 依据前端逻辑而定
+   * @param perPage 每页数量，最大100
+   * @returns Promise<ListReposResponse> 仓库列表响应
+   */
+  getRepositories(connector: OauthConnectorName, page?: number, perPage?: number): Promise<ListReposResponse>;
 }
 /**
  * 创建 BackendProvider 实例
@@ -3543,6 +4142,12 @@ declare class IPCBackendProvider implements IBackendProvider {
    * IDE 环境: 通过 IPC 通知 IDE 关闭 Agent Manager（用于返回 IDE）
    */
   closeAgentManager(): Promise<void>;
+  /**
+   * 在外部浏览器中打开链接
+   * IDE 环境: 通过 IPC 通知 IDE 使用 vscode.env.openExternal 打开 URL
+   * @param url 要打开的 URL
+   */
+  openExternal(url: string): Promise<void>;
   /**
    * 批量切换插件状态
    * IDE 环境: 通过 IPC 调用 Extension Host 的 PluginService
@@ -3614,7 +4219,7 @@ type UnauthorizedCallback = () => void;
  * 特性：
  * - 单例模式，全局唯一实例，延迟初始化（首次使用时自动创建）
  * - 支持拦截器注册（其他模块可注入 header）
- * - 统一 401/403 处理
+ * - 统一 401 处理（支持自动刷新 token 并重试）
  * - 自动携带凭证（withCredentials）
  * - 类型安全
  *
@@ -3650,6 +4255,10 @@ declare class HttpService {
   private axiosInstance;
   private unauthorizedCallbacks;
   private config;
+  /** 是否正在刷新 token */
+  private isRefreshing;
+  /** 等待 token 刷新完成的请求队列 */
+  private refreshSubscribers;
   /**
    * 私有构造函数（单例模式）
    */
@@ -3667,9 +4276,17 @@ declare class HttpService {
    */
   private registerDefaultRequestInterceptor;
   /**
-   * 注册默认响应拦截器（处理 401/403）
+   * 注册默认响应拦截器（处理 401，支持自动重试）
    */
   private registerDefaultResponseInterceptor;
+  /**
+   * token 刷新成功，通知所有等待的请求
+   */
+  private onRefreshSuccess;
+  /**
+   * token 刷新失败，通知所有等待的请求
+   */
+  private onRefreshFailure;
   /**
    * 注册请求拦截器
    * @param onFulfilled 请求成功拦截器
@@ -3735,7 +4352,9 @@ declare class HttpService {
    */
   offUnauthorized(callback: UnauthorizedCallback): void;
   /**
-   * 触发所有 401 回调
+   * 触发所有 401 回调并等待完成
+   * @returns Promise，等待所有回调完成
+   * @throws 如果任何回调失败，则抛出错误
    */
   private triggerUnauthorizedCallbacks;
   /**