@opengeni/react 2.2.0-canary.0 → 2.5.0-canary.0

package/dist/{chunk-UOLJWT5Y.js → chunk-ATQJEWCA.js}

@@ -1,8 +1,9 @@
 import {
   buildTimeline,
+  createOlderHistoryLoadReceipt,
   groupTimeline,
   sessionStatusFromEvents
-} from "./chunk-XSA2QAKP.js";
+} from "./chunk-MXJGO7LE.js";
 import {
   useDebouncedCallback,
   useMutationRunner,
@@ -21,7 +22,7 @@ import {
 } from "./chunk-NEXLLTP4.js";
 
 // src/hooks/use-session.ts
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 function isTitleEvent(event) {
   return event.type === "session.title_set";
 }
@@ -29,15 +30,28 @@ function useSession(sessionId, options = {}) {
   const { client, workspaceId, workspaceControlEvent, registerSessionReconciler } = useEmbeddedSessionRead(options);
   const enabled = (options.enabled ?? true) && Boolean(sessionId);
   const [override, setOverride] = useState(null);
+  const nextReadRevision = useRef(0);
+  const nextReadGeneration = useRef(0);
+  const beginRead = options.beginRead;
   const { run, mutating, mutationError, clearMutationError } = useMutationRunner();
   const load = useCallback(async () => {
     if (!sessionId) {
       return null;
     }
-    const fetched = await client.getSession(workspaceId, sessionId);
+    let readGeneration2 = 0;
+    const fetched = await client.getSession(workspaceId, sessionId, {
+      fresh: true,
+      onRequestStart: () => {
+        readGeneration2 = beginRead?.() ?? ++nextReadGeneration.current;
+      }
+    });
     setOverride(null);
-    return fetched;
-  }, [client, workspaceId, sessionId]);
+    return {
+      session: fetched,
+      revision: ++nextReadRevision.current,
+      readGeneration: readGeneration2
+    };
+  }, [beginRead, client, workspaceId, sessionId]);
   const { data, loading, error, refresh } = usePolledValue(load, {
     pollIntervalMs: options.pollIntervalMs,
     enabled
@@ -49,13 +63,18 @@ function useSession(sessionId, options = {}) {
     if (!sessionId || !enabled) return;
     return registerSessionReconciler(sessionId, "session", refresh);
   }, [enabled, refresh, registerSessionReconciler, sessionId]);
-  const base = data ?? null;
+  const base = data?.session ?? null;
+  const readRevision = data?.revision ?? 0;
+  const readGeneration = data?.readGeneration ?? 0;
   const session = useMemo(
     () => base && override && override.id === base.id ? { ...base, title: override.title, titleSource: override.titleSource } : base,
     [base, override]
   );
   const onTitleEvent = useCallback(
     (event) => {
+      if (!base || event.sequence <= base.lastSequence) {
+        return;
+      }
       const payload = event.payload ?? {};
       const title = payload.title;
       if (typeof title !== "string") {
@@ -64,9 +83,6 @@ function useSession(sessionId, options = {}) {
       const source = payload.source === "user" || payload.source === "agent" ? payload.source : null;
       setOverride((current) => {
         const next = current ?? base;
-        if (!next) {
-          return current;
-        }
         return { ...next, title, titleSource: source };
       });
     },
@@ -93,6 +109,8 @@ function useSession(sessionId, options = {}) {
     session,
     loading,
     error,
+    readRevision,
+    readGeneration,
     refresh,
     updateTitle,
     updating: mutating,
@@ -102,7 +120,7 @@ function useSession(sessionId, options = {}) {
 }
 
 // src/hooks/use-session-events.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2, useRef, useState as useState2 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
 var INITIAL_TAIL_PAGE_SIZE = 1e3;
 var OLDER_PAGE_SIZE = 5e3;
 var NEWER_PAGE_SIZE = 5e3;
@@ -174,23 +192,23 @@ function useSessionEvents(sessionId, options = {}) {
   const [loadingLatest, setLoadingLatest] = useState2(false);
   const [streamEpoch, setStreamEpoch] = useState2(0);
   const [viewMode, setViewMode] = useState2("live");
-  const lastSequenceRef = useRef(after);
-  const streamResumeSequenceRef = useRef(after);
-  const oldestSequenceRef = useRef(null);
-  const newestSequenceRef = useRef(null);
-  const hasOlderRef = useRef(false);
-  const hasNewerRef = useRef(false);
-  const loadingOlderRef = useRef(false);
-  const loadingNewerRef = useRef(false);
-  const loadingOldestRef = useRef(false);
-  const loadingLatestRef = useRef(false);
-  const viewModeRef = useRef("live");
-  const initialWindowLoadedRef = useRef(false);
-  const streamAbortRef = useRef(null);
-  const streamKeyRef = useRef(null);
-  const generationRef = useRef(0);
-  const eventWindowRef = useRef(EMPTY_EVENT_WINDOW);
-  const sessionStatusRef = useRef({
+  const lastSequenceRef = useRef2(after);
+  const streamResumeSequenceRef = useRef2(after);
+  const oldestSequenceRef = useRef2(null);
+  const newestSequenceRef = useRef2(null);
+  const hasOlderRef = useRef2(false);
+  const hasNewerRef = useRef2(false);
+  const loadingOlderRef = useRef2(false);
+  const loadingNewerRef = useRef2(false);
+  const loadingOldestRef = useRef2(false);
+  const loadingLatestRef = useRef2(false);
+  const viewModeRef = useRef2("live");
+  const initialWindowLoadedRef = useRef2(false);
+  const streamAbortRef = useRef2(null);
+  const streamKeyRef = useRef2(null);
+  const generationRef = useRef2(0);
+  const eventWindowRef = useRef2(EMPTY_EVENT_WINDOW);
+  const sessionStatusRef = useRef2({
     sequence: after,
     status: null
   });
@@ -392,73 +410,78 @@ function useSessionEvents(sessionId, options = {}) {
     reconcileSession
   ]);
   const navigationBusy = () => loadingOlderRef.current || loadingNewerRef.current || loadingOldestRef.current || loadingLatestRef.current;
-  const loadOlder = useCallback2(async () => {
-    if (!sessionId || navigationBusy() || !hasOlderRef.current) {
-      return false;
-    }
-    const before = oldestSequenceRef.current;
-    if (before === null) {
-      hasOlderRef.current = false;
-      setHasOlder(false);
-      return false;
-    }
-    const generation = generationRef.current;
-    loadingOlderRef.current = true;
-    setLoadingOlder(true);
-    try {
-      const window = await loadEventWindow(client, workspaceId, sessionId, {
-        before,
-        pageSize: OLDER_PAGE_SIZE,
-        targetGroups: OLDER_GROUP_TARGET,
-        maxFetches: OLDER_FETCH_CAP
-      });
-      if (generationRef.current !== generation) {
+  const loadOlder = useCallback2(
+    () => createOlderHistoryLoadReceipt(async (markCommitted) => {
+      if (!sessionId || navigationBusy() || !hasOlderRef.current) {
         return false;
       }
-      if (window.events.length === 0) {
+      const before = oldestSequenceRef.current;
+      if (before === null) {
         oldestSequenceRef.current = null;
         hasOlderRef.current = false;
         setHasOlder(false);
         return false;
       }
-      const current = eventWindowRef.current;
-      assertPrependOrder(current.events, window.events);
-      streamAbortRef.current?.abort();
-      observeSessionStatus(window.events, sessionStatusRef, setSessionStatusProjection);
-      const next = boundBrowserSessionEventWindow([...window.events, ...current.events], {
-        direction: "oldest"
-      });
-      const retained = {
-        ...next,
-        truncated: current.truncated || next.truncated
-      };
-      const retainedOldest = retained.events[0]?.sequence ?? null;
-      if (retainedOldest === null || retainedOldest >= before) {
-        throw new Error("@opengeni/react: loadOlder made no durable sequence progress");
-      }
-      const retainedNewest = retained.events.at(-1)?.sequence ?? null;
-      eventWindowRef.current = retained;
-      setEventWindow(retained);
-      oldestSequenceRef.current = retainedOldest;
-      newestSequenceRef.current = retainedNewest;
-      streamResumeSequenceRef.current = maxResumeSequence(retained.events);
-      const olderStillAvailable = window.hasOlder;
-      hasOlderRef.current = olderStillAvailable;
-      setHasOlder(olderStillAvailable);
-      if (viewModeRef.current === "history") {
-        const highWater = lastSequenceRef.current;
-        const newer = retainedNewest !== null && (retainedNewest < highWater || retained.truncated);
-        hasNewerRef.current = newer;
-        setHasNewer(newer);
-      } else {
-        setStreamEpoch((epoch) => epoch + 1);
+      const generation = generationRef.current;
+      loadingOlderRef.current = true;
+      setLoadingOlder(true);
+      try {
+        const window = await loadEventWindow(client, workspaceId, sessionId, {
+          before,
+          pageSize: OLDER_PAGE_SIZE,
+          targetGroups: OLDER_GROUP_TARGET,
+          maxFetches: OLDER_FETCH_CAP
+        });
+        if (generationRef.current !== generation) {
+          return false;
+        }
+        if (window.events.length === 0) {
+          oldestSequenceRef.current = null;
+          hasOlderRef.current = false;
+          setHasOlder(false);
+          return false;
+        }
+        const current = eventWindowRef.current;
+        assertPrependOrder(current.events, window.events);
+        streamAbortRef.current?.abort();
+        observeSessionStatus(window.events, sessionStatusRef, setSessionStatusProjection);
+        const next = boundBrowserSessionEventWindow([...window.events, ...current.events], {
+          direction: "oldest"
+        });
+        const retained = {
+          ...next,
+          truncated: current.truncated || next.truncated
+        };
+        const retainedOldest = retained.events[0]?.sequence ?? null;
+        if (retainedOldest === null || retainedOldest >= before) {
+          throw new Error("@opengeni/react: loadOlder made no durable sequence progress");
+        }
+        const retainedNewest = retained.events.at(-1)?.sequence ?? null;
+        eventWindowRef.current = retained;
+        markCommitted();
+        setEventWindow(retained);
+        oldestSequenceRef.current = retainedOldest;
+        newestSequenceRef.current = retainedNewest;
+        streamResumeSequenceRef.current = maxResumeSequence(retained.events);
+        const olderStillAvailable = window.hasOlder;
+        hasOlderRef.current = olderStillAvailable;
+        setHasOlder(olderStillAvailable);
+        if (viewModeRef.current === "history") {
+          const highWater = lastSequenceRef.current;
+          const newer = retainedNewest !== null && (retainedNewest < highWater || retained.truncated);
+          hasNewerRef.current = newer;
+          setHasNewer(newer);
+        } else {
+          setStreamEpoch((epoch) => epoch + 1);
+        }
+        return olderStillAvailable;
+      } finally {
+        loadingOlderRef.current = false;
+        setLoadingOlder(false);
       }
-      return olderStillAvailable;
-    } finally {
-      loadingOlderRef.current = false;
-      setLoadingOlder(false);
-    }
-  }, [client, workspaceId, sessionId]);
+    }),
+    [client, workspaceId, sessionId]
+  );
   const loadOldest = useCallback2(async () => {
     if (!sessionId || navigationBusy() || !hasOlderRef.current) {
       return false;
@@ -1048,14 +1071,14 @@ function abortError() {
 }
 
 // src/hooks/use-file-attachments.ts
-import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef2, useState as useState3 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
 var isImage = (file) => file.type.startsWith("image/");
 function useFileAttachments(options = {}) {
   const { client, workspaceId } = useEmbeddedFileAttachments(options);
   const pasteFilter = options.pasteFilter ?? isImage;
   const [attachments, setAttachments] = useState3([]);
-  const sources = useRef2(/* @__PURE__ */ new Map());
-  const previewUrls = useRef2(/* @__PURE__ */ new Map());
+  const sources = useRef3(/* @__PURE__ */ new Map());
+  const previewUrls = useRef3(/* @__PURE__ */ new Map());
   const revokePreview = useCallback3((id) => {
     const previewUrl = previewUrls.current.get(id);
     if (!previewUrl) return;
@@ -1067,7 +1090,7 @@ function useFileAttachments(options = {}) {
     previewUrls.current.clear();
     for (const previewUrl of urls) URL.revokeObjectURL(previewUrl);
   }, []);
-  const committedAttachmentIds = useRef2(/* @__PURE__ */ new Set());
+  const committedAttachmentIds = useRef3(/* @__PURE__ */ new Set());
   useEffect3(() => {
     const currentIds = new Set(attachments.map((attachment) => attachment.id));
     for (const id of committedAttachmentIds.current) {
@@ -1075,8 +1098,8 @@ function useFileAttachments(options = {}) {
     }
     committedAttachmentIds.current = currentIds;
   }, [attachments, revokePreview]);
-  const scopeGeneration = useRef2(0);
-  const previousScope = useRef2({ client, workspaceId });
+  const scopeGeneration = useRef3(0);
+  const previousScope = useRef3({ client, workspaceId });
   useEffect3(() => {
     const previous = previousScope.current;
     if (previous.client === client && previous.workspaceId === workspaceId) return;
@@ -1264,7 +1287,7 @@ function useFileAttachments(options = {}) {
 }
 
 // src/hooks/use-turn-queue.ts
-import { useCallback as useCallback4, useEffect as useEffect4, useLayoutEffect, useMemo as useMemo3, useRef as useRef3, useState as useState4 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect4, useLayoutEffect, useMemo as useMemo3, useRef as useRef4, useState as useState4 } from "react";
 function isTurnQueueEvent(event) {
   return event.type.startsWith("turn.") || event.type.startsWith("session.queue.") || event.type.startsWith("session.control.") || event.type.startsWith("system.update.") || event.type.startsWith("workspace.inference.");
 }
@@ -1286,10 +1309,10 @@ function useTurnQueue(sessionId, options = {}) {
   const [mutationError, setMutationError] = useState4(null);
   const [pendingByTurn, setPendingByTurn] = useState4({});
   const [acceptedSteers, setAcceptedSteers] = useState4([]);
-  const pendingRef = useRef3({});
-  const readGeneration = useRef3(0);
-  const targetKeyRef = useRef3(targetKey);
-  const snapshotRef = useRef3(null);
+  const pendingRef = useRef4({});
+  const readGeneration = useRef4(0);
+  const targetKeyRef = useRef4(targetKey);
+  const snapshotRef = useRef4(null);
   useLayoutEffect(() => {
     if (targetKeyRef.current === targetKey) return;
     targetKeyRef.current = targetKey;
@@ -1598,7 +1621,7 @@ function isOutcomeUnknownError(cause) {
 
 // src/hooks/use-goal.ts
 import { OpenGeniApiError } from "@opengeni/sdk";
-import { useCallback as useCallback5, useEffect as useEffect5, useRef as useRef4, useState as useState5 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect5, useRef as useRef5, useState as useState5 } from "react";
 function isGoalEvent(event) {
   return event.type.startsWith("goal.");
 }
@@ -1616,8 +1639,8 @@ function useGoal(sessionId, options = {}) {
   const [loading, setLoading] = useState5(enabled);
   const [error, setError] = useState5(null);
   const { run, mutating, mutationError, clearMutationError } = useMutationRunner();
-  const generation = useRef4(0);
-  const targetKeyRef = useRef4(null);
+  const generation = useRef5(0);
+  const targetKeyRef = useRef5(null);
   const load = useCallback5(async () => {
     if (!sessionId) {
       return;
@@ -1750,11 +1773,11 @@ function useGoal(sessionId, options = {}) {
 }
 
 // src/hooks/use-session-control.ts
-import { useCallback as useCallback6, useLayoutEffect as useLayoutEffect2, useRef as useRef5 } from "react";
+import { useCallback as useCallback6, useLayoutEffect as useLayoutEffect2, useRef as useRef6 } from "react";
 function useSessionControl(sessionId, options = {}) {
   const { client, workspaceId } = useEmbeddedSession(options);
   const approvalTargetKey = `${workspaceId}\0${sessionId ?? ""}`;
-  const pendingApproval = useRef5(null);
+  const pendingApproval = useRef6(null);
   useLayoutEffect2(() => {
     if (pendingApproval.current?.targetKey !== approvalTargetKey) {
       pendingApproval.current = null;
@@ -1847,7 +1870,7 @@ function useSessionControl(sessionId, options = {}) {
 }
 
 // src/hooks/use-session-mcp-approval-policy.ts
-import { useCallback as useCallback7, useEffect as useEffect6, useLayoutEffect as useLayoutEffect3, useMemo as useMemo4, useRef as useRef6, useState as useState6 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect6, useLayoutEffect as useLayoutEffect3, useMemo as useMemo4, useRef as useRef7, useState as useState6 } from "react";
 function isSessionMcpApprovalPolicyEvent(event, serverId) {
   if (event.type !== "session.mcp.approval_policy.updated") {
     return false;
@@ -1863,7 +1886,7 @@ function useSessionMcpApprovalPolicy(sessionId, serverId, options = {}) {
   const enabled = (options.enabled ?? true) && Boolean(sessionId && serverId);
   const [override, setOverride] = useState6(null);
   const targetKey = `${workspaceId}\0${sessionId ?? ""}\0${serverId ?? ""}`;
-  const authoritativeGeneration = useRef6(0);
+  const authoritativeGeneration = useRef7(0);
   const mutationIdentity = useMemo4(() => ({ client, targetKey }), [client, targetKey]);
   const { run, mutating, mutationError, clearMutationError } = useMutationRunner(mutationIdentity);
   useLayoutEffect3(() => {
@@ -1948,7 +1971,7 @@ function useSessionMcpApprovalPolicy(sessionId, serverId, options = {}) {
 }
 
 // src/hooks/use-session-lineage.ts
-import { useCallback as useCallback8, useEffect as useEffect7, useRef as useRef7 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect7, useRef as useRef8 } from "react";
 function isLineageRefreshEvent(event) {
   if (event.type === "session.status.changed" || event.type === "session.created") {
     return true;
@@ -1971,10 +1994,26 @@ function isSessionCreateToolCallCreated(event) {
 function useSessionLineage(sessionId, options = {}) {
   const { client, workspaceId, workspaceControlEvent, registerSessionReconciler } = useEmbeddedSessionLineage(options);
   const enabled = (options.enabled ?? true) && Boolean(sessionId);
-  const load = useCallback8(
-    async () => sessionId ? await client.getSessionLineage(workspaceId, sessionId) : { ancestors: [], children: [], truncated: false },
-    [client, workspaceId, sessionId]
-  );
+  const nextReadGeneration = useRef8(0);
+  const beginRead = options.beginRead;
+  const load = useCallback8(async () => {
+    if (!sessionId) {
+      return {
+        lineage: { ancestors: [], children: [], truncated: false },
+        readGeneration: 0
+      };
+    }
+    let readGeneration = 0;
+    const lineage = await client.getSessionLineage(workspaceId, sessionId, {
+      onRequestStart: (sharedReadGeneration) => {
+        readGeneration = sharedReadGeneration ?? beginRead?.() ?? ++nextReadGeneration.current;
+      }
+    });
+    return {
+      lineage,
+      readGeneration
+    };
+  }, [beginRead, client, workspaceId, sessionId]);
   const state = usePolledValue(load, { pollIntervalMs: options.pollIntervalMs, enabled });
   const refresh = state.refresh;
   useEffect7(() => {
@@ -1985,7 +2024,7 @@ function useSessionLineage(sessionId, options = {}) {
     return registerSessionReconciler(sessionId, "lineage", refresh);
   }, [enabled, refresh, registerSessionReconciler, sessionId]);
   const refreshSoon = useDebouncedCallback(() => void refresh(), 150);
-  const delayedChildRefreshRef = useRef7(null);
+  const delayedChildRefreshRef = useRef8(null);
   useEffect7(() => {
     return () => {
       if (delayedChildRefreshRef.current !== null) {
@@ -2025,9 +2064,10 @@ function useSessionLineage(sessionId, options = {}) {
     { events: options.events, enabled: enabled && options.events !== void 0 }
   );
   return {
-    lineage: state.data,
+    lineage: state.data?.lineage ?? null,
     loading: state.loading,
     error: state.error,
+    readGeneration: state.data?.readGeneration ?? 0,
     refresh
   };
 }
@@ -2126,7 +2166,7 @@ function isRecord(value) {
 }
 
 // src/hooks/use-human-input.ts
-import { useCallback as useCallback9, useEffect as useEffect8, useRef as useRef8, useState as useState7 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect8, useRef as useRef9, useState as useState7 } from "react";
 function isHumanInputEvent(event) {
   return event.type === "session.humanInput.requested" || event.type === "user.humanInputResponse" || event.type === "turn.completed" || event.type === "turn.failed" || event.type === "turn.cancelled";
 }
@@ -2143,7 +2183,7 @@ function useHumanInputRequests(sessionId, options = {}) {
   });
   const mutation = useMutationRunner(`${workspaceId}\0${sessionId ?? ""}`);
   const [respondingRequestId, setRespondingRequestId] = useState7(null);
-  const respondingRequestRef = useRef8(null);
+  const respondingRequestRef = useRef9(null);
   useEffect8(() => {
     respondingRequestRef.current = null;
     setRespondingRequestId(null);
@@ -2220,4 +2260,4 @@ export {
   isHumanInputEvent,
   useHumanInputRequests
 };
-//# sourceMappingURL=chunk-UOLJWT5Y.js.map
+//# sourceMappingURL=chunk-ATQJEWCA.js.map