@tencent-ai/cloud-agent-sdk 0.2.12 → 0.2.13-next.06ef89d.20260310

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,50 @@ 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>;
+  /**
+   * 保存待发送的输入内容到后端（用于跨域登录场景）
+   * API 端点: POST /api/v1/code-id
+   *
+   * @param code 要保存的文本内容
+   * @returns Promise<string | null> 返回 codeId，失败返回 null
+   */
+  savePendingInput?(code: string): Promise<string | null>;
+  /**
+   * 从后端加载待发送的输入内容（用于跨域登录场景）
+   * API 端点: GET /api/v1/code?id=xxx
+   *
+   * @param codeId 内容 ID
+   * @returns Promise<string | null> 返回保存的文本内容，失败返回 null
+   */
+  loadPendingInput?(codeId: string): Promise<string | null>;
 }
 /**
  * 场景中的插件信息
@@ -991,6 +1202,12 @@ interface ScenePlugin {
   /** 插件市场名称 */
   marketplaceName: string;
 }
+/**
+ * 场景模式类型
+ * - coding: 编程相关场景
+ * - working: 工作/通用场景
+ */
+type SupportSceneMode = 'coding' | 'working';
 /**
  * 支持的场景信息
  * 用于 Welcome 页面的 QuickActions 快捷操作
@@ -1005,11 +1222,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' | 'local';
 /**
  * 插件操作类型
  */
