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

package/dist/chunk-UA23VX5J.mjs

@@ -1,65 +0,0 @@
-import {
-  __spreadProps,
-  __spreadValues
-} from "./chunk-SKC7AJIV.mjs";
-
-// src/hooks/use-frontend-tool.ts
-import React, { useEffect, useMemo, useRef } from "react";
-import {
-  getZodParameters
-} from "@copilotkit/shared";
-import { parseJson } from "@copilotkit/shared";
-import {
-  useFrontendTool as useFrontendToolVNext
-} from "@copilotkitnext/react";
-function useFrontendTool(tool, dependencies) {
-  const { name, description, parameters, render, followUp } = tool;
-  const zodParameters = getZodParameters(parameters);
-  const renderRef = useRef(render);
-  useEffect(() => {
-    renderRef.current = render;
-  }, [render, ...dependencies != null ? dependencies : []]);
-  const normalizedRender = useMemo(() => {
-    if (typeof render === "undefined") {
-      return void 0;
-    }
-    return (args) => {
-      const currentRender = renderRef.current;
-      if (typeof currentRender === "undefined") {
-        return null;
-      }
-      if (typeof currentRender === "string") {
-        return React.createElement(React.Fragment, null, currentRender);
-      }
-      const renderArgs = __spreadProps(__spreadValues({}, args), {
-        result: typeof args.result === "string" ? parseJson(args.result, args.result) : args.result
-      });
-      const rendered = currentRender(renderArgs);
-      if (typeof rendered === "string") {
-        return React.createElement(React.Fragment, null, rendered);
-      }
-      return rendered != null ? rendered : null;
-    };
-  }, []);
-  const handlerRef = useRef(tool.handler);
-  useEffect(() => {
-    handlerRef.current = tool.handler;
-  }, [tool.handler, ...dependencies != null ? dependencies : []]);
-  const normalizedHandler = tool.handler ? (args) => {
-    var _a;
-    return (_a = handlerRef.current) == null ? void 0 : _a.call(handlerRef, args);
-  } : void 0;
-  useFrontendToolVNext({
-    name,
-    description,
-    parameters: zodParameters,
-    handler: normalizedHandler,
-    followUp,
-    render: normalizedRender
-  });
-}
-
-export {
-  useFrontendTool
-};
-//# sourceMappingURL=chunk-UA23VX5J.mjs.map

package/dist/chunk-UA23VX5J.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-frontend-tool.ts"],"sourcesContent":["import React, { useEffect, useMemo, useRef } from \"react\";\nimport { ActionRenderProps, FrontendAction } from \"../types/frontend-action\";\nimport {\n  Parameter,\n  getZodParameters,\n  MappedParameterTypes,\n} from \"@copilotkit/shared\";\nimport { parseJson } from \"@copilotkit/shared\";\nimport { ToolCallStatus } from \"@copilotkitnext/core\";\nimport {\n  type ReactFrontendTool,\n  useFrontendTool as useFrontendToolVNext,\n} from \"@copilotkitnext/react\";\n\ntype FrontendToolOptions<T extends Parameter[] | []> = ReactFrontendTool<\n  MappedParameterTypes<T>\n>;\ntype FrontendToolRenderArgs<T extends Parameter[] | []> =\n  | {\n      name: string;\n      args: Partial<MappedParameterTypes<T>>;\n      status: ToolCallStatus.InProgress;\n      result: undefined;\n    }\n  | {\n      name: string;\n      args: MappedParameterTypes<T>;\n      status: ToolCallStatus.Executing;\n      result: undefined;\n    }\n  | {\n      name: string;\n      args: MappedParameterTypes<T>;\n      status: ToolCallStatus.Complete;\n      result: string;\n    };\n\nexport type UseFrontendToolArgs<T extends Parameter[] | [] = []> = {\n  available?: \"disabled\" | \"enabled\";\n} & Pick<\n  FrontendAction<T>,\n  \"name\" | \"description\" | \"parameters\" | \"handler\" | \"followUp\" | \"render\"\n>;\n\nexport function useFrontendTool<const T extends Parameter[] = []>(\n  tool: UseFrontendToolArgs<T>,\n  dependencies?: any[],\n) {\n  const { name, description, parameters, render, followUp } = tool;\n  const zodParameters = getZodParameters(parameters);\n\n  const renderRef = useRef<typeof render>(render);\n\n  useEffect(() => {\n    renderRef.current = render;\n  }, [render, ...(dependencies ?? [])]);\n\n  const normalizedRender: FrontendToolOptions<T>[\"render\"] | undefined =\n    useMemo(() => {\n      if (typeof render === \"undefined\") {\n        return undefined;\n      }\n\n      return ((args: FrontendToolRenderArgs<T>) => {\n        const currentRender = renderRef.current;\n\n        if (typeof currentRender === \"undefined\") {\n          return null;\n        }\n\n        if (typeof currentRender === \"string\") {\n          return React.createElement(React.Fragment, null, currentRender);\n        }\n\n        const renderArgs = {\n          ...args,\n          result:\n            typeof args.result === \"string\"\n              ? parseJson(args.result, args.result)\n              : args.result,\n        } as ActionRenderProps<T>;\n\n        const rendered = currentRender(renderArgs);\n\n        if (typeof rendered === \"string\") {\n          return React.createElement(React.Fragment, null, rendered);\n        }\n\n        return rendered ?? null;\n      }) as FrontendToolOptions<T>[\"render\"];\n    }, []);\n\n  // Handler ref to avoid stale closures\n  const handlerRef = useRef<typeof tool.handler>(tool.handler);\n\n  useEffect(() => {\n    handlerRef.current = tool.handler;\n  }, [tool.handler, ...(dependencies ?? [])]);\n\n  const normalizedHandler = tool.handler\n    ? (args: MappedParameterTypes<T>) => handlerRef.current?.(args)\n    : undefined;\n\n  useFrontendToolVNext<MappedParameterTypes<T>>({\n    name,\n    description,\n    parameters: zodParameters,\n    handler: normalizedHandler,\n    followUp,\n    render: normalizedRender,\n  });\n}\n"],"mappings":";;;;;;AAAA,OAAO,SAAS,WAAW,SAAS,cAAc;AAElD;AAAA,EAEE;AAAA,OAEK;AACP,SAAS,iBAAiB;AAE1B;AAAA,EAEE,mBAAmB;AAAA,OACd;AAgCA,SAAS,gBACd,MACA,cACA;AACA,QAAM,EAAE,MAAM,aAAa,YAAY,QAAQ,SAAS,IAAI;AAC5D,QAAM,gBAAgB,iBAAiB,UAAU;AAEjD,QAAM,YAAY,OAAsB,MAAM;AAE9C,YAAU,MAAM;AACd,cAAU,UAAU;AAAA,EACtB,GAAG,CAAC,QAAQ,GAAI,sCAAgB,CAAC,CAAE,CAAC;AAEpC,QAAM,mBACJ,QAAQ,MAAM;AACZ,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO;AAAA,IACT;AAEA,WAAQ,CAAC,SAAoC;AAC3C,YAAM,gBAAgB,UAAU;AAEhC,UAAI,OAAO,kBAAkB,aAAa;AACxC,eAAO;AAAA,MACT;AAEA,UAAI,OAAO,kBAAkB,UAAU;AACrC,eAAO,MAAM,cAAc,MAAM,UAAU,MAAM,aAAa;AAAA,MAChE;AAEA,YAAM,aAAa,iCACd,OADc;AAAA,QAEjB,QACE,OAAO,KAAK,WAAW,WACnB,UAAU,KAAK,QAAQ,KAAK,MAAM,IAClC,KAAK;AAAA,MACb;AAEA,YAAM,WAAW,cAAc,UAAU;AAEzC,UAAI,OAAO,aAAa,UAAU;AAChC,eAAO,MAAM,cAAc,MAAM,UAAU,MAAM,QAAQ;AAAA,MAC3D;AAEA,aAAO,8BAAY;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,CAAC;AAGP,QAAM,aAAa,OAA4B,KAAK,OAAO;AAE3D,YAAU,MAAM;AACd,eAAW,UAAU,KAAK;AAAA,EAC5B,GAAG,CAAC,KAAK,SAAS,GAAI,sCAAgB,CAAC,CAAE,CAAC;AAE1C,QAAM,oBAAoB,KAAK,UAC3B,CAAC,SAA+B;AApGtC;AAoGyC,4BAAW,YAAX,oCAAqB;AAAA,MACxD;AAEJ,uBAA8C;AAAA,IAC5C;AAAA,IACA;AAAA,IACA,YAAY;AAAA,IACZ,SAAS;AAAA,IACT;AAAA,IACA,QAAQ;AAAA,EACV,CAAC;AACH;","names":[]}

