@copilotkit/react-core 1.10.0-next.1 → 1.10.0-next.10

package/dist/hooks/index.js

@@ -87,7 +87,9 @@ __export(hooks_exports, {
   useCopilotAction: () => useCopilotAction,
   useCopilotAdditionalInstructions: () => useCopilotAdditionalInstructions,
   useCopilotAuthenticatedAction_c: () => useCopilotAuthenticatedAction_c,
-  useCopilotChat: () => useCopilotChat,
+  useCopilotChat: () => useCopilotChat2,
+  useCopilotChatHeadless_c: () => useCopilotChatHeadless_c,
+  useCopilotChatInternal: () => useCopilotChat,
   useCopilotReadable: () => useCopilotReadable,
   useCopilotRuntimeClient: () => useCopilotRuntimeClient,
   useLangGraphInterrupt: () => useLangGraphInterrupt,
@@ -96,8 +98,8 @@ __export(hooks_exports, {
 });
 module.exports = __toCommonJS(hooks_exports);
 
-// src/hooks/use-copilot-chat.ts
-var import_react9 = require("react");
+// src/hooks/use-copilot-chat_internal.ts
+var import_react10 = require("react");
 
 // src/context/copilot-context.tsx
 var import_react = __toESM(require("react"));
@@ -174,8 +176,8 @@ var emptyCopilotContext = {
   setLangGraphInterruptAction: () => null,
   removeLangGraphInterruptAction: () => null,
   onError: void 0,
-  suggestions: [],
-  setSuggestions: () => {
+  bannerError: null,
+  setBannerError: () => {
   }
 };
 var CopilotContext = import_react.default.createContext(emptyCopilotContext);
@@ -194,7 +196,10 @@ function returnAndThrowInDebug(_value) {
 var import_react2 = __toESM(require("react"));
 var emptyCopilotContext2 = {
   messages: [],
-  setMessages: () => []
+  setMessages: () => [],
+  // suggestions state
+  suggestions: [],
+  setSuggestions: () => []
 };
 var CopilotMessagesContext = import_react2.default.createContext(emptyCopilotContext2);
 function useCopilotMessagesContext() {
@@ -259,8 +264,16 @@ var import_react4 = require("react");
 var import_shared3 = require("@copilotkit/shared");
 
 // src/utils/dev-console.ts
+function isLocalhost() {
+  if (typeof window === "undefined")
+    return false;
+  return window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1" || window.location.hostname === "0.0.0.0";
+}
 function shouldShowDevConsole(showDevConsole) {
-  return showDevConsole;
+  if (showDevConsole !== void 0) {
+    return showDevConsole;
+  }
+  return isLocalhost();
 }
 
 // src/hooks/use-copilot-runtime-client.ts
@@ -1156,14 +1169,27 @@ function getPairedFeAction(actions, message) {
 }
 
 // src/components/copilot-provider/copilotkit.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_react_dom2 = require("react-dom");
-var import_shared7 = require("@copilotkit/shared");
+var import_shared8 = require("@copilotkit/shared");
 
-// src/utils/extract.ts
-var import_shared5 = require("@copilotkit/shared");
+// src/components/copilot-provider/copilot-messages.tsx
+var import_react7 = require("react");
 var import_runtime_client_gql4 = require("@copilotkit/runtime-client-gql");
+var import_shared5 = require("@copilotkit/shared");
+var import_jsx_runtime4 = require("react/jsx-runtime");
+var MessagesTapContext = (0, import_react7.createContext)(null);
+function useMessagesTap() {
+  const tap = (0, import_react7.useContext)(MessagesTapContext);
+  if (!tap)
+    throw new Error("useMessagesTap must be used inside <MessagesTapProvider>");
+  return tap;
+}
+
+// src/utils/extract.ts
+var import_shared6 = require("@copilotkit/shared");
 var import_runtime_client_gql5 = require("@copilotkit/runtime-client-gql");
+var import_runtime_client_gql6 = require("@copilotkit/runtime-client-gql");
 function extract(_0) {
   return __async(this, arguments, function* ({
     context,
@@ -1173,7 +1199,7 @@ function extract(_0) {
     data,
     abortSignal,
     stream,
-    requestType = import_runtime_client_gql4.CopilotRequestType.Task,
+    requestType = import_runtime_client_gql5.CopilotRequestType.Task,
     forwardedParameters
   }) {
     var _a, _b;
@@ -1194,13 +1220,13 @@ function extract(_0) {
     if (includeReadable) {
       contextString += context.getContextString([], defaultCopilotContextCategories);
     }
-    const systemMessage = new import_runtime_client_gql4.TextMessage({
+    const systemMessage = new import_runtime_client_gql5.TextMessage({
       content: makeSystemMessage(contextString, instructions),
-      role: import_runtime_client_gql4.Role.System
+      role: import_runtime_client_gql5.Role.System
     });
-    const instructionsMessage = new import_runtime_client_gql4.TextMessage({
+    const instructionsMessage = new import_runtime_client_gql5.TextMessage({
       content: makeInstructionsMessage(instructions),
-      role: import_runtime_client_gql4.Role.User
+      role: import_runtime_client_gql5.Role.User
     });
     const response = context.runtimeClient.asStream(
       context.runtimeClient.generateCopilotResponse({
@@ -1210,13 +1236,13 @@ function extract(_0) {
               {
                 name: action.name,
                 description: action.description || "",
-                jsonSchema: JSON.stringify((0, import_shared5.actionParametersToJsonSchema)(action.parameters || []))
+                jsonSchema: JSON.stringify((0, import_shared6.actionParametersToJsonSchema)(action.parameters || []))
               }
             ],
             url: window.location.href
           },
-          messages: (0, import_runtime_client_gql5.convertMessagesToGqlInput)(
-            includeMessages ? [systemMessage, instructionsMessage, ...(0, import_runtime_client_gql5.filterAgentStateMessages)(messages)] : [systemMessage, instructionsMessage]
+          messages: (0, import_runtime_client_gql6.convertMessagesToGqlInput)(
+            includeMessages ? [systemMessage, instructionsMessage, ...(0, import_runtime_client_gql6.filterAgentStateMessages)(messages)] : [systemMessage, instructionsMessage]
           ),
           metadata: {
             requestType
@@ -1241,7 +1267,7 @@ function extract(_0) {
       if (abortSignal == null ? void 0 : abortSignal.aborted) {
         throw new Error("Aborted");
       }
-      actionExecutionMessage = (0, import_runtime_client_gql4.convertGqlOutputToMessages)(
+      actionExecutionMessage = (0, import_runtime_client_gql5.convertGqlOutputToMessages)(
         value.generateCopilotResponse.messages
       ).find((msg) => msg.isActionExecutionMessage());
       if (!actionExecutionMessage) {
@@ -1295,8 +1321,8 @@ This is not a conversation, so please do not ask questions. Just call the functi
 }
 
 // src/utils/suggestions.ts
-var import_shared6 = require("@copilotkit/shared");
-var import_runtime_client_gql6 = require("@copilotkit/runtime-client-gql");
+var import_shared7 = require("@copilotkit/shared");
+var import_runtime_client_gql7 = require("@copilotkit/runtime-client-gql");
 var reloadSuggestions = (context, chatSuggestionConfiguration, setCurrentSuggestions, abortControllerRef) => __async(void 0, null, function* () {
   const abortController = abortControllerRef.current;
   if (abortController == null ? void 0 : abortController.signal.aborted) {
@@ -1312,7 +1338,7 @@ var reloadSuggestions = (context, chatSuggestionConfiguration, setCurrentSuggest
       Object.values(context.actions).map((action) => ({
         name: action.name,
         description: action.description,
-        jsonSchema: JSON.stringify((0, import_shared6.actionParametersToJsonSchema)(action.parameters))
+        jsonSchema: JSON.stringify((0, import_shared7.actionParametersToJsonSchema)(action.parameters))
       }))
     );
     const allSuggestions = [];
@@ -1340,7 +1366,7 @@ var reloadSuggestions = (context, chatSuggestionConfiguration, setCurrentSuggest
 Available tools: ${tools}
 
 `,
-          requestType: import_runtime_client_gql6.CopilotRequestType.Task,
+          requestType: import_runtime_client_gql7.CopilotRequestType.Task,
           parameters: [
             {
               name: "suggestions",
@@ -1428,21 +1454,21 @@ Available tools: ${tools}
 });
 
 // src/components/copilot-provider/copilotkit.tsx
-var import_jsx_runtime4 = require("react/jsx-runtime");
+var import_jsx_runtime5 = require("react/jsx-runtime");
 var defaultCopilotContextCategories = ["global"];
 
-// src/hooks/use-copilot-chat.ts
-var import_runtime_client_gql7 = require("@copilotkit/runtime-client-gql");
+// src/hooks/use-copilot-chat_internal.ts
+var import_runtime_client_gql8 = require("@copilotkit/runtime-client-gql");
 
 // src/hooks/use-langgraph-interrupt-render.ts
-var import_react8 = __toESM(require("react"));
+var import_react9 = __toESM(require("react"));
 var InterruptRenderer = ({ event, result, render, resolve }) => {
   return render({ event, result, resolve });
 };
 function useLangGraphInterruptRender() {
   const { langGraphInterruptAction, setLangGraphInterruptAction, agentSession } = useCopilotContext();
-  const responseRef = import_react8.default.useRef();
-  const resolveInterrupt = (0, import_react8.useCallback)(
+  const responseRef = import_react9.default.useRef();
+  const resolveInterrupt = (0, import_react9.useCallback)(
     (response) => {
       responseRef.current = response;
       setTimeout(() => {
@@ -1465,7 +1491,7 @@ function useLangGraphInterruptRender() {
       resolve: resolveInterrupt
     });
   }
-  return import_react8.default.createElement(InterruptRenderer, {
+  return import_react9.default.createElement(InterruptRenderer, {
     event,
     result,
     render,
@@ -1473,7 +1499,7 @@ function useLangGraphInterruptRender() {
   });
 }
 
-// src/hooks/use-copilot-chat.ts
+// src/hooks/use-copilot-chat_internal.ts
 var globalSuggestionPromise = null;
 function useCopilotChat(options = {}) {
   var _a;
@@ -1503,15 +1529,13 @@ function useCopilotChat(options = {}) {
     langGraphInterruptAction,
     setLangGraphInterruptAction,
     chatSuggestionConfiguration,
-    suggestions,
-    setSuggestions,
     runtimeClient
   } = useCopilotContext();
-  const { messages, setMessages } = useCopilotMessagesContext();
-  const [mcpServers, setLocalMcpServers] = (0, import_react9.useState)([]);
-  const suggestionsAbortControllerRef = (0, import_react9.useRef)(null);
-  const isLoadingSuggestionsRef = (0, import_react9.useRef)(false);
-  const abortSuggestions = (0, import_react9.useCallback)(
+  const { messages, setMessages, suggestions, setSuggestions } = useCopilotMessagesContext();
+  const [mcpServers, setLocalMcpServers] = (0, import_react10.useState)([]);
+  const suggestionsAbortControllerRef = (0, import_react10.useRef)(null);
+  const isLoadingSuggestionsRef = (0, import_react10.useRef)(false);
+  const abortSuggestions = (0, import_react10.useCallback)(
     (clear = true) => {
       var _a2;
       (_a2 = suggestionsAbortControllerRef.current) == null ? void 0 : _a2.abort("suggestions aborted by user");
@@ -1522,7 +1546,7 @@ function useCopilotChat(options = {}) {
     },
     [setSuggestions]
   );
-  const stableContext = (0, import_react9.useMemo)(() => {
+  const stableContext = (0, import_react10.useMemo)(() => {
     return {
       actions,
       copilotApiConfig,
@@ -1538,7 +1562,7 @@ function useCopilotChat(options = {}) {
     messages.length,
     Object.keys(chatSuggestionConfiguration).length
   ]);
-  const generateSuggestionsFunc = (0, import_react9.useCallback)(() => __async(this, null, function* () {
+  const generateSuggestionsFunc = (0, import_react10.useCallback)(() => __async(this, null, function* () {
     if (globalSuggestionPromise) {
       return globalSuggestionPromise;
     }
@@ -1563,10 +1587,10 @@ function useCopilotChat(options = {}) {
     }))();
     return globalSuggestionPromise;
   }), [stableContext, chatSuggestionConfiguration, setSuggestions, abortSuggestions]);
-  const resetSuggestions = (0, import_react9.useCallback)(() => {
+  const resetSuggestions = (0, import_react10.useCallback)(() => {
     setSuggestions([]);
   }, [setSuggestions]);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     if (mcpServers.length > 0) {
       const serversCopy = [...mcpServers];
       copilotApiConfig.mcpServers = serversCopy;
@@ -1576,7 +1600,7 @@ function useCopilotChat(options = {}) {
       copilotApiConfig.properties.mcpServers = serversCopy;
     }
   }, [mcpServers, copilotApiConfig]);
-  const setMcpServers = (0, import_react9.useCallback)((servers) => {
+  const setMcpServers = (0, import_react10.useCallback)((servers) => {
     setLocalMcpServers(servers);
   }, []);
   const onCoAgentStateRender = useAsyncCallback(
@@ -1597,15 +1621,15 @@ function useCopilotChat(options = {}) {
     }),
     [coAgentStateRenders]
   );
-  const makeSystemMessageCallback = (0, import_react9.useCallback)(() => {
+  const makeSystemMessageCallback = (0, import_react10.useCallback)(() => {
     const systemMessageMaker = makeSystemMessage2 || defaultSystemMessage;
     const contextString = getContextString([], defaultCopilotContextCategories);
-    return new import_runtime_client_gql7.TextMessage({
+    return new import_runtime_client_gql8.TextMessage({
       content: systemMessageMaker(contextString, chatInstructions),
-      role: import_runtime_client_gql7.Role.System
+      role: import_runtime_client_gql8.Role.System
     });
   }, [getContextString, makeSystemMessage2, chatInstructions]);
-  const deleteMessage = (0, import_react9.useCallback)(
+  const deleteMessage = (0, import_react10.useCallback)(
     (messageId) => {
       setMessages((prev) => prev.filter((message) => message.id !== messageId));
     },
@@ -1614,7 +1638,7 @@ function useCopilotChat(options = {}) {
   const { append, reload, stop, runChatCompletion } = useChat(__spreadProps(__spreadValues({}, options), {
     actions: Object.values(actions),
     copilotConfig: copilotApiConfig,
-    initialMessages: (0, import_runtime_client_gql7.aguiToGQL)(options.initialMessages || []),
+    initialMessages: (0, import_runtime_client_gql8.aguiToGQL)(options.initialMessages || []),
     onFunctionCall: getFunctionCallHandler(),
     onCoAgentStateRender,
     messages,
@@ -1642,7 +1666,14 @@ function useCopilotChat(options = {}) {
   const latestAppendFunc = useAsyncCallback(
     (message, options2) => __async(this, null, function* () {
       abortSuggestions(options2 == null ? void 0 : options2.clearSuggestions);
-      return yield latestAppend.current((0, import_runtime_client_gql7.aguiToGQL)([message])[0], options2);
+      return yield latestAppend.current(message, options2);
+    }),
+    [latestAppend]
+  );
+  const latestSendMessageFunc = useAsyncCallback(
+    (message, options2) => __async(this, null, function* () {
+      abortSuggestions(options2 == null ? void 0 : options2.clearSuggestions);
+      return yield latestAppend.current((0, import_runtime_client_gql8.aguiToGQL)([message])[0], options2);
     }),
     [latestAppend]
   );
@@ -1654,20 +1685,23 @@ function useCopilotChat(options = {}) {
     [latestReload]
   );
   const latestStop = useUpdatedRef(stop);
-  const latestStopFunc = (0, import_react9.useCallback)(() => {
+  const latestStopFunc = (0, import_react10.useCallback)(() => {
     return latestStop.current();
   }, [latestStop]);
   const latestDelete = useUpdatedRef(deleteMessage);
-  const latestDeleteFunc = (0, import_react9.useCallback)(
+  const latestDeleteFunc = (0, import_react10.useCallback)(
     (messageId) => {
       return latestDelete.current(messageId);
     },
     [latestDelete]
   );
   const latestSetMessages = useUpdatedRef(setMessages);
-  const latestSetMessagesFunc = (0, import_react9.useCallback)(
+  const latestSetMessagesFunc = (0, import_react10.useCallback)(
     (messages2) => {
-      return latestSetMessages.current((0, import_runtime_client_gql7.aguiToGQL)(messages2));
+      if (messages2.every((message) => message instanceof import_runtime_client_gql8.Message)) {
+        return latestSetMessages.current(messages2);
+      }
+      return latestSetMessages.current((0, import_runtime_client_gql8.aguiToGQL)(messages2));
     },
     [latestSetMessages]
   );
@@ -1675,7 +1709,7 @@ function useCopilotChat(options = {}) {
   const latestRunChatCompletionFunc = useAsyncCallback(() => __async(this, null, function* () {
     return yield latestRunChatCompletion.current();
   }), [latestRunChatCompletion]);
-  const reset = (0, import_react9.useCallback)(() => {
+  const reset = (0, import_react10.useCallback)(() => {
     latestStopFunc();
     setMessages([]);
     setRunId(null);
@@ -1698,12 +1732,14 @@ function useCopilotChat(options = {}) {
     resetSuggestions
   ]);
   const latestReset = useUpdatedRef(reset);
-  const latestResetFunc = (0, import_react9.useCallback)(() => {
+  const latestResetFunc = (0, import_react10.useCallback)(() => {
     return latestReset.current();
   }, [latestReset]);
   const interrupt = useLangGraphInterruptRender();
   return {
-    visibleMessages: (0, import_runtime_client_gql7.gqlToAGUI)(messages, actions, coAgentStateRenders),
+    visibleMessages: messages,
+    messages: (0, import_runtime_client_gql8.gqlToAGUI)(messages, actions, coAgentStateRenders),
+    sendMessage: latestSendMessageFunc,
     appendMessage: latestAppendFunc,
     setMessages: latestSetMessagesFunc,
     reloadMessages: latestReloadFunc,
@@ -1723,8 +1759,8 @@ function useCopilotChat(options = {}) {
   };
 }
 function useUpdatedRef(value) {
-  const ref = (0, import_react9.useRef)(value);
-  (0, import_react9.useEffect)(() => {
+  const ref = (0, import_react10.useRef)(value);
+  (0, import_react10.useEffect)(() => {
     ref.current = value;
   }, [value]);
   return ref;
@@ -1756,14 +1792,105 @@ In case of a function error:
 ${additionalInstructions}` : "");
 }
 
+// src/hooks/use-copilot-chat.ts
+function useCopilotChat2(options = {}) {
+  const {
+    visibleMessages,
+    appendMessage,
+    reloadMessages,
+    stopGeneration,
+    reset,
+    isLoading,
+    runChatCompletion,
+    mcpServers,
+    setMcpServers
+  } = useCopilotChat(options);
+  return {
+    visibleMessages,
+    appendMessage,
+    reloadMessages,
+    stopGeneration,
+    reset,
+    isLoading,
+    runChatCompletion,
+    mcpServers,
+    setMcpServers
+  };
+}
+
+// src/hooks/use-copilot-chat-headless_c.ts
+var import_react11 = require("react");
+var import_shared9 = require("@copilotkit/shared");
+var createNonFunctionalReturn = () => ({
+  visibleMessages: [],
+  messages: [],
+  sendMessage: () => __async(void 0, null, function* () {
+  }),
+  appendMessage: () => __async(void 0, null, function* () {
+  }),
+  setMessages: () => {
+  },
+  deleteMessage: () => {
+  },
+  reloadMessages: () => __async(void 0, null, function* () {
+  }),
+  stopGeneration: () => {
+  },
+  reset: () => {
+  },
+  isLoading: false,
+  runChatCompletion: () => __async(void 0, null, function* () {
+    return [];
+  }),
+  mcpServers: [],
+  setMcpServers: () => {
+  },
+  suggestions: [],
+  setSuggestions: () => {
+  },
+  generateSuggestions: () => __async(void 0, null, function* () {
+  }),
+  resetSuggestions: () => {
+  },
+  isLoadingSuggestions: false,
+  interrupt: null
+});
+function useCopilotChatHeadless_c(options = {}) {
+  const { copilotApiConfig, setBannerError } = useCopilotContext();
+  const hasPublicApiKey = Boolean(copilotApiConfig.publicApiKey);
+  const internalResult = useCopilotChat(options);
+  (0, import_react11.useEffect)(() => {
+    if (!hasPublicApiKey) {
+      setBannerError(
+        new import_shared9.CopilotKitError({
+          message: (
+            // add link to documentation here
+            "You're using useCopilotChatHeadless_c, a subscription-only feature, which offers extensive headless chat capabilities. To continue, you'll need to provide a free subscription key."
+          ),
+          code: import_shared9.CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR,
+          severity: import_shared9.Severity.WARNING,
+          visibility: import_shared9.ErrorVisibility.BANNER
+        })
+      );
+      import_shared9.styledConsole.logCopilotKitPlatformMessage();
+    } else {
+      setBannerError(null);
+    }
+  }, [hasPublicApiKey]);
+  if (hasPublicApiKey) {
+    return internalResult;
+  }
+  return createNonFunctionalReturn();
+}
+
 // src/hooks/use-copilot-action.ts
-var import_shared8 = require("@copilotkit/shared");
-var import_react10 = require("react");
+var import_shared10 = require("@copilotkit/shared");
+var import_react12 = require("react");
 function useCopilotAction(action, dependencies) {
   const { setAction, removeAction, actions, chatComponentsCache } = useCopilotContext();
-  const idRef = (0, import_react10.useRef)((0, import_shared8.randomId)());
-  const renderAndWaitRef = (0, import_react10.useRef)(null);
-  const activatingMessageIdRef = (0, import_react10.useRef)(null);
+  const idRef = (0, import_react12.useRef)((0, import_shared10.randomId)());
+  const renderAndWaitRef = (0, import_react12.useRef)(null);
+  const activatingMessageIdRef = (0, import_react12.useRef)(null);
   const { addToast } = useToast();
   action = __spreadValues({}, action);
   if (
@@ -1825,7 +1952,7 @@ function useCopilotAction(action, dependencies) {
           return renderAndWait(waitProps);
         }
       }
-      return (0, import_react10.createElement)(import_react10.Fragment);
+      return (0, import_react12.createElement)(import_react12.Fragment);
     };
   }
   if (dependencies === void 0) {
@@ -1840,7 +1967,7 @@ function useCopilotAction(action, dependencies) {
       }
     }
   }
-  (0, import_react10.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     const hasDuplicate = Object.values(actions).some(
       (otherAction) => otherAction.name === action.name && otherAction !== actions[idRef.current]
     );
@@ -1852,7 +1979,7 @@ function useCopilotAction(action, dependencies) {
       });
     }
   }, [actions]);
-  (0, import_react10.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     setAction(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.actions[action.name] = action.render;
@@ -1881,8 +2008,8 @@ function isFrontendAction(action) {
 }
 
 // src/hooks/use-coagent-state-render.ts
-var import_react11 = require("react");
-var import_shared9 = require("@copilotkit/shared");
+var import_react13 = require("react");
+var import_shared11 = require("@copilotkit/shared");
 function useCoAgentStateRender(action, dependencies) {
   const {
     setCoAgentStateRender,
@@ -1890,13 +2017,13 @@ function useCoAgentStateRender(action, dependencies) {
     coAgentStateRenders,
     chatComponentsCache,
     availableAgents
-  } = (0, import_react11.useContext)(CopilotContext);
-  const idRef = (0, import_react11.useRef)((0, import_shared9.randomId)());
+  } = (0, import_react13.useContext)(CopilotContext);
+  const idRef = (0, import_react13.useRef)((0, import_shared11.randomId)());
   const { setBannerError, addToast } = useToast();
-  (0, import_react11.useEffect)(() => {
+  (0, import_react13.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 import_shared9.CopilotKitAgentDiscoveryError({
+      const agentError = new import_shared11.CopilotKitAgentDiscoveryError({
         agentName: action.name,
         availableAgents: availableAgents.map((a) => ({ name: a.name, id: a.id }))
       });
@@ -1914,7 +2041,7 @@ function useCoAgentStateRender(action, dependencies) {
       }
     }
   }
-  (0, import_react11.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     const currentId = idRef.current;
     const hasDuplicate = Object.entries(coAgentStateRenders).some(([id, otherAction]) => {
       if (id === currentId)
@@ -1938,7 +2065,7 @@ function useCoAgentStateRender(action, dependencies) {
       });
     }
   }, [coAgentStateRenders]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     setCoAgentStateRender(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.coAgentStateRenders[key] = action.render;
@@ -1958,11 +2085,11 @@ function useCoAgentStateRender(action, dependencies) {
 }
 
 // src/hooks/use-make-copilot-document-readable.ts
-var import_react12 = require("react");
+var import_react14 = require("react");
 function useMakeCopilotDocumentReadable(document, categories, dependencies = []) {
   const { addDocumentContext, removeDocumentContext } = useCopilotContext();
-  const idRef = (0, import_react12.useRef)();
-  (0, import_react12.useEffect)(() => {
+  const idRef = (0, import_react14.useRef)();
+  (0, import_react14.useEffect)(() => {
     const id = addDocumentContext(document, categories);
     idRef.current = id;
     return () => {
@@ -1973,7 +2100,7 @@ function useMakeCopilotDocumentReadable(document, categories, dependencies = [])
 }
 
 // src/hooks/use-copilot-readable.ts
-var import_react13 = require("react");
+var import_react15 = require("react");
 function convertToJSON(description, value) {
   return `${description}: ${typeof value === "string" ? value : JSON.stringify(value)}`;
 }
@@ -1986,10 +2113,10 @@ function useCopilotReadable({
   available = "enabled"
 }, dependencies) {
   const { addContext, removeContext } = useCopilotContext();
-  const idRef = (0, import_react13.useRef)();
+  const idRef = (0, import_react15.useRef)();
   convert = convert || convertToJSON;
   const information = convert(description, value);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     if (available === "disabled")
       return;
     const id = addContext(information, parentId, categories);
@@ -2002,30 +2129,29 @@ function useCopilotReadable({
 }
 
 // src/hooks/use-coagent.ts
-var import_react14 = require("react");
-var import_shared10 = require("@copilotkit/shared");
+var import_react16 = require("react");
+var import_shared12 = require("@copilotkit/shared");
 function useCoAgent(options) {
-  const generalContext = useCopilotContext();
-  const { availableAgents } = generalContext;
+  const context = useCopilotContext();
+  const { availableAgents } = context;
   const { setBannerError } = useToast();
-  const lastLoadedThreadId = (0, import_react14.useRef)();
-  const lastLoadedState = (0, import_react14.useRef)();
+  const lastLoadedThreadId = (0, import_react16.useRef)();
+  const lastLoadedState = (0, import_react16.useRef)();
   const { name } = options;
-  (0, import_react14.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     if ((availableAgents == null ? void 0 : availableAgents.length) && !availableAgents.some((a) => a.name === name)) {
       const message = `(useCoAgent): Agent "${name}" not found. Make sure the agent exists and is properly configured.`;
       console.warn(message);
-      const agentError = new import_shared10.CopilotKitAgentDiscoveryError({
+      const agentError = new import_shared12.CopilotKitAgentDiscoveryError({
         agentName: name,
         availableAgents: availableAgents.map((a) => ({ name: a.name, id: a.id }))
       });
       setBannerError(agentError);
     }
   }, [availableAgents]);
-  const messagesContext = useCopilotMessagesContext();
-  const context = __spreadValues(__spreadValues({}, generalContext), messagesContext);
+  const { getMessagesFromTap } = useMessagesTap();
   const { coagentStates, coagentStatesRef, setCoagentStatesWithRef, threadId, copilotApiConfig } = context;
-  const { appendMessage, runChatCompletion } = useCopilotChat();
+  const { sendMessage, runChatCompletion } = useCopilotChat();
   const headers = __spreadValues({}, copilotApiConfig.headers || {});
   const runtimeClient = useCopilotRuntimeClient({
     url: copilotApiConfig.chatApiEndpoint,
@@ -2034,7 +2160,7 @@ function useCoAgent(options) {
     credentials: copilotApiConfig.credentials,
     showDevConsole: context.showDevConsole
   });
-  const setState = (0, import_react14.useCallback)(
+  const setState = (0, import_react16.useCallback)(
     (newState) => {
       let coagentState = getCoagentState({ coagentStates, name, options });
       const updatedState = typeof newState === "function" ? newState(coagentState.state) : newState;
@@ -2046,7 +2172,7 @@ function useCoAgent(options) {
     },
     [coagentStates, name]
   );
-  (0, import_react14.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     const fetchAgentState = () => __async(this, null, function* () {
       var _a, _b, _c, _d;
       if (!threadId || threadId === lastLoadedThreadId.current)
@@ -2064,13 +2190,13 @@ function useCoAgent(options) {
       if (((_d = (_c = result.data) == null ? void 0 : _c.loadAgentState) == null ? void 0 : _d.threadExists) && newState && newState != "{}") {
         lastLoadedState.current = newState;
         lastLoadedThreadId.current = threadId;
-        const fetchedState = (0, import_shared10.parseJson)(newState, {});
+        const fetchedState = (0, import_shared12.parseJson)(newState, {});
         isExternalStateManagement(options) ? options.setState(fetchedState) : setState(fetchedState);
       }
     });
     void fetchAgentState();
   }, [threadId]);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     if (isExternalStateManagement(options)) {
       setState(options.state);
     } else if (coagentStates[name] === void 0) {
@@ -2081,7 +2207,7 @@ function useCoAgent(options) {
     // reset initialstate on reset
     coagentStates[name] === void 0
   ]);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     const newConfig = options.config ? options.config : options.configurable ? { configurable: options.configurable } : void 0;
     if (newConfig === void 0)
       return;
@@ -2109,11 +2235,11 @@ function useCoAgent(options) {
   }, [JSON.stringify(options.config), JSON.stringify(options.configurable)]);
   const runAgentCallback = useAsyncCallback(
     (hint) => __async(this, null, function* () {
-      yield runAgent(name, context, appendMessage, runChatCompletion, hint);
+      yield runAgent(name, context, getMessagesFromTap(), sendMessage, runChatCompletion, hint);
     }),
-    [name, context, appendMessage, runChatCompletion]
+    [name, context, sendMessage, runChatCompletion]
   );
-  return (0, import_react14.useMemo)(() => {
+  return (0, import_react16.useMemo)(() => {
     const coagentState = getCoagentState({ coagentStates, name, options });
     return {
       name,
@@ -2153,7 +2279,7 @@ function stopAgent(name, context) {
     console.warn(`No agent session found for ${name}`);
   }
 }
-function runAgent(name, context, appendMessage, runChatCompletion, hint) {
+function runAgent(name, context, messages, sendMessage, runChatCompletion, hint) {
   return __async(this, null, function* () {
     var _a, _b;
     const { agentSession, setAgentSession } = context;
@@ -2163,8 +2289,8 @@ function runAgent(name, context, appendMessage, runChatCompletion, hint) {
       });
     }
     let previousState = null;
-    for (let i = context.messages.length - 1; i >= 0; i--) {
-      const message = context.messages[i];
+    for (let i = messages.length - 1; i >= 0; i--) {
+      const message = messages[i];
       if (message.isAgentStateMessage() && message.agentName === name) {
         previousState = message.state;
       }
@@ -2173,7 +2299,7 @@ function runAgent(name, context, appendMessage, runChatCompletion, hint) {
     if (hint) {
       const hintMessage = hint({ previousState, currentState: state });
       if (hintMessage) {
-        yield appendMessage(hintMessage);
+        yield sendMessage(hintMessage);
       } else {
         yield runChatCompletion();
       }
@@ -2210,28 +2336,28 @@ var getCoagentState = ({
 };
 
 // src/hooks/use-copilot-authenticated-action.ts
-var import_react15 = require("react");
-var import_react16 = __toESM(require("react"));
+var import_react17 = require("react");
+var import_react18 = __toESM(require("react"));
 function useCopilotAuthenticatedAction_c(action, dependencies) {
   const { authConfig_c, authStates_c, setAuthStates_c } = useCopilotContext();
-  const pendingActionRef = (0, import_react15.useRef)(null);
-  const executeAction2 = (0, import_react15.useCallback)(
+  const pendingActionRef = (0, import_react17.useRef)(null);
+  const executeAction2 = (0, import_react17.useCallback)(
     (props) => {
       if (typeof action.render === "function") {
         return action.render(props);
       }
-      return action.render || import_react16.default.createElement(import_react15.Fragment);
+      return action.render || import_react18.default.createElement(import_react17.Fragment);
     },
     [action]
   );
-  const wrappedRender = (0, import_react15.useCallback)(
+  const wrappedRender = (0, import_react17.useCallback)(
     (props) => {
       const isAuthenticated = Object.values(authStates_c || {}).some(
         (state) => state.status === "authenticated"
       );
       if (!isAuthenticated) {
         pendingActionRef.current = props;
-        return (authConfig_c == null ? void 0 : authConfig_c.SignInComponent) ? import_react16.default.createElement(authConfig_c.SignInComponent, {
+        return (authConfig_c == null ? void 0 : authConfig_c.SignInComponent) ? import_react18.default.createElement(authConfig_c.SignInComponent, {
           onSignInComplete: (authState) => {
             setAuthStates_c == null ? void 0 : setAuthStates_c((prev) => __spreadProps(__spreadValues({}, prev), { [action.name]: authState }));
             if (pendingActionRef.current) {
@@ -2239,7 +2365,7 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
               pendingActionRef.current = null;
             }
           }
-        }) : import_react16.default.createElement(import_react15.Fragment);
+        }) : import_react18.default.createElement(import_react17.Fragment);
       }
       return executeAction2(props);
     },
@@ -2254,29 +2380,29 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
 }
 
 // src/hooks/use-langgraph-interrupt.ts
-var import_react17 = require("react");
-var import_shared11 = require("@copilotkit/shared");
+var import_react19 = require("react");
+var import_shared13 = require("@copilotkit/shared");
 function useLangGraphInterrupt(action, dependencies) {
   var _a;
-  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react17.useContext)(CopilotContext);
+  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react19.useContext)(CopilotContext);
   const { runChatCompletion } = useCopilotChat();
   const { addToast } = useToast();
-  const actionId = (0, import_shared11.dataToUUID)(JSON.stringify(action), "lgAction");
-  const hasAction = (0, import_react17.useMemo)(
+  const actionId = (0, import_shared13.dataToUUID)(JSON.stringify(action), "lgAction");
+  const hasAction = (0, import_react19.useMemo)(
     () => Boolean(langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id),
     [langGraphInterruptAction]
   );
-  const isCurrentAction = (0, import_react17.useMemo)(
+  const isCurrentAction = (0, import_react19.useMemo)(
     () => (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) && (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) === actionId,
     [langGraphInterruptAction]
   );
-  (0, import_react17.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     var _a2;
     if (hasAction && isCurrentAction && ((_a2 = langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.event) == null ? void 0 : _a2.response)) {
       runChatCompletion();
     }
   }, [(_a = langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.event) == null ? void 0 : _a.response, runChatCompletion, hasAction, isCurrentAction]);
-  (0, import_react17.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     if (!action)
       return;
     if (hasAction && !isCurrentAction && !action.enabled) {
@@ -2301,10 +2427,10 @@ function useLangGraphInterrupt(action, dependencies) {
 }
 
 // src/hooks/use-copilot-additional-instructions.ts
-var import_react18 = require("react");
+var import_react20 = require("react");
 function useCopilotAdditionalInstructions({ instructions, available = "enabled" }, dependencies) {
   const { setAdditionalInstructions } = useCopilotContext();
-  (0, import_react18.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (available === "disabled")
       return;
     setAdditionalInstructions((prevInstructions) => [...prevInstructions || [], instructions]);
@@ -2326,6 +2452,8 @@ function useCopilotAdditionalInstructions({ instructions, available = "enabled"
   useCopilotAdditionalInstructions,
   useCopilotAuthenticatedAction_c,
   useCopilotChat,
+  useCopilotChatHeadless_c,
+  useCopilotChatInternal,
   useCopilotReadable,
   useCopilotRuntimeClient,
   useLangGraphInterrupt,