@opengeni/react 0.6.3 → 0.9.0

package/README.md

@@ -53,12 +53,19 @@ import {
 const client = new OpenGeniClient({ baseUrl: "/api/opengeni" }); // proxy through your API
 
 function OpsChannel({ sessionId }: { sessionId: string }) {
-  const { timeline, sessionStatus } = useSessionEvents(sessionId);
+  const { timeline, sessionStatus, hasOlder, loadingOlder, loadOlder } = useSessionEvents(sessionId);
   const composer = useComposer(sessionId);
   return (
     <div className="flex h-full flex-col">
       {sessionStatus ? <SessionStatus status={sessionStatus} /> : null}
-      <MessageTimeline items={timeline} status={sessionStatus} className="min-h-0 flex-1" />
+      <MessageTimeline
+        items={timeline}
+        status={sessionStatus}
+        hasOlder={hasOlder}
+        loadingOlder={loadingOlder}
+        onLoadOlder={() => void loadOlder()}
+        className="min-h-0 flex-1"
+      />
       <ChatComposer composer={composer} status={sessionStatus} />
     </div>
   );
@@ -75,10 +82,14 @@ export function App() {
 
 ## Hooks
 
-- `useSessionEvents(sessionId)` — live stream + replay on the SDK's
-  exactly-once/ordered event delivery; returns the raw `events`, the projected
-  `timeline`, the latest `sessionStatus`, and the connection state. Updates are
-  batched per animation-frame-ish window so long replays stay smooth.
+- `useSessionEvents(sessionId)` — loads a compact, bounded tail window by
+  default, then live-streams on the SDK's exactly-once/ordered event delivery.
+  Initial replay is capped at three 5000-row raw pages and `loadOlder` at two;
+  timeline group density is only an early stop. It returns the raw windowed
+  `events`, projected `timeline`, latest `sessionStatus`, connection state, and
+  older-history controls (`hasOlder`, `loadingOlder`, `loadOlder`). Pass
+  `replay: "full"` to opt back into full replay; a nonzero `after` keeps the
+  previous resume semantics.
 - `useComposer(sessionId, { sendExtras, defaultMode })` — draft/send/interrupt
   state plus the compose-time **queue-vs-steer** choice (`mode`/`setMode`,
   default `"queue"`): queue stacks the message behind the running turn, steer

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientOverride, S as SessionClientLike } from './machines-Bv9tG7qZ.js';
-export { a as CONNECTION_STATUS_META, b as ConnectionDot, c as ConnectionDotProps, d as ConnectionStatus, e as ConnectionStatusMeta, f as ConnectionStatusPill, g as ConnectionStatusPillProps, D as DeviceFlowPhase, E as EnrollmentConsent, h as EnrollmentConsentMachine, i as EnrollmentConsentPhase, j as EnrollmentConsentProps, k as EnrollmentDeviceFlow, l as EnrollmentDeviceFlowProps, M as MACHINE_STATE_BADGE_META, m as MachineCard, n as MachineCardProps, o as MachineDockBar, p as MachineDockBarProps, q as MachineMetrics, r as MachineMetricsProps, s as MachineStateBadgeMeta, t as MachineStatusPill, u as MachineStatusPillProps, v as MachinesClientLike, w as MachinesDashboard, x as MachinesDashboardProps, O as OpenGeniContextValue, y as OpenGeniProvider, z as OpenGeniProviderProps, A as SharedMachineDisclosure, B as SharedMachineDisclosureProps, U as UseMachinesOptions, F as UseMachinesResult, G as connectionStatusForState, H as useMachines, I as useOpenGeni, J as useOpenGeniClient } from './machines-Bv9tG7qZ.js';
+import { C as ClientOverride, S as SessionClientLike } from './machines-BeZ3bD3t.js';
+export { a as CONNECTION_STATUS_META, b as ConnectionDot, c as ConnectionDotProps, d as ConnectionStatus, e as ConnectionStatusMeta, f as ConnectionStatusPill, g as ConnectionStatusPillProps, D as DeviceFlowPhase, E as EnrollmentConsent, h as EnrollmentConsentMachine, i as EnrollmentConsentPhase, j as EnrollmentConsentProps, k as EnrollmentDeviceFlow, l as EnrollmentDeviceFlowProps, M as MACHINE_STATE_BADGE_META, m as MachineCard, n as MachineCardProps, o as MachineDockBar, p as MachineDockBarProps, q as MachineMetrics, r as MachineMetricsProps, s as MachineStateBadgeMeta, t as MachineStatusPill, u as MachineStatusPillProps, v as MachinesClientLike, w as MachinesDashboard, x as MachinesDashboardProps, O as OpenGeniContextValue, y as OpenGeniProvider, z as OpenGeniProviderProps, A as SharedMachineDisclosure, B as SharedMachineDisclosureProps, U as UseMachinesOptions, F as UseMachinesResult, G as connectionStatusForState, H as useMachines, I as useOpenGeni, J as useOpenGeniClient } from './machines-BeZ3bD3t.js';
 import { SessionEvent, Session, ResourceRef, ToolRef, SessionStatus as SessionStatus$1, GitFileDiff, StreamConnectionState, SendMessageInput, FileAsset, FileResourceRef, SessionTurn, UpdateSessionTurnRequest, SessionGoal, ScheduledTask, WorkspaceEnvironment, CreateWorkspaceEnvironmentRequest, UpdateWorkspaceEnvironmentRequest, WorkspaceEnvironmentVariableMetadata, CapabilityPack, PackInstallation, RegisterCapabilityPackRequest, WorkspaceRegisteredPack, EnablePackRequest, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, BillingBalance, UsageEvent, ClientModel, SessionCapabilities, DesktopStreamCapability, DesktopConnectionState, DesktopRfbFactory, TerminalCapability, FsReadResponse, FsWriteResponse, Permission, CapabilityUnavailableReason, CodexAccountsResponse, CodexAccount, CodexRotationSettings } from '@opengeni/sdk';
 export { MachineKind, MachineMetricsSeriesResponse, MachineState, MachineView, MachinesResponse, MetricSample } from '@opengeni/sdk';
 import * as react from 'react';
@@ -488,8 +488,10 @@ declare function unwrapMcpOutput(output: unknown): {
 
 type SessionEventsConnectionState = StreamConnectionState | "idle" | "ended" | "error";
 type UseSessionEventsOptions = ClientOverride & {
-    /** Resume after this sequence (exclusive). Defaults to 0 = full replay. */
+    /** Resume after this sequence (exclusive). Nonzero keeps full replay/resume semantics. */
     after?: number | undefined;
+    /** Load a bounded tail by default, or opt back into full replay from `after`. */
+    replay?: "windowed" | "full" | undefined;
     /** Pause the stream without unmounting (e.g. hidden tab). Defaults to true. */
     enabled?: boolean | undefined;
 };
@@ -503,12 +505,20 @@ type UseSessionEventsResult = {
     connectionState: SessionEventsConnectionState;
     /** Highest sequence seen so far (0 before the first event). */
     lastSequence: number;
+    /** True until the initial tail window has been applied (windowed mode). */
+    initialLoading: boolean;
+    /** Whether older durable events are available before the current window. */
+    hasOlder: boolean;
+    /** True while an older window is being fetched. */
+    loadingOlder: boolean;
+    /** Prepend an older density-bounded window; resolves true when more remain. */
+    loadOlder: () => Promise<boolean>;
     error: Error | null;
 };
 /**
  * Live-stream a session's event log with replay-by-sequence, reconnect, and
- * batched React updates. The SDK guarantees ordered, gap-free, exactly-once
- * delivery; this hook accumulates the log and projects it into a timeline.
+ * batched React updates. Fresh loads default to a bounded tail window; pass
+ * `replay: "full"` or a nonzero `after` for the previous full replay path.
  */
 declare function useSessionEvents(sessionId: string | null | undefined, options?: UseSessionEventsOptions): UseSessionEventsResult;
 
@@ -931,8 +941,9 @@ type UseSessionCapabilitiesOptions = ClientOverride & {
     warmingPollMs?: number | undefined;
     /**
      * Give up waiting for `warm` after this long while polling (ms) and surface a
-     * stalled error with a manual `renegotiate`. Default 30000 (must agree with
-     * the lease warming TTL — I15). 0 disables the deadline.
+     * stalled error with a manual `renegotiate`. Default 30000. This is a UI
+     * patience deadline, independent from the worker's sandbox warming timeout.
+     * 0 disables the deadline.
      */
     warmingDeadlineMs?: number | undefined;
 };
@@ -1599,6 +1610,12 @@ type MessageTimelineProps = {
     toolRegistry?: ToolRegistry | undefined;
     /** Follow new events when pinned to the bottom. Defaults to true. */
     autoFollow?: boolean | undefined;
+    /** Older durable history exists above the current window (see useSessionEvents). */
+    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;
     emptyState?: ReactNode | undefined;
     className?: string | undefined;
 };
@@ -1608,7 +1625,7 @@ type MessageTimelineProps = {
  * cards, goal markers, and status transitions. Owns stick-to-bottom scrolling
  * with a "jump to latest" affordance when the reader scrolls back.
  */
-declare function MessageTimeline({ events, items, status, renderMessageText, onOpenSession, toolRegistry, autoFollow, emptyState, className, }: MessageTimelineProps): react_jsx_runtime.JSX.Element;
+declare function MessageTimeline({ events, items, status, renderMessageText, onOpenSession, toolRegistry, autoFollow, hasOlder, loadingOlder, onLoadOlder, emptyState, className, }: MessageTimelineProps): react_jsx_runtime.JSX.Element;
 /**
  * Render one non-activity timeline item (chat message, status divider, goal
  * landmark, notice). Exported so the component demo draws the EXACT same rows as