@copilotkit/react-core 1.77.2 → 1.79.0

package/dist/v2/index.umd.js

@@ -1766,7 +1766,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 
 //#endregion
 //#region package.json
-	var version = "1.77.2";
+	var version = "1.79.0";
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
@@ -3430,8 +3430,9 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 	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)(() => [], []);
@@ -3443,7 +3444,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		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)(() => {
@@ -3536,15 +3537,15 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		(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);
@@ -3669,7 +3670,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 				runtimeUrl: chatApiEndpoint,
 				deferInitialConnection: true,
 				runtimeTransport: useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto",
-				headers: mergedHeaders,
+				headers: headersSource,
 				credentials,
 				messageFilter,
 				properties,
@@ -3764,7 +3765,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		(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,
@@ -3776,7 +3777,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		}, [
 			copilotkit,
 			chatApiEndpoint,
-			mergedHeaders,
+			headersSource,
 			credentials,
 			properties,
 			a2uiCatalogProvided,
@@ -3785,15 +3786,25 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			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;
@@ -3888,17 +3899,17 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		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
@@ -5390,9 +5401,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		const hasMoreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectHasNextPage);
 		const isFetchingMoreThreads = useThreadStoreSelector(store, _copilotkit_core.ɵselectIsFetchingNextPage);
 		const isMutating = useThreadStoreSelector(store, _copilotkit_core.ɵselectIsMutating);
-		const headersKey = (0, react.useMemo)(() => {
-			return JSON.stringify(Object.entries(copilotkit.headers ?? {}).sort(([left], [right]) => left.localeCompare(right)));
-		}, [copilotkit.headers]);
+		const headersKey = copilotkit.ɵheadersGeneration;
 		const runtimeStatus = copilotkit.runtimeConnectionStatus;
 		const threadListEndpointSupported = copilotkit.threadEndpoints?.list !== false;
 		const threadMutationsSupported = copilotkit.threadEndpoints?.mutations !== false;
@@ -5457,7 +5466,6 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			}
 			const context = {
 				runtimeUrl: copilotkit.runtimeUrl,
-				headers: { ...copilotkit.headers },
 				wsUrl: copilotkit.intelligence?.wsUrl,
 				agentId,
 				includeArchived,
@@ -5585,7 +5593,9 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 	*
 	* The function uses the same transport as `useLearnFromUserAction`:
 	* - `runtimeUrl` from `copilotkit.runtimeUrl` (BFF proxies to the platform)
-	* - `headers` from `copilotkit.headers` (customer auth forwarded to BFF)
+	* - `fetch: copilotkit.ɵruntimeFetch`, which adds the current core headers at
+	*   send time (#1937); `headers` here is only for extra request-specific
+	*   headers on top of that
 	* - `clientEventId` auto-generated via `randomUUID()` when omitted
 	* - `userId` is resolved server-side by the runtime; the client never sends it
 	* - Errors propagate to the caller (fire-and-propagate, not fire-and-forget)
@@ -5677,7 +5687,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			return recordAnnotation({
 				fetch: copilotkit.ɵruntimeFetch,
 				runtimeUrl,
-				headers: copilotkit.headers ?? {},
+				headers: {},
 				type: "user_action",
 				payload: Object.keys(payload).length > 0 ? payload : void 0,
 				threadId: input.threadId,
@@ -6005,16 +6015,13 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		/** Guards the missing-runtimeUrl warning so it fires at most once per hook instance. */
 		const warnedMissingUrlRef = (0, react.useRef)(false);
 		const runtimeUrlRef = (0, react.useRef)(copilotkit.runtimeUrl);
-		const headersRef = (0, react.useRef)(copilotkit.headers ?? {});
 		const runtimeFetchRef = (0, react.useRef)(copilotkit.ɵruntimeFetch);
 		runtimeUrlRef.current = copilotkit.runtimeUrl;
-		headersRef.current = copilotkit.headers ?? {};
 		runtimeFetchRef.current = copilotkit.ɵruntimeFetch;
 		const key = JSON.stringify(learningContainers);
 		const defaultKey = JSON.stringify(DEFAULT_CONTAINERS);
 		(0, react.useEffect)(() => {
 			const runtimeUrl = copilotkit.runtimeUrl;
-			const headers = copilotkit.headers ?? {};
 			/**
 			* Fire-and-forget emit; errors must not surface in render.
 			* Failures are logged as warnings so they are diagnosable without
@@ -6031,7 +6038,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 				recordAnnotation({
 					fetch: copilotkit.ɵruntimeFetch,
 					runtimeUrl,
-					headers,
+					headers: {},
 					type: "set_learning_containers",
 					payload: { containers },
 					threadId
@@ -6055,11 +6062,10 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			const capturedThreadId = threadId;
 			return () => {
 				const capturedRuntimeUrl = runtimeUrlRef.current;
-				const capturedHeaders = headersRef.current;
 				if (capturedRuntimeUrl) recordAnnotation({
 					fetch: runtimeFetchRef.current,
 					runtimeUrl: capturedRuntimeUrl,
-					headers: capturedHeaders,
+					headers: {},
 					type: "set_learning_containers",
 					payload: { containers: DEFAULT_CONTAINERS },
 					threadId: capturedThreadId
@@ -8865,7 +8871,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			message: "Runtime URL is not configured",
 			retryable: false
 		});
-		const headers = { ...core.headers };
+		const headers = { ...await core.resolveHeaders() };
 		let response;
 		try {
 			if (core.runtimeTransport === "single") {
@@ -9277,7 +9283,6 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 				threadStore.start();
 				const context = copilotkit.runtimeUrl ? {
 					runtimeUrl: copilotkit.runtimeUrl,
-					headers: { ...copilotkit.headers },
 					wsUrl: copilotkit.intelligence?.wsUrl,
 					agentId: resolvedAgentId
 				} : null;
@@ -9373,7 +9378,7 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			hasNativeIntelligenceRunActivity,
 			copilotkit.runtimeConnectionStatus,
 			copilotkit.runtimeUrl,
-			copilotkit.headers,
+			copilotkit.ɵheadersGeneration,
 			copilotkit.intelligence?.wsUrl,
 			copilotkit.threadEndpoints?.realtimeMetadata,
 			standaloneRunActivityStore,
@@ -12250,6 +12255,16 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 
 //#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;
@@ -12329,6 +12344,13 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 		* 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)({});
@@ -12396,19 +12418,46 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 				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,
@@ -12416,27 +12465,6 @@ _radix_ui_react_dropdown_menu = __toESM(_radix_ui_react_dropdown_menu);
 			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) => ({
@@ -12950,6 +12978,12 @@ Object.defineProperty(exports, 'CopilotKitCoreRuntimeConnectionStatus', {
     return _copilotkit_core.CopilotKitCoreRuntimeConnectionStatus;
   }
 });
+Object.defineProperty(exports, 'CopilotKitHeaderResolutionError', {
+  enumerable: true,
+  get: function () {
+    return _copilotkit_core.CopilotKitHeaderResolutionError;
+  }
+});
 exports.CopilotKitInspector = CopilotKitInspector;
 exports.CopilotKitProvider = CopilotKitProvider;
 Object.defineProperty(exports, 'CopilotModalHeader', {
@@ -14289,5 +14323,11 @@ Object.defineProperty(exports, 'ɵthreadAdapterEvents', {
     return _copilotkit_core.ɵthreadAdapterEvents;
   }
 });
+Object.defineProperty(exports, 'ɵwithHeaderDefaults', {
+  enumerable: true,
+  get: function () {
+    return _copilotkit_core.ɵwithHeaderDefaults;
+  }
+});
 });
 //# sourceMappingURL=index.umd.js.map