@opengeni/react 0.46.1 → 0.52.1

package/dist/components/artifacts/spreadsheet-canvas.d.ts

@@ -0,0 +1,120 @@
+export type SpreadsheetCanvasCellFormat = {
+    fill?: string | undefined;
+    font?: {
+        name?: string | undefined;
+        size?: number | undefined;
+        bold?: boolean | undefined;
+        italic?: boolean | undefined;
+        underline?: boolean | undefined;
+        color?: string | undefined;
+    } | undefined;
+    horizontalAlignment?: "left" | "center" | "right" | "justify" | undefined;
+    verticalAlignment?: "top" | "center" | "bottom" | undefined;
+    wrapText?: boolean | undefined;
+};
+/** One sparse, already-authorized cell projected into the renderer. */
+export type SpreadsheetCanvasCell = {
+    row: number;
+    col: number;
+    value: unknown;
+    formula?: string | null | undefined;
+    format: SpreadsheetCanvasCellFormat;
+};
+export type SpreadsheetCanvasCoverage = {
+    rowStart: number;
+    rowEnd: number;
+    columnStart: number;
+    columnEnd: number;
+};
+/**
+ * A bounded value projection. `coverage` is end-exclusive; omitting it means
+ * the source can answer for the entire sheet. A session-backed adapter can
+ * replace this object as viewport subscriptions advance without making the
+ * React layer or renderer own the canonical workbook model.
+ */
+export type SpreadsheetCanvasProjection = {
+    sheetId: string;
+    generationId: string | null;
+    revision: string | number;
+    coverage?: SpreadsheetCanvasCoverage | undefined;
+    cells: SpreadsheetCanvasCellSource;
+    valueAt: (cell: SpreadsheetCanvasCell) => unknown;
+};
+export type SpreadsheetCanvasCellSource = {
+    forEachInRange: (rowStart: number, rowEnd: number, columnStart: number, columnEnd: number, visit: (cell: SpreadsheetCanvasCell) => void) => void;
+};
+export type SpreadsheetCanvasAxis = {
+    count: number;
+    total: number;
+    offsetAt: (index: number) => number;
+    sizeAt: (index: number) => number;
+    indexAtOffset: (offset: number) => number;
+};
+export type SpreadsheetCanvasSelection = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    focusRow: number;
+    focusColumn: number;
+};
+export type SpreadsheetCanvasTheme = {
+    background: string;
+    headerBackground: string;
+    border: string;
+    foreground: string;
+    mutedForeground: string;
+    accent: string;
+    error: string;
+    fontFamily: string;
+    fontSize: number;
+    headerFontSize: number;
+    signature: string;
+};
+export type SpreadsheetCanvasPaint = {
+    canvas: HTMLCanvasElement;
+    projection: SpreadsheetCanvasProjection;
+    rows: SpreadsheetCanvasAxis;
+    columns: SpreadsheetCanvasAxis;
+    selection: SpreadsheetCanvasSelection;
+    logicalScrollLeft: number;
+    logicalScrollTop: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    rowHeaderWidth: number;
+    columnHeaderHeight: number;
+    dimensionRevision: string | number;
+    devicePixelRatio: number;
+    theme: SpreadsheetCanvasTheme;
+};
+export type SpreadsheetCanvasPaintStats = {
+    cacheSize: number;
+    paintedTiles: number;
+    reusedTiles: number;
+    uncachedTiles: number;
+    devicePixelRatio: number;
+};
+/**
+ * A row-major sparse index over stored worksheet cells. Empty cells never enter
+ * this structure, so a tile query costs O(log k + v), where v is the number of
+ * stored cells intersecting that tile.
+ */
+export declare class SparseSpreadsheetCellIndex {
+    readonly size: number;
+    private readonly rows;
+    constructor(entries: Iterable<SpreadsheetCanvasCell>);
+    forEachInRange(rowStart: number, rowEnd: number, columnStart: number, columnEnd: number, visit: (cell: SpreadsheetCanvasCell) => void): void;
+}
+export declare function spreadsheetCanvasDevicePixelRatio(value: number): number;
+/** Caps backing-store allocation while retaining the full CSS viewport. */
+export declare function spreadsheetCanvasBackingScale(width: number, height: number, devicePixelRatio: number): number;
+/** Retained 2D tile renderer. Dynamic selection and headers are painted above cached body tiles. */
+export declare class SpreadsheetCanvasRenderer {
+    private readonly tiles;
+    private generation;
+    private clock;
+    dispose(): void;
+    paint(input: SpreadsheetCanvasPaint): SpreadsheetCanvasPaintStats | null;
+    private paintTile;
+    private evictTiles;
+}

