@copilotkit/react-core 1.73.0 → 1.73.2-canary.1790068297

package/dist/{copilotkit-tkBlMrXl.cjs → copilotkit-D_c2dJ9t.cjs}

@@ -3391,7 +3391,7 @@ function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	}, [value, warningMessage]);
 	return value;
 }
-const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY_HEADERS, credentials, publicApiKey, publicLicenseKey, licenseToken, properties = EMPTY_PROPERTIES, agents__unsafe_dev_only: agents = EMPTY_AGENTS, selfManagedAgents = EMPTY_AGENTS, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, openGenerativeUI, enableInspector, agentId, useSingleEndpoint, onError, a2ui, defaultThrottleMs, debug }) => {
+const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY_HEADERS, credentials, messageFilter, publicApiKey, publicLicenseKey, licenseToken, properties = EMPTY_PROPERTIES, agents__unsafe_dev_only: agents = EMPTY_AGENTS, selfManagedAgents = EMPTY_AGENTS, renderToolCalls, renderActivityMessages, renderCustomMessages, frontendTools, humanInTheLoop, openGenerativeUI, enableInspector, agentId, useSingleEndpoint, onError, a2ui, defaultThrottleMs, debug }) => {
 	const [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
 	const [inspectorVisible, setInspectorVisible] = (0, react.useState)(false);
 	(0, react.useEffect)(() => {
@@ -3512,6 +3512,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		const processedRenderToolCalls = [];
 		humanInTheLoopList.forEach((tool) => {
 			const frontendTool = {
+				type: "human-in-the-loop",
 				name: tool.name,
 				description: tool.description,
 				parameters: tool.parameters,
@@ -3618,6 +3619,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 			runtimeTransport: useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto",
 			headers: mergedHeaders,
 			credentials,
+			messageFilter,
 			properties,
 			agents__unsafe_dev_only: mergedAgents,
 			tools: allTools,
@@ -3703,6 +3705,9 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 			subscription.unsubscribe();
 		};
 	}, [copilotkit]);
+	(0, react.useEffect)(() => {
+		copilotkit.setMessageFilter(messageFilter);
+	}, [copilotkit, messageFilter]);
 	(0, react.useEffect)(() => {
 		copilotkit.setRuntimeUrl(chatApiEndpoint);
 		copilotkit.setRuntimeTransport(useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto");
@@ -3932,10 +3937,10 @@ function useRenderActivityMessage() {
 
 //#endregion
 //#region src/v2/hooks/use-frontend-tool.tsx
-const EMPTY_DEPS$1 = [];
+const EMPTY_DEPS$2 = [];
 function useFrontendTool(tool, deps) {
 	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
-	const extraDeps = deps ?? EMPTY_DEPS$1;
+	const extraDeps = deps ?? EMPTY_DEPS$2;
 	(0, react.useLayoutEffect)(() => {
 		const name = tool.name;
 		if (copilotkit.getTool({
@@ -3964,6 +3969,103 @@ function useFrontendTool(tool, deps) {
 	]);
 }
 
+//#endregion
+//#region src/v2/hooks/use-frontend-tools.tsx
+const EMPTY_DEPS$1 = [];
+const EMPTY_TOOLS = [];
+/**
+* Register a list of frontend tools whose length can change between renders.
+*
+* `useFrontendTool` registers exactly one tool per call, so it cannot be called
+* in a loop over a runtime-length list without breaking the rules of hooks.
+* This hook runs a single effect over the whole array instead, which makes it
+* safe to build the list from state, props, or a server response.
+*
+* Tools are keyed by `name` plus `agentId`, the same as `useFrontendTool`. A
+* tool that disappears from the array is unregistered on the next render, and
+* every tool is unregistered on unmount. Renderers stay registered after
+* unmount so past tool calls still render in the chat history.
+*
+* @param tools - The tools to register. May be empty and may change length.
+* @param deps - Extra dependencies that force re-registration, compared by
+* identity like the second argument of `useEffect`. Use this when a handler
+* closes over a value that is not part of the tool definition. Keep the array
+* a constant length across renders.
+*
+* @example
+* Register one tool per item in application state:
+* ```tsx
+* const [reports, setReports] = useState<Report[]>([]);
+*
+* useFrontendTools(
+*   reports.map((report) => ({
+*     name: `open_${report.id}`,
+*     description: `Open the ${report.title} report`,
+*     handler: async () => navigate(`/reports/${report.id}`),
+*   })),
+*   [navigate],
+* );
+* ```
+*
+* @example
+* Register tools described by the backend:
+* ```tsx
+* const { data } = useQuery(fetchToolDescriptors);
+*
+* useFrontendTools(
+*   (data ?? []).map((descriptor) => ({
+*     name: descriptor.name,
+*     description: descriptor.description,
+*     parameters: z.object({ query: z.string() }),
+*     handler: async ({ query }) => runDescriptor(descriptor.id, query),
+*   })),
+* );
+* ```
+*/
+function useFrontendTools(tools, deps) {
+	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
+	const toolList = tools ?? EMPTY_TOOLS;
+	const extraDeps = deps ?? EMPTY_DEPS$1;
+	(0, react.useLayoutEffect)(() => {
+		const deduped = /* @__PURE__ */ new Map();
+		for (const tool of toolList) {
+			const key = `${tool.agentId ?? ""}:${tool.name}`;
+			if (deduped.has(key)) console.warn(`Tool '${tool.name}' is listed more than once for agent '${tool.agentId || "global"}' in the same useFrontendTools call. Using the last entry.`);
+			deduped.set(key, tool);
+		}
+		const registered = [...deduped.values()];
+		for (const tool of registered) {
+			if (copilotkit.getTool({
+				toolName: tool.name,
+				agentId: tool.agentId
+			})) {
+				console.warn(`Tool '${tool.name}' already exists for agent '${tool.agentId || "global"}'. Overriding with latest registration.`);
+				copilotkit.removeTool(tool.name, tool.agentId);
+			}
+			copilotkit.addTool(tool);
+			if (tool.render) copilotkit.addHookRenderToolCall({
+				name: tool.name,
+				args: tool.parameters,
+				agentId: tool.agentId,
+				render: tool.render
+			});
+		}
+		return () => {
+			for (const tool of registered) copilotkit.removeTool(tool.name, tool.agentId);
+		};
+	}, [
+		JSON.stringify(toolList.map((tool) => [
+			tool.name,
+			tool.description ?? null,
+			tool.agentId ?? null,
+			tool.available ?? null,
+			tool.webmcp ?? null
+		])),
+		copilotkit,
+		...extraDeps
+	]);
+}
+
 //#endregion
 //#region src/v2/hooks/use-component.tsx
 /**
@@ -4380,6 +4482,7 @@ function useHumanInTheLoop(tool, deps) {
 	]);
 	useFrontendTool({
 		...tool,
+		type: "human-in-the-loop",
 		handler,
 		render: RenderComponent
 	}, deps);
@@ -7525,6 +7628,13 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 		return copilotkit.getStateByRun(config.agentId, config.threadId, resolvedRunId);
 	};
 	const deduplicatedMessages = (0, react.useMemo)(() => deduplicateMessages(messages), [messages]);
+	const rowKeyStoreRef = (0, react.useRef)(null);
+	rowKeyStoreRef.current ??= (0, _copilotkit_shared.createRowKeyStore)();
+	const rowKeyStore = rowKeyStoreRef.current;
+	const rowRenderKeys = (0, react.useMemo)(() => (0, _copilotkit_shared.resolveRowRenderKeysById)(rowKeyStore, deduplicatedMessages), [rowKeyStore, deduplicatedMessages]);
+	(0, react.useLayoutEffect)(() => {
+		(0, _copilotkit_shared.commitRowKeyStore)(rowKeyStore, deduplicatedMessages);
+	}, [rowKeyStore, deduplicatedMessages]);
 	if (process.env.NODE_ENV === "development" && deduplicatedMessages.length < messages.length) console.warn(`CopilotChatMessageView: Merged ${messages.length - deduplicatedMessages.length} message(s) with duplicate IDs.`);
 	const { Component: AssistantComponent, slotProps: assistantSlotProps } = (0, react.useMemo)(() => resolveSlotComponent(assistantMessage, CopilotChatAssistantMessage_default), [assistantMessage]);
 	const agentId = config?.agentId;
@@ -7579,41 +7689,42 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 	const renderMessageBlock = (message) => {
 		const elements = [];
 		const stateSnapshot = getStateSnapshotForMessage(message.id);
+		const rowKey = rowRenderKeys.get(message.id) ?? message.id;
 		if (renderCustomMessage) elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedCustomMessage, {
 			message,
 			position: "before",
 			renderCustomMessage,
 			stateSnapshot
-		}, `${message.id}-custom-before`));
+		}, `${rowKey}-custom-before`));
 		if (message.role === "assistant") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedAssistantMessage, {
 			message,
 			messages,
 			isRunning,
 			AssistantMessageComponent: AssistantComponent,
 			slotProps: assistantSlotPropsWithFeedback
-		}, message.id));
+		}, rowKey));
 		else if (message.role === "user") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedUserMessage, {
 			message,
 			UserMessageComponent: UserComponent,
 			slotProps: userSlotProps
-		}, message.id));
+		}, rowKey));
 		else if (message.role === "activity") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedActivityMessage, {
 			message,
 			renderActivityMessage
-		}, message.id));
+		}, rowKey));
 		else if (message.role === "reasoning") elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedReasoningMessage, {
 			message,
 			messages,
 			isRunning,
 			ReasoningMessageComponent: ReasoningComponent,
 			slotProps: reasoningSlotProps
-		}, message.id));
+		}, rowKey));
 		if (renderCustomMessage) elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(MemoizedCustomMessage, {
 			message,
 			position: "after",
 			renderCustomMessage,
 			stateSnapshot
-		}, `${message.id}-custom-after`));
+		}, `${rowKey}-custom-after`));
 		const intelligenceTurnId = intelligenceTurnAnchors.get(message.id);
 		if (intelligenceTurnId !== void 0) elements.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IntelligenceIndicator, {
 			message,
@@ -7659,7 +7770,7 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 							transform: `translateY(${virtualItem.start}px)`
 						},
 						children: renderMessageBlock(message)
-					}, message.id);
+					}, rowRenderKeys.get(message.id) ?? message.id);
 				})
 			}) : messageElements,
 			interruptElement,
@@ -8972,14 +9083,7 @@ function CopilotChat({ agentId, threadId, labels, inspectorTools, chatView, isMo
 				type: "text",
 				text: value
 			});
-			for (const att of readyAttachments) contentParts.push({
-				type: att.type,
-				source: att.source,
-				metadata: {
-					...att.filename ? { filename: att.filename } : {},
-					...att.metadata
-				}
-			});
+			for (const att of readyAttachments) contentParts.push((0, _copilotkit_shared.createAttachmentContent)(att));
 			agent.addMessage({
 				id: (0, _copilotkit_shared.randomUUID)(),
 				role: "user",
@@ -12803,6 +12907,12 @@ Object.defineProperty(exports, 'useFrontendTool', {
     return useFrontendTool;
   }
 });
+Object.defineProperty(exports, 'useFrontendTools', {
+  enumerable: true,
+  get: function () {
+    return useFrontendTools;
+  }
+});
 Object.defineProperty(exports, 'useHumanInTheLoop', {
   enumerable: true,
   get: function () {
@@ -12899,4 +13009,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-tkBlMrXl.cjs.map
+//# sourceMappingURL=copilotkit-D_c2dJ9t.cjs.map