@opengeni/react 0.15.0 → 0.23.0

package/src/lib/noto-sans-jp-loader.generated.ts

@@ -0,0 +1,295 @@
+/* This file is generated by scripts/generate-noto-jp-loader.ts. */
+import unicodeRanges from "@fontsource-variable/noto-sans-jp/unicode.json";
+import font0 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-0-wght-normal.woff2";
+import font1 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-1-wght-normal.woff2";
+import font2 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-2-wght-normal.woff2";
+import font3 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-3-wght-normal.woff2";
+import font4 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-4-wght-normal.woff2";
+import font5 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-5-wght-normal.woff2";
+import font6 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-6-wght-normal.woff2";
+import font7 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-7-wght-normal.woff2";
+import font8 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-8-wght-normal.woff2";
+import font9 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-9-wght-normal.woff2";
+import font10 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-10-wght-normal.woff2";
+import font11 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-11-wght-normal.woff2";
+import font12 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-12-wght-normal.woff2";
+import font13 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-13-wght-normal.woff2";
+import font14 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-14-wght-normal.woff2";
+import font15 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-15-wght-normal.woff2";
+import font16 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-16-wght-normal.woff2";
+import font17 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-17-wght-normal.woff2";
+import font18 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-18-wght-normal.woff2";
+import font19 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-19-wght-normal.woff2";
+import font20 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-20-wght-normal.woff2";
+import font21 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-21-wght-normal.woff2";
+import font22 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-22-wght-normal.woff2";
+import font23 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-23-wght-normal.woff2";
+import font24 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-24-wght-normal.woff2";
+import font25 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-25-wght-normal.woff2";
+import font26 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-26-wght-normal.woff2";
+import font27 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-27-wght-normal.woff2";
+import font28 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-28-wght-normal.woff2";
+import font29 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-29-wght-normal.woff2";
+import font30 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-30-wght-normal.woff2";
+import font31 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-31-wght-normal.woff2";
+import font32 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-32-wght-normal.woff2";
+import font33 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-33-wght-normal.woff2";
+import font34 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-34-wght-normal.woff2";
+import font35 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-35-wght-normal.woff2";
+import font36 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-36-wght-normal.woff2";
+import font37 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-37-wght-normal.woff2";
+import font38 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-38-wght-normal.woff2";
+import font39 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-39-wght-normal.woff2";
+import font40 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-40-wght-normal.woff2";
+import font41 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-41-wght-normal.woff2";
+import font42 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-42-wght-normal.woff2";
+import font43 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-43-wght-normal.woff2";
+import font44 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-44-wght-normal.woff2";
+import font45 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-45-wght-normal.woff2";
+import font46 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-46-wght-normal.woff2";
+import font47 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-47-wght-normal.woff2";
+import font48 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-48-wght-normal.woff2";
+import font49 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-49-wght-normal.woff2";
+import font50 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-50-wght-normal.woff2";
+import font51 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-51-wght-normal.woff2";
+import font52 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-52-wght-normal.woff2";
+import font53 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-53-wght-normal.woff2";
+import font54 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-54-wght-normal.woff2";
+import font55 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-55-wght-normal.woff2";
+import font56 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-56-wght-normal.woff2";
+import font57 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-57-wght-normal.woff2";
+import font58 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-58-wght-normal.woff2";
+import font59 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-59-wght-normal.woff2";
+import font60 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-60-wght-normal.woff2";
+import font61 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-61-wght-normal.woff2";
+import font62 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-62-wght-normal.woff2";
+import font63 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-63-wght-normal.woff2";
+import font64 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-64-wght-normal.woff2";
+import font65 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-65-wght-normal.woff2";
+import font66 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-66-wght-normal.woff2";
+import font67 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-67-wght-normal.woff2";
+import font68 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-68-wght-normal.woff2";
+import font69 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-69-wght-normal.woff2";
+import font70 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-70-wght-normal.woff2";
+import font71 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-71-wght-normal.woff2";
+import font72 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-72-wght-normal.woff2";
+import font73 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-73-wght-normal.woff2";
+import font74 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-74-wght-normal.woff2";
+import font75 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-75-wght-normal.woff2";
+import font76 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-76-wght-normal.woff2";
+import font77 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-77-wght-normal.woff2";
+import font78 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-78-wght-normal.woff2";
+import font79 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-79-wght-normal.woff2";
+import font80 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-80-wght-normal.woff2";
+import font81 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-81-wght-normal.woff2";
+import font82 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-82-wght-normal.woff2";
+import font83 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-83-wght-normal.woff2";
+import font84 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-84-wght-normal.woff2";
+import font85 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-85-wght-normal.woff2";
+import font86 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-86-wght-normal.woff2";
+import font87 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-87-wght-normal.woff2";
+import font88 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-88-wght-normal.woff2";
+import font89 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-89-wght-normal.woff2";
+import font90 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-90-wght-normal.woff2";
+import font91 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-91-wght-normal.woff2";
+import font92 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-92-wght-normal.woff2";
+import font93 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-93-wght-normal.woff2";
+import font94 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-94-wght-normal.woff2";
+import font95 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-95-wght-normal.woff2";
+import font96 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-96-wght-normal.woff2";
+import font97 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-97-wght-normal.woff2";
+import font98 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-98-wght-normal.woff2";
+import font99 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-99-wght-normal.woff2";
+import font100 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-100-wght-normal.woff2";
+import font101 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-101-wght-normal.woff2";
+import font102 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-102-wght-normal.woff2";
+import font103 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-103-wght-normal.woff2";
+import font104 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-104-wght-normal.woff2";
+import font105 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-105-wght-normal.woff2";
+import font106 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-106-wght-normal.woff2";
+import font107 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-107-wght-normal.woff2";
+import font108 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-108-wght-normal.woff2";
+import font109 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-109-wght-normal.woff2";
+import font110 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-110-wght-normal.woff2";
+import font111 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-111-wght-normal.woff2";
+import font112 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-112-wght-normal.woff2";
+import font113 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-113-wght-normal.woff2";
+import font114 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-114-wght-normal.woff2";
+import font115 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-115-wght-normal.woff2";
+import font116 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-116-wght-normal.woff2";
+import font117 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-117-wght-normal.woff2";
+import font118 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-118-wght-normal.woff2";
+import font119 from "@fontsource-variable/noto-sans-jp/files/noto-sans-jp-119-wght-normal.woff2";
+
+const fontUrls: Record<string, string> = {
+  "[0]": font0,
+  "[1]": font1,
+  "[2]": font2,
+  "[3]": font3,
+  "[4]": font4,
+  "[5]": font5,
+  "[6]": font6,
+  "[7]": font7,
+  "[8]": font8,
+  "[9]": font9,
+  "[10]": font10,
+  "[11]": font11,
+  "[12]": font12,
+  "[13]": font13,
+  "[14]": font14,
+  "[15]": font15,
+  "[16]": font16,
+  "[17]": font17,
+  "[18]": font18,
+  "[19]": font19,
+  "[20]": font20,
+  "[21]": font21,
+  "[22]": font22,
+  "[23]": font23,
+  "[24]": font24,
+  "[25]": font25,
+  "[26]": font26,
+  "[27]": font27,
+  "[28]": font28,
+  "[29]": font29,
+  "[30]": font30,
+  "[31]": font31,
+  "[32]": font32,
+  "[33]": font33,
+  "[34]": font34,
+  "[35]": font35,
+  "[36]": font36,
+  "[37]": font37,
+  "[38]": font38,
+  "[39]": font39,
+  "[40]": font40,
+  "[41]": font41,
+  "[42]": font42,
+  "[43]": font43,
+  "[44]": font44,
+  "[45]": font45,
+  "[46]": font46,
+  "[47]": font47,
+  "[48]": font48,
+  "[49]": font49,
+  "[50]": font50,
+  "[51]": font51,
+  "[52]": font52,
+  "[53]": font53,
+  "[54]": font54,
+  "[55]": font55,
+  "[56]": font56,
+  "[57]": font57,
+  "[58]": font58,
+  "[59]": font59,
+  "[60]": font60,
+  "[61]": font61,
+  "[62]": font62,
+  "[63]": font63,
+  "[64]": font64,
+  "[65]": font65,
+  "[66]": font66,
+  "[67]": font67,
+  "[68]": font68,
+  "[69]": font69,
+  "[70]": font70,
+  "[71]": font71,
+  "[72]": font72,
+  "[73]": font73,
+  "[74]": font74,
+  "[75]": font75,
+  "[76]": font76,
+  "[77]": font77,
+  "[78]": font78,
+  "[79]": font79,
+  "[80]": font80,
+  "[81]": font81,
+  "[82]": font82,
+  "[83]": font83,
+  "[84]": font84,
+  "[85]": font85,
+  "[86]": font86,
+  "[87]": font87,
+  "[88]": font88,
+  "[89]": font89,
+  "[90]": font90,
+  "[91]": font91,
+  "[92]": font92,
+  "[93]": font93,
+  "[94]": font94,
+  "[95]": font95,
+  "[96]": font96,
+  "[97]": font97,
+  "[98]": font98,
+  "[99]": font99,
+  "[100]": font100,
+  "[101]": font101,
+  "[102]": font102,
+  "[103]": font103,
+  "[104]": font104,
+  "[105]": font105,
+  "[106]": font106,
+  "[107]": font107,
+  "[108]": font108,
+  "[109]": font109,
+  "[110]": font110,
+  "[111]": font111,
+  "[112]": font112,
+  "[113]": font113,
+  "[114]": font114,
+  "[115]": font115,
+  "[116]": font116,
+  "[117]": font117,
+  "[118]": font118,
+  "[119]": font119,
+};
+const loads = new Map<string, Promise<void>>();
+
+export async function loadNotoSansJp(text: string): Promise<void> {
+  const required = new Set<string>();
+  for (const character of text) {
+    const codePoint = character.codePointAt(0);
+    if (codePoint === undefined) continue;
+    for (const [key, range] of Object.entries(unicodeRanges)) {
+      if (!fontUrls[key]) continue;
+      if (rangeContains(range, codePoint)) {
+        required.add(key);
+        break;
+      }
+    }
+  }
+  await Promise.all([...required].map(loadShard));
+}
+
+function loadShard(key: string): Promise<void> {
+  const existing = loads.get(key);
+  if (existing) return existing;
+  const url = fontUrls[key];
+  const unicodeRange = (unicodeRanges as Record<string, string>)[key];
+  if (!url || !unicodeRange) throw new Error(`Missing Noto Sans JP shard ${key}`);
+  const loading = new FontFace(
+    "Noto Sans JP Variable",
+    `url("${url}") format("woff2-variations")`,
+    { style: "normal", weight: "100 900", unicodeRange },
+  )
+    .load()
+    .then((font) => {
+      document.fonts.add(font);
+    })
+    .catch((error: unknown) => {
+      loads.delete(key);
+      throw error;
+    });
+  loads.set(key, loading);
+  return loading;
+}
+
+function rangeContains(range: string, codePoint: number): boolean {
+  for (const token of range.split(",")) {
+    const [startText, endText = startText] = token.trim().slice(2).split("-");
+    const start = Number.parseInt(startText ?? "", 16);
+    const end = Number.parseInt(endText ?? "", 16);
+    if (Number.isFinite(start) && codePoint >= start && codePoint <= end) return true;
+  }
+  return false;
+}

