@opengeni/react 2.3.0-canary.0 → 2.5.0-canary.1

package/dist/components/composer.d.ts

@@ -219,7 +219,7 @@ export declare function useChatComposerController({ delivery, draft, control, ef
     handlePaste: (event: ClipboardEvent<HTMLTextAreaElement>) => void;
     handleFileChange: (event: ChangeEvent<HTMLInputElement>) => void;
     focusInput: () => void | undefined;
-    setValue: (value: string) => void;
+    setValue: (next: string) => void;
     value: string;
 };
 export type ChatComposerController = ReturnType<typeof useChatComposerController>;

package/dist/components/fleet-tile.d.ts

@@ -1,7 +1,7 @@
 import type { Session } from "@opengeni/sdk";
 export type FleetTileProps = {
     session: Session;
-    /** Overrides the derived title (metadata.title/name, else the initial message). */
+    /** Overrides the derived title (session title, metadata title/name, or safe fallback). */
     title?: string | undefined;
     /** Extra line under the title — e.g. "drift check" or the worker's task. */
     subtitle?: string | undefined;

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

@@ -1,5 +1,6 @@
 import type { DraftTimelineAnnotation, SessionEvent, SessionStatus } from "@opengeni/sdk";
 import { type ReactNode } from "react";
+import { type OlderHistoryLoader } from "../older-history.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 = {
     /** Raw session events (projected internally) … */
@@ -70,8 +71,12 @@ export type MessageTimelineProps = {
     hasOlder?: boolean | undefined;
     /** An older window is being fetched; shows the quiet top shimmer. */
     loadingOlder?: boolean | undefined;
-    /** Called when the reader nears the top and older history should backfill. */
-    onLoadOlder?: (() => void) | undefined;
+    /**
+     * Called when older history should backfill. Existing void, synchronous-value,
+     * and arbitrary-promise callbacks remain supported. Receipt-aware loaders
+     * preserve committed-page direction through wrappers and bounded windows.
+     */
+    onLoadOlder?: OlderHistoryLoader | undefined;
     /** Jump to the durable session start (bounded oldest window, no middle). */
     onJumpToStart?: (() => void | Promise<void>) | undefined;
     /** True while the oldest window is loading. */

package/dist/composer.js

@@ -37,8 +37,8 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-LTCHJ4MS.js";
-import "./chunk-JOAVA2TW.js";
+} from "./chunk-KSDXER4X.js";
+import "./chunk-T7VAYG2I.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,

package/dist/hooks/use-session-events.d.ts

@@ -1,5 +1,6 @@
 import type { SessionEvent, SessionStatus, StreamConnectionState } from "@opengeni/sdk";
 import { type EmbeddedSessionClientOverride } from "../session-context.js";
+import { type OlderHistoryLoadReceipt } from "../older-history.js";
 import type { TimelineItem } from "../timeline/types.js";
 export type SessionEventsConnectionState = StreamConnectionState | "idle" | "ended" | "error";
 export type UseSessionEventsOptions = EmbeddedSessionClientOverride & {
@@ -31,7 +32,7 @@ export type UseSessionEventsResult = {
     /** True while an older window is being fetched. */
     loadingOlder: boolean;
     /** Prepend an older density-bounded window; resolves true when more remain. */
-    loadOlder: () => Promise<boolean>;
+    loadOlder: () => OlderHistoryLoadReceipt;
     /**
      * Durable events exist after the current window (history view jumped away
      * from the live tip, or a forward page is incomplete).

package/dist/hooks/use-session-lineage.d.ts

@@ -5,11 +5,15 @@ export type UseSessionLineageOptions = EmbeddedSessionLineageClientOverride & {
     /** Refresh interval (ms). Off by default. */
     pollIntervalMs?: number | undefined;
     enabled?: boolean | undefined;
+    /** Optional shared causal clock invoked when each network read starts. */
+    beginRead?: (() => number) | undefined;
 };
 export type UseSessionLineageResult = {
     lineage: SessionLineageResponse | null;
     loading: boolean;
     error: Error | null;
+    /** Causal generation captured when the accepted lineage read started. */
+    readGeneration: number;
     refresh: () => Promise<void>;
 };
 export declare function isLineageRefreshEvent(event: SessionEvent): boolean;

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

@@ -4,11 +4,17 @@ import { type SessionEventFeedOptions } from "./internal.js";
 export type UseSessionOptions = EmbeddedSessionReadClientOverride & SessionEventFeedOptions & {
     /** Re-fetch on an interval (ms). Off by default — pair with `useSessionEvents` for live status. */
     pollIntervalMs?: number | undefined;
+    /** Optional shared causal clock invoked when each network read starts. */
+    beginRead?: (() => number) | undefined;
 };
 export type UseSessionResult = {
     session: Session | null;
     loading: boolean;
     error: Error | null;
+    /** Monotonic revision of accepted authoritative detail reads. */
+    readRevision: number;
+    /** Causal generation captured when the accepted network read started. */
+    readGeneration: number;
     refresh: () => Promise<void>;
     /** Manually rename the session (PATCH, source='user'). Returns the updated session, or null on failure. */
     updateTitle: (title: string) => Promise<Session | null>;

package/dist/hooks/use-workspace-sessions.d.ts

@@ -11,6 +11,8 @@ export type UseWorkspaceSessionsOptions = ClientOverride & {
     /** Refresh interval (ms) for fleet/manager views. Off by default. */
     pollIntervalMs?: number | undefined;
     enabled?: boolean | undefined;
+    /** Optional shared causal clock invoked when each network read starts. */
+    beginRead?: (() => number) | undefined;
 };
 export type UseWorkspaceSessionsResult = {
     /**
@@ -25,6 +27,10 @@ export type UseWorkspaceSessionsResult = {
     nextCursor: string | null;
     loading: boolean;
     error: Error | null;
+    /** Monotonic revision of accepted authoritative list-page reads. */
+    readRevision: number;
+    /** Causal generation captured when the accepted network read started. */
+    readGeneration: number;
     refresh: () => Promise<void>;
 };
 /** List the workspace's sessions — the data behind fleet and manager views. */

package/dist/index.d.ts

@@ -8,7 +8,9 @@ export { usePageLiveActivity } from "./hooks/internal.js";
 export { useSession, isTitleEvent } from "./hooks/use-session.js";
 export type { UseSessionOptions, UseSessionResult } from "./hooks/use-session.js";
 export { SESSION_EVENT_BROWSER_MAX_BYTES, SESSION_EVENT_BROWSER_MAX_COUNT, SESSION_EVENT_BROWSER_PENDING_MAX_BYTES, SESSION_EVENT_BROWSER_PENDING_MAX_COUNT, SESSION_EVENT_BROWSER_SINGLE_EVENT_MAX_BYTES, boundBrowserSessionEventWindow, useSessionEvents, } from "./hooks/use-session-events.js";
+export { createOlderHistoryLoadReceipt } from "./older-history.js";
 export type { BrowserSessionEventWindow, SessionEventsConnectionState, UseSessionEventsOptions, UseSessionEventsResult, } from "./hooks/use-session-events.js";
+export type { OlderHistoryLoader, OlderHistoryLoadReceipt } from "./older-history.js";
 export { useComposer, composeSendInput, shouldSteerOnKey, shouldSubmitOnKey, FILE_ONLY_MESSAGE_TEXT, } from "./hooks/use-composer.js";
 export type { ComposerControllerState, ComposerPolicy, ComposerSendExtras, ComposerState, UseComposerOptions, } from "./hooks/use-composer.js";
 export { VOICE_RECORDING_CLIENT_MAX_DURATION_SECONDS, VOICE_RECORDING_OWNER_HEARTBEAT_MILLISECONDS, VOICE_RECORDING_OWNER_STALE_MILLISECONDS, VOICE_RECORDING_TIMESLICE_MILLISECONDS, useVoiceInput, } from "./hooks/use-voice-input.js";

package/dist/index.js

@@ -24,7 +24,7 @@ import {
   useSessionLineage,
   useSessionMcpApprovalPolicy,
   useTurnQueue
-} from "./chunk-SE4W4WQ3.js";
+} from "./chunk-ATQJEWCA.js";
 import {
   CONNECTION_STATUS_META,
   ConnectionDot,
@@ -109,14 +109,14 @@ import {
   useSlashCommands,
   useTranscription,
   useVoiceInput
-} from "./chunk-LTCHJ4MS.js";
+} from "./chunk-KSDXER4X.js";
 import {
   FILE_ONLY_MESSAGE_TEXT,
   composeSendInput,
   shouldSteerOnKey,
   shouldSubmitOnKey,
   useComposer
-} from "./chunk-JOAVA2TW.js";
+} from "./chunk-T7VAYG2I.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -205,15 +205,16 @@ import {
   useThemeType,
   userMessageLikelyNeedsDisclosure,
   v4aToGitFileDiff
-} from "./chunk-LS4POUTY.js";
+} from "./chunk-6H6S5V4Z.js";
 import {
   buildTimeline,
+  createOlderHistoryLoadReceipt,
   creditExhaustedFromEvents,
   extractSessionRef,
   groupTimeline,
   sessionStatusFromEvents,
   toolDisplayName
-} from "./chunk-RSXJN73N.js";
+} from "./chunk-MXJGO7LE.js";
 import {
   TimelineAnnotationsChip
 } from "./chunk-WSK7G5LE.js";