package/dist/chunk-V42VL2JR.mjs

@@ -1,136 +0,0 @@
-import {
-  useAgentNodeName
-} from "./chunk-I76HKHPJ.mjs";
-import {
-  useCopilotContext
-} from "./chunk-C7HSVDHD.mjs";
-import {
-  __spreadProps,
-  __spreadValues
-} from "./chunk-SKC7AJIV.mjs";
-
-// src/hooks/use-langgraph-interrupt-render.ts
-import React, { useCallback, useEffect, useMemo } from "react";
-import { MetaEventName } from "@copilotkit/runtime-client-gql";
-import { dataToUUID, parseJson } from "@copilotkit/shared";
-import { useCopilotChatConfiguration } from "@copilotkitnext/react";
-var InterruptRenderer = ({
-  event,
-  result,
-  render,
-  resolve
-}) => {
-  return render({ event, result, resolve });
-};
-function useLangGraphInterruptRender(agent) {
-  var _a;
-  const {
-    interruptActions,
-    agentSession,
-    threadId,
-    interruptEventQueue,
-    addInterruptEvent,
-    resolveInterruptEvent
-  } = useCopilotContext();
-  const existingConfig = useCopilotChatConfiguration();
-  const resolvedAgentId = (_a = existingConfig == null ? void 0 : existingConfig.agentId) != null ? _a : "default";
-  const nodeName = useAgentNodeName(resolvedAgentId);
-  useEffect(() => {
-    if (!agent)
-      return;
-    let localInterrupt = null;
-    const subscriber = {
-      onCustomEvent: ({ event }) => {
-        if (event.name === "on_interrupt") {
-          const eventData = {
-            name: MetaEventName.LangGraphInterruptEvent,
-            type: event.type,
-            value: parseJson(event.value, event.value)
-          };
-          const eventId = dataToUUID(eventData, "interruptEvents");
-          localInterrupt = {
-            eventId,
-            threadId,
-            event: eventData
-          };
-        }
-      },
-      onRunStartedEvent: () => {
-        localInterrupt = null;
-      },
-      onRunFinalized: () => {
-        if (localInterrupt) {
-          addInterruptEvent(localInterrupt);
-          localInterrupt = null;
-        }
-      }
-    };
-    const { unsubscribe } = agent.subscribe(subscriber);
-    return () => {
-      unsubscribe();
-    };
-  }, [agent, threadId]);
-  const handleResolve = useCallback(
-    (eventId, response) => {
-      agent == null ? void 0 : agent.runAgent({
-        forwardedProps: {
-          command: {
-            resume: response
-          }
-        }
-      });
-      resolveInterruptEvent(threadId, eventId, response != null ? response : "");
-    },
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [agent, threadId]
-  );
-  return useMemo(() => {
-    const eventQueue = interruptEventQueue[threadId] || [];
-    const currentQueuedEvent = eventQueue.find((qe) => !qe.event.response);
-    if (!currentQueuedEvent || !agentSession)
-      return null;
-    const allActions = Object.values(interruptActions);
-    const matchingAction = allActions.find((action) => {
-      if (!action.enabled)
-        return true;
-      return action.enabled({
-        eventValue: currentQueuedEvent.event.value,
-        agentMetadata: __spreadProps(__spreadValues({}, agentSession), {
-          nodeName
-        })
-      });
-    });
-    if (!matchingAction)
-      return null;
-    const { render, handler } = matchingAction;
-    const resolveInterrupt = (response) => {
-      handleResolve(currentQueuedEvent.eventId, response);
-    };
-    let result = null;
-    if (handler) {
-      result = handler({
-        event: currentQueuedEvent.event,
-        resolve: resolveInterrupt
-      });
-    }
-    if (!render)
-      return null;
-    return React.createElement(InterruptRenderer, {
-      event: currentQueuedEvent.event,
-      result,
-      render,
-      resolve: resolveInterrupt
-    });
-  }, [
-    interruptActions,
-    interruptEventQueue,
-    threadId,
-    agentSession,
-    handleResolve
-  ]);
-}
-
-export {
-  useLangGraphInterruptRender
-};
-//# sourceMappingURL=chunk-V42VL2JR.mjs.map

