@tencent-ai/cloud-agent-sdk 0.2.12 → 0.2.13-next.bb9822d.20260204

package/dist/index.d.cts

@@ -339,12 +339,240 @@ interface ClientEvents extends Record<string, unknown> {
  */
 type QuestionAnswers = Record<string, string | string[]>;
 //#endregion
-//#region ../agent-provider/lib/backend/types.d.ts
+//#region ../agent-provider/lib/backend/service/oauth-repository-types.d.ts
 /**
- * Backend Provider 类型定义
+ * OAuth Repository Types
  *
- * 定义 IBackendProvider 接口和配置
+ * 定义 OAuth 连接器相关的仓库和分支操作类型
+ */
+/**
+ * Connector name type for OAuth providers
+ */
+type OauthConnectorName$1 = 'github' | 'gongfeng' | 'cnb';
+/**
+ * Branch information from OAuth connector
+ * GET /console/as/connector/oauth/{name}/branches
+ */
+interface OauthBranch$1 {
+  /** Branch name */
+  name: string;
+  /** Whether the branch is protected */
+  protected: boolean;
+  /** Latest commit SHA */
+  commit_sha: string;
+  /** Latest commit URL */
+  commit_url: string;
+}
+/**
+ * GitHub 分支查询参数
+ */
+interface GitHubBranchParams$1 {
+  /** Repository owner (e.g., "CodeBuddy-Official-Account") */
+  owner: string;
+  /** Repository name (e.g., "CodeBuddyIDE") */
+  repo: string;
+}
+/**
+ * Gongfeng 分支查询参数
+ */
+interface GongfengBranchParams$1 {
+  /** Project ID (e.g., "1611499") */
+  project_id: string;
+}
+/**
+ * CNB 分支查询参数
+ */
+interface CNBBranchParams$1 {
+  /** Repository path: org/repo (e.g., "genie/genie-ide") */
+  repo: string;
+}
+/**
+ * GitHub repository owner information
+ */
+interface OauthGitHubRepoOwner {
+  /** Owner login name */
+  login: string;
+  /** Owner avatar URL */
+  avatar_url: string;
+  /** Owner API URL */
+  url: string;
+  /** Owner HTML URL */
+  html_url: string;
+  /** Owner followers URL */
+  followers_url: string;
+  /** Owner starred URL */
+  starred_url: string;
+  /** Owner repos URL */
+  repos_url: string;
+  /** Owner events URL */
+  events_url: string;
+}
+/**
+ * GitHub repository information
+ * From ListReposResponse.GitHubRepos
+ */
+interface OauthGitHubRepo$1 {
+  /** Repository name */
+  name: string;
+  /** Full repository name (owner/repo) */
+  full_name: string;
+  /** Whether the repository is private */
+  private: boolean;
+  /** Repository HTML URL */
+  html_url: string;
+  /** Repository API URL */
+  url: string;
+  /** Repository teams URL */
+  teams_url: string;
+  /** Repository hooks URL */
+  hooks_url: string;
+  /** Repository events URL */
+  events_url: string;
+  /** Repository branches URL */
+  branches_url: string;
+  /** Repository git commits URL */
+  git_commits_url: string;
+  /** Repository merges URL */
+  merges_url: string;
+  /** Repository pulls URL */
+  pulls_url: string;
+  /** Repository git URL */
+  git_url: string;
+  /** Repository clone URL */
+  clone_url: string;
+  /** Repository SVN URL */
+  svn_url: string;
+  /** Repository downloads URL */
+  downloads_url: string;
+  /** Repository description */
+  description: string;
+  /** Repository owner */
+  owner: OauthGitHubRepoOwner;
+  /** Number of forks */
+  forks_count: number;
+}
+/**
+ * Gongfeng repository namespace information
+ */
+interface OauthGongFengRepoNamespace {
+  /** Namespace name */
+  name: string;
+  /** Namespace description */
+  description: string;
+  /** Namespace path */
+  path: string;
+}
+/**
+ * Gongfeng repository owner information
  */
+interface OauthGongFengRepoOwner {
+  /** Owner username */
+  username: string;
+  /** Owner web URL */
+  web_url: string;
+  /** Owner name */
+  name: string;
+  /** Owner state */
+  state: string;
+  /** Owner avatar URL */
+  avatar_url: string;
+}
+/**
+ * Gongfeng (工蜂) repository information
+ * From ListReposResponse.GongFengRepos
+ */
+interface OauthGongFengRepo$1 {
+  /** Repository ID */
+  id: number;
+  /** Repository description */
+  description: string;
+  /** Whether the repository is public */
+  public: boolean;
+  /** Whether the repository is archived */
+  archived: boolean;
+  /** Visibility level */
+  visibility_level: string;
+  /** Public visibility */
+  public_visibility: number;
+  /** Repository namespace */
+  namespace: OauthGongFengRepoNamespace;
+  /** Repository owner */
+  owner: OauthGongFengRepoOwner;
+  /** Repository name */
+  name: string;
+  /** Name with namespace */
+  name_with_namespace: string;
+  /** Repository path */
+  path: string;
+  /** Path with namespace */
+  path_with_namespace: string;
+  /** Repository type (Git/SVN) */
+  type: string;
+  /** Default branch */
+  default_branch: string;
+  /** SSH URL to repository */
+  ssh_url_to_repo: string;
+  /** HTTP URL to repository */
+  http_url_to_repo: string;
+  /** HTTPS URL to repository */
+  https_url_to_repo: string;
+  /** Web URL */
+  web_url: string;
+  /** Avatar URL */
+  avatar_url: string;
+  /** Forked from project */
+  forked_from_project: string;
+}
+/**
+ * CNB repository information
+ * From ListReposResponse.CNBRepos
+ */
+interface OauthCNBRepo$1 {
+  /** Created timestamp */
+  created_at: string;
+  /** Repository description */
+  description: string;
+  /** Repository name */
+  name: string;
+  /** Repository path */
+  path: string;
+  /** Repository site */
+  site: string;
+  /** Repository status */
+  status: number;
+  /** Repository topics */
+  topics: string;
+  /** Visibility level */
+  visibility_level: string;
+  /** Web URL */
+  web_url: string;
+}
+/**
+ * Response for listing repositories
+ * GET /console/as/connector/oauth/{name}/repos
+ */
+interface ListReposResponse$1 {
+  /**
+   * GitHub repositories grouped by installation id
+   * Map: installation_id => repository list
+   */
+  github_repos?: Record<number, OauthGitHubRepo$1[]>;
+  /** Gongfeng repositories */
+  gongfeng_repos?: OauthGongFengRepo$1[];
+  /** CNB repositories */
+  cnb_repos?: OauthCNBRepo$1[];
+}
+//#endregion
+//#region ../agent-provider/lib/backend/types.d.ts
+type OauthConnectorName = OauthConnectorName$1;
+type OauthBranch = OauthBranch$1;
+type GitHubBranchParams = GitHubBranchParams$1;
+type GongfengBranchParams = GongfengBranchParams$1;
+type CNBBranchParams = CNBBranchParams$1;
+type OauthGitHubRepo = OauthGitHubRepo$1;
+type OauthGongFengRepo = OauthGongFengRepo$1;
+type OauthCNBRepo = OauthCNBRepo$1;
+type ListReposResponse = ListReposResponse$1;
 /**
  * 账号版本类型
  */
@@ -433,6 +661,13 @@ interface AccountPlan {
   /** 所有套餐资源列表 */
   resources?: PlanResource[];
 }
+/**
+ * 账号类型
+ * - sso: SSO 登录账号
+ * - unified: 统一登录账号
+ * - 空字符串: 普通账号
+ */
+type AccountType = 'sso' | 'unified' | '';
 /**
  * 账号信息
  */
@@ -459,6 +694,8 @@ interface Account {
   pluginEnabled?: boolean;
   /** 部署状态 */
   deployStatus?: DeployStatus;
+  /** 账号类型 */
+  accountType?: AccountType;
   /** 是否是 Pro 版本 */
   isPro?: boolean;
   /** 到期时间戳 */
@@ -517,6 +754,7 @@ interface UserConnector {
   oauthClientId: string;
   /** OAuth 重定向 URL */
   oauthRedirectUrl: string;
+  oauthAppName: string;
 }
 /**
  * 获取用户连接器列表响应
@@ -590,6 +828,7 @@ interface TaskConnector {
   connect_at: string;
   /** 连接状态，0未连接，1已连接 */
   connectStatus: 0 | 1;
+  oauthAppName: string;
 }
 /**
  * 添加任务请求
@@ -679,84 +918,6 @@ interface RevokeAllRequest {
   /** 安装ID列表（可选，如果不传则撤销所有） */
   installationIds?: string[];
 }
