@opengeni/react 3.3.2 → 3.4.1-canary.38960406141001

package/dist/{chunk-IOLVN74D.js → chunk-V5ZUJT2T.js}

@@ -1,15 +1,54 @@
+"use client";
 import {
   useSessionEventTrigger
-} from "./chunk-KZ73RL76.js";
+} from "./chunk-QHUE7E4N.js";
+import {
+  normalizeError,
+  useErrorMessage
+} from "./chunk-CM7LVUKC.js";
 import {
   useEmbeddedSession
-} from "./chunk-NEXLLTP4.js";
+} from "./chunk-G76LSA76.js";
+import {
+  COMPOSER_MODEL_UNAVAILABLE_MESSAGE,
+  ComposerReconciliationRequiredError,
+  ComposerStateError,
+  ComposerWorkspaceControlUnavailableError,
+  composerSubmissionCanRetry,
+  composerSubmissionErrorMessage
+} from "./chunk-BLL56F7R.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";
+
+// src/lib/notify-observer.ts
+function notifyObserver(observer, ...args) {
+  const report = (cause) => globalThis.reportError?.(cause);
+  try {
+    const result = observer?.(...args);
+    if (result && typeof result.then === "function") {
+      void Promise.resolve(result).catch(report);
+    }
+  } catch (cause) {
+    report(cause);
+  }
+}
+
+// src/hooks/use-composer.ts
+function initialComposerShadow(seed) {
+  if (!seed || !seed.text && !seed.resources?.length && !seed.annotations?.length && !seed.policy)
+    return void 0;
+  return {
+    text: seed.text,
+    resources: [...seed.resources ?? []],
+    annotations: cloneAnnotations(seed.annotations ?? []),
+    ...seed.policy ? { policy: { ...seed.policy } } : {}
+  };
+}
 var PENDING_COMPOSER_STORAGE_PREFIX = "opengeni.pending-composer.v1:";
 var OPTIMISTIC_SEND_STORAGE_PREFIX = "opengeni.optimistic-sends.v1:";
 var pendingComposerOperations = /* @__PURE__ */ new Map();
