@copilotkit/core 1.62.3 → 1.63.0

package/dist/index.cjs

@@ -889,6 +889,7 @@ var AgentRegistry = class {
 	localAgents = {};
 	remoteAgents = {};
 	_runtimeUrl;
+	_connectionInFlight;
 	_runtimeVersion;
 	_runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Disconnected;
 	_runtimeTransport = "auto";
@@ -981,10 +982,28 @@ var AgentRegistry = class {
 	/**
 	* 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?.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) {
@@ -1130,6 +1149,20 @@ var AgentRegistry = class {
 	*/
 	async updateRuntimeConnection() {
 		if (typeof window === "undefined") return;
+		const key = `${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(() => {
+			if (this._connectionInFlight?.promise === promise) this._connectionInFlight = void 0;
+		});
+		return promise;
+	}
+	async performRuntimeConnection() {
 		if (!this.runtimeUrl) {
 			this._runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Disconnected;
 			this._runtimeVersion = void 0;
@@ -3681,7 +3714,7 @@ var CopilotKitCore = class {
 	* store that was registered prior to that initial notification.
 	*/
 	previousAgentIds = /* @__PURE__ */ new Set();
-	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 }) {
 		this._headers = normalizeHeaders(headers);
 		this._credentials = credentials;
 		this._properties = properties;
@@ -3697,7 +3730,7 @@ var CopilotKitCore = class {
 		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: () => {
@@ -3773,6 +3806,18 @@ var CopilotKitCore = class {
 	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;
 	}