@copilotkit/react-core 1.67.1 → 1.68.0

package/dist/index.cjs

@@ -1,13 +1,14 @@
 "use client";
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_copilotkit = require('./copilotkit-CmMYFfLV.cjs');
+const require_copilotkit = require('./copilotkit-8KSSmCH_.cjs');
 let react = require("react");
 react = require_copilotkit.__toESM(react);
 let _copilotkit_core = require("@copilotkit/core");
 let _ag_ui_client = require("@ag-ui/client");
 let _copilotkit_shared = require("@copilotkit/shared");
 let _copilotkit_runtime_client_gql = require("@copilotkit/runtime-client-gql");
+let _copilotkit_react_core_v2_context = require("@copilotkit/react-core/v2/context");
 
 //#region src/utils/suggestions-constants.ts
 /**
@@ -37,7 +38,7 @@ function useLazyToolRenderer() {
 //#endregion
 //#region src/hooks/use-copilot-chat_internal.ts
 function useCopilotChatInternal({ suggestions, onInProgress, onSubmitMessage, onStopGeneration, onReloadMessages } = {}) {
-	const { copilotkit } = require_copilotkit.useCopilotKit();
+	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
 	const { threadId, agentSession } = require_copilotkit.useCopilotContext();
 	const existingConfig = require_copilotkit.useCopilotChatConfiguration();
 	const [agentAvailable, setAgentAvailable] = (0, react.useState)(false);
@@ -615,7 +616,7 @@ function useFrontendTool(tool, dependencies) {
 //#endregion
 //#region src/hooks/use-render-tool-call.ts
 function useRenderToolCall(tool, dependencies) {
-	const { copilotkit } = require_copilotkit.useCopilotKit();
+	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
 	const hasAddedRef = (0, react.useRef)(false);
 	(0, react.useEffect)(() => {
 		const { name, parameters, render } = tool;
@@ -1041,8 +1042,7 @@ function useMakeCopilotDocumentReadable(document, categories, dependencies = [])
 //#region src/hooks/use-copilot-readable.ts
 /**
 * `useCopilotReadable` is a React hook that provides app-state and other information
-* to the Copilot. Optionally, the hook can also handle hierarchical state within your
-* application, passing these parent-child relationships to the Copilot.
+* to the Copilot.
 *
 * ## Usage
 *
@@ -1065,75 +1065,74 @@ function useMakeCopilotDocumentReadable(document, categories, dependencies = [])
 * }
 * ```
 *
-* ### Nested Components
+* ### Custom Serialization
 *
-* Optionally, you can maintain the hierarchical structure of information by passing
-* `parentId`. This allows you to use `useCopilotReadable` in nested components:
+* By default the value is serialized with `JSON.stringify`. Pass `convert` to
+* control the string the Copilot sees. It is called with the description and the
+* value, in that order:
 *
-* ```tsx /employeeContextId/1 {17,23}
-* import { useCopilotReadable } from "@copilotkit/react-core";
+* ```tsx
+* useCopilotReadable({
+*   description: "The current user",
+*   value: user,
+*   convert: (description, value) => `${description}: ${value.firstName} ${value.lastName}`,
+* });
+* ```
 *
-* function Employee(props: EmployeeProps) {
-*   const { employeeName, workProfile, metadata } = props;
+* ### Conditional Usage
 *
-*   // propagate any information to copilot
-*   const employeeContextId = useCopilotReadable({
-*     description: "Employee name",
-*     value: employeeName
-*   });
+* Toggle `available` to add or remove the context as your app state changes.
+* Switching to `"disabled"` removes the entry from the Copilot context; switching
+* back to `"enabled"` re-adds it.
 *
-*   // Pass a parentID to maintain a hierarchical structure.
-*   // Especially useful with child React components, list elements, etc.
-*   useCopilotReadable({
-*     description: "Work profile",
-*     value: workProfile.description(),
-*     parentId: employeeContextId
-*   });
+* ```tsx
+* useCopilotReadable({
+*   description: "The list of employees",
+*   value: employees,
+*   available: showEmployees ? "enabled" : "disabled",
+* });
+* ```
 *
-*   useCopilotReadable({
-*     description: "Employee metadata",
-*     value: metadata.description(),
-*     parentId: employeeContextId
-*   });
+* ### Re-running on Custom Dependencies
 *
-*   return (
-*     // Render as usual...
-*   );
-* }
+* The context is refreshed whenever `description`, `value`, `convert` or
+* `available` change. Pass a second argument to add your own dependencies:
+*
+* ```tsx
+* useCopilotReadable(
+*   {
+*     description: "The selected employee",
+*     value: employee,
+*   },
+*   [departmentId],
+* );
 * ```
 */
 /**
 * Adds the given information to the Copilot context to make it readable by Copilot.
 */
-function useCopilotReadable({ description, value, convert, available }, dependencies) {
-	const { copilotkit } = require_copilotkit.useCopilotKit();
+function useCopilotReadable({ description, value, convert, available = "enabled" }, dependencies) {
+	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
 	const ctxIdRef = (0, react.useRef)(void 0);
 	(0, react.useEffect)(() => {
 		if (!copilotkit) return;
-		const found = Object.entries(copilotkit.context).find(([id, ctxItem]) => {
-			return JSON.stringify({
-				description,
-				value
-			}) == JSON.stringify(ctxItem);
-		});
-		if (found) {
-			ctxIdRef.current = found[0];
-			if (available === "disabled") copilotkit.removeContext(ctxIdRef.current);
-			return;
-		}
-		if (!found && available === "disabled") return;
-		ctxIdRef.current = copilotkit.addContext({
+		if (available === "disabled") return;
+		const id = copilotkit.addContext({
 			description,
-			value: (convert ?? JSON.stringify)(value)
+			value: convert ? convert(description, value) : JSON.stringify(value)
 		});
+		ctxIdRef.current = id;
 		return () => {
-			if (!ctxIdRef.current) return;
-			copilotkit.removeContext(ctxIdRef.current);
+			copilotkit.removeContext(id);
+			if (ctxIdRef.current === id) ctxIdRef.current = void 0;
 		};
 	}, [
+		copilotkit,
 		description,
 		value,
-		convert
+		convert,
+		available,
+		...dependencies || []
 	]);
 	return ctxIdRef.current;
 }
@@ -1268,7 +1267,7 @@ function useAgentNodeName(agentName) {
 */
 function useCoAgent(options) {
 	const { agent } = require_copilotkit.useAgent({ agentId: options.name });
-	const { copilotkit } = require_copilotkit.useCopilotKit();
+	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
 	const nodeName = useAgentNodeName(options.name);
 	const handleStateUpdate = (0, react.useCallback)((newState) => {
 		if (!agent) return;