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

package/dist/index.cjs

@@ -517,13 +517,6 @@ function truncate(body, maxChars = 500) {
 	}
 }
 
-//#endregion
-//#region src/v1/acp/vendor/sdk.ts
-const PROTOCOL_VERSION = 1;
-async function loadAcpSdk() {
-	return import("@agentclientprotocol/sdk");
-}
-
 //#endregion
 //#region src/v1/acp/transport.ts
 /**
@@ -531,11 +524,11 @@ async function loadAcpSdk() {
 * 返回的对象实现 Stream 接口（readable + writable），可直接传给 ClientSideConnection。
 */
 function createStreamableHttpTransport(options) {
-	const { endpoint, authToken, headers: customHeaders = {}, reconnect = {}, signal: externalSignal, fetch: customFetch = globalThis.fetch, onConnect, onDisconnect, onError, heartbeatTimeout = 6e4, connectionTimeout = 3e4, postTimeout = 3e4, backpressure = {} } = options;
+	const { endpoint, authToken, headers: customHeaders = {}, lastEventId: initialLastEventId, reconnect = {}, signal: externalSignal, fetch: customFetch = globalThis.fetch, onConnect, onDisconnect, onError, heartbeatTimeout = 6e4, connectionTimeout = 3e4, postTimeout = 3e4, backpressure = {} } = options;
 	const { enabled: reconnectEnabled = true, initialDelay = 1e3, maxDelay = 3e4, maxRetries = Infinity, jitter: jitterEnabled = true } = reconnect;
 	const { highWaterMark = 100, lowWaterMark = 50, pauseTimeout = 5e3 } = backpressure;
 	let connectionId;
-	let lastEventId;
+	let lastEventId = initialLastEventId;
 	let reconnectAttempts = 0;
 	let closed = false;
 	let isClosing = false;
@@ -1549,6 +1542,13 @@ var QuestionManager = class {
 	}
 };
 
+//#endregion
+//#region src/v1/acp/vendor/sdk.ts
+const PROTOCOL_VERSION = 1;
+async function loadAcpSdk() {
+	return import("@agentclientprotocol/sdk");
+}
+
 //#endregion
 //#region src/v1/acp/vendor/client.ts
 /**
@@ -1703,6 +1703,7 @@ var StreamableHttpClient = class {
 				endpoint: this.options.endpoint,
 				authToken: this.options.authToken,
 				headers: this.options.headers,
+				lastEventId: this.options.lastEventId,
 				reconnect: this.options.reconnect,
 				fetch: this.options.fetch,
 				heartbeatTimeout: this.options.heartbeatTimeout,
@@ -2134,6 +2135,7 @@ var AcpClient = class {
 				endpoint: acpUrl,
 				authToken: token,
 				headers: opts?.headers,
+				lastEventId: opts?.lastEventId,
 				reconnect: {
 					enabled: true,
 					initialDelay: opts?.reconnectBackoffMs ?? 1e3,
@@ -2244,6 +2246,18 @@ var AcpClient = class {
 		await this._client.cancel(sessionId);
 	}
 	/**
+	* 设置 session 使用的模型。
+	*
+	* @experimental 对应 ACP 协议的 `unstable_setSessionModel`，API 尚未稳定。
+	*/
+	async setSessionModel(sessionId, modelId) {
+		if (!this._client) throw new AcpProtocolError("Not connected");
+		return this._client.setSessionModel({
+			sessionId,
+			modelId
+		});
+	}
+	/**
 	* 订阅指定 sessionId 的上游 notifications。
 	*
 	* Listener 收到的是上游 `SessionNotification` 原样（`{ sessionId, update, _meta? }`）。
@@ -2339,6 +2353,7 @@ var AcpClient = class {
 var Session = class {
 	/** @internal */
 	constructor(id, runtime, restClient) {
+		this._pendingSubscribers = /* @__PURE__ */ new Set();
 		this.id = id;
 		this.runtimeId = runtime.id;
 		this._runtime = runtime;
@@ -2404,6 +2419,7 @@ var Session = class {
 		});
 		if (opts?.initialize !== false) await client.initialize();
 		await client.sessionLoad(this.id);
+		for (const listener of this._pendingSubscribers) client.subscribe(this.id, listener);
 		this._acpClient = client;
 	}
 	/** 断开 ACP 连接。所有订阅器被自动清除。 */
@@ -2484,7 +2500,8 @@ var Session = class {
 	* `update` 是上游 11-tag 判别联合，在 switch 分支里类型自动收窄。
 	*
 	* 订阅独立于 prompt 生命周期——connect 之后注册，直到 unsubscribe 或
-	* disconnect 为止。一个 session 支持任意多个订阅者。
+	* disconnect 为止。未 connect 时也可以先注册，后续 connect / reconnect 到
+	* 该 session 后会自动生效。一个 session 支持任意多个订阅者。
 	*
 	* @returns unsubscribe 函数，调用即退订。
 	*
@@ -2505,8 +2522,17 @@ var Session = class {
 	* ```
 	*/
 	subscribe(listener) {
-		if (!this._acpClient || this._acpClient.state !== "OPEN") throw new ValidationError("Session not connected. Call connect() first.");
-		return this._acpClient.subscribe(this.id, listener);
+		this._pendingSubscribers.add(listener);
+		if (this._acpClient && this._acpClient.state === "OPEN") {
+			const unsub = this._acpClient.subscribe(this.id, listener);
+			return () => {
+				unsub();
+				this._pendingSubscribers.delete(listener);
+			};
+		}
+		return () => {
+			this._pendingSubscribers.delete(listener);
+		};
 	}
 	/**
 	* 取消当前运行的 prompt（如果有）。
@@ -2525,6 +2551,26 @@ var Session = class {
 			loggerFor(this._runtime._connectionOpts).warn(`[session ${this.id}] cancel failed: ${err.message}`);
 		}
 	}
+	/**
+	* 设置 session 使用的模型。
+	*
+	* 必须在 `connect()` 之后调用。
+	*
+	* @param modelId 目标模型 ID，例如 `"gpt-4o"` / `"claude-3-7-sonnet"`
+	*
+	* @experimental 对应 ACP 协议的 `unstable_setSessionModel`，API 尚未稳定。
+	*
+	* @example
+	* ```ts
+	* await session.connect();
+	* await session.setModel('claude-3-7-sonnet');
+	* const r = await session.prompt('hello');
+	* ```
+	*/
+	async setModel(modelId) {
+		if (!this._acpClient || this._acpClient.state !== "OPEN") throw new ValidationError("Session not connected. Call connect() first.");
+		await this._acpClient.setSessionModel(this.id, modelId);
+	}
 };
 /**
 * 合并两个 AbortSignal：任一 abort 时返回的 signal 也 abort。