@tencent-ai/cloud-agent-sdk 0.2.13 → 0.2.14-next.0a3c83c.20260321

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-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";
 import "zod";
 
 //#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
@@ -995,6 +1001,38 @@ 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;
+}
 /**
  * 企业用户用量信息
  */
@@ -1122,6 +1160,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
@@ -1145,6 +1191,22 @@ 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>;
   /**
    * 刷新 Token（可选）
    * 通过调用 getAccount 刷新 cookie
@@ -1173,6 +1235,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 +1417,12 @@ interface ScenePlugin {
   /** 插件市场名称 */
   marketplaceName: string;
 }
+/**
+ * 场景模式类型
+ * - coding: 编程相关场景
+ * - working: 工作/通用场景
+ */
+type SupportSceneMode = 'coding' | 'working';
 /**
  * 支持的场景信息
  * 用于 Welcome 页面的 QuickActions 快捷操作
@@ -1200,11 +1437,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 +1555,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 +1703,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 +1711,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 +1816,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 +1922,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 +2145,8 @@ interface BaseAgentState {
   updatedAt?: Date;
   /** 是否为 playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * LocalAgentState - 本地 Agent 状态
@@ -1893,6 +2210,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 +2292,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 +2366,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 +2481,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 +2491,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 +2499,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 +2586,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 +2625,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 +2648,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 +2718,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 +2748,34 @@ 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>;
+  }>;
+  /**
+   * 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 +2791,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 +2828,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 +2903,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 +2916,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 +2925,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,6 +2968,131 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param handler - Event handler function to remove
    */
   off?(event: string, handler: (...args: any[]) => void): void;
+  /**
+   * Report telemetry event through the provider chain
+   * - Local: via ACP JSON-RPC → AcpAgent → IDE EventService
+   * - Cloud: via connection → cloud endpoint
+   *
+   * @param eventName - Event name / code
+   * @param payload - Event data
+   */
+  reportTelemetry?(eventName: string, payload: Record<string, unknown>): Promise<void>;
+  /**
+   * Respond to MCP Sampling confirmation request (optional, used by LocalAgentProvider)
+   * Called when user confirms/rejects a sampling request
+   *
+   * @param sessionId - Session ID
+   * @param response - Sampling confirmation response
+   */
+  respondToSampling?(sessionId: string, response: McpSamplingConfirmResponse): Promise<void>;
+  /**
+   * Respond to MCP Roots confirmation request (optional, used by LocalAgentProvider)
+   * Called when user confirms/rejects a roots request
+   *
+   * @param sessionId - Session ID
+   * @param response - Roots confirmation response
+   */
+  respondToRoots?(sessionId: string, response: McpRootsConfirmResponse): Promise<void>;
+  /**
+   * Subscribe to MCP Sampling confirmation requests (optional, used by LocalAgentProvider)
+   * Called when MCP server initiates a sampling request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeSamplingRequests?(serverName: string, callback: (request: McpSamplingConfirmRequest) => void): () => void;
+  /**
+   * Subscribe to MCP Roots confirmation requests (optional, used by LocalAgentProvider)
+   * Called when MCP server initiates a roots request
+   *
+   * @param serverName - MCP server name
+   * @param callback - Request callback
+   * @returns Unsubscribe function
+   */
+  subscribeRootsRequests?(serverName: string, callback: (request: McpRootsConfirmRequest) => void): () => void;
+  /**
+   * 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
@@ -2459,6 +3150,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 +3169,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 +3193,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,34 +3219,388 @@ 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;
   }>;
-  /**
-   * Get support scenes from backend API (for LocalAgentProvider)
-   * API 端点: GET /v2/as/support/scenes (Local) 或 GET /console/as/support/scenes (Web)
-   */
-  getSupportScenes(): Promise<Array<{
-    id: number;
+  /** 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;
-    plugins: Array<{
-      id: number;
-      name: string;
-      marketplaceName: string;
-    }>;
-    prompts: string[];
+    type: 'github' | 'local' | 'custom';
+    source: {
+      repo?: string;
+      ref?: string;
+      url?: string;
+    };
+    description?: string;
+    isBuiltin?: boolean;
   }>>;
-  /**
-   * 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)
+  /** 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 - 可选，语言环境
+   */
+  getProductScenes?(locale?: string): Promise<Array<{
+    id: number;
+    name: string;
+    plugins: Array<{
+      id: number;
+      name: string;
+      marketplaceName: string;
+    }>;
+    prompts: string[];
+    mode?: 'coding' | 'working';
+    target?: 'local' | 'cloud' | 'all';
+  }>>;
+  /**
+   * Get available commands for a session
+   * If session.availableCommands has cached values, return them
+   * Otherwise, fetch from provider (for LocalAgentProvider)
+   * @param params - Parameters for getting commands
    * @returns Promise<AvailableCommand[]> - Array of available commands
    */
-  getAvailableCommands(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>;
+  }>;
+  /**
+   * 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 +3666,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 +3681,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
@@ -2703,6 +3779,233 @@ interface GetSubagentListResponse {
   /** 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;
+}
+/**
+ * MCP Tool information
+ */
+interface McpToolInfo {
+  /** Tool name */
+  name: string;
+  /** Tool description */
+  description?: string;
+  /** Whether the tool is enabled */
+  enabled?: boolean;
+}
+/**
+ * MCP Server information
+ */
+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 +4037,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 +4081,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 +4095,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 +4123,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 +4141,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 +4231,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 +4303,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 +4357,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 +4384,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 +4425,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 +4449,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'
- * });
- *
- * // Read/write files
- * await fs.write('/test.txt', 'Hello World');
- * const content = await fs.read('/test.txt');
+ * // Basic usage (no auto-reconnect)
+ * const fs = await E2BFilesystem.connect({ sandboxId: '...' });
  *
