@copilotkit/react-core 1.79.1 → 1.80.0

package/dist/index.umd.js

@@ -178,7 +178,7 @@ react_markdown = __toESM(react_markdown);
 	* Returns true only for plain JS objects (`{}`), excluding arrays, Dates,
 	* class instances, and other exotic objects that happen to have typeof "object".
 	*/
-	function isPlainObject(obj) {
+	function isPlainObject$1(obj) {
 		return obj !== null && typeof obj === "object" && Object.prototype.toString.call(obj) === "[object Object]";
 	}
 	/**
@@ -197,7 +197,7 @@ react_markdown = __toESM(react_markdown);
 	function useShallowStableRef(value) {
 		const ref = (0, react.useRef)(value);
 		if (ref.current === value) return ref.current;
-		if (isPlainObject(ref.current) && isPlainObject(value)) {
+		if (isPlainObject$1(ref.current) && isPlainObject$1(value)) {
 			if (shallowEqual(ref.current, value)) return ref.current;
 		}
 		ref.current = value;
@@ -213,6 +213,8 @@ react_markdown = __toESM(react_markdown);
 		chatInputToolbarFinishTranscribeButtonLabel: "Finish",
 		chatInputToolbarAddButtonLabel: "Add attachments",
 		chatInputToolbarToolsButtonLabel: "Tools",
+		chatInputToolbarSendButtonLabel: "Send message",
+		chatInputToolbarStopButtonLabel: "Stop",
 		assistantMessageToolbarCopyCodeLabel: "Copy",
 		assistantMessageToolbarCopyCodeCopiedLabel: "Copied",
 		assistantMessageToolbarCopyMessageLabel: "Copy",
@@ -225,13 +227,18 @@ react_markdown = __toESM(react_markdown);
 		assistantMessageToolbarInspectorHideDescription: "Until you reload this page",
 		assistantMessageToolbarThumbsUpLabel: "Good response",
 		assistantMessageToolbarThumbsDownLabel: "Bad response",
+		assistantMessageFeedbackCommentPlaceholder: "Add a comment (optional)",
+		assistantMessageFeedbackCommentSubmitLabel: "Send comment",
 		assistantMessageToolbarReadAloudLabel: "Read aloud",
 		assistantMessageToolbarRegenerateLabel: "Regenerate",
 		userMessageToolbarCopyMessageLabel: "Copy",
 		userMessageToolbarEditMessageLabel: "Edit",
+		userMessageToolbarPreviousBranchLabel: "Previous branch",
+		userMessageToolbarNextBranchLabel: "Next branch",
 		chatDisclaimerText: "AI can make mistakes. Please verify important information.",
 		chatToggleOpenLabel: "Open chat",
 		chatToggleCloseLabel: "Close chat",
+		chatScrollToBottomLabel: "Scroll to bottom",
 		modalHeaderTitle: "CopilotKit Chat",
 		welcomeMessageText: "How can I help you today?"
 	};
@@ -555,6 +562,14 @@ react_markdown = __toESM(react_markdown);
 		}
 	}
 	/**
+	* The tool-call renderers registered on the provider, kept current.
+	* @internal
+	*/
+	function useToolCallRenderers() {
+		const { copilotkit } = useCopilotKit();
+		return (0, react.useSyncExternalStore)((callback) => copilotkit.subscribe({ onRenderToolCallsChanged: callback }).unsubscribe, () => copilotkit.renderToolCalls, () => copilotkit.renderToolCalls);
+	}
+	/**
 	* Hook that returns a function to render tool calls based on the render functions
 	* defined in CopilotKitProvider.
 	*
@@ -565,9 +580,7 @@ react_markdown = __toESM(react_markdown);
 		const agentId = useCopilotChatConfiguration()?.agentId ?? _copilotkit_shared.DEFAULT_AGENT_ID;
 		const unrenderedToolNames = (0, react.useRef)(/* @__PURE__ */ new Set());
 		const warnedToolNames = (0, react.useRef)(/* @__PURE__ */ new Set());
