@opengeni/react 0.52.1 → 0.57.0

package/src/client.ts

@@ -62,6 +62,12 @@ export type SessionClientLike = Pick<
   | "deleteEnvironment"
   | "setEnvironmentVariable"
   | "deleteEnvironmentVariable"
+  // Channels (rail organization)
+  | "listChannels"
+  | "createChannel"
+  | "updateChannel"
+  | "deleteChannel"
+  | "updateSessionChannel"
   // Rigs
   | "listRigs"
   | "createRig"
@@ -94,6 +100,7 @@ export type SessionClientLike = Pick<
   | "getWorkspaceModelCatalog"
   | "listWorkspaceControlEvents"
   | "streamWorkspaceControlEvents"
+  | "streamWorkspaceInteractionRevisions"
   | "getBillingUsage"
   // Stream surfacing (Phase 5): capability negotiation + viewer lifecycle
   | "getClientConfig"
@@ -103,14 +110,37 @@ export type SessionClientLike = Pick<
   | "heartbeatViewer"
   | "detachViewer"
   // Browser/Computer interaction resources
+  | "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"
@@ -128,6 +158,7 @@ export type SessionClientLike = Pick<
   | "endBrowserSession"
   | "listComputerSessions"
   | "getComputerSession"
+  | "readComputerClipboard"
   | "createComputerSession"
   | "listComputerTargets"
   | "observeComputerTarget"
@@ -156,7 +187,7 @@ export type SessionClientLike = Pick<
   | "terminalPtyResize"
   | "terminalPtyClose"
 > &
-  Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource">>;
+  Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents">>;
 
 /**
  * Tenant-safe client surface required by the session-only React entry.
@@ -222,22 +253,57 @@ export type EmbeddedRealtimeSessionClientLike = Pick<
   | "heartbeatSessionRealtime"
   | "negotiateCodexRealtimeWebrtc"
   | "negotiateGatewayRealtime"
+  | "negotiateXaiSubscriptionRealtime"
   | "activateCodexRealtimeConnection"
   | "syncSessionRealtimeLedger"
   | "endSessionRealtime"
 >;
 
+/** Exact public SDK surface required by cross-surface human interventions. */
+export type EmbeddedInterventionClientLike = Pick<
+  OpenGeniClient,
+  | "streamWorkspaceInteractionRevisions"
+  | "listInteractionInterventions"
+  | "getInteractionIntervention"
+  | "createInteractionIntervention"
+  | "resolveInteractionIntervention"
+>;
+
 /** Exact public SDK surface required by BrowserSession hooks and components. */
 export type EmbeddedBrowserInteractionClientLike = Pick<
   OpenGeniClient,
+  | "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"
@@ -253,13 +319,16 @@ export type EmbeddedBrowserInteractionClientLike = Pick<
   | "suspendBrowserSession"
   | "resumeBrowserSession"
   | "endBrowserSession"
->;
+> &
+  EmbeddedInterventionClientLike;
 
 /** Exact public SDK surface required by ComputerSession hooks and components. */
 export type EmbeddedComputerInteractionClientLike = Pick<
   OpenGeniClient,
+  | "streamWorkspaceInteractionRevisions"
   | "listComputerSessions"
   | "getComputerSession"
+  | "readComputerClipboard"
   | "createComputerSession"
   | "listComputerTargets"
   | "observeComputerTarget"
@@ -268,7 +337,8 @@ export type EmbeddedComputerInteractionClientLike = Pick<
   | "attachComputerSession"
   | "heartbeatComputerSession"
   | "endComputerSession"
->;
+> &
+  EmbeddedInterventionClientLike;
 
 /** Complete public Browser + Computer interaction surface. */
 export type EmbeddedInteractionClientLike = EmbeddedBrowserInteractionClientLike &

package/src/components/artifacts/index.ts

@@ -3,6 +3,11 @@ export {
   type ArtifactModality,
   type ArtifactSurfaceProps,
 } from "./artifact-surface";
