@copilotkit/react-core 1.5.15-next.3 → 1.5.15-next.4

package/dist/index.js

@@ -100,6 +100,8 @@ __export(src_exports, {
   useCopilotMessagesContext: () => useCopilotMessagesContext,
   useCopilotReadable: () => useCopilotReadable,
   useCopilotRuntimeClient: () => useCopilotRuntimeClient,
+  useLangGraphInterrupt: () => useLangGraphInterrupt,
+  useLangGraphInterruptRender: () => useLangGraphInterruptRender,
   useMakeCopilotDocumentReadable: () => useMakeCopilotDocumentReadable
 });
 module.exports = __toCommonJS(src_exports);
@@ -174,7 +176,10 @@ var emptyCopilotContext = {
   availableAgents: [],
   extensions: {},
   setExtensions: () => {
-  }
+  },
+  langGraphInterruptAction: null,
+  setLangGraphInterruptAction: () => null,
+  removeLangGraphInterruptAction: () => null
 };
 var CopilotContext = import_react.default.createContext(emptyCopilotContext);
 function useCopilotContext() {
@@ -1403,6 +1408,23 @@ ${nonDocumentStrings}`;
   const [runId, setRunId] = (0, import_react10.useState)(null);
   const chatAbortControllerRef = (0, import_react10.useRef)(null);
   const showDevConsole = props.showDevConsole === void 0 ? "auto" : props.showDevConsole;
+  const [langGraphInterruptAction, _setLangGraphInterruptAction] = (0, import_react10.useState)(null);
+  const setLangGraphInterruptAction = (0, import_react10.useCallback)((action) => {
+    _setLangGraphInterruptAction((prev) => {
+      if (prev == null)
+        return action;
+      if (action == null)
+        return null;
+      let event = prev.event;
+      if (action.event) {
+        event = __spreadValues(__spreadValues({}, prev.event), action.event);
+      }
+      return __spreadProps(__spreadValues(__spreadValues({}, prev), action), { event });
+    });
+  }, []);
+  const removeLangGraphInterruptAction = (0, import_react10.useCallback)(() => {
+    setLangGraphInterruptAction(null);
+  }, []);
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
     CopilotContext.Provider,
     {
@@ -1449,7 +1471,10 @@ ${nonDocumentStrings}`;
         authStates_c: authStates,
         setAuthStates_c: setAuthStates,
         extensions,
-        setExtensions
+        setExtensions,
+        langGraphInterruptAction,
+        setLangGraphInterruptAction,
+        removeLangGraphInterruptAction
       },
       children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CopilotMessages, { children })
     }