-/**
- * GitHub 仓库所有者信息
- */
-interface OauthGitHubRepoOwner {
-  login: string;
-  avatar_url: string;
-  url: string;
-  html_url: string;
-  followers_url: string;
-  starred_url: string;
-  repos_url: string;
-  events_url: string;
-}
-/**
- * GitHub 仓库信息
- */
-interface OauthGitHubRepo {
-  name: string;
-  full_name: string;
-  private: boolean;
-  html_url: string;
-  url: string;
-  teams_url: string;
-  hooks_url: string;
-  events_url: string;
-  branches_url: string;
-  git_commits_url: string;
-  merges_url: string;
-  pulls_url: string;
-  git_url: string;
-  clone_url: string;
-  svn_url: string;
-  downloads_url: string;
-  description: string;
-  owner: OauthGitHubRepoOwner;
-  forks_count: number;
-}
-/**
- * 工蜂仓库信息
- */
-interface OauthGongfengRepo {
-  id: number;
-  description: string;
-  public: boolean;
-  archived: boolean;
-  visibility_level: number;
-  public_visibility: number;
-  namespace: {
-    name: string;
-    description: string;
-    path: string;
-  };
-  owner: {
-    username: string;
-    web_url: string;
-    name: string;
-    state: string;
-    avatar_url: string;
-  };
-  name: string;
-  name_with_namespace: string;
-  path: string;
-  path_with_namespace: string;
-  type: string;
-  default_branch: string;
-  ssh_url_to_repo: string;
-  http_url_to_repo: string;
-  https_url_to_repo: string;
-  web_url: string;
-  avatar_url: string;
-}
-/**
- * CNB仓库信息
- */
-interface OauthCnbRepo {
-  name: string;
-  [key: string]: any;
-}
 /**
  * 获取仓库列表响应
  */
