@opengeni/react 0.46.1 → 0.52.1

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.
      */
@@ -57,9 +60,15 @@ 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;
+    /** 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;
@@ -68,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).
@@ -83,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 & {
@@ -94,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). */
@@ -106,9 +120,15 @@ 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;
+    /** 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 +141,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/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

@@ -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.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, 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 { 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-3PB7MIT6.js";
-import "./chunk-HFO4ERGQ.js";
-import "./chunk-EB67J347.js";
+} from "./chunk-ROIRTM37.js";
 import {
   BillingClassMark,
   ModelPolicyPicker,
@@ -48,12 +46,14 @@ import {
   PickerBackHeader,
   PickerNavRow,
   defaultModelPolicyPickerMessages
-} from "./chunk-FGZUCXZF.js";
-import "./chunk-EKZH6IDG.js";
+} from "./chunk-WYA65Y3F.js";
 import "./chunk-23EJ676W.js";
-import "./chunk-U3CSCMWA.js";
+import "./chunk-FK6VG4LL.js";
+import "./chunk-VZTQ73XT.js";
+import "./chunk-724BW4TW.js";
 import "./chunk-LAKLF4PA.js";
-import "./chunk-JB5725BI.js";
+import "./chunk-KZ73RL76.js";
+import "./chunk-HDBG7XGO.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";
+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
+ * 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-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;
 /**
@@ -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-composer.d.ts

@@ -1,8 +1,10 @@
-import { type ComposerDraft, type EffectiveControlResumeOption, type EffectiveSessionControl, type ResourceRef, type SendMessageInput, type SessionEvent } from "@opengeni/sdk";
-import { type EmbeddedSessionClientOverride } from "../session-context";
-import { type SessionEventFeedOptions } from "./internal";
-export type ComposerSendExtras = Omit<SendMessageInput, "text" | "clientEventId">;
+import { type ComposerDraft, type DraftTimelineAnnotation, type EffectiveControlResumeOption, type EffectiveSessionControl, type ResourceRef, type SendMessageInput, type SessionEvent } from "@opengeni/sdk";
+import { type EmbeddedSessionClientOverride } from "../session-context.js";
+import { type SessionEventFeedOptions } from "./internal.js";
+export type ComposerSendExtras = Omit<SendMessageInput, "text" | "clientEventId" | "annotations">;
 export type UseComposerOptions = EmbeddedSessionClientOverride & SessionEventFeedOptions & {
+    /** Called synchronously after an ordinary Send is accepted by the local UI. */
+    onSubmitted?: ((text: string, input: SendMessageInput) => void) | undefined;
     /** Called with the exact accepted wire input after a successful send. */
     onSent?: ((text: string, input: SendMessageInput) => void) | undefined;
     /**
@@ -24,17 +26,40 @@ export type UseComposerOptions = EmbeddedSessionClientOverride & SessionEventFee
     /** Disable remote composer-draft reads and writes for embedded hosts. */
     draftPersistence?: "durable" | "disabled" | undefined;
 };
