@copilotkit/core 1.56.5-canary.1777972218 → 1.57.0

package/dist/index.cjs

@@ -502,7 +502,6 @@ function withAbortErrorHandling(observable) {
 var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui_client.HttpAgent {
 	runtimeUrl;
 	credentials;
-	remoteAgentId;
 	transport;
 	singleEndpointUrl;
 	runtimeMode;
@@ -513,8 +512,7 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 	constructor(config) {
 		const normalizedRuntimeUrl = config.runtimeUrl ? config.runtimeUrl.replace(/\/$/, "") : void 0;
 		const transport = config.transport ?? "auto";
-		const routedId = config.remoteAgentId ?? config.agentId ?? "";
-		const runUrl = transport === "single" ? normalizedRuntimeUrl ?? config.runtimeUrl ?? "" : `${normalizedRuntimeUrl ?? config.runtimeUrl}/agent/${encodeURIComponent(routedId)}/run`;
+		const runUrl = transport === "single" ? normalizedRuntimeUrl ?? config.runtimeUrl ?? "" : `${normalizedRuntimeUrl ?? config.runtimeUrl}/agent/${encodeURIComponent(config.agentId ?? "")}/run`;
 		if (!runUrl) throw new Error("ProxiedCopilotRuntimeAgent requires a runtimeUrl when transport is set to 'single'.");
 		super({
 			...config,
@@ -522,7 +520,6 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		});
 		this.runtimeUrl = normalizedRuntimeUrl ?? config.runtimeUrl;
 		this.credentials = config.credentials;
-		this.remoteAgentId = config.remoteAgentId;
 		this.transport = transport;
 		this.runtimeMode = config.runtimeMode ?? _copilotkit_shared.RUNTIME_MODE_SSE;
 		this.intelligence = config.intelligence;
@@ -530,21 +527,6 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		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() {
-		const id = 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;
 	}
@@ -564,7 +546,6 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		}
 		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({
@@ -577,7 +558,7 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 				body: JSON.stringify({
 					method: "agent/stop",
 					params: {
-						agentId: routedId,
+						agentId: this.agentId,
 						threadId: this.threadId
 					}
 				}),
@@ -588,7 +569,7 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 			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);
@@ -652,13 +633,12 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		return (0, rxjs.defer)(() => (0, rxjs.from)(this.resolveDelegate())).pipe((0, rxjs_operators.switchMap)((delegate) => withAbortErrorHandling(delegate.connect(input))));
 	}
 	#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))));
 	}
 	#runViaDelegate(input) {
 		return (0, rxjs.defer)(() => (0, rxjs.from)(this.resolveDelegate())).pipe((0, rxjs_operators.switchMap)((delegate) => withAbortErrorHandling(delegate.run(input))));
@@ -666,7 +646,7 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 	#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(super.run(input));
@@ -675,7 +655,6 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		const cloned = new ProxiedCopilotRuntimeAgent({
 			runtimeUrl: this.runtimeUrl,
 			agentId: this.agentId,
-			remoteAgentId: this.remoteAgentId,
 			description: this.description,
 			headers: { ...this.headers },
 			credentials: this.credentials,
@@ -784,18 +763,17 @@ var ProxiedCopilotRuntimeAgent = class ProxiedCopilotRuntimeAgent extends _ag_ui
 		};
 	}
 	createIntelligenceDelegate() {
-		const routedId = this.routedAgentId();
-		if (!this.runtimeUrl || !routedId || !this.intelligence?.wsUrl) throw new Error("Intelligence mode requires runtimeUrl, agentId, and intelligence websocket metadata");
+		if (!this.runtimeUrl || !this.agentId || !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);
@@ -929,52 +907,6 @@ var AgentRegistry = class {
 		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) {
@@ -1254,10 +1186,16 @@ var SuggestionEngine = class {
 	/**
 	* 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) {
 		this.clearSuggestions(agentId);
-		const agent = this.core.getAgent(agentId);
+		const agent = consumerAgent ?? this.core.getAgent(agentId);
 		const messageCount = agent?.messages?.length ?? 0;
 		let hasAnySuggestions = false;
 		for (const config of Object.values(this._suggestionsConfig)) {
@@ -1270,7 +1208,7 @@ var SuggestionEngine = class {
 					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);
 		}
 	}
@@ -1298,12 +1236,12 @@ var SuggestionEngine = class {
 	/**
 	* Generate suggestions using a provider agent
 	*/
-	async generateSuggestions(suggestionId, config, consumerAgentId) {
+	async generateSuggestions(suggestionId, config, consumerAgentId, consumerAgent) {
 		let agent = void 0;
 		try {
 			const suggestionsProviderAgent = this.core.getAgent(config.providerAgentId ?? "default");
 			if (!suggestionsProviderAgent) throw new Error(`Suggestions provider agent not found: ${config.providerAgentId}`);
-			const suggestionsConsumerAgent = this.core.getAgent(consumerAgentId);
+			const suggestionsConsumerAgent = consumerAgent ?? this.core.getAgent(consumerAgentId);
 			if (!suggestionsConsumerAgent) throw new Error(`Suggestions consumer agent not found: ${consumerAgentId}`);
 			agent = suggestionsProviderAgent.clone();
 			agent.threadId = suggestionId;
@@ -1608,6 +1546,10 @@ var RunHandler = class {
 			agent.setMessages([]);
 			agent.setState({});
 			if (agent instanceof _ag_ui_client.HttpAgent) agent.headers = { ...this._internal.headers };
+			await this._internal.notifySubscribers((subscriber) => subscriber.onAgentRunStarted?.({
+				copilotkit: this.core,
+				agent
+			}), "Subscriber onAgentRunStarted error:");
 			const runAgentResult = await agent.connectAgent({
 				forwardedProps: this._internal.properties,
 				tools: this.buildFrontendTools(agent.agentId),
@@ -1638,6 +1580,11 @@ var RunHandler = class {
 		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) => subscriber.onAgentRunStarted?.({
+			copilotkit: this.core,
+			agent
+		}), "Subscriber onAgentRunStarted error:");
 		const isTopLevel = this._runDepth === 0;
 		let originalAbortRun;
 		if (isTopLevel) {
@@ -1708,7 +1655,7 @@ var RunHandler = class {
 			await this._internal.waitForPendingFrameworkUpdates();
 			return await this.runAgent({ agent });
 		}
-		this._internal.suggestionEngine.reloadSuggestions(agentId);
+		this._internal.suggestionEngine.reloadSuggestions(agentId, agent);
 		return runAgentResult;
 	}
 	/**
@@ -2120,14 +2067,21 @@ var StateManager = class {
 	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;
@@ -2171,13 +2125,16 @@ var StateManager = class {
 				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);
@@ -2462,16 +2419,7 @@ var CopilotKitCore = class {
 				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;
 		} });
 	}
@@ -2634,28 +2582,6 @@ var CopilotKitCore = class {
 	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);
 	}
@@ -2889,6 +2815,9 @@ var CopilotKitCore = class {
 	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
 	*/