@opengeni/react 0.48.0 → 0.57.0

package/src/artifacts.ts

@@ -0,0 +1,89 @@
+/** Public artifact surfaces. Import from `@opengeni/react/artifacts`. */
+export {
+  ArtifactSurface,
+  DocumentArtifactSurface,
+  DocumentEditor,
+  DocumentProjectionArtifactSurface,
+  DocumentProjectionEditor,
+  BrowserEditableArtifactWorkbench,
+  EditableDocumentArtifactSurface,
+  EditableArtifactWorkbench,
+  EditableArtifactWorkbenchHost,
+  EditablePresentationArtifactSurface,
+  EditableSpreadsheetArtifactSurface,
+  EditableSpreadsheetGrid,
+  PresentationArtifactSurface,
+  PresentationEditor,
+  PresentationProjectionArtifactSurface,
+  PresentationProjectionEditor,
+  PublishedHtmlArtifactFrame,
+  PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
+  SpreadsheetArtifactSurface,
+  SpreadsheetGrid,
+  SpreadsheetProjectionGrid,
+  type ArtifactModality,
+  type ArtifactSurfaceProps,
+  type DocumentArtifactSurfaceProps,
+  type DocumentCommit,
+  type DocumentCommitHandler,
+  type DocumentEditorProps,
+  type DocumentEditorProjection,
+  type DocumentLayoutMode,
+  type DocumentProjectionArtifactSurfaceProps,
+  type DocumentProjectionBlock,
+  type DocumentProjectionChange,
+  type DocumentProjectionComment,
+  type DocumentProjectionEditorProps,
+  type DocumentProjectionPageBreak,
+  type DocumentProjectionPageGeometry,
+  type DocumentProjectionParagraph,
+  type DocumentProjectionParagraphStyle,
+  type DocumentProjectionSection,
+  type DocumentProjectionTable,
+  type DocumentProjectionTextRun,
+  type DocumentProjectionTextStyle,
+  type DocumentSelection,
+  type BrowserEditableArtifactWorkbenchOptions,
+  type BrowserEditableArtifactWorkbenchProps,
+  type EditableDocumentArtifactSurfaceProps,
+  type EditableArtifactWorkbenchHostProps,
+  type EditableArtifactWorkbenchProps,
+  type EditablePresentationArtifactSurfaceProps,
+  type EditableSpreadsheetArtifactSurfaceProps,
+  type EditableSpreadsheetGridProps,
+  type PresentationArtifactSurfaceProps,
+  type PresentationCommit,
+  type PresentationCommitHandler,
+  type PresentationEditorProps,
+  type PresentationEditorProjection,
+  type PresentationProjectionArtifactSurfaceProps,
+  type PresentationProjectionChart,
+  type PresentationProjectionChartSeries,
+  type PresentationProjectionConnector,
+  type PresentationProjectionEditorProps,
+  type PublishedHtmlArtifactFrameProps,
+  type PresentationProjectionElementMetadata,
+  type PresentationProjectionElement,
+  type PresentationProjectionFill,
+  type PresentationProjectionGroup,
+  type PresentationProjectionImage,
+  type PresentationProjectionLine,
+  type PresentationProjectionPosition,
+  type PresentationProjectionRichText,
+  type PresentationProjectionShape,
+  type PresentationProjectionTable,
+  type PresentationProjectionTableCell,
+  type PresentationProjectionTextParagraph,
+  type PresentationProjectionTextRun,
+  type PresentationProjectionTextStyle,
+  type PresentationSlideProjection,
+  type SpreadsheetArtifactSurfaceProps,
+  type SpreadsheetCommit,
+  type SpreadsheetRangeCommit,
+  type SpreadsheetGridProps,
+  type SpreadsheetGridProjection,
+  type SpreadsheetProjectionCell,
+  type SpreadsheetProjectionGridProps,
+  type SpreadsheetSelection,
+  type SpreadsheetViewport,
+} from "./components/artifacts";

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"
@@ -80,6 +86,10 @@ export type SessionClientLike = Pick<
   | "listPacks"
   | "registerPack"
   | "enablePack"
+  | "previewPackInstallation"
+  | "installPack"
+  | "previewPackUninstall"
+  | "uninstallPack"
   | "deletePack"
   // Workspaces + billing
   | "listWorkspaces"
@@ -90,6 +100,7 @@ export type SessionClientLike = Pick<
   | "getWorkspaceModelCatalog"
   | "listWorkspaceControlEvents"
   | "streamWorkspaceControlEvents"
+  | "streamWorkspaceInteractionRevisions"
   | "getBillingUsage"
   // Stream surfacing (Phase 5): capability negotiation + viewer lifecycle
   | "getClientConfig"
@@ -98,6 +109,64 @@ export type SessionClientLike = Pick<
   | "attachViewer"
   | "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"
