@tencent-ai/cloud-agent-sdk 0.3.6 → 0.3.8

package/dist/index.cjs

@@ -1,4 +1,51 @@
 
+//#region src/v1/agent.ts
+var Agent = class {
+	/** @internal */
+	constructor(restClient, info) {
+		this.versions = {
+			list: async (opts) => {
+				const params = {};
+				if (opts?.page !== void 0) params.page = String(opts.page);
+				if (opts?.pageSize !== void 0) params.pageSize = String(opts.pageSize);
+				return this._restClient.get(`/agents/${this.id}/versions`, params, opts);
+			},
+			get: async (versionId, opts) => this._restClient.get(`/agents/${this.id}/versions/${versionId}`, void 0, opts),
+			publish: async (req, opts) => this._restClient.post(`/agents/${this.id}/versions`, req, opts),
+			delete: async (versionId, opts) => {
+				await this._restClient.delete(`/agents/${this.id}/versions/${versionId}`, opts);
+			},
+			setCurrent: async (versionId, opts) => {
+				await this._restClient.put(`/agents/${this.id}/versions/current`, { versionId }, opts);
+			}
+		};
+		this.draft = {
+			save: async (req, opts) => this._restClient.put(`/agents/${this.id}/draft`, req, opts),
+			get: async (opts) => this._restClient.get(`/agents/${this.id}/draft`, void 0, opts),
+			publish: async (description, opts) => this._restClient.post(`/agents/${this.id}/draft/publish`, { description }, opts)
+		};
+		this.id = info.id;
+		this._info = info;
+		this._restClient = restClient;
+	}
+	get agentInfo() {
+		return this._info;
+	}
+	get agentName() {
+		return this._info.agentName;
+	}
+	get description() {
+		return this._info.description;
+	}
+	get model() {
+		return this._info.model;
+	}
+	get enabled() {
+		return this._info.enabled;
+	}
+};
+
+//#endregion
 //#region src/v1/internal/log.ts
 /** 级别数值：越大越详细；方法级别 > 当前级别时，该方法变成 noop。 */
 const LEVEL_NUMBER = {
@@ -271,6 +318,11 @@ var RestClient = class {
 		const url = this.buildUrl(path);
 		return this.request("POST", url, body, opts);
 	}
+	/** PUT 请求。 */
+	async put(path, body, opts) {
+		const url = this.buildUrl(path);
+		return this.request("PUT", url, body, opts);
+	}
 	/** PATCH 请求。 */
 	async patch(path, body, opts) {
 		const url = this.buildUrl(path);
@@ -517,13 +569,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 +576,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;
@@ -970,6 +1015,9 @@ const KNOWN_EXTENSIONS = [
 //#endregion
 //#region src/v1/acp/vendor/constants.ts
 /**
+* Protocol constants for Streamable HTTP ACP Client
+*/
+/**
 * Default timeout for initialize operation
 */
 const DEFAULT_INITIALIZE_TIMEOUT = 3e4;
@@ -1549,6 +1597,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 +1758,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,
@@ -1867,7 +1923,7 @@ var StreamableHttpClient = class {
 	async setSessionModel(params) {
 		this.ensureInitialized("setSessionModel");
 		this.options.logger?.debug(`Setting session model: ${params.sessionId} -> ${params.modelId}`);
-		return this.connection.unstable_setSessionModel(params);
+		return await this.connection.extMethod("session/set_model", params);
 	}
 	/**
 	* Send a prompt to the agent
@@ -2134,6 +2190,7 @@ var AcpClient = class {
 				endpoint: acpUrl,
 				authToken: token,
 				headers: opts?.headers,
+				lastEventId: opts?.lastEventId,
 				reconnect: {
 					enabled: true,
 					initialDelay: opts?.reconnectBackoffMs ?? 1e3,
@@ -2351,6 +2408,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;
@@ -2416,6 +2474,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 连接。所有订阅器被自动清除。 */
@@ -2496,7 +2555,8 @@ var Session = class {
 	* `update` 是上游 11-tag 判别联合，在 switch 分支里类型自动收窄。
 	*
 	* 订阅独立于 prompt 生命周期——connect 之后注册，直到 unsubscribe 或
-	* disconnect 为止。一个 session 支持任意多个订阅者。
+	* disconnect 为止。未 connect 时也可以先注册，后续 connect / reconnect 到
+	* 该 session 后会自动生效。一个 session 支持任意多个订阅者。
 	*
 	* @returns unsubscribe 函数，调用即退订。
 	*
@@ -2517,8 +2577,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（如果有）。
@@ -2582,17 +2651,27 @@ var Runtime = class {
 	constructor(restClient, connectionOpts, info) {
 		this.sessions = {
 			create: async (opts) => {
-				const body = {
-					sessionId: opts.sessionId,
-					sessionName: opts.sessionName,
-					agentManifest: opts.agentManifest
-				};
-				return new Session((await this._restClient.post(`/runtimes/${this.id}/sessions`, body, {
+				const reqOpts = {
 					timeoutMs: opts.timeoutMs,
 					headers: opts.headers,
 					signal: opts.signal,
 					requestId: opts.requestId
-				})).sessionId, this, this._restClient);
+				};
+				let info;
+				if (opts.agentId) info = await this._restClient.post("/agents/sessions", {
+					agentId: opts.agentId,
+					runtimeId: this.id,
+					sessionName: opts.sessionName
+				}, reqOpts);
+				else {
+					const body = {
+						sessionId: opts.sessionId,
+						sessionName: opts.sessionName,
+						agentManifest: opts.agentManifest
+					};
+					info = await this._restClient.post(`/runtimes/${this.id}/sessions`, body, reqOpts);
+				}
+				return new Session(info.sessionId, this, this._restClient);
 			},
 			get: async (sessionId, opts) => {
 				await this._restClient.get(`/runtimes/${this.id}/sessions/${sessionId}`, void 0, opts);
@@ -2663,6 +2742,26 @@ const CODEBUDDY_API_KEY = "CODEBUDDY_API_KEY";
 var CloudAgentClient = class CloudAgentClient {
 	/** 构造（同步，不发网络请求） */
 	constructor(opts = {}) {
+		this.agents = {
+			create: async (req, opts) => {
+				const info = await this._restClient.post("/agents", req, opts);
+				return new Agent(this._restClient, info);
+			},
+			get: async (agentId, opts) => {
+				const info = await this._restClient.get(`/agents/${agentId}`, void 0, opts);
+				return new Agent(this._restClient, info);
+			},
+			list: async (opts) => {
+				const params = {};
+				if (opts?.page !== void 0) params.page = String(opts.page);
+				if (opts?.pageSize !== void 0) params.pageSize = String(opts.pageSize);
+				if (opts?.keyword) params.keyword = opts.keyword;
+				return this._restClient.get("/agents", params, opts);
+			},
+			delete: async (agentId, opts) => {
+				await this._restClient.delete(`/agents/${agentId}`, opts);
+			}
+		};
 		this.runtimes = {
 			create: async (opts) => {
 				const agentManifest = withInjectedApiKeySecret(opts.agentManifest, this.opts.apiKey, this.opts);
@@ -2861,6 +2960,7 @@ var ManifestBuilder = class {
 
 //#endregion
 exports.AcpProtocolError = AcpProtocolError;
+exports.Agent = Agent;
 exports.AuthError = AuthError;
 exports.CloudAgentClient = CloudAgentClient;
 exports.CloudAgentError = CloudAgentError;