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

package/dist/index.js

@@ -98,7 +98,9 @@ __export(src_exports, {
   useCopilotAction: () => useCopilotAction,
   useCopilotAdditionalInstructions: () => useCopilotAdditionalInstructions,
   useCopilotAuthenticatedAction_c: () => useCopilotAuthenticatedAction_c,
-  useCopilotChat: () => useCopilotChat,
+  useCopilotChat: () => useCopilotChat2,
+  useCopilotChatHeadless_c: () => useCopilotChatHeadless_c,
+  useCopilotChatInternal: () => useCopilotChat,
   useCopilotContext: () => useCopilotContext,
   useCopilotMessagesContext: () => useCopilotMessagesContext,
   useCopilotReadable: () => useCopilotReadable,
@@ -187,8 +189,8 @@ var emptyCopilotContext = {
   setLangGraphInterruptAction: () => null,
   removeLangGraphInterruptAction: () => null,
   onError: void 0,
-  suggestions: [],
-  setSuggestions: () => {
+  bannerError: null,
+  setBannerError: () => {
   }
 };
 var CopilotContext = import_react.default.createContext(emptyCopilotContext);
@@ -414,7 +416,10 @@ var import_react6 = require("react");
 var import_react4 = __toESM(require("react"));
 var emptyCopilotContext2 = {
   messages: [],
-  setMessages: () => []
+  setMessages: () => [],
+  // suggestions state
+  suggestions: [],
+  setSuggestions: () => []
 };
 var CopilotMessagesContext = import_react4.default.createContext(emptyCopilotContext2);
 function useCopilotMessagesContext() {
@@ -731,18 +736,44 @@ function ToastProvider({
 }
 
 // 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/components/copilot-provider/copilot-messages.tsx
 var import_shared4 = require("@copilotkit/shared");
 var import_jsx_runtime2 = require("react/jsx-runtime");
+var MessagesTapContext = (0, import_react6.createContext)(null);
+function useMessagesTap() {
+  const tap = (0, import_react6.useContext)(MessagesTapContext);
+  if (!tap)
+    throw new Error("useMessagesTap must be used inside <MessagesTapProvider>");
+  return tap;
+}
+function MessagesTapProvider({ children }) {
+  const messagesRef = (0, import_react6.useRef)([]);
+  const tapRef = (0, import_react6.useRef)({
+    getMessagesFromTap: () => messagesRef.current,
+    updateTapMessages: (messages) => {
+      messagesRef.current = messages;
+    }
+  });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MessagesTapContext.Provider, { value: tapRef.current, children });
+}
 function CopilotMessages({ children }) {
   const [messages, setMessages] = (0, import_react6.useState)([]);
   const lastLoadedThreadId = (0, import_react6.useRef)();
   const lastLoadedAgentName = (0, import_react6.useRef)();
   const lastLoadedMessages = (0, import_react6.useRef)();
+  const { updateTapMessages } = useMessagesTap();
   const { threadId, agentSession, runtimeClient, showDevConsole, onError, copilotApiConfig } = useCopilotContext();
   const { setBannerError } = useToast();
   const traceUIError = (0, import_react6.useCallback)(
@@ -879,23 +910,230 @@ function CopilotMessages({ children }) {
     });
     void fetchMessages();
   }, [threadId, agentSession == null ? void 0 : agentSession.agentName]);
+  (0, import_react6.useEffect)(() => {
+    updateTapMessages(messages);
+  }, [messages, updateTapMessages]);
   const memoizedChildren = (0, import_react6.useMemo)(() => children, [children]);
+  const [suggestions, setSuggestions] = (0, import_react6.useState)([]);
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
     CopilotMessagesContext.Provider,
     {
       value: {
         messages,
-        setMessages
+        setMessages,
+        suggestions,
+        setSuggestions
       },
       children: memoizedChildren
     }
   );
 }
 
+// src/components/usage-banner.tsx
+var import_shared5 = require("@copilotkit/shared");
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function UsageBanner({
+  severity = import_shared5.Severity.CRITICAL,
+  message = "",
+  onClose,
+  actions
+}) {
+  if (!message || !severity) {
+    return null;
+  }
+  const themes = {
+    [import_shared5.Severity.INFO]: {
+      bg: "#f8fafc",
+      border: "#e2e8f0",
+      text: "#475569",
+      accent: "#3b82f6"
+    },
+    [import_shared5.Severity.WARNING]: {
+      bg: "#fffbeb",
+      border: "#fbbf24",
+      text: "#92400e",
+      accent: "#f59e0b"
+    },
+    [import_shared5.Severity.CRITICAL]: {
+      bg: "#fef2f2",
+      border: "#fecaca",
+      text: "#dc2626",
+      accent: "#ef4444"
+    }
+  };
+  const theme = themes[severity];
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("style", { children: `
+          @keyframes slideUp {
+            from { opacity: 0; transform: translateX(-50%) translateY(8px); }
+            to { opacity: 1; transform: translateX(-50%) translateY(0); }
+          }
+          
+          .usage-banner {
+            position: fixed;
+            bottom: 24px;
+            left: 50%;
+            transform: translateX(-50%);
+            width: min(600px, calc(100vw - 32px));
+            z-index: 10000;
+            animation: slideUp 0.2s cubic-bezier(0.16, 1, 0.3, 1);
+          }
+          
+          .banner-content {
+            background: linear-gradient(135deg, ${theme.bg} 0%, ${theme.bg}f5 100%);
+            border: 1px solid ${theme.border};
+            border-radius: 12px;
+            padding: 18px 20px;
+            box-shadow: 
+              0 4px 24px rgba(0, 0, 0, 0.08),
+              0 2px 8px rgba(0, 0, 0, 0.04),
+              inset 0 1px 0 rgba(255, 255, 255, 0.7);
+            display: flex;
+            align-items: center;
+            gap: 16px;
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
+            backdrop-filter: blur(12px);
+            position: relative;
+            overflow: hidden;
+          }
+          
+          .banner-content::before {
+            content: '';
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            height: 1px;
+            background: linear-gradient(90deg, transparent, ${theme.accent}40, transparent);
+          }
+          
+          .banner-message {
+            color: ${theme.text};
+            font-size: 14px;
+            line-height: 1.5;
+            font-weight: 500;
+            flex: 1;
+            letter-spacing: -0.01em;
+          }
+          
+          .close-btn {
+            background: rgba(0, 0, 0, 0.05);
+            border: none;
+            color: ${theme.text};
+            cursor: pointer;
+            padding: 0;
+            border-radius: 6px;
+            opacity: 0.6;
+            transition: all 0.15s cubic-bezier(0.16, 1, 0.3, 1);
+            font-size: 14px;
+            line-height: 1;
+            flex-shrink: 0;
+            width: 24px;
+            height: 24px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+          }
+          
+          .close-btn:hover {
+            opacity: 1;
+            background: rgba(0, 0, 0, 0.08);
+            transform: scale(1.05);
+          }
+          
+          .btn-primary {
+            background: linear-gradient(135deg, ${theme.accent} 0%, ${theme.accent}e6 100%);
+            color: white;
+            border: none;
+            border-radius: 8px;
+            padding: 10px 18px;
+            font-size: 13px;
+            font-weight: 600;
+            cursor: pointer;
+            transition: all 0.15s cubic-bezier(0.16, 1, 0.3, 1);
+            font-family: inherit;
+            flex-shrink: 0;
+            box-shadow: 
+              0 2px 8px ${theme.accent}30,
+              inset 0 1px 0 rgba(255, 255, 255, 0.2);
+            letter-spacing: -0.01em;
+          }
+          
+          .btn-primary:hover {
+            transform: translateY(-1px) scale(1.02);
+            box-shadow: 
+              0 4px 12px ${theme.accent}40,
+              inset 0 1px 0 rgba(255, 255, 255, 0.25);
+          }
+          
+          .btn-primary:active {
+            transform: translateY(0) scale(0.98);
+            transition: all 0.08s cubic-bezier(0.16, 1, 0.3, 1);
+          }
+          
+          @media (max-width: 640px) {
+            .usage-banner {
+              width: calc(100vw - 24px);
+            }
+            
+            .banner-content {
+              padding: 16px;
+              gap: 12px;
+            }
+            
+            .banner-message {
+              font-size: 13px;
+              line-height: 1.45;
+            }
+            
+            .btn-primary {
+              padding: 8px 14px;
+              font-size: 12px;
+            }
+            
+            .close-btn {
+              width: 22px;
+              height: 22px;
+              font-size: 12px;
+            }
+          }
+        ` }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "usage-banner", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "banner-content", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "banner-message", children: message }),
+      (actions == null ? void 0 : actions.primary) && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { className: "btn-primary", onClick: actions.primary.onClick, children: actions.primary.label }),
+      onClose && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { className: "close-btn", onClick: onClose, title: "Close", children: "\xD7" })
+    ] }) })
+  ] });
+}
+var getErrorActions = (error) => {
+  switch (error.code) {
+    case import_shared5.CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR:
+      return {
+        primary: {
+          label: "Show me how",
+          onClick: () => window.open(
+            "https://docs.copilotkit.ai/docs/guides/subscription",
+            "_blank",
+            "noopener,noreferrer"
+          )
+        }
+      };
+    case import_shared5.CopilotKitErrorCode.UPGRADE_REQUIRED_ERROR:
+      return {
+        primary: {
+          label: "Upgrade",
+          onClick: () => window.open("https://cloud.copilotkit.ai", "_blank", "noopener,noreferrer")
+        }
+      };
+    default:
+      return void 0;
+  }
+};
+
 // src/hooks/use-copilot-runtime-client.ts
 var import_runtime_client_gql2 = require("@copilotkit/runtime-client-gql");
 var import_react7 = require("react");