+  | "selectBrowserTarget"
+  | "closeBrowserTarget"
+  | "observeBrowserTarget"
+  | "actInBrowser"
+  | "getBrowserActionReceipt"
+  | "listBrowserDiagnostics"
+  | "attachBrowserSession"
+  | "heartbeatBrowserSession"
+  | "publishBrowserRevision"
+  | "suspendBrowserSession"
+  | "resumeBrowserSession"
+  | "endBrowserSession"
+  | "listComputerSessions"
+  | "getComputerSession"
+  | "readComputerClipboard"
+  | "createComputerSession"
+  | "listComputerTargets"
+  | "observeComputerTarget"
+  | "actInComputer"
+  | "getComputerActionReceipt"
+  | "attachComputerSession"
+  | "heartbeatComputerSession"
+  | "endComputerSession"
   // Channel-A structured services (terminal-as-events feed via fs/git/terminal)
   | "fsList"
   | "fsListBatch"
@@ -117,7 +186,8 @@ export type SessionClientLike = Pick<
   | "terminalPtyWrite"
   | "terminalPtyResize"
   | "terminalPtyClose"
->;
+> &
+  Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents">>;
 
 /**
  * Tenant-safe client surface required by the session-only React entry.
@@ -183,7 +253,93 @@ 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"
+  | "selectBrowserTarget"
+  | "closeBrowserTarget"
+  | "observeBrowserTarget"
+  | "actInBrowser"
+  | "getBrowserActionReceipt"
+  | "listBrowserDiagnostics"
+  | "attachBrowserSession"
+  | "heartbeatBrowserSession"
+  | "publishBrowserRevision"
+  | "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"
+  | "actInComputer"
+  | "getComputerActionReceipt"
+  | "attachComputerSession"
+  | "heartbeatComputerSession"
+  | "endComputerSession"
+> &
+  EmbeddedInterventionClientLike;
+
+/** Complete public Browser + Computer interaction surface. */
+export type EmbeddedInteractionClientLike = EmbeddedBrowserInteractionClientLike &
+  EmbeddedComputerInteractionClientLike;

package/src/clipboard.ts

@@ -0,0 +1,2 @@
+// @opengeni/react/clipboard — narrow clipboard helpers without the root UI barrel.
+export { copyTextToClipboard } from "./lib/clipboard";

package/src/components/artifacts/artifact-surface.tsx

@@ -0,0 +1,93 @@
+import {
+  FileSpreadsheetIcon,
+  FileTextIcon,
+  LoaderCircleIcon,
+  PresentationIcon,
+} from "lucide-react";
+import type { ReactNode } from "react";
+
+import { cn } from "../../lib/cn";
+
+export type ArtifactModality = "spreadsheet" | "document" | "presentation";
+
+export type ArtifactSurfaceProps = {
+  modality: ArtifactModality;
+  title: string;
+  subtitle?: ReactNode | undefined;
+  actions?: ReactNode | undefined;
+  children: ReactNode;
+  footer?: ReactNode | undefined;
+  busy?: boolean | undefined;
+  className?: string | undefined;
+};
+
+const MODALITY_LABEL: Record<ArtifactModality, string> = {
+  spreadsheet: "Spreadsheet",
+  document: "Document",
+  presentation: "Presentation",
+};
+
+function ModalityIcon({ modality }: { modality: ArtifactModality }) {
+  switch (modality) {
+    case "spreadsheet":
+      return <FileSpreadsheetIcon className="size-4" />;
+    case "document":
+      return <FileTextIcon className="size-4" />;
+    case "presentation":
+      return <PresentationIcon className="size-4" />;
+  }
+}
+
+/**
+ * Modality-neutral artifact chrome. It deliberately owns no file, session, or
+ * persistence state: hosts can use the same surface for a local draft, a
+ * durable OpenGeni artifact, or a collaborative projection.
+ */
+export function ArtifactSurface({
+  modality,
+  title,
+  subtitle,
+  actions,
+  children,
+  footer,
+  busy = false,
+  className,
+}: ArtifactSurfaceProps) {
+  return (
+    <section
+      aria-label={`${MODALITY_LABEL[modality]}: ${title}`}
+      aria-busy={busy || undefined}
+      data-og-artifact-modality={modality}
+      className={cn(
+        "og-root flex h-full min-h-0 min-w-0 flex-col overflow-hidden rounded-og-lg border border-og-border bg-og-surface-1 text-og-fg shadow-og-md",
+        className,
+      )}
+    >
+      <header className="flex min-h-11 shrink-0 items-center gap-2 border-b border-og-border bg-og-surface-2 px-3">
+        <span
+          aria-hidden
+          className="grid size-7 shrink-0 place-items-center rounded-og-sm bg-og-surface-3 text-og-fg-muted"
+        >
+          <ModalityIcon modality={modality} />
+        </span>
+        <div className="min-w-0 flex-1">
+          <h2 className="truncate text-og-base font-medium text-og-fg">{title}</h2>
+          {subtitle ? <div className="truncate text-og-xs text-og-fg-muted">{subtitle}</div> : null}
+        </div>
+        {busy ? (
+          <LoaderCircleIcon
+            aria-label="Updating artifact"
+            className="size-4 shrink-0 animate-spin text-og-fg-muted"
+          />
+        ) : null}
+        {actions ? <div className="flex shrink-0 items-center gap-1">{actions}</div> : null}
+      </header>
+
+      <div className="min-h-0 min-w-0 flex-1">{children}</div>
+
+      {footer ? (
+        <footer className="shrink-0 border-t border-og-border bg-og-surface-2">{footer}</footer>
+      ) : null}
+    </section>
+  );
+}