@opengeni/react 0.45.0 → 0.48.0

package/dist/client.d.ts

@@ -4,7 +4,7 @@ import type { OpenGeniClient } from "@opengeni/sdk";
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "fsList" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose">;
+export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose">;
 /**
  * Tenant-safe client surface required by the session-only React entry.
  *

package/dist/components/chat-composer.d.ts

@@ -5,11 +5,16 @@ import type { ComposerState } from "../hooks/use-composer";
 import type { UseFileAttachmentsResult } from "../hooks/use-file-attachments";
 import type { SlashCommandContext } from "../hooks/use-slash-commands";
 import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event";
-import { type ChatComposerMessages, type ComposerControlLinks } from "./composer";
+import { type ChatComposerMessages, type ComposerControlLinks, type ResponsiveBasis } from "./composer";
 import { type ComposerTranscriptionControlProps } from "./composer-transcription-control";
 export { OPEN_WORKSTREAM_CONTROL_EVENT };
 export type ChatComposerProps = {
     composer: ComposerState;
+    /**
+     * Measurement surface for responsive chrome. Defaults to the historical
+     * viewport breakpoints; opt into `container` for narrow embedded panels.
+     */
+    responsiveBasis?: ResponsiveBasis | undefined;
     /** Canonical workstream control, separate from lifecycle status. */
     effectiveControl?: EffectiveSessionControl | null | undefined;
     /** Waiting prompts already ahead of a normal Send. */