package/dist/components/artifacts/spreadsheet-grid.d.ts

@@ -0,0 +1,113 @@
+import type { Workbook, Worksheet } from "@opengeni/artifact-tool/reference";
+import { type ReactNode } from "react";
+import { type SpreadsheetCanvasCellFormat, type SpreadsheetCanvasProjection } from "./spreadsheet-canvas.js";
+type CellCoordinate = {
+    row: number;
+    col: number;
+};
+export type SpreadsheetSelection = {
+    sheetId: string;
+    anchor: CellCoordinate;
+    focus: CellCoordinate;
+};
+export type SpreadsheetCommit = {
+    sheetId: string;
+    cell: CellCoordinate;
+    input: string;
+    kind: "formula" | "value";
+};
+/** Row-major rectangular input submitted as one durable spreadsheet command. */
+export type SpreadsheetRangeCommit = {
+    sheetId: string;
+    anchor: CellCoordinate;
+    rows: number;
+    columns: number;
+    inputs: readonly string[];
+};
+/** End-exclusive logical windows emitted at most once per animation frame. */
+export type SpreadsheetViewport = {
+    sheetId: string;
+    rowStart: number;
+    rowEnd: number;
+    columnStart: number;
+    columnEnd: number;
+    overscanRowStart: number;
+    overscanRowEnd: number;
+    overscanColumnStart: number;
+    overscanColumnEnd: number;
+    logicalScrollLeft: number;
+    logicalScrollTop: number;
+    viewportWidth: number;
+    viewportHeight: number;
+};
+export type SpreadsheetGridProps = {
+    workbook: Workbook;
+    worksheet: Worksheet;
+    readOnly?: boolean | undefined;
+    /** Addressable rows in the interactive projection. Grows to include used data. */
+    rowCount?: number | undefined;
+    /** Addressable columns in the interactive projection. Grows to include used data. */
+    columnCount?: number | undefined;
+    overscanRows?: number | undefined;
+    overscanColumns?: number | undefined;
+    onSelectionChange?: ((selection: SpreadsheetSelection) => void) | undefined;
+    onCommit?: ((commit: SpreadsheetCommit) => void) | undefined;
+    onViewportChange?: ((viewport: SpreadsheetViewport) => void) | undefined;
+    className?: string | undefined;
+};
+export type SpreadsheetProjectionCell = {
+    value: unknown;
+    input: string;
+    format: SpreadsheetCanvasCellFormat;
+};
+/**
+ * Synchronous, bounded view state consumed by the React editor. Durable model
+ * ownership stays with the caller (legacy Workbook, SDK Worker, or another
+ * projection adapter); edits return through `commit` / `clear` ports.
+ */
+export type SpreadsheetGridProjection = SpreadsheetCanvasProjection & {
+    sheetName: string;
+    rowCount: number;
+    columnCount: number;
+    defaultRowHeight?: number | undefined;
+    defaultColumnWidth?: number | undefined;
+    rowHeights?: readonly (readonly [number, number])[] | undefined;
+    columnWidths?: readonly (readonly [number, number])[] | undefined;
+    dimensionRevision?: string | number | undefined;
+    usedRange?: {
+        row: number;
+        col: number;
+        rowCount: number;
+        colCount: number;
+    } | null | undefined;
+    readCell: (row: number, column: number) => SpreadsheetProjectionCell | null;
+};
+export type SpreadsheetProjectionGridProps = {
+    projection: SpreadsheetGridProjection;
+    readOnly?: boolean | undefined;
+    overscanRows?: number | undefined;
+    overscanColumns?: number | undefined;
+    onSelectionChange?: ((selection: SpreadsheetSelection) => void) | undefined;
+    commit?: ((commit: SpreadsheetCommit) => void | Promise<void>) | undefined;
+    commitRange?: ((commit: SpreadsheetRangeCommit) => void | Promise<void>) | undefined;
+    clear?: ((selection: SpreadsheetSelection) => void | Promise<void>) | undefined;
+    onCommandError?: ((error: Error) => void) | undefined;
+    onViewportChange?: ((viewport: SpreadsheetViewport) => void) | undefined;
+    className?: string | undefined;
+};
+export type SpreadsheetArtifactSurfaceProps = Omit<SpreadsheetGridProps, "worksheet"> & {
+    title?: string | undefined;
+    subtitle?: ReactNode | undefined;
+    actions?: ReactNode | undefined;
+    initialSheetId?: string | undefined;
+    allowAddSheet?: boolean | undefined;
+};
+/** A reusable workbook shell with first-class sheet switching. */
+export declare function SpreadsheetArtifactSurface({ workbook, title, subtitle, actions, initialSheetId, allowAddSheet, readOnly, ...gridProps }: SpreadsheetArtifactSurfaceProps): import("react").JSX.Element;
+export declare function SpreadsheetGrid({ workbook, worksheet, readOnly, rowCount: requestedRowCount, columnCount: requestedColumnCount, overscanRows, overscanColumns, onSelectionChange, onCommit, onViewportChange, className, }: SpreadsheetGridProps): import("react").JSX.Element;
+/**
+ * Two-axis virtualized, accessible spreadsheet projection. The caller owns
+ * durable model state; React owns only viewport, selection, and edit state.
+ */
+export declare function SpreadsheetProjectionGrid({ projection, readOnly, overscanRows, overscanColumns, onSelectionChange, commit, commitRange, clear, onCommandError, onViewportChange, className, }: SpreadsheetProjectionGridProps): import("react").JSX.Element;
+export {};

