@copilotkit/react-core 1.51.5-next.0 → 1.51.5-next.2

package/dist/chunk-S65UEHGI.mjs

@@ -1,95 +0,0 @@
-import {
-  useCoAgentStateRenders
-} from "./chunk-IHMMKEFG.mjs";
-import {
-  CopilotContext
-} from "./chunk-C7HSVDHD.mjs";
-import {
-  useToast
-} from "./chunk-ZP2IMXFY.mjs";
-
-// src/hooks/use-coagent-state-render.ts
-import { useRef, useContext, useEffect } from "react";
-import { randomId, CopilotKitAgentDiscoveryError } from "@copilotkit/shared";
-function useCoAgentStateRender(action, dependencies) {
-  const { chatComponentsCache, availableAgents } = useContext(CopilotContext);
-  const {
-    setCoAgentStateRender,
-    removeCoAgentStateRender,
-    coAgentStateRenders
-  } = useCoAgentStateRenders();
-  const idRef = useRef(randomId());
-  const { setBannerError, addToast } = useToast();
-  useEffect(() => {
-    if ((availableAgents == null ? void 0 : availableAgents.length) && !availableAgents.some((a) => a.name === action.name)) {
-      const message = `(useCoAgentStateRender): Agent "${action.name}" not found. Make sure the agent exists and is properly configured.`;
-      const agentError = new CopilotKitAgentDiscoveryError({
-        agentName: action.name,
-        availableAgents: availableAgents.map((a) => ({
-          name: a.name,
-          id: a.id
-        }))
-      });
-      setBannerError(agentError);
-    }
-  }, [availableAgents]);
-  const key = `${action.name}-${action.nodeName || "global"}`;
-  if (dependencies === void 0) {
-    if (coAgentStateRenders[idRef.current]) {
-      coAgentStateRenders[idRef.current].handler = action.handler;
-      if (typeof action.render === "function") {
-        if (chatComponentsCache.current !== null) {
-          chatComponentsCache.current.coAgentStateRenders[key] = action.render;
-        }
-      }
-    }
-  }
-  useEffect(() => {
-    const currentId = idRef.current;
-    const hasDuplicate = Object.entries(coAgentStateRenders).some(
-      ([id, otherAction]) => {
-        if (id === currentId)
-          return false;
-        if (otherAction.name !== action.name)
-          return false;
-        const hasNodeName = !!action.nodeName;
-        const hasOtherNodeName = !!otherAction.nodeName;
-        if (!hasNodeName && !hasOtherNodeName)
-          return true;
-        if (hasNodeName !== hasOtherNodeName)
-          return false;
-        return action.nodeName === otherAction.nodeName;
-      }
-    );
-    if (hasDuplicate) {
-      const message = action.nodeName ? `Found multiple state renders for agent ${action.name} and node ${action.nodeName}. State renders might get overridden` : `Found multiple state renders for agent ${action.name}. State renders might get overridden`;
-      addToast({
-        type: "warning",
-        message,
-        id: `dup-action-${action.name}`
-      });
-    }
-  }, [coAgentStateRenders]);
-  useEffect(() => {
-    setCoAgentStateRender(idRef.current, action);
-    if (chatComponentsCache.current !== null && action.render !== void 0) {
-      chatComponentsCache.current.coAgentStateRenders[key] = action.render;
-    }
-    return () => {
-      removeCoAgentStateRender(idRef.current);
-    };
-  }, [
-    setCoAgentStateRender,
-    removeCoAgentStateRender,
-    action.name,
-    // include render only if it's a string
-    typeof action.render === "string" ? action.render : void 0,
-    // dependencies set by the developer
-    ...dependencies || []
-  ]);
-}
-
-export {
-  useCoAgentStateRender
-};
-//# sourceMappingURL=chunk-S65UEHGI.mjs.map

