@opengeni/react 0.48.0 → 0.57.0

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

@@ -1,5 +1,5 @@
 import { type SessionCapabilities, type SessionEvent } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
+import { type ClientOverride } from "../provider.js";
 export type SessionCapabilitiesState = "idle" | "negotiating" | "ready" | "cold" | "on-demand" | "error";
 export type UseSessionCapabilitiesOptions = ClientOverride & {
     /**
@@ -59,7 +59,8 @@ export type UseSessionCapabilitiesResult = {
     error: Error | null;
     /**
      * 409 from the desktop attach: the un-redacted (or shared) plane needs explicit
-     * acknowledgment before a viewer holder is granted. Drives the consent prompt.
+     * acknowledgment before a viewer holder is granted. The workbench uses this
+     * to complete acknowledgment automatically while Desktop is opening.
      */
     acknowledgmentRequired: "unredacted" | "shared" | null;
     /** 429 from the desktop attach: the per-session viewer cap is reached. */
@@ -77,7 +78,7 @@ export type UseSessionCapabilitiesResult = {
  *
  * Degradation is a value, never a crash: an unsupported surface comes back
  * `available:false`/`transport:null` + a `reason`; the components render the
- * reason-aware empty state. 409 (consent) and 429 (viewer cap) are surfaced as
- * typed signals, not thrown.
+ * reason-aware empty state. 409 (acknowledgment) and 429 (viewer cap) are
+ * surfaced as typed signals, not thrown.
  */
 export declare function useSessionCapabilities(sessionId: string | null | undefined, options?: UseSessionCapabilitiesOptions): UseSessionCapabilitiesResult;

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

@@ -1,5 +1,5 @@
 import type { SessionControlResponse, SessionEvent } from "@opengeni/sdk";
-import { type EmbeddedSessionClientOverride } from "../session-context";
+import { type EmbeddedSessionClientOverride } from "../session-context.js";
 export type UseSessionControlOptions = EmbeddedSessionClientOverride;
 export type UseSessionControlResult = {
     pause: (reason?: string) => Promise<SessionControlResponse | null>;

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

@@ -1,6 +1,6 @@
 import type { SessionEvent, SessionStatus, StreamConnectionState } from "@opengeni/sdk";
-import { type EmbeddedSessionClientOverride } from "../session-context";
-import type { TimelineItem } from "../timeline/types";
+import { type EmbeddedSessionClientOverride } from "../session-context.js";
+import type { TimelineItem } from "../timeline/types.js";
 export type SessionEventsConnectionState = StreamConnectionState | "idle" | "ended" | "error";
 export type UseSessionEventsOptions = EmbeddedSessionClientOverride & {
     /** Resume after this sequence (exclusive). Nonzero keeps full replay/resume semantics. */

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

@@ -1,5 +1,5 @@
 import type { SessionEvent, SessionLineageResponse } from "@opengeni/sdk";
-import { type EmbeddedSessionLineageClientOverride } from "../session-context";
+import { type EmbeddedSessionLineageClientOverride } from "../session-context.js";
 export type UseSessionLineageOptions = EmbeddedSessionLineageClientOverride & {
     events?: SessionEvent[] | undefined;
     /** Refresh interval (ms). Off by default. */

package/dist/hooks/use-session-mcp-approval-policy.d.ts

@@ -1,6 +1,6 @@
 import type { SessionEvent, SessionMcpApprovalPolicy, SessionMcpServerMetadata, UpdateSessionMcpApprovalPolicyResponse } from "@opengeni/sdk";
-import { type EmbeddedSessionMcpApprovalPolicyClientOverride } from "../session-context";
-import { type SessionEventFeedOptions } from "./internal";
+import { type EmbeddedSessionMcpApprovalPolicyClientOverride } from "../session-context.js";
+import { type SessionEventFeedOptions } from "./internal.js";
 export declare function isSessionMcpApprovalPolicyEvent(event: Pick<SessionEvent, "type" | "payload">, serverId?: string): boolean;
 export type UseSessionMcpApprovalPolicyOptions = EmbeddedSessionMcpApprovalPolicyClientOverride & SessionEventFeedOptions & {
     /** Optional safety-net polling (ms). Off by default; policy events drive refreshes. */

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

@@ -1,6 +1,6 @@
 import type { Session, SessionEvent } from "@opengeni/sdk";
-import { type EmbeddedSessionReadClientOverride } from "../session-context";
-import { type SessionEventFeedOptions } from "./internal";
+import { type EmbeddedSessionReadClientOverride } from "../session-context.js";
+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;

package/dist/hooks/use-site-auth-connections.d.ts

@@ -0,0 +1,25 @@
+import type { CreateSiteAuthConnectionRequest, SiteAuthConnection, SiteAuthConnectionMutationResponse, UpdateSiteAuthConnectionRequest } from "@opengeni/sdk/interaction";
+import type { EmbeddedBrowserInteractionClientLike } from "../client.js";
+import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type UseSiteAuthConnectionsOptions = EmbeddedBrowserInteractionClientOverride & {
+    enabled?: boolean | undefined;
+    includeArchived?: boolean | undefined;
+};
+export type UseSiteAuthConnectionsResult = {
+    revision: number;
+    connections: SiteAuthConnection[];
+    loading: boolean;
+    refreshing: boolean;
+    mutating: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    create: (request: Omit<CreateSiteAuthConnectionRequest, "operationId"> & {
+        operationId?: string;
+    }) => Promise<SiteAuthConnectionMutationResponse>;
+    update: (connectionId: string, request: Omit<UpdateSiteAuthConnectionRequest, "operationId"> & {
+        operationId?: string;
+    }) => Promise<SiteAuthConnectionMutationResponse>;
+};
+/** Secret-free workspace login recipes and their verified health. */
+export declare function useSiteAuthConnections(options?: UseSiteAuthConnectionsOptions): UseSiteAuthConnectionsResult;
+export type SiteAuthConnectionsClient = EmbeddedBrowserInteractionClientLike;

package/dist/hooks/use-slash-commands.d.ts

@@ -1,5 +1,5 @@
 import type { KeyboardEvent } from "react";
-import type { CommandContext, SlashCommand } from "../commands/types";
+import type { CommandContext, SlashCommand } from "../commands/types.js";
 /**
  * Context the composer supplies for command execution and visibility. The
  * composer owns the UI affordances (notice/openHelp/clearView/confirm), so they

package/dist/hooks/use-supergrok-accounts.d.ts

@@ -0,0 +1,26 @@
+import type { SuperGrokAccount, SuperGrokAccountsResponse } from "@opengeni/sdk";
+import { type ClientOverride } from "../provider.js";
+export type SuperGrokAccountsClientLike = {
+    listSuperGrokAccounts: (workspaceId: string) => Promise<SuperGrokAccountsResponse>;
+    activateSuperGrokAccount?: (workspaceId: string, accountId: string) => Promise<{
+        activated: boolean;
+        accountId: string;
+    }>;
+};
+export type UseSuperGrokAccountsOptions = ClientOverride & {
+    enabled?: boolean | undefined;
+    pollIntervalMs?: number | undefined;
+    supergrokClient?: SuperGrokAccountsClientLike | undefined;
+};
+export type UseSuperGrokAccountsResult = {
+    accounts: SuperGrokAccount[];
+    activeAccountId: string | null;
+    settings: SuperGrokAccountsResponse["settings"];
+    loading: boolean;
+    refresh: () => Promise<void>;
+    activate: (accountId: string) => Promise<boolean>;
+    activating: boolean;
+    mutationError: Error | null;
+};
+/** Workspace-visible xAI accounts. Workspace scope is the connection default. */
+export declare function useSuperGrokAccounts(options?: UseSuperGrokAccountsOptions): UseSuperGrokAccountsResult;

package/dist/hooks/use-terminal-stream.d.ts

@@ -6,11 +6,14 @@ export type UseTerminalStreamOptions = {
      *  The stream connects ONLY when `transport === "pty-ws"` and `url` is set; on a
      *  cold box (`transport === "sse-events"` / no url) it stays idle and the caller
      *  falls back to the Channel-A read-only firehose. */
-    capability: Pick<TerminalCapability, "transport" | "url" | "token"> | null;
+    capability: Pick<TerminalCapability, "transport" | "url" | "token" | "expiresAt"> | null;
     /** Called for each OUTPUT payload from ttyd (write verbatim into xterm). */
     onOutput?: ((data: string) => void) | undefined;
     /** Called when ttyd sends a SET_WINDOW_TITLE frame. */
     onTitle?: ((title: string) => void) | undefined;
+    /** Requests a fresh negotiated terminal grant after an unexpected transport
+     * failure. Intentional disconnects and effect cleanup never call it. */
+    onReconnectNeeded?: (() => void) | undefined;
     /** Initial PTY size to seed the ttyd auth frame + first resize. */
     initialCols?: number | undefined;
     initialRows?: number | undefined;
@@ -19,13 +22,19 @@ export type UseTerminalStreamResult = {
     /** True once the ttyd socket is open (and the auth frame has been sent). */
     connected: boolean;
     status: TerminalStreamStatus;
-    /** Pipe a keystroke/paste to the PTY stdin. No-op until the socket is open. */
+    /** Pipe a keystroke/paste to PTY stdin. Input during CONNECTING is bounded and
+     *  replayed only after ttyd authentication succeeds. */
     write: (data: string) => void;
     /** Tell ttyd the PTY window changed size (on xterm fit/resize). */
     resize: (cols: number, rows: number) => void;
     /** Tear the socket down (the effect also tears down on unmount / url change). */
     disconnect: () => void;
 };
+export declare const MAX_PENDING_TERMINAL_INPUT_CODE_UNITS: number;
+/** A bearer must remain valid long enough to finish a new websocket handshake.
+ * Existing open sockets are unaffected: this is evaluated only when the
+ * credential identity changes and the connection effect attempts a new socket. */
+export declare function terminalStreamCredentialUsable(capability: Pick<TerminalCapability, "transport" | "url" | "expiresAt"> | null | undefined, nowMs?: number): boolean;
 /**
  * Drive a ttyd PTY-over-websocket connection from a `pty-ws` Terminal capability,
  * symmetric with `use-desktop-stream` (the noVNC-over-tunnel hook). The scoped

package/dist/hooks/use-turn-queue.d.ts

@@ -1,6 +1,6 @@
 import type { ComposerDraft, EffectiveSessionControl, McpPersonalConnectionSummary, SessionEvent, SessionQueueSnapshot, SessionPendingInputPreview, SessionTurn } from "@opengeni/sdk";
-import { type EmbeddedSessionClientOverride } from "../session-context";
-import { type SessionEventFeedOptions } from "./internal";
+import { type EmbeddedSessionClientOverride } from "../session-context.js";
+import { type SessionEventFeedOptions } from "./internal.js";
 /** Events that can change the authoritative prompt queue or effective control. */
 export declare function isTurnQueueEvent(event: Pick<SessionEvent, "type">): boolean;
 export type QueueMutationKind = "move" | "edit" | "steer" | "delete";

package/dist/hooks/use-video-artifact-playback.d.ts

@@ -0,0 +1,9 @@
+import type { VideoArtifactPlaybackLoader } from "../timeline/index.js";
+import { type ClientOverride } from "../session-context.js";
+/**
+ * Bind the current public SDK client/workspace to MessageTimeline's renewable
+ * video-source boundary. Proxy hosts may omit the method until they support
+ * retained video; the failure remains local to the player instead of loading
+ * any video bytes through React.
+ */
+export declare function useVideoArtifactPlaybackLoader(options?: ClientOverride): VideoArtifactPlaybackLoader;

package/dist/hooks/use-voice-input.d.ts

@@ -1,5 +1,5 @@
 import { type ClientVoiceInputConfig, type OpenGeniClient } from "@opengeni/sdk";
-import { type VoiceRecordingStore } from "../voice-recording-store";
+import { type VoiceRecordingStore } from "../voice-recording-store.js";
 export type VoiceInputStatus = "idle" | "requesting-permission" | "recording" | "saving" | "transcribing" | "retrying" | "recovered" | "transcript-ready" | "error";
 export type UseVoiceInputOptions = {
     client: VoiceInputClient | null;

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

@@ -1,5 +1,5 @@
 import type { SessionEvent, WorkspaceCaptureDegradedReason, WorkspaceCaptureManifest } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
+import { type ClientOverride } from "../provider.js";
 export type UseWorkspaceCaptureOptions = ClientOverride & {
     /** Live event log (usually `useSessionEvents().events`) — a
      *  `workspace.revision.captured` for a NEWER revision refreshes the manifest. */

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

@@ -1,4 +1,4 @@
-import { type ClientOverride } from "../provider";
+import { type ClientOverride } from "../provider.js";
 /**
  * The wake-on-edit state machine. This hook owns the logic and the UI renders
  * its result. States are explicit and exhaustive:

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

@@ -1,5 +1,5 @@
 import type { Session } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
+import { type ClientOverride } from "../provider.js";
 export type UseWorkspaceSessionsOptions = ClientOverride & {
     limit?: number | undefined;
     parentSessionId?: string | null | undefined;

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

@@ -1,5 +1,5 @@
 import type { CreateWorkspaceRequest, UpdateWorkspaceRequest, Workspace } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
+import { type ClientOverride } from "../provider.js";
 export type UseWorkspacesOptions = Pick<ClientOverride, "client"> & {
     pollIntervalMs?: number | undefined;
     enabled?: boolean | undefined;