@@ -1315,7 +1536,7 @@ type PromptContentBlock = {
   uri: string;
   mimeType?: string | null;
   name: string;
-  size?: bigint | null;
+  size?: number | null;
   title?: string | null;
   _meta?: {
     [key: string]: unknown;
@@ -1428,6 +1649,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 +1865,8 @@ interface BaseAgentState {
   updatedAt?: Date;
   /** 是否为 playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * LocalAgentState - 本地 Agent 状态
@@ -1698,6 +1930,11 @@ interface ListAgentSort {
  * Local: Client-side filtering and sorting, no pagination (returns all)
  */
 interface ListAgentOptions {
+  /**
+   * User ID for filtering sessions (required for multi-user isolation)
+   * If not provided, returns empty list for Local provider
+   */
+  userId?: string;
   /**
    * Page number (starts from 1)
    * Cloud: Used for API pagination
@@ -1781,16 +2018,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 +2084,80 @@ interface InitializeWorkspaceResponse {
   /** Error message (if failed) */
   error?: string;
 }
+type AutomationStatus = 'ACTIVE' | 'PAUSED';
+type AutomationUpdateMode = 'view' | 'suggested create' | 'suggested update';
+type AutomationRunStatus = 'ACCEPTED' | 'ARCHIVED' | 'PENDING_REVIEW' | 'IN_PROGRESS';
+interface AutomationDefinition {
+  version: number;
+  id: string;
+  name: string;
+  prompt: string;
+  status: AutomationStatus;
+  rrule: string;
+  cwds: string[];
+  created_at: number;
+  updated_at: number;
+}
+interface AutomationCwdRunResult {
+  cwd: string;
+  success: boolean;
+  startedAt: number;
+  finishedAt: number;
+  conversationId?: string;
+  output?: string;
+  error?: string;
+}
+interface AutomationInboxItem {
+  id: string;
+  automationId: string;
+  automationName: string;
+  status?: AutomationRunStatus;
+  readAt?: number;
+  startedAt: number;
+  finishedAt: number;
+  success: boolean;
+  summary: string;
+  runs: AutomationCwdRunResult[];
+  archived?: boolean;
+  archivedAt?: number;
+}
+interface AutomationRuntimeState {
+  lastRunAt?: number;
+  lastError?: string;
+  running?: boolean;
+  runningStartedAt?: number;
+  runningConversationId?: string;
+}
+interface AutomationSnapshot {
+  automations: AutomationDefinition[];
+  inbox: AutomationInboxItem[];
+  runtimeState: Record<string, AutomationRuntimeState>;
+  updatedAt: number;
+}
+interface AutomationUpdatePayload {
+  mode: AutomationUpdateMode;
+  id?: string;
+  name?: string;
+  prompt?: string;
+  rrule?: string;
+  cwds?: string[] | string;
+  status?: AutomationStatus;
+}
+interface AutomationUpdateResult {
+  success: boolean;
+  message: string;
+  automation?: AutomationDefinition;
+  snapshot?: AutomationSnapshot;
+}
+/**
+ * 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 +2195,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 +2205,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: {
@@ -1880,6 +2213,8 @@ interface SessionsResourceEvents {
   };
   /** Emitted when a session is updated (status change, etc.) */
   sessionUpdated: SessionInfo;
+  /** Emitted when automation snapshot is updated (pushed from server) */
+  automationSnapshotUpdate: AutomationSnapshot;
 }
 /**
  * Event handler type for sessions resource events
@@ -1956,6 +2291,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 +2336,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) */
@@ -2016,6 +2353,12 @@ interface ActiveSession {
   once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
   /** Disconnect from the session/agent */
   disconnect(): void;
+  /**
+   * Detach the session from connection events without disconnecting the connection.
+   * This should be called when the session is being replaced but the connection is shared.
+   * Unlike disconnect(), this only removes event listeners without closing the connection.
+   */
+  detach(): void;
   /** Symbol.dispose for 'using' keyword support */
   [Symbol.dispose](): void;
 }
@@ -2080,6 +2423,17 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
   rename?(agentId: string, title: string): Promise<{
     id: string;
   }>;
+  /**
+   * Update agent status by ID (optional)
+   * Used by CloudAgentProvider for updating session status
+   *
+   * @param agentId - Agent ID to update
+   * @param status - New status for the agent
+   * @returns Object containing the updated agent ID
+   */
+  updateStatus?(agentId: string, status: string): Promise<{
+    id: string;
+  }>;
   /**
    * Move an agent by ID (optional)
    * Used by LocalAgentProvider for moving Playground sessions to Workspace
@@ -2099,6 +2453,30 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @returns Array of model information
    */
   getModels?(repo?: string): Promise<ModelInfo[]>;
+  /**
+   * Get product configuration subset (optional)
+   * Returns deploymentType, creditPurchaseActions, links, networkEnvironment
+   */
+  getProductConfiguration?(): Promise<{
+    deploymentType?: string;
+    creditPurchaseActions?: Record<string, {
+      labelZh: string;
+      labelEn: string;
+      url: string;
+      showButton?: boolean;
+    }>;
+    links?: {
+      craftFeedback?: string;
+    };
+    networkEnvironment?: string;
+  }>;
+  /**
+   * Get user info (optional)
+   * Returns enterpriseId from authentication session
+   */
+  getUserInfo?(): Promise<{
+    enterpriseId?: string;
+  }>;
   /**
    * Register sessionId → agentId mapping (optional, used by LocalAgentProvider)
    * Called after session creation to maintain the mapping for loadSession
@@ -2142,6 +2520,27 @@ 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>;
+  /**
+   * Get skill list (optional, used by LocalAgentProvider)
+   *
+   * @param params - Query parameters
+   * @returns Response with skill list
+   */
+  getSkillList?(params?: GetSkillListParams): Promise<GetSkillListResponse>;
+  /**
+   * Import a skill folder (optional, used by LocalAgentProvider)
+   *
+   * @param params - Import parameters including source location
+   * @returns Response with import result
+   */
+  importSkill?(params: ImportSkillParams): Promise<ImportSkillResponse>;
   /**
    * Batch toggle plugins (optional, used by LocalAgentProvider)
    *
@@ -2162,6 +2561,9 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
     description?: string;
     version?: string;
     installScope?: 'user' | 'project';
+    installedScopes?: Array<'user' | 'project' | 'local' | 'project-local'>;
+    installedScopesStatus?: Record<string, boolean>;
+    installId?: string;
   }>>;
   /**
    * Install plugins (optional, used by LocalAgentProvider)
@@ -2169,12 +2571,46 @@ 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[]>;
+  /**
+   * Get automation snapshot (optional, used by LocalAgentProvider)
+   */
+  getAutomationSnapshot?(): Promise<AutomationSnapshot>;
+  /**
+   * Create/update automation definition (optional, used by LocalAgentProvider)
+   */
+  updateAutomation?(payload: AutomationUpdatePayload): Promise<AutomationUpdateResult>;
+  /**
+   * Delete automation definition (optional, used by LocalAgentProvider)
+   */
+  deleteAutomation?(id: string): Promise<AutomationUpdateResult>;
+  /**
+   * Archive an automation inbox item (optional, used by LocalAgentProvider)
+   */
+  archiveAutomationInboxItem?(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Delete an automation inbox item (optional, used by LocalAgentProvider)
+   */
+  deleteAutomationInboxItem?(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Trigger test run for automation (optional, used by LocalAgentProvider)
+   */
+  testAutomation?(id: string): Promise<AutomationUpdateResult>;
   /**
    * Register an event listener
    * Provider implementations should forward events to the underlying transport
@@ -2190,17 +2626,77 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param handler - Event handler function to remove
    */
   off?(event: string, handler: (...args: any[]) => void): void;
-}
-/**
- * AgentClient initialization options
- */
-interface AgentClientOptions {
-  /** Agent provider (required) */
-  provider: AgentProvider;
-  /** Logger instance */
-  logger?: Logger;
-  /** Client capabilities (sent during initialization) */
-  clientCapabilities?: ClientCapabilities$1;
+  /**
+   * 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;
+  /**
+   * Get product scenes from ProductManager configuration (optional, for LocalAgentProvider)
+   * 从 ProductManager.waitConfiguration().scenes 获取本地配置的场景数据
+   * @param locale - 可选，语言环境
+   */
+  getProductScenes?(locale?: string): Promise<Array<{
+    id: number;
+    name: string;
+    plugins: Array<{
+      id: number;
+      name: string;
+      marketplaceName: string;
+    }>;
+    prompts: string[];
+    mode?: 'coding' | 'working';
+    target?: 'local' | 'cloud' | 'all';
+  }>>;
+}
+/**
+ * AgentClient initialization options
+ */
+interface AgentClientOptions {
+  /** Agent provider (required) */
+  provider: AgentProvider;
+  /** Logger instance */
+  logger?: Logger;
+  /** Client capabilities (sent during initialization) */
+  clientCapabilities?: ClientCapabilities$1;
   /**
    * 运行环境类型
    * - 'local': IDE 本地环境
@@ -2247,6 +2743,15 @@ interface ClientSessionsResource {
   rename(sessionId: string, title: string): Promise<{
     id: string;
   }>;
+  /**
+   * Update session status
+   * @param sessionId - Session ID to update
+   * @param status - New status for the session
+   * @returns Object containing the updated session ID
+   */
+  updateStatus(sessionId: string, status: string): Promise<{
+    id: string;
+  }>;
   /**
    * Move a session (Playground → Workspace)
    * @param sessionId - Session ID to move
@@ -2277,6 +2782,12 @@ 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>;
+  /** Get skill list (for LocalAgentProvider) */
+  getSkillList(params?: GetSkillListParams): Promise<GetSkillListResponse>;
+  /** Import a skill folder (for LocalAgentProvider) */
+  importSkill(params: ImportSkillParams): Promise<ImportSkillResponse>;
   /** Batch toggle plugins (for LocalAgentProvider) */
   batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
   /** Get installed plugins (for LocalAgentProvider) */
@@ -2287,17 +2798,120 @@ interface ClientSessionsResource {
     description?: string;
     version?: string;
     installScope?: 'user' | 'project';
+    installedScopes?: Array<'user' | 'project' | 'local' | 'project-local'>;
+    installedScopesStatus?: Record<string, boolean>;
+    installId?: string;
   }>>;
   /** 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;
   }>;
+  /** Uninstall a plugin (for LocalAgentProvider) */
+  uninstallPlugin?(pluginName: string, marketplaceName: string, scope: 'user' | 'project' | 'project-local'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Update a plugin to the latest version (for LocalAgentProvider) */
+  updatePlugin?(pluginName: string, marketplaceName: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Get plugin marketplaces list (for LocalAgentProvider) */
+  getPluginMarketplaces?(forceRefresh?: boolean): Promise<Array<{
+    id: string;
+    name: string;
+    type: 'github' | 'local' | 'custom';
+    source: {
+      repo?: string;
+      ref?: string;
+      url?: string;
+    };
+    description?: string;
+    isBuiltin?: boolean;
+  }>>;
+  /** Get plugins from a marketplace (for LocalAgentProvider) */
+  getMarketplacePlugins?(marketplaceName: string, forceRefresh?: boolean, searchText?: string): Promise<Array<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    iconUrl?: string;
+    tags?: string[];
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+    installedScopes?: Array<'user' | 'project'>;
+    hasUpdate?: boolean;
+  }>>;
+  /** Get plugin detail (for LocalAgentProvider) */
+  getPluginDetail?(pluginName: string, marketplaceName: string): Promise<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    readme?: string;
+    tools?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    resources?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    prompts?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+  } | null>;
+  /** Add a plugin marketplace (for LocalAgentProvider) */
+  addPluginMarketplace?(source: string, name?: string): Promise<{
+    success: boolean;
+    error?: string;
+    marketplace?: {
+      id: string;
+      name: string;
+      type: 'github' | 'local' | 'custom';
+      source: {
+        repo?: string;
+        ref?: string;
+        url?: string;
+      };
+      description?: string;
+      isBuiltin?: boolean;
+    };
+  }>;
+  /** Remove a plugin marketplace (for LocalAgentProvider) */
+  removePluginMarketplace?(marketplaceName: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Refresh a plugin marketplace (for LocalAgentProvider) */
+  refreshPluginMarketplace?(marketplaceName: string): Promise<{
+    success: boolean;
+    error?: string;
+    plugins?: Array<{
+      name: string;
+      marketplaceName: string;
+      description?: string;
+      version?: string;
+      installed?: boolean;
+      status?: 'enabled' | 'disabled' | 'not-installed';
+    }>;
+  }>;
+  /** Open folder in new window (for LocalAgentProvider) */
+  openFolderInNewWindow?(folderPath: string): Promise<void>;
   /**
    * 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(): Promise<Array<{
+  getSupportScenes(locale?: string): Promise<Array<{
     id: number;
     name: string;
     plugins: Array<{
@@ -2306,7 +2920,211 @@ interface ClientSessionsResource {
       marketplaceName: string;
     }>;
     prompts: string[];
+    mode?: 'coding' | 'working';
   }>>;
+  /**
+   * Get product scenes from ProductManager configuration (for LocalAgentProvider)
+   * 从 ProductManager.waitConfiguration().scenes 获取本地配置的场景数据
+   * @param locale - 可选，语言环境
+   */
+  getProductScenes?(locale?: string): Promise<Array<{
+    id: number;
+    name: string;
+    plugins: Array<{
+      id: number;
+      name: string;
+      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[]>;
+  /**
+   * Get automation snapshot
+   */
+  getAutomationSnapshot(): Promise<AutomationSnapshot>;
+  /**
+   * Create/update automation definition
+   */
+  updateAutomation(payload: AutomationUpdatePayload): Promise<AutomationUpdateResult>;
+  /**
+   * Delete automation definition
+   */
+  deleteAutomation(id: string): Promise<AutomationUpdateResult>;
+  /**
+   * Archive automation inbox item
+   */
+  archiveAutomationInboxItem(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Delete automation inbox item
+   */
+  deleteAutomationInboxItem(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Trigger automation test run
+   */
+  testAutomation(id: string): Promise<AutomationUpdateResult>;
+  /**
+   * 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>;
+  /**
+   * Get product configuration subset
+   * Returns deploymentType, creditPurchaseActions, links
+   * Used by agent-ui for error banner credit purchase guidance
+   */
+  getProductConfiguration?(): Promise<{
+    deploymentType?: string;
+    creditPurchaseActions?: Record<string, {
+      labelZh: string;
+      labelEn: string;
+      url: string;
+      showButton?: boolean;
+    }>;
+    links?: {
+      craftFeedback?: string;
+    };
+    networkEnvironment?: string;
+  }>;
+  /**
+   * Get user info
+   * Returns enterpriseId from authentication session
+   * Used by agent-ui for determining personal/enterprise user
+   */
+  getUserInfo?(): Promise<{
+    enterpriseId?: string;
+  }>;
+  /**
+   * 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 +3190,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 +3205,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 +3257,109 @@ 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;
+}
+/**
+ * Skill info returned from getSkillList
+ */
+interface SkillInfo {
+  /** Skill name */
+  name: string;
+  /** File path of the skill */
+  filePath: string;
+  /** Description of the skill */
+  description: string;
+  /** When to use the skill */
+  whenToUse?: string;
+  /** Source of the skill */
+  source: 'localSettings' | 'userSettings' | 'plugin' | 'builtin';
+  /** Skill type */
+  type: 'prompt';
+  /** License information */
+  license?: string;
+  /** Allowed tools */
+  allowedTools?: string[];
+  /** Whether the skill is disabled */
+  disable?: boolean;
+}
+/**
+ * Parameters for getting skill list
+ */
+interface GetSkillListParams {
+  /** Working directory (optional, for filtering project-level skills) */
+  readonly cwd?: string;
+}
+/**
+ * Response from getting skill list
+ */
+interface GetSkillListResponse {
+  /** Skill list */
+  readonly results: SkillInfo[];
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for importing a skill folder
+ */
+interface ImportSkillParams {
+  /** Source location: project-level or user-level */
+  readonly source: 'localSettings' | 'userSettings';
+  /** Working directory (optional, for project-level skill import) */
+  readonly cwd?: string;
+}
+/**
+ * Response from importing a skill folder
+ */
+interface ImportSkillResponse {
+  /** Whether the import was successful */
+  readonly success: boolean;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
 //#endregion
 //#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
 /**
@@ -2466,6 +3391,17 @@ declare class CloudAgentConnection implements AgentConnection {
   readonly transport: "cloud";
   readonly cwd: string;
   constructor(agentId: string, config: CloudConnectionConfig, cwd?: string);
+  /**
+   * Check whether a notification belongs to this connection's own session.
+   *
+   * CloudConnection.createSession() overrides sessionId to agentId, so the
+   * rest of the client stack uses agentId as the canonical session
+   * identifier.  Notifications whose sessionId differs from agentId
+   * originate from sub-agent sessions running inside the same sandbox and
+   * should be silently ignored at this layer — the adapter layer handles
+   * sub-agent messages independently via parentToolUseId in _meta.
+   */
+  private isOwnSessionNotification;
   private setupEventForwarding;
   on<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
   off<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
@@ -2513,6 +3449,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
@@ -2635,6 +3572,22 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   private cosUploadService;
   /** Event listeners for provider-level events */
   private eventListeners;
+  /** 产品配置缓存（内存），用于存储 deploymentType 和 creditPurchaseActions */
+  private productConfigCache;
+  /**
+   * Plugin marketplace cache (name/id -> marketplace info)
+   * LRU 缓存，容量上限 200
+   * Key: marketplace name 或 id
+   * Value: marketplace 完整信息
+   */
+  private marketplaceCache;
+  /**
+   * Installed plugin cache (plugin name -> plugin info with install_id)
+   * LRU 缓存，容量上限 2000
+   * Key: plugin name
+   * Value: plugin 完整信息（包含 installId）
+   */
+  private pluginCache;
   constructor(options: CloudAgentProviderOptions);
   /**
    * Dispose the provider and clean up resources
@@ -2691,8 +3644,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
    *
@@ -2744,6 +3698,21 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
    * ```
    */
   rename(agentId: string, title: string): Promise<PatchConversationResponse>;
+  /**
+   * Update conversation status by ID
+   * POST {endpoint}/console/as/conversations/{agentId}
+   *
+   * @param agentId - Conversation ID to update
+   * @param status - New status for the conversation
+   * @returns PatchConversationResponse containing the updated conversation ID
+   *
+   * @example
+   * ```typescript
+   * const result = await provider.updateStatus('agent-123', 'completed');
+   * console.log('Updated conversation status:', result.id);
+   * ```
+   */
+  updateStatus(agentId: string, status: string): Promise<PatchConversationResponse>;
   /**
    * Get available models from product configuration
    *
@@ -2756,6 +3725,25 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
    * @returns Array of ModelInfo with full model details
    */
   getModels(repo?: string): Promise<ModelInfo[]>;
+  /**
+   * 获取产品部署类型（从缓存）
+   * 需要先调用 getModels() 初始化缓存
+   *
+   * @returns 部署类型：'SaaS' | 'Cloud-Hosted' | 'Self-Hosted'，默认为 'SaaS'
+   */
+  getDeploymentType(): string;
+  /**
+   * 获取 Credit 购买引导配置（从缓存）
+   * 需要先调用 getModels() 初始化缓存
+   *
+   * @returns Credit 购买引导配置，key 为错误码。如果后端未返回，则使用默认配置
+   */
+  getCreditPurchaseActions(): Record<string, {
+    labelZh: string;
+    labelEn: string;
+    url: string;
+    showButton?: boolean;
+  }>;
   /**
    * Generate a unique request ID
    */
@@ -2778,7 +3766,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,53 +3790,282 @@ 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;
+  /**
+   * 获取已安装插件列表
+   * GET /console/as/user/plugins/installed
+   */
+  getInstalledPlugins(forceRefresh?: boolean): Promise<Array<{
+    name: string;
+    marketplaceName: string;
+    status: string;
+    description?: string;
+    version?: string;
+    installScope?: 'user' | 'project';
+    installedScopes?: Array<'user' | 'project' | 'local' | 'project-local'>;
+    installId?: string;
+  }>>;
+  /**
+   * 安装插件
+   * POST /console/as/user/plugins/install
+   *
+   * @param pluginNames - 插件名称数组
+   * @param marketplaceNameOrId - 市场名称或 ID
+   */
+  installPlugins(pluginNames: string[], marketplaceNameOrId: string, installScope?: 'user' | 'project' | 'project-local', marketplaceSource?: string, workspacePath?: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * 卸载插件
+   * POST /console/as/user/plugins/installed/:id/uninstall
+   *
+   * 完整链路：
+   * CloudAgentProvider.uninstallPlugin()
+   *   -> HTTP POST /console/as/user/plugins/installed/:id/uninstall
+   *   -> agentserver: PluginInstallService.Uninstall()
+   *   -> 软删除 DB + 异步同步到活跃沙箱
+   *
+   * @param pluginName - 插件名称
+   * @param marketplaceName - 市场名称（用于标识唯一插件）
+   * @param scope - 卸载范围 ('user' | 'project' | 'project-local')
+   */
+  uninstallPlugin(pluginName: string, marketplaceName: string, scope: 'user' | 'project' | 'project-local'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * 获取插件市场列表
+   * GET /console/as/marketplace/sources
+   */
+  getPluginMarketplaces(forceRefresh?: boolean): Promise<Array<{
+    id: string;
+    name: string;
+    type: 'github' | 'local' | 'custom';
+    source: {
+      repo?: string;
+      ref?: string;
+      url?: string;
+    };
+    description?: string;
+    isBuiltin?: boolean;
+  }>>;
+  /**
+   * 获取市场下的插件列表
+   * - 有 searchText: GET /console/as/marketplace/plugins/search (跨所有市场搜索)
+   * - 无 searchText: GET /console/as/marketplace/plugins (指定市场)
+   *
+   * @param marketplaceNameOrId - 市场名称或 ID（优先使用 ID，如果是名称则从缓存查询 ID）
+   * @param forceRefresh - 是否强制刷新
+   * @param searchText - 搜索关键字（如果提供，则跨所有市场搜索）
+   */
+  getMarketplacePlugins(marketplaceNameOrId: string, forceRefresh?: boolean, searchText?: string): Promise<Array<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    iconUrl?: string;
+    tags?: string[];
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+    installedScopes?: Array<'user' | 'project'>;
+    hasUpdate?: boolean;
+    latestVersion?: string;
+    agents?: any;
+    commands?: any;
+    skills?: any;
+    mcpServers?: any;
+    hooks?: any;
+    rules?: any;
+  }>>;
+  /**
+   * 获取插件详情
+   * GET /console/as/marketplace/plugins/:name/detail
+   *
+   * @param pluginName - 插件名称
+   * @param marketplaceNameOrId - 市场名称或 ID（优先使用 ID，如果是名称则从缓存查询 ID）
+   */
+  getPluginDetail(pluginName: string, marketplaceNameOrId: string): Promise<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    iconUrl?: string;
+    tags?: string[];
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+    installedScopes?: Array<'user' | 'project'>;
+    readme?: string;
+    configSchema?: Record<string, unknown>;
+    tools?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    resources?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    prompts?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    downloadCount?: number;
+    lastUpdated?: string;
+    license?: string;
+    repositoryUrl?: string;
+  } | null>;
+  /**
+   * 添加插件市场
+   * POST /console/as/marketplace/sources
+   */
+  addPluginMarketplace(sourceUrl: string, name?: string): Promise<{
+    success: boolean;
+    error?: string;
+    marketplace?: {
+      id: string;
+      name: string;
+      type: 'github' | 'local' | 'custom';
+      source: {
+        repo?: string;
+        ref?: string;
+        url?: string;
+      };
+      description?: string;
+      isBuiltin?: boolean;
+    };
+  }>;
+  /**
+   * 删除插件市场
+   * POST /console/as/marketplace/sources/:id/delete
+   */
+  removePluginMarketplace(marketplaceNameOrId: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * 刷新插件市场
+   * POST /console/as/marketplace/sources/:id/check-updates
+   */
+  refreshPluginMarketplace(marketplaceNameOrId: string): Promise<{
+    success: boolean;
+    error?: string;
+    plugins?: Array<any>;
+  }>;
+  /**
+   * 批量切换插件启用/禁用状态
+   * POST /console/as/user/plugins/installed/:id/toggle
+   */
+  batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
+  /**
+   * 将后端插件数据映射为前端格式
+   */
+  private mapPluginData;
+  /**
+   * 从缓存中查找插件的 install_id
+   * 如果缓存未命中，则调用 API 获取并缓存
+   *
+   * @param pluginName - 插件名称
+   * @returns install_id 或 null
+   */
+  private findPluginInstallId;
+  /**
+   * 从缓存中查找 marketplace ID
+   * 如果缓存未命中，则调用 API 获取并缓存
+   */
+  private findMarketplaceId;
+  /**
+   * 提取 API 错误信息
+   * 从 AxiosError 中提取详细的错误信息，包括 HTTP 状态码、错误码和错误消息
+   */
+  private extractErrorMessage;
+  /**
+   * 映射后端 source_type 到前端类型
+   */
+  private mapSourceType;
+  /**
+   * 解析 capabilities JSON 字符串
+   */
+  private parseCapabilities;
+  /**
+   * 上报 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
 /**
- * E2B Filesystem Implementation
+ * Callback to fetch fresh sandbox connection info from backend.
+ * Called when an operation fails with 401/403.
+ */
+type ReconnectFn = () => Promise<E2BSandboxConnectionInfo>;
+/**
+ * E2B Filesystem
  *
- * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource interface.
+ * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource.
+ * When `reconnectFn` is provided, automatically reconnects on auth errors.
  *
  * @example
  * ```typescript
- * const fs = await E2BFilesystem.connect({
- *     sandboxId: 'sandbox-123',
- *     apiKey: 'e2b_xxx'
- * });
+ * // Basic usage (no auto-reconnect)
+ * const fs = await E2BFilesystem.connect({ sandboxId: '...' });
  *
- * // Read/write files
- * await fs.write('/test.txt', 'Hello World');
- * const content = await fs.read('/test.txt');
- *
- * // Watch for changes
- * const handle = await fs.watchDir('/workspace', (event) => {
- *     console.log('File changed:', event);
- * });
+ * // With auto-reconnect on token expiry
+ * const fs = await E2BFilesystem.connect({ sandboxId: '...' });
+ * fs.setReconnectFn(async () => fetchFreshConnectionInfo());
  * ```
  */
 declare class E2BFilesystem implements FilesResource {
   private sandbox;
+  private reconnectFn?;
+  /** Whether a reconnect is currently in-flight */
+  private isReconnecting;
+  /** Callers waiting for the in-flight reconnect to complete */
+  private reconnectSubscribers;
+  /** Timestamp of last reconnect attempt (anti-loop: min 10s between attempts) */
+  private lastReconnectAt;
+  private static readonly MIN_RECONNECT_INTERVAL_MS;
   constructor(sandbox: Sandbox);
   /**
    * Connect to an E2B Sandbox and create filesystem instance
    */
   static connect(info: E2BSandboxConnectionInfo): Promise<E2BFilesystem>;
+  /**
+   * Set reconnect callback. When set, auth errors trigger automatic reconnect + retry.
+   */
+  setReconnectFn(fn: ReconnectFn): void;
   /**
    * Get the underlying E2B Sandbox instance
    */
   getSandbox(): Sandbox;
+  private isAuthError;
+  private canAttemptReconnect;
+  /**
+   * Reconnect with fresh credentials.
+   * Only one reconnect in-flight at a time; concurrent callers share the result.
+   */
+  private reconnect;
+  /**
+   * Execute an operation. If reconnectFn is set and an auth error occurs,
+   * reconnect and retry once.
+   */
+  private exec;
   read(path: string, opts?: FilesystemRequestOpts & {
     format?: 'text';
   }): Promise<string>;
@@ -2991,6 +4208,7 @@ interface ActiveSessionImplOptions {
 declare class ActiveSessionImpl implements ActiveSession {
   private _id;
   private _agentId;
+  private _cwd?;
   private _availableModes?;
   private _currentMode?;
   private _availableModels?;
@@ -3002,6 +4220,7 @@ declare class ActiveSessionImpl implements ActiveSession {
   private _connectionInfo?;
   private listeners;
   private onceListeners;
+  private connectionListeners;
   /**
    * Agent operations namespace
    */
@@ -3035,6 +4254,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 +4367,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
    *
@@ -3179,6 +4406,12 @@ declare class ActiveSessionImpl implements ActiveSession {
    * Disconnect from the session/agent
    */
   disconnect(): void;
+  /**
+   * Detach the session from connection events without disconnecting the connection.
+   * This should be called when the session is being replaced but the connection is shared.
+   * Unlike disconnect(), this only removes event listeners without closing the connection.
+   */
+  detach(): void;
   /**
    * Symbol.dispose for 'using' keyword support
    * Automatically disconnects and cleans up when session goes out of scope
@@ -3193,8 +4426,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 +4518,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 +4546,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 (返回账号列表)
@@ -3397,9 +4663,21 @@ declare class BackendProvider implements IBackendProvider {
   login(): Promise<void>;
   /**
    * 登出账号
-   * Web 环境: 通过 iframe 访问登出 URL 清除 cookie
+   *
+   * 策略：
+   * - IOA 企业：用 iframe 走 SSO/SAML SLO 登出链路（涉及跨域重定向），通过轮询 iframe URL 变化检测完成
+   * - 非 IOA 企业：直接用 httpService 请求 /console/logout，速度快
    */
   logout(): Promise<void>;
+  /**
+   * IOA 企业登出：通过 iframe 走 SSO/SAML SLO 登出链路
+   * 轮询 iframe URL 变化检测完成，兜底超时 5 秒
+   */
+  private logoutViaIframe;
+  /**
+   * 非 IOA 企业登出：直接 HTTP 请求 /console/logout
+   */
+  private logoutViaHttp;
   /**
    * 批量切换插件状态
    * Web 环境不支持此功能
@@ -3410,6 +4688,48 @@ 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>;
+  /**
+   * 保存待发送的输入内容到后端
+   * API 端点: POST /api/v1/code-id
+   */
+  savePendingInput(code: string): Promise<string | null>;
+  /**
+   * 从后端加载待发送的输入内容
+   * API 端点: GET /api/v1/code?id=xxx
+   */
+  loadPendingInput(codeId: string): Promise<string | null>;
 }
 /**
  * 创建 BackendProvider 实例
@@ -3543,6 +4863,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 +4940,7 @@ type UnauthorizedCallback = () => void;
  * 特性：
  * - 单例模式，全局唯一实例，延迟初始化（首次使用时自动创建）
  * - 支持拦截器注册（其他模块可注入 header）
- * - 统一 401/403 处理
+ * - 统一 401 处理（支持自动刷新 token 并重试）
  * - 自动携带凭证（withCredentials）
  * - 类型安全
  *
@@ -3650,6 +4976,10 @@ declare class HttpService {
   private axiosInstance;
   private unauthorizedCallbacks;
   private config;
+  /** 是否正在刷新 token */
+  private isRefreshing;
+  /** 等待 token 刷新完成的请求队列 */
+  private refreshSubscribers;
   /**
    * 私有构造函数（单例模式）
    */
@@ -3667,9 +4997,17 @@ declare class HttpService {
    */
   private registerDefaultRequestInterceptor;
   /**
-   * 注册默认响应拦截器（处理 401/403）
+   * 注册默认响应拦截器（处理 401，支持自动重试）
    */
   private registerDefaultResponseInterceptor;
+  /**
+   * token 刷新成功，通知所有等待的请求
+   */
+  private onRefreshSuccess;
+  /**
+   * token 刷新失败，通知所有等待的请求
+   */
+  private onRefreshFailure;
   /**
    * 注册请求拦截器
    * @param onFulfilled 请求成功拦截器
@@ -3735,7 +5073,9 @@ declare class HttpService {
    */
   offUnauthorized(callback: UnauthorizedCallback): void;
   /**
-   * 触发所有 401 回调
+   * 触发所有 401 回调并等待完成
+   * @returns Promise，等待所有回调完成
+   * @throws 如果任何回调失败，则抛出错误
    */
   private triggerUnauthorizedCallbacks;
   /**