package/dist/chunk-V42VL2JR.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-langgraph-interrupt-render.ts"],"sourcesContent":["import { useCopilotContext } from \"../context\";\nimport React, { useCallback, useEffect, useMemo } from \"react\";\nimport type { AbstractAgent, AgentSubscriber } from \"@ag-ui/client\";\nimport { MetaEventName } from \"@copilotkit/runtime-client-gql\";\nimport { dataToUUID, parseJson } from \"@copilotkit/shared\";\nimport { useAgentNodeName } from \"./use-agent-nodename\";\nimport { useCopilotChatConfiguration } from \"@copilotkitnext/react\";\n\ntype InterruptProps = {\n  event: any;\n  result: any;\n  render: (props: {\n    event: any;\n    result: any;\n    resolve: (response: string) => void;\n  }) => string | React.ReactElement;\n  resolve: (response: string) => void;\n};\n\nconst InterruptRenderer: React.FC<InterruptProps> = ({\n  event,\n  result,\n  render,\n  resolve,\n}) => {\n  return render({ event, result, resolve });\n};\n\nexport function useLangGraphInterruptRender(\n  agent: AbstractAgent,\n): string | React.ReactElement | null {\n  const {\n    interruptActions,\n    agentSession,\n    threadId,\n    interruptEventQueue,\n    addInterruptEvent,\n    resolveInterruptEvent,\n  } = useCopilotContext();\n  const existingConfig = useCopilotChatConfiguration();\n  const resolvedAgentId = existingConfig?.agentId ?? \"default\";\n  const nodeName = useAgentNodeName(resolvedAgentId);\n\n  useEffect(() => {\n    if (!agent) return;\n    let localInterrupt: any = null;\n    const subscriber: AgentSubscriber = {\n      onCustomEvent: ({ event }) => {\n        if (event.name === \"on_interrupt\") {\n          const eventData = {\n            name: MetaEventName.LangGraphInterruptEvent,\n            type: event.type,\n            value: parseJson(event.value, event.value),\n          };\n          const eventId = dataToUUID(eventData, \"interruptEvents\");\n          localInterrupt = {\n            eventId,\n            threadId,\n            event: eventData,\n          };\n        }\n      },\n      onRunStartedEvent: () => {\n        localInterrupt = null;\n      },\n      onRunFinalized: () => {\n        if (localInterrupt) {\n          addInterruptEvent(localInterrupt);\n          localInterrupt = null;\n        }\n      },\n    };\n\n    const { unsubscribe } = agent.subscribe(subscriber);\n    return () => {\n      unsubscribe();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [agent, threadId]);\n\n  const handleResolve = useCallback(\n    (eventId: string, response?: string) => {\n      agent?.runAgent({\n        forwardedProps: {\n          command: {\n            resume: response,\n          },\n        },\n      });\n      resolveInterruptEvent(threadId, eventId, response ?? \"\");\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [agent, threadId],\n  );\n\n  return useMemo(() => {\n    // Get the queue for this thread and find the first unresponded event\n    const eventQueue = interruptEventQueue[threadId] || [];\n    const currentQueuedEvent = eventQueue.find((qe) => !qe.event.response);\n\n    if (!currentQueuedEvent || !agentSession) return null;\n\n    // Find the first matching action from all registered actions\n    const allActions = Object.values(interruptActions);\n    const matchingAction = allActions.find((action) => {\n      if (!action.enabled) return true; // No filter = match all\n      return action.enabled({\n        eventValue: currentQueuedEvent.event.value,\n        agentMetadata: {\n          ...agentSession,\n          nodeName,\n        },\n      });\n    });\n\n    if (!matchingAction) return null;\n\n    const { render, handler } = matchingAction;\n\n    const resolveInterrupt = (response: string) => {\n      handleResolve(currentQueuedEvent.eventId, response);\n    };\n\n    let result = null;\n    if (handler) {\n      result = handler({\n        event: currentQueuedEvent.event,\n        resolve: resolveInterrupt,\n      });\n    }\n\n    if (!render) return null;\n\n    return React.createElement(InterruptRenderer, {\n      event: currentQueuedEvent.event,\n      result,\n      render,\n      resolve: resolveInterrupt,\n    });\n  }, [\n    interruptActions,\n    interruptEventQueue,\n    threadId,\n    agentSession,\n    handleResolve,\n  ]);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-VZ4NSOFQ.mjs

@@ -1,80 +0,0 @@
-import {
-  useRenderToolCall
-} from "./chunk-MBJ7OLYI.mjs";
-import {
-  useFrontendTool
-} from "./chunk-UA23VX5J.mjs";
-import {
-  useHumanInTheLoop
-} from "./chunk-LNGBARXE.mjs";
-import {
-  __spreadProps,
-  __spreadValues
-} from "./chunk-SKC7AJIV.mjs";
-
-// src/hooks/use-copilot-action.ts
-import { useState } from "react";
-function getActionConfig(action) {
-  if (action.name === "*") {
-    return {
-      type: "render",
-      action
-    };
-  }
-  if ("renderAndWaitForResponse" in action || "renderAndWait" in action) {
-    let render = action.render;
-    if (!render && "renderAndWaitForResponse" in action) {
-      render = action.renderAndWaitForResponse;
-    }
-    if (!render && "renderAndWait" in action) {
-      render = action.renderAndWait;
-    }
-    return {
-      type: "hitl",
-      action: __spreadProps(__spreadValues({}, action), { render })
-    };
-  }
-  if ("available" in action) {
-    if (action.available === "enabled" || action.available === "remote") {
-      return {
-        type: "frontend",
-        action
-      };
-    }
-    if (action.available === "frontend" || action.available === "disabled") {
-      return {
-        type: "render",
-        action
-      };
-    }
-  }
-  if ("handler" in action) {
-    return {
-      type: "frontend",
-      action
-    };
-  }
-  throw new Error("Invalid action configuration");
-}
-function useCopilotAction(action, dependencies) {
-  const [initialActionConfig] = useState(getActionConfig(action));
-  const currentActionConfig = getActionConfig(action);
-  if (initialActionConfig.type !== currentActionConfig.type) {
-    throw new Error("Action configuration changed between renders");
-  }
-  switch (currentActionConfig.type) {
-    case "render":
-      return useRenderToolCall(currentActionConfig.action, dependencies);
-    case "hitl":
-      return useHumanInTheLoop(currentActionConfig.action, dependencies);
-    case "frontend":
-      return useFrontendTool(currentActionConfig.action, dependencies);
-    default:
-      throw new Error("Invalid action configuration");
-  }
-}
-
-export {
-  useCopilotAction
-};
-//# sourceMappingURL=chunk-VZ4NSOFQ.mjs.map

