@opengeni/react 0.37.0 → 0.41.0

package/README.md

@@ -13,7 +13,8 @@ The default root import (`@opengeni/react`) is the clean sandbox-agnostic
 surface — the chat/timeline hooks and components plus the sandbox workspace
 suite. Advanced chat-composer composition lives under
 `@opengeni/react/composer`; Connected-Machine UI lives under
-`@opengeni/react/machines`. (The root barrel still re-exports the machines
+`@opengeni/react/machines`; realtime voice controls live under the lazily
+loadable `@opengeni/react/realtime` subpath. (The root barrel still re-exports the machines
 island for back-compat, deprecated per #144.)
 
 Design-system-first: every visual decision routes through CSS-variable tokens
@@ -118,6 +119,89 @@ export function App() {
 }
 ```
 
+## Realtime composer controls (`@opengeni/react/realtime`)
+
+The realtime subpath is the exact OpenGeni composer experience: model catalog
+and selection, split-button motion, start/stop/retry states, microphone and
+audio mute controls, diagnostics, recovery, and the same copy, ARIA, classes,
+and styling used by the web console. It is deliberately separate from the root
+entry so SSR and non-realtime consumers do not eagerly load browser media or
+transport code.
+
+For an existing session, place one public component in the composer's action
+slot. It resolves `client` and `workspaceId` from `OpenGeniProvider` and reuses
+the host's existing session/event projection rather than opening a duplicate
+stream:
+
+```tsx
+import { ChatComposer } from "@opengeni/react";
+import { SessionRealtimeControl } from "@opengeni/react/realtime";
+
+<ChatComposer
+  composer={composer}
+  effectiveControl={effectiveControl}
+  actionsStart={
+    <SessionRealtimeControl
+      sessionId={sessionId}
+      sessionStatus={sessionStatus}
+      effectiveControl={effectiveControl}
+      events={events}
+      eventsReady={!initialLoading}
+      codexConnected={codexConnected}
+    />
+  }
+/>;
+```
+
+For a new-session composer, create the session with `startMode: "realtime"`,
+navigate to it, and pass the selected model to the same existing-session
+control's `realtimeAutostartModel` prop:
+
+```tsx
+import { NewSessionRealtimeControl } from "@opengeni/react/realtime";
+
+<NewSessionRealtimeControl
+  codexConnected={codexConnected}
+  onStart={async (model) => {
+    const session = await client.createSession(workspaceId, {
+      requestedSessionId: crypto.randomUUID(),
+      startMode: "realtime",
+      idempotencyKey: crypto.randomUUID(),
+    });
+    navigateToSession(session.id, { realtimeAutostartModel: model });
+    return true;
+  }}
+/>;
+```
+
+Proxy-backed hosts can pass explicit `client` and `workspaceId` overrides. The
+exported `EmbeddedRealtimeSessionClientLike` requires only catalog, begin,
+Codex/Gateway negotiation, activation, heartbeat, ledger sync, and end. For
+custom layouts, use `useSessionRealtime`, `useRealtimeModelSelection`,
+`RealtimeVoiceControl`, and `RealtimeModelPickerMenu`; the batteries-included
+wrappers remain the recommended path.
+
+The reference consumer is `demo/realtime.html`. Run `bun run demo` from
+`packages/react`, then open `http://localhost:3100/realtime.html?mode=mock` for
+deterministic selection/start/mute/stop/reconnect/error testing. Use
+`?mode=live&workspaceId=…&sessionId=…` against the web server's same-origin
+`/demo-api` proxy for a real local OpenGeni environment. Configure
+`OPENGENI_DEMO_API_URL` and, only on the server, optional demo API/access
+credentials; the browser receives neither credential. Prefer the deployment's
+normal browser authentication. If the proxy needs a server credential, create a
+dedicated tenant-scoped, least-privilege key for the reference demo and never
+reuse a deployment-wide runtime secret. Helm deployments can mount a Secret
+containing only `api-key` and/or `access-key` with
+`web.demoApiCredentialsSecret`; those values are mounted read-only rather than
+exposed as container environment variables. Local non-Kubernetes servers may
+instead use `OPENGENI_DEMO_API_KEY` and/or `OPENGENI_DEMO_ACCESS_KEY`.
+
+Microphone capture works on `localhost` or a secure HTTPS origin. A remote HTTP
+deployment cannot request microphone access. The live page exercises catalog
+loading, realtime-first creation, Codex Live, Gateway models, mute, recovery,
+delegation/context timeline updates, structured questions, and stop/restart
+through published package APIs only.
+
 ## Composer customization (`@opengeni/react/composer`)
 
 Use `ChatComposer` for the standard layout and its `controlsStart`, `header`,
@@ -418,4 +502,6 @@ what the surfaces you mount need:
 `bun run demo` (from this package) serves a harness that drives the real hooks
 and components against a scripted mock client — a manager ops-channel narrative
 with streaming, tool calls, and a worker spawn, plus fleet and scheduled-task
-views and a dark/light toggle. `bun run demo:build` is part of the repo gate.
+views and a dark/light toggle. `realtime.html` is the public-package reference
+consumer described above, with deterministic mock and same-origin live modes.
+`bun run demo:build` is part of the repo gate.

package/dist/{chunk-7CJOAW3V.js → chunk-EB67J347.js}

@@ -1,127 +1,3 @@
-// src/session-context.ts
-import { createContext, useContext } from "react";
-var OpenGeniContext = createContext(null);
-var NOOP_REGISTER_RECONCILER = () => () => void 0;
-var NOOP_RECONCILE_SESSION = async () => void 0;
-function useEmbeddedClientRefinement(override, requiredMethods, hookName) {
-  const context = useContext(OpenGeniContext);
-  const candidate = override.client ?? context?.client;
-  const workspaceId = override.workspaceId ?? context?.workspaceId;
-  if (!candidate || !workspaceId) {
-    throw new Error(
-      "@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook."
-    );
-  }
-  const methods = candidate;
-  const missing = requiredMethods.filter((method) => typeof methods[method] !== "function");
-  if (missing.length > 0) {
-    throw new Error(
-      `@opengeni/react: ${hookName} requires client method${missing.length === 1 ? "" : "s"} ${missing.join(", ")}.`
-    );
-  }
-  return {
-    client: candidate,
-    workspaceId,
-    workspaceControlEvent: context?.workspaceControlEvent ?? null,
-    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
-    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
-    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION
-  };
-}
-function eventClientMethods(override, directMethods) {
-  const hasSharedEventFeed = "events" in override && override.events !== void 0;
-  return hasSharedEventFeed ? directMethods : ["getSession", "streamEvents", ...directMethods];
-}
-function useOpenGeni(override = {}) {
-  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
-  };
-}
-function useEmbeddedSession(override = {}) {
-  return useEmbeddedClientRefinement(
-    override,
-    [
-      "getSession",
-      "listEvents",
-      "streamEvents",
-      "getComposerDraft",
-      "saveComposerDraft",
-      "sendMessage",
-      "steerMessage",
-      "getQueue",
-      "moveQueueItem",
-      "editQueueItem",
-      "steerQueueItem",
-      "deleteQueueItem",
-      "pauseSession",
-      "resumeSession",
-      "sendApprovalDecision"
-    ],
-    "session hooks"
-  );
-}
-function useEmbeddedSessionRead(override = {}) {
-  return useEmbeddedClientRefinement(
-    override,
-    eventClientMethods(override, ["getSession", "updateSession"]),
-    "useSession"
-  );
-}
-function useEmbeddedGoal(override = {}) {
-  return useEmbeddedClientRefinement(
-    override,
-    eventClientMethods(override, ["getGoal", "updateGoal", "deleteGoal"]),
-    "useGoal"
-  );
-}
-function useEmbeddedSessionLineage(override = {}) {
-  return useEmbeddedClientRefinement(
-    override,
-    eventClientMethods(override, ["getSessionLineage"]),
-    "useSessionLineage"
-  );
-}
-function useEmbeddedFileAttachments(override = {}) {
-  return useEmbeddedClientRefinement(override, ["uploadFile"], "useFileAttachments");
-}
-function useEmbeddedHumanInputSession(override = {}) {
-  return useEmbeddedClientRefinement(
-    override,
-    eventClientMethods(override, ["listHumanInputRequests", "submitHumanInputResponse"]),
-    "useHumanInputRequests"
-  );
-}
-function useEmbeddedSessionMcpApprovalPolicy(override = {}) {
-  return useEmbeddedClientRefinement(
-    override,
-    eventClientMethods(override, ["getSession", "updateSessionMcpApprovalPolicy"]),
-    "useSessionMcpApprovalPolicy"
-  );
-}
-function useOpenGeniClient(override = {}) {
-  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;
-}
-
 // src/hooks/internal.ts
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 function usePolledValue(load, options = {}) {
@@ -374,19 +250,9 @@ function useDebouncedCallback(callback, delayMs = 150) {
 }
 
 export {
-  OpenGeniContext,
-  useOpenGeni,
-  useEmbeddedSession,
-  useEmbeddedSessionRead,
-  useEmbeddedGoal,
-  useEmbeddedSessionLineage,
-  useEmbeddedFileAttachments,
-  useEmbeddedHumanInputSession,
-  useEmbeddedSessionMcpApprovalPolicy,
-  useOpenGeniClient,
   usePolledValue,
   useMutationRunner,
   useSessionEventTrigger,
   useDebouncedCallback
 };
-//# sourceMappingURL=chunk-7CJOAW3V.js.map
+//# sourceMappingURL=chunk-EB67J347.js.map

package/dist/chunk-EB67J347.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/internal.ts"],"sourcesContent":["import type { SessionEvent } from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport type { EmbeddedSessionEventClientLike } from \"../client\";\n\nexport type AsyncListState<T> = {\n  data: T | null;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n};\n\n/**\n * Shared fetch + optional polling loop for the list/read hooks. Stale\n * responses (superseded by a newer load or an unmount) are dropped.\n */\nexport function usePolledValue<T>(\n  load: (signal?: AbortSignal) => Promise<T>,\n  options: { pollIntervalMs?: number | undefined; enabled?: boolean | undefined } = {},\n): AsyncListState<T> {\n  const enabled = options.enabled ?? true;\n  const pollIntervalMs = options.pollIntervalMs;\n  const [data, setData] = useState<T | null>(null);\n  const [loading, setLoading] = useState(enabled);\n  const [error, setError] = useState<Error | null>(null);\n  const generation = useRef(0);\n  const activeLoadRef = useRef(load);\n  useLayoutEffect(() => {\n    activeLoadRef.current = load;\n  }, [load]);\n  const requestAbortRef = useRef<AbortController | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<{ load: typeof load }>(() => ({ load }));\n\n  // A new loader identity means a new query (different session/workspace/...):\n  // drop the previous result instead of showing it as the new query's data.\n  useEffect(() => {\n    if (stateIdentity.load !== load) {\n      setStateIdentity({ load });\n      setData(null);\n      setError(null);\n    }\n  }, [load, stateIdentity.load]);\n\n  const run = useCallback(async () => {\n    // A callback retained by a completed mutation from the previous query must\n    // not supersede or settle the current query's request.\n    if (activeLoadRef.current !== load) return;\n    const ticket = ++generation.current;\n    requestAbortRef.current?.abort();\n    const requestAbort = new AbortController();\n    requestAbortRef.current = requestAbort;\n    try {\n      const result = await load(requestAbort.signal);\n      if (\n        ticket === generation.current &&\n        activeLoadRef.current === load &&\n        !requestAbort.signal.aborted\n      ) {\n        setData(result);\n        setError(null);\n        setLoading(false);\n      }\n    } catch (cause) {\n      if (\n        ticket === generation.current &&\n        activeLoadRef.current === load &&\n        !requestAbort.signal.aborted\n      ) {\n        setError(cause instanceof Error ? cause : new Error(String(cause)));\n        setLoading(false);\n      }\n    } finally {\n      if (requestAbortRef.current === requestAbort) {\n        requestAbortRef.current = null;\n      }\n    }\n  }, [load]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setLoading(false);\n      return;\n    }\n    setLoading(true);\n    void run();\n    if (pollIntervalMs === undefined || pollIntervalMs <= 0) {\n      return () => {\n        generation.current += 1;\n        requestAbortRef.current?.abort();\n      };\n    }\n    const timer = setInterval(() => void run(), pollIntervalMs);\n    return () => {\n      clearInterval(timer);\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n    };\n  }, [run, enabled, pollIntervalMs]);\n\n  const identityMatches = stateIdentity.load === load;\n  return {\n    data: identityMatches ? data : null,\n    loading: identityMatches ? loading : enabled,\n    error: identityMatches ? error : null,\n    refresh: run,\n  };\n}\n\nexport type MutationState = {\n  mutating: boolean;\n  mutationError: Error | null;\n  clearMutationError: () => void;\n};\n\n/**\n * Shared async mutation runner for the write hooks. `run` resolves with the\n * operation's value, or `null` after capturing the error in `mutationError`\n * (callers then roll back optimistic state).\n */\nexport function useMutationRunner(identity: unknown = undefined): MutationState & {\n  run: <T>(operation: () => Promise<T>) => Promise<T | null>;\n} {\n  const [mutating, setMutating] = useState(false);\n  const [mutationError, setMutationError] = useState<Error | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<unknown>(() => identity);\n  const inFlight = useRef(0);\n  const generation = useRef(0);\n  const identityRef = useRef(identity);\n  useLayoutEffect(() => {\n    if (Object.is(identityRef.current, identity)) return;\n    identityRef.current = identity;\n    generation.current += 1;\n    inFlight.current = 0;\n  }, [identity]);\n  const mounted = useRef(true);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n  useEffect(() => {\n    if (!Object.is(stateIdentity, identity)) {\n      setStateIdentity(() => identity);\n      setMutating(false);\n      setMutationError(null);\n    }\n  }, [identity, stateIdentity]);\n  const run = useCallback(\n    async <T>(operation: () => Promise<T>): Promise<T | null> => {\n      const ownedIdentity = identity;\n      const ownedGeneration = generation.current;\n      if (!Object.is(identityRef.current, ownedIdentity)) return null;\n      inFlight.current += 1;\n      if (mounted.current) {\n        setMutating(true);\n        setMutationError(null);\n      }\n      try {\n        const result = await operation();\n        if (\n          !mounted.current ||\n          generation.current !== ownedGeneration ||\n          !Object.is(identityRef.current, ownedIdentity)\n        ) {\n          return null;\n        }\n        return result;\n      } catch (cause) {\n        if (\n          mounted.current &&\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          setMutationError(cause instanceof Error ? cause : new Error(String(cause)));\n        }\n        return null;\n      } finally {\n        if (\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          inFlight.current -= 1;\n          if (mounted.current && inFlight.current === 0) {\n            setMutating(false);\n          }\n        }\n      }\n    },\n    [identity],\n  );\n  const identityMatches = Object.is(stateIdentity, identity);\n  return {\n    mutating: identityMatches && mutating,\n    mutationError: identityMatches ? mutationError : null,\n    clearMutationError: useCallback(() => {\n      if (Object.is(identityRef.current, identity)) setMutationError(null);\n    }, [identity]),\n    run,\n  };\n}\n\nexport type SessionEventFeedOptions = {\n  /**\n   * Share an existing event log (from `useSessionEvents`) instead of opening\n   * a second stream. When omitted the hook tails the session's event stream\n   * itself, starting at the current `lastSequence`.\n   */\n  events?: SessionEvent[] | undefined;\n  enabled?: boolean | undefined;\n};\n\n/**\n * Invoke `onEvent` for every session event matching `match` — the live-update\n * primitive behind `useTurnQueue` and `useGoal`. Either watches a shared\n * `events` log or tails the stream directly (reconnect handled by the SDK).\n */\nexport function useSessionEventTrigger(\n  client: EmbeddedSessionEventClientLike,\n  workspaceId: string,\n  sessionId: string | null | undefined,\n  match: (event: SessionEvent) => boolean,\n  onEvent: (event: SessionEvent) => void,\n  options: SessionEventFeedOptions = {},\n  reconcileBeforeLive?: (() => void | Promise<void>) | undefined,\n): void {\n  const enabled = options.enabled ?? true;\n  const events = options.events;\n  const sharedFeed = events !== undefined;\n  const matchRef = useRef(match);\n  const onEventRef = useRef(onEvent);\n  const reconcileBeforeLiveRef = useRef(reconcileBeforeLive);\n  useLayoutEffect(() => {\n    matchRef.current = match;\n    onEventRef.current = onEvent;\n    reconcileBeforeLiveRef.current = reconcileBeforeLive;\n  }, [match, onEvent, reconcileBeforeLive]);\n  const consumedRef = useRef(0);\n  const feedKeyRef = useRef<string | null>(null);\n  const sharedFeedHasEventsRef = useRef(false);\n\n  // Shared-log mode: scan only the unseen tail on every append.\n  useEffect(() => {\n    if (!sharedFeed || !enabled || !sessionId) {\n      return;\n    }\n    const feedKey = `${workspaceId}\\u0000${sessionId}`;\n    const firstSequence = events[0]?.sequence ?? 0;\n    if (feedKeyRef.current !== feedKey) {\n      feedKeyRef.current = feedKey;\n      sharedFeedHasEventsRef.current = events.length > 0;\n      // The caller has already loaded its authoritative initial projection.\n      // Seed from the shared log's current tail so mounting a large historical\n      // session cannot replay every old event as a new live trigger.\n      consumedRef.current = events.at(-1)?.sequence ?? 0;\n      return;\n    }\n    const firstNonEmptyBatch = !sharedFeedHasEventsRef.current && events.length > 0;\n    if (firstNonEmptyBatch || firstSequence > consumedRef.current + 1) {\n      // The usual shared feed mounts empty, then receives a historical tail.\n      // A later discontinuity can likewise replace the retained browser\n      // window. In either case, reconcile once from the latest relevant event\n      // instead of replaying the whole retained window as live traffic.\n      sharedFeedHasEventsRef.current = events.length > 0;\n      consumedRef.current = events.at(-1)?.sequence ?? consumedRef.current;\n      let latestMatch: SessionEvent | undefined;\n      for (let index = events.length - 1; index >= 0; index -= 1) {\n        const event = events[index];\n        if (event && matchRef.current(event)) {\n          latestMatch = event;\n          break;\n        }\n      }\n      if (latestMatch) {\n        onEventRef.current(latestMatch);\n      }\n      return;\n    }\n    sharedFeedHasEventsRef.current ||= events.length > 0;\n    for (const event of events) {\n      if (event.sequence <= consumedRef.current) {\n        continue;\n      }\n      consumedRef.current = event.sequence;\n      if (matchRef.current(event)) {\n        onEventRef.current(event);\n      }\n    }\n  }, [sharedFeed, enabled, events, workspaceId, sessionId]);\n\n  // Self-stream mode: tail from the session's current lastSequence.\n  useEffect(() => {\n    if (sharedFeed || !enabled || !sessionId) {\n      return;\n    }\n    const controller = new AbortController();\n    void (async () => {\n      try {\n        const session = await client.getSession(workspaceId, sessionId);\n        if (controller.signal.aborted) {\n          return;\n        }\n        const stream = client.streamEvents(workspaceId, sessionId, {\n          after: session.lastSequence,\n          signal: controller.signal,\n          beforeLive: async () => await reconcileBeforeLiveRef.current?.(),\n        });\n        for await (const event of stream) {\n          if (matchRef.current(event)) {\n            onEventRef.current(event);\n          }\n        }\n      } catch {\n        // Live updates are best-effort: the read hooks still expose refresh()\n        // and the initial load already populated state.\n      }\n    })();\n    return () => {\n      controller.abort();\n    };\n  }, [sharedFeed, enabled, client, workspaceId, sessionId]);\n}\n\n/** Debounce rapid event bursts into one trailing call (default 150ms). */\nexport function useDebouncedCallback(callback: () => void, delayMs = 150): () => void {\n  const callbackRef = useRef(callback);\n  useLayoutEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(() => {\n    return () => {\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n      }\n    };\n  }, []);\n  return useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n    }\n    timerRef.current = setTimeout(() => {\n      timerRef.current = null;\n      callbackRef.current();\n    }, delayMs);\n  }, [delayMs]);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-EKZH6IDG.js

@@ -0,0 +1,141 @@
+// src/session-context.ts
+import { createContext, useContext } from "react";
+var OpenGeniContext = createContext(null);
+var NOOP_REGISTER_RECONCILER = () => () => void 0;
+var NOOP_RECONCILE_SESSION = async () => void 0;
+function useEmbeddedClientRefinement(override, requiredMethods, hookName) {
+  const context = useContext(OpenGeniContext);
+  const candidate = override.client ?? context?.client;
+  const workspaceId = override.workspaceId ?? context?.workspaceId;
+  if (!candidate || !workspaceId) {
+    throw new Error(
+      "@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook."
+    );
+  }
+  const methods = candidate;
+  const missing = requiredMethods.filter((method) => typeof methods[method] !== "function");
+  if (missing.length > 0) {
+    throw new Error(
+      `@opengeni/react: ${hookName} requires client method${missing.length === 1 ? "" : "s"} ${missing.join(", ")}.`
+    );
+  }
+  return {
+    client: candidate,
+    workspaceId,
+    workspaceControlEvent: context?.workspaceControlEvent ?? null,
+    workspaceControlConnectionState: context?.workspaceControlConnectionState ?? "idle",
+    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,
+    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION
+  };
+}
+function eventClientMethods(override, directMethods) {
+  const hasSharedEventFeed = "events" in override && override.events !== void 0;
+  return hasSharedEventFeed ? directMethods : ["getSession", "streamEvents", ...directMethods];
+}
+function useOpenGeni(override = {}) {
+  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
+  };
+}
+function useEmbeddedSession(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    [
+      "getSession",
+      "listEvents",
+      "streamEvents",
+      "getComposerDraft",
+      "saveComposerDraft",
+      "sendMessage",
+      "steerMessage",
+      "getQueue",
+      "moveQueueItem",
+      "editQueueItem",
+      "steerQueueItem",
+      "deleteQueueItem",
+      "pauseSession",
+      "resumeSession",
+      "sendApprovalDecision"
+    ],
+    "session hooks"
+  );
+}
+function useEmbeddedSessionRead(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    eventClientMethods(override, ["getSession", "updateSession"]),
+    "useSession"
+  );
+}
+function useEmbeddedGoal(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    eventClientMethods(override, ["getGoal", "updateGoal", "deleteGoal"]),
+    "useGoal"
+  );
+}
+function useEmbeddedSessionLineage(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    eventClientMethods(override, ["getSessionLineage"]),
+    "useSessionLineage"
+  );
+}
+function useEmbeddedFileAttachments(override = {}) {
+  return useEmbeddedClientRefinement(override, ["uploadFile"], "useFileAttachments");
+}
+function useEmbeddedHumanInputSession(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    eventClientMethods(override, ["listHumanInputRequests", "submitHumanInputResponse"]),
+    "useHumanInputRequests"
+  );
+}
+function useEmbeddedSessionMcpApprovalPolicy(override = {}) {
+  return useEmbeddedClientRefinement(
+    override,
+    eventClientMethods(override, ["getSession", "updateSessionMcpApprovalPolicy"]),
+    "useSessionMcpApprovalPolicy"
+  );
+}
+function useEmbeddedRealtimeSession(override = {}) {
+  return useEmbeddedClientRefinement(override, [], "realtime hooks");
+}
+function useOpenGeniClient(override = {}) {
+  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;
+}
+
+export {
+  OpenGeniContext,
+  useOpenGeni,
+  useEmbeddedSession,
+  useEmbeddedSessionRead,
+  useEmbeddedGoal,
+  useEmbeddedSessionLineage,
+  useEmbeddedFileAttachments,
+  useEmbeddedHumanInputSession,
+  useEmbeddedSessionMcpApprovalPolicy,
+  useEmbeddedRealtimeSession,
+  useOpenGeniClient
+};
+//# sourceMappingURL=chunk-EKZH6IDG.js.map