package/dist/components/browser-viewer.d.ts

@@ -0,0 +1,29 @@
+import type { ComputerSession } from "@opengeni/sdk/interaction";
+import { type ReactNode } from "react";
+import { type BrowserFrameWebSocketFactory } from "../hooks/use-browser-frame-stream.js";
+import type { EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+export type BrowserViewerNotification = {
+    kind: "error" | "info";
+    message: string;
+};
+export type BrowserViewerProps = EmbeddedBrowserInteractionClientOverride & {
+    /** The selected OpenGeni agent/session. Peer BrowserSessions stay discoverable. */
+    sessionId: string;
+    enabled?: boolean | undefined;
+    className?: string | undefined;
+    onNotify?: ((notification: BrowserViewerNotification) => void) | undefined;
+    /** Tests/demos only. Production uses the browser's native WebSocket. */
+    webSocketFactory?: BrowserFrameWebSocketFactory | undefined;
+    renderEmpty?: ((create: () => void, creating: boolean) => ReactNode) | undefined;
+    /** Optional host capability for a headed managed browser. Browser-only
+     * embedders remain valid and create headless sessions instead. */
+    createLinkedComputer?: ((name: string) => Promise<Pick<ComputerSession, "id" | "placement">>) | undefined;
+    /** Navigate to the exact linked ComputerSession; never a lookalike desktop. */
+    onOpenComputer?: ((computerSessionId: string) => void) | undefined;
+};
+/**
+ * Complete browser-native session surface: workspace discovery, agent relevance,
+ * browser/tab switching, live frames, semantic fallback, direct human input,
+ * address navigation, diagnostics, and reconnect. Closing it never closes the browser.
+ */
+export declare function BrowserViewer({ sessionId, enabled, className, onNotify, webSocketFactory, renderEmpty, createLinkedComputer, onOpenComputer, ...override }: BrowserViewerProps): import("react").JSX.Element | null;

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

@@ -1,15 +1,20 @@
 import type { ClientModel, EffectiveSessionControl } from "@opengeni/sdk";
 import type { ClipboardEvent, ReactNode } from "react";
-import type { SlashCommand } from "../commands/types";
-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 ComposerTranscriptionControlProps } from "./composer-transcription-control";
+import type { SlashCommand } from "../commands/types.js";
+import type { ComposerState } from "../hooks/use-composer.js";
+import type { UseFileAttachmentsResult } from "../hooks/use-file-attachments.js";
+import type { SlashCommandContext } from "../hooks/use-slash-commands.js";
+import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event.js";
+import { type ChatComposerMessages, type ComposerControlLinks, type ResponsiveBasis } from "./composer.js";
+import { type ComposerTranscriptionControlProps } from "./composer-transcription-control.js";
 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.Element;

