@copilotkit/react-core 1.77.0 → 1.77.2

package/dist/index.umd.js

@@ -602,7 +602,7 @@ react_markdown = __toESM(react_markdown);
 
 //#endregion
 //#region package.json
-	var version = "1.77.0";
+	var version = "1.77.2";
 
 //#endregion
 //#region src/v2/components/CopilotKitInspector.tsx
@@ -2231,7 +2231,12 @@ 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).`;
-	const GENERATE_SANDBOXED_UI_DESCRIPTION = "Generate sandboxed UI. IMPORTANT: The generated code runs in a sandboxed iframe WITHOUT same-origin access. Do NOT use localStorage, sessionStorage, document.cookie, IndexedDB, or fetch/XMLHttpRequest to same-origin URLs. To communicate with the host application, use Websandbox.connection.remote.<functionName>(args) which returns a Promise.\n\nYou CAN use external libraries from CDNs by including <script> or <link> tags in the HTML <head> (e.g., Chart.js, D3, Three.js, x-data-spreadsheet, etc.). CDN resources load normally inside the sandbox.\n\nPARAMETER ORDER IS CRITICAL — generate parameters in exactly this order:\n1. initialHeight + placeholderMessages (shown to user while generating)\n2. css (all styles FIRST — the user sees a placeholder until CSS is complete)\n3. html (streams in live — the user watches the UI build as HTML is generated)\n4. jsFunctions (reusable helper functions)\n5. jsExpressions (applied one-by-one — the user sees each expression take effect)";
+	const DEFAULT_LEARNING = Object.freeze({});
+	function toLearningConfig(learning) {
+		if (learning === true) return DEFAULT_LEARNING;
+		if (learning === false) return void 0;
+		return learning;
+	}
 	function useStableArrayProp(prop, warningMessage, isMeaningfulChange) {
 		const empty = (0, react.useMemo)(() => [], []);
 		const value = prop ?? empty;
@@ -2242,6 +2247,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 [shouldRenderInspector, setShouldRenderInspector] = (0, react.useState)(false);
 		const [inspectorVisible, setInspectorVisible] = (0, react.useState)(false);
 		(0, react.useEffect)(() => {
@@ -2424,7 +2430,7 @@ react_markdown = __toESM(react_markdown);
 			if (!openGenUIActive) return [];
 			return [{
 				name: "generateSandboxedUi",
-				description: GENERATE_SANDBOXED_UI_DESCRIPTION,
+				description: _copilotkit_shared.GENERATE_SANDBOXED_UI_DESCRIPTION,
 				parameters: GenerateSandboxedUiArgsSchema,
 				handler: async () => "UI generated",
 				followUp: true,
@@ -2477,7 +2483,7 @@ react_markdown = __toESM(react_markdown);
 				renderActivityMessages: allActivityRenderers,
 				renderCustomMessages: renderCustomMessagesList,
 				debug,
-				learning
+				learning: learningConfig
 			});
 			if (defaultThrottleMs !== void 0) copilotkitRef.current.setDefaultThrottleMs(defaultThrottleMs);
 		}
@@ -2582,17 +2588,21 @@ react_markdown = __toESM(react_markdown);
 			useSingleEndpoint,
 			debug
 		]);
-		const learningEnabled = learning !== void 0;
-		const trajectoryId = learning?.trajectoryId;
-		const learningContainerIdsRef = (0, react.useRef)(learning?.learningContainerIds);
+		const learningEnabled = learningConfig !== void 0;
+		const generatesTrajectoryId = learning === true;
+		const suppliedTrajectoryId = learningConfig?.trajectoryId;
+		const learningContainerIdsRef = (0, react.useRef)(learningConfig?.learningContainerIds);
+		const generatedTrajectoryIdRef = (0, react.useRef)(void 0);
 		(0, react.useEffect)(() => {
-			copilotkit.setLearningConfig(learning);
-			learningContainerIdsRef.current = learning?.learningContainerIds;
-			if (learning?.sink === void 0 && learning?.trajectoryId === void 0 && learning?.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, learning]);
+			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]);
 		(0, react.useEffect)(() => {
+			if (!generatesTrajectoryId) generatedTrajectoryIdRef.current = void 0;
 			if (!learningEnabled) return;
 			let disposed = false;
+			const trajectoryId = generatesTrajectoryId ? generatedTrajectoryIdRef.current ?? (generatedTrajectoryIdRef.current = (0, _copilotkit_shared.randomUUID)()) : suppliedTrajectoryId;
 			if (trajectoryId !== void 0) copilotkit.startTrajectory({
 				trajectoryId,
 				learningContainerIds: learningContainerIdsRef.current
@@ -2606,7 +2616,8 @@ react_markdown = __toESM(react_markdown);
 		}, [
 			copilotkit,
 			learningEnabled,
-			trajectoryId
+			generatesTrajectoryId,
+			suppliedTrajectoryId
 		]);
 		const didMountRef = (0, react.useRef)(false);
 		(0, react.useEffect)(() => {
@@ -7110,7 +7121,7 @@ react_markdown = __toESM(react_markdown);
 	*   running,  // A boolean indicating if the agent is currently running.
 	*   start,    // A function to start the agent.
 	*   stop,     // A function to stop the agent.
-	*   run,      // A function to (re-)run the agent. Maps to the v2 agent's `runAgent()`.
+	*   run,      // A function to (re-)run the agent through the v2 core (`copilotkit.runAgent`).
 	* } = agent;
 	* ```
 	*
@@ -7221,6 +7232,17 @@ react_markdown = __toESM(react_markdown);
 			handleStateUpdate,
 			hasStateValues
 		]);
+		const runAgent = (0, react.useCallback)(async (parameters) => {
+			if (!agent) return void 0;
+			return copilotkit.runAgent({
+				agent,
+				forwardedProps: parameters?.forwardedProps,
+				runId: parameters?.runId
+			});
+		}, [agent, copilotkit]);
+		const stopAgent = (0, react.useCallback)(() => {
+			if (agent) copilotkit.stopAgent({ agent });
+		}, [agent, copilotkit]);
 		return (0, react.useMemo)(() => {
 			if (!agent) {
 				const noop = () => {};
@@ -7245,15 +7267,14 @@ react_markdown = __toESM(react_markdown);
 				running: agent.isRunning,
 				state: agent.state,
 				setState: handleStateUpdate,
-				start: agent.runAgent,
-				stop: agent.abortRun,
-				run: agent.runAgent
+				start: runAgent,
+				stop: stopAgent,
+				run: runAgent
 			};
 		}, [
 			agent?.state,
-			agent?.runAgent,
-			agent?.abortRun,
-			agent?.runAgent,
+			runAgent,
+			stopAgent,
 			agent?.threadId,
 			agent?.isRunning,
 			agent?.agentId,