@copilotkit/runtime 1.77.1 → 1.78.0

package/dist/v2/runtime/intelligence-platform/client.mjs

@@ -120,6 +120,10 @@ const MANAGED_INTELLIGENCE_WS_URL = "wss://realtime.intelligence.copilotkit.ai";
 /** Maximum time spent on the optional Inspector metadata provider request. */
 const INSPECTOR_METADATA_REQUEST_TIMEOUT_MS = 5e3;
 const INSPECTOR_LEARNING_REQUEST_TIMEOUT_MS = 5e3;
+/** A 404 the caller expects: a thread lookup made before the thread exists. */
+const NOT_FOUND = new Set([404]);
+/** A 409 the caller expects: another request created the thread first. */
+const CONFLICT = new Set([409]);
 /**
 * Error thrown when a CopilotKit Intelligence HTTP request returns a non-2xx
 * status. Carries the HTTP {@link status} code so callers can branch on
@@ -645,24 +649,42 @@ var CopilotKitIntelligence = class {
 	}
 	/** Mint a browser capture grant using only the Runtime's project and user. */
 	async ɵconnectTrajectory(params) {
-		const response = await fetch(`${this.#apiUrl}/api/trajectories/join`, {
-			method: "POST",
-			headers: {
-				Authorization: `Bearer ${this.#apiKey}`,
-				"Content-Type": "application/json"
-			},
-			body: JSON.stringify({
-				trajectoryId: params.trajectoryId,
-				appUserId: params.user.id
-			}),
-			signal: params.signal,
-			redirect: "error"
-		});
+		let response;
+		try {
+			response = await fetch(`${this.#apiUrl}/api/trajectories/join`, {
+				method: "POST",
+				headers: {
+					Authorization: `Bearer ${this.#apiKey}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify({
+					trajectoryId: params.trajectoryId,
+					appUserId: params.user.id
+				}),
+				signal: params.signal,
+				redirect: "error"
+			});
+		} catch (error) {
+			if (!params.signal?.aborted) logger.warn({
+				error: error instanceof Error ? error.name : typeof error,
+				causeCode: networkErrorCode(error instanceof Error ? error.cause : void 0),
+				host: urlHost(this.#apiUrl)
+			}, "Could not reach Intelligence to connect a Trajectory");
+			throw error;
+		}
 		const payload = await response.json().catch(() => void 0);
 		if (!response.ok) throw trajectoryResponseError(payload, response.status, this.#apiKey);
 		return parseTrajectoryConnectionGrant(payload, params.trajectoryId, this.ɵgetClientWsUrl());
 	}
-	async #request(method, path, body, extraHeaders, signal) {
+	/**
+	* Sends one request to the platform and parses its JSON body.
+	*
+	* @param expectedStatuses - Non-2xx statuses the caller handles as a normal
+	*   outcome, such as the 404 of a thread that does not exist yet. They are
+	*   logged at debug instead of error, and still throw.
+	* @throws {@link PlatformRequestError} on every non-2xx response.
+	*/
+	async #request(method, path, body, extraHeaders, signal, expectedStatuses) {
 		const url = `${this.#apiUrl}${path}`;
 		const headers = {
 			Authorization: `Bearer ${this.#apiKey}`,
@@ -677,7 +699,11 @@ var CopilotKitIntelligence = class {
 		});
 		if (!response.ok) {
 			const text = await response.text().catch(() => "");
-			logger.error({
+			if (expectedStatuses?.has(response.status)) logger.debug({
+				status: response.status,
+				path
+			}, "Intelligence platform request returned an expected status");
+			else logger.error({
 				status: response.status,
 				body: text,
 				path
@@ -836,13 +862,20 @@ var CopilotKitIntelligence = class {
 	*   same `threadId` already exists.
 	*/
 	async createThread(params) {
+		return this.#createThread(params);
+	}
+	/**
+	* Creates a thread. {@link getOrCreateThread} passes 409 as expected,
+	* because there it means another request created the thread first.
+	*/
+	async #createThread(params, expectedStatuses) {
 		const response = await this.#request("POST", `/api/threads`, {
 			threadId: params.threadId,
 			userId: params.userId,
 			agentId: params.agentId,
 			...params.name !== void 0 ? { name: params.name } : {},
 			...params.learningContainerId !== void 0 ? { learningContainerId: params.learningContainerId } : {}
-		});
+		}, void 0, void 0, expectedStatuses);
 		this.#invokeLifecycleCallback("onThreadCreated", response.thread);
 		return response.thread;
 	}
@@ -854,8 +887,15 @@ var CopilotKitIntelligence = class {
 	*   not exist.
 	*/
 	async getThread(params) {
+		return this.#getThread(params);
+	}
+	/**
+	* Fetches a thread. {@link getOrCreateThread} passes 404 as expected,
+	* because there it means the thread is about to be created (PE-678).
+	*/
+	async #getThread(params, expectedStatuses) {
 		const qs = new URLSearchParams({ userId: params.userId }).toString();
-		return (await this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}?${qs}`)).thread;
+		return (await this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}?${qs}`, void 0, void 0, void 0, expectedStatuses)).thread;
 	}
 	/**
 	* Get an existing thread or create it if it does not exist.
@@ -875,10 +915,10 @@ var CopilotKitIntelligence = class {
 	async getOrCreateThread(params) {
 		try {
 			return {
-				thread: await this.getThread({
+				thread: await this.#getThread({
 					threadId: params.threadId,
 					userId: params.userId
-				}),
+				}, NOT_FOUND),
 				created: false
 			};
 		} catch (error) {
@@ -886,7 +926,7 @@ var CopilotKitIntelligence = class {
 		}
 		try {
 			return {
-				thread: await this.createThread(params),
+				thread: await this.#createThread(params, CONFLICT),
 				created: true
 			};
 		} catch (error) {
@@ -1113,6 +1153,19 @@ function deriveRunnerWsUrl(wsUrl) {
 	if (wsUrl.endsWith("/channels")) return `${wsUrl.slice(0, -9)}/runner`;
 	return `${wsUrl}/runner`;
 }
+/** A system error code such as ECONNREFUSED, or undefined for anything else. */
+function networkErrorCode(cause) {
+	const code = typeof cause === "object" && cause !== null && "code" in cause ? cause.code : void 0;
+	return typeof code === "string" && /^[A-Z][A-Z0-9_]{0,63}$/.test(code) ? code : void 0;
+}
+/** The host of a URL without its credentials, path or query. */
+function urlHost(url) {
+	try {
+		return new URL(url).host;
+	} catch {
+		return;
+	}
+}
 function deriveClientWsUrl(wsUrl) {
 	if (wsUrl.endsWith("/client")) return wsUrl;
 	if (wsUrl.endsWith("/runner")) return `${wsUrl.slice(0, -7)}/client`;