@opengeni/react 0.12.0 → 0.15.0

package/dist/{machines-BeZ3bD3t.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" | "updateSession" | "listSessions" | "sendMessage" | "steerMessage" | "interrupt" | "sendApprovalDecision" | "listEvents" | "streamEvents" | "listTurns" | "updateQueuedTurn" | "reorderQueuedTurns" | "deleteQueuedTurn" | "getGoal" | "updateGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "fsList" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "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;
@@ -76,7 +81,7 @@ type ConnectionStatusPillProps = {
  * the Machines dashboard, the dock header, and the session timeline. Reconnecting
  * breathes (the resiliency-as-headline blip), online/offline hold still.
  */
-declare function ConnectionStatusPill({ status, label, size, className }: ConnectionStatusPillProps): react_jsx_runtime.JSX.Element;
+declare function ConnectionStatusPill({ status, label, size, className, }: ConnectionStatusPillProps): react_jsx_runtime.JSX.Element;
 type ConnectionDotProps = {
     status: ConnectionStatus;
     className?: string | undefined;
@@ -97,7 +102,7 @@ type MachineStatusPillProps = {
  * dashboard row, the dock header, and the timeline all reuse so the status
  * language is identical everywhere.
  */
-declare function MachineStatusPill({ state, sharedSessionCount, size, className }: MachineStatusPillProps): react_jsx_runtime.JSX.Element;
+declare function MachineStatusPill({ state, sharedSessionCount, size, className, }: MachineStatusPillProps): react_jsx_runtime.JSX.Element;
 
 type MachineMetricsProps = {
     /** The latest metric sample, or null when the machine hasn't reported yet. */
@@ -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. */
@@ -171,7 +291,7 @@ type MachineDockBarProps = {
  * render IDENTICALLY regardless of backend — this bar is the only backend-aware
  * chrome (the dock-parity contract: selfhosted == Modal for the surfaces).
  */
-declare function MachineDockBar({ name, kind, state, sharedSessionCount, className }: MachineDockBarProps): react_jsx_runtime.JSX.Element;
+declare function MachineDockBar({ name, kind, state, className }: MachineDockBarProps): react_jsx_runtime.JSX.Element;
 type SharedMachineDisclosureProps = {
     sharedSessionCount: number;
     /** Compact (inline strip) vs full (a notice block). */
@@ -183,7 +303,7 @@ 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`.
  */
-declare function SharedMachineDisclosure({ sharedSessionCount, density, className }: SharedMachineDisclosureProps): react_jsx_runtime.JSX.Element;
+declare function SharedMachineDisclosure({ sharedSessionCount, density, className, }: SharedMachineDisclosureProps): react_jsx_runtime.JSX.Element;
 
 /** The poll state of an in-flight device-flow enrollment. */
 type DeviceFlowPhase = "pending" | "authorized" | "denied" | "expired" | "disabled";
@@ -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-BeZ3bD3t.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-5TIXRCSI.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.12.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": {
@@ -8,6 +8,11 @@
     "url": "git+https://github.com/Cloudgeni-ai/opengeni.git",
     "directory": "packages/react"
   },
+  "files": [
+    "dist",
+    "src",
+    "styles"
+  ],
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -25,20 +30,12 @@
     "./styles.css": "./styles/index.css",
     "./tokens.css": "./styles/tokens.css"
   },
-  "files": [
-    "dist",
-    "src",
-    "styles"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "scripts": {
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsgo --noEmit",
     "build": "tsup",
     "demo": "vite dev demo --port 3100",
     "demo:build": "vite build demo",
@@ -46,7 +43,10 @@
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.2.0",
-    "@opengeni/sdk": "^0.11.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",
@@ -54,7 +54,8 @@
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^4.11.2",
     "remark-gfm": "^4.0.1",
-    "tailwind-merge": "^3.5.0"
+    "tailwind-merge": "^3.5.0",
+    "virtua": "^0.49.2"
   },
   "peerDependencies": {
     "@codemirror/lang-css": "^6.0.0",
@@ -68,6 +69,7 @@
     "@uiw/react-codemirror": "^4.23.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/addon-web-links": "^0.12.0",
+    "@xterm/addon-webgl": "^0.19.0",
     "@xterm/xterm": "^6.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
@@ -106,8 +108,14 @@
     "@xterm/addon-web-links": {
       "optional": true
     },
+    "@xterm/addon-webgl": {
+      "optional": true
+    },
     "@xterm/xterm": {
       "optional": true
     }
+  },
+  "engines": {
+    "node": ">=18"
   }
 }

package/src/approvals.ts

@@ -33,13 +33,22 @@ export type PendingApproval = {
 
 /** The approvals carried by one `session.requiresAction` payload. */
 export function approvalsFromRequiresAction(payload: unknown): PendingApproval[] {
-  const approvals = payload && typeof payload === "object" ? (payload as { approvals?: unknown }).approvals : undefined;
+  const approvals =
+    payload && typeof payload === "object"
+      ? (payload as { approvals?: unknown }).approvals
+      : undefined;
   if (!Array.isArray(approvals)) {
     return [];
   }
   return approvals.map((approval, index) => {
-    const raw = (approval && typeof approval === "object" ? approval : {}) as Record<string, unknown>;
-    const rawItem = raw.rawItem && typeof raw.rawItem === "object" ? raw.rawItem as Record<string, unknown> : {};
+    const raw = (approval && typeof approval === "object" ? approval : {}) as Record<
+      string,
+      unknown
+    >;
+    const rawItem =
+      raw.rawItem && typeof raw.rawItem === "object"
+        ? (raw.rawItem as Record<string, unknown>)
+        : {};
     return {
       id: String(raw.id ?? raw.callId ?? rawItem.callId ?? index),
       name: String(raw.name ?? "approval"),
@@ -61,7 +70,10 @@ export function projectPendingApprovals(events: SessionEvent[]): PendingApproval
         break;
       }
       case "user.approvalDecision": {
-        const payload = event.payload && typeof event.payload === "object" ? event.payload as { approvalId?: unknown } : {};
+        const payload =
+          event.payload && typeof event.payload === "object"
+            ? (event.payload as { approvalId?: unknown })
+            : {};
         if (typeof payload.approvalId === "string") {
           pending = pending.filter((approval) => approval.id !== payload.approvalId);
         }

package/src/client.ts

@@ -11,22 +11,31 @@ export type SessionClientLike = Pick<
   | "getClientConfig"
   // Sessions, events, composer
   | "getSession"
+  | "getSessionLineage"
   | "updateSession"
+  | "updateSessionPin"
   | "listSessions"
+  | "listSessionPage"
   | "sendMessage"
   | "steerMessage"
-  | "interrupt"
+  | "pauseSession"
+  | "resumeSession"
   | "sendApprovalDecision"
   | "listEvents"
   | "streamEvents"
   // Turn queue
+  | "getQueue"
+  | "moveQueueItem"
+  | "editQueueItem"
+  | "steerQueueItem"
+  | "deleteQueueItem"
+  | "getComposerDraft"
+  | "saveComposerDraft"
   | "listTurns"
-  | "updateQueuedTurn"
-  | "reorderQueuedTurns"
-  | "deleteQueuedTurn"
   // Goal
   | "getGoal"
   | "updateGoal"
+  | "deleteGoal"
   // Operator context controls (/clear, /compact)
   | "clearSessionContext"
   | "compactSessionContext"
@@ -36,13 +45,33 @@ export type SessionClientLike = Pick<
   | "uploadFile"
   | "getFile"
   | "createFileDownloadUrl"
-  // Environments
+  // VariableSets
+  | "listVariableSets"
+  | "createVariableSet"
+  | "updateVariableSet"
+  | "deleteVariableSet"
+  | "setVariableSetVariable"
+  | "deleteVariableSetVariable"
   | "listEnvironments"
   | "createEnvironment"
   | "updateEnvironment"
   | "deleteEnvironment"
   | "setEnvironmentVariable"
   | "deleteEnvironmentVariable"
+  // Rigs
+  | "listRigs"
+  | "createRig"
+  | "getRig"
+  | "updateRig"
+  | "deleteRig"
+  | "listRigVersions"
+  | "activateRigVersion"
+  | "listRigChanges"
+  | "proposeRigChange"
+  | "getRigChange"
+  | "verifyRigChange"
+  | "promoteRigChange"
+  | "verifyRig"
   // Packs
   | "listPacks"
   | "registerPack"
@@ -52,6 +81,10 @@ export type SessionClientLike = Pick<
   | "listWorkspaces"
   | "createWorkspace"
   | "updateWorkspace"
+  | "setWorkspaceInferenceState"
+  | "getWorkspace"
+  | "listWorkspaceControlEvents"
+  | "streamWorkspaceControlEvents"
   | "getBillingUsage"
   // Stream surfacing (Phase 5): capability negotiation + viewer lifecycle
   | "getClientConfig"
@@ -69,6 +102,9 @@ export type SessionClientLike = Pick<
   | "fsMkdir"
   | "gitStatus"
   | "gitDiff"
+  // Workbench v2 turn-end capture reads (the cold-paint source; M3 consumes these)
+  | "getWorkspaceCapture"
+  | "getWorkspaceCaptureFile"
   | "terminalExec"
   | "terminalPtyOpen"
   | "terminalPtyWrite"

package/src/commands/index.ts

@@ -1,10 +1,4 @@
-export type {
-  CommandContext,
-  CommandResult,
-  Notice,
-  SlashArg,
-  SlashCommand,
-} from "./types";
+export type { CommandContext, CommandResult, Notice, SlashArg, SlashCommand } from "./types";
 export {
   argHint,
   defaultCommands,

package/src/commands/registry.ts

@@ -40,7 +40,10 @@ export function parseCommandLine(value: string): ParsedCommandLine | null {
 const PERMISSION_SUPERUSER: Permission = "workspace:admin";
 
 /** Whether the operator's permission set satisfies a command's gate. */
-export function hasPermission(required: Permission | undefined, permissions: Permission[]): boolean {
+export function hasPermission(
+  required: Permission | undefined,
+  permissions: Permission[],
+): boolean {
   if (!required) {
     return true;
   }
@@ -48,13 +51,18 @@ export function hasPermission(required: Permission | undefined, permissions: Per
 }
 
 /** Match a command (by name or alias) against the value. */
-export function matchCommand(commands: readonly SlashCommand[], value: string): SlashCommand | null {
+export function matchCommand(
+  commands: readonly SlashCommand[],
+  value: string,
+): SlashCommand | null {
   const parsed = parseCommandLine(value);
   if (!parsed) {
     return null;
   }
   const token = parsed.name.toLowerCase();
-  return commands.find((command) => command.name === token || command.aliases?.includes(token)) ?? null;
+  return (
+    commands.find((command) => command.name === token || command.aliases?.includes(token)) ?? null
+  );
 }
 
 type FilterCtx = Pick<CommandContext, "sessionId" | "status" | "permissions">;
@@ -64,7 +72,11 @@ type FilterCtx = Pick<CommandContext, "sessionId" | "status" | "permissions">;
  * `available()===false` commands are dropped entirely (a gated command is never
  * shown, not shown-disabled). Filtering is a prefix match on name/alias.
  */
-export function filterCommands(commands: readonly SlashCommand[], token: string, ctx: FilterCtx): SlashCommand[] {
+export function filterCommands(
+  commands: readonly SlashCommand[],
+  token: string,
+  ctx: FilterCtx,
+): SlashCommand[] {
   const needle = token.toLowerCase();
   return commands.filter((command) => {
     if (!hasPermission(command.permission, ctx.permissions)) {
@@ -76,7 +88,10 @@ export function filterCommands(commands: readonly SlashCommand[], token: string,
     if (needle.length === 0) {
       return true;
     }
-    return command.name.startsWith(needle) || (command.aliases?.some((alias) => alias.startsWith(needle)) ?? false);
+    return (
+      command.name.startsWith(needle) ||
+      (command.aliases?.some((alias) => alias.startsWith(needle)) ?? false)
+    );
   });
 }
 
@@ -139,7 +154,10 @@ export const defaultCommands: readonly SlashCommand[] = [
       // instead so the operator isn't told something happened when nothing did.
       const cleared = ctx.clearView();
       if (!cleared) {
-        return { status: "error", message: "This view can't be cleared here (no local timeline to reset)." };
+        return {
+          status: "error",
+          message: "This view can't be cleared here (no local timeline to reset).",
+        };
       }
       return { status: "ok", message: "Local view cleared." };
     },
@@ -149,7 +167,9 @@ export const defaultCommands: readonly SlashCommand[] = [
     description: "Pause or resume the session's goal loop.",
     permission: "sessions:control",
     available: hasSession,
-    args: [{ name: "action", required: true, oneOf: ["pause", "resume"], description: "pause | resume" }],
+    args: [
+      { name: "action", required: true, oneOf: ["pause", "resume"], description: "pause | resume" },
+    ],
     run: async (args, ctx) => {
       const sessionId = requireSession(ctx);
       const action = args[0];
@@ -157,7 +177,9 @@ export const defaultCommands: readonly SlashCommand[] = [
         return { status: "error", message: "Usage: /goal pause | /goal resume" };
       }
       try {
-        await ctx.client.updateGoal(ctx.workspaceId, sessionId, { status: action === "pause" ? "paused" : "active" });
+        await ctx.client.updateGoal(ctx.workspaceId, sessionId, {
+          status: action === "pause" ? "paused" : "active",
+        });
         return { status: "ok", message: action === "pause" ? "Goal paused." : "Goal resumed." };
       } catch (cause) {
         return { status: "error", message: goalErrorMessage(cause, action) };
@@ -204,14 +226,24 @@ export const defaultCommands: readonly SlashCommand[] = [
 ];
 
 function errorMessage(cause: unknown): string | undefined {
-  if (cause && typeof cause === "object" && "message" in cause && typeof (cause as { message?: unknown }).message === "string") {
+  if (
+    cause &&
+    typeof cause === "object" &&
+    "message" in cause &&
+    typeof (cause as { message?: unknown }).message === "string"
+  ) {
     return (cause as { message: string }).message;
   }
   return undefined;
 }
 
 function statusCode(cause: unknown): number | undefined {
-  if (cause && typeof cause === "object" && "status" in cause && typeof (cause as { status?: unknown }).status === "number") {
+  if (
+    cause &&
+    typeof cause === "object" &&
+    "status" in cause &&
+    typeof (cause as { status?: unknown }).status === "number"
+  ) {
     return (cause as { status: number }).status;
   }
   return undefined;
@@ -223,14 +255,16 @@ function goalErrorMessage(cause: unknown, action: "pause" | "resume"): string {
     return "This session has no goal to control.";
   }
   if (code === 409) {
-    return action === "resume" ? "Only a paused goal can be resumed." : "Goal is already in a terminal state.";
+    return action === "resume"
+      ? "Only a paused goal can be resumed."
+      : "Goal is already in a terminal state.";
   }
   return errorMessage(cause) ?? `Could not ${action} the goal.`;
 }
 
 function clearErrorMessage(cause: unknown): string {
   if (statusCode(cause) === 409) {
-    return "Can't clear context mid-turn — stop the current turn first.";
+    return "Pause the session and wait for the current inference to settle, then clear context.";
   }
   return errorMessage(cause) ?? "Could not clear context.";
 }