@copilotkit/react-core 1.57.3 → 1.58.0

package/src/components/copilot-provider/copilotkit.tsx

@@ -1,853 +0,0 @@
-/**
- * This component will typically wrap your entire application (or a sub-tree of your application where you want to have a copilot). It provides the copilot context to all other components and hooks.
- *
- * ## Example
- *
- * You can find more information about self-hosting CopilotKit [here](/guides/self-hosting).
- *
- * ```tsx
- * import { CopilotKit } from "@copilotkit/react-core";
- *
- * <CopilotKit runtimeUrl="<your-runtime-url>">
- *   // ... your app ...
- * </CopilotKit>
- * ```
- */
-
-import React, {
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-  useState,
-  SetStateAction,
-} from "react";
-import {
-  CopilotChatConfigurationProvider,
-  CopilotKitInspector,
-  CopilotKitProvider as CopilotKitV2Provider,
-  useCopilotKit,
-} from "../../v2";
-import {
-  CopilotContext,
-  CopilotApiConfig,
-  ChatComponentsCache,
-  AgentSession,
-  AuthState,
-  useCopilotContext,
-} from "../../context/copilot-context";
-import useTree from "../../hooks/use-tree";
-import {
-  CopilotChatSuggestionConfiguration,
-  DocumentPointer,
-} from "../../types";
-import { flushSync } from "react-dom";
-import {
-  COPILOT_CLOUD_CHAT_URL,
-  CopilotCloudConfig,
-  FunctionCallHandler,
-  COPILOT_CLOUD_PUBLIC_API_KEY_HEADER,
-  randomUUID,
-  ConfigurationError,
-  MissingPublicApiKeyError,
-  CopilotKitError,
-  CopilotErrorEvent,
-  CopilotErrorHandler,
-} from "@copilotkit/shared";
-import { FrontendAction } from "../../types/frontend-action";
-import useFlatCategoryStore from "../../hooks/use-flat-category-store";
-import { CopilotKitProps } from "./copilotkit-props";
-import { CoagentState } from "../../types/coagent-state";
-import { CopilotMessages, MessagesTapProvider } from "./copilot-messages";
-import { ToastProvider } from "../toast/toast-provider";
-import { getErrorActions, UsageBanner } from "../usage-banner";
-import { shouldShowDevConsole } from "../../utils";
-import { CopilotErrorBoundary } from "../error-boundary/error-boundary";
-import { Agent, ExtensionsInput } from "@copilotkit/runtime-client-gql";
-import {
-  LangGraphInterruptRender,
-  LangGraphInterruptActionSetterArgs,
-  QueuedInterruptEvent,
-} from "../../types/interrupt-action";
-import { CoAgentStateRendersProvider } from "../../context/coagent-state-renders-context";
-import { CoAgentStateRenderBridge } from "../../hooks/use-coagent-state-render-bridge";
-import { ThreadsProvider, useThreads } from "../../context/threads-context";
-import { CopilotListeners } from "../CopilotListeners";
-
-export function CopilotKit({ children, ...props }: CopilotKitProps) {
-  const enabled = shouldShowDevConsole(props.showDevConsole);
-  const showInspector = shouldShowDevConsole(props.enableInspector);
-
-  // Use API key if provided, otherwise use the license key
-  const publicApiKey = props.publicApiKey || props.publicLicenseKey;
-
-  const renderArr = useMemo(() => [{ render: CoAgentStateRenderBridge }], []);
-
-  return (
-    <ToastProvider enabled={enabled}>
-      <CopilotErrorBoundary
-        publicApiKey={publicApiKey}
-        showUsageBanner={enabled}
-      >
-        <ThreadsProvider threadId={props.threadId}>
-          <CopilotKitV2Provider
-            {...props}
-            showDevConsole={showInspector}
-            renderCustomMessages={renderArr}
-            useSingleEndpoint={props.useSingleEndpoint ?? true}
-          >
-            <CopilotKitInternal {...props}>{children}</CopilotKitInternal>
-          </CopilotKitV2Provider>
-        </ThreadsProvider>
-      </CopilotErrorBoundary>
-    </ToastProvider>
-  );
-}
-
-/**
- * Bridge component that subscribes to v2.x copilotkit core error events
- * and forwards them to v1.x error handling system.
- * This ensures only ONE subscription exists regardless of how many times
- * Chat components are rendered.
- */
-function CopilotKitErrorBridge() {
-  const { copilotkit } = useCopilotKit();
-  const { onError, copilotApiConfig } = useCopilotContext();
-
-  useEffect(() => {
-    if (!copilotkit) return;
-
-    const subscription = copilotkit.subscribe({
-      onError: async (event) => {
-        // Convert v2.x error event to v1.x CopilotErrorEvent format
-        const errorEvent: CopilotErrorEvent = {
-          type: "error",
-          timestamp: Date.now(),
-          context: {
-            source: "agent",
-            request: {
-              operation: event.code || "unknown",
-              url: copilotApiConfig?.chatApiEndpoint,
-              startTime: Date.now(),
-            },
-            technical: {
-              environment: "browser",
-              userAgent:
-                typeof navigator !== "undefined"
-                  ? navigator.userAgent
-                  : undefined,
-              stackTrace: event.error.stack,
-            },
-            // Add additional context from v2.x event
-            ...event.context,
-          },
-          error: event.error,
-        };
-
-        try {
-          await onError(errorEvent);
-        } catch (handlerError) {
-          console.error("Error in onError handler:", handlerError);
-        }
-      },
-    });
-
-    return () => {
-      subscription.unsubscribe();
-    };
-  }, [copilotkit, onError, copilotApiConfig]);
-
-  return null;
-}
-
-export function CopilotKitInternal(cpkProps: CopilotKitProps) {
-  const { children, ...props } = cpkProps;
-
-  /**
-   * This will throw an error if the props are invalid.
-   */
-  validateProps(cpkProps);
-
-  // Use license key as API key if provided, otherwise use the API key
-  const publicApiKey = props.publicLicenseKey || props.publicApiKey;
-
-  const chatApiEndpoint = props.runtimeUrl || COPILOT_CLOUD_CHAT_URL;
-
-  const [actions, setActions] = useState<Record<string, FrontendAction<any>>>(
-    {},
-  );
-
-  // State for registered actions from useCopilotAction
-  const [registeredActionConfigs, setRegisteredActionConfigs] = useState<
-    Map<string, { type: string; action: any; component: any }>
-  >(new Map());
-
-  const chatComponentsCache = useRef<ChatComponentsCache>({
-    actions: {},
-    coAgentStateRenders: {},
-  });
-
-  const { addElement, removeElement, printTree, getAllElements } = useTree();
-  const [isLoading, setIsLoading] = useState(false);
-  const [chatInstructions, setChatInstructions] = useState("");
-  const [authStates, setAuthStates] = useState<Record<string, AuthState>>({});
-  const [extensions, setExtensions] = useState<ExtensionsInput>({});
-  const [additionalInstructions, setAdditionalInstructions] = useState<
-    string[]
-  >([]);
-
-  const {
-    addElement: addDocument,
-    removeElement: removeDocument,
-    allElements: allDocuments,
-  } = useFlatCategoryStore<DocumentPointer>();
-
-  // Compute all the functions and properties that we need to pass
-  const setAction = useCallback((id: string, action: FrontendAction<any>) => {
-    setActions((prevPoints) => {
-      return {
-        ...prevPoints,
-        [id]: action,
-      };
-    });
-  }, []);
-
-  const removeAction = useCallback((id: string) => {
-    setActions((prevPoints) => {
-      const newPoints = { ...prevPoints };
-      delete newPoints[id];
-      return newPoints;
-    });
-  }, []);
-
-  const getContextString = useCallback(
-    (documents: DocumentPointer[], categories: string[]) => {
-      const documentsString = documents
-        .map((document) => {
-          return `${document.name} (${document.sourceApplication}):\n${document.getContents()}`;
-        })
-        .join("\n\n");
-
-      const nonDocumentStrings = printTree(categories);
-
-      return `${documentsString}\n\n${nonDocumentStrings}`;
-    },
-    [printTree],
-  );
-
-  const addContext = useCallback(
-    (
-      context: string,
-      parentId?: string,
-      categories: string[] = defaultCopilotContextCategories,
-    ) => {
-      return addElement(context, categories, parentId);
-    },
-    [addElement],
-  );
-
-  const removeContext = useCallback(
-    (id: string) => {
-      removeElement(id);
-    },
-    [removeElement],
-  );
-
-  const getAllContext = useCallback(() => {
-    return getAllElements();
-  }, [getAllElements]);
-
-  const getFunctionCallHandler = useCallback(
-    (customEntryPoints?: Record<string, FrontendAction<any>>) => {
-      return entryPointsToFunctionCallHandler(
-        Object.values(customEntryPoints || actions),
-      );
-    },
-    [actions],
-  );
-
-  const getDocumentsContext = useCallback(
-    (categories: string[]) => {
-      return allDocuments(categories);
-    },
-    [allDocuments],
-  );
-
-  const addDocumentContext = useCallback(
-    (
-      documentPointer: DocumentPointer,
-      categories: string[] = defaultCopilotContextCategories,
-    ) => {
-      return addDocument(documentPointer, categories);
-    },
-    [addDocument],
-  );
-
-  const removeDocumentContext = useCallback(
-    (documentId: string) => {
-      removeDocument(documentId);
-    },
-    [removeDocument],
-  );
-
-  // get the appropriate CopilotApiConfig from the props
-  const copilotApiConfig: CopilotApiConfig = useMemo(() => {
-    let cloud: CopilotCloudConfig | undefined = undefined;
-    if (publicApiKey) {
-      cloud = {
-        guardrails: {
-          input: {
-            restrictToTopic: {
-              enabled: Boolean(props.guardrails_c),
-              validTopics: props.guardrails_c?.validTopics || [],
-              invalidTopics: props.guardrails_c?.invalidTopics || [],
-            },
-          },
-        },
-      };
-    }
-
-    return {
-      publicApiKey: publicApiKey,
-      ...(cloud ? { cloud } : {}),
-      chatApiEndpoint: chatApiEndpoint,
-      headers:
-        typeof props.headers === "function"
-          ? props.headers()
-          : props.headers || {},
-      properties: props.properties || {},
-      transcribeAudioUrl: props.transcribeAudioUrl,
-      textToSpeechUrl: props.textToSpeechUrl,
-      credentials: props.credentials,
-    };
-  }, [
-    publicApiKey,
-    props.headers,
-    props.properties,
-    props.transcribeAudioUrl,
-    props.textToSpeechUrl,
-    props.credentials,
-    props.cloudRestrictToTopic,
-    props.guardrails_c,
-  ]);
-
-  const headers = useMemo(() => {
-    const authHeaders = Object.values(authStates || {}).reduce((acc, state) => {
-      if (state.status === "authenticated" && state.authHeaders) {
-        return {
-          ...acc,
-          ...Object.entries(state.authHeaders).reduce(
-            (headers, [key, value]) => ({
-              ...headers,
-              [key.startsWith("X-Custom-") ? key : `X-Custom-${key}`]: value,
-            }),
-            {},
-          ),
-        };
-      }
-      return acc;
-    }, {});
-
-    return {
-      ...copilotApiConfig.headers,
-      ...(copilotApiConfig.publicApiKey
-        ? {
-            [COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]:
-              copilotApiConfig.publicApiKey,
-          }
-        : {}),
-      ...authHeaders,
-    };
-  }, [copilotApiConfig.headers, copilotApiConfig.publicApiKey, authStates]);
-
-  const [internalErrorHandlers, _setInternalErrorHandler] = useState<
-    Record<string, CopilotErrorHandler>
-  >({});
-  const setInternalErrorHandler = useCallback(
-    (handler: Record<string, CopilotErrorHandler>) => {
-      _setInternalErrorHandler((prev: Record<string, CopilotErrorHandler>) => ({
-        ...prev,
-        ...handler,
-      }));
-    },
-    [],
-  );
-  const removeInternalErrorHandler = useCallback((key: string) => {
-    _setInternalErrorHandler((prev) => {
-      const { [key]: _removed, ...rest } = prev;
-      return rest;
-    });
-  }, []);
-
-  // Keep latest values in refs
-  const onErrorRef = useRef<CopilotErrorHandler | undefined>(props.onError);
-  useEffect(() => {
-    onErrorRef.current = props.onError;
-  }, [props.onError]);
-
-  const internalHandlersRef = useRef<Record<string, CopilotErrorHandler>>({});
-  useEffect(() => {
-    internalHandlersRef.current = internalErrorHandlers;
-  }, [internalErrorHandlers]);
-
-  const handleErrors = useCallback(
-    async (error: CopilotErrorEvent) => {
-      if (copilotApiConfig.publicApiKey && onErrorRef.current) {
-        try {
-          await onErrorRef.current(error);
-        } catch (e) {
-          console.error("Error in public onError handler:", e);
-        }
-      }
-      const handlers = Object.values(internalHandlersRef.current);
-      await Promise.all(
-        handlers.map((h) =>
-          Promise.resolve(h(error)).catch((e) =>
-            console.error("Error in internal error handler:", e),
-          ),
-        ),
-      );
-    },
-    [copilotApiConfig.publicApiKey],
-  );
-
-  const [chatSuggestionConfiguration, setChatSuggestionConfiguration] =
-    useState<{
-      [key: string]: CopilotChatSuggestionConfiguration;
-    }>({});
-
-  const addChatSuggestionConfiguration = useCallback(
-    (id: string, suggestion: CopilotChatSuggestionConfiguration) => {
-      setChatSuggestionConfiguration((prev) => ({ ...prev, [id]: suggestion }));
-    },
-    [setChatSuggestionConfiguration],
-  );
-
-  const removeChatSuggestionConfiguration = useCallback(
-    (id: string) => {
-      setChatSuggestionConfiguration((prev) => {
-        const { [id]: _, ...rest } = prev;
-        return rest;
-      });
-    },
-    [setChatSuggestionConfiguration],
-  );
-
-  const [availableAgents, setAvailableAgents] = useState<Agent[]>([]);
-  const [coagentStates, setCoagentStates] = useState<
-    Record<string, CoagentState>
-  >({});
-  const coagentStatesRef = useRef<Record<string, CoagentState>>({});
-  const setCoagentStatesWithRef = useCallback(
-    (
-      value:
-        | Record<string, CoagentState>
-        | ((
-            prev: Record<string, CoagentState>,
-          ) => Record<string, CoagentState>),
-    ) => {
-      const newValue =
-        typeof value === "function" ? value(coagentStatesRef.current) : value;
-      coagentStatesRef.current = newValue;
-      setCoagentStates((prev) => {
-        return newValue;
-      });
-    },
-    [],
-  );
-
-  let initialAgentSession: AgentSession | null = null;
-  if (props.agent) {
-    initialAgentSession = {
-      agentName: props.agent,
-    };
-  }
-
-  const [agentSession, setAgentSession] = useState<AgentSession | null>(
-    initialAgentSession,
-  );
-
-  // Update agentSession when props.agent changes
-  useEffect(() => {
-    if (props.agent) {
-      setAgentSession({
-        agentName: props.agent,
-      });
-    } else {
-      setAgentSession(null);
-    }
-  }, [props.agent]);
-
-  const {
-    threadId,
-    setThreadId: setInternalThreadId,
-    isThreadIdExplicit,
-  } = useThreads();
-
-  const setThreadId = useCallback(
-    (value: SetStateAction<string>) => {
-      if (props.threadId) {
-        throw new Error(
-          "Cannot call setThreadId() when threadId is provided via props.",
-        );
-      }
-      setInternalThreadId(value);
-    },
-    [props.threadId],
-  );
-
-  const [runId, setRunId] = useState<string | null>(null);
-
-  const chatAbortControllerRef = useRef<AbortController | null>(null);
-
-  const showDevConsole = shouldShowDevConsole(props.showDevConsole);
-
-  const [interruptActions, _setInterruptActions] = useState<
-    Record<string, LangGraphInterruptRender>
-  >({});
-  const setInterruptAction = useCallback(
-    (action: LangGraphInterruptActionSetterArgs) => {
-      _setInterruptActions((prev) => {
-        if (action == null || !action.id) {
-          // Cannot set action without id
-          return prev;
-        }
-        return {
-          ...prev,
-          [action.id]: {
-            ...prev[action.id],
-            ...action,
-          } as LangGraphInterruptRender,
-        };
-      });
-    },
-    [],
-  );
-  const removeInterruptAction = useCallback((actionId: string): void => {
-    _setInterruptActions((prev) => {
-      const { [actionId]: _, ...rest } = prev;
-      return rest;
-    });
-  }, []);
-
-  const [interruptEventQueue, setInterruptEventQueue] = useState<
-    Record<string, QueuedInterruptEvent[]>
-  >({});
-
-  const addInterruptEvent = useCallback((queuedEvent: QueuedInterruptEvent) => {
-    setInterruptEventQueue((prev) => {
-      const threadQueue = prev[queuedEvent.threadId] || [];
-      return {
-        ...prev,
-        [queuedEvent.threadId]: [...threadQueue, queuedEvent],
-      };
-    });
-  }, []);
-
-  const resolveInterruptEvent = useCallback(
-    (threadId: string, eventId: string, response: string) => {
-      setInterruptEventQueue((prev) => {
-        const threadQueue = prev[threadId] || [];
-        return {
-          ...prev,
-          [threadId]: threadQueue.map((queuedEvent) =>
-            queuedEvent.eventId === eventId
-              ? { ...queuedEvent, event: { ...queuedEvent.event, response } }
-              : queuedEvent,
-          ),
-        };
-      });
-    },
-    [],
-  );
-
-  const memoizedChildren = useMemo(() => children, [children]);
-  const [bannerError, setBannerError] = useState<CopilotKitError | null>(null);
-
-  const agentLock = useMemo(() => props.agent ?? null, [props.agent]);
-
-  const forwardedParameters = useMemo(
-    () => props.forwardedParameters ?? {},
-    [props.forwardedParameters],
-  );
-
-  const updateExtensions = useCallback(
-    (newExtensions: SetStateAction<ExtensionsInput>) => {
-      setExtensions((prev: ExtensionsInput) => {
-        const resolved =
-          typeof newExtensions === "function"
-            ? newExtensions(prev)
-            : newExtensions;
-        const isSameLength =
-          Object.keys(resolved).length === Object.keys(prev).length;
-        const isEqual =
-          isSameLength &&
-          // @ts-ignore
-          Object.entries(resolved).every(([key, value]) => prev[key] === value);
-
-        return isEqual ? prev : resolved;
-      });
-    },
-    [setExtensions],
-  );
-
-  const updateAuthStates = useCallback(
-    (newAuthStates: SetStateAction<Record<string, AuthState>>) => {
-      setAuthStates((prev) => {
-        const resolved =
-          typeof newAuthStates === "function"
-            ? newAuthStates(prev)
-            : newAuthStates;
-        const isSameLength =
-          Object.keys(resolved).length === Object.keys(prev).length;
-        const isEqual =
-          isSameLength &&
-          // @ts-ignore
-          Object.entries(resolved).every(([key, value]) => prev[key] === value);
-
-        return isEqual ? prev : resolved;
-      });
-    },
-    [setAuthStates],
-  );
-
-  const handleSetRegisteredActions = useCallback(
-    (actionConfig: any): string => {
-      const key = actionConfig.action.name || randomUUID();
-      setRegisteredActionConfigs((prev) => {
-        const newMap = new Map(prev);
-        newMap.set(key, actionConfig);
-        return newMap;
-      });
-      return key;
-    },
-    [],
-  );
-
-  const handleRemoveRegisteredAction = useCallback((actionKey: string) => {
-    setRegisteredActionConfigs((prev) => {
-      const newMap = new Map(prev);
-      newMap.delete(actionKey);
-      return newMap;
-    });
-  }, []);
-
-  // Component to render all registered actions
-  const RegisteredActionsRenderer = useMemo(() => {
-    return () => (
-      <>
-        {Array.from(registeredActionConfigs.entries()).map(([key, config]) => {
-          const Component = config.component;
-          return <Component key={key} action={config.action} />;
-        })}
-      </>
-    );
-  }, [registeredActionConfigs]);
-
-  const copilotContextValue = useMemo(
-    () => ({
-      actions,
-      chatComponentsCache,
-      getFunctionCallHandler,
-      setAction,
-      removeAction,
-      setRegisteredActions: handleSetRegisteredActions,
-      removeRegisteredAction: handleRemoveRegisteredAction,
-      getContextString,
-      addContext,
-      removeContext,
-      getAllContext,
-      getDocumentsContext,
-      addDocumentContext,
-      removeDocumentContext,
-      copilotApiConfig: copilotApiConfig,
-      isLoading,
-      setIsLoading,
-      chatSuggestionConfiguration,
-      addChatSuggestionConfiguration,
-      removeChatSuggestionConfiguration,
-      chatInstructions,
-      setChatInstructions,
-      additionalInstructions,
-      setAdditionalInstructions,
-      showDevConsole,
-      coagentStates,
-      setCoagentStates,
-      coagentStatesRef,
-      setCoagentStatesWithRef,
-      agentSession,
-      setAgentSession,
-      forwardedParameters,
-      agentLock,
-      threadId,
-      setThreadId,
-      runId,
-      setRunId,
-      chatAbortControllerRef,
-      availableAgents,
-      authConfig_c: props.authConfig_c,
-      authStates_c: authStates,
-      setAuthStates_c: updateAuthStates,
-      extensions,
-      setExtensions: updateExtensions,
-      interruptActions,
-      setInterruptAction,
-      removeInterruptAction,
-      interruptEventQueue,
-      addInterruptEvent,
-      resolveInterruptEvent,
-      bannerError,
-      setBannerError,
-      onError: handleErrors,
-      internalErrorHandlers,
-      setInternalErrorHandler,
-      removeInternalErrorHandler,
-    }),
-    [
-      actions,
-      chatComponentsCache,
-      getFunctionCallHandler,
-      setAction,
-      removeAction,
-      handleSetRegisteredActions,
-      handleRemoveRegisteredAction,
-      getContextString,
-      addContext,
-      removeContext,
-      getAllContext,
-      getDocumentsContext,
-      addDocumentContext,
-      removeDocumentContext,
-      copilotApiConfig,
-      isLoading,
-      chatSuggestionConfiguration,
-      addChatSuggestionConfiguration,
-      removeChatSuggestionConfiguration,
-      chatInstructions,
-      additionalInstructions,
-      showDevConsole,
-      coagentStates,
-      setCoagentStatesWithRef,
-      agentSession,
-      setAgentSession,
-      forwardedParameters,
-      agentLock,
-      threadId,
-      setThreadId,
-      runId,
-      availableAgents,
-      props.authConfig_c,
-      authStates,
-      updateAuthStates,
-      extensions,
-      updateExtensions,
-      interruptActions,
-      setInterruptAction,
-      removeInterruptAction,
-      interruptEventQueue,
-      addInterruptEvent,
-      resolveInterruptEvent,
-      bannerError,
-      handleErrors,
-      internalErrorHandlers,
-      setInternalErrorHandler,
-      removeInternalErrorHandler,
-    ],
-  );
-
-  return (
-    <CopilotChatConfigurationProvider
-      // labels={labels}
-      // isModalDefaultOpen={isModalDefaultOpen}
-      agentId={props.agent ?? "default"}
-      threadId={threadId}
-      hasExplicitThreadId={isThreadIdExplicit}
-    >
-      <CopilotContext.Provider value={copilotContextValue}>
-        <CopilotListeners />
-        <CopilotKitErrorBridge />
-        <CoAgentStateRendersProvider>
-          <MessagesTapProvider>
-            <CopilotMessages>
-              <React.Fragment key="children">{memoizedChildren}</React.Fragment>
-              <RegisteredActionsRenderer key="actions" />
-            </CopilotMessages>
-          </MessagesTapProvider>
-          {bannerError && showDevConsole && (
-            <UsageBanner
-              severity={bannerError.severity}
-              message={bannerError.message}
-              onClose={() => setBannerError(null)}
-              actions={getErrorActions(bannerError)}
-            />
-          )}
-        </CoAgentStateRendersProvider>
-      </CopilotContext.Provider>
-    </CopilotChatConfigurationProvider>
-  );
-}
-
-export const defaultCopilotContextCategories = ["global"];
-
-function entryPointsToFunctionCallHandler(
-  actions: FrontendAction<any>[],
-): FunctionCallHandler {
-  return async ({
-    name,
-    args,
-  }: {
-    name: string;
-    args: Record<string, any>;
-  }) => {
-    let actionsByFunctionName: Record<string, FrontendAction<any>> = {};
-    for (let action of actions) {
-      actionsByFunctionName[action.name] = action;
-    }
-
-    const action = actionsByFunctionName[name];
-    let result: any = undefined;
-    if (action) {
-      await new Promise<void>((resolve, reject) => {
-        flushSync(async () => {
-          try {
-            result = await action.handler?.(args);
-            resolve();
-          } catch (error) {
-            reject(error);
-          }
-        });
-      });
-      await new Promise((resolve) => setTimeout(resolve, 20));
-    }
-    return result;
-  };
-}
-
-function formatFeatureName(featureName: string): string {
-  return featureName
-    .replace(/_c$/, "")
-    .split("_")
-    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-    .join(" ");
-}
-
-function validateProps(props: CopilotKitProps): never | void {
-  const cloudFeatures = Object.keys(props).filter((key) => key.endsWith("_c"));
-
-  // Check if we have either a runtimeUrl or one of the API keys
-  const hasApiKey = props.publicApiKey || props.publicLicenseKey;
-
-  if (!props.runtimeUrl && !hasApiKey) {
-    throw new ConfigurationError(
-      "Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'",
-    );
-  }
-
-  if (cloudFeatures.length > 0 && !hasApiKey) {
-    throw new MissingPublicApiKeyError(
-      `Missing required prop: 'publicApiKey' or 'publicLicenseKey' to use cloud features: ${cloudFeatures
-        .map(formatFeatureName)
-        .join(", ")}`,
-    );
-  }
-}