@@ -59,4 +64,4 @@ export type ChatComposerProps = {
  * the public controller and compound primitives exported by the composer
  * subpath, so custom and default layouts share one behavioral implementation.
  */
-export declare function ChatComposer({ composer, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, placeholder, disabled, autoFocus, hint, controlsLeading, controlsStart, actionsStart, attachButtonClassName, transcription, transcriptionClassName, transcriptionSuppressed, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, messages, }: ChatComposerProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatComposer({ composer, responsiveBasis, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, placeholder, disabled, autoFocus, hint, controlsLeading, controlsStart, actionsStart, attachButtonClassName, transcription, transcriptionClassName, transcriptionSuppressed, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, messages, }: ChatComposerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/composer-transcription-control.d.ts

@@ -5,10 +5,12 @@ export type ComposerTranscriptionMessages = {
     stop: string;
     cancel: string;
     retry: string;
+    pauseRetrying: string;
     requestingPermission: string;
     recording: string;
     saving: string;
     transcribing: string;
+    retrying: string;
     recovered: string;
     recoveredTranscript: string;
     insertRecoveredTranscript: string;

package/dist/components/composer.d.ts

@@ -4,9 +4,11 @@ import type { Notice, SlashCommand } from "../commands/types";
 import type { ComposerState } from "../hooks/use-composer";
 import type { UseFileAttachmentsResult } from "../hooks/use-file-attachments";
 import { type ConfirmState, type SlashCommandContext } from "../hooks/use-slash-commands";
+import { type ResponsiveBasis } from "../lib/composer-responsive-context";
 import type { PickerModelRow } from "../model-policy";
 import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event";
 export { OPEN_WORKSTREAM_CONTROL_EVENT };
+export type { ResponsiveBasis } from "../lib/composer-responsive-context";
 export type ComposerDelivery = Pick<ComposerState, "value" | "setValue" | "send" | "steer" | "sending" | "canSend" | "error" | "clearError">;
 export type ComposerDraftState = Pick<ComposerState, "draftConflict" | "draftSaving" | "resolveDraftConflict" | "restoredResources" | "removeRestoredResource">;
 export type ComposerControlState = Pick<ComposerState, "pause" | "pausing" | "resume" | "resumeScope" | "resuming">;
@@ -227,10 +229,22 @@ export declare function useChatComposer(): ChatComposerContextValue;
 export type ComposerRootProps = Omit<ComponentPropsWithoutRef<"div">, "children"> & {
     controller: ChatComposerController;
     children: ReactNode;
+    /**
+     * Measurement surface for responsive composer chrome. `viewport` preserves
+     * the existing breakpoint behavior; `container` responds to this root's
+     * inline size and also bounds composer-owned portalled menus to it.
+     */
+    responsiveBasis?: ResponsiveBasis | undefined;
 };
 export declare const Root: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children"> & {
     controller: ChatComposerController;
     children: ReactNode;
+    /**
+     * Measurement surface for responsive composer chrome. `viewport` preserves
+     * the existing breakpoint behavior; `container` responds to this root's
+     * inline size and also bounds composer-owned portalled menus to it.
+     */
+    responsiveBasis?: ResponsiveBasis | undefined;
 } & import("react").RefAttributes<HTMLDivElement>>;
 export type ComposerFrameProps = ComponentPropsWithoutRef<"div">;
 export declare const Frame: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/machines/machine-detail.d.ts

@@ -8,7 +8,9 @@ export type MachineDetailProps = {
     onWindowChange: (w: MetricWindow) => void;
     loadingSeries?: boolean | undefined;
     onBack?: (() => void) | undefined;
+    /** Open the workspace-admin removal confirmation for a self-hosted machine. */
+    onRemove?: ((machine: MachineView) => void) | undefined;
     now?: number | undefined;
     className?: string | undefined;
 };
-export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, now, className, }: MachineDetailProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, onRemove, now, className, }: MachineDetailProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/machines-dashboard.d.ts

@@ -15,16 +15,16 @@ export type MachinesDashboardProps = {
     onOpenDetail?: ((machine: MachineView) => void) | undefined;
     /** Shared clock so freshness/relative times render consistently across cards. */
     now?: number | undefined;
-    /** Open the enrollment flow (the "Enroll a machine" CTA). */
+    /** Open the connection flow (the "Connect a machine" CTA). */
     onEnroll?: (() => void) | undefined;
     onRefresh?: (() => void) | undefined;
     className?: string | undefined;
 };
 /**
- * The workspace Machines dashboard: the fleet of selfhosted enrollments + the
+ * The workspace Machines dashboard: the fleet of Connected Machines + the
  * session's managed sandbox, each with its connection-status pill, state badges,
  * latest metrics, and an attach/swap affordance. Renders the empty state (no
- * machines → enroll CTA), a load error, and the populated grid. The component
+ * machines → connect CTA), a load error, and the populated grid. The component
  * is purely presentational — feed it `MachinesResponse` data via `useMachines`.
  */
 export declare function MachinesDashboard({ machines, activeSandboxId, loading, error, onAttach, attachingSandboxId, seriesByMachine, onOpenDetail, now, onEnroll, onRefresh, className, }: MachinesDashboardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,6 @@
 import type { SessionEvent, SessionStatus } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import { type AgentMessageItem, type AuthNeededItem, type TimelineGroup, type TimelineItem, type ToolRegistry, type TurnSummaryOptions, type UserMessageItem } from "../timeline";
+import { type AgentMessageItem, type AuthNeededItem, type TimelineGroup, type TimelineItem, type RetainedScreenshotLoader, type ToolRegistry, type TurnSummaryOptions, type UserMessageItem } from "../timeline";
 export type MessageTimelineProps = {
     /** Raw session events (projected internally) … */
     events?: SessionEvent[] | undefined;
@@ -29,6 +29,12 @@ export type MessageTimelineProps = {
      * a Reconnect button without a handler to run it.
      */
     onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
+    /**
+     * Decide which durable authentication notices this timeline presents.
+     * Defaults to showing every notice. Embedded hosts can suppress notices for
+     * credentials they manage elsewhere without discarding the underlying event.
+     */
+    shouldRenderAuthNeeded?: ((item: AuthNeededItem) => boolean) | undefined;
     /**
      * Resolve a provider domain (from a reconnect card) to a logo URL the host
      * serves itself — the app maps it through its catalog + `catalogAssetUrl`.
@@ -43,6 +49,8 @@ export type MessageTimelineProps = {
      * `createDefaultToolRegistry({ entries })` to add custom tool renderers.
      */
     toolRegistry?: ToolRegistry | undefined;
+    /** Resolve opaque retained screenshot receipts through the authenticated host SDK. */
+    loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
     /**
      * Display name of the session's active compute target (Connected Machine or
      * cloud sandbox). When set, exec_command collapsed previews prefix `on {label}`.
@@ -73,6 +81,8 @@ export type MessageTimelineProps = {
      * scrolls the in-memory window.
      */
     onJumpToLatest?: (() => void | Promise<void>) | undefined;
+    /** Host-owned content appended after timeline groups, such as startup progress. */
+    trailingState?: ReactNode | undefined;
     emptyState?: ReactNode | undefined;
     className?: string | undefined;
 };
@@ -82,7 +92,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, renderMessageText, onOpenSession, onMemoryClick, onReconnect, resolveProviderLogo, toolRegistry, computeLabel, turnSummary, autoFollow, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, emptyState, className, }: MessageTimelineProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageTimeline({ events, items, status: _status, renderMessageText, onOpenSession, onMemoryClick, onReconnect, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, computeLabel, turnSummary, autoFollow, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react/jsx-runtime").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/sandbox-files.d.ts

@@ -3,8 +3,8 @@ import type { UseSandboxGitResult } from "../hooks/use-sandbox-git";
 export type SandboxFilesProps = {
     /** From `useSandboxFiles(...)`. */
     files: UseSandboxFilesResult;
-    /** From `useSandboxGit(...)` — drives the branch/dirty header only. */
-    git: UseSandboxGitResult;
+    /** Compatibility fallback for callers that have not yet adopted `files.gitSummary`. */
+    git?: UseSandboxGitResult | undefined;
     /** @deprecated Diffs live in the dedicated Changes tab now; accepted for
      *  source-compat but unused (the Files surface is a browser + viewer). */
     stagedGit?: UseSandboxGitResult | undefined;

package/dist/components/sandbox-terminal.d.ts

@@ -82,6 +82,35 @@ export type SandboxTerminalProps = {
     onActivate?: (() => void) | undefined;
     className?: string | undefined;
 };
+type XtermLike = {
+    open: (el: HTMLElement) => void;
+    write: (data: string) => void;
+    clear: () => void;
+    onData: (cb: (data: string) => void) => {
+        dispose: () => void;
+    };
+    onResize: (cb: (size: {
+        cols: number;
+        rows: number;
+    }) => void) => {
+        dispose: () => void;
+    };
+    loadAddon: (addon: unknown) => void;
+    dispose: () => void;
+    cols: number;
+    rows: number;
+    options: {
+        theme?: XtermTheme;
+        disableStdin?: boolean;
+        cursorBlink?: boolean;
+        fontFamily?: string;
+        fontSize?: number;
+    };
+};
+/** Clear the transient wake line and put the first live prompt at cell 1,1.
+ * `Terminal.clear()` removes scrollback but deliberately preserves the cursor,
+ * which lets the first PTY frame append to the old wake message. */
+export declare function clearTerminalBootStatus(term: Pick<XtermLike, "write">): void;
 /** Debug seam (dev/evidence only, never a typed public API): a global hook the
  *  screenshot harness reads to probe the settled renderer tier + resolved font
  *  without mounting a real WebGL context in unit tests. */

package/dist/components/sandbox-workspace.d.ts

@@ -57,6 +57,8 @@ export type UseSandboxWorkspaceTabsOptions = ClientOverride & {
     /** Override the source-driven default tab (e.g. a host landing tab id). When
      *  omitted the workbench picks Changes-vs-Files from capture or live Git. */
     initialTab?: string | null | undefined;
+    /** Actually selected dock tab. Inactive data surfaces retain cache but issue no live reads. */
+    activeTab?: string | null | undefined;
     /** Host-routed notifications (mutation errors, desktop-consent failures). The
      *  package never imports a toast library — the host decides how to surface. */
     onNotify?: ((notification: WorkspaceNotification) => void) | undefined;
@@ -109,6 +111,8 @@ export type SandboxWorkspaceProps = ClientOverride & {
     /** Controlled collapsed state for hosts with their own dock toggle. */
     collapsed?: boolean | undefined;
     onCollapsedChange?: ((collapsed: boolean) => void) | undefined;
+    /** Keep the dock's built-in collapse control with controlled collapsed state. */
+    showCollapseControl?: boolean | undefined;
     /** Host navigation shown only in the phone workspace overlay header. */
     mobileLeadingControl?: ReactNode | undefined;
     autoSaveId?: string | undefined;
@@ -121,7 +125,7 @@ export type SandboxWorkspaceProps = ClientOverride & {
  * The whole session workspace, ready to mount: `<SandboxWorkspace>` assembles the
  * capability-gated tabs, pins the machine-state chip in the dock header, and
  * renders the resizable `<WorkspaceDock>`. Wrap the tree in `<OpenGeniProvider>`
- * (client + workspaceId) and import `@opengeni/react/styles.css`; that is the
+ * (client + workspaceId) and import `@opengeni/react/compiled.css`; that is the
  * entire integration (see `docs/embedding-workbench.md`).
  */
 export declare function SandboxWorkspace(props: SandboxWorkspaceProps): ReactNode;

package/dist/components/workspace-dock.d.ts

@@ -17,6 +17,8 @@ export type WorkspaceDockProps = {
     /** Controlled collapsed state for hosts that expose their own dock toggle. */
     collapsed?: boolean | undefined;
     onCollapsedChange?: ((collapsed: boolean) => void) | undefined;
+    /** Keep the built-in collapse control when the host controls collapsed state. */
+    showCollapseControl?: boolean | undefined;
     /** A status accessory pinned to the right of the tab strip, left of the
      *  maximize/collapse controls (e.g. the machine-state chip). Renders in both
      *  the docked header and the full-screen overlay header. */
@@ -32,4 +34,4 @@ export type WorkspaceDockProps = {
     maxSize?: number | undefined;
     className?: string | undefined;
 };
-export declare function WorkspaceDock({ primary, tabs, activeTab, onActiveTabChange, collapsed: collapsedProp, onCollapsedChange, headerAccessory, mobileLeadingControl, autoSaveId, defaultSize, minSize, maxSize, className, }: WorkspaceDockProps): import("react/jsx-runtime").JSX.Element;
+export declare function WorkspaceDock({ primary, tabs, activeTab, onActiveTabChange, collapsed: collapsedProp, onCollapsedChange, showCollapseControl, headerAccessory, mobileLeadingControl, autoSaveId, defaultSize, minSize, maxSize, className, }: WorkspaceDockProps): import("react/jsx-runtime").JSX.Element;

package/dist/composer.d.ts

@@ -7,10 +7,10 @@ export { OPEN_WORKSTREAM_CONTROL_EVENT } from "./workstream-control-event";
 export { BillingClassMark, ModelPolicyPicker, ModelPolicyPickerMenu, PickerAnimatedPage, PickerBackHeader, PickerNavRow, defaultModelPolicyPickerMessages, } from "./components/model-policy-picker";
 export type { ModelPolicyPickerMessages, ModelPolicyPickerProps, } from "./components/model-policy-picker";
 export { Actions, AttachButton, Attachments, CommandPalette, Confirmation, Controls, Footer, Frame, Help, Hint, Input, ModelPicker, PauseButton, PausedState, RestoredResources, Root, SendButton, Status, Surface, defaultChatComposerMessages, useChatComposer, useChatComposerController, } from "./components/composer";
-export type { ChatComposerController, ChatComposerContextValue, ChatComposerMessages, ComposerActionsProps, ComposerAttachButtonProps, ComposerCommandPaletteProps, ComposerControlLinks, ComposerControlState, ComposerControlsProps, ComposerDelivery, ComposerDraftState, ComposerFooterProps, ComposerFrameProps, ComposerHintProps, ComposerInputProps, ComposerModelPickerProps, ComposerPauseButtonProps, ComposerRootProps, ComposerSendButtonProps, ComposerSubmitBlocker, ComposerSubmitMode, ComposerSurfaceProps, UseChatComposerControllerOptions, } from "./components/composer";
+export type { ChatComposerController, ChatComposerContextValue, ChatComposerMessages, ComposerActionsProps, ComposerAttachButtonProps, ComposerCommandPaletteProps, ComposerControlLinks, ComposerControlState, ComposerControlsProps, ComposerDelivery, ComposerDraftState, ComposerFooterProps, ComposerFrameProps, ComposerHintProps, ComposerInputProps, ComposerModelPickerProps, ComposerPauseButtonProps, ComposerRootProps, ComposerSendButtonProps, ComposerSubmitBlocker, ComposerSubmitMode, ComposerSurfaceProps, ResponsiveBasis, UseChatComposerControllerOptions, } from "./components/composer";
 export { ComposerTranscriptionControl } from "./components/composer-transcription-control";
 export type { ComposerTranscriptionControlProps, ComposerTranscriptionMessages, } from "./components/composer-transcription-control";
 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";
 export type { UseVoiceInputOptions, UseVoiceInputResult, VoiceInputStatus, } from "./hooks/use-voice-input";
 export { IndexedDbVoiceRecordingStore, VoiceRecordingChunkConflictError, VoiceRecordingChunkSequenceError, VoiceRecordingNotFoundError, VoiceRecordingOwnedError, VoiceRecordingStorageUnavailableError, createVoiceRecordingManifest, planVoiceRecordingChunkCommit, prepareVoiceRecordingChunk, } from "./voice-recording-store";
-export type { PersistVoiceRecordingChunkInput, PersistVoiceRecordingChunkResult, VoiceRecordingCaptureState, VoiceRecordingChunk, VoiceRecordingChunkUploadState, VoiceRecordingFinalizationState, VoiceRecordingManifest, VoiceRecordingStore, VoiceRecordingTranscriptionState, VoiceRecordingUploadState, } from "./voice-recording-store";
+export type { PersistVoiceRecordingChunkInput, PersistVoiceRecordingChunkResult, VoiceRecordingCaptureState, VoiceRecordingChunk, VoiceRecordingChunkUploadState, VoiceRecordingFinalizationState, VoiceRecordingHandoffMode, VoiceRecordingManifest, VoiceRecordingRecoveryMode, VoiceRecordingStore, VoiceRecordingTranscriptionState, VoiceRecordingUploadState, } from "./voice-recording-store";

package/dist/composer.js

@@ -37,9 +37,9 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-L3EWO3UK.js";
-import "./chunk-HFO4ERGQ.js";
-import "./chunk-EB67J347.js";
+} from "./chunk-NJ7M2B6Z.js";
+import "./chunk-FWXGSNXT.js";
+import "./chunk-KZ73RL76.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -48,12 +48,12 @@ import {
   PickerBackHeader,
   PickerNavRow,
   defaultModelPolicyPickerMessages
-} from "./chunk-EHSYZ4KP.js";
+} from "./chunk-WYA65Y3F.js";
 import "./chunk-EKZH6IDG.js";
 import "./chunk-23EJ676W.js";
-import "./chunk-U3CSCMWA.js";
+import "./chunk-FK6VG4LL.js";
 import "./chunk-LAKLF4PA.js";
-import "./chunk-JB5725BI.js";
+import "./chunk-VZTQ73XT.js";
 import "./chunk-22KP6LR5.js";
 export {
   Actions,

package/dist/hooks/internal.d.ts

@@ -1,5 +1,11 @@
 import type { SessionEvent } from "@opengeni/sdk";
 import type { EmbeddedSessionEventClientLike } from "../client";
+/**
+ * Keep live browser work active while the page is visible, then suspend it
+ * after a short hidden-tab grace period. Returning to the page re-enables the
+ * caller, which must reconcile durable state before resuming live delivery.
+ */
+export declare function usePageLiveActivity(hiddenGraceMs?: number): boolean;
 export type AsyncListState<T> = {
     data: T | null;
     loading: boolean;

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

@@ -63,7 +63,7 @@ export type UseCodexAccountsResult = {
  * The workspace's Codex accounts + the per-workspace active pointer + (when
  * session-scoped) the session pin and last-ran-on account. Composed like
  * `useMachines`: slow polling (the realtime work is done by the
- * `codex.account.switched` / `turn.started` event trigger) + a `pin` mutation.
+ * `codex.account.switched` event trigger) + a `pin` mutation.
  * Dual-consumer safe via the structural `CodexAccountsClientLike` surface.
  */
 export declare function useCodexAccounts(options?: UseCodexAccountsOptions): UseCodexAccountsResult;

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

@@ -1,4 +1,4 @@
-import type { CreateVariableSetRequest, UpdateVariableSetRequest, VariableSet, VariableSetVariableMetadata } from "@opengeni/sdk";
+import type { CreateVariableSetRequest, UpdateVariableSetRequest, VariableSet, VariableSetSecret, VariableSetVariableMetadata } from "@opengeni/sdk";
 import { type ClientOverride } from "../provider";
 export type UseVariableSetsOptions = ClientOverride & {
     pollIntervalMs?: number | undefined;
@@ -12,7 +12,12 @@ export type UseVariableSetsResult = {
     create: (request: CreateVariableSetRequest) => Promise<VariableSet | null>;
     update: (variableSetId: string, request: UpdateVariableSetRequest) => Promise<VariableSet | null>;
     remove: (variableSetId: string) => Promise<boolean>;
-    /** Set/rotate a variable. Values are write-only — reads expose metadata only. */
+    /**
+     * Read one exact value through the dedicated permissioned API. The hook never
+     * puts plaintext in its polled variable-set cache.
+     */
+    readVariable: (variableSetId: string, name: string) => Promise<VariableSetSecret | null>;
+    /** Set/rotate a variable. Generic reads expose metadata only. */
     setVariable: (variableSetId: string, name: string, value: string) => Promise<VariableSetVariableMetadata | null>;
     deleteVariable: (variableSetId: string, name: string) => Promise<boolean>;
     mutating: boolean;
@@ -21,8 +26,9 @@ export type UseVariableSetsResult = {
 };
 /**
  * Variable sets (named, encrypted variable sets attached to sessions
- * and scheduled tasks). Variable values are write-only end to end: this hook
- * never sees a value after it is sent.
+ * and scheduled tasks). Generic reads stay metadata-only. A dedicated,
+ * permissioned method can retrieve one value and returns it directly without
+ * adding plaintext to hook state or polling caches.
  */
 export declare function useVariableSets(options?: UseVariableSetsOptions): UseVariableSetsResult;
 /** @deprecated use UseVariableSetsOptions */

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

@@ -1,3 +1,4 @@
+import type { RemoveEnrollmentRequest, RemoveEnrollmentResponse } from "@opengeni/sdk";
 import { type ClientOverride } from "../provider";
 import type { MachinesResponse, MachineView, MetricSample } from "../types/machines";
 /**
@@ -26,6 +27,8 @@ export type MachinesClientLike = {
     machineMetricsSeries?: (workspaceId: string, enrollmentId: string, options?: {
         window?: "15m" | "1h" | "6h" | "24h";
     }) => Promise<MetricSample[]>;
+    /** POST .../enrollments/:enrollmentId/revoke — workspace-admin removal. */
+    removeEnrollment?: (workspaceId: string, enrollmentId: string, request?: RemoveEnrollmentRequest) => Promise<RemoveEnrollmentResponse>;
     /**
      * POST .../sessions/:sessionId/active-sandbox — swap the session's active
      * sandbox to a machine. The default swap path; the real SDK client provides it.
@@ -60,6 +63,10 @@ export type UseMachinesResult = {
     refresh: () => Promise<void>;
     /** Attach/swap the session's active sandbox to a machine (returns the new pointer). */
     attach: (sandboxId: string) => Promise<boolean>;
+    /** Remove a self-hosted enrollment while retaining history. */
+    remove: (enrollmentId: string, request?: RemoveEnrollmentRequest) => Promise<RemoveEnrollmentResponse | null>;
+    canRemove: boolean;
+    removingEnrollmentId: string | null;
     /** Whether the host wired an attach/swap path (drives the card affordance). */
     canAttach: boolean;
     /** Fetch a downsampled metric series for one enrolled machine. */

package/dist/hooks/use-sandbox-files.d.ts

@@ -48,6 +48,10 @@ export type UseSandboxFilesOptions = ClientOverride & {
     rootPath?: string | undefined;
     /** Hold off the initial list (e.g. panel collapsed). Default true. */
     enabled?: boolean | undefined;
+    /** Pause live reads/invalidation while preserving the last rendered result. */
+    active?: boolean | undefined;
+    /** Repository roots advertised by capabilities, relative to the workspace. */
+    repoPaths?: readonly string[] | undefined;
     /** The lease liveness ("cold" | "warm" | "draining"). The structured FileSystem
      *  capability is advertised even on a COLD box, so the mount-time list can race
      *  the box: it lists before the box is warm, gets an empty/errored result, and
@@ -90,14 +94,29 @@ export type UseSandboxFilesResult = {
     }) => Promise<void>;
     /** Re-list the whole tree from the root. */
     refresh: () => Promise<void>;
+    /** Monotonic invalidation token for open file previews. Advances when an
+     *  external filesystem change or completed agent tool may have changed bytes. */
+    contentRevision?: number | undefined;
     /** Which source the tree is currently served from: the live box, the turn-end
      *  capture (cold/offline), or neither yet. M5's source badge reads this. */
     source: "live" | "capture" | null;
     /** When the served capture was taken (ISO), when `source === "capture"`. */
     capturedAt: string | null;
+    /** Lightweight repository context loaded by the same status request that tints files. */
+    gitSummary?: SandboxFilesGitSummary | null | undefined;
+    /** True only while the initial repository-status overlay is still loading. */
+    gitLoading?: boolean | undefined;
     loading: boolean;
     error: Error | null;
 };
+export type SandboxFilesGitSummary = {
+    branch: string | null;
+    isRepo: boolean;
+    repoCount: number;
+    ahead: number;
+    behind: number;
+    dirtyCount: number;
+};
 /**
  * Project the FileSystem service into a lazy-loaded Pierre tree. The initial
  * list pulls one level (depth 1); `expand(path)` lists a directory's immediate

package/dist/hooks/use-sandbox-git.d.ts

@@ -11,8 +11,14 @@ export type UseSandboxGitOptions = ClientOverride & {
     repoPaths?: readonly string[] | undefined;
     /** Diff the staged index vs HEAD (`--cached`) instead of the working tree. */
     staged?: boolean | undefined;
+    /** Review scope. `branch` compares the current branch with the remote default
+     *  branch, `working` shows uncommitted edits, and `staged` shows the index.
+     *  `staged` above remains as a compatibility alias. */
+    comparison?: SandboxGitComparison | undefined;
     /** Hold off the initial fetch. Default true. */
     enabled?: boolean | undefined;
+    /** Pause live reads/invalidation while preserving the last rendered result. */
+    active?: boolean | undefined;
     /** Lease liveness ("warm" | "draining" | "cold"). When NOT warm, the diff is
      *  served from the capture (cold/offline) instead of a live `gitDiff` RPC. */
     liveness?: string | undefined;
@@ -21,6 +27,7 @@ export type UseSandboxGitOptions = ClientOverride & {
      *  surface in place if the live request is temporarily unavailable. */
     capture?: WorkspaceCaptureManifest | null | undefined;
 };
+export type SandboxGitComparison = "branch" | "working" | "staged";
 /** A Git diff qualified into workspace scope. `repoRoot` is present for the
  *  workspace-wide path and lets review UI group real repositories without
  *  guessing from the first path segment. */

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

@@ -53,7 +53,7 @@ export type UseTranscriptionOptions = {
     disabled?: boolean | undefined;
     createLocalSessionId?: (() => string) | undefined;
     lifecycleTimeouts?: Partial<TranscriptionLifecycleTimeouts> | undefined;
-    /** Receives bounded, redacted diagnostics; this detail is never rendered by the hook. */
+    /** Receives the exact diagnostic emitted by the transcription transport. */
     onDiagnostic?: ((diagnostic: TranscriptionDiagnostic) => void) | undefined;
 };
 export type TranscriptionLifecycleTimeouts = {
@@ -70,4 +70,4 @@ export type UseTranscriptionResult = {
 };
 export declare function useTranscription({ adapter, policy, selection, value, setValue, focusInput, disabled, createLocalSessionId, lifecycleTimeouts, onDiagnostic, }: UseTranscriptionOptions): UseTranscriptionResult;
 export declare function normalizeTranscriptionErrorCode(code: unknown): TranscriptionErrorCode;
-export declare function sanitizeTranscriptionDiagnostic(diagnostic: unknown): TranscriptionDiagnostic;
+export declare function normalizeTranscriptionDiagnostic(diagnostic: unknown): TranscriptionDiagnostic;

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

@@ -1,8 +1,8 @@
-import type { ClientVoiceInputConfig, OpenGeniClient } from "@opengeni/sdk";
+import { type ClientVoiceInputConfig, type OpenGeniClient } from "@opengeni/sdk";
 import { type VoiceRecordingStore } from "../voice-recording-store";
-export type VoiceInputStatus = "idle" | "requesting-permission" | "recording" | "saving" | "transcribing" | "recovered" | "transcript-ready" | "error";
+export type VoiceInputStatus = "idle" | "requesting-permission" | "recording" | "saving" | "transcribing" | "retrying" | "recovered" | "transcript-ready" | "error";
 export type UseVoiceInputOptions = {
-    client: Pick<OpenGeniClient, "transcribeAudio"> | null;
+    client: VoiceInputClient | null;
     workspaceId: string;
     capability: ClientVoiceInputConfig | null;
     enabled: boolean;
@@ -15,7 +15,11 @@ export type UseVoiceInputOptions = {
     createRecordingId?: (() => string) | undefined;
     createOwnerId?: (() => string) | undefined;
     now?: (() => Date) | undefined;
+    /** Test/embed seam. Production uses bounded exponential recovery backoff. */
+    automaticRetryDelayMilliseconds?: number | undefined;
 };
+type ResumableVoiceInputClient = Pick<OpenGeniClient, "createTranscriptionRecording" | "getTranscriptionRecording" | "uploadTranscriptionRecordingChunk" | "finalizeTranscriptionRecording" | "processNextTranscriptionRecordingSegment" | "discardTranscriptionRecording">;
+type VoiceInputClient = Pick<OpenGeniClient, "transcribeAudio"> & Partial<ResumableVoiceInputClient>;
 export type UseVoiceInputResult = {
     status: VoiceInputStatus;
     error: string | null;
@@ -43,4 +47,9 @@ export declare const VOICE_RECORDING_TIMESLICE_MILLISECONDS = 5000;
 export declare const VOICE_RECORDING_OWNER_HEARTBEAT_MILLISECONDS = 5000;
 export declare const VOICE_RECORDING_OWNER_STALE_MILLISECONDS = 30000;
 export declare const VOICE_RECORDING_CLIENT_MAX_DURATION_SECONDS = 600;
-export declare function useVoiceInput({ client, workspaceId, capability, enabled, value, setValue, focusInput, disabled, createRecordingStore, createRecordingId, createOwnerId, now, }: UseVoiceInputOptions): UseVoiceInputResult;
+export declare const VOICE_RECORDING_RESUMABLE_CLIENT_MAX_DURATION_SECONDS: number;
+export declare const VOICE_RECORDING_RECOVERY_STATUS_POLL_MILLISECONDS = 2000;
+export declare const VOICE_RECORDING_RECOVERY_MAX_MUTATION_DELAY_MILLISECONDS = 30000;
+export declare function transcriptionRecoveryMutationDelayMilliseconds(retryAfterMilliseconds: number | undefined, attempt: number, random?: () => number): number;
+export declare function useVoiceInput({ client, workspaceId, capability, enabled, value, setValue, focusInput, disabled, createRecordingStore, createRecordingId, createOwnerId, now, automaticRetryDelayMilliseconds, }: UseVoiceInputOptions): UseVoiceInputResult;
+export {};

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { OpenGeniProvider } from "./provider";
 export type { OpenGeniProviderProps } from "./provider";
 export { useOpenGeni, useOpenGeniClient } from "./session-context";
 export type { ClientOverride, OpenGeniContextValue } from "./session-context";
+export { usePageLiveActivity } from "./hooks/internal";
 export { useSession, isTitleEvent } from "./hooks/use-session";
 export type { UseSessionOptions, UseSessionResult } from "./hooks/use-session";
 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";
@@ -12,7 +13,7 @@ export type { ComposerSendExtras, ComposerState, UseComposerOptions } from "./ho
 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";
 export type { UseVoiceInputOptions, UseVoiceInputResult, VoiceInputStatus, } from "./hooks/use-voice-input";
 export { IndexedDbVoiceRecordingStore, VoiceRecordingChunkConflictError, VoiceRecordingChunkSequenceError, VoiceRecordingNotFoundError, VoiceRecordingOwnedError, VoiceRecordingStorageUnavailableError, createVoiceRecordingManifest, planVoiceRecordingChunkCommit, prepareVoiceRecordingChunk, } from "./voice-recording-store";
-export type { PersistVoiceRecordingChunkInput, PersistVoiceRecordingChunkResult, VoiceRecordingCaptureState, VoiceRecordingChunk, VoiceRecordingChunkUploadState, VoiceRecordingFinalizationState, VoiceRecordingManifest, VoiceRecordingStore, VoiceRecordingTranscriptionState, VoiceRecordingUploadState, } from "./voice-recording-store";
+export type { PersistVoiceRecordingChunkInput, PersistVoiceRecordingChunkResult, VoiceRecordingCaptureState, VoiceRecordingChunk, VoiceRecordingChunkUploadState, VoiceRecordingFinalizationState, VoiceRecordingHandoffMode, VoiceRecordingManifest, VoiceRecordingRecoveryMode, VoiceRecordingStore, VoiceRecordingTranscriptionState, VoiceRecordingUploadState, } from "./voice-recording-store";
 export { COMPOSER_PAYMENT_REQUIRED_MESSAGE, composerSubmissionErrorMessage } from "./lib/format";
 export { INITIAL_TRANSCRIPTION_CONTROL_STATE, appendFinalTranscript, transitionTranscriptionControl, useTranscription, } from "./hooks/use-transcription";
 export type { TranscriptionControlAction, TranscriptionControlState, TranscriptionControlTransition, UseTranscriptionOptions, UseTranscriptionResult, } from "./hooks/use-transcription";
@@ -63,9 +64,9 @@ export type { TerminalStreamStatus, UseTerminalStreamOptions, UseTerminalStreamR
 export { useSandboxTerminal } from "./hooks/use-sandbox-terminal";
 export type { TerminalChunk, UseSandboxTerminalOptions, UseSandboxTerminalResult, } from "./hooks/use-sandbox-terminal";
 export { CapturedFileUnavailableError, FileWriteConflictError, useSandboxFiles, } from "./hooks/use-sandbox-files";
-export type { CapturedFileUnavailableReason, FileTreeNode, FileTreeStatus, SandboxWriteFileOptions, UseSandboxFilesOptions, UseSandboxFilesResult, } from "./hooks/use-sandbox-files";
+export type { CapturedFileUnavailableReason, FileTreeNode, FileTreeStatus, SandboxFilesGitSummary, SandboxWriteFileOptions, UseSandboxFilesOptions, UseSandboxFilesResult, } from "./hooks/use-sandbox-files";
 export { useSandboxGit } from "./hooks/use-sandbox-git";
-export type { SandboxGitFileDiff, UseSandboxGitOptions, UseSandboxGitResult, } from "./hooks/use-sandbox-git";
+export type { SandboxGitComparison, SandboxGitFileDiff, UseSandboxGitOptions, UseSandboxGitResult, } from "./hooks/use-sandbox-git";
 export { useWorkspaceCapture } from "./hooks/use-workspace-capture";
 export type { UseWorkspaceCaptureOptions, UseWorkspaceCaptureResult, } from "./hooks/use-workspace-capture";
 export { useWorkspaceEdit } from "./hooks/use-workspace-edit";
@@ -90,7 +91,7 @@ export { createDefaultToolRegistry, createToolRegistry, defaultToolRegistry, raw
 export type { CreateToolRegistryOptions, ToolRegistry, ToolRegistryEntry, ToolRenderer, ToolRendererProps, } from "./timeline";
 export { ActivityDisclosure, ActivityRail, BodyNote, DisclosureDefaultsProvider, LightboxProvider, MediaEmpty, MediaSkeleton, PayloadBlock, ScreenshotFigure, TermBlock, Thumbnail, TurnSummary, BUILT_IN_TURN_SUMMARY_FACET_IDS, useLightbox, useLightboxOptional, } from "./timeline";
 export type { ActivityDisclosureProps, ActivityRailProps, DisclosureChip, BuiltInTurnSummaryFacetId, TurnOutcome, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, TurnSummaryProps, } from "./timeline";
-export { applyPatchOps, applyPatchOpsFromToolItem, controlCaret, execTruncated, isApplyPatch, isExecSessionLostBanner, looksBinary, parseExecBannerSessionId, parseFreeformApplyPatch, parseToolArgs, redactSecrets, sandboxCommandExitCode, stripExecBanner, tailPeek, unwrapMcpOutput, v4aToGitFileDiff, } from "./timeline";
+export { applyPatchOps, applyPatchOpsFromToolItem, controlCaret, execTruncated, isApplyPatch, isExecSessionLostBanner, looksBinary, parseExecBannerSessionId, parseFreeformApplyPatch, parseToolArgs, sandboxCommandExitCode, stripExecBanner, tailPeek, unwrapMcpOutput, v4aToGitFileDiff, } from "./timeline";
 export type { ApplyPatchOperation } from "./timeline";
 export { argHint, defaultCommands, filterCommands, firstMissingRequiredArg, hasPermission, matchCommand, parseCommandLine, } from "./commands/registry";
 export type { ParsedCommandLine } from "./commands/registry";
@@ -104,7 +105,7 @@ export type { ChatComposerProps } from "./components/chat-composer";
 export { ComposerTranscriptionControl } from "./components/composer-transcription-control";
 export type { ComposerTranscriptionControlProps, ComposerTranscriptionMessages, } from "./components/composer-transcription-control";
 export { defaultChatComposerMessages } from "./components/composer";
-export type { ChatComposerMessages } from "./components/composer";
+export type { ChatComposerMessages, ResponsiveBasis } from "./components/composer";
 export { ModelPicker } from "./components/model-picker";
 export type { ModelPickerProps } from "./components/model-picker";
 export { BillingClassMark, ModelPolicyPicker, ModelPolicyPickerMenu, PickerAnimatedPage, PickerBackHeader, PickerNavRow, defaultModelPolicyPickerMessages, } from "./components/model-policy-picker";