@opengeni/react 0.13.0 → 0.15.0

package/dist/{machines-CnlMb7E-.d.ts → machines-BpdwuQcD.d.ts}

@@ -1,4 +1,4 @@
-import { OpenGeniClient, MachineState, MetricSample, MachineView, MachineKind, MachinesResponse } from '@opengeni/sdk';
+import { OpenGeniClient, WorkspaceControlEvent, StreamConnectionState, MachineState, MetricSample, MachineView, MachineKind, MachinesResponse } from '@opengeni/sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
@@ -7,22 +7,27 @@ import { ReactNode } from 'react';
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listEvents" | "streamEvents" | "getQueue" | "cancelQueueItem" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "fsList" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose">;
+type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "fsList" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose">;
 
 type OpenGeniContextValue = {
     client: SessionClientLike;
     workspaceId: string;
+    workspaceControlEvent: WorkspaceControlEvent | null;
+    workspaceControlConnectionState: StreamConnectionState | "idle" | "error";
+    registerSessionReconciler: (sessionId: string, key: string, reconcile: () => Promise<void>) => () => void;
+    reconcileSession: (sessionId: string) => Promise<void>;
 };
 type OpenGeniProviderProps = {
     client: SessionClientLike;
     workspaceId: string;
+    onWorkspaceControlEvent?: ((event: WorkspaceControlEvent) => void) | undefined;
     children?: ReactNode;
 };
 /**
  * Supplies the OpenGeni client + workspace to all hooks below it. Hooks also
  * accept `{ client, workspaceId }` overrides per call for multi-workspace UIs.
  */