@@ -374,6 +375,9 @@ function useWorkspaceSessions(options = {}) {
   const pinsOnly = options.pinsOnly;
   const archivedOnly = options.archivedOnly;
   const enabled = options.enabled ?? true;
+  const nextReadRevision = useRef(0);
+  const nextReadGeneration = useRef(0);
+  const beginRead = options.beginRead;
   const queryKey = [
     workspaceId,
     limit ?? "",
@@ -388,20 +392,34 @@ function useWorkspaceSessions(options = {}) {
   useEffect2(() => {
     previousQueryKey.current = queryKey;
   }, [queryKey]);
-  const load = useCallback3(
-    async () => ({
+  const load = useCallback3(async () => {
+    const readGeneration = beginRead?.() ?? ++nextReadGeneration.current;
+    const page2 = await client.listSessionPage(workspaceId, {
+      ...limit !== void 0 ? { limit } : {},
+      ...parentSessionId !== void 0 ? { parentSessionId } : {},
+      ...cursor !== void 0 ? { cursor } : {},
+      ...search !== void 0 ? { search } : {},
+      ...pinsOnly ? { pinsOnly: true } : {},
+      ...archivedOnly ? { archivedOnly: true } : {}
+    });
+    return {
       queryKey,
-      page: await client.listSessionPage(workspaceId, {
-        ...limit !== void 0 ? { limit } : {},
-        ...parentSessionId !== void 0 ? { parentSessionId } : {},
-        ...cursor !== void 0 ? { cursor } : {},
-        ...search !== void 0 ? { search } : {},
-        ...pinsOnly ? { pinsOnly: true } : {},
-        ...archivedOnly ? { archivedOnly: true } : {}
-      })
-    }),
-    [client, workspaceId, limit, parentSessionId, cursor, search, pinsOnly, archivedOnly, queryKey]
-  );
+      page: page2,
+      revision: ++nextReadRevision.current,
+      readGeneration
+    };
+  }, [
+    beginRead,
+    client,
+    workspaceId,
+    limit,
+    parentSessionId,
+    cursor,
+    search,
+    pinsOnly,
+    archivedOnly,
+    queryKey
+  ]);
   const state = usePolledValue(load, {
     pollIntervalMs: options.pollIntervalMs,
     enabled
@@ -423,6 +441,8 @@ function useWorkspaceSessions(options = {}) {
     // announce a transient false zero-match result.
     loading: enabled && (state.loading || queryKeyTransition || state.data !== null && state.data.queryKey !== queryKey),
     error: state.error,
+    readRevision: page ? state.data?.revision ?? 0 : 0,
+    readGeneration: page ? state.data?.readGeneration ?? 0 : 0,
     refresh: state.refresh
   };
 }
@@ -4065,6 +4085,7 @@ function ChatComposer({
 
 // src/components/fleet-tile.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var AUTOMATIC_SESSION_TITLE_FALLBACK = "New conversation";
 function sessionDisplayTitle(session) {
   if (typeof session.title === "string" && session.title.trim().length > 0) {
     return session.title;
@@ -4075,7 +4096,7 @@ function sessionDisplayTitle(session) {
       return value;
     }
   }
-  return truncate(session.initialMessage, 100) || session.id.slice(0, 8);
+  return AUTOMATIC_SESSION_TITLE_FALLBACK;
 }
 function FleetTile({ session, title, subtitle, onOpen, className }) {
   const running = session.status === "running" || session.status === "queued";
@@ -9527,6 +9548,7 @@ export {
   controlCaret,
   copyTextToClipboard,
   createDefaultToolRegistry,
+  createOlderHistoryLoadReceipt,
   createToolRegistry,
   createVoiceRecordingManifest,
   creditExhaustedFromEvents,