@opengeni/react 0.46.1 → 0.52.1

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/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`). */
@@ -8,7 +8,9 @@ export type MachineDetailProps = {
     onWindowChange: (w: MetricWindow) => void;
     loadingSeries?: boolean | undefined;
     onBack?: (() => void) | undefined;
+    /** Open the workspace-admin removal confirmation for a self-hosted machine. */
+    onRemove?: ((machine: MachineView) => void) | undefined;
     now?: number | undefined;
     className?: string | undefined;
 };
-export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, now, className, }: MachineDetailProps): import("react/jsx-runtime").JSX.Element;
+export declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, onRemove, now, className, }: MachineDetailProps): import("react").JSX.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). */
@@ -15,16 +15,16 @@ export type MachinesDashboardProps = {
     onOpenDetail?: ((machine: MachineView) => void) | undefined;
     /** Shared clock so freshness/relative times render consistently across cards. */
     now?: number | undefined;
-    /** Open the enrollment flow (the "Enroll a machine" CTA). */
+    /** Open the connection flow (the "Connect a machine" CTA). */
     onEnroll?: (() => void) | undefined;
     onRefresh?: (() => void) | undefined;
     className?: string | undefined;
 };
 /**
- * The workspace Machines dashboard: the fleet of selfhosted enrollments + the
+ * The workspace Machines dashboard: the fleet of Connected Machines + the
  * session's managed sandbox, each with its connection-status pill, state badges,
  * latest metrics, and an attach/swap affordance. Renders the empty state (no
- * machines → enroll CTA), a load error, and the populated grid. The component
+ * machines → connect CTA), a load error, and the populated grid. The component
  * is purely presentational — feed it `MachinesResponse` data via `useMachines`.
  */
-export declare function MachinesDashboard({ machines, activeSandboxId, loading, error, onAttach, attachingSandboxId, seriesByMachine, onOpenDetail, now, onEnroll, onRefresh, className, }: MachinesDashboardProps): import("react/jsx-runtime").JSX.Element;
+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 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;
@@ -29,6 +29,12 @@ export type MessageTimelineProps = {
      * a Reconnect button without a handler to run it.
      */
     onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
+    /**
+     * Decide which durable authentication notices this timeline presents.
+     * Defaults to showing every notice. Embedded hosts can suppress notices for
+     * credentials they manage elsewhere without discarding the underlying event.
+     */
+    shouldRenderAuthNeeded?: ((item: AuthNeededItem) => boolean) | undefined;
     /**
      * Resolve a provider domain (from a reconnect card) to a logo URL the host
      * serves itself — the app maps it through its catalog + `catalogAssetUrl`.
@@ -43,6 +49,12 @@ export type MessageTimelineProps = {
      * `createDefaultToolRegistry({ entries })` to add custom tool renderers.
      */
     toolRegistry?: ToolRegistry | undefined;
+    /** Resolve opaque retained screenshot receipts through the authenticated host SDK. */
+    loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
+    /** 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}`.
@@ -52,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. */
@@ -73,6 +87,8 @@ export type MessageTimelineProps = {
      * scrolls the in-memory window.
      */
     onJumpToLatest?: (() => void | Promise<void>) | undefined;
+    /** Host-owned content appended after timeline groups, such as startup progress. */
+    trailingState?: ReactNode | undefined;
     emptyState?: ReactNode | undefined;
     className?: string | undefined;
 };
