@copilotkit/core 1.57.0 → 1.57.1-canary.1778272612

package/dist/index.umd.js

@@ -295,10 +295,22 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		* Reconnect to an existing thread by fetching websocket credentials and
 		* joining the realtime thread channel.
 		*/
+		/**
+		* Reconnect to an existing thread by fetching websocket credentials
+		* and joining the realtime thread channel.
+		*
+		* Note: this method does NOT clear the replay cursor. Whether to
+		* request a full historical replay vs. resume from
+		* `lastSeenEventId` is a decision the caller (typically
+		* `RunHandler.connectAgent`) makes by calling
+		* {@link clearReconnectCursor} ahead of time on a fresh thread
+		* restore. Same-thread churn re-connects preserve the cursor so the
+		* gateway only streams events past it instead of replaying the
+		* entire history every time the chat re-opens a socket.
+		*/
 		connect(input) {
 			this.threadId = input.threadId;
 			this.canonicalRunId = null;
-			this.clearReconnectCursor(input.threadId);
 			return (0, rxjs.defer)(() => this.requestJoinCredentials$("connect", input)).pipe((0, rxjs.switchMap)((credentials) => {
 				if (credentials === null) return rxjs.EMPTY;
 				const canonicalInput = this.applyCanonicalRunIdentity(input, credentials, { fallbackToInputRunId: false });
@@ -483,6 +495,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		getReconnectCursor(input) {
 			return this.getLastSeenEventId(input.threadId);
 		}
+		/**
+		* Drop the cached `lastSeenEventId` cursor for `threadId` so the
+		* next connect to that topic asks the gateway for a full historical
+		* replay (rather than resuming). Public because
+		* `RunHandler.connectAgent` calls it on a detected thread switch
+		* to rebuild local state from scratch, and skips it on same-thread
+		* churn so the gateway can resume.
+		*/
 		clearReconnectCursor(threadId) {
 			this.sharedState.lastSeenEventIds.delete(threadId);
 		}
@@ -602,10 +622,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 +635,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 +645,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 +653,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 +689,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 +702,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 +713,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 +777,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,
@@ -755,6 +796,24 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			}
 			return cloned;
 		}
+		/**
+		* Drop the delegate's cached `lastSeenEventId` for this thread so
+		* the next connect requests a full historical replay from the
+		* gateway. Used by `RunHandler.connectAgent` on a detected thread
+		* switch (the chat moved between threads, so its local
+		* messages/state are about to be cleared and need rebuilding from
+		* the gateway). Skipped on same-thread churn re-connects so the
+		* gateway can resume from the cursor instead.
+		*
+		* No-op for non-Intelligence runtime modes — the HTTP transport
+		* doesn't replay.
+		*/
+		clearReplayCursor(threadId) {
+			var _delegate$clearReconn;
+			if (this.runtimeMode !== _copilotkit_shared.RUNTIME_MODE_INTELLIGENCE) return;
+			const delegate = this.delegate;
+			delegate === null || delegate === void 0 || (_delegate$clearReconn = delegate.clearReconnectCursor) === null || _delegate$clearReconn === void 0 || _delegate$clearReconn.call(delegate, threadId);
+		}
 		async resolveDelegate() {
 			await this.ensureRuntimeMode();
 			if (!this.delegate) {
@@ -849,17 +908,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 +933,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 +947,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 +1077,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 +1413,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 +1430,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 +1459,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;
@@ -1601,6 +1702,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_defineProperty(this, "_tools", []);
 			_defineProperty(this, "_runAbortController", null);
 			_defineProperty(this, "_runDepth", 0);
+			_defineProperty(this, "_lastConnectedThreadId", null);
 		}
 		/**
 		* Abort the current run. Called by `CopilotKitCore.stopAgent()` to signal
@@ -1673,17 +1775,18 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		*/
 		async connectAgent({ agent }) {
 			try {
+				var _agent$threadId;
+				const incomingThreadId = (_agent$threadId = agent.threadId) !== null && _agent$threadId !== void 0 ? _agent$threadId : null;
+				const isFreshRestore = incomingThreadId !== this._lastConnectedThreadId;
+				this._lastConnectedThreadId = incomingThreadId;
 				await agent.detachActiveRun();
-				agent.setMessages([]);
-				agent.setState({});
+				if (isFreshRestore) {
+					agent.setMessages([]);
+					agent.setState({});
+					const proxied = agent;
+					if (incomingThreadId && typeof proxied.clearReplayCursor === "function") proxied.clearReplayCursor(incomingThreadId);
+				}
 				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 +1817,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 +1888,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 +2317,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 +2371,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 +2668,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 +2849,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 +3105,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
 		*/