package/dist/chunk-VZ4NSOFQ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-copilot-action.ts"],"sourcesContent":["/**\n * Example usage of useCopilotAction with complex parameters:\n *\n * @example\n * useCopilotAction({\n *   name: \"myAction\",\n *   parameters: [\n *     { name: \"arg1\", type: \"string\", enum: [\"option1\", \"option2\", \"option3\"], required: false },\n *     { name: \"arg2\", type: \"number\" },\n *     {\n *       name: \"arg3\",\n *       type: \"object\",\n *       attributes: [\n *         { name: \"nestedArg1\", type: \"boolean\" },\n *         { name: \"xyz\", required: false },\n *       ],\n *     },\n *     { name: \"arg4\", type: \"number[]\" },\n *   ],\n *   handler: ({ arg1, arg2, arg3, arg4 }) => {\n *     const x = arg3.nestedArg1;\n *     const z = arg3.xyz;\n *     console.log(arg1, arg2, arg3);\n *   },\n * });\n *\n * @example\n * // Simple action without parameters\n * useCopilotAction({\n *   name: \"myAction\",\n *   handler: () => {\n *     console.log(\"No parameters provided.\");\n *   },\n * });\n *\n * @example\n * // Interactive action with UI rendering and response handling\n * useCopilotAction({\n *   name: \"handleMeeting\",\n *   description: \"Handle a meeting by booking or canceling\",\n *   parameters: [\n *     {\n *       name: \"meeting\",\n *       type: \"string\",\n *       description: \"The meeting to handle\",\n *       required: true,\n *     },\n *     {\n *       name: \"date\",\n *       type: \"string\",\n *       description: \"The date of the meeting\",\n *       required: true,\n *     },\n *     {\n *       name: \"title\",\n *       type: \"string\",\n *       description: \"The title of the meeting\",\n *       required: true,\n *     },\n *   ],\n *   renderAndWaitForResponse: ({ args, respond, status }) => {\n *     const { meeting, date, title } = args;\n *     return (\n *       <MeetingConfirmationDialog\n *         meeting={meeting}\n *         date={date}\n *         title={title}\n *         onConfirm={() => respond('meeting confirmed')}\n *         onCancel={() => respond('meeting canceled')}\n *       />\n *     );\n *   },\n * });\n *\n * @example\n * // Catch all action allows you to render actions that are not defined in the frontend\n * useCopilotAction({\n *   name: \"*\",\n *   render: ({ name, args, status, result, handler, respond }) => {\n *     return <div>Rendering action: {name}</div>;\n *   },\n * });\n */\n\n/**\n * <img src=\"https://cdn.copilotkit.ai/docs/copilotkit/images/use-copilot-action/useCopilotAction.gif\" width=\"500\" />\n * `useCopilotAction` is a React hook that you can use in your application to provide\n * custom actions that can be called by the AI. Essentially, it allows the Copilot to\n * execute these actions contextually during a chat, based on the user's interactions\n * and needs.\n *\n * Here's how it works:\n *\n * Use `useCopilotAction` to set up actions that the Copilot can call. To provide\n * more context to the Copilot, you can provide it with a `description` (for example to explain\n * what the action does, under which conditions it can be called, etc.).\n *\n * Then you define the parameters of the action, which can be simple, e.g. primitives like strings or numbers,\n * or complex, e.g. objects or arrays.\n *\n * Finally, you provide a `handler` function that receives the parameters and returns a result.\n * CopilotKit takes care of automatically inferring the parameter types, so you get type safety\n * and autocompletion for free.\n *\n * To render a custom UI for the action, you can provide a `render()` function. This function\n * lets you render a custom component or return a string to display.\n *\n * ## Usage\n *\n * ### Simple Usage\n *\n * ```tsx\n * useCopilotAction({\n *   name: \"sayHello\",\n *   description: \"Say hello to someone.\",\n *   parameters: [\n *     {\n *       name: \"name\",\n *       type: \"string\",\n *       description: \"name of the person to say greet\",\n *     },\n *   ],\n *   handler: async ({ name }) => {\n *     alert(`Hello, ${name}!`);\n *   },\n * });\n * ```\n *\n * ## Generative UI\n *\n * This hooks enables you to dynamically generate UI elements and render them in the copilot chat. For more information, check out the [Generative UI](/guides/generative-ui) page.\n */\nimport { useEffect, useRef, useState } from \"react\";\nimport { Parameter } from \"@copilotkit/shared\";\nimport {\n  CatchAllFrontendAction,\n  FrontendAction,\n} from \"../types/frontend-action\";\nimport { useFrontendTool, UseFrontendToolArgs } from \"./use-frontend-tool\";\nimport {\n  useRenderToolCall,\n  UseRenderToolCallArgs,\n} from \"./use-render-tool-call\";\nimport {\n  useHumanInTheLoop,\n  UseHumanInTheLoopArgs,\n} from \"./use-human-in-the-loop\";\nimport { useCopilotContext } from \"../context\";\n\n// Helper to determine which component and action config to use\nfunction getActionConfig<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n) {\n  if (action.name === \"*\") {\n    return {\n      type: \"render\" as const,\n      action: action as UseRenderToolCallArgs<T>,\n    };\n  }\n\n  if (\"renderAndWaitForResponse\" in action || \"renderAndWait\" in action) {\n    let render = action.render;\n    if (!render && \"renderAndWaitForResponse\" in action) {\n      // @ts-expect-error -- renderAndWaitForResponse is deprecated, but we need to support it for backwards compatibility\n      render = action.renderAndWaitForResponse;\n    }\n    if (!render && \"renderAndWait\" in action) {\n      // @ts-expect-error -- renderAndWait is deprecated, but we need to support it for backwards compatibility\n      render = action.renderAndWait;\n    }\n\n    return {\n      type: \"hitl\" as const,\n      action: { ...action, render } as UseHumanInTheLoopArgs<T>,\n    };\n  }\n\n  if (\"available\" in action) {\n    if (action.available === \"enabled\" || action.available === \"remote\") {\n      return {\n        type: \"frontend\" as const,\n        action: action as UseFrontendToolArgs<T>,\n      };\n    }\n    if (action.available === \"frontend\" || action.available === \"disabled\") {\n      return {\n        type: \"render\" as const,\n        action: action as UseRenderToolCallArgs<T>,\n      };\n    }\n  }\n\n  if (\"handler\" in action) {\n    return {\n      type: \"frontend\" as const,\n      action: action as UseFrontendToolArgs<T>,\n    };\n  }\n\n  throw new Error(\"Invalid action configuration\");\n}\n\n/**\n * useCopilotAction is a legacy hook maintained for backwards compatibility.\n *\n * To avoid violating React's Rules of Hooks (which prohibit conditional hook calls),\n * we use a registration pattern:\n * 1. This hook registers the action configuration with the CopilotContext\n * 2. A renderer component in CopilotKit actually renders the appropriate hook wrapper\n * 3. React properly manages hook state since components are rendered, not conditionally called\n *\n * This allows action types to change between renders without corrupting React's hook state.\n */\nexport function useCopilotAction<const T extends Parameter[] | [] = []>(\n  action: FrontendAction<T> | CatchAllFrontendAction,\n  dependencies?: any[],\n): void {\n  const [initialActionConfig] = useState(getActionConfig(action));\n  const currentActionConfig = getActionConfig(action);\n\n  /**\n   * Calling hooks conditionally violates React's Rules of Hooks. This rule exists because\n   * React maintains the call stack for hooks like useEffect or useState, and conditionally\n   * calling a hook would result in inconsistent call stacks between renders.\n   *\n   * Unfortunately, useCopilotAction _has_ to conditionally call a hook based on the\n   * supplied parameters. In order to avoid breaking React's call stack tracking, while\n   * breaking the Rule of Hooks, we use a ref to store the initial action configuration\n   * and throw an error if the _configuration_ changes such that we would call a different hook.\n   */\n  if (initialActionConfig.type !== currentActionConfig.type) {\n    throw new Error(\"Action configuration changed between renders\");\n  }\n\n  switch (currentActionConfig.type) {\n    case \"render\":\n      return useRenderToolCall(currentActionConfig.action, dependencies);\n    case \"hitl\":\n      return useHumanInTheLoop(currentActionConfig.action, dependencies);\n    case \"frontend\":\n      return useFrontendTool(currentActionConfig.action, dependencies);\n    default:\n      throw new Error(\"Invalid action configuration\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAoIA,SAA4B,gBAAgB;AAkB5C,SAAS,gBACP,QACA;AACA,MAAI,OAAO,SAAS,KAAK;AACvB,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAEA,MAAI,8BAA8B,UAAU,mBAAmB,QAAQ;AACrE,QAAI,SAAS,OAAO;AACpB,QAAI,CAAC,UAAU,8BAA8B,QAAQ;AAEnD,eAAS,OAAO;AAAA,IAClB;AACA,QAAI,CAAC,UAAU,mBAAmB,QAAQ;AAExC,eAAS,OAAO;AAAA,IAClB;AAEA,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ,iCAAK,SAAL,EAAa,OAAO;AAAA,IAC9B;AAAA,EACF;AAEA,MAAI,eAAe,QAAQ;AACzB,QAAI,OAAO,cAAc,aAAa,OAAO,cAAc,UAAU;AACnE,aAAO;AAAA,QACL,MAAM;AAAA,QACN;AAAA,MACF;AAAA,IACF;AACA,QAAI,OAAO,cAAc,cAAc,OAAO,cAAc,YAAY;AACtE,aAAO;AAAA,QACL,MAAM;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,aAAa,QAAQ;AACvB,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,8BAA8B;AAChD;AAaO,SAAS,iBACd,QACA,cACM;AACN,QAAM,CAAC,mBAAmB,IAAI,SAAS,gBAAgB,MAAM,CAAC;AAC9D,QAAM,sBAAsB,gBAAgB,MAAM;AAYlD,MAAI,oBAAoB,SAAS,oBAAoB,MAAM;AACzD,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,UAAQ,oBAAoB,MAAM;AAAA,IAChC,KAAK;AACH,aAAO,kBAAkB,oBAAoB,QAAQ,YAAY;AAAA,IACnE,KAAK;AACH,aAAO,kBAAkB,oBAAoB,QAAQ,YAAY;AAAA,IACnE,KAAK;AACH,aAAO,gBAAgB,oBAAoB,QAAQ,YAAY;AAAA,IACjE;AACE,YAAM,IAAI,MAAM,8BAA8B;AAAA,EAClD;AACF;","names":[]}