+export type ComposerOptimisticMessage = {
+    clientEventId: string;
+    text: string;
+    annotations: DraftTimelineAnnotation[];
+    resources: ResourceRef[];
+    occurredAt: string;
+    state: "sending" | "queued" | "failed";
+    error?: string | undefined;
+    outcomeUnknown?: boolean | undefined;
+};
 export type ComposerState = {
     value: string;
     setValue: (value: string) => void;
+    annotations?: DraftTimelineAnnotation[] | undefined;
+    addAnnotation?: ((annotation: DraftTimelineAnnotation) => void) | undefined;
+    updateAnnotation?: ((id: string, note: string) => void) | undefined;
+    removeAnnotation?: ((id: string) => void) | undefined;
+    /** Newly captured annotation the review surface should focus. */
+    annotationReviewTargetId?: string | null | undefined;
+    clearAnnotationReviewTarget?: (() => void) | undefined;
     /** Read the current draft synchronously before a destructive replacement. */
     hasDraftContent: () => boolean;
     /** Append the draft behind prompts already visible in the queue. */
     send: (text?: string) => Promise<boolean>;
+    /** Locally acknowledged ordinary sends awaiting durable timeline reconciliation. */
+    optimisticMessages?: ComposerOptimisticMessage[] | undefined;
+    retryOptimisticMessage?: ((clientEventId: string) => void) | undefined;
+    removeOptimisticMessage?: ((clientEventId: string) => void) | undefined;
     /** Supersede current direction with the draft. */
     steer: (text?: string) => Promise<boolean>;
     /** Optimistic-to-durable projection for a Steer that has not started yet. */
     steering?: ComposerSteeringState | null | undefined;
+    /** Immediate mutation-receipt projection while physical cancellation settles. */
+    stoppingAttempt?: "current" | "previous" | null | undefined;
     sending: boolean;
     canSend: boolean;
     /** Pause the session without deleting its prompt queue. */
@@ -65,6 +90,8 @@ export type ComposerSteeringState = {
     clientEventId: string | null;
     triggerEventId: string | null;
     turnId: string | null;
+    /** True only when the accepted Steer durably interrupted a live attempt. */
+    stoppingPreviousAttempt?: boolean | undefined;
 };
 /**
  * Draft + send + Pause/Resume state for the chat composer — the only
@@ -76,12 +103,12 @@ export declare function useComposer(sessionId: string | null | undefined, option
 /** Events that can atomically replace or clear this subject's durable draft. */
 export declare function isComposerDraftEvent(event: Pick<SessionEvent, "type">): boolean;
 /**
- * Default text for a file-only message (attachment(s) present, no typed draft).
- * Kept non-empty so the wire contract (`text: z.string().min(1)`) and the
- * worker's non-whitespace guard accept it; the attached files still ride in
- * `resources`. Exported for tests.
+ * Default text for a resource-only message (attachments present, no typed
+ * draft). Kept non-empty so the wire contract (`text: z.string().min(1)`) and
+ * the worker's non-whitespace guard accept it. The export name is retained for
+ * compatibility now that repositories can ride beside files in `resources`.
  */
-export declare const FILE_ONLY_MESSAGE_TEXT = "(see attached files)";
+export declare const FILE_ONLY_MESSAGE_TEXT = "(see attached context)";
 /** Resolve possibly-deferred extras to a concrete bag (function evaluated now). */
 export declare function resolveSendExtras(extras: ComposerSendExtras | (() => ComposerSendExtras) | undefined): ComposerSendExtras;
 /**

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

@@ -0,0 +1,24 @@
+import { type ComputerFrame, type ComputerFrameStreamOptions, type ComputerSessionAttachment } from "@opengeni/sdk/interaction";
+import { type EmbeddedComputerInteractionClientOverride } from "../session-context.js";
+export type ComputerFrameConnectionState = "idle" | "attaching" | "connecting" | "live" | "reconnecting" | "error";
+export type ComputerFrameWebSocket = Pick<WebSocket, "binaryType" | "readyState" | "close" | "addEventListener" | "removeEventListener"> & {
+    send(data: ArrayBuffer): void;
+};
+export type ComputerFrameWebSocketFactory = (url: string, protocols: string[]) => ComputerFrameWebSocket;
+export type UseComputerFrameStreamOptions = EmbeddedComputerInteractionClientOverride & {
+    computerSessionId: string | null;
+    targetId: string | null;
+    enabled?: boolean | undefined;
+    stream?: ComputerFrameStreamOptions | undefined;
+    webSocketFactory?: ComputerFrameWebSocketFactory | undefined;
+};
+export type UseComputerFrameStreamResult = {
+    state: ComputerFrameConnectionState;
+    frame: ComputerFrame | null;
+    attachment: Pick<ComputerSessionAttachment, "computerSessionId" | "controllerGeneration" | "targetId" | "expiresAt"> | null;
+    error: Error | null;
+    reconnect: () => void;
+};
+/** Reconnecting, latest-only ComputerSession media attachment. Grants remain in
+ * WebSocket subprotocols or the relay's authenticated first binary message. */
+export declare function useComputerFrameStream(options: UseComputerFrameStreamOptions): UseComputerFrameStreamResult;