@@ -764,8 +925,8 @@ interface GetRepoListResponse {
   github_repos?: {
     [key: string | number]: OauthGitHubRepo[];
   };
-  gongfeng_repos?: OauthGongfengRepo[];
-  cnb_repos?: OauthCnbRepo[];
+  gongfeng_repos?: OauthGongFengRepo[];
+  cnb_repos?: OauthCNBRepo[];
 }
 /**
  * OAuth 用户信息
@@ -966,6 +1127,12 @@ interface IBackendProvider {
    * 用于 Local 模式下点击 Logo 返回 IDE
    */
   closeAgentManager?(): Promise<void>;
+  /**
+   * 在外部浏览器中打开链接（可选，仅 IPC 环境支持）
+   * 用于 Local 模式下打开外部 URL
+   * @param url 要打开的 URL
+   */
+  openExternal?(url: string): Promise<void>;
   /**
    * 监听事件（可选，用于 IPC 环境）
    * @param event 事件名称
@@ -978,6 +1145,34 @@ interface IBackendProvider {
    * @returns Promise<EnterpriseUsage | null> 企业用户用量信息
    */
   getEnterpriseUsage?(enterpriseId: string): Promise<EnterpriseUsage | null>;
+  /**
+   * 刷新 Token（可选）
+   * 通过调用 getAccount 刷新 cookie
+   * 适用于 Cloud 场景下页面切换回来时刷新登录态
+   * @returns Promise<Account | null> 刷新后的账号信息
+   */
+  refreshToken?(): Promise<Account | null>;
+  /**
+   * 获取仓库分支列表
+   * API 端点: GET /console/as/connector/oauth/{name}/branches
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param params 平台特定的查询参数
+   * @param page 页码，从1开始，0表示不分页获取全部
+   * @param perPage 每页数量，最大100
+   * @returns Promise<OauthBranch[]> 分支列表
+   */
+  getBranches?(connector: OauthConnectorName, params: GitHubBranchParams | GongfengBranchParams | CNBBranchParams, page?: number, perPage?: number): Promise<OauthBranch[]>;
+  /**
+   * 获取仓库列表
+   * API 端点: GET /console/as/connector/oauth/{name}/repos
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param page 页码，从1开始，0表示不分页获取全部
+   * @param perPage 每页数量，最大100
+   * @returns Promise<ListReposResponse> 仓库列表响应
+   */
+  getRepositories?(connector: OauthConnectorName, page?: number, perPage?: number): Promise<ListReposResponse>;
 }
 /**
  * 场景中的插件信息
@@ -1635,6 +1830,8 @@ interface BaseAgentState {
   updatedAt?: Date;
   /** 是否为 playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * LocalAgentState - 本地 Agent 状态
@@ -1781,6 +1978,8 @@ interface SessionInfo {
   cwd?: string;
   /** Whether the session is a playground */
   isPlayground?: boolean;
+  /** Whether the title is user defined (1 = user defined) */
+  isUserDefinedTitle?: number;
 }
 /**
  * Parameters for creating a new session
@@ -1999,7 +2198,7 @@ interface ActiveSession {
     error?: string;
   }>;
   /** Set the current session mode */
