@tencent-ai/cloud-agent-sdk 0.2.13 → 0.2.14-next.17885cf.20260323

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { AgentCapabilities as AgentCapabilities$1, ClientCapabilities, InitializeResponse, LoadSessionResponse, NewSessionResponse, PromptResponse as PromptResponse$1, RequestPermissionRequest, RequestPermissionRequest as RequestPermissionRequest$1, SessionNotification, SessionNotification as SessionNotification$1, SetSessionModeResponse, SetSessionModelResponse } from "@agentclientprotocol/sdk";
-import { EntryInfo, EntryInfo as EntryInfo$1, Filesystem, FilesystemEvent, FilesystemEvent as FilesystemEvent$1, Sandbox, WatchHandle, WriteInfo } from "e2b";
+import { AgentCapabilities as AgentCapabilities$1, ClientCapabilities, InitializeResponse, LoadSessionResponse, NewSessionResponse, PromptResponse as PromptResponse$1, RequestPermissionRequest, RequestPermissionRequest as RequestPermissionRequest$1, SessionNotification, SessionNotification as SessionNotification$1, SetSessionModeResponse, SetSessionModelResponse, StopReason } from "@agentclientprotocol/sdk";
+import { Sandbox } from "e2b";
 
 //#region ../agent-client-protocol/lib/common/types.d.ts
 /**
@@ -235,6 +235,12 @@ interface CodebuddyClientMeta {
   artifacts?: ArtifactsConfig;
   /** Whether the client supports checkpoint notifications */
   checkpoint?: boolean;
+  /**
+   * Whether the client supports handling AskUserQuestion tool via extMethod.
+   * When true, AskUserQuestion requests will be sent to the client via
+   * the '_codebuddy.ai/question' extMethod instead of being handled locally.
+   */
+  question?: boolean;
 }
 /**
  * codebuddy.ai extension capabilities for Agent
@@ -339,6 +345,35 @@ interface ClientEvents extends Record<string, unknown> {
  */
 type QuestionAnswers = Record<string, string | string[]>;
 //#endregion
+//#region ../agent-client-protocol/lib/common/client/errors.d.ts
+/**
+ * Custom error classes for Streamable HTTP ACP Client
+ */
+/**
+ * Base error class for all ACP client errors
+ */
+declare class ACPClientError extends Error {
+  readonly code: string;
+  readonly cause?: Error;
+  constructor(message: string, code: string, cause?: Error);
+}
+/**
+ * Error thrown for session-related failures
+ */
+declare class SessionError extends ACPClientError {
+  readonly sessionId?: string;
+  /**
+   * Agent ID associated with the failed session operation.
+   * Available when session/new fails after agent creation + connection established.
+   * Can be used with `retryNewSession()` to recover from transient failures.
+   *
+   * @experimental This field is subject to change
+   */
+  readonly agentId?: string;
+  constructor(message: string, sessionId?: string, cause?: Error);
+  constructor(message: string, sessionId?: string, agentId?: string, cause?: Error);
+}
+//#endregion
 //#region ../agent-provider/lib/backend/service/oauth-repository-types.d.ts
 /**
  * OAuth Repository Types
@@ -727,6 +762,56 @@ interface ReasoningConfig {
   /** 摘要模式 */
   summary: 'auto' | 'always' | 'never';
 }
+/**
+ * 本地自定义模型配置
+ * 对应 ~/.codebuddy/models.json 中的单个模型定义
+ */
+interface LocalCustomModelConfig {
+  /** 模型唯一标识（同时作为请求时使用的 model 参数） */
+  id: string;
+  /** 模型展示名 */
+  name?: string;
+  /** 提供商名称 */
+  vendor?: string;
+  /** OpenAI 兼容接口地址（完整路径） */
+  url?: string;
+  /** API Key */
+  apiKey?: string;
+  /** 最大输入 token 数 */
+  maxInputTokens?: number;
+  /** 最大输出 token 数 */
+  maxOutputTokens?: number;
+  /** 温度 */
+  temperature?: number;
+  /** 是否支持工具调用 */
+  supportsToolCall?: boolean;
+  /** 是否支持图片输入 */
+  supportsImages?: boolean;
+  /** 是否支持推理 */
+  supportsReasoning?: boolean;
+}
+/**
+ * 获取本地自定义模型响应
+ */
+interface GetLocalCustomModelsResponse {
+  /** 用户级 models.json 中配置的模型列表 */
+  models: LocalCustomModelConfig[];
+  /** 原始 availableModels 配置 */
+  availableModels?: string[];
+  /** 配置文件路径 */
+  path: string;
+}
+/**
+ * 保存本地自定义模型请求
+ */
+interface SaveLocalCustomModelRequest {
+  /** 新模型配置 */
+  model: LocalCustomModelConfig;
+  /** 编辑时旧的模型 ID（用于重命名） */
+  previousId?: string;
+  /** 是否加入可见模型列表，默认 true */
+  visible?: boolean;
+}
 /**
  * 用户连接器信息
  */
@@ -995,6 +1080,57 @@ interface BackendProviderConfig {
   /** 认证 Token */
   authToken?: string;
 }
+/**
+ * 签到状态响应
+ */
+interface CheckinStatusResponse {
+  /** 活动是否开启 */
+  active: boolean;
+  /** 今天是否已签到 */
+  today_checked_in: boolean;
+  /** 当前连续签到天数 */
+  streak_days: number;
+  /** 普通日签 credit 数量 */
+  daily_credit: number;
+  /** 今天签到可获得的 credit 数量 */
+  today_credit: number;
+  /** 今天是否是连续签到奖励日 */
+  is_streak_day: boolean;
+  /** 距离下一个连续签到奖励日还需签到天数（0 表示今天就是） */
+  next_streak_day: number;
+  /** 签到日期列表（yyyy-MM-dd 格式） */
+  checkin_dates: string[];
+}
+/**
+ * 签到结果响应
+ */
+interface CheckinResultResponse {
+  /** 本次签到实际获得的 credit */
+  credit: number;
+  /** 签到后的连续签到天数 */
+  streak_days: number;
+  /** 本次签到是否为连续签到奖励日 */
+  is_streak_day: boolean;
+}
+/**
+ * 活动 Banner 响应
+ */
+interface ActivityBannerResponse {
+  /** 活动 ID */
+  id: string;
+  /** 活动是否开启 */
+  active: boolean;
+  /** Banner 文案内容 */
+  bannerContent: string;
+  /** 详情链接 */
+  link: string;
+  /** 活动优先级 */
+  level: number;
+  /** 活动开始时间（格式："2026-03-20 00:00:00"，不存在则视为已开始） */
+  startTime?: string;
+  /** 活动结束时间（格式："2026-04-20 23:59:59"，不存在则视为永不过期） */
+  endTime?: string;
+}
 /**
  * 企业用户用量信息
  */
@@ -1122,6 +1258,14 @@ interface IBackendProvider {
   reloadWindow?(params?: {
     locale?: string;
   }): Promise<void>;
+  /**
+   * Save locale to argv.json without restarting the app (optional, IPC only).
+   * The change takes effect on next manual restart.
+   * @param params locale to save
+   */
+  saveLocale?(params: {
+    locale: string;
+  }): Promise<void>;
   /**
    * 关闭 Agent Manager 面板（可选，仅 IPC 环境支持）
    * 用于 Local 模式下点击 Logo 返回 IDE
@@ -1133,6 +1277,24 @@ interface IBackendProvider {
    * @param url 要打开的 URL
    */
   openExternal?(url: string): Promise<void>;
+  /**
+   * 打开本地文件（可选，仅 IPC 环境支持）
+   * 用于 Local 模式下打开本地配置文件
+   * @param filePath 要打开的文件路径
+   */
+  openLocalFile?(filePath: string): Promise<void>;
+  /**
+   * 获取用户级本地自定义模型列表（可选，仅 IPC 环境支持）
+   */
+  getLocalCustomModels?(): Promise<GetLocalCustomModelsResponse>;
+  /**
+   * 保存用户级本地自定义模型（可选，仅 IPC 环境支持）
+   */
+  saveLocalCustomModel?(request: SaveLocalCustomModelRequest): Promise<GetLocalCustomModelsResponse>;
+  /**
+   * 删除用户级本地自定义模型（可选，仅 IPC 环境支持）
+   */
+  deleteLocalCustomModel?(id: string): Promise<GetLocalCustomModelsResponse>;
   /**
    * 监听事件（可选，用于 IPC 环境）
    * @param event 事件名称
@@ -1145,6 +1307,27 @@ interface IBackendProvider {
    * @returns Promise<EnterpriseUsage | null> 企业用户用量信息
    */
   getEnterpriseUsage?(enterpriseId: string): Promise<EnterpriseUsage | null>;
+  /**
+   * 获取账号用量信息（积分/Credits）
+   * 实时获取，每次打开菜单时调用，不依赖 getAccount 缓存
+   * @returns Promise<Partial<Account> | null> 包含 usageLeft, usageTotal, refreshAt 等字段
+   */
+  getAccountUsage?(): Promise<Partial<Account> | null>;
+  /**
+   * 获取每日签到状态
+   * @returns Promise<CheckinStatusResponse | null> 签到状态，失败时返回 null
+   */
+  getCheckinStatus?(): Promise<CheckinStatusResponse | null>;
+  /**
+   * 执行每日签到
+   * @returns Promise<CheckinResultResponse> 签到结果
+   */
+  claimDailyCheckin?(): Promise<CheckinResultResponse>;
+  /**
+   * 获取活动 Banner
+   * @returns Promise<ActivityBannerResponse | null> 活动 Banner 信息，失败时返回 null
+   */
+  getActivityBanner?(): Promise<ActivityBannerResponse | null>;
   /**
    * 刷新 Token（可选）
    * 通过调用 getAccount 刷新 cookie
@@ -1173,6 +1356,175 @@ interface IBackendProvider {
    * @returns Promise<ListReposResponse> 仓库列表响应
    */
   getRepositories?(connector: OauthConnectorName, page?: number, perPage?: number): Promise<ListReposResponse>;
+  /**
+   * 保存待发送的输入内容到后端（用于跨域登录场景）
+   * API 端点: POST /api/v1/code-id
+   *
+   * @param code 要保存的文本内容
+   * @returns Promise<string | null> 返回 codeId，失败返回 null
+   */
+  savePendingInput?(code: string): Promise<string | null>;
+  /**
+   * 从后端加载待发送的输入内容（用于跨域登录场景）
+   * API 端点: GET /api/v1/code?id=xxx
+   *
+   * @param codeId 内容 ID
+   * @returns Promise<string | null> 返回保存的文本内容，失败返回 null
+   */
+  loadPendingInput?(codeId: string): Promise<string | null>;
+  /**
+   * 获取 SkillHub 技能列表（分页）
+   * @param params 分页/过滤参数
+   * @returns Promise<SkillHubListResponse>
+   */
+  getSkillHubList?(params?: SkillHubListParams): Promise<SkillHubListResponse>;
+  /**
+   * 获取 SkillHub 分类列表
+   * @returns Promise<SkillHubCategoriesResponse>
+   */
+  getSkillHubCategories?(): Promise<SkillHubCategoriesResponse>;
+  /**
+   * 搜索 SkillHub 技能
+   * @param q 搜索关键词
+   * @param limit 结果数量限制
+   * @returns Promise<SkillHubSearchResponse>
+   */
+  getSkillHubSearch?(q: string, limit?: number): Promise<SkillHubSearchResponse>;
+  /**
+   * 获取 SkillHub 技能详情
+   * @param slug 技能唯一标识
+   * @returns Promise<SkillHubDetailResponse>
+   */
+  getSkillHubDetail?(slug: string): Promise<SkillHubDetailResponse>;
+  /**
+   * 批量检查 SkillHub 技能是否存在
+   * @param slugs 技能标识列表
+   * @returns Promise<SkillHubExistsResponse>
+   */
+  getSkillHubExists?(slugs: string[]): Promise<SkillHubExistsResponse>;
+  /**
+   * 上报 SkillHub 技能统计
+   * @param slug 技能标识
+   * @param inc 增量统计
+   */
+  reportSkillHubStats?(slug: string, inc: {
+    downloads?: number;
+    installs?: number;
+    stars?: number;
+  }): Promise<void>;
+  /**
+   * 安装 SkillHub 技能（下载 zip → 解压到本地）
+   * @param slug 技能标识
+   * @param version 版本号
+   * @param name 原始显示名称（保留大小写）
+   * @returns Promise<SkillHubInstallResponse>
+   */
+  installSkillHubSkill?(slug: string, version?: string, name?: string): Promise<SkillHubInstallResponse>;
+  /**
+   * 获取本地已安装的 SkillHub 技能元信息
+   * @returns Promise<SkillHubInstalledMeta[]>
+   */
+  getSkillHubInstalledMetas?(): Promise<SkillHubInstalledMeta[]>;
+}
+interface SkillHubSkill {
+  slug: string;
+  ownerName: string;
+  category: string;
+  name: string;
+  description: string;
+  description_zh: string;
+  version: string;
+  homepage: string;
+  tags: string[];
+  downloads: number;
+  stars: number;
+  installs: number;
+  updated_at: number;
+  score: number;
+  /** Optional source marker used in merged search results */
+  _source?: 'recommend' | 'skillhub';
+}
+interface SkillHubListResponse {
+  code: number;
+  message: string;
+  data: {
+    total: number;
+    skills: SkillHubSkill[];
+  };
+}
+interface SkillHubCategory {
+  key: string;
+  name: string;
+  nameEn: string;
+  sortOrder: number;
+  active: boolean;
+}
+interface SkillHubCategoriesResponse {
+  items: SkillHubCategory[];
+  count: number;
+}
+interface SkillHubSearchResult {
+  score: number;
+  slug: string;
+  displayName: string;
+  summary: string;
+  version: string;
+  updatedAt: number;
+}
+interface SkillHubSearchResponse {
+  results: SkillHubSearchResult[];
+}
+interface SkillHubDetailResponse {
+  skill: {
+    slug: string;
+    category: string;
+    displayName: string;
+    summary: string;
+    summary_zh: string;
+    tags: Record<string, string>;
+    stats: {
+      downloads: number;
+      stars: number;
+      installs: number;
+      versions: number;
+      comments: number;
+    };
+    createdAt: number;
+    updatedAt: number;
+  };
+  latestVersion: {
+    version: string;
+    createdAt: number;
+    changelog: string;
+  };
+  owner: {
+    handle: string;
+    displayName: string;
+    image: string | null;
+  };
+}
+interface SkillHubExistsResponse {
+  exists: Record<string, boolean>;
+  count: number;
+}
+interface SkillHubInstallResponse {
+  success: boolean;
+  skillName: string;
+  errorMessage?: string;
+}
+interface SkillHubInstalledMeta {
+  slug: string;
+  version: string | null;
+  installedAt?: number;
+}
+type SkillHubSortBy = 'score' | 'downloads' | 'updated_at' | 'installs';
+interface SkillHubListParams {
+  page?: number;
+  pageSize?: number;
+  sortBy?: SkillHubSortBy;
+  order?: 'asc' | 'desc';
+  keyword?: string;
+  category?: string;
 }
 /**
  * 场景中的插件信息
@@ -1186,6 +1538,12 @@ interface ScenePlugin {
   /** 插件市场名称 */
   marketplaceName: string;
 }