@@ -51,11 +90,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,
+    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) => {
@@ -281,6 +332,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");
@@ -289,7 +341,7 @@ function useComposer(sessionId, options = {}) {
   const pendingOperationKey = pendingComposerOperationKey(workspaceId, sessionId);
   const initialPendingOperation = restorePendingComposerOperation(pendingOperationKey);
   const initialOptimisticSends = restoreOptimisticSendOperations(pendingOperationKey);
-  const initialShadow = initialPendingOperation?.newerShadow ?? initialOptimisticSends.at(-1)?.newerShadow;
+  const initialShadow = initialPendingOperation?.newerShadow ?? initialOptimisticSends.at(-1)?.newerShadow ?? initialComposerShadow(options.initialDraft);
   const [value, setValue] = useState(() => initialShadow?.text ?? "");
   const [annotations, setAnnotations] = useState(
     () => initialShadow?.annotations ?? []
@@ -313,6 +365,7 @@ function useComposer(sessionId, options = {}) {
   const [acceptedControl, setAcceptedControl] = useState(null);
   const [resuming, setResuming] = useState(false);
   const [error, setError] = useState(null);
+  const [draftReadError, setDraftReadError] = useState(null);
   const [draft, setDraft] = useState(null);
   const [draftLoading, setDraftLoading] = useState(Boolean(sessionId) && durableDrafts);
   const [draftSaving, setDraftSaving] = useState(false);
@@ -348,8 +401,18 @@ function useComposer(sessionId, options = {}) {
   const draftReadRetryRef = useRef({ targetKey, failures: 0, timer: null });
   const lastSavedSignature = useRef(null);
   const saveChain = useRef(Promise.resolve());
-  const onSent = options.onSent;
-  const onSubmitted = options.onSubmitted;
+  const onSent = useCallback(
+    (text, input) => {
+      notifyObserver(options.onSent, text, input);
+    },
+    [options.onSent]
+  );
+  const onSubmitted = useCallback(
+    (text, input) => {
+      notifyObserver(options.onSubmitted, text, input);
+    },
+    [options.onSubmitted]
+  );
   const onDeliveryErrorRef = useRef(options.onDeliveryError);
   onDeliveryErrorRef.current = options.onDeliveryError;
   useLayoutEffect(() => {
@@ -385,7 +448,7 @@ function useComposer(sessionId, options = {}) {
     optimisticCallbackIdsRef.current = /* @__PURE__ */ new Set();
     steeringSettlementEventsRef.current = [];
     pendingClientEventId.current = pendingOperationRef.current?.input.clientEventId ?? null;
-    const shadow = pendingOperationRef.current?.newerShadow ?? restoredOptimisticSends.at(-1)?.newerShadow;
+    const shadow = pendingOperationRef.current?.newerShadow ?? restoredOptimisticSends.at(-1)?.newerShadow ?? initialComposerShadow(options.initialDraft);
     localEditRevision.current = shadow ? 1 : 0;
     valueRef.current = shadow?.text ?? "";
     annotationsRef.current = shadow?.annotations ?? [];
@@ -416,12 +479,20 @@ function useComposer(sessionId, options = {}) {
     setAcceptedControl(null);
     setResuming(false);
     setError(null);
+    setDraftReadError(null);
     setDraft(null);
     setDraftLoading(Boolean(sessionId) && durableDrafts);
     setDraftSaving(false);
     setDraftConflict(null);
     setRestoredResources(shadow?.resources ?? []);
-  }, [durableDrafts, options.initialPolicy, pendingOperationKey, sessionId, targetKey]);
+  }, [
+    durableDrafts,
+    options.initialPolicy,
+    options.initialDraft,
+    pendingOperationKey,
+    sessionId,
+    targetKey
+  ]);
   useEffect(
     () => () => {
       if (draftReadRetryRef.current.timer !== null) {
@@ -539,6 +610,7 @@ function useComposer(sessionId, options = {}) {
       if (targetKeyRef.current !== targetKey) return;
       if (!sessionId || !durableDrafts) {
         setDraftLoading(false);
+        setDraftReadError(null);
         return;
       }
       let retry = draftReadRetryRef.current;
@@ -598,6 +670,7 @@ function useComposer(sessionId, options = {}) {
         if (retry.timer !== null) clearTimeout(retry.timer);
         retry.failures = 0;
         retry.timer = null;
+        setDraftReadError(null);
         const currentRevision = draftRef.current?.revision ?? -1;
         if (replaceLocal || fetched.revision > currentRevision) {
           draftRef.current = fetched;
@@ -635,9 +708,13 @@ function useComposer(sessionId, options = {}) {
           }
         }
       } catch (cause) {
-        if (generation === targetGeneration.current && targetKeyRef.current === targetKey && readTicket === draftReadGeneration.current) {
-          setError(asError(cause));
-          if (cause instanceof TypeError || cause && typeof cause === "object" && "retryable" in cause && cause.retryable === true) {
+        if (!requestAbort.signal.aborted && generation === targetGeneration.current && targetKeyRef.current === targetKey && readTicket === draftReadGeneration.current) {
+          const problem = asError(cause);
+          const timedOut = problem.name === "TimeoutError";
+          setDraftReadError(
+            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;
             scheduleRetry();
           } else {
@@ -900,17 +977,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: problem.message,
-              outcomeUnknown
+              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,
+              correlationId: problem instanceof OpenGeniApiError ? problem.correlationId : candidate.correlationId
             } : candidate
           )
         );
@@ -933,7 +1016,7 @@ function useComposer(sessionId, options = {}) {
               payloadMode: "full"
             });
           } catch (cause) {
-            markFailed(asError(cause), true);
+            markFailed(cause, true);
             return;
           }
           const reconciled = reconcileOptimisticSendFromEvents(operation, events);
@@ -955,15 +1038,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;
         }
@@ -978,7 +1059,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,
@@ -993,7 +1074,7 @@ function useComposer(sessionId, options = {}) {
             ...wireInput.controlEtag ? { controlEtag: wireInput.controlEtag } : {},
             ...wireInput.modelContext ? { modelContext: wireInput.modelContext } : {},
             ...wireInput.mcpCredentialUpdates ? { mcpCredentialUpdates: wireInput.mcpCredentialUpdates } : {},
-            ...wireInput.connectionAuthorities ? { connectionAuthorities: wireInput.connectionAuthorities } : {},
+            ...wireInput.connectionAccounts ? { connectionAccounts: wireInput.connectionAccounts } : {},
             ...wireInput.personalResourceAttachment ? { personalResourceAttachment: wireInput.personalResourceAttachment } : {}
           }).catch((cause) => {
             mutationFailureObserved = true;
@@ -1042,9 +1123,9 @@ function useComposer(sessionId, options = {}) {
           return;
         }
         const problem = asError(cause);
-        onDeliveryErrorRef.current?.(problem, operation.input, "send");
+        notifyObserver(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) {
@@ -1056,6 +1137,7 @@ function useComposer(sessionId, options = {}) {
     adoptDraftBase,
     client,
     durableDrafts,
+    formatError,
     markOptimisticAccepted,
     loadDraft,
     onSent,
@@ -1180,7 +1262,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,
@@ -1195,7 +1277,7 @@ function useComposer(sessionId, options = {}) {
             ...input.controlEtag ? { controlEtag: input.controlEtag } : {},
             ...input.modelContext ? { modelContext: input.modelContext } : {},
             ...input.mcpCredentialUpdates ? { mcpCredentialUpdates: input.mcpCredentialUpdates } : {},
-            ...input.connectionAuthorities ? { connectionAuthorities: input.connectionAuthorities } : {},
+            ...input.connectionAccounts ? { connectionAccounts: input.connectionAccounts } : {},
             ...input.personalResourceAttachment ? { personalResourceAttachment: input.personalResourceAttachment } : {}
           });
           adoptDraftBase(result.draft);
@@ -1271,11 +1353,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 {
@@ -1294,7 +1372,12 @@ function useComposer(sessionId, options = {}) {
           } catch (cause) {
             const problem = asError(cause);
             const outcomeUnknown = isOutcomeUnknownError(cause);
-            onDeliveryErrorRef.current?.(problem, pending.input, pending.delivery);
+            notifyObserver(
+              onDeliveryErrorRef.current,
+              problem,
+              pending.input,
+              pending.delivery
+            );
             if (!outcomeUnknown) {
               clearPending();
               keepSteering = false;
@@ -1377,7 +1460,12 @@ function useComposer(sessionId, options = {}) {
             });
           }
         } catch (cause) {
-          onDeliveryErrorRef.current?.(asError(cause), operation.input, operation.delivery);
+          notifyObserver(
+            onDeliveryErrorRef.current,
+            asError(cause),
+            operation.input,
+            operation.delivery
+          );
           if (!isOutcomeUnknownError(cause)) {
             clearPending();
           } else if (delivery === "steer") {
@@ -1520,6 +1608,7 @@ function useComposer(sessionId, options = {}) {
           if (operation.outcomeUnknown) {
             return { ...operation, state: "sending", error: void 0 };
           }
+          if (operation.retryable === false) return operation;
           const nextClientEventId = generateClientEventId();
           const currentPersonalResourceAttachment = resolveSendExtras(
             sendExtrasRef.current
@@ -1545,6 +1634,7 @@ function useComposer(sessionId, options = {}) {
             occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
             state: "sending",
             error: void 0,
+            retryable: void 0,
             outcomeUnknown: false,
             canRetry: true
           };
@@ -1597,7 +1687,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) {
@@ -1629,7 +1719,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) {
@@ -1652,9 +1742,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(
@@ -1767,7 +1855,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];
@@ -1794,6 +1882,19 @@ function useComposer(sessionId, options = {}) {
   const clearAnnotationReviewTarget = useCallback(() => {
     setAnnotationReviewTargetId(null);
   }, []);
+  const requestAnnotationReview = useCallback((id) => {
+    const current = annotationsRef.current;
+    if (current.length === 0) {
+      setAnnotationReviewTargetId(null);
+      return;
+    }
+    if (id && current.some((annotation) => annotation.id === id)) {
+      setAnnotationReviewTargetId(id);
+      return;
+    }
+    const incomplete = current.find((annotation) => annotation.note.trim().length === 0);
+    setAnnotationReviewTargetId(incomplete?.id ?? current[0].id);
+  }, []);
   const updatePolicy = useCallback(
     (next) => {
       if (targetKeyRef.current !== targetKey) return;
@@ -1870,6 +1971,34 @@ function useComposer(sessionId, options = {}) {
     const extras = resolveSendExtras(sendExtrasRef.current);
     return valueRef.current.length > 0 || annotationsRef.current.length > 0 || restoredResourcesRef.current.length > 0 || (extras.resources?.length ?? 0) > 0 || current?.sourceTurnId !== null && current?.sourceTurnId !== void 0;
   }, []);
+  const restoreOptimisticMessage = useCallback(
+    (clientEventId) => {
+      if (targetKeyRef.current !== targetKey || draftLoading || pendingOperationRef.current || hasDraftContent())
+        return;
+      const operation = optimisticSendsRef.current.find(
+        (candidate) => candidate.clientEventId === clientEventId
+      );
+      if (!operation || operation.state !== "failed" || operation.outcomeUnknown) return;
+      localEditRevision.current += 1;
+      valueRef.current = operation.text;
+      restoredResourcesRef.current = [...operation.resources];
+      annotationsRef.current = cloneAnnotations(operation.annotations);
+      setValue(operation.text);
+      setRestoredResources(restoredResourcesRef.current);
+      setAnnotations(annotationsRef.current);
+      setError(null);
+      setOptimisticDraftShadow({
+        text: operation.text,
+        resources: restoredResourcesRef.current,
+        annotations: annotationsRef.current,
+        policy: policyRef.current ?? void 0
+      });
+      replaceOptimisticSends(
+        (current) => current.filter((candidate) => candidate.clientEventId !== clientEventId)
+      );
+    },
+    [draftLoading, hasDraftContent, replaceOptimisticSends, setOptimisticDraftShadow, targetKey]
+  );
   const resolveDraftConflict = useCallback(
     async (choice) => {
       const ownedTargetKey = targetKey;
@@ -1929,6 +2058,7 @@ function useComposer(sessionId, options = {}) {
   const clearError = useCallback(() => {
     if (targetKeyRef.current !== targetKey) return;
     setError(null);
+    setDraftReadError(null);
     setDraftConflict(null);
   }, [targetKey]);
   const visibleValue = identityMatches ? valueRef.current : "";
@@ -1941,10 +2071,12 @@ function useComposer(sessionId, options = {}) {
     removeAnnotation,
     annotationReviewTargetId: identityMatches ? annotationReviewTargetId : null,
     clearAnnotationReviewTarget,
+    requestAnnotationReview,
     hasDraftContent,
     send,
     optimisticMessages: visibleOptimisticMessages,
     retryOptimisticMessage,
+    restoreOptimisticMessage: !draftLoading && !pendingOperationRef.current && !hasDraftContent() ? restoreOptimisticMessage : void 0,
     removeOptimisticMessage,
     steer,
     steering: visibleSteering,
@@ -1972,7 +2104,7 @@ function useComposer(sessionId, options = {}) {
     resolveDraftConflict,
     restoredResources: identityMatches ? restoredResources : [],
     removeRestoredResource,
-    error: identityMatches ? error : null,
+    error: identityMatches ? error ?? draftReadError : null,
     clearError
   };
 }
@@ -2010,7 +2142,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)) {
@@ -2067,10 +2199,11 @@ function mergeResources(base, additions) {
 }
 
 export {
+  notifyObserver,
   useComposer,
   FILE_ONLY_MESSAGE_TEXT,
   composeSendInput,
   shouldSubmitOnKey,
   shouldSteerOnKey
 };
-//# sourceMappingURL=chunk-IOLVN74D.js.map
+//# sourceMappingURL=chunk-V5ZUJT2T.js.map