-var import_shared5 = require("@copilotkit/shared");
+var import_shared6 = require("@copilotkit/shared");
 var useCopilotRuntimeClient = (options) => {
   const { setBannerError } = useToast();
   const _a = options, { showDevConsole, onError } = _a, runtimeOptions = __objRest(_a, ["showDevConsole", "onError"]);
@@ -937,7 +1175,7 @@ var useCopilotRuntimeClient = (options) => {
             const extensions = gqlError.extensions;
             const visibility = extensions == null ? void 0 : extensions.visibility;
             const isDev = shouldShowDevConsole(showDevConsole != null ? showDevConsole : false);
-            if (visibility === import_shared5.ErrorVisibility.SILENT) {
+            if (visibility === import_shared6.ErrorVisibility.SILENT) {
               console.error("CopilotKit Silent Error:", gqlError.message);
               return;
             }
@@ -956,9 +1194,9 @@ var useCopilotRuntimeClient = (options) => {
               setBannerError(ckError);
               traceUIError(ckError, gqlError);
             } else {
-              const fallbackError = new import_shared5.CopilotKitError({
+              const fallbackError = new import_shared6.CopilotKitError({
                 message: gqlError.message,
-                code: import_shared5.CopilotKitErrorCode.UNKNOWN
+                code: import_shared6.CopilotKitErrorCode.UNKNOWN
               });
               setBannerError(fallbackError);
               traceUIError(fallbackError, gqlError);
@@ -970,9 +1208,9 @@ var useCopilotRuntimeClient = (options) => {
           if (!isDev) {
             console.error("CopilotKit Error (hidden in production):", error);
           } else {
-            const fallbackError = new import_shared5.CopilotKitError({
+            const fallbackError = new import_shared6.CopilotKitError({
               message: (error == null ? void 0 : error.message) || String(error),
-              code: import_shared5.CopilotKitErrorCode.UNKNOWN
+              code: import_shared6.CopilotKitErrorCode.UNKNOWN
             });
             setBannerError(fallbackError);
             traceUIError(fallbackError, error);
@@ -981,9 +1219,9 @@ var useCopilotRuntimeClient = (options) => {
       },
       handleGQLWarning: (message) => {
         console.warn(message);
-        const warningError = new import_shared5.CopilotKitError({
+        const warningError = new import_shared6.CopilotKitError({
           message,
-          code: import_shared5.CopilotKitErrorCode.UNKNOWN
+          code: import_shared6.CopilotKitErrorCode.UNKNOWN
         });
         setBannerError(warningError);
       }
@@ -998,16 +1236,16 @@ function createStructuredError(gqlError) {
   const message = (originalError == null ? void 0 : originalError.message) || gqlError.message;
   const code = extensions == null ? void 0 : extensions.code;
   if (code) {
-    return new import_shared5.CopilotKitError({ message, code });
+    return new import_shared6.CopilotKitError({ message, code });
   }
   if ((_a = originalError == null ? void 0 : originalError.stack) == null ? void 0 : _a.includes("CopilotApiDiscoveryError")) {
-    return new import_shared5.CopilotKitApiDiscoveryError({ message });
+    return new import_shared6.CopilotKitApiDiscoveryError({ message });
   }
   if ((_b = originalError == null ? void 0 : originalError.stack) == null ? void 0 : _b.includes("CopilotKitRemoteEndpointDiscoveryError")) {
-    return new import_shared5.CopilotKitRemoteEndpointDiscoveryError({ message });
+    return new import_shared6.CopilotKitRemoteEndpointDiscoveryError({ message });
   }
   if ((_c = originalError == null ? void 0 : originalError.stack) == null ? void 0 : _c.includes("CopilotKitAgentDiscoveryError")) {
-    return new import_shared5.CopilotKitAgentDiscoveryError({
+    return new import_shared6.CopilotKitAgentDiscoveryError({
       agentName: "",
       availableAgents: []
     });
@@ -1016,7 +1254,7 @@ function createStructuredError(gqlError) {
 }
 
 // src/utils/extract.ts
-var import_shared6 = require("@copilotkit/shared");
+var import_shared7 = require("@copilotkit/shared");
 var import_runtime_client_gql3 = require("@copilotkit/runtime-client-gql");
 var import_runtime_client_gql4 = require("@copilotkit/runtime-client-gql");
 function extract(_0) {
@@ -1065,7 +1303,7 @@ function extract(_0) {
               {
                 name: action.name,
                 description: action.description || "",
-                jsonSchema: JSON.stringify((0, import_shared6.actionParametersToJsonSchema)(action.parameters || []))
+                jsonSchema: JSON.stringify((0, import_shared7.actionParametersToJsonSchema)(action.parameters || []))
               }
             ],
             url: window.location.href
@@ -1150,7 +1388,7 @@ This is not a conversation, so please do not ask questions. Just call the functi
 }
 
 // src/utils/suggestions.ts
-var import_shared7 = require("@copilotkit/shared");
+var import_shared8 = require("@copilotkit/shared");
 var import_runtime_client_gql5 = require("@copilotkit/runtime-client-gql");
 var reloadSuggestions = (context, chatSuggestionConfiguration, setCurrentSuggestions, abortControllerRef) => __async(void 0, null, function* () {
   const abortController = abortControllerRef.current;
@@ -1167,7 +1405,7 @@ var reloadSuggestions = (context, chatSuggestionConfiguration, setCurrentSuggest
       Object.values(context.actions).map((action) => ({
         name: action.name,
         description: action.description,
-        jsonSchema: JSON.stringify((0, import_shared7.actionParametersToJsonSchema)(action.parameters))
+        jsonSchema: JSON.stringify((0, import_shared8.actionParametersToJsonSchema)(action.parameters))
       }))
     );
     const allSuggestions = [];
@@ -1294,7 +1532,7 @@ var import_react9 = __toESM(require("react"));
 var import_shared10 = require("@copilotkit/shared");
 
 // src/lib/status-checker.ts
-var import_shared8 = require("@copilotkit/shared");
+var import_shared9 = require("@copilotkit/shared");
 var STATUS_CHECK_INTERVAL = 1e3 * 60 * 5;
 var StatusChecker = class {
   constructor() {
@@ -1312,10 +1550,10 @@ var StatusChecker = class {
         clearInterval(this.intervalId);
       const checkStatus = () => __async(this, null, function* () {
         try {
-          const response = yield fetch(`${import_shared8.COPILOT_CLOUD_API_URL}/ciu`, {
+          const response = yield fetch(`${import_shared9.COPILOT_CLOUD_API_URL}/ciu`, {
             method: "GET",
             headers: {
-              [import_shared8.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey
+              [import_shared9.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey
             }
           }).then((response2) => response2.json());
           this.lastResponse = response;
@@ -1347,349 +1585,6 @@ var StatusChecker = class {
   }
 };
 
-// src/components/usage-banner.tsx
-var import_shared9 = require("@copilotkit/shared");
-var import_jsx_runtime3 = require("react/jsx-runtime");
-var defaultIcons = {
-  [import_shared9.Severity.CRITICAL]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-    "svg",
-    {
-      viewBox: "0 0 24 24",
-      width: "16",
-      height: "16",
-      stroke: "currentColor",
-      strokeWidth: "2.5",
-      fill: "none",
-      strokeLinecap: "round",
-      strokeLinejoin: "round",
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("circle", { cx: "12", cy: "12", r: "10" }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("line", { x1: "15", y1: "9", x2: "9", y2: "15" }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("line", { x1: "9", y1: "9", x2: "15", y2: "15" })
-      ]
-    }
-  ),
-  [import_shared9.Severity.WARNING]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-    "svg",
-    {
-      viewBox: "0 0 24 24",
-      width: "16",
-      height: "16",
-      stroke: "currentColor",
-      strokeWidth: "2.5",
-      fill: "none",
-      strokeLinecap: "round",
-      strokeLinejoin: "round",
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z" }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("line", { x1: "12", y1: "9", x2: "12", y2: "13" }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("line", { x1: "12", y1: "17", x2: "12.01", y2: "17" })
-      ]
-    }
-  ),
-  [import_shared9.Severity.INFO]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-    "svg",
-    {
-      viewBox: "0 0 24 24",
-      width: "16",
-      height: "16",
-      stroke: "currentColor",
-      strokeWidth: "2.5",
-      fill: "none",
-      strokeLinecap: "round",
-      strokeLinejoin: "round",
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("circle", { cx: "12", cy: "12", r: "10" }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("line", { x1: "12", y1: "16", x2: "12", y2: "12" }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("line", { x1: "12", y1: "8", x2: "12.01", y2: "8" })
-      ]
-    }
-  )
-};
-function UsageBanner({
-  severity = import_shared9.Severity.CRITICAL,
-  message = "",
-  icon,
-  onClose,
-  actions
-}) {
-  if (!message || !severity) {
-    return null;
-  }
-  const parseMessage = (rawMessage) => {
-    if (rawMessage.toLowerCase().includes("authentication") || rawMessage.toLowerCase().includes("api key")) {
-      return "Authentication failed. Please check your API key.";
-    }
-    if (rawMessage.toLowerCase().includes("rate limit")) {
-      return "Rate limit exceeded. Please try again later.";
-    }
-    if (rawMessage.toLowerCase().includes("checkpointer")) {
-      return "Agent configuration error. Please check your setup.";
-    }
-    let cleanMessage2 = rawMessage;
-    cleanMessage2 = cleanMessage2.split(" - ")[0];
-    cleanMessage2 = cleanMessage2.split(": Error code")[0];
-    cleanMessage2 = cleanMessage2.split(": 401")[0];
-    cleanMessage2 = cleanMessage2.split(": 403")[0];
-    cleanMessage2 = cleanMessage2.split(": 404")[0];
-    cleanMessage2 = cleanMessage2.split(": 500")[0];
-    cleanMessage2 = cleanMessage2.replace(/See more:.*$/g, "").trim();
-    if (cleanMessage2.includes("{") || cleanMessage2.includes("'") || cleanMessage2.length > 60) {
-      return "Configuration error. Please check your setup.";
-    }
-    return cleanMessage2 || "An error occurred. Please check your configuration.";
-  };
-  const cleanMessage = parseMessage(message);
-  const Icon = icon || defaultIcons[severity];
-  const themeConfigs = {
-    [import_shared9.Severity.INFO]: {
-      bg: "rgba(239, 246, 255, 0.95)",
-      border: "#93c5fd",
-      text: "#1e40af",
-      icon: "#3b82f6",
-      primaryBtn: "#3b82f6",
-      primaryBtnHover: "#2563eb"
-    },
-    [import_shared9.Severity.WARNING]: {
-      bg: "rgba(255, 251, 235, 0.95)",
-      border: "#fbbf24",
-      text: "#92400e",
-      icon: "#f59e0b",
-      primaryBtn: "#f59e0b",
-      primaryBtnHover: "#d97706"
-    },
-    [import_shared9.Severity.CRITICAL]: {
-      bg: "rgba(254, 242, 242, 0.95)",
-      border: "#f87171",
-      text: "#991b1b",
-      icon: "#ef4444",
-      primaryBtn: "#ef4444",
-      primaryBtnHover: "#dc2626"
-    }
-  };
-  const themeConfig = themeConfigs[severity] || themeConfigs[import_shared9.Severity.CRITICAL];
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-    "div",
-    {
-      style: {
-        position: "fixed",
-        bottom: "24px",
-        left: "50%",
-        transform: "translateX(-50%)",
-        width: "400px",
-        maxWidth: "90vw",
-        zIndex: 1e4,
-        animation: "bannerSlideIn 0.3s cubic-bezier(0.16, 1, 0.3, 1)"
-      },
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("style", { children: `
-          @keyframes bannerSlideIn {
-            from {
-              opacity: 0;
-              transform: translateX(-50%) translateY(20px);
-              scale: 0.95;
-            }
-            to {
-              opacity: 1;
-              transform: translateX(-50%) translateY(0);
-              scale: 1;
-            }
-          }
-        ` }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-          "div",
-          {
-            style: {
-              borderRadius: "12px",
-              border: `1px solid ${themeConfig.border}`,
-              background: themeConfig.bg,
-              padding: "14px",
-              boxShadow: "0 8px 32px rgba(0, 0, 0, 0.12), 0 2px 8px rgba(0, 0, 0, 0.08)",
-              position: "relative",
-              backdropFilter: "blur(12px)",
-              WebkitBackdropFilter: "blur(12px)",
-              boxSizing: "border-box",
-              overflow: "hidden"
-            },
-            children: [
-              onClose && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                "button",
-                {
-                  onClick: onClose,
-                  style: {
-                    position: "absolute",
-                    top: "8px",
-                    right: "8px",
-                    background: "rgba(255, 255, 255, 0.9)",
-                    border: "none",
-                    color: themeConfig.text,
-                    cursor: "pointer",
-                    fontSize: "16px",
-                    lineHeight: "1",
-                    padding: "4px",
-                    borderRadius: "4px",
-                    width: "20px",
-                    height: "20px",
-                    display: "flex",
-                    alignItems: "center",
-                    justifyContent: "center"
-                  },
-                  title: "Close",
-                  children: "\xD7"
-                }
-              ),
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                "div",
-                {
-                  style: {
-                    fontSize: "14px",
-                    fontWeight: 500,
-                    color: themeConfig.text,
-                    lineHeight: "1.4",
-                    fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
-                    paddingRight: onClose ? "30px" : "0",
-                    marginBottom: actions ? "12px" : "0",
-                    wordBreak: "break-word",
-                    overflow: "hidden",
-                    textOverflow: "ellipsis",
-                    display: "-webkit-box",
-                    WebkitLineClamp: 2,
-                    WebkitBoxOrient: "vertical"
-                  },
-                  children: cleanMessage
-                }
-              ),
-              actions && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-                "div",
-                {
-                  style: {
-                    display: "flex",
-                    gap: "8px",
-                    flexWrap: "wrap"
-                  },
-                  children: [
-                    actions.secondary && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                      "button",
-                      {
-                        onClick: actions.secondary.onClick,
-                        style: {
-                          borderRadius: "8px",
-                          padding: "6px 12px",
-                          fontSize: "13px",
-                          fontWeight: 500,
-                          color: themeConfig.text,
-                          backgroundColor: "rgba(255, 255, 255, 0.9)",
-                          border: `1px solid ${themeConfig.border}`,
-                          cursor: "pointer",
-                          transition: "all 0.2s ease",
-                          fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
-                        },
-                        onMouseOver: (e) => {
-                          e.currentTarget.style.backgroundColor = "rgba(255, 255, 255, 1)";
-                          e.currentTarget.style.transform = "translateY(-1px)";
-                        },
-                        onMouseOut: (e) => {
-                          e.currentTarget.style.backgroundColor = "rgba(255, 255, 255, 0.9)";
-                          e.currentTarget.style.transform = "translateY(0)";
-                        },
-                        children: actions.secondary.label
-                      }
-                    ),
-                    actions.primary && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                      "button",
-                      {
-                        onClick: actions.primary.onClick,
-                        style: {
-                          borderRadius: "8px",
-                          padding: "6px 12px",
-                          fontSize: "13px",
-                          fontWeight: 600,
-                          color: "#fff",
-                          backgroundColor: themeConfig.primaryBtn,
-                          border: "none",
-                          cursor: "pointer",
-                          transition: "all 0.2s ease",
-                          boxShadow: "0 2px 8px rgba(0, 0, 0, 0.15)",
-                          fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
-                        },
-                        onMouseOver: (e) => {
-                          e.currentTarget.style.backgroundColor = themeConfig.primaryBtnHover;
-                          e.currentTarget.style.transform = "translateY(-1px)";
-                          e.currentTarget.style.boxShadow = "0 4px 12px rgba(0, 0, 0, 0.2)";
-                        },
-                        onMouseOut: (e) => {
-                          e.currentTarget.style.backgroundColor = themeConfig.primaryBtn;
-                          e.currentTarget.style.transform = "translateY(0)";
-                          e.currentTarget.style.boxShadow = "0 2px 8px rgba(0, 0, 0, 0.15)";
-                        },
-                        children: actions.primary.label
-                      }
-                    )
-                  ]
-                }
-              )
-            ]
-          }
-        )
-      ]
-    }
-  );
-}
-function renderCopilotKitUsage(error, onClose) {
-  if (error.visibility !== import_shared9.ErrorVisibility.BANNER) {
-    return null;
-  }
-  const extractUrlFromMessage = (message) => {
-    const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
-    const match = linkRegex.exec(message);
-    return match ? match[2] : null;
-  };
-  const getErrorActions = (error2) => {
-    switch (error2.name) {
-      case import_shared9.ERROR_NAMES.MISSING_PUBLIC_API_KEY_ERROR:
-        return {
-          primary: {
-            label: "Sign In",
-            onClick: () => window.location.href = "https://cloud.copilotkit.ai"
-          }
-        };
-      case import_shared9.ERROR_NAMES.UPGRADE_REQUIRED_ERROR:
-        return {
-          primary: {
-            label: "Upgrade",
-            onClick: () => window.location.href = "https://copilotkit.ai/"
-          }
-        };
-      case import_shared9.ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR:
-      case import_shared9.ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR:
-      case import_shared9.ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR:
-        return {
-          primary: {
-            label: "View Docs",
-            onClick: () => {
-              var _a;
-              const urlFromMessage = extractUrlFromMessage(error2.message);
-              const urlFromExtensions = (_a = error2.extensions) == null ? void 0 : _a.troubleshootingUrl;
-              const url = urlFromMessage || urlFromExtensions || "https://docs.copilotkit.ai/troubleshooting/common-issues";
-              window.open(url, "_blank");
-            }
-          }
-        };
-      default:
-        return void 0;
-    }
-  };
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-    UsageBanner,
-    {
-      severity: error.severity || import_shared9.Severity.CRITICAL,
-      message: error.message,
-      onClose,
-      actions: getErrorActions(error)
-    }
-  );
-}
-
 // src/components/error-boundary/error-utils.tsx
 var import_react8 = require("react");
 
@@ -1838,22 +1733,17 @@ var CopilotErrorBoundary = class extends import_react9.default.Component {
     console.error("CopilotKit Error:", error, errorInfo);
   }
   render() {
-    var _a, _b;
+    var _a, _b, _c, _d;
     if (this.state.hasError) {
       if (this.state.error instanceof import_shared10.CopilotKitError) {
-        if (this.state.error.visibility === import_shared10.ErrorVisibility.BANNER) {
-          return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ErrorToast2, { error: this.state.error, children: renderCopilotKitUsage(
-            this.state.error,
-            () => this.setState({ hasError: false, error: void 0 })
-          ) });
-        }
         return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(import_jsx_runtime6.Fragment, { children: [
           this.props.children,
           this.props.showUsageBanner && /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
             UsageBanner,
             {
-              severity: (_a = this.state.status) == null ? void 0 : _a.severity,
-              message: (_b = this.state.status) == null ? void 0 : _b.message
+              severity: (_b = (_a = this.state.status) == null ? void 0 : _a.severity) != null ? _b : this.state.error.severity,
+              message: (_d = (_c = this.state.status) == null ? void 0 : _c.message) != null ? _d : this.state.error.message,
+              actions: getErrorActions(this.state.error)
             }
           )
         ] });
@@ -1863,29 +1753,15 @@ var CopilotErrorBoundary = class extends import_react9.default.Component {
     return this.props.children;
   }
 };
-function ErrorToast2({ error, children }) {
-  const addErrorToast = useErrorToast();
-  (0, import_react9.useEffect)(() => {
-    if (error) {
-      addErrorToast([error]);
-    }
-  }, [error, addErrorToast]);
-  if (!error)
-    throw error;
-  return children;
-}
 
 // src/components/copilot-provider/copilotkit.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
 function CopilotKit(_a) {
   var _b = _a, { children } = _b, props = __objRest(_b, ["children"]);
-  var _a2;
-  const showDevConsole = (_a2 = props.showDevConsole) != null ? _a2 : false;
-  const enabled = shouldShowDevConsole(showDevConsole);
+  const enabled = shouldShowDevConsole(props.showDevConsole);
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ToastProvider, { enabled, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CopilotErrorBoundary, { publicApiKey: props.publicApiKey, showUsageBanner: enabled, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CopilotKitInternal, __spreadProps(__spreadValues({}, props), { children })) }) });
 }
 function CopilotKitInternal(cpkProps) {
-  var _b, _c;
   const _a = cpkProps, { children } = _a, props = __objRest(_a, ["children"]);
   validateProps(cpkProps);
   const chatApiEndpoint = props.runtimeUrl || import_shared11.COPILOT_CLOUD_CHAT_URL;
@@ -1989,7 +1865,7 @@ ${nonDocumentStrings}`;
     [removeDocument]
   );
   const copilotApiConfig = (0, import_react10.useMemo)(() => {
-    var _a2, _b2;
+    var _a2, _b;
     let cloud = void 0;
     if (props.publicApiKey) {
       cloud = {
@@ -1998,7 +1874,7 @@ ${nonDocumentStrings}`;
             restrictToTopic: {
               enabled: Boolean(props.guardrails_c),
               validTopics: ((_a2 = props.guardrails_c) == null ? void 0 : _a2.validTopics) || [],
-              invalidTopics: ((_b2 = props.guardrails_c) == null ? void 0 : _b2.invalidTopics) || []
+              invalidTopics: ((_b = props.guardrails_c) == null ? void 0 : _b.invalidTopics) || []
             }
           }
         }
@@ -2043,7 +1919,7 @@ ${nonDocumentStrings}`;
     publicApiKey: copilotApiConfig.publicApiKey,
     headers,
     credentials: copilotApiConfig.credentials,
-    showDevConsole: (_b = props.showDevConsole) != null ? _b : false,
+    showDevConsole: shouldShowDevConsole(props.showDevConsole),
     onError: props.onError
   });
   const [chatSuggestionConfiguration, setChatSuggestionConfiguration] = (0, import_react10.useState)({});
@@ -2122,7 +1998,7 @@ ${nonDocumentStrings}`;
   }, [props.threadId]);
   const [runId, setRunId] = (0, import_react10.useState)(null);
   const chatAbortControllerRef = (0, import_react10.useRef)(null);
-  const showDevConsole = (_c = props.showDevConsole) != null ? _c : false;
+  const showDevConsole = shouldShowDevConsole(props.showDevConsole);
   const [langGraphInterruptAction, _setLangGraphInterruptAction] = (0, import_react10.useState)(null);
   const setLangGraphInterruptAction = (0, import_react10.useCallback)((action) => {
     _setLangGraphInterruptAction((prev) => {
@@ -2141,7 +2017,7 @@ ${nonDocumentStrings}`;
     setLangGraphInterruptAction(null);
   }, []);
   const memoizedChildren = (0, import_react10.useMemo)(() => children, [children]);
-  const [suggestions, setSuggestions] = (0, import_react10.useState)([]);
+  const [bannerError, setBannerError] = (0, import_react10.useState)(null);
   const agentLock = (0, import_react10.useMemo)(() => {
     var _a2;
     return (_a2 = props.agent) != null ? _a2 : null;
@@ -2177,7 +2053,7 @@ ${nonDocumentStrings}`;
     },
     [setAuthStates]
   );
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
     CopilotContext.Provider,
     {
       value: {
@@ -2231,10 +2107,21 @@ ${nonDocumentStrings}`;
         setLangGraphInterruptAction,
         removeLangGraphInterruptAction,
         onError: props.onError,
-        suggestions,
-        setSuggestions
+        bannerError,
+        setBannerError
       },
-      children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CopilotMessages, { children: memoizedChildren })
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(MessagesTapProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CopilotMessages, { children: memoizedChildren }) }),
+        bannerError && showDevConsole && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+          UsageBanner,
+          {
+            severity: bannerError.severity,
+            message: bannerError.message,
+            onClose: () => setBannerError(null),
+            actions: getErrorActions(bannerError)
+          }
+        )
+      ]
     }
   );
 }
@@ -2279,7 +2166,7 @@ function validateProps(props) {
   }
 }
 
-// src/hooks/use-copilot-chat.ts
+// src/hooks/use-copilot-chat_internal.ts
 var import_react13 = require("react");
 
 // src/hooks/use-chat.ts
@@ -2970,7 +2857,7 @@ function getPairedFeAction(actions, message) {
   );
 }
 
-// src/hooks/use-copilot-chat.ts
+// src/hooks/use-copilot-chat_internal.ts
 var import_runtime_client_gql8 = require("@copilotkit/runtime-client-gql");
 
 // src/hooks/use-langgraph-interrupt-render.ts
@@ -3012,7 +2899,7 @@ function useLangGraphInterruptRender() {
   });
 }
 
-// src/hooks/use-copilot-chat.ts
+// src/hooks/use-copilot-chat_internal.ts
 var globalSuggestionPromise = null;
 function useCopilotChat(options = {}) {
   var _a;
@@ -3042,11 +2929,9 @@ function useCopilotChat(options = {}) {
     langGraphInterruptAction,
     setLangGraphInterruptAction,
     chatSuggestionConfiguration,
-    suggestions,
-    setSuggestions,
     runtimeClient
   } = useCopilotContext();
-  const { messages, setMessages } = useCopilotMessagesContext();
+  const { messages, setMessages, suggestions, setSuggestions } = useCopilotMessagesContext();
   const [mcpServers, setLocalMcpServers] = (0, import_react13.useState)([]);
   const suggestionsAbortControllerRef = (0, import_react13.useRef)(null);
   const isLoadingSuggestionsRef = (0, import_react13.useRef)(false);
@@ -3179,6 +3064,13 @@ function useCopilotChat(options = {}) {
   }));
   const latestAppend = useUpdatedRef(append);
   const latestAppendFunc = useAsyncCallback(
+    (message, options2) => __async(this, null, function* () {
+      abortSuggestions(options2 == null ? void 0 : options2.clearSuggestions);
+      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);
@@ -3206,6 +3098,9 @@ function useCopilotChat(options = {}) {
   const latestSetMessages = useUpdatedRef(setMessages);
   const latestSetMessagesFunc = (0, import_react13.useCallback)(
     (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]
@@ -3242,7 +3137,9 @@ function useCopilotChat(options = {}) {
   }, [latestReset]);
   const interrupt = useLangGraphInterruptRender();
   return {
-    visibleMessages: (0, import_runtime_client_gql8.gqlToAGUI)(messages, actions, coAgentStateRenders),
+    visibleMessages: messages,
+    messages: (0, import_runtime_client_gql8.gqlToAGUI)(messages, actions, coAgentStateRenders),
+    sendMessage: latestSendMessageFunc,
     appendMessage: latestAppendFunc,
     setMessages: latestSetMessagesFunc,
     reloadMessages: latestReloadFunc,
@@ -3295,14 +3192,105 @@ In case of a function error:
 ${additionalInstructions}` : "");
 }
 
-// src/hooks/use-copilot-action.ts
-var import_shared14 = require("@copilotkit/shared");
+// 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_react14 = require("react");
+var import_shared14 = 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_react14.useEffect)(() => {
+    if (!hasPublicApiKey) {
+      setBannerError(
+        new import_shared14.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_shared14.CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR,
+          severity: import_shared14.Severity.WARNING,
+          visibility: import_shared14.ErrorVisibility.BANNER
+        })
+      );
+      import_shared14.styledConsole.logCopilotKitPlatformMessage();
+    } else {
+      setBannerError(null);
+    }
+  }, [hasPublicApiKey]);
+  if (hasPublicApiKey) {
+    return internalResult;
+  }
+  return createNonFunctionalReturn();
+}
+
+// src/hooks/use-copilot-action.ts
+var import_shared15 = require("@copilotkit/shared");
+var import_react15 = require("react");
 function useCopilotAction(action, dependencies) {
   const { setAction, removeAction, actions, chatComponentsCache } = useCopilotContext();
-  const idRef = (0, import_react14.useRef)((0, import_shared14.randomId)());
-  const renderAndWaitRef = (0, import_react14.useRef)(null);
-  const activatingMessageIdRef = (0, import_react14.useRef)(null);
+  const idRef = (0, import_react15.useRef)((0, import_shared15.randomId)());
+  const renderAndWaitRef = (0, import_react15.useRef)(null);
+  const activatingMessageIdRef = (0, import_react15.useRef)(null);
   const { addToast } = useToast();
   action = __spreadValues({}, action);
   if (
@@ -3364,7 +3352,7 @@ function useCopilotAction(action, dependencies) {
           return renderAndWait(waitProps);
         }
       }
-      return (0, import_react14.createElement)(import_react14.Fragment);
+      return (0, import_react15.createElement)(import_react15.Fragment);
     };
   }
   if (dependencies === void 0) {
@@ -3379,7 +3367,7 @@ function useCopilotAction(action, dependencies) {
       }
     }
   }
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     const hasDuplicate = Object.values(actions).some(
       (otherAction) => otherAction.name === action.name && otherAction !== actions[idRef.current]
     );
@@ -3391,7 +3379,7 @@ function useCopilotAction(action, dependencies) {
       });
     }
   }, [actions]);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     setAction(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.actions[action.name] = action.render;
@@ -3420,8 +3408,8 @@ function isFrontendAction(action) {
 }
 
 // src/hooks/use-coagent-state-render.ts
-var import_react15 = require("react");
-var import_shared15 = require("@copilotkit/shared");
+var import_react16 = require("react");
+var import_shared16 = require("@copilotkit/shared");
 function useCoAgentStateRender(action, dependencies) {
   const {
     setCoAgentStateRender,
@@ -3429,13 +3417,13 @@ function useCoAgentStateRender(action, dependencies) {
     coAgentStateRenders,
     chatComponentsCache,
     availableAgents
-  } = (0, import_react15.useContext)(CopilotContext);
-  const idRef = (0, import_react15.useRef)((0, import_shared15.randomId)());
+  } = (0, import_react16.useContext)(CopilotContext);
+  const idRef = (0, import_react16.useRef)((0, import_shared16.randomId)());
   const { setBannerError, addToast } = useToast();
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.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_shared15.CopilotKitAgentDiscoveryError({
+      const agentError = new import_shared16.CopilotKitAgentDiscoveryError({
         agentName: action.name,
         availableAgents: availableAgents.map((a) => ({ name: a.name, id: a.id }))
       });
@@ -3453,7 +3441,7 @@ function useCoAgentStateRender(action, dependencies) {
       }
     }
   }
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     const currentId = idRef.current;
     const hasDuplicate = Object.entries(coAgentStateRenders).some(([id, otherAction]) => {
       if (id === currentId)
@@ -3477,7 +3465,7 @@ function useCoAgentStateRender(action, dependencies) {
       });
     }
   }, [coAgentStateRenders]);
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     setCoAgentStateRender(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.coAgentStateRenders[key] = action.render;
@@ -3497,11 +3485,11 @@ function useCoAgentStateRender(action, dependencies) {
 }
 
 // src/hooks/use-make-copilot-document-readable.ts
-var import_react16 = require("react");
+var import_react17 = require("react");
 function useMakeCopilotDocumentReadable(document, categories, dependencies = []) {
   const { addDocumentContext, removeDocumentContext } = useCopilotContext();
-  const idRef = (0, import_react16.useRef)();
-  (0, import_react16.useEffect)(() => {
+  const idRef = (0, import_react17.useRef)();
+  (0, import_react17.useEffect)(() => {
     const id = addDocumentContext(document, categories);
     idRef.current = id;
     return () => {
@@ -3512,7 +3500,7 @@ function useMakeCopilotDocumentReadable(document, categories, dependencies = [])
 }
 
 // src/hooks/use-copilot-readable.ts
-var import_react17 = require("react");
+var import_react18 = require("react");
 function convertToJSON(description, value) {
   return `${description}: ${typeof value === "string" ? value : JSON.stringify(value)}`;
 }
@@ -3525,10 +3513,10 @@ function useCopilotReadable({
   available = "enabled"
 }, dependencies) {
   const { addContext, removeContext } = useCopilotContext();
-  const idRef = (0, import_react17.useRef)();
+  const idRef = (0, import_react18.useRef)();
   convert = convert || convertToJSON;
   const information = convert(description, value);
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     if (available === "disabled")
       return;
     const id = addContext(information, parentId, categories);
@@ -3541,30 +3529,29 @@ function useCopilotReadable({
 }
 
 // src/hooks/use-coagent.ts
-var import_react18 = require("react");
-var import_shared16 = require("@copilotkit/shared");
+var import_react19 = require("react");
+var import_shared17 = 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_react18.useRef)();
-  const lastLoadedState = (0, import_react18.useRef)();
+  const lastLoadedThreadId = (0, import_react19.useRef)();
+  const lastLoadedState = (0, import_react19.useRef)();
   const { name } = options;
-  (0, import_react18.useEffect)(() => {
+  (0, import_react19.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_shared16.CopilotKitAgentDiscoveryError({
+      const agentError = new import_shared17.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,
@@ -3573,7 +3560,7 @@ function useCoAgent(options) {
     credentials: copilotApiConfig.credentials,
     showDevConsole: context.showDevConsole
   });
-  const setState = (0, import_react18.useCallback)(
+  const setState = (0, import_react19.useCallback)(
     (newState) => {
       let coagentState = getCoagentState({ coagentStates, name, options });
       const updatedState = typeof newState === "function" ? newState(coagentState.state) : newState;
@@ -3585,7 +3572,7 @@ function useCoAgent(options) {
     },
     [coagentStates, name]
   );
-  (0, import_react18.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     const fetchAgentState = () => __async(this, null, function* () {
       var _a, _b, _c, _d;
       if (!threadId || threadId === lastLoadedThreadId.current)
@@ -3603,13 +3590,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_shared16.parseJson)(newState, {});
+        const fetchedState = (0, import_shared17.parseJson)(newState, {});
         isExternalStateManagement(options) ? options.setState(fetchedState) : setState(fetchedState);
       }
     });
     void fetchAgentState();
   }, [threadId]);
-  (0, import_react18.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     if (isExternalStateManagement(options)) {
       setState(options.state);
     } else if (coagentStates[name] === void 0) {
@@ -3620,7 +3607,7 @@ function useCoAgent(options) {
     // reset initialstate on reset
     coagentStates[name] === void 0
   ]);
-  (0, import_react18.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     const newConfig = options.config ? options.config : options.configurable ? { configurable: options.configurable } : void 0;
     if (newConfig === void 0)
       return;
@@ -3648,11 +3635,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_react18.useMemo)(() => {
+  return (0, import_react19.useMemo)(() => {
     const coagentState = getCoagentState({ coagentStates, name, options });
     return {
       name,
@@ -3692,7 +3679,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;
@@ -3702,8 +3689,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;
       }
@@ -3712,7 +3699,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();
       }
@@ -3749,28 +3736,28 @@ var getCoagentState = ({
 };
 
 // src/hooks/use-copilot-authenticated-action.ts
-var import_react19 = require("react");
-var import_react20 = __toESM(require("react"));
+var import_react20 = require("react");
+var import_react21 = __toESM(require("react"));
 function useCopilotAuthenticatedAction_c(action, dependencies) {
   const { authConfig_c, authStates_c, setAuthStates_c } = useCopilotContext();
-  const pendingActionRef = (0, import_react19.useRef)(null);
-  const executeAction2 = (0, import_react19.useCallback)(
+  const pendingActionRef = (0, import_react20.useRef)(null);
+  const executeAction2 = (0, import_react20.useCallback)(
     (props) => {
       if (typeof action.render === "function") {
         return action.render(props);
       }
-      return action.render || import_react20.default.createElement(import_react19.Fragment);
+      return action.render || import_react21.default.createElement(import_react20.Fragment);
     },
     [action]
   );
-  const wrappedRender = (0, import_react19.useCallback)(
+  const wrappedRender = (0, import_react20.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_react20.default.createElement(authConfig_c.SignInComponent, {
+        return (authConfig_c == null ? void 0 : authConfig_c.SignInComponent) ? import_react21.default.createElement(authConfig_c.SignInComponent, {
           onSignInComplete: (authState) => {
             setAuthStates_c == null ? void 0 : setAuthStates_c((prev) => __spreadProps(__spreadValues({}, prev), { [action.name]: authState }));
             if (pendingActionRef.current) {
@@ -3778,7 +3765,7 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
               pendingActionRef.current = null;
             }
           }
-        }) : import_react20.default.createElement(import_react19.Fragment);
+        }) : import_react21.default.createElement(import_react20.Fragment);
       }
       return executeAction2(props);
     },
@@ -3793,29 +3780,29 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
 }
 
 // src/hooks/use-langgraph-interrupt.ts
-var import_react21 = require("react");
-var import_shared17 = require("@copilotkit/shared");
+var import_react22 = require("react");
+var import_shared18 = require("@copilotkit/shared");
 function useLangGraphInterrupt(action, dependencies) {
   var _a;
-  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react21.useContext)(CopilotContext);
+  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react22.useContext)(CopilotContext);
   const { runChatCompletion } = useCopilotChat();
   const { addToast } = useToast();
-  const actionId = (0, import_shared17.dataToUUID)(JSON.stringify(action), "lgAction");
-  const hasAction = (0, import_react21.useMemo)(
+  const actionId = (0, import_shared18.dataToUUID)(JSON.stringify(action), "lgAction");
+  const hasAction = (0, import_react22.useMemo)(
     () => Boolean(langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id),
     [langGraphInterruptAction]
   );
-  const isCurrentAction = (0, import_react21.useMemo)(
+  const isCurrentAction = (0, import_react22.useMemo)(
     () => (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) && (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) === actionId,
     [langGraphInterruptAction]
   );
-  (0, import_react21.useEffect)(() => {
+  (0, import_react22.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_react21.useEffect)(() => {
+  (0, import_react22.useEffect)(() => {
     if (!action)
       return;
     if (hasAction && !isCurrentAction && !action.enabled) {
@@ -3840,10 +3827,10 @@ function useLangGraphInterrupt(action, dependencies) {
 }
 
 // src/hooks/use-copilot-additional-instructions.ts
-var import_react22 = require("react");
+var import_react23 = require("react");
 function useCopilotAdditionalInstructions({ instructions, available = "enabled" }, dependencies) {
   const { setAdditionalInstructions } = useCopilotContext();
-  (0, import_react22.useEffect)(() => {
+  (0, import_react23.useEffect)(() => {
     if (available === "disabled")
       return;
     setAdditionalInstructions((prevInstructions) => [...prevInstructions || [], instructions]);
@@ -3971,6 +3958,8 @@ ${instructions}
   useCopilotAdditionalInstructions,
   useCopilotAuthenticatedAction_c,
   useCopilotChat,
+  useCopilotChatHeadless_c,
+  useCopilotChatInternal,
   useCopilotContext,
   useCopilotMessagesContext,
   useCopilotReadable,