package/dist/chunk-WRALJIW5.mjs

@@ -1,79 +0,0 @@
-import {
-  useToast
-} from "./chunk-ZP2IMXFY.mjs";
-
-// src/components/CopilotListeners.tsx
-import { useCallback, useEffect, useRef } from "react";
-import {
-  useAgent,
-  useCopilotChatConfiguration,
-  useCopilotKit
-} from "@copilotkitnext/react";
-import { parseJson } from "@copilotkit/shared";
-import { CopilotKitLowLevelError } from "@copilotkit/shared";
-var usePredictStateSubscription = (agent) => {
-  const predictStateToolsRef = useRef([]);
-  const getSubscriber = useCallback(
-    (agent2) => ({
-      onCustomEvent: ({ event }) => {
-        if (event.name === "PredictState") {
-          predictStateToolsRef.current = event.value;
-        }
-      },
-      onToolCallArgsEvent: ({ partialToolCallArgs, toolCallName }) => {
-        predictStateToolsRef.current.forEach((t) => {
-          if ((t == null ? void 0 : t.tool) !== toolCallName)
-            return;
-          const emittedState = typeof partialToolCallArgs === "string" ? parseJson(
-            partialToolCallArgs,
-            partialToolCallArgs
-          ) : partialToolCallArgs;
-          agent2.setState({
-            [t.state_key]: emittedState[t.state_key]
-          });
-        });
-      }
-    }),
-    []
-  );
-  useEffect(() => {
-    if (!agent)
-      return;
-    const subscriber = getSubscriber(agent);
-    const { unsubscribe } = agent.subscribe(subscriber);
-    return () => {
-      unsubscribe();
-    };
-  }, [agent, getSubscriber]);
-};
-function CopilotListeners() {
-  const { copilotkit } = useCopilotKit();
-  const existingConfig = useCopilotChatConfiguration();
-  const resolvedAgentId = existingConfig == null ? void 0 : existingConfig.agentId;
-  const { setBannerError } = useToast();
-  const { agent } = useAgent({ agentId: resolvedAgentId });
-  usePredictStateSubscription(agent);
-  useEffect(() => {
-    const subscriber = {
-      onError: ({ error }) => {
-        setBannerError(
-          new CopilotKitLowLevelError({
-            error,
-            message: error.message,
-            url: typeof window !== "undefined" ? window.location.href : ""
-          })
-        );
-      }
-    };
-    const subscription = copilotkit.subscribe(subscriber);
-    return () => {
-      subscription.unsubscribe();
-    };
-  }, [copilotkit == null ? void 0 : copilotkit.subscribe]);
-  return null;
-}
-
-export {
-  CopilotListeners
-};
-//# sourceMappingURL=chunk-WRALJIW5.mjs.map