@@ -82,7 +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, resolveProviderLogo, toolRegistry, computeLabel, turnSummary, autoFollow, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, emptyState, className, }: MessageTimelineProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageTimeline({ events, items, status: _status, renderMessageText, onOpenSession, onMemoryClick, onReconnect, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, 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.
@@ -94,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;

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

@@ -1,6 +1,6 @@
 import type { ClientModel, LatencyMode, ReasoningEffort } from "@opengeni/sdk";
 import { type CSSProperties, type ReactNode } from "react";
-import { type PickerBillingClass, type PickerModelRow } from "../model-policy";
+import { type PickerBillingClass, type PickerModelRow } from "../model-policy.js";
 type NavLevel = "providers" | "models" | "thinking";
 type PickerNavState = {
     level: NavLevel;
@@ -55,7 +55,7 @@ export declare function BillingClassMark(props: {
     billingClass: PickerBillingClass;
     className?: string | undefined;
     "aria-label"?: string | undefined;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function PickerNavRow(props: {
     label: string;
     hint?: string | undefined;
@@ -67,21 +67,21 @@ export declare function PickerNavRow(props: {
     active?: boolean | undefined;
     testId?: string | undefined;
     onClick: () => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function PickerBackHeader(props: {
     label: string;
     icon?: ReactNode;
     onBack: () => void;
     trailing?: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function PickerAnimatedPage(props: {
     pageKey: string;
     direction: 1 | -1;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function ModelPolicyPickerMenu(props: ModelPolicyPickerProps & {
     nav?: PickerNavState | undefined;
     onNavChange?: ((next: NavUpdater) => void) | undefined;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function ModelPolicyPicker(props: ModelPolicyPickerProps): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
+export declare function ModelPolicyPicker(props: ModelPolicyPickerProps): import("react").JSX.Element;
 export {};

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

@@ -31,4 +31,4 @@ export type PierreDiffProps = {
  * `GitFileDiff` hunks). The ONE workbench diff renderer; a host without
  * `@pierre/diffs` gets the built-in plain-text degrade (`PlainPatch`).
  */
-export declare function PierreDiff({ diff, layout, themeType, theme, disableWorkerPool, loading, fallback, plain, overflow, className, }: PierreDiffProps): import("react/jsx-runtime").JSX.Element;
+export declare function PierreDiff({ diff, layout, themeType, theme, disableWorkerPool, loading, fallback, plain, overflow, className, }: PierreDiffProps): import("react").JSX.Element;

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

@@ -24,4 +24,4 @@ export type PierreFileProps = {
  * clicking any file in the tree shows its contents (NOT a diff; no repo needed).
  * Falls back to a plain `<pre>` when `@pierre/diffs` is absent / fails to import.
  */
-export declare function PierreFile({ path, contents, themeType, theme, disableWorkerPool, loading, fallback, className, }: PierreFileProps): import("react/jsx-runtime").JSX.Element;
+export declare function PierreFile({ path, contents, themeType, theme, disableWorkerPool, loading, fallback, className, }: PierreFileProps): import("react").JSX.Element;

package/dist/components/queue-draft-policy.d.ts

@@ -1,4 +1,4 @@
-import type { ComposerState } from "../hooks/use-composer";
+import type { ComposerState } from "../hooks/use-composer.js";
 /**
  * Decide whether checking out a queued prompt would replace current composer
  * content. `hasDraftContent` reads the synchronous draft refs, so this stays

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

@@ -1,5 +1,5 @@
-import type { ComposerState } from "../hooks/use-composer";
-import type { UseTurnQueueResult } from "../hooks/use-turn-queue";
+import type { ComposerState } from "../hooks/use-composer.js";
+import type { UseTurnQueueResult } from "../hooks/use-turn-queue.js";
 /** The sole pending-input surface: compact above Goal, Agents, and composer. */
 type QueueSurfaceCommonProps = {
     /** Focus the composer owned by this queue after checkout/removal. */
@@ -16,5 +16,5 @@ export type QueueSurfaceProps = (QueueSurfaceCommonProps & {
 });
 /** @internal Pure policy seam for queue/composer embedding tests. */
 export declare function queueComposerCheckoutEnabled(composer: ComposerState | undefined, readOnly: boolean): boolean;
-export declare function QueueSurface({ queue, composer, readOnly, onRequestComposerFocus, }: QueueSurfaceProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function QueueSurface({ queue, composer, readOnly, onRequestComposerFocus, }: QueueSurfaceProps): import("react").JSX.Element | null;
 export {};

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

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

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

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

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

@@ -1,10 +1,10 @@
-import { type UseSandboxFilesResult } from "../hooks/use-sandbox-files";
-import type { UseSandboxGitResult } from "../hooks/use-sandbox-git";
+import { type UseSandboxFilesResult } from "../hooks/use-sandbox-files.js";
+import type { UseSandboxGitResult } from "../hooks/use-sandbox-git.js";
 export type SandboxFilesProps = {
     /** From `useSandboxFiles(...)`. */
     files: UseSandboxFilesResult;
-    /** From `useSandboxGit(...)` — drives the branch/dirty header only. */
-    git: UseSandboxGitResult;
+    /** Compatibility fallback for callers that have not yet adopted `files.gitSummary`. */
+    git?: UseSandboxGitResult | undefined;
     /** @deprecated Diffs live in the dedicated Changes tab now; accepted for
      *  source-compat but unused (the Files surface is a browser + viewer). */
     stagedGit?: UseSandboxGitResult | undefined;
@@ -46,4 +46,4 @@ export type SandboxFilesProps = {
  * surface deliberately does NOT replicate the changed-files list, and does not
  * diff here — one job per tab). The agent commits; the human reviews.
  */
-export declare function SandboxFiles({ files, git, fileSystemAvailable, usePierre, editable, onEditIntent, requestedPath, requestedPathRequestId, requestedPathReady, workspaceResting, workspaceWaking, liveWorkspaceReady, onWakeWorkspace, themeType, className, }: SandboxFilesProps): import("react/jsx-runtime").JSX.Element;
+export declare function SandboxFiles({ files, git, fileSystemAvailable, usePierre, editable, onEditIntent, requestedPath, requestedPathRequestId, requestedPathReady, workspaceResting, workspaceWaking, liveWorkspaceReady, onWakeWorkspace, themeType, className, }: SandboxFilesProps): import("react").JSX.Element;

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

@@ -1,7 +1,8 @@
 import type { TerminalCapability } from "@opengeni/sdk";
 import { type ReactNode } from "react";
-import type { UseSandboxTerminalResult } from "../hooks/use-sandbox-terminal";
-import { type RendererTier } from "../lib/xterm-renderer";
+import { type TerminalStreamStatus } from "../hooks/use-terminal-stream.js";
+import type { UseSandboxTerminalResult } from "../hooks/use-sandbox-terminal.js";
+import { type RendererTier } from "../lib/xterm-renderer.js";
 /**
  * A COMPLETE xterm `ITheme` (subset by intent, but every field xterm colors a
  * cell with is present so it never falls back to its stock VGA palette). Built
@@ -55,7 +56,7 @@ export type SandboxTerminalProps = {
     fontSize?: number | undefined;
     /**
      * Lease liveness (`cold` | `warming` | `warm` | `draining`). Drives the
-     * boot-in-terminal status lines: once the user has focused the terminal and
+     * boot-in-terminal status lines: once the user has engaged the terminal and
      * the box is not yet warm, a styled "● waking machine — Ns…" line is rendered
      * INSIDE xterm (no overlay/spinner) until the live PTY connects.
      */
@@ -82,6 +83,51 @@ export type SandboxTerminalProps = {
     onActivate?: (() => void) | undefined;
     className?: string | undefined;
 };
+type XtermLike = {
+    open: (el: HTMLElement) => void;
+    write: (data: string) => void;
+    clear: () => void;
+    onData: (cb: (data: string) => void) => {
+        dispose: () => void;
+    };
+    onResize: (cb: (size: {
+        cols: number;
+        rows: number;
+    }) => void) => {
+        dispose: () => void;
+    };
+    loadAddon: (addon: unknown) => void;
+    dispose: () => void;
+    cols: number;
+    rows: number;
+    options: {
+        theme?: XtermTheme;
+        disableStdin?: boolean;
+        cursorBlink?: boolean;
+        fontFamily?: string;
+        fontSize?: number;
+    };
+};
+export type TerminalSurfaceState = "loading" | "connecting" | "error" | "waking" | "output-only" | "interactive";
+/**
+ * Stable semantic state for hosts and browser acceptance. The xterm helper
+ * textarea exists before the live PTY socket is ready, so its presence alone
+ * must never be treated as proof that keystrokes can reach the sandbox.
+ */
+export declare function terminalSurfaceState(input: {
+    ready: boolean;
+    acceptsInput: boolean;
+    inputPending: boolean;
+    ptyStatus: TerminalStreamStatus;
+    booting: boolean;
+}): TerminalSurfaceState;
+export declare function subscribeTerminalInput(term: Pick<XtermLike, "onData"> | null, sink: ((data: string) => void) | null, enabled: boolean): {
+    dispose: () => void;
+} | null;
+/** Clear the transient wake line and put the first live prompt at cell 1,1.
+ * `Terminal.clear()` removes scrollback but deliberately preserves the cursor,
+ * which lets the first PTY frame append to the old wake message. */
+export declare function clearTerminalBootStatus(term: Pick<XtermLike, "write">): void;
 /** Debug seam (dev/evidence only, never a typed public API): a global hook the
  *  screenshot harness reads to probe the settled renderer tier + resolved font
  *  without mounting a real WebGL context in unit tests. */
@@ -119,5 +165,5 @@ declare global {
  * Resizes are tracked with a `ResizeObserver` on the container (not just
  * `window.resize`) so dragging the dock handle refits the grid.
  */
-export declare function SandboxTerminal({ result, terminalCapability, theme, fontFamily, fontSize, liveness, readOnly, placeholder, showHeader, shell, onActivate, className, }: SandboxTerminalProps): import("react/jsx-runtime").JSX.Element;
+export declare function SandboxTerminal({ result, terminalCapability, theme, fontFamily, fontSize, liveness, readOnly, placeholder, showHeader, shell, onActivate, className, }: SandboxTerminalProps): import("react").JSX.Element;
 export {};