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

package/dist/hooks/index.mjs

@@ -1,56 +1,56 @@
 import "../chunk-CQPYJIBH.mjs";
+import {
+  useMakeCopilotDocumentReadable
+} from "../chunk-ERXWDCY6.mjs";
+import {
+  useCopilotAdditionalInstructions
+} from "../chunk-JPMIAGI6.mjs";
+import {
+  useCopilotAuthenticatedAction_c
+} from "../chunk-EF5BNM34.mjs";
+import {
+  useCopilotReadable
+} from "../chunk-UBNRUXEK.mjs";
 import {
   useLangGraphInterruptRender
-} from "../chunk-Q5D5XQFA.mjs";
+} from "../chunk-CMQV4XNY.mjs";
 import {
   useLangGraphInterrupt
-} from "../chunk-YZDRMIOM.mjs";
-import {
-  useMakeCopilotDocumentReadable
-} from "../chunk-UHQMV2CE.mjs";
+} from "../chunk-OIPDW3UR.mjs";
 import {
   useCoAgentStateRender
-} from "../chunk-2FW7HH6W.mjs";
+} from "../chunk-3YHYWAHK.mjs";
 import {
   runAgent,
   startAgent,
   stopAgent,
   useCoAgent
-} from "../chunk-XY5BN4HZ.mjs";
-import {
-  useCopilotAdditionalInstructions
-} from "../chunk-C6F6EQNA.mjs";
-import {
-  useCopilotAuthenticatedAction_c
-} from "../chunk-LDACFA2B.mjs";
-import {
-  useCopilotAction
-} from "../chunk-T42PN5VN.mjs";
+} from "../chunk-RYREGU4E.mjs";
 import {
   useCopilotChat
-} from "../chunk-UIT6QMUJ.mjs";
-import {
-  useCopilotReadable
-} from "../chunk-LZDDYZEY.mjs";
-import "../chunk-SGLWMQ2J.mjs";
-import "../chunk-QQZLIEXK.mjs";
-import "../chunk-NNSXCFQO.mjs";
-import "../chunk-5FHSUKQL.mjs";
+} from "../chunk-7BYXCFPB.mjs";
+import "../chunk-YPSGKPDA.mjs";
+import "../chunk-BEDNUHSA.mjs";
+import "../chunk-SJJNFYGQ.mjs";
+import "../chunk-JDEWNLNP.mjs";
 import "../chunk-RKTVJRK7.mjs";
 import "../chunk-PMAFHQ7P.mjs";
-import "../chunk-HD2GE3DK.mjs";
-import "../chunk-YPSGKPDA.mjs";
+import "../chunk-5FHSUKQL.mjs";
 import "../chunk-DCTJZ742.mjs";
-import "../chunk-HJP2RX5R.mjs";
+import "../chunk-57K2ZJ5F.mjs";
+import "../chunk-AFDL5JI3.mjs";
 import "../chunk-4CEQJ2X6.mjs";
-import "../chunk-CCESTGAM.mjs";
-import "../chunk-O7ARI5CV.mjs";
 import {
   useCopilotRuntimeClient
-} from "../chunk-RUY6MLHA.mjs";
+} from "../chunk-55QZ2SVJ.mjs";
 import "../chunk-GFJW4RIM.mjs";