package/dist/components/code-editor.d.ts

@@ -8,8 +8,13 @@ export type CodeEditorProps = {
     path: string;
     /** The decoded text contents to seed the editor with. */
     initialContents: string;
-    /** Persist the current buffer. Resolves when the write lands; rejects to surface an error. */
-    onSave: (contents: string) => Promise<unknown>;
+    /**
+     * Persist the current buffer against the exact contents it was edited from.
+     * The second argument is the immutable compare-and-swap baseline; hosts must
+     * not replace it with a newer remote snapshot or concurrent writes can be
+     * silently overwritten.
+     */
+    onSave: (contents: string, expectedContents: string) => Promise<unknown>;
     /** Explicitly overwrite after a visible expected-content conflict. */
     onOverwrite?: ((contents: string) => Promise<unknown>) | undefined;
     /** Re-read the selected file after a visible save conflict. */
@@ -27,6 +32,23 @@ export type CodeEditorProps = {
     fallback?: ReactNode | undefined;
     className?: string | undefined;
 };
+export type EditorBufferState = {
+    path: string;
+    value: string;
+    baseline: string;
+};
+/**
+ * Reconcile a remote file snapshot without destroying unsaved local work.
+ *
+ * A different path is a new document and always resets. For the same path, a
+ * clean editor follows the remote snapshot while a dirty editor retains both
+ * its local value and the original CAS baseline. The eventual save will then
+ * either succeed against that baseline or surface a typed conflict.
+ */
+export declare function reconcileEditorBuffer(current: EditorBufferState, incoming: {
+    path: string;
+    contents: string;
+}): EditorBufferState;
 /**
  * The EDITABLE single-file pane: CodeMirror 6 with a per-language grammar chosen
  * from the filename, og-* themed, with dirty tracking and a save path wired to
@@ -39,5 +61,5 @@ export type CodeEditorProps = {
  * `readOnly` suppresses every mutation path so a truncated/binary file can never
  * be saved back (which would corrupt it by writing the truncated prefix).
  */
-export declare function CodeEditor({ path, initialContents, onSave, onOverwrite, onReload, onEditIntent, readOnly, themeType, loading, fallback, className, }: CodeEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare function CodeEditor({ path, initialContents, onSave, onOverwrite, onReload, onEditIntent, readOnly, themeType, loading, fallback, className, }: CodeEditorProps): import("react").JSX.Element;
 export {};

package/dist/components/command-palette.d.ts

@@ -1,4 +1,4 @@
-import type { SlashCommand } from "../commands/types";
+import type { SlashCommand } from "../commands/types.js";
 export type CommandPaletteProps = {
     open: boolean;
     items: SlashCommand[];
@@ -22,4 +22,4 @@ export type CommandPaletteProps = {
  * the opengeni#46 design tokens. Full keyboard nav lives in useSlashCommands;
  * this component is presentational + aria.
  */
-export declare function CommandPalette({ open, items, highlight, onHighlight, onRun, argHintText, listboxId, label, dangerLabel, }: CommandPaletteProps): import("react/jsx-runtime").JSX.Element;
+export declare function CommandPalette({ open, items, highlight, onHighlight, onRun, argHintText, listboxId, label, dangerLabel, }: CommandPaletteProps): import("react").JSX.Element;

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

@@ -1,14 +1,16 @@
 import type { ClientVoiceInputConfig, OpenGeniClient, TranscriptionAdapter, WorkspaceTranscriptionPolicy } from "@opengeni/sdk";
-import type { VoiceRecordingStore } from "../voice-recording-store";
+import type { VoiceRecordingStore } from "../voice-recording-store.js";
 export type ComposerTranscriptionMessages = {
     start: string;
     stop: string;
     cancel: string;
     retry: string;
+    pauseRetrying: string;
     requestingPermission: string;
     recording: string;
     saving: string;
     transcribing: string;
+    retrying: string;
     recovered: string;
     recoveredTranscript: string;
     insertRecoveredTranscript: string;
@@ -48,4 +50,4 @@ export type ComposerTranscriptionControlProps = {
     suppressed?: boolean | undefined;
 };
 /** One provider-neutral microphone control for the nearest editable composer. */
-export declare function ComposerTranscriptionControl({ client, workspaceId, capability, workspaceEnabled, messages: overrides, className, createRecordingStore, createOwnerId, suppressed, }: ComposerTranscriptionControlProps): import("react/jsx-runtime").JSX.Element;
+export declare function ComposerTranscriptionControl({ client, workspaceId, capability, workspaceEnabled, messages: overrides, className, createRecordingStore, createOwnerId, suppressed, }: ComposerTranscriptionControlProps): import("react").JSX.Element;

package/dist/components/composer.d.ts

@@ -1,12 +1,14 @@
 import type { ClientModel, EffectiveSessionControl } from "@opengeni/sdk";
 import { type ButtonHTMLAttributes, type ChangeEvent, type ClipboardEvent, type ComponentPropsWithoutRef, type DragEvent, type KeyboardEvent, type ReactNode, type RefObject } from "react";
-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 { PickerModelRow } from "../model-policy";
-import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event";
+import type { Notice, SlashCommand } from "../commands/types.js";
+import type { ComposerState } from "../hooks/use-composer.js";
+import type { UseFileAttachmentsResult } from "../hooks/use-file-attachments.js";
+import { type ConfirmState, type SlashCommandContext } from "../hooks/use-slash-commands.js";
+import { type ResponsiveBasis } from "../lib/composer-responsive-context.js";
+import type { PickerModelRow } from "../model-policy.js";
+import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event.js";
 export { OPEN_WORKSTREAM_CONTROL_EVENT };
+export type { ResponsiveBasis } from "../lib/composer-responsive-context.js";
 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">;
@@ -201,7 +203,7 @@ export declare function useChatComposerController({ delivery, draft, control, ef
     handleDragOver: (event: DragEvent<HTMLDivElement>) => void;
     handleDragLeave: (event: DragEvent<HTMLDivElement>) => void;
     handleDrop: (event: DragEvent<HTMLDivElement>) => void;
-    palette: import("..").UseSlashCommandsResult;
+    palette: import("../index.js").UseSlashCommandsResult;
     paletteEnabled: boolean;
     commandDraftBlocked: boolean;
     confirmState: ConfirmState;
@@ -227,27 +229,39 @@ 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>>;
 export type ComposerCommandPaletteProps = {
     className?: string | undefined;
 };
-export declare function CommandPalette({ className }: ComposerCommandPaletteProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CommandPalette({ className }: ComposerCommandPaletteProps): import("react").JSX.Element | null;
 type OwnedSurfaceProps = "onDragOver" | "onDragLeave" | "onDrop";
 export type ComposerSurfaceProps = Omit<ComponentPropsWithoutRef<"div">, OwnedSurfaceProps>;
 export declare const Surface: import("react").ForwardRefExoticComponent<ComposerSurfaceProps & import("react").RefAttributes<HTMLDivElement>>;
-export declare function PausedState(): import("react/jsx-runtime").JSX.Element | null;
-export declare function RestoredResources(): import("react/jsx-runtime").JSX.Element | null;
-export declare function Attachments(): import("react/jsx-runtime").JSX.Element | null;
+export declare function PausedState(): import("react").JSX.Element | null;
+export declare function RestoredResources(): import("react").JSX.Element | null;
+export declare function Attachments(): import("react").JSX.Element | null;
 type OwnedInputProps = "value" | "defaultValue" | "onChange" | "onKeyDown" | "onPaste" | "disabled" | "aria-autocomplete" | "aria-controls" | "aria-activedescendant" | "aria-keyshortcuts";
 export type ComposerInputProps = Omit<ComponentPropsWithoutRef<"textarea">, OwnedInputProps>;
 export declare const Input: import("react").ForwardRefExoticComponent<ComposerInputProps & import("react").RefAttributes<HTMLTextAreaElement>>;
-export declare function Confirmation(): import("react/jsx-runtime").JSX.Element | null;
+export declare function Confirmation(): import("react").JSX.Element | null;
 export type ComposerFooterProps = ComponentPropsWithoutRef<"div">;
 export declare const Footer: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export type ComposerControlsProps = ComponentPropsWithoutRef<"span">;
@@ -276,10 +290,10 @@ export type ComposerModelPickerProps = {
     /** Filter to Codex models for remote_v2-locked sessions. */
     codexOnly?: boolean | undefined;
 };
-export declare function ModelPicker({ models, rows, value, onChange, label, className, codexOnly, }: ComposerModelPickerProps): import("react/jsx-runtime").JSX.Element;
+export declare function ModelPicker({ models, rows, value, onChange, label, className, codexOnly, }: ComposerModelPickerProps): import("react").JSX.Element;
 export type ComposerPauseButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, OwnedButtonProps>;
 export declare const PauseButton: import("react").ForwardRefExoticComponent<ComposerPauseButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 export type ComposerSendButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, OwnedButtonProps>;
 export declare const SendButton: import("react").ForwardRefExoticComponent<ComposerSendButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
-export declare function Help(): import("react/jsx-runtime").JSX.Element;
-export declare function Status(): import("react/jsx-runtime").JSX.Element;
+export declare function Help(): import("react").JSX.Element;
+export declare function Status(): import("react").JSX.Element;

package/dist/components/computer-viewer.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from "react";
+import { type ComputerFrameWebSocketFactory } from "../hooks/use-computer-frame-stream.js";
+import type { EmbeddedComputerInteractionClientOverride } from "../session-context.js";
+export type ComputerViewerNotification = {
+    kind: "error" | "info";
+    message: string;
+};
+export type ComputerViewerProps = EmbeddedComputerInteractionClientOverride & {
+    /** Selected OpenGeni agent/session. Peer ComputerSessions remain visible. */
+    sessionId: string;
+    enabled?: boolean | undefined;
+    className?: string | undefined;
+    onNotify?: ((notification: ComputerViewerNotification) => void) | undefined;
+    /** Tests/demos only. Production uses the browser's native WebSocket. */
+    webSocketFactory?: ComputerFrameWebSocketFactory | undefined;
+    renderEmpty?: ((create: () => void, creating: boolean) => ReactNode) | undefined;
+    /** Host navigation request for one exact ComputerSession. */
+    requestedComputerSessionId?: string | null | undefined;
+    requestedComputerRequestId?: string | number | null | undefined;
+};
+/** Full ComputerSession surface: workspace discovery, peer switching, app/window/
+ * screen navigation, semantic controls, exact-frame input, and live media. */
+export declare function ComputerViewer({ sessionId, enabled, className, onNotify, webSocketFactory, renderEmpty, requestedComputerSessionId, requestedComputerRequestId, ...override }: ComputerViewerProps): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;

package/dist/components/copy-button.d.ts

@@ -15,7 +15,7 @@ export type CopyButtonProps = {
  * Ghost icon copy control — no chrome box, no "Copy code" label.
  * Copy → check flash. Hover-reveal via `group/copy` on a parent.
  */
-export declare function CopyButton({ text, label, className, reveal, }: CopyButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function CopyButton({ text, label, className, reveal, }: CopyButtonProps): import("react").JSX.Element;
 /** Hover-reveal chrome around a message / turn so {@link CopyButton} can fade in. */
 export declare function CopyHoverFrame({ children, className, copyText, label, align, trailing, }: {
     children: ReactNode;
@@ -25,4 +25,4 @@ export declare function CopyHoverFrame({ children, className, copyText, label, a
     align?: "start" | "end" | undefined;
     /** Optional footer meta (e.g. sent/finished clock) — immediately after the copy control. */
     trailing?: ReactNode | undefined;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

package/dist/components/desktop-viewer.d.ts

@@ -1,6 +1,6 @@
 import type { CapabilityUnavailableReason, DesktopRfbFactory, DesktopStreamCapability } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import type { DesktopWebSocketFactory } from "../hooks/use-relay-frame-stream";
+import type { DesktopWebSocketFactory } from "../hooks/use-relay-frame-stream.js";
 export type DesktopViewerProps = {
     /** The desktop cell of the negotiated capabilities (`capabilities.DesktopStream`). */
     capability: DesktopStreamCapability | null;
@@ -20,22 +20,26 @@ export type DesktopViewerProps = {
      *  Defaults to `new WebSocket(url)`. Mirrors `rfbFactory`. */
     webSocketFactory?: DesktopWebSocketFactory | undefined;
     /**
-     * Consent gate for the un-redacted (and possibly shared) pixel plane. Rendered
-     * BEFORE connecting whenever the desktop requires acknowledgment that hasn't
-     * been given. Call `onAccept` to record consent (the host wires it to
-     * `client.acknowledgeStream` + a re-negotiate). When omitted, a default
-     * banner is shown.
+     * @deprecated Desktop acknowledgment is automatic. Retained as an ignored
+     * compatibility prop so existing embedders keep compiling.
      */
     renderConsentGate?: ((onAccept: () => void, shared: boolean) => ReactNode) | undefined;
-    /** Called when the default consent gate's accept button is pressed. */
-    onAcknowledge?: (() => void) | undefined;
     /**
-     * Whether the host has the viewer attach engaged (i.e. the user has opted into
-     * watching — the parent's `watchDesktop`/`attachDesktop`). Drives the
-     * cold-state behaviour: when watching, a cold-but-warmable lease AUTO-WARMS
-     * (and re-warms when the box drains) instead of dead-ending. When omitted we
-     * infer it from a recorded consent (the default gate's accept), so the
-     * component still self-heals after the first acknowledgment.
+     * Called once when the viewer mounts. Hosts use this to engage the desktop
+     * holder immediately when the Desktop tab opens.
+     */
+    onActivate?: (() => void) | undefined;
+    /**
+     * Called automatically when the server requires acknowledgment of the
+     * un-redacted (and possibly shared) pixel plane. The viewer shows its ordinary
+     * opening state while this completes; no click-through gate is rendered.
+     */
+    onAcknowledge?: (() => void | Promise<void>) | undefined;
+    /**
+     * Whether the host has the viewer attach engaged. Drives the cold-state
+     * behaviour: when watching, a cold-but-warmable lease AUTO-WARMS (and re-warms
+     * when the box drains) instead of dead-ending. Mounting the viewer counts as
+     * watching when this is omitted.
      */
     watching?: boolean | undefined;
     /**
@@ -43,8 +47,7 @@ export type DesktopViewerProps = {
      * already been recorded — only the box drained). The host wires this to
      * "engage the viewer attach + re-negotiate". Called automatically when a
      * watched desktop is found cold-but-warmable, and behind the manual retry on
-     * the warming notice. Distinct from `onAcknowledge`, which is the FIRST,
-     * consent-bearing warm.
+     * the warming notice. Distinct from the automatic acknowledgment request.
      */
     onWarm?: (() => void) | undefined;
     /** Shown when transport is null (headless backend / degraded / disabled). */
@@ -77,9 +80,10 @@ export type DesktopViewerProps = {
  * reason).
  *
  * Warming: a cold-but-warmable lease (`reason: "lease_cold"`) is NOT a dead end.
- * When the user is watching (consented), the viewer asks the host to (re)warm
- * the box (`onWarm`) and shows a "Warming…" spinner; if the box later drains to
- * cold it re-warms. Genuinely-unavailable surfaces (headless/policy/os/backend)
- * keep a clear, static unavailable notice.
+ * When the viewer is mounted, it asks the host to engage the desktop and records
+ * any required acknowledgment automatically. A cold-but-warmable box then
+ * (re)warms through `onWarm`; if it later drains to cold it re-warms.
+ * Genuinely-unavailable surfaces (headless/policy/os/backend) keep a clear,
+ * static unavailable notice.
  */
-export declare function DesktopViewer({ capability, interactive, showControlToggle, scaleViewport, rfbFactory, webSocketFactory, renderConsentGate, onAcknowledge, watching, onWarm, renderUnavailable, renderWarming, renderViewerCap, viewerCapReached, connectTimeoutMs, className, }: DesktopViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare function DesktopViewer({ capability, interactive, showControlToggle, scaleViewport, rfbFactory, webSocketFactory, onActivate, onAcknowledge, watching, onWarm, renderUnavailable, renderWarming, renderViewerCap, viewerCapReached, connectTimeoutMs, className, }: DesktopViewerProps): import("react").JSX.Element;

package/dist/components/diff-view.d.ts

@@ -35,4 +35,4 @@ export type DiffViewProps = {
  * (Shiki-highlighted, unified/split) with a plain-text fallback for a host
  * without `@pierre/diffs`. Removed next major.
  */
-export declare function DiffView({ diff, fallback, layout, themeType, isRepo, emptyState, className, }: DiffViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function DiffView({ diff, fallback, layout, themeType, isRepo, emptyState, className, }: DiffViewProps): import("react").JSX.Element;

package/dist/components/enrollment-consent.d.ts

@@ -30,4 +30,4 @@ export type EnrollmentConsentProps = {
  * The danger framing is deliberate (§18 hardening: whole-machine = loud consent),
  * never buried. Renders review / approving / approved / denied / error phases.
  */
-export declare function EnrollmentConsent({ userCode, machine, phase, onApprove, onDeny, errorMessage, className, }: EnrollmentConsentProps): import("react/jsx-runtime").JSX.Element;
+export declare function EnrollmentConsent({ userCode, machine, phase, onApprove, onDeny, errorMessage, className, }: EnrollmentConsentProps): import("react").JSX.Element;

package/dist/components/enrollment-device-flow.d.ts

@@ -24,4 +24,4 @@ export type EnrollmentDeviceFlowProps = {
  * pending → authorized/denied/expired progression with a connection pill. This is
  * the FIRST step of the IA flow (device-flow → Machines list → attach/swap).
  */
-export declare function EnrollmentDeviceFlow({ userCode, verificationUri, verificationUriComplete, installCommand, phase, expiresInSeconds, onCopyCode, onCopyInstall, onOpenVerification, className, }: EnrollmentDeviceFlowProps): import("react/jsx-runtime").JSX.Element;
+export declare function EnrollmentDeviceFlow({ userCode, verificationUri, verificationUriComplete, installCommand, phase, expiresInSeconds, onCopyCode, onCopyInstall, onOpenVerification, className, }: EnrollmentDeviceFlowProps): import("react").JSX.Element;

package/dist/components/file-browser.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import type { FileTreeNode, UseSandboxFilesResult } from "../hooks/use-sandbox-files";
+import type { FileTreeNode, UseSandboxFilesResult } from "../hooks/use-sandbox-files.js";
 export type FileBrowserProps = {
     /** From `useSandboxFiles(...)`. */
     result: UseSandboxFilesResult;
@@ -44,4 +44,4 @@ export type FileBrowserProps = {
  * `renderNode` is still honoured as the Pierre-swap escape hatch for the row
  * chrome; the manager scaffolding (toolbar, dnd, menu, inline inputs) wraps it.
  */
-export declare function FileBrowser({ result, fallback, onSelectFile, selectedPath, renderNode, emptyState, editable, confirmDelete, className, }: FileBrowserProps): import("react/jsx-runtime").JSX.Element;
+export declare function FileBrowser({ result, fallback, onSelectFile, selectedPath, renderNode, emptyState, editable, confirmDelete, className, }: FileBrowserProps): import("react").JSX.Element;

package/dist/components/fleet-tile.d.ts

@@ -15,4 +15,4 @@ export declare function sessionDisplayTitle(session: Session): string;
  * recency — dense but calm. Running sessions carry a breathing status dot
  * and a faint accent edge so the live ones read at a glance.
  */
-export declare function FleetTile({ session, title, subtitle, onOpen, className }: FleetTileProps): import("react/jsx-runtime").JSX.Element;
+export declare function FleetTile({ session, title, subtitle, onOpen, className }: FleetTileProps): import("react").JSX.Element;