@copilotkit/react-core 1.77.2 → 1.79.0

package/dist/index.cjs

@@ -1,7 +1,7 @@
 "use client";
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_copilotkit = require('./copilotkit-D7_J5Hs_.cjs');
+const require_copilotkit = require('./copilotkit-DjrKQjfL.cjs');
 let react = require("react");
 react = require_copilotkit.__toESM(react);
 let _copilotkit_core = require("@copilotkit/core");

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Af as Tree, Bf as FrontendActionAvailability, Cf as CrewsResponseStatus, Df as CopilotChatSuggestionConfiguration, Ef as CrewsToolStateItem, Ff as ActionRenderPropsWait, If as CatchAllActionRenderProps, Lf as CatchAllActionRenderPropsWait, Mf as ActionRenderProps, Nf as ActionRenderPropsNoArgs, Of as SystemMessageFunction, Pf as ActionRenderPropsNoArgsWait, Rf as CatchAllFrontendAction, Sf as CrewsResponse, Tf as CrewsTaskStateItem, Vf as RenderFunctionStatus, X as useAgent, _f as LangGraphInterruptRender, bf as QueuedInterruptEvent, cf as CoagentInChatRenderFunction, df as CopilotContextParams, ff as useCopilotContext, gf as LangGraphInterruptActionSetterArgs, hf as LangGraphInterruptActionSetter, jf as TreeNode, kf as DocumentPointer, lf as CopilotApiConfig, mf as LangGraphInterruptAction, n as defaultCopilotContextCategories, pf as CoAgentStateRender, r as CopilotKitProps, t as CopilotKit, uf as CopilotContext, vf as LangGraphInterruptRenderHandlerProps, wf as CrewsStateItem, xf as CrewsAgentState, xt as useRenderToolCall$1, yf as LangGraphInterruptRenderProps, zf as FrontendAction } from "./copilotkit-BQBy80gH.cjs";
+import { Af as CopilotChatSuggestionConfiguration, Bf as CatchAllActionRenderPropsWait, Cf as QueuedInterruptEvent, Df as CrewsStateItem, Ef as CrewsResponseStatus, Ff as ActionRenderProps, Hf as FrontendAction, If as ActionRenderPropsNoArgs, Lf as ActionRenderPropsNoArgsWait, Mf as DocumentPointer, Nf as Tree, Of as CrewsTaskStateItem, Pf as TreeNode, Rf as ActionRenderPropsWait, Sf as LangGraphInterruptRenderProps, Tf as CrewsResponse, Uf as FrontendActionAvailability, Vf as CatchAllFrontendAction, Wf as RenderFunctionStatus, X as useAgent, _f as LangGraphInterruptAction, bf as LangGraphInterruptRender, df as CoagentInChatRenderFunction, ff as CopilotApiConfig, gf as CoAgentStateRender, hf as useCopilotContext, jf as SystemMessageFunction, kf as CrewsToolStateItem, mf as CopilotContextParams, n as defaultCopilotContextCategories, pf as CopilotContext, r as CopilotKitProps, t as CopilotKit, vf as LangGraphInterruptActionSetter, wf as CrewsAgentState, xf as LangGraphInterruptRenderHandlerProps, xt as useRenderToolCall$1, yf as LangGraphInterruptActionSetterArgs, zf as CatchAllActionRenderProps } from "./copilotkit-2Fbb5_CC.cjs";
 import "./v2/index.cjs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { CopilotRuntimeClient, CopilotRuntimeClientOptions, ForwardedParametersInput, Message } from "@copilotkit/runtime-client-gql";

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Af as Tree, Bf as FrontendActionAvailability, Cf as CrewsResponseStatus, Df as CopilotChatSuggestionConfiguration, Ef as CrewsToolStateItem, Ff as ActionRenderPropsWait, If as CatchAllActionRenderProps, Lf as CatchAllActionRenderPropsWait, Mf as ActionRenderProps, Nf as ActionRenderPropsNoArgs, Of as SystemMessageFunction, Pf as ActionRenderPropsNoArgsWait, Rf as CatchAllFrontendAction, Sf as CrewsResponse, Tf as CrewsTaskStateItem, Vf as RenderFunctionStatus, X as useAgent, _f as LangGraphInterruptRender, bf as QueuedInterruptEvent, cf as CoagentInChatRenderFunction, df as CopilotContextParams, ff as useCopilotContext, gf as LangGraphInterruptActionSetterArgs, hf as LangGraphInterruptActionSetter, jf as TreeNode, kf as DocumentPointer, lf as CopilotApiConfig, mf as LangGraphInterruptAction, n as defaultCopilotContextCategories, pf as CoAgentStateRender, r as CopilotKitProps, t as CopilotKit, uf as CopilotContext, vf as LangGraphInterruptRenderHandlerProps, wf as CrewsStateItem, xf as CrewsAgentState, xt as useRenderToolCall$1, yf as LangGraphInterruptRenderProps, zf as FrontendAction } from "./copilotkit-DkLb1sf9.mjs";
+import { Af as CopilotChatSuggestionConfiguration, Bf as CatchAllActionRenderPropsWait, Cf as QueuedInterruptEvent, Df as CrewsStateItem, Ef as CrewsResponseStatus, Ff as ActionRenderProps, Hf as FrontendAction, If as ActionRenderPropsNoArgs, Lf as ActionRenderPropsNoArgsWait, Mf as DocumentPointer, Nf as Tree, Of as CrewsTaskStateItem, Pf as TreeNode, Rf as ActionRenderPropsWait, Sf as LangGraphInterruptRenderProps, Tf as CrewsResponse, Uf as FrontendActionAvailability, Vf as CatchAllFrontendAction, Wf as RenderFunctionStatus, X as useAgent, _f as LangGraphInterruptAction, bf as LangGraphInterruptRender, df as CoagentInChatRenderFunction, ff as CopilotApiConfig, gf as CoAgentStateRender, hf as useCopilotContext, jf as SystemMessageFunction, kf as CrewsToolStateItem, mf as CopilotContextParams, n as defaultCopilotContextCategories, pf as CopilotContext, r as CopilotKitProps, t as CopilotKit, vf as LangGraphInterruptActionSetter, wf as CrewsAgentState, xf as LangGraphInterruptRenderHandlerProps, xt as useRenderToolCall$1, yf as LangGraphInterruptActionSetterArgs, zf as CatchAllActionRenderProps } from "./copilotkit-DFMMPW2I.mjs";
 import "./v2/index.mjs";
 import React, { ReactNode, RefObject, SetStateAction } from "react";
 import { StaticSuggestionsConfig, Suggestion } from "@copilotkit/core";