-declare function OpenGeniProvider({ client, workspaceId, children }: OpenGeniProviderProps): react_jsx_runtime.JSX.Element;
+declare function OpenGeniProvider({ client, workspaceId, onWorkspaceControlEvent, children, }: OpenGeniProviderProps): react_jsx_runtime.JSX.Element;
 type ClientOverride = {
     client?: SessionClientLike | undefined;
     workspaceId?: string | undefined;
@@ -120,15 +125,124 @@ type MachineCardProps = {
     onAttach?: ((machine: MachineView) => void) | undefined;
     /** Whether an attach/swap is currently in flight (disables the affordance). */
     attaching?: boolean | undefined;
+    /** Short recent history (e.g. 15m) — drives the card's CPU trend + preview. */
+    series?: MetricSample[] | undefined;
+    /** Open the full per-machine telemetry detail. Makes the whole card actionable. */
+    onOpenDetail?: ((machine: MachineView) => void) | undefined;
+    now?: number | undefined;
     className?: string | undefined;
 };
 /**
- * One machine in the Machines dashboard: name + kind + OS/arch, the composite
- * connection/state/shared status, latest resource meters, last-seen recency, and
- * an attach/swap affordance. The session's currently-active sandbox carries an
- * accent edge + an "Active" marker (never an attach button — it's already active).
+ * One machine in the Machines dashboard: name + kind + OS/arch, the fused HEALTH
+ * verdict, latest resource meters, a CPU trend that previews the history, live
+ * freshness, and attach/swap. The whole card opens the telemetry detail when
+ * `onOpenDetail` is wired. The session's active sandbox carries an accent edge.
  */
-declare function MachineCard({ machine, onAttach, attaching, className }: MachineCardProps): react_jsx_runtime.JSX.Element;
+declare function MachineCard({ machine, onAttach, attaching, series, onOpenDetail, now, className, }: MachineCardProps): react_jsx_runtime.JSX.Element;
+
+type MachineHealthPillProps = {
+    state: MachineState;
+    metrics: MetricSample | null;
+    now?: number | undefined;
+    size?: "sm" | "md" | undefined;
+    className?: string | undefined;
+};
+declare function MachineHealthPill({ state, metrics, now, size, className, }: MachineHealthPillProps): react_jsx_runtime.JSX.Element;
+
+type HealthLevel = "healthy" | "degraded" | "critical" | "offline" | "unknown";
+type HealthVerdict = {
+    level: HealthLevel;
+    /** Title-case label for the pill ("Healthy", "Under load", "Critical", …). */
+    label: string;
+    /** One short human clause naming the dominant cause ("Memory 94%", "No display"…). */
+    reason: string;
+    /** The latest sample is older than we'd expect from a live agent (~5s cadence). */
+    stale: boolean;
+};
+/** Fold a machine's reachability + latest sample + wall-clock into one verdict. */
+declare function deriveHealth(state: MachineState, metrics: MetricSample | null, now?: number): HealthVerdict;
+/**
+ * The token color ramp for a health level. Green/amber/red/grey is the
+ * universally-legible traffic model; we reserve it for the HEALTH verdict
+ * specifically (per-resource meters keep their own ramp in `machine-metrics`).
+ */
+declare const HEALTH_TOKEN: Record<HealthLevel, {
+    text: string;
+    dot: string;
+    soft: string;
+}>;
+/** Live/transient levels breathe; settled levels hold still. */
+declare function healthPulses(level: HealthLevel): boolean;
+
+type SeriesPoint = {
+    t: number;
+    v: number | null;
+};
+type MetricHistoryChartProps = {
+    points: SeriesPoint[];
+    /** Fixed ceiling (100 for %) or "auto" to fit the data with headroom. */
+    yMax?: number | "auto";
+    yMin?: number;
+    /** Format a value for the axis + readout (default: rounded + unit). */
+    format?: (v: number) => string;
+    unit?: string;
+    /** Stroke/fill hue — any CSS color; pass a token var to stay theme-safe. */
+    color?: string;
+    thresholds?: {
+        warn?: number | undefined;
+        crit?: number | undefined;
+    } | undefined;
+    height?: number;
+    /** Human range label for the empty state ("in the last hour"). */
+    rangeLabel?: string | undefined;
+    className?: string | undefined;
+};
+declare function MetricHistoryChart({ points, yMax, yMin, format, unit, color, thresholds, height, rangeLabel, className, }: MetricHistoryChartProps): react_jsx_runtime.JSX.Element;
+
+type MetricSparklineProps = {
+    points: SeriesPoint[];
+    color?: string;
+    yMax?: number | "auto";
+    height?: number;
+    className?: string | undefined;
+};
+declare function MetricSparkline({ points, color, yMax, height, className, }: MetricSparklineProps): react_jsx_runtime.JSX.Element;
+
+type MetricWindow = "15m" | "1h" | "6h" | "24h";
+declare const METRIC_WINDOWS: MetricWindow[];
+declare const WINDOW_LABEL: Record<MetricWindow, string>;
+type MetricKey = "cpu" | "mem" | "disk" | "load" | "gpu";
+type MetricDef = {
+    key: MetricKey;
+    title: string;
+    unit: string;
+    yMax: number | "auto";
+    color: string;
+    thresholds?: {
+        warn?: number;
+        crit?: number;
+    };
+    pick: (s: MetricSample) => number | null;
+    /** Big current-value string for tiles/badges. */
+    current: (s: MetricSample) => string;
+    /** Optional sub-line under the current value. */
+    sub?: (s: MetricSample) => string | null;
+};
+declare const METRICS: MetricDef[];
+declare function pointsFor(def: MetricDef, samples: MetricSample[]): SeriesPoint[];
+
+type MachineDetailProps = {
+    machine: MachineView;
+    /** Downsampled history for the active window (from `fetchSeries`). */
+    series: MetricSample[];
+    window: MetricWindow;
+    onWindowChange: (w: MetricWindow) => void;
+    loadingSeries?: boolean | undefined;
+    onBack?: (() => void) | undefined;
+    now?: number | undefined;
+    className?: string | undefined;
+};
+declare function MachineDetail({ machine, series, window, onWindowChange, loadingSeries, onBack, now, className, }: MachineDetailProps): react_jsx_runtime.JSX.Element;
 
 type MachinesDashboardProps = {
     machines: MachineView[];
@@ -140,6 +254,12 @@ type MachinesDashboardProps = {
     onAttach?: ((machine: MachineView) => void) | undefined;
     /** The sandbox id currently being attached/swapped to (disables that card). */
     attachingSandboxId?: string | null | undefined;
+    /** Short recent history per machine (keyed by sandboxId) — drives card sparklines. */
+    seriesByMachine?: Record<string, MetricSample[]> | undefined;
+    /** Open the per-machine telemetry detail (makes each card actionable). */
+    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). */
     onEnroll?: (() => void) | undefined;
     onRefresh?: (() => void) | undefined;
@@ -152,7 +272,7 @@ type MachinesDashboardProps = {
  * machines → enroll CTA), a load error, and the populated grid. The component
  * is purely presentational — feed it `MachinesResponse` data via `useMachines`.
  */
-declare function MachinesDashboard({ machines, activeSandboxId, loading, error, onAttach, attachingSandboxId, onEnroll, onRefresh, className, }: MachinesDashboardProps): react_jsx_runtime.JSX.Element;
+declare function MachinesDashboard({ machines, activeSandboxId, loading, error, onAttach, attachingSandboxId, seriesByMachine, onOpenDetail, now, onEnroll, onRefresh, className, }: MachinesDashboardProps): react_jsx_runtime.JSX.Element;
 
 type MachineDockBarProps = {
     /** The active machine's display name. */
@@ -326,4 +446,4 @@ type UseMachinesResult = {
  */
 declare function useMachines(options?: UseMachinesOptions): UseMachinesResult;
 
-export { SharedMachineDisclosure as A, type SharedMachineDisclosureProps as B, type ClientOverride as C, type DeviceFlowPhase as D, EnrollmentConsent as E, type UseMachinesResult as F, connectionStatusForState as G, useMachines as H, useOpenGeni as I, useOpenGeniClient as J, MACHINE_STATE_BADGE_META as M, type OpenGeniContextValue as O, type SessionClientLike as S, type UseMachinesOptions as U, CONNECTION_STATUS_META as a, ConnectionDot as b, type ConnectionDotProps as c, type ConnectionStatus as d, type ConnectionStatusMeta as e, ConnectionStatusPill as f, type ConnectionStatusPillProps as g, type EnrollmentConsentMachine as h, type EnrollmentConsentPhase as i, type EnrollmentConsentProps as j, EnrollmentDeviceFlow as k, type EnrollmentDeviceFlowProps as l, MachineCard as m, type MachineCardProps as n, MachineDockBar as o, type MachineDockBarProps as p, MachineMetrics as q, type MachineMetricsProps as r, type MachineStateBadgeMeta as s, MachineStatusPill as t, type MachineStatusPillProps as u, type MachinesClientLike as v, MachinesDashboard as w, type MachinesDashboardProps as x, OpenGeniProvider as y, type OpenGeniProviderProps as z };
+export { WINDOW_LABEL as $, type MachineStateBadgeMeta as A, MachineStatusPill as B, type ClientOverride as C, type DeviceFlowPhase as D, EnrollmentConsent as E, type MachineStatusPillProps as F, type MachinesClientLike as G, HEALTH_TOKEN as H, MachinesDashboard as I, type MachinesDashboardProps as J, type MetricDef as K, MetricHistoryChart as L, MACHINE_STATE_BADGE_META as M, type MetricHistoryChartProps as N, type MetricKey as O, MetricSparkline as P, type MetricSparklineProps as Q, type MetricWindow as R, type SessionClientLike as S, type OpenGeniContextValue as T, OpenGeniProvider as U, type OpenGeniProviderProps as V, type SeriesPoint as W, SharedMachineDisclosure as X, type SharedMachineDisclosureProps as Y, type UseMachinesOptions as Z, type UseMachinesResult as _, CONNECTION_STATUS_META as a, connectionStatusForState as a0, deriveHealth as a1, healthPulses as a2, pointsFor as a3, useMachines as a4, useOpenGeni as a5, useOpenGeniClient as a6, ConnectionDot as b, type ConnectionDotProps as c, type ConnectionStatus as d, type ConnectionStatusMeta as e, ConnectionStatusPill as f, type ConnectionStatusPillProps as g, type EnrollmentConsentMachine as h, type EnrollmentConsentPhase as i, type EnrollmentConsentProps as j, EnrollmentDeviceFlow as k, type EnrollmentDeviceFlowProps as l, type HealthLevel as m, type HealthVerdict as n, METRICS as o, METRIC_WINDOWS as p, MachineCard as q, type MachineCardProps as r, MachineDetail as s, type MachineDetailProps as t, MachineDockBar as u, type MachineDockBarProps as v, MachineHealthPill as w, type MachineHealthPillProps as x, MachineMetrics as y, type MachineMetricsProps as z };

package/dist/machines.d.ts

@@ -1,4 +1,4 @@
-export { a as CONNECTION_STATUS_META, b as ConnectionDot, c as ConnectionDotProps, d as ConnectionStatus, e as ConnectionStatusMeta, f as ConnectionStatusPill, g as ConnectionStatusPillProps, D as DeviceFlowPhase, E as EnrollmentConsent, h as EnrollmentConsentMachine, i as EnrollmentConsentPhase, j as EnrollmentConsentProps, k as EnrollmentDeviceFlow, l as EnrollmentDeviceFlowProps, M as MACHINE_STATE_BADGE_META, m as MachineCard, n as MachineCardProps, o as MachineDockBar, p as MachineDockBarProps, q as MachineMetrics, r as MachineMetricsProps, s as MachineStateBadgeMeta, t as MachineStatusPill, u as MachineStatusPillProps, v as MachinesClientLike, w as MachinesDashboard, x as MachinesDashboardProps, A as SharedMachineDisclosure, B as SharedMachineDisclosureProps, U as UseMachinesOptions, F as UseMachinesResult, G as connectionStatusForState, H as useMachines } from './machines-CnlMb7E-.js';
+export { a as CONNECTION_STATUS_META, b as ConnectionDot, c as ConnectionDotProps, d as ConnectionStatus, e as ConnectionStatusMeta, f as ConnectionStatusPill, g as ConnectionStatusPillProps, D as DeviceFlowPhase, E as EnrollmentConsent, h as EnrollmentConsentMachine, i as EnrollmentConsentPhase, j as EnrollmentConsentProps, k as EnrollmentDeviceFlow, l as EnrollmentDeviceFlowProps, H as HEALTH_TOKEN, m as HealthLevel, n as HealthVerdict, M as MACHINE_STATE_BADGE_META, o as METRICS, p as METRIC_WINDOWS, q as MachineCard, r as MachineCardProps, s as MachineDetail, t as MachineDetailProps, u as MachineDockBar, v as MachineDockBarProps, w as MachineHealthPill, x as MachineHealthPillProps, y as MachineMetrics, z as MachineMetricsProps, A as MachineStateBadgeMeta, B as MachineStatusPill, F as MachineStatusPillProps, G as MachinesClientLike, I as MachinesDashboard, J as MachinesDashboardProps, K as MetricDef, L as MetricHistoryChart, N as MetricHistoryChartProps, O as MetricKey, P as MetricSparkline, Q as MetricSparklineProps, R as MetricWindow, W as SeriesPoint, X as SharedMachineDisclosure, Y as SharedMachineDisclosureProps, Z as UseMachinesOptions, _ as UseMachinesResult, $ as WINDOW_LABEL, a0 as connectionStatusForState, a1 as deriveHealth, a2 as healthPulses, a3 as pointsFor, a4 as useMachines } from './machines-BpdwuQcD.js';
 export { MachineKind, MachineMetricsSeriesResponse, MachineState, MachineView, MachinesResponse, MetricSample } from '@opengeni/sdk';
 import 'react/jsx-runtime';
 import 'react';

package/dist/machines.js

@@ -4,30 +4,52 @@ import {
   ConnectionStatusPill,
   EnrollmentConsent,
   EnrollmentDeviceFlow,
+  HEALTH_TOKEN,
   MACHINE_STATE_BADGE_META,
+  METRICS,
+  METRIC_WINDOWS,
   MachineCard,
+  MachineDetail,
   MachineDockBar,
+  MachineHealthPill,
   MachineMetrics,
   MachineStatusPill,
   MachinesDashboard,
+  MetricHistoryChart,
+  MetricSparkline,
   SharedMachineDisclosure,
+  WINDOW_LABEL,
   connectionStatusForState,
+  deriveHealth,
+  healthPulses,
+  pointsFor,
   useMachines
-} from "./chunk-NFYVQWIB.js";
+} from "./chunk-TOJR776I.js";
 export {
   CONNECTION_STATUS_META,
   ConnectionDot,
   ConnectionStatusPill,
   EnrollmentConsent,
   EnrollmentDeviceFlow,
+  HEALTH_TOKEN,
   MACHINE_STATE_BADGE_META,
+  METRICS,
+  METRIC_WINDOWS,
   MachineCard,
+  MachineDetail,
   MachineDockBar,
+  MachineHealthPill,
   MachineMetrics,
   MachineStatusPill,
   MachinesDashboard,
+  MetricHistoryChart,
+  MetricSparkline,
   SharedMachineDisclosure,
+  WINDOW_LABEL,
   connectionStatusForState,
+  deriveHealth,
+  healthPulses,
+  pointsFor,
   useMachines
 };
 //# sourceMappingURL=machines.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/react",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "React hooks and styled components for OpenGeni: live session streaming, chat composer, message timeline, session status, and fleet views — token-themed (CSS variables), dark-first, built on Tailwind v4 + Radix + Motion.",
   "license": "Apache-2.0",
   "repository": {
@@ -43,7 +43,10 @@
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.2.0",
-    "@opengeni/sdk": "^0.13.0",
+    "@dnd-kit/core": "6.3.1",
+    "@dnd-kit/sortable": "10.0.0",
+    "@dnd-kit/utilities": "3.2.2",
+    "@opengeni/sdk": "^0.15.0",
     "clsx": "^2.1.1",
     "lucide-react": "^1.8.0",
     "motion": "^12.0.0",

package/src/client.ts

@@ -25,7 +25,12 @@ export type SessionClientLike = Pick<
   | "streamEvents"
   // Turn queue
   | "getQueue"
-  | "cancelQueueItem"
+  | "moveQueueItem"
+  | "editQueueItem"
+  | "steerQueueItem"
+  | "deleteQueueItem"
+  | "getComposerDraft"
+  | "saveComposerDraft"
   | "listTurns"
   // Goal
   | "getGoal"
@@ -76,6 +81,10 @@ export type SessionClientLike = Pick<
   | "listWorkspaces"
   | "createWorkspace"
   | "updateWorkspace"
+  | "setWorkspaceInferenceState"
+  | "getWorkspace"
+  | "listWorkspaceControlEvents"
+  | "streamWorkspaceControlEvents"
   | "getBillingUsage"
   // Stream surfacing (Phase 5): capability negotiation + viewer lifecycle
   | "getClientConfig"