+/**
+ * 场景模式类型
+ * - coding: 编程相关场景
+ * - working: 工作/通用场景
+ */
+type SupportSceneMode = 'coding' | 'working';
 /**
  * 支持的场景信息
  * 用于 Welcome 页面的 QuickActions 快捷操作
@@ -1200,11 +1558,15 @@ interface SupportScene {
   plugins: ScenePlugin[];
   /** 场景对应的 prompt 列表 */
   prompts: string[];
+  /** 场景模式类型 */
+  mode?: SupportSceneMode;
 }
 /**
  * 插件作用域
+ * 使用 agent-craft 的 PluginInstallScope 类型
+ * 注意: 当前后端 API 只支持 user 和 project,暂不支持 project-local
  */
-type PluginScope = 'user' | 'project';
+type PluginScope = 'user' | 'project' | 'project-local' | 'local';
 /**
  * 插件操作类型
  */
@@ -1314,6 +1676,71 @@ interface AvailableCommand {
 }
 //#endregion
 //#region ../agent-provider/lib/common/types.d.ts
+/**
+ * File type enumeration
+ * Compatible with e2b SDK FileType
+ */
+declare enum FileType {
+  FILE = "file",
+  DIR = "dir"
+}
+/**
+ * Filesystem event type enumeration
+ * Compatible with e2b SDK FilesystemEventType
+ */
+declare enum FilesystemEventType {
+  CHMOD = "chmod",
+  CREATE = "create",
+  REMOVE = "remove",
+  RENAME = "rename",
+  WRITE = "write"
+}
+/**
+ * File or directory entry information
+ * Compatible with e2b SDK EntryInfo
+ */
+interface EntryInfo {
+  name: string;
+  type: FileType;
+  path: string;
+  size: number;
+  mode: number;
+  permissions: string;
+  owner: string;
+  group: string;
+  modifiedTime?: Date;
+  symlinkTarget?: string;
+}
+/**
+ * Write operation result
+ * Compatible with e2b SDK WriteInfo
+ */
+interface WriteInfo {
+  path: string;
+  type: FileType;
+  name: string;
+}
+/**
+ * Filesystem watch event
+ * Compatible with e2b SDK FilesystemEvent
+ */
+interface FilesystemEvent {
+  name: string;
+  type: FilesystemEventType;
+}
+/**
+ * Handle for stopping a directory watch
+ * Compatible with e2b SDK WatchHandle
+ */
+interface WatchHandle {
+  stop(): Promise<void>;
+}
+/**
+ * @deprecated Use the standalone type definitions above instead.
+ * This type alias is kept for backward compatibility with code that
+ * imported `Filesystem` type from this module.
+ */
+type Filesystem = FilesResource;
 /**
  * Base options for filesystem operations
  * 对齐 e2b SDK FilesystemRequestOpts
@@ -1397,7 +1824,7 @@ interface FilesResource {
   /** Write multiple files in batch */
   write(files: WriteEntry[], opts?: FilesystemRequestOpts): Promise<WriteInfo[]>;
   /** List directory contents with optional depth */
-  list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo$1[]>;
+  list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo[]>;
   /** Check if path exists */
   exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
   /** Create directory */
