@copilotkit/core 1.55.0-next.8 → 1.55.0

package/dist/index.umd.js

@@ -615,7 +615,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		constructor(config) {
 			var _config$transport, _ref, _config$agentId, _config$runtimeMode;
 			const normalizedRuntimeUrl = config.runtimeUrl ? config.runtimeUrl.replace(/\/$/, "") : void 0;
-			const transport = (_config$transport = config.transport) !== null && _config$transport !== void 0 ? _config$transport : "rest";
+			const transport = (_config$transport = config.transport) !== null && _config$transport !== void 0 ? _config$transport : "auto";
 			const runUrl = transport === "single" ? (_ref = normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl) !== null && _ref !== void 0 ? _ref : "" : `${normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl}/agent/${encodeURIComponent((_config$agentId = config.agentId) !== null && _config$agentId !== void 0 ? _config$agentId : "")}/run`;
 			if (!runUrl) throw new Error("ProxiedCopilotRuntimeAgent requires a runtimeUrl when transport is set to 'single'.");
 			super({
@@ -773,6 +773,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 		async fetchRuntimeInfo() {
 			const headers = { ...this.headers };
+			if (this.transport === "auto") return this.fetchRuntimeInfoAutoDetect(headers);
 			let init;
 			let url;
 			if (this.transport === "single") {
@@ -795,6 +796,30 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			if (!response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
 			return await response.json();
 		}
+		async fetchRuntimeInfoAutoDetect(headers) {
+			try {
+				const response = await fetch(`${this.runtimeUrl}/info`, {
+					headers: { ...headers },
+					...this.credentials ? { credentials: this.credentials } : {}
+				});
+				if (response.status >= 200 && response.status < 300) {
+					this.transport = "rest";
+					return await response.json();
+				}
+			} catch (_unused) {}
+			const singleHeaders = { ...headers };
+			if (!singleHeaders["Content-Type"]) singleHeaders["Content-Type"] = "application/json";
+			const response = await fetch(this.runtimeUrl, {
+				method: "POST",
+				headers: singleHeaders,
+				body: JSON.stringify({ method: "info" }),
+				...this.credentials ? { credentials: this.credentials } : {}
+			});
+			if (!response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
+			this.transport = "single";
+			this.singleEndpointUrl = this.runtimeUrl;
+			return await response.json();
+		}
 		createSingleRouteRequestInit(input, method, params) {
 			var _baseInit$headers, _headers$get;
 			if (!this.agentId) throw new Error("ProxiedCopilotRuntimeAgent requires agentId to make runtime requests");
@@ -878,11 +903,12 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "_runtimeUrl", void 0);
 			_defineProperty(this, "_runtimeVersion", void 0);
 			_defineProperty(this, "_runtimeConnectionStatus", CopilotKitCoreRuntimeConnectionStatus.Disconnected);
-			_defineProperty(this, "_runtimeTransport", "rest");
+			_defineProperty(this, "_runtimeTransport", "auto");
 			_defineProperty(this, "_audioFileTranscriptionEnabled", false);
 			_defineProperty(this, "_runtimeMode", _copilotkit_shared.RUNTIME_MODE_SSE);
 			_defineProperty(this, "_intelligence", void 0);
 			_defineProperty(this, "_a2uiEnabled", false);
+			_defineProperty(this, "_openGenerativeUIEnabled", false);
 			_defineProperty(this, "_licenseStatus", void 0);
 		}
 		/**
@@ -915,6 +941,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		get a2uiEnabled() {
 			return this._a2uiEnabled;
 		}
+		get openGenerativeUIEnabled() {
+			return this._openGenerativeUIEnabled;
+		}
 		get licenseStatus() {
 			return this._licenseStatus;
 		}
@@ -1027,6 +1056,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				this._runtimeMode = _copilotkit_shared.RUNTIME_MODE_SSE;
 				this._intelligence = void 0;
 				this._a2uiEnabled = false;
+				this._openGenerativeUIEnabled = false;
 				this.remoteAgents = {};
 				this._agents = this.localAgents;
 				await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Disconnected);
@@ -1036,7 +1066,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this._runtimeConnectionStatus = CopilotKitCoreRuntimeConnectionStatus.Connecting;
 			await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Connecting);
 			try {
-				var _runtimeInfoResponse$2, _runtimeInfoResponse$3, _runtimeInfoResponse$4;
+				var _runtimeInfoResponse$2, _runtimeInfoResponse$3, _runtimeInfoResponse$4, _runtimeInfoResponse$5;
 				const runtimeInfoResponse = await this.fetchRuntimeInfo();
 				const { version, ...runtimeInfo } = runtimeInfoResponse;
 				const credentials = this.core.credentials;
@@ -1064,6 +1094,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				this._runtimeMode = (_runtimeInfoResponse$3 = runtimeInfoResponse.mode) !== null && _runtimeInfoResponse$3 !== void 0 ? _runtimeInfoResponse$3 : _copilotkit_shared.RUNTIME_MODE_SSE;
 				this._intelligence = runtimeInfoResponse.intelligence;
 				this._a2uiEnabled = (_runtimeInfoResponse$4 = runtimeInfoResponse.a2uiEnabled) !== null && _runtimeInfoResponse$4 !== void 0 ? _runtimeInfoResponse$4 : false;
+				this._openGenerativeUIEnabled = (_runtimeInfoResponse$5 = runtimeInfoResponse.openGenerativeUIEnabled) !== null && _runtimeInfoResponse$5 !== void 0 ? _runtimeInfoResponse$5 : false;
 				this._licenseStatus = runtimeInfoResponse.licenseStatus;
 				await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Connected);
 				await this.notifyAgentsChanged();
@@ -1074,6 +1105,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				this._runtimeMode = _copilotkit_shared.RUNTIME_MODE_SSE;
 				this._intelligence = void 0;
 				this._a2uiEnabled = false;
+				this._openGenerativeUIEnabled = false;
 				this.remoteAgents = {};
 				this._agents = this.localAgents;
 				await this.notifyRuntimeStatusChanged(CopilotKitCoreRuntimeConnectionStatus.Error);
@@ -1093,25 +1125,46 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			const baseHeaders = this.core.headers;
 			const credentials = this.core.credentials;
 			const headers = { ...baseHeaders };
-			if (this._runtimeTransport === "single") {
-				if (!headers["Content-Type"]) headers["Content-Type"] = "application/json";
-				const response = await fetch(this.runtimeUrl, {
-					method: "POST",
-					headers,
-					body: JSON.stringify({ method: "info" }),
-					...credentials ? { credentials } : {}
-				});
-				if ("ok" in response && !response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
-				return await response.json();
-			}
+			if (this._runtimeTransport === "single") return this.fetchRuntimeInfoSingle(headers, credentials);
+			if (this._runtimeTransport === "auto") return this.fetchRuntimeInfoAutoDetect(headers, credentials);
 			const response = await fetch(`${this.runtimeUrl}/info`, {
 				headers,
 				...credentials ? { credentials } : {}
 			});
-			if ("ok" in response && !response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
+			if (!response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
+			return await response.json();
+		}
+		async fetchRuntimeInfoSingle(headers, credentials) {
+			if (!headers["Content-Type"]) headers["Content-Type"] = "application/json";
+			const response = await fetch(this.runtimeUrl, {
+				method: "POST",
+				headers,
+				body: JSON.stringify({ method: "info" }),
+				...credentials ? { credentials } : {}
+			});
+			if (!response.ok) throw new Error(`Runtime info request failed with status ${response.status}`);
 			return await response.json();
 		}
 		/**
+		* Auto-detect transport by trying REST first, then falling back to single-endpoint.
+		* Updates `_runtimeTransport` to the detected value so subsequent requests use it directly.
+		*/
+		async fetchRuntimeInfoAutoDetect(headers, credentials) {
+			try {
+				const response = await fetch(`${this.runtimeUrl}/info`, {
+					headers: { ...headers },
+					...credentials ? { credentials } : {}
+				});
+				if (response.status >= 200 && response.status < 300) {
+					this._runtimeTransport = "rest";
+					return await response.json();
+				}
+			} catch (_unused) {}
+			const result = await this.fetchRuntimeInfoSingle({ ...headers }, credentials);
+			this._runtimeTransport = "single";
+			return result;
+		}
+		/**
 		* Assign agent IDs to a record of agents
 		*/
 		assignAgentIds(agents) {
@@ -1243,11 +1296,17 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Reload suggestions for a specific agent
 		* This triggers generation of new suggestions based on current configs
+		*
+		* @param agentId - The consumer agent ID
+		* @param consumerAgent - Optional: the specific agent instance whose messages should be used
+		*   for availability filtering and context. When running with per-thread clones, the thread
+		*   clone holds the conversation messages; passing it here ensures dynamic suggestions fire
+		*   after the first message even though the registry agent has an empty message list.
 		*/
-		reloadSuggestions(agentId) {
+		reloadSuggestions(agentId, consumerAgent) {
 			var _agent$messages$lengt, _agent$messages;
 			this.clearSuggestions(agentId);
-			const agent = this.core.getAgent(agentId);
+			const agent = consumerAgent !== null && consumerAgent !== void 0 ? consumerAgent : this.core.getAgent(agentId);
 			if (!agent) return;
 			const messageCount = (_agent$messages$lengt = (_agent$messages = agent.messages) === null || _agent$messages === void 0 ? void 0 : _agent$messages.length) !== null && _agent$messages$lengt !== void 0 ? _agent$messages$lengt : 0;
 			let hasAnySuggestions = false;
@@ -1260,7 +1319,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						hasAnySuggestions = true;
 						this.notifySuggestionsStartedLoading(agentId);
 					}
-					this.generateSuggestions(suggestionId, config, agentId);
+					this.generateSuggestions(suggestionId, config, agentId, agent);
 				} else if (isStaticSuggestionsConfig(config)) this.addStaticSuggestions(suggestionId, config, agentId);
 			}
 		}
@@ -1289,13 +1348,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Generate suggestions using a provider agent
 		*/
-		async generateSuggestions(suggestionId, config, consumerAgentId) {
+		async generateSuggestions(suggestionId, config, consumerAgentId, consumerAgent) {
 			let agent = void 0;
 			try {
 				var _config$providerAgent, _this$_suggestions$co, _this$_runningSuggest3, _config$minSuggestion, _config$maxSuggestion;
 				const suggestionsProviderAgent = this.core.getAgent((_config$providerAgent = config.providerAgentId) !== null && _config$providerAgent !== void 0 ? _config$providerAgent : "default");
 				if (!suggestionsProviderAgent) throw new Error(`Suggestions provider agent not found: ${config.providerAgentId}`);
-				const suggestionsConsumerAgent = this.core.getAgent(consumerAgentId);
+				const suggestionsConsumerAgent = consumerAgent !== null && consumerAgent !== void 0 ? consumerAgent : this.core.getAgent(consumerAgentId);
 				if (!suggestionsConsumerAgent) throw new Error(`Suggestions consumer agent not found: ${consumerAgentId}`);
 				agent = suggestionsProviderAgent.clone();
 				agent.threadId = suggestionId;
@@ -1619,13 +1678,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				});
 			} catch (error) {
 				const connectError = error instanceof Error ? error : new Error(String(error));
-				const context = {};
-				if (agent.agentId) context.agentId = agent.agentId;
-				await this._internal.emitError({
-					error: connectError,
-					code: CopilotKitCoreErrorCode.AGENT_CONNECT_FAILED,
-					context
-				});
+				if (!(connectError.name === "AbortError" || connectError.message === "Fetch is aborted" || connectError.message === "signal is aborted without reason" || connectError.message === "component unmounted")) {
+					const context = {};
+					if (agent.agentId) context.agentId = agent.agentId;
+					await this._internal.emitError({
+						error: connectError,
+						code: CopilotKitCoreErrorCode.AGENT_CONNECT_FAILED,
+						context
+					});
+				}
 				return { newMessages: [] };
 			}
 		}
@@ -1636,6 +1697,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			if (agent.agentId) this._internal.suggestionEngine.clearSuggestions(agent.agentId);
 			if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...this._internal.headers };
 			if (agent.detachActiveRun) await agent.detachActiveRun();
+			this._internal.subscribeAgentToStateManager(agent);
 			const isTopLevel = this._runDepth === 0;
 			let originalAbortRun;
 			if (isTopLevel) {
@@ -1707,7 +1769,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				await this._internal.waitForPendingFrameworkUpdates();
 				return await this.runAgent({ agent });
 			}
-			this._internal.suggestionEngine.reloadSuggestions(agentId);
+			this._internal.suggestionEngine.reloadSuggestions(agentId, agent);
 			return runAgentResult;
 		}
 		/**
@@ -2127,6 +2189,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.core = core;
 			_defineProperty(this, "stateByRun", /* @__PURE__ */ new Map());
 			_defineProperty(this, "messageToRun", /* @__PURE__ */ new Map());
