@opengeni/react 5.0.5-canary.2 → 5.1.0-canary.0

package/dist/components/message-timeline.d.ts

@@ -2,8 +2,11 @@ import { type GenieLoadingOptions } from "../timeline/genie-loading.js";
 import type { DraftTimelineAnnotation, SessionEvent, SessionStatus } from "@opengeni/sdk";
 import { type ReactNode } from "react";
 import { type OlderHistoryLoader } from "../older-history.js";
+import { type UserMessageDisclosureLabels } from "./user-message-body.js";
 import { type AgentMessageItem, type AuthNeededItem, type TimelineGroup, type TimelineItem, type RetainedArtifactLoader, type RetainedScreenshotLoader, type VideoArtifactPlaybackLoader, type ToolRegistry, type TurnSummaryOptions, type UserMessageItem } from "../timeline/index.js";
 export type MessageTimelineProps = {
+    /** Localized user-message disclosure actions, including custom UserMessageBody renderers. */
+    userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
     /** Raw session events (projected internally) … */
     events?: SessionEvent[] | undefined;
     /** … or pre-projected items (e.g. from `useSessionEvents().timeline`). */
@@ -113,7 +116,7 @@ export type MessageTimelineProps = {
  * cards, goal markers, and status transitions. Owns stick-to-bottom scrolling
  * with a "jump to latest" affordance when the reader scrolls back.
  */
-export declare function MessageTimeline({ events, items, status: _status, renderMessageActions, renderMessageText, onOpenSession, onMemoryClick, onReconnect, renderAuthNeeded, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, genieLoading, turnSummary, autoFollow, onAnnotate, draftAnnotations, onDraftAnnotationSelect, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
+export declare function MessageTimeline({ userMessageDisclosureLabels, events, items, status: _status, renderMessageActions, renderMessageText, onOpenSession, onMemoryClick, onReconnect, renderAuthNeeded, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, genieLoading, turnSummary, autoFollow, onAnnotate, draftAnnotations, onDraftAnnotationSelect, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
 /**
  * Settled turns lift the final agent answer out as a sibling group. Include it
  * in "Copy turn" when present so the chip copies the full assistant reply.

package/dist/components/session-conversation.d.ts

@@ -2,8 +2,11 @@ import { type CSSProperties } from "react";
 import { type ClientOverride } from "../session-context.js";
 import { type ChatComposerProps } from "./chat-composer.js";
 import { type HumanInputSurfaceProps } from "./human-input-surface.js";
+import type { UserMessageDisclosureLabels } from "./user-message-body.js";
 export type SessionConversationProps = ClientOverride & {
     sessionId: string;
+    /** Localized actions for already-sent user-message disclosure. */
+    userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
     loadSkillReview?: HumanInputSurfaceProps["loadSkillReview"];
     className?: string;
     /** Defaults to filling the host. The host owns available height. */

package/dist/components/user-message-body.d.ts

@@ -1,6 +1,13 @@
 import { type ReactNode } from "react";
 type RestoreDisclosureAnchor = (() => void) | null;
+export type UserMessageDisclosureLabels = {
+    /** Collapsed disclosure action. Defaults to "Show more". */
+    showMore?: string | undefined;
+    /** Expanded disclosure action. Defaults to "Show less". */
+    showLess?: string | undefined;
+};
 export type UserMessageDisclosureContextValue = {
+    labels?: UserMessageDisclosureLabels | undefined;
     expandedByMessageId: Map<string, boolean>;
     beginChange: (messageBody: HTMLElement, disclosureControl: HTMLElement) => RestoreDisclosureAnchor;
 };
@@ -21,6 +28,8 @@ export type UserMessageBodyProps = {
     text: string;
     children: ReactNode;
     className?: string | undefined;
+    /** Per-field overrides for timeline labels, then the English defaults. */
+    disclosureLabels?: UserMessageDisclosureLabels | undefined;
 };
 /**
  * Lossless disclosure boundary for already-sent user-message text.
@@ -32,5 +41,5 @@ export type UserMessageBodyProps = {
  * remembers expansion per durable message id and preserves the reader's scroll
  * anchor when height changes.
  */
-export declare function UserMessageBody({ messageId, text, children, className }: UserMessageBodyProps): import("react").JSX.Element;
+export declare function UserMessageBody({ messageId, text, children, className, disclosureLabels, }: UserMessageBodyProps): import("react").JSX.Element;
 export {};

package/dist/composer.js

@@ -40,7 +40,7 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-V3WX3TQG.js";
+} from "./chunk-45XEUVTK.js";
 import "./chunk-HQV2I5HV.js";
 import {
   BillingClassMark,
@@ -51,7 +51,7 @@ import {
   defaultModelPolicyPickerMessages
 } from "./chunk-R4KRSFGA.js";
 import "./chunk-VZTQ73XT.js";
-import "./chunk-6J56T3MG.js";
+import "./chunk-NYESIADM.js";
 import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import "./chunk-NEXLLTP4.js";

package/dist/index.d.ts

@@ -131,7 +131,7 @@ export { GeneratedVideoPlayer } from "./components/generated-video-player.js";
 export type { GeneratedVideoPlayerProps } from "./components/generated-video-player.js";
 export type { MessageTimelineProps } from "./components/message-timeline.js";
 export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body.js";
-export type { UserMessageBodyProps } from "./components/user-message-body.js";
+export type { UserMessageBodyProps, UserMessageDisclosureLabels, } from "./components/user-message-body.js";
 export { Markdown, sandboxFileLocationFromHref, sandboxFilePathFromHref, } from "./components/markdown.js";
 export type { MarkdownProps, SandboxFileLocation } from "./components/markdown.js";
 export { CopyButton, CopyHoverFrame } from "./components/copy-button.js";

package/dist/index.js

@@ -104,7 +104,7 @@ import {
   useWorkspaceModelCatalog,
   userMessageLikelyNeedsDisclosure,
   v4aToGitFileDiff
-} from "./chunk-H63SQTGI.js";
+} from "./chunk-WS6D5BHH.js";
 import "./chunk-YBM6CQRU.js";
 import "./chunk-5M6VTFJ5.js";
 import "./chunk-ZYRGEKWS.js";
@@ -159,7 +159,7 @@ import {
   useSlashCommands,
   useTranscription,
   useVoiceInput
-} from "./chunk-V3WX3TQG.js";
+} from "./chunk-45XEUVTK.js";
 import {
   Tooltip,
   TooltipContent,
@@ -220,7 +220,7 @@ import {
   shouldSteerOnKey,
   shouldSubmitOnKey,
   useComposer
-} from "./chunk-6J56T3MG.js";
+} from "./chunk-NYESIADM.js";
 import {
   COMPOSER_PAYMENT_REQUIRED_MESSAGE,
   CREDIT_EXHAUSTION_MESSAGE,

package/dist/session-ui.d.ts

@@ -9,7 +9,7 @@ export type { MessageTimelineProps } from "./components/message-timeline.js";
 export { createOlderHistoryLoadReceipt } from "./older-history.js";
 export type { OlderHistoryLoader, OlderHistoryLoadReceipt } from "./older-history.js";
 export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body.js";
-export type { UserMessageBodyProps } from "./components/user-message-body.js";
+export type { UserMessageBodyProps, UserMessageDisclosureLabels, } from "./components/user-message-body.js";
 export { BUILT_IN_TURN_SUMMARY_FACET_IDS } from "./timeline/turn-summary.js";
 export type { BuiltInTurnSummaryFacetId, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, } from "./timeline/turn-summary.js";
 export { QueueSurface } from "./components/queue-surface.js";

package/dist/session-ui.js

@@ -16,7 +16,7 @@ import {
   setStartupDetails,
   useStartupDetails,
   userMessageLikelyNeedsDisclosure
-} from "./chunk-H63SQTGI.js";
+} from "./chunk-WS6D5BHH.js";
 import "./chunk-YBM6CQRU.js";
 import "./chunk-5M6VTFJ5.js";
 import "./chunk-ZYRGEKWS.js";
@@ -24,14 +24,14 @@ import "./chunk-NOSYBS2D.js";
 import "./chunk-PAJU5KKL.js";
 import "./chunk-M2HNWZYR.js";
 import "./chunk-JVYQRRC4.js";
-import "./chunk-V3WX3TQG.js";
+import "./chunk-45XEUVTK.js";
 import "./chunk-HQV2I5HV.js";
 import "./chunk-R4KRSFGA.js";
 import "./chunk-VZTQ73XT.js";
 import {
   createOlderHistoryLoadReceipt
 } from "./chunk-HUMIRRYI.js";
-import "./chunk-6J56T3MG.js";
+import "./chunk-NYESIADM.js";
 import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import "./chunk-NEXLLTP4.js";

package/dist/session.js

@@ -35,7 +35,7 @@ import {
   shouldSteerOnKey,
   shouldSubmitOnKey,
   useComposer
-} from "./chunk-6J56T3MG.js";
+} from "./chunk-NYESIADM.js";
 import "./chunk-PLYRL5ER.js";
 import "./chunk-KZ73RL76.js";
 import "./chunk-NEXLLTP4.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/react",
-  "version": "5.0.5-canary.2",
+  "version": "5.1.0-canary.0",
   "description": "React hooks and styled components for OpenGeni: live session streaming, chat composer, message timeline, session status, and fleet views — token-themed (CSS variables), dark-first, built on Tailwind v4 + Radix + Motion.",
   "license": "Apache-2.0",
   "repository": {
@@ -133,8 +133,8 @@
     "@dnd-kit/utilities": "3.2.2",
     "@fontsource-variable/noto-sans-arabic": "5.2.10",
     "@fontsource-variable/noto-sans-jp": "5.2.10",
-    "@opengeni/connect": "^0.2.0-canary.4",
-    "@opengeni/sdk": "^5.0.5-canary.2",
+    "@opengeni/connect": "^0.2.0-canary.6",
+    "@opengeni/sdk": "^5.1.0-canary.0",
     "clsx": "^2.1.1",
     "dequal": "2.0.3",
     "lucide-react": "^1.8.0",

package/src/components/message-timeline.tsx

@@ -62,6 +62,7 @@ import {
   UserMessageBody,
   UserMessageDisclosureProvider,
   type UserMessageDisclosureContextValue,
+  type UserMessageDisclosureLabels,
 } from "./user-message-body";
 import {
   createTipFollowState,
@@ -128,6 +129,8 @@ const TimelineAnnotationSelection = lazy(() => import("./timeline-annotation-sel
 const TimelineAnnotationMarkers = lazy(() => import("./timeline-annotation-markers"));
 
 export type MessageTimelineProps = {
+  /** Localized user-message disclosure actions, including custom UserMessageBody renderers. */
+  userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
   /** Raw session events (projected internally) … */
   events?: SessionEvent[] | undefined;
   /** … or pre-projected items (e.g. from `useSessionEvents().timeline`). */
@@ -404,6 +407,7 @@ function cssEscapeAttribute(value: string): string {
  * with a "jump to latest" affordance when the reader scrolls back.
  */
 export function MessageTimeline({
+  userMessageDisclosureLabels,
   events,
   items,
   status: _status,
@@ -919,8 +923,16 @@ export function MessageTimeline({
     () => ({
       expandedByMessageId: userMessageDisclosureMemoryRef.current,
       beginChange: beginUserMessageDisclosureChange,
+      labels: {
+        showMore: userMessageDisclosureLabels?.showMore,
+        showLess: userMessageDisclosureLabels?.showLess,
+      },
     }),
-    [beginUserMessageDisclosureChange],
+    [
+      beginUserMessageDisclosureChange,
+      userMessageDisclosureLabels?.showMore,
+      userMessageDisclosureLabels?.showLess,
+    ],
   );
   const timelineGroupEntryContext = useMemo<TimelineGroupEntryContext>(
     () => ({
@@ -2393,41 +2405,49 @@ const TimelineGroupEntry = memo(function TimelineGroupEntry({
           nextGroup.item.phase === "compacted"
         ? 1
         : 0;
+  const content = (
+    <TimelineGroupView
+      {...behavior}
+      group={group}
+      foldLiveCluster={isAgentProgress(nextGroup)}
+      startupDismissed={startupDismissed}
+      trailingAgentText={trailingAgentTextAfterTurn(group, nextGroup)}
+      contextCompactionCount={contextCompactionCount > 0 ? contextCompactionCount : undefined}
+    />
+  );
   return (
     <GenieLoadingOptionsContext.Provider value={behavior.genieLoading}>
       <div data-og-timeline-group-anchor="" data-og-group-key={groupKey}>
         <EntranceAnimationProvider value={entranceEnabled} liveValue={liveEntranceEnabled}>
           <TimelineGroupRenderBoundary resetKeys={[group, behavior]}>
             <UserMessageDisclosureProvider value={userMessageDisclosureContext}>
-              <AnimatePresence initial={false}>
-                <motion.div
-                  key={
-                    !startupDismissed &&
-                    group.kind === "activity" &&
-                    group.items.every(
-                      (item) =>
-                        item.kind === "startup-phase" ||
-                        (item.kind === "reasoning" && !item.text.trim()),
-                    )
-                      ? "preparation"
-                      : "content"
-                  }
-                  initial={false}
-                  exit={{ opacity: 0, height: 0 }}
-                  transition={{ duration: reducedMotion ? 0 : 0.2 }}
-                >
-                  <TimelineGroupView
-                    {...behavior}
-                    group={group}
-                    foldLiveCluster={isAgentProgress(nextGroup)}
-                    startupDismissed={startupDismissed}
-                    trailingAgentText={trailingAgentTextAfterTurn(group, nextGroup)}
-                    contextCompactionCount={
-                      contextCompactionCount > 0 ? contextCompactionCount : undefined
+              {/* Item groups never switch the preparation/content key. Keep their
+                  DOM shell without mounting inert presence and motion lifecycles
+                  for every historical message in a prepend. */}
+              {group.kind === "item" ? (
+                <div>{content}</div>
+              ) : (
+                <AnimatePresence initial={false}>
+                  <motion.div
+                    key={
+                      !startupDismissed &&
+                      group.kind === "activity" &&
+                      group.items.every(
+                        (item) =>
+                          item.kind === "startup-phase" ||
+                          (item.kind === "reasoning" && !item.text.trim()),
+                      )
+                        ? "preparation"
+                        : "content"
                     }
-                  />
-                </motion.div>
-              </AnimatePresence>
+                    initial={false}
+                    exit={{ opacity: 0, height: 0 }}
+                    transition={{ duration: reducedMotion ? 0 : 0.2 }}
+                  >
+                    {content}
+                  </motion.div>
+                </AnimatePresence>
+              )}
             </UserMessageDisclosureProvider>
           </TimelineGroupRenderBoundary>
         </EntranceAnimationProvider>

package/src/components/session-conversation.tsx

@@ -11,11 +11,14 @@ import { ChatComposer, type ChatComposerProps } from "./chat-composer";
 import { QueueSurface } from "./queue-surface";
 import { HumanInputSurface, type HumanInputSurfaceProps } from "./human-input-surface";
 import { MessageTimeline } from "./message-timeline";
+import type { UserMessageDisclosureLabels } from "./user-message-body";
 import { conversationTimeline } from "../conversation-timeline";
 import { cn } from "../lib/cn";
 
 export type SessionConversationProps = ClientOverride & {
   sessionId: string;
+  /** Localized actions for already-sent user-message disclosure. */
+  userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
   loadSkillReview?: HumanInputSurfaceProps["loadSkillReview"];
   className?: string;
   /** Defaults to filling the host. The host owns available height. */
@@ -32,6 +35,7 @@ export function SessionConversation(props: SessionConversationProps) {
 
 function Conversation({
   sessionId,
+  userMessageDisclosureLabels,
   loadSkillReview,
   client,
   workspaceId,
@@ -71,6 +75,7 @@ function Conversation({
     >
       {error && <p role="alert">{error.message}</p>}
       <MessageTimeline
+        userMessageDisclosureLabels={userMessageDisclosureLabels}
         className="min-h-0 flex-1"
         items={conversationTimeline(feed.timeline, queue, composer)}
         status={status}

package/src/components/user-message-body.tsx

@@ -190,7 +190,15 @@ function observeSharedResize(element: Element, callback: () => void): (() => voi
   };
 }
 
+export type UserMessageDisclosureLabels = {
+  /** Collapsed disclosure action. Defaults to "Show more". */
+  showMore?: string | undefined;
+  /** Expanded disclosure action. Defaults to "Show less". */
+  showLess?: string | undefined;
+};
+
 export type UserMessageDisclosureContextValue = {
+  labels?: UserMessageDisclosureLabels | undefined;
   expandedByMessageId: Map<string, boolean>;
   beginChange: (
     messageBody: HTMLElement,
@@ -235,6 +243,8 @@ export type UserMessageBodyProps = {
   text: string;
   children: ReactNode;
   className?: string | undefined;
+  /** Per-field overrides for timeline labels, then the English defaults. */
+  disclosureLabels?: UserMessageDisclosureLabels | undefined;
 };
 
 /**
@@ -247,7 +257,13 @@ export type UserMessageBodyProps = {
  * remembers expansion per durable message id and preserves the reader's scroll
  * anchor when height changes.
  */
-export function UserMessageBody({ messageId, text, children, className }: UserMessageBodyProps) {
+export function UserMessageBody({
+  messageId,
+  text,
+  children,
+  className,
+  disclosureLabels,
+}: UserMessageBodyProps) {
   const disclosure = useContext(UserMessageDisclosureContext);
   const [expanded, setExpanded] = useState(
     () => disclosure?.expandedByMessageId.get(messageId) ?? false,
@@ -454,7 +470,9 @@ export function UserMessageBody({ messageId, text, children, className }: UserMe
         className="mt-1.5 inline-flex min-h-7 items-center rounded-og-sm px-1.5 text-og-xs font-medium text-og-fg-muted outline-hidden transition-colors hover:bg-og-surface-3/60 hover:text-og-fg focus-visible:ring-2 focus-visible:ring-og-accent/45 pointer-coarse:min-h-11"
         onClick={(event) => toggle(event.currentTarget)}
       >
-        {expanded ? "Show less" : "Show more"}
+        {expanded
+          ? (disclosureLabels?.showLess ?? disclosure?.labels?.showLess ?? "Show less")
+          : (disclosureLabels?.showMore ?? disclosure?.labels?.showMore ?? "Show more")}
       </button>
     </div>
   );

package/src/hooks/use-composer.ts

@@ -677,6 +677,8 @@ export function useComposer(
   const [acceptedControl, setAcceptedControl] = useState<EffectiveSessionControl | null>(null);
   const [resuming, setResuming] = useState(false);
   const [error, setError] = useState<Error | null>(null);
+  // Background draft reads recover independently of Send/Steer/control failures.
+  const [draftReadError, setDraftReadError] = useState<Error | null>(null);
   const [draft, setDraft] = useState<ComposerDraft | null>(null);
   const [draftLoading, setDraftLoading] = useState(Boolean(sessionId) && durableDrafts);
   const [draftSaving, setDraftSaving] = useState(false);
@@ -794,6 +796,7 @@ export function useComposer(
     setAcceptedControl(null);
     setResuming(false);
     setError(null);
+    setDraftReadError(null);
     setDraft(null);
     setDraftLoading(Boolean(sessionId) && durableDrafts);
     setDraftSaving(false);
@@ -920,6 +923,7 @@ export function useComposer(
       if (targetKeyRef.current !== targetKey) return;
       if (!sessionId || !durableDrafts) {
         setDraftLoading(false);
+        setDraftReadError(null);
         return;
       }
       let retry = draftReadRetryRef.current;
@@ -993,6 +997,8 @@ export function useComposer(
         if (retry.timer !== null) clearTimeout(retry.timer);
         retry.failures = 0;
         retry.timer = null;
+        // Recovery also counts when the server returns the same draft revision.
+        setDraftReadError(null);
         const currentRevision = draftRef.current?.revision ?? -1;
         // Reconnect and client-generation effects can legitimately ask for the
         // draft again. A same-revision response is not new authority: publishing
@@ -1045,12 +1051,18 @@ export function useComposer(
         }
       } catch (cause) {
         if (
+          !requestAbort.signal.aborted &&
           generation === targetGeneration.current &&
           targetKeyRef.current === targetKey &&
           readTicket === draftReadGeneration.current
         ) {
-          setError(asError(cause));
+          const problem = asError(cause);
+          const timedOut = problem.name === "TimeoutError";
+          setDraftReadError(
+            timedOut ? new Error("Draft sync timed out. Retrying…", { cause }) : problem,
+          );
           if (
+            timedOut ||
             cause instanceof TypeError ||
             (cause && typeof cause === "object" && "retryable" in cause && cause.retryable === true)
           ) {
@@ -2639,6 +2651,7 @@ export function useComposer(
   const clearError = useCallback(() => {
     if (targetKeyRef.current !== targetKey) return;
     setError(null);
+    setDraftReadError(null);
     setDraftConflict(null);
   }, [targetKey]);
   // `valueRef` is the synchronous composer authority. React state exists to
@@ -2706,7 +2719,7 @@ export function useComposer(
     resolveDraftConflict,
     restoredResources: identityMatches ? restoredResources : [],
     removeRestoredResource,
-    error: identityMatches ? error : null,
+    error: identityMatches ? (error ?? draftReadError) : null,
     clearError,
   };
 }

package/src/index.ts

@@ -511,7 +511,10 @@ export { GeneratedVideoPlayer } from "./components/generated-video-player";
 export type { GeneratedVideoPlayerProps } from "./components/generated-video-player";
 export type { MessageTimelineProps } from "./components/message-timeline";
 export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body";
-export type { UserMessageBodyProps } from "./components/user-message-body";
+export type {
+  UserMessageBodyProps,
+  UserMessageDisclosureLabels,
+} from "./components/user-message-body";
 export {
   Markdown,
   sandboxFileLocationFromHref,

package/src/session-ui.ts

@@ -16,7 +16,10 @@ export type { MessageTimelineProps } from "./components/message-timeline";
 export { createOlderHistoryLoadReceipt } from "./older-history";
 export type { OlderHistoryLoader, OlderHistoryLoadReceipt } from "./older-history";
 export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body";
-export type { UserMessageBodyProps } from "./components/user-message-body";
+export type {
+  UserMessageBodyProps,
+  UserMessageDisclosureLabels,
+} from "./components/user-message-body";
 export { BUILT_IN_TURN_SUMMARY_FACET_IDS } from "./timeline/turn-summary";
 export type {
   BuiltInTurnSummaryFacetId,