package/src/lib/use-portal-token-style.ts

@@ -0,0 +1,51 @@
+import { type CSSProperties, type RefObject, useEffect, useState } from "react";
+
+export type PortalTokenStyle = CSSProperties & Record<`--${string}`, string>;
+
+/**
+ * Copy the effective SDK tokens across a portal boundary. A locally themed or
+ * rebranded embed cannot rely on CSS inheritance once a portal mounts under
+ * `<body>`. Ancestor theme/class/style mutations and OS color-scheme changes
+ * keep the copied values live.
+ */
+export function usePortalTokenStyle(sourceRef: RefObject<HTMLElement | null>): PortalTokenStyle {
+  const [style, setStyle] = useState<PortalTokenStyle>({});
+  useEffect(() => {
+    const source = sourceRef.current;
+    if (!source || typeof MutationObserver === "undefined") return;
+    let signature = "";
+    const sync = () => {
+      const computed = getComputedStyle(source);
+      const next: PortalTokenStyle = { colorScheme: computed.colorScheme };
+      for (let index = 0; index < computed.length; index += 1) {
+        const property = computed.item(index);
+        if (!property.startsWith("--og-")) continue;
+        next[property as `--${string}`] = computed.getPropertyValue(property);
+      }
+      const nextSignature = JSON.stringify(next);
+      if (nextSignature !== signature) {
+        signature = nextSignature;
+        setStyle(next);
+      }
+    };
+    const observers: MutationObserver[] = [];
+    let ancestor: HTMLElement | null = source;
+    while (ancestor) {
+      const observer = new MutationObserver(sync);
+      observer.observe(ancestor, {
+        attributes: true,
+        attributeFilter: ["class", "data-og-theme", "style"],
+      });
+      observers.push(observer);
+      ancestor = ancestor.parentElement;
+    }
+    const colorScheme = window.matchMedia?.("(prefers-color-scheme: dark)");
+    colorScheme?.addEventListener?.("change", sync);
+    sync();
+    return () => {
+      for (const observer of observers) observer.disconnect();
+      colorScheme?.removeEventListener?.("change", sync);
+    };
+  }, [sourceRef]);
+  return style;
+}

