@copilotkit/react-core 1.50.0-beta.1 → 1.50.0-beta.10

package/dist/hooks/index.js

@@ -81,13 +81,13 @@ var hooks_exports = {};
 __export(hooks_exports, {
   useCoAgent: () => useCoAgent,
   useCoAgentStateRender: () => useCoAgentStateRender,
-  useConfigureChatSuggestions: () => useConfigureChatSuggestions,
   useCopilotAction: () => useCopilotAction,
   useCopilotAdditionalInstructions: () => useCopilotAdditionalInstructions,
   useCopilotAuthenticatedAction_c: () => useCopilotAuthenticatedAction_c,
   useCopilotChat: () => useCopilotChat,
   useCopilotChatHeadless_c: () => useCopilotChatHeadless_c,
   useCopilotChatInternal: () => useCopilotChatInternal,
+  useCopilotChatSuggestions: () => useCopilotChatSuggestions,
   useCopilotReadable: () => useCopilotReadable,
   useCopilotRuntimeClient: () => useCopilotRuntimeClient,
   useDefaultTool: () => useDefaultTool,
@@ -102,7 +102,7 @@ __export(hooks_exports, {
 module.exports = __toCommonJS(hooks_exports);
 
 // src/hooks/use-copilot-chat_internal.ts
-var import_react12 = require("react");
+var import_react13 = require("react");
 
 // src/context/copilot-context.tsx
 var import_react = __toESM(require("react"));
@@ -180,7 +180,7 @@ var emptyCopilotContext = {
   interruptEventQueue: {},
   addInterruptEvent: () => {
   },
-  removeInterruptEvent: () => {
+  resolveInterruptEvent: () => {
   },
   onError: () => {
   },
@@ -351,24 +351,60 @@ function useCoAgentStateRenders() {
 }
 
 // src/hooks/use-langgraph-interrupt-render.ts
-var import_react5 = __toESM(require("react"));
+var import_react7 = __toESM(require("react"));
 var import_runtime_client_gql = require("@copilotkit/runtime-client-gql");
 var import_shared2 = require("@copilotkit/shared");
+
+// src/hooks/use-agent-nodename.ts
+var import_react5 = require("react");
+var import_react6 = require("@copilotkitnext/react");
+function useAgentNodeName(agentName) {
+  const { agent } = (0, import_react6.useAgent)({ agentId: agentName });
+  const nodeNameRef = (0, import_react5.useRef)("start");
+  (0, import_react5.useEffect)(() => {
+    if (!agent)
+      return;
+    const subscriber = {
+      onStepStartedEvent: ({ event }) => {
+        nodeNameRef.current = event.stepName;
+      },
+      onRunStartedEvent: () => {
+        nodeNameRef.current = "start";
+      },
+      onRunFinishedEvent: () => {
+        nodeNameRef.current = "end";
+      }
+    };
+    const subscription = agent.subscribe(subscriber);
+    return () => {
+      subscription.unsubscribe();
+    };
+  }, [agent]);
+  return nodeNameRef.current;
+}
+
+// src/hooks/use-langgraph-interrupt-render.ts
+var import_react8 = require("@copilotkitnext/react");
 var InterruptRenderer = ({ event, result, render, resolve }) => {
   return render({ event, result, resolve });
 };
 function useLangGraphInterruptRender(agent) {
+  var _a;
   const {
     interruptActions,
     agentSession,
     threadId,
     interruptEventQueue,
     addInterruptEvent,
-    removeInterruptEvent
+    resolveInterruptEvent
   } = useCopilotContext();
-  (0, import_react5.useEffect)(() => {
+  const existingConfig = (0, import_react8.useCopilotChatConfiguration)();
+  const resolvedAgentId = (_a = existingConfig == null ? void 0 : existingConfig.agentId) != null ? _a : "default";
+  const nodeName = useAgentNodeName(resolvedAgentId);
+  (0, import_react7.useEffect)(() => {
     if (!agent)
       return;
+    let localInterrupt = null;
     const subscriber = {
       onCustomEvent: ({ event }) => {
         if (event.name === "on_interrupt") {
@@ -377,12 +413,21 @@ function useLangGraphInterruptRender(agent) {
             type: event.type,
             value: (0, import_shared2.parseJson)(event.value, event.value)
           };
-          const eventId = (0, import_shared2.dataToUUID)(JSON.stringify(eventData), "interruptEvents");
-          addInterruptEvent({
+          const eventId = (0, import_shared2.dataToUUID)(eventData, "interruptEvents");
+          localInterrupt = {
             eventId,
             threadId,
             event: eventData
-          });
+          };
+        }
+      },
+      onRunStartedEvent: () => {
+        localInterrupt = null;
+      },
+      onRunFinalized: () => {
+        if (localInterrupt) {
+          addInterruptEvent(localInterrupt);
+          localInterrupt = null;
         }
       }
     };
@@ -391,7 +436,7 @@ function useLangGraphInterruptRender(agent) {
       unsubscribe();
     };
   }, [agent, threadId]);
-  const handleResolve = (0, import_react5.useCallback)(
+  const handleResolve = (0, import_react7.useCallback)(
     (eventId, response) => {
       agent == null ? void 0 : agent.runAgent({
         forwardedProps: {
@@ -400,15 +445,15 @@ function useLangGraphInterruptRender(agent) {
           }
         }
       });
-      removeInterruptEvent(threadId, eventId);
+      resolveInterruptEvent(threadId, eventId, response != null ? response : "");
     },
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [agent, threadId]
   );
-  return (0, import_react5.useMemo)(() => {
+  return (0, import_react7.useMemo)(() => {
     const eventQueue = interruptEventQueue[threadId] || [];
     const currentQueuedEvent = eventQueue.find((qe) => !qe.event.response);
-    if (!currentQueuedEvent)
+    if (!currentQueuedEvent || !agentSession)
       return null;
     const allActions = Object.values(interruptActions);
     const matchingAction = allActions.find((action) => {
@@ -416,7 +461,9 @@ function useLangGraphInterruptRender(agent) {
         return true;
       return action.enabled({
         eventValue: currentQueuedEvent.event.value,
-        agentMetadata: agentSession
+        agentMetadata: __spreadProps(__spreadValues({}, agentSession), {
+          nodeName
+        })
       });
     });
     if (!matchingAction)
@@ -434,7 +481,7 @@ function useLangGraphInterruptRender(agent) {
     }
     if (!render)
       return null;
-    return import_react5.default.createElement(InterruptRenderer, {
+    return import_react7.default.createElement(InterruptRenderer, {
       event: currentQueuedEvent.event,
       result,
       render,
@@ -444,14 +491,14 @@ function useLangGraphInterruptRender(agent) {
 }
 
 // src/hooks/use-copilot-chat_internal.ts
-var import_react13 = require("@copilotkitnext/react");
+var import_react14 = require("@copilotkitnext/react");
 
 // src/hooks/use-lazy-tool-renderer.tsx
-var import_react6 = require("@copilotkitnext/react");
-var import_react7 = require("react");
+var import_react9 = require("@copilotkitnext/react");
+var import_react10 = require("react");
 function useLazyToolRenderer() {
-  const renderToolCall = (0, import_react6.useRenderToolCall)();
-  return (0, import_react7.useCallback)(
+  const renderToolCall = (0, import_react9.useRenderToolCall)();
+  return (0, import_react10.useCallback)(
     (message, messages) => {
       var _a;
       if (!((_a = message == null ? void 0 : message.toolCalls) == null ? void 0 : _a.length))
@@ -471,39 +518,7 @@ function useLazyToolRenderer() {
   );
 }
 
-// src/hooks/use-configure-chat-suggestions.tsx
-var import_react8 = require("@copilotkitnext/react");
-var import_react9 = require("react");
-function useConfigureChatSuggestions(config, dependencies = []) {
-  const { agentSession } = useCopilotContext();
-  const { copilotkit } = (0, import_react8.useCopilotKit)();
-  const available = config.available === "enabled" ? "always" : config.available;
-  const finalSuggestionConfig = __spreadProps(__spreadValues({}, config), {
-    available,
-    consumerAgentId: agentSession == null ? void 0 : agentSession.agentName
-    // Use chatConfig.agentId here
-  });
-  (0, import_react8.useConfigureSuggestions)(finalSuggestionConfig, { deps: dependencies });
-  const result = (0, import_react8.useSuggestions)({ agentId: agentSession == null ? void 0 : agentSession.agentName });
-  (0, import_react9.useEffect)(() => {
-    if (finalSuggestionConfig.available === "disabled")
-      return;
-    const subscription = copilotkit.subscribe({
-      onAgentsChanged: () => {
-        const agent = copilotkit.getAgent(agentSession == null ? void 0 : agentSession.agentName);
-        if (agent && !agent.isRunning && !result.suggestions.length) {
-          copilotkit.reloadSuggestions(agentSession == null ? void 0 : agentSession.agentName);
-        }
-      }
-    });
-    return () => {
-      subscription.unsubscribe();
-    };
-  }, []);
-  return result;
-}
-
-// ../../node_modules/.pnpm/@ag-ui+core@0.0.42-alpha.1/node_modules/@ag-ui/core/dist/index.mjs
+// ../../node_modules/.pnpm/@ag-ui+core@0.0.42/node_modules/@ag-ui/core/dist/index.mjs
 var import_zod = require("zod");
 var import_zod2 = require("zod");
 var FunctionCallSchema = import_zod.z.object({
@@ -909,10 +924,12 @@ var EventSchemas = import_zod2.z.discriminatedUnion("type", [
 ]);
 
 // src/hooks/use-coagent-state-render-bridge.tsx
-var import_react10 = require("@copilotkitnext/react");
-var import_react11 = require("react");
+var import_react11 = require("@copilotkitnext/react");
+var import_react12 = require("react");
 var import_shared3 = require("@copilotkit/shared");
 function getStateWithoutConstantKeys(state) {
+  if (!state)
+    return {};
   const _a = state, { messages, tools, copilotkit } = _a, stateWithoutConstantKeys = __objRest(_a, ["messages", "tools", "copilotkit"]);
   return stateWithoutConstantKeys;
 }
@@ -935,11 +952,11 @@ function useCoagentStateRenderBridge(agentId, props) {
   var _a;
   const { stateSnapshot, messageIndexInRun, message } = props;
   const { coAgentStateRenders, claimsRef } = useCoAgentStateRenders();
-  const { agent } = (0, import_react10.useAgent)({ agentId });
-  const [nodeName, setNodeName] = (0, import_react11.useState)(void 0);
+  const { agent } = (0, import_react11.useAgent)({ agentId });
+  const [nodeName, setNodeName] = (0, import_react12.useState)(void 0);
   const runId = (_a = props.runId) != null ? _a : message.runId;
   const effectiveRunId = runId || "pending";
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (!agent)
       return;
     const subscriber = {
@@ -959,10 +976,7 @@ function useCoagentStateRenderBridge(agentId, props) {
       unsubscribe();
     };
   }, [agentId, nodeName]);
-  if (messageIndexInRun !== 0) {
-    return null;
-  }
-  const getStateRender = (0, import_react11.useCallback)(
+  const getStateRender = (0, import_react12.useCallback)(
     (messageId) => {
       return Object.entries(coAgentStateRenders).find(([stateRenderId, stateRender]) => {
         if (claimsRef.current[messageId]) {
@@ -989,7 +1003,7 @@ function useCoagentStateRenderBridge(agentId, props) {
       return canRender;
     }
     const renderClaimedByOtherMessage = Object.values(claimsRef.current).find(
-      (c) => c.stateRenderId === stateRenderId && (0, import_shared3.dataToUUID)(JSON.stringify(getStateWithoutConstantKeys(c.stateSnapshot))) === (0, import_shared3.dataToUUID)(JSON.stringify(getStateWithoutConstantKeys(renderSnapshot)))
+      (c) => c.stateRenderId === stateRenderId && (0, import_shared3.dataToUUID)(getStateWithoutConstantKeys(c.stateSnapshot)) === (0, import_shared3.dataToUUID)(getStateWithoutConstantKeys(renderSnapshot))
     );
     if (renderClaimedByOtherMessage) {
       if (renderSnapshot && renderClaimedByOtherMessage.stateSnapshot && !areStatesEquals(renderClaimedByOtherMessage.stateSnapshot, renderSnapshot)) {
@@ -1004,8 +1018,11 @@ function useCoagentStateRenderBridge(agentId, props) {
     claimsRef.current[messageId] = { stateRenderId, runId: runId2 };
     return true;
   };
-  return (0, import_react11.useMemo)(() => {
+  return (0, import_react12.useMemo)(() => {
     var _a2, _b, _c;
+    if (messageIndexInRun !== 0) {
+      return null;
+    }
     const [stateRenderId, stateRender] = (_a2 = getStateRender(message.id)) != null ? _a2 : [];
     if (!stateRender || !stateRenderId) {
       return null;
@@ -1052,7 +1069,8 @@ function useCoagentStateRenderBridge(agentId, props) {
     agent == null ? void 0 : agent.isRunning,
     nodeName,
     effectiveRunId,
-    message.id
+    message.id,
+    messageIndexInRun
   ]);
 }
 function CoAgentStateRenderBridge(props) {
@@ -1060,35 +1078,17 @@ function CoAgentStateRenderBridge(props) {
 }
 
 // src/hooks/use-copilot-chat_internal.ts
-function useConfigureSuggestions2(suggestions) {
-  let suggestionsConfig;
-  if (Array.isArray(suggestions)) {
-    suggestionsConfig = {
-      suggestions,
-      available: "always"
-    };
-  } else if (suggestions === "auto") {
-    suggestionsConfig = {
-      available: suggestions === "auto" ? "always" : "disabled",
-      instructions: "Suggest what the user could say next. Provide clear, highly relevant suggestions. Do not literally suggest function calls."
-    };
-  } else {
-    suggestionsConfig = { available: "disabled" };
-  }
-  useConfigureChatSuggestions(suggestionsConfig);
-}
 function useCopilotChatInternal({
   suggestions
 } = {}) {
-  var _a, _b, _c, _d;
-  const { copilotkit } = (0, import_react13.useCopilotKit)();
+  var _a, _b, _c;
+  const { copilotkit } = (0, import_react14.useCopilotKit)();
   const { threadId, agentSession } = useCopilotContext();
-  const existingConfig = (0, import_react13.useCopilotChatConfiguration)();
-  const [agentAvailable, setAgentAvailable] = (0, import_react12.useState)(false);
-  useConfigureSuggestions2(suggestions);
-  const resolvedAgentId = (_b = (_a = agentSession == null ? void 0 : agentSession.agentName) != null ? _a : existingConfig == null ? void 0 : existingConfig.agentId) != null ? _b : "default";
-  const { agent } = (0, import_react13.useAgent)({ agentId: resolvedAgentId });
-  (0, import_react12.useEffect)(() => {
+  const existingConfig = (0, import_react14.useCopilotChatConfiguration)();
+  const [agentAvailable, setAgentAvailable] = (0, import_react13.useState)(false);
+  const resolvedAgentId = (_a = existingConfig == null ? void 0 : existingConfig.agentId) != null ? _a : "default";
+  const { agent } = (0, import_react14.useAgent)({ agentId: resolvedAgentId });
+  (0, import_react13.useEffect)(() => {
     const connect = (agent2) => __async(this, null, function* () {
       setAgentAvailable(false);
       try {
@@ -1113,7 +1113,7 @@ function useCopilotChatInternal({
     agent == null ? void 0 : agent.setMessages([]);
     agent == null ? void 0 : agent.setState(null);
   };
-  const deleteMessage = (0, import_react12.useCallback)(
+  const deleteMessage = (0, import_react13.useCallback)(
     (messageId) => {
       var _a2;
       const filteredMessages = ((_a2 = agent == null ? void 0 : agent.messages) != null ? _a2 : []).filter(
@@ -1124,13 +1124,13 @@ function useCopilotChatInternal({
     [agent == null ? void 0 : agent.setMessages, agent == null ? void 0 : agent.messages]
   );
   const latestDelete = useUpdatedRef(deleteMessage);
-  const latestDeleteFunc = (0, import_react12.useCallback)(
+  const latestDeleteFunc = (0, import_react13.useCallback)(
     (messageId) => {
       return latestDelete.current(messageId);
     },
     [latestDelete]
   );
-  const currentSuggestions = (0, import_react13.useSuggestions)({ agentId: resolvedAgentId });
+  const currentSuggestions = (0, import_react14.useSuggestions)({ agentId: resolvedAgentId });
   const reload = useAsyncCallback(
     (reloadMessageId) => __async(this, null, function* () {
       var _a2;
@@ -1197,16 +1197,15 @@ function useCopilotChatInternal({
     }),
     [latestSendMessageFunc]
   );
-  const latestSetMessages = useUpdatedRef(agent == null ? void 0 : agent.setMessages);
-  const latestSetMessagesFunc = (0, import_react12.useCallback)(
+  const latestSetMessagesFunc = (0, import_react13.useCallback)(
     (messages) => {
       var _a2, _b2;
       if (messages.every((message) => message instanceof import_runtime_client_gql2.Message)) {
-        return (_a2 = latestSetMessages.current) == null ? void 0 : _a2.call(latestSetMessages, (0, import_runtime_client_gql2.gqlToAGUI)(messages));
+        return (_a2 = agent == null ? void 0 : agent.setMessages) == null ? void 0 : _a2.call(agent, (0, import_runtime_client_gql2.gqlToAGUI)(messages));
       }
-      return (_b2 = latestSetMessages.current) == null ? void 0 : _b2.call(latestSetMessages, messages);
+      return (_b2 = agent == null ? void 0 : agent.setMessages) == null ? void 0 : _b2.call(agent, messages);
     },
-    [latestSetMessages, agent]
+    [agent == null ? void 0 : agent.setMessages, agent]
   );
   const latestReload = useUpdatedRef(reload);
   const latestReloadFunc = useAsyncCallback(
@@ -1215,25 +1214,24 @@ function useCopilotChatInternal({
     }),
     [latestReload]
   );
-  const latestStop = useUpdatedRef(agent == null ? void 0 : agent.abortRun);
-  const latestStopFunc = (0, import_react12.useCallback)(() => {
+  const latestStopFunc = (0, import_react13.useCallback)(() => {
     var _a2;
-    return (_a2 = latestStop.current) == null ? void 0 : _a2.call(latestStop);
-  }, [latestStop]);
+    return (_a2 = agent == null ? void 0 : agent.abortRun) == null ? void 0 : _a2.call(agent);
+  }, [agent == null ? void 0 : agent.abortRun]);
   const latestReset = useUpdatedRef(reset);
-  const latestResetFunc = (0, import_react12.useCallback)(() => {
+  const latestResetFunc = (0, import_react13.useCallback)(() => {
     return latestReset.current();
   }, [latestReset]);
   const lazyToolRendered = useLazyToolRenderer();
-  const renderCustomMessage = (0, import_react13.useRenderCustomMessages)();
+  const renderCustomMessage = (0, import_react14.useRenderCustomMessages)();
   const legacyCustomMessageRenderer = useLegacyCoagentRenderer({
     copilotkit,
     agent,
     agentId: resolvedAgentId,
-    threadId: (_c = existingConfig == null ? void 0 : existingConfig.threadId) != null ? _c : threadId
+    threadId: (_b = existingConfig == null ? void 0 : existingConfig.threadId) != null ? _b : threadId
   });
-  const allMessages = (_d = agent == null ? void 0 : agent.messages) != null ? _d : [];
-  const resolvedMessages = (0, import_react12.useMemo)(() => {
+  const allMessages = (_c = agent == null ? void 0 : agent.messages) != null ? _c : [];
+  const resolvedMessages = (0, import_react13.useMemo)(() => {
     let processedMessages = allMessages.map((message) => {
       if (message.role !== "assistant") {
         return message;
@@ -1261,33 +1259,24 @@ function useCopilotChatInternal({
       return message;
     });
     const hasAssistantMessages = processedMessages.some((msg) => msg.role === "assistant");
-    if (legacyCustomMessageRenderer && !hasAssistantMessages) {
-      const placeholderId = `coagent-state-render-${resolvedAgentId}`;
-      const placeholderMessage = {
-        id: placeholderId,
-        role: "assistant",
-        content: "",
-        name: "coagent-state-render"
-      };
-      processedMessages = [
-        ...processedMessages,
-        __spreadProps(__spreadValues({}, placeholderMessage), {
-          generativeUI: () => legacyCustomMessageRenderer({
-            message: placeholderMessage,
-            position: "before"
-          })
-        })
-      ];
-    }
     return processedMessages;
   }, [
     agent == null ? void 0 : agent.messages,
     lazyToolRendered,
     allMessages,
     renderCustomMessage,
-    legacyCustomMessageRenderer,
+    // legacyCustomMessageRenderer,
     resolvedAgentId
   ]);
+  const renderedSuggestions = (0, import_react13.useMemo)(() => {
+    if (Array.isArray(suggestions)) {
+      return {
+        suggestions: suggestions.map((s) => __spreadProps(__spreadValues({}, s), { isLoading: false })),
+        isLoading: false
+      };
+    }
+    return currentSuggestions;
+  }, [suggestions, currentSuggestions]);
   return {
     messages: resolvedMessages,
     sendMessage: latestSendMessageFunc,
@@ -1297,25 +1286,25 @@ function useCopilotChatInternal({
     stopGeneration: latestStopFunc,
     reset: latestResetFunc,
     deleteMessage: latestDeleteFunc,
-    isAvailable: !agentAvailable,
+    isAvailable: agentAvailable,
     isLoading: Boolean(agent == null ? void 0 : agent.isRunning),
     // mcpServers,
     // setMcpServers,
-    suggestions: currentSuggestions.suggestions,
+    suggestions: renderedSuggestions.suggestions,
     setSuggestions: (suggestions2) => copilotkit.addSuggestionsConfig({ suggestions: suggestions2 }),
     generateSuggestions: () => __async(this, null, function* () {
       return copilotkit.reloadSuggestions(resolvedAgentId);
     }),
     resetSuggestions: () => copilotkit.clearSuggestions(resolvedAgentId),
-    isLoadingSuggestions: currentSuggestions.isLoading,
+    isLoadingSuggestions: renderedSuggestions.isLoading,
     interrupt,
     agent,
     threadId
   };
 }
 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;
@@ -1326,20 +1315,19 @@ function useLegacyCoagentRenderer({
   agentId,
   threadId
 }) {
-  return (0, import_react12.useMemo)(() => {
+  return (0, import_react13.useMemo)(() => {
     if (!copilotkit || !agent) {
       return null;
     }
     return ({ message, position }) => {
       var _a;
       const effectiveThreadId = (_a = threadId != null ? threadId : agent.threadId) != null ? _a : "default";
-      const existingRunId = copilotkit.getRunIdForMessage(
-        agentId,
-        effectiveThreadId,
-        message.id
-      );
+      const existingRunId = copilotkit.getRunIdForMessage(agentId, effectiveThreadId, message.id);
       const runId = existingRunId || `pending:${message.id}`;
-      const messageIndex = Math.max(agent.messages.findIndex((msg) => msg.id === message.id), 0);
+      const messageIndex = Math.max(
+        agent.messages.findIndex((msg) => msg.id === message.id),
+        0
+      );
       const bridgeProps = {
         message,
         position,
@@ -1350,7 +1338,7 @@ function useLegacyCoagentRenderer({
         agentId,
         stateSnapshot: message.state
       };
-      return (0, import_react12.createElement)(CoAgentStateRenderBridge, bridgeProps);
+      return (0, import_react13.createElement)(CoAgentStateRenderBridge, bridgeProps);
     };
   }, [agent, agentId, copilotkit, threadId]);
 }
@@ -1384,7 +1372,7 @@ function useCopilotChat(options = {}) {
 }
 
 // src/hooks/use-copilot-chat-headless_c.ts
-var import_react14 = require("react");
+var import_react15 = require("react");
 var import_shared4 = require("@copilotkit/shared");
 var createNonFunctionalReturn = () => ({
   visibleMessages: [],
@@ -1425,7 +1413,7 @@ function useCopilotChatHeadless_c(options = {}) {
   const { copilotApiConfig, setBannerError } = useCopilotContext();
   const hasPublicApiKey = Boolean(copilotApiConfig.publicApiKey);
   const internalResult = useCopilotChatInternal(options);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     if (!hasPublicApiKey) {
       setBannerError(
         new import_shared4.CopilotKitError({
@@ -1450,13 +1438,13 @@ function useCopilotChatHeadless_c(options = {}) {
 }
 
 // src/hooks/use-copilot-action.ts
-var import_react21 = require("react");
+var import_react22 = require("react");
 
 // src/hooks/use-frontend-tool.ts
-var import_react15 = __toESM(require("react"));
+var import_react16 = __toESM(require("react"));
 var import_shared5 = require("@copilotkit/shared");
 var import_shared6 = require("@copilotkit/shared");
-var import_react16 = require("@copilotkitnext/react");
+var import_react17 = require("@copilotkitnext/react");
 function useFrontendTool(tool, dependencies) {
   const { name, description, parameters, render, followUp } = tool;
   const zodParameters = (0, import_shared5.getZodParameters)(parameters);
@@ -1466,7 +1454,11 @@ function useFrontendTool(tool, dependencies) {
     }
     if (typeof render === "string") {
       const staticRender = render;
-      return () => import_react15.default.createElement(import_react15.default.Fragment, null, staticRender);
+      return () => import_react16.default.createElement(
+        import_react16.default.Fragment,
+        null,
+        staticRender
+      );
     }
     return (args) => {
       const renderArgs = __spreadProps(__spreadValues({}, args), {
@@ -1474,12 +1466,12 @@ function useFrontendTool(tool, dependencies) {
       });
       const rendered = render(renderArgs);
       if (typeof rendered === "string") {
-        return import_react15.default.createElement(import_react15.default.Fragment, null, rendered);
+        return import_react16.default.createElement(import_react16.default.Fragment, null, rendered);
       }
       return rendered != null ? rendered : null;
     };
   })();
-  (0, import_react16.useFrontendTool)({
+  (0, import_react17.useFrontendTool)({
     name,
     description,
     parameters: zodParameters,
@@ -1491,23 +1483,23 @@ function useFrontendTool(tool, dependencies) {
 
 // src/hooks/use-render-tool-call.ts
 var import_shared7 = require("@copilotkit/shared");
-var import_react17 = require("react");
-var import_react18 = require("@copilotkitnext/react");
+var import_react18 = require("react");
+var import_react19 = require("@copilotkitnext/react");
 var import_shared8 = require("@copilotkit/shared");
 function useRenderToolCall2(tool, dependencies) {
-  const { copilotkit } = (0, import_react18.useCopilotKit)();
-  const hasAddedRef = (0, import_react17.useRef)(false);
-  (0, import_react17.useEffect)(() => {
+  const { copilotkit } = (0, import_react19.useCopilotKit)();
+  const hasAddedRef = (0, import_react18.useRef)(false);
+  (0, import_react18.useEffect)(() => {
     const { name, parameters, render } = tool;
     const zodParameters = (0, import_shared7.getZodParameters)(parameters);
-    const renderToolCall = name === "*" ? (0, import_react18.defineToolCallRenderer)({
+    const renderToolCall = name === "*" ? (0, import_react19.defineToolCallRenderer)({
       name: "*",
       render: (args) => {
         return render(__spreadProps(__spreadValues({}, args), {
           result: args.result ? (0, import_shared8.parseJson)(args.result, args.result) : args.result
         }));
       }
-    }) : (0, import_react18.defineToolCallRenderer)({
+    }) : (0, import_react19.defineToolCallRenderer)({
       name,
       args: zodParameters,
       render: (args) => {
@@ -1536,18 +1528,18 @@ function useRenderToolCall2(tool, dependencies) {
 
 // src/hooks/use-human-in-the-loop.ts
 var import_shared9 = require("@copilotkit/shared");
-var import_react19 = require("@copilotkitnext/react");
+var import_react20 = require("@copilotkitnext/react");
 var import_core = require("@copilotkitnext/core");
-var import_react20 = __toESM(require("react"));
+var import_react21 = __toESM(require("react"));
 function useHumanInTheLoop(tool, dependencies) {
   const _a = tool, { render } = _a, toolRest = __objRest(_a, ["render"]);
   const { name, description, parameters, followUp } = toolRest;
   const zodParameters = (0, import_shared9.getZodParameters)(parameters);
-  const renderRef = (0, import_react20.useRef)(null);
-  (0, import_react20.useEffect)(() => {
+  const renderRef = (0, import_react21.useRef)(null);
+  (0, import_react21.useEffect)(() => {
     renderRef.current = (args) => {
       if (typeof render === "string") {
-        return import_react20.default.createElement(import_react20.default.Fragment, null, render);
+        return import_react21.default.createElement(import_react21.default.Fragment, null, render);
       }
       if (!render) {
         return null;
@@ -1587,12 +1579,12 @@ function useHumanInTheLoop(tool, dependencies) {
       })();
       const rendered = render(renderProps);
       if (typeof rendered === "string") {
-        return import_react20.default.createElement(import_react20.default.Fragment, null, rendered);
+        return import_react21.default.createElement(import_react21.default.Fragment, null, rendered);
       }
       return rendered != null ? rendered : null;
     };
   }, [render, ...dependencies != null ? dependencies : []]);
-  (0, import_react19.useHumanInTheLoop)({
+  (0, import_react20.useHumanInTheLoop)({
     name,
     description,
     followUp,
@@ -1648,7 +1640,7 @@ function getActionConfig(action) {
   throw new Error("Invalid action configuration");
 }
 function useCopilotAction(action, dependencies) {
-  const [initialActionConfig] = (0, import_react21.useState)(getActionConfig(action));
+  const [initialActionConfig] = (0, import_react22.useState)(getActionConfig(action));
   const currentActionConfig = getActionConfig(action);
   if (initialActionConfig.type !== currentActionConfig.type) {
     throw new Error("Action configuration changed between renders");
@@ -1666,14 +1658,14 @@ function useCopilotAction(action, dependencies) {
 }
 
 // src/hooks/use-coagent-state-render.ts
-var import_react22 = require("react");
+var import_react23 = require("react");
 var import_shared10 = require("@copilotkit/shared");
 function useCoAgentStateRender(action, dependencies) {
-  const { chatComponentsCache, availableAgents } = (0, import_react22.useContext)(CopilotContext);
+  const { chatComponentsCache, availableAgents } = (0, import_react23.useContext)(CopilotContext);
   const { setCoAgentStateRender, removeCoAgentStateRender, coAgentStateRenders } = useCoAgentStateRenders();
-  const idRef = (0, import_react22.useRef)((0, import_shared10.randomId)());
+  const idRef = (0, import_react23.useRef)((0, import_shared10.randomId)());
   const { setBannerError, addToast } = useToast();
-  (0, import_react22.useEffect)(() => {
+  (0, import_react23.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_shared10.CopilotKitAgentDiscoveryError({
@@ -1694,7 +1686,7 @@ function useCoAgentStateRender(action, dependencies) {
       }
     }
   }
-  (0, import_react22.useEffect)(() => {
+  (0, import_react23.useEffect)(() => {
     const currentId = idRef.current;
     const hasDuplicate = Object.entries(coAgentStateRenders).some(([id, otherAction]) => {
       if (id === currentId)
@@ -1718,7 +1710,7 @@ function useCoAgentStateRender(action, dependencies) {
       });
     }
   }, [coAgentStateRenders]);
-  (0, import_react22.useEffect)(() => {
+  (0, import_react23.useEffect)(() => {
     setCoAgentStateRender(idRef.current, action);
     if (chatComponentsCache.current !== null && action.render !== void 0) {
       chatComponentsCache.current.coAgentStateRenders[key] = action.render;
@@ -1738,11 +1730,11 @@ function useCoAgentStateRender(action, dependencies) {
 }
 
 // src/hooks/use-make-copilot-document-readable.ts
-var import_react23 = require("react");
+var import_react24 = require("react");
 function useMakeCopilotDocumentReadable(document, categories, dependencies = []) {
   const { addDocumentContext, removeDocumentContext } = useCopilotContext();
-  const idRef = (0, import_react23.useRef)(void 0);
-  (0, import_react23.useEffect)(() => {
+  const idRef = (0, import_react24.useRef)(void 0);
+  (0, import_react24.useEffect)(() => {
     const id = addDocumentContext(document, categories);
     idRef.current = id;
     return () => {
@@ -1753,21 +1745,46 @@ function useMakeCopilotDocumentReadable(document, categories, dependencies = [])
 }
 
 // src/hooks/use-copilot-readable.ts
-var import_react24 = require("@copilotkitnext/react");
-function useCopilotReadable({ description, value }, dependencies) {
-  (0, import_react24.useAgentContext)({
-    description,
-    value
-  });
+var import_react25 = require("@copilotkitnext/react");
+var import_react26 = require("react");
+function useCopilotReadable({ description, value, convert, available }, dependencies) {
+  const { copilotkit } = (0, import_react25.useCopilotKit)();
+  const ctxIdRef = (0, import_react26.useRef)(void 0);
+  (0, import_react26.useEffect)(() => {
+    if (!copilotkit)
+      return;
+    const found = Object.entries(copilotkit.context).find(([id, ctxItem]) => {
+      return JSON.stringify({ description, value }) == JSON.stringify(ctxItem);
+    });
+    if (found) {
+      ctxIdRef.current = found[0];
+      if (available === "disabled")
+        copilotkit.removeContext(ctxIdRef.current);
+      return;
+    }
+    if (!found && available === "disabled")
+      return;
+    ctxIdRef.current = copilotkit.addContext({
+      description,
+      value: (convert != null ? convert : JSON.stringify)(value)
+    });
+    return () => {
+      if (!ctxIdRef.current)
+        return;
+      copilotkit.removeContext(ctxIdRef.current);
+    };
+  }, [description, value, convert]);
+  return ctxIdRef.current;
 }
 
 // src/hooks/use-coagent.ts
-var import_react25 = require("react");
-var import_react26 = require("@copilotkitnext/react");
+var import_react27 = require("react");
+var import_react28 = require("@copilotkitnext/react");
 function useCoAgent(options) {
-  const { agent } = (0, import_react26.useAgent)({ agentId: options.name });
-  const nodeNameRef = (0, import_react25.useRef)("start");
-  const handleStateUpdate = (0, import_react25.useCallback)(
+  const { agent } = (0, import_react28.useAgent)({ agentId: options.name });
+  const { copilotkit } = (0, import_react28.useCopilotKit)();
+  const nodeName = useAgentNodeName(options.name);
+  const handleStateUpdate = (0, import_react27.useCallback)(
     (newState) => {
       if (!agent)
         return;
@@ -1780,22 +1797,34 @@ function useCoAgent(options) {
     },
     [agent == null ? void 0 : agent.state, agent == null ? void 0 : agent.setState]
   );
-  const externalStateStr = (0, import_react25.useMemo)(
+  (0, import_react27.useEffect)(() => {
+    var _a;
+    if (!options.config && !options.configurable)
+      return;
+    let config = (_a = options.config) != null ? _a : {};
+    if (options.configurable) {
+      config = __spreadProps(__spreadValues({}, config), {
+        configurable: __spreadValues(__spreadValues({}, options.configurable), config.configurable)
+      });
+    }
+    copilotkit.setProperties(config);
+  }, [options.config, options.configurable]);
+  const externalStateStr = (0, import_react27.useMemo)(
     () => isExternalStateManagement(options) ? JSON.stringify(options.state) : void 0,
     [isExternalStateManagement(options) ? JSON.stringify(options.state) : void 0]
   );
-  (0, import_react25.useEffect)(() => {
+  (0, import_react27.useEffect)(() => {
     if ((agent == null ? void 0 : agent.state) && isExternalStateManagement(options) && JSON.stringify(options.state) !== JSON.stringify(agent.state)) {
       handleStateUpdate(options.state);
     }
   }, [agent, externalStateStr, handleStateUpdate]);
-  const hasStateValues = (0, import_react25.useCallback)((value) => {
+  const hasStateValues = (0, import_react27.useCallback)((value) => {
     return Boolean(value && Object.keys(value).length);
   }, []);
-  const initialStateRef = (0, import_react25.useRef)(
+  const initialStateRef = (0, import_react27.useRef)(
     isExternalStateManagement(options) ? options.state : "initialState" in options ? options.initialState : void 0
   );
-  (0, import_react25.useEffect)(() => {
+  (0, import_react27.useEffect)(() => {
     if (isExternalStateManagement(options)) {
       initialStateRef.current = options.state;
     } else if ("initialState" in options) {
@@ -1804,7 +1833,7 @@ function useCoAgent(options) {
   }, [
     isExternalStateManagement(options) ? JSON.stringify(options.state) : "initialState" in options ? JSON.stringify(options.initialState) : void 0
   ]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react27.useEffect)(() => {
     if (!agent)
       return;
     const subscriber = {
@@ -1825,15 +1854,6 @@ function useCoAgent(options) {
         if (initialStateRef.current !== void 0) {
           handleStateUpdate(initialStateRef.current);
         }
-      },
-      onStepStartedEvent: ({ event }) => {
-        nodeNameRef.current = event.stepName;
-      },
-      onRunStartedEvent: () => {
-        nodeNameRef.current = "start";
-      },
-      onRunFinishedEvent: () => {
-        nodeNameRef.current = "end";
       }
     };
     const subscription = agent.subscribe(subscriber);
@@ -1841,7 +1861,7 @@ function useCoAgent(options) {
       subscription.unsubscribe();
     };
   }, [agent, handleStateUpdate, hasStateValues]);
-  return (0, import_react25.useMemo)(() => {
+  return (0, import_react27.useMemo)(() => {
     var _a, _b, _c;
     if (!agent) {
       const noop = () => {
@@ -1857,7 +1877,7 @@ function useCoAgent(options) {
       );
       return {
         name: options.name,
-        nodeName: nodeNameRef.current,
+        nodeName,
         threadId: void 0,
         running: false,
         state: initialState,
@@ -1869,7 +1889,7 @@ function useCoAgent(options) {
     }
     return {
       name: (_c = agent == null ? void 0 : agent.agentId) != null ? _c : options.name,
-      nodeName: nodeNameRef.current,
+      nodeName,
       threadId: agent.threadId,
       running: agent.isRunning,
       state: agent.state,
@@ -1897,12 +1917,12 @@ var isExternalStateManagement = (options) => {
 
 // src/hooks/use-copilot-runtime-client.ts
 var import_runtime_client_gql3 = require("@copilotkit/runtime-client-gql");
-var import_react27 = require("react");
+var import_react29 = require("react");
 var import_shared11 = require("@copilotkit/shared");
 var useCopilotRuntimeClient = (options) => {
   const { setBannerError } = useToast();
   const _a = options, { showDevConsole, onError } = _a, runtimeOptions = __objRest(_a, ["showDevConsole", "onError"]);
-  const lastStructuredErrorRef = (0, import_react27.useRef)(null);
+  const lastStructuredErrorRef = (0, import_react29.useRef)(null);
   const traceUIError = (error, originalError) => __async(void 0, null, function* () {
     try {
       const errorEvent = {
@@ -1928,7 +1948,7 @@ var useCopilotRuntimeClient = (options) => {
       console.error("Error in onError handler:", error2);
     }
   });
-  const runtimeClient = (0, import_react27.useMemo)(() => {
+  const runtimeClient = (0, import_react29.useMemo)(() => {
     return new import_runtime_client_gql3.CopilotRuntimeClient(__spreadProps(__spreadValues({}, runtimeOptions), {
       handleGQLErrors: (error) => {
         var _a2;
@@ -2007,28 +2027,28 @@ function createStructuredError(gqlError) {
 }
 
 // src/hooks/use-copilot-authenticated-action.ts
-var import_react28 = require("react");
-var import_react29 = __toESM(require("react"));
+var import_react30 = require("react");
+var import_react31 = __toESM(require("react"));
 function useCopilotAuthenticatedAction_c(action, dependencies) {
   const { authConfig_c, authStates_c, setAuthStates_c } = useCopilotContext();
-  const pendingActionRef = (0, import_react28.useRef)(null);
-  const executeAction = (0, import_react28.useCallback)(
+  const pendingActionRef = (0, import_react30.useRef)(null);
+  const executeAction = (0, import_react30.useCallback)(
     (props) => {
       if (typeof action.render === "function") {
         return action.render(props);
       }
-      return action.render || import_react29.default.createElement(import_react28.Fragment);
+      return action.render || import_react31.default.createElement(import_react30.Fragment);
     },
     [action]
   );
-  const wrappedRender = (0, import_react28.useCallback)(
+  const wrappedRender = (0, import_react30.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_react29.default.createElement(authConfig_c.SignInComponent, {
+        return (authConfig_c == null ? void 0 : authConfig_c.SignInComponent) ? import_react31.default.createElement(authConfig_c.SignInComponent, {
           onSignInComplete: (authState) => {
             setAuthStates_c == null ? void 0 : setAuthStates_c((prev) => __spreadProps(__spreadValues({}, prev), { [action.name]: authState }));
             if (pendingActionRef.current) {
@@ -2036,7 +2056,7 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
               pendingActionRef.current = null;
             }
           }
-        }) : import_react29.default.createElement(import_react28.Fragment);
+        }) : import_react31.default.createElement(import_react30.Fragment);
       }
       return executeAction(props);
     },
@@ -2051,16 +2071,16 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
 }
 
 // src/hooks/use-langgraph-interrupt.ts
-var import_react30 = require("react");
+var import_react32 = require("react");
 var import_shared12 = require("@copilotkit/shared");
 function useLangGraphInterrupt(action, dependencies) {
-  const { setInterruptAction, removeInterruptAction, interruptActions, threadId } = (0, import_react30.useContext)(CopilotContext);
+  const { setInterruptAction, removeInterruptAction, interruptActions, threadId } = (0, import_react32.useContext)(CopilotContext);
   const { addToast } = useToast();
-  const actionId = (0, import_shared12.dataToUUID)(JSON.stringify(action), "lgAction");
-  (0, import_react30.useEffect)(() => {
+  const actionId = (0, import_shared12.dataToUUID)(action, "lgAction");
+  (0, import_react32.useEffect)(() => {
     if (!action)
       return;
-    setInterruptAction(threadId, __spreadProps(__spreadValues({}, action), { id: actionId }));
+    setInterruptAction(__spreadProps(__spreadValues({}, action), { id: actionId }));
     return () => {
       removeInterruptAction(actionId);
     };
@@ -2068,10 +2088,10 @@ function useLangGraphInterrupt(action, dependencies) {
 }
 
 // src/hooks/use-copilot-additional-instructions.ts
-var import_react31 = require("react");
+var import_react33 = require("react");
 function useCopilotAdditionalInstructions({ instructions, available = "enabled" }, dependencies) {
   const { setAdditionalInstructions } = useCopilotContext();
-  (0, import_react31.useEffect)(() => {
+  (0, import_react33.useEffect)(() => {
     if (available === "disabled")
       return;
     setAdditionalInstructions((prevInstructions) => [...prevInstructions || [], instructions]);
@@ -2087,17 +2107,32 @@ function useCopilotAdditionalInstructions({ instructions, available = "enabled"
 function useDefaultTool(tool, dependencies) {
   useCopilotAction(__spreadProps(__spreadValues({}, tool), { name: "*" }), dependencies);
 }
+
+// src/hooks/use-copilot-chat-suggestions.tsx
+var import_react34 = require("@copilotkitnext/react");
+function useCopilotChatSuggestions(config, dependencies = []) {
+  var _a, _b;
+  const existingConfig = (0, import_react34.useCopilotChatConfiguration)();
+  const resolvedAgentId = (_a = existingConfig == null ? void 0 : existingConfig.agentId) != null ? _a : "default";
+  const available = (_b = config.available === "enabled" ? "always" : config.available) != null ? _b : "before-first-message";
+  const finalSuggestionConfig = __spreadProps(__spreadValues({}, config), {
+    available,
+    consumerAgentId: resolvedAgentId
+    // Use chatConfig.agentId here
+  });
+  (0, import_react34.useConfigureSuggestions)(finalSuggestionConfig, dependencies);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   useCoAgent,
   useCoAgentStateRender,
-  useConfigureChatSuggestions,
   useCopilotAction,
   useCopilotAdditionalInstructions,
   useCopilotAuthenticatedAction_c,
   useCopilotChat,
   useCopilotChatHeadless_c,
   useCopilotChatInternal,
+  useCopilotChatSuggestions,
   useCopilotReadable,
   useCopilotRuntimeClient,
   useDefaultTool,