@copilotkit/react-core 1.9.3-next.4 → 1.10.0-next.0

package/dist/index.js

@@ -85,8 +85,10 @@ __export(src_exports, {
   CopilotKit: () => CopilotKit,
   CopilotMessagesContext: () => CopilotMessagesContext,
   CopilotTask: () => CopilotTask,
+  SUGGESTION_RETRY_CONFIG: () => SUGGESTION_RETRY_CONFIG,
   defaultCopilotContextCategories: () => defaultCopilotContextCategories,
   extract: () => extract,
+  reloadSuggestions: () => reloadSuggestions,
   runAgent: () => runAgent,
   shouldShowDevConsole: () => shouldShowDevConsole,
   startAgent: () => startAgent,
@@ -184,7 +186,10 @@ var emptyCopilotContext = {
   langGraphInterruptAction: null,
   setLangGraphInterruptAction: () => null,
   removeLangGraphInterruptAction: () => null,
-  onError: void 0
+  onError: void 0,
+  suggestions: [],
+  setSuggestions: () => {
+  }
 };
 var CopilotContext = import_react.default.createContext(emptyCopilotContext);
 function useCopilotContext() {
@@ -334,7 +339,7 @@ function setsHaveIntersection(setA, setB) {
 
 // src/components/copilot-provider/copilotkit.tsx
 var import_react_dom = require("react-dom");
-var import_shared10 = require("@copilotkit/shared");
+var import_shared11 = require("@copilotkit/shared");
 
 // src/hooks/use-flat-category-store.ts
 var import_react3 = require("react");
@@ -1144,12 +1149,152 @@ 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_runtime_client_gql5 = 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) {
+    return;
+  }
+  const setSuggestionsIfNotAborted = (suggestions) => {
+    if (!(abortController == null ? void 0 : abortController.signal.aborted) && abortControllerRef.current === abortController) {
+      setCurrentSuggestions(suggestions);
+    }
+  };
+  try {
+    const tools = JSON.stringify(
+      Object.values(context.actions).map((action) => ({
+        name: action.name,
+        description: action.description,
+        jsonSchema: JSON.stringify((0, import_shared7.actionParametersToJsonSchema)(action.parameters))
+      }))
+    );
+    const allSuggestions = [];
+    let hasSuccessfulSuggestions = false;
+    let hasErrors = false;
+    let lastError = null;
+    const enabledConfigs = Object.values(chatSuggestionConfiguration).filter(
+      (config) => config.instructions && config.instructions.trim().length > 0
+    );
+    if (enabledConfigs.length === 0) {
+      return;
+    }
+    setSuggestionsIfNotAborted([]);
+    for (const config of enabledConfigs) {
+      if (abortController == null ? void 0 : abortController.signal.aborted) {
+        setSuggestionsIfNotAborted([]);
+        return;
+      }
+      try {
+        const result = yield extract({
+          context,
+          instructions: "Suggest what the user could say next. Provide clear, highly relevant suggestions. Do not literally suggest function calls. ",
+          data: `${config.instructions}
+
+Available tools: ${tools}
+
+`,
+          requestType: import_runtime_client_gql5.CopilotRequestType.Task,
+          parameters: [
+            {
+              name: "suggestions",
+              type: "object[]",
+              attributes: [
+                {
+                  name: "title",
+                  description: "The title of the suggestion. This is shown as a button and should be short.",
+                  type: "string"
+                },
+                {
+                  name: "message",
+                  description: "The message to send when the suggestion is clicked. This should be a clear, complete sentence and will be sent as an instruction to the AI.",
+                  type: "string"
+                }
+              ]
+            }
+          ],
+          include: {
+            messages: true,
+            readable: true
+          },
+          abortSignal: abortController == null ? void 0 : abortController.signal,
+          stream: ({ status, args }) => {
+            if (abortController == null ? void 0 : abortController.signal.aborted) {
+              return;
+            }
+            const suggestions = args.suggestions || [];
+            const newSuggestions = [];
+            for (let i = 0; i < suggestions.length; i++) {
+              if (config.maxSuggestions !== void 0 && i >= config.maxSuggestions) {
+                break;
+              }
+              const suggestion = suggestions[i];
+              if (!suggestion || typeof suggestion !== "object") {
+                continue;
+              }
+              const { title, message } = suggestion;
+              const hasValidTitle = title && typeof title === "string" && title.trim().length > 0;
+              const hasValidMessage = message && typeof message === "string" && message.trim().length > 0;
+              if (!hasValidTitle) {
+                continue;
+              }
+              const partial = i === suggestions.length - 1 && status !== "complete";
+              newSuggestions.push({
+                title: title.trim(),
+                message: hasValidMessage ? message.trim() : "",
+                // Use title as fallback
+                partial,
+                className: config.className
+              });
+            }
+            setSuggestionsIfNotAborted([...allSuggestions, ...newSuggestions]);
+          }
+        });
+        if ((result == null ? void 0 : result.suggestions) && Array.isArray(result.suggestions)) {
+          const validSuggestions = result.suggestions.filter(
+            (suggestion) => suggestion && typeof suggestion.title === "string" && suggestion.title.trim().length > 0
+          ).map((suggestion) => ({
+            title: suggestion.title.trim(),
+            message: suggestion.message && typeof suggestion.message === "string" && suggestion.message.trim() ? suggestion.message.trim() : suggestion.title.trim()
+          }));
+          if (validSuggestions.length > 0) {
+            allSuggestions.push(...validSuggestions);
+            hasSuccessfulSuggestions = true;
+          }
+        }
+      } catch (error) {
+        hasErrors = true;
+        lastError = error instanceof Error ? error : new Error(String(error));
+      }
+    }
+    if (hasSuccessfulSuggestions && allSuggestions.length > 0) {
+      const uniqueSuggestions = allSuggestions.filter(
+        (suggestion, index, self) => index === self.findIndex((s) => s.message === suggestion.message)
+      );
+      setSuggestionsIfNotAborted(uniqueSuggestions);
+    } else if (hasErrors) {
+      const errorMessage = lastError ? lastError.message : "Failed to generate suggestions due to API errors";
+      throw new Error(errorMessage);
+    }
+  } catch (error) {
+    throw error;
+  }
+});
+
+// src/utils/suggestions-constants.ts
+var SUGGESTION_RETRY_CONFIG = {
+  MAX_RETRIES: 3,
+  COOLDOWN_MS: 5e3
+  // 5 seconds
+};
+
 // src/components/error-boundary/error-boundary.tsx
 var import_react9 = __toESM(require("react"));
-var import_shared9 = require("@copilotkit/shared");
+var import_shared10 = require("@copilotkit/shared");
 
 // src/lib/status-checker.ts
-var import_shared7 = require("@copilotkit/shared");
+var import_shared8 = require("@copilotkit/shared");
 var STATUS_CHECK_INTERVAL = 1e3 * 60 * 5;
 var StatusChecker = class {
   constructor() {
@@ -1167,10 +1312,10 @@ var StatusChecker = class {
         clearInterval(this.intervalId);
       const checkStatus = () => __async(this, null, function* () {
         try {
-          const response = yield fetch(`${import_shared7.COPILOT_CLOUD_API_URL}/ciu`, {
+          const response = yield fetch(`${import_shared8.COPILOT_CLOUD_API_URL}/ciu`, {
             method: "GET",
             headers: {
-              [import_shared7.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey
+              [import_shared8.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey
             }
           }).then((response2) => response2.json());
           this.lastResponse = response;
@@ -1203,10 +1348,10 @@ var StatusChecker = class {
 };
 
 // src/components/usage-banner.tsx
-var import_shared8 = require("@copilotkit/shared");
+var import_shared9 = require("@copilotkit/shared");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var defaultIcons = {
-  [import_shared8.Severity.CRITICAL]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+  [import_shared9.Severity.CRITICAL]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -1224,7 +1369,7 @@ var defaultIcons = {
       ]
     }
   ),
-  [import_shared8.Severity.WARNING]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+  [import_shared9.Severity.WARNING]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -1242,7 +1387,7 @@ var defaultIcons = {
       ]
     }
   ),
-  [import_shared8.Severity.INFO]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+  [import_shared9.Severity.INFO]: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -1262,7 +1407,7 @@ var defaultIcons = {
   )
 };
 function UsageBanner({
-  severity = import_shared8.Severity.CRITICAL,
+  severity = import_shared9.Severity.CRITICAL,
   message = "",
   icon,
   onClose,
@@ -1297,7 +1442,7 @@ function UsageBanner({
   const cleanMessage = parseMessage(message);
   const Icon = icon || defaultIcons[severity];
   const themeConfigs = {
-    [import_shared8.Severity.INFO]: {
+    [import_shared9.Severity.INFO]: {
       bg: "rgba(239, 246, 255, 0.95)",
       border: "#93c5fd",
       text: "#1e40af",
@@ -1305,7 +1450,7 @@ function UsageBanner({
       primaryBtn: "#3b82f6",
       primaryBtnHover: "#2563eb"
     },
-    [import_shared8.Severity.WARNING]: {
+    [import_shared9.Severity.WARNING]: {
       bg: "rgba(255, 251, 235, 0.95)",
       border: "#fbbf24",
       text: "#92400e",
@@ -1313,7 +1458,7 @@ function UsageBanner({
       primaryBtn: "#f59e0b",
       primaryBtnHover: "#d97706"
     },
-    [import_shared8.Severity.CRITICAL]: {
+    [import_shared9.Severity.CRITICAL]: {
       bg: "rgba(254, 242, 242, 0.95)",
       border: "#f87171",
       text: "#991b1b",
@@ -1322,7 +1467,7 @@ function UsageBanner({
       primaryBtnHover: "#dc2626"
     }
   };
-  const themeConfig = themeConfigs[severity] || themeConfigs[import_shared8.Severity.CRITICAL];
+  const themeConfig = themeConfigs[severity] || themeConfigs[import_shared9.Severity.CRITICAL];
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
     "div",
     {
@@ -1491,7 +1636,7 @@ function UsageBanner({
   );
 }
 function renderCopilotKitUsage(error, onClose) {
-  if (error.visibility !== import_shared8.ErrorVisibility.BANNER) {
+  if (error.visibility !== import_shared9.ErrorVisibility.BANNER) {
     return null;
   }
   const extractUrlFromMessage = (message) => {
@@ -1501,23 +1646,23 @@ function renderCopilotKitUsage(error, onClose) {
   };
   const getErrorActions = (error2) => {
     switch (error2.name) {
-      case import_shared8.ERROR_NAMES.MISSING_PUBLIC_API_KEY_ERROR:
+      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_shared8.ERROR_NAMES.UPGRADE_REQUIRED_ERROR:
+      case import_shared9.ERROR_NAMES.UPGRADE_REQUIRED_ERROR:
         return {
           primary: {
             label: "Upgrade",
             onClick: () => window.location.href = "https://copilotkit.ai/"
           }
         };
-      case import_shared8.ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR:
-      case import_shared8.ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR:
-      case import_shared8.ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR:
+      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",
@@ -1537,7 +1682,7 @@ function renderCopilotKitUsage(error, onClose) {
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
     UsageBanner,
     {
-      severity: error.severity || import_shared8.Severity.CRITICAL,
+      severity: error.severity || import_shared9.Severity.CRITICAL,
       message: error.message,
       onClose,
       actions: getErrorActions(error)
@@ -1695,8 +1840,8 @@ var CopilotErrorBoundary = class extends import_react9.default.Component {
   render() {
     var _a, _b;
     if (this.state.hasError) {
-      if (this.state.error instanceof import_shared9.CopilotKitError) {
-        if (this.state.error.visibility === import_shared9.ErrorVisibility.BANNER) {
+      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 })
@@ -1743,7 +1888,7 @@ function CopilotKitInternal(cpkProps) {
   var _b, _c;
   const _a = cpkProps, { children } = _a, props = __objRest(_a, ["children"]);
   validateProps(cpkProps);
-  const chatApiEndpoint = props.runtimeUrl || import_shared10.COPILOT_CLOUD_CHAT_URL;
+  const chatApiEndpoint = props.runtimeUrl || import_shared11.COPILOT_CLOUD_CHAT_URL;
   const [actions, setActions] = (0, import_react10.useState)({});
   const [coAgentStateRenders, setCoAgentStateRenders] = (0, import_react10.useState)({});
   const chatComponentsCache = (0, import_react10.useRef)({
@@ -1891,7 +2036,7 @@ ${nonDocumentStrings}`;
       }
       return acc;
     }, {});
-    return __spreadValues(__spreadValues(__spreadValues({}, copilotApiConfig.headers || {}), copilotApiConfig.publicApiKey ? { [import_shared10.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: copilotApiConfig.publicApiKey } : {}), authHeaders);
+    return __spreadValues(__spreadValues(__spreadValues({}, copilotApiConfig.headers || {}), copilotApiConfig.publicApiKey ? { [import_shared11.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: copilotApiConfig.publicApiKey } : {}), authHeaders);
   }, [copilotApiConfig.headers, copilotApiConfig.publicApiKey, authStates]);
   const runtimeClient = useCopilotRuntimeClient({
     url: copilotApiConfig.chatApiEndpoint,
@@ -1960,7 +2105,7 @@ ${nonDocumentStrings}`;
       setAgentSession(null);
     }
   }, [props.agent]);
-  const [internalThreadId, setInternalThreadId] = (0, import_react10.useState)(props.threadId || (0, import_shared10.randomUUID)());
+  const [internalThreadId, setInternalThreadId] = (0, import_react10.useState)(props.threadId || (0, import_shared11.randomUUID)());
   const setThreadId = (0, import_react10.useCallback)(
     (value) => {
       if (props.threadId) {
@@ -1996,6 +2141,7 @@ ${nonDocumentStrings}`;
     setLangGraphInterruptAction(null);
   }, []);
   const memoizedChildren = (0, import_react10.useMemo)(() => children, [children]);
+  const [suggestions, setSuggestions] = (0, import_react10.useState)([]);
   const agentLock = (0, import_react10.useMemo)(() => {
     var _a2;
     return (_a2 = props.agent) != null ? _a2 : null;
@@ -2084,7 +2230,9 @@ ${nonDocumentStrings}`;
         langGraphInterruptAction,
         setLangGraphInterruptAction,
         removeLangGraphInterruptAction,
-        onError: props.onError
+        onError: props.onError,
+        suggestions,
+        setSuggestions
       },
       children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CopilotMessages, { children: memoizedChildren })
     }
@@ -2122,44 +2270,43 @@ function formatFeatureName(featureName) {
 function validateProps(props) {
   const cloudFeatures = Object.keys(props).filter((key) => key.endsWith("_c"));
   if (!props.runtimeUrl && !props.publicApiKey) {
-    throw new import_shared10.ConfigurationError("Missing required prop: 'runtimeUrl' or 'publicApiKey'");
+    throw new import_shared11.ConfigurationError("Missing required prop: 'runtimeUrl' or 'publicApiKey'");
   }
   if (cloudFeatures.length > 0 && !props.publicApiKey) {
-    throw new import_shared10.MissingPublicApiKeyError(
+    throw new import_shared11.MissingPublicApiKeyError(
       `Missing required prop: 'publicApiKey' to use cloud features: ${cloudFeatures.map(formatFeatureName).join(", ")}`
     );
   }
 }
 
 // src/hooks/use-copilot-chat.ts
-var import_react12 = require("react");
-var import_runtime_client_gql7 = require("@copilotkit/runtime-client-gql");
+var import_react13 = require("react");
 
 // src/hooks/use-chat.ts
 var import_react11 = require("react");
 var import_react_dom2 = require("react-dom");
-var import_shared12 = require("@copilotkit/shared");
-var import_runtime_client_gql6 = require("@copilotkit/runtime-client-gql");
+var import_shared13 = require("@copilotkit/shared");
+var import_runtime_client_gql7 = require("@copilotkit/runtime-client-gql");
 
 // src/types/frontend-action.ts
-var import_runtime_client_gql5 = require("@copilotkit/runtime-client-gql");
-var import_shared11 = require("@copilotkit/shared");
+var import_runtime_client_gql6 = require("@copilotkit/runtime-client-gql");
+var import_shared12 = require("@copilotkit/shared");
 function processActionsForRuntimeRequest(actions) {
   const filteredActions = actions.filter(
-    (action) => action.available !== import_runtime_client_gql5.ActionInputAvailability.Disabled && action.disabled !== true && action.name !== "*" && action.available != "frontend" && !action.pairedAction
+    (action) => action.available !== import_runtime_client_gql6.ActionInputAvailability.Disabled && action.disabled !== true && action.name !== "*" && action.available != "frontend" && !action.pairedAction
   ).map((action) => {
-    let available = import_runtime_client_gql5.ActionInputAvailability.Enabled;
+    let available = import_runtime_client_gql6.ActionInputAvailability.Enabled;
     if (action.disabled) {
-      available = import_runtime_client_gql5.ActionInputAvailability.Disabled;
+      available = import_runtime_client_gql6.ActionInputAvailability.Disabled;
     } else if (action.available === "disabled") {
-      available = import_runtime_client_gql5.ActionInputAvailability.Disabled;
+      available = import_runtime_client_gql6.ActionInputAvailability.Disabled;
     } else if (action.available === "remote") {
-      available = import_runtime_client_gql5.ActionInputAvailability.Remote;
+      available = import_runtime_client_gql6.ActionInputAvailability.Remote;
     }
     return {
       name: action.name,
       description: action.description || "",
-      jsonSchema: JSON.stringify((0, import_shared11.actionParametersToJsonSchema)(action.parameters || [])),
+      jsonSchema: JSON.stringify((0, import_shared12.actionParametersToJsonSchema)(action.parameters || [])),
       available
     };
   });
@@ -2232,7 +2379,7 @@ function useChat(options) {
   const extensionsRef = (0, import_react11.useRef)(extensions);
   extensionsRef.current = extensions;
   const publicApiKey = copilotConfig.publicApiKey;
-  const headers = __spreadValues(__spreadValues({}, copilotConfig.headers || {}), publicApiKey ? { [import_shared12.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey } : {});
+  const headers = __spreadValues(__spreadValues({}, copilotConfig.headers || {}), publicApiKey ? { [import_shared13.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER]: publicApiKey } : {});
   const { showDevConsole } = useCopilotContext();
   const runtimeClient = useCopilotRuntimeClient({
     url: copilotConfig.chatApiEndpoint,
@@ -2247,7 +2394,7 @@ function useChat(options) {
       var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t;
       setIsLoading(true);
       const interruptEvent = langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.event;
-      if ((interruptEvent == null ? void 0 : interruptEvent.name) === import_runtime_client_gql6.MetaEventName.LangGraphInterruptEvent && (interruptEvent == null ? void 0 : interruptEvent.value) && !(interruptEvent == null ? void 0 : interruptEvent.response) && agentSessionRef.current) {
+      if ((interruptEvent == null ? void 0 : interruptEvent.name) === import_runtime_client_gql7.MetaEventName.LangGraphInterruptEvent && (interruptEvent == null ? void 0 : interruptEvent.value) && !(interruptEvent == null ? void 0 : interruptEvent.response) && agentSessionRef.current) {
         addErrorToast([
           new Error(
             "A message was sent while interrupt is active. This will cause failure on the agent side"
@@ -2255,9 +2402,9 @@ function useChat(options) {
         ]);
       }
       let newMessages = [
-        new import_runtime_client_gql6.TextMessage({
+        new import_runtime_client_gql7.TextMessage({
           content: "",
-          role: import_runtime_client_gql6.Role.Assistant
+          role: import_runtime_client_gql7.Role.Assistant
         })
       ];
       chatAbortControllerRef.current = new AbortController();
@@ -2287,7 +2434,7 @@ function useChat(options) {
             runId: runIdRef.current,
             extensions: extensionsRef.current,
             metaEvents: composeAndFlushMetaEventsInput([langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.event]),
-            messages: (0, import_runtime_client_gql6.convertMessagesToGqlInput)((0, import_runtime_client_gql6.filterAgentStateMessages)(messagesWithContext))
+            messages: (0, import_runtime_client_gql7.convertMessagesToGqlInput)((0, import_runtime_client_gql7.filterAgentStateMessages)(messagesWithContext))
           }, copilotConfig.cloud ? {
             cloud: __spreadValues({}, ((_d = (_c = (_b = copilotConfig.cloud.guardrails) == null ? void 0 : _b.input) == null ? void 0 : _c.restrictToTopic) == null ? void 0 : _d.enabled) ? {
               guardrails: {
@@ -2299,7 +2446,7 @@ function useChat(options) {
             } : {})
           } : {}), {
             metadata: {
-              requestType: import_runtime_client_gql6.CopilotRequestType.Chat
+              requestType: import_runtime_client_gql7.CopilotRequestType.Chat
             }
           }), agentSessionRef.current ? {
             agentSession: agentSessionRef.current
@@ -2347,7 +2494,7 @@ function useChat(options) {
             continue;
           }
           runIdRef.current = value.generateCopilotResponse.runId || null;
-          extensionsRef.current = import_runtime_client_gql6.CopilotRuntimeClient.removeGraphQLTypename(
+          extensionsRef.current = import_runtime_client_gql7.CopilotRuntimeClient.removeGraphQLTypename(
             value.generateCopilotResponse.extensions || {}
           );
           setRunId(runIdRef.current);
@@ -2355,39 +2502,39 @@ function useChat(options) {
           let rawMessagesResponse = value.generateCopilotResponse.messages;
           const metaEvents = (_j = (_i = value.generateCopilotResponse) == null ? void 0 : _i.metaEvents) != null ? _j : [];
           (metaEvents != null ? metaEvents : []).forEach((ev) => {
-            if (ev.name === import_runtime_client_gql6.MetaEventName.LangGraphInterruptEvent) {
-              let eventValue = (0, import_runtime_client_gql6.langGraphInterruptEvent)(ev).value;
-              eventValue = (0, import_shared12.parseJson)(eventValue, eventValue);
+            if (ev.name === import_runtime_client_gql7.MetaEventName.LangGraphInterruptEvent) {
+              let eventValue = (0, import_runtime_client_gql7.langGraphInterruptEvent)(ev).value;
+              eventValue = (0, import_shared13.parseJson)(eventValue, eventValue);
               setLangGraphInterruptAction({
-                event: __spreadProps(__spreadValues({}, (0, import_runtime_client_gql6.langGraphInterruptEvent)(ev)), {
+                event: __spreadProps(__spreadValues({}, (0, import_runtime_client_gql7.langGraphInterruptEvent)(ev)), {
                   value: eventValue
                 })
               });
             }
-            if (ev.name === import_runtime_client_gql6.MetaEventName.CopilotKitLangGraphInterruptEvent) {
+            if (ev.name === import_runtime_client_gql7.MetaEventName.CopilotKitLangGraphInterruptEvent) {
               const data = ev.data;
               rawMessagesResponse = [...rawMessagesResponse, ...data.messages];
-              interruptMessages = (0, import_runtime_client_gql6.convertGqlOutputToMessages)(
+              interruptMessages = (0, import_runtime_client_gql7.convertGqlOutputToMessages)(
                 // @ts-ignore
-                (0, import_runtime_client_gql6.filterAdjacentAgentStateMessages)(data.messages)
+                (0, import_runtime_client_gql7.filterAdjacentAgentStateMessages)(data.messages)
               );
             }
           });
-          messages2 = (0, import_runtime_client_gql6.convertGqlOutputToMessages)(
-            (0, import_runtime_client_gql6.filterAdjacentAgentStateMessages)(rawMessagesResponse)
+          messages2 = (0, import_runtime_client_gql7.convertGqlOutputToMessages)(
+            (0, import_runtime_client_gql7.filterAdjacentAgentStateMessages)(rawMessagesResponse)
           );
           newMessages = [];
           if (((_k = value.generateCopilotResponse.status) == null ? void 0 : _k.__typename) === "FailedResponseStatus" && value.generateCopilotResponse.status.reason === "GUARDRAILS_VALIDATION_FAILED") {
             const guardrailsReason = ((_l = value.generateCopilotResponse.status.details) == null ? void 0 : _l.guardrailsReason) || "";
             newMessages = [
-              new import_runtime_client_gql6.TextMessage({
-                role: import_runtime_client_gql6.MessageRole.Assistant,
+              new import_runtime_client_gql7.TextMessage({
+                role: import_runtime_client_gql7.MessageRole.Assistant,
                 content: guardrailsReason
               })
             ];
-            const guardrailsError = new import_shared12.CopilotKitError({
+            const guardrailsError = new import_shared13.CopilotKitError({
               message: `Guardrails validation failed: ${guardrailsReason}`,
-              code: import_shared12.CopilotKitErrorCode.MISUSE
+              code: import_shared13.CopilotKitErrorCode.MISUSE
             });
             yield traceUIError(guardrailsError, {
               statusReason: value.generateCopilotResponse.status.reason,
@@ -2403,11 +2550,11 @@ function useChat(options) {
             const originalCode = (originalError == null ? void 0 : originalError.code) || ((_o = originalError == null ? void 0 : originalError.extensions) == null ? void 0 : _o.code);
             const originalSeverity = (originalError == null ? void 0 : originalError.severity) || ((_p = originalError == null ? void 0 : originalError.extensions) == null ? void 0 : _p.severity);
             const originalVisibility = (originalError == null ? void 0 : originalError.visibility) || ((_q = originalError == null ? void 0 : originalError.extensions) == null ? void 0 : _q.visibility);
-            let errorCode = import_shared12.CopilotKitErrorCode.NETWORK_ERROR;
-            if (originalCode && Object.values(import_shared12.CopilotKitErrorCode).includes(originalCode)) {
+            let errorCode = import_shared13.CopilotKitErrorCode.NETWORK_ERROR;
+            if (originalCode && Object.values(import_shared13.CopilotKitErrorCode).includes(originalCode)) {
               errorCode = originalCode;
             }
-            const structuredError = new import_shared12.CopilotKitError({
+            const structuredError = new import_shared13.CopilotKitError({
               message: errorMessage,
               code: errorCode,
               severity: originalSeverity,
@@ -2440,7 +2587,7 @@ function useChat(options) {
             const lastAgentStateMessage = [...messages2].reverse().find((message) => message.isAgentStateMessage());
             if (lastAgentStateMessage) {
               if (lastAgentStateMessage.state.messages && lastAgentStateMessage.state.messages.length > 0) {
-                syncedMessages = (0, import_runtime_client_gql6.loadMessagesFromJsonRepresentation)(
+                syncedMessages = (0, import_runtime_client_gql7.loadMessagesFromJsonRepresentation)(
                   lastAgentStateMessage.state.messages
                 );
               }
@@ -2469,7 +2616,7 @@ function useChat(options) {
               } else {
                 if (agentLock) {
                   setAgentSession({
-                    threadId: (0, import_shared12.randomId)(),
+                    threadId: (0, import_shared13.randomId)(),
                     agentName: agentLock,
                     nodeName: void 0
                   });
@@ -2526,7 +2673,7 @@ function useChat(options) {
           const lastMessages = [];
           for (let i = finalMessages.length - 1; i >= 0; i--) {
             const message = finalMessages[i];
-            if ((message.isActionExecutionMessage() || message.isResultMessage()) && message.status.code !== import_runtime_client_gql6.MessageStatusCode.Pending) {
+            if ((message.isActionExecutionMessage() || message.isResultMessage()) && message.status.code !== import_runtime_client_gql7.MessageStatusCode.Pending) {
               lastMessages.unshift(message);
             } else if (!message.isAgentStateMessage()) {
               break;
@@ -2537,7 +2684,7 @@ function useChat(options) {
             const action = actions.find(
               (action2) => action2.name === message.name
             );
-            if (action && action.available === "remote") {
+            if (action && action.available === "frontend") {
               continue;
             }
             const currentResultMessagePairedFeAction = message.isResultMessage() ? getPairedFeAction(actions, message) : null;
@@ -2554,9 +2701,9 @@ function useChat(options) {
                 );
                 const pairedFeAction = getPairedFeAction(actions, resultMessage);
                 if (pairedFeAction) {
-                  const newExecutionMessage = new import_runtime_client_gql6.ActionExecutionMessage({
+                  const newExecutionMessage = new import_runtime_client_gql7.ActionExecutionMessage({
                     name: pairedFeAction.name,
-                    arguments: (0, import_shared12.parseJson)(resultMessage.result, resultMessage.result),
+                    arguments: (0, import_shared13.parseJson)(resultMessage.result, resultMessage.result),
                     status: message.status,
                     createdAt: message.createdAt,
                     parentMessageId: message.parentMessageId
@@ -2565,9 +2712,9 @@ function useChat(options) {
                 }
               }
             } else if (message.isResultMessage() && currentResultMessagePairedFeAction) {
-              const newExecutionMessage = new import_runtime_client_gql6.ActionExecutionMessage({
+              const newExecutionMessage = new import_runtime_client_gql7.ActionExecutionMessage({
                 name: currentResultMessagePairedFeAction.name,
-                arguments: (0, import_shared12.parseJson)(message.result, message.result),
+                arguments: (0, import_shared13.parseJson)(message.result, message.result),
                 status: message.status,
                 createdAt: message.createdAt
               });
@@ -2652,7 +2799,7 @@ function useChat(options) {
         if (!event)
           return acc;
         switch (event.name) {
-          case import_runtime_client_gql6.MetaEventName.LangGraphInterruptEvent:
+          case import_runtime_client_gql7.MetaEventName.LangGraphInterruptEvent:
             if (event.response) {
               setLangGraphInterruptAction(null);
               const value = event.value;
@@ -2700,7 +2847,7 @@ function useChat(options) {
         return;
       }
       const reloadMessageRole = messages[reloadMessageIndex].role;
-      if (reloadMessageRole !== import_runtime_client_gql6.MessageRole.Assistant) {
+      if (reloadMessageRole !== import_runtime_client_gql7.MessageRole.Assistant) {
         console.warn(`Regenerate cannot be performed on ${reloadMessageRole} role`);
         return;
       }
@@ -2709,7 +2856,7 @@ function useChat(options) {
         const lastUserMessageBeforeRegenerate = messages.slice(0, reloadMessageIndex).reverse().find(
           (msg) => (
             // @ts-expect-error -- message has role
-            msg.role === import_runtime_client_gql6.MessageRole.User
+            msg.role === import_runtime_client_gql7.MessageRole.User
           )
         );
         const indexOfLastUserMessageBeforeRegenerate = messages.findIndex(
@@ -2798,9 +2945,9 @@ function executeAction(_0) {
     } catch (e) {
       onError(e);
     }
-    return new import_runtime_client_gql6.ResultMessage({
+    return new import_runtime_client_gql7.ResultMessage({
       id: "result-" + message.id,
-      result: import_runtime_client_gql6.ResultMessage.encodeResult(
+      result: import_runtime_client_gql7.ResultMessage.encodeResult(
         error ? {
           content: result,
           error: JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)))
@@ -2824,12 +2971,52 @@ function getPairedFeAction(actions, message) {
 }
 
 // src/hooks/use-copilot-chat.ts
-function useCopilotChat(_a = {}) {
-  var _b = _a, {
-    makeSystemMessage: makeSystemMessage2
-  } = _b, options = __objRest(_b, [
-    "makeSystemMessage"
-  ]);
+var import_runtime_client_gql8 = require("@copilotkit/runtime-client-gql");
+
+// src/hooks/use-langgraph-interrupt-render.ts
+var import_react12 = __toESM(require("react"));
+var InterruptRenderer = ({ event, result, render, resolve }) => {
+  return render({ event, result, resolve });
+};
+function useLangGraphInterruptRender() {
+  const { langGraphInterruptAction, setLangGraphInterruptAction, agentSession } = useCopilotContext();
+  const responseRef = import_react12.default.useRef();
+  const resolveInterrupt = (0, import_react12.useCallback)(
+    (response) => {
+      responseRef.current = response;
+      setTimeout(() => {
+        setLangGraphInterruptAction({ event: { response } });
+      }, 0);
+    },
+    [setLangGraphInterruptAction]
+  );
+  if (!langGraphInterruptAction || !langGraphInterruptAction.event || !langGraphInterruptAction.render)
+    return null;
+  const { render, handler, event, enabled } = langGraphInterruptAction;
+  const conditionsMet = !agentSession || !enabled ? true : enabled({ eventValue: event.value, agentMetadata: agentSession });
+  if (!conditionsMet) {
+    return null;
+  }
+  let result = null;
+  if (handler) {
+    result = handler({
+      event,
+      resolve: resolveInterrupt
+    });
+  }
+  return import_react12.default.createElement(InterruptRenderer, {
+    event,
+    result,
+    render,
+    resolve: resolveInterrupt
+  });
+}
+
+// src/hooks/use-copilot-chat.ts
+var globalSuggestionPromise = null;
+function useCopilotChat(options = {}) {
+  var _a;
+  const makeSystemMessage2 = (_a = options.makeSystemMessage) != null ? _a : defaultSystemMessage;
   const {
     getContextString,
     getFunctionCallHandler,
@@ -2853,11 +3040,72 @@ function useCopilotChat(_a = {}) {
     extensions,
     setExtensions,
     langGraphInterruptAction,
-    setLangGraphInterruptAction
+    setLangGraphInterruptAction,
+    chatSuggestionConfiguration,
+    suggestions,
+    setSuggestions,
+    runtimeClient
   } = useCopilotContext();
   const { messages, setMessages } = useCopilotMessagesContext();
-  const [mcpServers, setLocalMcpServers] = (0, import_react12.useState)([]);
-  (0, import_react12.useEffect)(() => {
+  const [mcpServers, setLocalMcpServers] = (0, import_react13.useState)([]);
+  const suggestionsAbortControllerRef = (0, import_react13.useRef)(null);
+  const isLoadingSuggestionsRef = (0, import_react13.useRef)(false);
+  const abortSuggestions = (0, import_react13.useCallback)(
+    (clear = true) => {
+      var _a2;
+      (_a2 = suggestionsAbortControllerRef.current) == null ? void 0 : _a2.abort("suggestions aborted by user");
+      suggestionsAbortControllerRef.current = null;
+      if (clear) {
+        setSuggestions([]);
+      }
+    },
+    [setSuggestions]
+  );
+  const stableContext = (0, import_react13.useMemo)(() => {
+    return {
+      actions,
+      copilotApiConfig,
+      chatSuggestionConfiguration,
+      messages,
+      setMessages,
+      getContextString,
+      runtimeClient
+    };
+  }, [
+    JSON.stringify(Object.keys(actions)),
+    copilotApiConfig.chatApiEndpoint,
+    messages.length,
+    Object.keys(chatSuggestionConfiguration).length
+  ]);
+  const generateSuggestionsFunc = (0, import_react13.useCallback)(() => __async(this, null, function* () {
+    if (globalSuggestionPromise) {
+      return globalSuggestionPromise;
+    }
+    globalSuggestionPromise = (() => __async(this, null, function* () {
+      try {
+        abortSuggestions();
+        isLoadingSuggestionsRef.current = true;
+        suggestionsAbortControllerRef.current = new AbortController();
+        setSuggestions([]);
+        yield reloadSuggestions(
+          stableContext,
+          chatSuggestionConfiguration,
+          setSuggestions,
+          suggestionsAbortControllerRef
+        );
+      } catch (error) {
+        throw error;
+      } finally {
+        isLoadingSuggestionsRef.current = false;
+        globalSuggestionPromise = null;
+      }
+    }))();
+    return globalSuggestionPromise;
+  }), [stableContext, chatSuggestionConfiguration, setSuggestions, abortSuggestions]);
+  const resetSuggestions = (0, import_react13.useCallback)(() => {
+    setSuggestions([]);
+  }, [setSuggestions]);
+  (0, import_react13.useEffect)(() => {
     if (mcpServers.length > 0) {
       const serversCopy = [...mcpServers];
       copilotApiConfig.mcpServers = serversCopy;
@@ -2867,7 +3115,7 @@ function useCopilotChat(_a = {}) {
       copilotApiConfig.properties.mcpServers = serversCopy;
     }
   }, [mcpServers, copilotApiConfig]);
-  const setMcpServers = (0, import_react12.useCallback)((servers) => {
+  const setMcpServers = (0, import_react13.useCallback)((servers) => {
     setLocalMcpServers(servers);
   }, []);
   const onCoAgentStateRender = useAsyncCallback(
@@ -2888,15 +3136,15 @@ function useCopilotChat(_a = {}) {
     }),
     [coAgentStateRenders]
   );
-  const makeSystemMessageCallback = (0, import_react12.useCallback)(() => {
+  const makeSystemMessageCallback = (0, import_react13.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_react12.useCallback)(
+  const deleteMessage = (0, import_react13.useCallback)(
     (messageId) => {
       setMessages((prev) => prev.filter((message) => message.id !== messageId));
     },
@@ -2905,7 +3153,7 @@ function useCopilotChat(_a = {}) {
   const { append, reload, stop, runChatCompletion } = useChat(__spreadProps(__spreadValues({}, options), {
     actions: Object.values(actions),
     copilotConfig: copilotApiConfig,
-    initialMessages: options.initialMessages || [],
+    initialMessages: (0, import_runtime_client_gql8.aguiToGQL)(options.initialMessages || []),
     onFunctionCall: getFunctionCallHandler(),
     onCoAgentStateRender,
     messages,
@@ -2932,7 +3180,8 @@ function useCopilotChat(_a = {}) {
   const latestAppend = useUpdatedRef(append);
   const latestAppendFunc = useAsyncCallback(
     (message, options2) => __async(this, null, function* () {
-      return yield latestAppend.current(message, options2);
+      abortSuggestions(options2 == null ? void 0 : options2.clearSuggestions);
+      return yield latestAppend.current((0, import_runtime_client_gql8.aguiToGQL)([message])[0], options2);
     }),
     [latestAppend]
   );
@@ -2944,20 +3193,20 @@ function useCopilotChat(_a = {}) {
     [latestReload]
   );
   const latestStop = useUpdatedRef(stop);
-  const latestStopFunc = (0, import_react12.useCallback)(() => {
+  const latestStopFunc = (0, import_react13.useCallback)(() => {
     return latestStop.current();
   }, [latestStop]);
   const latestDelete = useUpdatedRef(deleteMessage);
-  const latestDeleteFunc = (0, import_react12.useCallback)(
+  const latestDeleteFunc = (0, import_react13.useCallback)(
     (messageId) => {
       return latestDelete.current(messageId);
     },
     [latestDelete]
   );
   const latestSetMessages = useUpdatedRef(setMessages);
-  const latestSetMessagesFunc = (0, import_react12.useCallback)(
+  const latestSetMessagesFunc = (0, import_react13.useCallback)(
     (messages2) => {
-      return latestSetMessages.current(messages2);
+      return latestSetMessages.current((0, import_runtime_client_gql8.aguiToGQL)(messages2));
     },
     [latestSetMessages]
   );
@@ -2965,7 +3214,7 @@ function useCopilotChat(_a = {}) {
   const latestRunChatCompletionFunc = useAsyncCallback(() => __async(this, null, function* () {
     return yield latestRunChatCompletion.current();
   }), [latestRunChatCompletion]);
-  const reset = (0, import_react12.useCallback)(() => {
+  const reset = (0, import_react13.useCallback)(() => {
     latestStopFunc();
     setMessages([]);
     setRunId(null);
@@ -2977,20 +3226,23 @@ function useCopilotChat(_a = {}) {
       };
     }
     setAgentSession(initialAgentSession);
+    resetSuggestions();
   }, [
     latestStopFunc,
     setMessages,
     setThreadId,
     setCoagentStatesWithRef,
     setAgentSession,
-    agentLock
+    agentLock,
+    resetSuggestions
   ]);
   const latestReset = useUpdatedRef(reset);
-  const latestResetFunc = (0, import_react12.useCallback)(() => {
+  const latestResetFunc = (0, import_react13.useCallback)(() => {
     return latestReset.current();
   }, [latestReset]);
+  const interrupt = useLangGraphInterruptRender();
   return {
-    visibleMessages: messages,
+    visibleMessages: (0, import_runtime_client_gql8.gqlToAGUI)(messages, actions, coAgentStateRenders),
     appendMessage: latestAppendFunc,
     setMessages: latestSetMessagesFunc,
     reloadMessages: latestReloadFunc,
@@ -3000,12 +3252,18 @@ function useCopilotChat(_a = {}) {
     runChatCompletion: latestRunChatCompletionFunc,
     isLoading,
     mcpServers,
-    setMcpServers
+    setMcpServers,
+    suggestions,
+    setSuggestions,
+    generateSuggestions: generateSuggestionsFunc,
+    resetSuggestions,
+    isLoadingSuggestions: isLoadingSuggestionsRef.current,
+    interrupt
   };
 }
 function useUpdatedRef(value) {
-  const ref = (0, import_react12.useRef)(value);
-  (0, import_react12.useEffect)(() => {
+  const ref = (0, import_react13.useRef)(value);
+  (0, import_react13.useEffect)(() => {
     ref.current = value;
   }, [value]);
   return ref;
@@ -3038,13 +3296,13 @@ ${additionalInstructions}` : "");
 }
 
 // src/hooks/use-copilot-action.ts
-var import_shared13 = require("@copilotkit/shared");
-var import_react13 = require("react");
+var import_shared14 = require("@copilotkit/shared");
+var import_react14 = require("react");
 function useCopilotAction(action, dependencies) {
   const { setAction, removeAction, actions, chatComponentsCache } = useCopilotContext();
-  const idRef = (0, import_react13.useRef)((0, import_shared13.randomId)());
-  const renderAndWaitRef = (0, import_react13.useRef)(null);
-  const activatingMessageIdRef = (0, import_react13.useRef)(null);
+  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 { addToast } = useToast();
   action = __spreadValues({}, action);
   if (
@@ -3106,7 +3364,7 @@ function useCopilotAction(action, dependencies) {
           return renderAndWait(waitProps);
         }
       }
-      return (0, import_react13.createElement)(import_react13.Fragment);
+      return (0, import_react14.createElement)(import_react14.Fragment);
     };
   }
   if (dependencies === void 0) {
@@ -3121,7 +3379,7 @@ function useCopilotAction(action, dependencies) {
       }
     }
   }
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     const hasDuplicate = Object.values(actions).some(
       (otherAction) => otherAction.name === action.name && otherAction !== actions[idRef.current]
     );
@@ -3133,7 +3391,7 @@ function useCopilotAction(action, dependencies) {
       });
     }
   }, [actions]);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     setAction(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.actions[action.name] = action.render;
@@ -3162,8 +3420,8 @@ function isFrontendAction(action) {
 }
 
 // src/hooks/use-coagent-state-render.ts
-var import_react14 = require("react");
-var import_shared14 = require("@copilotkit/shared");
+var import_react15 = require("react");
+var import_shared15 = require("@copilotkit/shared");
 function useCoAgentStateRender(action, dependencies) {
   const {
     setCoAgentStateRender,
@@ -3171,13 +3429,13 @@ function useCoAgentStateRender(action, dependencies) {
     coAgentStateRenders,
     chatComponentsCache,
     availableAgents
-  } = (0, import_react14.useContext)(CopilotContext);
-  const idRef = (0, import_react14.useRef)((0, import_shared14.randomId)());
+  } = (0, import_react15.useContext)(CopilotContext);
+  const idRef = (0, import_react15.useRef)((0, import_shared15.randomId)());
   const { setBannerError, addToast } = useToast();
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.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_shared14.CopilotKitAgentDiscoveryError({
+      const agentError = new import_shared15.CopilotKitAgentDiscoveryError({
         agentName: action.name,
         availableAgents: availableAgents.map((a) => ({ name: a.name, id: a.id }))
       });
@@ -3195,7 +3453,7 @@ function useCoAgentStateRender(action, dependencies) {
       }
     }
   }
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     const currentId = idRef.current;
     const hasDuplicate = Object.entries(coAgentStateRenders).some(([id, otherAction]) => {
       if (id === currentId)
@@ -3219,7 +3477,7 @@ function useCoAgentStateRender(action, dependencies) {
       });
     }
   }, [coAgentStateRenders]);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     setCoAgentStateRender(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.coAgentStateRenders[key] = action.render;
@@ -3239,11 +3497,11 @@ function useCoAgentStateRender(action, dependencies) {
 }
 
 // src/hooks/use-make-copilot-document-readable.ts
-var import_react15 = require("react");
+var import_react16 = require("react");
 function useMakeCopilotDocumentReadable(document, categories, dependencies = []) {
   const { addDocumentContext, removeDocumentContext } = useCopilotContext();
-  const idRef = (0, import_react15.useRef)();
-  (0, import_react15.useEffect)(() => {
+  const idRef = (0, import_react16.useRef)();
+  (0, import_react16.useEffect)(() => {
     const id = addDocumentContext(document, categories);
     idRef.current = id;
     return () => {
@@ -3254,7 +3512,7 @@ function useMakeCopilotDocumentReadable(document, categories, dependencies = [])
 }
 
 // src/hooks/use-copilot-readable.ts
-var import_react16 = require("react");
+var import_react17 = require("react");
 function convertToJSON(description, value) {
   return `${description}: ${typeof value === "string" ? value : JSON.stringify(value)}`;
 }
@@ -3267,10 +3525,10 @@ function useCopilotReadable({
   available = "enabled"
 }, dependencies) {
   const { addContext, removeContext } = useCopilotContext();
-  const idRef = (0, import_react16.useRef)();
+  const idRef = (0, import_react17.useRef)();
   convert = convert || convertToJSON;
   const information = convert(description, value);
-  (0, import_react16.useEffect)(() => {
+  (0, import_react17.useEffect)(() => {
     if (available === "disabled")
       return;
     const id = addContext(information, parentId, categories);
@@ -3283,20 +3541,20 @@ function useCopilotReadable({
 }
 
 // src/hooks/use-coagent.ts
-var import_react17 = require("react");
-var import_shared15 = require("@copilotkit/shared");
+var import_react18 = require("react");
+var import_shared16 = require("@copilotkit/shared");
 function useCoAgent(options) {
   const generalContext = useCopilotContext();
   const { availableAgents } = generalContext;
   const { setBannerError } = useToast();
-  const lastLoadedThreadId = (0, import_react17.useRef)();
-  const lastLoadedState = (0, import_react17.useRef)();
+  const lastLoadedThreadId = (0, import_react18.useRef)();
+  const lastLoadedState = (0, import_react18.useRef)();
   const { name } = options;
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.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_shared15.CopilotKitAgentDiscoveryError({
+      const agentError = new import_shared16.CopilotKitAgentDiscoveryError({
         agentName: name,
         availableAgents: availableAgents.map((a) => ({ name: a.name, id: a.id }))
       });
@@ -3315,7 +3573,7 @@ function useCoAgent(options) {
     credentials: copilotApiConfig.credentials,
     showDevConsole: context.showDevConsole
   });
-  const setState = (0, import_react17.useCallback)(
+  const setState = (0, import_react18.useCallback)(
     (newState) => {
       let coagentState = getCoagentState({ coagentStates, name, options });
       const updatedState = typeof newState === "function" ? newState(coagentState.state) : newState;
@@ -3327,7 +3585,7 @@ function useCoAgent(options) {
     },
     [coagentStates, name]
   );
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     const fetchAgentState = () => __async(this, null, function* () {
       var _a, _b, _c, _d;
       if (!threadId || threadId === lastLoadedThreadId.current)
@@ -3345,13 +3603,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_shared15.parseJson)(newState, {});
+        const fetchedState = (0, import_shared16.parseJson)(newState, {});
         isExternalStateManagement(options) ? options.setState(fetchedState) : setState(fetchedState);
       }
     });
     void fetchAgentState();
   }, [threadId]);
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     if (isExternalStateManagement(options)) {
       setState(options.state);
     } else if (coagentStates[name] === void 0) {
@@ -3362,7 +3620,7 @@ function useCoAgent(options) {
     // reset initialstate on reset
     coagentStates[name] === void 0
   ]);
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     const newConfig = options.config ? options.config : options.configurable ? { configurable: options.configurable } : void 0;
     if (newConfig === void 0)
       return;
@@ -3394,7 +3652,7 @@ function useCoAgent(options) {
     }),
     [name, context, appendMessage, runChatCompletion]
   );
-  return (0, import_react17.useMemo)(() => {
+  return (0, import_react18.useMemo)(() => {
     const coagentState = getCoagentState({ coagentStates, name, options });
     return {
       name,
@@ -3491,28 +3749,28 @@ var getCoagentState = ({
 };
 
 // src/hooks/use-copilot-authenticated-action.ts
-var import_react18 = require("react");
-var import_react19 = __toESM(require("react"));
+var import_react19 = require("react");
+var import_react20 = __toESM(require("react"));
 function useCopilotAuthenticatedAction_c(action, dependencies) {
   const { authConfig_c, authStates_c, setAuthStates_c } = useCopilotContext();
-  const pendingActionRef = (0, import_react18.useRef)(null);
-  const executeAction2 = (0, import_react18.useCallback)(
+  const pendingActionRef = (0, import_react19.useRef)(null);
+  const executeAction2 = (0, import_react19.useCallback)(
     (props) => {
       if (typeof action.render === "function") {
         return action.render(props);
       }
-      return action.render || import_react19.default.createElement(import_react18.Fragment);
+      return action.render || import_react20.default.createElement(import_react19.Fragment);
     },
     [action]
   );
-  const wrappedRender = (0, import_react18.useCallback)(
+  const wrappedRender = (0, import_react19.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_react19.default.createElement(authConfig_c.SignInComponent, {
+        return (authConfig_c == null ? void 0 : authConfig_c.SignInComponent) ? import_react20.default.createElement(authConfig_c.SignInComponent, {
           onSignInComplete: (authState) => {
             setAuthStates_c == null ? void 0 : setAuthStates_c((prev) => __spreadProps(__spreadValues({}, prev), { [action.name]: authState }));
             if (pendingActionRef.current) {
@@ -3520,7 +3778,7 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
               pendingActionRef.current = null;
             }
           }
-        }) : import_react19.default.createElement(import_react18.Fragment);
+        }) : import_react20.default.createElement(import_react19.Fragment);
       }
       return executeAction2(props);
     },
@@ -3535,29 +3793,29 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
 }
 
 // src/hooks/use-langgraph-interrupt.ts
-var import_react20 = require("react");
-var import_shared16 = require("@copilotkit/shared");
+var import_react21 = require("react");
+var import_shared17 = require("@copilotkit/shared");
 function useLangGraphInterrupt(action, dependencies) {
   var _a;
-  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react20.useContext)(CopilotContext);
+  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react21.useContext)(CopilotContext);
   const { runChatCompletion } = useCopilotChat();
   const { addToast } = useToast();
-  const actionId = (0, import_shared16.dataToUUID)(JSON.stringify(action), "lgAction");
-  const hasAction = (0, import_react20.useMemo)(
+  const actionId = (0, import_shared17.dataToUUID)(JSON.stringify(action), "lgAction");
+  const hasAction = (0, import_react21.useMemo)(
     () => Boolean(langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id),
     [langGraphInterruptAction]
   );
-  const isCurrentAction = (0, import_react20.useMemo)(
+  const isCurrentAction = (0, import_react21.useMemo)(
     () => (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) && (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) === actionId,
     [langGraphInterruptAction]
   );
-  (0, import_react20.useEffect)(() => {
+  (0, import_react21.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_react20.useEffect)(() => {
+  (0, import_react21.useEffect)(() => {
     if (!action)
       return;
     if (hasAction && !isCurrentAction && !action.enabled) {
@@ -3581,45 +3839,6 @@ function useLangGraphInterrupt(action, dependencies) {
   ]);
 }
 
-// src/hooks/use-langgraph-interrupt-render.ts
-var import_react21 = __toESM(require("react"));
-var InterruptRenderer = ({ event, result, render, resolve }) => {
-  return render({ event, result, resolve });
-};
-function useLangGraphInterruptRender() {
-  const { langGraphInterruptAction, setLangGraphInterruptAction, agentSession } = useCopilotContext();
-  const responseRef = import_react21.default.useRef();
-  const resolveInterrupt = (0, import_react21.useCallback)(
-    (response) => {
-      responseRef.current = response;
-      setTimeout(() => {
-        setLangGraphInterruptAction({ event: { response } });
-      }, 0);
-    },
-    [setLangGraphInterruptAction]
-  );
-  if (!langGraphInterruptAction || !langGraphInterruptAction.event || !langGraphInterruptAction.render)
-    return null;
-  const { render, handler, event, enabled } = langGraphInterruptAction;
-  const conditionsMet = !agentSession || !enabled ? true : enabled({ eventValue: event.value, agentMetadata: agentSession });
-  if (!conditionsMet) {
-    return null;
-  }
-  let result = null;
-  if (handler) {
-    result = handler({
-      event,
-      resolve: resolveInterrupt
-    });
-  }
-  return import_react21.default.createElement(InterruptRenderer, {
-    event,
-    result,
-    render,
-    resolve: resolveInterrupt
-  });
-}
-
 // src/hooks/use-copilot-additional-instructions.ts
 var import_react22 = require("react");
 function useCopilotAdditionalInstructions({ instructions, available = "enabled" }, dependencies) {
@@ -3637,7 +3856,7 @@ function useCopilotAdditionalInstructions({ instructions, available = "enabled"
 }
 
 // src/lib/copilot-task.ts
-var import_runtime_client_gql8 = require("@copilotkit/runtime-client-gql");
+var import_runtime_client_gql9 = require("@copilotkit/runtime-client-gql");
 var CopilotTask = class {
   constructor(config) {
     this.instructions = config.instructions;
@@ -3665,12 +3884,12 @@ var CopilotTask = class {
       if (this.includeCopilotReadable) {
         contextString += context.getContextString([], defaultCopilotContextCategories);
       }
-      const systemMessage = new import_runtime_client_gql8.TextMessage({
+      const systemMessage = new import_runtime_client_gql9.TextMessage({
         content: taskSystemMessage(contextString, this.instructions),
-        role: import_runtime_client_gql8.Role.System
+        role: import_runtime_client_gql9.Role.System
       });
       const messages = [systemMessage];
-      const runtimeClient = new import_runtime_client_gql8.CopilotRuntimeClient({
+      const runtimeClient = new import_runtime_client_gql9.CopilotRuntimeClient({
         url: context.copilotApiConfig.chatApiEndpoint,
         publicApiKey: context.copilotApiConfig.publicApiKey,
         headers: context.copilotApiConfig.headers,
@@ -3682,9 +3901,9 @@ var CopilotTask = class {
             actions: processActionsForRuntimeRequest(Object.values(actions)),
             url: window.location.href
           },
-          messages: (0, import_runtime_client_gql8.convertMessagesToGqlInput)((0, import_runtime_client_gql8.filterAgentStateMessages)(messages)),
+          messages: (0, import_runtime_client_gql9.convertMessagesToGqlInput)((0, import_runtime_client_gql9.filterAgentStateMessages)(messages)),
           metadata: {
-            requestType: import_runtime_client_gql8.CopilotRequestType.Task
+            requestType: import_runtime_client_gql9.CopilotRequestType.Task
           },
           forwardedParameters: __spreadValues({
             // if forwardedParameters is provided, use it
@@ -3694,7 +3913,7 @@ var CopilotTask = class {
         properties: context.copilotApiConfig.properties
       }).toPromise();
       const functionCallHandler = context.getFunctionCallHandler(actions);
-      const functionCalls = (0, import_runtime_client_gql8.convertGqlOutputToMessages)(
+      const functionCalls = (0, import_runtime_client_gql9.convertGqlOutputToMessages)(
         ((_c = (_b = response.data) == null ? void 0 : _b.generateCopilotResponse) == null ? void 0 : _c.messages) || []
       ).filter((m) => m.isActionExecutionMessage());
       for (const functionCall of functionCalls) {
@@ -3738,8 +3957,10 @@ ${instructions}
   CopilotKit,
   CopilotMessagesContext,
   CopilotTask,
+  SUGGESTION_RETRY_CONFIG,
   defaultCopilotContextCategories,
   extract,
+  reloadSuggestions,
   runAgent,
   shouldShowDevConsole,
   startAgent,