package/dist/chunk-WRALJIW5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/CopilotListeners.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef } from \"react\";\nimport {\n  useAgent,\n  useCopilotChatConfiguration,\n  useCopilotKit,\n} from \"@copilotkitnext/react\";\nimport { CopilotKitError, parseJson } from \"@copilotkit/shared\";\nimport { useCopilotContext } from \"../context\";\nimport {\n  AbstractAgent,\n  AgentSubscriber,\n  AGUIConnectNotImplementedError,\n} from \"@ag-ui/client\";\nimport { useErrorToast } from \"./error-boundary/error-utils\";\nimport { CopilotKitCoreSubscriber } from \"@copilotkitnext/core\";\nimport { useToast } from \"./toast/toast-provider\";\nimport { CopilotKitLowLevelError } from \"@copilotkit/shared\";\n\nconst usePredictStateSubscription = (agent?: AbstractAgent) => {\n  const predictStateToolsRef = useRef<\n    {\n      tool: string;\n      state_key: string;\n      tool_argument: string;\n    }[]\n  >([]);\n\n  const getSubscriber = useCallback(\n    (agent: AbstractAgent): AgentSubscriber => ({\n      onCustomEvent: ({ event }) => {\n        if (event.name === \"PredictState\") {\n          predictStateToolsRef.current = event.value;\n        }\n      },\n      onToolCallArgsEvent: ({ partialToolCallArgs, toolCallName }) => {\n        predictStateToolsRef.current.forEach((t) => {\n          if (t?.tool !== toolCallName) return;\n\n          const emittedState =\n            typeof partialToolCallArgs === \"string\"\n              ? parseJson(\n                  partialToolCallArgs as unknown as string,\n                  partialToolCallArgs,\n                )\n              : partialToolCallArgs;\n\n          agent.setState({\n            [t.state_key]: emittedState[t.state_key],\n          });\n        });\n      },\n    }),\n    [],\n  );\n\n  useEffect(() => {\n    if (!agent) return;\n\n    const subscriber = getSubscriber(agent);\n    const { unsubscribe } = agent.subscribe(subscriber);\n    return () => {\n      unsubscribe();\n    };\n  }, [agent, getSubscriber]);\n};\n\nexport function CopilotListeners() {\n  const { copilotkit } = useCopilotKit();\n  const existingConfig = useCopilotChatConfiguration();\n  const resolvedAgentId = existingConfig?.agentId;\n  const { setBannerError } = useToast();\n\n  const { agent } = useAgent({ agentId: resolvedAgentId });\n\n  usePredictStateSubscription(agent);\n\n  useEffect(() => {\n    const subscriber: CopilotKitCoreSubscriber = {\n      onError: ({ error }) => {\n        setBannerError(\n          new CopilotKitLowLevelError({\n            error,\n            message: error.message,\n            url: typeof window !== \"undefined\" ? window.location.href : \"\",\n          }),\n        );\n      },\n    };\n    const subscription = copilotkit.subscribe(subscriber);\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [copilotkit?.subscribe]);\n\n  return null;\n}\n"],"mappings":";;;;;AAAA,SAAS,aAAa,WAAoB,cAAc;AACxD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAA0B,iBAAiB;AAU3C,SAAS,+BAA+B;AAExC,IAAM,8BAA8B,CAAC,UAA0B;AAC7D,QAAM,uBAAuB,OAM3B,CAAC,CAAC;AAEJ,QAAM,gBAAgB;AAAA,IACpB,CAACA,YAA2C;AAAA,MAC1C,eAAe,CAAC,EAAE,MAAM,MAAM;AAC5B,YAAI,MAAM,SAAS,gBAAgB;AACjC,+BAAqB,UAAU,MAAM;AAAA,QACvC;AAAA,MACF;AAAA,MACA,qBAAqB,CAAC,EAAE,qBAAqB,aAAa,MAAM;AAC9D,6BAAqB,QAAQ,QAAQ,CAAC,MAAM;AAC1C,eAAI,uBAAG,UAAS;AAAc;AAE9B,gBAAM,eACJ,OAAO,wBAAwB,WAC3B;AAAA,YACE;AAAA,YACA;AAAA,UACF,IACA;AAEN,UAAAA,OAAM,SAAS;AAAA,YACb,CAAC,EAAE,SAAS,GAAG,aAAa,EAAE,SAAS;AAAA,UACzC,CAAC;AAAA,QACH,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IACA,CAAC;AAAA,EACH;AAEA,YAAU,MAAM;AACd,QAAI,CAAC;AAAO;AAEZ,UAAM,aAAa,cAAc,KAAK;AACtC,UAAM,EAAE,YAAY,IAAI,MAAM,UAAU,UAAU;AAClD,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,OAAO,aAAa,CAAC;AAC3B;AAEO,SAAS,mBAAmB;AACjC,QAAM,EAAE,WAAW,IAAI,cAAc;AACrC,QAAM,iBAAiB,4BAA4B;AACnD,QAAM,kBAAkB,iDAAgB;AACxC,QAAM,EAAE,eAAe,IAAI,SAAS;AAEpC,QAAM,EAAE,MAAM,IAAI,SAAS,EAAE,SAAS,gBAAgB,CAAC;AAEvD,8BAA4B,KAAK;AAEjC,YAAU,MAAM;AACd,UAAM,aAAuC;AAAA,MAC3C,SAAS,CAAC,EAAE,MAAM,MAAM;AACtB;AAAA,UACE,IAAI,wBAAwB;AAAA,YAC1B;AAAA,YACA,SAAS,MAAM;AAAA,YACf,KAAK,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO;AAAA,UAC9D,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AACA,UAAM,eAAe,WAAW,UAAU,UAAU;AAEpD,WAAO,MAAM;AACX,mBAAa,YAAY;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,yCAAY,SAAS,CAAC;AAE1B,SAAO;AACT;","names":["agent"]}

