@copilotkit/core 1.62.3 → 1.63.0

package/dist/index.umd.js

@@ -1005,6 +1005,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "localAgents", {});
 			_defineProperty(this, "remoteAgents", {});
 			_defineProperty(this, "_runtimeUrl", void 0);
+			_defineProperty(this, "_connectionInFlight", void 0);
 			_defineProperty(this, "_runtimeVersion", void 0);
 			_defineProperty(this, "_runtimeConnectionStatus", CopilotKitCoreRuntimeConnectionStatus.Disconnected);
 			_defineProperty(this, "_runtimeTransport", "auto");
@@ -1085,10 +1086,28 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Set the runtime URL and update connection
 		*/
-		setRuntimeUrl(runtimeUrl) {
+		setRuntimeUrl(runtimeUrl, options) {
 			const normalizedRuntimeUrl = runtimeUrl ? runtimeUrl.replace(/\/$/, "") : void 0;
 			if (this._runtimeUrl === normalizedRuntimeUrl) return;
 			this._runtimeUrl = normalizedRuntimeUrl;
+			if (options === null || options === void 0 ? void 0 : options.deferConnection) return;
+			this.updateRuntimeConnection();
+		}
+		/**
+		* Start the initial runtime connection if it has not been started yet.
+		*
+		* Backs {@link CopilotKitCore.connect}. Idempotent: it only kicks off a fetch
+		* when a `runtimeUrl` is set and the connection is still `Disconnected` (its
+		* state before any connect attempt). `updateRuntimeConnection` flips the
+		* status to `Connecting` synchronously, so a second call — e.g. React
+		* StrictMode double-invoking the mount effect — bails here. A genuine config
+		* change still reconnects through `setRuntimeUrl`/`setRuntimeTransport`. See
+		* #5801.
+		*/
+		connectRuntime() {
+			if (typeof window === "undefined") return;
+			if (!this._runtimeUrl) return;
+			if (this._runtimeConnectionStatus !== CopilotKitCoreRuntimeConnectionStatus.Disconnected) return;
 			this.updateRuntimeConnection();
 		}
 		setRuntimeTransport(runtimeTransport) {
@@ -1233,7 +1252,23 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* Update runtime connection and fetch remote agents
 		*/
 		async updateRuntimeConnection() {
+			var _this$_runtimeUrl;
 			if (typeof window === "undefined") return;
+			const key = `${(_this$_runtimeUrl = this._runtimeUrl) !== null && _this$_runtimeUrl !== void 0 ? _this$_runtimeUrl : ""}::${this._requestedTransport}`;
+			const inFlight = this._connectionInFlight;
+			if (inFlight && inFlight.key === key) return inFlight.promise;
+			const promise = this.performRuntimeConnection();
+			this._connectionInFlight = {
+				key,
+				promise
+			};
+			promise.finally(() => {
+				var _this$_connectionInFl;
+				if (((_this$_connectionInFl = this._connectionInFlight) === null || _this$_connectionInFl === void 0 ? void 0 : _this$_connectionInFl.promise) === promise) this._connectionInFlight = void 0;
+			});
+			return promise;
+		}
+		async performRuntimeConnection() {
 			if (!this.runtimeUrl) {
 				this._runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Disconnected;
 				this._runtimeVersion = void 0;
@@ -3807,7 +3842,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return Object.fromEntries(Object.entries(headers).filter((entry) => entry[1] != null));
 	}
 	var CopilotKitCore = class {
-		constructor({ runtimeUrl, runtimeTransport = "auto", headers = {}, credentials, properties = {}, agents__unsafe_dev_only = {}, tools = [], suggestionsConfig = [], debug }) {
+		constructor({ runtimeUrl, runtimeTransport = "auto", deferInitialConnection = false, headers = {}, credentials, properties = {}, agents__unsafe_dev_only = {}, tools = [], suggestionsConfig = [], debug }) {
 			_defineProperty(this, "_headers", void 0);
 			_defineProperty(this, "_credentials", void 0);
 			_defineProperty(this, "_properties", void 0);
@@ -3837,7 +3872,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.suggestionEngine.initialize(suggestionsConfig);
 			this.stateManager.initialize();
 			this.agentRegistry.setRuntimeTransport(runtimeTransport);
-			this.agentRegistry.setRuntimeUrl(runtimeUrl);
+			this.agentRegistry.setRuntimeUrl(runtimeUrl, { deferConnection: deferInitialConnection });
 			this.previousAgentIds = new Set(Object.keys(agents__unsafe_dev_only));
 			this.subscribe({
 				onRuntimeConnectionStatusChanged: () => {
@@ -3916,6 +3951,18 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		setRuntimeUrl(runtimeUrl) {
 			this.agentRegistry.setRuntimeUrl(runtimeUrl);
 		}
+		/**
+		* Start the runtime `/info` connection if it has not been started yet.
+		*
+		* Intended to be driven from a host's commit-phase effect when the core was
+		* constructed with {@link CopilotKitCoreConfig.deferInitialConnection}. Safe
+		* to call repeatedly — it is a no-op once a connection is in progress or
+		* settled, so a double-invoked mount effect (React StrictMode) collapses to a
+		* single request. See #5801.
+		*/
+		connect() {
+			this.agentRegistry.connectRuntime();
+		}
 		get runtimeTransport() {
 			return this.agentRegistry.runtimeTransport;
 		}