package/src/lib/use-unicode-fonts.ts

@@ -0,0 +1,57 @@
+import { useEffect, useMemo } from "react";
+
+export type UnicodeFontNeeds = {
+  japanese: boolean;
+  arabic: boolean;
+};
+
+const japaneseScript = /[\u3040-\u30ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff]/u;
+const arabicScript = /[\u0600-\u06ff\u0750-\u077f\u0870-\u08ff\ufb50-\ufdff\ufe70-\ufefc]/u;
+
+export function detectUnicodeFontNeeds(values: Iterable<string>): UnicodeFontNeeds {
+  let japanese = false;
+  let arabic = false;
+  for (const value of values) {
+    japanese ||= japaneseScript.test(value);
+    arabic ||= arabicScript.test(value);
+    if (japanese && arabic) break;
+  }
+  return { japanese, arabic };
+}
+
+/**
+ * Load large script-specific font manifests only when visible workspace content
+ * needs them. Fontsource splits the actual glyphs by unicode-range, so Chromium
+ * then fetches only the small shards used by the path instead of charging every
+ * Latin-only session for the complete font.
+ */
+export function useUnicodeFallbackFonts(values: readonly string[]): void {
+  const content = useMemo(() => collectUnicodeContent(values), [values]);
+  useEffect(() => {
+    if (content.japanese) {
+      void import("./noto-sans-jp-loader.generated")
+        .then(({ loadNotoSansJp }) => loadNotoSansJp(content.japanese))
+        .catch(() => undefined);
+    }
+    if (content.arabic) {
+      void import("./noto-sans-arabic-loader")
+        .then(({ loadNotoSansArabic }) => loadNotoSansArabic())
+        .catch(() => undefined);
+    }
+  }, [content.arabic, content.japanese]);
+}
+
+function collectUnicodeContent(values: Iterable<string>): {
+  japanese: string;
+  arabic: string;
+} {
+  const japanese = new Set<string>();
+  const arabic = new Set<string>();
+  for (const value of values) {
+    for (const character of value) {
+      if (japaneseScript.test(character)) japanese.add(character);
+      if (arabicScript.test(character)) arabic.add(character);
+    }
+  }
+  return { japanese: [...japanese].join(""), arabic: [...arabic].join("") };
+}

