@tencent-ai/cloud-agent-sdk 0.2.15-next.e99b1de.20260421 → 0.2.15-next.eacecfc.20260428

package/dist/index.cjs

@@ -17479,6 +17479,15 @@ var CloudAgentProvider = class CloudAgentProvider {
 		};
 	}
 	/**
+	* 获取产品功能开关（从缓存）
+	* 需要先调用 getModels() 初始化缓存
+	*
+	* @returns 产品功能开关 Record，如果缓存为空则返回 undefined
+	*/
+	getProductFeatures() {
+		return this.productConfigCache?.productFeatures;
+	}
+	/**
 	* Generate a unique request ID
 	*/
 	generateRequestId() {
@@ -25077,7 +25086,11 @@ var BackendProvider = class BackendProvider {
 	async claimDailyCheckin() {
 		const result = await httpService.post("/billing/meter/daily-checkin", {});
 		if (result?.code === 0 && result?.data) return result.data;
-		throw new Error(result?.msg || "Checkin failed");
+		return {
+			code: result?.code ?? -1,
+			msg: result?.msg || "Checkin failed",
+			requestId: result?.requestId
+		};
 	}
 	/**
 	* 上传分享文件到服务端获取分享链接
@@ -25156,10 +25169,15 @@ var BackendProvider = class BackendProvider {
 	* 获取专家排行榜数据
 	* API 端点: GET /console/expert/ranking
 	* 完全对齐 getCheckinStatus 的调用方式
+	*
+	* @param options.limit 期望返回的专家条数。服务端默认仅返回 100 条，
+	*                      超过该阈值时后面的专家卡片会缺失 `useCount` 导致热度不展示。
 	*/
-	async getExpertRanking() {
+	async getExpertRanking(options) {
 		try {
-			const result = await httpService.get("/console/expert/ranking");
+			const query = {};
+			if (options?.limit && Number.isFinite(options.limit) && options.limit > 0) query.limit = Math.floor(options.limit);
+			const result = await httpService.get("/console/expert/ranking", Object.keys(query).length > 0 ? { params: query } : void 0);
 			if (result?.code === 0 && result?.data) {
 				const normalizedItems = Array.isArray(result.data.items) ? result.data.items : Array.isArray(result.data.experts) ? result.data.experts : [];
 				return {
@@ -25175,6 +25193,68 @@ var BackendProvider = class BackendProvider {
 		}
 	}
 	/**
+	* 获取对话分享详情
+	* API 端点: GET /v2/as/p/tasks/share/:code
+	*
+	* @param code 分享码
+	* @returns Promise<TaskShareDetailResponse | TaskShareDetailError> 对话分享详情或错误信息
+	*/
+	async getTaskShareDetail(code) {
+		try {
+			const result = await httpService.get(`/v2/as/p/tasks/share/${encodeURIComponent(code)}`);
+			if (result?.code && typeof result.code === "number" && result.code !== 0) return {
+				data: null,
+				error: result.message || "Unknown error"
+			};
+			return {
+				data: result.data,
+				error: null
+			};
+		} catch (error) {
+			console.error("[BackendProvider] getTaskShareDetail failed:", error);
+			if (error?.response?.status) return {
+				data: null,
+				error: error.response.data?.message || error.message || "Request failed"
+			};
+			return {
+				data: null,
+				error: error instanceof Error ? error.message : "Network error"
+			};
+		}
+	}
+	/**
+	* 验证并获取对话分享内容
+	* API 端点: POST /v2/as/p/tasks/share/:code/verify
+	*
+	* @param request 验证请求参数，包含分享码和可选的提取码
+	* @returns Promise<TaskShareVerifyResponse | TaskShareVerifyError> 验证结果或错误信息
+	*/
+	async verifyTaskShare(request) {
+		try {
+			const body = {};
+			if (request.extractionCode) body.extractionCode = request.extractionCode;
+			const result = await httpService.post(`/v2/as/p/tasks/share/${encodeURIComponent(request.code)}/verify`, body);
+			if (result?.code && typeof result.code === "number" && result.code !== 0) return {
+				data: null,
+				error: result.message || "Unknown error"
+			};
+			return {
+				data: result.data,
+				error: null
+			};
+		} catch (error) {
+			console.error("[BackendProvider] verifyTaskShare failed:", error);
+			if (error?.response?.status) return {
+				data: null,
+				error: error.response.data?.message || error.message || "Request failed"
+			};
+			return {
+				data: null,
+				error: error instanceof Error ? error.message : "Network error"
+			};
+		}
+	}
+	/**
 	* 获取用户成长体系数据
 	* API 端点: GET /activity/growth/buddy/info
 	* 完全对齐 getExpertRanking 的调用方式
@@ -25219,6 +25299,22 @@ var BackendProvider = class BackendProvider {
 			};
 		}
 	}
+	/**
+	* 通过分享链接创建 Cloud Agent 实例（幂等）
+	* API 端点: POST /console/as/cloudagent/share/:agentBusinessId/create
+	*/
+	async createInstanceFromShare(agentBusinessId) {
+		try {
+			const result = await httpService.post(`/console/as/cloudagent/share/${encodeURIComponent(agentBusinessId)}/create`, {});
+			if (result?.code && result.code !== 0) return { error: result.msg || `Error code: ${result.code}` };
+			const data = result?.data;
+			if (!data?.instance) return { error: "Invalid response: missing instance" };
+			return data;
+		} catch (err) {
+			console.error("[BackendProvider] createInstanceFromShare error:", err);
+			return { error: err?.message || "Unknown error" };
+		}
+	}
 	static {
 		this.SMH_HOST = "https://smh26tqjmz2qlj4i.api.tencentsmh.cn";
 	}
@@ -25332,6 +25428,89 @@ var BackendProvider = class BackendProvider {
 	async getSkillHubInstalledMetas() {
 		return [];
 	}
+	async getKnotList() {
+		return {
+			code: 0,
+			message: "success",
+			data: {
+				total: 0,
+				skills: []
+			}
+		};
+	}
+	async getKnotByIds() {
+		return {
+			code: 0,
+			message: "success",
+			data: []
+		};
+	}
+	async getKnotCategories() {
+		return {
+			items: [],
+			count: 0
+		};
+	}
+	async getKnotTags() {
+		return {
+			code: 0,
+			message: "success",
+			data: []
+		};
+	}
+	async getKnotSearch() {
+		return { results: [] };
+	}
+	async getKnotDetail(slug) {
+		return {
+			skill: {
+				slug,
+				category: "",
+				displayName: slug,
+				summary: "",
+				summary_zh: "",
+				tags: {},
+				stats: {
+					downloads: 0,
+					stars: 0,
+					installs: 0,
+					versions: 0,
+					comments: 0
+				},
+				createdAt: 0,
+				updatedAt: 0
+			},
+			latestVersion: {
+				version: "latest",
+				createdAt: 0,
+				changelog: ""
+			},
+			owner: {
+				handle: "",
+				displayName: "",
+				image: null
+			}
+		};
+	}
+	async getKnotExists(slugs) {
+		const exists = {};
+		for (const s of slugs) exists[s] = false;
+		return {
+			exists,
+			count: 0
+		};
+	}
+	async reportKnotStats() {}
+	async installKnotSkill(id) {
+		return {
+			success: false,
+			skillName: String(id),
+			errorMessage: "Knot install requires IDE mode"
+		};
+	}
+	async getKnotInstalledMetas() {
+		return [];
+	}
 	/**
 	* 获取大使状态
 	* API 端点: GET /console/activity/ambassador/status
@@ -25409,6 +25588,12 @@ const BACKEND_REQUEST_TYPES = {
 	GET_SHARE_LIST: "backend:get-share-list",
 	DOWNLOAD_SHARE_FILE: "backend:download-share-file",
 	SET_SHARE_ENABLED: "backend:set-share-enabled",
+	PREPARE_SHARE_TASK: "backend:prepare-share-task",
+	UPLOAD_SHARE_TASK_FILE: "backend:upload-share-task-file",
+	CONFIRM_SHARE_TASK: "backend:confirm-share-task",
+	CANCEL_SHARE_TASK: "backend:cancel-share-task",
+	DELETE_TASK_SHARE: "backend:delete-task-share",
+	GET_TASK_SHARE_LIST: "backend:get-task-share-list",
 	GET_ACTIVITY_BANNER: "backend:get-activity-banner",
 	GET_AMBASSADOR_STATUS: "backend:get-ambassador-status",
 	GET_EXPERT_RANKING: "backend:get-expert-ranking",
@@ -25420,6 +25605,16 @@ const BACKEND_REQUEST_TYPES = {
 	SKILLHUB_DOWNLOAD_URL: "backend:skillhub-download-url",
 	SKILLHUB_EXISTS: "backend:skillhub-exists",
 	SKILLHUB_REPORT_STATS: "backend:skillhub-report-stats",
+	KNOT_LIST: "backend:knot-list",
+	KNOT_GET_BY_IDS: "backend:knot-get-by-ids",
+	KNOT_CATEGORIES: "backend:knot-categories",
+	KNOT_TAGS: "backend:knot-tags",
+	KNOT_SEARCH: "backend:knot-search",
+	KNOT_DETAIL: "backend:knot-detail",
+	KNOT_EXISTS: "backend:knot-exists",
+	KNOT_REPORT_STATS: "backend:knot-report-stats",
+	KNOT_INSTALL: "backend:knot-install",
+	KNOT_INSTALLED_METAS: "backend:knot-installed-metas",
 	SUBMIT_USER_FEEDBACK: "backend:submit-user-feedback",
 	OPEN_YUANBAO: "backend:open-yuanbao"
 };
@@ -26135,6 +26330,124 @@ var IPCBackendProvider = class {
 		}
 	}
 	/**
+	* 预创建对话分享（草稿态）
+	* IDE 环境: 通过 IPC 调用主进程预创建分享
+	*
+	* @param params 预创建参数（可选），包含分享名称
+	* @returns Promise<TaskSharePrepareResult> 预创建结果
+	*/
+	async prepareShareTask(params) {
+		this.log("Preparing share task via IPC:", params?.name);
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.PREPARE_SHARE_TASK, params);
+		} catch (error) {
+			this.log("Prepare share task failed:", error);
+			return {
+				success: false,
+				error: error instanceof Error ? error.message : "Prepare share task failed"
+			};
+		}
+	}
+	/**
+	* 上传对话分享制品文件
+	* IDE 环境: 通过 IPC 调用主进程上传文件
+	*
+	* @param params 上传参数
+	* @returns Promise<TaskShareUploadResult> 上传结果
+	*/
+	async uploadShareTaskFile(params) {
+		this.log("Uploading share task file via IPC:", params.fileName || params.filePath);
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.UPLOAD_SHARE_TASK_FILE, params, 12e4);
+		} catch (error) {
+			this.log("Upload share task file failed:", error);
+			return {
+				success: false,
+				error: error instanceof Error ? error.message : "Upload share task file failed"
+			};
+		}
+	}
+	/**
+	* 确认对话分享
+	* IDE 环境: 通过 IPC 调用主进程确认分享
+	*
+	* @param params 确认参数
+	* @returns Promise<TaskShareConfirmResult> 确认结果
+	*/
+	async confirmShareTask(params) {
+		this.log("Confirming share task via IPC:", params.prepareId);
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.CONFIRM_SHARE_TASK, params);
+		} catch (error) {
+			this.log("Confirm share task failed:", error);
+			return {
+				success: false,
+				error: error instanceof Error ? error.message : "Confirm share task failed"
+			};
+		}
+	}
+	/**
+	* 取消对话分享
+	* IDE 环境: 通过 IPC 调用主进程取消分享
+	*
+	* @param params 取消参数
+	* @returns Promise<TaskShareCancelResult> 取消结果
+	*/
+	async cancelShareTask(params) {
+		this.log("Cancelling share task via IPC:", params.prepareId);
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.CANCEL_SHARE_TASK, params);
+		} catch (error) {
+			this.log("Cancel share task failed:", error);
+			return {
+				success: false,
+				error: error instanceof Error ? error.message : "Cancel share task failed"
+			};
+		}
+	}
+	/**
+	* 删除对话分享
+	* IDE 环境: 通过 IPC 调用主进程删除分享
+	*
+	* @param code 分享码
+	* @returns Promise<TaskShareDeleteResult> 删除结果
+	*/
+	async deleteTaskShare(code) {
+		this.log("Deleting task share via IPC:", code);
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.DELETE_TASK_SHARE, { code });
+		} catch (error) {
+			this.log("Delete task share failed:", error);
+			return {
+				success: false,
+				error: error instanceof Error ? error.message : "Delete task share failed"
+			};
+		}
+	}
+	/**
+	* 获取对话分享列表
+	* IDE 环境: 通过 IPC 获取对话分享列表
+	*
+	* @param params 分页参数
+	* @returns Promise<TaskShareListResult> 对话分享列表结果
+	*/
+	async getTaskShareList(params) {
+		this.log("Getting task share list via IPC:", params);
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.GET_TASK_SHARE_LIST, params);
+		} catch (error) {
+			this.log("Get task share list failed:", error);
+			return {
+				success: false,
+				records: [],
+				total: 0,
+				page: params?.page ?? 1,
+				pageSize: params?.pageSize ?? 20,
+				error: error instanceof Error ? error.message : "Get task share list failed"
+			};
+		}
+	}
+	/**
 	* 获取大使状态
 	* IDE 环境: 通过 IPC 获取大使状态
 	*/