+			_defineProperty(this, "activeRun", /* @__PURE__ */ new Map());
 			_defineProperty(this, "agentSubscriptions", /* @__PURE__ */ new Map());
 		}
 		/**
@@ -2134,36 +2197,73 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		*/
 		initialize() {}
 		/**
-		* Subscribe to an agent's events to track state and messages
+		* Subscribe to an agent's events to track state and messages.
+		*
+		* Registry agents (subscribed via `onAgentsChanged`) use the bare `agentId`
+		* key so that `unsubscribeFromAgent(agentId)` can remove them when they
+		* are replaced. Per-thread clones (subscribed via `subscribeAgentToStateManager`)
+		* pass `{ isClone: true }` to use a composite `agentId:threadId` key, keeping
+		* their subscription independent of the registry agent's.
 		*/
-		subscribeToAgent(agent) {
+		subscribeToAgent(agent, { isClone = false } = {}) {
 			if (!agent.agentId) return;
 			const agentId = agent.agentId;
-			this.unsubscribeFromAgent(agentId);
+			const subscriptionKey = isClone && agent.threadId ? `${agentId}:${agent.threadId}` : agentId;
+			const existingUnsubscribe = this.agentSubscriptions.get(subscriptionKey);
+			if (existingUnsubscribe) {
+				existingUnsubscribe();
+				this.agentSubscriptions.delete(subscriptionKey);
+			}
+			let revoked = false;
+			let subRunId;
+			let runFinished = false;
+			const effectiveInput = (input) => {
+				var _subRunId;
+				return {
+					...input,
+					runId: (_subRunId = subRunId) !== null && _subRunId !== void 0 ? _subRunId : input.runId
+				};
+			};
 			const { unsubscribe } = agent.subscribe({
-				onRunStartedEvent: ({ event, state }) => {
-					this.handleRunStarted(agent, event, state);
+				onRunStartedEvent: ({ input, state }) => {
+					if (revoked) return;
+					if (runFinished && input.runId === subRunId) subRunId = (0, _ag_ui_client.randomUUID)();
+					else subRunId = input.runId;
+					runFinished = false;
+					this.handleRunStarted(agent, effectiveInput(input), state);
 				},
-				onRunFinishedEvent: ({ event, state }) => {
-					this.handleRunFinished(agent, event, state);
+				onRunFinishedEvent: ({ input, state }) => {
+					if (revoked) return;
+					runFinished = true;
+					this.handleRunFinished(agent, effectiveInput(input), state);
 				},
 				onStateSnapshotEvent: ({ event, input, state }) => {
-					this.handleStateSnapshot(agent, event, input, state);
+					if (revoked) return;
+					this.handleStateSnapshot(agent, event, effectiveInput(input), state);
 				},
 				onStateDeltaEvent: ({ event, input, state }) => {
-					this.handleStateDelta(agent, event, input, state);
+					if (revoked) return;
+					this.handleStateDelta(agent, event, effectiveInput(input), state);
 				},
 				onMessagesSnapshotEvent: ({ event, input, messages }) => {
-					this.handleMessagesSnapshot(agent, event, input, messages);
+					if (revoked) return;
+					this.handleMessagesSnapshot(agent, event, effectiveInput(input), messages);
 				},
 				onNewMessage: ({ message, input }) => {
-					this.handleNewMessage(agent, message, input);
+					if (revoked) return;
+					this.handleNewMessage(agent, message, input ? effectiveInput(input) : void 0);
 				}
 			});
-			this.agentSubscriptions.set(agentId, unsubscribe);
+			this.agentSubscriptions.set(subscriptionKey, () => {
+				revoked = true;
+				unsubscribe();
+			});
 		}
 		/**
-		* Unsubscribe from an agent's events
+		* Unsubscribe a registry agent's subscription (bare `agentId` key).
+		* Per-thread clone subscriptions use composite `agentId:threadId` keys and
+		* are replaced (not removed) by subsequent subscribeToAgent(agent, { isClone: true })
+		* calls for the same (agentId, threadId) pair.
 		*/
 		unsubscribeFromAgent(agentId) {
 			const unsubscribe = this.agentSubscriptions.get(agentId);
@@ -2207,18 +2307,20 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Handle run started event
 		*/
-		handleRunStarted(agent, event, state) {
+		handleRunStarted(agent, input, state) {
 			if (!agent.agentId) return;
-			const { threadId, runId } = event;
-			this.saveState(agent.agentId, threadId, runId, state);
+			const { threadId, runId } = input;
+			this.activeRun.set(`${agent.agentId}:${threadId}`, runId);
+			if (state && Object.keys(state).length > 0) this.saveState(agent.agentId, threadId, runId, state);
 		}
 		/**
 		* Handle run finished event
 		*/
-		handleRunFinished(agent, event, state) {
+		handleRunFinished(agent, input, state) {
 			if (!agent.agentId) return;
-			const { threadId, runId } = event;
-			this.saveState(agent.agentId, threadId, runId, state);
+			const { threadId, runId } = input;
+			this.activeRun.delete(`${agent.agentId}:${threadId}`);
+			if (state && Object.keys(state).length > 0) this.saveState(agent.agentId, threadId, runId, state);
 		}
 		/**
 		* Handle state snapshot event
@@ -2252,7 +2354,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* Handle new message event
 		*/
 		handleNewMessage(agent, message, input) {
-			if (!agent.agentId || !input) return;
+			if (!agent.agentId) return;
+			if (!input) {
+				var _agent$threadId;
+				const threadId = (_agent$threadId = agent.threadId) !== null && _agent$threadId !== void 0 ? _agent$threadId : "";
+				const runId = this.activeRun.get(`${agent.agentId}:${threadId}`);
+				if (runId) this.associateMessageWithRun(agent.agentId, threadId, message.id, runId);
+				return;
+			}
 			const { threadId, runId } = input;
 			this.associateMessageWithRun(agent.agentId, threadId, message.id, runId);
 		}
@@ -2335,10 +2444,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return CopilotKitCoreRuntimeConnectionStatus;
 	}({});
 	var CopilotKitCore = class {
-		constructor({ runtimeUrl, runtimeTransport = "rest", headers = {}, credentials, properties = {}, agents__unsafe_dev_only = {}, tools = [], suggestionsConfig = [] }) {
+		constructor({ runtimeUrl, runtimeTransport = "auto", headers = {}, credentials, properties = {}, agents__unsafe_dev_only = {}, tools = [], suggestionsConfig = [] }) {
 			_defineProperty(this, "_headers", void 0);
 			_defineProperty(this, "_credentials", void 0);
 			_defineProperty(this, "_properties", void 0);
+			_defineProperty(this, "_defaultThrottleMs", void 0);
 			_defineProperty(this, "subscribers", /* @__PURE__ */ new Set());
 			_defineProperty(this, "agentRegistry", void 0);
 			_defineProperty(this, "contextStore", void 0);
@@ -2427,6 +2537,22 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		get properties() {
 			return this._properties;
 		}
+		/**
+		* Default throttle interval (ms) applied by framework hooks (e.g.
+		* `useAgent()`) when the hook/component does not specify an explicit
+		* `throttleMs`. An explicit `0` passed as `throttleMs` to `useAgent()`
+		* or `<CopilotChat>` overrides this default and disables throttling.
+		*/
+		get defaultThrottleMs() {
+			return this._defaultThrottleMs;
+		}
+		setDefaultThrottleMs(value) {
+			if (value !== void 0 && (!Number.isFinite(value) || value < 0)) {
+				this._defaultThrottleMs = void 0;
+				return;
+			}
+			this._defaultThrottleMs = value;
+		}
 		get runtimeConnectionStatus() {
 			return this.agentRegistry.runtimeConnectionStatus;
 		}
@@ -2442,6 +2568,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		get a2uiEnabled() {
 			return this.agentRegistry.a2uiEnabled;
 		}
+		get openGenerativeUIEnabled() {
+			return this.agentRegistry.openGenerativeUIEnabled;
+		}
 		get licenseStatus() {
 			return this.agentRegistry.licenseStatus;
 		}
@@ -2572,6 +2701,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		getRunIdsForThread(agentId, threadId) {
 			return this.stateManager.getRunIdsForThread(agentId, threadId);
 		}
+		subscribeAgentToStateManager(agent) {
+			this.stateManager.subscribeToAgent(agent, { isClone: true });
+		}
 		/**
 		* Internal method used by RunHandler to build frontend tools
 		*/