package/dist/chunk-S65UEHGI.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-coagent-state-render.ts"],"sourcesContent":["/**\n * The useCoAgentStateRender hook allows you to render UI or text based components on a Agentic Copilot's state in the chat.\n * This is particularly useful for showing intermediate state or progress during Agentic Copilot operations.\n *\n * ## Usage\n *\n * ### Simple Usage\n *\n * ```tsx\n * import { useCoAgentStateRender } from \"@copilotkit/react-core\";\n *\n * type YourAgentState = {\n *   agent_state_property: string;\n * }\n *\n * useCoAgentStateRender<YourAgentState>({\n *   name: \"basic_agent\",\n *   nodeName: \"optionally_specify_a_specific_node\",\n *   render: ({ status, state, nodeName }) => {\n *     return (\n *       <YourComponent\n *         agentStateProperty={state.agent_state_property}\n *         status={status}\n *         nodeName={nodeName}\n *       />\n *     );\n *   },\n * });\n * ```\n *\n * This allows for you to render UI components or text based on what is happening within the agent.\n *\n * ### Example\n * A great example of this is in our Perplexity Clone where we render the progress of an agent's internet search as it is happening.\n * You can play around with it below or learn how to build it with its [demo](/coagents/videos/perplexity-clone).\n *\n * <Callout type=\"info\">\n *   This example is hosted on Vercel and may take a few seconds to load.\n * </Callout>\n *\n * <iframe src=\"https://examples-coagents-ai-researcher-ui.vercel.app/\" className=\"w-full rounded-lg border h-[700px] my-4\" />\n */\n\nimport { useRef, useContext, useEffect } from \"react\";\nimport { CopilotContext } from \"../context/copilot-context\";\nimport { randomId, CopilotKitAgentDiscoveryError } from \"@copilotkit/shared\";\nimport { CoAgentStateRender } from \"../types/coagent-action\";\nimport { useToast } from \"../components/toast/toast-provider\";\nimport { useCoAgentStateRenders } from \"../context/coagent-state-renders-context\";\n\n/**\n * This hook is used to render agent state with custom UI components or text. This is particularly\n * useful for showing intermediate state or progress during Agentic Copilot operations.\n * To get started using rendering intermediate state through this hook, checkout the documentation.\n *\n * https://docs.copilotkit.ai/coagents/shared-state/predictive-state-updates\n */\n\n// We implement useCoAgentStateRender dependency handling so that\n// the developer has the option to not provide any dependencies.\n// see useCopilotAction for more details about this approach.\nexport function useCoAgentStateRender<T = any>(\n  action: CoAgentStateRender<T>,\n  dependencies?: any[],\n): void {\n  const { chatComponentsCache, availableAgents } = useContext(CopilotContext);\n  const {\n    setCoAgentStateRender,\n    removeCoAgentStateRender,\n    coAgentStateRenders,\n  } = useCoAgentStateRenders();\n  const idRef = useRef<string>(randomId());\n  const { setBannerError, addToast } = useToast();\n\n  useEffect(() => {\n    if (\n      availableAgents?.length &&\n      !availableAgents.some((a) => a.name === action.name)\n    ) {\n      const message = `(useCoAgentStateRender): Agent \"${action.name}\" not found. Make sure the agent exists and is properly configured.`;\n\n      // Route to banner instead of toast for consistency\n      const agentError = new CopilotKitAgentDiscoveryError({\n        agentName: action.name,\n        availableAgents: availableAgents.map((a) => ({\n          name: a.name,\n          id: a.id,\n        })),\n      });\n      setBannerError(agentError);\n    }\n  }, [availableAgents]);\n\n  const key = `${action.name}-${action.nodeName || \"global\"}`;\n\n  if (dependencies === undefined) {\n    if (coAgentStateRenders[idRef.current]) {\n      coAgentStateRenders[idRef.current].handler = action.handler as any;\n      if (typeof action.render === \"function\") {\n        if (chatComponentsCache.current !== null) {\n          chatComponentsCache.current.coAgentStateRenders[key] = action.render;\n        }\n      }\n    }\n  }\n\n  useEffect(() => {\n    // Check for duplicates by comparing against all other actions\n    const currentId = idRef.current;\n    const hasDuplicate = Object.entries(coAgentStateRenders).some(\n      ([id, otherAction]) => {\n        // Skip comparing with self\n        if (id === currentId) return false;\n\n        // Different agent names are never duplicates\n        if (otherAction.name !== action.name) return false;\n\n        // Same agent names:\n        const hasNodeName = !!action.nodeName;\n        const hasOtherNodeName = !!otherAction.nodeName;\n\n        // If neither has nodeName, they're duplicates\n        if (!hasNodeName && !hasOtherNodeName) return true;\n\n        // If one has nodeName and other doesn't, they're not duplicates\n        if (hasNodeName !== hasOtherNodeName) return false;\n\n        // If both have nodeName, they're duplicates only if the names match\n        return action.nodeName === otherAction.nodeName;\n      },\n    );\n\n    if (hasDuplicate) {\n      const message = action.nodeName\n        ? `Found multiple state renders for agent ${action.name} and node ${action.nodeName}. State renders might get overridden`\n        : `Found multiple state renders for agent ${action.name}. State renders might get overridden`;\n\n      addToast({\n        type: \"warning\",\n        message,\n        id: `dup-action-${action.name}`,\n      });\n    }\n  }, [coAgentStateRenders]);\n\n  useEffect(() => {\n    setCoAgentStateRender(idRef.current, action as any);\n    if (chatComponentsCache.current !== null && action.render !== undefined) {\n      chatComponentsCache.current.coAgentStateRenders[key] = action.render;\n    }\n    return () => {\n      removeCoAgentStateRender(idRef.current);\n    };\n  }, [\n    setCoAgentStateRender,\n    removeCoAgentStateRender,\n    action.name,\n    // include render only if it's a string\n    typeof action.render === \"string\" ? action.render : undefined,\n    // dependencies set by the developer\n    ...(dependencies || []),\n  ]);\n}\n"],"mappings":";;;;;;;;;;;AA2CA,SAAS,QAAQ,YAAY,iBAAiB;AAE9C,SAAS,UAAU,qCAAqC;AAgBjD,SAAS,sBACd,QACA,cACM;AACN,QAAM,EAAE,qBAAqB,gBAAgB,IAAI,WAAW,cAAc;AAC1E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,uBAAuB;AAC3B,QAAM,QAAQ,OAAe,SAAS,CAAC;AACvC,QAAM,EAAE,gBAAgB,SAAS,IAAI,SAAS;AAE9C,YAAU,MAAM;AACd,SACE,mDAAiB,WACjB,CAAC,gBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,OAAO,IAAI,GACnD;AACA,YAAM,UAAU,mCAAmC,OAAO;AAG1D,YAAM,aAAa,IAAI,8BAA8B;AAAA,QACnD,WAAW,OAAO;AAAA,QAClB,iBAAiB,gBAAgB,IAAI,CAAC,OAAO;AAAA,UAC3C,MAAM,EAAE;AAAA,UACR,IAAI,EAAE;AAAA,QACR,EAAE;AAAA,MACJ,CAAC;AACD,qBAAe,UAAU;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,eAAe,CAAC;AAEpB,QAAM,MAAM,GAAG,OAAO,QAAQ,OAAO,YAAY;AAEjD,MAAI,iBAAiB,QAAW;AAC9B,QAAI,oBAAoB,MAAM,OAAO,GAAG;AACtC,0BAAoB,MAAM,OAAO,EAAE,UAAU,OAAO;AACpD,UAAI,OAAO,OAAO,WAAW,YAAY;AACvC,YAAI,oBAAoB,YAAY,MAAM;AACxC,8BAAoB,QAAQ,oBAAoB,GAAG,IAAI,OAAO;AAAA,QAChE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,YAAU,MAAM;AAEd,UAAM,YAAY,MAAM;AACxB,UAAM,eAAe,OAAO,QAAQ,mBAAmB,EAAE;AAAA,MACvD,CAAC,CAAC,IAAI,WAAW,MAAM;AAErB,YAAI,OAAO;AAAW,iBAAO;AAG7B,YAAI,YAAY,SAAS,OAAO;AAAM,iBAAO;AAG7C,cAAM,cAAc,CAAC,CAAC,OAAO;AAC7B,cAAM,mBAAmB,CAAC,CAAC,YAAY;AAGvC,YAAI,CAAC,eAAe,CAAC;AAAkB,iBAAO;AAG9C,YAAI,gBAAgB;AAAkB,iBAAO;AAG7C,eAAO,OAAO,aAAa,YAAY;AAAA,MACzC;AAAA,IACF;AAEA,QAAI,cAAc;AAChB,YAAM,UAAU,OAAO,WACnB,0CAA0C,OAAO,iBAAiB,OAAO,iDACzE,0CAA0C,OAAO;AAErD,eAAS;AAAA,QACP,MAAM;AAAA,QACN;AAAA,QACA,IAAI,cAAc,OAAO;AAAA,MAC3B,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,mBAAmB,CAAC;AAExB,YAAU,MAAM;AACd,0BAAsB,MAAM,SAAS,MAAa;AAClD,QAAI,oBAAoB,YAAY,QAAQ,OAAO,WAAW,QAAW;AACvE,0BAAoB,QAAQ,oBAAoB,GAAG,IAAI,OAAO;AAAA,IAChE;AACA,WAAO,MAAM;AACX,+BAAyB,MAAM,OAAO;AAAA,IACxC;AAAA,EACF,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA,OAAO;AAAA;AAAA,IAEP,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS;AAAA;AAAA,IAEpD,GAAI,gBAAgB,CAAC;AAAA,EACvB,CAAC;AACH;","names":[]}