-  setMode(modeId: string): Promise<void>;
+  setMode(modeId: string, skipChecker?: boolean): Promise<void>;
   /** Set the current session model */
   setSessionModel(modelId: string): Promise<void>;
   /** Set available commands (called when available_commands_update is received) */
@@ -2142,6 +2341,13 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @returns Response with search results
    */
   searchFile?(params: SearchFileParams): Promise<SearchFileResponse>;
+  /**
+   * Get subagent list (optional, used by LocalAgentProvider)
+   *
+   * @param params - Query parameters including options
+   * @returns Response with subagent list
+   */
+  getSubagentList?(params: GetSubagentListParams): Promise<GetSubagentListResponse>;
   /**
    * Batch toggle plugins (optional, used by LocalAgentProvider)
    *
@@ -2169,12 +2375,22 @@ interface AgentProvider<C extends AgentConnection = AgentConnection> {
    * @param pluginNames - Array of plugin names to install
    * @param marketplaceName - Marketplace name
    * @param installScope - Install scope ('user' | 'project')
+   * @param marketplaceSource - Marketplace source URL (for auto-adding marketplace when not exists)
    * @returns Result of the operation
    */
-  installPlugins?(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project'): Promise<{
+  installPlugins?(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string): Promise<{
     success: boolean;
     error?: string;
   }>;
+  /**
+   * Get available commands for a session (optional, used by LocalAgentProvider)
+   * If session.availableCommands has cached values, return them
+   * Otherwise, fetch from product configuration
+   *
+   * @param sessionId - Session ID to get commands for (optional, for global commands)
+   * @returns Array of available commands
+   */
+  getAvailableCommands?(sessionId?: string): Promise<AvailableCommand[]>;
   /**
    * Register an event listener
    * Provider implementations should forward events to the underlying transport
@@ -2277,6 +2493,8 @@ interface ClientSessionsResource {
   uploadFile(params: UploadFileParams): Promise<UploadFileResponse>;
   /** Search for files in the workspace (for LocalAgentProvider) */
   searchFile(params: SearchFileParams): Promise<SearchFileResponse>;
+  /** Get subagent list (for LocalAgentProvider) */
+  getSubagentList(params: GetSubagentListParams): Promise<GetSubagentListResponse>;
   /** Batch toggle plugins (for LocalAgentProvider) */
   batchTogglePlugins(request: BatchPluginOperationRequest): Promise<BatchPluginOperationResult>;
   /** Get installed plugins (for LocalAgentProvider) */
@@ -2289,7 +2507,7 @@ interface ClientSessionsResource {
     installScope?: 'user' | 'project';
   }>>;
   /** Install plugins (for LocalAgentProvider) */
-  installPlugins(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project'): Promise<{
+  installPlugins(pluginNames: string[], marketplaceName: string, installScope?: 'user' | 'project', marketplaceSource?: string): Promise<{
     success: boolean;
     error?: string;
   }>;
@@ -2307,6 +2525,14 @@ interface ClientSessionsResource {
     }>;
     prompts: string[];
   }>>;
+  /**
+   * 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)
+   * @returns Promise<AvailableCommand[]> - Array of available commands
+   */
+  getAvailableCommands(sessionId?: string): Promise<AvailableCommand[]>;
 }
 /**
  * Workspace information (aligned with FolderSelectResult)
@@ -2435,6 +2661,52 @@ interface SearchFileResponse {
   /** Error message (if failed) */
   readonly error?: string;
 }
+/**
+ * Subagent information
+ */
+interface SubagentInfo {
+  /** Subagent name */
+  name: string;
+  /** Subagent description */
+  description: string;
+  /** System prompt */
+  systemPrompt: string;
+  /** File path */
+  filePath?: string;
+  /** Model type */
+  model?: string;
+  /** Agent mode */
+  agentMode?: 'agentic' | 'manual';
+  /** Whether enabled */
+  enabled?: boolean;
+  /** Model ID */
+  modelID?: string;
+  /** Subagent level */
+  level?: 'project' | 'user';
+}
+/**
+ * Parameters for getting subagent list
+ */
+interface GetSubagentListParams {
+  /** Search options */
+  readonly options: {
+    /** Search keyword (filter by name or description) */readonly search?: string; /** Limit number of results */
+    readonly resultNum?: number; /** Agent mode filter */
+    readonly agentMode?: 'agentic' | 'manual' | 'all'; /** Whether to return only enabled subagents */
+    readonly onlyEnabled?: boolean;
+  };
+  /** Working directory (optional, for filtering project-level subagents) */
+  readonly cwd?: string;
+}
+/**
+ * Response from getting subagent list
+ */
+interface GetSubagentListResponse {
+  /** Subagent list */
+  readonly results: SubagentInfo[];
+  /** Error message (if failed) */
+  readonly error?: string;
+}
 //#endregion
 //#region ../agent-provider/lib/common/providers/cloud-agent-provider/cloud-connection.d.ts
 /**
@@ -2691,8 +2963,11 @@ declare class CloudAgentProvider implements AgentProvider<CloudAgentConnection>,
   /**
    * Create a new conversation
    * POST {endpoint}/console/as/conversations
+   * @param params - Optional session params containing _meta with tags
    */