package/dist/chunk-EKZH6IDG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-context.ts"],"sourcesContent":["import type { StreamConnectionState, WorkspaceControlEvent } from \"@opengeni/sdk\";\nimport { createContext, useContext } from \"react\";\nimport type {\n  EmbeddedFileAttachmentClientLike,\n  EmbeddedGoalClientLike,\n  EmbeddedHumanInputSessionClientLike,\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  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 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    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    registerSessionReconciler: context?.registerSessionReconciler ?? NOOP_REGISTER_RECONCILER,\n    reconcileSession: context?.reconcileSession ?? NOOP_RECONCILE_SESSION,\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-FSPDND3P.js → chunk-JALF5FI3.js}

@@ -5,17 +5,19 @@ import {
 } from "./chunk-4IJCL7YO.js";
 import {
   useDebouncedCallback,
+  useMutationRunner,
+  usePolledValue,
+  useSessionEventTrigger
+} from "./chunk-EB67J347.js";
+import {
   useEmbeddedFileAttachments,
   useEmbeddedGoal,
   useEmbeddedHumanInputSession,
   useEmbeddedSession,
   useEmbeddedSessionLineage,
   useEmbeddedSessionMcpApprovalPolicy,
-  useEmbeddedSessionRead,
-  useMutationRunner,
-  usePolledValue,
-  useSessionEventTrigger
-} from "./chunk-7CJOAW3V.js";
+  useEmbeddedSessionRead
+} from "./chunk-EKZH6IDG.js";
 
 // src/hooks/use-session.ts
 import { useCallback, useEffect, useMemo, useState } from "react";
@@ -2100,4 +2102,4 @@ export {
   isHumanInputEvent,
   useHumanInputRequests
 };
-//# sourceMappingURL=chunk-FSPDND3P.js.map
+//# sourceMappingURL=chunk-JALF5FI3.js.map