@opengeni/react 1.3.0 → 1.4.0

package/src/components/open-geni-chat.tsx

@@ -1,4 +1,10 @@
-import type { FileResourceRef, LatencyMode, OpenGeniClient, ReasoningEffort } from "@opengeni/sdk";
+import {
+  OpenGeniApiError,
+  type FileResourceRef,
+  type LatencyMode,
+  type OpenGeniClient,
+  type ReasoningEffort,
+} from "@opengeni/sdk";
 import { MenuIcon, XIcon } from "lucide-react";
 import { useCallback, useRef, useState, type CSSProperties, type FormEvent } from "react";
 import { useWorkspaceModelCatalog } from "../hooks/use-available-models";
@@ -14,9 +20,10 @@ import {
 import { useOpenGeni, type ClientOverride } from "../session-context";
 import { ChatComposer } from "./chat-composer";
 import { ModelPolicyPicker } from "./model-policy-picker";
+import { useClientConfigFlags } from "../hooks/use-client-config-flags";
 import {
   SessionConversation,
-  useClientConfigFlags,
+  useComposerTranscription,
   type SessionConversationProps,
 } from "./session-conversation";
 import { SessionList, type SessionListLabels, type SessionListProps } from "./session-list";
@@ -71,7 +78,11 @@ export type OpenGeniChatProps = ClientOverride &
           options: OpenGeniChatCreateOptions,
         ) => Promise<string>)
       | undefined;