package/dist/chunk-WV2EA7SX.mjs

@@ -1,65 +0,0 @@
-import {
-  __async
-} from "./chunk-SKC7AJIV.mjs";
-
-// src/lib/status-checker.ts
-import {
-  COPILOT_CLOUD_API_URL,
-  COPILOT_CLOUD_PUBLIC_API_KEY_HEADER
-} from "@copilotkit/shared";
-var STATUS_CHECK_INTERVAL = 1e3 * 60 * 5;
-var StatusChecker = class {
-  constructor() {
-    this.activeKey = null;
-    this.intervalId = null;
-    this.instanceCount = 0;
-    this.lastResponse = null;
-  }
-  start(publicApiKey, onUpdate) {
-    return __async(this, null, function* () {
-      this.instanceCount++;
-      if (this.activeKey === publicApiKey)
-        return;
-      if (this.intervalId)
-        clearInterval(this.intervalId);
-      const checkStatus = () => __async(this, null, function* () {
-        try {
-          const response = yield fetch(`${COPILOT_CLOUD_API_URL}/ciu`, {
-            method: "GET",
-            headers: {
-              [COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey
-            }
-          }).then((response2) => response2.json());
-          this.lastResponse = response;
-          onUpdate == null ? void 0 : onUpdate(response);
-          return response;
-        } catch (error) {
-          return null;
-        }
-      });
-      const initialResponse = yield checkStatus();
-      this.intervalId = setInterval(checkStatus, STATUS_CHECK_INTERVAL);
-      this.activeKey = publicApiKey;
-      return initialResponse;
-    });
-  }
-  getLastResponse() {
-    return this.lastResponse;
-  }
-  stop() {
-    this.instanceCount--;
-    if (this.instanceCount === 0) {
-      if (this.intervalId) {
-        clearInterval(this.intervalId);
-        this.intervalId = null;
-        this.activeKey = null;
-        this.lastResponse = null;
-      }
-    }
-  }
-};
-
-export {
-  StatusChecker
-};
-//# sourceMappingURL=chunk-WV2EA7SX.mjs.map

package/dist/chunk-WV2EA7SX.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/status-checker.ts"],"sourcesContent":["import {\n  COPILOT_CLOUD_API_URL,\n  COPILOT_CLOUD_PUBLIC_API_KEY_HEADER,\n  Severity,\n} from \"@copilotkit/shared\";\n\nconst STATUS_CHECK_INTERVAL = 1000 * 60 * 5; // 5 minutes\n\nexport type Status = {\n  severity: Severity;\n  message: string;\n};\n\nexport class StatusChecker {\n  private activeKey: string | null = null;\n  private intervalId: ReturnType<typeof setInterval> | null = null;\n  private instanceCount = 0;\n  private lastResponse: Status | null = null;\n\n  async start(\n    publicApiKey: string,\n    onUpdate?: (status: Status | null) => void,\n  ) {\n    this.instanceCount++;\n    if (this.activeKey === publicApiKey) return;\n\n    if (this.intervalId) clearInterval(this.intervalId);\n\n    const checkStatus = async () => {\n      try {\n        const response = await fetch(`${COPILOT_CLOUD_API_URL}/ciu`, {\n          method: \"GET\",\n          headers: {\n            [COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey,\n          },\n        }).then((response) => response.json() as Promise<Status>);\n        this.lastResponse = response;\n        onUpdate?.(response);\n        return response;\n      } catch (error) {\n        // Silently fail\n        return null;\n      }\n    };\n\n    const initialResponse = await checkStatus();\n    this.intervalId = setInterval(checkStatus, STATUS_CHECK_INTERVAL);\n    this.activeKey = publicApiKey;\n    return initialResponse;\n  }\n\n  getLastResponse() {\n    return this.lastResponse;\n  }\n\n  stop() {\n    this.instanceCount--;\n    if (this.instanceCount === 0) {\n      if (this.intervalId) {\n        clearInterval(this.intervalId);\n        this.intervalId = null;\n        this.activeKey = null;\n        this.lastResponse = null;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAEP,IAAM,wBAAwB,MAAO,KAAK;AAOnC,IAAM,gBAAN,MAAoB;AAAA,EAApB;AACL,SAAQ,YAA2B;AACnC,SAAQ,aAAoD;AAC5D,SAAQ,gBAAgB;AACxB,SAAQ,eAA8B;AAAA;AAAA,EAEhC,MACJ,cACA,UACA;AAAA;AACA,WAAK;AACL,UAAI,KAAK,cAAc;AAAc;AAErC,UAAI,KAAK;AAAY,sBAAc,KAAK,UAAU;AAElD,YAAM,cAAc,MAAY;AAC9B,YAAI;AACF,gBAAM,WAAW,MAAM,MAAM,GAAG,6BAA6B;AAAA,YAC3D,QAAQ;AAAA,YACR,SAAS;AAAA,cACP,CAAC,mCAAmC,GAAG;AAAA,YACzC;AAAA,UACF,CAAC,EAAE,KAAK,CAACA,cAAaA,UAAS,KAAK,CAAoB;AACxD,eAAK,eAAe;AACpB,+CAAW;AACX,iBAAO;AAAA,QACT,SAAS,OAAP;AAEA,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,YAAM,kBAAkB,MAAM,YAAY;AAC1C,WAAK,aAAa,YAAY,aAAa,qBAAqB;AAChE,WAAK,YAAY;AACjB,aAAO;AAAA,IACT;AAAA;AAAA,EAEA,kBAAkB;AAChB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO;AACL,SAAK;AACL,QAAI,KAAK,kBAAkB,GAAG;AAC5B,UAAI,KAAK,YAAY;AACnB,sBAAc,KAAK,UAAU;AAC7B,aAAK,aAAa;AAClB,aAAK,YAAY;AACjB,aAAK,eAAe;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AACF;","names":["response"]}

package/dist/chunk-Z6JV2LRY.mjs

