@tencent-ai/cloud-agent-sdk 0.3.2 → 0.3.3

package/dist/index.cjs

@@ -207,6 +207,19 @@ function redactBody(body) {
 
 //#endregion
 //#region src/v1/rest/client.ts
+/**
+* REST 客户端 — 基于原生 fetch
+*
+* 职责：
+* - 注入认证 / 身份 / 自定义 header（apiKey / source* / user 定制）
+* - 统一解包 `{ code, msg, data, requestId }`，非 0 抛 `CloudAgentError`
+* - 超时控制（AbortController + AbortSignal 合并）
+* - 重试（指数退避 + 抖动；默认仅 GET 重试，非 GET 需显式 `retry`）
+* - 日志：对齐 Anthropic SDK —— 日志行不带自造 ID，只带**服务端 requestId**
+*   作为定位 ID；"是否在重试 / 第几次重试" 通过独立的告警行 + `attempt=N/M`
+*   字段表达，而非自造 logId/retryOf 链
+* - 脱敏：onRequest / onResponse 钩子 + debug 日志里的 headers 自动脱敏
+*/
 /** 默认 baseUrl */
 const DEFAULT_BASE_URL = "https://www.codebuddy.cn/v2/agentos";
 /**
@@ -286,7 +299,7 @@ var RestClient = class {
 		};
 		if (this.opts.apiKey) if (this.opts.apiKey.startsWith("pt_")) headers["Authorization"] = `Bearer ${this.opts.apiKey}`;
 		else headers["X-Api-Key"] = this.opts.apiKey;
-		if (this.opts.sourceApp) headers["X-Source-App"] = this.opts.sourceApp;
+		headers["X-Source-App"] = this.opts.sourceApp || "cloud-agent";
 		if (this.opts.sourceTenantId) headers["X-Source-Tenant-Id"] = this.opts.sourceTenantId;
 		if (this.opts.userId) headers["X-User-Id"] = this.opts.userId;
 		if (this.opts.headers) Object.assign(headers, this.opts.headers);
@@ -465,7 +478,7 @@ var RestClient = class {
 				await sleep(delayMs);
 			}
 		}
-		throw lastError;
+		throw lastError ?? /* @__PURE__ */ new Error("Retry exhausted with no captured error");
 	}
 	/** 计算退避时间。 */
 	getBackoffMs(attempt, opts) {