@opengeni/react 7.6.1 → 7.7.0-canary.37090756480001

package/dist/{chunk-BI57CQUV.js → chunk-I7IWRQLN.js}

@@ -23,7 +23,7 @@ import {
 } from "./chunk-BRM6FVZA.js";
 import {
   stringifyPayload
-} from "./chunk-UJRYEWZI.js";
+} from "./chunk-UTRTG6LH.js";
 import {
   cn
 } from "./chunk-22KP6LR5.js";
@@ -1605,4 +1605,4 @@ export {
   retainedImageId,
   Markdown
 };
-//# sourceMappingURL=chunk-BI57CQUV.js.map
+//# sourceMappingURL=chunk-I7IWRQLN.js.map

package/dist/{chunk-XA6R7DJQ.js → chunk-IQUCRAT7.js}

@@ -1,11 +1,11 @@
 import {
   formatBytes,
   formatRelativeTime
-} from "./chunk-UJRYEWZI.js";
+} from "./chunk-UTRTG6LH.js";
 import {
   useMutationRunner,
   usePageLiveActivity
-} from "./chunk-KZ73RL76.js";
+} from "./chunk-YQEAA6LT.js";
 import {
   useOpenGeni
 } from "./chunk-NEXLLTP4.js";
@@ -2448,4 +2448,4 @@ export {
   EnrollmentDeviceFlow,
   EnrollmentConsent
 };
-//# sourceMappingURL=chunk-XA6R7DJQ.js.map
+//# sourceMappingURL=chunk-IQUCRAT7.js.map

package/dist/{chunk-DV2DBNPQ.js → chunk-Q5QBEZIQ.js}

@@ -1,17 +1,26 @@
 import {
+  COMPOSER_MODEL_UNAVAILABLE_MESSAGE,
+  ComposerReconciliationRequiredError,
+  ComposerStateError,
+  ComposerWorkspaceControlUnavailableError,
   composerSubmissionCanRetry,
   composerSubmissionErrorMessage
-} from "./chunk-UJRYEWZI.js";
+} from "./chunk-UTRTG6LH.js";
 import {
   useSessionEventTrigger
-} from "./chunk-KZ73RL76.js";
+} from "./chunk-YQEAA6LT.js";
+import {
+  normalizeError,
+  useErrorMessage
+} from "./chunk-UGLEYEMP.js";
 import {
   useEmbeddedSession
 } from "./chunk-NEXLLTP4.js";
 
 // src/hooks/use-composer.ts
 import {
-  DEFAULT_FILE_RESOURCE_MOUNT_ROOT
+  DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
+  OpenGeniApiError
 } from "@opengeni/sdk";
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 var PENDING_COMPOSER_STORAGE_PREFIX = "opengeni.pending-composer.v1:";
@@ -55,12 +64,23 @@ function restoreOptimisticSendOperations(key) {
     newerShadow: operation.newerShadow ?? { text: "", resources: [], annotations: [] },
     state: operation.state === "sending" || operation.state === "queued" ? "sending" : operation.state,
     outcomeUnknown: operation.state === "sending" || operation.state === "queued" ? true : operation.outcomeUnknown,
-    error: operation.state === "sending" ? "Delivery was interrupted; retry to reconcile this message." : operation.error ? composerSubmissionErrorMessage(new Error(operation.error)) : void 0,
+    correlationId: restoredCorrelationId(operation.correlationId),
+    error: restoredErrorReference(
+      operation.correlationId,
+      hasMcpCredentialUpdates && (operation.state === "sending" || operation.outcomeUnknown) ? composerSubmissionErrorMessage(new ComposerReconciliationRequiredError()) : operation.state === "sending" ? "Delivery was interrupted; retry to reconcile this message." : operation.outcomeUnknown ? "The request could not be confirmed. Check its status before retrying." : operation.error ? composerSubmissionErrorMessage(new Error(operation.error)) : void 0
+    ),
     retryable: operation.state === "sending" || operation.outcomeUnknown ? true : operation.retryable ?? (operation.error ? composerSubmissionCanRetry(new Error(operation.error)) : true),
     input: operation.input,
     canRetry: !hasMcpCredentialUpdates
   }));
 }