-import "../chunk-VRXANACV.mjs";
-import "../chunk-6KGEF242.mjs";
+import {
+  useCopilotAction
+} from "../chunk-NQVCZQ5T.mjs";
+import "../chunk-3OQM3NEK.mjs";
+import "../chunk-O7ARI5CV.mjs";
+import "../chunk-YAF2LATQ.mjs";
+import "../chunk-XFOTNHYA.mjs";
 import "../chunk-SKC7AJIV.mjs";
 export {
   runAgent,

package/dist/hooks/use-chat.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { FunctionCallHandler, CoAgentStateRenderHandler } from '@copilotkit/shared';
 import { Message, TextMessage, ForwardedParametersInput, ExtensionsInput } from '@copilotkit/runtime-client-gql';
-import { c as CopilotApiConfig, A as AgentSession, L as LangGraphInterruptAction, d as LangGraphInterruptActionSetter } from '../copilot-context-f9b2b4c3.js';
+import { c as CopilotApiConfig, A as AgentSession, L as LangGraphInterruptAction, d as LangGraphInterruptActionSetter } from '../copilot-context-3da805ab.js';
 import { FrontendAction } from '../types/frontend-action.js';
 import { CoagentState } from '../types/coagent-state.js';
 import './use-tree.js';

package/dist/hooks/use-chat.js

@@ -139,8 +139,35 @@ function shouldShowDevConsole(showDevConsole) {
 // src/hooks/use-copilot-runtime-client.ts
 var useCopilotRuntimeClient = (options) => {
   const { setBannerError } = useToast();
-  const _a = options, { showDevConsole } = _a, runtimeOptions = __objRest(_a, ["showDevConsole"]);
+  const _a = options, { showDevConsole, onTrace } = _a, runtimeOptions = __objRest(_a, ["showDevConsole", "onTrace"]);
   const lastStructuredErrorRef = (0, import_react2.useRef)(null);
+  const traceUIError = (error, originalError) => __async(void 0, null, function* () {
+    if (!onTrace || !runtimeOptions.publicApiKey)
+      return;
+    try {
+      const traceEvent = {
+        type: "error",
+        timestamp: Date.now(),
+        context: {
+          source: "ui",
+          request: {
+            operation: "runtimeClient",
+            url: runtimeOptions.url,
+            startTime: Date.now()
+          },
+          technical: {
+            environment: "browser",
+            userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0,
+            stackTrace: originalError instanceof Error ? originalError.stack : void 0
+          }
+        },
+        error
+      };
+      yield onTrace(traceEvent);
+    } catch (traceError) {
+      console.error("Error in onTrace handler:", traceError);
+    }
+  });
   const runtimeClient = (0, import_react2.useMemo)(() => {
     return new import_runtime_client_gql2.CopilotRuntimeClient(__spreadProps(__spreadValues({}, runtimeOptions), {
       handleGQLErrors: (error) => {
@@ -168,12 +195,14 @@ var useCopilotRuntimeClient = (options) => {
             const ckError = createStructuredError(gqlError);
             if (ckError) {
               setBannerError(ckError);
+              traceUIError(ckError, gqlError);
             } else {
               const fallbackError = new import_shared3.CopilotKitError({
                 message: gqlError.message,
                 code: import_shared3.CopilotKitErrorCode.UNKNOWN
               });
               setBannerError(fallbackError);
+              traceUIError(fallbackError, gqlError);
             }
           };
           graphQLErrors.forEach(routeError);
@@ -187,6 +216,7 @@ var useCopilotRuntimeClient = (options) => {
               code: import_shared3.CopilotKitErrorCode.UNKNOWN
             });
             setBannerError(fallbackError);
+            traceUIError(fallbackError, error);
           }
         }
       },
@@ -199,7 +229,7 @@ var useCopilotRuntimeClient = (options) => {
         setBannerError(warningError);
       }
     }));
-  }, [runtimeOptions, setBannerError, showDevConsole]);
+  }, [runtimeOptions, setBannerError, showDevConsole, onTrace]);
   return runtimeClient;
 };
 function createStructuredError(gqlError) {
@@ -299,7 +329,8 @@ var emptyCopilotContext = {
   },
   langGraphInterruptAction: null,
   setLangGraphInterruptAction: () => null,
-  removeLangGraphInterruptAction: () => null
+  removeLangGraphInterruptAction: () => null,
+  onTrace: void 0
 };
 var CopilotContext = import_react3.default.createContext(emptyCopilotContext);
 function useCopilotContext() {
@@ -458,6 +489,35 @@ function useChat(options) {
   } = options;
   const runChatCompletionRef = (0, import_react5.useRef)();
   const addErrorToast = useErrorToast();
+  const { setBannerError } = useToast();
+  const { onTrace } = useCopilotContext();
+  const traceUIError = (error, originalError) => __async(this, null, function* () {
+    if (!onTrace || !(copilotConfig == null ? void 0 : copilotConfig.publicApiKey))
+      return;
+    try {
+      const traceEvent = {
+        type: "error",
+        timestamp: Date.now(),
+        context: {
+          source: "ui",
+          request: {
+            operation: "useChatCompletion",
+            url: copilotConfig.chatApiEndpoint,
+            startTime: Date.now()
+          },
+          technical: {
+            environment: "browser",
+            userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0,
+            stackTrace: originalError instanceof Error ? originalError.stack : void 0
+          }
+        },
+        error
+      };
+      yield onTrace(traceEvent);
+    } catch (traceError) {
+      console.error("Error in use-chat onTrace handler:", traceError);
+    }
+  });
   const agentSessionRef = (0, import_react5.useRef)(agentSession);
   agentSessionRef.current = agentSession;
   const runIdRef = (0, import_react5.useRef)(runId);
@@ -477,7 +537,7 @@ function useChat(options) {
   const pendingAppendsRef = (0, import_react5.useRef)([]);
   const runChatCompletion = useAsyncCallback(
     (previousMessages) => __async(this, null, function* () {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o;
+      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_gql3.MetaEventName.LangGraphInterruptEvent && (interruptEvent == null ? void 0 : interruptEvent.value) && !(interruptEvent == null ? void 0 : interruptEvent.response) && agentSessionRef.current) {
@@ -609,20 +669,53 @@ function useChat(options) {
           messages2 = (0, import_runtime_client_gql3.convertGqlOutputToMessages)(
             (0, import_runtime_client_gql3.filterAdjacentAgentStateMessages)(rawMessagesResponse)
           );
-          if (messages2.length === 0) {
-            continue;
-          }
           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_gql3.TextMessage({
                 role: import_runtime_client_gql3.MessageRole.Assistant,
-                content: ((_l = value.generateCopilotResponse.status.details) == null ? void 0 : _l.guardrailsReason) || ""
+                content: guardrailsReason
               })
             ];
+            const guardrailsError = new import_shared4.CopilotKitError({
+              message: `Guardrails validation failed: ${guardrailsReason}`,
+              code: import_shared4.CopilotKitErrorCode.MISUSE
+            });
+            yield traceUIError(guardrailsError, {
+              statusReason: value.generateCopilotResponse.status.reason,
+              statusDetails: value.generateCopilotResponse.status.details
+            });
             setMessages([...previousMessages, ...newMessages]);
             break;
-          } else {
+          }
+          if (((_m = value.generateCopilotResponse.status) == null ? void 0 : _m.__typename) === "FailedResponseStatus" && value.generateCopilotResponse.status.reason === "UNKNOWN_ERROR") {
+            const errorMessage = ((_n = value.generateCopilotResponse.status.details) == null ? void 0 : _n.description) || "An unknown error occurred";
+            const statusDetails = value.generateCopilotResponse.status.details;
+            const originalError = (statusDetails == null ? void 0 : statusDetails.originalError) || (statusDetails == null ? void 0 : statusDetails.error);
+            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_shared4.CopilotKitErrorCode.NETWORK_ERROR;
+            if (originalCode && Object.values(import_shared4.CopilotKitErrorCode).includes(originalCode)) {
+              errorCode = originalCode;
+            }
+            const structuredError = new import_shared4.CopilotKitError({
+              message: errorMessage,
+              code: errorCode,
+              severity: originalSeverity,
+              visibility: originalVisibility
+            });
+            setBannerError(structuredError);
+            yield traceUIError(structuredError, {
+              statusReason: value.generateCopilotResponse.status.reason,
+              statusDetails: value.generateCopilotResponse.status.details,
+              originalErrorCode: originalCode,
+              preservedStructure: !!originalCode
+            });
+            setIsLoading(false);
+            break;
+          } else if (messages2.length > 0) {
             newMessages = [...messages2];
             for (const message of messages2) {
               if (message.isAgentStateMessage() && !message.active && !executedCoAgentStateRenders.includes(message.id) && onCoAgentStateRender) {
@@ -753,11 +846,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
-          !((_m = chatAbortControllerRef.current) == null ? void 0 : _m.signal.aborted)
+          !((_r = chatAbortControllerRef.current) == null ? void 0 : _r.signal.aborted)
         ) {
           yield new Promise((resolve) => setTimeout(resolve, 10));
           return yield runChatCompletionRef.current(finalMessages);
-        } else if ((_n = chatAbortControllerRef.current) == null ? void 0 : _n.signal.aborted) {
+        } else if ((_s = chatAbortControllerRef.current) == null ? void 0 : _s.signal.aborted) {
           const repairedMessages = finalMessages.filter((message, actionExecutionIndex) => {
             if (message.isActionExecutionMessage()) {
               return finalMessages.find(
@@ -768,7 +861,7 @@ function useChat(options) {
           });
           const repairedMessageIds = repairedMessages.map((message) => message.id);
           setMessages(repairedMessages);
-          if ((_o = agentSessionRef.current) == null ? void 0 : _o.nodeName) {
+          if ((_t = agentSessionRef.current) == null ? void 0 : _t.nodeName) {
             setAgentSession({
               threadId: agentSessionRef.current.threadId,
               agentName: agentSessionRef.current.agentName,