-    /** Hide the "New chat" entry point. */
+    /**
+     * Hide the "New chat" entry point. It is also hidden when the session proxy
+     * reports chat creation unavailable (no `createSession` hook) and no
+     * `createSession` prop is given.
+     */
     newChat?: boolean | undefined;
     /**
      * Forwarded to the conversation (message rendering, tool renderers,
@@ -152,6 +163,9 @@ function Chat({
   const [listRevision, setListRevision] = useState(0);
   const root = useRef<HTMLDivElement>(null);
   const hostTheme = useHostTheme(root, { theme, surface });
+  const config = useClientConfigFlags(context.client);
+  // A host creator replaces the proxy route; otherwise trust the proxy's report.
+  const canCreate = createSession !== undefined || config.sessionCreation;
 
   const select = useCallback(
     (next: string | null) => {
@@ -171,12 +185,20 @@ function Chat({
       if (createSession) return await createSession(initialMessage, idempotencyKey, options);
       const creator = (context.client as unknown as CreateClient).createSession;
       if (typeof creator !== "function") throw new Error(labels.newChatUnavailable);
-      const created = await creator.call(context.client, context.workspaceId, {
-        initialMessage,
-        idempotencyKey,
-        ...options,
-      } as Parameters<NonNullable<CreateClient["createSession"]>>[1]);
-      return created.id;
+      try {
+        const created = await creator.call(context.client, context.workspaceId, {
+          initialMessage,
+          idempotencyKey,
+          ...options,
+        } as Parameters<NonNullable<CreateClient["createSession"]>>[1]);
+        return created.id;
+      } catch (error) {
+        // A proxy without a createSession hook refuses the route itself.
+        if (error instanceof OpenGeniApiError && error.code === "route_not_allowed") {
+          throw new Error(labels.newChatUnavailable, { cause: error });
+        }
+        throw error;
+      }
     },
     [context.client, context.workspaceId, createSession, labels.newChatUnavailable],
   );
@@ -188,7 +210,7 @@ function Chat({
       labels={labels}
       selectedSessionId={selected}
       onSelect={select}
-      onNewChat={newChat ? () => select(null) : undefined}
+      onNewChat={newChat && canCreate ? () => select(null) : undefined}
       onArchived={(archivedId) => {
         if (archivedId === selected) select(null);
       }}
@@ -256,6 +278,8 @@ function Chat({
           {selected ? (
             <SessionConversation
               {...conversationProps}
+              // Sub-agent chats open in place, like a chat from the list.
+              onOpenSession={conversationProps?.onOpenSession ?? select}
               {...scope}
               sessionId={selected}
               height="100%"
@@ -266,6 +290,7 @@ function Chat({
               labels={labels}
               placeholderOverride={labelOverrides?.newChatPlaceholder}
               conversationProps={conversationProps}
+              available={canCreate}
               create={create}
               onCreated={(id) => {
                 setListRevision((revision) => revision + 1);
@@ -291,6 +316,7 @@ function NewChat({
   labels,
   placeholderOverride,
   conversationProps,
+  available,
   create,
   onCreated,
 }: {
@@ -298,6 +324,8 @@ function NewChat({
   labels: OpenGeniChatLabels;
   placeholderOverride: string | undefined;
   conversationProps: OpenGeniChatProps["conversationProps"];
+  /** False when this product cannot start chats; the composer is disabled and says so. */
+  available: boolean;
   create: (
     initialMessage: string,
     idempotencyKey: string,
@@ -317,6 +345,11 @@ function NewChat({
   });
   const files = useFileAttachments(scope);
   const uploadsEnabled = (conversationProps?.attachments ?? true) && config.uploads;
+  const transcription = useComposerTranscription(
+    context.client,
+    context.workspaceId,
+    (conversationProps?.voiceInput ?? true) && available ? config.voiceInput : null,
+  );
   const [text, setText] = useState("");
   const [sending, setSending] = useState(false);
   const [error, setError] = useState<{ cause: unknown } | null>(null);
@@ -333,7 +366,7 @@ function NewChat({
 
   const submit = async (): Promise<boolean> => {
     const initialMessage = text.trim() || (resources.length > 0 ? FILE_ONLY_MESSAGE_TEXT : "");
-    if (!initialMessage || sending || pendingFiles) return false;
+    if (!initialMessage || sending || pendingFiles || !available) return false;
     const options: OpenGeniChatCreateOptions = {
       ...(resources.length > 0 ? { resources } : {}),
       ...(showModelPicker ? choice : {}),
@@ -377,7 +410,8 @@ function NewChat({
     send: submit,
     steer: submit,
     sending,
-    canSend: (text.trim().length > 0 || resources.length > 0) && !sending && !pendingFiles,
+    canSend:
+      available && (text.trim().length > 0 || resources.length > 0) && !sending && !pendingFiles,
     pause: NOOP_ASYNC,
     pausing: false,
     resume: NOOP_ASYNC,
@@ -420,8 +454,10 @@ function NewChat({
       ) : null}
       <ChatComposer
         {...composerProps}
+        {...(transcription && composerProps?.transcription === undefined ? { transcription } : {})}
         composer={composer}
         attachments={uploadsEnabled ? files : undefined}
+        disabled={!available || composerProps?.disabled}
         runControl="none"
         running={false}
         placeholder={placeholderOverride ?? composerProps?.placeholder ?? labels.newChatPlaceholder}
@@ -455,7 +491,11 @@ function NewChat({
         }
         responsiveBasis={composerProps?.responsiveBasis ?? "container"}
       />
-      {error ? (
+      {!available ? (
+        <p className="text-center text-og-sm text-og-fg-muted" data-og-new-chat-unavailable="">
+          {labels.newChatUnavailable}
+        </p>
+      ) : error ? (
         <p role="alert" className="text-center text-og-sm text-og-status-failed">
           {formatError(
             error.cause,

package/src/components/session-conversation.tsx

@@ -1,4 +1,10 @@
-import { SESSION_SCOPE_HEADER, type ReasoningEffort, type SendMessageInput } from "@opengeni/sdk";
+import {
+  resolveWorkspaceVoiceInputEnabled,
+  SESSION_SCOPE_HEADER,
+  type ClientVoiceInputConfig,
+  type OpenGeniClient,
+  type SendMessageInput,
+} from "@opengeni/sdk";
 import {
   lazy,
   Suspense,
@@ -7,6 +13,7 @@ import {
   useMemo,
   useRef,
   useState,
+  type ComponentProps,
   type CSSProperties,
 } from "react";
 import type { SiteSnapshotClient } from "./artifacts/chat-interactive-block";
@@ -20,9 +27,17 @@ import { useComposer } from "../hooks/use-composer";
 import { useHumanInputRequests } from "../hooks/use-human-input";
 import { useFileAttachments } from "../hooks/use-file-attachments";
 import { useSessionControl } from "../hooks/use-session-control";
+import { useGoal, type UseGoalOptions } from "../hooks/use-goal";
+import { useClientConfigFlags } from "../hooks/use-client-config-flags";
+import {
+  createSessionRetainedScreenshotLoader,
+  createWorkspaceRetainedArtifactLoader,
+  createWorkspaceRetainedVideoLoader,
+} from "../timeline/retained-loaders";
 import { projectPendingApprovals } from "../approvals";
 import { ApprovalSurface } from "./approval-surface";
 import { ChatComposer, type ChatComposerProps } from "./chat-composer";
+import type { ComposerTranscriptionControlProps } from "./composer-transcription-control";
 import { SessionChrome } from "./session-chrome";
 import { HumanInputSurface, type HumanInputSurfaceProps } from "./human-input-surface";
 import { MessageTimeline, type MessageTimelineProps } from "./message-timeline";
@@ -50,11 +65,14 @@ export type SessionConversationLabels = {
   retry: string;
   /** Action when the conversation could not load at all. */
   tryAgain: string;
+  /** Shown in place of a Site preview when the session proxy does not serve Sites. */
+  sitePreviewUnavailable: string;
 };
 
 const DEFAULT_CONVERSATION_LABELS: SessionConversationLabels = {
   retry: "Retry",
   tryAgain: "Try again",
+  sitePreviewUnavailable: "Site preview unavailable",
 };
 
 export type SessionConversationProps = ClientOverride &
@@ -75,10 +93,17 @@ export type SessionConversationProps = ClientOverride &
      * after `resolveLink`.
      */
     onOpenArtifact?: ((target: OpenGeniViewerTarget) => void) | undefined;
+    /**
+     * Open another session the conversation points at: a sub-agent's chat from
+     * its worker card or a child update. `OpenGeniChat` opens it in place;
+     * without it those entries are not links.
+     */
+    onOpenSession?: ((sessionId: string) => void) | undefined;
     /**
      * Inline previews for assistant `opengeni-site` / `opengeni-html` fences.
-     * Defaults to the OpenGeni preview (Site reads need the proxy's
-     * `artifacts` option); `false` shows the fence as code.
+     * Defaults to the OpenGeni preview. Behind a session proxy without its
+     * `artifacts` option, Sites show as unavailable without a request; `false`
+     * shows the fence as code.
      */
     renderInteractiveBlock?: MessageTimelineProps["renderInteractiveBlock"] | false;
     /** Product-specific tool-call renderers; defaults to the built-in registry. */
@@ -95,6 +120,12 @@ export type SessionConversationProps = ClientOverride &
      * appears only when the deployment's client config enables file uploads.
      */
     attachments?: boolean | undefined;
+    /**
+     * Composer microphone (dictation into the draft). Defaults to true; it
+     * appears only when the client config reports voice input available
+     * (`createSessionProxyHandler({ voiceInput: false })` turns it off).
+     */
+    voiceInput?: boolean | undefined;
     /**
      * Show the model/reasoning picker. End users of an embedded product rarely
      * choose models, so it is hidden unless this is `true` or the client config
@@ -172,11 +203,13 @@ function Conversation({
   renderMessageText,
   resolveLink,
   onOpenArtifact,
+  onOpenSession,
   renderInteractiveBlock,
   toolRegistry,
   renderAllowanceExhausted,
   allowanceExhaustedLabels,
   attachments: attachmentsRequested = true,
+  voiceInput: voiceInputRequested = true,
   modelPicker,
   modelPickerProps,
   userMessageDisclosureLabels,
@@ -238,6 +271,14 @@ function Conversation({
     context.client,
     context.workspaceId,
     sessionId,
+    config.artifacts,
+    labelOverrides?.sitePreviewUnavailable ?? DEFAULT_CONVERSATION_LABELS.sitePreviewUnavailable,
+  );
+  const retainedLoaders = useRetainedLoaders(context.client, context.workspaceId, sessionId);
+  const transcription = useComposerTranscription(
+    context.client,
+    context.workspaceId,
+    voiceInputRequested && !importedArchive ? config.voiceInput : null,
   );
   const inheritedLinks = useOpenGeniLinkResolver();
   const defaultLinks = useMemo(
@@ -336,6 +377,8 @@ function Conversation({
           // Isolated and clipped: floating navigation stays inside the timeline.
           className="isolate min-h-0 flex-1 overflow-hidden"
           {...(toolRegistry ? { toolRegistry } : {})}
+          {...retainedLoaders}
+          {...(onOpenSession ? { onOpenSession } : {})}
           events={feed.events}
           items={conversationTimeline(feed.timeline, queue, composer)}
           turnSummary={{ rolling: true }}
@@ -394,18 +437,24 @@ function Conversation({
               autoFocus={false}
               decisionButtons
             />
-            {terminal ? (
-              <SessionChrome queue={queue} sessionStatus={status} readOnly />
-            ) : (
-              <SessionChrome
-                queue={queue}
-                composer={composer}
-                sessionStatus={status}
-                onComposerFocus={() =>
-                  region.current?.querySelector<HTMLTextAreaElement>("textarea")?.focus()
-                }
-              />
-            )}
+            <ConversationChrome
+              sessionId={sessionId}
+              client={context.client}
+              workspaceId={context.workspaceId}
+              events={feed.events}
+              chrome={
+                terminal
+                  ? { queue, sessionStatus: status, readOnly: true, onOpenSession }
+                  : {
+                      queue,
+                      composer,
+                      sessionStatus: status,
+                      onOpenSession,
+                      onComposerFocus: () =>
+                        region.current?.querySelector<HTMLTextAreaElement>("textarea")?.focus(),
+                    }
+              }
+            />
           </div>
           <div
             className="relative z-20 mx-auto w-full max-w-3xl shrink-0"
@@ -415,6 +464,9 @@ function Conversation({
               runControl="stop"
               running={running}
               {...composerProps}
+              {...(transcription && composerProps?.transcription === undefined
+                ? { transcription }
+                : {})}
               composer={composer}
               attachments={uploadsEnabled ? files : undefined}
               disabled={terminal || composerProps?.disabled}
@@ -456,34 +508,60 @@ function Conversation({
   );
 }
 
+type ConversationChromeProps = {
+  sessionId: string;
+  client: unknown;
+  workspaceId: string;
+  events: UseGoalOptions["events"];
+  chrome: Omit<ComponentProps<typeof SessionChrome>, "goal">;
+};
+
+/** Session chrome with the goal pill and its Pause/Resume/Clear when the client can reach goals. */
+function ConversationChrome(props: ConversationChromeProps) {
+  const goals = props.client as Partial<Record<"getGoal" | "updateGoal" | "deleteGoal", unknown>>;
+  const canReachGoals =
+    typeof goals.getGoal === "function" &&
+    typeof goals.updateGoal === "function" &&
+    typeof goals.deleteGoal === "function";
+  return canReachGoals ? <GoalChrome {...props} /> : <SessionChrome {...props.chrome} />;
+}
+
+function GoalChrome({ sessionId, client, workspaceId, events, chrome }: ConversationChromeProps) {
+  const goal = useGoal(sessionId, {
+    client: client as UseGoalOptions["client"],
+    workspaceId,
+    events,
+  });
+  return <SessionChrome {...chrome} goal={goal} />;
+}
+
 const LazyChatInteractiveBlock = lazy(() =>
   import("./artifacts/chat-interactive-block").then((module) => ({
     default: module.ChatInteractiveBlock,
   })),
 );
 
-type ScopableClient = SiteSnapshotClient & {
-  withHeaders?: (headers: Readonly<Record<string, string>>) => SiteSnapshotClient;
-};
+/** This client with the conversation's session scope header, when it can add headers. */
+function sessionScoped<T>(client: T, sessionId: string): T {
+  const candidate = client as { withHeaders?: (headers: Readonly<Record<string, string>>) => T };
+  return typeof candidate.withHeaders === "function"
+    ? candidate.withHeaders({ [SESSION_SCOPE_HEADER]: sessionId })
+    : client;
+}
 
 /** Inline Site/HTML preview reading through this conversation's session scope. */
 function useDefaultInteractiveBlock(
   client: unknown,
   workspaceId: string,
   sessionId: string,
+  sitesAvailable: boolean,
+  sitePreviewUnavailable: string,
 ): NonNullable<MessageTimelineProps["renderInteractiveBlock"]> {
   // Scope lazily: only a rendered preview reads, and some clients (a Site's
   // own client) cannot add headers.
   const scoped = useMemo((): SiteSnapshotClient => {
     let resolved: SiteSnapshotClient | null = null;
-    const get = () => {
-      const candidate = client as ScopableClient;
-      resolved ??=
-        typeof candidate.withHeaders === "function"
-          ? candidate.withHeaders({ [SESSION_SCOPE_HEADER]: sessionId })
-          : candidate;
-      return resolved;
-    };
+    const get = () => (resolved ??= sessionScoped(client as SiteSnapshotClient, sessionId));
     return {
       getWorkspaceArtifact: (...args) => get().getWorkspaceArtifact(...args),
       getWorkspaceArtifactHtml: (...args) => get().getWorkspaceArtifactHtml(...args),
@@ -495,54 +573,142 @@ function useDefaultInteractiveBlock(
     };
   }, [client, sessionId]);
   return useCallback(
-    (block) => (
-      <Suspense fallback={<span role="status">Loading preview…</span>}>
-        <LazyChatInteractiveBlock workspaceId={workspaceId} client={scoped} {...block} />
-      </Suspense>
-    ),
-    [scoped, workspaceId],
+    (block) =>
+      block.kind === "site" && !sitesAvailable ? (
+        // The proxy does not serve Sites: say so instead of offering a load
+        // that can only fail.
+        <div
+          className="rounded-og-md border border-og-border bg-og-surface-1 px-3 py-2 text-og-sm text-og-fg-muted"
+          data-og-site-preview-unavailable=""
+        >
+          {sitePreviewUnavailable}
+        </div>
+      ) : (
+        <Suspense fallback={<span role="status">Loading preview…</span>}>
+          <LazyChatInteractiveBlock workspaceId={workspaceId} client={scoped} {...block} />
+        </Suspense>
+      ),
+    [scoped, workspaceId, sitesAvailable, sitePreviewUnavailable],
   );
 }
 
-/** Deployment/proxy flags from the client config: uploads, and whether model choice is open. */
-export function useClientConfigFlags(client: {
-  getClientConfig: () => Promise<{
-    fileUploads?: { enabled?: boolean };
-    modelSelection?: boolean | undefined;
-    sandboxFiles?: boolean | undefined;
-    defaultReasoningEffort?: ReasoningEffort | undefined;
-  }>;
-}): {
-  uploads: boolean;
-  modelSelection: boolean;
-  sandboxFiles: boolean;
-  defaultReasoningEffort: ReasoningEffort | null;
-} {
-  const [flags, setFlags] = useState<ReturnType<typeof useClientConfigFlags>>({
-    uploads: false,
-    modelSelection: false,
-    sandboxFiles: false,
-    defaultReasoningEffort: null,
-  });
+type RetainedLoaderClient = Partial<
+  Pick<
+    OpenGeniClient,
+    | "createRetainedArtifactDownloadUrl"
+    | "downloadRetainedArtifact"
+    | "downloadRetainedScreenshot"
+    | "createVideoArtifactPlaybackSource"
+  >
+>;
+
+/**
+ * Generated images, published files, screenshots and generated video, read
+ * through this conversation's session scope (a session proxy only serves
+ * media that session produced). Clients without the SDK reads get none.
+ */
+function useRetainedLoaders(
+  client: unknown,
+  workspaceId: string,
+  sessionId: string,
+): Pick<
+  MessageTimelineProps,
+  "loadRetainedArtifact" | "loadRetainedScreenshot" | "loadVideoArtifactPlayback"
+> {
+  return useMemo(() => {
+    const base = client as RetainedLoaderClient;
+    // Scope lazily: only a rendered receipt reads.
+    let scoped: RetainedLoaderClient | null = null;
+    const get = () => (scoped ??= sessionScoped(base, sessionId));
+    return {
+      ...(typeof base.downloadRetainedArtifact === "function" &&
+      typeof base.createRetainedArtifactDownloadUrl === "function"
+        ? {
+            loadRetainedArtifact: (artifact, signal) =>
+              createWorkspaceRetainedArtifactLoader(
+                get() as Required<RetainedLoaderClient>,
+                workspaceId,
+              )(artifact, signal),
+          }
+        : {}),
+      ...(typeof base.downloadRetainedScreenshot === "function"
+        ? {
+            loadRetainedScreenshot: (artifact, signal) =>
+              createSessionRetainedScreenshotLoader(
+                get() as Required<RetainedLoaderClient>,
+                workspaceId,
+                sessionId,
+              )(artifact, signal),
+          }
+        : {}),
+      ...(typeof base.createVideoArtifactPlaybackSource === "function"
+        ? {
+            loadVideoArtifactPlayback: (artifactId, signal) =>
+              createWorkspaceRetainedVideoLoader(
+                get() as Required<RetainedLoaderClient>,
+                workspaceId,
+              )(artifactId, signal),
+          }
+        : {}),
+    } satisfies Pick<
+      MessageTimelineProps,
+      "loadRetainedArtifact" | "loadRetainedScreenshot" | "loadVideoArtifactPlayback"
+    >;
+  }, [client, workspaceId, sessionId]);
+}
+
+/**
+ * The composer microphone: shown when the deployment can transcribe, enabled
+ * once the workspace's voice-input setting allows it.
+ */
+export function useComposerTranscription(
+  client: unknown,
+  workspaceId: string,
+  capability: ClientVoiceInputConfig | null,
+): ComposerTranscriptionControlProps | null {
+  const [workspaceEnabled, setWorkspaceEnabled] = useState<{
+    key: string;
+    enabled: boolean;
+  } | null>(null);
+  const reader = client as Partial<Pick<OpenGeniClient, "getWorkspace" | "transcribeAudio">>;
+  const supported = capability !== null && typeof reader.transcribeAudio === "function";
   useEffect(() => {
+    if (!supported) return;
     let live = true;
-    client.getClientConfig().then(
-      (config) => {
+    const key = workspaceId;
+    if (typeof reader.getWorkspace !== "function") {
+      setWorkspaceEnabled({ key, enabled: true });
+      return;
+    }
+    reader.getWorkspace(workspaceId).then(
+      (workspace) => {
         if (live) {
-          setFlags({
-            uploads: config.fileUploads?.enabled === true,
-            // Only an explicit offer shows end users the picker.
-            modelSelection: config.modelSelection === true,
-            sandboxFiles: config.sandboxFiles !== false,
-            defaultReasoningEffort: config.defaultReasoningEffort ?? null,
+          setWorkspaceEnabled({
+            key,
+            enabled: resolveWorkspaceVoiceInputEnabled(workspace.settings) ?? true,
           });
         }
       },
-      () => undefined,
+      // The transcription request still enforces the setting.
+      () => live && setWorkspaceEnabled({ key, enabled: true }),
     );
     return () => {
       live = false;
     };
-  }, [client]);
-  return flags;
+  }, [reader, workspaceId, supported]);
+  return useMemo(
+    () =>
+      supported
+        ? {
+            client: reader as Pick<OpenGeniClient, "transcribeAudio">,
+            workspaceId,
+            capability,
+            workspaceEnabled:
+              workspaceEnabled?.key === workspaceId ? workspaceEnabled.enabled : false,
+          }
+        : null,
+    [supported, reader, workspaceId, capability, workspaceEnabled],
+  );
 }
+
+export { useClientConfigFlags } from "../hooks/use-client-config-flags";

package/src/components/session-list.tsx

@@ -1,6 +1,7 @@
 import { deriveSessionDisplayTitle, type OpenGeniClient, type Session } from "@opengeni/sdk";
 import { ArchiveIcon, PencilIcon, PlusIcon } from "lucide-react";
 import { useEffect, useRef, useState, type FormEvent } from "react";
+import { useClientConfigFlags } from "../hooks/use-client-config-flags";
 import { useWorkspaceSessions } from "../hooks/use-workspace-sessions";
 import { cn } from "../lib/cn";
 import { formatRelativeTime } from "../lib/format";
@@ -38,7 +39,10 @@ export type SessionListProps = ClientOverride & {
   onNewChat?: (() => void) | undefined;
   /** Allow inline rename (`updateSession`). Defaults to true. */
   rename?: boolean | undefined;
-  /** Allow archiving (`updateSessionArchive`). Defaults to true. */
+  /**
+   * Allow archiving (`updateSessionArchive`). Defaults to true; hidden when the
+   * session proxy reports archive disabled (`archive: false`).
+   */
   archive?: boolean | undefined;
   /** Called after the selected chat was archived, so the host can move on. */
   onArchived?: ((sessionId: string) => void) | undefined;
@@ -94,7 +98,10 @@ export function SessionList({
   const [error, setError] = useState<{ cause: unknown } | null>(null);
   const formatError = useErrorMessage();
   const archiveClient = context.client as unknown as ArchiveClient;
-  const canArchive = archive && typeof archiveClient.updateSessionArchive === "function";
+  // A session proxy with `archive: false` reports it; hide what would fail.
+  const config = useClientConfigFlags(context.client as never);
+  const canArchive =
+    archive && config.archive && typeof archiveClient.updateSessionArchive === "function";
 
   const run = async (id: string, action: () => Promise<unknown>) => {
     setBusy(id);