-  create(): Promise<string>;
+  create(params?: {
+    _meta?: Record<string, unknown>;
+  }): Promise<string>;
   /**
    * Connect to an agent and return the connection
    *
@@ -3140,7 +3415,7 @@ declare class ActiveSessionImpl implements ActiveSession {
    * await session.setMode('architect');
    * ```
    */
-  setMode(modeId: string): Promise<void>;
+  setMode(modeId: string, skipAvailableChecker?: boolean): Promise<void>;
   /**
    * Set the current session model
    *
@@ -3271,6 +3546,18 @@ declare class SessionManager {
    * 7. Return ActiveSession instance (cached)
    */
   loadSession(params: LoadSessionParams$1): Promise<ActiveSession>;
+  /**
+   * 从 ACP response 中提取可用模型列表
+   *
+   * 优先级:
+   * 1. response.models._meta?.['codebuddy.ai']?.availableModels - 包含完整的模型信息（字段名为 'id'）
+   * 2. response.models?.availableModels - 只包含基本信息（字段名为 'modelId'）
+   * 3. undefined - 都没有时返回 undefined
+   *
+   * @param response - ACP 响应对象
+   * @returns ModelInfo[] | undefined
+   */
+  protected extractAvailableModels(response: LoadSessionResponse): ModelInfo[] | undefined;
 }
 //#endregion
 //#region ../agent-provider/lib/backend/backend-provider.d.ts
@@ -3410,6 +3697,38 @@ declare class BackendProvider implements IBackendProvider {
    * API: POST /billing/meter/get-enterprise-user-usage
    */
   getEnterpriseUsage(enterpriseId: string): Promise<EnterpriseUsage | null>;
+  /**
+   * 刷新 Token
+   * 通过调用 getAccount 刷新 cookie，适用于 Cloud 场景下页面切换回来时刷新登录态
+   * @returns Promise<Account | null> 刷新后的账号信息
+   */
+  refreshToken(): Promise<Account | null>;
+  /**
+   * 获取仓库分支列表
+   * API 端点: GET /console/as/connector/oauth/{name}/branches
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param params 平台特定的查询参数
+   * @param page 页码，从1开始，0表示不分页获取全部
+   * @param perPage 每页数量，最大100
+   * @returns Promise<OauthBranch[]> 分支列表
+   */
+  getBranches(connector: OauthConnectorName, params: GitHubBranchParams | GongfengBranchParams | CNBBranchParams, page?: number, perPage?: number): Promise<OauthBranch[]>;
+  /**
+   * 获取仓库列表
+   * API 端点: GET /console/as/connector/oauth/{name}/repos
+   *
+   * Note: 由于工蜂原生支持的 Search 能力会匹配 path/name/description 部分，
+   * 且不支持定制，不满足产品要求（只按 name 匹配），因此前端拉取全量数据后做筛选。
+   *
+   * @param connector 连接器名称 ('github' | 'gongfeng' | 'cnb')
+   * @param page 页码，从1开始，0表示不分页获取全部
+   *             - GitHub 只支持全量数据，必须传 0
+   *             - 工蜂和 CNB 依据前端逻辑而定
+   * @param perPage 每页数量，最大100
+   * @returns Promise<ListReposResponse> 仓库列表响应
+   */
+  getRepositories(connector: OauthConnectorName, page?: number, perPage?: number): Promise<ListReposResponse>;
 }
 /**
  * 创建 BackendProvider 实例
@@ -3543,6 +3862,12 @@ declare class IPCBackendProvider implements IBackendProvider {
    * IDE 环境: 通过 IPC 通知 IDE 关闭 Agent Manager（用于返回 IDE）
    */
   closeAgentManager(): Promise<void>;
+  /**
+   * 在外部浏览器中打开链接
+   * IDE 环境: 通过 IPC 通知 IDE 使用 vscode.env.openExternal 打开 URL
+   * @param url 要打开的 URL
+   */
+  openExternal(url: string): Promise<void>;
   /**
    * 批量切换插件状态
    * IDE 环境: 通过 IPC 调用 Extension Host 的 PluginService