@tencent-ai/cloud-agent-sdk 0.2.6 → 0.2.7-next.4a35c5d.20260128

package/dist/index.d.cts

@@ -72,7 +72,7 @@ interface TasksArtifact extends BaseArtifact<'tasks'> {
 /**
  * Media content type (auxiliary classification)
  */
-type MediaContentType = 'image' | 'video' | 'document' | 'spreadsheet';
+type MediaContentType = 'image' | 'video' | 'audio' | 'document' | 'spreadsheet' | 'presentation' | 'diagram' | 'code';
 /**
  * Media Artifact - Media files
  * Supports images, videos, documents and other browser-renderable files
@@ -142,8 +142,14 @@ interface QuestionRequest {
   sessionId: string;
   /** Associated tool call ID (links extMethod to tool_call for UI) */
   toolCallId: string;
-  /** Questions to ask (1-4) */
-  questions: UserQuestion[];
+  /** Input type */
+  inputType?: string;
+  /** Schema containing questions */
+  schema?: {
+    /** Questions to ask (1-4) */questions: UserQuestion[];
+  };
+  /** Questions to ask (1-4) - legacy format */
+  questions?: UserQuestion[];
   /** Request timeout in ms */
   timeout?: number;
 }
@@ -552,6 +558,7 @@ interface Session {
 interface CreateSessionParams {
   cwd: string;
   mcpServers?: McpServerConfig[];
+  _meta?: Record<string, unknown>;
 }
 /**
  * Parameters for loading an existing session
@@ -627,6 +634,10 @@ interface ConnectionEvents extends ClientEvents {
   questionTimeout: {
     toolCallId: string;
   };
+  command: {
+    action: string;
+    params?: Record<string, unknown>;
+  };
 }
 /**
  * Event listener type
@@ -827,1906 +838,2290 @@ declare enum ModelTrustLevel {
   CERTIFIED = "certified"
 }
 //#endregion
-//#region ../agent-provider/lib/common/client/types.d.ts
+//#region ../agent-provider/lib/backend/types.d.ts
 /**
- * Session connection information
- * 包含连接到Agent会话所需的所有信息，包括sandbox连接凭证
+ * Backend Provider 类型定义
+ *
+ * 定义 IBackendProvider 接口和配置
  */
-interface SessionConnectionInfo {
-  /** Session ID */
-  sessionId: string;
-  /** Agent ID */
-  agentId: string;
-  /** Session endpoint URL (Agent的WebSocket/HTTP端点) */
-  link: string;
-  /** Session token (JWT格式的认证令牌) */
-  token: string;
-  /** Sandbox ID (E2B沙箱的唯一标识) */
-  sandboxId: string;
-  /** Session expiration timestamp (unix timestamp) */
-  expireAt: number;
-  /** Current working directory (optional) */
-  cwd?: string;
-}
 /**
- * Agent 来源类型
+ * 账号版本类型
  */
-type AgentStateType = 'local' | 'cloud';
+type Edition = 'pro' | 'personal' | 'ultimate' | 'exclusive';
 /**
- * 云端 Agent 可见性
+ * 版本展示类型（用于 UI 展示）
+ * - free: 免费版（个人版未订阅 Pro）
+ * - pro: Pro 版（个人版已订阅 Pro）
+ * - ultimate: 旗舰版（团队版）
+ * - exclusive: 专享版（企业版）
  */
-type CloudAgentVisibility = 'PRIVATE' | 'PUBLIC' | 'TEAM';
+type EditionDisplayType = 'free' | 'pro' | 'ultimate' | 'exclusive';
 /**
- * 云端 Agent 来源信息
+ * 部署状态
  */
-interface CloudAgentSourceInfo {
-  /** 提供商: github, gitlab 等 */
-  provider: string;
-  /** 分支/引用 */
-  ref: string;
-  /** 仓库路径 */
-  repository: string;
+interface DeployStatus {
+  statusCode: number;
+  statusMsg: string;
+  detailMsg: string;
 }
 /**
- * 云端 Agent 目标信息
+ * 套餐代码
  */
-interface CloudAgentTarget {
-  /** 是否自动创建 PR */
-  autoCreatePr: boolean;
-  /** 分支名称 */
-  branchName?: string;
-  /** PR URL */
-  prUrl?: string;
-  /** Agent URL */
-  url?: string;
+/**
+ *  TCACA_code_001_PqouKr6QWV CodeBuddy海外版免费包
+ * TCACA_code_002_AkiJS3ZHF5 CodeBuddy海外版Pro版本包-包月/CodeBuddy Pro Plan - Monthly:
+ * TCACA_code_006_DbXS0lrypC CodeBuddy海外版一次性免费赠送2周的Pro版本包/CodeBuddy One-time Free 2-Week Pro Plan Trial
+ * TCACA_code_007_nzdH5h4Nl0 CodeBuddy海外版运营裂变包/CodeBuddy Growth Plan
+ * TCACA_code_003_FAnt7lcmRT CodeBuddy海外版Pro版本包-包年/CodeBuddy Pro Plan - Yearly
+ * TCACA_code_008_cfWoLwvjU4 赠送月包
+ */
+declare enum CommodityCode {
+  free = "TCACA_code_001_PqouKr6QWV",
+  // free
+  proMon = "TCACA_code_002_AkiJS3ZHF5",
+  proMonPlus = "TCACA_code_005_maRGyrHhw1",
+  gift = "TCACA_code_006_DbXS0lrypC",
+  activity = "TCACA_code_007_nzdH5h4Nl0",
+  proYear = "TCACA_code_003_FAnt7lcmRT",
+  freeMon = "TCACA_code_008_cfWoLwvjU4",
+  // free
+  extra = "TCACA_code_009_0XmEQc2xOf"
 }
 /**
- * AgentState 基础接口
- * 所有类型的 AgentState 都必须实现此接口
+ * 套餐资源项（用于展示列表）
  */
-interface BaseAgentState {
-  /** Unique agent ID */
+interface PlanResource {
+  /** 资源 ID */
   id: string;
-  /** Display name */
+  /** 套餐名称（i18n key） */
+  name: string;
+  /** 套餐代码 */
+  packageCode: CommodityCode;
+  /** 是否是每日刷新的套餐 */
+  isDaily: boolean;
+  /** 总量 */
+  total: number;
+  /** 已用 */
+  used: number;
+  /** 剩余 */
+  left: number;
+  /** 到期时间戳 */
+  expireAt?: number;
+  /** 刷新时间戳 */
+  refreshAt?: number;
+}
+/**
+ * 账号套餐信息
+ */
+interface AccountPlan {
+  /** 是否是 Pro 版本 */
+  isPro: boolean;
+  isTria?: boolean;
+  /** 到期时间戳 */
+  expireAt?: number;
+  refreshAt?: number;
+  /** 自动续费标志 0-关闭 1-开启 */
+  renewFlag: 0 | 1;
+  /** 套餐代码 */
+  PackageCode?: CommodityCode;
+  /** 套餐名称 */
+  name: string;
+  usageTotal?: string;
+  usageUsed?: string;
+  usageLeft?: string;
+  /** 所有套餐资源列表 */
+  resources?: PlanResource[];
+}
+/**
+ * 账号信息
+ */
+interface Account {
+  /** 用户ID（唯一标识） */
+  uid: string;
+  /** 用户昵称 */
+  nickname: string;
+  /** 版本类型 */
+  type: Edition;
+  /** 版本展示类型（用于 UI 展示） */
+  editionType: EditionDisplayType;
+  /** 是否最后一次登录 */
+  lastLogin: boolean;
+  /** 企业ID */
+  enterpriseId?: string;
+  /** 企业名称 */
+  enterpriseName?: string;
+  /** 企业LOGO */
+  enterpriseLogo?: string;
+  /** 企业内用户名 */
+  enterpriseUserName?: string;
+  /** 插件是否启用 */
+  pluginEnabled?: boolean;
+  /** 部署状态 */
+  deployStatus?: DeployStatus;
+  /** 是否是 Pro 版本 */
+  isPro?: boolean;
+  /** 到期时间戳 */
+  expireAt?: string | number;
+  /** 刷新时间（年套餐下、本周期结束日期） */
+  refreshAt?: number;
+  /** 自动续费标志 0-关闭 1-开启 */
+  renewFlag?: 0 | 1;
+  /** 套餐代码 */
+  PackageCode?: CommodityCode;
+  /** 套餐名称 */
   name?: string;
-  /** Description */
-  description?: string;
-  /** Agent type */
-  type: AgentStateType;
-  /** Current connection status */
-  status: AgentStatus;
-  /** Agent capabilities (available after connection) */
-  capabilities?: AgentCapabilities;
-  /** When the agent was created */
-  createdAt?: Date;
-  /** When the agent was last updated */
-  updatedAt?: Date;
+  email?: string;
+  /** 套餐总用量 */
+  usageTotal?: string;
+  /** 套餐已用量 */
+  usageUsed?: string;
+  /** 套餐剩余用量 */
+  usageLeft?: string;
+  /** 所有套餐资源列表（个人用户） */
+  resources?: PlanResource[];
 }
 /**
- * LocalAgentState - 本地 Agent 状态
- * 来自本地 IPC 通信的 Agent
+ * 推理配置
  */
-interface LocalAgentState extends BaseAgentState {
-  type: 'local';
-  /** 工作目录 */
-  cwd: string;
+interface ReasoningConfig {
+  /** 推理努力程度 */
+  effort: 'low' | 'medium' | 'high';
+  /** 摘要模式 */
+  summary: 'auto' | 'always' | 'never';
 }
 /**
- * CloudAgentState - 云端 Agent 状态
- * 来自远程 API 的云端实例
+ * 模型信息
  */
-interface CloudAgentState extends BaseAgentState {
-  type: 'cloud';
+interface ModelInfo {
+  /** 模型ID */
+  id: string;
+  /** 模型名称 */
+  name: string;
+  /** 供应商 */
+  vendor: string;
+  /** 最大输出 token 数 */
+  maxOutputTokens: number;
+  /** 最大输入 token 数 */
+  maxInputTokens: number;
+  /** 是否支持工具调用 */
+  supportsToolCall: boolean;
+  /** 是否支持图像 */
+  supportsImages: boolean;
+  /** 是否禁用多模态 */
+  disabledMultimodal: boolean;
+  /** 最大允许大小 */
+  maxAllowedSize: number;
+  /** 是否支持推理 */
+  supportsReasoning: boolean;
+  /** 是否仅推理模式 */
+  onlyReasoning: boolean;
+  /** 温度参数 */
+  temperature: number;
+  /** 推理配置 */
+  reasoning: ReasoningConfig;
+  /** 英文描述 */
+  descriptionEn: string;
+  /** 中文描述 */
+  descriptionZh: string;
 }
 /**
- * AgentState - Unified agent state object exposed to client users
- *
- * This is the primary way clients access agent information.
- * Uses discriminated union pattern to distinguish between local and cloud agents.
+ * 用户连接器信息
+ */
+interface UserConnector {
+  /** 用户ID */
+  user_id: string;
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
+  displayName: string;
+  /** 连接时间 */
+  connect_at: string;
+  /** 连接状态，0未连接，1已连接 */
+  connectStatus: 0 | 1;
+  /** 勾选仓库列表，逗号分隔 */
+  repos: string;
+  /** 激活状态，0未激活，1已激活 */
+  activeStatus: 0 | 1;
+  /** 提示词 */
+  prompt: string;
+  /** 跳转URL */
+  url: string;
+  /** 描述 */
+  description: string;
+  /** OAuth Client ID */
+  oauthClientId: string;
+  /** OAuth 重定向 URL */
+  oauthRedirectUrl: string;
+}
+/**
+ * 获取用户连接器列表响应
  */
-type AgentState = LocalAgentState | CloudAgentState;
+interface ListUserConnectorResponse {
+  /** 连接器列表 */
+  connectors: UserConnector[];
+}
 /**
- * 类型守卫：判断是否为 CloudAgentState
+ * 修改用户连接器连接状态请求
  */
-declare function isCloudAgentState(state: AgentState): state is CloudAgentState;
+interface ModifyUserConnectorConnectStatusRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
+  /** 连接状态，0未连接，1已连接 */
+  connectStatus: 0 | 1;
+  /** 激活状态，0未激活，1已激活 */
+  activeStatus?: 0 | 1;
+  /** 勾选仓库列表 */
+  repos?: string[];
+}
 /**
- * Logger interface
+ * 修改用户连接器仓库请求
  */
-interface Logger {
-  debug(message: string, ...args: unknown[]): void;
-  info(message: string, ...args: unknown[]): void;
-  warn(message: string, ...args: unknown[]): void;
-  error(message: string, ...args: unknown[]): void;
+interface ModifyUserConnectorRepoRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
+  /** 仓库列表 */
+  repo?: string[];
 }
 /**
- * Filter condition for listing agents
+ * 修改用户连接器激活状态请求
  */
-interface ListAgentFilter {
-  /** Filter field name (e.g., 'status', 'name') */
-  field: string;
-  /** Filter value (comma-separated for multiple values) */
-  value: string;
+interface ModifyUserConnectorActiveStatusRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
+  /** 激活状态，0未激活，1已激活 */
+  activeStatus: 0 | 1;
 }
 /**
- * Sort options for listing agents
+ * 任务连接器信息
  */
-interface ListAgentSort {
-  /** Sort field (e.g., 'createdAt', 'status') */
-  orderBy: string;
-  /** Sort direction */
-  order?: 'asc' | 'desc';
+interface TaskConnector {
+  /** 用户ID */
+  user_id: string;
+  /** 任务ID */
+  task_id: string;
+  /** 连接器名称（唯一标识，如github/gongfeng/figma/cnb） */
+  name: string;
+  displayName: string;
+  /** 勾选仓库列表，逗号分隔 */
+  repos: string;
+  /** 激活状态：0未激活 / 1已激活 */
+  activeStatus: 0 | 1;
+  /** 创建时间 */
+  created_at: string;
+  /** 更新时间 */
+  updated_at: string;
+  /** 提示词 */
+  prompt: string;
+  /** 跳转URL */
+  url: string;
+  /** 描述 */
+  description: string;
+  /** OAuth Client ID */
+  oauthClientId?: string;
+  /** OAuth 重定向 URL */
+  oauthRedirectUrl?: string;
+  /** 连接时间 */
+  connect_at: string;
+  /** 连接状态，0未连接，1已连接 */
+  connectStatus: 0 | 1;
+}
+/**
+ * 添加任务请求
+ */
+interface AddTaskRequest {
+  /** 任务ID */
+  taskId: string;
+  /** 连接器列表 */
+  connectors?: Array<{
+    name: string;
+    repos: string;
+    activeStatus?: 0 | 1;
+  }>;
 }
 /**
- * Query options for listing agents
- *
- * These options are supported by both CloudAgentProvider and LocalAgentProvider.
- * Cloud: Server-side filtering, sorting, and pagination
- * Local: Client-side filtering and sorting, no pagination (returns all)
+ * 添加任务响应
  */
-interface ListAgentOptions {
-  /**
-   * Page number (starts from 1)
-   * Cloud: Used for API pagination
-   * Local: Ignored (returns all sessions)
-   */
-  page?: number;
-  /**
-   * Page size
-   * Cloud: Number of items per page (default 20, max 100)
-   * Local: Ignored (returns all sessions)
-   */
-  size?: number;
-  /**
-   * Sort options
-   * Cloud: Sorts results by specified field and order
-   * Local: Sorts results by specified field and order
-   */
-  sort?: ListAgentSort;
-  /**
-   * Filter conditions
-   * Cloud: Filters results by specified field values
-   * Local: Filters results by specified field values
-   */
-  filters?: ListAgentFilter[];
-  /**
-   * Day range filter (e.g., agents created in last N days)
-   * Cloud: Filters by creation date
-   * Local: Filters by creation date
-   */
-  dayRange?: number;
-  /**
-   * Title search keyword (matches agent title)
-   * Cloud: Server-side search
-   * Local: Client-side search
-   */
-  title?: string;
+interface AddTaskResponse {
+  /** 任务ID */
+  taskId: string;
 }
 /**
- * Pagination metadata returned from list operations
+ * 获取任务连接器列表响应
  */
-interface PaginationInfo {
-  /** Current page number (starts from 1) */
-  page: number;
-  /** Page size */
-  size: number;
-  /** Total number of items */
-  total: number;
-  /** Total number of pages */
-  totalPages: number;
-  /** Whether there is a next page */
-  hasNext: boolean;
-  /** Whether there is a previous page */
-  hasPrev: boolean;
+interface ListTaskConnectorResponse {
+  /** 连接器列表 */
+  connectors: TaskConnector[];
 }
 /**
- * Response from list operations that includes pagination
+ * 修改任务连接器激活状态请求
  */
-interface ListAgentResult<T = AgentState> {
-  /** List of agent states or session info */
-  agents: T[];
-  /** Pagination information */
-  pagination: PaginationInfo;
+interface ModifyTaskConnectorActiveStatusRequest {
+  /** 任务ID */
+  taskId: string;
+  /** 连接器名称 */
+  name: string;
+  /** 激活状态，0未激活，1已激活 */
+  activeStatus: 0 | 1;
 }
 /**
- * Session information (returned by list, mapped from Agent)
+ * 修改任务连接器激活状态响应
  */
-interface SessionInfo {
-  /** Session ID (from agent.session) */
-  id: string;
-  /** Associated agent ID */
-  agentId: string;
-  /** Agent name */
-  name?: string;
-  /** Agent status */
-  status: AgentStatus;
-  /** When the session/agent was created */
-  createdAt?: Date;
-  /** Last activity timestamp */
-  lastActivityAt?: Date;
-  /** Working directory (for local agents) */
-  cwd?: string;
+interface ModifyTaskConnectorActiveStatusResponse {
+  /** 任务ID */
+  taskId: string;
 }
 /**
- * Parameters for creating a new session
+ * 修改任务连接器仓库请求
  */
-interface CreateSessionParams$1 {
-  /** Working directory */
-  cwd: string;
-  /** MCP server configurations */
-  mcpServers?: McpServerConfig[];
+interface ModifyTaskConnectorRepoRequest {
+  /** 任务ID */
+  taskId: string;
+  /** 连接器名称 */
+  name: string;
+  /** 仓库列表 */
+  repo: string[];
 }
 /**
- * Parameters for loading an existing session
+ * 修改任务连接器仓库响应
  */
-interface LoadSessionParams$1 {
-  /** Session ID to load (required) */
-  sessionId: string;
-  /** Working directory */
-  cwd: string;
-  /** MCP server configurations */
-  mcpServers?: McpServerConfig[];
+interface ModifyTaskConnectorRepoResponse {
+  /** 任务ID */
+  taskId: string;
 }
 /**
- * Parameters for initializing a workspace
+ * oauth回调请求参数
  */
-interface InitializeWorkspaceParams {
-  /** Working directory */
-  cwd: string;
-  /** MCP server configurations */
-  mcpServers?: McpServerConfig[];
-  /** Whether to activate the workspace window to foreground (default true) */
-  needActivated?: boolean;
+interface SaveOauthTokenRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
+  /** 第三方回调code */
+  authorizationCode: string;
 }
 /**
- * Response for workspace initialization
+ * 获取仓库列表请求参数
  */
-interface InitializeWorkspaceResponse {
-  /** Whether initialization was successful */
-  success: boolean;
-  /** Error message (if failed) */
-  error?: string;
+interface GetRepoListRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
 }
 /**
- * Prompts resource interface (ACP verbs)
- * Operations use the current session automatically
+ * 撤销所有OAuth连接请求参数
  */
-interface PromptsResource {
-  /** Send a prompt and wait for completion */
-  send(params: PromptParams): Promise<PromptResponse>;
-  /** Stream a prompt (yields session updates) */
-  stream(params: PromptParams): AsyncIterable<SessionNotification$1>;
-  /** Cancel an ongoing prompt */
-  cancel(): Promise<void>;
+interface RevokeAllRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
+  /** 安装ID列表（可选，如果不传则撤销所有） */
+  installationIds?: string[];
 }
 /**
- * Artifacts resource interface
+ * GitHub 仓库所有者信息
  */
-interface ArtifactsResource {
-  /** List all artifacts */
-  list(params?: {
-    type?: ArtifactType;
-  }): Promise<Artifact[]>;
-  /** Get a single artifact */
-  retrieve(artifactId: string): Promise<Artifact>;
-  /** Get artifact content */
-  content(artifactId: string): Promise<string>;
+interface OauthGitHubRepoOwner {
+  login: string;
+  avatar_url: string;
+  url: string;
+  html_url: string;
+  followers_url: string;
+  starred_url: string;
+  repos_url: string;
+  events_url: string;
 }
 /**
- * Models resource interface
+ * GitHub 仓库信息
  */
-interface ModelsResource {
-  /** Get available models for a repository */
-  list(repo?: string): Promise<ModelInfo$1[]>;
+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;
 }
 /**
- * Prompt response
+ * 工蜂仓库信息
  */
-interface PromptResponse {
-  /** Stop reason */
-  stopReason: 'end_turn' | 'max_tokens' | 'tool_use' | 'cancelled' | 'error';
-  /** Response metadata */
-  _meta?: Record<string, unknown>;
+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;
 }
 /**
- * Sessions resource events for monitoring session list changes
+ * 获取仓库列表响应
  */
-interface SessionsResourceEvents {
-  /** Emitted when the sessions list changes (create, delete, update) */
-  sessionsChanged: SessionInfo[];
-  /** Emitted when a new session is created */
-  sessionCreated: SessionInfo;
-  /** Emitted when a session is deleted */
-  sessionDeleted: {
-    sessionId: string;
+interface GetRepoListResponse {
+  github_repos?: {
+    [key: string | number]: OauthGitHubRepo[];
   };
-  /** Emitted when a session is updated (status change, etc.) */
-  sessionUpdated: SessionInfo;
+  gongfeng_repos?: OauthGongfengRepo[];
 }
 /**
- * Event handler type for sessions resource events
+ * OAuth 用户信息
  */
-type SessionsResourceEventHandler<K extends keyof SessionsResourceEvents> = (data: SessionsResourceEvents[K]) => void | Promise<void>;
+interface OauthUserInfo {
+  /** 头像 URL */
+  avatarUrl: string;
+  /** 用户名 */
+  name: string;
+}
 /**
- * Session events for event subscription
+ * 获取 OAuth 用户信息请求参数
  */
-interface SessionEvents {
-  /** Emitted when session updates occur */
-  sessionUpdate: SessionNotification$1;
-  /** Emitted when an artifact is created */
-  artifactCreated: Artifact;
-  /** Emitted when an artifact is updated */
-  artifactUpdated: Artifact;
-  /** Emitted when an artifact is deleted */
-  artifactDeleted: Artifact;
-  /** Emitted when a permission request is received */
-  permissionRequest: {
-    requestId: string;
-    params: RequestPermissionRequest$1;
-  };
-  /** Emitted when a question request is received (ask_followup_question) */
-  questionRequest: {
-    toolCallId: string;
-    request: QuestionRequest;
-  };
-  /** Emitted when usage data is updated */
-  usageUpdate: UsageUpdate;
-  /** Emitted when a checkpoint is created */
-  checkpointCreated: CheckpointInfo;
-  /** Emitted when a checkpoint is updated */
-  checkpointUpdated: CheckpointInfo;
-  /** Emitted when connected to agent */
-  connected: void;
-  /** Emitted when disconnected from agent */
-  disconnected: void;
-  /** Emitted when an error occurs */
-  error: Error;
+interface GetOauthUserRequest {
+  /** 连接器名称 */
+  name: 'github' | 'gongfeng';
 }
 /**
- * Event handler type for session events
+ * 获取 OAuth 用户信息响应
  */
-type SessionEventHandler<K extends keyof SessionEvents> = (data: SessionEvents[K]) => void | Promise<void>;
+interface GetOauthUserResponse {
+  /** 用户信息 */
+  user: OauthUserInfo;
+}
 /**
- * Agent operations (accessed via session.agent)
+ * Backend Provider 配置选项
  */
-interface SessionAgentOperations {
-  /** Agent ID */
-  readonly id: string;
-  /** Agent state */
-  readonly state: AgentState;
-  /** Whether the agent is connected */
-  readonly isConnected: boolean;
-  /** Agent capabilities */
-  readonly capabilities?: AgentCapabilities;
+interface BackendProviderConfig {
+  /** API 基础 URL (例如: https://api.example.com) */
+  baseUrl: string;
+  /** 认证 Token */
+  authToken?: string;
 }
 /**
- * Active Session interface
- * Represents an active session with its resources and operations
+ * 企业用户用量信息
+ */
+interface EnterpriseUsage {
+  /** 已使用 credit */
+  credit: number;
+  /** 周期开始时间 */
+  cycleStartTime: string;
+  /** 周期结束时间 */
+  cycleEndTime: string;
+  /** 周期重置时间 */
+  cycleResetTime: string;
+  /** 限额数量 */
+  limitNum: number;
+}
+/**
+ * IBackendProvider 接口
  *
- * Key design:
- * - Session is the primary API surface
- * - agentState provides direct access to underlying agent state
- * - disconnect() is called directly on session (not session.agent)
+ * 定义与后端 API 交互的抽象接口
+ *
+ * 注意：getAgents 和 getModels 方法已废弃并移除，
+ * 请使用 IAgentAdapter 中的对应方法
  */
-interface ActiveSession {
-  /** Session ID */
-  readonly id: string;
-  /** Agent ID */
-  readonly agentId: string;
-  /** Agent state (direct access to underlying agent state) */
-  readonly agentState: AgentState;
-  /** Agent capabilities (available after connection) */
-  readonly capabilities?: AgentCapabilities;
-  /** Available session modes */
-  readonly availableModes?: SessionMode[];
-  /** Current session mode */
-  readonly currentMode?: string;
-  /** Available slash commands (updated via available_commands_update) */
-  readonly availableCommands: AvailableCommand[];
-  /** Whether the session is active */
-  readonly isActive: boolean;
+interface IBackendProvider {
   /**
-   * Session connection information (only available for cloud sessions)
-   * 会话连接信息，包括sandboxId、link、token等
+   * 获取当前账号信息
+   * @returns Promise<Account | null> 账号信息，未登录时返回 null
    */
-  readonly connectionInfo?: SessionConnectionInfo;
-  /** Agent operations */
-  readonly agent: SessionAgentOperations;
-  /** Prompts resource */
-  readonly prompts: PromptsResource;
-  /** Artifacts resource */
-  readonly artifacts: ArtifactsResource;
-  /** Files resource */
-  readonly files: FilesResource;
-  /** Resolve a permission request */
-  resolvePermission(requestId: string, optionId: string): boolean;
-  /** Reject a permission request */
-  rejectPermission(requestId: string, reason?: string): boolean;
-  /** Answer a question request with user's selections */
-  answerQuestion(toolCallId: string, answers: QuestionAnswers): boolean;
-  /** Cancel a question request */
-  cancelQuestion(toolCallId: string, reason?: string): boolean;
-  /** Callback for tool operations (skip or cancel) */
-  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
-    success: boolean;
-    error?: string;
-  }>;
-  /** Set the current session mode */
-  setMode(modeId: string): Promise<void>;
-  /** Set the current session model */
-  setSessionModel(modelId: string): Promise<void>;
-  /** Subscribe to an event */
-  on<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
-  /** Unsubscribe from an event */
-  off<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
-  /** Subscribe to an event once */
-  once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
-  /** Disconnect from the session/agent */
-  disconnect(): void;
-  /** Symbol.dispose for 'using' keyword support */
-  [Symbol.dispose](): void;
-}
-/**
- * 环境类型
- */
-type EnvironmentType = 'local' | 'cloud';
-/**
- * Agent provider interface
- *
- * Responsible for:
- * - Managing agent state/configuration storage
- * - Creating connections to agents
- * - Abstracting away transport details (cloud/local)
- *
- * The provider.connect() method returns an AgentConnection.
- * The client wraps the connection in an ActiveSession instance.
- *
- * @typeParam C - Connection type used by this provider (e.g., CloudAgentConnection, LocalAgentConnection)
- */
-interface AgentProvider<C extends AgentConnection = AgentConnection> {
+  getAccount(): Promise<Account | null>;
   /**
-   * Create a new agent and return its ID
-   *
-   * @param params - Optional session params (used by LocalAgentProvider to get cwd)
-   * @returns Agent ID (Cloud: UUID, Local: cwd)
+   * 获取用户连接器列表
+   * @returns Promise<ListUserConnectorResponse | null> 用户连接器列表，失败时返回 null
    */
-  create?(params?: CreateSessionParams$1): Promise<string>;
-  /** Get agent state by ID */
-  get(agentId: string): Promise<AgentState | undefined>;
+  getUserConnector(): Promise<ListUserConnectorResponse>;
   /**
-   * List all agent states with pagination information
-   *
-   * @param options - Optional query parameters for filtering, sorting, and pagination
-   *                  Cloud providers use these for API queries and return server pagination
-   *                  Local providers apply client-side filtering and return synthetic pagination
-   * @returns Object containing agents array and pagination info
+   * 修改用户连接器连接状态
+   * @param request 请求参数
+   * @returns Promise<void>
    */
-  list(options?: ListAgentOptions): Promise<ListAgentResult<AgentState>>;
-  /** Connect to an agent and return the connection */
-  connect(agentId: string): Promise<C>;
-  /** Delete an agent by ID */
-  delete(agentId: string): Promise<boolean>;
+  modifyUserConnectorConnectStatus(request: ModifyUserConnectorConnectStatusRequest): Promise<void>;
   /**
-   * Archive an agent by ID (optional)
-   * Used by CloudAgentProvider for archiving agents
-   *
-   * @param agentId - Agent ID to archive
-   * @returns Object containing the archived agent ID
+   * 修改用户连接器仓库
+   * @param request 请求参数
+   * @returns Promise<void>
    */
-  archive?(agentId: string): Promise<{
-    id: string;
-  }>;
+  modifyUserConnectorRepo(request: ModifyUserConnectorRepoRequest): Promise<void>;
   /**
-   * Rename an agent by ID (optional)
-   * Used by CloudAgentProvider and LocalAgentProvider for renaming agents
-   *
-   * @param agentId - Agent ID to rename
-   * @param title - New title for the agent
-   * @returns Object containing the renamed agent ID
+   * 修改用户连接器激活状态
+   * @param request 请求参数
+   * @returns Promise<void>
    */
-  rename?(agentId: string, title: string): Promise<{
-    id: string;
-  }>;
-  /** Filesystem provider (optional - some providers may not support filesystem operations) */
-  readonly filesystem?: FilesystemProvider;
+  modifyUserConnectorActiveStatus(request: ModifyUserConnectorActiveStatusRequest): Promise<void>;
   /**
-   * Get available models for a repository (optional)
-   * Implementation varies by provider type
-   * @param repo - Repository identifier
-   * @returns Array of model information
+   * 删除用户连接器
+   * @param name 连接器名称
+   * @returns Promise<void>
    */
-  getModels?(repo?: string): Promise<ModelInfo$1[]>;
+  deleteUserConnector(name: 'github' | 'gongfeng'): Promise<void>;
   /**
-   * Register sessionId → agentId mapping (optional, used by LocalAgentProvider)
-   * Called after session creation to maintain the mapping for loadSession
-   *
-   * @param sessionId - Session ID returned by connection.createSession()
-   * @param agentId - Agent ID (cwd for Local)
+   * 添加任务
+   * @param request 请求参数
+   * @returns Promise<AddTaskResponse>
    */
-  registerSession?(sessionId: string, agentId: string): void;
+  addConnectorTask(request: AddTaskRequest): Promise<AddTaskResponse>;
   /**
-   * Open a workspace window (optional, used by LocalAgentProvider)
-   *
-   * @param params - Workspace params including cwd
-   * @returns Response with success status
+   * 获取任务连接器列表
+   * @param taskId 任务ID
+   * @returns Promise<ListTaskConnectorResponse>
    */
-  openWorkspace?(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  getTaskConnector(taskId: string): Promise<ListTaskConnectorResponse>;
   /**
-   * Pick files from file dialog (optional, used by LocalAgentProvider)
-   *
-   * @param params - File picker params including filters
-   * @returns Response with file paths and cancel status
+   * 修改任务连接器激活状态
+   * @param request 请求参数
+   * @returns Promise<ModifyTaskConnectorActiveStatusResponse>
    */
-  pickFile?(params?: PickFileParams): Promise<PickFileResponse>;
+  modifyTaskConnectorActiveStatus(request: ModifyTaskConnectorActiveStatusRequest): Promise<ModifyTaskConnectorActiveStatusResponse>;
   /**
-   * Pick folders from folder dialog (optional, used by LocalAgentProvider)
-   *
-   * @param params - Folder picker params
-   * @returns Response with folder paths and cancel status
+   * 修改任务连接器仓库
+   * @param request 请求参数
+   * @returns Promise<ModifyTaskConnectorRepoResponse>
    */
-  pickFolder?(params?: PickFolderParams): Promise<PickFolderResponse>;
+  modifyTaskConnectorRepo(request: ModifyTaskConnectorRepoRequest): Promise<ModifyTaskConnectorRepoResponse>;
   /**
-   * Upload a file to cloud storage (optional)
-   *
-   * @param params - Upload parameters including file content
-   * @returns Response with cloud URL after successful upload
+   * oauth回调，后端用第三方的code换token的
    */
-  uploadFile?(params: UploadFileParams): Promise<UploadFileResponse>;
+  saveOauthToken(request: SaveOauthTokenRequest): Promise<void>;
   /**
-   * Search for files in the workspace (optional, used by LocalAgentProvider)
-   *
-   * @param params - Search parameters including options
-   * @returns Response with search results
+   * 获取OAuth连接器的仓库列表
+   * @param request 请求参数
+   * @returns Promise<GetRepoListResponse> 仓库列表响应
    */
-  searchFile?(params: SearchFileParams): Promise<SearchFileResponse>;
+  getRepoList(request: GetRepoListRequest): Promise<GetRepoListResponse>;
   /**
-   * Register an event listener
-   * Provider implementations should forward events to the underlying transport
-   *
-   * @param event - Event name
-   * @param handler - Event handler function
+   * 撤销OAuth连接器的所有连接
+   * @param request 请求参数
+   * @returns Promise<void>
    */
-  on?(event: string, handler: (...args: any[]) => void): void;
+  revokeAll(request: RevokeAllRequest): Promise<void>;
   /**
-   * Unregister an event listener
-   *
-   * @param event - Event name
-   * @param handler - Event handler function to remove
+   * 获取 OAuth 用户信息
+   * @param request 请求参数
+   * @returns Promise<GetOauthUserResponse> 用户信息响应
    */
-  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;
+  getOauthUser(request: GetOauthUserRequest): Promise<GetOauthUserResponse>;
   /**
-   * 运行环境类型
-   * - 'local': IDE 本地环境
-   * - 'cloud': 云端环境
+   * 触发登录流程
+   * - Web 环境: 跳转到登录页面
+   * - IDE 环境: 通过 IPC 通知 IDE 打开登录流程
    */
-  environmentType?: EnvironmentType;
-}
-/**
- * Client sessions resource interface
- * Top-level API for session management
- *
- * Key design:
- * - list() returns sessions with pagination info (mapped from agents)
- * - create() creates a new session (auto-creates agent and connects)
- * - load() loads an existing session (finds agent by sessionId and connects)
- * - archive() archives a session/agent
- * - initializeWorkspace() initializes a workspace for future sessions
- */
-interface ClientSessionsResource {
+  login(): Promise<void>;
   /**
-   * List all sessions with pagination info
-   * Cloud: Returns server-side filtered/sorted/paginated results
-   * Local: Returns client-side filtered/sorted results (synthetic pagination)
+   * 登出账号
    */
-  list(options?: ListAgentOptions): Promise<ListAgentResult<SessionInfo>>;
-  /** Create a new session (auto-creates agent and connects) */
-  create(params: CreateSessionParams$1): Promise<ActiveSession>;
-  /** Load an existing session (finds agent by sessionId and connects) */
-  load(params: LoadSessionParams$1): Promise<ActiveSession>;
+  logout(): Promise<void>;
   /**
-   * Archive a session/agent
-   * @param sessionId - Session ID to archive
-   * @returns Object containing the archived session ID
+   * 重新加载窗口（可选，仅 IPC 环境支持）
+   * @param params 可选参数，如 locale
    */
-  archive(sessionId: string): Promise<{
-    id: string;
-  }>;
+  reloadWindow?(params?: {
+    locale?: string;
+  }): Promise<void>;
   /**
-   * Rename a session/agent
-   * @param sessionId - Session ID to rename
-   * @param title - New title for the session
-   * @returns Object containing the renamed session ID
+   * 监听事件（可选，用于 IPC 环境）
+   * @param event 事件名称
+   * @param callback 回调函数
+   * @returns 取消订阅函数
    */
-  rename(sessionId: string, title: string): Promise<{
-    id: string;
-  }>;
-  /** Initialize a workspace for future sessions */
-  initializeWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
-  /** Models resource for getting available models */
-  readonly models: ModelsResource;
-  /** Get current workspaces list */
-  getCurrentWorkspaces(filter?: {
-    activeOnly?: boolean;
-  }): Promise<WorkspaceInfo[]>;
-  /** Subscribe to sessions resource events */
-  on<K extends keyof SessionsResourceEvents>(event: K, handler: SessionsResourceEventHandler<K>): void;
-  /** Unsubscribe from sessions resource events */
-  off<K extends keyof SessionsResourceEvents>(event: K, handler: SessionsResourceEventHandler<K>): void;
-  /** Open a workspace (for LocalAgentProvider) */
-  openWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
-  /** Pick files from file dialog (for LocalAgentProvider) */
-  pickFile(params?: PickFileParams): Promise<PickFileResponse>;
-  /** Pick folders from folder dialog (for LocalAgentProvider) */
-  pickFolder(params?: PickFolderParams): Promise<PickFolderResponse>;
-  /** Upload a file to cloud storage */
-  uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
-  /** Search for files in the workspace (for LocalAgentProvider) */
-  searchFile(params: SearchFileParams): Promise<SearchFileResponse>;
+  on?(event: string, callback: (data?: unknown) => void): () => void;
+  /** 获取企业用户用量信息
+   * @param enterpriseId 企业 ID
+   * @returns Promise<EnterpriseUsage | null> 企业用户用量信息
+   */
+  getEnterpriseUsage?(enterpriseId: string): Promise<EnterpriseUsage | null>;
 }
 /**
- * Workspace information (aligned with FolderSelectResult)
+ * 插件作用域
  */
-interface WorkspaceInfo {
-  /** Folder path */
-  path: string;
-  /** Folder display name */
-  label: string;
-}
+type PluginScope = 'user' | 'project';
 /**
- * File filter for pickFile dialog
+ * 插件操作类型
  */
-interface FileFilter {
-  /** Display name for the filter */
-  readonly name: string;
-  /** File extensions (without dot) */
-  readonly extensions: string[];
-}
+type PluginOperation = 'enable' | 'disable';
 /**
- * Parameters for picking files
+ * 批量插件操作项
  */
-interface PickFileParams {
-  /** Default path for the dialog */
-  readonly defaultPath?: string;
-  /** File type filters */
-  readonly filters?: FileFilter[];
-  /** Whether to allow multiple selection (default false) */
-  readonly canSelectMany?: boolean;
+interface BatchPluginOperationItem {
+  /** 插件名称 */
+  readonly pluginName: string;
+  /** 市场名称 */
+  readonly marketplaceName: string;
+  /** 作用域 */
+  readonly scope: PluginScope;
+  /** 操作类型 */
+  readonly operation: PluginOperation;
 }
 /**
- * Response from picking files
+ * 批量插件操作请求
  */
-interface PickFileResponse {
-  /** Selected files - File objects in browser, absolute path strings in IDE */
-  readonly files: Array<File | string>;
-  /** Whether user cancelled the dialog */
-  readonly canceled: boolean;
-  /** Error message (if failed) */
-  readonly error?: string;
+interface BatchPluginOperationRequest {
+  /** 操作项列表 */
+  readonly items: BatchPluginOperationItem[];
 }
 /**
- * Parameters for picking folders
+ * 批量插件操作失败项
  */
-interface PickFolderParams {
-  /** Default path for the dialog */
-  readonly defaultPath?: string;
+interface BatchPluginOperationFailedItem extends BatchPluginOperationItem {
+  /** 错误信息 */
+  readonly error: string;
 }
 /**
- * Response from picking folders
+ * 批量插件操作结果
  */
-interface PickFolderResponse {
-  /** Selected folder paths */
-  readonly folderPaths: string[];
-  /** Whether user cancelled the dialog */
-  readonly canceled: boolean;
-  /** Error message (if failed) */
-  readonly error?: string;
+interface BatchPluginOperationResult {
+  /** 是否全部成功 */
+  readonly success: boolean;
+  /** 成功的插件列表 */
+  readonly succeededPlugins: BatchPluginOperationItem[];
+  /** 失败的插件列表 */
+  readonly failedPlugins: BatchPluginOperationFailedItem[];
 }
+//#endregion
+//#region ../agent-provider/lib/common/client/types.d.ts
 /**
- * Parameters for uploading files
+ * Session connection information
+ * 包含连接到Agent会话所需的所有信息，包括sandbox连接凭证
  */
-interface UploadFileParams {
-  /** Files to upload - File objects in browser, absolute path strings in IDE */
-  readonly files: Array<File | string>;
+interface SessionConnectionInfo {
+  /** Session ID */
+  sessionId: string;
+  /** Agent ID */
+  agentId: string;
+  /** Session endpoint URL (Agent的WebSocket/HTTP端点) */
+  link: string;
+  /** Session token (JWT格式的认证令牌) */
+  token: string;
+  /** Sandbox ID (E2B沙箱的唯一标识) */
+  sandboxId: string;
+  /** Session expiration timestamp (unix timestamp) */
+  expireAt: number;
+  /** Current working directory (optional) */
+  cwd?: string;
 }
 /**
- * Response from uploading files
+ * Agent 来源类型
  */
-interface UploadFileResponse {
-  /** Whether upload was successful */
-  readonly success: boolean;
-  /** Cloud URLs corresponding to each uploaded file (same order as input files) */
-  readonly urls?: string[];
-  /** URL expiration time in seconds (from backend) */
-  readonly expireSeconds?: number;
-  /** Error message (if upload failed) */
-  readonly error?: string;
+type AgentStateType = 'local' | 'cloud';
+/**
+ * 云端 Agent 可见性
+ */
+type CloudAgentVisibility = 'PRIVATE' | 'PUBLIC' | 'TEAM';
+/**
+ * 云端 Agent 来源信息
+ */
+interface CloudAgentSourceInfo {
+  /** 提供商: github, gitlab 等 */
+  provider: string;
+  /** 分支/引用 */
+  ref: string;
+  /** 仓库路径 */
+  repository: string;
 }
 /**
- * Mention type for file/folder
+ * 云端 Agent 目标信息
  */
-declare enum MentionType {
-  file = "file",
-  folder = "folder"
+interface CloudAgentTarget {
+  /** 是否自动创建 PR */
+  autoCreatePr: boolean;
+  /** 分支名称 */
+  branchName?: string;
+  /** PR URL */
+  prUrl?: string;
+  /** Agent URL */
+  url?: string;
 }
 /**
- * Search options for file search
+ * AgentState 基础接口
+ * 所有类型的 AgentState 都必须实现此接口
  */
-interface SearchOptions {
-  /** Search keyword */
-  readonly search?: string;
-  /** Number of results to return */
-  readonly resultNum: number;
+interface BaseAgentState {
+  /** Unique agent ID */
+  id: string;
+  /** Display name */
+  name?: string;
+  /** Description */
+  description?: string;
+  /** Agent type */
+  type: AgentStateType;
+  /** Current connection status */
+  status: AgentStatus;
+  /** Agent capabilities (available after connection) */
+  capabilities?: AgentCapabilities;
+  /** When the agent was created */
+  createdAt?: Date;
+  /** When the agent was last updated */
+  updatedAt?: Date;
 }
 /**
- * File search result
+ * LocalAgentState - 本地 Agent 状态
+ * 来自本地 IPC 通信的 Agent
  */
-interface SearchFileResult {
-  /** Full path */
-  path: string;
-  /** Relative path */
-  relativePath: string;
-  /** File name */
-  fileName?: string;
-  /** Folder name */
-  folderName?: string;
-  /** Type (file or folder) */
-  type: MentionType.file | MentionType.folder;
+interface LocalAgentState extends BaseAgentState {
+  type: 'local';
+  /** 工作目录 */
+  cwd: string;
 }
 /**
- * Parameters for searching files
+ * CloudAgentState - 云端 Agent 状态
+ * 来自远程 API 的云端实例
  */
-interface SearchFileParams {
-  /** Search options */
-  readonly options: SearchOptions;
-  /** Search path*/
-  readonly cwd?: string;
+interface CloudAgentState extends BaseAgentState {
+  type: 'cloud';
 }
 /**
- * Response from searching files
+ * AgentState - Unified agent state object exposed to client users
+ *
+ * This is the primary way clients access agent information.
+ * Uses discriminated union pattern to distinguish between local and cloud agents.
  */
-interface SearchFileResponse {
-  /** Search results */
-  readonly results: SearchFileResult[];
-  /** Error message (if failed) */
-  readonly error?: string;
+type AgentState = LocalAgentState | CloudAgentState;
+/**
+ * 类型守卫：判断是否为 CloudAgentState
+ */
+declare function isCloudAgentState(state: AgentState): state is CloudAgentState;
+/**
+ * Logger interface
+ */
+interface Logger {
+  debug(message: string, ...args: unknown[]): void;
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
 }
-//#endregion
-//#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
 /**
- * Cloud Agent Connection implementation
- * Uses Streamable HTTP transport to connect to cloud-hosted ACP agents
- * Uses composition pattern - implements event emitter methods internally
+ * Filter condition for listing agents
+ */
+interface ListAgentFilter {
+  /** Filter field name (e.g., 'status', 'name') */
+  field: string;
+  /** Filter value (comma-separated for multiple values) */
+  value: string;
+}
+/**
+ * Sort options for listing agents
+ */
+interface ListAgentSort {
+  /** Sort field (e.g., 'createdAt', 'status') */
+  orderBy: string;
+  /** Sort direction */
+  order?: 'asc' | 'desc';
+}
+/**
+ * Query options for listing agents
  *
- * TODO: Connection Lifecycle Responsibilities
- * CloudAgentProvider caches connections by endpoint link. This class needs to:
- * - Implement connection health checks (detect and handle connection failures/reconnection)
- * - Handle token expiration (refresh or re-authentication when tokens expire)
- * - Emit 'disconnected' event when connection becomes unhealthy so provider can clean up cache
+ * These options are supported by both CloudAgentProvider and LocalAgentProvider.
+ * Cloud: Server-side filtering, sorting, and pagination
+ * Local: Client-side filtering and sorting, no pagination (returns all)
  */
-declare class CloudAgentConnection implements AgentConnection {
-  private client;
-  private listeners;
-  private onceListeners;
+interface ListAgentOptions {
   /**
-   * Flag to suppress sessionUpdate event emission during streaming.
-   * When true, onSessionUpdate callback won't emit to avoid duplicate messages with promptStream.
+   * Page number (starts from 1)
+   * Cloud: Used for API pagination
+   * Local: Ignored (returns all sessions)
    */
-  private _isStreaming;
+  page?: number;
   /**
-   * Session connection information (sandboxId, link, token, etc.)
-   * Set by CloudAgentProvider.connect() after fetching session data from backend.
+   * Page size
+   * Cloud: Number of items per page (default 20, max 100)
+   * Local: Ignored (returns all sessions)
    */
-  private _sessionConnectionInfo?;
-  readonly agentId: string;
-  readonly transport: "cloud";
-  readonly cwd: string;
-  constructor(agentId: string, config: CloudConnectionConfig, cwd?: string);
-  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;
-  once<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
-  emit<K extends keyof ConnectionEvents>(event: K, data: ConnectionEvents[K]): boolean;
-  removeAllListeners<K extends keyof ConnectionEvents>(event?: K): this;
-  get state(): AgentStatus;
-  get isInitialized(): boolean;
-  get capabilities(): AgentCapabilities | undefined;
-  get initializeResult(): InitializeResponse | undefined;
-  connect(): Promise<InitializeResponse>;
-  disconnect(): Promise<void>;
-  createSession(params: CreateSessionParams): Promise<NewSessionResponse>;
-  loadSession(params: LoadSessionParams): Promise<LoadSessionResponse>;
-  setSessionMode(sessionId: string, modeId: string): Promise<SetSessionModeResponse>;
-  setSessionModel(sessionId: string, modelId: string): Promise<SetSessionModelResponse>;
-  prompt(sessionId: string, params: PromptParams): Promise<PromptResponse$1>;
-  promptStream(sessionId: string, params: PromptParams): AsyncIterable<SessionNotification>;
-  cancel(sessionId: string): Promise<void>;
-  resolvePermission(requestId: string, optionId: string): boolean;
-  rejectPermission(requestId: string, reason?: string): boolean;
-  getPendingPermissions(): Map<string, {
-    params: RequestPermissionRequest;
-    createdAt: number;
-  }>;
-  hasPendingPermissions(): boolean;
-  answerQuestion(toolCallId: string, answers: QuestionAnswers): boolean;
-  cancelQuestion(toolCallId: string, reason?: string): boolean;
-  getPendingQuestions(): Map<string, {
-    request: QuestionRequest;
-    createdAt: number;
-  }>;
-  hasPendingQuestions(): boolean;
-  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
-    success: boolean;
-    error?: string;
-  }>;
+  size?: number;
   /**
-   * Set session connection information
-   * Called by CloudAgentProvider.connect() after fetching session data from backend.
+   * Sort options
+   * Cloud: Sorts results by specified field and order
+   * Local: Sorts results by specified field and order
    */
-  setSessionConnectionInfo(info: SessionConnectionInfo): void;
+  sort?: ListAgentSort;
   /**
-   * Get session connection information
-   * Contains sandboxId, link, token, etc.
+   * Filter conditions
+   * Cloud: Filters results by specified field values
+   * Local: Filters results by specified field values
    */
-  get sessionConnectionInfo(): SessionConnectionInfo | undefined;
-  extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+  filters?: ListAgentFilter[];
+  /**
+   * Day range filter (e.g., agents created in last N days)
+   * Cloud: Filters by creation date
+   * Local: Filters by creation date
+   */
+  dayRange?: number;
+  /**
+   * Title search keyword (matches agent title)
+   * Cloud: Server-side search
+   * Local: Client-side search
+   */
+  title?: string;
 }
-//#endregion
-//#region ../agent-provider/lib/common/providers/cloud-agent-provider/api-types.d.ts
 /**
- * Response for archive agent
- * POST /v2/cloudagent/agentmgmt/agents/{id}/archive
+ * Pagination metadata returned from list operations
  */
-interface ArchiveAgentResponse {
-  /** Agent ID */
-  id: string;
+interface PaginationInfo {
+  /** Current page number (starts from 1) */
+  page: number;
+  /** Page size */
+  size: number;
+  /** Total number of items */
+  total: number;
+  /** Total number of pages */
+  totalPages: number;
+  /** Whether there is a next page */
+  hasNext: boolean;
+  /** Whether there is a previous page */
+  hasPrev: boolean;
 }
 /**
- * Response for rename agent
- * PATCH /v2/cloudagent/agentmgmt/agents/{id}
+ * Response from list operations that includes pagination
  */
-interface RenameAgentResponse {
-  /** Agent ID */
+interface ListAgentResult<T = AgentState> {
+  /** List of agent states or session info */
+  agents: T[];
+  /** Pagination information */
+  pagination: PaginationInfo;
+}
+/**
+ * Session information (returned by list, mapped from Agent)
+ */
+interface SessionInfo {
+  /** Session ID (from agent.session) */
   id: string;
+  /** Associated agent ID */
+  agentId: string;
+  /** Agent name */
+  name?: string;
+  /** Agent status */
+  status: AgentStatus;
+  /** When the session/agent was created */
+  createdAt?: Date;
+  /** Last activity timestamp */
+  lastActivityAt?: Date;
+  /** Working directory (for local agents) */
+  cwd?: string;
+  /** Whether the session is a playground */
+  isPlayground?: boolean;
 }
-//#endregion
-//#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-provider.d.ts
 /**
- * Configuration for CloudAgentProvider
+ * Parameters for creating a new session
  */
-interface CloudAgentProviderOptions {
-  /** Base endpoint URL for agent management API (e.g., 'https://api.example.com') */
-  endpoint: string;
-  /** Authorization token */
-  authToken?: string;
-  /** Custom headers */
-  headers?: Record<string, string>;
-  /** Logger instance */
-  logger?: Logger;
-  /** Custom fetch implementation */
-  fetch?: typeof fetch;
-  /** Client capabilities (sent during agent initialization) */
-  clientCapabilities?: ClientCapabilities$1;
+interface CreateSessionParams$1 {
+  /** Working directory */
+  cwd: string;
+  /** MCP server configurations */
+  mcpServers?: McpServerConfig[];
+  _meta?: Record<string, unknown>;
 }
 /**
- * CloudAgentProvider - Manages cloud-hosted agents via REST API
- *
- * API Endpoints:
- * - POST   {endpoint}/console/cloudagent/agentmgmt/agents             - Create new agent
- * - GET    {endpoint}/console/cloudagent/agentmgmt/agents/{id}       - Get agent data
- * - GET    {endpoint}/console/cloudagent/agentmgmt/agents            - List all agents
- * - POST   {endpoint}/console/cloudagent/agentmgmt/agents/{id}/delete - Delete agent
- * - GET    {endpoint}/console/cloudagent/agentmgmt/agents/{id}/session - Get agent session (includes sandboxId)
- * - GET    {endpoint}/console/cloudagent/agentmgmt/models             - Get available models
- *
- * The provider stores agent endpoint configurations in the cloud backend.
- * When connect() is called, it creates a CloudAgentConnection to the agent's
- * endpoint and returns an Agent instance.
- *
- * @example
- * ```typescript
- * const provider = new CloudAgentProvider({
- *     endpoint: 'https://staging-copilot.tencent.com',
- *     authToken: 'token'
- * });
- *
- * // List all agents (uses default pagination and sorting)
- * const allAgents = await provider.list();
- *
- * // List agents with custom pagination
- * const page2 = await provider.list({
- *     page: 2,
- *     size: 50
- * });
- *
- * // List agents with filtering
- * const runningAgents = await provider.list({
- *     filters: [
- *         { field: 'status', value: 'running' }
- *     ]
- * });
- *
- * // List agents with custom sorting
- * const sortedAgents = await provider.list({
- *     sort: {
- *         orderBy: 'createdAt',
- *         order: 'desc'
- *     }
- * });
- *
- * // List agents created in last 14 days with multiple filters
- * const recentAgents = await provider.list({
- *     dayRange: 14,
- *     filters: [
- *         { field: 'status', value: 'running,stopped' }
- *     ],
- *     page: 1,
- *     size: 20
- * });
+ * Parameters for loading an existing session
+ */
+interface LoadSessionParams$1 {
+  /** Session ID to load (required) */
+  sessionId: string;
+  /** Working directory */
+  cwd: string;
+  /** MCP server configurations */
+  mcpServers?: McpServerConfig[];
+}
+/**
+ * Parameters for initializing a workspace
+ */
+interface InitializeWorkspaceParams {
+  /** Working directory */
+  cwd: string;
+  /** MCP server configurations */
+  mcpServers?: McpServerConfig[];
+  /** Whether to activate the workspace window to foreground (default true) */
+  needActivated?: boolean;
+}
+/**
+ * Response for workspace initialization
+ */
+interface InitializeWorkspaceResponse {
+  /** Whether initialization was successful */
+  success: boolean;
+  /** Error message (if failed) */
+  error?: string;
+}
+/**
+ * Prompts resource interface (ACP verbs)
+ * Operations use the current session automatically
+ */
+interface PromptsResource {
+  /** Send a prompt and wait for completion */
+  send(params: PromptParams): Promise<PromptResponse>;
+  /** Stream a prompt (yields session updates) */
+  stream(params: PromptParams): AsyncIterable<SessionNotification$1>;
+  /** Cancel an ongoing prompt */
+  cancel(): Promise<void>;
+}
+/**
+ * Artifacts resource interface
+ */
+interface ArtifactsResource {
+  /** List all artifacts */
+  list(params?: {
+    type?: ArtifactType;
+  }): Promise<Artifact[]>;
+  /** Get a single artifact */
+  retrieve(artifactId: string): Promise<Artifact>;
+  /** Get artifact content */
+  content(artifactId: string): Promise<string>;
+}
+/**
+ * Models resource interface
+ */
+interface ModelsResource {
+  /** Get available models for a repository */
+  list(repo?: string): Promise<ModelInfo$1[]>;
+}
+/**
+ * Prompt response
+ */
+interface PromptResponse {
+  /** Stop reason */
+  stopReason: 'end_turn' | 'max_tokens' | 'tool_use' | 'cancelled' | 'error';
+  /** Response metadata */
+  _meta?: Record<string, unknown>;
+}
+/**
+ * Sessions resource events for monitoring session list changes
+ */
+interface SessionsResourceEvents {
+  /** Emitted when the sessions list changes (create, delete, update) */
+  sessionsChanged: SessionInfo[];
+  /** Emitted when a new session is created */
+  sessionCreated: SessionInfo;
+  /** Emitted when a session is deleted */
+  sessionDeleted: {
+    sessionId: string;
+  };
+  /** Emitted when a session is updated (status change, etc.) */
+  sessionUpdated: SessionInfo;
+}
+/**
+ * Event handler type for sessions resource events
+ */
+type SessionsResourceEventHandler<K extends keyof SessionsResourceEvents> = (data: SessionsResourceEvents[K]) => void | Promise<void>;
+/**
+ * Session events for event subscription
+ */
+interface SessionEvents {
+  /** Emitted when session updates occur */
+  sessionUpdate: SessionNotification$1;
+  /** Emitted when an artifact is created */
+  artifactCreated: Artifact;
+  /** Emitted when an artifact is updated */
+  artifactUpdated: Artifact;
+  /** Emitted when an artifact is deleted */
+  artifactDeleted: Artifact;
+  /** Emitted when a permission request is received */
+  permissionRequest: {
+    requestId: string;
+    params: RequestPermissionRequest$1;
+  };
+  /** Emitted when a question request is received (ask_followup_question) */
+  questionRequest: {
+    toolCallId: string;
+    request: QuestionRequest;
+  };
+  /** Emitted when usage data is updated */
+  usageUpdate: UsageUpdate;
+  /** Emitted when a checkpoint is created */
+  checkpointCreated: CheckpointInfo;
+  /** Emitted when a checkpoint is updated */
+  checkpointUpdated: CheckpointInfo;
+  /** Emitted when a command is received */
+  command: {
+    action: string;
+    params?: Record<string, unknown>;
+  };
+  /** Emitted when connected to agent */
+  connected: void;
+  /** Emitted when disconnected from agent */
+  disconnected: void;
+  /** Emitted when an error occurs */
+  error: Error;
+}
+/**
+ * Event handler type for session events
+ */
+type SessionEventHandler<K extends keyof SessionEvents> = (data: SessionEvents[K]) => void | Promise<void>;
+/**
+ * Agent operations (accessed via session.agent)
+ */
+interface SessionAgentOperations {
+  /** Agent ID */
+  readonly id: string;
+  /** Agent state */
+  readonly state: AgentState;
+  /** Whether the agent is connected */
+  readonly isConnected: boolean;
+  /** Agent capabilities */
+  readonly capabilities?: AgentCapabilities;
+}
+/**
+ * Active Session interface
+ * Represents an active session with its resources and operations
  *
- * // Get agent state
- * const state = await provider.get('agent-id');
+ * Key design:
+ * - Session is the primary API surface
+ * - agentState provides direct access to underlying agent state
+ * - disconnect() is called directly on session (not session.agent)
+ */
+interface ActiveSession {
+  /** Session ID */
+  readonly id: string;
+  /** Agent ID */
+  readonly agentId: string;
+  /** Agent state (direct access to underlying agent state) */
+  readonly agentState: AgentState;
+  /** Agent capabilities (available after connection) */
+  readonly capabilities?: AgentCapabilities;
+  /** Available session modes */
+  readonly availableModes?: SessionMode[];
+  /** Current session mode */
+  readonly currentMode?: string;
+  /** Available slash commands (updated via available_commands_update) */
+  readonly availableCommands: AvailableCommand[];
+  /** Whether the session is active */
+  readonly isActive: boolean;
+  /**
+   * Session connection information (only available for cloud sessions)
+   * 会话连接信息，包括sandboxId、link、token等
+   */
+  readonly connectionInfo?: SessionConnectionInfo;
+  /** Agent operations */
+  readonly agent: SessionAgentOperations;
+  /** Prompts resource */
+  readonly prompts: PromptsResource;
+  /** Artifacts resource */
+  readonly artifacts: ArtifactsResource;
+  /** Files resource */
+  readonly files: FilesResource;
+  /** Resolve a permission request */
+  resolvePermission(requestId: string, optionId: string): boolean;
+  /** Reject a permission request */
+  rejectPermission(requestId: string, reason?: string): boolean;
+  /** Answer a question request with user's selections */
+  answerQuestion(toolCallId: string, answers: QuestionAnswers): boolean;
+  /** Cancel a question request */
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  /** Callback for tool operations (skip or cancel) */
+  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Set the current session mode */
+  setMode(modeId: string): Promise<void>;
+  /** Set the current session model */
+  setSessionModel(modelId: string): Promise<void>;
+  /** Set available commands (called when available_commands_update is received) */
+  setAvailableCommands(commands: AvailableCommand[]): void;
+  /** Subscribe to an event */
+  on<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /** Unsubscribe from an event */
+  off<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /** Subscribe to an event once */
+  once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /** Disconnect from the session/agent */
+  disconnect(): void;
+  /** Symbol.dispose for 'using' keyword support */
+  [Symbol.dispose](): void;
+}
+/**
+ * 环境类型
+ */
+type EnvironmentType = 'local' | 'cloud';
+/**
+ * Agent provider interface
  *
- * // Connect to agent
- * const agent = await provider.connect('agent-id');
+ * Responsible for:
+ * - Managing agent state/configuration storage
+ * - Creating connections to agents
+ * - Abstracting away transport details (cloud/local)
  *
- * // Use agent
- * const session = await agent.sessions.create({ cwd: '/workspace' });
+ * The provider.connect() method returns an AgentConnection.
+ * The client wraps the connection in an ActiveSession instance.
  *
- * // Get available models
- * const models = await provider.getModels('my-repo');
- * ```
+ * @typeParam C - Connection type used by this provider (e.g., CloudAgentConnection, LocalAgentConnection)
  */
-declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>, FilesystemProvider {
-  private options;
-  private logger?;
-  private fetchImpl;
-  /** Cache for filesystem instances (keyed by agentId) */
-  private filesystemCache;
-  /** Cache for agent connections (keyed by endpoint link) */
-  private connectionCache;
-  /** COS upload service instance */
-  private cosUploadService;
-  /** Event listeners for provider-level events */
-  private eventListeners;
-  constructor(options: CloudAgentProviderOptions);
-  /**
-   * Dispose the provider and clean up resources
-   */
-  dispose(): void;
-  /**
-   * Get the filesystem provider (returns self)
-   */
-  get filesystem(): FilesystemProvider;
-  /**
-   * Get filesystem resource for an agent
-   *
-   * Creates or returns cached filesystem instance for the agent's sandbox.
-   * The filesystem supports both `agent:///` URIs and raw paths.
-   *
-   * @param agentId - Agent ID to get filesystem for
-   * @returns FilesResource instance for the agent's sandbox (with URI support)
-   *
-   * @example
-   * ```typescript
-   * const fs = await provider.getFilesystem(agentId);
-   *
-   * // Use agent:/// URIs
-   * const content = await fs.read('agent:///files/src/app.ts');
-   * await fs.write('agent:///artifacts/output.txt', 'Hello');
-   *
-   * // Raw paths still work (backward compatible)
-   * const content2 = await fs.read('/src/app.ts');
-   * ```
-   */
-  getFilesystem(agentId: string): Promise<FilesResource>;
+interface AgentProvider<C extends AgentConnection = AgentConnection> {
   /**
-   * Get sandbox information from backend
-   *
-   * Uses GET {endpoint}/console/cloudagent/agentmgmt/agents/{agentId}/session
-   * to retrieve sandbox information. Extracts sandboxId from the session response
-   * and constructs the apiUrl for E2B proxy.
+   * Create a new agent and return its ID
    *
-   * @param agentId - Agent ID
-   * @returns E2B Sandbox connection information with sandboxId and apiUrl
-   */
-  private getSandboxInfo;
-  /**
-   * Get agent state by ID
+   * @param params - Optional session params (used by LocalAgentProvider to get cwd)
+   * @returns Agent ID (Cloud: UUID, Local: cwd)
    */
-  get(agentId: string): Promise<CloudAgentState | undefined>;
+  create?(params?: CreateSessionParams$1): Promise<string>;
+  /** Get agent state by ID */
+  get(agentId: string): Promise<AgentState | undefined>;
   /**
    * List all agent states with pagination information
    *
    * @param options - Optional query parameters for filtering, sorting, and pagination
+   *                  Cloud providers use these for API queries and return server pagination
+   *                  Local providers apply client-side filtering and return synthetic pagination
    * @returns Object containing agents array and pagination info
    */
-  list(options?: ListAgentOptions): Promise<ListAgentResult<CloudAgentState>>;
-  /**
-   * Create a new agent
-   * POST {endpoint}/console/cloudagent/agentmgmt/agents
-   */
-  create(): Promise<string>;
-  /**
-   * Connect to an agent and return the connection
-   *
-   * This method:
-   * 1. Fetches the agent configuration from the backend
-   * 2. Checks if an existing connection can be reused (based on endpoint link)
-   * 3. Creates a CloudAgentConnection to the agent's endpoint if not cached
-   * 4. Saves session connection info to the connection
-   * 5. Connects and initializes the connection
-   * 6. Returns the connected CloudAgentConnection
-   *
-   * Connection caching:
-   * - Connections are cached by endpoint link to enable reuse
-   * - CloudAgentConnection is responsible for handling connection health checks
-   *   and token expiration internally
-   */
-  connect(agentId: string): Promise<CloudAgentConnection>;
-  /**
-   * Delete an agent by ID
-   * POST {endpoint}/console/cloudagent/agentmgmt/agents/{agentId}/delete
-   */
+  list(options?: ListAgentOptions): Promise<ListAgentResult<AgentState>>;
+  /** Connect to an agent and return the connection */
+  connect(agentId: string): Promise<C>;
+  /** Delete an agent by ID */
   delete(agentId: string): Promise<boolean>;
   /**
-   * Archive an agent by ID
-   * POST {endpoint}/console/cloudagent/agentmgmt/agents/{agentId}/archive
+   * Archive an agent by ID (optional)
+   * Used by CloudAgentProvider for archiving agents
    *
    * @param agentId - Agent ID to archive
-   * @returns ArchiveAgentResponse containing the archived agent ID
-   *
-   * @example
-   * ```typescript
-   * const result = await provider.archive('agent-123');
-   * console.log('Archived agent:', result.id);
-   * ```
+   * @returns Object containing the archived agent ID
    */
-  archive(agentId: string): Promise<ArchiveAgentResponse>;
+  archive?(agentId: string): Promise<{
+    id: string;
+  }>;
   /**
-   * Rename an agent by ID
-   * PATCH {endpoint}/v2/cloudagent/agentmgmt/agents/{agentId}
+   * Rename an agent by ID (optional)
+   * Used by CloudAgentProvider and LocalAgentProvider for renaming agents
    *
    * @param agentId - Agent ID to rename
    * @param title - New title for the agent
-   * @returns RenameAgentResponse containing the renamed agent ID
-   *
-   * @example
-   * ```typescript
-   * const result = await provider.rename('agent-123', 'New Title');
-   * console.log('Renamed agent:', result.id);
-   * ```
+   * @returns Object containing the renamed agent ID
    */
-  rename(agentId: string, title: string): Promise<RenameAgentResponse>;
+  rename?(agentId: string, title: string): Promise<{
+    id: string;
+  }>;
   /**
-   * Get available models from product configuration
+   * Move an agent by ID (optional)
+   * Used by LocalAgentProvider for moving Playground sessions to Workspace
    *
-   * GET {endpoint}/v3/config?repos[]={repo}
+   * @param agentId - Agent ID to move
+   * @returns Object containing the moved agent ID
+   */
+  move?(agentId: string): Promise<{
+    id: string;
+  }>;
+  /** Filesystem provider (optional - some providers may not support filesystem operations) */
+  readonly filesystem?: FilesystemProvider;
+  /**
+   * Get available models for a repository (optional)
+   * Implementation varies by provider type
+   * @param repo - Repository identifier
+   * @returns Array of model information
+   */
+  getModels?(repo?: string): Promise<ModelInfo$1[]>;
+  /**
+   * Register sessionId → agentId mapping (optional, used by LocalAgentProvider)
+   * Called after session creation to maintain the mapping for loadSession
    *
-   * This method fetches the product configuration from /v3/config API
-   * and extracts the models array from the response.
+   * @param sessionId - Session ID returned by connection.createSession()
+   * @param agentId - Agent ID (cwd for Local)
+   */
+  registerSession?(sessionId: string, agentId: string): void;
+  /**
+   * Open a workspace window (optional, used by LocalAgentProvider)
    *
-   * @param repo - Optional repository URL for context-specific config
-   * @returns Array of ModelInfo with full model details
+   * @param params - Workspace params including cwd
+   * @returns Response with success status
    */
-  getModels(repo?: string): Promise<ModelInfo$1[]>;
+  openWorkspace?(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
   /**
-   * Generate a unique request ID
+   * Pick files from file dialog (optional, used by LocalAgentProvider)
+   *
+   * @param params - File picker params including filters
+   * @returns Response with file paths and cancel status
    */
-  private generateRequestId;
+  pickFile?(params?: PickFileParams): Promise<PickFileResponse>;
   /**
-   * Common image MIME types for filtering
+   * Pick folders from folder dialog (optional, used by LocalAgentProvider)
+   *
+   * @param params - Folder picker params
+   * @returns Response with folder paths and cancel status
    */
-  private static readonly IMAGE_MIME_TYPES;
+  pickFolder?(params?: PickFolderParams): Promise<PickFolderResponse>;
   /**
-   * Pick files using browser's native file input
+   * Upload a file to cloud storage (optional)
    *
-   * @param params - File picker parameters
-   * @returns Response with selected file paths (filenames in browser)
+   * @param params - Upload parameters including file content
+   * @returns Response with cloud URL after successful upload
    */
-  pickFile(params?: PickFileParams): Promise<PickFileResponse>;
+  uploadFile?(params: UploadFileParams): Promise<UploadFileResponse>;
   /**
-   * Convert file extension to MIME type
+   * Search for files in the workspace (optional, used by LocalAgentProvider)
+   *
+   * @param params - Search parameters including options
+   * @returns Response with search results
    */
-  private extensionToMimeType;
+  searchFile?(params: SearchFileParams): Promise<SearchFileResponse>;
   /**
-   * Upload files to cloud storage via COS presigned URL
+   * Batch toggle plugins (optional, used by LocalAgentProvider)
    *
-   * @param params - files array (File objects in browser)
-   * @returns Response with corresponding cloud URLs
+   * @param request - Batch plugin operation request
+   * @returns Batch operation result
    */
-  uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
+  batchTogglePlugins?(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
   /**
-   * Register event listener
+   * Register an event listener
+   * Provider implementations should forward events to the underlying transport
+   *
    * @param event - Event name
    * @param handler - Event handler function
    */
-  on(event: string, handler: (...args: any[]) => void): () => void;
+  on?(event: string, handler: (...args: any[]) => void): void;
   /**
-   * Unregister event listener
+   * Unregister an event listener
+   *
    * @param event - Event name
-   * @param handler - Event handler function
+   * @param handler - Event handler function to remove
    */
-  off(event: string, handler: (...args: any[]) => void): void;
+  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;
   /**
-   * Emit event to all registered listeners
-   * @param event - Event name
-   * @param args - Event arguments
+   * 运行环境类型
+   * - 'local': IDE 本地环境
+   * - 'cloud': 云端环境
    */
-  private emitEvent;
-  private toAgentState;
-  private request;
+  environmentType?: EnvironmentType;
 }
-//#endregion
-//#region ../agent-provider/lib/common/providers/cloud-agent-provider/e2b-filesystem.d.ts
 /**
- * E2B Filesystem Implementation
- *
- * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource interface.
- *
- * @example
- * ```typescript
- * const fs = await E2BFilesystem.connect({
- *     sandboxId: 'sandbox-123',
- *     apiKey: 'e2b_xxx'
- * });
- *
- * // Read/write files
- * await fs.write('/test.txt', 'Hello World');
- * const content = await fs.read('/test.txt');
+ * Client sessions resource interface
+ * Top-level API for session management
  *
- * // Watch for changes
- * const handle = await fs.watchDir('/workspace', (event) => {
- *     console.log('File changed:', event);
- * });
- * ```
+ * Key design:
+ * - list() returns sessions with pagination info (mapped from agents)
+ * - create() creates a new session (auto-creates agent and connects)
+ * - load() loads an existing session (finds agent by sessionId and connects)
+ * - archive() archives a session/agent
+ * - initializeWorkspace() initializes a workspace for future sessions
  */
-declare class E2BFilesystem implements FilesResource {
-  private sandbox;
-  constructor(sandbox: Sandbox);
+interface ClientSessionsResource {
   /**
-   * Connect to an E2B Sandbox and create filesystem instance
+   * List all sessions with pagination info
+   * Cloud: Returns server-side filtered/sorted/paginated results
+   * Local: Returns client-side filtered/sorted results (synthetic pagination)
    */
-  static connect(info: E2BSandboxConnectionInfo): Promise<E2BFilesystem>;
+  list(options?: ListAgentOptions): Promise<ListAgentResult<SessionInfo>>;
+  /** Create a new session (auto-creates agent and connects) */
+  create(params: CreateSessionParams$1): Promise<ActiveSession>;
+  /** Load an existing session (finds agent by sessionId and connects) */
+  load(params: LoadSessionParams$1): Promise<ActiveSession>;
   /**
-   * Get the underlying E2B Sandbox instance
+   * Archive a session/agent
+   * @param sessionId - Session ID to archive
+   * @returns Object containing the archived session ID
    */
-  getSandbox(): Sandbox;
-  read(path: string, opts?: FilesystemRequestOpts & {
-    format?: 'text';
-  }): Promise<string>;
-  read(path: string, opts: FilesystemRequestOpts & {
-    format: 'bytes';
-  }): Promise<Uint8Array>;
-  read(path: string, opts: FilesystemRequestOpts & {
-    format: 'blob';
-  }): Promise<Blob>;
-  read(path: string, opts: FilesystemRequestOpts & {
-    format: 'stream';
-  }): Promise<ReadableStream<Uint8Array>>;
-  write(path: string, data: string | ArrayBuffer | Blob | ReadableStream, opts?: FilesystemRequestOpts): Promise<WriteInfo>;
-  write(files: WriteEntry[], opts?: FilesystemRequestOpts): Promise<WriteInfo[]>;
-  list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo$1[]>;
-  exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
-  makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
-  remove(path: string, opts?: FilesystemRequestOpts): Promise<void>;
-  rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
-  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
-  watchDir(path: string, onEvent: (event: FilesystemEvent$1) => void | Promise<void>, opts?: WatchOpts & {
-    onExit?: (err?: Error) => void | Promise<void>;
-  }): Promise<WatchHandle>;
+  archive(sessionId: string): Promise<{
+    id: string;
+  }>;
+  /**
+   * Rename a session/agent
+   * @param sessionId - Session ID to rename
+   * @param title - New title for the session
+   * @returns Object containing the renamed session ID
+   */
+  rename(sessionId: string, title: string): Promise<{
+    id: string;
+  }>;
+  /**
+   * Move a session (Playground → Workspace)
+   * @param sessionId - Session ID to move
+   * @returns Object containing the moved session ID
+   */
+  move(sessionId: string): Promise<{
+    id: string;
+  }>;
+  /** Initialize a workspace for future sessions */
+  initializeWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  /** Models resource for getting available models */
+  readonly models: ModelsResource;
+  /** Get current workspaces list */
+  getCurrentWorkspaces(filter?: {
+    activeOnly?: boolean;
+  }): Promise<WorkspaceInfo[]>;
+  /** Subscribe to sessions resource events */
+  on<K extends keyof SessionsResourceEvents>(event: K, handler: SessionsResourceEventHandler<K>): void;
+  /** Unsubscribe from sessions resource events */
+  off<K extends keyof SessionsResourceEvents>(event: K, handler: SessionsResourceEventHandler<K>): void;
+  /** Open a workspace (for LocalAgentProvider) */
+  openWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  /** Pick files from file dialog (for LocalAgentProvider) */
+  pickFile(params?: PickFileParams): Promise<PickFileResponse>;
+  /** Pick folders from folder dialog (for LocalAgentProvider) */
+  pickFolder(params?: PickFolderParams): Promise<PickFolderResponse>;
+  /** Upload a file to cloud storage */
+  uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
+  /** Search for files in the workspace (for LocalAgentProvider) */
+  searchFile(params: SearchFileParams): Promise<SearchFileResponse>;
+  /** Batch toggle plugins (for LocalAgentProvider) */
+  batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
+}
+/**
+ * Workspace information (aligned with FolderSelectResult)
+ */
+interface WorkspaceInfo {
+  /** Folder path */
+  path: string;
+  /** Folder display name */
+  label: string;
+}
+/**
+ * File filter for pickFile dialog
+ */
+interface FileFilter {
+  /** Display name for the filter */
+  readonly name: string;
+  /** File extensions (without dot) */
+  readonly extensions: string[];
+}
+/**
+ * Parameters for picking files
+ */
+interface PickFileParams {
+  /** Default path for the dialog */
+  readonly defaultPath?: string;
+  /** File type filters */
+  readonly filters?: FileFilter[];
+  /** Whether to allow multiple selection (default false) */
+  readonly canSelectMany?: boolean;
+}
+/**
+ * Response from picking files
+ */
+interface PickFileResponse {
+  /** Selected files - File objects in browser, absolute path strings in IDE */
+  readonly files: Array<File | string>;
+  /** Whether user cancelled the dialog */
+  readonly canceled: boolean;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for picking folders
+ */
+interface PickFolderParams {
+  /** Default path for the dialog */
+  readonly defaultPath?: string;
+}
+/**
+ * Response from picking folders
+ */
+interface PickFolderResponse {
+  /** Selected folder paths */
+  readonly folderPaths: string[];
+  /** Whether user cancelled the dialog */
+  readonly canceled: boolean;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for uploading files
+ */
+interface UploadFileParams {
+  /** Files to upload - File objects in browser, absolute path strings in IDE */
+  readonly files: Array<File | string>;
+}
+/**
+ * Response from uploading files
+ */
+interface UploadFileResponse {
+  /** Whether upload was successful */
+  readonly success: boolean;
+  /** Cloud URLs corresponding to each uploaded file (same order as input files) */
+  readonly urls?: string[];
+  /** URL expiration time in seconds (from backend) */
+  readonly expireSeconds?: number;
+  /** Error message (if upload failed) */
+  readonly error?: string;
+}
+/**
+ * Mention type for file/folder
+ */
+declare enum MentionType {
+  file = "file",
+  folder = "folder"
+}
+/**
+ * Search options for file search
+ */
+interface SearchOptions {
+  /** Search keyword */
+  readonly search?: string;
+  /** Number of results to return */
+  readonly resultNum: number;
+}
+/**
+ * File search result
+ */
+interface SearchFileResult {
+  /** Full path */
+  path: string;
+  /** Relative path */
+  relativePath: string;
+  /** File name */
+  fileName?: string;
+  /** Folder name */
+  folderName?: string;
+  /** Type (file or folder) */
+  type: MentionType.file | MentionType.folder;
+}
+/**
+ * Parameters for searching files
+ */
+interface SearchFileParams {
+  /** Search options */
+  readonly options: SearchOptions;
+  /** Search path*/
+  readonly cwd?: string;
+}
+/**
+ * Response from searching files
+ */
+interface SearchFileResponse {
+  /** Search results */
+  readonly results: SearchFileResult[];
+  /** Error message (if failed) */
+  readonly error?: string;
 }
 //#endregion
-//#region ../agent-provider/lib/common/client/client.d.ts
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
 /**
- * AgentClient - Session-centric client
- *
- * Provides a session-centric API that internally manages agents.
- * Users interact with sessions; the agent lifecycle is handled internally.
- *
- * @example
- * ```typescript
- * // Create client with a provider
- * const provider = new CloudAgentProvider({
- *     endpoint: 'https://api.example.com',
- *     authToken: 'token'
- * });
- *
- * const client = new AgentClient({
- *     provider,
- *     logger: console
- * });
- *
- * // List all sessions
- * const sessions = await client.sessions.list();
- *
- * // Create new session (auto-creates agent and connects)
- * const session = await client.sessions.create({ cwd: '/workspace' });
- * console.log(session.agentState.status);  // agent status
- * console.log(session.agentState.id);      // agent ID
- *
- * // Send prompt
- * await session.prompts.send({ content: 'Hello' });
- *
- * // Get available models
- * const models = await client.sessions.models.list('my-repo');
- *
- * // Use 'using' keyword for automatic cleanup
- * {
- *     using session = await client.sessions.create({ cwd: '/workspace' });
- *     // ... use session
- * } // session automatically disposed
- *
- * // Or manually disconnect
- * session.disconnect();
+ * Cloud Agent Connection implementation
+ * Uses Streamable HTTP transport to connect to cloud-hosted ACP agents
+ * Uses composition pattern - implements event emitter methods internally
  *
- * // Load existing session
- * const loadedSession = await client.sessions.load({
- *     sessionId: 'xxx',
- *     cwd: '/workspace'
- * });
- * ```
+ * TODO: Connection Lifecycle Responsibilities
+ * CloudAgentProvider caches connections by endpoint link. This class needs to:
+ * - Implement connection health checks (detect and handle connection failures/reconnection)
+ * - Handle token expiration (refresh or re-authentication when tokens expire)
+ * - Emit 'disconnected' event when connection becomes unhealthy so provider can clean up cache
  */
-declare class AgentClient {
-  private logger?;
-  private provider;
-  private sessionManager;
+declare class CloudAgentConnection implements AgentConnection {
+  private client;
+  private listeners;
+  private onceListeners;
   /**
-   * Sessions resource namespace (primary API entry point)
+   * Flag to suppress sessionUpdate event emission during streaming.
+   * When true, onSessionUpdate callback won't emit to avoid duplicate messages with promptStream.
    */
-  readonly sessions: ClientSessionsResource;
+  private _isStreaming;
   /**
-   * 运行环境类型
-   * - 'local': IDE 本地环境
-   * - 'cloud': 云端环境
+   * Session connection information (sandboxId, link, token, etc.)
+   * Set by CloudAgentProvider.connect() after fetching session data from backend.
    */
-  readonly environmentType: 'local' | 'cloud';
-  constructor(options: AgentClientOptions);
-  private createSessionsResource;
-  private createModelsResource;
+  private _sessionConnectionInfo?;
+  readonly agentId: string;
+  readonly transport: "cloud";
+  readonly cwd: string;
+  constructor(agentId: string, config: CloudConnectionConfig, cwd?: string);
+  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;
+  once<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  emit<K extends keyof ConnectionEvents>(event: K, data: ConnectionEvents[K]): boolean;
+  removeAllListeners<K extends keyof ConnectionEvents>(event?: K): this;
+  get state(): AgentStatus;
+  get isInitialized(): boolean;
+  get capabilities(): AgentCapabilities | undefined;
+  get initializeResult(): InitializeResponse | undefined;
+  connect(): Promise<InitializeResponse>;
+  disconnect(): Promise<void>;
+  createSession(params: CreateSessionParams): Promise<NewSessionResponse>;
+  loadSession(params: LoadSessionParams): Promise<LoadSessionResponse>;
+  setSessionMode(sessionId: string, modeId: string): Promise<SetSessionModeResponse>;
+  setSessionModel(sessionId: string, modelId: string): Promise<SetSessionModelResponse>;
+  prompt(sessionId: string, params: PromptParams): Promise<PromptResponse$1>;
+  promptStream(sessionId: string, params: PromptParams): AsyncIterable<SessionNotification>;
+  cancel(sessionId: string): Promise<void>;
+  resolvePermission(requestId: string, optionId: string): boolean;
+  rejectPermission(requestId: string, reason?: string): boolean;
+  getPendingPermissions(): Map<string, {
+    params: RequestPermissionRequest;
+    createdAt: number;
+  }>;
+  hasPendingPermissions(): boolean;
+  answerQuestion(toolCallId: string, answers: QuestionAnswers): boolean;
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  getPendingQuestions(): Map<string, {
+    request: QuestionRequest;
+    createdAt: number;
+  }>;
+  hasPendingQuestions(): boolean;
+  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
   /**
-   * Dispose the client
-   *
-   * Note: Active sessions are not automatically disposed.
-   * The caller is responsible for disconnecting sessions they created.
+   * Set session connection information
+   * Called by CloudAgentProvider.connect() after fetching session data from backend.
    */
-  dispose(): void;
+  setSessionConnectionInfo(info: SessionConnectionInfo): void;
+  /**
+   * Get session connection information
+   * Contains sandboxId, link, token, etc.
+   */
+  get sessionConnectionInfo(): SessionConnectionInfo | undefined;
+  extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
 }
 //#endregion
-//#region ../agent-provider/lib/common/client/session.d.ts
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/api-types.d.ts
 /**
- * Filesystem getter function type
- * Returns a FilesResource instance for file operations
+ * Response for archive agent
+ * POST /v2/cloudagent/agentmgmt/agents/{id}/archive
  */
-type FilesystemGetter = () => Promise<FilesResource>;
+interface ArchiveAgentResponse {
+  /** Agent ID */
+  id: string;
+}
 /**
- * Options for creating an ActiveSessionImpl instance
+ * Response for rename agent
+ * PATCH /v2/cloudagent/agentmgmt/agents/{id}
  */
-interface ActiveSessionImplOptions {
+interface RenameAgentResponse {
+  /** Agent ID */
+  id: string;
+}
+//#endregion
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-provider.d.ts
+/**
+ * Configuration for CloudAgentProvider
+ */
+interface CloudAgentProviderOptions {
+  /** Base endpoint URL for agent management API (e.g., 'https://api.example.com') */
+  endpoint: string;
+  /** Authorization token */
+  authToken?: string;
+  /** Custom headers */
+  headers?: Record<string, string>;
   /** Logger instance */
   logger?: Logger;
-  /** Getter function for filesystem resource (provided by SessionManager) */
-  getFilesystem?: FilesystemGetter;
-  /** Session connection information (for cloud sessions) */
-  connectionInfo?: SessionConnectionInfo;
+  /** Custom fetch implementation */
+  fetch?: typeof fetch;
+  /** Client capabilities (sent during agent initialization) */
+  clientCapabilities?: ClientCapabilities$1;
 }
 /**
- * ActiveSessionImpl - Implements the ActiveSession interface
+ * CloudAgentProvider - Manages cloud-hosted agents via REST API
  *
- * This class wraps an AgentConnection and provides the session-centric API.
- * It is created by SessionManager when creating or loading sessions.
+ * API Endpoints:
+ * - POST   {endpoint}/console/cloudagent/agentmgmt/agents             - Create new agent
+ * - GET    {endpoint}/console/cloudagent/agentmgmt/agents/{id}       - Get agent data
+ * - GET    {endpoint}/console/cloudagent/agentmgmt/agents            - List all agents
+ * - POST   {endpoint}/console/cloudagent/agentmgmt/agents/{id}/delete - Delete agent
+ * - GET    {endpoint}/console/cloudagent/agentmgmt/agents/{id}/session - Get agent session (includes sandboxId)
+ * - GET    {endpoint}/console/cloudagent/agentmgmt/models             - Get available models
+ *
+ * The provider stores agent endpoint configurations in the cloud backend.
+ * When connect() is called, it creates a CloudAgentConnection to the agent's
+ * endpoint and returns an Agent instance.
  *
  * @example
  * ```typescript
- * // Created by client.sessions.new() or client.sessions.load()
- * const session = await client.sessions.new({ cwd: '/workspace' });
+ * const provider = new CloudAgentProvider({
+ *     endpoint: 'https://staging-copilot.tencent.com',
+ *     authToken: 'token'
+ * });
  *
- * // Access agent state
- * console.log(session.agentState.status);
+ * // List all agents (uses default pagination and sorting)
+ * const allAgents = await provider.list();
  *
- * // Send prompt
- * const response = await session.prompts.send({ content: 'Hello!' });
+ * // List agents with custom pagination
+ * const page2 = await provider.list({
+ *     page: 2,
+ *     size: 50
+ * });
  *
- * // Cleanup
- * session.disconnect();
+ * // List agents with filtering
+ * const runningAgents = await provider.list({
+ *     filters: [
+ *         { field: 'status', value: 'running' }
+ *     ]
+ * });
+ *
+ * // List agents with custom sorting
+ * const sortedAgents = await provider.list({
+ *     sort: {
+ *         orderBy: 'createdAt',
+ *         order: 'desc'
+ *     }
+ * });
+ *
+ * // List agents created in last 14 days with multiple filters
+ * const recentAgents = await provider.list({
+ *     dayRange: 14,
+ *     filters: [
+ *         { field: 'status', value: 'running,stopped' }
+ *     ],
+ *     page: 1,
+ *     size: 20
+ * });
+ *
+ * // Get agent state
+ * const state = await provider.get('agent-id');
+ *
+ * // Connect to agent
+ * const agent = await provider.connect('agent-id');
+ *
+ * // Use agent
+ * const session = await agent.sessions.create({ cwd: '/workspace' });
+ *
+ * // Get available models
+ * const models = await provider.getModels('my-repo');
  * ```
  */
-declare class ActiveSessionImpl implements ActiveSession {
-  private _id;
-  private _agentId;
-  private _availableModes?;
-  private _currentMode?;
-  private _availableCommands;
+declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>, FilesystemProvider {
+  private options;
   private logger?;
-  private connection;
-  private _getFilesystem?;
-  private _connectionInfo?;
-  private listeners;
-  private onceListeners;
-  /**
-   * Agent operations namespace
-   */
-  readonly agent: SessionAgentOperations;
+  private fetchImpl;
+  /** Cache for filesystem instances (keyed by agentId) */
+  private filesystemCache;
+  /** Cache for agent connections (keyed by endpoint link) */
+  private connectionCache;
+  /** COS upload service instance */
+  private cosUploadService;
+  /** Event listeners for provider-level events */
+  private eventListeners;
+  constructor(options: CloudAgentProviderOptions);
   /**
-   * Prompts resource namespace
+   * Dispose the provider and clean up resources
    */
-  readonly prompts: PromptsResource;
+  dispose(): void;
   /**
-   * Artifacts resource namespace
+   * Get the filesystem provider (returns self)
    */
-  readonly artifacts: ArtifactsResource;
+  get filesystem(): FilesystemProvider;
   /**
-   * Files resource namespace (lazily loaded via getter)
+   * Get filesystem resource for an agent
+   *
+   * Creates or returns cached filesystem instance for the agent's sandbox.
+   * The filesystem supports both `agent:///` URIs and raw paths.
+   *
+   * @param agentId - Agent ID to get filesystem for
+   * @returns FilesResource instance for the agent's sandbox (with URI support)
+   *
+   * @example
+   * ```typescript
+   * const fs = await provider.getFilesystem(agentId);
+   *
+   * // Use agent:/// URIs
+   * const content = await fs.read('agent:///files/src/app.ts');
+   * await fs.write('agent:///artifacts/output.txt', 'Hello');
+   *
+   * // Raw paths still work (backward compatible)
+   * const content2 = await fs.read('/src/app.ts');
+   * ```
    */
-  readonly files: FilesResource;
+  getFilesystem(agentId: string): Promise<FilesResource>;
   /**
-   * Create an ActiveSessionImpl instance
+   * Get sandbox information from backend
+   *
+   * Uses GET {endpoint}/console/cloudagent/agentmgmt/agents/{agentId}/session
+   * to retrieve sandbox information. Extracts sandboxId from the session response
+   * and constructs the apiUrl for E2B proxy.
    *
-   * @param sessionId - Session ID
    * @param agentId - Agent ID
-   * @param connection - Already connected AgentConnection
-   * @param options - Additional options
-   */
-  constructor(sessionId: string, agentId: string, connection: AgentConnection, options?: ActiveSessionImplOptions);
-  /**
-   * Session ID
-   */
-  get id(): string;
-  /**
-   * Agent ID
-   */
-  get agentId(): string;
-  /**
-   * Agent state (live connection state)
-   * Returns LocalAgentState or CloudAgentState based on transport type
-   */
-  get agentState(): AgentState;
-  /**
-   * Get agent capabilities (available after connection)
-   */
-  get capabilities(): AgentCapabilities | undefined;
-  /**
-   * Available session modes
+   * @returns E2B Sandbox connection information with sandboxId and apiUrl
    */
-  get availableModes(): SessionMode[] | undefined;
+  private getSandboxInfo;
   /**
-   * Current session mode
+   * Get agent state by ID
    */
-  get currentMode(): string | undefined;
+  get(agentId: string): Promise<CloudAgentState | undefined>;
   /**
-   * Available slash commands
+   * List all agent states with pagination information
    *
-   * When Agent sends available_commands_update, this list is automatically updated.
-   * Commands can be accessed directly without waiting for events.
-   */
-  get availableCommands(): AvailableCommand[];
-  /**
-   * Check if the session is active
-   */
-  get isActive(): boolean;
-  /**
-   * Session connection information (only available for cloud sessions)
-   * 会话连接信息，包括sandboxId、link、token等
+   * @param options - Optional query parameters for filtering, sorting, and pagination
+   * @returns Object containing agents array and pagination info
    */
-  get connectionInfo(): SessionConnectionInfo | undefined;
+  list(options?: ListAgentOptions): Promise<ListAgentResult<CloudAgentState>>;
   /**
-   * Set session modes (called after create/load)
+   * Create a new agent
+   * POST {endpoint}/console/cloudagent/agentmgmt/agents
    */
-  setModes(availableModes?: SessionMode[], currentMode?: string): void;
-  private createAgentOperations;
-  private createPromptsResource;
-  private createArtifactsResource;
+  create(): Promise<string>;
   /**
-   * Create files resource with lazy-loaded filesystem
+   * Connect to an agent and return the connection
    *
-   * The filesystem is lazily loaded on first use to avoid unnecessary
-   * connections to the sandbox. The actual filesystem instance is obtained
-   * via the getter function provided by SessionManager.
-   */
-  private createFilesResource;
-  /**
-   * Resolve a permission request
-   */
-  resolvePermission(requestId: string, optionId: string): boolean;
-  /**
-   * Reject a permission request
-   */
-  rejectPermission(requestId: string, reason?: string): boolean;
-  /**
-   * Answer a question request with user's selections
-   */
-  answerQuestion(toolCallId: string, answers: QuestionAnswers): boolean;
-  /**
-   * Cancel a question request
+   * This method:
+   * 1. Fetches the agent configuration from the backend
+   * 2. Checks if an existing connection can be reused (based on endpoint link)
+   * 3. Creates a CloudAgentConnection to the agent's endpoint if not cached
+   * 4. Saves session connection info to the connection
+   * 5. Connects and initializes the connection
+   * 6. Returns the connected CloudAgentConnection
+   *
+   * Connection caching:
+   * - Connections are cached by endpoint link to enable reuse
+   * - CloudAgentConnection is responsible for handling connection health checks
+   *   and token expiration internally
    */
-  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  connect(agentId: string): Promise<CloudAgentConnection>;
   /**
-   * Callback for tool operations (skip or cancel)
-   * @param toolCallId Tool call ID
-   * @param toolName Tool name
-   * @param action Action to perform ('skip' or 'cancel')
+   * Delete an agent by ID
+   * POST {endpoint}/console/cloudagent/agentmgmt/agents/{agentId}/delete
    */
-  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
-    success: boolean;
-    error?: string;
-  }>;
+  delete(agentId: string): Promise<boolean>;
   /**
-   * Set the current session mode
+   * Archive an agent by ID
+   * POST {endpoint}/console/cloudagent/agentmgmt/agents/{agentId}/archive
    *
-   * @param modeId - The mode ID to switch to (must be in availableModes)
-   * @throws Error if modeId is not in availableModes or connection fails
+   * @param agentId - Agent ID to archive
+   * @returns ArchiveAgentResponse containing the archived agent ID
    *
    * @example
    * ```typescript
-   * // Switch to 'code' mode
-   * await session.setMode('code');
-   *
-   * // Switch to 'architect' mode
-   * await session.setMode('architect');
+   * const result = await provider.archive('agent-123');
+   * console.log('Archived agent:', result.id);
    * ```
    */
-  setMode(modeId: string): Promise<void>;
+  archive(agentId: string): Promise<ArchiveAgentResponse>;
   /**
-   * Set the current session model
+   * Rename an agent by ID
+   * PATCH {endpoint}/v2/cloudagent/agentmgmt/agents/{agentId}
+   *
+   * @param agentId - Agent ID to rename
+   * @param title - New title for the agent
+   * @returns RenameAgentResponse containing the renamed agent ID
    *
-   * @param modelId - The model ID to switch to
    * @example
    * ```typescript
-   * // Switch to Claude Sonnet 4
-   * await session.setSessionModel('claude-sonnet-4-20250514');
-   *
-   * // Switch to GPT-4o
-   * await session.setSessionModel('gpt-4o');
+   * const result = await provider.rename('agent-123', 'New Title');
+   * console.log('Renamed agent:', result.id);
    * ```
    */
-  setSessionModel(modelId: string): Promise<void>;
+  rename(agentId: string, title: string): Promise<RenameAgentResponse>;
   /**
-   * Subscribe to session events
+   * Get available models from product configuration
+   *
+   * GET {endpoint}/v3/config?repos[]={repo}
+   *
+   * This method fetches the product configuration from /v3/config API
+   * and extracts the models array from the response.
+   *
+   * @param repo - Optional repository URL for context-specific config
+   * @returns Array of ModelInfo with full model details
    */
-  on<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  getModels(repo?: string): Promise<ModelInfo$1[]>;
   /**
-   * Unsubscribe from session events
+   * Generate a unique request ID
    */
-  off<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  private generateRequestId;
   /**
-   * Subscribe to a session event once
+   * Common image MIME types for filtering
    */
-  once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  private static readonly IMAGE_MIME_TYPES;
   /**
-   * Emit an event to all registered listeners
+   * Pick files using browser's native file input
+   *
+   * @param params - File picker parameters
+   * @returns Response with selected file paths (filenames in browser)
    */
-  private emit;
+  pickFile(params?: PickFileParams): Promise<PickFileResponse>;
   /**
-   * Remove all listeners for an event
+   * Convert file extension to MIME type
    */
-  private removeAllListeners;
+  private extensionToMimeType;
   /**
-   * Disconnect from the session/agent
+   * Upload files to cloud storage via COS presigned URL
+   *
+   * @param params - files array (File objects in browser)
+   * @returns Response with corresponding cloud URLs
    */
-  disconnect(): void;
+  uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
   /**
-   * Symbol.dispose for 'using' keyword support
-   * Automatically disconnects and cleans up when session goes out of scope
-   *
-   * @example
-   * ```typescript
-   * {
-   *     using session = await client.sessions.new({ cwd: '/workspace' });
-   *     // ... use session
-   * } // session automatically disposed
-   * ```
+   * Register event listener
+   * @param event - Event name
+   * @param handler - Event handler function
+   */
+  on(event: string, handler: (...args: any[]) => void): () => void;
+  /**
+   * Unregister event listener
+   * @param event - Event name
+   * @param handler - Event handler function
    */
-  [Symbol.dispose](): void;
-  private getConnectionOrThrow;
-  private setupConnectionEvents;
-  private mapPromptResponse;
+  off(event: string, handler: (...args: any[]) => void): void;
+  /**
+   * Emit event to all registered listeners
+   * @param event - Event name
+   * @param args - Event arguments
+   */
+  private emitEvent;
+  private toAgentState;
+  private request;
 }
 //#endregion
-//#region ../agent-provider/lib/common/client/session-manager.d.ts
-/**
- * Options for creating a SessionManager instance
- */
-interface SessionManagerOptions {
-  /** Agent provider (required) */
-  provider: AgentProvider;
-  /** Logger instance */
-  logger?: Logger;
-}
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/e2b-filesystem.d.ts
 /**
- * SessionManager - Session lifecycle management
- *
- * This class manages the relationship between sessions and agents.
- * Since the backend is agent-centric, SessionManager handles the mapping:
- * - Sessions are views over agents
- * - sessionId may equal agentId in simple cases
+ * E2B Filesystem Implementation
  *
- * Features:
- * - Session caching: reuses existing ActiveSession instances
- * - Automatic cleanup on session disconnect
+ * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource interface.
  *
  * @example
  * ```typescript
- * const manager = new SessionManager({ provider, logger });
- *
- * // List sessions
- * const sessions = await manager.listSessions();
+ * const fs = await E2BFilesystem.connect({
+ *     sandboxId: 'sandbox-123',
+ *     apiKey: 'e2b_xxx'
+ * });
  *
- * // Create new session
- * const session = await manager.createSession({ cwd: '/workspace' });
+ * // Read/write files
+ * await fs.write('/test.txt', 'Hello World');
+ * const content = await fs.read('/test.txt');
  *
- * // Load existing session (returns cached instance if available)
- * const loaded = await manager.loadSession({ sessionId: 'xxx', cwd: '/workspace' });
+ * // Watch for changes
+ * const handle = await fs.watchDir('/workspace', (event) => {
+ *     console.log('File changed:', event);
+ * });
  * ```
  */
-declare class SessionManager {
-  private provider;
-  private logger?;
-  constructor(options: SessionManagerOptions);
-  /**
-   * List all sessions with pagination info (mapped from agents)
-   *
-   * Each agent maps to a session. The sessionId is derived from the agent.
-   * Cloud: Returns server-side filtered/sorted/paginated results
-   * Local: Returns client-side filtered/sorted results (synthetic pagination)
-   *
-   * @param options - Optional query parameters for filtering, sorting, and pagination
-   */
-  listSessions(options?: ListAgentOptions): Promise<ListAgentResult<SessionInfo>>;
+declare class E2BFilesystem implements FilesResource {
+  private sandbox;
+  constructor(sandbox: Sandbox);
   /**
-   * Create a new session
-   *
-   * Steps:
-   * 1. Create new agent (if provider supports it) or use existing
-   * 2. Connect to agent
-   * 3. Call ACP newSession
-   * 4. Register session mapping (for LocalAgentProvider)
-   * 5. Return ActiveSession instance
+   * Connect to an E2B Sandbox and create filesystem instance
    */
-  createSession(params: CreateSessionParams$1): Promise<ActiveSession>;
+  static connect(info: E2BSandboxConnectionInfo): Promise<E2BFilesystem>;
   /**
-   * Load an existing session
-   *
-   * Steps:
-   * 1. Check cache for existing session
-   * 2. Find agent by sessionId (sessionId === agentId in current design)
-   * 3. Connect to agent
-   * 4. Call ACP loadSession
-   * 5. Return ActiveSession instance (cached)
+   * Get the underlying E2B Sandbox instance
    */
-  loadSession(params: LoadSessionParams$1): Promise<ActiveSession>;
-}
-//#endregion
-//#region ../agent-provider/lib/backend/agent-api.d.ts
-/**
- * Cloud Agent API 类型定义
- *
- * 定义与 /v2/cloudagent/agentmgmt/agents API 相关的数据结构
- */
-/**
- * 过滤条件
- */
-interface AgentFilter {
-  /** 过滤字段 */
-  field: string;
-  /** 过滤值 */
-  value: string;
-}
-/**
- * 排序条件
- */
-interface SortCondition {
-  /** 排序方向: asc | desc */
-  order: 'asc' | 'desc';
-  /** 排序字段 */
-  orderBy: string;
-}
-/**
- * 获取 Agent 列表请求参数
- */
-interface GetAgentsRequest {
-  /** 时间范围（天） */
-  dayRange?: number;
-  /** 过滤条件列表 */
-  filters?: AgentFilter[];
-  /** 页码 */
-  page?: number;
-  /** 每页大小 */
-  size?: number;
-  /** 排序条件 */
-  sort?: SortCondition;
-}
-/**
- * Agent 来源信息
- */
-interface CloudAgentSource {
-  /** 提供商: github, gitlab 等 */
-  provider: string;
-  /** 分支/引用 */
-  ref: string;
-  /** 仓库路径 */
-  repository: string;
-}
-/**
- * Agent 目标信息
- */
-interface CloudAgentTarget$1 {
-  /** 是否自动创建 PR */
-  autoCreatePr: boolean;
-  /** 分支名称 */
-  branchName?: string;
-  /** PR URL */
-  prUrl?: string;
-  /** Agent URL */
-  url?: string;
-}
-/**
- * Agent 状态
- */
-type CloudAgentStatus = 'CREATING' | 'RUNNING' | 'STOPPED' | 'FAILED' | 'DELETING';
-/**
- * Agent 可见性
- */
-type CloudAgentVisibility$1 = 'PRIVATE' | 'PUBLIC' | 'TEAM';
-/**
- * Cloud Agent 信息
- * 重命名为 CloudAgent 以避免与 ACP SDK 的 Agent 类型冲突
- */
-interface CloudAgent {
-  /** 创建时间 (ISO 8601) */
-  createdAt: string;
-  /** Agent ID */
-  id: string;
-  /** Agent 名称 */
-  name: string;
-  /** 来源信息 */
-  source: CloudAgentSource;
-  /** 状态 */
-  status: CloudAgentStatus;
-  /** 摘要 */
-  summary?: string;
-  /** 目标信息 */
-  target: CloudAgentTarget$1;
-  /** 可见性 */
-  visibility: CloudAgentVisibility$1;
-}
-/**
- * 分页信息
- */
-interface Pagination {
-  /** 是否有下一页 */
-  hasNext: boolean;
-  /** 是否有上一页 */
-  hasPrev: boolean;
-  /** 当前页码 */
-  page: number;
-  /** 每页大小 */
-  size: number;
-  /** 总数 */
-  total: number;
-  /** 总页数 */
-  totalPages: number;
-}
-/**
- * 获取 Agent 列表响应
- */
-interface GetAgentsResponse {
-  /** Agent 列表 */
-  agents: CloudAgent[];
-  /** 分页信息 */
-  pagination: Pagination;
-}
-//#endregion
-//#region ../agent-provider/lib/backend/types.d.ts
-/**
- * 账号版本类型
- */
-type Edition = 'pro' | 'personal' | 'ultimate' | 'exclusive';
-/**
- * 版本展示类型（用于 UI 展示）
- * - free: 免费版（个人版未订阅 Pro）
- * - pro: Pro 版（个人版已订阅 Pro）
- * - ultimate: 旗舰版（团队版）
- * - exclusive: 专享版（企业版）
- */
-type EditionDisplayType = 'free' | 'pro' | 'ultimate' | 'exclusive';
-/**
- * 部署状态
- */
-interface DeployStatus {
-  statusCode: number;
-  statusMsg: string;
-  detailMsg: string;
-}
-/**
- * 套餐代码
- */
-/**
- *  TCACA_code_001_PqouKr6QWV CodeBuddy海外版免费包
- * TCACA_code_002_AkiJS3ZHF5 CodeBuddy海外版Pro版本包-包月/CodeBuddy Pro Plan - Monthly:
- * TCACA_code_006_DbXS0lrypC CodeBuddy海外版一次性免费赠送2周的Pro版本包/CodeBuddy One-time Free 2-Week Pro Plan Trial
- * TCACA_code_007_nzdH5h4Nl0 CodeBuddy海外版运营裂变包/CodeBuddy Growth Plan
- * TCACA_code_003_FAnt7lcmRT CodeBuddy海外版Pro版本包-包年/CodeBuddy Pro Plan - Yearly
- * TCACA_code_008_cfWoLwvjU4 赠送月包
- */
-declare enum CommodityCode {
-  free = "TCACA_code_001_PqouKr6QWV",
-  // free
-  proMon = "TCACA_code_002_AkiJS3ZHF5",
-  proMonPlus = "TCACA_code_005_maRGyrHhw1",
-  gift = "TCACA_code_006_DbXS0lrypC",
-  activity = "TCACA_code_007_nzdH5h4Nl0",
-  proYear = "TCACA_code_003_FAnt7lcmRT",
-  freeMon = "TCACA_code_008_cfWoLwvjU4",
-  // free
-  extra = "TCACA_code_009_0XmEQc2xOf"
-}
-/**
- * 账号套餐信息
- */
-interface AccountPlan {
-  /** 是否是 Pro 版本 */
-  isPro: boolean;
-  isTria?: boolean;
-  /** 到期时间戳 */
-  expireAt?: number;
-  refreshAt?: number;
-  /** 自动续费标志 0-关闭 1-开启 */
-  renewFlag: 0 | 1;
-  /** 套餐代码 */
-  PackageCode?: CommodityCode;
-  /** 套餐名称 */
-  name: string;
-  usageTotal?: string;
-  usageUsed?: string;
-  usageLeft?: string;
-}
-/**
- * 账号信息
- */
-interface Account {
-  /** 用户ID（唯一标识） */
-  uid: string;
-  /** 用户昵称 */
-  nickname: string;
-  /** 版本类型 */
-  type: Edition;
-  /** 版本展示类型（用于 UI 展示） */
-  editionType: EditionDisplayType;
-  /** 是否最后一次登录 */
-  lastLogin: boolean;
-  /** 企业ID */
-  enterpriseId?: string;
-  /** 企业名称 */
-  enterpriseName?: string;
-  /** 企业LOGO */
-  enterpriseLogo?: string;
-  /** 企业内用户名 */
-  enterpriseUserName?: string;
-  /** 插件是否启用 */
-  pluginEnabled?: boolean;
-  /** 部署状态 */
-  deployStatus?: DeployStatus;
-  /** 是否是 Pro 版本 */
-  isPro?: boolean;
-  /** 到期时间戳 */
-  expireAt?: string | number;
-  /** 自动续费标志 0-关闭 1-开启 */
-  renewFlag?: 0 | 1;
-  /** 套餐代码 */
-  PackageCode?: CommodityCode;
-  /** 套餐名称 */
-  name?: string;
-  email?: string;
+  getSandbox(): Sandbox;
+  read(path: string, opts?: FilesystemRequestOpts & {
+    format?: 'text';
+  }): Promise<string>;
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'bytes';
+  }): Promise<Uint8Array>;
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'blob';
+  }): Promise<Blob>;
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'stream';
+  }): Promise<ReadableStream<Uint8Array>>;
+  write(path: string, data: string | ArrayBuffer | Blob | ReadableStream, opts?: FilesystemRequestOpts): Promise<WriteInfo>;
+  write(files: WriteEntry[], opts?: FilesystemRequestOpts): Promise<WriteInfo[]>;
+  list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo$1[]>;
+  exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+  makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+  remove(path: string, opts?: FilesystemRequestOpts): Promise<void>;
+  rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  watchDir(path: string, onEvent: (event: FilesystemEvent$1) => void | Promise<void>, opts?: WatchOpts & {
+    onExit?: (err?: Error) => void | Promise<void>;
+  }): Promise<WatchHandle>;
 }
+//#endregion
+//#region ../agent-provider/lib/common/client/client.d.ts
 /**
- * 推理配置
+ * AgentClient - Session-centric client
+ *
+ * Provides a session-centric API that internally manages agents.
+ * Users interact with sessions; the agent lifecycle is handled internally.
+ *
+ * @example
+ * ```typescript
+ * // Create client with a provider
+ * const provider = new CloudAgentProvider({
+ *     endpoint: 'https://api.example.com',
+ *     authToken: 'token'
+ * });
+ *
+ * const client = new AgentClient({
+ *     provider,
+ *     logger: console
+ * });
+ *
+ * // List all sessions
+ * const sessions = await client.sessions.list();
+ *
+ * // Create new session (auto-creates agent and connects)
+ * const session = await client.sessions.create({ cwd: '/workspace' });
+ * console.log(session.agentState.status);  // agent status
+ * console.log(session.agentState.id);      // agent ID
+ *
+ * // Send prompt
+ * await session.prompts.send({ content: 'Hello' });
+ *
+ * // Get available models
+ * const models = await client.sessions.models.list('my-repo');
+ *
+ * // Use 'using' keyword for automatic cleanup
+ * {
+ *     using session = await client.sessions.create({ cwd: '/workspace' });
+ *     // ... use session
+ * } // session automatically disposed
+ *
+ * // Or manually disconnect
+ * session.disconnect();
+ *
+ * // Load existing session
+ * const loadedSession = await client.sessions.load({
+ *     sessionId: 'xxx',
+ *     cwd: '/workspace'
+ * });
+ * ```
  */
-interface ReasoningConfig {
-  /** 推理努力程度 */
-  effort: 'low' | 'medium' | 'high';
-  /** 摘要模式 */
-  summary: 'auto' | 'always' | 'never';
+declare class AgentClient {
+  private logger?;
+  private provider;
+  private sessionManager;
+  /**
+   * Sessions resource namespace (primary API entry point)
+   */
+  readonly sessions: ClientSessionsResource;
+  /**
+   * 运行环境类型
+   * - 'local': IDE 本地环境
+   * - 'cloud': 云端环境
+   */
+  readonly environmentType: 'local' | 'cloud';
+  constructor(options: AgentClientOptions);
+  private createSessionsResource;
+  private createModelsResource;
+  /**
+   * Dispose the client
+   *
+   * Note: Active sessions are not automatically disposed.
+   * The caller is responsible for disconnecting sessions they created.
+   */
+  dispose(): void;
 }
+//#endregion
+//#region ../agent-provider/lib/common/client/session.d.ts
 /**
- * 模型信息
+ * Filesystem getter function type
+ * Returns a FilesResource instance for file operations
  */
-interface ModelInfo {
-  /** 模型ID */
-  id: string;
-  /** 模型名称 */
-  name: string;
-  /** 供应商 */
-  vendor: string;
-  /** 最大输出 token 数 */
-  maxOutputTokens: number;
-  /** 最大输入 token 数 */
-  maxInputTokens: number;
-  /** 是否支持工具调用 */
-  supportsToolCall: boolean;
-  /** 是否支持图像 */
-  supportsImages: boolean;
-  /** 是否禁用多模态 */
-  disabledMultimodal: boolean;
-  /** 最大允许大小 */
-  maxAllowedSize: number;
-  /** 是否支持推理 */
-  supportsReasoning: boolean;
-  /** 是否仅推理模式 */
-  onlyReasoning: boolean;
-  /** 温度参数 */
-  temperature: number;
-  /** 推理配置 */
-  reasoning: ReasoningConfig;
-  /** 英文描述 */
-  descriptionEn: string;
-  /** 中文描述 */
-  descriptionZh: string;
-}
+type FilesystemGetter = () => Promise<FilesResource>;
 /**
- * GetModels 请求参数
+ * Options for creating an ActiveSessionImpl instance
  */
-interface GetModelsRequest {
-  /** 仓库路径 */
-  repository: string;
+interface ActiveSessionImplOptions {
+  /** Logger instance */
+  logger?: Logger;
+  /** Getter function for filesystem resource (provided by SessionManager) */
+  getFilesystem?: FilesystemGetter;
+  /** Session connection information (for cloud sessions) */
+  connectionInfo?: SessionConnectionInfo;
 }
 /**
- * GetModels 响应
+ * ActiveSessionImpl - Implements the ActiveSession interface
+ *
+ * This class wraps an AgentConnection and provides the session-centric API.
+ * It is created by SessionManager when creating or loading sessions.
+ *
+ * @example
+ * ```typescript
+ * // Created by client.sessions.new() or client.sessions.load()
+ * const session = await client.sessions.new({ cwd: '/workspace' });
+ *
+ * // Access agent state
+ * console.log(session.agentState.status);
+ *
+ * // Send prompt
+ * const response = await session.prompts.send({ content: 'Hello!' });
+ *
+ * // Cleanup
+ * session.disconnect();
+ * ```
  */
-interface GetModelsResponse {
-  /** 模型列表 */
-  models: ModelInfo[];
+declare class ActiveSessionImpl implements ActiveSession {
+  private _id;
+  private _agentId;
+  private _availableModes?;
+  private _currentMode?;
+  private _availableCommands;
+  private logger?;
+  private connection;
+  private _getFilesystem?;
+  private _connectionInfo?;
+  private listeners;
+  private onceListeners;
+  /**
+   * Agent operations namespace
+   */
+  readonly agent: SessionAgentOperations;
+  /**
+   * Prompts resource namespace
+   */
+  readonly prompts: PromptsResource;
+  /**
+   * Artifacts resource namespace
+   */
+  readonly artifacts: ArtifactsResource;
+  /**
+   * Files resource namespace (lazily loaded via getter)
+   */
+  readonly files: FilesResource;
+  /**
+   * Create an ActiveSessionImpl instance
+   *
+   * @param sessionId - Session ID
+   * @param agentId - Agent ID
+   * @param connection - Already connected AgentConnection
+   * @param options - Additional options
+   */
+  constructor(sessionId: string, agentId: string, connection: AgentConnection, options?: ActiveSessionImplOptions);
+  /**
+   * Session ID
+   */
+  get id(): string;
+  /**
+   * Agent ID
+   */
+  get agentId(): string;
+  /**
+   * Agent state (live connection state)
+   * Returns LocalAgentState or CloudAgentState based on transport type
+   */
+  get agentState(): AgentState;
+  /**
+   * Get agent capabilities (available after connection)
+   */
+  get capabilities(): AgentCapabilities | undefined;
+  /**
+   * Available session modes
+   */
+  get availableModes(): SessionMode[] | undefined;
+  /**
+   * Current session mode
+   */
+  get currentMode(): string | undefined;
+  /**
+   * Available slash commands
+   *
+   * When Agent sends available_commands_update, this list is automatically updated.
+   * Commands can be accessed directly without waiting for events.
+   */
+  get availableCommands(): AvailableCommand[];
+  /**
+   * Set available commands (called when available_commands_update is received)
+   */
+  setAvailableCommands(commands: AvailableCommand[]): void;
+  /**
+   * Check if the session is active
+   */
+  get isActive(): boolean;
+  /**
+   * Session connection information (only available for cloud sessions)
+   * 会话连接信息，包括sandboxId、link、token等
+   */
+  get connectionInfo(): SessionConnectionInfo | undefined;
+  /**
+   * Set session modes (called after create/load)
+   */
+  setModes(availableModes?: SessionMode[], currentMode?: string): void;
+  private createAgentOperations;
+  private createPromptsResource;
+  private createArtifactsResource;
+  /**
+   * Create files resource with lazy-loaded filesystem
+   *
+   * The filesystem is lazily loaded on first use to avoid unnecessary
+   * connections to the sandbox. The actual filesystem instance is obtained
+   * via the getter function provided by SessionManager.
+   */
+  private createFilesResource;
+  /**
+   * Resolve a permission request
+   */
+  resolvePermission(requestId: string, optionId: string): boolean;
+  /**
+   * Reject a permission request
+   */
+  rejectPermission(requestId: string, reason?: string): boolean;
+  /**
+   * Answer a question request with user's selections
+   */
+  answerQuestion(toolCallId: string, answers: QuestionAnswers): boolean;
+  /**
+   * Cancel a question request
+   */
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  /**
+   * Callback for tool operations (skip or cancel)
+   * @param toolCallId Tool call ID
+   * @param toolName Tool name
+   * @param action Action to perform ('skip' or 'cancel')
+   */
+  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * Set the current session mode
+   *
+   * @param modeId - The mode ID to switch to (must be in availableModes)
+   * @throws Error if modeId is not in availableModes or connection fails
+   *
+   * @example
+   * ```typescript
+   * // Switch to 'code' mode
+   * await session.setMode('code');
+   *
+   * // Switch to 'architect' mode
+   * await session.setMode('architect');
+   * ```
+   */
+  setMode(modeId: string): Promise<void>;
+  /**
+   * Set the current session model
+   *
+   * @param modelId - The model ID to switch to
+   * @example
+   * ```typescript
+   * // Switch to Claude Sonnet 4
+   * await session.setSessionModel('claude-sonnet-4-20250514');
+   *
+   * // Switch to GPT-4o
+   * await session.setSessionModel('gpt-4o');
+   * ```
+   */
+  setSessionModel(modelId: string): Promise<void>;
+  /**
+   * Subscribe to session events
+   */
+  on<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /**
+   * Unsubscribe from session events
+   */
+  off<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /**
+   * Subscribe to a session event once
+   */
+  once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /**
+   * Emit an event to all registered listeners
+   */
+  private emit;
+  /**
+   * Remove all listeners for an event
+   */
+  private removeAllListeners;
+  /**
+   * Disconnect from the session/agent
+   */
+  disconnect(): void;
+  /**
+   * Symbol.dispose for 'using' keyword support
+   * Automatically disconnects and cleans up when session goes out of scope
+   *
+   * @example
+   * ```typescript
+   * {
+   *     using session = await client.sessions.new({ cwd: '/workspace' });
+   *     // ... use session
+   * } // session automatically disposed
+   * ```
+   */
+  [Symbol.dispose](): void;
+  private getConnectionOrThrow;
+  private setupConnectionEvents;
+  private mapPromptResponse;
 }
+//#endregion
+//#region ../agent-provider/lib/common/client/session-manager.d.ts
 /**
- * Backend Provider 配置选项
+ * Options for creating a SessionManager instance
  */
-interface BackendProviderConfig {
-  /** API 基础 URL (例如: https://api.example.com) */
-  baseUrl: string;
-  /** 认证 Token */
-  authToken?: string;
+interface SessionManagerOptions {
+  /** Agent provider (required) */
+  provider: AgentProvider;
+  /** Logger instance */
+  logger?: Logger;
 }
 /**
- * IBackendProvider 接口
+ * SessionManager - Session lifecycle management
  *
- * 定义与后端 API 交互的抽象接口
+ * This class manages the relationship between sessions and agents.
+ * Since the backend is agent-centric, SessionManager handles the mapping:
+ * - Sessions are views over agents
+ * - sessionId may equal agentId in simple cases
+ *
+ * Features:
+ * - Session caching: reuses existing ActiveSession instances
+ * - Automatic cleanup on session disconnect
+ *
+ * @example
+ * ```typescript
+ * const manager = new SessionManager({ provider, logger });
+ *
+ * // List sessions
+ * const sessions = await manager.listSessions();
+ *
+ * // Create new session
+ * const session = await manager.createSession({ cwd: '/workspace' });
+ *
+ * // Load existing session (returns cached instance if available)
+ * const loaded = await manager.loadSession({ sessionId: 'xxx', cwd: '/workspace' });
+ * ```
  */
-interface IBackendProvider {
-  /**
-   * 获取 Agent 列表
-   * @param request 请求参数
-   * @returns Promise<GetAgentsResponse> Agent 列表响应
-   */
-  getAgents(request: GetAgentsRequest): Promise<GetAgentsResponse>;
-  /**
-   * 获取可用模型列表
-   * @param request 请求参数（包含仓库路径）
-   * @returns Promise<GetModelsResponse> 模型列表响应
-   */
-  getModels(request: GetModelsRequest): Promise<GetModelsResponse>;
+declare class SessionManager {
+  private provider;
+  private logger?;
+  constructor(options: SessionManagerOptions);
   /**
-   * 获取当前账号信息
-   * @returns Promise<Account | null> 账号信息，未登录时返回 null
+   * List all sessions with pagination info (mapped from agents)
+   *
+   * Each agent maps to a session. The sessionId is derived from the agent.
+   * Cloud: Returns server-side filtered/sorted/paginated results
+   * Local: Returns client-side filtered/sorted results (synthetic pagination)
+   *
+   * @param options - Optional query parameters for filtering, sorting, and pagination
    */
-  getAccount(): Promise<Account | null>;
+  listSessions(options?: ListAgentOptions): Promise<ListAgentResult<SessionInfo>>;
   /**
-   * 触发登录流程
-   * - Web 环境: 跳转到登录页面
-   * - IDE 环境: 通过 IPC 通知 IDE 打开登录流程
+   * Create a new session
+   *
+   * Steps:
+   * 1. Create new agent (if provider supports it) or use existing
+   * 2. Connect to agent
+   * 3. Call ACP newSession
+   * 4. Register session mapping (for LocalAgentProvider)
+   * 5. Return ActiveSession instance
    */
-  login(): Promise<void>;
+  createSession(params: CreateSessionParams$1): Promise<ActiveSession>;
   /**
-   * 登出账号
+   * Load an existing session
+   *
+   * Steps:
+   * 1. Check cache for existing session
+   * 2. Find agent by sessionId (sessionId === agentId in current design)
+   * 3. Connect to agent
+   * 4. Call ACP loadSession
+   * 5. Return ActiveSession instance (cached)
    */
-  logout(): Promise<void>;
+  loadSession(params: LoadSessionParams$1): Promise<ActiveSession>;
 }
 //#endregion
 //#region ../agent-provider/lib/backend/backend-provider.d.ts
@@ -2734,26 +3129,16 @@ interface IBackendProvider {
  * Backend Provider 实现类
  *
  * 职责：
- * - 与后端 API 通信（getAgents, getModels, getAccount 等）
  * - 触发登录/登出流程
  * - 获取 account 后自动同步到 accountService
+ *
+ * 注意：getAgents 和 getModels 方法已废弃并移除，
+ * 请使用 IAgentAdapter 中的对应方法
  */
 declare class BackendProvider implements IBackendProvider {
   private readonly baseUrl;
   private readonly authToken?;
   constructor(config: BackendProviderConfig);
-  /**
-   * 获取 Agent 列表
-   * API 端点: GET /v2/cloudagent/agentmgmt/agents
-   */
-  getAgents(request?: GetAgentsRequest): Promise<GetAgentsResponse>;
-  /**
-   * 获取可用模型列表
-   * API 端点: GET /v2/cloudagent/models (假设)
-   *
-   * 当前实现: 返回 Mock 数据
-   */
-  getModels(request: GetModelsRequest): Promise<GetModelsResponse>;
   /**
    * 获取当前账号信息
    * API 端点: GET /console/accounts (返回账号列表)
@@ -2768,12 +3153,82 @@ declare class BackendProvider implements IBackendProvider {
    * 5. 同步到 accountService
    */
   getAccount(): Promise<Account | null>;
+  /**
+   * 获取用户连接器列表
+   * API 端点: GET /console/as/connector/user/
+   */
+  getUserConnector(): Promise<ListUserConnectorResponse>;
+  /**
+   * 修改用户连接器连接状态
+   * API 端点: PATCH /console/as/connector/user/:name/connect_status
+   */
+  modifyUserConnectorConnectStatus(request: ModifyUserConnectorConnectStatusRequest): Promise<void>;
+  /**
+   * 修改用户连接器仓库
+   * API 端点: PATCH /console/as/connector/user/:name/repo/
+   */
+  modifyUserConnectorRepo(request: ModifyUserConnectorRepoRequest): Promise<void>;
+  /**
+   * 修改用户连接器激活状态
+   * API 端点: PATCH /console/as/connector/user/:name/active_status
+   */
+  modifyUserConnectorActiveStatus(request: ModifyUserConnectorActiveStatusRequest): Promise<void>;
+  /**
+   * 删除用户连接器
+   * API 端点: DELETE /console/as/connector/user/:name/
+   */
+  deleteUserConnector(name: 'github' | 'gongfeng'): Promise<void>;
+  /**
+   * 添加任务
+   * API 端点: POST /console/as/connector/task/
+   */
+  addConnectorTask(request: AddTaskRequest): Promise<AddTaskResponse>;
+  /**
+   * 获取任务连接器列表
+   * API 端点: GET /console/as/connector/task/:taskid
+   */
+  getTaskConnector(taskId: string): Promise<ListTaskConnectorResponse>;
+  /**
+   * 修改任务连接器激活状态
+   * API 端点: PATCH /console/as/connector/task/:taskid/active_status
+   */
+  modifyTaskConnectorActiveStatus(request: ModifyTaskConnectorActiveStatusRequest): Promise<ModifyTaskConnectorActiveStatusResponse>;
+  /**
+   * 修改任务连接器仓库
+   * API 端点: PATCH /console/as/connector/task/:taskid/repo
+   */
+  modifyTaskConnectorRepo(request: ModifyTaskConnectorRepoRequest): Promise<ModifyTaskConnectorRepoResponse>;
+  /**
+   * 根据账号类型获取用量信息并合并到账号中
+   * - 企业用户：调用 getEnterpriseUsage 获取月度限额
+   * - 个人用户：调用 getCurrentPlan 获取套餐信息
+   */
+  private enrichAccountWithUsage;
   /**
    * 获取当前套餐信息
    * 从计量计费接口获取用户的套餐信息
    * API: POST /billing/meter/get-user-resource
    */
   private getCurrentPlan;
+  /**
+   * 通过回调code，换token
+   * @param request
+   * @returns
+   */
+  saveOauthToken(request: SaveOauthTokenRequest): Promise<void>;
+  /**
+   * 获取OAuth连接器的仓库列表
+   */
+  getRepoList(request: GetRepoListRequest): Promise<GetRepoListResponse>;
+  /**
+   * 撤销OAuth连接器的所有连接
+   */
+  revokeAll(request: RevokeAllRequest): Promise<void>;
+  /**
+   * 获取 OAuth 用户信息
+   * API 端点: GET /console/as/connector/oauth/:name/oauthuser
+   */
+  getOauthUser(request: GetOauthUserRequest): Promise<GetOauthUserResponse>;
   /**
    * 根据账号类型和 Pro 状态计算版本展示类型
    * - personal + isPro = 'pro'
@@ -2789,9 +3244,20 @@ declare class BackendProvider implements IBackendProvider {
   login(): Promise<void>;
   /**
    * 登出账号
-   * Web 环境: 调用登出接口并清除本地状态
+   * Web 环境: 通过 iframe 访问登出 URL 清除 cookie
    */
   logout(): Promise<void>;
+  /**
+   * 批量切换插件状态
+   * Web 环境不支持此功能
+   */
+  batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
+  /**
+   * 获取企业用户用量信息
+   * API: POST /billing/meter/get-enterprise-user-usage
+   * 构建查询参数字符串
+   */
+  getEnterpriseUsage(enterpriseId: string): Promise<EnterpriseUsage | null>;
 }
 /**
  * 创建 BackendProvider 实例
@@ -2813,7 +3279,7 @@ interface IPCBackendProviderConfig {
 /**
  * IPC Backend Provider 实现类
  *
- * 通过 IWidgetChannel 与后端通信获取 Agent 列表
+ * 通过 IWidgetChannel 与后端通信
  */
 declare class IPCBackendProvider implements IBackendProvider {
   private readonly channel;
@@ -2828,20 +3294,75 @@ declare class IPCBackendProvider implements IBackendProvider {
    */
   private sendBackendRequest;
   /**
-   * 获取 Agent 列表
-   * 通过 IWidgetChannel 发送请求到后端
+   * 获取当前账号信息
+   * IDE 环境: 通过 IPC 获取账号信息，并同步到 accountService
    */
-  getAgents(request?: GetAgentsRequest): Promise<GetAgentsResponse>;
+  getAccount(): Promise<Account | null>;
   /**
-   * 获取可用模型列表
-   * 通过 IWidgetChannel 发送请求到后端
+   * 获取用户连接器列表
+   * IDE 环境: 通过 IPC 获取用户连接器列表
    */
-  getModels(request: GetModelsRequest): Promise<GetModelsResponse>;
+  getUserConnector(): Promise<ListUserConnectorResponse>;
   /**
-   * 获取当前账号信息
-   * IDE 环境: 通过 IPC 获取账号信息，并同步到 accountService
+   * 修改用户连接器连接状态
+   * IDE 环境: 通过 IPC 修改用户连接器连接状态
    */
-  getAccount(): Promise<Account | null>;
+  modifyUserConnectorConnectStatus(request: ModifyUserConnectorConnectStatusRequest): Promise<void>;
+  /**
+   * 修改用户连接器仓库
+   * IDE 环境: 通过 IPC 修改用户连接器仓库
+   */
+  modifyUserConnectorRepo(request: ModifyUserConnectorRepoRequest): Promise<void>;
+  /**
+   * 修改用户连接器激活状态
+   * IDE 环境: 通过 IPC 修改用户连接器激活状态
+   */
+  modifyUserConnectorActiveStatus(request: ModifyUserConnectorActiveStatusRequest): Promise<void>;
+  /**
+   * 删除用户连接器
+   * IDE 环境: 通过 IPC 删除用户连接器
+   */
+  deleteUserConnector(name: 'github' | 'gongfeng'): Promise<void>;
+  /**
+   * 添加任务
+   * IDE 环境: 通过 IPC 添加任务
+   */
+  addConnectorTask(request: AddTaskRequest): Promise<AddTaskResponse>;
+  /**
+   * 获取任务连接器列表
+   * IDE 环境: 通过 IPC 获取任务连接器列表
+   */
+  getTaskConnector(taskId: string): Promise<ListTaskConnectorResponse>;
+  /**
+   * 修改任务连接器激活状态
+   * IDE 环境: 通过 IPC 修改任务连接器激活状态
+   */
+  modifyTaskConnectorActiveStatus(request: ModifyTaskConnectorActiveStatusRequest): Promise<ModifyTaskConnectorActiveStatusResponse>;
+  /**
+   * 修改任务连接器仓库
+   * IDE 环境: 通过 IPC 修改任务连接器仓库
+   */
+  modifyTaskConnectorRepo(request: ModifyTaskConnectorRepoRequest): Promise<ModifyTaskConnectorRepoResponse>;
+  /**
+   * 获取 OAuth 用户信息
+   * IDE 环境: 通过 IPC 获取 OAuth 用户信息
+   */
+  getOauthUser(request: GetOauthUserRequest): Promise<GetOauthUserResponse>;
+  /**
+  * 通过回调code，换token
+  * IDE 环境: 通过 IPC 保存 OAuth Token
+  */
+  saveOauthToken(request: SaveOauthTokenRequest): Promise<void>;
+  /**
+   * 获取OAuth连接器的仓库列表
+   * IDE 环境: 通过 IPC 获取仓库列表
+   */
+  getRepoList(request: GetRepoListRequest): Promise<GetRepoListResponse>;
+  /**
+   * 撤销OAuth连接器的所有连接
+   * IDE 环境: 通过 IPC 撤销所有连接
+   */
+  revokeAll(request: RevokeAllRequest): Promise<void>;
   /**
    * 触发登录流程
    * IDE 环境: 通过 IPC 通知 IDE 打开登录流程
@@ -2852,6 +3373,19 @@ declare class IPCBackendProvider implements IBackendProvider {
    * IDE 环境: 通过 IPC 通知 IDE 登出
    */
   logout(): Promise<void>;
+  /**
+   * 重新加载窗口
+   * IDE 环境: 通过 IPC 通知 IDE 重新加载窗口（用于应用语言设置等）
+   * @param params 可选参数，如 locale
+   */
+  reloadWindow(params?: {
+    locale?: string;
+  }): Promise<void>;
+  /**
+   * 批量切换插件状态
+   * IDE 环境: 通过 IPC 调用 Extension Host 的 PluginService
+   */
+  batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
   /**
    * 调试日志
    */
@@ -2862,5 +3396,5 @@ declare class IPCBackendProvider implements IBackendProvider {
  */
 declare function createIPCBackendProvider(config: IPCBackendProviderConfig): IPCBackendProvider;
 //#endregion
-export { type Account, type AccountPlan, type ActiveSession, ActiveSessionImpl, type AgentCapabilities, AgentClient, type AgentClientOptions, type AgentConnection, type Agent as AgentInfo, type AgentProvider, type AgentState, type AgentStateType, type AgentStatus, type AgentTransport, type PromptResponse as ApiPromptResponse, type ArtifactsResource, BackendProvider, type BackendProviderConfig, type BaseAgentState, type BaseConnectionConfig, type CreateSessionParams as ClientCreateSessionParams, type CreateSessionParams, type LoadSessionParams as ClientLoadSessionParams, type LoadSessionParams, type ClientSessionsResource, CloudAgentConnection, CloudAgentProvider, type CloudAgentProviderOptions, type CloudAgentSourceInfo, type CloudAgentState, type CloudAgentTarget, type CloudAgentVisibility, type CloudConnectionConfig, type CommodityCode, type ConnectionEvents, type DeployStatus, E2BFilesystem, type E2BSandboxConnectionInfo, type Edition, type EditionDisplayType, type EntryInfo, type FilesResource, type Filesystem, type FilesystemListOpts, type FilesystemProvider, type FilesystemRequestOpts, type GetModelsRequest, type GetModelsResponse, type IBackendProvider, IPCBackendProvider, type ListAgentFilter, type ListAgentOptions, type ListAgentSort, type Logger, type McpServerConfig, type ModelInfo, type PromptContentBlock, type PromptParams, type PromptsResource, type ReasoningConfig, type Session, type SessionAgentOperations, type SessionConnectionInfo, type SessionEventHandler, type SessionEvents, type SessionInfo, SessionManager, type SessionMode, type WatchOpts, type WriteEntry, createBackendProvider, createIPCBackendProvider, isCloudAgentState };
+export { type Account, type AccountPlan, type ActiveSession, ActiveSessionImpl, type AgentCapabilities, AgentClient, type AgentClientOptions, type AgentConnection, type Agent as AgentInfo, type AgentProvider, type AgentState, type AgentStateType, type AgentStatus, type AgentTransport, type PromptResponse as ApiPromptResponse, type ArtifactsResource, BackendProvider, type BackendProviderConfig, type BaseAgentState, type BaseConnectionConfig, type CreateSessionParams as ClientCreateSessionParams, type CreateSessionParams, type LoadSessionParams as ClientLoadSessionParams, type LoadSessionParams, type ClientSessionsResource, CloudAgentConnection, CloudAgentProvider, type CloudAgentProviderOptions, type CloudAgentSourceInfo, type CloudAgentState, type CloudAgentTarget, type CloudAgentVisibility, type CloudConnectionConfig, type CommodityCode, type ConnectionEvents, type DeployStatus, E2BFilesystem, type E2BSandboxConnectionInfo, type Edition, type EditionDisplayType, type EntryInfo, type FilesResource, type Filesystem, type FilesystemListOpts, type FilesystemProvider, type FilesystemRequestOpts, type IBackendProvider, IPCBackendProvider, type ListAgentFilter, type ListAgentOptions, type ListAgentSort, type Logger, type McpServerConfig, type ModelInfo, type PromptContentBlock, type PromptParams, type PromptsResource, type ReasoningConfig, type Session, type SessionAgentOperations, type SessionConnectionInfo, type SessionEventHandler, type SessionEvents, type SessionInfo, SessionManager, type SessionMode, type WatchOpts, type WriteEntry, createBackendProvider, createIPCBackendProvider, isCloudAgentState };
 //# sourceMappingURL=index.d.cts.map