@opengeni/react 0.48.0 → 0.57.0

package/dist/{chunk-EKZH6IDG.js → chunk-C5ZPSSS5.js}

@@ -24,6 +24,8 @@ function useEmbeddedClientRefinement(override, requiredMethods, hookName) {
     workspaceId,
     workspaceControlEvent: context?.workspaceControlEvent ?? null,
     workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
+    workspaceInteractionEvent: context?.workspaceInteractionEvent ?? null,
+    workspaceInteractionConnectionState: context?.workspaceInteractionConnectionState ?? "idle",
     registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
     reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION
   };
@@ -46,10 +48,114 @@ function useOpenGeni(override = {}) {
     workspaceId,
     workspaceControlEvent: context?.workspaceControlEvent ?? null,
     workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
+    workspaceInteractionEvent: context?.workspaceInteractionEvent ?? null,
+    workspaceInteractionConnectionState: context?.workspaceInteractionConnectionState ?? "idle",
     registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
     reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION
   };
 }
+var BROWSER_INTERACTION_METHODS = [
+  "streamWorkspaceInteractionRevisions",
+  "listNetworkRoutes",
+  "getNetworkRoute",
+  "createNetworkRoute",
+  "updateNetworkRoute",
+  "listSiteAuthConnections",
+  "getSiteAuthConnection",
+  "createSiteAuthConnection",
+  "updateSiteAuthConnection",
+  "listAuthRuns",
+  "getAuthRun",
+  "startBrowserAuthRun",
+  "reportBrowserAuthRun",
+  "protectedBrowserAuthFill",
+  "verifyBrowserAuthRun",
+  "listInteractionInterventions",
+  "getInteractionIntervention",
+  "createInteractionIntervention",
+  "resolveInteractionIntervention",
+  "listAttachedBrowsers",
+  "getAttachedBrowser",
+  "listBrowserIdentities",
+  "getBrowserIdentity",
+  "createBrowserIdentity",
+  "updateBrowserIdentity",
+  "listBrowserRevisions",
+  "listBrowserSessions",
+  "getBrowserSession",
+  "readBrowserClipboard",
+  "listBrowserDownloads",
+  "getBrowserDownload",
+  "saveBrowserDownload",
+  "createBrowserSession",
+  "listBrowserTargets",
+  "openBrowserTarget",
+  "selectBrowserTarget",
+  "closeBrowserTarget",
+  "observeBrowserTarget",
+  "actInBrowser",
+  "getBrowserActionReceipt",
+  "listBrowserDiagnostics",
+  "attachBrowserSession",
+  "heartbeatBrowserSession",
+  "publishBrowserRevision",
+  "suspendBrowserSession",
+  "resumeBrowserSession",
+  "endBrowserSession"
+];
+var COMPUTER_INTERACTION_METHODS = [
+  "streamWorkspaceInteractionRevisions",
+  "listInteractionInterventions",
+  "getInteractionIntervention",
+  "createInteractionIntervention",
+  "resolveInteractionIntervention",
+  "listComputerSessions",
+  "getComputerSession",
+  "readComputerClipboard",
+  "createComputerSession",
+  "listComputerTargets",
+  "observeComputerTarget",
+  "actInComputer",
+  "getComputerActionReceipt",
+  "attachComputerSession",
+  "heartbeatComputerSession",
+  "endComputerSession"
+];
+var INTERVENTION_METHODS = [
+  "streamWorkspaceInteractionRevisions",
+  "listInteractionInterventions",
+  "getInteractionIntervention",
+  "createInteractionIntervention",
+  "resolveInteractionIntervention"
+];
+function useEmbeddedInterventions(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    INTERVENTION_METHODS,
+    "interaction intervention hooks"
+  );
+}
+function useEmbeddedBrowserInteraction(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    BROWSER_INTERACTION_METHODS,
+    "browser interaction hooks"
+  );
+}
+function useEmbeddedComputerInteraction(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    COMPUTER_INTERACTION_METHODS,
+    "computer interaction hooks"
+  );
+}
+function useEmbeddedInteraction(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    [...BROWSER_INTERACTION_METHODS, ...COMPUTER_INTERACTION_METHODS],
+    "interaction hooks"
+  );
+}
 function useEmbeddedSession(override = {}) {
   return useEmbeddedClientRefinement(
     override,
@@ -128,6 +234,10 @@ function useOpenGeniClient(override = {}) {
 export {
   OpenGeniContext,
   useOpenGeni,
+  useEmbeddedInterventions,
+  useEmbeddedBrowserInteraction,
+  useEmbeddedComputerInteraction,
+  useEmbeddedInteraction,
   useEmbeddedSession,
   useEmbeddedSessionRead,
   useEmbeddedGoal,
@@ -138,4 +248,4 @@ export {
   useEmbeddedRealtimeSession,
   useOpenGeniClient
 };
-//# sourceMappingURL=chunk-EKZH6IDG.js.map
+//# sourceMappingURL=chunk-C5ZPSSS5.js.map

package/dist/chunk-C5ZPSSS5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-context.ts"],"sourcesContent":["import type {\n  StreamConnectionState,\n  WorkspaceControlEvent,\n  WorkspaceInteractionRevisionEvent,\n} from \"@opengeni/sdk\";\nimport { createContext, useContext } from \"react\";\nimport type {\n  EmbeddedFileAttachmentClientLike,\n  EmbeddedGoalClientLike,\n  EmbeddedHumanInputSessionClientLike,\n  EmbeddedBrowserInteractionClientLike,\n  EmbeddedComputerInteractionClientLike,\n  EmbeddedInteractionClientLike,\n  EmbeddedInterventionClientLike,\n  EmbeddedRealtimeSessionClientLike,\n  EmbeddedSessionClientLike,\n  EmbeddedSessionLineageClientLike,\n  EmbeddedSessionMcpApprovalPolicyClientLike,\n  EmbeddedSessionReadClientLike,\n  SessionClientLike,\n} from \"./client\";\n\nexport type OpenGeniContextValue = {\n  client: SessionClientLike;\n  workspaceId: string;\n  workspaceControlEvent: WorkspaceControlEvent | null;\n  workspaceControlConnectionState: StreamConnectionState | \"idle\" | \"error\";\n  workspaceInteractionEvent: WorkspaceInteractionRevisionEvent | null;\n  workspaceInteractionConnectionState: StreamConnectionState | \"idle\" | \"error\";\n  registerSessionReconciler: (\n    sessionId: string,\n    key: string,\n    reconcile: () => Promise<void>,\n  ) => () => void;\n  reconcileSession: (sessionId: string) => Promise<void>;\n};\n\nexport const OpenGeniContext = createContext<OpenGeniContextValue | null>(null);\n\nconst NOOP_REGISTER_RECONCILER: OpenGeniContextValue[\"registerSessionReconciler\"] = () => () =>\n  undefined;\nconst NOOP_RECONCILE_SESSION: OpenGeniContextValue[\"reconcileSession\"] = async () => undefined;\n\nexport type ClientOverride = {\n  client?: SessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionClientOverride = {\n  client?: EmbeddedSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedHumanInputClientOverride = {\n  client?: EmbeddedHumanInputSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionMcpApprovalPolicyClientOverride = {\n  client?: EmbeddedSessionMcpApprovalPolicyClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionReadClientOverride = {\n  client?: EmbeddedSessionReadClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedRealtimeSessionClientOverride = {\n  client?: EmbeddedRealtimeSessionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedGoalClientOverride = {\n  client?: EmbeddedGoalClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionLineageClientOverride = {\n  client?: EmbeddedSessionLineageClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedFileAttachmentClientOverride = {\n  client?: EmbeddedFileAttachmentClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedInteractionClientOverride = {\n  client?: EmbeddedInteractionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedInterventionClientOverride = {\n  client?: EmbeddedInterventionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedBrowserInteractionClientOverride = {\n  client?: EmbeddedBrowserInteractionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedComputerInteractionClientOverride = {\n  client?: EmbeddedComputerInteractionClientLike | undefined;\n  workspaceId?: string | undefined;\n};\n\nexport type EmbeddedSessionContextValue = Omit<OpenGeniContextValue, \"client\"> & {\n  client: EmbeddedSessionClientLike;\n};\n\ntype EmbeddedClientOverride<TClient> = {\n  client?: TClient | undefined;\n  workspaceId?: string | undefined;\n};\n\ntype EmbeddedClientContextValue<TClient> = Omit<OpenGeniContextValue, \"client\"> & {\n  client: TClient;\n};\n\nfunction useEmbeddedClientRefinement<TClient extends object>(\n  override: EmbeddedClientOverride<TClient>,\n  requiredMethods: readonly string[],\n  hookName: string,\n): EmbeddedClientContextValue<TClient> {\n  const context = useContext(OpenGeniContext);\n  const candidate = override.client ?? context?.client;\n  const workspaceId = override.workspaceId ?? context?.workspaceId;\n  if (!candidate || !workspaceId) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.\",\n    );\n  }\n  const methods = candidate as Record<string, unknown>;\n  const missing = requiredMethods.filter((method) => typeof methods[method] !== \"function\");\n  if (missing.length > 0) {\n    throw new Error(\n      `@opengeni/react: ${hookName} requires client method${missing.length === 1 ? \"\" : \"s\"} ${missing.join(\", \")}.`,\n    );\n  }\n  return {\n    client: candidate as TClient,\n    workspaceId,\n    workspaceControlEvent: context?.workspaceControlEvent ?? null,\n    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? \"idle\",\n    workspaceInteractionEvent: context?.workspaceInteractionEvent ?? null,\n    workspaceInteractionConnectionState: context?.workspaceInteractionConnectionState ?? \"idle\",\n    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\n  };\n}\n\nfunction eventClientMethods(override: object, directMethods: readonly string[]): readonly string[] {\n  const hasSharedEventFeed =\n    \"events\" in override && (override as { events?: unknown }).events !== undefined;\n  return hasSharedEventFeed ? directMethods : [\"getSession\", \"streamEvents\", ...directMethods];\n}\n\n/** Resolve client + workspace from explicit overrides or the provider. */\nexport function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue {\n  const context = useContext(OpenGeniContext);\n  const client = override.client ?? context?.client;\n  const workspaceId = override.workspaceId ?? context?.workspaceId;\n  if (!client || !workspaceId) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.\",\n    );\n  }\n  return {\n    client,\n    workspaceId,\n    workspaceControlEvent: context?.workspaceControlEvent ?? null,\n    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? \"idle\",\n    workspaceInteractionEvent: context?.workspaceInteractionEvent ?? null,\n    workspaceInteractionConnectionState: context?.workspaceInteractionConnectionState ?? \"idle\",\n    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\n  };\n}\n\nconst BROWSER_INTERACTION_METHODS = [\n  \"streamWorkspaceInteractionRevisions\",\n  \"listNetworkRoutes\",\n  \"getNetworkRoute\",\n  \"createNetworkRoute\",\n  \"updateNetworkRoute\",\n  \"listSiteAuthConnections\",\n  \"getSiteAuthConnection\",\n  \"createSiteAuthConnection\",\n  \"updateSiteAuthConnection\",\n  \"listAuthRuns\",\n  \"getAuthRun\",\n  \"startBrowserAuthRun\",\n  \"reportBrowserAuthRun\",\n  \"protectedBrowserAuthFill\",\n  \"verifyBrowserAuthRun\",\n  \"listInteractionInterventions\",\n  \"getInteractionIntervention\",\n  \"createInteractionIntervention\",\n  \"resolveInteractionIntervention\",\n  \"listAttachedBrowsers\",\n  \"getAttachedBrowser\",\n  \"listBrowserIdentities\",\n  \"getBrowserIdentity\",\n  \"createBrowserIdentity\",\n  \"updateBrowserIdentity\",\n  \"listBrowserRevisions\",\n  \"listBrowserSessions\",\n  \"getBrowserSession\",\n  \"readBrowserClipboard\",\n  \"listBrowserDownloads\",\n  \"getBrowserDownload\",\n  \"saveBrowserDownload\",\n  \"createBrowserSession\",\n  \"listBrowserTargets\",\n  \"openBrowserTarget\",\n  \"selectBrowserTarget\",\n  \"closeBrowserTarget\",\n  \"observeBrowserTarget\",\n  \"actInBrowser\",\n  \"getBrowserActionReceipt\",\n  \"listBrowserDiagnostics\",\n  \"attachBrowserSession\",\n  \"heartbeatBrowserSession\",\n  \"publishBrowserRevision\",\n  \"suspendBrowserSession\",\n  \"resumeBrowserSession\",\n  \"endBrowserSession\",\n] as const;\n\nconst COMPUTER_INTERACTION_METHODS = [\n  \"streamWorkspaceInteractionRevisions\",\n  \"listInteractionInterventions\",\n  \"getInteractionIntervention\",\n  \"createInteractionIntervention\",\n  \"resolveInteractionIntervention\",\n  \"listComputerSessions\",\n  \"getComputerSession\",\n  \"readComputerClipboard\",\n  \"createComputerSession\",\n  \"listComputerTargets\",\n  \"observeComputerTarget\",\n  \"actInComputer\",\n  \"getComputerActionReceipt\",\n  \"attachComputerSession\",\n  \"heartbeatComputerSession\",\n  \"endComputerSession\",\n] as const;\n\nconst INTERVENTION_METHODS = [\n  \"streamWorkspaceInteractionRevisions\",\n  \"listInteractionInterventions\",\n  \"getInteractionIntervention\",\n  \"createInteractionIntervention\",\n  \"resolveInteractionIntervention\",\n] as const;\n\n/** Resolve only the workspace-wide Browser/Computer intervention surface. */\nexport function useEmbeddedInterventions(\n  override: EmbeddedInterventionClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedInterventionClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    INTERVENTION_METHODS,\n    \"interaction intervention hooks\",\n  );\n}\n\n/** Resolve only BrowserSession methods for a standalone Browser embed. */\nexport function useEmbeddedBrowserInteraction(\n  override: EmbeddedBrowserInteractionClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedBrowserInteractionClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    BROWSER_INTERACTION_METHODS,\n    \"browser interaction hooks\",\n  );\n}\n\n/** Resolve only ComputerSession methods for a standalone Computer embed. */\nexport function useEmbeddedComputerInteraction(\n  override: EmbeddedComputerInteractionClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedComputerInteractionClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    COMPUTER_INTERACTION_METHODS,\n    \"computer interaction hooks\",\n  );\n}\n\n/** Resolve the complete Browser + Computer client surface. */\nexport function useEmbeddedInteraction(\n  override: EmbeddedInteractionClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedInteractionClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    [...BROWSER_INTERACTION_METHODS, ...COMPUTER_INTERACTION_METHODS],\n    \"interaction hooks\",\n  );\n}\n\n/**\n * Resolve the narrow client required by the session-only hooks. The full\n * provider client is structurally compatible, while an explicit host proxy\n * only needs to expose session/event/composer/queue/control operations.\n */\nexport function useEmbeddedSession(\n  override: EmbeddedSessionClientOverride = {},\n): EmbeddedSessionContextValue {\n  return useEmbeddedClientRefinement(\n    override,\n    [\n      \"getSession\",\n      \"listEvents\",\n      \"streamEvents\",\n      \"getComposerDraft\",\n      \"saveComposerDraft\",\n      \"sendMessage\",\n      \"steerMessage\",\n      \"getQueue\",\n      \"moveQueueItem\",\n      \"editQueueItem\",\n      \"steerQueueItem\",\n      \"deleteQueueItem\",\n      \"pauseSession\",\n      \"resumeSession\",\n      \"sendApprovalDecision\",\n    ],\n    \"session hooks\",\n  );\n}\n\n/** Resolve the exact client surface required by `useSession`. */\nexport function useEmbeddedSessionRead(\n  override: EmbeddedSessionReadClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedSessionReadClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSession\", \"updateSession\"]),\n    \"useSession\",\n  );\n}\n\n/** Resolve the exact client surface required by `useGoal`. */\nexport function useEmbeddedGoal(\n  override: EmbeddedGoalClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedGoalClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getGoal\", \"updateGoal\", \"deleteGoal\"]),\n    \"useGoal\",\n  );\n}\n\n/** Resolve the exact client surface required by `useSessionLineage`. */\nexport function useEmbeddedSessionLineage(\n  override: EmbeddedSessionLineageClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedSessionLineageClientLike> {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSessionLineage\"]),\n    \"useSessionLineage\",\n  );\n}\n\n/** Resolve the exact client surface required by `useFileAttachments`. */\nexport function useEmbeddedFileAttachments(\n  override: EmbeddedFileAttachmentClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedFileAttachmentClientLike> {\n  return useEmbeddedClientRefinement(override, [\"uploadFile\"], \"useFileAttachments\");\n}\n\n/**\n * Resolve the structured-input refinement without widening the baseline\n * session-only proxy contract.\n */\nexport function useEmbeddedHumanInputSession(override: EmbeddedHumanInputClientOverride = {}): Omit<\n  EmbeddedSessionContextValue,\n  \"client\"\n> & {\n  client: EmbeddedHumanInputSessionClientLike;\n} {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"listHumanInputRequests\", \"submitHumanInputResponse\"]),\n    \"useHumanInputRequests\",\n  );\n}\n\n/** Resolve the approval-policy refinement without widening session-only hosts. */\nexport function useEmbeddedSessionMcpApprovalPolicy(\n  override: EmbeddedSessionMcpApprovalPolicyClientOverride = {},\n): Omit<EmbeddedSessionContextValue, \"client\"> & {\n  client: EmbeddedSessionMcpApprovalPolicyClientLike;\n} {\n  return useEmbeddedClientRefinement(\n    override,\n    eventClientMethods(override, [\"getSession\", \"updateSessionMcpApprovalPolicy\"]),\n    \"useSessionMcpApprovalPolicy\",\n  );\n}\n\n/** Resolve the exact browser/API surface required by `@opengeni/react/realtime`. */\nexport function useEmbeddedRealtimeSession(\n  override: EmbeddedRealtimeSessionClientOverride = {},\n): EmbeddedClientContextValue<EmbeddedRealtimeSessionClientLike> {\n  // Preserve the existing lazy capability behavior: proxy/test clients may\n  // implement only the methods reached by their selected model and lifecycle.\n  // The exported structural type remains the complete embedding contract.\n  return useEmbeddedClientRefinement(override, [], \"realtime hooks\");\n}\n\n/**\n * Resolve the client only — for hooks that are not workspace-scoped\n * (`useWorkspaces`, `useBillingUsage`).\n */\nexport function useOpenGeniClient(\n  override: Pick<ClientOverride, \"client\"> = {},\n): SessionClientLike {\n  const context = useContext(OpenGeniContext);\n  const client = override.client ?? context?.client;\n  if (!client) {\n    throw new Error(\n      \"@opengeni/react: no OpenGeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.\",\n    );\n  }\n  return client;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-OL6QVXGF.js → chunk-HA46CYQK.js}

@@ -6,7 +6,7 @@ import {
 import {
   OpenGeniContext,
   useOpenGeni
-} from "./chunk-EKZH6IDG.js";
+} from "./chunk-C5ZPSSS5.js";
 import {
   formatBytes,
   formatRelativeTime
@@ -1032,7 +1032,7 @@ function MachineDetail({
             "data-remove-machine": true,
             "aria-label": `Remove machine ${machine.name}`,
             onClick: () => onRemove(machine),
-            className: "inline-flex min-h-9 items-center gap-1.5 rounded-og-sm border border-og-status-failed/40 px-2.5 py-1 font-medium text-og-xs text-og-status-failed transition-colors hover:bg-og-status-failed/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-og-status-failed/50 pointer-coarse:min-h-11",
+            className: "inline-flex min-h-9 items-center gap-1.5 rounded-og-sm border border-og-status-failed/40 px-2.5 py-1 font-medium text-og-xs text-og-status-failed transition-colors hover:bg-og-status-failed/10 focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-og-status-failed/50 pointer-coarse:min-h-11",
             children: [
               /* @__PURE__ */ jsx7(Trash2Icon, { className: "size-3.5", "aria-hidden": true }),
               /* @__PURE__ */ jsx7("span", { className: "hidden sm:inline", children: "Remove machine" })
@@ -1738,21 +1738,28 @@ function OpenGeniProvider({
   client,
   workspaceId,
   onWorkspaceControlEvent,
+  onWorkspaceInteractionEvent,
   children
 }) {
   const [workspaceControlEvent, setWorkspaceControlEvent] = useState3(
     null
   );
   const [workspaceControlConnectionState, setWorkspaceControlConnectionState] = useState3("idle");
+  const [workspaceInteractionEvent, setWorkspaceInteractionEvent] = useState3(null);
+  const [workspaceInteractionConnectionState, setWorkspaceInteractionConnectionState] = useState3("idle");
   const [contractMismatch, setContractMismatch] = useState3(
     null
   );
   const callbackRef = useRef2(onWorkspaceControlEvent);
+  const interactionCallbackRef = useRef2(onWorkspaceInteractionEvent);
   const reconcilersRef = useRef2(/* @__PURE__ */ new Map());
   const reconcileInFlightRef = useRef2(/* @__PURE__ */ new Map());
   const workspaceControlSequencesRef = useRef2(/* @__PURE__ */ new Map());
+  const workspaceInteractionSequencesRef = useRef2(/* @__PURE__ */ new Map());
   const pageLive = usePageLiveActivity();
+  const supportsWorkspaceLiveStream = "streamWorkspaceLiveEvents" in client && typeof client.streamWorkspaceLiveEvents === "function";
   callbackRef.current = onWorkspaceControlEvent;
+  interactionCallbackRef.current = onWorkspaceInteractionEvent;
   const verifyApiContract = useCallback(async () => {
     try {
       const config = await client.getClientConfig();
@@ -1806,6 +1813,77 @@ function OpenGeniProvider({
     [verifyApiContract]
   );
   useEffect(() => {
+    if (!supportsWorkspaceLiveStream) return;
+    const openLiveStream = client.streamWorkspaceLiveEvents;
+    setWorkspaceControlEvent(null);
+    setWorkspaceInteractionEvent(null);
+    if (!pageLive) {
+      setWorkspaceControlConnectionState("idle");
+      setWorkspaceInteractionConnectionState("idle");
+      return;
+    }
+    const controller = new AbortController();
+    const setConnectionState = (state) => {
+      setWorkspaceControlConnectionState(state);
+      setWorkspaceInteractionConnectionState(state);
+    };
+    setConnectionState("connecting");
+    void (async () => {
+      try {
+        await verifyApiContract();
+        const workspace = await client.getWorkspace(workspaceId);
+        const controlAfter = Math.max(
+          workspaceControlSequencesRef.current.get(workspaceId) ?? 0,
+          workspace.inferenceControl.revision
+        );
+        const interactionAfter = workspaceInteractionSequencesRef.current.get(workspaceId) ?? 0;
+        workspaceControlSequencesRef.current.set(workspaceId, controlAfter);
+        const stream = openLiveStream.call(client, workspaceId, {
+          controlAfter,
+          interactionAfter,
+          signal: controller.signal,
+          onStateChange: setConnectionState
+        });
+        for await (const event of stream) {
+          if (controller.signal.aborted) return;
+          if (event.type === "workspace.control.changed") {
+            workspaceControlSequencesRef.current.set(
+              workspaceId,
+              Math.max(workspaceControlSequencesRef.current.get(workspaceId) ?? 0, event.sequence)
+            );
+            setWorkspaceControlEvent(
+              (current) => !current || event.sequence > current.sequence ? event : current
+            );
+            callbackRef.current?.(event);
+          } else {
+            workspaceInteractionSequencesRef.current.set(
+              workspaceId,
+              Math.max(
+                workspaceInteractionSequencesRef.current.get(workspaceId) ?? 0,
+                event.sequence
+              )
+            );
+            setWorkspaceInteractionEvent(
+              (current) => !current || event.sequence > current.sequence ? event : current
+            );
+            interactionCallbackRef.current?.(event);
+          }
+        }
+      } catch (error) {
+        if (error instanceof OpenGeniApiContractMismatchError) {
+          setContractMismatch(error);
+          reloadForContractMismatchOnce(error);
+        }
+        if (!controller.signal.aborted) {
+          setWorkspaceControlConnectionState("error");
+          setWorkspaceInteractionConnectionState("error");
+        }
+      }
+    })();
+    return () => controller.abort();
+  }, [client, pageLive, supportsWorkspaceLiveStream, verifyApiContract, workspaceId]);
+  useEffect(() => {
+    if (supportsWorkspaceLiveStream) return;
     if (!pageLive) {
       setWorkspaceControlConnectionState("idle");
       return;
@@ -1846,13 +1924,57 @@ function OpenGeniProvider({
       }
     })();
     return () => controller.abort();
-  }, [client, pageLive, verifyApiContract, workspaceId]);
+  }, [client, pageLive, supportsWorkspaceLiveStream, verifyApiContract, workspaceId]);
+  useEffect(() => {
+    if (supportsWorkspaceLiveStream) return;
+    setWorkspaceInteractionEvent(null);
+    if (!pageLive) {
+      setWorkspaceInteractionConnectionState("idle");
+      return;
+    }
+    const controller = new AbortController();
+    setWorkspaceInteractionConnectionState("connecting");
+    void (async () => {
+      try {
+        await verifyApiContract();
+        const resumeAfter = workspaceInteractionSequencesRef.current.get(workspaceId) ?? 0;
+        const stream = client.streamWorkspaceInteractionRevisions(workspaceId, {
+          after: resumeAfter,
+          signal: controller.signal,
+          onStateChange: setWorkspaceInteractionConnectionState
+        });
+        for await (const event of stream) {
+          if (controller.signal.aborted) return;
+          workspaceInteractionSequencesRef.current.set(
+            workspaceId,
+            Math.max(
+              workspaceInteractionSequencesRef.current.get(workspaceId) ?? 0,
+              event.sequence
+            )
+          );
+          setWorkspaceInteractionEvent(
+            (current) => !current || event.sequence > current.sequence ? event : current
+          );
+          interactionCallbackRef.current?.(event);
+        }
+      } catch (error) {
+        if (error instanceof OpenGeniApiContractMismatchError) {
+          setContractMismatch(error);
+          reloadForContractMismatchOnce(error);
+        }
+        if (!controller.signal.aborted) setWorkspaceInteractionConnectionState("error");
+      }
+    })();
+    return () => controller.abort();
+  }, [client, pageLive, supportsWorkspaceLiveStream, verifyApiContract, workspaceId]);
   const value = useMemo(
     () => ({
       client,
       workspaceId,
       workspaceControlEvent,
       workspaceControlConnectionState,
+      workspaceInteractionEvent,
+      workspaceInteractionConnectionState,
       registerSessionReconciler,
       reconcileSession
     }),
@@ -1861,6 +1983,8 @@ function OpenGeniProvider({
       workspaceId,
       workspaceControlEvent,
       workspaceControlConnectionState,
+      workspaceInteractionEvent,
+      workspaceInteractionConnectionState,
       registerSessionReconciler,
       reconcileSession
     ]
@@ -1924,6 +2048,23 @@ function reloadForContractMismatchOnce(mismatch) {
 
 // src/hooks/use-machines.ts
 var EMPTY = { activeSandboxId: null, activeEpoch: 0, machines: [] };
+function swapFailureMessage(result) {
+  if (result.reason?.trim()) return result.reason;
+  switch (result.code) {
+    case "recovery_in_progress":
+      return "The managed sandbox is still recovering. Try again shortly.";
+    case "recovery_degraded":
+      return "The managed sandbox recovery is degraded and needs attention.";
+    case "recovery_unrecoverable":
+      return "The managed sandbox could not be recovered.";
+    case "offline_enrollment":
+      return "The selected machine is offline.";
+    case "concurrent_swap":
+      return "The session route changed concurrently. Refresh and try again.";
+    default:
+      return "The session stayed on its current sandbox.";
+  }
+}
 function useMachines(options = {}) {
   const { client, workspaceId } = useOpenGeni(options);
   const machinesClient = options.machinesClient ?? client;
@@ -1965,7 +2106,10 @@ function useMachines(options = {}) {
       const ownedIdentity = identityKey;
       setAttachState({ identity: ownedIdentity, sandboxId });
       const result = await run(async () => {
-        await runSwap();
+        const response = await runSwap();
+        if (response && typeof response === "object" && "swapped" in response && response.swapped === false) {
+          throw new Error(swapFailureMessage(response));
+        }
         return true;
       });
       if (identityRef.current === ownedIdentity) {
@@ -2022,7 +2166,9 @@ function useMachines(options = {}) {
 }
 
 export {
+  OpenGeniProvider,
   connectionStatusForState,
+  useMachines,
   CONNECTION_STATUS_META,
   MACHINE_STATE_BADGE_META,
   ConnectionStatusPill,
@@ -2045,8 +2191,6 @@ export {
   MachineDockBar,
   SharedMachineDisclosure,
   EnrollmentDeviceFlow,
-  EnrollmentConsent,
-  OpenGeniProvider,
-  useMachines
+  EnrollmentConsent
 };
-//# sourceMappingURL=chunk-OL6QVXGF.js.map
+//# sourceMappingURL=chunk-HA46CYQK.js.map