+export {
+  PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
+  PublishedHtmlArtifactFrame,
+  type PublishedHtmlArtifactFrameProps,
+} from "./published-html-artifact-frame";
 export {
   SpreadsheetArtifactSurface,
   SpreadsheetGrid,

package/src/components/artifacts/published-html-artifact-frame.tsx

@@ -0,0 +1,38 @@
+import type { CSSProperties } from "react";
+
+export const PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX = [
+  "allow-downloads",
+  "allow-forms",
+  "allow-modals",
+  "allow-orientation-lock",
+  "allow-pointer-lock",
+  "allow-popups",
+  "allow-popups-to-escape-sandbox",
+  "allow-presentation",
+  "allow-scripts",
+].join(" ");
+
+export type PublishedHtmlArtifactFrameProps = {
+  html: string;
+  title: string;
+  className?: string;
+  style?: CSSProperties;
+};
+
+/**
+ * Render exact published HTML in an opaque-origin iframe. Artifact scripts,
+ * external resources, forms, popups, and downloads work without granting
+ * parent-origin authority, shared cookies/storage, or top-level navigation.
+ */
+export function PublishedHtmlArtifactFrame(props: PublishedHtmlArtifactFrameProps) {
+  return (
+    <iframe
+      title={props.title}
+      sandbox={PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX}
+      referrerPolicy="no-referrer"
+      srcDoc={props.html}
+      className={props.className}
+      style={props.style}
+    />
+  );
+}

package/src/components/browser-input.ts

@@ -0,0 +1,65 @@
+import type { KeyboardEvent } from "react";
+import { interactionHostPlatform, type InteractionHostPlatform } from "../lib/host-platform";
+
+export const HUMAN_BROWSER_HOME_URL = "https://www.google.com/";
+const HUMAN_BROWSER_SEARCH_URL = "https://www.google.com/search?q=";
+
+/** Apply browser-style omnibox behavior: navigate hosts, search ordinary text. */
+export function normalizeBrowserAddress(value: string): string | null {
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+
+  if (/^(?:https?|about):/iu.test(trimmed)) {
+    try {
+      const url = new URL(trimmed);
+      return ["http:", "https:", "about:"].includes(url.protocol) ? url.href : null;
+    } catch {
+      return `${HUMAN_BROWSER_SEARCH_URL}${encodeURIComponent(trimmed)}`;
+    }
+  }
+
+  const isLocal = /^(?:localhost|127(?:\.\d{1,3}){3}|\[::1\])(?::\d+)?(?:[/?#]|$)/iu.test(trimmed);
+  const looksLikeHost =
+    !/\s/u.test(trimmed) &&
+    (isLocal || /^(?:[^./\s]+\.)+[^./\s]+(?::\d+)?(?:[/?#]|$)/u.test(trimmed));
+  if (!looksLikeHost) return `${HUMAN_BROWSER_SEARCH_URL}${encodeURIComponent(trimmed)}`;
+
+  try {
+    return new URL(`${isLocal ? "http" : "https"}://${trimmed}`).href;
+  } catch {
+    return `${HUMAN_BROWSER_SEARCH_URL}${encodeURIComponent(trimmed)}`;
+  }
+}
+
+/** Translate executable keyboard chords for the BrowserSession action API. */
+export function browserKey(
+  event: Pick<
+    KeyboardEvent<HTMLTextAreaElement>,
+    "altKey" | "ctrlKey" | "key" | "metaKey" | "shiftKey"
+  >,
+  hostPlatform: InteractionHostPlatform = interactionHostPlatform(),
+): string | null {
+  // Modifier keydowns precede the actual chord key. They are not executable
+  // browser actions by themselves (for example Meta+Meta is invalid CDP input).
+  if (["Alt", "AltGraph", "Control", "Meta", "Shift"].includes(event.key)) return null;
+  const special = new Set([
+    "Enter",
+    "Tab",
+    "Escape",
+    "Backspace",
+    "Delete",
+    "ArrowUp",
+    "ArrowDown",
+    "ArrowLeft",
+    "ArrowRight",
+  ]);
+  const modified = event.altKey || event.ctrlKey || event.metaKey;
+  if (!modified && !special.has(event.key)) return null;
+  const parts: string[] = [];
+  if (event.ctrlKey) parts.push(hostPlatform === "mac" ? "Control" : "Mod");
+  if (event.altKey) parts.push("Alt");
+  if (event.metaKey) parts.push(hostPlatform === "mac" ? "Mod" : "Meta");
+  if (event.shiftKey) parts.push("Shift");
+  parts.push(event.key === " " ? "Space" : event.key);
+  return parts.join("+");
+}