@copilotkit/runtime 1.77.0 → 1.77.2

package/dist/v2/runtime/handlers/shared/platform-error.mjs

@@ -0,0 +1,40 @@
+import "reflect-metadata";
+import { PlatformRequestError } from "../../intelligence-platform/client.mjs";
+import { errorResponse } from "./json-response.mjs";
+
+//#region src/v2/runtime/handlers/shared/platform-error.ts
+/**
+* Map a thrown error from a platform call onto a `Response`.
+*
+* Extracted from the memory handlers, which had it first and alone; the thread
+* handlers flattened every failure to 500, so a "this does not exist yet" was
+* indistinguishable from "the platform is down". One copy, because two would
+* drift the moment either grew a case.
+*
+* Forward only client-actionable **4xx** statuses verbatim (404 missing or
+* wrong-scope, 409 conflict, 422 unprocessable) so a consumer can branch on
+* them — a flat 500 erases that distinction. A platform **5xx**, or any non-4xx
+* or malformed status, means this runtime is healthy but its dependency failed,
+* so it surfaces as `502 Bad Gateway` rather than echoing the upstream status as
+* if the runtime itself broke. That also avoids a `RangeError` from
+* `new Response(..., { status })` on an out-of-range status. Anything that is
+* not a platform error at all stays 500.
+*
+* A platform **401** is also 502: it rejects the runtime's own credentials
+* (e.g. a rotated API key), not the end user, so forwarding it would tell the
+* browser the user is unauthenticated for a fault only the server can fix. A
+* **403** is different: the platform uses it to deny this user an action (e.g.
+* a write to read-only memory), so it is forwarded like any other 4xx.
+*/
+function platformErrorResponse(error, message) {
+	if (error instanceof PlatformRequestError) {
+		const { status } = error;
+		if (Number.isInteger(status) && status >= 400 && status <= 499 && status !== 401) return errorResponse(message, status);
+		return errorResponse(message, 502);
+	}
+	return errorResponse(message, 500);
+}
+
+//#endregion
+export { platformErrorResponse };
+//# sourceMappingURL=platform-error.mjs.map

package/dist/v2/runtime/handlers/shared/platform-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-error.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/shared/platform-error.ts"],"sourcesContent":["import { PlatformRequestError } from \"../../intelligence-platform/client\";\nimport { errorResponse } from \"./json-response\";\n\n/**\n * Map a thrown error from a platform call onto a `Response`.\n *\n * Extracted from the memory handlers, which had it first and alone; the thread\n * handlers flattened every failure to 500, so a \"this does not exist yet\" was\n * indistinguishable from \"the platform is down\". One copy, because two would\n * drift the moment either grew a case.\n *\n * Forward only client-actionable **4xx** statuses verbatim (404 missing or\n * wrong-scope, 409 conflict, 422 unprocessable) so a consumer can branch on\n * them — a flat 500 erases that distinction. A platform **5xx**, or any non-4xx\n * or malformed status, means this runtime is healthy but its dependency failed,\n * so it surfaces as `502 Bad Gateway` rather than echoing the upstream status as\n * if the runtime itself broke. That also avoids a `RangeError` from\n * `new Response(..., { status })` on an out-of-range status. Anything that is\n * not a platform error at all stays 500.\n *\n * A platform **401** is also 502: it rejects the runtime's own credentials\n * (e.g. a rotated API key), not the end user, so forwarding it would tell the\n * browser the user is unauthenticated for a fault only the server can fix. A\n * **403** is different: the platform uses it to deny this user an action (e.g.\n * a write to read-only memory), so it is forwarded like any other 4xx.\n */\nexport function platformErrorResponse(\n  error: unknown,\n  message: string,\n): Response {\n  if (error instanceof PlatformRequestError) {\n    const { status } = error;\n    if (\n      Number.isInteger(status) &&\n      status >= 400 &&\n      status <= 499 &&\n      status !== 401\n    ) {\n      return errorResponse(message, status);\n    }\n    return errorResponse(message, 502);\n  }\n  return errorResponse(message, 500);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,sBACd,OACA,SACU;AACV,KAAI,iBAAiB,sBAAsB;EACzC,MAAM,EAAE,WAAW;AACnB,MACE,OAAO,UAAU,OAAO,IACxB,UAAU,OACV,UAAU,OACV,WAAW,IAEX,QAAO,cAAc,SAAS,OAAO;AAEvC,SAAO,cAAc,SAAS,IAAI;;AAEpC,QAAO,cAAc,SAAS,IAAI"}

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

@@ -146,6 +146,24 @@ var PlatformRequestError = class extends Error {
 		this.name = "PlatformRequestError";
 	}
 };
+/**
+* Read the platform's `retryable` hint from an error response body. The
+* platform sends `{ error: { code, message, category, retryable } }`; anything
+* else (non-JSON, proxies, older platforms) yields `undefined`.
+*/
+function readErrorBodyRetryable(text) {
+	if (!text) return void 0;
+	try {
+		const body = JSON.parse(text);
+		if (typeof body !== "object" || body === null) return void 0;
+		const error = body.error;
+		if (typeof error !== "object" || error === null) return void 0;
+		const retryable = error.retryable;
+		return typeof retryable === "boolean" ? retryable : void 0;
+	} catch {
+		return;
+	}
+}
 /** Copy a public Runtime entitlement so callers cannot mutate cached authority. */
 function cloneRuntimeEntitlementResponse(response) {
 	if (response.status === "ready") return {
@@ -628,24 +646,34 @@ 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) _copilotkit_shared.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 require_trajectories.trajectoryResponseError(payload, response.status, this.#apiKey);
 		return require_trajectories.parseTrajectoryConnectionGrant(payload, params.trajectoryId, this.ɵgetClientWsUrl());
 	}
-	async #request(method, path, body, extraHeaders) {
+	async #request(method, path, body, extraHeaders, signal) {
 		const url = `${this.#apiUrl}${path}`;
 		const headers = {
 			Authorization: `Bearer ${this.#apiKey}`,
@@ -655,7 +683,8 @@ var CopilotKitIntelligence = class {
 		const response = await fetch(url, {
 			method,
 			headers,
-			body: body ? JSON.stringify(body) : void 0
+			body: body ? JSON.stringify(body) : void 0,
+			signal
 		});
 		if (!response.ok) {
 			const text = await response.text().catch(() => "");
@@ -664,7 +693,7 @@ var CopilotKitIntelligence = class {
 				body: text,
 				path
 			}, "Intelligence platform request failed");
-			throw new PlatformRequestError(`Intelligence platform error ${response.status}: ${text || response.statusText}`, response.status);
+			throw new PlatformRequestError(`Intelligence platform error ${response.status}: ${text || response.statusText}`, response.status, readErrorBodyRetryable(text));
 		}
 		const text = await response.text();
 		if (!text) return;
@@ -1030,7 +1059,7 @@ var CopilotKitIntelligence = class {
 			runId: params.runId,
 			ttlSeconds: params.ttlSeconds,
 			...params.lockKeyPrefix !== void 0 ? { lockKeyPrefix: params.lockKeyPrefix } : {}
-		});
+		}, void 0, params.signal);
 	}
 	async ɵgetActiveJoinCode(params) {
 		const qs = new URLSearchParams({ userId: params.userId }).toString();
@@ -1095,6 +1124,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`;