@copilotkit/react-core 1.72.1-canary.sp-longthread-perf → 1.73.2-canary.1790068297

package/dist/{copilotkit-BV7MguMm.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");
@@ -3855,8 +3860,8 @@ function useRenderCustomMessages() {
 		if (aHasAgent === (b.agentId !== void 0)) return 0;
 		return aHasAgent ? -1 : 1;
 	});
-	if (!customMessageRenderers.length) return null;
 	return function(params) {
+		if (!customMessageRenderers.length) return null;
 		const { message, position } = params;
 		const resolvedRunId = copilotkit.getRunIdForMessage(agentId, threadId, message.id) ?? copilotkit.getRunIdsForThread(agentId, threadId).slice(-1)[0];
 		const runId = resolvedRunId ?? `missing-run-id:${message.id}`;
@@ -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);
@@ -7029,32 +7132,6 @@ CopilotChatSuggestionView.displayName = "CopilotChatSuggestionView";
 */
 const ScrollElementContext = react.default.createContext(null);
 
-//#endregion
-//#region src/v2/components/chat/scroll-pinned-context.ts
-/**
-* True while the pin-to-bottom behaviour is actively following the bottom of
-* the thread — i.e. `use-stick-to-bottom` will animate the scroll position to
-* the bottom the next time the content grows.
-*
-* Only CopilotChatView's pin-to-bottom branch provides this. The other scroll
-* modes leave it `false`, which is correct: nothing else writes the scroll
-* position on its own, so no one is competing with the virtualizer.
-*
-* Why this exists: the virtualizer and `use-stick-to-bottom` both write
-* `scrollTop` on the same element. The virtualizer writes it to compensate
-* when a row above the viewport turns out taller than its estimate, so that
-* what the reader is looking at does not shift. That compensation is essential
-* while the reader is scrolled up — and pointless while pinned to the bottom,
-* because the pin is about to move the scroll position anyway. Worse than
-* pointless: the compensation changes the virtual container's height, the pin
-* reads that as content growth and animates, the animation brings unmeasured
-* rows into view, they measure, and the two keep shoving each other.
-*
-* Consumed by CopilotChatMessageView to stand the virtualizer down while the
-* pin owns the scroll position.
-*/
-const ScrollPinnedContext = react.default.createContext(false);
-
 //#endregion
 //#region src/v2/components/intelligence-indicator/IntelligenceIndicatorView.tsx
 /**
@@ -7520,7 +7597,6 @@ function deduplicateMessages(messages) {
 }
 const VIRTUALIZE_THRESHOLD = 50;
 function CopilotChatMessageView({ messages = [], assistantMessage, userMessage, reasoningMessage, cursor, intelligenceIndicator, isRunning = false, children, className, ...props }) {
-	const isPinnedToBottom = (0, react.useContext)(ScrollPinnedContext);
 	const renderCustomMessage = useRenderCustomMessages();
 	const { renderActivityMessage } = useRenderActivityMessage();
 	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
@@ -7552,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;
@@ -7586,36 +7669,17 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 		if (process.env.NODE_ENV !== "production" && scrollElementFromCtx && scrollElementFromCtx.clientHeight === 0) console.warn("[CopilotKit] Chat scroll container has clientHeight=0 — virtualization disabled. Ensure the chat is rendered in a visible container with a non-zero height.");
 	}, [scrollElementFromCtx]);
 	const shouldVirtualize = !!scrollElement && !children && deduplicatedMessages.length > VIRTUALIZE_THRESHOLD;
-	const measuredRef = react.default.useRef({
-		count: 0,
-		total: 0
-	});
-	const isPinnedToBottomRef = react.default.useRef(isPinnedToBottom);
-	const shouldAdjustScrollOnResize = react.default.useCallback(() => !isPinnedToBottomRef.current, []);
-	const estimateRowSize = react.default.useCallback(() => {
-		const { count, total } = measuredRef.current;
-		return count > 0 ? Math.max(1, Math.round(total / count)) : 100;
-	}, []);
 	const virtualizer = (0, _tanstack_react_virtual.useVirtualizer)({
 		count: shouldVirtualize ? deduplicatedMessages.length : 0,
 		getScrollElement: () => scrollElement,
-		estimateSize: estimateRowSize,
+		estimateSize: () => 100,
 		overscan: 5,
-		measureElement: (el) => {
-			const height = el?.getBoundingClientRect().height ?? 0;
-			if (height > 0) {
-				measuredRef.current.count += 1;
-				measuredRef.current.total += height;
-			}
-			return height;
-		},
+		measureElement: (el) => el?.getBoundingClientRect().height ?? 0,
 		initialRect: {
 			width: 0,
 			height: 600
 		}
 	});
-	isPinnedToBottomRef.current = isPinnedToBottom;
-	virtualizer.shouldAdjustScrollPositionOnItemSizeChange = shouldAdjustScrollOnResize;
 	const firstMessageId = deduplicatedMessages[0]?.id;
 	(0, react.useLayoutEffect)(() => {
 		if (!shouldVirtualize || !deduplicatedMessages.length) return;
@@ -7624,42 +7688,43 @@ function CopilotChatMessageView({ messages = [], assistantMessage, userMessage,
 	const intelligenceTurnAnchors = (0, react.useMemo)(() => getIntelligenceTurnAnchors(deduplicatedMessages), [deduplicatedMessages]);
 	const renderMessageBlock = (message) => {
 		const elements = [];
-		const stateSnapshot = renderCustomMessage ? getStateSnapshotForMessage(message.id) : void 0;
+		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,
@@ -7705,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,
@@ -8268,28 +8333,25 @@ function CopilotChatView({ messageView, input, scrollView, suggestionView, welco
 		const BoundFeather = renderSlot(feather, CopilotChatView.Feather, {});
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollElementContext.Provider, {
 			value: scrollEl,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollPinnedContext.Provider, {
-				value: isAtBottom,
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(use_stick_to_bottom.StickToBottom.Content, {
-						className: "cpk:overflow-y-auto cpk:overflow-x-hidden",
-						style: {
-							flex: "1 1 0%",
-							minHeight: 0
-						},
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-							className: "cpk:px-4 cpk:@3xl:px-0 cpk:[div[data-sidebar-chat]_&]:px-8 cpk:[div[data-popup-chat]_&]:px-6",
-							children
-						})
-					}),
-					BoundFeather,
-					!isAtBottom && !isResizing && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "cpk:absolute cpk:inset-x-0 cpk:flex cpk:justify-center cpk:z-30 cpk:pointer-events-none",
-						style: { bottom: `${inputContainerHeight + SCROLL_BUTTON_OFFSET}px` },
-						children: renderSlot(scrollToBottomButton, CopilotChatView.ScrollToBottomButton, { onClick: () => scrollToBottom() })
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(use_stick_to_bottom.StickToBottom.Content, {
+					className: "cpk:overflow-y-auto cpk:overflow-x-hidden",
+					style: {
+						flex: "1 1 0%",
+						minHeight: 0
+					},
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "cpk:px-4 cpk:@3xl:px-0 cpk:[div[data-sidebar-chat]_&]:px-8 cpk:[div[data-popup-chat]_&]:px-6",
+						children
 					})
-				] })
-			})
+				}),
+				BoundFeather,
+				!isAtBottom && !isResizing && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "cpk:absolute cpk:inset-x-0 cpk:flex cpk:justify-center cpk:z-30 cpk:pointer-events-none",
+					style: { bottom: `${inputContainerHeight + SCROLL_BUTTON_OFFSET}px` },
+					children: renderSlot(scrollToBottomButton, CopilotChatView.ScrollToBottomButton, { onClick: () => scrollToBottom() })
+				})
+			] })
 		});
 	};
 	const PinToSendScrollContainer = ({ children, scrollRef, contentRef, scrollToBottom, scrollToBottomButton, feather, inputContainerHeight, isResizing, nonAutoScrollEl, nonAutoScrollRefCallback, showScrollButton, className, ...props }) => {
@@ -9021,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",
@@ -9958,10 +10013,10 @@ function findChatInput(origin) {
 *   thread-list launcher appears, and binds the element `open` state to the
 *   configuration's `drawerOpen`.
 *
-* License gating is two-pronged: the locked view shows when no license is configured
-* (the runtime reported no license status) OR the `threads` feature is
-* explicitly unlicensed. While unlicensed, the thread fetch is skipped entirely
-* so an unlicensed drawer issues no network requests.
+* Intelligence gating is two-pronged: the locked view shows when the runtime
+* reports no active entitlement OR the `threads` feature is unavailable. While
+* unavailable, the thread fetch is skipped entirely so the drawer issues no
+* network requests.
 *
 * Thread switching needs no host wiring: when `onThreadSelect`/`onNewThread`
 * are omitted, the wrapper drives the surrounding chat configuration directly
@@ -9973,7 +10028,7 @@ function findChatInput(origin) {
 * @example
 * ```tsx
 * // Callback-free: the drawer drives the chat configuration itself.
-* <CopilotKitProvider runtimeUrl="/api/copilotkit" publicLicenseKey="ck_pub_...">
+* <CopilotKitProvider runtimeUrl="/api/copilotkit">
 *   <CopilotChat />
 *   <CopilotThreadsDrawer />
 * </CopilotKitProvider>
@@ -12852,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 () {
@@ -12948,4 +13009,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-BV7MguMm.cjs.map
+//# sourceMappingURL=copilotkit-D_c2dJ9t.cjs.map