-		const renderToolCalls = (0, react.useSyncExternalStore)((callback) => {
-			return copilotkit.subscribe({ onRenderToolCallsChanged: callback }).unsubscribe;
-		}, () => copilotkit.renderToolCalls, () => copilotkit.renderToolCalls);
+		const renderToolCalls = useToolCallRenderers();
 		const renderToolCall = (0, react.useCallback)(({ toolCall, toolMessage }) => {
 			const exactMatches = renderToolCalls.filter((rc) => rc.name === toolCall.function.name);
 			const renderConfig = exactMatches.find((rc) => rc.agentId === agentId) || exactMatches.find((rc) => !rc.agentId) || exactMatches[0] || renderToolCalls.find((rc) => rc.name === "*");
@@ -602,7 +615,7 @@ react_markdown = __toESM(react_markdown);
 
 //#endregion
 //#region package.json
-	var version = "1.79.1";
+	var version = "1.80.0";
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
@@ -806,7 +819,7 @@ react_markdown = __toESM(react_markdown);
 	* Fetches resource content on-demand via proxied MCP requests. The React shell
 	* owns the iframe; `bindMcpApp` owns the protocol.
 	*/
-	const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, message, agent }) {
+	const MCPAppsActivityRenderer = function MCPAppsActivityRenderer({ content, message, agent, allowSameOriginFallback }) {
 		const { copilotkit } = useCopilotKit();
 		const messageId = message?.id;
 		const containerRef = (0, react.useRef)(null);
@@ -856,6 +869,7 @@ react_markdown = __toESM(react_markdown);
 						getAgent: () => agentRef.current,
 						host: copilotkit,
 						messageId,
+						options: { allowSameOriginFallback },
 						hooks: {
 							onResource: (resource) => {
 								if (!mounted) return;
@@ -897,6 +911,7 @@ react_markdown = __toESM(react_markdown);
 			agent,
 			copilotkit,
 			messageId,
+			allowSameOriginFallback,
 			content.resourceUri,
 			content.serverHash,
 			content.serverId
@@ -2111,7 +2126,8 @@ react_markdown = __toESM(react_markdown);
 			name: def.name,
 			args: argsSchema,
 			render: def.render,
-			...def.agentId ? { agentId: def.agentId } : {}
+			...def.agentId ? { agentId: def.agentId } : {},
+			...def.group ? { group: true } : {}
 		};
 	}
 
@@ -2231,6 +2247,11 @@ react_markdown = __toESM(react_markdown);
 - Use CSS Grid or Flexbox for layout. Ensure the UI looks good at any width.
 - Minimal transitions (150ms) for hover/focus states only. No decorative animations.
 - Keep the UI focused and dense — avoid excessive padding. Use compact spacing (8–12px gaps, 10–14px padding in controls).`;
+	/** The MCP Apps renderer with `mcpApps.allowSameOriginFallback` applied. */
+	const SameOriginMCPAppsActivityRenderer = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MCPAppsActivityRenderer, {
+		...props,
+		allowSameOriginFallback: true
+	});
 	const DEFAULT_LEARNING = Object.freeze({});
 	function toLearningConfig(learning) {
 		if (learning === true) return DEFAULT_LEARNING;
@@ -2247,7 +2268,8 @@ react_markdown = __toESM(react_markdown);
 		}, [value, warningMessage]);
 		return value;
 	}
-	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, showIntelligenceIndicator = true, useSingleEndpoint, onError, a2ui, defaultThrottleMs, debug, learning }) => {
+	/** Provide a shared core instance and synchronize runtime, tool, and UI configuration. */
+	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, showIntelligenceIndicator = true, useSingleEndpoint, onError, a2ui, mcpApps, defaultThrottleMs, debug, learning }) => {
 		const learningConfig = (0, react.useMemo)(() => toLearningConfig(learning), [learning]);
 		const [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
 		const [inspectorVisible, setInspectorVisible] = (0, react.useState)(false);
@@ -2304,11 +2326,12 @@ react_markdown = __toESM(react_markdown);
 			const core = copilotkitRef.current;
 			return (0, _copilotkit_a2ui_renderer.filterCatalog)(rawCatalog, (name) => core ? core.isCatalogComponentEnabled(name) : true);
 		}, [rawCatalog, catalogToggleVersion]);
+		const mcpAppsAllowSameOrigin = mcpApps?.allowSameOriginFallback === true;
 		const builtInActivityRenderers = (0, react.useMemo)(() => {
 			const renderers = [{
 				activityType: _copilotkit_mcp_apps_renderer_activity.MCPAppsActivityType,
 				content: _copilotkit_mcp_apps_renderer_activity.MCPAppsActivityContentSchema,
-				render: MCPAppsActivityRenderer
+				render: mcpAppsAllowSameOrigin ? SameOriginMCPAppsActivityRenderer : MCPAppsActivityRenderer
 			}];
 			if (openGenUIActive) renderers.push({
 				activityType: OpenGenerativeUIActivityType,
@@ -2326,7 +2349,8 @@ react_markdown = __toESM(react_markdown);
 			a2uiActive,
 			openGenUIActive,
 			a2ui,
-			filteredCatalog
+			filteredCatalog,
+			mcpAppsAllowSameOrigin
 		]);
 		const allActivityRenderers = (0, react.useMemo)(() => {
 			return [...renderActivityMessagesList, ...builtInActivityRenderers];
@@ -2434,6 +2458,7 @@ react_markdown = __toESM(react_markdown);
 				description: _copilotkit_shared.GENERATE_SANDBOXED_UI_DESCRIPTION,
 				parameters: GenerateSandboxedUiArgsSchema,
 				handler: async () => "UI generated",
+				reconnectBehavior: "resume-pending",
 				followUp: true,
 				render: OpenGenerativeUIToolRenderer
 			}];
@@ -2798,11 +2823,85 @@ react_markdown = __toESM(react_markdown);
 	}
 
 //#endregion
-//#region src/v2/hooks/use-frontend-tool.tsx
+//#region src/v2/hooks/tool-registration.ts
+/**
+	* Deps comparison shared by `useFrontendTool` (and through it
+	* `useHumanInTheLoop` and `useComponent`) and `useRenderTool`. Not part of the
+	* public API.
+	*/
 	const EMPTY_DEPS = [];
+	function isPlainObject(value) {
+		const proto = Object.getPrototypeOf(value);
+		return proto === Object.prototype || proto === null;
+	}
+	/**
+	* Plain data (primitives, plain objects, arrays, dates) compares by value.
+	* Functions always compare equal: these hooks used to compare
+	* `JSON.stringify(deps)`, which turns every function into `null`, and a
+	* function that counted as changed would re-register on every render when it
+	* is written inline (and loop in a component that also reads
+	* `useRenderToolCall`). Everything else (class instances, maps, sets) compares
+	* by identity. A cycle inside plain data is safe: a pair already being
+	* compared counts as equal for that branch.
+	*/
+	function depEqual(a, b, seen) {
+		if (Object.is(a, b)) return true;
+		if (typeof a === "function" && typeof b === "function") return true;
+		if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+		if (a instanceof Date && b instanceof Date) return Object.is(a.getTime(), b.getTime());
+		const aIsArray = Array.isArray(a);
+		if (aIsArray !== Array.isArray(b)) return false;
+		if (!aIsArray && !(isPlainObject(a) && isPlainObject(b))) return false;
+		if (seen.get(a) === b) return true;
+		seen.set(a, b);
+		if (aIsArray) {
+			const left = a;
+			const right = b;
+			if (left.length !== right.length) return false;
+			for (let i = 0; i < left.length; i++) if (!depEqual(left[i], right[i], seen)) return false;
+			return true;
+		}
+		const left = a;
+		const right = b;
+		const leftKeys = Object.keys(left);
+		if (leftKeys.length !== Object.keys(right).length) return false;
+		for (const key of leftKeys) {
+			if (!Object.prototype.hasOwnProperty.call(right, key)) return false;
+			if (!depEqual(left[key], right[key], seen)) return false;
+		}
+		return true;
+	}
+	/** Whether two deps arrays are equal. A change in length is always a change. */
+	function depsEqual(prev, next) {
+		if (prev.length !== next.length) return false;
+		const seen = /* @__PURE__ */ new Map();
+		for (let i = 0; i < prev.length; i++) if (!depEqual(prev[i], next[i], seen)) return false;
+		return true;
+	}
+	/**
+	* Turns a caller's `deps` array into a number that changes exactly when the
+	* deps change, by the rules of {@link depsEqual}. Put the number, not the
+	* array, in the registration effect's dependency list: that keeps the list a
+	* constant length and never serializes a value.
+	*/
+	function useDepsVersion(deps) {
+		const next = deps ?? EMPTY_DEPS;
+		const ref = (0, react.useRef)({
+			deps: next,
+			version: 0
+		});
+		if (ref.current.deps !== next && !depsEqual(ref.current.deps, next)) ref.current = {
+			deps: next,
+			version: ref.current.version + 1
+		};
+		return ref.current.version;
+	}
+
+//#endregion
+//#region src/v2/hooks/use-frontend-tool.tsx
 	function useFrontendTool$1(tool, deps) {
 		const { copilotkit } = useCopilotKit();
-		const extraDeps = deps ?? EMPTY_DEPS;
+		const depsVersion = useDepsVersion(deps);
 		(0, react.useLayoutEffect)(() => {
 			const name = tool.name;
 			if (copilotkit.getTool({
@@ -2826,7 +2925,7 @@ react_markdown = __toESM(react_markdown);
 			tool.name,
 			tool.available,
 			copilotkit,
-			JSON.stringify(extraDeps),
+			depsVersion,
 			JSON.stringify(tool.webmcp ?? null)
 		]);
 	}
@@ -6693,6 +6792,14 @@ react_markdown = __toESM(react_markdown);
 	*
 	* This hooks enables you to dynamically generate UI elements and render them in the copilot chat. For more information, check out the [Generative UI](/guides/generative-ui) page.
 	*/
+	function toRenderToolCallArgs(action) {
+		const { render } = action;
+		if (typeof render === "string") return {
+			...action,
+			render: () => react.default.createElement(react.default.Fragment, null, render)
+		};
+		return action;
+	}
 	function getActionConfig(action) {
 		if (action.name === "*") {
 			const catchAll = action;
@@ -6728,14 +6835,18 @@ react_markdown = __toESM(react_markdown);
 			};
 			if (action.available === "frontend" || action.available === "disabled") return {
 				type: "render",
-				action
+				action: toRenderToolCallArgs(action)
 			};
 		}
 		if ("handler" in action) return {
 			type: "frontend",
 			action
 		};
-		throw new Error("Invalid action configuration");
+		if ("render" in action && action.render) return {
+			type: "render",
+			action: toRenderToolCallArgs(action)
+		};
+		throw new Error(`useCopilotAction(${JSON.stringify(action.name)}): this action has no handler and no render function. Add a handler to run the action in the browser, or a render function to render a tool call that the agent runs.`);
 	}
 	/**
 	* useCopilotAction is a legacy hook maintained for backwards compatibility.