@tencent-ai/cloud-agent-sdk 0.1.1 → 0.1.5

package/dist/index.d.mts

@@ -0,0 +1,2466 @@
+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";
+
+//#region ../agent-provider/lib/common/_legacy/IPCAgentProvider.d.ts
+/**
+ * Widget Channel 接口
+ * 定义 Widget 与 Agent Manager 的通信抽象
+ * 面向 ACP 协议设计，使用 sessionId 作为主要标识符
+ */
+interface IWidgetChannel {
+  /**
+   * 发送通知到指定 session（fire-and-forget）
+   * Channel 层负责路由到正确的 window
+   * 不需要等待响应时使用此方法
+   *
+   * @param sessionId ACP 会话 ID
+   * @param message 消息内容
+   * @returns 是否发送成功
+   */
+  sendNotification(sessionId: string, message: any): boolean;
+  /**
+   * 调用远程方法并等待响应
+   * 需要响应时使用此方法（推荐）
+   *
+   * @param sessionId ACP 会话 ID
+   * @param message 消息内容
+   * @param timeoutMs 超时时间（毫秒，默认 5000）
+   * @returns Promise 包含响应数据
+   */
+  callMethod(sessionId: string, message: any, timeoutMs?: number): Promise<any>;
+  /**
+   * 绑定 session 到 window
+   * 用于创建新对话时建立 sessionId → windowId 映射
+   *
+   * @param sessionId ACP 会话 ID
+   * @param windowId 窗口 ID
+   */
+  bindSession?(sessionId: string, windowId: number): void;
+  /**
+   * 解除 session 绑定
+   *
+   * @param sessionId ACP 会话 ID
+   */
+  unbindSession?(sessionId: string): void;
+  /**
+   * 获取所有窗口的所有会话
+   * Channel 层负责向所有窗口广播并聚合结果
+   *
+   * @returns Promise<ConversationData[]> 所有窗口的会话列表
+   */
+  getAllSessions(): Promise<ConversationData[]>;
+  /** 注册事件监听器 */
+  on(event: string, handler: (data?: any) => void): void;
+  /** 注销事件监听器 */
+  off(event: string, handler: (data?: any) => void): void;
+  /** 触发事件（向外部发送事件） */
+  emit(event: string, data?: any): void;
+  /** 清除所有事件监听器 */
+  clear?(): void;
+}
+//#endregion
+//#region ../agent-provider/lib/common/_legacy/types.d.ts
+/**
+ * 会话信息(后端格式)
+ */
+interface ConversationData {
+  id: string;
+  title: string;
+  lastMessage: string;
+  timestamp: number;
+  branch?: string;
+}
+//#endregion
+//#region ../agent-client-protocol/lib/common/types.d.ts
+/**
+ * Types of artifacts that can be created by the agent
+ *
+ * Note: 'task' and 'diff' were removed as they can be implemented using standard ACP:
+ * - task: Use `sessionUpdate: "plan"` with `PlanEntry[]`
+ * - diff: Use `ToolCallContent` with `type: "diff"`
+ */
+type ArtifactType = 'plan' | 'walkthrough' | 'snapshot' | 'video' | 'web_preview' | 'custom';
+/**
+ * Status of an artifact
+ */
+type ArtifactStatus = 'creating' | 'ready' | 'updating' | 'archived';
+/**
+ * Artifact metadata base interface
+ */
+interface ArtifactMeta {
+  mimeType?: string;
+  size?: number;
+  preview?: string;
+  [key: string]: unknown;
+}
+/**
+ * Base artifact interface
+ */
+interface BaseArtifact {
+  id: string;
+  type: ArtifactType;
+  title: string;
+  uri: string;
+  status: ArtifactStatus;
+}
+/**
+ * An artifact created by the agent
+ * Generic parameter allows type-safe metadata for specific artifact types
+ */
+interface Artifact<TMeta extends ArtifactMeta = ArtifactMeta> extends BaseArtifact {
+  _meta?: TMeta;
+}
+/**
+ * Question option structure
+ */
+interface QuestionOption {
+  /** Display text (1-5 words) */
+  label: string;
+  /** Option description */
+  description: string;
+}
+/**
+ * Single question structure
+ */
+interface UserQuestion {
+  /** Question ID */
+  id: string;
+  /** Question text */
+  question: string;
+  /** Short label (max 12 chars) */
+  header?: string;
+  /** Available options (2-4) */
+  options: QuestionOption[];
+  /** Allow multiple selections */
+  multiSelect?: boolean;
+}
+/**
+ * Schema for 'question' inputType
+ */
+interface QuestionInputSchema {
+  /** Questions to ask (1-4) */
+  questions: UserQuestion[];
+}
+/**
+ * Response data for 'question' inputType
+ */
+interface QuestionInputData {
+  /** User's answers keyed by question ID */
+  answers: Record<string, string | string[]>;
+}
+/**
+ * Token usage information
+ * Sent via extNotification: _codebuddy.ai/usage_update
+ */
+interface UsageUpdate {
+  sessionId: string;
+  inputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+  cost?: number;
+  model?: string;
+  _meta?: Record<string, unknown>;
+}
+/**
+ * Checkpoint information visible to clients
+ */
+interface CheckpointInfo {
+  /** Checkpoint ID */
+  id: string;
+  /** Label/description */
+  label?: string;
+  /** Creation timestamp */
+  createdAt: number;
+  /** File change summary */
+  fileChanges: FileChangeSummary;
+}
+/**
+ * File change summary for a checkpoint
+ */
+interface FileChangeSummary {
+  /** List of changed files */
+  files: FileChangeInfo[];
+  /** Total lines added */
+  totalAdditions: number;
+  /** Total lines deleted */
+  totalDeletions: number;
+}
+/**
+ * Change type for a file
+ */
+type FileChangeType = 'created' | 'modified' | 'deleted';
+/**
+ * Information about a single file change
+ */
+interface FileChangeInfo {
+  /** File URI (agent://files/{path}) */
+  uri: string;
+  /** Type of change */
+  changeType: FileChangeType;
+  /** Lines added */
+  additions: number;
+  /** Lines deleted */
+  deletions: number;
+  /** Unified diff format content */
+  diff?: string;
+  /** File language */
+  language?: string;
+  /** Virtual URI for original content (agent-diff://...) */
+  originalUri?: string;
+  /** Virtual URI for modified content (agent-diff://...) */
+  modifiedUri?: string;
+}
+//#endregion
+//#region ../agent-client-protocol/lib/common/sdk.d.ts
+/**
+ * Configuration for a specific artifact type
+ */
+interface ArtifactTypeConfig {
+  /** Whether this artifact type is enabled */
+  enabled?: boolean;
+}
+/**
+ * Artifacts configuration in codebuddy.ai extension
+ */
+type ArtifactsConfig = { [K in ArtifactType]?: ArtifactTypeConfig };
+/**
+ * codebuddy.ai extension capabilities for Client
+ */
+interface CodebuddyClientMeta {}
+/**
+ * codebuddy.ai extension capabilities for Agent
+ */
+interface CodebuddyAgentMeta {
+  /** Artifact types the agent can produce */
+  artifacts?: ArtifactsConfig;
+  /** Whether the agent supports checkpoint notifications */
+  checkpoint?: boolean;
+}
+/**
+ * Client capabilities with codebuddy.ai extensions
+ */
+interface ClientCapabilities$1 extends ClientCapabilities {
+  _meta?: {
+    'codebuddy.ai'?: CodebuddyClientMeta;
+    [key: string]: unknown;
+  } | null;
+}
+/**
+ * Agent capabilities with codebuddy.ai extensions
+ */
+interface AgentCapabilities extends AgentCapabilities$1 {
+  _meta?: {
+    'codebuddy.ai'?: CodebuddyAgentMeta;
+    [key: string]: unknown;
+  } | null;
+}
+//#endregion
+//#region ../agent-client-protocol/lib/common/client/questions.d.ts
+/**
+ * Strongly-typed question request for client API
+ * Narrows ToolInputRequest to 'question' inputType with proper schema typing
+ */
+interface QuestionRequest {
+  /** Session ID */
+  sessionId: string;
+  /** Associated tool call ID */
+  toolCallId: string;
+  /** Questions to present to the user */
+  questions: QuestionInputSchema['questions'];
+  /** Request timeout in ms */
+  timeout?: number;
+  /** Additional metadata */
+  _meta?: Record<string, unknown>;
+}
+//#endregion
+//#region ../agent-client-protocol/lib/common/client/types.d.ts
+/**
+ * Client connection states
+ */
+type ClientState = 'disconnected' | 'connecting' | 'connected' | 'initialized' | 'error';
+/**
+ * Logger interface
+ */
+interface Logger$1 {
+  debug(message: string, ...args: unknown[]): void;
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Events emitted by the client
+ */
+interface ClientEvents extends Record<string, unknown> {
+  connecting: void;
+  connected: void;
+  disconnected: void;
+  error: Error;
+  stateChange: {
+    previous: ClientState;
+    current: ClientState;
+  };
+  sessionUpdate: SessionNotification;
+  artifactCreated: Artifact;
+  artifactUpdated: Artifact;
+  artifactDeleted: Artifact;
+  usageUpdate: UsageUpdate;
+  permissionRequest: {
+    requestId: string;
+    params: RequestPermissionRequest;
+  };
+  permissionResolved: {
+    requestId: string;
+    optionId: string;
+  };
+  permissionRejected: {
+    requestId: string;
+    reason?: string;
+  };
+  permissionTimeout: {
+    requestId: string;
+  };
+  questionRequest: {
+    toolCallId: string;
+    request: QuestionRequest;
+  };
+  questionAnswered: {
+    toolCallId: string;
+    answers: QuestionInputData;
+  };
+  questionCancelled: {
+    toolCallId: string;
+    reason?: string;
+  };
+  questionTimeout: {
+    toolCallId: string;
+  };
+  checkpointCreated: CheckpointInfo;
+  checkpointUpdated: CheckpointInfo;
+}
+//#endregion
+//#region ../agent-provider/lib/common/providers/local-agent-provider/acp/types.d.ts
+/**
+ * 可用命令定义 (符合 ACP 协议)
+ * 参考: https://agentclientprotocol.com/protocol/slash-commands
+ */
+interface AvailableCommand {
+  /** 命令名称 (如 "web", "test", "plan") */
+  readonly name: string;
+  /** 人类可读的命令描述 */
+  readonly description: string;
+  /** 可选的输入规范 */
+  readonly input?: {
+    /** 输入提示，当用户未提供输入时显示 */readonly hint?: string;
+  };
+}
+//#endregion
+//#region ../agent-provider/lib/common/types.d.ts
+/**
+ * Base options for filesystem operations
+ * 对齐 e2b SDK FilesystemRequestOpts
+ */
+interface FilesystemRequestOpts {
+  user?: string;
+  requestTimeoutMs?: number;
+}
+/**
+ * Options for list operation
+ * 对齐 e2b SDK FilesystemListOpts
+ */
+interface FilesystemListOpts extends FilesystemRequestOpts {
+  depth?: number;
+}
+/**
+ * Options for watchDir operation
+ * 对齐 e2b SDK WatchOpts
+ */
+interface WatchOpts extends FilesystemRequestOpts {
+  timeoutMs?: number;
+  onExit?: (err?: Error) => void | Promise<void>;
+  recursive?: boolean;
+}
+/**
+ * Entry for batch write operation
+ * 对齐 e2b SDK WriteEntry
+ */
+type WriteEntry = {
+  path: string;
+  data: string | ArrayBuffer | Blob | ReadableStream;
+};
+/**
+ * E2B Sandbox connection information
+ * 与 e2b SDK 的 ConnectionOpts 对齐
+ */
+interface E2BSandboxConnectionInfo {
+  /** Sandbox ID */
+  sandboxId: string;
+  /** API key for authentication (e2b_ 开头的 key) */
+  apiKey?: string;
+  /** Access token for authentication (JWT 格式的 token) */
+  accessToken?: string;
+  /** Domain for the API (不带 https://) */
+  domain?: string;
+  /** API URL override (internal) */
+  apiUrl?: string;
+  /** Request timeout in milliseconds */
+  requestTimeoutMs?: number;
+  /** Debug mode */
+  debug?: boolean;
+  /**
+  * Additional headers to send with the request.
+  */
+  headers?: Record<string, string>;
+}
+/**
+ * Filesystem resource interface
+ * Mirrors e2b SDK Filesystem API
+ * 完全对齐 e2b SDK 的 Filesystem 类
+ */
+interface FilesResource {
+  /** Read file content as text (default) */
+  read(path: string, opts?: FilesystemRequestOpts & {
+    format?: 'text';
+  }): Promise<string>;
+  /** Read file content as bytes */
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'bytes';
+  }): Promise<Uint8Array>;
+  /** Read file content as blob */
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'blob';
+  }): Promise<Blob>;
+  /** Read file content as stream */
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'stream';
+  }): Promise<ReadableStream<Uint8Array>>;
+  /** Write content to a single file */
+  write(path: string, data: string | ArrayBuffer | Blob | ReadableStream, opts?: FilesystemRequestOpts): Promise<WriteInfo>;
+  /** 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[]>;
+  /** Check if path exists */
+  exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+  /** Create directory */
+  makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+  /** 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>;
+  /** Get file or directory information */
+  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  /** Watch directory for changes */
+  watchDir(path: string, onEvent: (event: FilesystemEvent) => void | Promise<void>, opts?: WatchOpts & {
+    onExit?: (err?: Error) => void | Promise<void>;
+  }): Promise<WatchHandle>;
+}
+/**
+ * Filesystem provider interface - implemented by Provider
+ */
+interface FilesystemProvider {
+  /**
+   * Get filesystem resource for an agent
+   * @param agentId - Agent ID (used to get the corresponding sandbox connection)
+   */
+  getFilesystem(agentId: string): Promise<FilesResource>;
+}
+/**
+ * Transport type for agents
+ */
+type AgentTransport = 'cloud' | 'local';
+/**
+ * Agent connection status
+ */
+type AgentStatus = 'disconnected' | 'connecting' | 'connected' | 'initialized' | 'error';
+/**
+ * Agent information
+ */
+interface Agent {
+  id: string;
+  name: string;
+  description?: string;
+  version?: string;
+  transport: AgentTransport;
+  status: AgentStatus;
+  capabilities?: AgentCapabilities;
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Session mode configuration
+ */
+interface SessionMode {
+  id: string;
+  name: string;
+  description?: string | null;
+}
+/**
+ * Session information
+ */
+interface Session {
+  id: string;
+  agentId: string;
+  availableModes?: SessionMode[];
+  currentMode?: string;
+}
+/**
+ * Parameters for creating a new session
+ */
+interface CreateSessionParams {
+  cwd: string;
+  mcpServers?: McpServerConfig[];
+}
+/**
+ * Parameters for loading an existing session
+ * If sessionId is not provided, reloads the current session
+ */
+interface LoadSessionParams {
+  /** Session ID to load (optional - uses current session if not provided) */
+  sessionId?: string;
+  cwd: string;
+  mcpServers?: McpServerConfig[];
+}
+/**
+ * MCP server configuration
+ */
+interface McpServerConfig {
+  name: string;
+  command: string;
+  args?: string[];
+  env?: Record<string, string>;
+}
+/**
+ * Prompt content block types
+ */
+type PromptContentBlock = {
+  type: 'text';
+  text: string;
+  _meta?: {
+    [key: string]: unknown;
+  } | null | undefined;
+} | {
+  type: 'image';
+  data: string;
+  mimeType: string;
+} | {
+  type: 'resource';
+  uri: string;
+};
+/**
+ * Parameters for sending a prompt
+ */
+interface PromptParams {
+  content: string | PromptContentBlock[];
+  planMode?: boolean;
+  _meta?: Record<string, unknown>;
+}
+/**
+ * Events emitted by agent connections
+ */
+interface ConnectionEvents extends ClientEvents {
+  spawn: {
+    pid: number;
+  };
+  exit: {
+    code: number | null;
+    signal: string | null;
+  };
+  questionRequest: {
+    toolCallId: string;
+    request: QuestionRequest;
+  };
+  questionAnswered: {
+    toolCallId: string;
+    answers: QuestionInputData;
+  };
+  questionCancelled: {
+    toolCallId: string;
+    reason?: string;
+  };
+  questionTimeout: {
+    toolCallId: string;
+  };
+}
+/**
+ * Event listener type
+ */
+type ConnectionEventListener<T> = (data: T) => void | Promise<void>;
+/**
+ * Abstract interface for agent connections
+ * Implemented by CloudAgentConnection and LocalAgentConnection
+ */
+interface AgentConnection {
+  /** Agent ID */
+  readonly agentId: string;
+  on<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  off<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  once<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  emit<K extends keyof ConnectionEvents>(event: K, data: ConnectionEvents[K]): boolean;
+  removeAllListeners<K extends keyof ConnectionEvents>(event?: K): this;
+  /** Transport type */
+  readonly transport: AgentTransport;
+  /** Current connection state */
+  readonly state: AgentStatus;
+  /** Whether the connection is initialized */
+  readonly isInitialized: boolean;
+  /** Agent capabilities (available after initialization) */
+  readonly capabilities?: AgentCapabilities;
+  /** Initialize response (available after initialization) */
+  readonly initializeResult?: InitializeResponse;
+  connect(): Promise<InitializeResponse>;
+  disconnect(): void | Promise<void>;
+  createSession(params: CreateSessionParams): Promise<NewSessionResponse>;
+  loadSession(params: LoadSessionParams): Promise<LoadSessionResponse>;
+  setSessionMode(sessionId: string, modeId: string): Promise<SetSessionModeResponse>;
+  /**
+   * Set the session model
+   * @experimental This API is unstable and may change
+   */
+  setSessionModel(sessionId: string, modelId: string): Promise<SetSessionModelResponse>;
+  prompt(sessionId: string, params: PromptParams): Promise<PromptResponse$1>;
+  promptStream(sessionId: string, params: PromptParams): AsyncIterable<SessionNotification>;
+  cancel(sessionId: string): Promise<void>;
+  resolvePermission(requestId: string, optionId: string): boolean;
+  rejectPermission(requestId: string, reason?: string): boolean;
+  getPendingPermissions(): Map<string, {
+    params: RequestPermissionRequest;
+    createdAt: number;
+  }>;
+  hasPendingPermissions(): boolean;
+  answerQuestion(toolCallId: string, answers: QuestionInputData): boolean;
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  getPendingQuestions(): Map<string, {
+    request: QuestionRequest;
+    createdAt: number;
+  }>;
+  hasPendingQuestions(): boolean;
+  /**
+   * 工具回调操作
+   * 用于对正在执行的工具进行 skip 或 cancel 操作
+   * @param sessionId 会话 ID
+   * @param toolCallId 工具调用 ID
+   * @param toolName 工具名称
+   * @param action 操作类型 ('skip' | 'cancel')
+   */
+  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+/**
+ * Base configuration for connections
+ */
+interface BaseConnectionConfig {
+  /** Logger instance */
+  logger?: Logger$1;
+  /** Permission timeout (ms) */
+  permissionTimeout?: number;
+  /** Auto-reject permissions on timeout */
+  permissionAutoRejectOnTimeout?: boolean;
+  /** Auto-approve all permissions */
+  autoApprove?: boolean;
+  /** Client capabilities (sent during initialization) */
+  clientCapabilities?: ClientCapabilities$1;
+}
+/**
+ * Configuration for cloud agent connections
+ */
+interface CloudConnectionConfig extends BaseConnectionConfig {
+  /** Agent endpoint URL */
+  endpoint: string;
+  /** Authorization token */
+  authToken?: string;
+  /** Custom headers */
+  headers?: Record<string, string>;
+  /** Reconnect options */
+  reconnect?: {
+    enabled?: boolean;
+    initialDelay?: number;
+    maxDelay?: number;
+    maxRetries?: number;
+  };
+  /** Initialize timeout (ms) */
+  initializeTimeout?: number;
+  /** Custom fetch implementation */
+  fetch?: typeof fetch;
+}
+/**
+ * Model reasoning configuration
+ */
+interface ModelReasoning {
+  /** Reasoning effort level */
+  effort: 'low' | 'medium' | 'high';
+  /** When to show summary */
+  summary: 'never' | 'always' | 'auto';
+}
+/**
+ * Model information
+ */
+interface ModelInfo$1 {
+  /** 模型唯一标识符，例如"gpt-3.5-turbo" */
+  readonly id: string;
+  /** 可选，模型名称，例如"GPT-3.5 Turbo" */
+  readonly name?: string;
+  /** 可选，模型供应商，例如"OpenAI" */
+  readonly vendor?: string;
+  /** 可选，模型版本，例如"2024-06-01" */
+  readonly version?: string;
+  /** 可选，模型家族，例如"gpt" */
+  readonly family?: string;
+  /** 可选，最大输入 token 数，例如 4096 */
+  readonly maxInputTokens?: number;
+  /** 可选，最大输出 token 数，例如 1024 */
+  readonly maxOutputTokens?: number;
+  /** 描述 */
+  readonly description?: string;
+  /** 英文描述 */
+  readonly descriptionEn?: string;
+  /** 中文描述 */
+  readonly descriptionZh?: string;
+  /** 是否可配置 */
+  readonly configurable?: boolean;
+  /** 已经配置 */
+  readonly configured?: boolean;
+  /** 接口地址（全路径） */
+  readonly url?: string;
+  /** 模型 apiKey，自定义模型需要 */
+  readonly apiKey?: string;
+  /** 是否支持 extra 上下文 */
+  readonly supportsExtra?: boolean;
+  /** 是否支持工具调用 */
+  readonly supportsToolCall?: boolean;
+  /** 是否支持图片 */
+  readonly supportsImages?: boolean;
+  /** 是否支持推理 */
+  readonly supportsReasoning?: boolean;
+  /** 是否只支持推理模型 */
+  readonly onlyReasoning?: boolean;
+  /** 开始上下文处理的 token 阈值 */
+  readonly maxAllowedSize?: number;
+  /** tags */
+  readonly tags?: string[];
+  /** 是否关闭多模态能力 */
+  readonly disabledMultimodal?: boolean;
+  /** 模型消耗的积分信息 */
+  readonly credits?: string;
+  /** 推理配置 */
+  readonly reasoning?: ModelReasoning;
+  /** 最多支持的图片数量 */
+  readonly maxImageCount?: number;
+  /** 是否是默认模型 */
+  readonly isDefault?: boolean;
+  /** 温度 */
+  readonly temperature?: number;
+  /** icon */
+  readonly iconUrl?: string;
+  /** 模型类型：enterprise 表示企业版模型，built-in 表示内置模型 */
+  readonly modelType?: 'enterprise' | 'built-in';
+  /** 模型可信安全级别 */
+  readonly trustLevel?: ModelTrustLevel;
+  /** 是否禁用该模型（用于安全限制等场景） */
+  readonly disabled?: boolean;
+  /** 禁用原因说明（例如："当前项目为敏感项目，建议使用内部模型"） */
+  readonly disabledReason?: string;
+  /** 禁用模型交互 */
+  readonly disabledAction?: {
+    type: 'link' | 'applyGroup';
+    text?: string;
+    link?: string;
+  };
+}
+declare enum ModelTrustLevel {
+  /** 未经验证，存在潜在风险 */
+  UNVERIFIED = "unverified",
+  /** 用户配置 */
+  CUSTOM = "custom",
+  /** 认证安全 */
+  CERTIFIED = "certified"
+}
+//#endregion
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
+/**
+ * Cloud Agent Connection implementation
+ * Uses Streamable HTTP transport to connect to cloud-hosted ACP agents
+ * Uses composition pattern - implements event emitter methods internally
+ */
+declare class CloudAgentConnection implements AgentConnection {
+  private client;
+  private listeners;
+  private onceListeners;
+  /**
+   * Flag to suppress sessionUpdate event emission during streaming.
+   * When true, onSessionUpdate callback won't emit to avoid duplicate messages with promptStream.
+   */
+  private _isStreaming;
+  readonly agentId: string;
+  readonly transport: "cloud";
+  constructor(agentId: string, config: CloudConnectionConfig);
+  private setupEventForwarding;
+  on<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  off<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  once<K extends keyof ConnectionEvents>(event: K, listener: ConnectionEventListener<ConnectionEvents[K]>): this;
+  emit<K extends keyof ConnectionEvents>(event: K, data: ConnectionEvents[K]): boolean;
+  removeAllListeners<K extends keyof ConnectionEvents>(event?: K): this;
+  get state(): AgentStatus;
+  get isInitialized(): boolean;
+  get capabilities(): AgentCapabilities | undefined;
+  get initializeResult(): InitializeResponse | undefined;
+  connect(): Promise<InitializeResponse>;
+  disconnect(): Promise<void>;
+  createSession(params: CreateSessionParams): Promise<NewSessionResponse>;
+  loadSession(params: LoadSessionParams): Promise<LoadSessionResponse>;
+  setSessionMode(sessionId: string, modeId: string): Promise<SetSessionModeResponse>;
+  setSessionModel(sessionId: string, modelId: string): Promise<SetSessionModelResponse>;
+  prompt(sessionId: string, params: PromptParams): Promise<PromptResponse$1>;
+  promptStream(sessionId: string, params: PromptParams): AsyncIterable<SessionNotification>;
+  cancel(sessionId: string): Promise<void>;
+  resolvePermission(requestId: string, optionId: string): boolean;
+  rejectPermission(requestId: string, reason?: string): boolean;
+  getPendingPermissions(): Map<string, {
+    params: RequestPermissionRequest;
+    createdAt: number;
+  }>;
+  hasPendingPermissions(): boolean;
+  answerQuestion(toolCallId: string, answers: QuestionInputData): boolean;
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  getPendingQuestions(): Map<string, {
+    request: QuestionRequest;
+    createdAt: number;
+  }>;
+  hasPendingQuestions(): boolean;
+  toolCallback(sessionId: string, toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+//#endregion
+//#region ../agent-provider/lib/common/client/types.d.ts
+/**
+ * Agent 来源类型
+ */
+type AgentStateType = 'local' | 'cloud';
+/**
+ * 云端 Agent 可见性
+ */
+type CloudAgentVisibility = 'PRIVATE' | 'PUBLIC' | 'TEAM';
+/**
+ * 云端 Agent 来源信息
+ */
+interface CloudAgentSourceInfo {
+  /** 提供商: github, gitlab 等 */
+  provider: string;
+  /** 分支/引用 */
+  ref: string;
+  /** 仓库路径 */
+  repository: string;
+}
+/**
+ * 云端 Agent 目标信息
+ */
+interface CloudAgentTarget {
+  /** 是否自动创建 PR */
+  autoCreatePr: boolean;
+  /** 分支名称 */
+  branchName?: string;
+  /** PR URL */
+  prUrl?: string;
+  /** Agent URL */
+  url?: string;
+}
+/**
+ * AgentState 基础接口
+ * 所有类型的 AgentState 都必须实现此接口
+ */
+interface BaseAgentState {
+  /** Unique agent ID */
+  id: string;
+  /** Display name */
+  name?: string;
+  /** Description */
+  description?: string;
+  /** Agent type */
+  type: AgentStateType;
+  /** Current connection status */
+  status: AgentStatus;
+  /** Agent capabilities (available after connection) */
+  capabilities?: AgentCapabilities;
+  /** When the agent was created */
+  createdAt?: Date;
+  /** When the agent was last updated */
+  updatedAt?: Date;
+}
+/**
+ * LocalAgentState - 本地 Agent 状态
+ * 来自本地 IPC 通信的 Agent
+ */
+interface LocalAgentState extends BaseAgentState {
+  type: 'local';
+  /** 工作目录 */
+  cwd: string;
+}
+/**
+ * CloudAgentState - 云端 Agent 状态
+ * 来自远程 API 的云端实例
+ */
+interface CloudAgentState extends BaseAgentState {
+  type: 'cloud';
+}
+/**
+ * AgentState - Unified agent state object exposed to client users
+ *
+ * This is the primary way clients access agent information.
+ * Uses discriminated union pattern to distinguish between local and cloud agents.
+ */
+type AgentState = LocalAgentState | CloudAgentState;
+/**
+ * 类型守卫：判断是否为 CloudAgentState
+ */
+declare function isCloudAgentState(state: AgentState): state is CloudAgentState;
+/**
+ * Logger interface
+ */
+interface Logger {
+  debug(message: string, ...args: unknown[]): void;
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Filter condition for listing agents
+ */
+interface ListAgentFilter {
+  /** Filter field name (e.g., 'status', 'name') */
+  field: string;
+  /** Filter value (comma-separated for multiple values) */
+  value: string;
+}
+/**
+ * Sort options for listing agents
+ */
+interface ListAgentSort {
+  /** Sort field (e.g., 'createdAt', 'status') */
+  orderBy: string;
+  /** Sort direction */
+  order?: 'asc' | 'desc';
+}
+/**
+ * Query options for listing agents
+ *
+ * These options are supported by both CloudAgentProvider and LocalAgentProvider.
+ * Cloud: Server-side filtering, sorting, and pagination
+ * Local: Client-side filtering and sorting, no pagination (returns all)
+ */
+interface ListAgentOptions {
+  /**
+   * Page number (starts from 1)
+   * Cloud: Used for API pagination
+   * Local: Ignored (returns all sessions)
+   */
+  page?: number;
+  /**
+   * Page size
+   * Cloud: Number of items per page (default 20, max 100)
+   * Local: Ignored (returns all sessions)
+   */
+  size?: number;
+  /**
+   * Sort options
+   * Cloud: Sorts results by specified field and order
+   * Local: Sorts results by specified field and order
+   */
+  sort?: ListAgentSort;
+  /**
+   * Filter conditions
+   * Cloud: Filters results by specified field values
+   * Local: Filters results by specified field values
+   */
+  filters?: ListAgentFilter[];
+  /**
+   * Day range filter (e.g., agents created in last N days)
+   * Cloud: Filters by creation date
+   * Local: Filters by creation date
+   */
+  dayRange?: number;
+  /**
+   * Title search keyword (matches agent title)
+   * Cloud: Server-side search
+   * Local: Client-side search
+   */
+  title?: string;
+}
+/**
+ * Pagination metadata returned from list operations
+ */
+interface PaginationInfo {
+  /** Current page number (starts from 1) */
+  page: number;
+  /** Page size */
+  size: number;
+  /** Total number of items */
+  total: number;
+  /** Total number of pages */
+  totalPages: number;
+  /** Whether there is a next page */
+  hasNext: boolean;
+  /** Whether there is a previous page */
+  hasPrev: boolean;
+}
+/**
+ * Response from list operations that includes pagination
+ */
+interface ListAgentResult<T = AgentState> {
+  /** List of agent states or session info */
+  agents: T[];
+  /** Pagination information */
+  pagination: PaginationInfo;
+}
+/**
+ * Session information (returned by list, mapped from Agent)
+ */
+interface SessionInfo {
+  /** Session ID (from agent.session) */
+  id: string;
+  /** Associated agent ID */
+  agentId: string;
+  /** Agent name */
+  name?: string;
+  /** Agent status */
+  status: AgentStatus;
+  /** When the session/agent was created */
+  createdAt?: Date;
+  /** Last activity timestamp */
+  lastActivityAt?: Date;
+  /** Working directory (for local agents) */
+  cwd?: string;
+}
+/**
+ * Parameters for creating a new session
+ */
+interface CreateSessionParams$1 {
+  /** Working directory */
+  cwd: string;
+  /** MCP server configurations */
+  mcpServers?: McpServerConfig[];
+}
+/**
+ * Parameters for loading an existing session
+ */
+interface LoadSessionParams$1 {
+  /** Session ID to load (required) */
+  sessionId: string;
+  /** Working directory */
+  cwd: string;
+  /** MCP server configurations */
+  mcpServers?: McpServerConfig[];
+}
+/**
+ * Parameters for initializing a workspace
+ */
+interface InitializeWorkspaceParams {
+  /** Working directory */
+  cwd: string;
+  /** MCP server configurations */
+  mcpServers?: McpServerConfig[];
+}
+/**
+ * Response for workspace initialization
+ */
+interface InitializeWorkspaceResponse {
+  /** Whether initialization was successful */
+  success: boolean;
+  /** Error message (if failed) */
+  error?: string;
+}
+/**
+ * Prompts resource interface (ACP verbs)
+ * Operations use the current session automatically
+ */
+interface PromptsResource {
+  /** Send a prompt and wait for completion */
+  send(params: PromptParams): Promise<PromptResponse>;
+  /** Stream a prompt (yields session updates) */
+  stream(params: PromptParams): AsyncIterable<SessionNotification$1>;
+  /** Cancel an ongoing prompt */
+  cancel(): Promise<void>;
+}
+/**
+ * Artifacts resource interface
+ */
+interface ArtifactsResource {
+  /** List all artifacts */
+  list(params?: {
+    type?: ArtifactType;
+  }): Promise<Artifact[]>;
+  /** Get a single artifact */
+  retrieve(artifactId: string): Promise<Artifact>;
+  /** Get artifact content */
+  content(artifactId: string): Promise<string>;
+}
+/**
+ * Models resource interface
+ */
+interface ModelsResource {
+  /** Get available models for a repository */
+  list(repo: string): Promise<ModelInfo$1[]>;
+}
+/**
+ * Prompt response
+ */
+interface PromptResponse {
+  /** Stop reason */
+  stopReason: 'end_turn' | 'max_tokens' | 'tool_use' | 'cancelled' | 'error';
+  /** Response metadata */
+  _meta?: Record<string, unknown>;
+}
+/**
+ * Sessions resource events for monitoring session list changes
+ */
+interface SessionsResourceEvents {
+  /** Emitted when the sessions list changes (create, delete, update) */
+  sessionsChanged: SessionInfo[];
+  /** Emitted when a new session is created */
+  sessionCreated: SessionInfo;
+  /** Emitted when a session is deleted */
+  sessionDeleted: {
+    sessionId: string;
+  };
+  /** Emitted when a session is updated (status change, etc.) */
+  sessionUpdated: SessionInfo;
+}
+/**
+ * Event handler type for sessions resource events
+ */
+type SessionsResourceEventHandler<K extends keyof SessionsResourceEvents> = (data: SessionsResourceEvents[K]) => void | Promise<void>;
+/**
+ * Session events for event subscription
+ */
+interface SessionEvents {
+  /** Emitted when session updates occur */
+  sessionUpdate: SessionNotification$1;
+  /** Emitted when an artifact is created */
+  artifactCreated: Artifact;
+  /** Emitted when an artifact is updated */
+  artifactUpdated: Artifact;
+  /** Emitted when an artifact is deleted */
+  artifactDeleted: Artifact;
+  /** Emitted when a permission request is received */
+  permissionRequest: {
+    requestId: string;
+    params: RequestPermissionRequest$1;
+  };
+  /** Emitted when a question request is received (ask_followup_question) */
+  questionRequest: {
+    toolCallId: string;
+    request: QuestionRequest;
+  };
+  /** Emitted when usage data is updated */
+  usageUpdate: UsageUpdate;
+  /** Emitted when a checkpoint is created */
+  checkpointCreated: CheckpointInfo;
+  /** Emitted when a checkpoint is updated */
+  checkpointUpdated: CheckpointInfo;
+  /** Emitted when connected to agent */
+  connected: void;
+  /** Emitted when disconnected from agent */
+  disconnected: void;
+  /** Emitted when an error occurs */
+  error: Error;
+}
+/**
+ * Event handler type for session events
+ */
+type SessionEventHandler<K extends keyof SessionEvents> = (data: SessionEvents[K]) => void | Promise<void>;
+/**
+ * Agent operations (accessed via session.agent)
+ */
+interface SessionAgentOperations {
+  /** Agent ID */
+  readonly id: string;
+  /** Agent state */
+  readonly state: AgentState;
+  /** Whether the agent is connected */
+  readonly isConnected: boolean;
+  /** Agent capabilities */
+  readonly capabilities?: AgentCapabilities;
+}
+/**
+ * Active Session interface
+ * Represents an active session with its resources and operations
+ *
+ * Key design:
+ * - Session is the primary API surface
+ * - agentState provides direct access to underlying agent state
+ * - disconnect() is called directly on session (not session.agent)
+ */
+interface ActiveSession {
+  /** Session ID */
+  readonly id: string;
+  /** Agent ID */
+  readonly agentId: string;
+  /** Agent state (direct access to underlying agent state) */
+  readonly agentState: AgentState;
+  /** Agent capabilities (available after connection) */
+  readonly capabilities?: AgentCapabilities;
+  /** Available session modes */
+  readonly availableModes?: SessionMode[];
+  /** Current session mode */
+  readonly currentMode?: string;
+  /** Available slash commands (updated via available_commands_update) */
+  readonly availableCommands: AvailableCommand[];
+  /** Whether the session is active */
+  readonly isActive: boolean;
+  /** Agent operations */
+  readonly agent: SessionAgentOperations;
+  /** Prompts resource */
+  readonly prompts: PromptsResource;
+  /** Artifacts resource */
+  readonly artifacts: ArtifactsResource;
+  /** Files resource */
+  readonly files: FilesResource;
+  /** Resolve a permission request */
+  resolvePermission(requestId: string, optionId: string): boolean;
+  /** Reject a permission request */
+  rejectPermission(requestId: string, reason?: string): boolean;
+  /** Answer a question request with user's selections */
+  answerQuestion(toolCallId: string, answers: QuestionInputData): boolean;
+  /** Cancel a question request */
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  /** Callback for tool operations (skip or cancel) */
+  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /** Set the current session mode */
+  setMode(modeId: string): Promise<void>;
+  /** Set the current session model */
+  setSessionModel(modelId: string): Promise<void>;
+  /** Subscribe to an event */
+  on<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /** Unsubscribe from an event */
+  off<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /** Subscribe to an event once */
+  once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /** Disconnect from the session/agent */
+  disconnect(): void;
+  /** Symbol.dispose for 'using' keyword support */
+  [Symbol.dispose](): void;
+}
+/**
+ * 环境类型
+ */
+type EnvironmentType = 'local' | 'cloud';
+/**
+ * Agent provider interface
+ *
+ * Responsible for:
+ * - Managing agent state/configuration storage
+ * - Creating connections to agents
+ * - Abstracting away transport details (cloud/local)
+ *
+ * The provider.connect() method returns an AgentConnection.
+ * The client wraps the connection in an ActiveSession instance.
+ *
+ * @typeParam C - Connection type used by this provider (e.g., CloudAgentConnection, LocalAgentConnection)
+ */
+interface AgentProvider<C extends AgentConnection = AgentConnection> {
+  /**
+   * Create a new agent and return its ID
+   *
+   * @param params - Optional session params (used by LocalAgentProvider to get cwd)
+   * @returns Agent ID (Cloud: UUID, Local: cwd)
+   */
+  create?(params?: CreateSessionParams$1): Promise<string>;
+  /** Get agent state by ID */
+  get(agentId: string): Promise<AgentState | undefined>;
+  /**
+   * List all agent states with pagination information
+   *
+   * @param options - Optional query parameters for filtering, sorting, and pagination
+   *                  Cloud providers use these for API queries and return server pagination
+   *                  Local providers apply client-side filtering and return synthetic pagination
+   * @returns Object containing agents array and pagination info
+   */
+  list(options?: ListAgentOptions): Promise<ListAgentResult<AgentState>>;
+  /** Connect to an agent and return the connection */
+  connect(agentId: string): Promise<C>;
+  /** Delete an agent by ID */
+  delete(agentId: string): Promise<boolean>;
+  /**
+   * Archive an agent by ID (optional)
+   * Used by CloudAgentProvider for archiving agents
+   *
+   * @param agentId - Agent ID to archive
+   * @returns Object containing the archived agent ID
+   */
+  archive?(agentId: string): Promise<{
+    id: string;
+  }>;
+  /** Filesystem provider (optional - some providers may not support filesystem operations) */
+  readonly filesystem?: FilesystemProvider;
+  /**
+   * Get available models for a repository (optional)
+   * Implementation varies by provider type
+   * @param repo - Repository identifier
+   * @returns Array of model information
+   */
+  getModels?(repo: string): Promise<ModelInfo$1[]>;
+  /**
+   * Register sessionId → agentId mapping (optional, used by LocalAgentProvider)
+   * Called after session creation to maintain the mapping for loadSession
+   *
+   * @param sessionId - Session ID returned by connection.createSession()
+   * @param agentId - Agent ID (cwd for Local)
+   */
+  registerSession?(sessionId: string, agentId: string): void;
+  /**
+   * Open a workspace window (optional, used by LocalAgentProvider)
+   *
+   * @param params - Workspace params including cwd
+   * @returns Response with success status
+   */
+  openWorkspace?(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  /**
+   * Register an event listener
+   * Provider implementations should forward events to the underlying transport
+   *
+   * @param event - Event name
+   * @param handler - Event handler function
+   */
+  on?(event: string, handler: (...args: any[]) => void): void;
+  /**
+   * Unregister an event listener
+   *
+   * @param event - Event name
+   * @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': 云端环境
+   */
+  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>;
+  /** 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
+   * @returns Object containing the archived session ID
+   */
+  archive(sessionId: string): Promise<{
+    id: string;
+  }>;
+  /** Initialize a workspace for future sessions */
+  initializeWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+  /** Models resource for getting available models */
+  readonly models: ModelsResource;
+  /** Get current workspaces list */
+  getCurrentWorkspaces(filter?: {
+    activeOnly?: boolean;
+  }): Promise<WorkspaceInfo[]>;
+  /** Subscribe to sessions resource events */
+  on<K extends keyof SessionsResourceEvents>(event: K, handler: SessionsResourceEventHandler<K>): void;
+  /** Unsubscribe from sessions resource events */
+  off<K extends keyof SessionsResourceEvents>(event: K, handler: SessionsResourceEventHandler<K>): void;
+  /** Open a workspace (for LocalAgentProvider) */
+  openWorkspace(params: InitializeWorkspaceParams): Promise<InitializeWorkspaceResponse>;
+}
+/**
+ * Workspace information (aligned with FolderSelectResult)
+ */
+interface WorkspaceInfo {
+  /** Folder path */
+  path: string;
+  /** Folder display name */
+  label: string;
+}
+//#endregion
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/api-types.d.ts
+/**
+ * Response for archive agent
+ * POST /v2/cloudagent/agentmgmt/agents/{id}/archive
+ */
+interface ArchiveAgentResponse {
+  /** Agent ID */
+  id: string;
+}
+//#endregion
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-provider.d.ts
+/**
+ * Configuration for CloudAgentProvider
+ */
+interface CloudAgentProviderOptions {
+  /** Base endpoint URL for agent management API (e.g., 'https://api.example.com') */
+  endpoint: string;
+  /** Authorization token */
+  authToken?: string;
+  /** Custom headers */
+  headers?: Record<string, string>;
+  /** Logger instance */
+  logger?: Logger;
+  /** Custom fetch implementation */
+  fetch?: typeof fetch;
+  /** Client capabilities (sent during agent initialization) */
+  clientCapabilities?: ClientCapabilities$1;
+}
+/**
+ * CloudAgentProvider - Manages cloud-hosted agents via REST API
+ *
+ * API Endpoints:
+ * - POST   {endpoint}/v2/cloudagent/agentmgmt/agents             - Create new agent
+ * - GET    {endpoint}/v2/cloudagent/agentmgmt/agents/{id}       - Get agent data
+ * - GET    {endpoint}/v2/cloudagent/agentmgmt/agents            - List all agents
+ * - POST   {endpoint}/v2/cloudagent/agentmgmt/agents/{id}/delete - Delete agent
+ * - GET    {endpoint}/v2/cloudagent/agentmgmt/agents/{id}/session - Get agent session (includes sandboxId)
+ * - GET    {endpoint}/v2/cloudagent/agentmgmt/models             - Get available models
+ *
+ * The provider stores agent endpoint configurations in the cloud backend.
+ * When connect() is called, it creates a CloudAgentConnection to the agent's
+ * endpoint and returns an Agent instance.
+ *
+ * @example
+ * ```typescript
+ * const provider = new CloudAgentProvider({
+ *     endpoint: 'https://staging-copilot.tencent.com',
+ *     authToken: 'token'
+ * });
+ *
+ * // List all agents (uses default pagination and sorting)
+ * const allAgents = await provider.list();
+ *
+ * // List agents with custom pagination
+ * const page2 = await provider.list({
+ *     page: 2,
+ *     size: 50
+ * });
+ *
+ * // List agents with filtering
+ * const runningAgents = await provider.list({
+ *     filters: [
+ *         { field: 'status', value: 'running' }
+ *     ]
+ * });
+ *
+ * // List agents with custom sorting
+ * const sortedAgents = await provider.list({
+ *     sort: {
+ *         orderBy: 'createdAt',
+ *         order: 'desc'
+ *     }
+ * });
+ *
+ * // List agents created in last 14 days with multiple filters
+ * const recentAgents = await provider.list({
+ *     dayRange: 14,
+ *     filters: [
+ *         { field: 'status', value: 'running,stopped' }
+ *     ],
+ *     page: 1,
+ *     size: 20
+ * });
+ *
+ * // Get agent state
+ * const state = await provider.get('agent-id');
+ *
+ * // Connect to agent
+ * const agent = await provider.connect('agent-id');
+ *
+ * // Use agent
+ * const session = await agent.sessions.create({ cwd: '/workspace' });
+ *
+ * // Get available models
+ * const models = await provider.getModels('my-repo');
+ * ```
+ */
+declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>, FilesystemProvider {
+  private options;
+  private logger?;
+  private fetchImpl;
+  /** Cache for filesystem instances (keyed by agentId) */
+  private filesystemCache;
+  constructor(options: CloudAgentProviderOptions);
+  /**
+   * Get the filesystem provider (returns self)
+   */
+  get filesystem(): FilesystemProvider;
+  /**
+   * Get filesystem resource for an agent
+   *
+   * Creates or returns cached E2BFilesystem instance for the agent's sandbox.
+   *
+   * @param agentId - Agent ID to get filesystem for
+   * @returns FilesResource instance for the agent's sandbox
+   */
+  getFilesystem(agentId: string): Promise<FilesResource>;
+  /**
+   * Get sandbox information from backend
+   *
+   * Uses GET {endpoint}/v2/cloudagent/agentmgmt/agents/{agentId}/session
+   * to retrieve sandbox information. Extracts sandboxId from the session response
+   * and constructs the apiUrl for E2B proxy.
+   *
+   * @param agentId - Agent ID
+   * @returns E2B Sandbox connection information with sandboxId and apiUrl
+   */
+  private getSandboxInfo;
+  /**
+   * Get agent state by ID
+   */
+  get(agentId: string): Promise<CloudAgentState | undefined>;
+  /**
+   * List all agent states with pagination information
+   *
+   * @param options - Optional query parameters for filtering, sorting, and pagination
+   * @returns Object containing agents array and pagination info
+   */
+  list(options?: ListAgentOptions): Promise<ListAgentResult<CloudAgentState>>;
+  /**
+   * Create a new agent
+   * POST {endpoint}/v2/cloudagent/agentmgmt/agents
+   */
+  create(): Promise<string>;
+  /**
+   * Connect to an agent and return the connection
+   *
+   * This method:
+   * 1. Fetches the agent configuration from the backend
+   * 2. Creates a CloudAgentConnection to the agent's endpoint
+   * 3. Connects and initializes the connection
+   * 4. Returns the connected CloudAgentConnection
+   */
+  connect(agentId: string): Promise<CloudAgentConnection>;
+  /**
+   * Delete an agent by ID
+   * POST {endpoint}/v2/cloudagent/agentmgmt/agents/{agentId}/delete
+   */
+  delete(agentId: string): Promise<boolean>;
+  /**
+   * Archive an agent by ID
+   * POST {endpoint}/v2/cloudagent/agentmgmt/agents/{agentId}/archive
+   *
+   * @param agentId - Agent ID to archive
+   * @returns ArchiveAgentResponse containing the archived agent ID
+   *
+   * @example
+   * ```typescript
+   * const result = await provider.archive('agent-123');
+   * console.log('Archived agent:', result.id);
+   * ```
+   */
+  archive(agentId: string): Promise<ArchiveAgentResponse>;
+  /**
+   * Get available models for a repository
+   *
+   * GET {endpoint}/v2/cloudagent/agentmgmt/models?repo={repo}
+   *
+   * @param repo - Repository identifier
+   * @returns Array of model names (backend only provides names, not full ModelInfo)
+   */
+  getModels(repo: string): Promise<ModelInfo$1[]>;
+  private toAgentState;
+  private request;
+}
+//#endregion
+//#region ../agent-provider/lib/common/providers/cloud-agent-provider/e2b-filesystem.d.ts
+/**
+ * E2B Filesystem Implementation
+ *
+ * Wraps E2B Sandbox SDK's filesystem operations to implement FilesResource interface.
+ *
+ * @example
+ * ```typescript
+ * const fs = await E2BFilesystem.connect({
+ *     sandboxId: 'sandbox-123',
+ *     apiKey: 'e2b_xxx'
+ * });
+ *
+ * // Read/write files
+ * await fs.write('/test.txt', 'Hello World');
+ * const content = await fs.read('/test.txt');
+ *
+ * // Watch for changes
+ * const handle = await fs.watchDir('/workspace', (event) => {
+ *     console.log('File changed:', event);
+ * });
+ * ```
+ */
+declare class E2BFilesystem implements FilesResource {
+  private sandbox;
+  constructor(sandbox: Sandbox);
+  /**
+   * Connect to an E2B Sandbox and create filesystem instance
+   */
+  static connect(info: E2BSandboxConnectionInfo): Promise<E2BFilesystem>;
+  /**
+   * Get the underlying E2B Sandbox instance
+   */
+  getSandbox(): Sandbox;
+  read(path: string, opts?: FilesystemRequestOpts & {
+    format?: 'text';
+  }): Promise<string>;
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'bytes';
+  }): Promise<Uint8Array>;
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'blob';
+  }): Promise<Blob>;
+  read(path: string, opts: FilesystemRequestOpts & {
+    format: 'stream';
+  }): Promise<ReadableStream<Uint8Array>>;
+  write(path: string, data: string | ArrayBuffer | Blob | ReadableStream, opts?: FilesystemRequestOpts): Promise<WriteInfo>;
+  write(files: WriteEntry[], opts?: FilesystemRequestOpts): Promise<WriteInfo[]>;
+  list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo$1[]>;
+  exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+  makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+  remove(path: string, opts?: FilesystemRequestOpts): Promise<void>;
+  rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo$1>;
+  watchDir(path: string, onEvent: (event: FilesystemEvent$1) => void | Promise<void>, opts?: WatchOpts & {
+    onExit?: (err?: Error) => void | Promise<void>;
+  }): Promise<WatchHandle>;
+}
+//#endregion
+//#region ../agent-provider/lib/common/client/client.d.ts
+/**
+ * AgentClient - Session-centric client
+ *
+ * Provides a session-centric API that internally manages agents.
+ * Users interact with sessions; the agent lifecycle is handled internally.
+ *
+ * @example
+ * ```typescript
+ * // Create client with a provider
+ * const provider = new CloudAgentProvider({
+ *     endpoint: 'https://api.example.com',
+ *     authToken: 'token'
+ * });
+ *
+ * const client = new AgentClient({
+ *     provider,
+ *     logger: console
+ * });
+ *
+ * // List all sessions
+ * const sessions = await client.sessions.list();
+ *
+ * // Create new session (auto-creates agent and connects)
+ * const session = await client.sessions.create({ cwd: '/workspace' });
+ * console.log(session.agentState.status);  // agent status
+ * console.log(session.agentState.id);      // agent ID
+ *
+ * // Send prompt
+ * await session.prompts.send({ content: 'Hello' });
+ *
+ * // Get available models
+ * const models = await client.sessions.models.list('my-repo');
+ *
+ * // Use 'using' keyword for automatic cleanup
+ * {
+ *     using session = await client.sessions.create({ cwd: '/workspace' });
+ *     // ... use session
+ * } // session automatically disposed
+ *
+ * // Or manually disconnect
+ * session.disconnect();
+ *
+ * // Load existing session
+ * const loadedSession = await client.sessions.load({
+ *     sessionId: 'xxx',
+ *     cwd: '/workspace'
+ * });
+ * ```
+ */
+declare class AgentClient {
+  private logger?;
+  private provider;
+  private sessionManager;
+  /**
+   * Sessions resource namespace (primary API entry point)
+   */
+  readonly sessions: ClientSessionsResource;
+  /**
+   * 运行环境类型
+   * - 'local': IDE 本地环境
+   * - 'cloud': 云端环境
+   */
+  readonly environmentType: 'local' | 'cloud';
+  constructor(options: AgentClientOptions);
+  private createSessionsResource;
+  private createModelsResource;
+  /**
+   * Dispose the client
+   *
+   * Note: Active sessions are not automatically disposed.
+   * The caller is responsible for disconnecting sessions they created.
+   */
+  dispose(): void;
+}
+//#endregion
+//#region ../agent-provider/lib/common/client/session.d.ts
+/**
+ * Filesystem getter function type
+ * Returns a FilesResource instance for file operations
+ */
+type FilesystemGetter = () => Promise<FilesResource>;
+/**
+ * Options for creating an ActiveSessionImpl instance
+ */
+interface ActiveSessionImplOptions {
+  /** Logger instance */
+  logger?: Logger;
+  /** Getter function for filesystem resource (provided by SessionManager) */
+  getFilesystem?: FilesystemGetter;
+}
+/**
+ * ActiveSessionImpl - Implements the ActiveSession interface
+ *
+ * This class wraps an AgentConnection and provides the session-centric API.
+ * It is created by SessionManager when creating or loading sessions.
+ *
+ * @example
+ * ```typescript
+ * // Created by client.sessions.new() or client.sessions.load()
+ * const session = await client.sessions.new({ cwd: '/workspace' });
+ *
+ * // Access agent state
+ * console.log(session.agentState.status);
+ *
+ * // Send prompt
+ * const response = await session.prompts.send({ content: 'Hello!' });
+ *
+ * // Cleanup
+ * session.disconnect();
+ * ```
+ */
+declare class ActiveSessionImpl implements ActiveSession {
+  private _id;
+  private _agentId;
+  private _availableModes?;
+  private _currentMode?;
+  private _availableCommands;
+  private logger?;
+  private connection;
+  private _getFilesystem?;
+  private listeners;
+  private onceListeners;
+  /**
+   * Agent operations namespace
+   */
+  readonly agent: SessionAgentOperations;
+  /**
+   * Prompts resource namespace
+   */
+  readonly prompts: PromptsResource;
+  /**
+   * Artifacts resource namespace
+   */
+  readonly artifacts: ArtifactsResource;
+  /**
+   * Files resource namespace (lazily loaded via getter)
+   */
+  readonly files: FilesResource;
+  /**
+   * Create an ActiveSessionImpl instance
+   *
+   * @param sessionId - Session ID
+   * @param agentId - Agent ID
+   * @param connection - Already connected AgentConnection
+   * @param options - Additional options
+   */
+  constructor(sessionId: string, agentId: string, connection: AgentConnection, options?: ActiveSessionImplOptions);
+  /**
+   * Session ID
+   */
+  get id(): string;
+  /**
+   * Agent ID
+   */
+  get agentId(): string;
+  /**
+   * Agent state (live connection state)
+   * Returns LocalAgentState or CloudAgentState based on transport type
+   */
+  get agentState(): AgentState;
+  /**
+   * Get agent capabilities (available after connection)
+   */
+  get capabilities(): AgentCapabilities | undefined;
+  /**
+   * Available session modes
+   */
+  get availableModes(): SessionMode[] | undefined;
+  /**
+   * Current session mode
+   */
+  get currentMode(): string | undefined;
+  /**
+   * Available slash commands
+   *
+   * When Agent sends available_commands_update, this list is automatically updated.
+   * Commands can be accessed directly without waiting for events.
+   */
+  get availableCommands(): AvailableCommand[];
+  /**
+   * Check if the session is active
+   */
+  get isActive(): boolean;
+  /**
+   * Set session modes (called after create/load)
+   */
+  setModes(availableModes?: SessionMode[], currentMode?: string): void;
+  private createAgentOperations;
+  private createPromptsResource;
+  private createArtifactsResource;
+  /**
+   * Create files resource with lazy-loaded filesystem
+   *
+   * The filesystem is lazily loaded on first use to avoid unnecessary
+   * connections to the sandbox. The actual filesystem instance is obtained
+   * via the getter function provided by SessionManager.
+   */
+  private createFilesResource;
+  /**
+   * Resolve a permission request
+   */
+  resolvePermission(requestId: string, optionId: string): boolean;
+  /**
+   * Reject a permission request
+   */
+  rejectPermission(requestId: string, reason?: string): boolean;
+  /**
+   * Answer a question request with user's selections
+   */
+  answerQuestion(toolCallId: string, answers: QuestionInputData): boolean;
+  /**
+   * Cancel a question request
+   */
+  cancelQuestion(toolCallId: string, reason?: string): boolean;
+  /**
+   * Callback for tool operations (skip or cancel)
+   * @param toolCallId Tool call ID
+   * @param toolName Tool name
+   * @param action Action to perform ('skip' or 'cancel')
+   */
+  toolCallback(toolCallId: string, toolName: string, action: 'skip' | 'cancel'): Promise<{
+    success: boolean;
+    error?: string;
+  }>;
+  /**
+   * Set the current session mode
+   *
+   * @param modeId - The mode ID to switch to (must be in availableModes)
+   * @throws Error if modeId is not in availableModes or connection fails
+   *
+   * @example
+   * ```typescript
+   * // Switch to 'code' mode
+   * await session.setMode('code');
+   *
+   * // Switch to 'architect' mode
+   * await session.setMode('architect');
+   * ```
+   */
+  setMode(modeId: string): Promise<void>;
+  /**
+   * Set the current session model
+   *
+   * @param modelId - The model ID to switch to
+   * @example
+   * ```typescript
+   * // Switch to Claude Sonnet 4
+   * await session.setSessionModel('claude-sonnet-4-20250514');
+   *
+   * // Switch to GPT-4o
+   * await session.setSessionModel('gpt-4o');
+   * ```
+   */
+  setSessionModel(modelId: string): Promise<void>;
+  /**
+   * Subscribe to session events
+   */
+  on<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /**
+   * Unsubscribe from session events
+   */
+  off<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /**
+   * Subscribe to a session event once
+   */
+  once<K extends keyof SessionEvents>(event: K, handler: SessionEventHandler<K>): this;
+  /**
+   * Emit an event to all registered listeners
+   */
+  private emit;
+  /**
+   * Remove all listeners for an event
+   */
+  private removeAllListeners;
+  /**
+   * Disconnect from the session/agent
+   */
+  disconnect(): void;
+  /**
+   * Symbol.dispose for 'using' keyword support
+   * Automatically disconnects and cleans up when session goes out of scope
+   *
+   * @example
+   * ```typescript
+   * {
+   *     using session = await client.sessions.new({ cwd: '/workspace' });
+   *     // ... use session
+   * } // session automatically disposed
+   * ```
+   */
+  [Symbol.dispose](): void;
+  private getConnectionOrThrow;
+  private setupConnectionEvents;
+  private mapPromptResponse;
+}
+//#endregion
+//#region ../agent-provider/lib/common/client/session-manager.d.ts
+/**
+ * Options for creating a SessionManager instance
+ */
+interface SessionManagerOptions {
+  /** Agent provider (required) */
+  provider: AgentProvider;
+  /** Logger instance */
+  logger?: Logger;
+}
+/**
+ * SessionManager - Session lifecycle management
+ *
+ * This class manages the relationship between sessions and agents.
+ * Since the backend is agent-centric, SessionManager handles the mapping:
+ * - Sessions are views over agents
+ * - sessionId may equal agentId in simple cases
+ *
+ * Features:
+ * - Session caching: reuses existing ActiveSession instances
+ * - Automatic cleanup on session disconnect
+ *
+ * @example
+ * ```typescript
+ * const manager = new SessionManager({ provider, logger });
+ *
+ * // List sessions
+ * const sessions = await manager.listSessions();
+ *
+ * // Create new session
+ * const session = await manager.createSession({ cwd: '/workspace' });
+ *
+ * // Load existing session (returns cached instance if available)
+ * const loaded = await manager.loadSession({ sessionId: 'xxx', cwd: '/workspace' });
+ * ```
+ */
+declare class SessionManager {
+  private provider;
+  private logger?;
+  constructor(options: SessionManagerOptions);
+  /**
+   * List all sessions with pagination info (mapped from agents)
+   *
+   * Each agent maps to a session. The sessionId is derived from the agent.
+   * Cloud: Returns server-side filtered/sorted/paginated results
+   * Local: Returns client-side filtered/sorted results (synthetic pagination)
+   *
+   * @param options - Optional query parameters for filtering, sorting, and pagination
+   */
+  listSessions(options?: ListAgentOptions): Promise<ListAgentResult<SessionInfo>>;
+  /**
+   * Create a new session
+   *
+   * Steps:
+   * 1. Create new agent (if provider supports it) or use existing
+   * 2. Connect to agent
+   * 3. Call ACP newSession
+   * 4. Register session mapping (for LocalAgentProvider)
+   * 5. Return ActiveSession instance
+   */
+  createSession(params: CreateSessionParams$1): Promise<ActiveSession>;
+  /**
+   * Load an existing session
+   *
+   * Steps:
+   * 1. Check cache for existing session
+   * 2. Find agent by sessionId (sessionId === agentId in current design)
+   * 3. Connect to agent
+   * 4. Call ACP loadSession
+   * 5. Return ActiveSession instance (cached)
+   */
+  loadSession(params: LoadSessionParams$1): Promise<ActiveSession>;
+}
+//#endregion
+//#region ../agent-provider/lib/backend/agent-api.d.ts
+/**
+ * Cloud Agent API 类型定义
+ *
+ * 定义与 /v2/cloudagent/agentmgmt/agents API 相关的数据结构
+ */
+/**
+ * 过滤条件
+ */
+interface AgentFilter {
+  /** 过滤字段 */
+  field: string;
+  /** 过滤值 */
+  value: string;
+}
+/**
+ * 排序条件
+ */
+interface SortCondition {
+  /** 排序方向: asc | desc */
+  order: 'asc' | 'desc';
+  /** 排序字段 */
+  orderBy: string;
+}
+/**
+ * 获取 Agent 列表请求参数
+ */
+interface GetAgentsRequest {
+  /** 时间范围（天） */
+  dayRange?: number;
+  /** 过滤条件列表 */
+  filters?: AgentFilter[];
+  /** 页码 */
+  page?: number;
+  /** 每页大小 */
+  size?: number;
+  /** 排序条件 */
+  sort?: SortCondition;
+}
+/**
+ * Agent 来源信息
+ */
+interface CloudAgentSource {
+  /** 提供商: github, gitlab 等 */
+  provider: string;
+  /** 分支/引用 */
+  ref: string;
+  /** 仓库路径 */
+  repository: string;
+}
+/**
+ * Agent 目标信息
+ */
+interface CloudAgentTarget$1 {
+  /** 是否自动创建 PR */
+  autoCreatePr: boolean;
+  /** 分支名称 */
+  branchName?: string;
+  /** PR URL */
+  prUrl?: string;
+  /** Agent URL */
+  url?: string;
+}
+/**
+ * Agent 状态
+ */
+type CloudAgentStatus = 'CREATING' | 'RUNNING' | 'STOPPED' | 'FAILED' | 'DELETING';
+/**
+ * Agent 可见性
+ */
+type CloudAgentVisibility$1 = 'PRIVATE' | 'PUBLIC' | 'TEAM';
+/**
+ * Cloud Agent 信息
+ * 重命名为 CloudAgent 以避免与 ACP SDK 的 Agent 类型冲突
+ */
+interface CloudAgent {
+  /** 创建时间 (ISO 8601) */
+  createdAt: string;
+  /** Agent ID */
+  id: string;
+  /** Agent 名称 */
+  name: string;
+  /** 来源信息 */
+  source: CloudAgentSource;
+  /** 状态 */
+  status: CloudAgentStatus;
+  /** 摘要 */
+  summary?: string;
+  /** 目标信息 */
+  target: CloudAgentTarget$1;
+  /** 可见性 */
+  visibility: CloudAgentVisibility$1;
+}
+/**
+ * 分页信息
+ */
+interface Pagination {
+  /** 是否有下一页 */
+  hasNext: boolean;
+  /** 是否有上一页 */
+  hasPrev: boolean;
+  /** 当前页码 */
+  page: number;
+  /** 每页大小 */
+  size: number;
+  /** 总数 */
+  total: number;
+  /** 总页数 */
+  totalPages: number;
+}
+/**
+ * 获取 Agent 列表响应
+ */
+interface GetAgentsResponse {
+  /** Agent 列表 */
+  agents: CloudAgent[];
+  /** 分页信息 */
+  pagination: Pagination;
+}
+//#endregion
+//#region ../agent-provider/lib/backend/types.d.ts
+/**
+ * 账号版本类型
+ */
+type Edition = 'pro' | 'personal' | 'ultimate' | 'exclusive';
+/**
+ * 版本展示类型（用于 UI 展示）
+ * - free: 免费版（个人版未订阅 Pro）
+ * - pro: Pro 版（个人版已订阅 Pro）
+ * - ultimate: 旗舰版（团队版）
+ * - exclusive: 专享版（企业版）
+ */
+type EditionDisplayType = 'free' | 'pro' | 'ultimate' | 'exclusive';
+/**
+ * 部署状态
+ */
+interface DeployStatus {
+  statusCode: number;
+  statusMsg: string;
+  detailMsg: string;
+}
+/**
+ * 套餐代码
+ */
+type CommodityCode = 'free' | 'proMon' | 'gift' | 'activity' | 'proYear' | 'freeMon' | 'extra';
+/**
+ * 账号套餐信息
+ */
+interface AccountPlan {
+  /** 是否是 Pro 版本 */
+  isPro: boolean;
+  /** 到期时间戳 */
+  expireAt?: string | number;
+  /** 自动续费标志 0-关闭 1-开启 */
+  renewFlag: 0 | 1;
+  /** 套餐代码 */
+  PackageCode?: CommodityCode;
+  /** 套餐名称 */
+  name: string;
+}
+/**
+ * 账号信息
+ */
+interface Account {
+  /** 用户ID（唯一标识） */
+  uid: string;
+  /** 用户昵称 */
+  nickname: string;
+  /** 版本类型 */
+  type: Edition;
+  /** 版本展示类型（用于 UI 展示） */
+  editionType: EditionDisplayType;
+  /** 是否最后一次登录 */
+  lastLogin: boolean;
+  /** 企业ID */
+  enterpriseId?: string;
+  /** 企业名称 */
+  enterpriseName?: string;
+  /** 企业LOGO */
+  enterpriseLogo?: string;
+  /** 企业内用户名 */
+  enterpriseUserName?: string;
+  /** 插件是否启用 */
+  pluginEnabled?: boolean;
+  /** 部署状态 */
+  deployStatus?: DeployStatus;
+  /** 是否是 Pro 版本 */
+  isPro?: boolean;
+  /** 到期时间戳 */
+  expireAt?: string | number;
+  /** 自动续费标志 0-关闭 1-开启 */
+  renewFlag?: 0 | 1;
+  /** 套餐代码 */
+  PackageCode?: CommodityCode;
+  /** 套餐名称 */
+  name?: string;
+}
+/**
+ * 推理配置
+ */
+interface ReasoningConfig {
+  /** 推理努力程度 */
+  effort: 'low' | 'medium' | 'high';
+  /** 摘要模式 */
+  summary: 'auto' | 'always' | 'never';
+}
+/**
+ * 模型信息
+ */
+interface ModelInfo {
+  /** 模型ID */
+  id: string;
+  /** 模型名称 */
+  name: string;
+  /** 供应商 */
+  vendor: string;
+  /** 最大输出 token 数 */
+  maxOutputTokens: number;
+  /** 最大输入 token 数 */
+  maxInputTokens: number;
+  /** 是否支持工具调用 */
+  supportsToolCall: boolean;
+  /** 是否支持图像 */
+  supportsImages: boolean;
+  /** 是否禁用多模态 */
+  disabledMultimodal: boolean;
+  /** 最大允许大小 */
+  maxAllowedSize: number;
+  /** 是否支持推理 */
+  supportsReasoning: boolean;
+  /** 是否仅推理模式 */
+  onlyReasoning: boolean;
+  /** 温度参数 */
+  temperature: number;
+  /** 推理配置 */
+  reasoning: ReasoningConfig;
+  /** 英文描述 */
+  descriptionEn: string;
+  /** 中文描述 */
+  descriptionZh: string;
+}
+/**
+ * GetModels 请求参数
+ */
+interface GetModelsRequest {
+  /** 仓库路径 */
+  repository: string;
+}
+/**
+ * GetModels 响应
+ */
+interface GetModelsResponse {
+  /** 模型列表 */
+  models: ModelInfo[];
+}
+/**
+ * Backend Provider 配置选项
+ */
+interface BackendProviderConfig {
+  /** API 基础 URL (例如: https://api.example.com) */
+  baseUrl: string;
+  /** 认证 Token */
+  authToken?: string;
+}
+/**
+ * IBackendProvider 接口
+ *
+ * 定义与后端 API 交互的抽象接口
+ */
+interface IBackendProvider {
+  /**
+   * 获取 Agent 列表
+   * @param request 请求参数
+   * @returns Promise<GetAgentsResponse> Agent 列表响应
+   */
+  getAgents(request: GetAgentsRequest): Promise<GetAgentsResponse>;
+  /**
+   * 获取可用模型列表
+   * @param request 请求参数（包含仓库路径）
+   * @returns Promise<GetModelsResponse> 模型列表响应
+   */
+  getModels(request: GetModelsRequest): Promise<GetModelsResponse>;
+  /**
+   * 获取当前账号信息
+   * @returns Promise<Account | null> 账号信息，未登录时返回 null
+   */
+  getAccount(): Promise<Account | null>;
+  /**
+   * 触发登录流程
+   * - Web 环境: 跳转到登录页面
+   * - IDE 环境: 通过 IPC 通知 IDE 打开登录流程
+   */
+  login(): Promise<void>;
+  /**
+   * 登出账号
+   */
+  logout(): Promise<void>;
+  /**
+   * 监听事件（可选，用于 IPC 环境）
+   * @param event 事件名称
+   * @param callback 回调函数
+   * @returns 取消订阅函数
+   */
+  on?(event: string, callback: (data?: unknown) => void): () => void;
+}
+//#endregion
+//#region ../agent-provider/lib/backend/backend-provider.d.ts
+/**
+ * Backend Provider 实现类
+ */
+declare class BackendProvider implements IBackendProvider {
+  private readonly baseUrl;
+  private readonly authToken?;
+  constructor(config: BackendProviderConfig);
+  /**
+   * 获取 Agent 列表
+   * API 端点: GET /v2/cloudagent/agentmgmt/agents
+   */
+  getAgents(request?: GetAgentsRequest): Promise<GetAgentsResponse>;
+  /**
+   * 获取可用模型列表
+   * API 端点: GET /v2/cloudagent/models (假设)
+   *
+   * 当前实现: 返回 Mock 数据
+   */
+  getModels(request: GetModelsRequest): Promise<GetModelsResponse>;
+  /**
+   * 获取当前账号信息
+   * API 端点: GET /console/accounts (返回账号列表)
+   *
+   * 逻辑：
+   * 1. 从 localStorage 读取 CODEBUDDY_IDE_SELECTED_ACCOUNT_ID
+   * 2. 根据 CODEBUDDY_IDE_SELECTED_ACCOUNT_ID 找到对应账号
+   *    - personal 类型: 用 uid 匹配
+   *    - 其他类型: 用 enterpriseId 匹配
+   * 3. 如果没有选中的账号，跳转到账号选择页面
+   * 4. 获取套餐信息并合并到账号中
+   */
+  getAccount(): Promise<Account | null>;
+  /**
+   * 获取当前套餐信息
+   * 从计量计费接口获取用户的套餐信息
+   * API: POST /billing/meter/get-user-resource
+   */
+  private getCurrentPlan;
+  /**
+   * 根据账号类型和 Pro 状态计算版本展示类型
+   * - personal + isPro = 'pro'
+   * - personal + !isPro = 'free'
+   * - ultimate = 'ultimate' (旗舰版/团队版)
+   * - exclusive = 'exclusive' (专享版/企业版)
+   */
+  private getEditionDisplayType;
+  /**
+   * 触发登录流程
+   * Web 环境: 跳转到登录页面
+   */
+  login(): Promise<void>;
+  /**
+   * 登出账号
+   * Web 环境: 跳转到登出页面或清除 cookie
+   */
+  logout(): Promise<void>;
+}
+/**
+ * 创建 BackendProvider 实例
+ */
+declare function createBackendProvider(config: BackendProviderConfig): BackendProvider;
+//#endregion
+//#region ../agent-provider/lib/backend/ipc-backend-provider.d.ts
+/**
+ * IPC Backend Provider 配置
+ */
+interface IPCBackendProviderConfig {
+  /** Widget Channel 接口 */
+  channel: IWidgetChannel;
+  /** 是否启用调试日志 */
+  debug?: boolean;
+  /** 请求超时时间（毫秒，默认 30000） */
+  timeoutMs?: number;
+}
+/**
+ * IPC Backend Provider 实现类
+ *
+ * 通过 IWidgetChannel 与后端通信获取 Agent 列表
+ */
+declare class IPCBackendProvider implements IBackendProvider {
+  private readonly channel;
+  private readonly debug;
+  private readonly timeoutMs;
+  constructor(config: IPCBackendProviderConfig);
+  /**
+   * 发送统一格式的后端请求
+   * @param requestType 请求类型
+   * @param params 请求参数
+   * @returns 响应数据
+   */
+  private sendBackendRequest;
+  /**
+   * 获取 Agent 列表
+   * 通过 IWidgetChannel 发送请求到后端
+   */
+  getAgents(request?: GetAgentsRequest): Promise<GetAgentsResponse>;
+  /**
+   * 获取可用模型列表
+   * 通过 IWidgetChannel 发送请求到后端
+   */
+  getModels(request: GetModelsRequest): Promise<GetModelsResponse>;
+  /**
+   * 获取当前账号信息
+   * IDE 环境: 通过 IPC 获取账号信息
+   */
+  getAccount(): Promise<Account | null>;
+  /**
+   * 触发登录流程
+   * IDE 环境: 通过 IPC 通知 IDE 打开登录流程
+   */
+  login(): Promise<void>;
+  /**
+   * 登出账号
+   * IDE 环境: 通过 IPC 通知 IDE 登出
+   */
+  logout(): Promise<void>;
+  /**
+   * 监听 channel 事件
+   * 用于监听账户变化等事件
+   */
+  on(event: string, callback: (data?: unknown) => void): () => void;
+  /**
+   * 调试日志
+   */
+  private log;
+}
+/**
+ * 创建 IPCBackendProvider 实例
+ */
+declare function createIPCBackendProvider(config: IPCBackendProviderConfig): IPCBackendProvider;
+//#endregion
+export { type Account, type AccountPlan, type ActiveSession, ActiveSessionImpl, type AgentCapabilities, AgentClient, type AgentClientOptions, type AgentConnection, type Agent as AgentInfo, type AgentProvider, type AgentState, type AgentStateType, type AgentStatus, type AgentTransport, type PromptResponse as ApiPromptResponse, type ArtifactsResource, BackendProvider, type BackendProviderConfig, type BaseAgentState, type BaseConnectionConfig, type CreateSessionParams as ClientCreateSessionParams, type CreateSessionParams, type LoadSessionParams as ClientLoadSessionParams, type LoadSessionParams, type ClientSessionsResource, CloudAgentConnection, CloudAgentProvider, type CloudAgentProviderOptions, type CloudAgentSourceInfo, type CloudAgentState, type CloudAgentTarget, type CloudAgentVisibility, type CloudConnectionConfig, type CommodityCode, type ConnectionEvents, type DeployStatus, E2BFilesystem, type E2BSandboxConnectionInfo, type Edition, type EditionDisplayType, type EntryInfo, type FilesResource, type Filesystem, type FilesystemListOpts, type FilesystemProvider, type FilesystemRequestOpts, type GetModelsRequest, type GetModelsResponse, type IBackendProvider, IPCBackendProvider, type ListAgentFilter, type ListAgentOptions, type ListAgentSort, type Logger, type McpServerConfig, type ModelInfo, type PromptContentBlock, type PromptParams, type PromptsResource, type ReasoningConfig, type Session, type SessionAgentOperations, type SessionEventHandler, type SessionEvents, type SessionInfo, SessionManager, type SessionMode, type WatchOpts, type WriteEntry, createBackendProvider, createIPCBackendProvider, isCloudAgentState };
+//# sourceMappingURL=index.d.mts.map