+function restoredCorrelationId(value) {
+  return typeof value === "string" && /^[\w.:-]{1,128}$/u.test(value) ? value : void 0;
+}
+function restoredErrorReference(reference, message) {
+  const correlationId = restoredCorrelationId(reference);
+  return message && correlationId && message !== COMPOSER_MODEL_UNAVAILABLE_MESSAGE ? `${message} Reference: ${correlationId}.` : message;
+}
 function rememberOptimisticSendOperations(key, operations) {
   if (!key) return;
   const stored = operations.filter((operation) => operation.state !== "queued").map((operation) => {
@@ -286,6 +306,7 @@ function reconcileOptimisticSendFromEvents(operation, events) {
 }
 function useComposer(sessionId, options = {}) {
   const { client, workspaceId, registerSessionReconciler } = useEmbeddedSession(options);
+  const formatError = useErrorMessage();
   const durableDrafts = options.draftPersistence !== "disabled";
   if (!durableDrafts && !options.initialPolicy) {
     throw new Error("useComposer requires initialPolicy when draft persistence is disabled");
@@ -648,7 +669,7 @@ function useComposer(sessionId, options = {}) {
           const problem = asError(cause);
           const timedOut = problem.name === "TimeoutError";
           setDraftReadError(
-            timedOut ? new Error("Draft sync timed out. Retrying\u2026", { cause }) : problem
+            timedOut ? new ComposerStateError("Draft sync timed out. Retrying\u2026", { cause }) : problem
           );
           if (timedOut || cause instanceof TypeError || cause && typeof cause === "object" && "retryable" in cause && cause.retryable === true) {
             retry.failures += 1;
@@ -913,18 +934,23 @@ function useComposer(sessionId, options = {}) {
     optimisticProcessorBusyRef.current = true;
     void (async () => {
       let mutationFailureObserved = false;
-      const markFailed = (problem, outcomeUnknown) => {
+      const markFailed = (cause, outcomeUnknown) => {
         if (targetKeyRef.current !== ownedTargetKey || targetGeneration.current !== ownedGeneration) {
           return;
         }
+        const problem = asError(cause);
         replaceOptimisticSends(
           (current) => current.map(
             (candidate) => candidate.clientEventId === operation.clientEventId ? {
               ...candidate,
               state: "failed",
-              error: outcomeUnknown ? problem.message : composerSubmissionErrorMessage(problem),
+              error: formatError(
+                cause,
+                outcomeUnknown && !isOutcomeUnknownError(problem) && !(problem instanceof ComposerReconciliationRequiredError) ? `The request could not be confirmed. Check its status before retrying.${problem instanceof OpenGeniApiError && problem.correlationId ? ` Reference: ${problem.correlationId}.` : ""}` : composerSubmissionErrorMessage(problem)
+              ),
               retryable: outcomeUnknown || composerSubmissionCanRetry(problem),
-              outcomeUnknown
+              outcomeUnknown,
+              correlationId: problem instanceof OpenGeniApiError ? problem.correlationId : candidate.correlationId
             } : candidate
           )
         );
@@ -947,7 +973,7 @@ function useComposer(sessionId, options = {}) {
               payloadMode: "full"
             });
           } catch (cause) {
-            markFailed(asError(cause), true);
+            markFailed(cause, true);
             return;
           }
           const reconciled = reconcileOptimisticSendFromEvents(operation, events);
@@ -969,15 +995,13 @@ function useComposer(sessionId, options = {}) {
             return;
           }
           if (!operation.canRetry) {
-            throw new Error(
-              "Opengeni cannot safely retry this uncertain request after remount; reconcile the session before sending again."
-            );
+            throw new ComposerReconciliationRequiredError();
           }
         }
         let expectedDraftRevision;
         if (durableDrafts && operation.draftPayload) {
           if (!await persistPayload(operation.draftPayload)) {
-            throw new Error("The message draft could not be saved before delivery.");
+            throw new ComposerStateError("The message draft could not be saved before delivery.");
           }
           expectedDraftRevision = draftRef.current?.revision;
         }
@@ -992,7 +1016,7 @@ function useComposer(sessionId, options = {}) {
         let acceptedEvent = null;
         if (durableDrafts) {
           if (!operation.draftPayload || expectedDraftRevision === void 0) {
-            throw new Error("The durable composer draft is not ready for delivery.");
+            throw new ComposerStateError("The durable composer draft is not ready for delivery.");
           }
           const result = await client.submitComposerDraft(workspaceId, sessionId, {
             text: operation.draftPayload.text,
@@ -1058,7 +1082,7 @@ function useComposer(sessionId, options = {}) {
         const problem = asError(cause);
         onDeliveryErrorRef.current?.(problem, operation.input, "send");
         const outcomeUnknown = operation.outcomeUnknown && !mutationFailureObserved ? true : isOutcomeUnknownError(cause);
-        markFailed(problem, outcomeUnknown);
+        markFailed(cause, outcomeUnknown);
       } finally {
         optimisticProcessorBusyRef.current = false;
         if (targetKeyRef.current === ownedTargetKey) {
@@ -1070,6 +1094,7 @@ function useComposer(sessionId, options = {}) {
     adoptDraftBase,
     client,
     durableDrafts,
+    formatError,
     markOptimisticAccepted,
     loadDraft,
     onSent,
@@ -1194,7 +1219,7 @@ function useComposer(sessionId, options = {}) {
         if (durableDrafts) {
           const input = operation.input;
           if (input.expectedDraftRevision === void 0 || input.clientEventId === void 0 || input.model === void 0 || input.reasoningEffort === void 0 || input.latencyMode === void 0) {
-            throw new Error("The durable composer draft is not ready for delivery.");
+            throw new ComposerStateError("The durable composer draft is not ready for delivery.");
           }
           const result = await client.submitComposerDraft(workspaceId, sessionId, {
             text: input.text,
@@ -1285,11 +1310,7 @@ function useComposer(sessionId, options = {}) {
             return true;
           }
           if (!pending.canRetry) {
-            setError(
-              new Error(
-                "Opengeni cannot safely retry this uncertain request after remount; reconcile the session before sending again."
-              )
-            );
+            setError(new ComposerReconciliationRequiredError());
             return false;
           }
           try {
@@ -1613,7 +1634,7 @@ function useComposer(sessionId, options = {}) {
         }
       } catch (cause) {
         if (targetKeyRef.current === ownedTargetKey && targetGeneration.current === ownedGeneration) {
-          setError(cause instanceof Error ? cause : new Error(String(cause)));
+          setError(normalizeError(cause));
         }
       } finally {
         if (targetKeyRef.current === ownedTargetKey && targetGeneration.current === ownedGeneration) {
@@ -1645,7 +1666,7 @@ function useComposer(sessionId, options = {}) {
         }
       } catch (cause) {
         if (targetKeyRef.current === ownedTargetKey && targetGeneration.current === ownedGeneration) {
-          setError(cause instanceof Error ? cause : new Error(String(cause)));
+          setError(normalizeError(cause));
         }
       } finally {
         if (targetKeyRef.current === ownedTargetKey && targetGeneration.current === ownedGeneration) {
@@ -1668,9 +1689,7 @@ function useComposer(sessionId, options = {}) {
             (blocker) => blocker.kind === "workspace"
           );
           if (!client.setWorkspaceInferenceState) {
-            throw new Error(
-              "@opengeni/react: workspace-scoped resume requires setWorkspaceInferenceState."
-            );
+            throw new ComposerWorkspaceControlUnavailableError();
           }
           const clientEventId = generateClientEventId();
           await replayOutcomeUnknown(
@@ -1783,7 +1802,7 @@ function useComposer(sessionId, options = {}) {
   const addAnnotation = useCallback(
     (annotation) => {
       if (annotationsRef.current.length >= 12) {
-        setError(new Error("A message can include at most 12 timeline annotations."));
+        setError(new ComposerStateError("A message can include at most 12 timeline annotations."));
         return;
       }
       const next = [...annotationsRef.current, annotation];
@@ -2070,7 +2089,7 @@ async function replayOutcomeUnknown(command) {
   }
 }
 function asError(cause) {
-  return cause instanceof Error ? cause : new Error(String(cause));
+  return normalizeError(cause);
 }
 function promptRoutingFromAcceptedEvent(event) {
   if (typeof event?.payload !== "object" || event.payload === null || Array.isArray(event.payload)) {
@@ -2133,4 +2152,4 @@ export {
   shouldSubmitOnKey,
   shouldSteerOnKey
 };
-//# sourceMappingURL=chunk-DV2DBNPQ.js.map
+//# sourceMappingURL=chunk-Q5QBEZIQ.js.map