package/dist/index.mjs

@@ -1,6 +1,6 @@
 "use client";
 
-import { $ as useConfigureSuggestions, It as useCopilotChatConfiguration, Q as INTERRUPT_EVENT_NAME, Z as useInterrupt, _t as defineToolCallRenderer, a as ThreadsProvider, at as useHumanInTheLoop$1, c as CoAgentStateRendersProvider, d as shouldShowDevConsole, et as useSuggestions, f as useToast, ft as useRenderCustomMessages, g as useCopilotContext, h as CopilotContext, i as ThreadsContext, it as useAgent, jt as useRenderToolCall$1, l as useCoAgentStateRenders, m as useCopilotMessagesContext, mt as useCopilotKit, n as defaultCopilotContextCategories, o as useThreads, p as CopilotMessagesContext, r as CoAgentStateRenderBridge, s as CoAgentStateRendersContext, t as CopilotKit, u as useAsyncCallback, ut as useFrontendTool$1 } from "./copilotkit-BI7KSQQw.mjs";
+import { $ as useConfigureSuggestions, It as useCopilotChatConfiguration, Q as INTERRUPT_EVENT_NAME, Z as useInterrupt, _t as defineToolCallRenderer, a as ThreadsProvider, at as useHumanInTheLoop$1, c as CoAgentStateRendersProvider, d as shouldShowDevConsole, et as useSuggestions, f as useToast, ft as useRenderCustomMessages, g as useCopilotContext, h as CopilotContext, i as ThreadsContext, it as useAgent, jt as useRenderToolCall$1, l as useCoAgentStateRenders, m as useCopilotMessagesContext, mt as useCopilotKit, n as defaultCopilotContextCategories, o as useThreads, p as CopilotMessagesContext, r as CoAgentStateRenderBridge, s as CoAgentStateRendersContext, t as CopilotKit, u as useAsyncCallback, ut as useFrontendTool$1 } from "./copilotkit-DQvE96lZ.mjs";
 import React, { Fragment, createElement, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { CopilotKitCoreRuntimeConnectionStatus, ToolCallStatus, ɵisHttpAgent } from "@copilotkit/core";
 import { AGUIConnectNotImplementedError } from "@ag-ui/client";

package/dist/index.umd.js

@@ -602,7 +602,7 @@ react_markdown = __toESM(react_markdown);
 
 //#endregion
 //#region package.json
-	var version = "1.77.2";
+	var version = "1.79.0";
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
@@ -2234,8 +2234,9 @@ react_markdown = __toESM(react_markdown);
 	const DEFAULT_LEARNING = Object.freeze({});
 	function toLearningConfig(learning) {
 		if (learning === true) return DEFAULT_LEARNING;
-		if (learning === false) return void 0;
-		return learning;
+		if (learning === false || learning === void 0) return void 0;
+		const { autoStart: _autoStart, ...config } = learning;
+		return config;
 	}
 	function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 		const empty = (0, react.useMemo)(() => [], []);
@@ -2247,7 +2248,7 @@ react_markdown = __toESM(react_markdown);
 		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 }) => {
-		const learningConfig = toLearningConfig(learning);
+		const learningConfig = (0, react.useMemo)(() => toLearningConfig(learning), [learning]);
 		const [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
 		const [inspectorVisible, setInspectorVisible] = (0, react.useState)(false);
 		(0, react.useEffect)(() => {
@@ -2340,15 +2341,15 @@ react_markdown = __toESM(react_markdown);
 		(0, react.useEffect)(() => {
 			if (hasSelfManagedAgents && !resolvedPublicKey) console.warn("[CopilotKit] `selfManagedAgents` is part of CopilotKit's Enterprise Intelligence tier. Provide a `publicLicenseKey` for production use — contact the CopilotKit team about licensing.");
 		}, [hasSelfManagedAgents, resolvedPublicKey]);
-		const headers = typeof headersProp === "function" ? headersProp() : headersProp;
-		const mergedHeaders = (0, react.useMemo)(() => {
-			if (!resolvedPublicKey) return headers;
-			if (headers[HEADER_NAME]) return headers;
-			return {
-				...headers,
-				[HEADER_NAME]: resolvedPublicKey
-			};
-		}, [headers, resolvedPublicKey]);
+		const headersRef = (0, react.useRef)(headersProp);
+		headersRef.current = headersProp;
+		const isHeadersBuilder = typeof headersProp === "function";
+		const stableHeadersBuilder = (0, react.useCallback)(() => {
+			const current = headersRef.current;
+			return typeof current === "function" ? current() : current;
+		}, []);
+		const headersInput = isHeadersBuilder ? stableHeadersBuilder : headersProp;
+		const headersSource = (0, react.useMemo)(() => (0, _copilotkit_core.ɵwithHeaderDefaults)(headersInput, resolvedPublicKey ? { [HEADER_NAME]: resolvedPublicKey } : {}), [headersInput, resolvedPublicKey]);
 		if (!runtimeUrl && !resolvedPublicKey && !hasLocalAgents) {
 			const message = "Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'";
 			if (process.env.NODE_ENV === "production") throw new Error(message);
@@ -2473,7 +2474,7 @@ react_markdown = __toESM(react_markdown);
 				runtimeUrl: chatApiEndpoint,
 				deferInitialConnection: true,
 				runtimeTransport: useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto",
-				headers: mergedHeaders,
+				headers: headersSource,
 				credentials,
 				messageFilter,
 				properties,
@@ -2568,7 +2569,7 @@ react_markdown = __toESM(react_markdown);
 		(0, react.useEffect)(() => {
 			copilotkit.setRuntimeUrl(chatApiEndpoint);
 			copilotkit.setRuntimeTransport(useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto");
-			copilotkit.setHeaders(mergedHeaders);
+			copilotkit.setHeaders(headersSource);
 			copilotkit.setCredentials(credentials);
 			copilotkit.setProperties(a2uiCatalogProvided ? {
 				...properties,
@@ -2580,7 +2581,7 @@ react_markdown = __toESM(react_markdown);
 		}, [
 			copilotkit,
 			chatApiEndpoint,
-			mergedHeaders,
+			headersSource,
 			credentials,
 			properties,
 			a2uiCatalogProvided,
@@ -2589,15 +2590,25 @@ react_markdown = __toESM(react_markdown);
 			debug
 		]);
 		const learningEnabled = learningConfig !== void 0;
-		const generatesTrajectoryId = learning === true;
-		const suppliedTrajectoryId = learningConfig?.trajectoryId;
+		const autoStart = learningEnabled && (typeof learning !== "object" || learning.autoStart !== false);
+		const suppliedTrajectoryId = autoStart ? learningConfig?.trajectoryId : void 0;
+		const generatesTrajectoryId = autoStart && suppliedTrajectoryId === void 0;
 		const learningContainerIdsRef = (0, react.useRef)(learningConfig?.learningContainerIds);
 		const generatedTrajectoryIdRef = (0, react.useRef)(void 0);
 		(0, react.useEffect)(() => {
 			copilotkit.setLearningConfig(learningConfig);
 			learningContainerIdsRef.current = learningConfig?.learningContainerIds;
-			if (learningConfig?.sink === void 0 && learningConfig?.trajectoryId === void 0 && learningConfig?.learningContainerIds !== void 0) console.warn("[CopilotKit] learningContainerIds is supported only with a custom sink. Authenticated Trajectory capture does not assign Learning Containers; remove learningContainerIds from the capture options.");
-		}, [copilotkit, learningConfig]);
+			if (learningConfig?.sink === void 0 && !autoStart && learningConfig?.learningContainerIds !== void 0) console.warn("[CopilotKit] learningContainerIds is supported only with a custom sink. Authenticated Trajectory capture does not assign Learning Containers; remove learningContainerIds from the capture options.");
+		}, [
+			copilotkit,
+			learningConfig,
+			autoStart
+		]);
+		const ignoresTrajectoryId = !autoStart && learningConfig?.trajectoryId !== void 0;
+		(0, react.useEffect)(() => {
+			if (!ignoresTrajectoryId) return;
+			console.warn("[CopilotKit] learning.trajectoryId is ignored when autoStart is false; pass the ID to startTrajectory() instead.");
+		}, [ignoresTrajectoryId]);
 		(0, react.useEffect)(() => {
 			if (!generatesTrajectoryId) generatedTrajectoryIdRef.current = void 0;
 			if (!learningEnabled) return;
@@ -2692,17 +2703,17 @@ react_markdown = __toESM(react_markdown);
 		const hasNonReadyRuntimeEntitlement = runtimeEntitlements !== void 0 && runtimeEntitlements.status !== "ready";
 		const hasLegacyRuntimeEntitlementFallback = runtimeLicenseStatus === "valid" || runtimeLicenseStatus === "expiring";
 		const runtimeEntitlementRetryInProgress = retryableRuntimeEntitlementFailure && runtimeEntitlementRetryPending && !hasLegacyRuntimeEntitlementFallback;
-		const runtimeEntitlementFailureSettled = hasNonReadyRuntimeEntitlement && !runtimeEntitlementRetryInProgress && !hasLegacyRuntimeEntitlementFallback;
+		const terminalRuntimeEntitlementFailure = hasNonReadyRuntimeEntitlement && !retryableRuntimeEntitlementFailure && !hasLegacyRuntimeEntitlementFallback;
 		const licenseContextValue = (0, react.useMemo)(() => {
 			const runtimeLicenseContext = (0, _copilotkit_shared.createLicenseContextValue)(runtimeEntitlementRetryInProgress ? void 0 : runtimeLicenseStatus, runtimeEntitlements);
-			if (!runtimeEntitlementFailureSettled) return runtimeLicenseContext;
+			if (!terminalRuntimeEntitlementFailure) return runtimeLicenseContext;
 			return {
 				...runtimeLicenseContext,
 				checkFeature: () => false,
 				getLimit: () => null
 			};
 		}, [
-			runtimeEntitlementFailureSettled,
+			terminalRuntimeEntitlementFailure,
 			runtimeEntitlementRetryInProgress,
 			runtimeEntitlements,
 			runtimeLicenseStatus
@@ -5270,6 +5281,16 @@ react_markdown = __toESM(react_markdown);
 
 //#endregion
 //#region src/v1-deprecated/components/copilot-provider/copilotkit.tsx
+/**
+	* Drops `null`/`undefined` entries so a `CopilotKitHeadersSource` record (or
+	* a builder's resolved record) matches `CopilotApiConfig.headers`'s
+	* `Record<string, string>` shape. Mirrors core's own (internal-only)
+	* `normalizeHeaders`.
+	*/
+	function normalizeV1Headers(headers) {
+		if (!headers) return {};
+		return Object.fromEntries(Object.entries(headers).filter((entry) => entry[1] != null));
+	}
 	function CopilotKit({ children, ...props }) {
 		const enabled = shouldShowDevConsole(props.showDevConsole);
 		const publicApiKey = props.publicApiKey || props.publicLicenseKey;
@@ -5349,6 +5370,13 @@ react_markdown = __toESM(react_markdown);
 		* This will throw an error if the props are invalid.
 		*/
 		validateProps(cpkProps);
+		const headersPropRef = (0, react.useRef)(props.headers);
+		headersPropRef.current = props.headers;
+		const headersBuilderStateRef = (0, react.useRef)({
+			fn: void 0,
+			isAsync: false
+		});
+		const warnedAsyncHeadersRef = (0, react.useRef)(false);
 		const publicApiKey = props.publicLicenseKey || props.publicApiKey;
 		const chatApiEndpoint = props.runtimeUrl || _copilotkit_shared.COPILOT_CLOUD_CHAT_URL;
 		const [actions, setActions] = (0, react.useState)({});
@@ -5416,19 +5444,46 @@ react_markdown = __toESM(react_markdown);
 				validTopics: props.guardrails_c?.validTopics || [],
 				invalidTopics: props.guardrails_c?.invalidTopics || []
 			} } } };
-			return {
+			const config = {
 				publicApiKey,
 				...cloud ? { cloud } : {},
 				chatApiEndpoint,
-				headers: typeof props.headers === "function" ? props.headers() : props.headers || {},
 				properties: props.properties || {},
 				transcribeAudioUrl: props.transcribeAudioUrl,
 				textToSpeechUrl: props.textToSpeechUrl,
 				credentials: props.credentials
 			};
+			Object.defineProperty(config, "headers", {
+				enumerable: true,
+				configurable: true,
+				get() {
+					const source = headersPropRef.current;
+					if (typeof source !== "function") return normalizeV1Headers(source);
+					const state = headersBuilderStateRef.current;
+					if (state.fn === source && state.isAsync) return {};
+					const result = source();
+					if (typeof result === "object" && result !== null && typeof result.then === "function") {
+						headersBuilderStateRef.current = {
+							fn: source,
+							isAsync: true
+						};
+						result.then(void 0, () => {});
+						if (process.env.NODE_ENV !== "production" && !warnedAsyncHeadersRef.current) {
+							warnedAsyncHeadersRef.current = true;
+							console.warn("[CopilotKit] An async `headers` builder is not supported by the v1 CopilotTask / GraphQL path; its headers are not sent there.");
+						}
+						return {};
+					}
+					headersBuilderStateRef.current = {
+						fn: source,
+						isAsync: false
+					};
+					return normalizeV1Headers(result);
+				}
+			});
+			return config;
 		}, [
 			publicApiKey,
-			props.headers,
 			props.properties,
 			props.transcribeAudioUrl,
 			props.textToSpeechUrl,
@@ -5436,27 +5491,6 @@ react_markdown = __toESM(react_markdown);
 			props.cloudRestrictToTopic,
 			props.guardrails_c
 		]);
-		(0, react.useMemo)(() => {
-			const authHeaders = Object.values(authStates || {}).reduce((acc, state) => {
-				if (state.status === "authenticated" && state.authHeaders) return {
-					...acc,
-					...Object.entries(state.authHeaders).reduce((headers, [key, value]) => ({
-						...headers,
-						[key.startsWith("X-Custom-") ? key : `X-Custom-${key}`]: value
-					}), {})
-				};
-				return acc;
-			}, {});
-			return {
-				...copilotApiConfig.headers,
-				...copilotApiConfig.publicApiKey ? { [_copilotkit_shared.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: copilotApiConfig.publicApiKey } : {},
-				...authHeaders
-			};
-		}, [
-			copilotApiConfig.headers,
-			copilotApiConfig.publicApiKey,
-			authStates
-		]);
 		const [internalErrorHandlers, _setInternalErrorHandler] = (0, react.useState)({});
 		const setInternalErrorHandler = (0, react.useCallback)((handler) => {
 			_setInternalErrorHandler((prev) => ({