@@ -1498,7 +1523,7 @@ function validateProps(props) {
 
 // src/hooks/use-copilot-chat.ts
 var import_react12 = require("react");
-var import_runtime_client_gql7 = require("@copilotkit/runtime-client-gql");
+var import_runtime_client_gql8 = require("@copilotkit/runtime-client-gql");
 
 // src/hooks/use-chat.ts
 var import_react11 = require("react");
@@ -1531,6 +1556,7 @@ function processActionsForRuntimeRequest(actions) {
 }
 
 // src/hooks/use-chat.ts
+var import_runtime_client_gql7 = require("@copilotkit/runtime-client-gql");
 function useChat(options) {
   const {
     messages,
@@ -1554,7 +1580,9 @@ function useChat(options) {
     chatAbortControllerRef,
     agentLock,
     extensions,
-    setExtensions
+    setExtensions,
+    langGraphInterruptAction,
+    setLangGraphInterruptAction
   } = options;
   const runChatCompletionRef = (0, import_react11.useRef)();
   const addErrorToast = useErrorToast();
@@ -1574,7 +1602,7 @@ function useChat(options) {
   });
   const runChatCompletion = useAsyncCallback(
     (previousMessages) => __async(this, null, function* () {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
       setIsLoading(true);
       let newMessages = [
         new import_runtime_client_gql6.TextMessage({
@@ -1597,6 +1625,7 @@ function useChat(options) {
             threadId,
             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))
           }, copilotConfig.cloud ? {
             cloud: __spreadValues({}, ((_c = (_b = (_a = copilotConfig.cloud.guardrails) == null ? void 0 : _a.input) == null ? void 0 : _b.restrictToTopic) == null ? void 0 : _c.enabled) ? {
@@ -1658,15 +1687,22 @@ function useChat(options) {
           messages2 = (0, import_runtime_client_gql6.convertGqlOutputToMessages)(
             (0, import_runtime_client_gql6.filterAdjacentAgentStateMessages)(value.generateCopilotResponse.messages)
           );
+          ((_i = (_h = value.generateCopilotResponse) == null ? void 0 : _h.metaEvents) != null ? _i : []).forEach((ev) => {
+            if (ev.name === "LangGraphInterruptEvent") {
+              setLangGraphInterruptAction({
+                event: (0, import_runtime_client_gql6.langGraphInterruptEvent)(ev)
+              });
+            }
+          });
           if (messages2.length === 0) {
             continue;
           }
           newMessages = [];
-          if (((_h = value.generateCopilotResponse.status) == null ? void 0 : _h.__typename) === "FailedResponseStatus" && value.generateCopilotResponse.status.reason === "GUARDRAILS_VALIDATION_FAILED") {
+          if (((_j = value.generateCopilotResponse.status) == null ? void 0 : _j.__typename) === "FailedResponseStatus" && value.generateCopilotResponse.status.reason === "GUARDRAILS_VALIDATION_FAILED") {
             newMessages = [
               new import_runtime_client_gql6.TextMessage({
                 role: import_runtime_client_gql6.MessageRole.Assistant,
-                content: ((_i = value.generateCopilotResponse.status.details) == null ? void 0 : _i.guardrailsReason) || ""
+                content: ((_k = value.generateCopilotResponse.status.details) == null ? void 0 : _k.guardrailsReason) || ""
               })
             ];
             setMessages([...previousMessages, ...newMessages]);
@@ -1804,11 +1840,11 @@ function useChat(options) {
           followUp !== false && // and we executed an action
           (didExecuteAction || // the last message is a server side result
           !isAgentRun && finalMessages.length && finalMessages[finalMessages.length - 1].isResultMessage()) && // the user did not stop generation
-          !((_j = chatAbortControllerRef.current) == null ? void 0 : _j.signal.aborted)
+          !((_l = chatAbortControllerRef.current) == null ? void 0 : _l.signal.aborted)
         ) {
           yield new Promise((resolve) => setTimeout(resolve, 10));
           return yield runChatCompletionRef.current(finalMessages);
-        } else if ((_k = chatAbortControllerRef.current) == null ? void 0 : _k.signal.aborted) {
+        } else if ((_m = chatAbortControllerRef.current) == null ? void 0 : _m.signal.aborted) {
           const repairedMessages = finalMessages.filter((message, actionExecutionIndex) => {
             if (message.isActionExecutionMessage()) {
               return finalMessages.find(
@@ -1819,7 +1855,7 @@ function useChat(options) {
           });
           const repairedMessageIds = repairedMessages.map((message) => message.id);
           setMessages(repairedMessages);
-          if ((_l = agentSessionRef.current) == null ? void 0 : _l.nodeName) {
+          if ((_n = agentSessionRef.current) == null ? void 0 : _n.nodeName) {
             setAgentSession({
               threadId: agentSessionRef.current.threadId,
               agentName: agentSessionRef.current.agentName,
@@ -1858,6 +1894,33 @@ function useChat(options) {
     }),
     [messages]
   );
+  const composeAndFlushMetaEventsInput = (0, import_react11.useCallback)(
+    (metaEvents) => {
+      return metaEvents.reduce((acc, event) => {
+        if (!event)
+          return acc;
+        switch (event.name) {
+          case import_runtime_client_gql7.MetaEventName.LangGraphInterruptEvent:
+            if (event.response) {
+              setLangGraphInterruptAction(null);
+              return [
+                ...acc,
+                {
+                  type: event.type,
+                  name: event.name,
+                  value: event.value,
+                  response: event.response
+                }
+              ];
+            }
+            return acc;
+          default:
+            return acc;
+        }
+      }, []);
+    },
+    [setLangGraphInterruptAction]
+  );
   const append = useAsyncCallback(
     (message, options2) => __async(this, null, function* () {
       var _a;
@@ -1942,7 +2005,9 @@ function useCopilotChat(_a = {}) {
     setRunId,
     chatAbortControllerRef,
     extensions,
-    setExtensions
+    setExtensions,
+    langGraphInterruptAction,
+    setLangGraphInterruptAction
   } = useCopilotContext();
   const { messages, setMessages } = useCopilotMessagesContext();
   const latestGetContextString = useUpdatedRef(getContextString);
@@ -1955,9 +2020,9 @@ function useCopilotChat(_a = {}) {
   const makeSystemMessageCallback = (0, import_react12.useCallback)(() => {
     const systemMessageMaker = makeSystemMessage2 || defaultSystemMessage;
     const contextString = latestGetContextString.current([], 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 onCoAgentStateRender = useAsyncCallback(
@@ -2001,7 +2066,9 @@ function useCopilotChat(_a = {}) {
     chatAbortControllerRef,
     agentLock,
     extensions,
-    setExtensions
+    setExtensions,
+    langGraphInterruptAction,
+    setLangGraphInterruptAction
   }));
   const latestAppend = useUpdatedRef(append);
   const latestAppendFunc = useAsyncCallback(
@@ -2479,8 +2546,96 @@ function useCopilotAuthenticatedAction_c(action, dependencies) {
   );
 }
 
+// src/hooks/use-langgraph-interrupt.ts
+var import_react20 = require("react");
+var import_shared12 = require("@copilotkit/shared");
+function useLangGraphInterrupt(action, dependencies) {
+  var _a;
+  const { setLangGraphInterruptAction, removeLangGraphInterruptAction, langGraphInterruptAction } = (0, import_react20.useContext)(CopilotContext);
+  const { runChatCompletion } = useCopilotChat();
+  const { addToast } = useToast();
+  const actionId = (0, import_shared12.dataToUUID)(JSON.stringify(action), "lgAction");
+  const hasAction = (0, import_react20.useMemo)(
+    () => Boolean(langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id),
+    [langGraphInterruptAction]
+  );
+  const isCurrentAction = (0, import_react20.useMemo)(
+    () => (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) && (langGraphInterruptAction == null ? void 0 : langGraphInterruptAction.id) === actionId,
+    [langGraphInterruptAction]
+  );
+  (0, import_react20.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)(() => {
+    var _a2;
+    if (!action)
+      return;
+    if (hasAction && !isCurrentAction && !((_a2 = action.conditions) == null ? void 0 : _a2.length)) {
+      addToast({
+        type: "warning",
+        message: "An action is already registered for the interrupt event"
+      });
+      return;
+    }
+    if (hasAction && isCurrentAction) {
+      return;
+    }
+    setLangGraphInterruptAction(__spreadProps(__spreadValues({}, action), { id: actionId }));
+  }, [
+    action,
+    hasAction,
+    isCurrentAction,
+    setLangGraphInterruptAction,
+    removeLangGraphInterruptAction,
+    ...dependencies || []
+  ]);
+}
+
+// src/hooks/use-langgraph-interrupt-render.ts
+var import_react21 = __toESM(require("react"));
+var import_shared13 = require("@copilotkit/shared");
+var InterruptRenderer = ({ event, result, render, resolve }) => {
+  return render({ event, result, resolve });
+};
+function useLangGraphInterruptRender() {
+  const { langGraphInterruptAction, setLangGraphInterruptAction } = 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, conditions } = langGraphInterruptAction;
+  const conditionsMet = (0, import_shared13.executeConditions)({ conditions, value: event.value });
+  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/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;
@@ -2508,12 +2663,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,
@@ -2525,9 +2680,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: __spreadProps(__spreadValues({}, (_a = this.forwardedParameters) != null ? _a : {}), {
             toolChoice: "required"
@@ -2536,7 +2691,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) {
@@ -2595,6 +2750,8 @@ ${instructions}
   useCopilotMessagesContext,
   useCopilotReadable,
   useCopilotRuntimeClient,
+  useLangGraphInterrupt,
+  useLangGraphInterruptRender,
   useMakeCopilotDocumentReadable
 });
 //# sourceMappingURL=index.js.map