- * // 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 +4739,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 +4867,7 @@ interface ActiveSessionImplOptions {
 declare class ActiveSessionImpl implements ActiveSession {
   private _id;
   private _agentId;
+  private _cwd?;
   private _availableModes?;
   private _currentMode?;
   private _availableModels?;
@@ -3273,6 +4879,7 @@ declare class ActiveSessionImpl implements ActiveSession {
   private _connectionInfo?;
   private listeners;
   private onceListeners;
+  private connectionListeners;
   /**
    * Agent operations namespace
    */
@@ -3306,6 +4913,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 +5002,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 +5065,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 +5085,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
@@ -3570,6 +5204,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 +5321,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 +5378,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 实例
@@ -3853,6 +5541,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）
@@ -3881,6 +5577,71 @@ 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>;
+  /**
+   * 获取 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 +5679,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 +5696,7 @@ type UnauthorizedCallback = () => void;
  * 特性：
  * - 单例模式，全局唯一实例，延迟初始化（首次使用时自动创建）
  * - 支持拦截器注册（其他模块可注入 header）
- * - 统一 401/403 处理
+ * - 统一 401 处理（支持自动刷新 token 并重试）
  * - 自动携带凭证（withCredentials）
  * - 类型安全
  *
@@ -3971,6 +5732,10 @@ declare class HttpService {
   private axiosInstance;
   private unauthorizedCallbacks;
   private config;
+  /** 是否正在刷新 token */
+  private isRefreshing;
+  /** 等待 token 刷新完成的请求队列 */
+  private refreshSubscribers;
   /**
    * 私有构造函数（单例模式）
    */
@@ -3988,9 +5753,17 @@ declare class HttpService {
    */
   private registerDefaultRequestInterceptor;
   /**
-   * 注册默认响应拦截器（处理 401/403）
+   * 注册默认响应拦截器（处理 401，支持自动重试）
    */
   private registerDefaultResponseInterceptor;
+  /**
+   * token 刷新成功，通知所有等待的请求
+   */
+  private onRefreshSuccess;
+  /**
+   * token 刷新失败，通知所有等待的请求
+   */
+  private onRefreshFailure;
   /**
    * 注册请求拦截器
    * @param onFulfilled 请求成功拦截器
@@ -4056,7 +5829,9 @@ declare class HttpService {
    */
   offUnauthorized(callback: UnauthorizedCallback): void;
   /**
-   * 触发所有 401 回调
+   * 触发所有 401 回调并等待完成
+   * @returns Promise，等待所有回调完成
+   * @throws 如果任何回调失败，则抛出错误
    */
   private triggerUnauthorizedCallbacks;
   /**
@@ -4107,6 +5882,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 实例（用于高级场景）
    */