@copilotkit/core 1.62.2-canary.1783457132 → 1.62.2-canary.1785518626

package/dist/index.cjs

@@ -2510,6 +2510,124 @@ var StateManager = class {
 	}
 };
 
+//#endregion
+//#region src/core/subagent-registry.ts
+/**
+* Tracks subagent lifecycle events (SUBAGENT_STARTED / FINISHED / ERROR) per
+* owning agent so consumers can resolve a message's `subagentId` to a name,
+* description, and running status.
+*
+* Modeled on {@link SuggestionEngine}: an in-memory `Record` keyed by (owning)
+* agentId, mutated from streamed AG-UI events, made reactive by calling
+* `notifySubscribers(onSubagentsChanged)` after every change. It owns its own
+* per-agent `agent.subscribe` (like {@link StateManager}) so it is fully
+* self-contained and adds no coupling to the state/message tracking path.
+*
+* No-op for runs without subagents (a normal LangGraph run never emits
+* SUBAGENT_* events), so the registry simply stays empty.
+*/
+var SubagentRegistry = class {
+	_subagents = {};
+	agentSubscriptions = /* @__PURE__ */ new Map();
+	constructor(core) {
+		this.core = core;
+	}
+	/**
+	* Subscribe to an agent's subagent lifecycle events. Idempotent per agentId:
+	* an existing subscription for the same agent is revoked and replaced.
+	*/
+	subscribeToAgent(agent) {
+		if (!agent.agentId) return;
+		const agentId = agent.agentId;
+		const existingUnsubscribe = this.agentSubscriptions.get(agentId);
+		if (existingUnsubscribe) {
+			existingUnsubscribe();
+			this.agentSubscriptions.delete(agentId);
+		}
+		let revoked = false;
+		const { unsubscribe } = agent.subscribe({
+			onSubagentStartedEvent: ({ event }) => {
+				if (revoked) return;
+				this.handleStarted(agentId, event);
+			},
+			onSubagentFinishedEvent: ({ event }) => {
+				if (revoked) return;
+				this.handleFinished(agentId, event);
+			},
+			onSubagentErrorEvent: ({ event }) => {
+				if (revoked) return;
+				this.handleError(agentId, event);
+			}
+		});
+		this.agentSubscriptions.set(agentId, () => {
+			revoked = true;
+			unsubscribe();
+		});
+	}
+	/**
+	* Unsubscribe an agent's subscription (symmetric with StateManager cleanup).
+	*/
+	unsubscribeFromAgent(agentId) {
+		const unsubscribe = this.agentSubscriptions.get(agentId);
+		if (unsubscribe) {
+			unsubscribe();
+			this.agentSubscriptions.delete(agentId);
+		}
+	}
+	/**
+	* Get the subagents observed for an owning agent, keyed by subagentId.
+	* Returns a fresh shallow copy each call so consumers (and React state) see
+	* a new reference when anything changed.
+	*/
+	getSubagents(agentId) {
+		return { ...this._subagents[agentId] };
+	}
+	handleStarted(agentId, event) {
+		const bucket = this._subagents[agentId] ??= {};
+		bucket[event.subagentId] = {
+			subagentId: event.subagentId,
+			name: event.name,
+			description: event.description,
+			parentSubagentId: event.parentSubagentId,
+			status: "running"
+		};
+		this.notifySubagentsChanged(agentId);
+	}
+	handleFinished(agentId, event) {
+		const bucket = this._subagents[agentId];
+		const existing = bucket?.[event.subagentId];
+		if (!bucket || !existing) return;
+		bucket[event.subagentId] = {
+			...existing,
+			status: "finished"
+		};
+		this.notifySubagentsChanged(agentId);
+	}
+	handleError(agentId, event) {
+		const bucket = this._subagents[agentId] ??= {};
+		const existing = bucket[event.subagentId];
+		bucket[event.subagentId] = existing ? {
+			...existing,
+			status: "error",
+			error: event.message
+		} : {
+			subagentId: event.subagentId,
+			name: event.subagentId,
+			status: "error",
+			error: event.message
+		};
+		this.notifySubagentsChanged(agentId);
+	}
+	async notifySubagentsChanged(agentId) {
+		const subagents = this.getSubagents(agentId);
+		await this.core.notifySubscribers((subscriber) => subscriber.onSubagentsChanged?.({
+			copilotkit: this.core,
+			agentId,
+			subagents
+		}), "Subscriber onSubagentsChanged error:");
+	}
+};
+
 //#endregion
 //#region src/core/thread-store-registry.ts
 var ThreadStoreRegistry = class {
@@ -3612,6 +3730,7 @@ var CopilotKitCore = class {
 	suggestionEngine;
 	runHandler;
 	stateManager;
+	subagentRegistry;
 	threadStoreRegistry;
 	/**
 	* The single core-owned memory store, created lazily on first
@@ -3637,6 +3756,7 @@ var CopilotKitCore = class {
 		this.suggestionEngine = new SuggestionEngine(this);
 		this.runHandler = new RunHandler(this);
 		this.stateManager = new StateManager(this);
+		this.subagentRegistry = new SubagentRegistry(this);
 		this.threadStoreRegistry = new ThreadStoreRegistry(this);
 		this.agentRegistry.initialize(agents__unsafe_dev_only);
 		this.runHandler.initialize(tools);
@@ -3651,7 +3771,10 @@ var CopilotKitCore = class {
 			},
 			onAgentsChanged: ({ agents }) => {
 				Object.values(agents).forEach((agent) => {
-					if (agent.agentId) this.stateManager.subscribeToAgent(agent);
+					if (agent.agentId) {
+						this.stateManager.subscribeToAgent(agent);
+						this.subagentRegistry.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 {
@@ -3659,10 +3782,17 @@ var CopilotKitCore = class {
 				} 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 this.previousAgentIds) if (!currentAgentIds.has(agentId)) {
+					try {
+						this.stateManager.unsubscribeFromAgent(agentId);
+					} catch (err) {
+						console.error(`CopilotKitCore.onAgentsChanged: stateManager.unsubscribeFromAgent failed for "${agentId}":`, err);
+					}
+					try {
+						this.subagentRegistry.unsubscribeFromAgent(agentId);
+					} catch (err) {
+						console.error(`CopilotKitCore.onAgentsChanged: subagentRegistry.unsubscribeFromAgent failed for "${agentId}":`, err);
+					}
 				}
 				this.previousAgentIds = currentAgentIds;
 			}
@@ -4004,6 +4134,16 @@ var CopilotKitCore = class {
 		return this.suggestionEngine.getSuggestions(agentId);
 	}
 	/**
+	* Subagent registry (delegated to SubagentRegistry).
+	*
+	* Returns the subagents observed for an owning agent during its run(s),
+	* keyed by `subagentId`, each carrying `name` / `description` / `status`.
+	* Empty for runs that never emit SUBAGENT_* events.
+	*/
+	getSubagents(agentId) {
+		return this.subagentRegistry.getSubagents(agentId);
+	}
+	/**
 	* Tool management (delegated to RunHandler)
 	*/
 	addTool(tool) {
@@ -4409,6 +4549,7 @@ const initialThreadState = {
 	isLoading: false,
 	isFetchingNextPage: false,
 	error: null,
+	fetchMoreError: null,
 	context: null,
 	sessionId: 0,
 	metadataCredentialsRequested: false,
@@ -4494,6 +4635,7 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	isLoading: Boolean(context),
 	isFetchingNextPage: false,
 	error: null,
+	fetchMoreError: null,
 	metadataCredentialsRequested: false,
 	metadataJoinCode: null,
 	nextCursor: null,
@@ -4505,6 +4647,7 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	isLoading: false,
 	isFetchingNextPage: false,
 	error: null,
+	fetchMoreError: null,
 	metadataCredentialsRequested: false,
 	metadataJoinCode: null,
 	nextCursor: null,
@@ -4515,7 +4658,8 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	return {
 		...state,
 		isLoading: true,
-		error: null
+		error: null,
+		fetchMoreError: null
 	};
 }), on(threadRestEvents.listSucceeded, (state, { sessionId, threads, joinCode, nextCursor }) => {
 	if (sessionId !== state.sessionId) return state;
@@ -4525,6 +4669,7 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 		threads: sortThreadsByRecency(threads),
 		isLoading: false,
 		error: null,
+		fetchMoreError: null,
 		metadataJoinCode: joinCode,
 		metadataCredentialsRequested: joinCodeChanged ? false : state.metadataCredentialsRequested,
 		nextCursor
@@ -4544,6 +4689,7 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 		...state,
 		threads: merged,
 		isFetchingNextPage: false,
+		fetchMoreError: null,
 		nextCursor
 	};
 }), on(threadRestEvents.nextPageFailed, (state, { sessionId, error }) => {
@@ -4551,7 +4697,7 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	return {
 		...state,
 		isFetchingNextPage: false,
-		error
+		fetchMoreError: error
 	};
 }), on(threadRestEvents.metadataCredentialsFailed, (state, { sessionId }) => {
 	if (sessionId !== state.sessionId) return state;
@@ -4569,7 +4715,8 @@ const threadReducer = createReducer(initialThreadState, on(threadAdapterEvents.c
 	if (!state.nextCursor || state.isFetchingNextPage) return state;
 	return {
 		...state,
-		isFetchingNextPage: true
+		isFetchingNextPage: true,
+		fetchMoreError: null
 	};
 }), on(threadAdapterEvents.renameRequested, (state, { threadId, name }) => {
 	const existing = state.threads.find((thread) => thread.id === threadId);
@@ -4698,6 +4845,7 @@ function createThreadSelectors() {
 		threads: createSelector((state) => state.threads),
 		isLoading: createSelector((state) => state.isLoading),
 		error: createSelector((state) => state.error),
+		fetchMoreError: createSelector((state) => state.fetchMoreError),
 		hasNextPage: createSelector((state) => state.nextCursor != null),
 		isFetchingNextPage: createSelector((state) => state.isFetchingNextPage),
 		isMutating: createSelector((state) => state.inFlightMutationCount > 0)
@@ -4707,6 +4855,7 @@ const standaloneSelectors = createThreadSelectors();
 const selectThreads = standaloneSelectors.threads;
 const selectThreadsIsLoading = standaloneSelectors.isLoading;
 const selectThreadsError = standaloneSelectors.error;
+const selectFetchMoreError = standaloneSelectors.fetchMoreError;
 const selectHasNextPage = standaloneSelectors.hasNextPage;
 const selectIsFetchingNextPage = standaloneSelectors.isFetchingNextPage;
 const selectIsMutating = standaloneSelectors.isMutating;
@@ -5080,6 +5229,7 @@ const ɵcreateThreadSelectors = createThreadSelectors;
 const ɵselectThreads = selectThreads;
 const ɵselectThreadsIsLoading = selectThreadsIsLoading;
 const ɵselectThreadsError = selectThreadsError;
+const ɵselectFetchMoreError = selectFetchMoreError;
 const ɵselectHasNextPage = selectHasNextPage;
 const ɵselectIsFetchingNextPage = selectIsFetchingNextPage;
 const ɵselectIsMutating = selectIsMutating;
@@ -5149,6 +5299,7 @@ exports.MemoryError = MemoryError;
 exports.ProxiedCopilotRuntimeAgent = ProxiedCopilotRuntimeAgent;
 exports.RunHandler = RunHandler;
 exports.StateManager = StateManager;
+exports.SubagentRegistry = SubagentRegistry;
 exports.SuggestionEngine = SuggestionEngine;
 exports.ToolCallStatus = ToolCallStatus;
 exports.completePartialMarkdown = completePartialMarkdown;
@@ -5184,6 +5335,7 @@ exports.ɵobservePhoenixSocketHealth$ = ɵobservePhoenixSocketHealth$;
 exports.ɵobservePhoenixSocketSignals$ = ɵobservePhoenixSocketSignals$;
 exports.ɵphoenixChannel$ = ɵphoenixChannel$;
 exports.ɵphoenixSocket$ = ɵphoenixSocket$;
+exports.ɵselectFetchMoreError = ɵselectFetchMoreError;
 exports.ɵselectHasNextPage = ɵselectHasNextPage;
 exports.ɵselectIsFetchingNextPage = ɵselectIsFetchingNextPage;
 exports.ɵselectIsMutating = ɵselectIsMutating;