@@ -1,37 +0,0 @@
-// src/hooks/use-copilot-readable.ts
-import { useCopilotKit } from "@copilotkitnext/react";
-import { useEffect, useRef } from "react";
-function useCopilotReadable({ description, value, convert, available }, dependencies) {
-  const { copilotkit } = useCopilotKit();
-  const ctxIdRef = useRef(void 0);
-  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({
-      description,
-      value: (convert != null ? convert : JSON.stringify)(value)
-    });
-    return () => {
-      if (!ctxIdRef.current)
-        return;
-      copilotkit.removeContext(ctxIdRef.current);
-    };
-  }, [description, value, convert]);
-  return ctxIdRef.current;
-}
-
-export {
-  useCopilotReadable
-};
-//# sourceMappingURL=chunk-Z6JV2LRY.mjs.map

package/dist/chunk-Z6JV2LRY.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-copilot-readable.ts"],"sourcesContent":["/**\n * `useCopilotReadable` is a React hook that provides app-state and other information\n * to the Copilot. Optionally, the hook can also handle hierarchical state within your\n * application, passing these parent-child relationships to the Copilot.\n *\n * ## Usage\n *\n * ### Simple Usage\n *\n * In its most basic usage, useCopilotReadable accepts a single string argument\n * representing any piece of app state, making it available for the Copilot to use\n * as context when responding to user input.\n *\n * ```tsx\n * import { useCopilotReadable } from \"@copilotkit/react-core\";\n *\n * export function MyComponent() {\n *   const [employees, setEmployees] = useState([]);\n *\n *   useCopilotReadable({\n *     description: \"The list of employees\",\n *     value: employees,\n *   });\n * }\n * ```\n *\n * ### Nested Components\n *\n * Optionally, you can maintain the hierarchical structure of information by passing\n * `parentId`. This allows you to use `useCopilotReadable` in nested components:\n *\n * ```tsx /employeeContextId/1 {17,23}\n * import { useCopilotReadable } from \"@copilotkit/react-core\";\n *\n * function Employee(props: EmployeeProps) {\n *   const { employeeName, workProfile, metadata } = props;\n *\n *   // propagate any information to copilot\n *   const employeeContextId = useCopilotReadable({\n *     description: \"Employee name\",\n *     value: employeeName\n *   });\n *\n *   // Pass a parentID to maintain a hierarchical structure.\n *   // Especially useful with child React components, list elements, etc.\n *   useCopilotReadable({\n *     description: \"Work profile\",\n *     value: workProfile.description(),\n *     parentId: employeeContextId\n *   });\n *\n *   useCopilotReadable({\n *     description: \"Employee metadata\",\n *     value: metadata.description(),\n *     parentId: employeeContextId\n *   });\n *\n *   return (\n *     // Render as usual...\n *   );\n * }\n * ```\n */\nimport { useCopilotKit } from \"@copilotkitnext/react\";\nimport { useEffect, useRef } from \"react\";\n\n/**\n * Options for the useCopilotReadable hook.\n */\nexport interface UseCopilotReadableOptions {\n  /**\n   * The description of the information to be added to the Copilot context.\n   */\n  description: string;\n  /**\n   * The value to be added to the Copilot context. Object values are automatically stringified.\n   */\n  value: any;\n  /**\n   * The ID of the parent context, if any.\n   */\n  parentId?: string;\n  /**\n   * An array of categories to control which context are visible where. Particularly useful\n   * with CopilotTextarea (see `useMakeAutosuggestionFunction`)\n   */\n  categories?: string[];\n\n  /**\n   * Whether the context is available to the Copilot.\n   */\n  available?: \"enabled\" | \"disabled\";\n\n  /**\n   * A custom conversion function to use to serialize the value to a string. If not provided, the value\n   * will be serialized using `JSON.stringify`.\n   */\n  convert?: (description: string, value: any) => string;\n}\n\n/**\n * Adds the given information to the Copilot context to make it readable by Copilot.\n */\nexport function useCopilotReadable(\n  { description, value, convert, available }: UseCopilotReadableOptions,\n  dependencies?: any[],\n): string | undefined {\n  const { copilotkit } = useCopilotKit();\n  const ctxIdRef = useRef<string | undefined>(undefined);\n  useEffect(() => {\n    if (!copilotkit) return;\n\n    const found = Object.entries(copilotkit.context).find(([id, ctxItem]) => {\n      return JSON.stringify({ description, value }) == JSON.stringify(ctxItem);\n    });\n    if (found) {\n      ctxIdRef.current = found[0];\n      if (available === \"disabled\") copilotkit.removeContext(ctxIdRef.current);\n      return;\n    }\n    if (!found && available === \"disabled\") return;\n\n    ctxIdRef.current = copilotkit.addContext({\n      description,\n      value: (convert ?? JSON.stringify)(value),\n    });\n\n    return () => {\n      if (!ctxIdRef.current) return;\n      copilotkit.removeContext(ctxIdRef.current);\n    };\n  }, [description, value, convert]);\n\n  return ctxIdRef.current;\n}\n"],"mappings":";AA+DA,SAAS,qBAAqB;AAC9B,SAAS,WAAW,cAAc;AAuC3B,SAAS,mBACd,EAAE,aAAa,OAAO,SAAS,UAAU,GACzC,cACoB;AACpB,QAAM,EAAE,WAAW,IAAI,cAAc;AACrC,QAAM,WAAW,OAA2B,MAAS;AACrD,YAAU,MAAM;AACd,QAAI,CAAC;AAAY;AAEjB,UAAM,QAAQ,OAAO,QAAQ,WAAW,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,OAAO,MAAM;AACvE,aAAO,KAAK,UAAU,EAAE,aAAa,MAAM,CAAC,KAAK,KAAK,UAAU,OAAO;AAAA,IACzE,CAAC;AACD,QAAI,OAAO;AACT,eAAS,UAAU,MAAM,CAAC;AAC1B,UAAI,cAAc;AAAY,mBAAW,cAAc,SAAS,OAAO;AACvE;AAAA,IACF;AACA,QAAI,CAAC,SAAS,cAAc;AAAY;AAExC,aAAS,UAAU,WAAW,WAAW;AAAA,MACvC;AAAA,MACA,QAAQ,4BAAW,KAAK,WAAW,KAAK;AAAA,IAC1C,CAAC;AAED,WAAO,MAAM;AACX,UAAI,CAAC,SAAS;AAAS;AACvB,iBAAW,cAAc,SAAS,OAAO;AAAA,IAC3C;AAAA,EACF,GAAG,CAAC,aAAa,OAAO,OAAO,CAAC;AAEhC,SAAO,SAAS;AAClB;","names":[]}