@copilotkit/core 1.56.5-canary.1777972218 → 1.57.0

package/dist/index.umd.js

@@ -602,11 +602,10 @@ 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$remoteAgentId, _ref2, _config$runtimeMode;
+			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 : "auto";
-			const routedId = (_ref = (_config$remoteAgentId = config.remoteAgentId) !== null && _config$remoteAgentId !== void 0 ? _config$remoteAgentId : 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`;
+			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({
 				...config,
@@ -615,7 +614,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			_classPrivateMethodInitSpec(this, _ProxiedCopilotRuntimeAgent_brand);
 			_defineProperty(this, "runtimeUrl", void 0);
 			_defineProperty(this, "credentials", void 0);
-			_defineProperty(this, "remoteAgentId", void 0);
 			_defineProperty(this, "transport", void 0);
 			_defineProperty(this, "singleEndpointUrl", void 0);
 			_defineProperty(this, "runtimeMode", void 0);
@@ -625,7 +623,6 @@ 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.remoteAgentId = config.remoteAgentId;
 			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;
@@ -633,22 +630,6 @@ 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 — `remoteAgentId` 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$remoteAgentId;
-			const id = (_this$remoteAgentId = this.remoteAgentId) !== null && _this$remoteAgentId !== void 0 ? _this$remoteAgentId : this.agentId;
-			if (!id) throw new Error("ProxiedCopilotRuntimeAgent: cannot make a runtime request without an agentId or remoteAgentId.");
-			return id;
-		}
 		get capabilities() {
 			return this._capabilities;
 		}
@@ -669,7 +650,6 @@ 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({
@@ -682,7 +662,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					body: JSON.stringify({
 						method: "agent/stop",
 						params: {
-							agentId: routedId,
+							agentId: this.agentId,
 							threadId: this.threadId
 						}
 					}),
@@ -693,7 +673,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 				return;
 			}
 			if (!this.runtimeUrl) return;
-			const stopPath = `${this.runtimeUrl}/agent/${encodeURIComponent(routedId)}/stop/${encodeURIComponent(this.threadId)}`;
+			const stopPath = `${this.runtimeUrl}/agent/${encodeURIComponent(this.agentId)}/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);
@@ -757,7 +737,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			const cloned = new ProxiedCopilotRuntimeAgent({
 				runtimeUrl: this.runtimeUrl,
 				agentId: this.agentId,
-				remoteAgentId: this.remoteAgentId,
 				description: this.description,
 				headers: { ...this.headers },
 				credentials: this.credentials,
@@ -870,18 +849,17 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 		}
 		createIntelligenceDelegate() {
 			var _this$intelligence;
-			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");
+			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");
 			return new IntelligenceAgent({
 				url: this.intelligence.wsUrl,
 				runtimeUrl: this.runtimeUrl,
-				agentId: routedId,
+				agentId: this.agentId,
 				headers: { ...this.headers },
 				credentials: this.credentials
 			});
 		}
 		syncDelegate(delegate) {
-			delegate.agentId = this.routedAgentId();
+			delegate.agentId = this.agentId;
 			delegate.description = this.description;
 			delegate.threadId = this.threadId;
 			delegate.setMessages(this.messages);
@@ -895,13 +873,12 @@ 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: routedId });
+			const requestInit = this.createSingleRouteRequestInit(input, "agent/connect", { agentId: this.agentId });
 			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/${routedId}/connect`, this.requestInit(input))));
+		return withAbortErrorHandling((0, _ag_ui_client.transformHttpEventStream)((0, _ag_ui_client.runHttpRequest)(`${this.runtimeUrl}/agent/${this.agentId}/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))));
@@ -909,7 +886,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.routedAgentId() });
+			const requestInit = this.createSingleRouteRequestInit(input, "agent/run", { agentId: this.agentId });
 			return withAbortErrorHandling((0, _ag_ui_client.transformHttpEventStream)((0, _ag_ui_client.runHttpRequest)(this.singleEndpointUrl, requestInit)));
 		}
 		return withAbortErrorHandling(_superPropGet(_ProxiedCopilotRuntimeAgent.prototype, "run", this, 2)([input]));
@@ -1039,52 +1016,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 			this.notifyAgentsChanged();
 		}
 		/**
-		* Register a proxied agent that routes outbound runtime requests to an
-		* existing runtime agent (`remoteAgentId`) 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, remoteAgentId }) {
-			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,
-				remoteAgentId,
-				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) {
@@ -1375,11 +1306,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);
 			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)) {
@@ -1392,7 +1329,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);
 			}
 		}
@@ -1421,13 +1358,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$_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;
@@ -1740,6 +1677,13 @@ 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),
@@ -1770,6 +1714,14 @@ 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) {
@@ -1841,7 +1793,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;
 		}
 		/**
@@ -2270,14 +2222,21 @@ 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) {
+		subscribeToAgent(agent, { isClone = false } = {}) {
 			if (!agent.agentId) return;
 			const agentId = agent.agentId;
-			const existingUnsubscribe = this.agentSubscriptions.get(agentId);
+			const subscriptionKey = isClone && agent.threadId ? `${agentId}:${agent.threadId}` : agentId;
+			const existingUnsubscribe = this.agentSubscriptions.get(subscriptionKey);
 			if (existingUnsubscribe) {
 				existingUnsubscribe();
-				this.agentSubscriptions.delete(agentId);
+				this.agentSubscriptions.delete(subscriptionKey);
 			}
 			let revoked = false;
 			let subRunId;
@@ -2324,13 +2283,16 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 					this.handleNewMessage(agent, message, input ? effectiveInput(input) : void 0);
 				}
 			});
-			this.agentSubscriptions.set(agentId, () => {
+			this.agentSubscriptions.set(subscriptionKey, () => {
 				revoked = true;
 				unsubscribe();
 			});
 		}
 		/**
-		* Unsubscribe an agent's subscription.
+		* 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);
@@ -2621,16 +2583,7 @@ 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)) 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);
-				}
+				for (const agentId of Object.keys(this.threadStoreRegistry.getAll())) if (this.previousAgentIds.has(agentId) && !currentAgentIds.has(agentId)) this.threadStoreRegistry.unregister(agentId);
 				this.previousAgentIds = currentAgentIds;
 			} });
 		}
@@ -2802,28 +2755,6 @@ 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 `remoteAgentId`. 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",
-		*   remoteAgentId: "default",
-		* });
-		* // ... <CopilotChat agentId="chat-1" />
-		* // on cleanup:
-		* unregister();
-		*/
-		registerProxiedAgent(params) {
-			return this.agentRegistry.registerProxiedAgent(params);
-		}
 		getAgent(id) {
 			return this.agentRegistry.getAgent(id);
 		}
@@ -3058,6 +2989,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
 		*/