@copilotkitnext/react 0.0.30 → 0.0.31

package/dist/index.d.mts

@@ -632,6 +632,14 @@ interface CopilotKitProviderProps {
     children: ReactNode;
     runtimeUrl?: string;
     headers?: Record<string, string>;
+    /**
+     * The Copilot Cloud public API key.
+     */
+    publicApiKey?: string;
+    /**
+     * Alias for `publicApiKey`
+     **/
+    publicLicenseKey?: string;
     properties?: Record<string, unknown>;
     useSingleEndpoint?: boolean;
     agents__unsafe_dev_only?: Record<string, AbstractAgent>;

package/dist/index.d.ts

@@ -632,6 +632,14 @@ interface CopilotKitProviderProps {
     children: ReactNode;
     runtimeUrl?: string;
     headers?: Record<string, string>;
+    /**
+     * The Copilot Cloud public API key.
+     */
+    publicApiKey?: string;
+    /**
+     * Alias for `publicApiKey`
+     **/
+    publicLicenseKey?: string;
     properties?: Record<string, unknown>;
     useSingleEndpoint?: boolean;
     agents__unsafe_dev_only?: Record<string, AbstractAgent>;

package/dist/index.js

@@ -1510,6 +1510,8 @@ CopilotKitInspector.displayName = "CopilotKitInspector";
 
 // src/providers/CopilotKitProvider.tsx
 var import_jsx_runtime8 = require("react/jsx-runtime");
+var HEADER_NAME = "X-CopilotCloud-Public-Api-Key";
+var COPILOT_CLOUD_CHAT_URL = "https://api.cloud.copilotkit.ai/copilotkit/v1";
 var CopilotKitContext = (0, import_react6.createContext)({
   copilotkit: null
 });
@@ -1528,6 +1530,8 @@ var CopilotKitProvider = ({
   children,
   runtimeUrl,
   headers = {},
+  publicApiKey,
+  publicLicenseKey,
   properties = {},
   agents__unsafe_dev_only: agents = {},
   renderToolCalls,
@@ -1577,6 +1581,25 @@ var CopilotKitProvider = ({
     renderActivityMessages,
     "renderActivityMessages must be a stable array."
   );
+  const resolvedPublicKey = publicApiKey ?? publicLicenseKey;
+  const hasLocalAgents = agents && Object.keys(agents).length > 0;
+  const mergedHeaders = (0, import_react6.useMemo)(() => {
+    if (!resolvedPublicKey) return headers;
+    if (headers[HEADER_NAME]) return headers;
+    return {
+      ...headers,
+      [HEADER_NAME]: resolvedPublicKey
+    };
+  }, [headers, resolvedPublicKey]);
+  if (!runtimeUrl && !resolvedPublicKey && !hasLocalAgents) {
+    const message = "Missing required prop: 'runtimeUrl' or 'publicApiKey' or 'publicLicenseKey'";
+    if (process.env.NODE_ENV === "production") {
+      throw new Error(message);
+    } else {
+      console.warn(message);
+    }
+  }
+  const chatApiEndpoint = runtimeUrl ?? (resolvedPublicKey ? COPILOT_CLOUD_CHAT_URL : void 0);
   const frontendToolsList = useStableArrayProp(
     frontendTools,
     "frontendTools must be a stable array. If you want to dynamically add or remove tools, use `useFrontendTool` instead."
@@ -1639,9 +1662,9 @@ var CopilotKitProvider = ({
   }, [renderToolCallsList, frontendToolsList, processedHumanInTheLoopTools]);
   const copilotkit = (0, import_react6.useMemo)(() => {
     const copilotkit2 = new CopilotKitCoreReact({
-      runtimeUrl,
+      runtimeUrl: chatApiEndpoint,
       runtimeTransport: useSingleEndpoint ? "single" : "rest",
-      headers,
+      headers: mergedHeaders,
       properties,
       agents__unsafe_dev_only: agents,
       tools: allTools,
@@ -1663,12 +1686,12 @@ var CopilotKitProvider = ({
     };
   }, [copilotkit]);
   (0, import_react6.useEffect)(() => {
-    copilotkit.setRuntimeUrl(runtimeUrl);
+    copilotkit.setRuntimeUrl(chatApiEndpoint);
     copilotkit.setRuntimeTransport(useSingleEndpoint ? "single" : "rest");
-    copilotkit.setHeaders(headers);
+    copilotkit.setHeaders(mergedHeaders);
     copilotkit.setProperties(properties);
     copilotkit.setAgents__unsafe_dev_only(agents);
-  }, [runtimeUrl, headers, properties, agents, useSingleEndpoint]);
+  }, [chatApiEndpoint, mergedHeaders, properties, agents, useSingleEndpoint]);
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
     CopilotKitContext.Provider,
     {