@copilotkit/core 1.57.0 → 1.57.1

package/dist/index.umd.js

@@ -602,10 +602,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	var _ProxiedCopilotRuntimeAgent_brand = /* @__PURE__ */ new WeakSet();
 	var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui_client.HttpAgent {
 		constructor(config) {
-			var _config$transport, _ref, _config$agentId, _config$runtimeMode;
+			var _config$transport, _ref, _config$runtimeAgentI, _ref2, _config$runtimeMode;
 			const normalizedRuntimeUrl = config.runtimeUrl ? config.runtimeUrl.replace(/\/$/, "") : void 0;
 			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`;
+			const routedId = (_ref = (_config$runtimeAgentI = config.runtimeAgentId) !== null && _config$runtimeAgentI !== void 0 ? _config$runtimeAgentI : config.agentId) !== null && _ref !== void 0 ? _ref : "";
+			const runUrl = transport === "single" ? (_ref2 = normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl) !== null && _ref2 !== void 0 ? _ref2 : "" : `${normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl}/agent/${encodeURIComponent(routedId)}/run`;
 			if (!runUrl) throw new Error("ProxiedCopilotRuntimeAgent requires a runtimeUrl when transport is set to 'single'.");
 			super({
 				...config,
@@ -614,6 +615,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_classPrivateMethodInitSpec(this, _ProxiedCopilotRuntimeAgent_brand);
 			_defineProperty(this, "runtimeUrl", void 0);
 			_defineProperty(this, "credentials", void 0);
+			_defineProperty(this, "runtimeAgentId", void 0);
 			_defineProperty(this, "transport", void 0);
 			_defineProperty(this, "singleEndpointUrl", void 0);
 			_defineProperty(this, "runtimeMode", void 0);
@@ -623,6 +625,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "runtimeInfoPromise", void 0);
 			this.runtimeUrl = normalizedRuntimeUrl !== null && normalizedRuntimeUrl !== void 0 ? normalizedRuntimeUrl : config.runtimeUrl;
 			this.credentials = config.credentials;
+			this.runtimeAgentId = config.runtimeAgentId;
 			this.transport = transport;
 			this.runtimeMode = (_config$runtimeMode = config.runtimeMode) !== null && _config$runtimeMode !== void 0 ? _config$runtimeMode : _copilotkit_shared.RUNTIME_MODE_SSE;
 			this.intelligence = config.intelligence;
@@ -630,6 +633,22 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			if (config.debug) this.debug = config.debug;
 			if (this.transport === "single") this.singleEndpointUrl = this.runtimeUrl;
 		}
+		/**
+		* The agent id used for outbound runtime requests — `runtimeAgentId` when
+		* set (manually-registered proxy), otherwise `agentId` (registry id
+		* matches runtime id). Subscriber bookkeeping keeps using `agentId`
+		* directly.
+		*
+		* Throws when both are unset: a proxy reaching an HTTP path with no
+		* routable id is a bug, and a missing id would otherwise produce a
+		* malformed `/agent//run` or `/agent/undefined/connect` URL silently.
+		*/
+		routedAgentId() {
+			var _this$runtimeAgentId;
+			const id = (_this$runtimeAgentId = this.runtimeAgentId) !== null && _this$runtimeAgentId !== void 0 ? _this$runtimeAgentId : this.agentId;
+			if (!id) throw new Error("ProxiedCopilotRuntimeAgent: cannot make a runtime request without an agentId or runtimeAgentId.");
+			return id;
+		}
 		get capabilities() {
 			return this._capabilities;
 		}
@@ -650,6 +669,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			}
 			if (!this.agentId || !this.threadId) return;
 			if (typeof fetch === "undefined") return;
+			const routedId = this.routedAgentId();
 			if (this.transport === "single") {
 				if (!this.singleEndpointUrl) return;
 				const headers = new Headers({
@@ -662,7 +682,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					body: JSON.stringify({
 						method: "agent/stop",
 						params: {
-							agentId: this.agentId,
+							agentId: routedId,
 							threadId: this.threadId
 						}
 					}),
@@ -673,7 +693,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				return;
 			}
 			if (!this.runtimeUrl) return;
-			const stopPath = `${this.runtimeUrl}/agent/${encodeURIComponent(this.agentId)}/stop/${encodeURIComponent(this.threadId)}`;
+			const stopPath = `${this.runtimeUrl}/agent/${encodeURIComponent(routedId)}/stop/${encodeURIComponent(this.threadId)}`;
 			const origin = typeof window !== "undefined" && window.location ? window.location.origin : "http://localhost";
 			const base = new URL(this.runtimeUrl, origin);
 			const stopUrl = new URL(stopPath, base);
@@ -737,6 +757,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			const cloned = new ProxiedCopilotRuntimeAgent({
 				runtimeUrl: this.runtimeUrl,
 				agentId: this.agentId,
+				runtimeAgentId: this.runtimeAgentId,
 				description: this.description,
 				headers: { ...this.headers },
 				credentials: this.credentials,
@@ -849,17 +870,18 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 		createIntelligenceDelegate() {
 			var _this$intelligence;
-			if (!this.runtimeUrl || !this.agentId || !((_this$intelligence = this.intelligence) === null || _this$intelligence === void 0 ? void 0 : _this$intelligence.wsUrl)) throw new Error("Intelligence mode requires runtimeUrl, agentId, and intelligence websocket metadata");
+			const routedId = this.routedAgentId();
+			if (!this.runtimeUrl || !routedId || !((_this$intelligence = this.intelligence) === null || _this$intelligence === void 0 ? void 0 : _this$intelligence.wsUrl)) throw new Error("Intelligence mode requires runtimeUrl, agentId, and intelligence websocket metadata");
 			return new IntelligenceAgent({
 				url: this.intelligence.wsUrl,
 				runtimeUrl: this.runtimeUrl,
-				agentId: this.agentId,
+				agentId: routedId,
 				headers: { ...this.headers },
 				credentials: this.credentials
 			});
 		}
 		syncDelegate(delegate) {
-			delegate.agentId = this.agentId;
+			delegate.agentId = this.routedAgentId();
 			delegate.description = this.description;
 			delegate.threadId = this.threadId;
 			delegate.setMessages(this.messages);
@@ -873,12 +895,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		return (0, rxjs.defer)(() => (0, rxjs.from)(this.resolveDelegate())).pipe((0, rxjs_operators.switchMap)((delegate) => withAbortErrorHandling(delegate.connect(input))));
 	}
 	function _connectViaHttp(input) {
+		const routedId = this.routedAgentId();
 		if (this.transport === "single") {
 			if (!this.singleEndpointUrl) throw new Error("Single endpoint transport requires a runtimeUrl");
-			const requestInit = this.createSingleRouteRequestInit(input, "agent/connect", { agentId: this.agentId });
+			const requestInit = this.createSingleRouteRequestInit(input, "agent/connect", { agentId: routedId });
 			return withAbortErrorHandling((0, _ag_ui_client.transformHttpEventStream)((0, _ag_ui_client.runHttpRequest)(this.singleEndpointUrl, requestInit)));
 		}
-		return withAbortErrorHandling((0, _ag_ui_client.transformHttpEventStream)((0, _ag_ui_client.runHttpRequest)(`${this.runtimeUrl}/agent/${this.agentId}/connect`, this.requestInit(input))));
+		return withAbortErrorHandling((0, _ag_ui_client.transformHttpEventStream)((0, _ag_ui_client.runHttpRequest)(`${this.runtimeUrl}/agent/${routedId}/connect`, this.requestInit(input))));
 	}
 	function _runViaDelegate(input) {
 		return (0, rxjs.defer)(() => (0, rxjs.from)(this.resolveDelegate())).pipe((0, rxjs_operators.switchMap)((delegate) => withAbortErrorHandling(delegate.run(input))));
@@ -886,7 +909,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	function _runViaHttp(input) {
 		if (this.transport === "single") {
 			if (!this.singleEndpointUrl) throw new Error("Single endpoint transport requires a runtimeUrl");
-			const requestInit = this.createSingleRouteRequestInit(input, "agent/run", { agentId: this.agentId });
+			const requestInit = this.createSingleRouteRequestInit(input, "agent/run", { agentId: this.routedAgentId() });
 			return withAbortErrorHandling((0, _ag_ui_client.transformHttpEventStream)((0, _ag_ui_client.runHttpRequest)(this.singleEndpointUrl, requestInit)));
 		}
 		return withAbortErrorHandling(_superPropGet(_ProxiedCopilotRuntimeAgent.prototype, "run", this, 2)([input]));
@@ -1016,6 +1039,52 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.notifyAgentsChanged();
 		}
 		/**
+		* Register a proxied agent that routes outbound runtime requests to an
+		* existing runtime agent (`runtimeAgentId`) while exposing a distinct local
+		* registry id (`agentId`). Throws if `agentId` is already taken by either a
+		* local or runtime-discovered agent.
+		*
+		* Use this to mount multiple frontend agents against a single runtime
+		* agent (e.g. a chat-1 / chat-2 pair both proxying to "default") without
+		* implicit per-thread cloning. The returned `unregister` removes the proxy
+		* from the registry and emits `onAgentsChanged`.
+		*/
+		registerProxiedAgent({ agentId, runtimeAgentId }) {
+			if (Object.prototype.hasOwnProperty.call(this._agents, agentId)) throw new Error(`CopilotKitCore.registerProxiedAgent: agentId "${agentId}" is already registered. Pick a different agentId, or unregister the existing agent first.`);
+			const friends = this.core;
+			const debug = friends.debug;
+			const agent = new ProxiedCopilotRuntimeAgent({
+				runtimeUrl: this._runtimeUrl,
+				agentId,
+				runtimeAgentId,
+				transport: this._runtimeTransport,
+				credentials: friends.credentials,
+				runtimeMode: this._runtimeUrl ? this._runtimeConnectionStatus === CopilotKitCoreRuntimeConnectionStatus.Connected ? this._runtimeMode : "pending" : _copilotkit_shared.RUNTIME_MODE_SSE,
+				intelligence: this._intelligence,
+				debug: debug ? (0, _copilotkit_shared.resolveDebugConfig)(debug) : void 0
+			});
+			this.applyHeadersToAgent(agent);
+			this.localAgents[agentId] = agent;
+			this._agents = {
+				...this.localAgents,
+				...this.remoteAgents
+			};
+			this.notifyAgentsChanged();
+			return {
+				agent,
+				unregister: () => {
+					if (this.localAgents[agentId] === agent) {
+						delete this.localAgents[agentId];
+						this._agents = {
+							...this.localAgents,
+							...this.remoteAgents
+						};
+						this.notifyAgentsChanged();
+					}
+				}
+			};
+		}
+		/**
 		* Get an agent by ID
 		*/
 		getAgent(id) {
@@ -1306,17 +1375,11 @@ 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, consumerAgent) {
+		reloadSuggestions(agentId) {
 			var _agent$messages$lengt, _agent$messages;
 			this.clearSuggestions(agentId);
-			const agent = consumerAgent !== null && consumerAgent !== void 0 ? consumerAgent : this.core.getAgent(agentId);
+			const agent = this.core.getAgent(agentId);
 			const messageCount = (_agent$messages$lengt = agent === null || agent === void 0 || (_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;
 			for (const config of Object.values(this._suggestionsConfig)) {
@@ -1329,7 +1392,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 						hasAnySuggestions = true;
 						this.notifySuggestionsStartedLoading(agentId);
 					}
-					this.generateSuggestions(suggestionId, config, agentId, agent);
+					this.generateSuggestions(suggestionId, config, agentId);
 				} else if (isStaticSuggestionsConfig(config)) this.addStaticSuggestions(suggestionId, config, agentId);
 			}
 		}
@@ -1358,13 +1421,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		/**
 		* Generate suggestions using a provider agent
 		*/
-		async generateSuggestions(suggestionId, config, consumerAgentId, consumerAgent) {
+		async generateSuggestions(suggestionId, config, consumerAgentId) {
 			let agent = void 0;
 			try {
 				var _config$providerAgent, _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 = consumerAgent !== null && consumerAgent !== void 0 ? consumerAgent : this.core.getAgent(consumerAgentId);
+				const suggestionsConsumerAgent = this.core.getAgent(consumerAgentId);
 				if (!suggestionsConsumerAgent) throw new Error(`Suggestions consumer agent not found: ${consumerAgentId}`);
 				agent = suggestionsProviderAgent.clone();
 				agent.threadId = suggestionId;
@@ -1677,13 +1740,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				agent.setMessages([]);
 				agent.setState({});
 				if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...this._internal.headers };
-				await this._internal.notifySubscribers((subscriber) => {
-					var _subscriber$onAgentRu;
-					return (_subscriber$onAgentRu = subscriber.onAgentRunStarted) === null || _subscriber$onAgentRu === void 0 ? void 0 : _subscriber$onAgentRu.call(subscriber, {
-						copilotkit: this.core,
-						agent
-					});
-				}, "Subscriber onAgentRunStarted error:");
 				const runAgentResult = await agent.connectAgent({
 					forwardedProps: this._internal.properties,
 					tools: this.buildFrontendTools(agent.agentId),
@@ -1714,14 +1770,6 @@ 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);
-			await this._internal.notifySubscribers((subscriber) => {
-				var _subscriber$onAgentRu2;
-				return (_subscriber$onAgentRu2 = subscriber.onAgentRunStarted) === null || _subscriber$onAgentRu2 === void 0 ? void 0 : _subscriber$onAgentRu2.call(subscriber, {
-					copilotkit: this.core,
-					agent
-				});
-			}, "Subscriber onAgentRunStarted error:");
 			const isTopLevel = this._runDepth === 0;
 			let originalAbortRun;
 			if (isTopLevel) {
@@ -1793,7 +1841,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				await this._internal.waitForPendingFrameworkUpdates();
 				return await this.runAgent({ agent });
 			}
-			this._internal.suggestionEngine.reloadSuggestions(agentId, agent);
+			this._internal.suggestionEngine.reloadSuggestions(agentId);
 			return runAgentResult;
 		}
 		/**
@@ -2222,21 +2270,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		initialize() {}
 		/**
 		* 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, { isClone = false } = {}) {
+		subscribeToAgent(agent) {
 			if (!agent.agentId) return;
 			const agentId = agent.agentId;
-			const subscriptionKey = isClone && agent.threadId ? `${agentId}:${agent.threadId}` : agentId;
-			const existingUnsubscribe = this.agentSubscriptions.get(subscriptionKey);
+			const existingUnsubscribe = this.agentSubscriptions.get(agentId);
 			if (existingUnsubscribe) {
 				existingUnsubscribe();
-				this.agentSubscriptions.delete(subscriptionKey);
+				this.agentSubscriptions.delete(agentId);
 			}
 			let revoked = false;
 			let subRunId;
@@ -2283,16 +2324,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					this.handleNewMessage(agent, message, input ? effectiveInput(input) : void 0);
 				}
 			});
-			this.agentSubscriptions.set(subscriptionKey, () => {
+			this.agentSubscriptions.set(agentId, () => {
 				revoked = true;
 				unsubscribe();
 			});
 		}
 		/**
-		* 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.
+		* Unsubscribe an agent's subscription.
 		*/
 		unsubscribeFromAgent(agentId) {
 			const unsubscribe = this.agentSubscriptions.get(agentId);
@@ -2583,7 +2621,16 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					if (agent.agentId) this.stateManager.subscribeToAgent(agent);
 				});
 				const currentAgentIds = new Set(Object.keys(agents));
-				for (const agentId of Object.keys(this.threadStoreRegistry.getAll())) if (this.previousAgentIds.has(agentId) && !currentAgentIds.has(agentId)) this.threadStoreRegistry.unregister(agentId);
+				for (const agentId of Object.keys(this.threadStoreRegistry.getAll())) if (this.previousAgentIds.has(agentId) && !currentAgentIds.has(agentId)) try {
+					this.threadStoreRegistry.unregister(agentId);
+				} catch (err) {
+					console.error(`CopilotKitCore.onAgentsChanged: threadStoreRegistry.unregister failed for "${agentId}":`, err);
+				}
+				for (const agentId of this.previousAgentIds) if (!currentAgentIds.has(agentId)) try {
+					this.stateManager.unsubscribeFromAgent(agentId);
+				} catch (err) {
+					console.error(`CopilotKitCore.onAgentsChanged: stateManager.unsubscribeFromAgent failed for "${agentId}":`, err);
+				}
 				this.previousAgentIds = currentAgentIds;
 			} });
 		}
@@ -2755,6 +2802,28 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		removeAgent__unsafe_dev_only(id) {
 			this.agentRegistry.removeAgent__unsafe_dev_only(id);
 		}
+		/**
+		* Register a proxied agent against an existing runtime agent. The proxy is
+		* exposed under `agentId` (local registry id) and routes outbound runtime
+		* requests to `runtimeAgentId`. Throws if `agentId` is already taken.
+		*
+		* Returns the minted proxy and an `unregister` handle for cleanup.
+		*
+		* Use this to mount multiple frontend agents against a single runtime
+		* agent (e.g. one per chat window) without implicit per-thread cloning.
+		*
+		* @example
+		* const { agent, unregister } = copilotkit.registerProxiedAgent({
+		*   agentId: "chat-1",
+		*   runtimeAgentId: "default",
+		* });
+		* // ... <CopilotChat agentId="chat-1" />
+		* // on cleanup:
+		* unregister();
+		*/
+		registerProxiedAgent(params) {
+			return this.agentRegistry.registerProxiedAgent(params);
+		}
 		getAgent(id) {
 			return this.agentRegistry.getAgent(id);
 		}
@@ -2989,9 +3058,6 @@ 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
 		*/