@copilotkit/react-core 1.79.1 → 1.79.2-canary.1792172552

package/dist/v2/headless.cjs

@@ -51,7 +51,7 @@ function shallowEqual(obj1, obj2) {
 * Returns true only for plain JS objects (`{}`), excluding arrays, Dates,
 * class instances, and other exotic objects that happen to have typeof "object".
 */
-function isPlainObject(obj) {
+function isPlainObject$1(obj) {
 	return obj !== null && typeof obj === "object" && Object.prototype.toString.call(obj) === "[object Object]";
 }
 /**
@@ -70,7 +70,7 @@ function isPlainObject(obj) {
 function useShallowStableRef(value) {
 	const ref = (0, react.useRef)(value);
 	if (ref.current === value) return ref.current;
-	if (isPlainObject(ref.current) && isPlainObject(value)) {
+	if (isPlainObject$1(ref.current) && isPlainObject$1(value)) {
 		if (shallowEqual(ref.current, value)) return ref.current;
 	}
 	ref.current = value;
@@ -562,12 +562,86 @@ function useAgent({ agentId, threadId, runtimeAgentId, updates, throttleMs } = {
 	};
 }
 
+//#endregion
+//#region src/v2/hooks/tool-registration.ts
+/**
+* Deps comparison shared by `useFrontendTool` (and through it
+* `useHumanInTheLoop` and `useComponent`) and `useRenderTool`. Not part of the
+* public API.
+*/
+const EMPTY_DEPS$1 = [];
+function isPlainObject(value) {
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+/**
+* Plain data (primitives, plain objects, arrays, dates) compares by value.
+* Functions always compare equal: these hooks used to compare
+* `JSON.stringify(deps)`, which turns every function into `null`, and a
+* function that counted as changed would re-register on every render when it
+* is written inline (and loop in a component that also reads
+* `useRenderToolCall`). Everything else (class instances, maps, sets) compares
+* by identity. A cycle inside plain data is safe: a pair already being
+* compared counts as equal for that branch.
+*/
+function depEqual(a, b, seen) {
+	if (Object.is(a, b)) return true;
+	if (typeof a === "function" && typeof b === "function") return true;
+	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return false;
+	if (a instanceof Date && b instanceof Date) return Object.is(a.getTime(), b.getTime());
+	const aIsArray = Array.isArray(a);
+	if (aIsArray !== Array.isArray(b)) return false;
+	if (!aIsArray && !(isPlainObject(a) && isPlainObject(b))) return false;
+	if (seen.get(a) === b) return true;
+	seen.set(a, b);
+	if (aIsArray) {
+		const left = a;
+		const right = b;
+		if (left.length !== right.length) return false;
+		for (let i = 0; i < left.length; i++) if (!depEqual(left[i], right[i], seen)) return false;
+		return true;
+	}
+	const left = a;
+	const right = b;
+	const leftKeys = Object.keys(left);
+	if (leftKeys.length !== Object.keys(right).length) return false;
+	for (const key of leftKeys) {
+		if (!Object.prototype.hasOwnProperty.call(right, key)) return false;
+		if (!depEqual(left[key], right[key], seen)) return false;
+	}
+	return true;
+}
+/** Whether two deps arrays are equal. A change in length is always a change. */
+function depsEqual(prev, next) {
+	if (prev.length !== next.length) return false;
+	const seen = /* @__PURE__ */ new Map();
+	for (let i = 0; i < prev.length; i++) if (!depEqual(prev[i], next[i], seen)) return false;
+	return true;
+}
+/**
+* Turns a caller's `deps` array into a number that changes exactly when the
+* deps change, by the rules of {@link depsEqual}. Put the number, not the
+* array, in the registration effect's dependency list: that keeps the list a
+* constant length and never serializes a value.
+*/
+function useDepsVersion(deps) {
+	const next = deps ?? EMPTY_DEPS$1;
+	const ref = (0, react.useRef)({
+		deps: next,
+		version: 0
+	});
+	if (ref.current.deps !== next && !depsEqual(ref.current.deps, next)) ref.current = {
+		deps: next,
+		version: ref.current.version + 1
+	};
+	return ref.current.version;
+}
+
 //#endregion
 //#region src/v2/hooks/use-frontend-tool.tsx
-const EMPTY_DEPS$2 = [];
 function useFrontendTool(tool, deps) {
 	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
-	const extraDeps = deps ?? EMPTY_DEPS$2;
+	const depsVersion = useDepsVersion(deps);
 	(0, react.useLayoutEffect)(() => {
 		const name = tool.name;
 		if (copilotkit.getTool({
@@ -591,14 +665,14 @@ function useFrontendTool(tool, deps) {
 		tool.name,
 		tool.available,
 		copilotkit,
-		JSON.stringify(extraDeps),
+		depsVersion,
 		JSON.stringify(tool.webmcp ?? null)
 	]);
 }
 
 //#endregion
 //#region src/v2/hooks/use-frontend-tools.tsx
-const EMPTY_DEPS$1 = [];
+const EMPTY_DEPS = [];
 const EMPTY_TOOLS = [];
 /**
 * Register a list of frontend tools whose length can change between renders.
@@ -652,7 +726,7 @@ const EMPTY_TOOLS = [];
 function useFrontendTools(tools, deps) {
 	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
 	const toolList = tools ?? EMPTY_TOOLS;
-	const extraDeps = deps ?? EMPTY_DEPS$1;
+	const extraDeps = deps ?? EMPTY_DEPS;
 	(0, react.useLayoutEffect)(() => {
 		const deduped = /* @__PURE__ */ new Map();
 		for (const tool of toolList) {
@@ -1570,7 +1644,6 @@ function defineToolCallRenderer(def) {
 
 //#endregion
 //#region src/v2/hooks/use-render-tool.tsx
-const EMPTY_DEPS = [];
 /**
 * Registers a renderer entry in CopilotKit's `renderToolCalls` registry.
 *
@@ -1614,7 +1687,7 @@ const EMPTY_DEPS = [];
 */
 function useRenderTool(config, deps) {
 	const { copilotkit } = (0, _copilotkit_react_core_v2_context.useCopilotKit)();
-	const extraDeps = deps ?? EMPTY_DEPS;
+	const depsVersion = useDepsVersion(deps);
 	(0, react.useEffect)(() => {
 		const renderer = config.name === "*" && !config.parameters ? defineToolCallRenderer({
 			name: "*",
@@ -1646,7 +1719,7 @@ function useRenderTool(config, deps) {
 	}, [
 		config.name,
 		copilotkit,
-		JSON.stringify(extraDeps)
+		depsVersion
 	]);
 }