package/src/provider.tsx

@@ -4,35 +4,12 @@ import {
   type StreamConnectionState,
   type WorkspaceControlEvent,
 } from "@opengeni/sdk";
-import {
-  createContext,
-  useCallback,
-  useContext,
-  useEffect,
-  useMemo,
-  useRef,
-  useState,
-  type ReactNode,
-} from "react";
+import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
 import type { SessionClientLike } from "./client";
+import { OpenGeniContext } from "./session-context";
 
-export 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>;
-};
-
-const OpenGeniContext = createContext<OpenGeniContextValue | null>(null);
-const NOOP_REGISTER_RECONCILER: OpenGeniContextValue["registerSessionReconciler"] = () => () =>
-  undefined;
-const NOOP_RECONCILE_SESSION: OpenGeniContextValue["reconcileSession"] = async () => undefined;
+export { useOpenGeni, useOpenGeniClient } from "./session-context";
+export type { ClientOverride, OpenGeniContextValue } from "./session-context";
 const CONTRACT_RELOAD_STORAGE_PREFIX = "opengeni.reloadForApiContract:";
 
 export type OpenGeniProviderProps = {
@@ -202,45 +179,3 @@ function reloadForContractMismatchOnce(mismatch: OpenGeniApiContractMismatchErro
   sessionStorage.setItem(key, OPENGENI_API_CONTRACT_REVISION);
   window.setTimeout(() => window.location.reload(), 150);
 }
-
-export type ClientOverride = {
-  client?: SessionClientLike | undefined;
-  workspaceId?: string | undefined;
-};
-
-/** Resolve client + workspace from explicit overrides or the provider. */
-export function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue {
-  const context = useContext(OpenGeniContext);
-  const client = override.client ?? context?.client;
-  const workspaceId = override.workspaceId ?? context?.workspaceId;
-  if (!client || !workspaceId) {
-    throw new Error(
-      "@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.",
-    );
-  }
-  return {
-    client,
-    workspaceId,
-    workspaceControlEvent: context?.workspaceControlEvent ?? null,
-    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
-    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
-    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,
-  };
-}
-
-/**
- * Resolve the client only — for hooks that are not workspace-scoped
- * (`useWorkspaces`, `useBillingUsage`).
- */
-export function useOpenGeniClient(
-  override: Pick<ClientOverride, "client"> = {},
-): SessionClientLike {
-  const context = useContext(OpenGeniContext);
-  const client = override.client ?? context?.client;
-  if (!client) {
-    throw new Error(
-      "@opengeni/react: no OpenGeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.",
-    );
-  }
-  return client;
-}

package/src/session-context.ts

@@ -0,0 +1,160 @@
+import type { StreamConnectionState, WorkspaceControlEvent } from "@opengeni/sdk";
+import { createContext, useContext } from "react";
+import type {
+  EmbeddedHumanInputSessionClientLike,
+  EmbeddedSessionMcpApprovalPolicyClientLike,
+  EmbeddedSessionClientLike,
+  SessionClientLike,
+} from "./client";
+
+export 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>;
+};
+
+export const OpenGeniContext = createContext<OpenGeniContextValue | null>(null);
+
+const NOOP_REGISTER_RECONCILER: OpenGeniContextValue["registerSessionReconciler"] = () => () =>
+  undefined;
+const NOOP_RECONCILE_SESSION: OpenGeniContextValue["reconcileSession"] = async () => undefined;
+
+export type ClientOverride = {
+  client?: SessionClientLike | undefined;
+  workspaceId?: string | undefined;
+};
+
+export type EmbeddedSessionClientOverride = {
+  client?: EmbeddedSessionClientLike | undefined;
+  workspaceId?: string | undefined;
+};
+
+export type EmbeddedHumanInputClientOverride = {
+  client?: EmbeddedHumanInputSessionClientLike | undefined;
+  workspaceId?: string | undefined;
+};
+
+export type EmbeddedSessionMcpApprovalPolicyClientOverride = {
+  client?: EmbeddedSessionMcpApprovalPolicyClientLike | undefined;
+  workspaceId?: string | undefined;
+};
+
+export type EmbeddedSessionContextValue = Omit<OpenGeniContextValue, "client"> & {
+  client: EmbeddedSessionClientLike;
+};
+
+/** Resolve client + workspace from explicit overrides or the provider. */
+export function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue {
+  const context = useContext(OpenGeniContext);
+  const client = override.client ?? context?.client;
+  const workspaceId = override.workspaceId ?? context?.workspaceId;
+  if (!client || !workspaceId) {
+    throw new Error(
+      "@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.",
+    );
+  }
+  return {
+    client,
+    workspaceId,
+    workspaceControlEvent: context?.workspaceControlEvent ?? null,
+    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
+    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
+    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,
+  };
+}
+
+/**
+ * Resolve the narrow client required by the session-only hooks. The full
+ * provider client is structurally compatible, while an explicit host proxy
+ * only needs to expose session/event/composer/queue/control operations.
+ */
+export function useEmbeddedSession(
+  override: EmbeddedSessionClientOverride = {},
+): EmbeddedSessionContextValue {
+  const context = useContext(OpenGeniContext);
+  const client = override.client ?? context?.client;
+  const workspaceId = override.workspaceId ?? context?.workspaceId;
+  if (!client || !workspaceId) {
+    throw new Error(
+      "@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.",
+    );
+  }
+  return {
+    client,
+    workspaceId,
+    workspaceControlEvent: context?.workspaceControlEvent ?? null,
+    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
+    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
+    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,
+  };
+}
+
+/**
+ * Resolve the structured-input refinement without widening the baseline
+ * session-only proxy contract.
+ */
+export function useEmbeddedHumanInputSession(override: EmbeddedHumanInputClientOverride = {}): Omit<
+  EmbeddedSessionContextValue,
+  "client"
+> & {
+  client: EmbeddedHumanInputSessionClientLike;
+} {
+  const embedded = useEmbeddedSession(override);
+  const client = embedded.client as Partial<EmbeddedHumanInputSessionClientLike>;
+  if (
+    typeof client.listHumanInputRequests !== "function" ||
+    typeof client.getHumanInputRequest !== "function" ||
+    typeof client.submitHumanInputResponse !== "function"
+  ) {
+    throw new Error(
+      "@opengeni/react: useHumanInputRequests requires listHumanInputRequests, getHumanInputRequest, and submitHumanInputResponse.",
+    );
+  }
+  return {
+    ...embedded,
+    client: client as EmbeddedHumanInputSessionClientLike,
+  };
+}
+
+/** Resolve the approval-policy refinement without widening session-only hosts. */
+export function useEmbeddedSessionMcpApprovalPolicy(
+  override: EmbeddedSessionMcpApprovalPolicyClientOverride = {},
+): Omit<EmbeddedSessionContextValue, "client"> & {
+  client: EmbeddedSessionMcpApprovalPolicyClientLike;
+} {
+  const embedded = useEmbeddedSession(override);
+  const client = embedded.client as Partial<EmbeddedSessionMcpApprovalPolicyClientLike>;
+  if (typeof client.updateSessionMcpApprovalPolicy !== "function") {
+    throw new Error(
+      "@opengeni/react: useSessionMcpApprovalPolicy requires updateSessionMcpApprovalPolicy.",
+    );
+  }
+  return {
+    ...embedded,
+    client: client as EmbeddedSessionMcpApprovalPolicyClientLike,
+  };
+}
+
+/**
+ * Resolve the client only — for hooks that are not workspace-scoped
+ * (`useWorkspaces`, `useBillingUsage`).
+ */
+export function useOpenGeniClient(
+  override: Pick<ClientOverride, "client"> = {},
+): SessionClientLike {
+  const context = useContext(OpenGeniContext);
+  const client = override.client ?? context?.client;
+  if (!client) {
+    throw new Error(
+      "@opengeni/react: no OpenGeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.",
+    );
+  }
+  return client;
+}