@opengeni/react 0.48.0 → 0.57.0

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

@@ -1,5 +1,5 @@
 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;
@@ -50,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,14 +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 ResponsiveBasis } from "../lib/composer-responsive-context";
-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";
+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">;
@@ -203,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;
@@ -251,17 +251,17 @@ export declare const Frame: import("react").ForwardRefExoticComponent<Omit<impor
 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">;
@@ -290,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,24 @@
+import { type KeyboardEvent, 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;
+export declare function computerKey(event: Pick<KeyboardEvent<HTMLTextAreaElement>, "altKey" | "ctrlKey" | "key" | "metaKey" | "shiftKey">): string | null;

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,7 @@
 import type { CapabilityUnavailableReason, DesktopRfbFactory, DesktopStreamCapability } from "@opengeni/sdk";
-import { type ReactNode } from "react";
-import type { DesktopWebSocketFactory } from "../hooks/use-relay-frame-stream";
+import { type KeyboardEvent as ReactKeyboardEvent, type ReactNode } from "react";
+import { type InteractionHostPlatform } from "../lib/host-platform.js";
+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;
@@ -16,26 +17,43 @@ export type DesktopViewerProps = {
     scaleViewport?: boolean | undefined;
     /** Custom RFB factory (tests / a WebRTC swap). Defaults to lazy @novnc/novnc. */
     rfbFactory?: DesktopRfbFactory | undefined;
+    /** Authenticated controller protocols for proxied RFB transports. */
+    webSocketProtocols?: string[] | undefined;
     /** Custom socket factory for the self-hosted `relay-frames` transport (tests).
      *  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.
+     * Optional host-owned paste path. ComputerSession hosts use their native,
+     * target-scoped clipboard action instead of relying on an RFB server to sync
+     * ClientCutText into the graphical seat. Return true once the host accepted
+     * the text. Without a host authority the viewer leaves paste untouched rather
+     * than claiming success for an unreliable display-server clipboard heuristic.
+     */
+    onPasteText?: ((text: string) => boolean) | undefined;
+    /** OS behind the RFB seat. Used only to translate the host's primary shortcut
+     * (Cmd on macOS, Ctrl elsewhere) to the target's primary modifier. */
+    targetPlatform?: "linux" | "macos" | "windows" | null | undefined;
+    /**
+     * @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 +61,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 +94,20 @@ 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, webSocketProtocols, webSocketFactory, onPasteText, targetPlatform, onActivate, onAcknowledge, watching, onWarm, renderUnavailable, renderWarming, renderViewerCap, viewerCapReached, connectTimeoutMs, className, }: DesktopViewerProps): import("react").JSX.Element;
+type RfbKeyEvent = {
+    keysym: number;
+    code: string;
+    down: boolean;
+};
+/** Translate one host-primary chord into deterministic RFB events for the
+ * target OS. noVNC otherwise treats a Mac Command key as remote Alt, which
+ * makes ordinary Cmd+A/Z shortcuts silently wrong on Linux sandboxes. */
+export declare function desktopPrimaryShortcut(event: Pick<ReactKeyboardEvent<HTMLDivElement>, "altKey" | "ctrlKey" | "key" | "metaKey" | "shiftKey" | "code">, hostPlatform: InteractionHostPlatform, targetPlatform: "linux" | "macos" | "windows"): RfbKeyEvent[] | "clipboard" | null;
+export {};

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;

package/dist/components/generated-video-player.d.ts

@@ -0,0 +1,10 @@
+import type { GeneratedVideoReceipt } from "@opengeni/sdk";
+import type { VideoArtifactPlaybackLoader } from "../timeline/index.js";
+export type GeneratedVideoPlayerProps = {
+    receipt: GeneratedVideoReceipt;
+    loadPlaybackSource: VideoArtifactPlaybackLoader;
+    className?: string | undefined;
+    label?: string | undefined;
+};
+/** Native, Range-based playback. Video bytes never pass through React or the SDK heap. */
+export declare function GeneratedVideoPlayer({ receipt, loadPlaybackSource, className, label, }: GeneratedVideoPlayerProps): import("react").JSX.Element;

package/dist/components/human-input-form.d.ts

@@ -50,7 +50,7 @@ export type HumanInputFormProps = {
  * options, sticky ask/submit chrome. Hosts can replace title/description or
  * use `useHumanInputRequests` headlessly.
  */
-export declare function HumanInputForm({ request, onSubmit, submitting, error, title, description, progressLabel, submitLabel, skipLabel, messages: messageOverrides, autoFocus, defaultCollapsed, className, }: HumanInputFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function HumanInputForm({ request, onSubmit, submitting, error, title, description, progressLabel, submitLabel, skipLabel, messages: messageOverrides, autoFocus, defaultCollapsed, className, }: HumanInputFormProps): import("react").JSX.Element;
 export declare function answersFromDrafts(questions: HumanInputQuestion[], drafts: Record<string, HumanInputAnswerDraft>, messageOverrides?: Partial<HumanInputFormMessages>): {
     answers: HumanInputAnswer[];
     errors: Record<string, string>;

package/dist/components/human-input-surface.d.ts

@@ -1,5 +1,5 @@
 import type { SessionHumanInputRequest, SubmitHumanInputResponseRequest } from "@opengeni/sdk";
-import { type HumanInputFormMessages } from "./human-input-form";
+import { type HumanInputFormMessages } from "./human-input-form.js";
 export type HumanInputSurfaceProps = {
     requests: SessionHumanInputRequest[];
     onSubmit: (requestId: string, response: SubmitHumanInputResponseRequest) => void | Promise<void>;
@@ -16,4 +16,4 @@ export type HumanInputSurfaceProps = {
  * settles the active request and the next remaining set advances automatically
  * when the authoritative pending list updates.
  */
-export declare function HumanInputSurface({ requests, onSubmit, respondingRequestId, error, messages, className, autoFocus, }: HumanInputSurfaceProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function HumanInputSurface({ requests, onSubmit, respondingRequestId, error, messages, className, autoFocus, }: HumanInputSurfaceProps): import("react").JSX.Element | null;

package/dist/components/interaction-intervention-banner.d.ts

@@ -0,0 +1,11 @@
+import type { InteractionIntervention } from "@opengeni/sdk/interaction";
+export type InteractionInterventionBannerProps = {
+    interventions: InteractionIntervention[];
+    activeTargetId?: string | null | undefined;
+    mutating?: boolean | undefined;
+    className?: string | undefined;
+    onOpen?: ((intervention: InteractionIntervention) => void) | undefined;
+    onResolve: (intervention: InteractionIntervention, outcome: "completed" | "dismissed") => void;
+};
+/** Compact durable human-action prompt shared by Browser and Computer viewers. */
+export declare function InteractionInterventionBanner({ interventions, activeTargetId, mutating, className, onOpen, onResolve, }: InteractionInterventionBannerProps): import("react").JSX.Element | null;

package/dist/components/interactive-workbench-viewers.d.ts

@@ -0,0 +1,2 @@
+export { BrowserViewer } from "./browser-viewer.js";
+export { ComputerViewer } from "./computer-viewer.js";

package/dist/components/machine-card.d.ts

@@ -1,4 +1,4 @@
-import type { MachineView, MetricSample } from "../types/machines";
+import type { MachineView, MetricSample } from "../types/machines.js";
 export type MachineCardProps = {
     machine: MachineView;
     /** Attach/swap the session's active sandbox to this machine. */
@@ -18,4 +18,4 @@ export type MachineCardProps = {
  * freshness, and attach/swap. The whole card opens the telemetry detail when
  * `onOpenDetail` is wired. The session's active sandbox carries an accent edge.
  */
-export declare function MachineCard({ machine, onAttach, attaching, series, onOpenDetail, now, className, }: MachineCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineCard({ machine, onAttach, attaching, series, onOpenDetail, now, className, }: MachineCardProps): import("react").JSX.Element;

package/dist/components/machine-dock-bar.d.ts

@@ -1,4 +1,4 @@
-import type { MachineKind, MachineState } from "../types/machines";
+import type { MachineKind, MachineState } from "../types/machines.js";
 export type MachineDockBarProps = {
     /** The active machine's display name. */
     name: string;
@@ -16,7 +16,7 @@ export type MachineDockBarProps = {
  * render IDENTICALLY regardless of backend — this bar is the only backend-aware
  * chrome (the dock-parity contract: selfhosted == Modal for the surfaces).
  */
-export declare function MachineDockBar({ name, kind, state, className }: MachineDockBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineDockBar({ name, kind, state, className }: MachineDockBarProps): import("react").JSX.Element;
 export type SharedMachineDisclosureProps = {
     sharedSessionCount: number;
     /** Compact (inline strip) vs full (a notice block). */
@@ -28,4 +28,4 @@ export type SharedMachineDisclosureProps = {
  * dock (and reused on the desktop take-control gate) so the user knows others are
  * driving the same whole-machine lease. Render when `sharedSessionCount > 1`.
  */
-export declare function SharedMachineDisclosure({ sharedSessionCount, density, className, }: SharedMachineDisclosureProps): import("react/jsx-runtime").JSX.Element;
+export declare function SharedMachineDisclosure({ sharedSessionCount, density, className, }: SharedMachineDisclosureProps): import("react").JSX.Element;

package/dist/components/machine-health-pill.d.ts

@@ -1,4 +1,4 @@
-import type { MachineState, MetricSample } from "../types/machines";
+import type { MachineState, MetricSample } from "../types/machines.js";
 export type MachineHealthPillProps = {
     state: MachineState;
     metrics: MetricSample | null;
@@ -6,4 +6,4 @@ export type MachineHealthPillProps = {
     size?: "sm" | "md" | undefined;
     className?: string | undefined;
 };
-export declare function MachineHealthPill({ state, metrics, now, size, className, }: MachineHealthPillProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineHealthPill({ state, metrics, now, size, className, }: MachineHealthPillProps): import("react").JSX.Element;

package/dist/components/machine-input-display.d.ts

@@ -1,4 +1,4 @@
-import type { MachineInputMember } from "../timeline/types";
+import type { MachineInputMember } from "../timeline/types.js";
 export declare const MACHINE_INPUT_META: Record<MachineInputMember["kind"], string>;
 /**
  * Collapsed landmark label for a coalesced machine-input batch.

package/dist/components/machine-metrics.d.ts

@@ -1,4 +1,4 @@
-import type { MetricSample } from "../types/machines";
+import type { MetricSample } from "../types/machines.js";
 export type MachineMetricsProps = {
     /** The latest metric sample, or null when the machine hasn't reported yet. */
     metrics: MetricSample | null;
@@ -12,4 +12,4 @@ export type MachineMetricsProps = {
  * null the panel shows a quiet "no samples yet" placeholder (offline / just
  * enrolled). GPU rows only render when `gpuUtilPct` is non-null.
  */
-export declare function MachineMetrics({ metrics, density, className }: MachineMetricsProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineMetrics({ metrics, density, className }: MachineMetricsProps): import("react").JSX.Element;

package/dist/components/machine-status-pill.d.ts

@@ -1,4 +1,4 @@
-import { type ConnectionStatus, type MachineState } from "../types/machines";
+import { type ConnectionStatus, type MachineState } from "../types/machines.js";
 export type ConnectionStatusMeta = {
     label: string;
     dotClassName: string;
@@ -30,13 +30,13 @@ export type ConnectionStatusPillProps = {
  * the Machines dashboard, the dock header, and the session timeline. Reconnecting
  * breathes (the resiliency-as-headline blip), online/offline hold still.
  */
-export declare function ConnectionStatusPill({ status, label, size, className, }: ConnectionStatusPillProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConnectionStatusPill({ status, label, size, className, }: ConnectionStatusPillProps): import("react").JSX.Element;
 export type ConnectionDotProps = {
     status: ConnectionStatus;
     className?: string | undefined;
 };
 /** Just the dot — for dense rows, the dock header, and timeline notices. */
-export declare function ConnectionDot({ status, className }: ConnectionDotProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConnectionDot({ status, className }: ConnectionDotProps): import("react").JSX.Element;
 export type MachineStatusPillProps = {
     /** The machine's full state — drives the connection pill + any state badge. */
     state: MachineState;
@@ -51,4 +51,4 @@ export type MachineStatusPillProps = {
  * dashboard row, the dock header, and the timeline all reuse so the status
  * language is identical everywhere.
  */
-export declare function MachineStatusPill({ state, sharedSessionCount, size, className, }: MachineStatusPillProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineStatusPill({ state, sharedSessionCount, size, className, }: MachineStatusPillProps): import("react").JSX.Element;

package/dist/components/machines/health.d.ts

@@ -1,4 +1,4 @@
-import type { MachineState, MetricSample } from "../../types/machines";
+import type { MachineState, MetricSample } from "../../types/machines.js";
 export type HealthLevel = "healthy" | "degraded" | "critical" | "offline" | "unknown";
 export type HealthVerdict = {
     level: HealthLevel;

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

@@ -1,5 +1,5 @@
-import type { MachineView, MetricSample } from "../../types/machines";
-import { type MetricWindow } from "./series";
+import type { MachineView, MetricSample } from "../../types/machines.js";
+import { type MetricWindow } from "./series.js";
 export type MachineDetailProps = {
     machine: MachineView;
     /** Downsampled history for the active window (from `fetchSeries`). */
@@ -13,4 +13,4 @@ export type MachineDetailProps = {
     now?: number | undefined;
     className?: string | undefined;
 };
-export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, onRemove, now, className, }: MachineDetailProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, onRemove, now, className, }: MachineDetailProps): import("react").JSX.Element;

package/dist/components/machines/metric-history-chart.d.ts

@@ -21,4 +21,4 @@ export type MetricHistoryChartProps = {
     rangeLabel?: string | undefined;
     className?: string | undefined;
 };
-export declare function MetricHistoryChart({ points, yMax, yMin, format, unit, color, thresholds, height, rangeLabel, className, }: MetricHistoryChartProps): import("react/jsx-runtime").JSX.Element;
+export declare function MetricHistoryChart({ points, yMax, yMin, format, unit, color, thresholds, height, rangeLabel, className, }: MetricHistoryChartProps): import("react").JSX.Element;

package/dist/components/machines/metric-sparkline.d.ts

@@ -1,4 +1,4 @@
-import type { SeriesPoint } from "./metric-history-chart";
+import type { SeriesPoint } from "./metric-history-chart.js";
 export type MetricSparklineProps = {
     points: SeriesPoint[];
     color?: string;
@@ -6,4 +6,4 @@ export type MetricSparklineProps = {
     height?: number;
     className?: string | undefined;
 };
-export declare function MetricSparkline({ points, color, yMax, height, className, }: MetricSparklineProps): import("react/jsx-runtime").JSX.Element;
+export declare function MetricSparkline({ points, color, yMax, height, className, }: MetricSparklineProps): import("react").JSX.Element;

package/dist/components/machines/series.d.ts

@@ -1,5 +1,5 @@
-import type { MetricSample } from "../../types/machines";
-import type { SeriesPoint } from "./metric-history-chart";
+import type { MetricSample } from "../../types/machines.js";
+import type { SeriesPoint } from "./metric-history-chart.js";
 export type MetricWindow = "15m" | "1h" | "6h" | "24h";
 export declare const METRIC_WINDOWS: MetricWindow[];
 export declare const WINDOW_LABEL: Record<MetricWindow, string>;

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

@@ -1,4 +1,4 @@
-import type { MachineView, MetricSample } from "../types/machines";
+import type { MachineView, MetricSample } from "../types/machines.js";
 export type MachinesDashboardProps = {
     machines: MachineView[];
     /** The session's active sandbox id (drives the per-card "Active" marker). */
@@ -27,4 +27,4 @@ export type MachinesDashboardProps = {
  * machines → connect CTA), a load error, and the populated grid. The component
  * is purely presentational — feed it `MachinesResponse` data via `useMachines`.
  */
-export declare function MachinesDashboard({ machines, activeSandboxId, loading, error, onAttach, attachingSandboxId, seriesByMachine, onOpenDetail, now, onEnroll, onRefresh, className, }: MachinesDashboardProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachinesDashboard({ machines, activeSandboxId, loading, error, onAttach, attachingSandboxId, seriesByMachine, onOpenDetail, now, onEnroll, onRefresh, className, }: MachinesDashboardProps): import("react").JSX.Element;

package/dist/components/markdown.d.ts

@@ -25,7 +25,7 @@ export type MarkdownProps = {
      */
     streaming?: boolean | undefined;
 };
-declare function MarkdownImpl({ children, className, streaming }: MarkdownProps): import("react/jsx-runtime").JSX.Element;
+declare function MarkdownImpl({ children, className, streaming }: MarkdownProps): import("react").JSX.Element;
 /** Memoized so streaming re-renders of the parent don't re-parse settled bodies. */
 export declare const Markdown: import("react").MemoExoticComponent<typeof MarkdownImpl>;
 export {};

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

@@ -1,6 +1,6 @@
-import type { SessionEvent, SessionStatus } from "@opengeni/sdk";
+import type { DraftTimelineAnnotation, SessionEvent, SessionStatus } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import { type AgentMessageItem, type AuthNeededItem, type TimelineGroup, type TimelineItem, type RetainedScreenshotLoader, type ToolRegistry, type TurnSummaryOptions, type UserMessageItem } from "../timeline";
+import { type AgentMessageItem, type AuthNeededItem, type TimelineGroup, type TimelineItem, type RetainedArtifactLoader, type RetainedScreenshotLoader, type VideoArtifactPlaybackLoader, type ToolRegistry, type TurnSummaryOptions, type UserMessageItem } from "../timeline/index.js";
 export type MessageTimelineProps = {
     /** Raw session events (projected internally) … */
     events?: SessionEvent[] | undefined;
@@ -51,6 +51,10 @@ export type MessageTimelineProps = {
     toolRegistry?: ToolRegistry | undefined;
     /** Resolve opaque retained screenshot receipts through the authenticated host SDK. */
     loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
+    /** Resolve permanent generated-image receipts through the authenticated host SDK. */
+    loadRetainedArtifact?: RetainedArtifactLoader | undefined;
+    /** Mint short-lived native playback sources for retained generated videos. */
+    loadVideoArtifactPlayback?: VideoArtifactPlaybackLoader | undefined;
     /**
      * Display name of the session's active compute target (Connected Machine or
      * cloud sandbox). When set, exec_command collapsed previews prefix `on {label}`.
@@ -60,6 +64,8 @@ export type MessageTimelineProps = {
     turnSummary?: TurnSummaryOptions | undefined;
     /** Follow new events when pinned to the bottom. Defaults to true. */
     autoFollow?: boolean | undefined;
+    /** Capture a same-row text selection into the host's canonical composer draft. */
+    onAnnotate?: ((annotation: DraftTimelineAnnotation) => void) | undefined;
     /** Older durable history exists above the current window (see useSessionEvents). */
     hasOlder?: boolean | undefined;
     /** An older window is being fetched; shows the quiet top shimmer. */
@@ -92,7 +98,7 @@ export type MessageTimelineProps = {
  * cards, goal markers, and status transitions. Owns stick-to-bottom scrolling
  * with a "jump to latest" affordance when the reader scrolls back.
  */
-export declare function MessageTimeline({ events, items, status: _status, renderMessageText, onOpenSession, onMemoryClick, onReconnect, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, computeLabel, turnSummary, autoFollow, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageTimeline({ events, items, status: _status, renderMessageText, onOpenSession, onMemoryClick, onReconnect, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, turnSummary, autoFollow, onAnnotate, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
 /**
  * Settled turns lift the final agent answer out as a sibling group. Include it
  * in "Copy turn" when present so the chip copies the full assistant reply.
@@ -104,10 +110,11 @@ export declare function trailingAgentTextAfterTurn(group: TimelineGroup, next: T
  * landmark, notice). Exported so the component demo draws the EXACT same rows as
  * the live app — no forked bubble/goal markup.
  */
-export declare function TimelineRow({ item, renderMessageText, onReconnect, resolveProviderLogo, onOpenSession, }: {
+export declare function TimelineRow({ item, renderMessageText, onReconnect, resolveProviderLogo, onOpenSession, loadVideoArtifactPlayback, }: {
     item: TimelineItem;
     renderMessageText?: ((text: string, item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
     onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
     resolveProviderLogo?: ((providerDomain: string) => string | null | undefined) | undefined;
     onOpenSession?: ((sessionId: string) => void) | undefined;
-}): import("react/jsx-runtime").JSX.Element | null;
+    loadVideoArtifactPlayback?: VideoArtifactPlaybackLoader | undefined;
+}): import("react").JSX.Element | null;

package/dist/components/model-picker.d.ts

@@ -1,5 +1,5 @@
 import type { ClientModel } from "@opengeni/sdk";
-import { type PickerModelRow } from "../model-policy";
+import { type PickerModelRow } from "../model-policy.js";
 export type ModelPickerProps = {
     /** Legacy host config models grouped by provider. */
     models?: ClientModel[] | undefined;
@@ -16,4 +16,4 @@ export type ModelPickerProps = {
      */
     codexOnly?: boolean | undefined;
 };
-export declare function ModelPicker({ models, rows, value, onChange, disabled, className, label, codexOnly, }: ModelPickerProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ModelPicker({ models, rows, value, onChange, disabled, className, label, codexOnly, }: ModelPickerProps): import("react").JSX.Element | null;