@@ -26162,11 +26475,13 @@ var IPCBackendProvider = class {
 	/**
 	* 获取专家排行榜数据
 	* IDE 环境: 通过 IPC 获取排行榜数据
+	*
+	* @param options.limit 期望返回的专家条数（服务端默认仅返回 100 条）
 	*/
-	async getExpertRanking() {
+	async getExpertRanking(options) {
 		this.log("Getting expert ranking via IPC");
 		try {
-			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.GET_EXPERT_RANKING);
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.GET_EXPERT_RANKING, options);
 		} catch (error) {
 			this.log("Get expert ranking failed:", error);
 			return null;
@@ -26308,6 +26623,119 @@ var IPCBackendProvider = class {
 			return [];
 		}
 	}
+	async getKnotList(params) {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_LIST, params);
+		} catch (error) {
+			this.log("Get Knot list failed:", error);
+			return {
+				code: -1,
+				message: String(error),
+				data: {
+					total: 0,
+					skills: []
+				}
+			};
+		}
+	}
+	async getKnotByIds(ids) {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_GET_BY_IDS, { ids });
+		} catch (error) {
+			this.log("Get Knot by ids failed:", error);
+			return {
+				code: -1,
+				message: String(error),
+				data: []
+			};
+		}
+	}
+	async getKnotCategories() {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_CATEGORIES);
+		} catch (error) {
+			this.log("Get Knot categories failed:", error);
+			return {
+				items: [],
+				count: 0
+			};
+		}
+	}
+	async getKnotTags() {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_TAGS);
+		} catch (error) {
+			this.log("Get Knot tags failed:", error);
+			return {
+				code: -1,
+				message: String(error),
+				data: []
+			};
+		}
+	}
+	async getKnotSearch(q, limit = 20) {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_SEARCH, {
+				q,
+				limit
+			});
+		} catch (error) {
+			this.log("Knot search failed:", error);
+			return { results: [] };
+		}
+	}
+	async getKnotDetail(slug) {
+		return this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_DETAIL, { slug });
+	}
+	async getKnotExists(slugs) {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_EXISTS, { slugs });
+		} catch (error) {
+			this.log("Knot exists failed:", error);
+			const exists = {};
+			for (const s of slugs) exists[s] = false;
+			return {
+				exists,
+				count: 0
+			};
+		}
+	}
+	async reportKnotStats(slug, inc) {
+		try {
+			await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_REPORT_STATS, {
+				slug,
+				inc
+			});
+		} catch (error) {
+			this.log("Report Knot stats failed:", error);
+		}
+	}
+	async installKnotSkill(id, version, name, skillName, slug) {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_INSTALL, {
+				id,
+				version,
+				name,
+				skillName,
+				slug
+			});
+		} catch (error) {
+			this.log("Install Knot skill failed:", error);
+			return {
+				success: false,
+				skillName: name || String(id),
+				errorMessage: String(error)
+			};
+		}
+	}
+	async getKnotInstalledMetas() {
+		try {
+			return await this.sendBackendRequest(BACKEND_REQUEST_TYPES.KNOT_INSTALLED_METAS);
+		} catch (error) {
+			this.log("Get Knot installed metas failed:", error);
+			return [];
+		}
+	}
 	/**
 	* 提交用户意见反馈
 	* IDE 环境: 通过 IPC 将反馈数据发送到 Extension Host