@copilotkit/react-core 1.77.2 → 1.79.0

package/dist/{copilotkit-D7_J5Hs_.cjs → copilotkit-DjrKQjfL.cjs}

@@ -1655,7 +1655,7 @@ function useRenderToolCall() {
 
 //#endregion
 //#region package.json
-var version = "1.77.2";
+var version = "1.79.0";
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
@@ -3415,8 +3415,9 @@ const DEFAULT_DESIGN_SKILL = `When generating UI with generateSandboxedUi, follo
 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)(() => [], []);
@@ -3428,7 +3429,7 @@ function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 	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)(() => {
@@ -3521,15 +3522,15 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	(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);
@@ -3654,7 +3655,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 			runtimeUrl: chatApiEndpoint,
 			deferInitialConnection: true,
 			runtimeTransport: useSingleEndpoint === true ? "single" : useSingleEndpoint === false ? "rest" : "auto",
-			headers: mergedHeaders,
+			headers: headersSource,
 			credentials,
 			messageFilter,
 			properties,
@@ -3749,7 +3750,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	(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,
@@ -3761,7 +3762,7 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	}, [
 		copilotkit,
 		chatApiEndpoint,
-		mergedHeaders,
+		headersSource,
 		credentials,
 		properties,
 		a2uiCatalogProvided,
@@ -3770,15 +3771,25 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 		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;
@@ -3873,17 +3884,17 @@ const CopilotKitProvider = ({ children, runtimeUrl, headers: headersProp = EMPTY
 	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
@@ -5375,9 +5386,7 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 	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;
@@ -5442,7 +5451,6 @@ function useThreads$1({ agentId, includeArchived, limit, enabled = true }) {
 		}
 		const context = {
 			runtimeUrl: copilotkit.runtimeUrl,
-			headers: { ...copilotkit.headers },
 			wsUrl: copilotkit.intelligence?.wsUrl,
 			agentId,
 			includeArchived,
@@ -5570,7 +5578,9 @@ function useMemories() {
 *
 * 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)
@@ -5662,7 +5672,7 @@ function useLearnFromUserAction() {
 		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,
@@ -5990,16 +6000,13 @@ function useLearningContainers({ threadId, learningContainers }) {
 	/** 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
@@ -6016,7 +6023,7 @@ function useLearningContainers({ threadId, learningContainers }) {
 			recordAnnotation({
 				fetch: copilotkit.ɵruntimeFetch,
 				runtimeUrl,
-				headers,
+				headers: {},
 				type: "set_learning_containers",
 				payload: { containers },
 				threadId
@@ -6040,11 +6047,10 @@ function useLearningContainers({ threadId, learningContainers }) {
 		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
@@ -8850,7 +8856,7 @@ async function transcribeAudio(core, audioBlob, filename = "recording.webm") {
 		message: "Runtime URL is not configured",
 		retryable: false
 	});
-	const headers = { ...core.headers };
+	const headers = { ...await core.resolveHeaders() };
 	let response;
 	try {
 		if (core.runtimeTransport === "single") {
@@ -9262,7 +9268,6 @@ function CopilotChat({ agentId, threadId, labels, inspectorTools, chatView, isMo
 			threadStore.start();
 			const context = copilotkit.runtimeUrl ? {
 				runtimeUrl: copilotkit.runtimeUrl,
-				headers: { ...copilotkit.headers },
 				wsUrl: copilotkit.intelligence?.wsUrl,
 				agentId: resolvedAgentId
 			} : null;
@@ -9358,7 +9363,7 @@ function CopilotChat({ agentId, threadId, labels, inspectorTools, chatView, isMo
 		hasNativeIntelligenceRunActivity,
 		copilotkit.runtimeConnectionStatus,
 		copilotkit.runtimeUrl,
-		copilotkit.headers,
+		copilotkit.ɵheadersGeneration,
 		copilotkit.intelligence?.wsUrl,
 		copilotkit.threadEndpoints?.realtimeMetadata,
 		standaloneRunActivityStore,
@@ -12349,6 +12354,16 @@ function CopilotListeners() {
 
 //#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;
@@ -12428,6 +12443,13 @@ function CopilotKitInternal(cpkProps) {
 	* 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)({});
@@ -12495,19 +12517,46 @@ function CopilotKitInternal(cpkProps) {
 			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,
@@ -12515,27 +12564,6 @@ function CopilotKitInternal(cpkProps) {
 		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) => ({
@@ -13366,4 +13394,4 @@ Object.defineProperty(exports, 'useToast', {
     return useToast;
   }
 });
-//# sourceMappingURL=copilotkit-D7_J5Hs_.cjs.map
+//# sourceMappingURL=copilotkit-DjrKQjfL.cjs.map