@@ -1405,9 +1832,9 @@ interface FilesResource {
   /** Remove file or directory */
   remove(path: string, opts?: FilesystemRequestOpts): Promise<void>;
   /** Rename/move file or directory */
-  rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
   /** Get file or directory information */
-  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
   /** Watch directory for changes */
   watchDir(path: string, onEvent: (event: FilesystemEvent) => void | Promise<void>, opts?: WatchOpts & {
     onExit?: (err?: Error) => void | Promise<void>;
@@ -1510,7 +1937,7 @@ type PromptContentBlock = {
   uri: string;
   mimeType?: string | null;
   name: string;
-  size?: bigint | null;
+  size?: number | null;
   title?: string | null;
   _meta?: {
     [key: string]: unknown;
@@ -1616,13 +2043,22 @@ interface AgentConnection {
    * @param sessionId 会话 ID
    * @param toolCallId 工具调用 ID
    * @param toolName 工具名称
-   * @param action 操作类型 ('skip' | 'cancel')
+   * @param action 操作类型 ('approve' | 'skip' | 'cancel')
    */
-  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'approve' | 'skip' | 'cancel'): Promise<{
     success: boolean;
     error?: string;
   }>;
   extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+  /**
+   * Report telemetry event through the standard provider chain
+   * - Local: via ACP JSON-RPC → IDE EventService
+   * - Cloud: via StreamableHTTP → cloud telemetry endpoint
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data (already includes mode)
+   */
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): Promise<void>;
 }
 /**
  * Base configuration for connections
@@ -1830,6 +2266,8 @@ interface BaseAgentState {
   updatedAt?: Date;
   /** 是否为 playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * LocalAgentState - 本地 Agent 状态
@@ -1893,6 +2331,11 @@ interface ListAgentSort {
  * Local: Client-side filtering and sorting, no pagination (returns all)
  */
 interface ListAgentOptions {
+  /**
+   * User ID for filtering sessions (required for multi-user isolation)
+   * If not provided, returns empty list for Local provider
+   */
+  userId?: string;
   /**
    * Page number (starts from 1)
    * Cloud: Used for API pagination
@@ -1970,22 +2413,46 @@ interface SessionInfo {
   status: AgentStatus;
   /** When the session/agent was created */
   createdAt?: Date;
+  /** When the session/agent was last updated */
+  updatedAt?: Date;
   /** Last activity timestamp */
   lastActivityAt?: Date;
   /** Working directory (for local agents) */
   cwd?: string;
   /** Whether the session is a playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * Parameters for creating a new session
  */
 interface CreateSessionParams$1 {
-  /** Working directory */
+  /** Working directory (required) */
   cwd: string;
+  /** Optional configuration */
+  options?: CreateSessionOptions;
+}
+/**
+ * Optional configuration for creating a session
+ */
+interface CreateSessionOptions {
   /** MCP server configurations */
   mcpServers?: McpServerConfig[];
+  /** Initial prompt for the session (Cloud only) */
+  prompt?: string;
+  /** Initial model for the session (Cloud only) */
+  model?: string;
+  /** Mode ID (e.g., 'craft', 'architect') */
+  mode?: string;
+  /** Whether this is a playground session (no cwd) */
+  isPlayground?: boolean;
+  /** Tags for template scenes (Cloud only, format: { scene: 'xxx' }) */
+  tags?: Record<string, string>;
+  /** Additional metadata */
   _meta?: Record<string, unknown>;
+  /** Callback when session is prepared (POST succeeded, before WebSocket connect) */
+  onSessionPrepared?: (sessionInfo: SessionInfo) => void;
 }
 /**
  * Parameters for loading an existing session
@@ -2020,6 +2487,84 @@ interface InitializeWorkspaceResponse {
   /** Error message (if failed) */
   error?: string;
 }
+type AutomationStatus = 'ACTIVE' | 'PAUSED';
+type AutomationUpdateMode = 'view' | 'suggested create' | 'suggested update';
+type AutomationRunStatus = 'ACCEPTED' | 'ARCHIVED' | 'PENDING_REVIEW' | 'IN_PROGRESS';
+interface AutomationDefinition {
+  version: number;
+  id: string;
+  name: string;
+  prompt: string;
+  status: AutomationStatus;
+  rrule: string;
+  cwds: string[];
+  modelId?: string;
+  modelIsThinking?: boolean;
+  created_at: number;
+  updated_at: number;
+}
+interface AutomationCwdRunResult {
+  cwd: string;
+  success: boolean;
+  startedAt: number;
+  finishedAt: number;
+  conversationId?: string;
+  output?: string;
+  error?: string;
+}
+interface AutomationInboxItem {
+  id: string;
+  automationId: string;
+  automationName: string;
+  status?: AutomationRunStatus;
+  readAt?: number;
+  startedAt: number;
+  finishedAt: number;
+  success: boolean;
+  summary: string;
+  runs: AutomationCwdRunResult[];
+  archived?: boolean;
+  archivedAt?: number;
+}
+interface AutomationRuntimeState {
+  lastRunAt?: number;
+  lastError?: string;
+  running?: boolean;
+  runningStartedAt?: number;
+  runningConversationId?: string;
+}
+interface AutomationSnapshot {
+  automations: AutomationDefinition[];
+  inbox: AutomationInboxItem[];
+  runtimeState: Record<string, AutomationRuntimeState>;
+  updatedAt: number;
+}
+interface AutomationUpdatePayload {
+  mode: AutomationUpdateMode;
+  id?: string;
+  name?: string;
+  prompt?: string;
+  rrule?: string;
+  cwds?: string[] | string;
+  status?: AutomationStatus;
+  modelId?: string;
+  modelIsThinking?: boolean;
+}
+interface AutomationUpdateResult {
+  success: boolean;
+  message: string;
+  automation?: AutomationDefinition;
+  snapshot?: AutomationSnapshot;
+}
+/**
+ * Parameters for getting available commands
+ */
+interface GetAvailableCommandsParams {
+  /** Session ID to get commands for (optional, for global commands) */
+  sessionId?: string;
+  /** Workspace path for getting custom commands (optional) */
+  workspacePath?: string;
+}
 /**
  * Prompts resource interface (ACP verbs)
  * Operations use the current session automatically
@@ -2057,7 +2602,7 @@ interface ModelsResource {
  */
 interface PromptResponse {
   /** Stop reason */
-  stopReason: 'end_turn' | 'max_tokens' | 'tool_use' | 'cancelled' | 'error';
+  stopReason: StopReason;
   /** Response metadata */
   _meta?: Record<string, unknown>;
 }
@@ -2067,7 +2612,7 @@ interface PromptResponse {
 interface SessionsResourceEvents {
   /** Emitted when the sessions list changes (create, delete, update) */
   sessionsChanged: SessionInfo[];
-  /** Emitted when a new session is created */
+  /** Emitted when a new session is fully connected and ready */
   sessionCreated: SessionInfo;
   /** Emitted when a session is deleted */
   sessionDeleted: {
@@ -2075,6 +2620,17 @@ interface SessionsResourceEvents {
   };
   /** Emitted when a session is updated (status change, etc.) */
   sessionUpdated: SessionInfo;
+  /** Emitted when automation snapshot is updated (pushed from server) */
+  automationSnapshotUpdate: AutomationSnapshot;
+  /** Emitted when plugins or marketplaces change (install/uninstall/add/remove/update) */
+  pluginsChanged: {
+    newMarketplaceName?: string;
+  } | undefined;
+  /** Emitted when ProductConfiguration changes (account switch, config sync, etc.) */
+  productConfigChanged: {
+    timestamp: number;
+    productFeatures: Record<string, boolean>;
+  };
 }
 /**
  * Event handler type for sessions resource events
@@ -2151,6 +2707,8 @@ interface ActiveSession {
   readonly id: string;
   /** Agent ID */
   readonly agentId: string;
+  /** Actual workspace path (set after newSession, useful for Playground scenario) */
+  readonly cwd?: string;
   /** Agent state (direct access to underlying agent state) */
   readonly agentState: AgentState;
   /** Agent capabilities (available after connection) */
@@ -2188,8 +2746,8 @@ interface ActiveSession {
   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<{
+  /** Callback for tool operations (approve / skip / cancel) */
+  toolCallback(toolCallId: string, toolName: string, action: 'approve' | 'skip' | 'cancel'): Promise<{
     success: boolean;
     error?: string;
   }>;
@@ -2211,6 +2769,12 @@ interface ActiveSession {
   once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
   /** Disconnect from the session/agent */
   disconnect(): void;
+  /**
+   * Detach the session from connection events without disconnecting the connection.
+   * This should be called when the session is being replaced but the connection is shared.
+   * Unlike disconnect(), this only removes event listeners without closing the connection.
+   */
+  detach(): void;
   /** Symbol.dispose for 'using' keyword support */
   [Symbol.dispose](): void;
 }
@@ -2275,6 +2839,17 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
   rename?(agentId: string, title: string): Promise<{
     id: string;
   }>;
+  /**
+   * Update agent status by ID (optional)
+   * Used by CloudAgentProvider for updating session status
+   *
+   * @param agentId - Agent ID to update
+   * @param status - New status for the agent
+   * @returns Object containing the updated agent ID
+   */
+  updateStatus?(agentId: string, status: string): Promise<{
+    id: string;
+  }>;
   /**
    * Move an agent by ID (optional)
    * Used by LocalAgentProvider for moving Playground sessions to Workspace
@@ -2294,6 +2869,36 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @returns Array of model information
    */
   getModels?(repo?: string): Promise<ModelInfo[]>;
+  /**
+   * Get product configuration subset (optional)
+   * Returns deploymentType, creditPurchaseActions, links, networkEnvironment, productFeatures
+   */
+  getProductConfiguration?(): Promise<{
+    deploymentType?: string;
+    creditPurchaseActions?: Record<string, {
+      labelZh: string;
+      labelEn: string;
+      url: string;
+      showButton?: boolean;
+    }>;
+    links?: {
+      craftFeedback?: string;
+      mcpMarketUrl?: string;
+      mcpDocumentUrl?: string;
+      helpDocument?: string;
+    };
+    networkEnvironment?: string;
+    productFeatures?: Record<string, boolean>;
+    customModelSettings?: unknown;
+    skillScanDirs?: string[];
+  }>;
+  /**
+   * Get user info (optional)
+   * Returns enterpriseId from authentication session
+   */
+  getUserInfo?(): Promise<{
+    enterpriseId?: string;
+  }>;
   /**
    * Register sessionId → agentId mapping (optional, used by LocalAgentProvider)
    * Called after session creation to maintain the mapping for loadSession
@@ -2309,6 +2914,8 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @returns Response with success status
    */
   openWorkspace?(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  /** Request yielding after current step for a running session (optional, used by LocalAgentProvider) */
+  requestYieldAfterCurrentStep?(sessionId: string): Promise<boolean>;
   /**
    * Pick files from file dialog (optional, used by LocalAgentProvider)
    *
@@ -2344,6 +2951,61 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @returns Response with subagent list
    */
   getSubagentList?(params: GetSubagentListParams): Promise<GetSubagentListResponse>;
+  /**
+   * Get skill list (optional, used by LocalAgentProvider)
+   *
+   * @param params - Query parameters
+   * @returns Response with skill list
+   */
+  getSkillList?(params?: GetSkillListParams): Promise<GetSkillListResponse>;
+  /**
+   * Import a skill folder (optional, used by LocalAgentProvider)
+   *
+   * @param params - Import parameters including source location
+   * @returns Response with import result
+   */
+  importSkill?(params: ImportSkillParams): Promise<ImportSkillResponse>;
+  /**
+   * Get skill content by file path (optional, used by LocalAgentProvider)
+   *
+   * @param params - Parameters including skill file path
+   * @returns Response with skill content
+   */
+  getSkillContent?(params: GetSkillContentParams): Promise<GetSkillContentResponse>;
+  /**
+   * Get marketplace skills list (optional, used by LocalAgentProvider)
+   *
+   * @returns Response with marketplace skill list
+   */
+  getMarketplaceSkills?(): Promise<GetMarketplaceSkillsResponse>;
+  /**
+   * Get marketplace skill content (optional, used by LocalAgentProvider)
+   *
+   * @param params - Parameters including skill name
+   * @returns Response with skill content
+   */
+  getMarketplaceSkillContent?(params: GetMarketplaceSkillContentParams): Promise<GetMarketplaceSkillContentResponse>;
+  /**
+   * Install marketplace skill to user directory (optional, used by LocalAgentProvider)
+   *
+   * @param params - Parameters including skill name
+   * @returns Response with install result
+   */
+  installMarketplaceSkill?(params: InstallMarketplaceSkillParams): Promise<InstallMarketplaceSkillResponse>;
+  /**
+   * Toggle skill enable/disable state (optional, used by LocalAgentProvider)
+   *
+   * @param params - Toggle parameters including filePath and disable state
+   * @returns Response with toggle result
+   */
+  toggleSkill?(params: ToggleSkillParams): Promise<ToggleSkillResponse>;
+  /**
+   * Delete a skill (optional, used by LocalAgentProvider)
+   *
+   * @param params - Delete parameters including filePath and name
+   * @returns Response with delete result
+   */
+  deleteSkill?(params: DeleteSkillParams): Promise<DeleteSkillResponse>;
   /**
    * Batch toggle plugins (optional, used by LocalAgentProvider)
    *
@@ -2364,6 +3026,9 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
     description?: string;
     version?: string;
     installScope?: 'user' | 'project';
+    installedScopes?: Array<'user' | 'project' | 'local' | 'project-local'>;
+    installedScopesStatus?: Record<string, boolean>;
+    installId?: string;
   }>>;
   /**
    * Install plugins (optional, used by LocalAgentProvider)
@@ -2374,7 +3039,7 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param marketplaceSource - Marketplace source URL (for auto-adding marketplace when not exists)
    * @returns Result of the operation
    */
-  installPlugins?(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string): Promise<{
+  installPlugins?(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string, workspacePath?: string): Promise<{
     success: boolean;
     error?: string;
   }>;
@@ -2383,10 +3048,34 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * If session.availableCommands has cached values, return them
    * Otherwise, fetch from product configuration
    *
-   * @param sessionId - Session ID to get commands for (optional, for global commands)
+   * @param params - Parameters for getting commands
    * @returns Array of available commands
    */
-  getAvailableCommands?(sessionId?: string): Promise<AvailableCommand[]>;
+  getAvailableCommands?(params?: GetAvailableCommandsParams): Promise<AvailableCommand[]>;
+  /**
+   * Get automation snapshot (optional, used by LocalAgentProvider)
+   */
+  getAutomationSnapshot?(): Promise<AutomationSnapshot>;
+  /**
+   * Create/update automation definition (optional, used by LocalAgentProvider)
+   */
+  updateAutomation?(payload: AutomationUpdatePayload): Promise<AutomationUpdateResult>;
+  /**
+   * Delete automation definition (optional, used by LocalAgentProvider)
+   */
+  deleteAutomation?(id: string): Promise<AutomationUpdateResult>;
+  /**
+   * Archive an automation inbox item (optional, used by LocalAgentProvider)
+   */
+  archiveAutomationInboxItem?(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Delete an automation inbox item (optional, used by LocalAgentProvider)
+   */
+  deleteAutomationInboxItem?(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Trigger test run for automation (optional, used by LocalAgentProvider)
+   */
+  testAutomation?(id: string): Promise<AutomationUpdateResult>;
   /**
    * Register an event listener
    * Provider implementations should forward events to the underlying transport
@@ -2402,46 +3091,187 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param handler - Event handler function to remove
    */
   off?(event: string, handler: (...args: any[]) => void): void;
-}
-/**
- * AgentClient initialization options
- */
-interface AgentClientOptions {
-  /** Agent provider (required) */
-  provider: AgentProvider;
-  /** Logger instance */
-  logger?: Logger;
-  /** Client capabilities (sent during initialization) */
-  clientCapabilities?: ClientCapabilities$1;
   /**
-   * 运行环境类型
-   * - 'local': IDE 本地环境
-   * - 'cloud': 云端环境
+   * Report telemetry event through the provider chain
+   * - Local: via ACP JSON-RPC → AcpAgent → IDE EventService
+   * - Cloud: via connection → cloud endpoint
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data
    */
-  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 {
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): 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)
+   * Respond to MCP Sampling confirmation request (optional, used by LocalAgentProvider)
+   * Called when user confirms/rejects a sampling request
+   *
+   * @param sessionId - Session ID
+   * @param response - Sampling confirmation response
    */
-  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>;
+  respondToSampling?(sessionId: string, response: McpSamplingConfirmResponse): Promise<void>;
+  /**
+   * Respond to MCP Roots confirmation request (optional, used by LocalAgentProvider)
+   * Called when user confirms/rejects a roots request
+   *
+   * @param sessionId - Session ID
+   * @param response - Roots confirmation response
+   */
+  respondToRoots?(sessionId: string, response: McpRootsConfirmResponse): Promise<void>;
+  /**
+   * Subscribe to MCP Sampling confirmation requests (optional, used by LocalAgentProvider)
+   * Called when MCP server initiates a sampling request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeSamplingRequests?(serverName: string, callback: (request: McpSamplingConfirmRequest) => void): () => void;
+  /**
+   * Subscribe to MCP Roots confirmation requests (optional, used by LocalAgentProvider)
+   * Called when MCP server initiates a roots request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeRootsRequests?(serverName: string, callback: (request: McpRootsConfirmRequest) => void): () => void;
+  /**
+   * Get product scenes from ProductManager configuration (optional, for LocalAgentProvider)
+   * 从 ProductManager.waitConfiguration().scenes 获取本地配置的场景数据
+   * @param locale - 可选，语言环境
+   */
+  getProductScenes?(locale?: string): Promise<Array<{
+    id: number;
+    name: string;
+    plugins: Array<{
+      id: number;
+      name: string;
+      marketplaceName: string;
+    }>;
+    prompts: string[];
+    mode?: 'coding' | 'working';
+    target?: 'local' | 'cloud' | 'all';
+  }>>;
+  /**
+   * Get all MCP servers with their status and tools (optional, used by LocalAgentProvider)
+   * Returns the list of configured MCP servers from McpServerManager
+   *
+   * @returns Array of MCP server information
+   */
+  getMcpServers?(): Promise<Array<{
+    id: string;
+    name: string;
+    status: 'connecting' | 'connected' | 'disconnected' | 'disabled';
+    description?: string;
+    tools?: Array<{
+      name: string;
+      description?: string;
+      enabled?: boolean;
+    }>;
+    disabled?: boolean;
+    error?: string;
+    logoUrl?: string;
+    officialUrl?: string;
+    configSource?: 'user' | 'project' | 'plugin';
+  }>>;
+  /**
+   * Toggle MCP server enabled/disabled state (optional, used by LocalAgentProvider)
+   *
+   * @param serverName - Name of the MCP server to toggle
+   * @param enabled - Whether to enable (true) or disable (false) the server
+   */
+  toggleMcpServer?(serverName: string, enabled: boolean): Promise<void>;
+  /**
+   * Reconnect to an MCP server (optional, used by LocalAgentProvider)
+   *
+   * @param serverName - Name of the MCP server to reconnect
+   * @param forceHttpCallback - Force using HTTP callback instead of URL scheme
+   */
+  reconnectMcpServer?(serverName: string, forceHttpCallback?: boolean): Promise<void>;
+  /**
+   * Delete an MCP server configuration (optional, used by LocalAgentProvider)
+   *
+   * @param serverName - Name of the MCP server to delete
+   */
+  deleteMcpServer?(serverName: string): Promise<void>;
+  /**
+   * Open the MCP configuration file in editor (optional, used by LocalAgentProvider)
+   * Executes 'codebuddy.openMcpConfig' command
+   */
+  openMcpConfig?(): Promise<void>;
+  /**
+   * Get MCP configuration file content
+   * @returns File path and content
+   */
+  getMcpConfigContent?(): Promise<{
+    filePath: string;
+    content: string;
+  }>;
+  /**
+   * Save MCP configuration file content
+   * @param content New configuration content
+   */
+  saveMcpConfigContent?(content: string): Promise<void>;
+  /**
+   * Read text from clipboard (optional, used by LocalAgentProvider for webview clipboard access)
+   * @returns Clipboard text content
+   */
+  clipboardReadText?(): Promise<string>;
+}
+/**
+ * AgentClient initialization options
+ */
+interface AgentClientOptions {
+  /** Agent provider (required) */
+  provider: AgentProvider;
+  /** Logger instance */
+  logger?: Logger;
+  /** Client capabilities (sent during initialization) */
+  clientCapabilities?: ClientCapabilities$1;
+  /**
+   * 运行环境类型
+   * - 'local': IDE 本地环境
+   * - 'cloud': 云端环境
+   */
+  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 {
+  /**
+   * 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>;
+  /**
+   * Retry creating a session after initial session/new request failed.
+   *
+   * Use this when `sessions.create()` fails at the `session/new` step
+   * (after agent creation and connection establishment succeeded).
+   * The caller retrieves `agentId` from the thrown `SessionError.agentId`,
+   * then calls this method to re-attempt only the `session/new` request.
+   *
+   * @experimental This API is subject to change
+   *
+   * @param agentId - Agent ID from the failed SessionError.agentId
+   * @param params - Original create session params (cwd, etc.)
+   * @returns ActiveSession on success
+   * @throws SessionError if session/new fails again
+   */
+  retryNewSession(agentId: string, params: CreateSessionParams$1): Promise<ActiveSession>;
+  /** Load an existing session (finds agent by sessionId and connects) */
+  load(params: LoadSessionParams$1): Promise<ActiveSession>;
   /**
    * Archive a session/agent
    * @param sessionId - Session ID to archive
@@ -2459,6 +3289,15 @@ interface ClientSessionsResource {
   rename(sessionId: string, title: string): Promise<{
     id: string;
   }>;
+  /**
+   * Update session status
+   * @param sessionId - Session ID to update
+   * @param status - New status for the session
+   * @returns Object containing the updated session ID
+   */
+  updateStatus(sessionId: string, status: string): Promise<{
+    id: string;
+  }>;
   /**
    * Move a session (Playground → Workspace)
    * @param sessionId - Session ID to move
@@ -2469,6 +3308,8 @@ interface ClientSessionsResource {
   }>;
   /** Initialize a workspace for future sessions */
   initializeWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  /** Request yielding after current step for a running session */
+  requestYieldAfterCurrentStep(sessionId: string): Promise<boolean>;
   /** Models resource for getting available models */
   readonly models: ModelsResource;
   /** Get current workspaces list */
@@ -2491,6 +3332,22 @@ interface ClientSessionsResource {
   searchFile(params: SearchFileParams): Promise<SearchFileResponse>;
   /** Get subagent list (for LocalAgentProvider) */
   getSubagentList(params: GetSubagentListParams): Promise<GetSubagentListResponse>;
+  /** Get skill list (for LocalAgentProvider) */
+  getSkillList(params?: GetSkillListParams): Promise<GetSkillListResponse>;
+  /** Import a skill folder (for LocalAgentProvider) */
+  importSkill(params: ImportSkillParams): Promise<ImportSkillResponse>;
+  /** Toggle skill enable/disable state (for LocalAgentProvider) */
+  toggleSkill(params: ToggleSkillParams): Promise<ToggleSkillResponse>;
+  /** Delete a skill (for LocalAgentProvider) */
+  deleteSkill(params: DeleteSkillParams): Promise<DeleteSkillResponse>;
+  /** Get skill content by file path (for LocalAgentProvider) */
+  getSkillContent(params: GetSkillContentParams): Promise<GetSkillContentResponse>;
+  /** Get marketplace skills list (for LocalAgentProvider) */
+  getMarketplaceSkills(): Promise<GetMarketplaceSkillsResponse>;
+  /** Get marketplace skill content (for LocalAgentProvider) */
+  getMarketplaceSkillContent(params: GetMarketplaceSkillContentParams): Promise<GetMarketplaceSkillContentResponse>;
+  /** Install marketplace skill to user directory (for LocalAgentProvider) */
+  installMarketplaceSkill(params: InstallMarketplaceSkillParams): Promise<InstallMarketplaceSkillResponse>;
   /** Batch toggle plugins (for LocalAgentProvider) */
   batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
   /** Get installed plugins (for LocalAgentProvider) */
@@ -2501,17 +3358,138 @@ interface ClientSessionsResource {
     description?: string;
     version?: string;
     installScope?: 'user' | 'project';
+    installedScopes?: Array<'user' | 'project' | 'local' | 'project-local'>;
+    installedScopesStatus?: Record<string, boolean>;
+    installId?: string;
   }>>;
   /** Install plugins (for LocalAgentProvider) */
-  installPlugins(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string): Promise<{
+  installPlugins(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string, workspacePath?: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Uninstall a plugin (for LocalAgentProvider) */
+  uninstallPlugin?(pluginName: string, marketplaceName: string, scope: 'user' | 'project' | 'project-local'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Update a plugin to the latest version (for LocalAgentProvider) */
+  updatePlugin?(pluginName: string, marketplaceName: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Get plugin marketplaces list (for LocalAgentProvider) */
+  getPluginMarketplaces?(forceRefresh?: boolean): Promise<Array<{
+    id: string;
+    name: string;
+    type: 'github' | 'local' | 'custom';
+    source: {
+      repo?: string;
+      ref?: string;
+      url?: string;
+    };
+    description?: string;
+    isBuiltin?: boolean;
+  }>>;
+  /** Get plugins from a marketplace (for LocalAgentProvider) */
+  getMarketplacePlugins?(marketplaceName: string, forceRefresh?: boolean, searchText?: string): Promise<Array<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    iconUrl?: string;
+    tags?: string[];
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+    installedScopes?: Array<'user' | 'project'>;
+    hasUpdate?: boolean;
+  }>>;
+  /** Get plugin detail (for LocalAgentProvider) */
+  getPluginDetail?(pluginName: string, marketplaceName: string): Promise<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    readme?: string;
+    tools?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    resources?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    prompts?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+  } | null>;
+  /** Add a plugin marketplace (for LocalAgentProvider) */
+  addPluginMarketplace?(source: string, name?: string): Promise<{
     success: boolean;
     error?: string;
+    marketplace?: {
+      id: string;
+      name: string;
+      type: 'github' | 'local' | 'custom';
+      source: {
+        repo?: string;
+        ref?: string;
+        url?: string;
+      };
+      description?: string;
+      isBuiltin?: boolean;
+    };
   }>;
+  /** Remove a plugin marketplace (for LocalAgentProvider) */
+  removePluginMarketplace?(marketplaceName: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Refresh a plugin marketplace (for LocalAgentProvider) */
+  refreshPluginMarketplace?(marketplaceName: string): Promise<{
+    success: boolean;
+    error?: string;
+    plugins?: Array<{
+      name: string;
+      marketplaceName: string;
+      description?: string;
+      version?: string;
+      installed?: boolean;
+      status?: 'enabled' | 'disabled' | 'not-installed';
+    }>;
+  }>;
+  /** Open folder in new window (for LocalAgentProvider) */
+  openFolderInNewWindow?(folderPath: string): Promise<void>;
+  /** Open folder in system file manager (for LocalAgentProvider) */
+  openFolder?(folderPath: string): Promise<boolean>;
   /**
    * Get support scenes from backend API (for LocalAgentProvider)
    * API 端点: GET /v2/as/support/scenes (Local) 或 GET /console/as/support/scenes (Web)
+   * @param locale - 可选，语言环境（如 'zh-CN', 'en-US'），用于获取对应语言的场景数据
+   */
+  getSupportScenes(locale?: string): Promise<Array<{
+    id: number;
+    name: string;
+    plugins: Array<{
+      id: number;
+      name: string;
+      marketplaceName: string;
+    }>;
+    prompts: string[];
+    mode?: 'coding' | 'working';
+  }>>;
+  /**
+   * Get product scenes from ProductManager configuration (for LocalAgentProvider)
+   * 从 ProductManager.waitConfiguration().scenes 获取本地配置的场景数据
+   * @param locale - 可选，语言环境
    */
-  getSupportScenes(): Promise<Array<{
+  getProductScenes?(locale?: string): Promise<Array<{
     id: number;
     name: string;
     plugins: Array<{
@@ -2520,15 +3498,250 @@ interface ClientSessionsResource {
       marketplaceName: string;
     }>;
     prompts: string[];
+    mode?: 'coding' | 'working';
+    target?: 'local' | 'cloud' | 'all';
   }>>;
   /**
    * Get available commands for a session
    * If session.availableCommands has cached values, return them
    * Otherwise, fetch from provider (for LocalAgentProvider)
-   * @param sessionId - Session ID to get commands for (optional, for global commands)
+   * @param params - Parameters for getting commands
    * @returns Promise<AvailableCommand[]> - Array of available commands
    */
-  getAvailableCommands(sessionId?: string): Promise<AvailableCommand[]>;
+  getAvailableCommands(params?: GetAvailableCommandsParams): Promise<AvailableCommand[]>;
+  /**
+   * Get automation snapshot
+   */
+  getAutomationSnapshot(): Promise<AutomationSnapshot>;
+  /**
+   * Create/update automation definition
+   */
+  updateAutomation(payload: AutomationUpdatePayload): Promise<AutomationUpdateResult>;
+  /**
+   * Delete automation definition
+   */
+  deleteAutomation(id: string): Promise<AutomationUpdateResult>;
+  /**
+   * Archive automation inbox item
+   */
+  archiveAutomationInboxItem(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Delete automation inbox item
+   */
+  deleteAutomationInboxItem(itemId: string): Promise<AutomationUpdateResult>;
+  /**
+   * Trigger automation test run
+   */
+  testAutomation(id: string): Promise<AutomationUpdateResult>;
+  /**
+   * Report telemetry event through the provider chain
+   * Delegates to AgentProvider.reportTelemetry()
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data
+   */
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): Promise<void>;
+  /**
+   * Get product configuration subset
+   * Returns deploymentType, creditPurchaseActions, links, productFeatures
+   * Used by agent-ui for error banner credit purchase guidance
+   */
+  getProductConfiguration?(): Promise<{
+    deploymentType?: string;
+    creditPurchaseActions?: Record<string, {
+      labelZh: string;
+      labelEn: string;
+      url: string;
+      showButton?: boolean;
+    }>;
+    links?: {
+      craftFeedback?: string;
+      mcpMarketUrl?: string;
+      mcpDocumentUrl?: string;
+      helpDocument?: string;
+    };
+    networkEnvironment?: string;
+    productFeatures?: Record<string, boolean>;
+    customModelSettings?: unknown;
+    skillScanDirs?: string[];
+  }>;
+  /**
+   * Get user info
+   * Returns enterpriseId from authentication session
+   * Used by agent-ui for determining personal/enterprise user
+   */
+  getUserInfo?(): Promise<{
+    enterpriseId?: string;
+  }>;
+  /**
+   * Respond to MCP Sampling confirmation request
+   * Called when user confirms/rejects a sampling request in MCP tool renderer
+   *
+   * @param sessionId - Session ID
+   * @param response - Sampling confirmation response
+   */
+  respondToSampling?(sessionId: string, response: McpSamplingConfirmResponse): Promise<void>;
+  /**
+   * Respond to MCP Roots confirmation request
+   * Called when user confirms/rejects a roots request in MCP tool renderer
+   *
+   * @param sessionId - Session ID
+   * @param response - Roots confirmation response
+   */
+  respondToRoots?(sessionId: string, response: McpRootsConfirmResponse): Promise<void>;
+  /**
+   * Subscribe to MCP Sampling confirmation requests
+   * Called when MCP server initiates a sampling request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeSamplingRequests?(serverName: string, callback: (request: McpSamplingConfirmRequest) => void): () => void;
+  /**
+   * Subscribe to MCP Roots confirmation requests
+   * Called when MCP server initiates a roots request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeRootsRequests?(serverName: string, callback: (request: McpRootsConfirmRequest) => void): () => void;
+  /**
+   * Get MCP servers list
+   * Returns the list of configured MCP servers with their status
+   *
+   * @returns Promise<McpServerInfo[]> - Array of MCP server info
+   */
+  getMcpServers?(): Promise<McpServerInfo[]>;
+  /**
+   * Toggle MCP server enabled/disabled state
+   *
+   * @param serverName - Server name
+   * @param enabled - Whether to enable the server
+   */
+  toggleMcpServer?(serverName: string, enabled: boolean): Promise<void>;
+  /**
+   * Reconnect to an MCP server
+   *
+   * @param serverName - Server name
+   * @param forceHttpCallback - Force using HTTP callback instead of URL scheme
+   */
+  reconnectMcpServer?(serverName: string, forceHttpCallback?: boolean): Promise<void>;
+  /**
+   * Delete an MCP server configuration
+   *
+   * @param serverName - Server name
+   */
+  deleteMcpServer?(serverName: string): Promise<void>;
+  /**
+   * Open MCP configuration file in editor
+   */
+  openMcpConfig?(): Promise<void>;
+  /**
+   * Get MCP configuration file content
+   * @returns File path and content
+   */
+  getMcpConfigContent?(): Promise<{
+    filePath: string;
+    content: string;
+  }>;
+  /**
+   * Save MCP configuration file content
+   * @param content New configuration content
+   */
+  saveMcpConfigContent?(content: string): Promise<void>;
+  /**
+   * Read text from clipboard (optional, used by LocalAgentProvider for webview clipboard access)
+   * @returns Clipboard text content
+   */
+  clipboardReadText?(): Promise<string>;
+}
+/**
+ * MCP Sampling message role
+ */
+type McpSamplingRole = 'user' | 'assistant';
+/**
+ * MCP Sampling message content - text
+ */
+interface McpSamplingTextContent {
+  type: 'text';
+  text: string;
+}
+/**
+ * MCP Sampling message content - image
+ */
+interface McpSamplingImageContent {
+  type: 'image';
+  data: string;
+  mimeType: string;
+}
+/**
+ * MCP Sampling message content - audio
+ */
+interface McpSamplingAudioContent {
+  type: 'audio';
+  data: string;
+  mimeType: string;
+}
+/**
+ * MCP Sampling message content union type
+ */
+type McpSamplingContent = McpSamplingTextContent | McpSamplingImageContent | McpSamplingAudioContent;
+/**
+ * MCP Sampling message
+ */
+interface McpSamplingMessage {
+  role: McpSamplingRole;
+  content: McpSamplingContent;
+}
+/**
+ * MCP Sampling confirmation request
+ * Sent from backend when MCP server requests sampling
+ */
+interface McpSamplingConfirmRequest {
+  id: string;
+  serverName: string;
+  model?: string;
+  messages: McpSamplingMessage[];
+  systemPrompt?: string;
+  maxTokens: number;
+  timestamp: number;
+}
+/**
+ * MCP Sampling confirmation response
+ * Sent from frontend when user confirms/rejects
+ */
+interface McpSamplingConfirmResponse {
+  id: string;
+  approved: boolean;
+  rememberChoice?: boolean;
+}
+/**
+ * MCP Root definition
+ */
+interface McpRoot {
+  uri: string;
+  name?: string;
+}
+/**
+ * MCP Roots confirmation request
+ * Sent from backend when MCP server requests roots access
+ */
+interface McpRootsConfirmRequest {
+  id: string;
+  serverName: string;
+  roots: McpRoot[];
+  timestamp: number;
+}
+/**
+ * MCP Roots confirmation response
+ * Sent from frontend when user confirms/rejects
+ */
+interface McpRootsConfirmResponse {
+  id: string;
+  approved: boolean;
+  rememberChoice?: boolean;
 }
 /**
  * Workspace information (aligned with FolderSelectResult)
@@ -2594,6 +3807,8 @@ interface PickFolderResponse {
 interface UploadFileParams {
   /** Files to upload - File objects in browser, absolute path strings in IDE */
   readonly files: Array<File | string>;
+  /** Optional AbortSignal to cancel the upload */
+  readonly abortSignal?: AbortSignal;
 }
 /**
  * Response from uploading files
@@ -2607,6 +3822,8 @@ interface UploadFileResponse {
   readonly expireSeconds?: number;
   /** Error message (if upload failed) */
   readonly error?: string;
+  /** Whether the upload was cancelled by user */
+  readonly aborted?: boolean;
 }
 /**
  * Mention type for file/folder
@@ -2655,53 +3872,280 @@ interface SearchFileResponse {
   /** Search results */
   readonly results: SearchFileResult[];
   /** Error message (if failed) */
-  readonly error?: string;
+  readonly error?: string;
+}
+/**
+ * Subagent information
+ */
+interface SubagentInfo {
+  /** Subagent name */
+  name: string;
+  /** Subagent description */
+  description: string;
+  /** System prompt */
+  systemPrompt: string;
+  /** File path */
+  filePath?: string;
+  /** Model type */
+  model?: string;
+  /** Agent mode */
+  agentMode?: 'agentic' | 'manual';
+  /** Whether enabled */
+  enabled?: boolean;
+  /** Model ID */
+  modelID?: string;
+  /** Subagent level */
+  level?: 'project' | 'user';
+}
+/**
+ * Parameters for getting subagent list
+ */
+interface GetSubagentListParams {
+  /** Search options */
+  readonly options: {
+    /** Search keyword (filter by name or description) */readonly search?: string; /** Limit number of results */
+    readonly resultNum?: number; /** Agent mode filter */
+    readonly agentMode?: 'agentic' | 'manual' | 'all'; /** Whether to return only enabled subagents */
+    readonly onlyEnabled?: boolean;
+  };
+  /** Working directory (optional, for filtering project-level subagents) */
+  readonly cwd?: string;
+}
+/**
+ * Response from getting subagent list
+ */
+interface GetSubagentListResponse {
+  /** Subagent list */
+  readonly results: SubagentInfo[];
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Skill info returned from getSkillList
+ */
+interface SkillInfo {
+  /** Skill name */
+  name: string;
+  /** File path of the skill */
+  filePath: string;
+  /** Description of the skill */
+  description: string;
+  /** Chinese description of the skill */
+  description_zh?: string;
+  /** English description of the skill */
+  description_en?: string;
+  /** When to use the skill */
+  whenToUse?: string;
+  /** Source of the skill */
+  source: 'localSettings' | 'userSettings' | 'plugin' | 'builtin';
+  /** Skill type */
+  type: 'prompt';
+  /** License information */
+  license?: string;
+  /** Allowed tools */
+  allowedTools?: string[];
+  /** Whether the skill is disabled */
+  disable?: boolean;
+}
+/**
+ * Parameters for getting skill list
+ */
+interface GetSkillListParams {
+  /** Working directory (optional, for filtering project-level skills) */
+  readonly cwd?: string;
+  /** Whether to use global (backend) channel, defaults to true. When false, uses sendBroadcastRequest. */
+  readonly global?: boolean;
+  /** Whether to exclude plugin skills from the result, defaults to false. */
+  readonly excludePluginSkills?: boolean;
+  /**
+   * 用户级 skill 扫描目录名称列表（相对于 home 目录），按优先级从高到低排列。
+   * 同名 skill 以高优先级目录为准。
+   * 未传入或为空时使用产品默认目录。
+   */
+  readonly skillScanDirs?: string[];
+}
+/**
+ * Response from getting skill list
+ */
+interface GetSkillListResponse {
+  /** Skill list */
+  readonly results: SkillInfo[];
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for importing a skill folder
+ */
+interface ImportSkillParams {
+  /** Source location: project-level or user-level */
+  readonly source: 'localSettings' | 'userSettings';
+  /** Working directory (required when source is localSettings). */
+  readonly cwd?: string;
+  /** 直接传入文件夹路径（拖拽导入时使用），有此字段时跳过系统文件选择器 */
+  readonly folderPath?: string;
+}
+/**
+ * Response from importing a skill folder
+ */
+interface ImportSkillResponse {
+  /** Whether the import was successful */
+  readonly success: boolean;
+  /** Error message (if failed) */
+  readonly error?: string;
+  /** Imported skill name */
+  readonly skillName?: string;
+}
+/**
+ * Parameters for toggling skill enable/disable state
+ */
+interface ToggleSkillParams {
+  /** File path of the skill to toggle */
+  readonly filePath: string;
+  /** Whether to disable the skill */
+  readonly disable: boolean;
+}
+/**
+ * Response from toggling skill state
+ */
+interface ToggleSkillResponse {
+  /** Whether the toggle was successful */
+  readonly success: boolean;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for deleting a skill
+ */
+interface DeleteSkillParams {
+  /** File path of the skill to delete */
+  readonly filePath: string;
+  /** Name of the skill */
+  readonly name: string;
+}
+/**
+ * Response from deleting a skill
+ */
+interface DeleteSkillResponse {
+  /** Whether the deletion was successful */
+  readonly success: boolean;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for getting skill content
+ */
+interface GetSkillContentParams {
+  /** File path of the skill */
+  readonly filePath: string;
+}
+/**
+ * Response from getting skill content
+ */
+interface GetSkillContentResponse {
+  /** Skill file content */
+  readonly content: string;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Marketplace skill info (simplified structure for UI layer)
+ */
+interface MarketplaceSkillInfo {
+  /** Skill name */
+  name: string;
+  /** Skill description */
+  description: string;
+  /** Skill description in Chinese */
+  description_zh?: string;
+  /** Skill description in English */
+  description_en?: string;
+  /** Skill version */
+  version?: string;
+  /** Skill author */
+  author?: string;
+  /** Skill icon URL */
+  iconUrl?: string;
+  /** Skill tags */
+  tags?: string[];
+}
+/**
+ * Response from getting marketplace skills
+ */
+interface GetMarketplaceSkillsResponse {
+  /** Marketplace skill list */
+  readonly results: MarketplaceSkillInfo[];
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for getting marketplace skill content
+ */
+interface GetMarketplaceSkillContentParams {
+  /** Skill name */
+  readonly skillName: string;
+}
+/**
+ * Response from getting marketplace skill content
+ */
+interface GetMarketplaceSkillContentResponse {
+  /** Skill file content */
+  readonly content: string;
+  /** Error message (if failed) */
+  readonly error?: string;
+}
+/**
+ * Parameters for installing marketplace skill
+ */
+interface InstallMarketplaceSkillParams {
+  /** Skill name to install */
+  readonly skillName: string;
+}
+/**
+ * Response from installing marketplace skill
+ */
+interface InstallMarketplaceSkillResponse {
+  /** Whether the install was successful */
+  readonly success: boolean;
+  /** Skill name */
+  readonly skillName: string;
+  /** Error message (if failed) */
+  readonly errorMessage?: string;
 }
 /**
- * Subagent information
+ * MCP Tool information
  */
-interface SubagentInfo {
-  /** Subagent name */
+interface McpToolInfo {
+  /** Tool name */
   name: string;
-  /** Subagent description */
-  description: string;
-  /** System prompt */
-  systemPrompt: string;
-  /** File path */
-  filePath?: string;
-  /** Model type */
-  model?: string;
-  /** Agent mode */
-  agentMode?: 'agentic' | 'manual';
-  /** Whether enabled */
+  /** Tool description */
+  description?: string;
+  /** Whether the tool is enabled */
   enabled?: boolean;
-  /** Model ID */
-  modelID?: string;
-  /** Subagent level */
-  level?: 'project' | 'user';
-}
-/**
- * Parameters for getting subagent list
- */
-interface GetSubagentListParams {
-  /** Search options */
-  readonly options: {
-    /** Search keyword (filter by name or description) */readonly search?: string; /** Limit number of results */
-    readonly resultNum?: number; /** Agent mode filter */
-    readonly agentMode?: 'agentic' | 'manual' | 'all'; /** Whether to return only enabled subagents */
-    readonly onlyEnabled?: boolean;
-  };
-  /** Working directory (optional, for filtering project-level subagents) */
-  readonly cwd?: string;
 }
 /**
- * Response from getting subagent list
+ * MCP Server information
  */
-interface GetSubagentListResponse {
-  /** Subagent list */
-  readonly results: SubagentInfo[];
-  /** Error message (if failed) */
-  readonly error?: string;
+interface McpServerInfo {
+  /** Server ID */
+  id: string;
+  /** Server name */
+  name: string;
+  /** Connection status */
+  status: 'connecting' | 'connected' | 'disconnected' | 'disabled';
+  /** Server description */
+  description?: string;
+  /** Available tools */
+  tools?: McpToolInfo[];
+  /** Whether the server is disabled */
+  disabled?: boolean;
+  /** Error message (if connection failed) */
+  error?: string;
+  /** Logo URL */
+  logoUrl?: string;
+  /** Official website URL */
+  officialUrl?: string;
+  /** Configuration source */
+  configSource?: 'user' | 'project' | 'plugin';
 }
 //#endregion
 //#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
@@ -2734,6 +4178,17 @@ declare class CloudAgentConnection implements AgentConnection {
   readonly transport: "cloud";
   readonly cwd: string;
   constructor(agentId: string, config: CloudConnectionConfig, cwd?: string);
+  /**
+   * Check whether a notification belongs to this connection's own session.
+   *
+   * CloudConnection.createSession() overrides sessionId to agentId, so the
+   * rest of the client stack uses agentId as the canonical session
+   * identifier.  Notifications whose sessionId differs from agentId
+   * originate from sub-agent sessions running inside the same sandbox and
+   * should be silently ignored at this layer — the adapter layer handles
+   * sub-agent messages independently via parentToolUseId in _meta.
+   */
+  private isOwnSessionNotification;
   private setupEventForwarding;
   on<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
   off<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
@@ -2767,7 +4222,7 @@ declare class CloudAgentConnection implements AgentConnection {
     createdAt: number;
   }>;
   hasPendingQuestions(): boolean;
-  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'approve' | 'skip' | 'cancel'): Promise<{
     success: boolean;
     error?: string;
   }>;
@@ -2781,6 +4236,7 @@ declare class CloudAgentConnection implements AgentConnection {
    * Contains sandboxId, link, token, etc.
    */
   get sessionConnectionInfo(): SessionConnectionInfo | undefined;
+  reportTelemetry(eventName: string, payload: Record<string, unknown>): Promise<void>;
   extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
 }
 //#endregion
@@ -2808,6 +4264,13 @@ interface ArchiveConversationResponse {
 /**
  * Configuration for CloudAgentProvider
  */
+/**
+ * Factory function to create a FilesResource from sandbox connection info.
+ * Used to inject different filesystem implementations (e.g., MiniProgramE2BFilesystem for miniprogram).
+ */
+type FilesystemFactory = (info: E2BSandboxConnectionInfo) => Promise<FilesResource & {
+  setReconnectFn?: (fn: () => Promise<E2BSandboxConnectionInfo>) => void;
+}>;
 interface CloudAgentProviderOptions {
   /** Base endpoint URL for agent management API (e.g., 'https://api.example.com') */
   endpoint: string;
@@ -2819,6 +4282,12 @@ interface CloudAgentProviderOptions {
   logger?: Logger;
   /** Client capabilities (sent during agent initialization) */
   clientCapabilities?: ClientCapabilities$1;
+  /**
+   * Optional filesystem factory for creating FilesResource instances.
+   * If not provided, defaults to E2BFilesystem (requires e2b package).
+   * Set this to MiniProgramE2BFilesystem.connect for miniprogram environments.
+   */
+  filesystemFactory?: FilesystemFactory;
 }
 /**
  * CloudAgentProvider - Manages cloud-hosted agents via REST API
@@ -2903,6 +4372,22 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   private cosUploadService;
   /** Event listeners for provider-level events */
   private eventListeners;
+  /** 产品配置缓存（内存），用于存储 deploymentType 和 creditPurchaseActions */
+  private productConfigCache;
+  /**
+   * Plugin marketplace cache (name/id -> marketplace info)
+   * LRU 缓存，容量上限 200
+   * Key: marketplace name 或 id
+   * Value: marketplace 完整信息
+   */
+  private marketplaceCache;
+  /**
+   * Installed plugin cache (plugin name -> plugin info with install_id)
+   * LRU 缓存，容量上限 2000
+   * Key: plugin name
+   * Value: plugin 完整信息（包含 installId）
+   */
+  private pluginCache;
   constructor(options: CloudAgentProviderOptions);
   /**
    * Dispose the provider and clean up resources
@@ -2959,11 +4444,9 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   /**
    * Create a new conversation
    * POST {endpoint}/console/as/conversations
-   * @param params - Optional session params containing _meta with tags
+   * @param params - Session params containing cwd and optional configuration
    */
-  create(params?: {
-    _meta?: Record<string, unknown>;
-  }): Promise<string>;
+  create(params: CreateSessionParams$1): Promise<string>;
   /**
    * Connect to an agent and return the connection
    *
@@ -3015,6 +4498,21 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
    * ```
    */
   rename(agentId: string, title: string): Promise<PatchConversationResponse>;
+  /**
+   * Update conversation status by ID
+   * POST {endpoint}/console/as/conversations/{agentId}
+   *
+   * @param agentId - Conversation ID to update
+   * @param status - New status for the conversation
+   * @returns PatchConversationResponse containing the updated conversation ID
+   *
+   * @example
+   * ```typescript
+   * const result = await provider.updateStatus('agent-123', 'completed');
+   * console.log('Updated conversation status:', result.id);
+   * ```
+   */
+  updateStatus(agentId: string, status: string): Promise<PatchConversationResponse>;
   /**
    * Get available models from product configuration
    *
@@ -3027,6 +4525,25 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
    * @returns Array of ModelInfo with full model details
    */
   getModels(repo?: string): Promise<ModelInfo[]>;
+  /**
+   * 获取产品部署类型（从缓存）
+   * 需要先调用 getModels() 初始化缓存
+   *
+   * @returns 部署类型：'SaaS' | 'Cloud-Hosted' | 'Self-Hosted'，默认为 'SaaS'
+   */
+  getDeploymentType(): string;
+  /**
+   * 获取 Credit 购买引导配置（从缓存）
+   * 需要先调用 getModels() 初始化缓存
+   *
+   * @returns Credit 购买引导配置，key 为错误码。如果后端未返回，则使用默认配置
+   */
+  getCreditPurchaseActions(): Record<string, {
+    labelZh: string;
+    labelEn: string;
+    url: string;
+    showButton?: boolean;
+  }>;
   /**
    * Generate a unique request ID
    */
@@ -3049,7 +4566,7 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   /**
    * Upload files to cloud storage via COS presigned URL
    *
-   * @param params - files array (File objects in browser)
+   * @param params - files array (File objects in browser), optional abortSignal
    * @returns Response with corresponding cloud URLs
    */
   uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
@@ -3073,53 +4590,282 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   private emitEvent;
   /**
    * 获取支持的场景列表
-   * API 端点: GET /console/as/support/scenes
+   * API 端点: GET /v2/as/support/scenes (不鉴权)
    * 用于 Welcome 页面的 QuickActions 快捷操作
    *
+   * @param locale - 可选，语言环境（如 'zh-CN', 'en-US'），用于获取对应语言的场景数据
    * @returns Promise<SupportScene[]> 支持的场景列表
    */
-  getSupportScenes(): Promise<SupportScene[]>;
+  getSupportScenes(locale?: string): Promise<SupportScene[]>;
   private toAgentState;
   /**
    * Helper: 将 GET 请求的 body 转换为 URL 查询参数
    */
   private buildGetUrl;
+  /**
+   * 获取已安装插件列表
+   * GET /console/as/user/plugins/installed
+   */
+  getInstalledPlugins(forceRefresh?: boolean): Promise<Array<{
+    name: string;
+    marketplaceName: string;
+    status: string;
+    description?: string;
+    version?: string;
+    installScope?: 'user' | 'project';
+    installedScopes?: Array<'user' | 'project' | 'local' | 'project-local'>;
+    installId?: string;
+  }>>;
+  /**
+   * 安装插件
+   * POST /console/as/user/plugins/install
+   *
+   * @param pluginNames - 插件名称数组
+   * @param marketplaceNameOrId - 市场名称或 ID
+   */
+  installPlugins(pluginNames: string[], marketplaceNameOrId: string, installScope?: 'user' | 'project' | 'project-local', marketplaceSource?: string, workspacePath?: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * 卸载插件
+   * POST /console/as/user/plugins/installed/:id/uninstall
+   *
+   * 完整链路：
+   * CloudAgentProvider.uninstallPlugin()
+   *   -> HTTP POST /console/as/user/plugins/installed/:id/uninstall
+   *   -> agentserver: PluginInstallService.Uninstall()
+   *   -> 软删除 DB + 异步同步到活跃沙箱
+   *
+   * @param pluginName - 插件名称
+   * @param marketplaceName - 市场名称（用于标识唯一插件）
+   * @param scope - 卸载范围 ('user' | 'project' | 'project-local')
+   */
+  uninstallPlugin(pluginName: string, marketplaceName: string, scope: 'user' | 'project' | 'project-local'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * 获取插件市场列表
+   * GET /console/as/marketplace/sources
+   */
+  getPluginMarketplaces(forceRefresh?: boolean): Promise<Array<{
+    id: string;
+    name: string;
+    type: 'github' | 'local' | 'custom';
+    source: {
+      repo?: string;
+      ref?: string;
+      url?: string;
+    };
+    description?: string;
+    isBuiltin?: boolean;
+  }>>;
+  /**
+   * 获取市场下的插件列表
+   * - 有 searchText: GET /console/as/marketplace/plugins/search (跨所有市场搜索)
+   * - 无 searchText: GET /console/as/marketplace/plugins (指定市场)
+   *
+   * @param marketplaceNameOrId - 市场名称或 ID（优先使用 ID，如果是名称则从缓存查询 ID）
+   * @param forceRefresh - 是否强制刷新
+   * @param searchText - 搜索关键字（如果提供，则跨所有市场搜索）
+   */
+  getMarketplacePlugins(marketplaceNameOrId: string, forceRefresh?: boolean, searchText?: string): Promise<Array<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    iconUrl?: string;
+    tags?: string[];
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+    installedScopes?: Array<'user' | 'project'>;
+    hasUpdate?: boolean;
+    latestVersion?: string;
+    agents?: any;
+    commands?: any;
+    skills?: any;
+    mcpServers?: any;
+    hooks?: any;
+    rules?: any;
+  }>>;
+  /**
+   * 获取插件详情
+   * GET /console/as/marketplace/plugins/:name/detail
+   *
+   * @param pluginName - 插件名称
+   * @param marketplaceNameOrId - 市场名称或 ID（优先使用 ID，如果是名称则从缓存查询 ID）
+   */
+  getPluginDetail(pluginName: string, marketplaceNameOrId: string): Promise<{
+    name: string;
+    marketplaceName: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    homepage?: string;
+    iconUrl?: string;
+    tags?: string[];
+    installed?: boolean;
+    status?: 'enabled' | 'disabled' | 'not-installed';
+    installedScopes?: Array<'user' | 'project'>;
+    readme?: string;
+    configSchema?: Record<string, unknown>;
+    tools?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    resources?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    prompts?: Array<{
+      name: string;
+      description?: string;
+    }>;
+    downloadCount?: number;
+    lastUpdated?: string;
+    license?: string;
+    repositoryUrl?: string;
+  } | null>;
+  /**
+   * 添加插件市场
+   * POST /console/as/marketplace/sources
+   */
+  addPluginMarketplace(sourceUrl: string, name?: string): Promise<{
+    success: boolean;
+    error?: string;
+    marketplace?: {
+      id: string;
+      name: string;
+      type: 'github' | 'local' | 'custom';
+      source: {
+        repo?: string;
+        ref?: string;
+        url?: string;
+      };
+      description?: string;
+      isBuiltin?: boolean;
+    };
+  }>;
+  /**
+   * 删除插件市场
+   * POST /console/as/marketplace/sources/:id/delete
+   */
+  removePluginMarketplace(marketplaceNameOrId: string): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * 刷新插件市场
+   * POST /console/as/marketplace/sources/:id/check-updates
+   */
+  refreshPluginMarketplace(marketplaceNameOrId: string): Promise<{
+    success: boolean;
+    error?: string;
+    plugins?: Array<any>;
+  }>;
+  /**
+   * 批量切换插件启用/禁用状态
+   * POST /console/as/user/plugins/installed/:id/toggle
+   */
+  batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
+  /**
+   * 将后端插件数据映射为前端格式
+   */
+  private mapPluginData;
+  /**
+   * 从缓存中查找插件的 install_id
+   * 如果缓存未命中，则调用 API 获取并缓存
+   *
+   * @param pluginName - 插件名称
+   * @returns install_id 或 null
+   */
+  private findPluginInstallId;
+  /**
+   * 从缓存中查找 marketplace ID
+   * 如果缓存未命中，则调用 API 获取并缓存
+   */
+  private findMarketplaceId;
+  /**
+   * 提取 API 错误信息
+   * 从 AxiosError 中提取详细的错误信息，包括 HTTP 状态码、错误码和错误消息
+   */
+  private extractErrorMessage;
+  /**
+   * 映射后端 source_type 到前端类型
+   */
+  private mapSourceType;
+  /**
+   * 解析 capabilities JSON 字符串
+   */
+  private parseCapabilities;
+  /**
+   * 上报 telemetry 事件（Cloud 模式）
+   * 通过 HTTP POST 发送到 /v2/report
+   * 注入用户信息和浏览器环境等公共字段
+   */
+  reportTelemetry(eventName: string, payload: Record<string, unknown>): Promise<void>;
 }
 //#endregion
 //#region ../agent-provider/lib/common/providers/cloud-agent-provider/e2b-filesystem.d.ts
 /**
- * E2B Filesystem Implementation
+ * Callback to fetch fresh sandbox connection info from backend.
+ * Called when an operation fails with 401/403.
+ */
+type ReconnectFn = () => Promise<E2BSandboxConnectionInfo>;
+/**
+ * E2B Filesystem
  *
- * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource interface.
+ * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource.
+ * When `reconnectFn` is provided, automatically reconnects on auth errors.
  *
  * @example
  * ```typescript
- * const fs = await E2BFilesystem.connect({
- *     sandboxId: 'sandbox-123',
- *     apiKey: 'e2b_xxx'
- * });
+ * // Basic usage (no auto-reconnect)
+ * const fs = await E2BFilesystem.connect({ sandboxId: '...' });
  *
- * // Read/write files
- * await fs.write('/test.txt', 'Hello World');
- * const content = await fs.read('/test.txt');
- *
- * // Watch for changes
- * const handle = await fs.watchDir('/workspace', (event) => {
- *     console.log('File changed:', event);
- * });
+ * // With auto-reconnect on token expiry
+ * const fs = await E2BFilesystem.connect({ sandboxId: '...' });
+ * fs.setReconnectFn(async () => fetchFreshConnectionInfo());
  * ```
  */
 declare class E2BFilesystem implements FilesResource {
   private sandbox;
+  private reconnectFn?;
+  /** Whether a reconnect is currently in-flight */
+  private isReconnecting;
+  /** Callers waiting for the in-flight reconnect to complete */
+  private reconnectSubscribers;
+  /** Timestamp of last reconnect attempt (anti-loop: min 10s between attempts) */
+  private lastReconnectAt;
+  private static readonly MIN_RECONNECT_INTERVAL_MS;
   constructor(sandbox: Sandbox);
   /**
    * Connect to an E2B Sandbox and create filesystem instance
    */
   static connect(info: E2BSandboxConnectionInfo): Promise<E2BFilesystem>;
+  /**
+   * Set reconnect callback. When set, auth errors trigger automatic reconnect + retry.
+   */
+  setReconnectFn(fn: ReconnectFn): void;
   /**
    * Get the underlying E2B Sandbox instance
    */
   getSandbox(): Sandbox;
+  private isAuthError;
+  private canAttemptReconnect;
+  /**
+   * Reconnect with fresh credentials.
+   * Only one reconnect in-flight at a time; concurrent callers share the result.
+   */
+  private reconnect;
+  /**
+   * Execute an operation. If reconnectFn is set and an auth error occurs,
+   * reconnect and retry once.
+   */
+  private exec;
   read(path: string, opts?: FilesystemRequestOpts & {
     format?: 'text';
   }): Promise<string>;
@@ -3134,13 +4880,13 @@ declare class E2BFilesystem implements FilesResource {
   }): 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[]>;
+  list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo[]>;
   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 & {
+  rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
+  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
+  watchDir(path: string, onEvent: (event: FilesystemEvent) => void | Promise<void>, opts?: WatchOpts & {
     onExit?: (err?: Error) => void | Promise<void>;
   }): Promise<WatchHandle>;
 }
@@ -3262,6 +5008,7 @@ interface ActiveSessionImplOptions {
 declare class ActiveSessionImpl implements ActiveSession {
   private _id;
   private _agentId;
+  private _cwd?;
   private _availableModes?;
   private _currentMode?;
   private _availableModels?;
@@ -3273,6 +5020,7 @@ declare class ActiveSessionImpl implements ActiveSession {
   private _connectionInfo?;
   private listeners;
   private onceListeners;
+  private connectionListeners;
   /**
    * Agent operations namespace
    */
@@ -3306,6 +5054,14 @@ declare class ActiveSessionImpl implements ActiveSession {
    * Agent ID
    */
   get agentId(): string;
+  /**
+   * Actual workspace path (set from newSession response _meta)
+   */
+  get cwd(): string | undefined;
+  /**
+   * Set actual workspace path (called by SessionManager after createSession)
+   */
+  setCwd(cwd: string): void;
   /**
    * Agent state (live connection state)
    * Returns LocalAgentState or CloudAgentState based on transport type
@@ -3387,12 +5143,12 @@ declare class ActiveSessionImpl implements ActiveSession {
    */
   cancelQuestion(toolCallId: string, reason?: string): boolean;
   /**
-   * Callback for tool operations (skip or cancel)
+   * Callback for tool operations (approve / skip / cancel)
    * @param toolCallId Tool call ID
    * @param toolName Tool name
-   * @param action Action to perform ('skip' or 'cancel')
+   * @param action Action to perform ('approve' / 'skip' / 'cancel')
    */
-  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+  toolCallback(toolCallId: string, toolName: string, action: 'approve' | 'skip' | 'cancel'): Promise<{
     success: boolean;
     error?: string;
   }>;
@@ -3450,6 +5206,12 @@ declare class ActiveSessionImpl implements ActiveSession {
    * Disconnect from the session/agent
    */
   disconnect(): void;
+  /**
+   * Detach the session from connection events without disconnecting the connection.
+   * This should be called when the session is being replaced but the connection is shared.
+   * Unlike disconnect(), this only removes event listeners without closing the connection.
+   */
+  detach(): void;
   /**
    * Symbol.dispose for 'using' keyword support
    * Automatically disconnects and cleans up when session goes out of scope
@@ -3464,8 +5226,21 @@ declare class ActiveSessionImpl implements ActiveSession {
    */
   [Symbol.dispose](): void;
   private getConnectionOrThrow;
+  /**
+   * 在 connection 上注册 listener 并保存引用，便于 disconnect 时移除
+   */
+  private addConnectionListener;
+  /**
+   * 从 connection 上移除所有本 session 注册的 listener
+   */
+  private removeConnectionListeners;
   private setupConnectionEvents;
   private mapPromptResponse;
+  /**
+   * 判断 artifact 是否应该转发给当前 session
+   * 所有类型的 artifact 都按 __sessionId 严格隔离
+   */
+  private shouldForwardArtifact;
 }
 //#endregion
 //#region ../agent-provider/lib/common/client/session-manager.d.ts
@@ -3507,6 +5282,14 @@ interface SessionManagerOptions {
 declare class SessionManager {
   private provider;
   private logger?;
+  /**
+   * Cache of connections from failed createSession() attempts.
+   * Keyed by agentId, used by retryNewSession() to reuse the
+   * existing initialized connection instead of re-connecting.
+   *
+   * @experimental Internal cache for retryNewSession support
+   */
+  private pendingConnections;
   constructor(options: SessionManagerOptions);
   /**
    * List all sessions with pagination info (mapped from agents)
@@ -3529,6 +5312,47 @@ declare class SessionManager {
    * 5. Return ActiveSession instance
    */
   createSession(params: CreateSessionParams$1): Promise<ActiveSession>;
+  /**
+   * Retry creating a session after initial session/new request failed.
+   *
+   * Use this when `sessions.create()` fails at the `session/new` step
+   * (after agent creation and connection establishment succeeded).
+   * The caller retrieves `agentId` from the thrown `SessionError.agentId`,
+   * then calls this method to re-attempt only the `session/new` request
+   * while reusing the already-initialized connection (no re-connect).
+   *
+   * @experimental This API is subject to change
+   *
+   * @param agentId - Agent ID from the failed SessionError
+   * @param params - Original create session params (cwd, mcpServers, etc.)
+   * @returns ActiveSession on success
+   * @throws SessionError if session/new fails again
+   *
+   * @example
+   * ```typescript
+   * try {
+   *   const session = await client.sessions.create({ cwd: '/workspace' });
+   * } catch (err) {
+   *   if (err instanceof SessionError && err.agentId) {
+   *     // Retry with custom logic
+   *     for (let i = 0; i < 3; i++) {
+   *       try {
+   *         const session = await client.sessions.retryNewSession(err.agentId, { cwd: '/workspace' });
+   *         break; // success
+   *       } catch (retryErr) {
+   *         await new Promise(r => setTimeout(r, 1000 * (i + 1)));
+   *       }
+   *     }
+   *   }
+   * }
+   * ```
+   */
+  retryNewSession(agentId: string, params: CreateSessionParams$1): Promise<ActiveSession>;
+  /**
+   * Build an ActiveSession from a NewSessionResponse.
+   * Shared by createSession() and retryNewSession().
+   */
+  private buildActiveSession;
   /**
    * Load an existing session
    *
@@ -3570,6 +5394,13 @@ declare class SessionManager {
  */
 declare class BackendProvider implements IBackendProvider {
   constructor(config: BackendProviderConfig);
+  /**
+   * 处理 401 未授权错误
+   * 先尝试刷新 token，失败后再执行登出流程
+   *
+   * @throws 如果 token 刷新失败，抛出错误通知 HttpService 不要重试
+   */
+  protected handleUnauthorized(): Promise<void>;
   /**
    * 获取当前账号信息
    * API 端点: GET /console/accounts (返回账号列表)
@@ -3680,9 +5511,21 @@ declare class BackendProvider implements IBackendProvider {
   login(): Promise<void>;
   /**
    * 登出账号
-   * Web 环境: 通过 iframe 访问登出 URL 清除 cookie
+   *
+   * 策略：
+   * - IOA 企业：用 iframe 走 SSO/SAML SLO 登出链路（涉及跨域重定向），通过轮询 iframe URL 变化检测完成
+   * - 非 IOA 企业：直接用 httpService 请求 /console/logout，速度快
    */
   logout(): Promise<void>;
+  /**
+   * IOA 企业登出：通过 iframe 走 SSO/SAML SLO 登出链路
+   * 轮询 iframe URL 变化检测完成，兜底超时 5 秒
+   */
+  private logoutViaIframe;
+  /**
+   * 非 IOA 企业登出：直接 HTTP 请求 /console/logout
+   */
+  private logoutViaHttp;
   /**
    * 批量切换插件状态
    * Web 环境不支持此功能
@@ -3725,6 +5568,41 @@ declare class BackendProvider implements IBackendProvider {
    * @returns Promise<ListReposResponse> 仓库列表响应
    */
   getRepositories(connector: OauthConnectorName, page?: number, perPage?: number): Promise<ListReposResponse>;
+  /**
+   * 保存待发送的输入内容到后端
+   * API 端点: POST /api/v1/code-id
+   */
+  savePendingInput(code: string): Promise<string | null>;
+  /**
+   * 从后端加载待发送的输入内容
+   * API 端点: GET /api/v1/code?id=xxx
+   */
+  loadPendingInput(codeId: string): Promise<string | null>;
+  /**
+   * 获取每日签到状态
+   * API 端点: POST /billing/meter/checkin-status
+   */
+  getCheckinStatus(): Promise<CheckinStatusResponse | null>;
+  /**
+   * 执行每日签到
+   * API 端点: POST /billing/meter/daily-checkin
+   */
+  claimDailyCheckin(): Promise<CheckinResultResponse>;
+  private static readonly SKILLHUB_BASE_URL;
+  private static readonly SKILLHUB_FETCH_TIMEOUT;
+  private skillHubFetch;
+  getSkillHubList(params?: SkillHubListParams): Promise<SkillHubListResponse>;
+  getSkillHubCategories(): Promise<SkillHubCategoriesResponse>;
+  getSkillHubSearch(q: string, limit?: number): Promise<SkillHubSearchResponse>;
+  getSkillHubDetail(slug: string): Promise<SkillHubDetailResponse>;
+  getSkillHubExists(slugs: string[]): Promise<SkillHubExistsResponse>;
+  reportSkillHubStats(slug: string, inc: {
+    downloads?: number;
+    installs?: number;
+    stars?: number;
+  }): Promise<void>;
+  installSkillHubSkill(_slug: string, _version?: string, _name?: string): Promise<SkillHubInstallResponse>;
+  getSkillHubInstalledMetas(): Promise<SkillHubInstalledMeta[]>;
 }
 /**
  * 创建 BackendProvider 实例
@@ -3753,6 +5631,12 @@ declare class IPCBackendProvider implements IBackendProvider {
   private readonly debug;
   private readonly timeoutMs;
   constructor(config: IPCBackendProviderConfig);
+  /**
+   * 设置会话变化监听器
+   * 监听来自 Extension Host (BackendBridgeService) 推送的 auth:session-changed 事件
+   * 并更新本地 accountService
+   */
+  private setupSessionChangeListener;
   /**
    * 发送统一格式的后端请求
    * @param requestType 请求类型
@@ -3853,6 +5737,14 @@ declare class IPCBackendProvider implements IBackendProvider {
   reloadWindow(params?: {
     locale?: string;
   }): Promise<void>;
+  /**
+   * Save locale to argv.json without restarting the app.
+   * The change takes effect on next manual restart.
+   * @param params locale to save
+   */
+  saveLocale(params: {
+    locale: string;
+  }): Promise<void>;
   /**
    * 关闭 Agent Manager 面板
    * IDE 环境: 通过 IPC 通知 IDE 关闭 Agent Manager（用于返回 IDE）
@@ -3864,6 +5756,24 @@ declare class IPCBackendProvider implements IBackendProvider {
    * @param url 要打开的 URL
    */
   openExternal(url: string): Promise<void>;
+  /**
+   * 打开本地文件
+   * IDE 环境: 通过 IPC 通知 IDE 打开本地配置文件
+   * @param filePath 要打开的文件路径
+   */
+  openLocalFile(filePath: string): Promise<void>;
+  /**
+   * 获取用户级本地自定义模型
+   */
+  getLocalCustomModels(): Promise<GetLocalCustomModelsResponse>;
+  /**
+   * 保存用户级本地自定义模型
+   */
+  saveLocalCustomModel(request: SaveLocalCustomModelRequest): Promise<GetLocalCustomModelsResponse>;
+  /**
+   * 删除用户级本地自定义模型
+   */
+  deleteLocalCustomModel(id: string): Promise<GetLocalCustomModelsResponse>;
   /**
    * 批量切换插件状态
    * IDE 环境: 通过 IPC 调用 Extension Host 的 PluginService
@@ -3881,6 +5791,76 @@ declare class IPCBackendProvider implements IBackendProvider {
    * 4. 返回 SupportScene[] 数据给 agent-ui
    */
   getSupportScenes(): Promise<SupportScene[]>;
+  /**
+   * 获取账号用量信息（积分/Credits）
+   * IDE 环境: 通过 IPC 实时获取用量信息，每次打开菜单时调用
+   *
+   * 调用链：
+   * 1. agent-ui: IPCBackendProvider.getAccountUsage()
+   * 2. Agent Manager renderer: BackendService.getAccountUsage()
+   * 3. Main Process: codebuddy:getAccountUsage IPC handler
+   * 4. 返回 { usageLeft, usageTotal, editionType, refreshAt } 等字段
+   */
+  getAccountUsage(): Promise<Partial<Account> | null>;
+  /**
+   * 获取每日签到状态
+   * IDE 环境: 通过 IPC 获取签到状态
+   */
+  getCheckinStatus(): Promise<CheckinStatusResponse | null>;
+  /**
+   * 执行每日签到
+   * IDE 环境: 通过 IPC 执行签到
+   */
+  claimDailyCheckin(): Promise<CheckinResultResponse>;
+  /**
+   * 获取活动 Banner
+   * IDE 环境: 通过 IPC 获取活动 Banner
+   */
+  getActivityBanner(): Promise<ActivityBannerResponse | null>;
+  /**
+   * 获取 SkillHub 技能列表
+   * IDE 环境: 通过 IPC 获取技能列表
+   */
+  getSkillHubList(params?: SkillHubListParams): Promise<SkillHubListResponse>;
+  /**
+   * 获取 SkillHub 分类列表
+   * IDE 环境: 通过 IPC 获取分类列表
+   */
+  getSkillHubCategories(): Promise<SkillHubCategoriesResponse>;
+  /**
+   * 搜索 SkillHub 技能
+   * IDE 环境: 通过 IPC 搜索技能
+   */
+  getSkillHubSearch(q: string, limit?: number): Promise<SkillHubSearchResponse>;
+  /**
+   * 获取 SkillHub 技能详情
+   * IDE 环境: 通过 IPC 获取技能详情
+   */
+  getSkillHubDetail(slug: string): Promise<SkillHubDetailResponse>;
+  /**
+   * 批量检查 SkillHub 技能是否存在
+   * IDE 环境: 通过 IPC 检查技能是否存在
+   */
+  getSkillHubExists(slugs: string[]): Promise<SkillHubExistsResponse>;
+  /**
+   * 上报 SkillHub 技能统计
+   * IDE 环境: 通过 IPC 上报统计
+   */
+  reportSkillHubStats(slug: string, inc: {
+    downloads?: number;
+    installs?: number;
+    stars?: number;
+  }): Promise<void>;
+  /**
+   * 安装 SkillHub 技能
+   * IDE 环境: 通过 IPC 安装技能（下载 zip → 解压到本地）
+   */
+  installSkillHubSkill(slug: string, version?: string, name?: string): Promise<SkillHubInstallResponse>;
+  /**
+   * 获取本地已安装的 SkillHub 技能元信息
+   * IDE 环境: 通过 IPC 获取元信息
+   */
+  getSkillHubInstalledMetas(): Promise<SkillHubInstalledMeta[]>;
   /**
    * 调试日志
    */
@@ -3918,7 +5898,7 @@ type RequestErrorInterceptor = (error: any) => any;
 /**
  * 响应拦截器函数
  */
-type ResponseInterceptor = (response: AxiosResponse) => AxiosResponse | Promise<AxiosResponse>;
+type ResponseInterceptor = (response: AxiosResponse$1) => AxiosResponse$1 | Promise<AxiosResponse$1>;
 /**
  * 响应错误拦截器函数
  */
@@ -3935,7 +5915,7 @@ type UnauthorizedCallback = () => void;
  * 特性：
  * - 单例模式，全局唯一实例，延迟初始化（首次使用时自动创建）
  * - 支持拦截器注册（其他模块可注入 header）
- * - 统一 401/403 处理
+ * - 统一 401 处理（支持自动刷新 token 并重试）
  * - 自动携带凭证（withCredentials）
  * - 类型安全
  *
@@ -3971,6 +5951,10 @@ declare class HttpService {
   private axiosInstance;
   private unauthorizedCallbacks;
   private config;
+  /** 是否正在刷新 token */
+  private isRefreshing;
+  /** 等待 token 刷新完成的请求队列 */
+  private refreshSubscribers;
   /**
    * 私有构造函数（单例模式）
    */
@@ -3988,9 +5972,17 @@ declare class HttpService {
    */
   private registerDefaultRequestInterceptor;
   /**
-   * 注册默认响应拦截器（处理 401/403）
+   * 注册默认响应拦截器（处理 401，支持自动重试）
    */
   private registerDefaultResponseInterceptor;
+  /**
+   * token 刷新成功，通知所有等待的请求
+   */
+  private onRefreshSuccess;
+  /**
+   * token 刷新失败，通知所有等待的请求
+   */
+  private onRefreshFailure;
   /**
    * 注册请求拦截器
    * @param onFulfilled 请求成功拦截器
@@ -4056,7 +6048,9 @@ declare class HttpService {
    */
   offUnauthorized(callback: UnauthorizedCallback): void;
   /**
-   * 触发所有 401 回调
+   * 触发所有 401 回调并等待完成
+   * @returns Promise，等待所有回调完成
+   * @throws 如果任何回调失败，则抛出错误
    */
   private triggerUnauthorizedCallbacks;
   /**
@@ -4107,6 +6101,12 @@ declare class HttpService {
    * @returns 响应数据
    */
   put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+  /**
+   * 通用请求方法
+   * @param config axios 请求配置
+   * @returns 原始 AxiosResponse
+   */
+  request<T = any>(config: AxiosRequestConfig): Promise<AxiosResponse<T>>;
   /**
    * 获取原始 axios 实例（用于高级场景）
    */
@@ -4134,5 +6134,5 @@ declare class HttpService {
  */
 declare const httpService: HttpService;
 //#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, HttpService, type HttpServiceConfig, type IBackendProvider, IPCBackendProvider, type ListAgentFilter, type ListAgentOptions, type ListAgentSort, type Logger, type McpServerConfig, type ModelInfo, type PromptContentBlock, type PromptParams, type PromptsResource, type ReasoningConfig, type RequestErrorInterceptor, type RequestInterceptor, type ResponseErrorInterceptor, type ResponseInterceptor, type Session, type SessionAgentOperations, type SessionConnectionInfo, type SessionEventHandler, type SessionEvents, type SessionInfo, SessionManager, type SessionMode, type UnauthorizedCallback, type WatchOpts, type WriteEntry, createBackendProvider, createIPCBackendProvider, httpService, 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, HttpService, type HttpServiceConfig, type IBackendProvider, IPCBackendProvider, type ListAgentFilter, type ListAgentOptions, type ListAgentSort, type Logger, type McpServerConfig, type ModelInfo, type PromptContentBlock, type PromptParams, type PromptsResource, type ReasoningConfig, type RequestErrorInterceptor, type RequestInterceptor, type ResponseErrorInterceptor, type ResponseInterceptor, type Session, type SessionAgentOperations, type SessionConnectionInfo, SessionError, type SessionEventHandler, type SessionEvents, type SessionInfo, SessionManager, type SessionMode, type UnauthorizedCallback, type WatchOpts, type WriteEntry, createBackendProvider, createIPCBackendProvider, httpService, isCloudAgentState };
 //# sourceMappingURL=index.d.mts.map