@opengeni/react 0.48.0 → 0.52.1

package/dist/components/queue-surface-state.d.ts

@@ -1,12 +1,12 @@
-import type { UseTurnQueueResult } from "../hooks/use-turn-queue";
+import type { UseTurnQueueResult } from "../hooks/use-turn-queue.js";
 type QueueStateProps = {
     queue: UseTurnQueueResult;
 };
-export declare function EmptyQueueStateSurface({ queue }: QueueStateProps): import("react/jsx-runtime").JSX.Element;
+export declare function EmptyQueueStateSurface({ queue }: QueueStateProps): import("react").JSX.Element;
 export declare function QueueStoppingStatus({ queue, dividerAfter, }: QueueStateProps & {
     dividerAfter?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function QueueErrorAlert({ queue, dividerBefore, }: QueueStateProps & {
     dividerBefore?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export {};

package/dist/components/queue-surface.d.ts

@@ -1,12 +1,12 @@
 import { type ComponentType } from "react";
-import type { QueueSurfaceProps } from "./queue-surface-implementation";
-export { requestQueueDraftEdit } from "./queue-draft-policy";
-export type { QueueSurfaceProps } from "./queue-surface-implementation";
+import type { QueueSurfaceProps } from "./queue-surface-implementation.js";
+export { requestQueueDraftEdit } from "./queue-draft-policy.js";
+export type { QueueSurfaceProps } from "./queue-surface-implementation.js";
 type QueueSurfaceModule = {
     QueueSurface: ComponentType<QueueSurfaceProps>;
 };
 type QueueSurfaceLoader = () => Promise<QueueSurfaceModule>;
 /** The sole pending-input surface: compact above Goal, Agents, and composer. */
-export declare const QueueSurface: (props: QueueSurfaceProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const QueueSurface: (props: QueueSurfaceProps) => import("react").JSX.Element | null;
 /** @internal Deterministic Suspense seam for the QueueSurface regression suite. */
-export declare function createQueueSurfaceForTest(loadImplementation: QueueSurfaceLoader): (props: QueueSurfaceProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare function createQueueSurfaceForTest(loadImplementation: QueueSurfaceLoader): (props: QueueSurfaceProps) => import("react").JSX.Element | null;

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

@@ -1,5 +1,5 @@
-import { type UseSandboxFilesResult } from "../hooks/use-sandbox-files";
-import type { UseSandboxGitResult } from "../hooks/use-sandbox-git";
+import { type UseSandboxFilesResult } from "../hooks/use-sandbox-files.js";
+import type { UseSandboxGitResult } from "../hooks/use-sandbox-git.js";
 export type SandboxFilesProps = {
     /** From `useSandboxFiles(...)`. */
     files: UseSandboxFilesResult;
@@ -46,4 +46,4 @@ export type SandboxFilesProps = {
  * surface deliberately does NOT replicate the changed-files list, and does not
  * diff here — one job per tab). The agent commits; the human reviews.
  */
-export declare function SandboxFiles({ files, git, fileSystemAvailable, usePierre, editable, onEditIntent, requestedPath, requestedPathRequestId, requestedPathReady, workspaceResting, workspaceWaking, liveWorkspaceReady, onWakeWorkspace, themeType, className, }: SandboxFilesProps): import("react/jsx-runtime").JSX.Element;
+export declare function SandboxFiles({ files, git, fileSystemAvailable, usePierre, editable, onEditIntent, requestedPath, requestedPathRequestId, requestedPathReady, workspaceResting, workspaceWaking, liveWorkspaceReady, onWakeWorkspace, themeType, className, }: SandboxFilesProps): import("react").JSX.Element;

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

@@ -1,7 +1,8 @@
 import type { TerminalCapability } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import type { UseSandboxTerminalResult } from "../hooks/use-sandbox-terminal";
-import { type RendererTier } from "../lib/xterm-renderer";
+import { type TerminalStreamStatus } from "../hooks/use-terminal-stream.js";
+import type { UseSandboxTerminalResult } from "../hooks/use-sandbox-terminal.js";
+import { type RendererTier } from "../lib/xterm-renderer.js";
 /**
  * A COMPLETE xterm `ITheme` (subset by intent, but every field xterm colors a
  * cell with is present so it never falls back to its stock VGA palette). Built
@@ -55,7 +56,7 @@ export type SandboxTerminalProps = {
     fontSize?: number | undefined;
     /**
      * Lease liveness (`cold` | `warming` | `warm` | `draining`). Drives the
-     * boot-in-terminal status lines: once the user has focused the terminal and
+     * boot-in-terminal status lines: once the user has engaged the terminal and
      * the box is not yet warm, a styled "● waking machine — Ns…" line is rendered
      * INSIDE xterm (no overlay/spinner) until the live PTY connects.
      */
@@ -107,6 +108,22 @@ type XtermLike = {
         fontSize?: number;
     };
 };
+export type TerminalSurfaceState = "loading" | "connecting" | "error" | "waking" | "output-only" | "interactive";
+/**
+ * Stable semantic state for hosts and browser acceptance. The xterm helper
+ * textarea exists before the live PTY socket is ready, so its presence alone
+ * must never be treated as proof that keystrokes can reach the sandbox.
+ */
+export declare function terminalSurfaceState(input: {
+    ready: boolean;
+    acceptsInput: boolean;
+    inputPending: boolean;
+    ptyStatus: TerminalStreamStatus;
+    booting: boolean;
+}): TerminalSurfaceState;
+export declare function subscribeTerminalInput(term: Pick<XtermLike, "onData"> | null, sink: ((data: string) => void) | null, enabled: boolean): {
+    dispose: () => void;
+} | null;
 /** 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. */
@@ -148,5 +165,5 @@ declare global {
  * Resizes are tracked with a `ResizeObserver` on the container (not just
  * `window.resize`) so dragging the dock handle refits the grid.
  */
-export declare function SandboxTerminal({ result, terminalCapability, theme, fontFamily, fontSize, liveness, readOnly, placeholder, showHeader, shell, onActivate, className, }: SandboxTerminalProps): import("react/jsx-runtime").JSX.Element;
+export declare function SandboxTerminal({ result, terminalCapability, theme, fontFamily, fontSize, liveness, readOnly, placeholder, showHeader, shell, onActivate, className, }: SandboxTerminalProps): import("react").JSX.Element;
 export {};

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

@@ -1,9 +1,11 @@
 import { type ReactNode } from "react";
 import type { SessionEvent } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
-import { type MachineChip } from "../hooks/use-machine-chip";
-import type { MachineView } from "../types/machines";
-import { type WorkspaceDockProps, type WorkspaceTab } from "./workspace-dock";
+import { type ClientOverride } from "../provider.js";
+import type { BrowserFrameWebSocketFactory } from "../hooks/use-browser-frame-stream.js";
+import type { ComputerFrameWebSocketFactory } from "../hooks/use-computer-frame-stream.js";
+import { type MachineChip } from "../hooks/use-machine-chip.js";
+import type { MachineView } from "../types/machines.js";
+import { type WorkspaceDockProps, type WorkspaceTab } from "./workspace-dock.js";
 /** A host-routed notification (replaces the app-only `sonner` toast coupling). */
 export type WorkspaceNotification = {
     kind: "error" | "info";
@@ -13,13 +15,14 @@ export type WorkspaceNotification = {
 export declare const WORKBENCH_TAB_CHANGES = "changes";
 export declare const WORKBENCH_TAB_FILES = "files";
 export declare const WORKBENCH_TAB_TERMINAL = "terminal";
+export declare const WORKBENCH_TAB_BROWSER = "browser";
 export declare const WORKBENCH_TAB_DESKTOP = "desktop";
 /**
  * The built-in workbench surfaces in their canonical display order. Hosts can
  * pass a subset through `surfaces`; omission preserves the complete standalone
  * workbench.
  */
-export declare const WORKBENCH_SURFACES: readonly ["changes", "files", "terminal", "desktop"];
+export declare const WORKBENCH_SURFACES: readonly ["changes", "files", "terminal", "browser", "desktop"];
 export type SandboxWorkspaceSurface = (typeof WORKBENCH_SURFACES)[number];
 /**
  * Decide a workspace tab from an already-local event log: the newest
@@ -49,7 +52,7 @@ export type UseSandboxWorkspaceTabsOptions = ClientOverride & {
     /** Live event log (usually `useSessionEvents().events`). */
     events: SessionEvent[];
     /**
-     * Built-in surfaces this host wants to expose. Omit for all four. A disabled
+     * Built-in surfaces this host wants to expose. Omit for all five. A disabled
      * surface is behaviorally dormant: its data hooks, warm intents, stream
      * attachment, and navigation callbacks are not activated.
      */
@@ -62,6 +65,10 @@ export type UseSandboxWorkspaceTabsOptions = ClientOverride & {
     /** 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;
+    /** Alternate frame transport for non-browser runtimes and deterministic tests. */
+    browserWebSocketFactory?: BrowserFrameWebSocketFactory | undefined;
+    /** Alternate Computer frame transport for non-browser runtimes and deterministic tests. */
+    computerWebSocketFactory?: ComputerFrameWebSocketFactory | undefined;
     /** File requested by a Changes guard. The Files surface defers the read until
      *  the sandbox is live, then reveals this path. */
     requestedFilePath?: string | null | undefined;
@@ -70,9 +77,13 @@ export type UseSandboxWorkspaceTabsOptions = ClientOverride & {
     requestedFileRequestId?: string | number | null | undefined;
     /** Route a guarded diff into the host's Files tab. */
     onOpenFile?: ((path: string) => void) | undefined;
+    /** Navigate the host dock to one exact linked ComputerSession. */
+    onOpenComputerSession?: ((computerSessionId: string) => void) | undefined;
+    requestedComputerSessionId?: string | null | undefined;
+    requestedComputerRequestId?: string | number | null | undefined;
 };
 export type UseSandboxWorkspaceTabsResult = {
-    /** Changes | Files | Terminal | Desktop (capability-gated where noted). */
+    /** Changes | Files | Terminal | Browser | Desktop (capability-gated where noted). */
     tabs: WorkspaceTab[];
     /** The source-driven default tab: Changes when the first authoritative capture
      *  or live Git result has changes, else Files (a host `initialTab` overrides).
@@ -85,7 +96,8 @@ export type UseSandboxWorkspaceTabsResult = {
 /**
  * Build the workbench tabs + the machine-chip model for one session. This is the
  * dock "brain": capability negotiation, capture-backed cold reads, prewarm
- * flags, desktop consent, and the xterm theme observer — all package-local.
+ * flags, automatic desktop acknowledgment, and the xterm theme observer — all
+ * package-local.
  */
 export declare function useSandboxWorkspaceTabs(options: UseSandboxWorkspaceTabsOptions): UseSandboxWorkspaceTabsResult;
 export type SandboxWorkspaceProps = ClientOverride & {
@@ -96,7 +108,7 @@ export type SandboxWorkspaceProps = ClientOverride & {
     primary: ReactNode;
     /**
      * Built-in surfaces this host wants to expose. Omit for Changes, Files,
-     * Terminal, and Desktop. Disabled surfaces remain behaviorally dormant.
+     * Terminal, Browser, and Desktop. Disabled surfaces remain behaviorally dormant.
      */
     surfaces?: readonly SandboxWorkspaceSurface[] | undefined;
     /** Host tabs injected BEFORE the workbench tabs (e.g. a "Run" landing tab). */
@@ -108,6 +120,10 @@ export type SandboxWorkspaceProps = ClientOverride & {
     initialTab?: string | undefined;
     /** Host-routed notifications (no toast dependency in the package). */
     onNotify?: ((notification: WorkspaceNotification) => void) | undefined;
+    /** Alternate Browser frame transport for non-browser runtimes and deterministic tests. */
+    browserWebSocketFactory?: BrowserFrameWebSocketFactory | undefined;
+    /** Alternate Computer frame transport for non-browser runtimes and deterministic tests. */
+    computerWebSocketFactory?: ComputerFrameWebSocketFactory | undefined;
     /** Controlled collapsed state for hosts with their own dock toggle. */
     collapsed?: boolean | undefined;
     onCollapsedChange?: ((collapsed: boolean) => void) | undefined;

package/dist/components/session-chrome.d.ts

@@ -33,9 +33,9 @@
  */
 import type { SessionGoal } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import type { ComposerState } from "../hooks/use-composer";
-import type { UseGoalResult } from "../hooks/use-goal";
-import type { UseTurnQueueResult } from "../hooks/use-turn-queue";
+import type { ComposerState } from "../hooks/use-composer.js";
+import type { UseGoalResult } from "../hooks/use-goal.js";
+import type { UseTurnQueueResult } from "../hooks/use-turn-queue.js";
 export type SessionChromeSignalId = "incoming" | "steering" | "queue" | "goal" | "agents";
 export type SessionChromeSignalTone = "neutral" | "accent" | "waiting" | "running";
 export type SessionChromeAgentsSignal = {
@@ -67,5 +67,5 @@ export type SessionChromeProps = {
 type GoalPillState = "pursuing" | "scheduled" | "blocked" | "held" | "paused" | "invariant_broken" | "completed";
 /** Select pill state from the goal's authoritative continuation projection. */
 export declare function sessionChromeGoalPillState(goalStatus: "active" | "paused" | "completed", continuation: SessionGoal["continuation"] | null | undefined): GoalPillState;
-export declare function SessionChrome({ queue, composer, goal, agentsPanel, agentsSignal, onDismissIncoming, readOnly, className, active: activeControlled, defaultActive, onActiveChange, }: SessionChromeProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SessionChrome({ queue, composer, goal, agentsPanel, agentsSignal, onDismissIncoming, readOnly, className, active: activeControlled, defaultActive, onActiveChange, }: SessionChromeProps): import("react").JSX.Element | null;
 export {};

package/dist/components/session-status.d.ts

@@ -16,10 +16,10 @@ export type SessionStatusProps = {
     className?: string | undefined;
 };
 /** Status badge with a breathing dot for live states. */
-export declare function SessionStatus({ status, label, size, className }: SessionStatusProps): import("react/jsx-runtime").JSX.Element;
+export declare function SessionStatus({ status, label, size, className }: SessionStatusProps): import("react").JSX.Element;
 export type StatusDotProps = {
     status: SessionStatusValue;
     className?: string | undefined;
 };
 /** Just the dot — for dense rows and tiles. */
-export declare function StatusDot({ status, className }: StatusDotProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusDot({ status, className }: StatusDotProps): import("react").JSX.Element;

package/dist/components/timeline-annotation-selection.d.ts

@@ -0,0 +1,9 @@
+import type { DraftTimelineAnnotation } from "@opengeni/sdk";
+import { type RefObject } from "react";
+import type { TimelineAnnotationSourceDescriptor } from "../timeline/index.js";
+export declare function TimelineAnnotationSelection({ rootRef, sources, onAnnotate, }: {
+    rootRef: RefObject<HTMLElement | null>;
+    sources: ReadonlyMap<string, TimelineAnnotationSourceDescriptor>;
+    onAnnotate?: ((annotation: DraftTimelineAnnotation) => void) | undefined;
+}): import("react").ReactPortal | null;
+export default TimelineAnnotationSelection;

package/dist/components/timeline-annotations-dialog.d.ts

@@ -0,0 +1,16 @@
+import type { TimelineAnnotationSource } from "@opengeni/sdk";
+import { type RefObject } from "react";
+import type { TimelineAnnotationLike } from "./timeline-annotations.js";
+export declare function TimelineAnnotationsDialog({ annotations, editable, focusAnnotationId, onFocusConsumed, onUpdate, onRemove, onRevealSource, triggerRef, countLabel, onDismiss, }: {
+    annotations: readonly TimelineAnnotationLike[];
+    editable: boolean;
+    focusAnnotationId?: string | null | undefined;
+    onFocusConsumed?: (() => void) | undefined;
+    onUpdate?: ((id: string, note: string) => void) | undefined;
+    onRemove?: ((id: string) => void) | undefined;
+    onRevealSource?: ((source: TimelineAnnotationSource) => boolean) | undefined;
+    triggerRef: RefObject<HTMLButtonElement | null>;
+    countLabel: string;
+    onDismiss: (restoreFocus: boolean) => void;
+}): import("react").ReactPortal | null;
+export default TimelineAnnotationsDialog;

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

@@ -0,0 +1,13 @@
+import type { DraftTimelineAnnotation, TimelineAnnotation, TimelineAnnotationSource } from "@opengeni/sdk";
+export type TimelineAnnotationLike = DraftTimelineAnnotation | TimelineAnnotation;
+export declare function TimelineAnnotationsChip({ annotations, editable, focusAnnotationId, onFocusConsumed, onUpdate, onRemove, onRevealSource, className, }: {
+    annotations: readonly TimelineAnnotationLike[];
+    editable?: boolean | undefined;
+    focusAnnotationId?: string | null | undefined;
+    onFocusConsumed?: (() => void) | undefined;
+    onUpdate?: ((id: string, note: string) => void) | undefined;
+    onRemove?: ((id: string) => void) | undefined;
+    onRevealSource?: ((source: TimelineAnnotationSource) => boolean) | undefined;
+    className?: string | undefined;
+}): import("react").JSX.Element | null;
+export default TimelineAnnotationsChip;

package/dist/components/tooltip.d.ts

@@ -9,8 +9,8 @@
  */
 import { Tooltip as TooltipPrimitive } from "radix-ui";
 import { type ComponentProps } from "react";
-declare function TooltipProvider({ delayDuration, ...props }: ComponentProps<typeof TooltipPrimitive.Provider>): import("react/jsx-runtime").JSX.Element;
-declare function Tooltip({ children, ...props }: ComponentProps<typeof TooltipPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
-declare function TooltipTrigger({ asChild, ...props }: ComponentProps<typeof TooltipPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
-declare function TooltipContent({ className, sideOffset, children, style, ...props }: ComponentProps<typeof TooltipPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+declare function TooltipProvider({ delayDuration, ...props }: ComponentProps<typeof TooltipPrimitive.Provider>): import("react").JSX.Element;
+declare function Tooltip({ children, ...props }: ComponentProps<typeof TooltipPrimitive.Root>): import("react").JSX.Element;
+declare function TooltipTrigger({ asChild, ...props }: ComponentProps<typeof TooltipPrimitive.Trigger>): import("react").JSX.Element;
+declare function TooltipContent({ className, sideOffset, children, style, ...props }: ComponentProps<typeof TooltipPrimitive.Content>): import("react").JSX.Element;
 export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger };

package/dist/components/user-message-body.d.ts

@@ -7,7 +7,7 @@ export type UserMessageDisclosureContextValue = {
 export declare function UserMessageDisclosureProvider({ value, children, }: {
     value: UserMessageDisclosureContextValue;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 /**
  * Deterministic first-paint fallback for runtimes without layout measurement.
  * Real browsers replace this estimate with the rendered-height decision in the
@@ -32,5 +32,5 @@ export type UserMessageBodyProps = {
  * remembers expansion per durable message id and preserves the reader's scroll
  * anchor when height changes.
  */
-export declare function UserMessageBody({ messageId, text, children, className }: UserMessageBodyProps): import("react/jsx-runtime").JSX.Element;
+export declare function UserMessageBody({ messageId, text, children, className }: UserMessageBodyProps): import("react").JSX.Element;
 export {};

package/dist/components/workbench-changes.d.ts

@@ -1,4 +1,4 @@
-import type { SandboxGitFileDiff } from "../hooks/use-sandbox-git";
+import type { SandboxGitFileDiff } from "../hooks/use-sandbox-git.js";
 export type WorkbenchChangesProps = {
     /** The changed files (`useSandboxGit().diff`). Assumed non-empty by the caller. */
     diff: SandboxGitFileDiff[];
@@ -30,5 +30,5 @@ export declare function buildRail(files: SandboxGitFileDiff[]): {
     rows: RailRow[];
     grouped: boolean;
 };
-export declare function WorkbenchChanges({ diff, source, capturedAt, captureRevision, themeType, onOpenFile, className, }: WorkbenchChangesProps): import("react/jsx-runtime").JSX.Element;
+export declare function WorkbenchChanges({ diff, source, capturedAt, captureRevision, themeType, onOpenFile, className, }: WorkbenchChangesProps): import("react").JSX.Element;
 export {};

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

@@ -34,4 +34,4 @@ export type WorkspaceDockProps = {
     maxSize?: number | undefined;
     className?: string | undefined;
 };
-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;
+export declare function WorkspaceDock({ primary, tabs, activeTab, onActiveTabChange, collapsed: collapsedProp, onCollapsedChange, showCollapseControl, headerAccessory, mobileLeadingControl, autoSaveId, defaultSize, minSize, maxSize, className, }: WorkspaceDockProps): import("react").JSX.Element;

package/dist/composer.d.ts

@@ -3,14 +3,14 @@
  *
  * `import * as Composer from "@opengeni/react/composer"`.
  */
-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, 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, VoiceRecordingHandoffMode, VoiceRecordingManifest, VoiceRecordingRecoveryMode, VoiceRecordingStore, VoiceRecordingTranscriptionState, VoiceRecordingUploadState, } from "./voice-recording-store";
+export { OPEN_WORKSTREAM_CONTROL_EVENT } from "./workstream-control-event.js";
+export { BillingClassMark, ModelPolicyPicker, ModelPolicyPickerMenu, PickerAnimatedPage, PickerBackHeader, PickerNavRow, defaultModelPolicyPickerMessages, } from "./components/model-policy-picker.js";
+export type { ModelPolicyPickerMessages, ModelPolicyPickerProps, } from "./components/model-policy-picker.js";
+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.js";
+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.js";
+export { ComposerTranscriptionControl } from "./components/composer-transcription-control.js";
+export type { ComposerTranscriptionControlProps, ComposerTranscriptionMessages, } from "./components/composer-transcription-control.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";
+export type { UseVoiceInputOptions, UseVoiceInputResult, VoiceInputStatus, } from "./hooks/use-voice-input.js";
+export { IndexedDbVoiceRecordingStore, VoiceRecordingChunkConflictError, VoiceRecordingChunkSequenceError, VoiceRecordingNotFoundError, VoiceRecordingOwnedError, VoiceRecordingStorageUnavailableError, createVoiceRecordingManifest, planVoiceRecordingChunkCommit, prepareVoiceRecordingChunk, } from "./voice-recording-store.js";
+export type { PersistVoiceRecordingChunkInput, PersistVoiceRecordingChunkResult, VoiceRecordingCaptureState, VoiceRecordingChunk, VoiceRecordingChunkUploadState, VoiceRecordingFinalizationState, VoiceRecordingHandoffMode, VoiceRecordingManifest, VoiceRecordingRecoveryMode, VoiceRecordingStore, VoiceRecordingTranscriptionState, VoiceRecordingUploadState, } from "./voice-recording-store.js";

package/dist/composer.js

@@ -37,9 +37,7 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-NJ7M2B6Z.js";
-import "./chunk-FWXGSNXT.js";
-import "./chunk-KZ73RL76.js";
+} from "./chunk-ROIRTM37.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -49,11 +47,13 @@ import {
   PickerNavRow,
   defaultModelPolicyPickerMessages
 } from "./chunk-WYA65Y3F.js";
-import "./chunk-EKZH6IDG.js";
 import "./chunk-23EJ676W.js";
 import "./chunk-FK6VG4LL.js";
-import "./chunk-LAKLF4PA.js";
 import "./chunk-VZTQ73XT.js";
+import "./chunk-724BW4TW.js";
+import "./chunk-LAKLF4PA.js";
+import "./chunk-KZ73RL76.js";
+import "./chunk-HDBG7XGO.js";
 import "./chunk-22KP6LR5.js";
 export {
   Actions,

package/dist/hooks/internal.d.ts

@@ -1,5 +1,5 @@
 import type { SessionEvent } from "@opengeni/sdk";
-import type { EmbeddedSessionEventClientLike } from "../client";
+import type { EmbeddedSessionEventClientLike } from "../client.js";
 /**
  * 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

package/dist/hooks/use-attached-browsers.d.ts

@@ -0,0 +1,21 @@
+import type { AttachedBrowserDevice } from "@opengeni/sdk/interaction";
+import type { EmbeddedBrowserInteractionClientLike } from "../client.js";
+import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type UseAttachedBrowsersOptions = EmbeddedBrowserInteractionClientOverride & {
+    enabled?: boolean | undefined;
+    includeDisconnected?: boolean | undefined;
+    pollIntervalMs?: number | undefined;
+};
+export type UseAttachedBrowsersResult = {
+    revision: number;
+    devices: AttachedBrowserDevice[];
+    loading: boolean;
+    refreshing: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
+/** Workspace-wide inventory of Chrome profiles currently connected through an
+ * enrolled OpenGeni machine. BrowserSessions remain the execution authority. */
+export declare function useAttachedBrowsers(options?: UseAttachedBrowsersOptions): UseAttachedBrowsersResult;
+/** Exported for narrow proxy implementations and tests. */
+export type AttachedBrowsersClient = EmbeddedBrowserInteractionClientLike;

package/dist/hooks/use-available-models.d.ts

@@ -1,6 +1,6 @@
 import type { WorkspaceModelCatalogModel } from "@opengeni/sdk";
-import { type PickerModelRow } from "../model-policy";
-import { type ClientOverride } from "../provider";
+import { type PickerModelRow } from "../model-policy.js";
+import { type ClientOverride } from "../provider.js";
 export type UseAvailableModelsOptions = Pick<ClientOverride, "client"> & {
     /** Refresh interval (ms). Off by default — the host model list rarely moves. */
     pollIntervalMs?: number | undefined;

package/dist/hooks/use-billing-usage.d.ts

@@ -1,5 +1,5 @@
 import type { BillingBalance, UsageEvent } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
+import { type ClientOverride } from "../provider.js";
 export type UseBillingUsageOptions = Pick<ClientOverride, "client"> & {
     /** Account to read. Defaults to the caller's default account server-side. */
     accountId?: string | undefined;

package/dist/hooks/use-browser-frame-stream.d.ts

@@ -0,0 +1,28 @@
+import { type BrowserFrame, type BrowserFrameStreamOptions, type BrowserSessionAttachment } from "@opengeni/sdk/interaction";
+import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type BrowserFrameConnectionState = "idle" | "attaching" | "connecting" | "live" | "reconnecting" | "error";
+export type BrowserFrameWebSocket = Pick<WebSocket, "binaryType" | "readyState" | "close" | "addEventListener" | "removeEventListener"> & {
+    send(data: ArrayBuffer): void;
+};
+export type BrowserFrameWebSocketFactory = (url: string, protocols: string[]) => BrowserFrameWebSocket;
+export type UseBrowserFrameStreamOptions = EmbeddedBrowserInteractionClientOverride & {
+    browserSessionId: string | null;
+    targetId: string | null;
+    enabled?: boolean | undefined;
+    stream?: BrowserFrameStreamOptions | undefined;
+    webSocketFactory?: BrowserFrameWebSocketFactory | undefined;
+};
+export type UseBrowserFrameStreamResult = {
+    state: BrowserFrameConnectionState;
+    frame: BrowserFrame | null;
+    attachment: Pick<BrowserSessionAttachment, "browserSessionId" | "controllerGeneration" | "targetId" | "expiresAt"> | null;
+    error: Error | null;
+    reconnect: () => void;
+};
+/**
+ * Reconnecting, latest-only BrowserSession media attachment. Direct placement
+ * grants travel as a WebSocket subprotocol; connected-machine grants stay in the
+ * relay's first authenticated binary message. Neither transport puts a grant in
+ * a URL, event, log, or separately exposed React state.
+ */
+export declare function useBrowserFrameStream(options: UseBrowserFrameStreamOptions): UseBrowserFrameStreamResult;

package/dist/hooks/use-browser-identities.d.ts

@@ -0,0 +1,26 @@
+import type { BrowserIdentity, BrowserIdentityMutationResponse, BrowserRevisionListResponse, CreateBrowserIdentityRequest, PublishBrowserRevisionRequest, PublishBrowserRevisionResponse } from "@opengeni/sdk/interaction";
+import type { EmbeddedBrowserInteractionClientLike } from "../client.js";
+import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type UseBrowserIdentitiesOptions = EmbeddedBrowserInteractionClientOverride & {
+    enabled?: boolean | undefined;
+};
+export type UseBrowserIdentitiesResult = {
+    revision: number;
+    identities: BrowserIdentity[];
+    loading: boolean;
+    refreshing: boolean;
+    mutating: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    create: (request: Omit<CreateBrowserIdentityRequest, "operationId"> & {
+        operationId?: string;
+    }) => Promise<BrowserIdentityMutationResponse>;
+    revisions: (identityId: string) => Promise<BrowserRevisionListResponse>;
+    publish: (browserSessionId: string, request: Omit<PublishBrowserRevisionRequest, "operationId"> & {
+        operationId?: string;
+    }) => Promise<PublishBrowserRevisionResponse>;
+};
+/** Workspace browser-profile library and explicit immutable-version mutations. */
+export declare function useBrowserIdentities(options?: UseBrowserIdentitiesOptions): UseBrowserIdentitiesResult;
+/** Exported for narrow proxy implementations and tests. */
+export type BrowserIdentitiesClient = EmbeddedBrowserInteractionClientLike;

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

@@ -0,0 +1,28 @@
+import type { BrowserAction, BrowserActionBatch, BrowserActionReceipt, BrowserDiagnosticBatch, BrowserDiagnosticsOptions, BrowserFrame, BrowserObservation, BrowserSession, BrowserTarget } from "@opengeni/sdk/interaction";
+import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type UseBrowserSessionOptions = EmbeddedBrowserInteractionClientOverride & {
+    browserSessionId: string | null;
+    enabled?: boolean | undefined;
+    pollIntervalMs?: number | undefined;
+};
+export type UseBrowserSessionResult = {
+    session: BrowserSession | null;
+    targets: BrowserTarget[];
+    selectedTarget: BrowserTarget | null;
+    observation: BrowserObservation | null;
+    loading: boolean;
+    mutating: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    selectTarget: (targetId: string) => Promise<BrowserTarget>;
+    openTarget: (url?: string) => Promise<BrowserTarget>;
+    closeTarget: (targetId: string) => Promise<void>;
+    act: (action: BrowserAction | BrowserActionBatch, operationId?: string) => Promise<BrowserActionReceipt>;
+    /** Dispatch input against the exact image a human saw. Stale images fail at
+     *  the controller fence instead of targeting a newer page. */
+    actFromFrame: (action: BrowserAction | BrowserActionBatch, frame: BrowserFrame, operationId?: string) => Promise<BrowserActionReceipt>;
+    diagnostics: (options?: BrowserDiagnosticsOptions) => Promise<BrowserDiagnosticBatch>;
+};
+/** Selected BrowserSession control state. All human actions use the same
+ *  generation-fenced controller operation stream as agent actions. */
+export declare function useBrowserSession(options: UseBrowserSessionOptions): UseBrowserSessionResult;

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

@@ -0,0 +1,32 @@
+import type { BrowserSession, BrowserSessionMutationResponse, CreateBrowserSessionRequest } from "@opengeni/sdk/interaction";
+import type { EmbeddedBrowserInteractionClientLike } from "../client.js";
+import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type UseBrowserSessionsOptions = EmbeddedBrowserInteractionClientOverride & {
+    /** Current agent/session relevance. Workspace peers remain in `sessions`. */
+    sessionId?: string | undefined;
+    enabled?: boolean | undefined;
+    /** Temporary invalidation path until the interaction event stream lands. */
+    pollIntervalMs?: number | undefined;
+};
+export type UseBrowserSessionsResult = {
+    revision: number;
+    sessions: BrowserSession[];
+    relevantSessions: BrowserSession[];
+    loading: boolean;
+    refreshing: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    create: (request: Omit<CreateBrowserSessionRequest, "operationId"> & {
+        operationId?: string;
+    }) => Promise<BrowserSessionMutationResponse>;
+    suspend: (browserSessionId: string, operationId?: string) => Promise<BrowserSessionMutationResponse>;
+    resume: (browserSessionId: string, operationId?: string) => Promise<BrowserSessionMutationResponse>;
+    end: (browserSessionId: string, operationId?: string) => Promise<BrowserSessionMutationResponse>;
+};
+/**
+ * Workspace-wide BrowserSession registry. Associations rank relevance but never
+ * hide peer resources; no explicit share ceremony or per-view ownership exists.
+ */
+export declare function useBrowserSessions(options?: UseBrowserSessionsOptions): UseBrowserSessionsResult;
+/** Exported for narrow proxy implementations and tests. */
+export type BrowserSessionsClient = EmbeddedBrowserInteractionClientLike;

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

@@ -1,6 +1,6 @@
 import type { CodexAccount, CodexAccountsResponse, CodexRotationSettings, SessionEvent } from "@opengeni/sdk";
-import { type ClientOverride } from "../provider";
-import { type SessionEventFeedOptions } from "./internal";
+import { type ClientOverride } from "../provider.js";
+import { type SessionEventFeedOptions } from "./internal.js";
 /** Events that change which Codex account a session runs on (or just ran). */
 export declare function isCodexAccountEvent(event: Pick<SessionEvent, "type">): boolean;
 /**